Introducción
El paquete @lynx/auth es el corazón del control de identidades dentro del monorepo Lynx. Su propósito primordial es centralizar y estandarizar la forma en que los usuarios inician sesión, mantienen sus sesiones y se autentican de forma segura a través de múltiples interfaces.
Filosofía de Diseño
Sección titulada «Filosofía de Diseño»A diferencia de modelos de autenticación acoplados a una sola aplicación, @lynx/auth se diseña como una capa independiente.
- Unica Fuente de Verdad: Las reglas de sesión, las estrategias de los tokens y los esquemas se definen aquí, y son importadas tanto por el cliente (Next.js) como por el backend (NestJS).
- Enfoque Multiplataforma: Exporta tanto las configuraciones del servidor (server-side configurations) como los clientes de autenticación estándar (auth clients).
Infraestructura Base
Sección titulada «Infraestructura Base»El paquete basa sus capacidades en el motor de última generación de Better Auth, enriqueciéndolo con herramientas del propio ecosistema Lynx.
- Better Auth: Framework primario de autenticación elegido por su portabilidad, rendimiento nativo y extensibilidad en TypeScript.
- Zod: Encargado de imponer fronteras estrictamente tipadas y validaciones sobre todos los objetos que transitan por este módulo.
Relación con el Ecosistema
Sección titulada «Relación con el Ecosistema»| Dependencia | Función |
| :----------------- | :----------------------------------------------------------------------------------------------------------------------- |
| @lynx/models | Define e inyecta la base de datos subyacente que almacena los perfiles, sesiones y tokens de cuenta. |
| apps/next | Consume el cliente de autenticación (authClient) para hidratar componentes y proteger rutas de manera reactiva. |
| apps/nest | Envuelve la instancia del servidor Better Auth para inyectar flujos de autorización mediante decoradores personalizados. |
Continúa a la sección de Arquitectura Lógica para entender el enlazado dinámico de plugins.