backbone-bucket 0.3.1

Bucket Bounded Context: File Storage Module for Backbone Framework
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
94
95
96
97
98

//! Top-level error type for the bucket module.
//!
//! `BucketError` is the module's unified error surface — storage failures,
//! authorization denials, config/signing issues, and missing objects all
//! collapse into one enum so consumers get precise `match` coverage.
//!
//! Converts into `backbone_core::ServiceError` for compatibility with the
//! framework error plumbing used by the generated CRUD stack.

use std::io;

use thiserror::Error;

/// Unified error surface for storage, serving, and signing.
#[derive(Debug, Error)]
pub enum BucketError {
    /// Object not found in storage or database.
    #[error("not found")]
    NotFound,

    /// Caller is not permitted to perform the requested action.
    #[error("forbidden")]
    Forbidden,

    /// Request could not be authenticated.
    #[error("unauthenticated")]
    Unauthenticated,

    /// Presigned URL has expired or is malformed.
    #[error("invalid or expired signature")]
    InvalidSignature,

    /// Configured backend cannot satisfy this operation (e.g. `public_url`
    /// on a backend without a public bucket configured).
    #[error("operation not supported by backend: {0}")]
    Unsupported(String),

    /// Missing or malformed configuration.
    #[error("configuration error: {0}")]
    Config(String),

    /// Storage backend I/O error.
    #[error("storage I/O error: {0}")]
    Io(#[from] io::Error),

    /// S3/MinIO-side error.
    #[error("s3 error: {0}")]
    S3(String),

    /// URL construction / parsing error.
    #[error("url error: {0}")]
    Url(String),

    /// Request payload is invalid (missing required fields, malformed
    /// input). Maps to HTTP 400.
    #[error("invalid input: {0}")]
    InvalidInput(String),

    /// Operation conflicts with current resource state (e.g. uploading
    /// to a readonly/archived bucket). Maps to HTTP 409.
    #[error("conflict: {0}")]
    Conflict(String),

    /// Payload exceeds the allowed size. Maps to HTTP 413.
    #[error("payload too large: {0}")]
    PayloadTooLarge(String),

    /// MIME type is not in the bucket's allow-list. Maps to HTTP 415.
    #[error("unsupported media type: {0}")]
    UnsupportedMediaType(String),

    /// Catch-all for errors outside the above categories.
    #[error("{0}")]
    Other(String),
}

pub type BucketResult<T> = Result<T, BucketError>;

impl From<BucketError> for backbone_core::ServiceError {
    fn from(err: BucketError) -> Self {
        match err {
            BucketError::NotFound => backbone_core::ServiceError::NotFound,
            BucketError::Forbidden => {
                backbone_core::ServiceError::Validation("forbidden".to_string())
            }
            BucketError::Unauthenticated => {
                backbone_core::ServiceError::Validation("unauthenticated".to_string())
            }
            other => backbone_core::ServiceError::Internal(other.to_string()),
        }
    }
}

impl From<url::ParseError> for BucketError {
    fn from(err: url::ParseError) -> Self {
        BucketError::Url(err.to_string())
    }
}