@nicia-ai/typegraph 0.4.0 → 0.6.0

package/dist/backend/postgres/index.js

@@ -1,11 +1,291 @@
-export { generatePostgresDDL, getPostgresMigrationSQL } from '../../chunk-SMLIWLS7.js';
-export { createPostgresBackend } from '../../chunk-Q6PXIKRQ.js';
-import '../../chunk-ZQGOBVXZ.js';
-import '../../chunk-OGGLFYFA.js';
-export { createPostgresTables, edges, embeddings, nodes, schemaVersions, tables, uniques } from '../../chunk-3PURVEA4.js';
+import { createNodeRowMapper, POSTGRES_ROW_MAPPER_CONFIG, createEdgeRowMapper, createUniqueRowMapper, createSchemaVersionRowMapper, POSTGRES_CAPABILITIES, tables2, createPostgresOperationStrategy, createCommonOperationBackend, nowIso, generateVectorIndexName, dropPostgresVectorIndex, createPostgresVectorIndex, compileQueryWithDialect, formatPostgresTimestamp } from '../../chunk-JPO7W262.js';
+export { createPostgresTables, edges2 as edges, embeddings2 as embeddings, generatePostgresDDL, generatePostgresMigrationSQL, nodes2 as nodes, schemaVersions2 as schemaVersions, tables2 as tables, uniques2 as uniques } from '../../chunk-JPO7W262.js';
 import '../../chunk-SJ2QMDXY.js';
 import '../../chunk-U3452TEU.js';
 import '../../chunk-54WJF3DW.js';
 import '../../chunk-K7SQ3SWP.js';
+import { getTableName } from '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 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 = createNodeRowMapper(POSTGRES_ROW_MAPPER_CONFIG);
+var toEdgeRow = createEdgeRowMapper(POSTGRES_ROW_MAPPER_CONFIG);
+var toUniqueRow = createUniqueRowMapper(POSTGRES_ROW_MAPPER_CONFIG);
+var toSchemaVersionRow = createSchemaVersionRowMapper(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: formatPostgresTimestamp(row.created_at) ?? "",
+    updated_at: formatPostgresTimestamp(row.updated_at) ?? ""
+  };
+}
+var POSTGRES_VECTOR_CAPABILITIES = {
+  ...POSTGRES_CAPABILITIES,
+  vector: {
+    supported: true,
+    metrics: ["cosine", "l2", "inner_product"],
+    indexTypes: ["hnsw", "ivfflat", "none"],
+    maxDimensions: 16e3
+    // pgvector limit
+  }
+};
+function createPostgresBackend(db, options = {}) {
+  const tables2$1 = options.tables ?? tables2;
+  const executionAdapter = createPostgresExecutionAdapter(db);
+  const tableNames = {
+    nodes: getTableName(tables2$1.nodes),
+    edges: getTableName(tables2$1.edges),
+    embeddings: getTableName(tables2$1.embeddings)
+  };
+  const operationStrategy = createPostgresOperationStrategy(tables2$1);
+  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 = 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,
+    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 = 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 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 = generateVectorIndexName(
+          params.graphId,
+          params.nodeKind,
+          params.fieldPath,
+          metric
+        );
+        const result = await 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
+  });
+}
+
+export { createPostgresBackend };
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map

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

@@ -1 +1 @@
-{"version":3,"sources":[],"names":[],"mappings":"","file":"index.js"}
+{"version":3,"sources":["../../../src/backend/drizzle/execution/postgres-execution.ts","../../../src/backend/drizzle/postgres.ts"],"names":["tables","options"],"mappings":"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","file":"index.js","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/sqlite/index.cjs

@@ -1,122 +1,53 @@
 'use strict';
 
-var chunkUYMT4LO2_cjs = require('../../chunk-UYMT4LO2.cjs');
-var chunkNYDXJGA3_cjs = require('../../chunk-NYDXJGA3.cjs');
-require('../../chunk-7RVSDXT3.cjs');
-var chunkXZL6MCZJ_cjs = require('../../chunk-XZL6MCZJ.cjs');
-require('../../chunk-NU2XNMVI.cjs');
-var chunk44SXEVF4_cjs = require('../../chunk-44SXEVF4.cjs');
+var chunkK5O7TOJO_cjs = require('../../chunk-K5O7TOJO.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 Database = require('better-sqlite3');
-var betterSqlite3 = require('drizzle-orm/better-sqlite3');
 
-function _interopDefault (e) { return e && e.__esModule ? e : { default: e }; }
 
-var Database__default = /*#__PURE__*/_interopDefault(Database);
 
-function getUnknownErrorMessage(error) {
-  if (error instanceof Error) return error.message;
-  return String(error);
-}
-function parseNodeModuleVersionMismatchMessage(message) {
-  const regexp = /NODE_MODULE_VERSION (?<compiled>\d+)[\s\S]*?NODE_MODULE_VERSION (?<required>\d+)/;
-  const match = regexp.exec(message);
-  if (!match?.groups) return void 0;
-  const compiled = Number(match.groups.compiled);
-  const required = Number(match.groups.required);
-  if (!Number.isFinite(compiled) || !Number.isFinite(required))
-    return void 0;
-  return { compiled, required };
-}
-function createDatabase(path) {
-  try {
-    return new Database__default.default(path);
-  } catch (error) {
-    const message = getUnknownErrorMessage(error);
-    const mismatch = parseNodeModuleVersionMismatchMessage(message);
-    if (!mismatch) throw error;
-    throw new chunk44SXEVF4_cjs.ConfigurationError(
-      [
-        "Failed to load better-sqlite3 native addon.",
-        `It was compiled for NODE_MODULE_VERSION ${mismatch.compiled}, but this Node.js runtime requires ${mismatch.required}.`,
-        "This usually happens after switching Node versions without rebuilding native dependencies.",
-        "Rebuild with: pnpm rebuild better-sqlite3 (or npm rebuild better-sqlite3)."
-      ].join(" "),
-      {
-        nodeVersion: process.version,
-        nodeModuleVersion: process.versions.modules,
-        compiledNodeModuleVersion: mismatch.compiled,
-        requiredNodeModuleVersion: mismatch.required
-      },
-      { cause: error }
-    );
-  }
-}
-function createLocalSqliteBackend(options = {}) {
-  const path = options.path ?? ":memory:";
-  const tables2 = options.tables ?? chunkXZL6MCZJ_cjs.tables;
-  const sqlite = createDatabase(path);
-  const db = betterSqlite3.drizzle(sqlite);
-  const ddlStatements = chunkUYMT4LO2_cjs.generateSqliteDDL(tables2);
-  for (const statement of ddlStatements) {
-    sqlite.exec(statement);
-  }
-  const backend = chunkNYDXJGA3_cjs.createSqliteBackend(db, {
-    executionProfile: {
-      isD1: false,
-      isSync: true
-    },
-    tables: tables2
-  });
-  let isClosed = false;
-  function close() {
-    if (isClosed) return Promise.resolve();
-    isClosed = true;
-    sqlite.close();
-    return Promise.resolve();
-  }
-  const managedBackend = { ...backend, close };
-  return { backend: managedBackend, db };
-}
-
-Object.defineProperty(exports, "generateSqliteDDL", {
+Object.defineProperty(exports, "createSqliteBackend", {
   enumerable: true,
-  get: function () { return chunkUYMT4LO2_cjs.generateSqliteDDL; }
+  get: function () { return chunkK5O7TOJO_cjs.createSqliteBackend; }
 });
-Object.defineProperty(exports, "getSqliteMigrationSQL", {
+Object.defineProperty(exports, "createSqliteTables", {
   enumerable: true,
-  get: function () { return chunkUYMT4LO2_cjs.getSqliteMigrationSQL; }
+  get: function () { return chunk23NGZHUN_cjs.createSqliteTables; }
 });
-Object.defineProperty(exports, "createSqliteBackend", {
+Object.defineProperty(exports, "edges", {
   enumerable: true,
-  get: function () { return chunkNYDXJGA3_cjs.createSqliteBackend; }
+  get: function () { return chunk23NGZHUN_cjs.edges; }
 });
-Object.defineProperty(exports, "createSqliteTables", {
+Object.defineProperty(exports, "embeddings", {
   enumerable: true,
-  get: function () { return chunkXZL6MCZJ_cjs.createSqliteTables; }
+  get: function () { return chunk23NGZHUN_cjs.embeddings; }
 });
-Object.defineProperty(exports, "edges", {
+Object.defineProperty(exports, "generateSqliteDDL", {
+  enumerable: true,
+  get: function () { return chunk23NGZHUN_cjs.generateSqliteDDL; }
+});
+Object.defineProperty(exports, "generateSqliteMigrationSQL", {
   enumerable: true,
-  get: function () { return chunkXZL6MCZJ_cjs.edges; }
+  get: function () { return chunk23NGZHUN_cjs.generateSqliteMigrationSQL; }
 });
 Object.defineProperty(exports, "nodes", {
   enumerable: true,
-  get: function () { return chunkXZL6MCZJ_cjs.nodes; }
+  get: function () { return chunk23NGZHUN_cjs.nodes; }
 });
 Object.defineProperty(exports, "schemaVersions", {
   enumerable: true,
-  get: function () { return chunkXZL6MCZJ_cjs.schemaVersions; }
+  get: function () { return chunk23NGZHUN_cjs.schemaVersions; }
 });
 Object.defineProperty(exports, "tables", {
   enumerable: true,
-  get: function () { return chunkXZL6MCZJ_cjs.tables; }
+  get: function () { return chunk23NGZHUN_cjs.tables; }
 });
 Object.defineProperty(exports, "uniques", {
   enumerable: true,
-  get: function () { return chunkXZL6MCZJ_cjs.uniques; }
+  get: function () { return chunk23NGZHUN_cjs.uniques; }
 });
-exports.createLocalSqliteBackend = createLocalSqliteBackend;
 //# sourceMappingURL=index.cjs.map
 //# sourceMappingURL=index.cjs.map

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

@@ -1 +1 @@
-{"version":3,"sources":["../../../src/backend/sqlite/index.ts"],"names":["Database","ConfigurationError","tables","drizzle","generateSqliteDDL","createSqliteBackend"],"mappings":"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","file":"index.cjs","sourcesContent":["/**\n * SQLite backend for TypeGraph.\n *\n * Re-exports from the Drizzle implementation for backwards compatibility.\n *\n * @example Quick start with in-memory database\n * ```typescript\n * import { createLocalSqliteBackend } from \"@nicia-ai/typegraph/sqlite\";\n *\n * const { backend, db } = createLocalSqliteBackend();\n * const store = createStore(graph, backend);\n * ```\n *\n * @example File-based database for persistent local development\n * ```typescript\n * import { createLocalSqliteBackend } from \"@nicia-ai/typegraph/sqlite\";\n *\n * const { backend, db } = createLocalSqliteBackend({ path: \"./dev.db\" });\n * const store = createStore(graph, backend);\n * ```\n *\n * @example Full manual configuration\n * ```typescript\n * import { drizzle } from \"drizzle-orm/better-sqlite3\";\n * import Database from \"better-sqlite3\";\n * import { createSqliteBackend, getSqliteMigrationSQL } from \"@nicia-ai/typegraph/sqlite\";\n *\n * const sqlite = new Database(\"app.db\");\n * sqlite.exec(getSqliteMigrationSQL());\n * const db = drizzle(sqlite);\n * const backend = createSqliteBackend(db);\n * ```\n */\nimport Database from \"better-sqlite3\";\nimport {\n  type BetterSQLite3Database,\n  drizzle,\n} from \"drizzle-orm/better-sqlite3\";\n\nimport { ConfigurationError } from \"../../errors\";\nimport {\n  createSqliteBackend,\n  type SqliteTables,\n  tables as defaultTables,\n} from \"../drizzle/sqlite\";\nimport { generateSqliteDDL } from \"../drizzle/test-helpers\";\nimport type { GraphBackend } from \"../types\";\n\ntype NodeModuleVersionMismatch = Readonly<{\n  compiled: number;\n  required: number;\n}>;\n\nfunction getUnknownErrorMessage(error: unknown): string {\n  if (error instanceof Error) return error.message;\n  return String(error);\n}\n\nfunction parseNodeModuleVersionMismatchMessage(\n  message: string,\n): NodeModuleVersionMismatch | undefined {\n  const regexp =\n    /NODE_MODULE_VERSION (?<compiled>\\d+)[\\s\\S]*?NODE_MODULE_VERSION (?<required>\\d+)/;\n  const match = regexp.exec(message);\n  if (!match?.groups) return undefined;\n\n  const compiled = Number(match.groups.compiled);\n  const required = Number(match.groups.required);\n\n  if (!Number.isFinite(compiled) || !Number.isFinite(required))\n    return undefined;\n\n  return { compiled, required };\n}\n\nfunction createDatabase(path: string): Database.Database {\n  try {\n    return new Database(path);\n  } catch (error) {\n    const message = getUnknownErrorMessage(error);\n    const mismatch = parseNodeModuleVersionMismatchMessage(message);\n    if (!mismatch) throw error;\n\n    throw new ConfigurationError(\n      [\n        \"Failed to load better-sqlite3 native addon.\",\n        `It was compiled for NODE_MODULE_VERSION ${mismatch.compiled}, but this Node.js runtime requires ${mismatch.required}.`,\n        \"This usually happens after switching Node versions without rebuilding native dependencies.\",\n        \"Rebuild with: pnpm rebuild better-sqlite3 (or npm rebuild better-sqlite3).\",\n      ].join(\" \"),\n      {\n        nodeVersion: process.version,\n        nodeModuleVersion: process.versions.modules,\n        compiledNodeModuleVersion: mismatch.compiled,\n        requiredNodeModuleVersion: mismatch.required,\n      },\n      { cause: error },\n    );\n  }\n}\n\n// ============================================================\n// Types\n// ============================================================\n\n/**\n * Options for creating a local SQLite backend.\n */\nexport type LocalSqliteBackendOptions = Readonly<{\n  /**\n   * Path to the SQLite database file.\n   * Defaults to \":memory:\" for an in-memory database.\n   */\n  path?: string;\n\n  /**\n   * Custom table definitions.\n   * Defaults to standard TypeGraph table names.\n   */\n  tables?: SqliteTables;\n}>;\n\n/**\n * Result of creating a local SQLite backend.\n */\nexport type LocalSqliteBackendResult = Readonly<{\n  /**\n   * The GraphBackend instance for use with createStore.\n   */\n  backend: GraphBackend;\n\n  /**\n   * The underlying Drizzle database instance.\n   * Useful for direct SQL access or cleanup.\n   */\n  db: BetterSQLite3Database;\n}>;\n\n// ============================================================\n// Factory Function\n// ============================================================\n\n/**\n * Creates a SQLite backend with minimal configuration.\n *\n * This is a convenience function for local development and testing.\n * It handles database creation, schema migration, and backend setup.\n *\n * For production deployments or custom configurations, use createSqliteBackend\n * directly with your own Drizzle database instance.\n *\n * @param options - Configuration options\n * @returns Backend and database instances\n *\n * @example In-memory database (default)\n * ```typescript\n * const { backend } = createLocalSqliteBackend();\n * const store = createStore(graph, backend);\n * ```\n *\n * @example File-based database\n * ```typescript\n * const { backend, db } = createLocalSqliteBackend({ path: \"./data.db\" });\n * const store = createStore(graph, backend);\n * ```\n */\nexport function createLocalSqliteBackend(\n  options: LocalSqliteBackendOptions = {},\n): LocalSqliteBackendResult {\n  const path = options.path ?? \":memory:\";\n  const tables = options.tables ?? defaultTables;\n\n  const sqlite = createDatabase(path);\n  const db = drizzle(sqlite);\n\n  // Generate and execute DDL from schema\n  const ddlStatements = generateSqliteDDL(tables);\n  for (const statement of ddlStatements) {\n    sqlite.exec(statement);\n  }\n\n  const backend = createSqliteBackend(db, {\n    executionProfile: {\n      isD1: false,\n      isSync: true,\n    },\n    tables,\n  });\n  let isClosed = false;\n\n  function close(): Promise<void> {\n    if (isClosed) return Promise.resolve();\n    isClosed = true;\n    sqlite.close();\n    return Promise.resolve();\n  }\n\n  const managedBackend: GraphBackend = { ...backend, close };\n\n  return { backend: managedBackend, db };\n}\n\n// ============================================================\n// Re-exports\n// ============================================================\n\n// Re-export everything from the Drizzle SQLite implementation\nexport {\n  createSqliteBackend,\n  createSqliteTables,\n  type SqliteBackendOptions,\n  type SqliteTableNames,\n  type SqliteTables,\n  tables,\n} from \"../drizzle/sqlite\";\n\n// Re-export individual tables for schema usage\nexport {\n  edges,\n  nodes,\n  schemaVersions,\n  uniques,\n} from \"../drizzle/schema/sqlite\";\n\n// Re-export migration SQL generation\nexport {\n  generateSqliteDDL,\n  getSqliteMigrationSQL,\n} from \"../drizzle/test-helpers\";\n"]}
+{"version":3,"sources":[],"names":[],"mappings":"","file":"index.cjs"}

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

@@ -1,72 +1,36 @@
-import { BetterSQLite3Database } from 'drizzle-orm/better-sqlite3';
-export { SqliteBackendOptions, createSqliteBackend } from '../drizzle/sqlite.cjs';
-import { G as GraphBackend } from '../../types-BUy-pHKH.cjs';
-import { SqliteTables } from '../drizzle/schema/sqlite.cjs';
-export { SqliteTableNames, createSqliteTables, edges, nodes, schemaVersions, tables, uniques } from '../drizzle/schema/sqlite.cjs';
-export { b as generateSqliteDDL, c as getSqliteMigrationSQL } from '../../test-helpers-DPRFVky4.cjs';
-import 'drizzle-orm/sqlite-core';
+import { G as GraphBackend } from '../../types-SVDEKnU6.cjs';
+import { BaseSQLiteDatabase } from 'drizzle-orm/sqlite-core';
+import { S as SqliteTables } from '../../sqlite-FWGZLwDd.cjs';
+export { C as CreateSqliteTablesOptions, a as SqliteTableNames, c as createSqliteTables, e as edges, b as embeddings, n as nodes, s as schemaVersions, t as tables, u as uniques } from '../../sqlite-FWGZLwDd.cjs';
+export { g as generateSqliteDDL, a as generateSqliteMigrationSQL } from '../../ddl-Bcyb4DW1.cjs';
 import 'drizzle-orm';
-import '../../types-DTJEu_-h.cjs';
+import '../../types-DolHw9pJ.cjs';
 import 'zod';
-import '../../types-BRzHlhKC.cjs';
-import '../../types-DHRsi6j9.cjs';
-import '../../ast-D-3bOanX.cjs';
-import '../drizzle/schema/postgres.cjs';
+import '../../types-BbMn2Ycv.cjs';
+import '../../ast-Cq9qrnNP.cjs';
 import 'drizzle-orm/pg-core';
 
+type SqliteExecutionProfileHints = Readonly<{
+    isD1?: boolean;
+    isSync?: boolean;
+}>;
+type AnySqliteDatabase = BaseSQLiteDatabase<"sync" | "async", unknown>;
+
 /**
- * Options for creating a local SQLite backend.
+ * Options for creating a SQLite backend.
  */
-type LocalSqliteBackendOptions = Readonly<{
-    /**
-     * Path to the SQLite database file.
-     * Defaults to ":memory:" for an in-memory database.
-     */
-    path?: string;
+type SqliteBackendOptions = Readonly<{
     /**
-     * Custom table definitions.
+     * Custom table definitions. Use createSqliteTables() to customize table names.
      * Defaults to standard TypeGraph table names.
      */
     tables?: SqliteTables;
-}>;
-/**
- * Result of creating a local SQLite backend.
- */
-type LocalSqliteBackendResult = Readonly<{
-    /**
-     * The GraphBackend instance for use with createStore.
-     */
-    backend: GraphBackend;
     /**
-     * The underlying Drizzle database instance.
-     * Useful for direct SQL access or cleanup.
+     * Optional execution profile hints used to avoid runtime driver reflection.
+     * Set `isD1: true` when using Cloudflare D1.
      */
-    db: BetterSQLite3Database;
+    executionProfile?: SqliteExecutionProfileHints;
 }>;
-/**
- * Creates a SQLite backend with minimal configuration.
- *
- * This is a convenience function for local development and testing.
- * It handles database creation, schema migration, and backend setup.
- *
- * For production deployments or custom configurations, use createSqliteBackend
- * directly with your own Drizzle database instance.
- *
- * @param options - Configuration options
- * @returns Backend and database instances
- *
- * @example In-memory database (default)
- * ```typescript
- * const { backend } = createLocalSqliteBackend();
- * const store = createStore(graph, backend);
- * ```
- *
- * @example File-based database
- * ```typescript
- * const { backend, db } = createLocalSqliteBackend({ path: "./data.db" });
- * const store = createStore(graph, backend);
- * ```
- */
-declare function createLocalSqliteBackend(options?: LocalSqliteBackendOptions): LocalSqliteBackendResult;
+declare function createSqliteBackend(db: AnySqliteDatabase, options?: SqliteBackendOptions): GraphBackend;
 
-export { type LocalSqliteBackendOptions, type LocalSqliteBackendResult, SqliteTables, createLocalSqliteBackend };
+export { type SqliteBackendOptions, SqliteTables, createSqliteBackend };