Struct EntitlementWriteTransaction 

pub struct EntitlementWriteTransaction { /* private fields */ }

A top-level PostgreSQL transaction awaiting entitlement admission.

Create this transaction directly from a pool with Self::begin. It can carry host preparatory writes, but deliberately has no commit operation. Passing it to require_entitlement_for_update either rolls it back or transforms it into an AdmittedEntitlementWriteTransaction.

Implementations

impl EntitlementWriteTransaction

pub async fn begin(pool: &PgPool) -> Result<Self, Error>

Starts a top-level transaction reserved for an entitlement-protected write.

pub fn connection(&mut self) -> &mut PgConnection

Borrows the transaction connection for preparatory host database work.

Callers must finish any nested savepoint before returning this value to Syrup Rail. Leaking a savepoint would violate SQLx’s transaction lifecycle contract.

pub async fn rollback(self) -> Result<(), Error>

Explicitly rolls back the pending transaction.

Trait Implementations

impl Debug for EntitlementWriteTransaction

fn fmt(&self, formatter: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.