Release Patto Bot Template v1.2.0 · HormigaDev/patto-bot-template

[1.2.0] - 2026-03-17

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

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

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

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

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.