@undefineds.co/xpod 0.3.6 → 0.3.14

package/dist/storage/rdf/types.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=types.js.map

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

@@ -0,0 +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  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 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 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 Rdf3xTripleIndexOptions {\n  path: string;\n  debug?: boolean;\n}\n\nexport interface Rdf3xGraphPrefixPattern {\n  $startsWith: string;\n}\n\nexport interface Rdf3xNumericObjectRangePattern {\n  $gt?: Term | string | number;\n  $gte?: Term | string | number;\n  $lt?: Term | string | number;\n  $lte?: Term | string | number;\n}\n\nexport interface Rdf3xTriplePattern {\n  graph?: Term | Rdf3xGraphPrefixPattern;\n  subject?: Term;\n  predicate?: Term;\n  object?: Term | Rdf3xNumericObjectRangePattern;\n}\n\nexport interface Rdf3xTripleScanOptions {\n  order?: Array<'graph' | 'subject' | 'predicate' | 'object'>;\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 Rdf3xJoinOptions {\n  orderBy?: RdfQuadJoinOrder[];\n  limit?: number;\n  offset?: number;\n  project?: string[];\n  distinct?: boolean;\n  countMatchedRows?: boolean;\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  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  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}\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  | {\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\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  | '$bound'\n  | '$termType'\n  | '$sameTerm'\n  | '$lang'\n  | '$notLang'\n  | '$langMatches'\n  | '$datatype'\n  | '$notDatatype';\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 RdfLocalQuery {\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  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  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 RdfLocalQueryMetrics {\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 RdfLocalQueryResult {\n  bindings: RdfBindingRow[];\n  count?: number;\n  metrics: RdfLocalQueryMetrics;\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"]}

package/dist/storage/rdf/types.jsonld

@@ -0,0 +1,316 @@
+{
+  "@context": [
+    "https://linkedsoftwaredependencies.org/bundles/npm/@undefineds.co/xpod/^0.0.0/components/context.jsonld"
+  ],
+  "@id": "npmd:@undefineds.co/xpod",
+  "components": [
+    {
+      "@id": "undefineds:dist/storage/rdf/types.jsonld#RdfIndexStats",
+      "@type": "AbstractClass",
+      "requireElement": "RdfIndexStats",
+      "parameters": [],
+      "memberFields": [
+        {
+          "@id": "undefineds:dist/storage/rdf/types.jsonld#RdfIndexStats__member_termCount",
+          "memberFieldName": "termCount"
+        },
+        {
+          "@id": "undefineds:dist/storage/rdf/types.jsonld#RdfIndexStats__member_quadCount",
+          "memberFieldName": "quadCount"
+        },
+        {
+          "@id": "undefineds:dist/storage/rdf/types.jsonld#RdfIndexStats__member_sourceCount",
+          "memberFieldName": "sourceCount"
+        },
+        {
+          "@id": "undefineds:dist/storage/rdf/types.jsonld#RdfIndexStats__member_graphCount",
+          "memberFieldName": "graphCount"
+        },
+        {
+          "@id": "undefineds:dist/storage/rdf/types.jsonld#RdfIndexStats__member_databaseBytes",
+          "memberFieldName": "databaseBytes"
+        },
+        {
+          "@id": "undefineds:dist/storage/rdf/types.jsonld#RdfIndexStats__member_tableBytes",
+          "memberFieldName": "tableBytes"
+        },
+        {
+          "@id": "undefineds:dist/storage/rdf/types.jsonld#RdfIndexStats__member_indexBytes",
+          "memberFieldName": "indexBytes"
+        },
+        {
+          "@id": "undefineds:dist/storage/rdf/types.jsonld#RdfIndexStats__member_spaceObjects",
+          "memberFieldName": "spaceObjects"
+        },
+        {
+          "@id": "undefineds:dist/storage/rdf/types.jsonld#RdfIndexStats__member_serializedTermTextBytes",
+          "memberFieldName": "serializedTermTextBytes"
+        },
+        {
+          "@id": "undefineds:dist/storage/rdf/types.jsonld#RdfIndexStats__member_literalDatatypeDistribution",
+          "memberFieldName": "literalDatatypeDistribution"
+        },
+        {
+          "@id": "undefineds:dist/storage/rdf/types.jsonld#RdfIndexStats__member_cardinalityDistributions",
+          "memberFieldName": "cardinalityDistributions"
+        }
+      ],
+      "constructorArguments": []
+    },
+    {
+      "@id": "undefineds:dist/storage/rdf/types.jsonld#RdfIndexSpaceObject",
+      "@type": "AbstractClass",
+      "requireElement": "RdfIndexSpaceObject",
+      "parameters": [],
+      "memberFields": [
+        {
+          "@id": "undefineds:dist/storage/rdf/types.jsonld#RdfIndexSpaceObject__member_name",
+          "memberFieldName": "name"
+        },
+        {
+          "@id": "undefineds:dist/storage/rdf/types.jsonld#RdfIndexSpaceObject__member_kind",
+          "memberFieldName": "kind"
+        },
+        {
+          "@id": "undefineds:dist/storage/rdf/types.jsonld#RdfIndexSpaceObject__member_tableName",
+          "memberFieldName": "tableName"
+        },
+        {
+          "@id": "undefineds:dist/storage/rdf/types.jsonld#RdfIndexSpaceObject__member_bytes",
+          "memberFieldName": "bytes"
+        },
+        {
+          "@id": "undefineds:dist/storage/rdf/types.jsonld#RdfIndexSpaceObject__member_pages",
+          "memberFieldName": "pages"
+        },
+        {
+          "@id": "undefineds:dist/storage/rdf/types.jsonld#RdfIndexSpaceObject__member_estimated",
+          "memberFieldName": "estimated"
+        }
+      ],
+      "constructorArguments": []
+    },
+    {
+      "@id": "undefineds:dist/storage/rdf/types.jsonld#RdfIndexMetrics",
+      "@type": "AbstractClass",
+      "requireElement": "RdfIndexMetrics",
+      "parameters": [],
+      "memberFields": [
+        {
+          "@id": "undefineds:dist/storage/rdf/types.jsonld#RdfIndexMetrics__member_engine",
+          "memberFieldName": "engine"
+        },
+        {
+          "@id": "undefineds:dist/storage/rdf/types.jsonld#RdfIndexMetrics__member_indexChoice",
+          "memberFieldName": "indexChoice"
+        },
+        {
+          "@id": "undefineds:dist/storage/rdf/types.jsonld#RdfIndexMetrics__member_matchedRows",
+          "memberFieldName": "matchedRows"
+        },
+        {
+          "@id": "undefineds:dist/storage/rdf/types.jsonld#RdfIndexMetrics__member_returnedRows",
+          "memberFieldName": "returnedRows"
+        },
+        {
+          "@id": "undefineds:dist/storage/rdf/types.jsonld#RdfIndexMetrics__member_durationMs",
+          "memberFieldName": "durationMs"
+        },
+        {
+          "@id": "undefineds:dist/storage/rdf/types.jsonld#RdfIndexMetrics__member_queryPlan",
+          "memberFieldName": "queryPlan"
+        }
+      ],
+      "constructorArguments": []
+    },
+    {
+      "@id": "undefineds:dist/storage/rdf/types.jsonld#RdfIndexPutOptions",
+      "@type": "AbstractClass",
+      "requireElement": "RdfIndexPutOptions",
+      "parameters": [],
+      "memberFields": [
+        {
+          "@id": "undefineds:dist/storage/rdf/types.jsonld#RdfIndexPutOptions__member_source",
+          "memberFieldName": "source"
+        },
+        {
+          "@id": "undefineds:dist/storage/rdf/types.jsonld#RdfIndexPutOptions__member_sourceLineNo",
+          "memberFieldName": "sourceLineNo"
+        }
+      ],
+      "constructorArguments": []
+    },
+    {
+      "@id": "undefineds:dist/storage/rdf/types.jsonld#RdfPatternQuery",
+      "@type": "AbstractClass",
+      "requireElement": "RdfPatternQuery",
+      "parameters": [],
+      "memberFields": [
+        {
+          "@id": "undefineds:dist/storage/rdf/types.jsonld#RdfPatternQuery__member_pattern",
+          "memberFieldName": "pattern"
+        },
+        {
+          "@id": "undefineds:dist/storage/rdf/types.jsonld#RdfPatternQuery__member_options",
+          "memberFieldName": "options"
+        }
+      ],
+      "constructorArguments": []
+    },
+    {
+      "@id": "undefineds:dist/storage/rdf/types.jsonld#RdfQuadIndexOptions",
+      "@type": "AbstractClass",
+      "requireElement": "RdfQuadIndexOptions",
+      "parameters": [],
+      "memberFields": [
+        {
+          "@id": "undefineds:dist/storage/rdf/types.jsonld#RdfQuadIndexOptions__member_path",
+          "memberFieldName": "path"
+        },
+        {
+          "@id": "undefineds:dist/storage/rdf/types.jsonld#RdfQuadIndexOptions__member_debug",
+          "memberFieldName": "debug"
+        }
+      ],
+      "constructorArguments": []
+    },
+    {
+      "@id": "undefineds:dist/storage/rdf/types.jsonld#RdfQuadIndexScanResult",
+      "@type": "AbstractClass",
+      "requireElement": "RdfQuadIndexScanResult",
+      "parameters": [],
+      "memberFields": [
+        {
+          "@id": "undefineds:dist/storage/rdf/types.jsonld#RdfQuadIndexScanResult__member_quads",
+          "memberFieldName": "quads"
+        },
+        {
+          "@id": "undefineds:dist/storage/rdf/types.jsonld#RdfQuadIndexScanResult__member_metrics",
+          "memberFieldName": "metrics"
+        }
+      ],
+      "constructorArguments": []
+    },
+    {
+      "@id": "undefineds:dist/storage/rdf/types.jsonld#RdfShadowBackfillOptions",
+      "@type": "AbstractClass",
+      "requireElement": "RdfShadowBackfillOptions",
+      "parameters": [],
+      "memberFields": [
+        {
+          "@id": "undefineds:dist/storage/rdf/types.jsonld#RdfShadowBackfillOptions__member_clear",
+          "memberFieldName": "clear"
+        },
+        {
+          "@id": "undefineds:dist/storage/rdf/types.jsonld#RdfShadowBackfillOptions__member_batchSize",
+          "memberFieldName": "batchSize"
+        }
+      ],
+      "constructorArguments": []
+    },
+    {
+      "@id": "undefineds:dist/storage/rdf/types.jsonld#RdfShadowBackfillResult",
+      "@type": "AbstractClass",
+      "requireElement": "RdfShadowBackfillResult",
+      "parameters": [],
+      "memberFields": [
+        {
+          "@id": "undefineds:dist/storage/rdf/types.jsonld#RdfShadowBackfillResult__member_scannedRows",
+          "memberFieldName": "scannedRows"
+        },
+        {
+          "@id": "undefineds:dist/storage/rdf/types.jsonld#RdfShadowBackfillResult__member_indexedRows",
+          "memberFieldName": "indexedRows"
+        },
+        {
+          "@id": "undefineds:dist/storage/rdf/types.jsonld#RdfShadowBackfillResult__member_batchCount",
+          "memberFieldName": "batchCount"
+        },
+        {
+          "@id": "undefineds:dist/storage/rdf/types.jsonld#RdfShadowBackfillResult__member_durationMs",
+          "memberFieldName": "durationMs"
+        }
+      ],
+      "constructorArguments": []
+    },
+    {
+      "@id": "undefineds:dist/storage/rdf/types.jsonld#RdfShadowDiff",
+      "@type": "AbstractClass",
+      "requireElement": "RdfShadowDiff",
+      "parameters": [],
+      "memberFields": [
+        {
+          "@id": "undefineds:dist/storage/rdf/types.jsonld#RdfShadowDiff__member_missingFromPrimary",
+          "memberFieldName": "missingFromPrimary"
+        },
+        {
+          "@id": "undefineds:dist/storage/rdf/types.jsonld#RdfShadowDiff__member_extraInPrimary",
+          "memberFieldName": "extraInPrimary"
+        }
+      ],
+      "constructorArguments": []
+    },
+    {
+      "@id": "undefineds:dist/storage/rdf/types.jsonld#RdfShadowScanResult",
+      "@type": "AbstractClass",
+      "requireElement": "RdfShadowScanResult",
+      "parameters": [],
+      "memberFields": [
+        {
+          "@id": "undefineds:dist/storage/rdf/types.jsonld#RdfShadowScanResult__member_matched",
+          "memberFieldName": "matched"
+        },
+        {
+          "@id": "undefineds:dist/storage/rdf/types.jsonld#RdfShadowScanResult__member_orderedMatch",
+          "memberFieldName": "orderedMatch"
+        },
+        {
+          "@id": "undefineds:dist/storage/rdf/types.jsonld#RdfShadowScanResult__member_primary",
+          "memberFieldName": "primary"
+        },
+        {
+          "@id": "undefineds:dist/storage/rdf/types.jsonld#RdfShadowScanResult__member_compatibility",
+          "memberFieldName": "compatibility"
+        },
+        {
+          "@id": "undefineds:dist/storage/rdf/types.jsonld#RdfShadowScanResult__member_diff",
+          "memberFieldName": "diff"
+        },
+        {
+          "@id": "undefineds:dist/storage/rdf/types.jsonld#RdfShadowScanResult__member_metrics",
+          "memberFieldName": "metrics"
+        }
+      ],
+      "constructorArguments": []
+    },
+    {
+      "@id": "undefineds:dist/storage/rdf/types.jsonld#RdfSourceInput",
+      "@type": "AbstractClass",
+      "requireElement": "RdfSourceInput",
+      "parameters": [],
+      "memberFields": [
+        {
+          "@id": "undefineds:dist/storage/rdf/types.jsonld#RdfSourceInput__member_source",
+          "memberFieldName": "source"
+        },
+        {
+          "@id": "undefineds:dist/storage/rdf/types.jsonld#RdfSourceInput__member_workspace",
+          "memberFieldName": "workspace"
+        },
+        {
+          "@id": "undefineds:dist/storage/rdf/types.jsonld#RdfSourceInput__member_localPath",
+          "memberFieldName": "localPath"
+        },
+        {
+          "@id": "undefineds:dist/storage/rdf/types.jsonld#RdfSourceInput__member_contentType",
+          "memberFieldName": "contentType"
+        },
+        {
+          "@id": "undefineds:dist/storage/rdf/types.jsonld#RdfSourceInput__member_sourceVersion",
+          "memberFieldName": "sourceVersion"
+        }
+      ],
+      "constructorArguments": []
+    }
+  ]
+}

package/dist/storage/vector/VectorIndexingListener.d.ts

@@ -17,9 +17,9 @@ import type { ResourceStore } from '@solid/community-server';
  * VectorStore 定义（从 RDF 读取）
  */
 export interface VectorStoreDefinition {
-    /** VectorStore URI */
-    uri: string;
-    /** 索引范围（Container URI） */
+    /** VectorStore resource */
+    resource: string;
+    /** 索引范围（Container resource） */
     scope: string;
     /** embedding 模型 */
     model: string;
@@ -100,9 +100,9 @@ export declare class VectorIndexingListener implements ResourceChangeListener {
      */
     private getPodBaseUrl;
     /**
-     * 解析相对 URI
+     * 解析相对资源引用
      */
-    private resolveUri;
+    private resolveResource;
     /**
      * 将路径转换为向量 ID（使用 hash）
      */

package/dist/storage/vector/VectorIndexingListener.js

@@ -114,7 +114,7 @@ class VectorIndexingListener {
         const modelEmbeddings = new Map();
         for (const vs of vectorStores) {
             if (vs.status !== 'active') {
-                this.logger.debug(`VectorStore ${vs.uri} is ${vs.status}, skipping`);
+                this.logger.debug(`VectorStore ${vs.resource} is ${vs.status}, skipping`);
                 continue;
             }
             const model = vs.model || this.defaultModel;
@@ -180,8 +180,8 @@ class VectorIndexingListener {
                 const chunkOverlap = binding.get('chunkOverlap');
                 if (vs && scope) {
                     definitions.push({
-                        uri: vs.value,
-                        scope: this.resolveUri(scope.value, podBaseUrl),
+                        resource: vs.value,
+                        scope: this.resolveResource(scope.value, podBaseUrl),
                         model: model?.value || this.defaultModel,
                         status: status?.value || 'active',
                         chunkSize: chunkSize ? parseInt(chunkSize.value, 10) : undefined,
@@ -209,19 +209,19 @@ class VectorIndexingListener {
             const query = `
         PREFIX cred: <${models_1.XPOD_CREDENTIAL.NAMESPACE}>
         PREFIX ai: <${models_1.XPOD_AI.NAMESPACE}>
-        SELECT ?apiKey ?baseUrl ?providerUri ?proxyUrl WHERE {
+        SELECT ?apiKey ?baseUrl ?provider ?proxyUrl WHERE {
           ?cred a cred:Credential ;
                 cred:service "ai" ;
                 cred:status "active" ;
                 cred:apiKey ?apiKey .
-          OPTIONAL { ?cred cred:provider ?providerUri }
+          OPTIONAL { ?cred cred:provider ?provider }
           OPTIONAL { 
-            ?cred cred:provider ?providerUri .
-            ?providerUri ai:baseUrl ?baseUrl .
+            ?cred cred:provider ?provider .
+            ?provider ai:baseUrl ?baseUrl .
           }
           OPTIONAL { 
-            ?cred cred:provider ?providerUri .
-            ?providerUri ai:proxyUrl ?proxyUrl .
+            ?cred cred:provider ?provider .
+            ?provider ai:proxyUrl ?proxyUrl .
           }
         } LIMIT 1
       `;
@@ -229,10 +229,10 @@ class VectorIndexingListener {
             for await (const binding of bindingsStream) {
                 const apiKey = binding.get('apiKey');
                 const baseUrl = binding.get('baseUrl');
-                const providerUri = binding.get('providerUri');
+                const provider = binding.get('provider');
                 const proxyUrl = binding.get('proxyUrl');
                 if (apiKey) {
-                    const providerName = (0, models_1.normalizeAIConfigProviderId)(providerUri?.value || 'google') || 'google';
+                    const providerName = (0, models_1.normalizeAIConfigProviderId)(provider?.value || 'google') || 'google';
                     return {
                         apiKey: apiKey.value,
                         baseUrl: baseUrl?.value,
@@ -306,22 +306,22 @@ class VectorIndexingListener {
         return null;
     }
     /**
-     * 解析相对 URI
+     * 解析相对资源引用
      */
-    resolveUri(uri, baseUrl) {
-        if (uri.startsWith('http://') || uri.startsWith('https://')) {
-            return uri;
+    resolveResource(resource, baseUrl) {
+        if (resource.startsWith('http://') || resource.startsWith('https://')) {
+            return resource;
         }
-        if (uri.startsWith('/')) {
+        if (resource.startsWith('/')) {
             try {
                 const base = new URL(baseUrl);
-                return `${base.origin}${uri}`;
+                return `${base.origin}${resource}`;
             }
             catch {
-                return uri;
+                return resource;
             }
         }
-        return `${baseUrl}${uri}`;
+        return `${baseUrl}${resource}`;
     }
     /**
      * 将路径转换为向量 ID（使用 hash）

package/dist/storage/vector/VectorIndexingListener.js.map

@@ -1 +1 @@
-{"version":3,"file":"VectorIndexingListener.js","sourceRoot":"","sources":["../../../src/storage/vector/VectorIndexingListener.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * VectorIndexingListener - 向量索引监听器\n *\n * 监听资源变更事件，自动触发向量索引更新。\n *\n * 工作流程：\n * 1. 收到资源变更事件\n * 2. 检查资源是否在某个 VectorStore 的 scope 内\n * 3. 如果是，读取资源内容，生成 embedding，存入向量库\n */\n\nimport { getLoggerFor } from 'global-logger-factory';\nimport type { ResourceChangeEvent, ResourceChangeListener } from '../ObservableResourceStore';\nimport type { VectorStore } from '../vector/VectorStore';\nimport type { EmbeddingService } from '../../ai/service/EmbeddingService';\nimport type { SparqlEngine } from '../sparql/SubgraphQueryEngine';\nimport type { AiCredential } from '../../ai/service/types';\nimport type { ResourceStore, RepresentationPreferences } from '@solid/community-server';\nimport { XPOD_AI, XPOD_CREDENTIAL, normalizeAIConfigProviderId } from '@undefineds.co/models';\n\n/**\n * VectorStore 定义（从 RDF 读取）\n */\nexport interface VectorStoreDefinition {\n  /** VectorStore URI */\n  uri: string;\n  /** 索引范围（Container URI） */\n  scope: string;\n  /** embedding 模型 */\n  model: string;\n  /** 状态 */\n  status: 'active' | 'paused';\n  /** 分块大小 */\n  chunkSize?: number;\n  /** 分块重叠 */\n  chunkOverlap?: number;\n}\n\nexport interface VectorIndexingListenerOptions {\n  /** SPARQL 引擎（用于查询 VectorStore 定义和 AI 凭据） */\n  sparqlEngine: SparqlEngine;\n  /** 向量存储 */\n  vectorStore: VectorStore;\n  /** Embedding 服务 */\n  embeddingService: EmbeddingService;\n  /** 资源存储（用于读取资源内容） */\n  resourceStore: ResourceStore;\n  /** 默认 embedding 模型 */\n  defaultModel?: string;\n  /** 支持的文件扩展名 */\n  supportedExtensions?: string[];\n}\n\n/**\n * VectorIndexingListener - 自动向量索引\n */\nexport class VectorIndexingListener implements ResourceChangeListener {\n  protected readonly logger = getLoggerFor(this);\n\n  private readonly sparqlEngine: SparqlEngine;\n  private readonly vectorStore: VectorStore;\n  private readonly embeddingService: EmbeddingService;\n  private readonly resourceStore: ResourceStore;\n  private readonly defaultModel: string;\n  private readonly supportedExtensions: Set<string>;\n\n  // 缓存 VectorStore 定义，避免频繁查询\n  private vectorStoreCache = new Map<string, VectorStoreDefinition[]>();\n  private cacheExpiry = 0;\n  private readonly cacheTtlMs = 60000; // 1 分钟缓存\n\n  public constructor(options: VectorIndexingListenerOptions) {\n    this.sparqlEngine = options.sparqlEngine;\n    this.vectorStore = options.vectorStore;\n    this.embeddingService = options.embeddingService;\n    this.resourceStore = options.resourceStore;\n    this.defaultModel = options.defaultModel ?? 'text-embedding-004';\n    this.supportedExtensions = new Set(\n      options.supportedExtensions ?? ['.txt', '.md', '.html', '.json', '.ttl', '.jsonld'],\n    );\n  }\n\n  /**\n   * 处理资源变更事件\n   */\n  public async onResourceChanged(event: ResourceChangeEvent): Promise<void> {\n    const { path, action, isContainer } = event;\n\n    // 跳过容器变更\n    if (isContainer) {\n      this.logger.debug(`Skipping container: ${path}`);\n      return;\n    }\n\n    // 检查文件扩展名\n    if (!this.isSupportedFile(path)) {\n      this.logger.debug(`Skipping unsupported file type: ${path}`);\n      return;\n    }\n\n    // 获取 Pod base URL\n    const podBaseUrl = this.getPodBaseUrl(path);\n    if (!podBaseUrl) {\n      this.logger.debug(`Cannot determine pod base URL for: ${path}`);\n      return;\n    }\n\n    // 如果是 VectorStore 配置文件或 Credential 配置文件更新，清除缓存\n    if (path.includes('vector-stores') || path.includes('credentials')) {\n      this.logger.debug(`Configuration file updated, clearing cache for ${podBaseUrl}`);\n      this.vectorStoreCache.delete(podBaseUrl);\n      // 配置文件本身不需要索引，直接返回\n      return;\n    }\n\n    try {\n      // 查找覆盖此路径的 VectorStore\n      const vectorStores = await this.findVectorStoresForPath(path, podBaseUrl);\n      if (vectorStores.length === 0) {\n        this.logger.debug(`No VectorStore configured for: ${path}`);\n        return;\n      }\n\n      this.logger.info(`Processing ${action} for ${path}, matched ${vectorStores.length} VectorStore(s)`);\n\n      // 根据 action 执行索引操作\n      if (action === 'delete') {\n        await this.handleDelete(path, vectorStores);\n      } else {\n        await this.handleCreateOrUpdate(path, podBaseUrl, vectorStores);\n      }\n    } catch (error) {\n      this.logger.error(`Failed to process ${action} for ${path}: ${error}`);\n    }\n  }\n\n  /**\n   * 处理删除操作\n   */\n  private async handleDelete(path: string, vectorStores: VectorStoreDefinition[]): Promise<void> {\n    const vectorId = this.pathToVectorId(path);\n\n    for (const vs of vectorStores) {\n      try {\n        await this.vectorStore.deleteVector(vs.model, vectorId);\n        this.logger.info(`Deleted vector for ${path} from model ${vs.model}`);\n      } catch (error) {\n        this.logger.error(`Failed to delete vector for ${path}: ${error}`);\n      }\n    }\n  }\n\n  /**\n   * 处理创建或更新操作\n   */\n  private async handleCreateOrUpdate(\n    path: string,\n    podBaseUrl: string,\n    vectorStores: VectorStoreDefinition[],\n  ): Promise<void> {\n    // 读取资源内容\n    const content = await this.getResourceContent(path);\n    if (!content || content.trim().length === 0) {\n      this.logger.debug(`Empty content for ${path}, skipping`);\n      return;\n    }\n\n    // 获取 AI 凭据\n    const credential = await this.getAiCredential(podBaseUrl);\n    if (!credential) {\n      this.logger.warn(`No AI credential found for ${podBaseUrl}, skipping indexing`);\n      return;\n    }\n\n    // 为每个 VectorStore 生成 embedding 并存储\n    // 注意：如果多个 VectorStore 使用相同的 model，只需要生成一次 embedding\n    const modelEmbeddings = new Map<string, number[]>();\n\n    for (const vs of vectorStores) {\n      if (vs.status !== 'active') {\n        this.logger.debug(`VectorStore ${vs.uri} is ${vs.status}, skipping`);\n        continue;\n      }\n\n      const model = vs.model || this.defaultModel;\n\n      try {\n        // 检查是否已经生成过这个 model 的 embedding\n        let embedding = modelEmbeddings.get(model);\n        if (!embedding) {\n          embedding = await this.embeddingService.embed(content, credential, model);\n          modelEmbeddings.set(model, embedding);\n        }\n\n        // 确保向量表存在\n        await this.vectorStore.ensureVectorTable(model);\n\n        // 存储向量\n        const vectorId = this.pathToVectorId(path);\n        await this.vectorStore.upsertVector(model, vectorId, embedding);\n\n        this.logger.info(`Indexed ${path} to model ${model}, vectorId=${vectorId}`);\n      } catch (error) {\n        this.logger.error(`Failed to index ${path} to model ${model}: ${error}`);\n      }\n    }\n  }\n\n  /**\n   * 查找覆盖指定路径的 VectorStore\n   */\n  private async findVectorStoresForPath(\n    path: string,\n    podBaseUrl: string,\n  ): Promise<VectorStoreDefinition[]> {\n    const allStores = await this.getVectorStoreDefinitions(podBaseUrl);\n\n    return allStores.filter((vs) => {\n      // 检查 path 是否在 scope 内\n      const scope = vs.scope.endsWith('/') ? vs.scope : `${vs.scope}/`;\n      return path.startsWith(scope);\n    });\n  }\n\n  /**\n   * 获取 Pod 的所有 VectorStore 定义\n   */\n  private async getVectorStoreDefinitions(podBaseUrl: string): Promise<VectorStoreDefinition[]> {\n    // 检查缓存\n    if (Date.now() < this.cacheExpiry && this.vectorStoreCache.has(podBaseUrl)) {\n      return this.vectorStoreCache.get(podBaseUrl)!;\n    }\n\n    try {\n      // 使用 undefineds.co/ns# 命名空间，与 drizzle-solid schema 一致\n      const query = `\n        PREFIX udfs: <https://undefineds.co/ns#>\n        SELECT ?vs ?scope ?model ?status ?chunkSize ?chunkOverlap WHERE {\n          ?vs a udfs:VectorStore ;\n              udfs:container ?scope .\n          OPTIONAL { ?vs udfs:chunkingStrategy ?model }\n          OPTIONAL { ?vs udfs:status ?status }\n          OPTIONAL { ?vs udfs:chunkSize ?chunkSize }\n          OPTIONAL { ?vs udfs:chunkOverlap ?chunkOverlap }\n        }\n      `;\n\n      const bindingsStream = await this.sparqlEngine.queryBindings(query, podBaseUrl);\n      const definitions: VectorStoreDefinition[] = [];\n\n      for await (const binding of bindingsStream) {\n        const vs = binding.get('vs');\n        const scope = binding.get('scope');\n        const model = binding.get('model');\n        const status = binding.get('status');\n        const chunkSize = binding.get('chunkSize');\n        const chunkOverlap = binding.get('chunkOverlap');\n\n        if (vs && scope) {\n          definitions.push({\n            uri: vs.value,\n            scope: this.resolveUri(scope.value, podBaseUrl),\n            model: model?.value || this.defaultModel,\n            status: (status?.value as 'active' | 'paused') || 'active',\n            chunkSize: chunkSize ? parseInt(chunkSize.value, 10) : undefined,\n            chunkOverlap: chunkOverlap ? parseInt(chunkOverlap.value, 10) : undefined,\n          });\n        }\n      }\n\n      // 更新缓存\n      this.vectorStoreCache.set(podBaseUrl, definitions);\n      this.cacheExpiry = Date.now() + this.cacheTtlMs;\n\n      this.logger.debug(`Found ${definitions.length} VectorStore(s) for ${podBaseUrl}`);\n      return definitions;\n    } catch (error) {\n      this.logger.error(`Failed to query VectorStore definitions: ${error}`);\n      return [];\n    }\n  }\n\n  /**\n   * 获取 AI 凭据\n   */\n  private async getAiCredential(podBaseUrl: string): Promise<AiCredential | null> {\n    try {\n      // Credential -> Provider 关联，从 Provider 获取 baseUrl 和 proxyUrl\n      const query = `\n        PREFIX cred: <${XPOD_CREDENTIAL.NAMESPACE}>\n        PREFIX ai: <${XPOD_AI.NAMESPACE}>\n        SELECT ?apiKey ?baseUrl ?providerUri ?proxyUrl WHERE {\n          ?cred a cred:Credential ;\n                cred:service \"ai\" ;\n                cred:status \"active\" ;\n                cred:apiKey ?apiKey .\n          OPTIONAL { ?cred cred:provider ?providerUri }\n          OPTIONAL { \n            ?cred cred:provider ?providerUri .\n            ?providerUri ai:baseUrl ?baseUrl .\n          }\n          OPTIONAL { \n            ?cred cred:provider ?providerUri .\n            ?providerUri ai:proxyUrl ?proxyUrl .\n          }\n        } LIMIT 1\n      `;\n\n      const bindingsStream = await this.sparqlEngine.queryBindings(query, podBaseUrl);\n\n      for await (const binding of bindingsStream) {\n        const apiKey = binding.get('apiKey');\n        const baseUrl = binding.get('baseUrl');\n        const providerUri = binding.get('providerUri');\n        const proxyUrl = binding.get('proxyUrl');\n\n        if (apiKey) {\n          const providerName = normalizeAIConfigProviderId(providerUri?.value || 'google') || 'google';\n          \n          return {\n            apiKey: apiKey.value,\n            baseUrl: baseUrl?.value,\n            provider: providerName,\n            proxyUrl: proxyUrl?.value,\n          };\n        }\n      }\n\n      return null;\n    } catch (error) {\n      this.logger.error(`Failed to query AI credential: ${error}`);\n      return null;\n    }\n  }\n\n  /**\n   * 读取资源内容\n   */\n  private async getResourceContent(path: string): Promise<string | null> {\n    try {\n      const preferences: RepresentationPreferences = {\n        type: { 'text/plain': 1, 'text/markdown': 0.9, 'text/turtle': 0.8, '*/*': 0.1 },\n      };\n\n      const representation = await this.resourceStore.getRepresentation({ path }, preferences);\n      const chunks: Buffer[] = [];\n\n      for await (const chunk of representation.data) {\n        chunks.push(Buffer.isBuffer(chunk) ? chunk : Buffer.from(chunk));\n      }\n\n      return Buffer.concat(chunks).toString('utf-8');\n    } catch (error) {\n      this.logger.error(`Failed to read resource ${path}: ${error}`);\n      return null;\n    }\n  }\n\n  /**\n   * 检查是否为支持的文件类型\n   */\n  private isSupportedFile(path: string): boolean {\n    const ext = this.getExtension(path);\n    return this.supportedExtensions.has(ext);\n  }\n\n  /**\n   * 获取文件扩展名\n   */\n  private getExtension(path: string): string {\n    const lastDot = path.lastIndexOf('.');\n    if (lastDot === -1) return '';\n    return path.slice(lastDot).toLowerCase();\n  }\n\n  /**\n   * 从路径提取 Pod base URL\n   */\n  private getPodBaseUrl(path: string): string | null {\n    // 假设路径格式为 /username/... 或 https://pod.example.com/username/...\n    try {\n      const url = new URL(path, 'http://localhost');\n      const parts = url.pathname.split('/').filter(Boolean);\n      if (parts.length > 0) {\n        return `${url.origin}/${parts[0]}/`;\n      }\n    } catch {\n      // 相对路径\n      const parts = path.split('/').filter(Boolean);\n      if (parts.length > 0) {\n        return `/${parts[0]}/`;\n      }\n    }\n    return null;\n  }\n\n  /**\n   * 解析相对 URI\n   */\n  private resolveUri(uri: string, baseUrl: string): string {\n    if (uri.startsWith('http://') || uri.startsWith('https://')) {\n      return uri;\n    }\n    if (uri.startsWith('/')) {\n      try {\n        const base = new URL(baseUrl);\n        return `${base.origin}${uri}`;\n      } catch {\n        return uri;\n      }\n    }\n    return `${baseUrl}${uri}`;\n  }\n\n  /**\n   * 将路径转换为向量 ID（使用 hash）\n   */\n  private pathToVectorId(path: string): number {\n    let hash = 2166136261; // FNV offset basis\n    for (let i = 0; i < path.length; i++) {\n      hash ^= path.charCodeAt(i);\n      hash = Math.imul(hash, 16777619); // FNV prime\n    }\n    return Math.abs(hash);\n  }\n\n  /**\n   * 清除缓存\n   */\n  public clearCache(): void {\n    this.vectorStoreCache.clear();\n    this.cacheExpiry = 0;\n  }\n}\n"]}
+{"version":3,"file":"VectorIndexingListener.js","sourceRoot":"","sources":["../../../src/storage/vector/VectorIndexingListener.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * VectorIndexingListener - 向量索引监听器\n *\n * 监听资源变更事件，自动触发向量索引更新。\n *\n * 工作流程：\n * 1. 收到资源变更事件\n * 2. 检查资源是否在某个 VectorStore 的 scope 内\n * 3. 如果是，读取资源内容，生成 embedding，存入向量库\n */\n\nimport { getLoggerFor } from 'global-logger-factory';\nimport type { ResourceChangeEvent, ResourceChangeListener } from '../ObservableResourceStore';\nimport type { VectorStore } from '../vector/VectorStore';\nimport type { EmbeddingService } from '../../ai/service/EmbeddingService';\nimport type { SparqlEngine } from '../sparql/SubgraphQueryEngine';\nimport type { AiCredential } from '../../ai/service/types';\nimport type { ResourceStore, RepresentationPreferences } from '@solid/community-server';\nimport { XPOD_AI, XPOD_CREDENTIAL, normalizeAIConfigProviderId } from '@undefineds.co/models';\n\n/**\n * VectorStore 定义（从 RDF 读取）\n */\nexport interface VectorStoreDefinition {\n  /** VectorStore resource */\n  resource: string;\n  /** 索引范围（Container resource） */\n  scope: string;\n  /** embedding 模型 */\n  model: string;\n  /** 状态 */\n  status: 'active' | 'paused';\n  /** 分块大小 */\n  chunkSize?: number;\n  /** 分块重叠 */\n  chunkOverlap?: number;\n}\n\nexport interface VectorIndexingListenerOptions {\n  /** SPARQL 引擎（用于查询 VectorStore 定义和 AI 凭据） */\n  sparqlEngine: SparqlEngine;\n  /** 向量存储 */\n  vectorStore: VectorStore;\n  /** Embedding 服务 */\n  embeddingService: EmbeddingService;\n  /** 资源存储（用于读取资源内容） */\n  resourceStore: ResourceStore;\n  /** 默认 embedding 模型 */\n  defaultModel?: string;\n  /** 支持的文件扩展名 */\n  supportedExtensions?: string[];\n}\n\n/**\n * VectorIndexingListener - 自动向量索引\n */\nexport class VectorIndexingListener implements ResourceChangeListener {\n  protected readonly logger = getLoggerFor(this);\n\n  private readonly sparqlEngine: SparqlEngine;\n  private readonly vectorStore: VectorStore;\n  private readonly embeddingService: EmbeddingService;\n  private readonly resourceStore: ResourceStore;\n  private readonly defaultModel: string;\n  private readonly supportedExtensions: Set<string>;\n\n  // 缓存 VectorStore 定义，避免频繁查询\n  private vectorStoreCache = new Map<string, VectorStoreDefinition[]>();\n  private cacheExpiry = 0;\n  private readonly cacheTtlMs = 60000; // 1 分钟缓存\n\n  public constructor(options: VectorIndexingListenerOptions) {\n    this.sparqlEngine = options.sparqlEngine;\n    this.vectorStore = options.vectorStore;\n    this.embeddingService = options.embeddingService;\n    this.resourceStore = options.resourceStore;\n    this.defaultModel = options.defaultModel ?? 'text-embedding-004';\n    this.supportedExtensions = new Set(\n      options.supportedExtensions ?? ['.txt', '.md', '.html', '.json', '.ttl', '.jsonld'],\n    );\n  }\n\n  /**\n   * 处理资源变更事件\n   */\n  public async onResourceChanged(event: ResourceChangeEvent): Promise<void> {\n    const { path, action, isContainer } = event;\n\n    // 跳过容器变更\n    if (isContainer) {\n      this.logger.debug(`Skipping container: ${path}`);\n      return;\n    }\n\n    // 检查文件扩展名\n    if (!this.isSupportedFile(path)) {\n      this.logger.debug(`Skipping unsupported file type: ${path}`);\n      return;\n    }\n\n    // 获取 Pod base URL\n    const podBaseUrl = this.getPodBaseUrl(path);\n    if (!podBaseUrl) {\n      this.logger.debug(`Cannot determine pod base URL for: ${path}`);\n      return;\n    }\n\n    // 如果是 VectorStore 配置文件或 Credential 配置文件更新，清除缓存\n    if (path.includes('vector-stores') || path.includes('credentials')) {\n      this.logger.debug(`Configuration file updated, clearing cache for ${podBaseUrl}`);\n      this.vectorStoreCache.delete(podBaseUrl);\n      // 配置文件本身不需要索引，直接返回\n      return;\n    }\n\n    try {\n      // 查找覆盖此路径的 VectorStore\n      const vectorStores = await this.findVectorStoresForPath(path, podBaseUrl);\n      if (vectorStores.length === 0) {\n        this.logger.debug(`No VectorStore configured for: ${path}`);\n        return;\n      }\n\n      this.logger.info(`Processing ${action} for ${path}, matched ${vectorStores.length} VectorStore(s)`);\n\n      // 根据 action 执行索引操作\n      if (action === 'delete') {\n        await this.handleDelete(path, vectorStores);\n      } else {\n        await this.handleCreateOrUpdate(path, podBaseUrl, vectorStores);\n      }\n    } catch (error) {\n      this.logger.error(`Failed to process ${action} for ${path}: ${error}`);\n    }\n  }\n\n  /**\n   * 处理删除操作\n   */\n  private async handleDelete(path: string, vectorStores: VectorStoreDefinition[]): Promise<void> {\n    const vectorId = this.pathToVectorId(path);\n\n    for (const vs of vectorStores) {\n      try {\n        await this.vectorStore.deleteVector(vs.model, vectorId);\n        this.logger.info(`Deleted vector for ${path} from model ${vs.model}`);\n      } catch (error) {\n        this.logger.error(`Failed to delete vector for ${path}: ${error}`);\n      }\n    }\n  }\n\n  /**\n   * 处理创建或更新操作\n   */\n  private async handleCreateOrUpdate(\n    path: string,\n    podBaseUrl: string,\n    vectorStores: VectorStoreDefinition[],\n  ): Promise<void> {\n    // 读取资源内容\n    const content = await this.getResourceContent(path);\n    if (!content || content.trim().length === 0) {\n      this.logger.debug(`Empty content for ${path}, skipping`);\n      return;\n    }\n\n    // 获取 AI 凭据\n    const credential = await this.getAiCredential(podBaseUrl);\n    if (!credential) {\n      this.logger.warn(`No AI credential found for ${podBaseUrl}, skipping indexing`);\n      return;\n    }\n\n    // 为每个 VectorStore 生成 embedding 并存储\n    // 注意：如果多个 VectorStore 使用相同的 model，只需要生成一次 embedding\n    const modelEmbeddings = new Map<string, number[]>();\n\n    for (const vs of vectorStores) {\n      if (vs.status !== 'active') {\n        this.logger.debug(`VectorStore ${vs.resource} is ${vs.status}, skipping`);\n        continue;\n      }\n\n      const model = vs.model || this.defaultModel;\n\n      try {\n        // 检查是否已经生成过这个 model 的 embedding\n        let embedding = modelEmbeddings.get(model);\n        if (!embedding) {\n          embedding = await this.embeddingService.embed(content, credential, model);\n          modelEmbeddings.set(model, embedding);\n        }\n\n        // 确保向量表存在\n        await this.vectorStore.ensureVectorTable(model);\n\n        // 存储向量\n        const vectorId = this.pathToVectorId(path);\n        await this.vectorStore.upsertVector(model, vectorId, embedding);\n\n        this.logger.info(`Indexed ${path} to model ${model}, vectorId=${vectorId}`);\n      } catch (error) {\n        this.logger.error(`Failed to index ${path} to model ${model}: ${error}`);\n      }\n    }\n  }\n\n  /**\n   * 查找覆盖指定路径的 VectorStore\n   */\n  private async findVectorStoresForPath(\n    path: string,\n    podBaseUrl: string,\n  ): Promise<VectorStoreDefinition[]> {\n    const allStores = await this.getVectorStoreDefinitions(podBaseUrl);\n\n    return allStores.filter((vs) => {\n      // 检查 path 是否在 scope 内\n      const scope = vs.scope.endsWith('/') ? vs.scope : `${vs.scope}/`;\n      return path.startsWith(scope);\n    });\n  }\n\n  /**\n   * 获取 Pod 的所有 VectorStore 定义\n   */\n  private async getVectorStoreDefinitions(podBaseUrl: string): Promise<VectorStoreDefinition[]> {\n    // 检查缓存\n    if (Date.now() < this.cacheExpiry && this.vectorStoreCache.has(podBaseUrl)) {\n      return this.vectorStoreCache.get(podBaseUrl)!;\n    }\n\n    try {\n      // 使用 undefineds.co/ns# 命名空间，与 drizzle-solid schema 一致\n      const query = `\n        PREFIX udfs: <https://undefineds.co/ns#>\n        SELECT ?vs ?scope ?model ?status ?chunkSize ?chunkOverlap WHERE {\n          ?vs a udfs:VectorStore ;\n              udfs:container ?scope .\n          OPTIONAL { ?vs udfs:chunkingStrategy ?model }\n          OPTIONAL { ?vs udfs:status ?status }\n          OPTIONAL { ?vs udfs:chunkSize ?chunkSize }\n          OPTIONAL { ?vs udfs:chunkOverlap ?chunkOverlap }\n        }\n      `;\n\n      const bindingsStream = await this.sparqlEngine.queryBindings(query, podBaseUrl);\n      const definitions: VectorStoreDefinition[] = [];\n\n      for await (const binding of bindingsStream) {\n        const vs = binding.get('vs');\n        const scope = binding.get('scope');\n        const model = binding.get('model');\n        const status = binding.get('status');\n        const chunkSize = binding.get('chunkSize');\n        const chunkOverlap = binding.get('chunkOverlap');\n\n        if (vs && scope) {\n          definitions.push({\n            resource: vs.value,\n            scope: this.resolveResource(scope.value, podBaseUrl),\n            model: model?.value || this.defaultModel,\n            status: (status?.value as 'active' | 'paused') || 'active',\n            chunkSize: chunkSize ? parseInt(chunkSize.value, 10) : undefined,\n            chunkOverlap: chunkOverlap ? parseInt(chunkOverlap.value, 10) : undefined,\n          });\n        }\n      }\n\n      // 更新缓存\n      this.vectorStoreCache.set(podBaseUrl, definitions);\n      this.cacheExpiry = Date.now() + this.cacheTtlMs;\n\n      this.logger.debug(`Found ${definitions.length} VectorStore(s) for ${podBaseUrl}`);\n      return definitions;\n    } catch (error) {\n      this.logger.error(`Failed to query VectorStore definitions: ${error}`);\n      return [];\n    }\n  }\n\n  /**\n   * 获取 AI 凭据\n   */\n  private async getAiCredential(podBaseUrl: string): Promise<AiCredential | null> {\n    try {\n      // Credential -> Provider 关联，从 Provider 获取 baseUrl 和 proxyUrl\n      const query = `\n        PREFIX cred: <${XPOD_CREDENTIAL.NAMESPACE}>\n        PREFIX ai: <${XPOD_AI.NAMESPACE}>\n        SELECT ?apiKey ?baseUrl ?provider ?proxyUrl WHERE {\n          ?cred a cred:Credential ;\n                cred:service \"ai\" ;\n                cred:status \"active\" ;\n                cred:apiKey ?apiKey .\n          OPTIONAL { ?cred cred:provider ?provider }\n          OPTIONAL { \n            ?cred cred:provider ?provider .\n            ?provider ai:baseUrl ?baseUrl .\n          }\n          OPTIONAL { \n            ?cred cred:provider ?provider .\n            ?provider ai:proxyUrl ?proxyUrl .\n          }\n        } LIMIT 1\n      `;\n\n      const bindingsStream = await this.sparqlEngine.queryBindings(query, podBaseUrl);\n\n      for await (const binding of bindingsStream) {\n        const apiKey = binding.get('apiKey');\n        const baseUrl = binding.get('baseUrl');\n        const provider = binding.get('provider');\n        const proxyUrl = binding.get('proxyUrl');\n\n        if (apiKey) {\n          const providerName = normalizeAIConfigProviderId(provider?.value || 'google') || 'google';\n          \n          return {\n            apiKey: apiKey.value,\n            baseUrl: baseUrl?.value,\n            provider: providerName,\n            proxyUrl: proxyUrl?.value,\n          };\n        }\n      }\n\n      return null;\n    } catch (error) {\n      this.logger.error(`Failed to query AI credential: ${error}`);\n      return null;\n    }\n  }\n\n  /**\n   * 读取资源内容\n   */\n  private async getResourceContent(path: string): Promise<string | null> {\n    try {\n      const preferences: RepresentationPreferences = {\n        type: { 'text/plain': 1, 'text/markdown': 0.9, 'text/turtle': 0.8, '*/*': 0.1 },\n      };\n\n      const representation = await this.resourceStore.getRepresentation({ path }, preferences);\n      const chunks: Buffer[] = [];\n\n      for await (const chunk of representation.data) {\n        chunks.push(Buffer.isBuffer(chunk) ? chunk : Buffer.from(chunk));\n      }\n\n      return Buffer.concat(chunks).toString('utf-8');\n    } catch (error) {\n      this.logger.error(`Failed to read resource ${path}: ${error}`);\n      return null;\n    }\n  }\n\n  /**\n   * 检查是否为支持的文件类型\n   */\n  private isSupportedFile(path: string): boolean {\n    const ext = this.getExtension(path);\n    return this.supportedExtensions.has(ext);\n  }\n\n  /**\n   * 获取文件扩展名\n   */\n  private getExtension(path: string): string {\n    const lastDot = path.lastIndexOf('.');\n    if (lastDot === -1) return '';\n    return path.slice(lastDot).toLowerCase();\n  }\n\n  /**\n   * 从路径提取 Pod base URL\n   */\n  private getPodBaseUrl(path: string): string | null {\n    // 假设路径格式为 /username/... 或 https://pod.example.com/username/...\n    try {\n      const url = new URL(path, 'http://localhost');\n      const parts = url.pathname.split('/').filter(Boolean);\n      if (parts.length > 0) {\n        return `${url.origin}/${parts[0]}/`;\n      }\n    } catch {\n      // 相对路径\n      const parts = path.split('/').filter(Boolean);\n      if (parts.length > 0) {\n        return `/${parts[0]}/`;\n      }\n    }\n    return null;\n  }\n\n  /**\n   * 解析相对资源引用\n   */\n  private resolveResource(resource: string, baseUrl: string): string {\n    if (resource.startsWith('http://') || resource.startsWith('https://')) {\n      return resource;\n    }\n    if (resource.startsWith('/')) {\n      try {\n        const base = new URL(baseUrl);\n        return `${base.origin}${resource}`;\n      } catch {\n        return resource;\n      }\n    }\n    return `${baseUrl}${resource}`;\n  }\n\n  /**\n   * 将路径转换为向量 ID（使用 hash）\n   */\n  private pathToVectorId(path: string): number {\n    let hash = 2166136261; // FNV offset basis\n    for (let i = 0; i < path.length; i++) {\n      hash ^= path.charCodeAt(i);\n      hash = Math.imul(hash, 16777619); // FNV prime\n    }\n    return Math.abs(hash);\n  }\n\n  /**\n   * 清除缓存\n   */\n  public clearCache(): void {\n    this.vectorStoreCache.clear();\n    this.cacheExpiry = 0;\n  }\n}\n"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@undefineds.co/xpod",
-  "version": "0.3.6",
+  "version": "0.3.14",
   "description": "Xpod is an extended Community Solid Server, offering rich-feature, production-level Solid Pod and identity management.",
   "repository": "https://github.com/undefinedsco/xpod",
   "author": "developer@undefineds.co",
@@ -95,6 +95,7 @@
     "test:quad-vs-quint": "vitest --run tests/storage/quad-vs-quint-comparison.test.ts",
     "test:w3c": "vitest --run tests/storage/w3c-sparql-full.test.ts",
     "test:storage": "vitest --run tests/storage/",
+    "benchmark:rdf-models": "bun scripts/rdf-models-benchmark.ts",
     "dev:cluster:lite": "docker compose -f docker-compose.standalone.yml up --build",
     "dev:cluster:lite:down": "docker compose -f docker-compose.standalone.yml down",
     "doctor:dev-procs": "node scripts/dev-process-doctor.cjs scan",
@@ -138,7 +139,6 @@
     "dotenv": "^16.4.5",
     "dotenv-cli": "^7.4.4",
     "jsdom": "^24.0.0",
-    "jsonld": "^8.3.3",
     "memory-level": "^3.1.0",
     "nat-upnp": "^1.1.1",
     "node-pty": "^1.1.0",
@@ -175,6 +175,7 @@
     "i18next": "^23.10.1",
     "inngest": "^4.4.0",
     "inngest-cli": "^1.19.4",
+    "jsonld": "^8.3.3",
     "minio": "^8.0.2",
     "pg": "^8.13.1",
     "pg-query-stream": "^4.7.1",