Enum DurabilityError 

pub enum DurabilityError {
    StoreError(ApiError),
    SequenceConflict {
        expected: u64,
        actual: u64,
    },
    CursorRegression {
        stored: u64,
        attempted: u64,
    },
    DedupCollision {
        key: String,
    },
    ConfigError(String),
    EphemeralStoreOpen(String),
    EphemeralStoreDetached,
    EnvelopeError(String),
}

Error taxonomy for haematite-backed durability operations.

Variants

StoreError(ApiError)

Haematite returned a store-level failure.

The umbrella From<haematite::ApiError> conversion lives in super::store because it routes the optimistic-concurrency variants to their dedicated cases rather than wrapping them here.

SequenceConflict

An append observed a different stream sequence than the caller expected.

Fields

expected: u64

Caller-provided expected stream sequence.

actual: u64

Actual stream sequence reported by haematite.

CursorRegression

A cursor checkpoint attempted to move from a stale stored value.

Fields

stored: u64

Current value stored for the cursor.

attempted: u64

Value the caller attempted to checkpoint from.

DedupCollision

A producer idempotency key collided with an existing dedup entry.

Fields

key: String

Idempotency key that collided.

ConfigError(String)

Durability configuration failed validation.

EphemeralStoreOpen(String)

An ephemeral durable store could not be opened on disk.

Raised only on the construction path of a self-owned ephemeral store (see super::store::open_ephemeral); the guarding temporary directory is already removed by the time this surfaces.

EphemeralStoreDetached

An operation reached an ephemeral store whose backing database was already detached by teardown.

Unreachable by construction: the store is detached only inside the ephemeral guard’s Drop, which cannot overlap a live handle’s call. The variant exists because that detachment is expressed through an Option the compiler cannot see through, and the fallback must be a typed refusal rather than a panic.

EnvelopeError(String)

Persisted envelope bytes could not be encoded or decoded.

Trait Implementations

impl Debug for DurabilityError

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

Formats the value using the given formatter.

impl Display for DurabilityError

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

Formats the value using the given formatter.

impl Error for DurabilityError

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<ApiError> for DurabilityError

Maps a real-engine ApiError onto liminal’s DurabilityError.

The optimistic-concurrency variants route to their dedicated DurabilityError cases (SequenceConflict, CursorRegression); everything else is a store-level failure carried verbatim.

fn from(error: ApiError) -> Self

Converts to this type from the input type.

impl From<CasMismatch> for DurabilityError

fn from(error: CasMismatch) -> Self

Converts to this type from the input type.

impl From<SequenceConflict> for DurabilityError

fn from(error: SequenceConflict) -> Self

Converts to this type from the input type.