meocord 1.4.0 → 1.4.1

package/README.md

@@ -571,6 +571,12 @@ Thank you for helping make **MeoCord** better!
 
 ---
 
+## Release Notes
+
+Full release history is available on the [GitHub Releases](https://github.com/l7aromeo/meocord/releases) page.
+
+---
+
 ## License
 
 **MeoCord Framework** is licensed under the [MIT License](./LICENSE).

package/dist/cjs/_shared/{meocord.app-BcwCzqru.cjs → meocord.app-Ds9XbbCN.cjs}

@@ -153,7 +153,7 @@ const REACTION_HANDLER_METADATA_KEY = Symbol('reaction_handlers');
         if (typeof builderOrType === 'function') {
             const builderObj = new builderOrType();
             builderInstance = builderObj.build(commandName);
-            commandType = Reflect.getMetadata('commandType', builderOrType);
+            commandType = Reflect.getMetadata(enum_index.MetadataKey.CommandType, builderOrType);
             if (!(commandType in enum_index.CommandType)) {
                 throw new Error(`Metadata for 'commandType' is missing on builder ${builderOrType.name}`);
             }
@@ -205,19 +205,19 @@ const REACTION_HANDLER_METADATA_KEY = Symbol('reaction_handlers');
  * ```
  */ function Controller() {
     return function(target) {
-        if (!Reflect.hasMetadata('inversify:injectable', target)) {
+        if (!Reflect.hasMetadata(enum_index.MetadataKey.Injectable, target)) {
             inversify.injectable()(target);
         }
-        const injectables = Reflect.getMetadata('design:paramtypes', target) || [];
+        const injectables = Reflect.getMetadata(enum_index.MetadataKey.ParamTypes, target) || [];
         injectables.map((dep)=>{
             if (!mainContainer.isBound(dep)) {
-                if (!Reflect.hasMetadata('inversify:injectable', dep)) {
+                if (!Reflect.hasMetadata(enum_index.MetadataKey.Injectable, dep)) {
                     inversify.injectable()(dep);
                 }
                 mainContainer.bind(dep).toSelf().inSingletonScope();
             }
         });
-        Reflect.defineMetadata('inversify:container', mainContainer, target);
+        Reflect.defineMetadata(enum_index.MetadataKey.Container, mainContainer, target);
     };
 }
 
@@ -399,7 +399,7 @@ class MeoCordApp {
         for (const controller of relevantControllers){
             let controllerInstance = this.controllerInstancesCache.get(controller.constructor);
             if (!controllerInstance) {
-                const container = Reflect.getMetadata('inversify:container', controller.constructor);
+                const container = Reflect.getMetadata(enum_index.MetadataKey.Container, controller.constructor);
                 controllerInstance = container.get(controller.constructor, {
                     autobind: true
                 });
@@ -432,7 +432,7 @@ class MeoCordApp {
         for (const controller of relevantControllers){
             let controllerInstance = this.controllerInstancesCache.get(controller.constructor);
             if (!controllerInstance) {
-                const container = Reflect.getMetadata('inversify:container', controller.constructor);
+                const container = Reflect.getMetadata(enum_index.MetadataKey.Container, controller.constructor);
                 controllerInstance = container.get(controller.constructor, {
                     autobind: true
                 });

package/dist/cjs/core/index.cjs

@@ -2,9 +2,10 @@
 
 require('reflect-metadata');
 var theme = require('../_shared/theme-Bz-D4RbT.cjs');
-var meocord_app = require('../_shared/meocord.app-BcwCzqru.cjs');
+var meocord_app = require('../_shared/meocord.app-Ds9XbbCN.cjs');
 require('inversify');
 require('discord.js');
+var enum_index = require('../enum/index.cjs');
 require('path');
 require('fs');
 require('jiti');
@@ -13,13 +14,12 @@ require('dayjs');
 require('dayjs/plugin/utc.js');
 require('dayjs/plugin/timezone.js');
 require('chalk');
-require('../enum/index.cjs');
 require('lodash-es');
 require('cli-table3');
 
 class MeoCordFactory {
     static create(target) {
-        const container = Reflect.getMetadata('inversify:container', target);
+        const container = Reflect.getMetadata(enum_index.MetadataKey.Container, target);
         if (!container) {
             if (typeof target === 'function') {
                 this.logger.error(`No container found for class: ${target.name}`);

package/dist/cjs/decorator/index.cjs

@@ -1,11 +1,11 @@
 'use strict';
 
 require('reflect-metadata');
-var meocord_app = require('../_shared/meocord.app-BcwCzqru.cjs');
+var meocord_app = require('../_shared/meocord.app-Ds9XbbCN.cjs');
 var inversify = require('inversify');
 var discord_js = require('discord.js');
+var enum_index = require('../enum/index.cjs');
 var theme = require('../_shared/theme-Bz-D4RbT.cjs');
-require('../enum/index.cjs');
 require('lodash-es');
 require('cli-table3');
 require('node:util');
@@ -36,7 +36,7 @@ require('chalk');
  */ function Service() {
     return function(target) {
         // Check if the class is already injectable; if not, make it injectable dynamically
-        if (!Reflect.hasMetadata('inversify:injectable', target)) {
+        if (!Reflect.hasMetadata(enum_index.MetadataKey.Injectable, target)) {
             inversify.injectable()(target);
         }
         // Check if the class is already injectable; if not, make it injectable dynamically
@@ -50,14 +50,14 @@ require('chalk');
 }
 function bindDependencies$1(target) {
     // Get the constructor parameter types using Reflect metadata
-    const dependencies = Reflect.getMetadata('design:paramtypes', target) || [];
+    const dependencies = Reflect.getMetadata(enum_index.MetadataKey.ParamTypes, target) || [];
     dependencies.forEach((dep)=>{
         // Bind the dependency if not already bound
         if (!meocord_app.mainContainer.isBound(dep)) {
             if (dep.name === discord_js.Client.name) return;
             try {
                 // Check if the class is already injectable; if not, make it injectable dynamically
-                if (!Reflect.hasMetadata('inversify:injectable', dep)) {
+                if (!Reflect.hasMetadata(enum_index.MetadataKey.Injectable, dep)) {
                     inversify.injectable()(dep);
                 }
                 meocord_app.mainContainer.bind(dep).toSelf().inSingletonScope();
@@ -89,11 +89,11 @@ function bindDependencies$1(target) {
  */ function CommandBuilder(commandType) {
     return function(target) {
         // Check if the class is already injectable; if not, make it injectable dynamically
-        if (!Reflect.hasMetadata('inversify:injectable', target)) {
+        if (!Reflect.hasMetadata(enum_index.MetadataKey.Injectable, target)) {
             inversify.injectable()(target);
         }
         // Define the command type metadata for the target class
-        Reflect.defineMetadata('commandType', commandType, target);
+        Reflect.defineMetadata(enum_index.MetadataKey.CommandType, commandType, target);
     };
 }
 
@@ -167,12 +167,12 @@ export class ButtonInteractionGuard implements GuardInterface {
  */ function Guard() {
     return function(target) {
         // Check if the class is already injectable; if not, make it injectable dynamically
-        if (!Reflect.hasMetadata('inversify:injectable', target)) {
+        if (!Reflect.hasMetadata(enum_index.MetadataKey.Injectable, target)) {
             inversify.injectable()(target);
         }
         meocord_app.mainContainer.bind(target).toSelf().inTransientScope();
         // Bind any dependencies that the guard requires
-        const injectables = Reflect.getMetadata('design:paramtypes', target) || [];
+        const injectables = Reflect.getMetadata(enum_index.MetadataKey.ParamTypes, target) || [];
         injectables.forEach((dep)=>{
             if (!meocord_app.mainContainer.isBound(dep)) {
                 meocord_app.mainContainer.bind(dep).toSelf().inSingletonScope();
@@ -231,7 +231,7 @@ export class ButtonInteractionGuard implements GuardInterface {
             // Method Decorator
             applyGuards(descriptor, guards, String(propertyKey));
             // Store guard metadata for later access (if needed)
-            Reflect.defineMetadata('guards', guards, target, propertyKey);
+            Reflect.defineMetadata(enum_index.MetadataKey.Guards, guards, target, propertyKey);
         } else if (typeof target === 'function' && !propertyKey && !descriptor) {
             // Class Decorator
             const prototype = target.prototype;
@@ -248,7 +248,7 @@ export class ButtonInteractionGuard implements GuardInterface {
                 if (methodDescriptor) {
                     applyGuards(methodDescriptor, guards, methodName);
                     Object.defineProperty(prototype, methodName, methodDescriptor);
-                    Reflect.defineMetadata('guards', guards, prototype, methodName);
+                    Reflect.defineMetadata(enum_index.MetadataKey.Guards, guards, prototype, methodName);
                 }
             }
         }
@@ -263,7 +263,7 @@ export class ButtonInteractionGuard implements GuardInterface {
  */ function bindDependencies(container, cls) {
     if (!container.isBound(cls)) {
         container.bind(cls).toSelf().inSingletonScope();
-        const dependencies = Reflect.getMetadata('design:paramtypes', cls) || [];
+        const dependencies = Reflect.getMetadata(enum_index.MetadataKey.ParamTypes, cls) || [];
         dependencies.forEach((dep)=>bindDependencies(container, dep));
     }
 }
@@ -274,7 +274,7 @@ export class ButtonInteractionGuard implements GuardInterface {
  * @param {any} target - The target class whose dependencies are to be resolved.
  * @returns {any[]} - An array of resolved instances of the target's dependencies.
  */ function resolveDependencies(container, target) {
-    const injectables = Reflect.getMetadata('design:paramtypes', target) || [];
+    const injectables = Reflect.getMetadata(enum_index.MetadataKey.ParamTypes, target) || [];
     return injectables.map((dep)=>{
         bindDependencies(container, dep);
         return container.get(dep);
@@ -314,7 +314,7 @@ export class ButtonInteractionGuard implements GuardInterface {
  * ```
  **/ function MeoCord(options) {
     return (target)=>{
-        if (!Reflect.hasMetadata('inversify:injectable', target)) {
+        if (!Reflect.hasMetadata(enum_index.MetadataKey.Injectable, target)) {
             inversify.injectable()(target); // Make target injectable (inversify-specific)
         }
         const meocordConfig = theme.loadMeoCordConfig();
@@ -342,7 +342,7 @@ export class ButtonInteractionGuard implements GuardInterface {
             const dependencies = resolveDependencies(meocord_app.mainContainer, target);
             return new target(...dependencies);
         }).inSingletonScope();
-        Reflect.defineMetadata('inversify:container', meocord_app.mainContainer, target);
+        Reflect.defineMetadata(enum_index.MetadataKey.Container, meocord_app.mainContainer, target);
     };
 }
 

package/dist/cjs/enum/index.cjs

@@ -16,5 +16,37 @@ var CommandType = /*#__PURE__*/ function(CommandType) {
     return ReactionHandlerAction;
 }({});
 
+/**
+ * MeoCord Framework
+ * Copyright (c) 2025 Ukasyah Rahmatullah Zada
+ * SPDX-License-Identifier: MIT
+ */ /**
+ * Centralised metadata keys used across the framework's `Reflect` calls.
+ *
+ * Keeping them here prevents typos, documents the Inversify 8 key rename,
+ * and makes key changes a single-file edit.
+ */ var MetadataKey = /*#__PURE__*/ function(MetadataKey) {
+    /**
+   * Set by Inversify 8's `injectable()` decorator.
+   * Renamed from the legacy `'inversify:injectable'` string used in older versions.
+   */ MetadataKey["Injectable"] = "@inversifyjs/core/classIsInjectableFlagReflectKey";
+    /**
+   * Stores the Inversify `Container` instance on a `@Controller` or `@MeoCord` class.
+   * Read by `MeoCordFactory.create()` and `MeoCordApp` event handlers.
+   */ MetadataKey["Container"] = "inversify:container";
+    /**
+   * TypeScript compiler-emitted metadata listing constructor parameter types.
+   * Requires `"emitDecoratorMetadata": true` in tsconfig.
+   */ MetadataKey["ParamTypes"] = "design:paramtypes";
+    /**
+   * Stores the guard list applied to a method or class via `@UseGuard`.
+   */ MetadataKey["Guards"] = "guards";
+    /**
+   * Stores the `CommandType` on a `@CommandBuilder` class.
+   */ MetadataKey["CommandType"] = "commandType";
+    return MetadataKey;
+}({});
+
 exports.CommandType = CommandType;
+exports.MetadataKey = MetadataKey;
 exports.ReactionHandlerAction = ReactionHandlerAction;

package/dist/esm/core/meocord-factory.js

@@ -5,13 +5,14 @@ import { MeoCordApp } from './meocord.app.js';
 import { mainContainer } from '../decorator/container.js';
 import 'inversify';
 import 'discord.js';
+import { MetadataKey } from '../enum/metadata-key.enum.js';
 import 'path';
 import 'fs';
 import 'jiti';
 
 class MeoCordFactory {
     static create(target) {
-        const container = Reflect.getMetadata('inversify:container', target);
+        const container = Reflect.getMetadata(MetadataKey.Container, target);
         if (!container) {
             if (typeof target === 'function') {
                 this.logger.error(`No container found for class: ${target.name}`);

package/dist/esm/core/meocord.app.js

@@ -6,6 +6,7 @@ import { mainContainer } from '../decorator/container.js';
 import { sample } from 'lodash-es';
 import { createErrorEmbed } from '../util/embed.util.js';
 import { ReactionHandlerAction, CommandType } from '../enum/controller.enum.js';
+import { MetadataKey } from '../enum/metadata-key.enum.js';
 import CliTable3 from 'cli-table3';
 
 class MeoCordApp {
@@ -178,7 +179,7 @@ class MeoCordApp {
         for (const controller of relevantControllers){
             let controllerInstance = this.controllerInstancesCache.get(controller.constructor);
             if (!controllerInstance) {
-                const container = Reflect.getMetadata('inversify:container', controller.constructor);
+                const container = Reflect.getMetadata(MetadataKey.Container, controller.constructor);
                 controllerInstance = container.get(controller.constructor, {
                     autobind: true
                 });
@@ -211,7 +212,7 @@ class MeoCordApp {
         for (const controller of relevantControllers){
             let controllerInstance = this.controllerInstancesCache.get(controller.constructor);
             if (!controllerInstance) {
-                const container = Reflect.getMetadata('inversify:container', controller.constructor);
+                const container = Reflect.getMetadata(MetadataKey.Container, controller.constructor);
                 controllerInstance = container.get(controller.constructor, {
                     autobind: true
                 });

package/dist/esm/decorator/app.decorator.js

@@ -4,6 +4,7 @@ import { injectable } from 'inversify';
 import { Client } from 'discord.js';
 import { MeoCordApp } from '../core/meocord.app.js';
 import { loadMeoCordConfig } from '../util/meocord-config-loader.util.js';
+import { MetadataKey } from '../enum/metadata-key.enum.js';
 
 /**
  * Binds a class and its dependencies to the Inversify container in singleton scope.
@@ -13,7 +14,7 @@ import { loadMeoCordConfig } from '../util/meocord-config-loader.util.js';
  */ function bindDependencies(container, cls) {
     if (!container.isBound(cls)) {
         container.bind(cls).toSelf().inSingletonScope();
-        const dependencies = Reflect.getMetadata('design:paramtypes', cls) || [];
+        const dependencies = Reflect.getMetadata(MetadataKey.ParamTypes, cls) || [];
         dependencies.forEach((dep)=>bindDependencies(container, dep));
     }
 }
@@ -24,7 +25,7 @@ import { loadMeoCordConfig } from '../util/meocord-config-loader.util.js';
  * @param {any} target - The target class whose dependencies are to be resolved.
  * @returns {any[]} - An array of resolved instances of the target's dependencies.
  */ function resolveDependencies(container, target) {
-    const injectables = Reflect.getMetadata('design:paramtypes', target) || [];
+    const injectables = Reflect.getMetadata(MetadataKey.ParamTypes, target) || [];
     return injectables.map((dep)=>{
         bindDependencies(container, dep);
         return container.get(dep);
@@ -64,7 +65,7 @@ import { loadMeoCordConfig } from '../util/meocord-config-loader.util.js';
  * ```
  **/ function MeoCord(options) {
     return (target)=>{
-        if (!Reflect.hasMetadata('inversify:injectable', target)) {
+        if (!Reflect.hasMetadata(MetadataKey.Injectable, target)) {
             injectable()(target); // Make target injectable (inversify-specific)
         }
         const meocordConfig = loadMeoCordConfig();
@@ -92,7 +93,7 @@ import { loadMeoCordConfig } from '../util/meocord-config-loader.util.js';
             const dependencies = resolveDependencies(mainContainer, target);
             return new target(...dependencies);
         }).inSingletonScope();
-        Reflect.defineMetadata('inversify:container', mainContainer, target);
+        Reflect.defineMetadata(MetadataKey.Container, mainContainer, target);
     };
 }
 

package/dist/esm/decorator/command-builder.decorator.js

@@ -1,5 +1,6 @@
 import 'reflect-metadata';
 import { injectable } from 'inversify';
+import { MetadataKey } from '../enum/metadata-key.enum.js';
 
 /**
  * This decorator is used to mark a class as a Discord command builder that later can be registered on the `@Command` decorator.
@@ -21,11 +22,11 @@ import { injectable } from 'inversify';
  */ function CommandBuilder(commandType) {
     return function(target) {
         // Check if the class is already injectable; if not, make it injectable dynamically
-        if (!Reflect.hasMetadata('inversify:injectable', target)) {
+        if (!Reflect.hasMetadata(MetadataKey.Injectable, target)) {
             injectable()(target);
         }
         // Define the command type metadata for the target class
-        Reflect.defineMetadata('commandType', commandType, target);
+        Reflect.defineMetadata(MetadataKey.CommandType, commandType, target);
     };
 }
 

package/dist/esm/decorator/controller.decorator.js

@@ -3,6 +3,7 @@ import { injectable } from 'inversify';
 import { mainContainer } from './container.js';
 import { ButtonInteraction, StringSelectMenuInteraction, ChatInputCommandInteraction, ContextMenuCommandInteraction, ModalSubmitInteraction } from 'discord.js';
 import { CommandType } from '../enum/controller.enum.js';
+import { MetadataKey } from '../enum/metadata-key.enum.js';
 
 const COMMAND_METADATA_KEY = Symbol('commands');
 const MESSAGE_HANDLER_METADATA_KEY = Symbol('message_handlers');
@@ -147,7 +148,7 @@ const REACTION_HANDLER_METADATA_KEY = Symbol('reaction_handlers');
         if (typeof builderOrType === 'function') {
             const builderObj = new builderOrType();
             builderInstance = builderObj.build(commandName);
-            commandType = Reflect.getMetadata('commandType', builderOrType);
+            commandType = Reflect.getMetadata(MetadataKey.CommandType, builderOrType);
             if (!(commandType in CommandType)) {
                 throw new Error(`Metadata for 'commandType' is missing on builder ${builderOrType.name}`);
             }
@@ -199,19 +200,19 @@ const REACTION_HANDLER_METADATA_KEY = Symbol('reaction_handlers');
  * ```
  */ function Controller() {
     return function(target) {
-        if (!Reflect.hasMetadata('inversify:injectable', target)) {
+        if (!Reflect.hasMetadata(MetadataKey.Injectable, target)) {
             injectable()(target);
         }
-        const injectables = Reflect.getMetadata('design:paramtypes', target) || [];
+        const injectables = Reflect.getMetadata(MetadataKey.ParamTypes, target) || [];
         injectables.map((dep)=>{
             if (!mainContainer.isBound(dep)) {
-                if (!Reflect.hasMetadata('inversify:injectable', dep)) {
+                if (!Reflect.hasMetadata(MetadataKey.Injectable, dep)) {
                     injectable()(dep);
                 }
                 mainContainer.bind(dep).toSelf().inSingletonScope();
             }
         });
-        Reflect.defineMetadata('inversify:container', mainContainer, target);
+        Reflect.defineMetadata(MetadataKey.Container, mainContainer, target);
     };
 }
 

package/dist/esm/decorator/guard.decorator.js

@@ -3,6 +3,7 @@ import { injectable } from 'inversify';
 import { mainContainer } from './container.js';
 import { BaseInteraction, Message, MessageReaction } from 'discord.js';
 import { getCommandMap, getMessageHandlers, getReactionHandlers } from './controller.decorator.js';
+import { MetadataKey } from '../enum/metadata-key.enum.js';
 
 function isValidContext(context) {
     return context instanceof BaseInteraction || context instanceof Message || context instanceof MessageReaction;
@@ -74,12 +75,12 @@ export class ButtonInteractionGuard implements GuardInterface {
  */ function Guard() {
     return function(target) {
         // Check if the class is already injectable; if not, make it injectable dynamically
-        if (!Reflect.hasMetadata('inversify:injectable', target)) {
+        if (!Reflect.hasMetadata(MetadataKey.Injectable, target)) {
             injectable()(target);
         }
         mainContainer.bind(target).toSelf().inTransientScope();
         // Bind any dependencies that the guard requires
-        const injectables = Reflect.getMetadata('design:paramtypes', target) || [];
+        const injectables = Reflect.getMetadata(MetadataKey.ParamTypes, target) || [];
         injectables.forEach((dep)=>{
             if (!mainContainer.isBound(dep)) {
                 mainContainer.bind(dep).toSelf().inSingletonScope();
@@ -138,7 +139,7 @@ export class ButtonInteractionGuard implements GuardInterface {
             // Method Decorator
             applyGuards(descriptor, guards, String(propertyKey));
             // Store guard metadata for later access (if needed)
-            Reflect.defineMetadata('guards', guards, target, propertyKey);
+            Reflect.defineMetadata(MetadataKey.Guards, guards, target, propertyKey);
         } else if (typeof target === 'function' && !propertyKey && !descriptor) {
             // Class Decorator
             const prototype = target.prototype;
@@ -155,7 +156,7 @@ export class ButtonInteractionGuard implements GuardInterface {
                 if (methodDescriptor) {
                     applyGuards(methodDescriptor, guards, methodName);
                     Object.defineProperty(prototype, methodName, methodDescriptor);
-                    Reflect.defineMetadata('guards', guards, prototype, methodName);
+                    Reflect.defineMetadata(MetadataKey.Guards, guards, prototype, methodName);
                 }
             }
         }

package/dist/esm/decorator/service.decorator.js

@@ -2,6 +2,7 @@ import 'reflect-metadata';
 import { mainContainer } from './container.js';
 import { injectable } from 'inversify';
 import { Client } from 'discord.js';
+import { MetadataKey } from '../enum/metadata-key.enum.js';
 
 /**
  * `@Service()` decorator to mark a class as a service that can be injected into controllers or used as standalone services.
@@ -22,7 +23,7 @@ import { Client } from 'discord.js';
  */ function Service() {
     return function(target) {
         // Check if the class is already injectable; if not, make it injectable dynamically
-        if (!Reflect.hasMetadata('inversify:injectable', target)) {
+        if (!Reflect.hasMetadata(MetadataKey.Injectable, target)) {
             injectable()(target);
         }
         // Check if the class is already injectable; if not, make it injectable dynamically
@@ -36,14 +37,14 @@ import { Client } from 'discord.js';
 }
 function bindDependencies(target) {
     // Get the constructor parameter types using Reflect metadata
-    const dependencies = Reflect.getMetadata('design:paramtypes', target) || [];
+    const dependencies = Reflect.getMetadata(MetadataKey.ParamTypes, target) || [];
     dependencies.forEach((dep)=>{
         // Bind the dependency if not already bound
         if (!mainContainer.isBound(dep)) {
             if (dep.name === Client.name) return;
             try {
                 // Check if the class is already injectable; if not, make it injectable dynamically
-                if (!Reflect.hasMetadata('inversify:injectable', dep)) {
+                if (!Reflect.hasMetadata(MetadataKey.Injectable, dep)) {
                     injectable()(dep);
                 }
                 mainContainer.bind(dep).toSelf().inSingletonScope();

package/dist/esm/enum/index.js

@@ -1 +1,2 @@
 export { CommandType, ReactionHandlerAction } from './controller.enum.js';
+export { MetadataKey } from './metadata-key.enum.js';

package/dist/esm/enum/metadata-key.enum.js

@@ -0,0 +1,32 @@
+/**
+ * MeoCord Framework
+ * Copyright (c) 2025 Ukasyah Rahmatullah Zada
+ * SPDX-License-Identifier: MIT
+ */ /**
+ * Centralised metadata keys used across the framework's `Reflect` calls.
+ *
+ * Keeping them here prevents typos, documents the Inversify 8 key rename,
+ * and makes key changes a single-file edit.
+ */ var MetadataKey = /*#__PURE__*/ function(MetadataKey) {
+    /**
+   * Set by Inversify 8's `injectable()` decorator.
+   * Renamed from the legacy `'inversify:injectable'` string used in older versions.
+   */ MetadataKey["Injectable"] = "@inversifyjs/core/classIsInjectableFlagReflectKey";
+    /**
+   * Stores the Inversify `Container` instance on a `@Controller` or `@MeoCord` class.
+   * Read by `MeoCordFactory.create()` and `MeoCordApp` event handlers.
+   */ MetadataKey["Container"] = "inversify:container";
+    /**
+   * TypeScript compiler-emitted metadata listing constructor parameter types.
+   * Requires `"emitDecoratorMetadata": true` in tsconfig.
+   */ MetadataKey["ParamTypes"] = "design:paramtypes";
+    /**
+   * Stores the guard list applied to a method or class via `@UseGuard`.
+   */ MetadataKey["Guards"] = "guards";
+    /**
+   * Stores the `CommandType` on a `@CommandBuilder` class.
+   */ MetadataKey["CommandType"] = "commandType";
+    return MetadataKey;
+}({});
+
+export { MetadataKey };

package/dist/types/controller.enum-QA-IuReF.d.ts

@@ -0,0 +1,18 @@
+declare enum CommandType {
+    SLASH = "SLASH",
+    BUTTON = "BUTTON",
+    CONTEXT_MENU = "CONTEXT_MENU",
+    SELECT_MENU = "SELECT_MENU",
+    MODAL_SUBMIT = "MODAL_SUBMIT"
+}
+/**
+ * Enum representing actions that can be performed on a message reaction.
+ */
+declare enum ReactionHandlerAction {
+    /** Reaction added to a message. */
+    ADD = "ADD",
+    /** Reaction removed from a message. */
+    REMOVE = "REMOVE"
+}
+
+export { CommandType as C, ReactionHandlerAction as R };

package/dist/types/decorator/index.d.ts

@@ -1,4 +1,4 @@
-import { CommandType } from '../enum/index.js';
+import { C as CommandType } from '../controller.enum-QA-IuReF.js';
 import { SlashCommandBuilder, SlashCommandSubcommandsOnlyBuilder, ContextMenuCommandBuilder, ButtonInteraction, StringSelectMenuInteraction, ChatInputCommandInteraction, UserContextMenuCommandInteraction, MessageContextMenuCommandInteraction, ModalSubmitInteraction, OmitPartialGroupDMChannel, Message, MessageReaction, PartialMessageReaction, ClientOptions, ActivityOptions } from 'discord.js';
 import { ReactionHandlerOptions, GuardInterface } from '../interface/index.js';
 import { ServiceIdentifier, Container } from 'inversify';

package/dist/types/enum/index.d.ts

@@ -1,18 +1,40 @@
-declare enum CommandType {
-    SLASH = "SLASH",
-    BUTTON = "BUTTON",
-    CONTEXT_MENU = "CONTEXT_MENU",
-    SELECT_MENU = "SELECT_MENU",
-    MODAL_SUBMIT = "MODAL_SUBMIT"
-}
+export { C as CommandType, R as ReactionHandlerAction } from '../controller.enum-QA-IuReF.js';
+
+/**
+ * MeoCord Framework
+ * Copyright (c) 2025 Ukasyah Rahmatullah Zada
+ * SPDX-License-Identifier: MIT
+ */
 /**
- * Enum representing actions that can be performed on a message reaction.
+ * Centralised metadata keys used across the framework's `Reflect` calls.
+ *
+ * Keeping them here prevents typos, documents the Inversify 8 key rename,
+ * and makes key changes a single-file edit.
  */
-declare enum ReactionHandlerAction {
-    /** Reaction added to a message. */
-    ADD = "ADD",
-    /** Reaction removed from a message. */
-    REMOVE = "REMOVE"
+declare const enum MetadataKey {
+    /**
+     * Set by Inversify 8's `injectable()` decorator.
+     * Renamed from the legacy `'inversify:injectable'` string used in older versions.
+     */
+    Injectable = "@inversifyjs/core/classIsInjectableFlagReflectKey",
+    /**
+     * Stores the Inversify `Container` instance on a `@Controller` or `@MeoCord` class.
+     * Read by `MeoCordFactory.create()` and `MeoCordApp` event handlers.
+     */
+    Container = "inversify:container",
+    /**
+     * TypeScript compiler-emitted metadata listing constructor parameter types.
+     * Requires `"emitDecoratorMetadata": true` in tsconfig.
+     */
+    ParamTypes = "design:paramtypes",
+    /**
+     * Stores the guard list applied to a method or class via `@UseGuard`.
+     */
+    Guards = "guards",
+    /**
+     * Stores the `CommandType` on a `@CommandBuilder` class.
+     */
+    CommandType = "commandType"
 }
 
-export { CommandType, ReactionHandlerAction };
+export { MetadataKey };

package/dist/types/interface/index.d.ts

@@ -1,6 +1,6 @@
 import { User, PartialUser, BaseInteraction, Message, MessageReaction } from 'discord.js';
 import { Configuration } from 'webpack';
-import { ReactionHandlerAction } from '../enum/index.js';
+import { R as ReactionHandlerAction } from '../controller.enum-QA-IuReF.js';
 
 /**
  * MeoCord Framework

package/package.json

@@ -1,12 +1,16 @@
 {
   "name": "meocord",
   "description": "MeoCord is a lightweight and modular framework for building scalable Discord bots using TypeScript and Discord.js. It simplifies bot development with an extensible architecture, TypeScript-first approach, and powerful CLI tools.",
-  "version": "1.4.0",
+  "version": "1.4.1",
   "type": "module",
   "scripts": {
-    "lint": "eslint --fix . && tsc --noEmit",
+    "lint": "eslint --fix . && tsc --noEmit && tsc --noEmit --project tsconfig.test.json",
     "build": "rm -rf ./dist && rollup -c",
-    "prepare": "husky"
+    "prepare": "husky",
+    "test": "node --experimental-vm-modules node_modules/.bin/jest",
+    "test:watch": "node --experimental-vm-modules node_modules/.bin/jest --watch",
+    "test:coverage": "node --experimental-vm-modules node_modules/.bin/jest --coverage",
+    "test:typecheck": "bunx tsc --noEmit --project tsconfig.test.json"
   },
   "bin": "./dist/esm/bin/meocord.js",
   "repository": {
@@ -62,7 +66,7 @@
     "cli-table3": "^0.6.5",
     "commander": "^14.0.3",
     "dayjs": "^1.11.20",
-    "dotenv": "^17.4.1",
+    "dotenv": "^16.4.7",
     "inversify": "^8.1.0",
     "jiti": "^2.6.1",
     "lodash-es": "^4.18.1",
@@ -85,6 +89,8 @@
     "@semantic-release/exec": "^7.1.0",
     "@semantic-release/github": "^12.0.6",
     "@semantic-release/release-notes-generator": "^14.1.0",
+    "@swc/jest": "^0.2.39",
+    "@types/jest": "29",
     "@types/lodash-es": "^4.17.12",
     "@types/webpack-node-externals": "^3.0.4",
     "@typescript-eslint/parser": "^8.58.1",
@@ -97,6 +103,7 @@
     "eslint-plugin-unused-imports": "^4.4.1",
     "globals": "^17.4.0",
     "husky": "^9.1.7",
+    "jest": "29",
     "prettier": "^3.8.1",
     "rollup": "^4.60.1",
     "rollup-plugin-copy": "^3.5.0",