@clowk/core
@clowk/core é a base independente de runtime de todos os SDKs JavaScript do Clowk: configuração, erros, cliente HTTP com fetch e verificação de JWT.
Instalação
npm install @clowk/coreVisão geral
O pacote base. Não depende de runtime: funciona em Node.js, Bun, Deno, Cloudflare Workers e navegadores.
O que ele oferece:
- Singleton de configuração com padrões sensatos
- Hierarquia de erros (
ClowkError,ConfigurationError,InvalidStateError,InvalidTokenError) - Cliente HTTP sobre o
fetchnativo, com pilha de middleware (timeout, retry, logger) - SDK Client com API orientada a recursos:
users,sessions,subdomains,tokens - Verificação de JWT (HS256 via jose) com validação de issuer e checagem de expiração
- Extração de token (params, header bearer, cookie)
Configuração
import { configure } from '@clowk/core'
configure({
publishableKey: 'pk_live_...',
secretKey: 'sk_live_...',
})Verificar um token
import { verifyToken } from '@clowk/core'
const user = await verifyToken(token)
// => { id, email, name, provider, iat, exp }Arquitetura
Todos os SDKs do Clowk dependem de @clowk/core:
@clowk/core
├── @clowk/sdk
├── @clowk/react
├── @clowk/express
├── @clowk/hono
└── @clowk/nextjsOs pacotes de framework são camadas finas que adaptam o core às convenções de cada framework.
Erros
Erros dos SDKs do Clowk explicados, como ConfigurationError, InvalidStateError e InvalidTokenError, os códigos HTTP e como corrigir e tratar cada um.
@clowk/sdk
@clowk/sdk reexporta tudo do @clowk/core em um único caminho de import, para apps JavaScript que querem uma só dependência para a autenticação com Clowk.