wiki-graph-core 0.3.1 → 0.4.1

package/dist/storage/wikg/archive/zip.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../src/storage/wikg/archive/zip.ts"],"sourcesContent":["import { open as openFile, type FileHandle } from \"fs/promises\";\nimport { inflateRaw } from \"zlib\";\n\nimport {\n  open as openZip,\n  type Entry,\n  type ZipFile as YauzlZipFile,\n} from \"yauzl\";\n\nimport { WIKG_MANIFEST_PATH, WIKG_MUTATION_TOKEN_PATH } from \"./constants.js\";\nimport { parseWikgManifest, parseWikgMutationToken } from \"./manifest.js\";\nimport { normalizeArchivePath } from \"./paths.js\";\n\nexport async function openIndexedArchive(inputPath: string): Promise<{\n  readonly entries: readonly Entry[];\n  readonly zipFile: YauzlZipFile;\n}> {\n  const zipFile = await openArchive(inputPath);\n\n  try {\n    const entries = await indexArchiveEntries(zipFile);\n\n    await validateArchiveManifest(inputPath, entries);\n    return { entries, zipFile };\n  } catch (error) {\n    zipFile.close();\n    throw error;\n  }\n}\n\nexport async function indexArchiveEntries(\n  zipFile: YauzlZipFile,\n): Promise<readonly Entry[]> {\n  return await new Promise((resolve, reject) => {\n    const entries: Entry[] = [];\n\n    zipFile.on(\"entry\", (entry: Entry) => {\n      if (entry.fileName.endsWith(\"/\")) {\n        zipFile.readEntry();\n        return;\n      }\n\n      entries.push(entry);\n      zipFile.readEntry();\n    });\n    zipFile.once(\"end\", () => {\n      resolve(entries);\n    });\n    zipFile.once(\"error\", (error: Error) => {\n      reject(error);\n    });\n\n    zipFile.readEntry();\n  });\n}\n\nexport async function readArchiveEntryText(\n  inputPath: string,\n  entry: Entry,\n): Promise<string> {\n  return (await readArchiveEntryBuffer(inputPath, entry)).toString(\"utf8\");\n}\n\nexport async function readArchiveEntryBuffer(\n  inputPath: string,\n  entry: Entry,\n): Promise<Buffer> {\n  const file = await openFile(inputPath, \"r\");\n\n  try {\n    return await readArchiveEntryBufferFromFile(file, entry);\n  } finally {\n    await file.close();\n  }\n}\n\nexport async function readArchiveEntryBufferFromFile(\n  file: FileHandle,\n  entry: Entry,\n): Promise<Buffer> {\n  const compressed = await readCompressedArchiveEntryBuffer(file, entry);\n\n  if (entry.compressionMethod === 0) {\n    return compressed;\n  }\n  if (entry.compressionMethod === 8) {\n    return await inflateRawBuffer(compressed);\n  }\n\n  throw new Error(`Unsupported ZIP compression method: ${entry.fileName}`);\n}\n\nasync function openArchive(path: string): Promise<YauzlZipFile> {\n  return await new Promise((resolve, reject) => {\n    openZip(path, { autoClose: false, lazyEntries: true }, (error, zipFile) => {\n      if (error !== null || zipFile === undefined) {\n        reject(error ?? new Error(`Cannot open archive: ${path}`));\n        return;\n      }\n\n      resolve(zipFile);\n    });\n  });\n}\n\nasync function validateArchiveManifest(\n  inputPath: string,\n  entries: readonly Entry[],\n): Promise<void> {\n  await validateArchiveMutationToken(inputPath, entries);\n\n  const entry = entries.find(\n    (candidate) =>\n      normalizeArchivePath(candidate.fileName) === WIKG_MANIFEST_PATH,\n  );\n\n  if (entry === undefined) {\n    throw new Error(`Missing WIKG manifest: ${WIKG_MANIFEST_PATH}.`);\n  }\n\n  parseWikgManifest(await readArchiveEntryText(inputPath, entry));\n}\n\nasync function validateArchiveMutationToken(\n  inputPath: string,\n  entries: readonly Entry[],\n): Promise<void> {\n  const firstEntryPath = normalizeArchivePath(entries[0]?.fileName ?? \"\");\n\n  if (firstEntryPath !== WIKG_MUTATION_TOKEN_PATH) {\n    throw new Error(\n      `Missing WIKG mutation token: ${WIKG_MUTATION_TOKEN_PATH}.`,\n    );\n  }\n\n  parseWikgMutationToken(await readArchiveEntryText(inputPath, entries[0]!));\n}\n\nasync function readCompressedArchiveEntryBuffer(\n  file: FileHandle,\n  entry: Entry,\n): Promise<Buffer> {\n  const header = Buffer.alloc(30);\n\n  await file.read(header, 0, header.length, entry.relativeOffsetOfLocalHeader);\n  if (header.readUInt32LE(0) !== 0x04034b50) {\n    throw new Error(`Invalid ZIP local file header: ${entry.fileName}`);\n  }\n\n  const fileNameLength = header.readUInt16LE(26);\n  const extraFieldLength = header.readUInt16LE(28);\n  const dataOffset =\n    entry.relativeOffsetOfLocalHeader + 30 + fileNameLength + extraFieldLength;\n  const compressed = Buffer.alloc(entry.compressedSize);\n\n  await file.read(compressed, 0, compressed.length, dataOffset);\n  return compressed;\n}\n\nasync function inflateRawBuffer(input: Buffer): Promise<Buffer> {\n  return await new Promise((resolveInflate, rejectInflate) => {\n    inflateRaw(input, (error, output) => {\n      if (error !== null) {\n        rejectInflate(error);\n        return;\n      }\n\n      resolveInflate(output);\n    });\n  });\n}\n"],"mappings":"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","names":[]}

package/dist/storage/wikg/archive-uri.d.ts

@@ -0,0 +1 @@
+export { LocatedWikiGraphUri, ParsedWikiGraphUri, WIKI_GRAPH_ARCHIVE_EXTENSION, WIKI_GRAPH_JOB_URI_PREFIX, WIKI_GRAPH_URI_PREFIX, formatLocatedChapterResourceUri, formatLocatedChapterSourceCollectionUri, formatLocatedChapterUri, formatLocatedWikiGraphUri, formatWikiGraphCommandUri, formatWikiGraphObjectUri, formatWikiGraphUriExpectedError, isWikiGraphJobUri, isWikiGraphUri, parseLocatedWikiGraphUri, parseWikiGraphUriSyntax, requireArchiveUri, requireLocatedObjectOrArchiveUri, requireLocatedObjectUri } from '../../runtime/common/wiki-graph/uri.js';

package/dist/storage/wikg/archive-uri.js

@@ -0,0 +1,39 @@
+import {
+  formatLocatedChapterResourceUri,
+  formatLocatedChapterSourceCollectionUri,
+  formatLocatedChapterUri,
+  formatLocatedWikiGraphUri,
+  formatWikiGraphCommandUri,
+  formatWikiGraphObjectUri,
+  formatWikiGraphUriExpectedError,
+  isWikiGraphJobUri,
+  isWikiGraphUri,
+  parseLocatedWikiGraphUri,
+  parseWikiGraphUriSyntax,
+  requireArchiveUri,
+  requireLocatedObjectOrArchiveUri,
+  requireLocatedObjectUri,
+  WIKI_GRAPH_ARCHIVE_EXTENSION,
+  WIKI_GRAPH_JOB_URI_PREFIX,
+  WIKI_GRAPH_URI_PREFIX
+} from "../../runtime/common/wiki-graph/uri.js";
+export {
+  WIKI_GRAPH_ARCHIVE_EXTENSION,
+  WIKI_GRAPH_JOB_URI_PREFIX,
+  WIKI_GRAPH_URI_PREFIX,
+  formatLocatedChapterResourceUri,
+  formatLocatedChapterSourceCollectionUri,
+  formatLocatedChapterUri,
+  formatLocatedWikiGraphUri,
+  formatWikiGraphCommandUri,
+  formatWikiGraphObjectUri,
+  formatWikiGraphUriExpectedError,
+  isWikiGraphJobUri,
+  isWikiGraphUri,
+  parseLocatedWikiGraphUri,
+  parseWikiGraphUriSyntax,
+  requireArchiveUri,
+  requireLocatedObjectOrArchiveUri,
+  requireLocatedObjectUri
+};
+//# sourceMappingURL=archive-uri.js.map

package/dist/storage/wikg/archive-uri.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/storage/wikg/archive-uri.ts"],"sourcesContent":["export {\n  formatLocatedChapterResourceUri,\n  formatLocatedChapterSourceCollectionUri,\n  formatLocatedChapterUri,\n  formatLocatedWikiGraphUri,\n  formatWikiGraphCommandUri,\n  formatWikiGraphObjectUri,\n  formatWikiGraphUriExpectedError,\n  isWikiGraphJobUri,\n  isWikiGraphUri,\n  parseLocatedWikiGraphUri,\n  parseWikiGraphUriSyntax,\n  requireArchiveUri,\n  requireLocatedObjectOrArchiveUri,\n  requireLocatedObjectUri,\n  WIKI_GRAPH_ARCHIVE_EXTENSION,\n  WIKI_GRAPH_JOB_URI_PREFIX,\n  WIKI_GRAPH_URI_PREFIX,\n  type LocatedWikiGraphUri,\n  type ParsedWikiGraphUri,\n} from \"../../runtime/common/wiki-graph/uri.js\";\n"],"mappings":"AAAA;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OAGK;","names":[]}

package/dist/storage/wikg/coordinator.d.ts

@@ -0,0 +1,29 @@
+export { WikgCoordinator } from './wikg-coordinator/facade.js';
+export { WikgArchiveSession } from './wikg-coordinator/session.js';
+export { tryStartWikgFlusher } from './wikg-coordinator/flusher.js';
+export { runWikgCoordinatorGc } from './wikg-coordinator/gc.js';
+import '../../document/directory/types.js';
+import '../../text/source/meta.js';
+import 'zod';
+import '../../text/source/toc.js';
+import '../../text/source/types.js';
+import '../../document/database.js';
+import 'sqlite3';
+import '../../document/types.js';
+import '../../document/text-streams/serial.js';
+import '../../document/text-streams/draft.js';
+import '../../document/text-streams/types.js';
+import '../../document/stores/chunk.js';
+import '../../document/stores/types.js';
+import '../../document/stores/fragment-group.js';
+import '../../document/stores/graph-build-parameter.js';
+import '../../document/stores/mention-link.js';
+import '../../document/stores/mention.js';
+import '../../document/stores/object-metadata.js';
+import '../../document/stores/reading-edge.js';
+import '../../document/stores/serial.js';
+import '../../document/stores/snake/chunk.js';
+import '../../document/stores/snake/core.js';
+import '../../document/stores/snake/edge.js';
+import './wikg-coordinator/types.js';
+import '../../runtime/gc/types.js';

package/dist/storage/wikg/coordinator.js

@@ -0,0 +1,2 @@
+export * from "./wikg-coordinator/index.js";
+//# sourceMappingURL=coordinator.js.map

package/dist/storage/wikg/coordinator.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/storage/wikg/coordinator.ts"],"sourcesContent":["export * from \"./wikg-coordinator/index.js\";\n"],"mappings":"AAAA,cAAc;","names":[]}

package/dist/storage/wikg/index.d.ts

@@ -0,0 +1,41 @@
+export { extractWikgArchive } from './archive/extract.js';
+export { WikgArchiveReader, listWikgArchiveEntries, readWikgArchiveEntry, readWikgArchiveFormatVersion, readWikgArchiveMutationToken, readWikgArchiveSchemaVersion } from './archive/reader.js';
+export { WIKG_FORMAT_VERSION, WIKG_SCHEMA_VERSION } from './archive/manifest.js';
+export { writeWikgArchive, writeWikgArchiveWithOverlays } from './archive/write.js';
+export { WikgArchiveOverlay } from './archive/types.js';
+export { LocatedWikiGraphUri, ParsedWikiGraphUri, WIKI_GRAPH_ARCHIVE_EXTENSION, WIKI_GRAPH_JOB_URI_PREFIX, WIKI_GRAPH_URI_PREFIX, formatLocatedChapterResourceUri, formatLocatedChapterSourceCollectionUri, formatLocatedChapterUri, formatLocatedWikiGraphUri, formatWikiGraphCommandUri, formatWikiGraphObjectUri, formatWikiGraphUriExpectedError, isWikiGraphJobUri, isWikiGraphUri, parseLocatedWikiGraphUri, parseWikiGraphUriSyntax, requireArchiveUri, requireLocatedObjectOrArchiveUri, requireLocatedObjectUri } from '../../runtime/common/wiki-graph/uri.js';
+export { WikiGraphArchiveFile } from './wiki-graph-archive-file.js';
+export { WikgCoordinator } from './wikg-coordinator/facade.js';
+export { runWikgCoordinatorGc } from './wikg-coordinator/gc.js';
+import 'yauzl';
+import '../../core-Cv8a8viI.js';
+import '../../text/source/meta.js';
+import 'zod';
+import '../../text/source/toc.js';
+import '../../text/source/types.js';
+import '../../document/database.js';
+import 'sqlite3';
+import '../../document/text-streams/core.js';
+import '../../document/types.js';
+import '../../document/text-streams/serial.js';
+import '../../document/text-streams/draft.js';
+import '../../document/text-streams/types.js';
+import '../../document/stores/chunk.js';
+import '../../document/stores/types.js';
+import '../../document/stores/fragment-group.js';
+import '../../document/stores/graph-build-parameter.js';
+import '../../document/stores/mention-link.js';
+import '../../document/stores/mention.js';
+import '../../document/stores/object-metadata.js';
+import '../../document/stores/reading-edge.js';
+import '../../document/stores/serial.js';
+import '../../document/stores/snake/chunk.js';
+import '../../document/stores/snake/core.js';
+import '../../document/stores/snake/edge.js';
+import '../../document/directory/types.js';
+import '../../api/wiki-graph-archive.js';
+import '../../document/chapter/types.js';
+import '../../api/types.js';
+import './wikg-coordinator/session.js';
+import './wikg-coordinator/types.js';
+import '../../runtime/gc/types.js';

package/dist/storage/wikg/index.js

@@ -0,0 +1,68 @@
+import {
+  extractWikgArchive,
+  listWikgArchiveEntries,
+  readWikgArchiveEntry,
+  readWikgArchiveFormatVersion,
+  readWikgArchiveMutationToken,
+  readWikgArchiveSchemaVersion,
+  WikgArchiveReader,
+  WIKG_FORMAT_VERSION,
+  WIKG_SCHEMA_VERSION,
+  writeWikgArchive,
+  writeWikgArchiveWithOverlays
+} from "./archive/index.js";
+import {
+  formatLocatedChapterResourceUri,
+  formatLocatedChapterSourceCollectionUri,
+  formatLocatedChapterUri,
+  formatLocatedWikiGraphUri,
+  formatWikiGraphCommandUri,
+  formatWikiGraphObjectUri,
+  formatWikiGraphUriExpectedError,
+  isWikiGraphJobUri,
+  isWikiGraphUri,
+  parseLocatedWikiGraphUri,
+  parseWikiGraphUriSyntax,
+  requireArchiveUri,
+  requireLocatedObjectOrArchiveUri,
+  requireLocatedObjectUri,
+  WIKI_GRAPH_ARCHIVE_EXTENSION,
+  WIKI_GRAPH_JOB_URI_PREFIX,
+  WIKI_GRAPH_URI_PREFIX
+} from "./archive-uri.js";
+import { WikiGraphArchiveFile } from "./wiki-graph-archive-file.js";
+import { runWikgCoordinatorGc, WikgCoordinator } from "./coordinator.js";
+export {
+  WIKG_FORMAT_VERSION,
+  WIKG_SCHEMA_VERSION,
+  WIKI_GRAPH_ARCHIVE_EXTENSION,
+  WIKI_GRAPH_JOB_URI_PREFIX,
+  WIKI_GRAPH_URI_PREFIX,
+  WikgArchiveReader,
+  WikgCoordinator,
+  WikiGraphArchiveFile,
+  extractWikgArchive,
+  formatLocatedChapterResourceUri,
+  formatLocatedChapterSourceCollectionUri,
+  formatLocatedChapterUri,
+  formatLocatedWikiGraphUri,
+  formatWikiGraphCommandUri,
+  formatWikiGraphObjectUri,
+  formatWikiGraphUriExpectedError,
+  isWikiGraphJobUri,
+  isWikiGraphUri,
+  listWikgArchiveEntries,
+  parseLocatedWikiGraphUri,
+  parseWikiGraphUriSyntax,
+  readWikgArchiveEntry,
+  readWikgArchiveFormatVersion,
+  readWikgArchiveMutationToken,
+  readWikgArchiveSchemaVersion,
+  requireArchiveUri,
+  requireLocatedObjectOrArchiveUri,
+  requireLocatedObjectUri,
+  runWikgCoordinatorGc,
+  writeWikgArchive,
+  writeWikgArchiveWithOverlays
+};
+//# sourceMappingURL=index.js.map

package/dist/storage/wikg/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/storage/wikg/index.ts"],"sourcesContent":["export {\n  extractWikgArchive,\n  listWikgArchiveEntries,\n  readWikgArchiveEntry,\n  readWikgArchiveFormatVersion,\n  readWikgArchiveMutationToken,\n  readWikgArchiveSchemaVersion,\n  WikgArchiveReader,\n  WIKG_FORMAT_VERSION,\n  WIKG_SCHEMA_VERSION,\n  writeWikgArchive,\n  writeWikgArchiveWithOverlays,\n} from \"./archive/index.js\";\nexport type { WikgArchiveOverlay } from \"./archive/index.js\";\nexport {\n  formatLocatedChapterResourceUri,\n  formatLocatedChapterSourceCollectionUri,\n  formatLocatedChapterUri,\n  formatLocatedWikiGraphUri,\n  formatWikiGraphCommandUri,\n  formatWikiGraphObjectUri,\n  formatWikiGraphUriExpectedError,\n  isWikiGraphJobUri,\n  isWikiGraphUri,\n  parseLocatedWikiGraphUri,\n  parseWikiGraphUriSyntax,\n  requireArchiveUri,\n  requireLocatedObjectOrArchiveUri,\n  requireLocatedObjectUri,\n  WIKI_GRAPH_ARCHIVE_EXTENSION,\n  WIKI_GRAPH_JOB_URI_PREFIX,\n  WIKI_GRAPH_URI_PREFIX,\n} from \"./archive-uri.js\";\nexport type { LocatedWikiGraphUri, ParsedWikiGraphUri } from \"./archive-uri.js\";\nexport { WikiGraphArchiveFile } from \"./wiki-graph-archive-file.js\";\nexport { runWikgCoordinatorGc, WikgCoordinator } from \"./coordinator.js\";\n"],"mappings":"AAAA;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OACK;AAEP;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OACK;AAEP,SAAS,4BAA4B;AACrC,SAAS,sBAAsB,uBAAuB;","names":[]}

package/dist/storage/wikg/wikg-coordinator/activity.d.ts

@@ -0,0 +1,4 @@
+declare function hasActiveArchiveOwnerOrSqliteLease(archiveKey: string, entryPath: string): Promise<boolean>;
+declare function hasActiveWorkspaceUse(archiveKey: string): Promise<boolean>;
+
+export { hasActiveArchiveOwnerOrSqliteLease, hasActiveWorkspaceUse };

package/dist/storage/wikg/wikg-coordinator/activity.js

@@ -0,0 +1,48 @@
+import { cleanupStaleState, getNumber, withStateDatabase } from "./state.js";
+async function hasActiveArchiveOwnerOrSqliteLease(archiveKey, entryPath) {
+  return await withStateDatabase(async (state) => {
+    await cleanupStaleState(state);
+    const ownerCount = await state.queryOne(
+      "SELECT COUNT(*) AS count FROM archive_owners WHERE archive_key = ?",
+      [archiveKey],
+      (row) => getNumber(row, "count")
+    );
+    const leaseCount = await state.queryOne(
+      `
+SELECT COUNT(*) AS count
+FROM entry_sqlite_leases
+WHERE archive_key = ?
+  AND entry_path = ?
+`,
+      [archiveKey, entryPath],
+      (row) => getNumber(row, "count")
+    );
+    return (ownerCount ?? 0) > 0 || (leaseCount ?? 0) > 0;
+  });
+}
+async function hasActiveWorkspaceUse(archiveKey) {
+  return await withStateDatabase(async (state) => {
+    await cleanupStaleState(state);
+    const ownerCount = await state.queryOne(
+      "SELECT COUNT(*) AS count FROM archive_owners WHERE archive_key = ?",
+      [archiveKey],
+      (row) => getNumber(row, "count")
+    );
+    const leaseCount = await state.queryOne(
+      "SELECT COUNT(*) AS count FROM entry_sqlite_leases WHERE archive_key = ?",
+      [archiveKey],
+      (row) => getNumber(row, "count")
+    );
+    const lockCount = await state.queryOne(
+      "SELECT COUNT(*) AS count FROM entry_locks WHERE archive_key = ?",
+      [archiveKey],
+      (row) => getNumber(row, "count")
+    );
+    return (ownerCount ?? 0) > 0 || (leaseCount ?? 0) > 0 || (lockCount ?? 0) > 0;
+  });
+}
+export {
+  hasActiveArchiveOwnerOrSqliteLease,
+  hasActiveWorkspaceUse
+};
+//# sourceMappingURL=activity.js.map

package/dist/storage/wikg/wikg-coordinator/activity.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../src/storage/wikg/wikg-coordinator/activity.ts"],"sourcesContent":["import { cleanupStaleState, getNumber, withStateDatabase } from \"./state.js\";\n\nexport async function hasActiveArchiveOwnerOrSqliteLease(\n  archiveKey: string,\n  entryPath: string,\n): Promise<boolean> {\n  return await withStateDatabase(async (state) => {\n    await cleanupStaleState(state);\n    const ownerCount = await state.queryOne(\n      \"SELECT COUNT(*) AS count FROM archive_owners WHERE archive_key = ?\",\n      [archiveKey],\n      (row) => getNumber(row, \"count\"),\n    );\n    const leaseCount = await state.queryOne(\n      `\nSELECT COUNT(*) AS count\nFROM entry_sqlite_leases\nWHERE archive_key = ?\n  AND entry_path = ?\n`,\n      [archiveKey, entryPath],\n      (row) => getNumber(row, \"count\"),\n    );\n\n    return (ownerCount ?? 0) > 0 || (leaseCount ?? 0) > 0;\n  });\n}\n\nexport async function hasActiveWorkspaceUse(\n  archiveKey: string,\n): Promise<boolean> {\n  return await withStateDatabase(async (state) => {\n    await cleanupStaleState(state);\n    const ownerCount = await state.queryOne(\n      \"SELECT COUNT(*) AS count FROM archive_owners WHERE archive_key = ?\",\n      [archiveKey],\n      (row) => getNumber(row, \"count\"),\n    );\n    const leaseCount = await state.queryOne(\n      \"SELECT COUNT(*) AS count FROM entry_sqlite_leases WHERE archive_key = ?\",\n      [archiveKey],\n      (row) => getNumber(row, \"count\"),\n    );\n    const lockCount = await state.queryOne(\n      \"SELECT COUNT(*) AS count FROM entry_locks WHERE archive_key = ?\",\n      [archiveKey],\n      (row) => getNumber(row, \"count\"),\n    );\n\n    return (\n      (ownerCount ?? 0) > 0 || (leaseCount ?? 0) > 0 || (lockCount ?? 0) > 0\n    );\n  });\n}\n"],"mappings":"AAAA,SAAS,mBAAmB,WAAW,yBAAyB;AAEhE,eAAsB,mCACpB,YACA,WACkB;AAClB,SAAO,MAAM,kBAAkB,OAAO,UAAU;AAC9C,UAAM,kBAAkB,KAAK;AAC7B,UAAM,aAAa,MAAM,MAAM;AAAA,MAC7B;AAAA,MACA,CAAC,UAAU;AAAA,MACX,CAAC,QAAQ,UAAU,KAAK,OAAO;AAAA,IACjC;AACA,UAAM,aAAa,MAAM,MAAM;AAAA,MAC7B;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,MAMA,CAAC,YAAY,SAAS;AAAA,MACtB,CAAC,QAAQ,UAAU,KAAK,OAAO;AAAA,IACjC;AAEA,YAAQ,cAAc,KAAK,MAAM,cAAc,KAAK;AAAA,EACtD,CAAC;AACH;AAEA,eAAsB,sBACpB,YACkB;AAClB,SAAO,MAAM,kBAAkB,OAAO,UAAU;AAC9C,UAAM,kBAAkB,KAAK;AAC7B,UAAM,aAAa,MAAM,MAAM;AAAA,MAC7B;AAAA,MACA,CAAC,UAAU;AAAA,MACX,CAAC,QAAQ,UAAU,KAAK,OAAO;AAAA,IACjC;AACA,UAAM,aAAa,MAAM,MAAM;AAAA,MAC7B;AAAA,MACA,CAAC,UAAU;AAAA,MACX,CAAC,QAAQ,UAAU,KAAK,OAAO;AAAA,IACjC;AACA,UAAM,YAAY,MAAM,MAAM;AAAA,MAC5B;AAAA,MACA,CAAC,UAAU;AAAA,MACX,CAAC,QAAQ,UAAU,KAAK,OAAO;AAAA,IACjC;AAEA,YACG,cAAc,KAAK,MAAM,cAAc,KAAK,MAAM,aAAa,KAAK;AAAA,EAEzE,CAAC;AACH;","names":[]}

package/dist/storage/wikg/wikg-coordinator/archive-key.d.ts

@@ -0,0 +1,7 @@
+declare function createArchiveKey(archivePath: string): string;
+declare function createArchiveSignature(archivePath: string): Promise<string>;
+declare function createOwnerId(): string;
+declare function delay(ms: number): Promise<void>;
+declare function pathExists(path: string): Promise<boolean>;
+
+export { createArchiveKey, createArchiveSignature, createOwnerId, delay, pathExists };

package/dist/storage/wikg/wikg-coordinator/archive-key.js

@@ -0,0 +1,38 @@
+import { createHash, randomUUID } from "crypto";
+import { stat } from "fs/promises";
+import { resolve } from "path";
+import { isNodeError } from "../../../utils/node-error.js";
+function createArchiveKey(archivePath) {
+  return createHash("sha256").update(resolve(archivePath)).digest("hex");
+}
+async function createArchiveSignature(archivePath) {
+  const stats = await stat(archivePath);
+  return `${stats.size}:${stats.mtimeMs}`;
+}
+function createOwnerId() {
+  return `${process.pid}-${randomUUID()}`;
+}
+async function delay(ms) {
+  await new Promise((resolveDelay) => {
+    setTimeout(resolveDelay, ms);
+  });
+}
+async function pathExists(path) {
+  try {
+    await stat(path);
+    return true;
+  } catch (error) {
+    if (isNodeError(error) && error.code === "ENOENT") {
+      return false;
+    }
+    throw error;
+  }
+}
+export {
+  createArchiveKey,
+  createArchiveSignature,
+  createOwnerId,
+  delay,
+  pathExists
+};
+//# sourceMappingURL=archive-key.js.map

package/dist/storage/wikg/wikg-coordinator/archive-key.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../src/storage/wikg/wikg-coordinator/archive-key.ts"],"sourcesContent":["import { createHash, randomUUID } from \"crypto\";\nimport { stat } from \"fs/promises\";\nimport { resolve } from \"path\";\n\nimport { isNodeError } from \"../../../utils/node-error.js\";\n\nexport function createArchiveKey(archivePath: string): string {\n  return createHash(\"sha256\").update(resolve(archivePath)).digest(\"hex\");\n}\n\nexport async function createArchiveSignature(\n  archivePath: string,\n): Promise<string> {\n  const stats = await stat(archivePath);\n\n  return `${stats.size}:${stats.mtimeMs}`;\n}\n\nexport function createOwnerId(): string {\n  return `${process.pid}-${randomUUID()}`;\n}\n\nexport async function delay(ms: number): Promise<void> {\n  await new Promise<void>((resolveDelay) => {\n    setTimeout(resolveDelay, ms);\n  });\n}\n\nexport async function pathExists(path: string): Promise<boolean> {\n  try {\n    await stat(path);\n    return true;\n  } catch (error) {\n    if (isNodeError(error) && error.code === \"ENOENT\") {\n      return false;\n    }\n\n    throw error;\n  }\n}\n"],"mappings":"AAAA,SAAS,YAAY,kBAAkB;AACvC,SAAS,YAAY;AACrB,SAAS,eAAe;AAExB,SAAS,mBAAmB;AAErB,SAAS,iBAAiB,aAA6B;AAC5D,SAAO,WAAW,QAAQ,EAAE,OAAO,QAAQ,WAAW,CAAC,EAAE,OAAO,KAAK;AACvE;AAEA,eAAsB,uBACpB,aACiB;AACjB,QAAM,QAAQ,MAAM,KAAK,WAAW;AAEpC,SAAO,GAAG,MAAM,IAAI,IAAI,MAAM,OAAO;AACvC;AAEO,SAAS,gBAAwB;AACtC,SAAO,GAAG,QAAQ,GAAG,IAAI,WAAW,CAAC;AACvC;AAEA,eAAsB,MAAM,IAA2B;AACrD,QAAM,IAAI,QAAc,CAAC,iBAAiB;AACxC,eAAW,cAAc,EAAE;AAAA,EAC7B,CAAC;AACH;AAEA,eAAsB,WAAW,MAAgC;AAC/D,MAAI;AACF,UAAM,KAAK,IAAI;AACf,WAAO;AAAA,EACT,SAAS,OAAO;AACd,QAAI,YAAY,KAAK,KAAK,MAAM,SAAS,UAAU;AACjD,aAAO;AAAA,IACT;AAEA,UAAM;AAAA,EACR;AACF;","names":[]}

package/dist/storage/wikg/wikg-coordinator/constants.d.ts

@@ -0,0 +1,9 @@
+declare const DATABASE_ENTRY_PATH = "database.db";
+declare const SEARCH_INDEX_DATABASE_ENTRY_PATH = "fts.db";
+declare const LOCK_POLL_INTERVAL_MS = 100;
+declare const LOCK_STALE_TIMEOUT_MS = 60000;
+declare const OWNER_HEARTBEAT_INTERVAL_MS = 20000;
+declare const SQLITE_CACHE_TTL_MS: number;
+declare const ARCHIVE_SESSION_CONSTRUCTOR_TOKEN: unique symbol;
+
+export { ARCHIVE_SESSION_CONSTRUCTOR_TOKEN, DATABASE_ENTRY_PATH, LOCK_POLL_INTERVAL_MS, LOCK_STALE_TIMEOUT_MS, OWNER_HEARTBEAT_INTERVAL_MS, SEARCH_INDEX_DATABASE_ENTRY_PATH, SQLITE_CACHE_TTL_MS };

package/dist/storage/wikg/wikg-coordinator/constants.js

@@ -0,0 +1,19 @@
+const DATABASE_ENTRY_PATH = "database.db";
+const SEARCH_INDEX_DATABASE_ENTRY_PATH = "fts.db";
+const LOCK_POLL_INTERVAL_MS = 100;
+const LOCK_STALE_TIMEOUT_MS = 6e4;
+const OWNER_HEARTBEAT_INTERVAL_MS = 2e4;
+const SQLITE_CACHE_TTL_MS = 60 * 60 * 1e3;
+const ARCHIVE_SESSION_CONSTRUCTOR_TOKEN = /* @__PURE__ */ Symbol(
+  "WikgArchiveSession constructor token"
+);
+export {
+  ARCHIVE_SESSION_CONSTRUCTOR_TOKEN,
+  DATABASE_ENTRY_PATH,
+  LOCK_POLL_INTERVAL_MS,
+  LOCK_STALE_TIMEOUT_MS,
+  OWNER_HEARTBEAT_INTERVAL_MS,
+  SEARCH_INDEX_DATABASE_ENTRY_PATH,
+  SQLITE_CACHE_TTL_MS
+};
+//# sourceMappingURL=constants.js.map

package/dist/storage/wikg/wikg-coordinator/constants.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../src/storage/wikg/wikg-coordinator/constants.ts"],"sourcesContent":["export const DATABASE_ENTRY_PATH = \"database.db\";\nexport const SEARCH_INDEX_DATABASE_ENTRY_PATH = \"fts.db\";\nexport const LOCK_POLL_INTERVAL_MS = 100;\nexport const LOCK_STALE_TIMEOUT_MS = 60_000;\nexport const OWNER_HEARTBEAT_INTERVAL_MS = 20_000;\nexport const SQLITE_CACHE_TTL_MS = 60 * 60 * 1000;\nexport const ARCHIVE_SESSION_CONSTRUCTOR_TOKEN = Symbol(\n  \"WikgArchiveSession constructor token\",\n);\n"],"mappings":"AAAO,MAAM,sBAAsB;AAC5B,MAAM,mCAAmC;AACzC,MAAM,wBAAwB;AAC9B,MAAM,wBAAwB;AAC9B,MAAM,8BAA8B;AACpC,MAAM,sBAAsB,KAAK,KAAK;AACtC,MAAM,oCAAoC;AAAA,EAC/C;AACF;","names":[]}

package/dist/storage/wikg/wikg-coordinator/facade.d.ts

@@ -0,0 +1,40 @@
+import { DocumentFileStore } from '../../../document/directory/types.js';
+import { WikgArchiveSession } from './session.js';
+import { WorkspaceWritebackPolicy } from './types.js';
+import '../../../text/source/meta.js';
+import 'zod';
+import '../../../text/source/toc.js';
+import '../../../text/source/types.js';
+import '../../../document/database.js';
+import 'sqlite3';
+import '../../../document/types.js';
+import '../../../document/text-streams/serial.js';
+import '../../../document/text-streams/draft.js';
+import '../../../document/text-streams/types.js';
+import '../../../document/stores/chunk.js';
+import '../../../document/stores/types.js';
+import '../../../document/stores/fragment-group.js';
+import '../../../document/stores/graph-build-parameter.js';
+import '../../../document/stores/mention-link.js';
+import '../../../document/stores/mention.js';
+import '../../../document/stores/object-metadata.js';
+import '../../../document/stores/reading-edge.js';
+import '../../../document/stores/serial.js';
+import '../../../document/stores/snake/chunk.js';
+import '../../../document/stores/snake/core.js';
+import '../../../document/stores/snake/edge.js';
+
+declare class WikgCoordinator {
+    createFileStore(archivePath: string, options?: {
+        readonly readonlyDatabase?: boolean;
+        readonly searchIndexWritebackPolicy?: WorkspaceWritebackPolicy;
+        readonly session?: WikgArchiveSession;
+    }): DocumentFileStore;
+    withArchiveSession<T>(archivePath: string, operation: (session: WikgArchiveSession) => Promise<T> | T): Promise<T>;
+    withReadWorkspace<T>(archivePath: string, operation: (documentDirectoryPath: string) => Promise<T> | T, options?: {
+        readonly documentDirPath?: string;
+    }): Promise<T>;
+    withWriteWorkspace<T>(archivePath: string, operation: (documentDirectoryPath: string) => Promise<T> | T): Promise<T>;
+}
+
+export { WikgCoordinator };

package/dist/storage/wikg/wikg-coordinator/facade.js

@@ -0,0 +1,43 @@
+import { rm } from "fs/promises";
+import { resolve } from "path";
+import { createWikiGraphTempDirectory } from "../../../runtime/common/wiki-graph/temp.js";
+import { extractWikgArchive } from "../archive/index.js";
+import { WikgDocumentFileStore } from "./file-store.js";
+import { WikgArchiveSession } from "./session.js";
+class WikgCoordinator {
+  createFileStore(archivePath, options = {}) {
+    return new WikgDocumentFileStore(resolve(archivePath), options);
+  }
+  async withArchiveSession(archivePath, operation) {
+    const session = await WikgArchiveSession.open(resolve(archivePath));
+    try {
+      return await operation(session);
+    } finally {
+      await session.close();
+    }
+  }
+  async withReadWorkspace(archivePath, operation, options = {}) {
+    const directoryPath = options.documentDirPath === void 0 ? await createWikiGraphTempDirectory("archive-open") : resolve(options.documentDirPath);
+    try {
+      await extractWikgArchive(resolve(archivePath), directoryPath);
+      return await operation(directoryPath);
+    } finally {
+      if (options.documentDirPath === void 0) {
+        await rm(directoryPath, { force: true, recursive: true });
+      }
+    }
+  }
+  async withWriteWorkspace(archivePath, operation) {
+    const directoryPath = await createWikiGraphTempDirectory("archive-write");
+    try {
+      await extractWikgArchive(resolve(archivePath), directoryPath);
+      return await operation(directoryPath);
+    } finally {
+      await rm(directoryPath, { force: true, recursive: true });
+    }
+  }
+}
+export {
+  WikgCoordinator
+};
+//# sourceMappingURL=facade.js.map

package/dist/storage/wikg/wikg-coordinator/facade.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../src/storage/wikg/wikg-coordinator/facade.ts"],"sourcesContent":["import { rm } from \"fs/promises\";\nimport { resolve } from \"path\";\n\nimport { createWikiGraphTempDirectory } from \"../../../runtime/common/wiki-graph/temp.js\";\nimport type { DocumentFileStore } from \"../../../document/directory/index.js\";\n\nimport { extractWikgArchive } from \"../archive/index.js\";\n\nimport { WikgDocumentFileStore } from \"./file-store.js\";\nimport { WikgArchiveSession } from \"./session.js\";\nimport type { WorkspaceWritebackPolicy } from \"./types.js\";\n\nexport class WikgCoordinator {\n  public createFileStore(\n    archivePath: string,\n    options: {\n      readonly readonlyDatabase?: boolean;\n      readonly searchIndexWritebackPolicy?: WorkspaceWritebackPolicy;\n      readonly session?: WikgArchiveSession;\n    } = {},\n  ): DocumentFileStore {\n    return new WikgDocumentFileStore(resolve(archivePath), options);\n  }\n\n  public async withArchiveSession<T>(\n    archivePath: string,\n    operation: (session: WikgArchiveSession) => Promise<T> | T,\n  ): Promise<T> {\n    const session = await WikgArchiveSession.open(resolve(archivePath));\n\n    try {\n      return await operation(session);\n    } finally {\n      await session.close();\n    }\n  }\n\n  public async withReadWorkspace<T>(\n    archivePath: string,\n    operation: (documentDirectoryPath: string) => Promise<T> | T,\n    options: {\n      readonly documentDirPath?: string;\n    } = {},\n  ): Promise<T> {\n    const directoryPath =\n      options.documentDirPath === undefined\n        ? await createWikiGraphTempDirectory(\"archive-open\")\n        : resolve(options.documentDirPath);\n\n    try {\n      await extractWikgArchive(resolve(archivePath), directoryPath);\n      return await operation(directoryPath);\n    } finally {\n      if (options.documentDirPath === undefined) {\n        await rm(directoryPath, { force: true, recursive: true });\n      }\n    }\n  }\n\n  public async withWriteWorkspace<T>(\n    archivePath: string,\n    operation: (documentDirectoryPath: string) => Promise<T> | T,\n  ): Promise<T> {\n    const directoryPath = await createWikiGraphTempDirectory(\"archive-write\");\n\n    try {\n      await extractWikgArchive(resolve(archivePath), directoryPath);\n      return await operation(directoryPath);\n    } finally {\n      await rm(directoryPath, { force: true, recursive: true });\n    }\n  }\n}\n"],"mappings":"AAAA,SAAS,UAAU;AACnB,SAAS,eAAe;AAExB,SAAS,oCAAoC;AAG7C,SAAS,0BAA0B;AAEnC,SAAS,6BAA6B;AACtC,SAAS,0BAA0B;AAG5B,MAAM,gBAAgB;AAAA,EACpB,gBACL,aACA,UAII,CAAC,GACc;AACnB,WAAO,IAAI,sBAAsB,QAAQ,WAAW,GAAG,OAAO;AAAA,EAChE;AAAA,EAEA,MAAa,mBACX,aACA,WACY;AACZ,UAAM,UAAU,MAAM,mBAAmB,KAAK,QAAQ,WAAW,CAAC;AAElE,QAAI;AACF,aAAO,MAAM,UAAU,OAAO;AAAA,IAChC,UAAE;AACA,YAAM,QAAQ,MAAM;AAAA,IACtB;AAAA,EACF;AAAA,EAEA,MAAa,kBACX,aACA,WACA,UAEI,CAAC,GACO;AACZ,UAAM,gBACJ,QAAQ,oBAAoB,SACxB,MAAM,6BAA6B,cAAc,IACjD,QAAQ,QAAQ,eAAe;AAErC,QAAI;AACF,YAAM,mBAAmB,QAAQ,WAAW,GAAG,aAAa;AAC5D,aAAO,MAAM,UAAU,aAAa;AAAA,IACtC,UAAE;AACA,UAAI,QAAQ,oBAAoB,QAAW;AACzC,cAAM,GAAG,eAAe,EAAE,OAAO,MAAM,WAAW,KAAK,CAAC;AAAA,MAC1D;AAAA,IACF;AAAA,EACF;AAAA,EAEA,MAAa,mBACX,aACA,WACY;AACZ,UAAM,gBAAgB,MAAM,6BAA6B,eAAe;AAExE,QAAI;AACF,YAAM,mBAAmB,QAAQ,WAAW,GAAG,aAAa;AAC5D,aAAO,MAAM,UAAU,aAAa;AAAA,IACtC,UAAE;AACA,YAAM,GAAG,eAAe,EAAE,OAAO,MAAM,WAAW,KAAK,CAAC;AAAA,IAC1D;AAAA,EACF;AACF;","names":[]}

package/dist/storage/wikg/wikg-coordinator/file-store.d.ts

@@ -0,0 +1,52 @@
+import { DocumentFileStore } from '../../../document/directory/types.js';
+import { WorkspaceWritebackPolicy } from './types.js';
+import { WikgArchiveSession } from './session.js';
+import '../../../text/source/meta.js';
+import 'zod';
+import '../../../text/source/toc.js';
+import '../../../text/source/types.js';
+import '../../../document/database.js';
+import 'sqlite3';
+import '../../../document/types.js';
+import '../../../document/text-streams/serial.js';
+import '../../../document/text-streams/draft.js';
+import '../../../document/text-streams/types.js';
+import '../../../document/stores/chunk.js';
+import '../../../document/stores/types.js';
+import '../../../document/stores/fragment-group.js';
+import '../../../document/stores/graph-build-parameter.js';
+import '../../../document/stores/mention-link.js';
+import '../../../document/stores/mention.js';
+import '../../../document/stores/object-metadata.js';
+import '../../../document/stores/reading-edge.js';
+import '../../../document/stores/serial.js';
+import '../../../document/stores/snake/chunk.js';
+import '../../../document/stores/snake/core.js';
+import '../../../document/stores/snake/edge.js';
+
+declare class WikgDocumentFileStore implements DocumentFileStore {
+    #private;
+    constructor(archivePath: string, options: {
+        readonly readonlyDatabase?: boolean;
+        readonly searchIndexWritebackPolicy?: WorkspaceWritebackPolicy;
+        readonly session?: WikgArchiveSession;
+    });
+    close(): Promise<void>;
+    deleteFile(path: string): Promise<void>;
+    deleteTree(path: string): Promise<void>;
+    ensureDirectory(): Promise<void>;
+    initializeDatabaseSchema(): boolean;
+    markDatabaseDirty(): void;
+    markSearchIndexDatabaseDirty(): void;
+    openDatabaseReadonly(): boolean;
+    listFiles(path: string): Promise<readonly string[]>;
+    listFileContents(path: string): Promise<ReadonlyMap<string, Uint8Array>>;
+    readFile(path: string): Promise<Uint8Array | undefined>;
+    resolveDatabasePath(): Promise<string>;
+    resolveSearchIndexDatabasePath(): Promise<string>;
+    writeFile(path: string, content: string | Uint8Array, options: {
+        readonly overwrite?: boolean;
+    }): Promise<void>;
+}
+
+export { WikgDocumentFileStore };