@undefineds.co/xpod 0.3.6 → 0.3.15

package/dist/storage/rdf/ShadowRdfQuintStore.jsonld

@@ -0,0 +1,308 @@
+{
+  "@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/ShadowRdfQuintStore.jsonld#ShadowRdfQuintStoreOptions",
+      "@type": "AbstractClass",
+      "requireElement": "ShadowRdfQuintStoreOptions",
+      "parameters": [],
+      "memberFields": [
+        {
+          "@id": "undefineds:dist/storage/rdf/ShadowRdfQuintStore.jsonld#ShadowRdfQuintStoreOptions__member_compatibilityStore",
+          "memberFieldName": "compatibilityStore"
+        },
+        {
+          "@id": "undefineds:dist/storage/rdf/ShadowRdfQuintStore.jsonld#ShadowRdfQuintStoreOptions__member_index",
+          "memberFieldName": "index"
+        },
+        {
+          "@id": "undefineds:dist/storage/rdf/ShadowRdfQuintStore.jsonld#ShadowRdfQuintStoreOptions__member_autoOpen",
+          "memberFieldName": "autoOpen"
+        },
+        {
+          "@id": "undefineds:dist/storage/rdf/ShadowRdfQuintStore.jsonld#ShadowRdfQuintStoreOptions__member_autoBackfill",
+          "memberFieldName": "autoBackfill"
+        }
+      ],
+      "constructorArguments": []
+    },
+    {
+      "@id": "undefineds:dist/storage/rdf/ShadowRdfQuintStore.jsonld#ShadowRdfQuintStore",
+      "@type": "Class",
+      "requireElement": "ShadowRdfQuintStore",
+      "extends": [
+        "undefineds:dist/storage/quint/types.jsonld#QuintStore"
+      ],
+      "comment": "Shadow-first bridge from the existing TEXT QuintStore to the term-id RDF index.  Reads keep using the compatibility store. Writes are mirrored into RdfQuadIndex so callers can run explicit shadow comparisons before any query path is switched to SolidRdfEngine.",
+      "parameters": [
+        {
+          "@id": "undefineds:dist/storage/rdf/ShadowRdfQuintStore.jsonld#ShadowRdfQuintStore_options_compatibilityStore",
+          "range": "undefineds:dist/storage/quint/types.jsonld#QuintStore"
+        },
+        {
+          "@id": "undefineds:dist/storage/rdf/ShadowRdfQuintStore.jsonld#ShadowRdfQuintStore_options_index_path",
+          "range": "xsd:string"
+        },
+        {
+          "@id": "undefineds:dist/storage/rdf/ShadowRdfQuintStore.jsonld#ShadowRdfQuintStore_options_index_debug",
+          "range": {
+            "@type": "ParameterRangeUnion",
+            "parameterRangeElements": [
+              "xsd:boolean",
+              {
+                "@type": "ParameterRangeUndefined"
+              }
+            ]
+          }
+        },
+        {
+          "@id": "undefineds:dist/storage/rdf/ShadowRdfQuintStore.jsonld#ShadowRdfQuintStore_options_autoOpen",
+          "range": {
+            "@type": "ParameterRangeUnion",
+            "parameterRangeElements": [
+              "xsd:boolean",
+              {
+                "@type": "ParameterRangeUndefined"
+              }
+            ]
+          }
+        },
+        {
+          "@id": "undefineds:dist/storage/rdf/ShadowRdfQuintStore.jsonld#ShadowRdfQuintStore_options_autoBackfill_enabled",
+          "range": {
+            "@type": "ParameterRangeUnion",
+            "parameterRangeElements": [
+              "xsd:boolean",
+              {
+                "@type": "ParameterRangeUndefined"
+              }
+            ]
+          }
+        },
+        {
+          "@id": "undefineds:dist/storage/rdf/ShadowRdfQuintStore.jsonld#ShadowRdfQuintStore_options_autoBackfill_clear",
+          "range": {
+            "@type": "ParameterRangeUnion",
+            "parameterRangeElements": [
+              "xsd:boolean",
+              {
+                "@type": "ParameterRangeUndefined"
+              }
+            ]
+          }
+        },
+        {
+          "@id": "undefineds:dist/storage/rdf/ShadowRdfQuintStore.jsonld#ShadowRdfQuintStore_options_autoBackfill_batchSize",
+          "range": {
+            "@type": "ParameterRangeUnion",
+            "parameterRangeElements": [
+              "xsd:number",
+              {
+                "@type": "ParameterRangeUndefined"
+              }
+            ]
+          }
+        }
+      ],
+      "memberFields": [
+        {
+          "@id": "undefineds:dist/storage/rdf/ShadowRdfQuintStore.jsonld#ShadowRdfQuintStore__member_index",
+          "memberFieldName": "index",
+          "range": "undefineds:dist/storage/rdf/RdfQuadIndex.jsonld#RdfQuadIndex"
+        },
+        {
+          "@id": "undefineds:dist/storage/rdf/ShadowRdfQuintStore.jsonld#ShadowRdfQuintStore__member_compatibilityStore",
+          "memberFieldName": "compatibilityStore"
+        },
+        {
+          "@id": "undefineds:dist/storage/rdf/ShadowRdfQuintStore.jsonld#ShadowRdfQuintStore__member_ownsIndex",
+          "memberFieldName": "ownsIndex"
+        },
+        {
+          "@id": "undefineds:dist/storage/rdf/ShadowRdfQuintStore.jsonld#ShadowRdfQuintStore__member_comparator",
+          "memberFieldName": "comparator"
+        },
+        {
+          "@id": "undefineds:dist/storage/rdf/ShadowRdfQuintStore.jsonld#ShadowRdfQuintStore__member_autoBackfill",
+          "memberFieldName": "autoBackfill"
+        },
+        {
+          "@id": "undefineds:dist/storage/rdf/ShadowRdfQuintStore.jsonld#ShadowRdfQuintStore__member_opened",
+          "memberFieldName": "opened"
+        },
+        {
+          "@id": "undefineds:dist/storage/rdf/ShadowRdfQuintStore.jsonld#ShadowRdfQuintStore__member_opening",
+          "memberFieldName": "opening"
+        },
+        {
+          "@id": "undefineds:dist/storage/rdf/ShadowRdfQuintStore.jsonld#ShadowRdfQuintStore__member_autoBackfilled",
+          "memberFieldName": "autoBackfilled"
+        },
+        {
+          "@id": "undefineds:dist/storage/rdf/ShadowRdfQuintStore.jsonld#ShadowRdfQuintStore__member_constructor",
+          "memberFieldName": "constructor"
+        },
+        {
+          "@id": "undefineds:dist/storage/rdf/ShadowRdfQuintStore.jsonld#ShadowRdfQuintStore__member_open",
+          "memberFieldName": "open"
+        },
+        {
+          "@id": "undefineds:dist/storage/rdf/ShadowRdfQuintStore.jsonld#ShadowRdfQuintStore__member_openOnce",
+          "memberFieldName": "openOnce"
+        },
+        {
+          "@id": "undefineds:dist/storage/rdf/ShadowRdfQuintStore.jsonld#ShadowRdfQuintStore__member_close",
+          "memberFieldName": "close"
+        },
+        {
+          "@id": "undefineds:dist/storage/rdf/ShadowRdfQuintStore.jsonld#ShadowRdfQuintStore__member_get",
+          "memberFieldName": "get"
+        },
+        {
+          "@id": "undefineds:dist/storage/rdf/ShadowRdfQuintStore.jsonld#ShadowRdfQuintStore__member_match",
+          "memberFieldName": "match"
+        },
+        {
+          "@id": "undefineds:dist/storage/rdf/ShadowRdfQuintStore.jsonld#ShadowRdfQuintStore__member_getByGraphPrefix",
+          "memberFieldName": "getByGraphPrefix"
+        },
+        {
+          "@id": "undefineds:dist/storage/rdf/ShadowRdfQuintStore.jsonld#ShadowRdfQuintStore__member_count",
+          "memberFieldName": "count"
+        },
+        {
+          "@id": "undefineds:dist/storage/rdf/ShadowRdfQuintStore.jsonld#ShadowRdfQuintStore__member_getCompound",
+          "memberFieldName": "getCompound"
+        },
+        {
+          "@id": "undefineds:dist/storage/rdf/ShadowRdfQuintStore.jsonld#ShadowRdfQuintStore__member_getAttributes",
+          "memberFieldName": "getAttributes"
+        },
+        {
+          "@id": "undefineds:dist/storage/rdf/ShadowRdfQuintStore.jsonld#ShadowRdfQuintStore__member_put",
+          "memberFieldName": "put"
+        },
+        {
+          "@id": "undefineds:dist/storage/rdf/ShadowRdfQuintStore.jsonld#ShadowRdfQuintStore__member_multiPut",
+          "memberFieldName": "multiPut"
+        },
+        {
+          "@id": "undefineds:dist/storage/rdf/ShadowRdfQuintStore.jsonld#ShadowRdfQuintStore__member_replaceSource",
+          "memberFieldName": "replaceSource"
+        },
+        {
+          "@id": "undefineds:dist/storage/rdf/ShadowRdfQuintStore.jsonld#ShadowRdfQuintStore__member_deleteSource",
+          "memberFieldName": "deleteSource"
+        },
+        {
+          "@id": "undefineds:dist/storage/rdf/ShadowRdfQuintStore.jsonld#ShadowRdfQuintStore__member_updateEmbedding",
+          "memberFieldName": "updateEmbedding"
+        },
+        {
+          "@id": "undefineds:dist/storage/rdf/ShadowRdfQuintStore.jsonld#ShadowRdfQuintStore__member_del",
+          "memberFieldName": "del"
+        },
+        {
+          "@id": "undefineds:dist/storage/rdf/ShadowRdfQuintStore.jsonld#ShadowRdfQuintStore__member_multiDel",
+          "memberFieldName": "multiDel"
+        },
+        {
+          "@id": "undefineds:dist/storage/rdf/ShadowRdfQuintStore.jsonld#ShadowRdfQuintStore__member_stats",
+          "memberFieldName": "stats"
+        },
+        {
+          "@id": "undefineds:dist/storage/rdf/ShadowRdfQuintStore.jsonld#ShadowRdfQuintStore__member_clear",
+          "memberFieldName": "clear"
+        },
+        {
+          "@id": "undefineds:dist/storage/rdf/ShadowRdfQuintStore.jsonld#ShadowRdfQuintStore__member_backfillShadowIndex",
+          "memberFieldName": "backfillShadowIndex"
+        },
+        {
+          "@id": "undefineds:dist/storage/rdf/ShadowRdfQuintStore.jsonld#ShadowRdfQuintStore__member_shadowGet",
+          "memberFieldName": "shadowGet"
+        },
+        {
+          "@id": "undefineds:dist/storage/rdf/ShadowRdfQuintStore.jsonld#ShadowRdfQuintStore__member_runAutoBackfill",
+          "memberFieldName": "runAutoBackfill"
+        },
+        {
+          "@id": "undefineds:dist/storage/rdf/ShadowRdfQuintStore.jsonld#ShadowRdfQuintStore__member_shouldAutoBackfill",
+          "memberFieldName": "shouldAutoBackfill"
+        },
+        {
+          "@id": "undefineds:dist/storage/rdf/ShadowRdfQuintStore.jsonld#ShadowRdfQuintStore__member_autoBackfillOptions",
+          "memberFieldName": "autoBackfillOptions"
+        }
+      ],
+      "constructorArguments": [
+        {
+          "@id": "undefineds:dist/storage/rdf/ShadowRdfQuintStore.jsonld#ShadowRdfQuintStore_options__constructorArgument",
+          "fields": [
+            {
+              "keyRaw": "compatibilityStore",
+              "value": {
+                "@id": "undefineds:dist/storage/rdf/ShadowRdfQuintStore.jsonld#ShadowRdfQuintStore_options_compatibilityStore"
+              }
+            },
+            {
+              "keyRaw": "index",
+              "value": {
+                "@id": "undefineds:dist/storage/rdf/ShadowRdfQuintStore.jsonld#ShadowRdfQuintStore_options_index__constructorArgument",
+                "fields": [
+                  {
+                    "keyRaw": "path",
+                    "value": {
+                      "@id": "undefineds:dist/storage/rdf/ShadowRdfQuintStore.jsonld#ShadowRdfQuintStore_options_index_path"
+                    }
+                  },
+                  {
+                    "keyRaw": "debug",
+                    "value": {
+                      "@id": "undefineds:dist/storage/rdf/ShadowRdfQuintStore.jsonld#ShadowRdfQuintStore_options_index_debug"
+                    }
+                  }
+                ]
+              }
+            },
+            {
+              "keyRaw": "autoOpen",
+              "value": {
+                "@id": "undefineds:dist/storage/rdf/ShadowRdfQuintStore.jsonld#ShadowRdfQuintStore_options_autoOpen"
+              }
+            },
+            {
+              "keyRaw": "autoBackfill",
+              "value": {
+                "@id": "undefineds:dist/storage/rdf/ShadowRdfQuintStore.jsonld#ShadowRdfQuintStore_options_autoBackfill__constructorArgument",
+                "fields": [
+                  {
+                    "keyRaw": "enabled",
+                    "value": {
+                      "@id": "undefineds:dist/storage/rdf/ShadowRdfQuintStore.jsonld#ShadowRdfQuintStore_options_autoBackfill_enabled"
+                    }
+                  },
+                  {
+                    "keyRaw": "clear",
+                    "value": {
+                      "@id": "undefineds:dist/storage/rdf/ShadowRdfQuintStore.jsonld#ShadowRdfQuintStore_options_autoBackfill_clear"
+                    }
+                  },
+                  {
+                    "keyRaw": "batchSize",
+                    "value": {
+                      "@id": "undefineds:dist/storage/rdf/ShadowRdfQuintStore.jsonld#ShadowRdfQuintStore_options_autoBackfill_batchSize"
+                    }
+                  }
+                ]
+              }
+            }
+          ]
+        }
+      ]
+    }
+  ]
+}

package/dist/storage/rdf/SolidRdfEngine.d.ts

@@ -0,0 +1,56 @@
+import type { Quad } from '@rdfjs/types';
+import type { QuintPattern, QuintStore } from '../quint/types';
+import type { Rdf3xShadowJoinResult, Rdf3xShadowScanResult, Rdf3xTripleIndexOptions, RdfIndexPutOptions, RdfPatternQuery, RdfQuadJoinOptions, RdfQuadJoinPattern, RdfQuadIndexOptions, RdfQuadIndexScanResult, RdfSourceInput, RdfShadowScanResult, RdfTextChunkInput, RdfTextIndexOptions, RdfTextSearchOptions, RdfTextSearchResult, RdfTextSourceInput, RdfVectorChunkInput, RdfVectorIndexOptions, RdfVectorSearchOptions, RdfVectorSearchResult, RdfVectorSourceInput } from './types';
+import { RdfQuadIndex } from './RdfQuadIndex';
+import { Rdf3xTripleIndex } from './Rdf3xTripleIndex';
+import { RdfTextIndex } from './RdfTextIndex';
+import { RdfVectorIndex } from './RdfVectorIndex';
+import type { RdfLocalQuery, RdfLocalQueryResult } from './types';
+export interface SolidRdfEngineOptions {
+    index: RdfQuadIndex | RdfQuadIndexOptions;
+    textIndex?: RdfTextIndex | RdfTextIndexOptions;
+    vectorIndex?: RdfVectorIndex | RdfVectorIndexOptions;
+    rdf3xIndex?: Rdf3xTripleIndex | Rdf3xTripleIndexOptions;
+    rdf3xPrimary?: boolean;
+    compatibilityStore?: QuintStore;
+    autoOpen?: boolean;
+}
+export declare class SolidRdfEngine {
+    readonly index: RdfQuadIndex;
+    readonly textIndex?: RdfTextIndex;
+    readonly vectorIndex?: RdfVectorIndex;
+    readonly rdf3xIndex?: Rdf3xTripleIndex;
+    private readonly ownsIndex;
+    private readonly ownsTextIndex;
+    private readonly ownsVectorIndex;
+    private readonly ownsRdf3xIndex;
+    private readonly rdf3xPrimary;
+    private readonly compatibilityStore?;
+    private shadowComparator?;
+    private readonly queryEngine;
+    private rdf3xDirty;
+    constructor(options: SolidRdfEngineOptions);
+    open(): void;
+    close(): Promise<void>;
+    put(quads: Quad | Quad[], options?: RdfIndexPutOptions): void;
+    replaceSource(quads: Quad[], source: RdfSourceInput): void;
+    deleteSource(source: string): number;
+    delete(pattern: QuintPattern): number;
+    scan(query: RdfPatternQuery): RdfQuadIndexScanResult;
+    query(query: RdfLocalQuery): RdfLocalQueryResult;
+    indexTextSource(source: RdfTextSourceInput, text: string, chunks?: RdfTextChunkInput[]): void;
+    deleteTextSource(source: string): number;
+    searchText(options: RdfTextSearchOptions | string): RdfTextSearchResult[];
+    indexVectorSource(source: RdfVectorSourceInput, chunks: RdfVectorChunkInput[]): void;
+    deleteVectorSource(source: string): number;
+    searchVector(options: RdfVectorSearchOptions): RdfVectorSearchResult[];
+    shadowScan(query: RdfPatternQuery): Promise<RdfShadowScanResult>;
+    shadowRdf3xScan(query: RdfPatternQuery): Rdf3xShadowScanResult;
+    shadowRdf3xJoin(patterns: RdfQuadJoinPattern[], options?: RdfQuadJoinOptions): Rdf3xShadowJoinResult;
+    supportsPrimary(query: RdfPatternQuery): boolean;
+    private requireTextIndex;
+    private requireVectorIndex;
+    private requireRdf3xIndex;
+    private markRdf3xDirty;
+    private refreshRdf3xPrimary;
+}

package/dist/storage/rdf/SolidRdfEngine.js

@@ -0,0 +1,292 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SolidRdfEngine = void 0;
+const n3_1 = require("n3");
+const types_1 = require("../quint/types");
+const RdfQuadIndex_1 = require("./RdfQuadIndex");
+const Rdf3xTripleIndex_1 = require("./Rdf3xTripleIndex");
+const RdfTextIndex_1 = require("./RdfTextIndex");
+const RdfVectorIndex_1 = require("./RdfVectorIndex");
+const RdfShadowComparator_1 = require("./RdfShadowComparator");
+const RdfLocalQueryEngine_1 = require("./RdfLocalQueryEngine");
+class SolidRdfEngine {
+    constructor(options) {
+        this.rdf3xDirty = true;
+        if (options.index instanceof RdfQuadIndex_1.RdfQuadIndex) {
+            this.index = options.index;
+            this.ownsIndex = false;
+        }
+        else {
+            this.index = new RdfQuadIndex_1.RdfQuadIndex(options.index);
+            this.ownsIndex = true;
+        }
+        if (options.textIndex instanceof RdfTextIndex_1.RdfTextIndex) {
+            this.textIndex = options.textIndex;
+            this.ownsTextIndex = false;
+        }
+        else if (isRdfTextIndexOptions(options.textIndex)) {
+            this.textIndex = new RdfTextIndex_1.RdfTextIndex(options.textIndex);
+            this.ownsTextIndex = true;
+        }
+        else {
+            this.ownsTextIndex = false;
+        }
+        if (options.vectorIndex instanceof RdfVectorIndex_1.RdfVectorIndex) {
+            this.vectorIndex = options.vectorIndex;
+            this.ownsVectorIndex = false;
+        }
+        else if (isRdfVectorIndexOptions(options.vectorIndex)) {
+            this.vectorIndex = new RdfVectorIndex_1.RdfVectorIndex(options.vectorIndex);
+            this.ownsVectorIndex = true;
+        }
+        else {
+            this.ownsVectorIndex = false;
+        }
+        if (options.rdf3xIndex instanceof Rdf3xTripleIndex_1.Rdf3xTripleIndex) {
+            this.rdf3xIndex = options.rdf3xIndex;
+            this.ownsRdf3xIndex = false;
+        }
+        else if (isRdf3xTripleIndexOptions(options.rdf3xIndex)) {
+            this.rdf3xIndex = new Rdf3xTripleIndex_1.Rdf3xTripleIndex(options.rdf3xIndex);
+            this.ownsRdf3xIndex = true;
+        }
+        else {
+            this.ownsRdf3xIndex = false;
+        }
+        if (options.rdf3xPrimary && !this.rdf3xIndex) {
+            throw new Error('SolidRdfEngine rdf3xPrimary requires an rdf3xIndex');
+        }
+        this.rdf3xPrimary = Boolean(options.rdf3xPrimary);
+        this.compatibilityStore = options.compatibilityStore;
+        this.queryEngine = new RdfLocalQueryEngine_1.RdfLocalQueryEngine(this.index, this.textIndex, this.vectorIndex, this.rdf3xPrimary ? this.rdf3xIndex : undefined);
+        if (this.compatibilityStore) {
+            this.shadowComparator = new RdfShadowComparator_1.RdfShadowComparator(this.index, this.compatibilityStore);
+        }
+        if (options.autoOpen) {
+            this.open();
+        }
+    }
+    open() {
+        this.index.open();
+        this.textIndex?.open();
+        this.vectorIndex?.open();
+        this.rdf3xIndex?.open();
+    }
+    async close() {
+        if (this.ownsRdf3xIndex) {
+            this.rdf3xIndex?.close();
+        }
+        if (this.ownsVectorIndex) {
+            this.vectorIndex?.close();
+        }
+        if (this.ownsTextIndex) {
+            this.textIndex?.close();
+        }
+        if (this.ownsIndex) {
+            this.index.close();
+        }
+        if (this.compatibilityStore) {
+            await this.compatibilityStore.close();
+        }
+    }
+    put(quads, options) {
+        this.index.multiPut(Array.isArray(quads) ? quads : [quads], options);
+        this.markRdf3xDirty();
+    }
+    replaceSource(quads, source) {
+        this.index.replaceSource(quads, source);
+        this.markRdf3xDirty();
+    }
+    deleteSource(source) {
+        const changes = this.index.deleteSource(source);
+        if (changes > 0) {
+            this.markRdf3xDirty();
+        }
+        return changes;
+    }
+    delete(pattern) {
+        const changes = this.index.delete(pattern);
+        if (changes > 0) {
+            this.markRdf3xDirty();
+        }
+        return changes;
+    }
+    scan(query) {
+        return this.index.scan(query.pattern, query.options);
+    }
+    query(query) {
+        this.refreshRdf3xPrimary();
+        return this.queryEngine.query(query);
+    }
+    indexTextSource(source, text, chunks) {
+        this.requireTextIndex().indexText(source, text, chunks);
+    }
+    deleteTextSource(source) {
+        return this.requireTextIndex().deleteSource(source);
+    }
+    searchText(options) {
+        return this.requireTextIndex().search(typeof options === 'string' ? { query: options } : options);
+    }
+    indexVectorSource(source, chunks) {
+        this.requireVectorIndex().indexVector(source, chunks);
+    }
+    deleteVectorSource(source) {
+        return this.requireVectorIndex().deleteSource(source);
+    }
+    searchVector(options) {
+        return this.requireVectorIndex().search(options);
+    }
+    async shadowScan(query) {
+        if (!this.shadowComparator) {
+            throw new Error('SolidRdfEngine shadowScan requires a compatibility QuintStore');
+        }
+        return this.shadowComparator.compareScan(query);
+    }
+    shadowRdf3xScan(query) {
+        const rdf3xIndex = this.requireRdf3xIndex();
+        const rdf3xPattern = toRdf3xTriplePattern(query.pattern);
+        const rebuild = rdf3xIndex.rebuildFromCurrentQuads();
+        const primary = this.index.scan(query.pattern, query.options);
+        const rdf3x = rdf3xIndex.scan(rdf3xPattern, query.options);
+        const diff = (0, RdfShadowComparator_1.diffQuads)(rdf3x.quads, primary.quads);
+        const orderedMatch = canonicalQuadKeys(primary.quads).join('\n') === canonicalQuadKeys(rdf3x.quads).join('\n');
+        return {
+            matched: diff.missingFromPrimary.length === 0 && diff.extraInPrimary.length === 0,
+            orderedMatch,
+            primary: primary.quads,
+            rdf3x: rdf3x.quads,
+            diff: {
+                missingFromRdf3x: diff.extraInPrimary,
+                extraInRdf3x: diff.missingFromPrimary,
+            },
+            primaryMetrics: primary.metrics,
+            rdf3xMetrics: rdf3x.metrics,
+            rebuild,
+        };
+    }
+    shadowRdf3xJoin(patterns, options) {
+        const rdf3xIndex = this.requireRdf3xIndex();
+        const rebuild = rdf3xIndex.rebuildFromCurrentQuads();
+        const primary = this.index.joinPatterns(patterns, options);
+        const rdf3x = rdf3xIndex.joinPatterns(patterns, options);
+        const primaryKeys = primary.bindings.map(canonicalBindingKey);
+        const rdf3xKeys = rdf3x.bindings.map(canonicalBindingKey);
+        const diff = diffBindingKeys(rdf3xKeys, primaryKeys);
+        return {
+            matched: diff.missingFromRdf3x.length === 0 && diff.extraInRdf3x.length === 0,
+            orderedMatch: primaryKeys.join('\n') === rdf3xKeys.join('\n'),
+            primary: primary.bindings,
+            rdf3x: rdf3x.bindings,
+            diff,
+            primaryMetrics: primary.metrics,
+            rdf3xMetrics: rdf3x.metrics,
+            rebuild,
+        };
+    }
+    supportsPrimary(query) {
+        try {
+            this.index.scan(query.pattern, { ...query.options, limit: 0 });
+            return true;
+        }
+        catch {
+            return false;
+        }
+    }
+    requireTextIndex() {
+        if (!this.textIndex) {
+            throw new Error('SolidRdfEngine text index is not configured');
+        }
+        return this.textIndex;
+    }
+    requireVectorIndex() {
+        if (!this.vectorIndex) {
+            throw new Error('SolidRdfEngine vector index is not configured');
+        }
+        return this.vectorIndex;
+    }
+    requireRdf3xIndex() {
+        if (!this.rdf3xIndex) {
+            throw new Error('SolidRdfEngine RDF-3X shadow index is not configured');
+        }
+        return this.rdf3xIndex;
+    }
+    markRdf3xDirty() {
+        if (this.rdf3xIndex) {
+            this.rdf3xDirty = true;
+        }
+    }
+    refreshRdf3xPrimary() {
+        if (!this.rdf3xPrimary || !this.rdf3xDirty) {
+            return;
+        }
+        this.requireRdf3xIndex().rebuildFromCurrentQuads();
+        this.rdf3xDirty = false;
+    }
+}
+exports.SolidRdfEngine = SolidRdfEngine;
+function isRdfTextIndexOptions(input) {
+    return input !== undefined && !(input instanceof RdfTextIndex_1.RdfTextIndex) && typeof input.path === 'string';
+}
+function isRdfVectorIndexOptions(input) {
+    return input !== undefined && !(input instanceof RdfVectorIndex_1.RdfVectorIndex) && typeof input.path === 'string';
+}
+function isRdf3xTripleIndexOptions(input) {
+    return input !== undefined && !(input instanceof Rdf3xTripleIndex_1.Rdf3xTripleIndex) && typeof input.path === 'string';
+}
+function canonicalQuadKeys(quads) {
+    return quads.map((quad) => [
+        (0, n3_1.termToId)(quad.graph),
+        (0, n3_1.termToId)(quad.subject),
+        (0, n3_1.termToId)(quad.predicate),
+        (0, n3_1.termToId)(quad.object),
+    ].join('\u001f'));
+}
+function canonicalBindingKey(binding) {
+    return Object.keys(binding)
+        .sort()
+        .map((key) => `${key}=${(0, n3_1.termToId)(binding[key])}`)
+        .join('\u001f');
+}
+function diffBindingKeys(rdf3xKeys, primaryKeys) {
+    const rdf3xSet = new Set(rdf3xKeys);
+    const primarySet = new Set(primaryKeys);
+    return {
+        missingFromRdf3x: Array.from(primarySet).filter((key) => !rdf3xSet.has(key)).sort(),
+        extraInRdf3x: Array.from(rdf3xSet).filter((key) => !primarySet.has(key)).sort(),
+    };
+}
+function toRdf3xTriplePattern(pattern) {
+    const result = {};
+    for (const key of ['graph', 'subject', 'predicate', 'object']) {
+        const value = pattern[key];
+        if (!value) {
+            continue;
+        }
+        if (!(0, types_1.isTerm)(value)) {
+            if (key === 'graph' && isStartsWithOperator(value)) {
+                result.graph = { $startsWith: value.$startsWith };
+                continue;
+            }
+            if (key === 'object' && isNumericObjectRangeOperator(value)) {
+                result.object = value;
+                continue;
+            }
+            throw new Error(`SolidRdfEngine RDF-3X shadow scan only supports exact ${key} terms${key === 'graph' ? ' or graph $startsWith' : ''}`);
+        }
+        result[key] = value;
+    }
+    return result;
+}
+function isStartsWithOperator(value) {
+    return value !== null
+        && typeof value === 'object'
+        && '$startsWith' in value
+        && typeof value.$startsWith === 'string';
+}
+function isNumericObjectRangeOperator(value) {
+    return value !== null
+        && typeof value === 'object'
+        && !('termType' in value)
+        && ['$gt', '$gte', '$lt', '$lte'].some((operator) => operator in value);
+}
+//# sourceMappingURL=SolidRdfEngine.js.map