tiny-essentials 1.28.10 → 1.28.11

package/dist/v1/libs/TinyMediaPlayer.mjs

@@ -76,11 +76,12 @@ class TinyMediaPlayer extends TinyDebugger {
      * @param {Object} [callbacks={}] - Callbacks for monitoring the loading process.
      * @param {(progress: LoadingMediaProgress) => void} [callbacks.onProgress] - Callback triggered on stage changes.
      * @param {(error: MediaLoadingErrorData) => void} [callbacks.onError] - Callback triggered when a non-fatal or fatal error occurs.
+     * @param {boolean} [convertBase64toBlob=true] - If the image content needs to be converted directly into a high-performance Blob URL, use this method.
      * @returns {Promise<MediaContent>} A promise that resolves to a valid MediaContent object.
      * @throws {MediaLoadingError} If the preparation process fails at any stage.
      */
-    static async parseContent(source, defaultMetadata, metadata, parseFile, callbacks) {
-        return parseMediaMetadata(source, defaultMetadata, metadata, parseFile, callbacks, TinyMediaPlayer.#unknownArtist);
+    static async parseContent(source, defaultMetadata, metadata, parseFile, callbacks, convertBase64toBlob) {
+        return parseMediaMetadata(source, defaultMetadata, metadata, parseFile, callbacks, convertBase64toBlob, TinyMediaPlayer.#unknownArtist);
     }
     /** @type {boolean} */
     #destroyed = false;
@@ -1073,8 +1074,10 @@ class TinyMediaPlayer extends TinyDebugger {
         checkDestroy(this.#destroyed);
         this.log('info', `Attempting to play track at index: ${this.#currentIndex}`);
         const adapter = this.#getActiveAdapter();
-        if (!adapter)
+        if (!adapter) {
+            this.log('error', 'Failed to play track:', `Active adapter not found for track at index ${this.#currentIndex}.`);
             return;
+        }
         // Ensure the adapter aligns with the global volume before playing
         if (this.#smoothPlayPauseVolume) {
             await this.#fadeAdapterVolume(this.#volume);

package/dist/v1/libs/TinyRadioFm.cjs

@@ -150,16 +150,25 @@ class TinyRadioFm extends events.EventEmitter {
    * @param {Object} [callbacks={}] - Callbacks for monitoring the loading process.
    * @param {(progress: LoadingMediaProgress) => void} [callbacks.onProgress] - Callback triggered on stage changes.
    * @param {(error: MediaLoadingErrorData) => void} [callbacks.onError] - Callback triggered when a non-fatal or fatal error occurs.
+   * @param {boolean} [convertBase64toBlob=true] - If the image content needs to be converted directly into a high-performance Blob URL, use this method.
    * @returns {Promise<MediaContent>} A promise that resolves to a valid MediaContent object.
    * @throws {MediaLoadingError} If the preparation process fails at any stage.
    */
-  static async parseContent(source, defaultMetadata, metadata, parseFile, callbacks) {
+  static async parseContent(
+    source,
+    defaultMetadata,
+    metadata,
+    parseFile,
+    callbacks,
+    convertBase64toBlob,
+  ) {
     return mediaContent.parseMediaMetadata(
       source,
       defaultMetadata,
       metadata,
       parseFile,
       callbacks,
+      convertBase64toBlob,
       TinyRadioFm.#unknownArtist,
     );
   }

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

@@ -341,6 +341,7 @@ declare class TinyRadioFm extends EventEmitter {
      * @param {Object} [callbacks={}] - Callbacks for monitoring the loading process.
      * @param {(progress: LoadingMediaProgress) => void} [callbacks.onProgress] - Callback triggered on stage changes.
      * @param {(error: MediaLoadingErrorData) => void} [callbacks.onError] - Callback triggered when a non-fatal or fatal error occurs.
+     * @param {boolean} [convertBase64toBlob=true] - If the image content needs to be converted directly into a high-performance Blob URL, use this method.
      * @returns {Promise<MediaContent>} A promise that resolves to a valid MediaContent object.
      * @throws {MediaLoadingError} If the preparation process fails at any stage.
      */
@@ -353,7 +354,7 @@ declare class TinyRadioFm extends EventEmitter {
     }, parseFile?: ParseMediaContentMetadata, callbacks?: {
         onProgress?: (progress: LoadingMediaProgress) => void;
         onError?: (error: MediaLoadingErrorData) => void;
-    }): Promise<MediaContent>;
+    }, convertBase64toBlob?: boolean): Promise<MediaContent>;
     /**
      * Gets the current value used to represent unknown artists.
      * @returns {UnknownArtistGetter}

package/dist/v1/libs/TinyRadioFm.mjs

@@ -128,11 +128,12 @@ class TinyRadioFm extends EventEmitter {
      * @param {Object} [callbacks={}] - Callbacks for monitoring the loading process.
      * @param {(progress: LoadingMediaProgress) => void} [callbacks.onProgress] - Callback triggered on stage changes.
      * @param {(error: MediaLoadingErrorData) => void} [callbacks.onError] - Callback triggered when a non-fatal or fatal error occurs.
+     * @param {boolean} [convertBase64toBlob=true] - If the image content needs to be converted directly into a high-performance Blob URL, use this method.
      * @returns {Promise<MediaContent>} A promise that resolves to a valid MediaContent object.
      * @throws {MediaLoadingError} If the preparation process fails at any stage.
      */
-    static async parseContent(source, defaultMetadata, metadata, parseFile, callbacks) {
-        return parseMediaMetadata(source, defaultMetadata, metadata, parseFile, callbacks, TinyRadioFm.#unknownArtist);
+    static async parseContent(source, defaultMetadata, metadata, parseFile, callbacks, convertBase64toBlob) {
+        return parseMediaMetadata(source, defaultMetadata, metadata, parseFile, callbacks, convertBase64toBlob, TinyRadioFm.#unknownArtist);
     }
     /**
      * @type {UnknownArtistGetter}

package/docs/v1/basics/mediaContent.md

@@ -77,6 +77,7 @@ Downloads an audio file and uses a provided parser to extract its internal metad
 *   **Parameters:**
     *   `url` (string): The full URL of the audio file.
     *   `parseFile` (Function): A callback that accepts a `Blob` and returns a promise with metadata.
+    *   `convertBase64toBlob` (boolean): If true, the image content will be converted directly into a high-performance Blob URL, use this method.
 *   **Returns:** `Promise<MediaContentMetadata>`
 *   **Throws:** `TypeError` for invalid arguments or `Error` for network/parsing failures.
 
@@ -94,6 +95,7 @@ Downloads an audio file and uses a provided parser to extract its internal metad
 | `metadata` | `Partial<MediaContent>` | Manual overrides for the metadata (highest priority). |
 | `parseFile` | `ParseMediaContentMetadata` | The library function used to parse the file. |
 | `callbacks` | `Object` | Contains `onProgress` and `onError` listeners. |
+| `convertBase64toBlob` | `boolean` | If true, the image content will be converted directly into a high-performance Blob URL, use this method.
 | `unknownArtist` | `UnknownArtistGetter` | Logic to determine the artist if none is found. |
 
 #### 💡 Usage Examples

package/docs/v1/libs/TinyMediaPlayer.md

@@ -181,7 +181,7 @@ When initializing `new TinyMediaPlayer(options)`, you can pass the following `Ti
     * **Getter/Setter**: Allows customization of the default event subscription list.
 
 #### Methods
-* **`parseContent(source, defaultMetadata, metadata, parseFile, callbacks)`**: 
+* **`parseContent(source, defaultMetadata, metadata, parseFile, callbacks, convertBase64toBlob)`**: 
     * A static factory method to prepare a `MediaContent` object by extracting metadata from a URL or HTMLMediaElement.
     * **Parameters**:
         * `source`: `string | HTMLMediaElement`
@@ -189,6 +189,7 @@ When initializing `new TinyMediaPlayer(options)`, you can pass the following `Ti
         * `metadata`: `Partial<MediaContentBase & MediaContentMetadata>`
         * `parseFile`: `ParseMediaContentMetadata`
         * `callbacks`: `Object` (containing `onProgress` and `onError`)
+        * `convertBase64toBlob`: `boolean`
     * **Returns**: `Promise<MediaContent>`.
 
 ---

package/docs/v1/libs/TinyRadioFm.md

@@ -42,7 +42,7 @@ The behavior of the engine is controlled via the `RadioConfig` object.
 
 ### 🏗️ Static Methods
 
-#### `static parseContent(source, defaultMetadata, metadata, parseFile, callbacks)`
+#### `static parseContent(source, defaultMetadata, metadata, parseFile, callbacks, convertBase64toBlob)`
 Prepares a `MediaContent` object by extracting metadata from an audio source.
 * **Parameters:**
     * `source`: A URL string or an existing `HTMLMediaElement`.
@@ -50,6 +50,7 @@ Prepares a `MediaContent` object by extracting metadata from an audio source.
     * `metadata`: Optional manual overrides.
     * `parseFile`: Internal helper for file parsing.
     * `callbacks`: Object containing `onProgress` and `onError` handlers.
+    * `convertBase64toBlob`: If true, the image content will be converted directly into a high-performance Blob URL, use this method.
 * **Returns:** `Promise<MediaContent>`
 * **Throws:** `MediaLoadingError`
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "tiny-essentials",
-  "version": "1.28.10",
+  "version": "1.28.11",
   "description": "Collection of small, essential scripts designed to be used across various projects. These simple utilities are crafted for speed, ease of use, and versatility.",
   "bin": {
     "tiny-essentials-fork": "./TinyFork.mjs"