EventEmitter fixed.

Author: JasminDreasond

docs/TinyChain/Events.md

@@ -75,93 +75,3 @@ This class defines all the event names used by `TinyChain` in the EventEmitter.
 
   **Description:**
   Validates if a given event is one of the defined event names in the class.
-
----
-
-### 📏 `setMaxListeners(max)`
-
-Set the maximum number of listeners allowed for the internal event emitter.
-
-* **Parameters:**
-
-  * `max` *(number)*: Maximum number of allowed listeners.
-
-> 🧠 Useful for preventing memory leaks due to excessive listeners.
-
----
-
-### 📣 `emit(event, ...args)`
-
-Emit an event, triggering all listeners registered to it.
-
-* **Parameters:**
-
-  * `event` *(string | symbol)*: Name of the event to emit.
-  * `...args` *(any)*: Optional arguments passed to listeners.
-* **Returns:** `boolean` – `true` if the event had listeners, `false` otherwise.
-
-> 🚀 Emits are synchronous and fire listeners in the order they were registered.
-
----
-
-### 🎧 `on(event, listener)`
-
-Register a listener for the specified event.
-
-* **Parameters:**
-
-  * `event` *(string | symbol)*: The event name.
-  * `listener` *(ListenerCallback)*: Function to invoke when the event is emitted.
-* **Returns:** `this` – Enables method chaining.
-
----
-
-### ⏱️ `once(event, listener)`
-
-Register a one-time listener for the event. It will be invoked once and then automatically removed.
-
-* **Parameters:**
-
-  * `event` *(string | symbol)*: The event name.
-  * `listener` *(ListenerCallback)*: The callback function.
-* **Returns:** `this`
-
----
-
-### 🧹 `off(event, listener)`
-
-Remove a specific listener from the given event.
-
-* **Parameters:**
-
-  * `event` *(string | symbol)*: The event name.
-  * `listener` *(ListenerCallback)*: The listener to remove.
-* **Returns:** `this`
-
----
-
-### ➕ `addListener(event, listener)`
-
-Alias for `.on()` – Register a listener for the specified event.
-
-* **Parameters:**
-
-  * `event` *(string | symbol)*: The event name.
-  * `listener` *(ListenerCallback)*: The callback function.
-* **Returns:** `this`
-
-> 🔁 Use this if you prefer the more explicit naming convention.
-
----
-
-### ➖ `removeListener(event, listener)`
-
-Alias for `.off()` – Remove a listener from the event.
-
-* **Parameters:**
-
-  * `event` *(string | symbol)*: The event name.
-  * `listener` *(ListenerCallback)*: The listener to remove.
-* **Returns:** `this`
-
-> 🧽 Perfect for cleaning up listeners dynamically.

package.json

@@ -1,6 +1,6 @@
 {
   "name": "tiny-crypto-suite",
-  "version": "1.5.1",
+  "version": "1.5.2",
   "description": "Tiny tools, big crypto — seamless encryption and certificate handling for modern web and Node apps.",
   "scripts": {
     "test": "npm run test:mjs && npm run test:cjs && npm run test:js",

src/TinyChain/Instance.mjs

@@ -195,6 +195,86 @@ class TinyChainInstance {
     return this;
   }
 
+  /**
+   * Removes all listeners for a specific event, or all events if no event is specified.
+   * @param {string | symbol} [event] - The name of the event. If omitted, all listeners from all events will be removed.
+   * @returns {this} The current class instance (for chaining).
+   */
+  removeAllListeners(event) {
+    this.#events.removeAllListeners(event);
+    return this;
+  }
+
+  /**
+   * Returns the number of times the given `listener` is registered for the specified `event`.
+   * If no `listener` is passed, returns how many listeners are registered for the `event`.
+   * @param {string | symbol} eventName - The name of the event.
+   * @param {Function} [listener] - Optional listener function to count.
+   * @returns {number} Number of matching listeners.
+   */
+  listenerCount(eventName, listener) {
+    return this.#events.listenerCount(eventName, listener);
+  }
+
+  /**
+   * Adds a listener function to the **beginning** of the listeners array for the specified event.
+   * The listener is called every time the event is emitted.
+   * @param {string | symbol} eventName - The event name.
+   * @param {ListenerCallback} listener - The callback function.
+   * @returns {this} The current class instance (for chaining).
+   */
+  prependListener(eventName, listener) {
+    this.#events.prependListener(eventName, listener);
+    return this;
+  }
+
+  /**
+   * Adds a **one-time** listener function to the **beginning** of the listeners array.
+   * The next time the event is triggered, this listener is removed and then invoked.
+   * @param {string | symbol} eventName - The event name.
+   * @param {ListenerCallback} listener - The callback function.
+   * @returns {this} The current class instance (for chaining).
+   */
+  prependOnceListener(eventName, listener) {
+    this.#events.prependOnceListener(eventName, listener);
+    return this;
+  }
+
+  /**
+   * Returns an array of event names for which listeners are currently registered.
+   * @returns {(string | symbol)[]} Array of event names.
+   */
+  eventNames() {
+    return this.#events.eventNames();
+  }
+
+  /**
+   * Gets the current maximum number of listeners allowed for any single event.
+   * @returns {number} The max listener count.
+   */
+  getMaxListeners() {
+    return this.#events.getMaxListeners();
+  }
+
+  /**
+   * Returns a copy of the listeners array for the specified event.
+   * @param {string | symbol} eventName - The event name.
+   * @returns {Function[]} An array of listener functions.
+   */
+  listeners(eventName) {
+    return this.#events.listeners(eventName);
+  }
+
+  /**
+   * Returns a copy of the internal listeners array for the specified event,
+   * including wrapper functions like those used by `.once()`.
+   * @param {string | symbol} eventName - The event name.
+   * @returns {Function[]} An array of raw listener functions.
+   */
+  rawListeners(eventName) {
+    return this.#events.rawListeners(eventName);
+  }
+
   /**
    * Important instance used to make request queue.
    * @type {TinyPromiseQueue}
@@ -1745,6 +1825,20 @@ class TinyChainInstance {
   getBlockSizeLimit() {
     return this.#blockSizeLimit;
   }
+
+  /**
+   * Destroys the current instance by resetting all internal state.
+   *
+   * This method clears the chain data, resets all balances,
+   * and removes all attached listeners from both internal and system event emitters.
+   * It should be called when the instance is no longer needed to free up memory and avoid leaks.
+   */
+  destroy() {
+    this.chain = [];
+    this.balances = {};
+    this.#events.removeAllListeners();
+    this.#sysEvents.removeAllListeners();
+  }
 }
 
 export default TinyChainInstance;

src/TinyOlm/Instance.mjs

@@ -50,13 +50,46 @@ class TinyOlmInstance {
    */
   #events = new EventEmitter();
 
+  /**
+   * Important instance used to make system event emitter.
+   * @type {EventEmitter}
+   */
+  #sysEvents = new EventEmitter();
+  #sysEventsUsed = false;
+
   /**
    * Emits an event with optional arguments to all system emit.
    * @param {string | symbol} event - The name of the event to emit.
    * @param {...any} args - Arguments passed to event listeners.
    */
   #emit(event, ...args) {
     this.#events.emit(event, ...args);
+    if (this.#sysEventsUsed) this.#sysEvents.emit(event, ...args);
+  }
+
+  /**
+   * Provides access to a secure internal EventEmitter for subclass use only.
+   *
+   * This method exposes a dedicated EventEmitter instance intended specifically for subclasses
+   * that extend the main class. It prevents subclasses from accidentally or intentionally using
+   * the primary class's public event system (`emit`), which could lead to unpredictable behavior
+   * or interference in the base class's event flow.
+   *
+   * For security and consistency, this method is designed to be accessed only once.
+   * Multiple accesses are blocked to avoid leaks or misuse of the internal event bus.
+   *
+   * @returns {EventEmitter} A special internal EventEmitter instance for subclass use.
+   * @throws {Error} If the method is called more than once.
+   */
+  getSysEvents() {
+    if (this.#sysEventsUsed)
+      throw new Error(
+        'Access denied: getSysEvents() can only be called once. ' +
+          'This restriction ensures subclass event isolation and prevents accidental interference ' +
+          'with the main class event emitter.',
+      );
+    this.#sysEventsUsed = true;
+    return this.#sysEvents;
   }
 
   /**
@@ -138,6 +171,86 @@ class TinyOlmInstance {
     return this;
   }
 
+  /**
+   * Removes all listeners for a specific event, or all events if no event is specified.
+   * @param {string | symbol} [event] - The name of the event. If omitted, all listeners from all events will be removed.
+   * @returns {this} The current class instance (for chaining).
+   */
+  removeAllListeners(event) {
+    this.#events.removeAllListeners(event);
+    return this;
+  }
+
+  /**
+   * Returns the number of times the given `listener` is registered for the specified `event`.
+   * If no `listener` is passed, returns how many listeners are registered for the `event`.
+   * @param {string | symbol} eventName - The name of the event.
+   * @param {Function} [listener] - Optional listener function to count.
+   * @returns {number} Number of matching listeners.
+   */
+  listenerCount(eventName, listener) {
+    return this.#events.listenerCount(eventName, listener);
+  }
+
+  /**
+   * Adds a listener function to the **beginning** of the listeners array for the specified event.
+   * The listener is called every time the event is emitted.
+   * @param {string | symbol} eventName - The event name.
+   * @param {ListenerCallback} listener - The callback function.
+   * @returns {this} The current class instance (for chaining).
+   */
+  prependListener(eventName, listener) {
+    this.#events.prependListener(eventName, listener);
+    return this;
+  }
+
+  /**
+   * Adds a **one-time** listener function to the **beginning** of the listeners array.
+   * The next time the event is triggered, this listener is removed and then invoked.
+   * @param {string | symbol} eventName - The event name.
+   * @param {ListenerCallback} listener - The callback function.
+   * @returns {this} The current class instance (for chaining).
+   */
+  prependOnceListener(eventName, listener) {
+    this.#events.prependOnceListener(eventName, listener);
+    return this;
+  }
+
+  /**
+   * Returns an array of event names for which listeners are currently registered.
+   * @returns {(string | symbol)[]} Array of event names.
+   */
+  eventNames() {
+    return this.#events.eventNames();
+  }
+
+  /**
+   * Gets the current maximum number of listeners allowed for any single event.
+   * @returns {number} The max listener count.
+   */
+  getMaxListeners() {
+    return this.#events.getMaxListeners();
+  }
+
+  /**
+   * Returns a copy of the listeners array for the specified event.
+   * @param {string | symbol} eventName - The event name.
+   * @returns {Function[]} An array of listener functions.
+   */
+  listeners(eventName) {
+    return this.#events.listeners(eventName);
+  }
+
+  /**
+   * Returns a copy of the internal listeners array for the specified event,
+   * including wrapper functions like those used by `.once()`.
+   * @param {string | symbol} eventName - The event name.
+   * @returns {Function[]} An array of raw listener functions.
+   */
+  rawListeners(eventName) {
+    return this.#events.rawListeners(eventName);
+  }
+
   /**
    * Important instance used to validate values.
    * @type {TinyCryptoParser}
@@ -1730,6 +1843,23 @@ class TinyOlmInstance {
       }
     });
   }
+
+  /**
+   * Destroys the instance by disposing internal resources and removing all event listeners.
+   *
+   * This method ensures a clean shutdown of the instance by first calling `dispose()`—which is expected
+   * to release external or internal resources (such as timers or memory references)—and then
+   * removes all listeners from both `#events` and `#sysEvents` to prevent memory leaks or unintended behavior.
+   *
+   * It should be called when the instance is no longer needed.
+   *
+   * @returns {Promise<void>} Resolves when cleanup is complete.
+   */
+  async destroy() {
+    await this.dispose();
+    this.#events.removeAllListeners();
+    this.#sysEvents.removeAllListeners();
+  }
 }
 
 export default TinyOlmInstance;