Struct AdminError 

pub struct AdminError {
    pub status: StatusCode,
    pub code: &'static str,
    pub message: String,
    /* private fields */
}

A failed admin request. Clone so pages::refuse_with_card can render a refusal and keep the borrowed original: it builds the response from into_response, which consumes, and the caller still owns the error it was handed.

Fields

status: StatusCode

code: &'static str

Stable, machine-readable, snake_case. Never a URN.

message: String

Implementations

impl AdminError

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

400 — the request body or query string did not make sense.

pub fn session_invalid() -> Self

401 — no usable session. Every reason a login can fail collapses to AdminError::invalid_credentials; this one is for a request that arrived without a live session.

pub fn session_expired() -> Self

401 — the session passed its absolute deadline.

pub fn session_idle() -> Self

401 — the session went unused for longer than the idle timeout.

pub fn invalid_credentials() -> Self

401 — the login failed.

One code for every cause: unknown username, wrong password, and a disabled account are indistinguishable to the client on purpose, so the endpoint cannot be used to enumerate operators. The log says which (see crate::admin::users::AuthOutcome).

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

403 — the CSRF token was missing, wrong, or the request came from another origin.

pub fn insufficient_role() -> Self

403 — the session is live, but the operator’s role does not permit this action (crates/store/src/admin_user.rs’s AdminRole). Not a 401: the answer is not “sign in again”, so to_page_error renders it as a banner rather than a redirect to the login form.

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

404 — no such row.

pub fn with_code( status: StatusCode, code: &'static str, message: impl Into<String>, ) -> Self

405/404 fallbacks and any other conflict-free refusal with its own code.

pub fn conflict(code: &'static str, message: impl Into<String>) -> Self

409 — the request was well-formed but the row is in the wrong state.

pub fn rate_limited(retry_after_seconds: u64) -> Self

429 — too many failed logins from this address.

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

502 — the signer backend refused or could not be reached.

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

403 — admin.filter refused the caller before any handler ran.

pub fn internal() -> Self

500 — anything the operator can only find in the log.

Trait Implementations

impl Clone for AdminError

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for AdminError

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

Formats the value using the given formatter.

impl Display for AdminError

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

Formats the value using the given formatter.

impl Eq for AdminError

impl Error for AdminError

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<AdminError> for PageError

A 401 from the API layer means “sign in”; everything else keeps its status.

This is the one place the two error vocabularies meet, and it is a conversion rather than a shared type on purpose: AdminError answers a script, PageError answers a browser, and the day one grows a member the other should not have, nothing has to be untangled.

fn from(error: AdminError) -> Self

Converts to this type from the input type.

impl From<Error> for AdminError

A database failure is logged and answered generically.

The sqlx message names tables and columns, which is schema disclosure on an authenticated-but-not-necessarily-trusted surface — it belongs in the log, where the operator can read it, and not in the body.

fn from(error: Error) -> Self

Converts to this type from the input type.

impl IntoResponse for AdminError

fn into_response(self) -> Response

Create a response.

impl PartialEq for AdminError

fn eq(&self, other: &Self) -> bool

Equality operator ==.

fn ne(&self, other: &Rhs) -> bool

Inequality operator !=.

impl StructuralPartialEq for AdminError