fix: AE-2316: field validator for serverless idleTimeout

src/runpod_flash/core/resources/serverless.py

@@ -328,6 +328,15 @@ def validate_python_version(cls, v: Optional[str]) -> Optional[str]:
             _validate_python_version(v)
         return v
 
+    @field_validator("idleTimeout")
+    @classmethod
+    def validate_idle_timeout(cls, value: Optional[int]) -> Optional[int]:
+        if value is None:
+            return value
+        if not 1 <= value <= 3600:
+            raise ValueError("idleTimeout must be between 1 and 3600 seconds")
+        return value
+
     @property
     def config_hash(self) -> str:
         """Get config hash excluding runtime-assigned fields.

tests/unit/resources/test_live_serverless.py

@@ -27,6 +27,13 @@ def test_live_serverless_workers_min_cannot_exceed_workers_max(self):
         ):
             LiveServerless(name="broken", workersMin=5, workersMax=1)
 
+    def test_live_serverless_idle_timeout_rejects_zero(self):
+        with pytest.raises(
+            ValueError,
+            match="idleTimeout must be between 1 and 3600 seconds",
+        ):
+            LiveServerless(name="broken", idleTimeout=0)
+
     def test_live_serverless_gpu_defaults(self):
         """Test LiveServerless uses GPU image and defaults."""
         live_serverless = LiveServerless(

tests/unit/resources/test_serverless.py

@@ -368,6 +368,20 @@ def test_workers_min_cannot_exceed_workers_max(self):
         ):
             ServerlessResource(name="test", workersMin=5, workersMax=1)
 
+    @pytest.mark.parametrize("idle_timeout", [0, -1, 3601])
+    def test_idle_timeout_must_be_between_1_and_3600(self, idle_timeout):
+        with pytest.raises(
+            ValueError,
+            match="idleTimeout must be between 1 and 3600 seconds",
+        ):
+            ServerlessResource(name="test", idleTimeout=idle_timeout)
+
+    @pytest.mark.parametrize("idle_timeout", [1, 3600])
+    def test_idle_timeout_accepts_valid_boundaries(self, idle_timeout):
+        serverless = ServerlessResource(name="test", idleTimeout=idle_timeout)
+
+        assert serverless.idleTimeout == idle_timeout
+
     def test_scaler_type_serialization(self):
         """Test ServerlessScalerType enum serialization."""
         serverless = ServerlessResource(