Enum Error 

pub enum Error {
    InvalidInput {
        message: String,
    },
    NotFound {
        resource: String,
    },
    PayloadTooLarge {
        size: u64,
        limit: u64,
    },
    BucketNameTooLong {
        name: String,
        len: usize,
    },
    Config {
        message: String,
    },
    Storage(StorageError),
    MalformedRange(String),
    NotModified,
    PreconditionFailed,
    RangeNotSatisfiable {
        complete_length: u64,
    },
}

Domain error mapped to §6.12 HTTP status codes. This is the general error for the API layer — storage-specific errors use StorageError.

Variants

InvalidInput

Input from the client was invalid (e.g., malformed slug, invalid path).

Fields

message: String

Human-readable description of what was invalid.

NotFound

The requested resource was not found.

Fields

resource: String

Identifies the missing resource (e.g., "kb:my-notes").

PayloadTooLarge

The request payload exceeded the allowed size limit.

Fields

size: u64

The actual payload size in bytes.

limit: u64

The maximum allowed size in bytes.

BucketNameTooLong

The derived S3 bucket name exceeds 63 characters.

Fields

name: String

The full bucket name that was too long.

len: usize

The length in bytes of the too-long name.

Config

A required configuration value was missing or invalid.

Fields

message: String

Human-readable description of the configuration problem.

Storage(StorageError)

A storage-layer error (see StorageError).

MalformedRange(String)

Malformed Range: bytes= header — unparseable syntax. Maps to HTTP 400.

NotModified

Backend returned 304 Not Modified (conditional request). Maps to HTTP 304.

PreconditionFailed

Backend returned 412 Precondition Failed (conditional request). Maps to HTTP 412.

RangeNotSatisfiable

Backend returned 416 Range Not Satisfiable. complete_length is the total object size. Maps to HTTP 416 with Content-Range: bytes */complete_length.

Fields

complete_length: u64

The total size of the object in bytes.

Trait Implementations

impl Debug for Error

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

Formats the value using the given formatter.

impl Display for Error

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

Formats the value using the given formatter.

impl Error for Error

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<SearchError> for Error

fn from(e: SearchError) -> Self

Converts to this type from the input type.

impl From<StorageError> for Error

fn from(err: StorageError) -> Self

Converts to this type from the input type.