youtube-knowledge-mcp 2.1.0 → 3.0.0

package/dist/utils/storage.js

@@ -1,13 +1,14 @@
 import { join } from 'path';
 import { z } from 'zod';
-import { mkdir, readFile, rm, writeFile } from 'fs/promises';
+import { readFile, rm } from 'fs/promises';
 import { existsSync } from 'fs';
 import { YouTubeError } from './errors.js';
 import { hasCachedTranscript } from './youtube.js';
 import { SearchIndex } from './search-index.js';
 import { libraryMetadataSchema, recordOfValid } from '../schemas.js';
-import { readJsonFile, writeJsonAtomic } from './json-file.js';
-import { dataDir } from './paths.js';
+import { readJsonFile, writeFileAtomic, writeJsonAtomic } from './json-file.js';
+import { dataDir, ensurePrivateDir } from './paths.js';
+import { assertVideoId } from './validate.js';
 const LIBRARY_DIR = dataDir('library');
 const INDEX_FILE = dataDir('index.json');
 /**
@@ -21,8 +22,8 @@ export const libraryIndexSchema = z.object({
     items: recordOfValid(libraryMetadataSchema),
 });
 async function ensureDirectories() {
-    await mkdir(dataDir(), { recursive: true });
-    await mkdir(LIBRARY_DIR, { recursive: true });
+    await ensurePrivateDir(dataDir());
+    await ensurePrivateDir(LIBRARY_DIR);
 }
 async function loadIndex() {
     await ensureDirectories();
@@ -36,11 +37,11 @@ export async function saveToLibrary(options) {
     const { videoId, title, channel, url, content, contentType, tags = [] } = options;
     await ensureDirectories();
     const directory = itemDir(videoId);
-    await mkdir(directory, { recursive: true });
+    await ensurePrivateDir(directory);
     // Save content
     const filename = contentType === 'summary' ? 'summary.md' : 'skill.md';
     const filePath = join(directory, filename);
-    await writeFile(filePath, content, 'utf-8');
+    await writeFileAtomic(filePath, content);
     // Update metadata. Only the fields worth carrying forward need to survive
     // validation, so this is the metadata schema made optional field by field
     // rather than an "is an object" check that let anything through as metadata.
@@ -69,8 +70,13 @@ export async function saveToLibrary(options) {
 function withoutKey(record, key) {
     return Object.fromEntries(Object.entries(record).filter(([existing]) => existing !== key));
 }
+/**
+ * The only place a video id becomes a path. Validated here, exactly as
+ * `brainDir` validates a channel id, because a value like `../../x` would
+ * otherwise write — and, on delete, recursively remove — outside the library.
+ */
 function itemDir(videoId) {
-    return join(LIBRARY_DIR, videoId);
+    return join(LIBRARY_DIR, assertVideoId(videoId));
 }
 function metadataPath(videoId) {
     return join(itemDir(videoId), 'metadata.json');

package/dist/utils/storage.js.map

@@ -1 +1 @@
-{"version":3,"file":"storage.js","sourceRoot":"","sources":["../../src/utils/storage.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"storage.js","sourceRoot":"","sources":["../../src/utils/storage.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AAC5B,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,aAAa,CAAC;AAC3C,OAAO,EAAE,UAAU,EAAE,MAAM,IAAI,CAAC;AAChC,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAC3C,OAAO,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAC;AACnD,OAAO,EAAE,WAAW,EAAsB,MAAM,mBAAmB,CAAC;AACpE,OAAO,EAAE,qBAAqB,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AACrE,OAAO,EAAE,YAAY,EAAE,eAAe,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AAChF,OAAO,EAAE,OAAO,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AACvD,OAAO,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAE9C,MAAM,WAAW,GAAG,OAAO,CAAC,SAAS,CAAC,CAAC;AACvC,MAAM,UAAU,GAAG,OAAO,CAAC,YAAY,CAAC,CAAC;AAIzC;;;;;GAKG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC,CAAC,MAAM,CAAC;IACzC,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE;IACnB,KAAK,EAAE,aAAa,CAAC,qBAAqB,CAAC;CAC5C,CAAC,CAAC;AAIH,KAAK,UAAU,iBAAiB;IAC9B,MAAM,gBAAgB,CAAC,OAAO,EAAE,CAAC,CAAC;IAClC,MAAM,gBAAgB,CAAC,WAAW,CAAC,CAAC;AACtC,CAAC;AAED,KAAK,UAAU,SAAS;IACtB,MAAM,iBAAiB,EAAE,CAAC;IAC1B,OAAO,CAAC,MAAM,YAAY,CAAC,UAAU,EAAE,kBAAkB,CAAC,CAAC,IAAI,EAAE,OAAO,EAAE,CAAC,EAAE,KAAK,EAAE,EAAE,EAAE,CAAC;AAC3F,CAAC;AAED,KAAK,UAAU,SAAS,CAAC,KAAmB;IAC1C,MAAM,iBAAiB,EAAE,CAAC;IAC1B,MAAM,eAAe,CAAC,UAAU,EAAE,KAAK,CAAC,CAAC;AAC3C,CAAC;AAYD,MAAM,CAAC,KAAK,UAAU,aAAa,CACjC,OAAoB;IAEpB,MAAM,EAAE,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,GAAG,EAAE,OAAO,EAAE,WAAW,EAAE,IAAI,GAAG,EAAE,EAAE,GAAG,OAAO,CAAC;IAElF,MAAM,iBAAiB,EAAE,CAAC;IAE1B,MAAM,SAAS,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IACnC,MAAM,gBAAgB,CAAC,SAAS,CAAC,CAAC;IAElC,eAAe;IACf,MAAM,QAAQ,GAAG,WAAW,KAAK,SAAS,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,UAAU,CAAC;IACvE,MAAM,QAAQ,GAAG,IAAI,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAC;IAC3C,MAAM,eAAe,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;IAEzC,0EAA0E;IAC1E,0EAA0E;IAC1E,6EAA6E;IAC7E,MAAM,QAAQ,GACZ,CAAC,MAAM,YAAY,CAAC,YAAY,CAAC,OAAO,CAAC,EAAE,qBAAqB,CAAC,OAAO,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;IAErF,MAAM,eAAe,GAAoB;QACvC,OAAO;QACP,KAAK;QACL,OAAO,EAAE,OAAO,IAAI,QAAQ,CAAC,OAAO,IAAI,EAAE;QAC1C,GAAG,EAAE,GAAG,IAAI,QAAQ,CAAC,GAAG,IAAI,mCAAmC,OAAO,EAAE;QACxE,IAAI,EAAE,CAAC,GAAG,IAAI,GAAG,CAAC,CAAC,GAAG,CAAC,QAAQ,CAAC,IAAI,IAAI,EAAE,CAAC,EAAE,GAAG,IAAI,CAAC,CAAC,CAAC;QACvD,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;QACnC,yEAAyE;QACzE,qDAAqD;QACrD,aAAa,EAAE,mBAAmB,CAAC,OAAO,CAAC;QAC3C,UAAU,EAAE,WAAW,KAAK,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,UAAU,IAAI,KAAK,CAAC;QAC7E,QAAQ,EAAE,WAAW,KAAK,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,QAAQ,IAAI,KAAK,CAAC;KACxE,CAAC;IAEF,MAAM,aAAa,CAAC,eAAe,CAAC,CAAC;IAErC,eAAe;IACf,MAAM,KAAK,GAAG,MAAM,SAAS,EAAE,CAAC;IAChC,KAAK,CAAC,KAAK,CAAC,OAAO,CAAC,GAAG,eAAe,CAAC;IACvC,MAAM,SAAS,CAAC,KAAK,CAAC,CAAC;IAEvB,MAAM,aAAa,CAAC,OAAO,EAAE,KAAK,EAAE,WAAW,EAAE,OAAO,CAAC,CAAC;IAE1D,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC;AACzC,CAAC;AAcD,SAAS,UAAU,CAAI,MAAyB,EAAE,GAAW;IAC3D,OAAO,MAAM,CAAC,WAAW,CAAC,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC,QAAQ,KAAK,GAAG,CAAC,CAAC,CAAC;AAC7F,CAAC;AAED;;;;GAIG;AACH,SAAS,OAAO,CAAC,OAAe;IAC9B,OAAO,IAAI,CAAC,WAAW,EAAE,aAAa,CAAC,OAAO,CAAC,CAAC,CAAC;AACnD,CAAC;AAED,SAAS,YAAY,CAAC,OAAe;IACnC,OAAO,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,eAAe,CAAC,CAAC;AACjD,CAAC;AAED,KAAK,UAAU,aAAa,CAAC,QAAyB;IACpD,MAAM,eAAe,CAAC,YAAY,CAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,QAAQ,CAAC,CAAC;AAClE,CAAC;AAED,KAAK,UAAU,aAAa,CAAC,IAAY;IACvC,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC;QAAE,OAAO,SAAS,CAAC;IACxC,OAAO,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;AACjC,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,cAAc,CAClC,OAAe,EACf,WAAiC;IAEjC,MAAM,KAAK,GAAG,MAAM,SAAS,EAAE,CAAC;IAChC,MAAM,QAAQ,GAAG,KAAK,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;IAEtC,IAAI,CAAC,QAAQ,EAAE,CAAC;QACd,MAAM,IAAI,YAAY,CAAC,WAAW,EAAE,2BAA2B,OAAO,GAAG,EAAE;YACzE,QAAQ,EAAE,uEAAuE;SAClF,CAAC,CAAC;IACL,CAAC;IAED,MAAM,IAAI,GAAgB,EAAE,QAAQ,EAAE,CAAC;IAEvC,IAAI,WAAW,KAAK,SAAS,IAAI,WAAW,KAAK,SAAS,EAAE,CAAC;QAC3D,IAAI,CAAC,OAAO,GAAG,MAAM,aAAa,CAAC,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,YAAY,CAAC,CAAC,CAAC;IAC3E,CAAC;IACD,IAAI,WAAW,KAAK,SAAS,IAAI,WAAW,KAAK,OAAO,EAAE,CAAC;QACzD,IAAI,CAAC,KAAK,GAAG,MAAM,aAAa,CAAC,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,UAAU,CAAC,CAAC,CAAC;IACvE,CAAC;IAED,IAAI,IAAI,CAAC,OAAO,KAAK,SAAS,IAAI,IAAI,CAAC,KAAK,KAAK,SAAS,EAAE,CAAC;QAC3D,MAAM,IAAI,YAAY,CAAC,WAAW,EAAE,MAAM,WAAW,IAAI,SAAS,cAAc,OAAO,GAAG,EAAE;YAC1F,QAAQ,EAAE,oEAAoE;SAC/E,CAAC,CAAC;IACL,CAAC;IAED,OAAO,IAAI,CAAC;AACd,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,iBAAiB,CACrC,OAAe,EACf,WAAiC;IAEjC,MAAM,KAAK,GAAG,MAAM,SAAS,EAAE,CAAC;IAChC,MAAM,QAAQ,GAAG,KAAK,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;IAEtC,IAAI,CAAC,QAAQ,EAAE,CAAC;QACd,MAAM,IAAI,YAAY,CAAC,WAAW,EAAE,2BAA2B,OAAO,GAAG,EAAE;YACzE,QAAQ,EAAE,yCAAyC;SACpD,CAAC,CAAC;IACL,CAAC;IAED,6EAA6E;IAC7E,2BAA2B;IAC3B,IAAI,WAAW,KAAK,SAAS,EAAE,CAAC;QAC9B,MAAM,EAAE,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;QAC7D,KAAK,CAAC,KAAK,GAAG,UAAU,CAAC,KAAK,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;QAC/C,MAAM,SAAS,CAAC,KAAK,CAAC,CAAC;QACvB,MAAM,eAAe,CAAC,OAAO,CAAC,CAAC;QAC/B,OAAO,EAAE,OAAO,EAAE,CAAC,SAAS,EAAE,OAAO,EAAE,UAAU,CAAC,EAAE,CAAC;IACvD,CAAC;IAED,MAAM,QAAQ,GAAG,WAAW,KAAK,SAAS,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,UAAU,CAAC;IACvE,MAAM,EAAE,CAAC,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,QAAQ,CAAC,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;IAE5D,MAAM,OAAO,GAAoB;QAC/B,GAAG,QAAQ;QACX,UAAU,EAAE,WAAW,KAAK,SAAS,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,QAAQ,CAAC,UAAU;QACnE,QAAQ,EAAE,WAAW,KAAK,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,QAAQ,CAAC,QAAQ;KAC9D,CAAC;IAEF,IAAI,CAAC,OAAO,CAAC,UAAU,IAAI,CAAC,OAAO,CAAC,QAAQ,EAAE,CAAC;QAC7C,MAAM,EAAE,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;QAC7D,KAAK,CAAC,KAAK,GAAG,UAAU,CAAC,KAAK,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;IACjD,CAAC;SAAM,CAAC;QACN,KAAK,CAAC,KAAK,CAAC,OAAO,CAAC,GAAG,OAAO,CAAC;QAC/B,MAAM,aAAa,CAAC,OAAO,CAAC,CAAC;IAC/B,CAAC;IAED,MAAM,SAAS,CAAC,KAAK,CAAC,CAAC;IACvB,MAAM,eAAe,CAAC,OAAO,EAAE,WAAW,CAAC,CAAC;IAC5C,OAAO,EAAE,OAAO,EAAE,CAAC,WAAW,CAAC,EAAE,CAAC;AACpC,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,iBAAiB,CACrC,OAAe,EACf,OAAkE;IAElE,MAAM,KAAK,GAAG,MAAM,SAAS,EAAE,CAAC;IAChC,MAAM,QAAQ,GAAG,KAAK,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;IAEtC,IAAI,CAAC,QAAQ,EAAE,CAAC;QACd,MAAM,IAAI,YAAY,CAAC,WAAW,EAAE,2BAA2B,OAAO,GAAG,EAAE;YACzE,QAAQ,EAAE,yCAAyC;SACpD,CAAC,CAAC;IACL,CAAC;IAED,MAAM,QAAQ,GAAG,IAAI,GAAG,CAAC,CAAC,OAAO,CAAC,MAAM,IAAI,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC;IACjF,MAAM,IAAI,GAAG,OAAO,CAAC,OAAO,IAAI,QAAQ,CAAC,IAAI,CAAC;IAC9C,MAAM,IAAI,GAAG,CAAC,GAAG,IAAI,GAAG,CAAC,CAAC,GAAG,IAAI,EAAE,GAAG,CAAC,OAAO,CAAC,GAAG,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,CACjE,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC,QAAQ,CAAC,GAAG,CAAC,GAAG,CAAC,WAAW,EAAE,CAAC,CAC1C,CAAC;IAEF,MAAM,OAAO,GAAoB,EAAE,GAAG,QAAQ,EAAE,IAAI,EAAE,CAAC;IACvD,KAAK,CAAC,KAAK,CAAC,OAAO,CAAC,GAAG,OAAO,CAAC;IAC/B,MAAM,SAAS,CAAC,KAAK,CAAC,CAAC;IACvB,MAAM,aAAa,CAAC,OAAO,CAAC,CAAC;IAE7B,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,yDAAyD;AACzD,MAAM,CAAC,KAAK,UAAU,QAAQ;IAC5B,MAAM,KAAK,GAAG,MAAM,SAAS,EAAE,CAAC;IAChC,MAAM,IAAI,GAAG,IAAI,GAAG,EAAU,CAAC;IAC/B,KAAK,MAAM,IAAI,IAAI,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,EAAE,CAAC;QAC9C,KAAK,MAAM,GAAG,IAAI,IAAI,CAAC,IAAI;YAAE,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;IAC7C,CAAC;IACD,OAAO,CAAC,GAAG,IAAI,CAAC,CAAC,IAAI,EAAE,CAAC;AAC1B,CAAC;AAED,2EAA2E;AAE3E,MAAM,iBAAiB,GAAG,OAAO,CAAC,mBAAmB,CAAC,CAAC;AAEvD,KAAK,UAAU,eAAe;IAC5B,MAAM,iBAAiB,EAAE,CAAC;IAC1B,6EAA6E;IAC7E,0EAA0E;IAC1E,OAAO,WAAW,CAAC,QAAQ,CAAC,MAAM,YAAY,CAAC,iBAAiB,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC;AAClF,CAAC;AAED,KAAK,UAAU,kBAAkB,CAAC,KAAkB;IAClD,iFAAiF;IACjF,MAAM,eAAe,CAAC,iBAAiB,EAAE,KAAK,CAAC,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,CAAC;AAC9E,CAAC;AAED,KAAK,UAAU,aAAa,CAC1B,OAAe,EACf,KAAa,EACb,IAAY,EACZ,IAAY;IAEZ,MAAM,KAAK,GAAG,MAAM,eAAe,EAAE,CAAC;IACtC,KAAK,CAAC,GAAG,CAAC,EAAE,EAAE,EAAE,GAAG,OAAO,IAAI,IAAI,EAAE,EAAE,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;IACpE,MAAM,kBAAkB,CAAC,KAAK,CAAC,CAAC;AAClC,CAAC;AAED,KAAK,UAAU,eAAe,CAAC,OAAe,EAAE,IAAa;IAC3D,MAAM,KAAK,GAAG,MAAM,eAAe,EAAE,CAAC;IACtC,IAAI,IAAI,KAAK,SAAS,EAAE,CAAC;QACvB,KAAK,MAAM,IAAI,IAAI,CAAC,SAAS,EAAE,OAAO,CAAC;YAAE,KAAK,CAAC,MAAM,CAAC,GAAG,OAAO,IAAI,IAAI,EAAE,CAAC,CAAC;IAC9E,CAAC;SAAM,CAAC;QACN,KAAK,CAAC,MAAM,CAAC,GAAG,OAAO,IAAI,IAAI,EAAE,CAAC,CAAC;IACrC,CAAC;IACD,MAAM,kBAAkB,CAAC,KAAK,CAAC,CAAC;AAClC,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,aAAa,CAAC,KAAa,EAAE,KAAK,GAAG,EAAE,EAAE,MAAM,GAAG,CAAC;IACvE,MAAM,KAAK,GAAG,MAAM,eAAe,EAAE,CAAC;IACtC,OAAO,KAAK,CAAC,MAAM,CAAC,KAAK,EAAE,KAAK,EAAE,MAAM,CAAC,CAAC;AAC5C,CAAC;AAED,uDAAuD;AACvD,MAAM,CAAC,KAAK,UAAU,kBAAkB;IACtC,MAAM,YAAY,GAAG,MAAM,SAAS,EAAE,CAAC;IACvC,MAAM,KAAK,GAAG,IAAI,WAAW,EAAE,CAAC;IAEhC,KAAK,MAAM,QAAQ,IAAI,MAAM,CAAC,MAAM,CAAC,YAAY,CAAC,KAAK,CAAC,EAAE,CAAC;QACzD,KAAK,MAAM,IAAI,IAAI,CAAC,SAAS,EAAE,OAAO,CAAU,EAAE,CAAC;YACjD,MAAM,IAAI,GAAG,MAAM,aAAa,CAAC,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,GAAG,IAAI,KAAK,CAAC,CAAC,CAAC;YAChF,IAAI,IAAI,KAAK,SAAS,EAAE,CAAC;gBACvB,KAAK,CAAC,GAAG,CAAC;oBACR,EAAE,EAAE,GAAG,QAAQ,CAAC,OAAO,IAAI,IAAI,EAAE;oBACjC,OAAO,EAAE,QAAQ,CAAC,OAAO;oBACzB,KAAK,EAAE,QAAQ,CAAC,KAAK;oBACrB,IAAI;oBACJ,IAAI;iBACL,CAAC,CAAC;YACL,CAAC;QACH,CAAC;IACH,CAAC;IAED,MAAM,kBAAkB,CAAC,KAAK,CAAC,CAAC;IAChC,OAAO,EAAE,SAAS,EAAE,KAAK,CAAC,IAAI,EAAE,CAAC;AACnC,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,WAAW,CAAC,MAAyB;IACzD,MAAM,KAAK,GAAG,MAAM,SAAS,EAAE,CAAC;IAChC,IAAI,KAAK,GAAG,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;IAEvC,IAAI,MAAM,EAAE,GAAG,EAAE,CAAC;QAChB,MAAM,QAAQ,GAAG,MAAM,CAAC,GAAG,CAAC,WAAW,EAAE,CAAC;QAC1C,KAAK,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC;IAC5F,CAAC;IAED,yCAAyC;IACzC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,IAAI,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,OAAO,EAAE,GAAG,IAAI,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC;IAExF,OAAO,KAAK,CAAC;AACf,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"}

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

@@ -0,0 +1,33 @@
+/**
+ * Every file the harvested store is made of.
+ *
+ * The only module that names `dataDir('store')`, so a later decision to shard
+ * the database by channel touches one file rather than every caller — the same
+ * reason `brain-paths.ts` exists.
+ *
+ * The `-wal` and `-shm` sidecars are created and removed by SQLite itself, not
+ * by us. They are the one place in this codebase where a file under the data
+ * directory is not written through `writeJsonAtomic`, and that exception is
+ * confined to the `store*.ts` modules.
+ */
+export declare function storeDir(): string;
+export declare function storeDatabasePath(): string;
+/**
+ * Where a database that failed its integrity check is moved to.
+ *
+ * Renamed rather than deleted: a harvest costs hours of network that no local
+ * cache can replay, so nothing here removes one without the user asking.
+ */
+export declare function corruptStorePath(at: number): string;
+/** Taken before a migration that would change an existing `user_version`. */
+export declare function preMigrationBackupPath(fromVersion: number): string;
+/**
+ * Job-level exclusion, which WAL does not provide.
+ *
+ * WAL keeps concurrent writes consistent; it does not stop two harvests of the
+ * same channel from spawning yt-dlp twice and doubling the request rate at the
+ * one thing that throttles us.
+ */
+export declare function channelHarvestLockPath(channelId: string): string;
+export declare function videoHarvestLockPath(videoId: string): string;
+//# sourceMappingURL=store-paths.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"store-paths.d.ts","sourceRoot":"","sources":["../../src/utils/store-paths.ts"],"names":[],"mappings":"AAIA;;;;;;;;;;;GAWG;AAEH,wBAAgB,QAAQ,IAAI,MAAM,CAEjC;AAED,wBAAgB,iBAAiB,IAAI,MAAM,CAE1C;AAED;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,CAEnD;AAED,6EAA6E;AAC7E,wBAAgB,sBAAsB,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,CAElE;AAED;;;;;;GAMG;AACH,wBAAgB,sBAAsB,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAEhE;AAED,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAE5D"}

package/dist/utils/store-paths.js

@@ -0,0 +1,48 @@
+import { join } from 'node:path';
+import { dataDir } from './paths.js';
+import { assertChannelId, assertVideoId } from './validate.js';
+/**
+ * Every file the harvested store is made of.
+ *
+ * The only module that names `dataDir('store')`, so a later decision to shard
+ * the database by channel touches one file rather than every caller — the same
+ * reason `brain-paths.ts` exists.
+ *
+ * The `-wal` and `-shm` sidecars are created and removed by SQLite itself, not
+ * by us. They are the one place in this codebase where a file under the data
+ * directory is not written through `writeJsonAtomic`, and that exception is
+ * confined to the `store*.ts` modules.
+ */
+export function storeDir() {
+    return dataDir('store');
+}
+export function storeDatabasePath() {
+    return join(storeDir(), 'knowledge.db');
+}
+/**
+ * Where a database that failed its integrity check is moved to.
+ *
+ * Renamed rather than deleted: a harvest costs hours of network that no local
+ * cache can replay, so nothing here removes one without the user asking.
+ */
+export function corruptStorePath(at) {
+    return join(storeDir(), `knowledge.corrupt-${String(at)}.db`);
+}
+/** Taken before a migration that would change an existing `user_version`. */
+export function preMigrationBackupPath(fromVersion) {
+    return join(storeDir(), `knowledge.pre-v${String(fromVersion)}.db`);
+}
+/**
+ * Job-level exclusion, which WAL does not provide.
+ *
+ * WAL keeps concurrent writes consistent; it does not stop two harvests of the
+ * same channel from spawning yt-dlp twice and doubling the request rate at the
+ * one thing that throttles us.
+ */
+export function channelHarvestLockPath(channelId) {
+    return join(storeDir(), `harvest.${assertChannelId(channelId)}.lock`);
+}
+export function videoHarvestLockPath(videoId) {
+    return join(storeDir(), `harvest.${assertVideoId(videoId)}.lock`);
+}
+//# sourceMappingURL=store-paths.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"store-paths.js","sourceRoot":"","sources":["../../src/utils/store-paths.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AACrC,OAAO,EAAE,eAAe,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAE/D;;;;;;;;;;;GAWG;AAEH,MAAM,UAAU,QAAQ;IACtB,OAAO,OAAO,CAAC,OAAO,CAAC,CAAC;AAC1B,CAAC;AAED,MAAM,UAAU,iBAAiB;IAC/B,OAAO,IAAI,CAAC,QAAQ,EAAE,EAAE,cAAc,CAAC,CAAC;AAC1C,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,gBAAgB,CAAC,EAAU;IACzC,OAAO,IAAI,CAAC,QAAQ,EAAE,EAAE,qBAAqB,MAAM,CAAC,EAAE,CAAC,KAAK,CAAC,CAAC;AAChE,CAAC;AAED,6EAA6E;AAC7E,MAAM,UAAU,sBAAsB,CAAC,WAAmB;IACxD,OAAO,IAAI,CAAC,QAAQ,EAAE,EAAE,kBAAkB,MAAM,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC;AACtE,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,sBAAsB,CAAC,SAAiB;IACtD,OAAO,IAAI,CAAC,QAAQ,EAAE,EAAE,WAAW,eAAe,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC;AACxE,CAAC;AAED,MAAM,UAAU,oBAAoB,CAAC,OAAe;IAClD,OAAO,IAAI,CAAC,QAAQ,EAAE,EAAE,WAAW,aAAa,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;AACpE,CAAC"}

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

@@ -0,0 +1,22 @@
+import type { StatementSync } from 'node:sqlite';
+import { z } from 'zod';
+/**
+ * Reading rows back out of the store, validated.
+ *
+ * `StatementSync.all()` is typed `Record<string, SQLOutputValue>[]` — usefully
+ * honest, and unusable directly. Every read goes through a zod schema here,
+ * the same contract `readJsonFile` and `parseYtDlpJson` already apply to the
+ * other two places untyped data enters this server. No `as` anywhere.
+ */
+/**
+ * SQLite `STRICT` tables have no BOOLEAN, so flags are stored as 0 or 1.
+ * Decoded with an explicit transform rather than a cast, which also rejects a
+ * 2 that some future writer might smuggle in.
+ */
+export declare const sqliteBoolean: z.ZodEffects<z.ZodUnion<[z.ZodLiteral<0>, z.ZodLiteral<1>]>, boolean, 0 | 1>;
+export declare function queryRows<T extends z.ZodTypeAny>(statement: StatementSync, schema: T, ...params: readonly (string | number | null)[]): z.output<T>[];
+/** The single-row form. Returns undefined when the statement matched nothing. */
+export declare function queryRow<T extends z.ZodTypeAny>(statement: StatementSync, schema: T, ...params: readonly (string | number | null)[]): z.output<T> | undefined;
+/** `SELECT COUNT(*)` is the one query whose shape is always the same. */
+export declare function countRows(statement: StatementSync, ...params: readonly (string | number | null)[]): number;
+//# sourceMappingURL=store-rows.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"store-rows.d.ts","sourceRoot":"","sources":["../../src/utils/store-rows.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AACjD,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB;;;;;;;GAOG;AAEH;;;;GAIG;AACH,eAAO,MAAM,aAAa,8EAEU,CAAC;AA8BrC,wBAAgB,SAAS,CAAC,CAAC,SAAS,CAAC,CAAC,UAAU,EAC9C,SAAS,EAAE,aAAa,EACxB,MAAM,EAAE,CAAC,EACT,GAAG,MAAM,EAAE,SAAS,CAAC,MAAM,GAAG,MAAM,GAAG,IAAI,CAAC,EAAE,GAC7C,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAEf;AAED,iFAAiF;AACjF,wBAAgB,QAAQ,CAAC,CAAC,SAAS,CAAC,CAAC,UAAU,EAC7C,SAAS,EAAE,aAAa,EACxB,MAAM,EAAE,CAAC,EACT,GAAG,MAAM,EAAE,SAAS,CAAC,MAAM,GAAG,MAAM,GAAG,IAAI,CAAC,EAAE,GAC7C,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,GAAG,SAAS,CAQzB;AAED,yEAAyE;AACzE,wBAAgB,SAAS,CACvB,SAAS,EAAE,aAAa,EACxB,GAAG,MAAM,EAAE,SAAS,CAAC,MAAM,GAAG,MAAM,GAAG,IAAI,CAAC,EAAE,GAC7C,MAAM,CAMR"}

package/dist/utils/store-rows.js

@@ -0,0 +1,62 @@
+import { z } from 'zod';
+import { YouTubeError } from './errors.js';
+/**
+ * Reading rows back out of the store, validated.
+ *
+ * `StatementSync.all()` is typed `Record<string, SQLOutputValue>[]` — usefully
+ * honest, and unusable directly. Every read goes through a zod schema here,
+ * the same contract `readJsonFile` and `parseYtDlpJson` already apply to the
+ * other two places untyped data enters this server. No `as` anywhere.
+ */
+/**
+ * SQLite `STRICT` tables have no BOOLEAN, so flags are stored as 0 or 1.
+ * Decoded with an explicit transform rather than a cast, which also rejects a
+ * 2 that some future writer might smuggle in.
+ */
+export const sqliteBoolean = z
+    .union([z.literal(0), z.literal(1)])
+    .transform((value) => value === 1);
+function describe(error) {
+    return error.issues
+        .slice(0, 3)
+        .map((issue) => `${issue.path.join('.') || '(row)'}: ${issue.message}`)
+        .join('; ');
+}
+/**
+ * Runs a statement and validates every row.
+ *
+ * A row that does not match is a bug in this server, not something a caller
+ * can fix, so it fails loudly rather than being skipped — the opposite of
+ * `recordOfValid`, which drops a bad entry because there the bad entry came
+ * from YouTube.
+ */
+function parseAll(schema, rows) {
+    const parsed = z.array(schema).safeParse(rows);
+    if (parsed.success)
+        return parsed.data;
+    throw new YouTubeError('MALFORMED_RESPONSE', 'A row in the harvested store had an unexpected shape.', {
+        nextStep: `This is a bug in the server, not in your request. Details: ${describe(parsed.error)}`,
+    });
+}
+export function queryRows(statement, schema, ...params) {
+    return parseAll(schema, statement.all(...params));
+}
+/** The single-row form. Returns undefined when the statement matched nothing. */
+export function queryRow(statement, schema, ...params) {
+    const row = statement.get(...params);
+    if (row === undefined)
+        return undefined;
+    // Parsed through `z.array(schema)` rather than `schema` directly: a bare
+    // generic `safeParse` widens its result to `any`, which would let every
+    // later misuse through unchecked. This also shares one error message.
+    return parseAll(schema, [row])[0];
+}
+/** `SELECT COUNT(*)` is the one query whose shape is always the same. */
+export function countRows(statement, ...params) {
+    const row = queryRow(statement, z.object({}).passthrough(), ...params);
+    if (row === undefined)
+        return 0;
+    const first = Object.values(row)[0];
+    return typeof first === 'number' ? first : 0;
+}
+//# sourceMappingURL=store-rows.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"store-rows.js","sourceRoot":"","sources":["../../src/utils/store-rows.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAE3C;;;;;;;GAOG;AAEH;;;;GAIG;AACH,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC;KAC3B,KAAK,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC;KACnC,SAAS,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,KAAK,CAAC,CAAC,CAAC;AAErC,SAAS,QAAQ,CAAC,KAAiB;IACjC,OAAO,KAAK,CAAC,MAAM;SAChB,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC;SACX,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,GAAG,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,OAAO,KAAK,KAAK,CAAC,OAAO,EAAE,CAAC;SACtE,IAAI,CAAC,IAAI,CAAC,CAAC;AAChB,CAAC;AAED;;;;;;;GAOG;AACH,SAAS,QAAQ,CAAyB,MAAS,EAAE,IAAe;IAClE,MAAM,MAAM,GAAG,CAAC,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;IAC/C,IAAI,MAAM,CAAC,OAAO;QAAE,OAAO,MAAM,CAAC,IAAI,CAAC;IAEvC,MAAM,IAAI,YAAY,CACpB,oBAAoB,EACpB,uDAAuD,EACvD;QACE,QAAQ,EAAE,8DAA8D,QAAQ,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE;KACjG,CACF,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,SAAS,CACvB,SAAwB,EACxB,MAAS,EACT,GAAG,MAA2C;IAE9C,OAAO,QAAQ,CAAC,MAAM,EAAE,SAAS,CAAC,GAAG,CAAC,GAAG,MAAM,CAAC,CAAC,CAAC;AACpD,CAAC;AAED,iFAAiF;AACjF,MAAM,UAAU,QAAQ,CACtB,SAAwB,EACxB,MAAS,EACT,GAAG,MAA2C;IAE9C,MAAM,GAAG,GAAG,SAAS,CAAC,GAAG,CAAC,GAAG,MAAM,CAAC,CAAC;IACrC,IAAI,GAAG,KAAK,SAAS;QAAE,OAAO,SAAS,CAAC;IAExC,yEAAyE;IACzE,wEAAwE;IACxE,sEAAsE;IACtE,OAAO,QAAQ,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;AACpC,CAAC;AAED,yEAAyE;AACzE,MAAM,UAAU,SAAS,CACvB,SAAwB,EACxB,GAAG,MAA2C;IAE9C,MAAM,GAAG,GAAG,QAAQ,CAAC,SAAS,EAAE,CAAC,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,WAAW,EAAE,EAAE,GAAG,MAAM,CAAC,CAAC;IACvE,IAAI,GAAG,KAAK,SAAS;QAAE,OAAO,CAAC,CAAC;IAEhC,MAAM,KAAK,GAAG,MAAM,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;IACpC,OAAO,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;AAC/C,CAAC"}

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

@@ -0,0 +1,16 @@
+/**
+ * The shape of the harvested store, as one reviewable unit.
+ *
+ * Kept apart from the module that opens the database so the schema can be read
+ * end to end without the connection handling in the way.
+ *
+ * `STRICT` on every table: SQLite's default type affinity would silently accept
+ * a string where a count belongs, and this store exists to make claims about
+ * counts. It has no BOOLEAN, so flags are 0/1 integers decoded explicitly on
+ * the way out (see store-rows.ts) rather than cast.
+ */
+/** Bumped only by a migration in store-migrations.ts. Independent of the server's semver. */
+export declare const STORE_VERSION = 1;
+export declare const STORE_PRAGMAS: readonly ["PRAGMA journal_mode = WAL", "PRAGMA synchronous = NORMAL", "PRAGMA foreign_keys = ON", "PRAGMA temp_store = MEMORY"];
+export declare const STORE_SCHEMA = "\nCREATE TABLE IF NOT EXISTS meta (\n  key   TEXT PRIMARY KEY,\n  value TEXT NOT NULL\n) STRICT;\n\nCREATE TABLE IF NOT EXISTS channel (\n  channel_id       TEXT PRIMARY KEY,\n  handle           TEXT    NOT NULL DEFAULT '',\n  name             TEXT    NOT NULL DEFAULT '',\n  channel_url      TEXT    NOT NULL DEFAULT '',\n  subscriber_count INTEGER,\n  description      TEXT    NOT NULL DEFAULT '',\n  avatar_url       TEXT,\n  banner_url       TEXT,\n  first_seen_at    INTEGER NOT NULL,\n  updated_at       INTEGER NOT NULL\n) STRICT;\n\nCREATE TABLE IF NOT EXISTS video (\n  video_id      TEXT PRIMARY KEY,\n  channel_id    TEXT REFERENCES channel(channel_id) ON DELETE CASCADE,\n  title         TEXT    NOT NULL DEFAULT '',\n  duration_s    INTEGER,\n  -- 'YYYY-MM-DD'. NULL, never '', when a flat listing carried none: a date\n  -- filter must be able to tell \"not known yet\" from \"known to be empty\".\n  upload_date   TEXT,\n  view_count    INTEGER,\n  like_count    INTEGER,\n  -- YouTube's own claim, read WITHOUT --write-comments, which overwrites it\n  -- with the number extracted. This is the denominator every comment receipt\n  -- is measured against, so it may only ever come from a metadata pass.\n  comment_count INTEGER,\n  live_status   TEXT,\n  availability  TEXT,\n  thumbnail_url TEXT,\n  tab           TEXT,\n  also_in_tabs  TEXT    NOT NULL DEFAULT '[]',\n  catalog_rank  INTEGER,\n  listed_at     INTEGER,\n  detail_at     INTEGER,\n  -- Stripped before storage: formats, automatic_captions, subtitles,\n  -- thumbnails and comments are 96% of a raw -j payload and are mostly\n  -- expiring URLs. See MAX_DETAIL_JSON_BYTES.\n  detail_json   TEXT,\n  heatmap_json  TEXT\n) STRICT;\n\nCREATE INDEX IF NOT EXISTS video_by_channel ON video(channel_id, catalog_rank);\nCREATE INDEX IF NOT EXISTS video_by_date    ON video(channel_id, upload_date DESC);\n\nCREATE TABLE IF NOT EXISTS comment (\n  comment_id         TEXT PRIMARY KEY,\n  video_id           TEXT    NOT NULL REFERENCES video(video_id) ON DELETE CASCADE,\n  -- NULL for a top-level comment. yt-dlp writes the string 'root'; normalising\n  -- it here means a reply count is a COUNT(parent_id) rather than a filter\n  -- everyone has to remember.\n  parent_id          TEXT,\n  text               TEXT    NOT NULL DEFAULT '',\n  like_count         INTEGER NOT NULL DEFAULT 0,\n  author             TEXT    NOT NULL DEFAULT '',\n  author_id          TEXT,\n  author_url         TEXT,\n  author_thumbnail   TEXT,\n  author_is_uploader INTEGER NOT NULL DEFAULT 0,\n  author_is_verified INTEGER NOT NULL DEFAULT 0,\n  is_pinned          INTEGER NOT NULL DEFAULT 0,\n  is_favorited       INTEGER NOT NULL DEFAULT 0,\n  time_text          TEXT,\n  published_at       INTEGER,\n  harvested_at       INTEGER NOT NULL\n) STRICT;\n\nCREATE INDEX IF NOT EXISTS comment_by_video  ON comment(video_id, parent_id, like_count DESC);\nCREATE INDEX IF NOT EXISTS comment_by_parent ON comment(parent_id);\nCREATE INDEX IF NOT EXISTS comment_by_author ON comment(author_id);\nCREATE INDEX IF NOT EXISTS comment_by_time   ON comment(video_id, published_at);\n\nCREATE VIRTUAL TABLE IF NOT EXISTS comment_fts USING fts5(\n  text,\n  content       = 'comment',\n  content_rowid = 'rowid',\n  tokenize      = \"unicode61 remove_diacritics 2\"\n);\n\n-- Triggers rather than a periodic 'rebuild'. Measured: triggers cost 6.2x on\n-- bulk insert (2.3s vs 366ms per 200k rows) while 'rebuild' is O(whole table)\n-- and would take seconds per checkpoint at millions of rows. Against a network\n-- that delivers ~17 comments/second, the trigger cost is noise, and there is no\n-- \"did we remember to rebuild\" failure mode.\nCREATE TRIGGER IF NOT EXISTS comment_ai AFTER INSERT ON comment BEGIN\n  INSERT INTO comment_fts(rowid, text) VALUES (new.rowid, new.text);\nEND;\nCREATE TRIGGER IF NOT EXISTS comment_ad AFTER DELETE ON comment BEGIN\n  INSERT INTO comment_fts(comment_fts, rowid, text) VALUES ('delete', old.rowid, old.text);\nEND;\nCREATE TRIGGER IF NOT EXISTS comment_au AFTER UPDATE ON comment BEGIN\n  INSERT INTO comment_fts(comment_fts, rowid, text) VALUES ('delete', old.rowid, old.text);\n  INSERT INTO comment_fts(rowid, text) VALUES (new.rowid, new.text);\nEND;\n\n-- What this store can prove about one target. Written in the SAME transaction\n-- as the rows it describes, so there is no interval in which a receipt can\n-- claim something the store does not hold.\nCREATE TABLE IF NOT EXISTS harvest_receipt (\n  scope             TEXT    NOT NULL,\n  target_id         TEXT    NOT NULL,\n  state             TEXT    NOT NULL,\n  reason            TEXT    NOT NULL,\n  have              INTEGER NOT NULL DEFAULT 0,\n  -- What the SOURCE stated. NULL when it stated nothing; never derived from\n  -- 'have', which would turn \"we stopped\" into \"there was nothing more\".\n  expected          INTEGER,\n  expected_source   TEXT,\n  source            TEXT    NOT NULL,\n  limit_applied     INTEGER,\n  sort_applied      TEXT,\n  ran_to_exhaustion INTEGER,\n  resume_token      TEXT,\n  started_at        INTEGER NOT NULL,\n  finished_at       INTEGER,\n  attempts          INTEGER NOT NULL DEFAULT 0,\n  error_code        TEXT,\n  note              TEXT,\n  PRIMARY KEY (scope, target_id)\n) STRICT;\n\nCREATE INDEX IF NOT EXISTS receipt_by_state ON harvest_receipt(state, finished_at DESC);\n\n-- Append-only audit trail: cheap, and it is what makes a receipt defensible\n-- after the fact rather than merely asserted.\nCREATE TABLE IF NOT EXISTS harvest_event (\n  event_id  INTEGER PRIMARY KEY AUTOINCREMENT,\n  scope     TEXT    NOT NULL,\n  target_id TEXT    NOT NULL,\n  at        INTEGER NOT NULL,\n  state     TEXT    NOT NULL,\n  delta     INTEGER NOT NULL DEFAULT 0,\n  note      TEXT\n) STRICT;\n\nCREATE INDEX IF NOT EXISTS event_by_target ON harvest_event(scope, target_id, at DESC);\n";
+//# sourceMappingURL=store-schema.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"store-schema.d.ts","sourceRoot":"","sources":["../../src/utils/store-schema.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,6FAA6F;AAC7F,eAAO,MAAM,aAAa,IAAI,CAAC;AAE/B,eAAO,MAAM,aAAa,iIAUhB,CAAC;AAEX,eAAO,MAAM,YAAY,0vLA8IxB,CAAC"}