braze-sync 0.1.0

//! Braze API error variants. See IMPLEMENTATION.md §6.7 / §8.

use reqwest::StatusCode;
use thiserror::Error;

#[derive(Error, Debug)]
pub enum BrazeApiError {
    /// Non-success HTTP status that wasn't already mapped to a typed
    /// variant below. Carries the body so users have something to grep.
    #[error("HTTP {status}: {body}")]
    Http { status: StatusCode, body: String },

    /// Network / decode errors from `reqwest`. Includes JSON parse errors
    /// (reqwest::Error::is_decode) — the message will say so.
    #[error("network error: {0}")]
    Network(#[from] reqwest::Error),

    /// 401 from Braze. Almost always a wrong / missing API key.
    #[error("authentication failed (invalid api key)")]
    Unauthorized,

    /// 404 mapped from a get-by-name endpoint. Generic Http {404} from a
    /// list endpoint stays as Http; this variant is reserved for the
    /// "this specific resource doesn't exist" case so callers can branch
    /// on it without string matching.
    #[error("Braze resource not found: {resource}")]
    NotFound { resource: String },

    /// MAX_RETRIES of 429 in a row. The caller should slow down (or
    /// raise the configured rate limit) rather than just retrying again.
    #[error("rate limit retries exhausted")]
    RateLimitExhausted,
}