Enum WriteError 

pub enum WriteError {
    Storage(StorageError),
    TooLarge {
        size: u64,
        limit: u64,
    },
    Path(Error),
    IndexerBackpressureUpsert,
    IndexerBackpressureTombstone,
    EventPublishFailed {
        after: WriteEffect,
    },
    PatchTooLarge {
        size: u64,
        limit: u64,
    },
    PatchLineOutOfRange {
        first: u64,
        last: u64,
        total_lines: u64,
        total_bytes: u64,
    },
    PatchInvalidRange {
        message: String,
    },
    InvalidManifest {
        message: String,
    },
    ReplaceNoMatch,
    ReplaceAmbiguous {
        count: u64,
    },
}

Errors returned by shared write operations.

Variants

Storage(StorageError)

Storage-layer failure.

TooLarge

Upload size exceeded the configured limit.

Fields

size: u64

Actual byte size.

limit: u64

Maximum allowed byte size.

Path(Error)

Path/domain validation failure.

IndexerBackpressureUpsert

Indexer queue was full while enqueueing an upsert.

IndexerBackpressureTombstone

Indexer queue was full while enqueueing a tombstone.

EventPublishFailed

The event log refused the change after storage had already taken it.

Mirrors the indexer backpressure variants: the caller answers 503 with Retry-After and a retried write publishes the event (D38, D55).

Fields

after: WriteEffect

What storage had already done by the time publishing failed.

PatchTooLarge

Object body exceeds the NOTEDTHAT_MAX_PATCHABLE_SIZE limit before or after splice.

Fields

size: u64

Actual byte size.

limit: u64

Maximum allowed byte size.

PatchLineOutOfRange

Requested line range is beyond the end of the object at server-side splice time.

Fields

first: u64

Requested first line.

last: u64

Requested last line.

total_lines: u64

Total line count in the object.

total_bytes: u64

Total byte count in the object (for X-Content-Range-Bytes).

PatchInvalidRange

Invalid range, mode contradiction, or missing If-Match for PATCH.

Fields

message: String

Human-readable reason.

InvalidManifest

A body written to .notedthat/manifest.json is not the manifest startup would accept: not a manifest document, naming another knowledge base, or outside the limits KbManifest::validate enforces. The message is the one the refused boot would have printed.

Fields

message: String

Human-readable reason, as startup would report it.

ReplaceNoMatch

Replace operation found no occurrence of the requested old string.

ReplaceAmbiguous

Replace operation found multiple occurrences, making single replace ambiguous.

Fields

count: u64

Number of matches found in the object body.

Trait Implementations

impl Debug for WriteError

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

Formats the value using the given formatter.

impl Display for WriteError

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

Formats the value using the given formatter.

impl Error for WriteError

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<StorageError> for WriteError

fn from(err: StorageError) -> Self

Converts to this type from the input type.