@ultimat3/db 26.1.0 → 27.0.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ultimat3/db",
-  "version": "26.1.0",
+  "version": "27.0.0",
   "description": "Postgres access, transactions, migrations and drift detection",
   "license": "MIT",
   "type": "module",
@@ -33,7 +33,7 @@
     "test": "bun test"
   },
   "dependencies": {
-    "@ultimat3/core": "26.1.0"
+    "@ultimat3/core": "27.0.0"
   },
   "peerDependencies": {
     "@electric-sql/pglite": ">=0.5.0"

package/src/index.ts

@@ -205,7 +205,7 @@ export { DB_SQLSTATE_CODES, isRetryableState, SQLSTATE, sqlState, sqlStateCode }
 export { statementFingerprint, statementKind, statementVerb } from './statement-shape';
 export { STATEMENT_ATTRIBUTE } from './statement-span';
 export { statementsOf } from './statement-split';
-export { currentTx, liveTxConnection, withTransaction } from './transaction';
+export { currentTx, liveTxConnection, outsideTransaction, withTransaction } from './transaction';
 export { commitUnknown, siblingScopeTimeout, transactionAborted } from './transaction-errors';
 export type { DbTx, IsolationLevel, TransactionOptions } from './transaction-options';
 export { beginStatement } from './transaction-options';

package/src/transaction.ts

@@ -79,6 +79,17 @@ export function currentTx(): DbTx | undefined {
   return storage.get()?.tx;
 }
 
+/**
+ * Run `fn` outside any transaction this async context carries: inside it `currentTx()` is
+ * `undefined` and `db()` is the pool. For work that must never join a caller's transaction even
+ * when it was STARTED inside one — `@ultimat3/jobs` runs every job body under it, because a worker
+ * started inside a transaction scope handed each job that transaction, long committed, and an
+ * enqueue from the body staged into its dead outbox.
+ */
+export function outsideTransaction<R>(fn: () => R): R {
+  return storage.exit(fn);
+}
+
 /**
  * The connection the transaction still OPEN on this async context runs on, or `undefined`. A
  * different question from `currentTx() !== undefined`, which only says a store is present — and the