tiny-essentials 1.28.0 → 1.28.2

package/dist/v1/libs/TinyIframeEvents.cjs

@@ -2,6 +2,9 @@
 
 var events = require('events');
 var objChecker = require('../basics/objChecker.cjs');
+var utils = require('./utils.cjs');
+
+const checkDestroy = utils.createCheckDestroyed('TinyIframeEvents');
 
 /** @type {WeakMap<Window, TinyIframeEvents>} */
 const instances = new WeakMap();
@@ -51,6 +54,7 @@ class TinyIframeEvents extends events.EventEmitter {
   #targetWindow;
 
   get targetWindow() {
+    checkDestroy(this.#isDestroyed);
     return this.#targetWindow;
   }
 
@@ -58,6 +62,7 @@ class TinyIframeEvents extends events.EventEmitter {
   #targetIframeElement;
 
   get targetIframeElement() {
+    checkDestroy(this.#isDestroyed);
     return this.#targetIframeElement;
   }
 
@@ -65,6 +70,7 @@ class TinyIframeEvents extends events.EventEmitter {
   #targetOrigin;
 
   get targetOrigin() {
+    checkDestroy(this.#isDestroyed);
     return this.#targetOrigin;
   }
 
@@ -72,6 +78,7 @@ class TinyIframeEvents extends events.EventEmitter {
   #selfType;
 
   get selfType() {
+    checkDestroy(this.#isDestroyed);
     return this.#selfType;
   }
 
@@ -82,6 +89,7 @@ class TinyIframeEvents extends events.EventEmitter {
   #ready = false;
 
   get ready() {
+    checkDestroy(this.#isDestroyed);
     return this.#ready;
   }
 
@@ -89,9 +97,10 @@ class TinyIframeEvents extends events.EventEmitter {
    * Executes the provided callback when the secure MessageChannel connection is fully established.
    * If the connection is already ready, the callback is executed immediately.
    *
-   * @param {function(): void} handler - The callback function to execute.
+   * @param {() => void} handler - The callback function to execute.
    */
   onReady(handler) {
+    checkDestroy(this.#isDestroyed);
     if (this.#ready) {
       handler();
     } else {
@@ -168,6 +177,7 @@ class TinyIframeEvents extends events.EventEmitter {
    * @returns {string}
    */
   get secretEventName() {
+    checkDestroy(this.#isDestroyed);
     return this.#secretEventName;
   }
 
@@ -177,6 +187,7 @@ class TinyIframeEvents extends events.EventEmitter {
    * @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;
@@ -187,6 +198,7 @@ class TinyIframeEvents extends events.EventEmitter {
    * @returns {string}
    */
   get handshakeEventName() {
+    checkDestroy(this.#isDestroyed);
     return this.#handshakeEventName;
   }
 
@@ -196,6 +208,7 @@ class TinyIframeEvents extends events.EventEmitter {
    * @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;
@@ -206,6 +219,7 @@ class TinyIframeEvents extends events.EventEmitter {
    * @returns {string}
    */
   get readyEventName() {
+    checkDestroy(this.#isDestroyed);
     return this.#readyEventName;
   }
 
@@ -215,6 +229,7 @@ class TinyIframeEvents extends events.EventEmitter {
    * @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;
@@ -339,6 +354,7 @@ class TinyIframeEvents extends events.EventEmitter {
    * @throws {Error} If instance has been destroyed.
    */
   winEmit(eventName, payload) {
+    checkDestroy(this.#isDestroyed);
     if (typeof eventName !== 'string') throw new TypeError('Event name must be a string.');
     if (this.#isDestroyed) throw new Error('Cannot emit: instance has been destroyed.');
 
@@ -372,7 +388,7 @@ class TinyIframeEvents extends events.EventEmitter {
    * 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);
@@ -389,6 +405,7 @@ class TinyIframeEvents extends events.EventEmitter {
     this.removeAllListeners();
     this.#pendingQueue = [];
     instances.delete(this.#targetWindow);
+    this.#isDestroyed = true;
   }
 }
 

package/dist/v1/libs/TinyIframeEvents.d.mts

@@ -1,41 +1,32 @@
-export default TinyIframeEvents;
-/**
- * A function to handle incoming event payloads.
- */
+import { EventEmitter } from 'events';
 export type handler = (payload: any, event: MessageEvent<any>) => any;
-/**
- * Configuration object for initializing TinyIframeEvents.
- */
 export type TinyIframeEventsConfig = {
     /**
      * - The target iframe element to post messages to. Required if instantiated in the parent window.
      */
-    targetIframe?: HTMLIFrameElement | undefined;
+    targetIframe?: HTMLIFrameElement;
     /**
      * - The target origin to restrict messages to. Defaults to `window.location.origin`.
      */
-    targetOrigin?: string | undefined;
+    targetOrigin?: string;
     /**
      * - Custom internal name used to validate standard routing messages.
      */
-    secretEventName?: string | undefined;
+    secretEventName?: string;
     /**
      * - Custom internal name used for the initial MessageChannel handshake.
      */
-    handshakeEventName?: string | undefined;
+    handshakeEventName?: string;
     /**
      * - Custom internal name used for the ready event trigger.
      */
-    readyEventName?: string | undefined;
+    readyEventName?: string;
 };
-/**
- * Internal message structure for routed communication.
- */
 export type IframeEventBase = {
     /**
      * - Dynamic key based on secretEventName to validate the message.
      */
-    secretIndicator?: boolean | undefined;
+    secretIndicator?: boolean;
     /**
      * - The name of the custom event route.
      */
@@ -47,7 +38,7 @@ export type IframeEventBase = {
     /**
      * - Indicates the sender: 'iframe' or 'parent'.
      */
-    direction: "iframe" | "parent";
+    direction: 'iframe' | 'parent';
 };
 /**
  * @callback handler
@@ -86,14 +77,10 @@ export type IframeEventBase = {
  * - Queue management for messages sent before the connection is established.
  * - Auto-reconnects and resets ports if the target iframe is reloaded.
  */
-declare class TinyIframeEvents extends EventEmitter<any> {
-    /**
-     * Creates a new TinyIframeEvents instance to manage secure communication.
-     * Automatically establishes a MessageChannel connection between contexts.
-     *
-     * @param {TinyIframeEventsConfig} config - Configuration object.
-     */
-    constructor({ targetIframe, targetOrigin, secretEventName, handshakeEventName, readyEventName, }?: TinyIframeEventsConfig);
+declare class TinyIframeEvents extends EventEmitter {
+    #private;
+    _boundWindowMessage: (event: MessageEvent<any>) => void;
+    _boundPortMessage: (event: MessageEvent<any>) => void;
     get targetWindow(): Window;
     get targetIframeElement(): HTMLIFrameElement | undefined;
     get targetOrigin(): string;
@@ -103,44 +90,49 @@ declare class TinyIframeEvents extends EventEmitter<any> {
      * Executes the provided callback when the secure MessageChannel connection is fully established.
      * If the connection is already ready, the callback is executed immediately.
      *
-     * @param {function(): void} handler - The callback function to execute.
+     * @param {() => void} handler - The callback function to execute.
      */
     onReady(handler: () => void): void;
-    _boundWindowMessage: (event: MessageEvent<any>) => void;
-    _boundPortMessage: (event: MessageEvent<any>) => void;
     /**
-     * Sets the internal secret iframe event name.
-     * @param {string} name
-     * @throws {TypeError} If the value is not a string.
+     * Creates a new TinyIframeEvents instance to manage secure communication.
+     * Automatically establishes a MessageChannel connection between contexts.
+     *
+     * @param {TinyIframeEventsConfig} config - Configuration object.
      */
-    set secretEventName(name: string);
+    constructor({ targetIframe, targetOrigin, secretEventName, handshakeEventName, readyEventName, }?: TinyIframeEventsConfig);
     /**
      * Gets the internal secret iframe event name used for validation.
      * @returns {string}
      */
     get secretEventName(): string;
     /**
-     * Sets the internal handshake event name.
+     * Sets the internal secret iframe event name.
      * @param {string} name
      * @throws {TypeError} If the value is not a string.
      */
-    set handshakeEventName(name: string);
+    set secretEventName(name: string);
     /**
      * Gets the internal handshake event name used for establishing the MessageChannel.
      * @returns {string}
      */
     get handshakeEventName(): string;
     /**
-     * Sets the internal ready event name.
+     * Sets the internal handshake event name.
      * @param {string} name
      * @throws {TypeError} If the value is not a string.
      */
-    set readyEventName(name: string);
+    set handshakeEventName(name: string);
     /**
      * Gets the internal ready event name used when the connection is fully established.
      * @returns {string}
      */
     get readyEventName(): string;
+    /**
+     * Sets the internal ready event name.
+     * @param {string} name
+     * @throws {TypeError} If the value is not a string.
+     */
+    set readyEventName(name: string);
     /**
      * Sends an event to the target window through the secure MessageChannel.
      *
@@ -161,7 +153,6 @@ declare class TinyIframeEvents extends EventEmitter<any> {
      * Call this when the instance is no longer needed to prevent memory leaks.
      */
     destroy(): void;
-    #private;
 }
-import { EventEmitter } from 'events';
+export default TinyIframeEvents;
 //# sourceMappingURL=TinyIframeEvents.d.mts.map

package/dist/v1/libs/TinyIframeEvents.mjs

@@ -1,5 +1,7 @@
 import { EventEmitter } from 'events';
 import { isJsonObject } from '../basics/objChecker.mjs';
+import { createCheckDestroyed } from './utils.mjs';
+const checkDestroy = createCheckDestroyed('TinyIframeEvents');
 /** @type {WeakMap<Window, TinyIframeEvents>} */
 const instances = new WeakMap();
 /**
@@ -43,21 +45,25 @@ 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} */
@@ -65,15 +71,17 @@ class TinyIframeEvents extends EventEmitter {
     /** @type {boolean} */
     #ready = false;
     get ready() {
+        checkDestroy(this.#isDestroyed);
         return this.#ready;
     }
     /**
      * Executes the provided callback when the secure MessageChannel connection is fully established.
      * If the connection is already ready, the callback is executed immediately.
      *
-     * @param {function(): void} handler - The callback function to execute.
+     * @param {() => void} handler - The callback function to execute.
      */
     onReady(handler) {
+        checkDestroy(this.#isDestroyed);
         if (this.#ready) {
             handler();
         }
@@ -127,6 +135,7 @@ class TinyIframeEvents extends EventEmitter {
      * @returns {string}
      */
     get secretEventName() {
+        checkDestroy(this.#isDestroyed);
         return this.#secretEventName;
     }
     /**
@@ -135,6 +144,7 @@ class TinyIframeEvents extends EventEmitter {
      * @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;
@@ -144,6 +154,7 @@ class TinyIframeEvents extends EventEmitter {
      * @returns {string}
      */
     get handshakeEventName() {
+        checkDestroy(this.#isDestroyed);
         return this.#handshakeEventName;
     }
     /**
@@ -152,6 +163,7 @@ class TinyIframeEvents extends EventEmitter {
      * @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;
@@ -161,6 +173,7 @@ class TinyIframeEvents extends EventEmitter {
      * @returns {string}
      */
     get readyEventName() {
+        checkDestroy(this.#isDestroyed);
         return this.#readyEventName;
     }
     /**
@@ -169,6 +182,7 @@ class TinyIframeEvents extends EventEmitter {
      * @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;
@@ -276,6 +290,7 @@ class TinyIframeEvents extends EventEmitter {
      * @throws {Error} If instance has been destroyed.
      */
     winEmit(eventName, payload) {
+        checkDestroy(this.#isDestroyed);
         if (typeof eventName !== 'string')
             throw new TypeError('Event name must be a string.');
         if (this.#isDestroyed)
@@ -306,7 +321,8 @@ class TinyIframeEvents extends EventEmitter {
      * 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) {
@@ -319,6 +335,7 @@ class TinyIframeEvents extends EventEmitter {
         this.removeAllListeners();
         this.#pendingQueue = [];
         instances.delete(this.#targetWindow);
+        this.#isDestroyed = true;
     }
 }
 export default TinyIframeEvents;