Struct Envelope 

pub struct Envelope {
    pub id: Uuid,
    pub source: String,
    pub correlation_id: Option<Uuid>,
    pub timestamp: DateTime<Utc>,
    pub message: Message,
}

An envelope wraps a Message with provenance metadata.

Every message routed through the bus is wrapped in an Envelope. The metadata fields make the bus auditable and enable future capability checks.

Fields

id: Uuid

Unique identifier of this envelope.

source: String

Source module / subsystem name.

correlation_id: Option<Uuid>

Optional correlation id to tie a command to its response event.

timestamp: DateTime<Utc>

Time the envelope was created.

message: Message

The actual message payload.

Implementations

impl Envelope

pub fn new(source: impl Into<String>, message: Message) -> Self

Wrap a Message in a new envelope tagged with the given source.

pub fn with_correlation_id(self, correlation_id: Uuid) -> Self

Builder helper to attach a correlation id.

Trait Implementations

impl Clone for Envelope

fn clone(&self) -> Envelope

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Envelope

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for Envelope

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for Envelope

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

where __S: Serializer,

Serialize this value into the given Serde serializer.