Struct SqlxTransactionCompanion 

pub struct SqlxTransactionCompanion<C = PostcardCodec>
where
    C: CacheCodec,
{ /* private fields */ }

SQLx transaction companion.

The companion begins a transaction, gives user code explicit access to the SQLx transaction and an invalidation collector, then either enqueues durable outbox rows before commit or applies local-only invalidation after commit.

Implementations

impl<C> SqlxTransactionCompanion<C>

where C: CacheCodec,

pub fn new(queries: DbCache<C>) -> Self

Create a companion for the given query cache namespace.

pub fn with_outbox(self, outbox: SqlxInvalidationOutbox) -> Self

Attach a durable SQLx invalidation outbox.

pub fn diagnostics(&self) -> SqlxTransactionDiagnostics

Return transaction companion diagnostics.

pub async fn sqlite_durable<F, E>( &self, pool: &SqlitePool, reason: impl Into<String>, body: F, ) -> TransactionResult<SqlxTransactionReport, E>

where F: for<'tx> FnOnce(&'tx mut Transaction<'_, Sqlite>, &'tx mut InvalidationCollector) -> SqlxTransactionFuture<'tx, E> + Send, E: Error + Send + Sync + 'static,

Execute a SQLite transaction and enqueue invalidation intent before commit.

pub async fn sqlite_local<F, E>( &self, pool: &SqlitePool, reason: impl Into<String>, body: F, ) -> TransactionResult<SqlxTransactionReport, E>

where F: for<'tx> FnOnce(&'tx mut Transaction<'_, Sqlite>, &'tx mut InvalidationCollector) -> SqlxTransactionFuture<'tx, E> + Send, E: Error + Send + Sync + 'static,

Execute a SQLite transaction and apply invalidation directly after commit.

This mode is intentionally non-durable. It is useful for local demos and single-process tests, while production writes should use SqlxTransactionCompanion::sqlite_durable.

Trait Implementations

impl<C> Clone for SqlxTransactionCompanion<C>

where C: CacheCodec,

fn clone(&self) -> Self

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl<C> Debug for SqlxTransactionCompanion<C>

where C: CacheCodec + Debug,

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

Formats the value using the given formatter.