Enum RouteError 

pub enum RouteError {
    SchemaVersionMismatch {
        expected: String,
        found: String,
    },
    EmptySentinel {
        field: &'static str,
    },
    UnknownEventName {
        received: String,
    },
    UnknownEnumName {
        field: &'static str,
        received: String,
    },
    InvalidFrameContext {
        detail: String,
    },
    InvalidPayloadRef {
        index: usize,
        detail: String,
    },
    InvalidEventEnvelope {
        detail: String,
    },
    AdapterIdNotFound {
        adapter_id: String,
    },
    AdapterVersionMismatch {
        adapter_id: String,
        requested: String,
        registered: String,
    },
}

Reasons the router refused a crate::CallbackRequest before dispatch.

Variants are intentionally fine-grained: each acceptance-criterion failure class gets its own variant so a future super::FailureMapper can map them onto distinct crate::FailureClass values without inspecting strings.

Variants

SchemaVersionMismatch

schema_version on the inbound request did not match the router’s compiled-in crate::SCHEMA_VERSION.

Fields

expected: String

found: String

EmptySentinel

A required identifier was the empty sentinel string. Carries the field path for diagnostics.

Fields

field: &'static str

UnknownEventName

The deserialized request carried an event-kind value that is not part of the wire vocabulary.

In practice serde rejects unknown enum wire names at deserialize time, but the variant exists so non-serde call sites (e.g. a future text-protocol bridge) can surface the same failure class without inventing a parallel error type.

Fields

received: String

UnknownEnumName

The deserialized request carried an enum value other than the event kind (e.g. integration_mode) whose wire name is not in the vocabulary. Preserved as a separate variant from Self::UnknownEventName so the failure class is unambiguous when mapping to a receipt.

Fields

field: &'static str

received: String

InvalidFrameContext

frame_context violated a structural invariant: required for the event but absent, or partially populated (e.g. parent_frame_id without frame_id, or any frame field set without frame_class).

Fields

detail: String

InvalidPayloadRef

A payload reference failed structural validation (empty payload_id / payload_kind). Body semantics are opaque to the router — this only catches sentinel-empty fields on the reference itself.

Fields

index: usize

detail: String

InvalidEventEnvelope

The request’s event is structurally illegal for this envelope (e.g. receipt.emitted carrying an idempotency_key). Distinct from frame-context errors so the failure class is unambiguous.

Fields

detail: String

AdapterIdNotFound

No registered adapter has an adapter_id matching the request. Distinct from Self::AdapterVersionMismatch.

Fields

adapter_id: String

AdapterVersionMismatch

An adapter with the requested adapter_id is registered, but its adapter_version does not match the request. Carries both versions so a client can surface a precise upgrade suggestion.

Fields

adapter_id: String

requested: String

registered: String

Trait Implementations

impl Clone for RouteError

fn clone(&self) -> RouteError

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for RouteError

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

Formats the value using the given formatter.

impl Display for RouteError

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

Formats the value using the given formatter.

impl Error for RouteError

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<&RouteError> for FailureClass

fn from(err: &RouteError) -> Self

Converts to this type from the input type.

impl PartialEq for RouteError

fn eq(&self, other: &RouteError) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl Eq for RouteError

impl StructuralPartialEq for RouteError