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

package/dist/storage/accessors/MixDataAccessor.jsonld

@@ -5,12 +5,67 @@
   ],
   "@id": "npmd:@undefineds.co/xpod",
   "components": [
+    {
+      "@id": "undefineds:dist/storage/accessors/MixDataAccessor.jsonld#LocalRdfAuthorityJournal",
+      "@type": "AbstractClass",
+      "requireElement": "LocalRdfAuthorityJournal",
+      "parameters": [],
+      "memberFields": [
+        {
+          "@id": "undefineds:dist/storage/accessors/MixDataAccessor.jsonld#LocalRdfAuthorityJournal__member_recordLocalCommitted",
+          "memberFieldName": "recordLocalCommitted"
+        },
+        {
+          "@id": "undefineds:dist/storage/accessors/MixDataAccessor.jsonld#LocalRdfAuthorityJournal__member_markDone",
+          "memberFieldName": "markDone"
+        },
+        {
+          "@id": "undefineds:dist/storage/accessors/MixDataAccessor.jsonld#LocalRdfAuthorityJournal__member_markRetryableFailure",
+          "memberFieldName": "markRetryableFailure"
+        },
+        {
+          "@id": "undefineds:dist/storage/accessors/MixDataAccessor.jsonld#LocalRdfAuthorityJournal__member_markReconcileRequired",
+          "memberFieldName": "markReconcileRequired"
+        },
+        {
+          "@id": "undefineds:dist/storage/accessors/MixDataAccessor.jsonld#LocalRdfAuthorityJournal__member_markFailedPermanent",
+          "memberFieldName": "markFailedPermanent"
+        }
+      ],
+      "constructorArguments": []
+    },
+    {
+      "@id": "undefineds:dist/storage/accessors/MixDataAccessor.jsonld#LocalRdfIndexAccessor",
+      "@type": "AbstractClass",
+      "requireElement": "LocalRdfIndexAccessor",
+      "parameters": [],
+      "memberFields": [
+        {
+          "@id": "undefineds:dist/storage/accessors/MixDataAccessor.jsonld#LocalRdfIndexAccessor__member_syncLocalRdfDocument",
+          "memberFieldName": "syncLocalRdfDocument"
+        },
+        {
+          "@id": "undefineds:dist/storage/accessors/MixDataAccessor.jsonld#LocalRdfIndexAccessor__member_deleteLocalRdfIndex",
+          "memberFieldName": "deleteLocalRdfIndex"
+        },
+        {
+          "@id": "undefineds:dist/storage/accessors/MixDataAccessor.jsonld#LocalRdfIndexAccessor__member_moveLocalRdfIndex",
+          "memberFieldName": "moveLocalRdfIndex"
+        },
+        {
+          "@id": "undefineds:dist/storage/accessors/MixDataAccessor.jsonld#LocalRdfIndexAccessor__member_rewriteTerms",
+          "memberFieldName": "rewriteTerms"
+        }
+      ],
+      "constructorArguments": []
+    },
     {
       "@id": "undefineds:dist/storage/accessors/MixDataAccessor.jsonld#MixDataAccessor",
       "@type": "Class",
       "requireElement": "MixDataAccessor",
       "extends": [
-        "css:dist/storage/accessors/DataAccessor.jsonld#DataAccessor"
+        "css:dist/storage/accessors/DataAccessor.jsonld#DataAccessor",
+        "undefineds:dist/storage/accessors/MixDataAccessor.jsonld#LocalRdfIndexAccessor"
       ],
       "comment": "MixDataAccessor - Routes data to appropriate storage based on content type  - RDF data (internal/quads) -> structuredDataAccessor (Solid RDF engine by default) - RDF file mirrors (.ttl/.jsonld) -> rdfFileDataAccessor (local FileSystem) - Other data (binary, text, etc.) -> unstructuredDataAccessor (FileSystem, Minio, etc.)  This uses composition instead of inheritance, allowing any DataAccessor to be used as the RDF storage backend.",
       "parameters": [
@@ -62,6 +117,18 @@
             ]
           }
         },
+        {
+          "@id": "undefineds:dist/storage/accessors/MixDataAccessor.jsonld#MixDataAccessor_rdfSearchIntentSink",
+          "range": {
+            "@type": "ParameterRangeUnion",
+            "parameterRangeElements": [
+              "undefineds:dist/search/RdfSearchIntentSink.jsonld#RdfSearchReconciliationIntentSink",
+              {
+                "@type": "ParameterRangeUndefined"
+              }
+            ]
+          }
+        },
         {
           "@id": "undefineds:dist/storage/accessors/MixDataAccessor.jsonld#MixDataAccessor_structuredDataAccessor",
           "range": "css:dist/storage/accessors/DataAccessor.jsonld#DataAccessor"
@@ -103,10 +170,6 @@
             "@type": "ParameterRangeWildcard"
           }
         },
-        {
-          "@id": "undefineds:dist/storage/accessors/MixDataAccessor.jsonld#MixDataAccessor__member_rdfSparqlAdapter",
-          "memberFieldName": "rdfSparqlAdapter"
-        },
         {
           "@id": "undefineds:dist/storage/accessors/MixDataAccessor.jsonld#MixDataAccessor__member_structuredDataAccessor",
           "memberFieldName": "structuredDataAccessor"
@@ -139,6 +202,10 @@
           "@id": "undefineds:dist/storage/accessors/MixDataAccessor.jsonld#MixDataAccessor__member_textSearchIndexingEnabled",
           "memberFieldName": "textSearchIndexingEnabled"
         },
+        {
+          "@id": "undefineds:dist/storage/accessors/MixDataAccessor.jsonld#MixDataAccessor__member_rdfSearchIntentSink",
+          "memberFieldName": "rdfSearchIntentSink"
+        },
         {
           "@id": "undefineds:dist/storage/accessors/MixDataAccessor.jsonld#MixDataAccessor__member_constructor",
           "memberFieldName": "constructor"
@@ -188,92 +255,16 @@
           "memberFieldName": "executeSparqlUpdate"
         },
         {
-          "@id": "undefineds:dist/storage/accessors/MixDataAccessor.jsonld#MixDataAccessor__member_shouldApplyLocalRdfSparqlUpdate",
-          "memberFieldName": "shouldApplyLocalRdfSparqlUpdate"
-        },
-        {
-          "@id": "undefineds:dist/storage/accessors/MixDataAccessor.jsonld#MixDataAccessor__member_executeLocalRdfSparqlUpdate",
-          "memberFieldName": "executeLocalRdfSparqlUpdate"
-        },
-        {
-          "@id": "undefineds:dist/storage/accessors/MixDataAccessor.jsonld#MixDataAccessor__member_applyLocalRdfDelta",
-          "memberFieldName": "applyLocalRdfDelta"
+          "@id": "undefineds:dist/storage/accessors/MixDataAccessor.jsonld#MixDataAccessor__member_prepareNativeRdfSparqlUpdate",
+          "memberFieldName": "prepareNativeRdfSparqlUpdate"
         },
         {
-          "@id": "undefineds:dist/storage/accessors/MixDataAccessor.jsonld#MixDataAccessor__member_loadLocalRdfDeltaGraphs",
-          "memberFieldName": "loadLocalRdfDeltaGraphs"
+          "@id": "undefineds:dist/storage/accessors/MixDataAccessor.jsonld#MixDataAccessor__member_executePreparedRdfSparqlUpdate",
+          "memberFieldName": "executePreparedRdfSparqlUpdate"
         },
         {
-          "@id": "undefineds:dist/storage/accessors/MixDataAccessor.jsonld#MixDataAccessor__member_localRdfDeltaGraphIris",
-          "memberFieldName": "localRdfDeltaGraphIris"
-        },
-        {
-          "@id": "undefineds:dist/storage/accessors/MixDataAccessor.jsonld#MixDataAccessor__member_localRdfDeltaWriteGraphIris",
-          "memberFieldName": "localRdfDeltaWriteGraphIris"
-        },
-        {
-          "@id": "undefineds:dist/storage/accessors/MixDataAccessor.jsonld#MixDataAccessor__member_addWritableTemplateGraphIris",
-          "memberFieldName": "addWritableTemplateGraphIris"
-        },
-        {
-          "@id": "undefineds:dist/storage/accessors/MixDataAccessor.jsonld#MixDataAccessor__member_addWritableGraphVariableIris",
-          "memberFieldName": "addWritableGraphVariableIris"
-        },
-        {
-          "@id": "undefineds:dist/storage/accessors/MixDataAccessor.jsonld#MixDataAccessor__member_localRdfWriteGraphIri",
-          "memberFieldName": "localRdfWriteGraphIri"
-        },
-        {
-          "@id": "undefineds:dist/storage/accessors/MixDataAccessor.jsonld#MixDataAccessor__member_queryLocalUpdateBindings",
-          "memberFieldName": "queryLocalUpdateBindings"
-        },
-        {
-          "@id": "undefineds:dist/storage/accessors/MixDataAccessor.jsonld#MixDataAccessor__member_queryGraphTerms",
-          "memberFieldName": "queryGraphTerms"
-        },
-        {
-          "@id": "undefineds:dist/storage/accessors/MixDataAccessor.jsonld#MixDataAccessor__member_collectQueryGraphTerms",
-          "memberFieldName": "collectQueryGraphTerms"
-        },
-        {
-          "@id": "undefineds:dist/storage/accessors/MixDataAccessor.jsonld#MixDataAccessor__member_collectGraphVariableFilterTerms",
-          "memberFieldName": "collectGraphVariableFilterTerms"
-        },
-        {
-          "@id": "undefineds:dist/storage/accessors/MixDataAccessor.jsonld#MixDataAccessor__member_collectGraphVariableFilterIris",
-          "memberFieldName": "collectGraphVariableFilterIris"
-        },
-        {
-          "@id": "undefineds:dist/storage/accessors/MixDataAccessor.jsonld#MixDataAccessor__member_collectGraphVariableValueTerms",
-          "memberFieldName": "collectGraphVariableValueTerms"
-        },
-        {
-          "@id": "undefineds:dist/storage/accessors/MixDataAccessor.jsonld#MixDataAccessor__member_collectGraphVariableValueIris",
-          "memberFieldName": "collectGraphVariableValueIris"
-        },
-        {
-          "@id": "undefineds:dist/storage/accessors/MixDataAccessor.jsonld#MixDataAccessor__member_addGraphFilterValueIri",
-          "memberFieldName": "addGraphFilterValueIri"
-        },
-        {
-          "@id": "undefineds:dist/storage/accessors/MixDataAccessor.jsonld#MixDataAccessor__member_addNamedGraphIris",
-          "memberFieldName": "addNamedGraphIris"
-        },
-        {
-          "@id": "undefineds:dist/storage/accessors/MixDataAccessor.jsonld#MixDataAccessor__member_addWritableNamedGraphIri",
-          "memberFieldName": "addWritableNamedGraphIri"
-        },
-        {
-          "@id": "undefineds:dist/storage/accessors/MixDataAccessor.jsonld#MixDataAccessor__member_isLocalRdfAuthorityIdentifier",
-          "memberFieldName": "isLocalRdfAuthorityIdentifier"
-        },
-        {
-          "@id": "undefineds:dist/storage/accessors/MixDataAccessor.jsonld#MixDataAccessor__member_isQueryVariable",
-          "memberFieldName": "isQueryVariable"
-        },
-        {
-          "@id": "undefineds:dist/storage/accessors/MixDataAccessor.jsonld#MixDataAccessor__member_isRdfTerm",
-          "memberFieldName": "isRdfTerm"
+          "@id": "undefineds:dist/storage/accessors/MixDataAccessor.jsonld#MixDataAccessor__member_assertPreparedDeltaQuadGraph",
+          "memberFieldName": "assertPreparedDeltaQuadGraph"
         },
         {
           "@id": "undefineds:dist/storage/accessors/MixDataAccessor.jsonld#MixDataAccessor__member_readLocalRdfState",
@@ -299,6 +290,10 @@
           "@id": "undefineds:dist/storage/accessors/MixDataAccessor.jsonld#MixDataAccessor__member_markLocalRdfAuthorityJournalFailure",
           "memberFieldName": "markLocalRdfAuthorityJournalFailure"
         },
+        {
+          "@id": "undefineds:dist/storage/accessors/MixDataAccessor.jsonld#MixDataAccessor__member_markLocalRdfAuthorityRollbackComplete",
+          "memberFieldName": "markLocalRdfAuthorityRollbackComplete"
+        },
         {
           "@id": "undefineds:dist/storage/accessors/MixDataAccessor.jsonld#MixDataAccessor__member_localRdfPatchWorkspace",
           "memberFieldName": "localRdfPatchWorkspace"
@@ -371,14 +366,34 @@
           "@id": "undefineds:dist/storage/accessors/MixDataAccessor.jsonld#MixDataAccessor__member_syncTextSearchIndex",
           "memberFieldName": "syncTextSearchIndex"
         },
+        {
+          "@id": "undefineds:dist/storage/accessors/MixDataAccessor.jsonld#MixDataAccessor__member_syncUnstructuredTextSearchIndex",
+          "memberFieldName": "syncUnstructuredTextSearchIndex"
+        },
         {
           "@id": "undefineds:dist/storage/accessors/MixDataAccessor.jsonld#MixDataAccessor__member_deleteSearchIndexes",
           "memberFieldName": "deleteSearchIndexes"
         },
+        {
+          "@id": "undefineds:dist/storage/accessors/MixDataAccessor.jsonld#MixDataAccessor__member_moveSearchIndexes",
+          "memberFieldName": "moveSearchIndexes"
+        },
+        {
+          "@id": "undefineds:dist/storage/accessors/MixDataAccessor.jsonld#MixDataAccessor__member_moveVectorIndexIfPresent",
+          "memberFieldName": "moveVectorIndexIfPresent"
+        },
+        {
+          "@id": "undefineds:dist/storage/accessors/MixDataAccessor.jsonld#MixDataAccessor__member_deleteVectorIndexIfPresent",
+          "memberFieldName": "deleteVectorIndexIfPresent"
+        },
         {
           "@id": "undefineds:dist/storage/accessors/MixDataAccessor.jsonld#MixDataAccessor__member_rdfSourceInput",
           "memberFieldName": "rdfSourceInput"
         },
+        {
+          "@id": "undefineds:dist/storage/accessors/MixDataAccessor.jsonld#MixDataAccessor__member_rdfTextSourceInput",
+          "memberFieldName": "rdfTextSourceInput"
+        },
         {
           "@id": "undefineds:dist/storage/accessors/MixDataAccessor.jsonld#MixDataAccessor__member_relativePathFromWorkspace",
           "memberFieldName": "relativePathFromWorkspace"
@@ -391,6 +406,10 @@
           "@id": "undefineds:dist/storage/accessors/MixDataAccessor.jsonld#MixDataAccessor__member_isRdfDocumentIdentifier",
           "memberFieldName": "isRdfDocumentIdentifier"
         },
+        {
+          "@id": "undefineds:dist/storage/accessors/MixDataAccessor.jsonld#MixDataAccessor__member_isSearchableUnstructuredText",
+          "memberFieldName": "isSearchableUnstructuredText"
+        },
         {
           "@id": "undefineds:dist/storage/accessors/MixDataAccessor.jsonld#MixDataAccessor__member_isLocalMirroredRdf",
           "memberFieldName": "isLocalMirroredRdf"
@@ -476,6 +495,9 @@
         },
         {
           "@id": "undefineds:dist/storage/accessors/MixDataAccessor.jsonld#MixDataAccessor_localRdfAuthorityJournal"
+        },
+        {
+          "@id": "undefineds:dist/storage/accessors/MixDataAccessor.jsonld#MixDataAccessor_rdfSearchIntentSink"
         }
       ]
     }

package/dist/storage/accessors/SolidRdfDataAccessor.d.ts

@@ -1,9 +1,10 @@
 import { Readable } from 'node:stream';
 import type { NamedNode, Quad } from '@rdfjs/types';
 import { DataAccessor, IdentifierStrategy, RepresentationMetadata, type Guarded, type Representation, type ResourceIdentifier } from '@solid/community-server';
-import type { RdfEngineLike, RdfSourceInput, RdfTextChunkInput, RdfTextSourceInput, RdfVectorChunkInput, RdfVectorSourceInput } from '../rdf/types';
+import type { RdfEngineLike, RdfNativeSparqlAccessScope, RdfPreparedUpdateDelta, RdfSourceInput, RdfTextChunkInput, RdfTextSourceInput, RdfVectorChunkInput, RdfVectorSourceInput } from '../rdf/types';
 import type { Quint } from '../quint/types';
-import { ShadowRdfQuintStore } from '../rdf/ShadowRdfQuintStore';
+export declare const PREPARED_UPDATE_MEDIA_TYPE = "application/vnd.xpod.rdf-prepared-delta+json;version=1";
+export declare function parsePreparedUpdateDelta(body: string): RdfPreparedUpdateDelta;
 /**
  * Structured RDF DataAccessor backed directly by SolidRdfEngine.
  *
@@ -14,12 +15,11 @@ import { ShadowRdfQuintStore } from '../rdf/ShadowRdfQuintStore';
 export declare class SolidRdfDataAccessor implements DataAccessor {
     private readonly rdfEngine;
     private readonly identifierStrategy;
-    private readonly legacyIndex?;
     protected readonly logger: import("global-logger-factory").Logger<unknown>;
-    private readonly adapter;
+    private readonly sparqlAdapter;
     private initialized;
     private initializing;
-    constructor(rdfEngine: RdfEngineLike, identifierStrategy: IdentifierStrategy, legacyIndex?: ShadowRdfQuintStore | undefined);
+    constructor(rdfEngine: RdfEngineLike, identifierStrategy: IdentifierStrategy);
     initialize(): Promise<void>;
     finalize(): Promise<void>;
     canHandle(representation: Representation): Promise<void>;
@@ -31,16 +31,20 @@ export declare class SolidRdfDataAccessor implements DataAccessor {
     writeRdfSourceDocument(identifier: ResourceIdentifier, quads: Quad[], metadata: RepresentationMetadata, source: RdfSourceInput): Promise<void>;
     indexTextSource(source: RdfTextSourceInput, text: string, chunks?: RdfTextChunkInput[]): Promise<void>;
     deleteTextSource(source: string): Promise<number>;
+    moveTextSource(oldSource: string, next: RdfTextSourceInput): Promise<number>;
     moveRdfSourceDocument(oldSource: string, next: RdfSourceInput): Promise<number>;
     indexVectorSource(source: RdfVectorSourceInput, chunks: RdfVectorChunkInput[]): Promise<void>;
     deleteVectorSource(source: string): Promise<number>;
+    moveVectorSource(oldSource: string, next: RdfVectorSourceInput): Promise<number>;
     deleteRdfSourceDocument(identifier: ResourceIdentifier): Promise<void>;
     writeMetadata(identifier: ResourceIdentifier, metadata: RepresentationMetadata): Promise<void>;
     deleteResource(identifier: ResourceIdentifier): Promise<void>;
     getDataByGraphPrefix(prefix: string): Promise<Quint[]>;
-    executeSparqlUpdate(query: string, baseIri?: string): Promise<void>;
-    private applyUpdateOperation;
-    private deleteMaterialized;
+    prepareSparqlUpdate(query: string, baseIri: string, accessScope?: RdfNativeSparqlAccessScope, options?: {
+        timeoutMs?: number;
+        signal?: AbortSignal;
+    }): Promise<RdfPreparedUpdateDelta | undefined>;
+    private prepareEmbeddedSparqlUpdate;
     private getRelatedNames;
     protected getMetadataNode(name: NamedNode): NamedNode;
     private isMetadataIdentifier;

package/dist/storage/accessors/SolidRdfDataAccessor.js

@@ -3,14 +3,123 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.SolidRdfDataAccessor = void 0;
+exports.SolidRdfDataAccessor = exports.PREPARED_UPDATE_MEDIA_TYPE = void 0;
+exports.parsePreparedUpdateDelta = parsePreparedUpdateDelta;
 const node_stream_1 = require("node:stream");
 const arrayify_stream_1 = __importDefault(require("arrayify-stream"));
 const global_logger_factory_1 = require("global-logger-factory");
 const n3_1 = require("n3");
 const community_server_1 = require("@solid/community-server");
+const RdfAccessScope_1 = require("../rdf/RdfAccessScope");
+const RdfSparqlBoundary_1 = require("../rdf/RdfSparqlBoundary");
 const RdfSparqlAdapter_1 = require("../rdf/RdfSparqlAdapter");
 const { defaultGraph, namedNode, quad } = n3_1.DataFactory;
+exports.PREPARED_UPDATE_MEDIA_TYPE = 'application/vnd.xpod.rdf-prepared-delta+json;version=1';
+function preparedTerm(value) {
+    if (!value || typeof value !== 'object') {
+        throw new RdfSparqlBoundary_1.NativeSparqlExecutionError('Native prepared update contains an invalid RDF term');
+    }
+    const term = value;
+    if (typeof term.value !== 'string') {
+        throw new RdfSparqlBoundary_1.NativeSparqlExecutionError('Native prepared update contains an invalid RDF term value');
+    }
+    if (term.type === 'uri') {
+        return namedNode(term.value);
+    }
+    if (term.type === 'literal') {
+        if (typeof term['xml:lang'] === 'string' && term['xml:lang']) {
+            return n3_1.DataFactory.literal(term.value, term['xml:lang']);
+        }
+        if (typeof term.datatype === 'string' && term.datatype) {
+            return n3_1.DataFactory.literal(term.value, namedNode(term.datatype));
+        }
+        return n3_1.DataFactory.literal(term.value);
+    }
+    throw new RdfSparqlBoundary_1.UnsupportedSparqlQueryError('Native prepared update cannot stably replay blank-node terms');
+}
+function preparedQuad(value) {
+    if (!value || typeof value !== 'object') {
+        throw new RdfSparqlBoundary_1.NativeSparqlExecutionError('Native prepared update contains an invalid RDF quad');
+    }
+    const candidate = value;
+    const subject = preparedTerm(candidate.subject);
+    const predicate = preparedTerm(candidate.predicate);
+    const object = preparedTerm(candidate.object);
+    const graph = preparedTerm(candidate.graph);
+    if (subject.termType !== 'NamedNode' || predicate.termType !== 'NamedNode' || graph.termType !== 'NamedNode') {
+        throw new RdfSparqlBoundary_1.UnsupportedSparqlQueryError('Native prepared update v1 requires named subject, predicate, and graph terms');
+    }
+    return n3_1.DataFactory.quad(subject, predicate, object, graph);
+}
+function parsePreparedUpdateDelta(body) {
+    let parsed;
+    try {
+        parsed = JSON.parse(body);
+    }
+    catch {
+        throw new RdfSparqlBoundary_1.NativeSparqlExecutionError('Native prepared update returned invalid JSON');
+    }
+    if (!parsed || typeof parsed !== 'object') {
+        throw new RdfSparqlBoundary_1.NativeSparqlExecutionError('Native prepared update returned an invalid envelope');
+    }
+    const envelope = parsed;
+    if (envelope.version !== 1 || !Array.isArray(envelope.graphs)) {
+        throw new RdfSparqlBoundary_1.NativeSparqlExecutionError('Native prepared update requires version 1 graph deltas');
+    }
+    const graphs = envelope.graphs.map((value) => {
+        if (!value || typeof value !== 'object') {
+            throw new RdfSparqlBoundary_1.NativeSparqlExecutionError('Native prepared update contains an invalid graph delta');
+        }
+        const graph = value;
+        if (typeof graph.graphIri !== 'string' ||
+            typeof graph.sourceUri !== 'string' ||
+            !Array.isArray(graph.deletes) ||
+            !Array.isArray(graph.inserts)) {
+            throw new RdfSparqlBoundary_1.NativeSparqlExecutionError('Native prepared update contains incomplete graph provenance');
+        }
+        return {
+            graphIri: graph.graphIri,
+            sourceUri: graph.sourceUri,
+            deletes: graph.deletes.map(preparedQuad),
+            inserts: graph.inserts.map(preparedQuad),
+        };
+    });
+    return { version: 1, graphs };
+}
+function graphDeltaFor(deltas, quad) {
+    if (quad.graph.termType !== 'NamedNode') {
+        throw new RdfSparqlBoundary_1.UnsupportedSparqlQueryError('SPARQL UPDATE prepared delta requires a named writable graph', {
+            code: 'rdf.sparql.update_authority_required',
+            capability: 'sparql.update.authority',
+        });
+    }
+    const graphIri = quad.graph.value;
+    let delta = deltas.get(graphIri);
+    if (!delta) {
+        delta = {
+            graphIri,
+            sourceUri: graphIri,
+            deletes: [],
+            inserts: [],
+        };
+        deltas.set(graphIri, delta);
+    }
+    return delta;
+}
+function normalizeAdapterError(error) {
+    if (error instanceof RdfSparqlAdapter_1.DisabledSparqlFeatureError) {
+        return new RdfSparqlBoundary_1.UnsupportedSparqlQueryError(error.message);
+    }
+    if (error instanceof RdfSparqlAdapter_1.UnsupportedSparqlQueryError) {
+        return new RdfSparqlBoundary_1.UnsupportedSparqlQueryError(error.message, {
+            code: error.code,
+            capability: error.capability,
+            hint: error.hint,
+            correction: error.correction,
+        });
+    }
+    return error instanceof Error ? error : new Error(String(error));
+}
 /**
  * Structured RDF DataAccessor backed directly by SolidRdfEngine.
  *
@@ -19,12 +128,11 @@ const { defaultGraph, namedNode, quad } = n3_1.DataFactory;
  * operations through Comunica.
  */
 class SolidRdfDataAccessor {
-    constructor(rdfEngine, identifierStrategy, legacyIndex) {
+    constructor(rdfEngine, identifierStrategy) {
         this.rdfEngine = rdfEngine;
         this.identifierStrategy = identifierStrategy;
-        this.legacyIndex = legacyIndex;
         this.logger = (0, global_logger_factory_1.getLoggerFor)(this);
-        this.adapter = new RdfSparqlAdapter_1.RdfSparqlAdapter();
+        this.sparqlAdapter = new RdfSparqlAdapter_1.RdfSparqlAdapter();
         this.initialized = false;
         this.initializing = null;
     }
@@ -35,8 +143,6 @@ class SolidRdfDataAccessor {
         this.initializing ??= Promise.resolve()
             .then(async () => {
             await this.rdfEngine.open();
-            // Finish the one-time legacy migration before CSS checks ACR metadata.
-            await this.legacyIndex?.open();
             await this.rdfEngine.refreshDerivedIndexes();
             this.initialized = true;
         })
@@ -147,6 +253,13 @@ class SolidRdfDataAccessor {
         }
         return await this.rdfEngine.deleteTextSource(source);
     }
+    async moveTextSource(oldSource, next) {
+        await this.initialize();
+        if (!this.rdfEngine.moveTextSource) {
+            return 0;
+        }
+        return await this.rdfEngine.moveTextSource(oldSource, next);
+    }
     async moveRdfSourceDocument(oldSource, next) {
         await this.initialize();
         if (!this.rdfEngine.moveSource) {
@@ -168,6 +281,13 @@ class SolidRdfDataAccessor {
         }
         return await this.rdfEngine.deleteVectorSource(source);
     }
+    async moveVectorSource(oldSource, next) {
+        await this.initialize();
+        if (!this.rdfEngine.moveVectorSource) {
+            return 0;
+        }
+        return await this.rdfEngine.moveVectorSource(oldSource, next);
+    }
     async deleteRdfSourceDocument(identifier) {
         await this.initialize();
         const { name, parent } = this.getRelatedNames(identifier);
@@ -216,68 +336,78 @@ class SolidRdfDataAccessor {
         });
         return scan.quads;
     }
-    async executeSparqlUpdate(query, baseIri) {
+    async prepareSparqlUpdate(query, baseIri, accessScope, options) {
         await this.initialize();
+        if (!this.rdfEngine.sparqlQuery) {
+            return this.prepareEmbeddedSparqlUpdate(query, baseIri, accessScope);
+        }
+        // basePath is the writable boundary. Keep sourceUri unset so each explicit
+        // child graph resolves to its own RDF document source.
+        const result = await this.rdfEngine.sparqlQuery(query, {
+            basePath: baseIri,
+            operation: 'prepareUpdate',
+            acceptMediaType: exports.PREPARED_UPDATE_MEDIA_TYPE,
+            ...(accessScope ? { accessScope } : {}),
+            ...(options?.timeoutMs === undefined ? {} : { timeoutMs: options.timeoutMs }),
+            ...(options?.signal ? { signal: options.signal } : {}),
+        });
+        if (result.status === 'unsupported') {
+            throw new RdfSparqlBoundary_1.UnsupportedSparqlQueryError(result.error || 'Native QLever cannot prepare this SPARQL update for file-authority commit');
+        }
+        if (result.status !== 'ok') {
+            throw new RdfSparqlBoundary_1.NativeSparqlExecutionError(result.error || 'Native QLever failed to prepare the SPARQL update');
+        }
+        if (result.mediaType !== exports.PREPARED_UPDATE_MEDIA_TYPE) {
+            throw new RdfSparqlBoundary_1.NativeSparqlExecutionError(`Native prepared update returned unexpected media type ${result.mediaType}`);
+        }
+        return parsePreparedUpdateDelta(result.body);
+    }
+    async prepareEmbeddedSparqlUpdate(query, baseIri, accessScope) {
+        let delta;
         try {
-            const delta = this.adapter.compileUpdateDelta(query, baseIri ?? '', {
-                defaultGraph: baseIri,
+            delta = this.sparqlAdapter.compileUpdateDelta(query, baseIri, {
+                defaultGraph: baseIri.endsWith('/') ? undefined : baseIri,
             });
-            for (const operation of delta.operations) {
-                await this.applyUpdateOperation(operation);
-            }
         }
         catch (error) {
-            if (error instanceof RdfSparqlAdapter_1.DisabledSparqlFeatureError) {
-                throw error;
+            throw normalizeAdapterError(error);
+        }
+        const graphDeltas = new Map();
+        const appendDeletes = (quads) => {
+            for (const quad of quads) {
+                graphDeltaFor(graphDeltas, quad).deletes.push(quad);
             }
-            if (error instanceof RdfSparqlAdapter_1.UnsupportedSparqlQueryError) {
-                this.logger.warn(`SolidRdfDataAccessor cannot execute SPARQL UPDATE without compatibility fallback: ${error.message}`);
-                throw error;
+        };
+        const appendInserts = (quads) => {
+            for (const quad of quads) {
+                graphDeltaFor(graphDeltas, quad).inserts.push(quad);
             }
-            this.logger.error(`SPARQL update failed: ${(0, community_server_1.createErrorMessage)(error)}`);
-            throw error;
-        }
-    }
-    async applyUpdateOperation(operation) {
-        if (operation.type === 'insert') {
-            await this.rdfEngine.put(operation.quads);
-            return;
-        }
-        if (operation.type === 'delete') {
-            for (const value of operation.quads) {
-                await this.rdfEngine.delete({
-                    graph: value.graph,
-                    subject: value.subject,
-                    predicate: value.predicate,
-                    object: value.object,
-                });
+        };
+        for (const operation of delta.operations) {
+            if (operation.type === 'delete') {
+                appendDeletes(operation.quads);
+            }
+            else if (operation.type === 'insert') {
+                appendInserts(operation.quads);
+            }
+            else if (operation.type === 'insertDeleteWhere') {
+                const result = await this.rdfEngine.query((0, RdfAccessScope_1.applyRdfAccessScope)(operation.query, accessScope));
+                appendDeletes(this.sparqlAdapter.materializeDeleteWhere(operation.deletes, result.bindings));
+                appendInserts(this.sparqlAdapter.materializeDeleteWhere(operation.inserts, result.bindings));
+            }
+            else if (operation.type === 'insertWhere') {
+                const result = await this.rdfEngine.query((0, RdfAccessScope_1.applyRdfAccessScope)(operation.query, accessScope));
+                appendInserts(this.sparqlAdapter.materializeDeleteWhere(operation.inserts, result.bindings));
+            }
+            else {
+                const result = await this.rdfEngine.query((0, RdfAccessScope_1.applyRdfAccessScope)(operation.query, accessScope));
+                appendDeletes(this.sparqlAdapter.materializeDeleteWhere(operation.template, result.bindings));
             }
-            return;
-        }
-        if (operation.type === 'deleteWhere') {
-            const result = await this.rdfEngine.query(operation.query);
-            await this.deleteMaterialized(operation.template, result.bindings);
-            return;
-        }
-        if (operation.type === 'insertWhere') {
-            const result = await this.rdfEngine.query(operation.query);
-            await this.rdfEngine.put(this.adapter.materializeDeleteWhere(operation.inserts, result.bindings));
-            return;
-        }
-        const result = await this.rdfEngine.query(operation.query);
-        const rows = result.bindings;
-        await this.deleteMaterialized(operation.deletes, rows);
-        await this.rdfEngine.put(this.adapter.materializeDeleteWhere(operation.inserts, rows));
-    }
-    async deleteMaterialized(template, rows) {
-        for (const value of this.adapter.materializeDeleteWhere(template, rows)) {
-            await this.rdfEngine.delete({
-                graph: value.graph,
-                subject: value.subject,
-                predicate: value.predicate,
-                object: value.object,
-            });
         }
+        return {
+            version: 1,
+            graphs: [...graphDeltas.values()],
+        };
     }
     getRelatedNames(identifier) {
         const name = namedNode(identifier.path);