@kenzuya/mediabunny 1.26.0 → 1.28.5

package/dist/modules/src/metadata.js

@@ -1,193 +0,0 @@
-/*!
- * Copyright (c) 2025-present, Vanilagy and contributors
- *
- * This Source Code Form is subject to the terms of the Mozilla Public
- * License, v. 2.0. If a copy of the MPL was not distributed with this
- * file, You can obtain one at https://mozilla.org/MPL/2.0/.
- */
-/**
- * Image data with additional metadata.
- *
- * @group Metadata tags
- * @public
- */
-export class RichImageData {
-    /** Creates a new {@link RichImageData}. */
-    constructor(
-    /** The raw image data. */
-    data, 
-    /** An RFC 6838 MIME type (e.g. image/jpeg, image/png, etc.) */
-    mimeType) {
-        this.data = data;
-        this.mimeType = mimeType;
-        if (!(data instanceof Uint8Array)) {
-            throw new TypeError('data must be a Uint8Array.');
-        }
-        if (typeof mimeType !== 'string') {
-            throw new TypeError('mimeType must be a string.');
-        }
-    }
-}
-/**
- * A file attached to a media file.
- *
- * @group Metadata tags
- * @public
- */
-export class AttachedFile {
-    /** Creates a new {@link AttachedFile}. */
-    constructor(
-    /** The raw file data. */
-    data, 
-    /** An RFC 6838 MIME type (e.g. image/jpeg, image/png, font/ttf, etc.) */
-    mimeType, 
-    /** The name of the file. */
-    name, 
-    /** A description of the file. */
-    description) {
-        this.data = data;
-        this.mimeType = mimeType;
-        this.name = name;
-        this.description = description;
-        if (!(data instanceof Uint8Array)) {
-            throw new TypeError('data must be a Uint8Array.');
-        }
-        if (mimeType !== undefined && typeof mimeType !== 'string') {
-            throw new TypeError('mimeType, when provided, must be a string.');
-        }
-        if (name !== undefined && typeof name !== 'string') {
-            throw new TypeError('name, when provided, must be a string.');
-        }
-        if (description !== undefined && typeof description !== 'string') {
-            throw new TypeError('description, when provided, must be a string.');
-        }
-    }
-}
-;
-export const validateMetadataTags = (tags) => {
-    if (!tags || typeof tags !== 'object') {
-        throw new TypeError('tags must be an object.');
-    }
-    if (tags.title !== undefined && typeof tags.title !== 'string') {
-        throw new TypeError('tags.title, when provided, must be a string.');
-    }
-    if (tags.description !== undefined && typeof tags.description !== 'string') {
-        throw new TypeError('tags.description, when provided, must be a string.');
-    }
-    if (tags.artist !== undefined && typeof tags.artist !== 'string') {
-        throw new TypeError('tags.artist, when provided, must be a string.');
-    }
-    if (tags.album !== undefined && typeof tags.album !== 'string') {
-        throw new TypeError('tags.album, when provided, must be a string.');
-    }
-    if (tags.albumArtist !== undefined && typeof tags.albumArtist !== 'string') {
-        throw new TypeError('tags.albumArtist, when provided, must be a string.');
-    }
-    if (tags.trackNumber !== undefined && (!Number.isInteger(tags.trackNumber) || tags.trackNumber <= 0)) {
-        throw new TypeError('tags.trackNumber, when provided, must be a positive integer.');
-    }
-    if (tags.tracksTotal !== undefined
-        && (!Number.isInteger(tags.tracksTotal) || tags.tracksTotal <= 0)) {
-        throw new TypeError('tags.tracksTotal, when provided, must be a positive integer.');
-    }
-    if (tags.discNumber !== undefined && (!Number.isInteger(tags.discNumber) || tags.discNumber <= 0)) {
-        throw new TypeError('tags.discNumber, when provided, must be a positive integer.');
-    }
-    if (tags.discsTotal !== undefined
-        && (!Number.isInteger(tags.discsTotal) || tags.discsTotal <= 0)) {
-        throw new TypeError('tags.discsTotal, when provided, must be a positive integer.');
-    }
-    if (tags.genre !== undefined && typeof tags.genre !== 'string') {
-        throw new TypeError('tags.genre, when provided, must be a string.');
-    }
-    if (tags.date !== undefined && (!(tags.date instanceof Date) || Number.isNaN(tags.date.getTime()))) {
-        throw new TypeError('tags.date, when provided, must be a valid Date.');
-    }
-    if (tags.lyrics !== undefined && typeof tags.lyrics !== 'string') {
-        throw new TypeError('tags.lyrics, when provided, must be a string.');
-    }
-    if (tags.images !== undefined) {
-        if (!Array.isArray(tags.images)) {
-            throw new TypeError('tags.images, when provided, must be an array.');
-        }
-        for (const image of tags.images) {
-            if (!image || typeof image !== 'object') {
-                throw new TypeError('Each image in tags.images must be an object.');
-            }
-            if (!(image.data instanceof Uint8Array)) {
-                throw new TypeError('Each image.data must be a Uint8Array.');
-            }
-            if (typeof image.mimeType !== 'string') {
-                throw new TypeError('Each image.mimeType must be a string.');
-            }
-            if (!['coverFront', 'coverBack', 'unknown'].includes(image.kind)) {
-                throw new TypeError('Each image.kind must be \'coverFront\', \'coverBack\', or \'unknown\'.');
-            }
-        }
-    }
-    if (tags.comment !== undefined && typeof tags.comment !== 'string') {
-        throw new TypeError('tags.comment, when provided, must be a string.');
-    }
-    if (tags.raw !== undefined) {
-        if (!tags.raw || typeof tags.raw !== 'object') {
-            throw new TypeError('tags.raw, when provided, must be an object.');
-        }
-        for (const value of Object.values(tags.raw)) {
-            if (value !== null
-                && typeof value !== 'string'
-                && !(value instanceof Uint8Array)
-                && !(value instanceof RichImageData)
-                && !(value instanceof AttachedFile)) {
-                throw new TypeError('Each value in tags.raw must be a string, Uint8Array, RichImageData, AttachedFile, or null.');
-            }
-        }
-    }
-};
-export const metadataTagsAreEmpty = (tags) => {
-    return tags.title === undefined
-        && tags.description === undefined
-        && tags.artist === undefined
-        && tags.album === undefined
-        && tags.albumArtist === undefined
-        && tags.trackNumber === undefined
-        && tags.tracksTotal === undefined
-        && tags.discNumber === undefined
-        && tags.discsTotal === undefined
-        && tags.genre === undefined
-        && tags.date === undefined
-        && tags.lyrics === undefined
-        && (!tags.images || tags.images.length === 0)
-        && tags.comment === undefined
-        && (tags.raw === undefined || Object.keys(tags.raw).length === 0);
-};
-export const DEFAULT_TRACK_DISPOSITION = {
-    default: true,
-    forced: false,
-    original: false,
-    commentary: false,
-    hearingImpaired: false,
-    visuallyImpaired: false,
-};
-export const validateTrackDisposition = (disposition) => {
-    if (!disposition || typeof disposition !== 'object') {
-        throw new TypeError('disposition must be an object.');
-    }
-    if (disposition.default !== undefined && typeof disposition.default !== 'boolean') {
-        throw new TypeError('disposition.default must be a boolean.');
-    }
-    if (disposition.forced !== undefined && typeof disposition.forced !== 'boolean') {
-        throw new TypeError('disposition.forced must be a boolean.');
-    }
-    if (disposition.original !== undefined && typeof disposition.original !== 'boolean') {
-        throw new TypeError('disposition.original must be a boolean.');
-    }
-    if (disposition.commentary !== undefined && typeof disposition.commentary !== 'boolean') {
-        throw new TypeError('disposition.commentary must be a boolean.');
-    }
-    if (disposition.hearingImpaired !== undefined && typeof disposition.hearingImpaired !== 'boolean') {
-        throw new TypeError('disposition.hearingImpaired must be a boolean.');
-    }
-    if (disposition.visuallyImpaired !== undefined && typeof disposition.visuallyImpaired !== 'boolean') {
-        throw new TypeError('disposition.visuallyImpaired must be a boolean.');
-    }
-};