@nicia-ai/typegraph 0.4.0 → 0.6.0

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

@@ -1,72 +1,36 @@
-import { BetterSQLite3Database } from 'drizzle-orm/better-sqlite3';
-export { SqliteBackendOptions, createSqliteBackend } from '../drizzle/sqlite.js';
-import { G as GraphBackend } from '../../types-6EKrWTs9.js';
-import { SqliteTables } from '../drizzle/schema/sqlite.js';
-export { SqliteTableNames, createSqliteTables, edges, nodes, schemaVersions, tables, uniques } from '../drizzle/schema/sqlite.js';
-export { b as generateSqliteDDL, c as getSqliteMigrationSQL } from '../../test-helpers-CIq1Hhj1.js';
-import 'drizzle-orm/sqlite-core';
+import { G as GraphBackend } from '../../types-D5ggX07j.js';
+import { BaseSQLiteDatabase } from 'drizzle-orm/sqlite-core';
+import { S as SqliteTables } from '../../sqlite-CSJ-fgIm.js';
+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-CSJ-fgIm.js';
+export { g as generateSqliteDDL, a as generateSqliteMigrationSQL } from '../../ddl-D7DQx8w8.js';
 import 'drizzle-orm';
-import '../../types-DTJEu_-h.js';
+import '../../types-DolHw9pJ.js';
 import 'zod';
-import '../../types-BRzHlhKC.js';
-import '../../types-ZT5mlism.js';
-import '../../ast-CXFx6bF6.js';
-import '../drizzle/schema/postgres.js';
+import '../../types-C2rhqkg7.js';
+import '../../ast-CG87Zr6p.js';
 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 };

package/dist/backend/sqlite/index.js

@@ -1,83 +1,8 @@
-import { generateSqliteDDL } from '../../chunk-SMLIWLS7.js';
-export { generateSqliteDDL, getSqliteMigrationSQL } from '../../chunk-SMLIWLS7.js';
-import { createSqliteBackend } from '../../chunk-ZO2FRJ2U.js';
-export { createSqliteBackend } from '../../chunk-ZO2FRJ2U.js';
-import '../../chunk-ZQGOBVXZ.js';
-import { tables } from '../../chunk-OGGLFYFA.js';
-export { createSqliteTables, edges, nodes, schemaVersions, tables, uniques } from '../../chunk-OGGLFYFA.js';
-import '../../chunk-3PURVEA4.js';
-import { ConfigurationError } from '../../chunk-SJ2QMDXY.js';
+export { createSqliteBackend } from '../../chunk-2DKSQNPW.js';
+export { createSqliteTables, edges, embeddings, generateSqliteDDL, generateSqliteMigrationSQL, nodes, schemaVersions, tables, uniques } from '../../chunk-JPO7W262.js';
+import '../../chunk-SJ2QMDXY.js';
 import '../../chunk-U3452TEU.js';
 import '../../chunk-54WJF3DW.js';
 import '../../chunk-K7SQ3SWP.js';
-import Database from 'better-sqlite3';
-import { drizzle } from 'drizzle-orm/better-sqlite3';
-
-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(path);
-  } catch (error) {
-    const message = getUnknownErrorMessage(error);
-    const mismatch = parseNodeModuleVersionMismatchMessage(message);
-    if (!mismatch) throw error;
-    throw new 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 ?? tables;
-  const sqlite = createDatabase(path);
-  const db = drizzle(sqlite);
-  const ddlStatements = generateSqliteDDL(tables2);
-  for (const statement of ddlStatements) {
-    sqlite.exec(statement);
-  }
-  const backend = 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 };
-}
-
-export { createLocalSqliteBackend };
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map

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

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

package/dist/backend/sqlite/local.cjs

@@ -0,0 +1,83 @@
+'use strict';
+
+var chunkK5O7TOJO_cjs = require('../../chunk-K5O7TOJO.cjs');
+var chunk23NGZHUN_cjs = require('../../chunk-23NGZHUN.cjs');
+var chunk44SXEVF4_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 ?? chunk23NGZHUN_cjs.tables;
+  const sqlite = createDatabase(path);
+  const db = betterSqlite3.drizzle(sqlite);
+  const ddlStatements = chunk23NGZHUN_cjs.generateSqliteDDL(tables2);
+  for (const statement of ddlStatements) {
+    sqlite.exec(statement);
+  }
+  const backend = chunkK5O7TOJO_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 };
+}
+
+exports.createLocalSqliteBackend = createLocalSqliteBackend;
+//# sourceMappingURL=local.cjs.map
+//# sourceMappingURL=local.cjs.map

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

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/backend/sqlite/local.ts"],"names":["Database","ConfigurationError","tables","drizzle","generateSqliteDDL","createSqliteBackend"],"mappings":"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","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      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"]}

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

@@ -0,0 +1,66 @@
+import { BetterSQLite3Database } from 'drizzle-orm/better-sqlite3';
+import { G as GraphBackend } from '../../types-SVDEKnU6.cjs';
+import { S as SqliteTables } from '../../sqlite-FWGZLwDd.cjs';
+import 'drizzle-orm';
+import '../../types-DolHw9pJ.cjs';
+import 'zod';
+import 'drizzle-orm/sqlite-core';
+import '../../types-BbMn2Ycv.cjs';
+import '../../ast-Cq9qrnNP.cjs';
+
+/**
+ * Options for creating a local SQLite backend.
+ */
+type LocalSqliteBackendOptions = Readonly<{
+    /**
+     * Path to the SQLite database file.
+     * Defaults to ":memory:" for an in-memory database.
+     */
+    path?: string;
+    /**
+     * Custom table definitions.
+     * 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.
+     */
+    db: BetterSQLite3Database;
+}>;
+/**
+ * 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;
+
+export { type LocalSqliteBackendOptions, type LocalSqliteBackendResult, createLocalSqliteBackend };

package/dist/backend/sqlite/local.d.ts

@@ -0,0 +1,66 @@
+import { BetterSQLite3Database } from 'drizzle-orm/better-sqlite3';
+import { G as GraphBackend } from '../../types-D5ggX07j.js';
+import { S as SqliteTables } from '../../sqlite-CSJ-fgIm.js';
+import 'drizzle-orm';
+import '../../types-DolHw9pJ.js';
+import 'zod';
+import 'drizzle-orm/sqlite-core';
+import '../../types-C2rhqkg7.js';
+import '../../ast-CG87Zr6p.js';
+
+/**
+ * Options for creating a local SQLite backend.
+ */
+type LocalSqliteBackendOptions = Readonly<{
+    /**
+     * Path to the SQLite database file.
+     * Defaults to ":memory:" for an in-memory database.
+     */
+    path?: string;
+    /**
+     * Custom table definitions.
+     * 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.
+     */
+    db: BetterSQLite3Database;
+}>;
+/**
+ * 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;
+
+export { type LocalSqliteBackendOptions, type LocalSqliteBackendResult, createLocalSqliteBackend };

package/dist/backend/sqlite/local.js

@@ -0,0 +1,77 @@
+import { createSqliteBackend } from '../../chunk-2DKSQNPW.js';
+import { tables, generateSqliteDDL } from '../../chunk-JPO7W262.js';
+import { ConfigurationError } from '../../chunk-SJ2QMDXY.js';
+import '../../chunk-U3452TEU.js';
+import '../../chunk-54WJF3DW.js';
+import '../../chunk-K7SQ3SWP.js';
+import Database from 'better-sqlite3';
+import { drizzle } from 'drizzle-orm/better-sqlite3';
+
+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(path);
+  } catch (error) {
+    const message = getUnknownErrorMessage(error);
+    const mismatch = parseNodeModuleVersionMismatchMessage(message);
+    if (!mismatch) throw error;
+    throw new 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 ?? tables;
+  const sqlite = createDatabase(path);
+  const db = drizzle(sqlite);
+  const ddlStatements = generateSqliteDDL(tables2);
+  for (const statement of ddlStatements) {
+    sqlite.exec(statement);
+  }
+  const backend = 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 };
+}
+
+export { createLocalSqliteBackend };
+//# sourceMappingURL=local.js.map
+//# sourceMappingURL=local.js.map

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

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/backend/sqlite/local.ts"],"names":["tables"],"mappings":"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","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      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"]}