xbox 0.2.0

Unofficial Xbox Live authentication, gamertag/XUID resolution, and profile client for Rust.
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

use std::sync::Arc;

use thiserror::Error;

/// Errors produced by this crate.
#[derive(Debug, Clone, Error)]
pub enum XboxError {
    /// An HTTP request completed but returned a non-2xx status.
    #[error("http request to {url} failed with status {status}")]
    HttpStatus {
        url: String,
        status: reqwest::StatusCode,
    },

    /// The underlying HTTP request itself failed (connection, timeout, decode, ...).
    #[error("network error: {0}")]
    Network(Arc<reqwest::Error>),

    /// No Xbox Live user matching the given gamertag was found.
    #[error("no Xbox Live user found matching gamertag \"{0}\"")]
    PersonNotFound(String),

    /// Failed to locate the PPFT hidden form field in the Microsoft login page.
    #[cfg(feature = "legacy-password-login")]
    #[error("failed to parse PPFT token from Microsoft login page")]
    PpftNotFound,

    /// Failed to locate the login POST URL in the Microsoft login page.
    #[cfg(feature = "legacy-password-login")]
    #[error("failed to parse login post URL from Microsoft login page")]
    PostUrlNotFound,

    /// Microsoft rejected the supplied username or password.
    #[cfg(feature = "legacy-password-login")]
    #[error("invalid Microsoft account username or password")]
    InvalidCredentials,

    /// The login redirect response was missing a `Location` header.
    #[cfg(feature = "legacy-password-login")]
    #[error("login redirect response was missing a Location header")]
    MissingRedirectLocation,

    /// Failed to extract the RPS ticket (`access_token=...`) from the login redirect URL.
    #[cfg(feature = "legacy-password-login")]
    #[error("failed to extract access token from login redirect URL")]
    RpsTicketNotFound,
}

impl From<reqwest::Error> for XboxError {
    fn from(err: reqwest::Error) -> Self {
        XboxError::Network(Arc::new(err))
    }
}

impl XboxError {
    /// Whether this error represents an HTTP 401 (Unauthorized) response,
    /// indicating a cached credential has expired or been revoked server-side.
    pub fn is_unauthorized(&self) -> bool {
        matches!(
            self,
            XboxError::HttpStatus { status, .. } if *status == reqwest::StatusCode::UNAUTHORIZED
        )
    }
}