wiki-graph-core 0.3.1 → 0.4.1

package/dist/library/search-query.js

@@ -0,0 +1,418 @@
+import {
+  BROAD_FIND_LENS_HINT,
+  DEFAULT_FIND_LIMIT
+} from "../retrieval/query/archive-view/helper/constants.js";
+import { createFindResult } from "../retrieval/query/archive-view/helper/results.js";
+import { createLexicalQuery } from "../retrieval/query/lexical-search.js";
+import {
+  compareChapterTitleIndexHits,
+  compareTextIndexHits,
+  getObjectBucketCursorId,
+  isAfterChapterTitleKey,
+  isAfterTextKey
+} from "../retrieval/query/archive-view/search/bucket-order.js";
+import {
+  hydrateCachedChunkBucketHit,
+  hydrateCachedObjectBucketHit
+} from "../retrieval/query/archive-view/search/bucket-hydration.js";
+import { hydrateSearchIndexHits } from "../retrieval/query/archive-view/search/hydration.js";
+import { tryDecodeBucketSearchSessionCursor } from "../retrieval/query/archive-view/search/buckets.js";
+import {
+  createSearchSession,
+  encodeBucketSearchSessionCursor,
+  populateSearchSessionObjectCaches,
+  readSearchSessionChunkBucketPage,
+  readSearchSessionDescriptor,
+  readSearchSessionMetadataForCursor,
+  readSearchSessionObjectBucketPage
+} from "../retrieval/query/search-cache/index.js";
+import {
+  SEARCH_INDEX_FTS_HIT_LIMIT,
+  SEARCH_OBJECT_PROPERTY_OWNER_KIND
+} from "../retrieval/search-index/index.js";
+import {
+  assertWikiGraphLibraryIndexReady,
+  queryWikiGraphLibrarySearchIndex
+} from "./search-index.js";
+import {
+  createLibrarySource,
+  createSortedArchiveIds,
+  readLibraryArchiveDocument,
+  resolveReadableIndexedArchive
+} from "./query-helpers.js";
+function shouldUseLibraryBucketedSearch(options) {
+  return options.triplePattern === void 0;
+}
+async function findWikiGraphLibraryObjectsBucketed(target, query, options) {
+  const limit = options.limit ?? DEFAULT_FIND_LIMIT;
+  const search = createLexicalQuery(query);
+  if (search === void 0) {
+    return createFindResult(query, [], options);
+  }
+  if (options.cursor !== void 0) {
+    const cursor = tryDecodeBucketSearchSessionCursor(options.cursor);
+    if (cursor === void 0) {
+      throw new Error("Invalid search cursor.");
+    }
+    return await readLibraryBucketedSearchResultPage(target, cursor, {
+      ...options,
+      limit
+    });
+  }
+  const state = await assertWikiGraphLibraryIndexReady(target);
+  const archiveKey = createLibrarySearchArchiveKey(target);
+  const types = options.types ?? null;
+  const sessionId = await createSearchSession({
+    archiveKey,
+    chapters: options.chapters ?? null,
+    lens: options.types === void 0 ? "broad" : "typed",
+    match: options.match ?? "any",
+    order: options.order ?? "doc-asc",
+    query,
+    revisionScope: state.sourceFingerprint,
+    terms: search.terms,
+    types
+  });
+  const descriptor = await readSearchSessionDescriptor(sessionId, archiveKey);
+  return await readLibraryBucketedSearchResultPage(
+    target,
+    {
+      createdAt: descriptor.createdAt,
+      cursor: { bucket: 0 },
+      sessionId
+    },
+    { ...options, limit }
+  );
+}
+async function readLibraryBucketedSearchResultPage(target, cursor, options) {
+  const archiveKey = createLibrarySearchArchiveKey(target);
+  const session = await readSearchSessionMetadataForCursor(
+    cursor.sessionId,
+    archiveKey,
+    cursor.createdAt
+  );
+  assertLibrarySearchCursorTypesMatch(options.types, session.types);
+  const items = [];
+  let bucketCursor = cursor.cursor;
+  while (bucketCursor !== void 0 && items.length < options.limit) {
+    const remaining = options.limit - items.length;
+    const page = await readLibraryBucketPage(
+      target,
+      session,
+      bucketCursor,
+      remaining
+    );
+    items.push(...page.items);
+    bucketCursor = page.nextCursor;
+  }
+  return {
+    chapters: session.chapters,
+    items,
+    lens: session.types === null ? "broad" : "typed",
+    lensHint: session.types === null ? BROAD_FIND_LENS_HINT : null,
+    limit: options.limit,
+    match: session.match,
+    nextCursor: bucketCursor === void 0 ? null : encodeBucketSearchSessionCursor(
+      cursor.sessionId,
+      bucketCursor,
+      session.createdAt
+    ),
+    order: options.order ?? "doc-asc",
+    query: session.query,
+    terms: session.terms,
+    types: session.types
+  };
+}
+async function readLibraryBucketPage(target, session, cursor, limit) {
+  switch (cursor.bucket) {
+    case 0:
+      return shouldReadLibraryBucket(session, "chapter-title") ? await readLibraryChapterTitleBucketPage(
+        target,
+        session,
+        cursor.key,
+        limit
+      ) : { items: [], nextCursor: { bucket: 1 } };
+    case 1:
+      return shouldReadLibraryBucket(session, "entity", "triple") ? await readLibraryObjectBucketPage(target, session, cursor.key, limit) : { items: [], nextCursor: { bucket: 2 } };
+    case 2:
+      return shouldReadLibraryBucket(session, "node") ? await readLibraryChunkBucketPage(target, session, cursor.key, limit) : { items: [], nextCursor: { bucket: 3 } };
+    case 3:
+      return shouldReadLibraryBucket(session, "source", "summary") ? await readLibraryTextBucketPage(target, session, cursor.key, limit) : { items: [], nextCursor: void 0 };
+  }
+}
+async function readLibraryChapterTitleBucketPage(target, session, after, limit) {
+  const result = await queryWikiGraphLibrarySearchIndex(target, session.query, {
+    ...session.chapters === null ? {} : { chapters: session.chapters },
+    match: session.match,
+    objectHitLimit: SEARCH_INDEX_FTS_HIT_LIMIT,
+    textHitLimit: 0,
+    types: ["chapter-title"]
+  });
+  const hits = [...result?.objectHits ?? []].filter(
+    (hit) => hit.ownerKind === SEARCH_OBJECT_PROPERTY_OWNER_KIND.chapter
+  ).sort(compareChapterTitleIndexHits).filter((hit) => isAfterChapterTitleKey(hit, after));
+  const page = hits.slice(0, limit + 1);
+  const items = await hydrateLibraryIndexHits(target, {
+    objectHits: page.slice(0, limit),
+    terms: session.terms,
+    textHits: []
+  });
+  const last = page.at(limit - 1);
+  return {
+    items,
+    nextCursor: page.length > limit && last !== void 0 ? {
+      bucket: 0,
+      key: {
+        archiveId: last.archiveId,
+        chapterId: Number(last.ownerId),
+        score: last.score
+      }
+    } : { bucket: 1 }
+  };
+}
+async function readLibraryObjectBucketPage(target, session, after, limit) {
+  if (!session.objectCachesPopulated) {
+    const input = await createLibraryObjectBucketCacheInput(target, session);
+    await populateSearchSessionObjectCaches({
+      chunkHits: input.chunkHits,
+      entityHits: input.entityHits,
+      sessionId: session.sessionId
+    });
+  }
+  const page = await readSearchSessionObjectBucketPage(
+    session.sessionId,
+    1,
+    after,
+    limit
+  );
+  const items = page.slice(0, limit).filter((hit) => matchesLibrarySessionTypes(hit, session));
+  const hydrated = await hydrateLibraryCachedHits(
+    target,
+    items,
+    async (document, hit) => await hydrateCachedObjectBucketHit(document, hit)
+  );
+  const last = page.at(Math.min(limit, page.length) - 1);
+  return {
+    items: hydrated,
+    nextCursor: page.length > limit && last !== void 0 ? {
+      bucket: 1,
+      key: {
+        archiveId: getLibraryHitArchiveId(last),
+        id: getObjectBucketCursorId(last),
+        kind: last.type === "triple" ? "triple" : "entity",
+        score: last.score ?? 0
+      }
+    } : { bucket: 2 }
+  };
+}
+async function readLibraryChunkBucketPage(target, session, after, limit) {
+  const page = await readSearchSessionChunkBucketPage(
+    session.sessionId,
+    after,
+    limit
+  );
+  const items = page.slice(0, limit);
+  const hydrated = await hydrateLibraryCachedHits(
+    target,
+    items,
+    async (document, hit) => await hydrateCachedChunkBucketHit(document, hit)
+  );
+  const last = items.at(-1);
+  return {
+    items: hydrated,
+    nextCursor: page.length > limit && last !== void 0 ? {
+      bucket: 2,
+      key: {
+        archiveId: getLibraryHitArchiveId(last),
+        chunkId: Number(last.id.slice("wikg://chunk/".length)),
+        score: last.score ?? 0
+      }
+    } : { bucket: 3 }
+  };
+}
+async function readLibraryTextBucketPage(target, session, after, limit) {
+  const types = createLibraryTextTypes(session);
+  const result = await queryWikiGraphLibrarySearchIndex(target, session.query, {
+    ...session.chapters === null ? {} : { chapters: session.chapters },
+    match: session.match,
+    objectHitLimit: 0,
+    ...after === void 0 ? {} : {
+      textAfter: {
+        archiveId: after.archiveId,
+        chapterId: after.chapterId,
+        kind: after.kind,
+        rank: after.rank,
+        sentenceIndex: after.sentenceIndex
+      }
+    },
+    textHitLimit: createLibraryBucketQueryWindow(limit),
+    types
+  });
+  const hits = [...result?.textHits ?? []].sort(compareTextIndexHits).filter((hit) => isAfterTextKey(hit, after));
+  const page = hits.slice(0, limit + 1);
+  const items = await hydrateLibraryIndexHits(target, {
+    objectHits: [],
+    terms: session.terms,
+    textHits: page.slice(0, limit)
+  });
+  const last = page.at(limit - 1);
+  return {
+    items,
+    nextCursor: page.length > limit && last !== void 0 ? {
+      bucket: 3,
+      key: {
+        archiveId: last.archiveId,
+        chapterId: last.chapterId,
+        kind: last.kind,
+        rank: last.rank,
+        sentenceIndex: last.sentenceIndex
+      }
+    } : void 0
+  };
+}
+function createLibraryBucketQueryWindow(limit) {
+  return Math.max(limit + 1, limit * 3 + 1, 100);
+}
+function assertLibrarySearchCursorTypesMatch(requestedTypes, sessionTypes) {
+  if (requestedTypes === void 0) {
+    return;
+  }
+  if (requestedTypes.length !== (sessionTypes?.length ?? 0)) {
+    throw new Error("Search cursor does not match the requested result types.");
+  }
+  const sessionTypeSet = new Set(sessionTypes ?? []);
+  if (requestedTypes.some((type) => !sessionTypeSet.has(type))) {
+    throw new Error("Search cursor does not match the requested result types.");
+  }
+}
+async function createLibraryObjectBucketCacheInput(target, session) {
+  const result = await queryWikiGraphLibrarySearchIndex(target, session.query, {
+    ...session.chapters === null ? {} : { chapters: session.chapters },
+    match: session.match,
+    objectHitLimit: SEARCH_INDEX_FTS_HIT_LIMIT,
+    textHitLimit: 0,
+    types: null
+  });
+  const entityScores = /* @__PURE__ */ new Map();
+  const chunkScores = /* @__PURE__ */ new Map();
+  for (const hit of result?.objectHits ?? []) {
+    if (hit.ownerKind === SEARCH_OBJECT_PROPERTY_OWNER_KIND.entity) {
+      const key = createLibraryScopedObjectKey(hit.archiveId, hit.ownerId);
+      const scores = entityScores.get(key) ?? [];
+      scores.push(hit.score);
+      entityScores.set(key, scores);
+      continue;
+    }
+    if (hit.ownerKind === SEARCH_OBJECT_PROPERTY_OWNER_KIND.chunk) {
+      const key = createLibraryScopedObjectKey(hit.archiveId, hit.ownerId);
+      const scores = chunkScores.get(key) ?? [];
+      scores.push(hit.score);
+      chunkScores.set(key, scores);
+    }
+  }
+  return {
+    chunkHits: [...chunkScores].map(([key, propertyTopScores]) => {
+      const { archiveId, objectId } = parseLibraryScopedObjectKey(key);
+      return {
+        archiveId,
+        chunkId: Number(objectId),
+        propertyTopScores
+      };
+    }),
+    entityHits: [...entityScores].map(([key, propertyTopScores]) => {
+      const { archiveId, objectId } = parseLibraryScopedObjectKey(key);
+      return {
+        archiveId,
+        propertyTopScores,
+        qid: objectId
+      };
+    })
+  };
+}
+async function hydrateLibraryIndexHits(target, result) {
+  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 hits;
+}
+async function hydrateLibraryCachedHits(target, hits, hydrate) {
+  const hydrated = [];
+  for (const archiveId of [
+    ...new Set(hits.map((hit) => getLibraryHitArchiveId(hit)))
+  ].sort((left, right) => left - right)) {
+    const archive = await resolveReadableIndexedArchive(target, archiveId, {
+      operation: "searching library objects"
+    });
+    const source = createLibrarySource(archive);
+    const archiveHits = hits.filter(
+      (hit) => getLibraryHitArchiveId(hit) === archiveId
+    );
+    await readLibraryArchiveDocument(archive, async (document) => {
+      for (const hit of archiveHits) {
+        const item = await hydrate(document, hit);
+        if (item !== void 0) {
+          hydrated.push({ ...item, ...source });
+        }
+      }
+    });
+  }
+  return hydrated;
+}
+function shouldReadLibraryBucket(session, ...types) {
+  return session.types === null || types.some((type) => session.types?.includes(type));
+}
+function matchesLibrarySessionTypes(hit, session) {
+  return session.types === null || hit.type === "entity" && session.types.includes("entity") || hit.type === "triple" && session.types.includes("triple");
+}
+function createLibraryTextTypes(session) {
+  if (session.types === null) {
+    return ["source", "summary"];
+  }
+  return session.types.filter(
+    (type) => type === "source" || type === "summary"
+  );
+}
+function createLibrarySearchArchiveKey(target) {
+  return target.isDefault ? "library:default" : `library:${target.publicId ?? "unknown"}`;
+}
+function getLibraryHitArchiveId(hit) {
+  if (hit.archiveId === void 0) {
+    throw new Error("Internal error: library search hit is missing archiveId.");
+  }
+  return hit.archiveId;
+}
+function createLibraryScopedObjectKey(archiveId, objectId) {
+  return `${archiveId}:${objectId}`;
+}
+function parseLibraryScopedObjectKey(key) {
+  const separator = key.indexOf(":");
+  if (separator <= 0) {
+    throw new Error(`Invalid library search cache key: ${key}`);
+  }
+  return {
+    archiveId: Number(key.slice(0, separator)),
+    objectId: key.slice(separator + 1)
+  };
+}
+export {
+  findWikiGraphLibraryObjectsBucketed,
+  shouldUseLibraryBucketedSearch
+};
+//# sourceMappingURL=search-query.js.map

package/dist/library/search-query.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/library/search-query.ts"],"sourcesContent":["import type { ReadonlyDocument } from \"../document/index.js\";\nimport {\n  BROAD_FIND_LENS_HINT,\n  DEFAULT_FIND_LIMIT,\n} from \"../retrieval/query/archive-view/helper/constants.js\";\nimport { createFindResult } from \"../retrieval/query/archive-view/helper/results.js\";\nimport { createLexicalQuery } from \"../retrieval/query/lexical-search.js\";\nimport {\n  compareChapterTitleIndexHits,\n  compareTextIndexHits,\n  getObjectBucketCursorId,\n  isAfterChapterTitleKey,\n  isAfterTextKey,\n} from \"../retrieval/query/archive-view/search/bucket-order.js\";\nimport {\n  hydrateCachedChunkBucketHit,\n  hydrateCachedObjectBucketHit,\n} from \"../retrieval/query/archive-view/search/bucket-hydration.js\";\nimport { hydrateSearchIndexHits } from \"../retrieval/query/archive-view/search/hydration.js\";\nimport { tryDecodeBucketSearchSessionCursor } from \"../retrieval/query/archive-view/search/buckets.js\";\nimport {\n  createSearchSession,\n  encodeBucketSearchSessionCursor,\n  populateSearchSessionObjectCaches,\n  readSearchSessionChunkBucketPage,\n  readSearchSessionDescriptor,\n  readSearchSessionMetadataForCursor,\n  readSearchSessionObjectBucketPage,\n  type BucketSearchCursor,\n  type SearchChapterTitleCursorKey,\n  type SearchChunkHitInput,\n  type SearchChunkCursorKey,\n  type SearchEntityHitInput,\n  type SearchObjectCursorKey,\n  type SearchSessionDescriptor,\n  type SearchTextCursorKey,\n} from \"../retrieval/query/search-cache/index.js\";\nimport {\n  SEARCH_INDEX_FTS_HIT_LIMIT,\n  SEARCH_OBJECT_PROPERTY_OWNER_KIND,\n  type SearchIndexObjectHit,\n  type SearchIndexTextHit,\n} from \"../retrieval/search-index/index.js\";\nimport type {\n  ArchiveFindFilterType,\n  ArchiveFindHit,\n  ArchiveFindOptions,\n  ArchiveFindResult,\n} from \"../retrieval/query/archive-view/types.js\";\nimport type { ParsedWikiGraphLibraryUri } from \"./registry.js\";\nimport {\n  assertWikiGraphLibraryIndexReady,\n  queryWikiGraphLibrarySearchIndex,\n} from \"./search-index.js\";\nimport {\n  createLibrarySource,\n  createSortedArchiveIds,\n  readLibraryArchiveDocument,\n  resolveReadableIndexedArchive,\n} from \"./query-helpers.js\";\n\nexport function shouldUseLibraryBucketedSearch(\n  options: ArchiveFindOptions,\n): boolean {\n  return options.triplePattern === undefined;\n}\n\nexport async function findWikiGraphLibraryObjectsBucketed(\n  target: ParsedWikiGraphLibraryUri,\n  query: string,\n  options: ArchiveFindOptions,\n): Promise<ArchiveFindResult> {\n  const limit = options.limit ?? DEFAULT_FIND_LIMIT;\n  const search = createLexicalQuery(query);\n\n  if (search === undefined) {\n    return createFindResult(query, [], options);\n  }\n  if (options.cursor !== undefined) {\n    const cursor = tryDecodeBucketSearchSessionCursor(options.cursor);\n\n    if (cursor === undefined) {\n      throw new Error(\"Invalid search cursor.\");\n    }\n    return await readLibraryBucketedSearchResultPage(target, cursor, {\n      ...options,\n      limit,\n    });\n  }\n\n  const state = await assertWikiGraphLibraryIndexReady(target);\n  const archiveKey = createLibrarySearchArchiveKey(target);\n  const types = options.types ?? null;\n  const sessionId = await createSearchSession({\n    archiveKey,\n    chapters: options.chapters ?? null,\n    lens: options.types === undefined ? \"broad\" : \"typed\",\n    match: options.match ?? \"any\",\n    order: options.order ?? \"doc-asc\",\n    query,\n    revisionScope: state.sourceFingerprint,\n    terms: search.terms,\n    types,\n  });\n  const descriptor = await readSearchSessionDescriptor(sessionId, archiveKey);\n\n  return await readLibraryBucketedSearchResultPage(\n    target,\n    {\n      createdAt: descriptor.createdAt,\n      cursor: { bucket: 0 },\n      sessionId,\n    },\n    { ...options, limit },\n  );\n}\n\nasync function readLibraryBucketedSearchResultPage(\n  target: ParsedWikiGraphLibraryUri,\n  cursor: {\n    readonly createdAt: number;\n    readonly cursor: BucketSearchCursor;\n    readonly sessionId: string;\n  },\n  options: ArchiveFindOptions & { readonly limit: number },\n): Promise<ArchiveFindResult> {\n  const archiveKey = createLibrarySearchArchiveKey(target);\n  const session = await readSearchSessionMetadataForCursor(\n    cursor.sessionId,\n    archiveKey,\n    cursor.createdAt,\n  );\n\n  assertLibrarySearchCursorTypesMatch(options.types, session.types);\n\n  const items: ArchiveFindHit[] = [];\n  let bucketCursor: BucketSearchCursor | undefined = cursor.cursor;\n\n  while (bucketCursor !== undefined && items.length < options.limit) {\n    const remaining = options.limit - items.length;\n    const page = await readLibraryBucketPage(\n      target,\n      session,\n      bucketCursor,\n      remaining,\n    );\n\n    items.push(...page.items);\n    bucketCursor = page.nextCursor;\n  }\n\n  return {\n    chapters: session.chapters,\n    items,\n    lens: session.types === null ? \"broad\" : \"typed\",\n    lensHint: session.types === null ? BROAD_FIND_LENS_HINT : null,\n    limit: options.limit,\n    match: session.match as ArchiveFindResult[\"match\"],\n    nextCursor:\n      bucketCursor === undefined\n        ? null\n        : encodeBucketSearchSessionCursor(\n            cursor.sessionId,\n            bucketCursor,\n            session.createdAt,\n          ),\n    order: options.order ?? \"doc-asc\",\n    query: session.query,\n    terms: session.terms,\n    types: session.types as ArchiveFindResult[\"types\"],\n  };\n}\n\nasync function readLibraryBucketPage(\n  target: ParsedWikiGraphLibraryUri,\n  session: SearchSessionDescriptor,\n  cursor: BucketSearchCursor,\n  limit: number,\n): Promise<{\n  readonly items: readonly ArchiveFindHit[];\n  readonly nextCursor: BucketSearchCursor | undefined;\n}> {\n  switch (cursor.bucket) {\n    case 0:\n      return shouldReadLibraryBucket(session, \"chapter-title\")\n        ? await readLibraryChapterTitleBucketPage(\n            target,\n            session,\n            cursor.key,\n            limit,\n          )\n        : { items: [], nextCursor: { bucket: 1 } };\n    case 1:\n      return shouldReadLibraryBucket(session, \"entity\", \"triple\")\n        ? await readLibraryObjectBucketPage(target, session, cursor.key, limit)\n        : { items: [], nextCursor: { bucket: 2 } };\n    case 2:\n      return shouldReadLibraryBucket(session, \"node\")\n        ? await readLibraryChunkBucketPage(target, session, cursor.key, limit)\n        : { items: [], nextCursor: { bucket: 3 } };\n    case 3:\n      return shouldReadLibraryBucket(session, \"source\", \"summary\")\n        ? await readLibraryTextBucketPage(target, session, cursor.key, limit)\n        : { items: [], nextCursor: undefined };\n  }\n}\n\nasync function readLibraryChapterTitleBucketPage(\n  target: ParsedWikiGraphLibraryUri,\n  session: SearchSessionDescriptor,\n  after: SearchChapterTitleCursorKey | undefined,\n  limit: number,\n): Promise<{\n  readonly items: readonly ArchiveFindHit[];\n  readonly nextCursor: BucketSearchCursor | undefined;\n}> {\n  const result = await queryWikiGraphLibrarySearchIndex(target, session.query, {\n    ...(session.chapters === null ? {} : { chapters: session.chapters }),\n    match: session.match as ArchiveFindResult[\"match\"],\n    objectHitLimit: SEARCH_INDEX_FTS_HIT_LIMIT,\n    textHitLimit: 0,\n    types: [\"chapter-title\"],\n  });\n  const hits = [...(result?.objectHits ?? [])]\n    .filter(\n      (hit) => hit.ownerKind === SEARCH_OBJECT_PROPERTY_OWNER_KIND.chapter,\n    )\n    .sort(compareChapterTitleIndexHits)\n    .filter((hit) => isAfterChapterTitleKey(hit, after));\n  const page = hits.slice(0, limit + 1);\n  const items = await hydrateLibraryIndexHits(target, {\n    objectHits: page.slice(0, limit),\n    terms: session.terms,\n    textHits: [],\n  });\n  const last = page.at(limit - 1);\n\n  return {\n    items,\n    nextCursor:\n      page.length > limit && last !== undefined\n        ? {\n            bucket: 0,\n            key: {\n              archiveId: last.archiveId,\n              chapterId: Number(last.ownerId),\n              score: last.score,\n            },\n          }\n        : { bucket: 1 },\n  };\n}\n\nasync function readLibraryObjectBucketPage(\n  target: ParsedWikiGraphLibraryUri,\n  session: SearchSessionDescriptor,\n  after: SearchObjectCursorKey | undefined,\n  limit: number,\n): Promise<{\n  readonly items: readonly ArchiveFindHit[];\n  readonly nextCursor: BucketSearchCursor | undefined;\n}> {\n  if (!session.objectCachesPopulated) {\n    const input = await createLibraryObjectBucketCacheInput(target, session);\n\n    await populateSearchSessionObjectCaches({\n      chunkHits: input.chunkHits,\n      entityHits: input.entityHits,\n      sessionId: session.sessionId,\n    });\n  }\n  const page = await readSearchSessionObjectBucketPage(\n    session.sessionId,\n    1,\n    after,\n    limit,\n  );\n  const items = page\n    .slice(0, limit)\n    .filter((hit) => matchesLibrarySessionTypes(hit, session));\n  const hydrated = await hydrateLibraryCachedHits(\n    target,\n    items,\n    async (document, hit) => await hydrateCachedObjectBucketHit(document, hit),\n  );\n  const last = page.at(Math.min(limit, page.length) - 1);\n\n  return {\n    items: hydrated,\n    nextCursor:\n      page.length > limit && last !== undefined\n        ? {\n            bucket: 1,\n            key: {\n              archiveId: getLibraryHitArchiveId(last),\n              id: getObjectBucketCursorId(last),\n              kind: last.type === \"triple\" ? \"triple\" : \"entity\",\n              score: last.score ?? 0,\n            },\n          }\n        : { bucket: 2 },\n  };\n}\n\nasync function readLibraryChunkBucketPage(\n  target: ParsedWikiGraphLibraryUri,\n  session: SearchSessionDescriptor,\n  after: SearchChunkCursorKey | undefined,\n  limit: number,\n): Promise<{\n  readonly items: readonly ArchiveFindHit[];\n  readonly nextCursor: BucketSearchCursor | undefined;\n}> {\n  const page = await readSearchSessionChunkBucketPage(\n    session.sessionId,\n    after,\n    limit,\n  );\n  const items = page.slice(0, limit);\n  const hydrated = await hydrateLibraryCachedHits(\n    target,\n    items,\n    async (document, hit) => await hydrateCachedChunkBucketHit(document, hit),\n  );\n  const last = items.at(-1);\n\n  return {\n    items: hydrated,\n    nextCursor:\n      page.length > limit && last !== undefined\n        ? {\n            bucket: 2,\n            key: {\n              archiveId: getLibraryHitArchiveId(last),\n              chunkId: Number(last.id.slice(\"wikg://chunk/\".length)),\n              score: last.score ?? 0,\n            },\n          }\n        : { bucket: 3 },\n  };\n}\n\nasync function readLibraryTextBucketPage(\n  target: ParsedWikiGraphLibraryUri,\n  session: SearchSessionDescriptor,\n  after: SearchTextCursorKey | undefined,\n  limit: number,\n): Promise<{\n  readonly items: readonly ArchiveFindHit[];\n  readonly nextCursor: BucketSearchCursor | undefined;\n}> {\n  const types = createLibraryTextTypes(session);\n  const result = await queryWikiGraphLibrarySearchIndex(target, session.query, {\n    ...(session.chapters === null ? {} : { chapters: session.chapters }),\n    match: session.match as ArchiveFindResult[\"match\"],\n    objectHitLimit: 0,\n    ...(after === undefined\n      ? {}\n      : {\n          textAfter: {\n            archiveId: after.archiveId,\n            chapterId: after.chapterId,\n            kind: after.kind as SearchIndexTextHit[\"kind\"],\n            rank: after.rank,\n            sentenceIndex: after.sentenceIndex,\n          },\n        }),\n    textHitLimit: createLibraryBucketQueryWindow(limit),\n    types,\n  });\n  const hits = [...(result?.textHits ?? [])]\n    .sort(compareTextIndexHits)\n    .filter((hit) => isAfterTextKey(hit, after));\n  const page = hits.slice(0, limit + 1);\n  const items = await hydrateLibraryIndexHits(target, {\n    objectHits: [],\n    terms: session.terms,\n    textHits: page.slice(0, limit),\n  });\n  const last = page.at(limit - 1);\n\n  return {\n    items,\n    nextCursor:\n      page.length > limit && last !== undefined\n        ? {\n            bucket: 3,\n            key: {\n              archiveId: last.archiveId,\n              chapterId: last.chapterId,\n              kind: last.kind,\n              rank: last.rank,\n              sentenceIndex: last.sentenceIndex,\n            },\n          }\n        : undefined,\n  };\n}\n\nfunction createLibraryBucketQueryWindow(limit: number): number {\n  return Math.max(limit + 1, limit * 3 + 1, 100);\n}\n\nfunction assertLibrarySearchCursorTypesMatch(\n  requestedTypes: readonly string[] | undefined,\n  sessionTypes: readonly string[] | null,\n): void {\n  if (requestedTypes === undefined) {\n    return;\n  }\n  if (requestedTypes.length !== (sessionTypes?.length ?? 0)) {\n    throw new Error(\"Search cursor does not match the requested result types.\");\n  }\n  const sessionTypeSet = new Set(sessionTypes ?? []);\n\n  if (requestedTypes.some((type) => !sessionTypeSet.has(type))) {\n    throw new Error(\"Search cursor does not match the requested result types.\");\n  }\n}\n\nasync function createLibraryObjectBucketCacheInput(\n  target: ParsedWikiGraphLibraryUri,\n  session: SearchSessionDescriptor,\n): Promise<{\n  readonly chunkHits: readonly SearchChunkHitInput[];\n  readonly entityHits: readonly SearchEntityHitInput[];\n}> {\n  const result = await queryWikiGraphLibrarySearchIndex(target, session.query, {\n    ...(session.chapters === null ? {} : { chapters: session.chapters }),\n    match: session.match as ArchiveFindResult[\"match\"],\n    objectHitLimit: SEARCH_INDEX_FTS_HIT_LIMIT,\n    textHitLimit: 0,\n    types: null,\n  });\n  const entityScores = new Map<string, number[]>();\n  const chunkScores = new Map<string, number[]>();\n\n  for (const hit of result?.objectHits ?? []) {\n    if (hit.ownerKind === SEARCH_OBJECT_PROPERTY_OWNER_KIND.entity) {\n      const key = createLibraryScopedObjectKey(hit.archiveId, hit.ownerId);\n      const scores = entityScores.get(key) ?? [];\n\n      scores.push(hit.score);\n      entityScores.set(key, scores);\n      continue;\n    }\n    if (hit.ownerKind === SEARCH_OBJECT_PROPERTY_OWNER_KIND.chunk) {\n      const key = createLibraryScopedObjectKey(hit.archiveId, hit.ownerId);\n      const scores = chunkScores.get(key) ?? [];\n\n      scores.push(hit.score);\n      chunkScores.set(key, scores);\n    }\n  }\n\n  return {\n    chunkHits: [...chunkScores].map(([key, propertyTopScores]) => {\n      const { archiveId, objectId } = parseLibraryScopedObjectKey(key);\n\n      return {\n        archiveId,\n        chunkId: Number(objectId),\n        propertyTopScores,\n      };\n    }),\n    entityHits: [...entityScores].map(([key, propertyTopScores]) => {\n      const { archiveId, objectId } = parseLibraryScopedObjectKey(key);\n\n      return {\n        archiveId,\n        propertyTopScores,\n        qid: objectId,\n      };\n    }),\n  };\n}\n\nasync function hydrateLibraryIndexHits(\n  target: ParsedWikiGraphLibraryUri,\n  result: {\n    readonly objectHits: readonly SearchIndexObjectHit[];\n    readonly terms: readonly string[];\n    readonly textHits: readonly SearchIndexTextHit[];\n  },\n): Promise<readonly ArchiveFindHit[]> {\n  const hits: ArchiveFindHit[] = [];\n\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 hits;\n}\n\nasync function hydrateLibraryCachedHits(\n  target: ParsedWikiGraphLibraryUri,\n  hits: readonly ArchiveFindHit[],\n  hydrate: (\n    document: ReadonlyDocument,\n    hit: ArchiveFindHit,\n  ) => Promise<ArchiveFindHit | undefined>,\n): Promise<readonly ArchiveFindHit[]> {\n  const hydrated: ArchiveFindHit[] = [];\n\n  for (const archiveId of [\n    ...new Set(hits.map((hit) => getLibraryHitArchiveId(hit))),\n  ].sort((left, right) => left - right)) {\n    const archive = await resolveReadableIndexedArchive(target, archiveId, {\n      operation: \"searching library objects\",\n    });\n    const source = createLibrarySource(archive);\n    const archiveHits = hits.filter(\n      (hit) => getLibraryHitArchiveId(hit) === archiveId,\n    );\n\n    await readLibraryArchiveDocument(archive, async (document) => {\n      for (const hit of archiveHits) {\n        const item = await hydrate(document, hit);\n\n        if (item !== undefined) {\n          hydrated.push({ ...item, ...source });\n        }\n      }\n    });\n  }\n\n  return hydrated;\n}\n\nfunction shouldReadLibraryBucket(\n  session: SearchSessionDescriptor,\n  ...types: ArchiveFindFilterType[]\n): boolean {\n  return (\n    session.types === null ||\n    types.some((type) => session.types?.includes(type))\n  );\n}\n\nfunction matchesLibrarySessionTypes(\n  hit: ArchiveFindHit,\n  session: SearchSessionDescriptor,\n): boolean {\n  return (\n    session.types === null ||\n    (hit.type === \"entity\" && session.types.includes(\"entity\")) ||\n    (hit.type === \"triple\" && session.types.includes(\"triple\"))\n  );\n}\n\nfunction createLibraryTextTypes(\n  session: SearchSessionDescriptor,\n): readonly (\"source\" | \"summary\")[] {\n  if (session.types === null) {\n    return [\"source\", \"summary\"];\n  }\n\n  return session.types.filter(\n    (type): type is \"source\" | \"summary\" =>\n      type === \"source\" || type === \"summary\",\n  );\n}\n\nfunction createLibrarySearchArchiveKey(\n  target: ParsedWikiGraphLibraryUri,\n): string {\n  return target.isDefault\n    ? \"library:default\"\n    : `library:${target.publicId ?? \"unknown\"}`;\n}\n\nfunction getLibraryHitArchiveId(hit: ArchiveFindHit): number {\n  if (hit.archiveId === undefined) {\n    throw new Error(\"Internal error: library search hit is missing archiveId.\");\n  }\n  return hit.archiveId;\n}\n\nfunction createLibraryScopedObjectKey(\n  archiveId: number,\n  objectId: string,\n): string {\n  return `${archiveId}:${objectId}`;\n}\n\nfunction parseLibraryScopedObjectKey(key: string): {\n  readonly archiveId: number;\n  readonly objectId: string;\n} {\n  const separator = key.indexOf(\":\");\n\n  if (separator <= 0) {\n    throw new Error(`Invalid library search cache key: ${key}`);\n  }\n\n  return {\n    archiveId: Number(key.slice(0, separator)),\n    objectId: key.slice(separator + 1),\n  };\n}\n"],"mappings":"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","names":[]}

package/dist/library/segments.d.ts

@@ -0,0 +1,3 @@
+declare const RESERVED_LIBRARY_URI_SEGMENTS: Set<string>;
+
+export { RESERVED_LIBRARY_URI_SEGMENTS };

package/dist/library/segments.js

@@ -0,0 +1,16 @@
+const RESERVED_LIBRARY_URI_SEGMENTS = /* @__PURE__ */ new Set([
+  "registry",
+  "arc",
+  "path",
+  "tree",
+  "meta",
+  "index",
+  "chapter",
+  "chunk",
+  "entity",
+  "triple"
+]);
+export {
+  RESERVED_LIBRARY_URI_SEGMENTS
+};
+//# sourceMappingURL=segments.js.map

package/dist/library/segments.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/library/segments.ts"],"sourcesContent":["export const RESERVED_LIBRARY_URI_SEGMENTS = new Set([\n  \"registry\",\n  \"arc\",\n  \"path\",\n  \"tree\",\n  \"meta\",\n  \"index\",\n  \"chapter\",\n  \"chunk\",\n  \"entity\",\n  \"triple\",\n]);\n"],"mappings":"AAAO,MAAM,gCAAgC,oBAAI,IAAI;AAAA,EACnD;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACF,CAAC;","names":[]}

package/dist/maintenance/upgrade.d.ts

@@ -0,0 +1,54 @@
+import { ParsedWikiGraphLibraryUri } from '../library/registry.js';
+
+type WikiGraphMaintenanceUpgradeResult = {
+    readonly kind: "home";
+    readonly path: string;
+    readonly schemaVersionBefore: number;
+    readonly schemaVersionAfter: number;
+    readonly status: "already-current" | "upgraded";
+} | {
+    readonly kind: "archive";
+    readonly path: string;
+    readonly schemaVersionBefore: number;
+    readonly schemaVersionAfter: number;
+    readonly status: "already-current" | "upgraded";
+} | {
+    readonly kind: "sdpub";
+    readonly inputPath: string;
+    readonly outputPath: string;
+    readonly status: "migrated";
+} | WikiGraphLibraryUpgradeResult;
+interface WikiGraphLibraryUpgradeResult {
+    readonly kind: "lib";
+    readonly library: {
+        readonly id: number;
+        readonly publicId: string;
+        readonly uri: string;
+        readonly folderPath: string;
+        readonly stagingPath: string;
+    };
+    readonly upgraded: readonly WikiGraphLibraryArchiveUpgradeItem[];
+    readonly skipped: readonly WikiGraphLibraryArchiveUpgradeItem[];
+    readonly failed?: WikiGraphLibraryArchiveFailure | undefined;
+    readonly status: "already-current" | "partial" | "upgraded";
+}
+interface WikiGraphLibraryArchiveUpgradeItem {
+    readonly publicId: string;
+    readonly uri: string;
+    readonly path: string;
+    readonly schemaVersionBefore: number;
+    readonly schemaVersionAfter: number;
+}
+interface WikiGraphLibraryArchiveFailure {
+    readonly publicId: string;
+    readonly uri: string;
+    readonly path: string;
+    readonly message: string;
+}
+declare function upgradeWikiGraphMaintenanceTarget(target: string, options?: {
+    readonly outputPath?: string;
+}): Promise<WikiGraphMaintenanceUpgradeResult>;
+declare function assertWikiGraphLibrarySchemaCurrent(target: ParsedWikiGraphLibraryUri): Promise<void>;
+declare function upgradeWikiGraphLibrarySchema(target: ParsedWikiGraphLibraryUri): Promise<WikiGraphLibraryUpgradeResult>;
+
+export { type WikiGraphLibraryArchiveFailure, type WikiGraphLibraryArchiveUpgradeItem, type WikiGraphLibraryUpgradeResult, type WikiGraphMaintenanceUpgradeResult, assertWikiGraphLibrarySchemaCurrent, upgradeWikiGraphLibrarySchema, upgradeWikiGraphMaintenanceTarget };