Struct DeadLetter 

pub struct DeadLetter {
    pub event_name: &'static str,
    pub subscription_id: SubscriptionId,
    pub attempts: usize,
    pub error: String,
    pub event: Arc<dyn Any + Send + Sync>,
    pub failed_at: SystemTime,
    pub listener_name: Option<&'static str>,
}

A dead-letter record emitted when a handler exhausts all retry attempts.

The original error is stored as a String rather than a typed error because DeadLetter must be Clone (it is published as an event) and Box<dyn Error> does not implement Clone. Use error for diagnostics or pattern-match on the stringified message.

The original event payload is available via event as a type-erased Arc. Consumers can call dead_letter.event.downcast_ref::<OriginalEvent>() to inspect the payload that caused the failure.

Fields

event_name: &'static str

The type_name of the event that failed.

subscription_id: SubscriptionId

The subscription that failed to handle the event.

attempts: usize

Total number of attempts (initial + retries).

error: String

Stringified error from the last failed attempt.

event: Arc<dyn Any + Send + Sync>

The original event payload, type-erased.

Use downcast_ref::<E>() to recover the concrete event type.

failed_at: SystemTime

When the terminal failure occurred.

listener_name: Option<&'static str>

Human-readable name of the listener that failed, if provided.

Trait Implementations

impl Clone for DeadLetter

fn clone(&self) -> DeadLetter

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for DeadLetter

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

Formats the value using the given formatter.