Struct EmailMessage 

pub struct EmailMessage {
    pub message_id: String,
    pub from: String,
    pub to: String,
    pub client_ip: Option<IpAddr>,
    pub helo_domain: Option<String>,
    /* private fields */
}

Represents an email message for storage operations.

Headers are stored as an ordered Vec (preserving RFC 5322 order and supporting duplicate headers such as Received). A cached raw field holds the full serialized form; call rebuild after modifying headers so that raw reflects the changes.

Fields

message_id: String

Unique message identifier, RFC 5322 message-id format.

from: String

Sender address, RFC 5322 address format.

to: String

Recipient address, RFC 5322 address format.

client_ip: Option<IpAddr>

IP address of the connecting SMTP client (for SPF verification).

helo_domain: Option<String>

HELO/EHLO domain presented by the connecting client (for SPF verification).

Implementations

impl EmailMessage

pub fn new(from: String, to: String, raw: String) -> Self

pub fn from_raw(from: &str, to: &str, raw: &str) -> Self

pub fn with_id( message_id: String, from: String, to: String, subject: String, raw: String, ) -> Self

pub fn header(&self, name: &str) -> Option<&str>

Returns the first header value matching name (case-insensitive).

pub fn subject(&self) -> &str

Returns the email subject (convenience for header("Subject")).

pub fn raw(&self) -> &str

Returns the full serialized email (headers + blank line + content).

Returns the cached Self::raw field. Call rebuild after modifying headers to ensure this is up to date.

pub fn original_raw(&self) -> &str

Returns the original raw email as received, before any transformer modifications.

Use this for byte-exact operations such as DKIM signature verification, where the original byte sequence must be preserved.

pub fn body(&self) -> &str

Returns the message body after the header section (RFC 5322 body).

pub fn has_headers(&self) -> bool

Returns whether the message has any MIME headers.

pub fn headers(&self) -> &[(String, String)]

Returns a reference to the ordered header list.

pub fn prepend_header(&mut self, name: &str, value: &str)

Prepends a header to the beginning of the header list.

The cached raw field is not updated automatically, call rebuild once after all header modifications are done (e.g. after running all transformers via [MessageTransformer::apply]).

pub fn rebuild(&mut self)

Rebuilds the cached raw field from headers and body.

Call this once after all header modifications are complete so that raw() returns the up-to-date serialized form.

Pre-computes the exact byte length, allocates once, and writes all parts via push_str.

Trait Implementations

impl Clone for EmailMessage

fn clone(&self) -> EmailMessage

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for EmailMessage

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

Formats the value using the given formatter.