@nodemod/core 1.0.4 → 1.0.5

package/dist/core/cmd.d.ts

@@ -29,23 +29,28 @@ export interface ServerCommandContext {
     /** Array of parsed command arguments, including the command name as the first element */
     args: string[];
 }
+/** Return type for command handlers - can be sync or async */
+type CommandResult = nodemod.META_RES | void | Promise<nodemod.META_RES | void>;
 /**
  * Handler function for console commands (client or server).
+ * Can optionally return a META_RES value to set the result.
  */
 export interface CommandHandler {
-    (ctx: CommandContext): void;
+    (ctx: CommandContext): CommandResult;
 }
 /**
  * Handler function for client commands.
+ * Can optionally return a META_RES value to set the result.
  */
 export interface ClientCommandHandler {
-    (ctx: ClientCommandContext): void;
+    (ctx: ClientCommandContext): CommandResult;
 }
 /**
  * Handler function for server commands.
+ * Can optionally return a META_RES value to set the result.
  */
 export interface ServerCommandHandler {
-    (ctx: ServerCommandContext): void;
+    (ctx: ServerCommandContext): CommandResult;
 }
 /**
  * Configuration options for registering a command.
@@ -104,11 +109,20 @@ export default class NodemodCmd {
      */
     constructor();
     /**
-     * Retrieves a registered command by name and type.
+     * Retrieves all registered commands by name and type.
+     *
+     * @param commandName - The name of the command to find
+     * @param type - The type of command ('client', 'server', or 'console')
+     * @returns Array of matching command options
+     */
+    getCommands(commandName: string, type: string): CommandOptions[];
+    /**
+     * Retrieves a registered command by name and type (first match only).
      *
      * @param commandName - The name of the command to find
      * @param type - The type of command ('client' or 'server')
      * @returns The command options if found, undefined otherwise
+     * @deprecated Use getCommands() for multiple handlers
      */
     getCommand(commandName: string, type: string): CommandOptions | undefined;
     /**
@@ -143,6 +157,7 @@ export default class NodemodCmd {
      * Convenience method to register a console command that works from both client and server.
      * Similar to AMXX console commands - can be executed by clients or from server console.
      * The handler receives the client (null if from console) and arguments.
+     * Can optionally return a META_RES value to set the result.
      *
      * @param name - The command name
      * @param handler - Function that receives the client entity (or null) and arguments
@@ -155,30 +170,34 @@ export default class NodemodCmd {
      *   } else {
      *     console.log('Server console requested status');
      *   }
+     *   return nodemod.META_RES.SUPERCEDE; // optional
      * });
      * ```
      */
-    register(name: string, handler: (client: nodemod.Entity | null, args: string[]) => void): void;
+    register(name: string, handler: (client: nodemod.Entity | null, args: string[]) => CommandResult): void;
     /**
      * Convenience method to register a client-only command with a simplified handler signature.
      * The handler receives the client entity and arguments (excluding the command name).
+     * Can optionally return a META_RES value to set the result.
      *
      * @param name - The command name
      * @param handler - Function that receives the client and arguments
      *
      * @example
      * ```typescript
-     * nodemodCore.cmd.registerClient('kick', (client, args) => {
-     *   const targetName = args[0];
-     *   const reason = args.slice(1).join(' ');
-     *   console.log(`${client.name} wants to kick ${targetName}: ${reason}`);
+     * nodemodCore.cmd.registerClient('say', (client, args) => {
+     *   const message = args.join(' ');
+     *   console.log(`${client.name} said: ${message}`);
+     *   // No return = IGNORED, chat passes through to engine
+     *   // return nodemod.META_RES.SUPERCEDE; // to block the chat
      * });
      * ```
      */
-    registerClient(name: string, handler: (client: nodemod.Entity, args: string[]) => void): void;
+    registerClient(name: string, handler: (client: nodemod.Entity, args: string[]) => CommandResult): void;
     /**
      * Convenience method to register a server command with a simplified handler signature.
      * The handler receives the arguments (excluding the command name) but no client entity.
+     * Can optionally return a META_RES value to set the result.
      *
      * @param name - The command name
      * @param handler - Function that receives the command arguments
@@ -192,7 +211,7 @@ export default class NodemodCmd {
      * });
      * ```
      */
-    registerServer(name: string, handler: (args: string[]) => void): void;
+    registerServer(name: string, handler: (args: string[]) => CommandResult): void;
     /**
      * Executes a server command through the native engine.
      * Automatically appends a newline character to the command.
@@ -208,4 +227,5 @@ export default class NodemodCmd {
      */
     run(command: string): void;
 }
+export {};
 //# sourceMappingURL=cmd.d.ts.map

package/dist/core/cmd.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"cmd.d.ts","sourceRoot":"","sources":["../../src/core/cmd.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,oDAAoD;IACpD,IAAI,EAAE,MAAM,CAAC;IACb,yFAAyF;IACzF,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,4EAA4E;IAC5E,MAAM,EAAE,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;CAC/B;AAED;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,oDAAoD;IACpD,IAAI,EAAE,MAAM,CAAC;IACb,yFAAyF;IACzF,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,gDAAgD;IAChD,MAAM,EAAE,OAAO,CAAC,MAAM,CAAC;CACxB;AAED;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,sCAAsC;IACtC,IAAI,EAAE,MAAM,CAAC;IACb,yFAAyF;IACzF,IAAI,EAAE,MAAM,EAAE,CAAC;CAChB;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,CAAC,GAAG,EAAE,cAAc,GAAG,IAAI,CAAC;CAC7B;AAED;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,CAAC,GAAG,EAAE,oBAAoB,GAAG,IAAI,CAAC;CACnC;AAED;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,CAAC,GAAG,EAAE,oBAAoB,GAAG,IAAI,CAAC;CACnC;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,wCAAwC;IACxC,IAAI,EAAE,MAAM,CAAC;IACb,2DAA2D;IAC3D,IAAI,EAAE,SAAS,GAAG,QAAQ,GAAG,QAAQ,CAAC;IACtC,kEAAkE;IAClE,OAAO,EAAE,cAAc,GAAG,oBAAoB,GAAG,oBAAoB,CAAC;CACvE;AAID;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,MAAM,CAAC,OAAO,OAAO,UAAU;IAC7B,mCAAmC;IACnC,OAAO,CAAC,QAAQ,CAAwB;IAExC;;;;;;;;;;;OAWG;IACH,OAAO,CAAC,YAAY;IA8BpB;;;OAGG;;IAuBH;;;;;;OAMG;IACH,UAAU,CAAC,WAAW,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,cAAc,GAAG,SAAS;IAIzE;;;;;;;;;;;;;;;;;;;;;;;;;;OA0BG;IACH,GAAG,CAAC,OAAO,EAAE,cAAc,GAAG,IAAI;IA2ClC;;;;;;;;;;;;;;;;;;OAkBG;IACH,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,MAAM,EAAE,OAAO,CAAC,MAAM,GAAG,IAAI,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,IAAI,GAAG,IAAI;IAQ9F;;;;;;;;;;;;;;;OAeG;IACH,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,MAAM,EAAE,OAAO,CAAC,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,IAAI,GAAG,IAAI;IAQ7F;;;;;;;;;;;;;;;OAeG;IACH,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,IAAI,GAAG,IAAI;IASrE;;;;;;;;;;;;OAYG;IACH,GAAG,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;CAG3B"}
+{"version":3,"file":"cmd.d.ts","sourceRoot":"","sources":["../../src/core/cmd.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,oDAAoD;IACpD,IAAI,EAAE,MAAM,CAAC;IACb,yFAAyF;IACzF,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,4EAA4E;IAC5E,MAAM,EAAE,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;CAC/B;AAED;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,oDAAoD;IACpD,IAAI,EAAE,MAAM,CAAC;IACb,yFAAyF;IACzF,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,gDAAgD;IAChD,MAAM,EAAE,OAAO,CAAC,MAAM,CAAC;CACxB;AAED;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,sCAAsC;IACtC,IAAI,EAAE,MAAM,CAAC;IACb,yFAAyF;IACzF,IAAI,EAAE,MAAM,EAAE,CAAC;CAChB;AAED,8DAA8D;AAC9D,KAAK,aAAa,GAAG,OAAO,CAAC,QAAQ,GAAG,IAAI,GAAG,OAAO,CAAC,OAAO,CAAC,QAAQ,GAAG,IAAI,CAAC,CAAC;AAEhF;;;GAGG;AACH,MAAM,WAAW,cAAc;IAC7B,CAAC,GAAG,EAAE,cAAc,GAAG,aAAa,CAAC;CACtC;AAED;;;GAGG;AACH,MAAM,WAAW,oBAAoB;IACnC,CAAC,GAAG,EAAE,oBAAoB,GAAG,aAAa,CAAC;CAC5C;AAED;;;GAGG;AACH,MAAM,WAAW,oBAAoB;IACnC,CAAC,GAAG,EAAE,oBAAoB,GAAG,aAAa,CAAC;CAC5C;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,wCAAwC;IACxC,IAAI,EAAE,MAAM,CAAC;IACb,2DAA2D;IAC3D,IAAI,EAAE,SAAS,GAAG,QAAQ,GAAG,QAAQ,CAAC;IACtC,kEAAkE;IAClE,OAAO,EAAE,cAAc,GAAG,oBAAoB,GAAG,oBAAoB,CAAC;CACvE;AAID;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,MAAM,CAAC,OAAO,OAAO,UAAU;IAC7B,mCAAmC;IACnC,OAAO,CAAC,QAAQ,CAAwB;IAExC;;;;;;;;;;;OAWG;IACH,OAAO,CAAC,YAAY;IA8BpB;;;OAGG;;IAoDH;;;;;;OAMG;IACH,WAAW,CAAC,WAAW,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,cAAc,EAAE;IAIhE;;;;;;;OAOG;IACH,UAAU,CAAC,WAAW,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,cAAc,GAAG,SAAS;IAIzE;;;;;;;;;;;;;;;;;;;;;;;;;;OA0BG;IACH,GAAG,CAAC,OAAO,EAAE,cAAc,GAAG,IAAI;IA2ClC;;;;;;;;;;;;;;;;;;;;OAoBG;IACH,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,MAAM,EAAE,OAAO,CAAC,MAAM,GAAG,IAAI,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,aAAa,GAAG,IAAI;IAQvG;;;;;;;;;;;;;;;;;OAiBG;IACH,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,MAAM,EAAE,OAAO,CAAC,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,aAAa,GAAG,IAAI;IAQtG;;;;;;;;;;;;;;;;OAgBG;IACH,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,aAAa,GAAG,IAAI;IAS9E;;;;;;;;;;;;OAYG;IACH,GAAG,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;CAG3B"}

package/dist/core/cmd.js

@@ -73,29 +73,64 @@ class NodemodCmd {
      */
     constructor() {
         nodemod.on('dllClientCommand', (client, rtext) => {
+            // Check if a previous listener already blocked this command
+            if (nodemod.getMetaResult() === 4 /* nodemod.META_RES.SUPERCEDE */) {
+                return;
+            }
             const args = this.parseCommand(rtext);
             const commandName = args[0];
-            const command = this.getCommand(commandName, 'client') || this.getCommand(commandName, 'console');
-            if (!command) {
+            // Get matching commands by type
+            const clientCommands = this.getCommands(commandName, 'client');
+            const consoleCommands = this.getCommands(commandName, 'console');
+            const commands = [...clientCommands, ...consoleCommands];
+            if (commands.length === 0) {
                 return;
             }
-            nodemod.setMetaResult(4 /* nodemod.META_RES.SUPERCEDE */); // Supercede the command
-            if (command.type === 'client') {
-                const ctx = { text: rtext, args, client };
-                return command.handler(ctx);
+            // Execute all registered handlers, stopping if one sets SUPERCEDE
+            for (const command of commands) {
+                let result;
+                if (command.type === 'client') {
+                    const ctx = { text: rtext, args, client };
+                    result = command.handler(ctx);
+                }
+                else {
+                    const ctx = { text: rtext, args, client };
+                    result = command.handler(ctx);
+                }
+                // If handler returned a sync META_RES value, set it (ignore Promises)
+                if (typeof result === 'number') {
+                    nodemod.setMetaResult(result);
+                }
+                // Check if handler blocked the command - stop processing further handlers
+                const mres = nodemod.getMetaResult();
+                if (mres === 4 /* nodemod.META_RES.SUPERCEDE */) {
+                    break;
+                }
             }
-            else {
-                const ctx = { text: rtext, args, client };
-                return command.handler(ctx);
+            // Auto-SUPERCEDE only for console commands (register/registerServer)
+            // Client-only commands (registerClient) let the plugin decide
+            if (clientCommands.length === 0 && nodemod.getMetaResult() === 1 /* nodemod.META_RES.IGNORED */) {
+                nodemod.setMetaResult(4 /* nodemod.META_RES.SUPERCEDE */);
             }
         });
     }
     /**
-     * Retrieves a registered command by name and type.
+     * Retrieves all registered commands by name and type.
+     *
+     * @param commandName - The name of the command to find
+     * @param type - The type of command ('client', 'server', or 'console')
+     * @returns Array of matching command options
+     */
+    getCommands(commandName, type) {
+        return this.commands.filter(v => v.name === commandName && v.type === type);
+    }
+    /**
+     * Retrieves a registered command by name and type (first match only).
      *
      * @param commandName - The name of the command to find
      * @param type - The type of command ('client' or 'server')
      * @returns The command options if found, undefined otherwise
+     * @deprecated Use getCommands() for multiple handlers
      */
     getCommand(commandName, type) {
         return this.commands.find(v => v.name === commandName && v.type === type);
@@ -175,6 +210,7 @@ class NodemodCmd {
      * Convenience method to register a console command that works from both client and server.
      * Similar to AMXX console commands - can be executed by clients or from server console.
      * The handler receives the client (null if from console) and arguments.
+     * Can optionally return a META_RES value to set the result.
      *
      * @param name - The command name
      * @param handler - Function that receives the client entity (or null) and arguments
@@ -187,6 +223,7 @@ class NodemodCmd {
      *   } else {
      *     console.log('Server console requested status');
      *   }
+     *   return nodemod.META_RES.SUPERCEDE; // optional
      * });
      * ```
      */
@@ -200,16 +237,18 @@ class NodemodCmd {
     /**
      * Convenience method to register a client-only command with a simplified handler signature.
      * The handler receives the client entity and arguments (excluding the command name).
+     * Can optionally return a META_RES value to set the result.
      *
      * @param name - The command name
      * @param handler - Function that receives the client and arguments
      *
      * @example
      * ```typescript
-     * nodemodCore.cmd.registerClient('kick', (client, args) => {
-     *   const targetName = args[0];
-     *   const reason = args.slice(1).join(' ');
-     *   console.log(`${client.name} wants to kick ${targetName}: ${reason}`);
+     * nodemodCore.cmd.registerClient('say', (client, args) => {
+     *   const message = args.join(' ');
+     *   console.log(`${client.name} said: ${message}`);
+     *   // No return = IGNORED, chat passes through to engine
+     *   // return nodemod.META_RES.SUPERCEDE; // to block the chat
      * });
      * ```
      */
@@ -223,6 +262,7 @@ class NodemodCmd {
     /**
      * Convenience method to register a server command with a simplified handler signature.
      * The handler receives the arguments (excluding the command name) but no client entity.
+     * Can optionally return a META_RES value to set the result.
      *
      * @param name - The command name
      * @param handler - Function that receives the command arguments

package/dist/core/cmd.js.map

@@ -1 +1 @@
-{"version":3,"file":"cmd.js","sourceRoot":"","sources":["../../src/core/cmd.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"cmd.js","sourceRoot":"","sources":["../../src/core/cmd.ts"],"names":[],"mappings":";;AAyEA,0DAA0D;AAE1D;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,MAAqB,UAAU;IAC7B,mCAAmC;IAC3B,QAAQ,GAAqB,EAAE,CAAC;IAExC;;;;;;;;;;;OAWG;IACK,YAAY,CAAC,OAAe;QAClC,MAAM,IAAI,GAAa,EAAE,CAAC;QAC1B,IAAI,OAAO,GAAG,EAAE,CAAC;QACjB,IAAI,QAAQ,GAAG,KAAK,CAAC;QACrB,IAAI,CAAC,GAAG,CAAC,CAAC;QAEV,OAAO,CAAC,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;YAC1B,MAAM,IAAI,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;YAExB,IAAI,IAAI,KAAK,GAAG,EAAE,CAAC;gBACjB,QAAQ,GAAG,CAAC,QAAQ,CAAC;YACvB,CAAC;iBAAM,IAAI,IAAI,KAAK,GAAG,IAAI,CAAC,QAAQ,EAAE,CAAC;gBACrC,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;oBACvB,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;oBACnB,OAAO,GAAG,EAAE,CAAC;gBACf,CAAC;YACH,CAAC;iBAAM,CAAC;gBACN,OAAO,IAAI,IAAI,CAAC;YAClB,CAAC;YACD,CAAC,EAAE,CAAC;QACN,CAAC;QAED,wCAAwC;QACxC,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACvB,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QACrB,CAAC;QAED,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;;OAGG;IACH;QACE,OAAO,CAAC,EAAE,CAAC,kBAAkB,EAAE,CAAC,MAAsB,EAAE,KAAa,EAAE,EAAE;YACvE,4DAA4D;YAC5D,IAAI,OAAO,CAAC,aAAa,EAAE,uCAA+B,EAAE,CAAC;gBAC3D,OAAO;YACT,CAAC;YAED,MAAM,IAAI,GAAG,IAAI,CAAC,YAAY,CAAC,KAAK,CAAC,CAAC;YACtC,MAAM,WAAW,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;YAE5B,gCAAgC;YAChC,MAAM,cAAc,GAAG,IAAI,CAAC,WAAW,CAAC,WAAW,EAAE,QAAQ,CAAC,CAAC;YAC/D,MAAM,eAAe,GAAG,IAAI,CAAC,WAAW,CAAC,WAAW,EAAE,SAAS,CAAC,CAAC;YACjE,MAAM,QAAQ,GAAG,CAAC,GAAG,cAAc,EAAE,GAAG,eAAe,CAAC,CAAC;YAEzD,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;gBAC1B,OAAO;YACT,CAAC;YAED,kEAAkE;YAClE,KAAK,MAAM,OAAO,IAAI,QAAQ,EAAE,CAAC;gBAC/B,IAAI,MAAqB,CAAC;gBAE1B,IAAI,OAAO,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;oBAC9B,MAAM,GAAG,GAAyB,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC;oBAChE,MAAM,GAAI,OAAO,CAAC,OAAgC,CAAC,GAAG,CAAC,CAAC;gBAC1D,CAAC;qBAAM,CAAC;oBACN,MAAM,GAAG,GAAmB,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC;oBAC1D,MAAM,GAAI,OAAO,CAAC,OAA0B,CAAC,GAAG,CAAC,CAAC;gBACpD,CAAC;gBAED,sEAAsE;gBACtE,IAAI,OAAO,MAAM,KAAK,QAAQ,EAAE,CAAC;oBAC/B,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,CAAC;gBAChC,CAAC;gBAED,0EAA0E;gBAC1E,MAAM,IAAI,GAAG,OAAO,CAAC,aAAa,EAAE,CAAC;gBACrC,IAAI,IAAI,uCAA+B,EAAE,CAAC;oBACxC,MAAM;gBACR,CAAC;YACH,CAAC;YAED,qEAAqE;YACrE,8DAA8D;YAC9D,IAAI,cAAc,CAAC,MAAM,KAAK,CAAC,IAAI,OAAO,CAAC,aAAa,EAAE,qCAA6B,EAAE,CAAC;gBACxF,OAAO,CAAC,aAAa,oCAA4B,CAAC;YACpD,CAAC;QACH,CAAC,CAAC,CAAC;IACL,CAAC;IAED;;;;;;OAMG;IACH,WAAW,CAAC,WAAmB,EAAE,IAAY;QAC3C,OAAO,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,WAAW,IAAI,CAAC,CAAC,IAAI,KAAK,IAAI,CAAC,CAAC;IAC9E,CAAC;IAED;;;;;;;OAOG;IACH,UAAU,CAAC,WAAmB,EAAE,IAAY;QAC1C,OAAO,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,WAAW,IAAI,CAAC,CAAC,IAAI,KAAK,IAAI,CAAC,CAAC;IAC5E,CAAC;IAED;;;;;;;;;;;;;;;;;;;;;;;;;;OA0BG;IACH,GAAG,CAAC,OAAuB;QACzB,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QAE5B,uDAAuD;QACvD,IAAI,OAAO,CAAC,IAAI,KAAK,QAAQ,IAAI,OAAO,CAAC,IAAI,KAAK,SAAS,EAAE,CAAC;YAC5D,0EAA0E;YAC1E,IAAI,OAAO,CAAC,IAAI,KAAK,SAAS,EAAE,CAAC;gBAC/B,MAAM,cAAc,GAAG,GAAG,EAAE;oBAC1B,IAAI,CAAC;wBACH,MAAM,QAAQ,GAAG,OAAO,CAAC,GAAG,CAAC,OAAO,EAAE,CAAC;wBACvC,MAAM,IAAI,GAAa,EAAE,CAAC;wBAC1B,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,QAAQ,EAAE,CAAC,EAAE,EAAE,CAAC;4BAClC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC;wBACpC,CAAC;wBACD,MAAM,IAAI,GAAG,OAAO,CAAC,GAAG,CAAC,OAAO,EAAE,CAAC;wBACnC,MAAM,GAAG,GAAmB,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC;wBACxD,OAAO,CAAC,OAA0B,CAAC,GAAG,CAAC,CAAC;oBAC3C,CAAC;oBAAC,OAAO,GAAG,EAAE,CAAC;wBACb,OAAO,CAAC,KAAK,CAAC,6BAA6B,OAAO,CAAC,IAAI,IAAI,EAAE,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;oBACvG,CAAC;gBACH,CAAC,CAAC;gBACF,OAAO,CAAC,GAAG,CAAC,gBAAgB,CAAC,OAAO,CAAC,IAAI,EAAE,cAAqB,CAAC,CAAC;YACpE,CAAC;iBAAM,CAAC;gBACN,mEAAmE;gBACnE,MAAM,aAAa,GAAG,GAAG,EAAE;oBACzB,IAAI,CAAC;wBACH,MAAM,QAAQ,GAAG,OAAO,CAAC,GAAG,CAAC,OAAO,EAAE,CAAC;wBACvC,MAAM,IAAI,GAAa,EAAE,CAAC;wBAC1B,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,QAAQ,EAAE,CAAC,EAAE,EAAE,CAAC;4BAClC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC;wBACpC,CAAC;wBACD,MAAM,IAAI,GAAG,OAAO,CAAC,GAAG,CAAC,OAAO,EAAE,CAAC;wBACnC,MAAM,GAAG,GAAyB,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC;wBAChD,OAAO,CAAC,OAAgC,CAAC,GAAG,CAAC,CAAC;oBACjD,CAAC;oBAAC,OAAO,GAAG,EAAE,CAAC;wBACb,OAAO,CAAC,KAAK,CAAC,4BAA4B,OAAO,CAAC,IAAI,IAAI,EAAE,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;oBACtG,CAAC;gBACH,CAAC,CAAC;gBACF,OAAO,CAAC,GAAG,CAAC,gBAAgB,CAAC,OAAO,CAAC,IAAI,EAAE,aAAoB,CAAC,CAAC;YACnE,CAAC;QACH,CAAC;IACH,CAAC;IAED;;;;;;;;;;;;;;;;;;;;OAoBG;IACH,QAAQ,CAAC,IAAY,EAAE,OAAyE;QAC9F,IAAI,CAAC,GAAG,CAAC;YACP,IAAI;YACJ,IAAI,EAAE,SAAS;YACf,OAAO,EAAE,CAAC,GAAmB,EAAE,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;SACzE,CAAC,CAAC;IACL,CAAC;IAED;;;;;;;;;;;;;;;;;OAiBG;IACH,cAAc,CAAC,IAAY,EAAE,OAAkE;QAC7F,IAAI,CAAC,GAAG,CAAC;YACP,IAAI;YACJ,IAAI,EAAE,QAAQ;YACd,OAAO,EAAE,CAAC,GAAyB,EAAE,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;SAC/E,CAAC,CAAC;IACL,CAAC;IAED;;;;;;;;;;;;;;;;OAgBG;IACH,cAAc,CAAC,IAAY,EAAE,OAA0C;QACrE,IAAI,CAAC,GAAG,CAAC;YACP,IAAI;YACJ,IAAI,EAAE,QAAQ;YACd,OAAO,EAAE,CAAC,GAAyB,EAAE,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;SACnE,CAAC,CAAC;IACL,CAAC;IAGD;;;;;;;;;;;;OAYG;IACH,GAAG,CAAC,OAAe;QACjB,OAAO,CAAC,GAAG,CAAC,aAAa,CAAC,OAAO,GAAG,IAAI,CAAC,CAAC;IAC5C,CAAC;CACF;AAnSD,6BAmSC"}

package/dist/enhanced/events.d.ts

@@ -1,134 +1,41 @@
 /**
- * Internal event listener metadata for enhanced event management.
- */
-export interface EventListener<T extends keyof nodemod.EventCallbacks> {
-    /** The wrapped handler function */
-    handler: nodemod.EventCallbacks[T];
-    /** The original handler function */
-    original: nodemod.EventCallbacks[T];
-    /** Priority level for execution order */
-    priority: number;
-}
-/**
- * Options for configuring event listeners.
- */
-export interface EventOptions {
-    /** Execute the handler only once, then automatically remove it */
-    once?: boolean;
-    /** Priority level (higher numbers execute first) */
-    priority?: number;
-}
-/**
- * Enhanced player information for connection events.
- */
-export interface PlayerInfo {
-    /** Player entity */
-    entity: nodemod.Entity;
-    /** Player entity index */
-    id: number;
-    /** Player display name */
-    name: string;
-    /** Player IP address (if available) */
-    address?: string;
-    /** Player Steam ID */
-    steamId: string;
-    /** Player user ID (if available) */
-    userId?: number;
-}
-/**
- * Enhanced spawn information for entity/player spawn events.
- */
-export interface SpawnInfo {
-    /** Spawned entity */
-    entity: nodemod.Entity;
-    /** Entity index */
-    id: number;
-    /** Entity name (for players) */
-    name?: string;
-    /** Entity class name */
-    className: string;
-}
-/**
- * Frame timing and server state information.
+ * Enhanced event utilities providing convenience methods on top of nodemod's native events.
+ *
+ * Note: For low-level event handling that needs SUPERCEDE support, use nodemod.on() directly.
+ * This wrapper provides utilities like once(), waitFor(), throttle(), and debounce().
  */
-export interface FrameInfo {
-    /** Current server time */
-    time: number;
-    /** Current map name */
-    mapname: string;
-    /** Number of connected players */
-    playerCount: number;
-}
 /** Type alias for event handler functions */
 export type EventHandler<T extends keyof nodemod.EventCallbacks = keyof nodemod.EventCallbacks> = nodemod.EventCallbacks[T];
 /** Type alias for event filtering predicates */
 export type EventPredicate<T extends keyof nodemod.EventCallbacks = keyof nodemod.EventCallbacks> = (...args: Parameters<nodemod.EventCallbacks[T]>) => boolean;
-/** Type alias for event transformation functions */
-export type EventTransformer<T extends keyof nodemod.EventCallbacks = keyof nodemod.EventCallbacks> = (...args: Parameters<nodemod.EventCallbacks[T]>) => any;
 /**
- * Enhanced event system providing advanced event handling capabilities on top of nodemod's native events.
- * Features include priority-based execution, one-time listeners, event filtering, throttling, and debouncing.
+ * Enhanced event utilities for nodemod events.
  *
  * @example
  * ```typescript
- * // Basic event listening
- * nodemodCore.events.on('dllClientConnect', (entity, name) => {
- *   console.log(`${name} connected`);
- * });
- *
  * // One-time event listener
  * nodemodCore.events.once('dllSpawn', (entity) => {
  *   console.log('First spawn event received');
  * });
  *
- * // Priority-based event handling
- * nodemodCore.events.on('dllClientCommand', handleCommand, { priority: 10 });
- * nodemodCore.events.on('dllClientCommand', logCommand, { priority: 1 });
- *
- * // Event filtering
- * nodemodCore.events.filter('dllClientConnect',
- *   (entity, name) => name.startsWith('Admin'),
- *   (entity, name) => console.log(`Admin ${name} connected`)
- * );
- *
  * // Throttled events (max once per second)
  * nodemodCore.events.throttle('dllStartFrame', frameHandler, 1000);
+ *
+ * // Wait for event with timeout
+ * const [entity, name] = await nodemodCore.events.waitFor('dllClientConnect', 30000);
  * ```
  */
 export default class NodemodEvents {
-    /** Map of active event listeners organized by event name */
-    private eventListeners;
+    /** Map tracking wrapped handlers for removal */
+    private wrappedHandlers;
     /**
-     * Creates a new NodemodEvents instance and initializes enhanced event handlers.
+     * Adds an event listener. This is a simple wrapper around nodemod.on().
+     * For most cases, use nodemod.on() directly.
      */
-    constructor();
+    on<T extends keyof nodemod.EventCallbacks>(eventName: T, handler: nodemod.EventCallbacks[T]): this;
     /**
-     * Adds an event listener with enhanced options like priority and one-time execution.
-     *
-     * @param eventName - Name of the event to listen for
-     * @param handler - Function to execute when event occurs
-     * @param options - Additional options for the listener
-     * @returns This instance for method chaining
-     *
-     * @example
-     * ```typescript
-     * // Basic event listener
-     * nodemodCore.events.on('dllClientConnect', (entity, name) => {
-     *   console.log(`${name} joined the server`);
-     * });
-     *
-     * // High-priority listener (executes first)
-     * nodemodCore.events.on('dllClientCommand', (entity, command) => {
-     *   console.log('Processing command:', command);
-     * }, { priority: 100 });
-     *
-     * // One-time listener
-     * nodemodCore.events.on('dllSpawn', (entity) => {
-     *   console.log('First entity spawned');
-     * }, { once: true });
-     * ```
+     * Removes an event listener.
      */
-    on<T extends keyof nodemod.EventCallbacks>(eventName: T, handler: nodemod.EventCallbacks[T], options?: EventOptions): this;
     off<T extends keyof nodemod.EventCallbacks>(eventName: T, handler: nodemod.EventCallbacks[T]): this;
     /**
      * Adds a one-time event listener that automatically removes itself after first execution.
@@ -139,24 +46,14 @@ export default class NodemodEvents {
      *
      * @example
      * ```typescript
-     * // Listen for first player connection only
      * nodemodCore.events.once('dllClientConnect', (entity, name) => {
-     *   console.log(`First player ${name} connected - starting game logic`);
-     * });
-     *
-     * // Wait for map change
-     * nodemodCore.events.once('dllSpawn', () => {
-     *   console.log('Map fully loaded');
+     *   console.log(`First player ${name} connected`);
      * });
      * ```
      */
     once<T extends keyof nodemod.EventCallbacks>(eventName: T, handler: nodemod.EventCallbacks[T]): this;
-    clearListeners(eventName?: keyof nodemod.EventCallbacks): this;
-    getListeners<T extends keyof nodemod.EventCallbacks>(eventName: T): EventListener<T>[];
-    private initializeEvents;
     /**
      * Waits for a specific event to occur and returns its parameters as a promise.
-     * Useful for async/await patterns with events.
      *
      * @param eventName - Name of the event to wait for
      * @param timeout - Timeout in milliseconds (default: 10000)
@@ -164,16 +61,12 @@ export default class NodemodEvents {
      *
      * @example
      * ```typescript
-     * // Wait for player connection
      * try {
      *   const [entity, name] = await nodemodCore.events.waitFor('dllClientConnect', 30000);
      *   console.log(`Player ${name} connected within 30 seconds`);
      * } catch (error) {
      *   console.log('No player connected within timeout');
      * }
-     *
-     * // Wait for entity spawn with shorter timeout
-     * const [spawnedEntity] = await nodemodCore.events.waitFor('dllSpawn', 5000);
      * ```
      */
     waitFor<T extends keyof nodemod.EventCallbacks>(eventName: T, timeout?: number): Promise<Parameters<nodemod.EventCallbacks[T]>>;
@@ -187,24 +80,16 @@ export default class NodemodEvents {
      *
      * @example
      * ```typescript
-     * // Only handle commands from admins
      * nodemodCore.events.filter('dllClientCommand',
      *   (entity, command) => isAdmin(entity),
      *   (entity, command) => handleAdminCommand(entity, command)
      * );
-     *
-     * // Only handle player connections with specific names
-     * nodemodCore.events.filter('dllClientConnect',
-     *   (entity, name) => name.startsWith('VIP_'),
-     *   (entity, name) => grantVipAccess(entity)
-     * );
      * ```
      */
     filter<T extends keyof nodemod.EventCallbacks>(eventName: T, predicate: EventPredicate<T>, handler: nodemod.EventCallbacks[T]): this;
-    map<T extends keyof nodemod.EventCallbacks>(eventName: T, transformer: EventTransformer<T>, newEventName?: keyof nodemod.EventCallbacks): this;
     /**
      * Adds a throttled event listener that limits execution to once per specified interval.
-     * Useful for performance optimization with high-frequency events.
+     * Useful for performance optimization with high-frequency events like dllStartFrame.
      *
      * @param eventName - Name of the event to listen for
      * @param handler - Function to execute when event occurs
@@ -213,23 +98,15 @@ export default class NodemodEvents {
      *
      * @example
      * ```typescript
-     * // Throttle frame events to once per second
      * nodemodCore.events.throttle('dllStartFrame', () => {
      *   console.log('Frame update (max once per second)');
      * }, 1000);
-     *
-     * // Throttle player movement tracking
-     * nodemodCore.events.throttle('dllClientCommand', (entity, command) => {
-     *   if (command.startsWith('+move')) {
-     *     updatePlayerPosition(entity);
-     *   }
-     * }, 500); // Max twice per second
      * ```
      */
     throttle<T extends keyof nodemod.EventCallbacks>(eventName: T, handler: nodemod.EventCallbacks[T], delay?: number): this;
     /**
      * Adds a debounced event listener that delays execution until after the specified interval
-     * has passed since the last event occurrence. Useful for handling rapid successive events.
+     * has passed since the last event occurrence.
      *
      * @param eventName - Name of the event to listen for
      * @param handler - Function to execute when event occurs
@@ -238,14 +115,6 @@ export default class NodemodEvents {
      *
      * @example
      * ```typescript
-     * // Debounce player input to handle final command only
-     * nodemodCore.events.debounce('dllClientCommand', (entity, command) => {
-     *   if (command.startsWith('buy_')) {
-     *     processPurchase(entity, command);
-     *   }
-     * }, 300); // Wait 300ms after last buy command
-     *
-     * // Debounce entity spawning for batch processing
      * nodemodCore.events.debounce('dllSpawn', () => {
      *   console.log('Finished spawning entities');
      *   optimizeMapEntities();

package/dist/enhanced/events.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"events.d.ts","sourceRoot":"","sources":["../../src/enhanced/events.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,WAAW,aAAa,CAAC,CAAC,SAAS,MAAM,OAAO,CAAC,cAAc;IACnE,mCAAmC;IACnC,OAAO,EAAE,OAAO,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC;IACnC,oCAAoC;IACpC,QAAQ,EAAE,OAAO,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC;IACpC,yCAAyC;IACzC,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,kEAAkE;IAClE,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,oDAAoD;IACpD,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,oBAAoB;IACpB,MAAM,EAAE,OAAO,CAAC,MAAM,CAAC;IACvB,0BAA0B;IAC1B,EAAE,EAAE,MAAM,CAAC;IACX,0BAA0B;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,uCAAuC;IACvC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,sBAAsB;IACtB,OAAO,EAAE,MAAM,CAAC;IAChB,oCAAoC;IACpC,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED;;GAEG;AACH,MAAM,WAAW,SAAS;IACxB,qBAAqB;IACrB,MAAM,EAAE,OAAO,CAAC,MAAM,CAAC;IACvB,mBAAmB;IACnB,EAAE,EAAE,MAAM,CAAC;IACX,gCAAgC;IAChC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,wBAAwB;IACxB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,SAAS;IACxB,0BAA0B;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,uBAAuB;IACvB,OAAO,EAAE,MAAM,CAAC;IAChB,kCAAkC;IAClC,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,6CAA6C;AAC7C,MAAM,MAAM,YAAY,CAAC,CAAC,SAAS,MAAM,OAAO,CAAC,cAAc,GAAG,MAAM,OAAO,CAAC,cAAc,IAAI,OAAO,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC;AAE5H,gDAAgD;AAChD,MAAM,MAAM,cAAc,CAAC,CAAC,SAAS,MAAM,OAAO,CAAC,cAAc,GAAG,MAAM,OAAO,CAAC,cAAc,IAAI,CAAC,GAAG,IAAI,EAAE,UAAU,CAAC,OAAO,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC,KAAK,OAAO,CAAC;AAEhK,oDAAoD;AACpD,MAAM,MAAM,gBAAgB,CAAC,CAAC,SAAS,MAAM,OAAO,CAAC,cAAc,GAAG,MAAM,OAAO,CAAC,cAAc,IAAI,CAAC,GAAG,IAAI,EAAE,UAAU,CAAC,OAAO,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC,KAAK,GAAG,CAAC;AAI9J;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACH,MAAM,CAAC,OAAO,OAAO,aAAa;IAChC,4DAA4D;IAC5D,OAAO,CAAC,cAAc,CAA0F;IAEhH;;OAEG;;IAKH;;;;;;;;;;;;;;;;;;;;;;;;;OAyBG;IACH,EAAE,CAAC,CAAC,SAAS,MAAM,OAAO,CAAC,cAAc,EAAE,SAAS,EAAE,CAAC,EAAE,OAAO,EAAE,OAAO,CAAC,cAAc,CAAC,CAAC,CAAC,EAAE,OAAO,GAAE,YAAiB,GAAG,IAAI;IAyB9H,GAAG,CAAC,CAAC,SAAS,MAAM,OAAO,CAAC,cAAc,EAAE,SAAS,EAAE,CAAC,EAAE,OAAO,EAAE,OAAO,CAAC,cAAc,CAAC,CAAC,CAAC,GAAG,IAAI;IAkBnG;;;;;;;;;;;;;;;;;;;OAmBG;IACH,IAAI,CAAC,CAAC,SAAS,MAAM,OAAO,CAAC,cAAc,EAAE,SAAS,EAAE,CAAC,EAAE,OAAO,EAAE,OAAO,CAAC,cAAc,CAAC,CAAC,CAAC,GAAG,IAAI;IAKpG,cAAc,CAAC,SAAS,CAAC,EAAE,MAAM,OAAO,CAAC,cAAc,GAAG,IAAI;IAe9D,YAAY,CAAC,CAAC,SAAS,MAAM,OAAO,CAAC,cAAc,EAAE,SAAS,EAAE,CAAC,GAAG,aAAa,CAAC,CAAC,CAAC,EAAE;IAKtF,OAAO,CAAC,gBAAgB;IAiExB;;;;;;;;;;;;;;;;;;;;;OAqBG;IACH,OAAO,CAAC,CAAC,SAAS,MAAM,OAAO,CAAC,cAAc,EAAE,SAAS,EAAE,CAAC,EAAE,OAAO,GAAE,MAAc,GAAG,OAAO,CAAC,UAAU,CAAC,OAAO,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC,CAAC;IAgBtI;;;;;;;;;;;;;;;;;;;;;;OAsBG;IACH,MAAM,CAAC,CAAC,SAAS,MAAM,OAAO,CAAC,cAAc,EAAE,SAAS,EAAE,CAAC,EAAE,SAAS,EAAE,cAAc,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,OAAO,CAAC,cAAc,CAAC,CAAC,CAAC,GAAG,IAAI;IAWpI,GAAG,CAAC,CAAC,SAAS,MAAM,OAAO,CAAC,cAAc,EAAE,SAAS,EAAE,CAAC,EAAE,WAAW,EAAE,gBAAgB,CAAC,CAAC,CAAC,EAAE,YAAY,CAAC,EAAE,MAAM,OAAO,CAAC,cAAc,GAAG,IAAI;IAO9I;;;;;;;;;;;;;;;;;;;;;;;OAuBG;IACH,QAAQ,CAAC,CAAC,SAAS,MAAM,OAAO,CAAC,cAAc,EAAE,SAAS,EAAE,CAAC,EAAE,OAAO,EAAE,OAAO,CAAC,cAAc,CAAC,CAAC,CAAC,EAAE,KAAK,GAAE,MAAa,GAAG,IAAI;IAa9H;;;;;;;;;;;;;;;;;;;;;;;;OAwBG;IACH,QAAQ,CAAC,CAAC,SAAS,MAAM,OAAO,CAAC,cAAc,EAAE,SAAS,EAAE,CAAC,EAAE,OAAO,EAAE,OAAO,CAAC,cAAc,CAAC,CAAC,CAAC,EAAE,KAAK,GAAE,MAAa,GAAG,IAAI;CAS/H"}
+{"version":3,"file":"events.d.ts","sourceRoot":"","sources":["../../src/enhanced/events.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,6CAA6C;AAC7C,MAAM,MAAM,YAAY,CAAC,CAAC,SAAS,MAAM,OAAO,CAAC,cAAc,GAAG,MAAM,OAAO,CAAC,cAAc,IAAI,OAAO,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC;AAE5H,gDAAgD;AAChD,MAAM,MAAM,cAAc,CAAC,CAAC,SAAS,MAAM,OAAO,CAAC,cAAc,GAAG,MAAM,OAAO,CAAC,cAAc,IAAI,CAAC,GAAG,IAAI,EAAE,UAAU,CAAC,OAAO,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC,KAAK,OAAO,CAAC;AAEhK;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,CAAC,OAAO,OAAO,aAAa;IAChC,gDAAgD;IAChD,OAAO,CAAC,eAAe,CAAiC;IAExD;;;OAGG;IACH,EAAE,CAAC,CAAC,SAAS,MAAM,OAAO,CAAC,cAAc,EAAE,SAAS,EAAE,CAAC,EAAE,OAAO,EAAE,OAAO,CAAC,cAAc,CAAC,CAAC,CAAC,GAAG,IAAI;IAKlG;;OAEG;IACH,GAAG,CAAC,CAAC,SAAS,MAAM,OAAO,CAAC,cAAc,EAAE,SAAS,EAAE,CAAC,EAAE,OAAO,EAAE,OAAO,CAAC,cAAc,CAAC,CAAC,CAAC,GAAG,IAAI;IAYnG;;;;;;;;;;;;;OAaG;IACH,IAAI,CAAC,CAAC,SAAS,MAAM,OAAO,CAAC,cAAc,EAAE,SAAS,EAAE,CAAC,EAAE,OAAO,EAAE,OAAO,CAAC,cAAc,CAAC,CAAC,CAAC,GAAG,IAAI;IAYpG;;;;;;;;;;;;;;;;OAgBG;IACH,OAAO,CAAC,CAAC,SAAS,MAAM,OAAO,CAAC,cAAc,EAAE,SAAS,EAAE,CAAC,EAAE,OAAO,GAAE,MAAc,GAAG,OAAO,CAAC,UAAU,CAAC,OAAO,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC,CAAC;IAgBtI;;;;;;;;;;;;;;;OAeG;IACH,MAAM,CAAC,CAAC,SAAS,MAAM,OAAO,CAAC,cAAc,EAAE,SAAS,EAAE,CAAC,EAAE,SAAS,EAAE,cAAc,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,OAAO,CAAC,cAAc,CAAC,CAAC,CAAC,GAAG,IAAI;IAYpI;;;;;;;;;;;;;;;OAeG;IACH,QAAQ,CAAC,CAAC,SAAS,MAAM,OAAO,CAAC,cAAc,EAAE,SAAS,EAAE,CAAC,EAAE,OAAO,EAAE,OAAO,CAAC,cAAc,CAAC,CAAC,CAAC,EAAE,KAAK,GAAE,MAAa,GAAG,IAAI;IAe9H;;;;;;;;;;;;;;;;OAgBG;IACH,QAAQ,CAAC,CAAC,SAAS,MAAM,OAAO,CAAC,cAAc,EAAE,SAAS,EAAE,CAAC,EAAE,OAAO,EAAE,OAAO,CAAC,cAAc,CAAC,CAAC,CAAC,EAAE,KAAK,GAAE,MAAa,GAAG,IAAI;CAW/H"}

package/dist/enhanced/events.js

@@ -1,102 +1,51 @@
 "use strict";
+/**
+ * Enhanced event utilities providing convenience methods on top of nodemod's native events.
+ *
+ * Note: For low-level event handling that needs SUPERCEDE support, use nodemod.on() directly.
+ * This wrapper provides utilities like once(), waitFor(), throttle(), and debounce().
+ */
 Object.defineProperty(exports, "__esModule", { value: true });
-// Extend the nodemod namespace to include missing methods
 /**
- * Enhanced event system providing advanced event handling capabilities on top of nodemod's native events.
- * Features include priority-based execution, one-time listeners, event filtering, throttling, and debouncing.
+ * Enhanced event utilities for nodemod events.
  *
  * @example
  * ```typescript
- * // Basic event listening
- * nodemodCore.events.on('dllClientConnect', (entity, name) => {
- *   console.log(`${name} connected`);
- * });
- *
  * // One-time event listener
  * nodemodCore.events.once('dllSpawn', (entity) => {
  *   console.log('First spawn event received');
  * });
  *
- * // Priority-based event handling
- * nodemodCore.events.on('dllClientCommand', handleCommand, { priority: 10 });
- * nodemodCore.events.on('dllClientCommand', logCommand, { priority: 1 });
- *
- * // Event filtering
- * nodemodCore.events.filter('dllClientConnect',
- *   (entity, name) => name.startsWith('Admin'),
- *   (entity, name) => console.log(`Admin ${name} connected`)
- * );
- *
  * // Throttled events (max once per second)
  * nodemodCore.events.throttle('dllStartFrame', frameHandler, 1000);
+ *
+ * // Wait for event with timeout
+ * const [entity, name] = await nodemodCore.events.waitFor('dllClientConnect', 30000);
  * ```
  */
 class NodemodEvents {
-    /** Map of active event listeners organized by event name */
-    eventListeners = new Map();
+    /** Map tracking wrapped handlers for removal */
+    wrappedHandlers = new Map();
     /**
-     * Creates a new NodemodEvents instance and initializes enhanced event handlers.
+     * Adds an event listener. This is a simple wrapper around nodemod.on().
+     * For most cases, use nodemod.on() directly.
      */
-    constructor() {
-        this.initializeEvents();
+    on(eventName, handler) {
+        nodemod.on(eventName, handler);
+        return this;
     }
     /**
-     * Adds an event listener with enhanced options like priority and one-time execution.
-     *
-     * @param eventName - Name of the event to listen for
-     * @param handler - Function to execute when event occurs
-     * @param options - Additional options for the listener
-     * @returns This instance for method chaining
-     *
-     * @example
-     * ```typescript
-     * // Basic event listener
-     * nodemodCore.events.on('dllClientConnect', (entity, name) => {
-     *   console.log(`${name} joined the server`);
-     * });
-     *
-     * // High-priority listener (executes first)
-     * nodemodCore.events.on('dllClientCommand', (entity, command) => {
-     *   console.log('Processing command:', command);
-     * }, { priority: 100 });
-     *
-     * // One-time listener
-     * nodemodCore.events.on('dllSpawn', (entity) => {
-     *   console.log('First entity spawned');
-     * }, { once: true });
-     * ```
+     * Removes an event listener.
      */
-    on(eventName, handler, options = {}) {
-        const wrappedHandler = (options.once) ?
-            ((...args) => {
-                handler(...args);
-                this.off(eventName, wrappedHandler);
-            }) : handler;
-        if (!this.eventListeners.has(eventName)) {
-            this.eventListeners.set(eventName, []);
-        }
-        this.eventListeners.get(eventName).push({
-            handler: wrappedHandler,
-            original: handler,
-            priority: options.priority || 0
-        });
-        // Sort by priority (higher priority first)
-        this.eventListeners.get(eventName).sort((a, b) => b.priority - a.priority);
-        nodemod.on(eventName, wrappedHandler);
-        return this;
-    }
-    // Remove event listener
     off(eventName, handler) {
-        if (!this.eventListeners.has(eventName))
-            return this;
-        const listeners = this.eventListeners.get(eventName);
-        const index = listeners.findIndex(l => l.original === handler || l.handler === handler);
-        if (index !== -1) {
-            nodemod.removeListener(eventName, listeners[index].handler);
-            listeners.splice(index, 1);
-            if (listeners.length === 0) {
-                this.eventListeners.delete(eventName);
-            }
+        // Check if this was a wrapped handler
+        const wrapped = this.wrappedHandlers.get(handler);
+        if (wrapped) {
+            nodemod.removeListener(eventName, wrapped);
+            this.wrappedHandlers.delete(handler);
+        }
+        else {
+            nodemod.removeListener(eventName, handler);
         }
         return this;
     }
@@ -109,101 +58,23 @@ class NodemodEvents {
      *
      * @example
      * ```typescript
-     * // Listen for first player connection only
      * nodemodCore.events.once('dllClientConnect', (entity, name) => {
-     *   console.log(`First player ${name} connected - starting game logic`);
-     * });
-     *
-     * // Wait for map change
-     * nodemodCore.events.once('dllSpawn', () => {
-     *   console.log('Map fully loaded');
+     *   console.log(`First player ${name} connected`);
      * });
      * ```
      */
     once(eventName, handler) {
-        return this.on(eventName, handler, { once: true });
-    }
-    // Clear all listeners for an event
-    clearListeners(eventName) {
-        if (eventName) {
-            nodemod.clearListeners(eventName);
-            this.eventListeners.delete(eventName);
-        }
-        else {
-            // Clear all listeners
-            for (const [event] of this.eventListeners) {
-                nodemod.clearListeners(event);
-            }
-            this.eventListeners.clear();
-        }
-        return this;
-    }
-    // Get list of active event listeners
-    getListeners(eventName) {
-        return this.eventListeners.get(eventName) || [];
-    }
-    // Initialize commonly used event handlers with utilities
-    initializeEvents() {
-        // Player connection events with enhanced data
-        this.on('dllClientConnect', (entity, name, address, rejectReason) => {
-            const playerId = nodemod.eng.indexOfEdict(entity);
-            const playerInfo = {
-                entity,
-                id: playerId,
-                name: name,
-                address: address,
-                steamId: nodemod.eng.getPlayerAuthId(entity),
-                userId: nodemod.eng.getPlayerUserId(entity)
-            };
-            // Custom event - not calling nodemod functions
-        });
-        this.on('dllClientDisconnect', (entity) => {
-            const playerId = nodemod.eng.indexOfEdict(entity);
-            const playerInfo = {
-                entity,
-                id: playerId,
-                name: entity.netname,
-                steamId: nodemod.eng.getPlayerAuthId(entity)
-            };
-            // Custom event - not calling nodemod functions
-        });
-        // Enhanced spawn event
-        this.on('dllSpawn', (entity) => {
-            if (entity.netname) {
-                // Player spawn
-                const playerSpawnInfo = {
-                    entity,
-                    id: nodemod.eng.indexOfEdict(entity),
-                    name: entity.netname,
-                    className: entity.classname
-                };
-                // Custom event - not calling nodemod functions
-            }
-            else {
-                // Entity spawn
-                const entitySpawnInfo = {
-                    entity,
-                    id: nodemod.eng.indexOfEdict(entity),
-                    className: entity.classname
-                };
-                // Custom event - not calling nodemod functions
-            }
-        });
-        // Frame timing events
-        this.on('dllStartFrame', () => {
-            const frameInfo = {
-                time: nodemod.time,
-                mapname: nodemod.mapname,
-                playerCount: nodemod.players.length
-            };
-            // Custom event - not calling nodemod functions
+        const wrappedHandler = ((...args) => {
+            nodemod.removeListener(eventName, wrappedHandler);
+            this.wrappedHandlers.delete(handler);
+            handler(...args);
         });
+        this.wrappedHandlers.set(handler, wrappedHandler);
+        nodemod.on(eventName, wrappedHandler);
+        return this;
     }
-    // Custom emit removed - only using nodemod events
-    // Event helper methods
     /**
      * Waits for a specific event to occur and returns its parameters as a promise.
-     * Useful for async/await patterns with events.
      *
      * @param eventName - Name of the event to wait for
      * @param timeout - Timeout in milliseconds (default: 10000)
@@ -211,16 +82,12 @@ class NodemodEvents {
      *
      * @example
      * ```typescript
-     * // Wait for player connection
      * try {
      *   const [entity, name] = await nodemodCore.events.waitFor('dllClientConnect', 30000);
      *   console.log(`Player ${name} connected within 30 seconds`);
      * } catch (error) {
      *   console.log('No player connected within timeout');
      * }
-     *
-     * // Wait for entity spawn with shorter timeout
-     * const [spawnedEntity] = await nodemodCore.events.waitFor('dllSpawn', 5000);
      * ```
      */
     waitFor(eventName, timeout = 10000) {
@@ -246,38 +113,25 @@ class NodemodEvents {
      *
      * @example
      * ```typescript
-     * // Only handle commands from admins
      * nodemodCore.events.filter('dllClientCommand',
      *   (entity, command) => isAdmin(entity),
      *   (entity, command) => handleAdminCommand(entity, command)
      * );
-     *
-     * // Only handle player connections with specific names
-     * nodemodCore.events.filter('dllClientConnect',
-     *   (entity, name) => name.startsWith('VIP_'),
-     *   (entity, name) => grantVipAccess(entity)
-     * );
      * ```
      */
     filter(eventName, predicate, handler) {
-        const wrappedHandler = function (...args) {
+        const wrappedHandler = ((...args) => {
             if (predicate(...args)) {
-                // @ts-ignore - TypeScript can't guarantee spread matches exact signature but it's safe here
-                return handler(...args);
+                handler(...args);
             }
-        };
-        return this.on(eventName, wrappedHandler);
-    }
-    // Event mapping/transformation
-    map(eventName, transformer, newEventName) {
-        return this.on(eventName, ((...args) => {
-            const transformed = transformer(...args);
-            // Note: mapping to custom events not supported in strict mode
-        }));
+        });
+        this.wrappedHandlers.set(handler, wrappedHandler);
+        nodemod.on(eventName, wrappedHandler);
+        return this;
     }
     /**
      * Adds a throttled event listener that limits execution to once per specified interval.
-     * Useful for performance optimization with high-frequency events.
+     * Useful for performance optimization with high-frequency events like dllStartFrame.
      *
      * @param eventName - Name of the event to listen for
      * @param handler - Function to execute when event occurs
@@ -286,34 +140,27 @@ class NodemodEvents {
      *
      * @example
      * ```typescript
-     * // Throttle frame events to once per second
      * nodemodCore.events.throttle('dllStartFrame', () => {
      *   console.log('Frame update (max once per second)');
      * }, 1000);
-     *
-     * // Throttle player movement tracking
-     * nodemodCore.events.throttle('dllClientCommand', (entity, command) => {
-     *   if (command.startsWith('+move')) {
-     *     updatePlayerPosition(entity);
-     *   }
-     * }, 500); // Max twice per second
      * ```
      */
     throttle(eventName, handler, delay = 1000) {
         let lastCall = 0;
-        const wrappedHandler = function (...args) {
+        const wrappedHandler = ((...args) => {
             const now = Date.now();
             if (now - lastCall >= delay) {
                 lastCall = now;
-                // @ts-ignore - TypeScript can't guarantee spread matches exact signature but it's safe here
-                return handler(...args);
+                handler(...args);
             }
-        };
-        return this.on(eventName, wrappedHandler);
+        });
+        this.wrappedHandlers.set(handler, wrappedHandler);
+        nodemod.on(eventName, wrappedHandler);
+        return this;
     }
     /**
      * Adds a debounced event listener that delays execution until after the specified interval
-     * has passed since the last event occurrence. Useful for handling rapid successive events.
+     * has passed since the last event occurrence.
      *
      * @param eventName - Name of the event to listen for
      * @param handler - Function to execute when event occurs
@@ -322,14 +169,6 @@ class NodemodEvents {
      *
      * @example
      * ```typescript
-     * // Debounce player input to handle final command only
-     * nodemodCore.events.debounce('dllClientCommand', (entity, command) => {
-     *   if (command.startsWith('buy_')) {
-     *     processPurchase(entity, command);
-     *   }
-     * }, 300); // Wait 300ms after last buy command
-     *
-     * // Debounce entity spawning for batch processing
      * nodemodCore.events.debounce('dllSpawn', () => {
      *   console.log('Finished spawning entities');
      *   optimizeMapEntities();
@@ -338,12 +177,13 @@ class NodemodEvents {
      */
     debounce(eventName, handler, delay = 1000) {
         let timeoutId;
-        const wrappedHandler = function (...args) {
+        const wrappedHandler = ((...args) => {
             clearTimeout(timeoutId);
-            // @ts-ignore - TypeScript can't guarantee spread matches exact signature but it's safe here
             timeoutId = setTimeout(() => handler(...args), delay);
-        };
-        return this.on(eventName, wrappedHandler);
+        });
+        this.wrappedHandlers.set(handler, wrappedHandler);
+        nodemod.on(eventName, wrappedHandler);
+        return this;
     }
 }
 exports.default = NodemodEvents;

package/dist/enhanced/events.js.map

@@ -1 +1 @@
-{"version":3,"file":"events.js","sourceRoot":"","sources":["../../src/enhanced/events.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"events.js","sourceRoot":"","sources":["../../src/enhanced/events.ts"],"names":[],"mappings":"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"}

package/dist/types/index.d.ts

@@ -36,5 +36,6 @@ declare namespace nodemod {
   function getUserMsgId(msgName: string): number;
   function getUserMsgName(msgId: number): string;
   function setMetaResult(result: META_RES): void;
+  function getMetaResult(): META_RES;
   function continueServer(): void;
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nodemod/core",
-  "version": "1.0.4",
+  "version": "1.0.5",
   "description": "TypeScript-first NodeMod core library for Half-Life server development",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",