@nicia-ai/typegraph 0.16.1 → 0.17.0

package/dist/backend/postgres/index.cjs

@@ -1,7 +1,7 @@
 'use strict';
 
-var chunkCRMN2NOM_cjs = require('../../chunk-CRMN2NOM.cjs');
-require('../../chunk-44SXEVF4.cjs');
+var chunk2UTJRP4F_cjs = require('../../chunk-2UTJRP4F.cjs');
+require('../../chunk-O5PST6TB.cjs');
 require('../../chunk-LELLOHJK.cjs');
 require('../../chunk-MME3H4ZF.cjs');
 require('../../chunk-P5CNM325.cjs');
@@ -31,7 +31,7 @@ function createPgPreparedStatement(pgClient, sqlText) {
 function createPostgresExecutionAdapter(db) {
   const pgClient = resolvePgClient(db);
   function compile(query) {
-    return chunkCRMN2NOM_cjs.compileQueryWithDialect(db, query, "PostgreSQL");
+    return chunk2UTJRP4F_cjs.compileQueryWithDialect(db, query, "PostgreSQL");
   }
   if (pgClient === void 0) {
     return {
@@ -86,10 +86,10 @@ var POSTGRES_CHECK_UNIQUE_BATCH_CHUNK_SIZE = Math.max(
   1,
   POSTGRES_MAX_BIND_PARAMETERS - CHECK_UNIQUE_BATCH_FIXED_PARAM_COUNT
 );
-var toNodeRow = chunkCRMN2NOM_cjs.createNodeRowMapper(chunkCRMN2NOM_cjs.POSTGRES_ROW_MAPPER_CONFIG);
-var toEdgeRow = chunkCRMN2NOM_cjs.createEdgeRowMapper(chunkCRMN2NOM_cjs.POSTGRES_ROW_MAPPER_CONFIG);
-var toUniqueRow = chunkCRMN2NOM_cjs.createUniqueRowMapper(chunkCRMN2NOM_cjs.POSTGRES_ROW_MAPPER_CONFIG);
-var toSchemaVersionRow = chunkCRMN2NOM_cjs.createSchemaVersionRowMapper(chunkCRMN2NOM_cjs.POSTGRES_ROW_MAPPER_CONFIG);
+var toNodeRow = chunk2UTJRP4F_cjs.createNodeRowMapper(chunk2UTJRP4F_cjs.POSTGRES_ROW_MAPPER_CONFIG);
+var toEdgeRow = chunk2UTJRP4F_cjs.createEdgeRowMapper(chunk2UTJRP4F_cjs.POSTGRES_ROW_MAPPER_CONFIG);
+var toUniqueRow = chunk2UTJRP4F_cjs.createUniqueRowMapper(chunk2UTJRP4F_cjs.POSTGRES_ROW_MAPPER_CONFIG);
+var toSchemaVersionRow = chunk2UTJRP4F_cjs.createSchemaVersionRowMapper(chunk2UTJRP4F_cjs.POSTGRES_ROW_MAPPER_CONFIG);
 function toEmbeddingRow(row) {
   let embedding;
   if (typeof row.embedding === "string") {
@@ -107,12 +107,12 @@ function toEmbeddingRow(row) {
     field_path: row.field_path,
     embedding,
     dimensions: row.dimensions,
-    created_at: chunkCRMN2NOM_cjs.formatPostgresTimestamp(row.created_at) ?? "",
-    updated_at: chunkCRMN2NOM_cjs.formatPostgresTimestamp(row.updated_at) ?? ""
+    created_at: chunk2UTJRP4F_cjs.formatPostgresTimestamp(row.created_at) ?? "",
+    updated_at: chunk2UTJRP4F_cjs.formatPostgresTimestamp(row.updated_at) ?? ""
   };
 }
 var POSTGRES_VECTOR_CAPABILITIES = {
-  ...chunkCRMN2NOM_cjs.POSTGRES_CAPABILITIES,
+  ...chunk2UTJRP4F_cjs.POSTGRES_CAPABILITIES,
   vector: {
     supported: true,
     metrics: ["cosine", "l2", "inner_product"],
@@ -122,14 +122,14 @@ var POSTGRES_VECTOR_CAPABILITIES = {
   }
 };
 function createPostgresBackend(db, options = {}) {
-  const tables2 = options.tables ?? chunkCRMN2NOM_cjs.tables;
+  const tables2 = options.tables ?? chunk2UTJRP4F_cjs.tables;
   const executionAdapter = createPostgresExecutionAdapter(db);
   const tableNames = {
     nodes: drizzleOrm.getTableName(tables2.nodes),
     edges: drizzleOrm.getTableName(tables2.edges),
     embeddings: drizzleOrm.getTableName(tables2.embeddings)
   };
-  const operationStrategy = chunkCRMN2NOM_cjs.createPostgresOperationStrategy(tables2);
+  const operationStrategy = chunk2UTJRP4F_cjs.createPostgresOperationStrategy(tables2);
   const operations = createPostgresOperationBackend({
     db,
     executionAdapter,
@@ -139,7 +139,7 @@ function createPostgresBackend(db, options = {}) {
   const backend = {
     ...operations,
     async bootstrapTables() {
-      const statements = chunkCRMN2NOM_cjs.generatePostgresDDL(tables2);
+      const statements = chunk2UTJRP4F_cjs.generatePostgresDDL(tables2);
       for (const statement of statements) {
         await db.execute(drizzleOrm.sql.raw(statement));
       }
@@ -180,7 +180,7 @@ function createPostgresOperationBackend(options) {
   async function execRun(query) {
     await db.execute(query);
   }
-  const commonBackend = chunkCRMN2NOM_cjs.createCommonOperationBackend({
+  const commonBackend = chunk2UTJRP4F_cjs.createCommonOperationBackend({
     batchConfig: {
       checkUniqueBatchChunkSize: POSTGRES_CHECK_UNIQUE_BATCH_CHUNK_SIZE,
       edgeInsertBatchSize: POSTGRES_EDGE_INSERT_BATCH_SIZE,
@@ -193,7 +193,7 @@ function createPostgresOperationBackend(options) {
       execGet,
       execRun
     },
-    nowIso: chunkCRMN2NOM_cjs.nowIso,
+    nowIso: chunk2UTJRP4F_cjs.nowIso,
     operationStrategy,
     rowMappers: {
       toEdgeRow,
@@ -216,7 +216,7 @@ function createPostgresOperationBackend(options) {
     tableNames,
     // === Embedding Operations ===
     async upsertEmbedding(params) {
-      const timestamp = chunkCRMN2NOM_cjs.nowIso();
+      const timestamp = chunk2UTJRP4F_cjs.nowIso();
       const query = operationStrategy.buildUpsertEmbedding(params, timestamp);
       await execRun(query);
     },
@@ -255,7 +255,7 @@ function createPostgresOperationBackend(options) {
         ...params.indexParams?.efConstruction === void 0 ? {} : { hnswEfConstruction: params.indexParams.efConstruction },
         ...params.indexParams?.lists === void 0 ? {} : { ivfflatLists: params.indexParams.lists }
       };
-      const result = await chunkCRMN2NOM_cjs.createPostgresVectorIndex(db, indexOptions);
+      const result = await chunk2UTJRP4F_cjs.createPostgresVectorIndex(db, indexOptions);
       if (!result.success) {
         throw new Error(
           result.message ?? "Failed to create PostgreSQL vector index"
@@ -265,13 +265,13 @@ function createPostgresOperationBackend(options) {
     async dropVectorIndex(params) {
       const metrics = POSTGRES_VECTOR_CAPABILITIES.vector?.metrics ?? ["cosine"];
       for (const metric of metrics) {
-        const indexName = chunkCRMN2NOM_cjs.generateVectorIndexName(
+        const indexName = chunk2UTJRP4F_cjs.generateVectorIndexName(
           params.graphId,
           params.nodeKind,
           params.fieldPath,
           metric
         );
-        const result = await chunkCRMN2NOM_cjs.dropPostgresVectorIndex(db, indexName);
+        const result = await chunk2UTJRP4F_cjs.dropPostgresVectorIndex(db, indexName);
         if (!result.success) {
           throw new Error(
             result.message ?? "Failed to drop PostgreSQL vector index"
@@ -301,39 +301,39 @@ function createTransactionBackend(options) {
 
 Object.defineProperty(exports, "createPostgresTables", {
   enumerable: true,
-  get: function () { return chunkCRMN2NOM_cjs.createPostgresTables; }
+  get: function () { return chunk2UTJRP4F_cjs.createPostgresTables; }
 });
 Object.defineProperty(exports, "edges", {
   enumerable: true,
-  get: function () { return chunkCRMN2NOM_cjs.edges; }
+  get: function () { return chunk2UTJRP4F_cjs.edges; }
 });
 Object.defineProperty(exports, "embeddings", {
   enumerable: true,
-  get: function () { return chunkCRMN2NOM_cjs.embeddings; }
+  get: function () { return chunk2UTJRP4F_cjs.embeddings; }
 });
 Object.defineProperty(exports, "generatePostgresDDL", {
   enumerable: true,
-  get: function () { return chunkCRMN2NOM_cjs.generatePostgresDDL; }
+  get: function () { return chunk2UTJRP4F_cjs.generatePostgresDDL; }
 });
 Object.defineProperty(exports, "generatePostgresMigrationSQL", {
   enumerable: true,
-  get: function () { return chunkCRMN2NOM_cjs.generatePostgresMigrationSQL; }
+  get: function () { return chunk2UTJRP4F_cjs.generatePostgresMigrationSQL; }
 });
 Object.defineProperty(exports, "nodes", {
   enumerable: true,
-  get: function () { return chunkCRMN2NOM_cjs.nodes; }
+  get: function () { return chunk2UTJRP4F_cjs.nodes; }
 });
 Object.defineProperty(exports, "schemaVersions", {
   enumerable: true,
-  get: function () { return chunkCRMN2NOM_cjs.schemaVersions; }
+  get: function () { return chunk2UTJRP4F_cjs.schemaVersions; }
 });
 Object.defineProperty(exports, "tables", {
   enumerable: true,
-  get: function () { return chunkCRMN2NOM_cjs.tables; }
+  get: function () { return chunk2UTJRP4F_cjs.tables; }
 });
 Object.defineProperty(exports, "uniques", {
   enumerable: true,
-  get: function () { return chunkCRMN2NOM_cjs.uniques; }
+  get: function () { return chunk2UTJRP4F_cjs.uniques; }
 });
 exports.createPostgresBackend = createPostgresBackend;
 //# sourceMappingURL=index.cjs.map

package/dist/backend/postgres/index.js

@@ -1,6 +1,6 @@
-import { createNodeRowMapper, POSTGRES_ROW_MAPPER_CONFIG, createEdgeRowMapper, createUniqueRowMapper, createSchemaVersionRowMapper, POSTGRES_CAPABILITIES, tables, createPostgresOperationStrategy, createCommonOperationBackend, nowIso, generatePostgresDDL, generateVectorIndexName, dropPostgresVectorIndex, createPostgresVectorIndex, compileQueryWithDialect, formatPostgresTimestamp } from '../../chunk-HWWF3FOP.js';
-export { createPostgresTables, edges, embeddings, generatePostgresDDL, generatePostgresMigrationSQL, nodes, schemaVersions, tables, uniques } from '../../chunk-HWWF3FOP.js';
-import '../../chunk-SJ2QMDXY.js';
+import { createNodeRowMapper, POSTGRES_ROW_MAPPER_CONFIG, createEdgeRowMapper, createUniqueRowMapper, createSchemaVersionRowMapper, POSTGRES_CAPABILITIES, tables, createPostgresOperationStrategy, createCommonOperationBackend, nowIso, generatePostgresDDL, generateVectorIndexName, dropPostgresVectorIndex, createPostgresVectorIndex, compileQueryWithDialect, formatPostgresTimestamp } from '../../chunk-7ZVPFJLQ.js';
+export { createPostgresTables, edges, embeddings, generatePostgresDDL, generatePostgresMigrationSQL, nodes, schemaVersions, tables, uniques } from '../../chunk-7ZVPFJLQ.js';
+import '../../chunk-WFMTAEEN.js';
 import '../../chunk-6GWJH6AR.js';
 import '../../chunk-GNIYZKBI.js';
 import '../../chunk-K7SQ3SWP.js';

package/dist/backend/sqlite/index.cjs

@@ -1,8 +1,8 @@
 'use strict';
 
-var chunk56RQFK7U_cjs = require('../../chunk-56RQFK7U.cjs');
-var chunkCRMN2NOM_cjs = require('../../chunk-CRMN2NOM.cjs');
-require('../../chunk-44SXEVF4.cjs');
+var chunk5H74QKKF_cjs = require('../../chunk-5H74QKKF.cjs');
+var chunk2UTJRP4F_cjs = require('../../chunk-2UTJRP4F.cjs');
+require('../../chunk-O5PST6TB.cjs');
 require('../../chunk-LELLOHJK.cjs');
 require('../../chunk-MME3H4ZF.cjs');
 require('../../chunk-P5CNM325.cjs');
@@ -11,43 +11,43 @@ require('../../chunk-P5CNM325.cjs');
 
 Object.defineProperty(exports, "createSqliteBackend", {
   enumerable: true,
-  get: function () { return chunk56RQFK7U_cjs.createSqliteBackend; }
+  get: function () { return chunk5H74QKKF_cjs.createSqliteBackend; }
 });
 Object.defineProperty(exports, "createSqliteTables", {
   enumerable: true,
-  get: function () { return chunkCRMN2NOM_cjs.createSqliteTables; }
+  get: function () { return chunk2UTJRP4F_cjs.createSqliteTables; }
 });
 Object.defineProperty(exports, "edges", {
   enumerable: true,
-  get: function () { return chunkCRMN2NOM_cjs.edges2; }
+  get: function () { return chunk2UTJRP4F_cjs.edges2; }
 });
 Object.defineProperty(exports, "embeddings", {
   enumerable: true,
-  get: function () { return chunkCRMN2NOM_cjs.embeddings2; }
+  get: function () { return chunk2UTJRP4F_cjs.embeddings2; }
 });
 Object.defineProperty(exports, "generateSqliteDDL", {
   enumerable: true,
-  get: function () { return chunkCRMN2NOM_cjs.generateSqliteDDL; }
+  get: function () { return chunk2UTJRP4F_cjs.generateSqliteDDL; }
 });
 Object.defineProperty(exports, "generateSqliteMigrationSQL", {
   enumerable: true,
-  get: function () { return chunkCRMN2NOM_cjs.generateSqliteMigrationSQL; }
+  get: function () { return chunk2UTJRP4F_cjs.generateSqliteMigrationSQL; }
 });
 Object.defineProperty(exports, "nodes", {
   enumerable: true,
-  get: function () { return chunkCRMN2NOM_cjs.nodes2; }
+  get: function () { return chunk2UTJRP4F_cjs.nodes2; }
 });
 Object.defineProperty(exports, "schemaVersions", {
   enumerable: true,
-  get: function () { return chunkCRMN2NOM_cjs.schemaVersions2; }
+  get: function () { return chunk2UTJRP4F_cjs.schemaVersions2; }
 });
 Object.defineProperty(exports, "tables", {
   enumerable: true,
-  get: function () { return chunkCRMN2NOM_cjs.tables2; }
+  get: function () { return chunk2UTJRP4F_cjs.tables2; }
 });
 Object.defineProperty(exports, "uniques", {
   enumerable: true,
-  get: function () { return chunkCRMN2NOM_cjs.uniques2; }
+  get: function () { return chunk2UTJRP4F_cjs.uniques2; }
 });
 //# sourceMappingURL=index.cjs.map
 //# sourceMappingURL=index.cjs.map

package/dist/backend/sqlite/index.js

@@ -1,6 +1,6 @@
-export { createSqliteBackend } from '../../chunk-XZBAGJJH.js';
-export { createSqliteTables, edges2 as edges, embeddings2 as embeddings, generateSqliteDDL, generateSqliteMigrationSQL, nodes2 as nodes, schemaVersions2 as schemaVersions, tables2 as tables, uniques2 as uniques } from '../../chunk-HWWF3FOP.js';
-import '../../chunk-SJ2QMDXY.js';
+export { createSqliteBackend } from '../../chunk-IRS2C6GN.js';
+export { createSqliteTables, edges2 as edges, embeddings2 as embeddings, generateSqliteDDL, generateSqliteMigrationSQL, nodes2 as nodes, schemaVersions2 as schemaVersions, tables2 as tables, uniques2 as uniques } from '../../chunk-7ZVPFJLQ.js';
+import '../../chunk-WFMTAEEN.js';
 import '../../chunk-6GWJH6AR.js';
 import '../../chunk-GNIYZKBI.js';
 import '../../chunk-K7SQ3SWP.js';

package/dist/backend/sqlite/local.cjs

@@ -1,8 +1,8 @@
 'use strict';
 
-var chunk56RQFK7U_cjs = require('../../chunk-56RQFK7U.cjs');
-var chunkCRMN2NOM_cjs = require('../../chunk-CRMN2NOM.cjs');
-var chunk44SXEVF4_cjs = require('../../chunk-44SXEVF4.cjs');
+var chunk5H74QKKF_cjs = require('../../chunk-5H74QKKF.cjs');
+var chunk2UTJRP4F_cjs = require('../../chunk-2UTJRP4F.cjs');
+var chunkO5PST6TB_cjs = require('../../chunk-O5PST6TB.cjs');
 require('../../chunk-LELLOHJK.cjs');
 require('../../chunk-MME3H4ZF.cjs');
 require('../../chunk-P5CNM325.cjs');
@@ -34,7 +34,7 @@ function createDatabase(path) {
     const message = getUnknownErrorMessage(error);
     const mismatch = parseNodeModuleVersionMismatchMessage(message);
     if (!mismatch) throw error;
-    throw new chunk44SXEVF4_cjs.ConfigurationError(
+    throw new chunkO5PST6TB_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}.`,
@@ -53,25 +53,25 @@ function createDatabase(path) {
 }
 function createLocalSqliteBackend(options = {}) {
   const path = options.path ?? ":memory:";
-  const tables2 = options.tables ?? chunkCRMN2NOM_cjs.tables2;
+  const tables2 = options.tables ?? chunk2UTJRP4F_cjs.tables2;
   const sqlite = createDatabase(path);
   const db = betterSqlite3.drizzle(sqlite);
-  const ddlStatements = chunkCRMN2NOM_cjs.generateSqliteDDL(tables2);
+  const ddlStatements = chunk2UTJRP4F_cjs.generateSqliteDDL(tables2);
   for (const statement of ddlStatements) {
     sqlite.exec(statement);
   }
-  const backend = chunk56RQFK7U_cjs.createSqliteBackend(db, {
+  const backend = chunk5H74QKKF_cjs.createSqliteBackend(db, {
     executionProfile: {
       isSync: true
     },
     tables: tables2
   });
   let isClosed = false;
-  function close() {
-    if (isClosed) return Promise.resolve();
+  async function close() {
+    if (isClosed) return;
     isClosed = true;
+    await backend.close();
     sqlite.close();
-    return Promise.resolve();
   }
   const managedBackend = { ...backend, close };
   return { backend: managedBackend, db };

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

@@ -1 +1 @@
-{"version":3,"sources":["../../../src/backend/sqlite/local.ts"],"names":["Database","ConfigurationError","tables","drizzle","generateSqliteDDL","createSqliteBackend"],"mappings":";;;;;;;;;;;;;;;AA+CA,SAAS,uBAAuB,KAAA,EAAwB;AACtD,EAAA,IAAI,KAAA,YAAiB,KAAA,EAAO,OAAO,KAAA,CAAM,OAAA;AACzC,EAAA,OAAO,OAAO,KAAK,CAAA;AACrB;AAEA,SAAS,sCACP,OAAA,EACuC;AACvC,EAAA,MAAM,MAAA,GACJ,kFAAA;AACF,EAAA,MAAM,KAAA,GAAQ,MAAA,CAAO,IAAA,CAAK,OAAO,CAAA;AACjC,EAAA,IAAI,CAAC,KAAA,EAAO,MAAA,EAAQ,OAAO,MAAA;AAE3B,EAAA,MAAM,QAAA,GAAW,MAAA,CAAO,KAAA,CAAM,MAAA,CAAO,QAAQ,CAAA;AAC7C,EAAA,MAAM,QAAA,GAAW,MAAA,CAAO,KAAA,CAAM,MAAA,CAAO,QAAQ,CAAA;AAE7C,EAAA,IAAI,CAAC,OAAO,QAAA,CAAS,QAAQ,KAAK,CAAC,MAAA,CAAO,SAAS,QAAQ,CAAA;AACzD,IAAA,OAAO,MAAA;AAET,EAAA,OAAO,EAAE,UAAU,QAAA,EAAS;AAC9B;AAEA,SAAS,eAAe,IAAA,EAAiC;AACvD,EAAA,IAAI;AACF,IAAA,OAAO,IAAIA,0BAAS,IAAI,CAAA;AAAA,EAC1B,SAAS,KAAA,EAAO;AACd,IAAA,MAAM,OAAA,GAAU,uBAAuB,KAAK,CAAA;AAC5C,IAAA,MAAM,QAAA,GAAW,sCAAsC,OAAO,CAAA;AAC9D,IAAA,IAAI,CAAC,UAAU,MAAM,KAAA;AAErB,IAAA,MAAM,IAAIC,oCAAA;AAAA,MACR;AAAA,QACE,6CAAA;AAAA,QACA,CAAA,wCAAA,EAA2C,QAAA,CAAS,QAAQ,CAAA,oCAAA,EAAuC,SAAS,QAAQ,CAAA,CAAA,CAAA;AAAA,QACpH,4FAAA;AAAA,QACA;AAAA,OACF,CAAE,KAAK,GAAG,CAAA;AAAA,MACV;AAAA,QACE,aAAa,OAAA,CAAQ,OAAA;AAAA,QACrB,iBAAA,EAAmB,QAAQ,QAAA,CAAS,OAAA;AAAA,QACpC,2BAA2B,QAAA,CAAS,QAAA;AAAA,QACpC,2BAA2B,QAAA,CAAS;AAAA,OACtC;AAAA,MACA,EAAE,OAAO,KAAA;AAAM,KACjB;AAAA,EACF;AACF;AAmEO,SAAS,wBAAA,CACd,OAAA,GAAqC,EAAC,EACZ;AAC1B,EAAA,MAAM,IAAA,GAAO,QAAQ,IAAA,IAAQ,UAAA;AAC7B,EAAA,MAAMC,OAAAA,GAAS,QAAQ,MAAA,IAAUA,yBAAA;AAEjC,EAAA,MAAM,MAAA,GAAS,eAAe,IAAI,CAAA;AAClC,EAAA,MAAM,EAAA,GAAKC,sBAAQ,MAAM,CAAA;AAGzB,EAAA,MAAM,aAAA,GAAgBC,oCAAkBF,OAAM,CAAA;AAC9C,EAAA,KAAA,MAAW,aAAa,aAAA,EAAe;AACrC,IAAA,MAAA,CAAO,KAAK,SAAS,CAAA;AAAA,EACvB;AAEA,EAAA,MAAM,OAAA,GAAUG,sCAAoB,EAAA,EAAI;AAAA,IACtC,gBAAA,EAAkB;AAAA,MAChB,MAAA,EAAQ;AAAA,KACV;AAAA,IACA,MAAA,EAAAH;AAAA,GACD,CAAA;AACD,EAAA,IAAI,QAAA,GAAW,KAAA;AAEf,EAAA,SAAS,KAAA,GAAuB;AAC9B,IAAA,IAAI,QAAA,EAAU,OAAO,OAAA,CAAQ,OAAA,EAAQ;AACrC,IAAA,QAAA,GAAW,IAAA;AACX,IAAA,MAAA,CAAO,KAAA,EAAM;AACb,IAAA,OAAO,QAAQ,OAAA,EAAQ;AAAA,EACzB;AAEA,EAAA,MAAM,cAAA,GAA+B,EAAE,GAAG,OAAA,EAAS,KAAA,EAAM;AAEzD,EAAA,OAAO,EAAE,OAAA,EAAS,cAAA,EAAgB,EAAA,EAAG;AACvC","file":"local.cjs","sourcesContent":["/**\n * Local SQLite backend using better-sqlite3.\n *\n * This module depends on the `better-sqlite3` native addon and should only\n * be imported in Node.js environments. For bundler-friendly SQLite DDL\n * generation and Drizzle backend creation, import from `@nicia-ai/typegraph/sqlite`.\n *\n * @example In-memory database (default)\n * ```typescript\n * import { createLocalSqliteBackend } from \"@nicia-ai/typegraph/sqlite/local\";\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/local\";\n *\n * const { backend, db } = createLocalSqliteBackend({ path: \"./dev.db\" });\n * const store = createStore(graph, backend);\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 { generateSqliteDDL } from \"../drizzle/ddl\";\nimport {\n  createSqliteBackend,\n  type SqliteTables,\n  tables as defaultTables,\n} from \"../drizzle/sqlite\";\nimport type { GraphBackend } from \"../types\";\n\n// ============================================================\n// Native Addon Helpers\n// ============================================================\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      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"]}
+{"version":3,"sources":["../../../src/backend/sqlite/local.ts"],"names":["Database","ConfigurationError","tables","drizzle","generateSqliteDDL","createSqliteBackend"],"mappings":";;;;;;;;;;;;;;;AA+CA,SAAS,uBAAuB,KAAA,EAAwB;AACtD,EAAA,IAAI,KAAA,YAAiB,KAAA,EAAO,OAAO,KAAA,CAAM,OAAA;AACzC,EAAA,OAAO,OAAO,KAAK,CAAA;AACrB;AAEA,SAAS,sCACP,OAAA,EACuC;AACvC,EAAA,MAAM,MAAA,GACJ,kFAAA;AACF,EAAA,MAAM,KAAA,GAAQ,MAAA,CAAO,IAAA,CAAK,OAAO,CAAA;AACjC,EAAA,IAAI,CAAC,KAAA,EAAO,MAAA,EAAQ,OAAO,MAAA;AAE3B,EAAA,MAAM,QAAA,GAAW,MAAA,CAAO,KAAA,CAAM,MAAA,CAAO,QAAQ,CAAA;AAC7C,EAAA,MAAM,QAAA,GAAW,MAAA,CAAO,KAAA,CAAM,MAAA,CAAO,QAAQ,CAAA;AAE7C,EAAA,IAAI,CAAC,OAAO,QAAA,CAAS,QAAQ,KAAK,CAAC,MAAA,CAAO,SAAS,QAAQ,CAAA;AACzD,IAAA,OAAO,MAAA;AAET,EAAA,OAAO,EAAE,UAAU,QAAA,EAAS;AAC9B;AAEA,SAAS,eAAe,IAAA,EAAiC;AACvD,EAAA,IAAI;AACF,IAAA,OAAO,IAAIA,0BAAS,IAAI,CAAA;AAAA,EAC1B,SAAS,KAAA,EAAO;AACd,IAAA,MAAM,OAAA,GAAU,uBAAuB,KAAK,CAAA;AAC5C,IAAA,MAAM,QAAA,GAAW,sCAAsC,OAAO,CAAA;AAC9D,IAAA,IAAI,CAAC,UAAU,MAAM,KAAA;AAErB,IAAA,MAAM,IAAIC,oCAAA;AAAA,MACR;AAAA,QACE,6CAAA;AAAA,QACA,CAAA,wCAAA,EAA2C,QAAA,CAAS,QAAQ,CAAA,oCAAA,EAAuC,SAAS,QAAQ,CAAA,CAAA,CAAA;AAAA,QACpH,4FAAA;AAAA,QACA;AAAA,OACF,CAAE,KAAK,GAAG,CAAA;AAAA,MACV;AAAA,QACE,aAAa,OAAA,CAAQ,OAAA;AAAA,QACrB,iBAAA,EAAmB,QAAQ,QAAA,CAAS,OAAA;AAAA,QACpC,2BAA2B,QAAA,CAAS,QAAA;AAAA,QACpC,2BAA2B,QAAA,CAAS;AAAA,OACtC;AAAA,MACA,EAAE,OAAO,KAAA;AAAM,KACjB;AAAA,EACF;AACF;AAmEO,SAAS,wBAAA,CACd,OAAA,GAAqC,EAAC,EACZ;AAC1B,EAAA,MAAM,IAAA,GAAO,QAAQ,IAAA,IAAQ,UAAA;AAC7B,EAAA,MAAMC,OAAAA,GAAS,QAAQ,MAAA,IAAUA,yBAAA;AAEjC,EAAA,MAAM,MAAA,GAAS,eAAe,IAAI,CAAA;AAClC,EAAA,MAAM,EAAA,GAAKC,sBAAQ,MAAM,CAAA;AAGzB,EAAA,MAAM,aAAA,GAAgBC,oCAAkBF,OAAM,CAAA;AAC9C,EAAA,KAAA,MAAW,aAAa,aAAA,EAAe;AACrC,IAAA,MAAA,CAAO,KAAK,SAAS,CAAA;AAAA,EACvB;AAEA,EAAA,MAAM,OAAA,GAAUG,sCAAoB,EAAA,EAAI;AAAA,IACtC,gBAAA,EAAkB;AAAA,MAChB,MAAA,EAAQ;AAAA,KACV;AAAA,IACA,MAAA,EAAAH;AAAA,GACD,CAAA;AACD,EAAA,IAAI,QAAA,GAAW,KAAA;AAEf,EAAA,eAAe,KAAA,GAAuB;AACpC,IAAA,IAAI,QAAA,EAAU;AACd,IAAA,QAAA,GAAW,IAAA;AACX,IAAA,MAAM,QAAQ,KAAA,EAAM;AACpB,IAAA,MAAA,CAAO,KAAA,EAAM;AAAA,EACf;AAEA,EAAA,MAAM,cAAA,GAA+B,EAAE,GAAG,OAAA,EAAS,KAAA,EAAM;AAEzD,EAAA,OAAO,EAAE,OAAA,EAAS,cAAA,EAAgB,EAAA,EAAG;AACvC","file":"local.cjs","sourcesContent":["/**\n * Local SQLite backend using better-sqlite3.\n *\n * This module depends on the `better-sqlite3` native addon and should only\n * be imported in Node.js environments. For bundler-friendly SQLite DDL\n * generation and Drizzle backend creation, import from `@nicia-ai/typegraph/sqlite`.\n *\n * @example In-memory database (default)\n * ```typescript\n * import { createLocalSqliteBackend } from \"@nicia-ai/typegraph/sqlite/local\";\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/local\";\n *\n * const { backend, db } = createLocalSqliteBackend({ path: \"./dev.db\" });\n * const store = createStore(graph, backend);\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 { generateSqliteDDL } from \"../drizzle/ddl\";\nimport {\n  createSqliteBackend,\n  type SqliteTables,\n  tables as defaultTables,\n} from \"../drizzle/sqlite\";\nimport type { GraphBackend } from \"../types\";\n\n// ============================================================\n// Native Addon Helpers\n// ============================================================\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      isSync: true,\n    },\n    tables,\n  });\n  let isClosed = false;\n\n  async function close(): Promise<void> {\n    if (isClosed) return;\n    isClosed = true;\n    await backend.close();\n    sqlite.close();\n  }\n\n  const managedBackend: GraphBackend = { ...backend, close };\n\n  return { backend: managedBackend, db };\n}\n"]}

package/dist/backend/sqlite/local.js

@@ -1,6 +1,6 @@
-import { createSqliteBackend } from '../../chunk-XZBAGJJH.js';
-import { tables2, generateSqliteDDL } from '../../chunk-HWWF3FOP.js';
-import { ConfigurationError } from '../../chunk-SJ2QMDXY.js';
+import { createSqliteBackend } from '../../chunk-IRS2C6GN.js';
+import { tables2, generateSqliteDDL } from '../../chunk-7ZVPFJLQ.js';
+import { ConfigurationError } from '../../chunk-WFMTAEEN.js';
 import '../../chunk-6GWJH6AR.js';
 import '../../chunk-GNIYZKBI.js';
 import '../../chunk-K7SQ3SWP.js';
@@ -61,11 +61,11 @@ function createLocalSqliteBackend(options = {}) {
     tables: tables2$1
   });
   let isClosed = false;
-  function close() {
-    if (isClosed) return Promise.resolve();
+  async function close() {
+    if (isClosed) return;
     isClosed = true;
+    await backend.close();
     sqlite.close();
-    return Promise.resolve();
   }
   const managedBackend = { ...backend, close };
   return { backend: managedBackend, db };

package/dist/backend/sqlite/local.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../../src/backend/sqlite/local.ts"],"names":["tables"],"mappings":";;;;;;;;;AA+CA,SAAS,uBAAuB,KAAA,EAAwB;AACtD,EAAA,IAAI,KAAA,YAAiB,KAAA,EAAO,OAAO,KAAA,CAAM,OAAA;AACzC,EAAA,OAAO,OAAO,KAAK,CAAA;AACrB;AAEA,SAAS,sCACP,OAAA,EACuC;AACvC,EAAA,MAAM,MAAA,GACJ,kFAAA;AACF,EAAA,MAAM,KAAA,GAAQ,MAAA,CAAO,IAAA,CAAK,OAAO,CAAA;AACjC,EAAA,IAAI,CAAC,KAAA,EAAO,MAAA,EAAQ,OAAO,MAAA;AAE3B,EAAA,MAAM,QAAA,GAAW,MAAA,CAAO,KAAA,CAAM,MAAA,CAAO,QAAQ,CAAA;AAC7C,EAAA,MAAM,QAAA,GAAW,MAAA,CAAO,KAAA,CAAM,MAAA,CAAO,QAAQ,CAAA;AAE7C,EAAA,IAAI,CAAC,OAAO,QAAA,CAAS,QAAQ,KAAK,CAAC,MAAA,CAAO,SAAS,QAAQ,CAAA;AACzD,IAAA,OAAO,MAAA;AAET,EAAA,OAAO,EAAE,UAAU,QAAA,EAAS;AAC9B;AAEA,SAAS,eAAe,IAAA,EAAiC;AACvD,EAAA,IAAI;AACF,IAAA,OAAO,IAAI,SAAS,IAAI,CAAA;AAAA,EAC1B,SAAS,KAAA,EAAO;AACd,IAAA,MAAM,OAAA,GAAU,uBAAuB,KAAK,CAAA;AAC5C,IAAA,MAAM,QAAA,GAAW,sCAAsC,OAAO,CAAA;AAC9D,IAAA,IAAI,CAAC,UAAU,MAAM,KAAA;AAErB,IAAA,MAAM,IAAI,kBAAA;AAAA,MACR;AAAA,QACE,6CAAA;AAAA,QACA,CAAA,wCAAA,EAA2C,QAAA,CAAS,QAAQ,CAAA,oCAAA,EAAuC,SAAS,QAAQ,CAAA,CAAA,CAAA;AAAA,QACpH,4FAAA;AAAA,QACA;AAAA,OACF,CAAE,KAAK,GAAG,CAAA;AAAA,MACV;AAAA,QACE,aAAa,OAAA,CAAQ,OAAA;AAAA,QACrB,iBAAA,EAAmB,QAAQ,QAAA,CAAS,OAAA;AAAA,QACpC,2BAA2B,QAAA,CAAS,QAAA;AAAA,QACpC,2BAA2B,QAAA,CAAS;AAAA,OACtC;AAAA,MACA,EAAE,OAAO,KAAA;AAAM,KACjB;AAAA,EACF;AACF;AAmEO,SAAS,wBAAA,CACd,OAAA,GAAqC,EAAC,EACZ;AAC1B,EAAA,MAAM,IAAA,GAAO,QAAQ,IAAA,IAAQ,UAAA;AAC7B,EAAA,MAAMA,SAAAA,GAAS,QAAQ,MAAA,IAAUA,OAAA;AAEjC,EAAA,MAAM,MAAA,GAAS,eAAe,IAAI,CAAA;AAClC,EAAA,MAAM,EAAA,GAAK,QAAQ,MAAM,CAAA;AAGzB,EAAA,MAAM,aAAA,GAAgB,kBAAkBA,SAAM,CAAA;AAC9C,EAAA,KAAA,MAAW,aAAa,aAAA,EAAe;AACrC,IAAA,MAAA,CAAO,KAAK,SAAS,CAAA;AAAA,EACvB;AAEA,EAAA,MAAM,OAAA,GAAU,oBAAoB,EAAA,EAAI;AAAA,IACtC,gBAAA,EAAkB;AAAA,MAChB,MAAA,EAAQ;AAAA,KACV;AAAA,IACA,MAAA,EAAAA;AAAA,GACD,CAAA;AACD,EAAA,IAAI,QAAA,GAAW,KAAA;AAEf,EAAA,SAAS,KAAA,GAAuB;AAC9B,IAAA,IAAI,QAAA,EAAU,OAAO,OAAA,CAAQ,OAAA,EAAQ;AACrC,IAAA,QAAA,GAAW,IAAA;AACX,IAAA,MAAA,CAAO,KAAA,EAAM;AACb,IAAA,OAAO,QAAQ,OAAA,EAAQ;AAAA,EACzB;AAEA,EAAA,MAAM,cAAA,GAA+B,EAAE,GAAG,OAAA,EAAS,KAAA,EAAM;AAEzD,EAAA,OAAO,EAAE,OAAA,EAAS,cAAA,EAAgB,EAAA,EAAG;AACvC","file":"local.js","sourcesContent":["/**\n * Local SQLite backend using better-sqlite3.\n *\n * This module depends on the `better-sqlite3` native addon and should only\n * be imported in Node.js environments. For bundler-friendly SQLite DDL\n * generation and Drizzle backend creation, import from `@nicia-ai/typegraph/sqlite`.\n *\n * @example In-memory database (default)\n * ```typescript\n * import { createLocalSqliteBackend } from \"@nicia-ai/typegraph/sqlite/local\";\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/local\";\n *\n * const { backend, db } = createLocalSqliteBackend({ path: \"./dev.db\" });\n * const store = createStore(graph, backend);\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 { generateSqliteDDL } from \"../drizzle/ddl\";\nimport {\n  createSqliteBackend,\n  type SqliteTables,\n  tables as defaultTables,\n} from \"../drizzle/sqlite\";\nimport type { GraphBackend } from \"../types\";\n\n// ============================================================\n// Native Addon Helpers\n// ============================================================\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      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"]}
+{"version":3,"sources":["../../../src/backend/sqlite/local.ts"],"names":["tables"],"mappings":";;;;;;;;;AA+CA,SAAS,uBAAuB,KAAA,EAAwB;AACtD,EAAA,IAAI,KAAA,YAAiB,KAAA,EAAO,OAAO,KAAA,CAAM,OAAA;AACzC,EAAA,OAAO,OAAO,KAAK,CAAA;AACrB;AAEA,SAAS,sCACP,OAAA,EACuC;AACvC,EAAA,MAAM,MAAA,GACJ,kFAAA;AACF,EAAA,MAAM,KAAA,GAAQ,MAAA,CAAO,IAAA,CAAK,OAAO,CAAA;AACjC,EAAA,IAAI,CAAC,KAAA,EAAO,MAAA,EAAQ,OAAO,MAAA;AAE3B,EAAA,MAAM,QAAA,GAAW,MAAA,CAAO,KAAA,CAAM,MAAA,CAAO,QAAQ,CAAA;AAC7C,EAAA,MAAM,QAAA,GAAW,MAAA,CAAO,KAAA,CAAM,MAAA,CAAO,QAAQ,CAAA;AAE7C,EAAA,IAAI,CAAC,OAAO,QAAA,CAAS,QAAQ,KAAK,CAAC,MAAA,CAAO,SAAS,QAAQ,CAAA;AACzD,IAAA,OAAO,MAAA;AAET,EAAA,OAAO,EAAE,UAAU,QAAA,EAAS;AAC9B;AAEA,SAAS,eAAe,IAAA,EAAiC;AACvD,EAAA,IAAI;AACF,IAAA,OAAO,IAAI,SAAS,IAAI,CAAA;AAAA,EAC1B,SAAS,KAAA,EAAO;AACd,IAAA,MAAM,OAAA,GAAU,uBAAuB,KAAK,CAAA;AAC5C,IAAA,MAAM,QAAA,GAAW,sCAAsC,OAAO,CAAA;AAC9D,IAAA,IAAI,CAAC,UAAU,MAAM,KAAA;AAErB,IAAA,MAAM,IAAI,kBAAA;AAAA,MACR;AAAA,QACE,6CAAA;AAAA,QACA,CAAA,wCAAA,EAA2C,QAAA,CAAS,QAAQ,CAAA,oCAAA,EAAuC,SAAS,QAAQ,CAAA,CAAA,CAAA;AAAA,QACpH,4FAAA;AAAA,QACA;AAAA,OACF,CAAE,KAAK,GAAG,CAAA;AAAA,MACV;AAAA,QACE,aAAa,OAAA,CAAQ,OAAA;AAAA,QACrB,iBAAA,EAAmB,QAAQ,QAAA,CAAS,OAAA;AAAA,QACpC,2BAA2B,QAAA,CAAS,QAAA;AAAA,QACpC,2BAA2B,QAAA,CAAS;AAAA,OACtC;AAAA,MACA,EAAE,OAAO,KAAA;AAAM,KACjB;AAAA,EACF;AACF;AAmEO,SAAS,wBAAA,CACd,OAAA,GAAqC,EAAC,EACZ;AAC1B,EAAA,MAAM,IAAA,GAAO,QAAQ,IAAA,IAAQ,UAAA;AAC7B,EAAA,MAAMA,SAAAA,GAAS,QAAQ,MAAA,IAAUA,OAAA;AAEjC,EAAA,MAAM,MAAA,GAAS,eAAe,IAAI,CAAA;AAClC,EAAA,MAAM,EAAA,GAAK,QAAQ,MAAM,CAAA;AAGzB,EAAA,MAAM,aAAA,GAAgB,kBAAkBA,SAAM,CAAA;AAC9C,EAAA,KAAA,MAAW,aAAa,aAAA,EAAe;AACrC,IAAA,MAAA,CAAO,KAAK,SAAS,CAAA;AAAA,EACvB;AAEA,EAAA,MAAM,OAAA,GAAU,oBAAoB,EAAA,EAAI;AAAA,IACtC,gBAAA,EAAkB;AAAA,MAChB,MAAA,EAAQ;AAAA,KACV;AAAA,IACA,MAAA,EAAAA;AAAA,GACD,CAAA;AACD,EAAA,IAAI,QAAA,GAAW,KAAA;AAEf,EAAA,eAAe,KAAA,GAAuB;AACpC,IAAA,IAAI,QAAA,EAAU;AACd,IAAA,QAAA,GAAW,IAAA;AACX,IAAA,MAAM,QAAQ,KAAA,EAAM;AACpB,IAAA,MAAA,CAAO,KAAA,EAAM;AAAA,EACf;AAEA,EAAA,MAAM,cAAA,GAA+B,EAAE,GAAG,OAAA,EAAS,KAAA,EAAM;AAEzD,EAAA,OAAO,EAAE,OAAA,EAAS,cAAA,EAAgB,EAAA,EAAG;AACvC","file":"local.js","sourcesContent":["/**\n * Local SQLite backend using better-sqlite3.\n *\n * This module depends on the `better-sqlite3` native addon and should only\n * be imported in Node.js environments. For bundler-friendly SQLite DDL\n * generation and Drizzle backend creation, import from `@nicia-ai/typegraph/sqlite`.\n *\n * @example In-memory database (default)\n * ```typescript\n * import { createLocalSqliteBackend } from \"@nicia-ai/typegraph/sqlite/local\";\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/local\";\n *\n * const { backend, db } = createLocalSqliteBackend({ path: \"./dev.db\" });\n * const store = createStore(graph, backend);\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 { generateSqliteDDL } from \"../drizzle/ddl\";\nimport {\n  createSqliteBackend,\n  type SqliteTables,\n  tables as defaultTables,\n} from \"../drizzle/sqlite\";\nimport type { GraphBackend } from \"../types\";\n\n// ============================================================\n// Native Addon Helpers\n// ============================================================\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      isSync: true,\n    },\n    tables,\n  });\n  let isClosed = false;\n\n  async function close(): Promise<void> {\n    if (isClosed) return;\n    isClosed = true;\n    await backend.close();\n    sqlite.close();\n  }\n\n  const managedBackend: GraphBackend = { ...backend, close };\n\n  return { backend: managedBackend, db };\n}\n"]}

package/dist/{chunk-CRMN2NOM.cjs → chunk-2UTJRP4F.cjs}

@@ -1,6 +1,6 @@
 'use strict';
 
-var chunk44SXEVF4_cjs = require('./chunk-44SXEVF4.cjs');
+var chunkO5PST6TB_cjs = require('./chunk-O5PST6TB.cjs');
 var chunkLELLOHJK_cjs = require('./chunk-LELLOHJK.cjs');
 var chunkMME3H4ZF_cjs = require('./chunk-MME3H4ZF.cjs');
 var pgCore = require('drizzle-orm/pg-core');
@@ -620,7 +620,7 @@ var POSTGRES_CAPABILITIES = {
 // src/backend/drizzle/row-mappers.ts
 function requireTimestamp(value, field) {
   if (value === void 0) {
-    throw new chunk44SXEVF4_cjs.DatabaseOperationError(
+    throw new chunkO5PST6TB_cjs.DatabaseOperationError(
       `Expected non-null ${field} timestamp`,
       { operation: "select", entity: "row" }
     );
@@ -629,7 +629,7 @@ function requireTimestamp(value, field) {
 }
 function asString(value, field) {
   if (typeof value !== "string") {
-    throw new chunk44SXEVF4_cjs.DatabaseOperationError(
+    throw new chunkO5PST6TB_cjs.DatabaseOperationError(
       `Expected ${field} to be string, got ${typeof value}`,
       { operation: "select", entity: "row" }
     );
@@ -638,7 +638,7 @@ function asString(value, field) {
 }
 function asNumber(value, field) {
   if (typeof value !== "number") {
-    throw new chunk44SXEVF4_cjs.DatabaseOperationError(
+    throw new chunkO5PST6TB_cjs.DatabaseOperationError(
       `Expected ${field} to be number, got ${typeof value}`,
       { operation: "select", entity: "row" }
     );
@@ -669,7 +669,7 @@ var SQLITE_ROW_MAPPER_CONFIG = {
   formatTimestamp: (value) => {
     if (value === null || value === void 0) return;
     if (typeof value !== "string") {
-      throw new chunk44SXEVF4_cjs.DatabaseOperationError(
+      throw new chunkO5PST6TB_cjs.DatabaseOperationError(
         `Expected timestamp to be string, got ${typeof value}`,
         { operation: "select", entity: "row" }
       );
@@ -678,7 +678,7 @@ var SQLITE_ROW_MAPPER_CONFIG = {
   },
   normalizeJson: (value) => {
     if (typeof value !== "string") {
-      throw new chunk44SXEVF4_cjs.DatabaseOperationError(
+      throw new chunkO5PST6TB_cjs.DatabaseOperationError(
         `Expected JSON column to be string, got ${typeof value}`,
         { operation: "select", entity: "row" }
       );
@@ -766,7 +766,7 @@ function createCommonOperationBackend(options) {
       const timestamp2 = nowIso2();
       const query = operationStrategy.buildInsertNode(params, timestamp2);
       const row = await execution.execGet(query);
-      if (!row) throw new chunk44SXEVF4_cjs.DatabaseOperationError("Insert node failed: no row returned", { operation: "insert", entity: "node" });
+      if (!row) throw new chunkO5PST6TB_cjs.DatabaseOperationError("Insert node failed: no row returned", { operation: "insert", entity: "node" });
       return rowMappers.toNodeRow(row);
     },
     async insertNodeNoReturn(params) {
@@ -816,7 +816,7 @@ function createCommonOperationBackend(options) {
       const timestamp2 = nowIso2();
       const query = operationStrategy.buildUpdateNode(params, timestamp2);
       const row = await execution.execGet(query);
-      if (!row) throw new chunk44SXEVF4_cjs.DatabaseOperationError("Update node failed: no row returned", { operation: "update", entity: "node" });
+      if (!row) throw new chunkO5PST6TB_cjs.DatabaseOperationError("Update node failed: no row returned", { operation: "update", entity: "node" });
       return rowMappers.toNodeRow(row);
     },
     async deleteNode(params) {
@@ -851,7 +851,7 @@ function createCommonOperationBackend(options) {
       const timestamp2 = nowIso2();
       const query = operationStrategy.buildInsertEdge(params, timestamp2);
       const row = await execution.execGet(query);
-      if (!row) throw new chunk44SXEVF4_cjs.DatabaseOperationError("Insert edge failed: no row returned", { operation: "insert", entity: "edge" });
+      if (!row) throw new chunkO5PST6TB_cjs.DatabaseOperationError("Insert edge failed: no row returned", { operation: "insert", entity: "edge" });
       return rowMappers.toEdgeRow(row);
     },
     async insertEdgeNoReturn(params) {
@@ -901,7 +901,7 @@ function createCommonOperationBackend(options) {
       const timestamp2 = nowIso2();
       const query = operationStrategy.buildUpdateEdge(params, timestamp2);
       const row = await execution.execGet(query);
-      if (!row) throw new chunk44SXEVF4_cjs.DatabaseOperationError("Update edge failed: no row returned", { operation: "update", entity: "edge" });
+      if (!row) throw new chunkO5PST6TB_cjs.DatabaseOperationError("Update edge failed: no row returned", { operation: "update", entity: "edge" });
       return rowMappers.toEdgeRow(row);
     },
     async deleteEdge(params) {
@@ -952,7 +952,7 @@ function createCommonOperationBackend(options) {
       const query = operationStrategy.buildInsertUnique(params);
       const result = await execution.execGet(query);
       if (result && result.node_id !== params.nodeId) {
-        throw new chunk44SXEVF4_cjs.UniquenessError({
+        throw new chunkO5PST6TB_cjs.UniquenessError({
           constraintName: params.constraintName,
           kind: params.nodeKind,
           existingId: result.node_id,
@@ -990,7 +990,7 @@ function createCommonOperationBackend(options) {
       const timestamp2 = nowIso2();
       const query = operationStrategy.buildInsertSchema(params, timestamp2);
       const row = await execution.execGet(query);
-      if (!row) throw new chunk44SXEVF4_cjs.DatabaseOperationError("Insert schema failed: no row returned", { operation: "insert", entity: "schema" });
+      if (!row) throw new chunkO5PST6TB_cjs.DatabaseOperationError("Insert schema failed: no row returned", { operation: "insert", entity: "schema" });
       return rowMappers.toSchemaVersionRow(row);
     },
     async getSchemaVersion(graphId, version) {
@@ -2160,5 +2160,5 @@ exports.tables = tables;
 exports.tables2 = tables2;
 exports.uniques = uniques;
 exports.uniques2 = uniques2;
-//# sourceMappingURL=chunk-CRMN2NOM.cjs.map
-//# sourceMappingURL=chunk-CRMN2NOM.cjs.map
+//# sourceMappingURL=chunk-2UTJRP4F.cjs.map
+//# sourceMappingURL=chunk-2UTJRP4F.cjs.map