@zumito-team/sentry

Integración de Sentry para reporte centralizado de todos los errores del framework Zumito.

Captura automáticamente errores de comandos (prefix/slash), rutas API, carga de módulos y cualquier otro error que pase por el ErrorHandler del framework.

Instalación

npm install @zumito-team/sentry

Uso

Como módulo de Zumito

// zumito.config.ts
import { SentryModule } from '@zumito-team/sentry';

export const config = {
    bundles: [
        {
            path: 'node_modules/@zumito-team/sentry',
            options: {
                dsn: 'https://<key>@sentry.io/<project>',
                environment: 'production',
                release: '1.0.0',
                sampleRate: 1.0,
                tracesSampleRate: 0.2,
            },
        },
    ],
};

Configuración directa

import { SentryModule, SentryService, ServiceContainer } from '@zumito-team/sentry';

new SentryModule({
    dsn: 'https://<key>@sentry.io/<project>',
    environment: 'production',
});

const sentry = ServiceContainer.getService(SentryService);

Envío manual de errores

import * as Sentry from '@sentry/node';

Sentry.captureException(new Error('Custom error'));
Sentry.captureMessage('Something happened', 'warning');

Contexto capturado automáticamente

El módulo enriquece cada error con:

Contexto	Datos
Tags	errorType, command, source (slash/prefix), guildId, channelId, endpoint, method, module, routePath
User	ID y username del usuario de Discord que ejecutó el comando
Extra	Nombre y tipo del comando, ID de interacción/mensaje, contenido del mensaje (primeros 200 chars)
API errors	Endpoint y método HTTP
Module errors	Nombre del módulo que falló al cargar

Configuración

Campo	Tipo	Requerido	Descripción
dsn	string	sí	DSN del proyecto en Sentry
environment	string	no	Entorno (default: NODE_ENV o development)
release	string	no	Versión del release
sampleRate	number	no	Tasa de muestreo de errores (0-1, default: 1.0)
tracesSampleRate	number	no	Tasa de muestreo de trazas (0-1)
debug	boolean	no	Modo debug de Sentry (default: false)

Cambios requeridos en zumito-framework

Este módulo necesita que CommandErrorOptions incluya interaction/message para extraer el contexto completo (guild, usuario, canal). Asegúrate de usar una versión del framework que incluya estos campos.