Struct MailConfig 

pub struct MailConfig {
    pub driver: MailDriver,
    pub from: String,
    pub from_name: Option<String>,
    pub smtp: Option<SmtpConfig>,
    pub resend: Option<ResendConfig>,
}

Mail configuration supporting multiple drivers.

Fields

driver: MailDriver

Which driver to use.

from: String

Default from address (shared across all drivers).

from_name: Option<String>

Default from name (shared across all drivers).

smtp: Option<SmtpConfig>

SMTP-specific config (only when driver = Smtp).

resend: Option<ResendConfig>

Resend-specific config (only when driver = Resend).

Implementations

impl MailConfig

pub fn new(host: impl Into<String>, port: u16, from: impl Into<String>) -> Self

Create a new SMTP mail config (backwards compatible).

pub fn resend(api_key: impl Into<String>, from: impl Into<String>) -> Self

Create a new Resend mail config.

pub fn from_env() -> Option<Self>

Create mail configuration from environment variables.

Returns None if required variables are missing.

Reads the following environment variables:

• MAIL_DRIVER: “smtp” (default) or “resend”
• MAIL_FROM_ADDRESS: Default from email address (required for all drivers)
• MAIL_FROM_NAME: Default from name (optional)

SMTP driver variables:

• MAIL_HOST: SMTP server host (required)
• MAIL_PORT: SMTP server port (default: 587)
• MAIL_USERNAME: SMTP username (optional)
• MAIL_PASSWORD: SMTP password (optional)
• MAIL_ENCRYPTION: “tls” or “none” (default: “tls”)

Resend driver variables:

• RESEND_API_KEY: Resend API key (required)

Example

use ferro_notifications::MailConfig;

if let Some(config) = MailConfig::from_env() {
    // Mail is configured
}

pub fn credentials( self, username: impl Into<String>, password: impl Into<String>, ) -> Self

Set SMTP credentials.

No-ops with a warning when the driver is not MailDriver::Smtp — calling credentials(...) on a Resend config is almost certainly a caller mistake and should not silently mutate the config into an SMTP shape.

pub fn from_name(self, name: impl Into<String>) -> Self

Set the from name.

pub fn no_tls(self) -> Self

Disable TLS (SMTP only).

Trait Implementations

impl Clone for MailConfig

fn clone(&self) -> MailConfig

Returns a duplicate of the value.

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

Performs copy-assignment from source.