tiny-essentials 1.27.1 → 1.28.1

package/dist/v1/libs/TinyRadioFm.cjs

@@ -1,7 +1,10 @@
 'use strict';
 
+var events = require('events');
 var mediaContent = require('../basics/mediaContent.cjs');
-var TinyEvents = require('./TinyEvents.cjs');
+var utils = require('./utils.cjs');
+
+const checkDestroy = utils.createCheckDestroyed('TinyRadioFm');
 
 /**
  * @typedef {import('../basics/mediaContent.mjs').MediaContentBase} MediaContentBase
@@ -126,10 +129,9 @@ var TinyEvents = require('./TinyEvents.cjs');
 
 /**
  * A deterministic, seed-based radio management system with scheduled adaptations and weighted random generation.
- * @extends TinyEvents
  * @beta
  */
-class TinyRadioFm extends TinyEvents {
+class TinyRadioFm extends events.EventEmitter {
   /**
    * A Static Factory Method that prepares a MediaContent object by
    * extracting metadata from an audio source.
@@ -180,11 +182,19 @@ class TinyRadioFm extends TinyEvents {
     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;
   }
 
@@ -193,6 +203,7 @@ class TinyRadioFm extends TinyEvents {
    * @returns {number}
    */
   get musicSize() {
+    checkDestroy(this.#destroyed);
     return this.#musicList.length;
   }
 
@@ -201,6 +212,7 @@ class TinyRadioFm extends TinyEvents {
    * @returns {number}
    */
   get voiceSize() {
+    checkDestroy(this.#destroyed);
     return this.#voiceList.length;
   }
 
@@ -209,6 +221,7 @@ class TinyRadioFm extends TinyEvents {
    * @returns {number}
    */
   get customPosSize() {
+    checkDestroy(this.#destroyed);
     return this.#customPositions.length;
   }
 
@@ -217,6 +230,7 @@ class TinyRadioFm extends TinyEvents {
    * @returns {number}
    */
   get tasksSize() {
+    checkDestroy(this.#destroyed);
     return this.#scheduledTasks.length;
   }
 
@@ -225,6 +239,7 @@ class TinyRadioFm extends TinyEvents {
    * @returns {number}
    */
   get cycleCacheSize() {
+    checkDestroy(this.#destroyed);
     return this.#cycleCache.size;
   }
 
@@ -235,6 +250,7 @@ class TinyRadioFm extends TinyEvents {
    * @returns {MediaContent[]}
    */
   get musicList() {
+    checkDestroy(this.#destroyed);
     return structuredClone(this.#musicList);
   }
 
@@ -245,6 +261,7 @@ class TinyRadioFm extends TinyEvents {
    * @returns {MediaContent[]}
    */
   get voiceList() {
+    checkDestroy(this.#destroyed);
     return structuredClone(this.#voiceList);
   }
 
@@ -255,6 +272,7 @@ class TinyRadioFm extends TinyEvents {
    * @returns {CustomPosition[]}
    */
   get customPositions() {
+    checkDestroy(this.#destroyed);
     return structuredClone(this.#customPositions);
   }
 
@@ -265,6 +283,7 @@ class TinyRadioFm extends TinyEvents {
    * @returns {ScheduledTask[]}
    */
   get scheduledTasks() {
+    checkDestroy(this.#destroyed);
     return structuredClone(this.#scheduledTasks);
   }
 
@@ -273,6 +292,7 @@ class TinyRadioFm extends TinyEvents {
    * @returns {MediaContent[]} A cloned object of the cache.
    */
   get allList() {
+    checkDestroy(this.#destroyed);
     return [...this.musicList, ...this.voiceList];
   }
 
@@ -283,6 +303,7 @@ class TinyRadioFm extends TinyEvents {
    * @returns {number}
    */
   get seed() {
+    checkDestroy(this.#destroyed);
     return this.#seed;
   }
   /**
@@ -290,6 +311,7 @@ class TinyRadioFm extends TinyEvents {
    * @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();
@@ -303,6 +325,7 @@ class TinyRadioFm extends TinyEvents {
    * @returns {number}
    */
   get anchorDate() {
+    checkDestroy(this.#destroyed);
     return this.#anchorDate;
   }
 
@@ -326,6 +349,7 @@ class TinyRadioFm extends TinyEvents {
    * @returns {RadioConfig}
    */
   get config() {
+    checkDestroy(this.#destroyed);
     return structuredClone(this.#config);
   }
   /**
@@ -334,6 +358,7 @@ class TinyRadioFm extends TinyEvents {
    * @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);
 
@@ -456,6 +481,7 @@ class TinyRadioFm extends TinyEvents {
    * @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".');
     }
@@ -492,6 +518,7 @@ class TinyRadioFm extends TinyEvents {
    * @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))
@@ -561,6 +588,7 @@ class TinyRadioFm extends TinyEvents {
    * @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
@@ -606,6 +634,7 @@ class TinyRadioFm extends TinyEvents {
    * @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);
 
@@ -625,6 +654,7 @@ class TinyRadioFm extends TinyEvents {
    * @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);
@@ -640,6 +670,7 @@ class TinyRadioFm extends TinyEvents {
    * @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.`);
     }
@@ -678,6 +709,7 @@ class TinyRadioFm extends TinyEvents {
    * @returns {CustomPosition[]} Shallow copy of custom positions array.
    */
   searchCustomPositions() {
+    checkDestroy(this.#destroyed);
     this.#syncRealTimeState(Date.now());
     return [...this.#customPositions];
   }
@@ -727,6 +759,7 @@ class TinyRadioFm extends TinyEvents {
    * @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);
 
@@ -771,6 +804,7 @@ class TinyRadioFm extends TinyEvents {
    * @throws {TypeError} If json is not a valid string or object.
    */
   importState(json) {
+    checkDestroy(this.#destroyed);
     /** @type {TinyRadioFmImport} */
     let data;
     if (typeof json === 'string') {
@@ -1348,6 +1382,8 @@ class TinyRadioFm extends TinyEvents {
    * @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));
@@ -1372,6 +1408,7 @@ class TinyRadioFm extends TinyEvents {
     this.#cycleCache.clear();
     this.emit('destroyed', { timestamp: Date.now() });
     this.removeAllListeners();
+    this.#destroyed = true;
   }
 }
 

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

@@ -327,10 +327,9 @@ export type TinyRadioFmImport = {
  */
 /**
  * A deterministic, seed-based radio management system with scheduled adaptations and weighted random generation.
- * @extends TinyEvents
  * @beta
  */
-declare class TinyRadioFm extends TinyEvents {
+declare class TinyRadioFm extends EventEmitter<any> {
     /**
      * A Static Factory Method that prepares a MediaContent object by
      * extracting metadata from an audio source.
@@ -378,6 +377,7 @@ declare class TinyRadioFm extends TinyEvents {
      * @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}
@@ -550,5 +550,5 @@ declare class TinyRadioFm extends TinyEvents {
     destroy(destroyThumbs?: boolean): void;
     #private;
 }
-import TinyEvents from './TinyEvents.mjs';
+import { EventEmitter } from 'events';
 //# sourceMappingURL=TinyRadioFm.d.mts.map

package/dist/v1/libs/TinyRadioFm.mjs

@@ -1,5 +1,7 @@
+import { EventEmitter } from 'events';
 import { blobUrlToBase64, convertToBlobUrl, parseMediaMetadata, revokeContentUrls, } from '../basics/mediaContent.mjs';
-import TinyEvents from './TinyEvents.mjs';
+import { createCheckDestroyed } from './utils.mjs';
+const checkDestroy = createCheckDestroyed('TinyRadioFm');
 /**
  * @typedef {import('../basics/mediaContent.mjs').MediaContentBase} MediaContentBase
  * @typedef {import('../basics/mediaContent.mjs').MediaContentMetadata} MediaContentMetadata
@@ -105,10 +107,9 @@ import TinyEvents from './TinyEvents.mjs';
 //////////////////////////////////////////////////////////////////
 /**
  * A deterministic, seed-based radio management system with scheduled adaptations and weighted random generation.
- * @extends TinyEvents
  * @beta
  */
-class TinyRadioFm extends TinyEvents {
+class TinyRadioFm extends EventEmitter {
     /**
      * A Static Factory Method that prepares a MediaContent object by
      * extracting metadata from an audio source.
@@ -148,11 +149,17 @@ class TinyRadioFm extends TinyEvents {
             throw new TypeError('unknownArtist must have an string or function.');
         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;
     }
     /**
@@ -160,6 +167,7 @@ class TinyRadioFm extends TinyEvents {
      * @returns {number}
      */
     get musicSize() {
+        checkDestroy(this.#destroyed);
         return this.#musicList.length;
     }
     /**
@@ -167,6 +175,7 @@ class TinyRadioFm extends TinyEvents {
      * @returns {number}
      */
     get voiceSize() {
+        checkDestroy(this.#destroyed);
         return this.#voiceList.length;
     }
     /**
@@ -174,6 +183,7 @@ class TinyRadioFm extends TinyEvents {
      * @returns {number}
      */
     get customPosSize() {
+        checkDestroy(this.#destroyed);
         return this.#customPositions.length;
     }
     /**
@@ -181,6 +191,7 @@ class TinyRadioFm extends TinyEvents {
      * @returns {number}
      */
     get tasksSize() {
+        checkDestroy(this.#destroyed);
         return this.#scheduledTasks.length;
     }
     /**
@@ -188,6 +199,7 @@ class TinyRadioFm extends TinyEvents {
      * @returns {number}
      */
     get cycleCacheSize() {
+        checkDestroy(this.#destroyed);
         return this.#cycleCache.size;
     }
     /** @type {MediaContent[]} */
@@ -197,6 +209,7 @@ class TinyRadioFm extends TinyEvents {
      * @returns {MediaContent[]}
      */
     get musicList() {
+        checkDestroy(this.#destroyed);
         return structuredClone(this.#musicList);
     }
     /** @type {MediaContent[]} */
@@ -206,6 +219,7 @@ class TinyRadioFm extends TinyEvents {
      * @returns {MediaContent[]}
      */
     get voiceList() {
+        checkDestroy(this.#destroyed);
         return structuredClone(this.#voiceList);
     }
     /** @type {CustomPosition[]} */
@@ -215,6 +229,7 @@ class TinyRadioFm extends TinyEvents {
      * @returns {CustomPosition[]}
      */
     get customPositions() {
+        checkDestroy(this.#destroyed);
         return structuredClone(this.#customPositions);
     }
     /** @type {ScheduledTask[]} */
@@ -224,6 +239,7 @@ class TinyRadioFm extends TinyEvents {
      * @returns {ScheduledTask[]}
      */
     get scheduledTasks() {
+        checkDestroy(this.#destroyed);
         return structuredClone(this.#scheduledTasks);
     }
     /**
@@ -231,6 +247,7 @@ class TinyRadioFm extends TinyEvents {
      * @returns {MediaContent[]} A cloned object of the cache.
      */
     get allList() {
+        checkDestroy(this.#destroyed);
         return [...this.musicList, ...this.voiceList];
     }
     /** @type {number} */
@@ -240,6 +257,7 @@ class TinyRadioFm extends TinyEvents {
      * @returns {number}
      */
     get seed() {
+        checkDestroy(this.#destroyed);
         return this.#seed;
     }
     /**
@@ -247,6 +265,7 @@ class TinyRadioFm extends TinyEvents {
      * @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;
@@ -260,6 +279,7 @@ class TinyRadioFm extends TinyEvents {
      * @returns {number}
      */
     get anchorDate() {
+        checkDestroy(this.#destroyed);
         return this.#anchorDate;
     }
     /** @type {Map<number, CycleBlock>} */
@@ -281,6 +301,7 @@ class TinyRadioFm extends TinyEvents {
      * @returns {RadioConfig}
      */
     get config() {
+        checkDestroy(this.#destroyed);
         return structuredClone(this.#config);
     }
     /**
@@ -289,6 +310,7 @@ class TinyRadioFm extends TinyEvents {
      * @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);
         this.#config = structuredClone(config);
@@ -378,6 +400,7 @@ class TinyRadioFm extends TinyEvents {
      * @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".');
         }
@@ -411,6 +434,7 @@ class TinyRadioFm extends TinyEvents {
      * @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))
@@ -468,6 +492,7 @@ class TinyRadioFm extends TinyEvents {
      * @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
@@ -506,6 +531,7 @@ class TinyRadioFm extends TinyEvents {
      * @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);
         // Create the potential new state
@@ -521,6 +547,7 @@ class TinyRadioFm extends TinyEvents {
      * @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);
@@ -535,6 +562,7 @@ class TinyRadioFm extends TinyEvents {
      * @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.`);
         }
@@ -566,6 +594,7 @@ class TinyRadioFm extends TinyEvents {
      * @returns {CustomPosition[]} Shallow copy of custom positions array.
      */
     searchCustomPositions() {
+        checkDestroy(this.#destroyed);
         this.#syncRealTimeState(Date.now());
         return [...this.#customPositions];
     }
@@ -608,6 +637,7 @@ class TinyRadioFm extends TinyEvents {
      * @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);
         const processedCustom = await Promise.all(this.#customPositions.map(async (cp) => {
@@ -642,6 +672,7 @@ class TinyRadioFm extends TinyEvents {
      * @throws {TypeError} If json is not a valid string or object.
      */
     importState(json) {
+        checkDestroy(this.#destroyed);
         /** @type {TinyRadioFmImport} */
         let data;
         if (typeof json === 'string') {
@@ -1112,6 +1143,8 @@ class TinyRadioFm extends TinyEvents {
      * @param {boolean} [destroyThumbs=true]
      */
     destroy(destroyThumbs = true) {
+        if (this.#destroyed)
+            return;
         if (destroyThumbs) {
             this.#musicList.forEach((item) => revokeContentUrls(item));
             this.#voiceList.forEach((item) => revokeContentUrls(item));
@@ -1132,6 +1165,7 @@ class TinyRadioFm extends TinyEvents {
         this.#cycleCache.clear();
         this.emit('destroyed', { timestamp: Date.now() });
         this.removeAllListeners();
+        this.#destroyed = true;
     }
 }
 export default TinyRadioFm;