herolib-sid 0.1.0

SmartID - Short, human-readable, collision-free identifiers
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
49
50
51
52
53
54
55
56
57
58
59
60
61
62

//! Error types for SmartID operations

use super::base36::DecodeError;
use thiserror::Error;

/// Errors that can occur during SmartID operations
#[derive(Debug, Error)]
pub enum SidError {
    /// Contributor ID exceeds maximum (998)
    #[error("contributor id {0} exceeds maximum 998")]
    ContributorIdTooLarge(u16),

    /// Space has reached maximum contributors (999)
    #[error("space has reached maximum contributors (999)")]
    MaxContributorsReached,

    /// Invalid SmartID format
    #[error("invalid sid format: {0}")]
    InvalidFormat(String),

    /// Base36 decoding failed
    #[error("base36 decode error: {0}")]
    DecodeError(#[from] DecodeError),

    /// Global ID overflow (exceeded 6-char capacity)
    #[error("global id overflow: value {0} exceeds 6-char capacity")]
    GlobalIdOverflow(u64),

    /// Contributor not registered
    #[error("contributor {0} not registered - call register_contributor first")]
    ContributorNotRegistered(u16),

    /// Invalid counter file format
    #[error("invalid counter file for contributor {0}")]
    InvalidCounterFile(u16),

    /// Invalid config file format
    #[error("invalid config file: {0}")]
    InvalidConfigFile(String),

    /// Invalid name format (not name-fixed)
    #[error("invalid name format: {0}")]
    InvalidName(String),

    /// I/O error during storage operations
    #[error("io error: {0}")]
    IoError(#[from] std::io::Error),

    /// Serialization error
    #[error("serialization error: {0}")]
    SerializationError(String),

    /// Object not found
    #[error("object not found: {0}")]
    NotFound(String),

    /// Storage backend error
    #[error("storage error: {0}")]
    StorageError(String),
}

pub type Result<T> = std::result::Result<T, SidError>;