@undefineds.co/xpod 0.3.18 → 0.3.23

package/dist/storage/accessors/SolidRdfDataAccessor.js

@@ -0,0 +1,277 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SolidRdfDataAccessor = void 0;
+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 RdfSparqlAdapter_1 = require("../rdf/RdfSparqlAdapter");
+const { defaultGraph, namedNode, quad } = n3_1.DataFactory;
+/**
+ * Structured RDF DataAccessor backed directly by SolidRdfEngine.
+ *
+ * This is the server-owned Pod storage path. It writes resource graphs and
+ * metadata graphs into the term-id RDF index without routing simple CSS LDP
+ * operations through Comunica.
+ */
+class SolidRdfDataAccessor {
+    constructor(rdfEngine, identifierStrategy) {
+        this.rdfEngine = rdfEngine;
+        this.identifierStrategy = identifierStrategy;
+        this.logger = (0, global_logger_factory_1.getLoggerFor)(this);
+        this.adapter = new RdfSparqlAdapter_1.RdfSparqlAdapter();
+        this.initialized = false;
+        this.initializing = null;
+    }
+    async initialize() {
+        if (this.initialized) {
+            return;
+        }
+        this.initializing ??= Promise.resolve()
+            .then(() => {
+            this.rdfEngine.open();
+            this.rdfEngine.refreshDerivedIndexes();
+            this.initialized = true;
+        })
+            .finally(() => {
+            this.initializing = null;
+        });
+        await this.initializing;
+    }
+    async finalize() {
+        if (this.initializing) {
+            await this.initializing.catch(() => { });
+        }
+        if (this.initialized) {
+            await this.rdfEngine.close();
+            this.initialized = false;
+        }
+    }
+    async canHandle(representation) {
+        if (representation.binary || representation.metadata.contentType !== community_server_1.INTERNAL_QUADS) {
+            throw new community_server_1.UnsupportedMediaTypeHttpError('Only Quad data is supported.');
+        }
+    }
+    async getData(identifier) {
+        await this.initialize();
+        const quads = this.scanGraph(namedNode(identifier.path));
+        return (0, community_server_1.guardStream)(node_stream_1.Readable.from(quads));
+    }
+    async getMetadata(identifier) {
+        await this.initialize();
+        const name = namedNode(identifier.path);
+        const quads = this.scanGraph(this.getMetadataNode(name));
+        if (quads.length === 0) {
+            throw new community_server_1.NotFoundHttpError();
+        }
+        const metadata = new community_server_1.RepresentationMetadata(identifier).addQuads(quads);
+        if (!(0, community_server_1.isContainerIdentifier)(identifier) && !metadata.contentType) {
+            metadata.contentType = community_server_1.INTERNAL_QUADS;
+        }
+        return metadata;
+    }
+    async *getChildren(identifier) {
+        await this.initialize();
+        const name = namedNode(identifier.path);
+        for (const entry of this.rdfEngine.scan({
+            pattern: {
+                graph: name,
+                subject: name,
+                predicate: community_server_1.LDP.terms.contains,
+            },
+            options: { order: ['object'] },
+        }).quads) {
+            if (entry.object.termType === 'NamedNode') {
+                yield new community_server_1.RepresentationMetadata(entry.object);
+            }
+        }
+    }
+    async writeContainer(identifier, metadata) {
+        await this.initialize();
+        (0, community_server_1.addResourceMetadata)(metadata, true);
+        (0, community_server_1.updateModifiedDate)(metadata);
+        const { name, parent } = this.getRelatedNames(identifier);
+        this.replaceMetadata(name, metadata, parent);
+    }
+    async writeDocument(identifier, data, metadata) {
+        await this.initialize();
+        if (this.isMetadataIdentifier(identifier)) {
+            throw new community_server_1.ConflictHttpError('Not allowed to create NamedNodes with the metadata extension.');
+        }
+        const triples = await (0, arrayify_stream_1.default)(data);
+        const def = defaultGraph();
+        if (triples.some((triple) => !def.equals(triple.graph))) {
+            throw new community_server_1.NotImplementedHttpError('Only triples in the default graph are supported.');
+        }
+        (0, community_server_1.addResourceMetadata)(metadata, false);
+        (0, community_server_1.updateModifiedDate)(metadata);
+        metadata.removeAll(community_server_1.CONTENT_TYPE_TERM);
+        const { name, parent } = this.getRelatedNames(identifier);
+        this.rdfEngine.delete({ graph: name });
+        this.replaceMetadata(name, metadata, parent);
+        this.putGraphQuads(name, triples);
+    }
+    async writeRdfSourceDocument(identifier, quads, metadata, source) {
+        await this.initialize();
+        if (this.isMetadataIdentifier(identifier)) {
+            throw new community_server_1.ConflictHttpError('Not allowed to create NamedNodes with the metadata extension.');
+        }
+        const def = defaultGraph();
+        if (quads.some((value) => !def.equals(value.graph))) {
+            throw new community_server_1.NotImplementedHttpError('Only triples in the default graph are supported.');
+        }
+        metadata.removeAll(community_server_1.CONTENT_TYPE_TERM);
+        const { name, parent } = this.getRelatedNames(identifier);
+        this.replaceMetadata(name, metadata, parent);
+        this.rdfEngine.replaceSource(quads.map((value) => quad(value.subject, value.predicate, value.object, name)), source);
+    }
+    async deleteRdfSourceDocument(identifier) {
+        await this.initialize();
+        const { name, parent } = this.getRelatedNames(identifier);
+        this.rdfEngine.deleteSource(identifier.path);
+        this.rdfEngine.delete({ graph: this.getMetadataNode(name) });
+        if (parent) {
+            this.rdfEngine.delete({
+                graph: parent,
+                subject: parent,
+                predicate: community_server_1.LDP.terms.contains,
+                object: name,
+            });
+        }
+    }
+    async writeMetadata(identifier, metadata) {
+        await this.initialize();
+        const { name, parent } = this.getRelatedNames(identifier);
+        const metaName = this.getMetadataNode(name);
+        this.rdfEngine.delete({ graph: metaName });
+        const inserts = this.toGraphQuads(metaName, metadata.quads());
+        if (parent) {
+            inserts.push(quad(parent, community_server_1.LDP.terms.contains, name, parent));
+        }
+        this.rdfEngine.put(inserts);
+    }
+    async deleteResource(identifier) {
+        await this.initialize();
+        const { name, parent } = this.getRelatedNames(identifier);
+        this.rdfEngine.delete({ graph: name });
+        this.rdfEngine.delete({ graph: this.getMetadataNode(name) });
+        if (parent) {
+            this.rdfEngine.delete({
+                graph: parent,
+                subject: parent,
+                predicate: community_server_1.LDP.terms.contains,
+                object: name,
+            });
+        }
+    }
+    async getDataByGraphPrefix(prefix) {
+        await this.initialize();
+        return this.rdfEngine.scan({
+            pattern: {
+                graph: { $startsWith: prefix },
+            },
+        }).quads;
+    }
+    async executeSparqlUpdate(query, baseIri) {
+        await this.initialize();
+        try {
+            const delta = this.adapter.compileUpdateDelta(query, baseIri ?? '', {
+                defaultGraph: baseIri,
+            });
+            for (const operation of delta.operations) {
+                this.applyUpdateOperation(operation);
+            }
+        }
+        catch (error) {
+            if (error instanceof RdfSparqlAdapter_1.DisabledSparqlFeatureError) {
+                throw error;
+            }
+            if (error instanceof RdfSparqlAdapter_1.UnsupportedSparqlQueryError) {
+                this.logger.warn(`SolidRdfDataAccessor cannot execute SPARQL UPDATE without compatibility fallback: ${error.message}`);
+                throw error;
+            }
+            this.logger.error(`SPARQL update failed: ${(0, community_server_1.createErrorMessage)(error)}`);
+            throw error;
+        }
+    }
+    applyUpdateOperation(operation) {
+        if (operation.type === 'insert') {
+            this.rdfEngine.put(operation.quads);
+            return;
+        }
+        if (operation.type === 'delete') {
+            for (const value of operation.quads) {
+                this.rdfEngine.delete({
+                    graph: value.graph,
+                    subject: value.subject,
+                    predicate: value.predicate,
+                    object: value.object,
+                });
+            }
+            return;
+        }
+        if (operation.type === 'deleteWhere') {
+            this.deleteMaterialized(operation.template, this.rdfEngine.query(operation.query).bindings);
+            return;
+        }
+        if (operation.type === 'insertWhere') {
+            this.rdfEngine.put(this.adapter.materializeDeleteWhere(operation.inserts, this.rdfEngine.query(operation.query).bindings));
+            return;
+        }
+        const rows = this.rdfEngine.query(operation.query).bindings;
+        this.deleteMaterialized(operation.deletes, rows);
+        this.rdfEngine.put(this.adapter.materializeDeleteWhere(operation.inserts, rows));
+    }
+    deleteMaterialized(template, rows) {
+        for (const value of this.adapter.materializeDeleteWhere(template, rows)) {
+            this.rdfEngine.delete({
+                graph: value.graph,
+                subject: value.subject,
+                predicate: value.predicate,
+                object: value.object,
+            });
+        }
+    }
+    getRelatedNames(identifier) {
+        const name = namedNode(identifier.path);
+        if (this.identifierStrategy.isRootContainer(identifier)) {
+            return { name };
+        }
+        const parentIdentifier = this.identifierStrategy.getParentContainer(identifier);
+        const parent = namedNode(parentIdentifier.path);
+        return { name, parent };
+    }
+    getMetadataNode(name) {
+        return namedNode(`meta:${name.value}`);
+    }
+    isMetadataIdentifier(identifier) {
+        return identifier.path.startsWith('meta:');
+    }
+    replaceMetadata(name, metadata, parent) {
+        const metaName = this.getMetadataNode(name);
+        this.rdfEngine.delete({ graph: metaName });
+        const inserts = this.toGraphQuads(metaName, metadata.quads());
+        if (parent) {
+            inserts.push(quad(parent, community_server_1.LDP.terms.contains, name, parent));
+        }
+        this.rdfEngine.put(inserts);
+    }
+    putGraphQuads(graph, triples) {
+        this.rdfEngine.put(this.toGraphQuads(graph, triples));
+    }
+    scanGraph(graph) {
+        return this.rdfEngine.scan({
+            pattern: { graph },
+            options: { order: ['subject', 'predicate', 'object'] },
+        }).quads.map((value) => quad(value.subject, value.predicate, value.object));
+    }
+    toGraphQuads(graph, quads) {
+        return quads.map((value) => quad(value.subject, value.predicate, value.object, graph));
+    }
+}
+exports.SolidRdfDataAccessor = SolidRdfDataAccessor;
+//# sourceMappingURL=SolidRdfDataAccessor.js.map

package/dist/storage/accessors/SolidRdfDataAccessor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"SolidRdfDataAccessor.js","sourceRoot":"","sources":["../../../src/storage/accessors/SolidRdfDataAccessor.ts"],"names":[],"mappings":"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","sourcesContent":["import { Readable } from 'node:stream';\nimport arrayifyStream from 'arrayify-stream';\nimport { getLoggerFor } from 'global-logger-factory';\nimport { DataFactory } from 'n3';\nimport type { NamedNode, Quad } from '@rdfjs/types';\nimport {\n  addResourceMetadata,\n  CONTENT_TYPE_TERM,\n  ConflictHttpError,\n  createErrorMessage,\n  DataAccessor,\n  guardStream,\n  IdentifierStrategy,\n  INTERNAL_QUADS,\n  isContainerIdentifier,\n  LDP,\n  NotFoundHttpError,\n  NotImplementedHttpError,\n  RepresentationMetadata,\n  UnsupportedMediaTypeHttpError,\n  updateModifiedDate,\n  type Guarded,\n  type Representation,\n  type ResourceIdentifier,\n} from '@solid/community-server';\nimport type { RdfSparqlUpdateDeltaOperation, RdfSparqlUpdateTemplate } from '../rdf/RdfSparqlAdapter';\nimport {\n  DisabledSparqlFeatureError,\n  RdfSparqlAdapter,\n  UnsupportedSparqlQueryError,\n} from '../rdf/RdfSparqlAdapter';\nimport { SolidRdfEngine } from '../rdf/SolidRdfEngine';\nimport type { RdfBindingRow, RdfSourceInput } from '../rdf/types';\nimport type { Quint } from '../quint/types';\n\nconst { defaultGraph, namedNode, quad } = DataFactory;\n\n/**\n * Structured RDF DataAccessor backed directly by SolidRdfEngine.\n *\n * This is the server-owned Pod storage path. It writes resource graphs and\n * metadata graphs into the term-id RDF index without routing simple CSS LDP\n * operations through Comunica.\n */\nexport class SolidRdfDataAccessor implements DataAccessor {\n  protected readonly logger = getLoggerFor(this);\n  private readonly adapter = new RdfSparqlAdapter();\n  private initialized = false;\n  private initializing: Promise<void> | null = null;\n\n  public constructor(\n    private readonly rdfEngine: SolidRdfEngine,\n    private readonly identifierStrategy: IdentifierStrategy,\n  ) {}\n\n  public async initialize(): Promise<void> {\n    if (this.initialized) {\n      return;\n    }\n\n    this.initializing ??= Promise.resolve()\n      .then(() => {\n        this.rdfEngine.open();\n        this.rdfEngine.refreshDerivedIndexes();\n        this.initialized = true;\n      })\n      .finally(() => {\n        this.initializing = null;\n      });\n\n    await this.initializing;\n  }\n\n  public async finalize(): Promise<void> {\n    if (this.initializing) {\n      await this.initializing.catch(() => {});\n    }\n    if (this.initialized) {\n      await this.rdfEngine.close();\n      this.initialized = false;\n    }\n  }\n\n  public async canHandle(representation: Representation): Promise<void> {\n    if (representation.binary || representation.metadata.contentType !== INTERNAL_QUADS) {\n      throw new UnsupportedMediaTypeHttpError('Only Quad data is supported.');\n    }\n  }\n\n  public async getData(identifier: ResourceIdentifier): Promise<Guarded<Readable>> {\n    await this.initialize();\n    const quads = this.scanGraph(namedNode(identifier.path));\n    return guardStream(Readable.from(quads));\n  }\n\n  public async getMetadata(identifier: ResourceIdentifier): Promise<RepresentationMetadata> {\n    await this.initialize();\n    const name = namedNode(identifier.path);\n    const quads = this.scanGraph(this.getMetadataNode(name));\n\n    if (quads.length === 0) {\n      throw new NotFoundHttpError();\n    }\n\n    const metadata = new RepresentationMetadata(identifier).addQuads(quads);\n    if (!isContainerIdentifier(identifier) && !metadata.contentType) {\n      metadata.contentType = INTERNAL_QUADS;\n    }\n    return metadata;\n  }\n\n  public async* getChildren(identifier: ResourceIdentifier): AsyncIterableIterator<RepresentationMetadata> {\n    await this.initialize();\n    const name = namedNode(identifier.path);\n    for (const entry of this.rdfEngine.scan({\n      pattern: {\n        graph: name,\n        subject: name,\n        predicate: LDP.terms.contains,\n      },\n      options: { order: ['object'] },\n    }).quads) {\n      if (entry.object.termType === 'NamedNode') {\n        yield new RepresentationMetadata(entry.object as NamedNode);\n      }\n    }\n  }\n\n  public async writeContainer(identifier: ResourceIdentifier, metadata: RepresentationMetadata): Promise<void> {\n    await this.initialize();\n    addResourceMetadata(metadata, true);\n    updateModifiedDate(metadata);\n    const { name, parent } = this.getRelatedNames(identifier);\n    this.replaceMetadata(name, metadata, parent);\n  }\n\n  public async writeDocument(\n    identifier: ResourceIdentifier,\n    data: Guarded<Readable>,\n    metadata: RepresentationMetadata,\n  ): Promise<void> {\n    await this.initialize();\n    if (this.isMetadataIdentifier(identifier)) {\n      throw new ConflictHttpError('Not allowed to create NamedNodes with the metadata extension.');\n    }\n\n    const triples = await arrayifyStream<Quad>(data);\n    const def = defaultGraph();\n    if (triples.some((triple): boolean => !def.equals(triple.graph))) {\n      throw new NotImplementedHttpError('Only triples in the default graph are supported.');\n    }\n\n    addResourceMetadata(metadata, false);\n    updateModifiedDate(metadata);\n    metadata.removeAll(CONTENT_TYPE_TERM);\n    const { name, parent } = this.getRelatedNames(identifier);\n    this.rdfEngine.delete({ graph: name });\n    this.replaceMetadata(name, metadata, parent);\n    this.putGraphQuads(name, triples);\n  }\n\n  public async writeRdfSourceDocument(\n    identifier: ResourceIdentifier,\n    quads: Quad[],\n    metadata: RepresentationMetadata,\n    source: RdfSourceInput,\n  ): Promise<void> {\n    await this.initialize();\n    if (this.isMetadataIdentifier(identifier)) {\n      throw new ConflictHttpError('Not allowed to create NamedNodes with the metadata extension.');\n    }\n\n    const def = defaultGraph();\n    if (quads.some((value): boolean => !def.equals(value.graph))) {\n      throw new NotImplementedHttpError('Only triples in the default graph are supported.');\n    }\n\n    metadata.removeAll(CONTENT_TYPE_TERM);\n    const { name, parent } = this.getRelatedNames(identifier);\n    this.replaceMetadata(name, metadata, parent);\n    this.rdfEngine.replaceSource(\n      quads.map((value) => quad(value.subject, value.predicate, value.object, name) as Quad),\n      source,\n    );\n  }\n\n  public async deleteRdfSourceDocument(identifier: ResourceIdentifier): Promise<void> {\n    await this.initialize();\n    const { name, parent } = this.getRelatedNames(identifier);\n    this.rdfEngine.deleteSource(identifier.path);\n    this.rdfEngine.delete({ graph: this.getMetadataNode(name) });\n    if (parent) {\n      this.rdfEngine.delete({\n        graph: parent,\n        subject: parent,\n        predicate: LDP.terms.contains,\n        object: name,\n      });\n    }\n  }\n\n  public async writeMetadata(identifier: ResourceIdentifier, metadata: RepresentationMetadata): Promise<void> {\n    await this.initialize();\n    const { name, parent } = this.getRelatedNames(identifier);\n    const metaName = this.getMetadataNode(name);\n    this.rdfEngine.delete({ graph: metaName });\n    const inserts = this.toGraphQuads(metaName, metadata.quads());\n    if (parent) {\n      inserts.push(quad(parent, LDP.terms.contains, name, parent) as Quad);\n    }\n    this.rdfEngine.put(inserts);\n  }\n\n  public async deleteResource(identifier: ResourceIdentifier): Promise<void> {\n    await this.initialize();\n    const { name, parent } = this.getRelatedNames(identifier);\n    this.rdfEngine.delete({ graph: name });\n    this.rdfEngine.delete({ graph: this.getMetadataNode(name) });\n    if (parent) {\n      this.rdfEngine.delete({\n        graph: parent,\n        subject: parent,\n        predicate: LDP.terms.contains,\n        object: name,\n      });\n    }\n  }\n\n  public async getDataByGraphPrefix(prefix: string): Promise<Quint[]> {\n    await this.initialize();\n    return this.rdfEngine.scan({\n      pattern: {\n        graph: { $startsWith: prefix },\n      },\n    }).quads as Quint[];\n  }\n\n  public async executeSparqlUpdate(query: string, baseIri?: string): Promise<void> {\n    await this.initialize();\n    try {\n      const delta = this.adapter.compileUpdateDelta(query, baseIri ?? '', {\n        defaultGraph: baseIri,\n      });\n      for (const operation of delta.operations) {\n        this.applyUpdateOperation(operation);\n      }\n    } catch (error: unknown) {\n      if (error instanceof DisabledSparqlFeatureError) {\n        throw error;\n      }\n      if (error instanceof UnsupportedSparqlQueryError) {\n        this.logger.warn(`SolidRdfDataAccessor cannot execute SPARQL UPDATE without compatibility fallback: ${error.message}`);\n        throw error;\n      }\n      this.logger.error(`SPARQL update failed: ${createErrorMessage(error)}`);\n      throw error;\n    }\n  }\n\n  private applyUpdateOperation(operation: RdfSparqlUpdateDeltaOperation): void {\n    if (operation.type === 'insert') {\n      this.rdfEngine.put(operation.quads);\n      return;\n    }\n    if (operation.type === 'delete') {\n      for (const value of operation.quads) {\n        this.rdfEngine.delete({\n          graph: value.graph,\n          subject: value.subject,\n          predicate: value.predicate,\n          object: value.object,\n        });\n      }\n      return;\n    }\n\n    if (operation.type === 'deleteWhere') {\n      this.deleteMaterialized(operation.template, this.rdfEngine.query(operation.query).bindings);\n      return;\n    }\n\n    if (operation.type === 'insertWhere') {\n      this.rdfEngine.put(this.adapter.materializeDeleteWhere(\n        operation.inserts,\n        this.rdfEngine.query(operation.query).bindings,\n      ));\n      return;\n    }\n\n    const rows = this.rdfEngine.query(operation.query).bindings;\n    this.deleteMaterialized(operation.deletes, rows);\n    this.rdfEngine.put(this.adapter.materializeDeleteWhere(operation.inserts, rows));\n  }\n\n  private deleteMaterialized(template: RdfSparqlUpdateTemplate[], rows: RdfBindingRow[]): void {\n    for (const value of this.adapter.materializeDeleteWhere(template, rows)) {\n      this.rdfEngine.delete({\n        graph: value.graph,\n        subject: value.subject,\n        predicate: value.predicate,\n        object: value.object,\n      });\n    }\n  }\n\n  private getRelatedNames(identifier: ResourceIdentifier): { name: NamedNode; parent?: NamedNode } {\n    const name = namedNode(identifier.path);\n\n    if (this.identifierStrategy.isRootContainer(identifier)) {\n      return { name };\n    }\n\n    const parentIdentifier = this.identifierStrategy.getParentContainer(identifier);\n    const parent = namedNode(parentIdentifier.path);\n    return { name, parent };\n  }\n\n  protected getMetadataNode(name: NamedNode): NamedNode {\n    return namedNode(`meta:${name.value}`);\n  }\n\n  private isMetadataIdentifier(identifier: ResourceIdentifier): boolean {\n    return identifier.path.startsWith('meta:');\n  }\n\n  private replaceMetadata(name: NamedNode, metadata: RepresentationMetadata, parent?: NamedNode): void {\n    const metaName = this.getMetadataNode(name);\n    this.rdfEngine.delete({ graph: metaName });\n    const inserts = this.toGraphQuads(metaName, metadata.quads());\n    if (parent) {\n      inserts.push(quad(parent, LDP.terms.contains, name, parent) as Quad);\n    }\n    this.rdfEngine.put(inserts);\n  }\n\n  private putGraphQuads(graph: NamedNode, triples: Quad[]): void {\n    this.rdfEngine.put(this.toGraphQuads(graph, triples));\n  }\n\n  private scanGraph(graph: NamedNode): Quad[] {\n    return this.rdfEngine.scan({\n      pattern: { graph },\n      options: { order: ['subject', 'predicate', 'object'] },\n    }).quads.map((value) => quad(value.subject, value.predicate, value.object) as Quad);\n  }\n\n  private toGraphQuads(graph: NamedNode, quads: Quad[]): Quad[] {\n    return quads.map((value) => quad(value.subject, value.predicate, value.object, graph) as Quad);\n  }\n}\n"]}

package/dist/storage/accessors/SolidRdfDataAccessor.jsonld

@@ -0,0 +1,161 @@
+{
+  "@context": [
+    "https://linkedsoftwaredependencies.org/bundles/npm/@undefineds.co/xpod/^0.0.0/components/context.jsonld",
+    "https://linkedsoftwaredependencies.org/bundles/npm/@solid/community-server/^8.0.0/components/context.jsonld"
+  ],
+  "@id": "npmd:@undefineds.co/xpod",
+  "components": [
+    {
+      "@id": "undefineds:dist/storage/accessors/SolidRdfDataAccessor.jsonld#SolidRdfDataAccessor",
+      "@type": "Class",
+      "requireElement": "SolidRdfDataAccessor",
+      "extends": [
+        "css:dist/storage/accessors/DataAccessor.jsonld#DataAccessor"
+      ],
+      "comment": "Structured RDF DataAccessor backed directly by SolidRdfEngine.  This is the server-owned Pod storage path. It writes resource graphs and metadata graphs into the term-id RDF index without routing simple CSS LDP operations through Comunica.",
+      "parameters": [
+        {
+          "@id": "undefineds:dist/storage/accessors/SolidRdfDataAccessor.jsonld#SolidRdfDataAccessor_rdfEngine",
+          "range": "undefineds:dist/storage/rdf/SolidRdfEngine.jsonld#SolidRdfEngine"
+        },
+        {
+          "@id": "undefineds:dist/storage/accessors/SolidRdfDataAccessor.jsonld#SolidRdfDataAccessor_identifierStrategy",
+          "range": "css:dist/util/identifiers/IdentifierStrategy.jsonld#IdentifierStrategy"
+        }
+      ],
+      "memberFields": [
+        {
+          "@id": "undefineds:dist/storage/accessors/SolidRdfDataAccessor.jsonld#SolidRdfDataAccessor__member_rdfEngine",
+          "memberFieldName": "rdfEngine"
+        },
+        {
+          "@id": "undefineds:dist/storage/accessors/SolidRdfDataAccessor.jsonld#SolidRdfDataAccessor__member_identifierStrategy",
+          "memberFieldName": "identifierStrategy"
+        },
+        {
+          "@id": "undefineds:dist/storage/accessors/SolidRdfDataAccessor.jsonld#SolidRdfDataAccessor__member_logger",
+          "memberFieldName": "logger",
+          "range": {
+            "@type": "ParameterRangeWildcard"
+          }
+        },
+        {
+          "@id": "undefineds:dist/storage/accessors/SolidRdfDataAccessor.jsonld#SolidRdfDataAccessor__member_adapter",
+          "memberFieldName": "adapter"
+        },
+        {
+          "@id": "undefineds:dist/storage/accessors/SolidRdfDataAccessor.jsonld#SolidRdfDataAccessor__member_initialized",
+          "memberFieldName": "initialized"
+        },
+        {
+          "@id": "undefineds:dist/storage/accessors/SolidRdfDataAccessor.jsonld#SolidRdfDataAccessor__member_initializing",
+          "memberFieldName": "initializing"
+        },
+        {
+          "@id": "undefineds:dist/storage/accessors/SolidRdfDataAccessor.jsonld#SolidRdfDataAccessor__member_constructor",
+          "memberFieldName": "constructor"
+        },
+        {
+          "@id": "undefineds:dist/storage/accessors/SolidRdfDataAccessor.jsonld#SolidRdfDataAccessor__member_initialize",
+          "memberFieldName": "initialize"
+        },
+        {
+          "@id": "undefineds:dist/storage/accessors/SolidRdfDataAccessor.jsonld#SolidRdfDataAccessor__member_finalize",
+          "memberFieldName": "finalize"
+        },
+        {
+          "@id": "undefineds:dist/storage/accessors/SolidRdfDataAccessor.jsonld#SolidRdfDataAccessor__member_canHandle",
+          "memberFieldName": "canHandle"
+        },
+        {
+          "@id": "undefineds:dist/storage/accessors/SolidRdfDataAccessor.jsonld#SolidRdfDataAccessor__member_getData",
+          "memberFieldName": "getData"
+        },
+        {
+          "@id": "undefineds:dist/storage/accessors/SolidRdfDataAccessor.jsonld#SolidRdfDataAccessor__member_getMetadata",
+          "memberFieldName": "getMetadata"
+        },
+        {
+          "@id": "undefineds:dist/storage/accessors/SolidRdfDataAccessor.jsonld#SolidRdfDataAccessor__member_getChildren",
+          "memberFieldName": "getChildren"
+        },
+        {
+          "@id": "undefineds:dist/storage/accessors/SolidRdfDataAccessor.jsonld#SolidRdfDataAccessor__member_writeContainer",
+          "memberFieldName": "writeContainer"
+        },
+        {
+          "@id": "undefineds:dist/storage/accessors/SolidRdfDataAccessor.jsonld#SolidRdfDataAccessor__member_writeDocument",
+          "memberFieldName": "writeDocument"
+        },
+        {
+          "@id": "undefineds:dist/storage/accessors/SolidRdfDataAccessor.jsonld#SolidRdfDataAccessor__member_writeRdfSourceDocument",
+          "memberFieldName": "writeRdfSourceDocument"
+        },
+        {
+          "@id": "undefineds:dist/storage/accessors/SolidRdfDataAccessor.jsonld#SolidRdfDataAccessor__member_deleteRdfSourceDocument",
+          "memberFieldName": "deleteRdfSourceDocument"
+        },
+        {
+          "@id": "undefineds:dist/storage/accessors/SolidRdfDataAccessor.jsonld#SolidRdfDataAccessor__member_writeMetadata",
+          "memberFieldName": "writeMetadata"
+        },
+        {
+          "@id": "undefineds:dist/storage/accessors/SolidRdfDataAccessor.jsonld#SolidRdfDataAccessor__member_deleteResource",
+          "memberFieldName": "deleteResource"
+        },
+        {
+          "@id": "undefineds:dist/storage/accessors/SolidRdfDataAccessor.jsonld#SolidRdfDataAccessor__member_getDataByGraphPrefix",
+          "memberFieldName": "getDataByGraphPrefix"
+        },
+        {
+          "@id": "undefineds:dist/storage/accessors/SolidRdfDataAccessor.jsonld#SolidRdfDataAccessor__member_executeSparqlUpdate",
+          "memberFieldName": "executeSparqlUpdate"
+        },
+        {
+          "@id": "undefineds:dist/storage/accessors/SolidRdfDataAccessor.jsonld#SolidRdfDataAccessor__member_applyUpdateOperation",
+          "memberFieldName": "applyUpdateOperation"
+        },
+        {
+          "@id": "undefineds:dist/storage/accessors/SolidRdfDataAccessor.jsonld#SolidRdfDataAccessor__member_deleteMaterialized",
+          "memberFieldName": "deleteMaterialized"
+        },
+        {
+          "@id": "undefineds:dist/storage/accessors/SolidRdfDataAccessor.jsonld#SolidRdfDataAccessor__member_getRelatedNames",
+          "memberFieldName": "getRelatedNames"
+        },
+        {
+          "@id": "undefineds:dist/storage/accessors/SolidRdfDataAccessor.jsonld#SolidRdfDataAccessor__member_getMetadataNode",
+          "memberFieldName": "getMetadataNode"
+        },
+        {
+          "@id": "undefineds:dist/storage/accessors/SolidRdfDataAccessor.jsonld#SolidRdfDataAccessor__member_isMetadataIdentifier",
+          "memberFieldName": "isMetadataIdentifier"
+        },
+        {
+          "@id": "undefineds:dist/storage/accessors/SolidRdfDataAccessor.jsonld#SolidRdfDataAccessor__member_replaceMetadata",
+          "memberFieldName": "replaceMetadata"
+        },
+        {
+          "@id": "undefineds:dist/storage/accessors/SolidRdfDataAccessor.jsonld#SolidRdfDataAccessor__member_putGraphQuads",
+          "memberFieldName": "putGraphQuads"
+        },
+        {
+          "@id": "undefineds:dist/storage/accessors/SolidRdfDataAccessor.jsonld#SolidRdfDataAccessor__member_scanGraph",
+          "memberFieldName": "scanGraph"
+        },
+        {
+          "@id": "undefineds:dist/storage/accessors/SolidRdfDataAccessor.jsonld#SolidRdfDataAccessor__member_toGraphQuads",
+          "memberFieldName": "toGraphQuads"
+        }
+      ],
+      "constructorArguments": [
+        {
+          "@id": "undefineds:dist/storage/accessors/SolidRdfDataAccessor.jsonld#SolidRdfDataAccessor_rdfEngine"
+        },
+        {
+          "@id": "undefineds:dist/storage/accessors/SolidRdfDataAccessor.jsonld#SolidRdfDataAccessor_identifierStrategy"
+        }
+      ]
+    }
+  ]
+}

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

@@ -0,0 +1,122 @@
+import type { Rdf3xCardinalityEstimate, Rdf3xCountResult, Rdf3xIndexStats, Rdf3xJoinOptions, Rdf3xJoinScanResult, Rdf3xPatternKey, Rdf3xRebuildResult, Rdf3xIndexOptions, Rdf3xTriplePattern, Rdf3xTripleScanOptions, Rdf3xTripleScanResult, RdfIndexSpaceObject, RdfQuadJoinCountOptions, RdfQuadJoinGroupAggregateOptions, RdfQuadJoinPattern, RdfQuadTupleConstraintSource } from './types';
+export declare class Rdf3xIndex {
+    private readonly options;
+    private readonly sqliteRuntime;
+    private db;
+    private dictionary;
+    constructor(options: Rdf3xIndexOptions);
+    open(): void;
+    close(): void;
+    clear(): void;
+    rebuildFromCurrentQuads(): Rdf3xRebuildResult;
+    factsDataVersion(): number;
+    isSyncedWithCurrentQuads(): boolean;
+    scan(pattern: Rdf3xTriplePattern, options?: Rdf3xTripleScanOptions): Rdf3xTripleScanResult;
+    scanWithTupleConstraints(pattern: Rdf3xTriplePattern, tupleValues: RdfQuadTupleConstraintSource, options?: Rdf3xTripleScanOptions): Rdf3xTripleScanResult;
+    countDistinct(pattern: Rdf3xTriplePattern, distinctKey: Rdf3xPatternKey): Rdf3xCountResult;
+    private scanInternal;
+    private compileDistinctCountSql;
+    private compileMembershipDistinctCountSql;
+    joinPatterns(patterns: RdfQuadJoinPattern[], options?: Rdf3xJoinOptions): Rdf3xJoinScanResult;
+    countJoinPatterns(patterns: RdfQuadJoinPattern[], options: RdfQuadJoinCountOptions): Rdf3xJoinScanResult;
+    aggregateJoinPatterns(patterns: RdfQuadJoinPattern[], options: RdfQuadJoinCountOptions): Rdf3xJoinScanResult;
+    groupCountJoinPatterns(patterns: RdfQuadJoinPattern[], options: RdfQuadJoinGroupAggregateOptions): Rdf3xJoinScanResult;
+    groupAggregateJoinPatterns(patterns: RdfQuadJoinPattern[], options: RdfQuadJoinGroupAggregateOptions): Rdf3xJoinScanResult;
+    private aggregateJoinPatternsInternal;
+    private groupAggregateJoinPatternsInternal;
+    estimateCardinality(pattern: Rdf3xTriplePattern): Rdf3xCardinalityEstimate;
+    stats(): Rdf3xIndexStats;
+    collectSpaceObjects(): RdfIndexSpaceObject[];
+    private initializeSchema;
+    private dropMaterializedFactCopies;
+    private dropLegacyRowidTables;
+    private clearRdf3xTables;
+    private prepareSchemaVersion;
+    private ensureMetadataTable;
+    private dropRdf3xSchema;
+    private currentFactsDataVersion;
+    private setFactsDataVersion;
+    private setMetadataValue;
+    private rebuildPairProjection;
+    private rebuildTermProjection;
+    private rebuildGraphProjection;
+    private compileScanSql;
+    private compileMembershipScanSql;
+    private compileJoinPatterns;
+    private joinSourceSql;
+    private membershipJoinSourceSql;
+    private canUseIndexOnlyJoin;
+    private buildMergeJoinPlan;
+    private joinSourceColumnRef;
+    private buildTupleConstraintJoin;
+    private buildJoinValuesJoins;
+    private populateJoinValuesTable;
+    private joinValueColumnName;
+    private populateTupleConstraintTable;
+    private termIdForTupleConstraint;
+    private tupleColumnName;
+    private tupleColumnRef;
+    private buildJoinOrderClause;
+    private buildJoinAggregateColumn;
+    private buildGroupAggregateHavingClause;
+    private havingSqlOperator;
+    private buildGroupAggregateOrderScope;
+    private buildOrderClause;
+    private chooseJoinStart;
+    private orderJoinSources;
+    private chooseNextJoinSource;
+    private compareJoinConnectivity;
+    private boundVariableCount;
+    private compareJoinFanout;
+    private estimateJoinFanout;
+    private boundPatternKeys;
+    private sourceVariables;
+    private compareJoinSources;
+    private estimateResolvedCardinality;
+    private resolveJoinPattern;
+    private joinMetrics;
+    private joinRowsToBindings;
+    private buildPagination;
+    private estimateExactTriple;
+    private estimatePairProjection;
+    private estimateTermProjection;
+    private estimateMembershipCardinality;
+    private estimateResolvedMembershipCardinality;
+    private buildMembershipWhere;
+    private pairProjectionFor;
+    private appendResolvedIdSetConditions;
+    private appendResolvedExcludedIdSetConditions;
+    private resolvePattern;
+    private resolveTermInIds;
+    private resolveTermNotInIds;
+    private resolveOperatorPattern;
+    private resolveTermMetadataFilter;
+    private resolveTextSearchFilter;
+    private resolveDatatypeFilter;
+    private countDistinctResolvedMembershipTuple;
+    private estimateObjectRangeCardinality;
+    private appendObjectRangeCondition;
+    private appendTermFilterJoinsAndConditions;
+    private appendTermFilterCondition;
+    private appendTextSearchCondition;
+    private appendTermTypeCondition;
+    private appendLanguageCondition;
+    private appendDatatypeCondition;
+    private resolveObjectRange;
+    private numericValueForPattern;
+    private lexicalValueForPattern;
+    private choosePermutation;
+    private permutation;
+    private rowsToQuads;
+    private permutationSource;
+    private factSource;
+    private uniqueTripleCount;
+    private rowCount;
+    private collectPageCount;
+    private estimateDatabaseBytes;
+    private estimateSpaceObjectsFromSchema;
+    private estimatePageSize;
+    private metrics;
+    private requireDb;
+    private requireDictionary;
+}