fix(alarms): fetch/poll ceilings; truncation-semantics docs; log-format conformance

2026-08-15 17:19:41 -04:00
parent 7c9add3d73
commit b5ea6bb461
11 changed files with 254 additions and 40 deletions
@@ -57,6 +57,51 @@ public sealed class MxAccessStaSessionTests
        }
    }

+    /// <summary>
+    ///     The alarm poll cadence comes from the launcher-set environment
+    ///     variable; a missing, unparseable, or out-of-range value must fall
+    ///     back to the 500 ms default rather than throw. The ceiling matters as
+    ///     much as the floor: <see cref="int.MaxValue"/> milliseconds is ~24
+    ///     days, which silently disables alarm polling altogether.
+    /// </summary>
+    /// <param name="environmentValue">Raw environment value under test.</param>
+    /// <param name="expectedMilliseconds">Expected resolved cadence, in milliseconds.</param>
+    [Theory]
+    [InlineData(null, 500)]
+    [InlineData("", 500)]
+    [InlineData("not-a-number", 500)]
+    [InlineData("0", 500)]
+    [InlineData("-1", 500)]
+    [InlineData("99", 500)]
+    [InlineData("100", 100)]
+    [InlineData("250", 250)]
+    [InlineData("3600000", 3600000)]
+    [InlineData("3600001", 500)]
+    [InlineData("2147483647", 500)]
+    public void ResolveAlarmPollInterval_WithEnvironmentValue_FallsBackToDefaultWhenOutOfRange(
+        string? environmentValue,
+        int expectedMilliseconds)
+    {
+        string? original = Environment.GetEnvironmentVariable(
+            MxAccessStaSession.AlarmPollIntervalEnvironmentVariableName);
+        try
+        {
+            Environment.SetEnvironmentVariable(
+                MxAccessStaSession.AlarmPollIntervalEnvironmentVariableName,
+                environmentValue);
+
+            Assert.Equal(
+                TimeSpan.FromMilliseconds(expectedMilliseconds),
+                MxAccessStaSession.ResolveAlarmPollInterval());
+        }
+        finally
+        {
+            Environment.SetEnvironmentVariable(
+                MxAccessStaSession.AlarmPollIntervalEnvironmentVariableName,
+                original);
+        }
+    }
+
    /// <summary>
    /// Verifies that StartAsync creates the MXAccess COM object and attaches the event sink on the STA thread.
    /// </summary>