youtube-knowledge-mcp 2.2.0 → 3.0.1

package/dist/utils/scenes.d.ts

@@ -0,0 +1,39 @@
+/**
+ * Finding where a video cuts.
+ *
+ * ffmpeg scores every frame by how different it is from the one before; frames
+ * scoring above the threshold are cuts. Detection has to decode every frame of the
+ * window, so it reads the lightest stream and only a bounded window at a time.
+ */
+/** A scan decodes every frame; this keeps one call to a few minutes of work. */
+export declare const MAX_SCENE_WINDOW_SECONDS = 900;
+export declare const MAX_SCENE_CUTS = 200;
+export declare const DEFAULT_SCENE_THRESHOLD = 0.4;
+export interface ScanWindowRequest {
+    start?: number;
+    end?: number;
+}
+export interface SceneScanRequest extends ScanWindowRequest {
+    /** 0 to 1: how different a frame must be from the last to count as a cut. */
+    threshold: number;
+}
+export interface SceneScan {
+    videoId: string;
+    title: string;
+    duration: number;
+    start: number;
+    end: number;
+    threshold: number;
+    /** Absolute video time of each cut, ascending. */
+    cuts: number[];
+    /** True when more cuts were found than are returned. */
+    truncated: boolean;
+}
+/** Frames ffmpeg selected, as the times its showinfo filter logged them at. */
+export declare function parseSceneCuts(stderr: string, offset: number): number[];
+export declare function planScanWindow(request: ScanWindowRequest, duration: number): {
+    start: number;
+    end: number;
+};
+export declare function detectScenes(video: string, request: SceneScanRequest): Promise<SceneScan>;
+//# sourceMappingURL=scenes.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"scenes.d.ts","sourceRoot":"","sources":["../../src/utils/scenes.ts"],"names":[],"mappings":"AAWA;;;;;;GAMG;AAEH,gFAAgF;AAChF,eAAO,MAAM,wBAAwB,MAAM,CAAC;AAC5C,eAAO,MAAM,cAAc,MAAM,CAAC;AAClC,eAAO,MAAM,uBAAuB,MAAM,CAAC;AAG3C,MAAM,WAAW,iBAAiB;IAChC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,gBAAiB,SAAQ,iBAAiB;IACzD,6EAA6E;IAC7E,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,SAAS;IACxB,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,EAAE,MAAM,CAAC;IACZ,SAAS,EAAE,MAAM,CAAC;IAClB,kDAAkD;IAClD,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,wDAAwD;IACxD,SAAS,EAAE,OAAO,CAAC;CACpB;AAED,+EAA+E;AAC/E,wBAAgB,cAAc,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,CAUvE;AAED,wBAAgB,cAAc,CAC5B,OAAO,EAAE,iBAAiB,EAC1B,QAAQ,EAAE,MAAM,GACf;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAA;CAAE,CA0BhC;AAED,wBAAsB,YAAY,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,gBAAgB,GAAG,OAAO,CAAC,SAAS,CAAC,CA2C/F"}

package/dist/utils/scenes.js

@@ -0,0 +1,83 @@
+import { YouTubeError } from './errors.js';
+import { runFfmpeg } from './ffmpeg.js';
+import { roundToMillisecond } from './seconds.js';
+import { requireFfmpeg } from './preflight.js';
+import { FFMPEG_NETWORK_INPUT_ARGS, resolveStreamUrl, SCAN_STREAM_SELECTOR, } from './video-stream.js';
+import { getVideoInfo } from './youtube.js';
+/**
+ * Finding where a video cuts.
+ *
+ * ffmpeg scores every frame by how different it is from the one before; frames
+ * scoring above the threshold are cuts. Detection has to decode every frame of the
+ * window, so it reads the lightest stream and only a bounded window at a time.
+ */
+/** A scan decodes every frame; this keeps one call to a few minutes of work. */
+export const MAX_SCENE_WINDOW_SECONDS = 900;
+export const MAX_SCENE_CUTS = 200;
+export const DEFAULT_SCENE_THRESHOLD = 0.4;
+const SCAN_TIMEOUT_MS = 300_000;
+/** Frames ffmpeg selected, as the times its showinfo filter logged them at. */
+export function parseSceneCuts(stderr, offset) {
+    const times = stderr
+        .split('\n')
+        .filter((line) => line.includes('Parsed_showinfo'))
+        .flatMap((line) => {
+        const match = /pts_time:(\d+(?:\.\d+)?)/.exec(line);
+        return match?.[1] === undefined ? [] : [roundToMillisecond(offset + Number(match[1]))];
+    });
+    return [...new Set(times)].sort((a, b) => a - b);
+}
+export function planScanWindow(request, duration) {
+    const { start = 0 } = request;
+    if (duration > 0 && start >= duration) {
+        throw new YouTubeError('INVALID_INPUT', `${Math.round(start)}s is past the end of this ${duration}s video.`, { nextStep: 'Pick a start time inside the video.' });
+    }
+    const requestedEnd = request.end ?? start + MAX_SCENE_WINDOW_SECONDS;
+    if (requestedEnd <= start) {
+        throw new YouTubeError('INVALID_INPUT', 'end must be later than start.');
+    }
+    const end = duration > 0 ? Math.min(requestedEnd, duration) : requestedEnd;
+    if (end - start > MAX_SCENE_WINDOW_SECONDS) {
+        throw new YouTubeError('INVALID_INPUT', `Scene detection reads at most ${MAX_SCENE_WINDOW_SECONDS}s per call.`, { nextStep: 'Scan the video in windows, moving start forward each time.' });
+    }
+    return { start, end };
+}
+export async function detectScenes(video, request) {
+    await requireFfmpeg('Scene detection');
+    const info = await getVideoInfo(video);
+    const { start, end } = planScanWindow(request, info.duration);
+    const { threshold } = request;
+    const mediaUrl = await resolveStreamUrl(info.id, SCAN_STREAM_SELECTOR, 'Scene detection');
+    const { stderr } = await runFfmpeg([
+        ...FFMPEG_NETWORK_INPUT_ARGS,
+        // Both before -i: seek there, then read only the window.
+        '-ss',
+        String(start),
+        '-t',
+        String(end - start),
+        '-i',
+        mediaUrl,
+        '-an',
+        '-vf',
+        `select=gt(scene\\,${String(threshold)}),showinfo`,
+        '-f',
+        'null',
+        '-',
+    ], {
+        failure: 'ffmpeg could not scan this video for scene cuts.',
+        nextStep: 'Try a shorter window, or check that ffmpeg works with network input.',
+        timeoutMs: SCAN_TIMEOUT_MS,
+    });
+    const cuts = parseSceneCuts(stderr, start);
+    return {
+        videoId: info.id,
+        title: info.title,
+        duration: info.duration,
+        start,
+        end,
+        threshold,
+        cuts: cuts.slice(0, MAX_SCENE_CUTS),
+        truncated: cuts.length > MAX_SCENE_CUTS,
+    };
+}
+//# sourceMappingURL=scenes.js.map

package/dist/utils/scenes.js.map

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

package/dist/utils/seconds.d.ts

@@ -0,0 +1,5 @@
+/** Time in the units the tools speak (seconds) and the units ffmpeg and whisper.cpp write (milliseconds). */
+export declare const MILLISECONDS_PER_SECOND = 1000;
+/** Seconds rounded to the nearest millisecond, which is all the precision any source here has. */
+export declare function roundToMillisecond(seconds: number): number;
+//# sourceMappingURL=seconds.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"seconds.d.ts","sourceRoot":"","sources":["../../src/utils/seconds.ts"],"names":[],"mappings":"AAAA,6GAA6G;AAE7G,eAAO,MAAM,uBAAuB,OAAO,CAAC;AAE5C,kGAAkG;AAClG,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAE1D"}

package/dist/utils/seconds.js

@@ -0,0 +1,7 @@
+/** Time in the units the tools speak (seconds) and the units ffmpeg and whisper.cpp write (milliseconds). */
+export const MILLISECONDS_PER_SECOND = 1000;
+/** Seconds rounded to the nearest millisecond, which is all the precision any source here has. */
+export function roundToMillisecond(seconds) {
+    return Math.round(seconds * MILLISECONDS_PER_SECOND) / MILLISECONDS_PER_SECOND;
+}
+//# sourceMappingURL=seconds.js.map

package/dist/utils/seconds.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"seconds.js","sourceRoot":"","sources":["../../src/utils/seconds.ts"],"names":[],"mappings":"AAAA,6GAA6G;AAE7G,MAAM,CAAC,MAAM,uBAAuB,GAAG,IAAI,CAAC;AAE5C,kGAAkG;AAClG,MAAM,UAAU,kBAAkB,CAAC,OAAe;IAChD,OAAO,IAAI,CAAC,KAAK,CAAC,OAAO,GAAG,uBAAuB,CAAC,GAAG,uBAAuB,CAAC;AACjF,CAAC"}

package/dist/utils/sleep.d.ts

@@ -0,0 +1,9 @@
+/**
+ * A cancellable pause.
+ *
+ * Shared by the retry loop and the pacer so a cooling-down server still
+ * answers a client that gives up: an uncancellable sleep is how a cooldown
+ * turns into a wedge.
+ */
+export declare function sleep(ms: number, signal?: AbortSignal): Promise<void>;
+//# sourceMappingURL=sleep.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"sleep.d.ts","sourceRoot":"","sources":["../../src/utils/sleep.ts"],"names":[],"mappings":"AAEA;;;;;;GAMG;AACH,wBAAsB,KAAK,CAAC,EAAE,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC,CAgB3E"}

package/dist/utils/sleep.js

@@ -0,0 +1,25 @@
+import { YouTubeError } from './errors.js';
+/**
+ * A cancellable pause.
+ *
+ * Shared by the retry loop and the pacer so a cooling-down server still
+ * answers a client that gives up: an uncancellable sleep is how a cooldown
+ * turns into a wedge.
+ */
+export async function sleep(ms, signal) {
+    if (signal?.aborted === true) {
+        throw new YouTubeError('CANCELLED', 'The request was cancelled.');
+    }
+    await new Promise((resolve, reject) => {
+        const timer = setTimeout(() => {
+            signal?.removeEventListener('abort', onAbort);
+            resolve();
+        }, ms);
+        const onAbort = () => {
+            clearTimeout(timer);
+            reject(new YouTubeError('CANCELLED', 'The request was cancelled.'));
+        };
+        signal?.addEventListener('abort', onAbort, { once: true });
+    });
+}
+//# sourceMappingURL=sleep.js.map

package/dist/utils/sleep.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sleep.js","sourceRoot":"","sources":["../../src/utils/sleep.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAE3C;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,KAAK,CAAC,EAAU,EAAE,MAAoB;IAC1D,IAAI,MAAM,EAAE,OAAO,KAAK,IAAI,EAAE,CAAC;QAC7B,MAAM,IAAI,YAAY,CAAC,WAAW,EAAE,4BAA4B,CAAC,CAAC;IACpE,CAAC;IAED,MAAM,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;QAC1C,MAAM,KAAK,GAAG,UAAU,CAAC,GAAG,EAAE;YAC5B,MAAM,EAAE,mBAAmB,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;YAC9C,OAAO,EAAE,CAAC;QACZ,CAAC,EAAE,EAAE,CAAC,CAAC;QACP,MAAM,OAAO,GAAG,GAAS,EAAE;YACzB,YAAY,CAAC,KAAK,CAAC,CAAC;YACpB,MAAM,CAAC,IAAI,YAAY,CAAC,WAAW,EAAE,4BAA4B,CAAC,CAAC,CAAC;QACtE,CAAC,CAAC;QACF,MAAM,EAAE,gBAAgB,CAAC,OAAO,EAAE,OAAO,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;IAC7D,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/utils/sponsorblock.d.ts

@@ -0,0 +1,24 @@
+/** SponsorBlock's documented categories that mark something a viewer may want to skip. */
+export declare const SPONSOR_CATEGORIES: readonly ["sponsor", "selfpromo", "interaction", "intro", "outro", "preview", "music_offtopic", "filler"];
+export type SponsorCategory = (typeof SPONSOR_CATEGORIES)[number];
+export interface SponsorSegment {
+    category: string;
+    startSeconds: number;
+    endSeconds: number;
+    durationSeconds: number;
+    /** Community votes: higher is more agreed upon. */
+    votes: number;
+}
+/**
+ * The length covered by the segments, with overlaps counted once.
+ *
+ * SponsorBlock categories overlap (a sponsor read inside a self-promotion) and several
+ * submissions can mark the same range, so a plain sum of durations is more than the
+ * video can hold.
+ */
+export declare function coveredSeconds(segments: readonly SponsorSegment[]): number;
+export declare function hashPrefix(videoId: string): string;
+export declare function fetchSponsorSegments(videoId: string, categories?: readonly string[], options?: {
+    timeoutMs?: number;
+}): Promise<SponsorSegment[]>;
+//# sourceMappingURL=sponsorblock.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"sponsorblock.d.ts","sourceRoot":"","sources":["../../src/utils/sponsorblock.ts"],"names":[],"mappings":"AAuBA,0FAA0F;AAC1F,eAAO,MAAM,kBAAkB,2GASrB,CAAC;AAEX,MAAM,MAAM,eAAe,GAAG,CAAC,OAAO,kBAAkB,CAAC,CAAC,MAAM,CAAC,CAAC;AAElE,MAAM,WAAW,cAAc;IAC7B,QAAQ,EAAE,MAAM,CAAC;IACjB,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;IACnB,eAAe,EAAE,MAAM,CAAC;IACxB,mDAAmD;IACnD,KAAK,EAAE,MAAM,CAAC;CACf;AAeD;;;;;;GAMG;AACH,wBAAgB,cAAc,CAAC,QAAQ,EAAE,SAAS,cAAc,EAAE,GAAG,MAAM,CAa1E;AAED,wBAAgB,UAAU,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAElD;AA8DD,wBAAsB,oBAAoB,CACxC,OAAO,EAAE,MAAM,EACf,UAAU,GAAE,SAAS,MAAM,EAAuB,EAClD,OAAO,GAAE;IAAE,SAAS,CAAC,EAAE,MAAM,CAAA;CAAO,GACnC,OAAO,CAAC,cAAc,EAAE,CAAC,CA6C3B"}

package/dist/utils/sponsorblock.js

@@ -0,0 +1,153 @@
+import { createHash } from 'node:crypto';
+import { z } from 'zod';
+import { currentContext } from './context.js';
+import { YouTubeError } from './errors.js';
+import { assertVideoId } from './validate.js';
+/**
+ * The stretches of a video the community has marked as sponsor reads, intros, outros
+ * and the like, from SponsorBlock (https://sponsor.ajay.app), the database the whole
+ * ecosystem uses.
+ *
+ * Its API is queried by the first four hex digits of the video id's SHA-256, never by
+ * the id, so the service cannot tell which of the several videos sharing a prefix was
+ * asked about. That is the privacy design SponsorBlock documents, and the only way this
+ * module asks.
+ */
+const API = 'https://sponsor.ajay.app/api/skipSegments';
+const HASH_PREFIX_LENGTH = 4;
+const DEFAULT_TIMEOUT_MS = 15_000;
+/** A hash prefix answers with every video sharing it; far more than this is not plausible. */
+const MAX_RESPONSE_CHARS = 8_000_000;
+/** SponsorBlock's documented categories that mark something a viewer may want to skip. */
+export const SPONSOR_CATEGORIES = [
+    'sponsor',
+    'selfpromo',
+    'interaction',
+    'intro',
+    'outro',
+    'preview',
+    'music_offtopic',
+    'filler',
+];
+const responseSchema = z.array(z.object({
+    videoID: z.string(),
+    segments: z.array(z.object({
+        category: z.string(),
+        segment: z.tuple([z.number(), z.number()]),
+        votes: z.number().optional(),
+    })),
+}));
+/**
+ * The length covered by the segments, with overlaps counted once.
+ *
+ * SponsorBlock categories overlap (a sponsor read inside a self-promotion) and several
+ * submissions can mark the same range, so a plain sum of durations is more than the
+ * video can hold.
+ */
+export function coveredSeconds(segments) {
+    let covered = 0;
+    let reachedTo = Number.NEGATIVE_INFINITY;
+    for (const { startSeconds, endSeconds } of [...segments].sort((a, b) => a.startSeconds - b.startSeconds)) {
+        const from = Math.max(startSeconds, reachedTo);
+        if (endSeconds > from)
+            covered += endSeconds - from;
+        reachedTo = Math.max(reachedTo, endSeconds);
+    }
+    return covered;
+}
+export function hashPrefix(videoId) {
+    return createHash('sha256').update(videoId).digest('hex').slice(0, HASH_PREFIX_LENGTH);
+}
+function failure(message, cause) {
+    return new YouTubeError('FETCH_FAILED', message, {
+        nextStep: 'SponsorBlock is a community service and may be down. Try again later.',
+        retryable: true,
+        cause,
+    });
+}
+/**
+ * The body as text, read as it arrives and abandoned once it passes the cap, so a
+ * misbehaving service cannot make this process hold an unbounded response in memory.
+ */
+async function readBounded(response) {
+    if (response.body === null)
+        return '';
+    const reader = response.body.getReader();
+    const decoder = new TextDecoder();
+    let text = '';
+    for (;;) {
+        const { done, value } = await reader.read();
+        if (done)
+            return text + decoder.decode();
+        text += decoder.decode(value, { stream: true });
+        if (text.length > MAX_RESPONSE_CHARS) {
+            await reader.cancel();
+            throw failure('SponsorBlock answered with too much data.');
+        }
+    }
+}
+async function request(url, timeoutMs) {
+    const timeout = AbortSignal.timeout(timeoutMs);
+    const { signal: cancelled } = currentContext();
+    const signal = cancelled === undefined ? timeout : AbortSignal.any([cancelled, timeout]);
+    try {
+        // The host is fixed, so a redirect is never legitimate: refusing it keeps this
+        // request on the one origin it was written for.
+        const response = await fetch(url, {
+            signal,
+            redirect: 'error',
+            headers: { Accept: 'application/json' },
+        });
+        return { status: response.status, text: await readBounded(response) };
+    }
+    catch (error) {
+        if (error instanceof YouTubeError)
+            throw error;
+        if (error instanceof DOMException && error.name === 'TimeoutError') {
+            throw new YouTubeError('TIMEOUT', 'SponsorBlock did not answer in time.', {
+                nextStep: 'Try again later.',
+                retryable: true,
+                cause: error,
+            });
+        }
+        if (cancelled?.aborted === true) {
+            throw new YouTubeError('CANCELLED', 'The request was cancelled.');
+        }
+        throw failure('Could not reach SponsorBlock.', error);
+    }
+}
+export async function fetchSponsorSegments(videoId, categories = SPONSOR_CATEGORIES, options = {}) {
+    assertVideoId(videoId);
+    const url = new URL(`${API}/${hashPrefix(videoId)}`);
+    url.searchParams.set('categories', JSON.stringify(categories));
+    const { status, text } = await request(url, options.timeoutMs ?? DEFAULT_TIMEOUT_MS);
+    // 404 is how the service says no video sharing the prefix has any segment.
+    if (status === 404)
+        return [];
+    if (status < 200 || status >= 300) {
+        throw failure(`SponsorBlock answered with status ${String(status)}.`);
+    }
+    let json;
+    try {
+        json = JSON.parse(text);
+    }
+    catch (error) {
+        throw new YouTubeError('MALFORMED_RESPONSE', 'SponsorBlock answered with something that is not JSON.', { cause: error });
+    }
+    const parsed = responseSchema.safeParse(json);
+    if (!parsed.success) {
+        throw new YouTubeError('MALFORMED_RESPONSE', 'SponsorBlock answered in a shape this server does not know.', { cause: parsed.error });
+    }
+    return parsed.data
+        .filter((entry) => entry.videoID === videoId)
+        .flatMap((entry) => entry.segments)
+        .map(({ category, segment: [start, end], votes }) => ({
+        category,
+        startSeconds: start,
+        endSeconds: end,
+        durationSeconds: end - start,
+        votes: votes ?? 0,
+    }))
+        .sort((a, b) => a.startSeconds - b.startSeconds);
+}
+//# sourceMappingURL=sponsorblock.js.map

package/dist/utils/sponsorblock.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sponsorblock.js","sourceRoot":"","sources":["../../src/utils/sponsorblock.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAC9C,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAC3C,OAAO,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAE9C;;;;;;;;;GASG;AAEH,MAAM,GAAG,GAAG,2CAA2C,CAAC;AACxD,MAAM,kBAAkB,GAAG,CAAC,CAAC;AAC7B,MAAM,kBAAkB,GAAG,MAAM,CAAC;AAClC,8FAA8F;AAC9F,MAAM,kBAAkB,GAAG,SAAS,CAAC;AAErC,0FAA0F;AAC1F,MAAM,CAAC,MAAM,kBAAkB,GAAG;IAChC,SAAS;IACT,WAAW;IACX,aAAa;IACb,OAAO;IACP,OAAO;IACP,SAAS;IACT,gBAAgB;IAChB,QAAQ;CACA,CAAC;AAaX,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAC5B,CAAC,CAAC,MAAM,CAAC;IACP,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE;IACnB,QAAQ,EAAE,CAAC,CAAC,KAAK,CACf,CAAC,CAAC,MAAM,CAAC;QACP,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE;QACpB,OAAO,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC;QAC1C,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;KAC7B,CAAC,CACH;CACF,CAAC,CACH,CAAC;AAEF;;;;;;GAMG;AACH,MAAM,UAAU,cAAc,CAAC,QAAmC;IAChE,IAAI,OAAO,GAAG,CAAC,CAAC;IAChB,IAAI,SAAS,GAAG,MAAM,CAAC,iBAAiB,CAAC;IAEzC,KAAK,MAAM,EAAE,YAAY,EAAE,UAAU,EAAE,IAAI,CAAC,GAAG,QAAQ,CAAC,CAAC,IAAI,CAC3D,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,YAAY,GAAG,CAAC,CAAC,YAAY,CAC1C,EAAE,CAAC;QACF,MAAM,IAAI,GAAG,IAAI,CAAC,GAAG,CAAC,YAAY,EAAE,SAAS,CAAC,CAAC;QAC/C,IAAI,UAAU,GAAG,IAAI;YAAE,OAAO,IAAI,UAAU,GAAG,IAAI,CAAC;QACpD,SAAS,GAAG,IAAI,CAAC,GAAG,CAAC,SAAS,EAAE,UAAU,CAAC,CAAC;IAC9C,CAAC;IAED,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,MAAM,UAAU,UAAU,CAAC,OAAe;IACxC,OAAO,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,kBAAkB,CAAC,CAAC;AACzF,CAAC;AAED,SAAS,OAAO,CAAC,OAAe,EAAE,KAAe;IAC/C,OAAO,IAAI,YAAY,CAAC,cAAc,EAAE,OAAO,EAAE;QAC/C,QAAQ,EAAE,uEAAuE;QACjF,SAAS,EAAE,IAAI;QACf,KAAK;KACN,CAAC,CAAC;AACL,CAAC;AAED;;;GAGG;AACH,KAAK,UAAU,WAAW,CAAC,QAAkB;IAC3C,IAAI,QAAQ,CAAC,IAAI,KAAK,IAAI;QAAE,OAAO,EAAE,CAAC;IAEtC,MAAM,MAAM,GAAG,QAAQ,CAAC,IAAI,CAAC,SAAS,EAAE,CAAC;IACzC,MAAM,OAAO,GAAG,IAAI,WAAW,EAAE,CAAC;IAClC,IAAI,IAAI,GAAG,EAAE,CAAC;IAEd,SAAS,CAAC;QACR,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,GAAG,MAAM,MAAM,CAAC,IAAI,EAAE,CAAC;QAC5C,IAAI,IAAI;YAAE,OAAO,IAAI,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;QACzC,IAAI,IAAI,OAAO,CAAC,MAAM,CAAC,KAAK,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC;QAChD,IAAI,IAAI,CAAC,MAAM,GAAG,kBAAkB,EAAE,CAAC;YACrC,MAAM,MAAM,CAAC,MAAM,EAAE,CAAC;YACtB,MAAM,OAAO,CAAC,2CAA2C,CAAC,CAAC;QAC7D,CAAC;IACH,CAAC;AACH,CAAC;AAED,KAAK,UAAU,OAAO,CAAC,GAAQ,EAAE,SAAiB;IAChD,MAAM,OAAO,GAAG,WAAW,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;IAC/C,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,GAAG,cAAc,EAAE,CAAC;IAC/C,MAAM,MAAM,GAAG,SAAS,KAAK,SAAS,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC,CAAC;IAEzF,IAAI,CAAC;QACH,+EAA+E;QAC/E,gDAAgD;QAChD,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,GAAG,EAAE;YAChC,MAAM;YACN,QAAQ,EAAE,OAAO;YACjB,OAAO,EAAE,EAAE,MAAM,EAAE,kBAAkB,EAAE;SACxC,CAAC,CAAC;QACH,OAAO,EAAE,MAAM,EAAE,QAAQ,CAAC,MAAM,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC,QAAQ,CAAC,EAAE,CAAC;IACxE,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IAAI,KAAK,YAAY,YAAY;YAAE,MAAM,KAAK,CAAC;QAC/C,IAAI,KAAK,YAAY,YAAY,IAAI,KAAK,CAAC,IAAI,KAAK,cAAc,EAAE,CAAC;YACnE,MAAM,IAAI,YAAY,CAAC,SAAS,EAAE,sCAAsC,EAAE;gBACxE,QAAQ,EAAE,kBAAkB;gBAC5B,SAAS,EAAE,IAAI;gBACf,KAAK,EAAE,KAAK;aACb,CAAC,CAAC;QACL,CAAC;QACD,IAAI,SAAS,EAAE,OAAO,KAAK,IAAI,EAAE,CAAC;YAChC,MAAM,IAAI,YAAY,CAAC,WAAW,EAAE,4BAA4B,CAAC,CAAC;QACpE,CAAC;QACD,MAAM,OAAO,CAAC,+BAA+B,EAAE,KAAK,CAAC,CAAC;IACxD,CAAC;AACH,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,oBAAoB,CACxC,OAAe,EACf,aAAgC,kBAAkB,EAClD,UAAkC,EAAE;IAEpC,aAAa,CAAC,OAAO,CAAC,CAAC;IAEvB,MAAM,GAAG,GAAG,IAAI,GAAG,CAAC,GAAG,GAAG,IAAI,UAAU,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;IACrD,GAAG,CAAC,YAAY,CAAC,GAAG,CAAC,YAAY,EAAE,IAAI,CAAC,SAAS,CAAC,UAAU,CAAC,CAAC,CAAC;IAE/D,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,GAAG,MAAM,OAAO,CAAC,GAAG,EAAE,OAAO,CAAC,SAAS,IAAI,kBAAkB,CAAC,CAAC;IAErF,2EAA2E;IAC3E,IAAI,MAAM,KAAK,GAAG;QAAE,OAAO,EAAE,CAAC;IAC9B,IAAI,MAAM,GAAG,GAAG,IAAI,MAAM,IAAI,GAAG,EAAE,CAAC;QAClC,MAAM,OAAO,CAAC,qCAAqC,MAAM,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;IACxE,CAAC;IAED,IAAI,IAAa,CAAC;IAClB,IAAI,CAAC;QACH,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAC1B,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,IAAI,YAAY,CACpB,oBAAoB,EACpB,wDAAwD,EACxD,EAAE,KAAK,EAAE,KAAK,EAAE,CACjB,CAAC;IACJ,CAAC;IAED,MAAM,MAAM,GAAG,cAAc,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;IAC9C,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;QACpB,MAAM,IAAI,YAAY,CACpB,oBAAoB,EACpB,6DAA6D,EAC7D,EAAE,KAAK,EAAE,MAAM,CAAC,KAAK,EAAE,CACxB,CAAC;IACJ,CAAC;IAED,OAAO,MAAM,CAAC,IAAI;SACf,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,OAAO,KAAK,OAAO,CAAC;SAC5C,OAAO,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,QAAQ,CAAC;SAClC,GAAG,CAAC,CAAC,EAAE,QAAQ,EAAE,OAAO,EAAE,CAAC,KAAK,EAAE,GAAG,CAAC,EAAE,KAAK,EAAE,EAAE,EAAE,CAAC,CAAC;QACpD,QAAQ;QACR,YAAY,EAAE,KAAK;QACnB,UAAU,EAAE,GAAG;QACf,eAAe,EAAE,GAAG,GAAG,KAAK;QAC5B,KAAK,EAAE,KAAK,IAAI,CAAC;KAClB,CAAC,CAAC;SACF,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,YAAY,GAAG,CAAC,CAAC,YAAY,CAAC,CAAC;AACrD,CAAC"}

package/dist/utils/store-health.d.ts

@@ -0,0 +1,37 @@
+/**
+ * What can be said about the store without harvesting anything.
+ *
+ * Integrity is checked here and nowhere else on the hot path: `quick_check` is
+ * bounded and catches the realistic failures, while the full `integrity_check`
+ * is O(database) and would add seconds to every server start on a store that
+ * is measured in gigabytes.
+ */
+export interface StoreHealth {
+    enabled: boolean;
+    path: string;
+    exists: boolean;
+    storeVersion?: number;
+    sizeBytes: number;
+    walBytes: number;
+    integrity: 'ok' | 'failed' | 'unchecked';
+    channels: number;
+    videos: number;
+    comments: number;
+    receipts: {
+        complete: number;
+        partial: number;
+        running: number;
+        failed: number;
+    };
+    error?: string;
+}
+export declare function readStoreHealth(): Promise<StoreHealth>;
+/**
+ * Whether the store should make an overall health report say "not ready".
+ *
+ * A missing store must not: a fresh install has none, and check_health's job
+ * is diagnosing the external binaries. A store that fails its integrity check,
+ * or claims a version this build does not understand, must.
+ */
+export declare function storeFailsHealth(health: StoreHealth): boolean;
+//# sourceMappingURL=store-health.d.ts.map

package/dist/utils/store-health.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"store-health.d.ts","sourceRoot":"","sources":["../../src/utils/store-health.ts"],"names":[],"mappings":"AAOA;;;;;;;GAOG;AAEH,MAAM,WAAW,WAAW;IAC1B,OAAO,EAAE,OAAO,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,OAAO,CAAC;IAChB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,IAAI,GAAG,QAAQ,GAAG,WAAW,CAAC;IACzC,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC;IACjF,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAiBD,wBAAsB,eAAe,IAAI,OAAO,CAAC,WAAW,CAAC,CA0D5D;AAED;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,WAAW,GAAG,OAAO,CAG7D"}

package/dist/utils/store-health.js

@@ -0,0 +1,92 @@
+import { stat } from 'node:fs/promises';
+import { z } from 'zod';
+import { countRows, queryRow } from './store-rows.js';
+import { getStore, readUserVersion } from './store.js';
+import { storeDatabasePath } from './store-paths.js';
+import { STORE_VERSION } from './store-schema.js';
+const quickCheckSchema = z.object({ quick_check: z.string() }).passthrough();
+const stateCountSchema = z.object({ state: z.string(), n: z.number() }).passthrough();
+async function sizeOf(path) {
+    try {
+        return (await stat(path)).size;
+    }
+    catch {
+        return 0;
+    }
+}
+function emptyReceipts() {
+    return { complete: 0, partial: 0, running: 0, failed: 0 };
+}
+export async function readStoreHealth() {
+    const path = storeDatabasePath();
+    const [sizeBytes, walBytes] = await Promise.all([sizeOf(path), sizeOf(`${path}-wal`)]);
+    const base = {
+        enabled: true,
+        path,
+        exists: sizeBytes > 0,
+        sizeBytes,
+        // A -wal file that never shrinks means a reader is pinning it, which is
+        // worth seeing before it becomes a disk-space surprise.
+        walBytes,
+        integrity: 'unchecked',
+        channels: 0,
+        videos: 0,
+        comments: 0,
+        receipts: emptyReceipts(),
+    };
+    try {
+        const store = await getStore();
+        const quick = queryRow(store.prepare('PRAGMA quick_check'), quickCheckSchema);
+        const receipts = emptyReceipts();
+        for (const row of store
+            .prepare('SELECT state, COUNT(*) AS n FROM harvest_receipt GROUP BY state')
+            .all()) {
+            const parsed = stateCountSchema.safeParse(row);
+            if (!parsed.success)
+                continue;
+            // A `state` this build does not know about is counted nowhere rather
+            // than crashing: the enum is allowed to grow ahead of this reader.
+            const { state, n } = parsed.data;
+            if (state === 'complete')
+                receipts.complete = n;
+            else if (state === 'partial')
+                receipts.partial = n;
+            else if (state === 'running')
+                receipts.running = n;
+            else if (state === 'failed')
+                receipts.failed = n;
+        }
+        return {
+            ...base,
+            storeVersion: readUserVersion(store),
+            integrity: quick?.quick_check === 'ok' ? 'ok' : 'failed',
+            channels: countRows(store.prepare('SELECT COUNT(*) FROM channel')),
+            videos: countRows(store.prepare('SELECT COUNT(*) FROM video')),
+            comments: countRows(store.prepare('SELECT COUNT(*) FROM comment')),
+            receipts,
+        };
+    }
+    catch (error) {
+        // A store that cannot be opened is a reportable condition, not a reason
+        // for check_health itself to fail: the binaries it exists to diagnose are
+        // unaffected.
+        return {
+            ...base,
+            enabled: false,
+            error: error instanceof Error ? error.message : String(error),
+        };
+    }
+}
+/**
+ * Whether the store should make an overall health report say "not ready".
+ *
+ * A missing store must not: a fresh install has none, and check_health's job
+ * is diagnosing the external binaries. A store that fails its integrity check,
+ * or claims a version this build does not understand, must.
+ */
+export function storeFailsHealth(health) {
+    if (health.integrity === 'failed')
+        return true;
+    return health.storeVersion !== undefined && health.storeVersion > STORE_VERSION;
+}
+//# sourceMappingURL=store-health.js.map

package/dist/utils/store-health.js.map

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

package/dist/utils/store-migrations.d.ts

@@ -0,0 +1,33 @@
+import type { DatabaseSync } from 'node:sqlite';
+/**
+ * Ordered schema migrations for the harvested store.
+ *
+ * `PRAGMA user_version` carries the store's version, deliberately independent
+ * of the server's semver: the schema changes far less often than the code, and
+ * tying them together would force an empty migration on every release.
+ *
+ * Version 0 means "no store yet". Creating the tables is `STORE_SCHEMA`'s job,
+ * not a migration's, so the first run only stamps the version.
+ */
+export interface StoreMigration {
+    /** The version this migration produces. */
+    to: number;
+    apply: (database: DatabaseSync) => void;
+}
+/**
+ * Empty on purpose at v1: `STORE_SCHEMA` is `CREATE TABLE IF NOT EXISTS`
+ * throughout, so a fresh database and an existing v1 database converge without
+ * one. The list exists so the second schema change is a one-line addition
+ * rather than a retrofit.
+ */
+export declare const STORE_MIGRATIONS: readonly StoreMigration[];
+/**
+ * Brings a database up to STORE_VERSION.
+ *
+ * Each migration runs inside its own transaction so a failure leaves the
+ * store at the last version that fully applied, rather than half-way through
+ * one. A newer-than-known version is rejected before this is reached, in
+ * `store.ts`.
+ */
+export declare function runStoreMigrations(database: DatabaseSync, fromVersion: number): number;
+//# sourceMappingURL=store-migrations.d.ts.map

package/dist/utils/store-migrations.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"store-migrations.d.ts","sourceRoot":"","sources":["../../src/utils/store-migrations.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAIhD;;;;;;;;;GASG;AAEH,MAAM,WAAW,cAAc;IAC7B,2CAA2C;IAC3C,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,CAAC,QAAQ,EAAE,YAAY,KAAK,IAAI,CAAC;CACzC;AAED;;;;;GAKG;AACH,eAAO,MAAM,gBAAgB,EAAE,SAAS,cAAc,EAAO,CAAC;AAE9D;;;;;;;GAOG;AACH,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,GAAG,MAAM,CAwBtF"}

package/dist/utils/store-migrations.js

@@ -0,0 +1,41 @@
+import { STORE_VERSION } from './store-schema.js';
+import { writeUserVersion } from './store.js';
+/**
+ * Empty on purpose at v1: `STORE_SCHEMA` is `CREATE TABLE IF NOT EXISTS`
+ * throughout, so a fresh database and an existing v1 database converge without
+ * one. The list exists so the second schema change is a one-line addition
+ * rather than a retrofit.
+ */
+export const STORE_MIGRATIONS = [];
+/**
+ * Brings a database up to STORE_VERSION.
+ *
+ * Each migration runs inside its own transaction so a failure leaves the
+ * store at the last version that fully applied, rather than half-way through
+ * one. A newer-than-known version is rejected before this is reached, in
+ * `store.ts`.
+ */
+export function runStoreMigrations(database, fromVersion) {
+    let current = fromVersion;
+    for (const migration of STORE_MIGRATIONS) {
+        if (migration.to <= current)
+            continue;
+        database.exec('BEGIN');
+        try {
+            migration.apply(database);
+            writeUserVersion(database, migration.to);
+            database.exec('COMMIT');
+        }
+        catch (error) {
+            database.exec('ROLLBACK');
+            throw error;
+        }
+        current = migration.to;
+    }
+    if (current !== STORE_VERSION) {
+        writeUserVersion(database, STORE_VERSION);
+        current = STORE_VERSION;
+    }
+    return current;
+}
+//# sourceMappingURL=store-migrations.js.map

package/dist/utils/store-migrations.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"store-migrations.js","sourceRoot":"","sources":["../../src/utils/store-migrations.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAClD,OAAO,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAmB9C;;;;;GAKG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAA8B,EAAE,CAAC;AAE9D;;;;;;;GAOG;AACH,MAAM,UAAU,kBAAkB,CAAC,QAAsB,EAAE,WAAmB;IAC5E,IAAI,OAAO,GAAG,WAAW,CAAC;IAE1B,KAAK,MAAM,SAAS,IAAI,gBAAgB,EAAE,CAAC;QACzC,IAAI,SAAS,CAAC,EAAE,IAAI,OAAO;YAAE,SAAS;QAEtC,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QACvB,IAAI,CAAC;YACH,SAAS,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;YAC1B,gBAAgB,CAAC,QAAQ,EAAE,SAAS,CAAC,EAAE,CAAC,CAAC;YACzC,QAAQ,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QAC1B,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,QAAQ,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;YAC1B,MAAM,KAAK,CAAC;QACd,CAAC;QACD,OAAO,GAAG,SAAS,CAAC,EAAE,CAAC;IACzB,CAAC;IAED,IAAI,OAAO,KAAK,aAAa,EAAE,CAAC;QAC9B,gBAAgB,CAAC,QAAQ,EAAE,aAAa,CAAC,CAAC;QAC1C,OAAO,GAAG,aAAa,CAAC;IAC1B,CAAC;IAED,OAAO,OAAO,CAAC;AACjB,CAAC"}