Enum TransportErrorClass 

#[non_exhaustive]
pub enum TransportErrorClass {
    Timeout,
    Connect,
    Redirect,
    Decode,
    Body,
    Builder,
    Request,
    Status,
    Upgrade,
    ResponseTooLarge,
    Other,
}

Production HTTP transport seam and its typed surfaces.

HttpTransport is the async injection point downstream clients consume; TransportResponse is its success envelope (2xx status, redacted headers, body); TransportError is its typed failure surface, and TransportErrorClass is the label telemetry and retry layers use to partition REST-transport failures without parsing error messages. The native default implementation is ReqwestTransport; the browser default lives in cow-sdk-core (transport::fetch). REST-transport error classification shared across transport-capable crates.

Built by classifying a reqwest::Error through the documented partition (is_timeout, is_connect, is_redirect, is_decode, is_body, is_builder, is_request, is_status, fallthrough). The ResponseTooLarge class is the exception: it is produced by the transport’s own response-size guard rather than by reqwest classification. Downstream error surfaces pair this enum with a redacted detail string to produce the public Transport { class, detail } variant shape.

Variants (Non-exhaustive)

Non-exhaustive enums could have additional variants added in future. Therefore, when matching against variants of non-exhaustive enums, an extra wildcard arm must be added to account for any future variants.

Timeout

The request timed out before a response was received.

Connect

The request could not establish a connection to the remote host.

Redirect

The request hit a redirect-handling failure.

Decode

Response body decoding failed.

Body

Request or response body-stream handling failed.

Builder

The request could not be built locally.

Request

The request failed at the HTTP request layer without a structured status.

Status

The server returned a non-success status code without a structured body.

Upgrade

HTTP 101 Switching Protocols upgrade (e.g., WebSocket); reserved for future streaming response API. Not currently produced by any in-tree transport implementation.

ResponseTooLarge

The response body exceeded the configured maximum size, so the transport refused to buffer it. Produced by the SDK’s response-size guard, not by reqwest classification.

Other

The transport failure does not match any of the named categories.

Implementations

impl TransportErrorClass

pub const fn as_str(self) -> &'static str

Returns the canonical lowercase label for this class, suitable for telemetry labels and structured log fields.

Trait Implementations

impl Clone for TransportErrorClass

fn clone(&self) -> TransportErrorClass

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Copy for TransportErrorClass

impl Debug for TransportErrorClass

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

Formats the value using the given formatter.

impl Display for TransportErrorClass

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

Formats the value using the given formatter.

impl Eq for TransportErrorClass

impl Hash for TransportErrorClass

fn hash<__H>(&self, state: &mut __H)

where __H: Hasher,

Feeds this value into the given Hasher.

fn hash_slice<H>(data: &[Self], state: &mut H)

where H: Hasher, Self: Sized,

Feeds a slice of this type into the given Hasher.

impl PartialEq for TransportErrorClass

fn eq(&self, other: &TransportErrorClass) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl StructuralPartialEq for TransportErrorClass