Auth

Descripción

El módulo Auth maneja login, reset de contraseña, gestión de tokens y modo visitante.

El registro de nuevos usuarios ya no vive en este módulo: se realiza al aceptar una invitación. Ver Invitations.

Ubicación: src/modules/auth/

Este módulo implementa un sistema de bloqueo por intentos fallidos: tras 5 intentos incorrectos, la cuenta se bloquea durante 15 minutos.

Screens

Screen	Ruta	Descripción
`LoginScreen`	`/(auth)/login`	Login con email/contraseña, soporte para invitaciones
`ResendScreen`	`/(auth)/resend-password`	Reenvío de email de reset
`ResetScreen`	`/(auth)/reset-password`	Formulario de nueva contraseña

API Endpoints

Método	Path	Descripción
`POST`	`/v2/auth/login`	Login con credenciales
`PUT`	`/v1/auth/recover-password`	Solicitar reset de contraseña
`POST`	`/v1/auth/logout`	Cerrar sesión
`DELETE`	`/v2/users/remove`	Eliminar cuenta
`POST`	`/v1/auth/refresh-token`	Renovar access token
`GET`	`/v2/users/me`	Obtener usuario actual

Hooks

Hook	Descripción
`useAuth()`	Hook principal: `login`, `logout`, `resetPassword`, `resendPassword`, `initializeAuth`
`useAuthState()`	Selector de estado de autenticación

Tipos principales

const MAX_LOGIN_ATTEMPTS = 5;
const LOCKOUT_DURATION = 15; // minutos

const TOKEN*KEY = "token";
const REFRESH_TOKEN_KEY = "refreshToken";
const USER_KEY = "user";
const SESSION_TIMEOUT = 24 * 60 \_ 60 \* 1000; // 24 horas

Store

El módulo utiliza authStore en Zustand con almacenamiento híbrido (AsyncStorage + SecureStore).

Los tokens se almacenan en SecureStore para mayor seguridad. No acceder directamente a ellos fuera de este módulo.

Ver Autenticación para detalles del flujo JWT.

Componentes destacados

LoginForm

Formulario de login con validación y manejo de errores inline.

ResendForm

Formulario para reenvío de email de reseteo de contraseña.

ResetPasswordForm

Formulario para establecer una nueva contraseña tras el reset.

AuthError

Componente de visualización de errores de autenticación con mapeo de códigos.

authService

Servicio singleton que centraliza la lógica de autenticación:

Login attempt lockout: Máximo 5 intentos (MAX_LOGIN_ATTEMPTS), bloqueo de 15 minutos (LOCKOUT_DURATION).
Manejo de errores: Mapeo de códigos de error del backend a mensajes legibles.
Gestión de tokens: Almacenamiento seguro y renovación automática.

Modo visitante

Acceso
Salida

El método loginAsVisitor() permite explorar la app sin necesidad de crear una cuenta. Los visitantes tienen acceso limitado a funcionalidades de solo lectura.

El método logoutAsVisitor() limpia el estado del visitante y redirige al flujo de login/registro.

Overview

Architecture

Modules

Shared

Integrations

Guides

Descripción

Screens

API Endpoints

Hooks

Tipos principales

Store

Componentes destacados

LoginForm

ResendForm

ResetPasswordForm

AuthError

authService

Modo visitante

​Descripción

​Screens

​API Endpoints

​Hooks

​Tipos principales

​Store

​Componentes destacados

LoginForm

ResendForm

ResetPasswordForm

AuthError

​authService

​Modo visitante

Descripción

Screens

API Endpoints

Hooks

Tipos principales

Store

Componentes destacados

authService

Modo visitante