wiki-graph-sdk 0.7.0 → 0.7.1

package/README.md

@@ -27,6 +27,22 @@ Job event subscriptions observe durable work without coupling observation to
 cancellation. Call `job.cancel()` explicitly to cancel a job; unsubscribing
 only stops the current listener.
 
+Services that receive chapter job artifacts as files can apply an ordered,
+lazy sequence through the Node delivery boundary without importing Core:
+
+```ts
+import { applyWikiGraphJobArtifacts } from "wiki-graph-sdk/worker";
+
+await applyWikiGraphJobArtifacts({
+  artifacts,
+  stateDir: "/tmp/job/sdk-state",
+  wikgPath: "/tmp/job/archive.wikg",
+});
+```
+
+Each artifact carries its chapter, job kind, and source revision. The operation
+stops before consuming later artifacts when a revision no longer matches.
+
 The SDK intentionally has no `execute(command, args)` API. CLI argument
 parsing, help text, terminal formatting, JSON, and JSONL rendering belong to
 the `wiki-graph` package. SDK methods return typed objects and job events.

package/dist/archives.cjs

@@ -40,15 +40,18 @@ __export(archive_exports, {
 module.exports = __toCommonJS(archive_exports);
 
 // src/archive/archive.ts
-var import_crypto = require("crypto");
+var import_crypto2 = require("crypto");
 var import_promises3 = require("fs/promises");
 var import_os3 = require("os");
-var import_path3 = require("path");
+var import_path4 = require("path");
 var import_stream = require("stream");
 var import_wiki_graph_core5 = require("wiki-graph-core");
 
 // src/conversions.ts
+var import_crypto = require("crypto");
+var import_fs = require("fs");
 var import_promises2 = require("fs/promises");
+var import_path3 = require("path");
 var import_wiki_graph_core2 = require("wiki-graph-core");
 
 // src/llm.ts
@@ -1269,6 +1272,9 @@ var WikiGraphConversionManager = class {
     if (options.targetStage !== void 0 && options.output.format !== "wikg") {
       throw new Error("targetStage is only supported for wikg output.");
     }
+    if (options.output.format === "pcex") {
+      throw new Error("pcex is supported only as a conversion input.");
+    }
     if (options.targetStage !== void 0 && options.input.format === "wikg") {
       throw new Error(
         "targetStage is only supported when creating a wikg archive."
@@ -1287,7 +1293,13 @@ var WikiGraphConversionManager = class {
       options.digestDirectory,
       requiresDigest
     );
+    let chapterCount;
     const write = async (archive) => {
+      if (requiresDigest) await options.onSourceImported?.();
+      if (typeof archive.readToc === "function") {
+        const toc = await archive.readToc();
+        chapterCount = toc === void 0 ? void 0 : countTocChapters(toc.items);
+      }
       await writeArchive(archive, options.output.path, options.output.format);
     };
     if (options.input.format === "wikg") {
@@ -1320,16 +1332,28 @@ var WikiGraphConversionManager = class {
       };
       if (options.input.format === "epub") {
         await app.digestEpubSession(digestOptions, write);
+      } else if (options.input.format === "pcex") {
+        await app.digestPcexSession(
+          {
+            ...digestOptions,
+            pdfDigest: options.input.sourcePdf.digest,
+            ...options.input.sourcePdf.name === void 0 ? {} : { pdfName: options.input.sourcePdf.name }
+          },
+          write
+        );
       } else if (options.input.format === "markdown") {
         await app.digestMarkdownSession(digestOptions, write);
       } else {
         await app.digestTxtSession(digestOptions, write);
       }
     }
+    const sourceArtifact = await resolveSourceArtifact(options.input);
     return {
+      ...chapterCount === void 0 ? {} : { chapterCount },
       inputFormat: options.input.format,
       outputFormat: options.output.format,
-      outputPath: options.output.path
+      outputPath: options.output.path,
+      ...sourceArtifact === void 0 ? {} : { sourceArtifact }
     };
   }
 };
@@ -1345,8 +1369,48 @@ async function writeArchive(archive, path, format) {
   const file = new NodeFile(resolveWikiGraphRuntimePath(path));
   if (format === "epub") await archive.exportEpub(file);
   else if (format === "wikg") await archive.saveAs(file);
+  else if (format === "pcex") throw new Error("pcex output is not supported.");
   else await archive.exportText(file);
 }
+async function resolveSourceArtifact(input) {
+  if (!("path" in input) || input.format === "wikg") return void 0;
+  if (input.format === "pcex") {
+    return {
+      digest: input.sourcePdf.digest.trim().toLowerCase(),
+      mediaType: "application/pdf",
+      ...input.sourcePdf.name === void 0 ? {} : { name: input.sourcePdf.name }
+    };
+  }
+  if (input.format !== "epub") return void 0;
+  const path = resolveWikiGraphRuntimePath(input.path);
+  const hash = (0, import_crypto.createHash)("sha256");
+  try {
+    for await (const chunk of (0, import_fs.createReadStream)(path)) {
+      hash.update(chunk);
+    }
+  } catch (error) {
+    if (isNodeErrorCode(error, "ENOENT")) return void 0;
+    throw error;
+  }
+  return {
+    digest: hash.digest("hex"),
+    mediaType: "application/epub+zip",
+    name: (0, import_path3.basename)(path)
+  };
+}
+function isNodeErrorCode(error, code) {
+  return typeof error === "object" && error !== null && "code" in error && error.code === code;
+}
+function countTocChapters(items) {
+  let count = 0;
+  for (const item of items) {
+    if (item.serialId !== void 0) count += 1;
+    count += countTocChapters(
+      item.children
+    );
+  }
+  return count;
+}
 
 // src/query-runtime.ts
 var import_wiki_graph_core3 = require("wiki-graph-core");
@@ -2019,9 +2083,9 @@ var WikiGraphArchiveManager = class {
       if (options.replace !== true && await nodePathExists(path)) {
         throw new WikiGraphArchiveExistsError(path);
       }
-      const outputPath = (0, import_path3.join)(
-        (0, import_path3.dirname)(path),
-        `.${(0, import_path3.basename)(path)}.${(0, import_crypto.randomUUID)()}.tmp.wikg`
+      const outputPath = (0, import_path4.join)(
+        (0, import_path4.dirname)(path),
+        `.${(0, import_path4.basename)(path)}.${(0, import_crypto2.randomUUID)()}.tmp.wikg`
       );
       try {
         if (options.importPath === void 0) {
@@ -2664,7 +2728,7 @@ function createPathLocation(path) {
 }
 async function createEmptyArchiveFile(path) {
   const directoryPath = await (0, import_promises3.mkdtemp)(
-    (0, import_path3.join)((0, import_os3.tmpdir)(), "wikigraph-archive-write-")
+    (0, import_path4.join)((0, import_os3.tmpdir)(), "wikigraph-archive-write-")
   );
   try {
     const directory = new NodeDirectory(directoryPath);