icydb-core 0.189.0

IcyDB — A schema-first typed query engine and persistence runtime for Internet Computer canisters
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48

//! Module: db::registry::error
//! Responsibility: typed registry lookup and registration error classification.
//! Does not own: store runtime behavior or persisted storage error taxonomy.
//! Boundary: converts registry-local failures into database internal errors.

use crate::error::{ErrorClass, ErrorOrigin, InternalError};

///
/// StoreRegistryError
///
/// StoreRegistryError is the typed error taxonomy for registry lookup and
/// registration invariants.
/// It stays local to the registry boundary and converts into `InternalError`
/// for callers that operate on the wider database error contract.
///

#[derive(Debug)]
#[expect(clippy::enum_variant_names)]
pub(in crate::db::registry) enum StoreRegistryError {
    /// Requested generated store path is not registered.
    StoreNotFound,

    /// Generated store path was registered more than once.
    StoreAlreadyRegistered,

    /// Physical data/index/schema store triplet was reused by another path.
    StoreHandleTripletAlreadyRegistered,

    /// Allocation identity metadata does not match declared storage capabilities.
    StoreAllocationCapabilityMismatch,
}

impl StoreRegistryError {
    const fn class(&self) -> ErrorClass {
        match self {
            Self::StoreNotFound => ErrorClass::Internal,
            Self::StoreAlreadyRegistered
            | Self::StoreHandleTripletAlreadyRegistered
            | Self::StoreAllocationCapabilityMismatch => ErrorClass::InvariantViolation,
        }
    }
}

impl From<StoreRegistryError> for InternalError {
    fn from(err: StoreRegistryError) -> Self {
        Self::classified(err.class(), ErrorOrigin::Store)
    }
}