canic-core 0.99.19

Canic — a canister orchestration and management toolkit for the Internet Computer
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

//! Module: workflow::state
//!
//! Responsibility: orchestrate Fleet-state mutations and downstream state cascades.
//! Does not own: endpoint authorization, stable state records, or DTO schemas.
//! Boundary: workflow layer between state API calls, storage ops, and cascade workflow.

pub mod query;

use crate::{
    InternalError,
    dto::state::{FleetCommand, FleetCommandResponse},
    ops::{runtime::env::EnvOps, storage::state::fleet::FleetStateOps},
    workflow::cascade::{snapshot::StateSnapshotBuilder, state::StateCascadeWorkflow},
};

///
/// FleetStateWorkflow
/// Orchestrates Fleet-state mutations and downstream cascades
///

pub struct FleetStateWorkflow;

impl FleetStateWorkflow {
    /// Apply a Fleet-level command (internal).
    ///
    /// Workflow-level orchestration for mutating Fleet state.
    /// This function:
    /// - enforces execution context (root-only)
    /// - applies the command via storage ops
    /// - rebuilds the relevant state snapshot
    /// - cascades state changes to dependent components
    ///
    /// Returns internal [`InternalError`]. Public error mapping is handled
    /// exclusively at the API boundary.
    pub async fn execute_command(cmd: FleetCommand) -> Result<FleetCommandResponse, InternalError> {
        EnvOps::require_root()?;
        let response = FleetStateOps::apply_command(cmd);
        if !fleet_command_response_changed(response) {
            return Ok(response);
        }

        let snapshot = StateSnapshotBuilder::new()?.with_fleet_state().build();
        StateCascadeWorkflow::root_cascade_state(&snapshot).await?;

        Ok(response)
    }
}

const fn fleet_command_response_changed(response: FleetCommandResponse) -> bool {
    match response {
        FleetCommandResponse::Status(status) => status.changed,
        FleetCommandResponse::CyclesFundingEnabled(enabled) => enabled.changed,
    }
}