wiki-graph-sdk 0.7.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (98) hide show
  1. package/LICENSE +201 -0
  2. package/README.md +32 -0
  3. package/dist/archives.cjs +2799 -0
  4. package/dist/archives.cjs.map +1 -0
  5. package/dist/archives.d.ts +249 -0
  6. package/dist/archives.js +2814 -0
  7. package/dist/archives.js.map +1 -0
  8. package/dist/conversions.cjs +1332 -0
  9. package/dist/conversions.cjs.map +1 -0
  10. package/dist/conversions.d.ts +37 -0
  11. package/dist/conversions.js +1308 -0
  12. package/dist/conversions.js.map +1 -0
  13. package/dist/data/editor/clue_reviewer.jinja +410 -0
  14. package/dist/data/editor/clue_reviewer_generator.jinja +428 -0
  15. package/dist/data/editor/revision_feedback.jinja +5 -0
  16. package/dist/data/editor/text_compressor.jinja +131 -0
  17. package/dist/data/guaranteed/response_intent_classifier.jinja +8 -0
  18. package/dist/data/output/epub/cover.xhtml.jinja +13 -0
  19. package/dist/data/output/epub/nav.xhtml.jinja +12 -0
  20. package/dist/data/output/epub/package.opf.xml.jinja +39 -0
  21. package/dist/data/output/epub/section.xhtml.jinja +12 -0
  22. package/dist/data/topologization/book_coherence_extraction.jinja +223 -0
  23. package/dist/data/topologization/chunk_extraction.jinja +233 -0
  24. package/dist/data/topologization/evidence_choice.jinja +38 -0
  25. package/dist/data/topologization/translate_chunks.jinja +138 -0
  26. package/dist/data/topologization/user_focused_extraction.jinja +378 -0
  27. package/dist/default-worker.cjs +1709 -0
  28. package/dist/default-worker.cjs.map +1 -0
  29. package/dist/default-worker.d.ts +10 -0
  30. package/dist/default-worker.js +1705 -0
  31. package/dist/default-worker.js.map +1 -0
  32. package/dist/embedding.cjs +1091 -0
  33. package/dist/embedding.cjs.map +1 -0
  34. package/dist/embedding.d.ts +26 -0
  35. package/dist/embedding.js +1062 -0
  36. package/dist/embedding.js.map +1 -0
  37. package/dist/entry-context.cjs +91 -0
  38. package/dist/entry-context.cjs.map +1 -0
  39. package/dist/entry-context.d.ts +20 -0
  40. package/dist/entry-context.js +68 -0
  41. package/dist/entry-context.js.map +1 -0
  42. package/dist/gc.cjs +731 -0
  43. package/dist/gc.cjs.map +1 -0
  44. package/dist/gc.d.ts +14 -0
  45. package/dist/gc.js +707 -0
  46. package/dist/gc.js.map +1 -0
  47. package/dist/index.cjs +4760 -0
  48. package/dist/index.cjs.map +1 -0
  49. package/dist/index.d.ts +213 -0
  50. package/dist/index.js +4808 -0
  51. package/dist/index.js.map +1 -0
  52. package/dist/jobs-Dd5PMSId.d.ts +98 -0
  53. package/dist/llm.cjs +101 -0
  54. package/dist/llm.cjs.map +1 -0
  55. package/dist/llm.d.ts +7 -0
  56. package/dist/llm.js +79 -0
  57. package/dist/llm.js.map +1 -0
  58. package/dist/local-config.cjs +1024 -0
  59. package/dist/local-config.cjs.map +1 -0
  60. package/dist/local-config.d.ts +14 -0
  61. package/dist/local-config.js +989 -0
  62. package/dist/local-config.js.map +1 -0
  63. package/dist/maintenance.cjs +800 -0
  64. package/dist/maintenance.cjs.map +1 -0
  65. package/dist/maintenance.d.ts +24 -0
  66. package/dist/maintenance.js +778 -0
  67. package/dist/maintenance.js.map +1 -0
  68. package/dist/node-platform.cjs +758 -0
  69. package/dist/node-platform.cjs.map +1 -0
  70. package/dist/node-platform.d.ts +49 -0
  71. package/dist/node-platform.js +723 -0
  72. package/dist/node-platform.js.map +1 -0
  73. package/dist/planning.cjs +164 -0
  74. package/dist/planning.cjs.map +1 -0
  75. package/dist/planning.d.ts +43 -0
  76. package/dist/planning.js +137 -0
  77. package/dist/planning.js.map +1 -0
  78. package/dist/runtime-config.cjs +1155 -0
  79. package/dist/runtime-config.cjs.map +1 -0
  80. package/dist/runtime-config.d.ts +50 -0
  81. package/dist/runtime-config.js +1127 -0
  82. package/dist/runtime-config.js.map +1 -0
  83. package/dist/stage.cjs +1265 -0
  84. package/dist/stage.cjs.map +1 -0
  85. package/dist/stage.d.ts +16 -0
  86. package/dist/stage.js +1239 -0
  87. package/dist/stage.js.map +1 -0
  88. package/dist/wikispine.cjs +85 -0
  89. package/dist/wikispine.cjs.map +1 -0
  90. package/dist/wikispine.d.ts +6 -0
  91. package/dist/wikispine.js +63 -0
  92. package/dist/wikispine.js.map +1 -0
  93. package/dist/worker.cjs +738 -0
  94. package/dist/worker.cjs.map +1 -0
  95. package/dist/worker.d.ts +157 -0
  96. package/dist/worker.js +715 -0
  97. package/dist/worker.js.map +1 -0
  98. package/package.json +151 -0
package/dist/gc.cjs ADDED
@@ -0,0 +1,731 @@
1
+ globalThis.__WIKIGRAPH_DATA_DIR__ ??= require("path").resolve(__dirname, "data");
2
+ "use strict";
3
+ var __create = Object.create;
4
+ var __defProp = Object.defineProperty;
5
+ var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
6
+ var __getOwnPropNames = Object.getOwnPropertyNames;
7
+ var __getProtoOf = Object.getPrototypeOf;
8
+ var __hasOwnProp = Object.prototype.hasOwnProperty;
9
+ var __export = (target, all) => {
10
+ for (var name in all)
11
+ __defProp(target, name, { get: all[name], enumerable: true });
12
+ };
13
+ var __copyProps = (to, from, except, desc) => {
14
+ if (from && typeof from === "object" || typeof from === "function") {
15
+ for (let key of __getOwnPropNames(from))
16
+ if (!__hasOwnProp.call(to, key) && key !== except)
17
+ __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
18
+ }
19
+ return to;
20
+ };
21
+ var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
22
+ // If the importer is in node compatibility mode or this is not an ESM
23
+ // file that has been converted to a CommonJS file using a Babel-
24
+ // compatible transform (i.e. "__esModule" has not been set), then set
25
+ // "default" to the CommonJS "module.exports" for node compatibility.
26
+ isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
27
+ mod
28
+ ));
29
+ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
30
+
31
+ // src/gc.ts
32
+ var gc_exports = {};
33
+ __export(gc_exports, {
34
+ tryRunWikiGraphGc: () => tryRunWikiGraphGc
35
+ });
36
+ module.exports = __toCommonJS(gc_exports);
37
+ var import_gc = require("wiki-graph-core/gc");
38
+
39
+ // src/node-platform.ts
40
+ var asyncHooks = __toESM(require("async_hooks"), 1);
41
+ var crypto = __toESM(require("crypto"), 1);
42
+ var fs = __toESM(require("fs"), 1);
43
+ var fsPromises = __toESM(require("fs/promises"), 1);
44
+ var os = __toESM(require("os"), 1);
45
+ var pathModule = __toESM(require("path"), 1);
46
+ var process = __toESM(require("process"), 1);
47
+ var import_node_stream = require("stream");
48
+ var import_promises = require("stream/promises");
49
+ var sqlite3 = __toESM(require("sqlite3"), 1);
50
+ var yauzl = __toESM(require("yauzl"), 1);
51
+ var yazl = __toESM(require("yazl"), 1);
52
+ var import_nunjucks = require("nunjucks");
53
+ var import_platform = require("wiki-graph-core/platform");
54
+ var nodeProcess = process.default ?? process;
55
+ var nodeSqlite3 = sqlite3.default ?? sqlite3;
56
+ var NODE_RESOURCE_KIND = /* @__PURE__ */ Symbol.for("wiki-graph-sdk.node-resource.v1");
57
+ var NodeFile = class {
58
+ constructor(path, name = pathModule.basename(path)) {
59
+ this.path = path;
60
+ this.identity = encodeNodeResourceIdentity("file", path);
61
+ this.name = name;
62
+ }
63
+ path;
64
+ kind = "file";
65
+ [NODE_RESOURCE_KIND] = "file";
66
+ identity;
67
+ name;
68
+ async openReader() {
69
+ const handle = await fsPromises.open(this.path, "r");
70
+ let closed = false;
71
+ try {
72
+ const stats = await handle.stat();
73
+ if (!stats.isFile())
74
+ throw new Error("File reader requires a regular file");
75
+ const { size } = stats;
76
+ return {
77
+ size,
78
+ close: async () => {
79
+ if (!closed) await handle.close();
80
+ closed = true;
81
+ },
82
+ read: async (offset, length) => {
83
+ if (closed) throw new Error("Cannot read from a closed FileReader");
84
+ assertFileRange(offset, length, size);
85
+ const buffer = Buffer.allocUnsafe(length);
86
+ let bytesRead = 0;
87
+ while (bytesRead < length) {
88
+ const result = await handle.read(
89
+ buffer,
90
+ bytesRead,
91
+ length - bytesRead,
92
+ offset + bytesRead
93
+ );
94
+ if (result.bytesRead === 0) {
95
+ throw new Error("File changed while reading its byte range");
96
+ }
97
+ bytesRead += result.bytesRead;
98
+ }
99
+ return new Uint8Array(buffer.buffer, buffer.byteOffset, bytesRead);
100
+ }
101
+ };
102
+ } catch (error) {
103
+ await handle.close();
104
+ throw error;
105
+ }
106
+ }
107
+ async getLastModified() {
108
+ try {
109
+ return (await fsPromises.stat(this.path)).mtimeMs;
110
+ } catch (error) {
111
+ if (typeof error === "object" && error !== null && "code" in error && error.code === "ENOENT") {
112
+ return void 0;
113
+ }
114
+ throw error;
115
+ }
116
+ }
117
+ async openWriter() {
118
+ await fsPromises.mkdir(pathModule.dirname(this.path), { recursive: true });
119
+ const temporary = `${this.path}.tmp-${crypto.randomUUID()}`;
120
+ const handle = await fsPromises.open(temporary, "wx");
121
+ let closed = false;
122
+ return {
123
+ write: async (data) => {
124
+ if (closed) throw new Error("Cannot write to a closed FileWriter");
125
+ await writeNodeFileHandle(handle, data);
126
+ },
127
+ writeAt: async (offset, data) => {
128
+ if (closed) throw new Error("Cannot write to a closed FileWriter");
129
+ assertFileOffset(offset);
130
+ await writeNodeFileHandle(handle, data, offset);
131
+ },
132
+ commit: async () => {
133
+ if (!closed) {
134
+ await handle.close();
135
+ await fsPromises.rename(temporary, this.path);
136
+ }
137
+ closed = true;
138
+ },
139
+ abort: async () => {
140
+ if (!closed) {
141
+ await handle.close();
142
+ await fsPromises.rm(temporary, { force: true });
143
+ }
144
+ closed = true;
145
+ }
146
+ };
147
+ }
148
+ };
149
+ async function writeNodeFileHandle(handle, data, position) {
150
+ const buffer = Buffer.from(data);
151
+ let written = 0;
152
+ while (written < buffer.byteLength) {
153
+ const result = await handle.write(
154
+ buffer,
155
+ written,
156
+ buffer.byteLength - written,
157
+ position === void 0 ? null : position + written
158
+ );
159
+ if (result.bytesWritten === 0) {
160
+ throw new Error("File writer made no progress");
161
+ }
162
+ written += result.bytesWritten;
163
+ }
164
+ }
165
+ function assertFileRange(offset, length, size) {
166
+ assertFileOffset(offset);
167
+ if (!Number.isSafeInteger(length) || length < 0) {
168
+ throw new RangeError(
169
+ "File read length must be a non-negative safe integer"
170
+ );
171
+ }
172
+ if (offset > size || length > size - offset) {
173
+ throw new RangeError("File read range exceeds the file size");
174
+ }
175
+ }
176
+ function assertFileOffset(offset) {
177
+ if (!Number.isSafeInteger(offset) || offset < 0) {
178
+ throw new RangeError("File offset must be a non-negative safe integer");
179
+ }
180
+ }
181
+ var NodeDirectory = class _NodeDirectory {
182
+ constructor(path) {
183
+ this.path = path;
184
+ this.identity = encodeNodeResourceIdentity("directory", path);
185
+ this.name = pathModule.basename(path);
186
+ }
187
+ path;
188
+ kind = "directory";
189
+ [NODE_RESOURCE_KIND] = "directory";
190
+ identity;
191
+ name;
192
+ async getFile(name) {
193
+ assertChildName(name);
194
+ const file = new NodeFile(pathModule.join(this.path, name));
195
+ try {
196
+ return (await fsPromises.stat(file.path)).isFile() ? file : void 0;
197
+ } catch {
198
+ return void 0;
199
+ }
200
+ }
201
+ async getLastModified() {
202
+ try {
203
+ return (await fsPromises.stat(this.path)).mtimeMs;
204
+ } catch (error) {
205
+ if (typeof error === "object" && error !== null && "code" in error && error.code === "ENOENT") {
206
+ return void 0;
207
+ }
208
+ throw error;
209
+ }
210
+ }
211
+ async getDirectory(name) {
212
+ assertChildName(name);
213
+ const directory = new _NodeDirectory(pathModule.join(this.path, name));
214
+ try {
215
+ return (await fsPromises.stat(directory.path)).isDirectory() ? directory : void 0;
216
+ } catch {
217
+ return void 0;
218
+ }
219
+ }
220
+ async list() {
221
+ const entries = await fsPromises.readdir(this.path, {
222
+ withFileTypes: true
223
+ });
224
+ return entries.map(
225
+ (entry) => entry.isDirectory() ? new _NodeDirectory(pathModule.join(this.path, entry.name)) : new NodeFile(pathModule.join(this.path, entry.name), entry.name)
226
+ );
227
+ }
228
+ async createFile(name) {
229
+ assertChildName(name);
230
+ await fsPromises.mkdir(this.path, { recursive: true });
231
+ const file = new NodeFile(pathModule.join(this.path, name));
232
+ await fsPromises.writeFile(file.path, "", { flag: "wx" });
233
+ return file;
234
+ }
235
+ async createDirectory(name) {
236
+ assertChildName(name);
237
+ await fsPromises.mkdir(this.path, { recursive: true });
238
+ const directory = new _NodeDirectory(pathModule.join(this.path, name));
239
+ await fsPromises.mkdir(directory.path);
240
+ return directory;
241
+ }
242
+ async remove(name, options) {
243
+ assertChildName(name);
244
+ await fsPromises.rm(pathModule.join(this.path, name), {
245
+ force: true,
246
+ recursive: options?.recursive === true
247
+ });
248
+ }
249
+ };
250
+ function encodeNodeResourceIdentity(kind, path) {
251
+ return `node-${kind}:${Buffer.from(pathModule.resolve(path), "utf8").toString("base64url")}`;
252
+ }
253
+ function decodeNodeResourceIdentity(identity, kind) {
254
+ const prefix = `node-${kind}:`;
255
+ if (!identity.startsWith(prefix)) {
256
+ return pathModule.isAbsolute(identity) ? identity : void 0;
257
+ }
258
+ try {
259
+ return Buffer.from(identity.slice(prefix.length), "base64url").toString(
260
+ "utf8"
261
+ );
262
+ } catch {
263
+ return void 0;
264
+ }
265
+ }
266
+ function assertChildName(name) {
267
+ if (name.length === 0 || name === "." || name === ".." || pathModule.isAbsolute(name) || name.includes("/") || name.includes("\\")) {
268
+ throw new TypeError(`Directory child must be a relative name: ${name}`);
269
+ }
270
+ }
271
+ var NodeDatabaseConnection = class {
272
+ constructor(database) {
273
+ this.database = database;
274
+ }
275
+ database;
276
+ async close() {
277
+ await new Promise((resolve2, reject) => {
278
+ this.database.close((error) => {
279
+ if (error) reject(error);
280
+ else resolve2();
281
+ });
282
+ });
283
+ }
284
+ async execute(sql) {
285
+ await new Promise((resolve2, reject) => {
286
+ this.database.exec(sql, (error) => {
287
+ if (error) reject(error);
288
+ else resolve2();
289
+ });
290
+ });
291
+ }
292
+ async queryAll(sql, params = []) {
293
+ return await new Promise((resolve2, reject) => {
294
+ this.database.all(sql, [...params], (error, rows) => {
295
+ if (error) reject(error);
296
+ else resolve2(rows);
297
+ });
298
+ });
299
+ }
300
+ async queryOne(sql, params = []) {
301
+ return await new Promise((resolve2, reject) => {
302
+ this.database.get(sql, [...params], (error, row) => {
303
+ if (error) reject(error);
304
+ else resolve2(row);
305
+ });
306
+ });
307
+ }
308
+ async run(sql, params = []) {
309
+ await new Promise((resolve2, reject) => {
310
+ this.database.run(sql, [...params], (error) => {
311
+ if (error) reject(error);
312
+ else resolve2();
313
+ });
314
+ });
315
+ }
316
+ };
317
+ async function openNodeDatabase(file, options) {
318
+ const flags = (options.mode === "readonly" ? nodeSqlite3.OPEN_READONLY : nodeSqlite3.OPEN_READWRITE | (options.create ? nodeSqlite3.OPEN_CREATE : 0)) | nodeSqlite3.OPEN_FULLMUTEX;
319
+ return new NodeDatabaseConnection(await openNativeNodeDatabase(file, flags));
320
+ }
321
+ async function openNativeNodeDatabase(file, flags) {
322
+ const path = getBrandedNodeResourcePath(file, "file");
323
+ if (path === void 0) {
324
+ throw new TypeError("The Node database adapter requires a NodeFile");
325
+ }
326
+ return await new Promise((resolve2, reject) => {
327
+ const database = new nodeSqlite3.Database(path, flags, (error) => {
328
+ if (error) reject(error);
329
+ else resolve2(database);
330
+ });
331
+ });
332
+ }
333
+ async function openNodeZip(file) {
334
+ const path = getBrandedNodeResourcePath(file, "file");
335
+ if (path === void 0) {
336
+ throw new TypeError("The Node ZIP adapter requires a NodeFile");
337
+ }
338
+ const zipFile = await new Promise((resolve2, reject) => {
339
+ yauzl.open(
340
+ path,
341
+ { autoClose: false, lazyEntries: true },
342
+ (error, opened) => {
343
+ if (error || opened === void 0)
344
+ reject(error ?? new Error("Cannot open ZIP"));
345
+ else resolve2(opened);
346
+ }
347
+ );
348
+ });
349
+ const entries = await new Promise(
350
+ (resolve2, reject) => {
351
+ const discovered = /* @__PURE__ */ new Map();
352
+ const rejectAndClose = (error) => {
353
+ zipFile.close();
354
+ reject(
355
+ error instanceof Error ? error : new Error("Cannot scan ZIP central directory")
356
+ );
357
+ };
358
+ const resolveEntries = () => {
359
+ zipFile.off("error", rejectAndClose);
360
+ resolve2(discovered);
361
+ };
362
+ zipFile.on("entry", (entry) => {
363
+ if (!entry.fileName.endsWith("/")) {
364
+ discovered.set(entry.fileName, entry);
365
+ }
366
+ zipFile.readEntry();
367
+ });
368
+ zipFile.once("error", rejectAndClose);
369
+ zipFile.once("end", resolveEntries);
370
+ zipFile.readEntry();
371
+ }
372
+ );
373
+ let closed = false;
374
+ return {
375
+ close: () => {
376
+ if (!closed) zipFile.close();
377
+ closed = true;
378
+ return Promise.resolve();
379
+ },
380
+ copyEntry: async (name, target) => {
381
+ if (closed) throw new Error("Cannot read a closed ZIP archive");
382
+ const entry = entries.get(name);
383
+ if (entry === void 0) return false;
384
+ await copyNodeZipEntry(zipFile, entry, target);
385
+ return true;
386
+ },
387
+ getEntrySize: (name) => {
388
+ if (closed) throw new Error("Cannot read a closed ZIP archive");
389
+ return Promise.resolve(entries.get(name)?.uncompressedSize);
390
+ },
391
+ listEntries: () => Promise.resolve([...entries.keys()]),
392
+ readEntryRange: async (name, offset, length) => {
393
+ if (closed) throw new Error("Cannot read a closed ZIP archive");
394
+ const entry = entries.get(name);
395
+ if (entry === void 0) return void 0;
396
+ return await readNodeZipEntryRange(zipFile, entry, offset, length);
397
+ },
398
+ readEntry: async (name) => {
399
+ if (closed) throw new Error("Cannot read a closed ZIP archive");
400
+ const entry = entries.get(name);
401
+ if (entry === void 0) return void 0;
402
+ return await readNodeZipEntry(zipFile, entry);
403
+ }
404
+ };
405
+ }
406
+ async function copyNodeZipEntry(zipFile, entry, target) {
407
+ const writer = await target.openWriter();
408
+ try {
409
+ const stream = await openNodeZipEntryStream(zipFile, entry);
410
+ await writeNodeStream(stream, writer);
411
+ await writer.commit();
412
+ } catch (error) {
413
+ await writer.abort().catch(() => void 0);
414
+ throw error;
415
+ }
416
+ }
417
+ async function readNodeZipEntry(zipFile, entry) {
418
+ return await collectNodeStream(await openNodeZipEntryStream(zipFile, entry));
419
+ }
420
+ async function readNodeZipEntryRange(zipFile, entry, offset, length) {
421
+ assertFileRange(offset, length, entry.uncompressedSize);
422
+ if (length === 0) return new Uint8Array();
423
+ if (entry.compressionMethod !== 0) {
424
+ const content2 = await collectDecodedNodeStreamRange(
425
+ await openNodeZipEntryStream(zipFile, entry),
426
+ offset,
427
+ length
428
+ );
429
+ return new Uint8Array(
430
+ content2.buffer,
431
+ content2.byteOffset,
432
+ content2.byteLength
433
+ );
434
+ }
435
+ const content = await collectNodeStream(
436
+ await openNodeZipEntryStream(zipFile, entry, {
437
+ decompress: null,
438
+ decrypt: null,
439
+ end: offset + length,
440
+ start: offset
441
+ })
442
+ );
443
+ return new Uint8Array(content.buffer, content.byteOffset, content.byteLength);
444
+ }
445
+ async function collectDecodedNodeStreamRange(input, offset, length) {
446
+ const chunks = [];
447
+ const end = offset + length;
448
+ let position = 0;
449
+ let collected = 0;
450
+ for await (const value of input) {
451
+ const chunk = Buffer.isBuffer(value) ? value : Buffer.from(value);
452
+ const chunkEnd = position + chunk.byteLength;
453
+ if (chunkEnd > offset && position < end) {
454
+ const selected = chunk.subarray(
455
+ Math.max(0, offset - position),
456
+ Math.min(chunk.byteLength, end - position)
457
+ );
458
+ chunks.push(selected);
459
+ collected += selected.byteLength;
460
+ }
461
+ position = chunkEnd;
462
+ if (position >= end) break;
463
+ }
464
+ if (collected !== length) {
465
+ throw new Error("ZIP entry changed while reading its byte range");
466
+ }
467
+ return Buffer.concat(chunks, collected);
468
+ }
469
+ async function openNodeZipEntryStream(zipFile, entry, options) {
470
+ return await new Promise((resolve2, reject) => {
471
+ const callback = (error, opened) => {
472
+ if (error || opened === void 0) {
473
+ reject(error ?? new Error(`Cannot read ZIP entry: ${entry.fileName}`));
474
+ } else {
475
+ resolve2(opened);
476
+ }
477
+ };
478
+ if (options === void 0) zipFile.openReadStream(entry, callback);
479
+ else zipFile.openReadStream(entry, options, callback);
480
+ });
481
+ }
482
+ async function writeNodeZip(file, entries) {
483
+ const zipFile = new yazl.ZipFile();
484
+ const writer = await file.openWriter();
485
+ const outputStream = zipFile.outputStream;
486
+ const outputDone = writeNodeStream(outputStream, writer);
487
+ const entryState = { cancelled: false, complete: false };
488
+ let iterator;
489
+ try {
490
+ iterator = getNodeZipEntryIterator(entries);
491
+ const entriesDone = addNodeZipEntries(zipFile, iterator, entryState);
492
+ await Promise.race([entriesDone, outputDone]);
493
+ if (!entryState.complete) {
494
+ throw new Error("ZIP output ended before entry production completed");
495
+ }
496
+ zipFile.end();
497
+ await outputDone;
498
+ await writer.commit();
499
+ } catch (error) {
500
+ entryState.cancelled = true;
501
+ if (!entryState.complete && iterator !== void 0) {
502
+ closeNodeZipEntryIterator(iterator);
503
+ }
504
+ if (!outputStream.destroyed) {
505
+ outputStream.destroy(
506
+ error instanceof Error ? error : new Error("Cannot write ZIP archive")
507
+ );
508
+ }
509
+ await outputDone.catch(() => void 0);
510
+ await writer.abort().catch(() => void 0);
511
+ throw error;
512
+ }
513
+ }
514
+ async function addNodeZipEntries(zipFile, iterator, state) {
515
+ while (!state.cancelled) {
516
+ const result = await iterator.next();
517
+ if (state.cancelled) return;
518
+ if (result.done) {
519
+ state.complete = true;
520
+ return;
521
+ }
522
+ if ("file" in result.value) {
523
+ zipFile.addReadStream(
524
+ createNodeFileReadStream(result.value.file),
525
+ result.value.name,
526
+ { compress: false }
527
+ );
528
+ } else if ("data" in result.value) {
529
+ zipFile.addBuffer(Buffer.from(result.value.data), result.value.name, {
530
+ compress: false
531
+ });
532
+ } else {
533
+ zipFile.addReadStream(
534
+ createNodeRangeReadStream(result.value),
535
+ result.value.name,
536
+ { compress: false, size: result.value.size }
537
+ );
538
+ }
539
+ }
540
+ }
541
+ function createNodeFileReadStream(file) {
542
+ return import_node_stream.Readable.from(
543
+ (async function* () {
544
+ const reader = await file.openReader();
545
+ try {
546
+ for (let offset = 0; offset < reader.size; ) {
547
+ const chunk = await reader.read(
548
+ offset,
549
+ Math.min(64 * 1024, reader.size - offset)
550
+ );
551
+ offset += chunk.byteLength;
552
+ yield chunk;
553
+ }
554
+ } finally {
555
+ await reader.close();
556
+ }
557
+ })()
558
+ );
559
+ }
560
+ function getBrandedNodeResourcePath(resource, kind) {
561
+ if (typeof resource !== "object" || resource === null) return void 0;
562
+ const candidate = resource;
563
+ return candidate[NODE_RESOURCE_KIND] === kind && typeof candidate.path === "string" ? candidate.path : void 0;
564
+ }
565
+ function createNodeRangeReadStream(entry) {
566
+ return import_node_stream.Readable.from(
567
+ (async function* () {
568
+ for (let offset = 0; offset < entry.size; ) {
569
+ const chunk = await entry.read(
570
+ offset,
571
+ Math.min(64 * 1024, entry.size - offset)
572
+ );
573
+ offset += chunk.byteLength;
574
+ yield chunk;
575
+ }
576
+ })()
577
+ );
578
+ }
579
+ function getNodeZipEntryIterator(entries) {
580
+ const asyncIterator = entries[Symbol.asyncIterator];
581
+ return asyncIterator === void 0 ? entries[Symbol.iterator]() : asyncIterator.call(entries);
582
+ }
583
+ function closeNodeZipEntryIterator(iterator) {
584
+ if (iterator.return === void 0) return;
585
+ try {
586
+ void Promise.resolve(iterator.return()).catch(() => void 0);
587
+ } catch {
588
+ }
589
+ }
590
+ async function writeNodeStream(input, writer) {
591
+ await (0, import_promises.pipeline)(
592
+ input,
593
+ new import_node_stream.Writable({
594
+ write: (chunk, _encoding, callback) => {
595
+ void writer.write(chunk).then(
596
+ () => callback(),
597
+ (error) => callback(
598
+ error instanceof Error ? error : new Error("Cannot stream ZIP archive")
599
+ )
600
+ );
601
+ }
602
+ })
603
+ );
604
+ }
605
+ async function collectNodeStream(input) {
606
+ return await new Promise((resolve2, reject) => {
607
+ const chunks = [];
608
+ input.on("data", (chunk) => chunks.push(chunk));
609
+ input.once("error", reject);
610
+ input.once("end", () => resolve2(Buffer.concat(chunks)));
611
+ });
612
+ }
613
+ var nodeWikiGraphPlatform = {
614
+ asyncContext: {
615
+ create: () => new asyncHooks.AsyncLocalStorage()
616
+ },
617
+ database: { open: openNodeDatabase },
618
+ lifecycle: {
619
+ instanceId: `node-process:${nodeProcess.pid}`,
620
+ isInstanceAlive: (instanceId) => {
621
+ const match = /^node-process:(\d+)$/u.exec(instanceId);
622
+ if (match === null) return Promise.resolve(void 0);
623
+ try {
624
+ nodeProcess.kill(Number(match[1]), 0);
625
+ return Promise.resolve(true);
626
+ } catch (error) {
627
+ if (typeof error === "object" && error !== null && "code" in error && error.code === "ESRCH") {
628
+ return Promise.resolve(false);
629
+ }
630
+ return Promise.resolve(true);
631
+ }
632
+ }
633
+ },
634
+ resources: {
635
+ getDirectory: (identity) => {
636
+ const path = decodeNodeResourceIdentity(identity, "directory");
637
+ return Promise.resolve(
638
+ path === void 0 ? void 0 : new NodeDirectory(path)
639
+ );
640
+ },
641
+ getFile: (identity) => {
642
+ const path = decodeNodeResourceIdentity(identity, "file");
643
+ return Promise.resolve(
644
+ path === void 0 ? void 0 : new NodeFile(path)
645
+ );
646
+ },
647
+ resolveLegacyDirectory: (reference) => {
648
+ const path = decodeNodeResourceIdentity(reference, "directory");
649
+ return Promise.resolve(
650
+ path === void 0 ? void 0 : new NodeDirectory(path)
651
+ );
652
+ }
653
+ },
654
+ templates: {
655
+ createEnvironment: (options) => new import_nunjucks.Environment(new NodeTemplateLoader(), options)
656
+ },
657
+ zip: {
658
+ open: openNodeZip,
659
+ write: writeNodeZip
660
+ }
661
+ };
662
+ var NodeTemplateLoader = class extends import_nunjucks.Loader {
663
+ #dataDirectory;
664
+ constructor(dataDirectory) {
665
+ super();
666
+ this.#dataDirectory = dataDirectory;
667
+ }
668
+ getSource(templateName) {
669
+ const name = (0, import_platform.normalizeTemplateName)(templateName);
670
+ const filePath = pathModule.join(
671
+ this.#dataDirectory ?? resolveNodeDataDirectory(),
672
+ name
673
+ );
674
+ return {
675
+ noCache: false,
676
+ path: name,
677
+ src: fs.readFileSync(filePath, "utf8")
678
+ };
679
+ }
680
+ };
681
+ function resolveNodeDataDirectory() {
682
+ const injected = globalThis.__WIKIGRAPH_DATA_DIR__;
683
+ if (typeof injected === "string" && injected !== "") return injected;
684
+ let directory = nodeProcess.cwd();
685
+ while (true) {
686
+ for (const candidate of [
687
+ pathModule.join(directory, "data"),
688
+ pathModule.join(directory, "packages", "core", "data")
689
+ ]) {
690
+ try {
691
+ if (fs.statSync(candidate).isDirectory()) return candidate;
692
+ } catch {
693
+ }
694
+ }
695
+ const parent = pathModule.dirname(directory);
696
+ if (parent === directory)
697
+ throw new Error("Could not locate data directory");
698
+ directory = parent;
699
+ }
700
+ }
701
+ function createNodeWikiGraphStorage(stateRoot = pathModule.join(os.homedir(), ".wikigraph")) {
702
+ return {
703
+ library: new NodeDirectory(stateRoot),
704
+ documentStore: new NodeDirectory(pathModule.join(stateRoot, "documents"))
705
+ };
706
+ }
707
+ function installNodeWikiGraphPlatform(stateRoot) {
708
+ (0, import_platform.installWikiGraphPlatform)(nodeWikiGraphPlatform);
709
+ (0, import_platform.installWikiGraphStorage)(createNodeWikiGraphStorage(stateRoot));
710
+ }
711
+ async function withNodeWikiGraphStorage(stateRoot, operation) {
712
+ return await (0, import_platform.withWikiGraphStorage)(
713
+ stateRoot === void 0 ? void 0 : createNodeWikiGraphStorage(stateRoot),
714
+ operation
715
+ );
716
+ }
717
+
718
+ // src/gc.ts
719
+ async function tryRunWikiGraphGc(options = {}) {
720
+ installNodeWikiGraphPlatform();
721
+ const { stateDir, ...coreOptions } = options;
722
+ return await withNodeWikiGraphStorage(
723
+ stateDir,
724
+ async () => await (0, import_gc.tryRunWikiGraphGc)(coreOptions)
725
+ );
726
+ }
727
+ // Annotate the CommonJS export names for ESM import in node:
728
+ 0 && (module.exports = {
729
+ tryRunWikiGraphGc
730
+ });
731
+ //# sourceMappingURL=gc.cjs.map