wiki-graph-sdk 0.8.1 → 0.8.3

package/README.md

@@ -23,6 +23,36 @@ for (const job of jobs) {
 wikiGraph.close();
 ```
 
+Electron and other Node hosts may provide their own lifecycle identity and
+storage layout without importing `wiki-graph-core`:
+
+```ts
+import {
+  createNodeWikiGraphPlatform,
+  createNodeWikiGraphStorage,
+  createWikiGraphSDK,
+} from "wiki-graph-sdk";
+
+const wikiGraph = createWikiGraphSDK({
+  host: {
+    platform: createNodeWikiGraphPlatform({ lifecycle }),
+    storage: createNodeWikiGraphStorage({
+      libraryRoot: "/path/to/home",
+      documentStoreRoot: "/path/to/documents",
+    }),
+    stateDir: "/path/to/state",
+  },
+});
+```
+
+Storage and SDK configuration state are scoped to the SDK instance. Platform
+services, including lifecycle, are process-wide; SDK instances in one process
+must use one compatible platform. The top-level `stateDir` remains a shorthand
+for the default Node host. When supplying `host.storage`, put the independent
+configuration root in the required `host.stateDir` field instead. A custom
+`host.storage` without `host.stateDir` is rejected rather than falling back to
+the current user's `~/.wikigraph` directory.
+
 Applications may replace the configured LLM and embedding implementations for
 one SDK instance:
 

package/dist/archives.cjs

@@ -41,7 +41,7 @@ module.exports = __toCommonJS(archive_exports);
 
 // src/archive/archive.ts
 var import_crypto2 = require("crypto");
-var import_promises4 = require("fs/promises");
+var import_promises5 = require("fs/promises");
 var import_os3 = require("os");
 var import_path5 = require("path");
 var import_stream = require("stream");
@@ -50,7 +50,7 @@ var import_wiki_graph_core7 = require("wiki-graph-core");
 // src/conversions.ts
 var import_crypto = require("crypto");
 var import_fs = require("fs");
-var import_promises3 = require("fs/promises");
+var import_promises4 = require("fs/promises");
 var import_path4 = require("path");
 var import_wiki_graph_core3 = require("wiki-graph-core");
 
@@ -831,13 +831,15 @@ function getWikiGraphSDKRuntimeContext() {
   };
 }
 function getWikiGraphSDKStateDir() {
-  return getWikiGraphSDKRuntimeContext().stateDir;
+  const context = getWikiGraphSDKRuntimeContext();
+  return context.host?.stateDir ?? context.stateDir;
 }
 function getWikiGraphSDKProviders() {
   return getWikiGraphSDKRuntimeContext().providers ?? {};
 }
 
 // src/local-config.ts
+var import_promises2 = require("fs/promises");
 var import_path = require("path");
 var import_os = require("os");
 var LOCAL_CONFIG_SCHEMA_SQL = `
@@ -867,13 +869,10 @@ function validateLocalConfigSection(section, value) {
   }
 }
 async function withLocalConfigDatabase(operation) {
+  const stateDir = getWikiGraphSDKStateDir() ?? (0, import_path.join)((0, import_os.homedir)(), ".wikigraph");
+  await (0, import_promises2.mkdir)(stateDir, { recursive: true });
   const database = await (0, import_wiki_graph_core.openSharedStateDatabase)(
-    new NodeFile(
-      (0, import_path.join)(
-        getWikiGraphSDKStateDir() ?? (0, import_path.join)((0, import_os.homedir)(), ".wikigraph"),
-        "core.sqlite"
-      )
-    ),
+    new NodeFile((0, import_path.join)(stateDir, "core.sqlite")),
     LOCAL_CONFIG_SCHEMA_SQL
   );
   try {
@@ -1271,7 +1270,7 @@ function resolveWikiGraphRuntimePath(path) {
 }
 
 // src/archive/target.ts
-var import_promises2 = require("fs/promises");
+var import_promises3 = require("fs/promises");
 var import_path3 = require("path");
 var import_wiki_graph_core2 = require("wiki-graph-core");
 var WikiGraphArchiveOwnershipError = class extends Error {
@@ -1370,7 +1369,7 @@ async function resolveLibraryLocation(target) {
 }
 async function canonicalPath(path) {
   try {
-    return await (0, import_promises2.realpath)(path);
+    return await (0, import_promises3.realpath)(path);
   } catch {
     const absolute = (0, import_path3.resolve)(path);
     const parent = (0, import_path3.dirname)(absolute);
@@ -1421,7 +1420,7 @@ function requireUnambiguousManagedMatch(path, matches) {
 }
 async function readFileIdentity(path) {
   try {
-    const value = await (0, import_promises2.stat)(path);
+    const value = await (0, import_promises3.stat)(path);
     return `${value.dev}:${value.ino}`;
   } catch {
     return void 0;
@@ -1545,7 +1544,7 @@ async function prepareDigestDirectory(path, required) {
   if (!required || normalized === void 0 || normalized === "")
     return void 0;
   const resolved = resolveWikiGraphRuntimePath(normalized);
-  await (0, import_promises3.rm)(resolved, { force: true, recursive: true });
+  await (0, import_promises4.rm)(resolved, { force: true, recursive: true });
   return new NodeDirectory(resolved);
 }
 async function writeArchive(archive, path, format) {
@@ -1938,10 +1937,10 @@ var WikiGraphArchiveManager = class {
           });
         }
         if (options.replace === true) {
-          await (0, import_promises4.rename)(outputPath, path);
+          await (0, import_promises5.rename)(outputPath, path);
         } else {
           try {
-            await (0, import_promises4.link)(outputPath, path);
+            await (0, import_promises5.link)(outputPath, path);
           } catch (error) {
             if (isNodeEEXISTError(error)) {
               throw new WikiGraphArchiveExistsError(path);
@@ -1951,7 +1950,7 @@ var WikiGraphArchiveManager = class {
         }
         return { locatedUri: (0, import_wiki_graph_core7.formatLocatedWikiGraphUri)(path), path };
       } finally {
-        await (0, import_promises4.rm)(outputPath, { force: true, recursive: true });
+        await (0, import_promises5.rm)(outputPath, { force: true, recursive: true });
       }
     }, options.signal);
   }
@@ -2114,6 +2113,13 @@ var WikiGraphArchiveHandle = class {
     );
     return status;
   }
+  /** Clear cached search sessions without changing the archive index. */
+  async clearSearchSessions(options = {}) {
+    await this.#runtime.run(
+      async () => await (0, import_wiki_graph_core7.deleteArchiveSearchSessions)(this.path),
+      options.signal
+    );
+  }
   async listChapters(options = {}) {
     return await this.#readDocument(
       async (document) => await (0, import_wiki_graph_core7.listChapters)(document),
@@ -2565,7 +2571,7 @@ function selectChapterSubtree(chapters, rootChapterId, depth) {
   );
 }
 async function createEmptyArchiveFile(path) {
-  const directoryPath = await (0, import_promises4.mkdtemp)(
+  const directoryPath = await (0, import_promises5.mkdtemp)(
     (0, import_path5.join)((0, import_os3.tmpdir)(), "wikigraph-archive-write-")
   );
   try {
@@ -2580,7 +2586,7 @@ async function createEmptyArchiveFile(path) {
     }
     await (0, import_wiki_graph_core7.writeWikgArchive)(directory, new NodeFile(path));
   } finally {
-    await (0, import_promises4.rm)(directoryPath, { force: true, recursive: true });
+    await (0, import_promises5.rm)(directoryPath, { force: true, recursive: true });
   }
 }
 function isNodeEEXISTError(error) {
@@ -2588,7 +2594,7 @@ function isNodeEEXISTError(error) {
 }
 async function nodePathExists(path) {
   try {
-    await (0, import_promises4.stat)(path);
+    await (0, import_promises5.stat)(path);
     return true;
   } catch (error) {
     if (isNodeENOENTError(error)) return false;