tiny-essentials 1.27.1 → 1.28.1

package/dist/v1/libs/TinyIframeEvents.mjs

@@ -1,5 +1,7 @@
+import { EventEmitter } from 'events';
 import { isJsonObject } from '../basics/objChecker.mjs';
-import TinyEvents from './TinyEvents.mjs';
+import { createCheckDestroyed } from './utils.mjs';
+const checkDestroy = createCheckDestroyed('TinyIframeEvents');
 /** @type {WeakMap<Window, TinyIframeEvents>} */
 const instances = new WeakMap();
 /**
@@ -39,188 +41,29 @@ const instances = new WeakMap();
  * - Queue management for messages sent before the connection is established.
  * - Auto-reconnects and resets ports if the target iframe is reloaded.
  */
-class TinyIframeEvents {
-    #events = new TinyEvents();
-    /**
-     * Enables or disables throwing an error when the maximum number of listeners is exceeded.
-     *
-     * @param {boolean} shouldThrow - If true, an error will be thrown when the max is exceeded.
-     */
-    setThrowOnMaxListeners(shouldThrow) {
-        return this.#events.setThrowOnMaxListeners(shouldThrow);
-    }
-    /**
-     * Checks whether an error will be thrown when the max listener limit is exceeded.
-     *
-     * @returns {boolean} True if an error will be thrown, false if only a warning is shown.
-     */
-    getThrowOnMaxListeners() {
-        return this.#events.getThrowOnMaxListeners();
-    }
-    /////////////////////////////////////////////////////////////
-    /**
-     * Adds a listener to the beginning of the listeners array for the specified event.
-     *
-     * @param {string|string[]} event - Event name.
-     * @param {handler} handler - The callback function.
-     */
-    prependListener(event, handler) {
-        return this.#events.prependListener(event, handler);
-    }
-    /**
-     * Adds a one-time listener to the beginning of the listeners array for the specified event.
-     *
-     * @param {string|string[]} event - Event name.
-     * @param {handler} handler - The callback function.
-     * @returns {handler[]} - The wrapped handler used internally.
-     */
-    prependListenerOnce(event, handler) {
-        return this.#events.prependListenerOnce(event, handler);
-    }
-    //////////////////////////////////////////////////////////////////////
-    /**
-     * Adds a event listener.
-     *
-     * @param {string|string[]} event - Event name, such as 'onScrollBoundary' or 'onAutoScroll'.
-     * @param {handler} handler - Callback function to be called when event fires.
-     */
-    appendListener(event, handler) {
-        return this.#events.appendListener(event, handler);
-    }
-    /**
-     * Registers an event listener that runs only once, then is removed.
-     *
-     * @param {string|string[]} event - Event name, such as 'onScrollBoundary' or 'onAutoScroll'.
-     * @param {handler} handler - The callback function to run on event.
-     * @returns {handler[]} - The wrapped version of the handler.
-     */
-    appendListenerOnce(event, handler) {
-        return this.#events.appendListenerOnce(event, handler);
-    }
-    /**
-     * Adds a event listener.
-     *
-     * @param {string|string[]} event - Event name, such as 'onScrollBoundary' or 'onAutoScroll'.
-     * @param {handler} handler - Callback function to be called when event fires.
-     */
-    on(event, handler) {
-        return this.#events.on(event, handler);
-    }
-    /**
-     * Registers an event listener that runs only once, then is removed.
-     *
-     * @param {string|string[]} event - Event name, such as 'onScrollBoundary' or 'onAutoScroll'.
-     * @param {handler} handler - The callback function to run on event.
-     * @returns {handler[]} - The wrapped version of the handler.
-     */
-    once(event, handler) {
-        return this.#events.once(event, handler);
-    }
-    ////////////////////////////////////////////////////////////////////
-    /**
-     * Removes a previously registered event listener.
-     *
-     * @param {string|string[]} event - The name of the event to remove the handler from.
-     * @param {handler} handler - The specific callback function to remove.
-     */
-    off(event, handler) {
-        return this.#events.off(event, handler);
-    }
-    /**
-     * Removes all event listeners of a specific type from the element.
-     *
-     * @param {string|string[]} event - The event type to remove (e.g. 'onScrollBoundary').
-     */
-    offAll(event) {
-        return this.#events.offAll(event);
-    }
-    /**
-     * Removes all event listeners of all types from the element.
-     */
-    offAllTypes() {
-        return this.#events.offAllTypes();
-    }
-    ////////////////////////////////////////////////////////////
-    /**
-     * Returns the number of listeners for a given event.
-     *
-     * @param {string} event - The name of the event.
-     * @returns {number} Number of listeners for the event.
-     */
-    listenerCount(event) {
-        return this.#events.listenerCount(event);
-    }
-    /**
-     * Returns a copy of the array of listeners for the specified event.
-     *
-     * @param {string} event - The name of the event.
-     * @returns {handler[]} Array of listener functions.
-     */
-    listeners(event) {
-        return this.#events.listeners(event);
-    }
-    /**
-     * Returns a copy of the array of listeners for the specified event.
-     *
-     * @param {string} event - The name of the event.
-     * @returns {handler[]} Array of listener functions.
-     */
-    onceListeners(event) {
-        return this.#events.onceListeners(event);
-    }
-    /**
-     * Returns a copy of the internal listeners array for the specified event,
-     * including wrapper functions like those used by `.once()`.
-     * @param {string | symbol} event - The event name.
-     * @returns {handler[]} An array of raw listener functions.
-     */
-    allListeners(event) {
-        return this.#events.allListeners(event);
-    }
-    /**
-     * Returns an array of event names for which there are registered listeners.
-     *
-     * @returns {string[]} Array of registered event names.
-     */
-    eventNames() {
-        return this.#events.eventNames();
-    }
-    //////////////////////////////////////////////////////
-    /**
-     * Sets the maximum number of listeners per event before a warning is shown.
-     *
-     * @param {number} n - The maximum number of listeners.
-     */
-    setMaxListeners(n) {
-        return this.#events.setMaxListeners(n);
-    }
-    /**
-     * Gets the maximum number of listeners allowed per event.
-     *
-     * @returns {number} The maximum number of listeners.
-     */
-    getMaxListeners() {
-        return this.#events.getMaxListeners();
-    }
-    ///////////////////////////////////////////////////
+class TinyIframeEvents extends EventEmitter {
     /** @type {Window} */
     #targetWindow;
     get targetWindow() {
+        checkDestroy(this.#isDestroyed);
         return this.#targetWindow;
     }
     /** @type {HTMLIFrameElement | undefined} */
     #targetIframeElement;
     get targetIframeElement() {
+        checkDestroy(this.#isDestroyed);
         return this.#targetIframeElement;
     }
     /** @type {string} */
     #targetOrigin;
     get targetOrigin() {
+        checkDestroy(this.#isDestroyed);
         return this.#targetOrigin;
     }
     /** @type {'iframe' | 'parent'} */
     #selfType;
     get selfType() {
+        checkDestroy(this.#isDestroyed);
         return this.#selfType;
     }
     /** @type {boolean} */
@@ -228,6 +71,7 @@ class TinyIframeEvents {
     /** @type {boolean} */
     #ready = false;
     get ready() {
+        checkDestroy(this.#isDestroyed);
         return this.#ready;
     }
     /**
@@ -237,11 +81,12 @@ class TinyIframeEvents {
      * @param {function(): void} handler - The callback function to execute.
      */
     onReady(handler) {
+        checkDestroy(this.#isDestroyed);
         if (this.#ready) {
             handler();
         }
         else {
-            this.#events.once(this.#readyEventName, handler);
+            this.once(this.#readyEventName, handler);
         }
     }
     /** @type {MessagePort | null} */
@@ -263,6 +108,7 @@ class TinyIframeEvents {
      * @param {TinyIframeEventsConfig} config - Configuration object.
      */
     constructor({ targetIframe, targetOrigin = window.location.origin, secretEventName = '__tinyIframeEvent__', handshakeEventName = '__tinyIframeHandshake__', readyEventName = '__tinyIframeReady__', } = {}) {
+        super();
         if (targetIframe !== undefined &&
             (!(targetIframe instanceof HTMLIFrameElement) || !targetIframe.contentWindow)) {
             throw new TypeError(`[TinyIframeEvents] Invalid "targetIframe": expected HTMLIFrameElement, received ${typeof targetIframe}`);
@@ -289,6 +135,7 @@ class TinyIframeEvents {
      * @returns {string}
      */
     get secretEventName() {
+        checkDestroy(this.#isDestroyed);
         return this.#secretEventName;
     }
     /**
@@ -297,6 +144,7 @@ class TinyIframeEvents {
      * @throws {TypeError} If the value is not a string.
      */
     set secretEventName(name) {
+        checkDestroy(this.#isDestroyed);
         if (typeof name !== 'string')
             throw new TypeError('TinyIframeEvents: secretEventName must be a string.');
         this.#secretEventName = name;
@@ -306,6 +154,7 @@ class TinyIframeEvents {
      * @returns {string}
      */
     get handshakeEventName() {
+        checkDestroy(this.#isDestroyed);
         return this.#handshakeEventName;
     }
     /**
@@ -314,6 +163,7 @@ class TinyIframeEvents {
      * @throws {TypeError} If the value is not a string.
      */
     set handshakeEventName(name) {
+        checkDestroy(this.#isDestroyed);
         if (typeof name !== 'string')
             throw new TypeError('TinyIframeEvents: handshakeEventName must be a string.');
         this.#handshakeEventName = name;
@@ -323,6 +173,7 @@ class TinyIframeEvents {
      * @returns {string}
      */
     get readyEventName() {
+        checkDestroy(this.#isDestroyed);
         return this.#readyEventName;
     }
     /**
@@ -331,6 +182,7 @@ class TinyIframeEvents {
      * @throws {TypeError} If the value is not a string.
      */
     set readyEventName(name) {
+        checkDestroy(this.#isDestroyed);
         if (typeof name !== 'string')
             throw new TypeError('TinyIframeEvents: readyEventName must be a string.');
         this.#readyEventName = name;
@@ -404,7 +256,7 @@ class TinyIframeEvents {
             (this.#selfType === 'parent' && direction !== 'parent')) {
             return;
         }
-        this.#events.emit(eventName, payload, event);
+        this.emit(`win:${eventName}`, payload, event);
     }
     /**
      * Marks the communication as ready, flushes any queued messages,
@@ -415,7 +267,7 @@ class TinyIframeEvents {
             return;
         this.#ready = true;
         this.#flushQueue();
-        this.#events.emit(this.#readyEventName);
+        this.emit(this.#readyEventName);
     }
     /**
      * Sends all pending messages queued before the secure port was established.
@@ -437,7 +289,8 @@ class TinyIframeEvents {
      * @throws {TypeError} If `eventName` is not a string.
      * @throws {Error} If instance has been destroyed.
      */
-    emit(eventName, payload) {
+    winEmit(eventName, payload) {
+        checkDestroy(this.#isDestroyed);
         if (typeof eventName !== 'string')
             throw new TypeError('Event name must be a string.');
         if (this.#isDestroyed)
@@ -468,7 +321,8 @@ class TinyIframeEvents {
      * Call this when the instance is no longer needed to prevent memory leaks.
      */
     destroy() {
-        this.#isDestroyed = true;
+        if (this.#isDestroyed)
+            return;
         this.#ready = false;
         window.removeEventListener('message', this._boundWindowMessage);
         if (this.#targetIframeElement && this.#boundSendPort) {
@@ -478,9 +332,10 @@ class TinyIframeEvents {
             this.#port.close();
             this.#port = null;
         }
-        this.#events.offAllTypes();
+        this.removeAllListeners();
         this.#pendingQueue = [];
         instances.delete(this.#targetWindow);
+        this.#isDestroyed = true;
     }
 }
 export default TinyIframeEvents;