@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/core

Visã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 middleware
  • c.get('clowkUser') — o usuário decodificado após a verificação

clowkAuth

import { clowkAuth } from '@clowk/hono'

app.use('*', clowkAuth())

Opções

OpçãoTipoPadrãoDescrição
onError(err, c) => ResponseRetorna 401 em JSONHandler de erro personalizado
extractToken(c) => string | nullDetecção automáticaExtrator de token personalizado

Ordem de extração do token

O middleware procura o JWT nesta ordem:

  1. Parâmetro de query: ?token=eyJ...
  2. Cookie: clowk_token
  3. 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

RuntimeAlvo de deploy
Cloudflare Workerswrangler deploy
Bunbun run src/index.ts
Denodeno run src/index.ts
Node.jsnode 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

Nesta página