Enum ClientError 

pub enum ClientError {
    Transport(String),
    Auth(String),
    NotFound(String),
    InvalidRequest(String),
    Server {
        status: u16,
        body: Value,
    },
    Config(String),
    Ws(String),
    ProtocolVersion {
        client_version: u32,
    },
}

Errors from the cloacina-server client.

Variants

Transport(String)

Transport-level failure: connect, TLS, timeout, DNS.

Auth(String)

401 / 403 — missing, invalid, or under-privileged API key.

NotFound(String)

404 — the addressed resource does not exist.

InvalidRequest(String)

400 / 422 — the server rejected the request as malformed.

Server

Any other non-2xx — business-logic rejection or server fault. body is the raw response JSON (canonically {error, code}).

Fields

status: u16

body: Value

Config(String)

Configuration problems (profile resolution, key schemes).

Ws(String)

WebSocket / delivery-protocol failures.

ProtocolVersion

The server rejected our delivery protocol version (close 4426). Reconnecting cannot help — upgrade the client.

Fields

client_version: u32

Implementations

impl ClientError

pub fn from_status(status: u16, body: Value) -> Self

Map an HTTP status + canonical {error, code} body to a variant.

pub fn code(&self) -> Option<&str>

Machine-readable code from the canonical error body, when present.

Trait Implementations

impl Debug for ClientError

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

Formats the value using the given formatter.

impl Display for ClientError

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

Formats the value using the given formatter.

impl Error for ClientError

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.