@undefineds.co/xpod 0.3.75 → 0.4.0-rc.140

package/dist/storage/rdf/ShadowRdfQuintStore.js

@@ -1,216 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.ShadowRdfQuintStore = void 0;
-const n3_1 = require("n3");
-const RdfQuadIndex_1 = require("./RdfQuadIndex");
-const RdfShadowComparator_1 = require("./RdfShadowComparator");
-/**
- * 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.
- */
-class ShadowRdfQuintStore {
-    constructor(options) {
-        this.opened = false;
-        this.opening = null;
-        this.autoBackfilled = false;
-        this.compatibilityStore = options.compatibilityStore;
-        this.autoBackfill = options.autoBackfill;
-        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;
-        }
-        this.comparator = new RdfShadowComparator_1.RdfShadowComparator(this.index, this.compatibilityStore);
-        if (options.autoOpen) {
-            void this.open();
-        }
-    }
-    async open() {
-        if (this.opened) {
-            return;
-        }
-        this.opening ??= this.openOnce().finally(() => {
-            this.opening = null;
-        });
-        await this.opening;
-    }
-    async openOnce() {
-        await this.compatibilityStore.open();
-        this.index.open();
-        await this.runAutoBackfill();
-        this.opened = true;
-    }
-    async close() {
-        if (this.opening) {
-            await this.opening.catch(() => { });
-        }
-        await this.compatibilityStore.close();
-        if (this.ownsIndex) {
-            this.index.close();
-        }
-        this.opened = false;
-        this.autoBackfilled = false;
-    }
-    async get(pattern, options) {
-        return this.compatibilityStore.get(pattern, options);
-    }
-    match(subject, predicate, object, graph) {
-        return this.compatibilityStore.match(subject, predicate, object, graph);
-    }
-    async getByGraphPrefix(prefix, options) {
-        return this.compatibilityStore.getByGraphPrefix(prefix, options);
-    }
-    async count(pattern) {
-        return this.compatibilityStore.count(pattern);
-    }
-    async getCompound(compound, options) {
-        const getCompound = this.compatibilityStore.getCompound?.bind(this.compatibilityStore);
-        if (!getCompound) {
-            throw new Error('Compatibility QuintStore does not support compound queries');
-        }
-        return getCompound(compound, options);
-    }
-    async getAttributes(subjects, predicates, graph) {
-        const getAttributes = this.compatibilityStore.getAttributes?.bind(this.compatibilityStore);
-        if (!getAttributes) {
-            throw new Error('Compatibility QuintStore does not support attribute queries');
-        }
-        return getAttributes(subjects, predicates, graph);
-    }
-    async put(quint) {
-        await this.compatibilityStore.put(quint);
-        this.index.put(quint);
-    }
-    async multiPut(quints) {
-        await this.compatibilityStore.multiPut(quints);
-        this.index.multiPut(quints);
-    }
-    async replaceSource(quints, source) {
-        await this.compatibilityStore.del({ graph: n3_1.DataFactory.namedNode(source.source) });
-        if (quints.length > 0) {
-            await this.compatibilityStore.multiPut(quints);
-        }
-        this.index.replaceSource(quints, source);
-    }
-    async deleteSource(source) {
-        const deleted = await this.compatibilityStore.del({ graph: n3_1.DataFactory.namedNode(source) });
-        this.index.deleteSource(source);
-        return deleted;
-    }
-    async updateEmbedding(pattern, embedding) {
-        return this.compatibilityStore.updateEmbedding(pattern, embedding);
-    }
-    async del(pattern) {
-        const deleted = await this.compatibilityStore.del(pattern);
-        this.index.delete(pattern);
-        return deleted;
-    }
-    async multiDel(quints) {
-        await this.compatibilityStore.multiDel(quints);
-        for (const quint of quints) {
-            this.index.delete({
-                graph: quint.graph,
-                subject: quint.subject,
-                predicate: quint.predicate,
-                object: quint.object,
-            });
-        }
-    }
-    async stats() {
-        return this.compatibilityStore.stats();
-    }
-    async clear() {
-        await this.compatibilityStore.clear();
-        this.index.clear();
-    }
-    /**
-     * Rebuild the term-id shadow index from the existing TEXT QuintStore.
-     *
-     * This is intentionally explicit: reads still use the compatibility store,
-     * and callers decide when it is acceptable to clear/rebuild the shadow index.
-     */
-    async backfillShadowIndex(options = {}) {
-        await this.open();
-        return this.copyCompatibilityRows(options);
-    }
-    async copyCompatibilityRows(options) {
-        const start = Date.now();
-        const batchSize = Math.max(1, Math.floor(options.batchSize ?? 1000));
-        if (options.clear) {
-            this.index.clear();
-        }
-        let scannedRows = 0;
-        let indexedRows = 0;
-        let batchCount = 0;
-        while (true) {
-            const batch = await this.compatibilityStore.get({}, {
-                order: ['graph', 'subject', 'predicate', 'object'],
-                limit: batchSize,
-                offset: scannedRows,
-            });
-            if (batch.length === 0) {
-                break;
-            }
-            scannedRows += batch.length;
-            batchCount += 1;
-            this.index.multiPut(batch);
-            indexedRows += batch.length;
-            if (batch.length < batchSize) {
-                break;
-            }
-        }
-        return {
-            scannedRows,
-            indexedRows,
-            batchCount,
-            durationMs: Date.now() - start,
-        };
-    }
-    async shadowGet(pattern, options) {
-        return this.comparator.compareScan({ pattern, options });
-    }
-    async runAutoBackfill() {
-        // A primary term-id index can contain newer writes than the legacy store.
-        // Only a pristine index may be recovered automatically. dataVersion also
-        // distinguishes a deliberately emptied index from one never populated.
-        if (this.autoBackfilled || !this.shouldAutoBackfill()) {
-            return;
-        }
-        const migration = 'legacy-quints';
-        const state = this.index.migrationState(migration);
-        if (state === 'complete' || (state !== 'pending' && this.index.dataVersion() > 0))
-            return;
-        // Persist pending before the first batch. A failed process can safely retry
-        // the idempotent inserts without treating a partial import as authoritative.
-        this.index.setMigrationState(migration, 'pending');
-        await this.copyCompatibilityRows({ ...this.autoBackfillOptions(), clear: false });
-        this.index.setMigrationState(migration, 'complete');
-        this.autoBackfilled = true;
-    }
-    shouldAutoBackfill() {
-        if (this.autoBackfill === true) {
-            return true;
-        }
-        if (typeof this.autoBackfill === 'object') {
-            return this.autoBackfill.enabled !== false;
-        }
-        return false;
-    }
-    autoBackfillOptions() {
-        if (typeof this.autoBackfill !== 'object') {
-            return {};
-        }
-        return {
-            clear: this.autoBackfill.clear,
-            batchSize: this.autoBackfill.batchSize,
-        };
-    }
-}
-exports.ShadowRdfQuintStore = ShadowRdfQuintStore;
-//# sourceMappingURL=ShadowRdfQuintStore.js.map

package/dist/storage/rdf/ShadowRdfQuintStore.jsonld

@@ -1,312 +0,0 @@
-{
-  "@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_copyCompatibilityRows",
-          "memberFieldName": "copyCompatibilityRows"
-        },
-        {
-          "@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/SolidRdfSparqlEngine.d.ts

@@ -1,107 +0,0 @@
-import type { AsyncIterator } from 'asynciterator';
-import type { Quad, Term, Variable } from '@rdfjs/types';
-import type { SparqlEngine, SparqlVoidOptions } from '../sparql/SubgraphQueryEngine';
-import type { ShadowRdfQuintStore } from './ShadowRdfQuintStore';
-import type { RdfEngineLike } from './types';
-import { type RdfAccessScope } from './RdfAccessScope';
-export interface SolidRdfSparqlEngineOptions {
-    rdfEngine: RdfEngineLike;
-    fallback?: SparqlEngine;
-    shadowStore?: ShadowRdfQuintStore;
-    enablePrimary?: boolean;
-    onFallback?: (reason: SolidRdfSparqlFallback) => void;
-    autoMaterializeProductViews?: boolean;
-}
-export interface SolidRdfSparqlFallback {
-    operation: 'queryBindings' | 'queryBoolean' | 'queryQuads' | 'queryVoid' | 'constructGraph' | 'listGraphs';
-    reason: string;
-}
-export type SolidRdfSparqlOperation = SolidRdfSparqlFallback['operation'];
-export interface SolidRdfSparqlOperationCount {
-    operation: SolidRdfSparqlOperation;
-    primaryCount: number;
-    fallbackCount: number;
-    totalCount: number;
-    fallbackRate: number;
-    primaryDurationMs: number;
-    fallbackDurationMs: number;
-}
-export interface SolidRdfSparqlPrimaryMetric {
-    operation: SolidRdfSparqlOperation;
-    durationMs: number;
-    scannedRows: number;
-    returnedRows: number;
-    plan: string[];
-    indexChoices: string[];
-    nativeProfile?: unknown;
-}
-export interface SolidRdfSparqlFallbackMetric extends SolidRdfSparqlFallback {
-    durationMs: number;
-}
-export interface SolidRdfSparqlMetricsSnapshot {
-    primaryCount: number;
-    fallbackCount: number;
-    totalCount: number;
-    fallbackRate: number;
-    operationCounts: SolidRdfSparqlOperationCount[];
-    lastPrimary?: SolidRdfSparqlPrimaryMetric;
-    lastFallback?: SolidRdfSparqlFallbackMetric;
-}
-export interface SolidRdfSparqlFallbackBudget {
-    maxFallbackRate?: number;
-    maxFallbackCount?: number;
-    operations?: SolidRdfSparqlOperation[];
-}
-type BindingsStream = AsyncIterator<RdfBindings> & {
-    metadata?: () => Promise<{
-        variables: import('@rdfjs/types').Variable[];
-    }>;
-};
-export declare class SolidRdfSparqlEngine implements SparqlEngine {
-    private readonly adapter;
-    private readonly rdfEngine;
-    private readonly fallback?;
-    private readonly shadowStore?;
-    private readonly enablePrimary;
-    private readonly onFallback?;
-    private readonly autoMaterializeProductViews;
-    private readonly operationCounts;
-    private lastPrimary?;
-    private lastFallback?;
-    constructor(rdfEngine: RdfEngineLike, fallback?: SparqlEngine, shadowStore?: ShadowRdfQuintStore, enablePrimary?: boolean, onFallback?: (reason: SolidRdfSparqlFallback) => void, autoMaterializeProductViews?: boolean);
-    queryBindings(query: string, basePath: string, accessScope?: RdfAccessScope): Promise<BindingsStream>;
-    queryBoolean(query: string, basePath: string, accessScope?: RdfAccessScope): Promise<boolean>;
-    queryQuads(query: string, basePath: string, accessScope?: RdfAccessScope): Promise<AsyncIterator<Quad>>;
-    queryVoid(query: string, basePath: string, accessScope?: RdfAccessScope, options?: SparqlVoidOptions): Promise<void>;
-    constructGraph(graph: string, basePath: string, accessScope?: RdfAccessScope): Promise<AsyncIterator<Quad>>;
-    listGraphs(basePath: string, accessScope?: RdfAccessScope): Promise<Set<string>>;
-    close(): Promise<void>;
-    getMetrics(): SolidRdfSparqlMetricsSnapshot;
-    assertFallbackBudget(budget?: SolidRdfSparqlFallbackBudget): void;
-    resetMetrics(): void;
-    private bindingsStream;
-    private applyMaterializedQuerySelector;
-    private bindings;
-    private fallbackWith;
-    private ensureReady;
-    private executeSelectPrimary;
-    private assertUpdateQuadsAllowedByAccessScope;
-    private executeConstructPrimary;
-    private executeQuadsPrimary;
-    private executeDescribePrimary;
-    private executeNativeVoidPrimary;
-    private executeNativeSelectPrimary;
-    private executeNativeBooleanPrimary;
-    private executeNativeGraphPrimary;
-    private runNativeSparql;
-    private recordPrimary;
-    private recordFallback;
-    private countsFor;
-}
-declare class RdfBindings extends Map<Variable, Term> {
-    private readonly byName;
-    constructor(entries: [Variable, Term][]);
-    get(key: string | Variable): Term | undefined;
-    has(key: string | Variable): boolean;
-}
-export {};