Enum ShaperailError 

pub enum ShaperailError {
    NotFound,
    Unauthorized,
    Forbidden,
    Validation(Vec<FieldError>),
    Conflict(String),
    RateLimited,
    Internal(String),
}

Unified error type used across all Shaperail crates.

Maps to the PRD error response format:

{
  "error": {
    "code": "NOT_FOUND",
    "status": 404,
    "message": "Resource not found",
    "request_id": "abc-123",
    "details": null
  }
}

Variants

NotFound

404 — Resource not found.

Unauthorized

401 — Missing or invalid authentication.

Forbidden

403 — Authenticated but insufficient permissions.

Validation(Vec<FieldError>)

422 — One or more fields failed validation.

Conflict(String)

409 — Conflict (e.g., unique constraint violation).

RateLimited

429 — Rate limit exceeded.

Internal(String)

500 — Internal server error.

Implementations

impl ShaperailError

pub fn code(&self) -> &'static str

Returns the machine-readable error code string.

pub fn status(&self) -> StatusCode

Returns the HTTP status code for this error.

pub fn to_error_body(&self, request_id: &str) -> Value

Builds the PRD-mandated JSON error response body.

The request_id is passed in by the caller (typically from middleware).

Trait Implementations

impl Debug for ShaperailError

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

Formats the value using the given formatter.

impl Display for ShaperailError

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

Formats the value using the given formatter.

impl Error for ShaperailError

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 ShaperailError

fn from(err: Error) -> Self

Converts to this type from the input type.

impl ResponseError for ShaperailError

fn status_code(&self) -> StatusCode

Returns appropriate status code for error.

fn error_response(&self) -> HttpResponse

Creates full response for error.