@undefineds.co/xpod 0.2.0-preview.2 → 0.2.1

package/dist/storage/sparql/SubgraphQueryEngine.js

@@ -1,135 +1,38 @@
 "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");
+const QuintEngine_1 = require("./QuintEngine");
 /**
- * Quadstore-based SPARQL engine implementation
+ * @deprecated Compatibility wrapper preserved for older call sites.
+ * Mainline xpod now executes subgraph queries through QuintStore.
  */
 class QuadstoreSparqlEngine {
     constructor(endpoint) {
-        this.logger = (0, global_logger_factory_1.getLoggerFor)(this);
-        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();
+        const store = new QuintEngine_1.QuintEngine({ endpoint }).getStore();
+        this.delegate = new QuintstoreSparqlEngine(store);
     }
     async queryBindings(query, basePath) {
-        await this.ready;
-        return this.engine.queryBindings(query, this.createContext(basePath));
+        return this.delegate.queryBindings(query, basePath);
     }
     async queryQuads(query, basePath) {
-        await this.ready;
-        return this.engine.queryQuads(query, this.createContext(basePath));
+        return this.delegate.queryQuads(query, basePath);
     }
     async queryBoolean(query, basePath) {
-        await this.ready;
-        return this.engine.queryBoolean(query, this.createContext(basePath));
+        return this.delegate.queryBoolean(query, basePath);
     }
     async queryVoid(query, basePath) {
-        await this.ready;
-        await this.optimizedEngine.queryVoid(query, { baseIRI: basePath });
+        await this.delegate.queryVoid(query, 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));
+        return this.delegate.constructGraph(graph, 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;
+        return this.delegate.listGraphs(basePath);
     }
     async close() {
-        await this.store.close();
-    }
-    createContext(basePath) {
-        const logger = this.logger;
-        const self = this;
-        return {
-            unionDefaultGraph: true,
-            baseIRI: basePath,
-            sources: [
-                {
-                    type: 'rdfjsSource',
-                    value: {
-                        match: (subject, predicate, object, graph) => {
-                            logger.debug(`[match] s=${subject?.value ?? '*'} p=${predicate?.value ?? '*'} o=${object?.value ?? '*'} g=${graph?.value ?? '*'} gType=${graph?.termType ?? 'null'}`);
-                            const iterator = self.store.match(subject ?? undefined, predicate ?? undefined, object ?? undefined, graph ?? undefined);
-                            const filtered = iterator.filter((quad) => self.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);
+        await this.delegate.close();
     }
 }
 exports.QuadstoreSparqlEngine = QuadstoreSparqlEngine;

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

@@ -1 +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 logger = getLoggerFor(this);\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    const logger = this.logger;\n    const self = this;\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              logger.debug(`[match] s=${subject?.value ?? '*'} p=${predicate?.value ?? '*'} o=${object?.value ?? '*'} g=${graph?.value ?? '*'} gType=${graph?.termType ?? 'null'}`);\n              const iterator = self.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                self.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"]}
+{"version":3,"file":"SubgraphQueryEngine.js","sourceRoot":"","sources":["../../../src/storage/sparql/SubgraphQueryEngine.ts"],"names":[],"mappings":"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","sourcesContent":["import type { Quad } from '@rdfjs/types';\nimport type { Bindings } from '@comunica/types';\nimport type { AsyncIterator } from 'asynciterator';\nimport { getLoggerFor } from 'global-logger-factory';\nimport { ComunicaQuintEngine } from './ComunicaQuintEngine';\nimport { QuintEngine } from './QuintEngine';\nimport type { QuintStore } from '../quint/types';\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 * @deprecated Compatibility wrapper preserved for older call sites.\n * Mainline xpod now executes subgraph queries through QuintStore.\n */\nexport class QuadstoreSparqlEngine implements SparqlEngine {\n  private readonly delegate: QuintstoreSparqlEngine;\n\n  public constructor(endpoint: string) {\n    const store = new QuintEngine({ endpoint }).getStore();\n    this.delegate = new QuintstoreSparqlEngine(store);\n  }\n\n  public async queryBindings(query: string, basePath: string): Promise<any> {\n    return this.delegate.queryBindings(query, basePath);\n  }\n\n  public async queryQuads(query: string, basePath: string): Promise<any> {\n    return this.delegate.queryQuads(query, basePath);\n  }\n\n  public async queryBoolean(query: string, basePath: string): Promise<boolean> {\n    return this.delegate.queryBoolean(query, basePath);\n  }\n\n  public async queryVoid(query: string, basePath: string): Promise<void> {\n    await this.delegate.queryVoid(query, basePath);\n  }\n\n  public async constructGraph(graph: string, basePath: string): Promise<AsyncIterator<Quad>> {\n    return this.delegate.constructGraph(graph, basePath);\n  }\n\n  public async listGraphs(basePath: string): Promise<Set<string>> {\n    return this.delegate.listGraphs(basePath);\n  }\n\n  public async close(): Promise<void> {\n    await this.delegate.close();\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

@@ -109,7 +109,6 @@
       "extends": [
         "undefineds:dist/storage/sparql/SubgraphQueryEngine.jsonld#SparqlEngine"
       ],
-      "comment": "Quadstore-based SPARQL engine implementation",
       "parameters": [
         {
           "@id": "undefineds:dist/storage/sparql/SubgraphQueryEngine.jsonld#QuadstoreSparqlEngine_endpoint",
@@ -118,24 +117,8 @@
       ],
       "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_logger",
-          "memberFieldName": "logger"
-        },
-        {
-          "@id": "undefineds:dist/storage/sparql/SubgraphQueryEngine.jsonld#QuadstoreSparqlEngine__member_ready",
-          "memberFieldName": "ready"
+          "@id": "undefineds:dist/storage/sparql/SubgraphQueryEngine.jsonld#QuadstoreSparqlEngine__member_delegate",
+          "memberFieldName": "delegate"
         },
         {
           "@id": "undefineds:dist/storage/sparql/SubgraphQueryEngine.jsonld#QuadstoreSparqlEngine__member_constructor",
@@ -168,14 +151,6 @@
         {
           "@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": [

package/dist/storage/sqlite/backends/BunSqliteRuntime.d.ts

@@ -0,0 +1,2 @@
+import type { SqliteRuntime } from '../types';
+export declare function createBunSqliteRuntime(): SqliteRuntime;

package/dist/storage/sqlite/backends/BunSqliteRuntime.js

@@ -0,0 +1,50 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createBunSqliteRuntime = createBunSqliteRuntime;
+const shared_1 = require("../shared");
+function createBunSqliteRuntime() {
+    const { Database } = require('bun:sqlite');
+    const { drizzle } = require('drizzle-orm/bun-sqlite');
+    return {
+        kind: 'bun-sqlite',
+        openDatabase: (path, options) => {
+            if ((0, shared_1.shouldEnsureParentDirectory)(path, options)) {
+                (0, shared_1.ensureParentDirectory)(path);
+            }
+            const BunDatabase = Database;
+            const nativeDb = options?.readonly ? new BunDatabase(path, { readonly: true }) : new BunDatabase(path);
+            return {
+                kind: 'bun-sqlite',
+                native: nativeDb,
+                exec: (sql) => nativeDb.exec(sql),
+                pragma: (pragma) => nativeDb.query(`PRAGMA ${pragma}`).get(),
+                prepare(sql) {
+                    const stmt = nativeDb.query(sql);
+                    return {
+                        run: (...params) => {
+                            const result = stmt.run(...params);
+                            return {
+                                changes: Number(result?.changes ?? 0),
+                                lastInsertRowid: result?.lastInsertRowid ?? 0,
+                            };
+                        },
+                        get: (...params) => stmt.get(...params),
+                        all: (...params) => stmt.all(...params),
+                        *iterate(...params) {
+                            for (const row of stmt.all(...params)) {
+                                yield row;
+                            }
+                        },
+                    };
+                },
+                loadExtension: (extensionPath) => nativeDb.loadExtension(extensionPath),
+                transaction(fn) {
+                    return nativeDb.transaction(fn);
+                },
+                close: () => nativeDb.close(),
+            };
+        },
+        createDrizzleDatabase: (database) => (0, shared_1.tagDrizzleDatabase)(drizzle(database.native), 'bun-sqlite'),
+    };
+}
+//# sourceMappingURL=BunSqliteRuntime.js.map

package/dist/storage/sqlite/backends/BunSqliteRuntime.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"BunSqliteRuntime.js","sourceRoot":"","sources":["../../../../src/storage/sqlite/backends/BunSqliteRuntime.ts"],"names":[],"mappings":";;AAGA,wDAkDC;AApDD,sCAAmG;AAEnG,SAAgB,sBAAsB;IACpC,MAAM,EAAE,QAAQ,EAAE,GAAG,OAAO,CAAC,YAAY,CAAsB,CAAC;IAChE,MAAM,EAAE,OAAO,EAAE,GAAG,OAAO,CAAC,wBAAwB,CAAwC,CAAC;IAE7F,OAAO;QACL,IAAI,EAAE,YAAY;QAClB,YAAY,EAAE,CAAC,IAAY,EAAE,OAA2B,EAAkB,EAAE;YAC1E,IAAI,IAAA,oCAA2B,EAAC,IAAI,EAAE,OAAO,CAAC,EAAE,CAAC;gBAC/C,IAAA,8BAAqB,EAAC,IAAI,CAAC,CAAC;YAC9B,CAAC;YAED,MAAM,WAAW,GAAG,QAAe,CAAC;YACpC,MAAM,QAAQ,GAAG,OAAO,EAAE,QAAQ,CAAC,CAAC,CAAC,IAAI,WAAW,CAAC,IAAI,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,WAAW,CAAC,IAAI,CAAC,CAAC;YAEvG,OAAO;gBACL,IAAI,EAAE,YAAY;gBAClB,MAAM,EAAE,QAAQ;gBAChB,IAAI,EAAE,CAAC,GAAW,EAAW,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC,GAAG,CAAC;gBAClD,MAAM,EAAE,CAAC,MAAc,EAAW,EAAE,CAAC,QAAQ,CAAC,KAAK,CAAC,UAAU,MAAM,EAAE,CAAC,CAAC,GAAG,EAAE;gBAC7E,OAAO,CAAoB,GAAW;oBACpC,MAAM,IAAI,GAAG,QAAQ,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;oBACjC,OAAO;wBACL,GAAG,EAAE,CAAC,GAAG,MAAiB,EAAmB,EAAE;4BAC7C,MAAM,MAAM,GAAG,IAAI,CAAC,GAAG,CAAC,GAAG,MAAM,CAAC,CAAC;4BACnC,OAAO;gCACL,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,IAAI,CAAC,CAAC;gCACrC,eAAe,EAAE,MAAM,EAAE,eAAe,IAAI,CAAC;6BAC9C,CAAC;wBACJ,CAAC;wBACD,GAAG,EAAE,CAAC,GAAG,MAAiB,EAAuB,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,MAAM,CAAwB;wBAC9F,GAAG,EAAE,CAAC,GAAG,MAAiB,EAAa,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,MAAM,CAAc;wBAC1E,CAAC,OAAO,CAAC,GAAG,MAAiB;4BAC3B,KAAK,MAAM,GAAG,IAAI,IAAI,CAAC,GAAG,CAAC,GAAG,MAAM,CAAc,EAAE,CAAC;gCACnD,MAAM,GAAG,CAAC;4BACZ,CAAC;wBACH,CAAC;qBACF,CAAC;gBACJ,CAAC;gBACD,aAAa,EAAE,CAAC,aAAqB,EAAQ,EAAE,CAAC,QAAQ,CAAC,aAAa,CAAC,aAAa,CAAC;gBACrF,WAAW,CAAmC,EAA+B;oBAC3E,OAAO,QAAQ,CAAC,WAAW,CAAC,EAAE,CAAC,CAAC;gBAClC,CAAC;gBACD,KAAK,EAAE,GAAS,EAAE,CAAC,QAAQ,CAAC,KAAK,EAAE;aACpC,CAAC;QACJ,CAAC;QACD,qBAAqB,EAAE,CAAC,QAAwB,EAAO,EAAE,CAAC,IAAA,2BAAkB,EAC1E,OAAO,CAAC,QAAQ,CAAC,MAAa,CAAC,EAC/B,YAAY,CACb;KACF,CAAC;AACJ,CAAC","sourcesContent":["import type { SqliteDatabase, SqliteOpenOptions, SqliteRunResult, SqliteRuntime, SqliteStatement } from '../types';\nimport { ensureParentDirectory, shouldEnsureParentDirectory, tagDrizzleDatabase } from '../shared';\n\nexport function createBunSqliteRuntime(): SqliteRuntime {\n  const { Database } = require('bun:sqlite') as { Database: any };\n  const { drizzle } = require('drizzle-orm/bun-sqlite') as { drizzle: (database: any) => any };\n\n  return {\n    kind: 'bun-sqlite',\n    openDatabase: (path: string, options?: SqliteOpenOptions): SqliteDatabase => {\n      if (shouldEnsureParentDirectory(path, options)) {\n        ensureParentDirectory(path);\n      }\n\n      const BunDatabase = Database as any;\n      const nativeDb = options?.readonly ? new BunDatabase(path, { readonly: true }) : new BunDatabase(path);\n\n      return {\n        kind: 'bun-sqlite',\n        native: nativeDb,\n        exec: (sql: string): unknown => nativeDb.exec(sql),\n        pragma: (pragma: string): unknown => nativeDb.query(`PRAGMA ${pragma}`).get(),\n        prepare<TResult = unknown>(sql: string): SqliteStatement<TResult> {\n          const stmt = nativeDb.query(sql);\n          return {\n            run: (...params: unknown[]): SqliteRunResult => {\n              const result = stmt.run(...params);\n              return {\n                changes: Number(result?.changes ?? 0),\n                lastInsertRowid: result?.lastInsertRowid ?? 0,\n              };\n            },\n            get: (...params: unknown[]): TResult | undefined => stmt.get(...params) as TResult | undefined,\n            all: (...params: unknown[]): TResult[] => stmt.all(...params) as TResult[],\n            *iterate(...params: unknown[]): IterableIterator<TResult> {\n              for (const row of stmt.all(...params) as TResult[]) {\n                yield row;\n              }\n            },\n          };\n        },\n        loadExtension: (extensionPath: string): void => nativeDb.loadExtension(extensionPath),\n        transaction<TArgs extends unknown[], TResult>(fn: (...args: TArgs) => TResult): (...args: TArgs) => TResult {\n          return nativeDb.transaction(fn);\n        },\n        close: (): void => nativeDb.close(),\n      };\n    },\n    createDrizzleDatabase: (database: SqliteDatabase): any => tagDrizzleDatabase(\n      drizzle(database.native as any),\n      'bun-sqlite',\n    ),\n  };\n}\n"]}

package/dist/storage/sqlite/backends/NodeSqliteRuntime.d.ts

@@ -0,0 +1,2 @@
+import type { SqliteRuntime } from '../types';
+export declare function createNodeSqliteRuntime(): SqliteRuntime;

package/dist/storage/sqlite/backends/NodeSqliteRuntime.js

@@ -0,0 +1,58 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createNodeSqliteRuntime = createNodeSqliteRuntime;
+const shared_1 = require("../shared");
+const NodeSqliteDrizzle_1 = require("../../NodeSqliteDrizzle");
+function createNodeSqliteRuntime() {
+    const { DatabaseSync } = require('node:sqlite');
+    return {
+        kind: 'node-sqlite',
+        openDatabase: (path, options) => {
+            if ((0, shared_1.shouldEnsureParentDirectory)(path, options)) {
+                (0, shared_1.ensureParentDirectory)(path);
+            }
+            const nativeDb = new DatabaseSync(path, {
+                readOnly: options?.readonly === true,
+                allowExtension: true,
+            });
+            nativeDb.enableLoadExtension(true);
+            return {
+                kind: 'node-sqlite',
+                native: nativeDb,
+                exec: (sql) => nativeDb.exec(sql),
+                pragma: (pragma) => nativeDb.prepare(`PRAGMA ${pragma}`).all(),
+                prepare(sql) {
+                    const stmt = nativeDb.prepare(sql);
+                    return {
+                        run: (...params) => stmt.run(...params),
+                        get: (...params) => stmt.get(...params),
+                        all: (...params) => stmt.all(...params),
+                        iterate: (...params) => stmt.iterate(...params),
+                    };
+                },
+                loadExtension: (extensionPath) => nativeDb.loadExtension(extensionPath),
+                transaction(fn) {
+                    return (...args) => {
+                        nativeDb.exec('BEGIN DEFERRED');
+                        try {
+                            const result = fn(...args);
+                            nativeDb.exec('COMMIT');
+                            return result;
+                        }
+                        catch (error) {
+                            try {
+                                nativeDb.exec('ROLLBACK');
+                            }
+                            catch {
+                            }
+                            throw error;
+                        }
+                    };
+                },
+                close: () => nativeDb.close(),
+            };
+        },
+        createDrizzleDatabase: (database) => (0, shared_1.tagDrizzleDatabase)((0, NodeSqliteDrizzle_1.drizzleNodeSqlite)(database.native), 'node-sqlite'),
+    };
+}
+//# sourceMappingURL=NodeSqliteRuntime.js.map

package/dist/storage/sqlite/backends/NodeSqliteRuntime.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"NodeSqliteRuntime.js","sourceRoot":"","sources":["../../../../src/storage/sqlite/backends/NodeSqliteRuntime.ts"],"names":[],"mappings":";;AAmBA,0DAuDC;AAzED,sCAAmG;AACnG,+DAA4D;AAiB5D,SAAgB,uBAAuB;IACrC,MAAM,EAAE,YAAY,EAAE,GAAG,OAAO,CAAC,aAAa,CAAqG,CAAC;IAEpJ,OAAO;QACL,IAAI,EAAE,aAAa;QACnB,YAAY,EAAE,CAAC,IAAY,EAAE,OAA2B,EAAkB,EAAE;YAC1E,IAAI,IAAA,oCAA2B,EAAC,IAAI,EAAE,OAAO,CAAC,EAAE,CAAC;gBAC/C,IAAA,8BAAqB,EAAC,IAAI,CAAC,CAAC;YAC9B,CAAC;YAED,MAAM,QAAQ,GAAG,IAAI,YAAY,CAAC,IAAI,EAAE;gBACtC,QAAQ,EAAE,OAAO,EAAE,QAAQ,KAAK,IAAI;gBACpC,cAAc,EAAE,IAAI;aACrB,CAAC,CAAC;YACH,QAAQ,CAAC,mBAAmB,CAAC,IAAI,CAAC,CAAC;YAEnC,OAAO;gBACL,IAAI,EAAE,aAAa;gBACnB,MAAM,EAAE,QAAQ;gBAChB,IAAI,EAAE,CAAC,GAAW,EAAW,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC,GAAG,CAAC;gBAClD,MAAM,EAAE,CAAC,MAAc,EAAW,EAAE,CAAC,QAAQ,CAAC,OAAO,CAAC,UAAU,MAAM,EAAE,CAAC,CAAC,GAAG,EAAE;gBAC/E,OAAO,CAAoB,GAAW;oBACpC,MAAM,IAAI,GAAG,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;oBACnC,OAAO;wBACL,GAAG,EAAE,CAAC,GAAG,MAAiB,EAAmB,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,MAAM,CAAC;wBACnE,GAAG,EAAE,CAAC,GAAG,MAAiB,EAAuB,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,MAAM,CAAwB;wBAC9F,GAAG,EAAE,CAAC,GAAG,MAAiB,EAAa,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,MAAM,CAAc;wBAC1E,OAAO,EAAE,CAAC,GAAG,MAAiB,EAA6B,EAAE,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,MAAM,CAA8B;qBACnH,CAAC;gBACJ,CAAC;gBACD,aAAa,EAAE,CAAC,aAAqB,EAAQ,EAAE,CAAC,QAAQ,CAAC,aAAa,CAAC,aAAa,CAAC;gBACrF,WAAW,CAAmC,EAA+B;oBAC3E,OAAO,CAAC,GAAG,IAAW,EAAW,EAAE;wBACjC,QAAQ,CAAC,IAAI,CAAC,gBAAgB,CAAC,CAAC;wBAChC,IAAI,CAAC;4BACH,MAAM,MAAM,GAAG,EAAE,CAAC,GAAG,IAAI,CAAC,CAAC;4BAC3B,QAAQ,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;4BACxB,OAAO,MAAM,CAAC;wBAChB,CAAC;wBAAC,OAAO,KAAK,EAAE,CAAC;4BACf,IAAI,CAAC;gCACH,QAAQ,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;4BAC5B,CAAC;4BAAC,MAAM,CAAC;4BACT,CAAC;4BACD,MAAM,KAAK,CAAC;wBACd,CAAC;oBACH,CAAC,CAAC;gBACJ,CAAC;gBACD,KAAK,EAAE,GAAS,EAAE,CAAC,QAAQ,CAAC,KAAK,EAAE;aACpC,CAAC;QACJ,CAAC;QACD,qBAAqB,EAAE,CAAC,QAAwB,EAAO,EAAE,CAAC,IAAA,2BAAkB,EAC1E,IAAA,qCAAiB,EAAC,QAAQ,CAAC,MAAgC,CAAC,EAC5D,aAAa,CACd;KACF,CAAC;AACJ,CAAC","sourcesContent":["import type { SqliteDatabase, SqliteOpenOptions, SqliteRunResult, SqliteRuntime, SqliteStatement } from '../types';\nimport { ensureParentDirectory, shouldEnsureParentDirectory, tagDrizzleDatabase } from '../shared';\nimport { drizzleNodeSqlite } from '../../NodeSqliteDrizzle';\n\ninterface NodeSqliteStatementSync {\n  run(...params: unknown[]): SqliteRunResult;\n  get(...params: unknown[]): unknown;\n  all(...params: unknown[]): unknown[];\n  iterate(...params: unknown[]): IterableIterator<unknown>;\n}\n\ninterface NodeSqliteDatabaseSync {\n  exec(sql: string): unknown;\n  prepare(sql: string): NodeSqliteStatementSync;\n  enableLoadExtension(enabled: boolean): void;\n  loadExtension(path: string): void;\n  close(): void;\n}\n\nexport function createNodeSqliteRuntime(): SqliteRuntime {\n  const { DatabaseSync } = require('node:sqlite') as { DatabaseSync: new(path: string, options?: Record<string, unknown>) => NodeSqliteDatabaseSync };\n\n  return {\n    kind: 'node-sqlite',\n    openDatabase: (path: string, options?: SqliteOpenOptions): SqliteDatabase => {\n      if (shouldEnsureParentDirectory(path, options)) {\n        ensureParentDirectory(path);\n      }\n\n      const nativeDb = new DatabaseSync(path, {\n        readOnly: options?.readonly === true,\n        allowExtension: true,\n      });\n      nativeDb.enableLoadExtension(true);\n\n      return {\n        kind: 'node-sqlite',\n        native: nativeDb,\n        exec: (sql: string): unknown => nativeDb.exec(sql),\n        pragma: (pragma: string): unknown => nativeDb.prepare(`PRAGMA ${pragma}`).all(),\n        prepare<TResult = unknown>(sql: string): SqliteStatement<TResult> {\n          const stmt = nativeDb.prepare(sql);\n          return {\n            run: (...params: unknown[]): SqliteRunResult => stmt.run(...params),\n            get: (...params: unknown[]): TResult | undefined => stmt.get(...params) as TResult | undefined,\n            all: (...params: unknown[]): TResult[] => stmt.all(...params) as TResult[],\n            iterate: (...params: unknown[]): IterableIterator<TResult> => stmt.iterate(...params) as IterableIterator<TResult>,\n          };\n        },\n        loadExtension: (extensionPath: string): void => nativeDb.loadExtension(extensionPath),\n        transaction<TArgs extends unknown[], TResult>(fn: (...args: TArgs) => TResult): (...args: TArgs) => TResult {\n          return (...args: TArgs): TResult => {\n            nativeDb.exec('BEGIN DEFERRED');\n            try {\n              const result = fn(...args);\n              nativeDb.exec('COMMIT');\n              return result;\n            } catch (error) {\n              try {\n                nativeDb.exec('ROLLBACK');\n              } catch {\n              }\n              throw error;\n            }\n          };\n        },\n        close: (): void => nativeDb.close(),\n      };\n    },\n    createDrizzleDatabase: (database: SqliteDatabase): any => tagDrizzleDatabase(\n      drizzleNodeSqlite(database.native as NodeSqliteDatabaseSync),\n      'node-sqlite',\n    ),\n  };\n}\n"]}

package/dist/storage/sqlite/factory.d.ts

@@ -0,0 +1,4 @@
+import type { SqliteRuntime, SqliteRuntimeKind } from './types';
+export declare function isBunRuntime(): boolean;
+export declare function resolveDefaultSqliteRuntimeKind(): SqliteRuntimeKind;
+export declare function createSqliteRuntime(kind?: SqliteRuntimeKind): SqliteRuntime;

package/dist/storage/sqlite/factory.js

@@ -0,0 +1,36 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.isBunRuntime = isBunRuntime;
+exports.resolveDefaultSqliteRuntimeKind = resolveDefaultSqliteRuntimeKind;
+exports.createSqliteRuntime = createSqliteRuntime;
+const BunSqliteRuntime_1 = require("./backends/BunSqliteRuntime");
+const NodeSqliteRuntime_1 = require("./backends/NodeSqliteRuntime");
+function isBunRuntime() {
+    return typeof globalThis.Bun !== 'undefined';
+}
+function parseConfiguredSqliteRuntimeKind(value) {
+    if (!value) {
+        return undefined;
+    }
+    if (value === 'node-sqlite' || value === 'bun-sqlite') {
+        return value;
+    }
+    throw new Error(`Unsupported XPOD_SQLITE_RUNTIME: ${value}`);
+}
+function resolveDefaultSqliteRuntimeKind() {
+    return parseConfiguredSqliteRuntimeKind(process.env.XPOD_SQLITE_RUNTIME)
+        ?? (isBunRuntime() ? 'bun-sqlite' : 'node-sqlite');
+}
+function createSqliteRuntime(kind = resolveDefaultSqliteRuntimeKind()) {
+    switch (kind) {
+        case 'bun-sqlite':
+            return (0, BunSqliteRuntime_1.createBunSqliteRuntime)();
+        case 'node-sqlite':
+            return (0, NodeSqliteRuntime_1.createNodeSqliteRuntime)();
+        default: {
+            const exhaustiveKind = kind;
+            throw new Error(`Unsupported sqlite runtime kind: ${String(exhaustiveKind)}`);
+        }
+    }
+}
+//# sourceMappingURL=factory.js.map

package/dist/storage/sqlite/factory.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"factory.js","sourceRoot":"","sources":["../../../src/storage/sqlite/factory.ts"],"names":[],"mappings":";;AAIA,oCAEC;AAcD,0EAGC;AAED,kDAWC;AApCD,kEAAqE;AACrE,oEAAuE;AAGvE,SAAgB,YAAY;IAC1B,OAAO,OAAQ,UAAkB,CAAC,GAAG,KAAK,WAAW,CAAC;AACxD,CAAC;AAED,SAAS,gCAAgC,CAAC,KAAyB;IACjE,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,IAAI,KAAK,KAAK,aAAa,IAAI,KAAK,KAAK,YAAY,EAAE,CAAC;QACtD,OAAO,KAAK,CAAC;IACf,CAAC;IAED,MAAM,IAAI,KAAK,CAAC,oCAAoC,KAAK,EAAE,CAAC,CAAC;AAC/D,CAAC;AAED,SAAgB,+BAA+B;IAC7C,OAAO,gCAAgC,CAAC,OAAO,CAAC,GAAG,CAAC,mBAAmB,CAAC;WACnE,CAAC,YAAY,EAAE,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC;AACvD,CAAC;AAED,SAAgB,mBAAmB,CAAC,OAA0B,+BAA+B,EAAE;IAC7F,QAAQ,IAAI,EAAE,CAAC;QACb,KAAK,YAAY;YACf,OAAO,IAAA,yCAAsB,GAAE,CAAC;QAClC,KAAK,aAAa;YAChB,OAAO,IAAA,2CAAuB,GAAE,CAAC;QACnC,OAAO,CAAC,CAAC,CAAC;YACR,MAAM,cAAc,GAAU,IAAI,CAAC;YACnC,MAAM,IAAI,KAAK,CAAC,oCAAoC,MAAM,CAAC,cAAc,CAAC,EAAE,CAAC,CAAC;QAChF,CAAC;IACH,CAAC;AACH,CAAC","sourcesContent":["import { createBunSqliteRuntime } from './backends/BunSqliteRuntime';\nimport { createNodeSqliteRuntime } from './backends/NodeSqliteRuntime';\nimport type { SqliteRuntime, SqliteRuntimeKind } from './types';\n\nexport function isBunRuntime(): boolean {\n  return typeof (globalThis as any).Bun !== 'undefined';\n}\n\nfunction parseConfiguredSqliteRuntimeKind(value: string | undefined): SqliteRuntimeKind | undefined {\n  if (!value) {\n    return undefined;\n  }\n\n  if (value === 'node-sqlite' || value === 'bun-sqlite') {\n    return value;\n  }\n\n  throw new Error(`Unsupported XPOD_SQLITE_RUNTIME: ${value}`);\n}\n\nexport function resolveDefaultSqliteRuntimeKind(): SqliteRuntimeKind {\n  return parseConfiguredSqliteRuntimeKind(process.env.XPOD_SQLITE_RUNTIME)\n    ?? (isBunRuntime() ? 'bun-sqlite' : 'node-sqlite');\n}\n\nexport function createSqliteRuntime(kind: SqliteRuntimeKind = resolveDefaultSqliteRuntimeKind()): SqliteRuntime {\n  switch (kind) {\n    case 'bun-sqlite':\n      return createBunSqliteRuntime();\n    case 'node-sqlite':\n      return createNodeSqliteRuntime();\n    default: {\n      const exhaustiveKind: never = kind;\n      throw new Error(`Unsupported sqlite runtime kind: ${String(exhaustiveKind)}`);\n    }\n  }\n}\n"]}

package/dist/storage/sqlite/shared.d.ts

@@ -0,0 +1,4 @@
+import type { SqliteOpenOptions, SqliteRuntimeKind } from './types';
+export declare function shouldEnsureParentDirectory(path: string, options?: SqliteOpenOptions): boolean;
+export declare function ensureParentDirectory(path: string): void;
+export declare function tagDrizzleDatabase(database: any, kind: SqliteRuntimeKind): any;

package/dist/storage/sqlite/shared.js

@@ -0,0 +1,25 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.shouldEnsureParentDirectory = shouldEnsureParentDirectory;
+exports.ensureParentDirectory = ensureParentDirectory;
+exports.tagDrizzleDatabase = tagDrizzleDatabase;
+const node_fs_1 = require("node:fs");
+const node_path_1 = require("node:path");
+function shouldEnsureParentDirectory(path, options) {
+    return !options?.readonly && path !== ':memory:' && !path.startsWith(':memory:');
+}
+function ensureParentDirectory(path) {
+    const directory = (0, node_path_1.dirname)(path);
+    if (directory && directory !== '.' && !(0, node_fs_1.existsSync)(directory)) {
+        (0, node_fs_1.mkdirSync)(directory, { recursive: true });
+    }
+}
+function tagDrizzleDatabase(database, kind) {
+    Object.defineProperty(database, '$xpodSqliteRuntime', {
+        value: kind,
+        enumerable: false,
+        configurable: true,
+    });
+    return database;
+}
+//# sourceMappingURL=shared.js.map

package/dist/storage/sqlite/shared.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"shared.js","sourceRoot":"","sources":["../../../src/storage/sqlite/shared.ts"],"names":[],"mappings":";;AAIA,kEAEC;AAED,sDAKC;AAED,gDAOC;AAtBD,qCAAgD;AAChD,yCAAoC;AAGpC,SAAgB,2BAA2B,CAAC,IAAY,EAAE,OAA2B;IACnF,OAAO,CAAC,OAAO,EAAE,QAAQ,IAAI,IAAI,KAAK,UAAU,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,UAAU,CAAC,CAAC;AACnF,CAAC;AAED,SAAgB,qBAAqB,CAAC,IAAY;IAChD,MAAM,SAAS,GAAG,IAAA,mBAAO,EAAC,IAAI,CAAC,CAAC;IAChC,IAAI,SAAS,IAAI,SAAS,KAAK,GAAG,IAAI,CAAC,IAAA,oBAAU,EAAC,SAAS,CAAC,EAAE,CAAC;QAC7D,IAAA,mBAAS,EAAC,SAAS,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAC5C,CAAC;AACH,CAAC;AAED,SAAgB,kBAAkB,CAAC,QAAa,EAAE,IAAuB;IACvE,MAAM,CAAC,cAAc,CAAC,QAAQ,EAAE,oBAAoB,EAAE;QACpD,KAAK,EAAE,IAAI;QACX,UAAU,EAAE,KAAK;QACjB,YAAY,EAAE,IAAI;KACnB,CAAC,CAAC;IACH,OAAO,QAAQ,CAAC;AAClB,CAAC","sourcesContent":["import { existsSync, mkdirSync } from 'node:fs';\nimport { dirname } from 'node:path';\nimport type { SqliteOpenOptions, SqliteRuntimeKind } from './types';\n\nexport function shouldEnsureParentDirectory(path: string, options?: SqliteOpenOptions): boolean {\n  return !options?.readonly && path !== ':memory:' && !path.startsWith(':memory:');\n}\n\nexport function ensureParentDirectory(path: string): void {\n  const directory = dirname(path);\n  if (directory && directory !== '.' && !existsSync(directory)) {\n    mkdirSync(directory, { recursive: true });\n  }\n}\n\nexport function tagDrizzleDatabase(database: any, kind: SqliteRuntimeKind): any {\n  Object.defineProperty(database, '$xpodSqliteRuntime', {\n    value: kind,\n    enumerable: false,\n    configurable: true,\n  });\n  return database;\n}\n"]}

package/dist/storage/sqlite/types.d.ts

@@ -0,0 +1,29 @@
+export type SqliteRuntimeKind = 'node-sqlite' | 'bun-sqlite';
+export interface SqliteOpenOptions {
+    readonly?: boolean;
+}
+export interface SqliteRunResult {
+    changes: number;
+    lastInsertRowid: number | bigint;
+}
+export interface SqliteStatement<TResult = unknown> {
+    run(...params: unknown[]): SqliteRunResult;
+    get(...params: unknown[]): TResult | undefined;
+    all(...params: unknown[]): TResult[];
+    iterate(...params: unknown[]): IterableIterator<TResult>;
+}
+export interface SqliteDatabase {
+    readonly kind: SqliteRuntimeKind;
+    readonly native: unknown;
+    exec(sql: string): unknown;
+    pragma(pragma: string): unknown;
+    prepare<TResult = unknown>(sql: string): SqliteStatement<TResult>;
+    loadExtension(path: string): void;
+    transaction<TArgs extends unknown[], TResult>(fn: (...args: TArgs) => TResult): (...args: TArgs) => TResult;
+    close(): void;
+}
+export interface SqliteRuntime {
+    readonly kind: SqliteRuntimeKind;
+    openDatabase(path: string, options?: SqliteOpenOptions): SqliteDatabase;
+    createDrizzleDatabase(database: SqliteDatabase): any;
+}

package/dist/storage/sqlite/types.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=types.js.map

package/dist/storage/sqlite/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/storage/sqlite/types.ts"],"names":[],"mappings":"","sourcesContent":["export type SqliteRuntimeKind = 'node-sqlite' | 'bun-sqlite';\n\nexport interface SqliteOpenOptions {\n  readonly?: boolean;\n}\n\nexport interface SqliteRunResult {\n  changes: number;\n  lastInsertRowid: number | bigint;\n}\n\nexport interface SqliteStatement<TResult = unknown> {\n  run(...params: unknown[]): SqliteRunResult;\n  get(...params: unknown[]): TResult | undefined;\n  all(...params: unknown[]): TResult[];\n  iterate(...params: unknown[]): IterableIterator<TResult>;\n}\n\nexport interface SqliteDatabase {\n  readonly kind: SqliteRuntimeKind;\n  readonly native: unknown;\n  exec(sql: string): unknown;\n  pragma(pragma: string): unknown;\n  prepare<TResult = unknown>(sql: string): SqliteStatement<TResult>;\n  loadExtension(path: string): void;\n  transaction<TArgs extends unknown[], TResult>(fn: (...args: TArgs) => TResult): (...args: TArgs) => TResult;\n  close(): void;\n}\n\nexport interface SqliteRuntime {\n  readonly kind: SqliteRuntimeKind;\n  openDatabase(path: string, options?: SqliteOpenOptions): SqliteDatabase;\n  createDrizzleDatabase(database: SqliteDatabase): any;\n}\n"]}

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

@@ -23,6 +23,7 @@ export declare class PostgresVectorStore extends VectorStore implements Initiali
     private ensureOpen;
     private getDb;
     protected getTableName(modelId: string): string;
+    private getCountTableCandidates;
     ensureVectorTable(modelId: string): Promise<void>;
     dropVectorTable(modelId: string): Promise<void>;
     hasVectorTable(modelId: string): Promise<boolean>;

package/dist/storage/vector/PostgresVectorStore.js

@@ -60,6 +60,14 @@ class PostgresVectorStore extends VectorStore_1.VectorStore {
     getTableName(modelId) {
         return `quint_vec_${(0, VectorStore_1.hashModelId)(modelId)}`;
     }
+    getCountTableCandidates(modelIdOrTableName) {
+        const candidates = [];
+        if (modelIdOrTableName.startsWith('quint_vec_')) {
+            candidates.push(modelIdOrTableName);
+        }
+        candidates.push(this.getTableName(modelIdOrTableName));
+        return [...new Set(candidates)];
+    }
     // ============================================
     // 向量表管理
     // ============================================
@@ -219,16 +227,18 @@ class PostgresVectorStore extends VectorStore_1.VectorStore {
     // ============================================
     async countVectors(modelId) {
         await this.ensureOpen();
-        const tableName = this.getTableName(modelId);
-        try {
-            const result = await this.getDb().execute((0, drizzle_orm_1.sql) `
-        SELECT COUNT(*) as count FROM ${drizzle_orm_1.sql.identifier(tableName)}
-      `);
-            return parseInt(result.rows[0]?.count ?? '0', 10);
-        }
-        catch {
-            return 0;
+        for (const tableName of this.getCountTableCandidates(modelId)) {
+            try {
+                const result = await this.getDb().execute((0, drizzle_orm_1.sql) `
+          SELECT COUNT(*) as count FROM ${drizzle_orm_1.sql.identifier(tableName)}
+        `);
+                return parseInt(result.rows[0]?.count ?? '0', 10);
+            }
+            catch {
+                continue;
+            }
         }
+        return 0;
     }
     // ============================================
     // 迁移支持