sova-auth 0.1.8

Fortify-style authentication for Sova (register, 2FA, reset, roles)
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

//! Mail helpers for verify / reset ([`Mailable`](sova_mail::Mailable) + templates).

use sova_core::{Request, Result};
use sova_mail::{Content, Envelope, MailExt, Mailable};
#[cfg(feature = "templates")]
use serde_json::json;

/// Email-verification message.
pub struct VerifyEmailMail {
    pub link: String,
    /// Prefer MiniJinja `mail/verify.html` when Templates is installed.
    pub(crate) prefer_view: bool,
}

impl VerifyEmailMail {
    pub fn new(link: impl Into<String>) -> Self {
        Self {
            link: link.into(),
            prefer_view: true,
        }
    }
}

impl Mailable for VerifyEmailMail {
    fn envelope(&self) -> Envelope {
        Envelope::new("Verify your email")
    }

    fn content(&self) -> Content {
        let text = format!("Verify your email:\n\n{}\n", self.link);
        let html = format!(
            "<p>Verify your email:</p><p><a href=\"{0}\">{0}</a></p>",
            self.link
        );
        #[cfg(feature = "templates")]
        if self.prefer_view {
            return Content::view_with_text(
                "mail/verify.html",
                json!({ "link": self.link }),
                text,
            );
        }
        Content::html_with_text(html, text)
    }
}

/// Password-reset message.
pub struct ResetPasswordMail {
    pub link: String,
    pub(crate) prefer_view: bool,
}

impl ResetPasswordMail {
    pub fn new(link: impl Into<String>) -> Self {
        Self {
            link: link.into(),
            prefer_view: true,
        }
    }
}

impl Mailable for ResetPasswordMail {
    fn envelope(&self) -> Envelope {
        Envelope::new("Reset your password")
    }

    fn content(&self) -> Content {
        let text = format!("Reset your password:\n\n{}\n", self.link);
        let html = format!(
            "<p>Reset your password:</p><p><a href=\"{0}\">{0}</a></p>",
            self.link
        );
        #[cfg(feature = "templates")]
        if self.prefer_view {
            return Content::view_with_text(
                "mail/reset.html",
                json!({ "link": self.link }),
                text,
            );
        }
        Content::html_with_text(html, text)
    }
}

fn templates_ready(req: &Request) -> bool {
    #[cfg(feature = "templates")]
    {
        req.try_state::<sova_templates::MiniJinjaTemplates>()
            .is_some()
    }
    #[cfg(not(feature = "templates"))]
    {
        let _ = req;
        false
    }
}

pub async fn send_verify(req: &Request, to: &str, link: &str) -> Result<()> {
    let mut mail = VerifyEmailMail::new(link);
    mail.prefer_view = templates_ready(req);
    req.mail().to(to).send_mail(mail).await
}

pub async fn send_reset(req: &Request, to: &str, link: &str) -> Result<()> {
    let mut mail = ResetPasswordMail::new(link);
    mail.prefer_view = templates_ready(req);
    req.mail().to(to).send_mail(mail).await
}