ffrelay-api 0.0.4

Rust API client library for Firefox Relay email forwarding service
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

//! Error types for the Firefox Relay API client.

use thiserror::Error;

/// A specialized `Result` type for Firefox Relay API operations.
pub type Result<T> = core::result::Result<T, Error>;

/// Errors that can occur when interacting with the Firefox Relay API.
#[derive(Debug, Error)]
pub enum Error {
    /// HTTP request failed with the given status code.
    ///
    /// This typically indicates a server error or invalid request.
    #[error("Http Error {http_status}")]
    RequestFailure { http_status: u16 },

    /// The specified relay ID was not found in your account.
    ///
    /// This occurs when trying to delete or access a relay that doesn't exist
    /// or doesn't belong to your account.
    #[error("Email Id not found")]
    RelayIdNotFound,

    /// Failed to delete the email relay.
    ///
    /// The server rejected the deletion request. Check the status code for details.
    #[error("Deletion Failure. Status code: {http_status}")]
    EmailDeletionFailure { http_status: u16 },

    /// Failed to update the email relay.
    ///
    /// The server rejected the deletion request. Check the status code for details.
    #[error("Update Failure. Status code: {http_status}")]
    EmailUpdateFailure { http_status: u16 },

    //
    // 3rd party errors
    //
    /// An HTTP client error occurred.
    ///
    /// This wraps errors from the `reqwest` HTTP client library,
    /// such as network connectivity issues or timeout errors.
    #[error(transparent)]
    HttpError(#[from] reqwest::Error),

    /// Failed to serialize or deserialize JSON data.
    ///
    /// This typically indicates an unexpected API response format.
    #[error(transparent)]
    Serialization(#[from] serde_json::Error),
}