Enum OriginError 

pub enum OriginError {
    UnsupportedEncoding {
        encoding: Box<str>,
    },
    MalformedEncoding,
    DecompressionFailed {
        encoding: SupportedEncoding,
        source: Error,
    },
}

Errors raised by the crate::origin::HttpOrigin decompression layer.

Surfaced to the engine through the anyhow::Error source on CacheError::OriginError (the Origin trait returns anyhow::Result). Use CacheError::origin_error_kind to recover the typed variant — the chain walk works through any number of with_context wrappers.

Variants

UnsupportedEncoding

The response advertised a Content-Encoding value the origin layer does not understand. We refuse to silently pass the bytes through — the BLAKE3 verify in the engine would fail, but with a confusing “hash mismatch” message rather than a precise “your origin is using an encoding I don’t support” message.

encoding is Box<str> rather than String to keep the variant 16 bytes on a 64-bit target — error enums get cloned/passed around the chain a lot, and the underlying buffer is never resized after construction.

Fields

encoding: Box<str>

The raw header value the origin sent.

MalformedEncoding

The response carried a non-ASCII Content-Encoding byte sequence that we refuse to interpret. RFC 9110 § 5.6.7 restricts coding names to ASCII tokens; treating an arbitrary byte sequence as “no encoding” would silently pass through what may be a real (mis-cased / mis-typed) compression directive.

DecompressionFailed

Decompression of the response body failed mid-stream. Either the origin sent a corrupt payload or an encoding mismatch slipped past the header check (e.g. Content-Encoding: gzip but the bytes are actually zstd). The encoding field is typed (closed set) so nonsense values are unrepresentable — this variant is reachable only from the gzip and zstd code paths.

Fields

encoding: SupportedEncoding

The supported encoding whose decoder rejected the body.

source: Error

Underlying decoder error.

Trait Implementations

impl Debug for OriginError

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

Formats the value using the given formatter.

impl Display for OriginError

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

Formats the value using the given formatter.

impl Error for OriginError

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.