Struct Metadata 

#[non_exhaustive]
pub struct Metadata {
    pub correlation: CorrelationMetadata,
    pub trace: TraceContext,
    pub routing: RoutingMetadata,
    pub delivery: DeliveryMetadata,
    pub tenant_id: Option<String>,
}

Canonical, typed framework metadata: the single source of truth. No value here is ever duplicated into Headers (ADR 0004).

use reliar_core::{CorrelationId, Envelope, Message};

#[derive(serde::Serialize, serde::Deserialize)]
struct OrderCreated;
impl Message for OrderCreated {
    const TYPE: &'static str = "orders.created";
    const VERSION: u16 = 1;
}

let envelope = Envelope::builder(OrderCreated)
    .tenant("acme")
    .correlation_id(CorrelationId::parse("checkout-42")?)
    .build();

// `Metadata` is reachable directly — it is the one place these values live.
assert_eq!(envelope.metadata.tenant_id.as_deref(), Some("acme"));
assert!(envelope.metadata.correlation.correlation_id.is_some());
// An un-correlated message roots its own conversation.
assert_eq!(envelope.metadata.correlation.conversation_id.as_uuid(), envelope.id.as_uuid());

Fields (Non-exhaustive)

Non-exhaustive structs could have additional fields added in future. Therefore, non-exhaustive structs cannot be constructed in external crates using the traditional Struct { .. } syntax; cannot be matched against without a wildcard ..; and struct update syntax will not work.

correlation: CorrelationMetadata

Correlation and conversation identity.

trace: TraceContext

W3C Trace Context, carried verbatim.

routing: RoutingMetadata

Transport-independent routing hints.

delivery: DeliveryMetadata

Serialization and delivery hints.

tenant_id: Option<String>

The owning tenant, if this deployment is multi-tenant.

Trait Implementations

impl Clone for Metadata

fn clone(&self) -> Metadata

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Metadata

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

Formats the value using the given formatter.

impl Default for Metadata

fn default() -> Metadata

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for Metadata

Available on crate feature serde only.

fn deserialize<D: Deserializer<'de>>(d: D) -> Result<Self, D::Error>

Deserialize this value from the given Serde deserializer.

impl PartialEq for Metadata

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

Equality operator ==.

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

Inequality operator !=.

impl Serialize for Metadata

Available on crate feature serde only.

fn serialize<S: Serializer>(&self, s: S) -> Result<S::Ok, S::Error>

Serialize this value into the given Serde serializer.

impl StructuralPartialEq for Metadata