Enum ErrorCode 

pub enum ErrorCode {
    TransportError,
    ResolverError,
    CacheMiss,
    NotFound,
    ValidationError,
    AuthorizationError,
    Timeout,
    Conflict,
    InternalError,
}

Canonical error code. Transport adapters project this into GraphQL errors, MQTT error topics, SSE error frames, etc.

Why NotFound, AuthorizationError and Conflict exist

These three are not convenience aliases. Each separates two outcomes that must never be collapsed, because collapsing them turns a fail-closed decision into an indistinguishable one:

• NotFound vs ErrorCode::CacheMiss: an authoritative store that holds no such entity is a fact about the data; a cache miss is a fact about the lookup path. A caller that retries a CacheMiss against the authority must not silently succeed-as-empty on a NotFound.
• AuthorizationError vs ErrorCode::ResolverError: a denial is a deliberate, audited policy outcome. A resolver that fails is a bug or a dependency fault. Reporting a denial as ResolverError makes a revoked grant indistinguishable from a domain failure, so an operator cannot tell an attack from an outage.
• Conflict vs ErrorCode::ValidationError: a compare-and-set that lost the race is a retryable outcome, not an invalid input. Sharing a code with ValidationError would tell the caller its input was wrong when its input was fine and merely stale.

Callers that must fail closed on a denial should match ErrorCode::AuthorizationError and must not fall through to the authority on it; see specs/core.toml [types.ErrorCode].

Variants

TransportError

Transport-level failure.

ResolverError

Resolver could not fulfil the query.

CacheMiss

Authoritative miss and no resolver.

NotFound

The named resource does not exist at the authoritative store.

ValidationError

Input failed validation.

AuthorizationError

The principal is not permitted to perform this operation.

Timeout

Deadline exceeded.

Conflict

A concurrent modification lost the compare-and-set race.

InternalError

Unexpected internal failure.

Trait Implementations

impl Clone for ErrorCode

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Copy for ErrorCode

impl Debug for ErrorCode

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for ErrorCode

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Display for ErrorCode

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

Formats the value using the given formatter.

impl Eq for ErrorCode

impl Hash for ErrorCode

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

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 ErrorCode

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

Equality operator ==.

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

Inequality operator !=.

impl Serialize for ErrorCode

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl StructuralPartialEq for ErrorCode