resuma 1.3.1

Resuma — resumable SSR Rust web framework: zero hydration, islands, server actions, Flow (Axum).
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
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154

//! Resource profiles — invisible limits managed by the execution layer.

use serde::{Deserialize, Serialize};

use super::types::RuntimeChoice;

/// Per-dimension resource setting (`"auto"` or explicit).
#[derive(Debug, Clone, Default, Serialize, Deserialize)]
#[serde(untagged)]
pub enum ResourceLevel {
    #[default]
    Auto,
    Named(String),
}

/// Resource declaration on a worker (user never tunes CPU/RAM manually).
#[derive(Debug, Clone, Default, Serialize, Deserialize)]
pub struct Resources {
    #[serde(default)]
    pub cpu: ResourceLevel,
    #[serde(default)]
    pub memory: ResourceLevel,
    #[serde(default)]
    pub timeout: ResourceLevel,
    #[serde(default)]
    pub network: ResourceLevel,
    #[serde(default)]
    pub persistence: ResourceLevel,
}

impl Resources {
    pub fn auto() -> Self {
        Self::default()
    }

    /// Long CPU jobs (mesh gen, builds): 5 minutes by default.
    pub fn extended() -> Self {
        Self {
            timeout: ResourceLevel::Named("extended".into()),
            ..Self::default()
        }
    }

    /// No wall-clock timeout (`timeout_secs = 0` → cooperative cancel only).
    pub fn unlimited() -> Self {
        Self {
            timeout: ResourceLevel::Named("none".into()),
            ..Self::default()
        }
    }
}

/// Resolved profile after the planner + resource manager run.
#[derive(Debug, Clone, Serialize, Deserialize)]
pub struct ResourceProfile {
    pub runtime: RuntimeChoice,
    /// Wall-clock seconds; **0** means no timeout (cancel token only).
    pub timeout_secs: u64,
    pub memory_mb: u32,
    pub parallel_limit: u32,
}

impl Default for ResourceProfile {
    fn default() -> Self {
        let timeout_secs = std::env::var("RESUMA_WORKER_TIMEOUT_SECS")
            .ok()
            .and_then(|s| s.parse().ok())
            .unwrap_or(30);
        Self {
            runtime: RuntimeChoice::Backend,
            timeout_secs,
            memory_mb: 256,
            parallel_limit: 4,
        }
    }
}

/// Assign concrete resources from intent + plan heuristics.
pub fn resolve(resources: &Resources, plan: &super::types::ExecutionPlan) -> ResourceProfile {
    let runtime = match plan.runtime {
        RuntimeChoice::Auto => {
            if plan.strategy == super::types::ExecutionStrategy::Hybrid {
                RuntimeChoice::Hybrid
            } else if plan.use_ai || plan.chunks > 1 {
                RuntimeChoice::Backend
            } else {
                RuntimeChoice::Browser
            }
        }
        other => other,
    };

    let mut profile = ResourceProfile {
        runtime,
        ..ResourceProfile::default()
    };

    match &resources.timeout {
        ResourceLevel::Named(s) if s == "extended" => {
            profile.timeout_secs = 300;
        }
        ResourceLevel::Named(s) if s == "none" || s == "unlimited" || s == "0" => {
            profile.timeout_secs = 0;
        }
        ResourceLevel::Named(s) => {
            if let Ok(secs) = s.parse::<u64>() {
                profile.timeout_secs = secs;
            }
        }
        ResourceLevel::Auto => {}
    }
    if matches!(resources.memory, ResourceLevel::Named(ref s) if s == "high") {
        profile.memory_mb = 1024;
    }
    if plan.parallel {
        profile.parallel_limit = plan.chunks.max(1);
    }

    profile
}

#[cfg(test)]
mod tests {
    use super::*;
    use crate::exec::types::{ExecutionPlan, ExecutionStrategy, RuntimeChoice};

    fn empty_plan() -> ExecutionPlan {
        ExecutionPlan {
            strategy: ExecutionStrategy::Single,
            runtime: RuntimeChoice::Backend,
            use_ai: false,
            chunks: 1,
            parallel: false,
            ..Default::default()
        }
    }

    #[test]
    fn extended_and_none_timeouts() {
        let plan = empty_plan();
        let ext = resolve(&Resources::extended(), &plan);
        assert_eq!(ext.timeout_secs, 300);
        let none = resolve(&Resources::unlimited(), &plan);
        assert_eq!(none.timeout_secs, 0);
        let custom = resolve(
            &Resources {
                timeout: ResourceLevel::Named("120".into()),
                ..Resources::auto()
            },
            &plan,
        );
        assert_eq!(custom.timeout_secs, 120);
    }
}