Enum XervError 

pub enum XervError {
    ArenaCreate {
        path: PathBuf,
        cause: String,
    },
    ArenaMmap {
        path: PathBuf,
        cause: String,
    },
    ArenaWrite {
        trace_id: TraceId,
        offset: ArenaOffset,
        cause: String,
    },
    ArenaRead {
        offset: ArenaOffset,
        cause: String,
    },
    ArenaCapacity {
        requested: u64,
        available: u64,
    },
    ArenaInvalidOffset {
        offset: ArenaOffset,
        cause: String,
    },
    ArenaCorruption {
        offset: ArenaOffset,
        cause: String,
    },
    SelectorResolution {
        selector: String,
        node_id: NodeId,
        cause: String,
    },
    NonDeterministicLayout {
        type_name: String,
        cause: String,
    },
    SelectorSyntax {
        selector: String,
        cause: String,
    },
    SelectorTargetNotFound {
        field: String,
        node_id: NodeId,
    },
    SelectorTypeMismatch {
        selector: String,
        expected: String,
        actual: String,
    },
    SchemaVersionNotFound {
        schema: String,
        version: String,
    },
    SchemaIncompatible {
        from: String,
        to: String,
        cause: String,
    },
    MigrationFailed {
        from: String,
        to: String,
        cause: String,
    },
    BreakingSchemaChange {
        schema: String,
        change: String,
    },
    MigrationPathTooLong {
        from: String,
        to: String,
        max_hops: u32,
    },
    MissingBinary {
        binary: String,
        cause: String,
    },
    RuntimeMismatch {
        runtime: String,
        required: String,
        found: String,
    },
    ContainerImageUnavailable {
        image: String,
    },
    UnsupportedProfile {
        profile: String,
    },
    NodeExecution {
        node_id: NodeId,
        trace_id: TraceId,
        cause: String,
    },
    NodeTimeout {
        node_id: NodeId,
        trace_id: TraceId,
        timeout_ms: u64,
    },
    NodePanic {
        node_id: NodeId,
        trace_id: TraceId,
        message: String,
    },
    NodeConfig {
        node_id: NodeId,
        cause: String,
    },
    NodeNotFound {
        node_name: String,
    },
    NoCompatibleVersion {
        trace_id: TraceId,
        cause: String,
    },
    InvalidTopology {
        cause: String,
    },
    UncontrolledCycle {
        nodes: Vec<NodeId>,
    },
    InvalidPort {
        port: String,
        node_id: NodeId,
    },
    MissingEdge {
        from_node: NodeId,
        from_port: String,
        to_node: NodeId,
        to_port: String,
    },
    InvalidEdge {
        from_node: NodeId,
        from_port: String,
        to_node: NodeId,
        to_port: String,
    },
    PipelineNotFound {
        pipeline_id: String,
    },
    PipelineExists {
        pipeline_id: String,
    },
    ConcurrencyLimit {
        pipeline_id: String,
        current: u32,
        max: u32,
    },
    CircuitBreakerOpen {
        pipeline_id: String,
        error_rate: f64,
    },
    DrainTimeout {
        pipeline_id: String,
        pending_traces: u32,
    },
    WalWrite {
        trace_id: TraceId,
        cause: String,
    },
    WalRead {
        cause: String,
    },
    WalCorruption {
        position: u64,
        cause: String,
    },
    WalReplay {
        trace_id: TraceId,
        cause: String,
    },
    WasmLoad {
        module: String,
        cause: String,
    },
    WasmExecution {
        node_id: NodeId,
        cause: String,
    },
    WasmMemoryAlloc {
        requested: u64,
    },
    WasmHostFunction {
        function: String,
        cause: String,
    },
    YamlParse {
        path: PathBuf,
        cause: String,
    },
    ConfigValue {
        field: String,
        cause: String,
    },
    SchemaValidation {
        schema: String,
        cause: String,
    },
    Serialization(String),
    Io {
        path: PathBuf,
        cause: String,
    },
    Network {
        cause: String,
    },
}

The main error type for XERV operations.

Variants

ArenaCreate

Failed to create or open arena file.

Fields

path: PathBuf

The path where arena creation failed.

cause: String

Reason for the failure.

ArenaMmap

Failed to memory-map the arena file.

Fields

path: PathBuf

The path of the arena file.

cause: String

Reason for the mmap failure.

ArenaWrite

Arena write operation failed.

Fields

trace_id: TraceId

The trace identifier.

offset: ArenaOffset

The offset where write was attempted.

cause: String

Reason for the write failure.

ArenaRead

Arena read operation failed.

Fields

offset: ArenaOffset

The offset that could not be read.

cause: String

Reason for the read failure.

ArenaCapacity

Arena capacity exceeded.

Fields

requested: u64

Number of bytes requested.

available: u64

Number of bytes available.

ArenaInvalidOffset

Invalid arena offset.

Fields

offset: ArenaOffset

The invalid offset.

cause: String

Reason why the offset is invalid.

ArenaCorruption

Arena corruption detected.

Fields

offset: ArenaOffset

The offset where corruption was detected.

cause: String

Description of the corruption.

SelectorResolution

Failed to resolve a selector expression.

Fields

selector: String

The selector expression that failed to resolve.

node_id: NodeId

The node where resolution was attempted.

cause: String

Reason for the resolution failure.

NonDeterministicLayout

Non-deterministic layout detected (unstable offsets).

Fields

type_name: String

The type with non-deterministic layout.

cause: String

Description of the layout issue.

SelectorSyntax

Invalid selector syntax.

Fields

selector: String

The selector with invalid syntax.

cause: String

Description of the syntax error.

SelectorTargetNotFound

Selector target not found.

Fields

field: String

The field that was not found.

node_id: NodeId

The node whose output was queried.

SelectorTypeMismatch

Type mismatch in selector.

Fields

selector: String

The selector expression with type mismatch.

expected: String

The expected type.

actual: String

The actual type found.

SchemaVersionNotFound

Schema version not found.

Fields

schema: String

The schema name.

version: String

The requested version.

SchemaIncompatible

Schema incompatible with no migration.

Fields

from: String

The source schema version.

to: String

The target schema version.

cause: String

Reason why schemas are incompatible.

MigrationFailed

Migration failed.

Fields

from: String

The source schema version.

to: String

The target schema version.

cause: String

Reason for the migration failure.

BreakingSchemaChange

Breaking schema change without migration.

Fields

schema: String

The affected schema.

change: String

Description of the breaking change.

MigrationPathTooLong

Migration path too long.

Fields

from: String

The source schema version.

to: String

The target schema version.

max_hops: u32

The maximum allowed number of migration hops.

MissingBinary

Missing binary dependency.

Fields

binary: String

The name of the missing binary.

cause: String

Reason why the binary is missing.

RuntimeMismatch

Runtime version mismatch.

Fields

runtime: String

The runtime with version mismatch.

required: String

The required version.

found: String

The found version.

ContainerImageUnavailable

Container image unavailable.

Fields

image: String

The container image reference.

UnsupportedProfile

Unsupported execution profile.

Fields

profile: String

The requested execution profile.

NodeExecution

Node execution failed.

Fields

node_id: NodeId

The node that failed to execute.

trace_id: TraceId

The trace in which execution occurred.

cause: String

Reason for the execution failure.

NodeTimeout

Node timeout.

Fields

node_id: NodeId

The node that timed out.

trace_id: TraceId

The trace in which timeout occurred.

timeout_ms: u64

Timeout duration in milliseconds.

NodePanic

Node panic.

Fields

node_id: NodeId

The node that panicked.

trace_id: TraceId

The trace in which panic occurred.

message: String

The panic message.

NodeConfig

Invalid node configuration.

Fields

node_id: NodeId

The node with invalid configuration.

cause: String

Description of the configuration error.

NodeNotFound

Node not found.

Fields

node_name: String

The name of the node that was not found.

NoCompatibleVersion

No compatible version for migration.

Fields

trace_id: TraceId

The trace for which no compatible version was found.

cause: String

Reason why no compatible version is available.

InvalidTopology

Invalid flow topology.

Fields

cause: String

Description of the topology issue.

UncontrolledCycle

Cycle detected without loop controller.

Fields

nodes: Vec<NodeId>

The nodes involved in the cycle.

InvalidPort

Invalid port reference.

Fields

port: String

The port name that is invalid.

node_id: NodeId

The node with the invalid port.

MissingEdge

Missing required edge.

Fields

from_node: NodeId

The source node.

from_port: String

The source port.

to_node: NodeId

The destination node.

to_port: String

The destination port.

InvalidEdge

Invalid edge (references non-existent node or port).

Fields

from_node: NodeId

The source node.

from_port: String

The source port.

to_node: NodeId

The destination node.

to_port: String

The destination port.

PipelineNotFound

Pipeline not found.

Fields

pipeline_id: String

The pipeline identifier that was not found.

PipelineExists

Pipeline already exists.

Fields

pipeline_id: String

The pipeline identifier that already exists.

ConcurrencyLimit

Pipeline concurrency limit reached.

Fields

pipeline_id: String

The pipeline identifier.

current: u32

Current number of concurrent executions.

max: u32

Maximum allowed concurrent executions.

CircuitBreakerOpen

Pipeline circuit breaker triggered.

Fields

pipeline_id: String

The pipeline identifier.

error_rate: f64

The error rate that triggered the circuit breaker.

DrainTimeout

Pipeline drain timeout.

Fields

pipeline_id: String

The pipeline identifier.

pending_traces: u32

Number of traces still pending.

WalWrite

WAL write failed.

Fields

trace_id: TraceId

The trace being written to the WAL.

cause: String

Reason for the write failure.

WalRead

WAL read failed.

Fields

cause: String

Reason for the read failure.

WalCorruption

WAL corruption detected.

Fields

position: u64

The position in the WAL where corruption was detected.

cause: String

Description of the corruption.

WalReplay

WAL replay failed.

Fields

trace_id: TraceId

The trace being replayed from the WAL.

cause: String

Reason for the replay failure.

WasmLoad

WASM module loading failed.

Fields

module: String

The WASM module that failed to load.

cause: String

Reason for the load failure.

WasmExecution

WASM execution failed.

Fields

node_id: NodeId

The node running WASM that failed.

cause: String

Reason for the execution failure.

WasmMemoryAlloc

WASM memory allocation failed.

Fields

requested: u64

Number of bytes requested for allocation.

WasmHostFunction

WASM host function error.

Fields

function: String

The host function name that failed.

cause: String

Reason for the function failure.

YamlParse

YAML parsing failed.

Fields

path: PathBuf

The path to the YAML file.

cause: String

Reason for the parse failure.

ConfigValue

Invalid configuration value.

Fields

field: String

The configuration field with invalid value.

cause: String

Description of why the value is invalid.

SchemaValidation

Schema validation failed.

Fields

schema: String

The schema being validated.

cause: String

Reason for the validation failure.

Serialization(String)

Serialization/deserialization error.

Tuple Fields

0: String

The serialization error message.

Io

File I/O error.

Fields

path: PathBuf

The path where the I/O error occurred.

cause: String

Description of the I/O error.

Network

Network error.

Fields

cause: String

Description of the network error.

Implementations

impl XervError

pub fn code(&self) -> &'static str

Get the error code (e.g., “E001”).

pub fn is_retriable(&self) -> bool

Check if this error is retriable.

pub fn is_config_error(&self) -> bool

Check if this error is a configuration/validation error.

pub fn is_schema_error(&self) -> bool

Check if this error is a schema evolution error.

Trait Implementations

impl Debug for XervError

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

Formats the value using the given formatter.

impl Display for XervError

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

Formats the value using the given formatter.

impl Error for XervError

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.