@undefineds.co/xpod 0.1.0-local.202602081751

package/dist/storage/quint/PgQuintStore.drizzle.js

@@ -0,0 +1,327 @@
+"use strict";
+/**
+ * PgQuintStore - PostgreSQL implementation of QuintStore
+ *
+ * Features:
+ * - Full ACID transactions
+ * - Efficient graph prefix queries using btree index
+ * - Connection pooling via pg Pool
+ * - Vector embeddings stored as JSON
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PgQuintStore = void 0;
+const pg_1 = require("pg");
+const asynciterator_1 = require("asynciterator");
+const serialization_1 = require("./serialization");
+const types_1 = require("./types");
+class PgQuintStore {
+    constructor(options) {
+        this.pool = null;
+        this.options = options;
+    }
+    async open() {
+        const poolConfig = {
+            connectionString: this.options.connectionString,
+            max: this.options.poolMax ?? 20,
+            idleTimeoutMillis: this.options.poolIdleTimeoutMillis ?? 30000,
+            connectionTimeoutMillis: this.options.poolConnectionTimeoutMillis ?? 2000,
+        };
+        this.pool = new pg_1.Pool(poolConfig);
+        await this.pool.query(`
+      CREATE TABLE IF NOT EXISTS quints (
+        graph TEXT NOT NULL,
+        subject TEXT NOT NULL,
+        predicate TEXT NOT NULL,
+        object TEXT NOT NULL,
+        embedding TEXT,
+        PRIMARY KEY (graph, subject, predicate, object)
+      );
+
+      CREATE INDEX IF NOT EXISTS idx_pg_spog ON quints (subject, predicate, object, graph);
+      CREATE INDEX IF NOT EXISTS idx_pg_ogsp ON quints (object, graph, subject, predicate);
+      CREATE INDEX IF NOT EXISTS idx_pg_gspo ON quints (graph, subject, predicate, object);
+      CREATE INDEX IF NOT EXISTS idx_pg_sopg ON quints (subject, object, predicate, graph);
+      CREATE INDEX IF NOT EXISTS idx_pg_pogs ON quints (predicate, object, graph, subject);
+      CREATE INDEX IF NOT EXISTS idx_pg_gpos ON quints (graph, predicate, object, subject);
+      CREATE INDEX IF NOT EXISTS idx_pg_graph_prefix ON quints (graph text_pattern_ops);
+    `);
+    }
+    async close() {
+        if (this.pool) {
+            await this.pool.end();
+            this.pool = null;
+        }
+    }
+    async get(pattern, options) {
+        this.ensureOpen();
+        const { whereClause, params } = this.buildWhereClause(pattern);
+        let queryText = `SELECT graph, subject, predicate, object, embedding FROM quints`;
+        if (whereClause) {
+            queryText += ` WHERE ${whereClause}`;
+        }
+        if (options?.limit) {
+            queryText += ` LIMIT ${options.limit}`;
+        }
+        if (options?.offset) {
+            queryText += ` OFFSET ${options.offset}`;
+        }
+        const result = await this.pool.query(queryText, params);
+        return result.rows.map(row => this.rowToQuint(row));
+    }
+    match(subject, predicate, object, graph) {
+        const pattern = {};
+        if (subject)
+            pattern.subject = subject;
+        if (predicate)
+            pattern.predicate = predicate;
+        if (object)
+            pattern.object = object;
+        if (graph)
+            pattern.graph = graph;
+        return (0, asynciterator_1.wrap)(this.get(pattern));
+    }
+    async getByGraphPrefix(prefix, options) {
+        return this.get({ graph: { $startsWith: prefix } }, options);
+    }
+    async count(pattern) {
+        this.ensureOpen();
+        const { whereClause, params } = this.buildWhereClause(pattern);
+        let queryText = `SELECT count(*)::int as count FROM quints`;
+        if (whereClause) {
+            queryText += ` WHERE ${whereClause}`;
+        }
+        const result = await this.pool.query(queryText, params);
+        return result.rows[0]?.count ?? 0;
+    }
+    async put(quint) {
+        this.ensureOpen();
+        const row = this.quintToRow(quint);
+        await this.pool.query(`
+      INSERT INTO quints (graph, subject, predicate, object, embedding)
+      VALUES ($1, $2, $3, $4, $5)
+      ON CONFLICT (graph, subject, predicate, object)
+      DO UPDATE SET embedding = EXCLUDED.embedding
+    `, [row.graph, row.subject, row.predicate, row.object, row.embedding]);
+    }
+    async multiPut(quints) {
+        this.ensureOpen();
+        if (quints.length === 0)
+            return;
+        const client = await this.pool.connect();
+        try {
+            await client.query('BEGIN');
+            for (const quint of quints) {
+                const row = this.quintToRow(quint);
+                await client.query(`
+          INSERT INTO quints (graph, subject, predicate, object, embedding)
+          VALUES ($1, $2, $3, $4, $5)
+          ON CONFLICT (graph, subject, predicate, object)
+          DO UPDATE SET embedding = EXCLUDED.embedding
+        `, [row.graph, row.subject, row.predicate, row.object, row.embedding]);
+            }
+            await client.query('COMMIT');
+        }
+        catch (error) {
+            await client.query('ROLLBACK');
+            throw error;
+        }
+        finally {
+            client.release();
+        }
+    }
+    async updateEmbedding(pattern, embedding) {
+        this.ensureOpen();
+        const { whereClause, params } = this.buildWhereClause(pattern);
+        const embeddingJson = JSON.stringify(embedding);
+        let queryText = `UPDATE quints SET embedding = $${params.length + 1}`;
+        if (whereClause) {
+            queryText += ` WHERE ${whereClause}`;
+        }
+        const result = await this.pool.query(queryText, [...params, embeddingJson]);
+        return result.rowCount ?? 0;
+    }
+    async del(pattern) {
+        this.ensureOpen();
+        const { whereClause, params } = this.buildWhereClause(pattern);
+        let queryText = `DELETE FROM quints`;
+        if (whereClause) {
+            queryText += ` WHERE ${whereClause}`;
+        }
+        const result = await this.pool.query(queryText, params);
+        return result.rowCount ?? 0;
+    }
+    async multiDel(quints) {
+        this.ensureOpen();
+        if (quints.length === 0)
+            return;
+        const client = await this.pool.connect();
+        try {
+            await client.query('BEGIN');
+            for (const quint of quints) {
+                const g = (0, serialization_1.termToId)(quint.graph);
+                const s = (0, serialization_1.termToId)(quint.subject);
+                const p = (0, serialization_1.termToId)(quint.predicate);
+                const o = (0, serialization_1.serializeObject)(quint.object);
+                await client.query(`
+          DELETE FROM quints 
+          WHERE graph = $1 AND subject = $2 AND predicate = $3 AND object = $4
+        `, [g, s, p, o]);
+            }
+            await client.query('COMMIT');
+        }
+        catch (error) {
+            await client.query('ROLLBACK');
+            throw error;
+        }
+        finally {
+            client.release();
+        }
+    }
+    async stats() {
+        this.ensureOpen();
+        const totalResult = await this.pool.query(`SELECT count(*)::int as count FROM quints`);
+        const vectorResult = await this.pool.query(`SELECT count(*)::int as count FROM quints WHERE embedding IS NOT NULL`);
+        const graphResult = await this.pool.query(`SELECT COUNT(DISTINCT graph)::int as count FROM quints`);
+        return {
+            totalCount: totalResult.rows[0]?.count ?? 0,
+            vectorCount: vectorResult.rows[0]?.count ?? 0,
+            graphCount: graphResult.rows[0]?.count ?? 0,
+        };
+    }
+    async clear() {
+        this.ensureOpen();
+        await this.pool.query('DELETE FROM quints');
+    }
+    async optimize() {
+        this.ensureOpen();
+        await this.pool.query('VACUUM ANALYZE quints');
+    }
+    ensureOpen() {
+        if (!this.pool) {
+            throw new Error('Store not open. Call open() first.');
+        }
+    }
+    buildWhereClause(pattern) {
+        const conditions = [];
+        const params = [];
+        // Helper to serialize operator value
+        const serializeOpValue = (value, isObject) => {
+            if (typeof value === 'object' && 'termType' in value) {
+                return isObject ? (0, serialization_1.serializeObject)(value) : (0, serialization_1.termToId)(value);
+            }
+            if (typeof value === 'number') {
+                return String(value);
+            }
+            return value;
+        };
+        const addTermConditions = (column, match, isObject = false) => {
+            if (!match)
+                return;
+            if ((0, types_1.isTerm)(match)) {
+                // Exact Term match
+                params.push(isObject ? (0, serialization_1.serializeObject)(match) : (0, serialization_1.termToId)(match));
+                conditions.push(`${column} = $${params.length}`);
+            }
+            else {
+                // Operator match
+                const ops = match;
+                if (ops.$eq !== undefined) {
+                    params.push(serializeOpValue(ops.$eq, isObject));
+                    conditions.push(`${column} = $${params.length}`);
+                }
+                if (ops.$ne !== undefined) {
+                    params.push(serializeOpValue(ops.$ne, isObject));
+                    conditions.push(`${column} != $${params.length}`);
+                }
+                if (ops.$gt !== undefined) {
+                    params.push(serializeOpValue(ops.$gt, isObject));
+                    conditions.push(`${column} > $${params.length}`);
+                }
+                if (ops.$gte !== undefined) {
+                    params.push(serializeOpValue(ops.$gte, isObject));
+                    conditions.push(`${column} >= $${params.length}`);
+                }
+                if (ops.$lt !== undefined) {
+                    params.push(serializeOpValue(ops.$lt, isObject));
+                    conditions.push(`${column} < $${params.length}`);
+                }
+                if (ops.$lte !== undefined) {
+                    params.push(serializeOpValue(ops.$lte, isObject));
+                    conditions.push(`${column} <= $${params.length}`);
+                }
+                if (ops.$in !== undefined && ops.$in.length > 0) {
+                    const startIdx = params.length;
+                    for (const val of ops.$in) {
+                        params.push(serializeOpValue(val, isObject));
+                    }
+                    const inPlaceholders = ops.$in.map((_, i) => `$${startIdx + i + 1}`).join(', ');
+                    conditions.push(`${column} IN (${inPlaceholders})`);
+                }
+                if (ops.$notIn !== undefined && ops.$notIn.length > 0) {
+                    const startIdx = params.length;
+                    for (const val of ops.$notIn) {
+                        params.push(serializeOpValue(val, isObject));
+                    }
+                    const notInPlaceholders = ops.$notIn.map((_, i) => `$${startIdx + i + 1}`).join(', ');
+                    conditions.push(`${column} NOT IN (${notInPlaceholders})`);
+                }
+                if (ops.$startsWith !== undefined) {
+                    // Use range query for prefix matching (index-friendly)
+                    params.push(ops.$startsWith);
+                    params.push(ops.$startsWith + '\uffff');
+                    conditions.push(`${column} >= $${params.length - 1} AND ${column} < $${params.length}`);
+                }
+                if (ops.$endsWith !== undefined) {
+                    params.push(`%${ops.$endsWith}`);
+                    conditions.push(`${column} LIKE $${params.length}`);
+                }
+                if (ops.$contains !== undefined) {
+                    params.push(`%${ops.$contains}%`);
+                    conditions.push(`${column} LIKE $${params.length}`);
+                }
+                if (ops.$regex !== undefined) {
+                    params.push(ops.$regex);
+                    conditions.push(`${column} ~ $${params.length}`);
+                }
+                if (ops.$isNull === true) {
+                    conditions.push(`${column} IS NULL`);
+                }
+                if (ops.$isNull === false) {
+                    conditions.push(`${column} IS NOT NULL`);
+                }
+            }
+        };
+        addTermConditions('graph', pattern.graph);
+        addTermConditions('subject', pattern.subject);
+        addTermConditions('predicate', pattern.predicate);
+        addTermConditions('object', pattern.object, true);
+        return {
+            whereClause: conditions.length > 0 ? conditions.join(' AND ') : '',
+            params,
+        };
+    }
+    quintToRow(quint) {
+        return {
+            graph: (0, serialization_1.termToId)(quint.graph),
+            subject: (0, serialization_1.termToId)(quint.subject),
+            predicate: (0, serialization_1.termToId)(quint.predicate),
+            object: (0, serialization_1.serializeObject)(quint.object),
+            embedding: quint.vector ? JSON.stringify(quint.vector) : null,
+        };
+    }
+    rowToQuint(row) {
+        const quad = (0, serialization_1.rowToQuad)({
+            graph: row.graph,
+            subject: row.subject,
+            predicate: row.predicate,
+            object: row.object,
+        });
+        const quint = quad;
+        if (row.embedding) {
+            quint.vector = (0, serialization_1.parseVector)(row.embedding);
+        }
+        return quint;
+    }
+}
+exports.PgQuintStore = PgQuintStore;
+//# sourceMappingURL=PgQuintStore.drizzle.js.map

package/dist/storage/quint/PgQuintStore.drizzle.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"PgQuintStore.drizzle.js","sourceRoot":"","sources":["../../../src/storage/quint/PgQuintStore.drizzle.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * PgQuintStore - PostgreSQL implementation of QuintStore\n * \n * Features:\n * - Full ACID transactions\n * - Efficient graph prefix queries using btree index\n * - Connection pooling via pg Pool\n * - Vector embeddings stored as JSON\n */\n\nimport { Pool, type PoolConfig } from 'pg';\nimport { wrap, AsyncIterator } from 'asynciterator';\nimport type { Term } from '@rdfjs/types';\n\nimport { \n  rowToQuad, \n  parseVector,\n  termToId,\n  serializeObject,\n} from './serialization';\nimport type {\n  Quint,\n  QuintPattern,\n  QuintStore,\n  QuintStoreOptions,\n  QueryOptions,\n  StoreStats,\n  TermMatch,\n  TermOperators,\n} from './types';\nimport { isTerm } from './types';\n\nexport interface PgQuintStoreOptions extends QuintStoreOptions {\n  /** PostgreSQL connection string */\n  connectionString?: string;\n  /** Maximum number of connections in pool */\n  poolMax?: number;\n  /** Idle timeout in milliseconds */\n  poolIdleTimeoutMillis?: number;\n  /** Connection timeout in milliseconds */\n  poolConnectionTimeoutMillis?: number;\n}\n\ninterface DbRow {\n  graph: string;\n  subject: string;\n  predicate: string;\n  object: string;\n  embedding: string | null;\n}\n\nexport class PgQuintStore {\n  private pool: Pool | null = null;\n  private options: PgQuintStoreOptions;\n\n  constructor(options: PgQuintStoreOptions) {\n    this.options = options;\n  }\n\n  async open(): Promise<void> {\n    const poolConfig: PoolConfig = {\n      connectionString: this.options.connectionString,\n      max: this.options.poolMax ?? 20,\n      idleTimeoutMillis: this.options.poolIdleTimeoutMillis ?? 30000,\n      connectionTimeoutMillis: this.options.poolConnectionTimeoutMillis ?? 2000,\n    };\n\n    this.pool = new Pool(poolConfig);\n\n    await this.pool.query(`\n      CREATE TABLE IF NOT EXISTS quints (\n        graph TEXT NOT NULL,\n        subject TEXT NOT NULL,\n        predicate TEXT NOT NULL,\n        object TEXT NOT NULL,\n        embedding TEXT,\n        PRIMARY KEY (graph, subject, predicate, object)\n      );\n\n      CREATE INDEX IF NOT EXISTS idx_pg_spog ON quints (subject, predicate, object, graph);\n      CREATE INDEX IF NOT EXISTS idx_pg_ogsp ON quints (object, graph, subject, predicate);\n      CREATE INDEX IF NOT EXISTS idx_pg_gspo ON quints (graph, subject, predicate, object);\n      CREATE INDEX IF NOT EXISTS idx_pg_sopg ON quints (subject, object, predicate, graph);\n      CREATE INDEX IF NOT EXISTS idx_pg_pogs ON quints (predicate, object, graph, subject);\n      CREATE INDEX IF NOT EXISTS idx_pg_gpos ON quints (graph, predicate, object, subject);\n      CREATE INDEX IF NOT EXISTS idx_pg_graph_prefix ON quints (graph text_pattern_ops);\n    `);\n  }\n\n  async close(): Promise<void> {\n    if (this.pool) {\n      await this.pool.end();\n      this.pool = null;\n    }\n  }\n\n  async get(pattern: QuintPattern, options?: QueryOptions): Promise<Quint[]> {\n    this.ensureOpen();\n\n    const { whereClause, params } = this.buildWhereClause(pattern);\n    \n    let queryText = `SELECT graph, subject, predicate, object, embedding FROM quints`;\n    if (whereClause) {\n      queryText += ` WHERE ${whereClause}`;\n    }\n\n    if (options?.limit) {\n      queryText += ` LIMIT ${options.limit}`;\n    }\n    if (options?.offset) {\n      queryText += ` OFFSET ${options.offset}`;\n    }\n\n    const result = await this.pool!.query<DbRow>(queryText, params);\n    return result.rows.map(row => this.rowToQuint(row));\n  }\n\n  match(\n    subject?: Term | null,\n    predicate?: Term | null,\n    object?: Term | null,\n    graph?: Term | null,\n  ): AsyncIterator<Quint> {\n    const pattern: QuintPattern = {};\n    if (subject) pattern.subject = subject;\n    if (predicate) pattern.predicate = predicate;\n    if (object) pattern.object = object;\n    if (graph) pattern.graph = graph;\n\n    return wrap(this.get(pattern));\n  }\n\n  async getByGraphPrefix(prefix: string, options?: QueryOptions): Promise<Quint[]> {\n    return this.get({ graph: { $startsWith: prefix } }, options);\n  }\n\n  async count(pattern: QuintPattern): Promise<number> {\n    this.ensureOpen();\n\n    const { whereClause, params } = this.buildWhereClause(pattern);\n    \n    let queryText = `SELECT count(*)::int as count FROM quints`;\n    if (whereClause) {\n      queryText += ` WHERE ${whereClause}`;\n    }\n\n    const result = await this.pool!.query<{ count: number }>(queryText, params);\n    return result.rows[0]?.count ?? 0;\n  }\n\n  async put(quint: Quint): Promise<void> {\n    this.ensureOpen();\n\n    const row = this.quintToRow(quint);\n\n    await this.pool!.query(`\n      INSERT INTO quints (graph, subject, predicate, object, embedding)\n      VALUES ($1, $2, $3, $4, $5)\n      ON CONFLICT (graph, subject, predicate, object)\n      DO UPDATE SET embedding = EXCLUDED.embedding\n    `, [row.graph, row.subject, row.predicate, row.object, row.embedding]);\n  }\n\n  async multiPut(quints: Quint[]): Promise<void> {\n    this.ensureOpen();\n\n    if (quints.length === 0) return;\n\n    const client = await this.pool!.connect();\n    try {\n      await client.query('BEGIN');\n\n      for (const quint of quints) {\n        const row = this.quintToRow(quint);\n        await client.query(`\n          INSERT INTO quints (graph, subject, predicate, object, embedding)\n          VALUES ($1, $2, $3, $4, $5)\n          ON CONFLICT (graph, subject, predicate, object)\n          DO UPDATE SET embedding = EXCLUDED.embedding\n        `, [row.graph, row.subject, row.predicate, row.object, row.embedding]);\n      }\n\n      await client.query('COMMIT');\n    } catch (error) {\n      await client.query('ROLLBACK');\n      throw error;\n    } finally {\n      client.release();\n    }\n  }\n\n  async updateEmbedding(pattern: QuintPattern, embedding: number[]): Promise<number> {\n    this.ensureOpen();\n\n    const { whereClause, params } = this.buildWhereClause(pattern);\n    const embeddingJson = JSON.stringify(embedding);\n\n    let queryText = `UPDATE quints SET embedding = $${params.length + 1}`;\n    if (whereClause) {\n      queryText += ` WHERE ${whereClause}`;\n    }\n\n    const result = await this.pool!.query(queryText, [...params, embeddingJson]);\n    return result.rowCount ?? 0;\n  }\n\n  async del(pattern: QuintPattern): Promise<number> {\n    this.ensureOpen();\n\n    const { whereClause, params } = this.buildWhereClause(pattern);\n\n    let queryText = `DELETE FROM quints`;\n    if (whereClause) {\n      queryText += ` WHERE ${whereClause}`;\n    }\n\n    const result = await this.pool!.query(queryText, params);\n    return result.rowCount ?? 0;\n  }\n\n  async multiDel(quints: Quint[]): Promise<void> {\n    this.ensureOpen();\n\n    if (quints.length === 0) return;\n\n    const client = await this.pool!.connect();\n    try {\n      await client.query('BEGIN');\n\n      for (const quint of quints) {\n        const g = termToId(quint.graph as any);\n        const s = termToId(quint.subject as any);\n        const p = termToId(quint.predicate as any);\n        const o = serializeObject(quint.object as any);\n\n        await client.query(`\n          DELETE FROM quints \n          WHERE graph = $1 AND subject = $2 AND predicate = $3 AND object = $4\n        `, [g, s, p, o]);\n      }\n\n      await client.query('COMMIT');\n    } catch (error) {\n      await client.query('ROLLBACK');\n      throw error;\n    } finally {\n      client.release();\n    }\n  }\n\n  async stats(): Promise<StoreStats> {\n    this.ensureOpen();\n\n    const totalResult = await this.pool!.query<{ count: number }>(\n      `SELECT count(*)::int as count FROM quints`\n    );\n\n    const vectorResult = await this.pool!.query<{ count: number }>(\n      `SELECT count(*)::int as count FROM quints WHERE embedding IS NOT NULL`\n    );\n\n    const graphResult = await this.pool!.query<{ count: number }>(\n      `SELECT COUNT(DISTINCT graph)::int as count FROM quints`\n    );\n\n    return {\n      totalCount: totalResult.rows[0]?.count ?? 0,\n      vectorCount: vectorResult.rows[0]?.count ?? 0,\n      graphCount: graphResult.rows[0]?.count ?? 0,\n    };\n  }\n\n  async clear(): Promise<void> {\n    this.ensureOpen();\n    await this.pool!.query('DELETE FROM quints');\n  }\n\n  async optimize(): Promise<void> {\n    this.ensureOpen();\n    await this.pool!.query('VACUUM ANALYZE quints');\n  }\n\n  private ensureOpen(): void {\n    if (!this.pool) {\n      throw new Error('Store not open. Call open() first.');\n    }\n  }\n\n  private buildWhereClause(pattern: QuintPattern): { whereClause: string; params: (string | number | string[])[] } {\n    const conditions: string[] = [];\n    const params: (string | number | string[])[] = [];\n\n    // Helper to serialize operator value\n    const serializeOpValue = (value: any, isObject: boolean): string | number => {\n      if (typeof value === 'object' && 'termType' in value) {\n        return isObject ? serializeObject(value as any) : termToId(value as any);\n      }\n      if (typeof value === 'number') {\n        return String(value);\n      }\n      return value;\n    };\n\n    const addTermConditions = (column: string, match: TermMatch | undefined, isObject: boolean = false) => {\n      if (!match) return;\n\n      if (isTerm(match)) {\n        // Exact Term match\n        params.push(isObject ? serializeObject(match as any) : termToId(match as any));\n        conditions.push(`${column} = $${params.length}`);\n      } else {\n        // Operator match\n        const ops = match as TermOperators;\n\n        if (ops.$eq !== undefined) {\n          params.push(serializeOpValue(ops.$eq, isObject));\n          conditions.push(`${column} = $${params.length}`);\n        }\n        if (ops.$ne !== undefined) {\n          params.push(serializeOpValue(ops.$ne, isObject));\n          conditions.push(`${column} != $${params.length}`);\n        }\n        if (ops.$gt !== undefined) {\n          params.push(serializeOpValue(ops.$gt, isObject));\n          conditions.push(`${column} > $${params.length}`);\n        }\n        if (ops.$gte !== undefined) {\n          params.push(serializeOpValue(ops.$gte, isObject));\n          conditions.push(`${column} >= $${params.length}`);\n        }\n        if (ops.$lt !== undefined) {\n          params.push(serializeOpValue(ops.$lt, isObject));\n          conditions.push(`${column} < $${params.length}`);\n        }\n        if (ops.$lte !== undefined) {\n          params.push(serializeOpValue(ops.$lte, isObject));\n          conditions.push(`${column} <= $${params.length}`);\n        }\n        if (ops.$in !== undefined && ops.$in.length > 0) {\n          const startIdx = params.length;\n          for (const val of ops.$in) {\n            params.push(serializeOpValue(val, isObject));\n          }\n          const inPlaceholders = ops.$in.map((_, i) => `$${startIdx + i + 1}`).join(', ');\n          conditions.push(`${column} IN (${inPlaceholders})`);\n        }\n        if (ops.$notIn !== undefined && ops.$notIn.length > 0) {\n          const startIdx = params.length;\n          for (const val of ops.$notIn) {\n            params.push(serializeOpValue(val, isObject));\n          }\n          const notInPlaceholders = ops.$notIn.map((_, i) => `$${startIdx + i + 1}`).join(', ');\n          conditions.push(`${column} NOT IN (${notInPlaceholders})`);\n        }\n        if (ops.$startsWith !== undefined) {\n          // Use range query for prefix matching (index-friendly)\n          params.push(ops.$startsWith);\n          params.push(ops.$startsWith + '\\uffff');\n          conditions.push(`${column} >= $${params.length - 1} AND ${column} < $${params.length}`);\n        }\n        if (ops.$endsWith !== undefined) {\n          params.push(`%${ops.$endsWith}`);\n          conditions.push(`${column} LIKE $${params.length}`);\n        }\n        if (ops.$contains !== undefined) {\n          params.push(`%${ops.$contains}%`);\n          conditions.push(`${column} LIKE $${params.length}`);\n        }\n        if (ops.$regex !== undefined) {\n          params.push(ops.$regex);\n          conditions.push(`${column} ~ $${params.length}`);\n        }\n        if (ops.$isNull === true) {\n          conditions.push(`${column} IS NULL`);\n        }\n        if (ops.$isNull === false) {\n          conditions.push(`${column} IS NOT NULL`);\n        }\n      }\n    };\n\n    addTermConditions('graph', pattern.graph);\n    addTermConditions('subject', pattern.subject);\n    addTermConditions('predicate', pattern.predicate);\n    addTermConditions('object', pattern.object, true);\n\n    return {\n      whereClause: conditions.length > 0 ? conditions.join(' AND ') : '',\n      params,\n    };\n  }\n\n  private quintToRow(quint: Quint): DbRow {\n    return {\n      graph: termToId(quint.graph as any),\n      subject: termToId(quint.subject as any),\n      predicate: termToId(quint.predicate as any),\n      object: serializeObject(quint.object as any),\n      embedding: quint.vector ? JSON.stringify(quint.vector) : null,\n    };\n  }\n\n  private rowToQuint(row: DbRow): Quint {\n    const quad = rowToQuad({\n      graph: row.graph,\n      subject: row.subject,\n      predicate: row.predicate,\n      object: row.object,\n    });\n    const quint: Quint = quad as Quint;\n    if (row.embedding) {\n      quint.vector = parseVector(row.embedding);\n    }\n    return quint;\n  }\n}\n"]}

package/dist/storage/quint/PgQuintStore.js

@@ -0,0 +1,275 @@
+"use strict";
+/**
+ * PgQuintStore - PostgreSQL implementation of QuintStore
+ *
+ * 支持两种连接方式：
+ * - PGLite: 嵌入式 PostgreSQL，用于测试
+ * - pg (node-postgres): 真正的 PostgreSQL 连接，用于生产
+ *
+ * PostgreSQL 不支持 TEXT 字段中的 \0 (null) 字符，
+ * 所以我们需要对序列化的字符串进行转换。
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PgQuintStore = void 0;
+const pglite_1 = require("@electric-sql/pglite");
+const BaseQuintStore_1 = require("./BaseQuintStore");
+const PostgresPoolManager_1 = require("../database/PostgresPoolManager");
+/**
+ * PostgreSQL 兼容的分隔符
+ * 使用 Unicode 控制字符 U+001F (Unit Separator) 代替 \0
+ */
+const PG_SEP = '\u001f';
+/**
+ * 将使用 \0 分隔符的字符串转换为使用 PG_SEP 的字符串
+ */
+function toPgSafe(str) {
+    return str.replace(/\u0000/g, PG_SEP);
+}
+/**
+ * 将使用 PG_SEP 分隔符的字符串转换回使用 \0 的字符串
+ */
+function fromPgSafe(str) {
+    return str.replace(new RegExp(PG_SEP, 'g'), '\u0000');
+}
+/**
+ * PGLite 执行器
+ */
+class PgliteExecutor {
+    constructor(db) {
+        this.db = db;
+    }
+    async query(sql, params) {
+        const pgSql = this.convertPlaceholders(sql);
+        const safeParams = params?.map(p => typeof p === 'string' ? toPgSafe(p) : p);
+        const result = await this.db.query(pgSql, safeParams);
+        return result.rows.map(row => this.restoreRow(row));
+    }
+    async execute(sql, params) {
+        const pgSql = this.convertPlaceholders(sql);
+        const safeParams = params?.map(p => typeof p === 'string' ? toPgSafe(p) : p);
+        const result = await this.db.query(pgSql, safeParams);
+        return result.affectedRows ?? 0;
+    }
+    async executeInTransaction(statements) {
+        await this.db.query('BEGIN');
+        try {
+            for (const { sql, params } of statements) {
+                const pgSql = this.convertPlaceholders(sql);
+                const safeParams = params?.map(p => typeof p === 'string' ? toPgSafe(p) : p);
+                await this.db.query(pgSql, safeParams);
+            }
+            await this.db.query('COMMIT');
+        }
+        catch (error) {
+            await this.db.query('ROLLBACK');
+            throw error;
+        }
+    }
+    async exec(sql) {
+        await this.db.exec(sql);
+    }
+    convertPlaceholders(sql) {
+        let index = 0;
+        return sql.replace(/\?/g, () => `$${++index}`);
+    }
+    restoreRow(row) {
+        if (!row || typeof row !== 'object')
+            return row;
+        const result = {};
+        for (const [key, value] of Object.entries(row)) {
+            result[key] = typeof value === 'string' ? fromPgSafe(value) : value;
+        }
+        return result;
+    }
+}
+/**
+ * node-postgres 执行器（需要安装 pg 包）
+ */
+class PgExecutor {
+    constructor(pool) {
+        this.pool = pool;
+    }
+    async query(sql, params) {
+        const pgSql = this.convertPlaceholders(sql);
+        const safeParams = params?.map(p => typeof p === 'string' ? toPgSafe(p) : p);
+        console.log(`[PgExecutor] Query: ${pgSql.slice(0, 60)}...`);
+        const start = Date.now();
+        const result = await this.pool.query(pgSql, safeParams);
+        console.log(`[PgExecutor] Query done in ${Date.now() - start}ms, ${result.rows.length} rows`);
+        return result.rows.map((row) => this.restoreRow(row));
+    }
+    async execute(sql, params) {
+        const pgSql = this.convertPlaceholders(sql);
+        const safeParams = params?.map(p => typeof p === 'string' ? toPgSafe(p) : p);
+        const result = await this.pool.query(pgSql, safeParams);
+        return result.rowCount ?? 0;
+    }
+    async executeInTransaction(statements) {
+        console.log(`[PgExecutor] Getting connection from pool...`);
+        const start = Date.now();
+        const client = await this.pool.connect();
+        console.log(`[PgExecutor] Got connection in ${Date.now() - start}ms`);
+        try {
+            console.log(`[PgExecutor] BEGIN transaction`);
+            await client.query('BEGIN');
+            for (let i = 0; i < statements.length; i++) {
+                const { sql, params } = statements[i];
+                const pgSql = this.convertPlaceholders(sql);
+                const safeParams = params?.map(p => typeof p === 'string' ? toPgSafe(p) : p);
+                console.log(`[PgExecutor] Executing statement ${i + 1}/${statements.length}: ${pgSql.slice(0, 60)}...`);
+                await client.query(pgSql, safeParams);
+            }
+            console.log(`[PgExecutor] COMMIT transaction`);
+            await client.query('COMMIT');
+        }
+        catch (error) {
+            console.error(`[PgExecutor] Error, rolling back:`, error);
+            await client.query('ROLLBACK');
+            throw error;
+        }
+        finally {
+            console.log(`[PgExecutor] Releasing connection`);
+            client.release();
+        }
+    }
+    async exec(sql) {
+        await this.pool.query(sql);
+    }
+    convertPlaceholders(sql) {
+        let index = 0;
+        return sql.replace(/\?/g, () => `$${++index}`);
+    }
+    restoreRow(row) {
+        if (!row || typeof row !== 'object')
+            return row;
+        const result = {};
+        for (const [key, value] of Object.entries(row)) {
+            result[key] = typeof value === 'string' ? fromPgSafe(value) : value;
+        }
+        return result;
+    }
+}
+/**
+ * PostgreSQL QuintStore 实现
+ */
+class PgQuintStore extends BaseQuintStore_1.BaseQuintStore {
+    constructor(options) {
+        super(options);
+        this.pglite = null;
+        this.pgPool = null; // pg.Pool
+        this.pgOptions = {
+            driver: 'pglite', // 默认使用 PGLite
+            ...options,
+        };
+    }
+    async createExecutor() {
+        if (this.pgOptions.driver === 'pg') {
+            // 使用共享的连接池（如果提供），避免死锁
+            if (this.pgOptions.pool) {
+                this.pgPool = this.pgOptions.pool;
+                return new PgExecutor(this.pgPool);
+            }
+            // 使用共享连接池管理器，避免多个组件创建独立连接池
+            this.pgPool = (0, PostgresPoolManager_1.getSharedPool)({
+                connectionString: this.pgOptions.connectionString,
+                host: this.pgOptions.host,
+                port: this.pgOptions.port,
+                database: this.pgOptions.database,
+                user: this.pgOptions.user,
+                password: this.pgOptions.password,
+            });
+            return new PgExecutor(this.pgPool);
+        }
+        else {
+            // 使用 PGLite
+            this.pglite = new pglite_1.PGlite(this.pgOptions.dataDir);
+            await this.pglite.waitReady;
+            return new PgliteExecutor(this.pglite);
+        }
+    }
+    async closeExecutor() {
+        if (this.pglite) {
+            await this.pglite.close();
+            this.pglite = null;
+        }
+        if (this.pgPool) {
+            await this.pgPool.end();
+            this.pgPool = null;
+        }
+    }
+    /**
+     * 重写 open 方法，处理 PostgreSQL 特定的语法
+     */
+    async open() {
+        if (this.executor) {
+            return;
+        }
+        this.executor = await this.createExecutor();
+        // PostgreSQL 建表语法
+        await this.executor.exec(`
+      CREATE TABLE IF NOT EXISTS quints (
+        graph TEXT NOT NULL,
+        subject TEXT NOT NULL,
+        predicate TEXT NOT NULL,
+        object TEXT NOT NULL,
+        vector TEXT,
+        PRIMARY KEY (graph, subject, predicate, object)
+      )
+    `);
+        const indexes = [
+            'CREATE INDEX IF NOT EXISTS idx_spog ON quints (subject, predicate, object, graph)',
+            'CREATE INDEX IF NOT EXISTS idx_ogsp ON quints (object, graph, subject, predicate)',
+            'CREATE INDEX IF NOT EXISTS idx_gspo ON quints (graph, subject, predicate, object)',
+            'CREATE INDEX IF NOT EXISTS idx_sopg ON quints (subject, object, predicate, graph)',
+            'CREATE INDEX IF NOT EXISTS idx_pogs ON quints (predicate, object, graph, subject)',
+            'CREATE INDEX IF NOT EXISTS idx_gpos ON quints (graph, predicate, object, subject)',
+        ];
+        for (const indexSql of indexes) {
+            await this.executor.exec(indexSql);
+        }
+    }
+    /**
+     * 重写 put 方法，使用 PostgreSQL 的 ON CONFLICT
+     */
+    async put(quint) {
+        this.ensureOpen();
+        const row = this.quintToRow(quint);
+        // PostgreSQL UPSERT 语法
+        const sql = `
+      INSERT INTO quints (graph, subject, predicate, object, vector) 
+      VALUES ($1, $2, $3, $4, $5)
+      ON CONFLICT (graph, subject, predicate, object) 
+      DO UPDATE SET vector = EXCLUDED.vector
+    `;
+        await this.executor.execute(sql, [row.graph, row.subject, row.predicate, row.object, row.vector]);
+    }
+    /**
+     * 重写 multiPut 方法，使用 PostgreSQL 的 ON CONFLICT
+     */
+    async multiPut(quintList) {
+        console.log(`[PgQuintStore.multiPut] Starting: ${quintList.length} quints`);
+        this.ensureOpen();
+        if (quintList.length === 0) {
+            console.log(`[PgQuintStore.multiPut] Empty list, skipping`);
+            return;
+        }
+        const statements = quintList.map(quint => {
+            const row = this.quintToRow(quint);
+            return {
+                sql: `
+          INSERT INTO quints (graph, subject, predicate, object, vector) 
+          VALUES ($1, $2, $3, $4, $5)
+          ON CONFLICT (graph, subject, predicate, object) 
+          DO UPDATE SET vector = EXCLUDED.vector
+        `,
+                params: [row.graph, row.subject, row.predicate, row.object, row.vector],
+            };
+        });
+        console.log(`[PgQuintStore.multiPut] Executing ${statements.length} statements in transaction`);
+        const start = Date.now();
+        await this.executor.executeInTransaction(statements);
+        console.log(`[PgQuintStore.multiPut] Completed in ${Date.now() - start}ms`);
+    }
+}
+exports.PgQuintStore = PgQuintStore;
+//# sourceMappingURL=PgQuintStore.js.map