bevy_stdb_auth 0.1.0

A Bevy-native integration for the SpacetimeAuth issuer.
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

use thiserror::Error;

/// An error returned when an authentication command cannot be accepted.
#[derive(Clone, Debug, Eq, Error, PartialEq)]
pub enum StdbAuthCommandError {
    /// Another authentication operation is already pending.
    #[error("another authentication operation is already pending")]
    PendingOperation,
    /// No authentication session is active.
    #[error("no authentication session is active")]
    NoSession,
    /// No authentication operation is pending.
    #[error("no authentication operation is pending")]
    NoPendingOperation,
    /// The active session cannot be refreshed.
    #[error("the active authentication session cannot be refreshed")]
    MissingRefreshToken,
    /// The active session does not include a client ID.
    #[error("the active authentication session does not include a client ID")]
    MissingClientId,
    /// The command is not supported by the active authentication source.
    #[error("unsupported authentication command: {0}")]
    Unsupported(String),
}

/// An authentication lifecycle error.
#[derive(Debug, Error)]
pub enum StdbAuthError {
    /// An authentication command could not be accepted.
    #[error("auth command rejected: {0}")]
    Command(#[from] StdbAuthCommandError),
    /// An HTTP request failed.
    #[error("auth HTTP request failed: {0}")]
    Http(#[from] reqwest::Error),
    /// A JSON payload failed to decode.
    #[error("auth response decode failed: {0}")]
    Decode(#[from] serde_json::Error),
    /// The requested operation timed out.
    #[error("auth operation timed out")]
    Timeout,
    /// The authentication configuration is invalid.
    #[error("invalid auth configuration: {0}")]
    InvalidConfig(String),
    /// A token endpoint response is invalid.
    #[error("invalid token response: {0}")]
    InvalidTokenResponse(String),
    /// An OIDC callback URL is invalid.
    #[error("invalid OIDC callback: {0}")]
    InvalidOidcCallback(String),
    /// The authentication provider returned an error.
    #[error("auth provider error: {0}")]
    Provider(String),
    /// The requested operation is not supported by the current auth source.
    #[error("unsupported auth operation: {0}")]
    Unsupported(String),
    /// An internal authentication operation failed.
    #[error("auth operation failed: {0}")]
    Internal(String),
}

#[cfg(test)]
mod tests {
    use super::*;

    #[test]
    fn command_error_converts_to_auth_error() {
        let error = StdbAuthError::from(StdbAuthCommandError::NoSession);

        assert!(matches!(
            error,
            StdbAuthError::Command(StdbAuthCommandError::NoSession)
        ));
    }
}