wiki-graph-core 0.3.1 → 0.4.1

package/dist/library/lock.js

@@ -0,0 +1,121 @@
+import { getNumber, getString } from "../document/database.js";
+import { openSharedStateDatabase } from "../document/index.js";
+import { resolveWikiGraphCoreDatabasePath } from "../runtime/common/wiki-graph/dir.js";
+import {
+  acquireStateLock,
+  isStateLocked,
+  withStateLock
+} from "../state-lock.js";
+import { isNodeError } from "../utils/node-error.js";
+const LEGACY_LIBRARY_LOCK_SCHEMA_SQL = `
+  CREATE TABLE IF NOT EXISTS library_locks (
+    library_id INTEGER PRIMARY KEY,
+    mode TEXT NOT NULL,
+    owner_id TEXT NOT NULL,
+    owner_pid INTEGER NOT NULL,
+    heartbeat_at INTEGER NOT NULL,
+    created_at INTEGER NOT NULL
+  );
+`;
+const LIBRARY_LOCK_SCOPE = "library";
+const LIBRARY_LOCK_STALE_MS = 5 * 60 * 1e3;
+async function withWikiGraphLibraryLock(libraryId, mode, operation) {
+  return await withStateLock(
+    createLibraryLockOptions(libraryId, mode),
+    operation
+  );
+}
+async function acquireWikiGraphLibraryLock(libraryId, mode) {
+  const release = await acquireStateLock(
+    createLibraryLockOptions(libraryId, mode)
+  );
+  if (release === void 0) {
+    throw new Error("Wiki Graph library lock was not acquired.");
+  }
+  return release;
+}
+async function tryAcquireWikiGraphLibraryLock(libraryId, mode) {
+  return await acquireStateLock({
+    ...createLibraryLockOptions(libraryId, mode),
+    wait: false
+  });
+}
+async function isWikiGraphLibraryLocked(libraryId) {
+  return await isStateLocked({
+    databasePath: resolveWikiGraphCoreDatabasePath(),
+    resourceKey: formatLibraryResourceKey(libraryId),
+    scope: LIBRARY_LOCK_SCOPE,
+    staleMs: LIBRARY_LOCK_STALE_MS
+  }) || await isLegacyWikiGraphLibraryLocked(libraryId);
+}
+function createLibraryLockOptions(libraryId, mode) {
+  return {
+    databasePath: resolveWikiGraphCoreDatabasePath(),
+    mode,
+    resourceKey: formatLibraryResourceKey(libraryId),
+    scope: LIBRARY_LOCK_SCOPE,
+    staleMs: LIBRARY_LOCK_STALE_MS
+  };
+}
+function formatLibraryResourceKey(libraryId) {
+  return String(libraryId);
+}
+async function isLegacyWikiGraphLibraryLocked(libraryId) {
+  const database = await openLegacyLibraryLockDatabase();
+  try {
+    const existing = await database.queryOne(
+      "SELECT owner_pid, heartbeat_at FROM library_locks WHERE library_id = ?",
+      [libraryId],
+      (row) => ({
+        heartbeatAt: getNumber(row, "heartbeat_at"),
+        ownerPid: getNumber(row, "owner_pid")
+      })
+    );
+    return existing !== void 0 && isLockActive(existing);
+  } finally {
+    await database.close();
+  }
+}
+async function openLegacyLibraryLockDatabase() {
+  const database = await openSharedStateDatabase(
+    resolveWikiGraphCoreDatabasePath(),
+    LEGACY_LIBRARY_LOCK_SCHEMA_SQL
+  );
+  await ensureLegacyLibraryLockColumns(database);
+  return database;
+}
+async function ensureLegacyLibraryLockColumns(database) {
+  const columns = new Set(
+    await database.queryAll(
+      "PRAGMA table_info(library_locks)",
+      void 0,
+      (row) => getString(row, "name")
+    )
+  );
+  if (!columns.has("heartbeat_at")) {
+    await database.run(
+      "ALTER TABLE library_locks ADD COLUMN heartbeat_at INTEGER NOT NULL DEFAULT 0"
+    );
+  }
+}
+function isLockActive(lock) {
+  return Date.now() - lock.heartbeatAt <= LIBRARY_LOCK_STALE_MS && isProcessAlive(lock.ownerPid);
+}
+function isProcessAlive(pid) {
+  try {
+    process.kill(pid, 0);
+    return true;
+  } catch (error) {
+    if (isNodeError(error) && error.code === "ESRCH") {
+      return false;
+    }
+    return true;
+  }
+}
+export {
+  acquireWikiGraphLibraryLock,
+  isWikiGraphLibraryLocked,
+  tryAcquireWikiGraphLibraryLock,
+  withWikiGraphLibraryLock
+};
+//# sourceMappingURL=lock.js.map

package/dist/library/lock.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/library/lock.ts"],"sourcesContent":["import { getNumber, getString, type Database } from \"../document/database.js\";\nimport { openSharedStateDatabase } from \"../document/index.js\";\nimport { resolveWikiGraphCoreDatabasePath } from \"../runtime/common/wiki-graph/dir.js\";\nimport {\n  acquireStateLock,\n  isStateLocked,\n  withStateLock,\n  type StateLockMode,\n} from \"../state-lock.js\";\nimport { isNodeError } from \"../utils/node-error.js\";\n\nconst LEGACY_LIBRARY_LOCK_SCHEMA_SQL = `\n  CREATE TABLE IF NOT EXISTS library_locks (\n    library_id INTEGER PRIMARY KEY,\n    mode TEXT NOT NULL,\n    owner_id TEXT NOT NULL,\n    owner_pid INTEGER NOT NULL,\n    heartbeat_at INTEGER NOT NULL,\n    created_at INTEGER NOT NULL\n  );\n`;\nconst LIBRARY_LOCK_SCOPE = \"library\";\nconst LIBRARY_LOCK_STALE_MS = 5 * 60 * 1000;\n\nexport type LibraryLockMode = StateLockMode;\n\nexport async function withWikiGraphLibraryLock<T>(\n  libraryId: number,\n  mode: LibraryLockMode,\n  operation: () => Promise<T> | T,\n): Promise<T> {\n  return await withStateLock(\n    createLibraryLockOptions(libraryId, mode),\n    operation,\n  );\n}\n\nexport async function acquireWikiGraphLibraryLock(\n  libraryId: number,\n  mode: LibraryLockMode,\n): Promise<() => Promise<void>> {\n  const release = await acquireStateLock(\n    createLibraryLockOptions(libraryId, mode),\n  );\n\n  if (release === undefined) {\n    throw new Error(\"Wiki Graph library lock was not acquired.\");\n  }\n\n  return release;\n}\n\nexport async function tryAcquireWikiGraphLibraryLock(\n  libraryId: number,\n  mode: LibraryLockMode,\n): Promise<(() => Promise<void>) | undefined> {\n  return await acquireStateLock({\n    ...createLibraryLockOptions(libraryId, mode),\n    wait: false,\n  });\n}\n\nexport async function isWikiGraphLibraryLocked(\n  libraryId: number,\n): Promise<boolean> {\n  return (\n    (await isStateLocked({\n      databasePath: resolveWikiGraphCoreDatabasePath(),\n      resourceKey: formatLibraryResourceKey(libraryId),\n      scope: LIBRARY_LOCK_SCOPE,\n      staleMs: LIBRARY_LOCK_STALE_MS,\n    })) || (await isLegacyWikiGraphLibraryLocked(libraryId))\n  );\n}\n\nfunction createLibraryLockOptions(libraryId: number, mode: LibraryLockMode) {\n  return {\n    databasePath: resolveWikiGraphCoreDatabasePath(),\n    mode,\n    resourceKey: formatLibraryResourceKey(libraryId),\n    scope: LIBRARY_LOCK_SCOPE,\n    staleMs: LIBRARY_LOCK_STALE_MS,\n  };\n}\n\nfunction formatLibraryResourceKey(libraryId: number): string {\n  return String(libraryId);\n}\n\nasync function isLegacyWikiGraphLibraryLocked(\n  libraryId: number,\n): Promise<boolean> {\n  const database = await openLegacyLibraryLockDatabase();\n\n  try {\n    const existing = await database.queryOne(\n      \"SELECT owner_pid, heartbeat_at FROM library_locks WHERE library_id = ?\",\n      [libraryId],\n      (row) => ({\n        heartbeatAt: getNumber(row, \"heartbeat_at\"),\n        ownerPid: getNumber(row, \"owner_pid\"),\n      }),\n    );\n\n    return existing !== undefined && isLockActive(existing);\n  } finally {\n    await database.close();\n  }\n}\n\nasync function openLegacyLibraryLockDatabase(): Promise<Database> {\n  const database = await openSharedStateDatabase(\n    resolveWikiGraphCoreDatabasePath(),\n    LEGACY_LIBRARY_LOCK_SCHEMA_SQL,\n  );\n\n  await ensureLegacyLibraryLockColumns(database);\n  return database;\n}\n\nasync function ensureLegacyLibraryLockColumns(\n  database: Database,\n): Promise<void> {\n  const columns = new Set(\n    await database.queryAll(\n      \"PRAGMA table_info(library_locks)\",\n      undefined,\n      (row) => getString(row, \"name\"),\n    ),\n  );\n\n  if (!columns.has(\"heartbeat_at\")) {\n    await database.run(\n      \"ALTER TABLE library_locks ADD COLUMN heartbeat_at INTEGER NOT NULL DEFAULT 0\",\n    );\n  }\n}\n\nfunction isLockActive(lock: {\n  readonly heartbeatAt: number;\n  readonly ownerPid: number;\n}): boolean {\n  return (\n    Date.now() - lock.heartbeatAt <= LIBRARY_LOCK_STALE_MS &&\n    isProcessAlive(lock.ownerPid)\n  );\n}\n\nfunction isProcessAlive(pid: number): boolean {\n  try {\n    process.kill(pid, 0);\n    return true;\n  } catch (error) {\n    if (isNodeError(error) && error.code === \"ESRCH\") {\n      return false;\n    }\n\n    return true;\n  }\n}\n"],"mappings":"AAAA,SAAS,WAAW,iBAAgC;AACpD,SAAS,+BAA+B;AACxC,SAAS,wCAAwC;AACjD;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,OAEK;AACP,SAAS,mBAAmB;AAE5B,MAAM,iCAAiC;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAUvC,MAAM,qBAAqB;AAC3B,MAAM,wBAAwB,IAAI,KAAK;AAIvC,eAAsB,yBACpB,WACA,MACA,WACY;AACZ,SAAO,MAAM;AAAA,IACX,yBAAyB,WAAW,IAAI;AAAA,IACxC;AAAA,EACF;AACF;AAEA,eAAsB,4BACpB,WACA,MAC8B;AAC9B,QAAM,UAAU,MAAM;AAAA,IACpB,yBAAyB,WAAW,IAAI;AAAA,EAC1C;AAEA,MAAI,YAAY,QAAW;AACzB,UAAM,IAAI,MAAM,2CAA2C;AAAA,EAC7D;AAEA,SAAO;AACT;AAEA,eAAsB,+BACpB,WACA,MAC4C;AAC5C,SAAO,MAAM,iBAAiB;AAAA,IAC5B,GAAG,yBAAyB,WAAW,IAAI;AAAA,IAC3C,MAAM;AAAA,EACR,CAAC;AACH;AAEA,eAAsB,yBACpB,WACkB;AAClB,SACG,MAAM,cAAc;AAAA,IACnB,cAAc,iCAAiC;AAAA,IAC/C,aAAa,yBAAyB,SAAS;AAAA,IAC/C,OAAO;AAAA,IACP,SAAS;AAAA,EACX,CAAC,KAAO,MAAM,+BAA+B,SAAS;AAE1D;AAEA,SAAS,yBAAyB,WAAmB,MAAuB;AAC1E,SAAO;AAAA,IACL,cAAc,iCAAiC;AAAA,IAC/C;AAAA,IACA,aAAa,yBAAyB,SAAS;AAAA,IAC/C,OAAO;AAAA,IACP,SAAS;AAAA,EACX;AACF;AAEA,SAAS,yBAAyB,WAA2B;AAC3D,SAAO,OAAO,SAAS;AACzB;AAEA,eAAe,+BACb,WACkB;AAClB,QAAM,WAAW,MAAM,8BAA8B;AAErD,MAAI;AACF,UAAM,WAAW,MAAM,SAAS;AAAA,MAC9B;AAAA,MACA,CAAC,SAAS;AAAA,MACV,CAAC,SAAS;AAAA,QACR,aAAa,UAAU,KAAK,cAAc;AAAA,QAC1C,UAAU,UAAU,KAAK,WAAW;AAAA,MACtC;AAAA,IACF;AAEA,WAAO,aAAa,UAAa,aAAa,QAAQ;AAAA,EACxD,UAAE;AACA,UAAM,SAAS,MAAM;AAAA,EACvB;AACF;AAEA,eAAe,gCAAmD;AAChE,QAAM,WAAW,MAAM;AAAA,IACrB,iCAAiC;AAAA,IACjC;AAAA,EACF;AAEA,QAAM,+BAA+B,QAAQ;AAC7C,SAAO;AACT;AAEA,eAAe,+BACb,UACe;AACf,QAAM,UAAU,IAAI;AAAA,IAClB,MAAM,SAAS;AAAA,MACb;AAAA,MACA;AAAA,MACA,CAAC,QAAQ,UAAU,KAAK,MAAM;AAAA,IAChC;AAAA,EACF;AAEA,MAAI,CAAC,QAAQ,IAAI,cAAc,GAAG;AAChC,UAAM,SAAS;AAAA,MACb;AAAA,IACF;AAAA,EACF;AACF;AAEA,SAAS,aAAa,MAGV;AACV,SACE,KAAK,IAAI,IAAI,KAAK,eAAe,yBACjC,eAAe,KAAK,QAAQ;AAEhC;AAEA,SAAS,eAAe,KAAsB;AAC5C,MAAI;AACF,YAAQ,KAAK,KAAK,CAAC;AACnB,WAAO;AAAA,EACT,SAAS,OAAO;AACd,QAAI,YAAY,KAAK,KAAK,MAAM,SAAS,SAAS;AAChD,aAAO;AAAA,IACT;AAEA,WAAO;AAAA,EACT;AACF;","names":[]}

package/dist/library/membership.d.ts

@@ -0,0 +1,51 @@
+import { WikiGraphLibraryRecord, ParsedWikiGraphLibraryUri } from './registry.js';
+
+type WikiGraphLibraryArchiveStatus = "conflict" | "missing" | "present";
+interface WikiGraphLibraryArchiveRecord {
+    readonly id: number;
+    readonly publicId: string;
+    readonly uri: string;
+    readonly libraryId: number;
+    readonly libraryUri: string;
+    readonly relativePath: string;
+    readonly path: string;
+    readonly exists: boolean;
+    readonly status: WikiGraphLibraryArchiveStatus;
+    readonly lastSeenMutationToken?: string;
+    readonly lastSeenSize?: number;
+    readonly lastSeenMtimeMs?: number;
+    readonly lastScannedAt?: string;
+    readonly createdAt: string;
+    readonly updatedAt: string;
+}
+interface WikiGraphLibraryScanResult {
+    readonly library: WikiGraphLibraryRecord;
+    readonly archives: readonly WikiGraphLibraryArchiveRecord[];
+}
+declare function scanWikiGraphLibrary(target: ParsedWikiGraphLibraryUri): Promise<WikiGraphLibraryScanResult>;
+declare function rebindWikiGraphLibrary(input: {
+    readonly target: ParsedWikiGraphLibraryUri;
+    readonly folderPath: string;
+}): Promise<WikiGraphLibraryScanResult>;
+declare function listWikiGraphLibraryArchives(target: ParsedWikiGraphLibraryUri): Promise<readonly WikiGraphLibraryArchiveRecord[]>;
+declare function getWikiGraphLibraryArchive(target: ParsedWikiGraphLibraryUri): Promise<WikiGraphLibraryArchiveRecord>;
+declare function getWikiGraphLibraryArchiveById(library: WikiGraphLibraryRecord, archiveId: number): Promise<WikiGraphLibraryArchiveRecord>;
+declare function resolveWikiGraphLibraryArchivePath(archiveLocator: string): Promise<string>;
+declare function addWikiGraphLibraryArchive(input: {
+    readonly target: ParsedWikiGraphLibraryUri;
+    readonly inputPath: string;
+    readonly to?: string;
+}): Promise<WikiGraphLibraryArchiveRecord>;
+declare function finalizeWikiGraphLibraryArchiveWrite(input: {
+    readonly target: ParsedWikiGraphLibraryUri;
+}): Promise<boolean>;
+declare function ensureLibraryManagedArchiveHasNoSearchIndex(archivePath: string): Promise<boolean>;
+declare function removeWikiGraphLibraryArchive(input: {
+    readonly target: ParsedWikiGraphLibraryUri;
+}): Promise<WikiGraphLibraryArchiveRecord>;
+declare function moveWikiGraphLibraryArchive(input: {
+    readonly target: ParsedWikiGraphLibraryUri;
+    readonly to: string;
+}): Promise<WikiGraphLibraryArchiveRecord>;
+
+export { type WikiGraphLibraryArchiveRecord, type WikiGraphLibraryScanResult, addWikiGraphLibraryArchive, ensureLibraryManagedArchiveHasNoSearchIndex, finalizeWikiGraphLibraryArchiveWrite, getWikiGraphLibraryArchive, getWikiGraphLibraryArchiveById, listWikiGraphLibraryArchives, moveWikiGraphLibraryArchive, rebindWikiGraphLibrary, removeWikiGraphLibraryArchive, resolveWikiGraphLibraryArchivePath, scanWikiGraphLibrary };