ig_client/
error.rs

1/******************************************************************************
2   Author: Joaquín Béjar García
3   Email: jb@taunais.com
4   Date: 12/5/25
5******************************************************************************/
6use reqwest::StatusCode;
7use std::fmt::{Display, Formatter};
8use std::{fmt, io};
9
10/// Error type for fetch operations
11#[derive(Debug)]
12pub enum FetchError {
13    /// Network error from reqwest
14    Reqwest(reqwest::Error),
15    /// Database error from sqlx
16    Sqlx(sqlx::Error),
17    /// Error during parsing
18    Parser(String),
19}
20
21impl Display for FetchError {
22    fn fmt(&self, f: &mut std::fmt::Formatter<'_>) -> std::fmt::Result {
23        match self {
24            FetchError::Reqwest(e) => write!(f, "network error: {e}"),
25            FetchError::Sqlx(e) => write!(f, "db error: {e}"),
26            FetchError::Parser(msg) => write!(f, "parser error: {msg}"),
27        }
28    }
29}
30
31impl std::error::Error for FetchError {}
32
33impl From<reqwest::Error> for FetchError {
34    fn from(err: reqwest::Error) -> Self {
35        FetchError::Reqwest(err)
36    }
37}
38
39impl From<sqlx::Error> for FetchError {
40    fn from(err: sqlx::Error) -> Self {
41        FetchError::Sqlx(err)
42    }
43}
44
45/// Error type for authentication operations
46#[derive(Debug)]
47pub enum AuthError {
48    /// Network error from reqwest
49    Network(reqwest::Error),
50    /// I/O error
51    Io(io::Error),
52    /// JSON serialization or deserialization error
53    Json(serde_json::Error),
54    /// Other unspecified error
55    Other(String),
56    /// Invalid credentials error
57    BadCredentials,
58    /// Unexpected HTTP status code
59    Unexpected(StatusCode),
60    /// Rate limit exceeded error
61    RateLimitExceeded,
62}
63
64impl Display for AuthError {
65    fn fmt(&self, f: &mut Formatter<'_>) -> fmt::Result {
66        match self {
67            AuthError::Network(e) => write!(f, "network error: {e}"),
68            AuthError::Io(e) => write!(f, "io error: {e}"),
69            AuthError::Json(e) => write!(f, "json error: {e}"),
70            AuthError::Other(msg) => write!(f, "other error: {msg}"),
71            AuthError::BadCredentials => write!(f, "bad credentials"),
72            AuthError::Unexpected(s) => write!(f, "unexpected http status: {s}"),
73            AuthError::RateLimitExceeded => write!(f, "rate limit exceeded"),
74        }
75    }
76}
77
78impl std::error::Error for AuthError {}
79
80impl From<reqwest::Error> for AuthError {
81    fn from(e: reqwest::Error) -> Self {
82        AuthError::Network(e)
83    }
84}
85impl From<Box<dyn std::error::Error + Send + Sync>> for AuthError {
86    fn from(e: Box<dyn std::error::Error + Send + Sync>) -> Self {
87        match e.downcast::<reqwest::Error>() {
88            Ok(req) => AuthError::Network(*req),
89            Err(e) => match e.downcast::<serde_json::Error>() {
90                Ok(js) => AuthError::Json(*js),
91                Err(e) => match e.downcast::<std::io::Error>() {
92                    Ok(ioe) => AuthError::Io(*ioe),
93                    Err(other) => AuthError::Other(other.to_string()),
94                },
95            },
96        }
97    }
98}
99impl From<Box<dyn std::error::Error>> for AuthError {
100    fn from(e: Box<dyn std::error::Error>) -> Self {
101        match e.downcast::<reqwest::Error>() {
102            Ok(req) => AuthError::Network(*req),
103            Err(e) => match e.downcast::<serde_json::Error>() {
104                Ok(js) => AuthError::Json(*js),
105                Err(e) => match e.downcast::<io::Error>() {
106                    Ok(ioe) => AuthError::Io(*ioe),
107                    Err(other) => AuthError::Other(other.to_string()),
108                },
109            },
110        }
111    }
112}
113impl From<AppError> for AuthError {
114    fn from(e: AppError) -> Self {
115        match e {
116            AppError::Network(e) => AuthError::Network(e),
117            AppError::Io(e) => AuthError::Io(e),
118            AppError::Json(e) => AuthError::Json(e),
119            AppError::Unexpected(s) => AuthError::Unexpected(s),
120            _ => AuthError::Other("unknown error".to_string()),
121        }
122    }
123}
124
125/// General application error type
126#[derive(Debug)]
127pub enum AppError {
128    /// Network error from reqwest
129    Network(reqwest::Error),
130    /// I/O error
131    Io(io::Error),
132    /// JSON serialization or deserialization error
133    Json(serde_json::Error),
134    /// Unexpected HTTP status code
135    Unexpected(StatusCode),
136    /// Database error from sqlx
137    Db(sqlx::Error),
138    /// Unauthorized access error
139    Unauthorized,
140    /// Resource not found error
141    NotFound,
142    /// API rate limit exceeded
143    RateLimitExceeded,
144    /// Error during serialization or deserialization
145    SerializationError(String),
146    /// WebSocket communication error
147    WebSocketError(String),
148    /// Deserialization error with details
149    Deserialization(String),
150    /// Represents an error type for invalid input.
151    ///
152    /// This enum variant is used to indicate that invalid input has been provided,
153    /// typically taking the form of a string that describes the nature of the issue.
154    ///
155    /// # Variants
156    /// * `InvalidInput(String)`
157    ///   - Contains a `String` value that provides more details about why the input
158    ///     was considered invalid, such as specific formatting issues or constraints
159    ///     that were violated.
160    ///
161    InvalidInput(String),
162}
163
164impl Display for AppError {
165    fn fmt(&self, f: &mut Formatter<'_>) -> fmt::Result {
166        match self {
167            AppError::Network(e) => write!(f, "network error: {e}"),
168            AppError::Io(e) => write!(f, "io error: {e}"),
169            AppError::Json(e) => write!(f, "json error: {e}"),
170            AppError::Unexpected(s) => write!(f, "unexpected http status: {s}"),
171            AppError::Db(e) => write!(f, "db error: {e}"),
172            AppError::Unauthorized => write!(f, "unauthorized"),
173            AppError::NotFound => write!(f, "not found"),
174            AppError::RateLimitExceeded => write!(f, "rate limit exceeded"),
175            AppError::SerializationError(s) => write!(f, "serialization error: {s}"),
176            AppError::WebSocketError(s) => write!(f, "websocket error: {s}"),
177            AppError::Deserialization(s) => write!(f, "deserialization error: {s}"),
178            AppError::InvalidInput(s) => write!(f, "invalid input: {s}"),
179        }
180    }
181}
182
183impl std::error::Error for AppError {}
184
185impl From<reqwest::Error> for AppError {
186    fn from(e: reqwest::Error) -> Self {
187        AppError::Network(e)
188    }
189}
190impl From<io::Error> for AppError {
191    fn from(e: io::Error) -> Self {
192        AppError::Io(e)
193    }
194}
195impl From<serde_json::Error> for AppError {
196    fn from(e: serde_json::Error) -> Self {
197        AppError::Json(e)
198    }
199}
200impl From<sqlx::Error> for AppError {
201    fn from(e: sqlx::Error) -> Self {
202        AppError::Db(e)
203    }
204}
205impl From<AuthError> for AppError {
206    fn from(e: AuthError) -> Self {
207        match e {
208            AuthError::Network(e) => AppError::Network(e),
209            AuthError::Io(e) => AppError::Io(e),
210            AuthError::Json(e) => AppError::Json(e),
211            AuthError::BadCredentials => AppError::Unauthorized,
212            AuthError::Unexpected(s) => AppError::Unexpected(s),
213            _ => AppError::Unexpected(StatusCode::INTERNAL_SERVER_ERROR),
214        }
215    }
216}
217
218impl From<Box<dyn std::error::Error>> for AppError {
219    fn from(e: Box<dyn std::error::Error>) -> Self {
220        match e.downcast::<reqwest::Error>() {
221            Ok(req) => AppError::Network(*req),
222            Err(e) => match e.downcast::<serde_json::Error>() {
223                Ok(js) => AppError::Json(*js),
224                Err(e) => match e.downcast::<std::io::Error>() {
225                    Ok(ioe) => AppError::Io(*ioe),
226                    Err(_) => AppError::Unexpected(StatusCode::INTERNAL_SERVER_ERROR),
227                },
228            },
229        }
230    }
231}