Enum SubscriptionError 

pub enum SubscriptionError {
    Sqlx(Error),
    LaneMismatch(String),
    Job(JobError),
    StateDecode(Error),
    NoSuchJob {
        subscriber_type: String,
        key: String,
    },
    CaughtUpTimeout {
        checkpoint: StreamPosition,
        target: StreamPosition,
        waited: Duration,
    },
}

Failure modes of the checkpoint read-back and the caught-up barrier.

Variants

Sqlx(Error)

Reading the stream frontier failed.

LaneMismatch(String)

The stored checkpoint is on the other Lane from the one this handle is typed for; the two cursors count different things.

Job(JobError)

Reading the handler job failed — a snapshot load (including the job never having existed), or a checkpoint point-read whose stored state did not decode.

StateDecode(Error)

The committed execution state did not decode as the handler job’s state type — the checkpoint is unreadable rather than absent.

NoSuchJob

A keyed member’s job could not be resolved from (subscriber_type, key) — no job of that type has ever been spawned under the key. Distinct from a cancelled subscription, whose job rows outlive the subscriptions row.

Fields

subscriber_type: String

key: String

CaughtUpTimeout

Subscription::await_position — or await_caught_up, which delegates to it — hit its deadline. Carries the observed lag so the caller can alert with real numbers instead of reporting a bare timeout.

target is the position being awaited: the caller’s own for await_position, the call-time frontier for await_caught_up. It names its lane, so on the commit lane it says which half of the fence ran out.

Fields

checkpoint: StreamPosition

target: StreamPosition

waited: Duration

Trait Implementations

impl Debug for SubscriptionError

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

Formats the value using the given formatter.

impl Display for SubscriptionError

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

Formats the value using the given formatter.

impl Error for SubscriptionError

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<Error> for SubscriptionError

fn from(source: Error) -> Self

Converts to this type from the input type.

impl From<Error> for SubscriptionError

fn from(source: Error) -> Self

Converts to this type from the input type.

impl From<JobError> for SubscriptionError

fn from(source: JobError) -> Self

Converts to this type from the input type.