tiny-essentials 1.28.0 → 1.28.2

package/dist/v1/libs/TinyMediaPlayer.cjs

@@ -2,11 +2,15 @@
 
 var events = require('events');
 var mediaContent = require('../basics/mediaContent.cjs');
+var utils = require('./utils.cjs');
+
+const checkDestroy = utils.createCheckDestroyed('TinyMediaPlayer');
 
 /**
- * @typedef {import('../basics/mediaContent.mjs').MediaContent} MediaContent
+ * @typedef {import('../basics/mediaContent.mjs').PictureDataType} PictureDataType
+ * @typedef {import('../basics/mediaContent.mjs').MediaContent<PictureDataType>} MediaContent
  * @typedef {import('../basics/mediaContent.mjs').MediaContentBase} MediaContentBase
- * @typedef {import('../basics/mediaContent.mjs').MediaContentMetadata} MediaContentMetadata
+ * @typedef {import('../basics/mediaContent.mjs').MediaContentMetadata<PictureDataType>} MediaContentMetadata
  * @typedef {import('../basics/mediaContent.mjs').ParseMediaContentMetadata} ParseMediaContentMetadata
  * @typedef {import('../basics/mediaContent.mjs').LoadingMediaProgress} LoadingMediaProgress
  * @typedef {import('../basics/mediaContent.mjs').MediaLoadingErrorData} MediaLoadingErrorData
@@ -14,6 +18,7 @@ var mediaContent = require('../basics/mediaContent.cjs');
  */
 
 /**
+ * The loop configuration modes.
  * @typedef {'NONE' | 'TRACK' | 'PLAYLIST'} LoopModeType
  */
 
@@ -160,6 +165,13 @@ class TinyMediaPlayer extends events.EventEmitter {
     );
   }
 
+  /** @type {boolean} */
+  #destroyed = false;
+
+  get destroyed() {
+    return this.#destroyed;
+  }
+
   /** @type {Map<string, BaseMediaAdapter>} */
   #adapters = new Map();
 
@@ -289,6 +301,7 @@ class TinyMediaPlayer extends events.EventEmitter {
 
   /** @returns {MediaContent[]} A shallow copy of the current playlist. */
   get playlist() {
+    checkDestroy(this.#destroyed);
     return [...this.#playlist];
   }
 
@@ -297,6 +310,7 @@ class TinyMediaPlayer extends events.EventEmitter {
    * @throws {TypeError} If the value is not an array.
    */
   set playlist(value) {
+    checkDestroy(this.#destroyed);
     if (!Array.isArray(value)) {
       throw new TypeError('Playlist must be an array of MediaContent objects.');
     }
@@ -343,6 +357,7 @@ class TinyMediaPlayer extends events.EventEmitter {
 
   /** @returns {number} The current active index in the playlist. */
   get currentIndex() {
+    checkDestroy(this.#destroyed);
     return this.#currentIndex;
   }
 
@@ -352,6 +367,7 @@ class TinyMediaPlayer extends events.EventEmitter {
    * @throws {RangeError} If the index is out of the playlist bounds (unless -1 for empty).
    */
   set currentIndex(value) {
+    checkDestroy(this.#destroyed);
     if (typeof value !== 'number') {
       throw new TypeError('Current index must be a number.');
     }
@@ -390,6 +406,7 @@ class TinyMediaPlayer extends events.EventEmitter {
 
   /** @returns {LoopModeType} The current loop configuration. */
   get loopMode() {
+    checkDestroy(this.#destroyed);
     return this.#loopMode;
   }
 
@@ -398,6 +415,7 @@ class TinyMediaPlayer extends events.EventEmitter {
    * @throws {TypeError} If the value is not a valid LoopModeType.
    */
   set loopMode(value) {
+    checkDestroy(this.#destroyed);
     const validModes = ['NONE', 'TRACK', 'PLAYLIST'];
     if (!validModes.includes(value)) {
       throw new TypeError(`Loop mode must be one of: ${validModes.join(', ')}.`);
@@ -408,6 +426,7 @@ class TinyMediaPlayer extends events.EventEmitter {
 
   /** @returns {boolean} The current random mode status. */
   get isRandom() {
+    checkDestroy(this.#destroyed);
     return this.#isRandom;
   }
 
@@ -416,6 +435,7 @@ class TinyMediaPlayer extends events.EventEmitter {
    * @throws {TypeError} If the value is not a boolean.
    */
   set isRandom(value) {
+    checkDestroy(this.#destroyed);
     if (typeof value !== 'boolean') {
       throw new TypeError('Random mode state must be a boolean.');
     }
@@ -425,11 +445,13 @@ class TinyMediaPlayer extends events.EventEmitter {
 
   /** @returns {boolean} True if media is actively playing. */
   get isPlaying() {
+    checkDestroy(this.#destroyed);
     return this.#isPlaying;
   }
 
   /** @returns {number} The current volume level (0.0 to 1.0). */
   get volume() {
+    checkDestroy(this.#destroyed);
     return this.#volume;
   }
 
@@ -439,6 +461,7 @@ class TinyMediaPlayer extends events.EventEmitter {
    * @throws {RangeError} If the value is outside the 0.0 to 1.0 range.
    */
   set volume(value) {
+    checkDestroy(this.#destroyed);
     if (typeof value !== 'number') throw new TypeError('Volume must be a number.');
     if (value < 0 || value > 1)
       throw new RangeError('Volume must be tightly constrained between 0.0 and 1.0.');
@@ -460,6 +483,7 @@ class TinyMediaPlayer extends events.EventEmitter {
 
   /** @returns {boolean} Whether the volume cache is currently enabled. */
   get persistVolume() {
+    checkDestroy(this.#destroyed);
     return this.#persistVolume;
   }
 
@@ -468,6 +492,7 @@ class TinyMediaPlayer extends events.EventEmitter {
    * @throws {TypeError} If the value is not a boolean.
    */
   set persistVolume(value) {
+    checkDestroy(this.#destroyed);
     if (typeof value !== 'boolean') {
       throw new TypeError('Persist volume parameter must be a boolean.');
     }
@@ -479,6 +504,7 @@ class TinyMediaPlayer extends events.EventEmitter {
 
   /** @returns {string} The localStorage key used for volume caching. */
   get volumeStorageKey() {
+    checkDestroy(this.#destroyed);
     return this.#volumeStorageKey;
   }
 
@@ -487,6 +513,7 @@ class TinyMediaPlayer extends events.EventEmitter {
    * @throws {TypeError} If the value is not a string or is empty.
    */
   set volumeStorageKey(value) {
+    checkDestroy(this.#destroyed);
     if (typeof value !== 'string') {
       throw new TypeError('Volume storage key must be a string.');
     }
@@ -519,6 +546,7 @@ class TinyMediaPlayer extends events.EventEmitter {
    * @throws {TypeError} If id is not a string or adapter is invalid.
    */
   registerAdapter(id, adapter) {
+    checkDestroy(this.#destroyed);
     if (typeof id !== 'string') {
       throw new TypeError('Adapter ID must be a string.');
     }
@@ -556,6 +584,7 @@ class TinyMediaPlayer extends events.EventEmitter {
    * @throws {TypeError} If content is invalid or missing required base properties.
    */
   addTrack(content) {
+    checkDestroy(this.#destroyed);
     if (!content || typeof content !== 'object' || typeof content.url !== 'string')
       throw new TypeError('Track content must be a valid MediaContent object containing a URL.');
 
@@ -579,6 +608,7 @@ class TinyMediaPlayer extends events.EventEmitter {
    * @throws {TypeError} If the index is not a number.
    */
   existsTrack(index) {
+    checkDestroy(this.#destroyed);
     if (typeof index !== 'number') {
       throw new TypeError('Index must be a number.');
     }
@@ -593,6 +623,7 @@ class TinyMediaPlayer extends events.EventEmitter {
    * @throws {RangeError} If the index is out of bounds.
    */
   getTrack(index) {
+    checkDestroy(this.#destroyed);
     if (typeof index !== 'number') {
       throw new TypeError('Index must be a number.');
     }
@@ -610,6 +641,7 @@ class TinyMediaPlayer extends events.EventEmitter {
    * @throws {RangeError} If the index is out of bounds.
    */
   async removeTrack(index) {
+    checkDestroy(this.#destroyed);
     if (typeof index !== 'number') {
       throw new TypeError('Index must be a number.');
     }
@@ -643,11 +675,12 @@ class TinyMediaPlayer extends events.EventEmitter {
 
   /**
    * Searches the playlist for tracks matching a string query or a custom evaluation function.
-   * @param {string | function(MediaContent): boolean} query - The search string (checked against title, artist, album) or a callback returning a boolean.
+   * @param {string | ((content: MediaContent) => boolean)} query - The search string (checked against title, artist, album) or a callback returning a boolean.
    * @returns {SearchResult[]} An array containing the matched tracks and their corresponding indices.
    * @throws {TypeError} If the query is neither a string nor a function.
    */
   searchTrack(query) {
+    checkDestroy(this.#destroyed);
     if (typeof query !== 'string' && typeof query !== 'function') {
       throw new TypeError('Search query must be a string or a boolean evaluation function.');
     }
@@ -681,6 +714,7 @@ class TinyMediaPlayer extends events.EventEmitter {
    * Clears the entire playlist and stops playback.
    */
   async clearPlaylist() {
+    checkDestroy(this.#destroyed);
     await this.stop();
     this.#playlist = [];
     this.#currentIndex = -1;
@@ -697,6 +731,7 @@ class TinyMediaPlayer extends events.EventEmitter {
    * @returns {Promise<void>}
    */
   async play() {
+    checkDestroy(this.#destroyed);
     const adapter = this.#getActiveAdapter();
     if (!adapter) return;
 
@@ -712,6 +747,7 @@ class TinyMediaPlayer extends events.EventEmitter {
    * @returns {Promise<void>}
    */
   async pause() {
+    checkDestroy(this.#destroyed);
     const adapter = this.#getActiveAdapter();
     if (!adapter) return;
 
@@ -725,6 +761,7 @@ class TinyMediaPlayer extends events.EventEmitter {
    * @returns {Promise<void>}
    */
   async stop() {
+    checkDestroy(this.#destroyed);
     const adapter = this.#getActiveAdapter();
     if (!adapter) return;
 
@@ -738,6 +775,7 @@ class TinyMediaPlayer extends events.EventEmitter {
    * @returns {Promise<void>}
    */
   async next() {
+    checkDestroy(this.#destroyed);
     if (this.#playlist.length === 0) return;
 
     await this.stop();
@@ -772,6 +810,7 @@ class TinyMediaPlayer extends events.EventEmitter {
    * @returns {Promise<void>}
    */
   async prev() {
+    checkDestroy(this.#destroyed);
     if (this.#playlist.length === 0) return;
 
     await this.stop();
@@ -803,6 +842,7 @@ class TinyMediaPlayer extends events.EventEmitter {
    * @returns {Promise<void>}
    */
   async seek(timeMs) {
+    checkDestroy(this.#destroyed);
     if (typeof timeMs !== 'number') {
       throw new TypeError('Seek time must be a number in milliseconds.');
     }
@@ -824,6 +864,7 @@ class TinyMediaPlayer extends events.EventEmitter {
    * @returns {Promise<void>}
    */
   async step(stepMs) {
+    checkDestroy(this.#destroyed);
     if (typeof stepMs !== 'number') {
       throw new TypeError('Step amount must be a number in milliseconds.');
     }
@@ -839,6 +880,39 @@ class TinyMediaPlayer extends events.EventEmitter {
 
     await this.seek(targetTime);
   }
+
+  /**
+   * Safely destroys the TinyMediaPlayer instance.
+   * This method stops active playback, clears the internal playlist,
+   * removes all registered media adapters, and detaches all event listeners
+   * to ensure proper garbage collection and prevent memory leaks.
+   *
+   * @returns {Promise<void>} A promise that resolves when the destruction sequence is complete.
+   */
+  async destroy() {
+    if (this.#destroyed) return;
+
+    // 1. Stop current playback if active to halt media processes
+    try {
+      if (this.#isPlaying) {
+        await this.stop();
+      }
+    } catch (error) {
+      console.warn('[TinyMediaPlayer] Non-fatal error during playback termination:', error);
+    }
+
+    // 2. Clear internal state variables
+    this.#playlist = [];
+    this.#currentIndex = -1;
+    this.#isPlaying = false;
+
+    // 3. Clear all registered API adapters
+    this.#adapters.clear();
+
+    // 4. Remove all event listeners inherited from EventEmitter
+    this.removeAllListeners();
+    this.#destroyed = true;
+  }
 }
 
 module.exports = TinyMediaPlayer;

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

@@ -1,28 +1,90 @@
-export default TinyMediaPlayer;
-export type MediaContent = import("../basics/mediaContent.mjs").MediaContent;
-export type MediaContentBase = import("../basics/mediaContent.mjs").MediaContentBase;
-export type MediaContentMetadata = import("../basics/mediaContent.mjs").MediaContentMetadata;
-export type ParseMediaContentMetadata = import("../basics/mediaContent.mjs").ParseMediaContentMetadata;
-export type LoadingMediaProgress = import("../basics/mediaContent.mjs").LoadingMediaProgress;
-export type MediaLoadingErrorData = import("../basics/mediaContent.mjs").MediaLoadingErrorData;
-export type UnknownArtistGetter = import("../basics/mediaContent.mjs").UnknownArtistGetter;
-export type LoopModeType = "NONE" | "TRACK" | "PLAYLIST";
-/**
- * Configuration options for initializing the UniversalMediaPlayer.
- */
+import { EventEmitter } from 'events';
+export type PictureDataType = import('../basics/mediaContent.mjs').PictureDataType;
+export type MediaContent = import('../basics/mediaContent.mjs').MediaContent<PictureDataType>;
+export type MediaContentBase = import('../basics/mediaContent.mjs').MediaContentBase;
+export type MediaContentMetadata = import('../basics/mediaContent.mjs').MediaContentMetadata<PictureDataType>;
+export type ParseMediaContentMetadata = import('../basics/mediaContent.mjs').ParseMediaContentMetadata;
+export type LoadingMediaProgress = import('../basics/mediaContent.mjs').LoadingMediaProgress;
+export type MediaLoadingErrorData = import('../basics/mediaContent.mjs').MediaLoadingErrorData;
+export type UnknownArtistGetter = import('../basics/mediaContent.mjs').UnknownArtistGetter;
+export type LoopModeType = 'NONE' | 'TRACK' | 'PLAYLIST';
 export type TinyMediaPlayerOptions = {
     /**
      * - Whether to automatically save the volume in localStorage.
      */
-    persistVolume?: boolean | undefined;
+    persistVolume?: boolean;
     /**
      * - The specific key name used for localStorage cache.
      */
-    volumeStorageKey?: string | undefined;
+    volumeStorageKey?: string;
 };
 /**
- * Represents a search match containing the media object and its exact playlist index.
+ * @typedef {import('../basics/mediaContent.mjs').PictureDataType} PictureDataType
+ * @typedef {import('../basics/mediaContent.mjs').MediaContent<PictureDataType>} MediaContent
+ * @typedef {import('../basics/mediaContent.mjs').MediaContentBase} MediaContentBase
+ * @typedef {import('../basics/mediaContent.mjs').MediaContentMetadata<PictureDataType>} MediaContentMetadata
+ * @typedef {import('../basics/mediaContent.mjs').ParseMediaContentMetadata} ParseMediaContentMetadata
+ * @typedef {import('../basics/mediaContent.mjs').LoadingMediaProgress} LoadingMediaProgress
+ * @typedef {import('../basics/mediaContent.mjs').MediaLoadingErrorData} MediaLoadingErrorData
+ * @typedef {import('../basics/mediaContent.mjs').UnknownArtistGetter} UnknownArtistGetter
+ */
+/**
+ * The loop configuration modes.
+ * @typedef {'NONE' | 'TRACK' | 'PLAYLIST'} LoopModeType
+ */
+/**
+ * Configuration options for initializing the UniversalMediaPlayer.
+ * @typedef {Object} TinyMediaPlayerOptions
+ * @property {boolean} [persistVolume=false] - Whether to automatically save the volume in localStorage.
+ * @property {string} [volumeStorageKey='universal_media_player_volume'] - The specific key name used for localStorage cache.
+ */
+/**
+ * Interface definition for a Media Provider Adapter.
+ * All specific API wrappers must extend and implement this class.
+ * @abstract
  */
+declare class BaseMediaAdapter {
+    constructor();
+    /**
+     * Determines if this adapter can play the provided content.
+     * @param {MediaContent} content - The media content to evaluate.
+     * @returns {boolean} True if the adapter can handle the content, false otherwise.
+     */
+    canHandle(content: MediaContent): boolean;
+    /**
+     * Starts or resumes playback of the provided content.
+     * @param {MediaContent} content - The media content to play.
+     * @returns {Promise<void>}
+     */
+    play(content: MediaContent): Promise<void>;
+    /**
+     * Pauses the current playback.
+     * @returns {Promise<void>}
+     */
+    pause(): Promise<void>;
+    /**
+     * Stops the playback completely and resets the internal platform state.
+     * @returns {Promise<void>}
+     */
+    stop(): Promise<void>;
+    /**
+     * Seeks to a specific time in the media timeline.
+     * @param {number} timeMs - The target time in milliseconds.
+     * @returns {Promise<void>}
+     */
+    seek(timeMs: number): Promise<void>;
+    /**
+     * Retrieves the current playback time from the underlying API.
+     * @returns {number} The current time in milliseconds.
+     */
+    getCurrentTime(): number;
+    /**
+     * Sets the playback volume for the underlying API.
+     * @param {number} volume - The volume level from 0.0 to 1.0.
+     * @returns {void}
+     */
+    setVolume(volume: number): void;
+}
 export type SearchResult = {
     /**
      * - The matched media content.
@@ -42,24 +104,20 @@ export type SearchResult = {
 /**
  * A universal media player manager capable of orchestrating multiple API adapters.
  */
-declare class TinyMediaPlayer extends EventEmitter<any> {
+declare class TinyMediaPlayer extends EventEmitter {
+    #private;
     static BaseMediaAdapter: typeof BaseMediaAdapter;
     /**
-     * @type {UnknownArtistGetter}
-     * The default identifier or function used when an artist cannot be determined.
+     * Gets the current value used to represent unknown artists.
+     * @returns {UnknownArtistGetter}
      */
-    static #unknownArtist: UnknownArtistGetter;
+    static get unknownArtist(): UnknownArtistGetter;
     /**
      * Sets the value used to represent unknown artists.
      * @param {UnknownArtistGetter} value - A string or a function that returns a string.
      * @throws {TypeError} If the value is neither a string nor a function.
      */
     static set unknownArtist(value: UnknownArtistGetter);
-    /**
-     * Gets the current value used to represent unknown artists.
-     * @returns {UnknownArtistGetter}
-     */
-    static get unknownArtist(): UnknownArtistGetter;
     /**
      * A Static Factory Method that prepares a MediaContent object by
      * extracting metadata from an audio source.
@@ -81,9 +139,10 @@ declare class TinyMediaPlayer extends EventEmitter<any> {
         id?: string;
         weight?: number;
     }, parseFile?: ParseMediaContentMetadata, callbacks?: {
-        onProgress?: ((progress: LoadingMediaProgress) => void) | undefined;
-        onError?: ((error: MediaLoadingErrorData) => void) | undefined;
+        onProgress?: (progress: LoadingMediaProgress) => void;
+        onError?: (error: MediaLoadingErrorData) => void;
     }): Promise<MediaContent>;
+    get destroyed(): boolean;
     /**
      * @param {TinyMediaPlayerOptions} [options={}] - Configuration parameters for the player.
      */
@@ -95,59 +154,59 @@ declare class TinyMediaPlayer extends EventEmitter<any> {
      * @private
      */
     private _getWeightedRandomIndex;
+    /** @returns {MediaContent[]} A shallow copy of the current playlist. */
+    get playlist(): MediaContent[];
     /**
      * @param {MediaContent[]} value - The new playlist array.
      * @throws {TypeError} If the value is not an array.
      */
     set playlist(value: MediaContent[]);
-    /** @returns {MediaContent[]} A shallow copy of the current playlist. */
-    get playlist(): MediaContent[];
+    /** @returns {number} The current active index in the playlist. */
+    get currentIndex(): number;
     /**
      * @param {number} value - The index to set as current.
      * @throws {TypeError} If the value is not a number.
      * @throws {RangeError} If the index is out of the playlist bounds (unless -1 for empty).
      */
     set currentIndex(value: number);
-    /** @returns {number} The current active index in the playlist. */
-    get currentIndex(): number;
+    /** @returns {LoopModeType} The current loop configuration. */
+    get loopMode(): LoopModeType;
     /**
      * @param {LoopModeType} value - The desired loop mode.
      * @throws {TypeError} If the value is not a valid LoopModeType.
      */
     set loopMode(value: LoopModeType);
-    /** @returns {LoopModeType} The current loop configuration. */
-    get loopMode(): LoopModeType;
+    /** @returns {boolean} The current random mode status. */
+    get isRandom(): boolean;
     /**
      * @param {boolean} value - True to enable random playback, false otherwise.
      * @throws {TypeError} If the value is not a boolean.
      */
     set isRandom(value: boolean);
-    /** @returns {boolean} The current random mode status. */
-    get isRandom(): boolean;
     /** @returns {boolean} True if media is actively playing. */
     get isPlaying(): boolean;
+    /** @returns {number} The current volume level (0.0 to 1.0). */
+    get volume(): number;
     /**
      * @param {number} value - The volume level to set.
      * @throws {TypeError} If the value is not a number.
      * @throws {RangeError} If the value is outside the 0.0 to 1.0 range.
      */
     set volume(value: number);
-    /** @returns {number} The current volume level (0.0 to 1.0). */
-    get volume(): number;
+    /** @returns {boolean} Whether the volume cache is currently enabled. */
+    get persistVolume(): boolean;
     /**
      * @param {boolean} value - True to save volume dynamically to localStorage.
      * @throws {TypeError} If the value is not a boolean.
      */
     set persistVolume(value: boolean);
-    /** @returns {boolean} Whether the volume cache is currently enabled. */
-    get persistVolume(): boolean;
+    /** @returns {string} The localStorage key used for volume caching. */
+    get volumeStorageKey(): string;
     /**
      * @param {string} value - The custom storage key string.
      * @throws {TypeError} If the value is not a string or is empty.
      */
     set volumeStorageKey(value: string);
-    /** @returns {string} The localStorage key used for volume caching. */
-    get volumeStorageKey(): string;
     /**
      * Registers a new media API adapter.
      * @param {string} id - Unique identifier for the platform (e.g., 'youtube', 'spotify').
@@ -187,11 +246,11 @@ declare class TinyMediaPlayer extends EventEmitter<any> {
     removeTrack(index: number): Promise<void>;
     /**
      * Searches the playlist for tracks matching a string query or a custom evaluation function.
-     * @param {string | function(MediaContent): boolean} query - The search string (checked against title, artist, album) or a callback returning a boolean.
+     * @param {string | ((content: MediaContent) => boolean)} query - The search string (checked against title, artist, album) or a callback returning a boolean.
      * @returns {SearchResult[]} An array containing the matched tracks and their corresponding indices.
      * @throws {TypeError} If the query is neither a string nor a function.
      */
-    searchTrack(query: string | ((arg0: MediaContent) => boolean)): SearchResult[];
+    searchTrack(query: string | ((content: MediaContent) => boolean)): SearchResult[];
     /**
      * Clears the entire playlist and stops playback.
      */
@@ -236,71 +295,15 @@ declare class TinyMediaPlayer extends EventEmitter<any> {
      * @returns {Promise<void>}
      */
     step(stepMs: number): Promise<void>;
-    #private;
-}
-import { EventEmitter } from 'events';
-/**
- * @typedef {import('../basics/mediaContent.mjs').MediaContent} MediaContent
- * @typedef {import('../basics/mediaContent.mjs').MediaContentBase} MediaContentBase
- * @typedef {import('../basics/mediaContent.mjs').MediaContentMetadata} MediaContentMetadata
- * @typedef {import('../basics/mediaContent.mjs').ParseMediaContentMetadata} ParseMediaContentMetadata
- * @typedef {import('../basics/mediaContent.mjs').LoadingMediaProgress} LoadingMediaProgress
- * @typedef {import('../basics/mediaContent.mjs').MediaLoadingErrorData} MediaLoadingErrorData
- * @typedef {import('../basics/mediaContent.mjs').UnknownArtistGetter} UnknownArtistGetter
- */
-/**
- * @typedef {'NONE' | 'TRACK' | 'PLAYLIST'} LoopModeType
- */
-/**
- * Configuration options for initializing the UniversalMediaPlayer.
- * @typedef {Object} TinyMediaPlayerOptions
- * @property {boolean} [persistVolume=false] - Whether to automatically save the volume in localStorage.
- * @property {string} [volumeStorageKey='universal_media_player_volume'] - The specific key name used for localStorage cache.
- */
-/**
- * Interface definition for a Media Provider Adapter.
- * All specific API wrappers must extend and implement this class.
- * @abstract
- */
-declare class BaseMediaAdapter {
     /**
-     * Determines if this adapter can play the provided content.
-     * @param {MediaContent} content - The media content to evaluate.
-     * @returns {boolean} True if the adapter can handle the content, false otherwise.
-     */
-    canHandle(content: MediaContent): boolean;
-    /**
-     * Starts or resumes playback of the provided content.
-     * @param {MediaContent} content - The media content to play.
-     * @returns {Promise<void>}
-     */
-    play(content: MediaContent): Promise<void>;
-    /**
-     * Pauses the current playback.
-     * @returns {Promise<void>}
-     */
-    pause(): Promise<void>;
-    /**
-     * Stops the playback completely and resets the internal platform state.
-     * @returns {Promise<void>}
-     */
-    stop(): Promise<void>;
-    /**
-     * Seeks to a specific time in the media timeline.
-     * @param {number} timeMs - The target time in milliseconds.
-     * @returns {Promise<void>}
-     */
-    seek(timeMs: number): Promise<void>;
-    /**
-     * Retrieves the current playback time from the underlying API.
-     * @returns {number} The current time in milliseconds.
-     */
-    getCurrentTime(): number;
-    /**
-     * Sets the playback volume for the underlying API.
-     * @param {number} volume - The volume level from 0.0 to 1.0.
-     * @returns {void}
+     * Safely destroys the TinyMediaPlayer instance.
+     * This method stops active playback, clears the internal playlist,
+     * removes all registered media adapters, and detaches all event listeners
+     * to ensure proper garbage collection and prevent memory leaks.
+     *
+     * @returns {Promise<void>} A promise that resolves when the destruction sequence is complete.
      */
-    setVolume(volume: number): void;
+    destroy(): Promise<void>;
 }
+export default TinyMediaPlayer;
 //# sourceMappingURL=TinyMediaPlayer.d.mts.map