Hono

Guia completo de autenticação com Clowk no Hono: clowkMiddleware, requireAuth, o contexto auth e deploy em Cloudflare Workers, Bun, Deno e Node.js.

Instalação

pnpm add @clowk/hono @clowk/core

Configuração

src/index.ts
import { Hono } from 'hono'
import { clowkMiddleware, requireAuth } from '@clowk/hono'

const app = new Hono()

Proteger todas as rotas

Aplique clowkMiddleware de forma global. O payload decodificado do JWT fica disponível via c.get('auth'):

app.use(clowkMiddleware({
  secretKey: process.env.CLOWK_SECRET_KEY,
}))

app.get('/me', (c) => {
  const auth = c.get('auth')

  return c.json({ user: auth })
})

export default app

Opções do middleware

OpçãoTipoDescrição
secretKeystringSecret key para verificar o JWT
tokenParamstringNome do parâmetro de query (padrão: "token")
cookieKeystringNome do cookie (padrão: "clowk_token")

Proteger rotas específicas

Use requireAuth() para proteger rotas. Ele retorna 401 se não encontrar um token válido:

app.get('/public', (c) => {
  return c.json({ message: 'This is public' })
})

app.get('/dashboard', requireAuth(), (c) => {
  const auth = c.get('auth')

  return c.json({ user: auth })
})

Tipo de c.get('auth')

interface JwtPayload {
  iss?: string       // "clowk"
  sub?: string       // UUID do usuário
  email?: string     // "[email protected]"
  name?: string      // "Jane Doe"
  avatar_url?: string
  provider?: string  // "google" | "github" | "twitter" | "email"
  instance_id?: string
  app_id?: string
  iat?: number
  exp?: number
}

Com clowkMiddleware, c.get('auth') é null se nenhum token for encontrado (soft auth). Com requireAuth, a requisição é recusada antes de chegar ao seu handler.

Runtimes

Hono + Clowk funciona em todo runtime. O @clowk/core usa fetch nativo e as APIs Web Crypto — sem dependências específicas do Node.js.

RuntimeAlvo de deploy
Cloudflare Workerswrangler deploy
Bunbun run src/index.ts
Denodeno run src/index.ts
Node.jsnode src/index.ts

Exemplo completo

src/index.ts
import { Hono } from 'hono'
import { clowkMiddleware, requireAuth } from '@clowk/hono'

const app = new Hono()

app.use(clowkMiddleware({
  secretKey: process.env.CLOWK_SECRET_KEY,
}))

app.get('/', (c) => {
  const auth = c.get('auth')

  return c.json({ authenticated: !!auth })
})

app.get('/profile', requireAuth(), (c) => {
  const auth = c.get('auth')

  return c.json({
    id: auth?.sub,
    email: auth?.email,
    name: auth?.name,
  })
})

export default app

Nesta página