wiki-graph-core 0.3.1 → 0.4.0

package/dist/library/membership.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/library/membership.ts"],"sourcesContent":["import { randomBytes } from \"crypto\";\nimport {\n  constants,\n  copyFile,\n  mkdir,\n  opendir,\n  realpath,\n  rename,\n  rm,\n  stat,\n} from \"fs/promises\";\nimport { dirname, isAbsolute, join, relative, resolve } from \"path\";\n\nimport {\n  getNumber,\n  getOptionalString,\n  getString,\n  type Database,\n  type SqlRow,\n} from \"../document/database.js\";\nimport { openSharedStateDatabase } from \"../document/index.js\";\nimport { resolveWikiGraphCoreDatabasePath } from \"../runtime/common/wiki-graph/dir.js\";\nimport { WIKI_GRAPH_ARCHIVE_EXTENSION } from \"../runtime/common/wiki-graph/uri.js\";\nimport {\n  readWikgArchiveEntry,\n  readWikgArchiveMutationToken,\n  WikiGraphArchiveFile,\n} from \"../storage/wikg/index.js\";\nimport { isNodeError } from \"../utils/node-error.js\";\nimport {\n  parseWikiGraphLibraryUri,\n  resolveWikiGraphLibrary,\n  updateWikiGraphLibraryFolderPathForRebind,\n  type ParsedWikiGraphLibraryUri,\n  type WikiGraphLibraryRecord,\n} from \"./registry.js\";\nimport { markWikiGraphLibraryIndexDirty } from \"./search-index.js\";\nimport { withWikiGraphLibraryLock } from \"./lock.js\";\n\nconst PUBLIC_ID_BYTES = 6;\nconst SEARCH_INDEX_ARCHIVE_ENTRY_PATH = \"fts.db\";\nconst LIBRARY_ARCHIVES_TABLE_COLUMNS_SQL = `\n    id INTEGER PRIMARY KEY AUTOINCREMENT,\n    library_id INTEGER NOT NULL,\n    public_id TEXT NOT NULL,\n    relative_path TEXT NOT NULL,\n    status TEXT NOT NULL DEFAULT 'present',\n    last_seen_mutation_token TEXT,\n    last_seen_size INTEGER,\n    last_seen_mtime_ms INTEGER,\n    last_scanned_at TEXT,\n    created_at TEXT NOT NULL,\n    updated_at TEXT NOT NULL,\n    UNIQUE(library_id, public_id)\n`;\nconst LIBRARY_ARCHIVE_MEMBERSHIP_SCHEMA_SQL = `\n  CREATE TABLE IF NOT EXISTS library_archives (\n${LIBRARY_ARCHIVES_TABLE_COLUMNS_SQL}\n  );\n\n  CREATE INDEX IF NOT EXISTS idx_library_archives_library\n  ON library_archives(library_id);\n\n  CREATE INDEX IF NOT EXISTS idx_library_archives_library_path\n  ON library_archives(library_id, relative_path);\n`;\n\ntype LibraryPathIdentityMode = \"trusted\" | \"untrusted\";\n\ntype WikiGraphLibraryArchiveStatus = \"conflict\" | \"missing\" | \"present\";\n\nexport interface WikiGraphLibraryArchiveRecord {\n  readonly id: number;\n  readonly publicId: string;\n  readonly uri: string;\n  readonly libraryId: number;\n  readonly libraryUri: string;\n  readonly relativePath: string;\n  readonly path: string;\n  readonly exists: boolean;\n  readonly status: WikiGraphLibraryArchiveStatus;\n  readonly lastSeenMutationToken?: string;\n  readonly lastSeenSize?: number;\n  readonly lastSeenMtimeMs?: number;\n  readonly lastScannedAt?: string;\n  readonly createdAt: string;\n  readonly updatedAt: string;\n}\n\nexport interface WikiGraphLibraryScanResult {\n  readonly library: WikiGraphLibraryRecord;\n  readonly archives: readonly WikiGraphLibraryArchiveRecord[];\n}\n\ninterface DiscoveredLibraryArchiveFile {\n  readonly relativePath: string;\n  readonly path: string;\n  readonly mutationToken?: string;\n  readonly size: number;\n  readonly mtimeMs: number;\n}\n\nexport async function scanWikiGraphLibrary(\n  target: ParsedWikiGraphLibraryUri,\n): Promise<WikiGraphLibraryScanResult> {\n  const library = await resolveWikiGraphLibrary(target);\n  return await withWikiGraphLibraryLock(library.id, \"write\", async () => {\n    const result = await scanWikiGraphLibraryUnlocked(target, library, {\n      pathIdentity: \"trusted\",\n    });\n\n    await markWikiGraphLibraryIndexDirty(library);\n    return result;\n  });\n}\n\nexport async function rebindWikiGraphLibrary(input: {\n  readonly target: ParsedWikiGraphLibraryUri;\n  readonly folderPath: string;\n}): Promise<WikiGraphLibraryScanResult> {\n  if (input.target.kind !== \"scope\" || input.target.objectUri !== undefined) {\n    throw new Error(\"Library rebind requires a library scope URI.\");\n  }\n\n  const library = await resolveWikiGraphLibrary(input.target);\n  return await withWikiGraphLibraryLock(library.id, \"write\", async () => {\n    const rebound = await updateWikiGraphLibraryFolderPathForRebind(\n      library,\n      input.folderPath,\n    );\n    const result = await scanWikiGraphLibraryUnlocked(input.target, rebound, {\n      pathIdentity: \"untrusted\",\n    });\n\n    await markWikiGraphLibraryIndexDirty(rebound);\n    return result;\n  });\n}\n\nasync function scanWikiGraphLibraryUnlocked(\n  target: ParsedWikiGraphLibraryUri,\n  library: WikiGraphLibraryRecord,\n  options: { readonly pathIdentity: LibraryPathIdentityMode },\n): Promise<WikiGraphLibraryScanResult> {\n  const files = await listWikgFiles(library.folderPath);\n\n  await withLibraryArchiveMembershipDatabase(async (database) => {\n    await database.transaction(async () => {\n      const existing = await listLibraryArchiveRows(database, library);\n      const currentPaths = new Set(files.map((file) => file.relativePath));\n      const seenArchiveIds = new Set<number>();\n\n      for (const file of files) {\n        const existingAtPath = findExistingArchiveAtPath(existing, file);\n        if (\n          options.pathIdentity === \"trusted\" &&\n          existingAtPath !== undefined\n        ) {\n          await updateLibraryArchiveSeen(database, existingAtPath.id, file, {\n            status: \"present\",\n          });\n          seenArchiveIds.add(existingAtPath.id);\n          continue;\n        }\n\n        const matchingTokenArchives =\n          file.mutationToken === undefined\n            ? []\n            : existing.filter(\n                (archive) =>\n                  archive.lastSeenMutationToken === file.mutationToken &&\n                  !seenArchiveIds.has(archive.id),\n              );\n        const adoptable = matchingTokenArchives.filter(\n          (archive) =>\n            archive.relativePath === file.relativePath ||\n            !currentPaths.has(archive.relativePath),\n        );\n\n        if (\n          matchingTokenArchives.length === 1 &&\n          adoptable.length === 1 &&\n          file.mutationToken !== undefined\n        ) {\n          const archive = adoptable[0]!;\n          await database.run(\n            `\n              UPDATE library_archives\n              SET relative_path = ?\n              WHERE id = ?\n            `,\n            [file.relativePath, archive.id],\n          );\n          await updateLibraryArchiveSeen(database, archive.id, file, {\n            status: \"present\",\n          });\n          seenArchiveIds.add(archive.id);\n          continue;\n        }\n\n        await insertLibraryArchive(database, library.id, file, {\n          status:\n            matchingTokenArchives.length === 0 ||\n            file.mutationToken === undefined\n              ? \"present\"\n              : \"conflict\",\n        });\n      }\n\n      const now = new Date().toISOString();\n      for (const archive of existing) {\n        if (\n          seenArchiveIds.has(archive.id) ||\n          (options.pathIdentity === \"trusted\" &&\n            currentPaths.has(archive.relativePath))\n        ) {\n          continue;\n        }\n        await database.run(\n          `\n            UPDATE library_archives\n            SET status = 'missing', updated_at = ?, last_scanned_at = ?\n            WHERE id = ?\n          `,\n          [now, now, archive.id],\n        );\n      }\n    });\n  });\n\n  return { library, archives: await listWikiGraphLibraryArchives(target) };\n}\n\nexport async function listWikiGraphLibraryArchives(\n  target: ParsedWikiGraphLibraryUri,\n): Promise<readonly WikiGraphLibraryArchiveRecord[]> {\n  const library = await resolveWikiGraphLibrary(target);\n  return await withLibraryArchiveMembershipDatabase(\n    async (database) => await listLibraryArchives(database, library),\n  );\n}\n\nexport async function getWikiGraphLibraryArchive(\n  target: ParsedWikiGraphLibraryUri,\n): Promise<WikiGraphLibraryArchiveRecord> {\n  const library = await resolveWikiGraphLibrary(target);\n  return await resolveLibraryArchiveTarget(target, library);\n}\n\nexport async function getWikiGraphLibraryArchiveById(\n  library: WikiGraphLibraryRecord,\n  archiveId: number,\n): Promise<WikiGraphLibraryArchiveRecord> {\n  return await withLibraryArchiveMembershipDatabase(\n    async (database) =>\n      await requireLibraryArchiveById(database, library, archiveId),\n  );\n}\n\nexport async function resolveWikiGraphLibraryArchivePath(\n  archiveLocator: string,\n): Promise<string> {\n  const target = parseWikiGraphLibraryUri(archiveLocator);\n  if (target === undefined || target.kind !== \"archive\") {\n    throw new Error(\n      `Expected a Wiki Graph library archive locator: ${archiveLocator}`,\n    );\n  }\n\n  const archive = await getWikiGraphLibraryArchive(target);\n  if (!archive.exists || archive.status === \"missing\") {\n    throw new Error(`Wiki Graph library archive is missing: ${archiveLocator}`);\n  }\n  if (archive.status === \"conflict\") {\n    throw new Error(\n      `Wiki Graph library archive has a conflict and cannot be resolved: ${archiveLocator}`,\n    );\n  }\n\n  return archive.path;\n}\n\nexport async function addWikiGraphLibraryArchive(input: {\n  readonly target: ParsedWikiGraphLibraryUri;\n  readonly inputPath: string;\n  readonly to?: string;\n}): Promise<WikiGraphLibraryArchiveRecord> {\n  if (input.inputPath.startsWith(\"wikg://\")) {\n    throw new Error(\n      \"Library add --input accepts a file path, not a Wiki Graph URI.\",\n    );\n  }\n  if (/^[a-z][a-z0-9+.-]*:\\/\\//iu.test(input.inputPath)) {\n    throw new Error(\"Library add does not support URL inputs yet.\");\n  }\n\n  const library = await resolveWikiGraphLibrary(input.target);\n  await mkdir(library.folderPath, { recursive: true });\n  const sourcePath = resolve(input.inputPath);\n  const sourceStats = await stat(sourcePath);\n  if (!sourceStats.isFile()) {\n    throw new Error(`Library add --input must be a file: ${input.inputPath}`);\n  }\n  const sourceBasename = sourcePath.split(/[\\\\/]/u).at(-1) ?? \"\";\n  const targetRelativePath = validateLibraryArchiveRelativePath(\n    input.to ?? sourceBasename,\n  );\n  const targetPath = resolveLibraryRelativePath(\n    library.folderPath,\n    targetRelativePath,\n  );\n\n  return await withWikiGraphLibraryLock(library.id, \"write\", async () => {\n    await mkdir(dirname(targetPath), { recursive: true });\n    await assertInsideLibrary(\n      await realpath(dirname(targetPath)),\n      library.folderPath,\n    );\n    await copyFile(sourcePath, targetPath, constants.COPYFILE_EXCL);\n    await assertInsideLibrary(await realpath(targetPath), library.folderPath);\n    const targetFile = await ensureLibraryArchiveFileHasNoSearchIndexAndInspect(\n      library.folderPath,\n      targetRelativePath,\n    );\n    const archive = await withLibraryArchiveMembershipDatabase(\n      async (database) => {\n        await database.transaction(async () => {\n          await ensureLibraryArchiveByRelativePath(\n            database,\n            library.id,\n            targetFile,\n          );\n        });\n        return await requireLibraryArchiveByRelativePath(\n          database,\n          library,\n          targetRelativePath,\n        );\n      },\n    );\n\n    await markWikiGraphLibraryIndexDirty(library);\n    return archive;\n  });\n}\n\nexport async function finalizeWikiGraphLibraryArchiveWrite(input: {\n  readonly target: ParsedWikiGraphLibraryUri;\n}): Promise<boolean> {\n  if (input.target.kind !== \"archive\") {\n    throw new Error(\"Expected a Wiki Graph library archive URI.\");\n  }\n\n  const library = await resolveWikiGraphLibrary(input.target);\n  return await withWikiGraphLibraryLock(library.id, \"write\", async () => {\n    const archive = await resolveLibraryArchiveTarget(input.target, library);\n    const removed = await ensureLibraryManagedArchiveHasNoSearchIndex(\n      archive.path,\n    );\n    const refreshedFile = await inspectLibraryArchiveFile(\n      library.folderPath,\n      archive.relativePath,\n    );\n\n    await withLibraryArchiveMembershipDatabase(async (database) => {\n      await updateLibraryArchiveSeen(database, archive.id, refreshedFile, {\n        status: \"present\",\n      });\n    });\n\n    return removed;\n  });\n}\n\nexport async function ensureLibraryManagedArchiveHasNoSearchIndex(\n  archivePath: string,\n): Promise<boolean> {\n  if ((await readOptionalWikgMutationToken(archivePath)) === undefined) {\n    return false;\n  }\n\n  const searchIndex = await readWikgArchiveEntry(\n    archivePath,\n    SEARCH_INDEX_ARCHIVE_ENTRY_PATH,\n  );\n  if (searchIndex === undefined) {\n    return false;\n  }\n\n  await new WikiGraphArchiveFile(archivePath).write(\n    async (document) => {\n      await document.deleteSearchIndexDatabase();\n    },\n    { searchIndexWritebackPolicy: \"archive\" },\n  );\n  return true;\n}\n\nexport async function removeWikiGraphLibraryArchive(input: {\n  readonly target: ParsedWikiGraphLibraryUri;\n}): Promise<WikiGraphLibraryArchiveRecord> {\n  const library = await resolveWikiGraphLibrary(input.target);\n  const archive = await resolveLibraryArchiveTarget(input.target, library);\n\n  await withWikiGraphLibraryLock(library.id, \"write\", async () => {\n    await rm(archive.path, { force: true });\n    await withLibraryArchiveMembershipDatabase(async (database) => {\n      await database.run(\"DELETE FROM library_archives WHERE id = ?\", [\n        archive.id,\n      ]);\n    });\n    await markWikiGraphLibraryIndexDirty(library);\n  });\n\n  return { ...archive, exists: false, status: \"missing\" };\n}\n\nexport async function moveWikiGraphLibraryArchive(input: {\n  readonly target: ParsedWikiGraphLibraryUri;\n  readonly to: string;\n}): Promise<WikiGraphLibraryArchiveRecord> {\n  const library = await resolveWikiGraphLibrary(input.target);\n  const archive = await resolveLibraryArchiveTarget(input.target, library);\n  const targetRelativePath = validateLibraryArchiveRelativePath(input.to);\n  const targetPath = resolveLibraryRelativePath(\n    library.folderPath,\n    targetRelativePath,\n  );\n\n  return await withWikiGraphLibraryLock(library.id, \"write\", async () => {\n    await mkdir(dirname(targetPath), { recursive: true });\n    await assertInsideLibrary(\n      await realpath(dirname(targetPath)),\n      library.folderPath,\n    );\n    if (await pathExists(targetPath)) {\n      throw new Error(\n        `Library archive target already exists: ${targetRelativePath}`,\n      );\n    }\n    await rename(archive.path, targetPath);\n    await assertInsideLibrary(await realpath(targetPath), library.folderPath);\n    const targetFile = await inspectLibraryArchiveFile(\n      library.folderPath,\n      targetRelativePath,\n    );\n    const moved = await withLibraryArchiveMembershipDatabase(\n      async (database) => {\n        await database.run(\n          \"UPDATE library_archives SET relative_path = ? WHERE id = ?\",\n          [targetRelativePath, archive.id],\n        );\n        await updateLibraryArchiveSeen(database, archive.id, targetFile, {\n          status: \"present\",\n        });\n        return await requireLibraryArchiveByPublicId(\n          database,\n          library,\n          archive.publicId,\n        );\n      },\n    );\n\n    await markWikiGraphLibraryIndexDirty(library);\n    return moved;\n  });\n}\n\nasync function withLibraryArchiveMembershipDatabase<T>(\n  operation: (database: Database) => Promise<T>,\n): Promise<T> {\n  const database = await openSharedStateDatabase(\n    resolveWikiGraphCoreDatabasePath(),\n    LIBRARY_ARCHIVE_MEMBERSHIP_SCHEMA_SQL,\n  );\n\n  try {\n    await ensureLibraryArchiveMembershipColumns(database);\n    await ensureLibraryArchiveMembershipPathIndex(database);\n    return await operation(database);\n  } finally {\n    await database.close();\n  }\n}\n\nasync function listLibraryArchives(\n  database: Database,\n  library: WikiGraphLibraryRecord,\n): Promise<WikiGraphLibraryArchiveRecord[]> {\n  const rows = await queryLibraryArchiveRows(database, library.id);\n  const archives: WikiGraphLibraryArchiveRecord[] = [];\n  for (const row of rows) {\n    const relativePath = getString(row, \"relative_path\");\n    archives.push(\n      mapLibraryArchiveRecord(\n        library,\n        row,\n        await pathExists(join(library.folderPath, relativePath)),\n      ),\n    );\n  }\n  return archives;\n}\n\nasync function listLibraryArchiveRows(\n  database: Database,\n  library: WikiGraphLibraryRecord,\n): Promise<WikiGraphLibraryArchiveRecord[]> {\n  const rows = await queryLibraryArchiveRows(database, library.id);\n  return rows.map((row) => mapLibraryArchiveRecord(library, row, false));\n}\n\nasync function queryLibraryArchiveRows(\n  database: Database,\n  libraryId: number,\n): Promise<SqlRow[]> {\n  return await database.queryAll(\n    `\n      SELECT id, public_id, relative_path, status, last_seen_mutation_token,\n             last_seen_size, last_seen_mtime_ms, last_scanned_at,\n             created_at, updated_at\n      FROM library_archives\n      WHERE library_id = ?\n      ORDER BY relative_path\n    `,\n    [libraryId],\n    (row) => row,\n  );\n}\n\nasync function ensureLibraryArchiveByRelativePath(\n  database: Database,\n  libraryId: number,\n  file: DiscoveredLibraryArchiveFile,\n): Promise<void> {\n  const existing = await database.queryOne(\n    `\n      SELECT id\n      FROM library_archives\n      WHERE library_id = ? AND relative_path = ?\n      ORDER BY CASE status\n        WHEN 'present' THEN 0\n        WHEN 'conflict' THEN 1\n        ELSE 2\n      END, id DESC\n    `,\n    [libraryId, file.relativePath],\n    (row) => getNumber(row, \"id\"),\n  );\n  if (existing !== undefined) {\n    await updateLibraryArchiveSeen(database, existing, file, {\n      status: \"present\",\n    });\n    return;\n  }\n\n  await insertLibraryArchive(database, libraryId, file, { status: \"present\" });\n}\n\nasync function insertLibraryArchive(\n  database: Database,\n  libraryId: number,\n  file: DiscoveredLibraryArchiveFile,\n  options: { readonly status: WikiGraphLibraryArchiveStatus },\n): Promise<void> {\n  const now = new Date().toISOString();\n  await database.run(\n    `\n      INSERT INTO library_archives (\n        library_id, public_id, relative_path, status, last_seen_mutation_token,\n        last_seen_size, last_seen_mtime_ms, last_scanned_at, created_at, updated_at\n      )\n      VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?)\n    `,\n    [\n      libraryId,\n      await createUniqueLibraryArchivePublicId(database, libraryId),\n      file.relativePath,\n      options.status,\n      file.mutationToken ?? null,\n      file.size,\n      Math.round(file.mtimeMs),\n      now,\n      now,\n      now,\n    ],\n  );\n}\n\nasync function updateLibraryArchiveSeen(\n  database: Database,\n  archiveId: number,\n  file: DiscoveredLibraryArchiveFile,\n  options: { readonly status: WikiGraphLibraryArchiveStatus },\n): Promise<void> {\n  const now = new Date().toISOString();\n  await database.run(\n    `\n      UPDATE library_archives\n      SET status = ?,\n          last_seen_mutation_token = ?,\n          last_seen_size = ?,\n          last_seen_mtime_ms = ?,\n          last_scanned_at = ?,\n          updated_at = ?\n      WHERE id = ?\n    `,\n    [\n      options.status,\n      file.mutationToken ?? null,\n      file.size,\n      Math.round(file.mtimeMs),\n      now,\n      now,\n      archiveId,\n    ],\n  );\n}\n\nasync function requireLibraryArchiveByRelativePath(\n  database: Database,\n  library: WikiGraphLibraryRecord,\n  relativePath: string,\n): Promise<WikiGraphLibraryArchiveRecord> {\n  const archive = await database.queryOne(\n    `\n      SELECT id, public_id, relative_path, status, last_seen_mutation_token,\n             last_seen_size, last_seen_mtime_ms, last_scanned_at,\n             created_at, updated_at\n      FROM library_archives\n      WHERE library_id = ? AND relative_path = ?\n      ORDER BY CASE status\n        WHEN 'present' THEN 0\n        WHEN 'conflict' THEN 1\n        ELSE 2\n      END, id DESC\n    `,\n    [library.id, relativePath],\n    (row) => mapLibraryArchiveRecord(library, row, true),\n  );\n  if (archive === undefined) {\n    throw new Error(\n      `Library archive registry record is missing: ${relativePath}`,\n    );\n  }\n  return archive;\n}\n\nasync function requireLibraryArchiveByPublicId(\n  database: Database,\n  library: WikiGraphLibraryRecord,\n  publicId: string,\n): Promise<WikiGraphLibraryArchiveRecord> {\n  const row = await database.queryOne(\n    `\n      SELECT id, public_id, relative_path, status, last_seen_mutation_token,\n             last_seen_size, last_seen_mtime_ms, last_scanned_at,\n             created_at, updated_at\n      FROM library_archives\n      WHERE library_id = ? AND public_id = ?\n    `,\n    [library.id, publicId],\n    (row) => row,\n  );\n  if (row === undefined) {\n    throw new Error(`Unknown Wiki Graph library archive: ${publicId}`);\n  }\n  const relativePath = getString(row, \"relative_path\");\n  return mapLibraryArchiveRecord(\n    library,\n    row,\n    await pathExists(join(library.folderPath, relativePath)),\n  );\n}\n\nasync function requireLibraryArchiveById(\n  database: Database,\n  library: WikiGraphLibraryRecord,\n  archiveId: number,\n): Promise<WikiGraphLibraryArchiveRecord> {\n  const row = await database.queryOne(\n    `\n      SELECT id, public_id, relative_path, status, last_seen_mutation_token,\n             last_seen_size, last_seen_mtime_ms, last_scanned_at,\n             created_at, updated_at\n      FROM library_archives\n      WHERE library_id = ? AND id = ?\n    `,\n    [library.id, archiveId],\n    (row) => row,\n  );\n  if (row === undefined) {\n    throw new Error(`Unknown Wiki Graph library archive: ${archiveId}`);\n  }\n  const relativePath = getString(row, \"relative_path\");\n  return mapLibraryArchiveRecord(\n    library,\n    row,\n    await pathExists(join(library.folderPath, relativePath)),\n  );\n}\n\nasync function resolveLibraryArchiveTarget(\n  target: ParsedWikiGraphLibraryUri,\n  library: WikiGraphLibraryRecord,\n): Promise<WikiGraphLibraryArchiveRecord> {\n  if (target.kind !== \"archive\" || target.archivePublicId === undefined) {\n    throw new Error(\"Expected a Wiki Graph library archive URI.\");\n  }\n  return await withLibraryArchiveMembershipDatabase(\n    async (database) =>\n      await requireLibraryArchiveByPublicId(\n        database,\n        library,\n        target.archivePublicId!,\n      ),\n  );\n}\n\nfunction mapLibraryArchiveRecord(\n  library: WikiGraphLibraryRecord,\n  row: SqlRow,\n  exists: boolean,\n): WikiGraphLibraryArchiveRecord {\n  const publicId = getString(row, \"public_id\");\n  const relativePath = getString(row, \"relative_path\");\n  const databaseStatus = normalizeArchiveStatus(\n    getOptionalString(row, \"status\") ?? \"present\",\n  );\n  return {\n    createdAt: getString(row, \"created_at\"),\n    exists,\n    id: getNumber(row, \"id\"),\n    libraryId: library.id,\n    libraryUri: library.uri,\n    ...optionalStringField(\n      row,\n      \"last_seen_mutation_token\",\n      \"lastSeenMutationToken\",\n    ),\n    ...optionalNumberField(row, \"last_seen_mtime_ms\", \"lastSeenMtimeMs\"),\n    ...optionalNumberField(row, \"last_seen_size\", \"lastSeenSize\"),\n    ...optionalStringField(row, \"last_scanned_at\", \"lastScannedAt\"),\n    path: join(library.folderPath, relativePath),\n    publicId,\n    relativePath,\n    status: exists ? databaseStatus : \"missing\",\n    updatedAt: getString(row, \"updated_at\"),\n    uri: `${library.uri}/arc/${publicId}`,\n  };\n}\n\nfunction findExistingArchiveAtPath(\n  archives: readonly WikiGraphLibraryArchiveRecord[],\n  file: DiscoveredLibraryArchiveFile,\n): WikiGraphLibraryArchiveRecord | undefined {\n  return archives\n    .filter((archive) => archive.relativePath === file.relativePath)\n    .sort((a, b) => archivePathMatchRank(a) - archivePathMatchRank(b))[0];\n}\n\nfunction archivePathMatchRank(archive: WikiGraphLibraryArchiveRecord): number {\n  if (archive.status === \"present\") {\n    return 0;\n  }\n  if (archive.status === \"conflict\") {\n    return 1;\n  }\n  return 2;\n}\n\nasync function listWikgFiles(\n  root: string,\n): Promise<DiscoveredLibraryArchiveFile[]> {\n  const relativePaths: string[] = [];\n  await walkLibraryDirectory(root, root, relativePaths);\n  const files: DiscoveredLibraryArchiveFile[] = [];\n  for (const relativePath of relativePaths.sort((a, b) => a.localeCompare(b))) {\n    files.push(\n      await ensureLibraryArchiveFileHasNoSearchIndexAndInspect(\n        root,\n        relativePath,\n      ),\n    );\n  }\n  return files;\n}\n\nasync function ensureLibraryArchiveFileHasNoSearchIndexAndInspect(\n  root: string,\n  relativePath: string,\n): Promise<DiscoveredLibraryArchiveFile> {\n  await ensureLibraryManagedArchiveHasNoSearchIndex(join(root, relativePath));\n  return await inspectLibraryArchiveFile(root, relativePath);\n}\n\nasync function walkLibraryDirectory(\n  root: string,\n  directory: string,\n  files: string[],\n): Promise<void> {\n  let entries;\n  try {\n    entries = await opendir(directory);\n  } catch (error) {\n    if (isNodeError(error) && error.code === \"ENOENT\") {\n      return;\n    }\n    throw error;\n  }\n  for await (const entry of entries) {\n    const path = join(directory, entry.name);\n    if (entry.isDirectory()) {\n      await walkLibraryDirectory(root, path, files);\n    } else if (\n      entry.isFile() &&\n      entry.name.endsWith(WIKI_GRAPH_ARCHIVE_EXTENSION)\n    ) {\n      files.push(relative(root, path).replace(/\\\\/gu, \"/\"));\n    }\n  }\n}\n\nasync function inspectLibraryArchiveFile(\n  root: string,\n  relativePath: string,\n): Promise<DiscoveredLibraryArchiveFile> {\n  const path = join(root, relativePath);\n  const fileStat = await stat(path);\n  const mutationToken = await readOptionalWikgMutationToken(path);\n  return {\n    mtimeMs: fileStat.mtimeMs,\n    ...(mutationToken === undefined ? {} : { mutationToken }),\n    path,\n    relativePath,\n    size: fileStat.size,\n  };\n}\n\nasync function readOptionalWikgMutationToken(\n  path: string,\n): Promise<string | undefined> {\n  try {\n    return await readWikgArchiveMutationToken(path);\n  } catch {\n    return undefined;\n  }\n}\n\nfunction validateLibraryArchiveRelativePath(relativePath: string): string {\n  const normalized = relativePath\n    .replace(/\\\\/gu, \"/\")\n    .replace(/^\\/+|\\/+$/gu, \"\");\n  if (\n    normalized === \"\" ||\n    isAbsolute(relativePath) ||\n    normalized.split(\"/\").includes(\"..\")\n  ) {\n    throw new Error(\n      \"Library archive target must be a relative path inside the library folder.\",\n    );\n  }\n  if (!normalized.endsWith(WIKI_GRAPH_ARCHIVE_EXTENSION)) {\n    throw new Error(\"Library archive target must end with .wikg.\");\n  }\n  return normalized;\n}\n\nfunction resolveLibraryRelativePath(\n  root: string,\n  relativePath: string,\n): string {\n  const path = resolve(root, relativePath);\n  const rel = relative(resolve(root), path);\n  if (rel === \"\" || rel.startsWith(\"..\") || isAbsolute(rel)) {\n    throw new Error(\"Library archive target escapes the library folder.\");\n  }\n  return path;\n}\n\nasync function assertInsideLibrary(path: string, root: string): Promise<void> {\n  const rootRealPath = await realpath(root);\n  const rel = relative(rootRealPath, path);\n  if (rel.startsWith(\"..\") || isAbsolute(rel)) {\n    throw new Error(\"Library archive path escapes the library folder.\");\n  }\n}\n\nasync function ensureLibraryArchiveMembershipColumns(\n  database: Database,\n): Promise<void> {\n  const columns = await database.queryAll(\n    \"PRAGMA table_info(library_archives)\",\n    undefined,\n    (row) => getString(row, \"name\"),\n  );\n  const columnSet = new Set(columns);\n  const additions: Array<readonly [string, string]> = [\n    [\"status\", \"TEXT NOT NULL DEFAULT 'present'\"],\n    [\"last_seen_mutation_token\", \"TEXT\"],\n    [\"last_seen_size\", \"INTEGER\"],\n    [\"last_seen_mtime_ms\", \"INTEGER\"],\n    [\"last_scanned_at\", \"TEXT\"],\n  ];\n  for (const [name, definition] of additions) {\n    if (!columnSet.has(name)) {\n      await database.run(\n        `ALTER TABLE library_archives ADD COLUMN ${name} ${definition}`,\n      );\n    }\n  }\n}\n\nasync function ensureLibraryArchiveMembershipPathIndex(\n  database: Database,\n): Promise<void> {\n  if (await hasUniqueLibraryArchiveRelativePathIndex(database)) {\n    await rebuildLibraryArchiveMembershipTable(database);\n  }\n  await database.run(\n    `\n      CREATE INDEX IF NOT EXISTS idx_library_archives_library_path\n      ON library_archives(library_id, relative_path)\n    `,\n  );\n}\n\nasync function hasUniqueLibraryArchiveRelativePathIndex(\n  database: Database,\n): Promise<boolean> {\n  const indexes = await database.queryAll(\n    \"PRAGMA index_list(library_archives)\",\n    undefined,\n    (row) => ({\n      name: getString(row, \"name\"),\n      unique: getNumber(row, \"unique\") === 1,\n    }),\n  );\n  for (const index of indexes) {\n    if (!index.unique) {\n      continue;\n    }\n    const columns = await database.queryAll(\n      `PRAGMA index_info(${sqlStringLiteral(index.name)})`,\n      undefined,\n      (row) => getString(row, \"name\"),\n    );\n    if (\n      columns.length === 2 &&\n      columns[0] === \"library_id\" &&\n      columns[1] === \"relative_path\"\n    ) {\n      return true;\n    }\n  }\n  return false;\n}\n\nasync function rebuildLibraryArchiveMembershipTable(\n  database: Database,\n): Promise<void> {\n  await database.transaction(async () => {\n    await database.run(\n      \"ALTER TABLE library_archives RENAME TO library_archives_unique_path_legacy\",\n    );\n    await database.run(`\n      CREATE TABLE library_archives (\n${LIBRARY_ARCHIVES_TABLE_COLUMNS_SQL}\n      )\n    `);\n    await database.run(`\n      INSERT INTO library_archives (\n        id, library_id, public_id, relative_path, status,\n        last_seen_mutation_token, last_seen_size, last_seen_mtime_ms,\n        last_scanned_at, created_at, updated_at\n      )\n      SELECT id, library_id, public_id, relative_path, status,\n        last_seen_mutation_token, last_seen_size, last_seen_mtime_ms,\n        last_scanned_at, created_at, updated_at\n      FROM library_archives_unique_path_legacy\n    `);\n    await database.run(\"DROP TABLE library_archives_unique_path_legacy\");\n  });\n}\n\nfunction sqlStringLiteral(value: string): string {\n  return `'${value.replace(/'/gu, \"''\")}'`;\n}\n\nasync function createUniqueLibraryArchivePublicId(\n  database: Database,\n  libraryId: number,\n): Promise<string> {\n  for (let attempt = 0; attempt < 20; attempt += 1) {\n    const publicId = randomBytes(PUBLIC_ID_BYTES).toString(\"hex\");\n    const existing = await database.queryOne(\n      \"SELECT public_id FROM library_archives WHERE library_id = ? AND public_id = ?\",\n      [libraryId, publicId],\n      (row) => getString(row, \"public_id\"),\n    );\n    if (existing === undefined) {\n      return publicId;\n    }\n  }\n  throw new Error(\"Could not generate a unique library archive id.\");\n}\n\nasync function pathExists(path: string): Promise<boolean> {\n  try {\n    await stat(path);\n    return true;\n  } catch (error) {\n    if (isNodeError(error) && error.code === \"ENOENT\") {\n      return false;\n    }\n    throw error;\n  }\n}\n\nfunction normalizeArchiveStatus(value: string): WikiGraphLibraryArchiveStatus {\n  if (value === \"conflict\" || value === \"missing\" || value === \"present\") {\n    return value;\n  }\n  return \"present\";\n}\n\nfunction optionalNumberField<K extends string>(\n  row: SqlRow,\n  dbKey: string,\n  outputKey: K,\n): Partial<Record<K, number>> {\n  const value = row[dbKey];\n  if (typeof value !== \"number\") {\n    return {};\n  }\n  return { [outputKey]: value } as Partial<Record<K, number>>;\n}\n\nfunction optionalStringField<K extends string>(\n  row: SqlRow,\n  dbKey: string,\n  outputKey: K,\n): Partial<Record<K, string>> {\n  const value = getOptionalString(row, dbKey);\n  if (value === undefined) {\n    return {};\n  }\n  return { [outputKey]: value } as Partial<Record<K, string>>;\n}\n"],"mappings":"AAAA,SAAS,mBAAmB;AAC5B;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OACK;AACP,SAAS,SAAS,YAAY,MAAM,UAAU,eAAe;AAE7D;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,OAGK;AACP,SAAS,+BAA+B;AACxC,SAAS,wCAAwC;AACjD,SAAS,oCAAoC;AAC7C;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,OACK;AACP,SAAS,mBAAmB;AAC5B;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,OAGK;AACP,SAAS,sCAAsC;AAC/C,SAAS,gCAAgC;AAEzC,MAAM,kBAAkB;AACxB,MAAM,kCAAkC;AACxC,MAAM,qCAAqC;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAc3C,MAAM,wCAAwC;AAAA;AAAA,EAE5C,kCAAkC;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AA6CpC,eAAsB,qBACpB,QACqC;AACrC,QAAM,UAAU,MAAM,wBAAwB,MAAM;AACpD,SAAO,MAAM,yBAAyB,QAAQ,IAAI,SAAS,YAAY;AACrE,UAAM,SAAS,MAAM,6BAA6B,QAAQ,SAAS;AAAA,MACjE,cAAc;AAAA,IAChB,CAAC;AAED,UAAM,+BAA+B,OAAO;AAC5C,WAAO;AAAA,EACT,CAAC;AACH;AAEA,eAAsB,uBAAuB,OAGL;AACtC,MAAI,MAAM,OAAO,SAAS,WAAW,MAAM,OAAO,cAAc,QAAW;AACzE,UAAM,IAAI,MAAM,8CAA8C;AAAA,EAChE;AAEA,QAAM,UAAU,MAAM,wBAAwB,MAAM,MAAM;AAC1D,SAAO,MAAM,yBAAyB,QAAQ,IAAI,SAAS,YAAY;AACrE,UAAM,UAAU,MAAM;AAAA,MACpB;AAAA,MACA,MAAM;AAAA,IACR;AACA,UAAM,SAAS,MAAM,6BAA6B,MAAM,QAAQ,SAAS;AAAA,MACvE,cAAc;AAAA,IAChB,CAAC;AAED,UAAM,+BAA+B,OAAO;AAC5C,WAAO;AAAA,EACT,CAAC;AACH;AAEA,eAAe,6BACb,QACA,SACA,SACqC;AACrC,QAAM,QAAQ,MAAM,cAAc,QAAQ,UAAU;AAEpD,QAAM,qCAAqC,OAAO,aAAa;AAC7D,UAAM,SAAS,YAAY,YAAY;AACrC,YAAM,WAAW,MAAM,uBAAuB,UAAU,OAAO;AAC/D,YAAM,eAAe,IAAI,IAAI,MAAM,IAAI,CAAC,SAAS,KAAK,YAAY,CAAC;AACnE,YAAM,iBAAiB,oBAAI,IAAY;AAEvC,iBAAW,QAAQ,OAAO;AACxB,cAAM,iBAAiB,0BAA0B,UAAU,IAAI;AAC/D,YACE,QAAQ,iBAAiB,aACzB,mBAAmB,QACnB;AACA,gBAAM,yBAAyB,UAAU,eAAe,IAAI,MAAM;AAAA,YAChE,QAAQ;AAAA,UACV,CAAC;AACD,yBAAe,IAAI,eAAe,EAAE;AACpC;AAAA,QACF;AAEA,cAAM,wBACJ,KAAK,kBAAkB,SACnB,CAAC,IACD,SAAS;AAAA,UACP,CAAC,YACC,QAAQ,0BAA0B,KAAK,iBACvC,CAAC,eAAe,IAAI,QAAQ,EAAE;AAAA,QAClC;AACN,cAAM,YAAY,sBAAsB;AAAA,UACtC,CAAC,YACC,QAAQ,iBAAiB,KAAK,gBAC9B,CAAC,aAAa,IAAI,QAAQ,YAAY;AAAA,QAC1C;AAEA,YACE,sBAAsB,WAAW,KACjC,UAAU,WAAW,KACrB,KAAK,kBAAkB,QACvB;AACA,gBAAM,UAAU,UAAU,CAAC;AAC3B,gBAAM,SAAS;AAAA,YACb;AAAA;AAAA;AAAA;AAAA;AAAA,YAKA,CAAC,KAAK,cAAc,QAAQ,EAAE;AAAA,UAChC;AACA,gBAAM,yBAAyB,UAAU,QAAQ,IAAI,MAAM;AAAA,YACzD,QAAQ;AAAA,UACV,CAAC;AACD,yBAAe,IAAI,QAAQ,EAAE;AAC7B;AAAA,QACF;AAEA,cAAM,qBAAqB,UAAU,QAAQ,IAAI,MAAM;AAAA,UACrD,QACE,sBAAsB,WAAW,KACjC,KAAK,kBAAkB,SACnB,YACA;AAAA,QACR,CAAC;AAAA,MACH;AAEA,YAAM,OAAM,oBAAI,KAAK,GAAE,YAAY;AACnC,iBAAW,WAAW,UAAU;AAC9B,YACE,eAAe,IAAI,QAAQ,EAAE,KAC5B,QAAQ,iBAAiB,aACxB,aAAa,IAAI,QAAQ,YAAY,GACvC;AACA;AAAA,QACF;AACA,cAAM,SAAS;AAAA,UACb;AAAA;AAAA;AAAA;AAAA;AAAA,UAKA,CAAC,KAAK,KAAK,QAAQ,EAAE;AAAA,QACvB;AAAA,MACF;AAAA,IACF,CAAC;AAAA,EACH,CAAC;AAED,SAAO,EAAE,SAAS,UAAU,MAAM,6BAA6B,MAAM,EAAE;AACzE;AAEA,eAAsB,6BACpB,QACmD;AACnD,QAAM,UAAU,MAAM,wBAAwB,MAAM;AACpD,SAAO,MAAM;AAAA,IACX,OAAO,aAAa,MAAM,oBAAoB,UAAU,OAAO;AAAA,EACjE;AACF;AAEA,eAAsB,2BACpB,QACwC;AACxC,QAAM,UAAU,MAAM,wBAAwB,MAAM;AACpD,SAAO,MAAM,4BAA4B,QAAQ,OAAO;AAC1D;AAEA,eAAsB,+BACpB,SACA,WACwC;AACxC,SAAO,MAAM;AAAA,IACX,OAAO,aACL,MAAM,0BAA0B,UAAU,SAAS,SAAS;AAAA,EAChE;AACF;AAEA,eAAsB,mCACpB,gBACiB;AACjB,QAAM,SAAS,yBAAyB,cAAc;AACtD,MAAI,WAAW,UAAa,OAAO,SAAS,WAAW;AACrD,UAAM,IAAI;AAAA,MACR,kDAAkD,cAAc;AAAA,IAClE;AAAA,EACF;AAEA,QAAM,UAAU,MAAM,2BAA2B,MAAM;AACvD,MAAI,CAAC,QAAQ,UAAU,QAAQ,WAAW,WAAW;AACnD,UAAM,IAAI,MAAM,0CAA0C,cAAc,EAAE;AAAA,EAC5E;AACA,MAAI,QAAQ,WAAW,YAAY;AACjC,UAAM,IAAI;AAAA,MACR,qEAAqE,cAAc;AAAA,IACrF;AAAA,EACF;AAEA,SAAO,QAAQ;AACjB;AAEA,eAAsB,2BAA2B,OAIN;AACzC,MAAI,MAAM,UAAU,WAAW,SAAS,GAAG;AACzC,UAAM,IAAI;AAAA,MACR;AAAA,IACF;AAAA,EACF;AACA,MAAI,4BAA4B,KAAK,MAAM,SAAS,GAAG;AACrD,UAAM,IAAI,MAAM,8CAA8C;AAAA,EAChE;AAEA,QAAM,UAAU,MAAM,wBAAwB,MAAM,MAAM;AAC1D,QAAM,MAAM,QAAQ,YAAY,EAAE,WAAW,KAAK,CAAC;AACnD,QAAM,aAAa,QAAQ,MAAM,SAAS;AAC1C,QAAM,cAAc,MAAM,KAAK,UAAU;AACzC,MAAI,CAAC,YAAY,OAAO,GAAG;AACzB,UAAM,IAAI,MAAM,uCAAuC,MAAM,SAAS,EAAE;AAAA,EAC1E;AACA,QAAM,iBAAiB,WAAW,MAAM,QAAQ,EAAE,GAAG,EAAE,KAAK;AAC5D,QAAM,qBAAqB;AAAA,IACzB,MAAM,MAAM;AAAA,EACd;AACA,QAAM,aAAa;AAAA,IACjB,QAAQ;AAAA,IACR;AAAA,EACF;AAEA,SAAO,MAAM,yBAAyB,QAAQ,IAAI,SAAS,YAAY;AACrE,UAAM,MAAM,QAAQ,UAAU,GAAG,EAAE,WAAW,KAAK,CAAC;AACpD,UAAM;AAAA,MACJ,MAAM,SAAS,QAAQ,UAAU,CAAC;AAAA,MAClC,QAAQ;AAAA,IACV;AACA,UAAM,SAAS,YAAY,YAAY,UAAU,aAAa;AAC9D,UAAM,oBAAoB,MAAM,SAAS,UAAU,GAAG,QAAQ,UAAU;AACxE,UAAM,aAAa,MAAM;AAAA,MACvB,QAAQ;AAAA,MACR;AAAA,IACF;AACA,UAAM,UAAU,MAAM;AAAA,MACpB,OAAO,aAAa;AAClB,cAAM,SAAS,YAAY,YAAY;AACrC,gBAAM;AAAA,YACJ;AAAA,YACA,QAAQ;AAAA,YACR;AAAA,UACF;AAAA,QACF,CAAC;AACD,eAAO,MAAM;AAAA,UACX;AAAA,UACA;AAAA,UACA;AAAA,QACF;AAAA,MACF;AAAA,IACF;AAEA,UAAM,+BAA+B,OAAO;AAC5C,WAAO;AAAA,EACT,CAAC;AACH;AAEA,eAAsB,qCAAqC,OAEtC;AACnB,MAAI,MAAM,OAAO,SAAS,WAAW;AACnC,UAAM,IAAI,MAAM,4CAA4C;AAAA,EAC9D;AAEA,QAAM,UAAU,MAAM,wBAAwB,MAAM,MAAM;AAC1D,SAAO,MAAM,yBAAyB,QAAQ,IAAI,SAAS,YAAY;AACrE,UAAM,UAAU,MAAM,4BAA4B,MAAM,QAAQ,OAAO;AACvE,UAAM,UAAU,MAAM;AAAA,MACpB,QAAQ;AAAA,IACV;AACA,UAAM,gBAAgB,MAAM;AAAA,MAC1B,QAAQ;AAAA,MACR,QAAQ;AAAA,IACV;AAEA,UAAM,qCAAqC,OAAO,aAAa;AAC7D,YAAM,yBAAyB,UAAU,QAAQ,IAAI,eAAe;AAAA,QAClE,QAAQ;AAAA,MACV,CAAC;AAAA,IACH,CAAC;AAED,WAAO;AAAA,EACT,CAAC;AACH;AAEA,eAAsB,4CACpB,aACkB;AAClB,MAAK,MAAM,8BAA8B,WAAW,MAAO,QAAW;AACpE,WAAO;AAAA,EACT;AAEA,QAAM,cAAc,MAAM;AAAA,IACxB;AAAA,IACA;AAAA,EACF;AACA,MAAI,gBAAgB,QAAW;AAC7B,WAAO;AAAA,EACT;AAEA,QAAM,IAAI,qBAAqB,WAAW,EAAE;AAAA,IAC1C,OAAO,aAAa;AAClB,YAAM,SAAS,0BAA0B;AAAA,IAC3C;AAAA,IACA,EAAE,4BAA4B,UAAU;AAAA,EAC1C;AACA,SAAO;AACT;AAEA,eAAsB,8BAA8B,OAET;AACzC,QAAM,UAAU,MAAM,wBAAwB,MAAM,MAAM;AAC1D,QAAM,UAAU,MAAM,4BAA4B,MAAM,QAAQ,OAAO;AAEvE,QAAM,yBAAyB,QAAQ,IAAI,SAAS,YAAY;AAC9D,UAAM,GAAG,QAAQ,MAAM,EAAE,OAAO,KAAK,CAAC;AACtC,UAAM,qCAAqC,OAAO,aAAa;AAC7D,YAAM,SAAS,IAAI,6CAA6C;AAAA,QAC9D,QAAQ;AAAA,MACV,CAAC;AAAA,IACH,CAAC;AACD,UAAM,+BAA+B,OAAO;AAAA,EAC9C,CAAC;AAED,SAAO,EAAE,GAAG,SAAS,QAAQ,OAAO,QAAQ,UAAU;AACxD;AAEA,eAAsB,4BAA4B,OAGP;AACzC,QAAM,UAAU,MAAM,wBAAwB,MAAM,MAAM;AAC1D,QAAM,UAAU,MAAM,4BAA4B,MAAM,QAAQ,OAAO;AACvE,QAAM,qBAAqB,mCAAmC,MAAM,EAAE;AACtE,QAAM,aAAa;AAAA,IACjB,QAAQ;AAAA,IACR;AAAA,EACF;AAEA,SAAO,MAAM,yBAAyB,QAAQ,IAAI,SAAS,YAAY;AACrE,UAAM,MAAM,QAAQ,UAAU,GAAG,EAAE,WAAW,KAAK,CAAC;AACpD,UAAM;AAAA,MACJ,MAAM,SAAS,QAAQ,UAAU,CAAC;AAAA,MAClC,QAAQ;AAAA,IACV;AACA,QAAI,MAAM,WAAW,UAAU,GAAG;AAChC,YAAM,IAAI;AAAA,QACR,0CAA0C,kBAAkB;AAAA,MAC9D;AAAA,IACF;AACA,UAAM,OAAO,QAAQ,MAAM,UAAU;AACrC,UAAM,oBAAoB,MAAM,SAAS,UAAU,GAAG,QAAQ,UAAU;AACxE,UAAM,aAAa,MAAM;AAAA,MACvB,QAAQ;AAAA,MACR;AAAA,IACF;AACA,UAAM,QAAQ,MAAM;AAAA,MAClB,OAAO,aAAa;AAClB,cAAM,SAAS;AAAA,UACb;AAAA,UACA,CAAC,oBAAoB,QAAQ,EAAE;AAAA,QACjC;AACA,cAAM,yBAAyB,UAAU,QAAQ,IAAI,YAAY;AAAA,UAC/D,QAAQ;AAAA,QACV,CAAC;AACD,eAAO,MAAM;AAAA,UACX;AAAA,UACA;AAAA,UACA,QAAQ;AAAA,QACV;AAAA,MACF;AAAA,IACF;AAEA,UAAM,+BAA+B,OAAO;AAC5C,WAAO;AAAA,EACT,CAAC;AACH;AAEA,eAAe,qCACb,WACY;AACZ,QAAM,WAAW,MAAM;AAAA,IACrB,iCAAiC;AAAA,IACjC;AAAA,EACF;AAEA,MAAI;AACF,UAAM,sCAAsC,QAAQ;AACpD,UAAM,wCAAwC,QAAQ;AACtD,WAAO,MAAM,UAAU,QAAQ;AAAA,EACjC,UAAE;AACA,UAAM,SAAS,MAAM;AAAA,EACvB;AACF;AAEA,eAAe,oBACb,UACA,SAC0C;AAC1C,QAAM,OAAO,MAAM,wBAAwB,UAAU,QAAQ,EAAE;AAC/D,QAAM,WAA4C,CAAC;AACnD,aAAW,OAAO,MAAM;AACtB,UAAM,eAAe,UAAU,KAAK,eAAe;AACnD,aAAS;AAAA,MACP;AAAA,QACE;AAAA,QACA;AAAA,QACA,MAAM,WAAW,KAAK,QAAQ,YAAY,YAAY,CAAC;AAAA,MACzD;AAAA,IACF;AAAA,EACF;AACA,SAAO;AACT;AAEA,eAAe,uBACb,UACA,SAC0C;AAC1C,QAAM,OAAO,MAAM,wBAAwB,UAAU,QAAQ,EAAE;AAC/D,SAAO,KAAK,IAAI,CAAC,QAAQ,wBAAwB,SAAS,KAAK,KAAK,CAAC;AACvE;AAEA,eAAe,wBACb,UACA,WACmB;AACnB,SAAO,MAAM,SAAS;AAAA,IACpB;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,IAQA,CAAC,SAAS;AAAA,IACV,CAAC,QAAQ;AAAA,EACX;AACF;AAEA,eAAe,mCACb,UACA,WACA,MACe;AACf,QAAM,WAAW,MAAM,SAAS;AAAA,IAC9B;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,IAUA,CAAC,WAAW,KAAK,YAAY;AAAA,IAC7B,CAAC,QAAQ,UAAU,KAAK,IAAI;AAAA,EAC9B;AACA,MAAI,aAAa,QAAW;AAC1B,UAAM,yBAAyB,UAAU,UAAU,MAAM;AAAA,MACvD,QAAQ;AAAA,IACV,CAAC;AACD;AAAA,EACF;AAEA,QAAM,qBAAqB,UAAU,WAAW,MAAM,EAAE,QAAQ,UAAU,CAAC;AAC7E;AAEA,eAAe,qBACb,UACA,WACA,MACA,SACe;AACf,QAAM,OAAM,oBAAI,KAAK,GAAE,YAAY;AACnC,QAAM,SAAS;AAAA,IACb;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,IAOA;AAAA,MACE;AAAA,MACA,MAAM,mCAAmC,UAAU,SAAS;AAAA,MAC5D,KAAK;AAAA,MACL,QAAQ;AAAA,MACR,KAAK,iBAAiB;AAAA,MACtB,KAAK;AAAA,MACL,KAAK,MAAM,KAAK,OAAO;AAAA,MACvB;AAAA,MACA;AAAA,MACA;AAAA,IACF;AAAA,EACF;AACF;AAEA,eAAe,yBACb,UACA,WACA,MACA,SACe;AACf,QAAM,OAAM,oBAAI,KAAK,GAAE,YAAY;AACnC,QAAM,SAAS;AAAA,IACb;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,IAUA;AAAA,MACE,QAAQ;AAAA,MACR,KAAK,iBAAiB;AAAA,MACtB,KAAK;AAAA,MACL,KAAK,MAAM,KAAK,OAAO;AAAA,MACvB;AAAA,MACA;AAAA,MACA;AAAA,IACF;AAAA,EACF;AACF;AAEA,eAAe,oCACb,UACA,SACA,cACwC;AACxC,QAAM,UAAU,MAAM,SAAS;AAAA,IAC7B;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,IAYA,CAAC,QAAQ,IAAI,YAAY;AAAA,IACzB,CAAC,QAAQ,wBAAwB,SAAS,KAAK,IAAI;AAAA,EACrD;AACA,MAAI,YAAY,QAAW;AACzB,UAAM,IAAI;AAAA,MACR,+CAA+C,YAAY;AAAA,IAC7D;AAAA,EACF;AACA,SAAO;AACT;AAEA,eAAe,gCACb,UACA,SACA,UACwC;AACxC,QAAM,MAAM,MAAM,SAAS;AAAA,IACzB;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,IAOA,CAAC,QAAQ,IAAI,QAAQ;AAAA,IACrB,CAACA,SAAQA;AAAA,EACX;AACA,MAAI,QAAQ,QAAW;AACrB,UAAM,IAAI,MAAM,uCAAuC,QAAQ,EAAE;AAAA,EACnE;AACA,QAAM,eAAe,UAAU,KAAK,eAAe;AACnD,SAAO;AAAA,IACL;AAAA,IACA;AAAA,IACA,MAAM,WAAW,KAAK,QAAQ,YAAY,YAAY,CAAC;AAAA,EACzD;AACF;AAEA,eAAe,0BACb,UACA,SACA,WACwC;AACxC,QAAM,MAAM,MAAM,SAAS;AAAA,IACzB;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,IAOA,CAAC,QAAQ,IAAI,SAAS;AAAA,IACtB,CAACA,SAAQA;AAAA,EACX;AACA,MAAI,QAAQ,QAAW;AACrB,UAAM,IAAI,MAAM,uCAAuC,SAAS,EAAE;AAAA,EACpE;AACA,QAAM,eAAe,UAAU,KAAK,eAAe;AACnD,SAAO;AAAA,IACL;AAAA,IACA;AAAA,IACA,MAAM,WAAW,KAAK,QAAQ,YAAY,YAAY,CAAC;AAAA,EACzD;AACF;AAEA,eAAe,4BACb,QACA,SACwC;AACxC,MAAI,OAAO,SAAS,aAAa,OAAO,oBAAoB,QAAW;AACrE,UAAM,IAAI,MAAM,4CAA4C;AAAA,EAC9D;AACA,SAAO,MAAM;AAAA,IACX,OAAO,aACL,MAAM;AAAA,MACJ;AAAA,MACA;AAAA,MACA,OAAO;AAAA,IACT;AAAA,EACJ;AACF;AAEA,SAAS,wBACP,SACA,KACA,QAC+B;AAC/B,QAAM,WAAW,UAAU,KAAK,WAAW;AAC3C,QAAM,eAAe,UAAU,KAAK,eAAe;AACnD,QAAM,iBAAiB;AAAA,IACrB,kBAAkB,KAAK,QAAQ,KAAK;AAAA,EACtC;AACA,SAAO;AAAA,IACL,WAAW,UAAU,KAAK,YAAY;AAAA,IACtC;AAAA,IACA,IAAI,UAAU,KAAK,IAAI;AAAA,IACvB,WAAW,QAAQ;AAAA,IACnB,YAAY,QAAQ;AAAA,IACpB,GAAG;AAAA,MACD;AAAA,MACA;AAAA,MACA;AAAA,IACF;AAAA,IACA,GAAG,oBAAoB,KAAK,sBAAsB,iBAAiB;AAAA,IACnE,GAAG,oBAAoB,KAAK,kBAAkB,cAAc;AAAA,IAC5D,GAAG,oBAAoB,KAAK,mBAAmB,eAAe;AAAA,IAC9D,MAAM,KAAK,QAAQ,YAAY,YAAY;AAAA,IAC3C;AAAA,IACA;AAAA,IACA,QAAQ,SAAS,iBAAiB;AAAA,IAClC,WAAW,UAAU,KAAK,YAAY;AAAA,IACtC,KAAK,GAAG,QAAQ,GAAG,QAAQ,QAAQ;AAAA,EACrC;AACF;AAEA,SAAS,0BACP,UACA,MAC2C;AAC3C,SAAO,SACJ,OAAO,CAAC,YAAY,QAAQ,iBAAiB,KAAK,YAAY,EAC9D,KAAK,CAAC,GAAG,MAAM,qBAAqB,CAAC,IAAI,qBAAqB,CAAC,CAAC,EAAE,CAAC;AACxE;AAEA,SAAS,qBAAqB,SAAgD;AAC5E,MAAI,QAAQ,WAAW,WAAW;AAChC,WAAO;AAAA,EACT;AACA,MAAI,QAAQ,WAAW,YAAY;AACjC,WAAO;AAAA,EACT;AACA,SAAO;AACT;AAEA,eAAe,cACb,MACyC;AACzC,QAAM,gBAA0B,CAAC;AACjC,QAAM,qBAAqB,MAAM,MAAM,aAAa;AACpD,QAAM,QAAwC,CAAC;AAC/C,aAAW,gBAAgB,cAAc,KAAK,CAAC,GAAG,MAAM,EAAE,cAAc,CAAC,CAAC,GAAG;AAC3E,UAAM;AAAA,MACJ,MAAM;AAAA,QACJ;AAAA,QACA;AAAA,MACF;AAAA,IACF;AAAA,EACF;AACA,SAAO;AACT;AAEA,eAAe,mDACb,MACA,cACuC;AACvC,QAAM,4CAA4C,KAAK,MAAM,YAAY,CAAC;AAC1E,SAAO,MAAM,0BAA0B,MAAM,YAAY;AAC3D;AAEA,eAAe,qBACb,MACA,WACA,OACe;AACf,MAAI;AACJ,MAAI;AACF,cAAU,MAAM,QAAQ,SAAS;AAAA,EACnC,SAAS,OAAO;AACd,QAAI,YAAY,KAAK,KAAK,MAAM,SAAS,UAAU;AACjD;AAAA,IACF;AACA,UAAM;AAAA,EACR;AACA,mBAAiB,SAAS,SAAS;AACjC,UAAM,OAAO,KAAK,WAAW,MAAM,IAAI;AACvC,QAAI,MAAM,YAAY,GAAG;AACvB,YAAM,qBAAqB,MAAM,MAAM,KAAK;AAAA,IAC9C,WACE,MAAM,OAAO,KACb,MAAM,KAAK,SAAS,4BAA4B,GAChD;AACA,YAAM,KAAK,SAAS,MAAM,IAAI,EAAE,QAAQ,QAAQ,GAAG,CAAC;AAAA,IACtD;AAAA,EACF;AACF;AAEA,eAAe,0BACb,MACA,cACuC;AACvC,QAAM,OAAO,KAAK,MAAM,YAAY;AACpC,QAAM,WAAW,MAAM,KAAK,IAAI;AAChC,QAAM,gBAAgB,MAAM,8BAA8B,IAAI;AAC9D,SAAO;AAAA,IACL,SAAS,SAAS;AAAA,IAClB,GAAI,kBAAkB,SAAY,CAAC,IAAI,EAAE,cAAc;AAAA,IACvD;AAAA,IACA;AAAA,IACA,MAAM,SAAS;AAAA,EACjB;AACF;AAEA,eAAe,8BACb,MAC6B;AAC7B,MAAI;AACF,WAAO,MAAM,6BAA6B,IAAI;AAAA,EAChD,QAAQ;AACN,WAAO;AAAA,EACT;AACF;AAEA,SAAS,mCAAmC,cAA8B;AACxE,QAAM,aAAa,aAChB,QAAQ,QAAQ,GAAG,EACnB,QAAQ,eAAe,EAAE;AAC5B,MACE,eAAe,MACf,WAAW,YAAY,KACvB,WAAW,MAAM,GAAG,EAAE,SAAS,IAAI,GACnC;AACA,UAAM,IAAI;AAAA,MACR;AAAA,IACF;AAAA,EACF;AACA,MAAI,CAAC,WAAW,SAAS,4BAA4B,GAAG;AACtD,UAAM,IAAI,MAAM,6CAA6C;AAAA,EAC/D;AACA,SAAO;AACT;AAEA,SAAS,2BACP,MACA,cACQ;AACR,QAAM,OAAO,QAAQ,MAAM,YAAY;AACvC,QAAM,MAAM,SAAS,QAAQ,IAAI,GAAG,IAAI;AACxC,MAAI,QAAQ,MAAM,IAAI,WAAW,IAAI,KAAK,WAAW,GAAG,GAAG;AACzD,UAAM,IAAI,MAAM,oDAAoD;AAAA,EACtE;AACA,SAAO;AACT;AAEA,eAAe,oBAAoB,MAAc,MAA6B;AAC5E,QAAM,eAAe,MAAM,SAAS,IAAI;AACxC,QAAM,MAAM,SAAS,cAAc,IAAI;AACvC,MAAI,IAAI,WAAW,IAAI,KAAK,WAAW,GAAG,GAAG;AAC3C,UAAM,IAAI,MAAM,kDAAkD;AAAA,EACpE;AACF;AAEA,eAAe,sCACb,UACe;AACf,QAAM,UAAU,MAAM,SAAS;AAAA,IAC7B;AAAA,IACA;AAAA,IACA,CAAC,QAAQ,UAAU,KAAK,MAAM;AAAA,EAChC;AACA,QAAM,YAAY,IAAI,IAAI,OAAO;AACjC,QAAM,YAA8C;AAAA,IAClD,CAAC,UAAU,iCAAiC;AAAA,IAC5C,CAAC,4BAA4B,MAAM;AAAA,IACnC,CAAC,kBAAkB,SAAS;AAAA,IAC5B,CAAC,sBAAsB,SAAS;AAAA,IAChC,CAAC,mBAAmB,MAAM;AAAA,EAC5B;AACA,aAAW,CAAC,MAAM,UAAU,KAAK,WAAW;AAC1C,QAAI,CAAC,UAAU,IAAI,IAAI,GAAG;AACxB,YAAM,SAAS;AAAA,QACb,2CAA2C,IAAI,IAAI,UAAU;AAAA,MAC/D;AAAA,IACF;AAAA,EACF;AACF;AAEA,eAAe,wCACb,UACe;AACf,MAAI,MAAM,yCAAyC,QAAQ,GAAG;AAC5D,UAAM,qCAAqC,QAAQ;AAAA,EACrD;AACA,QAAM,SAAS;AAAA,IACb;AAAA;AAAA;AAAA;AAAA,EAIF;AACF;AAEA,eAAe,yCACb,UACkB;AAClB,QAAM,UAAU,MAAM,SAAS;AAAA,IAC7B;AAAA,IACA;AAAA,IACA,CAAC,SAAS;AAAA,MACR,MAAM,UAAU,KAAK,MAAM;AAAA,MAC3B,QAAQ,UAAU,KAAK,QAAQ,MAAM;AAAA,IACvC;AAAA,EACF;AACA,aAAW,SAAS,SAAS;AAC3B,QAAI,CAAC,MAAM,QAAQ;AACjB;AAAA,IACF;AACA,UAAM,UAAU,MAAM,SAAS;AAAA,MAC7B,qBAAqB,iBAAiB,MAAM,IAAI,CAAC;AAAA,MACjD;AAAA,MACA,CAAC,QAAQ,UAAU,KAAK,MAAM;AAAA,IAChC;AACA,QACE,QAAQ,WAAW,KACnB,QAAQ,CAAC,MAAM,gBACf,QAAQ,CAAC,MAAM,iBACf;AACA,aAAO;AAAA,IACT;AAAA,EACF;AACA,SAAO;AACT;AAEA,eAAe,qCACb,UACe;AACf,QAAM,SAAS,YAAY,YAAY;AACrC,UAAM,SAAS;AAAA,MACb;AAAA,IACF;AACA,UAAM,SAAS,IAAI;AAAA;AAAA,EAErB,kCAAkC;AAAA;AAAA,KAE/B;AACD,UAAM,SAAS,IAAI;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,KAUlB;AACD,UAAM,SAAS,IAAI,gDAAgD;AAAA,EACrE,CAAC;AACH;AAEA,SAAS,iBAAiB,OAAuB;AAC/C,SAAO,IAAI,MAAM,QAAQ,OAAO,IAAI,CAAC;AACvC;AAEA,eAAe,mCACb,UACA,WACiB;AACjB,WAAS,UAAU,GAAG,UAAU,IAAI,WAAW,GAAG;AAChD,UAAM,WAAW,YAAY,eAAe,EAAE,SAAS,KAAK;AAC5D,UAAM,WAAW,MAAM,SAAS;AAAA,MAC9B;AAAA,MACA,CAAC,WAAW,QAAQ;AAAA,MACpB,CAAC,QAAQ,UAAU,KAAK,WAAW;AAAA,IACrC;AACA,QAAI,aAAa,QAAW;AAC1B,aAAO;AAAA,IACT;AAAA,EACF;AACA,QAAM,IAAI,MAAM,iDAAiD;AACnE;AAEA,eAAe,WAAW,MAAgC;AACxD,MAAI;AACF,UAAM,KAAK,IAAI;AACf,WAAO;AAAA,EACT,SAAS,OAAO;AACd,QAAI,YAAY,KAAK,KAAK,MAAM,SAAS,UAAU;AACjD,aAAO;AAAA,IACT;AACA,UAAM;AAAA,EACR;AACF;AAEA,SAAS,uBAAuB,OAA8C;AAC5E,MAAI,UAAU,cAAc,UAAU,aAAa,UAAU,WAAW;AACtE,WAAO;AAAA,EACT;AACA,SAAO;AACT;AAEA,SAAS,oBACP,KACA,OACA,WAC4B;AAC5B,QAAM,QAAQ,IAAI,KAAK;AACvB,MAAI,OAAO,UAAU,UAAU;AAC7B,WAAO,CAAC;AAAA,EACV;AACA,SAAO,EAAE,CAAC,SAAS,GAAG,MAAM;AAC9B;AAEA,SAAS,oBACP,KACA,OACA,WAC4B;AAC5B,QAAM,QAAQ,kBAAkB,KAAK,KAAK;AAC1C,MAAI,UAAU,QAAW;AACvB,WAAO,CAAC;AAAA,EACV;AACA,SAAO,EAAE,CAAC,SAAS,GAAG,MAAM;AAC9B;","names":["row"]}

package/dist/library/query-helpers.d.ts

@@ -0,0 +1,45 @@
+import { ReadonlyDocument } from '../document/directory/types.js';
+import { ArchiveLibrarySource } from '../retrieval/query/archive-view/types.js';
+import { WikiGraphLibraryArchiveRecord } from './membership.js';
+import { ParsedWikiGraphLibraryUri } from './registry.js';
+import '../text/source/meta.js';
+import 'zod';
+import '../text/source/toc.js';
+import '../text/source/types.js';
+import '../document/database.js';
+import 'sqlite3';
+import '../document/types.js';
+import '../document/text-streams/serial.js';
+import '../document/text-streams/draft.js';
+import '../document/text-streams/types.js';
+import '../document/stores/chunk.js';
+import '../document/stores/types.js';
+import '../document/stores/fragment-group.js';
+import '../document/stores/graph-build-parameter.js';
+import '../document/stores/mention-link.js';
+import '../document/stores/mention.js';
+import '../document/stores/object-metadata.js';
+import '../document/stores/reading-edge.js';
+import '../document/stores/serial.js';
+import '../document/stores/snake/chunk.js';
+import '../document/stores/snake/core.js';
+import '../document/stores/snake/edge.js';
+import '../graph/reading.js';
+import '../document/chapter/types.js';
+
+declare function createSortedArchiveIds(result: {
+    readonly objectHits: readonly {
+        readonly archiveId: number;
+    }[];
+    readonly textHits: readonly {
+        readonly archiveId: number;
+    }[];
+}): readonly number[];
+declare function resolveReadableIndexedArchive(target: ParsedWikiGraphLibraryUri, archiveId: number, options: {
+    readonly operation: string;
+}): Promise<WikiGraphLibraryArchiveRecord>;
+declare function readLibraryArchiveDocument<T>(archive: WikiGraphLibraryArchiveRecord, operation: (document: ReadonlyDocument) => Promise<T>): Promise<T>;
+declare function createLibrarySource(archive: WikiGraphLibraryArchiveRecord): ArchiveLibrarySource;
+declare function isReadableLibraryArchive(archive: WikiGraphLibraryArchiveRecord): boolean;
+
+export { createLibrarySource, createSortedArchiveIds, isReadableLibraryArchive, readLibraryArchiveDocument, resolveReadableIndexedArchive };

package/dist/library/query-helpers.js

@@ -0,0 +1,45 @@
+import { WikiGraphArchiveFile } from "../storage/wikg/index.js";
+import {
+  getWikiGraphLibraryArchiveById
+} from "./membership.js";
+import {
+  resolveWikiGraphLibrary
+} from "./registry.js";
+function createSortedArchiveIds(result) {
+  return [
+    .../* @__PURE__ */ new Set([
+      ...result.objectHits.map((hit) => hit.archiveId),
+      ...result.textHits.map((hit) => hit.archiveId)
+    ])
+  ].sort((left, right) => left - right);
+}
+async function resolveReadableIndexedArchive(target, archiveId, options) {
+  const library = await resolveWikiGraphLibrary(target);
+  const archive = await getWikiGraphLibraryArchiveById(library, archiveId);
+  if (!isReadableLibraryArchive(archive)) {
+    throw new Error(
+      `Wiki Graph library archive ${archiveId} is not readable while ${options.operation}.`
+    );
+  }
+  return archive;
+}
+async function readLibraryArchiveDocument(archive, operation) {
+  return await new WikiGraphArchiveFile(archive.path).readDocument(operation);
+}
+function createLibrarySource(archive) {
+  return {
+    archiveId: archive.id,
+    libraryArchiveUri: archive.uri
+  };
+}
+function isReadableLibraryArchive(archive) {
+  return archive.exists && archive.status === "present";
+}
+export {
+  createLibrarySource,
+  createSortedArchiveIds,
+  isReadableLibraryArchive,
+  readLibraryArchiveDocument,
+  resolveReadableIndexedArchive
+};
+//# sourceMappingURL=query-helpers.js.map

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

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/library/query-helpers.ts"],"sourcesContent":["import { WikiGraphArchiveFile } from \"../storage/wikg/index.js\";\nimport type { ReadonlyDocument } from \"../document/index.js\";\nimport type { ArchiveLibrarySource } from \"../retrieval/query/archive-view/types.js\";\nimport {\n  getWikiGraphLibraryArchiveById,\n  type WikiGraphLibraryArchiveRecord,\n} from \"./membership.js\";\nimport {\n  resolveWikiGraphLibrary,\n  type ParsedWikiGraphLibraryUri,\n} from \"./registry.js\";\n\nexport function createSortedArchiveIds(result: {\n  readonly objectHits: readonly { readonly archiveId: number }[];\n  readonly textHits: readonly { readonly archiveId: number }[];\n}): readonly number[] {\n  return [\n    ...new Set([\n      ...result.objectHits.map((hit) => hit.archiveId),\n      ...result.textHits.map((hit) => hit.archiveId),\n    ]),\n  ].sort((left, right) => left - right);\n}\n\nexport async function resolveReadableIndexedArchive(\n  target: ParsedWikiGraphLibraryUri,\n  archiveId: number,\n  options: { readonly operation: string },\n): Promise<WikiGraphLibraryArchiveRecord> {\n  const library = await resolveWikiGraphLibrary(target);\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 ${options.operation}.`,\n    );\n  }\n  return archive;\n}\n\nexport async function readLibraryArchiveDocument<T>(\n  archive: WikiGraphLibraryArchiveRecord,\n  operation: (document: ReadonlyDocument) => Promise<T>,\n): Promise<T> {\n  return await new WikiGraphArchiveFile(archive.path).readDocument(operation);\n}\n\nexport function createLibrarySource(\n  archive: WikiGraphLibraryArchiveRecord,\n): ArchiveLibrarySource {\n  return {\n    archiveId: archive.id,\n    libraryArchiveUri: archive.uri,\n  };\n}\n\nexport function isReadableLibraryArchive(\n  archive: WikiGraphLibraryArchiveRecord,\n): boolean {\n  return archive.exists && archive.status === \"present\";\n}\n"],"mappings":"AAAA,SAAS,4BAA4B;AAGrC;AAAA,EACE;AAAA,OAEK;AACP;AAAA,EACE;AAAA,OAEK;AAEA,SAAS,uBAAuB,QAGjB;AACpB,SAAO;AAAA,IACL,GAAG,oBAAI,IAAI;AAAA,MACT,GAAG,OAAO,WAAW,IAAI,CAAC,QAAQ,IAAI,SAAS;AAAA,MAC/C,GAAG,OAAO,SAAS,IAAI,CAAC,QAAQ,IAAI,SAAS;AAAA,IAC/C,CAAC;AAAA,EACH,EAAE,KAAK,CAAC,MAAM,UAAU,OAAO,KAAK;AACtC;AAEA,eAAsB,8BACpB,QACA,WACA,SACwC;AACxC,QAAM,UAAU,MAAM,wBAAwB,MAAM;AACpD,QAAM,UAAU,MAAM,+BAA+B,SAAS,SAAS;AACvE,MAAI,CAAC,yBAAyB,OAAO,GAAG;AACtC,UAAM,IAAI;AAAA,MACR,8BAA8B,SAAS,0BAA0B,QAAQ,SAAS;AAAA,IACpF;AAAA,EACF;AACA,SAAO;AACT;AAEA,eAAsB,2BACpB,SACA,WACY;AACZ,SAAO,MAAM,IAAI,qBAAqB,QAAQ,IAAI,EAAE,aAAa,SAAS;AAC5E;AAEO,SAAS,oBACd,SACsB;AACtB,SAAO;AAAA,IACL,WAAW,QAAQ;AAAA,IACnB,mBAAmB,QAAQ;AAAA,EAC7B;AACF;AAEO,SAAS,yBACd,SACS;AACT,SAAO,QAAQ,UAAU,QAAQ,WAAW;AAC9C;","names":[]}

package/dist/library/query.d.ts

@@ -0,0 +1,45 @@
+import { ArchiveFindOptions, ArchiveFindResult, ArchiveRelatedOptions, ArchiveRelatedResult, ArchiveEvidenceOptions, ArchiveEvidence, ArchiveCollectionOptions, ArchiveCollectionResult, ArchivePack, ArchivePage, ArchiveLibrarySource } from '../retrieval/query/archive-view/types.js';
+import { readArchivePage } from '../retrieval/query/archive-view/pages.js';
+import { ParsedWikiGraphLibraryUri } from './registry.js';
+import '../document/types.js';
+import '../text/source/meta.js';
+import 'zod';
+import '../graph/reading.js';
+import '../document/directory/types.js';
+import '../text/source/toc.js';
+import '../text/source/types.js';
+import '../document/database.js';
+import 'sqlite3';
+import '../document/text-streams/serial.js';
+import '../document/text-streams/draft.js';
+import '../document/text-streams/types.js';
+import '../document/stores/chunk.js';
+import '../document/stores/types.js';
+import '../document/stores/fragment-group.js';
+import '../document/stores/graph-build-parameter.js';
+import '../document/stores/mention-link.js';
+import '../document/stores/mention.js';
+import '../document/stores/object-metadata.js';
+import '../document/stores/reading-edge.js';
+import '../document/stores/serial.js';
+import '../document/stores/snake/chunk.js';
+import '../document/stores/snake/core.js';
+import '../document/stores/snake/edge.js';
+import '../document/chapter/types.js';
+import '../external/wikipage/types.js';
+import '../external/wikipage/wikimedia-client/wiki.js';
+import '../external/wikipage/fetch-log.js';
+
+declare function findWikiGraphLibraryObjects(target: ParsedWikiGraphLibraryUri, query: string, options?: ArchiveFindOptions): Promise<ArchiveFindResult>;
+declare function listWikiGraphLibraryObjects(target: ParsedWikiGraphLibraryUri, options?: ArchiveCollectionOptions): Promise<ArchiveCollectionResult>;
+declare function readWikiGraphLibraryPage(target: ParsedWikiGraphLibraryUri, objectUri: string, options?: Parameters<typeof readArchivePage>[2]): Promise<ArchivePage>;
+declare function listWikiGraphLibraryEvidence(target: ParsedWikiGraphLibraryUri, objectUri: string, options?: ArchiveEvidenceOptions): Promise<ArchiveEvidence>;
+declare function listRelatedWikiGraphLibraryObjects(target: ParsedWikiGraphLibraryUri, objectUri: string, options?: ArchiveRelatedOptions): Promise<ArchiveRelatedResult>;
+declare function packWikiGraphLibraryContext(target: ParsedWikiGraphLibraryUri, objectUri: string, budget: number): Promise<ArchivePack>;
+declare function resolveWikiGraphLibraryQueryTargetById(libraryId: number): Promise<ParsedWikiGraphLibraryUri>;
+declare function createLibrarySources(values: readonly {
+    readonly archiveId?: number;
+    readonly libraryArchiveUri?: string;
+}[]): readonly ArchiveLibrarySource[];
+
+export { createLibrarySources, findWikiGraphLibraryObjects, listRelatedWikiGraphLibraryObjects, listWikiGraphLibraryEvidence, listWikiGraphLibraryObjects, packWikiGraphLibraryContext, readWikiGraphLibraryPage, resolveWikiGraphLibraryQueryTargetById };