youtube-knowledge-mcp 2.1.0 → 3.0.0

package/dist/utils/youtube.js

@@ -1,489 +1,14 @@
-import { join } from 'path';
-import { z } from 'zod';
-import { mkdir, readFile, writeFile, unlink } from 'fs/promises';
-import { existsSync, readdirSync } from 'fs';
-import { formatYouTubeDate } from './format.js';
-import { YouTubeError, classifyPlayability } from './errors.js';
-import { TIMEOUTS, isRecord, parseYtDlpJson, parseYtDlpJsonLines, runYtDlp } from './ytdlp.js';
-import { assertLanguageTag, resolveOutputDir } from './validate.js';
-import { log } from './context.js';
-import { dataDir } from './paths.js';
-import { TRANSCRIPT_CACHE_VERSION, cachedTranscriptSchema, parseVtt, segmentsToText, } from './transcript.js';
-const CACHE_DIR = dataDir('transcripts');
 /**
- * yt-dlp's search rows. Only `id` is required — the rest are absent often
- * enough (age-gated entries, deleted uploads still in the index) that treating
- * them as guaranteed is what produced `undefined` in rendered output.
+ * Everything the server knows how to ask YouTube.
+ *
+ * This is a barrel: the implementation lives in one module per concern so each
+ * stays small enough to hold in view. Consumers import from here, so a module
+ * can move without every tool and test that uses it having to follow.
  */
-const searchResultSchema = z.object({
-    id: z.string(),
-    title: z.string().optional(),
-    duration: z.number().optional(),
-    channel: z.string().optional(),
-    view_count: z.number().optional(),
-    url: z.string().optional(),
-});
-function isSearchResult(value) {
-    return searchResultSchema.safeParse(value).success;
-}
-export function extractVideoId(urlOrId) {
-    // If it's already an ID (11 characters, no special chars except - and _)
-    if (/^[a-zA-Z0-9_-]{11}$/.test(urlOrId)) {
-        return urlOrId;
-    }
-    // Try to extract from URL
-    const patterns = [
-        /(?:youtube\.com\/watch\?v=|youtu\.be\/|youtube\.com\/embed\/|youtube\.com\/v\/)([a-zA-Z0-9_-]{11})/,
-        /(?:youtube\.com\/shorts\/)([a-zA-Z0-9_-]{11})/,
-    ];
-    for (const pattern of patterns) {
-        const match = pattern.exec(urlOrId);
-        if (match?.[1] !== undefined) {
-            return match[1];
-        }
-    }
-    throw new Error(`Could not extract video ID from: ${urlOrId}`);
-}
-function formatDuration(seconds) {
-    const hours = Math.floor(seconds / 3600);
-    const minutes = Math.floor((seconds % 3600) / 60);
-    const secs = seconds % 60;
-    if (hours > 0) {
-        return `${hours}:${minutes.toString().padStart(2, '0')}:${secs.toString().padStart(2, '0')}`;
-    }
-    return `${minutes}:${secs.toString().padStart(2, '0')}`;
-}
-export async function getVideoInfo(urlOrId) {
-    const videoId = extractVideoId(urlOrId);
-    const url = `https://www.youtube.com/watch?v=${videoId}`;
-    const stdout = await runYtDlp([
-        '--skip-download',
-        // Without this, a video YouTube refuses to serve aborts extraction and the
-        // only thing left to read is YouTube's localised refusal text. With it,
-        // yt-dlp downgrades that abort to a warning and still fills in the
-        // structured fields, so the reason can be read from `availability` and
-        // `live_status` instead of guessed at from prose.
-        '--ignore-no-formats-error',
-        '--print',
-        '%(id)s|||%(title)s|||%(channel)s|||%(duration)s|||%(upload_date)s|||%(description)s|||%(tags)j|||%(thumbnail)s|||%(view_count)s|||%(like_count)s|||%(comment_count)s|||%(availability)s|||%(live_status)s',
-        url,
-    ], { label: 'get_video_info' });
-    // yt-dlp prints "NA" for absent fields and simply omits trailing ones, so
-    // index access has to tolerate a short row rather than trust its length.
-    const parts = stdout.split('|||');
-    const field = (index) => parts[index] ?? '';
-    // Refusals reach us as a populated row rather than a failure, so this is the
-    // point at which one becomes a typed error.
-    const refusal = classifyPlayability({ availability: field(11), liveStatus: field(12) });
-    if (refusal)
-        throw refusal;
-    const [id, title, channel, durationStr, uploadDate, description, tagsJson, thumbnailUrl] = [
-        field(0),
-        field(1),
-        field(2),
-        field(3),
-        field(4),
-        field(5),
-        field(6),
-        field(7),
-    ];
-    const duration = parseInt(durationStr, 10) || 0;
-    let tags = [];
-    try {
-        const parsedTags = JSON.parse(tagsJson || '[]');
-        if (Array.isArray(parsedTags)) {
-            tags = parsedTags.filter((t) => typeof t === 'string');
-        }
-    }
-    catch {
-        tags = [];
-    }
-    return {
-        id,
-        title,
-        channel,
-        duration,
-        durationFormatted: formatDuration(duration),
-        uploadDate: formatYouTubeDate(uploadDate),
-        description: description || '',
-        tags,
-        url,
-        thumbnailUrl: thumbnailUrl || '',
-        viewCount: parseInt(field(8), 10) || 0,
-        likeCount: parseInt(field(9), 10) || 0,
-        commentCount: parseInt(field(10), 10) || 0,
-    };
-}
-export async function listVideos(urlOrChannel, limit = 20) {
-    const stdout = await runYtDlp([
-        '--skip-download',
-        '--flat-playlist',
-        '--print',
-        '%(id)s|||%(title)s|||%(duration)s|||%(upload_date)s',
-        '--playlist-end',
-        limit.toString(),
-        urlOrChannel,
-    ], { label: 'fetch_videos', timeoutMs: TIMEOUTS.transcript });
-    const lines = stdout.trim().split('\n').filter(Boolean);
-    return lines.map((line) => {
-        const parts = line.split('|||');
-        const field = (index) => parts[index] ?? '';
-        const id = field(0);
-        const duration = parseInt(field(2), 10) || 0;
-        return {
-            id,
-            title: field(1) || 'Unknown title',
-            duration,
-            durationFormatted: formatDuration(duration),
-            uploadDate: formatYouTubeDate(field(3)),
-            url: `https://www.youtube.com/watch?v=${id}`,
-        };
-    });
-}
-/** Captions rarely change, but a cache with no expiry is a cache that goes wrong. */
-const TRANSCRIPT_TTL_MS = Number(process.env.YOUTUBE_MCP_TRANSCRIPT_TTL_MS ?? 30 * 86_400_000);
-function cachePath(videoId, language) {
-    return join(CACHE_DIR, `${videoId}.${language}.json`);
-}
-async function readCachedTranscript(videoId, language) {
-    const path = cachePath(videoId, language);
-    if (!existsSync(path))
-        return undefined;
-    try {
-        const parsed = cachedTranscriptSchema.safeParse(JSON.parse(await readFile(path, 'utf-8')));
-        // Anything unreadable — an older layout, a truncated write, a hand-edit —
-        // is treated as absent and refetched, rather than half-trusted.
-        if (!parsed.success)
-            return undefined;
-        const cached = parsed.data;
-        // A cache written by an older version holds untimed text; regenerate it
-        // rather than reading it back as if it had timings.
-        if (cached.version !== TRANSCRIPT_CACHE_VERSION)
-            return undefined;
-        const fetchedAt = Date.parse(cached.fetchedAt);
-        if (Number.isFinite(fetchedAt) && Date.now() - fetchedAt > TRANSCRIPT_TTL_MS)
-            return undefined;
-        return cached;
-    }
-    catch {
-        return undefined;
-    }
-}
-/** True when a usable transcript is already on disk, in any language. */
-export function hasCachedTranscript(videoId) {
-    if (!existsSync(CACHE_DIR))
-        return false;
-    return readdirSync(CACHE_DIR).some((name) => name.startsWith(`${videoId}.`) && name.endsWith('.json'));
-}
-export async function getTranscript(urlOrId, preferredLangOrOptions = 'en') {
-    const options = typeof preferredLangOrOptions === 'string'
-        ? { language: preferredLangOrOptions }
-        : preferredLangOrOptions;
-    const preferredLang = options.language ?? 'en';
-    const videoId = extractVideoId(urlOrId);
-    assertLanguageTag(preferredLang);
-    const url = `https://www.youtube.com/watch?v=${videoId}`;
-    await mkdir(CACHE_DIR, { recursive: true });
-    if (!options.refresh) {
-        const cached = await readCachedTranscript(videoId, preferredLang);
-        if (cached) {
-            return {
-                transcript: segmentsToText(cached.segments),
-                segments: cached.segments,
-                language: cached.language,
-                videoId,
-                cached: true,
-            };
-        }
-    }
-    const tempDir = join(CACHE_DIR, 'temp');
-    await mkdir(tempDir, { recursive: true });
-    const outputTemplate = join(tempDir, videoId);
-    try {
-        await runYtDlp([
-            '--skip-download',
-            '--write-auto-sub',
-            '--write-sub',
-            '--sub-lang',
-            `${preferredLang},${preferredLang}-orig`,
-            '--sub-format',
-            'vtt',
-            '--convert-subs',
-            'vtt',
-            '-o',
-            outputTemplate,
-            url,
-        ], { label: 'get_transcript', timeoutMs: TIMEOUTS.transcript });
-        const candidates = [
-            { file: `${outputTemplate}.${preferredLang}.vtt`, language: preferredLang },
-            {
-                file: `${outputTemplate}.${preferredLang}-orig.vtt`,
-                language: `${preferredLang} (auto-generated)`,
-            },
-            { file: `${outputTemplate}.en.vtt`, language: 'en' },
-        ];
-        const found = candidates.find((candidate) => existsSync(candidate.file));
-        if (!found)
-            throw await noCaptionsError(url, preferredLang);
-        const segments = parseVtt(await readFile(found.file, 'utf-8'));
-        if (segments.length === 0)
-            throw await noCaptionsError(url, preferredLang);
-        const entry = {
-            version: TRANSCRIPT_CACHE_VERSION,
-            videoId,
-            language: found.language,
-            fetchedAt: new Date().toISOString(),
-            segments,
-        };
-        await writeFile(cachePath(videoId, preferredLang), JSON.stringify(entry), 'utf-8');
-        await unlink(found.file).catch(() => undefined);
-        return {
-            transcript: segmentsToText(segments),
-            segments,
-            language: found.language,
-            videoId,
-            cached: false,
-        };
-    }
-    catch (error) {
-        // Already typed and actionable — pass it through rather than flattening it
-        // into a generic string, which is what the old wrapper did to every failure.
-        if (error instanceof YouTubeError)
-            throw error;
-        throw new YouTubeError('YTDLP_FAILED', `Could not read the transcript for ${videoId}.`, {
-            nextStep: 'Verify the video exists and has captions, or call check_health.',
-            cause: error,
-        });
-    }
-}
-/**
- * Ask yt-dlp which caption tracks the video actually has, so the error can name
- * the languages that would work instead of just saying "not found".
- */
-async function noCaptionsError(url, requested) {
-    let available = [];
-    try {
-        const stdout = await runYtDlp(['-j', '--skip-download', url], {
-            label: 'get_transcript (caption probe)',
-        });
-        const data = parseYtDlpJson(stdout, isRecord, 'caption tracks');
-        available = [
-            ...Object.keys(data.subtitles ?? {}),
-            ...Object.keys(data.automatic_captions ?? {}),
-        ]
-            .filter((code) => !code.endsWith('-orig'))
-            .filter((code, index, all) => all.indexOf(code) === index)
-            .sort();
-    }
-    catch {
-        // The probe is a nicety; never let it mask the original problem.
-    }
-    if (available.length === 0) {
-        return new YouTubeError('NO_CAPTIONS', 'This video has no captions in any language.', {
-            nextStep: 'Try get_video_info for the description, or get_comments for viewer discussion instead.',
-        });
-    }
-    const shown = available.slice(0, 25).join(', ');
-    const more = available.length > 25 ? `, and ${available.length - 25} more` : '';
-    return new YouTubeError('NO_CAPTIONS', `No "${requested}" captions are available for this video.`, { nextStep: `Call get_transcript again with one of: ${shown}${more}.` });
-}
-const DOWNLOADS_DIR = dataDir('downloads');
-export async function listFormats(urlOrId) {
-    const videoId = extractVideoId(urlOrId);
-    const url = `https://www.youtube.com/watch?v=${videoId}`;
-    const stdout = await runYtDlp(['-j', '--skip-download', url], { label: 'list_formats' });
-    const data = parseYtDlpJson(stdout, isRecord, 'video formats');
-    const formats = data.formats ?? [];
-    return formats
-        .filter((f) => !f.format_id.startsWith('sb')) // skip storyboards
-        .map((f) => {
-        const resolution = f.resolution ?? (f.width && f.height ? `${f.width}x${f.height}` : 'audio only');
-        return {
-            formatId: f.format_id,
-            ext: f.ext,
-            resolution,
-            fps: f.fps,
-            vcodec: f.vcodec ?? 'none',
-            acodec: f.acodec ?? 'none',
-            filesize: f.filesize ?? f.filesize_approx,
-            note: f.format_note ?? '',
-        };
-    });
-}
-// Smart format selectors that use yt-dlp's fallback syntax
-const QUALITY_FORMAT_SELECTORS = {
-    best: 'bestvideo*+bestaudio/best',
-    '2160p': 'bestvideo[height<=2160]+bestaudio/bestvideo*[height<=2160]+bestaudio/best[height<=2160]/bestvideo+bestaudio/best',
-    '1440p': 'bestvideo[height<=1440]+bestaudio/bestvideo*[height<=1440]+bestaudio/best[height<=1440]/bestvideo+bestaudio/best',
-    '1080p': 'bestvideo[height<=1080]+bestaudio/bestvideo*[height<=1080]+bestaudio/best[height<=1080]/bestvideo+bestaudio/best',
-    '720p': 'bestvideo[height<=720]+bestaudio/bestvideo*[height<=720]+bestaudio/best[height<=720]/bestvideo+bestaudio/best',
-    '480p': 'bestvideo[height<=480]+bestaudio/bestvideo*[height<=480]+bestaudio/best[height<=480]/bestvideo+bestaudio/best',
-    '360p': 'bestvideo[height<=360]+bestaudio/bestvideo*[height<=360]+bestaudio/best[height<=360]/bestvideo+bestaudio/best',
-    audio: 'bestaudio/best',
-};
-export async function downloadVideo(urlOrId, formatId, outputDir, quality) {
-    const videoId = extractVideoId(urlOrId);
-    const url = `https://www.youtube.com/watch?v=${videoId}`;
-    const targetDir = resolveOutputDir(outputDir, DOWNLOADS_DIR);
-    // Ensure download directory exists
-    await mkdir(targetDir, { recursive: true });
-    // Get video title first for the result
-    const titleOutput = await runYtDlp(['--skip-download', '--print', '%(title)s', url], {
-        label: 'download_video (title)',
-    });
-    const title = titleOutput.trim();
-    // Download with specified format
-    const outputTemplate = join(targetDir, '%(title)s.%(ext)s');
-    // A quality preset always wins over formatId; that is what the tool schema
-    // promises, and the two are resolved in exactly one place.
-    const formatSelector = quality ? QUALITY_FORMAT_SELECTORS[quality] : formatId;
-    // -S vcodec:h264,acodec:m4a prefers H.264+AAC, which merge cleanly into MP4.
-    const commonArgs = (selector) => [
-        '-f',
-        selector,
-        '-S',
-        'vcodec:h264,acodec:m4a',
-        '-o',
-        outputTemplate,
-        '--no-playlist',
-        '--merge-output-format',
-        'mp4',
-    ];
-    // Transfers are not retried automatically: a partial file on disk plus a
-    // silent second attempt is worse than one clear failure.
-    const downloadOptions = {
-        label: 'download_video',
-        timeoutMs: TIMEOUTS.download,
-        retry: false,
-    };
-    let effectiveSelector = formatSelector;
-    try {
-        await runYtDlp([...commonArgs(formatSelector), url], downloadOptions);
-    }
-    catch (error) {
-        // An explicitly requested format may simply not exist for this video, so
-        // falling back to "best" is worth one attempt. A preset failing is not:
-        // presets already encode their own fallback chain, and "best" failing
-        // leaves nothing to fall back to.
-        const alreadyBroadest = quality !== undefined || formatId === 'best';
-        if (alreadyBroadest)
-            throw error;
-        log('warning', `format ${formatId} unavailable, falling back to best`);
-        effectiveSelector = QUALITY_FORMAT_SELECTORS.best;
-        await runYtDlp([...commonArgs(effectiveSelector), url], downloadOptions);
-    }
-    // Ask yt-dlp what it actually named the file rather than guessing.
-    const filenameOutput = await runYtDlp([...commonArgs(effectiveSelector), '--print', 'filename', '--skip-download', url], { label: 'download_video (filename)' });
-    return {
-        videoId,
-        title,
-        filePath: filenameOutput.trim(),
-        format: quality ?? formatId,
-    };
-}
-export async function searchVideos(query, limit = 5) {
-    const stdout = await runYtDlp([`ytsearch${limit}:${query}`, '--dump-json', '--flat-playlist'], {
-        label: 'search_videos',
-    });
-    return parseYtDlpJsonLines(stdout, isSearchResult).map((data) => {
-        return {
-            id: data.id,
-            title: data.title ?? 'Unknown',
-            duration: data.duration ?? 0,
-            durationFormatted: formatDuration(data.duration ?? 0),
-            channel: data.channel ?? 'Unknown',
-            viewCount: data.view_count ?? 0,
-            url: data.url ?? `https://www.youtube.com/watch?v=${data.id}`,
-        };
-    });
-}
-export async function getChapters(urlOrId) {
-    return (await getVideoDetails(urlOrId)).chapters;
-}
-export async function getVideoDetails(urlOrId) {
-    const videoId = extractVideoId(urlOrId);
-    const url = `https://www.youtube.com/watch?v=${videoId}`;
-    const stdout = await runYtDlp(['-j', '--skip-download', url], { label: 'get_video_details' });
-    const data = parseYtDlpJson(stdout, isRecord, 'video details');
-    return {
-        uploadDate: formatYouTubeDate(data.upload_date ?? ''),
-        durationSeconds: typeof data.duration === 'number' ? data.duration : 0,
-        chapters: (data.chapters ?? []).map((ch) => ({
-            title: ch.title,
-            startTime: ch.start_time,
-            startTimeFormatted: formatDuration(Math.floor(ch.start_time)),
-            endTime: ch.end_time,
-            endTimeFormatted: formatDuration(Math.floor(ch.end_time)),
-        })),
-    };
-}
-export async function getComments(urlOrId, limit = 20) {
-    const videoId = extractVideoId(urlOrId);
-    const url = `https://www.youtube.com/watch?v=${videoId}`;
-    const stdout = await runYtDlp([
-        '-j',
-        '--skip-download',
-        '--write-comments',
-        '--extractor-args',
-        `youtube:comment_sort=top;max_comments=${limit}`,
-        url,
-    ], { label: 'get_comments', timeoutMs: TIMEOUTS.comments });
-    const data = parseYtDlpJson(stdout, isRecord, 'video comments');
-    const comments = data.comments ?? [];
-    return comments
-        .filter((c) => c.parent === 'root')
-        .slice(0, limit)
-        .map((c) => ({
-        author: c.author ?? 'Unknown',
-        text: c.text ?? '',
-        likeCount: c.like_count ?? 0,
-        isPinned: c.is_pinned ?? false,
-    }));
-}
-export async function searchChannels(query, limit = 5) {
-    // YouTube channel filter: sp=EgIQAg%3D%3D
-    const searchUrl = `https://www.youtube.com/results?search_query=${encodeURIComponent(query)}&sp=EgIQAg%3D%3D`;
-    const stdout = await runYtDlp([searchUrl, '--dump-json', '--flat-playlist', '--playlist-items', `1-${limit}`], { label: 'search_channels' });
-    return parseYtDlpJsonLines(stdout, isRecord).map((data) => {
-        return {
-            name: data.channel ?? data.title ?? 'Unknown',
-            channelId: data.channel_id ?? data.id ?? '',
-            handle: data.uploader_id ?? '',
-            subscriberCount: data.channel_follower_count ?? 0,
-            channelUrl: data.channel_url ?? '',
-            description: data.description ?? '',
-        };
-    });
-}
-export async function getPlaylistInfo(playlistUrl) {
-    const stdout = await runYtDlp(['--dump-single-json', '--flat-playlist', '--playlist-items', '0', playlistUrl], { label: 'get_playlist_info' });
-    const data = parseYtDlpJson(stdout, isRecord, 'playlist metadata');
-    const modDate = data.modified_date ?? '';
-    return {
-        id: data.id ?? '',
-        title: data.title ?? 'Unknown',
-        channel: data.channel ?? '',
-        handle: data.uploader_id ?? '',
-        channelUrl: data.channel_url ?? '',
-        videoCount: data.playlist_count ?? 0,
-        lastModified: formatYouTubeDate(modDate),
-        url: data.webpage_url ?? playlistUrl,
-        description: data.description ?? '',
-    };
-}
-export async function getChannelInfo(channel) {
-    const channelUrl = channel.startsWith('http')
-        ? channel
-        : `https://www.youtube.com/${channel.startsWith('@') ? channel : `@${channel}`}`;
-    const stdout = await runYtDlp(['--dump-single-json', '--flat-playlist', '--playlist-items', '0', channelUrl], { label: 'get_channel_info' });
-    const data = parseYtDlpJson(stdout, isRecord, 'channel metadata');
-    return {
-        name: data.channel ?? 'Unknown',
-        channelId: data.channel_id ?? '',
-        handle: data.uploader_id ?? '',
-        subscriberCount: data.channel_follower_count ?? 0,
-        channelUrl: data.channel_url ?? channelUrl,
-        description: data.description ?? '',
-    };
-}
+export * from './youtube-url.js';
+export * from './youtube-video.js';
+export * from './youtube-channel.js';
+export * from './youtube-search.js';
+export * from './youtube-download.js';
+export * from './transcript-cache.js';
 //# sourceMappingURL=youtube.js.map

package/dist/utils/youtube.js.map

@@ -1 +1 @@
-{"version":3,"file":"youtube.js","sourceRoot":"","sources":["../../src/utils/youtube.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"youtube.js","sourceRoot":"","sources":["../../src/utils/youtube.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,cAAc,kBAAkB,CAAC;AACjC,cAAc,oBAAoB,CAAC;AACnC,cAAc,sBAAsB,CAAC;AACrC,cAAc,qBAAqB,CAAC;AACpC,cAAc,uBAAuB,CAAC;AACtC,cAAc,uBAAuB,CAAC"}

package/dist/utils/ytdlp-env.d.ts

@@ -0,0 +1,33 @@
+/**
+ * The session options yt-dlp is started with, read from the environment.
+ *
+ * Cookies are how yt-dlp reads age-restricted, members-only and sign-in-gated
+ * videos, and how it gets past the "confirm you're not a bot" check YouTube
+ * sometimes applies to an address. They are also the user's own account, so
+ * everything here is careful about two things: the values are validated at
+ * boot and never at request time, and neither the cookie path nor its contents
+ * ever appear in a log line, a tool result or an error message.
+ */
+export declare const COOKIE_BROWSERS: readonly ["brave", "chrome", "chromium", "edge", "firefox", "opera", "safari", "vivaldi", "whale"];
+export type CookieBrowser = (typeof COOKIE_BROWSERS)[number];
+export interface YtDlpEnv {
+    /** The flags to place before the caller's arguments on every spawn. */
+    args: string[];
+    /** Which kind of cookies are configured; safe to report, unlike the values. */
+    cookies: 'file' | 'browser' | 'none';
+    browser?: CookieBrowser;
+    proxy: boolean;
+    /** Seconds yt-dlp sleeps between its own requests, when configured. */
+    sleepRequestsSeconds?: number;
+}
+/**
+ * Validate the session settings and turn them into yt-dlp flags.
+ *
+ * Throws a plain `Error` naming the variable: this runs at boot, where a bad
+ * setting should stop the server before a transport starts, not surface as a
+ * puzzling failure on the first tool call.
+ */
+export declare function readYtDlpEnv(env?: NodeJS.ProcessEnv): YtDlpEnv;
+/** One line for the boot log: what is configured, never what it is. */
+export declare function describeYtDlpEnv(settings: YtDlpEnv): string;
+//# sourceMappingURL=ytdlp-env.d.ts.map

package/dist/utils/ytdlp-env.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ytdlp-env.d.ts","sourceRoot":"","sources":["../../src/utils/ytdlp-env.ts"],"names":[],"mappings":"AAIA;;;;;;;;;GASG;AAEH,eAAO,MAAM,eAAe,oGAUlB,CAAC;AAEX,MAAM,MAAM,aAAa,GAAG,CAAC,OAAO,eAAe,CAAC,CAAC,MAAM,CAAC,CAAC;AAI7D,MAAM,WAAW,QAAQ;IACvB,uEAAuE;IACvE,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,+EAA+E;IAC/E,OAAO,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,CAAC;IACrC,OAAO,CAAC,EAAE,aAAa,CAAC;IACxB,KAAK,EAAE,OAAO,CAAC;IACf,uEAAuE;IACvE,oBAAoB,CAAC,EAAE,MAAM,CAAC;CAC/B;AA4DD;;;;;;GAMG;AACH,wBAAgB,YAAY,CAAC,GAAG,GAAE,MAAM,CAAC,UAAwB,GAAG,QAAQ,CAyB3E;AAED,uEAAuE;AACvE,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,QAAQ,GAAG,MAAM,CAU3D"}