@spatulox/discord-module 0.2.1 → 0.3.0

package/CHANGELOG.md

@@ -0,0 +1,15 @@
+# Changelog
+Date format : dd/mm/yyy
+
+### 13/04/2026 - 0.3.0
+- InteractionManager : adds support for prefix and suffix identifier matching
+
+### 08/04/2026 - 0.2.1
+- Add usage example for InteractionManager
+
+### 08/04/2026 - 0.2.0
+- Introduce an InteractionManager to register interaction, same as module system
+
+### 18/03/2026 - 0.1.0
+- First official release
+- Add a Module system

package/README.md

@@ -16,6 +16,8 @@ Turn your Discord bot into independent modules that can be enabled or disabled a
 
     🔄 Hot reload : Enable/Disable problematic modules without restarting the bot !
 
+    ✅ Automatic Interactions Binding (name <-> function/method) : No more mess between interactions detection, dispatch and function/method call
+
     Discordjs : Always up to date and completely compatible
 
 ## 🎮 Usage (2 minutes)
@@ -55,13 +57,13 @@ Turn your Discord bot into independent modules that can be enabled or disabled a
 ```ts
 client.once(Events.ClientReady, () => {
     const manager = ModuleManager.createInstance(client); // ModuleManager is a singleton
-    const interactionManager = InteractionManager.createInstance(client); // ModuleManager is a singleton
+    const interactionManager = InteractionManager.createInstance(client); // InteractionManager is a singleton
     manager.register(new PongModule(client)); // You can register a Module or a MultiModule (Menu for Module)
     manager.enableAll(); // By default, a Module is disable
     manager.sendUIToChannel("channelID") // Optionnal, only if you want to dynamically toggle modules
 
     // Register commands
-    interaction.registerSlash("ping", PongModule.pong_interaction)
+    interactionManager.registerSlash("ping", PongModule.pong_interaction)
 });
 ```
 
@@ -69,4 +71,5 @@ client.once(Events.ClientReady, () => {
 |---------------------|------------------|---------------|
 | Hidden client.on    | ❌                | ✅             |
 | Live module enabled | ❌ (Need restart) | ✅ (One click) |
-| Organised           | ❌                | ✅             |
+| Organised           | ❌                | ✅             |
+| Automatic interaction binding           | ❌                | ✅             |

package/dist/index.d.mts

@@ -76,7 +76,14 @@ declare enum InteractionType {
     SLASH = "SLASH"
 }
 type InteractionHandler = (...args: any[]) => any;
+declare enum InteractionMatchType {
+    EXACT = 0,
+    START_WITH = 1,
+    END_WITH = 2
+}
 declare class InteractionsManager {
+    private startWithSet;
+    private endWithSet;
     private interactionMap;
     private client;
     private static instance;
@@ -88,17 +95,18 @@ declare class InteractionsManager {
     register(type: InteractionType, interaction: {
         name: string;
         func: InteractionHandler;
+        matchType: InteractionMatchType;
     }): boolean;
     private createMap;
     private _register;
-    registerAutocomplete(name: string, func: (...args: any[]) => any): boolean;
-    registerButton(name: string, func: (...args: any[]) => any): boolean;
-    registerMessageContextMenus(name: string, func: (...args: any[]) => any): boolean;
-    registerUserContextMenus(name: string, func: (...args: any[]) => any): boolean;
-    registerModal(name: string, func: (...args: any[]) => any): boolean;
-    registerPrimaryEntryPoint(name: string, func: (...args: any[]) => any): boolean;
-    registerSelectMenu(name: string, func: (...args: any[]) => any): boolean;
-    registerSlash(name: string, func: (...args: any[]) => any): boolean;
+    registerAutocomplete(name: string, func: (...args: any[]) => any, matchType?: InteractionMatchType): boolean;
+    registerButton(name: string, func: (...args: any[]) => any, matchType?: InteractionMatchType): boolean;
+    registerMessageContextMenus(name: string, func: (...args: any[]) => any, matchType?: InteractionMatchType): boolean;
+    registerUserContextMenus(name: string, func: (...args: any[]) => any, matchType?: InteractionMatchType): boolean;
+    registerModal(name: string, func: (...args: any[]) => any, matchType?: InteractionMatchType): boolean;
+    registerPrimaryEntryPoint(name: string, func: (...args: any[]) => any, matchType?: InteractionMatchType): boolean;
+    registerSelectMenu(name: string, func: (...args: any[]) => any, matchType?: InteractionMatchType): boolean;
+    registerSlash(name: string, func: (...args: any[]) => any, matchType?: InteractionMatchType): boolean;
 }
 
-export { InteractionType, InteractionsManager, Module, type ModuleEventsMap, ModuleManager, MultiModule };
+export { InteractionMatchType, InteractionType, InteractionsManager, Module, type ModuleEventsMap, ModuleManager, MultiModule };

package/dist/index.d.ts

@@ -76,7 +76,14 @@ declare enum InteractionType {
     SLASH = "SLASH"
 }
 type InteractionHandler = (...args: any[]) => any;
+declare enum InteractionMatchType {
+    EXACT = 0,
+    START_WITH = 1,
+    END_WITH = 2
+}
 declare class InteractionsManager {
+    private startWithSet;
+    private endWithSet;
     private interactionMap;
     private client;
     private static instance;
@@ -88,17 +95,18 @@ declare class InteractionsManager {
     register(type: InteractionType, interaction: {
         name: string;
         func: InteractionHandler;
+        matchType: InteractionMatchType;
     }): boolean;
     private createMap;
     private _register;
-    registerAutocomplete(name: string, func: (...args: any[]) => any): boolean;
-    registerButton(name: string, func: (...args: any[]) => any): boolean;
-    registerMessageContextMenus(name: string, func: (...args: any[]) => any): boolean;
-    registerUserContextMenus(name: string, func: (...args: any[]) => any): boolean;
-    registerModal(name: string, func: (...args: any[]) => any): boolean;
-    registerPrimaryEntryPoint(name: string, func: (...args: any[]) => any): boolean;
-    registerSelectMenu(name: string, func: (...args: any[]) => any): boolean;
-    registerSlash(name: string, func: (...args: any[]) => any): boolean;
+    registerAutocomplete(name: string, func: (...args: any[]) => any, matchType?: InteractionMatchType): boolean;
+    registerButton(name: string, func: (...args: any[]) => any, matchType?: InteractionMatchType): boolean;
+    registerMessageContextMenus(name: string, func: (...args: any[]) => any, matchType?: InteractionMatchType): boolean;
+    registerUserContextMenus(name: string, func: (...args: any[]) => any, matchType?: InteractionMatchType): boolean;
+    registerModal(name: string, func: (...args: any[]) => any, matchType?: InteractionMatchType): boolean;
+    registerPrimaryEntryPoint(name: string, func: (...args: any[]) => any, matchType?: InteractionMatchType): boolean;
+    registerSelectMenu(name: string, func: (...args: any[]) => any, matchType?: InteractionMatchType): boolean;
+    registerSlash(name: string, func: (...args: any[]) => any, matchType?: InteractionMatchType): boolean;
 }
 
-export { InteractionType, InteractionsManager, Module, type ModuleEventsMap, ModuleManager, MultiModule };
+export { InteractionMatchType, InteractionType, InteractionsManager, Module, type ModuleEventsMap, ModuleManager, MultiModule };

package/dist/index.js

@@ -20,6 +20,7 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
 // src/index.ts
 var index_exports = {};
 __export(index_exports, {
+  InteractionMatchType: () => InteractionMatchType,
   InteractionType: () => InteractionType,
   InteractionsManager: () => InteractionsManager,
   Module: () => Module,
@@ -311,7 +312,15 @@ var InteractionType = /* @__PURE__ */ ((InteractionType2) => {
   InteractionType2["SLASH"] = "SLASH";
   return InteractionType2;
 })(InteractionType || {});
+var InteractionMatchType = /* @__PURE__ */ ((InteractionMatchType2) => {
+  InteractionMatchType2[InteractionMatchType2["EXACT"] = 0] = "EXACT";
+  InteractionMatchType2[InteractionMatchType2["START_WITH"] = 1] = "START_WITH";
+  InteractionMatchType2[InteractionMatchType2["END_WITH"] = 2] = "END_WITH";
+  return InteractionMatchType2;
+})(InteractionMatchType || {});
 var InteractionsManager = class _InteractionsManager {
+  startWithSet = /* @__PURE__ */ new Set();
+  endWithSet = /* @__PURE__ */ new Set();
   interactionMap = {
     ["AUTOCOMPLETE" /* AUTOCOMPLETE */]: {},
     ["BUTTON" /* BUTTON */]: {},
@@ -336,10 +345,10 @@ var InteractionsManager = class _InteractionsManager {
     client.on(import_discord4.Events.InteractionCreate, async (interaction) => {
       const info = this.getInteractionInfo(interaction);
       if (!info) throw new Error("Interaction info not found");
-      const { type, identifier } = info;
+      const { type } = info;
       const map = this.interactionMap[type];
       if (map) {
-        await this.handle(map, identifier, interaction);
+        await this.handle(map, info, interaction);
       }
     });
   }
@@ -362,20 +371,46 @@ var InteractionsManager = class _InteractionsManager {
     if (interaction.isAutocomplete()) return { type: "AUTOCOMPLETE" /* AUTOCOMPLETE */, identifier: interaction.commandName };
     return void 0;
   }
-  async handle(interactionMap, name, interaction) {
-    const handler = interactionMap[name];
+  async handle(interactionMap, infos, interaction) {
+    let handler = interactionMap[infos.identifier];
+    if (handler) {
+      await handler(interaction);
+      return;
+    }
+    let prefix;
+    for (const key of this.startWithSet) {
+      if (infos.identifier.startsWith(key)) {
+        prefix = key;
+        break;
+      }
+    }
+    if (!prefix) {
+      for (const key of this.endWithSet) {
+        if (infos.identifier.endsWith(key)) {
+          prefix = key;
+          break;
+        }
+      }
+    }
+    if (prefix) {
+      handler = interactionMap[prefix];
+      if (handler) {
+        await handler(interaction);
+        return;
+      }
+    }
     if (!handler) {
-      throw new Error(`No handler registered for "${name}"`);
+      throw new Error(`No handler registered for "${infos.identifier}"`);
     }
-    await handler(interaction);
   }
   register(type, interaction) {
-    return this._register(type, { key: interaction.name, value: interaction.func });
+    return this._register(type, { key: interaction.name, value: interaction.func, matchType: interaction.matchType });
   }
-  createMap(name, func) {
+  createMap(name, func, matchType) {
     return {
       key: name,
-      value: func
+      value: func,
+      matchType
     };
   }
   _register(type, interaction) {
@@ -383,35 +418,42 @@ var InteractionsManager = class _InteractionsManager {
       throw new Error(`Duplicate entry when registering ${type}`);
     }
     this.interactionMap[type][interaction.key] = interaction.value;
+    if (interaction.matchType == 1 /* START_WITH */) {
+      this.startWithSet.add(interaction.key);
+    }
+    if (interaction.matchType == 0 /* EXACT */) {
+      this.endWithSet.add(interaction.key);
+    }
     return true;
   }
-  registerAutocomplete(name, func) {
-    return this._register("AUTOCOMPLETE" /* AUTOCOMPLETE */, this.createMap(name, func));
+  registerAutocomplete(name, func, matchType = 0 /* EXACT */) {
+    return this._register("AUTOCOMPLETE" /* AUTOCOMPLETE */, this.createMap(name, func, matchType));
   }
-  registerButton(name, func) {
-    return this._register("BUTTON" /* BUTTON */, this.createMap(name, func));
+  registerButton(name, func, matchType = 0 /* EXACT */) {
+    return this._register("BUTTON" /* BUTTON */, this.createMap(name, func, matchType));
   }
-  registerMessageContextMenus(name, func) {
-    return this._register("MESSAGE_CONTEXT_MENU" /* MESSAGE_CONTEXT_MENU */, this.createMap(name, func));
+  registerMessageContextMenus(name, func, matchType = 0 /* EXACT */) {
+    return this._register("MESSAGE_CONTEXT_MENU" /* MESSAGE_CONTEXT_MENU */, this.createMap(name, func, matchType));
   }
-  registerUserContextMenus(name, func) {
-    return this._register("USER_CONTEXT_MENU" /* USER_CONTEXT_MENU */, this.createMap(name, func));
+  registerUserContextMenus(name, func, matchType = 0 /* EXACT */) {
+    return this._register("USER_CONTEXT_MENU" /* USER_CONTEXT_MENU */, this.createMap(name, func, matchType));
   }
-  registerModal(name, func) {
-    return this._register("MODAL" /* MODAL */, this.createMap(name, func));
+  registerModal(name, func, matchType = 0 /* EXACT */) {
+    return this._register("MODAL" /* MODAL */, this.createMap(name, func, matchType));
   }
-  registerPrimaryEntryPoint(name, func) {
-    return this._register("PRIMARY_ENTRY_POINT" /* PRIMARY_ENTRY_POINT */, this.createMap(name, func));
+  registerPrimaryEntryPoint(name, func, matchType = 0 /* EXACT */) {
+    return this._register("PRIMARY_ENTRY_POINT" /* PRIMARY_ENTRY_POINT */, this.createMap(name, func, matchType));
   }
-  registerSelectMenu(name, func) {
-    return this._register("SELECT_MENU" /* SELECT_MENU */, this.createMap(name, func));
+  registerSelectMenu(name, func, matchType = 0 /* EXACT */) {
+    return this._register("SELECT_MENU" /* SELECT_MENU */, this.createMap(name, func, matchType));
   }
-  registerSlash(name, func) {
-    return this._register("SLASH" /* SLASH */, this.createMap(name, func));
+  registerSlash(name, func, matchType = 0 /* EXACT */) {
+    return this._register("SLASH" /* SLASH */, this.createMap(name, func, matchType));
   }
 };
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
+  InteractionMatchType,
   InteractionType,
   InteractionsManager,
   Module,

package/dist/index.mjs

@@ -300,7 +300,15 @@ var InteractionType = /* @__PURE__ */ ((InteractionType2) => {
   InteractionType2["SLASH"] = "SLASH";
   return InteractionType2;
 })(InteractionType || {});
+var InteractionMatchType = /* @__PURE__ */ ((InteractionMatchType2) => {
+  InteractionMatchType2[InteractionMatchType2["EXACT"] = 0] = "EXACT";
+  InteractionMatchType2[InteractionMatchType2["START_WITH"] = 1] = "START_WITH";
+  InteractionMatchType2[InteractionMatchType2["END_WITH"] = 2] = "END_WITH";
+  return InteractionMatchType2;
+})(InteractionMatchType || {});
 var InteractionsManager = class _InteractionsManager {
+  startWithSet = /* @__PURE__ */ new Set();
+  endWithSet = /* @__PURE__ */ new Set();
   interactionMap = {
     ["AUTOCOMPLETE" /* AUTOCOMPLETE */]: {},
     ["BUTTON" /* BUTTON */]: {},
@@ -325,10 +333,10 @@ var InteractionsManager = class _InteractionsManager {
     client.on(Events2.InteractionCreate, async (interaction) => {
       const info = this.getInteractionInfo(interaction);
       if (!info) throw new Error("Interaction info not found");
-      const { type, identifier } = info;
+      const { type } = info;
       const map = this.interactionMap[type];
       if (map) {
-        await this.handle(map, identifier, interaction);
+        await this.handle(map, info, interaction);
       }
     });
   }
@@ -351,20 +359,46 @@ var InteractionsManager = class _InteractionsManager {
     if (interaction.isAutocomplete()) return { type: "AUTOCOMPLETE" /* AUTOCOMPLETE */, identifier: interaction.commandName };
     return void 0;
   }
-  async handle(interactionMap, name, interaction) {
-    const handler = interactionMap[name];
+  async handle(interactionMap, infos, interaction) {
+    let handler = interactionMap[infos.identifier];
+    if (handler) {
+      await handler(interaction);
+      return;
+    }
+    let prefix;
+    for (const key of this.startWithSet) {
+      if (infos.identifier.startsWith(key)) {
+        prefix = key;
+        break;
+      }
+    }
+    if (!prefix) {
+      for (const key of this.endWithSet) {
+        if (infos.identifier.endsWith(key)) {
+          prefix = key;
+          break;
+        }
+      }
+    }
+    if (prefix) {
+      handler = interactionMap[prefix];
+      if (handler) {
+        await handler(interaction);
+        return;
+      }
+    }
     if (!handler) {
-      throw new Error(`No handler registered for "${name}"`);
+      throw new Error(`No handler registered for "${infos.identifier}"`);
     }
-    await handler(interaction);
   }
   register(type, interaction) {
-    return this._register(type, { key: interaction.name, value: interaction.func });
+    return this._register(type, { key: interaction.name, value: interaction.func, matchType: interaction.matchType });
   }
-  createMap(name, func) {
+  createMap(name, func, matchType) {
     return {
       key: name,
-      value: func
+      value: func,
+      matchType
     };
   }
   _register(type, interaction) {
@@ -372,34 +406,41 @@ var InteractionsManager = class _InteractionsManager {
       throw new Error(`Duplicate entry when registering ${type}`);
     }
     this.interactionMap[type][interaction.key] = interaction.value;
+    if (interaction.matchType == 1 /* START_WITH */) {
+      this.startWithSet.add(interaction.key);
+    }
+    if (interaction.matchType == 0 /* EXACT */) {
+      this.endWithSet.add(interaction.key);
+    }
     return true;
   }
-  registerAutocomplete(name, func) {
-    return this._register("AUTOCOMPLETE" /* AUTOCOMPLETE */, this.createMap(name, func));
+  registerAutocomplete(name, func, matchType = 0 /* EXACT */) {
+    return this._register("AUTOCOMPLETE" /* AUTOCOMPLETE */, this.createMap(name, func, matchType));
   }
-  registerButton(name, func) {
-    return this._register("BUTTON" /* BUTTON */, this.createMap(name, func));
+  registerButton(name, func, matchType = 0 /* EXACT */) {
+    return this._register("BUTTON" /* BUTTON */, this.createMap(name, func, matchType));
   }
-  registerMessageContextMenus(name, func) {
-    return this._register("MESSAGE_CONTEXT_MENU" /* MESSAGE_CONTEXT_MENU */, this.createMap(name, func));
+  registerMessageContextMenus(name, func, matchType = 0 /* EXACT */) {
+    return this._register("MESSAGE_CONTEXT_MENU" /* MESSAGE_CONTEXT_MENU */, this.createMap(name, func, matchType));
   }
-  registerUserContextMenus(name, func) {
-    return this._register("USER_CONTEXT_MENU" /* USER_CONTEXT_MENU */, this.createMap(name, func));
+  registerUserContextMenus(name, func, matchType = 0 /* EXACT */) {
+    return this._register("USER_CONTEXT_MENU" /* USER_CONTEXT_MENU */, this.createMap(name, func, matchType));
   }
-  registerModal(name, func) {
-    return this._register("MODAL" /* MODAL */, this.createMap(name, func));
+  registerModal(name, func, matchType = 0 /* EXACT */) {
+    return this._register("MODAL" /* MODAL */, this.createMap(name, func, matchType));
   }
-  registerPrimaryEntryPoint(name, func) {
-    return this._register("PRIMARY_ENTRY_POINT" /* PRIMARY_ENTRY_POINT */, this.createMap(name, func));
+  registerPrimaryEntryPoint(name, func, matchType = 0 /* EXACT */) {
+    return this._register("PRIMARY_ENTRY_POINT" /* PRIMARY_ENTRY_POINT */, this.createMap(name, func, matchType));
   }
-  registerSelectMenu(name, func) {
-    return this._register("SELECT_MENU" /* SELECT_MENU */, this.createMap(name, func));
+  registerSelectMenu(name, func, matchType = 0 /* EXACT */) {
+    return this._register("SELECT_MENU" /* SELECT_MENU */, this.createMap(name, func, matchType));
   }
-  registerSlash(name, func) {
-    return this._register("SLASH" /* SLASH */, this.createMap(name, func));
+  registerSlash(name, func, matchType = 0 /* EXACT */) {
+    return this._register("SLASH" /* SLASH */, this.createMap(name, func, matchType));
   }
 };
 export {
+  InteractionMatchType,
   InteractionType,
   InteractionsManager,
   Module,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@spatulox/discord-module",
-  "version": "0.2.1",
+  "version": "0.3.0",
   "description": "Automatic Module Manager for Discordjs",
   "main": "dist/index.js",
   "scripts": {
@@ -27,7 +27,7 @@
   "keywords": [
     "discordjs",
     "discord",
-    "framwork",
+    "framework",
     "modules"
   ],
   "author": "Spatulox",