@clowk/express
@clowk/express é o middleware Express para autenticação com Clowk: verifica o JWT, define req.clowk.user e permite customizar extração do token e erros.
Instalação
npm install @clowk/express @clowk/coreVisão geral
Middleware Express que verifica JWTs e coloca o usuário autenticado em req.clowk.user.
O que ele oferece:
ClowkExpressMiddleware()— factory de middlewarereq.clowk.user— o usuário decodificado após a verificaçãoreq.clowk.userId— atalho para o ID do usuário
ClowkExpressMiddleware
import { ClowkExpressMiddleware } from '@clowk/express'
const auth = ClowkExpressMiddleware()Opções
| Opção | Tipo | Padrão | Descrição |
|---|---|---|---|
onError | (err, req, res, next) => void | Retorna 401 | Handler de erro personalizado |
extractToken | (req) => 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...
req.clowk
Após uma verificação bem-sucedida, req.clowk contém:
interface ClowkRequest {
user: {
id: string
email: string
name: string
provider: string
iat: number
exp: number
}
userId: string
}Tratamento de erros
Por padrão, tokens inválidos ou ausentes retornam uma resposta 401:
{ "error": "Unauthorized" }Personalize com onError:
const auth = ClowkExpressMiddleware({
onError: (err, req, res, next) => {
res.status(401).json({ error: err.message })
},
})Próximos passos
- Quickstart do Express — guia para começar
- Referência do @clowk/core — pacote base
@clowk/nextjs
@clowk/nextjs adiciona autenticação com Clowk a apps Next.js com App Router: middleware de rotas, currentUser() em Server Components e hooks no cliente.
@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.