@nicia-ai/typegraph 0.32.0 → 0.34.0

package/README.md

@@ -85,6 +85,57 @@ 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)
 
+## Bitemporal History
+
+TypeGraph supports valid-time reads and opt-in recorded-time reconstruction:
+
+- **Valid time** (`validFrom` / `validTo`, `store.asOf(T)`): when a fact is true
+  in the world.
+- **Recorded time** (`history: true`, `store.asOfRecorded(T)`): when the
+  TypeGraph store wrote that fact down.
+
+Together they answer what TypeGraph captured as true at a recorded commit
+instant for writes that go through TypeGraph's collections. Use this for
+audit trails, agent decision replay, policy effective dating, and incident
+forensics.
+
+```ts
+const store = createStore(graph, backend, { history: true });
+
+await store.nodes.Decision.create({ answer: "approve source A" });
+const decisionTime = await store.recordedNow();
+if (decisionTime === undefined) throw new Error("expected recorded history");
+
+const replay = store.asOfRecorded(decisionTime);
+const answer = await replay.nodes.Decision.getById(decisionId);
+```
+
+Docs: [Temporal queries](https://typegraph.dev/queries/temporal)
+
+Examples: [Bitemporal Time Travel](https://typegraph.dev/examples/bitemporal-time-travel)
+· [Agent Decision Replay](https://typegraph.dev/examples/agent-decision-replay)
+· [Breach Forensics](https://typegraph.dev/examples/breach-forensics)
+
+## Provenance and Retraction
+
+TypeGraph ships source-lineage retraction as a dedicated subpath:
+
+```ts
+import { createRetractionCapability } from "@nicia-ai/typegraph/provenance";
+```
+
+Map ordinary graph kinds onto source, justification, fact, premise, and
+derivation roles. Retraction flips a source's boolean flag, recomputes
+well-founded support, keeps facts with alternate support current, and makes
+unsupported facts non-current. Source roles can cover multiple node kinds, and
+terminal fact kinds do not have to be valid premises. Because the capability
+requires `history: true`, recorded-time reads can replay what the graph believed
+before and after the transition.
+
+Docs: [Provenance and Retraction](https://typegraph.dev/provenance)
+
+Example: [Provenance Retraction](https://typegraph.dev/examples/provenance-retraction)
+
 ## Performance Smoke Check
 
 The perf harness lives in `@nicia-ai/typegraph-benchmarks`; these commands delegate to it.

package/dist/backend/postgres/index.cjs

@@ -1,15 +1,20 @@
 'use strict';
 
-var chunkYL4F3CMD_cjs = require('../../chunk-YL4F3CMD.cjs');
-require('../../chunk-YW7GHMF4.cjs');
+var chunkTOTPVGOG_cjs = require('../../chunk-TOTPVGOG.cjs');
+var chunkUJLOZYKT_cjs = require('../../chunk-UJLOZYKT.cjs');
+require('../../chunk-KGC4LY5T.cjs');
+require('../../chunk-WVC2Q2FD.cjs');
+require('../../chunk-G6SOJEDI.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-CFNT3ITG.cjs');
-require('../../chunk-73KASJGO.cjs');
+require('../../chunk-JJRCLAUN.cjs');
+require('../../chunk-ACSVZPK7.cjs');
+require('../../chunk-2JXB3NYJ.cjs');
+require('../../chunk-ZY4GXIVN.cjs');
+require('../../chunk-UNNPKQUG.cjs');
+require('../../chunk-RHZWOJVA.cjs');
+require('../../chunk-YAZE7QZR.cjs');
+require('../../chunk-NAUA4PW5.cjs');
+require('../../chunk-3E7SNSIA.cjs');
 require('../../chunk-JIEJCTDS.cjs');
 require('../../chunk-FLRCVI2G.cjs');
 
@@ -17,43 +22,55 @@ require('../../chunk-FLRCVI2G.cjs');
 
 Object.defineProperty(exports, "createPostgresBackend", {
   enumerable: true,
-  get: function () { return chunkYL4F3CMD_cjs.createPostgresBackend; }
+  get: function () { return chunkTOTPVGOG_cjs.createPostgresBackend; }
 });
 Object.defineProperty(exports, "createPostgresTables", {
   enumerable: true,
-  get: function () { return chunk3HQDMOBK_cjs.createPostgresTables; }
+  get: function () { return chunkUJLOZYKT_cjs.createPostgresTables; }
 });
 Object.defineProperty(exports, "edges", {
   enumerable: true,
-  get: function () { return chunk3HQDMOBK_cjs.edges; }
+  get: function () { return chunkUJLOZYKT_cjs.edges; }
 });
 Object.defineProperty(exports, "fulltext", {
   enumerable: true,
-  get: function () { return chunk3HQDMOBK_cjs.fulltext; }
+  get: function () { return chunkUJLOZYKT_cjs.fulltext; }
 });
 Object.defineProperty(exports, "generatePostgresDDL", {
   enumerable: true,
-  get: function () { return chunk3HQDMOBK_cjs.generatePostgresDDL; }
+  get: function () { return chunkUJLOZYKT_cjs.generatePostgresDDL; }
 });
 Object.defineProperty(exports, "generatePostgresMigrationSQL", {
   enumerable: true,
-  get: function () { return chunk3HQDMOBK_cjs.generatePostgresMigrationSQL; }
+  get: function () { return chunkUJLOZYKT_cjs.generatePostgresMigrationSQL; }
 });
 Object.defineProperty(exports, "nodes", {
   enumerable: true,
-  get: function () { return chunk3HQDMOBK_cjs.nodes; }
+  get: function () { return chunkUJLOZYKT_cjs.nodes; }
+});
+Object.defineProperty(exports, "recordedClock", {
+  enumerable: true,
+  get: function () { return chunkUJLOZYKT_cjs.recordedClock; }
+});
+Object.defineProperty(exports, "recordedEdges", {
+  enumerable: true,
+  get: function () { return chunkUJLOZYKT_cjs.recordedEdges; }
+});
+Object.defineProperty(exports, "recordedNodes", {
+  enumerable: true,
+  get: function () { return chunkUJLOZYKT_cjs.recordedNodes; }
 });
 Object.defineProperty(exports, "schemaVersions", {
   enumerable: true,
-  get: function () { return chunk3HQDMOBK_cjs.schemaVersions; }
+  get: function () { return chunkUJLOZYKT_cjs.schemaVersions; }
 });
 Object.defineProperty(exports, "tables", {
   enumerable: true,
-  get: function () { return chunk3HQDMOBK_cjs.tables; }
+  get: function () { return chunkUJLOZYKT_cjs.tables; }
 });
 Object.defineProperty(exports, "uniques", {
   enumerable: true,
-  get: function () { return chunk3HQDMOBK_cjs.uniques; }
+  get: function () { return chunkUJLOZYKT_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-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 { F as FulltextStrategy, V as VectorStrategy, B as BackendCapabilities, b as AnyPgDatabase, G as GraphBackend } from '../../types-DkNnF-7K.cjs';
+import { P as PostgresTables } from '../../postgres-BhpxGMC5.cjs';
+export { C as CreatePostgresTablesOptions, a as PostgresTableNames, c as createPostgresTables, e as edges, f as fulltext, n as nodes, r as recordedClock, b as recordedEdges, d as recordedNodes, s as schemaVersions, t as tables, u as uniques } from '../../postgres-BhpxGMC5.cjs';
+export { b as generatePostgresDDL, c as generatePostgresMigrationSQL } from '../../ddl-j1-sH6lE.cjs';
 import 'zod';
-import '../../extension-types-D1k0inWU.cjs';
+import '../../extension-types-YGFJPrzK.cjs';
 import 'drizzle-orm';
 import 'drizzle-orm/pg-core';
 import 'drizzle-orm/sqlite-core';
-import '../../sqlite-DcQ_BCUW.cjs';
+import '../../sqlite-XrDxNaa7.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-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 { F as FulltextStrategy, V as VectorStrategy, B as BackendCapabilities, b as AnyPgDatabase, G as GraphBackend } from '../../types-D1Sqeyxy.js';
+import { P as PostgresTables } from '../../postgres-CWHLwNl1.js';
+export { C as CreatePostgresTablesOptions, a as PostgresTableNames, c as createPostgresTables, e as edges, f as fulltext, n as nodes, r as recordedClock, b as recordedEdges, d as recordedNodes, s as schemaVersions, t as tables, u as uniques } from '../../postgres-CWHLwNl1.js';
+export { b as generatePostgresDDL, c as generatePostgresMigrationSQL } from '../../ddl-BrmPg61z.js';
 import 'zod';
-import '../../extension-types-D1k0inWU.js';
+import '../../extension-types-YGFJPrzK.js';
 import 'drizzle-orm';
 import 'drizzle-orm/pg-core';
 import 'drizzle-orm/sqlite-core';
-import '../../sqlite-BfLsCEqO.js';
+import '../../sqlite-CGu5SLsw.js';
 
 /**
  * Options for creating a PostgreSQL backend.

package/dist/backend/postgres/index.js

@@ -1,13 +1,18 @@
-export { createPostgresBackend } from '../../chunk-NDM5PXEH.js';
-import '../../chunk-PRMKPFN5.js';
+export { createPostgresBackend } from '../../chunk-LANHCOXB.js';
+export { createPostgresTables, edges, fulltext, generatePostgresDDL, generatePostgresMigrationSQL, nodes, recordedClock, recordedEdges, recordedNodes, schemaVersions, tables, uniques } from '../../chunk-RY2VIWAM.js';
+import '../../chunk-DEQFL35G.js';
+import '../../chunk-CYX2JTDG.js';
+import '../../chunk-6GNSY7AV.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-C4C4Q7A6.js';
-import '../../chunk-2YMGNYXY.js';
+import '../../chunk-QV245VMN.js';
+import '../../chunk-UR7W5YQK.js';
+import '../../chunk-KUTNI6SI.js';
+import '../../chunk-K34OPSJK.js';
+import '../../chunk-V3QNTB7Z.js';
+import '../../chunk-2MRAX3UE.js';
+import '../../chunk-GZCNZ7QW.js';
+import '../../chunk-2EBMPJBO.js';
+import '../../chunk-XLUNB2TZ.js';
 import '../../chunk-TQOYM4LN.js';
 import '../../chunk-K5P5OZXS.js';
 //# sourceMappingURL=index.js.map

package/dist/backend/postgres/pglite.cjs

@@ -1,15 +1,20 @@
 'use strict';
 
-var chunkYL4F3CMD_cjs = require('../../chunk-YL4F3CMD.cjs');
-require('../../chunk-YW7GHMF4.cjs');
+var chunkTOTPVGOG_cjs = require('../../chunk-TOTPVGOG.cjs');
+var chunkUJLOZYKT_cjs = require('../../chunk-UJLOZYKT.cjs');
+require('../../chunk-KGC4LY5T.cjs');
+require('../../chunk-WVC2Q2FD.cjs');
+require('../../chunk-G6SOJEDI.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-CFNT3ITG.cjs');
-require('../../chunk-73KASJGO.cjs');
+require('../../chunk-JJRCLAUN.cjs');
+require('../../chunk-ACSVZPK7.cjs');
+require('../../chunk-2JXB3NYJ.cjs');
+require('../../chunk-ZY4GXIVN.cjs');
+var chunkUNNPKQUG_cjs = require('../../chunk-UNNPKQUG.cjs');
+require('../../chunk-RHZWOJVA.cjs');
+require('../../chunk-YAZE7QZR.cjs');
+require('../../chunk-NAUA4PW5.cjs');
+require('../../chunk-3E7SNSIA.cjs');
 var chunkJIEJCTDS_cjs = require('../../chunk-JIEJCTDS.cjs');
 require('../../chunk-FLRCVI2G.cjs');
 var pglite = require('@electric-sql/pglite');
@@ -28,21 +33,21 @@ async function loadDefaultPgvectorExtension() {
   }
 }
 async function createLocalPgliteBackend(options = {}) {
-  const tables2 = options.tables ?? chunk3HQDMOBK_cjs.tables;
+  const tables2 = options.tables ?? chunkUJLOZYKT_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 ? chunk3HQDMOBK_cjs.generatePostgresMigrationSQL(tables2) : chunk3HQDMOBK_cjs.generatePostgresDDL(tables2).join("\n\n");
+  const migrationSql = vectorEnabled ? chunkUJLOZYKT_cjs.generatePostgresMigrationSQL(tables2) : chunkUJLOZYKT_cjs.generatePostgresDDL(tables2).join("\n\n");
   await client.exec(migrationSql);
   const db = pglite$1.drizzle(client);
-  const backend = chunkYL4F3CMD_cjs.createPostgresBackend(db, {
+  const backend = chunkTOTPVGOG_cjs.createPostgresBackend(db, {
     tables: tables2,
     ...vectorEnabled ? {} : { vector: false }
   });
-  const managedBackend = chunk6G35I3VW_cjs.wrapWithManagedClose(backend, async () => {
+  const managedBackend = chunkUNNPKQUG_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-Dvmn-eal.cjs';
-import { P as PostgresTables } from '../../postgres-jgXmD45C.cjs';
+import { G as GraphBackend } from '../../types-DkNnF-7K.cjs';
+import { P as PostgresTables } from '../../postgres-BhpxGMC5.cjs';
 import 'zod';
-import '../../extension-types-D1k0inWU.cjs';
+import '../../extension-types-YGFJPrzK.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-Dk8r09KY.js';
-import { P as PostgresTables } from '../../postgres-Dhom7iiX.js';
+import { G as GraphBackend } from '../../types-D1Sqeyxy.js';
+import { P as PostgresTables } from '../../postgres-CWHLwNl1.js';
 import 'zod';
-import '../../extension-types-D1k0inWU.js';
+import '../../extension-types-YGFJPrzK.js';
 import 'drizzle-orm';
 import 'drizzle-orm/pg-core';
 import 'drizzle-orm/sqlite-core';

package/dist/backend/postgres/pglite.js

@@ -1,13 +1,18 @@
-import { createPostgresBackend } from '../../chunk-NDM5PXEH.js';
-import '../../chunk-PRMKPFN5.js';
+import { createPostgresBackend } from '../../chunk-LANHCOXB.js';
+import { tables, generatePostgresMigrationSQL, generatePostgresDDL } from '../../chunk-RY2VIWAM.js';
+import '../../chunk-DEQFL35G.js';
+import '../../chunk-CYX2JTDG.js';
+import '../../chunk-6GNSY7AV.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-C4C4Q7A6.js';
-import '../../chunk-2YMGNYXY.js';
+import '../../chunk-QV245VMN.js';
+import '../../chunk-UR7W5YQK.js';
+import '../../chunk-KUTNI6SI.js';
+import '../../chunk-K34OPSJK.js';
+import { wrapWithManagedClose } from '../../chunk-V3QNTB7Z.js';
+import '../../chunk-2MRAX3UE.js';
+import '../../chunk-GZCNZ7QW.js';
+import '../../chunk-2EBMPJBO.js';
+import '../../chunk-XLUNB2TZ.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,18 @@
 'use strict';
 
-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-CFNT3ITG.cjs');
-require('../../chunk-73KASJGO.cjs');
+var chunkZP5WHI4C_cjs = require('../../chunk-ZP5WHI4C.cjs');
+var chunkUJLOZYKT_cjs = require('../../chunk-UJLOZYKT.cjs');
+var chunkWVC2Q2FD_cjs = require('../../chunk-WVC2Q2FD.cjs');
+require('../../chunk-G6SOJEDI.cjs');
+require('../../chunk-JJRCLAUN.cjs');
+require('../../chunk-ACSVZPK7.cjs');
+require('../../chunk-2JXB3NYJ.cjs');
+require('../../chunk-ZY4GXIVN.cjs');
+require('../../chunk-UNNPKQUG.cjs');
+require('../../chunk-RHZWOJVA.cjs');
+require('../../chunk-YAZE7QZR.cjs');
+require('../../chunk-NAUA4PW5.cjs');
+require('../../chunk-3E7SNSIA.cjs');
 require('../../chunk-JIEJCTDS.cjs');
 require('../../chunk-FLRCVI2G.cjs');
 
@@ -15,39 +20,51 @@ require('../../chunk-FLRCVI2G.cjs');
 
 Object.defineProperty(exports, "createSqliteBackend", {
   enumerable: true,
-  get: function () { return chunkCAMMC3E4_cjs.createSqliteBackend; }
+  get: function () { return chunkZP5WHI4C_cjs.createSqliteBackend; }
 });
 Object.defineProperty(exports, "generateSqliteDDL", {
   enumerable: true,
-  get: function () { return chunk3HQDMOBK_cjs.generateSqliteDDL; }
+  get: function () { return chunkUJLOZYKT_cjs.generateSqliteDDL; }
 });
 Object.defineProperty(exports, "generateSqliteMigrationSQL", {
   enumerable: true,
-  get: function () { return chunk3HQDMOBK_cjs.generateSqliteMigrationSQL; }
+  get: function () { return chunkUJLOZYKT_cjs.generateSqliteMigrationSQL; }
 });
 Object.defineProperty(exports, "createSqliteTables", {
   enumerable: true,
-  get: function () { return chunkJKRKIEVA_cjs.createSqliteTables; }
+  get: function () { return chunkWVC2Q2FD_cjs.createSqliteTables; }
 });
 Object.defineProperty(exports, "edges", {
   enumerable: true,
-  get: function () { return chunkJKRKIEVA_cjs.edges; }
+  get: function () { return chunkWVC2Q2FD_cjs.edges; }
 });
 Object.defineProperty(exports, "nodes", {
   enumerable: true,
-  get: function () { return chunkJKRKIEVA_cjs.nodes; }
+  get: function () { return chunkWVC2Q2FD_cjs.nodes; }
+});
+Object.defineProperty(exports, "recordedClock", {
+  enumerable: true,
+  get: function () { return chunkWVC2Q2FD_cjs.recordedClock; }
+});
+Object.defineProperty(exports, "recordedEdges", {
+  enumerable: true,
+  get: function () { return chunkWVC2Q2FD_cjs.recordedEdges; }
+});
+Object.defineProperty(exports, "recordedNodes", {
+  enumerable: true,
+  get: function () { return chunkWVC2Q2FD_cjs.recordedNodes; }
 });
 Object.defineProperty(exports, "schemaVersions", {
   enumerable: true,
-  get: function () { return chunkJKRKIEVA_cjs.schemaVersions; }
+  get: function () { return chunkWVC2Q2FD_cjs.schemaVersions; }
 });
 Object.defineProperty(exports, "tables", {
   enumerable: true,
-  get: function () { return chunkJKRKIEVA_cjs.tables; }
+  get: function () { return chunkWVC2Q2FD_cjs.tables; }
 });
 Object.defineProperty(exports, "uniques", {
   enumerable: true,
-  get: function () { return chunkJKRKIEVA_cjs.uniques; }
+  get: function () { return chunkWVC2Q2FD_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-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 { S as SqliteExecutionProfileHints, F as FulltextStrategy, V as VectorStrategy, B as BackendCapabilities, A as AnySqliteDatabase, G as GraphBackend } from '../../types-DkNnF-7K.cjs';
+export { a as SqliteTransactionMode } from '../../types-DkNnF-7K.cjs';
+import { S as SqliteTables } from '../../sqlite-XrDxNaa7.cjs';
+export { C as CreateSqliteTablesOptions, a as SqliteTableNames, c as createSqliteTables, e as edges, n as nodes, r as recordedClock, b as recordedEdges, d as recordedNodes, s as schemaVersions, t as tables, u as uniques } from '../../sqlite-XrDxNaa7.cjs';
+export { g as generateSqliteDDL, a as generateSqliteMigrationSQL } from '../../ddl-j1-sH6lE.cjs';
 import 'zod';
-import '../../extension-types-D1k0inWU.cjs';
+import '../../extension-types-YGFJPrzK.cjs';
 import 'drizzle-orm';
 import 'drizzle-orm/pg-core';
 import 'drizzle-orm/sqlite-core';
-import '../../postgres-jgXmD45C.cjs';
+import '../../postgres-BhpxGMC5.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-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 { S as SqliteExecutionProfileHints, F as FulltextStrategy, V as VectorStrategy, B as BackendCapabilities, A as AnySqliteDatabase, G as GraphBackend } from '../../types-D1Sqeyxy.js';
+export { a as SqliteTransactionMode } from '../../types-D1Sqeyxy.js';
+import { S as SqliteTables } from '../../sqlite-CGu5SLsw.js';
+export { C as CreateSqliteTablesOptions, a as SqliteTableNames, c as createSqliteTables, e as edges, n as nodes, r as recordedClock, b as recordedEdges, d as recordedNodes, s as schemaVersions, t as tables, u as uniques } from '../../sqlite-CGu5SLsw.js';
+export { g as generateSqliteDDL, a as generateSqliteMigrationSQL } from '../../ddl-BrmPg61z.js';
 import 'zod';
-import '../../extension-types-D1k0inWU.js';
+import '../../extension-types-YGFJPrzK.js';
 import 'drizzle-orm';
 import 'drizzle-orm/pg-core';
 import 'drizzle-orm/sqlite-core';
-import '../../postgres-Dhom7iiX.js';
+import '../../postgres-CWHLwNl1.js';
 
 /**
  * Options for creating a SQLite backend.

package/dist/backend/sqlite/index.js

@@ -1,11 +1,16 @@
-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-C4C4Q7A6.js';
-import '../../chunk-2YMGNYXY.js';
+export { createSqliteBackend } from '../../chunk-ZV5N4DBG.js';
+export { generateSqliteDDL, generateSqliteMigrationSQL } from '../../chunk-RY2VIWAM.js';
+export { createSqliteTables, edges, nodes, recordedClock, recordedEdges, recordedNodes, schemaVersions, tables, uniques } from '../../chunk-CYX2JTDG.js';
+import '../../chunk-6GNSY7AV.js';
+import '../../chunk-QV245VMN.js';
+import '../../chunk-UR7W5YQK.js';
+import '../../chunk-KUTNI6SI.js';
+import '../../chunk-K34OPSJK.js';
+import '../../chunk-V3QNTB7Z.js';
+import '../../chunk-2MRAX3UE.js';
+import '../../chunk-GZCNZ7QW.js';
+import '../../chunk-2EBMPJBO.js';
+import '../../chunk-XLUNB2TZ.js';
 import '../../chunk-TQOYM4LN.js';
 import '../../chunk-K5P5OZXS.js';
 //# sourceMappingURL=index.js.map