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

Visã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 fetch nativo, 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/nextjs

Os pacotes de framework são camadas finas que adaptam o core às convenções de cada framework.

Nesta página