wiki-graph-sdk 0.8.2 → 0.8.3

package/dist/host-IbqJ8WSV.d.ts

@@ -0,0 +1,18 @@
+import { WikiGraphPlatform, WikiGraphStorage } from 'wiki-graph-core/platform';
+
+interface WikiGraphSDKHostBase {
+    /** Process-wide runtime services. Concurrent SDKs must use one compatible platform. */
+    readonly platform?: WikiGraphPlatform;
+}
+type WikiGraphSDKHost = WikiGraphSDKHostBase & ({
+    /** Node state root for SDK configuration and other host-local state. */
+    readonly stateDir: string;
+    /** Storage roots scoped to this SDK instance or standalone operation. */
+    readonly storage: WikiGraphStorage;
+} | {
+    /** Node state root used by the default Node storage layout. */
+    readonly stateDir?: string;
+    readonly storage?: undefined;
+});
+
+export type { WikiGraphSDKHost as W };

package/dist/index.cjs

@@ -129,7 +129,7 @@ module.exports = __toCommonJS(src_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");
@@ -138,7 +138,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");
 
@@ -964,13 +964,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_SECTIONS = [
@@ -1071,13 +1073,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 {
@@ -1487,7 +1486,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 {
@@ -1616,7 +1615,7 @@ function withObjectUri(archiveLocator, objectUri) {
 }
 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);
@@ -1667,7 +1666,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;
@@ -1791,7 +1790,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) {
@@ -2209,10 +2208,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);
@@ -2222,7 +2221,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);
   }
@@ -2843,7 +2842,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 {
@@ -2858,7 +2857,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) {
@@ -2866,7 +2865,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;
@@ -3642,19 +3641,40 @@ function prepareWikiGraphSDKHost(host) {
   (0, import_platform2.installWikiGraphPlatform)(host.platform);
 }
 function assertWikiGraphSDKHostOptions(options) {
-  if (options.host?.storage !== void 0 && options.stateDir !== void 0) {
+  if (options.host?.storage !== void 0 && options.host.stateDir === void 0) {
     throw new TypeError(
-      "Wiki Graph SDK host.storage and stateDir cannot be used together."
+      "Wiki Graph SDK host.storage requires host.stateDir so SDK configuration cannot fall back to the default user state directory."
+    );
+  }
+  if (options.stateDir !== void 0 && (options.host?.stateDir !== void 0 || options.host?.storage !== void 0)) {
+    throw new TypeError(
+      "Wiki Graph SDK host state/storage and top-level stateDir cannot be used together. Put the state directory in host.stateDir when providing host.storage."
     );
   }
 }
 async function withWikiGraphSDKHost(options, operation) {
-  assertWikiGraphSDKHostOptions(options);
-  prepareWikiGraphSDKHost(options.host);
-  if (options.host?.storage !== void 0) {
-    return await (0, import_platform2.withWikiGraphStorage)(options.host.storage, operation);
+  const current = getWikiGraphSDKRuntimeContext();
+  const effective = {
+    ...options.host === void 0 ? current.host === void 0 ? {} : { host: current.host } : { host: options.host },
+    ...options.stateDir === void 0 ? current.stateDir === void 0 ? {} : { stateDir: current.stateDir } : { stateDir: options.stateDir }
+  };
+  assertWikiGraphSDKHostOptions(effective);
+  prepareWikiGraphSDKHost(effective.host);
+  const runWithContext = async () => await withWikiGraphSDKRuntimeContext(
+    {
+      ...current,
+      ...effective.host === void 0 ? {} : { host: effective.host },
+      ...effective.stateDir === void 0 ? {} : { stateDir: effective.stateDir }
+    },
+    operation
+  );
+  if (effective.host?.storage !== void 0) {
+    return await (0, import_platform2.withWikiGraphStorage)(effective.host.storage, runWithContext);
   }
-  return await withNodeWikiGraphStorage(options.stateDir, operation);
+  return await withNodeWikiGraphStorage(
+    effective.host?.stateDir ?? effective.stateDir,
+    runWithContext
+  );
 }
 
 // src/worker.ts
@@ -4556,7 +4576,7 @@ function forwardAbort(source, target) {
 
 // src/libraries.ts
 var import_wiki_graph_core16 = require("wiki-graph-core");
-var import_promises5 = require("fs/promises");
+var import_promises6 = require("fs/promises");
 async function resolveQueryEmbeddingProvider(queryMode) {
   if (queryMode === "fts") return void 0;
   const provider = await createConfiguredEmbeddingProvider();
@@ -4575,7 +4595,7 @@ var WikiGraphLibraryManager = class {
   async create(folder) {
     const record = await this.#runtime.run(async () => {
       const path = resolveWikiGraphRuntimePath(folder);
-      await (0, import_promises5.mkdir)(path);
+      await (0, import_promises6.mkdir)(path);
       return await (0, import_wiki_graph_core16.createWikiGraphLibrary)({ folder: new NodeDirectory(path) });
     });
     return new WikiGraphLibrary(this.#runtime, record);