@undefineds.co/xpod 0.3.57 → 0.3.61

package/dist/storage/rdf/types.js.map

@@ -1 +1 @@
-{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/storage/rdf/types.ts"],"names":[],"mappings":"","sourcesContent":["import type { Quad, Term } from '@rdfjs/types';\nimport type { QueryOptions, QuintPattern, TermMatch, TermName } from '../quint/types';\n\nexport type RdfTermKind = 'iri' | 'literal' | 'blank' | 'default_graph';\n\nexport interface RdfTermRow {\n  id: number;\n  kind: RdfTermKind;\n  value: string;\n  value_head: string;\n  datatype_id: number | null;\n  lang: string | null;\n  hash: string;\n  normalized_text: string | null;\n  numeric_value: number | null;\n  created_at: string;\n}\n\nexport interface RdfSourceInput {\n  source: string;\n  workspace: string;\n  localPath?: string;\n  contentType?: string;\n  sourceVersion?: string;\n}\n\nexport interface RdfSourceRow {\n  id: number;\n  source: string;\n  workspace: string;\n  local_path: string | null;\n  content_type: string | null;\n  last_indexed_at: string | null;\n  source_version: string | null;\n}\n\nexport interface RdfQuadRow {\n  graph_id: number;\n  subject_id: number;\n  predicate_id: number;\n  object_id: number;\n  source_file_id: number | null;\n  source_line_no: number | null;\n}\n\nexport interface RdfQuadIndexOptions {\n  path: string;\n  debug?: boolean;\n}\n\nexport type RdfDerivedIndexProfile = 'baseline' | 'rdf3x';\n\nexport interface RdfShadowAutoBackfillOptions {\n  enabled?: boolean;\n  clear?: boolean;\n  batchSize?: number;\n}\n\nexport interface RdfIndexPutOptions {\n  source?: RdfSourceInput;\n  sourceLineNo?: number;\n}\n\nexport interface RdfIndexMetrics {\n  engine: 'solid-rdf';\n  indexChoice: string;\n  /** Rows matched before LIMIT/OFFSET are applied. */\n  matchedRows: number;\n  returnedRows: number;\n  durationMs: number;\n  queryPlan?: string[];\n}\n\nexport interface RdfCardinalityEstimate {\n  rows: number;\n  source:\n    | 'exact-count'\n    | 'cached-exact-count'\n    | 'exact-distinct-count'\n    | 'cached-exact-distinct-count'\n    | 'exact-distinct-tuple-count'\n    | 'cached-exact-distinct-tuple-count';\n  indexChoice: string;\n}\n\nexport interface RdfIndexStats {\n  termCount: number;\n  quadCount: number;\n  sourceCount: number;\n  graphCount: number;\n  databaseBytes: number;\n  tableBytes: number;\n  indexBytes: number;\n  spaceObjects: RdfIndexSpaceObject[];\n  serializedTermTextBytes: number;\n  literalDatatypeDistribution: RdfLiteralDatatypeDistribution[];\n  cardinalityDistributions: RdfCardinalityDistributions;\n}\n\nexport interface RdfEngineStorageStats {\n  derivedIndexProfile: RdfDerivedIndexProfile;\n  facts: RdfIndexStats;\n  rdf3x?: {\n    stats: Rdf3xIndexStats;\n    syncedWithFacts: boolean;\n  };\n  factsBytes: number;\n  derivedBytes: number;\n  totalBytes: number;\n  derivedToFactsRatio: number;\n  totalToFactsRatio: number;\n}\n\nexport interface RdfDerivedIndexRefreshResult {\n  derivedIndexProfile: RdfDerivedIndexProfile;\n  factsDataVersion: number;\n  rdf3x?: {\n    refreshed: boolean;\n    previousFactsDataVersion: number;\n    factsDataVersion: number;\n    syncedWithFacts: boolean;\n    rebuild?: Rdf3xRebuildResult;\n  };\n}\n\nexport interface RdfIndexSpaceObject {\n  name: string;\n  kind: 'table' | 'index' | 'internal' | 'unknown';\n  tableName?: string;\n  bytes: number;\n  pages: number;\n  estimated?: boolean;\n}\n\nexport interface RdfLiteralDatatypeDistribution {\n  datatype: string;\n  termCount: number;\n  objectQuadCount: number;\n}\n\nexport interface RdfCardinalityTerm {\n  value: string;\n  kind: RdfTermKind;\n  datatype?: string;\n  language?: string;\n}\n\nexport interface RdfGraphCardinality {\n  graph: RdfCardinalityTerm;\n  quadCount: number;\n  distinctSubjects: number;\n  distinctPredicates: number;\n  distinctObjects: number;\n}\n\nexport interface RdfPredicateCardinality {\n  predicate: RdfCardinalityTerm;\n  quadCount: number;\n  graphCount: number;\n  distinctSubjects: number;\n  distinctObjects: number;\n}\n\nexport interface RdfPredicateObjectCardinality {\n  predicate: RdfCardinalityTerm;\n  object: RdfCardinalityTerm;\n  quadCount: number;\n  graphCount: number;\n  distinctSubjects: number;\n}\n\nexport interface RdfSubjectPredicateCardinality {\n  subject: RdfCardinalityTerm;\n  predicate: RdfCardinalityTerm;\n  quadCount: number;\n  graphCount: number;\n  distinctObjects: number;\n}\n\nexport interface RdfCardinalityDistributions {\n  graphs: RdfGraphCardinality[];\n  predicates: RdfPredicateCardinality[];\n  predicateObjects: RdfPredicateObjectCardinality[];\n  subjectPredicates: RdfSubjectPredicateCardinality[];\n}\n\nexport interface RdfQuadIndexScanResult {\n  quads: Quad[];\n  metrics: RdfIndexMetrics;\n}\n\nexport type Rdf3xTermKey = 'subject' | 'predicate' | 'object';\nexport type Rdf3xPatternKey = 'graph' | Rdf3xTermKey;\nexport type Rdf3xPermutationName = 'SPO' | 'SOP' | 'PSO' | 'POS' | 'OSP' | 'OPS';\nexport type Rdf3xPairProjectionName = 'SP' | 'SO' | 'PS' | 'PO' | 'OS' | 'OP';\nexport type Rdf3xTermProjectionName = 'S' | 'P' | 'O';\n\nexport interface Rdf3xIndexOptions {\n  path: string;\n  debug?: boolean;\n}\n\nexport interface Rdf3xGraphPrefixPattern {\n  $startsWith: string;\n}\n\nexport interface Rdf3xTermInPattern {\n  $in: Term[];\n}\n\nexport interface Rdf3xTermNotInPattern {\n  $notIn: Term[];\n}\n\nexport type Rdf3xTermTypePatternValue = 'iri' | 'blank' | 'literal' | 'numeric';\n\nexport interface Rdf3xTermMetadataPattern {\n  $termType?: Rdf3xTermTypePatternValue;\n  $language?: string;\n  $notLanguage?: string;\n  $langMatches?: string;\n  $datatype?: Term;\n  $notDatatype?: Term;\n}\n\nexport interface Rdf3xObjectRangePattern {\n  $gt?: Term | string | number;\n  $gte?: Term | string | number;\n  $lt?: Term | string | number;\n  $lte?: Term | string | number;\n}\n\nexport type Rdf3xNumericObjectRangePattern = Rdf3xObjectRangePattern;\n\nexport interface Rdf3xObjectTextSearchPattern {\n  $contains?: string;\n  $endsWith?: string;\n}\n\nexport interface Rdf3xObjectOperatorPattern extends Rdf3xObjectRangePattern, Rdf3xObjectTextSearchPattern, Rdf3xTermMetadataPattern {}\n\nexport interface Rdf3xTriplePattern {\n  graph?: Term | Rdf3xGraphPrefixPattern | Rdf3xTermInPattern | Rdf3xTermNotInPattern | Rdf3xTermMetadataPattern;\n  subject?: Term | Rdf3xTermInPattern | Rdf3xTermNotInPattern | Rdf3xTermMetadataPattern;\n  predicate?: Term | Rdf3xTermInPattern | Rdf3xTermNotInPattern | Rdf3xTermMetadataPattern;\n  object?: Term | Rdf3xObjectOperatorPattern | Rdf3xTermInPattern | Rdf3xTermNotInPattern;\n}\n\nexport interface Rdf3xTripleScanOptions {\n  order?: Array<'graph' | 'subject' | 'predicate' | 'object'>;\n  orderDirections?: Array<'asc' | 'desc'>;\n  reverse?: boolean;\n  limit?: number;\n  offset?: number;\n}\n\nexport interface Rdf3xIndexMetrics {\n  engine: 'solid-rdf3x';\n  indexChoice: Rdf3xPermutationName | 'source-membership' | 'none';\n  matchedRows: number;\n  returnedRows: number;\n  durationMs: number;\n  queryPlan?: string[];\n}\n\nexport interface Rdf3xTripleScanResult {\n  quads: Quad[];\n  metrics: Rdf3xIndexMetrics;\n}\n\nexport interface Rdf3xCountResult {\n  count: number;\n  metrics: Rdf3xIndexMetrics;\n}\n\nexport interface Rdf3xJoinOptions {\n  orderBy?: RdfQuadJoinOrder[];\n  limit?: number;\n  offset?: number;\n  project?: string[];\n  distinct?: boolean;\n  countMatchedRows?: boolean;\n  values?: RdfValuesBindingSource[];\n}\n\nexport interface Rdf3xJoinMetrics {\n  engine: 'solid-rdf3x';\n  indexChoice: string;\n  matchedRows: number;\n  returnedRows: number;\n  durationMs: number;\n  queryPlan?: string[];\n}\n\nexport interface Rdf3xJoinScanResult {\n  bindings: RdfBindingRow[];\n  metrics: Rdf3xJoinMetrics;\n}\n\nexport interface Rdf3xRebuildResult {\n  scannedQuads: number;\n  uniqueTriples: number;\n  memberships: number;\n  projectionRows: number;\n  factsDataVersion: number;\n  durationMs: number;\n}\n\nexport interface Rdf3xCardinalityEstimate {\n  uniqueTriples: number;\n  matchingQuads: number;\n  source: 'projection-stat' | 'term-stat' | 'exact-triple' | 'exact-membership' | 'full-count';\n  indexChoice: Rdf3xPermutationName | 'source-membership' | 'none';\n}\n\nexport interface Rdf3xIndexStats {\n  uniqueTriples: number;\n  membershipCount: number;\n  graphCount: number;\n  factsDataVersion: number;\n  permutationRows: Record<Rdf3xPermutationName, number>;\n  pairProjectionRows: Record<Rdf3xPairProjectionName, number>;\n  termProjectionRows: Record<Rdf3xTermProjectionName, number>;\n  databaseBytes: number;\n  tableBytes: number;\n  indexBytes: number;\n  spaceObjects: RdfIndexSpaceObject[];\n}\n\nexport interface Rdf3xShadowBindingDiff {\n  missingFromRdf3x: string[];\n  extraInRdf3x: string[];\n}\n\nexport interface Rdf3xShadowQuadDiff {\n  missingFromRdf3x: string[];\n  extraInRdf3x: string[];\n}\n\nexport interface Rdf3xShadowScanResult {\n  matched: boolean;\n  orderedMatch: boolean;\n  primary: Quad[];\n  rdf3x: Quad[];\n  diff: Rdf3xShadowQuadDiff;\n  primaryMetrics: RdfIndexMetrics;\n  rdf3xMetrics: Rdf3xIndexMetrics;\n  rebuild: Rdf3xRebuildResult;\n}\n\nexport interface Rdf3xShadowJoinResult {\n  matched: boolean;\n  orderedMatch: boolean;\n  primary: RdfBindingRow[];\n  rdf3x: RdfBindingRow[];\n  diff: Rdf3xShadowBindingDiff;\n  primaryMetrics: RdfIndexMetrics;\n  rdf3xMetrics: Rdf3xJoinMetrics;\n  rebuild: Rdf3xRebuildResult;\n}\n\nexport type RdfQuadTupleConstraint = Partial<Record<RdfQueryPatternKey, Term>>;\n\nexport interface RdfQuadTupleConstraintSource {\n  columns: RdfQueryPatternKey[];\n  rows: RdfQuadTupleConstraint[];\n}\n\nexport interface RdfQuadJoinPattern {\n  pattern: QuintPattern;\n  variables: Partial<Record<RdfQueryPatternKey, string>>;\n}\n\nexport interface RdfQuadJoinOrder {\n  variable: string;\n  direction?: 'asc' | 'desc';\n}\n\nexport interface RdfQuadScanOptions extends QueryOptions {\n  orderDirections?: Array<'asc' | 'desc'>;\n}\n\nexport interface RdfQuadJoinOptions {\n  orderBy?: RdfQuadJoinOrder[];\n  limit?: number;\n  offset?: number;\n  project?: string[];\n  distinct?: boolean;\n  countMatchedRows?: boolean;\n}\n\nexport interface RdfQuadJoinAggregateOptions {\n  aggregates: RdfQueryAggregate[];\n}\n\nexport type RdfQuadJoinCountOptions = RdfQuadJoinAggregateOptions;\n\nexport interface RdfQuadJoinGroupAggregateHaving {\n  aggregate: string;\n  operator: '$eq' | '$ne' | '$gt' | '$gte' | '$lt' | '$lte';\n  value: number;\n}\n\nexport type RdfQuadJoinGroupCountHaving = RdfQuadJoinGroupAggregateHaving;\n\nexport interface RdfPatternQuery {\n  pattern: QuintPattern;\n  options?: QueryOptions;\n}\n\nexport interface RdfQueryVariable {\n  variable: string;\n}\n\nexport type RdfQueryTermPattern = TermMatch | RdfQueryVariable;\n\nexport interface RdfQueryPattern {\n  graph?: RdfQueryTermPattern;\n  subject?: RdfQueryTermPattern;\n  predicate?: RdfQueryTermPattern;\n  object?: RdfQueryTermPattern;\n}\n\nexport interface RdfConstructTemplate {\n  subject: RdfQueryTermPattern;\n  predicate: RdfQueryTermPattern;\n  object: RdfQueryTermPattern;\n}\n\nexport interface RdfQueryOrder {\n  variable: string;\n  direction?: 'asc' | 'desc';\n}\n\nexport type RdfQueryAggregateType = 'count' | 'sum' | 'avg' | 'min' | 'max';\n\nexport interface RdfQueryAggregate {\n  type: RdfQueryAggregateType;\n  as: string;\n  variable?: string;\n  distinct?: boolean;\n  distinctVariables?: string[];\n}\n\nexport type RdfBindExpression =\n  | { type: 'term'; term: Term }\n  | { type: 'variable'; variable: string }\n  | { type: 'stringValue'; variable: string }\n  | { type: 'stringLength'; variable: string }\n  | { type: 'lowerCase'; expression: RdfBindExpression }\n  | { type: 'upperCase'; expression: RdfBindExpression }\n  | { type: 'coalesce'; expressions: RdfBindExpression[] }\n  | { type: 'if'; condition: RdfQueryFilter[]; then: RdfBindExpression; else: RdfBindExpression }\n  | {\n    type: 'substring';\n    expression: RdfBindExpression;\n    start: RdfBindExpression;\n    length?: RdfBindExpression;\n  }\n  | { type: 'concat'; expressions: RdfBindExpression[] }\n  | { type: 'iri'; expression: RdfBindExpression; base: string }\n  | { type: 'strdt'; lexical: RdfBindExpression; datatype: RdfBindExpression }\n  | { type: 'strlang'; lexical: RdfBindExpression; language: RdfBindExpression };\n\nexport interface RdfQueryBind {\n  variable: string;\n  expression: RdfBindExpression;\n}\n\nexport type RdfQueryFilterOperator =\n  | '$eq'\n  | '$ne'\n  | '$gt'\n  | '$gte'\n  | '$lt'\n  | '$lte'\n  | '$in'\n  | '$notIn'\n  | '$startsWith'\n  | '$contains'\n  | '$endsWith'\n  | '$regex'\n  | '$notStartsWith'\n  | '$notContains'\n  | '$notEndsWith'\n  | '$notRegex'\n  | '$bound'\n  | '$termType'\n  | '$notTermType'\n  | '$sameTerm'\n  | '$notSameTerm'\n  | '$lang'\n  | '$notLang'\n  | '$langIn'\n  | '$notLangIn'\n  | '$langMatches'\n  | '$notLangMatches'\n  | '$datatype'\n  | '$notDatatype'\n  | '$datatypeIn'\n  | '$notDatatypeIn';\n\nexport type RdfQueryFilterValue = Term | string | number | boolean;\n\nexport interface RdfQueryFilter {\n  variable: string;\n  operator: RdfQueryFilterOperator;\n  operand?: 'stringLength' | 'stringValue' | 'lowerStringValue' | 'upperStringValue';\n  value?: RdfQueryFilterValue;\n  values?: RdfQueryFilterValue[];\n  variable2?: string;\n  flags?: string;\n  source?: 'filter' | 'values';\n}\n\nexport interface RdfValuesBindingSource {\n  variables: string[];\n  rows: RdfBindingRow[];\n}\n\nexport interface RdfSearchScope {\n  workspace?: string;\n  sourcePrefix?: string;\n}\n\nexport interface RdfTextSearchPattern {\n  query: string;\n  scope?: RdfSearchScope;\n  limit?: number;\n  offset?: number;\n  orderBy?: RdfTextSearchOrder[];\n  source?: string;\n  chunk?: string;\n  content?: string;\n  heading?: string;\n  score?: string;\n  workspace?: string;\n  localPath?: string;\n  contentType?: string;\n  ordinal?: string;\n  level?: string;\n  startOffset?: string;\n  endOffset?: string;\n}\n\nexport type RdfVectorDistanceMetric = 'cosine' | 'dot' | 'euclidean';\n\nexport type RdfSearchOrderDirection = 'asc' | 'desc';\nexport type RdfTextSearchOrderField = 'score' | 'source' | 'localPath' | 'ordinal' | 'startOffset' | 'endOffset';\nexport type RdfVectorSearchOrderField = RdfTextSearchOrderField | 'distance';\n\nexport interface RdfTextSearchOrder {\n  field: RdfTextSearchOrderField;\n  direction?: RdfSearchOrderDirection;\n}\n\nexport interface RdfVectorSearchOrder {\n  field: RdfVectorSearchOrderField;\n  direction?: RdfSearchOrderDirection;\n}\n\nexport interface RdfVectorSearchPattern {\n  embedding: number[];\n  metric?: RdfVectorDistanceMetric;\n  vectorModel?: string;\n  scope?: RdfSearchScope;\n  limit?: number;\n  offset?: number;\n  threshold?: number;\n  orderBy?: RdfVectorSearchOrder[];\n  source?: string;\n  chunk?: string;\n  content?: string;\n  heading?: string;\n  score?: string;\n  distance?: string;\n  workspace?: string;\n  localPath?: string;\n  contentType?: string;\n  ordinal?: string;\n  level?: string;\n  startOffset?: string;\n  endOffset?: string;\n  model?: string;\n}\n\nexport interface RdfQuery {\n  patterns: RdfQueryPattern[];\n  values?: RdfValuesBindingSource[];\n  textSearch?: RdfTextSearchPattern[];\n  vectorSearch?: RdfVectorSearchPattern[];\n  unions?: RdfUnionQueryGroup[];\n  minus?: RdfMinusQueryGroup[];\n  exists?: RdfExistsQueryGroup[];\n  optional?: Array<RdfQueryPattern[] | RdfOptionalQueryGroup>;\n  binds?: RdfQueryBind[];\n  postOptionalBinds?: RdfQueryBind[];\n  filters?: RdfQueryFilter[];\n  having?: RdfQueryFilter[];\n  select?: string[];\n  distinct?: boolean;\n  groupBy?: string[];\n  aggregates?: RdfQueryAggregate[];\n  aggregate?: RdfQueryAggregate;\n  orderBy?: RdfQueryOrder[];\n  limit?: number;\n  offset?: number;\n}\n\nexport interface RdfUnionQueryBranch {\n  patterns: RdfQueryPattern[];\n  values?: RdfValuesBindingSource[];\n  unions?: RdfUnionQueryGroup[];\n  optional?: Array<RdfQueryPattern[] | RdfOptionalQueryGroup>;\n  binds?: RdfQueryBind[];\n  filters?: RdfQueryFilter[];\n}\n\nexport interface RdfUnionQueryGroup {\n  branches: RdfUnionQueryBranch[];\n}\n\nexport interface RdfMinusQueryGroup {\n  patterns: RdfQueryPattern[];\n  values?: RdfValuesBindingSource[];\n  unions?: RdfUnionQueryGroup[];\n  optional?: Array<RdfQueryPattern[] | RdfOptionalQueryGroup>;\n  binds?: RdfQueryBind[];\n  filters?: RdfQueryFilter[];\n}\n\nexport interface RdfExistsQueryGroup {\n  patterns: RdfQueryPattern[];\n  values?: RdfValuesBindingSource[];\n  unions?: RdfUnionQueryGroup[];\n  optional?: Array<RdfQueryPattern[] | RdfOptionalQueryGroup>;\n  binds?: RdfQueryBind[];\n  filters?: RdfQueryFilter[];\n}\n\nexport interface RdfOptionalQueryGroup {\n  patterns: RdfQueryPattern[];\n  values?: RdfValuesBindingSource[];\n  unions?: RdfUnionQueryGroup[];\n  optional?: Array<RdfQueryPattern[] | RdfOptionalQueryGroup>;\n  minus?: RdfMinusQueryGroup[];\n  exists?: RdfExistsQueryGroup[];\n  binds?: RdfQueryBind[];\n  filters?: RdfQueryFilter[];\n}\n\nexport type RdfBindingRow = Record<string, Term>;\n\nexport interface RdfQuadJoinScanResult {\n  bindings: RdfBindingRow[];\n  metrics: RdfIndexMetrics;\n}\n\nexport interface RdfQuadJoinGroupAggregateOptions {\n  groupBy: string[];\n  aggregates: RdfQueryAggregate[];\n  having?: RdfQuadJoinGroupAggregateHaving[];\n  orderBy?: RdfQuadJoinOrder[];\n  limit?: number;\n  offset?: number;\n}\n\nexport type RdfQuadJoinGroupCountOptions = RdfQuadJoinGroupAggregateOptions;\n\nexport interface RdfQueryMetrics {\n  engine: 'solid-rdf';\n  plan: string[];\n  scannedRows: number;\n  joinedRows: number;\n  returnedRows: number;\n  durationMs: number;\n  indexChoices: string[];\n  cardinalityEstimates?: number;\n  distinctCardinalityEstimates?: number;\n  searchCardinalityEstimates?: number;\n  filtersApplied: number;\n  filtersPushedDown: number;\n}\n\nexport interface RdfQueryResult {\n  bindings: RdfBindingRow[];\n  count?: number;\n  metrics: RdfQueryMetrics;\n}\n\nexport interface RdfEngineLike {\n  open(): void | Promise<void>;\n  close(): void | Promise<void>;\n  put(quads: Quad | Quad[], options?: RdfIndexPutOptions): void | Promise<void>;\n  replaceSource(quads: Quad[], source: RdfSourceInput): void | Promise<void>;\n  deleteSource(source: string): number | Promise<number>;\n  delete(pattern: QuintPattern): number | Promise<number>;\n  applyDelta(\n    deletes: QuintPattern[],\n    inserts: Quad[],\n    options?: RdfIndexPutOptions,\n  ): { deletedRows: number; insertedRows: number } | Promise<{ deletedRows: number; insertedRows: number }>;\n  scan(query: RdfPatternQuery): RdfQuadIndexScanResult | Promise<RdfQuadIndexScanResult>;\n  query(query: RdfQuery): RdfQueryResult | Promise<RdfQueryResult>;\n  refreshDerivedIndexes(): RdfDerivedIndexRefreshResult | Promise<RdfDerivedIndexRefreshResult>;\n  storageStats(): RdfEngineStorageStats | Promise<RdfEngineStorageStats>;\n}\n\nexport type RdfQueryPatternKey = TermName;\n\nexport interface RdfShadowDiff {\n  missingFromPrimary: string[];\n  extraInPrimary: string[];\n}\n\nexport interface RdfShadowBackfillOptions {\n  clear?: boolean;\n  batchSize?: number;\n}\n\nexport interface RdfShadowBackfillResult {\n  scannedRows: number;\n  indexedRows: number;\n  batchCount: number;\n  durationMs: number;\n}\n\nexport interface RdfShadowScanResult {\n  matched: boolean;\n  orderedMatch: boolean;\n  primary: Quad[];\n  compatibility: Quad[];\n  diff: RdfShadowDiff;\n  metrics: RdfIndexMetrics;\n}\n\nexport interface RdfTextIndexOptions {\n  path: string;\n}\n\nexport interface RdfTextSourceInput {\n  source: string;\n  workspace: string;\n  localPath?: string;\n  contentType?: string;\n  sourceVersion?: string;\n  sourceHash?: string;\n}\n\nexport interface RdfTextChunkInput {\n  chunkKey: string;\n  ordinal: number;\n  level: number;\n  heading?: string;\n  path?: string[];\n  content: string;\n  startOffset: number;\n  endOffset: number;\n}\n\nexport interface RdfTextChunkRow {\n  id: number;\n  source_id: number;\n  source: string;\n  workspace: string;\n  local_path: string | null;\n  content_type: string | null;\n  source_version: string | null;\n  source_hash: string | null;\n  chunk_key: string;\n  ordinal: number;\n  level: number;\n  heading: string | null;\n  path: string | null;\n  content: string;\n  start_offset: number;\n  end_offset: number;\n  normalized_text: string;\n  token_count: number;\n  updated_at: string;\n}\n\nexport interface RdfTextSearchOptions {\n  query: string;\n  source?: string;\n  workspace?: string;\n  sourcePrefix?: string;\n  limit?: number;\n  offset?: number;\n  orderBy?: RdfTextSearchOrder[];\n}\n\nexport interface RdfTextSearchResult {\n  source: string;\n  workspace: string;\n  localPath?: string;\n  contentType?: string;\n  sourceVersion?: string;\n  sourceHash?: string;\n  chunkKey: string;\n  ordinal: number;\n  level: number;\n  heading?: string;\n  path: string[];\n  content: string;\n  startOffset: number;\n  endOffset: number;\n  score: number;\n}\n\nexport interface RdfSearchCardinalityEstimate {\n  rows: number;\n  source: 'text-normalized-scan' | 'text-term-posting' | 'vector-candidate-count' | 'vector-component-score';\n  indexChoice: string;\n}\n\nexport interface RdfTextIndexStats {\n  sourceCount: number;\n  chunkCount: number;\n  databaseBytes: number;\n  termDocumentFrequency: RdfTextTermDocumentFrequency[];\n}\n\nexport interface RdfTextTermDocumentFrequency {\n  term: string;\n  sourceCount: number;\n  chunkCount: number;\n  totalOccurrences: number;\n}\n\nexport interface RdfVectorIndexOptions {\n  path: string;\n  defaultMetric?: RdfVectorDistanceMetric;\n}\n\nexport interface RdfVectorSourceInput {\n  source: string;\n  workspace: string;\n  localPath?: string;\n  contentType?: string;\n  sourceVersion?: string;\n  sourceHash?: string;\n}\n\nexport interface RdfVectorChunkInput {\n  chunkKey: string;\n  ordinal: number;\n  level: number;\n  embedding: number[];\n  model?: string;\n  heading?: string;\n  path?: string[];\n  content: string;\n  startOffset: number;\n  endOffset: number;\n}\n\nexport interface RdfVectorChunkRow {\n  id: number;\n  source_id: number;\n  source: string;\n  workspace: string;\n  local_path: string | null;\n  content_type: string | null;\n  source_version: string | null;\n  source_hash: string | null;\n  chunk_key: string;\n  ordinal: number;\n  level: number;\n  heading: string | null;\n  path: string | null;\n  content: string;\n  start_offset: number;\n  end_offset: number;\n  embedding_json: string;\n  dimensions: number;\n  magnitude: number;\n  model: string;\n  updated_at: string;\n}\n\nexport interface RdfVectorSearchOptions {\n  embedding: number[];\n  metric?: RdfVectorDistanceMetric;\n  model?: string;\n  source?: string;\n  workspace?: string;\n  sourcePrefix?: string;\n  limit?: number;\n  offset?: number;\n  threshold?: number;\n  orderBy?: RdfVectorSearchOrder[];\n}\n\nexport interface RdfVectorSearchResult {\n  source: string;\n  workspace: string;\n  localPath?: string;\n  contentType?: string;\n  sourceVersion?: string;\n  sourceHash?: string;\n  chunkKey: string;\n  ordinal: number;\n  level: number;\n  heading?: string;\n  path: string[];\n  content: string;\n  startOffset: number;\n  endOffset: number;\n  embedding: number[];\n  model?: string;\n  score: number;\n  distance: number;\n}\n\nexport interface RdfVectorIndexStats {\n  sourceCount: number;\n  chunkCount: number;\n  componentCount: number;\n  databaseBytes: number;\n  modelDistribution: RdfVectorModelDistribution[];\n}\n\nexport interface RdfVectorModelDistribution {\n  model: string;\n  dimensions: number;\n  sourceCount: number;\n  chunkCount: number;\n  minMagnitude: number;\n  maxMagnitude: number;\n  averageMagnitude: number;\n}\n\nexport interface RdfTermSelection {\n  sql: string;\n  params: unknown[];\n  indexHint: string;\n}\n\nexport interface RdfTermLookup {\n  id: number;\n  term: Term;\n}\n"]}
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/storage/rdf/types.ts"],"names":[],"mappings":"","sourcesContent":["import type { Quad, Term } from '@rdfjs/types';\nimport type { QueryOptions, QuintPattern, TermMatch, TermName } from '../quint/types';\n\nexport type RdfTermKind = 'iri' | 'literal' | 'blank' | 'default_graph';\n\nexport interface RdfTermRow {\n  id: number;\n  kind: RdfTermKind;\n  value: string;\n  value_head: string;\n  datatype_id: number | null;\n  lang: string | null;\n  hash: string;\n  normalized_text: string | null;\n  numeric_value: number | null;\n  created_at: string;\n}\n\nexport interface RdfSourceInput {\n  source: string;\n  workspace: string;\n  localPath?: string;\n  contentType?: string;\n  sourceVersion?: string;\n}\n\nexport interface RdfSourceRow {\n  id: number;\n  source: string;\n  workspace: string;\n  local_path: string | null;\n  content_type: string | null;\n  last_indexed_at: string | null;\n  source_version: string | null;\n}\n\nexport interface RdfQuadRow {\n  graph_id: number;\n  subject_id: number;\n  predicate_id: number;\n  object_id: number;\n  source_file_id: number | null;\n  source_line_no: number | null;\n}\n\nexport interface RdfQuadIndexOptions {\n  path: string;\n  debug?: boolean;\n}\n\nexport type RdfDerivedIndexProfile = 'baseline' | 'rdf3x';\nexport type RdfPgAccelerationProfile = 'baseline' | 'pg-result-cache' | 'pg-hot-operators' | 'pg-custom-index';\nexport type RdfPgAccelerationProvider = 'engine-sql' | 'sql-abi' | 'extension';\nexport type RdfPgAccelerationFallbackReason =\n  | 'profile-disabled'\n  | 'capability-missing'\n  | 'probe-failed'\n  | 'index-build-deferred';\n\nexport interface RdfShadowAutoBackfillOptions {\n  enabled?: boolean;\n  clear?: boolean;\n  batchSize?: number;\n}\n\nexport interface RdfIndexPutOptions {\n  source?: RdfSourceInput;\n  sourceLineNo?: number;\n}\n\nexport interface RdfIndexMetrics {\n  engine: 'solid-rdf';\n  indexChoice: string;\n  /** Rows matched before LIMIT/OFFSET are applied. */\n  matchedRows: number;\n  returnedRows: number;\n  durationMs: number;\n  queryPlan?: string[];\n}\n\nexport interface RdfCardinalityEstimate {\n  rows: number;\n  source:\n    | 'exact-count'\n    | 'cached-exact-count'\n    | 'exact-distinct-count'\n    | 'cached-exact-distinct-count'\n    | 'exact-distinct-tuple-count'\n    | 'cached-exact-distinct-tuple-count';\n  indexChoice: string;\n}\n\nexport interface RdfIndexStats {\n  termCount: number;\n  quadCount: number;\n  sourceCount: number;\n  graphCount: number;\n  databaseBytes: number;\n  tableBytes: number;\n  indexBytes: number;\n  spaceObjects: RdfIndexSpaceObject[];\n  serializedTermTextBytes: number;\n  literalDatatypeDistribution: RdfLiteralDatatypeDistribution[];\n  cardinalityDistributions: RdfCardinalityDistributions;\n}\n\nexport interface RdfStorageStatsOptions {\n  cacheScope?: RdfDerivedCacheScopeStatsOptions;\n}\n\nexport interface RdfDerivedCacheScopeStatsOptions {\n  query?: string;\n  principal?: string;\n  basePath?: string;\n  mode?: string;\n  authorizationModel?: string;\n  permissionVersion?: string;\n  limit?: number;\n}\n\nexport interface RdfEngineStorageStats {\n  derivedIndexProfile: RdfDerivedIndexProfile;\n  lifecycle?: RdfEngineLifecycleStats;\n  facts: RdfIndexStats;\n  rdf3x?: {\n    stats: Rdf3xIndexStats;\n    factsDataVersion: number;\n    rdf3xFactsDataVersion: number;\n    refreshLag: number;\n    syncedWithFacts: boolean;\n    pendingSources: number;\n  };\n  derivedCache?: RdfDerivedCacheStats;\n  queryResultCache?: RdfQueryResultCacheStats;\n  materializedResultCache?: RdfMaterializedResultCacheStats;\n  queryTemplateCache?: RdfQueryTemplateCacheStats;\n  accessControlOverrides?: RdfAccessControlOverrideIndexStats;\n  slowQueries?: RdfSlowQueryStats;\n  pgAcceleration?: RdfPgAccelerationStats;\n  bulkLoad?: RdfBulkLoadStats;\n  factsBytes: number;\n  derivedBytes: number;\n  totalBytes: number;\n  derivedToFactsRatio: number;\n  totalToFactsRatio: number;\n}\n\nexport interface RdfBulkLoadStats {\n  copyFromRows: {\n    attempts: number;\n    succeeded: number;\n    fallbacks: number;\n    rows: number;\n    tables: RdfBulkLoadCopyTableStats[];\n  };\n}\n\nexport interface RdfBulkLoadCopyTableStats {\n  kind: string;\n  statements: number;\n  rows: number;\n}\n\nexport interface RdfEngineLifecycleStats {\n  status: 'closed' | 'opening' | 'ready' | 'failed';\n  driver?: string;\n  openCount: number;\n  lastOpenStartedAt?: string;\n  lastReadyAt?: string;\n  lastOpenDurationMs?: number;\n  lastOpenFailedAt?: string;\n  lastOpenError?: string;\n  coldStart?: RdfEngineColdStartStats;\n}\n\nexport interface RdfEngineColdStartStats {\n  startedAt: string;\n  readyAt: string;\n  durationMs: number;\n  phases: RdfEngineColdStartPhaseStats[];\n  customIndexDeferred: boolean;\n  maintenanceEnabled: boolean;\n  ownsTextIndex: boolean;\n  ownsVectorIndex: boolean;\n}\n\nexport interface RdfEngineColdStartPhaseStats {\n  name:\n    | 'executor'\n    | 'text-index'\n    | 'vector-index'\n    | 'term-dictionary'\n    | 'schema'\n    | 'acceleration-probe'\n    | 'native-sparql-probe'\n    | 'custom-indexes'\n    | 'maintenance-scheduler';\n  durationMs: number;\n}\n\nexport interface RdfAccessControlOverrideIndexStats {\n  entryCount: number;\n  totalBytes: number;\n  tableBytes: number;\n  indexBytes: number;\n}\n\nexport interface RdfPgAccelerationStats {\n  profile: RdfPgAccelerationProfile;\n  requested: boolean;\n  available: boolean;\n  enabled: boolean;\n  provider?: RdfPgAccelerationProvider;\n  version?: string;\n  capabilities: string[];\n  capabilityProviders?: Record<string, RdfPgAccelerationProvider>;\n  requiredCapabilities: string[];\n  missingCapabilities: string[];\n  activeOperators?: string[];\n  customIndexes?: RdfPgCustomIndexStats[];\n  fallbackReason?: RdfPgAccelerationFallbackReason;\n  fallbackDetail?: string;\n}\n\nexport interface RdfPgCustomIndexStats {\n  name: string;\n  permutation: string;\n  columns: string[];\n  stats?: Record<string, unknown>;\n  error?: string;\n}\n\nexport interface RdfDerivedCacheStats {\n  cacheBytes: number;\n  maxCacheBytes: number;\n  cachePressure: number;\n  maxScopeBytes: number;\n  scopeVersionCount: number;\n  scopeEntries: RdfDerivedCacheScopeEntry[];\n  largestScopeBytes: number;\n  largestScopePressure: number;\n  largestScopeHash?: string;\n  largestScopeFactsDataVersion?: number;\n  evictionCount: number;\n  evictions: RdfDerivedCacheEvictionStats;\n  queryResultPayloadBytes: number;\n  materializedResultPayloadBytes: number;\n  queryTemplateBytes: number;\n}\n\nexport interface RdfSlowQueryDerivedCacheExplain {\n  cacheBytes: number;\n  maxCacheBytes: number;\n  cachePressure: number;\n  largestScopeBytes: number;\n  largestScopePressure: number;\n  largestScopeHash?: string;\n  largestScopeFactsDataVersion?: number;\n  evictionCount: number;\n  evictions: RdfDerivedCacheEvictionStats;\n}\n\nexport interface RdfDerivedCacheScopeEntry {\n  scopeHash: string;\n  factsDataVersion: number;\n  payloadBytes: number;\n  queryResultPayloadBytes: number;\n  materializedResultPayloadBytes: number;\n  queryResultEntries: number;\n  materializedResultEntries: number;\n  scopeShape?: string;\n  principal?: string;\n  basePath?: string;\n  mode?: string;\n  authorizationModel?: string;\n  permissionVersion?: string;\n}\n\nexport interface RdfDerivedCacheEvictionStats {\n  factsVersion: number;\n  ttl: number;\n  maxEntries: number;\n  payloadBytes: number;\n  scopeBytes: number;\n  totalBytes: number;\n  templateTtl: number;\n  templateMaxEntries: number;\n  templateBytes: number;\n}\n\nexport interface RdfQueryResultCacheStats {\n  entryCount: number;\n  scopeCount: number;\n  maxEntries: number;\n  ttlMs: number;\n  hitCount: number;\n  missCount: number;\n  refreshCount: number;\n  storeCount: number;\n  bypassCount: number;\n  disabledCount: number;\n  payloadBytes: number;\n  maxPayloadBytes: number;\n  tableBytes: number;\n  indexBytes: number;\n  totalBytes: number;\n  spaceObjects: RdfIndexSpaceObject[];\n}\n\nexport interface RdfMaterializedResultCacheStats {\n  entryCount: number;\n  scopeCount: number;\n  maxEntries: number;\n  ttlMs: number;\n  hitCount: number;\n  missCount: number;\n  refreshCount: number;\n  storeCount: number;\n  bypassCount: number;\n  disabledCount: number;\n  payloadBytes: number;\n  maxPayloadBytes: number;\n  tableBytes: number;\n  indexBytes: number;\n  totalBytes: number;\n  spaceObjects: RdfIndexSpaceObject[];\n}\n\nexport interface RdfQueryTemplateCacheStats {\n  entryCount: number;\n  maxEntries: number;\n  ttlMs: number;\n  hitCount: number;\n  missCount: number;\n  evictionCount: number;\n  compiledSqlEntryCount?: number;\n  compiledSqlHitCount?: number;\n  compiledSqlMissCount?: number;\n  compiledSqlEvictionCount?: number;\n  totalBytes: number;\n}\n\nexport interface RdfSlowQueryStats {\n  entryCount: number;\n  maxEntries: number;\n  entries: RdfSlowQueryStatsEntry[];\n}\n\nexport interface RdfSlowQueryStatsEntry {\n  generatedAt: string;\n  queryKey: string;\n  templateKey?: string;\n  selectedPath: RdfQueryPlannerSelectedPath;\n  reasons: string[];\n  runtime: RdfQueryPlannerRuntimeExplain;\n  slowQuery: RdfQueryPlannerSlowQueryExplain;\n  staleStats?: RdfQueryPlannerStaleStatsExplain;\n  histogramHints?: RdfQueryPlannerHistogramHint[];\n  rejectedNativeOperators?: RdfQueryPlannerNativeOperatorRejection[];\n  derivedCache: RdfSlowQueryDerivedCacheExplain;\n  cache: {\n    templateStatus?: RdfQueryTemplateCacheExplain['status'];\n    resultStatus?: RdfQueryCacheStatus;\n    materializedStatus?: RdfQueryCacheStatus;\n    result?: RdfSlowQueryCacheExplain;\n    materialized?: RdfSlowQueryCacheExplain;\n    scopeHash: string;\n    scopeBasePath: string | null;\n    scopePrincipal: string | null;\n  };\n  acceleration: {\n    profile: RdfPgAccelerationProfile;\n    requested: boolean;\n    enabled: boolean;\n    provider?: RdfPgAccelerationProvider;\n    fallbackReason?: RdfPgAccelerationFallbackReason;\n    activeOperators?: string[];\n    unsupportedCapabilities?: string[];\n  };\n}\n\nexport interface RdfSlowQueryCacheExplain {\n  status: RdfQueryCacheStatus;\n  key?: string;\n  templateKey?: string;\n  factsDataVersion?: number;\n  ttlMs?: number;\n  maxEntries?: number;\n  maxBytes?: number;\n  stored?: boolean;\n}\n\nexport interface RdfDerivedIndexRefreshResult {\n  derivedIndexProfile: RdfDerivedIndexProfile;\n  factsDataVersion: number;\n  rdf3x?: {\n    refreshed: boolean;\n    previousFactsDataVersion: number;\n    factsDataVersion: number;\n    syncedWithFacts: boolean;\n    plannerStats?: RdfPlannerStatsRefreshResult;\n    rebuild?: Rdf3xRebuildResult;\n    sourceQueue?: RdfDirtySourceQueueRefreshResult;\n  };\n}\n\nexport interface RdfDerivedIndexRefreshOptions {\n  mode?: 'auto' | 'full';\n  maxDirtySources?: number;\n}\n\nexport interface RdfDerivedIndexMaintenanceResult {\n  attempted: boolean;\n  claimed: boolean;\n  refreshed: boolean;\n  reason?: 'idle' | 'lease_busy';\n  pendingSources: number;\n  refresh?: RdfDerivedIndexRefreshResult;\n}\n\nexport interface RdfDirtySourceQueueRefreshResult {\n  pendingSources: number;\n  drainedSources: number;\n}\n\nexport interface RdfPlannerStatsRefreshResult {\n  analyzedTables: string[];\n  durationMs: number;\n}\n\nexport interface RdfIndexSpaceObject {\n  name: string;\n  kind: 'table' | 'index' | 'internal' | 'unknown';\n  tableName?: string;\n  bytes: number;\n  pages: number;\n  estimated?: boolean;\n}\n\nexport interface RdfLiteralDatatypeDistribution {\n  datatype: string;\n  termCount: number;\n  objectQuadCount: number;\n}\n\nexport interface RdfCardinalityTerm {\n  value: string;\n  kind: RdfTermKind;\n  datatype?: string;\n  language?: string;\n}\n\nexport interface RdfGraphCardinality {\n  graph: RdfCardinalityTerm;\n  quadCount: number;\n  distinctSubjects: number;\n  distinctPredicates: number;\n  distinctObjects: number;\n}\n\nexport interface RdfPredicateCardinality {\n  predicate: RdfCardinalityTerm;\n  quadCount: number;\n  graphCount: number;\n  distinctSubjects: number;\n  distinctObjects: number;\n}\n\nexport interface RdfPredicateObjectCardinality {\n  predicate: RdfCardinalityTerm;\n  object: RdfCardinalityTerm;\n  quadCount: number;\n  graphCount: number;\n  distinctSubjects: number;\n}\n\nexport interface RdfSubjectPredicateCardinality {\n  subject: RdfCardinalityTerm;\n  predicate: RdfCardinalityTerm;\n  quadCount: number;\n  graphCount: number;\n  distinctObjects: number;\n}\n\nexport interface RdfCardinalityDistributions {\n  graphs: RdfGraphCardinality[];\n  predicates: RdfPredicateCardinality[];\n  predicateObjects: RdfPredicateObjectCardinality[];\n  subjectPredicates: RdfSubjectPredicateCardinality[];\n}\n\nexport interface RdfSchemaExplorerOptions {\n  query?: string;\n  graphPrefix?: string;\n  limit?: number;\n}\n\nexport interface RdfSchemaExplorerTermEntry {\n  term: RdfCardinalityTerm;\n  subjectQuadCount: number;\n  predicateQuadCount: number;\n  objectQuadCount: number;\n  graphQuadCount: number;\n}\n\nexport interface RdfSchemaExplorerResult {\n  graphs: RdfGraphCardinality[];\n  predicates: RdfPredicateCardinality[];\n  classes: RdfPredicateObjectCardinality[];\n  terms: RdfSchemaExplorerTermEntry[];\n}\n\nexport type RdfPathSearchDirection = 'out' | 'in' | 'both';\nexport type RdfPathEdgeDirection = 'out' | 'in';\n\nexport interface RdfBoundedPathSearchOptions {\n  start: Term;\n  target?: Term;\n  direction?: RdfPathSearchDirection;\n  predicates?: Term[];\n  graphPrefix?: string;\n  maxDepth?: number;\n  maxPaths?: number;\n}\n\nexport interface RdfBoundedPathEdge {\n  graph: Term;\n  subject: Term;\n  predicate: Term;\n  object: Term;\n  direction: RdfPathEdgeDirection;\n}\n\nexport interface RdfBoundedPath {\n  nodes: Term[];\n  edges: RdfBoundedPathEdge[];\n}\n\nexport interface RdfBoundedPathSearchResult {\n  paths: RdfBoundedPath[];\n  truncated: boolean;\n  scannedEdges: number;\n  maxDepth: number;\n}\n\nexport interface RdfQuadIndexScanResult {\n  quads: Quad[];\n  metrics: RdfIndexMetrics;\n}\n\nexport type Rdf3xTermKey = 'subject' | 'predicate' | 'object';\nexport type Rdf3xPatternKey = 'graph' | Rdf3xTermKey;\nexport type Rdf3xPermutationName = 'SPO' | 'SOP' | 'PSO' | 'POS' | 'OSP' | 'OPS';\nexport type Rdf3xPairProjectionName = 'SP' | 'SO' | 'PS' | 'PO' | 'OS' | 'OP';\nexport type Rdf3xTermProjectionName = 'S' | 'P' | 'O';\n\nexport interface Rdf3xIndexOptions {\n  path: string;\n  debug?: boolean;\n}\n\nexport interface Rdf3xGraphPrefixPattern {\n  $startsWith: string;\n}\n\nexport interface Rdf3xTermInPattern {\n  $in: Term[];\n}\n\nexport interface Rdf3xTermNotInPattern {\n  $notIn: Term[];\n}\n\nexport type Rdf3xTermTypePatternValue = 'iri' | 'blank' | 'literal' | 'numeric';\n\nexport interface Rdf3xTermMetadataPattern {\n  $termType?: Rdf3xTermTypePatternValue;\n  $language?: string;\n  $notLanguage?: string;\n  $langMatches?: string;\n  $datatype?: Term;\n  $notDatatype?: Term;\n}\n\nexport interface Rdf3xObjectRangePattern {\n  $gt?: Term | string | number;\n  $gte?: Term | string | number;\n  $lt?: Term | string | number;\n  $lte?: Term | string | number;\n}\n\nexport type Rdf3xNumericObjectRangePattern = Rdf3xObjectRangePattern;\n\nexport interface Rdf3xObjectTextSearchPattern {\n  $contains?: string;\n  $endsWith?: string;\n}\n\nexport interface Rdf3xObjectOperatorPattern extends Rdf3xObjectRangePattern, Rdf3xObjectTextSearchPattern, Rdf3xTermMetadataPattern {}\n\nexport interface Rdf3xTriplePattern {\n  graph?: Term | Rdf3xGraphPrefixPattern | Rdf3xTermInPattern | Rdf3xTermNotInPattern | Rdf3xTermMetadataPattern;\n  subject?: Term | Rdf3xTermInPattern | Rdf3xTermNotInPattern | Rdf3xTermMetadataPattern;\n  predicate?: Term | Rdf3xTermInPattern | Rdf3xTermNotInPattern | Rdf3xTermMetadataPattern;\n  object?: Term | Rdf3xObjectOperatorPattern | Rdf3xTermInPattern | Rdf3xTermNotInPattern;\n}\n\nexport interface Rdf3xTripleScanOptions {\n  order?: Array<'graph' | 'subject' | 'predicate' | 'object'>;\n  orderDirections?: Array<'asc' | 'desc'>;\n  reverse?: boolean;\n  limit?: number;\n  offset?: number;\n}\n\nexport interface Rdf3xIndexMetrics {\n  engine: 'solid-rdf3x';\n  indexChoice: Rdf3xPermutationName | 'source-membership' | 'none';\n  matchedRows: number;\n  returnedRows: number;\n  durationMs: number;\n  queryPlan?: string[];\n}\n\nexport interface Rdf3xTripleScanResult {\n  quads: Quad[];\n  metrics: Rdf3xIndexMetrics;\n}\n\nexport interface Rdf3xCountResult {\n  count: number;\n  metrics: Rdf3xIndexMetrics;\n}\n\nexport interface Rdf3xJoinOptions {\n  orderBy?: RdfQuadJoinOrder[];\n  limit?: number;\n  offset?: number;\n  project?: string[];\n  distinct?: boolean;\n  countMatchedRows?: boolean;\n  values?: RdfValuesBindingSource[];\n}\n\nexport interface Rdf3xJoinMetrics {\n  engine: 'solid-rdf3x';\n  indexChoice: string;\n  matchedRows: number;\n  returnedRows: number;\n  durationMs: number;\n  queryPlan?: string[];\n}\n\nexport interface Rdf3xJoinScanResult {\n  bindings: RdfBindingRow[];\n  metrics: Rdf3xJoinMetrics;\n}\n\nexport interface Rdf3xRebuildResult {\n  mode?: 'full' | 'incremental';\n  scannedQuads: number;\n  uniqueTriples: number;\n  memberships: number;\n  projectionRows: number;\n  factsDataVersion: number;\n  durationMs: number;\n  dirtyGraphs?: number;\n  dirtyPairs?: number;\n  dirtyTerms?: number;\n}\n\nexport interface Rdf3xCardinalityEstimate {\n  uniqueTriples: number;\n  matchingQuads: number;\n  source: 'projection-stat' | 'term-stat' | 'exact-triple' | 'exact-membership' | 'full-count';\n  indexChoice: Rdf3xPermutationName | 'source-membership' | 'none';\n}\n\nexport interface Rdf3xIndexStats {\n  uniqueTriples: number;\n  membershipCount: number;\n  graphCount: number;\n  factsDataVersion: number;\n  permutationRows: Record<Rdf3xPermutationName, number>;\n  pairProjectionRows: Record<Rdf3xPairProjectionName, number>;\n  termProjectionRows: Record<Rdf3xTermProjectionName, number>;\n  databaseBytes: number;\n  tableBytes: number;\n  indexBytes: number;\n  spaceObjects: RdfIndexSpaceObject[];\n}\n\nexport interface Rdf3xShadowBindingDiff {\n  missingFromRdf3x: string[];\n  extraInRdf3x: string[];\n}\n\nexport interface Rdf3xShadowQuadDiff {\n  missingFromRdf3x: string[];\n  extraInRdf3x: string[];\n}\n\nexport interface Rdf3xShadowScanResult {\n  matched: boolean;\n  orderedMatch: boolean;\n  primary: Quad[];\n  rdf3x: Quad[];\n  diff: Rdf3xShadowQuadDiff;\n  primaryMetrics: RdfIndexMetrics;\n  rdf3xMetrics: Rdf3xIndexMetrics;\n  rebuild: Rdf3xRebuildResult;\n}\n\nexport interface Rdf3xShadowJoinResult {\n  matched: boolean;\n  orderedMatch: boolean;\n  primary: RdfBindingRow[];\n  rdf3x: RdfBindingRow[];\n  diff: Rdf3xShadowBindingDiff;\n  primaryMetrics: RdfIndexMetrics;\n  rdf3xMetrics: Rdf3xJoinMetrics;\n  rebuild: Rdf3xRebuildResult;\n}\n\nexport type RdfQuadTupleConstraint = Partial<Record<RdfQueryPatternKey, Term>>;\n\nexport interface RdfQuadTupleConstraintSource {\n  columns: RdfQueryPatternKey[];\n  rows: RdfQuadTupleConstraint[];\n}\n\nexport interface RdfQuadJoinPattern {\n  pattern: QuintPattern;\n  variables: Partial<Record<RdfQueryPatternKey, string>>;\n}\n\nexport interface RdfQuadJoinOrder {\n  variable: string;\n  direction?: 'asc' | 'desc';\n}\n\nexport interface RdfSlotTermKeyRange {\n  slot: RdfQueryPatternKey;\n  lower?: number;\n  upper?: number;\n  lowerInclusive?: boolean;\n  upperExclusive?: boolean;\n}\n\nexport interface RdfQuadScanOptions extends QueryOptions {\n  orderDirections?: Array<'asc' | 'desc'>;\n  slotTermRanges?: RdfSlotTermKeyRange[];\n}\n\nexport interface RdfQuadJoinOptions {\n  orderBy?: RdfQuadJoinOrder[];\n  limit?: number;\n  offset?: number;\n  project?: string[];\n  distinct?: boolean;\n  countMatchedRows?: boolean;\n}\n\nexport interface RdfQuadJoinAggregateOptions {\n  aggregates: RdfQueryAggregate[];\n}\n\nexport type RdfQuadJoinCountOptions = RdfQuadJoinAggregateOptions;\n\nexport interface RdfQuadJoinGroupAggregateHaving {\n  aggregate: string;\n  operator: '$eq' | '$ne' | '$gt' | '$gte' | '$lt' | '$lte';\n  value: number;\n}\n\nexport type RdfQuadJoinGroupCountHaving = RdfQuadJoinGroupAggregateHaving;\n\nexport interface RdfPatternQuery {\n  pattern: QuintPattern;\n  options?: RdfQuadScanOptions;\n}\n\nexport interface RdfQueryVariable {\n  variable: string;\n}\n\nexport type RdfQueryTermPattern = TermMatch | RdfQueryVariable;\n\nexport interface RdfQueryPattern {\n  graph?: RdfQueryTermPattern;\n  subject?: RdfQueryTermPattern;\n  predicate?: RdfQueryTermPattern;\n  object?: RdfQueryTermPattern;\n}\n\nexport interface RdfConstructTemplate {\n  subject: RdfQueryTermPattern;\n  predicate: RdfQueryTermPattern;\n  object: RdfQueryTermPattern;\n}\n\nexport interface RdfQueryOrder {\n  variable: string;\n  direction?: 'asc' | 'desc';\n}\n\nexport type RdfQueryAggregateType = 'count' | 'sum' | 'avg' | 'min' | 'max';\n\nexport interface RdfQueryAggregate {\n  type: RdfQueryAggregateType;\n  as: string;\n  variable?: string;\n  distinct?: boolean;\n  distinctVariables?: string[];\n}\n\nexport type RdfBindExpression =\n  | { type: 'term'; term: Term }\n  | { type: 'variable'; variable: string }\n  | { type: 'stringValue'; variable: string }\n  | { type: 'stringLength'; variable: string }\n  | { type: 'lowerCase'; expression: RdfBindExpression }\n  | { type: 'upperCase'; expression: RdfBindExpression }\n  | { type: 'coalesce'; expressions: RdfBindExpression[] }\n  | { type: 'if'; condition: RdfQueryFilter[]; then: RdfBindExpression; else: RdfBindExpression }\n  | { type: 'numericValue'; expression: RdfBindExpression }\n  | { type: 'add'; expressions: RdfBindExpression[] }\n  | { type: 'multiply'; expressions: RdfBindExpression[] }\n  | {\n    type: 'substring';\n    expression: RdfBindExpression;\n    start: RdfBindExpression;\n    length?: RdfBindExpression;\n  }\n  | { type: 'concat'; expressions: RdfBindExpression[] }\n  | { type: 'iri'; expression: RdfBindExpression; base: string }\n  | { type: 'strdt'; lexical: RdfBindExpression; datatype: RdfBindExpression }\n  | { type: 'strlang'; lexical: RdfBindExpression; language: RdfBindExpression };\n\nexport interface RdfQueryBind {\n  variable: string;\n  expression: RdfBindExpression;\n}\n\nexport type RdfQueryFilterOperator =\n  | '$eq'\n  | '$ne'\n  | '$gt'\n  | '$gte'\n  | '$lt'\n  | '$lte'\n  | '$in'\n  | '$notIn'\n  | '$startsWith'\n  | '$contains'\n  | '$endsWith'\n  | '$regex'\n  | '$notStartsWith'\n  | '$notContains'\n  | '$notEndsWith'\n  | '$notRegex'\n  | '$bound'\n  | '$termType'\n  | '$notTermType'\n  | '$sameTerm'\n  | '$notSameTerm'\n  | '$lang'\n  | '$notLang'\n  | '$langIn'\n  | '$notLangIn'\n  | '$langMatches'\n  | '$notLangMatches'\n  | '$datatype'\n  | '$notDatatype'\n  | '$datatypeIn'\n  | '$notDatatypeIn';\n\nexport type RdfQueryFilterValue = Term | string | number | boolean;\n\nexport interface RdfQueryFilter {\n  variable: string;\n  operator: RdfQueryFilterOperator;\n  operand?: 'stringLength' | 'stringValue' | 'lowerStringValue' | 'upperStringValue';\n  value?: RdfQueryFilterValue;\n  values?: RdfQueryFilterValue[];\n  variable2?: string;\n  flags?: string;\n  source?: 'filter' | 'values';\n}\n\nexport interface RdfValuesBindingSource {\n  variables: string[];\n  rows: RdfBindingRow[];\n}\n\nexport interface RdfMaterializedViewBindingSource {\n  key: string;\n  version?: string | number;\n  scope?: RdfQueryCacheScope;\n  variables?: string[];\n  limit?: number;\n  offset?: number;\n  required?: boolean;\n}\n\nexport interface RdfMaterializedViewBuildInput {\n  key: string;\n  version?: string | number;\n  query: RdfQuery;\n  variables?: string[];\n  scope?: RdfQueryCacheScope;\n  activate?: boolean;\n  maxRows?: number;\n}\n\nexport interface RdfMaterializedViewBuildResult {\n  key: string;\n  version: string;\n  scopeHash: string;\n  factsDataVersion: number;\n  variables: string[];\n  rowCount: number;\n  active: boolean;\n}\n\nexport interface RdfMaterializedViewReadResult extends RdfValuesBindingSource {\n  key: string;\n  version: string;\n  scopeHash: string;\n  factsDataVersion: number;\n  rowCount: number;\n  active: boolean;\n  createdAt: string;\n  activatedAt?: string;\n}\n\nexport interface RdfMaterializedViewActivationInput extends RdfMaterializedViewBindingSource {\n  factsDataVersion?: number;\n}\n\nexport interface RdfMaterializedViewActivationResult {\n  key: string;\n  version: string;\n  scopeHash: string;\n  factsDataVersion: number;\n  activated: boolean;\n  previousFactsDataVersion?: number;\n}\n\nexport interface RdfSearchScope {\n  workspace?: string;\n  sourcePrefix?: string;\n  localPathPrefix?: string;\n  accessBasePath?: string;\n  allowedSources?: string[];\n  deniedSources?: string[];\n  deniedSourcePrefixes?: string[];\n}\n\nexport interface RdfTextSearchPattern {\n  query: string;\n  scope?: RdfSearchScope;\n  entities?: string[];\n  limit?: number;\n  candidateLimit?: number;\n  offset?: number;\n  perSourceLimit?: number;\n  orderBy?: RdfTextSearchOrder[];\n  source?: string;\n  chunk?: string;\n  content?: string;\n  heading?: string;\n  score?: string;\n  scoreComponents?: string;\n  workspace?: string;\n  localPath?: string;\n  contentType?: string;\n  sourceKey?: string;\n  retrievalPoint?: string;\n  retrievalKind?: string;\n  entityProvenance?: string;\n  ordinal?: string;\n  level?: string;\n  startOffset?: string;\n  endOffset?: string;\n}\n\nexport type RdfVectorDistanceMetric = 'cosine' | 'dot' | 'euclidean';\n\nexport type RdfSearchOrderDirection = 'asc' | 'desc';\nexport type RdfTextSearchOrderField = 'score' | 'source' | 'localPath' | 'ordinal' | 'startOffset' | 'endOffset';\nexport type RdfVectorSearchOrderField = RdfTextSearchOrderField | 'distance';\n\nexport interface RdfTextSearchOrder {\n  field: RdfTextSearchOrderField;\n  direction?: RdfSearchOrderDirection;\n}\n\nexport interface RdfVectorSearchOrder {\n  field: RdfVectorSearchOrderField;\n  direction?: RdfSearchOrderDirection;\n}\n\nexport interface RdfVectorSearchPattern {\n  embedding: number[];\n  metric?: RdfVectorDistanceMetric;\n  vectorProvider?: string;\n  vectorModel?: string;\n  vectorModelVersion?: string;\n  vectorInputKind?: string;\n  vectorInputHash?: string;\n  vectorProjectionPolicyVersion?: string;\n  scope?: RdfSearchScope;\n  limit?: number;\n  candidateLimit?: number;\n  offset?: number;\n  threshold?: number;\n  orderBy?: RdfVectorSearchOrder[];\n  source?: string;\n  chunk?: string;\n  content?: string;\n  heading?: string;\n  score?: string;\n  distance?: string;\n  scoreComponents?: string;\n  workspace?: string;\n  localPath?: string;\n  contentType?: string;\n  sourceKey?: string;\n  retrievalPoint?: string;\n  ordinal?: string;\n  level?: string;\n  startOffset?: string;\n  endOffset?: string;\n  provider?: string;\n  model?: string;\n  modelVersion?: string;\n  inputKind?: string;\n  inputHash?: string;\n  projectionPolicyVersion?: string;\n}\n\nexport type RdfQueryCacheMode = 'default' | 'bypass' | 'refresh';\n\nexport interface RdfQueryMaterializedResultOptions {\n  key: string;\n  version?: string | number;\n  ttlMs?: number;\n}\n\nexport interface RdfQueryCacheScopeDescriptor {\n  principal?: string;\n  basePath?: string;\n  mode?: string;\n  authorizationModel?: string;\n  permissionVersion?: string | number;\n  allowedGraphUrls?: string[];\n  deniedGraphUrls?: string[];\n  deniedGraphPrefixes?: string[];\n  components?: RdfQueryCacheScope[];\n}\n\nexport type RdfQueryCacheScope = string | RdfQueryCacheScopeDescriptor | RdfQueryCacheScope[];\n\nexport interface RdfQueryCacheOptions {\n  /** Auth/principal/business scope that must be isolated in the cache key. */\n  scope?: RdfQueryCacheScope;\n  materialized?: string | RdfQueryMaterializedResultOptions;\n  mode?: RdfQueryCacheMode;\n  ttlMs?: number;\n}\n\nexport interface RdfQuery {\n  patterns: RdfQueryPattern[];\n  values?: RdfValuesBindingSource[];\n  materializedViews?: RdfMaterializedViewBindingSource[];\n  textSearch?: RdfTextSearchPattern[];\n  vectorSearch?: RdfVectorSearchPattern[];\n  unions?: RdfUnionQueryGroup[];\n  minus?: RdfMinusQueryGroup[];\n  exists?: RdfExistsQueryGroup[];\n  optional?: Array<RdfQueryPattern[] | RdfOptionalQueryGroup>;\n  binds?: RdfQueryBind[];\n  postOptionalBinds?: RdfQueryBind[];\n  filters?: RdfQueryFilter[];\n  having?: RdfQueryFilter[];\n  select?: string[];\n  distinct?: boolean;\n  groupBy?: string[];\n  aggregates?: RdfQueryAggregate[];\n  aggregate?: RdfQueryAggregate;\n  orderBy?: RdfQueryOrder[];\n  limit?: number;\n  offset?: number;\n  cache?: RdfQueryCacheOptions;\n}\n\nexport interface RdfUnionQueryBranch {\n  patterns: RdfQueryPattern[];\n  values?: RdfValuesBindingSource[];\n  unions?: RdfUnionQueryGroup[];\n  optional?: Array<RdfQueryPattern[] | RdfOptionalQueryGroup>;\n  binds?: RdfQueryBind[];\n  filters?: RdfQueryFilter[];\n}\n\nexport interface RdfUnionQueryGroup {\n  branches: RdfUnionQueryBranch[];\n}\n\nexport interface RdfMinusQueryGroup {\n  patterns: RdfQueryPattern[];\n  values?: RdfValuesBindingSource[];\n  unions?: RdfUnionQueryGroup[];\n  optional?: Array<RdfQueryPattern[] | RdfOptionalQueryGroup>;\n  binds?: RdfQueryBind[];\n  filters?: RdfQueryFilter[];\n}\n\nexport interface RdfExistsQueryGroup {\n  patterns: RdfQueryPattern[];\n  values?: RdfValuesBindingSource[];\n  unions?: RdfUnionQueryGroup[];\n  optional?: Array<RdfQueryPattern[] | RdfOptionalQueryGroup>;\n  binds?: RdfQueryBind[];\n  filters?: RdfQueryFilter[];\n}\n\nexport interface RdfOptionalQueryGroup {\n  patterns: RdfQueryPattern[];\n  values?: RdfValuesBindingSource[];\n  unions?: RdfUnionQueryGroup[];\n  optional?: Array<RdfQueryPattern[] | RdfOptionalQueryGroup>;\n  minus?: RdfMinusQueryGroup[];\n  exists?: RdfExistsQueryGroup[];\n  binds?: RdfQueryBind[];\n  filters?: RdfQueryFilter[];\n}\n\nexport type RdfBindingRow = Record<string, Term>;\n\nexport interface RdfQuadJoinScanResult {\n  bindings: RdfBindingRow[];\n  metrics: RdfIndexMetrics;\n}\n\nexport interface RdfQuadJoinGroupAggregateOptions {\n  groupBy: string[];\n  aggregates: RdfQueryAggregate[];\n  having?: RdfQuadJoinGroupAggregateHaving[];\n  orderBy?: RdfQuadJoinOrder[];\n  limit?: number;\n  offset?: number;\n}\n\nexport type RdfQuadJoinGroupCountOptions = RdfQuadJoinGroupAggregateOptions;\n\nexport interface RdfQueryMetrics {\n  engine: 'solid-rdf';\n  plan: string[];\n  explain?: RdfQueryExplain;\n  nativeProfile?: unknown;\n  scannedRows: number;\n  joinedRows: number;\n  returnedRows: number;\n  durationMs: number;\n  indexChoices: string[];\n  cardinalityEstimates?: number;\n  distinctCardinalityEstimates?: number;\n  searchCardinalityEstimates?: number;\n  filtersApplied: number;\n  filtersPushedDown: number;\n}\n\nexport interface RdfQueryExplain {\n  engine: 'solid-rdf' | 'postgres-rdf';\n  factsDataVersion?: number;\n  derived?: {\n    profile: RdfDerivedIndexProfile;\n    factsDataVersion?: number;\n    syncedWithFacts?: boolean;\n  };\n  planner?: RdfQueryPlannerExplain;\n  cache?: {\n    template?: RdfQueryTemplateCacheExplain;\n    result?: RdfQueryCacheExplain;\n    materialized?: RdfQueryCacheExplain;\n    scope?: RdfQueryCacheScopeExplain;\n  };\n  acceleration?: {\n    profile: RdfPgAccelerationProfile;\n    requested: boolean;\n    enabled: boolean;\n    provider?: RdfPgAccelerationProvider;\n    fallbackReason?: RdfPgAccelerationFallbackReason;\n    activeOperators?: string[];\n    unsupportedCapabilities?: string[];\n  };\n}\n\nexport type RdfQueryPlannerSelectedPath =\n  | 'materialized-result-cache'\n  | 'query-result-cache'\n  | 'native-extension'\n  | 'rdf3x'\n  | 'facts'\n  | 'unknown';\n\nexport interface RdfQueryPlannerExplain {\n  selectedPath: RdfQueryPlannerSelectedPath;\n  reasons: string[];\n  estimateInputs: string[];\n  availableStats: string[];\n  runtime: RdfQueryPlannerRuntimeExplain;\n  staleStats?: RdfQueryPlannerStaleStatsExplain;\n  slowQuery?: RdfQueryPlannerSlowQueryExplain;\n  histogramHints?: RdfQueryPlannerHistogramHint[];\n  rejectedCapabilities?: string[];\n  rejectedNativeOperators?: RdfQueryPlannerNativeOperatorRejection[];\n}\n\nexport interface RdfQueryPlannerNativeOperatorRejection {\n  capability: string;\n  reason: string;\n}\n\nexport interface RdfQueryPlannerRuntimeExplain {\n  durationMs: number;\n  scannedRows: number;\n  joinedRows: number;\n  returnedRows: number;\n  filtersApplied: number;\n  filtersPushedDown: number;\n  indexChoices: string[];\n  planSize: number;\n}\n\nexport interface RdfQueryPlannerStaleStatsExplain {\n  factsDataVersion: number;\n  rdf3xFactsDataVersion: number;\n  stale: boolean;\n  lag: number;\n}\n\nexport interface RdfQueryPlannerSlowQueryExplain {\n  durationMs: number;\n  thresholdMs: number;\n  scannedRows: number;\n  scannedRowsThreshold: number;\n  scanAmplification: number;\n  reasons: string[];\n}\n\nexport type RdfQueryPlannerHistogramHintKind =\n  | 'graph'\n  | 'predicate'\n  | 'predicate-object'\n  | 'subject-predicate';\n\nexport interface RdfQueryPlannerHistogramHint {\n  kind: RdfQueryPlannerHistogramHintKind;\n  patternIndex: number;\n  quadCount: number;\n  graphCount?: number;\n  distinctSubjects?: number;\n  distinctPredicates?: number;\n  distinctObjects?: number;\n  subject?: RdfCardinalityTerm;\n  predicate?: RdfCardinalityTerm;\n  object?: RdfCardinalityTerm;\n  graph?: RdfCardinalityTerm;\n}\n\nexport type RdfQueryCacheStatus =\n  | 'hit'\n  | 'miss'\n  | 'refresh'\n  | 'store'\n  | 'bypass'\n  | 'disabled'\n  | 'not-applicable';\n\nexport interface RdfQueryTemplateCacheExplain {\n  status: 'hit' | 'miss' | 'bypass';\n  key?: string;\n  maxEntries: number;\n  ttlMs: number;\n}\n\nexport interface RdfQueryCacheExplain {\n  status: RdfQueryCacheStatus;\n  key?: string;\n  templateKey?: string;\n  factsDataVersion?: number;\n  ttlMs?: number;\n  maxEntries?: number;\n  maxBytes?: number;\n  stored?: boolean;\n}\n\nexport interface RdfQueryCacheScopeExplain {\n  hash: string;\n  shape: string;\n  principal: string | null;\n  basePath: string | null;\n  mode: string | null;\n  authorizationModel: string | null;\n  permissionVersion: string | null;\n  allowedGraphUrls?: string[] | null;\n  deniedGraphUrls?: string[] | null;\n  deniedGraphPrefixes?: string[] | null;\n}\n\nexport interface RdfQueryResult {\n  bindings: RdfBindingRow[];\n  count?: number;\n  metrics: RdfQueryMetrics;\n}\n\nexport type RdfTermRewriteScope = 'graph' | 'source' | 'system' | 'safe_projection';\nexport type RdfTermRewriteMode = 'direct' | 'remap_existing' | 'safe';\n\nexport interface RdfTermRewriteInput {\n  oldPrefix: string;\n  newPrefix: string;\n  /** Conservative scope. P0 callers should use graph/source/system only. */\n  scope?: RdfTermRewriteScope;\n  /** safe = direct when possible, remap when needed, skip unsafe mixed terms. */\n  mode?: RdfTermRewriteMode;\n  /** Optional exact source URI boundaries for system projection moves. */\n  sources?: string[];\n}\n\nexport interface RdfTermRewriteSkippedTerm {\n  id: number;\n  value: string;\n  reason: 'not_named_node' | 'outside_scope' | 'mixed_usage' | 'collision_conflict';\n}\n\nexport interface RdfTermRewriteResult {\n  matchedTerms: number;\n  rewrittenTerms: number;\n  remappedTerms: number;\n  skippedTerms: RdfTermRewriteSkippedTerm[];\n  affectedQuads: number;\n}\n\nexport interface RdfNativeSparqlAccessScope {\n  basePath: string;\n  mode: string;\n  principal?: string;\n  allowedGraphUrls?: string[];\n  deniedGraphUrls?: string[];\n  deniedGraphPrefixes?: string[];\n  version?: string;\n}\n\nexport interface RdfNativeSparqlQueryOptions {\n  basePath: string;\n  operation?: string;\n  timeoutMs?: number;\n  acceptMediaType?: string;\n  loadDocument?: RdfNativeSparqlLoadDocumentOptions;\n  accessScope?: RdfNativeSparqlAccessScope;\n}\n\nexport interface RdfNativeSparqlLoadDocumentOptions {\n  sourceUri: string;\n  body: string;\n  mediaType?: string;\n}\n\nexport interface RdfNativeSparqlResult {\n  status: 'ok' | 'unsupported' | 'error';\n  mediaType: string;\n  body: string;\n  profile?: unknown;\n  error?: string;\n}\n\nexport interface RdfEngineLike {\n  open(): void | Promise<void>;\n  close(): void | Promise<void>;\n  put(quads: Quad | Quad[], options?: RdfIndexPutOptions): void | Promise<void>;\n  replaceSource(quads: Quad[], source: RdfSourceInput): void | Promise<void>;\n  deleteSource(source: string): number | Promise<number>;\n  moveSource?(oldSource: string, next: RdfSourceInput): number | Promise<number>;\n  indexTextSource?(source: RdfTextSourceInput, text: string, chunks?: RdfTextChunkInput[]): void | Promise<void>;\n  deleteTextSource?(source: string): number | Promise<number>;\n  indexVectorSource?(source: RdfVectorSourceInput, chunks: RdfVectorChunkInput[]): void | Promise<void>;\n  deleteVectorSource?(source: string): number | Promise<number>;\n  delete(pattern: QuintPattern): number | Promise<number>;\n  applyDelta(\n    deletes: QuintPattern[],\n    inserts: Quad[],\n    options?: RdfIndexPutOptions,\n  ): { deletedRows: number; insertedRows: number } | Promise<{ deletedRows: number; insertedRows: number }>;\n  scan(query: RdfPatternQuery): RdfQuadIndexScanResult | Promise<RdfQuadIndexScanResult>;\n  query(query: RdfQuery): RdfQueryResult | Promise<RdfQueryResult>;\n  sparqlQuery?(query: string, options: RdfNativeSparqlQueryOptions): RdfNativeSparqlResult | Promise<RdfNativeSparqlResult>;\n  rewriteTerms?(input: RdfTermRewriteInput): RdfTermRewriteResult | Promise<RdfTermRewriteResult>;\n  materializeView?(input: RdfMaterializedViewBuildInput): RdfMaterializedViewBuildResult | Promise<RdfMaterializedViewBuildResult>;\n  readMaterializedView?(source: RdfMaterializedViewBindingSource): RdfMaterializedViewReadResult | undefined | Promise<RdfMaterializedViewReadResult | undefined>;\n  activateMaterializedView?(source: RdfMaterializedViewActivationInput): RdfMaterializedViewActivationResult | Promise<RdfMaterializedViewActivationResult>;\n  deleteMaterializedView?(source: RdfMaterializedViewBindingSource): number | Promise<number>;\n  exploreSchema?(options?: RdfSchemaExplorerOptions): RdfSchemaExplorerResult | Promise<RdfSchemaExplorerResult>;\n  searchPaths?(options: RdfBoundedPathSearchOptions): RdfBoundedPathSearchResult | Promise<RdfBoundedPathSearchResult>;\n  invalidateQueryResultCache?(scope?: RdfQueryCacheScope): number | Promise<number>;\n  refreshDerivedIndexes(options?: RdfDerivedIndexRefreshOptions): RdfDerivedIndexRefreshResult | Promise<RdfDerivedIndexRefreshResult>;\n  storageStats(options?: RdfStorageStatsOptions): RdfEngineStorageStats | Promise<RdfEngineStorageStats>;\n}\n\nexport type RdfQueryPatternKey = TermName;\n\nexport interface RdfShadowDiff {\n  missingFromPrimary: string[];\n  extraInPrimary: string[];\n}\n\nexport interface RdfShadowBackfillOptions {\n  clear?: boolean;\n  batchSize?: number;\n}\n\nexport interface RdfShadowBackfillResult {\n  scannedRows: number;\n  indexedRows: number;\n  batchCount: number;\n  durationMs: number;\n}\n\nexport interface RdfShadowScanResult {\n  matched: boolean;\n  orderedMatch: boolean;\n  primary: Quad[];\n  compatibility: Quad[];\n  diff: RdfShadowDiff;\n  metrics: RdfIndexMetrics;\n}\n\nexport interface RdfTextIndexOptions {\n  path: string;\n  maxSourceBytes?: number;\n  maxChunksPerSource?: number;\n}\n\nexport type MaybePromise<T> = T | Promise<T>;\n\nexport interface RdfTextIndexLike {\n  open(): MaybePromise<void>;\n  close(): MaybePromise<void>;\n  clear(): MaybePromise<void>;\n  schemaVersion(): MaybePromise<number>;\n  sourceMetadata(source: string): MaybePromise<RdfTextSourceMetadata | undefined>;\n  recordRebuildStatus(input: RdfTextRebuildStatusInput): MaybePromise<void>;\n  rebuildStatus(source: string): MaybePromise<RdfTextRebuildStatus | undefined>;\n  indexText(source: RdfTextSourceInput, text: string, chunks?: RdfTextChunkInput[]): MaybePromise<void>;\n  moveSource(oldSource: string, next: RdfTextSourceInput): MaybePromise<number>;\n  deleteSource(source: string): MaybePromise<number>;\n  search(options: RdfTextSearchOptions): MaybePromise<RdfTextSearchResult[]>;\n  estimateSearchCardinality(options: RdfTextSearchOptions): MaybePromise<RdfSearchCardinalityEstimate>;\n  stats(): MaybePromise<RdfTextIndexStats>;\n  termDocumentFrequency(limit?: number): MaybePromise<RdfTextTermDocumentFrequency[]>;\n}\n\nexport interface RdfTextIndexSyncLike extends RdfTextIndexLike {\n  open(): void;\n  close(): void;\n  clear(): void;\n  indexText(source: RdfTextSourceInput, text: string, chunks?: RdfTextChunkInput[]): void;\n  moveSource(oldSource: string, next: RdfTextSourceInput): number;\n  deleteSource(source: string): number;\n  search(options: RdfTextSearchOptions): RdfTextSearchResult[];\n  estimateSearchCardinality(options: RdfTextSearchOptions): RdfSearchCardinalityEstimate;\n  stats(): RdfTextIndexStats;\n  termDocumentFrequency(limit?: number): RdfTextTermDocumentFrequency[];\n}\n\nexport interface RdfTextSourceInput {\n  sourceKey?: string;\n  source: string;\n  workspace: string;\n  localPath?: string;\n  contentType?: string;\n  sourceVersion?: string;\n  sourceHash?: string;\n}\n\nexport interface RdfTextSourceMetadata extends RdfTextSourceInput {\n  updatedAt: string;\n}\n\nexport type RdfTextRebuildStatusKind = 'indexed' | 'skipped' | 'capped' | 'error';\n\nexport interface RdfTextRebuildStatusInput extends RdfTextSourceInput {\n  status: RdfTextRebuildStatusKind;\n  reason?: string;\n  message?: string;\n}\n\nexport interface RdfTextRebuildStatus extends RdfTextRebuildStatusInput {\n  updatedAt: string;\n}\n\nexport type RdfTextRetrievalKind = 'entity-card' | 'field-chunk' | 'file-chunk' | 'folder-card';\n\nexport interface RdfTextChunkInput {\n  chunkKey: string;\n  retrievalKind?: RdfTextRetrievalKind;\n  ordinal: number;\n  level: number;\n  heading?: string;\n  path?: string[];\n  content: string;\n  startOffset: number;\n  endOffset: number;\n  entities?: RdfTextEntityInput[];\n}\n\nexport interface RdfTextEntityInput {\n  entity: string;\n  predicate?: string;\n  label?: string;\n  value?: string;\n  datatype?: string;\n  language?: string;\n  policyRole?: string;\n  occurrences?: number;\n}\n\nexport interface RdfTextEntityMention {\n  entity: string;\n  predicate?: string;\n  label?: string;\n  value?: string;\n  datatype?: string;\n  language?: string;\n  policyRole?: string;\n  occurrences: number;\n}\n\nexport interface RdfTextChunkRow {\n  id: number;\n  source_id: number;\n  source_key: string | null;\n  source: string;\n  workspace: string;\n  local_path: string | null;\n  content_type: string | null;\n  source_version: string | null;\n  source_hash: string | null;\n  chunk_key: string;\n  retrieval_kind: string | null;\n  ordinal: number;\n  level: number;\n  heading: string | null;\n  path: string | null;\n  content: string;\n  start_offset: number;\n  end_offset: number;\n  normalized_text: string;\n  token_count: number;\n  updated_at: string;\n}\n\nexport interface RdfTextSearchOptions {\n  query: string;\n  entities?: string[];\n  source?: string;\n  workspace?: string;\n  sourcePrefix?: string;\n  localPathPrefix?: string;\n  allowedSources?: string[];\n  deniedSources?: string[];\n  deniedSourcePrefixes?: string[];\n  limit?: number;\n  offset?: number;\n  perSourceLimit?: number;\n  orderBy?: RdfTextSearchOrder[];\n}\n\nexport interface RdfTextSearchResult {\n  source: string;\n  workspace: string;\n  localPath?: string;\n  contentType?: string;\n  sourceVersion?: string;\n  sourceHash?: string;\n  sourceKey: string;\n  chunkKey: string;\n  retrievalPointKey: string;\n  retrievalKind: RdfTextRetrievalKind;\n  ordinal: number;\n  level: number;\n  heading?: string;\n  path: string[];\n  content: string;\n  startOffset: number;\n  endOffset: number;\n  scoreComponents?: RdfTextScoreComponents;\n  score: number;\n  entities: RdfTextEntityMention[];\n}\n\nexport interface RdfTextScoreComponents {\n  sourceType: 'text';\n  algorithm: 'occurrence-heading-boost' | 'pg-ts-rank-cd';\n  normalizedQuery: string;\n  occurrenceScore: number;\n  headingBoost: number;\n  nativeRank?: number;\n  score: number;\n}\n\nexport interface RdfSearchCardinalityEstimate {\n  rows: number;\n  source: 'text-normalized-scan' | 'text-term-posting' | 'pg-native-fts' | 'vector-candidate-count' | 'vector-component-score' | 'pg-vector-score';\n  indexChoice: string;\n}\n\nexport interface RdfTextIndexStats {\n  sourceCount: number;\n  chunkCount: number;\n  entityMentionCount: number;\n  databaseBytes: number;\n  termDocumentFrequency: RdfTextTermDocumentFrequency[];\n}\n\nexport interface RdfTextTermDocumentFrequency {\n  term: string;\n  sourceCount: number;\n  chunkCount: number;\n  totalOccurrences: number;\n}\n\nexport interface RdfVectorIndexOptions {\n  path: string;\n  defaultMetric?: RdfVectorDistanceMetric;\n}\n\nexport interface RdfVectorIndexLike {\n  open(): MaybePromise<void>;\n  close(): MaybePromise<void>;\n  clear(): MaybePromise<void>;\n  indexVector(source: RdfVectorSourceInput, chunks: RdfVectorChunkInput[]): MaybePromise<void>;\n  deleteSource(source: string): MaybePromise<number>;\n  search(options: RdfVectorSearchOptions): MaybePromise<RdfVectorSearchResult[]>;\n  summaryLifecycle(options?: RdfVectorSummaryLifecycleOptions): MaybePromise<RdfVectorSummaryLifecycleEntry[]>;\n  estimateSearchCardinality(options: RdfVectorSearchOptions): MaybePromise<RdfSearchCardinalityEstimate>;\n  stats(): MaybePromise<RdfVectorIndexStats>;\n  modelDistribution(): MaybePromise<RdfVectorModelDistribution[]>;\n}\n\nexport interface RdfVectorIndexSyncLike extends RdfVectorIndexLike {\n  open(): void;\n  close(): void;\n  clear(): void;\n  indexVector(source: RdfVectorSourceInput, chunks: RdfVectorChunkInput[]): void;\n  deleteSource(source: string): number;\n  search(options: RdfVectorSearchOptions): RdfVectorSearchResult[];\n  summaryLifecycle(options?: RdfVectorSummaryLifecycleOptions): RdfVectorSummaryLifecycleEntry[];\n  estimateSearchCardinality(options: RdfVectorSearchOptions): RdfSearchCardinalityEstimate;\n  stats(): RdfVectorIndexStats;\n  modelDistribution(): RdfVectorModelDistribution[];\n}\n\nexport interface RdfVectorSourceInput {\n  sourceKey?: string;\n  source: string;\n  workspace: string;\n  localPath?: string;\n  contentType?: string;\n  sourceVersion?: string;\n  sourceHash?: string;\n}\n\nexport interface RdfVectorChunkInput {\n  chunkKey: string;\n  ordinal: number;\n  level: number;\n  embedding: number[];\n  provider?: string;\n  model?: string;\n  modelVersion?: string;\n  inputKind?: string;\n  inputHash?: string;\n  projectionPolicyVersion?: string;\n  heading?: string;\n  path?: string[];\n  content: string;\n  startOffset: number;\n  endOffset: number;\n  summaryMetadata?: RdfVectorSummaryMetadata;\n}\n\nexport interface RdfVectorChunkRow {\n  id: number;\n  source_id: number;\n  source_key: string;\n  source: string;\n  workspace: string;\n  local_path: string | null;\n  content_type: string | null;\n  source_version: string | null;\n  source_hash: string | null;\n  chunk_key: string;\n  ordinal: number;\n  level: number;\n  heading: string | null;\n  path: string | null;\n  content: string;\n  start_offset: number;\n  end_offset: number;\n  embedding_json: string;\n  summary_metadata: string | null;\n  dimensions: number;\n  magnitude: number;\n  provider: string;\n  model: string;\n  model_version: string;\n  input_kind: string;\n  input_hash: string;\n  projection_policy_version: string;\n  updated_at: string;\n}\n\nexport interface RdfVectorSearchOptions {\n  embedding: number[];\n  metric?: RdfVectorDistanceMetric;\n  provider?: string;\n  model?: string;\n  modelVersion?: string;\n  inputKind?: string;\n  inputHash?: string;\n  projectionPolicyVersion?: string;\n  source?: string;\n  workspace?: string;\n  sourcePrefix?: string;\n  localPathPrefix?: string;\n  allowedSources?: string[];\n  deniedSources?: string[];\n  deniedSourcePrefixes?: string[];\n  limit?: number;\n  offset?: number;\n  threshold?: number;\n  orderBy?: RdfVectorSearchOrder[];\n}\n\nexport interface RdfVectorSearchResult {\n  source: string;\n  workspace: string;\n  localPath?: string;\n  contentType?: string;\n  sourceVersion?: string;\n  sourceHash?: string;\n  sourceKey: string;\n  chunkKey: string;\n  retrievalPointKey: string;\n  ordinal: number;\n  level: number;\n  heading?: string;\n  path: string[];\n  content: string;\n  startOffset: number;\n  endOffset: number;\n  embedding: number[];\n  provider?: string;\n  model?: string;\n  modelVersion?: string;\n  inputKind?: string;\n  inputHash?: string;\n  projectionPolicyVersion?: string;\n  summaryMetadata?: RdfVectorSummaryMetadata;\n  scoreComponents?: RdfVectorScoreComponents;\n  score: number;\n  distance: number;\n}\n\nexport interface RdfVectorSummaryLifecycleOptions {\n  source?: string;\n  workspace?: string;\n  sourcePrefix?: string;\n  localPathPrefix?: string;\n  allowedSources?: string[];\n  deniedSources?: string[];\n  deniedSourcePrefixes?: string[];\n  provider?: string;\n  model?: string;\n  modelVersion?: string;\n  inputKind?: string;\n  inputHash?: string;\n  projectionPolicyVersion?: string;\n  limit?: number;\n}\n\nexport interface RdfVectorSummaryLifecycleEntry {\n  source: string;\n  workspace: string;\n  localPath?: string;\n  contentType?: string;\n  sourceVersion?: string;\n  sourceHash?: string;\n  sourceKey: string;\n  chunkKey: string;\n  retrievalPointKey: string;\n  ordinal: number;\n  level: number;\n  heading?: string;\n  path: string[];\n  content: string;\n  startOffset: number;\n  endOffset: number;\n  provider?: string;\n  model?: string;\n  modelVersion?: string;\n  inputKind?: string;\n  inputHash?: string;\n  projectionPolicyVersion?: string;\n  summaryMetadata: RdfVectorSummaryMetadata;\n  updatedAt: string;\n}\n\nexport interface RdfVectorScoreComponents {\n  sourceType: 'vector';\n  backend?: 'component' | 'pg-vector';\n  metric: RdfVectorDistanceMetric;\n  dimensions: number;\n  score: number;\n  distance: number;\n  dotProduct: number;\n  queryMagnitude: number;\n  candidateMagnitude: number;\n  distanceSquared?: number;\n}\n\nexport interface RdfVectorSummaryMetadata {\n  status: 'summarized';\n  provider: string;\n  model: string;\n  promptVersion: string;\n  sourceHash?: string;\n  originalChars: number;\n  summaryChars: number;\n  rounds: number;\n}\n\nexport interface RdfVectorIndexStats {\n  sourceCount: number;\n  chunkCount: number;\n  componentCount: number;\n  databaseBytes: number;\n  modelDistribution: RdfVectorModelDistribution[];\n}\n\nexport interface RdfVectorModelDistribution {\n  provider?: string;\n  model: string;\n  modelVersion?: string;\n  inputKind?: string;\n  projectionPolicyVersion?: string;\n  dimensions: number;\n  sourceCount: number;\n  chunkCount: number;\n  minMagnitude: number;\n  maxMagnitude: number;\n  averageMagnitude: number;\n}\n\nexport interface RdfTermSelection {\n  sql: string;\n  params: unknown[];\n  indexHint: string;\n}\n\nexport interface RdfTermLookup {\n  id: number;\n  term: Term;\n}\n"]}

package/dist/storage/rdf/types.jsonld

@@ -30,6 +30,26 @@
           "@id": "undefineds:dist/storage/rdf/types.jsonld#RdfEngineLike__member_deleteSource",
           "memberFieldName": "deleteSource"
         },
+        {
+          "@id": "undefineds:dist/storage/rdf/types.jsonld#RdfEngineLike__member_moveSource",
+          "memberFieldName": "moveSource"
+        },
+        {
+          "@id": "undefineds:dist/storage/rdf/types.jsonld#RdfEngineLike__member_indexTextSource",
+          "memberFieldName": "indexTextSource"
+        },
+        {
+          "@id": "undefineds:dist/storage/rdf/types.jsonld#RdfEngineLike__member_deleteTextSource",
+          "memberFieldName": "deleteTextSource"
+        },
+        {
+          "@id": "undefineds:dist/storage/rdf/types.jsonld#RdfEngineLike__member_indexVectorSource",
+          "memberFieldName": "indexVectorSource"
+        },
+        {
+          "@id": "undefineds:dist/storage/rdf/types.jsonld#RdfEngineLike__member_deleteVectorSource",
+          "memberFieldName": "deleteVectorSource"
+        },
         {
           "@id": "undefineds:dist/storage/rdf/types.jsonld#RdfEngineLike__member_delete",
           "memberFieldName": "delete"
@@ -46,6 +66,42 @@
           "@id": "undefineds:dist/storage/rdf/types.jsonld#RdfEngineLike__member_query",
           "memberFieldName": "query"
         },
+        {
+          "@id": "undefineds:dist/storage/rdf/types.jsonld#RdfEngineLike__member_sparqlQuery",
+          "memberFieldName": "sparqlQuery"
+        },
+        {
+          "@id": "undefineds:dist/storage/rdf/types.jsonld#RdfEngineLike__member_rewriteTerms",
+          "memberFieldName": "rewriteTerms"
+        },
+        {
+          "@id": "undefineds:dist/storage/rdf/types.jsonld#RdfEngineLike__member_materializeView",
+          "memberFieldName": "materializeView"
+        },
+        {
+          "@id": "undefineds:dist/storage/rdf/types.jsonld#RdfEngineLike__member_readMaterializedView",
+          "memberFieldName": "readMaterializedView"
+        },
+        {
+          "@id": "undefineds:dist/storage/rdf/types.jsonld#RdfEngineLike__member_activateMaterializedView",
+          "memberFieldName": "activateMaterializedView"
+        },
+        {
+          "@id": "undefineds:dist/storage/rdf/types.jsonld#RdfEngineLike__member_deleteMaterializedView",
+          "memberFieldName": "deleteMaterializedView"
+        },
+        {
+          "@id": "undefineds:dist/storage/rdf/types.jsonld#RdfEngineLike__member_exploreSchema",
+          "memberFieldName": "exploreSchema"
+        },
+        {
+          "@id": "undefineds:dist/storage/rdf/types.jsonld#RdfEngineLike__member_searchPaths",
+          "memberFieldName": "searchPaths"
+        },
+        {
+          "@id": "undefineds:dist/storage/rdf/types.jsonld#RdfEngineLike__member_invalidateQueryResultCache",
+          "memberFieldName": "invalidateQueryResultCache"
+        },
         {
           "@id": "undefineds:dist/storage/rdf/types.jsonld#RdfEngineLike__member_refreshDerivedIndexes",
           "memberFieldName": "refreshDerivedIndexes"
@@ -67,6 +123,10 @@
           "@id": "undefineds:dist/storage/rdf/types.jsonld#RdfEngineStorageStats__member_derivedIndexProfile",
           "memberFieldName": "derivedIndexProfile"
         },
+        {
+          "@id": "undefineds:dist/storage/rdf/types.jsonld#RdfEngineStorageStats__member_lifecycle",
+          "memberFieldName": "lifecycle"
+        },
         {
           "@id": "undefineds:dist/storage/rdf/types.jsonld#RdfEngineStorageStats__member_facts",
           "memberFieldName": "facts"
@@ -75,6 +135,38 @@
           "@id": "undefineds:dist/storage/rdf/types.jsonld#RdfEngineStorageStats__member_rdf3x",
           "memberFieldName": "rdf3x"
         },
+        {
+          "@id": "undefineds:dist/storage/rdf/types.jsonld#RdfEngineStorageStats__member_derivedCache",
+          "memberFieldName": "derivedCache"
+        },
+        {
+          "@id": "undefineds:dist/storage/rdf/types.jsonld#RdfEngineStorageStats__member_queryResultCache",
+          "memberFieldName": "queryResultCache"
+        },
+        {
+          "@id": "undefineds:dist/storage/rdf/types.jsonld#RdfEngineStorageStats__member_materializedResultCache",
+          "memberFieldName": "materializedResultCache"
+        },
+        {
+          "@id": "undefineds:dist/storage/rdf/types.jsonld#RdfEngineStorageStats__member_queryTemplateCache",
+          "memberFieldName": "queryTemplateCache"
+        },
+        {
+          "@id": "undefineds:dist/storage/rdf/types.jsonld#RdfEngineStorageStats__member_accessControlOverrides",
+          "memberFieldName": "accessControlOverrides"
+        },
+        {
+          "@id": "undefineds:dist/storage/rdf/types.jsonld#RdfEngineStorageStats__member_slowQueries",
+          "memberFieldName": "slowQueries"
+        },
+        {
+          "@id": "undefineds:dist/storage/rdf/types.jsonld#RdfEngineStorageStats__member_pgAcceleration",
+          "memberFieldName": "pgAcceleration"
+        },
+        {
+          "@id": "undefineds:dist/storage/rdf/types.jsonld#RdfEngineStorageStats__member_bulkLoad",
+          "memberFieldName": "bulkLoad"
+        },
         {
           "@id": "undefineds:dist/storage/rdf/types.jsonld#RdfEngineStorageStats__member_factsBytes",
           "memberFieldName": "factsBytes"
@@ -306,6 +398,262 @@
       ],
       "constructorArguments": []
     },
+    {
+      "@id": "undefineds:dist/storage/rdf/types.jsonld#RdfTextIndexLike",
+      "@type": "AbstractClass",
+      "requireElement": "RdfTextIndexLike",
+      "parameters": [],
+      "memberFields": [
+        {
+          "@id": "undefineds:dist/storage/rdf/types.jsonld#RdfTextIndexLike__member_open",
+          "memberFieldName": "open"
+        },
+        {
+          "@id": "undefineds:dist/storage/rdf/types.jsonld#RdfTextIndexLike__member_close",
+          "memberFieldName": "close"
+        },
+        {
+          "@id": "undefineds:dist/storage/rdf/types.jsonld#RdfTextIndexLike__member_clear",
+          "memberFieldName": "clear"
+        },
+        {
+          "@id": "undefineds:dist/storage/rdf/types.jsonld#RdfTextIndexLike__member_schemaVersion",
+          "memberFieldName": "schemaVersion"
+        },
+        {
+          "@id": "undefineds:dist/storage/rdf/types.jsonld#RdfTextIndexLike__member_sourceMetadata",
+          "memberFieldName": "sourceMetadata"
+        },
+        {
+          "@id": "undefineds:dist/storage/rdf/types.jsonld#RdfTextIndexLike__member_recordRebuildStatus",
+          "memberFieldName": "recordRebuildStatus"
+        },
+        {
+          "@id": "undefineds:dist/storage/rdf/types.jsonld#RdfTextIndexLike__member_rebuildStatus",
+          "memberFieldName": "rebuildStatus"
+        },
+        {
+          "@id": "undefineds:dist/storage/rdf/types.jsonld#RdfTextIndexLike__member_indexText",
+          "memberFieldName": "indexText"
+        },
+        {
+          "@id": "undefineds:dist/storage/rdf/types.jsonld#RdfTextIndexLike__member_moveSource",
+          "memberFieldName": "moveSource"
+        },
+        {
+          "@id": "undefineds:dist/storage/rdf/types.jsonld#RdfTextIndexLike__member_deleteSource",
+          "memberFieldName": "deleteSource"
+        },
+        {
+          "@id": "undefineds:dist/storage/rdf/types.jsonld#RdfTextIndexLike__member_search",
+          "memberFieldName": "search"
+        },
+        {
+          "@id": "undefineds:dist/storage/rdf/types.jsonld#RdfTextIndexLike__member_estimateSearchCardinality",
+          "memberFieldName": "estimateSearchCardinality"
+        },
+        {
+          "@id": "undefineds:dist/storage/rdf/types.jsonld#RdfTextIndexLike__member_stats",
+          "memberFieldName": "stats"
+        },
+        {
+          "@id": "undefineds:dist/storage/rdf/types.jsonld#RdfTextIndexLike__member_termDocumentFrequency",
+          "memberFieldName": "termDocumentFrequency"
+        }
+      ],
+      "constructorArguments": []
+    },
+    {
+      "@id": "undefineds:dist/storage/rdf/types.jsonld#RdfTextIndexOptions",
+      "@type": "AbstractClass",
+      "requireElement": "RdfTextIndexOptions",
+      "parameters": [],
+      "memberFields": [
+        {
+          "@id": "undefineds:dist/storage/rdf/types.jsonld#RdfTextIndexOptions__member_path",
+          "memberFieldName": "path"
+        },
+        {
+          "@id": "undefineds:dist/storage/rdf/types.jsonld#RdfTextIndexOptions__member_maxSourceBytes",
+          "memberFieldName": "maxSourceBytes"
+        },
+        {
+          "@id": "undefineds:dist/storage/rdf/types.jsonld#RdfTextIndexOptions__member_maxChunksPerSource",
+          "memberFieldName": "maxChunksPerSource"
+        }
+      ],
+      "constructorArguments": []
+    },
+    {
+      "@id": "undefineds:dist/storage/rdf/types.jsonld#RdfTextIndexSyncLike",
+      "@type": "AbstractClass",
+      "requireElement": "RdfTextIndexSyncLike",
+      "extends": [
+        "undefineds:dist/storage/rdf/types.jsonld#RdfTextIndexLike"
+      ],
+      "parameters": [],
+      "memberFields": [
+        {
+          "@id": "undefineds:dist/storage/rdf/types.jsonld#RdfTextIndexSyncLike__member_open",
+          "memberFieldName": "open"
+        },
+        {
+          "@id": "undefineds:dist/storage/rdf/types.jsonld#RdfTextIndexSyncLike__member_close",
+          "memberFieldName": "close"
+        },
+        {
+          "@id": "undefineds:dist/storage/rdf/types.jsonld#RdfTextIndexSyncLike__member_clear",
+          "memberFieldName": "clear"
+        },
+        {
+          "@id": "undefineds:dist/storage/rdf/types.jsonld#RdfTextIndexSyncLike__member_indexText",
+          "memberFieldName": "indexText"
+        },
+        {
+          "@id": "undefineds:dist/storage/rdf/types.jsonld#RdfTextIndexSyncLike__member_moveSource",
+          "memberFieldName": "moveSource"
+        },
+        {
+          "@id": "undefineds:dist/storage/rdf/types.jsonld#RdfTextIndexSyncLike__member_deleteSource",
+          "memberFieldName": "deleteSource"
+        },
+        {
+          "@id": "undefineds:dist/storage/rdf/types.jsonld#RdfTextIndexSyncLike__member_search",
+          "memberFieldName": "search"
+        },
+        {
+          "@id": "undefineds:dist/storage/rdf/types.jsonld#RdfTextIndexSyncLike__member_estimateSearchCardinality",
+          "memberFieldName": "estimateSearchCardinality"
+        },
+        {
+          "@id": "undefineds:dist/storage/rdf/types.jsonld#RdfTextIndexSyncLike__member_stats",
+          "memberFieldName": "stats"
+        },
+        {
+          "@id": "undefineds:dist/storage/rdf/types.jsonld#RdfTextIndexSyncLike__member_termDocumentFrequency",
+          "memberFieldName": "termDocumentFrequency"
+        }
+      ],
+      "constructorArguments": []
+    },
+    {
+      "@id": "undefineds:dist/storage/rdf/types.jsonld#RdfVectorIndexLike",
+      "@type": "AbstractClass",
+      "requireElement": "RdfVectorIndexLike",
+      "parameters": [],
+      "memberFields": [
+        {
+          "@id": "undefineds:dist/storage/rdf/types.jsonld#RdfVectorIndexLike__member_open",
+          "memberFieldName": "open"
+        },
+        {
+          "@id": "undefineds:dist/storage/rdf/types.jsonld#RdfVectorIndexLike__member_close",
+          "memberFieldName": "close"
+        },
+        {
+          "@id": "undefineds:dist/storage/rdf/types.jsonld#RdfVectorIndexLike__member_clear",
+          "memberFieldName": "clear"
+        },
+        {
+          "@id": "undefineds:dist/storage/rdf/types.jsonld#RdfVectorIndexLike__member_indexVector",
+          "memberFieldName": "indexVector"
+        },
+        {
+          "@id": "undefineds:dist/storage/rdf/types.jsonld#RdfVectorIndexLike__member_deleteSource",
+          "memberFieldName": "deleteSource"
+        },
+        {
+          "@id": "undefineds:dist/storage/rdf/types.jsonld#RdfVectorIndexLike__member_search",
+          "memberFieldName": "search"
+        },
+        {
+          "@id": "undefineds:dist/storage/rdf/types.jsonld#RdfVectorIndexLike__member_summaryLifecycle",
+          "memberFieldName": "summaryLifecycle"
+        },
+        {
+          "@id": "undefineds:dist/storage/rdf/types.jsonld#RdfVectorIndexLike__member_estimateSearchCardinality",
+          "memberFieldName": "estimateSearchCardinality"
+        },
+        {
+          "@id": "undefineds:dist/storage/rdf/types.jsonld#RdfVectorIndexLike__member_stats",
+          "memberFieldName": "stats"
+        },
+        {
+          "@id": "undefineds:dist/storage/rdf/types.jsonld#RdfVectorIndexLike__member_modelDistribution",
+          "memberFieldName": "modelDistribution"
+        }
+      ],
+      "constructorArguments": []
+    },
+    {
+      "@id": "undefineds:dist/storage/rdf/types.jsonld#RdfVectorIndexOptions",
+      "@type": "AbstractClass",
+      "requireElement": "RdfVectorIndexOptions",
+      "parameters": [],
+      "memberFields": [
+        {
+          "@id": "undefineds:dist/storage/rdf/types.jsonld#RdfVectorIndexOptions__member_path",
+          "memberFieldName": "path"
+        },
+        {
+          "@id": "undefineds:dist/storage/rdf/types.jsonld#RdfVectorIndexOptions__member_defaultMetric",
+          "memberFieldName": "defaultMetric"
+        }
+      ],
+      "constructorArguments": []
+    },
+    {
+      "@id": "undefineds:dist/storage/rdf/types.jsonld#RdfVectorIndexSyncLike",
+      "@type": "AbstractClass",
+      "requireElement": "RdfVectorIndexSyncLike",
+      "extends": [
+        "undefineds:dist/storage/rdf/types.jsonld#RdfVectorIndexLike"
+      ],
+      "parameters": [],
+      "memberFields": [
+        {
+          "@id": "undefineds:dist/storage/rdf/types.jsonld#RdfVectorIndexSyncLike__member_open",
+          "memberFieldName": "open"
+        },
+        {
+          "@id": "undefineds:dist/storage/rdf/types.jsonld#RdfVectorIndexSyncLike__member_close",
+          "memberFieldName": "close"
+        },
+        {
+          "@id": "undefineds:dist/storage/rdf/types.jsonld#RdfVectorIndexSyncLike__member_clear",
+          "memberFieldName": "clear"
+        },
+        {
+          "@id": "undefineds:dist/storage/rdf/types.jsonld#RdfVectorIndexSyncLike__member_indexVector",
+          "memberFieldName": "indexVector"
+        },
+        {
+          "@id": "undefineds:dist/storage/rdf/types.jsonld#RdfVectorIndexSyncLike__member_deleteSource",
+          "memberFieldName": "deleteSource"
+        },
+        {
+          "@id": "undefineds:dist/storage/rdf/types.jsonld#RdfVectorIndexSyncLike__member_search",
+          "memberFieldName": "search"
+        },
+        {
+          "@id": "undefineds:dist/storage/rdf/types.jsonld#RdfVectorIndexSyncLike__member_summaryLifecycle",
+          "memberFieldName": "summaryLifecycle"
+        },
+        {
+          "@id": "undefineds:dist/storage/rdf/types.jsonld#RdfVectorIndexSyncLike__member_estimateSearchCardinality",
+          "memberFieldName": "estimateSearchCardinality"
+        },
+        {
+          "@id": "undefineds:dist/storage/rdf/types.jsonld#RdfVectorIndexSyncLike__member_stats",
+          "memberFieldName": "stats"
+        },
+        {
+          "@id": "undefineds:dist/storage/rdf/types.jsonld#RdfVectorIndexSyncLike__member_modelDistribution",
+          "memberFieldName": "modelDistribution"
+        }
+      ],
+      "constructorArguments": []
+    },
     {
       "@id": "undefineds:dist/storage/rdf/types.jsonld#RdfShadowBackfillOptions",
       "@type": "AbstractClass",

package/dist/storage/sparql/CompatibilitySparqlEngine.d.ts

@@ -1,7 +1,8 @@
 import type { Quad } from '@rdfjs/types';
 import type { AsyncIterator } from 'asynciterator';
-import type { SparqlEngine } from './SubgraphQueryEngine';
+import type { SparqlEngine, SparqlVoidOptions } from './SubgraphQueryEngine';
 import type { QuintStore } from '../quint/types';
+import type { RdfAccessScope } from '../rdf/RdfAccessScope';
 /**
  * @deprecated Compatibility wrapper preserved for older call sites.
  * Mainline xpod uses SolidRdfEngine for server-owned Pod queries.
@@ -12,12 +13,12 @@ import type { QuintStore } from '../quint/types';
 export declare class QuadstoreSparqlEngine implements SparqlEngine {
     private readonly delegate;
     constructor(endpoint: string);
-    queryBindings(query: string, basePath: string): Promise<any>;
-    queryQuads(query: string, basePath: string): Promise<any>;
-    queryBoolean(query: string, basePath: string): Promise<boolean>;
-    queryVoid(query: string, basePath: string): Promise<void>;
-    constructGraph(graph: string, basePath: string): Promise<AsyncIterator<Quad>>;
-    listGraphs(basePath: string): Promise<Set<string>>;
+    queryBindings(query: string, basePath: string, accessScope?: RdfAccessScope): Promise<any>;
+    queryQuads(query: string, basePath: string, accessScope?: RdfAccessScope): Promise<any>;
+    queryBoolean(query: string, basePath: string, accessScope?: RdfAccessScope): Promise<boolean>;
+    queryVoid(query: string, basePath: string, accessScope?: RdfAccessScope, options?: SparqlVoidOptions): Promise<void>;
+    constructGraph(graph: string, basePath: string, accessScope?: RdfAccessScope): Promise<AsyncIterator<Quad>>;
+    listGraphs(basePath: string, accessScope?: RdfAccessScope): Promise<Set<string>>;
     close(): Promise<void>;
 }
 /**
@@ -26,11 +27,11 @@ export declare class QuadstoreSparqlEngine implements SparqlEngine {
 export declare class QuintstoreSparqlEngine implements SparqlEngine {
     private readonly delegate;
     constructor(store: QuintStore);
-    queryBindings(query: string, basePath: string): Promise<any>;
-    queryQuads(query: string, basePath: string): Promise<any>;
-    queryBoolean(query: string, basePath: string): Promise<boolean>;
-    queryVoid(query: string, basePath: string): Promise<void>;
-    constructGraph(graph: string, basePath: string): Promise<AsyncIterator<Quad>>;
-    listGraphs(basePath: string): Promise<Set<string>>;
+    queryBindings(query: string, basePath: string, accessScope?: RdfAccessScope): Promise<any>;
+    queryQuads(query: string, basePath: string, accessScope?: RdfAccessScope): Promise<any>;
+    queryBoolean(query: string, basePath: string, accessScope?: RdfAccessScope): Promise<boolean>;
+    queryVoid(query: string, basePath: string, accessScope?: RdfAccessScope, options?: SparqlVoidOptions): Promise<void>;
+    constructGraph(graph: string, basePath: string, accessScope?: RdfAccessScope): Promise<AsyncIterator<Quad>>;
+    listGraphs(basePath: string, accessScope?: RdfAccessScope): Promise<Set<string>>;
     close(): Promise<void>;
 }