@undefineds.co/xpod 0.1.0-local.202602081751

package/dist/storage/sparql/SubgraphQueryEngine.js

@@ -0,0 +1,248 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SubgraphQueryEngine = exports.QuintstoreSparqlEngine = exports.QuadstoreSparqlEngine = void 0;
+const query_sparql_1 = require("@comunica/query-sparql");
+const quadstore_1 = require("quadstore");
+const n3_1 = require("n3");
+const global_logger_factory_1 = require("global-logger-factory");
+const index_1 = require("../../libs/backends/index");
+const OptimizedQuadstoreEngine_1 = require("./OptimizedQuadstoreEngine");
+const ComunicaQuintEngine_1 = require("./ComunicaQuintEngine");
+/**
+ * Quadstore-based SPARQL engine implementation
+ */
+class QuadstoreSparqlEngine {
+    constructor(endpoint) {
+        const backend = (0, index_1.getBackend)(endpoint, { tableName: 'quadstore' });
+        this.store = new quadstore_1.Quadstore({
+            backend: backend,
+            dataFactory: n3_1.DataFactory,
+        });
+        this.engine = new query_sparql_1.QueryEngine();
+        this.optimizedEngine = new OptimizedQuadstoreEngine_1.OptimizedQuadstoreEngine(this.store);
+        this.ready = this.store.open();
+    }
+    async queryBindings(query, basePath) {
+        await this.ready;
+        return this.engine.queryBindings(query, this.createContext(basePath));
+    }
+    async queryQuads(query, basePath) {
+        await this.ready;
+        return this.engine.queryQuads(query, this.createContext(basePath));
+    }
+    async queryBoolean(query, basePath) {
+        await this.ready;
+        return this.engine.queryBoolean(query, this.createContext(basePath));
+    }
+    async queryVoid(query, basePath) {
+        await this.ready;
+        await this.optimizedEngine.queryVoid(query, { baseIRI: basePath });
+    }
+    async constructGraph(graph, basePath) {
+        await this.ready;
+        const constructQuery = `CONSTRUCT { ?s ?p ?o } WHERE { GRAPH <${graph}> { ?s ?p ?o } }`;
+        return this.engine.queryQuads(constructQuery, this.createContext(basePath));
+    }
+    async listGraphs(basePath) {
+        await this.ready;
+        const graphs = new Set();
+        const query = `
+      SELECT DISTINCT ?g WHERE {
+        GRAPH ?g { ?s ?p ?o }
+        FILTER(STRSTARTS(STR(?g), "${basePath}"))
+      }
+    `;
+        const stream = await this.optimizedEngine.queryBindings(query);
+        try {
+            for await (const binding of stream) {
+                const value = binding.get('g');
+                if (value && typeof value === 'object' && 'termType' in value && value.termType === 'NamedNode') {
+                    graphs.add(value.value);
+                }
+            }
+        }
+        finally {
+            const close = stream.close;
+            if (typeof close === 'function') {
+                close();
+            }
+        }
+        return graphs;
+    }
+    async close() {
+        await this.store.close();
+    }
+    createContext(basePath) {
+        return {
+            unionDefaultGraph: true,
+            baseIRI: basePath,
+            sources: [
+                {
+                    type: 'rdfjsSource',
+                    value: {
+                        match: (subject, predicate, object, graph) => {
+                            const iterator = this.store.match(subject ?? undefined, predicate ?? undefined, object ?? undefined, graph ?? undefined);
+                            const filtered = iterator.filter((quad) => this.isInScope(basePath, quad.graph));
+                            return filtered;
+                        },
+                    },
+                },
+            ],
+        };
+    }
+    isInScope(basePath, graph) {
+        if (!graph || graph.termType !== 'NamedNode') {
+            return false;
+        }
+        let graphValue = graph.value;
+        if (graphValue.startsWith('meta:')) {
+            graphValue = graphValue.slice(5);
+        }
+        if (graphValue === basePath) {
+            return true;
+        }
+        const childPrefix = basePath.endsWith('/') ? basePath : `${basePath}/`;
+        const fragmentPrefix = `${basePath}#`;
+        if (graphValue.startsWith(childPrefix) || graphValue.startsWith(fragmentPrefix)) {
+            return true;
+        }
+        let pathOnly = basePath;
+        try {
+            const url = new URL(basePath);
+            pathOnly = url.pathname;
+        }
+        catch {
+            // basePath is already a path
+        }
+        if (pathOnly === basePath) {
+            return false;
+        }
+        if (graphValue.startsWith('meta:')) {
+            graphValue = graphValue.slice(5);
+        }
+        if (graphValue === pathOnly) {
+            return true;
+        }
+        const pathChildPrefix = pathOnly.endsWith('/') ? pathOnly : `${pathOnly}/`;
+        const pathFragmentPrefix = `${pathOnly}#`;
+        return graphValue.startsWith(pathChildPrefix) || graphValue.startsWith(pathFragmentPrefix);
+    }
+}
+exports.QuadstoreSparqlEngine = QuadstoreSparqlEngine;
+/**
+ * QuintStore-based SPARQL engine implementation
+ *
+ * Uses security filters to enforce access boundaries,
+ * which are pushed down to the storage layer.
+ */
+class QuintstoreSparqlEngine {
+    constructor(store) {
+        this.store = store;
+        this.engine = new ComunicaQuintEngine_1.ComunicaQuintEngine(this.store);
+        this.ready = this.store.open();
+    }
+    async queryBindings(query, basePath) {
+        await this.ready;
+        return this.engine.queryBindings(query, {
+            baseIRI: basePath,
+            filters: { graph: { $startsWith: basePath } },
+        });
+    }
+    async queryQuads(query, basePath) {
+        await this.ready;
+        return this.engine.queryQuads(query, {
+            baseIRI: basePath,
+            filters: { graph: { $startsWith: basePath } },
+        });
+    }
+    async queryBoolean(query, basePath) {
+        await this.ready;
+        return this.engine.queryBoolean(query, {
+            baseIRI: basePath,
+            filters: { graph: { $startsWith: basePath } },
+        });
+    }
+    async queryVoid(query, basePath) {
+        await this.ready;
+        // UPDATE queries have their own graph validation in SubgraphSparqlHttpHandler
+        return this.engine.queryVoid(query, {
+            baseIRI: basePath,
+            filters: { graph: { $startsWith: basePath } },
+        });
+    }
+    async constructGraph(graph, basePath) {
+        await this.ready;
+        // CONSTRUCT with explicit graph IRI - security filter still applies
+        const constructQuery = `CONSTRUCT { ?s ?p ?o } WHERE { GRAPH <${graph}> { ?s ?p ?o } }`;
+        return this.engine.queryQuads(constructQuery, {
+            baseIRI: basePath,
+            filters: { graph: { $startsWith: basePath } },
+        });
+    }
+    async listGraphs(basePath) {
+        await this.ready;
+        const graphs = new Set();
+        const query = `SELECT DISTINCT ?g WHERE { GRAPH ?g { ?s ?p ?o } }`;
+        const stream = await this.engine.queryBindings(query, {
+            baseIRI: basePath,
+            filters: { graph: { $startsWith: basePath } },
+        });
+        try {
+            for await (const binding of stream) {
+                const value = binding.get('g');
+                if (value && typeof value === 'object' && 'termType' in value && value.termType === 'NamedNode') {
+                    graphs.add(value.value);
+                }
+            }
+        }
+        finally {
+            const close = stream.close;
+            if (typeof close === 'function') {
+                close();
+            }
+        }
+        return graphs;
+    }
+    async close() {
+        await this.store.close();
+    }
+}
+exports.QuintstoreSparqlEngine = QuintstoreSparqlEngine;
+/**
+ * SubgraphQueryEngine - SPARQL engine with subgraph (tenant) isolation
+ *
+ * Wraps a SparqlEngine implementation for use in the system.
+ */
+class SubgraphQueryEngine {
+    /**
+     * Create a SubgraphQueryEngine
+     * @param engine - A SparqlEngine implementation (QuadstoreSparqlEngine or QuintstoreSparqlEngine)
+     */
+    constructor(engine) {
+        this.logger = (0, global_logger_factory_1.getLoggerFor)(this);
+        this.impl = engine;
+    }
+    async queryBindings(query, basePath) {
+        return this.impl.queryBindings(query, basePath);
+    }
+    async queryQuads(query, basePath) {
+        return this.impl.queryQuads(query, basePath);
+    }
+    async queryBoolean(query, basePath) {
+        return this.impl.queryBoolean(query, basePath);
+    }
+    async queryVoid(query, basePath) {
+        return this.impl.queryVoid(query, basePath);
+    }
+    async constructGraph(graph, basePath) {
+        return this.impl.constructGraph(graph, basePath);
+    }
+    async listGraphs(basePath) {
+        return this.impl.listGraphs(basePath);
+    }
+    async close() {
+        return this.impl.close();
+    }
+}
+exports.SubgraphQueryEngine = SubgraphQueryEngine;
+//# sourceMappingURL=SubgraphQueryEngine.js.map

package/dist/storage/sparql/SubgraphQueryEngine.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"SubgraphQueryEngine.js","sourceRoot":"","sources":["../../../src/storage/sparql/SubgraphQueryEngine.ts"],"names":[],"mappings":"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","sourcesContent":["import type { Quad, Quad_Graph, Quad_Object, Quad_Predicate, Quad_Subject } from '@rdfjs/types';\nimport type { Bindings } from '@comunica/types';\nimport type { AsyncIterator } from 'asynciterator';\nimport { QueryEngine } from '@comunica/query-sparql';\nimport { Quadstore } from 'quadstore';\nimport { DataFactory } from 'n3';\nimport { getLoggerFor } from 'global-logger-factory';\nimport { getBackend } from '../../libs/backends/index';\nimport { OptimizedQuadstoreEngine } from './OptimizedQuadstoreEngine';\nimport { ComunicaQuintEngine } from './ComunicaQuintEngine';\nimport type { QuintStore } from '../quint/types';\n\ninterface QueryContext {\n  sources: [{ type: 'rdfjsSource'; value: { match: (subject?: Quad_Subject | null, predicate?: Quad_Predicate | null, object?: Quad_Object | null, graph?: Quad_Graph | null) => AsyncIterator<Quad> }}];\n  unionDefaultGraph: boolean;\n  baseIRI: string;\n}\n\n/**\n * SPARQL Engine interface - common abstraction for SPARQL query engines\n */\nexport interface SparqlEngine {\n  queryBindings(query: string, basePath: string): Promise<any>;\n  queryQuads(query: string, basePath: string): Promise<any>;\n  queryBoolean(query: string, basePath: string): Promise<boolean>;\n  queryVoid(query: string, basePath: string): Promise<void>;\n  constructGraph(graph: string, basePath: string): Promise<AsyncIterator<Quad>>;\n  listGraphs(basePath: string): Promise<Set<string>>;\n  close(): Promise<void>;\n}\n\n/**\n * Quadstore-based SPARQL engine implementation\n */\nexport class QuadstoreSparqlEngine implements SparqlEngine {\n  private readonly store: Quadstore;\n  private readonly engine: QueryEngine;\n  private readonly optimizedEngine: OptimizedQuadstoreEngine;\n  private readonly ready: Promise<void>;\n\n  public constructor(endpoint: string) {\n    const backend = getBackend(endpoint, { tableName: 'quadstore' });\n    this.store = new Quadstore({\n      backend: backend as any,\n      dataFactory: DataFactory as any,\n    });\n    this.engine = new QueryEngine();\n    this.optimizedEngine = new OptimizedQuadstoreEngine(this.store);\n    this.ready = this.store.open();\n  }\n\n  public async queryBindings(query: string, basePath: string): Promise<any> {\n    await this.ready;\n    return this.engine.queryBindings(query, this.createContext(basePath) as unknown as any);\n  }\n\n  public async queryQuads(query: string, basePath: string): Promise<any> {\n    await this.ready;\n    return this.engine.queryQuads(query, this.createContext(basePath) as unknown as any);\n  }\n\n  public async queryBoolean(query: string, basePath: string): Promise<boolean> {\n    await this.ready;\n    return this.engine.queryBoolean(query, this.createContext(basePath) as unknown as any);\n  }\n\n  public async queryVoid(query: string, basePath: string): Promise<void> {\n    await this.ready;\n    await this.optimizedEngine.queryVoid(query, { baseIRI: basePath });\n  }\n\n  public async constructGraph(graph: string, basePath: string): Promise<AsyncIterator<Quad>> {\n    await this.ready;\n    const constructQuery = `CONSTRUCT { ?s ?p ?o } WHERE { GRAPH <${graph}> { ?s ?p ?o } }`;\n    return this.engine.queryQuads(constructQuery, this.createContext(basePath) as unknown as any) as unknown as AsyncIterator<Quad>;\n  }\n\n  public async listGraphs(basePath: string): Promise<Set<string>> {\n    await this.ready;\n    const graphs = new Set<string>();\n    \n    const query = `\n      SELECT DISTINCT ?g WHERE {\n        GRAPH ?g { ?s ?p ?o }\n        FILTER(STRSTARTS(STR(?g), \"${basePath}\"))\n      }\n    `;\n    \n    const stream = await this.optimizedEngine.queryBindings(query);\n    try {\n      for await (const binding of stream as AsyncIterator<Bindings>) {\n        const value = binding.get('g');\n        if (value && typeof value === 'object' && 'termType' in value && value.termType === 'NamedNode') {\n          graphs.add(value.value);\n        }\n      }\n    } finally {\n      const close = (stream as unknown as { close?: () => void }).close;\n      if (typeof close === 'function') {\n        close();\n      }\n    }\n    return graphs;\n  }\n\n  public async close(): Promise<void> {\n    await this.store.close();\n  }\n\n  private createContext(basePath: string): QueryContext {\n    return {\n      unionDefaultGraph: true,\n      baseIRI: basePath,\n      sources: [\n        {\n          type: 'rdfjsSource',\n          value: {\n            match: (subject?: Quad_Subject | null, predicate?: Quad_Predicate | null, object?: Quad_Object | null, graph?: Quad_Graph | null): AsyncIterator<Quad> => {\n              const iterator = this.store.match(\n                subject ?? undefined,\n                predicate ?? undefined,\n                object ?? undefined,\n                graph ?? undefined,\n              );\n              const filtered = (iterator as unknown as AsyncIterator<Quad>).filter((quad): boolean =>\n                this.isInScope(basePath, quad.graph)\n              );\n              return filtered;\n            },\n          },\n        },\n      ],\n    };\n  }\n\n  private isInScope(basePath: string, graph: Quad_Graph): boolean {\n    if (!graph || graph.termType !== 'NamedNode') {\n      return false;\n    }\n\n    let graphValue = graph.value;\n\n    if (graphValue.startsWith('meta:')) {\n      graphValue = graphValue.slice(5);\n    }\n\n    if (graphValue === basePath) {\n      return true;\n    }\n\n    const childPrefix = basePath.endsWith('/') ? basePath : `${basePath}/`;\n    const fragmentPrefix = `${basePath}#`;\n\n    if (graphValue.startsWith(childPrefix) || graphValue.startsWith(fragmentPrefix)) {\n      return true;\n    }\n\n    let pathOnly = basePath;\n    try {\n      const url = new URL(basePath);\n      pathOnly = url.pathname;\n    } catch {\n      // basePath is already a path\n    }\n\n    if (pathOnly === basePath) {\n      return false;\n    }\n\n    if (graphValue.startsWith('meta:')) {\n       graphValue = graphValue.slice(5);\n    }\n\n    if (graphValue === pathOnly) {\n      return true;\n    }\n\n    const pathChildPrefix = pathOnly.endsWith('/') ? pathOnly : `${pathOnly}/`;\n    const pathFragmentPrefix = `${pathOnly}#`;\n\n    return graphValue.startsWith(pathChildPrefix) || graphValue.startsWith(pathFragmentPrefix);\n  }\n}\n\n/**\n * QuintStore-based SPARQL engine implementation\n * \n * Uses security filters to enforce access boundaries,\n * which are pushed down to the storage layer.\n */\nexport class QuintstoreSparqlEngine implements SparqlEngine {\n  private readonly store: QuintStore;\n  private readonly engine: ComunicaQuintEngine;\n  private readonly ready: Promise<void>;\n\n  public constructor(store: QuintStore) {\n    this.store = store;\n    this.engine = new ComunicaQuintEngine(this.store);\n    this.ready = this.store.open();\n  }\n\n  public async queryBindings(query: string, basePath: string): Promise<any> {\n    await this.ready;\n    return this.engine.queryBindings(query, {\n      baseIRI: basePath,\n      filters: { graph: { $startsWith: basePath } },\n    });\n  }\n\n  public async queryQuads(query: string, basePath: string): Promise<any> {\n    await this.ready;\n    return this.engine.queryQuads(query, {\n      baseIRI: basePath,\n      filters: { graph: { $startsWith: basePath } },\n    });\n  }\n\n  public async queryBoolean(query: string, basePath: string): Promise<boolean> {\n    await this.ready;\n    return this.engine.queryBoolean(query, {\n      baseIRI: basePath,\n      filters: { graph: { $startsWith: basePath } },\n    });\n  }\n\n  public async queryVoid(query: string, basePath: string): Promise<void> {\n    await this.ready;\n    // UPDATE queries have their own graph validation in SubgraphSparqlHttpHandler\n    return this.engine.queryVoid(query, {\n      baseIRI: basePath,\n      filters: { graph: { $startsWith: basePath } },\n    });\n  }\n\n  public async constructGraph(graph: string, basePath: string): Promise<AsyncIterator<Quad>> {\n    await this.ready;\n    // CONSTRUCT with explicit graph IRI - security filter still applies\n    const constructQuery = `CONSTRUCT { ?s ?p ?o } WHERE { GRAPH <${graph}> { ?s ?p ?o } }`;\n    return this.engine.queryQuads(constructQuery, {\n      baseIRI: basePath,\n      filters: { graph: { $startsWith: basePath } },\n    }) as unknown as AsyncIterator<Quad>;\n  }\n\n  public async listGraphs(basePath: string): Promise<Set<string>> {\n    await this.ready;\n    const graphs = new Set<string>();\n    \n    const query = `SELECT DISTINCT ?g WHERE { GRAPH ?g { ?s ?p ?o } }`;\n    \n    const stream = await this.engine.queryBindings(query, {\n      baseIRI: basePath,\n      filters: { graph: { $startsWith: basePath } },\n    });\n    \n    try {\n      for await (const binding of stream as unknown as AsyncIterator<Bindings>) {\n        const value = binding.get('g');\n        if (value && typeof value === 'object' && 'termType' in value && value.termType === 'NamedNode') {\n          graphs.add(value.value);\n        }\n      }\n    } finally {\n      const close = (stream as unknown as { close?: () => void }).close;\n      if (typeof close === 'function') {\n        close();\n      }\n    }\n    \n    return graphs;\n  }\n\n  public async close(): Promise<void> {\n    await this.store.close();\n  }\n}\n\n/**\n * SubgraphQueryEngine - SPARQL engine with subgraph (tenant) isolation\n * \n * Wraps a SparqlEngine implementation for use in the system.\n */\nexport class SubgraphQueryEngine {\n  private readonly logger = getLoggerFor(this);\n  private readonly impl: SparqlEngine;\n\n  /**\n   * Create a SubgraphQueryEngine\n   * @param engine - A SparqlEngine implementation (QuadstoreSparqlEngine or QuintstoreSparqlEngine)\n   */\n  public constructor(engine: SparqlEngine) {\n    this.impl = engine;\n  }\n\n  public async queryBindings(query: string, basePath: string): Promise<any> {\n    return this.impl.queryBindings(query, basePath);\n  }\n\n  public async queryQuads(query: string, basePath: string): Promise<any> {\n    return this.impl.queryQuads(query, basePath);\n  }\n\n  public async queryBoolean(query: string, basePath: string): Promise<boolean> {\n    return this.impl.queryBoolean(query, basePath);\n  }\n\n  public async queryVoid(query: string, basePath: string): Promise<void> {\n    return this.impl.queryVoid(query, basePath);\n  }\n\n  public async constructGraph(graph: string, basePath: string): Promise<AsyncIterator<Quad>> {\n    return this.impl.constructGraph(graph, basePath);\n  }\n\n  public async listGraphs(basePath: string): Promise<Set<string>> {\n    return this.impl.listGraphs(basePath);\n  }\n\n  public async close(): Promise<void> {\n    return this.impl.close();\n  }\n}\n"]}

package/dist/storage/sparql/SubgraphQueryEngine.jsonld

@@ -0,0 +1,250 @@
+{
+  "@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/sparql/SubgraphQueryEngine.jsonld#SparqlEngine",
+      "@type": "AbstractClass",
+      "requireElement": "SparqlEngine",
+      "comment": "SPARQL Engine interface - common abstraction for SPARQL query engines",
+      "parameters": [],
+      "memberFields": [
+        {
+          "@id": "undefineds:dist/storage/sparql/SubgraphQueryEngine.jsonld#SparqlEngine__member_queryBindings",
+          "memberFieldName": "queryBindings"
+        },
+        {
+          "@id": "undefineds:dist/storage/sparql/SubgraphQueryEngine.jsonld#SparqlEngine__member_queryQuads",
+          "memberFieldName": "queryQuads"
+        },
+        {
+          "@id": "undefineds:dist/storage/sparql/SubgraphQueryEngine.jsonld#SparqlEngine__member_queryBoolean",
+          "memberFieldName": "queryBoolean"
+        },
+        {
+          "@id": "undefineds:dist/storage/sparql/SubgraphQueryEngine.jsonld#SparqlEngine__member_queryVoid",
+          "memberFieldName": "queryVoid"
+        },
+        {
+          "@id": "undefineds:dist/storage/sparql/SubgraphQueryEngine.jsonld#SparqlEngine__member_constructGraph",
+          "memberFieldName": "constructGraph"
+        },
+        {
+          "@id": "undefineds:dist/storage/sparql/SubgraphQueryEngine.jsonld#SparqlEngine__member_listGraphs",
+          "memberFieldName": "listGraphs"
+        },
+        {
+          "@id": "undefineds:dist/storage/sparql/SubgraphQueryEngine.jsonld#SparqlEngine__member_close",
+          "memberFieldName": "close"
+        }
+      ],
+      "constructorArguments": []
+    },
+    {
+      "@id": "undefineds:dist/storage/sparql/SubgraphQueryEngine.jsonld#SubgraphQueryEngine",
+      "@type": "Class",
+      "requireElement": "SubgraphQueryEngine",
+      "comment": "SubgraphQueryEngine - SPARQL engine with subgraph (tenant) isolation  Wraps a SparqlEngine implementation for use in the system.",
+      "parameters": [
+        {
+          "@id": "undefineds:dist/storage/sparql/SubgraphQueryEngine.jsonld#SubgraphQueryEngine_engine",
+          "range": "undefineds:dist/storage/sparql/SubgraphQueryEngine.jsonld#SparqlEngine",
+          "comment": "A SparqlEngine implementation (QuadstoreSparqlEngine or QuintstoreSparqlEngine)"
+        }
+      ],
+      "memberFields": [
+        {
+          "@id": "undefineds:dist/storage/sparql/SubgraphQueryEngine.jsonld#SubgraphQueryEngine__member_logger",
+          "memberFieldName": "logger"
+        },
+        {
+          "@id": "undefineds:dist/storage/sparql/SubgraphQueryEngine.jsonld#SubgraphQueryEngine__member_impl",
+          "memberFieldName": "impl"
+        },
+        {
+          "@id": "undefineds:dist/storage/sparql/SubgraphQueryEngine.jsonld#SubgraphQueryEngine__member_constructor",
+          "memberFieldName": "constructor"
+        },
+        {
+          "@id": "undefineds:dist/storage/sparql/SubgraphQueryEngine.jsonld#SubgraphQueryEngine__member_queryBindings",
+          "memberFieldName": "queryBindings"
+        },
+        {
+          "@id": "undefineds:dist/storage/sparql/SubgraphQueryEngine.jsonld#SubgraphQueryEngine__member_queryQuads",
+          "memberFieldName": "queryQuads"
+        },
+        {
+          "@id": "undefineds:dist/storage/sparql/SubgraphQueryEngine.jsonld#SubgraphQueryEngine__member_queryBoolean",
+          "memberFieldName": "queryBoolean"
+        },
+        {
+          "@id": "undefineds:dist/storage/sparql/SubgraphQueryEngine.jsonld#SubgraphQueryEngine__member_queryVoid",
+          "memberFieldName": "queryVoid"
+        },
+        {
+          "@id": "undefineds:dist/storage/sparql/SubgraphQueryEngine.jsonld#SubgraphQueryEngine__member_constructGraph",
+          "memberFieldName": "constructGraph"
+        },
+        {
+          "@id": "undefineds:dist/storage/sparql/SubgraphQueryEngine.jsonld#SubgraphQueryEngine__member_listGraphs",
+          "memberFieldName": "listGraphs"
+        },
+        {
+          "@id": "undefineds:dist/storage/sparql/SubgraphQueryEngine.jsonld#SubgraphQueryEngine__member_close",
+          "memberFieldName": "close"
+        }
+      ],
+      "constructorArguments": [
+        {
+          "@id": "undefineds:dist/storage/sparql/SubgraphQueryEngine.jsonld#SubgraphQueryEngine_engine"
+        }
+      ]
+    },
+    {
+      "@id": "undefineds:dist/storage/sparql/SubgraphQueryEngine.jsonld#QuadstoreSparqlEngine",
+      "@type": "Class",
+      "requireElement": "QuadstoreSparqlEngine",
+      "extends": [
+        "undefineds:dist/storage/sparql/SubgraphQueryEngine.jsonld#SparqlEngine"
+      ],
+      "comment": "Quadstore-based SPARQL engine implementation",
+      "parameters": [
+        {
+          "@id": "undefineds:dist/storage/sparql/SubgraphQueryEngine.jsonld#QuadstoreSparqlEngine_endpoint",
+          "range": "xsd:string"
+        }
+      ],
+      "memberFields": [
+        {
+          "@id": "undefineds:dist/storage/sparql/SubgraphQueryEngine.jsonld#QuadstoreSparqlEngine__member_store",
+          "memberFieldName": "store"
+        },
+        {
+          "@id": "undefineds:dist/storage/sparql/SubgraphQueryEngine.jsonld#QuadstoreSparqlEngine__member_engine",
+          "memberFieldName": "engine"
+        },
+        {
+          "@id": "undefineds:dist/storage/sparql/SubgraphQueryEngine.jsonld#QuadstoreSparqlEngine__member_optimizedEngine",
+          "memberFieldName": "optimizedEngine"
+        },
+        {
+          "@id": "undefineds:dist/storage/sparql/SubgraphQueryEngine.jsonld#QuadstoreSparqlEngine__member_ready",
+          "memberFieldName": "ready"
+        },
+        {
+          "@id": "undefineds:dist/storage/sparql/SubgraphQueryEngine.jsonld#QuadstoreSparqlEngine__member_constructor",
+          "memberFieldName": "constructor"
+        },
+        {
+          "@id": "undefineds:dist/storage/sparql/SubgraphQueryEngine.jsonld#QuadstoreSparqlEngine__member_queryBindings",
+          "memberFieldName": "queryBindings"
+        },
+        {
+          "@id": "undefineds:dist/storage/sparql/SubgraphQueryEngine.jsonld#QuadstoreSparqlEngine__member_queryQuads",
+          "memberFieldName": "queryQuads"
+        },
+        {
+          "@id": "undefineds:dist/storage/sparql/SubgraphQueryEngine.jsonld#QuadstoreSparqlEngine__member_queryBoolean",
+          "memberFieldName": "queryBoolean"
+        },
+        {
+          "@id": "undefineds:dist/storage/sparql/SubgraphQueryEngine.jsonld#QuadstoreSparqlEngine__member_queryVoid",
+          "memberFieldName": "queryVoid"
+        },
+        {
+          "@id": "undefineds:dist/storage/sparql/SubgraphQueryEngine.jsonld#QuadstoreSparqlEngine__member_constructGraph",
+          "memberFieldName": "constructGraph"
+        },
+        {
+          "@id": "undefineds:dist/storage/sparql/SubgraphQueryEngine.jsonld#QuadstoreSparqlEngine__member_listGraphs",
+          "memberFieldName": "listGraphs"
+        },
+        {
+          "@id": "undefineds:dist/storage/sparql/SubgraphQueryEngine.jsonld#QuadstoreSparqlEngine__member_close",
+          "memberFieldName": "close"
+        },
+        {
+          "@id": "undefineds:dist/storage/sparql/SubgraphQueryEngine.jsonld#QuadstoreSparqlEngine__member_createContext",
+          "memberFieldName": "createContext"
+        },
+        {
+          "@id": "undefineds:dist/storage/sparql/SubgraphQueryEngine.jsonld#QuadstoreSparqlEngine__member_isInScope",
+          "memberFieldName": "isInScope"
+        }
+      ],
+      "constructorArguments": [
+        {
+          "@id": "undefineds:dist/storage/sparql/SubgraphQueryEngine.jsonld#QuadstoreSparqlEngine_endpoint"
+        }
+      ]
+    },
+    {
+      "@id": "undefineds:dist/storage/sparql/SubgraphQueryEngine.jsonld#QuintstoreSparqlEngine",
+      "@type": "Class",
+      "requireElement": "QuintstoreSparqlEngine",
+      "extends": [
+        "undefineds:dist/storage/sparql/SubgraphQueryEngine.jsonld#SparqlEngine"
+      ],
+      "comment": "QuintStore-based SPARQL engine implementation  Uses security filters to enforce access boundaries, which are pushed down to the storage layer.",
+      "parameters": [
+        {
+          "@id": "undefineds:dist/storage/sparql/SubgraphQueryEngine.jsonld#QuintstoreSparqlEngine_store",
+          "range": "undefineds:dist/storage/quint/types.jsonld#QuintStore"
+        }
+      ],
+      "memberFields": [
+        {
+          "@id": "undefineds:dist/storage/sparql/SubgraphQueryEngine.jsonld#QuintstoreSparqlEngine__member_store",
+          "memberFieldName": "store"
+        },
+        {
+          "@id": "undefineds:dist/storage/sparql/SubgraphQueryEngine.jsonld#QuintstoreSparqlEngine__member_engine",
+          "memberFieldName": "engine"
+        },
+        {
+          "@id": "undefineds:dist/storage/sparql/SubgraphQueryEngine.jsonld#QuintstoreSparqlEngine__member_ready",
+          "memberFieldName": "ready"
+        },
+        {
+          "@id": "undefineds:dist/storage/sparql/SubgraphQueryEngine.jsonld#QuintstoreSparqlEngine__member_constructor",
+          "memberFieldName": "constructor"
+        },
+        {
+          "@id": "undefineds:dist/storage/sparql/SubgraphQueryEngine.jsonld#QuintstoreSparqlEngine__member_queryBindings",
+          "memberFieldName": "queryBindings"
+        },
+        {
+          "@id": "undefineds:dist/storage/sparql/SubgraphQueryEngine.jsonld#QuintstoreSparqlEngine__member_queryQuads",
+          "memberFieldName": "queryQuads"
+        },
+        {
+          "@id": "undefineds:dist/storage/sparql/SubgraphQueryEngine.jsonld#QuintstoreSparqlEngine__member_queryBoolean",
+          "memberFieldName": "queryBoolean"
+        },
+        {
+          "@id": "undefineds:dist/storage/sparql/SubgraphQueryEngine.jsonld#QuintstoreSparqlEngine__member_queryVoid",
+          "memberFieldName": "queryVoid"
+        },
+        {
+          "@id": "undefineds:dist/storage/sparql/SubgraphQueryEngine.jsonld#QuintstoreSparqlEngine__member_constructGraph",
+          "memberFieldName": "constructGraph"
+        },
+        {
+          "@id": "undefineds:dist/storage/sparql/SubgraphQueryEngine.jsonld#QuintstoreSparqlEngine__member_listGraphs",
+          "memberFieldName": "listGraphs"
+        },
+        {
+          "@id": "undefineds:dist/storage/sparql/SubgraphQueryEngine.jsonld#QuintstoreSparqlEngine__member_close",
+          "memberFieldName": "close"
+        }
+      ],
+      "constructorArguments": [
+        {
+          "@id": "undefineds:dist/storage/sparql/SubgraphQueryEngine.jsonld#QuintstoreSparqlEngine_store"
+        }
+      ]
+    }
+  ]
+}

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

@@ -0,0 +1,46 @@
+/**
+ * PostgresVectorStore - PostgreSQL 向量存储实现（使用 pgvector 扩展）
+ *
+ * 使用 pgvector 扩展进行高性能向量搜索：
+ * - 向量表命名：quint_vec_{hash(modelId)}
+ * - 利用 <=> 运算符（余弦距离）进行近似最近邻搜索
+ * - 支持 IVFFlat 和 HNSW 索引
+ */
+import type { Finalizable, Initializable } from '@solid/community-server';
+import { VectorStore } from './VectorStore';
+import type { VectorRecord, VectorSearchOptions, VectorSearchResult, VectorStoreOptions } from './types';
+export declare class PostgresVectorStore extends VectorStore implements Initializable, Finalizable {
+    protected readonly connectionString: string;
+    /** @ignored */
+    private pool;
+    /** @ignored */
+    private db;
+    constructor(options: VectorStoreOptions);
+    initialize(): Promise<void>;
+    finalize(): Promise<void>;
+    open(): Promise<void>;
+    close(): Promise<void>;
+    private ensureOpen;
+    private getDb;
+    protected getTableName(modelId: string): string;
+    ensureVectorTable(modelId: string): Promise<void>;
+    dropVectorTable(modelId: string): Promise<void>;
+    hasVectorTable(modelId: string): Promise<boolean>;
+    listVectorTables(): Promise<string[]>;
+    upsertVector(modelId: string, id: number, embedding: number[]): Promise<void>;
+    batchUpsertVectors(modelId: string, records: {
+        id: number;
+        embedding: number[];
+    }[]): Promise<void>;
+    getVector(modelId: string, id: number): Promise<VectorRecord | null>;
+    deleteVector(modelId: string, id: number): Promise<void>;
+    batchDeleteVectors(modelId: string, ids: number[]): Promise<void>;
+    search(modelId: string, queryEmbedding: number[], options?: VectorSearchOptions): Promise<VectorSearchResult[]>;
+    countVectors(modelId: string): Promise<number>;
+    getVectorIds(modelId: string, options?: {
+        limit?: number;
+        afterId?: number;
+    }): Promise<number[]>;
+    private rowToVector;
+    private parseEmbedding;
+}