tiny-essentials 1.28.7 → 1.28.9

package/dist/v1/libs/TinyMediaPlayer.cjs

@@ -1,6 +1,6 @@
 'use strict';
 
-var events = require('events');
+var TinyDebugger = require('./TinyDebugger.cjs');
 var mediaContent = require('../basics/mediaContent.cjs');
 var utils = require('./utils.cjs');
 var index = require('./TinyMediaPlayer/index.cjs');
@@ -34,6 +34,9 @@ const checkDestroy = utils.createCheckDestroyed('TinyMediaPlayer');
  * @property {boolean} [repeatCurrentOnPrev=false] - If true, clicking 'previous' repeats the current track on the first click.
  * @property {boolean} [smoothPlayPauseVolume=false] - If true, volume fades smoothly during play/pause transitions.
  * @property {boolean} [smoothStopVolume=false] - If true, volume fades smoothly to zero when stopping.
+ * @property {boolean} [debugMode=false] - Whether to enable internal debug logging.
+ * @property {boolean} [useLogColors=false] - Whether to enable log color support.
+ * @property {Console} [logger=console] - A custom logger object (must implement console methods).
  */
 
 /**
@@ -46,7 +49,7 @@ const checkDestroy = utils.createCheckDestroyed('TinyMediaPlayer');
 /**
  * A universal media player manager capable of orchestrating multiple API adapters.
  */
-class TinyMediaPlayer extends events.EventEmitter {
+class TinyMediaPlayer extends TinyDebugger {
   static BaseMediaAdapter = index.BaseMediaAdapter;
 
   /**
@@ -266,11 +269,18 @@ class TinyMediaPlayer extends events.EventEmitter {
    * @throws {RangeError} If numeric options are out of valid ranges.
    */
   constructor(options = {}) {
-    super();
     if (!objChecker.isValidObj(options)) {
       throw new TypeError('Options must be a non-null object.');
     }
 
+    // Debug Configuration
+    super({
+      id: '[_blue_TinyMediaPlayer_reset_] :debug:',
+      logger: options.logger ?? console,
+      debugMode: options.debugMode ?? false,
+      useLogColors: options.useLogColors ?? false,
+    });
+
     // Volume configuration
     if (options.persistVolume !== undefined) {
       if (typeof options.persistVolume !== 'boolean') {
@@ -318,6 +328,8 @@ class TinyMediaPlayer extends events.EventEmitter {
     }
 
     if (this.#persistVolume) this.#loadVolumeFromStorage();
+
+    this.log('info', 'Instance initialized.', { options });
   }
 
   // ==========================================
@@ -335,6 +347,7 @@ class TinyMediaPlayer extends events.EventEmitter {
           const parsedVolume = parseFloat(storedValue);
           if (!isNaN(parsedVolume) && parsedVolume >= 0 && parsedVolume <= 1) {
             this.#volume = parsedVolume;
+            this.log('info', `Volume loaded from storage: ${this.#volume}`);
           }
         }
       }
@@ -350,6 +363,7 @@ class TinyMediaPlayer extends events.EventEmitter {
     try {
       if (this.#persistVolume && typeof window !== 'undefined' && window.localStorage) {
         window.localStorage.setItem(this.#volumeStorageKey, this.#volume.toString());
+        this.log('info', `Volume saved to storage: ${this.#volume}`);
       }
     } catch (error) {
       console.warn('[TinyMediaPlayer] Failed to save volume to localStorage.', error);
@@ -421,10 +435,15 @@ class TinyMediaPlayer extends events.EventEmitter {
     const startTime = performance.now();
     const duration = this.#fadeVolumeSpeed;
 
+    this.log('info', `Starting volume fade: ${startVolume} -> ${targetVolume}`);
+
     return new Promise((resolve) => {
       /** @param {number} currentTime */
       const step = (currentTime) => {
-        if (signal.aborted) return resolve();
+        if (signal.aborted) {
+          this.log('info', 'Volume fade aborted.');
+          return resolve();
+        }
 
         const elapsed = currentTime - startTime;
         const progress = Math.min(elapsed / duration, 1);
@@ -436,6 +455,7 @@ class TinyMediaPlayer extends events.EventEmitter {
           requestAnimationFrame(step);
         } else {
           adapter.setVolume(targetVolume);
+          this.log('info', `Volume fade completed: ${targetVolume}`);
           resolve();
         }
       };
@@ -477,6 +497,7 @@ class TinyMediaPlayer extends events.EventEmitter {
     }
 
     this.#playlist = value;
+    this.log('info', `Playlist updated. New size: ${this.#playlist.length}`);
     this.emit('playlistUpdate', this.playlist);
 
     // Validation to correct currentIndex ensuring it aligns with the new playlist limits
@@ -497,6 +518,7 @@ class TinyMediaPlayer extends events.EventEmitter {
           if (oldAdapter) await oldAdapter.stop();
           if (this.#currentIndex !== -1) await this.play();
         } catch (error) {
+          this.log('error', 'Background transition error on playlist update:', error);
           console.warn('[TinyMediaPlayer] Background transition error on playlist update:', error);
         }
       })();
@@ -525,6 +547,8 @@ class TinyMediaPlayer extends events.EventEmitter {
 
     if (this.#currentIndex === value) return; // Optimization: do nothing if index is the same
 
+    this.log('info', `Index change requested: ${this.#currentIndex} -> ${value}`);
+
     const wasPlaying = this.#isPlaying;
     let oldAdapter = null;
 
@@ -546,6 +570,7 @@ class TinyMediaPlayer extends events.EventEmitter {
           if (oldAdapter) await oldAdapter.stop();
           if (this.#currentIndex !== -1) await this.play();
         } catch (error) {
+          this.log('error', 'Background transition error on index update:', error);
           console.warn('[TinyMediaPlayer] Background transition error on index update:', error);
         }
       })();
@@ -569,6 +594,7 @@ class TinyMediaPlayer extends events.EventEmitter {
       throw new TypeError(`Loop mode must be one of: ${validModes.join(', ')}.`);
     }
     this.#loopMode = value;
+    this.log('info', `Loop mode changed to: ${this.#loopMode}`);
     this.emit('loopModeChange', this.#loopMode);
   }
 
@@ -588,6 +614,7 @@ class TinyMediaPlayer extends events.EventEmitter {
       throw new TypeError('Random mode state must be a boolean.');
     }
     this.#isRandom = value;
+    this.log('info', `Random mode: ${this.#isRandom}`);
     this.emit('randomModeChange', this.#isRandom);
   }
 
@@ -617,6 +644,7 @@ class TinyMediaPlayer extends events.EventEmitter {
     // Abort any ongoing fade to ensure manual control is immediate
     if (this.#fadeController) this.#fadeController.abort();
 
+    this.log('info', `Volume changed: ${this.#volume} -> ${value}`);
     this.#volume = value;
     this.#saveVolumeToStorage();
     this.emit('volumeChange', this.#volume);
@@ -648,6 +676,7 @@ class TinyMediaPlayer extends events.EventEmitter {
       throw new TypeError('Persist volume parameter must be a boolean.');
     }
     this.#persistVolume = value;
+    this.log('info', `Persist volume: ${this.#persistVolume}`);
     if (value) {
       this.#saveVolumeToStorage();
     }
@@ -693,30 +722,31 @@ class TinyMediaPlayer extends events.EventEmitter {
   }
 
   /**
-   * Sets the mute state of the player.
-   * This state is synchronized with the active adapter and respected when playing new tracks.
-   * @param {boolean} value - True to mute, false to unMute.
-   * @throws {TypeError} If the value is not a boolean.
+   * Mutes the current playback.
+   * @returns {Promise<void>}
    */
-  set isMuted(value) {
+  async mute() {
     checkDestroy(this.#destroyed);
-    if (typeof value !== 'boolean') {
-      throw new TypeError('isMuted must be a boolean.');
-    }
-
-    this.#isMuted = value;
-
-    // Synchronize with the active adapter immediately
-    try {
-      const adapter = this.#getActiveAdapter();
-      if (adapter) {
-        value ? adapter.mute() : adapter.unMute();
-      }
-    } catch (error) {
-      // If no active adapter, we just wait for the next play() call to apply the state
-    }
+    const adapter = this.#getActiveAdapter();
+    if (!adapter) return;
+    await adapter.mute();
+    this.#isMuted = true;
+    this.emit('muteChange', this.#isMuted);
+    this.log('info', 'Playback muted successfully.');
+  }
 
+  /**
+   * Unmutes the current playback.
+   * @returns {Promise<void>}
+   */
+  async unMute() {
+    checkDestroy(this.#destroyed);
+    const adapter = this.#getActiveAdapter();
+    if (!adapter) return;
+    await adapter.unMute();
+    this.#isMuted = false;
     this.emit('muteChange', this.#isMuted);
+    this.log('info', 'Playback unmuted successfully.');
   }
 
   // ==========================================
@@ -773,6 +803,8 @@ class TinyMediaPlayer extends events.EventEmitter {
       throw new TypeError('Adapter must be an instance of BaseMediaAdapter.');
     }
 
+    this.log('info', 'Registering new adapter:', adapter);
+
     const events = new Map();
     this.#adapterHandlers.set(adapter, events);
 
@@ -795,6 +827,7 @@ class TinyMediaPlayer extends events.EventEmitter {
     if (!(adapter instanceof index.BaseMediaAdapter)) {
       throw new TypeError('Adapter must be an instance of BaseMediaAdapter.');
     }
+    this.log('info', 'Removing adapter:', adapter);
     this.#removeHandler(adapter);
     return this.#adapters.delete(adapter);
   }
@@ -809,6 +842,7 @@ class TinyMediaPlayer extends events.EventEmitter {
     if (!(adapter instanceof index.BaseMediaAdapter)) {
       throw new TypeError('Adapter must be an instance of BaseMediaAdapter.');
     }
+    this.log('info', 'Destroying adapter:', adapter);
     this.#removeHandler(adapter);
     const result = this.#adapters.delete(adapter);
     if (result) adapter.destroy();
@@ -833,6 +867,7 @@ class TinyMediaPlayer extends events.EventEmitter {
    */
   destroyAllAdapters() {
     checkDestroy(this.#destroyed);
+    this.log('info', 'Destroying all adapters.');
     this.#adapters.forEach((adapter) => {
       this.#removeHandler(adapter);
       adapter.destroy();
@@ -845,6 +880,7 @@ class TinyMediaPlayer extends events.EventEmitter {
    */
   clearAdapters() {
     checkDestroy(this.#destroyed);
+    this.log('info', 'Clearing all adapters.');
     this.#adapters.forEach((adapter) => this.#removeHandler(adapter));
     this.#adapters.clear();
   }
@@ -877,7 +913,9 @@ class TinyMediaPlayer extends events.EventEmitter {
     const currentContent = this.#playlist[this.#currentIndex];
     const adapter = this.getMediaAdapter(currentContent);
     if (adapter) return adapter;
-    throw new Error(`No compatible adapter found for content ID: ${currentContent.id}.`);
+    const errorMsg = `No compatible adapter found for content ID: ${currentContent.id}.`;
+    this.log('error', errorMsg);
+    throw new Error(errorMsg);
   }
 
   // ==========================================
@@ -898,6 +936,7 @@ class TinyMediaPlayer extends events.EventEmitter {
     // If the event is already in the list, do nothing to avoid duplicates
     if (this.#adapterEventNames.has(eventName)) return;
 
+    this.log('info', `Adding adapter event listener: ${eventName}`);
     this.#adapterEventNames.add(eventName);
 
     // Synchronize: Add the listener to all already registered adapters
@@ -919,6 +958,7 @@ class TinyMediaPlayer extends events.EventEmitter {
 
     if (!this.#adapterEventNames.has(eventName)) return;
 
+    this.log('info', `Removing adapter event listener: ${eventName}`);
     this.#adapterEventNames.delete(eventName);
 
     // Synchronize: Remove the listener from all registered adapters
@@ -966,6 +1006,8 @@ class TinyMediaPlayer extends events.EventEmitter {
     /** @type {(...args: any[]) => any} */
     const handler = (...args) => {
       if (!this.#destroyed) {
+        if (eventName !== 'timeupdate')
+          this.log('debug', `Adapter event triggered: ${eventName}`, ...args);
         this.emit(eventName, ...args);
       }
     };
@@ -1011,6 +1053,8 @@ class TinyMediaPlayer extends events.EventEmitter {
     mediaContent.valMediaContentMetadata(newContent);
 
     const newLength = this.#playlist.push(newContent);
+    this.log('info', `Track added. New length: ${newLength}`, newContent);
+
     if (this.#currentIndex === -1) {
       this.#currentIndex = 0;
       this.emit('trackChange', this.#currentIndex);
@@ -1067,6 +1111,8 @@ class TinyMediaPlayer extends events.EventEmitter {
       throw new RangeError(`Index ${index} is out of bounds for the current playlist.`);
     }
 
+    this.log('info', `Removing track at index: ${index}`);
+
     if (index === this.#currentIndex) {
       // Stop the current track if it is the one being removed
       await this.stop();
@@ -1103,6 +1149,8 @@ class TinyMediaPlayer extends events.EventEmitter {
       throw new TypeError('Search query must be a string or a boolean evaluation function.');
     }
 
+    this.log('info', 'Searching playlist...', { query });
+
     const results = [];
 
     for (let i = 0; i < this.#playlist.length; i++) {
@@ -1125,6 +1173,7 @@ class TinyMediaPlayer extends events.EventEmitter {
       }
     }
 
+    this.log('info', `Search completed. Found ${results.length} results.`);
     return results;
   }
 
@@ -1133,6 +1182,7 @@ class TinyMediaPlayer extends events.EventEmitter {
    */
   async clearPlaylist() {
     checkDestroy(this.#destroyed);
+    this.log('info', 'Clearing entire playlist.');
     await this.stop();
     this.#playlist = [];
     this.#currentIndex = -1;
@@ -1150,6 +1200,7 @@ class TinyMediaPlayer extends events.EventEmitter {
    */
   async play() {
     checkDestroy(this.#destroyed);
+    this.log('info', `Attempting to play track at index: ${this.#currentIndex}`);
     const adapter = this.#getActiveAdapter();
     if (!adapter) return;
 
@@ -1160,10 +1211,16 @@ class TinyMediaPlayer extends events.EventEmitter {
       adapter.setVolume(this.#volume);
     }
 
-    await adapter.play(this.#playlist[this.#currentIndex]);
-    if (this.#isMuted) await adapter.mute();
-    this.#isPlaying = true;
-    this.emit('play', this.#currentIndex);
+    try {
+      await adapter.play(this.#playlist[this.#currentIndex]);
+      if (this.#isMuted) await adapter.mute();
+      this.#isPlaying = true;
+      this.log('info', 'Playback started successfully.');
+      this.emit('play', this.#currentIndex);
+    } catch (error) {
+      this.log('error', 'Failed to play track:', error);
+      throw error;
+    }
   }
 
   /**
@@ -1172,6 +1229,7 @@ class TinyMediaPlayer extends events.EventEmitter {
    */
   async pause() {
     checkDestroy(this.#destroyed);
+    this.log('info', 'Attempting to pause playback.');
     const adapter = this.#getActiveAdapter();
     if (!adapter) return;
 
@@ -1181,6 +1239,7 @@ class TinyMediaPlayer extends events.EventEmitter {
 
     await adapter.pause();
     this.#isPlaying = false;
+    this.log('info', 'Playback paused.');
     this.emit('pause', this.#currentIndex);
   }
 
@@ -1190,6 +1249,7 @@ class TinyMediaPlayer extends events.EventEmitter {
    */
   async stop() {
     checkDestroy(this.#destroyed);
+    this.log('info', 'Attempting to stop playback.');
     const adapter = this.#getActiveAdapter();
     if (!adapter) return;
 
@@ -1199,6 +1259,7 @@ class TinyMediaPlayer extends events.EventEmitter {
 
     await adapter.stop();
     this.#isPlaying = false;
+    this.log('info', 'Playback stopped.');
     this.emit('stop', this.#currentIndex);
   }
 
@@ -1210,9 +1271,11 @@ class TinyMediaPlayer extends events.EventEmitter {
     checkDestroy(this.#destroyed);
     if (this.#playlist.length === 0) return;
 
+    this.log('info', 'Next track requested.');
     await this.stop();
 
     if (this.#loopMode === 'TRACK') {
+      this.log('info', 'Loop mode: TRACK. Repeating current track.');
       // Index remains the same
       await this.play();
       return;
@@ -1220,13 +1283,15 @@ class TinyMediaPlayer extends events.EventEmitter {
 
     if (this.#isRandom) {
       this.#currentIndex = this._getWeightedRandomIndex();
+      this.log('info', `Random mode: Selected index ${this.#currentIndex}`);
     } else {
       let nextIndex = this.#currentIndex + 1;
       if (nextIndex >= this.#playlist.length) {
         if (this.#loopMode === 'PLAYLIST') {
           nextIndex = 0;
+          this.log('info', 'Loop mode: PLAYLIST. Returning to start.');
         } else {
-          // End of playlist, stop playing
+          this.log('info', 'End of playlist reached. Stopping.');
           return;
         }
       }
@@ -1247,6 +1312,7 @@ class TinyMediaPlayer extends events.EventEmitter {
 
     // UX: Repeat current track if "repeat on prev" is enabled and it's the first click
     if (this.#repeatCurrentOnPrev && !this.#prevClickedToRepeat) {
+      this.log('info', 'UX: Repeat current track on first "prev" click.');
       this.#prevClickedToRepeat = true;
 
       // Reset the "repeat" state after 2 seconds of inactivity to prevent glitches
@@ -1268,17 +1334,20 @@ class TinyMediaPlayer extends events.EventEmitter {
     }
     this.#prevClickedToRepeat = false;
 
+    this.log('info', 'Previous track requested.');
     await this.stop();
 
     if (this.#isRandom) {
       this.#currentIndex = this._getWeightedRandomIndex();
+      this.log('info', `Random mode: Selected index ${this.#currentIndex}`);
     } else {
       let prevIndex = this.#currentIndex - 1;
       if (prevIndex < 0) {
         if (this.#loopMode === 'PLAYLIST') {
           prevIndex = this.#playlist.length - 1;
+          this.log('info', 'Loop mode: PLAYLIST. Returning to end.');
         } else {
-          // End of playlist, stop playing
+          this.log('info', 'Start of playlist reached. Stopping.');
           return;
         }
       }
@@ -1289,6 +1358,29 @@ class TinyMediaPlayer extends events.EventEmitter {
     await this.play();
   }
 
+  /**
+   * Jumps directly to a specific index in the playlist.
+   * @param {number} index - The target index to skip to.
+   * @returns {Promise<void>}
+   * @throws {TypeError} If the index is not a number.
+   * @throws {RangeError} If the index is out of the playlist bounds.
+   */
+  async skipTo(index) {
+    checkDestroy(this.#destroyed);
+    if (typeof index !== 'number') {
+      throw new TypeError('Index must be a number.');
+    }
+    if (!this.existsTrack(index)) {
+      throw new RangeError(`Index ${index} is out of bounds for the current playlist.`);
+    }
+
+    this.log('info', `Skipping to index: ${index}`);
+    await this.stop();
+    this.#currentIndex = index;
+    this.emit('trackChange', this.#currentIndex);
+    await this.play();
+  }
+
   /**
    * Jumps to a specific absolute time in the timeline.
    * @param {number} timeMs - The target time in milliseconds.
@@ -1305,6 +1397,7 @@ class TinyMediaPlayer extends events.EventEmitter {
       throw new RangeError('Seek time cannot be negative.');
     }
 
+    this.log('info', `Seeking to: ${timeMs}ms`);
     const adapter = this.#getActiveAdapter();
     if (adapter) {
       await adapter.seek(timeMs);
@@ -1324,6 +1417,7 @@ class TinyMediaPlayer extends events.EventEmitter {
       throw new TypeError('Step amount must be a number in milliseconds.');
     }
 
+    this.log('info', `Stepping by: ${stepMs}ms`);
     const adapter = this.#getActiveAdapter();
     if (!adapter) return;
 
@@ -1396,6 +1490,34 @@ class TinyMediaPlayer extends events.EventEmitter {
     }
   }
 
+  /**
+   * Checks whether the media adapter is paused.
+   * @returns {boolean} True if the adapter is ready, false otherwise.
+   */
+  get isPaused() {
+    checkDestroy(this.#destroyed);
+    try {
+      const adapter = this.#getActiveAdapter();
+      return adapter ? adapter.isPaused() : false;
+    } catch {
+      return false;
+    }
+  }
+
+  /**
+   * Checks whether the media adapter is ended.
+   * @returns {boolean} True if the adapter is ready, false otherwise.
+   */
+  get isEnded() {
+    checkDestroy(this.#destroyed);
+    try {
+      const adapter = this.#getActiveAdapter();
+      return adapter ? adapter.isEnded() : true;
+    } catch {
+      return true;
+    }
+  }
+
   /**
    * Retrieves the metadata of the currently loaded content, returning a structured
    * object containing details such as the content ID, title, author, and duration.
@@ -1448,12 +1570,15 @@ class TinyMediaPlayer extends events.EventEmitter {
   async destroy() {
     if (this.#destroyed) return;
 
+    this.log('info', 'Destroying TinyMediaPlayer instance.');
+
     // 1. Stop current playback if active to halt media processes
     try {
       if (this.#isPlaying) {
         await this.stop();
       }
     } catch (error) {
+      this.log('error', 'Non-fatal error during playback termination:', error);
       console.warn('[TinyMediaPlayer] Non-fatal error during playback termination:', error);
     }
 

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

@@ -1,4 +1,4 @@
-import { EventEmitter } from 'events';
+import TinyDebugger from './TinyDebugger.mjs';
 import { BaseMediaAdapter } from './TinyMediaPlayer/index.mjs';
 export type PictureDataType = import('../basics/mediaContent.mjs').PictureDataType;
 export type MediaContent = import('../basics/mediaContent.mjs').MediaContent<PictureDataType>;
@@ -32,6 +32,18 @@ export type TinyMediaPlayerOptions = {
      * - If true, volume fades smoothly to zero when stopping.
      */
     smoothStopVolume?: boolean;
+    /**
+     * - Whether to enable internal debug logging.
+     */
+    debugMode?: boolean;
+    /**
+     * - Whether to enable log color support.
+     */
+    useLogColors?: boolean;
+    /**
+     * - A custom logger object (must implement console methods).
+     */
+    logger?: Console;
 };
 export type SearchResult = {
     /**
@@ -67,6 +79,9 @@ export type SearchResult = {
  * @property {boolean} [repeatCurrentOnPrev=false] - If true, clicking 'previous' repeats the current track on the first click.
  * @property {boolean} [smoothPlayPauseVolume=false] - If true, volume fades smoothly during play/pause transitions.
  * @property {boolean} [smoothStopVolume=false] - If true, volume fades smoothly to zero when stopping.
+ * @property {boolean} [debugMode=false] - Whether to enable internal debug logging.
+ * @property {boolean} [useLogColors=false] - Whether to enable log color support.
+ * @property {Console} [logger=console] - A custom logger object (must implement console methods).
  */
 /**
  * Represents a search match containing the media object and its exact playlist index.
@@ -77,7 +92,7 @@ export type SearchResult = {
 /**
  * A universal media player manager capable of orchestrating multiple API adapters.
  */
-declare class TinyMediaPlayer extends EventEmitter {
+declare class TinyMediaPlayer extends TinyDebugger {
     #private;
     static BaseMediaAdapter: typeof BaseMediaAdapter;
     /**
@@ -223,12 +238,15 @@ declare class TinyMediaPlayer extends EventEmitter {
     /** @returns {boolean} True if the player is currently muted. */
     get isMuted(): boolean;
     /**
-     * Sets the mute state of the player.
-     * This state is synchronized with the active adapter and respected when playing new tracks.
-     * @param {boolean} value - True to mute, false to unMute.
-     * @throws {TypeError} If the value is not a boolean.
+     * Mutes the current playback.
+     * @returns {Promise<void>}
+     */
+    mute(): Promise<void>;
+    /**
+     * Unmutes the current playback.
+     * @returns {Promise<void>}
      */
-    set isMuted(value: boolean);
+    unMute(): Promise<void>;
     get adapters(): BaseMediaAdapter[];
     get adaptersSize(): number;
     static get defaultAdapterEventNames(): string[];
@@ -356,6 +374,14 @@ declare class TinyMediaPlayer extends EventEmitter {
      * @returns {Promise<void>}
      */
     prev(): Promise<void>;
+    /**
+     * Jumps directly to a specific index in the playlist.
+     * @param {number} index - The target index to skip to.
+     * @returns {Promise<void>}
+     * @throws {TypeError} If the index is not a number.
+     * @throws {RangeError} If the index is out of the playlist bounds.
+     */
+    skipTo(index: number): Promise<void>;
     /**
      * Jumps to a specific absolute time in the timeline.
      * @param {number} timeMs - The target time in milliseconds.
@@ -391,6 +417,16 @@ declare class TinyMediaPlayer extends EventEmitter {
      * @returns {number} A value between 0 and 100.
      */
     getPlaybackPercentage(): number;
+    /**
+     * Checks whether the media adapter is paused.
+     * @returns {boolean} True if the adapter is ready, false otherwise.
+     */
+    get isPaused(): boolean;
+    /**
+     * Checks whether the media adapter is ended.
+     * @returns {boolean} True if the adapter is ready, false otherwise.
+     */
+    get isEnded(): boolean;
     /**
      * Retrieves the metadata of the currently loaded content, returning a structured
      * object containing details such as the content ID, title, author, and duration.