Enum StoreError 

pub enum StoreError {
    EmptyConnection,
    EmptyEnvVarName,
    MissingEnvVar {
        var: String,
    },
    PoolInit {
        dsn_masked: String,
        source: String,
    },
    InvalidIdentifier {
        kind: &'static str,
        name: String,
    },
    EmptyData {
        op: &'static str,
    },
    Filter(FilterError),
    Epistemic(EpistemicError),
    Connect {
        source: String,
    },
    Query {
        op: &'static str,
        source: String,
    },
    UnsupportedColumnType {
        column: String,
        pg_type: String,
    },
    Decode {
        column: String,
        pg_type: String,
        source: String,
    },
    TableNotResolved {
        table: String,
    },
    AmbiguousTable {
        table: String,
        schemas: Vec<String>,
    },
    SchemaDrift {
        op: &'static str,
        sqlstate: String,
        source: String,
    },
    MissingPerTenantSchemaEnv {
        store: String,
        var: String,
    },
    DeclaredVsLiveDrift {
        store: String,
        drift: String,
    },
}

Every way an axonstore SQL operation can fail. The backend is total: it returns one of these or a result — never a panic, never a silent empty result masking a failure.

Variants

EmptyConnection

connection was empty or whitespace-only.

EmptyEnvVarName

connection was the bare prefix env: with no variable name.

MissingEnvVar

connection: "env:VAR" and VAR is unset (or not UTF-8).

Fields

var: String

PoolInit

The resolved DSN is malformed — connect_lazy rejected it.

Fields

dsn_masked: String

source: String

InvalidIdentifier

A table or column identifier failed the [A-Za-z_]\w* / 63-byte safety check (D4 — no untrusted identifier reaches SQL).

Fields

kind: &'static str

name: String

EmptyData

insert / mutate was called with no column data.

Fields

op: &'static str

Filter(FilterError)

The where expression did not compile (delegates to 35.b).

Epistemic(EpistemicError)

A confidence_floor violation — a sub-floor or un-elevated persist (delegates to 35.g’s Pillar I epistemic data plane).

Connect

A live connection could not be acquired / the ping failed.

Fields

source: String

Query

A SQL statement failed at execution time.

Fields

op: &'static str

source: String

UnsupportedColumnType

A retrieved column has a type outside the supported catalog (classify_pg_type). Honest scope, not a silent miss.

Fields

column: String

pg_type: String

Decode

A retrieved column of a supported type failed to decode.

Fields

column: String

pg_type: String

source: String

TableNotResolved

§Fase 37.x.b (D1) — the table named by a store operation could not be resolved to a relation in ANY schema of the database.

Fields

table: String

AmbiguousTable

§Fase 37.x.b (D1) — the table name resolves to a relation in more than one schema and the connection’s search_path does not disambiguate it. Carries the schemas found, sorted.

Fields

table: String

schemas: Vec<String>

SchemaDrift

§Fase 37.x.f (D9) — a store SQL statement failed with a schema-drift SQLSTATE: the cached schema no longer matches the live table (an ALTER TABLE ran since the cache was populated). 42P01 undefined_table, 42703 undefined_column, 42804 datatype_mismatch (a stale write cast), 42883 undefined operator (a stale read cast). Triggers the D9 self-heal — the (dsn, table) cache entry is evicted and the operation retried once against fresh introspection. Safe: every one is a parse/plan-time rejection, so the failed statement had ZERO side effects (a retried persist/mutate cannot double-write).

Fields

op: &'static str

sqlstate: String

source: String

MissingPerTenantSchemaEnv

§Fase 38.f (D3) — axon-T806. A postgresql store declared schema: env:VAR and the named env var is unset at deploy time. Never falls back silently — the deploy fails, the operator either exports the var or fixes the declaration.

Fields

store: String

var: String

DeclaredVsLiveDrift

§Fase 38.f (D8 strengthening) — axon-T807. A declared column schema and the live introspected columns disagree at deploy time. Carries a human-readable drift summary (which columns are missing on the live DB, which have a type mismatch). The remedy is named in the message: run axon store introspect <store> to refresh the manifest, run the missing migration, or fix the declaration.

Fields

store: String

drift: String

Implementations

impl StoreError

pub fn is_schema_drift(&self) -> bool

§Fase 37.x.f (D9) — true iff this is a schema-drift failure (StoreError::SchemaDrift) — the signal that triggers the (dsn, table) cache self-heal (evict + retry once).

Trait Implementations

impl Clone for StoreError

fn clone(&self) -> StoreError

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for StoreError

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

Formats the value using the given formatter.

impl Display for StoreError

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

Formats the value using the given formatter.

impl Error for StoreError

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<EpistemicError> for StoreError

fn from(e: EpistemicError) -> Self

Converts to this type from the input type.

impl From<FilterError> for StoreError

fn from(e: FilterError) -> Self

Converts to this type from the input type.

impl PartialEq for StoreError

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

Tests for self and other values to be equal, and is used by ==.

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

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl StructuralPartialEq for StoreError