Módulos

Zumito proporciona un conjunto de módulos oficiales que extienden tu bot con funcionalidades listas para usar. Cada módulo es un paquete npm bajo el scope @zumito-team y se integra directamente con el framework de Zumito mediante la configuración bundles.

Módulos disponibles

Admin Panel de administración web centralizado con autenticación OAuth2 de Discord.

BuiltByBit License Verificación de licencias contra la API de BuiltByBit con comprobaciones periódicas y callbacks personalizados.

Canvas Librería de utilidades para renderizado canvas, procesamiento de imágenes y generación de GIFs.

Discord Auth Servicio reutilizable de autenticación OAuth2 JWT de Discord compartido por Admin y User Panel.

DisTube (Música) Reproducción de música con soporte para YouTube, Spotify, SoundCloud y panel de cola para usuarios.

File Manager Contrato abstracto FileManager para construir backends de almacenamiento modulares.

Local Filesystem Almacenamiento en sistema de archivos local implementando el contrato FileManager para desarrollo.

Logger Servicio de logging con salida a canales de Discord y persistencia en base de datos.

Reactions Comandos interactivos de reacciones GIF con categorías personalizables y plantillas multi-idioma.

S3 Assets Almacenamiento compatible con S3 (AWS, DigitalOcean, MinIO, Cloudflare R2) implementando FileManager.

Sentry Integración de monitoreo de errores con Sentry — captura automáticamente errores de comandos, API y módulos.

Stickman Fight Batallas animadas de stick figures usando avatares de Discord y GIFs generados.

User Panel Panel de usuario para gestión de servidores, configuración de cuenta y navegación extensible.

Arquitectura

Todos los módulos extienden Module de zumito-framework y se registran en el ServiceContainer. Pueden proporcionar:

• Servicios — Clases inyectables consumidas por otros módulos.
• Comandos — Comandos slash/prefix de Discord.
• Rutas — Endpoints HTTP (páginas admin, API, etc.).
• Elementos de navegación — Entradas en la barra lateral del Admin o User Panel.

Los módulos pueden declarar dependencias de otros módulos mediante las propiedades estáticas dependencies y optionalDependencies. El framework resuelve automáticamente estas dependencias y carga los módulos en el orden correcto usando ordenamiento topológico. Consulta Ciclo de vida del módulo para más detalles.

Grafo de dependencias

El siguiente grafo muestra las relaciones de dependencia entre los módulos oficiales. Estas se resuelven automáticamente por el framework durante el arranque.

zumito-framework (core)
├── admin-module
│   └── reactions-module
├── builtbybit-license
├── canvas-module
│   ├── stickmanfight
│   └── distube-module
├── discord-auth
│   ├── admin-module
│   └── user-panel-module
├── file-manager
│   ├── s3-assets
│   └── local-filesystem
├── logger-module
├── sentry
├── user-panel-module
│   └── distube-module
└── stickmanfight

Instalación

Instala cualquier módulo vía npm y agrégalo a los bundles de tu zumito.config.ts:

zumito.config.ts

export default {
    bundles: [
        '@zumito-team/admin-module',
        '@zumito-team/logger-module',
        // ...
    ]
}