Enum PostgresInboxError 

#[non_exhaustive]
pub enum PostgresInboxError {
    UnsupportedServerVersion {
        required: u32,
        detected: u32,
    },
    NotMigrated {
        schema: String,
    },
    SchemaNotOnSearchPath {
        configured: String,
        observed: String,
    },
    NotClaimed {
        scope: String,
        message_id: MessageId,
    },
    InvalidSettings {
        message: String,
    },
    Database {
        source: Error,
    },
}

A failure of a crate::PostgresInboxStore call (inbox contract §3). Deliberately smaller than crate::PostgresOutboxError: the inbox has no enqueue/acquire analog, so it needs no Decode/UnknownMetadataVersion/DuplicateMessage variant, and no InvalidSchema — every schema value this type ever sees already passed the same identifier validation at migrate() (the inbox shares the outbox’s schema and its single migrate() entry point, inbox contract §1), and claim/complete bind it only as set_config data, never interpolate it into DDL.

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.

UnsupportedServerVersion

The connected server’s server_version_num is below crate::MIN_SERVER_VERSION_NUM (ADR 0041). Checked at crate::PostgresInboxStore::connect, before the search_path verification below — the same ordering crate::PostgresOutboxError::UnsupportedServerVersion uses and for the same reason. Permanent.

Fields

required: u32

crate::MIN_SERVER_VERSION_NUM, restated on the value.

detected: u32

The server_version_num this connection reported.

NotMigrated

inbox resolved to the configured schema, but the relation itself is missing — migrate() has not been run. Permanent. Checked before Self::SchemaNotOnSearchPath below at crate::PostgresInboxStore::connect, exactly as crate::PostgresOutboxError::NotMigrated is checked before crate::PostgresOutboxError::SchemaNotOnSearchPath — a missing relation reported as a search_path problem would send an operator chasing the wrong fix.

Fields

schema: String

The configured schema.

SchemaNotOnSearchPath

The unqualified name inbox does not resolve to the configured schema and the relation exists somewhere reachable — search_path puts a different schema first. Carries the configured schema and the observed search_path; the ALTER ROLE remedy is in the Display text. Permanent.

Fields

configured: String

The schema crate::PostgresInboxSettings::schema named.

observed: String

The search_path Postgres reported at construction.

NotClaimed

crate::PostgresInboxStore’s InboxStore::complete matched zero rows — reachable only by misuse (completing without a preceding Claimed claim, after the claiming transaction aborted, or completing a row that has since gone dead — complete’s own guard is completed_at IS NULL AND dead_at IS NULL, ADR 0042 A.2.4). Permanent — retrying the same call changes nothing.

Fields

scope: String

The scope the caller completed under.

message_id: MessageId

The message id the caller tried to complete.

InvalidSettings

PostgresInboxSettings::validate rejected the settings — currently only max_attempts == 0 (ADR 0042 A.2.4). Checked at crate::PostgresInboxStore::connect, before any query runs. Permanent.

Fields

message: String

A payload-free description of what was rejected.

Database

Any other sqlx failure, classified by SQLSTATE exactly as crate::PostgresOutboxError::Database.

Fields

source: Error

The underlying sqlx error.

Trait Implementations

impl Classify for PostgresInboxError

Per-variant classification table, exactly as crate::PostgresOutboxError’s: no blanket “everything else is transient”.

fn kind(&self) -> FailureKind

Whether the failure this error represents can succeed on retry.

impl Debug for PostgresInboxError

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

Formats the value using the given formatter.

impl Display for PostgresInboxError

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

Formats the value using the given formatter.

impl Error for PostgresInboxError

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 PostgresInboxError

fn from(source: Error) -> Self

Converts to this type from the input type.