use serde::{Deserialize, Serialize};
use thiserror::Error;
#[derive(Debug, Clone, Serialize, Deserialize)]
pub struct ApiErrorBody {
pub error: ApiErrorDetail,
}
#[derive(Debug, Clone, Serialize, Deserialize)]
pub struct ApiErrorDetail {
pub code: String,
pub message: String,
pub request_id: String,
}
#[derive(Debug, Error)]
pub enum SdkError {
#[error("invalid ATP SDK configuration: {0}")]
Config(String),
#[error("ATP request timed out")]
Timeout,
#[error("ATP transport failed: {0}")]
Transport(String),
#[error("ATP response could not be decoded: {0}")]
Decode(String),
#[error("ATP rejected credentials")]
Unauthorized,
#[error("ATP resource was not found")]
NotFound,
#[error("insufficient credits")]
InsufficientCredits,
#[error("ATP request conflicts with current state")]
Conflict,
#[error("ATP rate limit exceeded")]
RateLimited {
retry_after_seconds: Option<u64>,
},
#[error("ATP API error {code}: {message} (request {request_id})")]
Api {
status: u16,
code: String,
message: String,
request_id: String,
},
}
impl SdkError {
pub fn is_retryable(&self) -> bool {
matches!(
self,
Self::Timeout
| Self::Transport(_)
| Self::RateLimited { .. }
| Self::Api {
status: 502..=504,
..
}
)
}
}
pub type SdkResult<T> = std::result::Result<T, SdkError>;
#[cfg(test)]
mod tests {
use super::*;
#[test]
fn cross_language_error_fixture_decodes() {
let value: ApiErrorBody = serde_json::from_str(include_str!(
"../../../sdk-conformance/error-insufficient-credits.json"
))
.unwrap();
assert_eq!(value.error.code, "insufficient_credits");
}
}