Enum StoreError 

#[non_exhaustive]
pub enum StoreError {
    Invalid(Cow<'static, str>),
    PartSubtreeMismatch,
    RangeNotSatisfiable {
        len: u64,
    },
    Unsupported(Cow<'static, str>),
    SessionGone,
    Corrupt(Cow<'static, str>),
    Full,
    Unavailable(BoxError),
}

Why a storage call failed. A failed precondition is not an error: it is crate::BatchOutcome::PreconditionFailed.

The pipeline maps these to a crate::ServerError; storage text never reaches a client.

Variants (Non-exhaustive)

Non-exhaustive enums could have additional variants added in future. Therefore, when matching against variants of non-exhaustive enums, an extra wildcard arm must be added to account for any future variants.

Invalid(Cow<'static, str>)

The request breaks the contract: an oversize key, value or batch, a scan limit of 0, a malformed byte range, or a blob whose bytes do not match its key or declared length. Nothing was written.

PartSubtreeMismatch

A staged part’s subtree hash differs from its authenticated commitment.

RangeNotSatisfiable

A byte range starts at or past the end of a blob of len bytes (HTTP 416 on the serving path).

Fields

len: u64

The blob’s length.

Unsupported(Cow<'static, str>)

The store’s crate::StoreCapabilities exclude the request, e.g. a non-ref key on a RefsOnly store or a multi-write batch on a store without atomic_multi_key. Nothing was written.

SessionGone

The multipart storage session was aborted, completed or reclaimed.

Corrupt(Cow<'static, str>)

A stored value failed to decode (unknown codec version, wrong length).

Full

The partition is at its storage cap and rejects writes that add data. Reads and delete-only batches keep working, so pruning still runs (Durable Objects and SQLite report SQLITE_FULL; see https://developers.cloudflare.com/durable-objects/platform/limits/). The pipeline answers a retryable unavailable (“storage partition full”), never resource_exhausted.

Unavailable(BoxError)

The backend failed or could not be reached. The outcome of an apply that fails this way is unknown: the pipeline re-reads.

Implementations

impl StoreError

pub fn unavailable(source: impl Into<BoxError>) -> Self

StoreError::Unavailable wrapping source.

Trait Implementations

impl Debug for StoreError

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

Formats the value using the given formatter.

impl Display for StoreError

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

Formats the value using the given formatter.

impl Error for StoreError

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<SqlError> for StoreError

fn from(e: SqlError) -> Self

Converts to this type from the input type.

impl From<StoreError> for WatermarkError

fn from(source: StoreError) -> Self

Converts to this type from the input type.