@nicia-ai/typegraph 0.4.0 → 0.6.0

package/README.md

@@ -19,7 +19,7 @@ import Database from "better-sqlite3";
 import { drizzle } from "drizzle-orm/better-sqlite3";
 
 import { createStore, defineEdge, defineGraph, defineNode } from "@nicia-ai/typegraph";
-import { createSqliteBackend, getSqliteMigrationSQL } from "@nicia-ai/typegraph/sqlite";
+import { createSqliteBackend, generateSqliteMigrationSQL } from "@nicia-ai/typegraph/sqlite";
 
 const Person = defineNode("Person", { schema: z.object({ name: z.string() }) });
 const knows = defineEdge("knows");
@@ -32,7 +32,7 @@ const graph = defineGraph({
 
 const sqlite = new Database(":memory:");
 const db = drizzle(sqlite);
-sqlite.exec(getSqliteMigrationSQL());
+sqlite.exec(generateSqliteMigrationSQL());
 
 const backend = createSqliteBackend(db);
 const store = createStore(graph, backend);

package/dist/{ast-CXFx6bF6.d.ts → ast-CG87Zr6p.d.ts}

@@ -1,4 +1,4 @@
-import { T as TemporalMode } from './types-DTJEu_-h.js';
+import { T as TemporalMode } from './types-DolHw9pJ.js';
 
 declare const MAX_JSON_POINTER_DEPTH: 5;
 type JsonPointer = string & {
@@ -441,4 +441,4 @@ type SetOperation = Readonly<{
  */
 type ComposableQuery = QueryAst | SetOperation;
 
-export { type AggregateExpr as A, type ComparisonOp as C, type FieldRef as F, type GroupBySpec as G, type JsonPointer as J, MAX_JSON_POINTER_DEPTH as M, type NodePredicate as N, type OrderSpec as O, type ParameterRef as P, type QueryAst as Q, type ResolveJsonPointer as R, type SortDirection as S, type TraversalExpansion as T, type ValueType as V, type JsonPointerFor as a, type JsonPointerSegmentsFor as b, type AggregateComparisonPredicate as c, type JsonPointerInput as d, type JsonPointerSegment as e, type JsonPointerSegments as f, type ResolveJsonPointerSegments as g, jsonPointer as h, type PredicateExpression as i, joinJsonPointers as j, type VectorMetricType as k, type Traversal as l, type ProjectedField as m, normalizeJsonPointer as n, type RecursiveCyclePolicy as o, parseJsonPointer as p, type TraversalDirection as q, type SelectiveField as r, type ComposableQuery as s, type SetOperationType as t, type SetOperation as u };
+export { type AggregateExpr as A, type ComparisonOp as C, type FieldRef as F, type GroupBySpec as G, type JsonPointer as J, MAX_JSON_POINTER_DEPTH as M, type NodePredicate as N, type OrderSpec as O, type ParameterRef as P, type QueryAst as Q, type ResolveJsonPointer as R, type SortDirection as S, type TraversalExpansion as T, type ValueType as V, type AggregateComparisonPredicate as a, type JsonPointerFor as b, type JsonPointerInput as c, type JsonPointerSegment as d, type JsonPointerSegments as e, type JsonPointerSegmentsFor as f, type ResolveJsonPointerSegments as g, jsonPointer as h, type PredicateExpression as i, joinJsonPointers as j, type VectorMetricType as k, type Traversal as l, type ProjectedField as m, normalizeJsonPointer as n, type RecursiveCyclePolicy as o, parseJsonPointer as p, type TraversalDirection as q, type SelectiveField as r, type ComposableQuery as s, type SetOperationType as t, type SetOperation as u };

package/dist/{ast-D-3bOanX.d.cts → ast-Cq9qrnNP.d.cts}

@@ -1,4 +1,4 @@
-import { T as TemporalMode } from './types-DTJEu_-h.cjs';
+import { T as TemporalMode } from './types-DolHw9pJ.cjs';
 
 declare const MAX_JSON_POINTER_DEPTH: 5;
 type JsonPointer = string & {
@@ -441,4 +441,4 @@ type SetOperation = Readonly<{
  */
 type ComposableQuery = QueryAst | SetOperation;
 
-export { type AggregateExpr as A, type ComparisonOp as C, type FieldRef as F, type GroupBySpec as G, type JsonPointer as J, MAX_JSON_POINTER_DEPTH as M, type NodePredicate as N, type OrderSpec as O, type ParameterRef as P, type QueryAst as Q, type ResolveJsonPointer as R, type SortDirection as S, type TraversalExpansion as T, type ValueType as V, type JsonPointerFor as a, type JsonPointerSegmentsFor as b, type AggregateComparisonPredicate as c, type JsonPointerInput as d, type JsonPointerSegment as e, type JsonPointerSegments as f, type ResolveJsonPointerSegments as g, jsonPointer as h, type PredicateExpression as i, joinJsonPointers as j, type VectorMetricType as k, type Traversal as l, type ProjectedField as m, normalizeJsonPointer as n, type RecursiveCyclePolicy as o, parseJsonPointer as p, type TraversalDirection as q, type SelectiveField as r, type ComposableQuery as s, type SetOperationType as t, type SetOperation as u };
+export { type AggregateExpr as A, type ComparisonOp as C, type FieldRef as F, type GroupBySpec as G, type JsonPointer as J, MAX_JSON_POINTER_DEPTH as M, type NodePredicate as N, type OrderSpec as O, type ParameterRef as P, type QueryAst as Q, type ResolveJsonPointer as R, type SortDirection as S, type TraversalExpansion as T, type ValueType as V, type AggregateComparisonPredicate as a, type JsonPointerFor as b, type JsonPointerInput as c, type JsonPointerSegment as d, type JsonPointerSegments as e, type JsonPointerSegmentsFor as f, type ResolveJsonPointerSegments as g, jsonPointer as h, type PredicateExpression as i, joinJsonPointers as j, type VectorMetricType as k, type Traversal as l, type ProjectedField as m, normalizeJsonPointer as n, type RecursiveCyclePolicy as o, parseJsonPointer as p, type TraversalDirection as q, type SelectiveField as r, type ComposableQuery as s, type SetOperationType as t, type SetOperation as u };

package/dist/backend/postgres/index.cjs

@@ -1,56 +1,328 @@
 'use strict';
 
-var chunkUYMT4LO2_cjs = require('../../chunk-UYMT4LO2.cjs');
-var chunkLUARLSYT_cjs = require('../../chunk-LUARLSYT.cjs');
-require('../../chunk-7RVSDXT3.cjs');
-require('../../chunk-XZL6MCZJ.cjs');
-var chunkNU2XNMVI_cjs = require('../../chunk-NU2XNMVI.cjs');
+var chunk23NGZHUN_cjs = require('../../chunk-23NGZHUN.cjs');
 require('../../chunk-44SXEVF4.cjs');
 require('../../chunk-JQDWEX6V.cjs');
 require('../../chunk-2WVFEIHR.cjs');
 require('../../chunk-P5CNM325.cjs');
+var drizzleOrm = require('drizzle-orm');
 
+// src/backend/drizzle/execution/postgres-execution.ts
+function resolvePgClient(db) {
+  const databaseWithClient = db;
+  const pgClient = databaseWithClient.$client;
+  if (pgClient?.query === void 0) {
+    return void 0;
+  }
+  return pgClient;
+}
+async function executeDrizzleQuery(db, query) {
+  const result = await db.execute(query);
+  return result.rows;
+}
+function createPgPreparedStatement(pgClient, sqlText) {
+  return {
+    async execute(params) {
+      const result = await pgClient.query(sqlText, params);
+      return result.rows;
+    }
+  };
+}
+function createPostgresExecutionAdapter(db) {
+  const pgClient = resolvePgClient(db);
+  function compile(query) {
+    return chunk23NGZHUN_cjs.compileQueryWithDialect(db, query, "PostgreSQL");
+  }
+  if (pgClient === void 0) {
+    return {
+      compile,
+      async execute(query) {
+        return executeDrizzleQuery(db, query);
+      }
+    };
+  }
+  const pgQueryClient = pgClient;
+  async function executeCompiled(compiledQuery) {
+    const result = await pgQueryClient.query(
+      compiledQuery.sql,
+      compiledQuery.params
+    );
+    return result.rows;
+  }
+  return {
+    compile,
+    async execute(query) {
+      return executeDrizzleQuery(db, query);
+    },
+    executeCompiled,
+    prepare(sqlText) {
+      return createPgPreparedStatement(pgQueryClient, sqlText);
+    }
+  };
+}
 
+// src/backend/drizzle/postgres.ts
+var POSTGRES_MAX_BIND_PARAMETERS = 65535;
+var NODE_INSERT_PARAM_COUNT = 9;
+var EDGE_INSERT_PARAM_COUNT = 12;
+var POSTGRES_NODE_INSERT_BATCH_SIZE = Math.max(
+  1,
+  Math.floor(POSTGRES_MAX_BIND_PARAMETERS / NODE_INSERT_PARAM_COUNT)
+);
+var POSTGRES_EDGE_INSERT_BATCH_SIZE = Math.max(
+  1,
+  Math.floor(POSTGRES_MAX_BIND_PARAMETERS / EDGE_INSERT_PARAM_COUNT)
+);
+var POSTGRES_GET_NODES_ID_CHUNK_SIZE = Math.max(
+  1,
+  POSTGRES_MAX_BIND_PARAMETERS - 2
+);
+var POSTGRES_GET_EDGES_ID_CHUNK_SIZE = Math.max(
+  1,
+  POSTGRES_MAX_BIND_PARAMETERS - 1
+);
+var toNodeRow = chunk23NGZHUN_cjs.createNodeRowMapper(chunk23NGZHUN_cjs.POSTGRES_ROW_MAPPER_CONFIG);
+var toEdgeRow = chunk23NGZHUN_cjs.createEdgeRowMapper(chunk23NGZHUN_cjs.POSTGRES_ROW_MAPPER_CONFIG);
+var toUniqueRow = chunk23NGZHUN_cjs.createUniqueRowMapper(chunk23NGZHUN_cjs.POSTGRES_ROW_MAPPER_CONFIG);
+var toSchemaVersionRow = chunk23NGZHUN_cjs.createSchemaVersionRowMapper(chunk23NGZHUN_cjs.POSTGRES_ROW_MAPPER_CONFIG);
+function toEmbeddingRow(row) {
+  let embedding;
+  if (typeof row.embedding === "string") {
+    const content = row.embedding.slice(1, -1);
+    embedding = content === "" ? [] : content.split(",").map((s) => Number.parseFloat(s.trim()));
+  } else if (Array.isArray(row.embedding)) {
+    embedding = row.embedding;
+  } else {
+    embedding = [];
+  }
+  return {
+    graph_id: row.graph_id,
+    node_kind: row.node_kind,
+    node_id: row.node_id,
+    field_path: row.field_path,
+    embedding,
+    dimensions: row.dimensions,
+    created_at: chunk23NGZHUN_cjs.formatPostgresTimestamp(row.created_at) ?? "",
+    updated_at: chunk23NGZHUN_cjs.formatPostgresTimestamp(row.updated_at) ?? ""
+  };
+}
+var POSTGRES_VECTOR_CAPABILITIES = {
+  ...chunk23NGZHUN_cjs.POSTGRES_CAPABILITIES,
+  vector: {
+    supported: true,
+    metrics: ["cosine", "l2", "inner_product"],
+    indexTypes: ["hnsw", "ivfflat", "none"],
+    maxDimensions: 16e3
+    // pgvector limit
+  }
+};
+function createPostgresBackend(db, options = {}) {
+  const tables2 = options.tables ?? chunk23NGZHUN_cjs.tables2;
+  const executionAdapter = createPostgresExecutionAdapter(db);
+  const tableNames = {
+    nodes: drizzleOrm.getTableName(tables2.nodes),
+    edges: drizzleOrm.getTableName(tables2.edges),
+    embeddings: drizzleOrm.getTableName(tables2.embeddings)
+  };
+  const operationStrategy = chunk23NGZHUN_cjs.createPostgresOperationStrategy(tables2);
+  const operations = createPostgresOperationBackend({
+    db,
+    executionAdapter,
+    operationStrategy,
+    tableNames
+  });
+  const backend = {
+    ...operations,
+    async setActiveSchema(graphId, version) {
+      await backend.transaction(async (txBackend) => {
+        await txBackend.setActiveSchema(graphId, version);
+      });
+    },
+    async transaction(fn, options2) {
+      const txConfig = options2?.isolationLevel ? {
+        isolationLevel: options2.isolationLevel.replace("_", " ")
+      } : void 0;
+      return db.transaction(async (tx) => {
+        const txBackend = createTransactionBackend({
+          db: tx,
+          operationStrategy,
+          tableNames
+        });
+        return fn(txBackend);
+      }, txConfig);
+    },
+    async close() {
+    }
+  };
+  return backend;
+}
+function createPostgresOperationBackend(options) {
+  const { db, executionAdapter, operationStrategy, tableNames } = options;
+  async function execAll(query) {
+    const result = await db.execute(query);
+    return result.rows;
+  }
+  async function execGet(query) {
+    const result = await db.execute(query);
+    return result.rows[0];
+  }
+  async function execRun(query) {
+    await db.execute(query);
+  }
+  const commonBackend = chunk23NGZHUN_cjs.createCommonOperationBackend({
+    batchConfig: {
+      edgeInsertBatchSize: POSTGRES_EDGE_INSERT_BATCH_SIZE,
+      getEdgesChunkSize: POSTGRES_GET_EDGES_ID_CHUNK_SIZE,
+      getNodesChunkSize: POSTGRES_GET_NODES_ID_CHUNK_SIZE,
+      nodeInsertBatchSize: POSTGRES_NODE_INSERT_BATCH_SIZE
+    },
+    execution: {
+      execAll,
+      execGet,
+      execRun
+    },
+    nowIso: chunk23NGZHUN_cjs.nowIso,
+    operationStrategy,
+    rowMappers: {
+      toEdgeRow,
+      toNodeRow,
+      toSchemaVersionRow,
+      toUniqueRow
+    }
+  });
+  const executeCompiled = executionAdapter.executeCompiled;
+  const executeRawMethod = executeCompiled === void 0 ? {} : {
+    async executeRaw(sqlText, params) {
+      return executeCompiled({ params, sql: sqlText });
+    }
+  };
+  const operationBackend = {
+    ...commonBackend,
+    ...executeRawMethod,
+    capabilities: POSTGRES_VECTOR_CAPABILITIES,
+    dialect: "postgres",
+    tableNames,
+    // === Embedding Operations ===
+    async upsertEmbedding(params) {
+      const timestamp = chunk23NGZHUN_cjs.nowIso();
+      const query = operationStrategy.buildUpsertEmbedding(params, timestamp);
+      await execRun(query);
+    },
+    async deleteEmbedding(params) {
+      const query = operationStrategy.buildDeleteEmbedding(params);
+      await execRun(query);
+    },
+    async getEmbedding(graphId, nodeKind, nodeId, fieldPath) {
+      const query = operationStrategy.buildGetEmbedding(
+        graphId,
+        nodeKind,
+        nodeId,
+        fieldPath
+      );
+      const row = await execGet(query);
+      return row ? toEmbeddingRow(row) : void 0;
+    },
+    async vectorSearch(params) {
+      const query = operationStrategy.buildVectorSearch(params);
+      const rows = await execAll(query);
+      return rows.map((row) => ({
+        nodeId: row.node_id,
+        score: row.score
+      }));
+    },
+    async createVectorIndex(params) {
+      const indexOptions = {
+        graphId: params.graphId,
+        nodeKind: params.nodeKind,
+        fieldPath: params.fieldPath,
+        dimensions: params.dimensions,
+        embeddingsTableName: tableNames.embeddings,
+        indexType: params.indexType,
+        metric: params.metric,
+        ...params.indexParams?.m === void 0 ? {} : { hnswM: params.indexParams.m },
+        ...params.indexParams?.efConstruction === void 0 ? {} : { hnswEfConstruction: params.indexParams.efConstruction },
+        ...params.indexParams?.lists === void 0 ? {} : { ivfflatLists: params.indexParams.lists }
+      };
+      const result = await chunk23NGZHUN_cjs.createPostgresVectorIndex(db, indexOptions);
+      if (!result.success) {
+        throw new Error(
+          result.message ?? "Failed to create PostgreSQL vector index"
+        );
+      }
+    },
+    async dropVectorIndex(params) {
+      const metrics = POSTGRES_VECTOR_CAPABILITIES.vector?.metrics ?? ["cosine"];
+      for (const metric of metrics) {
+        const indexName = chunk23NGZHUN_cjs.generateVectorIndexName(
+          params.graphId,
+          params.nodeKind,
+          params.fieldPath,
+          metric
+        );
+        const result = await chunk23NGZHUN_cjs.dropPostgresVectorIndex(db, indexName);
+        if (!result.success) {
+          throw new Error(
+            result.message ?? "Failed to drop PostgreSQL vector index"
+          );
+        }
+      }
+    },
+    // === Query Execution ===
+    async execute(query) {
+      return executionAdapter.execute(query);
+    },
+    compileSql(query) {
+      return executionAdapter.compile(query);
+    }
+  };
+  return operationBackend;
+}
+function createTransactionBackend(options) {
+  const txExecutionAdapter = options.executionAdapter ?? createPostgresExecutionAdapter(options.db);
+  return createPostgresOperationBackend({
+    db: options.db,
+    executionAdapter: txExecutionAdapter,
+    operationStrategy: options.operationStrategy,
+    tableNames: options.tableNames
+  });
+}
 
-Object.defineProperty(exports, "generatePostgresDDL", {
-  enumerable: true,
-  get: function () { return chunkUYMT4LO2_cjs.generatePostgresDDL; }
-});
-Object.defineProperty(exports, "getPostgresMigrationSQL", {
+Object.defineProperty(exports, "createPostgresTables", {
   enumerable: true,
-  get: function () { return chunkUYMT4LO2_cjs.getPostgresMigrationSQL; }
+  get: function () { return chunk23NGZHUN_cjs.createPostgresTables; }
 });
-Object.defineProperty(exports, "createPostgresBackend", {
+Object.defineProperty(exports, "edges", {
   enumerable: true,
-  get: function () { return chunkLUARLSYT_cjs.createPostgresBackend; }
+  get: function () { return chunk23NGZHUN_cjs.edges2; }
 });
-Object.defineProperty(exports, "createPostgresTables", {
+Object.defineProperty(exports, "embeddings", {
   enumerable: true,
-  get: function () { return chunkNU2XNMVI_cjs.createPostgresTables; }
+  get: function () { return chunk23NGZHUN_cjs.embeddings2; }
 });
-Object.defineProperty(exports, "edges", {
+Object.defineProperty(exports, "generatePostgresDDL", {
   enumerable: true,
-  get: function () { return chunkNU2XNMVI_cjs.edges; }
+  get: function () { return chunk23NGZHUN_cjs.generatePostgresDDL; }
 });
-Object.defineProperty(exports, "embeddings", {
+Object.defineProperty(exports, "generatePostgresMigrationSQL", {
   enumerable: true,
-  get: function () { return chunkNU2XNMVI_cjs.embeddings; }
+  get: function () { return chunk23NGZHUN_cjs.generatePostgresMigrationSQL; }
 });
 Object.defineProperty(exports, "nodes", {
   enumerable: true,
-  get: function () { return chunkNU2XNMVI_cjs.nodes; }
+  get: function () { return chunk23NGZHUN_cjs.nodes2; }
 });
 Object.defineProperty(exports, "schemaVersions", {
   enumerable: true,
-  get: function () { return chunkNU2XNMVI_cjs.schemaVersions; }
+  get: function () { return chunk23NGZHUN_cjs.schemaVersions2; }
 });
 Object.defineProperty(exports, "tables", {
   enumerable: true,
-  get: function () { return chunkNU2XNMVI_cjs.tables; }
+  get: function () { return chunk23NGZHUN_cjs.tables2; }
 });
 Object.defineProperty(exports, "uniques", {
   enumerable: true,
-  get: function () { return chunkNU2XNMVI_cjs.uniques; }
+  get: function () { return chunk23NGZHUN_cjs.uniques2; }
 });
+exports.createPostgresBackend = createPostgresBackend;
 //# sourceMappingURL=index.cjs.map
 //# sourceMappingURL=index.cjs.map

package/dist/backend/postgres/index.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":[],"names":[],"mappings":"","file":"index.cjs"}
+{"version":3,"sources":["../../../src/backend/drizzle/execution/postgres-execution.ts","../../../src/backend/drizzle/postgres.ts"],"names":["compileQueryWithDialect","createNodeRowMapper","POSTGRES_ROW_MAPPER_CONFIG","createEdgeRowMapper","createUniqueRowMapper","createSchemaVersionRowMapper","formatPostgresTimestamp","POSTGRES_CAPABILITIES","tables","getTableName","createPostgresOperationStrategy","options","createCommonOperationBackend","nowIso","createPostgresVectorIndex","generateVectorIndexName","dropPostgresVectorIndex"],"mappings":"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","file":"index.cjs","sourcesContent":["import { type SQL } from \"drizzle-orm\";\nimport { type PgDatabase, type PgQueryResultHKT } from \"drizzle-orm/pg-core\";\n\nimport {\n  type CompiledSqlQuery,\n  compileQueryWithDialect,\n  type PreparedSqlStatement,\n  type SqlExecutionAdapter,\n} from \"./types\";\n\ntype PgQueryResult = Readonly<{\n  rows: readonly unknown[];\n}>;\n\ntype PgQueryClient = Readonly<{\n  query: (sqlText: string, params: readonly unknown[]) => Promise<PgQueryResult>;\n}>;\n\ntype PgClientCarrier = Readonly<{\n  $client?: PgQueryClient;\n}>;\n\nexport type AnyPgDatabase = PgDatabase<PgQueryResultHKT, Record<string, unknown>>;\n\nexport type PostgresExecutionAdapter = SqlExecutionAdapter;\n\nfunction resolvePgClient(db: AnyPgDatabase): PgQueryClient | undefined {\n  const databaseWithClient = db as PgClientCarrier;\n  const pgClient = databaseWithClient.$client;\n  if (pgClient?.query === undefined) {\n    return undefined;\n  }\n  return pgClient;\n}\n\nasync function executeDrizzleQuery<TRow>(\n  db: AnyPgDatabase,\n  query: SQL,\n): Promise<readonly TRow[]> {\n  const result = (await db.execute(query)) as Readonly<{\n    rows: readonly TRow[];\n  }>;\n  return result.rows;\n}\n\nfunction createPgPreparedStatement(\n  pgClient: PgQueryClient,\n  sqlText: string,\n): PreparedSqlStatement {\n  return {\n    async execute<TRow>(params: readonly unknown[]): Promise<readonly TRow[]> {\n      const result = await pgClient.query(sqlText, params);\n      return result.rows as readonly TRow[];\n    },\n  };\n}\n\nexport function createPostgresExecutionAdapter(\n  db: AnyPgDatabase,\n): PostgresExecutionAdapter {\n  const pgClient = resolvePgClient(db);\n\n  function compile(query: SQL): CompiledSqlQuery {\n    return compileQueryWithDialect(db, query, \"PostgreSQL\");\n  }\n\n  if (pgClient === undefined) {\n    return {\n      compile,\n      async execute<TRow>(query: SQL): Promise<readonly TRow[]> {\n        return executeDrizzleQuery<TRow>(db, query);\n      },\n    };\n  }\n\n  const pgQueryClient = pgClient;\n\n  async function executeCompiled<TRow>(\n    compiledQuery: CompiledSqlQuery,\n  ): Promise<readonly TRow[]> {\n    const result = await pgQueryClient.query(\n      compiledQuery.sql,\n      compiledQuery.params,\n    );\n    return result.rows as readonly TRow[];\n  }\n\n  return {\n    compile,\n    async execute<TRow>(query: SQL): Promise<readonly TRow[]> {\n      return executeDrizzleQuery<TRow>(db, query);\n    },\n    executeCompiled,\n    prepare(sqlText: string): PreparedSqlStatement {\n      return createPgPreparedStatement(pgQueryClient, sqlText);\n    },\n  };\n}\n","/**\n * PostgreSQL backend adapter for TypeGraph.\n *\n * Works with any Drizzle PostgreSQL database instance:\n * - node-postgres (pg)\n * - PGlite\n * - Neon\n * - Vercel Postgres\n * - Supabase\n *\n * @example\n * ```typescript\n * import { drizzle } from \"drizzle-orm/node-postgres\";\n * import { Pool } from \"pg\";\n * import { createPostgresBackend, tables } from \"@nicia-ai/typegraph/postgres\";\n *\n * const pool = new Pool({ connectionString: process.env.DATABASE_URL });\n * const db = drizzle(pool);\n * const backend = createPostgresBackend(db, { tables });\n * ```\n */\nimport { getTableName, type SQL } from \"drizzle-orm\";\n\nimport type { SqlTableNames } from \"../../query/compiler/schema\";\nimport {\n  type BackendCapabilities,\n  type CreateVectorIndexParams,\n  type DeleteEmbeddingParams,\n  type DropVectorIndexParams,\n  type EmbeddingRow,\n  type GraphBackend,\n  POSTGRES_CAPABILITIES,\n  type TransactionBackend,\n  type TransactionOptions,\n  type UpsertEmbeddingParams,\n  type VectorSearchParams,\n  type VectorSearchResult,\n} from \"../types\";\nimport {\n  type AnyPgDatabase,\n  createPostgresExecutionAdapter,\n  type PostgresExecutionAdapter,\n} from \"./execution/postgres-execution\";\nimport { createCommonOperationBackend } from \"./operation-backend-core\";\nimport { createPostgresOperationStrategy } from \"./operations/strategy\";\nimport {\n  createEdgeRowMapper,\n  createNodeRowMapper,\n  createSchemaVersionRowMapper,\n  createUniqueRowMapper,\n  formatPostgresTimestamp,\n  nowIso,\n  POSTGRES_ROW_MAPPER_CONFIG,\n} from \"./row-mappers\";\nimport {\n  type PostgresTables,\n  tables as defaultTables,\n} from \"./schema/postgres\";\nimport {\n  createPostgresVectorIndex,\n  dropPostgresVectorIndex,\n  generateVectorIndexName,\n  type VectorIndexOptions,\n} from \"./vector-index\";\n\n// ============================================================\n// Types\n// ============================================================\n\n/**\n * Options for creating a PostgreSQL backend.\n */\nexport type PostgresBackendOptions = Readonly<{\n  /**\n   * Custom table definitions. Use createPostgresTables() to customize table names.\n   * Defaults to standard TypeGraph table names.\n   */\n  tables?: PostgresTables;\n}>;\n\nconst POSTGRES_MAX_BIND_PARAMETERS = 65_535;\nconst NODE_INSERT_PARAM_COUNT = 9;\nconst EDGE_INSERT_PARAM_COUNT = 12;\nconst POSTGRES_NODE_INSERT_BATCH_SIZE = Math.max(\n  1,\n  Math.floor(POSTGRES_MAX_BIND_PARAMETERS / NODE_INSERT_PARAM_COUNT),\n);\nconst POSTGRES_EDGE_INSERT_BATCH_SIZE = Math.max(\n  1,\n  Math.floor(POSTGRES_MAX_BIND_PARAMETERS / EDGE_INSERT_PARAM_COUNT),\n);\nconst POSTGRES_GET_NODES_ID_CHUNK_SIZE = Math.max(\n  1,\n  POSTGRES_MAX_BIND_PARAMETERS - 2,\n);\nconst POSTGRES_GET_EDGES_ID_CHUNK_SIZE = Math.max(\n  1,\n  POSTGRES_MAX_BIND_PARAMETERS - 1,\n);\n\n// ============================================================\n// Utilities\n// ============================================================\n\nconst toNodeRow = createNodeRowMapper(POSTGRES_ROW_MAPPER_CONFIG);\nconst toEdgeRow = createEdgeRowMapper(POSTGRES_ROW_MAPPER_CONFIG);\nconst toUniqueRow = createUniqueRowMapper(POSTGRES_ROW_MAPPER_CONFIG);\nconst toSchemaVersionRow = createSchemaVersionRowMapper(POSTGRES_ROW_MAPPER_CONFIG);\n\n/**\n * Converts a database row to EmbeddingRow type.\n * Raw SQL returns snake_case column names.\n */\nfunction toEmbeddingRow(row: Record<string, unknown>): EmbeddingRow {\n  // pgvector returns embedding as a string '[1,2,3]' or as parsed array\n  let embedding: readonly number[];\n  if (typeof row.embedding === \"string\") {\n    const content = row.embedding.slice(1, -1);\n    embedding = content === \"\" ? [] : content.split(\",\").map((s) => Number.parseFloat(s.trim()));\n  } else if (Array.isArray(row.embedding)) {\n    embedding = row.embedding as number[];\n  } else {\n    embedding = [];\n  }\n\n  return {\n    graph_id: row.graph_id as string,\n    node_kind: row.node_kind as string,\n    node_id: row.node_id as string,\n    field_path: row.field_path as string,\n    embedding,\n    dimensions: row.dimensions as number,\n    created_at: formatPostgresTimestamp(row.created_at) ?? \"\",\n    updated_at: formatPostgresTimestamp(row.updated_at) ?? \"\",\n  };\n}\n\n/**\n * PostgreSQL capabilities with vector search support.\n * Extends base POSTGRES_CAPABILITIES with vector operations.\n */\nconst POSTGRES_VECTOR_CAPABILITIES: BackendCapabilities = {\n  ...POSTGRES_CAPABILITIES,\n  vector: {\n    supported: true,\n    metrics: [\"cosine\", \"l2\", \"inner_product\"] as const,\n    indexTypes: [\"hnsw\", \"ivfflat\", \"none\"] as const,\n    maxDimensions: 16_000, // pgvector limit\n  },\n};\n\n// ============================================================\n// Backend Factory\n// ============================================================\n\n/**\n * Creates a TypeGraph backend for PostgreSQL databases.\n *\n * Works with any Drizzle PostgreSQL instance regardless of the underlying driver.\n *\n * @param db - A Drizzle PostgreSQL database instance\n * @param options - Backend configuration\n * @returns A GraphBackend implementation\n */\nexport function createPostgresBackend(\n  db: AnyPgDatabase,\n  options: PostgresBackendOptions = {},\n): GraphBackend {\n  const tables = options.tables ?? defaultTables;\n  const executionAdapter = createPostgresExecutionAdapter(db);\n  const tableNames: SqlTableNames = {\n    nodes: getTableName(tables.nodes),\n    edges: getTableName(tables.edges),\n    embeddings: getTableName(tables.embeddings),\n  };\n  const operationStrategy = createPostgresOperationStrategy(tables);\n  const operations = createPostgresOperationBackend({\n    db,\n    executionAdapter,\n    operationStrategy,\n    tableNames,\n  });\n\n  const backend: GraphBackend = {\n    ...operations,\n\n    async setActiveSchema(graphId: string, version: number): Promise<void> {\n      await backend.transaction(async (txBackend) => {\n        await txBackend.setActiveSchema(graphId, version);\n      });\n    },\n\n    async transaction<T>(\n      fn: (tx: TransactionBackend) => Promise<T>,\n      options?: TransactionOptions,\n    ): Promise<T> {\n      const txConfig = options?.isolationLevel\n        ? {\n            isolationLevel: options.isolationLevel.replace(\"_\", \" \") as\n              | \"read uncommitted\"\n              | \"read committed\"\n              | \"repeatable read\"\n              | \"serializable\",\n          }\n        : undefined;\n\n      return db.transaction(async (tx) => {\n        const txBackend = createTransactionBackend({\n          db: tx as AnyPgDatabase,\n          operationStrategy,\n          tableNames,\n        });\n        return fn(txBackend);\n      }, txConfig);\n    },\n\n    async close(): Promise<void> {\n      // Drizzle doesn't expose a close method\n      // Users manage connection lifecycle themselves\n    },\n  };\n\n  return backend;\n}\n\ntype CreatePostgresOperationBackendOptions = Readonly<{\n  db: AnyPgDatabase;\n  executionAdapter: PostgresExecutionAdapter;\n  operationStrategy: ReturnType<typeof createPostgresOperationStrategy>;\n  tableNames: SqlTableNames;\n}>;\n\ntype CreatePostgresTransactionBackendOptions = Readonly<{\n  db: AnyPgDatabase;\n  executionAdapter?: PostgresExecutionAdapter;\n  operationStrategy: ReturnType<typeof createPostgresOperationStrategy>;\n  tableNames: SqlTableNames;\n}>;\n\nfunction createPostgresOperationBackend(\n  options: CreatePostgresOperationBackendOptions,\n): TransactionBackend {\n  const { db, executionAdapter, operationStrategy, tableNames } = options;\n\n  async function execAll<T>(query: SQL): Promise<T[]> {\n    const result = (await db.execute(query)) as Readonly<{\n      rows: T[];\n    }>;\n    return result.rows;\n  }\n\n  async function execGet<T>(query: SQL): Promise<T | undefined> {\n    const result = (await db.execute(query)) as Readonly<{\n      rows: T[];\n    }>;\n    return result.rows[0];\n  }\n\n  async function execRun(query: SQL): Promise<void> {\n    await db.execute(query);\n  }\n\n  const commonBackend = createCommonOperationBackend({\n    batchConfig: {\n      edgeInsertBatchSize: POSTGRES_EDGE_INSERT_BATCH_SIZE,\n      getEdgesChunkSize: POSTGRES_GET_EDGES_ID_CHUNK_SIZE,\n      getNodesChunkSize: POSTGRES_GET_NODES_ID_CHUNK_SIZE,\n      nodeInsertBatchSize: POSTGRES_NODE_INSERT_BATCH_SIZE,\n    },\n    execution: {\n      execAll,\n      execGet,\n      execRun,\n    },\n    nowIso,\n    operationStrategy,\n    rowMappers: {\n      toEdgeRow,\n      toNodeRow,\n      toSchemaVersionRow,\n      toUniqueRow,\n    },\n  });\n\n  const executeCompiled = executionAdapter.executeCompiled;\n  const executeRawMethod: Pick<TransactionBackend, \"executeRaw\"> =\n    executeCompiled === undefined ?\n      {}\n    : {\n        async executeRaw<T>(\n          sqlText: string,\n          params: readonly unknown[],\n        ): Promise<readonly T[]> {\n          return executeCompiled<T>({ params, sql: sqlText });\n        },\n      };\n\n  const operationBackend: TransactionBackend = {\n    ...commonBackend,\n    ...executeRawMethod,\n    capabilities: POSTGRES_VECTOR_CAPABILITIES,\n    dialect: \"postgres\",\n    tableNames,\n\n    // === Embedding Operations ===\n\n    async upsertEmbedding(params: UpsertEmbeddingParams): Promise<void> {\n      const timestamp = nowIso();\n      const query = operationStrategy.buildUpsertEmbedding(params, timestamp);\n      await execRun(query);\n    },\n\n    async deleteEmbedding(params: DeleteEmbeddingParams): Promise<void> {\n      const query = operationStrategy.buildDeleteEmbedding(params);\n      await execRun(query);\n    },\n\n    async getEmbedding(\n      graphId: string,\n      nodeKind: string,\n      nodeId: string,\n      fieldPath: string,\n    ): Promise<EmbeddingRow | undefined> {\n      const query = operationStrategy.buildGetEmbedding(\n        graphId,\n        nodeKind,\n        nodeId,\n        fieldPath,\n      );\n      const row = await execGet<Record<string, unknown>>(query);\n      return row ? toEmbeddingRow(row) : undefined;\n    },\n\n    async vectorSearch(\n      params: VectorSearchParams,\n    ): Promise<readonly VectorSearchResult[]> {\n      const query = operationStrategy.buildVectorSearch(params);\n      const rows = await execAll<{ node_id: string; score: number }>(query);\n      return rows.map((row) => ({\n        nodeId: row.node_id,\n        score: row.score,\n      }));\n    },\n\n    async createVectorIndex(params: CreateVectorIndexParams): Promise<void> {\n      const indexOptions: VectorIndexOptions = {\n        graphId: params.graphId,\n        nodeKind: params.nodeKind,\n        fieldPath: params.fieldPath,\n        dimensions: params.dimensions,\n        embeddingsTableName: tableNames.embeddings,\n        indexType: params.indexType,\n        metric: params.metric,\n        ...(params.indexParams?.m === undefined\n          ? {}\n          : { hnswM: params.indexParams.m }),\n        ...(params.indexParams?.efConstruction === undefined\n          ? {}\n          : { hnswEfConstruction: params.indexParams.efConstruction }),\n        ...(params.indexParams?.lists === undefined\n          ? {}\n          : { ivfflatLists: params.indexParams.lists }),\n      };\n\n      const result = await createPostgresVectorIndex(db, indexOptions);\n\n      if (!result.success) {\n        throw new Error(\n          result.message ?? \"Failed to create PostgreSQL vector index\",\n        );\n      }\n    },\n\n    async dropVectorIndex(params: DropVectorIndexParams): Promise<void> {\n      const metrics =\n        POSTGRES_VECTOR_CAPABILITIES.vector?.metrics ?? ([\"cosine\"] as const);\n\n      for (const metric of metrics) {\n        const indexName = generateVectorIndexName(\n          params.graphId,\n          params.nodeKind,\n          params.fieldPath,\n          metric,\n        );\n        const result = await dropPostgresVectorIndex(db, indexName);\n        if (!result.success) {\n          throw new Error(\n            result.message ?? \"Failed to drop PostgreSQL vector index\",\n          );\n        }\n      }\n    },\n\n    // === Query Execution ===\n\n    async execute<T>(query: SQL): Promise<readonly T[]> {\n      return executionAdapter.execute<T>(query);\n    },\n\n    compileSql(query: SQL): Readonly<{ sql: string; params: readonly unknown[] }> {\n      return executionAdapter.compile(query);\n    },\n  };\n\n  return operationBackend;\n}\n\nfunction createTransactionBackend(\n  options: CreatePostgresTransactionBackendOptions,\n): TransactionBackend {\n  const txExecutionAdapter =\n    options.executionAdapter ?? createPostgresExecutionAdapter(options.db);\n\n  return createPostgresOperationBackend({\n    db: options.db,\n    executionAdapter: txExecutionAdapter,\n    operationStrategy: options.operationStrategy,\n    tableNames: options.tableNames,\n  });\n}\n\n// Re-export schema utilities\nexport type { PostgresTableNames,PostgresTables } from \"./schema/postgres\";\nexport { createPostgresTables, tables } from \"./schema/postgres\";\n"]}

package/dist/backend/postgres/index.d.cts

@@ -1,13 +1,36 @@
-export { PostgresBackendOptions, createPostgresBackend } from '../drizzle/postgres.cjs';
-export { PostgresTableNames, PostgresTables, createPostgresTables, edges, embeddings, nodes, schemaVersions, tables, uniques } from '../drizzle/schema/postgres.cjs';
-export { g as generatePostgresDDL, a as getPostgresMigrationSQL } from '../../test-helpers-DPRFVky4.cjs';
-import '../../types-BUy-pHKH.cjs';
+import { G as GraphBackend } from '../../types-SVDEKnU6.cjs';
+import { PgDatabase, PgQueryResultHKT } from 'drizzle-orm/pg-core';
+import { P as PostgresTables } from '../../ddl-Bcyb4DW1.cjs';
+export { C as CreatePostgresTablesOptions, b as PostgresTableNames, c as createPostgresTables, e as edges, d as embeddings, f as generatePostgresDDL, h as generatePostgresMigrationSQL, n as nodes, s as schemaVersions, t as tables, u as uniques } from '../../ddl-Bcyb4DW1.cjs';
 import 'drizzle-orm';
-import '../../types-DTJEu_-h.cjs';
+import '../../types-DolHw9pJ.cjs';
 import 'zod';
-import '../../types-BRzHlhKC.cjs';
-import 'drizzle-orm/pg-core';
-import '../../types-DHRsi6j9.cjs';
-import '../../ast-D-3bOanX.cjs';
-import '../drizzle/schema/sqlite.cjs';
+import '../../types-BbMn2Ycv.cjs';
+import '../../ast-Cq9qrnNP.cjs';
+import '../../sqlite-FWGZLwDd.cjs';
 import 'drizzle-orm/sqlite-core';
+
+type AnyPgDatabase = PgDatabase<PgQueryResultHKT, Record<string, unknown>>;
+
+/**
+ * Options for creating a PostgreSQL backend.
+ */
+type PostgresBackendOptions = Readonly<{
+    /**
+     * Custom table definitions. Use createPostgresTables() to customize table names.
+     * Defaults to standard TypeGraph table names.
+     */
+    tables?: PostgresTables;
+}>;
+/**
+ * Creates a TypeGraph backend for PostgreSQL databases.
+ *
+ * Works with any Drizzle PostgreSQL instance regardless of the underlying driver.
+ *
+ * @param db - A Drizzle PostgreSQL database instance
+ * @param options - Backend configuration
+ * @returns A GraphBackend implementation
+ */
+declare function createPostgresBackend(db: AnyPgDatabase, options?: PostgresBackendOptions): GraphBackend;
+
+export { type PostgresBackendOptions, PostgresTables, createPostgresBackend };

package/dist/backend/postgres/index.d.ts

@@ -1,13 +1,36 @@
-export { PostgresBackendOptions, createPostgresBackend } from '../drizzle/postgres.js';
-export { PostgresTableNames, PostgresTables, createPostgresTables, edges, embeddings, nodes, schemaVersions, tables, uniques } from '../drizzle/schema/postgres.js';
-export { g as generatePostgresDDL, a as getPostgresMigrationSQL } from '../../test-helpers-CIq1Hhj1.js';
-import '../../types-6EKrWTs9.js';
+import { G as GraphBackend } from '../../types-D5ggX07j.js';
+import { PgDatabase, PgQueryResultHKT } from 'drizzle-orm/pg-core';
+import { P as PostgresTables } from '../../ddl-D7DQx8w8.js';
+export { C as CreatePostgresTablesOptions, b as PostgresTableNames, c as createPostgresTables, e as edges, d as embeddings, f as generatePostgresDDL, h as generatePostgresMigrationSQL, n as nodes, s as schemaVersions, t as tables, u as uniques } from '../../ddl-D7DQx8w8.js';
 import 'drizzle-orm';
-import '../../types-DTJEu_-h.js';
+import '../../types-DolHw9pJ.js';
 import 'zod';
-import '../../types-BRzHlhKC.js';
-import 'drizzle-orm/pg-core';
-import '../../types-ZT5mlism.js';
-import '../../ast-CXFx6bF6.js';
-import '../drizzle/schema/sqlite.js';
+import '../../types-C2rhqkg7.js';
+import '../../ast-CG87Zr6p.js';
+import '../../sqlite-CSJ-fgIm.js';
 import 'drizzle-orm/sqlite-core';
+
+type AnyPgDatabase = PgDatabase<PgQueryResultHKT, Record<string, unknown>>;
+
+/**
+ * Options for creating a PostgreSQL backend.
+ */
+type PostgresBackendOptions = Readonly<{
+    /**
+     * Custom table definitions. Use createPostgresTables() to customize table names.
+     * Defaults to standard TypeGraph table names.
+     */
+    tables?: PostgresTables;
+}>;
+/**
+ * Creates a TypeGraph backend for PostgreSQL databases.
+ *
+ * Works with any Drizzle PostgreSQL instance regardless of the underlying driver.
+ *
+ * @param db - A Drizzle PostgreSQL database instance
+ * @param options - Backend configuration
+ * @returns A GraphBackend implementation
+ */
+declare function createPostgresBackend(db: AnyPgDatabase, options?: PostgresBackendOptions): GraphBackend;
+
+export { type PostgresBackendOptions, PostgresTables, createPostgresBackend };