youtube-knowledge-mcp 2.1.0 → 3.0.0

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

@@ -0,0 +1,492 @@
+import { z } from 'zod';
+/**
+ * The shapes yt-dlp's JSON output is checked against.
+ *
+ * Every field is optional or nullable: yt-dlp emits `null` for what it could
+ * not find and omits what it never looked for, and a row missing a field is
+ * still a usable row. What the schemas guarantee is that a field that *is*
+ * present has the type the code reads it as — which the previous "is it an
+ * object" guard did not.
+ */
+/** `--print '%(.{...})j'` for one video: yt-dlp writes `null` for what it did not find. */
+export declare const videoInfoRowSchema: z.ZodObject<{
+    id: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    title: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    channel: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    duration: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+    upload_date: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    description: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    tags: z.ZodUnknown;
+    thumbnail: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    view_count: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+    like_count: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+    comment_count: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+    availability: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    live_status: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+}, "strip", z.ZodTypeAny, {
+    id?: string | null | undefined;
+    title?: string | null | undefined;
+    channel?: string | null | undefined;
+    description?: string | null | undefined;
+    tags?: unknown;
+    duration?: number | null | undefined;
+    upload_date?: string | null | undefined;
+    thumbnail?: string | null | undefined;
+    view_count?: number | null | undefined;
+    like_count?: number | null | undefined;
+    comment_count?: number | null | undefined;
+    availability?: string | null | undefined;
+    live_status?: string | null | undefined;
+}, {
+    id?: string | null | undefined;
+    title?: string | null | undefined;
+    channel?: string | null | undefined;
+    description?: string | null | undefined;
+    tags?: unknown;
+    duration?: number | null | undefined;
+    upload_date?: string | null | undefined;
+    thumbnail?: string | null | undefined;
+    view_count?: number | null | undefined;
+    like_count?: number | null | undefined;
+    comment_count?: number | null | undefined;
+    availability?: string | null | undefined;
+    live_status?: string | null | undefined;
+}>;
+/** `--print 'after_move:%(.{title,filepath})j'`: where yt-dlp put the finished file. */
+export declare const afterMoveRowSchema: z.ZodObject<{
+    title: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    filepath: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+}, "strip", z.ZodTypeAny, {
+    title?: string | null | undefined;
+    filepath?: string | null | undefined;
+}, {
+    title?: string | null | undefined;
+    filepath?: string | null | undefined;
+}>;
+export declare const chapterRowSchema: z.ZodObject<{
+    title: z.ZodString;
+    start_time: z.ZodNumber;
+    end_time: z.ZodNumber;
+}, "strip", z.ZodTypeAny, {
+    title: string;
+    start_time: number;
+    end_time: number;
+}, {
+    title: string;
+    start_time: number;
+    end_time: number;
+}>;
+export declare const videoDetailsRowSchema: z.ZodObject<{
+    chapters: z.ZodOptional<z.ZodNullable<z.ZodArray<z.ZodObject<{
+        title: z.ZodString;
+        start_time: z.ZodNumber;
+        end_time: z.ZodNumber;
+    }, "strip", z.ZodTypeAny, {
+        title: string;
+        start_time: number;
+        end_time: number;
+    }, {
+        title: string;
+        start_time: number;
+        end_time: number;
+    }>, "many">>>;
+    upload_date: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    duration: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+    /**
+     * The video's real comment count — trustworthy ONLY here, because this read
+     * does not pass --write-comments. With that flag yt-dlp replaces the value
+     * with the number it extracted (measured: 300 against a video with 2.4M).
+     */
+    comment_count: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+}, "strip", z.ZodTypeAny, {
+    duration?: number | null | undefined;
+    upload_date?: string | null | undefined;
+    comment_count?: number | null | undefined;
+    chapters?: {
+        title: string;
+        start_time: number;
+        end_time: number;
+    }[] | null | undefined;
+}, {
+    duration?: number | null | undefined;
+    upload_date?: string | null | undefined;
+    comment_count?: number | null | undefined;
+    chapters?: {
+        title: string;
+        start_time: number;
+        end_time: number;
+    }[] | null | undefined;
+}>;
+/**
+ * Every field yt-dlp returns for a comment, verified against 2026.08.19.
+ *
+ * Nine of these were previously dropped on the floor after being paid for:
+ * the extraction fetches them either way, so discarding `id` and `parent`
+ * meant a thread could not be rebuilt from what we already had.
+ */
+export declare const commentRowSchema: z.ZodObject<{
+    id: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    author: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    author_id: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    author_url: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    author_thumbnail: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    author_is_uploader: z.ZodOptional<z.ZodNullable<z.ZodBoolean>>;
+    author_is_verified: z.ZodOptional<z.ZodNullable<z.ZodBoolean>>;
+    text: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    like_count: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+    is_pinned: z.ZodOptional<z.ZodNullable<z.ZodBoolean>>;
+    is_favorited: z.ZodOptional<z.ZodNullable<z.ZodBoolean>>;
+    timestamp: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+    _time_text: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    /** 'root' for a top-level comment; the parent's id for a reply. */
+    parent: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+}, "strip", z.ZodTypeAny, {
+    id?: string | null | undefined;
+    author?: string | null | undefined;
+    text?: string | null | undefined;
+    timestamp?: number | null | undefined;
+    parent?: string | null | undefined;
+    like_count?: number | null | undefined;
+    author_id?: string | null | undefined;
+    author_url?: string | null | undefined;
+    author_thumbnail?: string | null | undefined;
+    author_is_uploader?: boolean | null | undefined;
+    author_is_verified?: boolean | null | undefined;
+    is_pinned?: boolean | null | undefined;
+    is_favorited?: boolean | null | undefined;
+    _time_text?: string | null | undefined;
+}, {
+    id?: string | null | undefined;
+    author?: string | null | undefined;
+    text?: string | null | undefined;
+    timestamp?: number | null | undefined;
+    parent?: string | null | undefined;
+    like_count?: number | null | undefined;
+    author_id?: string | null | undefined;
+    author_url?: string | null | undefined;
+    author_thumbnail?: string | null | undefined;
+    author_is_uploader?: boolean | null | undefined;
+    author_is_verified?: boolean | null | undefined;
+    is_pinned?: boolean | null | undefined;
+    is_favorited?: boolean | null | undefined;
+    _time_text?: string | null | undefined;
+}>;
+export declare const commentsRowSchema: z.ZodObject<{
+    comments: z.ZodOptional<z.ZodNullable<z.ZodArray<z.ZodObject<{
+        id: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        author: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        author_id: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        author_url: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        author_thumbnail: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        author_is_uploader: z.ZodOptional<z.ZodNullable<z.ZodBoolean>>;
+        author_is_verified: z.ZodOptional<z.ZodNullable<z.ZodBoolean>>;
+        text: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        like_count: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+        is_pinned: z.ZodOptional<z.ZodNullable<z.ZodBoolean>>;
+        is_favorited: z.ZodOptional<z.ZodNullable<z.ZodBoolean>>;
+        timestamp: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+        _time_text: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        /** 'root' for a top-level comment; the parent's id for a reply. */
+        parent: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    }, "strip", z.ZodTypeAny, {
+        id?: string | null | undefined;
+        author?: string | null | undefined;
+        text?: string | null | undefined;
+        timestamp?: number | null | undefined;
+        parent?: string | null | undefined;
+        like_count?: number | null | undefined;
+        author_id?: string | null | undefined;
+        author_url?: string | null | undefined;
+        author_thumbnail?: string | null | undefined;
+        author_is_uploader?: boolean | null | undefined;
+        author_is_verified?: boolean | null | undefined;
+        is_pinned?: boolean | null | undefined;
+        is_favorited?: boolean | null | undefined;
+        _time_text?: string | null | undefined;
+    }, {
+        id?: string | null | undefined;
+        author?: string | null | undefined;
+        text?: string | null | undefined;
+        timestamp?: number | null | undefined;
+        parent?: string | null | undefined;
+        like_count?: number | null | undefined;
+        author_id?: string | null | undefined;
+        author_url?: string | null | undefined;
+        author_thumbnail?: string | null | undefined;
+        author_is_uploader?: boolean | null | undefined;
+        author_is_verified?: boolean | null | undefined;
+        is_pinned?: boolean | null | undefined;
+        is_favorited?: boolean | null | undefined;
+        _time_text?: string | null | undefined;
+    }>, "many">>>;
+    /**
+     * With --write-comments yt-dlp OVERWRITES this with the number extracted,
+     * and sets it to null when the extraction was interrupted. So it is a
+     * three-state signal about this run, never the video's real total, which
+     * only a separate metadata pass can report.
+     */
+    comment_count: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+}, "strip", z.ZodTypeAny, {
+    comment_count?: number | null | undefined;
+    comments?: {
+        id?: string | null | undefined;
+        author?: string | null | undefined;
+        text?: string | null | undefined;
+        timestamp?: number | null | undefined;
+        parent?: string | null | undefined;
+        like_count?: number | null | undefined;
+        author_id?: string | null | undefined;
+        author_url?: string | null | undefined;
+        author_thumbnail?: string | null | undefined;
+        author_is_uploader?: boolean | null | undefined;
+        author_is_verified?: boolean | null | undefined;
+        is_pinned?: boolean | null | undefined;
+        is_favorited?: boolean | null | undefined;
+        _time_text?: string | null | undefined;
+    }[] | null | undefined;
+}, {
+    comment_count?: number | null | undefined;
+    comments?: {
+        id?: string | null | undefined;
+        author?: string | null | undefined;
+        text?: string | null | undefined;
+        timestamp?: number | null | undefined;
+        parent?: string | null | undefined;
+        like_count?: number | null | undefined;
+        author_id?: string | null | undefined;
+        author_url?: string | null | undefined;
+        author_thumbnail?: string | null | undefined;
+        author_is_uploader?: boolean | null | undefined;
+        author_is_verified?: boolean | null | undefined;
+        is_pinned?: boolean | null | undefined;
+        is_favorited?: boolean | null | undefined;
+        _time_text?: string | null | undefined;
+    }[] | null | undefined;
+}>;
+export declare const formatRowSchema: z.ZodObject<{
+    format_id: z.ZodString;
+    ext: z.ZodString;
+    resolution: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    width: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+    height: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+    fps: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+    vcodec: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    acodec: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    filesize: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+    filesize_approx: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+    format_note: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+}, "strip", z.ZodTypeAny, {
+    ext: string;
+    format_id: string;
+    resolution?: string | null | undefined;
+    fps?: number | null | undefined;
+    vcodec?: string | null | undefined;
+    acodec?: string | null | undefined;
+    width?: number | null | undefined;
+    height?: number | null | undefined;
+    filesize?: number | null | undefined;
+    filesize_approx?: number | null | undefined;
+    format_note?: string | null | undefined;
+}, {
+    ext: string;
+    format_id: string;
+    resolution?: string | null | undefined;
+    fps?: number | null | undefined;
+    vcodec?: string | null | undefined;
+    acodec?: string | null | undefined;
+    width?: number | null | undefined;
+    height?: number | null | undefined;
+    filesize?: number | null | undefined;
+    filesize_approx?: number | null | undefined;
+    format_note?: string | null | undefined;
+}>;
+export declare const formatsRowSchema: z.ZodObject<{
+    formats: z.ZodOptional<z.ZodNullable<z.ZodArray<z.ZodObject<{
+        format_id: z.ZodString;
+        ext: z.ZodString;
+        resolution: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        width: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+        height: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+        fps: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+        vcodec: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        acodec: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        filesize: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+        filesize_approx: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+        format_note: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    }, "strip", z.ZodTypeAny, {
+        ext: string;
+        format_id: string;
+        resolution?: string | null | undefined;
+        fps?: number | null | undefined;
+        vcodec?: string | null | undefined;
+        acodec?: string | null | undefined;
+        width?: number | null | undefined;
+        height?: number | null | undefined;
+        filesize?: number | null | undefined;
+        filesize_approx?: number | null | undefined;
+        format_note?: string | null | undefined;
+    }, {
+        ext: string;
+        format_id: string;
+        resolution?: string | null | undefined;
+        fps?: number | null | undefined;
+        vcodec?: string | null | undefined;
+        acodec?: string | null | undefined;
+        width?: number | null | undefined;
+        height?: number | null | undefined;
+        filesize?: number | null | undefined;
+        filesize_approx?: number | null | undefined;
+        format_note?: string | null | undefined;
+    }>, "many">>>;
+}, "strip", z.ZodTypeAny, {
+    formats?: {
+        ext: string;
+        format_id: string;
+        resolution?: string | null | undefined;
+        fps?: number | null | undefined;
+        vcodec?: string | null | undefined;
+        acodec?: string | null | undefined;
+        width?: number | null | undefined;
+        height?: number | null | undefined;
+        filesize?: number | null | undefined;
+        filesize_approx?: number | null | undefined;
+        format_note?: string | null | undefined;
+    }[] | null | undefined;
+}, {
+    formats?: {
+        ext: string;
+        format_id: string;
+        resolution?: string | null | undefined;
+        fps?: number | null | undefined;
+        vcodec?: string | null | undefined;
+        acodec?: string | null | undefined;
+        width?: number | null | undefined;
+        height?: number | null | undefined;
+        filesize?: number | null | undefined;
+        filesize_approx?: number | null | undefined;
+        format_note?: string | null | undefined;
+    }[] | null | undefined;
+}>;
+export declare const captionTracksSchema: z.ZodObject<{
+    subtitles: z.ZodOptional<z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodUnknown>>>;
+    automatic_captions: z.ZodOptional<z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodUnknown>>>;
+}, "strip", z.ZodTypeAny, {
+    subtitles?: Record<string, unknown> | null | undefined;
+    automatic_captions?: Record<string, unknown> | null | undefined;
+}, {
+    subtitles?: Record<string, unknown> | null | undefined;
+    automatic_captions?: Record<string, unknown> | null | undefined;
+}>;
+/**
+ * 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.
+ */
+export declare const searchResultSchema: z.ZodObject<{
+    id: z.ZodString;
+    title: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    duration: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+    channel: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    view_count: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+    url: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+}, "strip", z.ZodTypeAny, {
+    id: string;
+    title?: string | null | undefined;
+    url?: string | null | undefined;
+    channel?: string | null | undefined;
+    duration?: number | null | undefined;
+    view_count?: number | null | undefined;
+}, {
+    id: string;
+    title?: string | null | undefined;
+    url?: string | null | undefined;
+    channel?: string | null | undefined;
+    duration?: number | null | undefined;
+    view_count?: number | null | undefined;
+}>;
+export declare const channelSearchRowSchema: z.ZodObject<{
+    id: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    title: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    channel: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    channel_id: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    channel_url: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    uploader_id: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    channel_follower_count: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+    description: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+}, "strip", z.ZodTypeAny, {
+    id?: string | null | undefined;
+    title?: string | null | undefined;
+    channel?: string | null | undefined;
+    description?: string | null | undefined;
+    channel_id?: string | null | undefined;
+    channel_url?: string | null | undefined;
+    uploader_id?: string | null | undefined;
+    channel_follower_count?: number | null | undefined;
+}, {
+    id?: string | null | undefined;
+    title?: string | null | undefined;
+    channel?: string | null | undefined;
+    description?: string | null | undefined;
+    channel_id?: string | null | undefined;
+    channel_url?: string | null | undefined;
+    uploader_id?: string | null | undefined;
+    channel_follower_count?: number | null | undefined;
+}>;
+export declare const channelMetaSchema: z.ZodObject<{
+    channel: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    channel_id: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    channel_url: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    uploader_id: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    channel_follower_count: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+    description: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    /** Checked by `selectChannelImages`, which tolerates any shape. */
+    thumbnails: z.ZodUnknown;
+}, "strip", z.ZodTypeAny, {
+    channel?: string | null | undefined;
+    description?: string | null | undefined;
+    channel_id?: string | null | undefined;
+    channel_url?: string | null | undefined;
+    uploader_id?: string | null | undefined;
+    channel_follower_count?: number | null | undefined;
+    thumbnails?: unknown;
+}, {
+    channel?: string | null | undefined;
+    description?: string | null | undefined;
+    channel_id?: string | null | undefined;
+    channel_url?: string | null | undefined;
+    uploader_id?: string | null | undefined;
+    channel_follower_count?: number | null | undefined;
+    thumbnails?: unknown;
+}>;
+export declare const playlistMetaSchema: z.ZodObject<{
+    id: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    title: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    channel: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    channel_url: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    uploader_id: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    playlist_count: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+    modified_date: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    webpage_url: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    description: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+}, "strip", z.ZodTypeAny, {
+    id?: string | null | undefined;
+    title?: string | null | undefined;
+    channel?: string | null | undefined;
+    description?: string | null | undefined;
+    channel_url?: string | null | undefined;
+    uploader_id?: string | null | undefined;
+    playlist_count?: number | null | undefined;
+    modified_date?: string | null | undefined;
+    webpage_url?: string | null | undefined;
+}, {
+    id?: string | null | undefined;
+    title?: string | null | undefined;
+    channel?: string | null | undefined;
+    description?: string | null | undefined;
+    channel_url?: string | null | undefined;
+    uploader_id?: string | null | undefined;
+    playlist_count?: number | null | undefined;
+    modified_date?: string | null | undefined;
+    webpage_url?: string | null | undefined;
+}>;
+//# sourceMappingURL=youtube-schemas.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"youtube-schemas.d.ts","sourceRoot":"","sources":["../../src/utils/youtube-schemas.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;;;;;;;GAQG;AAEH,2FAA2F;AAC3F,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAgB7B,CAAC;AAEH,wFAAwF;AACxF,eAAO,MAAM,kBAAkB;;;;;;;;;EAG7B,CAAC;AAEH,eAAO,MAAM,gBAAgB;;;;;;;;;;;;EAI3B,CAAC;AAEH,eAAO,MAAM,qBAAqB;;;;;;;;;;;;;;;;IAIhC;;;;OAIG;;;;;;;;;;;;;;;;;;;;EAEH,CAAC;AAEH;;;;;;GAMG;AACH,eAAO,MAAM,gBAAgB;;;;;;;;;;;;;;IAc3B,mEAAmE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAEnE,CAAC;AAEH,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;;;QAJ5B,mEAAmE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAMnE;;;;;OAKG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAEH,CAAC;AAEH,eAAO,MAAM,eAAe;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAY1B,CAAC;AAEH,eAAO,MAAM,gBAAgB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAE3B,CAAC;AAEH,eAAO,MAAM,mBAAmB;;;;;;;;;EAG9B,CAAC;AAEH;;;;GAIG;AACH,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;;;;;;;EAO7B,CAAC;AAEH,eAAO,MAAM,sBAAsB;;;;;;;;;;;;;;;;;;;;;;;;;;;EASjC,CAAC;AAEH,eAAO,MAAM,iBAAiB;;;;;;;IAO5B,mEAAmE;;;;;;;;;;;;;;;;;;EAEnE,CAAC;AAEH,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAU7B,CAAC"}

package/dist/utils/youtube-schemas.js

@@ -0,0 +1,148 @@
+import { z } from 'zod';
+/**
+ * The shapes yt-dlp's JSON output is checked against.
+ *
+ * Every field is optional or nullable: yt-dlp emits `null` for what it could
+ * not find and omits what it never looked for, and a row missing a field is
+ * still a usable row. What the schemas guarantee is that a field that *is*
+ * present has the type the code reads it as — which the previous "is it an
+ * object" guard did not.
+ */
+/** `--print '%(.{...})j'` for one video: yt-dlp writes `null` for what it did not find. */
+export const videoInfoRowSchema = z.object({
+    id: z.string().nullish(),
+    title: z.string().nullish(),
+    channel: z.string().nullish(),
+    duration: z.number().nullish(),
+    upload_date: z.string().nullish(),
+    description: z.string().nullish(),
+    // Kept loose on purpose: a tag list is read for the strings it holds, and a
+    // video whose tags field is odd should still be readable.
+    tags: z.unknown(),
+    thumbnail: z.string().nullish(),
+    view_count: z.number().nullish(),
+    like_count: z.number().nullish(),
+    comment_count: z.number().nullish(),
+    availability: z.string().nullish(),
+    live_status: z.string().nullish(),
+});
+/** `--print 'after_move:%(.{title,filepath})j'`: where yt-dlp put the finished file. */
+export const afterMoveRowSchema = z.object({
+    title: z.string().nullish(),
+    filepath: z.string().nullish(),
+});
+export const chapterRowSchema = z.object({
+    title: z.string(),
+    start_time: z.number(),
+    end_time: z.number(),
+});
+export const videoDetailsRowSchema = z.object({
+    chapters: z.array(chapterRowSchema).nullish(),
+    upload_date: z.string().nullish(),
+    duration: z.number().nullish(),
+    /**
+     * The video's real comment count — trustworthy ONLY here, because this read
+     * does not pass --write-comments. With that flag yt-dlp replaces the value
+     * with the number it extracted (measured: 300 against a video with 2.4M).
+     */
+    comment_count: z.number().nullish(),
+});
+/**
+ * Every field yt-dlp returns for a comment, verified against 2026.08.19.
+ *
+ * Nine of these were previously dropped on the floor after being paid for:
+ * the extraction fetches them either way, so discarding `id` and `parent`
+ * meant a thread could not be rebuilt from what we already had.
+ */
+export const commentRowSchema = z.object({
+    id: z.string().nullish(),
+    author: z.string().nullish(),
+    author_id: z.string().nullish(),
+    author_url: z.string().nullish(),
+    author_thumbnail: z.string().nullish(),
+    author_is_uploader: z.boolean().nullish(),
+    author_is_verified: z.boolean().nullish(),
+    text: z.string().nullish(),
+    like_count: z.number().nullish(),
+    is_pinned: z.boolean().nullish(),
+    is_favorited: z.boolean().nullish(),
+    timestamp: z.number().nullish(),
+    _time_text: z.string().nullish(),
+    /** 'root' for a top-level comment; the parent's id for a reply. */
+    parent: z.string().nullish(),
+});
+export const commentsRowSchema = z.object({
+    comments: z.array(commentRowSchema).nullish(),
+    /**
+     * With --write-comments yt-dlp OVERWRITES this with the number extracted,
+     * and sets it to null when the extraction was interrupted. So it is a
+     * three-state signal about this run, never the video's real total, which
+     * only a separate metadata pass can report.
+     */
+    comment_count: z.number().nullish(),
+});
+export const formatRowSchema = z.object({
+    format_id: z.string(),
+    ext: z.string(),
+    resolution: z.string().nullish(),
+    width: z.number().nullish(),
+    height: z.number().nullish(),
+    fps: z.number().nullish(),
+    vcodec: z.string().nullish(),
+    acodec: z.string().nullish(),
+    filesize: z.number().nullish(),
+    filesize_approx: z.number().nullish(),
+    format_note: z.string().nullish(),
+});
+export const formatsRowSchema = z.object({
+    formats: z.array(formatRowSchema).nullish(),
+});
+export const captionTracksSchema = z.object({
+    subtitles: z.record(z.string(), z.unknown()).nullish(),
+    automatic_captions: z.record(z.string(), z.unknown()).nullish(),
+});
+/**
+ * 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.
+ */
+export const searchResultSchema = z.object({
+    id: z.string(),
+    title: z.string().nullish(),
+    duration: z.number().nullish(),
+    channel: z.string().nullish(),
+    view_count: z.number().nullish(),
+    url: z.string().nullish(),
+});
+export const channelSearchRowSchema = z.object({
+    id: z.string().nullish(),
+    title: z.string().nullish(),
+    channel: z.string().nullish(),
+    channel_id: z.string().nullish(),
+    channel_url: z.string().nullish(),
+    uploader_id: z.string().nullish(),
+    channel_follower_count: z.number().nullish(),
+    description: z.string().nullish(),
+});
+export const channelMetaSchema = z.object({
+    channel: z.string().nullish(),
+    channel_id: z.string().nullish(),
+    channel_url: z.string().nullish(),
+    uploader_id: z.string().nullish(),
+    channel_follower_count: z.number().nullish(),
+    description: z.string().nullish(),
+    /** Checked by `selectChannelImages`, which tolerates any shape. */
+    thumbnails: z.unknown(),
+});
+export const playlistMetaSchema = z.object({
+    id: z.string().nullish(),
+    title: z.string().nullish(),
+    channel: z.string().nullish(),
+    channel_url: z.string().nullish(),
+    uploader_id: z.string().nullish(),
+    playlist_count: z.number().nullish(),
+    modified_date: z.string().nullish(),
+    webpage_url: z.string().nullish(),
+    description: z.string().nullish(),
+});
+//# sourceMappingURL=youtube-schemas.js.map

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

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

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

@@ -0,0 +1,14 @@
+import type { ChannelInfo } from './youtube-channel.js';
+/** Keyword search for videos and channels. */
+export interface SearchResult {
+    id: string;
+    title: string;
+    duration: number;
+    durationFormatted: string;
+    channel: string;
+    viewCount: number;
+    url: string;
+}
+export declare function searchVideos(query: string, limit?: number): Promise<SearchResult[]>;
+export declare function searchChannels(query: string, limit?: number): Promise<ChannelInfo[]>;
+//# sourceMappingURL=youtube-search.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"youtube-search.d.ts","sourceRoot":"","sources":["../../src/utils/youtube-search.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAGxD,8CAA8C;AAE9C,MAAM,WAAW,YAAY;IAC3B,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,GAAG,EAAE,MAAM,CAAC;CACb;AAED,wBAAsB,YAAY,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,SAAI,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC,CAiBpF;AAED,wBAAsB,cAAc,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,SAAI,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC,CAsBrF"}