Características

Más allá de verificar contraseñas, el módulo @lynx/auth expone una variedad de características que simplifican enormemente la implementación de identidades seguras de manera distribuida.

Capacidades del Cliente y Servidor

El paquete está diseñado para ser la navaja suiza de seguridad de Lynx.

Exportación Dual

Exportamos dos facetas distintas con responsabilidades marcadas:

• authClient: Diseñado para el navegador. Actúa como mediador con almacenamiento local, envía cookies seguras y levanta eventos reactivos (ideal para su integración con Zustand).
• authServer: Diseñado para entornos Node/Edge. Verifica tokens asimétricos, valida firmas en tiempo de solicitud (Request-Time Validation) e inyecta la instancia en apps/nest.

Internacionalización Nativa (i18n)

Al estar estrechamente acoplado con @better-auth/i18n, cualquier cambio en la preferencia del usuario o del parámetro en la URL de App Router se sincroniza, permitiendo por ejemplo, enviar automáticamente un correo electrónico de “Restablecimiento de Contraseña” en español o inglés sin lógica condicional pesada.

Pruebas de la Capa de Identidad (Vitest)

Dado lo crítico que resulta la seguridad, este paquete se evalúa estrictamente.

Cobertura de Testing

Las pruebas están diseñadas puramente como comprobaciones unitarias sobre:

• Codificadores y Decodificadores (Codecs): Lógica customizada de codificación en base64 u ofuscación, asegurando que su revertibilidad funcione y rechace alteraciones.
• Esquemas de Zod: Validar todos los límites perimetrales.
• Config Builders: Verificar que la función constructora devuelve una instancia con los conectores correctos inyectados antes del entorno de ejecución.

Ejecución de Pruebas

Pruebas Unitarias

bash # Evaluar los esquemas y lógica de los plugins pnpm vitest run

Análisis de Cobertura