Enum CoreError 

pub enum CoreError {
    InvalidInput(String),
    UrlParse(ParseError),
    Http(Error),
    HttpResponse(HttpErrorInfo),
    Authentication(String),
    Validation(String),
    UsageLimit(UsageLimitInfo),
    Job(JobErrorInfo),
    Config(String),
    Timeout(String),
    Protocol(String),
    Internal(String),
}

Unified error enum for all Synth core errors.

This provides a single error type that can be mapped to language-specific exceptions in Python, TypeScript, etc.

Variants

InvalidInput(String)

Invalid input provided

UrlParse(ParseError)

URL parsing failed

Http(Error)

HTTP request failed (network layer)

HttpResponse(HttpErrorInfo)

HTTP response error (4xx/5xx)

Authentication(String)

Authentication failed

Validation(String)

Validation error

UsageLimit(UsageLimitInfo)

Usage/rate limit exceeded

Job(JobErrorInfo)

Job operation failed

Config(String)

Configuration error

Timeout(String)

Timeout error

Protocol(String)

Protocol/wire format error

Internal(String)

Generic internal error

Implementations

impl CoreError

pub fn http_response( status: u16, url: &str, message: &str, body: Option<&str>, ) -> Self

Create an HTTP response error.

pub fn auth(message: impl Into<String>) -> Self

Create an authentication error.

pub fn validation(message: impl Into<String>) -> Self

Create a validation error.

pub fn usage_limit( limit_type: &str, api: &str, current: f64, limit: f64, tier: &str, retry_after: Option<i64>, ) -> Self

Create a usage limit error.

pub fn job(job_id: &str, message: &str, code: Option<&str>) -> Self

Create a job error.

pub fn timeout(message: impl Into<String>) -> Self

Create a timeout error.

pub fn config(message: impl Into<String>) -> Self

Create a config error.

pub fn is_auth_error(&self) -> bool

Check if this is an authentication error.

pub fn is_rate_limit(&self) -> bool

Check if this is a rate limit error.

pub fn is_retryable(&self) -> bool

Check if this is a retryable error (5xx, timeout, network).

pub fn http_status(&self) -> Option<u16>

Get HTTP status code if this is an HTTP error.

Trait Implementations

impl Debug for CoreError

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Display for CoreError

fn fmt(&self, __formatter: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Error for CoreError

fn source(&self) -> Option<&(dyn Error + 'static)>

Returns the lower-level source of this error, if any.

fn description(&self) -> &str

👎Deprecated since 1.42.0: use the Display impl or to_string()

fn cause(&self) -> Option<&dyn Error>

👎Deprecated since 1.33.0: replaced by Error::source, which can support downcasting

fn provide<'a>(&'a self, request: &mut Request<'a>)

🔬This is a nightly-only experimental API. (error_generic_member_access)

Provides type-based access to context intended for error reports.

impl From<Error> for CoreError

fn from(source: Error) -> Self

Converts to this type from the input type.

impl From<HttpError> for CoreError

fn from(err: HttpError) -> Self

Converts to this type from the input type.

impl From<ParseError> for CoreError

fn from(source: ParseError) -> Self

Converts to this type from the input type.