Struct Envelope 

pub struct Envelope<E: Event> { /* private fields */ }

Event plus metadata used by the broker for routing and observability.

• event: the user-defined payload implementing Event.
• meta: Meta describing who emitted the event and when. Includes actor_name and optional correlation_id for linking related events.

Implementations

impl<E: Event> Envelope<E>

pub fn new(event: E, actor_id: ActorId) -> Self

Create a new envelope tagging the event with the given actor name.

pub fn with_correlation( event: E, actor_id: ActorId, correlation_id: EventId, ) -> Self

Create a new envelope with an explicit correlation id.

Use this to link child events to a parent or to group related flows.

pub fn event(&self) -> &E

Returns a reference to the event payload.

This is a convenience method for pattern matching. For method calls, you can also use Deref (e.g., envelope.some_event_method()).

Example

match envelope.event() {
    MyEvent::Foo(x) => handle_foo(x),
    MyEvent::Bar => handle_bar(),
}

pub fn meta(&self) -> &Meta

pub fn id(&self) -> EventId

Trait Implementations

impl<E: Clone + Event> Clone for Envelope<E>

fn clone(&self) -> Envelope<E>

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl<E: Event + Debug> Debug for Envelope<E>

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

Formats the value using the given formatter.

impl<E: Event> Deref for Envelope<E>

type Target = E

The resulting type after dereferencing.

fn deref(&self) -> &E

Dereferences the value.

impl<E: Event> From<(&E, &Meta)> for Envelope<E>

fn from((event, meta): (&E, &Meta)) -> Self

Converts to this type from the input type.