ferro-whatsapp 0.2.1

WhatsApp Business Cloud API integration for the Ferro framework
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

/// Errors that can occur in ferro-whatsapp operations.
#[derive(Debug, thiserror::Error)]
pub enum Error {
    /// Configuration error (missing env var or invalid value).
    #[error("configuration error: {0}")]
    Config(String),

    /// Webhook signature verification failed.
    #[error("webhook verification failed: {0}")]
    WebhookVerification(String),

    /// Meta API rate limit exceeded (HTTP 429).
    #[error("rate limit exceeded")]
    RateLimit,

    /// Recipient phone number is invalid or not registered on WhatsApp.
    #[error("invalid phone number")]
    InvalidNumber,

    /// Authentication error — access token invalid or expired (HTTP 401).
    #[error("authentication error")]
    AuthError,

    /// Network-level error contacting the Meta Cloud API.
    #[error("network error: {0}")]
    NetworkError(String),

    /// Meta Cloud API returned a non-2xx response.
    #[error("api error {status}: {message}")]
    ApiError {
        /// HTTP status code from Meta API.
        status: u16,
        /// Error message from Meta API response body.
        message: String,
    },
}

#[cfg(test)]
mod tests {
    use super::*;

    #[test]
    fn error_config_displays_message() {
        let e = Error::Config("WHATSAPP_APP_SECRET not set".into());
        assert_eq!(
            e.to_string(),
            "configuration error: WHATSAPP_APP_SECRET not set"
        );
    }

    #[test]
    fn error_webhook_verification_displays_message() {
        let e = Error::WebhookVerification("Signature mismatch".into());
        assert_eq!(
            e.to_string(),
            "webhook verification failed: Signature mismatch"
        );
    }

    #[test]
    fn error_rate_limit_displays_correctly() {
        let e = Error::RateLimit;
        assert_eq!(e.to_string(), "rate limit exceeded");
    }

    #[test]
    fn error_invalid_number_displays_correctly() {
        let e = Error::InvalidNumber;
        assert_eq!(e.to_string(), "invalid phone number");
    }

    #[test]
    fn error_auth_error_displays_correctly() {
        let e = Error::AuthError;
        assert_eq!(e.to_string(), "authentication error");
    }

    #[test]
    fn error_network_error_displays_message() {
        let e = Error::NetworkError("connection refused".into());
        assert_eq!(e.to_string(), "network error: connection refused");
    }

    #[test]
    fn error_api_error_displays_status_and_message() {
        let e = Error::ApiError {
            status: 500,
            message: "internal server error".into(),
        };
        assert_eq!(e.to_string(), "api error 500: internal server error");
    }
}