hookified 1.3.0 → 1.4.0

package/README.md

@@ -119,7 +119,7 @@ if you are not using ESM modules, you can use the following:
 </script>
 ```
 
-# API
+# API - Hooks
 
 ## .onHook(eventName, handler)
 
@@ -143,6 +143,8 @@ Get all hooks for an event.
 
 ## .clearHooks(eventName)
 
+# API - Events
+
 ## .on(eventName, handler)
 
 Subscribe to an event.
@@ -167,6 +169,30 @@ Remove all listeners for an event.
 
 Set the maximum number of listeners and will truncate if there are already too many.
 
+## .once(eventName, handler)
+
+Subscribe to an event once.
+
+## .prependListener(eventName, handler)
+
+Prepend a listener to an event.
+
+## .prependOnceListener(eventName, handler)
+
+Prepend a listener to an event once.
+
+## .eventNames()
+
+Get all event names.
+
+## .listenerCount(eventName?)
+
+Get the count of listeners for an event or all events if evenName not provided.
+
+## .rawListeners(eventName?)
+
+Get all listeners for an event or all events if evenName not provided.
+
 # Development and Testing
 
 Hookified is written in TypeScript and tests are written in `vitest`. To run the tests, use the following command:

package/dist/browser/index.global.js

@@ -1,2 +1,2 @@
-"use strict";(()=>{var c=Object.defineProperty;var v=(n,e,s)=>e in n?c(n,e,{enumerable:!0,configurable:!0,writable:!0,value:s}):n[e]=s;var r=(n,e,s)=>v(n,typeof e!="symbol"?e+"":e,s);var o=class{constructor(){r(this,"_eventListeners");r(this,"_maxListeners");this._eventListeners=new Map,this._maxListeners=100}maxListeners(){return this._maxListeners}addListener(e,s){this.on(e,s)}on(e,s){this._eventListeners.has(e)||this._eventListeners.set(e,[]);let t=this._eventListeners.get(e);t&&(t.length>=this._maxListeners&&console.warn(`MaxListenersExceededWarning: Possible event memory leak detected. ${t.length+1} ${e} listeners added. Use setMaxListeners() to increase limit.`),t.push(s))}removeListener(e,s){this.off(e,s)}off(e,s){let t=this._eventListeners.get(e)??[],i=t.indexOf(s);i>-1&&t.splice(i,1),t.length===0&&this._eventListeners.delete(e)}emit(e,...s){let t=this._eventListeners.get(e);if(t&&t.length>0)for(let i of t)i(...s)}listeners(e){return this._eventListeners.get(e)??[]}removeAllListeners(e){e?this._eventListeners.delete(e):this._eventListeners.clear()}setMaxListeners(e){this._maxListeners=e;for(let s of this._eventListeners.values())s.length>e&&s.splice(e)}};var l=class extends o{constructor(){super();r(this,"_hooks");this._hooks=new Map}onHook(s,t){let i=this._hooks.get(s);i?i.push(t):this._hooks.set(s,[t])}removeHook(s,t){let i=this._hooks.get(s);if(i){let h=i.indexOf(t);h!==-1&&i.splice(h,1)}}async hook(s,...t){let i=this._hooks.get(s);if(i)for(let h of i)try{await h(...t)}catch(a){this.emit("error",new Error(`Error in hook handler for event "${s}": ${a.message}`))}}get hooks(){return this._hooks}getHooks(s){return this._hooks.get(s)}clearHooks(){this._hooks.clear()}};})();
+"use strict";(()=>{var g=Object.defineProperty;var a=(r,e,t)=>e in r?g(r,e,{enumerable:!0,configurable:!0,writable:!0,value:t}):r[e]=t;var i=(r,e,t)=>a(r,typeof e!="symbol"?e+"":e,t);var o=class{constructor(){i(this,"_eventListeners");i(this,"_maxListeners");this._eventListeners=new Map,this._maxListeners=100}once(e,t){let s=(...n)=>{this.off(e,s),t(...n)};return this.on(e,s),this}listenerCount(e){if(!e)return this.getAllListeners().length;let t=this._eventListeners.get(e);return t?t.length:0}eventNames(){return Array.from(this._eventListeners.keys())}rawListeners(e){return e?this._eventListeners.get(e)??[]:this.getAllListeners()}prependListener(e,t){let s=this._eventListeners.get(e)??[];return s.unshift(t),this._eventListeners.set(e,s),this}prependOnceListener(e,t){let s=(...n)=>{this.off(e,s),t(...n)};return this.prependListener(e,s),this}maxListeners(){return this._maxListeners}addListener(e,t){return this.on(e,t),this}on(e,t){this._eventListeners.has(e)||this._eventListeners.set(e,[]);let s=this._eventListeners.get(e);return s&&(s.length>=this._maxListeners&&console.warn(`MaxListenersExceededWarning: Possible event memory leak detected. ${s.length+1} ${e} listeners added. Use setMaxListeners() to increase limit.`),s.push(t)),this}removeListener(e,t){return this.off(e,t),this}off(e,t){let s=this._eventListeners.get(e)??[],n=s.indexOf(t);return n>-1&&s.splice(n,1),s.length===0&&this._eventListeners.delete(e),this}emit(e,...t){let s=this._eventListeners.get(e);if(s&&s.length>0)for(let n of s)n(...t);return!0}listeners(e){return this._eventListeners.get(e)??[]}removeAllListeners(e){return e?this._eventListeners.delete(e):this._eventListeners.clear(),this}setMaxListeners(e){this._maxListeners=e;for(let t of this._eventListeners.values())t.length>e&&t.splice(e)}getAllListeners(){let e=new Array;for(let t of this._eventListeners.values())e=e.concat(t);return e}};var h=class extends o{constructor(){super();i(this,"_hooks");this._hooks=new Map}onHook(t,s){let n=this._hooks.get(t);n?n.push(s):this._hooks.set(t,[s])}removeHook(t,s){let n=this._hooks.get(t);if(n){let l=n.indexOf(s);l!==-1&&n.splice(l,1)}}async hook(t,...s){let n=this._hooks.get(t);if(n)for(let l of n)try{await l(...s)}catch(L){this.emit("error",new Error(`Error in hook handler for event "${t}": ${L.message}`))}}get hooks(){return this._hooks}getHooks(t){return this._hooks.get(t)}clearHooks(){this._hooks.clear()}};})();
 //# sourceMappingURL=index.global.js.map

package/dist/browser/index.global.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/eventified.ts","../../src/index.ts"],"sourcesContent":["export type EventListener = (...arguments_: any[]) => void;\n\nexport class Eventified {\n\t_eventListeners: Map<string, EventListener[]>;\n\t_maxListeners: number;\n\n\tconstructor() {\n\t\tthis._eventListeners = new Map();\n\t\tthis._maxListeners = 100; // Default maximum number of listeners\n\t}\n\n\tpublic maxListeners(): number {\n\t\treturn this._maxListeners;\n\t}\n\n\t// Add an event listener\n\tpublic addListener(event: string, listener: EventListener): void {\n\t\tthis.on(event, listener);\n\t}\n\n\tpublic on(event: string, listener: EventListener): void {\n\t\tif (!this._eventListeners.has(event)) {\n\t\t\tthis._eventListeners.set(event, []);\n\t\t}\n\n\t\tconst listeners = this._eventListeners.get(event);\n\n\t\tif (listeners) {\n\t\t\tif (listeners.length >= this._maxListeners) {\n\t\t\t\tconsole.warn(`MaxListenersExceededWarning: Possible event memory leak detected. ${listeners.length + 1} ${event} listeners added. Use setMaxListeners() to increase limit.`);\n\t\t\t}\n\n\t\t\tlisteners.push(listener);\n\t\t}\n\t}\n\n\t// Remove an event listener\n\tpublic removeListener(event: string, listener: EventListener): void {\n\t\tthis.off(event, listener);\n\t}\n\n\tpublic off(event: string, listener: EventListener): void {\n\t\tconst listeners = this._eventListeners.get(event) ?? [];\n\t\tconst index = listeners.indexOf(listener);\n\t\tif (index > -1) {\n\t\t\tlisteners.splice(index, 1);\n\t\t}\n\n\t\tif (listeners.length === 0) {\n\t\t\tthis._eventListeners.delete(event);\n\t\t}\n\t}\n\n\t// Emit an event\n\tpublic emit(event: string, ...arguments_: any[]): void {\n\t\tconst listeners = this._eventListeners.get(event);\n\n\t\tif (listeners && listeners.length > 0) {\n\t\t\tfor (const listener of listeners) {\n\t\t\t\t// eslint-disable-next-line @typescript-eslint/no-unsafe-argument\n\t\t\t\tlistener(...arguments_);\n\t\t\t}\n\t\t}\n\t}\n\n\t// Get all listeners for a specific event\n\tpublic listeners(event: string): EventListener[] {\n\t\treturn this._eventListeners.get(event) ?? [];\n\t}\n\n\t// Remove all listeners for a specific event\n\tpublic removeAllListeners(event?: string): void {\n\t\tif (event) {\n\t\t\tthis._eventListeners.delete(event);\n\t\t} else {\n\t\t\tthis._eventListeners.clear();\n\t\t}\n\t}\n\n\t// Set the maximum number of listeners for a single event\n\tpublic setMaxListeners(n: number): void {\n\t\tthis._maxListeners = n;\n\t\tfor (const listeners of this._eventListeners.values()) {\n\t\t\tif (listeners.length > n) {\n\t\t\t\tlisteners.splice(n);\n\t\t\t}\n\t\t}\n\t}\n}\n","import {Eventified} from './eventified.js';\n\nexport type Hook = (...arguments_: any[]) => Promise<void> | void;\n\nexport class Hookified extends Eventified {\n\t_hooks: Map<string, Hook[]>;\n\n\tconstructor() {\n\t\tsuper();\n\t\tthis._hooks = new Map();\n\t}\n\n\t// Adds a handler function for a specific event\n\tonHook(event: string, handler: Hook) {\n\t\tconst eventHandlers = this._hooks.get(event);\n\t\tif (eventHandlers) {\n\t\t\teventHandlers.push(handler);\n\t\t} else {\n\t\t\tthis._hooks.set(event, [handler]);\n\t\t}\n\t}\n\n\t// Removes a specific handler function for a specific event\n\tremoveHook(event: string, handler: Hook) {\n\t\tconst eventHandlers = this._hooks.get(event);\n\t\tif (eventHandlers) {\n\t\t\tconst index = eventHandlers.indexOf(handler);\n\t\t\tif (index !== -1) {\n\t\t\t\teventHandlers.splice(index, 1);\n\t\t\t}\n\t\t}\n\t}\n\n\t// Triggers all handlers for a specific event with provided data\n\tasync hook<T>(event: string, ...arguments_: T[]) {\n\t\tconst eventHandlers = this._hooks.get(event);\n\t\tif (eventHandlers) {\n\t\t\tfor (const handler of eventHandlers) {\n\t\t\t\ttry {\n\t\t\t\t\t// eslint-disable-next-line no-await-in-loop\n\t\t\t\t\tawait handler(...arguments_);\n\t\t\t\t} catch (error) {\n\t\t\t\t\tthis.emit('error', new Error(`Error in hook handler for event \"${event}\": ${(error as Error).message}`));\n\t\t\t\t}\n\t\t\t}\n\t\t}\n\t}\n\n\t// Provides read-only access to the current handlers\n\tget hooks() {\n\t\t// Creating a new map to prevent external modifications to the original map\n\t\treturn this._hooks;\n\t}\n\n\tgetHooks(event: string) {\n\t\treturn this._hooks.get(event);\n\t}\n\n\tclearHooks() {\n\t\tthis._hooks.clear();\n\t}\n}\n\nexport {Eventified, type EventListener} from './eventified.js';\n"],"mappings":"uLAEO,IAAMA,EAAN,KAAiB,CAIvB,aAAc,CAHdC,EAAA,wBACAA,EAAA,sBAGC,KAAK,gBAAkB,IAAI,IAC3B,KAAK,cAAgB,GACtB,CAEO,cAAuB,CAC7B,OAAO,KAAK,aACb,CAGO,YAAYC,EAAeC,EAA+B,CAChE,KAAK,GAAGD,EAAOC,CAAQ,CACxB,CAEO,GAAGD,EAAeC,EAA+B,CAClD,KAAK,gBAAgB,IAAID,CAAK,GAClC,KAAK,gBAAgB,IAAIA,EAAO,CAAC,CAAC,EAGnC,IAAME,EAAY,KAAK,gBAAgB,IAAIF,CAAK,EAE5CE,IACCA,EAAU,QAAU,KAAK,eAC5B,QAAQ,KAAK,qEAAqEA,EAAU,OAAS,CAAC,IAAIF,CAAK,4DAA4D,EAG5KE,EAAU,KAAKD,CAAQ,EAEzB,CAGO,eAAeD,EAAeC,EAA+B,CACnE,KAAK,IAAID,EAAOC,CAAQ,CACzB,CAEO,IAAID,EAAeC,EAA+B,CACxD,IAAMC,EAAY,KAAK,gBAAgB,IAAIF,CAAK,GAAK,CAAC,EAChDG,EAAQD,EAAU,QAAQD,CAAQ,EACpCE,EAAQ,IACXD,EAAU,OAAOC,EAAO,CAAC,EAGtBD,EAAU,SAAW,GACxB,KAAK,gBAAgB,OAAOF,CAAK,CAEnC,CAGO,KAAKA,KAAkBI,EAAyB,CACtD,IAAMF,EAAY,KAAK,gBAAgB,IAAIF,CAAK,EAEhD,GAAIE,GAAaA,EAAU,OAAS,EACnC,QAAWD,KAAYC,EAEtBD,EAAS,GAAGG,CAAU,CAGzB,CAGO,UAAUJ,EAAgC,CAChD,OAAO,KAAK,gBAAgB,IAAIA,CAAK,GAAK,CAAC,CAC5C,CAGO,mBAAmBA,EAAsB,CAC3CA,EACH,KAAK,gBAAgB,OAAOA,CAAK,EAEjC,KAAK,gBAAgB,MAAM,CAE7B,CAGO,gBAAgBK,EAAiB,CACvC,KAAK,cAAgBA,EACrB,QAAWH,KAAa,KAAK,gBAAgB,OAAO,EAC/CA,EAAU,OAASG,GACtBH,EAAU,OAAOG,CAAC,CAGrB,CACD,ECpFO,IAAMC,EAAN,cAAwBC,CAAW,CAGzC,aAAc,CACb,MAAM,EAHPC,EAAA,eAIC,KAAK,OAAS,IAAI,GACnB,CAGA,OAAOC,EAAeC,EAAe,CACpC,IAAMC,EAAgB,KAAK,OAAO,IAAIF,CAAK,EACvCE,EACHA,EAAc,KAAKD,CAAO,EAE1B,KAAK,OAAO,IAAID,EAAO,CAACC,CAAO,CAAC,CAElC,CAGA,WAAWD,EAAeC,EAAe,CACxC,IAAMC,EAAgB,KAAK,OAAO,IAAIF,CAAK,EAC3C,GAAIE,EAAe,CAClB,IAAMC,EAAQD,EAAc,QAAQD,CAAO,EACvCE,IAAU,IACbD,EAAc,OAAOC,EAAO,CAAC,CAE/B,CACD,CAGA,MAAM,KAAQH,KAAkBI,EAAiB,CAChD,IAAMF,EAAgB,KAAK,OAAO,IAAIF,CAAK,EAC3C,GAAIE,EACH,QAAWD,KAAWC,EACrB,GAAI,CAEH,MAAMD,EAAQ,GAAGG,CAAU,CAC5B,OAASC,EAAO,CACf,KAAK,KAAK,QAAS,IAAI,MAAM,oCAAoCL,CAAK,MAAOK,EAAgB,OAAO,EAAE,CAAC,CACxG,CAGH,CAGA,IAAI,OAAQ,CAEX,OAAO,KAAK,MACb,CAEA,SAASL,EAAe,CACvB,OAAO,KAAK,OAAO,IAAIA,CAAK,CAC7B,CAEA,YAAa,CACZ,KAAK,OAAO,MAAM,CACnB,CACD","names":["Eventified","__publicField","event","listener","listeners","index","arguments_","n","Hookified","Eventified","__publicField","event","handler","eventHandlers","index","arguments_","error"]}
+{"version":3,"sources":["../../src/eventified.ts","../../src/index.ts"],"sourcesContent":["import {type IEventEmitter} from './event-emitter.js';\n\nexport type EventListener = (...arguments_: any[]) => void;\n\nexport class Eventified implements IEventEmitter {\n\t_eventListeners: Map<string | symbol, EventListener[]>;\n\t_maxListeners: number;\n\n\tconstructor() {\n\t\tthis._eventListeners = new Map<string | symbol, EventListener[]>();\n\t\tthis._maxListeners = 100; // Default maximum number of listeners\n\t}\n\n\tonce(eventName: string | symbol, listener: EventListener): IEventEmitter {\n\t\tconst onceListener: EventListener = (...arguments_: any[]) => {\n\t\t\tthis.off(eventName as string, onceListener);\n\t\t\t// eslint-disable-next-line @typescript-eslint/no-unsafe-argument\n\t\t\tlistener(...arguments_);\n\t\t};\n\n\t\tthis.on(eventName as string, onceListener);\n\t\treturn this;\n\t}\n\n\tlistenerCount(eventName?: string | symbol): number {\n\t\tif (!eventName) {\n\t\t\treturn this.getAllListeners().length;\n\t\t}\n\n\t\tconst listeners = this._eventListeners.get(eventName as string);\n\t\treturn listeners ? listeners.length : 0;\n\t}\n\n\teventNames(): Array<string | symbol> {\n\t\treturn Array.from(this._eventListeners.keys());\n\t}\n\n\trawListeners(eventName?: string | symbol): EventListener[] {\n\t\tif (!eventName) {\n\t\t\treturn this.getAllListeners();\n\t\t}\n\n\t\treturn this._eventListeners.get(eventName) ?? [];\n\t}\n\n\tprependListener(eventName: string | symbol, listener: EventListener): IEventEmitter {\n\t\tconst listeners = this._eventListeners.get(eventName) ?? [];\n\t\tlisteners.unshift(listener);\n\t\tthis._eventListeners.set(eventName, listeners);\n\t\treturn this;\n\t}\n\n\tprependOnceListener(eventName: string | symbol, listener: EventListener): IEventEmitter {\n\t\tconst onceListener: EventListener = (...arguments_: any[]) => {\n\t\t\tthis.off(eventName as string, onceListener);\n\t\t\t// eslint-disable-next-line @typescript-eslint/no-unsafe-argument\n\t\t\tlistener(...arguments_);\n\t\t};\n\n\t\tthis.prependListener(eventName as string, onceListener);\n\t\treturn this;\n\t}\n\n\tpublic maxListeners(): number {\n\t\treturn this._maxListeners;\n\t}\n\n\t// Add an event listener\n\tpublic addListener(event: string | symbol, listener: EventListener): IEventEmitter {\n\t\tthis.on(event, listener);\n\t\treturn this;\n\t}\n\n\tpublic on(event: string | symbol, listener: EventListener): IEventEmitter {\n\t\tif (!this._eventListeners.has(event)) {\n\t\t\tthis._eventListeners.set(event, []);\n\t\t}\n\n\t\tconst listeners = this._eventListeners.get(event);\n\n\t\tif (listeners) {\n\t\t\tif (listeners.length >= this._maxListeners) {\n\t\t\t\tconsole.warn(`MaxListenersExceededWarning: Possible event memory leak detected. ${listeners.length + 1} ${event as string} listeners added. Use setMaxListeners() to increase limit.`);\n\t\t\t}\n\n\t\t\tlisteners.push(listener);\n\t\t}\n\n\t\treturn this;\n\t}\n\n\t// Remove an event listener\n\tpublic removeListener(event: string, listener: EventListener): IEventEmitter {\n\t\tthis.off(event, listener);\n\t\treturn this;\n\t}\n\n\tpublic off(event: string, listener: EventListener): IEventEmitter {\n\t\tconst listeners = this._eventListeners.get(event) ?? [];\n\t\tconst index = listeners.indexOf(listener);\n\t\tif (index > -1) {\n\t\t\tlisteners.splice(index, 1);\n\t\t}\n\n\t\tif (listeners.length === 0) {\n\t\t\tthis._eventListeners.delete(event);\n\t\t}\n\n\t\treturn this;\n\t}\n\n\t// Emit an event\n\tpublic emit(event: string, ...arguments_: any[]): boolean {\n\t\tconst listeners = this._eventListeners.get(event);\n\n\t\tif (listeners && listeners.length > 0) {\n\t\t\tfor (const listener of listeners) {\n\t\t\t\t// eslint-disable-next-line @typescript-eslint/no-unsafe-argument\n\t\t\t\tlistener(...arguments_);\n\t\t\t}\n\t\t}\n\n\t\treturn true;\n\t}\n\n\t// Get all listeners for a specific event\n\tpublic listeners(event: string): EventListener[] {\n\t\treturn this._eventListeners.get(event) ?? [];\n\t}\n\n\t// Remove all listeners for a specific event\n\tpublic removeAllListeners(event?: string): IEventEmitter {\n\t\tif (event) {\n\t\t\tthis._eventListeners.delete(event);\n\t\t} else {\n\t\t\tthis._eventListeners.clear();\n\t\t}\n\n\t\treturn this;\n\t}\n\n\t// Set the maximum number of listeners for a single event\n\tpublic setMaxListeners(n: number): void {\n\t\tthis._maxListeners = n;\n\t\tfor (const listeners of this._eventListeners.values()) {\n\t\t\tif (listeners.length > n) {\n\t\t\t\tlisteners.splice(n);\n\t\t\t}\n\t\t}\n\t}\n\n\tpublic getAllListeners(): EventListener[] {\n\t\tlet result = new Array<EventListener>();\n\t\tfor (const listeners of this._eventListeners.values()) {\n\t\t\tresult = result.concat(listeners);\n\t\t}\n\n\t\treturn result;\n\t}\n}\n","import {Eventified} from './eventified.js';\n\nexport type Hook = (...arguments_: any[]) => Promise<void> | void;\n\nexport class Hookified extends Eventified {\n\t_hooks: Map<string, Hook[]>;\n\n\tconstructor() {\n\t\tsuper();\n\t\tthis._hooks = new Map();\n\t}\n\n\t// Adds a handler function for a specific event\n\tonHook(event: string, handler: Hook) {\n\t\tconst eventHandlers = this._hooks.get(event);\n\t\tif (eventHandlers) {\n\t\t\teventHandlers.push(handler);\n\t\t} else {\n\t\t\tthis._hooks.set(event, [handler]);\n\t\t}\n\t}\n\n\t// Removes a specific handler function for a specific event\n\tremoveHook(event: string, handler: Hook) {\n\t\tconst eventHandlers = this._hooks.get(event);\n\t\tif (eventHandlers) {\n\t\t\tconst index = eventHandlers.indexOf(handler);\n\t\t\tif (index !== -1) {\n\t\t\t\teventHandlers.splice(index, 1);\n\t\t\t}\n\t\t}\n\t}\n\n\t// Triggers all handlers for a specific event with provided data\n\tasync hook<T>(event: string, ...arguments_: T[]) {\n\t\tconst eventHandlers = this._hooks.get(event);\n\t\tif (eventHandlers) {\n\t\t\tfor (const handler of eventHandlers) {\n\t\t\t\ttry {\n\t\t\t\t\t// eslint-disable-next-line no-await-in-loop\n\t\t\t\t\tawait handler(...arguments_);\n\t\t\t\t} catch (error) {\n\t\t\t\t\tthis.emit('error', new Error(`Error in hook handler for event \"${event}\": ${(error as Error).message}`));\n\t\t\t\t}\n\t\t\t}\n\t\t}\n\t}\n\n\t// Provides read-only access to the current handlers\n\tget hooks() {\n\t\t// Creating a new map to prevent external modifications to the original map\n\t\treturn this._hooks;\n\t}\n\n\tgetHooks(event: string) {\n\t\treturn this._hooks.get(event);\n\t}\n\n\tclearHooks() {\n\t\tthis._hooks.clear();\n\t}\n}\n\nexport {Eventified, type EventListener} from './eventified.js';\n"],"mappings":"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","names":["Eventified","__publicField","eventName","listener","onceListener","arguments_","listeners","event","index","n","result","Hookified","Eventified","__publicField","event","handler","eventHandlers","index","arguments_","error"]}

package/dist/browser/index.js

@@ -1,2 +1,2 @@
-var c=Object.defineProperty;var v=(n,e,s)=>e in n?c(n,e,{enumerable:!0,configurable:!0,writable:!0,value:s}):n[e]=s;var r=(n,e,s)=>v(n,typeof e!="symbol"?e+"":e,s);var o=class{constructor(){r(this,"_eventListeners");r(this,"_maxListeners");this._eventListeners=new Map,this._maxListeners=100}maxListeners(){return this._maxListeners}addListener(e,s){this.on(e,s)}on(e,s){this._eventListeners.has(e)||this._eventListeners.set(e,[]);let t=this._eventListeners.get(e);t&&(t.length>=this._maxListeners&&console.warn(`MaxListenersExceededWarning: Possible event memory leak detected. ${t.length+1} ${e} listeners added. Use setMaxListeners() to increase limit.`),t.push(s))}removeListener(e,s){this.off(e,s)}off(e,s){let t=this._eventListeners.get(e)??[],i=t.indexOf(s);i>-1&&t.splice(i,1),t.length===0&&this._eventListeners.delete(e)}emit(e,...s){let t=this._eventListeners.get(e);if(t&&t.length>0)for(let i of t)i(...s)}listeners(e){return this._eventListeners.get(e)??[]}removeAllListeners(e){e?this._eventListeners.delete(e):this._eventListeners.clear()}setMaxListeners(e){this._maxListeners=e;for(let s of this._eventListeners.values())s.length>e&&s.splice(e)}};var l=class extends o{constructor(){super();r(this,"_hooks");this._hooks=new Map}onHook(s,t){let i=this._hooks.get(s);i?i.push(t):this._hooks.set(s,[t])}removeHook(s,t){let i=this._hooks.get(s);if(i){let h=i.indexOf(t);h!==-1&&i.splice(h,1)}}async hook(s,...t){let i=this._hooks.get(s);if(i)for(let h of i)try{await h(...t)}catch(a){this.emit("error",new Error(`Error in hook handler for event "${s}": ${a.message}`))}}get hooks(){return this._hooks}getHooks(s){return this._hooks.get(s)}clearHooks(){this._hooks.clear()}};export{o as Eventified,l as Hookified};
+var g=Object.defineProperty;var a=(r,e,t)=>e in r?g(r,e,{enumerable:!0,configurable:!0,writable:!0,value:t}):r[e]=t;var i=(r,e,t)=>a(r,typeof e!="symbol"?e+"":e,t);var o=class{constructor(){i(this,"_eventListeners");i(this,"_maxListeners");this._eventListeners=new Map,this._maxListeners=100}once(e,t){let s=(...n)=>{this.off(e,s),t(...n)};return this.on(e,s),this}listenerCount(e){if(!e)return this.getAllListeners().length;let t=this._eventListeners.get(e);return t?t.length:0}eventNames(){return Array.from(this._eventListeners.keys())}rawListeners(e){return e?this._eventListeners.get(e)??[]:this.getAllListeners()}prependListener(e,t){let s=this._eventListeners.get(e)??[];return s.unshift(t),this._eventListeners.set(e,s),this}prependOnceListener(e,t){let s=(...n)=>{this.off(e,s),t(...n)};return this.prependListener(e,s),this}maxListeners(){return this._maxListeners}addListener(e,t){return this.on(e,t),this}on(e,t){this._eventListeners.has(e)||this._eventListeners.set(e,[]);let s=this._eventListeners.get(e);return s&&(s.length>=this._maxListeners&&console.warn(`MaxListenersExceededWarning: Possible event memory leak detected. ${s.length+1} ${e} listeners added. Use setMaxListeners() to increase limit.`),s.push(t)),this}removeListener(e,t){return this.off(e,t),this}off(e,t){let s=this._eventListeners.get(e)??[],n=s.indexOf(t);return n>-1&&s.splice(n,1),s.length===0&&this._eventListeners.delete(e),this}emit(e,...t){let s=this._eventListeners.get(e);if(s&&s.length>0)for(let n of s)n(...t);return!0}listeners(e){return this._eventListeners.get(e)??[]}removeAllListeners(e){return e?this._eventListeners.delete(e):this._eventListeners.clear(),this}setMaxListeners(e){this._maxListeners=e;for(let t of this._eventListeners.values())t.length>e&&t.splice(e)}getAllListeners(){let e=new Array;for(let t of this._eventListeners.values())e=e.concat(t);return e}};var h=class extends o{constructor(){super();i(this,"_hooks");this._hooks=new Map}onHook(t,s){let n=this._hooks.get(t);n?n.push(s):this._hooks.set(t,[s])}removeHook(t,s){let n=this._hooks.get(t);if(n){let l=n.indexOf(s);l!==-1&&n.splice(l,1)}}async hook(t,...s){let n=this._hooks.get(t);if(n)for(let l of n)try{await l(...s)}catch(L){this.emit("error",new Error(`Error in hook handler for event "${t}": ${L.message}`))}}get hooks(){return this._hooks}getHooks(t){return this._hooks.get(t)}clearHooks(){this._hooks.clear()}};export{o as Eventified,h as Hookified};
 //# sourceMappingURL=index.js.map

package/dist/browser/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/eventified.ts","../../src/index.ts"],"sourcesContent":["export type EventListener = (...arguments_: any[]) => void;\n\nexport class Eventified {\n\t_eventListeners: Map<string, EventListener[]>;\n\t_maxListeners: number;\n\n\tconstructor() {\n\t\tthis._eventListeners = new Map();\n\t\tthis._maxListeners = 100; // Default maximum number of listeners\n\t}\n\n\tpublic maxListeners(): number {\n\t\treturn this._maxListeners;\n\t}\n\n\t// Add an event listener\n\tpublic addListener(event: string, listener: EventListener): void {\n\t\tthis.on(event, listener);\n\t}\n\n\tpublic on(event: string, listener: EventListener): void {\n\t\tif (!this._eventListeners.has(event)) {\n\t\t\tthis._eventListeners.set(event, []);\n\t\t}\n\n\t\tconst listeners = this._eventListeners.get(event);\n\n\t\tif (listeners) {\n\t\t\tif (listeners.length >= this._maxListeners) {\n\t\t\t\tconsole.warn(`MaxListenersExceededWarning: Possible event memory leak detected. ${listeners.length + 1} ${event} listeners added. Use setMaxListeners() to increase limit.`);\n\t\t\t}\n\n\t\t\tlisteners.push(listener);\n\t\t}\n\t}\n\n\t// Remove an event listener\n\tpublic removeListener(event: string, listener: EventListener): void {\n\t\tthis.off(event, listener);\n\t}\n\n\tpublic off(event: string, listener: EventListener): void {\n\t\tconst listeners = this._eventListeners.get(event) ?? [];\n\t\tconst index = listeners.indexOf(listener);\n\t\tif (index > -1) {\n\t\t\tlisteners.splice(index, 1);\n\t\t}\n\n\t\tif (listeners.length === 0) {\n\t\t\tthis._eventListeners.delete(event);\n\t\t}\n\t}\n\n\t// Emit an event\n\tpublic emit(event: string, ...arguments_: any[]): void {\n\t\tconst listeners = this._eventListeners.get(event);\n\n\t\tif (listeners && listeners.length > 0) {\n\t\t\tfor (const listener of listeners) {\n\t\t\t\t// eslint-disable-next-line @typescript-eslint/no-unsafe-argument\n\t\t\t\tlistener(...arguments_);\n\t\t\t}\n\t\t}\n\t}\n\n\t// Get all listeners for a specific event\n\tpublic listeners(event: string): EventListener[] {\n\t\treturn this._eventListeners.get(event) ?? [];\n\t}\n\n\t// Remove all listeners for a specific event\n\tpublic removeAllListeners(event?: string): void {\n\t\tif (event) {\n\t\t\tthis._eventListeners.delete(event);\n\t\t} else {\n\t\t\tthis._eventListeners.clear();\n\t\t}\n\t}\n\n\t// Set the maximum number of listeners for a single event\n\tpublic setMaxListeners(n: number): void {\n\t\tthis._maxListeners = n;\n\t\tfor (const listeners of this._eventListeners.values()) {\n\t\t\tif (listeners.length > n) {\n\t\t\t\tlisteners.splice(n);\n\t\t\t}\n\t\t}\n\t}\n}\n","import {Eventified} from './eventified.js';\n\nexport type Hook = (...arguments_: any[]) => Promise<void> | void;\n\nexport class Hookified extends Eventified {\n\t_hooks: Map<string, Hook[]>;\n\n\tconstructor() {\n\t\tsuper();\n\t\tthis._hooks = new Map();\n\t}\n\n\t// Adds a handler function for a specific event\n\tonHook(event: string, handler: Hook) {\n\t\tconst eventHandlers = this._hooks.get(event);\n\t\tif (eventHandlers) {\n\t\t\teventHandlers.push(handler);\n\t\t} else {\n\t\t\tthis._hooks.set(event, [handler]);\n\t\t}\n\t}\n\n\t// Removes a specific handler function for a specific event\n\tremoveHook(event: string, handler: Hook) {\n\t\tconst eventHandlers = this._hooks.get(event);\n\t\tif (eventHandlers) {\n\t\t\tconst index = eventHandlers.indexOf(handler);\n\t\t\tif (index !== -1) {\n\t\t\t\teventHandlers.splice(index, 1);\n\t\t\t}\n\t\t}\n\t}\n\n\t// Triggers all handlers for a specific event with provided data\n\tasync hook<T>(event: string, ...arguments_: T[]) {\n\t\tconst eventHandlers = this._hooks.get(event);\n\t\tif (eventHandlers) {\n\t\t\tfor (const handler of eventHandlers) {\n\t\t\t\ttry {\n\t\t\t\t\t// eslint-disable-next-line no-await-in-loop\n\t\t\t\t\tawait handler(...arguments_);\n\t\t\t\t} catch (error) {\n\t\t\t\t\tthis.emit('error', new Error(`Error in hook handler for event \"${event}\": ${(error as Error).message}`));\n\t\t\t\t}\n\t\t\t}\n\t\t}\n\t}\n\n\t// Provides read-only access to the current handlers\n\tget hooks() {\n\t\t// Creating a new map to prevent external modifications to the original map\n\t\treturn this._hooks;\n\t}\n\n\tgetHooks(event: string) {\n\t\treturn this._hooks.get(event);\n\t}\n\n\tclearHooks() {\n\t\tthis._hooks.clear();\n\t}\n}\n\nexport {Eventified, type EventListener} from './eventified.js';\n"],"mappings":"oKAEO,IAAMA,EAAN,KAAiB,CAIvB,aAAc,CAHdC,EAAA,wBACAA,EAAA,sBAGC,KAAK,gBAAkB,IAAI,IAC3B,KAAK,cAAgB,GACtB,CAEO,cAAuB,CAC7B,OAAO,KAAK,aACb,CAGO,YAAYC,EAAeC,EAA+B,CAChE,KAAK,GAAGD,EAAOC,CAAQ,CACxB,CAEO,GAAGD,EAAeC,EAA+B,CAClD,KAAK,gBAAgB,IAAID,CAAK,GAClC,KAAK,gBAAgB,IAAIA,EAAO,CAAC,CAAC,EAGnC,IAAME,EAAY,KAAK,gBAAgB,IAAIF,CAAK,EAE5CE,IACCA,EAAU,QAAU,KAAK,eAC5B,QAAQ,KAAK,qEAAqEA,EAAU,OAAS,CAAC,IAAIF,CAAK,4DAA4D,EAG5KE,EAAU,KAAKD,CAAQ,EAEzB,CAGO,eAAeD,EAAeC,EAA+B,CACnE,KAAK,IAAID,EAAOC,CAAQ,CACzB,CAEO,IAAID,EAAeC,EAA+B,CACxD,IAAMC,EAAY,KAAK,gBAAgB,IAAIF,CAAK,GAAK,CAAC,EAChDG,EAAQD,EAAU,QAAQD,CAAQ,EACpCE,EAAQ,IACXD,EAAU,OAAOC,EAAO,CAAC,EAGtBD,EAAU,SAAW,GACxB,KAAK,gBAAgB,OAAOF,CAAK,CAEnC,CAGO,KAAKA,KAAkBI,EAAyB,CACtD,IAAMF,EAAY,KAAK,gBAAgB,IAAIF,CAAK,EAEhD,GAAIE,GAAaA,EAAU,OAAS,EACnC,QAAWD,KAAYC,EAEtBD,EAAS,GAAGG,CAAU,CAGzB,CAGO,UAAUJ,EAAgC,CAChD,OAAO,KAAK,gBAAgB,IAAIA,CAAK,GAAK,CAAC,CAC5C,CAGO,mBAAmBA,EAAsB,CAC3CA,EACH,KAAK,gBAAgB,OAAOA,CAAK,EAEjC,KAAK,gBAAgB,MAAM,CAE7B,CAGO,gBAAgBK,EAAiB,CACvC,KAAK,cAAgBA,EACrB,QAAWH,KAAa,KAAK,gBAAgB,OAAO,EAC/CA,EAAU,OAASG,GACtBH,EAAU,OAAOG,CAAC,CAGrB,CACD,ECpFO,IAAMC,EAAN,cAAwBC,CAAW,CAGzC,aAAc,CACb,MAAM,EAHPC,EAAA,eAIC,KAAK,OAAS,IAAI,GACnB,CAGA,OAAOC,EAAeC,EAAe,CACpC,IAAMC,EAAgB,KAAK,OAAO,IAAIF,CAAK,EACvCE,EACHA,EAAc,KAAKD,CAAO,EAE1B,KAAK,OAAO,IAAID,EAAO,CAACC,CAAO,CAAC,CAElC,CAGA,WAAWD,EAAeC,EAAe,CACxC,IAAMC,EAAgB,KAAK,OAAO,IAAIF,CAAK,EAC3C,GAAIE,EAAe,CAClB,IAAMC,EAAQD,EAAc,QAAQD,CAAO,EACvCE,IAAU,IACbD,EAAc,OAAOC,EAAO,CAAC,CAE/B,CACD,CAGA,MAAM,KAAQH,KAAkBI,EAAiB,CAChD,IAAMF,EAAgB,KAAK,OAAO,IAAIF,CAAK,EAC3C,GAAIE,EACH,QAAWD,KAAWC,EACrB,GAAI,CAEH,MAAMD,EAAQ,GAAGG,CAAU,CAC5B,OAASC,EAAO,CACf,KAAK,KAAK,QAAS,IAAI,MAAM,oCAAoCL,CAAK,MAAOK,EAAgB,OAAO,EAAE,CAAC,CACxG,CAGH,CAGA,IAAI,OAAQ,CAEX,OAAO,KAAK,MACb,CAEA,SAASL,EAAe,CACvB,OAAO,KAAK,OAAO,IAAIA,CAAK,CAC7B,CAEA,YAAa,CACZ,KAAK,OAAO,MAAM,CACnB,CACD","names":["Eventified","__publicField","event","listener","listeners","index","arguments_","n","Hookified","Eventified","__publicField","event","handler","eventHandlers","index","arguments_","error"]}
+{"version":3,"sources":["../../src/eventified.ts","../../src/index.ts"],"sourcesContent":["import {type IEventEmitter} from './event-emitter.js';\n\nexport type EventListener = (...arguments_: any[]) => void;\n\nexport class Eventified implements IEventEmitter {\n\t_eventListeners: Map<string | symbol, EventListener[]>;\n\t_maxListeners: number;\n\n\tconstructor() {\n\t\tthis._eventListeners = new Map<string | symbol, EventListener[]>();\n\t\tthis._maxListeners = 100; // Default maximum number of listeners\n\t}\n\n\tonce(eventName: string | symbol, listener: EventListener): IEventEmitter {\n\t\tconst onceListener: EventListener = (...arguments_: any[]) => {\n\t\t\tthis.off(eventName as string, onceListener);\n\t\t\t// eslint-disable-next-line @typescript-eslint/no-unsafe-argument\n\t\t\tlistener(...arguments_);\n\t\t};\n\n\t\tthis.on(eventName as string, onceListener);\n\t\treturn this;\n\t}\n\n\tlistenerCount(eventName?: string | symbol): number {\n\t\tif (!eventName) {\n\t\t\treturn this.getAllListeners().length;\n\t\t}\n\n\t\tconst listeners = this._eventListeners.get(eventName as string);\n\t\treturn listeners ? listeners.length : 0;\n\t}\n\n\teventNames(): Array<string | symbol> {\n\t\treturn Array.from(this._eventListeners.keys());\n\t}\n\n\trawListeners(eventName?: string | symbol): EventListener[] {\n\t\tif (!eventName) {\n\t\t\treturn this.getAllListeners();\n\t\t}\n\n\t\treturn this._eventListeners.get(eventName) ?? [];\n\t}\n\n\tprependListener(eventName: string | symbol, listener: EventListener): IEventEmitter {\n\t\tconst listeners = this._eventListeners.get(eventName) ?? [];\n\t\tlisteners.unshift(listener);\n\t\tthis._eventListeners.set(eventName, listeners);\n\t\treturn this;\n\t}\n\n\tprependOnceListener(eventName: string | symbol, listener: EventListener): IEventEmitter {\n\t\tconst onceListener: EventListener = (...arguments_: any[]) => {\n\t\t\tthis.off(eventName as string, onceListener);\n\t\t\t// eslint-disable-next-line @typescript-eslint/no-unsafe-argument\n\t\t\tlistener(...arguments_);\n\t\t};\n\n\t\tthis.prependListener(eventName as string, onceListener);\n\t\treturn this;\n\t}\n\n\tpublic maxListeners(): number {\n\t\treturn this._maxListeners;\n\t}\n\n\t// Add an event listener\n\tpublic addListener(event: string | symbol, listener: EventListener): IEventEmitter {\n\t\tthis.on(event, listener);\n\t\treturn this;\n\t}\n\n\tpublic on(event: string | symbol, listener: EventListener): IEventEmitter {\n\t\tif (!this._eventListeners.has(event)) {\n\t\t\tthis._eventListeners.set(event, []);\n\t\t}\n\n\t\tconst listeners = this._eventListeners.get(event);\n\n\t\tif (listeners) {\n\t\t\tif (listeners.length >= this._maxListeners) {\n\t\t\t\tconsole.warn(`MaxListenersExceededWarning: Possible event memory leak detected. ${listeners.length + 1} ${event as string} listeners added. Use setMaxListeners() to increase limit.`);\n\t\t\t}\n\n\t\t\tlisteners.push(listener);\n\t\t}\n\n\t\treturn this;\n\t}\n\n\t// Remove an event listener\n\tpublic removeListener(event: string, listener: EventListener): IEventEmitter {\n\t\tthis.off(event, listener);\n\t\treturn this;\n\t}\n\n\tpublic off(event: string, listener: EventListener): IEventEmitter {\n\t\tconst listeners = this._eventListeners.get(event) ?? [];\n\t\tconst index = listeners.indexOf(listener);\n\t\tif (index > -1) {\n\t\t\tlisteners.splice(index, 1);\n\t\t}\n\n\t\tif (listeners.length === 0) {\n\t\t\tthis._eventListeners.delete(event);\n\t\t}\n\n\t\treturn this;\n\t}\n\n\t// Emit an event\n\tpublic emit(event: string, ...arguments_: any[]): boolean {\n\t\tconst listeners = this._eventListeners.get(event);\n\n\t\tif (listeners && listeners.length > 0) {\n\t\t\tfor (const listener of listeners) {\n\t\t\t\t// eslint-disable-next-line @typescript-eslint/no-unsafe-argument\n\t\t\t\tlistener(...arguments_);\n\t\t\t}\n\t\t}\n\n\t\treturn true;\n\t}\n\n\t// Get all listeners for a specific event\n\tpublic listeners(event: string): EventListener[] {\n\t\treturn this._eventListeners.get(event) ?? [];\n\t}\n\n\t// Remove all listeners for a specific event\n\tpublic removeAllListeners(event?: string): IEventEmitter {\n\t\tif (event) {\n\t\t\tthis._eventListeners.delete(event);\n\t\t} else {\n\t\t\tthis._eventListeners.clear();\n\t\t}\n\n\t\treturn this;\n\t}\n\n\t// Set the maximum number of listeners for a single event\n\tpublic setMaxListeners(n: number): void {\n\t\tthis._maxListeners = n;\n\t\tfor (const listeners of this._eventListeners.values()) {\n\t\t\tif (listeners.length > n) {\n\t\t\t\tlisteners.splice(n);\n\t\t\t}\n\t\t}\n\t}\n\n\tpublic getAllListeners(): EventListener[] {\n\t\tlet result = new Array<EventListener>();\n\t\tfor (const listeners of this._eventListeners.values()) {\n\t\t\tresult = result.concat(listeners);\n\t\t}\n\n\t\treturn result;\n\t}\n}\n","import {Eventified} from './eventified.js';\n\nexport type Hook = (...arguments_: any[]) => Promise<void> | void;\n\nexport class Hookified extends Eventified {\n\t_hooks: Map<string, Hook[]>;\n\n\tconstructor() {\n\t\tsuper();\n\t\tthis._hooks = new Map();\n\t}\n\n\t// Adds a handler function for a specific event\n\tonHook(event: string, handler: Hook) {\n\t\tconst eventHandlers = this._hooks.get(event);\n\t\tif (eventHandlers) {\n\t\t\teventHandlers.push(handler);\n\t\t} else {\n\t\t\tthis._hooks.set(event, [handler]);\n\t\t}\n\t}\n\n\t// Removes a specific handler function for a specific event\n\tremoveHook(event: string, handler: Hook) {\n\t\tconst eventHandlers = this._hooks.get(event);\n\t\tif (eventHandlers) {\n\t\t\tconst index = eventHandlers.indexOf(handler);\n\t\t\tif (index !== -1) {\n\t\t\t\teventHandlers.splice(index, 1);\n\t\t\t}\n\t\t}\n\t}\n\n\t// Triggers all handlers for a specific event with provided data\n\tasync hook<T>(event: string, ...arguments_: T[]) {\n\t\tconst eventHandlers = this._hooks.get(event);\n\t\tif (eventHandlers) {\n\t\t\tfor (const handler of eventHandlers) {\n\t\t\t\ttry {\n\t\t\t\t\t// eslint-disable-next-line no-await-in-loop\n\t\t\t\t\tawait handler(...arguments_);\n\t\t\t\t} catch (error) {\n\t\t\t\t\tthis.emit('error', new Error(`Error in hook handler for event \"${event}\": ${(error as Error).message}`));\n\t\t\t\t}\n\t\t\t}\n\t\t}\n\t}\n\n\t// Provides read-only access to the current handlers\n\tget hooks() {\n\t\t// Creating a new map to prevent external modifications to the original map\n\t\treturn this._hooks;\n\t}\n\n\tgetHooks(event: string) {\n\t\treturn this._hooks.get(event);\n\t}\n\n\tclearHooks() {\n\t\tthis._hooks.clear();\n\t}\n}\n\nexport {Eventified, type EventListener} from './eventified.js';\n"],"mappings":"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","names":["Eventified","__publicField","eventName","listener","onceListener","arguments_","listeners","event","index","n","result","Hookified","Eventified","__publicField","event","handler","eventHandlers","index","arguments_","error"]}

package/dist/node/index.cjs

@@ -33,12 +33,51 @@ var Eventified = class {
     this._eventListeners = /* @__PURE__ */ new Map();
     this._maxListeners = 100;
   }
+  once(eventName, listener) {
+    const onceListener = (...arguments_) => {
+      this.off(eventName, onceListener);
+      listener(...arguments_);
+    };
+    this.on(eventName, onceListener);
+    return this;
+  }
+  listenerCount(eventName) {
+    if (!eventName) {
+      return this.getAllListeners().length;
+    }
+    const listeners = this._eventListeners.get(eventName);
+    return listeners ? listeners.length : 0;
+  }
+  eventNames() {
+    return Array.from(this._eventListeners.keys());
+  }
+  rawListeners(eventName) {
+    if (!eventName) {
+      return this.getAllListeners();
+    }
+    return this._eventListeners.get(eventName) ?? [];
+  }
+  prependListener(eventName, listener) {
+    const listeners = this._eventListeners.get(eventName) ?? [];
+    listeners.unshift(listener);
+    this._eventListeners.set(eventName, listeners);
+    return this;
+  }
+  prependOnceListener(eventName, listener) {
+    const onceListener = (...arguments_) => {
+      this.off(eventName, onceListener);
+      listener(...arguments_);
+    };
+    this.prependListener(eventName, onceListener);
+    return this;
+  }
   maxListeners() {
     return this._maxListeners;
   }
   // Add an event listener
   addListener(event, listener) {
     this.on(event, listener);
+    return this;
   }
   on(event, listener) {
     if (!this._eventListeners.has(event)) {
@@ -51,10 +90,12 @@ var Eventified = class {
       }
       listeners.push(listener);
     }
+    return this;
   }
   // Remove an event listener
   removeListener(event, listener) {
     this.off(event, listener);
+    return this;
   }
   off(event, listener) {
     const listeners = this._eventListeners.get(event) ?? [];
@@ -65,6 +106,7 @@ var Eventified = class {
     if (listeners.length === 0) {
       this._eventListeners.delete(event);
     }
+    return this;
   }
   // Emit an event
   emit(event, ...arguments_) {
@@ -74,6 +116,7 @@ var Eventified = class {
         listener(...arguments_);
       }
     }
+    return true;
   }
   // Get all listeners for a specific event
   listeners(event) {
@@ -86,6 +129,7 @@ var Eventified = class {
     } else {
       this._eventListeners.clear();
     }
+    return this;
   }
   // Set the maximum number of listeners for a single event
   setMaxListeners(n) {
@@ -96,6 +140,13 @@ var Eventified = class {
       }
     }
   }
+  getAllListeners() {
+    let result = new Array();
+    for (const listeners of this._eventListeners.values()) {
+      result = result.concat(listeners);
+    }
+    return result;
+  }
 };
 
 // src/index.ts

package/dist/node/index.d.cts

@@ -1,17 +1,169 @@
+type IEventEmitter = {
+    /**
+     * Registers a listener for the specified event.
+     *
+     * @param eventName - The name (or symbol) of the event to listen for.
+     * @param listener - A callback function that will be invoked when the event is emitted.
+     * @returns The current instance of EventEmitter for method chaining.
+     *
+     * @example
+     * emitter.on('data', (message) => {
+     *   console.log(message);
+     * });
+     */
+    on(eventName: string | symbol, listener: (...arguments_: any[]) => void): IEventEmitter;
+    /**
+     * Alias for `on`. Registers a listener for the specified event.
+     *
+     * @param eventName - The name (or symbol) of the event to listen for.
+     * @param listener - A callback function that will be invoked when the event is emitted.
+     * @returns The current instance of EventEmitter for method chaining.
+     */
+    addListener(eventName: string | symbol, listener: (...arguments_: any[]) => void): IEventEmitter;
+    /**
+     * Registers a one-time listener for the specified event. The listener is removed after it is called once.
+     *
+     * @param eventName - The name (or symbol) of the event to listen for.
+     * @param listener - A callback function that will be invoked once when the event is emitted.
+     * @returns The current instance of EventEmitter for method chaining.
+     *
+     * @example
+     * emitter.once('close', () => {
+     *   console.log('The connection was closed.');
+     * });
+     */
+    once(eventName: string | symbol, listener: (...arguments_: any[]) => void): IEventEmitter;
+    /**
+     * Removes a previously registered listener for the specified event.
+     *
+     * @param eventName - The name (or symbol) of the event to stop listening for.
+     * @param listener - The specific callback function to remove.
+     * @returns The current instance of EventEmitter for method chaining.
+     *
+     * @example
+     * emitter.off('data', myListener);
+     */
+    off(eventName: string | symbol, listener: (...arguments_: any[]) => void): IEventEmitter;
+    /**
+     * Alias for `off`. Removes a previously registered listener for the specified event.
+     *
+     * @param eventName - The name (or symbol) of the event to stop listening for.
+     * @param listener - The specific callback function to remove.
+     * @returns The current instance of EventEmitter for method chaining.
+     */
+    removeListener(eventName: string | symbol, listener: (...arguments_: any[]) => void): IEventEmitter;
+    /**
+     * Emits the specified event, invoking all registered listeners with the provided arguments.
+     *
+     * @param eventName - The name (or symbol) of the event to emit.
+     * @param args - Arguments passed to each listener.
+     * @returns `true` if the event had listeners, `false` otherwise.
+     *
+     * @example
+     * emitter.emit('data', 'Hello World');
+     */
+    emit(eventName: string | symbol, ...arguments_: any[]): boolean;
+    /**
+     * Returns the number of listeners registered for the specified event.
+     *
+     * @param eventName - The name (or symbol) of the event.
+     * @returns The number of registered listeners.
+     *
+     * @example
+     * const count = emitter.listenerCount('data');
+     * console.log(count); // e.g., 2
+     */
+    listenerCount(eventName: string | symbol): number;
+    /**
+     * Removes all listeners for the specified event. If no event is specified, it removes all listeners for all events.
+     *
+     * @param eventName - (Optional) The name (or symbol) of the event.
+     * @returns The current instance of EventEmitter for method chaining.
+     *
+     * @example
+     * emitter.removeAllListeners('data');
+     */
+    removeAllListeners(eventName?: string | symbol): IEventEmitter;
+    /**
+     * Returns an array of event names for which listeners have been registered.
+     *
+     * @returns An array of event names (or symbols).
+     *
+     * @example
+     * const events = emitter.eventNames();
+     * console.log(events); // e.g., ['data', 'close']
+     */
+    eventNames(): Array<string | symbol>;
+    /**
+     * Returns an array of listeners registered for the specified event.
+     *
+     * @param eventName - The name (or symbol) of the event.
+     * @returns An array of listener functions.
+     *
+     * @example
+     * const listeners = emitter.listeners('data');
+     * console.log(listeners.length); // e.g., 2
+     */
+    listeners(eventName: string | symbol): Array<(...arguments_: any[]) => void>;
+    /**
+     * Returns an array of raw listeners for the specified event. This includes listeners wrapped by internal mechanisms (e.g., once-only listeners).
+     *
+     * @param eventName - The name (or symbol) of the event.
+     * @returns An array of raw listener functions.
+     *
+     * @example
+     * const rawListeners = emitter.rawListeners('data');
+     */
+    rawListeners(eventName: string | symbol): Array<(...arguments_: any[]) => void>;
+    /**
+     * Adds a listener to the beginning of the listeners array for the specified event.
+     *
+     * @param eventName - The name (or symbol) of the event to listen for.
+     * @param listener - A callback function that will be invoked when the event is emitted.
+     * @returns The current instance of EventEmitter for method chaining.
+     *
+     * @example
+     * emitter.prependListener('data', (message) => {
+     *   console.log('This will run first.');
+     * });
+     */
+    prependListener(eventName: string | symbol, listener: (...arguments_: any[]) => void): IEventEmitter;
+    /**
+     * Adds a one-time listener to the beginning of the listeners array for the specified event.
+     *
+     * @param eventName - The name (or symbol) of the event to listen for.
+     * @param listener - A callback function that will be invoked once when the event is emitted.
+     * @returns The current instance of EventEmitter for method chaining.
+     *
+     * @example
+     * emitter.prependOnceListener('data', (message) => {
+     *   console.log('This will run first and only once.');
+     * });
+     */
+    prependOnceListener(eventName: string | symbol, listener: (...arguments_: any[]) => void): IEventEmitter;
+};
+
 type EventListener = (...arguments_: any[]) => void;
-declare class Eventified {
-    _eventListeners: Map<string, EventListener[]>;
+declare class Eventified implements IEventEmitter {
+    _eventListeners: Map<string | symbol, EventListener[]>;
     _maxListeners: number;
     constructor();
+    once(eventName: string | symbol, listener: EventListener): IEventEmitter;
+    listenerCount(eventName?: string | symbol): number;
+    eventNames(): Array<string | symbol>;
+    rawListeners(eventName?: string | symbol): EventListener[];
+    prependListener(eventName: string | symbol, listener: EventListener): IEventEmitter;
+    prependOnceListener(eventName: string | symbol, listener: EventListener): IEventEmitter;
     maxListeners(): number;
-    addListener(event: string, listener: EventListener): void;
-    on(event: string, listener: EventListener): void;
-    removeListener(event: string, listener: EventListener): void;
-    off(event: string, listener: EventListener): void;
-    emit(event: string, ...arguments_: any[]): void;
+    addListener(event: string | symbol, listener: EventListener): IEventEmitter;
+    on(event: string | symbol, listener: EventListener): IEventEmitter;
+    removeListener(event: string, listener: EventListener): IEventEmitter;
+    off(event: string, listener: EventListener): IEventEmitter;
+    emit(event: string, ...arguments_: any[]): boolean;
     listeners(event: string): EventListener[];
-    removeAllListeners(event?: string): void;
+    removeAllListeners(event?: string): IEventEmitter;
     setMaxListeners(n: number): void;
+    getAllListeners(): EventListener[];
 }
 
 type Hook = (...arguments_: any[]) => Promise<void> | void;

package/dist/node/index.d.ts

@@ -1,17 +1,169 @@
+type IEventEmitter = {
+    /**
+     * Registers a listener for the specified event.
+     *
+     * @param eventName - The name (or symbol) of the event to listen for.
+     * @param listener - A callback function that will be invoked when the event is emitted.
+     * @returns The current instance of EventEmitter for method chaining.
+     *
+     * @example
+     * emitter.on('data', (message) => {
+     *   console.log(message);
+     * });
+     */
+    on(eventName: string | symbol, listener: (...arguments_: any[]) => void): IEventEmitter;
+    /**
+     * Alias for `on`. Registers a listener for the specified event.
+     *
+     * @param eventName - The name (or symbol) of the event to listen for.
+     * @param listener - A callback function that will be invoked when the event is emitted.
+     * @returns The current instance of EventEmitter for method chaining.
+     */
+    addListener(eventName: string | symbol, listener: (...arguments_: any[]) => void): IEventEmitter;
+    /**
+     * Registers a one-time listener for the specified event. The listener is removed after it is called once.
+     *
+     * @param eventName - The name (or symbol) of the event to listen for.
+     * @param listener - A callback function that will be invoked once when the event is emitted.
+     * @returns The current instance of EventEmitter for method chaining.
+     *
+     * @example
+     * emitter.once('close', () => {
+     *   console.log('The connection was closed.');
+     * });
+     */
+    once(eventName: string | symbol, listener: (...arguments_: any[]) => void): IEventEmitter;
+    /**
+     * Removes a previously registered listener for the specified event.
+     *
+     * @param eventName - The name (or symbol) of the event to stop listening for.
+     * @param listener - The specific callback function to remove.
+     * @returns The current instance of EventEmitter for method chaining.
+     *
+     * @example
+     * emitter.off('data', myListener);
+     */
+    off(eventName: string | symbol, listener: (...arguments_: any[]) => void): IEventEmitter;
+    /**
+     * Alias for `off`. Removes a previously registered listener for the specified event.
+     *
+     * @param eventName - The name (or symbol) of the event to stop listening for.
+     * @param listener - The specific callback function to remove.
+     * @returns The current instance of EventEmitter for method chaining.
+     */
+    removeListener(eventName: string | symbol, listener: (...arguments_: any[]) => void): IEventEmitter;
+    /**
+     * Emits the specified event, invoking all registered listeners with the provided arguments.
+     *
+     * @param eventName - The name (or symbol) of the event to emit.
+     * @param args - Arguments passed to each listener.
+     * @returns `true` if the event had listeners, `false` otherwise.
+     *
+     * @example
+     * emitter.emit('data', 'Hello World');
+     */
+    emit(eventName: string | symbol, ...arguments_: any[]): boolean;
+    /**
+     * Returns the number of listeners registered for the specified event.
+     *
+     * @param eventName - The name (or symbol) of the event.
+     * @returns The number of registered listeners.
+     *
+     * @example
+     * const count = emitter.listenerCount('data');
+     * console.log(count); // e.g., 2
+     */
+    listenerCount(eventName: string | symbol): number;
+    /**
+     * Removes all listeners for the specified event. If no event is specified, it removes all listeners for all events.
+     *
+     * @param eventName - (Optional) The name (or symbol) of the event.
+     * @returns The current instance of EventEmitter for method chaining.
+     *
+     * @example
+     * emitter.removeAllListeners('data');
+     */
+    removeAllListeners(eventName?: string | symbol): IEventEmitter;
+    /**
+     * Returns an array of event names for which listeners have been registered.
+     *
+     * @returns An array of event names (or symbols).
+     *
+     * @example
+     * const events = emitter.eventNames();
+     * console.log(events); // e.g., ['data', 'close']
+     */
+    eventNames(): Array<string | symbol>;
+    /**
+     * Returns an array of listeners registered for the specified event.
+     *
+     * @param eventName - The name (or symbol) of the event.
+     * @returns An array of listener functions.
+     *
+     * @example
+     * const listeners = emitter.listeners('data');
+     * console.log(listeners.length); // e.g., 2
+     */
+    listeners(eventName: string | symbol): Array<(...arguments_: any[]) => void>;
+    /**
+     * Returns an array of raw listeners for the specified event. This includes listeners wrapped by internal mechanisms (e.g., once-only listeners).
+     *
+     * @param eventName - The name (or symbol) of the event.
+     * @returns An array of raw listener functions.
+     *
+     * @example
+     * const rawListeners = emitter.rawListeners('data');
+     */
+    rawListeners(eventName: string | symbol): Array<(...arguments_: any[]) => void>;
+    /**
+     * Adds a listener to the beginning of the listeners array for the specified event.
+     *
+     * @param eventName - The name (or symbol) of the event to listen for.
+     * @param listener - A callback function that will be invoked when the event is emitted.
+     * @returns The current instance of EventEmitter for method chaining.
+     *
+     * @example
+     * emitter.prependListener('data', (message) => {
+     *   console.log('This will run first.');
+     * });
+     */
+    prependListener(eventName: string | symbol, listener: (...arguments_: any[]) => void): IEventEmitter;
+    /**
+     * Adds a one-time listener to the beginning of the listeners array for the specified event.
+     *
+     * @param eventName - The name (or symbol) of the event to listen for.
+     * @param listener - A callback function that will be invoked once when the event is emitted.
+     * @returns The current instance of EventEmitter for method chaining.
+     *
+     * @example
+     * emitter.prependOnceListener('data', (message) => {
+     *   console.log('This will run first and only once.');
+     * });
+     */
+    prependOnceListener(eventName: string | symbol, listener: (...arguments_: any[]) => void): IEventEmitter;
+};
+
 type EventListener = (...arguments_: any[]) => void;
-declare class Eventified {
-    _eventListeners: Map<string, EventListener[]>;
+declare class Eventified implements IEventEmitter {
+    _eventListeners: Map<string | symbol, EventListener[]>;
     _maxListeners: number;
     constructor();
+    once(eventName: string | symbol, listener: EventListener): IEventEmitter;
+    listenerCount(eventName?: string | symbol): number;
+    eventNames(): Array<string | symbol>;
+    rawListeners(eventName?: string | symbol): EventListener[];
+    prependListener(eventName: string | symbol, listener: EventListener): IEventEmitter;
+    prependOnceListener(eventName: string | symbol, listener: EventListener): IEventEmitter;
     maxListeners(): number;
-    addListener(event: string, listener: EventListener): void;
-    on(event: string, listener: EventListener): void;
-    removeListener(event: string, listener: EventListener): void;
-    off(event: string, listener: EventListener): void;
-    emit(event: string, ...arguments_: any[]): void;
+    addListener(event: string | symbol, listener: EventListener): IEventEmitter;
+    on(event: string | symbol, listener: EventListener): IEventEmitter;
+    removeListener(event: string, listener: EventListener): IEventEmitter;
+    off(event: string, listener: EventListener): IEventEmitter;
+    emit(event: string, ...arguments_: any[]): boolean;
     listeners(event: string): EventListener[];
-    removeAllListeners(event?: string): void;
+    removeAllListeners(event?: string): IEventEmitter;
     setMaxListeners(n: number): void;
+    getAllListeners(): EventListener[];
 }
 
 type Hook = (...arguments_: any[]) => Promise<void> | void;

package/dist/node/index.js

@@ -6,12 +6,51 @@ var Eventified = class {
     this._eventListeners = /* @__PURE__ */ new Map();
     this._maxListeners = 100;
   }
+  once(eventName, listener) {
+    const onceListener = (...arguments_) => {
+      this.off(eventName, onceListener);
+      listener(...arguments_);
+    };
+    this.on(eventName, onceListener);
+    return this;
+  }
+  listenerCount(eventName) {
+    if (!eventName) {
+      return this.getAllListeners().length;
+    }
+    const listeners = this._eventListeners.get(eventName);
+    return listeners ? listeners.length : 0;
+  }
+  eventNames() {
+    return Array.from(this._eventListeners.keys());
+  }
+  rawListeners(eventName) {
+    if (!eventName) {
+      return this.getAllListeners();
+    }
+    return this._eventListeners.get(eventName) ?? [];
+  }
+  prependListener(eventName, listener) {
+    const listeners = this._eventListeners.get(eventName) ?? [];
+    listeners.unshift(listener);
+    this._eventListeners.set(eventName, listeners);
+    return this;
+  }
+  prependOnceListener(eventName, listener) {
+    const onceListener = (...arguments_) => {
+      this.off(eventName, onceListener);
+      listener(...arguments_);
+    };
+    this.prependListener(eventName, onceListener);
+    return this;
+  }
   maxListeners() {
     return this._maxListeners;
   }
   // Add an event listener
   addListener(event, listener) {
     this.on(event, listener);
+    return this;
   }
   on(event, listener) {
     if (!this._eventListeners.has(event)) {
@@ -24,10 +63,12 @@ var Eventified = class {
       }
       listeners.push(listener);
     }
+    return this;
   }
   // Remove an event listener
   removeListener(event, listener) {
     this.off(event, listener);
+    return this;
   }
   off(event, listener) {
     const listeners = this._eventListeners.get(event) ?? [];
@@ -38,6 +79,7 @@ var Eventified = class {
     if (listeners.length === 0) {
       this._eventListeners.delete(event);
     }
+    return this;
   }
   // Emit an event
   emit(event, ...arguments_) {
@@ -47,6 +89,7 @@ var Eventified = class {
         listener(...arguments_);
       }
     }
+    return true;
   }
   // Get all listeners for a specific event
   listeners(event) {
@@ -59,6 +102,7 @@ var Eventified = class {
     } else {
       this._eventListeners.clear();
     }
+    return this;
   }
   // Set the maximum number of listeners for a single event
   setMaxListeners(n) {
@@ -69,6 +113,13 @@ var Eventified = class {
       }
     }
   }
+  getAllListeners() {
+    let result = new Array();
+    for (const listeners of this._eventListeners.values()) {
+      result = result.concat(listeners);
+    }
+    return result;
+  }
 };
 
 // src/index.ts

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "hookified",
-  "version": "1.3.0",
+  "version": "1.4.0",
   "description": "Event and Middleware Hooks",
   "type": "module",
   "main": "dist/node/index.cjs",