wiki-graph-core 0.3.1 → 0.4.0

package/dist/library/query.js

@@ -0,0 +1,422 @@
+import {
+  listArchiveEvidence,
+  listRelatedArchiveObjects,
+  packArchiveContext,
+  readArchivePage
+} from "../retrieval/query/archive-view/index.js";
+import {
+  createCollectionResult,
+  createFindResult
+} from "../retrieval/query/archive-view/helper/results.js";
+import {
+  findWikiGraphLibraryObjectsBucketed,
+  shouldUseLibraryBucketedSearch
+} from "./search-query.js";
+import { hydrateSearchIndexHits } from "../retrieval/query/archive-view/search/hydration.js";
+import {
+  getWikiGraphLibraryArchiveById,
+  listWikiGraphLibraryArchives
+} from "./membership.js";
+import {
+  createLibrarySource,
+  createSortedArchiveIds,
+  isReadableLibraryArchive,
+  readLibraryArchiveDocument,
+  resolveReadableIndexedArchive
+} from "./query-helpers.js";
+import {
+  parseWikiGraphLibraryUri,
+  resolveWikiGraphLibrary,
+  resolveWikiGraphLibraryById
+} from "./registry.js";
+import {
+  assertWikiGraphLibraryIndexReady,
+  listWikiGraphLibraryIndexArchiveIdsForObject,
+  listWikiGraphLibrarySearchIndex,
+  queryWikiGraphLibrarySearchIndex
+} from "./search-index.js";
+const DEFAULT_LIBRARY_PAGE_LIMIT = 20;
+const LIBRARY_QUERY_INDEX_LIMIT_MULTIPLIER = 20;
+const LIBRARY_QUERY_INDEX_MIN_LIMIT = 100;
+async function findWikiGraphLibraryObjects(target, query, options = {}) {
+  if (shouldUseLibraryBucketedSearch(options)) {
+    return await findWikiGraphLibraryObjectsBucketed(target, query, options);
+  }
+  const indexHitLimit = createLibraryQueryIndexHitLimit(options);
+  const result = await queryWikiGraphLibrarySearchIndex(target, query, {
+    objectHitLimit: indexHitLimit,
+    textHitLimit: indexHitLimit
+  });
+  if (result === void 0) {
+    return createFindResult(query, [], options);
+  }
+  const hits = [];
+  for (const archiveId of createSortedArchiveIds(result)) {
+    const archive = await resolveReadableIndexedArchive(target, archiveId, {
+      operation: "searching library objects"
+    });
+    const source = createLibrarySource(archive);
+    const hydrated = await readLibraryArchiveDocument(
+      archive,
+      async (document) => await hydrateSearchIndexHits(document, {
+        objectHits: result.objectHits.filter(
+          (hit) => hit.archiveId === archive.id
+        ),
+        terms: result.terms,
+        textHits: result.textHits.filter(
+          (hit) => hit.archiveId === archive.id
+        )
+      })
+    );
+    hits.push(...hydrated.map((hit) => ({ ...hit, ...source })));
+  }
+  return createFindResult(query, hits, options, result.terms);
+}
+function createLibraryQueryIndexHitLimit(options) {
+  return Math.max(
+    (options.limit ?? DEFAULT_LIBRARY_PAGE_LIMIT) * LIBRARY_QUERY_INDEX_LIMIT_MULTIPLIER,
+    LIBRARY_QUERY_INDEX_MIN_LIMIT
+  );
+}
+async function listWikiGraphLibraryObjects(target, options = {}) {
+  const hits = [];
+  const result = await listWikiGraphLibrarySearchIndex(target, {
+    includeText: shouldListTextStreams(options)
+  });
+  const archiveIds = createSortedArchiveIds(result);
+  for (const archiveId of archiveIds) {
+    const archive = await resolveReadableIndexedArchive(target, archiveId, {
+      operation: "listing library objects"
+    });
+    const source = createLibrarySource(archive);
+    const hydrated = await readLibraryArchiveDocument(
+      archive,
+      async (document) => await hydrateSearchIndexHits(document, {
+        objectHits: result.objectHits.filter(
+          (hit) => hit.archiveId === archive.id
+        ),
+        terms: result.terms,
+        textHits: result.textHits.filter(
+          (hit) => hit.archiveId === archive.id
+        )
+      })
+    );
+    hits.push(...hydrated.map((hit) => ({ ...hit, ...source })));
+  }
+  return createCollectionResult(hits, options);
+}
+async function readWikiGraphLibraryPage(target, objectUri, options = {}) {
+  const pages = await readIndexedArchiveResults(
+    target,
+    objectUri,
+    async (document, archive) => ({
+      ...await readArchivePage(document, objectUri, options),
+      ...createLibrarySource(archive)
+    })
+  );
+  const page = createMultiArchivePage(pages);
+  if ((page.type === "entity" || page.type === "triple") && pages.length > 1) {
+    return {
+      ...page,
+      evidence: combinePageEvidencePreviews(
+        pages,
+        options.evidenceLimit ?? 3,
+        options.order ?? "doc-asc"
+      )
+    };
+  }
+  return page;
+}
+async function listWikiGraphLibraryEvidence(target, objectUri, options = {}) {
+  const limit = options.limit ?? DEFAULT_LIBRARY_PAGE_LIMIT;
+  const offset = parseLibraryObjectCursor(options.cursor, "evidence");
+  const archiveWindowLimit = offset + limit;
+  const results = await readIndexedArchiveResults(
+    target,
+    objectUri,
+    async (document, archive) => {
+      const { cursor: _cursor, ...archiveOptions } = options;
+      const result = await listArchiveEvidence(document, objectUri, {
+        ...archiveOptions,
+        limit: archiveWindowLimit
+      });
+      const source = createLibrarySource(archive);
+      return {
+        ...result,
+        items: result.items.map(
+          (item) => ({
+            ...item,
+            ...source
+          })
+        )
+      };
+    }
+  );
+  return createEvidenceResult(
+    results.flatMap((result) => result.items),
+    options
+  );
+}
+async function listRelatedWikiGraphLibraryObjects(target, objectUri, options = {}) {
+  const limit = options.limit ?? DEFAULT_LIBRARY_PAGE_LIMIT;
+  const offset = parseLibraryObjectCursor(options.cursor, "related");
+  const archiveWindowLimit = offset + limit;
+  const results = await readIndexedArchiveResults(
+    target,
+    objectUri,
+    async (document, archive) => {
+      const { cursor: _cursor, ...archiveOptions } = options;
+      const result = await listRelatedArchiveObjects(document, objectUri, {
+        ...archiveOptions,
+        limit: archiveWindowLimit
+      });
+      const source = createLibrarySource(archive);
+      return {
+        ...result,
+        items: result.items.map(
+          (item) => ({
+            ...item,
+            ...source
+          })
+        )
+      };
+    }
+  );
+  return createRelatedResult(
+    results.flatMap((result) => result.items),
+    options
+  );
+}
+async function packWikiGraphLibraryContext(target, objectUri, budget) {
+  const packs = await readIndexedArchiveResults(
+    target,
+    objectUri,
+    async (document, archive) => {
+      const pack = await packArchiveContext(document, objectUri, budget);
+      const source = createLibrarySource(archive);
+      return {
+        ...pack,
+        anchor: { ...pack.anchor, ...source },
+        related: pack.related.map((item) => ({ ...item, ...source }))
+      };
+    }
+  );
+  const [first] = packs;
+  if (first === void 0) {
+    throw new Error(`Wiki Graph library object was not found: ${objectUri}`);
+  }
+  return {
+    anchor: createMultiArchivePage(packs.map((pack) => pack.anchor)),
+    budget,
+    related: packs.flatMap((pack) => pack.related)
+  };
+}
+async function resolveWikiGraphLibraryQueryTargetById(libraryId) {
+  const library = await resolveWikiGraphLibraryById(libraryId);
+  return parseWikiGraphLibraryUri(library.uri) ?? {
+    isDefault: library.isDefault,
+    kind: "scope",
+    publicId: library.publicId
+  };
+}
+async function readIndexedArchiveResults(target, objectUri, operation) {
+  const library = await resolveWikiGraphLibrary(target);
+  const archiveIds = await listWikiGraphLibraryIndexArchiveIdsForObject(
+    target,
+    objectUri
+  );
+  if (archiveIds.length === 0) {
+    if (!isTripleObjectUri(objectUri)) {
+      throw new Error(`Wiki Graph library object was not found: ${objectUri}`);
+    }
+    return await readUnindexedArchiveResults(target, objectUri, operation);
+  }
+  const results = [];
+  for (const archiveId of archiveIds) {
+    const archive = await getWikiGraphLibraryArchiveById(library, archiveId);
+    if (!isReadableLibraryArchive(archive)) {
+      throw new Error(
+        `Wiki Graph library archive ${archiveId} is not readable while reading ${objectUri}.`
+      );
+    }
+    try {
+      results.push(
+        await readLibraryArchiveDocument(
+          archive,
+          async (document) => await operation(document, archive)
+        )
+      );
+    } catch (error) {
+      throw new Error(
+        `Failed to read Wiki Graph library archive ${archiveId} (${archive.uri}) for ${objectUri}: ${formatErrorMessage(error)}`,
+        { cause: error }
+      );
+    }
+  }
+  if (results.length === 0) {
+    throw new Error(`Wiki Graph library object was not found: ${objectUri}`);
+  }
+  return results;
+}
+async function readUnindexedArchiveResults(target, objectUri, operation) {
+  const results = [];
+  for (const archive of await listReadyLibraryArchives(target)) {
+    try {
+      results.push(
+        await readLibraryArchiveDocument(
+          archive,
+          async (document) => await operation(document, archive)
+        )
+      );
+    } catch (error) {
+      if (isArchiveObjectNotFoundError(error)) {
+        continue;
+      }
+      throw new Error(
+        `Failed to read Wiki Graph library archive ${archive.id} (${archive.uri}) for ${objectUri}: ${formatErrorMessage(error)}`,
+        { cause: error }
+      );
+    }
+  }
+  if (results.length === 0) {
+    throw new Error(`Wiki Graph library object was not found: ${objectUri}`);
+  }
+  return results;
+}
+function createMultiArchivePage(pages) {
+  const [first] = pages;
+  if (first === void 0) {
+    throw new Error(
+      "Internal error: cannot merge an empty library page result."
+    );
+  }
+  const sources = createLibrarySources(pages);
+  if (sources.length === 1) {
+    return first;
+  }
+  const {
+    archiveId: _archiveId,
+    libraryArchiveUri: _libraryArchiveUri,
+    ...page
+  } = first;
+  return { ...page, sources };
+}
+function combinePageEvidencePreviews(pages, limit, order) {
+  const evidencePages = pages.flatMap(
+    (page) => page.type === "entity" || page.type === "triple" ? [page] : []
+  );
+  const orderedPages = order === "doc-desc" ? evidencePages.slice().reverse() : evidencePages;
+  const sources = orderedPages.flatMap(
+    (page) => page.evidence.sources.map((source) => ({
+      ...source,
+      ...page.archiveId === void 0 ? {} : { archiveId: page.archiveId },
+      ...page.libraryArchiveUri === void 0 ? {} : { libraryArchiveUri: page.libraryArchiveUri }
+    }))
+  );
+  const total = evidencePages.reduce(
+    (sum, page) => sum + page.evidence.total,
+    0
+  );
+  const pageSources = sources.slice(0, limit);
+  const shown = pageSources.length;
+  return {
+    nextCursor: limit < total ? String(limit) : null,
+    shown,
+    sources: pageSources,
+    total
+  };
+}
+function createEvidenceResult(items, options) {
+  const limit = options.limit ?? DEFAULT_LIBRARY_PAGE_LIMIT;
+  const offset = parseLibraryObjectCursor(options.cursor, "evidence");
+  const sorted = [...items].sort(
+    (left, right) => compareLibraryEvidenceItems(left, right, options.order ?? "doc-asc")
+  );
+  const pageItems = sorted.slice(offset, offset + limit);
+  const nextOffset = offset + pageItems.length;
+  return {
+    items: pageItems,
+    limit,
+    nextCursor: nextOffset < sorted.length ? String(nextOffset) : null
+  };
+}
+function createRelatedResult(items, options) {
+  const limit = options.limit ?? DEFAULT_LIBRARY_PAGE_LIMIT;
+  const offset = parseLibraryObjectCursor(options.cursor, "related");
+  const sorted = [...items].sort(
+    (left, right) => compareLibraryListItems(left, right, options.order ?? "doc-asc")
+  );
+  const pageItems = sorted.slice(offset, offset + limit);
+  const nextOffset = offset + pageItems.length;
+  return {
+    items: pageItems,
+    limit,
+    nextCursor: nextOffset < sorted.length ? String(nextOffset) : null
+  };
+}
+function createLibrarySources(values) {
+  const sources = /* @__PURE__ */ new Map();
+  for (const value of values) {
+    if (value.archiveId === void 0 || value.libraryArchiveUri === void 0) {
+      continue;
+    }
+    sources.set(value.archiveId, {
+      archiveId: value.archiveId,
+      libraryArchiveUri: value.libraryArchiveUri
+    });
+  }
+  return [...sources.values()].sort(
+    (left, right) => left.archiveId - right.archiveId
+  );
+}
+function compareLibraryEvidenceItems(left, right, order) {
+  const direction = order === "doc-asc" ? 1 : -1;
+  return (compareOptionalNumbers(left.archiveId, right.archiveId) || left.chapterId - right.chapterId || left.startSentenceIndex - right.startSentenceIndex || left.endSentenceIndex - right.endSentenceIndex || left.id.localeCompare(right.id)) * direction;
+}
+function compareLibraryListItems(left, right, order) {
+  const direction = order === "doc-asc" ? 1 : -1;
+  return (compareOptionalNumbers(left.archiveId, right.archiveId) || left.id.localeCompare(right.id)) * direction;
+}
+function compareOptionalNumbers(left, right) {
+  return (left ?? Number.MAX_SAFE_INTEGER) - (right ?? Number.MAX_SAFE_INTEGER);
+}
+function parseLibraryObjectCursor(cursor, kind) {
+  if (cursor === void 0) {
+    return 0;
+  }
+  if (!/^(0|[1-9][0-9]*)$/u.test(cursor)) {
+    throw new Error(`Invalid library ${kind} cursor: ${cursor}`);
+  }
+  return Number(cursor);
+}
+async function listReadyLibraryArchives(target) {
+  await assertWikiGraphLibraryIndexReady(target);
+  return (await listWikiGraphLibraryArchives(target)).filter(
+    isReadableLibraryArchive
+  );
+}
+function shouldListTextStreams(options) {
+  return options.types !== void 0 && options.types.some((type) => type === "source" || type === "summary");
+}
+function formatErrorMessage(error) {
+  return error instanceof Error ? error.message : String(error);
+}
+function isArchiveObjectNotFoundError(error) {
+  return error instanceof Error && error.message.includes(" was not found in this archive.");
+}
+function isTripleObjectUri(objectUri) {
+  return /^wikg:\/\/(?:chapter\/[1-9][0-9]*\/)?triple\/Q[1-9][0-9]*\/[^/]+\/Q[1-9][0-9]*\/?$/u.test(
+    objectUri
+  );
+}
+export {
+  createLibrarySources,
+  findWikiGraphLibraryObjects,
+  listRelatedWikiGraphLibraryObjects,
+  listWikiGraphLibraryEvidence,
+  listWikiGraphLibraryObjects,
+  packWikiGraphLibraryContext,
+  readWikiGraphLibraryPage,
+  resolveWikiGraphLibraryQueryTargetById
+};
+//# sourceMappingURL=query.js.map

package/dist/library/query.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/library/query.ts"],"sourcesContent":["import type { ReadonlyDocument } from \"../document/index.js\";\nimport {\n  listArchiveEvidence,\n  listRelatedArchiveObjects,\n  packArchiveContext,\n  readArchivePage,\n} from \"../retrieval/query/archive-view/index.js\";\nimport {\n  createCollectionResult,\n  createFindResult,\n} from \"../retrieval/query/archive-view/helper/results.js\";\nimport {\n  findWikiGraphLibraryObjectsBucketed,\n  shouldUseLibraryBucketedSearch,\n} from \"./search-query.js\";\nimport { hydrateSearchIndexHits } from \"../retrieval/query/archive-view/search/hydration.js\";\nimport type {\n  ArchiveCollectionOptions,\n  ArchiveCollectionResult,\n  ArchiveEvidence,\n  ArchiveEvidenceItem,\n  ArchiveEvidenceOptions,\n  ArchiveFindEvidencePreview,\n  ArchiveFindHit,\n  ArchiveFindOptions,\n  ArchiveFindOrder,\n  ArchiveFindResult,\n  ArchiveLibrarySource,\n  ArchiveListItem,\n  ArchivePack,\n  ArchivePage,\n  ArchiveRelatedOptions,\n  ArchiveRelatedResult,\n} from \"../retrieval/query/archive-view/types.js\";\nimport {\n  getWikiGraphLibraryArchiveById,\n  listWikiGraphLibraryArchives,\n  type WikiGraphLibraryArchiveRecord,\n} from \"./membership.js\";\nimport {\n  createLibrarySource,\n  createSortedArchiveIds,\n  isReadableLibraryArchive,\n  readLibraryArchiveDocument,\n  resolveReadableIndexedArchive,\n} from \"./query-helpers.js\";\nimport {\n  parseWikiGraphLibraryUri,\n  resolveWikiGraphLibrary,\n  resolveWikiGraphLibraryById,\n  type ParsedWikiGraphLibraryUri,\n} from \"./registry.js\";\nimport {\n  assertWikiGraphLibraryIndexReady,\n  listWikiGraphLibraryIndexArchiveIdsForObject,\n  listWikiGraphLibrarySearchIndex,\n  queryWikiGraphLibrarySearchIndex,\n} from \"./search-index.js\";\n\nconst DEFAULT_LIBRARY_PAGE_LIMIT = 20;\nconst LIBRARY_QUERY_INDEX_LIMIT_MULTIPLIER = 20;\nconst LIBRARY_QUERY_INDEX_MIN_LIMIT = 100;\n\nexport async function findWikiGraphLibraryObjects(\n  target: ParsedWikiGraphLibraryUri,\n  query: string,\n  options: ArchiveFindOptions = {},\n): Promise<ArchiveFindResult> {\n  if (shouldUseLibraryBucketedSearch(options)) {\n    return await findWikiGraphLibraryObjectsBucketed(target, query, options);\n  }\n\n  const indexHitLimit = createLibraryQueryIndexHitLimit(options);\n  const result = await queryWikiGraphLibrarySearchIndex(target, query, {\n    objectHitLimit: indexHitLimit,\n    textHitLimit: indexHitLimit,\n  });\n\n  if (result === undefined) {\n    return createFindResult(query, [], options);\n  }\n\n  const hits: ArchiveFindHit[] = [];\n  for (const archiveId of createSortedArchiveIds(result)) {\n    const archive = await resolveReadableIndexedArchive(target, archiveId, {\n      operation: \"searching library objects\",\n    });\n    const source = createLibrarySource(archive);\n    const hydrated = await readLibraryArchiveDocument(\n      archive,\n      async (document) =>\n        await hydrateSearchIndexHits(document, {\n          objectHits: result.objectHits.filter(\n            (hit) => hit.archiveId === archive.id,\n          ),\n          terms: result.terms,\n          textHits: result.textHits.filter(\n            (hit) => hit.archiveId === archive.id,\n          ),\n        }),\n    );\n\n    hits.push(...hydrated.map((hit) => ({ ...hit, ...source })));\n  }\n\n  return createFindResult(query, hits, options, result.terms);\n}\n\nfunction createLibraryQueryIndexHitLimit(options: ArchiveFindOptions): number {\n  return Math.max(\n    (options.limit ?? DEFAULT_LIBRARY_PAGE_LIMIT) *\n      LIBRARY_QUERY_INDEX_LIMIT_MULTIPLIER,\n    LIBRARY_QUERY_INDEX_MIN_LIMIT,\n  );\n}\n\nexport async function listWikiGraphLibraryObjects(\n  target: ParsedWikiGraphLibraryUri,\n  options: ArchiveCollectionOptions = {},\n): Promise<ArchiveCollectionResult> {\n  const hits: ArchiveFindHit[] = [];\n  const result = await listWikiGraphLibrarySearchIndex(target, {\n    includeText: shouldListTextStreams(options),\n  });\n  const archiveIds = createSortedArchiveIds(result);\n  for (const archiveId of archiveIds) {\n    const archive = await resolveReadableIndexedArchive(target, archiveId, {\n      operation: \"listing library objects\",\n    });\n    const source = createLibrarySource(archive);\n    const hydrated = await readLibraryArchiveDocument(\n      archive,\n      async (document) =>\n        await hydrateSearchIndexHits(document, {\n          objectHits: result.objectHits.filter(\n            (hit) => hit.archiveId === archive.id,\n          ),\n          terms: result.terms,\n          textHits: result.textHits.filter(\n            (hit) => hit.archiveId === archive.id,\n          ),\n        }),\n    );\n\n    hits.push(...hydrated.map((hit) => ({ ...hit, ...source })));\n  }\n\n  return createCollectionResult(hits, options);\n}\n\nexport async function readWikiGraphLibraryPage(\n  target: ParsedWikiGraphLibraryUri,\n  objectUri: string,\n  options: Parameters<typeof readArchivePage>[2] = {},\n): Promise<ArchivePage> {\n  const pages = await readIndexedArchiveResults(\n    target,\n    objectUri,\n    async (document, archive) => ({\n      ...(await readArchivePage(document, objectUri, options)),\n      ...createLibrarySource(archive),\n    }),\n  );\n\n  const page = createMultiArchivePage(pages);\n  if ((page.type === \"entity\" || page.type === \"triple\") && pages.length > 1) {\n    return {\n      ...page,\n      evidence: combinePageEvidencePreviews(\n        pages,\n        options.evidenceLimit ?? 3,\n        options.order ?? \"doc-asc\",\n      ),\n    };\n  }\n\n  return page;\n}\n\nexport async function listWikiGraphLibraryEvidence(\n  target: ParsedWikiGraphLibraryUri,\n  objectUri: string,\n  options: ArchiveEvidenceOptions = {},\n): Promise<ArchiveEvidence> {\n  const limit = options.limit ?? DEFAULT_LIBRARY_PAGE_LIMIT;\n  const offset = parseLibraryObjectCursor(options.cursor, \"evidence\");\n  const archiveWindowLimit = offset + limit;\n  const results = await readIndexedArchiveResults(\n    target,\n    objectUri,\n    async (document, archive) => {\n      const { cursor: _cursor, ...archiveOptions } = options;\n      const result = await listArchiveEvidence(document, objectUri, {\n        ...archiveOptions,\n        limit: archiveWindowLimit,\n      });\n      const source = createLibrarySource(archive);\n\n      return {\n        ...result,\n        items: result.items.map(\n          (item): ArchiveEvidenceItem => ({\n            ...item,\n            ...source,\n          }),\n        ),\n      };\n    },\n  );\n\n  return createEvidenceResult(\n    results.flatMap((result) => result.items),\n    options,\n  );\n}\n\nexport async function listRelatedWikiGraphLibraryObjects(\n  target: ParsedWikiGraphLibraryUri,\n  objectUri: string,\n  options: ArchiveRelatedOptions = {},\n): Promise<ArchiveRelatedResult> {\n  const limit = options.limit ?? DEFAULT_LIBRARY_PAGE_LIMIT;\n  const offset = parseLibraryObjectCursor(options.cursor, \"related\");\n  const archiveWindowLimit = offset + limit;\n  const results = await readIndexedArchiveResults(\n    target,\n    objectUri,\n    async (document, archive) => {\n      const { cursor: _cursor, ...archiveOptions } = options;\n      const result = await listRelatedArchiveObjects(document, objectUri, {\n        ...archiveOptions,\n        limit: archiveWindowLimit,\n      });\n      const source = createLibrarySource(archive);\n\n      return {\n        ...result,\n        items: result.items.map(\n          (item): ArchiveListItem => ({\n            ...item,\n            ...source,\n          }),\n        ),\n      };\n    },\n  );\n\n  return createRelatedResult(\n    results.flatMap((result) => result.items),\n    options,\n  );\n}\n\nexport async function packWikiGraphLibraryContext(\n  target: ParsedWikiGraphLibraryUri,\n  objectUri: string,\n  budget: number,\n): Promise<ArchivePack> {\n  const packs = await readIndexedArchiveResults(\n    target,\n    objectUri,\n    async (document, archive) => {\n      const pack = await packArchiveContext(document, objectUri, budget);\n      const source = createLibrarySource(archive);\n\n      return {\n        ...pack,\n        anchor: { ...pack.anchor, ...source },\n        related: pack.related.map((item) => ({ ...item, ...source })),\n      };\n    },\n  );\n  const [first] = packs;\n\n  if (first === undefined) {\n    throw new Error(`Wiki Graph library object was not found: ${objectUri}`);\n  }\n\n  return {\n    anchor: createMultiArchivePage(packs.map((pack) => pack.anchor)),\n    budget,\n    related: packs.flatMap((pack) => pack.related),\n  };\n}\n\nexport async function resolveWikiGraphLibraryQueryTargetById(\n  libraryId: number,\n): Promise<ParsedWikiGraphLibraryUri> {\n  const library = await resolveWikiGraphLibraryById(libraryId);\n  return (\n    parseWikiGraphLibraryUri(library.uri) ?? {\n      isDefault: library.isDefault,\n      kind: \"scope\",\n      publicId: library.publicId,\n    }\n  );\n}\n\nasync function readIndexedArchiveResults<T>(\n  target: ParsedWikiGraphLibraryUri,\n  objectUri: string,\n  operation: (\n    document: ReadonlyDocument,\n    archive: WikiGraphLibraryArchiveRecord,\n  ) => Promise<T>,\n): Promise<T[]> {\n  const library = await resolveWikiGraphLibrary(target);\n  const archiveIds = await listWikiGraphLibraryIndexArchiveIdsForObject(\n    target,\n    objectUri,\n  );\n\n  if (archiveIds.length === 0) {\n    if (!isTripleObjectUri(objectUri)) {\n      throw new Error(`Wiki Graph library object was not found: ${objectUri}`);\n    }\n\n    // Library v1 cannot project every triple occurrence into the index yet.\n    // Keep the archive scan explicit and restricted to triples so entity/chunk\n    // lookups remain index-backed and do not silently regress to full scans.\n    return await readUnindexedArchiveResults(target, objectUri, operation);\n  }\n\n  const results: T[] = [];\n  for (const archiveId of archiveIds) {\n    const archive = await getWikiGraphLibraryArchiveById(library, archiveId);\n    if (!isReadableLibraryArchive(archive)) {\n      throw new Error(\n        `Wiki Graph library archive ${archiveId} is not readable while reading ${objectUri}.`,\n      );\n    }\n\n    try {\n      results.push(\n        await readLibraryArchiveDocument(\n          archive,\n          async (document) => await operation(document, archive),\n        ),\n      );\n    } catch (error) {\n      throw new Error(\n        `Failed to read Wiki Graph library archive ${archiveId} (${archive.uri}) for ${objectUri}: ${formatErrorMessage(error)}`,\n        { cause: error },\n      );\n    }\n  }\n\n  if (results.length === 0) {\n    throw new Error(`Wiki Graph library object was not found: ${objectUri}`);\n  }\n  return results;\n}\n\nasync function readUnindexedArchiveResults<T>(\n  target: ParsedWikiGraphLibraryUri,\n  objectUri: string,\n  operation: (\n    document: ReadonlyDocument,\n    archive: WikiGraphLibraryArchiveRecord,\n  ) => Promise<T>,\n): Promise<T[]> {\n  const results: T[] = [];\n\n  for (const archive of await listReadyLibraryArchives(target)) {\n    try {\n      results.push(\n        await readLibraryArchiveDocument(\n          archive,\n          async (document) => await operation(document, archive),\n        ),\n      );\n    } catch (error) {\n      if (isArchiveObjectNotFoundError(error)) {\n        continue;\n      }\n      throw new Error(\n        `Failed to read Wiki Graph library archive ${archive.id} (${archive.uri}) for ${objectUri}: ${formatErrorMessage(error)}`,\n        { cause: error },\n      );\n    }\n  }\n\n  if (results.length === 0) {\n    throw new Error(`Wiki Graph library object was not found: ${objectUri}`);\n  }\n  return results;\n}\n\nfunction createMultiArchivePage(pages: readonly ArchivePage[]): ArchivePage {\n  const [first] = pages;\n  if (first === undefined) {\n    throw new Error(\n      \"Internal error: cannot merge an empty library page result.\",\n    );\n  }\n\n  const sources = createLibrarySources(pages);\n  if (sources.length === 1) {\n    return first;\n  }\n\n  const {\n    archiveId: _archiveId,\n    libraryArchiveUri: _libraryArchiveUri,\n    ...page\n  } = first;\n\n  return { ...page, sources };\n}\n\nfunction combinePageEvidencePreviews(\n  pages: readonly ArchivePage[],\n  limit: number,\n  order: ArchiveFindOrder,\n): ArchiveFindEvidencePreview {\n  const evidencePages = pages.flatMap((page) =>\n    page.type === \"entity\" || page.type === \"triple\" ? [page] : [],\n  );\n  const orderedPages =\n    order === \"doc-desc\" ? evidencePages.slice().reverse() : evidencePages;\n  const sources = orderedPages.flatMap((page) =>\n    page.evidence.sources.map((source) => ({\n      ...source,\n      ...(page.archiveId === undefined ? {} : { archiveId: page.archiveId }),\n      ...(page.libraryArchiveUri === undefined\n        ? {}\n        : { libraryArchiveUri: page.libraryArchiveUri }),\n    })),\n  );\n  const total = evidencePages.reduce(\n    (sum, page) => sum + page.evidence.total,\n    0,\n  );\n  const pageSources = sources.slice(0, limit);\n  const shown = pageSources.length;\n\n  return {\n    nextCursor: limit < total ? String(limit) : null,\n    shown,\n    sources: pageSources,\n    total,\n  };\n}\n\nfunction createEvidenceResult(\n  items: readonly ArchiveEvidenceItem[],\n  options: ArchiveEvidenceOptions,\n): ArchiveEvidence {\n  const limit = options.limit ?? DEFAULT_LIBRARY_PAGE_LIMIT;\n  const offset = parseLibraryObjectCursor(options.cursor, \"evidence\");\n  const sorted = [...items].sort((left, right) =>\n    compareLibraryEvidenceItems(left, right, options.order ?? \"doc-asc\"),\n  );\n  const pageItems = sorted.slice(offset, offset + limit);\n  const nextOffset = offset + pageItems.length;\n\n  return {\n    items: pageItems,\n    limit,\n    nextCursor: nextOffset < sorted.length ? String(nextOffset) : null,\n  };\n}\n\nfunction createRelatedResult(\n  items: readonly ArchiveListItem[],\n  options: ArchiveRelatedOptions,\n): ArchiveRelatedResult {\n  const limit = options.limit ?? DEFAULT_LIBRARY_PAGE_LIMIT;\n  const offset = parseLibraryObjectCursor(options.cursor, \"related\");\n  const sorted = [...items].sort((left, right) =>\n    compareLibraryListItems(left, right, options.order ?? \"doc-asc\"),\n  );\n  const pageItems = sorted.slice(offset, offset + limit);\n  const nextOffset = offset + pageItems.length;\n\n  return {\n    items: pageItems,\n    limit,\n    nextCursor: nextOffset < sorted.length ? String(nextOffset) : null,\n  };\n}\n\nexport function createLibrarySources(\n  values: readonly {\n    readonly archiveId?: number;\n    readonly libraryArchiveUri?: string;\n  }[],\n): readonly ArchiveLibrarySource[] {\n  const sources = new Map<number, ArchiveLibrarySource>();\n  for (const value of values) {\n    if (\n      value.archiveId === undefined ||\n      value.libraryArchiveUri === undefined\n    ) {\n      continue;\n    }\n    sources.set(value.archiveId, {\n      archiveId: value.archiveId,\n      libraryArchiveUri: value.libraryArchiveUri,\n    });\n  }\n  return [...sources.values()].sort(\n    (left, right) => left.archiveId - right.archiveId,\n  );\n}\n\nfunction compareLibraryEvidenceItems(\n  left: ArchiveEvidenceItem,\n  right: ArchiveEvidenceItem,\n  order: \"doc-asc\" | \"doc-desc\",\n): number {\n  const direction = order === \"doc-asc\" ? 1 : -1;\n  return (\n    (compareOptionalNumbers(left.archiveId, right.archiveId) ||\n      left.chapterId - right.chapterId ||\n      left.startSentenceIndex - right.startSentenceIndex ||\n      left.endSentenceIndex - right.endSentenceIndex ||\n      left.id.localeCompare(right.id)) * direction\n  );\n}\n\nfunction compareLibraryListItems(\n  left: ArchiveListItem,\n  right: ArchiveListItem,\n  order: \"doc-asc\" | \"doc-desc\",\n): number {\n  const direction = order === \"doc-asc\" ? 1 : -1;\n  return (\n    (compareOptionalNumbers(left.archiveId, right.archiveId) ||\n      left.id.localeCompare(right.id)) * direction\n  );\n}\n\nfunction compareOptionalNumbers(\n  left: number | undefined,\n  right: number | undefined,\n): number {\n  return (left ?? Number.MAX_SAFE_INTEGER) - (right ?? Number.MAX_SAFE_INTEGER);\n}\n\nfunction parseLibraryObjectCursor(\n  cursor: string | undefined,\n  kind: \"evidence\" | \"related\",\n): number {\n  if (cursor === undefined) {\n    return 0;\n  }\n  if (!/^(0|[1-9][0-9]*)$/u.test(cursor)) {\n    throw new Error(`Invalid library ${kind} cursor: ${cursor}`);\n  }\n  return Number(cursor);\n}\n\nasync function listReadyLibraryArchives(\n  target: ParsedWikiGraphLibraryUri,\n): Promise<readonly WikiGraphLibraryArchiveRecord[]> {\n  await assertWikiGraphLibraryIndexReady(target);\n  return (await listWikiGraphLibraryArchives(target)).filter(\n    isReadableLibraryArchive,\n  );\n}\n\nfunction shouldListTextStreams(options: ArchiveCollectionOptions): boolean {\n  return (\n    options.types !== undefined &&\n    options.types.some((type) => type === \"source\" || type === \"summary\")\n  );\n}\n\nfunction formatErrorMessage(error: unknown): string {\n  return error instanceof Error ? error.message : String(error);\n}\n\nfunction isArchiveObjectNotFoundError(error: unknown): boolean {\n  return (\n    error instanceof Error &&\n    error.message.includes(\" was not found in this archive.\")\n  );\n}\n\nfunction isTripleObjectUri(objectUri: string): boolean {\n  return /^wikg:\\/\\/(?:chapter\\/[1-9][0-9]*\\/)?triple\\/Q[1-9][0-9]*\\/[^/]+\\/Q[1-9][0-9]*\\/?$/u.test(\n    objectUri,\n  );\n}\n"],"mappings":"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","names":[]}

package/dist/library/registry.d.ts

@@ -0,0 +1,39 @@
+interface WikiGraphLibraryRecord {
+    readonly id: number;
+    readonly publicId: string;
+    readonly uri: string;
+    readonly folderPath: string;
+    readonly isDefault: boolean;
+    readonly stagingPath: string;
+    readonly createdAt: string;
+    readonly updatedAt: string;
+}
+interface ParsedWikiGraphLibraryUri {
+    readonly archivePublicId?: string;
+    readonly kind: "archive" | "archive-collection" | "archive-path" | "archive-tree" | "metadata" | "path" | "registry" | "scope";
+    readonly objectUri?: string;
+    readonly publicId?: string;
+    readonly isDefault: boolean;
+}
+declare function isWikiGraphLibraryUri(uri: string | undefined): uri is string;
+declare function parseWikiGraphLibraryUri(uri: string): ParsedWikiGraphLibraryUri | undefined;
+declare function formatWikiGraphLibraryUri(publicId?: string): string;
+declare function resolveDefaultWikiGraphLibraryDirectoryPath(): string;
+declare function resolveWikiGraphLibraryStagingDirectoryPath(id: number): string;
+declare function ensureDefaultWikiGraphLibrary(): Promise<WikiGraphLibraryRecord>;
+declare function createWikiGraphLibrary(input: {
+    readonly folderPath: string;
+}): Promise<WikiGraphLibraryRecord>;
+declare function listWikiGraphLibraries(): Promise<readonly WikiGraphLibraryRecord[]>;
+declare function resolveWikiGraphLibrary(target: ParsedWikiGraphLibraryUri): Promise<WikiGraphLibraryRecord>;
+declare function resolveWikiGraphLibraryById(id: number): Promise<WikiGraphLibraryRecord>;
+declare function listWikiGraphLibraryScope(target: ParsedWikiGraphLibraryUri): Promise<readonly []>;
+declare function removeWikiGraphLibrary(target: ParsedWikiGraphLibraryUri): Promise<WikiGraphLibraryRecord>;
+declare function updateWikiGraphLibraryFolderPathForRebind(library: WikiGraphLibraryRecord, inputFolderPath: string): Promise<WikiGraphLibraryRecord>;
+declare function getWikiGraphLibraryMetadata(target: ParsedWikiGraphLibraryUri): Promise<Readonly<Record<string, unknown>>>;
+declare function replaceWikiGraphLibraryMetadata(target: ParsedWikiGraphLibraryUri, map: Readonly<Record<string, unknown>>): Promise<Readonly<Record<string, unknown>>>;
+declare function putWikiGraphLibraryMetadata(target: ParsedWikiGraphLibraryUri, key: string, value: unknown): Promise<Readonly<Record<string, unknown>>>;
+declare function deleteWikiGraphLibraryMetadataKey(target: ParsedWikiGraphLibraryUri, key: string): Promise<Readonly<Record<string, unknown>>>;
+declare function clearWikiGraphLibraryMetadata(target: ParsedWikiGraphLibraryUri): Promise<Readonly<Record<string, unknown>>>;
+
+export { type ParsedWikiGraphLibraryUri, type WikiGraphLibraryRecord, clearWikiGraphLibraryMetadata, createWikiGraphLibrary, deleteWikiGraphLibraryMetadataKey, ensureDefaultWikiGraphLibrary, formatWikiGraphLibraryUri, getWikiGraphLibraryMetadata, isWikiGraphLibraryUri, listWikiGraphLibraries, listWikiGraphLibraryScope, parseWikiGraphLibraryUri, putWikiGraphLibraryMetadata, removeWikiGraphLibrary, replaceWikiGraphLibraryMetadata, resolveDefaultWikiGraphLibraryDirectoryPath, resolveWikiGraphLibrary, resolveWikiGraphLibraryById, resolveWikiGraphLibraryStagingDirectoryPath, updateWikiGraphLibraryFolderPathForRebind };