@vibeorm/adapter-pg 2.0.0-alpha.1 → 2.0.0-alpha.10

package/dist/errors.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,SAAS,EAAE,KAAK,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAIhE;;;GAGG;AACH,eAAO,MAAM,uBAAuB,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,aAAa,CAAC,CAqB1E,CAAC;AAEH,4EAA4E;AAC5E,eAAO,MAAM,mBAAmB,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAE/D,CAAC;AAYH;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE;IAAE,KAAK,EAAE,OAAO,CAAA;CAAE,GAAG,MAAM,GAAG,SAAS,CAK9E;AAID;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE;IAAE,KAAK,EAAE,OAAO,CAAA;CAAE,GAAG,SAAS,CA0BtE;AAED,wEAAwE;AACxE,wBAAsB,SAAS,CAAC,CAAC,EAAE,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAMnE"}
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,SAAS,EAAE,KAAK,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAIhE;;;GAGG;AACH,eAAO,MAAM,uBAAuB,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,aAAa,CAAC,CA2B1E,CAAC;AAEH,4EAA4E;AAC5E,eAAO,MAAM,mBAAmB,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAE/D,CAAC;AAYH;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE;IAAE,KAAK,EAAE,OAAO,CAAA;CAAE,GAAG,MAAM,GAAG,SAAS,CAK9E;AAID;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE;IAAE,KAAK,EAAE,OAAO,CAAA;CAAE,GAAG,SAAS,CA0BtE;AAED,wEAAwE;AACxE,wBAAsB,SAAS,CAAC,CAAC,EAAE,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAMnE"}

package/dist/index.d.ts

@@ -11,6 +11,16 @@ export type PgQueryConfig = {
     readonly text: string;
     readonly values?: unknown[];
     readonly name?: string;
+    /**
+     * QUERY-LOCAL result parsers ({@link EXACT_TYPES}). node-postgres reads this
+     * off the query config, so nothing outside VibeORM's own statements is
+     * affected — a caller's pool keeps the driver's documented behaviour.
+     */
+    readonly types?: PgTypeParsers;
+};
+/** The `pg-types` surface a query config may carry. */
+export type PgTypeParsers = {
+    getTypeParser(oid: number, format?: "text" | "binary"): (value: string) => unknown;
 };
 /** The parts of a `pg` result this adapter reads. */
 export type PgQueryResultLike = {
@@ -20,13 +30,27 @@ export type PgQueryResultLike = {
 /** The parts of a `pg` PoolClient this adapter uses. */
 export type PgPoolClientLike = {
     query(config: PgQueryConfig): Promise<PgQueryResultLike>;
-    release(): void;
+    /**
+     * Hand the client back. A TRUTHY argument tells node-postgres to DESTROY it
+     * instead of pooling it — used when a rollback failed and the session state
+     * can no longer be asserted (EPIC 6). Optional so existing test doubles that
+     * declare `release(): void` still satisfy this type.
+     */
+    release(destroy?: boolean): void;
+    /**
+     * EventEmitter surface. A real `pg.PoolClient` has it; test doubles need not,
+     * so both members are optional and the adapter feature-detects them.
+     */
+    on?(event: "error", listener: (error: unknown) => void): void;
+    removeListener?(event: "error", listener: (error: unknown) => void): void;
 };
 /** The parts of a `pg` Pool this adapter uses — satisfied by a real `pg.Pool`. */
 export type PgPoolLike = {
     connect(): Promise<PgPoolClientLike>;
     query(config: PgQueryConfig): Promise<PgQueryResultLike>;
     end(): Promise<void>;
+    /** EventEmitter surface; optional for the same reason as on {@link PgPoolClientLike}. */
+    on?(event: "error", listener: (error: unknown, client: PgPoolClientLike) => void): void;
 };
 /**
  * Options for {@link pgAdapter}. Either point it at a connection string (the
@@ -85,4 +109,6 @@ export { createStatementNameCache } from "./statement-cache.ts";
 export type { StatementNameCache } from "./statement-cache.ts";
 export { ISOLATION_LEVEL_SQL, beginStatement, classifyRawTransactionControl, refuseNestedTransactionOptions, statementTimeoutStatement, } from "./transaction-sql.ts";
 export type { RawTransactionControl } from "./transaction-sql.ts";
+export { DEFAULT_DEADLINE_CLOCK, engineStatementBudgetMs, isTransactionDeadlineError, startTransactionBudget, transactionClosedError, transactionDeadlineError, transactionOutcomeUnknownError, validateTransactionDeadline, } from "./transaction-budget.ts";
+export type { BudgetStage, DeadlineClock, TransactionBudget, TransactionOutcome } from "./transaction-budget.ts";
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAiD,MAAM,kBAAkB,CAAC;AAgBvG,qFAAqF;AACrF,MAAM,MAAM,aAAa,GAAG;IAC1B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,MAAM,CAAC,EAAE,OAAO,EAAE,CAAC;IAC5B,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;CACxB,CAAC;AAEF,qDAAqD;AACrD,MAAM,MAAM,iBAAiB,GAAG;IAC9B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,CAAC;IACzC,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;CAClC,CAAC;AAEF,wDAAwD;AACxD,MAAM,MAAM,gBAAgB,GAAG;IAC7B,KAAK,CAAC,MAAM,EAAE,aAAa,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAAC;IACzD,OAAO,IAAI,IAAI,CAAC;CACjB,CAAC;AAEF,kFAAkF;AAClF,MAAM,MAAM,UAAU,GAAG;IACvB,OAAO,IAAI,OAAO,CAAC,gBAAgB,CAAC,CAAC;IACrC,KAAK,CAAC,MAAM,EAAE,aAAa,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAAC;IACzD,GAAG,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACtB,CAAC;AAOF;;;GAGG;AACH,MAAM,MAAM,gBAAgB,GAAG;IAC7B,yEAAyE;IACzE,QAAQ,CAAC,gBAAgB,CAAC,EAAE,MAAM,CAAC;IACnC;;;OAGG;IACH,QAAQ,CAAC,IAAI,CAAC,EAAE,UAAU,CAAC;IAC3B,6EAA6E;IAC7E,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC;IACtB;;;OAGG;IACH,QAAQ,CAAC,gBAAgB,CAAC,EAAE,MAAM,CAAC;IACnC,gGAAgG;IAChG,QAAQ,CAAC,iBAAiB,CAAC,EAAE,MAAM,CAAC;IACpC;;;;;OAKG;IACH,QAAQ,CAAC,kBAAkB,CAAC,EAAE,OAAO,CAAC;IACtC,gFAAgF;IAChF,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC;CAChC,CAAC;AAcF;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,SAAS,CAAC,OAAO,CAAC,EAAE,gBAAgB,GAAG,eAAe,CAyOrE;AAID,OAAO,EAAE,uBAAuB,EAAE,mBAAmB,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAC9G,OAAO,EAAE,YAAY,EAAE,eAAe,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AAChF,OAAO,EAAE,sBAAsB,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AAC5E,YAAY,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AACxD,OAAO,EAAE,wBAAwB,EAAE,MAAM,sBAAsB,CAAC;AAChE,YAAY,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAC/D,OAAO,EACL,mBAAmB,EACnB,cAAc,EACd,6BAA6B,EAC7B,8BAA8B,EAC9B,yBAAyB,GAC1B,MAAM,sBAAsB,CAAC;AAC9B,YAAY,EAAE,qBAAqB,EAAE,MAAM,sBAAsB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAEV,eAAe,EAIhB,MAAM,kBAAkB,CAAC;AA8B1B,qFAAqF;AACrF,MAAM,MAAM,aAAa,GAAG;IAC1B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,MAAM,CAAC,EAAE,OAAO,EAAE,CAAC;IAC5B,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB;;;;OAIG;IACH,QAAQ,CAAC,KAAK,CAAC,EAAE,aAAa,CAAC;CAChC,CAAC;AAEF,uDAAuD;AACvD,MAAM,MAAM,aAAa,GAAG;IAC1B,aAAa,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,QAAQ,GAAG,CAAC,KAAK,EAAE,MAAM,KAAK,OAAO,CAAC;CACpF,CAAC;AAEF,qDAAqD;AACrD,MAAM,MAAM,iBAAiB,GAAG;IAC9B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,CAAC;IACzC,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;CAClC,CAAC;AAEF,wDAAwD;AACxD,MAAM,MAAM,gBAAgB,GAAG;IAC7B,KAAK,CAAC,MAAM,EAAE,aAAa,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAAC;IACzD;;;;;OAKG;IACH,OAAO,CAAC,OAAO,CAAC,EAAE,OAAO,GAAG,IAAI,CAAC;IACjC;;;OAGG;IACH,EAAE,CAAC,CAAC,KAAK,EAAE,OAAO,EAAE,QAAQ,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI,GAAG,IAAI,CAAC;IAC9D,cAAc,CAAC,CAAC,KAAK,EAAE,OAAO,EAAE,QAAQ,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI,GAAG,IAAI,CAAC;CAC3E,CAAC;AAEF,kFAAkF;AAClF,MAAM,MAAM,UAAU,GAAG;IACvB,OAAO,IAAI,OAAO,CAAC,gBAAgB,CAAC,CAAC;IACrC,KAAK,CAAC,MAAM,EAAE,aAAa,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAAC;IACzD,GAAG,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACrB,yFAAyF;IACzF,EAAE,CAAC,CAAC,KAAK,EAAE,OAAO,EAAE,QAAQ,EAAE,CAAC,KAAK,EAAE,OAAO,EAAE,MAAM,EAAE,gBAAgB,KAAK,IAAI,GAAG,IAAI,CAAC;CACzF,CAAC;AA6CF;;;GAGG;AACH,MAAM,MAAM,gBAAgB,GAAG;IAC7B,yEAAyE;IACzE,QAAQ,CAAC,gBAAgB,CAAC,EAAE,MAAM,CAAC;IACnC;;;OAGG;IACH,QAAQ,CAAC,IAAI,CAAC,EAAE,UAAU,CAAC;IAC3B,6EAA6E;IAC7E,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC;IACtB;;;OAGG;IACH,QAAQ,CAAC,gBAAgB,CAAC,EAAE,MAAM,CAAC;IACnC,gGAAgG;IAChG,QAAQ,CAAC,iBAAiB,CAAC,EAAE,MAAM,CAAC;IACpC;;;;;OAKG;IACH,QAAQ,CAAC,kBAAkB,CAAC,EAAE,OAAO,CAAC;IACtC,gFAAgF;IAChF,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC;CAChC,CAAC;AA2EF;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,SAAS,CAAC,OAAO,CAAC,EAAE,gBAAgB,GAAG,eAAe,CAgVrE;AAID,OAAO,EAAE,uBAAuB,EAAE,mBAAmB,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAC9G,OAAO,EAAE,YAAY,EAAE,eAAe,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AAChF,OAAO,EAAE,sBAAsB,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AAC5E,YAAY,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AACxD,OAAO,EAAE,wBAAwB,EAAE,MAAM,sBAAsB,CAAC;AAChE,YAAY,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAC/D,OAAO,EACL,mBAAmB,EACnB,cAAc,EACd,6BAA6B,EAC7B,8BAA8B,EAC9B,yBAAyB,GAC1B,MAAM,sBAAsB,CAAC;AAC9B,YAAY,EAAE,qBAAqB,EAAE,MAAM,sBAAsB,CAAC;AAElE,OAAO,EACL,sBAAsB,EACtB,uBAAuB,EACvB,0BAA0B,EAC1B,sBAAsB,EACtB,sBAAsB,EACtB,wBAAwB,EACxB,8BAA8B,EAC9B,2BAA2B,GAC5B,MAAM,yBAAyB,CAAC;AACjC,YAAY,EAAE,WAAW,EAAE,aAAa,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC"}

package/dist/index.js

@@ -10,6 +10,7 @@ var PG_SQLSTATE_ERROR_CODES = Object.freeze({
   "23502": "VIBE_VALIDATION",
   "23514": "VIBE_VALIDATION",
   "22P02": "VIBE_VALIDATION",
+  "42501": "VIBE_PERMISSION_DENIED",
   "40001": "VIBE_TRANSACTION",
   "40P01": "VIBE_TRANSACTION",
   "57014": "VIBE_TRANSACTION"
@@ -93,6 +94,9 @@ function serializeParamsRaw(params) {
   });
 }
 
+// packages/adapter-pg/src/savepoint-gate.ts
+import { AsyncLocalStorage } from "async_hooks";
+
 // packages/adapter-pg/src/savepoints.ts
 function createSavepointCounter() {
   return { n: 0 };
@@ -101,26 +105,123 @@ function nextSavepointName(params) {
   return `vibeorm_sp_${params.counter.n++}`;
 }
 
+// packages/adapter-pg/src/savepoint-gate.ts
+var CURRENT = new AsyncLocalStorage;
+function createSavepointScope() {
+  return { depth: 0, state: { counter: createSavepointCounter(), open: null } };
+}
+function runRootScope(params) {
+  return CURRENT.run(params.scope, params.body);
+}
+function scopeTurn(params) {
+  const open = params.scope.state.open;
+  if (mayProceed({ scope: params.scope, open }))
+    return;
+  return waitForTurn({ scope: params.scope });
+}
+async function runNestedSavepoint(params) {
+  const { scope, execute, body } = params;
+  const node = await acquire({ scope });
+  try {
+    if (execute !== undefined)
+      await execute(`SAVEPOINT ${node.name}`);
+    let result;
+    try {
+      result = await CURRENT.run(node.scope, () => body(node.scope));
+    } catch (error) {
+      await drainDescendants({ node });
+      if (execute !== undefined) {
+        try {
+          await execute(`ROLLBACK TO SAVEPOINT ${node.name}`);
+        } catch {}
+      }
+      throw error;
+    }
+    await drainDescendants({ node });
+    if (execute !== undefined)
+      await execute(`RELEASE SAVEPOINT ${node.name}`);
+    return result;
+  } finally {
+    closeNode({ node });
+  }
+}
+function mayProceed(params) {
+  const { scope, open } = params;
+  if (open === null)
+    return true;
+  if (open.scope === scope)
+    return true;
+  if (open.scope.depth < scope.depth)
+    return true;
+  return CURRENT.getStore() === open.scope;
+}
+async function waitForTurn(params) {
+  for (;; ) {
+    const open = params.scope.state.open;
+    if (open === null || mayProceed({ scope: params.scope, open }))
+      return;
+    await open.settled;
+  }
+}
+async function acquire(params) {
+  const { scope } = params;
+  for (;; ) {
+    const open = scope.state.open;
+    if (mayProceed({ scope, open }))
+      return pushNode({ scope, parent: open });
+    await open.settled;
+  }
+}
+function pushNode(params) {
+  const { scope, parent } = params;
+  const state = scope.state;
+  let settle = () => {
+    return;
+  };
+  const settled = new Promise((resolve) => {
+    settle = () => resolve();
+  });
+  const node = {
+    scope: { depth: (parent === null ? 0 : parent.scope.depth) + 1, state },
+    name: nextSavepointName({ counter: state.counter }),
+    parent,
+    settled,
+    settle
+  };
+  state.open = node;
+  return node;
+}
+function closeNode(params) {
+  const { node } = params;
+  const state = node.scope.state;
+  if (state.open === node)
+    state.open = node.parent;
+  node.settle();
+}
+async function drainDescendants(params) {
+  const state = params.node.scope.state;
+  for (;; ) {
+    const open = state.open;
+    if (open === null || open === params.node || open.scope.depth <= params.node.scope.depth)
+      return;
+    await open.settled;
+  }
+}
+
 // packages/adapter-pg/src/statement-cache.ts
 function createStatementNameCache(params) {
-  const { max } = params;
+  const max = Math.max(0, params.max);
   const names = new Map;
   let counter = 0;
   return {
     getName(nameParams) {
       const { text } = nameParams;
       const existing = names.get(text);
-      if (existing !== undefined) {
-        names.delete(text);
-        names.set(text, existing);
+      if (existing !== undefined)
         return existing;
-      }
+      if (names.size >= max)
+        return;
       const name = `vibeorm_${counter++}`;
-      if (names.size >= max) {
-        const oldest = names.keys().next().value;
-        if (oldest !== undefined)
-          names.delete(oldest);
-      }
       names.set(text, name);
       return name;
     },
@@ -130,8 +231,127 @@ function createStatementNameCache(params) {
   };
 }
 
-// packages/adapter-pg/src/transaction-sql.ts
+// packages/adapter-pg/src/transaction-budget.ts
 import { VibeError as VibeError2 } from "@vibeorm/schema";
+var DEFAULT_DEADLINE_CLOCK = () => Date.now();
+function validateTransactionDeadline(params) {
+  const { options, support, provider } = params;
+  const deadline = options?.deadline;
+  if (deadline === undefined)
+    return;
+  if (support === "unsupported") {
+    throw new VibeError2({
+      code: "VIBE_UNSUPPORTED_CAPABILITY",
+      message: `${provider} cannot enforce a transaction deadline \u2014 remove the \`deadline\` option`,
+      meta: { provider, feature: "transactionDeadline", supported: support }
+    });
+  }
+  if (!Number.isInteger(deadline.totalMs) || deadline.totalMs <= 0) {
+    throw new VibeError2({
+      code: "VIBE_VALIDATION",
+      message: `transaction deadline \`totalMs\` must be a positive integer of milliseconds, received ${String(deadline.totalMs)}`,
+      meta: { provider, feature: "transactionDeadline", totalMs: deadline.totalMs }
+    });
+  }
+  const requested = deadline.enforcement ?? "between-statements";
+  if (requested === "cancel-running-statements" && support !== "cancel-running-statements") {
+    throw new VibeError2({
+      code: "VIBE_UNSUPPORTED_CAPABILITY",
+      message: `${provider} cannot cancel a statement that is already running, so the requested ` + "`cancel-running-statements` deadline guarantee is refused rather than silently downgraded \u2014 " + 'ask for "between-statements" if a budget checked between statements is enough',
+      meta: { provider, feature: "transactionDeadline", requested, supported: support }
+    });
+  }
+}
+function startTransactionBudget(params) {
+  const { options, provider } = params;
+  const clock = params.clock ?? DEFAULT_DEADLINE_CLOCK;
+  const deadline = options?.deadline;
+  const totalMs = deadline === undefined ? null : deadline.totalMs;
+  const enforcement = deadline === undefined ? null : deadline.enforcement ?? "between-statements";
+  const expiresAt = totalMs === null ? null : clock() + totalMs;
+  let outcome = null;
+  const budget = {
+    enforcement,
+    totalMs,
+    statementTimeoutMs: options?.timeout ?? null,
+    remainingMs() {
+      return expiresAt === null ? null : Math.max(0, expiresAt - clock());
+    },
+    expired() {
+      return expiresAt !== null && clock() >= expiresAt;
+    },
+    assertUsable(assertParams) {
+      if (outcome !== null) {
+        throw transactionClosedError({ provider, outcome, stage: assertParams.stage });
+      }
+      if (expiresAt !== null && clock() >= expiresAt) {
+        throw transactionDeadlineError({
+          provider,
+          stage: assertParams.stage,
+          totalMs,
+          overdueMs: clock() - expiresAt
+        });
+      }
+    },
+    close(closeParams) {
+      if (outcome === null)
+        outcome = closeParams.outcome;
+    },
+    get outcome() {
+      return outcome;
+    }
+  };
+  return budget;
+}
+function engineStatementBudgetMs(params) {
+  const { budget } = params;
+  if (budget.enforcement !== "cancel-running-statements")
+    return null;
+  const remaining = budget.remainingMs();
+  if (remaining === null)
+    return null;
+  const totalBound = Math.max(1, Math.ceil(remaining));
+  return budget.statementTimeoutMs !== null && budget.statementTimeoutMs > 0 ? Math.min(totalBound, budget.statementTimeoutMs) : totalBound;
+}
+function transactionDeadlineError(params) {
+  const { provider, stage, totalMs, overdueMs } = params;
+  const what = stage === "commit" ? "the transaction was rolled back instead of committed" : "the statement was never sent and the transaction is being rolled back";
+  return new VibeError2({
+    code: "VIBE_TRANSACTION",
+    message: `transaction deadline of ${totalMs} ms expired ${Math.max(0, Math.round(overdueMs))} ms ago \u2014 ${what}. ` + "Nothing is retried automatically: work the callback did outside the database may already have happened.",
+    meta: { provider, reason: "transaction-deadline", stage, totalMs, overdueMs: Math.max(0, Math.round(overdueMs)) }
+  });
+}
+function transactionClosedError(params) {
+  const { provider, outcome, stage } = params;
+  return new VibeError2({
+    code: "VIBE_TRANSACTION",
+    message: `this transaction has already finished (${outcome}), so its client can no longer be used \u2014 ` + "a handle kept past the end of `$transaction` would run outside the transaction, on a connection " + "that now belongs to someone else",
+    meta: { provider, reason: "transaction-closed", outcome, stage }
+  });
+}
+function transactionOutcomeUnknownError(params) {
+  const { provider, totalMs, cause } = params;
+  return new VibeError2({
+    code: "VIBE_TRANSACTION",
+    message: `transaction deadline of ${totalMs} ms expired and the rollback that should have cleaned up failed \u2014 ` + "the commit state of this transaction is UNKNOWN. It is not retried automatically; inspect the data " + "before deciding.",
+    meta: {
+      provider,
+      reason: "transaction-outcome-unknown",
+      outcome: "unknown",
+      totalMs,
+      rollbackFailed: true
+    },
+    cause
+  });
+}
+function isTransactionDeadlineError(error) {
+  const reason = error?.meta?.reason;
+  return reason === "transaction-deadline";
+}
+
+// packages/adapter-pg/src/transaction-sql.ts
+import { VibeError as VibeError3 } from "@vibeorm/schema";
 var ISOLATION_LEVEL_SQL = Object.freeze({
   ReadCommitted: "READ COMMITTED",
   RepeatableRead: "REPEATABLE READ",
@@ -144,7 +364,7 @@ function beginStatement(params) {
 function statementTimeoutStatement(params) {
   const { timeout } = params;
   if (!Number.isInteger(timeout) || timeout < 0) {
-    throw new VibeError2({
+    throw new VibeError3({
       code: "VIBE_VALIDATION",
       message: `transaction timeout must be a non-negative integer of milliseconds, received ${String(timeout)}`,
       meta: { timeout }
@@ -170,6 +390,8 @@ function refuseNestedTransactionOptions(params) {
     passed.push("isolationLevel");
   if (options.timeout !== undefined)
     passed.push("timeout");
+  if (options.deadline !== undefined)
+    passed.push("deadline");
   if (passed.length === 0)
     return;
   const meta = { provider, nested: true };
@@ -177,23 +399,55 @@ function refuseNestedTransactionOptions(params) {
     meta.isolationLevel = options.isolationLevel;
   if (options.timeout !== undefined)
     meta.timeout = options.timeout;
-  throw new VibeError2({
+  if (options.deadline !== undefined)
+    meta.deadline = options.deadline;
+  throw new VibeError3({
     code: "VIBE_VALIDATION",
-    message: `nested transactions run as savepoints and cannot honor ${passed.join(" or ")} \u2014 a savepoint cannot change the isolation level of the transaction it joins, and a nested timeout is not enforceable; pass options on the top-level $transaction`,
+    message: `nested transactions run as savepoints and cannot honor ${passed.join(" or ")} \u2014 a savepoint cannot change the isolation level of the transaction it joins, a nested timeout is not enforceable, and a nested deadline would need its own session setting on a connection it does not own (it inherits the top-level one instead); pass options on the top-level $transaction`,
     meta
   });
 }
 
 // packages/adapter-pg/src/index.ts
+var POOL_STATEMENT_NAMES = new WeakMap;
+function guardBackgroundErrors(params) {
+  const { client } = params;
+  if (typeof client.on !== "function")
+    return () => {
+      return;
+    };
+  const swallow = () => {};
+  client.on("error", swallow);
+  return () => {
+    client.removeListener?.("error", swallow);
+  };
+}
 var DIALECT = "postgres";
 var PROVIDER = "postgresql";
 var WIRE = Object.freeze({ dateTime: "native", json: "parsed", numbers: "native" });
+var BUDGETS = Object.freeze({
+  acquireTimeout: true,
+  statementTimeout: "all-statements",
+  transactionDeadline: "cancel-running-statements"
+});
+var NUMERIC_ARRAY_OID = 1231;
+var TEXT_ARRAY_OID = 1009;
+var EXACT_TYPES = {
+  getTypeParser(oid, format) {
+    if (oid === NUMERIC_ARRAY_OID && (format === undefined || format === "text")) {
+      return driverTypeParser(TEXT_ARRAY_OID, "text");
+    }
+    return driverTypeParser(oid, format);
+  }
+};
+var driverTypeParser = pg.types.getTypeParser;
 function pgAdapter(options) {
   const usePrepared = options?.preparedStatements ?? false;
-  const statementNames = createStatementNameCache({ max: options?.stmtCacheMax ?? 1000 });
+  const stmtCacheMax = options?.stmtCacheMax ?? 1000;
   let pool = null;
   let ownsPool = false;
   let rawSession = null;
+  let rawSessionUnguard = null;
   function getPool() {
     if (pool !== null)
       return pool;
@@ -214,12 +468,24 @@ function pgAdapter(options) {
     }
     const PoolCtor = pg.Pool;
     pool = new PoolCtor(config);
+    pool.on?.("error", () => {});
     ownsPool = true;
     return pool;
   }
+  function statementNamesFor(params) {
+    const existing = POOL_STATEMENT_NAMES.get(params.pool);
+    if (existing !== undefined)
+      return existing;
+    const created = createStatementNameCache({ max: stmtCacheMax });
+    POOL_STATEMENT_NAMES.set(params.pool, created);
+    return created;
+  }
   function buildQueryConfig(params) {
     const values = serializeParams({ values: params.values });
-    return usePrepared ? { name: statementNames.getName({ text: params.text }), text: params.text, values } : { text: params.text, values };
+    if (!usePrepared)
+      return { text: params.text, values, types: EXACT_TYPES };
+    const name = statementNamesFor({ pool: getPool() }).getName({ text: params.text });
+    return name === undefined ? { text: params.text, values, types: EXACT_TYPES } : { name, text: params.text, values, types: EXACT_TYPES };
   }
   async function runExecute(params) {
     const config = buildQueryConfig({ text: params.text, values: params.values });
@@ -228,35 +494,46 @@ function pgAdapter(options) {
   }
   async function runExecuteUnsafe(params) {
     const values = params.values === undefined ? undefined : serializeParamsRaw({ values: params.values });
-    const result = await runMapped(() => params.queryable.query({ text: params.text, values }));
+    const result = await runMapped(() => params.queryable.query({ text: params.text, values, types: EXACT_TYPES }));
     return { rows: result.rows, affectedRows: result.rowCount ?? 0 };
   }
   function createClientAdapter(params) {
-    const { client, savepointCounter } = params;
+    const { client, scope, budget } = params;
+    async function applyEngineBudget() {
+      const ms = engineStatementBudgetMs({ budget });
+      if (ms === null)
+        return;
+      await runMapped(() => client.query({ text: statementTimeoutStatement({ timeout: ms }) }));
+    }
     return {
       dialect: DIALECT,
       provider: PROVIDER,
       wire: WIRE,
+      budgets: BUDGETS,
       async execute(execParams) {
+        const turn = scopeTurn({ scope });
+        if (turn !== undefined)
+          await turn;
+        budget.assertUsable({ stage: "statement" });
+        await applyEngineBudget();
         return runExecute({ queryable: client, ...execParams });
       },
       async executeUnsafe(execParams) {
+        const turn = scopeTurn({ scope });
+        if (turn !== undefined)
+          await turn;
+        budget.assertUsable({ stage: "statement" });
+        await applyEngineBudget();
         return runExecuteUnsafe({ queryable: client, ...execParams });
       },
       async transaction(fn, nestedOptions) {
         refuseNestedTransactionOptions({ options: nestedOptions, provider: PROVIDER });
-        const savepoint = nextSavepointName({ counter: savepointCounter });
-        await runMapped(() => client.query({ text: `SAVEPOINT ${savepoint}` }));
-        try {
-          const result = await fn(createClientAdapter({ client, savepointCounter }));
-          await runMapped(() => client.query({ text: `RELEASE SAVEPOINT ${savepoint}` }));
-          return result;
-        } catch (error) {
-          try {
-            await client.query({ text: `ROLLBACK TO SAVEPOINT ${savepoint}` });
-          } catch {}
-          throw error;
-        }
+        budget.assertUsable({ stage: "nested" });
+        return runNestedSavepoint({
+          scope,
+          execute: (statement) => runMapped(() => client.query({ text: statement })),
+          body: (child) => fn(createClientAdapter({ client, scope: child, budget }))
+        });
       },
       async connect() {},
       async disconnect() {},
@@ -269,6 +546,7 @@ function pgAdapter(options) {
     dialect: DIALECT,
     provider: PROVIDER,
     wire: WIRE,
+    budgets: BUDGETS,
     async execute(params) {
       return runExecute({ queryable: getPool(), ...params });
     },
@@ -277,10 +555,13 @@ function pgAdapter(options) {
       if (rawSession !== null) {
         if (control === "close") {
           const session = rawSession;
+          const unguard = rawSessionUnguard;
           rawSession = null;
+          rawSessionUnguard = null;
           try {
             return await runExecuteUnsafe({ queryable: session, ...params });
           } finally {
+            unguard?.();
             session.release();
           }
         }
@@ -288,11 +569,14 @@ function pgAdapter(options) {
       }
       if (control === "open") {
         const client = await runMapped(() => getPool().connect());
+        const unguard = guardBackgroundErrors({ client });
         try {
           const result = await runExecuteUnsafe({ queryable: client, ...params });
           rawSession = client;
+          rawSessionUnguard = unguard;
           return result;
         } catch (error) {
+          unguard();
           client.release();
           throw error;
         }
@@ -300,24 +584,49 @@ function pgAdapter(options) {
       return runExecuteUnsafe({ queryable: getPool(), ...params });
     },
     async transaction(fn, transactionOptions) {
+      validateTransactionDeadline({
+        options: transactionOptions,
+        support: BUDGETS.transactionDeadline,
+        provider: PROVIDER
+      });
       const client = await runMapped(() => getPool().connect());
-      const savepointCounter = createSavepointCounter();
+      const unguard = guardBackgroundErrors({ client });
+      const scope = createSavepointScope();
+      const budget = startTransactionBudget({ options: transactionOptions, provider: PROVIDER });
+      let discard = false;
       try {
         await runMapped(() => client.query({ text: beginStatement({ isolationLevel: transactionOptions?.isolationLevel }) }));
         if (transactionOptions?.timeout !== undefined) {
           const text = statementTimeoutStatement({ timeout: transactionOptions.timeout });
           await runMapped(() => client.query({ text }));
         }
-        const result = await fn(createClientAdapter({ client, savepointCounter }));
+        const result = await runRootScope({
+          scope,
+          body: () => fn(createClientAdapter({ client, scope, budget }))
+        });
+        budget.assertUsable({ stage: "commit" });
         await runMapped(() => client.query({ text: "COMMIT" }));
+        budget.close({ outcome: "committed" });
         return result;
       } catch (error) {
         try {
           await client.query({ text: "ROLLBACK" });
-        } catch {}
+          budget.close({ outcome: "rolled-back" });
+        } catch {
+          discard = true;
+          budget.close({ outcome: "unknown" });
+          if (budget.totalMs !== null && isTransactionDeadlineError(error)) {
+            throw transactionOutcomeUnknownError({
+              provider: PROVIDER,
+              totalMs: budget.totalMs,
+              cause: error
+            });
+          }
+        }
         throw error;
       } finally {
-        client.release();
+        unguard();
+        client.release(discard);
       }
     },
     async connect() {
@@ -327,10 +636,13 @@ function pgAdapter(options) {
     async disconnect() {
       if (rawSession !== null) {
         const session = rawSession;
+        const unguard = rawSessionUnguard;
         rawSession = null;
+        rawSessionUnguard = null;
         try {
           await session.query({ text: "ROLLBACK" });
         } catch {}
+        unguard?.();
         session.release();
       }
       if (pool !== null && ownsPool) {
@@ -345,7 +657,12 @@ function pgAdapter(options) {
   };
 }
 export {
+  validateTransactionDeadline,
+  transactionOutcomeUnknownError,
+  transactionDeadlineError,
+  transactionClosedError,
   statementTimeoutStatement,
+  startTransactionBudget,
   serializeParamsRaw,
   serializeParams,
   refuseNestedTransactionOptions,
@@ -353,6 +670,8 @@ export {
   pgAdapter,
   nextSavepointName,
   mapPgDriverError,
+  isTransactionDeadlineError,
+  engineStatementBudgetMs,
   createStatementNameCache,
   createSavepointCounter,
   classifyRawTransactionControl,
@@ -360,7 +679,8 @@ export {
   PgArrayParam,
   PG_SQLSTATE_REASONS,
   PG_SQLSTATE_ERROR_CODES,
-  ISOLATION_LEVEL_SQL
+  ISOLATION_LEVEL_SQL,
+  DEFAULT_DEADLINE_CLOCK
 };
 
-//# debugId=7F872087B9FB07A764756E2164756E21
+//# debugId=17E44C1AF7E3C0D164756E2164756E21