2023-08-26 19:41:00 +02:00
|
|
|
//! Contains all the errors that can be returned by the library.
|
2023-04-21 16:18:20 +02:00
|
|
|
use custom_error::custom_error;
|
|
|
|
|
2023-08-29 18:38:26 +02:00
|
|
|
use crate::types::WebSocketEvent;
|
|
|
|
|
2023-04-21 16:18:20 +02:00
|
|
|
custom_error! {
|
2023-09-03 16:55:19 +02:00
|
|
|
#[derive(PartialEq, Eq, Clone, Hash)]
|
2023-07-09 18:38:02 +02:00
|
|
|
pub RegistrationError
|
|
|
|
Consent = "Consent must be 'true' to register.",
|
2023-04-21 16:18:20 +02:00
|
|
|
}
|
2023-04-21 18:20:49 +02:00
|
|
|
|
2023-07-09 18:38:02 +02:00
|
|
|
pub type ChorusResult<T> = std::result::Result<T, ChorusError>;
|
2023-06-21 14:46:14 +02:00
|
|
|
|
2023-04-21 18:20:49 +02:00
|
|
|
custom_error! {
|
2023-09-03 16:55:19 +02:00
|
|
|
#[derive(Clone, Hash, PartialEq, Eq)]
|
2023-07-09 18:38:02 +02:00
|
|
|
pub ChorusError
|
|
|
|
/// Server did not respond.
|
2023-04-21 23:20:23 +02:00
|
|
|
NoResponse = "Did not receive a response from the Server.",
|
2023-07-09 18:38:02 +02:00
|
|
|
/// Reqwest returned an Error instead of a Response object.
|
2023-09-01 01:17:23 +02:00
|
|
|
RequestFailed{url:String, error: String} = "An error occured while trying to GET from {url}: {error}",
|
2023-07-09 18:38:02 +02:00
|
|
|
/// Response received, however, it was not of the successful responses type. Used when no other, special case applies.
|
|
|
|
ReceivedErrorCode{error_code: u16, error: String} = "Received the following error code while requesting from the route: {error_code}",
|
|
|
|
/// Used when there is likely something wrong with the instance, the request was directed to.
|
|
|
|
CantGetInformation{error:String} = "Something seems to be wrong with the instance. Cannot get information about the instance: {error}",
|
|
|
|
/// The requests form body was malformed/invalid.
|
|
|
|
InvalidFormBody{error_type: String, error:String} = "The server responded with: {error_type}: {error}",
|
|
|
|
/// The request has not been processed by the server due to a relevant rate limit bucket being exhausted.
|
2023-05-14 13:12:02 +02:00
|
|
|
RateLimited{bucket:String} = "Ratelimited on Bucket {bucket}",
|
2023-07-09 18:38:02 +02:00
|
|
|
/// The multipart form could not be created.
|
|
|
|
MultipartCreation{error: String} = "Got an error whilst creating the form: {error}",
|
|
|
|
/// The regular form could not be created.
|
|
|
|
FormCreation{error: String} = "Got an error whilst creating the form: {error}",
|
|
|
|
/// The token is invalid.
|
2023-05-14 13:07:46 +02:00
|
|
|
TokenExpired = "Token expired, invalid or not found.",
|
2023-07-09 18:38:02 +02:00
|
|
|
/// No permission
|
2023-05-14 13:07:46 +02:00
|
|
|
NoPermission = "You do not have the permissions needed to perform this action.",
|
2023-07-09 18:38:02 +02:00
|
|
|
/// Resource not found
|
2023-06-18 23:01:38 +02:00
|
|
|
NotFound{error: String} = "The provided resource hasn't been found: {error}",
|
2023-07-09 18:38:02 +02:00
|
|
|
/// Used when you, for example, try to change your spacebar account password without providing your old password for verification.
|
|
|
|
PasswordRequired = "You need to provide your current password to authenticate for this action.",
|
|
|
|
/// Malformed or unexpected response.
|
|
|
|
InvalidResponse{error: String} = "The response is malformed and cannot be processed. Error: {error}",
|
|
|
|
/// Invalid, insufficient or too many arguments provided.
|
|
|
|
InvalidArguments{error: String} = "Invalid arguments were provided. Error: {error}"
|
2023-04-21 18:20:49 +02:00
|
|
|
}
|
2023-04-27 22:38:57 +02:00
|
|
|
|
|
|
|
custom_error! {
|
|
|
|
#[derive(PartialEq, Eq)]
|
|
|
|
pub ObserverError
|
2023-07-09 18:38:02 +02:00
|
|
|
AlreadySubscribed = "Each event can only be subscribed to once."
|
2023-04-27 22:38:57 +02:00
|
|
|
}
|
2023-06-08 17:34:52 +02:00
|
|
|
|
|
|
|
custom_error! {
|
|
|
|
/// For errors we receive from the gateway, see https://discord-userdoccers.vercel.app/topics/opcodes-and-status-codes#gateway-close-event-codes;
|
|
|
|
///
|
|
|
|
/// Supposed to be sent as numbers, though they are sent as string most of the time?
|
|
|
|
///
|
|
|
|
/// Also includes errors when initiating a connection and unexpected opcodes
|
2023-08-29 18:38:26 +02:00
|
|
|
#[derive(PartialEq, Eq, Default, Clone)]
|
2023-06-08 17:34:52 +02:00
|
|
|
pub GatewayError
|
|
|
|
// Errors we have received from the gateway
|
2023-08-29 18:38:26 +02:00
|
|
|
#[default]
|
2023-07-09 18:38:02 +02:00
|
|
|
Unknown = "We're not sure what went wrong. Try reconnecting?",
|
|
|
|
UnknownOpcode = "You sent an invalid Gateway opcode or an invalid payload for an opcode",
|
|
|
|
Decode = "Gateway server couldn't decode payload",
|
|
|
|
NotAuthenticated = "You sent a payload prior to identifying",
|
|
|
|
AuthenticationFailed = "The account token sent with your identify payload is invalid",
|
|
|
|
AlreadyAuthenticated = "You've already identified, no need to reauthenticate",
|
|
|
|
InvalidSequenceNumber = "The sequence number sent when resuming the session was invalid. Reconnect and start a new session",
|
|
|
|
RateLimited = "You are being rate limited!",
|
|
|
|
SessionTimedOut = "Your session timed out. Reconnect and start a new one",
|
|
|
|
InvalidShard = "You sent us an invalid shard when identifying",
|
|
|
|
ShardingRequired = "The session would have handled too many guilds - you are required to shard your connection in order to connect",
|
|
|
|
InvalidAPIVersion = "You sent an invalid Gateway version",
|
|
|
|
InvalidIntents = "You sent an invalid intent",
|
|
|
|
DisallowedIntents = "You sent a disallowed intent. You may have tried to specify an intent that you have not enabled or are not approved for",
|
2023-06-08 17:34:52 +02:00
|
|
|
|
|
|
|
// Errors when initiating a gateway connection
|
2023-07-09 18:38:02 +02:00
|
|
|
CannotConnect{error: String} = "Cannot connect due to a tungstenite error: {error}",
|
|
|
|
NonHelloOnInitiate{opcode: u8} = "Received non hello on initial gateway connection ({opcode}), something is definitely wrong",
|
2023-06-08 17:34:52 +02:00
|
|
|
|
|
|
|
// Other misc errors
|
2023-07-09 18:38:02 +02:00
|
|
|
UnexpectedOpcodeReceived{opcode: u8} = "Received an opcode we weren't expecting to receive: {opcode}",
|
2023-06-08 17:34:52 +02:00
|
|
|
}
|
2023-08-29 18:38:26 +02:00
|
|
|
|
|
|
|
impl WebSocketEvent for GatewayError {}
|