lmrc-cloudflare 0.3.16

Cloudflare API client library for the LMRC Stack - comprehensive DNS, zones, and cache management with automatic retry logic
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
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127

//! Error types for the Cloudflare client.

use std::fmt;

/// Result type alias for Cloudflare operations.
pub type Result<T> = std::result::Result<T, Error>;

/// The main error type for Cloudflare client operations.
#[derive(Debug)]
pub enum Error {
    /// HTTP request failed
    Http(reqwest::Error),

    /// Cloudflare API returned an error response
    Api(ApiError),

    /// Failed to serialize/deserialize JSON
    Json(serde_json::Error),

    /// Resource not found (zone, record, etc.)
    NotFound(String),

    /// Invalid input or configuration
    InvalidInput(String),

    /// Authentication failed
    Unauthorized(String),

    /// Rate limited by Cloudflare API
    RateLimited { retry_after: Option<u64> },
}

/// Detailed API error from Cloudflare
#[derive(Debug, Clone)]
pub struct ApiError {
    /// HTTP status code
    pub status: u16,

    /// Error code from Cloudflare
    pub code: Option<i32>,

    /// Error message
    pub message: String,

    /// Full response body for debugging
    pub body: String,
}

impl fmt::Display for Error {
    fn fmt(&self, f: &mut fmt::Formatter<'_>) -> fmt::Result {
        match self {
            Error::Http(e) => write!(f, "HTTP request failed: {}", e),
            Error::Api(e) => write!(f, "Cloudflare API error: {}", e.message),
            Error::Json(e) => write!(f, "JSON serialization error: {}", e),
            Error::NotFound(msg) => write!(f, "Resource not found: {}", msg),
            Error::InvalidInput(msg) => write!(f, "Invalid input: {}", msg),
            Error::Unauthorized(msg) => write!(f, "Authentication failed: {}", msg),
            Error::RateLimited { retry_after } => {
                if let Some(seconds) = retry_after {
                    write!(f, "Rate limited, retry after {} seconds", seconds)
                } else {
                    write!(f, "Rate limited by Cloudflare API")
                }
            }
        }
    }
}

impl std::error::Error for Error {
    fn source(&self) -> Option<&(dyn std::error::Error + 'static)> {
        match self {
            Error::Http(e) => Some(e),
            Error::Json(e) => Some(e),
            _ => None,
        }
    }
}

impl From<reqwest::Error> for Error {
    fn from(err: reqwest::Error) -> Self {
        Error::Http(err)
    }
}

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

impl ApiError {
    /// Create a new API error
    pub fn new(status: u16, message: String, body: String) -> Self {
        Self {
            status,
            code: None,
            message,
            body,
        }
    }

    /// Create from Cloudflare API response
    pub(crate) fn from_response(status: u16, body: &str) -> Self {
        // Try to parse error details from response
        if let Ok(json) = serde_json::from_str::<serde_json::Value>(body)
            && let Some(errors) = json["errors"].as_array()
            && let Some(first_error) = errors.first()
        {
            return Self {
                status,
                code: first_error["code"].as_i64().map(|c| c as i32),
                message: first_error["message"]
                    .as_str()
                    .unwrap_or("Unknown error")
                    .to_string(),
                body: body.to_string(),
            };
        }

        Self {
            status,
            code: None,
            message: format!("HTTP {}", status),
            body: body.to_string(),
        }
    }
}