elif_http/errors/
responses.rs

1//! HTTP error response formatting
2
3use super::HttpError;
4use crate::response::{ElifResponse, ElifStatusCode, IntoElifResponse};
5use axum::response::{IntoResponse, Response};
6use axum::Json;
7use serde_json::json;
8
9impl HttpError {
10    /// Get the appropriate HTTP status code for this error
11    pub fn status_code(&self) -> ElifStatusCode {
12        match self {
13            HttpError::StartupFailed { .. } => ElifStatusCode::INTERNAL_SERVER_ERROR,
14            HttpError::ShutdownFailed { .. } => ElifStatusCode::INTERNAL_SERVER_ERROR,
15            HttpError::ConfigError { .. } => ElifStatusCode::INTERNAL_SERVER_ERROR,
16            HttpError::ServiceResolutionFailed { .. } => ElifStatusCode::INTERNAL_SERVER_ERROR,
17            HttpError::RequestTimeout => ElifStatusCode::REQUEST_TIMEOUT,
18            HttpError::RequestTooLarge { .. } => ElifStatusCode::PAYLOAD_TOO_LARGE,
19            HttpError::BadRequest { .. } => ElifStatusCode::BAD_REQUEST,
20            HttpError::InternalError { .. } => ElifStatusCode::INTERNAL_SERVER_ERROR,
21            HttpError::HealthCheckFailed { .. } => ElifStatusCode::SERVICE_UNAVAILABLE,
22            HttpError::DatabaseError { .. } => ElifStatusCode::INTERNAL_SERVER_ERROR,
23            HttpError::ValidationError { .. } => ElifStatusCode::UNPROCESSABLE_ENTITY,
24            HttpError::NotFound { .. } => ElifStatusCode::NOT_FOUND,
25            HttpError::Conflict { .. } => ElifStatusCode::CONFLICT,
26            HttpError::Unauthorized => ElifStatusCode::UNAUTHORIZED,
27            HttpError::Forbidden { .. } => ElifStatusCode::FORBIDDEN,
28        }
29    }
30
31    /// Get error hint for user guidance
32    pub fn error_hint(&self) -> Option<&'static str> {
33        match &self {
34            HttpError::RequestTooLarge { .. } => Some("Reduce request payload size"),
35            HttpError::RequestTimeout => Some("Retry the request"),
36            HttpError::BadRequest { .. } => Some("Check request format and parameters"),
37            HttpError::HealthCheckFailed { .. } => Some("Server may be starting up or experiencing issues"),
38            _ => None,
39        }
40    }
41}
42
43// Implement IntoElifResponse for HttpError
44impl IntoElifResponse for HttpError {
45    fn into_response(self) -> ElifResponse {
46        let body = json!({
47            "error": {
48                "code": self.error_code(),
49                "message": self.to_string(),
50                "hint": self.error_hint()
51            }
52        });
53
54        ElifResponse::with_status(self.status_code())
55            .json_value(body)
56    }
57}
58
59// Implement IntoResponse for automatic HTTP error responses (Axum compatibility)
60impl IntoResponse for HttpError {
61    fn into_response(self) -> Response {
62        let status = self.status_code().to_axum(); // Convert to Axum StatusCode
63        let body = json!({
64            "error": {
65                "code": self.error_code(),
66                "message": self.to_string(),
67                "hint": self.error_hint()
68            }
69        });
70
71        (status, Json(body)).into_response()
72    }
73}
74
75#[cfg(test)]
76mod tests {
77    use super::*;
78
79    #[test]
80    fn test_error_status_codes() {
81        assert_eq!(HttpError::bad_request("test").status_code(), crate::response::status::ElifStatusCode::BAD_REQUEST);
82        assert_eq!(HttpError::RequestTimeout.status_code(), crate::response::status::ElifStatusCode::REQUEST_TIMEOUT);
83        assert_eq!(
84            HttpError::RequestTooLarge { size: 100, limit: 50 }.status_code(), 
85            crate::response::status::ElifStatusCode::PAYLOAD_TOO_LARGE
86        );
87        assert_eq!(
88            HttpError::health_check("Database unavailable").status_code(), 
89            crate::response::status::ElifStatusCode::SERVICE_UNAVAILABLE
90        );
91    }
92
93    #[test]
94    fn test_validation_error_status_code() {
95        let validation_error = HttpError::validation_error("Field is required");
96        assert_eq!(validation_error.status_code(), crate::response::status::ElifStatusCode::UNPROCESSABLE_ENTITY);
97    }
98
99    #[test]
100    fn test_error_hints() {
101        let timeout_error = HttpError::RequestTimeout;
102        assert_eq!(timeout_error.error_hint(), Some("Retry the request"));
103
104        let large_request_error = HttpError::RequestTooLarge { size: 100, limit: 50 };
105        assert_eq!(large_request_error.error_hint(), Some("Reduce request payload size"));
106
107        let not_found_error = HttpError::not_found("User");
108        assert_eq!(not_found_error.error_hint(), None);
109    }
110
111    #[test]
112    fn test_error_response_format_consistency() {
113        use axum::response::IntoResponse as AxumIntoResponse;
114        
115        let error = HttpError::not_found("User");
116        let response = AxumIntoResponse::into_response(error);
117        
118        assert_eq!(response.status(), axum::http::StatusCode::NOT_FOUND);
119    }
120}
elif_http/errors/responses.rs

elif_http/errors/
responses.rs
