Enum MailError 

pub enum MailError {
    Unauthorized,
    DomainNotVerified {
        domain: String,
    },
    Invalid {
        detail: String,
    },
    RateLimited {
        retry_after: Option<Duration>,
    },
    Upstream(String),
    Transport(String),
}

Mailer failures, mapped by the adapter from provider responses.

Every variant that carries provider text is sanitized in Display, the same way DbError’s is (issue #235). “Never includes the API key” was too weak a promise: the text an adapter wraps is the provider’s own response, and a 422 from Resend quotes the field it objected to — which for a send is the recipient address. Display therefore runs it through crate::logging::scrub_text, so every tracing field, problem detail, report line and format! that renders a MailError gets the sanitized text rather than each call site remembering to. Debug still shows the raw string for tests; the logging formatters scrub {:?} output too.

Variants

Unauthorized

The API key is missing, wrong or revoked.

DomainNotVerified

The sending domain is not verified with the provider, so nothing from it will be accepted until somebody adds the DNS records.

Fields

domain: String

Invalid

The provider refused the message itself. detail is its wording, so it can quote the recipient — see the type docs.

Fields

detail: String

RateLimited

Too many sends; retry no earlier than retry_after when the provider named one.

Fields

retry_after: Option<Duration>

Upstream(String)

The provider failed on its side (a 5xx, an unparseable body).

Transport(String)

The request never got an answer: a socket, a DNS failure, a timeout.

Trait Implementations

impl Clone for MailError

fn clone(&self) -> MailError

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for MailError

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

Formats the value using the given formatter.

impl Display for MailError

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

Formats the value using the given formatter.

impl Eq for MailError

impl Error for MailError

fn source(&self) -> Option<&(dyn Error + 'static)>

Returns the lower-level source of this error, if any.

fn description(&self) -> &str

👎Deprecated since 1.42.0:

use the Display impl or to_string()

fn cause(&self) -> Option<&dyn Error>

👎Deprecated since 1.33.0:

replaced by Error::source, which can support downcasting

fn provide<'a>(&'a self, request: &mut Request<'a>)

🔬This is a nightly-only experimental API. (error_generic_member_access)

Provides type-based access to context intended for error reports.

impl PartialEq for MailError

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

Equality operator ==.

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

Inequality operator !=.

impl StructuralPartialEq for MailError