sofie-identity 0.2.0

Accounts, their area memberships, and signing up, in and out: the identity an app opts into.
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

use sofie::http::Next;
use sofie::prelude::*;

use crate::MemberArea;

/// `other` is a page to go to instead, linked under the form.
#[derive(ReadModel)]
pub struct FormPage {
    action: String,
    other: Option<String>,
}

impl FormPage {
    #[cfg(feature = "account-links")]
    #[cfg_attr(
        not(any(feature = "links", feature = "totp")),
        expect(
            dead_code,
            reason = "used by account links, whose users are `links` and `totp`"
        )
    )]
    pub(crate) fn new(action: String, other: Option<&'static str>) -> Self {
        Self {
            action,
            other: other.map(str::to_owned),
        }
    }
}

#[derive(ReadModel)]
pub struct SignInPage {
    action: String,
    other: Option<String>,
    by_link: Option<String>,
    passkey: Option<PasskeyForm>,
    oauth: Option<Offered>,
}

/// The options and address `engine.js` signs in with a passkey through.
#[derive(ReadModel)]
pub struct PasskeyForm {
    options: String,
    post: String,
}

#[derive(ReadModel)]
pub struct Offered {
    pub(crate) action: String,
    pub(crate) providers: Vec<Choice>,
}

#[derive(ReadModel)]
pub struct Choice {
    pub(crate) name: String,
    pub(crate) label: String,
}

pub async fn sign_in_page<A: MemberArea>(
    next: Next,
    #[cfg(feature = "passkeys")] sealing: sofie::http::Sealing,
    #[cfg(feature = "passkeys")] clock: Clock,
    #[cfg(feature = "oauth")] installed: crate::oauth::Installed,
) -> Result<SignInPage> {
    Ok(SignInPage {
        action: next.carried_by(A::SIGN_IN),
        other: A::SIGN_UP.map(|sign_up| next.carried_by(sign_up)),
        #[cfg(feature = "sign-in-links")]
        by_link: Some(crate::mailed::sign_in_link::asking::<A>()),
        #[cfg(not(feature = "sign-in-links"))]
        by_link: None,
        #[cfg(feature = "passkeys")]
        passkey: Some(PasskeyForm {
            options: crate::passkeys::sign_in_options(&sealing, &clock)?,
            post: crate::passkeys::sign_in_path::<A>(),
        }),
        #[cfg(not(feature = "passkeys"))]
        passkey: None,
        #[cfg(feature = "oauth")]
        oauth: crate::oauth::offered::<A>(&installed),
        #[cfg(not(feature = "oauth"))]
        oauth: None,
    })
}

/// `next` is carried to the form and the sign-in link, so a new member lands where it was going.
pub async fn sign_up_page<A: MemberArea>(next: Next) -> Result<FormPage> {
    Ok(FormPage {
        action: next.carried_by(A::SIGN_UP.unwrap_or(A::SIGN_IN)),
        other: Some(next.carried_by(A::SIGN_IN)),
    })
}