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

//! Authentication Flow interface

use futures::Future as StdFuture;
use hyper::client::connect::Connect;
use url::form_urlencoded;

use Future;
use Modio;
use ModioMessage;

/// Various forms of authentication credentials supported by [mod.io](https://mod.io).
#[derive(Clone, Debug, PartialEq)]
pub enum Credentials {
    ApiKey(String),
    Token(String),
}

/// Authentication Flow interface to retrieve access tokens. See the [mod.io Authentication
/// docs](https://docs.mod.io/#email-authentication-flow) for more informations.
///
/// # Example
/// ```no_run
/// extern crate modio;
/// extern crate tokio;
///
/// use std::io::{self, Write};
/// use tokio::runtime::Runtime;
///
/// use modio::error::Error;
/// use modio::{Credentials, Modio};
///
/// fn prompt(prompt: &str) -> io::Result<String> {
///     print!("{}", prompt);
///     io::stdout().flush()?;
///     let mut buffer = String::new();
///     io::stdin().read_line(&mut buffer)?;
///     Ok(buffer.trim().to_string())
/// }
///
/// fn main() -> Result<(), Error> {
///     let mut rt = Runtime::new()?;
///     let modio = Modio::new(
///         "user-agent-name/1.0",
///         Credentials::ApiKey(String::from("api-key")),
///     );
///
///     let email = prompt("Enter email: ")?;
///     rt.block_on(modio.auth().request_code(&email))?;
///
///     let code = prompt("Enter security code: ")?;
///     let token = rt.block_on(modio.auth().security_code(&code))?;
///
///     // Consume the endpoint and create an endpoint with new credentials.
///     let _modio = modio.with_credentials(Credentials::Token(token));
///
///     Ok(())
/// }
/// ```
pub struct Auth<C>
where
    C: Clone + Connect + 'static,
{
    modio: Modio<C>,
}

impl<C: Clone + Connect> Auth<C> {
    pub(crate) fn new(modio: Modio<C>) -> Self {
        Self { modio }
    }

    /// Request a security code be sent to the email of the user.
    pub fn request_code(&self, email: &str) -> Future<ModioMessage> {
        let data = form_urlencoded::Serializer::new(String::new())
            .append_pair("email", email)
            .finish();
        self.modio.post("/oauth/emailrequest", data)
    }

    /// Get the access token for a security code.
    pub fn security_code(&self, code: &str) -> Future<String> {
        #[derive(Deserialize)]
        struct AccessToken {
            access_token: String,
        }

        let data = form_urlencoded::Serializer::new(String::new())
            .append_pair("security_code", code)
            .finish();

        Box::new(
            self.modio
                .post::<AccessToken, _>("/oauth/emailexchange", data)
                .map(|token| token.access_token),
        )
    }
}