disruption 0.2.0

A light wrapper around the Discord API and gateway.
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
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94

//! Error types for the Disruption Discord library

use thiserror::Error;

/// Main error type for the Disruption library
#[derive(Error, Debug)]
pub enum Error {
    /// Gateway connection error
    #[error("Gateway error: {0}")]
    Gateway(#[from] disruption_gateway::GatewayError),

    /// REST API error
    #[error("REST API error: {0}")]
    Rest(#[from] RestError),

    /// Generic error for unexpected situations
    #[error("Internal error: {0}")]
    Internal(String),
}

/// Errors that can occur during REST API operations
#[derive(Error, Debug)]
pub enum RestError {
    /// HTTP request failed
    #[error("HTTP request failed: {0}")]
    RequestFailed(#[from] reqwest::Error),

    /// Discord API returned an error
    #[error("Discord API error (status {status}): {message}")]
    ApiError { status: u16, message: String },

    /// Rate limit exceeded
    #[error("Rate limit exceeded. Retry after {retry_after} seconds")]
    RateLimited { retry_after: u64 },

    /// Authentication failed (invalid token)
    #[error("Authentication failed: invalid or missing bot token")]
    AuthenticationFailed,

    /// Resource not found
    #[error("Resource not found: {resource_type} with ID {id}")]
    NotFound { resource_type: String, id: String },

    /// Invalid request parameters
    #[error("Invalid request: {0}")]
    InvalidRequest(String),

    /// Failed to serialize request body
    #[error("Failed to serialize request: {0}")]
    SerializationError(#[from] serde_json::Error),

    /// Response body parsing failed
    #[error("Failed to parse response body: {0}")]
    ResponseParseError(String),

    /// Missing required permission
    #[error("Missing permission: {0}")]
    MissingPermission(String),

    /// Invalid URL or endpoint
    #[error("Invalid URL: {0}")]
    InvalidUrl(String),
}

/// Result type for Disruption library operations
pub type Result<T> = std::result::Result<T, Error>;

/// Result type for REST API operations
pub type RestResult<T> = std::result::Result<T, RestError>;

// Additional conversions for convenience
impl From<reqwest::Error> for Error {
    fn from(err: reqwest::Error) -> Self {
        Error::Rest(RestError::RequestFailed(err))
    }
}

impl From<serde_json::Error> for Error {
    fn from(err: serde_json::Error) -> Self {
        Error::Rest(RestError::SerializationError(err))
    }
}

impl<T> From<async_channel::SendError<T>> for Error {
    fn from(err: async_channel::SendError<T>) -> Self {
        Error::Internal(format!("Channel send error: {}", err))
    }
}

impl From<async_channel::RecvError> for Error {
    fn from(err: async_channel::RecvError) -> Self {
        Error::Internal(format!("Channel receive error: {}", err))
    }
}