Errores

import { VimineError } from '@vimine/sdk';   // también desde /server

Todo lo que sale mal llega como un VimineError, una subclase de Error. code es el identificador estable sobre el que ramificar: el code de un documento problem+json (RFC 9457), el error de una respuesta OAuth o uno de los códigos propios del SDK.

Propiedades

	Tipo
code	string	el código estable
message	string	el detail o el title del problema, o error_description
status	number | null	el estado HTTP, null para los errores locales
requestId	string | null	el request_id de la respuesta: indícalo en los informes
detail	string | null	el detail del problema
errors	FieldError[] — { field?, code?, message? }	los detalles de validation_failed y de identification_required; una entrada codicefiscale_mismatch lleva además mismatches, hints y confirmable (guía)
cause	unknown	el error de origen (network, framed)
isAuthError	boolean	true para «la sesión ya no existe: vuelve a iniciar sesión» (401, invalid_token, token_expired, missing_token, invalid_grant, not_signed_in)

Los códigos del SDK

code	Cuándo
invalid_options	constructor sin clientId, redirectUri o clientSecret
network	la petición no ha llegado a la API (cause lleva el error original)
not_signed_in	sin sesión, o sin refresh token, para una llamada autenticada
no_flow	una vuelta sin un inicio de sesión empezado desde este navegador (almacenamiento vacío o caducado)
state_mismatch	la vuelta no corresponde al inicio de sesión que se empezó
framed	signIn() desde un marco de otro origen
http_<status>	una respuesta de error sin un cuerpo JSON reconocible

Los códigos de la API (insufficient_scope, not_found, validation_failed, statuto_required, rate_limited, …) y los de OAuth (invalid_grant, access_denied, unauthorized_client, …) están en Permisos, errores y límites.

Cómo gestionarlos

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(`Hay una versión más reciente en 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);
    }
}