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,
    },
    BufferEmpty,
    RecordNotFound {
        record_name: String,
    },
    RecordKeyNotFound {
        key: String,
    },
    InvalidRecordId {
        id: u32,
    },
    TypeMismatch {
        record_id: u32,
        expected_type: String,
    },
    AmbiguousType {
        count: u32,
        type_name: String,
    },
    DuplicateRecordKey {
        key: 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,
    CyclicDependency {
        records: Vec<String>,
    },
    TransformInputNotFound {
        output_key: String,
        input_key: String,
    },
    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

reason: String

BufferFull

Buffer is full and cannot accept more items

Fields

size: u32

buffer_name: String

BufferLagged

Consumer lagged behind producer (SPMC ring buffers)

Fields

lag_count: u64

buffer_name: String

BufferClosed

Buffer channel has been closed (shutdown)

Fields

buffer_name: String

BufferEmpty

Non-blocking receive found no pending values

RecordNotFound

Record type not found in database (legacy, by type name)

Fields

record_name: String

RecordKeyNotFound

Record key not found in registry

Fields

key: String

InvalidRecordId

RecordId out of bounds or invalid

Fields

id: u32

TypeMismatch

Type mismatch when accessing record by ID

Fields

record_id: u32

expected_type: String

AmbiguousType

Multiple records of same type exist (ambiguous type-only lookup)

Fields

count: u32

type_name: String

DuplicateRecordKey

Duplicate record key during registration

Fields

key: String

InvalidOperation

Invalid operation attempted

Fields

operation: String

reason: String

PermissionDenied

Permission denied for operation

Fields

operation: String

MissingConfiguration

Missing required configuration parameter

Fields

parameter: String

RuntimeError

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

Fields

message: String

ResourceUnavailable

Resource temporarily unavailable (used by adapters)

Fields

resource_type: u8

resource_name: String

HardwareError

Hardware-specific errors for embedded/MCU environments

Fields

component: u8

error_code: u16

description: String

Internal

Internal error for unexpected conditions

Fields

code: u32

message: String

AttachFailed

Failed to attach database to runtime thread

Fields

message: String

DetachFailed

Failed to detach database from runtime thread

Fields

message: String

SetTimeout

Timeout while setting a value

GetTimeout

Timeout while getting a value

RuntimeShutdown

Runtime thread has shut down

CyclicDependency

Transform dependency graph contains a cycle

Fields

records: Vec<String>

TransformInputNotFound

Transform input key references a record that was not registered

Fields

output_key: String

input_key: String

Io

I/O operation error

Fields

source: Error

IoWithContext

I/O operation error with context

Fields

context: String

source: Error

Json

JSON serialization error

Fields

source: Error

JsonWithContext

JSON serialization error with context

Fields

context: String

source: Error

Implementations

impl DbError

pub const RESOURCE_TYPE_MEMORY: u8 = 0

pub const RESOURCE_TYPE_FILE_HANDLE: u8 = 1

pub const RESOURCE_TYPE_SOCKET: u8 = 2

pub const RESOURCE_TYPE_BUFFER: u8 = 3

pub const RESOURCE_TYPE_THREAD: u8 = 4

pub const RESOURCE_TYPE_MUTEX: u8 = 5

pub const RESOURCE_TYPE_SEMAPHORE: u8 = 6

pub const RESOURCE_TYPE_CHANNEL: u8 = 7

pub const RESOURCE_TYPE_WOULD_BLOCK: u8 = 255

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

Creates a hardware error for embedded environments

pub fn internal(code: u32) -> Self

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: Into<String>>(self, context: S) -> Self

Adds additional context to an error (std only)

pub fn into_anyhow(self) -> Error

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

Trait Implementations

impl Debug for DbError

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

Formats the value using the given formatter.

impl Display for DbError

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

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<DbError> for RemoteError

fn from(err: DbError) -> Self

Converts to this type from the input type.

impl From<Error> for DbError

fn from(source: Error) -> Self

Converts to this type from the input type.

impl From<Error> for DbError

fn from(source: Error) -> Self

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) -> Self

Converts to this type from the input type.