#$transactional

#Import

1import { $transactional } from "alepha/orm";

#Overview

Middleware that wraps handler execution in a database transaction.

All Repository operations inside the handler automatically participate in the transaction - no explicit { tx } drilling required.

Nesting is safe: if the handler is already inside a transactional() block, the outer transaction is reused.

⚠️ A no-op on a driver without transactions (Cloudflare D1, PGlite): the handler runs in place, and a throw rolls nothing back. Each primitive logs one warning the first time it runs there. Code that must be correct on D1 guards its writes instead: preconditions in the WHERE, db.version(), or an order in which a failure leaves harmless state.

 1class OrderService { 2  createOrder = $action({ 3    use: [$transactional()], 4    handler: async ({ body }) => { 5      await this.orders.create(body);      // auto-uses tx 6      await this.audit.create({ ... });     // auto-uses tx 7      // throw → rollback, return → commit (not on D1: see above) 8    }, 9  });10}

#Options