Enum PhotonError 

pub enum PhotonError {
    TopicNotFound(String),
    SubscriptionNotFound(String),
    EventNotFound(String),
    InvalidTopicName(String),
    PayloadError(String),
    SchemaMismatch(String),
    TopicAlreadyExists(String),
    SubscriptionNameRequired,
    PersistenceError(String),
    Persistence {
        context: String,
        source: Arc<dyn Error + Sync + Send>,
    },
    Identity(String),
    Internal(String),
    Caused {
        context: String,
        source: Arc<dyn Error + Sync + Send>,
    },
}

Errors that can occur in Photon operations.

Variants

TopicNotFound(String)

Topic not found in registry.

SubscriptionNotFound(String)

Subscription not found.

EventNotFound(String)

Event not found.

InvalidTopicName(String)

Invalid topic name.

PayloadError(String)

Payload serialization/deserialization error.

SchemaMismatch(String)

Schema mismatch at publish time.

TopicAlreadyExists(String)

Topic already registered with different schema.

SubscriptionNameRequired

Subscription name required for durable subscriptions.

PersistenceError(String)

👎Deprecated:

use PhotonError::persistence(…) for sourced failures

Persistence / store error (ops metadata adapters).

Prefer PhotonError::persistence when an underlying store error exists.

Persistence

Persistence failure with preserved source chain.

Fields

context: String

Human-readable context for the failure.

source: Arc<dyn Error + Sync + Send>

Underlying store / I/O error.

Identity(String)

Identity reconstruction failed at the handler boundary.

Produced when photon_core::IdentityFactory::reconstruct rejects actor JSON (or a typed-actor downcast fails). Executor maps this to crate::instrumentation::FailureReason::IdentityBuild.

Internal(String)

Internal error (opaque message, no source chain).

Caused

Internal failure with preserved source chain.

Fields

context: String

Human-readable context for the failure.

source: Arc<dyn Error + Sync + Send>

Underlying error.

Implementations

impl PhotonError

pub fn caused( context: impl Into<String>, err: impl Display + Send + Sync + 'static, ) -> PhotonError

Internal error with a source chain (broker I/O, crypto, etc.).

Accepts any std::fmt::Display value so callers can wrap SDK errors that do not implement std::error::Error (e.g. some AEAD/crypto error types).

pub fn caused_error( context: impl Into<String>, err: impl Error + Send + Sync + 'static, ) -> PhotonError

Internal error wrapping a real std::error::Error source chain.

pub fn persistence( context: impl Into<String>, err: impl Error + Send + Sync + 'static, ) -> PhotonError

Persistence error with a source chain.

Trait Implementations

impl Clone for PhotonError

fn clone(&self) -> PhotonError

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for PhotonError

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

Formats the value using the given formatter.

impl Display for PhotonError

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

Formats the value using the given formatter.

impl Error for PhotonError

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 PhotonError

fn from(err: Error) -> PhotonError

Converts to this type from the input type.

impl From<Error> for PhotonError

fn from(err: Error) -> PhotonError

Converts to this type from the input type.

impl From<IdentityError> for PhotonError

fn from(err: IdentityError) -> PhotonError

Converts to this type from the input type.