Nota de la demo: El endpoint de inicio de sesión está protegido por desafíos PoW adaptativos — los fallos repetidos devuelven una dificultad de prueba de trabajo creciente. La limitación de velocidad con respaldo de caché está implementada y probada, pero actualmente no está habilitada en la demo en vivo; cambia createCacheClient en app.ts para activarla.

Una implementación de referencia de autenticación desde cero para Cloudflare Workers — hashing de contraseñas PBKDF2, sesiones de tokens duales JWT, comparación en tiempo constante, expiración deslizante y un plugin de observabilidad removible — todo conectado con Hono, Turso (con almacenamiento en caché opcional Valkey/Redis) y TypeScript estricto.

Cada decisión de diseño se remonta a un estándar: NIST SP 800-63B para credenciales, NIST SP 800-132 para derivación de claves, OWASP ASVS para verificación y RFC 8725 para mejores prácticas de JWT.

¿Lanzando un producto? Usa Better Auth en su lugar — cubre OAuth, passkeys, MFA, limitación de velocidad y más de fábrica con un ecosistema de plugins activo. Este repositorio existe para enseñarte cómo funciona la autenticación, no para reemplazar una librería de producción.

Por qué este repositorio

• Lee el código, no solo la documentación — cada propiedad de seguridad (rechazo en tiempo constante, revocación vinculada a la sesión, fijación de algoritmo) está implementada y probada, no solo descrita
• Referencias NIST + OWASP + RFC en todas partes — aprende el por qué detrás de cada decisión
• Más de 630 pruebas incluyendo suites de vectores de ataque (manipulación de tokens, confusión de algoritmos, casos límite de Unicode)
• Plugin de observabilidad — auditoría estructurada de eventos, desafíos PoW adaptativos, API de operaciones autenticada por agente y transmisión de eventos WebSocket — se conecta a través de middleware de Hono sin modificar la autenticación principal
• Construido para el borde — se ejecuta en Cloudflare Workers con Web Crypto API, sin dependencias de Node.js
• Apache-2.0 — bifurca, enseña, aprende

Lo que encontrarás dentro

Próximos pasos para producción

Este proyecto omite intencionalmente características que están fuera de su alcance educativo. Si estás extendiendo este código hacia producción (o evaluando lo que requiere un sistema de autenticación de producción), las tablas a continuación organizan las brechas por nivel de prioridad.

Para la mayoría de proyectos reales, usa Better Auth en lugar de construir esto tú mismo.

Crítico — Añadir antes de tener usuarios reales

Alta prioridad — Confianza en producción

Prioridad media — A medida que el producto escala

Avanzado — Empresarial / Alta seguridad

Todas estas son excelentes razones para optar por Better Auth en su lugar.

Estructura del repositorio

.
├── apps/
│   └── cloudflare-workers/    # Worker de ejemplo + rutas de Hono
├── packages/
│   ├── core/                  # Servicios de autenticación, middleware, utilidades criptográficas
│   ├── infrastructure/        # Cliente de base de datos + utilidades
│   ├── observability/         # Emisión de eventos, desafíos adaptativos, API de operaciones (plugin removible)
│   ├── schemas/               # Esquemas Zod
│   └── types/                 # Tipos TypeScript compartidos
├── tools/
│   └── cli/                   # plctl — TUI en Go para la superficie /ops
└── docs/
    ├── adr/                   # Registros de decisiones de arquitectura
    └── audits/                # Auditorías de seguridad

Primeros pasos

git clone https://github.com/vhscom/private-landing.git
cd private-landing
bun install
bun run dev

Eso es todo — sin cuentas, sin claves API, sin archivos .env. El servidor de desarrollo se inicia con una base de datos SQLite local y secretos generados. Abre http://localhost:8788 para registrar una cuenta y explorar los flujos de autenticación.

¿Tienes una cuenta de Turso? Coloca un archivo .dev.vars en apps/cloudflare-workers/ (consulta .dev.vars.example) y bun run dev usará automáticamente wrangler con tu base de datos remota en su lugar. Usa bun run dev:local para forzar el servidor local independientemente.

Consulta CONTRIBUTING.md para instrucciones de prueba e implementación.

Uso con IA

Este repositorio incluye un archivo CLAUDE.md que proporciona contexto para asistentes de IA. Al usar Claude Code, Cursor o herramientas de desarrollo similares potenciadas por IA:

1. La IA leerá automáticamente CLAUDE.md para el contexto del proyecto
2. Los Registros de Decisiones de Arquitectura en docs/adr/ explican las elecciones de diseño
3. Las auditorías de seguridad en docs/audits/ documentan la postura de seguridad
4. Las pruebas demuestran el comportamiento esperado y los casos límite

La base de código está diseñada para ser legible por IA con límites de módulo claros, tipos completos y nombres descriptivos.

Licencia

Apache-2.0