Struct MessageMetadata 

pub struct MessageMetadata { /* private fields */ }

Metadata carried independently from a strongly typed message payload.

IDs are strings deliberately: applications may generate UUIDs, ULIDs, or another stable representation without forcing a generator into the core.

Implementations

impl MessageMetadata

pub fn new(id: impl Into<MessageId>, created_at: SystemTime) -> Self

Creates metadata using identity and time supplied by an application boundary. The core intentionally does not read the clock or generate IDs.

pub fn with_correlation_id( self, correlation_id: impl Into<CorrelationId>, ) -> Self

Attaches a flow correlation identity.

pub fn with_causation_id(self, causation_id: impl Into<CausationId>) -> Self

Attaches the identity of the directly causing message.

pub fn with_initiated_by(self, initiated_by: impl Into<String>) -> Self

Attaches the actor or system that initiated the flow.

pub fn with_source(self, source: impl Into<String>) -> Self

Attaches the logical source component.

pub const fn id(&self) -> &MessageId

Returns the message identity.

pub const fn created_at(&self) -> SystemTime

Returns the externally supplied creation time.

pub const fn correlation_id(&self) -> Option<&CorrelationId>

Returns the optional correlation identity.

pub const fn causation_id(&self) -> Option<&CausationId>

Returns the optional causation identity.

pub fn initiated_by(&self) -> Option<&str>

Returns the optional initiating actor.

pub fn source(&self) -> Option<&str>

Returns the optional logical source component.

Trait Implementations

impl Clone for MessageMetadata

fn clone(&self) -> MessageMetadata

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for MessageMetadata

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

Formats the value using the given formatter.

impl Eq for MessageMetadata

impl PartialEq for MessageMetadata

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

Equality operator ==.

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

Inequality operator !=.

impl StructuralPartialEq for MessageMetadata