youtube-knowledge-mcp 2.0.2 → 2.2.0

package/dist/utils/youtube-url.js

@@ -0,0 +1,75 @@
+import { YouTubeError } from './errors.js';
+import { assertYouTubeUrl, CHANNEL_ID_PATTERN, VIDEO_ID_PATTERN } from './validate-youtube.js';
+/**
+ * Video ids, watch URLs and the duration formatter every YouTube module shares.
+ *
+ * Split out of youtube.ts so the modules that read video, channel, download
+ * and transcript data can each depend on this without depending on each other.
+ */
+export function extractVideoId(urlOrId) {
+    // If it's already an ID (11 characters, no special chars except - and _)
+    if (VIDEO_ID_PATTERN.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];
+        }
+    }
+    // Truncated: the value is model-controlled and could be arbitrarily long.
+    const shown = urlOrId.length > 64 ? `${urlOrId.slice(0, 61)}...` : urlOrId;
+    throw new YouTubeError('INVALID_INPUT', `Could not extract video ID from: ${shown}`, {
+        nextStep: 'Pass an 11-character video id or a youtube.com / youtu.be watch URL.',
+    });
+}
+const HANDLE_PATTERN = /^@[\w.-]{1,50}$/;
+/**
+ * Turn a caller-supplied playlist or channel reference into a yt-dlp target.
+ *
+ * Three shapes are accepted — a URL on a YouTube host, an `@handle`, or a bare
+ * channel id — and everything else is refused. This is the boundary that keeps
+ * `fetch_videos` and friends from pointing yt-dlp at an arbitrary host.
+ */
+export function resolveListTarget(input) {
+    const trimmed = input.trim();
+    if (HANDLE_PATTERN.test(trimmed))
+        return `https://www.youtube.com/${trimmed}`;
+    if (CHANNEL_ID_PATTERN.test(trimmed))
+        return `https://www.youtube.com/channel/${trimmed}`;
+    if (trimmed.includes('/') || trimmed.includes('.'))
+        return assertYouTubeUrl(trimmed);
+    throw new YouTubeError('INVALID_INPUT', `"${trimmed.slice(0, 64)}" is not a playlist or channel.`, {
+        nextStep: 'Pass a YouTube playlist or channel URL, an @handle, or a channel id.',
+    });
+}
+/**
+ * The URL for a channel named any way a caller might name it: a URL (checked),
+ * an `@handle`, or a bare name treated as a handle, which is what
+ * `get_channel_info` has always done.
+ */
+export function channelUrlFor(channel) {
+    const trimmed = channel.trim();
+    if (trimmed.includes('/') || trimmed.includes('://'))
+        return assertYouTubeUrl(trimmed);
+    return `https://www.youtube.com/${trimmed.startsWith('@') ? trimmed : `@${trimmed}`}`;
+}
+/** The canonical watch page for a video id. */
+export function watchUrl(videoId) {
+    return `https://www.youtube.com/watch?v=${videoId}`;
+}
+export 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')}`;
+}
+//# sourceMappingURL=youtube-url.js.map

package/dist/utils/youtube-url.js.map

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

package/dist/utils/youtube-video.d.ts

@@ -0,0 +1,47 @@
+/** Everything read about one video: metadata, chapters and comments. */
+export interface VideoInfo {
+    id: string;
+    title: string;
+    channel: string;
+    duration: number;
+    durationFormatted: string;
+    uploadDate: string;
+    description: string;
+    tags: string[];
+    url: string;
+    thumbnailUrl: string;
+    viewCount: number;
+    likeCount: number;
+    commentCount: number;
+}
+export interface Chapter {
+    title: string;
+    startTime: number;
+    startTimeFormatted: string;
+    endTime: number;
+    endTimeFormatted: string;
+}
+export interface VideoComment {
+    author: string;
+    text: string;
+    likeCount: number;
+    isPinned: boolean;
+}
+export declare function getVideoInfo(urlOrId: string): Promise<VideoInfo>;
+export declare function getChapters(urlOrId: string): Promise<Chapter[]>;
+/**
+ * Publication date, length and chapters, from a single metadata fetch.
+ *
+ * Reading a channel needs all three per video, and asking for them separately
+ * spawns yt-dlp twice for one identical `-j` request — doubling the requests a
+ * build makes to YouTube, which is the thing most likely to get it throttled.
+ * `getChapters` is the same call with everything but the chapters discarded.
+ */
+export interface VideoDetails {
+    uploadDate: string;
+    durationSeconds: number;
+    chapters: Chapter[];
+}
+export declare function getVideoDetails(urlOrId: string): Promise<VideoDetails>;
+export declare function getComments(urlOrId: string, limit?: number): Promise<VideoComment[]>;
+//# sourceMappingURL=youtube-video.d.ts.map

package/dist/utils/youtube-video.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"youtube-video.d.ts","sourceRoot":"","sources":["../../src/utils/youtube-video.ts"],"names":[],"mappings":"AAMA,wEAAwE;AAExE,MAAM,WAAW,SAAS;IACxB,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,GAAG,EAAE,MAAM,CAAC;IACZ,YAAY,EAAE,MAAM,CAAC;IACrB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,OAAO;IACtB,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;IAClB,kBAAkB,EAAE,MAAM,CAAC;IAC3B,OAAO,EAAE,MAAM,CAAC;IAChB,gBAAgB,EAAE,MAAM,CAAC;CAC1B;AAED,MAAM,WAAW,YAAY;IAC3B,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,OAAO,CAAC;CACnB;AAKD,wBAAsB,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,CAAC,CAoDtE;AAED,wBAAsB,WAAW,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,EAAE,CAAC,CAErE;AAED;;;;;;;GAOG;AACH,MAAM,WAAW,YAAY;IAC3B,UAAU,EAAE,MAAM,CAAC;IACnB,eAAe,EAAE,MAAM,CAAC;IACxB,QAAQ,EAAE,OAAO,EAAE,CAAC;CACrB;AAED,wBAAsB,eAAe,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC,CAqB5E;AAED,wBAAsB,WAAW,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,SAAK,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC,CA2BtF"}

package/dist/utils/youtube-video.js

@@ -0,0 +1,98 @@
+import { formatYouTubeDate } from './format.js';
+import { classifyPlayability } from './errors.js';
+import { TIMEOUTS, parseYtDlpJson, runYtDlp } from './ytdlp.js';
+import { commentsRowSchema, videoDetailsRowSchema, videoInfoRowSchema } from './youtube-schemas.js';
+import { extractVideoId, formatDuration, watchUrl } from './youtube-url.js';
+const VIDEO_INFO_TEMPLATE = '%(.{id,title,channel,duration,upload_date,description,tags,thumbnail,view_count,like_count,comment_count,availability,live_status})j';
+export async function getVideoInfo(urlOrId) {
+    const videoId = extractVideoId(urlOrId);
+    const url = watchUrl(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',
+        // One JSON object with exactly these fields, rather than a delimited row:
+        // yt-dlp writes `null` for what it does not know, the parser checks each
+        // field's type, and a description containing the delimiter cannot shift
+        // every field after it.
+        '--print',
+        VIDEO_INFO_TEMPLATE,
+    ], { label: 'get_video_info', target: url });
+    const row = parseYtDlpJson(stdout, videoInfoRowSchema, 'video metadata');
+    // 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: row.availability ?? undefined,
+        liveStatus: row.live_status ?? undefined,
+    });
+    if (refusal)
+        throw refusal;
+    const duration = row.duration ?? 0;
+    return {
+        id: row.id ?? videoId,
+        title: row.title ?? '',
+        channel: row.channel ?? '',
+        duration,
+        durationFormatted: formatDuration(duration),
+        uploadDate: formatYouTubeDate(row.upload_date ?? ''),
+        description: row.description ?? '',
+        tags: Array.isArray(row.tags)
+            ? row.tags.filter((tag) => typeof tag === 'string')
+            : [],
+        url,
+        thumbnailUrl: row.thumbnail ?? '',
+        viewCount: row.view_count ?? 0,
+        likeCount: row.like_count ?? 0,
+        commentCount: row.comment_count ?? 0,
+    };
+}
+export async function getChapters(urlOrId) {
+    return (await getVideoDetails(urlOrId)).chapters;
+}
+export async function getVideoDetails(urlOrId) {
+    const videoId = extractVideoId(urlOrId);
+    const url = watchUrl(videoId);
+    const stdout = await runYtDlp(['-j', '--skip-download'], {
+        label: 'get_video_details',
+        target: url,
+    });
+    const data = parseYtDlpJson(stdout, videoDetailsRowSchema, '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 = watchUrl(videoId);
+    const stdout = await runYtDlp([
+        '-j',
+        '--skip-download',
+        '--write-comments',
+        '--extractor-args',
+        `youtube:comment_sort=top;max_comments=${limit}`,
+    ], { label: 'get_comments', timeoutMs: TIMEOUTS.comments, target: url });
+    const data = parseYtDlpJson(stdout, commentsRowSchema, '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,
+    }));
+}
+//# sourceMappingURL=youtube-video.js.map

package/dist/utils/youtube-video.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"youtube-video.js","sourceRoot":"","sources":["../../src/utils/youtube-video.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAChD,OAAO,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAClD,OAAO,EAAE,QAAQ,EAAE,cAAc,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAChE,OAAO,EAAE,iBAAiB,EAAE,qBAAqB,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AACpG,OAAO,EAAE,cAAc,EAAE,cAAc,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAmC5E,MAAM,mBAAmB,GACvB,sIAAsI,CAAC;AAEzI,MAAM,CAAC,KAAK,UAAU,YAAY,CAAC,OAAe;IAChD,MAAM,OAAO,GAAG,cAAc,CAAC,OAAO,CAAC,CAAC;IACxC,MAAM,GAAG,GAAG,QAAQ,CAAC,OAAO,CAAC,CAAC;IAE9B,MAAM,MAAM,GAAG,MAAM,QAAQ,CAC3B;QACE,iBAAiB;QACjB,2EAA2E;QAC3E,wEAAwE;QACxE,mEAAmE;QACnE,uEAAuE;QACvE,kDAAkD;QAClD,2BAA2B;QAC3B,0EAA0E;QAC1E,yEAAyE;QACzE,wEAAwE;QACxE,wBAAwB;QACxB,SAAS;QACT,mBAAmB;KACpB,EACD,EAAE,KAAK,EAAE,gBAAgB,EAAE,MAAM,EAAE,GAAG,EAAE,CACzC,CAAC;IAEF,MAAM,GAAG,GAAG,cAAc,CAAC,MAAM,EAAE,kBAAkB,EAAE,gBAAgB,CAAC,CAAC;IAEzE,6EAA6E;IAC7E,4CAA4C;IAC5C,MAAM,OAAO,GAAG,mBAAmB,CAAC;QAClC,YAAY,EAAE,GAAG,CAAC,YAAY,IAAI,SAAS;QAC3C,UAAU,EAAE,GAAG,CAAC,WAAW,IAAI,SAAS;KACzC,CAAC,CAAC;IACH,IAAI,OAAO;QAAE,MAAM,OAAO,CAAC;IAE3B,MAAM,QAAQ,GAAG,GAAG,CAAC,QAAQ,IAAI,CAAC,CAAC;IAEnC,OAAO;QACL,EAAE,EAAE,GAAG,CAAC,EAAE,IAAI,OAAO;QACrB,KAAK,EAAE,GAAG,CAAC,KAAK,IAAI,EAAE;QACtB,OAAO,EAAE,GAAG,CAAC,OAAO,IAAI,EAAE;QAC1B,QAAQ;QACR,iBAAiB,EAAE,cAAc,CAAC,QAAQ,CAAC;QAC3C,UAAU,EAAE,iBAAiB,CAAC,GAAG,CAAC,WAAW,IAAI,EAAE,CAAC;QACpD,WAAW,EAAE,GAAG,CAAC,WAAW,IAAI,EAAE;QAClC,IAAI,EAAE,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC;YAC3B,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,GAAG,EAAiB,EAAE,CAAC,OAAO,GAAG,KAAK,QAAQ,CAAC;YAClE,CAAC,CAAC,EAAE;QACN,GAAG;QACH,YAAY,EAAE,GAAG,CAAC,SAAS,IAAI,EAAE;QACjC,SAAS,EAAE,GAAG,CAAC,UAAU,IAAI,CAAC;QAC9B,SAAS,EAAE,GAAG,CAAC,UAAU,IAAI,CAAC;QAC9B,YAAY,EAAE,GAAG,CAAC,aAAa,IAAI,CAAC;KACrC,CAAC;AACJ,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,WAAW,CAAC,OAAe;IAC/C,OAAO,CAAC,MAAM,eAAe,CAAC,OAAO,CAAC,CAAC,CAAC,QAAQ,CAAC;AACnD,CAAC;AAgBD,MAAM,CAAC,KAAK,UAAU,eAAe,CAAC,OAAe;IACnD,MAAM,OAAO,GAAG,cAAc,CAAC,OAAO,CAAC,CAAC;IACxC,MAAM,GAAG,GAAG,QAAQ,CAAC,OAAO,CAAC,CAAC;IAE9B,MAAM,MAAM,GAAG,MAAM,QAAQ,CAAC,CAAC,IAAI,EAAE,iBAAiB,CAAC,EAAE;QACvD,KAAK,EAAE,mBAAmB;QAC1B,MAAM,EAAE,GAAG;KACZ,CAAC,CAAC;IACH,MAAM,IAAI,GAAG,cAAc,CAAC,MAAM,EAAE,qBAAqB,EAAE,eAAe,CAAC,CAAC;IAE5E,OAAO;QACL,UAAU,EAAE,iBAAiB,CAAC,IAAI,CAAC,WAAW,IAAI,EAAE,CAAC;QACrD,eAAe,EAAE,OAAO,IAAI,CAAC,QAAQ,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC;QACtE,QAAQ,EAAE,CAAC,IAAI,CAAC,QAAQ,IAAI,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC;YAC3C,KAAK,EAAE,EAAE,CAAC,KAAK;YACf,SAAS,EAAE,EAAE,CAAC,UAAU;YACxB,kBAAkB,EAAE,cAAc,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,UAAU,CAAC,CAAC;YAC7D,OAAO,EAAE,EAAE,CAAC,QAAQ;YACpB,gBAAgB,EAAE,cAAc,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,QAAQ,CAAC,CAAC;SAC1D,CAAC,CAAC;KACJ,CAAC;AACJ,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,WAAW,CAAC,OAAe,EAAE,KAAK,GAAG,EAAE;IAC3D,MAAM,OAAO,GAAG,cAAc,CAAC,OAAO,CAAC,CAAC;IACxC,MAAM,GAAG,GAAG,QAAQ,CAAC,OAAO,CAAC,CAAC;IAE9B,MAAM,MAAM,GAAG,MAAM,QAAQ,CAC3B;QACE,IAAI;QACJ,iBAAiB;QACjB,kBAAkB;QAClB,kBAAkB;QAClB,yCAAyC,KAAK,EAAE;KACjD,EACD,EAAE,KAAK,EAAE,cAAc,EAAE,SAAS,EAAE,QAAQ,CAAC,QAAQ,EAAE,MAAM,EAAE,GAAG,EAAE,CACrE,CAAC;IAEF,MAAM,IAAI,GAAG,cAAc,CAAC,MAAM,EAAE,iBAAiB,EAAE,gBAAgB,CAAC,CAAC;IACzE,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,IAAI,EAAE,CAAC;IAErC,OAAO,QAAQ;SACZ,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,KAAK,MAAM,CAAC;SAClC,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC;SACf,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;QACX,MAAM,EAAE,CAAC,CAAC,MAAM,IAAI,SAAS;QAC7B,IAAI,EAAE,CAAC,CAAC,IAAI,IAAI,EAAE;QAClB,SAAS,EAAE,CAAC,CAAC,UAAU,IAAI,CAAC;QAC5B,QAAQ,EAAE,CAAC,CAAC,SAAS,IAAI,KAAK;KAC/B,CAAC,CAAC,CAAC;AACR,CAAC"}

package/dist/utils/youtube.d.ts

@@ -1,112 +1,14 @@
-import { type TranscriptSegment } from './transcript.js';
-export interface VideoInfo {
-    id: string;
-    title: string;
-    channel: string;
-    duration: number;
-    durationFormatted: string;
-    uploadDate: string;
-    description: string;
-    tags: string[];
-    url: string;
-    thumbnailUrl: string;
-    viewCount: number;
-    likeCount: number;
-    commentCount: number;
-}
-export interface VideoListItem {
-    id: string;
-    title: string;
-    duration: number;
-    durationFormatted: string;
-    uploadDate: string;
-    url: string;
-}
-export interface TranscriptResult {
-    /** The whole transcript as plain text, unchanged from previous releases. */
-    transcript: string;
-    /** The same content with cue timings preserved. */
-    segments: TranscriptSegment[];
-    language: string;
-    videoId: string;
-    /** True when served from the local cache rather than refetched. */
-    cached: boolean;
-}
-export interface VideoFormat {
-    formatId: string;
-    ext: string;
-    resolution: string;
-    fps?: number;
-    vcodec: string;
-    acodec: string;
-    filesize?: number;
-    note: string;
-}
-export interface DownloadResult {
-    videoId: string;
-    title: string;
-    filePath: string;
-    format: string;
-}
-export interface SearchResult {
-    id: string;
-    title: string;
-    duration: number;
-    durationFormatted: string;
-    channel: string;
-    viewCount: number;
-    url: string;
-}
-export interface Chapter {
-    title: string;
-    startTime: number;
-    startTimeFormatted: string;
-    endTime: number;
-    endTimeFormatted: string;
-}
-export interface VideoComment {
-    author: string;
-    text: string;
-    likeCount: number;
-    isPinned: boolean;
-}
-export interface ChannelInfo {
-    name: string;
-    channelId: string;
-    handle: string;
-    subscriberCount: number;
-    channelUrl: string;
-    description: string;
-}
-export interface PlaylistInfo {
-    id: string;
-    title: string;
-    channel: string;
-    handle: string;
-    channelUrl: string;
-    videoCount: number;
-    lastModified: string;
-    url: string;
-    description: string;
-}
-export declare function extractVideoId(urlOrId: string): string;
-export declare function getVideoInfo(urlOrId: string): Promise<VideoInfo>;
-export declare function listVideos(urlOrChannel: string, limit?: number): Promise<VideoListItem[]>;
-export interface GetTranscriptOptions {
-    language?: string;
-    /** Ignore any cached copy and refetch from YouTube. */
-    refresh?: boolean;
-}
-/** True when a usable transcript is already on disk, in any language. */
-export declare function hasCachedTranscript(videoId: string): boolean;
-export declare function getTranscript(urlOrId: string, preferredLangOrOptions?: string | GetTranscriptOptions): Promise<TranscriptResult>;
-export declare function listFormats(urlOrId: string): Promise<VideoFormat[]>;
-export type VideoQuality = 'best' | '2160p' | '1440p' | '1080p' | '720p' | '480p' | '360p' | 'audio';
-export declare function downloadVideo(urlOrId: string, formatId: string, outputDir?: string, quality?: VideoQuality): Promise<DownloadResult>;
-export declare function searchVideos(query: string, limit?: number): Promise<SearchResult[]>;
-export declare function getChapters(urlOrId: string): Promise<Chapter[]>;
-export declare function getComments(urlOrId: string, limit?: number): Promise<VideoComment[]>;
-export declare function searchChannels(query: string, limit?: number): Promise<ChannelInfo[]>;
-export declare function getPlaylistInfo(playlistUrl: string): Promise<PlaylistInfo>;
-export declare function getChannelInfo(channel: string): Promise<ChannelInfo>;
+/**
+ * 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.
+ */
+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.d.ts.map

package/dist/utils/youtube.d.ts.map

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