Enum ProximaError 

pub enum ProximaError {
    Upstream(String),
    Timeout(Duration),
    RateLimited,
    NoData,
    Config(String),
    Io(Error),
    Decode(String),
    Encode(String),
    Body(String),
    NotFound(String),
    Forbidden(String),
    Registry(String),
    RetriesExhausted {
        attempts: usize,
        last: String,
    },
    Record(String),
    ReplayMiss {
        fingerprint: String,
    },
    DecodeKind(DecodeError),
    EncodeKind(EncodeError),
    UpstreamKind(UpstreamError),
    ConfigKind(ConfigError),
    BodyKind(BodyError),
    NotFoundKind(NotFoundError),
    RegistryKind(RegistryError),
    RecordKind(RecordError),
}

Variants

Upstream(String)

Legacy String-payload variants. Construct via ProximaError::Decode(...) today; migrate to ProximaError::DecodeKind(DecodeError::...) over time.

Timeout(Duration)

RateLimited

NoData

Config(String)

Io(Error)

Decode(String)

Encode(String)

Body(String)

NotFound(String)

Forbidden(String)

A deliberate refusal, not a failure — the payload is the response body verbatim (e.g. a filter predicate’s RejectMode::Drop, which renders as 403 with this payload as the body).

Registry(String)

RetriesExhausted

Fields

attempts: usize

last: String

Record(String)

ReplayMiss

Fields

fingerprint: String

DecodeKind(DecodeError)

Typed payload variants. Carry sub-enum kinds with concrete fields (e.g. Decode(format!("missing field 'name'")) becomes DecodeKind(DecodeError::MissingField { field: "name" })). Match callers can now inspect the kind without parsing strings.

EncodeKind(EncodeError)

UpstreamKind(UpstreamError)

ConfigKind(ConfigError)

BodyKind(BodyError)

NotFoundKind(NotFoundError)

RegistryKind(RegistryError)

RecordKind(RecordError)

Implementations

impl ProximaError

pub fn is_retryable(&self) -> bool

Whether this error class is worth retrying. Covers both legacy and typed variants — the heuristic matches Upstream* (transient I/O), Timeout, Body* (worker churn), and (under std) Io.

Trait Implementations

impl Debug for ProximaError

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

Formats the value using the given formatter.

impl Display for ProximaError

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

Formats the value using the given formatter.

impl Error for ProximaError

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<BodyError> for ProximaError

fn from(source: BodyError) -> ProximaError

Converts to this type from the input type.

impl From<ConfigError> for ProximaError

fn from(source: ConfigError) -> ProximaError

Converts to this type from the input type.

impl From<DecodeError> for ProximaError

fn from(source: DecodeError) -> ProximaError

Converts to this type from the input type.

impl From<EncodeError> for ProximaError

fn from(source: EncodeError) -> ProximaError

Converts to this type from the input type.

impl From<Error> for ProximaError

fn from(source: Error) -> ProximaError

Converts to this type from the input type.

impl From<NotFoundError> for ProximaError

fn from(source: NotFoundError) -> ProximaError

Converts to this type from the input type.

impl From<RecordError> for ProximaError

fn from(source: RecordError) -> ProximaError

Converts to this type from the input type.

impl From<RegistryError> for ProximaError

fn from(source: RegistryError) -> ProximaError

Converts to this type from the input type.

impl From<RejectMode> for ProximaError

fn from(mode: RejectMode) -> Self

Converts to this type from the input type.

impl From<UpstreamError> for ProximaError

fn from(source: UpstreamError) -> ProximaError

Converts to this type from the input type.