Enum DbError 

pub enum DbError {
    ConnectionFailed {
        endpoint: String,
        reason: String,
    },
    BufferFull {
        size: u32,
        buffer_name: String,
    },
    BufferLagged {
        lag_count: u64,
        buffer_name: String,
    },
    BufferClosed {
        buffer_name: String,
    },
    RecordNotFound {
        record_name: String,
    },
    InvalidOperation {
        operation: String,
        reason: String,
    },
    PermissionDenied {
        operation: String,
    },
    MissingConfiguration {
        parameter: String,
    },
    RuntimeError {
        message: String,
    },
    ResourceUnavailable {
        resource_type: u8,
        resource_name: String,
    },
    HardwareError {
        component: u8,
        error_code: u16,
        description: String,
    },
    Internal {
        code: u32,
        message: String,
    },
    AttachFailed {
        message: String,
    },
    DetachFailed {
        message: String,
    },
    SetTimeout,
    GetTimeout,
    RuntimeShutdown,
    Io {
        source: Error,
    },
    IoWithContext {
        context: String,
        source: Error,
    },
    Json {
        source: Error,
    },
    JsonWithContext {
        context: String,
        source: Error,
    },
}

Streamlined error type for AimDB operations

Only includes errors that are actually used in the codebase, removing theoretical/unused error variants for simplicity.

Variants

ConnectionFailed

Connection or timeout failures

Fields

endpoint: String

Available on crate feature std only.

reason: String

Available on crate feature std only.

BufferFull

Buffer is full and cannot accept more items

Fields

size: u32

buffer_name: String

Available on crate feature std only.

BufferLagged

Consumer lagged behind producer (SPMC ring buffers)

Fields

lag_count: u64

buffer_name: String

Available on crate feature std only.

BufferClosed

Buffer channel has been closed (shutdown)

Fields

buffer_name: String

Available on crate feature std only.

RecordNotFound

Record type not found in database

Fields

record_name: String

Available on crate feature std only.

InvalidOperation

Invalid operation attempted

Fields

operation: String

Available on crate feature std only.

reason: String

Available on crate feature std only.

PermissionDenied

Permission denied for operation

Fields

operation: String

Available on crate feature std only.

MissingConfiguration

Missing required configuration parameter

Fields

parameter: String

Available on crate feature std only.

RuntimeError

Runtime execution error (task spawning, scheduling, etc.)

Fields

message: String

Available on crate feature std only.

ResourceUnavailable

Resource temporarily unavailable (used by adapters)

Fields

resource_type: u8

resource_name: String

Available on crate feature std only.

HardwareError

Hardware-specific errors for embedded/MCU environments

Fields

component: u8

error_code: u16

description: String

Available on crate feature std only.

Internal

Internal error for unexpected conditions

Fields

code: u32

message: String

Available on crate feature std only.

AttachFailed

Available on crate feature std only.

Failed to attach database to runtime thread

Fields

message: String

DetachFailed

Available on crate feature std only.

Failed to detach database from runtime thread

Fields

message: String

SetTimeout

Available on crate feature std only.

Timeout while setting a value

GetTimeout

Available on crate feature std only.

Timeout while getting a value

RuntimeShutdown

Available on crate feature std only.

Runtime thread has shut down

Io

Available on crate feature std only.

I/O operation error

Fields

source: Error

IoWithContext

Available on crate feature std only.

I/O operation error with context

Fields

context: String

source: Error

Json

Available on crate feature std only.

JSON serialization error

Fields

source: Error

JsonWithContext

Available on crate feature std only.

JSON serialization error with context

Fields

context: String

source: Error

Implementations

impl DbError

pub const RESOURCE_TYPE_MEMORY: u8 = 0u8

pub const RESOURCE_TYPE_FILE_HANDLE: u8 = 1u8

pub const RESOURCE_TYPE_SOCKET: u8 = 2u8

pub const RESOURCE_TYPE_BUFFER: u8 = 3u8

pub const RESOURCE_TYPE_THREAD: u8 = 4u8

pub const RESOURCE_TYPE_MUTEX: u8 = 5u8

pub const RESOURCE_TYPE_SEMAPHORE: u8 = 6u8

pub const RESOURCE_TYPE_CHANNEL: u8 = 7u8

pub const RESOURCE_TYPE_WOULD_BLOCK: u8 = 255u8

pub fn hardware_error(component: u8, error_code: u16) -> DbError

Creates a hardware error for embedded environments

pub fn internal(code: u32) -> DbError

Creates an internal error with a specific error code

pub fn is_network_error(&self) -> bool

Returns true if this is a network-related error

pub fn is_capacity_error(&self) -> bool

Returns true if this is a capacity-related error

pub fn is_hardware_error(&self) -> bool

Returns true if this is a hardware-related error

pub const fn error_code(&self) -> u32

Returns a numeric error code for embedded environments

pub const fn error_category(&self) -> u32

Returns the error category (high nibble)

pub fn with_context<S>(self, context: S) -> DbError

where S: Into<String>,

Available on crate feature std only.

Adds additional context to an error (std only)

pub fn into_anyhow(self) -> Error

Available on crate feature std only.

Converts this error into an anyhow::Error (std only)

Trait Implementations

impl Debug for DbError

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

Formats the value using the given formatter.

impl Display for DbError

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

Formats the value using the given formatter.

impl Error for DbError

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 DbError

fn from(source: Error) -> DbError

Converts to this type from the input type.

impl From<Error> for DbError

fn from(source: Error) -> DbError

Converts to this type from the input type.

impl From<ExecutorError> for DbError

Convert executor errors to database errors

This allows runtime adapters to return ExecutorError while the core database works with DbError for consistency across the API.

fn from(err: ExecutorError) -> DbError

Converts to this type from the input type.

impl TokioErrorSupport for DbError

fn from_join_error(error: JoinError) -> DbError

Converts a tokio::task::JoinError to DbError.

This is the only production-critical error conversion for the Tokio adapter. Task join errors occur when spawned tasks fail, and require special handling to distinguish between cancellation, panics, and regular task failures.