missive 0.7.0

Compose, deliver, preview, and test emails in Rust - pluggable providers with zero configuration code
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126

#![cfg(feature = "full")]

use missive::providers::TlsMode;
use missive::{EmailClient, MailerConfig, ResendConfig};
use std::collections::HashMap;

fn env(pairs: &[(&str, &str)]) -> impl FnMut(&str) -> Option<String> {
    let vars: HashMap<String, String> = pairs
        .iter()
        .map(|(key, value)| ((*key).to_string(), (*value).to_string()))
        .collect();

    move |key| vars.get(key).cloned()
}

#[test]
fn resend_config_validates_required_api_key() {
    let error = ResendConfig::new("").unwrap_err();

    assert!(error.to_string().contains("RESEND_API_KEY"));
}

#[test]
fn mailer_config_from_env_prefers_explicit_provider() {
    let config = MailerConfig::from_env_with(env(&[
        ("EMAIL_PROVIDER", "sendgrid"),
        ("RESEND_API_KEY", "re_123"),
        ("SENDGRID_API_KEY", "sg_123"),
    ]))
    .unwrap();

    assert_eq!(config.provider_name(), "sendgrid");
}

#[test]
fn mailer_config_from_env_documents_auto_detection_order() {
    let config = MailerConfig::from_env_with(env(&[
        ("RESEND_API_KEY", "re_123"),
        ("SENDGRID_API_KEY", "sg_123"),
    ]))
    .unwrap();

    assert_eq!(config.provider_name(), "resend");
}

#[test]
fn mailer_config_from_env_accepts_explicit_mailjet_provider() {
    let config = MailerConfig::from_env_with(env(&[
        ("EMAIL_PROVIDER", "mailjet"),
        ("MAILJET_API_KEY", "mj_api"),
        ("MAILJET_SECRET_KEY", "mj_secret"),
    ]))
    .unwrap();

    assert_eq!(config.provider_name(), "mailjet");
}

#[test]
fn mailer_config_from_env_auto_detects_mailjet_credentials() {
    let config = MailerConfig::from_env_with(env(&[
        ("MAILJET_API_KEY", "mj_api"),
        ("MAILJET_SECRET_KEY", "mj_secret"),
    ]))
    .unwrap();

    assert_eq!(config.provider_name(), "mailjet");
}

#[test]
fn mailer_config_from_env_requires_mailjet_secret_key() {
    let error = MailerConfig::from_env_with(env(&[
        ("EMAIL_PROVIDER", "mailjet"),
        ("MAILJET_API_KEY", "mj_api"),
    ]))
    .unwrap_err();

    assert!(error.to_string().contains("MAILJET_SECRET_KEY"));
}

#[test]
fn smtp_config_from_env_parses_tls_mode() {
    let config = MailerConfig::from_env_with(env(&[
        ("EMAIL_PROVIDER", "smtp"),
        ("SMTP_HOST", "smtp.example.com"),
        ("SMTP_TLS", "none"),
    ]))
    .unwrap();

    if let MailerConfig::Smtp(config) = config {
        assert_eq!(config.tls, TlsMode::None);
    } else {
        panic!("expected smtp config");
    }
}

#[test]
fn smtp_config_from_env_rejects_opportunistic_tls() {
    let error = MailerConfig::from_env_with(env(&[
        ("EMAIL_PROVIDER", "smtp"),
        ("SMTP_HOST", "smtp.example.com"),
        ("SMTP_TLS", "opportunistic"),
    ]))
    .unwrap_err();

    assert!(error.to_string().contains("silently downgrade TLS"));
}

#[test]
fn email_client_from_env_with_is_testable_without_process_env_mutation() {
    let client = EmailClient::from_env_with(env(&[
        ("EMAIL_PROVIDER", "local"),
        ("EMAIL_FROM", "noreply@example.com"),
    ]))
    .unwrap();

    assert_eq!(client.mailer().provider_name(), "local");
}

#[test]
fn local_env_mailer_does_not_publish_global_preview_storage() {
    let _mailer = MailerConfig::Local.into_mailer().unwrap();

    #[allow(deprecated)]
    let storage = missive::local_storage();
    assert!(storage.is_none());
}