Enum ServiceError 

pub enum ServiceError {
    Database {
        message: String,
        source: Option<Box<dyn Error + Send + Sync>>,
    },
    NotFound {
        resource_type: String,
        identifier: String,
    },
    InvalidInput {
        message: String,
        field: Option<String>,
    },
    Unauthenticated(String),
    PermissionDenied(String),
    BusinessRule(String),
    ExternalService {
        service: String,
        message: String,
        source: Option<Box<dyn Error + Send + Sync>>,
    },
    Configuration(String),
    RateLimitExceeded(String),
    Conflict(String),
    Cache {
        message: String,
        source: Option<Box<dyn Error + Send + Sync>>,
    },
    Timeout {
        operation: String,
        timeout_ms: u64,
    },
    ResourceExhausted {
        resource: String,
        message: String,
    },
    ValidationErrors(HashMap<String, Vec<String>>),
    Internal {
        message: String,
        source: Option<Box<dyn Error + Send + Sync>>,
    },
}

Unified error type for Pleme services

Follows Railway-Oriented Programming pattern where errors flow through a separate “error track” from the success track.

Variants

Database

Database operation failed

Fields

message: String

source: Option<Box<dyn Error + Send + Sync>>

NotFound

Resource not found

Fields

resource_type: String

identifier: String

InvalidInput

Invalid input or validation error

Fields

message: String

field: Option<String>

Unauthenticated(String)

Authentication required

PermissionDenied(String)

Permission denied

BusinessRule(String)

Business logic constraint violated

ExternalService

External service error (e.g., payment gateway, email service)

Fields

service: String

message: String

source: Option<Box<dyn Error + Send + Sync>>

Configuration(String)

Configuration error

RateLimitExceeded(String)

Rate limit exceeded

Conflict(String)

Conflict (e.g., duplicate resource)

Cache

Cache operation failed

Fields

message: String

source: Option<Box<dyn Error + Send + Sync>>

Timeout

Operation timeout

Fields

operation: String

timeout_ms: u64

ResourceExhausted

Resource exhausted (memory, disk, connections, etc.)

Fields

resource: String

message: String

ValidationErrors(HashMap<String, Vec<String>>)

Validation errors for multiple fields

Internal

Internal server error (catch-all)

Fields

message: String

source: Option<Box<dyn Error + Send + Sync>>

Implementations

impl ServiceError

pub fn database<E>(message: impl Into<String>, error: E) -> Self

where E: Error + Send + Sync + 'static,

Create a database error with context

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

Create a database error without source

pub fn not_found(resource_type: impl Into<String>, id: impl Display) -> Self

Create a not found error

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

Create an invalid input error

pub fn invalid_field( field: impl Into<String>, message: impl Into<String>, ) -> Self

Create an invalid input error with field name

pub fn external_service<E>( service: impl Into<String>, message: impl Into<String>, error: E, ) -> Self

where E: Error + Send + Sync + 'static,

Create an external service error

pub fn internal<E>(message: impl Into<String>, error: E) -> Self

where E: Error + Send + Sync + 'static,

Create an internal error with context

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

Create an internal error without source

pub fn cache<E>(message: impl Into<String>, error: E) -> Self

where E: Error + Send + Sync + 'static,

Create a cache error with context

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

Create a cache error without source

pub fn timeout(operation: impl Into<String>, timeout_ms: u64) -> Self

Create a timeout error

pub fn resource_exhausted( resource: impl Into<String>, message: impl Into<String>, ) -> Self

Create a resource exhausted error

pub fn is_retryable(&self) -> bool

Check if error is retryable (for exponential backoff)

pub fn is_severe(&self) -> bool

Check if error should be logged at error level

Trait Implementations

impl Debug for ServiceError

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

Formats the value using the given formatter.

impl Display for ServiceError

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

Formats the value using the given formatter.

impl Error for ServiceError

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 ServiceError

fn from(error: Error) -> Self

Converts to this type from the input type.

impl From<ParseError> for ServiceError

fn from(error: ParseError) -> Self

Converts to this type from the input type.