Enum ApiaryError 

pub enum ApiaryError {
    Storage {
        message: String,
        source: Option<Box<dyn Error + Send + Sync>>,
    },
    NotFound {
        key: String,
    },
    WriteConflict {
        key: String,
    },
    AlreadyExists {
        entity_type: String,
        name: String,
    },
    EntityNotFound {
        entity_type: String,
        name: String,
    },
    Schema {
        message: String,
    },
    MemoryExceeded {
        bee_id: BeeId,
        budget: u64,
        requested: u64,
    },
    TaskTimeout {
        message: String,
    },
    TaskAbandoned {
        message: String,
    },
    Config {
        message: String,
    },
    Resolution {
        path: String,
        reason: String,
    },
    Unsupported {
        message: String,
    },
    Ledger {
        frame_id: FrameId,
        message: String,
    },
    Internal {
        message: String,
    },
    Conflict {
        message: String,
    },
    Serialization(String),
}

The unified error type for all Apiary operations.

Variants

Storage

A storage operation failed.

Fields

message: String

Human-readable description of the failure.

source: Option<Box<dyn Error + Send + Sync>>

The underlying error, if available.

NotFound

The requested key was not found in storage.

Fields

key: String

The storage key that was not found.

WriteConflict

A conditional write conflict occurred (another writer committed first).

Fields

key: String

The storage key where the conflict occurred.

AlreadyExists

An entity with this name already exists.

Fields

entity_type: String

The type of entity (e.g., “Hive”, “Frame”).

name: String

The conflicting name.

EntityNotFound

The requested entity was not found in the registry.

Fields

entity_type: String

The type of entity (e.g., “Hive”, “Frame”).

name: String

The name that was not found.

Schema

A schema validation error occurred during a write.

Fields

message: String

Description of the schema mismatch.

MemoryExceeded

A bee exceeded its memory budget.

Fields

bee_id: BeeId

The bee that exceeded its budget.

budget: u64

The memory budget in bytes.

requested: u64

The amount of memory requested in bytes.

TaskTimeout

A task exceeded its timeout.

Fields

message: String

Description of the timed-out task.

TaskAbandoned

A task was abandoned after exceeding the retry limit.

Fields

message: String

Description including attempt history.

Config

Invalid configuration was provided.

Fields

message: String

Description of the configuration problem.

Resolution

A frame path could not be resolved.

Fields

path: String

The path that could not be resolved.

reason: String

The reason resolution failed.

Unsupported

An unsupported operation was attempted.

Fields

message: String

Description of the unsupported operation.

Ledger

A ledger operation failed.

Fields

frame_id: FrameId

The frame whose ledger had an error.

message: String

Description of the ledger error.

Internal

An internal error (bug).

Fields

message: String

Description of the internal error.

Conflict

A conflict occurred during a DDL operation after max retries.

Fields

message: String

Description of the conflict.

Serialization(String)

Serialization or deserialization error.

Implementations

impl ApiaryError

pub fn storage( message: impl Into<String>, source: impl Error + Send + Sync + 'static, ) -> Self

Create a storage error from a message and source error.

pub fn storage_msg(message: impl Into<String>) -> Self

Create a storage error from a message only.

Trait Implementations

impl Debug for ApiaryError

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

Formats the value using the given formatter.

impl Display for ApiaryError

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

Formats the value using the given formatter.

impl Error for ApiaryError

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.