@clowk/hono
@clowk/hono é o middleware Hono para autenticação com Clowk que verifica o JWT e coloca o usuário no contexto, em Cloudflare Workers, Bun, Deno e Node.js.
Instalação
npm install @clowk/hono @clowk/coreVisão geral
Middleware Hono que verifica JWTs e coloca o usuário autenticado no contexto. Funciona em todo runtime que o Hono suporta: Cloudflare Workers, Bun, Deno e Node.js.
O que ele oferece:
clowkAuth()— factory de middlewarec.get('clowkUser')— o usuário decodificado após a verificação
clowkAuth
import { clowkAuth } from '@clowk/hono'
app.use('*', clowkAuth())Opções
| Opção | Tipo | Padrão | Descrição |
|---|---|---|---|
onError | (err, c) => Response | Retorna 401 em JSON | Handler de erro personalizado |
extractToken | (c) => string | null | Detecção automática | Extrator de token personalizado |
Ordem de extração do token
O middleware procura o JWT nesta ordem:
- Parâmetro de query:
?token=eyJ... - Cookie:
clowk_token - Header Authorization:
Bearer eyJ...
Variáveis de contexto
Após uma verificação bem-sucedida:
app.get('/me', (c) => {
const user = c.get('clowkUser')
// => { id, email, name, provider, iat, exp }
return c.json({ user })
})Tipo do usuário
interface ClowkUser {
id: string
email: string
name: string
provider: string
iat: number
exp: number
}Tratamento de erros
Por padrão, tokens inválidos ou ausentes retornam:
{ "error": "Unauthorized" }Personalize com onError:
const auth = clowkAuth({
onError: (err, c) => {
return c.json({ error: err.message }, 401)
},
})Runtimes
| Runtime | Alvo de deploy |
|---|---|
| Cloudflare Workers | wrangler deploy |
| Bun | bun run src/index.ts |
| Deno | deno run src/index.ts |
| Node.js | node src/index.ts |
O pacote @clowk/core usa fetch nativo e as APIs Web Crypto — sem dependências específicas do Node.js.
Próximos passos
- Quickstart do Hono — guia para começar
- Referência do @clowk/core — pacote base