@supercat1337/event-emitter 1.0.7 → 1.0.8

package/README.md

@@ -17,6 +17,10 @@ $ npm install @supercat1337/event-emitter
  - removeListener(event, listener) - Remove an event listener.
  - waitForEvent(event, max_wait_ms = 0) - Wait for an event to be emitted. If max_wait_ms is set to 0, the function will wait indefinitely.
  - waitForAnyEvent(events, max_wait_ms = 0) - Wait for any of the specified events to be emitted. If max_wait_ms is set to 0, the function will wait indefinitely.
+ - clear() - Remove all event listeners
+ - clearEventListeners(event) - Remove all listeners for a specified event
+ - onHasEventListeners(callback) - Subscribe to the "#has-listeners" event. This event is emitted when the number of listeners for any event (except "#has-listeners" and "#no-listeners") goes from 0 to 1.
+ - onNoEventListeners(callback) - Subscribe to the "#no-listeners" event. This event is emitted when the number of listeners for any event (except "#has-listeners" and "#no-listeners") goes from 1 to 0.
 
 ### Usage
 

package/dist/event-emitter.esm.d.ts

@@ -1,50 +1,50 @@
-/** @module EventEmitter */
-/**
- * @template {string} T
- */
-export class EventEmitter<T extends string> {
-    /** @type {Object.<string, Function[]>} */
-    events: {
-        [x: string]: Function[];
-    };
-    /**
-     * on is used to add a callback function that's going to be executed when the event is triggered
-     * @param {T} event
-     * @param {Function} listener
-     * @returns {()=>void}
-     */
-    on(event: T, listener: Function): () => void;
-    /**
-     * Remove an event listener from an event
-     * @param {T} event
-     * @param {Function} listener
-     */
-    removeListener(event: T, listener: Function): void;
-    /**
-     * emit is used to trigger an event
-     * @param {T} event
-     */
-    emit(event: T, ...args: any[]): void;
-    /**
-     * Add a one-time listener
-     * @param {T} event
-     * @param {Function} listener
-     * @returns {()=>void}
-     */
-    once(event: T, listener: Function): () => void;
-    /**
-     * Wait for an event to be emitted
-     * @param {T} event
-     * @param {number} [max_wait_ms=0] - Maximum time to wait in ms. If 0, the function will wait indefinitely.
-     * @returns {Promise<boolean>} - Resolves with true if the event was emitted, false if the time ran out.
-     */
-    waitForEvent(event: T, max_wait_ms?: number): Promise<boolean>;
-    /**
-     * Wait for any of the specified events to be emitted
-     * @param {T[]} events - Array of event names to wait for
-     * @param {number} [max_wait_ms=0] - Maximum time to wait in ms. If 0, the function will wait indefinitely.
-     * @returns {Promise<boolean>} - Resolves with true if any event was emitted, false if the time ran out.
-     */
-    waitForAnyEvent(events: T[], max_wait_ms?: number): Promise<boolean>;
-}
+/** @module EventEmitter */
+/**
+ * @template {string} T
+ */
+export class EventEmitter<T extends string> {
+    /** @type {Object.<string, Function[]>} */
+    events: {
+        [x: string]: Function[];
+    };
+    /**
+     * on is used to add a callback function that's going to be executed when the event is triggered
+     * @param {T} event
+     * @param {Function} listener
+     * @returns {()=>void}
+     */
+    on(event: T, listener: Function): () => void;
+    /**
+     * Remove an event listener from an event
+     * @param {T} event
+     * @param {Function} listener
+     */
+    removeListener(event: T, listener: Function): void;
+    /**
+     * emit is used to trigger an event
+     * @param {T} event
+     */
+    emit(event: T, ...args: any[]): void;
+    /**
+     * Add a one-time listener
+     * @param {T} event
+     * @param {Function} listener
+     * @returns {()=>void}
+     */
+    once(event: T, listener: Function): () => void;
+    /**
+     * Wait for an event to be emitted
+     * @param {T} event
+     * @param {number} [max_wait_ms=0] - Maximum time to wait in ms. If 0, the function will wait indefinitely.
+     * @returns {Promise<boolean>} - Resolves with true if the event was emitted, false if the time ran out.
+     */
+    waitForEvent(event: T, max_wait_ms?: number): Promise<boolean>;
+    /**
+     * Wait for any of the specified events to be emitted
+     * @param {T[]} events - Array of event names to wait for
+     * @param {number} [max_wait_ms=0] - Maximum time to wait in ms. If 0, the function will wait indefinitely.
+     * @returns {Promise<boolean>} - Resolves with true if any event was emitted, false if the time ran out.
+     */
+    waitForAnyEvent(events: T[], max_wait_ms?: number): Promise<boolean>;
+}
 //# sourceMappingURL=event-emitter.esm.d.ts.map

package/dist/event-emitter.esm.js

@@ -159,6 +159,6 @@ class EventEmitter {
 
         });
     }
-}
-
-export { EventEmitter };
+}
+
+export { EventEmitter };

package/dist/event-emitter.esm.min.js

@@ -1 +1 @@
-var u=class{events={};on(e,t){typeof this.events[e]!="object"&&(this.events[e]=[]),this.events[e].push(t);let s=this;return function(){s.removeListener(e,t)}}removeListener(e,t){var s;typeof this.events[e]=="object"&&(s=this.events[e].indexOf(t),s>-1&&this.events[e].splice(s,1))}emit(e){if(typeof this.events[e]=="object"){var t,s,r,i=[].slice.call(arguments,1);for(s=this.events[e].slice(),r=s.length,t=0;t<r;t++)try{s[t].apply(this,i)}catch(n){console.error(e,i),console.error(n)}}}once(e,t){return this.on(e,function s(){this.removeListener(e,s),t.apply(this,arguments)})}waitForEvent(e,t=0){return new Promise(s=>{let r,i=this.on(e,()=>{t>0&&clearTimeout(r),i(),s(!0)});t>0&&(r=setTimeout(()=>{i(),s(!1)},t))})}waitForAnyEvent(e,t=0){return new Promise(s=>{let r,i=[],n=()=>{t>0&&clearTimeout(r),i.forEach(o=>{o()}),s(!0)};e.forEach(o=>{i.push(this.on(o,n))}),t>0&&(r=setTimeout(()=>{n(),s(!1)},t))})}};export{u as EventEmitter};
+var u=class{events={};on(e,t){typeof this.events[e]!="object"&&(this.events[e]=[]),this.events[e].push(t);let s=this;return function(){s.removeListener(e,t)}}removeListener(e,t){var s;typeof this.events[e]=="object"&&(s=this.events[e].indexOf(t),s>-1&&this.events[e].splice(s,1))}emit(e){if(typeof this.events[e]=="object"){var t,s,r,i=[].slice.call(arguments,1);for(s=this.events[e].slice(),r=s.length,t=0;t<r;t++)try{s[t].apply(this,i)}catch(n){console.error(e,i),console.error(n)}}}once(e,t){return this.on(e,function s(){this.removeListener(e,s),t.apply(this,arguments)})}waitForEvent(e,t=0){return new Promise(s=>{let r,i=this.on(e,()=>{t>0&&clearTimeout(r),i(),s(!0)});t>0&&(r=setTimeout(()=>{i(),s(!1)},t))})}waitForAnyEvent(e,t=0){return new Promise(s=>{let r,i=[],n=()=>{t>0&&clearTimeout(r),i.forEach(o=>{o()}),s(!0)};e.forEach(o=>{i.push(this.on(o,n))}),t>0&&(r=setTimeout(()=>{n(),s(!1)},t))})}};export{u as EventEmitter};

package/index.d.ts

@@ -1,2 +1,2 @@
-export { EventEmitter } from "./dist/event-emitter.esm.js";
+export { EventEmitter } from "./dist/event-emitter.esm.js";
 //# sourceMappingURL=index.d.ts.map

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@supercat1337/event-emitter",
-  "version": "1.0.7",
+  "version": "1.0.8",
   "description": "Event Emitter",
   "main": "index.js",
   "scripts": {

package/src/index.js

@@ -10,7 +10,7 @@ class EventEmitter {
 
     /**
      * on is used to add a callback function that's going to be executed when the event is triggered
-     * @param {T} event
+     * @param {T|"#has-listeners"|"#no-listeners"} event
      * @param {Function} listener
      * @returns {()=>void}
      */
@@ -28,11 +28,15 @@ class EventEmitter {
             that.removeListener(event, listener);
         };
 
+        if (this.events[event].length == 1) { 
+            this.emit("#has-listeners", event, listener);
+        }
+
         return unsubscriber;
     }
     /**
      * Remove an event listener from an event
-     * @param {T} event
+     * @param {T|"#has-listeners"|"#no-listeners"} event
      * @param {Function} listener
      */
     removeListener(event, listener) {
@@ -43,13 +47,17 @@ class EventEmitter {
 
             if (idx > -1) {
                 this.events[event].splice(idx, 1);
+
+                if (this.events[event].length == 0) {
+                    this.emit("#no-listeners", event, listener);
+                }
             }
         }
 
     }
     /**
      * emit is used to trigger an event
-     * @param {T} event
+     * @param {T|"#has-listeners"|"#no-listeners"} event
      */
     emit(event) {
         if (typeof this.events[event] !== 'object') return;
@@ -74,7 +82,7 @@ class EventEmitter {
 
     /**
      * Add a one-time listener
-     * @param {T} event
+     * @param {T|"#has-listeners"|"#no-listeners"} event
      * @param {Function} listener
      * @returns {()=>void}
      */
@@ -159,6 +167,39 @@ class EventEmitter {
 
         });
     }
+
+    /**
+     * Clear all events
+     */
+    clear() {
+        this.events = {};
+    }
+
+    /**
+     * Clears all listeners for a specified event.
+     * @param {T|"#has-listeners"|"#no-listeners"} event - The event for which to clear all listeners.
+     */
+    clearEventListeners(event) {
+        this.events[event] = [];
+    }
+
+    /**
+     * onHasEventListeners() is used to subscribe to the "#has-listeners" event. This event is emitted when the number of listeners for any event (except "#has-listeners" and "#no-listeners") goes from 0 to 1.
+     * @param {Function} callback
+     * @returns {()=>void}
+     */
+    onHasEventListeners(callback) {
+        return this.on("#has-listeners", callback);
+    }
+
+    /**
+     * onNoEventListeners() is used to subscribe to the "#no-listeners" event. This event is emitted when the number of listeners for any event (except "#has-listeners" and "#no-listeners") goes from 1 to 0.
+     * @param {Function} callback
+     * @returns {()=>void}
+     */
+    onNoEventListeners(callback) {
+        return this.on("#no-listeners", callback);
+    }
 }
 
 export { EventEmitter };