Erros

import { VimineError } from '@vimine/sdk';   // também de /server

Tudo o que dá errado chega como um VimineError, uma subclasse de Error. O code é o identificador estável em que basear as suas decisões: o code de um documento problem+json (RFC 9457), o error de uma resposta OAuth, ou um dos códigos próprios do SDK.

Propriedades

	Tipo
code	string	o código estável
message	string	o detail ou o title do problema, ou error_description
status	number | null	o status HTTP, null para os erros locais
requestId	string | null	o request_id da resposta: informe-o nos relatos de problema
detail	string | null	o detail do problema
errors	FieldError[] — { field?, code?, message? }	os detalhes de validation_failed e de identification_required; uma entrada codicefiscale_mismatch também traz mismatches, hints e confirmable (guia)
cause	unknown	o erro de origem (network, framed)
isAuthError	boolean	true para “a sessão acabou: entre de novo” (401, invalid_token, token_expired, missing_token, invalid_grant, not_signed_in)

Os códigos do SDK

code	Quando
invalid_options	construtor sem clientId, redirectUri ou clientSecret
network	a requisição não chegou à API (cause traz o erro original)
not_signed_in	nenhuma sessão, ou nenhum refresh token, para uma chamada autenticada
no_flow	um retorno sem um login iniciado neste navegador (storage vazio ou expirado)
state_mismatch	o retorno não corresponde ao login que foi iniciado
framed	signIn() a partir de um frame de outra origem
http_<status>	uma resposta de erro sem um corpo JSON reconhecível

Os códigos da API (insufficient_scope, not_found, validation_failed, statuto_required, rate_limited, …) e os do OAuth (invalid_grant, access_denied, unauthorized_client, …) estão em Permissões, erros e limites.

Como tratá-los

import { VimineError } from '@vimine/sdk';

try {
    await vimine.membership.acceptStatuto({ version });
} catch (err) {
    if (!(err instanceof VimineError)) throw err;
    if (err.isAuthError) return vimine.signIn({ returnTo: location.pathname });
    switch (err.code) {
        case 'statuto_outdated':  return alert(`Há uma versão mais recente em vigor: ${err.detail}`);
        case 'insufficient_scope': return vimine.signIn({ scopes: ['statuto:accept'], prompt: 'consent' });
        case 'rate_limited':      return setTimeout(retry, 5000);
        default:                  console.error(err.code, err.requestId);
    }
}