@undefineds.co/xpod 0.1.0-local.202602081751

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

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

package/dist/storage/quint/PgQuintStore.jsonld

@@ -0,0 +1,258 @@
+{
+  "@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/quint/PgQuintStore.jsonld#PgQuintStore",
+      "@type": "Class",
+      "requireElement": "PgQuintStore",
+      "extends": [
+        "undefineds:dist/storage/quint/BaseQuintStore.jsonld#BaseQuintStore"
+      ],
+      "comment": "PostgreSQL QuintStore 实现",
+      "parameters": [
+        {
+          "@id": "undefineds:dist/storage/quint/PgQuintStore.jsonld#PgQuintStore_options_driver",
+          "range": {
+            "@type": "ParameterRangeUnion",
+            "parameterRangeElements": [
+              {
+                "@type": "ParameterRangeLiteral",
+                "parameterRangeValueLiteral": "pglite"
+              },
+              {
+                "@type": "ParameterRangeLiteral",
+                "parameterRangeValueLiteral": "pg"
+              },
+              {
+                "@type": "ParameterRangeUndefined"
+              }
+            ]
+          },
+          "comment": "连接方式： - 'pglite': 使用 PGLite 嵌入式数据库（测试用） - 'pg': 使用 node-postgres 连接真正的 PostgreSQL（生产用）"
+        },
+        {
+          "@id": "undefineds:dist/storage/quint/PgQuintStore.jsonld#PgQuintStore_options_dataDir",
+          "range": {
+            "@type": "ParameterRangeUnion",
+            "parameterRangeElements": [
+              "xsd:string",
+              {
+                "@type": "ParameterRangeUndefined"
+              }
+            ]
+          },
+          "comment": "PGLite 数据目录，仅当 driver='pglite' 时使用"
+        },
+        {
+          "@id": "undefineds:dist/storage/quint/PgQuintStore.jsonld#PgQuintStore_options_connectionString",
+          "range": {
+            "@type": "ParameterRangeUnion",
+            "parameterRangeElements": [
+              "xsd:string",
+              {
+                "@type": "ParameterRangeUndefined"
+              }
+            ]
+          },
+          "comment": "PostgreSQL 连接字符串，仅当 driver='pg' 时使用"
+        },
+        {
+          "@id": "undefineds:dist/storage/quint/PgQuintStore.jsonld#PgQuintStore_options_host",
+          "range": {
+            "@type": "ParameterRangeUnion",
+            "parameterRangeElements": [
+              "xsd:string",
+              {
+                "@type": "ParameterRangeUndefined"
+              }
+            ]
+          },
+          "comment": "PostgreSQL 连接配置，仅当 driver='pg' 时使用"
+        },
+        {
+          "@id": "undefineds:dist/storage/quint/PgQuintStore.jsonld#PgQuintStore_options_port",
+          "range": {
+            "@type": "ParameterRangeUnion",
+            "parameterRangeElements": [
+              "xsd:number",
+              {
+                "@type": "ParameterRangeUndefined"
+              }
+            ]
+          }
+        },
+        {
+          "@id": "undefineds:dist/storage/quint/PgQuintStore.jsonld#PgQuintStore_options_database",
+          "range": {
+            "@type": "ParameterRangeUnion",
+            "parameterRangeElements": [
+              "xsd:string",
+              {
+                "@type": "ParameterRangeUndefined"
+              }
+            ]
+          }
+        },
+        {
+          "@id": "undefineds:dist/storage/quint/PgQuintStore.jsonld#PgQuintStore_options_user",
+          "range": {
+            "@type": "ParameterRangeUnion",
+            "parameterRangeElements": [
+              "xsd:string",
+              {
+                "@type": "ParameterRangeUndefined"
+              }
+            ]
+          }
+        },
+        {
+          "@id": "undefineds:dist/storage/quint/PgQuintStore.jsonld#PgQuintStore_options_password",
+          "range": {
+            "@type": "ParameterRangeUnion",
+            "parameterRangeElements": [
+              "xsd:string",
+              {
+                "@type": "ParameterRangeUndefined"
+              }
+            ]
+          }
+        },
+        {
+          "@id": "undefineds:dist/storage/quint/PgQuintStore.jsonld#PgQuintStore_options_pool",
+          "range": {
+            "@type": "ParameterRangeUnion",
+            "parameterRangeElements": [
+              {
+                "@type": "ParameterRangeWildcard"
+              },
+              {
+                "@type": "ParameterRangeUndefined"
+              }
+            ]
+          },
+          "comment": "共享的 pg Pool 实例（避免多个组件创建独立连接池导致死锁） 如果提供，将忽略其他连接配置"
+        },
+        {
+          "@id": "undefineds:dist/storage/quint/PgQuintStore.jsonld#PgQuintStore_options_debug",
+          "range": {
+            "@type": "ParameterRangeUnion",
+            "parameterRangeElements": [
+              "xsd:boolean",
+              {
+                "@type": "ParameterRangeUndefined"
+              }
+            ]
+          }
+        }
+      ],
+      "memberFields": [
+        {
+          "@id": "undefineds:dist/storage/quint/PgQuintStore.jsonld#PgQuintStore__member_pglite",
+          "memberFieldName": "pglite"
+        },
+        {
+          "@id": "undefineds:dist/storage/quint/PgQuintStore.jsonld#PgQuintStore__member_pgPool",
+          "memberFieldName": "pgPool"
+        },
+        {
+          "@id": "undefineds:dist/storage/quint/PgQuintStore.jsonld#PgQuintStore__member_pgOptions",
+          "memberFieldName": "pgOptions"
+        },
+        {
+          "@id": "undefineds:dist/storage/quint/PgQuintStore.jsonld#PgQuintStore__member_constructor",
+          "memberFieldName": "constructor"
+        },
+        {
+          "@id": "undefineds:dist/storage/quint/PgQuintStore.jsonld#PgQuintStore__member_createExecutor",
+          "memberFieldName": "createExecutor"
+        },
+        {
+          "@id": "undefineds:dist/storage/quint/PgQuintStore.jsonld#PgQuintStore__member_closeExecutor",
+          "memberFieldName": "closeExecutor"
+        },
+        {
+          "@id": "undefineds:dist/storage/quint/PgQuintStore.jsonld#PgQuintStore__member_open",
+          "memberFieldName": "open"
+        },
+        {
+          "@id": "undefineds:dist/storage/quint/PgQuintStore.jsonld#PgQuintStore__member_put",
+          "memberFieldName": "put"
+        },
+        {
+          "@id": "undefineds:dist/storage/quint/PgQuintStore.jsonld#PgQuintStore__member_multiPut",
+          "memberFieldName": "multiPut"
+        }
+      ],
+      "constructorArguments": [
+        {
+          "@id": "undefineds:dist/storage/quint/PgQuintStore.jsonld#PgQuintStore_options__constructorArgument",
+          "fields": [
+            {
+              "keyRaw": "driver",
+              "value": {
+                "@id": "undefineds:dist/storage/quint/PgQuintStore.jsonld#PgQuintStore_options_driver"
+              }
+            },
+            {
+              "keyRaw": "dataDir",
+              "value": {
+                "@id": "undefineds:dist/storage/quint/PgQuintStore.jsonld#PgQuintStore_options_dataDir"
+              }
+            },
+            {
+              "keyRaw": "connectionString",
+              "value": {
+                "@id": "undefineds:dist/storage/quint/PgQuintStore.jsonld#PgQuintStore_options_connectionString"
+              }
+            },
+            {
+              "keyRaw": "host",
+              "value": {
+                "@id": "undefineds:dist/storage/quint/PgQuintStore.jsonld#PgQuintStore_options_host"
+              }
+            },
+            {
+              "keyRaw": "port",
+              "value": {
+                "@id": "undefineds:dist/storage/quint/PgQuintStore.jsonld#PgQuintStore_options_port"
+              }
+            },
+            {
+              "keyRaw": "database",
+              "value": {
+                "@id": "undefineds:dist/storage/quint/PgQuintStore.jsonld#PgQuintStore_options_database"
+              }
+            },
+            {
+              "keyRaw": "user",
+              "value": {
+                "@id": "undefineds:dist/storage/quint/PgQuintStore.jsonld#PgQuintStore_options_user"
+              }
+            },
+            {
+              "keyRaw": "password",
+              "value": {
+                "@id": "undefineds:dist/storage/quint/PgQuintStore.jsonld#PgQuintStore_options_password"
+              }
+            },
+            {
+              "keyRaw": "pool",
+              "value": {
+                "@id": "undefineds:dist/storage/quint/PgQuintStore.jsonld#PgQuintStore_options_pool"
+              }
+            },
+            {
+              "keyRaw": "debug",
+              "value": {
+                "@id": "undefineds:dist/storage/quint/PgQuintStore.jsonld#PgQuintStore_options_debug"
+              }
+            }
+          ]
+        }
+      ]
+    }
+  ]
+}

package/dist/storage/quint/SqliteQuintStore.d.ts

@@ -0,0 +1,55 @@
+/**
+ * SqliteQuintStore - SQLite implementation of QuintStore using Drizzle ORM
+ */
+import { AsyncIterator } from 'asynciterator';
+import type { Term } from '@rdfjs/types';
+import type { Quint, QuintPattern, QuintStoreOptions, QueryOptions, StoreStats, CompoundPattern, CompoundResult } from './types';
+export interface SqliteQuintStoreOptions extends QuintStoreOptions {
+    /** SQLite database file path, use ':memory:' for in-memory database */
+    path: string;
+}
+export declare class SqliteQuintStore {
+    private sqlite;
+    private db;
+    private options;
+    constructor(options: SqliteQuintStoreOptions);
+    open(): Promise<void>;
+    close(): Promise<void>;
+    get(pattern: QuintPattern, options?: QueryOptions): Promise<Quint[]>;
+    match(subject?: Term | null, predicate?: Term | null, object?: Term | null, graph?: Term | null): AsyncIterator<Quint>;
+    getByGraphPrefix(prefix: string, options?: QueryOptions): Promise<Quint[]>;
+    count(pattern: QuintPattern): Promise<number>;
+    /**
+     * Compound query - multiple patterns JOINed by a common field
+     * This executes a single SQL query with JOINs, letting SQLite optimize the execution plan
+     */
+    getCompound(compound: CompoundPattern, options?: QueryOptions): Promise<CompoundResult[]>;
+    /**
+     * 批量获取多个 subject 的多个属性
+     *
+     * 用于优化 OPTIONAL 查询：避免每个 OPTIONAL 变成一次 LEFT JOIN
+     *
+     * SQL: SELECT subject, predicate, object FROM quints
+     *      WHERE subject IN (...) AND predicate IN (...)
+     */
+    getAttributes(subjects: string[], predicates: string[], graph?: Term): Promise<Map<string, Map<string, Term[]>>>;
+    /**
+     * Build SQL for compound query with JOINs
+     */
+    private buildCompoundSQL;
+    /**
+     * Build WHERE conditions for a specific table alias
+     */
+    private buildConditionsForAlias;
+    put(quint: Quint): Promise<void>;
+    multiPut(quintList: Quint[]): Promise<void>;
+    updateEmbedding(pattern: QuintPattern, embedding: number[]): Promise<number>;
+    del(pattern: QuintPattern): Promise<number>;
+    multiDel(quintList: Quint[]): Promise<void>;
+    stats(): Promise<StoreStats>;
+    clear(): Promise<void>;
+    private ensureOpen;
+    private buildConditions;
+    private quintToRow;
+    private rowToQuint;
+}