Struct Envelope 

pub struct Envelope {
    pub id: String,
    pub message_id: Option<String>,
    pub flags: BTreeSet<Flag>,
    pub subject: String,
    pub from: Vec<Address>,
    pub to: Vec<Address>,
    pub date: Option<DateTime<FixedOffset>>,
    pub size: u64,
    pub has_attachment: Option<bool>,
}

Lightweight summary of a message: enough to display in a list without fetching the full body.

Fields

id: String

Backend-specific identifier of the message.

IMAP UID, JMAP email ID or Maildir filename id.

message_id: Option<String>

Message-ID: header value (RFC 5322 §3.6.4), None when the header is missing or the backend did not surface it. Stable across every backend that stores the message, so sync uses it as the cross-side content key when available.

flags: BTreeSet<Flag>

Flags set on the message. Stored as a sorted set since wire order is not meaningful and duplicates are nonsensical; the derived Ord on Flag gives deterministic iteration.

subject: String

Subject header value.

from: Vec<Address>

Sender(s).

to: Vec<Address>

Primary recipient(s).

date: Option<DateTime<FixedOffset>>

Author-claimed send time, taken from the Date: header (IMAP ENVELOPE.date, JMAP sentAt, parsed Date: for Maildir).

Server-arrival timestamps (IMAP INTERNALDATE, JMAP receivedAt, filesystem mtime) are intentionally not used: Maildir mtime is rewritten by every fresh sync, and the Date: header is the only timestamp consistent across every backend. None when the header is missing or unparseable.

size: u64

Size of the raw RFC 5322 message in bytes. Free on every backend (IMAP RFC822.SIZE, JMAP size, filesystem entry size).

has_attachment: Option<bool>

Whether the message has at least one attachment, when the caller opted in. JMAP returns this for free; IMAP requires a BODYSTRUCTURE fetch; Maildir requires parsing the message body. None when not requested or when detection is not implemented for the active backend.

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 Eq for Envelope

impl PartialEq for Envelope

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

Tests for self and other values to be equal, and is used by ==.

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

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

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.

impl StructuralPartialEq for Envelope