Enum EngineError 

#[non_exhaustive]
pub enum EngineError {
    Auth(AuthGate),
    InvalidWorldName,
    NotFound,
    AppendOnly,
    PayloadTooLarge {
        max: usize,
    },
    PreconditionFailed {
        message: &'static str,
    },
    QuotaExceeded {
        used: usize,
        quota: usize,
        projected: usize,
    },
    TransientStorage {
        sqlite_code: Option<i32>,
    },
    InsufficientStorage {
        sqlite_code: Option<i32>,
    },
    Storage {
        sqlite_code: Option<i32>,
    },
    SubscriptionLimit,
    ShuttingDown,
    InternalInvariant(&'static str),
}

Runtime operation errors reported by the Engine facade.

Distinct from EngineBuildError: these are per-operation failures returned by Engine::read, Engine::replace, Engine::append, Engine::delete, Engine::subscribe, and the introspection methods. The enum is #[non_exhaustive]; match on the variants you care about and route the rest through a default arm.

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.

Auth(AuthGate)

Caller’s tier is too low for the requested gate.

InvalidWorldName

The supplied world name failed canonical-path validation.

NotFound

The world does not exist.

AppendOnly

The target world is append-only and refuses delete/overwrite (for example var/log/deletes).

PayloadTooLarge

Request body exceeded the per-world byte limit.

Fields

max: usize

Configured maximum body length, in bytes.

PreconditionFailed

An If-Match / If-None-Match precondition rejected the write.

Fields

message: &'static str

Static reason string (stale, exists, …).

QuotaExceeded

Write would exceed the configured durable storage quota.

Fields

used: usize

Bytes already in use.

quota: usize

Configured quota ceiling.

projected: usize

Projected total if the write were applied.

TransientStorage

Storage is temporarily unavailable (e.g. SQLite BUSY/LOCKED). Callers should retry with backoff.

Fields

sqlite_code: Option<i32>

Underlying SQLite extended result code, when available.

InsufficientStorage

Storage backing exhausted (full disk, IO failure that maps to “no space left”). Callers must surface this as 5xx-class to operators.

Fields

sqlite_code: Option<i32>

Underlying SQLite extended result code, when available.

Storage

Generic storage failure that is neither transient nor insufficient.

Fields

sqlite_code: Option<i32>

Underlying SQLite extended result code, when available.

SubscriptionLimit

Subscription slot semaphore is exhausted.

ShuttingDown

Engine::shutdown has been called; do not start new operations.

InternalInvariant(&'static str)

Internal invariant violation. Indicates a bug in the engine.

Implementations

impl EngineError

pub fn sqlite_code(&self) -> Option<i32>

Returns the underlying SQLite extended result code, when this error originated in the storage backend.

Non-storage variants (auth, not-found, append-only, precondition, quota, subscription-limit, shutting-down, internal-invariant) always return None. Adapters can use this for protocol-specific code mapping without inspecting the variant.

Trait Implementations

impl Debug for EngineError

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

Formats the value using the given formatter.