Nota da demonstração: O endpoint de login é protegido por desafios adaptativos de prova-de-trabalho (PoW) — falhas repetidas retornam dificuldade crescente de PoW. A limitação de taxa com suporte a cache está implementada e testada, mas atualmente não está ativada na demonstração ao vivo; altere createCacheClient em app.ts para ativá-la.

Uma implementação de referência de autenticação construída do zero para Cloudflare Workers — hash de senha PBKDF2, sessões de token duplo JWT, comparação em tempo constante, expiração deslizante e um plugin de observabilidade removível — tudo integrado com Hono, Turso (com cache opcional Valkey/Redis) e TypeScript estrito.

Cada escolha de design remonta a um padrão: NIST SP 800-63B para credenciais, NIST SP 800-132 para derivação de chaves, OWASP ASVS para verificação e RFC 8725 para boas práticas de JWT.

Lançando um produto? Use o Better Auth — ele cobre OAuth, chaves de acesso, MFA, limitação de taxa e muito mais de fábrica, com um ecossistema ativo de plugins. Este repositório existe para ensinar como a autenticação funciona, não para substituir uma biblioteca de produção.

Por que este repositório

• Leia o código, não apenas a documentação — cada propriedade de segurança (rejeição em tempo constante, revogação vinculada à sessão, fixação de algoritmo) está implementada e testada, não apenas descrita
• Referências NIST + OWASP + RFC ao longo do texto — aprenda o porquê por trás de cada decisão
• Mais de 630 testes incluindo suítes de vetores de ataque (adulteração de token, confusão de algoritmo, casos extremos de unicode)
• Plugin de observabilidade — registro de auditoria estruturada, desafios adaptativos de PoW, API de operações autenticada por agente e streaming de eventos WebSocket — conecta-se via middleware Hono sem modificar a autenticação principal
• Construído para o edge — executa em Cloudflare Workers com Web Crypto API, sem dependências Node.js
• Apache-2.0 — bifurque, ensine com ele, aprenda com ele

O Que Você Encontrará Aqui

Próximos Passos para Produção

Este projeto intencionalmente omite funcionalidades que estão fora de seu escopo educacional. Se você está estendendo este código para produção (ou avaliando o que um sistema de autenticação de produção exige), as tabelas abaixo organizam as lacunas por prioridade.

Para a maioria dos projetos reais, use o Better Auth em vez de construir isso você mesmo.

Crítico — Adicione Antes de Usuários Reais

Alta Prioridade — Confiança em Produção

Prioridade Média — Conforme o Produto Escalar

Avançado — Empresarial / Alta Segurança

Todas essas são excelentes razões para recorrer ao Better Auth em vez disso.

Estrutura do Repositório

.
├── apps/
│   └── cloudflare-workers/    # Exemplo de Worker + rotas Hono
├── packages/
│   ├── core/                  # Serviços de autenticação, middleware, utilitários criptográficos
│   ├── infrastructure/        # Cliente de banco de dados + utilitários
│   ├── observability/         # Emissão de eventos, desafios adaptativos, API de operações (plugin removível)
│   ├── schemas/               # Esquemas Zod
│   └── types/                 # Tipos TypeScript compartilhados
├── tools/
│   └── cli/                   # plctl — TUI Go para a superfície /ops
└── docs/
    ├── adr/                   # Registros de Decisão de Arquitetura
    └── audits/                # Auditorias de segurança

Primeiros Passos

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

Pronto — sem contas, sem chaves de API, sem arquivos .env. O servidor de desenvolvimento inicia com um banco de dados SQLite local e segredos gerados. Abra http://localhost:8788 para registrar uma conta e explorar os fluxos de autenticação.

Tem uma conta Turso? Coloque um arquivo .dev.vars em apps/cloudflare-workers/ (veja .dev.vars.example) e bun run dev usará automaticamente o wrangler com seu banco de dados remoto. Use bun run dev:local para forçar o servidor local independentemente.

Consulte CONTRIBUTING.md para instruções de teste e implantação.

Usando com IA

Este repositório inclui um arquivo CLAUDE.md que fornece contexto para assistentes de IA. Ao usar Claude Code, Cursor ou ferramentas de desenvolvimento similares baseadas em IA:

1. A IA lerá automaticamente CLAUDE.md para contexto do projeto
2. Os Registros de Decisão de Arquitetura em docs/adr/ explicam as escolhas de design
3. As auditorias de segurança em docs/audits/ documentam a postura de segurança
4. Os testes demonstram o comportamento esperado e casos extremos

A base de código foi projetada para ser legível por IA, com limites de módulo claros, tipos abrangentes e nomenclatura descritiva.

Licença

Apache-2.0