@thunderkiller/video-clipper 1.6.0 → 1.8.0

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

@@ -0,0 +1,177 @@
+import { youtube } from '@googleapis/youtube';
+import { ChannelSummarySchema, VideoDetailsSchema, VideoPageSchema, VideoSummarySchema, } from '../../../../types/youtube.js';
+export class GoogleYouTubeCatalogService {
+    client;
+    constructor(apiKey) {
+        this.client = youtube({ version: 'v3', auth: apiKey });
+    }
+    async resolveChannel(input) {
+        const lookup = parseChannelInput(input);
+        const request = {
+            part: ['snippet', 'contentDetails', 'statistics'],
+            maxResults: 1,
+            ...(lookup.kind === 'id' ? { id: [lookup.value] } : {}),
+            ...(lookup.kind === 'handle' ? { forHandle: lookup.value } : {}),
+            ...(lookup.kind === 'username' ? { forUsername: lookup.value } : {}),
+        };
+        const response = await this.client.channels.list(request);
+        const item = response.data.items?.[0];
+        if (!item) {
+            throw new Error(`No YouTube channel found for "${input}".`);
+        }
+        return mapChannel(item);
+    }
+    async listChannelVideos(channelId, pageToken) {
+        const channel = await this.resolveChannel(channelId);
+        const playlistResponse = await this.client.playlistItems.list({
+            part: ['snippet', 'contentDetails'],
+            playlistId: channel.uploadsPlaylistId,
+            maxResults: 24,
+            pageToken,
+        });
+        const videoIds = playlistResponse.data.items
+            ?.map((item) => item.contentDetails?.videoId)
+            .filter((id) => Boolean(id)) ?? [];
+        if (videoIds.length === 0) {
+            return VideoPageSchema.parse({
+                channelId,
+                videos: [],
+                nextPageToken: playlistResponse.data.nextPageToken ?? undefined,
+                prevPageToken: playlistResponse.data.prevPageToken ?? undefined,
+            });
+        }
+        const videos = await this.getVideoSummaries(videoIds);
+        return VideoPageSchema.parse({
+            channelId,
+            videos,
+            nextPageToken: playlistResponse.data.nextPageToken ?? undefined,
+            prevPageToken: playlistResponse.data.prevPageToken ?? undefined,
+        });
+    }
+    async getVideoDetails(videoId) {
+        const response = await this.client.videos.list({
+            part: ['snippet', 'contentDetails', 'statistics', 'status', 'player'],
+            id: [videoId],
+            maxResults: 1,
+        });
+        const item = response.data.items?.[0];
+        if (!item) {
+            throw new Error(`No YouTube video found for "${videoId}".`);
+        }
+        return mapVideoDetails(item);
+    }
+    async getVideoSummaries(videoIds) {
+        const response = await this.client.videos.list({
+            part: ['snippet', 'contentDetails', 'statistics', 'status'],
+            id: videoIds,
+            maxResults: videoIds.length,
+        });
+        return (response.data.items ?? []).map(mapVideoSummary);
+    }
+}
+export function parseChannelInput(input) {
+    const normalized = input.trim();
+    if (normalized === '') {
+        throw new Error('Channel input is required.');
+    }
+    const url = tryParseUrl(normalized);
+    if (url) {
+        const parts = url.pathname.split('/').filter(Boolean);
+        const first = parts[0];
+        const second = parts[1];
+        if (first === 'channel' && second)
+            return { kind: 'id', value: second };
+        if (first === 'user' && second)
+            return { kind: 'username', value: second };
+        if (first?.startsWith('@'))
+            return { kind: 'handle', value: first };
+    }
+    if (normalized.startsWith('@'))
+        return { kind: 'handle', value: normalized };
+    if (/^UC[a-zA-Z0-9_-]{20,}$/.test(normalized))
+        return { kind: 'id', value: normalized };
+    return { kind: 'handle', value: normalized };
+}
+export function parseYouTubeDuration(duration) {
+    if (!duration)
+        return 0;
+    const match = /^P(?:(\d+)D)?(?:T(?:(\d+)H)?(?:(\d+)M)?(?:(\d+)S)?)?$/.exec(duration);
+    if (!match)
+        return 0;
+    const days = Number(match[1] ?? 0);
+    const hours = Number(match[2] ?? 0);
+    const minutes = Number(match[3] ?? 0);
+    const seconds = Number(match[4] ?? 0);
+    return days * 86400 + hours * 3600 + minutes * 60 + seconds;
+}
+function tryParseUrl(input) {
+    try {
+        return new URL(input);
+    }
+    catch {
+        return null;
+    }
+}
+function mapChannel(item) {
+    const uploadsPlaylistId = item.contentDetails?.relatedPlaylists?.uploads;
+    if (!item.id || !uploadsPlaylistId) {
+        throw new Error('YouTube channel response did not include an id or uploads playlist.');
+    }
+    return ChannelSummarySchema.parse({
+        id: item.id,
+        title: item.snippet?.title ?? 'Untitled channel',
+        description: item.snippet?.description ?? '',
+        handle: item.snippet?.customUrl?.startsWith('@') ? item.snippet.customUrl : undefined,
+        customUrl: item.snippet?.customUrl ?? undefined,
+        thumbnail: mapThumbnail(item.snippet?.thumbnails),
+        uploadsPlaylistId,
+        subscriberCount: parseOptionalInt(item.statistics?.subscriberCount),
+        videoCount: parseOptionalInt(item.statistics?.videoCount),
+        viewCount: parseOptionalInt(item.statistics?.viewCount),
+    });
+}
+function mapVideoSummary(item) {
+    return VideoSummarySchema.parse({
+        id: item.id ?? '',
+        channelId: item.snippet?.channelId ?? '',
+        channelTitle: item.snippet?.channelTitle ?? '',
+        title: item.snippet?.title ?? 'Untitled video',
+        description: item.snippet?.description ?? '',
+        publishedAt: item.snippet?.publishedAt ?? '',
+        thumbnail: mapThumbnail(item.snippet?.thumbnails),
+        durationSec: parseYouTubeDuration(item.contentDetails?.duration),
+        viewCount: parseOptionalInt(item.statistics?.viewCount),
+        likeCount: parseOptionalInt(item.statistics?.likeCount),
+        commentCount: parseOptionalInt(item.statistics?.commentCount),
+        privacyStatus: item.status?.privacyStatus ?? undefined,
+    });
+}
+function mapVideoDetails(item) {
+    const summary = mapVideoSummary(item);
+    return VideoDetailsSchema.parse({
+        ...summary,
+        tags: item.snippet?.tags ?? [],
+        embedHtml: item.player?.embedHtml ?? undefined,
+    });
+}
+function mapThumbnail(thumbnails) {
+    const selected = thumbnails?.maxres ??
+        thumbnails?.standard ??
+        thumbnails?.high ??
+        thumbnails?.medium ??
+        thumbnails?.default;
+    if (!selected?.url)
+        return undefined;
+    return {
+        url: selected.url,
+        width: selected.width ?? undefined,
+        height: selected.height ?? undefined,
+    };
+}
+function parseOptionalInt(value) {
+    if (!value)
+        return undefined;
+    const parsed = Number.parseInt(value, 10);
+    return Number.isNaN(parsed) ? undefined : parsed;
+}
+//# sourceMappingURL=catalog.js.map

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

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

package/dist/{services/videoDownloader/index.d.ts → lib/services/video/source/youtube/downloader.d.ts}

@@ -1,4 +1,6 @@
-import type { RankedSegment, DownloadMode, DownloadResult } from '../../types/index.js';
+import type { RankedSegment, DownloadMode, DownloadResult } from '../../../../types/index.js';
+import type { DownloaderConfig } from '../../../../types/downloader.js';
+export type { DownloaderConfig } from '../../../../types/downloader.js';
 /**
  * Downloads a YouTube video using yt-dlp and returns the local file path.
  *
@@ -13,7 +15,7 @@ import type { RankedSegment, DownloadMode, DownloadResult } from '../../types/in
  * @returns Absolute path to the downloaded mp4 file
  * @throws {Error} if yt-dlp is not installed or the download fails
  */
-export declare function downloadFullVideo(videoId: string, customPath?: string): Promise<string>;
+export declare function downloadFullVideo(videoId: string, dlConfig: DownloaderConfig, customPath?: string): Promise<string>;
 /**
  * Downloads a YouTube video based on the specified mode.
  *
@@ -23,5 +25,5 @@ export declare function downloadFullVideo(videoId: string, customPath?: string):
  * @param customPath - Custom output directory (optional, overrides config defaults)
  * @returns Download result containing the mode and either path or paths
  */
-export declare function downloadVideo(videoId: string, mode?: DownloadMode, segments?: RankedSegment[], customPath?: string): Promise<DownloadResult>;
-//# sourceMappingURL=index.d.ts.map
+export declare function downloadVideo(videoId: string, mode: DownloadMode | undefined, segments: RankedSegment[] | undefined, dlConfig: DownloaderConfig, customPath?: string): Promise<DownloadResult>;
+//# sourceMappingURL=downloader.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"downloader.d.ts","sourceRoot":"","sources":["../../../../../../src/lib/services/video/source/youtube/downloader.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,aAAa,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AACvF,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AAEjE,YAAY,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AA+CjE;;;;;;;;;;;;;GAaG;AACH,wBAAsB,iBAAiB,CACrC,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE,gBAAgB,EAC1B,UAAU,CAAC,EAAE,MAAM,GAClB,OAAO,CAAC,MAAM,CAAC,CAqEjB;AAsJD;;;;;;;;GAQG;AACH,wBAAsB,aAAa,CACjC,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,YAAY,YAAQ,EAC1B,QAAQ,EAAE,aAAa,EAAE,YAAK,EAC9B,QAAQ,EAAE,gBAAgB,EAC1B,UAAU,CAAC,EAAE,MAAM,GAClB,OAAO,CAAC,cAAc,CAAC,CAkBzB"}

package/dist/{services/videoDownloader/index.js → lib/services/video/source/youtube/downloader.js}

@@ -2,8 +2,8 @@ import { execa } from 'execa';
 import { promises as fs } from 'fs';
 import { join } from 'path';
 import pLimit from 'p-limit';
-import { config } from '../../config/index.js';
-import { log } from '../../utils/logger.js';
+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.
@@ -16,6 +16,31 @@ function formatTimestamp(seconds) {
     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.
  *
@@ -30,8 +55,8 @@ function formatTimestamp(seconds) {
  * @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, customPath) {
-    const downloadDir = customPath || config.DOWNLOAD_DIR;
+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 {
@@ -41,32 +66,38 @@ export async function downloadFullVideo(videoId, customPath) {
     }
     catch { }
     log.info(`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 {
-        const args = [
-            '-f',
-            'bestvideo[ext=mp4]+bestaudio[ext=m4a]/best[ext=mp4]',
-            '--merge-output-format',
-            'mp4',
-            '-o',
-            outputPath,
-            '--no-playlist',
-            '--newline',
-            `https://www.youtube.com/watch?v=${videoId}`,
-        ];
-        if (config.YT_DLP_COOKIES_FROM_BROWSER) {
-            args.splice(0, 0, '--cookies-from-browser', config.YT_DLP_COOKIES_FROM_BROWSER);
-        }
-        else if (config.YT_DLP_COOKIES_FILE) {
-            args.splice(0, 0, '--cookies', config.YT_DLP_COOKIES_FILE);
-        }
-        const subprocess = execa('yt-dlp', args);
-        subprocess.stdout?.on('data', log.progress);
-        subprocess.stderr?.on('data', log.progress);
-        await subprocess;
+        await retryAsync(async () => {
+            const subprocess = execa('yt-dlp', args);
+            if (!dlConfig.quiet) {
+                subprocess.stdout?.on('data', log.progress);
+                subprocess.stderr?.on('data', log.progress);
+            }
+            await subprocess;
+        }, dlConfig.retryCount ?? 0, 2000, `yt-dlp:${videoId}`);
         process.stdout.write('\n');
     }
     catch (err) {
         const message = err instanceof Error ? err.message : String(err);
+        log.error(`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');
         }
@@ -84,11 +115,11 @@ export async function downloadFullVideo(videoId, customPath) {
 /**
  * Downloads a single segment using yt-dlp --download-sections.
  */
-async function downloadSegment(videoId, segment, index, customPath) {
-    const downloadDir = customPath || config.DOWNLOAD_DIR;
+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 + config.TIMESTAMP_OFFSET_SECONDS);
-    const adjustedEnd = Math.max(adjustedStart + 1, segment.end + config.TIMESTAMP_OFFSET_SECONDS);
+    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`);
@@ -102,10 +133,28 @@ async function downloadSegment(videoId, segment, index, customPath) {
     const endTs = formatTimestamp(adjustedEnd);
     log.info(`Downloading segment ${index + 1}: ${startTs} - ${endTs} (${segment.reason})`);
     log.info(`  Requested: ${segment.start.toFixed(2)}s - ${segment.end.toFixed(2)}s`);
-    if (config.TIMESTAMP_OFFSET_SECONDS !== 0) {
-        log.info(`  Adjusted: ${adjustedStart.toFixed(2)}s - ${adjustedEnd.toFixed(2)}s (offset: ${config.TIMESTAMP_OFFSET_SECONDS}s)`);
+    if (dlConfig.timestampOffset !== 0) {
+        log.info(`  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]',
@@ -117,22 +166,30 @@ async function downloadSegment(videoId, segment, index, customPath) {
             outputPath,
             '--no-playlist',
             '--newline',
+            ...buildSharedFlags(dlConfig),
             `https://www.youtube.com/watch?v=${videoId}`,
         ];
-        if (config.YT_DLP_COOKIES_FROM_BROWSER) {
-            args.splice(0, 0, '--cookies-from-browser', config.YT_DLP_COOKIES_FROM_BROWSER);
+        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);
+            }
         }
-        else if (config.YT_DLP_COOKIES_FILE) {
-            args.splice(0, 0, '--cookies', config.YT_DLP_COOKIES_FILE);
-        }
-        const subprocess = execa('yt-dlp', args);
-        subprocess.stdout?.on('data', log.progress);
-        subprocess.stderr?.on('data', log.progress);
-        await subprocess;
+        await retryAsync(async () => {
+            const subprocess = execa('yt-dlp', args);
+            if (!dlConfig.quiet) {
+                subprocess.stdout?.on('data', log.progress);
+                subprocess.stderr?.on('data', log.progress);
+            }
+            await subprocess;
+        }, dlConfig.retryCount ?? 0, 2000, `yt-dlp:${videoId}:seg${index + 1}`);
         process.stdout.write('\n');
     }
     catch (err) {
         const message = err instanceof Error ? err.message : String(err);
+        log.error(`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');
         }
@@ -147,15 +204,12 @@ async function downloadSegment(videoId, segment, index, customPath) {
     log.info(`Segment complete: ${outputPath}`);
     return outputPath;
 }
-/**
- * Downloads multiple segments in parallel.
- */
-async function downloadSegments(videoId, segments, customPath) {
+async function downloadSegments(videoId, segments, dlConfig, customPath) {
     if (segments.length === 0) {
         return [];
     }
-    const limit = pLimit(Math.min(config.LLM_CONCURRENCY, 3));
-    const results = await Promise.allSettled(segments.map((segment, index) => limit(() => downloadSegment(videoId, segment, index, customPath))));
+    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];
@@ -179,9 +233,9 @@ async function downloadSegments(videoId, segments, customPath) {
  * @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 = [], customPath) {
+export async function downloadVideo(videoId, mode = 'all', segments = [], dlConfig, customPath) {
     if (mode === 'all') {
-        const path = await downloadFullVideo(videoId, customPath);
+        const path = await downloadFullVideo(videoId, dlConfig, customPath);
         return { mode: 'all', path };
     }
     if (mode === 'segments') {
@@ -190,9 +244,9 @@ export async function downloadVideo(videoId, mode = 'all', segments = [], custom
             return { mode: 'segments', paths: [] };
         }
         log.info(`Downloading ${segments.length} segments in parallel...`);
-        const paths = await downloadSegments(videoId, segments, customPath);
+        const paths = await downloadSegments(videoId, segments, dlConfig, customPath);
         return { mode: 'segments', paths };
     }
     throw new Error(`Invalid download mode: ${mode}`);
 }
-//# sourceMappingURL=index.js.map
+//# 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":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,OAAO,CAAC;AAC9B,OAAO,EAAE,QAAQ,IAAI,EAAE,EAAE,MAAM,IAAI,CAAC;AACpC,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AAC5B,OAAO,MAAM,MAAM,SAAS,CAAC;AAC7B,OAAO,EAAE,GAAG,EAAE,MAAM,sBAAsB,CAAC;AAC3C,OAAO,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAC;AAMtD;;;GAGG;AACH,SAAS,eAAe,CAAC,OAAe;IACtC,MAAM,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,GAAG,IAAI,CAAC,CAAC;IACrC,MAAM,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,OAAO,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC;IAC5C,MAAM,CAAC,GAAG,OAAO,GAAG,EAAE,CAAC;IACvB,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;IAC3B,MAAM,EAAE,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,GAAG,IAAI,CAAC,CAAC;IACzC,OAAO,GAAG,MAAM,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,IAAI,MAAM,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,IAAI,MAAM,CAAC,IAAI,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,IAAI,MAAM,CAAC,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,CAAC;AACvI,CAAC;AAED;;;;;GAKG;AACH,SAAS,gBAAgB,CAAC,QAA0B;IAClD,MAAM,KAAK,GAAa,EAAE,CAAC;IAE3B,IAAI,QAAQ,CAAC,YAAY,IAAI,QAAQ,CAAC,YAAY,KAAK,MAAM,EAAE,CAAC;QAC9D,KAAK,CAAC,IAAI,CAAC,kBAAkB,EAAE,yBAAyB,QAAQ,CAAC,YAAY,EAAE,CAAC,CAAC;IACnF,CAAC;IAED,IAAI,QAAQ,CAAC,mBAAmB,EAAE,CAAC;QACjC,KAAK,CAAC,IAAI,CAAC,yBAAyB,CAAC,CAAC;IACxC,CAAC;IAED,IAAI,QAAQ,CAAC,SAAS,EAAE,CAAC;QACvB,KAAK,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC;IAC7B,CAAC;IAED,IAAI,QAAQ,CAAC,SAAS,EAAE,CAAC;QACvB,KAAK,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC;IAC7B,CAAC;IAED,IAAI,QAAQ,CAAC,aAAa,IAAI,QAAQ,CAAC,aAAa,GAAG,CAAC,EAAE,CAAC;QACzD,KAAK,CAAC,IAAI,CAAC,kBAAkB,EAAE,MAAM,CAAC,QAAQ,CAAC,aAAa,CAAC,CAAC,CAAC;IACjE,CAAC;IAED,OAAO,KAAK,CAAC;AACf,CAAC;AAED;;;;;;;;;;;;;GAaG;AACH,MAAM,CAAC,KAAK,UAAU,iBAAiB,CACrC,OAAe,EACf,QAA0B,EAC1B,UAAmB;IAEnB,MAAM,WAAW,GAAG,UAAU,IAAI,QAAQ,CAAC,WAAW,CAAC;IACvD,MAAM,EAAE,CAAC,KAAK,CAAC,WAAW,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAEjD,MAAM,UAAU,GAAG,IAAI,CAAC,WAAW,EAAE,GAAG,OAAO,MAAM,CAAC,CAAC;IAEvD,IAAI,CAAC;QACH,MAAM,EAAE,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC;QAC5B,GAAG,CAAC,IAAI,CAAC,6BAA6B,UAAU,EAAE,CAAC,CAAC;QACpD,OAAO,UAAU,CAAC;IACpB,CAAC;IAAC,MAAM,CAAC,CAAA,CAAC;IAEV,GAAG,CAAC,IAAI,CAAC,0BAA0B,OAAO,gBAAgB,CAAC,CAAC;IAE5D,MAAM,IAAI,GAAG;QACX,IAAI;QACJ,qDAAqD;QACrD,uBAAuB;QACvB,KAAK;QACL,IAAI;QACJ,UAAU;QACV,eAAe;QACf,WAAW;QACX,GAAG,gBAAgB,CAAC,QAAQ,CAAC;QAC7B,mCAAmC,OAAO,EAAE;KAC7C,CAAC;IAEF,IAAI,QAAQ,CAAC,kBAAkB,EAAE,CAAC;QAChC,IAAI,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC,EAAE,wBAAwB,EAAE,QAAQ,CAAC,kBAAkB,CAAC,CAAC;IAC3E,CAAC;SAAM,IAAI,QAAQ,CAAC,WAAW,EAAE,CAAC;QAChC,IAAI,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC,EAAE,WAAW,EAAE,QAAQ,CAAC,WAAW,CAAC,CAAC;IACvD,CAAC;IAED,IAAI,CAAC;QACH,MAAM,UAAU,CACd,KAAK,IAAI,EAAE;YACT,MAAM,UAAU,GAAG,KAAK,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC;YACzC,IAAI,CAAC,QAAQ,CAAC,KAAK,EAAE,CAAC;gBACpB,UAAU,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,EAAE,GAAG,CAAC,QAAQ,CAAC,CAAC;gBAC5C,UAAU,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,EAAE,GAAG,CAAC,QAAQ,CAAC,CAAC;YAC9C,CAAC;YACD,MAAM,UAAU,CAAC;QACnB,CAAC,EACD,QAAQ,CAAC,UAAU,IAAI,CAAC,EACxB,IAAI,EACJ,UAAU,OAAO,EAAE,CACpB,CAAC;QACF,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAC7B,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,KAAK,CAAC,0BAA0B,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QAEnD,IAAI,OAAO,CAAC,QAAQ,CAAC,mBAAmB,CAAC,IAAI,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC;YACxE,MAAM,IAAI,KAAK,CAAC,kEAAkE,CAAC,CAAC;QACtF,CAAC;QAED,IAAI,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAC,IAAI,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAC,EAAE,CAAC;YACrE,MAAM,IAAI,KAAK,CAAC,UAAU,OAAO,wCAAwC,CAAC,CAAC;QAC7E,CAAC;QAED,IAAI,OAAO,CAAC,QAAQ,CAAC,+BAA+B,CAAC,IAAI,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;YACjF,MAAM,IAAI,KAAK,CAAC,UAAU,OAAO,kCAAkC,CAAC,CAAC;QACvE,CAAC;QAED,MAAM,IAAI,KAAK,CAAC,oBAAoB,OAAO,EAAE,CAAC,CAAC;IACjD,CAAC;IAED,GAAG,CAAC,IAAI,CAAC,sBAAsB,UAAU,EAAE,CAAC,CAAC;IAC7C,OAAO,UAAU,CAAC;AACpB,CAAC;AAED;;GAEG;AACH,KAAK,UAAU,eAAe,CAC5B,OAAe,EACf,OAAsB,EACtB,KAAa,EACb,QAA0B,EAC1B,UAAmB;IAEnB,MAAM,WAAW,GAAG,UAAU,IAAI,QAAQ,CAAC,WAAW,CAAC;IACvD,MAAM,EAAE,CAAC,KAAK,CAAC,WAAW,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAEjD,MAAM,aAAa,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,OAAO,CAAC,KAAK,GAAG,QAAQ,CAAC,eAAe,CAAC,CAAC;IAC5E,MAAM,WAAW,GAAG,IAAI,CAAC,GAAG,CAAC,aAAa,GAAG,CAAC,EAAE,OAAO,CAAC,GAAG,GAAG,QAAQ,CAAC,eAAe,CAAC,CAAC;IACxF,MAAM,QAAQ,GAAG,IAAI,CAAC,KAAK,CAAC,aAAa,CAAC,CAAC;IAC3C,MAAM,MAAM,GAAG,IAAI,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;IACtC,MAAM,UAAU,GAAG,IAAI,CAAC,WAAW,EAAE,GAAG,OAAO,IAAI,QAAQ,IAAI,MAAM,MAAM,CAAC,CAAC;IAE7E,IAAI,CAAC;QACH,MAAM,EAAE,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC;QAC5B,GAAG,CAAC,IAAI,CAAC,WAAW,KAAK,GAAG,CAAC,IAAI,KAAK,wBAAwB,UAAU,EAAE,CAAC,CAAC;QAC5E,OAAO,UAAU,CAAC;IACpB,CAAC;IAAC,MAAM,CAAC,CAAA,CAAC;IAEV,MAAM,OAAO,GAAG,eAAe,CAAC,aAAa,CAAC,CAAC;IAC/C,MAAM,KAAK,GAAG,eAAe,CAAC,WAAW,CAAC,CAAC;IAE3C,GAAG,CAAC,IAAI,CAAC,uBAAuB,KAAK,GAAG,CAAC,KAAK,OAAO,MAAM,KAAK,KAAK,OAAO,CAAC,MAAM,GAAG,CAAC,CAAC;IACxF,GAAG,CAAC,IAAI,CAAC,gBAAgB,OAAO,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,OAAO,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;IACnF,IAAI,QAAQ,CAAC,eAAe,KAAK,CAAC,EAAE,CAAC;QACnC,GAAG,CAAC,IAAI,CACN,eAAe,aAAa,CAAC,OAAO,CAAC,CAAC,CAAC,OAAO,WAAW,CAAC,OAAO,CAAC,CAAC,CAAC,cAAc,QAAQ,CAAC,eAAe,IAAI,CAC/G,CAAC;IACJ,CAAC;IAED,IAAI,CAAC;QACH,8DAA8D;QAC9D,EAAE;QACF,wEAAwE;QACxE,0EAA0E;QAC1E,6EAA6E;QAC7E,6EAA6E;QAC7E,yEAAyE;QACzE,EAAE;QACF,uEAAuE;QACvE,sEAAsE;QACtE,2EAA2E;QAC3E,uDAAuD;QACvD,EAAE;QACF,wEAAwE;QACxE,wEAAwE;QACxE,yEAAyE;QACzE,4EAA4E;QAC5E,2EAA2E;QAC3E,MAAM,IAAI,GAAG;YACX,IAAI;YACJ,qDAAqD;YACrD,uBAAuB;YACvB,KAAK;YACL,qBAAqB;YACrB,IAAI,OAAO,IAAI,KAAK,EAAE;YACtB,IAAI;YACJ,UAAU;YACV,eAAe;YACf,WAAW;YACX,GAAG,gBAAgB,CAAC,QAAQ,CAAC;YAC7B,mCAAmC,OAAO,EAAE;SAC7C,CAAC;QAEF,IAAI,QAAQ,CAAC,qBAAqB,EAAE,CAAC;YACnC,IAAI,QAAQ,CAAC,kBAAkB,EAAE,CAAC;gBAChC,IAAI,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC,EAAE,wBAAwB,EAAE,QAAQ,CAAC,kBAAkB,CAAC,CAAC;YAC3E,CAAC;iBAAM,IAAI,QAAQ,CAAC,WAAW,EAAE,CAAC;gBAChC,IAAI,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC,EAAE,WAAW,EAAE,QAAQ,CAAC,WAAW,CAAC,CAAC;YACvD,CAAC;QACH,CAAC;QAED,MAAM,UAAU,CACd,KAAK,IAAI,EAAE;YACT,MAAM,UAAU,GAAG,KAAK,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC;YACzC,IAAI,CAAC,QAAQ,CAAC,KAAK,EAAE,CAAC;gBACpB,UAAU,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,EAAE,GAAG,CAAC,QAAQ,CAAC,CAAC;gBAC5C,UAAU,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,EAAE,GAAG,CAAC,QAAQ,CAAC,CAAC;YAC9C,CAAC;YACD,MAAM,UAAU,CAAC;QACnB,CAAC,EACD,QAAQ,CAAC,UAAU,IAAI,CAAC,EACxB,IAAI,EACJ,UAAU,OAAO,OAAO,KAAK,GAAG,CAAC,EAAE,CACpC,CAAC;QACF,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAC7B,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,KAAK,CAAC,WAAW,KAAK,GAAG,CAAC,qBAAqB,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QAClE,IAAI,OAAO,CAAC,QAAQ,CAAC,mBAAmB,CAAC,IAAI,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC;YACxE,MAAM,IAAI,KAAK,CAAC,kEAAkE,CAAC,CAAC;QACtF,CAAC;QAED,IAAI,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAC,IAAI,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAC,EAAE,CAAC;YACrE,MAAM,IAAI,KAAK,CAAC,UAAU,OAAO,wCAAwC,CAAC,CAAC;QAC7E,CAAC;QAED,IAAI,OAAO,CAAC,QAAQ,CAAC,+BAA+B,CAAC,IAAI,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;YACjF,MAAM,IAAI,KAAK,CAAC,UAAU,OAAO,kCAAkC,CAAC,CAAC;QACvE,CAAC;QAED,MAAM,IAAI,KAAK,CAAC,4BAA4B,OAAO,EAAE,CAAC,CAAC;IACzD,CAAC;IAED,GAAG,CAAC,IAAI,CAAC,qBAAqB,UAAU,EAAE,CAAC,CAAC;IAC5C,OAAO,UAAU,CAAC;AACpB,CAAC;AAED,KAAK,UAAU,gBAAgB,CAC7B,OAAe,EACf,QAAyB,EACzB,QAA0B,EAC1B,UAAmB;IAEnB,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC1B,OAAO,EAAE,CAAC;IACZ,CAAC;IAED,MAAM,KAAK,GAAG,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC,cAAc,EAAE,CAAC,CAAC,CAAC,CAAC;IAC3D,MAAM,OAAO,GAAwC,MAAM,OAAO,CAAC,UAAU,CAC3E,QAAQ,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,KAAK,EAAE,EAAE,CAC9B,KAAK,CAAC,GAAG,EAAE,CAAC,eAAe,CAAC,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,QAAQ,EAAE,UAAU,CAAC,CAAC,CAC5E,CACF,CAAC;IAEF,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACxC,MAAM,MAAM,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;QAC1B,MAAM,OAAO,GAAG,QAAQ,CAAC,CAAC,CAAC,CAAC;QAC5B,IAAI,MAAM,CAAC,MAAM,KAAK,WAAW,EAAE,CAAC;YAClC,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QAC3B,CAAC;aAAM,CAAC;YACN,MAAM,MAAM,GAAG,MAAM,CAAC,MAAM,YAAY,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;YAC9F,GAAG,CAAC,IAAI,CACN,+BAA+B,eAAe,CAAC,OAAO,CAAC,KAAK,CAAC,MAAM,eAAe,CAAC,OAAO,CAAC,GAAG,CAAC,WAAW,OAAO,CAAC,IAAI,MAAM,MAAM,EAAE,CACrI,CAAC;QACJ,CAAC;IACH,CAAC;IAED,OAAO,KAAK,CAAC;AACf,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,CAAC,KAAK,UAAU,aAAa,CACjC,OAAe,EACf,OAAqB,KAAK,EAC1B,WAA4B,EAAE,EAC9B,QAA0B,EAC1B,UAAmB;IAEnB,IAAI,IAAI,KAAK,KAAK,EAAE,CAAC;QACnB,MAAM,IAAI,GAAG,MAAM,iBAAiB,CAAC,OAAO,EAAE,QAAQ,EAAE,UAAU,CAAC,CAAC;QACpE,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC;IAC/B,CAAC;IAED,IAAI,IAAI,KAAK,UAAU,EAAE,CAAC;QACxB,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC1B,GAAG,CAAC,IAAI,CAAC,qEAAqE,CAAC,CAAC;YAChF,OAAO,EAAE,IAAI,EAAE,UAAU,EAAE,KAAK,EAAE,EAAE,EAAE,CAAC;QACzC,CAAC;QAED,GAAG,CAAC,IAAI,CAAC,eAAe,QAAQ,CAAC,MAAM,0BAA0B,CAAC,CAAC;QACnE,MAAM,KAAK,GAAG,MAAM,gBAAgB,CAAC,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAE,UAAU,CAAC,CAAC;QAC9E,OAAO,EAAE,IAAI,EAAE,UAAU,EAAE,KAAK,EAAE,CAAC;IACrC,CAAC;IAED,MAAM,IAAI,KAAK,CAAC,0BAA0B,IAAI,EAAE,CAAC,CAAC;AACpD,CAAC"}

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;AAkE7D;;;;;;;;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,
@@ -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...`);
     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;AAMtD,MAAM,UAAU,GAAG,gCAAgC,CAAC;AAWpD,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,sBAAsB,OAAO,MAAM,OAAO,EAAE,CAAC,CAAC;QACvD,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,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,sBAAsB,OAAO,8BAA8B,CAAC,CAAC;IACtE,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,61 @@
+import type { TranscriptLine } from '../../../../types/transcript.js';
+import { TranscriptAnalyzer } from '../../../audio/transcriber/base.js';
+import type { YtDlpCookies } from '../../../../types/downloader.js';
+interface YouTubeCaptionTrack {
+    baseUrl: string;
+    kind?: string;
+    languageCode: string;
+}
+interface YouTubePlayerResponse {
+    playabilityStatus?: {
+        status?: string;
+        reason?: string;
+        errorScreen?: {
+            playerErrorMessageRenderer?: {
+                reason?: {
+                    simpleText?: string;
+                };
+                subreason?: {
+                    simpleText?: string;
+                    runs?: Array<{
+                        text?: string;
+                    }>;
+                };
+            };
+        };
+    };
+    captions?: {
+        playerCaptionsTracklistRenderer?: {
+            captionTracks?: YouTubeCaptionTrack[];
+        };
+    };
+}
+/**
+ * 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[]>;
+}
+export {};
+//# sourceMappingURL=subtitles.d.ts.map