backbone-bucket 0.4.6

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

//! Application service for FileShare entities
//!
//! Generated by metaphor-schema. Do not edit manually.
//!
//! Type alias over `GenericCrudService` — all CRUD logic lives in backbone-core.
//! For custom behaviour, create `file_share_service_custom.rs` (preserved on regen).

use backbone_core::GenericCrudService;

use crate::presentation::dto::{CreateFileShareDto, UpdateFileShareDto};
use crate::domain::entity::FileShare;
use crate::infrastructure::persistence::FileShareRepository;

/// Application service for FileShare entities.
///
/// All 12 standard CRUD operations (list, create, get, update, patch,
/// soft_delete, restore, empty_trash, bulk_create, upsert, find_by_id,
/// list_deleted) are provided by `GenericCrudService`.
///
/// Custom extensions go in `file_share_service_custom.rs`:
///
/// ```rust,ignore
/// pub struct FileShareServiceCustom {
///     inner: Arc<FileShareService>,
///     // add domain-specific dependencies here
/// }
/// ```
pub type FileShareService = GenericCrudService<
    FileShare,
    CreateFileShareDto,
    UpdateFileShareDto,
    FileShareRepository,
>;

/// The row rules the schema declares for FileShare, checked against the row a create or
/// update would store. The generated build attaches it to [`FileShareService`]. Every rule
/// runs in shadow: a break is logged under `backbone::write_guard` and the write goes ahead.
pub struct FileShareRowRules;

#[async_trait::async_trait]
impl backbone_core::write_guard::WriteGuard<FileShare> for FileShareRowRules {
    async fn check(
        &self,
        ctx: &backbone_core::write_guard::WriteCtx<'_, FileShare>,
    ) -> backbone_core::write_guard::GuardOutcome {
        use backbone_core::row_rule as r;
        use backbone_core::violation::Violation;
        use backbone_core::write_guard::{GuardOutcome, WriteKind};
        let (create, update) = (ctx.kind == WriteKind::Create, ctx.kind == WriteKind::Update);
        let Some(after) = ctx.after.filter(|_| create || update) else {
            return GuardOutcome::allow();
        };
        let Ok(row) = serde_json::to_value(after) else {
            return GuardOutcome::allow();
        };
        let row = &row;
        let old = ctx.before.and_then(|b| serde_json::to_value(b).ok());
        let mut shadow = Vec::new();
        // `status` belongs to a state machine: only its verbs move it
        if update && ctx.transition.is_none() && r::changed(old.as_ref(), row, &["status"]) {
            shadow.push(Violation::new("status", "state_field_verbs_only", "the state field moves only through its verbs"));
        }
        // `token_length` (file_share.hook.yaml:66)
        if (create) && !r::holds(&r::and(r::ge(r::length(r::field(row, "token")), r::Val::Num(32.0_f64)), r::le(r::length(r::field(row, "token")), r::Val::Num(64.0_f64)))) {
            shadow.push(Violation::new("token", "invalid_token_length", "Share token must be 32-64 characters"));
        }
        // `token_alphanumeric` (file_share.hook.yaml:72)
        if (create) && !r::holds(&r::matches(r::field(row, "token"), "^[a-zA-Z0-9]+$")) {
            shadow.push(Violation::new("token", "invalid_token_chars", "Share token must be alphanumeric"));
        }
        // `future_expiry` (file_share.hook.yaml:90)
        if (create || (update && r::changed(old.as_ref(), row, &["expires_at"]))) && !r::holds(&r::or(r::is_null(r::field(row, "expires_at")), r::gt(r::field(row, "expires_at"), r::at(ctx.at)))) {
            shadow.push(Violation::new("expires_at", "expired_date", "Expiration date must be in the future"));
        }
        // `positive_downloads` (file_share.hook.yaml:96)
        if (create || update) && !r::holds(&r::or(r::is_null(r::field(row, "max_downloads")), r::gt(r::field(row, "max_downloads"), r::Val::Num(0.0_f64)))) {
            shadow.push(Violation::new("max_downloads", "invalid_max_downloads", "Maximum downloads must be positive"));
        }
        // `user_share_requires_recipients` (file_share.hook.yaml:102)
        if (create) && !r::holds(&r::or(r::ne(r::field(row, "share_type"), r::text("user")), r::and(r::is_not_null(r::field(row, "shared_with")), r::gt(r::length(r::field(row, "shared_with")), r::Val::Num(0.0_f64))))) {
            shadow.push(Violation::new("share_type", "missing_recipients", "User shares must specify recipients"));
        }
        // `cannot_modify_inactive` (file_share.hook.yaml:108)
        if (update) && !r::holds(&r::or(r::or(r::eq(r::field(row, "status"), r::text("active")), r::eq(r::actor(ctx.actor.as_deref()), r::field(row, "owner_id"))), r::has_role(ctx.actor.as_deref(), "admin").await)) {
            shadow.push(Violation::new("status", "share_inactive", "Cannot modify inactive shares"));
        }
        GuardOutcome { refuse: Vec::new(), shadow }
    }
}