Erros
Erros dos SDKs do Clowk explicados, como ConfigurationError, InvalidStateError e InvalidTokenError, os códigos HTTP e como corrigir e tratar cada um.
Hierarquia de erros
Todos os erros do Clowk estendem ClowkError:
ClowkError
├── ConfigurationError
├── InvalidStateError
└── InvalidTokenErrorConfigurationError
Lançado quando o SDK não está configurado corretamente.
ConfigurationError: Missing publishableKeySolução: chame configure() com as suas chaves antes de usar qualquer função do Clowk, ou defina as variáveis de ambiente.
InvalidStateError
Lançado quando o parâmetro state do OAuth não confere.
InvalidStateError: State mismatchSolução: em geral, a sessão do usuário expirou durante o fluxo OAuth. Peça para ele entrar de novo.
InvalidTokenError
Lançado quando a verificação do JWT falha.
InvalidTokenError: Token expired
InvalidTokenError: Invalid signature
InvalidTokenError: Invalid issuerSolução:
- Token expired — o JWT passou do tempo de expiração. O usuário precisa entrar de novo.
- Invalid signature — o token foi assinado com outra secret key. Confira se a sua
secretKeyé a mesma do dashboard do Clowk. - Invalid issuer — o token foi emitido por outro projeto do Clowk.
Códigos de erro HTTP
| Código | Significado |
|---|---|
401 | Não autorizado — token ausente ou inválido |
403 | Proibido — token válido, mas sem permissão suficiente |
429 | Requisições demais — limite de taxa excedido |
500 | Erro interno do servidor — erro inesperado do lado do Clowk |
Tratando erros
import { ClowkError, InvalidTokenError } from '@clowk/core'
try {
const user = await verifyToken(token)
} catch (err) {
if (err instanceof InvalidTokenError) {
// Token expirado ou inválido — redirecione para o login
} else if (err instanceof ClowkError) {
// Outro erro do Clowk
}
}Como contribuir
Como contribuir com o Clowk: envie pull requests para os SDKs e a documentação, crie um SDK da comunidade e reporte bugs ou peça recursos.
@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.