Enum HttpError 

#[non_exhaustive]
pub enum HttpError {
    Network(String),
    Status {
        status: u16,
        message: String,
    },
    RateLimited {
        retry_after_seconds: u64,
    },
    Timeout,
    Cors {
        message: String,
        remediation: String,
    },
}

HTTP client errors with retry classification.

Categorizes HTTP errors for proper retry handling:

• Network errors and timeouts are retryable
• 5xx server errors are retryable
• 429 rate limit responses include retry_after_seconds
• 4xx client errors are non-retryable
• CORS errors (WASM only) with remediation hints

Variants (Non-exhaustive)

Non-exhaustive enums could have additional variants added in future. Therefore, when matching against variants of non-exhaustive enums, an extra wildcard arm must be added to account for any future variants.

Network(String)

Network connectivity error (retryable)

Status

HTTP status error

Fields

status: u16

HTTP status code

message: String

Error message from response

RateLimited

Rate limited (retryable with backoff)

Fields

retry_after_seconds: u64

Seconds to wait before retrying

Timeout

Request timeout (retryable)

Cors

CORS error (WASM only, not retryable)

This error occurs when the browser blocks a cross-origin request. The IDP server must include proper CORS headers for the SDK to work in browsers.

Fields

message: String

Error description

remediation: String

Remediation hint

Implementations

impl HttpError

pub const fn is_retryable(&self) -> bool

Check if this error is retryable.

Returns true for:

• Network errors
• Timeouts
• 5xx server errors
• Rate limiting (after waiting)

CORS errors are NOT retryable - they require server configuration changes.

pub const fn is_rate_limited(&self) -> bool

Check if this error indicates rate limiting.

pub const fn retry_after(&self) -> Option<u64>

Get retry-after seconds if rate limited.

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

Create a network error.

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

Create a status error.

pub const fn rate_limited(retry_after_seconds: u64) -> Self

Create a rate limited error.

pub const fn suggested_retry_delay_ms(&self) -> Option<u64>

Get suggested retry delay in milliseconds.

Returns appropriate delay based on error type:

• Network errors: 500ms (short delay, transient issues)
• Timeout: 1000ms (moderate delay)
• 5xx errors: 2000ms (server needs time to recover)
• Rate limited: retry_after_seconds * 1000 (respect server’s hint)
• 4xx errors: None (not retryable)
• CORS errors: None (requires server configuration)

pub const fn status_code(&self) -> Option<u16>

Get the HTTP status code if this is a status error.

pub const fn category(&self) -> &'static str

Get the error category for metrics and logging.

pub fn cors(message: impl Into<String>, origin: &str) -> Self

Create a CORS error with remediation hints.

Use this when a request fails due to CORS policy in WASM environments.

Example

use lastid_sdk::HttpError;

let err = HttpError::cors(
    "Request blocked by CORS policy",
    "https://human.lastid.co",
);
assert!(!err.is_retryable());

pub fn cors_with_remediation( message: impl Into<String>, remediation: impl Into<String>, ) -> Self

Create a CORS error with custom remediation.

pub const fn is_cors(&self) -> bool

Check if this error is a CORS error.

Trait Implementations

impl Debug for HttpError

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

Formats the value using the given formatter.

impl Display for HttpError

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

Formats the value using the given formatter.

impl Error for HttpError

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<HttpError> for LastIDError

fn from(source: HttpError) -> Self

Converts to this type from the input type.

impl From<HttpError> for TrustRegistryError

fn from(source: HttpError) -> Self

Converts to this type from the input type.