squigit-storage 0.1.0

Persistent profiles, threads, and content-addressed storage for Squigit
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
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93

// Copyright 2026 a7mddra
// SPDX-License-Identifier: Apache-2.0

//! Error types for persisted storage.

use thiserror::Error;

/// Storage error types.
#[derive(Error, Debug)]
pub enum StorageError {
    /// No data directory found.
    #[error("Could not find data directory")]
    NoDataDir,

    /// Failed to locate the user's config directory.
    #[error("Could not locate config directory")]
    NoConfigDir,

    /// IO error.
    #[error("IO error: {0}")]
    Io(#[from] std::io::Error),

    /// JSON serialization error.
    #[error("JSON error: {0}")]
    Json(#[from] serde_json::Error),

    /// A locally parsed text attachment must contain valid UTF-8.
    #[error("Text attachment is not valid UTF-8: {0}")]
    InvalidUtf8(#[from] std::str::Utf8Error),

    /// Empty image provided.
    #[error("Empty image data")]
    EmptyImage,

    /// Invalid hash format.
    #[error("Invalid hash format")]
    InvalidHash,

    /// A persisted Office-to-PDF conversion receipt is invalid.
    #[error("Invalid document conversion: {0}")]
    InvalidDocumentConversion(String),

    /// Image not found.
    #[error("Image not found: {0}")]
    ImageNotFound(String),

    /// Thread not found.
    #[error("Thread not found: {0}")]
    ThreadNotFound(String),

    /// Workspace not found.
    #[error("Workspace not found: {0}")]
    WorkspaceNotFound(String),

    /// Workspace names must contain at least one non-whitespace character.
    #[error("Invalid workspace name")]
    InvalidWorkspaceName,

    /// Workspace path is invalid or too broad to use as an AI sandbox.
    #[error("Invalid workspace path: {0}")]
    InvalidWorkspacePath(String),

    /// Persisted message IDs must use the `msg-<UUID>` contract.
    #[error("Invalid thread message: {0}")]
    InvalidThreadMessage(String),

    /// Profile with the given ID was not found.
    #[error("Profile not found: {0}")]
    ProfileNotFound(String),

    /// Cannot delete the last remaining profile.
    #[error("Cannot delete the last profile")]
    CannotDeleteLastProfile,

    /// Profile ID is invalid.
    #[error("Invalid profile ID: {0}")]
    InvalidProfileId(String),

    /// Stored auth state is unsupported or invalid.
    #[error("{0}")]
    AuthState(String),

    /// Encrypted key-store structure, locking, or target safety failure.
    #[error("{0}")]
    KeyStore(String),

    /// Unsupported OCR annotations key.
    #[error("Unsupported OCR model id: {0}")]
    InvalidOcrModel(String),
}

/// Result type alias for storage operations.
pub type Result<T> = std::result::Result<T, StorageError>;