@nicia-ai/typegraph 0.30.0 → 0.32.0

package/README.md

@@ -46,6 +46,45 @@ See the repo README for more.
 
 Examples: [github.com/nicia-ai/typegraph/tree/main/packages/typegraph/examples](https://github.com/nicia-ai/typegraph/tree/main/packages/typegraph/examples)
 
+## Graph Merge
+
+TypeGraph ships semantic graph merge as a dedicated subpath:
+
+```ts
+import { branch, merge } from "@nicia-ai/typegraph/graph-merge";
+```
+
+`branch()` creates isolated working copies over caller-provided backends, stamped
+with the base graph's schema and content version. `merge()` reconciles those
+branches back into a target graph with deterministic entity resolution, conflict
+reporting, edge repointing, optional ontology type reconciliation, and provenance
+reporting.
+
+Use it when several agents, importers, reviewers, or local workers edit graph
+state independently and the application needs one canonical result instead of an
+append-only pile of duplicates. The merge pipeline can:
+
+- resolve duplicate entities by exact unique constraints, blocking keys,
+  fulltext/custom similarity, or vector/hybrid similarity;
+- preserve branch-specific context by repointing edges to canonical nodes;
+- surface property and delete/modify conflicts (for nodes and edges) in a
+  `MergeReport`, three-way merged against base so disjoint edits compose;
+- expose report-only provenance, with optional sidecar persistence you can query.
+
+`merge()` is a snapshot merge (all branches forked from the current base);
+`mergeIncremental()` additively folds a new source into a target that has already
+advanced, re-discovering committed entities instead of duplicating them — the
+primitive for continuous ingestion.
+
+It lives in the core package because the primitive is defined over TypeGraph
+stores, schemas, indexes, backends, and ontology semantics rather than as a
+separate product surface.
+
+Docs: [Graph Merge](https://typegraph.dev/graph-merge)
+
+Examples: [FHIR Graph Merge](https://typegraph.dev/examples/fhir-graph-merge)
+· [Incremental Merge](https://typegraph.dev/examples/incremental-merge)
+
 ## Performance Smoke Check
 
 The perf harness lives in `@nicia-ai/typegraph-benchmarks`; these commands delegate to it.

package/dist/backend/postgres/index.cjs

@@ -1,14 +1,15 @@
 'use strict';
 
-var chunk26HWIIVS_cjs = require('../../chunk-26HWIIVS.cjs');
-require('../../chunk-IE6GN7L3.cjs');
-var chunkWFCECD6Q_cjs = require('../../chunk-WFCECD6Q.cjs');
-require('../../chunk-WEMZM7J7.cjs');
+var chunkYL4F3CMD_cjs = require('../../chunk-YL4F3CMD.cjs');
+require('../../chunk-YW7GHMF4.cjs');
+require('../../chunk-HTGDWIDE.cjs');
+var chunk3HQDMOBK_cjs = require('../../chunk-3HQDMOBK.cjs');
+require('../../chunk-JKRKIEVA.cjs');
+require('../../chunk-WWVV44DY.cjs');
+require('../../chunk-6G35I3VW.cjs');
 require('../../chunk-RP7YITHX.cjs');
-require('../../chunk-UESTHN47.cjs');
-require('../../chunk-4BXHVEFB.cjs');
-require('../../chunk-YQGLVWB2.cjs');
-require('../../chunk-ZFWNO3GE.cjs');
+require('../../chunk-CFNT3ITG.cjs');
+require('../../chunk-73KASJGO.cjs');
 require('../../chunk-JIEJCTDS.cjs');
 require('../../chunk-FLRCVI2G.cjs');
 
@@ -16,43 +17,43 @@ require('../../chunk-FLRCVI2G.cjs');
 
 Object.defineProperty(exports, "createPostgresBackend", {
   enumerable: true,
-  get: function () { return chunk26HWIIVS_cjs.createPostgresBackend; }
+  get: function () { return chunkYL4F3CMD_cjs.createPostgresBackend; }
 });
 Object.defineProperty(exports, "createPostgresTables", {
   enumerable: true,
-  get: function () { return chunkWFCECD6Q_cjs.createPostgresTables; }
+  get: function () { return chunk3HQDMOBK_cjs.createPostgresTables; }
 });
 Object.defineProperty(exports, "edges", {
   enumerable: true,
-  get: function () { return chunkWFCECD6Q_cjs.edges; }
+  get: function () { return chunk3HQDMOBK_cjs.edges; }
 });
 Object.defineProperty(exports, "fulltext", {
   enumerable: true,
-  get: function () { return chunkWFCECD6Q_cjs.fulltext; }
+  get: function () { return chunk3HQDMOBK_cjs.fulltext; }
 });
 Object.defineProperty(exports, "generatePostgresDDL", {
   enumerable: true,
-  get: function () { return chunkWFCECD6Q_cjs.generatePostgresDDL; }
+  get: function () { return chunk3HQDMOBK_cjs.generatePostgresDDL; }
 });
 Object.defineProperty(exports, "generatePostgresMigrationSQL", {
   enumerable: true,
-  get: function () { return chunkWFCECD6Q_cjs.generatePostgresMigrationSQL; }
+  get: function () { return chunk3HQDMOBK_cjs.generatePostgresMigrationSQL; }
 });
 Object.defineProperty(exports, "nodes", {
   enumerable: true,
-  get: function () { return chunkWFCECD6Q_cjs.nodes; }
+  get: function () { return chunk3HQDMOBK_cjs.nodes; }
 });
 Object.defineProperty(exports, "schemaVersions", {
   enumerable: true,
-  get: function () { return chunkWFCECD6Q_cjs.schemaVersions; }
+  get: function () { return chunk3HQDMOBK_cjs.schemaVersions; }
 });
 Object.defineProperty(exports, "tables", {
   enumerable: true,
-  get: function () { return chunkWFCECD6Q_cjs.tables; }
+  get: function () { return chunk3HQDMOBK_cjs.tables; }
 });
 Object.defineProperty(exports, "uniques", {
   enumerable: true,
-  get: function () { return chunkWFCECD6Q_cjs.uniques; }
+  get: function () { return chunk3HQDMOBK_cjs.uniques; }
 });
 //# sourceMappingURL=index.cjs.map
 //# sourceMappingURL=index.cjs.map

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

@@ -1,13 +1,13 @@
-import { F as FulltextStrategy, V as VectorStrategy, B as BackendCapabilities, b as AnyPgDatabase, G as GraphBackend } from '../../types-dL-clxO3.cjs';
-import { P as PostgresTables } from '../../postgres-CK2ByP1q.cjs';
-export { C as CreatePostgresTablesOptions, a as PostgresTableNames, c as createPostgresTables, e as edges, f as fulltext, n as nodes, s as schemaVersions, t as tables, u as uniques } from '../../postgres-CK2ByP1q.cjs';
-export { b as generatePostgresDDL, c as generatePostgresMigrationSQL } from '../../ddl-BSFlbGQF.cjs';
+import { F as FulltextStrategy, V as VectorStrategy, B as BackendCapabilities, b as AnyPgDatabase, G as GraphBackend } from '../../types-Dvmn-eal.cjs';
+import { P as PostgresTables } from '../../postgres-jgXmD45C.cjs';
+export { C as CreatePostgresTablesOptions, a as PostgresTableNames, c as createPostgresTables, e as edges, f as fulltext, n as nodes, s as schemaVersions, t as tables, u as uniques } from '../../postgres-jgXmD45C.cjs';
+export { b as generatePostgresDDL, c as generatePostgresMigrationSQL } from '../../ddl-CwyG4HoQ.cjs';
 import 'zod';
-import '../../extension-types-CwHV-Uk4.cjs';
+import '../../extension-types-D1k0inWU.cjs';
 import 'drizzle-orm';
 import 'drizzle-orm/pg-core';
 import 'drizzle-orm/sqlite-core';
-import '../../sqlite-DxH1lrwD.cjs';
+import '../../sqlite-DcQ_BCUW.cjs';
 
 /**
  * Options for creating a PostgreSQL backend.

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

@@ -1,13 +1,13 @@
-import { F as FulltextStrategy, V as VectorStrategy, B as BackendCapabilities, b as AnyPgDatabase, G as GraphBackend } from '../../types-BBiDqJCU.js';
-import { P as PostgresTables } from '../../postgres-ymXYC6Rr.js';
-export { C as CreatePostgresTablesOptions, a as PostgresTableNames, c as createPostgresTables, e as edges, f as fulltext, n as nodes, s as schemaVersions, t as tables, u as uniques } from '../../postgres-ymXYC6Rr.js';
-export { b as generatePostgresDDL, c as generatePostgresMigrationSQL } from '../../ddl-EdkIiFVU.js';
+import { F as FulltextStrategy, V as VectorStrategy, B as BackendCapabilities, b as AnyPgDatabase, G as GraphBackend } from '../../types-Dk8r09KY.js';
+import { P as PostgresTables } from '../../postgres-Dhom7iiX.js';
+export { C as CreatePostgresTablesOptions, a as PostgresTableNames, c as createPostgresTables, e as edges, f as fulltext, n as nodes, s as schemaVersions, t as tables, u as uniques } from '../../postgres-Dhom7iiX.js';
+export { b as generatePostgresDDL, c as generatePostgresMigrationSQL } from '../../ddl-C8e8zDAE.js';
 import 'zod';
-import '../../extension-types-CwHV-Uk4.js';
+import '../../extension-types-D1k0inWU.js';
 import 'drizzle-orm';
 import 'drizzle-orm/pg-core';
 import 'drizzle-orm/sqlite-core';
-import '../../sqlite-R8YGOqVQ.js';
+import '../../sqlite-BfLsCEqO.js';
 
 /**
  * Options for creating a PostgreSQL backend.

package/dist/backend/postgres/index.js

@@ -1,12 +1,13 @@
-export { createPostgresBackend } from '../../chunk-K5VREXMZ.js';
-import '../../chunk-FVIGJTS7.js';
-export { createPostgresTables, edges, fulltext, generatePostgresDDL, generatePostgresMigrationSQL, nodes, schemaVersions, tables, uniques } from '../../chunk-N2OEOGBB.js';
-import '../../chunk-633N7DSE.js';
+export { createPostgresBackend } from '../../chunk-NDM5PXEH.js';
+import '../../chunk-PRMKPFN5.js';
+import '../../chunk-3EUKJEQ3.js';
+export { createPostgresTables, edges, fulltext, generatePostgresDDL, generatePostgresMigrationSQL, nodes, schemaVersions, tables, uniques } from '../../chunk-TUA3MEJJ.js';
+import '../../chunk-XQFAJVYW.js';
+import '../../chunk-CWFPJ3RC.js';
+import '../../chunk-SAJSMR2B.js';
 import '../../chunk-M6OC455F.js';
-import '../../chunk-AI3RNREM.js';
-import '../../chunk-R4JOBEJU.js';
-import '../../chunk-MXE2U3EX.js';
-import '../../chunk-454I6GDF.js';
+import '../../chunk-C4C4Q7A6.js';
+import '../../chunk-2YMGNYXY.js';
 import '../../chunk-TQOYM4LN.js';
 import '../../chunk-K5P5OZXS.js';
 //# sourceMappingURL=index.js.map

package/dist/backend/postgres/pglite.cjs

@@ -1,14 +1,15 @@
 'use strict';
 
-var chunk26HWIIVS_cjs = require('../../chunk-26HWIIVS.cjs');
-require('../../chunk-IE6GN7L3.cjs');
-var chunkWFCECD6Q_cjs = require('../../chunk-WFCECD6Q.cjs');
-var chunkWEMZM7J7_cjs = require('../../chunk-WEMZM7J7.cjs');
+var chunkYL4F3CMD_cjs = require('../../chunk-YL4F3CMD.cjs');
+require('../../chunk-YW7GHMF4.cjs');
+require('../../chunk-HTGDWIDE.cjs');
+var chunk3HQDMOBK_cjs = require('../../chunk-3HQDMOBK.cjs');
+require('../../chunk-JKRKIEVA.cjs');
+require('../../chunk-WWVV44DY.cjs');
+var chunk6G35I3VW_cjs = require('../../chunk-6G35I3VW.cjs');
 require('../../chunk-RP7YITHX.cjs');
-require('../../chunk-UESTHN47.cjs');
-require('../../chunk-4BXHVEFB.cjs');
-require('../../chunk-YQGLVWB2.cjs');
-require('../../chunk-ZFWNO3GE.cjs');
+require('../../chunk-CFNT3ITG.cjs');
+require('../../chunk-73KASJGO.cjs');
 var chunkJIEJCTDS_cjs = require('../../chunk-JIEJCTDS.cjs');
 require('../../chunk-FLRCVI2G.cjs');
 var pglite = require('@electric-sql/pglite');
@@ -27,21 +28,21 @@ async function loadDefaultPgvectorExtension() {
   }
 }
 async function createLocalPgliteBackend(options = {}) {
-  const tables2 = options.tables ?? chunkWFCECD6Q_cjs.tables;
+  const tables2 = options.tables ?? chunk3HQDMOBK_cjs.tables;
   const vectorExtension = options.vector === false ? void 0 : options.vector ?? await loadDefaultPgvectorExtension();
   const vectorEnabled = vectorExtension !== void 0;
   const client = await pglite.PGlite.create({
     ...options.dataDir === void 0 ? {} : { dataDir: options.dataDir },
     ...vectorExtension === void 0 ? {} : { extensions: { vector: vectorExtension } }
   });
-  const migrationSql = vectorEnabled ? chunkWFCECD6Q_cjs.generatePostgresMigrationSQL(tables2) : chunkWFCECD6Q_cjs.generatePostgresDDL(tables2).join("\n\n");
+  const migrationSql = vectorEnabled ? chunk3HQDMOBK_cjs.generatePostgresMigrationSQL(tables2) : chunk3HQDMOBK_cjs.generatePostgresDDL(tables2).join("\n\n");
   await client.exec(migrationSql);
   const db = pglite$1.drizzle(client);
-  const backend = chunk26HWIIVS_cjs.createPostgresBackend(db, {
+  const backend = chunkYL4F3CMD_cjs.createPostgresBackend(db, {
     tables: tables2,
     ...vectorEnabled ? {} : { vector: false }
   });
-  const managedBackend = chunkWEMZM7J7_cjs.wrapWithManagedClose(backend, async () => {
+  const managedBackend = chunk6G35I3VW_cjs.wrapWithManagedClose(backend, async () => {
     await client.close();
   });
   return { backend: managedBackend, db, client };

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

@@ -1 +1 @@
-{"version":3,"sources":["../../../src/backend/postgres/pglite.ts"],"names":["ConfigurationError","tables","PGlite","generatePostgresMigrationSQL","generatePostgresDDL","drizzle","createPostgresBackend","wrapWithManagedClose"],"mappings":";;;;;;;;;;;;;;;;AA2HA,eAAe,4BAAA,GAAmD;AAChE,EAAA,IAAI;AACF,IAAA,MAAM,OAAA,GAAU,MAAM,OAAO,+BAA+B,CAAA;AAC5D,IAAA,OAAO,OAAA,CAAQ,MAAA;AAAA,EACjB,SAAS,KAAA,EAAO;AACd,IAAA,MAAM,IAAIA,oCAAA;AAAA,MACR,2PAAA;AAAA,MAIA,EAAE,OAAA,EAAS,QAAA,EAAU,UAAA,EAAY,+BAAA,EAAgC;AAAA,MACjE,EAAE,OAAO,KAAA;AAAM,KACjB;AAAA,EACF;AACF;AAoBA,eAAsB,wBAAA,CACpB,OAAA,GAAqC,EAAC,EACH;AACnC,EAAA,MAAMC,OAAAA,GAAS,QAAQ,MAAA,IAAUA,wBAAA;AAMjC,EAAA,MAAM,eAAA,GACJ,QAAQ,MAAA,KAAW,KAAA,GACjB,SACC,OAAA,CAAQ,MAAA,IAAW,MAAM,4BAAA,EAA6B;AAC3D,EAAA,MAAM,gBAAgB,eAAA,KAAoB,MAAA;AAO1C,EAAA,MAAM,MAAA,GAAS,MAAMC,aAAA,CAAO,MAAA,CAAO;AAAA,IACjC,GAAI,QAAQ,OAAA,KAAY,MAAA,GAAY,EAAC,GAAI,EAAE,OAAA,EAAS,OAAA,CAAQ,OAAA,EAAQ;AAAA,IACpE,GAAI,eAAA,KAAoB,MAAA,GACtB,EAAC,GACD,EAAE,UAAA,EAAY,EAAE,MAAA,EAAQ,eAAA,EAAgB;AAAE,GAC7C,CAAA;AAID,EAAA,MAAM,YAAA,GACJ,gBACEC,8CAAA,CAA6BF,OAAM,IACnCG,qCAAA,CAAoBH,OAAM,CAAA,CAAE,IAAA,CAAK,MAAM,CAAA;AAC3C,EAAA,MAAM,MAAA,CAAO,KAAK,YAAY,CAAA;AAE9B,EAAA,MAAM,EAAA,GAAKI,iBAAQ,MAAM,CAAA;AACzB,EAAA,MAAM,OAAA,GAAUC,wCAAsB,EAAA,EAAI;AAAA,IACxC,MAAA,EAAAL,OAAAA;AAAA,IACA,GAAI,aAAA,GAAgB,EAAC,GAAI,EAAE,QAAQ,KAAA;AAAM,GAC1C,CAAA;AACD,EAAA,MAAM,cAAA,GAAiBM,sCAAA,CAAqB,OAAA,EAAS,YAAY;AAC/D,IAAA,MAAM,OAAO,KAAA,EAAM;AAAA,EACrB,CAAC,CAAA;AAED,EAAA,OAAO,EAAE,OAAA,EAAS,cAAA,EAAgB,EAAA,EAAI,MAAA,EAAO;AAC/C","file":"pglite.cjs","sourcesContent":["/**\n * Local PGlite backend — Postgres-in-WASM, running in-process.\n *\n * [PGlite](https://pglite.dev/) is a full Postgres compiled to WebAssembly\n * that runs inside the Node/Bun/Deno/browser process with no server and no\n * native addon. This is the batteries-included Postgres analog of\n * `createLocalSqliteBackend`: it constructs a PGlite instance, loads the\n * pgvector extension, runs the schema DDL, and returns a ready\n * `{ backend, db }` pair whose `close()` disposes the engine.\n *\n * `@electric-sql/pglite` is an optional peer dependency. Vector support\n * additionally needs `@electric-sql/pglite-pgvector` (PGlite ≥ 0.5 ships\n * pgvector as a separate package). Install what you need:\n *\n * ```bash\n * pnpm add @electric-sql/pglite @electric-sql/pglite-pgvector\n * ```\n *\n * @example In-memory database (default, vector enabled)\n * ```typescript\n * import { createLocalPgliteBackend } from \"@nicia-ai/typegraph/postgres/pglite\";\n *\n * const { backend } = await createLocalPgliteBackend();\n * const store = createStore(graph, backend);\n * ```\n *\n * @example Persistent on-disk database\n * ```typescript\n * const { backend, db } = await createLocalPgliteBackend({ dataDir: \"./pgdata\" });\n * ```\n *\n * @example No vector support (skip the pgvector extension)\n * ```typescript\n * const { backend } = await createLocalPgliteBackend({ vector: false });\n * ```\n *\n * PGlite is single-connection and serial: there is no pooling, so concurrent\n * `store.transaction()` calls queue rather than run in parallel.\n */\nimport { type Extension, PGlite } from \"@electric-sql/pglite\";\nimport { drizzle, type PgliteDatabase } from \"drizzle-orm/pglite\";\n\nimport { ConfigurationError } from \"../../errors\";\nimport {\n  generatePostgresDDL,\n  generatePostgresMigrationSQL,\n} from \"../drizzle/ddl\";\nimport {\n  createPostgresBackend,\n  type PostgresTables,\n  tables as defaultTables,\n} from \"../drizzle/postgres\";\nimport { type GraphBackend, wrapWithManagedClose } from \"../types\";\n\n// ============================================================\n// Types\n// ============================================================\n\n/**\n * Options for creating a local PGlite backend.\n */\nexport type LocalPgliteBackendOptions = Readonly<{\n  /**\n   * PGlite data directory. Omit for an in-memory database (the default).\n   * Accepts any PGlite data-dir spec: a filesystem path (`\"./pgdata\"`),\n   * `\"memory://\"`, or a browser/runtime-specific scheme such as\n   * `\"idb://my-db\"`.\n   */\n  dataDir?: string;\n\n  /**\n   * Custom table definitions. Defaults to standard TypeGraph table names.\n   */\n  tables?: PostgresTables;\n\n  /**\n   * Controls the pgvector stack:\n   *\n   * - **omitted (default)** — load pgvector from `@electric-sql/pglite-pgvector`\n   *   and run `CREATE EXTENSION vector`, so embedding fields work out of the\n   *   box. Throws a {@link ConfigurationError} if the package isn't installed.\n   * - **`false`** — skip the extension entirely; the backend advertises no\n   *   vector capability (mirroring a SQLite connection without sqlite-vec).\n   *   Use when a graph carries no embeddings, or to avoid the extension dep.\n   * - **a PGlite `Extension`** — bring your own pgvector build or custom\n   *   extension packaging. Decouples this helper from a specific pgvector\n   *   package version.\n   */\n  vector?: false | Extension;\n}>;\n\n/**\n * Result of creating a local PGlite backend.\n */\nexport type LocalPgliteBackendResult = Readonly<{\n  /**\n   * The GraphBackend instance for use with createStore. Its `close()`\n   * disposes the underlying PGlite engine.\n   */\n  backend: GraphBackend;\n\n  /**\n   * The underlying Drizzle database instance. Useful for direct SQL access.\n   */\n  db: PgliteDatabase;\n\n  /**\n   * The raw PGlite instance, for engine-specific operations such as\n   * `dumpDataDir()` / `clone()` not surfaced through Drizzle.\n   */\n  client: PGlite;\n}>;\n\n// ============================================================\n// Vector extension loading\n// ============================================================\n\n/**\n * Dynamically loads the default pgvector extension from\n * `@electric-sql/pglite-pgvector`. Kept as a runtime import so the package\n * stays an optional peer dependency — callers using `vector: false` or\n * supplying their own extension never need it installed.\n */\nasync function loadDefaultPgvectorExtension(): Promise<Extension> {\n  try {\n    const module_ = await import(\"@electric-sql/pglite-pgvector\");\n    return module_.vector;\n  } catch (error) {\n    throw new ConfigurationError(\n      \"createLocalPgliteBackend needs the pgvector extension but \" +\n        \"`@electric-sql/pglite-pgvector` could not be loaded. Install it \" +\n        \"(`pnpm add @electric-sql/pglite-pgvector`), pass your own `vector` \" +\n        \"extension, or set `vector: false` to disable vector support.\",\n      { backend: \"pglite\", dependency: \"@electric-sql/pglite-pgvector\" },\n      { cause: error },\n    );\n  }\n}\n\n// ============================================================\n// Factory Function\n// ============================================================\n\n/**\n * Creates a TypeGraph backend backed by an in-process PGlite database.\n *\n * Constructs the PGlite engine (loading pgvector unless disabled), executes\n * the schema DDL, and wires the standard Postgres backend. The returned\n * backend owns the engine: call `backend.close()` to dispose it.\n *\n * For production Postgres, or a PGlite instance you construct yourself,\n * use `createPostgresBackend` directly with your own Drizzle database — the\n * execution fast path detects PGlite and routes it correctly.\n *\n * @param options - Configuration options\n * @returns Backend, Drizzle database, and raw PGlite client\n */\nexport async function createLocalPgliteBackend(\n  options: LocalPgliteBackendOptions = {},\n): Promise<LocalPgliteBackendResult> {\n  const tables = options.tables ?? defaultTables;\n\n  // pgvector lives in the WASM instance, so the extension must be passed at\n  // construction — `CREATE EXTENSION vector` alone can't pull it in. An\n  // explicitly supplied extension wins; `false` disables; otherwise load the\n  // default package.\n  const vectorExtension =\n    options.vector === false ?\n      undefined\n    : (options.vector ?? (await loadDefaultPgvectorExtension()));\n  const vectorEnabled = vectorExtension !== undefined;\n\n  // Construct via the single options-object form (passing `dataDir` as a\n  // field), not the positional `create(dataDir, options)` overload: with a\n  // leading `undefined` dataDir, that overload silently drops `extensions`\n  // (\"extension vector is not available\"). The options form loads them for\n  // both the in-memory and on-disk cases.\n  const client = await PGlite.create({\n    ...(options.dataDir === undefined ? {} : { dataDir: options.dataDir }),\n    ...(vectorExtension === undefined ?\n      {}\n    : { extensions: { vector: vectorExtension } }),\n  });\n\n  // `exec` runs a multi-statement batch (DDL + the pgvector `CREATE\n  // EXTENSION` when enabled) in one round trip.\n  const migrationSql =\n    vectorEnabled ?\n      generatePostgresMigrationSQL(tables)\n    : generatePostgresDDL(tables).join(\"\\n\\n\");\n  await client.exec(migrationSql);\n\n  const db = drizzle(client);\n  const backend = createPostgresBackend(db, {\n    tables,\n    ...(vectorEnabled ? {} : { vector: false }),\n  });\n  const managedBackend = wrapWithManagedClose(backend, async () => {\n    await client.close();\n  });\n\n  return { backend: managedBackend, db, client };\n}\n"]}
+{"version":3,"sources":["../../../src/backend/postgres/pglite.ts"],"names":["ConfigurationError","tables","PGlite","generatePostgresMigrationSQL","generatePostgresDDL","drizzle","createPostgresBackend","wrapWithManagedClose"],"mappings":";;;;;;;;;;;;;;;;;AA2HA,eAAe,4BAAA,GAAmD;AAChE,EAAA,IAAI;AACF,IAAA,MAAM,OAAA,GAAU,MAAM,OAAO,+BAA+B,CAAA;AAC5D,IAAA,OAAO,OAAA,CAAQ,MAAA;AAAA,EACjB,SAAS,KAAA,EAAO;AACd,IAAA,MAAM,IAAIA,oCAAA;AAAA,MACR,2PAAA;AAAA,MAIA,EAAE,OAAA,EAAS,QAAA,EAAU,UAAA,EAAY,+BAAA,EAAgC;AAAA,MACjE,EAAE,OAAO,KAAA;AAAM,KACjB;AAAA,EACF;AACF;AAoBA,eAAsB,wBAAA,CACpB,OAAA,GAAqC,EAAC,EACH;AACnC,EAAA,MAAMC,OAAAA,GAAS,QAAQ,MAAA,IAAUA,wBAAA;AAMjC,EAAA,MAAM,eAAA,GACJ,QAAQ,MAAA,KAAW,KAAA,GACjB,SACC,OAAA,CAAQ,MAAA,IAAW,MAAM,4BAAA,EAA6B;AAC3D,EAAA,MAAM,gBAAgB,eAAA,KAAoB,MAAA;AAO1C,EAAA,MAAM,MAAA,GAAS,MAAMC,aAAA,CAAO,MAAA,CAAO;AAAA,IACjC,GAAI,QAAQ,OAAA,KAAY,MAAA,GAAY,EAAC,GAAI,EAAE,OAAA,EAAS,OAAA,CAAQ,OAAA,EAAQ;AAAA,IACpE,GAAI,eAAA,KAAoB,MAAA,GACtB,EAAC,GACD,EAAE,UAAA,EAAY,EAAE,MAAA,EAAQ,eAAA,EAAgB;AAAE,GAC7C,CAAA;AAID,EAAA,MAAM,YAAA,GACJ,gBACEC,8CAAA,CAA6BF,OAAM,IACnCG,qCAAA,CAAoBH,OAAM,CAAA,CAAE,IAAA,CAAK,MAAM,CAAA;AAC3C,EAAA,MAAM,MAAA,CAAO,KAAK,YAAY,CAAA;AAE9B,EAAA,MAAM,EAAA,GAAKI,iBAAQ,MAAM,CAAA;AACzB,EAAA,MAAM,OAAA,GAAUC,wCAAsB,EAAA,EAAI;AAAA,IACxC,MAAA,EAAAL,OAAAA;AAAA,IACA,GAAI,aAAA,GAAgB,EAAC,GAAI,EAAE,QAAQ,KAAA;AAAM,GAC1C,CAAA;AACD,EAAA,MAAM,cAAA,GAAiBM,sCAAA,CAAqB,OAAA,EAAS,YAAY;AAC/D,IAAA,MAAM,OAAO,KAAA,EAAM;AAAA,EACrB,CAAC,CAAA;AAED,EAAA,OAAO,EAAE,OAAA,EAAS,cAAA,EAAgB,EAAA,EAAI,MAAA,EAAO;AAC/C","file":"pglite.cjs","sourcesContent":["/**\n * Local PGlite backend — Postgres-in-WASM, running in-process.\n *\n * [PGlite](https://pglite.dev/) is a full Postgres compiled to WebAssembly\n * that runs inside the Node/Bun/Deno/browser process with no server and no\n * native addon. This is the batteries-included Postgres analog of\n * `createLocalSqliteBackend`: it constructs a PGlite instance, loads the\n * pgvector extension, runs the schema DDL, and returns a ready\n * `{ backend, db }` pair whose `close()` disposes the engine.\n *\n * `@electric-sql/pglite` is an optional peer dependency. Vector support\n * additionally needs `@electric-sql/pglite-pgvector` (PGlite ≥ 0.5 ships\n * pgvector as a separate package). Install what you need:\n *\n * ```bash\n * pnpm add @electric-sql/pglite @electric-sql/pglite-pgvector\n * ```\n *\n * @example In-memory database (default, vector enabled)\n * ```typescript\n * import { createLocalPgliteBackend } from \"@nicia-ai/typegraph/postgres/pglite\";\n *\n * const { backend } = await createLocalPgliteBackend();\n * const store = createStore(graph, backend);\n * ```\n *\n * @example Persistent on-disk database\n * ```typescript\n * const { backend, db } = await createLocalPgliteBackend({ dataDir: \"./pgdata\" });\n * ```\n *\n * @example No vector support (skip the pgvector extension)\n * ```typescript\n * const { backend } = await createLocalPgliteBackend({ vector: false });\n * ```\n *\n * PGlite is single-connection and serial: there is no pooling, so concurrent\n * `store.transaction()` calls queue rather than run in parallel.\n */\nimport { type Extension, PGlite } from \"@electric-sql/pglite\";\nimport { drizzle, type PgliteDatabase } from \"drizzle-orm/pglite\";\n\nimport { ConfigurationError } from \"../../errors\";\nimport {\n  generatePostgresDDL,\n  generatePostgresMigrationSQL,\n} from \"../drizzle/ddl\";\nimport {\n  createPostgresBackend,\n  type PostgresTables,\n  tables as defaultTables,\n} from \"../drizzle/postgres\";\nimport { type GraphBackend, wrapWithManagedClose } from \"../types\";\n\n// ============================================================\n// Types\n// ============================================================\n\n/**\n * Options for creating a local PGlite backend.\n */\nexport type LocalPgliteBackendOptions = Readonly<{\n  /**\n   * PGlite data directory. Omit for an in-memory database (the default).\n   * Accepts any PGlite data-dir spec: a filesystem path (`\"./pgdata\"`),\n   * `\"memory://\"`, or a browser/runtime-specific scheme such as\n   * `\"idb://my-db\"`.\n   */\n  dataDir?: string;\n\n  /**\n   * Custom table definitions. Defaults to standard TypeGraph table names.\n   */\n  tables?: PostgresTables;\n\n  /**\n   * Controls the pgvector stack:\n   *\n   * - **omitted (default)** — load pgvector from `@electric-sql/pglite-pgvector`\n   *   and run `CREATE EXTENSION vector`, so embedding fields work out of the\n   *   box. Throws a {@link ConfigurationError} if the package isn't installed.\n   * - **`false`** — skip the extension entirely; the backend advertises no\n   *   vector capability (mirroring a SQLite connection without sqlite-vec).\n   *   Use when a graph carries no embeddings, or to avoid the extension dep.\n   * - **a PGlite `Extension`** — bring your own pgvector build or custom\n   *   extension packaging. Decouples this helper from a specific pgvector\n   *   package version.\n   */\n  vector?: false | Extension;\n}>;\n\n/**\n * Result of creating a local PGlite backend.\n */\nexport type LocalPgliteBackendResult = Readonly<{\n  /**\n   * The GraphBackend instance for use with createStore. Its `close()`\n   * disposes the underlying PGlite engine.\n   */\n  backend: GraphBackend;\n\n  /**\n   * The underlying Drizzle database instance. Useful for direct SQL access.\n   */\n  db: PgliteDatabase;\n\n  /**\n   * The raw PGlite instance, for engine-specific operations such as\n   * `dumpDataDir()` / `clone()` not surfaced through Drizzle.\n   */\n  client: PGlite;\n}>;\n\n// ============================================================\n// Vector extension loading\n// ============================================================\n\n/**\n * Dynamically loads the default pgvector extension from\n * `@electric-sql/pglite-pgvector`. Kept as a runtime import so the package\n * stays an optional peer dependency — callers using `vector: false` or\n * supplying their own extension never need it installed.\n */\nasync function loadDefaultPgvectorExtension(): Promise<Extension> {\n  try {\n    const module_ = await import(\"@electric-sql/pglite-pgvector\");\n    return module_.vector;\n  } catch (error) {\n    throw new ConfigurationError(\n      \"createLocalPgliteBackend needs the pgvector extension but \" +\n        \"`@electric-sql/pglite-pgvector` could not be loaded. Install it \" +\n        \"(`pnpm add @electric-sql/pglite-pgvector`), pass your own `vector` \" +\n        \"extension, or set `vector: false` to disable vector support.\",\n      { backend: \"pglite\", dependency: \"@electric-sql/pglite-pgvector\" },\n      { cause: error },\n    );\n  }\n}\n\n// ============================================================\n// Factory Function\n// ============================================================\n\n/**\n * Creates a TypeGraph backend backed by an in-process PGlite database.\n *\n * Constructs the PGlite engine (loading pgvector unless disabled), executes\n * the schema DDL, and wires the standard Postgres backend. The returned\n * backend owns the engine: call `backend.close()` to dispose it.\n *\n * For production Postgres, or a PGlite instance you construct yourself,\n * use `createPostgresBackend` directly with your own Drizzle database — the\n * execution fast path detects PGlite and routes it correctly.\n *\n * @param options - Configuration options\n * @returns Backend, Drizzle database, and raw PGlite client\n */\nexport async function createLocalPgliteBackend(\n  options: LocalPgliteBackendOptions = {},\n): Promise<LocalPgliteBackendResult> {\n  const tables = options.tables ?? defaultTables;\n\n  // pgvector lives in the WASM instance, so the extension must be passed at\n  // construction — `CREATE EXTENSION vector` alone can't pull it in. An\n  // explicitly supplied extension wins; `false` disables; otherwise load the\n  // default package.\n  const vectorExtension =\n    options.vector === false ?\n      undefined\n    : (options.vector ?? (await loadDefaultPgvectorExtension()));\n  const vectorEnabled = vectorExtension !== undefined;\n\n  // Construct via the single options-object form (passing `dataDir` as a\n  // field), not the positional `create(dataDir, options)` overload: with a\n  // leading `undefined` dataDir, that overload silently drops `extensions`\n  // (\"extension vector is not available\"). The options form loads them for\n  // both the in-memory and on-disk cases.\n  const client = await PGlite.create({\n    ...(options.dataDir === undefined ? {} : { dataDir: options.dataDir }),\n    ...(vectorExtension === undefined ?\n      {}\n    : { extensions: { vector: vectorExtension } }),\n  });\n\n  // `exec` runs a multi-statement batch (DDL + the pgvector `CREATE\n  // EXTENSION` when enabled) in one round trip.\n  const migrationSql =\n    vectorEnabled ?\n      generatePostgresMigrationSQL(tables)\n    : generatePostgresDDL(tables).join(\"\\n\\n\");\n  await client.exec(migrationSql);\n\n  const db = drizzle(client);\n  const backend = createPostgresBackend(db, {\n    tables,\n    ...(vectorEnabled ? {} : { vector: false }),\n  });\n  const managedBackend = wrapWithManagedClose(backend, async () => {\n    await client.close();\n  });\n\n  return { backend: managedBackend, db, client };\n}\n"]}

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

@@ -1,9 +1,9 @@
 import { Extension, PGlite } from '@electric-sql/pglite';
 import { PgliteDatabase } from 'drizzle-orm/pglite';
-import { G as GraphBackend } from '../../types-dL-clxO3.cjs';
-import { P as PostgresTables } from '../../postgres-CK2ByP1q.cjs';
+import { G as GraphBackend } from '../../types-Dvmn-eal.cjs';
+import { P as PostgresTables } from '../../postgres-jgXmD45C.cjs';
 import 'zod';
-import '../../extension-types-CwHV-Uk4.cjs';
+import '../../extension-types-D1k0inWU.cjs';
 import 'drizzle-orm';
 import 'drizzle-orm/pg-core';
 import 'drizzle-orm/sqlite-core';

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

@@ -1,9 +1,9 @@
 import { Extension, PGlite } from '@electric-sql/pglite';
 import { PgliteDatabase } from 'drizzle-orm/pglite';
-import { G as GraphBackend } from '../../types-BBiDqJCU.js';
-import { P as PostgresTables } from '../../postgres-ymXYC6Rr.js';
+import { G as GraphBackend } from '../../types-Dk8r09KY.js';
+import { P as PostgresTables } from '../../postgres-Dhom7iiX.js';
 import 'zod';
-import '../../extension-types-CwHV-Uk4.js';
+import '../../extension-types-D1k0inWU.js';
 import 'drizzle-orm';
 import 'drizzle-orm/pg-core';
 import 'drizzle-orm/sqlite-core';

package/dist/backend/postgres/pglite.js

@@ -1,12 +1,13 @@
-import { createPostgresBackend } from '../../chunk-K5VREXMZ.js';
-import '../../chunk-FVIGJTS7.js';
-import { tables, generatePostgresMigrationSQL, generatePostgresDDL } from '../../chunk-N2OEOGBB.js';
-import { wrapWithManagedClose } from '../../chunk-633N7DSE.js';
+import { createPostgresBackend } from '../../chunk-NDM5PXEH.js';
+import '../../chunk-PRMKPFN5.js';
+import '../../chunk-3EUKJEQ3.js';
+import { tables, generatePostgresMigrationSQL, generatePostgresDDL } from '../../chunk-TUA3MEJJ.js';
+import '../../chunk-XQFAJVYW.js';
+import '../../chunk-CWFPJ3RC.js';
+import { wrapWithManagedClose } from '../../chunk-SAJSMR2B.js';
 import '../../chunk-M6OC455F.js';
-import '../../chunk-AI3RNREM.js';
-import '../../chunk-R4JOBEJU.js';
-import '../../chunk-MXE2U3EX.js';
-import '../../chunk-454I6GDF.js';
+import '../../chunk-C4C4Q7A6.js';
+import '../../chunk-2YMGNYXY.js';
 import { ConfigurationError } from '../../chunk-TQOYM4LN.js';
 import '../../chunk-K5P5OZXS.js';
 import { PGlite } from '@electric-sql/pglite';

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

@@ -1 +1 @@
-{"version":3,"sources":["../../../src/backend/postgres/pglite.ts"],"names":["tables"],"mappings":";;;;;;;;;;;;;;AA2HA,eAAe,4BAAA,GAAmD;AAChE,EAAA,IAAI;AACF,IAAA,MAAM,OAAA,GAAU,MAAM,OAAO,+BAA+B,CAAA;AAC5D,IAAA,OAAO,OAAA,CAAQ,MAAA;AAAA,EACjB,SAAS,KAAA,EAAO;AACd,IAAA,MAAM,IAAI,kBAAA;AAAA,MACR,2PAAA;AAAA,MAIA,EAAE,OAAA,EAAS,QAAA,EAAU,UAAA,EAAY,+BAAA,EAAgC;AAAA,MACjE,EAAE,OAAO,KAAA;AAAM,KACjB;AAAA,EACF;AACF;AAoBA,eAAsB,wBAAA,CACpB,OAAA,GAAqC,EAAC,EACH;AACnC,EAAA,MAAMA,OAAAA,GAAS,QAAQ,MAAA,IAAU,MAAA;AAMjC,EAAA,MAAM,eAAA,GACJ,QAAQ,MAAA,KAAW,KAAA,GACjB,SACC,OAAA,CAAQ,MAAA,IAAW,MAAM,4BAAA,EAA6B;AAC3D,EAAA,MAAM,gBAAgB,eAAA,KAAoB,MAAA;AAO1C,EAAA,MAAM,MAAA,GAAS,MAAM,MAAA,CAAO,MAAA,CAAO;AAAA,IACjC,GAAI,QAAQ,OAAA,KAAY,MAAA,GAAY,EAAC,GAAI,EAAE,OAAA,EAAS,OAAA,CAAQ,OAAA,EAAQ;AAAA,IACpE,GAAI,eAAA,KAAoB,MAAA,GACtB,EAAC,GACD,EAAE,UAAA,EAAY,EAAE,MAAA,EAAQ,eAAA,EAAgB;AAAE,GAC7C,CAAA;AAID,EAAA,MAAM,YAAA,GACJ,gBACE,4BAAA,CAA6BA,OAAM,IACnC,mBAAA,CAAoBA,OAAM,CAAA,CAAE,IAAA,CAAK,MAAM,CAAA;AAC3C,EAAA,MAAM,MAAA,CAAO,KAAK,YAAY,CAAA;AAE9B,EAAA,MAAM,EAAA,GAAK,QAAQ,MAAM,CAAA;AACzB,EAAA,MAAM,OAAA,GAAU,sBAAsB,EAAA,EAAI;AAAA,IACxC,MAAA,EAAAA,OAAAA;AAAA,IACA,GAAI,aAAA,GAAgB,EAAC,GAAI,EAAE,QAAQ,KAAA;AAAM,GAC1C,CAAA;AACD,EAAA,MAAM,cAAA,GAAiB,oBAAA,CAAqB,OAAA,EAAS,YAAY;AAC/D,IAAA,MAAM,OAAO,KAAA,EAAM;AAAA,EACrB,CAAC,CAAA;AAED,EAAA,OAAO,EAAE,OAAA,EAAS,cAAA,EAAgB,EAAA,EAAI,MAAA,EAAO;AAC/C","file":"pglite.js","sourcesContent":["/**\n * Local PGlite backend — Postgres-in-WASM, running in-process.\n *\n * [PGlite](https://pglite.dev/) is a full Postgres compiled to WebAssembly\n * that runs inside the Node/Bun/Deno/browser process with no server and no\n * native addon. This is the batteries-included Postgres analog of\n * `createLocalSqliteBackend`: it constructs a PGlite instance, loads the\n * pgvector extension, runs the schema DDL, and returns a ready\n * `{ backend, db }` pair whose `close()` disposes the engine.\n *\n * `@electric-sql/pglite` is an optional peer dependency. Vector support\n * additionally needs `@electric-sql/pglite-pgvector` (PGlite ≥ 0.5 ships\n * pgvector as a separate package). Install what you need:\n *\n * ```bash\n * pnpm add @electric-sql/pglite @electric-sql/pglite-pgvector\n * ```\n *\n * @example In-memory database (default, vector enabled)\n * ```typescript\n * import { createLocalPgliteBackend } from \"@nicia-ai/typegraph/postgres/pglite\";\n *\n * const { backend } = await createLocalPgliteBackend();\n * const store = createStore(graph, backend);\n * ```\n *\n * @example Persistent on-disk database\n * ```typescript\n * const { backend, db } = await createLocalPgliteBackend({ dataDir: \"./pgdata\" });\n * ```\n *\n * @example No vector support (skip the pgvector extension)\n * ```typescript\n * const { backend } = await createLocalPgliteBackend({ vector: false });\n * ```\n *\n * PGlite is single-connection and serial: there is no pooling, so concurrent\n * `store.transaction()` calls queue rather than run in parallel.\n */\nimport { type Extension, PGlite } from \"@electric-sql/pglite\";\nimport { drizzle, type PgliteDatabase } from \"drizzle-orm/pglite\";\n\nimport { ConfigurationError } from \"../../errors\";\nimport {\n  generatePostgresDDL,\n  generatePostgresMigrationSQL,\n} from \"../drizzle/ddl\";\nimport {\n  createPostgresBackend,\n  type PostgresTables,\n  tables as defaultTables,\n} from \"../drizzle/postgres\";\nimport { type GraphBackend, wrapWithManagedClose } from \"../types\";\n\n// ============================================================\n// Types\n// ============================================================\n\n/**\n * Options for creating a local PGlite backend.\n */\nexport type LocalPgliteBackendOptions = Readonly<{\n  /**\n   * PGlite data directory. Omit for an in-memory database (the default).\n   * Accepts any PGlite data-dir spec: a filesystem path (`\"./pgdata\"`),\n   * `\"memory://\"`, or a browser/runtime-specific scheme such as\n   * `\"idb://my-db\"`.\n   */\n  dataDir?: string;\n\n  /**\n   * Custom table definitions. Defaults to standard TypeGraph table names.\n   */\n  tables?: PostgresTables;\n\n  /**\n   * Controls the pgvector stack:\n   *\n   * - **omitted (default)** — load pgvector from `@electric-sql/pglite-pgvector`\n   *   and run `CREATE EXTENSION vector`, so embedding fields work out of the\n   *   box. Throws a {@link ConfigurationError} if the package isn't installed.\n   * - **`false`** — skip the extension entirely; the backend advertises no\n   *   vector capability (mirroring a SQLite connection without sqlite-vec).\n   *   Use when a graph carries no embeddings, or to avoid the extension dep.\n   * - **a PGlite `Extension`** — bring your own pgvector build or custom\n   *   extension packaging. Decouples this helper from a specific pgvector\n   *   package version.\n   */\n  vector?: false | Extension;\n}>;\n\n/**\n * Result of creating a local PGlite backend.\n */\nexport type LocalPgliteBackendResult = Readonly<{\n  /**\n   * The GraphBackend instance for use with createStore. Its `close()`\n   * disposes the underlying PGlite engine.\n   */\n  backend: GraphBackend;\n\n  /**\n   * The underlying Drizzle database instance. Useful for direct SQL access.\n   */\n  db: PgliteDatabase;\n\n  /**\n   * The raw PGlite instance, for engine-specific operations such as\n   * `dumpDataDir()` / `clone()` not surfaced through Drizzle.\n   */\n  client: PGlite;\n}>;\n\n// ============================================================\n// Vector extension loading\n// ============================================================\n\n/**\n * Dynamically loads the default pgvector extension from\n * `@electric-sql/pglite-pgvector`. Kept as a runtime import so the package\n * stays an optional peer dependency — callers using `vector: false` or\n * supplying their own extension never need it installed.\n */\nasync function loadDefaultPgvectorExtension(): Promise<Extension> {\n  try {\n    const module_ = await import(\"@electric-sql/pglite-pgvector\");\n    return module_.vector;\n  } catch (error) {\n    throw new ConfigurationError(\n      \"createLocalPgliteBackend needs the pgvector extension but \" +\n        \"`@electric-sql/pglite-pgvector` could not be loaded. Install it \" +\n        \"(`pnpm add @electric-sql/pglite-pgvector`), pass your own `vector` \" +\n        \"extension, or set `vector: false` to disable vector support.\",\n      { backend: \"pglite\", dependency: \"@electric-sql/pglite-pgvector\" },\n      { cause: error },\n    );\n  }\n}\n\n// ============================================================\n// Factory Function\n// ============================================================\n\n/**\n * Creates a TypeGraph backend backed by an in-process PGlite database.\n *\n * Constructs the PGlite engine (loading pgvector unless disabled), executes\n * the schema DDL, and wires the standard Postgres backend. The returned\n * backend owns the engine: call `backend.close()` to dispose it.\n *\n * For production Postgres, or a PGlite instance you construct yourself,\n * use `createPostgresBackend` directly with your own Drizzle database — the\n * execution fast path detects PGlite and routes it correctly.\n *\n * @param options - Configuration options\n * @returns Backend, Drizzle database, and raw PGlite client\n */\nexport async function createLocalPgliteBackend(\n  options: LocalPgliteBackendOptions = {},\n): Promise<LocalPgliteBackendResult> {\n  const tables = options.tables ?? defaultTables;\n\n  // pgvector lives in the WASM instance, so the extension must be passed at\n  // construction — `CREATE EXTENSION vector` alone can't pull it in. An\n  // explicitly supplied extension wins; `false` disables; otherwise load the\n  // default package.\n  const vectorExtension =\n    options.vector === false ?\n      undefined\n    : (options.vector ?? (await loadDefaultPgvectorExtension()));\n  const vectorEnabled = vectorExtension !== undefined;\n\n  // Construct via the single options-object form (passing `dataDir` as a\n  // field), not the positional `create(dataDir, options)` overload: with a\n  // leading `undefined` dataDir, that overload silently drops `extensions`\n  // (\"extension vector is not available\"). The options form loads them for\n  // both the in-memory and on-disk cases.\n  const client = await PGlite.create({\n    ...(options.dataDir === undefined ? {} : { dataDir: options.dataDir }),\n    ...(vectorExtension === undefined ?\n      {}\n    : { extensions: { vector: vectorExtension } }),\n  });\n\n  // `exec` runs a multi-statement batch (DDL + the pgvector `CREATE\n  // EXTENSION` when enabled) in one round trip.\n  const migrationSql =\n    vectorEnabled ?\n      generatePostgresMigrationSQL(tables)\n    : generatePostgresDDL(tables).join(\"\\n\\n\");\n  await client.exec(migrationSql);\n\n  const db = drizzle(client);\n  const backend = createPostgresBackend(db, {\n    tables,\n    ...(vectorEnabled ? {} : { vector: false }),\n  });\n  const managedBackend = wrapWithManagedClose(backend, async () => {\n    await client.close();\n  });\n\n  return { backend: managedBackend, db, client };\n}\n"]}
+{"version":3,"sources":["../../../src/backend/postgres/pglite.ts"],"names":["tables"],"mappings":";;;;;;;;;;;;;;;AA2HA,eAAe,4BAAA,GAAmD;AAChE,EAAA,IAAI;AACF,IAAA,MAAM,OAAA,GAAU,MAAM,OAAO,+BAA+B,CAAA;AAC5D,IAAA,OAAO,OAAA,CAAQ,MAAA;AAAA,EACjB,SAAS,KAAA,EAAO;AACd,IAAA,MAAM,IAAI,kBAAA;AAAA,MACR,2PAAA;AAAA,MAIA,EAAE,OAAA,EAAS,QAAA,EAAU,UAAA,EAAY,+BAAA,EAAgC;AAAA,MACjE,EAAE,OAAO,KAAA;AAAM,KACjB;AAAA,EACF;AACF;AAoBA,eAAsB,wBAAA,CACpB,OAAA,GAAqC,EAAC,EACH;AACnC,EAAA,MAAMA,OAAAA,GAAS,QAAQ,MAAA,IAAU,MAAA;AAMjC,EAAA,MAAM,eAAA,GACJ,QAAQ,MAAA,KAAW,KAAA,GACjB,SACC,OAAA,CAAQ,MAAA,IAAW,MAAM,4BAAA,EAA6B;AAC3D,EAAA,MAAM,gBAAgB,eAAA,KAAoB,MAAA;AAO1C,EAAA,MAAM,MAAA,GAAS,MAAM,MAAA,CAAO,MAAA,CAAO;AAAA,IACjC,GAAI,QAAQ,OAAA,KAAY,MAAA,GAAY,EAAC,GAAI,EAAE,OAAA,EAAS,OAAA,CAAQ,OAAA,EAAQ;AAAA,IACpE,GAAI,eAAA,KAAoB,MAAA,GACtB,EAAC,GACD,EAAE,UAAA,EAAY,EAAE,MAAA,EAAQ,eAAA,EAAgB;AAAE,GAC7C,CAAA;AAID,EAAA,MAAM,YAAA,GACJ,gBACE,4BAAA,CAA6BA,OAAM,IACnC,mBAAA,CAAoBA,OAAM,CAAA,CAAE,IAAA,CAAK,MAAM,CAAA;AAC3C,EAAA,MAAM,MAAA,CAAO,KAAK,YAAY,CAAA;AAE9B,EAAA,MAAM,EAAA,GAAK,QAAQ,MAAM,CAAA;AACzB,EAAA,MAAM,OAAA,GAAU,sBAAsB,EAAA,EAAI;AAAA,IACxC,MAAA,EAAAA,OAAAA;AAAA,IACA,GAAI,aAAA,GAAgB,EAAC,GAAI,EAAE,QAAQ,KAAA;AAAM,GAC1C,CAAA;AACD,EAAA,MAAM,cAAA,GAAiB,oBAAA,CAAqB,OAAA,EAAS,YAAY;AAC/D,IAAA,MAAM,OAAO,KAAA,EAAM;AAAA,EACrB,CAAC,CAAA;AAED,EAAA,OAAO,EAAE,OAAA,EAAS,cAAA,EAAgB,EAAA,EAAI,MAAA,EAAO;AAC/C","file":"pglite.js","sourcesContent":["/**\n * Local PGlite backend — Postgres-in-WASM, running in-process.\n *\n * [PGlite](https://pglite.dev/) is a full Postgres compiled to WebAssembly\n * that runs inside the Node/Bun/Deno/browser process with no server and no\n * native addon. This is the batteries-included Postgres analog of\n * `createLocalSqliteBackend`: it constructs a PGlite instance, loads the\n * pgvector extension, runs the schema DDL, and returns a ready\n * `{ backend, db }` pair whose `close()` disposes the engine.\n *\n * `@electric-sql/pglite` is an optional peer dependency. Vector support\n * additionally needs `@electric-sql/pglite-pgvector` (PGlite ≥ 0.5 ships\n * pgvector as a separate package). Install what you need:\n *\n * ```bash\n * pnpm add @electric-sql/pglite @electric-sql/pglite-pgvector\n * ```\n *\n * @example In-memory database (default, vector enabled)\n * ```typescript\n * import { createLocalPgliteBackend } from \"@nicia-ai/typegraph/postgres/pglite\";\n *\n * const { backend } = await createLocalPgliteBackend();\n * const store = createStore(graph, backend);\n * ```\n *\n * @example Persistent on-disk database\n * ```typescript\n * const { backend, db } = await createLocalPgliteBackend({ dataDir: \"./pgdata\" });\n * ```\n *\n * @example No vector support (skip the pgvector extension)\n * ```typescript\n * const { backend } = await createLocalPgliteBackend({ vector: false });\n * ```\n *\n * PGlite is single-connection and serial: there is no pooling, so concurrent\n * `store.transaction()` calls queue rather than run in parallel.\n */\nimport { type Extension, PGlite } from \"@electric-sql/pglite\";\nimport { drizzle, type PgliteDatabase } from \"drizzle-orm/pglite\";\n\nimport { ConfigurationError } from \"../../errors\";\nimport {\n  generatePostgresDDL,\n  generatePostgresMigrationSQL,\n} from \"../drizzle/ddl\";\nimport {\n  createPostgresBackend,\n  type PostgresTables,\n  tables as defaultTables,\n} from \"../drizzle/postgres\";\nimport { type GraphBackend, wrapWithManagedClose } from \"../types\";\n\n// ============================================================\n// Types\n// ============================================================\n\n/**\n * Options for creating a local PGlite backend.\n */\nexport type LocalPgliteBackendOptions = Readonly<{\n  /**\n   * PGlite data directory. Omit for an in-memory database (the default).\n   * Accepts any PGlite data-dir spec: a filesystem path (`\"./pgdata\"`),\n   * `\"memory://\"`, or a browser/runtime-specific scheme such as\n   * `\"idb://my-db\"`.\n   */\n  dataDir?: string;\n\n  /**\n   * Custom table definitions. Defaults to standard TypeGraph table names.\n   */\n  tables?: PostgresTables;\n\n  /**\n   * Controls the pgvector stack:\n   *\n   * - **omitted (default)** — load pgvector from `@electric-sql/pglite-pgvector`\n   *   and run `CREATE EXTENSION vector`, so embedding fields work out of the\n   *   box. Throws a {@link ConfigurationError} if the package isn't installed.\n   * - **`false`** — skip the extension entirely; the backend advertises no\n   *   vector capability (mirroring a SQLite connection without sqlite-vec).\n   *   Use when a graph carries no embeddings, or to avoid the extension dep.\n   * - **a PGlite `Extension`** — bring your own pgvector build or custom\n   *   extension packaging. Decouples this helper from a specific pgvector\n   *   package version.\n   */\n  vector?: false | Extension;\n}>;\n\n/**\n * Result of creating a local PGlite backend.\n */\nexport type LocalPgliteBackendResult = Readonly<{\n  /**\n   * The GraphBackend instance for use with createStore. Its `close()`\n   * disposes the underlying PGlite engine.\n   */\n  backend: GraphBackend;\n\n  /**\n   * The underlying Drizzle database instance. Useful for direct SQL access.\n   */\n  db: PgliteDatabase;\n\n  /**\n   * The raw PGlite instance, for engine-specific operations such as\n   * `dumpDataDir()` / `clone()` not surfaced through Drizzle.\n   */\n  client: PGlite;\n}>;\n\n// ============================================================\n// Vector extension loading\n// ============================================================\n\n/**\n * Dynamically loads the default pgvector extension from\n * `@electric-sql/pglite-pgvector`. Kept as a runtime import so the package\n * stays an optional peer dependency — callers using `vector: false` or\n * supplying their own extension never need it installed.\n */\nasync function loadDefaultPgvectorExtension(): Promise<Extension> {\n  try {\n    const module_ = await import(\"@electric-sql/pglite-pgvector\");\n    return module_.vector;\n  } catch (error) {\n    throw new ConfigurationError(\n      \"createLocalPgliteBackend needs the pgvector extension but \" +\n        \"`@electric-sql/pglite-pgvector` could not be loaded. Install it \" +\n        \"(`pnpm add @electric-sql/pglite-pgvector`), pass your own `vector` \" +\n        \"extension, or set `vector: false` to disable vector support.\",\n      { backend: \"pglite\", dependency: \"@electric-sql/pglite-pgvector\" },\n      { cause: error },\n    );\n  }\n}\n\n// ============================================================\n// Factory Function\n// ============================================================\n\n/**\n * Creates a TypeGraph backend backed by an in-process PGlite database.\n *\n * Constructs the PGlite engine (loading pgvector unless disabled), executes\n * the schema DDL, and wires the standard Postgres backend. The returned\n * backend owns the engine: call `backend.close()` to dispose it.\n *\n * For production Postgres, or a PGlite instance you construct yourself,\n * use `createPostgresBackend` directly with your own Drizzle database — the\n * execution fast path detects PGlite and routes it correctly.\n *\n * @param options - Configuration options\n * @returns Backend, Drizzle database, and raw PGlite client\n */\nexport async function createLocalPgliteBackend(\n  options: LocalPgliteBackendOptions = {},\n): Promise<LocalPgliteBackendResult> {\n  const tables = options.tables ?? defaultTables;\n\n  // pgvector lives in the WASM instance, so the extension must be passed at\n  // construction — `CREATE EXTENSION vector` alone can't pull it in. An\n  // explicitly supplied extension wins; `false` disables; otherwise load the\n  // default package.\n  const vectorExtension =\n    options.vector === false ?\n      undefined\n    : (options.vector ?? (await loadDefaultPgvectorExtension()));\n  const vectorEnabled = vectorExtension !== undefined;\n\n  // Construct via the single options-object form (passing `dataDir` as a\n  // field), not the positional `create(dataDir, options)` overload: with a\n  // leading `undefined` dataDir, that overload silently drops `extensions`\n  // (\"extension vector is not available\"). The options form loads them for\n  // both the in-memory and on-disk cases.\n  const client = await PGlite.create({\n    ...(options.dataDir === undefined ? {} : { dataDir: options.dataDir }),\n    ...(vectorExtension === undefined ?\n      {}\n    : { extensions: { vector: vectorExtension } }),\n  });\n\n  // `exec` runs a multi-statement batch (DDL + the pgvector `CREATE\n  // EXTENSION` when enabled) in one round trip.\n  const migrationSql =\n    vectorEnabled ?\n      generatePostgresMigrationSQL(tables)\n    : generatePostgresDDL(tables).join(\"\\n\\n\");\n  await client.exec(migrationSql);\n\n  const db = drizzle(client);\n  const backend = createPostgresBackend(db, {\n    tables,\n    ...(vectorEnabled ? {} : { vector: false }),\n  });\n  const managedBackend = wrapWithManagedClose(backend, async () => {\n    await client.close();\n  });\n\n  return { backend: managedBackend, db, client };\n}\n"]}

package/dist/backend/sqlite/index.cjs

@@ -1,13 +1,13 @@
 'use strict';
 
-var chunk4LBO6KIF_cjs = require('../../chunk-4LBO6KIF.cjs');
-var chunkWFCECD6Q_cjs = require('../../chunk-WFCECD6Q.cjs');
-var chunkWEMZM7J7_cjs = require('../../chunk-WEMZM7J7.cjs');
+var chunkCAMMC3E4_cjs = require('../../chunk-CAMMC3E4.cjs');
+var chunk3HQDMOBK_cjs = require('../../chunk-3HQDMOBK.cjs');
+var chunkJKRKIEVA_cjs = require('../../chunk-JKRKIEVA.cjs');
+require('../../chunk-WWVV44DY.cjs');
+require('../../chunk-6G35I3VW.cjs');
 require('../../chunk-RP7YITHX.cjs');
-require('../../chunk-UESTHN47.cjs');
-require('../../chunk-4BXHVEFB.cjs');
-require('../../chunk-YQGLVWB2.cjs');
-require('../../chunk-ZFWNO3GE.cjs');
+require('../../chunk-CFNT3ITG.cjs');
+require('../../chunk-73KASJGO.cjs');
 require('../../chunk-JIEJCTDS.cjs');
 require('../../chunk-FLRCVI2G.cjs');
 
@@ -15,39 +15,39 @@ require('../../chunk-FLRCVI2G.cjs');
 
 Object.defineProperty(exports, "createSqliteBackend", {
   enumerable: true,
-  get: function () { return chunk4LBO6KIF_cjs.createSqliteBackend; }
+  get: function () { return chunkCAMMC3E4_cjs.createSqliteBackend; }
 });
 Object.defineProperty(exports, "generateSqliteDDL", {
   enumerable: true,
-  get: function () { return chunkWFCECD6Q_cjs.generateSqliteDDL; }
+  get: function () { return chunk3HQDMOBK_cjs.generateSqliteDDL; }
 });
 Object.defineProperty(exports, "generateSqliteMigrationSQL", {
   enumerable: true,
-  get: function () { return chunkWFCECD6Q_cjs.generateSqliteMigrationSQL; }
+  get: function () { return chunk3HQDMOBK_cjs.generateSqliteMigrationSQL; }
 });
 Object.defineProperty(exports, "createSqliteTables", {
   enumerable: true,
-  get: function () { return chunkWEMZM7J7_cjs.createSqliteTables; }
+  get: function () { return chunkJKRKIEVA_cjs.createSqliteTables; }
 });
 Object.defineProperty(exports, "edges", {
   enumerable: true,
-  get: function () { return chunkWEMZM7J7_cjs.edges; }
+  get: function () { return chunkJKRKIEVA_cjs.edges; }
 });
 Object.defineProperty(exports, "nodes", {
   enumerable: true,
-  get: function () { return chunkWEMZM7J7_cjs.nodes; }
+  get: function () { return chunkJKRKIEVA_cjs.nodes; }
 });
 Object.defineProperty(exports, "schemaVersions", {
   enumerable: true,
-  get: function () { return chunkWEMZM7J7_cjs.schemaVersions; }
+  get: function () { return chunkJKRKIEVA_cjs.schemaVersions; }
 });
 Object.defineProperty(exports, "tables", {
   enumerable: true,
-  get: function () { return chunkWEMZM7J7_cjs.tables; }
+  get: function () { return chunkJKRKIEVA_cjs.tables; }
 });
 Object.defineProperty(exports, "uniques", {
   enumerable: true,
-  get: function () { return chunkWEMZM7J7_cjs.uniques; }
+  get: function () { return chunkJKRKIEVA_cjs.uniques; }
 });
 //# sourceMappingURL=index.cjs.map
 //# sourceMappingURL=index.cjs.map

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

@@ -1,14 +1,14 @@
-import { S as SqliteExecutionProfileHints, F as FulltextStrategy, V as VectorStrategy, B as BackendCapabilities, A as AnySqliteDatabase, G as GraphBackend } from '../../types-dL-clxO3.cjs';
-export { a as SqliteTransactionMode } from '../../types-dL-clxO3.cjs';
-import { S as SqliteTables } from '../../sqlite-DxH1lrwD.cjs';
-export { C as CreateSqliteTablesOptions, a as SqliteTableNames, c as createSqliteTables, e as edges, n as nodes, s as schemaVersions, t as tables, u as uniques } from '../../sqlite-DxH1lrwD.cjs';
-export { g as generateSqliteDDL, a as generateSqliteMigrationSQL } from '../../ddl-BSFlbGQF.cjs';
+import { S as SqliteExecutionProfileHints, F as FulltextStrategy, V as VectorStrategy, B as BackendCapabilities, A as AnySqliteDatabase, G as GraphBackend } from '../../types-Dvmn-eal.cjs';
+export { a as SqliteTransactionMode } from '../../types-Dvmn-eal.cjs';
+import { S as SqliteTables } from '../../sqlite-DcQ_BCUW.cjs';
+export { C as CreateSqliteTablesOptions, a as SqliteTableNames, c as createSqliteTables, e as edges, n as nodes, s as schemaVersions, t as tables, u as uniques } from '../../sqlite-DcQ_BCUW.cjs';
+export { g as generateSqliteDDL, a as generateSqliteMigrationSQL } from '../../ddl-CwyG4HoQ.cjs';
 import 'zod';
-import '../../extension-types-CwHV-Uk4.cjs';
+import '../../extension-types-D1k0inWU.cjs';
 import 'drizzle-orm';
 import 'drizzle-orm/pg-core';
 import 'drizzle-orm/sqlite-core';
-import '../../postgres-CK2ByP1q.cjs';
+import '../../postgres-jgXmD45C.cjs';
 
 /**
  * Options for creating a SQLite backend.

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

@@ -1,14 +1,14 @@
-import { S as SqliteExecutionProfileHints, F as FulltextStrategy, V as VectorStrategy, B as BackendCapabilities, A as AnySqliteDatabase, G as GraphBackend } from '../../types-BBiDqJCU.js';
-export { a as SqliteTransactionMode } from '../../types-BBiDqJCU.js';
-import { S as SqliteTables } from '../../sqlite-R8YGOqVQ.js';
-export { C as CreateSqliteTablesOptions, a as SqliteTableNames, c as createSqliteTables, e as edges, n as nodes, s as schemaVersions, t as tables, u as uniques } from '../../sqlite-R8YGOqVQ.js';
-export { g as generateSqliteDDL, a as generateSqliteMigrationSQL } from '../../ddl-EdkIiFVU.js';
+import { S as SqliteExecutionProfileHints, F as FulltextStrategy, V as VectorStrategy, B as BackendCapabilities, A as AnySqliteDatabase, G as GraphBackend } from '../../types-Dk8r09KY.js';
+export { a as SqliteTransactionMode } from '../../types-Dk8r09KY.js';
+import { S as SqliteTables } from '../../sqlite-BfLsCEqO.js';
+export { C as CreateSqliteTablesOptions, a as SqliteTableNames, c as createSqliteTables, e as edges, n as nodes, s as schemaVersions, t as tables, u as uniques } from '../../sqlite-BfLsCEqO.js';
+export { g as generateSqliteDDL, a as generateSqliteMigrationSQL } from '../../ddl-C8e8zDAE.js';
 import 'zod';
-import '../../extension-types-CwHV-Uk4.js';
+import '../../extension-types-D1k0inWU.js';
 import 'drizzle-orm';
 import 'drizzle-orm/pg-core';
 import 'drizzle-orm/sqlite-core';
-import '../../postgres-ymXYC6Rr.js';
+import '../../postgres-Dhom7iiX.js';
 
 /**
  * Options for creating a SQLite backend.

package/dist/backend/sqlite/index.js

@@ -1,11 +1,11 @@
-export { createSqliteBackend } from '../../chunk-IUIJJYPI.js';
-export { generateSqliteDDL, generateSqliteMigrationSQL } from '../../chunk-N2OEOGBB.js';
-export { createSqliteTables, edges, nodes, schemaVersions, tables, uniques } from '../../chunk-633N7DSE.js';
+export { createSqliteBackend } from '../../chunk-7WW3WL6E.js';
+export { generateSqliteDDL, generateSqliteMigrationSQL } from '../../chunk-TUA3MEJJ.js';
+export { createSqliteTables, edges, nodes, schemaVersions, tables, uniques } from '../../chunk-XQFAJVYW.js';
+import '../../chunk-CWFPJ3RC.js';
+import '../../chunk-SAJSMR2B.js';
 import '../../chunk-M6OC455F.js';
-import '../../chunk-AI3RNREM.js';
-import '../../chunk-R4JOBEJU.js';
-import '../../chunk-MXE2U3EX.js';
-import '../../chunk-454I6GDF.js';
+import '../../chunk-C4C4Q7A6.js';
+import '../../chunk-2YMGNYXY.js';
 import '../../chunk-TQOYM4LN.js';
 import '../../chunk-K5P5OZXS.js';
 //# sourceMappingURL=index.js.map

package/dist/backend/sqlite/libsql.cjs

@@ -1,24 +1,24 @@
 'use strict';
 
-var chunkFWBVPATK_cjs = require('../../chunk-FWBVPATK.cjs');
-var chunk4LBO6KIF_cjs = require('../../chunk-4LBO6KIF.cjs');
-var chunkWFCECD6Q_cjs = require('../../chunk-WFCECD6Q.cjs');
-var chunkWEMZM7J7_cjs = require('../../chunk-WEMZM7J7.cjs');
+var chunkFDN43KXV_cjs = require('../../chunk-FDN43KXV.cjs');
+var chunkCAMMC3E4_cjs = require('../../chunk-CAMMC3E4.cjs');
+var chunk3HQDMOBK_cjs = require('../../chunk-3HQDMOBK.cjs');
+var chunkJKRKIEVA_cjs = require('../../chunk-JKRKIEVA.cjs');
+require('../../chunk-WWVV44DY.cjs');
+require('../../chunk-6G35I3VW.cjs');
 require('../../chunk-RP7YITHX.cjs');
-require('../../chunk-UESTHN47.cjs');
-require('../../chunk-4BXHVEFB.cjs');
-require('../../chunk-YQGLVWB2.cjs');
-require('../../chunk-ZFWNO3GE.cjs');
+require('../../chunk-CFNT3ITG.cjs');
+require('../../chunk-73KASJGO.cjs');
 require('../../chunk-JIEJCTDS.cjs');
 require('../../chunk-FLRCVI2G.cjs');
 var libsql = require('drizzle-orm/libsql');
 
 async function createLibsqlBackend(client, options = {}) {
-  const tables2 = options.tables ?? chunkWEMZM7J7_cjs.tables;
+  const tables2 = options.tables ?? chunkJKRKIEVA_cjs.tables;
   const db = libsql.drizzle(client);
-  const ddlStatements = chunkWFCECD6Q_cjs.generateSqliteDDL(tables2);
+  const ddlStatements = chunk3HQDMOBK_cjs.generateSqliteDDL(tables2);
   await client.executeMultiple(ddlStatements.join(";\n"));
-  const backend = chunk4LBO6KIF_cjs.createSqliteBackend(db, {
+  const backend = chunkCAMMC3E4_cjs.createSqliteBackend(db, {
     executionProfile: {
       isSync: false,
       transactionMode: "drizzle"
@@ -26,7 +26,7 @@ async function createLibsqlBackend(client, options = {}) {
     tables: tables2,
     // libSQL ships native vector search in core — no extension to load —
     // so the strategy is wired unconditionally.
-    vector: chunkFWBVPATK_cjs.libsqlVectorStrategy
+    vector: chunkFDN43KXV_cjs.libsqlVectorStrategy
   });
   return { backend, db };
 }

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

@@ -1,9 +1,9 @@
 import { Client } from '@libsql/client';
 import { LibSQLDatabase } from 'drizzle-orm/libsql';
-import { G as GraphBackend } from '../../types-dL-clxO3.cjs';
-import { S as SqliteTables } from '../../sqlite-DxH1lrwD.cjs';
+import { G as GraphBackend } from '../../types-Dvmn-eal.cjs';
+import { S as SqliteTables } from '../../sqlite-DcQ_BCUW.cjs';
 import 'zod';
-import '../../extension-types-CwHV-Uk4.cjs';
+import '../../extension-types-D1k0inWU.cjs';
 import 'drizzle-orm';
 import 'drizzle-orm/pg-core';
 import 'drizzle-orm/sqlite-core';

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

@@ -1,9 +1,9 @@
 import { Client } from '@libsql/client';
 import { LibSQLDatabase } from 'drizzle-orm/libsql';
-import { G as GraphBackend } from '../../types-BBiDqJCU.js';
-import { S as SqliteTables } from '../../sqlite-R8YGOqVQ.js';
+import { G as GraphBackend } from '../../types-Dk8r09KY.js';
+import { S as SqliteTables } from '../../sqlite-BfLsCEqO.js';
 import 'zod';
-import '../../extension-types-CwHV-Uk4.js';
+import '../../extension-types-D1k0inWU.js';
 import 'drizzle-orm';
 import 'drizzle-orm/pg-core';
 import 'drizzle-orm/sqlite-core';