@aigne/afs-did-space 1.12.0-beta.5

package/dist/reconcile.mjs

@@ -0,0 +1,184 @@
+import { computeCID } from "./cid.mjs";
+import { readFileSync, readdirSync, statSync } from "node:fs";
+import { join, relative, sep } from "node:path";
+
+//#region src/reconcile.ts
+/**
+* DIDSpace reconcile engine — Phase 2 (Task 2.2)
+*
+* Compares the local filesystem against _metadata.db and brings the index
+* up to date without reading file content unless necessary.
+*
+* Algorithm (scalability-design §七):
+*   1. Walk filesystem (stat only) — O(n) syscalls, no file reads
+*   2. Read index from _metadata.db — single SQL query
+*   3. Three-way compare per file:
+*      - NEW:       in FS, not in DB  → read file, computeCID, INSERT
+*      - MODIFIED:  in both, mtime or size differ → re-read, computeCID, UPDATE
+*      - UNCHANGED: in both, mtime+size same       → skip (CID cache hit)
+*      - DELETED:   in DB, not in FS  → DELETE from entries
+*   4. Batch-update entries + cid_cache
+*/
+/** File names/patterns to exclude from reconcile */
+const EXCLUDED_NAMES = new Set([
+	"_metadata.db",
+	"_metadata.db-wal",
+	"_metadata.db-shm"
+]);
+/** Directory names to skip entirely (they contain sensitive/internal data) */
+const EXCLUDED_DIRS = new Set(["vault", "config"]);
+function isExcluded(name) {
+	if (EXCLUDED_NAMES.has(name)) return true;
+	if (name.startsWith("data.db")) return true;
+	if (name.endsWith("-wal") || name.endsWith("-shm") || name.endsWith("-journal")) return true;
+	return false;
+}
+/** Convert an absolute filesystem path to a relative AFS-style path (no leading slash). */
+function fsPathToRelative(rootPath, absPath) {
+	const rel = relative(rootPath, absPath);
+	return sep === "\\" ? rel.replace(/\\/g, "/") : rel;
+}
+function walkFs(rootPath, dir, depth) {
+	const results = [];
+	let entries;
+	try {
+		entries = readdirSync(dir, { withFileTypes: true });
+	} catch {
+		return results;
+	}
+	for (const entry of entries) {
+		if (entry.name.startsWith(".")) continue;
+		if (isExcluded(entry.name)) continue;
+		const absPath = join(dir, entry.name);
+		if (entry.isSymbolicLink()) continue;
+		if (entry.isDirectory()) {
+			if (EXCLUDED_DIRS.has(entry.name)) continue;
+			results.push(...walkFs(rootPath, absPath, depth + 1));
+		} else if (entry.isFile()) {
+			if (depth === 0) continue;
+			let st;
+			try {
+				st = statSync(absPath);
+			} catch {
+				continue;
+			}
+			results.push({
+				absPath,
+				relPath: fsPathToRelative(rootPath, absPath),
+				size: st.size,
+				mtimeMs: Math.floor(st.mtimeMs)
+			});
+		}
+	}
+	return results;
+}
+/**
+* Derive the `parent` path for a given file/dir path (no leading slash convention).
+*
+* Examples:
+*   "appA/files/hello.txt" → "appA/files/"
+*   "appA/files/"          → "appA/"
+*   "appA/"                → ""
+*/
+function parentOf(path) {
+	const p = path.endsWith("/") ? path.slice(0, -1) : path;
+	const idx = p.lastIndexOf("/");
+	if (idx < 0) return "";
+	return p.slice(0, idx + 1);
+}
+/** Derive the basename (name) from a path (no leading slash convention). */
+function nameOf(path) {
+	const p = path.endsWith("/") ? path.slice(0, -1) : path;
+	const idx = p.lastIndexOf("/");
+	return idx < 0 ? p : p.slice(idx + 1);
+}
+/**
+* Reconcile the local filesystem against _metadata.db.
+* Returns stats about the reconcile operation.
+*/
+async function reconcile(options) {
+	const { rootPath, scope, metadataDb } = options;
+	const start = Date.now();
+	const fsFiles = walkFs(rootPath, rootPath, 0);
+	const fsMap = /* @__PURE__ */ new Map();
+	for (const f of fsFiles) fsMap.set(f.relPath, {
+		size: f.size,
+		mtimeMs: f.mtimeMs,
+		absPath: f.absPath
+	});
+	const dbFiles = await metadataDb.getFiles(scope);
+	const dbMap = /* @__PURE__ */ new Map();
+	for (const row of dbFiles) dbMap.set(row.path, row);
+	const toUpsert = [];
+	const toDelete = [];
+	const now = Date.now();
+	let added = 0;
+	let modified = 0;
+	let unchanged = 0;
+	for (const [relPath, fsInfo] of fsMap) {
+		const dbEntry = dbMap.get(relPath);
+		if (!dbEntry) {
+			const cid = await computeCidWithCache(metadataDb, fsInfo.absPath, fsInfo.size, fsInfo.mtimeMs);
+			toUpsert.push({
+				scope,
+				path: relPath,
+				parent: parentOf(relPath),
+				name: nameOf(relPath),
+				kind: "file",
+				cid,
+				size: fsInfo.size,
+				mime_type: null,
+				ctime: now,
+				mtime: fsInfo.mtimeMs
+			});
+			added++;
+		} else if (fsInfo.size !== dbEntry.size || fsInfo.mtimeMs !== dbEntry.mtime) {
+			const cid = await computeCidWithCache(metadataDb, fsInfo.absPath, fsInfo.size, fsInfo.mtimeMs);
+			toUpsert.push({
+				...dbEntry,
+				cid,
+				size: fsInfo.size,
+				mtime: fsInfo.mtimeMs
+			});
+			modified++;
+		} else unchanged++;
+	}
+	for (const [dbPath] of dbMap) if (!fsMap.has(dbPath)) toDelete.push(dbPath);
+	const reconcileOpts = { deviceId: "desktop:default" };
+	if (toUpsert.length > 0) for (let i = 0; i < toUpsert.length; i += 500) await metadataDb.upsertEntries(toUpsert.slice(i, i + 500), reconcileOpts);
+	for (const path of toDelete) await metadataDb.deleteEntry(scope, path, reconcileOpts);
+	return {
+		added,
+		modified,
+		unchanged,
+		deleted: toDelete.length,
+		elapsed: Date.now() - start
+	};
+}
+/**
+* Get CID for a file — use cid_cache if mtime+size match, else compute and cache.
+*/
+async function computeCidWithCache(metadataDb, absPath, size, mtimeMs) {
+	const cached = await metadataDb.getCidCache(absPath);
+	if (cached && cached.mtime_ms === mtimeMs && cached.size === size) return cached.cid;
+	let content;
+	try {
+		const buf = readFileSync(absPath);
+		content = new Uint8Array(buf.buffer, buf.byteOffset, buf.byteLength);
+	} catch {
+		content = new Uint8Array(0);
+	}
+	const cid = await computeCID(content);
+	await metadataDb.setCidCache({
+		path: absPath,
+		cid,
+		size,
+		mtime_ms: mtimeMs,
+		computed_at: Date.now()
+	});
+	return cid;
+}
+
+//#endregion
+export { reconcile };
+//# sourceMappingURL=reconcile.mjs.map

package/dist/reconcile.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"reconcile.mjs","names":[],"sources":["../src/reconcile.ts"],"sourcesContent":["/**\n * DIDSpace reconcile engine — Phase 2 (Task 2.2)\n *\n * Compares the local filesystem against _metadata.db and brings the index\n * up to date without reading file content unless necessary.\n *\n * Algorithm (scalability-design §七):\n *   1. Walk filesystem (stat only) — O(n) syscalls, no file reads\n *   2. Read index from _metadata.db — single SQL query\n *   3. Three-way compare per file:\n *      - NEW:       in FS, not in DB  → read file, computeCID, INSERT\n *      - MODIFIED:  in both, mtime or size differ → re-read, computeCID, UPDATE\n *      - UNCHANGED: in both, mtime+size same       → skip (CID cache hit)\n *      - DELETED:   in DB, not in FS  → DELETE from entries\n *   4. Batch-update entries + cid_cache\n */\n\n// biome-ignore lint/style/noRestrictedImports: reconcile is provider-internal Node-only code\nimport { readdirSync, readFileSync, statSync } from \"node:fs\";\n// biome-ignore lint/style/noRestrictedImports: reconcile is provider-internal Node-only code\nimport { join, relative, sep } from \"node:path\";\nimport { computeCID } from \"./cid.js\";\nimport type { EntryRow, MetadataDB } from \"./metadata-db.js\";\n\nexport interface ReconcileOptions {\n  /** Root directory of the user's DID space (e.g. ~/.afs/spaces/{userDid}/) */\n  rootPath: string;\n  /** userDid used as scope in the entries table */\n  scope: string;\n  /** MetadataDB instance (already opened) */\n  metadataDb: MetadataDB;\n}\n\nexport interface ReconcileStats {\n  added: number;\n  modified: number;\n  unchanged: number;\n  deleted: number;\n  elapsed: number;\n}\n\n/** File names/patterns to exclude from reconcile */\nconst EXCLUDED_NAMES = new Set([\"_metadata.db\", \"_metadata.db-wal\", \"_metadata.db-shm\"]);\n\n/** Directory names to skip entirely (they contain sensitive/internal data) */\nconst EXCLUDED_DIRS = new Set([\"vault\", \"config\"]);\n\nfunction isExcluded(name: string): boolean {\n  if (EXCLUDED_NAMES.has(name)) return true;\n  // App SQLite database and its WAL/SHM journal files\n  if (name.startsWith(\"data.db\")) return true;\n  // SQLite temp files (any .db-wal, .db-shm, .db-journal)\n  if (name.endsWith(\"-wal\") || name.endsWith(\"-shm\") || name.endsWith(\"-journal\")) return true;\n  return false;\n}\n\n/** Convert an absolute filesystem path to a relative AFS-style path (no leading slash). */\nfunction fsPathToRelative(rootPath: string, absPath: string): string {\n  const rel = relative(rootPath, absPath);\n  // Normalize to forward slashes on Windows\n  return sep === \"\\\\\" ? rel.replace(/\\\\/g, \"/\") : rel;\n}\n\n/**\n * Walk the filesystem rooted at `dir` and collect all regular files.\n * Does NOT follow symlinks (lstat is used implicitly via readdirSync withFileTypes).\n * Returns: Array of { absPath, relPath, size, mtimeMs }\n */\ninterface FsFile {\n  absPath: string;\n  relPath: string; // relative to rootPath, no leading slash\n  size: number;\n  mtimeMs: number;\n}\n\nfunction walkFs(rootPath: string, dir: string, depth: number): FsFile[] {\n  // Safety: skip files directly under rootPath (depth 0 items are internal, e.g. _metadata.db)\n  // Only index files inside app subdirectories (depth >= 1).\n  const results: FsFile[] = [];\n\n  let entries: import(\"node:fs\").Dirent[];\n  try {\n    entries = readdirSync(dir, { withFileTypes: true });\n  } catch {\n    return results;\n  }\n\n  for (const entry of entries) {\n    if (entry.name.startsWith(\".\")) continue; // skip hidden files (.DS_Store, etc.)\n    if (isExcluded(entry.name)) continue;\n\n    const absPath = join(dir, entry.name);\n\n    if (entry.isSymbolicLink()) {\n      // Never follow symlinks — could escape rootPath\n      continue;\n    }\n\n    if (entry.isDirectory()) {\n      // Skip internal directories (vault, config) — they contain sensitive/non-synced data\n      if (EXCLUDED_DIRS.has(entry.name)) continue;\n      results.push(...walkFs(rootPath, absPath, depth + 1));\n    } else if (entry.isFile()) {\n      // Skip files at depth 0 (directly in rootPath — internal files)\n      if (depth === 0) continue;\n\n      let st: ReturnType<typeof statSync>;\n      try {\n        st = statSync(absPath);\n      } catch {\n        continue; // file disappeared between readdir and stat\n      }\n\n      results.push({\n        absPath,\n        relPath: fsPathToRelative(rootPath, absPath),\n        size: st.size,\n        mtimeMs: Math.floor(st.mtimeMs),\n      });\n    }\n  }\n\n  return results;\n}\n\n/**\n * Derive the `parent` path for a given file/dir path (no leading slash convention).\n *\n * Examples:\n *   \"appA/files/hello.txt\" → \"appA/files/\"\n *   \"appA/files/\"          → \"appA/\"\n *   \"appA/\"                → \"\"\n */\nfunction parentOf(path: string): string {\n  const p = path.endsWith(\"/\") ? path.slice(0, -1) : path;\n  const idx = p.lastIndexOf(\"/\");\n  if (idx < 0) return \"\";\n  return p.slice(0, idx + 1);\n}\n\n/** Derive the basename (name) from a path (no leading slash convention). */\nfunction nameOf(path: string): string {\n  const p = path.endsWith(\"/\") ? path.slice(0, -1) : path;\n  const idx = p.lastIndexOf(\"/\");\n  return idx < 0 ? p : p.slice(idx + 1);\n}\n\n/**\n * Reconcile the local filesystem against _metadata.db.\n * Returns stats about the reconcile operation.\n */\nexport async function reconcile(options: ReconcileOptions): Promise<ReconcileStats> {\n  const { rootPath, scope, metadataDb } = options;\n  const start = Date.now();\n\n  // Step 1: Walk filesystem (stat only)\n  const fsFiles = walkFs(rootPath, rootPath, 0);\n  const fsMap = new Map<string, { size: number; mtimeMs: number; absPath: string }>();\n  for (const f of fsFiles) {\n    fsMap.set(f.relPath, { size: f.size, mtimeMs: f.mtimeMs, absPath: f.absPath });\n  }\n\n  // Step 2: Read current index\n  const dbFiles = await metadataDb.getFiles(scope);\n  const dbMap = new Map<string, EntryRow>();\n  for (const row of dbFiles) {\n    dbMap.set(row.path, row);\n  }\n\n  // Step 3: Three-way compare\n  const toUpsert: EntryRow[] = [];\n  const toDelete: string[] = [];\n  const now = Date.now();\n\n  let added = 0;\n  let modified = 0;\n  let unchanged = 0;\n\n  for (const [relPath, fsInfo] of fsMap) {\n    const dbEntry = dbMap.get(relPath);\n\n    if (!dbEntry) {\n      // NEW: compute CID and insert\n      const cid = await computeCidWithCache(\n        metadataDb,\n        fsInfo.absPath,\n        fsInfo.size,\n        fsInfo.mtimeMs,\n      );\n      toUpsert.push({\n        scope,\n        path: relPath,\n        parent: parentOf(relPath),\n        name: nameOf(relPath),\n        kind: \"file\",\n        cid,\n        size: fsInfo.size,\n        mime_type: null,\n        ctime: now,\n        mtime: fsInfo.mtimeMs,\n      });\n      added++;\n    } else if (fsInfo.size !== dbEntry.size || fsInfo.mtimeMs !== dbEntry.mtime) {\n      // MODIFIED: re-read and recompute CID\n      const cid = await computeCidWithCache(\n        metadataDb,\n        fsInfo.absPath,\n        fsInfo.size,\n        fsInfo.mtimeMs,\n      );\n      toUpsert.push({\n        ...dbEntry,\n        cid,\n        size: fsInfo.size,\n        mtime: fsInfo.mtimeMs,\n      });\n      modified++;\n    } else {\n      // UNCHANGED\n      unchanged++;\n    }\n  }\n\n  // DELETED: in DB but not in FS\n  for (const [dbPath] of dbMap) {\n    if (!fsMap.has(dbPath)) {\n      toDelete.push(dbPath);\n    }\n  }\n\n  // Step 4: Apply batch updates\n  // Task 2.4a: reconcile is a desktop-side reconciliation loop, not a real\n  // device write. Use the `desktop:default` sentinel deviceId — real per-device\n  // tracking will land when the mobile polling scheduler (Task 3.x) introduces\n  // actual device UUIDs.\n  const reconcileOpts = { deviceId: \"desktop:default\" } as const;\n  if (toUpsert.length > 0) {\n    // Batch in chunks of 500 to avoid excessive statement count\n    for (let i = 0; i < toUpsert.length; i += 500) {\n      await metadataDb.upsertEntries(toUpsert.slice(i, i + 500), reconcileOpts);\n    }\n  }\n\n  for (const path of toDelete) {\n    await metadataDb.deleteEntry(scope, path, reconcileOpts);\n  }\n\n  return {\n    added,\n    modified,\n    unchanged,\n    deleted: toDelete.length,\n    elapsed: Date.now() - start,\n  };\n}\n\n/**\n * Get CID for a file — use cid_cache if mtime+size match, else compute and cache.\n */\nasync function computeCidWithCache(\n  metadataDb: MetadataDB,\n  absPath: string,\n  size: number,\n  mtimeMs: number,\n): Promise<string> {\n  const cached = await metadataDb.getCidCache(absPath);\n  if (cached && cached.mtime_ms === mtimeMs && cached.size === size) {\n    return cached.cid;\n  }\n\n  // Cache miss — read file and compute CID\n  let content: Uint8Array;\n  try {\n    const buf = readFileSync(absPath);\n    content = new Uint8Array(buf.buffer, buf.byteOffset, buf.byteLength);\n  } catch {\n    // File disappeared between stat and read — return empty CID\n    content = new Uint8Array(0);\n  }\n\n  const cid = await computeCID(content);\n\n  // Update cache\n  await metadataDb.setCidCache({\n    path: absPath,\n    cid,\n    size,\n    mtime_ms: mtimeMs,\n    computed_at: Date.now(),\n  });\n\n  return cid;\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;AA0CA,MAAM,iBAAiB,IAAI,IAAI;CAAC;CAAgB;CAAoB;CAAmB,CAAC;;AAGxF,MAAM,gBAAgB,IAAI,IAAI,CAAC,SAAS,SAAS,CAAC;AAElD,SAAS,WAAW,MAAuB;AACzC,KAAI,eAAe,IAAI,KAAK,CAAE,QAAO;AAErC,KAAI,KAAK,WAAW,UAAU,CAAE,QAAO;AAEvC,KAAI,KAAK,SAAS,OAAO,IAAI,KAAK,SAAS,OAAO,IAAI,KAAK,SAAS,WAAW,CAAE,QAAO;AACxF,QAAO;;;AAIT,SAAS,iBAAiB,UAAkB,SAAyB;CACnE,MAAM,MAAM,SAAS,UAAU,QAAQ;AAEvC,QAAO,QAAQ,OAAO,IAAI,QAAQ,OAAO,IAAI,GAAG;;AAelD,SAAS,OAAO,UAAkB,KAAa,OAAyB;CAGtE,MAAM,UAAoB,EAAE;CAE5B,IAAI;AACJ,KAAI;AACF,YAAU,YAAY,KAAK,EAAE,eAAe,MAAM,CAAC;SAC7C;AACN,SAAO;;AAGT,MAAK,MAAM,SAAS,SAAS;AAC3B,MAAI,MAAM,KAAK,WAAW,IAAI,CAAE;AAChC,MAAI,WAAW,MAAM,KAAK,CAAE;EAE5B,MAAM,UAAU,KAAK,KAAK,MAAM,KAAK;AAErC,MAAI,MAAM,gBAAgB,CAExB;AAGF,MAAI,MAAM,aAAa,EAAE;AAEvB,OAAI,cAAc,IAAI,MAAM,KAAK,CAAE;AACnC,WAAQ,KAAK,GAAG,OAAO,UAAU,SAAS,QAAQ,EAAE,CAAC;aAC5C,MAAM,QAAQ,EAAE;AAEzB,OAAI,UAAU,EAAG;GAEjB,IAAI;AACJ,OAAI;AACF,SAAK,SAAS,QAAQ;WAChB;AACN;;AAGF,WAAQ,KAAK;IACX;IACA,SAAS,iBAAiB,UAAU,QAAQ;IAC5C,MAAM,GAAG;IACT,SAAS,KAAK,MAAM,GAAG,QAAQ;IAChC,CAAC;;;AAIN,QAAO;;;;;;;;;;AAWT,SAAS,SAAS,MAAsB;CACtC,MAAM,IAAI,KAAK,SAAS,IAAI,GAAG,KAAK,MAAM,GAAG,GAAG,GAAG;CACnD,MAAM,MAAM,EAAE,YAAY,IAAI;AAC9B,KAAI,MAAM,EAAG,QAAO;AACpB,QAAO,EAAE,MAAM,GAAG,MAAM,EAAE;;;AAI5B,SAAS,OAAO,MAAsB;CACpC,MAAM,IAAI,KAAK,SAAS,IAAI,GAAG,KAAK,MAAM,GAAG,GAAG,GAAG;CACnD,MAAM,MAAM,EAAE,YAAY,IAAI;AAC9B,QAAO,MAAM,IAAI,IAAI,EAAE,MAAM,MAAM,EAAE;;;;;;AAOvC,eAAsB,UAAU,SAAoD;CAClF,MAAM,EAAE,UAAU,OAAO,eAAe;CACxC,MAAM,QAAQ,KAAK,KAAK;CAGxB,MAAM,UAAU,OAAO,UAAU,UAAU,EAAE;CAC7C,MAAM,wBAAQ,IAAI,KAAiE;AACnF,MAAK,MAAM,KAAK,QACd,OAAM,IAAI,EAAE,SAAS;EAAE,MAAM,EAAE;EAAM,SAAS,EAAE;EAAS,SAAS,EAAE;EAAS,CAAC;CAIhF,MAAM,UAAU,MAAM,WAAW,SAAS,MAAM;CAChD,MAAM,wBAAQ,IAAI,KAAuB;AACzC,MAAK,MAAM,OAAO,QAChB,OAAM,IAAI,IAAI,MAAM,IAAI;CAI1B,MAAM,WAAuB,EAAE;CAC/B,MAAM,WAAqB,EAAE;CAC7B,MAAM,MAAM,KAAK,KAAK;CAEtB,IAAI,QAAQ;CACZ,IAAI,WAAW;CACf,IAAI,YAAY;AAEhB,MAAK,MAAM,CAAC,SAAS,WAAW,OAAO;EACrC,MAAM,UAAU,MAAM,IAAI,QAAQ;AAElC,MAAI,CAAC,SAAS;GAEZ,MAAM,MAAM,MAAM,oBAChB,YACA,OAAO,SACP,OAAO,MACP,OAAO,QACR;AACD,YAAS,KAAK;IACZ;IACA,MAAM;IACN,QAAQ,SAAS,QAAQ;IACzB,MAAM,OAAO,QAAQ;IACrB,MAAM;IACN;IACA,MAAM,OAAO;IACb,WAAW;IACX,OAAO;IACP,OAAO,OAAO;IACf,CAAC;AACF;aACS,OAAO,SAAS,QAAQ,QAAQ,OAAO,YAAY,QAAQ,OAAO;GAE3E,MAAM,MAAM,MAAM,oBAChB,YACA,OAAO,SACP,OAAO,MACP,OAAO,QACR;AACD,YAAS,KAAK;IACZ,GAAG;IACH;IACA,MAAM,OAAO;IACb,OAAO,OAAO;IACf,CAAC;AACF;QAGA;;AAKJ,MAAK,MAAM,CAAC,WAAW,MACrB,KAAI,CAAC,MAAM,IAAI,OAAO,CACpB,UAAS,KAAK,OAAO;CASzB,MAAM,gBAAgB,EAAE,UAAU,mBAAmB;AACrD,KAAI,SAAS,SAAS,EAEpB,MAAK,IAAI,IAAI,GAAG,IAAI,SAAS,QAAQ,KAAK,IACxC,OAAM,WAAW,cAAc,SAAS,MAAM,GAAG,IAAI,IAAI,EAAE,cAAc;AAI7E,MAAK,MAAM,QAAQ,SACjB,OAAM,WAAW,YAAY,OAAO,MAAM,cAAc;AAG1D,QAAO;EACL;EACA;EACA;EACA,SAAS,SAAS;EAClB,SAAS,KAAK,KAAK,GAAG;EACvB;;;;;AAMH,eAAe,oBACb,YACA,SACA,MACA,SACiB;CACjB,MAAM,SAAS,MAAM,WAAW,YAAY,QAAQ;AACpD,KAAI,UAAU,OAAO,aAAa,WAAW,OAAO,SAAS,KAC3D,QAAO,OAAO;CAIhB,IAAI;AACJ,KAAI;EACF,MAAM,MAAM,aAAa,QAAQ;AACjC,YAAU,IAAI,WAAW,IAAI,QAAQ,IAAI,YAAY,IAAI,WAAW;SAC9D;AAEN,YAAU,IAAI,WAAW,EAAE;;CAG7B,MAAM,MAAM,MAAM,WAAW,QAAQ;AAGrC,OAAM,WAAW,YAAY;EAC3B,MAAM;EACN;EACA;EACA,UAAU;EACV,aAAa,KAAK,KAAK;EACxB,CAAC;AAEF,QAAO"}

package/dist/reference-check.cjs

@@ -0,0 +1,49 @@
+
+//#region src/reference-check.ts
+/** entries-only liveness UNION non-expired prepared upload-session refs. */
+const REFERENCED_ANYWHERE_SQL = "SELECT 1 FROM ds_entries WHERE cid = ? UNION ALL SELECT 1 FROM ds_upload_session_entries e JOIN ds_upload_sessions s ON e.session_id = s.id WHERE e.cid = ? AND s.status = 'prepared' AND s.expires_at > ? LIMIT 1";
+/** Fallback when the upload-session tables don't exist yet (old/partial DB). */
+const ENTRIES_ONLY_SQL = "SELECT 1 FROM ds_entries WHERE cid = ? LIMIT 1";
+/**
+* True when the error is the upload-session tables being absent. On such a DB
+* there are no prepared sessions anyway, so entries-only is the correct answer
+* — keeps the GC sweep working on DBs predating migration 0108.
+*/
+function isMissingUploadTable(err) {
+	const msg = (err instanceof Error ? err.message : String(err)).toLowerCase();
+	return msg.includes("no such table") && msg.includes("upload_session");
+}
+/** D1 backend (Cloudflare). */
+async function referencedAnywhereD1(db, cid, nowMs = Date.now()) {
+	if (!cid) return false;
+	try {
+		return await db.prepare(REFERENCED_ANYWHERE_SQL).bind(cid, cid, nowMs).first() !== null;
+	} catch (err) {
+		if (!isMissingUploadTable(err)) throw err;
+		return await db.prepare(ENTRIES_ONLY_SQL).bind(cid).first() !== null;
+	}
+}
+/** libsql backend (Node `_metadata.db`). */
+async function referencedAnywhereLibsql(client, cid, nowMs = Date.now()) {
+	if (!cid) return false;
+	try {
+		return (await client.execute({
+			sql: REFERENCED_ANYWHERE_SQL,
+			args: [
+				cid,
+				cid,
+				nowMs
+			]
+		})).rows.length > 0;
+	} catch (err) {
+		if (!isMissingUploadTable(err)) throw err;
+		return (await client.execute({
+			sql: ENTRIES_ONLY_SQL,
+			args: [cid]
+		})).rows.length > 0;
+	}
+}
+
+//#endregion
+exports.referencedAnywhereD1 = referencedAnywhereD1;
+exports.referencedAnywhereLibsql = referencedAnywhereLibsql;

package/dist/reference-check.d.cts

@@ -0,0 +1,10 @@
+import { Client } from "@libsql/client";
+
+//#region src/reference-check.d.ts
+/** D1 backend (Cloudflare). */
+declare function referencedAnywhereD1(db: D1Database, cid: string, nowMs?: number): Promise<boolean>;
+/** libsql backend (Node `_metadata.db`). */
+declare function referencedAnywhereLibsql(client: Client, cid: string, nowMs?: number): Promise<boolean>;
+//#endregion
+export { referencedAnywhereD1, referencedAnywhereLibsql };
+//# sourceMappingURL=reference-check.d.cts.map

package/dist/reference-check.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"reference-check.d.cts","names":[],"sources":["../src/reference-check.ts"],"mappings":";;;;iBAmDsB,oBAAA,CACpB,EAAA,EAAI,UAAA,EACJ,GAAA,UACA,KAAA,YACC,OAAA;;iBAamB,wBAAA,CACpB,MAAA,EAAQ,MAAA,EACR,GAAA,UACA,KAAA,YACC,OAAA"}

package/dist/reference-check.d.mts

@@ -0,0 +1,10 @@
+import { Client } from "@libsql/client";
+
+//#region src/reference-check.d.ts
+/** D1 backend (Cloudflare). */
+declare function referencedAnywhereD1(db: D1Database, cid: string, nowMs?: number): Promise<boolean>;
+/** libsql backend (Node `_metadata.db`). */
+declare function referencedAnywhereLibsql(client: Client, cid: string, nowMs?: number): Promise<boolean>;
+//#endregion
+export { referencedAnywhereD1, referencedAnywhereLibsql };
+//# sourceMappingURL=reference-check.d.mts.map

package/dist/reference-check.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"reference-check.d.mts","names":[],"sources":["../src/reference-check.ts"],"mappings":";;;;iBAmDsB,oBAAA,CACpB,EAAA,EAAI,UAAA,EACJ,GAAA,UACA,KAAA,YACC,OAAA;;iBAamB,wBAAA,CACpB,MAAA,EAAQ,MAAA,EACR,GAAA,UACA,KAAA,YACC,OAAA"}

package/dist/reference-check.mjs

@@ -0,0 +1,48 @@
+//#region src/reference-check.ts
+/** entries-only liveness UNION non-expired prepared upload-session refs. */
+const REFERENCED_ANYWHERE_SQL = "SELECT 1 FROM ds_entries WHERE cid = ? UNION ALL SELECT 1 FROM ds_upload_session_entries e JOIN ds_upload_sessions s ON e.session_id = s.id WHERE e.cid = ? AND s.status = 'prepared' AND s.expires_at > ? LIMIT 1";
+/** Fallback when the upload-session tables don't exist yet (old/partial DB). */
+const ENTRIES_ONLY_SQL = "SELECT 1 FROM ds_entries WHERE cid = ? LIMIT 1";
+/**
+* True when the error is the upload-session tables being absent. On such a DB
+* there are no prepared sessions anyway, so entries-only is the correct answer
+* — keeps the GC sweep working on DBs predating migration 0108.
+*/
+function isMissingUploadTable(err) {
+	const msg = (err instanceof Error ? err.message : String(err)).toLowerCase();
+	return msg.includes("no such table") && msg.includes("upload_session");
+}
+/** D1 backend (Cloudflare). */
+async function referencedAnywhereD1(db, cid, nowMs = Date.now()) {
+	if (!cid) return false;
+	try {
+		return await db.prepare(REFERENCED_ANYWHERE_SQL).bind(cid, cid, nowMs).first() !== null;
+	} catch (err) {
+		if (!isMissingUploadTable(err)) throw err;
+		return await db.prepare(ENTRIES_ONLY_SQL).bind(cid).first() !== null;
+	}
+}
+/** libsql backend (Node `_metadata.db`). */
+async function referencedAnywhereLibsql(client, cid, nowMs = Date.now()) {
+	if (!cid) return false;
+	try {
+		return (await client.execute({
+			sql: REFERENCED_ANYWHERE_SQL,
+			args: [
+				cid,
+				cid,
+				nowMs
+			]
+		})).rows.length > 0;
+	} catch (err) {
+		if (!isMissingUploadTable(err)) throw err;
+		return (await client.execute({
+			sql: ENTRIES_ONLY_SQL,
+			args: [cid]
+		})).rows.length > 0;
+	}
+}
+
+//#endregion
+export { referencedAnywhereD1, referencedAnywhereLibsql };
+//# sourceMappingURL=reference-check.mjs.map

package/dist/reference-check.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"reference-check.mjs","names":[],"sources":["../src/reference-check.ts"],"sourcesContent":["/**\n * reference-check.ts — scope-blind GC-liveness helper (design §4.4b + §9).\n *\n * Answers \"does a LIVE file anywhere — OR a non-expired in-flight upload —\n * point at this cid?\" for the `runGc` sweeper. Two UNION'd predicates:\n *\n *  1. `entries` only — counting changelog refs would pin every overwritten cid\n *     forever (its own historical put/delete rows reference it). scope-blind:\n *     under the global object pool (Model B) an object is shared across users,\n *     so a live reference in ANY scope must keep it.\n *  2. non-expired `prepared` upload sessions (design §9 in-flight protection) —\n *     bytes already uploaded but not yet committed must NOT be GC'd. This CANNOT\n *     lean on the 7-day grace window: prepared TTL is hours (≪ grace), so a\n *     just-uploaded object would fall inside the grace window and be deleted.\n *     `expires_at > nowMs` uses a STRICT `>`: a session exactly at expiry is no\n *     longer protected (it can be swept + reclaimed).\n *\n * `nowMs` is passed at CALL time (default `Date.now()`), never bound at\n * construction — a long-lived isolate must not capture a stale \"now\" that would\n * over-protect expired sessions (design §9 / tasks T1.4). `runGc` passes ONE\n * consistent sweep-time `nowMs` to every call so a sweep judges expiry uniformly.\n *\n * Do NOT reuse the legacy `D1GCQueue.isReferenced` here — it is the three-way\n * (entries ∪ changelog.cid ∪ changelog.old_cid) READ-AUTH check, a different\n * question (design §3).\n */\n\nimport type { Client as LibsqlClient } from \"@libsql/client\";\n\n/** entries-only liveness UNION non-expired prepared upload-session refs. */\nconst REFERENCED_ANYWHERE_SQL =\n  \"SELECT 1 FROM ds_entries WHERE cid = ? \" +\n  \"UNION ALL \" +\n  \"SELECT 1 FROM ds_upload_session_entries e JOIN ds_upload_sessions s ON e.session_id = s.id \" +\n  \"WHERE e.cid = ? AND s.status = 'prepared' AND s.expires_at > ? \" +\n  \"LIMIT 1\";\n\n/** Fallback when the upload-session tables don't exist yet (old/partial DB). */\nconst ENTRIES_ONLY_SQL = \"SELECT 1 FROM ds_entries WHERE cid = ? LIMIT 1\";\n\n/**\n * True when the error is the upload-session tables being absent. On such a DB\n * there are no prepared sessions anyway, so entries-only is the correct answer\n * — keeps the GC sweep working on DBs predating migration 0108.\n */\nfunction isMissingUploadTable(err: unknown): boolean {\n  const msg = (err instanceof Error ? err.message : String(err)).toLowerCase();\n  return msg.includes(\"no such table\") && msg.includes(\"upload_session\");\n}\n\n/** D1 backend (Cloudflare). */\nexport async function referencedAnywhereD1(\n  db: D1Database,\n  cid: string,\n  nowMs: number = Date.now(),\n): Promise<boolean> {\n  if (!cid) return false;\n  try {\n    const row = await db.prepare(REFERENCED_ANYWHERE_SQL).bind(cid, cid, nowMs).first();\n    return row !== null;\n  } catch (err) {\n    if (!isMissingUploadTable(err)) throw err;\n    const row = await db.prepare(ENTRIES_ONLY_SQL).bind(cid).first();\n    return row !== null;\n  }\n}\n\n/** libsql backend (Node `_metadata.db`). */\nexport async function referencedAnywhereLibsql(\n  client: LibsqlClient,\n  cid: string,\n  nowMs: number = Date.now(),\n): Promise<boolean> {\n  if (!cid) return false;\n  try {\n    const result = await client.execute({ sql: REFERENCED_ANYWHERE_SQL, args: [cid, cid, nowMs] });\n    return result.rows.length > 0;\n  } catch (err) {\n    if (!isMissingUploadTable(err)) throw err;\n    const result = await client.execute({ sql: ENTRIES_ONLY_SQL, args: [cid] });\n    return result.rows.length > 0;\n  }\n}\n"],"mappings":";;AA8BA,MAAM,0BACJ;;AAOF,MAAM,mBAAmB;;;;;;AAOzB,SAAS,qBAAqB,KAAuB;CACnD,MAAM,OAAO,eAAe,QAAQ,IAAI,UAAU,OAAO,IAAI,EAAE,aAAa;AAC5E,QAAO,IAAI,SAAS,gBAAgB,IAAI,IAAI,SAAS,iBAAiB;;;AAIxE,eAAsB,qBACpB,IACA,KACA,QAAgB,KAAK,KAAK,EACR;AAClB,KAAI,CAAC,IAAK,QAAO;AACjB,KAAI;AAEF,SADY,MAAM,GAAG,QAAQ,wBAAwB,CAAC,KAAK,KAAK,KAAK,MAAM,CAAC,OAAO,KACpE;UACR,KAAK;AACZ,MAAI,CAAC,qBAAqB,IAAI,CAAE,OAAM;AAEtC,SADY,MAAM,GAAG,QAAQ,iBAAiB,CAAC,KAAK,IAAI,CAAC,OAAO,KACjD;;;;AAKnB,eAAsB,yBACpB,QACA,KACA,QAAgB,KAAK,KAAK,EACR;AAClB,KAAI,CAAC,IAAK,QAAO;AACjB,KAAI;AAEF,UADe,MAAM,OAAO,QAAQ;GAAE,KAAK;GAAyB,MAAM;IAAC;IAAK;IAAK;IAAM;GAAE,CAAC,EAChF,KAAK,SAAS;UACrB,KAAK;AACZ,MAAI,CAAC,qBAAqB,IAAI,CAAE,OAAM;AAEtC,UADe,MAAM,OAAO,QAAQ;GAAE,KAAK;GAAkB,MAAM,CAAC,IAAI;GAAE,CAAC,EAC7D,KAAK,SAAS"}