@thunderkiller/video-clipper 1.7.0 → 1.9.0

package/dist/lib/services/video/source/youtube/downloader.js

@@ -0,0 +1,250 @@
+import { execa } from 'execa';
+import { promises as fs } from 'fs';
+import { join } from 'path';
+import pLimit from 'p-limit';
+import { log } from '../../../../utils/logger.js';
+import { retryAsync } from '../../../../utils/retryAsync.js';
+/**
+ * Formats a timestamp for yt-dlp --download-sections.
+ * Converts seconds to HH:MM:SS.mmm format with millisecond precision.
+ */
+function formatTimestamp(seconds) {
+    const h = Math.floor(seconds / 3600);
+    const m = Math.floor((seconds % 3600) / 60);
+    const s = seconds % 60;
+    const sInt = Math.floor(s);
+    const ms = Math.round((s - sInt) * 1000);
+    return `${String(h).padStart(2, '0')}:${String(m).padStart(2, '0')}:${String(sInt).padStart(2, '0')}.${String(ms).padStart(3, '0')}`;
+}
+/**
+ * Builds yt-dlp flags that are shared across all download functions based on
+ * the configurable strategy fields (player client, SSL, IPv4, geo-bypass,
+ * sleep).  These flags are prepended/appended to the per-function arg list so
+ * every call honours the same settings.
+ */
+function buildSharedFlags(dlConfig) {
+    const flags = [];
+    if (dlConfig.playerClient && dlConfig.playerClient !== 'auto') {
+        flags.push('--extractor-args', `youtube:player_client=${dlConfig.playerClient}`);
+    }
+    if (dlConfig.noCheckCertificates) {
+        flags.push('--no-check-certificates');
+    }
+    if (dlConfig.forceIpv4) {
+        flags.push('--force-ipv4');
+    }
+    if (dlConfig.geoBypass) {
+        flags.push('--geo-bypass');
+    }
+    if (dlConfig.sleepRequests && dlConfig.sleepRequests > 0) {
+        flags.push('--sleep-requests', String(dlConfig.sleepRequests));
+    }
+    return flags;
+}
+/**
+ * Downloads a YouTube video using yt-dlp and returns the local file path.
+ *
+ * Strategy:
+ * - Skips download if the target file already exists.
+ * - Auto-creates the download directory if it doesn't exist.
+ * - Surfaces clear errors for common failure modes (yt-dlp not installed,
+ *   private/geo-blocked video, etc.).
+ *
+ * @param videoId - 11-character YouTube video ID
+ * @param customPath - Custom output directory (optional, overrides DOWNLOAD_DIR)
+ * @returns Absolute path to the downloaded mp4 file
+ * @throws {Error} if yt-dlp is not installed or the download fails
+ */
+export async function downloadFullVideo(videoId, dlConfig, customPath) {
+    const downloadDir = customPath || dlConfig.downloadDir;
+    await fs.mkdir(downloadDir, { recursive: true });
+    const outputPath = join(downloadDir, `${videoId}.mp4`);
+    try {
+        await fs.access(outputPath);
+        log.info('downloadFullVideo', `Video already downloaded: ${outputPath}`);
+        return outputPath;
+    }
+    catch { }
+    log.info('downloadFullVideo', `Downloading full video ${videoId} via yt-dlp...`);
+    const args = [
+        '-f',
+        'bestvideo[ext=mp4]+bestaudio[ext=m4a]/best[ext=mp4]',
+        '--merge-output-format',
+        'mp4',
+        '-o',
+        outputPath,
+        '--no-playlist',
+        '--newline',
+        ...buildSharedFlags(dlConfig),
+        `https://www.youtube.com/watch?v=${videoId}`,
+    ];
+    if (dlConfig.cookiesFromBrowser) {
+        args.splice(0, 0, '--cookies-from-browser', dlConfig.cookiesFromBrowser);
+    }
+    else if (dlConfig.cookiesFile) {
+        args.splice(0, 0, '--cookies', dlConfig.cookiesFile);
+    }
+    try {
+        await retryAsync(async () => {
+            const subprocess = execa('yt-dlp', args);
+            if (!dlConfig.quiet) {
+                subprocess.stdout?.on('data', (chunk) => log.progress('downloadFullVideo', chunk));
+                subprocess.stderr?.on('data', (chunk) => log.progress('downloadFullVideo', chunk));
+            }
+            await subprocess;
+        }, dlConfig.retryCount ?? 0, 2000, `yt-dlp:${videoId}`);
+    }
+    catch (err) {
+        const message = err instanceof Error ? err.message : String(err);
+        log.error('downloadFullVideo', `Video download failed: ${String(err)}`);
+        if (message.includes('command not found') || message.includes('ENOENT')) {
+            throw new Error('yt-dlp is required. Install it: https://github.com/yt-dlp/yt-dlp');
+        }
+        if (message.includes('Private video') || message.includes('Sign in')) {
+            throw new Error(`Video "${videoId}" is private and cannot be downloaded.`);
+        }
+        if (message.includes('not available in your country') || message.includes('geo')) {
+            throw new Error(`Video "${videoId}" is geo-blocked in your region.`);
+        }
+        throw new Error(`Download failed: ${message}`);
+    }
+    log.info('downloadFullVideo', `Download complete: ${outputPath}`);
+    return outputPath;
+}
+/**
+ * Downloads a single segment using yt-dlp --download-sections.
+ */
+async function downloadSegment(videoId, segment, index, dlConfig, customPath) {
+    const downloadDir = customPath || dlConfig.downloadDir;
+    await fs.mkdir(downloadDir, { recursive: true });
+    const adjustedStart = Math.max(0, segment.start + dlConfig.timestampOffset);
+    const adjustedEnd = Math.max(adjustedStart + 1, segment.end + dlConfig.timestampOffset);
+    const startInt = Math.floor(adjustedStart);
+    const endInt = Math.ceil(adjustedEnd);
+    const outputPath = join(downloadDir, `${videoId}_${startInt}_${endInt}.mp4`);
+    try {
+        await fs.access(outputPath);
+        log.info('downloadSegment', `Segment ${index + 1}/${index} already downloaded: ${outputPath}`);
+        return outputPath;
+    }
+    catch { }
+    const startTs = formatTimestamp(adjustedStart);
+    const endTs = formatTimestamp(adjustedEnd);
+    log.info('downloadSegment', `Downloading segment ${index + 1}: ${startTs} - ${endTs} (${segment.reason})`);
+    log.info('downloadSegment', `  Requested: ${segment.start.toFixed(2)}s - ${segment.end.toFixed(2)}s`);
+    if (dlConfig.timestampOffset !== 0) {
+        log.info('downloadSegment', `  Adjusted: ${adjustedStart.toFixed(2)}s - ${adjustedEnd.toFixed(2)}s (offset: ${dlConfig.timestampOffset}s)`);
+    }
+    try {
+        // NOTE: cookies are intentionally NOT passed here by default.
+        //
+        // When --cookies-from-browser or --cookies is present, yt-dlp is forced
+        // into the TV + web_creator client path for --download-sections requests.
+        // That path downloads tv-player-ias.js and attempts to solve the n-challenge
+        // using it; the TV player JS references self.location.origin (a browser-only
+        // global) which crashes in every non-browser JS runtime (Deno, Node.js).
+        //
+        // Without cookies, yt-dlp automatically selects the ANDROID_VR client.
+        // The ANDROID_VR client generates pre-signed DASH URLs (c=ANDROID_VR)
+        // that work even when n-challenge solving fails — so the download succeeds
+        // at full quality (1080p60 DASH) for any public video.
+        //
+        // Trade-off: private or age-gated videos cannot be downloaded this way.
+        // Enable YT_DLP_SEGMENT_COOKIES_ENABLED=true to pass cookies here — but
+        // be aware it forces the TV client and may break public video downloads.
+        // For those, set PARTIAL_DOWNLOAD_ENABLED=false and use the full-video path
+        // which passes cookies and uses the web client (no TV player JS involved).
+        const args = [
+            '-f',
+            'bestvideo[ext=mp4]+bestaudio[ext=m4a]/best[ext=mp4]',
+            '--merge-output-format',
+            'mp4',
+            '--download-sections',
+            `*${startTs}-${endTs}`,
+            '-o',
+            outputPath,
+            '--no-playlist',
+            '--newline',
+            ...buildSharedFlags(dlConfig),
+            `https://www.youtube.com/watch?v=${videoId}`,
+        ];
+        if (dlConfig.segmentCookiesEnabled) {
+            if (dlConfig.cookiesFromBrowser) {
+                args.splice(0, 0, '--cookies-from-browser', dlConfig.cookiesFromBrowser);
+            }
+            else if (dlConfig.cookiesFile) {
+                args.splice(0, 0, '--cookies', dlConfig.cookiesFile);
+            }
+        }
+        await retryAsync(async () => {
+            const subprocess = execa('yt-dlp', args);
+            if (!dlConfig.quiet) {
+                subprocess.stdout?.on('data', (chunk) => log.progress('downloadSegment', chunk));
+                subprocess.stderr?.on('data', (chunk) => log.progress('downloadSegment', chunk));
+            }
+            await subprocess;
+        }, dlConfig.retryCount ?? 0, 2000, `yt-dlp:${videoId}:seg${index + 1}`);
+    }
+    catch (err) {
+        const message = err instanceof Error ? err.message : String(err);
+        log.error('downloadSegment', `Segment ${index + 1} download failed: ${String(err)}`);
+        if (message.includes('command not found') || message.includes('ENOENT')) {
+            throw new Error('yt-dlp is required. Install it: https://github.com/yt-dlp/yt-dlp');
+        }
+        if (message.includes('Private video') || message.includes('Sign in')) {
+            throw new Error(`Video "${videoId}" is private and cannot be downloaded.`);
+        }
+        if (message.includes('not available in your country') || message.includes('geo')) {
+            throw new Error(`Video "${videoId}" is geo-blocked in your region.`);
+        }
+        throw new Error(`Segment download failed: ${message}`);
+    }
+    log.info('downloadSegment', `Segment complete: ${outputPath}`);
+    return outputPath;
+}
+async function downloadSegments(videoId, segments, dlConfig, customPath) {
+    if (segments.length === 0) {
+        return [];
+    }
+    const limit = pLimit(Math.min(dlConfig.llmConcurrency, 3));
+    const results = await Promise.allSettled(segments.map((segment, index) => limit(() => downloadSegment(videoId, segment, index, dlConfig, customPath))));
+    const paths = [];
+    for (let i = 0; i < results.length; i++) {
+        const result = results[i];
+        const segment = segments[i];
+        if (result.status === 'fulfilled') {
+            paths.push(result.value);
+        }
+        else {
+            const reason = result.reason instanceof Error ? result.reason.message : String(result.reason);
+            log.warn('downloadSegments', `Failed to download segment [${formatTimestamp(segment.start)} – ${formatTimestamp(segment.end)}] (rank ${segment.rank}): ${reason}`);
+        }
+    }
+    return paths;
+}
+/**
+ * Downloads a YouTube video based on the specified mode.
+ *
+ * @param videoId - 11-character YouTube video ID
+ * @param mode - Download mode: 'all' (full video) or 'segments' (individual clips)
+ * @param segments - Ranked segments (required when mode is 'segments')
+ * @param customPath - Custom output directory (optional, overrides config defaults)
+ * @returns Download result containing the mode and either path or paths
+ */
+export async function downloadVideo(videoId, mode = 'all', segments = [], dlConfig, customPath) {
+    if (mode === 'all') {
+        const path = await downloadFullVideo(videoId, dlConfig, customPath);
+        return { mode: 'all', path };
+    }
+    if (mode === 'segments') {
+        if (segments.length === 0) {
+            log.warn('downloadVideo', 'No segments provided for download-segments mode. Skipping download.');
+            return { mode: 'segments', paths: [] };
+        }
+        log.info('downloadVideo', `Downloading ${segments.length} segments in parallel...`);
+        const paths = await downloadSegments(videoId, segments, dlConfig, customPath);
+        return { mode: 'segments', paths };
+    }
+    throw new Error(`Invalid download mode: ${mode}`);
+}
+//# sourceMappingURL=downloader.js.map

package/dist/lib/services/video/source/youtube/downloader.js.map

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

package/dist/lib/services/video/source/youtube/metadata.d.ts

@@ -0,0 +1,14 @@
+import type { VideoMetadata } from '../../../../types/video.js';
+import type { YtDlpCookies } from '../../../../types/downloader.js';
+export type { YtDlpCookies } from '../../../../types/downloader.js';
+/**
+ * Extracts video metadata (title, duration) for a given YouTube video ID.
+ *
+ * Strategy:
+ * 1. Try yt-dlp --dump-json (full metadata, requires yt-dlp installed)
+ * 2. Fall back to YouTube oEmbed API (title only, duration = 0)
+ *
+ * @throws {Error} if both strategies fail
+ */
+export declare function extractMetadata(videoId: string, cookies?: YtDlpCookies): Promise<VideoMetadata>;
+//# sourceMappingURL=metadata.d.ts.map

package/dist/lib/services/video/source/youtube/metadata.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"metadata.d.ts","sourceRoot":"","sources":["../../../../../../src/lib/services/video/source/youtube/metadata.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACzD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAE7D,YAAY,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AA2D7D;;;;;;;;GAQG;AACH,wBAAsB,eAAe,CACnC,OAAO,EAAE,MAAM,EACf,OAAO,GAAE,YAAiB,GACzB,OAAO,CAAC,aAAa,CAAC,CAQxB"}

package/dist/{services/metadataExtractor/index.js → lib/services/video/source/youtube/metadata.js}

@@ -1,21 +1,17 @@
 import { execa } from 'execa';
-import { config } from '../../config/index.js';
-import { log } from '../../utils/logger.js';
+import { log } from '../../../../utils/logger.js';
+import { retryAsync } from '../../../../utils/retryAsync.js';
 const OEMBED_URL = 'https://www.youtube.com/oembed';
-/**
- * Attempts to extract video metadata via yt-dlp --dump-json.
- * Returns null if yt-dlp is not installed or the call fails.
- */
-async function extractViaYtDlp(videoId) {
+async function extractViaYtDlp(videoId, cookies) {
     try {
         const args = ['--dump-json', '--no-playlist', `https://www.youtube.com/watch?v=${videoId}`];
-        if (config.YT_DLP_COOKIES_FROM_BROWSER) {
-            args.unshift('--cookies-from-browser', config.YT_DLP_COOKIES_FROM_BROWSER);
+        if (cookies.cookiesFromBrowser) {
+            args.unshift('--cookies-from-browser', cookies.cookiesFromBrowser);
         }
-        else if (config.YT_DLP_COOKIES_FILE) {
-            args.unshift('--cookies', config.YT_DLP_COOKIES_FILE);
+        else if (cookies.cookiesFile) {
+            args.unshift('--cookies', cookies.cookiesFile);
         }
-        const { stdout } = await execa('yt-dlp', args);
+        const { stdout } = await retryAsync(() => execa('yt-dlp', args), cookies.retryCount ?? 0, 2000, `yt-dlp:metadata:${videoId}`);
         const data = JSON.parse(stdout);
         return {
             videoId,
@@ -25,7 +21,7 @@ async function extractViaYtDlp(videoId) {
     }
     catch (err) {
         const message = err instanceof Error ? err.message : String(err);
-        log.warn(`yt-dlp failed for "${videoId}": ${message}`);
+        log.warn('extractViaYtDlp', `yt-dlp failed for "${videoId}": ${message}`);
         return null;
     }
 }
@@ -40,7 +36,7 @@ async function extractViaOEmbed(videoId) {
         throw new Error(`oEmbed request failed for "${videoId}": HTTP ${res.status}`);
     }
     const data = (await res.json());
-    log.warn(`yt-dlp unavailable — duration unknown for "${videoId}". Install yt-dlp for full metadata.`);
+    log.warn('extractViaOEmbed', `yt-dlp unavailable — duration unknown for "${videoId}". Install yt-dlp for full metadata.`);
     return {
         videoId,
         title: data.title,
@@ -56,12 +52,12 @@ async function extractViaOEmbed(videoId) {
  *
  * @throws {Error} if both strategies fail
  */
-export async function extractMetadata(videoId) {
-    const ytDlpResult = await extractViaYtDlp(videoId);
+export async function extractMetadata(videoId, cookies = {}) {
+    const ytDlpResult = await extractViaYtDlp(videoId, cookies);
     if (ytDlpResult) {
         return ytDlpResult;
     }
-    log.warn(`yt-dlp failed for "${videoId}", falling back to oEmbed...`);
+    log.warn('extractMetadata', `yt-dlp failed for "${videoId}", falling back to oEmbed...`);
     return extractViaOEmbed(videoId);
 }
-//# sourceMappingURL=index.js.map
+//# sourceMappingURL=metadata.js.map

package/dist/lib/services/video/source/youtube/metadata.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"metadata.js","sourceRoot":"","sources":["../../../../../../src/lib/services/video/source/youtube/metadata.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,OAAO,CAAC;AAC9B,OAAO,EAAE,GAAG,EAAE,MAAM,sBAAsB,CAAC;AAC3C,OAAO,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAC;AAOtD,MAAM,UAAU,GAAG,gCAAgC,CAAC;AAEpD,KAAK,UAAU,eAAe,CAC5B,OAAe,EACf,OAAqB;IAErB,IAAI,CAAC;QACH,MAAM,IAAI,GAAG,CAAC,aAAa,EAAE,eAAe,EAAE,mCAAmC,OAAO,EAAE,CAAC,CAAC;QAE5F,IAAI,OAAO,CAAC,kBAAkB,EAAE,CAAC;YAC/B,IAAI,CAAC,OAAO,CAAC,wBAAwB,EAAE,OAAO,CAAC,kBAAkB,CAAC,CAAC;QACrE,CAAC;aAAM,IAAI,OAAO,CAAC,WAAW,EAAE,CAAC;YAC/B,IAAI,CAAC,OAAO,CAAC,WAAW,EAAE,OAAO,CAAC,WAAW,CAAC,CAAC;QACjD,CAAC;QAED,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,UAAU,CACjC,GAAG,EAAE,CAAC,KAAK,CAAC,QAAQ,EAAE,IAAI,CAAC,EAC3B,OAAO,CAAC,UAAU,IAAI,CAAC,EACvB,IAAI,EACJ,mBAAmB,OAAO,EAAE,CAC7B,CAAC;QACF,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,CAAc,CAAC;QAC7C,OAAO;YACL,OAAO;YACP,KAAK,EAAE,IAAI,CAAC,KAAK;YACjB,QAAQ,EAAE,IAAI,CAAC,QAAQ;SACxB,CAAC;IACJ,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,MAAM,OAAO,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;QACjE,GAAG,CAAC,IAAI,CAAC,iBAAiB,EAAE,sBAAsB,OAAO,MAAM,OAAO,EAAE,CAAC,CAAC;QAC1E,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAED;;;GAGG;AACH,KAAK,UAAU,gBAAgB,CAAC,OAAe;IAC7C,MAAM,GAAG,GAAG,GAAG,UAAU,wCAAwC,OAAO,cAAc,CAAC;IACvF,MAAM,GAAG,GAAG,MAAM,KAAK,CAAC,GAAG,CAAC,CAAC;IAC7B,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC;QACZ,MAAM,IAAI,KAAK,CAAC,8BAA8B,OAAO,WAAW,GAAG,CAAC,MAAM,EAAE,CAAC,CAAC;IAChF,CAAC;IACD,MAAM,IAAI,GAAG,CAAC,MAAM,GAAG,CAAC,IAAI,EAAE,CAAmB,CAAC;IAClD,GAAG,CAAC,IAAI,CACN,kBAAkB,EAClB,8CAA8C,OAAO,sCAAsC,CAC5F,CAAC;IACF,OAAO;QACL,OAAO;QACP,KAAK,EAAE,IAAI,CAAC,KAAK;QACjB,QAAQ,EAAE,CAAC;KACZ,CAAC;AACJ,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,CAAC,KAAK,UAAU,eAAe,CACnC,OAAe,EACf,UAAwB,EAAE;IAE1B,MAAM,WAAW,GAAG,MAAM,eAAe,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;IAC5D,IAAI,WAAW,EAAE,CAAC;QAChB,OAAO,WAAW,CAAC;IACrB,CAAC;IAED,GAAG,CAAC,IAAI,CAAC,iBAAiB,EAAE,sBAAsB,OAAO,8BAA8B,CAAC,CAAC;IACzF,OAAO,gBAAgB,CAAC,OAAO,CAAC,CAAC;AACnC,CAAC"}

package/dist/{services/urlParser/index.d.ts → lib/services/video/source/youtube/parser.d.ts}

@@ -9,4 +9,4 @@
  * @throws {Error} if the URL is not a valid YouTube URL or the video ID is not 11 characters
  */
 export declare function parseUrl(url: string): string;
-//# sourceMappingURL=index.d.ts.map
+//# sourceMappingURL=parser.d.ts.map

package/dist/lib/services/video/source/youtube/parser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parser.d.ts","sourceRoot":"","sources":["../../../../../../src/lib/services/video/source/youtube/parser.ts"],"names":[],"mappings":"AAEA;;;;;;;;;GASG;AACH,wBAAgB,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAuC5C"}

package/dist/{services/urlParser/index.js → lib/services/video/source/youtube/parser.js}

@@ -43,4 +43,4 @@ export function parseUrl(url) {
     }
     return videoId;
 }
-//# sourceMappingURL=index.js.map
+//# sourceMappingURL=parser.js.map

package/dist/lib/services/video/source/youtube/parser.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"parser.js","sourceRoot":"","sources":["../../../../../../src/lib/services/video/source/youtube/parser.ts"],"names":[],"mappings":"AAAA,MAAM,eAAe,GAAG,EAAE,CAAC;AAE3B;;;;;;;;;GASG;AACH,MAAM,UAAU,QAAQ,CAAC,GAAW;IAClC,IAAI,MAAW,CAAC;IAEhB,IAAI,CAAC;QACH,MAAM,GAAG,IAAI,GAAG,CAAC,GAAG,CAAC,CAAC;IACxB,CAAC;IAAC,MAAM,CAAC;QACP,MAAM,IAAI,KAAK,CAAC,iBAAiB,GAAG,GAAG,CAAC,CAAC;IAC3C,CAAC;IAED,MAAM,EAAE,QAAQ,EAAE,QAAQ,EAAE,YAAY,EAAE,GAAG,MAAM,CAAC;IACpD,MAAM,IAAI,GAAG,QAAQ,CAAC,OAAO,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC;IAE5C,IAAI,OAAO,GAAkB,IAAI,CAAC;IAElC,IAAI,IAAI,KAAK,aAAa,EAAE,CAAC;QAC3B,IAAI,QAAQ,KAAK,QAAQ,EAAE,CAAC;YAC1B,OAAO,GAAG,YAAY,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QAClC,CAAC;aAAM,IAAI,QAAQ,CAAC,UAAU,CAAC,SAAS,CAAC,EAAE,CAAC;YAC1C,OAAO,GAAG,QAAQ,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,EAAE,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC;QAChE,CAAC;aAAM,IAAI,QAAQ,CAAC,UAAU,CAAC,UAAU,CAAC,EAAE,CAAC;YAC3C,OAAO,GAAG,QAAQ,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,EAAE,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC;QACjE,CAAC;IACH,CAAC;SAAM,IAAI,IAAI,KAAK,UAAU,EAAE,CAAC;QAC/B,OAAO,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC;IACpD,CAAC;IAED,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,MAAM,IAAI,KAAK,CAAC,yCAAyC,GAAG,GAAG,CAAC,CAAC;IACnE,CAAC;IAED,OAAO,GAAG,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;IAEhC,IAAI,OAAO,CAAC,MAAM,KAAK,eAAe,EAAE,CAAC;QACvC,MAAM,IAAI,KAAK,CACb,qBAAqB,OAAO,eAAe,eAAe,oBAAoB,OAAO,CAAC,MAAM,EAAE,CAC/F,CAAC;IACJ,CAAC;IAED,OAAO,OAAO,CAAC;AACjB,CAAC"}

package/dist/lib/services/video/source/youtube/subtitles.d.ts

@@ -0,0 +1,32 @@
+import type { TranscriptLine } from '../../../../types/transcript.js';
+import { TranscriptAnalyzer } from '../../../audio/transcriber/base.js';
+import type { YtDlpCookies } from '../../../../types/downloader.js';
+import type { YouTubeCaptionTrack, YouTubePlayerResponse } from '../../../../types/youtube.js';
+/**
+ * Parses a WebVTT string into TranscriptLine[].
+ *
+ * Handles:
+ * - `HH:MM:SS.mmm --> HH:MM:SS.mmm` timestamp lines
+ * - `<MM:SS.mmm><c>text</c>` inline cue tags (stripped)
+ * - Duplicate / empty cues (skipped)
+ *
+ * Exported for unit testing.
+ */
+export declare function parseVtt(vttContent: string): TranscriptLine[];
+export declare function extractInitialPlayerResponse(html: string): YouTubePlayerResponse | null;
+export declare function pickEnglishCaptionTrack(tracks: YouTubeCaptionTrack[]): YouTubeCaptionTrack | null;
+export declare function rankSubtitleFiles(files: string[]): string[];
+/**
+ * Fetches the YouTube transcript from YouTube caption tracks first, then
+ * falls back to yt-dlp subtitle extraction when needed.
+ *
+ * This is the default transcript provider. It does not use the audio file —
+ * the `audioPath` parameter is accepted but ignored.
+ */
+export declare class YtDlpTranscriptAnalyzer extends TranscriptAnalyzer {
+    private readonly cookies;
+    readonly source: "ytdlp";
+    constructor(cookies?: YtDlpCookies);
+    detect(videoId: string, _audioPath: string | null): Promise<TranscriptLine[]>;
+}
+//# sourceMappingURL=subtitles.d.ts.map

package/dist/lib/services/video/source/youtube/subtitles.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"subtitles.d.ts","sourceRoot":"","sources":["../../../../../../src/lib/services/video/source/youtube/subtitles.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAC/D,OAAO,EAAE,kBAAkB,EAAE,MAAM,oCAAoC,CAAC;AACxE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAC7D,OAAO,KAAK,EAAE,mBAAmB,EAAE,qBAAqB,EAAE,MAAM,uBAAuB,CAAC;AAOxF;;;;;;;;;GASG;AACH,wBAAgB,QAAQ,CAAC,UAAU,EAAE,MAAM,GAAG,cAAc,EAAE,CA+D7D;AAED,wBAAgB,4BAA4B,CAAC,IAAI,EAAE,MAAM,GAAG,qBAAqB,GAAG,IAAI,CAyBvF;AAED,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,mBAAmB,EAAE,GAAG,mBAAmB,GAAG,IAAI,CAQjG;AAED,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,MAAM,EAAE,CAO3D;AA2SD;;;;;;GAMG;AACH,qBAAa,uBAAwB,SAAQ,kBAAkB;IAGjD,OAAO,CAAC,QAAQ,CAAC,OAAO;IAFpC,QAAQ,CAAC,MAAM,EAAG,OAAO,CAAU;gBAEN,OAAO,GAAE,YAAiB;IAIjD,MAAM,CAAC,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,IAAI,GAAG,OAAO,CAAC,cAAc,EAAE,CAAC;CAGpF"}