Enum ServerError 

pub enum ServerError {
    Config {
        message: String,
    },
    UnsafeDataRootAncestor {
        data_root: PathBuf,
        component: PathBuf,
        reason: String,
    },
    TransportBind {
        transport: &'static str,
        address: SocketAddr,
        message: String,
    },
    Transport {
        transport: &'static str,
        message: String,
    },
    SignalListener {
        listener: &'static str,
        message: String,
    },
    Namespace {
        message: String,
    },
    EngineCall {
        source: EngineError,
    },
    StoreBackend {
        source: StoreError,
    },
    Stream {
        failure: StreamFailure,
    },
    WorkerDispatch {
        namespace: String,
        activity_type: String,
        reason: String,
    },
    WorkerConnectionLost {
        channel: String,
        detail: String,
    },
    LockPoisoned {
        resource: &'static str,
    },
    Wire {
        wire: WireError,
    },
}

Server-library error taxonomy.

Variants

Config

Operator configuration could not be loaded or validated.

Fields

message: String

Redacted, operator-facing failure message.

UnsafeDataRootAncestor

A path-ambient store backend was configured beneath a renameable directory.

Fields

data_root: PathBuf

Descriptor-resolved data root that the backend would use by pathname.

component: PathBuf

First unsafe component in the resolved root’s ancestor chain.

reason: String

Ownership, mode, or inspection failure that made the component unsafe.

TransportBind

A transport listener could not bind or start.

Fields

transport: &'static str

Transport name.

address: SocketAddr

Configured listener address.

message: String

Redacted, operator-facing failure message.

Transport

A running transport task aborted: it panicked or was cancelled.

Fields

transport: &'static str

Transport name.

message: String

Redacted, operator-facing failure message.

SignalListener

A termination-signal listener could not be installed or failed.

Fields

listener: &'static str

Listener name (SIGTERM, SIGINT, or the portable fallback).

message: String

Redacted, operator-facing failure message.

Namespace

Namespace validation or authorization failed.

Fields

message: String

Redacted namespace failure message.

EngineCall

Engine call failed.

Fields

source: EngineError

Typed engine error returned by the embedded engine.

StoreBackend

Store backend call failed before an engine handle was available.

Fields

source: StoreError

Typed store error returned by the configured backend.

Stream

Streaming failure.

Fields

failure: StreamFailure

Stream failure class.

WorkerDispatch

A scheduled activity could not be pushed to a worker.

Fields

namespace: String

Namespace scoped before dispatch.

activity_type: String

Activity type requested by the engine.

reason: String

Redacted dispatch failure reason.

WorkerConnectionLost

The worker connection chosen for a dispatch was lost mid-flight: the connection was already gone at push time, or it closed before the worker sent its correlated push reply.

This is DISTINCT from Self::WorkerDispatch: a WorkerDispatch covers a genuine reply timeout (the worker is alive but slow), a no-worker-available selection failure, or any other dispatch fault, all of which keep the outbox’s normal exponential backoff. A WorkerConnectionLost instead means the chosen worker is gone (and has already been deregistered by liminal’s on_worker_unregistered), so the row can be re-armed for IMMEDIATE re-claim to fail over to a live worker without waiting out the backoff. The outbox dispatcher keys its fast-failover decision on this variant.

Fields

channel: String

Row-derived dispatch channel for operator diagnostics.

detail: String

Redacted, operator-facing description of how the connection was lost.

LockPoisoned

A lock was poisoned and the protected state cannot be trusted.

Fields

resource: &'static str

Protected resource name.

Wire

A failure already translated into the public wire taxonomy.

Fields

wire: WireError

Stable wire error.

Implementations

impl ServerError

pub fn to_wire_error(&self) -> WireError

Convert a server error that crosses a transport boundary into the stable public wire taxonomy.

pub const fn is_config(&self) -> bool

Return true when this is an operator configuration failure.

pub fn namespace_denied(message: impl Into<String>) -> Self

Construct a namespace-denied error without embedding authorization logic.

pub fn placement_admission_denied( namespace: &str, worker_node: Option<&str>, required: &BTreeSet<String>, ) -> Self

Construct the loud, whole-registration rejection when a worker’s advertised node violates a Pinned{L} namespace’s placement (Control-Plane Phase 2, P2-I1). Names the offending namespace, the worker’s advertised node (or “none”), and the required label set, so the operator sees exactly why the registration was refused. Carried on the namespace-denied wire code — a registration refused on isolation grounds is a namespace-authorization failure, not a transient dispatch error.

pub fn deploy_denied(message: impl Into<String>) -> Self

Construct a deploy-authorization denial carried on the dedicated deploy_denied wire code (deploy is not a namespace operation).

pub const fn lagged_stream() -> Self

Construct a lagged-stream error.

pub fn worker_dispatch( namespace: impl Into<String>, activity_type: impl Into<String>, reason: impl Into<String>, ) -> Self

Construct a worker-dispatch error.

pub fn worker_connection_lost( channel: impl Into<String>, detail: impl Into<String>, ) -> Self

Construct a worker-connection-lost error for a dispatch whose chosen worker connection was gone at push time or closed before replying.

pub const fn is_worker_connection_lost(&self) -> bool

Return true when this is a lost-worker-connection dispatch failure.

The outbox dispatcher keys its fast cross-node failover on this: a lost connection means the worker is gone (already deregistered), so the row is re-armed for immediate re-claim instead of waiting out the retry backoff.

pub const fn lock_poisoned(resource: &'static str) -> Self

Construct a lock-poison error at the lock boundary.

impl ServerError

pub fn trace_fields(&self) -> ErrorTraceFields<'_>

Return stable typed fields for structured error logging.

Trait Implementations

impl Debug for ServerError

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

Formats the value using the given formatter.

impl Display for ServerError

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

Formats the value using the given formatter.

impl Error for ServerError

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<EngineError> for ServerError

fn from(source: EngineError) -> Self

Converts to this type from the input type.

impl From<StoreError> for ServerError

fn from(source: StoreError) -> Self

Converts to this type from the input type.

impl From<WireError> for ServerError

fn from(wire: WireError) -> Self

Converts to this type from the input type.