hookified 1.2.1 → 1.4.0

package/README.md

@@ -8,18 +8,18 @@
 [![npm](https://img.shields.io/npm/dm/hookified)](https://npmjs.com/package/hookified)
 [![npm](https://img.shields.io/npm/v/hookified)](https://npmjs.com/package/hookified)
 
-## Features
+# Features
 - Simple replacement for EventEmitter
 - Async Middleware Hooks for Your Methods
 - ESM / CJS with Types and Nodejs 20+
 - Maintained on a regular basis!
 
-## Installation
+# Installation
 ```bash
 npm install hookified --save
 ```
 
-## Usage
+# Usage
 This was built because we constantly wanted hooks and events extended on libraires we are building such as [Keyv](https://keyv.org) and [Cacheable](https://cacheable.org). This is a simple way to add hooks and events to your classes.
 
 ```javascript
@@ -66,39 +66,94 @@ class MyClass extends Hookified {
 }
 ```
 
-## API
+# Using it in the Browser
 
-### .onHook(eventName, handler)
+```html
+<script type="module">
+  import { Hookified } from 'https://cdn.jsdelivr.net/npm/hookified/dist/browser/index.js';
+
+  class MyClass extends Hookified {
+    constructor() {
+      super();
+    }
+
+    async myMethodEmittingEvent() {
+      this.emit('message', 'Hello World'); //using Emittery
+    }
+
+    //with hooks you can pass data in and if they are subscribed via onHook they can modify the data
+    async myMethodWithHooks() Promise<any> {
+      let data = { some: 'data' };
+      // do something
+      await this.hook('before:myMethod2', data);
+
+      return data;
+    }
+  }
+</script>
+```
+
+if you are not using ESM modules, you can use the following:
+
+```html
+<script src="https://cdn.jsdelivr.net/npm/hookified/dist/browser/index.global.js"></script>
+<script>
+  class MyClass extends Hookified {
+    constructor() {
+      super();
+    }
+
+    async myMethodEmittingEvent() {
+      this.emit('message', 'Hello World'); //using Emittery
+    }
+
+    //with hooks you can pass data in and if they are subscribed via onHook they can modify the data
+    async myMethodWithHooks() Promise<any> {
+      let data = { some: 'data' };
+      // do something
+      await this.hook('before:myMethod2', data);
+
+      return data;
+    }
+  }
+</script>
+```
+
+# API - Hooks
+
+## .onHook(eventName, handler)
 
 Subscribe to a hook event.
 
-### .removeHook(eventName)
+## .removeHook(eventName)
 
 Unsubscribe from a hook event.
 
-### .hook(eventName, ...args)
+## .hook(eventName, ...args)
 
 Run a hook event.
 
-### .hooks
+## .hooks
 
 Get all hooks.
 
-### .getHooks(eventName)
+## .getHooks(eventName)
 
 Get all hooks for an event.
 
-### .clearHooks(eventName)
+## .clearHooks(eventName)
+
+# API - Events
 
-### .on(eventName, handler)
+## .on(eventName, handler)
 
 Subscribe to an event.
 
-### .off(eventName, handler)
+## .off(eventName, handler)
 
 Unsubscribe from an event.
 
-### .emit(eventName, ...args)
+## .emit(eventName, ...args)
 
 Emit an event.
 
@@ -114,7 +169,31 @@ Remove all listeners for an event.
 
 Set the maximum number of listeners and will truncate if there are already too many.
 
-## Development and Testing
+## .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:
 
@@ -126,7 +205,7 @@ npm i && npm test
 
 To contribute follow the [Contributing Guidelines](CONTRIBUTING.md) and [Code of Conduct](CODE_OF_CONDUCT.md).
 
-## License
+# License
 
 [MIT & © Jared Wray](LICENSE)
 

package/dist/browser/index.global.js

@@ -0,0 +1,2 @@
+"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

@@ -0,0 +1 @@
+{"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

@@ -0,0 +1,2 @@
+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

@@ -0,0 +1 @@
+{"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/{index.cjs → 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

@@ -0,0 +1,181 @@
+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 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 | 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): IEventEmitter;
+    setMaxListeners(n: number): void;
+    getAllListeners(): EventListener[];
+}
+
+type Hook = (...arguments_: any[]) => Promise<void> | void;
+declare class Hookified extends Eventified {
+    _hooks: Map<string, Hook[]>;
+    constructor();
+    onHook(event: string, handler: Hook): void;
+    removeHook(event: string, handler: Hook): void;
+    hook<T>(event: string, ...arguments_: T[]): Promise<void>;
+    get hooks(): Map<string, Hook[]>;
+    getHooks(event: string): Hook[] | undefined;
+    clearHooks(): void;
+}
+
+export { type EventListener, Eventified, type Hook, Hookified };

package/dist/node/index.d.ts

@@ -0,0 +1,181 @@
+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 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 | 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): IEventEmitter;
+    setMaxListeners(n: number): void;
+    getAllListeners(): EventListener[];
+}
+
+type Hook = (...arguments_: any[]) => Promise<void> | void;
+declare class Hookified extends Eventified {
+    _hooks: Map<string, Hook[]>;
+    constructor();
+    onHook(event: string, handler: Hook): void;
+    removeHook(event: string, handler: Hook): void;
+    hook<T>(event: string, ...arguments_: T[]): Promise<void>;
+    get hooks(): Map<string, Hook[]>;
+    getHooks(event: string): Hook[] | undefined;
+    clearHooks(): void;
+}
+
+export { type EventListener, Eventified, type Hook, Hookified };

package/dist/{index.js → 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,25 +1,26 @@
 {
   "name": "hookified",
-  "version": "1.2.1",
+  "version": "1.4.0",
   "description": "Event and Middleware Hooks",
   "type": "module",
-  "main": "./dist/index.cjs",
-  "module": "./dist/index.js",
-  "types": "./dist/index.d.ts",
+  "main": "dist/node/index.cjs",
+  "module": "dist/node/index.js",
   "exports": {
     ".": {
-      "require": "./dist/index.cjs",
-      "import": "./dist/index.js"
+      "import": "./dist/node/index.js",
+      "require": "./dist/node/index.cjs"
+    },
+    "./browser": {
+      "import": "./dist/browser/index.js",
+      "default": "./dist/browser/index.global.js"
     }
   },
-  "engines": {
-    "node": ">=20"
-  },
+  "types": "dist/node/index.d.ts",
   "scripts": {
     "test": "xo --fix && vitest run --coverage",
     "test:ci": "xo && vitest run --coverage",
     "clean": "rimraf ./dist ./coverage ./site/dist",
-    "build": "rimraf ./dist && tsup src/index.ts --format cjs,esm --dts --clean",
+    "build": "rimraf ./dist && tsup",
     "website:build": "docula build",
     "website:serve": "docula serve",
     "prepare": "npm run build"
@@ -56,12 +57,12 @@
   },
   "homepage": "https://github.com/jaredwray/hookified#readme",
   "devDependencies": {
-    "@vitest/coverage-v8": "^2.1.2",
+    "@vitest/coverage-v8": "^2.1.3",
     "docula": "^0.9.3",
     "rimraf": "^6.0.1",
     "tsup": "^8.3.0",
     "typescript": "^5.6.3",
-    "vitest": "^2.1.2",
+    "vitest": "^2.1.3",
     "xo": "^0.59.3"
   },
   "files": [

package/dist/index.d.cts

@@ -1,29 +0,0 @@
-type EventListener = (...arguments_: any[]) => void;
-declare class Eventified {
-    _eventListeners: Map<string, EventListener[]>;
-    _maxListeners: number;
-    constructor();
-    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;
-    listeners(event: string): EventListener[];
-    removeAllListeners(event?: string): void;
-    setMaxListeners(n: number): void;
-}
-
-type Hook = (...arguments_: any[]) => Promise<void> | void;
-declare class Hookified extends Eventified {
-    _hooks: Map<string, Hook[]>;
-    constructor();
-    onHook(event: string, handler: Hook): void;
-    removeHook(event: string, handler: Hook): void;
-    hook<T>(event: string, ...arguments_: T[]): Promise<void>;
-    get hooks(): Map<string, Hook[]>;
-    getHooks(event: string): Hook[] | undefined;
-    clearHooks(): void;
-}
-
-export { type EventListener, Eventified, type Hook, Hookified };

package/dist/index.d.ts

@@ -1,29 +0,0 @@
-type EventListener = (...arguments_: any[]) => void;
-declare class Eventified {
-    _eventListeners: Map<string, EventListener[]>;
-    _maxListeners: number;
-    constructor();
-    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;
-    listeners(event: string): EventListener[];
-    removeAllListeners(event?: string): void;
-    setMaxListeners(n: number): void;
-}
-
-type Hook = (...arguments_: any[]) => Promise<void> | void;
-declare class Hookified extends Eventified {
-    _hooks: Map<string, Hook[]>;
-    constructor();
-    onHook(event: string, handler: Hook): void;
-    removeHook(event: string, handler: Hook): void;
-    hook<T>(event: string, ...arguments_: T[]): Promise<void>;
-    get hooks(): Map<string, Hook[]>;
-    getHooks(event: string): Hook[] | undefined;
-    clearHooks(): void;
-}
-
-export { type EventListener, Eventified, type Hook, Hookified };