Development Documentation (main branch) - For stable release docs, see docs.rs/eidetica
Skip to main content

eidetica/user/
errors.rs

1//! Error types for the user system
2use thiserror::Error;
3
4use crate::entry::ID;
5
6#[derive(Error, Debug)]
7pub enum UserError {
8    #[error("User not found: {username}")]
9    UserNotFound { username: String },
10
11    #[error("Username already exists: {username}")]
12    UsernameAlreadyExists { username: String },
13
14    #[error(
15        "Multiple users detected with username '{username}' ({count} found). This indicates a race condition during user creation. Manual intervention required."
16    )]
17    DuplicateUsersDetected { username: String, count: usize },
18
19    #[error("Invalid password")]
20    InvalidPassword,
21
22    #[error("Key not found: {key_id}")]
23    KeyNotFound { key_id: String },
24
25    #[error("Key already exists: {key_id}")]
26    KeyAlreadyExists { key_id: String },
27
28    #[error("Encryption failed: {reason}")]
29    EncryptionFailed { reason: String },
30
31    #[error("Decryption failed: {reason}")]
32    DecryptionFailed { reason: String },
33
34    #[error("Operation requires admin permission")]
35    InsufficientPermissions,
36
37    #[error("No admin key available for database: {database_id}")]
38    NoAdminKey { database_id: ID },
39
40    #[error("Database not tracked: {database_id}")]
41    DatabaseNotTracked { database_id: ID },
42
43    #[error("This user is not sharing database: {database_id}")]
44    DatabaseNotShared { database_id: ID },
45
46    #[error("Database handle lacks the user capability required to manage sharing: {database_id}")]
47    MissingDatabaseCapability { database_id: ID },
48
49    #[error("Database not found by name: {name}")]
50    DatabaseNotFoundByName { name: String },
51
52    #[error("User account disabled: {username}")]
53    UserDisabled { username: String },
54
55    #[error("Invalid salt length: expected {expected}, got {actual}")]
56    InvalidSaltLength { expected: usize, actual: usize },
57
58    #[error("Invalid nonce length: expected {expected}, got {actual}")]
59    InvalidNonceLength { expected: usize, actual: usize },
60
61    #[error("No key found for database: {database_id}")]
62    NoKeyForDatabase { database_id: ID },
63
64    #[error("No SigKey mapping found for key {key_id} in database {database_id}")]
65    NoSigKeyMapping { key_id: String, database_id: ID },
66
67    #[error("No SigKey found for key {key_id} in database {database_id}")]
68    NoSigKeyFound { key_id: String, database_id: ID },
69
70    #[error(
71        "Database access pending for {database_id}: a key mapping exists but the database has no local data yet \
72         (the bootstrap request may be awaiting approval, or the database has not synced)"
73    )]
74    DatabaseAccessPending { database_id: ID },
75
76    #[error("Password required for operation: {operation}")]
77    PasswordRequired { operation: String },
78
79    #[error("Invalid key format: {reason}")]
80    InvalidKeyFormat { reason: String },
81
82    #[error("No keys available for user")]
83    NoKeysAvailable,
84
85    #[error("Duplicate store name in DatabaseBuilder: {name}")]
86    DuplicateBuilderStore { name: String },
87}
88
89impl UserError {
90    /// Check if this error indicates a resource was not found.
91    pub fn is_not_found(&self) -> bool {
92        matches!(
93            self,
94            UserError::UserNotFound { .. }
95                | UserError::KeyNotFound { .. }
96                | UserError::DatabaseNotTracked { .. }
97                | UserError::DatabaseNotFoundByName { .. }
98        )
99    }
100}