Enum HttpError 

#[non_exhaustive]
pub enum HttpError {
    BodyNotUtf8,
    EmptyBody,
    Internal {
        source: Box<dyn Error + Send + Sync + 'static>,
    },
    MethodNotAllowed {
        allowed: &'static str,
    },
    NotAcceptable,
    NotFound {
        method: String,
        path: String,
    },
    Unprocessable {
        detail: String,
    },
    UnsupportedMediaType {
        received: Option<String>,
    },
}

HTTP-layer errors returned by the conversion API.

Each variant maps to a specific HTTP status code and is serialized as an RFC 7807 Problem JSON body via IntoResponse.

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.

BodyNotUtf8

The request body bytes are not valid UTF-8.

→ HTTP 400 Bad Request.

EmptyBody

The request body was empty (Content-Length: 0 or no body).

→ HTTP 400 Bad Request.

Internal

An unexpected internal error occurred during conversion.

The source error is captured for observability (sent to Sentry via sentry::capture_error, logged at warn! in stderr) and drives the error chain visible to operators. It is never exposed to the HTTP client — the RFC 7807 response detail is always the generic “An unexpected error occurred during conversion” string.

→ HTTP 500 Internal Server Error.

Fields

source: Box<dyn Error + Send + Sync + 'static>

The underlying error that caused this internal failure.

MethodNotAllowed

The HTTP method is not supported on this endpoint.

→ HTTP 405 Method Not Allowed (response includes an Allow header).

Fields

allowed: &'static str

Comma-separated list of allowed methods for this endpoint.

NotAcceptable

The Accept header excludes all formats this server produces.

→ HTTP 406 Not Acceptable.

NotFound

No route matches the requested method + path.

→ HTTP 404 Not Found.

Fields

method: String

The HTTP method of the unmatched request (e.g. "GET").

path: String

The path of the unmatched request (e.g. "/unknown").

Unprocessable

Document conversion failed due to invalid or malformed input.

→ HTTP 422 Unprocessable Entity.

Fields

detail: String

Explanation of what made the input invalid.

UnsupportedMediaType

The Content-Type header is not one of the supported types: text/markdown, text/html, or application/vnd.openxmlformats-officedocument.wordprocessingml.document.

→ HTTP 415 Unsupported Media Type.

Fields

received: Option<String>

The content-type that was received, if any.

Implementations

impl HttpError

pub fn error_class(&self) -> &'static str

Returns a stable, low-cardinality string identifying the error class. Safe to use as a Prometheus label value — never contains per-request data.

pub fn result_class(&self) -> &'static str

Returns the result class for Prometheus labels: "client_error" for 4xx, "server_error" for 5xx.

pub fn internal<E>(source: E) -> Self

where E: Error + Send + Sync + 'static,

Wrap an unexpected internal error as HttpError::Internal.

The source is preserved end-to-end for observability — it flows to Sentry via sentry::capture_error (walking the core::error::Error::source chain) and is logged at warn! level via core::fmt::Debug formatting.

Trait Implementations

impl Debug for HttpError

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

Formats the value using the given formatter.

impl IntoResponse for HttpError

fn into_response(self) -> Response

Convert this error into an HTTP response with an RFC 7807 Problem JSON body.

Sets Content-Type: application/problem+json; charset=utf-8 and a JSON body with exactly four fields: type, title, status, detail. HttpError::MethodNotAllowed additionally sets the Allow response header.