wiki-graph-core 0.3.1

package/dist/utils/async-semaphore.js

@@ -0,0 +1,40 @@
+class AsyncSemaphore {
+  #activeCount = 0;
+  #concurrency;
+  #pendingResolvers = [];
+  constructor(concurrency) {
+    if (!Number.isInteger(concurrency) || concurrency < 1) {
+      throw new RangeError("concurrency must be a positive integer");
+    }
+    this.#concurrency = concurrency;
+  }
+  async use(operation) {
+    await this.#acquire();
+    try {
+      return await operation();
+    } finally {
+      this.#release();
+    }
+  }
+  async #acquire() {
+    if (this.#activeCount < this.#concurrency) {
+      this.#activeCount += 1;
+      return;
+    }
+    await new Promise((resolve) => {
+      this.#pendingResolvers.push(() => {
+        this.#activeCount += 1;
+        resolve();
+      });
+    });
+  }
+  #release() {
+    this.#activeCount -= 1;
+    const next = this.#pendingResolvers.shift();
+    next?.();
+  }
+}
+export {
+  AsyncSemaphore
+};
+//# sourceMappingURL=async-semaphore.js.map

package/dist/utils/async-semaphore.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/utils/async-semaphore.ts"],"sourcesContent":["export class AsyncSemaphore {\n  #activeCount = 0;\n  readonly #concurrency: number;\n  readonly #pendingResolvers: Array<() => void> = [];\n\n  public constructor(concurrency: number) {\n    if (!Number.isInteger(concurrency) || concurrency < 1) {\n      throw new RangeError(\"concurrency must be a positive integer\");\n    }\n\n    this.#concurrency = concurrency;\n  }\n\n  public async use<T>(operation: () => Promise<T> | T): Promise<T> {\n    await this.#acquire();\n\n    try {\n      return await operation();\n    } finally {\n      this.#release();\n    }\n  }\n\n  async #acquire(): Promise<void> {\n    if (this.#activeCount < this.#concurrency) {\n      this.#activeCount += 1;\n      return;\n    }\n\n    await new Promise<void>((resolve) => {\n      this.#pendingResolvers.push(() => {\n        this.#activeCount += 1;\n        resolve();\n      });\n    });\n  }\n\n  #release(): void {\n    this.#activeCount -= 1;\n\n    const next = this.#pendingResolvers.shift();\n    next?.();\n  }\n}\n"],"mappings":"AAAO,MAAM,eAAe;AAAA,EAC1B,eAAe;AAAA,EACN;AAAA,EACA,oBAAuC,CAAC;AAAA,EAE1C,YAAY,aAAqB;AACtC,QAAI,CAAC,OAAO,UAAU,WAAW,KAAK,cAAc,GAAG;AACrD,YAAM,IAAI,WAAW,wCAAwC;AAAA,IAC/D;AAEA,SAAK,eAAe;AAAA,EACtB;AAAA,EAEA,MAAa,IAAO,WAA6C;AAC/D,UAAM,KAAK,SAAS;AAEpB,QAAI;AACF,aAAO,MAAM,UAAU;AAAA,IACzB,UAAE;AACA,WAAK,SAAS;AAAA,IAChB;AAAA,EACF;AAAA,EAEA,MAAM,WAA0B;AAC9B,QAAI,KAAK,eAAe,KAAK,cAAc;AACzC,WAAK,gBAAgB;AACrB;AAAA,IACF;AAEA,UAAM,IAAI,QAAc,CAAC,YAAY;AACnC,WAAK,kBAAkB,KAAK,MAAM;AAChC,aAAK,gBAAgB;AACrB,gBAAQ;AAAA,MACV,CAAC;AAAA,IACH,CAAC;AAAA,EACH;AAAA,EAEA,WAAiB;AACf,SAAK,gBAAgB;AAErB,UAAM,OAAO,KAAK,kBAAkB,MAAM;AAC1C,WAAO;AAAA,EACT;AACF;","names":[]}

package/dist/utils/enum.d.ts

@@ -0,0 +1,5 @@
+type EnumLike = Record<string, string>;
+declare function createEnumValueGuard<TEnum extends EnumLike>(enumType: TEnum): (value: string) => value is TEnum[keyof TEnum];
+declare function createEnumValueAsserter<TEnum extends EnumLike>(enumType: TEnum, label: string): (value: string) => TEnum[keyof TEnum];
+
+export { createEnumValueAsserter, createEnumValueGuard };

package/dist/utils/enum.js

@@ -0,0 +1,18 @@
+function createEnumValueGuard(enumType) {
+  const valueSet = new Set(Object.values(enumType));
+  return (value) => valueSet.has(value);
+}
+function createEnumValueAsserter(enumType, label) {
+  const isEnumValue = createEnumValueGuard(enumType);
+  return (value) => {
+    if (isEnumValue(value)) {
+      return value;
+    }
+    throw new Error(`Unknown ${label}: ${value}`);
+  };
+}
+export {
+  createEnumValueAsserter,
+  createEnumValueGuard
+};
+//# sourceMappingURL=enum.js.map

package/dist/utils/enum.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/utils/enum.ts"],"sourcesContent":["type EnumLike = Record<string, string>;\n\nexport function createEnumValueGuard<TEnum extends EnumLike>(enumType: TEnum) {\n  const valueSet = new Set<string>(Object.values(enumType));\n\n  return (value: string): value is TEnum[keyof TEnum] => valueSet.has(value);\n}\n\nexport function createEnumValueAsserter<TEnum extends EnumLike>(\n  enumType: TEnum,\n  label: string,\n) {\n  const isEnumValue = createEnumValueGuard(enumType);\n\n  return (value: string): TEnum[keyof TEnum] => {\n    if (isEnumValue(value)) {\n      return value;\n    }\n\n    throw new Error(`Unknown ${label}: ${value}`);\n  };\n}\n"],"mappings":"AAEO,SAAS,qBAA6C,UAAiB;AAC5E,QAAM,WAAW,IAAI,IAAY,OAAO,OAAO,QAAQ,CAAC;AAExD,SAAO,CAAC,UAA+C,SAAS,IAAI,KAAK;AAC3E;AAEO,SAAS,wBACd,UACA,OACA;AACA,QAAM,cAAc,qBAAqB,QAAQ;AAEjD,SAAO,CAAC,UAAsC;AAC5C,QAAI,YAAY,KAAK,GAAG;AACtB,aAAO;AAAA,IACT;AAEA,UAAM,IAAI,MAAM,WAAW,KAAK,KAAK,KAAK,EAAE;AAAA,EAC9C;AACF;","names":[]}

package/dist/utils/hash.d.ts

@@ -0,0 +1,3 @@
+declare function createHash(value: unknown): string;
+
+export { createHash };

package/dist/utils/hash.js

@@ -0,0 +1,132 @@
+import { createHash as createNodeHash } from "crypto";
+const UNSERIALIZABLE = /* @__PURE__ */ Symbol("UNSERIALIZABLE");
+function createHash(value) {
+  return new HashComputation().run(value);
+}
+class HashComputation {
+  #activeObjects = /* @__PURE__ */ new Set();
+  #hash = createNodeHash("sha512");
+  #resolvingObjects = /* @__PURE__ */ new Set();
+  run(value) {
+    const hasSerializedValue = this.#writeValue(value, "");
+    if (!hasSerializedValue) {
+      throw new TypeError("Hash input must be JSON-serializable");
+    }
+    return this.#hash.digest("hex");
+  }
+  #writeValue(value, key) {
+    const resolvedValue = this.#resolveValue(value, key);
+    if (resolvedValue === UNSERIALIZABLE) {
+      return false;
+    }
+    this.#writeResolvedValue(resolvedValue);
+    return true;
+  }
+  #writeResolvedValue(value) {
+    if (value === null) {
+      this.#hash.update("null", "utf8");
+      return;
+    }
+    if (typeof value === "string") {
+      this.#hash.update(JSON.stringify(value), "utf8");
+      return;
+    }
+    if (typeof value === "number") {
+      this.#hash.update(
+        Number.isFinite(value) ? String(value) : "null",
+        "utf8"
+      );
+      return;
+    }
+    if (typeof value === "boolean") {
+      this.#hash.update(value ? "true" : "false", "utf8");
+      return;
+    }
+    if (this.#activeObjects.has(value)) {
+      throw new TypeError("Hash input must be JSON-serializable");
+    }
+    this.#activeObjects.add(value);
+    try {
+      if (Array.isArray(value)) {
+        this.#writeArray(value);
+        return;
+      }
+      this.#writeObject(value);
+    } finally {
+      this.#activeObjects.delete(value);
+    }
+  }
+  #writeArray(values) {
+    this.#hash.update("[", "utf8");
+    for (const [index, value] of values.entries()) {
+      if (index > 0) {
+        this.#hash.update(",", "utf8");
+      }
+      const resolvedValue = this.#resolveValue(value, String(index));
+      if (resolvedValue === UNSERIALIZABLE) {
+        this.#hash.update("null", "utf8");
+        continue;
+      }
+      this.#writeResolvedValue(resolvedValue);
+    }
+    this.#hash.update("]", "utf8");
+  }
+  #writeObject(value) {
+    this.#hash.update("{", "utf8");
+    let hasWrittenProperty = false;
+    for (const key of Object.keys(value)) {
+      const propertyValue = value[key];
+      const resolvedValue = this.#resolveValue(propertyValue, key);
+      if (resolvedValue === UNSERIALIZABLE) {
+        continue;
+      }
+      if (hasWrittenProperty) {
+        this.#hash.update(",", "utf8");
+      }
+      this.#hash.update(JSON.stringify(key), "utf8");
+      this.#hash.update(":", "utf8");
+      this.#writeResolvedValue(resolvedValue);
+      hasWrittenProperty = true;
+    }
+    this.#hash.update("}", "utf8");
+  }
+  #resolveValue(value, key) {
+    if (value === null) {
+      return null;
+    }
+    if (typeof value === "string" || typeof value === "boolean") {
+      return value;
+    }
+    if (typeof value === "number") {
+      return Number.isFinite(value) ? value : null;
+    }
+    if (value === void 0 || typeof value === "function" || typeof value === "symbol") {
+      return UNSERIALIZABLE;
+    }
+    if (typeof value === "bigint") {
+      throw new TypeError("Hash input must be JSON-serializable");
+    }
+    if (value instanceof String || value instanceof Number || value instanceof Boolean) {
+      return this.#resolveValue(value.valueOf(), key);
+    }
+    if (!hasToJson(value)) {
+      return value;
+    }
+    if (this.#resolvingObjects.has(value)) {
+      throw new TypeError("Hash input must be JSON-serializable");
+    }
+    this.#resolvingObjects.add(value);
+    try {
+      return this.#resolveValue(value.toJSON(key), key);
+    } finally {
+      this.#resolvingObjects.delete(value);
+    }
+  }
+}
+function hasToJson(value) {
+  return "toJSON" in value && typeof value.toJSON === "function";
+}
+export {
+  createHash
+};
+//# sourceMappingURL=hash.js.map

package/dist/utils/hash.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/utils/hash.ts"],"sourcesContent":["import { createHash as createNodeHash } from \"crypto\";\n\nconst UNSERIALIZABLE = Symbol(\"UNSERIALIZABLE\");\n\ntype ResolvedHashValue = boolean | number | object | string | null;\n\nexport function createHash(value: unknown): string {\n  return new HashComputation().run(value);\n}\n\nclass HashComputation {\n  readonly #activeObjects = new Set<object>();\n  readonly #hash = createNodeHash(\"sha512\");\n  readonly #resolvingObjects = new Set<object>();\n\n  public run(value: unknown): string {\n    const hasSerializedValue = this.#writeValue(value, \"\");\n\n    if (!hasSerializedValue) {\n      throw new TypeError(\"Hash input must be JSON-serializable\");\n    }\n\n    return this.#hash.digest(\"hex\");\n  }\n\n  #writeValue(value: unknown, key: string): boolean {\n    const resolvedValue = this.#resolveValue(value, key);\n\n    if (resolvedValue === UNSERIALIZABLE) {\n      return false;\n    }\n\n    this.#writeResolvedValue(resolvedValue);\n    return true;\n  }\n\n  #writeResolvedValue(value: ResolvedHashValue): void {\n    if (value === null) {\n      this.#hash.update(\"null\", \"utf8\");\n      return;\n    }\n\n    if (typeof value === \"string\") {\n      this.#hash.update(JSON.stringify(value), \"utf8\");\n      return;\n    }\n\n    if (typeof value === \"number\") {\n      this.#hash.update(\n        Number.isFinite(value) ? String(value) : \"null\",\n        \"utf8\",\n      );\n      return;\n    }\n\n    if (typeof value === \"boolean\") {\n      this.#hash.update(value ? \"true\" : \"false\", \"utf8\");\n      return;\n    }\n\n    if (this.#activeObjects.has(value)) {\n      throw new TypeError(\"Hash input must be JSON-serializable\");\n    }\n\n    this.#activeObjects.add(value);\n\n    try {\n      if (Array.isArray(value)) {\n        this.#writeArray(value);\n        return;\n      }\n\n      this.#writeObject(value);\n    } finally {\n      this.#activeObjects.delete(value);\n    }\n  }\n\n  #writeArray(values: readonly unknown[]): void {\n    this.#hash.update(\"[\", \"utf8\");\n\n    for (const [index, value] of values.entries()) {\n      if (index > 0) {\n        this.#hash.update(\",\", \"utf8\");\n      }\n\n      const resolvedValue = this.#resolveValue(value, String(index));\n\n      if (resolvedValue === UNSERIALIZABLE) {\n        this.#hash.update(\"null\", \"utf8\");\n        continue;\n      }\n\n      this.#writeResolvedValue(resolvedValue);\n    }\n\n    this.#hash.update(\"]\", \"utf8\");\n  }\n\n  #writeObject(value: object): void {\n    this.#hash.update(\"{\", \"utf8\");\n\n    let hasWrittenProperty = false;\n\n    for (const key of Object.keys(value)) {\n      const propertyValue = (value as Record<string, unknown>)[key];\n      const resolvedValue = this.#resolveValue(propertyValue, key);\n\n      if (resolvedValue === UNSERIALIZABLE) {\n        continue;\n      }\n\n      if (hasWrittenProperty) {\n        this.#hash.update(\",\", \"utf8\");\n      }\n\n      this.#hash.update(JSON.stringify(key), \"utf8\");\n      this.#hash.update(\":\", \"utf8\");\n      this.#writeResolvedValue(resolvedValue);\n      hasWrittenProperty = true;\n    }\n\n    this.#hash.update(\"}\", \"utf8\");\n  }\n\n  #resolveValue(\n    value: unknown,\n    key: string,\n  ): ResolvedHashValue | typeof UNSERIALIZABLE {\n    if (value === null) {\n      return null;\n    }\n\n    if (typeof value === \"string\" || typeof value === \"boolean\") {\n      return value;\n    }\n\n    if (typeof value === \"number\") {\n      return Number.isFinite(value) ? value : null;\n    }\n\n    if (\n      value === undefined ||\n      typeof value === \"function\" ||\n      typeof value === \"symbol\"\n    ) {\n      return UNSERIALIZABLE;\n    }\n\n    if (typeof value === \"bigint\") {\n      throw new TypeError(\"Hash input must be JSON-serializable\");\n    }\n\n    if (\n      value instanceof String ||\n      value instanceof Number ||\n      value instanceof Boolean\n    ) {\n      return this.#resolveValue(value.valueOf(), key);\n    }\n\n    if (!hasToJson(value)) {\n      return value;\n    }\n\n    if (this.#resolvingObjects.has(value)) {\n      throw new TypeError(\"Hash input must be JSON-serializable\");\n    }\n\n    this.#resolvingObjects.add(value);\n\n    try {\n      return this.#resolveValue(value.toJSON(key), key);\n    } finally {\n      this.#resolvingObjects.delete(value);\n    }\n  }\n}\n\nfunction hasToJson(\n  value: object,\n): value is object & { toJSON(key: string): unknown } {\n  return \"toJSON\" in value && typeof value.toJSON === \"function\";\n}\n"],"mappings":"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","names":[]}

package/dist/utils/node-error.d.ts

@@ -0,0 +1,4 @@
+declare function isNodeError(error: unknown): error is NodeJS.ErrnoException;
+declare function formatError(error: unknown): string;
+
+export { formatError, isNodeError };

package/dist/utils/node-error.js

@@ -0,0 +1,59 @@
+function isNodeError(error) {
+  return error instanceof Error;
+}
+function formatError(error) {
+  const messages = [];
+  const visited = /* @__PURE__ */ new Set();
+  let current = error;
+  while (current !== void 0 && !visited.has(current)) {
+    visited.add(current);
+    if (current instanceof Error) {
+      pushErrorMessage(messages, describeError(current));
+      current = current.cause;
+      continue;
+    }
+    pushErrorMessage(messages, String(current));
+    break;
+  }
+  return messages.join(": ");
+}
+function describeError(error) {
+  const errnoError = error;
+  const message = error.message.trim();
+  const code = typeof errnoError.code === "string" && errnoError.code !== "" ? errnoError.code : void 0;
+  const path = typeof errnoError.path === "string" && errnoError.path !== "" ? errnoError.path : void 0;
+  if (code === "ENOENT") {
+    return path === void 0 ? "File not found (ENOENT)" : `File not found: ${path} (ENOENT)`;
+  }
+  if (code === "EACCES" || code === "EPERM") {
+    return path === void 0 ? `Permission denied (${code})` : `Permission denied: ${path} (${code})`;
+  }
+  if (message === "") {
+    return code === void 0 ? error.name : `${error.name} (${code})`;
+  }
+  return code === void 0 ? message : `${message} (${code})`;
+}
+function pushErrorMessage(messages, message) {
+  const normalizedMessage = message.trim();
+  if (normalizedMessage === "") {
+    return;
+  }
+  const lastMessage = messages.at(-1);
+  if (lastMessage === void 0) {
+    messages.push(normalizedMessage);
+    return;
+  }
+  if (lastMessage === normalizedMessage || lastMessage.includes(normalizedMessage)) {
+    return;
+  }
+  if (normalizedMessage.includes(lastMessage)) {
+    messages[messages.length - 1] = normalizedMessage;
+    return;
+  }
+  messages.push(normalizedMessage);
+}
+export {
+  formatError,
+  isNodeError
+};
+//# sourceMappingURL=node-error.js.map

package/dist/utils/node-error.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/utils/node-error.ts"],"sourcesContent":["export function isNodeError(error: unknown): error is NodeJS.ErrnoException {\n  return error instanceof Error;\n}\n\nexport function formatError(error: unknown): string {\n  const messages: string[] = [];\n  const visited = new Set<unknown>();\n  let current: unknown = error;\n\n  while (current !== undefined && !visited.has(current)) {\n    visited.add(current);\n\n    if (current instanceof Error) {\n      pushErrorMessage(messages, describeError(current));\n      current = current.cause;\n      continue;\n    }\n\n    pushErrorMessage(messages, String(current as unknown));\n    break;\n  }\n\n  return messages.join(\": \");\n}\n\nfunction describeError(error: Error): string {\n  const errnoError = error as NodeJS.ErrnoException;\n  const message = error.message.trim();\n  const code =\n    typeof errnoError.code === \"string\" && errnoError.code !== \"\"\n      ? errnoError.code\n      : undefined;\n  const path =\n    typeof errnoError.path === \"string\" && errnoError.path !== \"\"\n      ? errnoError.path\n      : undefined;\n\n  if (code === \"ENOENT\") {\n    return path === undefined\n      ? \"File not found (ENOENT)\"\n      : `File not found: ${path} (ENOENT)`;\n  }\n\n  if (code === \"EACCES\" || code === \"EPERM\") {\n    return path === undefined\n      ? `Permission denied (${code})`\n      : `Permission denied: ${path} (${code})`;\n  }\n\n  if (message === \"\") {\n    return code === undefined ? error.name : `${error.name} (${code})`;\n  }\n\n  return code === undefined ? message : `${message} (${code})`;\n}\n\nfunction pushErrorMessage(messages: string[], message: string): void {\n  const normalizedMessage = message.trim();\n\n  if (normalizedMessage === \"\") {\n    return;\n  }\n\n  const lastMessage = messages.at(-1);\n\n  if (lastMessage === undefined) {\n    messages.push(normalizedMessage);\n    return;\n  }\n\n  if (\n    lastMessage === normalizedMessage ||\n    lastMessage.includes(normalizedMessage)\n  ) {\n    return;\n  }\n\n  if (normalizedMessage.includes(lastMessage)) {\n    messages[messages.length - 1] = normalizedMessage;\n    return;\n  }\n\n  messages.push(normalizedMessage);\n}\n"],"mappings":"AAAO,SAAS,YAAY,OAAgD;AAC1E,SAAO,iBAAiB;AAC1B;AAEO,SAAS,YAAY,OAAwB;AAClD,QAAM,WAAqB,CAAC;AAC5B,QAAM,UAAU,oBAAI,IAAa;AACjC,MAAI,UAAmB;AAEvB,SAAO,YAAY,UAAa,CAAC,QAAQ,IAAI,OAAO,GAAG;AACrD,YAAQ,IAAI,OAAO;AAEnB,QAAI,mBAAmB,OAAO;AAC5B,uBAAiB,UAAU,cAAc,OAAO,CAAC;AACjD,gBAAU,QAAQ;AAClB;AAAA,IACF;AAEA,qBAAiB,UAAU,OAAO,OAAkB,CAAC;AACrD;AAAA,EACF;AAEA,SAAO,SAAS,KAAK,IAAI;AAC3B;AAEA,SAAS,cAAc,OAAsB;AAC3C,QAAM,aAAa;AACnB,QAAM,UAAU,MAAM,QAAQ,KAAK;AACnC,QAAM,OACJ,OAAO,WAAW,SAAS,YAAY,WAAW,SAAS,KACvD,WAAW,OACX;AACN,QAAM,OACJ,OAAO,WAAW,SAAS,YAAY,WAAW,SAAS,KACvD,WAAW,OACX;AAEN,MAAI,SAAS,UAAU;AACrB,WAAO,SAAS,SACZ,4BACA,mBAAmB,IAAI;AAAA,EAC7B;AAEA,MAAI,SAAS,YAAY,SAAS,SAAS;AACzC,WAAO,SAAS,SACZ,sBAAsB,IAAI,MAC1B,sBAAsB,IAAI,KAAK,IAAI;AAAA,EACzC;AAEA,MAAI,YAAY,IAAI;AAClB,WAAO,SAAS,SAAY,MAAM,OAAO,GAAG,MAAM,IAAI,KAAK,IAAI;AAAA,EACjE;AAEA,SAAO,SAAS,SAAY,UAAU,GAAG,OAAO,KAAK,IAAI;AAC3D;AAEA,SAAS,iBAAiB,UAAoB,SAAuB;AACnE,QAAM,oBAAoB,QAAQ,KAAK;AAEvC,MAAI,sBAAsB,IAAI;AAC5B;AAAA,EACF;AAEA,QAAM,cAAc,SAAS,GAAG,EAAE;AAElC,MAAI,gBAAgB,QAAW;AAC7B,aAAS,KAAK,iBAAiB;AAC/B;AAAA,EACF;AAEA,MACE,gBAAgB,qBAChB,YAAY,SAAS,iBAAiB,GACtC;AACA;AAAA,EACF;AAEA,MAAI,kBAAkB,SAAS,WAAW,GAAG;AAC3C,aAAS,SAAS,SAAS,CAAC,IAAI;AAChC;AAAA,EACF;AAEA,WAAS,KAAK,iBAAiB;AACjC;","names":[]}

package/dist/wikg/archive-uri.d.ts

@@ -0,0 +1 @@
+export { LocatedWikiGraphUri, WIKI_GRAPH_ARCHIVE_EXTENSION, WIKI_GRAPH_JOB_URI_PREFIX, WIKI_GRAPH_URI_PREFIX, formatLocatedChapterResourceUri, formatLocatedChapterSourceCollectionUri, formatLocatedChapterUri, formatLocatedWikiGraphUri, formatWikiGraphCommandUri, formatWikiGraphObjectUri, formatWikiGraphUriExpectedError, isWikiGraphJobUri, isWikiGraphUri, parseLocatedWikiGraphUri, requireArchiveUri, requireLocatedObjectOrArchiveUri, requireLocatedObjectUri } from '../common/wiki-graph-uri.js';

package/dist/wikg/archive-uri.js

@@ -0,0 +1,37 @@
+import {
+  formatLocatedChapterResourceUri,
+  formatLocatedChapterSourceCollectionUri,
+  formatLocatedChapterUri,
+  formatLocatedWikiGraphUri,
+  formatWikiGraphCommandUri,
+  formatWikiGraphObjectUri,
+  formatWikiGraphUriExpectedError,
+  isWikiGraphJobUri,
+  isWikiGraphUri,
+  parseLocatedWikiGraphUri,
+  requireArchiveUri,
+  requireLocatedObjectOrArchiveUri,
+  requireLocatedObjectUri,
+  WIKI_GRAPH_ARCHIVE_EXTENSION,
+  WIKI_GRAPH_JOB_URI_PREFIX,
+  WIKI_GRAPH_URI_PREFIX
+} from "../common/wiki-graph-uri.js";
+export {
+  WIKI_GRAPH_ARCHIVE_EXTENSION,
+  WIKI_GRAPH_JOB_URI_PREFIX,
+  WIKI_GRAPH_URI_PREFIX,
+  formatLocatedChapterResourceUri,
+  formatLocatedChapterSourceCollectionUri,
+  formatLocatedChapterUri,
+  formatLocatedWikiGraphUri,
+  formatWikiGraphCommandUri,
+  formatWikiGraphObjectUri,
+  formatWikiGraphUriExpectedError,
+  isWikiGraphJobUri,
+  isWikiGraphUri,
+  parseLocatedWikiGraphUri,
+  requireArchiveUri,
+  requireLocatedObjectOrArchiveUri,
+  requireLocatedObjectUri
+};
+//# sourceMappingURL=archive-uri.js.map

package/dist/wikg/archive-uri.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/wikg/archive-uri.ts"],"sourcesContent":["export {\n  formatLocatedChapterResourceUri,\n  formatLocatedChapterSourceCollectionUri,\n  formatLocatedChapterUri,\n  formatLocatedWikiGraphUri,\n  formatWikiGraphCommandUri,\n  formatWikiGraphObjectUri,\n  formatWikiGraphUriExpectedError,\n  isWikiGraphJobUri,\n  isWikiGraphUri,\n  parseLocatedWikiGraphUri,\n  requireArchiveUri,\n  requireLocatedObjectOrArchiveUri,\n  requireLocatedObjectUri,\n  WIKI_GRAPH_ARCHIVE_EXTENSION,\n  WIKI_GRAPH_JOB_URI_PREFIX,\n  WIKI_GRAPH_URI_PREFIX,\n  type LocatedWikiGraphUri,\n} from \"../common/wiki-graph-uri.js\";\n"],"mappings":"AAAA;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OAEK;","names":[]}

package/dist/wikg/archive.d.ts

@@ -0,0 +1,28 @@
+import { ZipFile, Entry } from 'yauzl';
+
+declare const WIKG_FORMAT_VERSION = 1;
+type WikgArchiveOverlay = {
+    readonly entryPath: string;
+    readonly kind: "deleted";
+} | {
+    readonly entryPath: string;
+    readonly kind: "file";
+    readonly workspacePath: string;
+};
+declare class WikgArchiveReader {
+    #private;
+    constructor(path: string, zipFile: ZipFile, entries: readonly Entry[]);
+    static open(inputPath: string): Promise<WikgArchiveReader>;
+    close(): void;
+    listEntries(): readonly string[];
+    readEntry(entryPath: string): Promise<Buffer | undefined>;
+}
+declare function extractWikgArchive(inputPath: string, outputDirectoryPath: string): Promise<void>;
+declare function writeWikgArchive(documentDirectoryPath: string, outputPath: string): Promise<void>;
+declare function listWikgArchiveEntries(inputPath: string): Promise<readonly string[]>;
+declare function readWikgArchiveEntry(inputPath: string, entryPath: string): Promise<Buffer | undefined>;
+declare function readWikgArchiveMutationToken(inputPath: string): Promise<string>;
+declare function writeWikgArchiveWithOverlays(inputPath: string, outputPath: string, overlays: readonly WikgArchiveOverlay[]): Promise<void>;
+declare function readWikgArchiveFormatVersion(documentDirectoryPath: string): Promise<number>;
+
+export { WIKG_FORMAT_VERSION, type WikgArchiveOverlay, WikgArchiveReader, extractWikgArchive, listWikgArchiveEntries, readWikgArchiveEntry, readWikgArchiveFormatVersion, readWikgArchiveMutationToken, writeWikgArchive, writeWikgArchiveWithOverlays };