tiny-essentials 1.28.0 → 1.28.1

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

@@ -38,6 +38,12 @@ declare class TinyNewWinEvents extends EventEmitter<any> {
         name?: string | undefined;
         features?: string | undefined;
     });
+    /**
+     * Gets the current destruction status of the instance.
+     *
+     * @returns {boolean} True if the instance is destroyed, false otherwise.
+     */
+    get destroyed(): boolean;
     /**
      * Sets the internal handshake event name.
      * @param {string} name

package/dist/v1/libs/TinyNewWinEvents.mjs

@@ -1,4 +1,6 @@
 import { EventEmitter } from 'events';
+import { createCheckDestroyed } from './utils.mjs';
+const checkDestroy = createCheckDestroyed('TinyNewWinEvents');
 /**
  * Stores polling intervals associated with window references.
  * Used to detect when the window is closed.
@@ -38,11 +40,25 @@ class TinyNewWinEvents extends EventEmitter {
     #readyEventName = '__TNE_READY__';
     /** @type {string} Internal message type for routed communication */
     #routeEventName = '__TNE_ROUTE__';
+    /**
+     * Tracks whether the instance has been destroyed.
+     * @type {boolean}
+     */
+    #destroyed = false;
+    /**
+     * Gets the current destruction status of the instance.
+     *
+     * @returns {boolean} True if the instance is destroyed, false otherwise.
+     */
+    get destroyed() {
+        return this.#destroyed;
+    }
     /**
      * Gets the internal handshake event name.
      * @returns {string}
      */
     get readyEventName() {
+        checkDestroy(this.#destroyed);
         return this.#readyEventName;
     }
     /**
@@ -51,6 +67,7 @@ class TinyNewWinEvents extends EventEmitter {
      * @throws {TypeError} If the value is not a string.
      */
     set readyEventName(name) {
+        checkDestroy(this.#destroyed);
         if (typeof name !== 'string')
             throw new TypeError('TinyNewWinEvents: readyEventName must be a string.');
         this.#readyEventName = name;
@@ -60,6 +77,7 @@ class TinyNewWinEvents extends EventEmitter {
      * @returns {string}
      */
     get routeEventName() {
+        checkDestroy(this.#destroyed);
         return this.#routeEventName;
     }
     /**
@@ -68,6 +86,7 @@ class TinyNewWinEvents extends EventEmitter {
      * @throws {TypeError} If the value is not a string.
      */
     set routeEventName(name) {
+        checkDestroy(this.#destroyed);
         if (typeof name !== 'string')
             throw new TypeError('TinyNewWinEvents: routeEventName must be a string.');
         this.#routeEventName = name;
@@ -120,6 +139,7 @@ class TinyNewWinEvents extends EventEmitter {
      * @returns {Window|null}
      */
     getWin() {
+        checkDestroy(this.#destroyed);
         return this.#windowRef;
     }
     /**
@@ -176,6 +196,7 @@ class TinyNewWinEvents extends EventEmitter {
      * @returns {void}
      */
     close() {
+        checkDestroy(this.#destroyed);
         if (!this.#isHost)
             throw new Error('Only host can close the window.');
         if (this.#windowRef && !this.#windowRef.closed)
@@ -192,6 +213,7 @@ class TinyNewWinEvents extends EventEmitter {
      * @returns {void}
      */
     winEmit(route, payload) {
+        checkDestroy(this.#destroyed);
         if (typeof route !== 'string')
             throw new TypeError('Event name must be a string.');
         if (this.isDestroyed())
@@ -208,6 +230,7 @@ class TinyNewWinEvents extends EventEmitter {
      * @returns {boolean}
      */
     isConnected() {
+        checkDestroy(this.#destroyed);
         return this.#ready && this.#windowRef && !this.#windowRef.closed ? true : false;
     }
     /**
@@ -233,6 +256,7 @@ class TinyNewWinEvents extends EventEmitter {
      * @returns {void}
      */
     onClose(callback) {
+        checkDestroy(this.#destroyed);
         this.on('WINDOW_REF_CLOSED', callback);
     }
     /**
@@ -242,6 +266,7 @@ class TinyNewWinEvents extends EventEmitter {
      * @returns {void}
      */
     offClose(callback) {
+        checkDestroy(this.#destroyed);
         this.off('WINDOW_REF_CLOSED', callback);
     }
     /**
@@ -270,6 +295,7 @@ class TinyNewWinEvents extends EventEmitter {
         this.#ready = false;
         this.#windowRef = null;
         this.removeAllListeners();
+        this.#destroyed = true;
     }
 }
 export default TinyNewWinEvents;

package/dist/v1/libs/TinyNotifyCenter.cjs

@@ -1,5 +1,9 @@
 'use strict';
 
+var utils = require('./utils.cjs');
+
+const checkDestroy = utils.createCheckDestroyed('TinyNotifyCenter');
+
 /**
  * Represents a single notification entry.
  *
@@ -109,6 +113,21 @@ class TinyNotifyCenter {
     document.body.insertAdjacentHTML(where, TinyNotifyCenter.getTemplate());
   }
 
+  /**
+   * Tracks whether the instance has been destroyed.
+   * @type {boolean}
+   */
+  #destroyed = false;
+
+  /**
+   * Gets the current destruction status of the instance.
+   *
+   * @returns {boolean} True if the instance is destroyed, false otherwise.
+   */
+  get destroyed() {
+    return this.#destroyed;
+  }
+
   /** @type {HTMLElement} */
   #center;
   /** @type {HTMLElement} */
@@ -206,6 +225,7 @@ class TinyNotifyCenter {
    * @param {boolean} value
    */
   setMarkAllAsReadOnClose(value) {
+    checkDestroy(this.#destroyed);
     if (typeof value !== 'boolean')
       throw new TypeError(`Expected boolean for markAllAsReadOnClose, got ${typeof value}`);
     this.#markAllAsReadOnClose = value;
@@ -216,6 +236,7 @@ class TinyNotifyCenter {
    * @param {number} ms
    */
   setRemoveDelay(ms) {
+    checkDestroy(this.#destroyed);
     if (typeof ms !== 'number') throw new Error(`NotificationCenter: "ms" must be an number.`);
     this.#removeDelay = ms;
   }
@@ -226,6 +247,7 @@ class TinyNotifyCenter {
    * @returns {'text' | 'html' | null}
    */
   getItemMode(index) {
+    checkDestroy(this.#destroyed);
     const item = this.getItem(index);
     return item ? this.#modes.get(item) : null;
   }
@@ -236,6 +258,7 @@ class TinyNotifyCenter {
    * @returns {HTMLElement}
    */
   getItem(index) {
+    checkDestroy(this.#destroyed);
     const element = this.#list.children.item(index);
     if (!(element instanceof HTMLElement))
       throw new Error(`NotificationCenter: "item" must be an HTMLElement. Got: ${element}`);
@@ -248,6 +271,7 @@ class TinyNotifyCenter {
    * @returns {boolean}
    */
   hasItem(index) {
+    checkDestroy(this.#destroyed);
     return index >= 0 && index < this.#list.children.length;
   }
 
@@ -256,6 +280,7 @@ class TinyNotifyCenter {
    * @param {number|HTMLElement} index
    */
   markAsRead(index) {
+    checkDestroy(this.#destroyed);
     const item = index instanceof HTMLElement ? index : this.getItem(index);
     if (item.classList.contains('unread')) {
       item.classList.remove('unread');
@@ -270,6 +295,7 @@ class TinyNotifyCenter {
    * @param {'text'|'html'} [mode='text'] - How to treat the message content.
    */
   add(message, mode = 'text') {
+    checkDestroy(this.#destroyed);
     const item = document.createElement('div');
     item.className = 'item unread';
 
@@ -351,6 +377,7 @@ class TinyNotifyCenter {
    * @param {number} index
    */
   remove(index) {
+    checkDestroy(this.#destroyed);
     const item = this.getItem(index);
     this.#removeItem(item);
   }
@@ -359,6 +386,7 @@ class TinyNotifyCenter {
    * Clear all notifications safely.
    */
   clear() {
+    checkDestroy(this.#destroyed);
     let needAgain = true;
     while (needAgain) {
       needAgain = false;
@@ -376,6 +404,7 @@ class TinyNotifyCenter {
    * Open the notify center.
    */
   open() {
+    checkDestroy(this.#destroyed);
     this.#overlay.classList.remove('hidden');
     this.#center.classList.add('open');
   }
@@ -384,6 +413,7 @@ class TinyNotifyCenter {
    * Close the notify center.
    */
   close() {
+    checkDestroy(this.#destroyed);
     this.#overlay.classList.add('hidden');
     this.#center.classList.remove('open');
     if (this.#markAllAsReadOnClose) {
@@ -398,6 +428,7 @@ class TinyNotifyCenter {
    * Toggle open/close state.
    */
   toggle() {
+    checkDestroy(this.#destroyed);
     if (this.#center.classList.contains('open')) this.close();
     else this.open();
   }
@@ -406,6 +437,7 @@ class TinyNotifyCenter {
    * Recalculate the number of notifications based on the actual DOM list.
    */
   recount() {
+    checkDestroy(this.#destroyed);
     const count = this.#list.querySelectorAll('.item.unread').length;
     this.#updateCount(count);
   }
@@ -427,6 +459,7 @@ class TinyNotifyCenter {
    * @returns {void}
    */
   destroy() {
+    if (this.#destroyed) return;
     // Remove event listeners
     this.#button?.removeEventListener('click', this.toggle);
     this.#center?.querySelector('.close')?.removeEventListener('click', this.close);
@@ -448,6 +481,9 @@ class TinyNotifyCenter {
     // this.#overlay = null;
     this.#count = 0;
     this.#modes = new WeakMap();
+
+    // Lock the instance
+    this.#destroyed = true;
   }
 }
 

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

@@ -91,6 +91,12 @@ declare class TinyNotifyCenter {
         button?: HTMLElement | undefined;
         overlay?: HTMLElement | undefined;
     });
+    /**
+     * Gets the current destruction status of the instance.
+     *
+     * @returns {boolean} True if the instance is destroyed, false otherwise.
+     */
+    get destroyed(): boolean;
     /**
      * Enable or disable automatic mark-as-read on close.
      * @param {boolean} value

package/dist/v1/libs/TinyNotifyCenter.mjs

@@ -1,3 +1,5 @@
+import { createCheckDestroyed } from './utils.mjs';
+const checkDestroy = createCheckDestroyed('TinyNotifyCenter');
 /**
  * Represents a single notification entry.
  *
@@ -104,6 +106,19 @@ class TinyNotifyCenter {
     static insertTemplate(where = 'afterbegin') {
         document.body.insertAdjacentHTML(where, TinyNotifyCenter.getTemplate());
     }
+    /**
+     * Tracks whether the instance has been destroyed.
+     * @type {boolean}
+     */
+    #destroyed = false;
+    /**
+     * Gets the current destruction status of the instance.
+     *
+     * @returns {boolean} True if the instance is destroyed, false otherwise.
+     */
+    get destroyed() {
+        return this.#destroyed;
+    }
     /** @type {HTMLElement} */
     #center;
     /** @type {HTMLElement} */
@@ -188,6 +203,7 @@ class TinyNotifyCenter {
      * @param {boolean} value
      */
     setMarkAllAsReadOnClose(value) {
+        checkDestroy(this.#destroyed);
         if (typeof value !== 'boolean')
             throw new TypeError(`Expected boolean for markAllAsReadOnClose, got ${typeof value}`);
         this.#markAllAsReadOnClose = value;
@@ -197,6 +213,7 @@ class TinyNotifyCenter {
      * @param {number} ms
      */
     setRemoveDelay(ms) {
+        checkDestroy(this.#destroyed);
         if (typeof ms !== 'number')
             throw new Error(`NotificationCenter: "ms" must be an number.`);
         this.#removeDelay = ms;
@@ -207,6 +224,7 @@ class TinyNotifyCenter {
      * @returns {'text' | 'html' | null}
      */
     getItemMode(index) {
+        checkDestroy(this.#destroyed);
         const item = this.getItem(index);
         return item ? this.#modes.get(item) : null;
     }
@@ -216,6 +234,7 @@ class TinyNotifyCenter {
      * @returns {HTMLElement}
      */
     getItem(index) {
+        checkDestroy(this.#destroyed);
         const element = this.#list.children.item(index);
         if (!(element instanceof HTMLElement))
             throw new Error(`NotificationCenter: "item" must be an HTMLElement. Got: ${element}`);
@@ -227,6 +246,7 @@ class TinyNotifyCenter {
      * @returns {boolean}
      */
     hasItem(index) {
+        checkDestroy(this.#destroyed);
         return index >= 0 && index < this.#list.children.length;
     }
     /**
@@ -234,6 +254,7 @@ class TinyNotifyCenter {
      * @param {number|HTMLElement} index
      */
     markAsRead(index) {
+        checkDestroy(this.#destroyed);
         const item = index instanceof HTMLElement ? index : this.getItem(index);
         if (item.classList.contains('unread')) {
             item.classList.remove('unread');
@@ -247,6 +268,7 @@ class TinyNotifyCenter {
      * @param {'text'|'html'} [mode='text'] - How to treat the message content.
      */
     add(message, mode = 'text') {
+        checkDestroy(this.#destroyed);
         const item = document.createElement('div');
         item.className = 'item unread';
         let titleText = null;
@@ -318,6 +340,7 @@ class TinyNotifyCenter {
      * @param {number} index
      */
     remove(index) {
+        checkDestroy(this.#destroyed);
         const item = this.getItem(index);
         this.#removeItem(item);
     }
@@ -325,6 +348,7 @@ class TinyNotifyCenter {
      * Clear all notifications safely.
      */
     clear() {
+        checkDestroy(this.#destroyed);
         let needAgain = true;
         while (needAgain) {
             needAgain = false;
@@ -341,6 +365,7 @@ class TinyNotifyCenter {
      * Open the notify center.
      */
     open() {
+        checkDestroy(this.#destroyed);
         this.#overlay.classList.remove('hidden');
         this.#center.classList.add('open');
     }
@@ -348,6 +373,7 @@ class TinyNotifyCenter {
      * Close the notify center.
      */
     close() {
+        checkDestroy(this.#destroyed);
         this.#overlay.classList.add('hidden');
         this.#center.classList.remove('open');
         if (this.#markAllAsReadOnClose) {
@@ -362,6 +388,7 @@ class TinyNotifyCenter {
      * Toggle open/close state.
      */
     toggle() {
+        checkDestroy(this.#destroyed);
         if (this.#center.classList.contains('open'))
             this.close();
         else
@@ -371,6 +398,7 @@ class TinyNotifyCenter {
      * Recalculate the number of notifications based on the actual DOM list.
      */
     recount() {
+        checkDestroy(this.#destroyed);
         const count = this.#list.querySelectorAll('.item.unread').length;
         this.#updateCount(count);
     }
@@ -390,6 +418,8 @@ class TinyNotifyCenter {
      * @returns {void}
      */
     destroy() {
+        if (this.#destroyed)
+            return;
         // Remove event listeners
         this.#button?.removeEventListener('click', this.toggle);
         this.#center?.querySelector('.close')?.removeEventListener('click', this.close);
@@ -408,6 +438,8 @@ class TinyNotifyCenter {
         // this.#overlay = null;
         this.#count = 0;
         this.#modes = new WeakMap();
+        // Lock the instance
+        this.#destroyed = true;
     }
 }
 export default TinyNotifyCenter;

package/dist/v1/libs/TinyRadioFm.cjs

@@ -2,6 +2,9 @@
 
 var events = require('events');
 var mediaContent = require('../basics/mediaContent.cjs');
+var utils = require('./utils.cjs');
+
+const checkDestroy = utils.createCheckDestroyed('TinyRadioFm');
 
 /**
  * @typedef {import('../basics/mediaContent.mjs').MediaContentBase} MediaContentBase
@@ -179,11 +182,19 @@ class TinyRadioFm extends events.EventEmitter {
     TinyRadioFm.#unknownArtist = value;
   }
 
+  /** @type {boolean} */
+  #destroyed = false;
+
+  get destroyed() {
+    return this.#destroyed;
+  }
+
   /**
    * Gets the total count of all content items (music and voice) in the system.
    * @returns {number}
    */
   get size() {
+    checkDestroy(this.#destroyed);
     return this.#musicList.length + this.#voiceList.length;
   }
 
@@ -192,6 +203,7 @@ class TinyRadioFm extends events.EventEmitter {
    * @returns {number}
    */
   get musicSize() {
+    checkDestroy(this.#destroyed);
     return this.#musicList.length;
   }
 
@@ -200,6 +212,7 @@ class TinyRadioFm extends events.EventEmitter {
    * @returns {number}
    */
   get voiceSize() {
+    checkDestroy(this.#destroyed);
     return this.#voiceList.length;
   }
 
@@ -208,6 +221,7 @@ class TinyRadioFm extends events.EventEmitter {
    * @returns {number}
    */
   get customPosSize() {
+    checkDestroy(this.#destroyed);
     return this.#customPositions.length;
   }
 
@@ -216,6 +230,7 @@ class TinyRadioFm extends events.EventEmitter {
    * @returns {number}
    */
   get tasksSize() {
+    checkDestroy(this.#destroyed);
     return this.#scheduledTasks.length;
   }
 
@@ -224,6 +239,7 @@ class TinyRadioFm extends events.EventEmitter {
    * @returns {number}
    */
   get cycleCacheSize() {
+    checkDestroy(this.#destroyed);
     return this.#cycleCache.size;
   }
 
@@ -234,6 +250,7 @@ class TinyRadioFm extends events.EventEmitter {
    * @returns {MediaContent[]}
    */
   get musicList() {
+    checkDestroy(this.#destroyed);
     return structuredClone(this.#musicList);
   }
 
@@ -244,6 +261,7 @@ class TinyRadioFm extends events.EventEmitter {
    * @returns {MediaContent[]}
    */
   get voiceList() {
+    checkDestroy(this.#destroyed);
     return structuredClone(this.#voiceList);
   }
 
@@ -254,6 +272,7 @@ class TinyRadioFm extends events.EventEmitter {
    * @returns {CustomPosition[]}
    */
   get customPositions() {
+    checkDestroy(this.#destroyed);
     return structuredClone(this.#customPositions);
   }
 
@@ -264,6 +283,7 @@ class TinyRadioFm extends events.EventEmitter {
    * @returns {ScheduledTask[]}
    */
   get scheduledTasks() {
+    checkDestroy(this.#destroyed);
     return structuredClone(this.#scheduledTasks);
   }
 
@@ -272,6 +292,7 @@ class TinyRadioFm extends events.EventEmitter {
    * @returns {MediaContent[]} A cloned object of the cache.
    */
   get allList() {
+    checkDestroy(this.#destroyed);
     return [...this.musicList, ...this.voiceList];
   }
 
@@ -282,6 +303,7 @@ class TinyRadioFm extends events.EventEmitter {
    * @returns {number}
    */
   get seed() {
+    checkDestroy(this.#destroyed);
     return this.#seed;
   }
   /**
@@ -289,6 +311,7 @@ class TinyRadioFm extends events.EventEmitter {
    * @param {number} seed - The new seed.
    */
   set seed(seed) {
+    checkDestroy(this.#destroyed);
     if (typeof seed !== 'number') throw new TypeError('Seed must be a number.');
     this.#seed = seed;
     this.#cycleCache.clear();
@@ -302,6 +325,7 @@ class TinyRadioFm extends events.EventEmitter {
    * @returns {number}
    */
   get anchorDate() {
+    checkDestroy(this.#destroyed);
     return this.#anchorDate;
   }
 
@@ -325,6 +349,7 @@ class TinyRadioFm extends events.EventEmitter {
    * @returns {RadioConfig}
    */
   get config() {
+    checkDestroy(this.#destroyed);
     return structuredClone(this.#config);
   }
   /**
@@ -333,6 +358,7 @@ class TinyRadioFm extends events.EventEmitter {
    * @throws {TypeError|RangeError} If the new configuration is invalid.
    */
   set config(config) {
+    checkDestroy(this.#destroyed);
     // Validate the entire object before applying it
     this.#validateConfig(config);
 
@@ -455,6 +481,7 @@ class TinyRadioFm extends events.EventEmitter {
    * @throws {TypeError} If the type is invalid or the data lacks a valid ID and numerical duration.
    */
   add(type, data, smartQueue = true) {
+    checkDestroy(this.#destroyed);
     if (!['music', 'voice', 'custom'].includes(type)) {
       throw new TypeError('Type must be "music", "voice", or "custom".');
     }
@@ -491,6 +518,7 @@ class TinyRadioFm extends events.EventEmitter {
    * @throws {TypeError} If arguments do not match the required types or action/type constraints.
    */
   scheduleTask(timestamp, action, type, payload, smartQueue = true) {
+    checkDestroy(this.#destroyed);
     if (typeof timestamp !== 'number' || isNaN(timestamp))
       throw new TypeError('timestamp must be a valid number.');
     if (!['add', 'remove', 'move'].includes(action))
@@ -560,6 +588,7 @@ class TinyRadioFm extends events.EventEmitter {
    * @throws {TypeError} If the id is not a string.
    */
   remove(id) {
+    checkDestroy(this.#destroyed);
     if (typeof id !== 'string') throw new TypeError('id must be a string.');
 
     // Revoke Blob URLs of items being removed to free memory
@@ -605,6 +634,7 @@ class TinyRadioFm extends events.EventEmitter {
    * @throws {TypeError|RangeError} If the provided values or the resulting state is invalid.
    */
   setConfig(config) {
+    checkDestroy(this.#destroyed);
     // First, validate the incoming partial object for basic type correctness
     this.#validateConfig(config);
 
@@ -624,6 +654,7 @@ class TinyRadioFm extends events.EventEmitter {
    * @returns {RadioEvent|null} The current active event, or null if empty.
    */
   getCurrentEvent() {
+    checkDestroy(this.#destroyed);
     const now = Date.now();
     this.#syncRealTimeState(now);
     return this.#getEventAtTime(now, now);
@@ -639,6 +670,7 @@ class TinyRadioFm extends events.EventEmitter {
    * @throws {RangeError} If the limit exceeds the configured queryLimit or is <= 0.
    */
   queryTimeline(targetDate, limit = 10) {
+    checkDestroy(this.#destroyed);
     if (typeof limit !== 'number' || isNaN(limit)) {
       throw new TypeError(`Invalid query limit value. Ensure it is a number.`);
     }
@@ -677,6 +709,7 @@ class TinyRadioFm extends events.EventEmitter {
    * @returns {CustomPosition[]} Shallow copy of custom positions array.
    */
   searchCustomPositions() {
+    checkDestroy(this.#destroyed);
     this.#syncRealTimeState(Date.now());
     return [...this.#customPositions];
   }
@@ -726,6 +759,7 @@ class TinyRadioFm extends events.EventEmitter {
    * @returns {Promise<string>} Stringified JSON state.
    */
   async exportState() {
+    checkDestroy(this.#destroyed);
     const processedMusic = await this._processListForExport(this.#musicList);
     const processedVoice = await this._processListForExport(this.#voiceList);
 
@@ -770,6 +804,7 @@ class TinyRadioFm extends events.EventEmitter {
    * @throws {TypeError} If json is not a valid string or object.
    */
   importState(json) {
+    checkDestroy(this.#destroyed);
     /** @type {TinyRadioFmImport} */
     let data;
     if (typeof json === 'string') {
@@ -1347,6 +1382,8 @@ class TinyRadioFm extends events.EventEmitter {
    * @param {boolean} [destroyThumbs=true]
    */
   destroy(destroyThumbs = true) {
+    if (this.#destroyed) return;
+
     if (destroyThumbs) {
       this.#musicList.forEach((item) => mediaContent.revokeContentUrls(item));
       this.#voiceList.forEach((item) => mediaContent.revokeContentUrls(item));
@@ -1371,6 +1408,7 @@ class TinyRadioFm extends events.EventEmitter {
     this.#cycleCache.clear();
     this.emit('destroyed', { timestamp: Date.now() });
     this.removeAllListeners();
+    this.#destroyed = true;
   }
 }
 

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

@@ -377,6 +377,7 @@ declare class TinyRadioFm extends EventEmitter<any> {
      * @throws {TypeError} If initialData is not an object or null, or if seed is not a number.
      */
     constructor(initialData?: TinyRadioFmImport | null, seed?: number);
+    get destroyed(): boolean;
     /**
      * Gets the total count of all content items (music and voice) in the system.
      * @returns {number}