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

use std::{
    error::Error as StdError,
    fmt::{Display, Formatter, Result as FmtResult},
};

use async_tungstenite::tungstenite::protocol::CloseFrame;

/// An error that occurred while attempting to deal with the gateway.
///
/// Note that - from a user standpoint - there should be no situation in which
/// you manually handle these.
#[derive(Clone, Debug)]
#[non_exhaustive]
pub enum Error {
    /// There was an error building a URL.
    BuildingUrl,
    /// The connection closed, potentially uncleanly.
    Closed(Option<CloseFrame<'static>>),
    /// Expected a Hello during a handshake
    ExpectedHello,
    /// When there was an error sending a heartbeat.
    HeartbeatFailed,
    /// When invalid authentication (a bad token) was sent in the IDENTIFY.
    InvalidAuthentication,
    /// Expected a Ready or an InvalidateSession
    InvalidHandshake,
    /// An indicator that an unknown opcode was received from the gateway.
    InvalidOpCode,
    /// When invalid sharding data was sent in the IDENTIFY.
    ///
    /// # Examples
    ///
    /// Sending a shard ID of 5 when sharding with 3 total is considered
    /// invalid.
    InvalidShardData,
    /// When no authentication was sent in the IDENTIFY.
    NoAuthentication,
    /// When a session Id was expected (for resuming), but was not present.
    NoSessionId,
    /// When a shard would have too many guilds assigned to it.
    ///
    /// # Examples
    ///
    /// When sharding 5500 guilds on 2 shards, at least one of the shards will
    /// have over the maximum number of allowed guilds per shard.
    ///
    /// This limit is currently 2500 guilds per shard.
    OverloadedShard,
    /// Failed to reconnect after a number of attempts.
    ReconnectFailure,
    /// When undocumented gateway intents are provided.
    InvalidGatewayIntents,
    /// When disallowed gatewax intents are provided.
    ///
    /// If an connection has been established but priviliged gateway intents
    /// were provided without enabling them prior.
    DisallowedGatewayIntents,
}

impl Display for Error {
    fn fmt(&self, f: &mut Formatter<'_>) -> FmtResult {
        match self {
            Error::BuildingUrl => f.write_str("Error building url"),
            Error::Closed(_) => f.write_str("Connection closed"),
            Error::ExpectedHello => f.write_str("Expected a Hello"),
            Error::HeartbeatFailed => f.write_str("Failed sending a heartbeat"),
            Error::InvalidAuthentication => f.write_str("Sent invalid authentication"),
            Error::InvalidHandshake => f.write_str("Expected a valid Handshake"),
            Error::InvalidOpCode => f.write_str("Invalid OpCode"),
            Error::InvalidShardData => f.write_str("Sent invalid shard data"),
            Error::NoAuthentication => f.write_str("Sent no authentication"),
            Error::NoSessionId => f.write_str("No Session Id present when required"),
            Error::OverloadedShard => f.write_str("Shard has too many guilds"),
            Error::ReconnectFailure => f.write_str("Failed to Reconnect"),
            Error::InvalidGatewayIntents => f.write_str("Invalid gateway intents were provided"),
            Error::DisallowedGatewayIntents => {
                f.write_str("Disallowed gateway intents were provided")
            },
        }
    }
}

impl StdError for Error {}