Enum LiteError 

pub enum LiteError {
    Storage {
        detail: String,
    },
    LockPoisoned,
    JoinError {
        detail: String,
    },
    Serialization {
        detail: String,
    },
    InvalidNamespace {
        ns: u8,
    },
    BadRequest {
        detail: String,
    },
    CollectionNotFound {
        engine: &'static str,
        collection: String,
    },
    UniqueViolation {
        collection: String,
        detail: String,
    },
    NotNullViolation {
        collection: String,
        column: String,
    },
    Sync {
        detail: String,
    },
    Query(String),
    ArrowTypeConversion {
        expected: String,
        got: String,
    },
    Backpressure {
        detail: String,
    },
    Unsupported {
        detail: String,
    },
    WorkerFailed {
        detail: String,
    },
    Encryption {
        detail: String,
    },
    Corrupted {
        detail: String,
    },
    FtsIndex {
        collection: String,
        detail: String,
    },
    TextIndexMissing {
        collection: String,
        field: String,
    },
    FtsQueryInvalid {
        collection: String,
        detail: String,
    },
    FtsSearch {
        collection: String,
        detail: String,
    },
    CounterFault {
        collection: String,
        fault: CounterFault,
    },
    TypeMismatch {
        collection: String,
        detail: String,
    },
    DataException {
        detail: String,
    },
    NumericValueOutOfRange {
        detail: String,
    },
    UndefinedObject {
        object: String,
    },
    ObjectNotReady {
        object: String,
        detail: String,
    },
    ConstraintViolation {
        collection: String,
        constraint: String,
        detail: String,
    },
    RetryableRefusal {
        detail: String,
    },
    AuthorizationDenied {
        resource: String,
    },
    PrevalidationRejected {
        reason: String,
    },
}

Errors specific to the Lite embedded engine.

Variants

Storage

Fields

detail: String

LockPoisoned

JoinError

Fields

detail: String

Serialization

Fields

detail: String

InvalidNamespace

Fields

ns: u8

BadRequest

Fields

detail: String

CollectionNotFound

A statement named a collection the engine it addressed does not hold. Maps to collection_not_found at the public API boundary.

Fields

engine: &'static str

collection: String

UniqueViolation

A write that would duplicate a declared unique key. Maps to SQLSTATE 23505 at the SQL boundary.

Fields

collection: String

detail: String

NotNullViolation

A write that would store NULL in a NOT NULL column. Maps to SQLSTATE 23502 at the SQL boundary.

Fields

collection: String

column: String

Sync

Fields

detail: String

Query(String)

ArrowTypeConversion

Fields

expected: String

got: String

Backpressure

Fields

detail: String

Unsupported

Feature or SQL construct not supported in this Lite beta release.

Fields

detail: String

WorkerFailed

The OPFS worker bridge failed to start or encountered an IPC error.

This variant is produced when PagedbStorage::open_opfs cannot spawn the dedicated Web Worker or when the worker signals a corruption-class failure that cannot be recovered automatically (OPFS has no rename).

Fields

detail: String

Encryption

An error during key derivation, salt I/O, or encryption setup.

Fields

detail: String

Corrupted

A corruption-class failure surfaced from the storage backend.

Kept as a distinct variant (rather than folded into LiteError::Storage) so the corruption signal survives the error-type conversions and reaches the open-sequence recovery driver, which renames the corrupt store aside, recreates a fresh one, and retries the open exactly once.

Fields

detail: String

FtsIndex

A full-text index update failed while writing a document.

The write that triggered it must fail too: the row and its postings are written together, and nothing re-indexes the gap afterwards — the next write to the document only indexes its new text, so a swallowed failure leaves the document permanently missing from (or stale in) the index.

Fields

collection: String

detail: String

TextIndexMissing

A full-text read named a field no document of the collection holds as text, while other fields of the collection are text-indexed. Maps to a bad-request error at the public API boundary.

Fields

collection: String

field: String

FtsQueryInvalid

A full-text query the index cannot run, such as a query with only negated terms. Maps to a bad-request error at the public API boundary.

Fields

collection: String

detail: String

FtsSearch

A full-text index read failed. The search fails with it: an empty result would claim that no document matches.

Fields

collection: String

detail: String

CounterFault

A KV counter atomic read a stored value it cannot parse as a number, or computed a result out of range. Maps to SQLSTATE 22P02 or 22003 at the SQL boundary, the same as Origin.

Fields

collection: String

fault: CounterFault

TypeMismatch

A value of the wrong kind for its target: a KV atomic on a typed row with no column of the type it reads, a text element in a VECTOR literal, a scalar write onto a nested CRDT container. collection is empty when the fault names no collection. SQLSTATE 42804.

Fields

collection: String

detail: String

DataException

An input the engine cannot compute on: a vector of the wrong dimension, or index input it cannot use. The same public error Origin raises for the same fault, SQLSTATE 22000.

Fields

detail: String

NumericValueOutOfRange

A value past the range of its numeric type: an integer wider than its column, a constant that overflows. SQLSTATE 22003.

Fields

detail: String

UndefinedObject

A statement or CRDT operation named an object that does not exist, such as a document absent at the requested version. SQLSTATE 42704.

Fields

object: String

ObjectNotReady

The object exists, but not in the state the request needs, such as a CRDT version below the compaction boundary. SQLSTATE 55000.

Fields

object: String

detail: String

ConstraintViolation

A named constraint refused a write. constraint names the constraint. SQLSTATE class 23.

Fields

collection: String

constraint: String

detail: String

RetryableRefusal

The request applied nothing it reports as done. The same request succeeds once a transient condition clears: missing causal history arrives, or a full queue drains. Retriable.

Fields

detail: String

AuthorizationDenied

The caller is not allowed to perform the request: expired auth or a delta signature that does not check out.

Fields

resource: String

PrevalidationRejected

A pre-validation gate refused the request, such as a replayed sync sequence number. The same request fails the same way every time.

Fields

reason: String

Implementations

impl LiteError

pub fn collection_not_found( engine: &'static str, collection: impl Into<String>, ) -> Self

collection is not a collection of engine ("strict", "columnar").

Trait Implementations

impl Debug for LiteError

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

Formats the value using the given formatter.

impl Display for LiteError

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

Formats the value using the given formatter.

impl Error for LiteError

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<CrdtError> for LiteError

Exhaustive, so a new CRDT error picks its own class rather than defaulting to Storage.

fn from(e: CrdtError) -> Self

Converts to this type from the input type.

impl From<EvalError> for LiteError

Expression evaluation failure: division or modulo by a zero divisor, a call to a function no evaluator implements, or a function argument it cannot compute on (vectors of different dimensions, an argument of the wrong type, a malformed JSONPath). SQL requires each to fail the statement rather than fold the row to NULL. Mapped to LiteError::Query so it surfaces to the caller instead of silently filtering rows out. An exact aggregate total out of range is LiteError::NumericValueOutOfRange, the class Origin gives it.

fn from(e: EvalError) -> Self

Converts to this type from the input type.

impl From<LiteError> for NodeDbError

fn from(e: LiteError) -> Self

Converts to this type from the input type.

impl From<PagedbError> for LiteError

fn from(e: PagedbError) -> Self

Converts to this type from the input type.

impl From<SchemaError> for LiteError

fn from(e: SchemaError) -> Self

Converts to this type from the input type.

impl From<SqlError> for LiteError

Exhaustive, so a new planner error picks its own class rather than defaulting to a plan error.

fn from(e: SqlError) -> Self

Converts to this type from the input type.

impl From<VectorError> for LiteError

A vector engine error, classified as Origin classifies it: an input vector of the wrong dimension, or index input the engine cannot use, is the caller’s data error; a memory budget refusal is backpressure; a stored-data or checkpoint failure is corruption.

fn from(e: VectorError) -> Self

Converts to this type from the input type.