Struct Message

pub struct Message {
    pub id: Uuid,
    pub from_peer: String,
    pub to_peer: String,
    pub topic: String,
    pub payload: Value,
    pub sent_at: DateTime<Utc>,
    pub read_at: Option<DateTime<Utc>>,
}

Represents a mail message stored in the mailbox.

Definition

Message is a data structure that models a single mail exchange between two peers. It contains a unique identifier, sender and recipient identifiers, a topic string, a JSON payload, and timestamps for when the message was sent and optionally when it was read.

Implementation Details

• id is a Uuid generated by the caller to guarantee global uniqueness.
• payload uses serde_json::Value so arbitrary JSON can be attached to the message.
• sent_at and read_at are stored as chrono::DateTime<Utc> to provide timezone‑agnostic timestamps.

Rationale

This struct provides a lightweight, serialisable representation of a message that can be persisted in the SQLite‑backed mailbox (see Mailbox). Keeping the payload as JSON allows different subsystems of the CHORUS platform to embed domain‑specific data without requiring a rigid schema.

Fields

id: Uuid

Globally unique identifier for the message.

from_peer: String

Identifier of the sending peer.

to_peer: String

Identifier of the receiving peer.

topic: String

Topic or channel of the message; used for routing/filters.

payload: Value

Arbitrary JSON payload containing the message body.

sent_at: DateTime<Utc>

Timestamp (UTC) when the message was sent.

read_at: Option<DateTime<Utc>>

Optional timestamp (UTC) when the recipient read the message.

Trait Implementations

impl Clone for Message

fn clone(&self) -> Message

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for Message

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for Message

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for Message

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

where __S: Serializer,

Serialize this value into the given Serde serializer.