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

Visão geral

Middleware Express que verifica JWTs e coloca o usuário autenticado em req.clowk.user.

O que ele oferece:

  • ClowkExpressMiddleware() — factory de middleware
  • req.clowk.user — o usuário decodificado após a verificação
  • req.clowk.userId — atalho para o ID do usuário

ClowkExpressMiddleware

import { ClowkExpressMiddleware } from '@clowk/express'

const auth = ClowkExpressMiddleware()

Opções

OpçãoTipoPadrãoDescrição
onError(err, req, res, next) => voidRetorna 401Handler de erro personalizado
extractToken(req) => 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...

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

Nesta página