@ziplayer/plugin 0.1.40 → 0.1.50

package/dist/AttachmentsPlugin.js

@@ -0,0 +1,481 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AttachmentsPlugin = void 0;
+const ziplayer_1 = require("ziplayer");
+const axios_1 = __importDefault(require("axios"));
+const music_metadata_1 = require("music-metadata");
+/**
+ * A plugin for handling Discord attachment URLs and local audio files.
+ *
+ * This plugin provides support for:
+ * - Discord attachment URLs (cdn.discordapp.com, media.discordapp.net)
+ * - Direct audio file URLs
+ * - Local file paths (if accessible)
+ * - Various audio formats (mp3, wav, ogg, m4a, flac, etc.)
+ * - File size validation
+ * - Audio metadata analysis (duration, title, artist, album, etc.)
+ * - Stream extraction from URLs
+ *
+ * @example
+ * const attachmentsPlugin = new AttachmentsPlugin({
+ *   maxFileSize: 25 * 1024 * 1024, // 25MB
+ *   allowedExtensions: ['mp3', 'wav', 'ogg', 'm4a', 'flac']
+ * });
+ *
+ * // Add to PlayerManager
+ * const manager = new PlayerManager({
+ *   plugins: [attachmentsPlugin]
+ * });
+ *
+ * // Search for attachment content
+ * const result = await attachmentsPlugin.search(
+ *   "https://cdn.discordapp.com/attachments/123/456/audio.mp3",
+ *   "user123"
+ * );
+ * const stream = await attachmentsPlugin.getStream(result.tracks[0]);
+ *
+ * @since 1.0.0
+ */
+class AttachmentsPlugin extends ziplayer_1.BasePlugin {
+    /**
+     * Creates a new AttachmentsPlugin instance.
+     *
+     * @param opts - Configuration options for the attachments plugin
+     * @param opts.maxFileSize - Maximum file size in bytes (default: 25MB)
+     * @param opts.allowedExtensions - Allowed audio file extensions (default: common audio formats)
+     * @param opts.debug - Whether to enable debug logging (default: false)
+     *
+     * @example
+     * // Basic attachments plugin
+     * const attachmentsPlugin = new AttachmentsPlugin();
+     *
+     * // Custom configuration
+     * const customPlugin = new AttachmentsPlugin({
+     *   maxFileSize: 50 * 1024 * 1024, // 50MB
+     *   allowedExtensions: ['mp3', 'wav', 'ogg'],
+     *   debug: true
+     * });
+     */
+    constructor(opts) {
+        super();
+        this.name = "attachments";
+        this.version = "1.0.0";
+        this.defaultAllowedExtensions = ["mp3", "wav", "ogg", "m4a", "flac", "aac", "wma", "opus", "webm"];
+        this.opts = {
+            maxFileSize: opts?.maxFileSize || 25 * 1024 * 1024, // 25MB default
+            allowedExtensions: opts?.allowedExtensions || this.defaultAllowedExtensions,
+            debug: opts?.debug || false,
+        };
+    }
+    /**
+     * Determines if this plugin can handle the given query.
+     *
+     * @param query - The URL or file path to check
+     * @returns `true` if the query is a Discord attachment URL or audio file URL, `false` otherwise
+     *
+     * @example
+     * plugin.canHandle("https://cdn.discordapp.com/attachments/123/456/audio.mp3"); // true
+     * plugin.canHandle("https://example.com/song.wav"); // true
+     * plugin.canHandle("youtube.com/watch?v=123"); // false
+     */
+    canHandle(query) {
+        if (!query)
+            return false;
+        const q = query.trim();
+        // Check if it's a URL
+        if (q.startsWith("http://") || q.startsWith("https://")) {
+            try {
+                const url = new URL(q);
+                // Discord attachment URLs
+                if (url.hostname === "cdn.discordapp.com" || url.hostname === "media.discordapp.net") {
+                    return this.isAudioFile(q);
+                }
+                // Any other URL - check if it's an audio file
+                return this.isAudioFile(q);
+            }
+            catch {
+                return false;
+            }
+        }
+        // Check if it's a local file path (basic check)
+        if (q.includes("/") || q.includes("\\")) {
+            return this.isAudioFile(q);
+        }
+        return false;
+    }
+    /**
+     * Validates if a URL is a valid Discord attachment URL or audio file URL.
+     *
+     * @param url - The URL to validate
+     * @returns `true` if the URL is valid and points to an audio file, `false` otherwise
+     *
+     * @example
+     * plugin.validate("https://cdn.discordapp.com/attachments/123/456/audio.mp3"); // true
+     * plugin.validate("https://example.com/song.wav"); // true
+     * plugin.validate("https://example.com/image.jpg"); // false
+     */
+    validate(url) {
+        return this.canHandle(url) && this.isAudioFile(url);
+    }
+    /**
+     * Creates a track from an attachment URL or file path.
+     *
+     * This method handles both Discord attachment URLs and direct audio file URLs.
+     * It extracts metadata from the URL and creates a track that can be played.
+     *
+     * @param query - The attachment URL or file path
+     * @param requestedBy - The user ID who requested the track
+     * @returns A SearchResult containing a single track
+     *
+     * @example
+     * // Discord attachment
+     * const result = await plugin.search(
+     *   "https://cdn.discordapp.com/attachments/123/456/audio.mp3",
+     *   "user123"
+     * );
+     *
+     * // Direct audio file URL
+     * const result2 = await plugin.search(
+     *   "https://example.com/song.wav",
+     *   "user123"
+     * );
+     */
+    async search(query, requestedBy) {
+        if (!this.canHandle(query)) {
+            return { tracks: [] };
+        }
+        try {
+            const filename = this.extractFilename(query);
+            const fileExtension = this.getFileExtension(filename);
+            let title = filename || `Audio File (${fileExtension})`;
+            // Get file size if it's a URL
+            let fileSize = 0;
+            let duration = 0;
+            let audioMetadata = {};
+            if (query.startsWith("http://") || query.startsWith("https://")) {
+                try {
+                    const headResponse = await axios_1.default.head(query, { timeout: 5000 });
+                    const contentLength = headResponse.headers["content-length"];
+                    if (contentLength) {
+                        fileSize = parseInt(contentLength, 10);
+                        // Check file size limit
+                        if (fileSize > this.opts.maxFileSize) {
+                            throw new Error(`File too large: ${this.formatBytes(fileSize)} (max: ${this.formatBytes(this.opts.maxFileSize)})`);
+                        }
+                    }
+                }
+                catch (error) {
+                    this.debug("Could not get file size:", error);
+                }
+                // Analyze audio metadata to get duration and other info
+                try {
+                    const analysisResult = await this.analyzeAudioMetadata(query);
+                    duration = analysisResult.duration;
+                    audioMetadata = analysisResult.metadata || {};
+                    // Use metadata title if available
+                    if (audioMetadata.title && audioMetadata.title.trim()) {
+                        const artist = audioMetadata.artist ? ` - ${audioMetadata.artist}` : "";
+                        const album = audioMetadata.album ? ` (${audioMetadata.album})` : "";
+                        const finalTitle = `${audioMetadata.title}${artist}${album}`;
+                        if (finalTitle.trim()) {
+                            title = finalTitle;
+                        }
+                    }
+                }
+                catch (error) {
+                    this.debug("Could not analyze audio metadata:", error);
+                }
+            }
+            const track = {
+                id: this.generateTrackId(query),
+                title,
+                url: query,
+                duration,
+                requestedBy,
+                source: this.name,
+                metadata: {
+                    filename,
+                    extension: fileExtension,
+                    fileSize,
+                    isDiscordAttachment: this.isDiscordAttachment(query),
+                    ...audioMetadata, // Include all audio metadata
+                },
+            };
+            return { tracks: [track] };
+        }
+        catch (error) {
+            this.debug("Error creating track:", error);
+            return { tracks: [] };
+        }
+    }
+    /**
+     * Retrieves the audio stream from an attachment URL or file path.
+     *
+     * This method downloads the audio file from the URL and returns it as a stream.
+     * It handles various audio formats and provides proper error handling.
+     *
+     * @param track - The Track object to get the stream for
+     * @returns A StreamInfo object containing the audio stream
+     * @throws {Error} If the URL is invalid, file is too large, or download fails
+     *
+     * @example
+     * const track = {
+     *   id: "attachment-123",
+     *   title: "audio.mp3",
+     *   url: "https://cdn.discordapp.com/attachments/123/456/audio.mp3",
+     *   ...
+     * };
+     * const streamInfo = await plugin.getStream(track);
+     * console.log(streamInfo.type); // "arbitrary"
+     * console.log(streamInfo.stream); // Readable stream
+     */
+    async getStream(track) {
+        if (track.source !== this.name) {
+            throw new Error("Track is not from AttachmentsPlugin");
+        }
+        const url = track.url;
+        if (!url) {
+            throw new Error("No URL provided for track");
+        }
+        try {
+            this.debug("Downloading audio from:", url);
+            // Download the file
+            const response = await axios_1.default.get(url, {
+                responseType: "stream",
+                timeout: 30000, // 30 second timeout
+                maxContentLength: this.opts.maxFileSize,
+            });
+            const stream = response.data;
+            const contentType = response.headers["content-type"] || "";
+            const contentLength = response.headers["content-length"];
+            this.debug("Download successful:", {
+                contentType,
+                contentLength: contentLength ? parseInt(contentLength, 10) : "unknown",
+            });
+            // Determine stream type based on content type or file extension
+            const streamType = this.getStreamType(contentType, track.metadata?.extension);
+            return {
+                stream,
+                type: streamType,
+                metadata: {
+                    ...track.metadata,
+                    contentType,
+                    contentLength: contentLength ? parseInt(contentLength, 10) : undefined,
+                },
+            };
+        }
+        catch (error) {
+            if (error.code === "ECONNABORTED") {
+                throw new Error(`Download timeout for ${url}`);
+            }
+            if (error.response?.status === 404) {
+                throw new Error(`File not found: ${url}`);
+            }
+            if (error.response?.status === 403) {
+                throw new Error(`Access denied: ${url}`);
+            }
+            if (error.message?.includes("maxContentLength")) {
+                throw new Error(`File too large: ${url}`);
+            }
+            throw new Error(`Failed to download audio: ${error.message || error}`);
+        }
+    }
+    /**
+     * Provides a fallback by attempting to re-download the file.
+     *
+     * @param track - The Track object to get a fallback stream for
+     * @returns A StreamInfo object containing the fallback audio stream
+     * @throws {Error} If fallback download fails
+     */
+    async getFallback(track) {
+        this.debug("Attempting fallback for track:", track.title);
+        return await this.getStream(track);
+    }
+    /**
+     * Checks if a file path or URL is an audio file based on extension.
+     */
+    isAudioFile(path) {
+        const extension = this.getFileExtension(path);
+        return this.opts.allowedExtensions.includes(extension.toLowerCase());
+    }
+    /**
+     * Extracts the file extension from a path or URL.
+     */
+    getFileExtension(path) {
+        const lastDot = path.lastIndexOf(".");
+        if (lastDot === -1)
+            return "";
+        const extension = path.slice(lastDot + 1);
+        // Remove query parameters if present
+        const questionMark = extension.indexOf("?");
+        return questionMark === -1 ? extension : extension.slice(0, questionMark);
+    }
+    /**
+     * Extracts filename from a URL or path.
+     */
+    extractFilename(path) {
+        try {
+            if (path.startsWith("http://") || path.startsWith("https://")) {
+                const url = new URL(path);
+                const pathname = url.pathname;
+                const lastSlash = pathname.lastIndexOf("/");
+                return lastSlash === -1 ? pathname : pathname.slice(lastSlash + 1);
+            }
+            // Local file path
+            const lastSlash = Math.max(path.lastIndexOf("/"), path.lastIndexOf("\\"));
+            return lastSlash === -1 ? path : path.slice(lastSlash + 1);
+        }
+        catch {
+            return "Unknown File";
+        }
+    }
+    /**
+     * Checks if a URL is a Discord attachment URL.
+     */
+    isDiscordAttachment(url) {
+        try {
+            const urlObj = new URL(url);
+            return urlObj.hostname === "cdn.discordapp.com" || urlObj.hostname === "media.discordapp.net";
+        }
+        catch {
+            return false;
+        }
+    }
+    /**
+     * Generates a unique track ID for a given URL.
+     */
+    generateTrackId(url) {
+        // Create a hash-like ID from the URL
+        const hash = this.simpleHash(url);
+        return `attachment-${hash}-${Date.now()}`;
+    }
+    /**
+     * Simple hash function for generating IDs.
+     */
+    simpleHash(str) {
+        let hash = 0;
+        for (let i = 0; i < str.length; i++) {
+            const char = str.charCodeAt(i);
+            hash = (hash << 5) - hash + char;
+            hash = hash & hash; // Convert to 32-bit integer
+        }
+        return Math.abs(hash).toString(36);
+    }
+    /**
+     * Determines the appropriate stream type based on content type and file extension.
+     */
+    getStreamType(contentType, extension) {
+        const type = contentType.toLowerCase();
+        const ext = extension?.toLowerCase() || "";
+        // Check content type first
+        if (type.includes("webm") && type.includes("opus"))
+            return "webm/opus";
+        if (type.includes("ogg") && type.includes("opus"))
+            return "ogg/opus";
+        // Fallback to extension
+        if (ext === "webm")
+            return "webm/opus";
+        if (ext === "ogg")
+            return "ogg/opus";
+        // Default to arbitrary for all other types (mp3, wav, flac, mp4, etc.)
+        return "arbitrary";
+    }
+    /**
+     * Formats bytes into a human-readable string.
+     */
+    formatBytes(bytes) {
+        if (bytes === 0)
+            return "0 Bytes";
+        const k = 1024;
+        const sizes = ["Bytes", "KB", "MB", "GB"];
+        const i = Math.floor(Math.log(bytes) / Math.log(k));
+        return parseFloat((bytes / Math.pow(k, i)).toFixed(2)) + " " + sizes[i];
+    }
+    /**
+     * Analyzes audio metadata to extract duration and other information.
+     *
+     * @param url - The URL to analyze
+     * @returns Promise containing duration in seconds and metadata
+     */
+    async analyzeAudioMetadata(url) {
+        try {
+            this.debug("Analyzing audio metadata for:", url);
+            // Download a small portion of the file to analyze metadata
+            const response = await axios_1.default.get(url, {
+                responseType: "arraybuffer",
+                timeout: 10000, // 10 second timeout for metadata analysis
+                maxContentLength: 1024 * 1024, // Only download first 1MB for metadata
+                headers: {
+                    Range: "bytes=0-1048575", // Request first 1MB
+                },
+            });
+            const buffer = Buffer.from(response.data);
+            const metadata = await (0, music_metadata_1.parseBuffer)(buffer);
+            const duration = metadata.format.duration || 0;
+            this.debug("Audio metadata analysis result:", {
+                duration: `${duration}s`,
+                format: metadata.format.container,
+                codec: metadata.format.codec,
+                bitrate: metadata.format.bitrate,
+            });
+            return {
+                duration: Math.round(duration),
+                metadata: {
+                    format: metadata.format.container,
+                    codec: metadata.format.codec,
+                    bitrate: metadata.format.bitrate,
+                    sampleRate: metadata.format.sampleRate,
+                    channels: metadata.format.numberOfChannels,
+                    title: metadata.common.title,
+                    artist: metadata.common.artist,
+                    album: metadata.common.album,
+                    year: metadata.common.year,
+                    genre: metadata.common.genre,
+                },
+            };
+        }
+        catch (error) {
+            this.debug("Failed to analyze audio metadata:", error.message);
+            // Fallback: try without Range header for some servers that don't support it
+            try {
+                const response = await axios_1.default.get(url, {
+                    responseType: "arraybuffer",
+                    timeout: 10000,
+                    maxContentLength: 1024 * 1024, // 1MB limit
+                });
+                const buffer = Buffer.from(response.data);
+                const metadata = await (0, music_metadata_1.parseBuffer)(buffer);
+                const duration = metadata.format.duration || 0;
+                this.debug("Audio metadata analysis (fallback) result:", {
+                    duration: `${duration}s`,
+                    format: metadata.format.container,
+                });
+                return {
+                    duration: Math.round(duration),
+                    metadata: {
+                        format: metadata.format.container,
+                        codec: metadata.format.codec,
+                        bitrate: metadata.format.bitrate,
+                    },
+                };
+            }
+            catch (fallbackError) {
+                this.debug("Fallback metadata analysis also failed:", fallbackError.message);
+                return { duration: 0 };
+            }
+        }
+    }
+    /**
+     * Debug logging helper.
+     */
+    debug(message, ...args) {
+        if (this.opts.debug) {
+            console.log(`[AttachmentsPlugin] ${message}`, ...args);
+        }
+    }
+}
+exports.AttachmentsPlugin = AttachmentsPlugin;
+//# sourceMappingURL=AttachmentsPlugin.js.map

package/dist/AttachmentsPlugin.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"AttachmentsPlugin.js","sourceRoot":"","sources":["../src/AttachmentsPlugin.ts"],"names":[],"mappings":"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"}

package/dist/TTSPlugin.d.ts

@@ -36,6 +36,7 @@ export interface TTSPluginOptions {
  * - Multiple language support
  * - Configurable speech rate (normal/slow)
  * - TTS query parsing with language and speed options
+ * - Accurate duration analysis by generating sample audio
  *
  * @example
  * const ttsPlugin = new TTSPlugin({
@@ -131,6 +132,22 @@ export declare class TTSPlugin extends BasePlugin {
      * const result4 = await plugin.search("say Hello world", "user123");
      */
     search(query: string, requestedBy: string): Promise<SearchResult>;
+    /**
+     * Analyzes TTS audio duration by generating a small sample and measuring its length.
+     *
+     * @param text - The text to analyze
+     * @param lang - The language code
+     * @param slow - Whether to use slow speech rate
+     * @returns Promise containing duration in seconds
+     */
+    private analyzeTTSDuration;
+    /**
+     * Estimates TTS duration based on text length and language.
+     *
+     * @param text - The text to estimate duration for
+     * @returns Estimated duration in seconds
+     */
+    private estimateDuration;
     /**
      * Generates an audio stream for a TTS track.
      *

package/dist/TTSPlugin.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"TTSPlugin.d.ts","sourceRoot":"","sources":["../src/TTSPlugin.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,KAAK,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AACvE,OAAO,EAAE,QAAQ,EAAE,MAAM,QAAQ,CAAC;AAIlC;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAChC,gEAAgE;IAChE,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,sCAAsC;IACtC,IAAI,CAAC,EAAE,OAAO,CAAC;IACf;;;;;;;;;;;;OAYG;IACH,YAAY,CAAC,EAAE,CACd,IAAI,EAAE,MAAM,EACZ,GAAG,CAAC,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,OAAO,CAAC;QAAC,KAAK,CAAC,EAAE,KAAK,CAAA;KAAE,KAElD,OAAO,CAAC,QAAQ,GAAG,MAAM,GAAG,GAAG,GAAG,MAAM,GAAG,UAAU,GAAG,WAAW,CAAC,GACpE,QAAQ,GACR,MAAM,GACN,GAAG,GACH,MAAM,GACN,UAAU,GACV,WAAW,CAAC;CACf;AAcD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAoCG;AACH,qBAAa,SAAU,SAAQ,UAAU;IACxC,IAAI,SAAS;IACb,OAAO,SAAW;IAClB,OAAO,CAAC,IAAI,CAA0F;IAEtG;;;;;;;;;;;;;;;;;;;;;;;;;OAyBG;gBACS,IAAI,CAAC,EAAE,gBAAgB;IASnC;;;;;;;;;;OAUG;IACH,SAAS,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO;IAMjC;;;;;;;;;;;;;;;;;;;;;;OAsBG;IACG,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC;IAuBvE;;;;;;;;;;;;;;;;OAgBG;IACG,SAAS,CAAC,KAAK,EAAE,KAAK,GAAG,OAAO,CAAC,UAAU,CAAC;YAsEpC,UAAU;IAgBxB,OAAO,CAAC,UAAU;IAiDlB,OAAO,CAAC,YAAY;IAKpB,OAAO,CAAC,aAAa;CAYrB"}
+{"version":3,"file":"TTSPlugin.d.ts","sourceRoot":"","sources":["../src/TTSPlugin.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,KAAK,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AACvE,OAAO,EAAE,QAAQ,EAAE,MAAM,QAAQ,CAAC;AAKlC;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAChC,gEAAgE;IAChE,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,sCAAsC;IACtC,IAAI,CAAC,EAAE,OAAO,CAAC;IACf;;;;;;;;;;;;OAYG;IACH,YAAY,CAAC,EAAE,CACd,IAAI,EAAE,MAAM,EACZ,GAAG,CAAC,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,OAAO,CAAC;QAAC,KAAK,CAAC,EAAE,KAAK,CAAA;KAAE,KAElD,OAAO,CAAC,QAAQ,GAAG,MAAM,GAAG,GAAG,GAAG,MAAM,GAAG,UAAU,GAAG,WAAW,CAAC,GACpE,QAAQ,GACR,MAAM,GACN,GAAG,GACH,MAAM,GACN,UAAU,GACV,WAAW,CAAC;CACf;AAcD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAqCG;AACH,qBAAa,SAAU,SAAQ,UAAU;IACxC,IAAI,SAAS;IACb,OAAO,SAAW;IAClB,OAAO,CAAC,IAAI,CAA0F;IAEtG;;;;;;;;;;;;;;;;;;;;;;;;;OAyBG;gBACS,IAAI,CAAC,EAAE,gBAAgB;IASnC;;;;;;;;;;OAUG;IACH,SAAS,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO;IAMjC;;;;;;;;;;;;;;;;;;;;;;OAsBG;IACG,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC;IAqCvE;;;;;;;OAOG;YACW,kBAAkB;IAgChC;;;;;OAKG;IACH,OAAO,CAAC,gBAAgB;IAaxB;;;;;;;;;;;;;;;;OAgBG;IACG,SAAS,CAAC,KAAK,EAAE,KAAK,GAAG,OAAO,CAAC,UAAU,CAAC;YAmEpC,UAAU;IAgBxB,OAAO,CAAC,UAAU;IAiDlB,OAAO,CAAC,YAAY;IAKpB,OAAO,CAAC,aAAa;CAYrB"}

package/dist/TTSPlugin.js

@@ -8,6 +8,7 @@ const ziplayer_1 = require("ziplayer");
 const stream_1 = require("stream");
 const zitts_1 = require("@zibot/zitts");
 const axios_1 = __importDefault(require("axios"));
+const music_metadata_1 = require("music-metadata");
 /**
  * A plugin for Text-to-Speech (TTS) functionality.
  *
@@ -17,6 +18,7 @@ const axios_1 = __importDefault(require("axios"));
  * - Multiple language support
  * - Configurable speech rate (normal/slow)
  * - TTS query parsing with language and speed options
+ * - Accurate duration analysis by generating sample audio
  *
  * @example
  * const ttsPlugin = new TTSPlugin({
@@ -130,18 +132,80 @@ class TTSPlugin extends ziplayer_1.BasePlugin {
         const config = { text, lang, slow };
         const url = this.encodeConfig(config);
         const title = `TTS (${lang}${slow ? ", slow" : ""}): ${text.slice(0, 64)}${text.length > 64 ? "…" : ""}`;
-        const estimatedSeconds = Math.max(1, Math.min(60, Math.ceil(text.length / 12)));
+        // Analyze actual TTS duration
+        let duration;
+        try {
+            duration = await this.analyzeTTSDuration(text, lang, slow);
+        }
+        catch (error) {
+            // Fallback to estimation if analysis fails
+            duration = this.estimateDuration(text);
+        }
         const track = {
             id: `tts-${Date.now()}-${Math.random().toString(36).slice(2, 8)}`,
             title,
             url,
-            duration: estimatedSeconds,
+            duration,
             requestedBy,
             source: this.name,
-            metadata: { tts: config },
+            metadata: {
+                tts: config,
+                analyzedDuration: true,
+                textLength: text.length,
+                language: lang,
+                slowMode: slow,
+            },
         };
         return { tracks: [track] };
     }
+    /**
+     * Analyzes TTS audio duration by generating a small sample and measuring its length.
+     *
+     * @param text - The text to analyze
+     * @param lang - The language code
+     * @param slow - Whether to use slow speech rate
+     * @returns Promise containing duration in seconds
+     */
+    async analyzeTTSDuration(text, lang, slow) {
+        try {
+            // Use a shorter sample text for duration analysis to minimize processing time
+            const sampleText = text.length > 50 ? text.slice(0, 50) + "..." : text;
+            const urls = (0, zitts_1.getTTSUrls)(sampleText, { lang, slow });
+            if (!urls || urls.length === 0) {
+                return this.estimateDuration(text);
+            }
+            // Download the sample audio
+            const parts = await Promise.all(urls.map((u) => axios_1.default.get(u, { responseType: "arraybuffer" }).then((r) => Buffer.from(r.data))));
+            const merged = Buffer.concat(parts);
+            // Parse metadata to get actual duration
+            const metadata = await (0, music_metadata_1.parseBuffer)(merged);
+            const actualDuration = metadata.format.duration || 0;
+            // Calculate ratio and apply to full text
+            const sampleRatio = sampleText.length / text.length;
+            const estimatedDuration = actualDuration / sampleRatio;
+            return Math.round(estimatedDuration);
+        }
+        catch (error) {
+            // Fallback to text-based estimation
+            return this.estimateDuration(text);
+        }
+    }
+    /**
+     * Estimates TTS duration based on text length and language.
+     *
+     * @param text - The text to estimate duration for
+     * @returns Estimated duration in seconds
+     */
+    estimateDuration(text) {
+        // Base estimation: ~12 characters per second for normal speech
+        // Adjust based on text complexity and language
+        const baseRate = 12; // characters per second
+        const wordCount = text.split(/\s+/).length;
+        const charCount = text.length;
+        // Use word count for better estimation
+        const estimatedSeconds = Math.max(1, Math.min(300, Math.ceil(wordCount / 2.5)));
+        return estimatedSeconds;
+    }
     /**
      * Generates an audio stream for a TTS track.
      *
@@ -198,10 +262,7 @@ class TTSPlugin extends ziplayer_1.BasePlugin {
                     const urlStr = o.url.toString();
                     try {
                         type =
-                            normType(o.type) ||
-                                (urlStr.endsWith(".webm") ? "webm/opus"
-                                    : urlStr.endsWith(".ogg") ? "ogg/opus"
-                                        : undefined);
+                            normType(o.type) || (urlStr.endsWith(".webm") ? "webm/opus" : urlStr.endsWith(".ogg") ? "ogg/opus" : undefined);
                         const res = await axios_1.default.get(urlStr, { responseType: "stream" });
                         stream = res.data;
                         metadata = o.metadata;