@relaybus/postgres 0.4.1 → 0.5.0

package/README.md

@@ -91,6 +91,16 @@ released. The other adapters keep only `statement_timeout`, because a server-end
 (the optional executor method `transactionWithBudget`), so the budget costs no extra round trip; executors without it
 send them as the first statement of the transaction.
 
+**Isolation levels.** `bus.transaction(work, { isolationLevel })` opens the transaction at `'read committed'`,
+`'repeatable read'` or `'serializable'`, and at the last two reruns `work` after a serialization failure
+(SQLSTATE `40001`; see the `@relaybus/nestjs` README). `PgExecutor` sends `BEGIN ISOLATION LEVEL ...` in the same round
+trip as the budget settings, so a level costs no statement. The TypeORM adapter uses TypeORM's own `transaction('SERIALIZABLE', ...)` (so the level is set before TypeORM subscribers run). Any other executor gets `SET TRANSACTION ISOLATION LEVEL ...`
+as the first statement of the transaction and the budget statement second (PostgreSQL refuses the level once a query ran,
+and the budget's `set_config` is a query). The store recognizes `40001` through `pg` (also what Kysely and Knex pass
+through), TypeORM's `driverError`, the `cause` of a Drizzle error and Prisma's `P2034`, `meta.code` and driver-adapter
+errors. A custom executor implements the optional `transactionWithIsolation` to send the level with its `BEGIN`, and the
+optional `isSerializationFailure` for an error shape the store does not know.
+
 Where the budget lives depends on who owns the pool:
 
 - **A pool the store created** (`connectionString`/`poolConfig`): each connection keeps the budget as a session setting.

package/dist/chunk-5WWPAN5Q.js

@@ -0,0 +1,26 @@
+import { budgetSettingsSql, budgetValue } from './chunk-UDBN4RRV.js';
+
+// src/adapter-executor.ts
+function adapterExecutor(client) {
+  return {
+    transaction: client.transaction,
+    ...client.transactionAt === void 0 ? {} : {
+      // The level is set by the library at BEGIN, so the budget statement can follow as the first query.
+      transactionWithIsolation: (work, { isolationLevel, timeoutMs }) => client.transactionAt(isolationLevel, async (queryable) => {
+        const sql = budgetSettingsSql({
+          value: "$1",
+          sessionTimeouts: false,
+          scope: "transaction"
+        });
+        await client.run(queryable, { sql, parameters: [budgetValue(timeoutMs)] });
+        return work(queryable);
+      })
+    },
+    // eslint-disable-next-line relaybus/max-two-params -- PostgresExecutor port signature
+    query: (sql, parameters, transaction) => client.run(transaction ?? client.root, { sql, parameters })
+  };
+}
+
+export { adapterExecutor };
+//# sourceMappingURL=chunk-5WWPAN5Q.js.map
+//# sourceMappingURL=chunk-5WWPAN5Q.js.map

package/dist/chunk-5WWPAN5Q.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/adapter-executor.ts"],"names":[],"mappings":";;;AAgCO,SAAS,gBACd,MAAA,EAC8B;AAC9B,EAAA,OAAO;AAAA,IACL,aAAa,MAAA,CAAO,WAAA;AAAA,IACpB,GAAI,MAAA,CAAO,aAAA,KAAkB,MAAA,GACzB,EAAC,GACD;AAAA;AAAA,MAEE,wBAAA,EAA0B,CAAC,IAAA,EAAM,EAAE,cAAA,EAAgB,SAAA,EAAU,KAC3D,MAAA,CAAO,aAAA,CAAe,cAAA,EAAgB,OAAO,SAAA,KAAc;AACzD,QAAA,MAAM,MAAM,iBAAA,CAAkB;AAAA,UAC5B,KAAA,EAAO,IAAA;AAAA,UACP,eAAA,EAAiB,KAAA;AAAA,UACjB,KAAA,EAAO;AAAA,SACR,CAAA;AACD,QAAA,MAAM,MAAA,CAAO,GAAA,CAAI,SAAA,EAAW,EAAE,GAAA,EAAK,UAAA,EAAY,CAAC,WAAA,CAAY,SAAS,CAAC,CAAA,EAAG,CAAA;AACzE,QAAA,OAAO,KAAK,SAAS,CAAA;AAAA,MACvB,CAAC;AAAA,KACL;AAAA;AAAA,IAEJ,KAAA,EAAO,CAAC,GAAA,EAAK,UAAA,EAAY,WAAA,KACvB,MAAA,CAAO,GAAA,CAAI,WAAA,IAAe,MAAA,CAAO,IAAA,EAAM,EAAE,GAAA,EAAK,YAAY;AAAA,GAC9D;AACF","file":"chunk-5WWPAN5Q.js","sourcesContent":["import type { TransactionIsolationLevel } from '@relaybus/core';\nimport type { PostgresExecutor, PostgresParameter, PostgresRow } from './executor.js';\nimport { budgetSettingsSql, budgetValue } from './transaction-timeouts.js';\n\n/** One statement the store sends, with its positional parameters. */\nexport type AdapterStatement = {\n  readonly sql: string;\n  readonly parameters: readonly PostgresParameter[];\n};\n\n/** What an adapter supplies: where statements run outside a transaction, and how it runs one. */\nexport type AdapterClient<TQueryable> = {\n  /** The instance itself: statements outside a transaction run on it. */\n  readonly root: TQueryable;\n  readonly transaction: PostgresExecutor<TQueryable>['transaction'];\n  /**\n   * Optional. Opens a transaction at an isolation level through the library's own API, for a library\n   * that runs code of its own (hooks, subscribers) right after it begins a transaction: that code\n   * would otherwise run a query before the store's `SET TRANSACTION ISOLATION LEVEL`.\n   */\n  readonly transactionAt?: <T>(\n    isolationLevel: TransactionIsolationLevel,\n    work: (queryable: TQueryable) => Promise<T>,\n  ) => Promise<T>;\n  /** Runs one statement on the caller's transaction, else on the root. */\n  readonly run: (queryable: TQueryable, statement: AdapterStatement) => Promise<PostgresRow[]>;\n};\n\n/**\n * The executor every library adapter shares: a statement runs on the transaction it is given,\n * else on the root instance. An adapter supplies only how its library runs one statement.\n */\nexport function adapterExecutor<TQueryable>(\n  client: AdapterClient<TQueryable>,\n): PostgresExecutor<TQueryable> {\n  return {\n    transaction: client.transaction,\n    ...(client.transactionAt === undefined\n      ? {}\n      : {\n          // The level is set by the library at BEGIN, so the budget statement can follow as the first query.\n          transactionWithIsolation: (work, { isolationLevel, timeoutMs }) =>\n            client.transactionAt!(isolationLevel, async (queryable) => {\n              const sql = budgetSettingsSql({\n                value: '$1',\n                sessionTimeouts: false,\n                scope: 'transaction',\n              });\n              await client.run(queryable, { sql, parameters: [budgetValue(timeoutMs)] });\n              return work(queryable);\n            }),\n        }),\n    // eslint-disable-next-line relaybus/max-two-params -- PostgresExecutor port signature\n    query: (sql, parameters, transaction) =>\n      client.run(transaction ?? client.root, { sql, parameters }),\n  };\n}\n"]}

package/dist/chunk-FY65AUUF.js

@@ -0,0 +1,40 @@
+import { budgetSettingsSql, budgetValue } from './chunk-UDBN4RRV.js';
+import { ConfigurationError } from '@relaybus/core';
+
+var ISOLATION_KEYWORDS = {
+  "read committed": "READ COMMITTED",
+  "repeatable read": "REPEATABLE READ",
+  serializable: "SERIALIZABLE"
+};
+function isolationKeywords(isolationLevel) {
+  const keywords = Object.hasOwn(ISOLATION_KEYWORDS, isolationLevel) ? ISOLATION_KEYWORDS[isolationLevel] : void 0;
+  if (keywords === void 0) {
+    throw new ConfigurationError(`Unknown isolation level ${JSON.stringify(isolationLevel)}`);
+  }
+  return keywords;
+}
+function inIsolatedTransaction(state, {
+  work,
+  timeoutMs,
+  isolationLevel
+}) {
+  const { executor } = state;
+  if (executor.transactionWithIsolation !== void 0) {
+    return executor.transactionWithIsolation(work, { isolationLevel, timeoutMs });
+  }
+  const keywords = isolationKeywords(isolationLevel);
+  const budget = budgetSettingsSql({
+    value: "$1",
+    sessionTimeouts: executor.sessionTimeouts === true,
+    scope: "transaction"
+  });
+  return executor.transaction(async (transaction) => {
+    await executor.query(`SET TRANSACTION ISOLATION LEVEL ${keywords}`, [], transaction);
+    await state.query({ sql: budget, parameters: [budgetValue(timeoutMs)], transaction });
+    return work(transaction);
+  });
+}
+
+export { inIsolatedTransaction, isolationKeywords };
+//# sourceMappingURL=chunk-FY65AUUF.js.map
+//# sourceMappingURL=chunk-FY65AUUF.js.map

package/dist/chunk-FY65AUUF.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/transaction-isolation.ts"],"names":[],"mappings":";;;AAKA,IAAM,kBAAA,GAA0E;AAAA,EAC9E,gBAAA,EAAkB,gBAAA;AAAA,EAClB,iBAAA,EAAmB,iBAAA;AAAA,EACnB,YAAA,EAAc;AAChB,CAAA;AAGO,SAAS,kBAAkB,cAAA,EAAmD;AACnF,EAAA,MAAM,QAAA,GAAW,OAAO,MAAA,CAAO,kBAAA,EAAoB,cAAc,CAAA,GAC7D,kBAAA,CAAmB,cAAc,CAAA,GACjC,MAAA;AACJ,EAAA,IAAI,aAAa,MAAA,EAAW;AAC1B,IAAA,MAAM,IAAI,kBAAA,CAAmB,CAAA,wBAAA,EAA2B,KAAK,SAAA,CAAU,cAAc,CAAC,CAAA,CAAE,CAAA;AAAA,EAC1F;AACA,EAAA,OAAO,QAAA;AACT;AAQO,SAAS,sBACd,KAAA,EACA;AAAA,EACE,IAAA;AAAA,EACA,SAAA;AAAA,EACA;AACF,CAAA,EAKY;AACZ,EAAA,MAAM,EAAE,UAAS,GAAI,KAAA;AACrB,EAAA,IAAI,QAAA,CAAS,6BAA6B,MAAA,EAAW;AACnD,IAAA,OAAO,SAAS,wBAAA,CAAyB,IAAA,EAAM,EAAE,cAAA,EAAgB,WAAW,CAAA;AAAA,EAC9E;AACA,EAAA,MAAM,QAAA,GAAW,kBAAkB,cAAc,CAAA;AACjD,EAAA,MAAM,SAAS,iBAAA,CAAkB;AAAA,IAC/B,KAAA,EAAO,IAAA;AAAA,IACP,eAAA,EAAiB,SAAS,eAAA,KAAoB,IAAA;AAAA,IAC9C,KAAA,EAAO;AAAA,GACR,CAAA;AACD,EAAA,OAAO,QAAA,CAAS,WAAA,CAAY,OAAO,WAAA,KAAgB;AACjD,IAAA,MAAM,SAAS,KAAA,CAAM,CAAA,gCAAA,EAAmC,QAAQ,CAAA,CAAA,EAAI,IAAI,WAAW,CAAA;AACnF,IAAA,MAAM,KAAA,CAAM,KAAA,CAAM,EAAE,GAAA,EAAK,MAAA,EAAQ,UAAA,EAAY,CAAC,WAAA,CAAY,SAAS,CAAC,CAAA,EAAG,WAAA,EAAa,CAAA;AACpF,IAAA,OAAO,KAAK,WAAW,CAAA;AAAA,EACzB,CAAC,CAAA;AACH","file":"chunk-FY65AUUF.js","sourcesContent":["import { ConfigurationError, type TransactionIsolationLevel } from '@relaybus/core';\nimport type { PostgresStoreState } from './postgres-store-state.js';\nimport { budgetSettingsSql, budgetValue } from './transaction-timeouts.js';\n\n/** The SQL keywords of each level. Only these literals ever reach SQL text. */\nconst ISOLATION_KEYWORDS: Readonly<Record<TransactionIsolationLevel, string>> = {\n  'read committed': 'READ COMMITTED',\n  'repeatable read': 'REPEATABLE READ',\n  serializable: 'SERIALIZABLE',\n};\n\n/** The keywords of `isolationLevel` as SQL; an unknown level (a store called around the bus) is refused. */\nexport function isolationKeywords(isolationLevel: TransactionIsolationLevel): string {\n  const keywords = Object.hasOwn(ISOLATION_KEYWORDS, isolationLevel)\n    ? ISOLATION_KEYWORDS[isolationLevel]\n    : undefined;\n  if (keywords === undefined) {\n    throw new ConfigurationError(`Unknown isolation level ${JSON.stringify(isolationLevel)}`);\n  }\n  return keywords;\n}\n\n/**\n * Runs `work` in a transaction at `isolationLevel` that the server holds to `timeoutMs`. An executor\n * with `transactionWithIsolation` (`PgExecutor`) sends both with its `BEGIN`; any other executor gets\n * `SET TRANSACTION ISOLATION LEVEL` as the first statement of the transaction and the budget as the\n * second: PostgreSQL refuses the level once a query ran, and the budget's `set_config` is a query.\n */\nexport function inIsolatedTransaction<TTransaction, T>(\n  state: PostgresStoreState<TTransaction>,\n  {\n    work,\n    timeoutMs,\n    isolationLevel,\n  }: {\n    readonly work: (transaction: TTransaction) => Promise<T>;\n    readonly timeoutMs: number;\n    readonly isolationLevel: TransactionIsolationLevel;\n  },\n): Promise<T> {\n  const { executor } = state;\n  if (executor.transactionWithIsolation !== undefined) {\n    return executor.transactionWithIsolation(work, { isolationLevel, timeoutMs });\n  }\n  const keywords = isolationKeywords(isolationLevel);\n  const budget = budgetSettingsSql({\n    value: '$1',\n    sessionTimeouts: executor.sessionTimeouts === true,\n    scope: 'transaction',\n  });\n  return executor.transaction(async (transaction) => {\n    await executor.query(`SET TRANSACTION ISOLATION LEVEL ${keywords}`, [], transaction);\n    await state.query({ sql: budget, parameters: [budgetValue(timeoutMs)], transaction });\n    return work(transaction);\n  });\n}\n"]}

package/dist/chunk-UDBN4RRV.js

@@ -0,0 +1,35 @@
+// src/transaction-timeouts.ts
+function budgetSettingsSql({ value, sessionTimeouts, scope }) {
+  const local = scope === "transaction";
+  const statementTimeout = `SELECT set_config('statement_timeout', ${value}, ${local})`;
+  if (!sessionTimeouts) {
+    return statementTimeout;
+  }
+  return `${statementTimeout}, set_config('idle_in_transaction_session_timeout', ${value}, ${local}), CASE WHEN current_setting('server_version_num')::int >= 170000 THEN set_config('transaction_timeout', ${value}, ${local}) END`;
+}
+var SESSION_DEFAULTS_SQL = "SELECT set_config(name, reset_val, false) FROM pg_settings WHERE name IN ('statement_timeout', 'idle_in_transaction_session_timeout', 'transaction_timeout')";
+function budgetValue(timeoutMs) {
+  return `${Math.ceil(timeoutMs)}ms`;
+}
+function inBudgetedTransaction(state, {
+  work,
+  timeoutMs
+}) {
+  const { executor } = state;
+  if (executor.transactionWithBudget !== void 0) {
+    return executor.transactionWithBudget(work, timeoutMs);
+  }
+  const sql = budgetSettingsSql({
+    value: "$1",
+    sessionTimeouts: executor.sessionTimeouts === true,
+    scope: "transaction"
+  });
+  return executor.transaction(async (transaction) => {
+    await state.query({ sql, parameters: [budgetValue(timeoutMs)], transaction });
+    return work(transaction);
+  });
+}
+
+export { SESSION_DEFAULTS_SQL, budgetSettingsSql, budgetValue, inBudgetedTransaction };
+//# sourceMappingURL=chunk-UDBN4RRV.js.map
+//# sourceMappingURL=chunk-UDBN4RRV.js.map

package/dist/chunk-UDBN4RRV.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/transaction-timeouts.ts"],"names":[],"mappings":";AAiBO,SAAS,iBAAA,CAAkB,EAAE,KAAA,EAAO,eAAA,EAAiB,OAAM,EAA2B;AAC3F,EAAA,MAAM,QAAQ,KAAA,KAAU,aAAA;AACxB,EAAA,MAAM,gBAAA,GAAmB,CAAA,uCAAA,EAA0C,KAAK,CAAA,EAAA,EAAK,KAAK,CAAA,CAAA,CAAA;AAClF,EAAA,IAAI,CAAC,eAAA,EAAiB;AACpB,IAAA,OAAO,gBAAA;AAAA,EACT;AACA,EAAA,OACE,CAAA,EAAG,gBAAgB,CAAA,oDAAA,EAAuD,KAAK,KAAK,KAAK,CAAA,yGAAA,EAE/C,KAAK,CAAA,EAAA,EAAK,KAAK,CAAA,KAAA,CAAA;AAE7D;AAGO,IAAM,oBAAA,GACX;AAIK,SAAS,YAAY,SAAA,EAA2B;AACrD,EAAA,OAAO,CAAA,EAAG,IAAA,CAAK,IAAA,CAAK,SAAS,CAAC,CAAA,EAAA,CAAA;AAChC;AAOO,SAAS,sBACd,KAAA,EACA;AAAA,EACE,IAAA;AAAA,EACA;AACF,CAAA,EAIY;AACZ,EAAA,MAAM,EAAE,UAAS,GAAI,KAAA;AACrB,EAAA,IAAI,QAAA,CAAS,0BAA0B,MAAA,EAAW;AAChD,IAAA,OAAO,QAAA,CAAS,qBAAA,CAAsB,IAAA,EAAM,SAAS,CAAA;AAAA,EACvD;AACA,EAAA,MAAM,MAAM,iBAAA,CAAkB;AAAA,IAC5B,KAAA,EAAO,IAAA;AAAA,IACP,eAAA,EAAiB,SAAS,eAAA,KAAoB,IAAA;AAAA,IAC9C,KAAA,EAAO;AAAA,GACR,CAAA;AACD,EAAA,OAAO,QAAA,CAAS,WAAA,CAAY,OAAO,WAAA,KAAgB;AACjD,IAAA,MAAM,KAAA,CAAM,KAAA,CAAM,EAAE,GAAA,EAAK,UAAA,EAAY,CAAC,WAAA,CAAY,SAAS,CAAC,CAAA,EAAG,WAAA,EAAa,CAAA;AAC5E,IAAA,OAAO,KAAK,WAAW,CAAA;AAAA,EACzB,CAAC,CAAA;AACH","file":"chunk-UDBN4RRV.js","sourcesContent":["import type { PostgresStoreState } from './postgres-store-state.js';\n\n/** What {@link budgetSettingsSql} sets and how long the settings last. */\nexport type BudgetSettings = {\n  /** The value as SQL: a parameter (`$1`) or a quoted literal (`'5000ms'`). */\n  readonly value: string;\n  /**\n   * Also `idle_in_transaction_session_timeout` and, on PostgreSQL 17+, `transaction_timeout`: the\n   * server then ends the session of an overrun, so only executors that survive that get them\n   * ({@link PostgresExecutor.sessionTimeouts}).\n   */\n  readonly sessionTimeouts: boolean;\n  /** `transaction`: `SET LOCAL` semantics, gone with the transaction. `session`: kept by the connection. */\n  readonly scope: 'transaction' | 'session';\n};\n\n/** The statement that holds a transaction to a time budget: `statement_timeout` and, see {@link BudgetSettings}, more. */\nexport function budgetSettingsSql({ value, sessionTimeouts, scope }: BudgetSettings): string {\n  const local = scope === 'transaction';\n  const statementTimeout = `SELECT set_config('statement_timeout', ${value}, ${local})`;\n  if (!sessionTimeouts) {\n    return statementTimeout;\n  }\n  return (\n    `${statementTimeout}, set_config('idle_in_transaction_session_timeout', ${value}, ${local}), ` +\n    \"CASE WHEN current_setting('server_version_num')::int >= 170000 \" +\n    `THEN set_config('transaction_timeout', ${value}, ${local}) END`\n  );\n}\n\n/** Puts the settings {@link budgetSettingsSql} keeps at session level back to the defaults of the session. */\nexport const SESSION_DEFAULTS_SQL =\n  'SELECT set_config(name, reset_val, false) FROM pg_settings ' +\n  \"WHERE name IN ('statement_timeout', 'idle_in_transaction_session_timeout', 'transaction_timeout')\";\n\n/** The budget as a setting value: whole milliseconds, so nothing but digits reaches SQL text. */\nexport function budgetValue(timeoutMs: number): string {\n  return `${Math.ceil(timeoutMs)}ms`;\n}\n\n/**\n * Runs `work` in a transaction of `state`'s executor that the server holds to `timeoutMs`. An executor\n * with `transactionWithBudget` (`PgExecutor`) sets the budget in the round trip of its `BEGIN`; any\n * other executor runs it with `SET LOCAL` semantics as the first statement of the transaction.\n */\nexport function inBudgetedTransaction<TTransaction, T>(\n  state: PostgresStoreState<TTransaction>,\n  {\n    work,\n    timeoutMs,\n  }: {\n    readonly work: (transaction: TTransaction) => Promise<T>;\n    readonly timeoutMs: number;\n  },\n): Promise<T> {\n  const { executor } = state;\n  if (executor.transactionWithBudget !== undefined) {\n    return executor.transactionWithBudget(work, timeoutMs);\n  }\n  const sql = budgetSettingsSql({\n    value: '$1',\n    sessionTimeouts: executor.sessionTimeouts === true,\n    scope: 'transaction',\n  });\n  return executor.transaction(async (transaction) => {\n    await state.query({ sql, parameters: [budgetValue(timeoutMs)], transaction });\n    return work(transaction);\n  });\n}\n"]}

package/dist/drizzle.cjs

@@ -2,10 +2,34 @@
 
 var drizzleOrm = require('drizzle-orm');
 
+// src/transaction-timeouts.ts
+function budgetSettingsSql({ value, sessionTimeouts, scope }) {
+  const local = scope === "transaction";
+  const statementTimeout = `SELECT set_config('statement_timeout', ${value}, ${local})`;
+  {
+    return statementTimeout;
+  }
+}
+function budgetValue(timeoutMs) {
+  return `${Math.ceil(timeoutMs)}ms`;
+}
+
 // src/adapter-executor.ts
 function adapterExecutor(client) {
   return {
     transaction: client.transaction,
+    ...client.transactionAt === void 0 ? {} : {
+      // The level is set by the library at BEGIN, so the budget statement can follow as the first query.
+      transactionWithIsolation: (work, { isolationLevel, timeoutMs }) => client.transactionAt(isolationLevel, async (queryable) => {
+        const sql = budgetSettingsSql({
+          value: "$1",
+          sessionTimeouts: false,
+          scope: "transaction"
+        });
+        await client.run(queryable, { sql, parameters: [budgetValue(timeoutMs)] });
+        return work(queryable);
+      })
+    },
     // eslint-disable-next-line relaybus/max-two-params -- PostgresExecutor port signature
     query: (sql, parameters, transaction) => client.run(transaction ?? client.root, { sql, parameters })
   };

package/dist/drizzle.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/adapter-executor.ts","../src/positional-sql.ts","../src/drizzle/drizzle-executor.ts"],"names":["drizzleSql"],"mappings":";;;;;AAqBO,SAAS,gBACd,MAAA,EAC8B;AAC9B,EAAA,OAAO;AAAA,IACL,aAAa,MAAA,CAAO,WAAA;AAAA;AAAA,IAEpB,KAAA,EAAO,CAAC,GAAA,EAAK,UAAA,EAAY,WAAA,KACvB,MAAA,CAAO,GAAA,CAAI,WAAA,IAAe,MAAA,CAAO,IAAA,EAAM,EAAE,GAAA,EAAK,YAAY;AAAA,GAC9D;AACF;;;ACrBO,SAAS,mBAAmB,GAAA,EAAkC;AACnE,EAAA,MAAM,QAA6B,EAAC;AACpC,EAAA,IAAI,SAAA,GAAY,CAAA;AAChB,EAAA,KAAA,MAAW,KAAA,IAAS,GAAA,CAAI,QAAA,CAAS,UAAU,CAAA,EAAG;AAC5C,IAAA,KAAA,CAAM,IAAA,CAAK,GAAA,CAAI,KAAA,CAAM,SAAA,EAAW,MAAM,KAAK,CAAA,EAAG,EAAE,cAAA,EAAgB,OAAO,KAAA,CAAM,CAAC,CAAC,CAAA,GAAI,GAAG,CAAA;AACtF,IAAA,SAAA,GAAY,KAAA,CAAM,KAAA,GAAQ,KAAA,CAAM,CAAC,CAAA,CAAE,MAAA;AAAA,EACrC;AACA,EAAA,KAAA,CAAM,IAAA,CAAK,GAAA,CAAI,KAAA,CAAM,SAAS,CAAC,CAAA;AAC/B,EAAA,OAAO,KAAA;AACT;;;ACCO,SAAS,sBAAsB,QAAA,EAA2D;AAC/F,EAAA,OAAO,eAAA,CAAkC;AAAA,IACvC,IAAA,EAAM,QAAA;AAAA,IACN,WAAA,EAAa,CAAC,IAAA,KAAS,QAAA,CAAS,YAAY,IAAI,CAAA;AAAA,IAChD,MAAM,GAAA,CAAI,SAAA,EAAW,EAAE,GAAA,EAAK,YAAW,EAAG;AACxC,MAAA,MAAM,MAAA,GAAS,kBAAA,CAAmB,GAAG,CAAA,CAAE,GAAA;AAAA,QAAI,CAAC,IAAA,KAC1C,OAAO,IAAA,KAAS,WACZA,cAAA,CAAW,GAAA,CAAI,IAAI,CAAA,GACnBA,cAAA,CAAW,KAAA,CAAM,UAAA,CAAW,IAAA,CAAK,cAAc,CAAC;AAAA,OACtD;AACA,MAAA,MAAM,SAAS,MAAM,SAAA,CAAU,QAAQA,cAAA,CAAW,IAAA,CAAK,MAAM,CAAC,CAAA;AAC9D,MAAA,OAAO,MAAA,CAAO,IAAA;AAAA,IAChB;AAAA,GACD,CAAA;AACH","file":"drizzle.cjs","sourcesContent":["import type { PostgresExecutor, PostgresParameter, PostgresRow } from './executor.js';\n\n/** One statement the store sends, with its positional parameters. */\nexport type AdapterStatement = {\n  readonly sql: string;\n  readonly parameters: readonly PostgresParameter[];\n};\n\n/** What an adapter supplies: where statements run outside a transaction, and how it runs one. */\nexport type AdapterClient<TQueryable> = {\n  /** The instance itself: statements outside a transaction run on it. */\n  readonly root: TQueryable;\n  readonly transaction: PostgresExecutor<TQueryable>['transaction'];\n  /** Runs one statement on the caller's transaction, else on the root. */\n  readonly run: (queryable: TQueryable, statement: AdapterStatement) => Promise<PostgresRow[]>;\n};\n\n/**\n * The executor every library adapter shares: a statement runs on the transaction it is given,\n * else on the root instance. An adapter supplies only how its library runs one statement.\n */\nexport function adapterExecutor<TQueryable>(\n  client: AdapterClient<TQueryable>,\n): PostgresExecutor<TQueryable> {\n  return {\n    transaction: client.transaction,\n    // eslint-disable-next-line relaybus/max-two-params -- PostgresExecutor port signature\n    query: (sql, parameters, transaction) =>\n      client.run(transaction ?? client.root, { sql, parameters }),\n  };\n}\n","/** A piece of SQL text, or a reference to the (zero-based) parameter that stands at this position. */\nexport type PositionalSqlPart = string | { readonly parameterIndex: number };\n\n/**\n * Splits SQL written with PostgreSQL `$1, $2, ...` placeholders into text and\n * parameter references, in order of appearance. A placeholder used twice\n * appears twice. Adapters for libraries with their own placeholder syntax\n * (Knex `?`, Drizzle parameter chunks) rebuild the statement from the parts.\n */\nexport function splitPositionalSql(sql: string): PositionalSqlPart[] {\n  const parts: PositionalSqlPart[] = [];\n  let textStart = 0;\n  for (const match of sql.matchAll(/\\$(\\d+)/g)) {\n    parts.push(sql.slice(textStart, match.index), { parameterIndex: Number(match[1]) - 1 });\n    textStart = match.index + match[0].length;\n  }\n  parts.push(sql.slice(textStart));\n  return parts;\n}\n","import { adapterExecutor } from '../adapter-executor.js';\nimport { sql as drizzleSql, type SQL } from 'drizzle-orm';\nimport type { PostgresExecutor } from '../executor.js';\nimport { splitPositionalSql } from '../positional-sql.js';\n\n/** What a Drizzle database and a Drizzle transaction have in common. */\nexport interface DrizzleQueryable {\n  execute(query: SQL): PromiseLike<{ readonly rows: Record<string, unknown>[] }>;\n}\n\n/** The part of a Drizzle `node-postgres` database the executor uses. */\nexport interface DrizzleLike extends DrizzleQueryable {\n  transaction<T>(work: (transaction: DrizzleQueryable) => Promise<T>): Promise<T>;\n}\n\n/**\n * Executor for Drizzle with the `node-postgres` driver. The transaction handle\n * is a Drizzle transaction: pass `tx` from `db.transaction(async (tx) => ...)`.\n */\nexport function createDrizzleExecutor(database: DrizzleLike): PostgresExecutor<DrizzleQueryable> {\n  return adapterExecutor<DrizzleQueryable>({\n    root: database,\n    transaction: (work) => database.transaction(work),\n    async run(queryable, { sql, parameters }) {\n      const chunks = splitPositionalSql(sql).map((part) =>\n        typeof part === 'string'\n          ? drizzleSql.raw(part)\n          : drizzleSql.param(parameters[part.parameterIndex]),\n      );\n      const result = await queryable.execute(drizzleSql.join(chunks));\n      return result.rows;\n    },\n  });\n}\n"]}
+{"version":3,"sources":["../src/transaction-timeouts.ts","../src/adapter-executor.ts","../src/positional-sql.ts","../src/drizzle/drizzle-executor.ts"],"names":["drizzleSql"],"mappings":";;;;;AAiBO,SAAS,iBAAA,CAAkB,EAAE,KAAA,EAAO,eAAA,EAAiB,OAAM,EAA2B;AAC3F,EAAA,MAAM,QAAQ,KAAA,KAAU,aAAA;AACxB,EAAA,MAAM,gBAAA,GAAmB,CAAA,uCAAA,EAA0C,KAAK,CAAA,EAAA,EAAK,KAAK,CAAA,CAAA,CAAA;AAClF,EAAsB;AACpB,IAAA,OAAO,gBAAA;AAAA,EACT;AAMF;AAQO,SAAS,YAAY,SAAA,EAA2B;AACrD,EAAA,OAAO,CAAA,EAAG,IAAA,CAAK,IAAA,CAAK,SAAS,CAAC,CAAA,EAAA,CAAA;AAChC;;;ACNO,SAAS,gBACd,MAAA,EAC8B;AAC9B,EAAA,OAAO;AAAA,IACL,aAAa,MAAA,CAAO,WAAA;AAAA,IACpB,GAAI,MAAA,CAAO,aAAA,KAAkB,MAAA,GACzB,EAAC,GACD;AAAA;AAAA,MAEE,wBAAA,EAA0B,CAAC,IAAA,EAAM,EAAE,cAAA,EAAgB,SAAA,EAAU,KAC3D,MAAA,CAAO,aAAA,CAAe,cAAA,EAAgB,OAAO,SAAA,KAAc;AACzD,QAAA,MAAM,MAAM,iBAAA,CAAkB;AAAA,UAC5B,KAAA,EAAO,IAAA;AAAA,UACP,eAAA,EAAiB,KAAA;AAAA,UACjB,KAAA,EAAO;AAAA,SACR,CAAA;AACD,QAAA,MAAM,MAAA,CAAO,GAAA,CAAI,SAAA,EAAW,EAAE,GAAA,EAAK,UAAA,EAAY,CAAC,WAAA,CAAY,SAAS,CAAC,CAAA,EAAG,CAAA;AACzE,QAAA,OAAO,KAAK,SAAS,CAAA;AAAA,MACvB,CAAC;AAAA,KACL;AAAA;AAAA,IAEJ,KAAA,EAAO,CAAC,GAAA,EAAK,UAAA,EAAY,WAAA,KACvB,MAAA,CAAO,GAAA,CAAI,WAAA,IAAe,MAAA,CAAO,IAAA,EAAM,EAAE,GAAA,EAAK,YAAY;AAAA,GAC9D;AACF;;;AC/CO,SAAS,mBAAmB,GAAA,EAAkC;AACnE,EAAA,MAAM,QAA6B,EAAC;AACpC,EAAA,IAAI,SAAA,GAAY,CAAA;AAChB,EAAA,KAAA,MAAW,KAAA,IAAS,GAAA,CAAI,QAAA,CAAS,UAAU,CAAA,EAAG;AAC5C,IAAA,KAAA,CAAM,IAAA,CAAK,GAAA,CAAI,KAAA,CAAM,SAAA,EAAW,MAAM,KAAK,CAAA,EAAG,EAAE,cAAA,EAAgB,OAAO,KAAA,CAAM,CAAC,CAAC,CAAA,GAAI,GAAG,CAAA;AACtF,IAAA,SAAA,GAAY,KAAA,CAAM,KAAA,GAAQ,KAAA,CAAM,CAAC,CAAA,CAAE,MAAA;AAAA,EACrC;AACA,EAAA,KAAA,CAAM,IAAA,CAAK,GAAA,CAAI,KAAA,CAAM,SAAS,CAAC,CAAA;AAC/B,EAAA,OAAO,KAAA;AACT;;;ACCO,SAAS,sBAAsB,QAAA,EAA2D;AAC/F,EAAA,OAAO,eAAA,CAAkC;AAAA,IACvC,IAAA,EAAM,QAAA;AAAA,IACN,WAAA,EAAa,CAAC,IAAA,KAAS,QAAA,CAAS,YAAY,IAAI,CAAA;AAAA,IAChD,MAAM,GAAA,CAAI,SAAA,EAAW,EAAE,GAAA,EAAK,YAAW,EAAG;AACxC,MAAA,MAAM,MAAA,GAAS,kBAAA,CAAmB,GAAG,CAAA,CAAE,GAAA;AAAA,QAAI,CAAC,IAAA,KAC1C,OAAO,IAAA,KAAS,WACZA,cAAA,CAAW,GAAA,CAAI,IAAI,CAAA,GACnBA,cAAA,CAAW,KAAA,CAAM,UAAA,CAAW,IAAA,CAAK,cAAc,CAAC;AAAA,OACtD;AACA,MAAA,MAAM,SAAS,MAAM,SAAA,CAAU,QAAQA,cAAA,CAAW,IAAA,CAAK,MAAM,CAAC,CAAA;AAC9D,MAAA,OAAO,MAAA,CAAO,IAAA;AAAA,IAChB;AAAA,GACD,CAAA;AACH","file":"drizzle.cjs","sourcesContent":["import type { PostgresStoreState } from './postgres-store-state.js';\n\n/** What {@link budgetSettingsSql} sets and how long the settings last. */\nexport type BudgetSettings = {\n  /** The value as SQL: a parameter (`$1`) or a quoted literal (`'5000ms'`). */\n  readonly value: string;\n  /**\n   * Also `idle_in_transaction_session_timeout` and, on PostgreSQL 17+, `transaction_timeout`: the\n   * server then ends the session of an overrun, so only executors that survive that get them\n   * ({@link PostgresExecutor.sessionTimeouts}).\n   */\n  readonly sessionTimeouts: boolean;\n  /** `transaction`: `SET LOCAL` semantics, gone with the transaction. `session`: kept by the connection. */\n  readonly scope: 'transaction' | 'session';\n};\n\n/** The statement that holds a transaction to a time budget: `statement_timeout` and, see {@link BudgetSettings}, more. */\nexport function budgetSettingsSql({ value, sessionTimeouts, scope }: BudgetSettings): string {\n  const local = scope === 'transaction';\n  const statementTimeout = `SELECT set_config('statement_timeout', ${value}, ${local})`;\n  if (!sessionTimeouts) {\n    return statementTimeout;\n  }\n  return (\n    `${statementTimeout}, set_config('idle_in_transaction_session_timeout', ${value}, ${local}), ` +\n    \"CASE WHEN current_setting('server_version_num')::int >= 170000 \" +\n    `THEN set_config('transaction_timeout', ${value}, ${local}) END`\n  );\n}\n\n/** Puts the settings {@link budgetSettingsSql} keeps at session level back to the defaults of the session. */\nexport const SESSION_DEFAULTS_SQL =\n  'SELECT set_config(name, reset_val, false) FROM pg_settings ' +\n  \"WHERE name IN ('statement_timeout', 'idle_in_transaction_session_timeout', 'transaction_timeout')\";\n\n/** The budget as a setting value: whole milliseconds, so nothing but digits reaches SQL text. */\nexport function budgetValue(timeoutMs: number): string {\n  return `${Math.ceil(timeoutMs)}ms`;\n}\n\n/**\n * Runs `work` in a transaction of `state`'s executor that the server holds to `timeoutMs`. An executor\n * with `transactionWithBudget` (`PgExecutor`) sets the budget in the round trip of its `BEGIN`; any\n * other executor runs it with `SET LOCAL` semantics as the first statement of the transaction.\n */\nexport function inBudgetedTransaction<TTransaction, T>(\n  state: PostgresStoreState<TTransaction>,\n  {\n    work,\n    timeoutMs,\n  }: {\n    readonly work: (transaction: TTransaction) => Promise<T>;\n    readonly timeoutMs: number;\n  },\n): Promise<T> {\n  const { executor } = state;\n  if (executor.transactionWithBudget !== undefined) {\n    return executor.transactionWithBudget(work, timeoutMs);\n  }\n  const sql = budgetSettingsSql({\n    value: '$1',\n    sessionTimeouts: executor.sessionTimeouts === true,\n    scope: 'transaction',\n  });\n  return executor.transaction(async (transaction) => {\n    await state.query({ sql, parameters: [budgetValue(timeoutMs)], transaction });\n    return work(transaction);\n  });\n}\n","import type { TransactionIsolationLevel } from '@relaybus/core';\nimport type { PostgresExecutor, PostgresParameter, PostgresRow } from './executor.js';\nimport { budgetSettingsSql, budgetValue } from './transaction-timeouts.js';\n\n/** One statement the store sends, with its positional parameters. */\nexport type AdapterStatement = {\n  readonly sql: string;\n  readonly parameters: readonly PostgresParameter[];\n};\n\n/** What an adapter supplies: where statements run outside a transaction, and how it runs one. */\nexport type AdapterClient<TQueryable> = {\n  /** The instance itself: statements outside a transaction run on it. */\n  readonly root: TQueryable;\n  readonly transaction: PostgresExecutor<TQueryable>['transaction'];\n  /**\n   * Optional. Opens a transaction at an isolation level through the library's own API, for a library\n   * that runs code of its own (hooks, subscribers) right after it begins a transaction: that code\n   * would otherwise run a query before the store's `SET TRANSACTION ISOLATION LEVEL`.\n   */\n  readonly transactionAt?: <T>(\n    isolationLevel: TransactionIsolationLevel,\n    work: (queryable: TQueryable) => Promise<T>,\n  ) => Promise<T>;\n  /** Runs one statement on the caller's transaction, else on the root. */\n  readonly run: (queryable: TQueryable, statement: AdapterStatement) => Promise<PostgresRow[]>;\n};\n\n/**\n * The executor every library adapter shares: a statement runs on the transaction it is given,\n * else on the root instance. An adapter supplies only how its library runs one statement.\n */\nexport function adapterExecutor<TQueryable>(\n  client: AdapterClient<TQueryable>,\n): PostgresExecutor<TQueryable> {\n  return {\n    transaction: client.transaction,\n    ...(client.transactionAt === undefined\n      ? {}\n      : {\n          // The level is set by the library at BEGIN, so the budget statement can follow as the first query.\n          transactionWithIsolation: (work, { isolationLevel, timeoutMs }) =>\n            client.transactionAt!(isolationLevel, async (queryable) => {\n              const sql = budgetSettingsSql({\n                value: '$1',\n                sessionTimeouts: false,\n                scope: 'transaction',\n              });\n              await client.run(queryable, { sql, parameters: [budgetValue(timeoutMs)] });\n              return work(queryable);\n            }),\n        }),\n    // eslint-disable-next-line relaybus/max-two-params -- PostgresExecutor port signature\n    query: (sql, parameters, transaction) =>\n      client.run(transaction ?? client.root, { sql, parameters }),\n  };\n}\n","/** A piece of SQL text, or a reference to the (zero-based) parameter that stands at this position. */\nexport type PositionalSqlPart = string | { readonly parameterIndex: number };\n\n/**\n * Splits SQL written with PostgreSQL `$1, $2, ...` placeholders into text and\n * parameter references, in order of appearance. A placeholder used twice\n * appears twice. Adapters for libraries with their own placeholder syntax\n * (Knex `?`, Drizzle parameter chunks) rebuild the statement from the parts.\n */\nexport function splitPositionalSql(sql: string): PositionalSqlPart[] {\n  const parts: PositionalSqlPart[] = [];\n  let textStart = 0;\n  for (const match of sql.matchAll(/\\$(\\d+)/g)) {\n    parts.push(sql.slice(textStart, match.index), { parameterIndex: Number(match[1]) - 1 });\n    textStart = match.index + match[0].length;\n  }\n  parts.push(sql.slice(textStart));\n  return parts;\n}\n","import { adapterExecutor } from '../adapter-executor.js';\nimport { sql as drizzleSql, type SQL } from 'drizzle-orm';\nimport type { PostgresExecutor } from '../executor.js';\nimport { splitPositionalSql } from '../positional-sql.js';\n\n/** What a Drizzle database and a Drizzle transaction have in common. */\nexport interface DrizzleQueryable {\n  execute(query: SQL): PromiseLike<{ readonly rows: Record<string, unknown>[] }>;\n}\n\n/** The part of a Drizzle `node-postgres` database the executor uses. */\nexport interface DrizzleLike extends DrizzleQueryable {\n  transaction<T>(work: (transaction: DrizzleQueryable) => Promise<T>): Promise<T>;\n}\n\n/**\n * Executor for Drizzle with the `node-postgres` driver. The transaction handle\n * is a Drizzle transaction: pass `tx` from `db.transaction(async (tx) => ...)`.\n */\nexport function createDrizzleExecutor(database: DrizzleLike): PostgresExecutor<DrizzleQueryable> {\n  return adapterExecutor<DrizzleQueryable>({\n    root: database,\n    transaction: (work) => database.transaction(work),\n    async run(queryable, { sql, parameters }) {\n      const chunks = splitPositionalSql(sql).map((part) =>\n        typeof part === 'string'\n          ? drizzleSql.raw(part)\n          : drizzleSql.param(parameters[part.parameterIndex]),\n      );\n      const result = await queryable.execute(drizzleSql.join(chunks));\n      return result.rows;\n    },\n  });\n}\n"]}

package/dist/drizzle.d.cts

@@ -1,5 +1,6 @@
 import { SQL } from 'drizzle-orm';
 import { PostgresExecutor } from './index.cjs';
+import '@relaybus/core';
 
 /** What a Drizzle database and a Drizzle transaction have in common. */
 interface DrizzleQueryable {

package/dist/drizzle.d.ts

@@ -1,5 +1,6 @@
 import { SQL } from 'drizzle-orm';
 import { PostgresExecutor } from './index.js';
+import '@relaybus/core';
 
 /** What a Drizzle database and a Drizzle transaction have in common. */
 interface DrizzleQueryable {

package/dist/drizzle.js

@@ -1,5 +1,6 @@
 import { splitPositionalSql } from './chunk-UUFSUL2M.js';
-import { adapterExecutor } from './chunk-NNZJR5AB.js';
+import { adapterExecutor } from './chunk-5WWPAN5Q.js';
+import './chunk-UDBN4RRV.js';
 import { sql } from 'drizzle-orm';
 
 function createDrizzleExecutor(database) {

package/dist/drizzle.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/drizzle/drizzle-executor.ts"],"names":["sql","drizzleSql"],"mappings":";;;;AAmBO,SAAS,sBAAsB,QAAA,EAA2D;AAC/F,EAAA,OAAO,eAAA,CAAkC;AAAA,IACvC,IAAA,EAAM,QAAA;AAAA,IACN,WAAA,EAAa,CAAC,IAAA,KAAS,QAAA,CAAS,YAAY,IAAI,CAAA;AAAA,IAChD,MAAM,GAAA,CAAI,SAAA,EAAW,OAAEA,KAAA,EAAK,YAAW,EAAG;AACxC,MAAA,MAAM,MAAA,GAAS,kBAAA,CAAmBA,KAAG,CAAA,CAAE,GAAA;AAAA,QAAI,CAAC,IAAA,KAC1C,OAAO,IAAA,KAAS,WACZC,GAAA,CAAW,GAAA,CAAI,IAAI,CAAA,GACnBA,GAAA,CAAW,KAAA,CAAM,UAAA,CAAW,IAAA,CAAK,cAAc,CAAC;AAAA,OACtD;AACA,MAAA,MAAM,SAAS,MAAM,SAAA,CAAU,QAAQA,GAAA,CAAW,IAAA,CAAK,MAAM,CAAC,CAAA;AAC9D,MAAA,OAAO,MAAA,CAAO,IAAA;AAAA,IAChB;AAAA,GACD,CAAA;AACH","file":"drizzle.js","sourcesContent":["import { adapterExecutor } from '../adapter-executor.js';\nimport { sql as drizzleSql, type SQL } from 'drizzle-orm';\nimport type { PostgresExecutor } from '../executor.js';\nimport { splitPositionalSql } from '../positional-sql.js';\n\n/** What a Drizzle database and a Drizzle transaction have in common. */\nexport interface DrizzleQueryable {\n  execute(query: SQL): PromiseLike<{ readonly rows: Record<string, unknown>[] }>;\n}\n\n/** The part of a Drizzle `node-postgres` database the executor uses. */\nexport interface DrizzleLike extends DrizzleQueryable {\n  transaction<T>(work: (transaction: DrizzleQueryable) => Promise<T>): Promise<T>;\n}\n\n/**\n * Executor for Drizzle with the `node-postgres` driver. The transaction handle\n * is a Drizzle transaction: pass `tx` from `db.transaction(async (tx) => ...)`.\n */\nexport function createDrizzleExecutor(database: DrizzleLike): PostgresExecutor<DrizzleQueryable> {\n  return adapterExecutor<DrizzleQueryable>({\n    root: database,\n    transaction: (work) => database.transaction(work),\n    async run(queryable, { sql, parameters }) {\n      const chunks = splitPositionalSql(sql).map((part) =>\n        typeof part === 'string'\n          ? drizzleSql.raw(part)\n          : drizzleSql.param(parameters[part.parameterIndex]),\n      );\n      const result = await queryable.execute(drizzleSql.join(chunks));\n      return result.rows;\n    },\n  });\n}\n"]}
+{"version":3,"sources":["../src/drizzle/drizzle-executor.ts"],"names":["sql","drizzleSql"],"mappings":";;;;;AAmBO,SAAS,sBAAsB,QAAA,EAA2D;AAC/F,EAAA,OAAO,eAAA,CAAkC;AAAA,IACvC,IAAA,EAAM,QAAA;AAAA,IACN,WAAA,EAAa,CAAC,IAAA,KAAS,QAAA,CAAS,YAAY,IAAI,CAAA;AAAA,IAChD,MAAM,GAAA,CAAI,SAAA,EAAW,OAAEA,KAAA,EAAK,YAAW,EAAG;AACxC,MAAA,MAAM,MAAA,GAAS,kBAAA,CAAmBA,KAAG,CAAA,CAAE,GAAA;AAAA,QAAI,CAAC,IAAA,KAC1C,OAAO,IAAA,KAAS,WACZC,GAAA,CAAW,GAAA,CAAI,IAAI,CAAA,GACnBA,GAAA,CAAW,KAAA,CAAM,UAAA,CAAW,IAAA,CAAK,cAAc,CAAC;AAAA,OACtD;AACA,MAAA,MAAM,SAAS,MAAM,SAAA,CAAU,QAAQA,GAAA,CAAW,IAAA,CAAK,MAAM,CAAC,CAAA;AAC9D,MAAA,OAAO,MAAA,CAAO,IAAA;AAAA,IAChB;AAAA,GACD,CAAA;AACH","file":"drizzle.js","sourcesContent":["import { adapterExecutor } from '../adapter-executor.js';\nimport { sql as drizzleSql, type SQL } from 'drizzle-orm';\nimport type { PostgresExecutor } from '../executor.js';\nimport { splitPositionalSql } from '../positional-sql.js';\n\n/** What a Drizzle database and a Drizzle transaction have in common. */\nexport interface DrizzleQueryable {\n  execute(query: SQL): PromiseLike<{ readonly rows: Record<string, unknown>[] }>;\n}\n\n/** The part of a Drizzle `node-postgres` database the executor uses. */\nexport interface DrizzleLike extends DrizzleQueryable {\n  transaction<T>(work: (transaction: DrizzleQueryable) => Promise<T>): Promise<T>;\n}\n\n/**\n * Executor for Drizzle with the `node-postgres` driver. The transaction handle\n * is a Drizzle transaction: pass `tx` from `db.transaction(async (tx) => ...)`.\n */\nexport function createDrizzleExecutor(database: DrizzleLike): PostgresExecutor<DrizzleQueryable> {\n  return adapterExecutor<DrizzleQueryable>({\n    root: database,\n    transaction: (work) => database.transaction(work),\n    async run(queryable, { sql, parameters }) {\n      const chunks = splitPositionalSql(sql).map((part) =>\n        typeof part === 'string'\n          ? drizzleSql.raw(part)\n          : drizzleSql.param(parameters[part.parameterIndex]),\n      );\n      const result = await queryable.execute(drizzleSql.join(chunks));\n      return result.rows;\n    },\n  });\n}\n"]}

package/dist/{executor-CfJgktC6.d.cts → executor-Bt90w33Q.d.cts}

@@ -1,3 +1,5 @@
+import { TransactionIsolationLevel } from '@relaybus/core';
+
 /** Values the store binds: always text, numbers or null (documents travel as JSON text). */
 type PostgresParameter = string | number | null;
 type PostgresRow = Readonly<Record<string, unknown>>;
@@ -45,7 +47,28 @@ interface PostgresExecutor<TTransaction> {
      * its own, one round trip more per `bus.transaction`. `PgExecutor` implements it.
      */
     transactionWithBudget?<T>(work: (transaction: TTransaction) => Promise<T>, timeoutMs: number): Promise<T>;
+    /**
+     * Optional. Opens a transaction at `isolationLevel` that the server holds to `timeoutMs`, like
+     * {@link PostgresExecutor.transactionWithBudget}, with the level set in the same round trip as its
+     * `BEGIN` (`BEGIN ISOLATION LEVEL ...`). Without it the store sends `SET TRANSACTION ISOLATION
+     * LEVEL ...` as the first statement of {@link PostgresExecutor.transaction}, then the budget:
+     * two round trips more, on the transactions that ask for a level only. `PgExecutor` implements it.
+     */
+    transactionWithIsolation?<T>(work: (transaction: TTransaction) => Promise<T>, options: PostgresIsolatedTransactionOptions): Promise<T>;
+    /**
+     * Optional. True when `error` is a serialization failure (SQLSTATE `40001`) of this library, for
+     * errors the store does not recognize itself. The store already finds `40001` in `code`, in
+     * `cause` and `driverError` chains, and in Prisma's `P2034` / `meta.code`; implement it only for
+     * a library that wraps the error in another shape.
+     */
+    isSerializationFailure?(error: unknown): boolean;
     query(sql: string, parameters: readonly PostgresParameter[], transaction?: TTransaction, options?: PostgresQueryOptions): Promise<readonly PostgresRow[]>;
 }
+/** What {@link PostgresExecutor.transactionWithIsolation} opens a transaction with. */
+interface PostgresIsolatedTransactionOptions {
+    readonly isolationLevel: TransactionIsolationLevel;
+    /** The time budget, as for {@link PostgresExecutor.transactionWithBudget}. */
+    readonly timeoutMs: number;
+}
 
-export type { PostgresExecutor as P, PostgresParameter as a, PostgresQueryOptions as b, PostgresRow as c };
+export type { PostgresExecutor as P, PostgresIsolatedTransactionOptions as a, PostgresParameter as b, PostgresQueryOptions as c, PostgresRow as d };

package/dist/{executor-CfJgktC6.d.ts → executor-Bt90w33Q.d.ts}

@@ -1,3 +1,5 @@
+import { TransactionIsolationLevel } from '@relaybus/core';
+
 /** Values the store binds: always text, numbers or null (documents travel as JSON text). */
 type PostgresParameter = string | number | null;
 type PostgresRow = Readonly<Record<string, unknown>>;
@@ -45,7 +47,28 @@ interface PostgresExecutor<TTransaction> {
      * its own, one round trip more per `bus.transaction`. `PgExecutor` implements it.
      */
     transactionWithBudget?<T>(work: (transaction: TTransaction) => Promise<T>, timeoutMs: number): Promise<T>;
+    /**
+     * Optional. Opens a transaction at `isolationLevel` that the server holds to `timeoutMs`, like
+     * {@link PostgresExecutor.transactionWithBudget}, with the level set in the same round trip as its
+     * `BEGIN` (`BEGIN ISOLATION LEVEL ...`). Without it the store sends `SET TRANSACTION ISOLATION
+     * LEVEL ...` as the first statement of {@link PostgresExecutor.transaction}, then the budget:
+     * two round trips more, on the transactions that ask for a level only. `PgExecutor` implements it.
+     */
+    transactionWithIsolation?<T>(work: (transaction: TTransaction) => Promise<T>, options: PostgresIsolatedTransactionOptions): Promise<T>;
+    /**
+     * Optional. True when `error` is a serialization failure (SQLSTATE `40001`) of this library, for
+     * errors the store does not recognize itself. The store already finds `40001` in `code`, in
+     * `cause` and `driverError` chains, and in Prisma's `P2034` / `meta.code`; implement it only for
+     * a library that wraps the error in another shape.
+     */
+    isSerializationFailure?(error: unknown): boolean;
     query(sql: string, parameters: readonly PostgresParameter[], transaction?: TTransaction, options?: PostgresQueryOptions): Promise<readonly PostgresRow[]>;
 }
+/** What {@link PostgresExecutor.transactionWithIsolation} opens a transaction with. */
+interface PostgresIsolatedTransactionOptions {
+    readonly isolationLevel: TransactionIsolationLevel;
+    /** The time budget, as for {@link PostgresExecutor.transactionWithBudget}. */
+    readonly timeoutMs: number;
+}
 
-export type { PostgresExecutor as P, PostgresParameter as a, PostgresQueryOptions as b, PostgresRow as c };
+export type { PostgresExecutor as P, PostgresIsolatedTransactionOptions as a, PostgresParameter as b, PostgresQueryOptions as c, PostgresRow as d };

package/dist/index.cjs

@@ -39,6 +39,41 @@ function inBudgetedTransaction(state, {
   });
 }
 
+// src/transaction-isolation.ts
+var ISOLATION_KEYWORDS = {
+  "read committed": "READ COMMITTED",
+  "repeatable read": "REPEATABLE READ",
+  serializable: "SERIALIZABLE"
+};
+function isolationKeywords(isolationLevel) {
+  const keywords = Object.hasOwn(ISOLATION_KEYWORDS, isolationLevel) ? ISOLATION_KEYWORDS[isolationLevel] : void 0;
+  if (keywords === void 0) {
+    throw new core.ConfigurationError(`Unknown isolation level ${JSON.stringify(isolationLevel)}`);
+  }
+  return keywords;
+}
+function inIsolatedTransaction(state, {
+  work,
+  timeoutMs,
+  isolationLevel
+}) {
+  const { executor } = state;
+  if (executor.transactionWithIsolation !== void 0) {
+    return executor.transactionWithIsolation(work, { isolationLevel, timeoutMs });
+  }
+  const keywords = isolationKeywords(isolationLevel);
+  const budget = budgetSettingsSql({
+    value: "$1",
+    sessionTimeouts: executor.sessionTimeouts === true,
+    scope: "transaction"
+  });
+  return executor.transaction(async (transaction) => {
+    await executor.query(`SET TRANSACTION ISOLATION LEVEL ${keywords}`, [], transaction);
+    await state.query({ sql: budget, parameters: [budgetValue(timeoutMs)], transaction });
+    return work(transaction);
+  });
+}
+
 // src/pg-executor.ts
 var FOREIGN_SESSION_ERRORS = /* @__PURE__ */ new Set(["26000", "42P05"]);
 var STATEMENT_NAME_DIGITS = 24;
@@ -69,14 +104,28 @@ var PgExecutor = class {
    * connection that already keeps this budget only gets `BEGIN`.
    */
   transactionWithBudget(work, timeoutMs) {
+    return this.#transaction(work, this.#budgetStart(timeoutMs, "BEGIN"));
+  }
+  /**
+   * Like {@link PgExecutor.transactionWithBudget} with `BEGIN ISOLATION LEVEL ...`: the level is set
+   * with the `BEGIN` of the same simple query, before the budget's first statement.
+   */
+  transactionWithIsolation(work, { isolationLevel, timeoutMs }) {
+    return this.#transaction(
+      work,
+      this.#budgetStart(timeoutMs, `BEGIN ISOLATION LEVEL ${isolationKeywords(isolationLevel)}`)
+    );
+  }
+  /** How a transaction starts on a connection when it is held to `timeoutMs`; `begin` is the `BEGIN` statement. */
+  #budgetStart(timeoutMs, begin) {
     const value = budgetValue(timeoutMs);
     const settings = (scope) => budgetSettingsSql({ value: `'${value}'`, sessionTimeouts: true, scope });
-    return this.#transaction(work, (client) => {
+    return (client) => {
       if (!this.#keepsSessionBudget()) {
-        return { begin: `BEGIN; ${settings("transaction")}` };
+        return { begin: `${begin}; ${settings("transaction")}` };
       }
-      return this.#sessionValues.get(client) === value ? { begin: "BEGIN" } : { begin: `BEGIN; ${settings("session")}`, sessionValue: value };
-    });
+      return this.#sessionValues.get(client) === value ? { begin } : { begin: `${begin}; ${settings("session")}`, sessionValue: value };
+    };
   }
   #recordSession(client, sessionValue) {
     if (sessionValue === null) {
@@ -538,10 +587,38 @@ function withRootPool(executor, root) {
     ...executor.transactionWithBudget === void 0 ? {} : {
       transactionWithBudget: (work, timeoutMs) => executor.transactionWithBudget(work, timeoutMs)
     },
+    ...executor.transactionWithIsolation === void 0 ? {} : {
+      transactionWithIsolation: (work, options) => executor.transactionWithIsolation(work, options)
+    },
+    ...executor.isSerializationFailure === void 0 ? {} : { isSerializationFailure: (error) => executor.isSerializationFailure(error) },
     // eslint-disable-next-line relaybus/max-two-params -- PostgresExecutor port signature
     query: (sql, parameters, transaction, options) => transaction === void 0 ? root.query(sql, parameters, void 0, options) : executor.query(sql, parameters, transaction, options)
   };
 }
+
+// src/serialization-failure.ts
+var SERIALIZATION_FAILURE = "40001";
+var PRISMA_WRITE_CONFLICT = "P2034";
+var CONFLICT_CODES = /* @__PURE__ */ new Set([
+  SERIALIZATION_FAILURE,
+  PRISMA_WRITE_CONFLICT
+]);
+var MAXIMUM_DEPTH = 6;
+var WRAPPED_ERROR_KEYS = ["cause", "driverError", "originalError"];
+function isPostgresSerializationFailure(error, depth = 0) {
+  if (typeof error !== "object" || error === null || depth > MAXIMUM_DEPTH) {
+    return false;
+  }
+  const shape = error;
+  if (CONFLICT_CODES.has(shape.code) || shape.originalCode === SERIALIZATION_FAILURE) {
+    return true;
+  }
+  const meta = shape.meta;
+  if (isPostgresSerializationFailure(meta, depth + 1) || isPostgresSerializationFailure(meta?.driverAdapterError, depth + 1)) {
+    return true;
+  }
+  return WRAPPED_ERROR_KEYS.some((key) => isPostgresSerializationFailure(shape[key], depth + 1));
+}
 function text(row, column) {
   return row[column];
 }
@@ -3046,6 +3123,16 @@ var PostgresEventStore = class {
   async setup() {
     await this.#setup.run();
   }
+  /** Every level PostgreSQL has (it runs `read uncommitted` as `read committed`, which the bus does not offer). */
+  isolationLevels = core.TRANSACTION_ISOLATION_LEVELS;
+  /**
+   * True for a serialization failure (SQLSTATE `40001`) raised through any executor, including
+   * Prisma's `P2034` and the wrappers of TypeORM and Drizzle; a custom executor can add its own
+   * test with {@link PostgresExecutor.isSerializationFailure}.
+   */
+  isSerializationFailure(error) {
+    return isPostgresSerializationFailure(error) || this.#state.executor.isSerializationFailure?.(error) === true;
+  }
   /**
    * Runs `work` in a transaction of the executor. With `options.timeoutMs` (from `bus.transaction`)
    * the server holds the transaction to the budget: `statement_timeout`, and for executors with
@@ -3053,6 +3140,9 @@ var PostgresEventStore = class {
    * `transaction_timeout`, all scoped to the transaction. An executor with `transactionWithBudget`
    * (`PgExecutor`) sets them with `BEGIN`, so the budget costs no round trip; on a pool the store
    * created they are kept per connection and sent only when the connection does not have them yet.
+   * With `options.isolationLevel` the transaction runs at that level: `PgExecutor` sends it with
+   * `BEGIN ISOLATION LEVEL ...` (no extra round trip), any other executor as `SET TRANSACTION
+   * ISOLATION LEVEL ...` before the budget statement.
    */
   async transaction(work, options) {
     const own = { wake: false };
@@ -3064,12 +3154,20 @@ var PostgresEventStore = class {
         this.#state.ownTransactions.delete(transaction);
       }
     };
-    const result = await (options === void 0 ? this.#state.executor.transaction(tracked) : inBudgetedTransaction(this.#state, { work: tracked, timeoutMs: options.timeoutMs }));
+    const result = await this.#open(tracked, options);
     if (own.wake) {
       this.#appender.wakeAfterCommit();
     }
     return result;
   }
+  /** Opens the transaction `work` runs in: plain, held to the budget, or at an isolation level too. */
+  #open(work, options) {
+    if (options === void 0) {
+      return this.#state.executor.transaction(work);
+    }
+    const { timeoutMs, isolationLevel } = options;
+    return isolationLevel === void 0 ? inBudgetedTransaction(this.#state, { work, timeoutMs }) : inIsolatedTransaction(this.#state, { work, timeoutMs, isolationLevel });
+  }
   /**
    * Writes the entries in `transaction`, normally with one statement
    * (`AppendStatements.insertFreshEvents`): keyed events reserve their sequence numbers (locking