Struct Mail 

pub struct Mail {
    pub to: String,
    pub subject: String,
    pub text_body: String,
    pub html_body: Option<String>,
    pub headers: Vec<(String, String)>,
}

One outbound message. Plaintext body is required; HTML is optional. Extra headers are project-controlled.

Fields

to: String

subject: String

text_body: String

html_body: Option<String>

headers: Vec<(String, String)>

Implementations

impl Mail

pub fn framework_envelope( to: impl Into<String>, subject: impl Into<String>, body: impl Into<String>, system_name: &str, request_ip: Option<&str>, ua_summary: Option<&str>, when: DateTime<Utc>, ) -> Self

Build a message with the framework’s canonical security envelope appended to the plaintext body. Used by recovery flows so every framework-emitted email carries the same “where, when, what, who” context — anti-phishing parity.

system_name should be the project’s SiteBranding::site_header (the human label of the install); request_ip and ua_summary are best-effort context lifted from the triggering request.

pub fn with_html(self, html: impl Into<String>) -> Self

Builder: attach a rendered HTML body alongside the existing plaintext. The mailer transport sends both as a multipart/alternative MIME tree; clients pick whichever part they prefer. Plaintext stays the source of truth — the HTML is a polished alternative, not a replacement.

Trait Implementations

impl Clone for Mail

fn clone(&self) -> Mail

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Mail

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

Formats the value using the given formatter.