Struct TransitionEffect 

pub struct TransitionEffect {
    pub model: String,
    pub field: String,
    pub record_id: String,
    pub from_state: String,
    pub to_state: String,
    pub idempotency_key: String,
}

Context payload delivered to an on_commit transition-effect job (issue #1973).

When a #[state_machine] edge declares on_commit = SomeJob, firing that edge via the generated transition_{field}_to_on_conn method enqueues SomeJob transactionally on the caller’s connection with an instance of this struct as its payload. Because the enqueue writes the job row inside the caller’s own transaction, a rollback drops the effect; the durable worker runs it post-commit with full AppState (at-least-once delivery).

Declare the job to receive it, deduping on the derived key so a retried transition coalesces into a single delivery:

#[job(name = "send_shipped_email", unique_by = "idempotency_key")]
async fn send_shipped_email(
    state: AppState,
    effect: TransitionEffect,
) -> AutumnResult<()> {
    // effect.model / .field / .record_id / .from_state / .to_state
    Ok(())
}

The idempotency_key is derived from (model, field, record_id, from_state, to_state), so declaring the job unique_by = "idempotency_key" gives idempotent, coalescing delivery.

Fields

model: String

The model type name whose field transitioned (e.g. "Order").

field: String

The state-machine field name that transitioned (e.g. "status").

record_id: String

The record’s primary-key value, rendered as a string.

from_state: String

The state the field moved from.

to_state: String

The state the field moved to.

idempotency_key: String

Derived dedup key: "{model}:{field}:{record_id}:{from_state}:{to_state}".

Trait Implementations

impl Clone for TransitionEffect

fn clone(&self) -> TransitionEffect

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for TransitionEffect

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for TransitionEffect

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Eq for TransitionEffect

impl PartialEq for TransitionEffect

fn eq(&self, other: &TransitionEffect) -> bool

Equality operator ==.

fn ne(&self, other: &Rhs) -> bool

Inequality operator !=.

impl Serialize for TransitionEffect

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl StructuralPartialEq for TransitionEffect