sms-client 3.1.0

//! HTTP interface related errors.

/// An error originating from the SMS `HttpClient`.
#[derive(thiserror::Error, Debug)]
pub enum HttpError {
    /// Network request failed (connection issues, timeouts, etc.)
    #[error("Reqwest failure: {0}")]
    RequestError(#[from] reqwest::Error),

    /// Failed to parse the provided URL.
    #[error("Invalid URL: {0}")]
    UrlParseError(#[from] url::ParseError),

    /// Failed to parse JSON response from the API.
    #[error("JSON parsing failed: {0}")]
    JsonError(#[from] serde_json::Error),

    /// System IO error
    #[error("IO error: {0}")]
    IOError(#[from] std::io::Error),

    /// HTTP request returned a non-success status code.
    #[error("{}", HttpError::format_http_error(status, message))]
    HttpStatus {
        /// HTTP status returned in response.
        status: u16,
        /// Full response body as text.
        message: String,
    },

    /// API returned success=false with an error message.
    #[error("{0}")]
    ApiError(String),

    /// TLS configuration error
    #[error("TLS error: {0}")]
    TLSError(String),

    /// API response missing the expected 'response' field.
    #[error("Missing 'response' field in API response")]
    MissingResponseField,

    /// Modem response type doesn't match what was expected.
    #[error("Type mismatch: expected '{expected}', got '{actual}'")]
    ResponseTypeMismatch {
        /// The expected response data-type.
        expected: String,
        /// The actual response data-type.
        actual: String,
    },
}
impl HttpError {
    fn status_text(status: u16) -> &'static str {
        match status {
            200 => "OK",
            400 => "Bad Request",
            401 => "Unauthorized",
            403 => "Forbidden",
            404 => "Not Found",
            405 => "Method Not Allowed",
            408 => "Not Acceptable",
            429 => "Too Many Requests",
            500 => "Internal Server Error",
            503 => "Service Unavailable",
            504 => "Gateway Timeout",
            _ => "Unknown",
        }
    }

    // Ignore Clippy hint since thiserror always provides it by reference.
    #[allow(clippy::trivially_copy_pass_by_ref)]
    fn format_http_error(status: &u16, message: &str) -> String {
        if message.trim().is_empty() {
            format!("HTTP {status} {}", Self::status_text(*status))
        } else {
            format!("HTTP {status}: {message}")
        }
    }
}

/// Result type alias for HTTP operations.
pub type HttpResult<T> = Result<T, HttpError>;