expo-auth

Files (1)

• SKILL.md

SKILL.md (first lines)

## Propósito

Entender y trabajar con el sistema de autenticación de MyQuota App.

---

## Flujo de Autenticación

```
1. Usuario abre app
   └── src/app/index.tsx revisa SecureStore

2. Si hay token → /dashboard
   Si no hay token → /login

3. En login:
   └── Google Sign-In → POST /login/google → { accessToken, refreshToken }

4. Tokens se guardan:
   └── SecureStore (primario)
   └── AsyncStorage (legacy/fallback)

5. Requests autenticadas:
   └── requestWithAuth adjunta Bearer token
   └── Si 401 → refresh automático
   └── Si refresh falla → limpiar tokens → /login
```

---

## Archivo Clave

`src/features/auth/hooks/useAuth.ts` exporta:

- `requestWithAuth` — HTTP client autenticado
- `signInWithGoogle` — Flujo de Google Sign-In
- `signOut` — Logout
- `getAccessToken` — Obtener token actual

---

## requestWithAuth

```typescript
import { requestWithAuth } from "@/features/auth/hooks/useAuth";

// Uso básico
const response = await requestWithAuth(`${API_BASE_URL}/items`);

// Con opciones
const response = await requestWithAuth(`${API_BASE_URL}/items`, {
  method: "POST",
  headers: { "Content-Type": "application/json" },
  body: JSON.stringify(data),
});
```

**Comportamiento automático:**
1. Adjunta `Authorization: Bearer <accessToken>`
2. Si 401 con `code: "token_expired"` → intenta refresh
3. Si refresh OK → reintenta request original
4. Si refresh falla → limpia tokens → redirige a login

---

## Almacenamiento de Tokens

```typescript
import * as SecureStore from "expo-secure-store";

// Guardar
await SecureStore.setItemAsync("accessToken", token);
await SecureStore.setItemAsync("refreshToken", refreshToken);

// Leer
const token = await SecureStore.getItemAsync("accessToken");

// Eliminar
await SecureStore.deleteItemAsync("accessToken");
```

**Nota**: Actualmente también se usa AsyncStorage como fallback (deuda técnica).

---

## Google Sign-In

Desde el hook `useAuth`:

```typescript
import { useAuth } from "@/features/auth/hooks/useAuth";

export default function LoginScreen() {
  const { signInWithGoogle, loading, error } = useAuth();

  const handleLogin = async () => {
    try {
      await signInWithGoogle();
      // Si éxito, redirige automáticamente a /dashboard
    } catch (err) {
      // Error ya manejado por el hook
    }
  };

  return (
    <Button title="Iniciar con Google" onPress={handleLogin} disabled={loading} />
  );
}
```

---

## Logout

```typescript
import { useAuth } from "@/features/auth/hooks/useAuth";

const { signOut } = useAuth();

From cabrerojas/myquota-app, MIT.

More from cabrerojas/myquota-app