Enum SurgeError 

pub enum SurgeError {
    Http(String),
    Api {
        status: Option<u16>,
        message: String,
        details: Value,
    },
    Tls(String),
    Json(String),
    Io(String),
    Ignore(String),
    InvalidProject(String),
    Auth(String),
    Network(String),
    Config(String),
    Event(String),
    Unknown(String),
}

Unified error type for the Surge SDK.

This enum encapsulates all possible error types that might occur during SDK usage, including:

• HTTP request failures
• Server-side API errors
• Event processing errors
• URL parsing issues
• JSON (de)serialization issues
• File system or I/O errors
• Ignore rules and directory walking issues
• Other unexpected or miscellaneous errors

Variants

Http(String)

HTTP-related errors from the reqwest crate.

Api

API errors returned by the remote server.

Fields

status: Option<u16>

message: String

details: Value

Tls(String)

TLS errors

Json(String)

JSON serialization/deserialization errors

Io(String)

File system or I/O errors

Ignore(String)

Directory traversal or ignore rules errors

InvalidProject(String)

Invalid project directory structure

Auth(String)

Authentication errors

Network(String)

Network errors

Config(String)

Configuration errors

Event(String)

Event processing errors

Unknown(String)

Unknown error variant

Implementations

impl SurgeError

pub fn api( status: Option<u16>, message: impl Into<String>, details: Value, ) -> Self

Creates a new API error

Trait Implementations

impl Debug for SurgeError

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for SurgeError

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Display for SurgeError

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

Formats the value using the given formatter.

impl Error for SurgeError

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<Box<dyn Error + Sync + Send>> for SurgeError

fn from(err: Box<dyn Error + Send + Sync>) -> Self

Converts to this type from the input type.

impl From<Error> for SurgeError

fn from(err: Error) -> Self

Converts to this type from the input type.

impl From<Error> for SurgeError

fn from(err: Error) -> Self

Converts to this type from the input type.

impl From<Error> for SurgeError

fn from(err: Error) -> Self

Converts to this type from the input type.

impl From<Error> for SurgeError

fn from(err: Error) -> Self

Converts to this type from the input type.

impl From<Error> for SurgeError

fn from(err: Error) -> Self

Converts to this type from the input type.

impl From<JoinError> for SurgeError

fn from(err: JoinError) -> Self

Converts to this type from the input type.

impl From<ParseError> for SurgeError

fn from(err: ParseError) -> Self

Converts to this type from the input type.

impl From<StripPrefixError> for SurgeError

fn from(err: StripPrefixError) -> Self

Converts to this type from the input type.

impl Serialize for SurgeError

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.