Patto Bot Template v1.4.0

[1.4.0] - 2026-05-13

🌍 Internacionalización (i18n) y generador propio de IDs

Esta versión introduce un subsistema de internacionalización opt-in para comandos que quieran responder en varios idiomas, con catálogo único, claves planas en notación de puntos y el helper this.t(...). También sustituye la dependencia nanoid (ESM-only, problemática en Jest) por un generador propio.

✨ Added

• Subsistema de i18n (src/i18n/)

  • Catálogo único en src/i18n/locale/es.ts (fuente de verdad), en.ts y pt.ts, con claves planas en notación de puntos: 'ping.response.title', 'system.argument.parse_error', 'help.subcommand_groups.footer', etc.
  • en.ts y pt.ts tipados como typeof es: el compilador exige paridad total de claves; firmas de funciones inferidas automáticamente.
  • API única: i18n.for(locale) devuelve la función traductora t(key, ...args) con tipos completos. Los argumentos se validan en cada call site según la firma del valor en el bundle.
  • Opt-in por comando: BaseCommand.t expone this.t('clave', ...args) para comandos que quieran respuestas traducidas. Los comandos base pueden seguir con strings literales.
  • Cadena de precedencia per-guild: preferencia explícita del servidor (LocaleStore) → interaction.locale de Discord (normalizado) → DEFAULT_LOCALE ('es').
  • El locale es una configuración global del servidor: todos los miembros ven al bot en el mismo idioma. Cambiarlo requiere ManageGuild.
  • LocaleResolver resuelve el locale una sola vez por petición y lo deposita en ctx.locale.
  • LocaleStore (interfaz per-guild) + MemoryLocaleStore por defecto; swappable por Redis u otro store distribuido vía LocaleRegistry.useStore(...).
  • LocaleRegistry estático — mismo patrón que StoreRegistry y PluginRegistry.
  • Helper resolveLocaleFromInteraction(interaction) para handlers estáticos de botones/selects/modales (no tienen acceso a BaseCommand/CommandContext).
  • Helpers isSupportedLocale, normalizeLocale para validar input externo (env vars, locales de Discord, etc.).
  • Soporte listo para es, en, pt (añadir un idioma = un nuevo archivo locale/<loc>.ts + entrada en SUPPORTED_LOCALES).

• Comando de ejemplo /setlocale (src/commands/examples/setlocale.command.ts)

  • Cambia el idioma de respuesta para todo el servidor.
  • Restringido con @RequirePermissions(Permissions.ManageGuild).
  • Devuelve la confirmación en el nuevo idioma seleccionado.
  • Aliases: idioma, language.

• Comando de ejemplo /help-translated (src/commands/info/help-translated.command.ts)

  • Versión traducida del comando de ayuda. El /help normal queda hardcoded para que el usuario elija qué enfoque conservar.

• Generador propio de IDs (src/utils/Id.ts)

  • generateId(size?: number) — IDs de alta entropía y cola aleatoria de crypto.randomBytes.
  • Tamaño por defecto 10 caracteres.

🔧 Changed

• BaseCommand — nuevos getters:
  • locale: SupportedLocale (delegado en ctx.locale).
  • t: TFn, usado sólo por comandos opt-in como setlocale y help-translated.
• CommandContext — nueva propiedad locale: SupportedLocale, fijada por el CommandHandler antes de ejecutar el comando.
• CommandHandler — resuelve el locale una sola vez por petición para que los comandos opt-in puedan usar this.locale/this.t.
• HelpCommand — vuelve a ser el comando hardcoded base.
• Comandos de ejemplo — PingCommand, componentes y subcomandos se mantienen hardcoded para no imponer i18n en el template.
• Button / Select / Modal (src/core/components/) — sustituidos los nanoid(10) por generateId(10) del nuevo módulo @/utils/Id.

🗑 Removed

• Dependencia nanoid — eliminada del package.json. La v5 se distribuye como ESM puro y rompía ts-jest. Su rol queda cubierto por src/utils/Id.ts sin nueva dependencia.
• LocaleStore.getUserLocale / setUserLocale / deleteUserLocale — reemplazados por sus equivalentes per-guild (getGuildLocale, etc.). El idioma del bot es una configuración del servidor, no del usuario.

📚 Documentation

• Nuevo src/i18n/README.md — guía completa: filosofía, arquitectura, cómo añadir un mensaje, cómo añadir un idioma, cómo configurar un store distribuido, cómo eliminar i18n del bot en un único punto, API pública.
• README.md principal — nueva sección "🌍 Internacionalización (i18n)" en Características y enlace en la navegación.
• Actualizadas referencias a generación de IDs (src/core/components/README.md, src/core/registry/component.registry.ts): ahora apuntan a @/utils/Id.
• README.md principal — eliminada la referencia a nanoid de la sección "Utilidades".

✅ Testing

• Nuevos tests en tests/unit/i18n/:
  • types.test.ts — SUPPORTED_LOCALES, isSupportedLocale, normalizeLocale.
  • translator.test.ts — bundle global i18n + función TFn (claves planas, args tipados, fallback, concurrencia).
  • memory.locale.store.test.ts — MemoryLocaleStore per-guild (incluye escrituras paralelas).
  • locale.resolver.test.ts — cadena de precedencia per-guild completa.
  • registry.test.ts — comportamiento estático del LocaleRegistry.
• Nuevo tests/unit/utils/Id.test.ts — formato, validación, orden temporal, unicidad.
• Tests existentes actualizados: CommandCategories.test.ts, cooldown.plugin.test.ts y permissions.plugin.test.ts.
• 212 tests pasan.

⚠️ Notas de migración

• Locale per-guild, no per-user: LocaleStore.getUserLocale → getGuildLocale. Si tu bot ya tenía preferencias persistidas por usuario, hay que migrar las claves a guildId.
• Convención de claves: planas con notación de puntos ('<dominio>.<seccion>.<mensaje>'). No camelCase, no objetos anidados.
• Consumo opt-in: usa this.t('clave', ...args) sólo en comandos que quieras traducir. Para eliminar i18n, borra setlocale, help-translated, el getter t de BaseCommand y el módulo src/i18n.
• Para añadir un mensaje nuevo: editar primero src/i18n/locale/es.ts; el compilador hará fallar en.ts y pt.ts hasta que se añadan las traducciones (contrato a propósito).
• Si se usa nanoid desde código propio downstream, migrar a generateId de @/utils/Id o reinstalar nanoid como dependencia propia.

Patto Bot Template v1.3.0

[1.3.0] - 2026-05-09

🚀 Sharding y Sistema de Logging

Esta versión introduce soporte completo para sharding mediante ShardingManager de Discord.js, un sistema de logging profesional con niveles y scopes, y stores distribuidos con Redis para cooldowns y payloads de componentes interactivos.

✨ Added

• Sistema de logging profesional (src/utils/Logger.ts)

  • Clase Logger con niveles: DEBUG, INFO, WARN, ERROR, FATAL, SILENT
  • Colores ANSI en TTY (desactivables con NO_COLOR; forzables con FORCE_COLOR)
  • Loggers hijos con scope via logger.child('NombreModulo') para identificar el origen de cada mensaje
  • Tag automático [SHARD X] cuando el proceso corre como worker de sharding
  • Serialización de Error con stack trace, objetos como JSON indentado y strings planos
  • Errores (ERROR, FATAL) dirigidos a stderr; el resto a stdout
  • Variable de entorno LOG_LEVEL para control en runtime (case-insensitive)
  • Singleton logger exportado listo para usar

• Soporte para Sharding (src/sharding.ts)

  • Entry point dedicado para modo ShardingManager
  • Compatible con TypeScript (ts-node en desarrollo) y JavaScript compilado (producción)
  • Respawn automático de shards caídos
  • Eventos de ciclo de vida de shard: ready, disconnect, reconnecting, death
  • Nuevos scripts: npm run dev:sharding y npm run start:sharding

• Stores distribuidos para sharding (src/core/store/)

  • CooldownStore — interfaz para almacenar expiraciones de cooldown (get, set, delete)
  • MemoryCooldownStore — implementación en memoria (default, single-instance / desarrollo)
  • RedisCooldownStore — implementación con Redis via ioredis; TTL automático; prefijo patto:cooldown:
  • RedisPayloadStore — implementación de PayloadStore con Redis; prefijo patto:payload:
  • StoreRegistry — registro centralizado para inyectar stores antes de que plugins.config.ts se evalúe

• Nuevas variables de entorno

  • LOG_LEVEL — nivel de logging (DEBUG/INFO/WARN/ERROR/FATAL/SILENT; default: DEBUG en dev, INFO en producción)
  • SHARDING_ENABLED — habilita el modo sharding (requiere REDIS_URL)
  • REDIS_URL — URL de conexión a Redis (redis:// o rediss://); obligatoria si SHARDING_ENABLED=true
  • TOTAL_SHARDS — número de shards a lanzar o auto (default: auto)

• Dependencia ioredis — cliente Redis para los stores distribuidos

🔧 Changed

• src/index.ts — migrado a función bootstrap() asíncrona con importaciones dinámicas; configura Redis stores antes de cargar plugins.config.ts; inyecta Logger.setShardId() desde process.env.SHARDS antes de Env.load()
• src/bot.ts — todos los console.* reemplazados por logger.child('Bot')
• src/utils/Env.ts — console.* reemplazados por logger.child('Env'); configuración cargada como objeto estructurado; REDIS_URL enmascarada en logs; nuevo método maskRedisUrl; validación del esquema de REDIS_URL; parseo robusto de TOTAL_SHARDS y LOG_LEVEL

🐛 Fixed

• Correcciones menores en command handler, loaders y componentes

📚 Documentation

• Actualizado .env.template con sección de sharding y nuevas variables documentadas
• Actualizados READMEs de src/core/, src/events/, src/plugins/ y src/utils/

⚠️ Notas

• El sharding requiere Redis; sin REDIS_URL válida el proceso termina con FATAL al iniciar.
• Para bots con menos de ~2.500 servidores, usar el entry point normal (npm run dev / npm start); SHARDING_ENABLED debe quedar en false.
• Los stores de Redis deben configurarse antes de que plugins.config.ts sea evaluado. El bootstrap en index.ts ya lo garantiza con importaciones dinámicas.

Patto Bot Template v1.2.0

[1.2.0] - 2026-03-17

🎯 Refactor de Metadata y Plugins

Esta versión consolida el acceso a metadata en una capa centralizada y agrega control de cooldown como plugin global configurable.

✨ Added

• Módulo de metadata centralizada (src/core/metadata/)
  • MetadataStore con caché por clase para evitar múltiples lecturas repetidas de Reflect.getMetadata
  • metadataHandler como API tipada de alto nivel para comandos, argumentos, permisos, cooldown, plugins y servicios
• Nuevos decoradores de control
  • @Cooldown para definir cooldown por comando
  • @BotPermissions para declarar permisos requeridos del bot
• Nuevo plugin CooldownPlugin
  • Bloquea ejecución durante cooldown y responde con timestamp de Discord para informar cuándo reintentar

🔧 Changed

• Infraestructura de comandos y ejecución
  • CommandHandler, CommandLoader, SlashCommandLoader, ArgumentResolver, TypeResolver, HelpCommand y PermissionsPlugin migran a metadataHandler como fuente de metadata
  • Se propaga explícitamente el commandId en eventos (interactionCreate, messageCreate) para identificar mejor la ejecución
• Base de comandos mejorada (BaseCommand)
  • Exposición de id del comando
  • Helpers reutilizables para validaciones frecuentes (validateUserIsNotAuthor, validateUserIsNotBot) y authorName
• Categorías de comandos
  • Renombre de enum de CommandCategoryTag a Category
  • Ampliación del enum con categorías adicionales (Utils, Moderation, Settings, Economy)
• Configuración de plugins
  • Registro de CooldownPlugin junto a PermissionsPlugin

📚 Documentation

• Nuevas guías del módulo de metadata y actualización de documentación en:
  • README.md
  • src/core/decorators/README.md
  • src/core/loaders/README.md
  • src/definitions/README.md
  • src/utils/README.md
  • docs/Subcommands.README.md
  • docs/SubcommandGroups.README.md
• Se añade soporte de seguridad documentado para 1.2.x en SECURITY.md

🧪 Testing

• Actualizados tests unitarios relacionados con:
  • PermissionsPlugin (flujo con metadata centralizada)
  • CommandCategories (nuevo enum Category)

⚠️ Notas

• En plugins.config.ts el CooldownPlugin se registra con PluginScope.Specified sin lista de comandos explícita; revisar si el alcance deseado es global o por comandos concretos.

Patto Bot Template v1.1.1

[1.1.0] - 2025-11-12

🎉 Soporte para Subcomandos y Grupos de Subcomandos

Implementación completa del sistema de subcomandos de Discord con hasta 3 niveles de anidamiento.

✨ Added

🎯 Sistema de Subcomandos

• Nuevos Decoradores
  • @Subcommand - Definir subcomandos simples (2 niveles: comando subcomando)
  • @SubcommandGroup - Definir grupos de subcomandos (3 niveles: comando grupo subcomando)
• Jerarquía de Decoradores - Prioridad automática: @SubcommandGroup > @Subcommand > @Command
• Keys en Kebab-Case - Sistema de identificación consistente para recuperación
  • Comando base: help
  • Subcomando: config-get (parent: config, name: get)
  • Grupo: server-config-get (parent: server, name: config, subcommand: get)
• Soporte en Text Commands - Los comandos de texto (!comando) soportan subcomandos
• Soporte en Slash Commands - Agrupación automática en formato Discord
• Estructura de 3 Niveles:
  • Nivel 1: <comando>
  • Nivel 2: <comando> <subcomando> o <comando> <grupo>
  • Nivel 3: <comando> <grupo> <subcomando>

⚡ Optimizaciones del CommandLoader

• Sistema Inteligente de Almacenamiento
  • Umbral configurable (default: 100 comandos)
  • ≤ 100 comandos: Toda la metadata en memoria (máximo rendimiento)
  • > 100 comandos: Sistema de caching con Map (optimización de memoria)
• Nuevos Métodos de Recuperación
  • getSubcommands(parentName) - Obtiene subcomandos de un comando padre
  • getSubcommandGroups(parentName) - Obtiene grupos de subcomandos organizados
  • getCommandEntry(key) - Recupera comando por kebab-case key con metadata completa

🤖 Registro Inteligente de Slash Commands

• Comandos Fantasma - Creación automática de comandos padre cuando no existen
  • Detecta subcomandos/grupos sin comando base
  • Genera automáticamente el comando padre como contenedor
  • Descripción generada: "Comandos de {nombre}"
  • Log distintivo: 👻 Comando fantasma creado: "{nombre}" (solo contenedor de subcomandos)
• Sin Modificaciones Requeridas - Los subcomandos funcionan automáticamente sin crear comando base
• Soporte de Plugins - Los comandos fantasma se omiten del ciclo de plugins (no tienen clase asociada)

📚 Documentación

• docs/Subcommands.README.md - Guía completa de subcomandos simples
• docs/SubcommandGroups.README.md - Guía completa de grupos de subcomandos
• Mejores Prácticas - Recomendaciones de organización de archivos y carpetas
• Ejemplos Actualizados - Comandos de ejemplo con subcomandos y grupos

🔧 Changed

• CommandLoader - Refactorizado para soportar jerarquía de comandos
• SlashCommandLoader - Agrupación automática por parent con construcción correcta de JSON
• CommandHandler - Soporte para comandos anidados con path tracking
• Events (messageCreate, interactionCreate) - Recuperación por kebab-case keys

🐛 Fixed

• Registro de Slash Commands - Los subcomandos y grupos ahora se registran correctamente en Discord API
  • Problema: Subcomandos/grupos sin comando base no se registraban
  • Solución: Sistema de "comandos fantasma" que crea automáticamente el comando padre
  • Efecto: Los comandos de ejemplo config y server ahora funcionan como slash commands
• Help Command - Corregido error al mostrar información de subcomandos
  • Problema: TypeError: Cannot read properties of undefined (reading 'name') al ejecutar !help config get
  • Causa: Metadata retrieval usaba solo COMMAND_METADATA_KEY para todos los tipos
  • Solución: Detección inteligente del tipo de comando con uso correcto de metadata keys

📖 Documentation

• Actualizado README.md con mejores prácticas de organización
• Actualizado src/commands/README.md con referencias a subcomandos
• Actualizado ARCHITECTURE.md con nueva estructura de comandos
• Nuevas guías detalladas en docs/

✅ Testing

• Sistema verificado con 7 comandos de ejemplo
• 2 comandos base, 2 subcomandos simples, 2 grupos con 3 subcomandos
• Recuperación correcta por keys kebab-case
• Compilación sin errores TypeScript
• Sin errores de ESLint

Patto Bot Template v1.0.0

Changelog

Todos los cambios notables de este proyecto serán documentados en este archivo.

El formato está basado en Keep a Changelog,
y este proyecto adhiere a Semantic Versioning.

1.0.0 - 2025-11-05

🎉 Lanzamiento Inicial

Primera versión pública del template. Incluye sistema completo de comandos, plugins, componentes interactivos y testing.

✨ Added (Características Principales)

🎯 Sistema de Comandos

• Decoradores TypeScript para definición declarativa de comandos
  • @Command - Definir comandos con metadata
  • @Arg - Definir argumentos con validación automática
  • @RequirePermissions - Validación de permisos de Discord
  • @UsePlugins - Aplicar plugins a comandos específicos
• Slash Commands (/comando) - Siempre disponibles
• Text Commands (!comando) - Opcionales y configurables
• Resolución automática de argumentos con tipos nativos y Discord
• Raw Text Capture - Captura texto completo sin comillas
• Options/Choices - Argumentos con valores predefinidos
• Aliases para comandos de texto
• Tipos Discord (User, Role, Channel, Member) resueltos automáticamente
• Custom Type Parsers para tipos personalizados

🔌 Sistema de Plugins

• BasePlugin - Clase base extensible con 4 lifecycle hooks
  • onBeforeRegisterCommand - Modificar comandos antes de registrar
  • onAfterRegisterCommand - Post-registro (logging, analytics)
  • onBeforeExecute - Pre-ejecución (validaciones, cooldowns)
  • onAfterExecute - Post-ejecución (recompensas, logging)
• Plugin Scopes - Aplicación granular de plugins
  • Scope global (todos los comandos)
  • Scope por carpeta (comandos de una categoría)
  • Scope por decorador (comandos específicos)
• PermissionsPlugin - Sistema de permisos integrado
  • Validación en registro (Discord API)
  • Validación en ejecución (runtime)
  • Soporte para múltiples permisos (bitwise OR)
  • Inmutable (no modifica JSON original)
  • 20 tests completos (unit + integration)

🎨 Componentes Interactivos

• Button Wrapper - Botones con callbacks inline
  • Estilos: Primary, Success, Danger, Secondary, Link
  • No requiere archivos separados
  • Callbacks tipo-seguros
• Select Wrapper - Select menus con onChange inline
  • String select, User select, Role select, Channel select, Mentionable select
  • Opciones personalizables con emojis
  • Handlers automáticos
• Modal Wrapper - Formularios interactivos
  • Campos de texto (short, paragraph)
  • onSubmit inline con valores parseados
  • Validación automática
• RichMessage - Gestión centralizada de componentes
  • 1 timeout global para N componentes (mejor performance)
  • Auto-limpieza después de inactividad (20s default)
  • Registry global automático
  • Sin boilerplate

🏗️ Arquitectura Limpia

• Principios SOLID aplicados
• Separación de responsabilidades
  • Loaders (cargan comandos, eventos)
  • Handlers (procesan mensajes, interacciones)
  • Resolvers (parsean argumentos)
  • Plugins (extienden funcionalidad)
• CommandContext unificado para Messages e Interactions
• BaseCommand con helpers útiles
  • reply() - Responder al usuario
  • send() - Enviar mensaje al canal
  • getEmbed(type) - Embeds pre-configurados (error, success, warning, info)
• Decoradores reutilizables
• Path aliases (@/core, @/commands, @/utils, etc.)

🛠️ Developer Experience

• TypeScript con strict mode
• Hot reload en desarrollo (ts-node)
• Testing completo con Jest
  • 57+ tests (unit + integration + e2e)
  • Cobertura de código configurada
  • Mocks de Discord.js incluidos
  • CI/CD con GitHub Actions
• Documentación exhaustiva
  • README detallado con ejemplos
  • Documentación por carpeta
  • Guías de arquitectura (ARCHITECTURE.md)
  • Documentación de plugins
  • Documentación de testing
  • JSDoc en código fuente
• Ejemplos listos para usar
  • Comando ping básico
  • Comando ask con OpenAI
  • Comando con permisos
  • Plugin de permisos

⚙️ Configuración Flexible

• Variables de entorno con validación robusta
  • BOT_TOKEN (obligatorio)
  • CLIENT_ID (obligatorio)
  • USE_MESSAGE_CONTENT (opcional)
  • COMMAND_PREFIX (opcional, default: !)
  • INTENTS (opcional, automático)
• Validación automática al inicio
  • Mensajes de error claros
  • Guías de qué falta configurar
  • Sugerencias de solución
• Intents automáticos según features usadas
• Presencias personalizables
• Manejo robusto de errores
  • ValidationError para validaciones
  • ReplyError para errores de usuario
  • Error handling global

🧪 Testing Infrastructure

• Jest 29 con soporte TypeScript
• Mocks de Discord.js pre-configurados
  • createMockClient, createMockUser, createMockGuild
  • createMockMember, createMockTextChannel
  • createMockMessage, createMockInteraction
• Fixtures - Datos de prueba reutilizables
• Path aliases funcionando en tests
• Coverage reports con umbrales configurables
• Debug en VSCode configurado
• Estructura organizada
  • /tests/unit - Tests unitarios
  • /tests/integration - Tests de integración
  • /tests/e2e - Tests end-to-end
  • /tests/mocks - Mocks reutilizables
  • /tests/fixtures - Datos de prueba

📚 Utilidades Incluidas

• Times - Conversión de tiempo a milisegundos
• CommandCategories - Categorías predefinidas para comandos
• Permissions - Re-export de permisos de Discord.js con categorización
• Colors - Paleta de colores para embeds

🔒 Sistema de Permisos

• @RequirePermissions decorator
• PermissionsPlugin incluido
• Validación dual (registro + ejecución)
• Inmutable (no modifica configuración original)
• 20 tests completos garantizando funcionalidad
• Soporte para múltiples permisos
• Mensajes de error personalizables

📖 Documentation

• README.md - Guía principal completa
• ARCHITECTURE.md - Documentación de arquitectura
• /src/core/decorators/README.md - Guía de decoradores
• /src/core/structures/README.md - Guía de estructuras base
• /src/plugins/README.md - Sistema de plugins
• /src/plugins/permissions.plugin.README.md - Plugin de permisos
• /src/utils/README.md - Utilidades disponibles
• /tests/README.md - Infraestructura de testing
• JSDoc completo en todo el código fuente

🔧 Technical Details

• Node.js: ≥18.0.0
• Discord.js: 14.16.3
• TypeScript: 5.9.3
• Jest: 29.7.0
• Reflect Metadata: Para decoradores
• TSConfig Paths: Para path aliases
• ESLint + Prettier: Linting y formateo

📦 Project Structure

patto-bot-template/
├── src/
│   ├── bot.ts                 # Instancia del bot
│   ├── index.ts               # Entry point
│   ├── commands/              # Implementaciones de comandos
│   ├── core/                  # Sistema core
│   │   ├── decorators/        # Decoradores (@Command, @Arg, etc)
│   │   ├── handlers/          # Handlers de mensajes/interacciones
│   │   ├── loaders/           # Cargadores de comandos/eventos
│   │   ├── resolvers/         # Resolvers de argumentos
│   │   └── structures/        # Clases base (BaseCommand, BasePlugin)
│   ├── definition/            # Definiciones de comandos
│   ├── error/                 # Errores personalizados
│   ├── events/                # Event listeners
│   ├── plugins/               # Plugins del sistema
│   ├── utils/                 # Utilidades
│   └── wrappers/              # Wrappers de componentes
├── tests/                     # Suite de tests completa
│   ├── unit/                  # Tests unitarios
│   ├── integration/           # Tests de integración
│   ├── e2e/                   # Tests end-to-end
│   ├── mocks/                 # Mocks de Discord.js
│   └── fixtures/              # Datos de prueba
├── assets/                    # Recursos estáticos
├── .github/                   # GitHub Actions CI/CD
├── package.json
├── tsconfig.json
├── jest.config.js
├── .env.template
├── README.md
├── ARCHITECTURE.md
├── CHANGELOG.md
└── LICENSE

🎯 Highlights

• ✅ 57+ tests pasando (100% cobertura crítica)
• ✅ Documentación exhaustiva (8 archivos README + JSDoc)
• ✅ Arquitectura modular fácil de extender
• ✅ Type-safe con TypeScript strict
• ✅ Production-ready con validación robusta
• ✅ Developer-friendly con hot reload y debugging
• ✅ CI/CD configurado con GitHub Actions

🚀 Getting Started

# Instalar
git clone https://github.com/HormigaDev/patto-bot-template.git
cd patto-bot-template
npm install

# Configurar
cp .env.template .env
# Editar .env con tu BOT_TOKEN y CLIENT_ID

# Desarrollar
npm run dev

# Testing
npm test

# Producción
npm run build
npm start

---

Unreleased

🔮 Future Plans

• Dashboard web para gestión del bot
• Sistema de economía con comandos de banco
• Sistema de niveles y experiencia
• Comandos de música (YouTube, Spotify)
• Sistema de tickets avanzado
• Base de datos integrada (MongoDB/PostgreSQL)
• Internacionalización (i18n)
• Sistema de logs avanzado con webhooks
• Rate limiting global
• Caching system

---