Enum GrapsusError 

pub enum GrapsusError {
    Config {
        message: String,
        source: Option<Box<dyn Error + Send + Sync>>,
    },
    Upstream {
        upstream: String,
        message: String,
        retryable: bool,
        source: Option<Box<dyn Error + Send + Sync>>,
    },
    Agent {
        agent: String,
        message: String,
        event: String,
        source: Option<Box<dyn Error + Send + Sync>>,
    },
    RequestValidation {
        reason: String,
        correlation_id: Option<String>,
    },
    ResponseValidation {
        reason: String,
        correlation_id: Option<String>,
    },
    LimitExceeded {
        limit_type: LimitType,
        message: String,
        current_value: usize,
        limit: usize,
    },
    Timeout {
        operation: String,
        duration_ms: u64,
        correlation_id: Option<String>,
    },
    CircuitBreakerOpen {
        component: String,
        consecutive_failures: u32,
        last_error: String,
    },
    WafBlocked {
        reason: String,
        rule_ids: Vec<String>,
        confidence: f32,
        correlation_id: String,
    },
    AuthenticationFailed {
        reason: String,
        correlation_id: Option<String>,
    },
    AuthorizationFailed {
        reason: String,
        correlation_id: Option<String>,
        required_permissions: Vec<String>,
    },
    Tls {
        message: String,
        source: Option<Box<dyn Error + Send + Sync>>,
    },
    Internal {
        message: String,
        correlation_id: Option<String>,
        source: Option<Box<dyn Error + Send + Sync>>,
    },
    Io {
        message: String,
        path: Option<String>,
        source: Error,
    },
    Parse {
        message: String,
        input: Option<String>,
        source: Option<Box<dyn Error + Send + Sync>>,
    },
    ServiceUnavailable {
        service: String,
        retry_after_seconds: Option<u32>,
    },
    RateLimit {
        message: String,
        limit: u32,
        window_seconds: u32,
        retry_after_seconds: Option<u32>,
    },
    NoHealthyUpstream,
}

Main error type for Grapsus operations

Variants

Config

Configuration errors

Fields

message: String

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

Upstream

Upstream connection errors

Fields

upstream: String

message: String

retryable: bool

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

Agent

Agent communication errors

Fields

agent: String

message: String

event: String

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

RequestValidation

Request validation errors

Fields

reason: String

correlation_id: Option<String>

ResponseValidation

Response validation errors

Fields

reason: String

correlation_id: Option<String>

LimitExceeded

Limit exceeded errors

Fields

limit_type: LimitType

message: String

current_value: usize

limit: usize

Timeout

Timeout errors

Fields

operation: String

duration_ms: u64

correlation_id: Option<String>

CircuitBreakerOpen

Circuit breaker errors

Fields

component: String

consecutive_failures: u32

last_error: String

WafBlocked

WAF block errors

Fields

reason: String

rule_ids: Vec<String>

confidence: f32

correlation_id: String

AuthenticationFailed

Authentication/Authorization errors

Fields

reason: String

correlation_id: Option<String>

AuthorizationFailed

Fields

reason: String

correlation_id: Option<String>

required_permissions: Vec<String>

Tls

TLS/Certificate errors

Fields

message: String

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

Internal

Internal errors

Fields

message: String

correlation_id: Option<String>

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

Io

IO errors

Fields

message: String

path: Option<String>

source: Error

Parse

Parsing errors

Fields

message: String

input: Option<String>

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

ServiceUnavailable

Service unavailable (for graceful degradation)

Fields

service: String

retry_after_seconds: Option<u32>

RateLimit

Rate limit errors

Fields

message: String

limit: u32

window_seconds: u32

retry_after_seconds: Option<u32>

NoHealthyUpstream

No healthy upstream available

Implementations

impl GrapsusError

pub fn is_circuit_breaker_eligible(&self) -> bool

Determine if this error should trigger a circuit breaker

pub fn is_retryable(&self) -> bool

Determine if this error is retryable

pub fn to_http_status(&self) -> u16

Get the HTTP status code for this error

pub fn client_message(&self) -> String

Get a client-safe error message (without internal details)

pub fn upstream( upstream: impl Into<String>, message: impl Into<String>, ) -> GrapsusError

Create an upstream error

pub fn upstream_retryable( upstream: impl Into<String>, message: impl Into<String>, ) -> GrapsusError

Create a retryable upstream error

pub fn timeout(operation: impl Into<String>, duration_ms: u64) -> GrapsusError

Create a timeout error

pub fn limit_exceeded( limit_type: LimitType, current_value: usize, limit: usize, ) -> GrapsusError

Create a limit exceeded error

pub fn with_correlation_id( self, correlation_id: impl Into<String>, ) -> GrapsusError

Add correlation ID to the error

Trait Implementations

impl Debug for GrapsusError

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

Formats the value using the given formatter.

impl Display for GrapsusError

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

Formats the value using the given formatter.

impl Error for GrapsusError

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 GrapsusError

Helper for converting IO errors

fn from(err: Error) -> GrapsusError

Converts to this type from the input type.