tiny-essentials 1.28.5 → 1.28.6

package/dist/v1/css/TinyLoadingScreen.min.css

@@ -1 +1 @@
-.loading-overlay{position:absolute;top:0;left:0;width:100%;height:100%;background:rgba(0,0,0,.6);display:absolute;justify-content:center;align-items:center;z-index:9999}.loading-overlay .loading-container{height:100%;width:100%;display:flex;align-items:center}.loading-overlay .loading-content{text-align:center;color:#fff;font-family:Arial,sans-serif;margin:auto}.loading-overlay .loading-spinner{position:relative;border:4px solid hsla(0,0%,100%,.3);border-top:4px solid #fff;border-radius:50%;width:50px;height:50px;margin:0 auto 15px;animation:loading-spin 1s linear infinite}.loading-overlay .loading-spinner::after{content:"";position:absolute;top:50%;left:50%;width:20px;height:20px;transform:translate(-50%, -50%);border-radius:50%;background:rgba(0,0,0,0);pointer-events:none}.loading-overlay .loading-message{font-size:1.2em;user-select:none !important}@keyframes loading-spin{0%{transform:rotate(0deg)}100%{transform:rotate(360deg)}}
+.loading-overlay{position:absolute;top:0;left:0;width:100%;height:100%;background:rgba(0,0,0,.6);display:absolute;justify-content:center;align-items:center;z-index:9999}.loading-overlay .loading-container{height:100%;width:100%;display:flex;align-items:center}.loading-overlay .loading-content{text-align:center;color:#fff;font-family:Arial,sans-serif;margin:auto}.loading-overlay .loading-spinner{position:relative;border:4px solid rgba(255,255,255,.3);border-top:4px solid #fff;border-radius:50%;width:50px;height:50px;margin:0 auto 15px;animation:loading-spin 1s linear infinite}.loading-overlay .loading-spinner::after{content:"";position:absolute;top:50%;left:50%;width:20px;height:20px;transform:translate(-50%, -50%);border-radius:50%;background:rgba(0,0,0,0);pointer-events:none}.loading-overlay .loading-message{font-size:1.2em;user-select:none !important}@keyframes loading-spin{0%{transform:rotate(0deg)}100%{transform:rotate(360deg)}}

package/dist/v1/libs/TinyMediaPlayer/HtmlAudio.cjs

@@ -8,6 +8,7 @@ var index = require('./index.cjs');
  * @typedef {import('../../basics/mediaContent.mjs').PictureDataType} PictureDataType
  * @typedef {import('../../basics/mediaContent.mjs').MediaContent<PictureDataType>} MediaContent
  * @typedef {import('./index.mjs').ContentTimeData} ContentTimeData
+ * @typedef {import('./index.mjs').ContentData} ContentData
  */
 
 
@@ -71,6 +72,27 @@ class HtmlAudioAdapter extends index.BaseMediaAdapter {
     this.#audioElement.addEventListener('error', (error) => {
       this.emit('error', error);
     });
+    this.#audioElement.addEventListener('seeked', () => {
+      this.emit('seek', this.getCurrentTime());
+    });
+  }
+
+  /**
+   * Synchronously checks whether the media adapter is fully initialized and ready.
+   * @returns {boolean} True if the adapter is ready, false otherwise.
+   */
+  isReady() {
+    checkDestroy(this.#destroyed);
+    return true;
+  }
+
+  /**
+   * Asynchronously waits until the content media adapter is fully initialized and ready.
+   * @returns {Promise<void>} A promise that resolves once the adapter is ready.
+   */
+  async waitIsReady() {
+    checkDestroy(this.#destroyed);
+    return;
   }
 
   /**
@@ -91,8 +113,7 @@ class HtmlAudioAdapter extends index.BaseMediaAdapter {
    * @returns {boolean} True if the content is compatible, false otherwise.
    * @throws {TypeError} If content is not a valid object.
    */
-  canHandle(content) {
-    checkDestroy(this.#destroyed);
+  static canHandle(content) {
     if (!objChecker.isValidObj(content)) {
       throw new TypeError('Content must be a valid object.');
     }
@@ -103,6 +124,17 @@ class HtmlAudioAdapter extends index.BaseMediaAdapter {
     );
   }
 
+  /**
+   * Determines if the provided content is compatible with this adapter.
+   * @param {MediaContent} content - The media content object.
+   * @returns {boolean} True if the content is compatible, false otherwise.
+   * @throws {TypeError} If content is not a valid object.
+   */
+  canHandle(content) {
+    checkDestroy(this.#destroyed);
+    return HtmlAudioAdapter.canHandle(content);
+  }
+
   /**
    * Plays the audio content provided via the URL.
    * @param {MediaContent} content - The media content object containing the URL.
@@ -158,7 +190,6 @@ class HtmlAudioAdapter extends index.BaseMediaAdapter {
     }
     const currentTime = timeMs / 1000;
     this.#audioElement.currentTime = currentTime;
-    this.emit('seek', currentTime);
   }
 
   /**
@@ -242,6 +273,25 @@ class HtmlAudioAdapter extends index.BaseMediaAdapter {
     this.emit('volumeChange', value);
   }
 
+  /**
+   * Retrieves the metadata of the currently loaded content, returning a structured
+   * object containing details such as the content ID, title, author, and duration.
+   * @returns {Promise<ContentData>}
+   */
+  async getContentData() {
+    return {
+      id: '',
+      createdAt: '',
+      artistId: '',
+      artistName: '',
+      description: '',
+      title: '',
+      duration: 0,
+      avatar: '',
+      url: '',
+    };
+  }
+
   /**
    * Cleans up the adapter resources and marks it as destroyed.
    * @returns {Promise<void>}

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

@@ -2,10 +2,12 @@
  * @typedef {import('../../basics/mediaContent.mjs').PictureDataType} PictureDataType
  * @typedef {import('../../basics/mediaContent.mjs').MediaContent<PictureDataType>} MediaContent
  * @typedef {import('./index.mjs').ContentTimeData} ContentTimeData
+ * @typedef {import('./index.mjs').ContentData} ContentData
  */
 export type PictureDataType = import('../../basics/mediaContent.mjs').PictureDataType;
 export type MediaContent = import('../../basics/mediaContent.mjs').MediaContent<PictureDataType>;
 export type ContentTimeData = import('./index.mjs').ContentTimeData;
+export type ContentData = import('./index.mjs').ContentData;
 import { BaseMediaAdapter } from './index.mjs';
 /**
  * Concrete implementation of the BaseMediaAdapter using HTML5 Audio.
@@ -30,11 +32,28 @@ declare class HtmlAudioAdapter extends BaseMediaAdapter {
      * Initializes a new instance of the HtmlAudioAdapter.
      */
     constructor();
+    /**
+     * Synchronously checks whether the media adapter is fully initialized and ready.
+     * @returns {boolean} True if the adapter is ready, false otherwise.
+     */
+    isReady(): boolean;
+    /**
+     * Asynchronously waits until the content media adapter is fully initialized and ready.
+     * @returns {Promise<void>} A promise that resolves once the adapter is ready.
+     */
+    waitIsReady(): Promise<void>;
     /**
      * Retrieves a consolidated object containing all time-related metrics for the current media content.
      * @returns {ContentTimeData} An object containing total, current, remaining time, and playback percentage.
      */
     getTimeData(): ContentTimeData;
+    /**
+     * Determines if the provided content is compatible with this adapter.
+     * @param {MediaContent} content - The media content object.
+     * @returns {boolean} True if the content is compatible, false otherwise.
+     * @throws {TypeError} If content is not a valid object.
+     */
+    static canHandle(content: MediaContent): boolean;
     /**
      * Determines if the provided content is compatible with this adapter.
      * @param {MediaContent} content - The media content object.
@@ -108,6 +127,12 @@ declare class HtmlAudioAdapter extends BaseMediaAdapter {
      * @throws {RangeError} If the volume is not between 0.0 and 1.0.
      */
     set volume(value: number);
+    /**
+     * Retrieves the metadata of the currently loaded content, returning a structured
+     * object containing details such as the content ID, title, author, and duration.
+     * @returns {Promise<ContentData>}
+     */
+    getContentData(): Promise<ContentData>;
     /**
      * Cleans up the adapter resources and marks it as destroyed.
      * @returns {Promise<void>}

package/dist/v1/libs/TinyMediaPlayer/HtmlAudio.mjs

@@ -2,6 +2,7 @@
  * @typedef {import('../../basics/mediaContent.mjs').PictureDataType} PictureDataType
  * @typedef {import('../../basics/mediaContent.mjs').MediaContent<PictureDataType>} MediaContent
  * @typedef {import('./index.mjs').ContentTimeData} ContentTimeData
+ * @typedef {import('./index.mjs').ContentData} ContentData
  */
 import { isValidObj } from '../../basics/objChecker.mjs';
 import { createCheckDestroyed } from '../utils.mjs';
@@ -57,6 +58,25 @@ class HtmlAudioAdapter extends BaseMediaAdapter {
         this.#audioElement.addEventListener('error', (error) => {
             this.emit('error', error);
         });
+        this.#audioElement.addEventListener('seeked', () => {
+            this.emit('seek', this.getCurrentTime());
+        });
+    }
+    /**
+     * Synchronously checks whether the media adapter is fully initialized and ready.
+     * @returns {boolean} True if the adapter is ready, false otherwise.
+     */
+    isReady() {
+        checkDestroy(this.#destroyed);
+        return true;
+    }
+    /**
+     * Asynchronously waits until the content media adapter is fully initialized and ready.
+     * @returns {Promise<void>} A promise that resolves once the adapter is ready.
+     */
+    async waitIsReady() {
+        checkDestroy(this.#destroyed);
+        return;
     }
     /**
      * Retrieves a consolidated object containing all time-related metrics for the current media content.
@@ -75,8 +95,7 @@ class HtmlAudioAdapter extends BaseMediaAdapter {
      * @returns {boolean} True if the content is compatible, false otherwise.
      * @throws {TypeError} If content is not a valid object.
      */
-    canHandle(content) {
-        checkDestroy(this.#destroyed);
+    static canHandle(content) {
         if (!isValidObj(content)) {
             throw new TypeError('Content must be a valid object.');
         }
@@ -84,6 +103,16 @@ class HtmlAudioAdapter extends BaseMediaAdapter {
             (content.url.startsWith('http') || content.url.startsWith('blob:')) &&
             (content.mediaType === undefined || content.mediaType === 'audio'));
     }
+    /**
+     * Determines if the provided content is compatible with this adapter.
+     * @param {MediaContent} content - The media content object.
+     * @returns {boolean} True if the content is compatible, false otherwise.
+     * @throws {TypeError} If content is not a valid object.
+     */
+    canHandle(content) {
+        checkDestroy(this.#destroyed);
+        return HtmlAudioAdapter.canHandle(content);
+    }
     /**
      * Plays the audio content provided via the URL.
      * @param {MediaContent} content - The media content object containing the URL.
@@ -135,7 +164,6 @@ class HtmlAudioAdapter extends BaseMediaAdapter {
         }
         const currentTime = timeMs / 1000;
         this.#audioElement.currentTime = currentTime;
-        this.emit('seek', currentTime);
     }
     /**
      * Gets the current playback time.
@@ -210,6 +238,24 @@ class HtmlAudioAdapter extends BaseMediaAdapter {
         this.#audioElement.volume = value;
         this.emit('volumeChange', value);
     }
+    /**
+     * Retrieves the metadata of the currently loaded content, returning a structured
+     * object containing details such as the content ID, title, author, and duration.
+     * @returns {Promise<ContentData>}
+     */
+    async getContentData() {
+        return {
+            id: '',
+            createdAt: '',
+            artistId: '',
+            artistName: '',
+            description: '',
+            title: '',
+            duration: 0,
+            avatar: '',
+            url: '',
+        };
+    }
     /**
      * Cleans up the adapter resources and marks it as destroyed.
      * @returns {Promise<void>}

package/dist/v1/libs/TinyMediaPlayer/HtmlVideo.cjs

@@ -8,6 +8,7 @@ var index = require('./index.cjs');
  * @typedef {import('../../basics/mediaContent.mjs').PictureDataType} PictureDataType
  * @typedef {import('../../basics/mediaContent.mjs').MediaContent<PictureDataType>} MediaContent
  * @typedef {import('./index.mjs').ContentTimeData} ContentTimeData
+ * @typedef {import('./index.mjs').ContentData} ContentData
  */
 
 
@@ -68,6 +69,27 @@ class HtmlVideoAdapter extends index.BaseMediaAdapter {
     this.#videoElement.addEventListener('error', (error) => {
       this.emit('error', error);
     });
+    this.#videoElement.addEventListener('seeked', () => {
+      this.emit('seek', this.getCurrentTime());
+    });
+  }
+
+  /**
+   * Synchronously checks whether the media adapter is fully initialized and ready.
+   * @returns {boolean} True if the adapter is ready, false otherwise.
+   */
+  isReady() {
+    checkDestroy(this.#destroyed);
+    return true;
+  }
+
+  /**
+   * Asynchronously waits until the content media adapter is fully initialized and ready.
+   * @returns {Promise<void>} A promise that resolves once the adapter is ready.
+   */
+  async waitIsReady() {
+    checkDestroy(this.#destroyed);
+    return;
   }
 
   /**
@@ -88,8 +110,7 @@ class HtmlVideoAdapter extends index.BaseMediaAdapter {
    * @returns {boolean} True if the content is compatible, false otherwise.
    * @throws {TypeError} If content is not a valid object.
    */
-  canHandle(content) {
-    checkDestroy(this.#destroyed);
+  static canHandle(content) {
     if (!objChecker.isValidObj(content)) {
       throw new TypeError('Content must be a valid object.');
     }
@@ -100,6 +121,17 @@ class HtmlVideoAdapter extends index.BaseMediaAdapter {
     );
   }
 
+  /**
+   * Determines if the provided content is compatible with this adapter.
+   * @param {MediaContent} content - The media content object.
+   * @returns {boolean} True if the content is compatible, false otherwise.
+   * @throws {TypeError} If content is not a valid object.
+   */
+  canHandle(content) {
+    checkDestroy(this.#destroyed);
+    return HtmlVideoAdapter.canHandle(content);
+  }
+
   /**
    * Plays the video content provided via the URL.
    * @param {MediaContent} content - The media content object containing the URL.
@@ -155,7 +187,6 @@ class HtmlVideoAdapter extends index.BaseMediaAdapter {
     }
     const currentTime = timeMs / 1000;
     this.#videoElement.currentTime = currentTime;
-    this.emit('seek', currentTime);
   }
 
   /**
@@ -239,6 +270,25 @@ class HtmlVideoAdapter extends index.BaseMediaAdapter {
     this.emit('volumeChange', value);
   }
 
+  /**
+   * Retrieves the metadata of the currently loaded content, returning a structured
+   * object containing details such as the content ID, title, author, and duration.
+   * @returns {Promise<ContentData>}
+   */
+  async getContentData() {
+    return {
+      id: '',
+      createdAt: '',
+      artistId: '',
+      artistName: '',
+      description: '',
+      title: '',
+      duration: 0,
+      avatar: '',
+      url: '',
+    };
+  }
+
   /**
    * Cleans up the adapter resources and marks it as destroyed.
    * @returns {Promise<void>}

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

@@ -2,10 +2,12 @@
  * @typedef {import('../../basics/mediaContent.mjs').PictureDataType} PictureDataType
  * @typedef {import('../../basics/mediaContent.mjs').MediaContent<PictureDataType>} MediaContent
  * @typedef {import('./index.mjs').ContentTimeData} ContentTimeData
+ * @typedef {import('./index.mjs').ContentData} ContentData
  */
 export type PictureDataType = import('../../basics/mediaContent.mjs').PictureDataType;
 export type MediaContent = import('../../basics/mediaContent.mjs').MediaContent<PictureDataType>;
 export type ContentTimeData = import('./index.mjs').ContentTimeData;
+export type ContentData = import('./index.mjs').ContentData;
 import { BaseMediaAdapter } from './index.mjs';
 /**
  * Concrete implementation of the BaseMediaAdapter using HTML5 Video.
@@ -30,11 +32,28 @@ declare class HtmlVideoAdapter extends BaseMediaAdapter {
      * Initializes a new instance of the HtmlVideoAdapter.
      */
     constructor();
+    /**
+     * Synchronously checks whether the media adapter is fully initialized and ready.
+     * @returns {boolean} True if the adapter is ready, false otherwise.
+     */
+    isReady(): boolean;
+    /**
+     * Asynchronously waits until the content media adapter is fully initialized and ready.
+     * @returns {Promise<void>} A promise that resolves once the adapter is ready.
+     */
+    waitIsReady(): Promise<void>;
     /**
      * Retrieves a consolidated object containing all time-related metrics for the current media content.
      * @returns {ContentTimeData} An object containing total, current, remaining time, and playback percentage.
      */
     getTimeData(): ContentTimeData;
+    /**
+     * Determines if the provided content is compatible with this adapter.
+     * @param {MediaContent} content - The media content object.
+     * @returns {boolean} True if the content is compatible, false otherwise.
+     * @throws {TypeError} If content is not a valid object.
+     */
+    static canHandle(content: MediaContent): boolean;
     /**
      * Determines if the provided content is compatible with this adapter.
      * @param {MediaContent} content - The media content object.
@@ -108,6 +127,12 @@ declare class HtmlVideoAdapter extends BaseMediaAdapter {
      * @throws {RangeError} If the volume is not between 0.0 and 1.0.
      */
     set volume(value: number);
+    /**
+     * Retrieves the metadata of the currently loaded content, returning a structured
+     * object containing details such as the content ID, title, author, and duration.
+     * @returns {Promise<ContentData>}
+     */
+    getContentData(): Promise<ContentData>;
     /**
      * Cleans up the adapter resources and marks it as destroyed.
      * @returns {Promise<void>}

package/dist/v1/libs/TinyMediaPlayer/HtmlVideo.mjs

@@ -2,6 +2,7 @@
  * @typedef {import('../../basics/mediaContent.mjs').PictureDataType} PictureDataType
  * @typedef {import('../../basics/mediaContent.mjs').MediaContent<PictureDataType>} MediaContent
  * @typedef {import('./index.mjs').ContentTimeData} ContentTimeData
+ * @typedef {import('./index.mjs').ContentData} ContentData
  */
 import { isValidObj } from '../../basics/objChecker.mjs';
 import { createCheckDestroyed } from '../utils.mjs';
@@ -54,6 +55,25 @@ class HtmlVideoAdapter extends BaseMediaAdapter {
         this.#videoElement.addEventListener('error', (error) => {
             this.emit('error', error);
         });
+        this.#videoElement.addEventListener('seeked', () => {
+            this.emit('seek', this.getCurrentTime());
+        });
+    }
+    /**
+     * Synchronously checks whether the media adapter is fully initialized and ready.
+     * @returns {boolean} True if the adapter is ready, false otherwise.
+     */
+    isReady() {
+        checkDestroy(this.#destroyed);
+        return true;
+    }
+    /**
+     * Asynchronously waits until the content media adapter is fully initialized and ready.
+     * @returns {Promise<void>} A promise that resolves once the adapter is ready.
+     */
+    async waitIsReady() {
+        checkDestroy(this.#destroyed);
+        return;
     }
     /**
      * Retrieves a consolidated object containing all time-related metrics for the current media content.
@@ -72,8 +92,7 @@ class HtmlVideoAdapter extends BaseMediaAdapter {
      * @returns {boolean} True if the content is compatible, false otherwise.
      * @throws {TypeError} If content is not a valid object.
      */
-    canHandle(content) {
-        checkDestroy(this.#destroyed);
+    static canHandle(content) {
         if (!isValidObj(content)) {
             throw new TypeError('Content must be a valid object.');
         }
@@ -81,6 +100,16 @@ class HtmlVideoAdapter extends BaseMediaAdapter {
             (content.url.startsWith('http') || content.url.startsWith('blob:')) &&
             (content.mediaType === undefined || content.mediaType === 'video'));
     }
+    /**
+     * Determines if the provided content is compatible with this adapter.
+     * @param {MediaContent} content - The media content object.
+     * @returns {boolean} True if the content is compatible, false otherwise.
+     * @throws {TypeError} If content is not a valid object.
+     */
+    canHandle(content) {
+        checkDestroy(this.#destroyed);
+        return HtmlVideoAdapter.canHandle(content);
+    }
     /**
      * Plays the video content provided via the URL.
      * @param {MediaContent} content - The media content object containing the URL.
@@ -132,7 +161,6 @@ class HtmlVideoAdapter extends BaseMediaAdapter {
         }
         const currentTime = timeMs / 1000;
         this.#videoElement.currentTime = currentTime;
-        this.emit('seek', currentTime);
     }
     /**
      * Gets the current playback time.
@@ -207,6 +235,24 @@ class HtmlVideoAdapter extends BaseMediaAdapter {
         this.#videoElement.volume = value;
         this.emit('volumeChange', value);
     }
+    /**
+     * Retrieves the metadata of the currently loaded content, returning a structured
+     * object containing details such as the content ID, title, author, and duration.
+     * @returns {Promise<ContentData>}
+     */
+    async getContentData() {
+        return {
+            id: '',
+            createdAt: '',
+            artistId: '',
+            artistName: '',
+            description: '',
+            title: '',
+            duration: 0,
+            avatar: '',
+            url: '',
+        };
+    }
     /**
      * Cleans up the adapter resources and marks it as destroyed.
      * @returns {Promise<void>}