@nicia-ai/typegraph 0.42.0 → 0.42.1

package/dist/backend/postgres/index.cjs

@@ -1,6 +1,6 @@
 'use strict';
 
-var chunk7TOT7RKY_cjs = require('../../chunk-7TOT7RKY.cjs');
+var chunk5ZPRE4CV_cjs = require('../../chunk-5ZPRE4CV.cjs');
 require('../../chunk-O7XVCLXW.cjs');
 require('../../chunk-33PAKPED.cjs');
 require('../../chunk-VGMNGWBR.cjs');
@@ -24,7 +24,7 @@ require('../../chunk-TDXIBCGY.cjs');
 
 Object.defineProperty(exports, "createPostgresBackend", {
   enumerable: true,
-  get: function () { return chunk7TOT7RKY_cjs.createPostgresBackend; }
+  get: function () { return chunk5ZPRE4CV_cjs.createPostgresBackend; }
 });
 Object.defineProperty(exports, "createPostgresTables", {
   enumerable: true,

package/dist/backend/postgres/index.js

@@ -1,4 +1,4 @@
-export { createPostgresBackend } from '../../chunk-BGXKXGDI.js';
+export { createPostgresBackend } from '../../chunk-YPVQYM3L.js';
 import '../../chunk-HHBKGPEI.js';
 import '../../chunk-ZGOUVMVS.js';
 import '../../chunk-ZOHCFYXE.js';

package/dist/backend/postgres/pglite-store.cjs

@@ -1,7 +1,7 @@
 'use strict';
 
-var chunkRTUCOEIO_cjs = require('../../chunk-RTUCOEIO.cjs');
-require('../../chunk-7TOT7RKY.cjs');
+var chunk5Q3P6OIC_cjs = require('../../chunk-5Q3P6OIC.cjs');
+require('../../chunk-5ZPRE4CV.cjs');
 require('../../chunk-O7XVCLXW.cjs');
 var chunk277UZV7X_cjs = require('../../chunk-277UZV7X.cjs');
 require('../../chunk-33PAKPED.cjs');
@@ -45,7 +45,7 @@ require('../../chunk-TDXIBCGY.cjs');
 // src/backend/postgres/pglite-store.ts
 async function createLocalPgliteStore(graph, options = {}) {
   const tables = options.store?.schema === void 0 ? void 0 : chunkOMQ2NBOR_cjs.createPostgresTables(options.store.schema.tables);
-  const { backend } = await chunkRTUCOEIO_cjs.createLocalPgliteBackend({
+  const { backend } = await chunk5Q3P6OIC_cjs.createLocalPgliteBackend({
     ...options.dataDir === void 0 ? {} : { dataDir: options.dataDir },
     ...options.vector === false ? { vector: false } : {},
     ...tables === void 0 ? {} : { tables }

package/dist/backend/postgres/pglite-store.js

@@ -1,5 +1,5 @@
-import { createLocalPgliteBackend } from '../../chunk-LTVBD56M.js';
-import '../../chunk-BGXKXGDI.js';
+import { createLocalPgliteBackend } from '../../chunk-NXIZL7ZZ.js';
+import '../../chunk-YPVQYM3L.js';
 import '../../chunk-HHBKGPEI.js';
 import { createStoreWithSchema } from '../../chunk-DP7KC6CL.js';
 import '../../chunk-ZGOUVMVS.js';

package/dist/backend/postgres/pglite.cjs

@@ -1,7 +1,7 @@
 'use strict';
 
-var chunkRTUCOEIO_cjs = require('../../chunk-RTUCOEIO.cjs');
-require('../../chunk-7TOT7RKY.cjs');
+var chunk5Q3P6OIC_cjs = require('../../chunk-5Q3P6OIC.cjs');
+require('../../chunk-5ZPRE4CV.cjs');
 require('../../chunk-O7XVCLXW.cjs');
 require('../../chunk-33PAKPED.cjs');
 require('../../chunk-VGMNGWBR.cjs');
@@ -25,7 +25,7 @@ require('../../chunk-TDXIBCGY.cjs');
 
 Object.defineProperty(exports, "createLocalPgliteBackend", {
   enumerable: true,
-  get: function () { return chunkRTUCOEIO_cjs.createLocalPgliteBackend; }
+  get: function () { return chunk5Q3P6OIC_cjs.createLocalPgliteBackend; }
 });
 //# sourceMappingURL=pglite.cjs.map
 //# sourceMappingURL=pglite.cjs.map

package/dist/backend/postgres/pglite.js

@@ -1,5 +1,5 @@
-export { createLocalPgliteBackend } from '../../chunk-LTVBD56M.js';
-import '../../chunk-BGXKXGDI.js';
+export { createLocalPgliteBackend } from '../../chunk-NXIZL7ZZ.js';
+import '../../chunk-YPVQYM3L.js';
 import '../../chunk-HHBKGPEI.js';
 import '../../chunk-ZGOUVMVS.js';
 import '../../chunk-ZOHCFYXE.js';

package/dist/{chunk-RTUCOEIO.cjs → chunk-5Q3P6OIC.cjs}

@@ -1,6 +1,6 @@
 'use strict';
 
-var chunk7TOT7RKY_cjs = require('./chunk-7TOT7RKY.cjs');
+var chunk5ZPRE4CV_cjs = require('./chunk-5ZPRE4CV.cjs');
 var chunkOMQ2NBOR_cjs = require('./chunk-OMQ2NBOR.cjs');
 var chunkECU53PMN_cjs = require('./chunk-ECU53PMN.cjs');
 var chunkKTBTSHU6_cjs = require('./chunk-KTBTSHU6.cjs');
@@ -31,7 +31,7 @@ async function createLocalPgliteBackend(options = {}) {
     const migrationSql = vectorEnabled ? chunkOMQ2NBOR_cjs.generatePostgresMigrationSQL(tables2) : chunkOMQ2NBOR_cjs.generatePostgresDDL(tables2).join("\n\n");
     await client.exec(migrationSql);
     const db = pglite$1.drizzle(client);
-    const backend = chunk7TOT7RKY_cjs.createPostgresBackend(db, {
+    const backend = chunk5ZPRE4CV_cjs.createPostgresBackend(db, {
       tables: tables2,
       ...vectorEnabled ? {} : { vector: false }
     });
@@ -45,5 +45,5 @@ async function createLocalPgliteBackend(options = {}) {
 }
 
 exports.createLocalPgliteBackend = createLocalPgliteBackend;
-//# sourceMappingURL=chunk-RTUCOEIO.cjs.map
-//# sourceMappingURL=chunk-RTUCOEIO.cjs.map
+//# sourceMappingURL=chunk-5Q3P6OIC.cjs.map
+//# sourceMappingURL=chunk-5Q3P6OIC.cjs.map

package/dist/{chunk-RTUCOEIO.cjs.map → chunk-5Q3P6OIC.cjs.map}

@@ -1 +1 @@
-{"version":3,"sources":["../src/backend/postgres/pglite.ts"],"names":["ConfigurationError","tables","PGlite","generatePostgresMigrationSQL","generatePostgresDDL","drizzle","createPostgresBackend","wrapWithManagedClose","closeAfterFailure"],"mappings":";;;;;;;;;AAiIA,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;AAED,EAAA,IAAI;AAGF,IAAA,MAAM,YAAA,GACJ,gBACEC,8CAAA,CAA6BF,OAAM,IACnCG,qCAAA,CAAoBH,OAAM,CAAA,CAAE,IAAA,CAAK,MAAM,CAAA;AAC3C,IAAA,MAAM,MAAA,CAAO,KAAK,YAAY,CAAA;AAE9B,IAAA,MAAM,EAAA,GAAKI,iBAAQ,MAAM,CAAA;AACzB,IAAA,MAAM,OAAA,GAAUC,wCAAsB,EAAA,EAAI;AAAA,MACxC,MAAA,EAAAL,OAAAA;AAAA,MACA,GAAI,aAAA,GAAgB,EAAC,GAAI,EAAE,QAAQ,KAAA;AAAM,KAC1C,CAAA;AACD,IAAA,MAAM,cAAA,GAAiBM,sCAAA,CAAqB,OAAA,EAAS,YAAY;AAC/D,MAAA,MAAM,OAAO,KAAA,EAAM;AAAA,IACrB,CAAC,CAAA;AAED,IAAA,OAAO,EAAE,OAAA,EAAS,cAAA,EAAgB,EAAA,EAAI,MAAA,EAAO;AAAA,EAC/C,SAAS,KAAA,EAAO;AACd,IAAA,OAAOC,mCAAA,CAAkB,QAAQ,KAAK,CAAA;AAAA,EACxC;AACF","file":"chunk-RTUCOEIO.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/adapters/drizzle/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 { type AnyPgTransaction } from \"../drizzle/execution\";\nexport type { AnyPgDatabase, AnyPgTransaction } from \"../drizzle/execution\";\nimport {\n  createPostgresBackend,\n  type PostgresTables,\n  tables as defaultTables,\n} from \"../drizzle/postgres\";\nimport {\n  type AdapterBackend,\n  closeAfterFailure,\n  wrapWithManagedClose,\n} 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: AdapterBackend<AnyPgTransaction>;\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  try {\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  } catch (error) {\n    return closeAfterFailure(client, error);\n  }\n}\n"]}
+{"version":3,"sources":["../src/backend/postgres/pglite.ts"],"names":["ConfigurationError","tables","PGlite","generatePostgresMigrationSQL","generatePostgresDDL","drizzle","createPostgresBackend","wrapWithManagedClose","closeAfterFailure"],"mappings":";;;;;;;;;AAiIA,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;AAED,EAAA,IAAI;AAGF,IAAA,MAAM,YAAA,GACJ,gBACEC,8CAAA,CAA6BF,OAAM,IACnCG,qCAAA,CAAoBH,OAAM,CAAA,CAAE,IAAA,CAAK,MAAM,CAAA;AAC3C,IAAA,MAAM,MAAA,CAAO,KAAK,YAAY,CAAA;AAE9B,IAAA,MAAM,EAAA,GAAKI,iBAAQ,MAAM,CAAA;AACzB,IAAA,MAAM,OAAA,GAAUC,wCAAsB,EAAA,EAAI;AAAA,MACxC,MAAA,EAAAL,OAAAA;AAAA,MACA,GAAI,aAAA,GAAgB,EAAC,GAAI,EAAE,QAAQ,KAAA;AAAM,KAC1C,CAAA;AACD,IAAA,MAAM,cAAA,GAAiBM,sCAAA,CAAqB,OAAA,EAAS,YAAY;AAC/D,MAAA,MAAM,OAAO,KAAA,EAAM;AAAA,IACrB,CAAC,CAAA;AAED,IAAA,OAAO,EAAE,OAAA,EAAS,cAAA,EAAgB,EAAA,EAAI,MAAA,EAAO;AAAA,EAC/C,SAAS,KAAA,EAAO;AACd,IAAA,OAAOC,mCAAA,CAAkB,QAAQ,KAAK,CAAA;AAAA,EACxC;AACF","file":"chunk-5Q3P6OIC.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/adapters/drizzle/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 { type AnyPgTransaction } from \"../drizzle/execution\";\nexport type { AnyPgDatabase, AnyPgTransaction } from \"../drizzle/execution\";\nimport {\n  createPostgresBackend,\n  type PostgresTables,\n  tables as defaultTables,\n} from \"../drizzle/postgres\";\nimport {\n  type AdapterBackend,\n  closeAfterFailure,\n  wrapWithManagedClose,\n} 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: AdapterBackend<AnyPgTransaction>;\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  try {\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  } catch (error) {\n    return closeAfterFailure(client, error);\n  }\n}\n"]}

package/dist/{chunk-7TOT7RKY.cjs → chunk-5ZPRE4CV.cjs}

@@ -29,6 +29,10 @@ function isPgNativeClient(candidate) {
 function isPgliteClient(candidate) {
   return typeof candidate === "object" && hasFunctionProperty(candidate, "query") && hasFunctionProperty(candidate, "dumpDataDir");
 }
+var PGLITE_MAX_BIND_PARAMETERS = 32767;
+function isPgliteDatabase(db) {
+  return isPgliteClient(db.$client);
+}
 function transactionSession(carrier) {
   return carrier.session ?? carrier._?.session;
 }
@@ -140,9 +144,10 @@ async function executeDrizzleQuery(db, query) {
   }
   return result.rows;
 }
-function createPgPreparedStatement(pgClient, sqlText) {
+function createPgPreparedStatement(pgClient, sqlText, maxBindParameters) {
   return {
     async execute(params) {
+      assertWithinBindParameterLimit(params.length, maxBindParameters);
       const result = await pgClient.query(sqlText, params);
       return result.rows;
     }
@@ -151,6 +156,7 @@ function createPgPreparedStatement(pgClient, sqlText) {
 function createPostgresExecutionAdapter(db, options = {}) {
   const prepareStatements = options.prepareStatements ?? true;
   const cacheMax = options.preparedStatementCacheMax ?? DEFAULT_POSTGRES_STATEMENT_CACHE_MAX;
+  const maxBindParameters = options.maxBindParameters;
   const pgClient = resolvePgClient(
     db,
     prepareStatements,
@@ -160,10 +166,17 @@ function createPostgresExecutionAdapter(db, options = {}) {
   function compile(query) {
     return chunk6TJ6PKPS_cjs.compileQueryWithDialect(db, query, "PostgreSQL");
   }
+  function assertCompiledWithinBindParameterLimit(compiledQuery) {
+    assertWithinBindParameterLimit(
+      compiledQuery.params.length,
+      maxBindParameters
+    );
+  }
   if (pgClient === void 0) {
     return {
       compile,
       async execute(query) {
+        assertCompiledWithinBindParameterLimit(compile(query));
         return executeDrizzleQuery(
           db,
           chunkX2XOQZT3_cjs.isSqlFragment(query) ? chunk6TJ6PKPS_cjs.toDrizzleSql(query, "postgres") : query
@@ -173,6 +186,7 @@ function createPostgresExecutionAdapter(db, options = {}) {
   }
   const pgQueryClient = pgClient;
   async function executeCompiled(compiledQuery) {
+    assertCompiledWithinBindParameterLimit(compiledQuery);
     const result = await pgQueryClient.query(
       compiledQuery.sql,
       compiledQuery.params
@@ -183,6 +197,7 @@ function createPostgresExecutionAdapter(db, options = {}) {
     compile,
     async execute(query) {
       const compiled = compile(query);
+      assertCompiledWithinBindParameterLimit(compiled);
       if (chunkX2XOQZT3_cjs.isSqlFragment(query) && chunkX2XOQZT3_cjs.shouldForceCustomPlan(query)) {
         const result = await pgQueryClient.queryUnnamed(
           compiled.sql,
@@ -194,10 +209,30 @@ function createPostgresExecutionAdapter(db, options = {}) {
     },
     executeCompiled,
     prepare(sqlText) {
-      return createPgPreparedStatement(pgQueryClient, sqlText);
+      return createPgPreparedStatement(
+        pgQueryClient,
+        sqlText,
+        maxBindParameters
+      );
     }
   };
 }
+function assertWithinBindParameterLimit(parameterCount, maxBindParameters) {
+  if (maxBindParameters === void 0 || parameterCount <= maxBindParameters) {
+    return;
+  }
+  throw new chunkKTBTSHU6_cjs.ConfigurationError(
+    `PostgreSQL statement uses ${parameterCount} bound parameters, exceeding this backend's limit of ${maxBindParameters}.`,
+    {
+      capability: "maxBindParameters",
+      maxBindParameters,
+      parameterCount
+    },
+    {
+      suggestion: "Split the operation into smaller batches or lower the batch size before retrying."
+    }
+  );
+}
 
 // src/backend/drizzle/execution/statement-queue.ts
 function ignoreOutcome() {
@@ -253,42 +288,52 @@ function createSerialExecutionAdapter(adapter) {
 // src/backend/drizzle/postgres.ts
 var NODE_INSERT_PARAM_COUNT = 9;
 var EDGE_INSERT_PARAM_COUNT = 12;
-var POSTGRES_NODE_INSERT_BATCH_SIZE = Math.max(
-  1,
-  Math.floor(chunkECU53PMN_cjs.POSTGRES_MAX_BIND_PARAMETERS / NODE_INSERT_PARAM_COUNT)
-);
-var POSTGRES_EDGE_INSERT_BATCH_SIZE = Math.max(
-  1,
-  Math.floor(chunkECU53PMN_cjs.POSTGRES_MAX_BIND_PARAMETERS / EDGE_INSERT_PARAM_COUNT)
-);
-var POSTGRES_GET_NODES_ID_CHUNK_SIZE = Math.max(
-  1,
-  chunkECU53PMN_cjs.POSTGRES_MAX_BIND_PARAMETERS - 2
-);
-var POSTGRES_GET_EDGES_ID_CHUNK_SIZE = Math.max(
-  1,
-  chunkECU53PMN_cjs.POSTGRES_MAX_BIND_PARAMETERS - 1
-);
+var GET_NODES_FIXED_PARAM_COUNT = 2;
+var GET_EDGES_FIXED_PARAM_COUNT = 1;
 var FULLTEXT_UPSERT_PARAM_COUNT = 6;
 var FULLTEXT_DELETE_FIXED_PARAM_COUNT = 2;
-var POSTGRES_FULLTEXT_UPSERT_BATCH_SIZE = Math.max(
-  1,
-  Math.floor(chunkECU53PMN_cjs.POSTGRES_MAX_BIND_PARAMETERS / FULLTEXT_UPSERT_PARAM_COUNT)
-);
-var POSTGRES_FULLTEXT_DELETE_CHUNK_SIZE = Math.max(
-  1,
-  chunkECU53PMN_cjs.POSTGRES_MAX_BIND_PARAMETERS - FULLTEXT_DELETE_FIXED_PARAM_COUNT
-);
 var CHECK_UNIQUE_BATCH_FIXED_PARAM_COUNT = 3;
-var POSTGRES_CHECK_UNIQUE_BATCH_CHUNK_SIZE = Math.max(
-  1,
-  chunkECU53PMN_cjs.POSTGRES_MAX_BIND_PARAMETERS - CHECK_UNIQUE_BATCH_FIXED_PARAM_COUNT
-);
 var UNIQUE_INSERT_PARAM_COUNT = 6;
-var POSTGRES_UNIQUE_INSERT_BATCH_SIZE = Math.max(
-  1,
-  Math.floor(chunkECU53PMN_cjs.POSTGRES_MAX_BIND_PARAMETERS / UNIQUE_INSERT_PARAM_COUNT)
-);
+function computePostgresBatchChunkSizes(maxBindParameters) {
+  return {
+    checkUniqueBatchChunkSize: Math.max(
+      1,
+      maxBindParameters - CHECK_UNIQUE_BATCH_FIXED_PARAM_COUNT
+    ),
+    edgeInsertBatchSize: Math.max(
+      1,
+      Math.floor(maxBindParameters / EDGE_INSERT_PARAM_COUNT)
+    ),
+    embeddingUpsertBatchSize: Math.max(
+      1,
+      Math.floor(maxBindParameters / chunkO7XVCLXW_cjs.EMBEDDING_UPSERT_PARAM_COUNT)
+    ),
+    fulltextDeleteChunkSize: Math.max(
+      1,
+      maxBindParameters - FULLTEXT_DELETE_FIXED_PARAM_COUNT
+    ),
+    fulltextUpsertBatchSize: Math.max(
+      1,
+      Math.floor(maxBindParameters / FULLTEXT_UPSERT_PARAM_COUNT)
+    ),
+    getEdgesChunkSize: Math.max(
+      1,
+      maxBindParameters - GET_EDGES_FIXED_PARAM_COUNT
+    ),
+    getNodesChunkSize: Math.max(
+      1,
+      maxBindParameters - GET_NODES_FIXED_PARAM_COUNT
+    ),
+    nodeInsertBatchSize: Math.max(
+      1,
+      Math.floor(maxBindParameters / NODE_INSERT_PARAM_COUNT)
+    ),
+    uniqueInsertBatchSize: Math.max(
+      1,
+      Math.floor(maxBindParameters / UNIQUE_INSERT_PARAM_COUNT)
+    )
+  };
+}
 var toNodeRow = chunkAQR6BHB3_cjs.createNodeRowMapper(chunkAQR6BHB3_cjs.POSTGRES_ROW_MAPPER_CONFIG);
 var toEdgeRow = chunkAQR6BHB3_cjs.createEdgeRowMapper(chunkAQR6BHB3_cjs.POSTGRES_ROW_MAPPER_CONFIG);
 var toUniqueRow = chunkAQR6BHB3_cjs.createUniqueRowMapper(chunkAQR6BHB3_cjs.POSTGRES_ROW_MAPPER_CONFIG);
@@ -318,14 +363,23 @@ function createPostgresBackend(db, options = {}) {
       supported: false
     }
   } : {};
+  const configuredMaxBindParameters = options.capabilities?.maxBindParameters ?? chunkECU53PMN_cjs.POSTGRES_MAX_BIND_PARAMETERS;
+  const driverBindParameterOverrides = isPgliteDatabase(db) ? {
+    maxBindParameters: Math.min(
+      configuredMaxBindParameters,
+      PGLITE_MAX_BIND_PARAMETERS
+    )
+  } : {};
   const capabilities = chunkECU53PMN_cjs.normalizeGraphAnalyticsCapabilities({
     ...baseCapabilities,
     ...httpOnlyOverrides,
-    ...options.capabilities
+    ...options.capabilities,
+    ...driverBindParameterOverrides
   });
   const adapterOptions = {
     ...options.prepareStatements === void 0 ? {} : { prepareStatements: options.prepareStatements },
-    ...options.preparedStatementCacheMax === void 0 ? {} : { preparedStatementCacheMax: options.preparedStatementCacheMax }
+    ...options.preparedStatementCacheMax === void 0 ? {} : { preparedStatementCacheMax: options.preparedStatementCacheMax },
+    maxBindParameters: capabilities.maxBindParameters ?? chunkECU53PMN_cjs.POSTGRES_MAX_BIND_PARAMETERS
   };
   const executionAdapter = createPostgresExecutionAdapter(db, adapterOptions);
   const tableNames = {
@@ -948,23 +1002,9 @@ function createPostgresOperationBackend(options) {
       return txAdapter.execute(query);
     });
   }
-  const batchConfig = {
-    checkUniqueBatchChunkSize: POSTGRES_CHECK_UNIQUE_BATCH_CHUNK_SIZE,
-    edgeInsertBatchSize: POSTGRES_EDGE_INSERT_BATCH_SIZE,
-    // Unlike the static siblings, the embedding upsert honors a runtime
-    // `maxBindParameters` override so its chunk size tracks the connection's
-    // actual bind budget.
-    embeddingUpsertBatchSize: Math.max(
-      1,
-      Math.floor(
-        (capabilities.maxBindParameters ?? chunkECU53PMN_cjs.POSTGRES_MAX_BIND_PARAMETERS) / chunkO7XVCLXW_cjs.EMBEDDING_UPSERT_PARAM_COUNT
-      )
-    ),
-    getEdgesChunkSize: POSTGRES_GET_EDGES_ID_CHUNK_SIZE,
-    getNodesChunkSize: POSTGRES_GET_NODES_ID_CHUNK_SIZE,
-    nodeInsertBatchSize: POSTGRES_NODE_INSERT_BATCH_SIZE,
-    uniqueInsertBatchSize: POSTGRES_UNIQUE_INSERT_BATCH_SIZE
-  };
+  const batchConfig = computePostgresBatchChunkSizes(
+    capabilities.maxBindParameters ?? chunkECU53PMN_cjs.POSTGRES_MAX_BIND_PARAMETERS
+  );
   const commonBackend = chunkO7XVCLXW_cjs.createCommonOperationBackend({
     batchConfig,
     execution: {
@@ -1207,7 +1247,7 @@ function createPostgresOperationBackend(options) {
       const timestamp = chunkAQR6BHB3_cjs.nowIso();
       for (const rows of chunkZDH3DX3C_cjs.chunk(
         params.rows,
-        POSTGRES_FULLTEXT_UPSERT_BATCH_SIZE
+        batchConfig.fulltextUpsertBatchSize
       )) {
         const statements = operationStrategy.buildUpsertFulltextBatch(
           { ...params, rows },
@@ -1222,7 +1262,7 @@ function createPostgresOperationBackend(options) {
       if (params.nodeIds.length === 0) return;
       for (const nodeIds of chunkZDH3DX3C_cjs.chunk(
         params.nodeIds,
-        POSTGRES_FULLTEXT_DELETE_CHUNK_SIZE
+        batchConfig.fulltextDeleteChunkSize
       )) {
         const statements = operationStrategy.buildDeleteFulltextBatch({
           ...params,
@@ -1295,5 +1335,5 @@ function createTransactionBackend(options) {
 }
 
 exports.createPostgresBackend = createPostgresBackend;
-//# sourceMappingURL=chunk-7TOT7RKY.cjs.map
-//# sourceMappingURL=chunk-7TOT7RKY.cjs.map
+//# sourceMappingURL=chunk-5ZPRE4CV.cjs.map
+//# sourceMappingURL=chunk-5ZPRE4CV.cjs.map