Enum DarkStrataError 

pub enum DarkStrataError {
    Authentication {
        message: String,
        status_code: Option<u16>,
    },
    Validation {
        message: String,
        field: Option<String>,
    },
    Api {
        message: String,
        status_code: Option<u16>,
        retryable: bool,
    },
    Timeout {
        duration: Duration,
    },
    Network {
        message: String,
        source: Option<Box<dyn Error + Send + Sync>>,
    },
    RateLimit {
        retry_after: Option<Duration>,
    },
}

Main error type for the DarkStrata SDK.

Variants

Authentication

Authentication failed (invalid or missing API key).

Fields

message: String

Error message.

status_code: Option<u16>

HTTP status code (typically 401).

Validation

Input validation failed.

Fields

message: String

Error message describing the validation failure.

field: Option<String>

The field that failed validation (if applicable).

Api

API request failed.

Fields

message: String

Error message.

status_code: Option<u16>

HTTP status code.

retryable: bool

Whether this error is retryable.

Timeout

Request timed out.

Fields

duration: Duration

The timeout duration that was exceeded.

Network

Network connectivity error.

Fields

message: String

Error message.

source: Option<Box<dyn Error + Send + Sync>>

The underlying error.

RateLimit

Rate limit exceeded.

Fields

retry_after: Option<Duration>

Duration to wait before retrying (from Retry-After header).

Implementations

impl DarkStrataError

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

Create an authentication error.

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

Create a validation error.

pub fn validation_field( field: impl Into<String>, message: impl Into<String>, ) -> Self

Create a validation error for a specific field.

pub fn api(message: impl Into<String>, status_code: Option<u16>) -> Self

Create an API error.

pub fn timeout(duration: Duration) -> Self

Create a timeout error.

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

Create a network error.

pub fn network_with_source( message: impl Into<String>, source: impl Error + Send + Sync + 'static, ) -> Self

Create a network error with a source.

pub fn rate_limit(retry_after: Option<Duration>) -> Self

Create a rate limit error.

pub fn is_retryable(&self) -> bool

Check if this error is retryable.

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

Get the HTTP status code if available.

pub fn retry_after(&self) -> Option<Duration>

Get the retry-after duration for rate limit errors.

Trait Implementations

impl Debug for DarkStrataError

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

Formats the value using the given formatter.

impl Display for DarkStrataError

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

Formats the value using the given formatter.

impl Error for DarkStrataError

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 DarkStrataError

Convert a reqwest error to a DarkStrataError.

fn from(err: Error) -> Self

Converts to this type from the input type.