seria 0.0.2-dev.2

A lightweight Revolt client library built for the Rust ecosystem.
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

use {
    reqwest::{Error as ReqwestError, Response},
    serde::Deserialize,
    std::result::Result as StdResult,
    thiserror::Error,
    tokio_tungstenite::tungstenite::Error as WebSocketError,
};

pub type SeriaResult<T = (), E = SeriaError> = StdResult<T, E>;

/// Top-level error type for all operations within the `seria` crate.
#[derive(Debug, Error)]
pub enum SeriaError {
    /// Network or HTTP-related error via `reqwest`.
    #[error("HTTP error: {0}")]
    Http(#[from] ReqwestError),

    /// Received a response with a non-success status code.
    #[error("Request failed with non-success status: {0:?}")]
    FailedRequest(Response),

    /// WebSocket-level error.
    #[error("WebSocket error: {0}")]
    WebSocket(#[from] WebSocketError),

    /// Error encountered during authentication with the Revolt API.
    #[error("Authentication failure: {0}")]
    Auth(#[from] AuthError),

    /// Any other unknown or uncategorized error.
    #[error("Unhandled error: {0}")]
    Other(String),
}

/// Authentication-specific errors encountered during login or token validation.
#[derive(Debug, Error, Deserialize, Clone, Copy, PartialEq)]
pub enum AuthError {
    /// Generic fallback error.
    #[error("Uncategorized authentication error")]
    LabelMe,

    /// Internal issue on the server side.
    #[error("Server encountered an internal error")]
    InternalError,

    /// Provided token is invalid or expired.
    #[error("Invalid session token")]
    InvalidSession,

    #[error("Invalid username")]
    OnboardingNotFinished,

    /// Attempted to authenticate while already authenticated.
    #[error("Session already active")]
    AlreadyAuthenticated,
}