feat(commons): ScriptTriggerAttribute — monitored attribute of a ValueChange/Conditional trigger (flow debugger script entry)

Claude-Session: https://claude.ai/code/session_01NcMG6xXdsJbmD2wYAgkK29
2026-09-08 01:07:38 -04:00
parent fefa3ffa77
commit 952b41f0f7
2 changed files with 95 additions and 0 deletions
@@ -0,0 +1,46 @@
+using ZB.MOM.WW.ScadaBridge.Commons.Types.Scripts;
+
+namespace ZB.MOM.WW.ScadaBridge.Commons.Tests.Scripts;
+
+/// <summary>Flow Debugger script entry (design 2026-09-08 §2): the monitored attribute of a ValueChange/Conditional trigger.</summary>
+public class ScriptTriggerAttributeTests
+{
+    [Theory]
+    [InlineData("ValueChange", """{"attributeName":"Level"}""", "Level")]
+    [InlineData("valuechange", """{"attribute":"Level"}""", "Level")]
+    [InlineData("Conditional", """{"attributeName":"Level","operator":">","threshold":"5"}""", "Level")]
+    [InlineData("CONDITIONAL", """{"attribute":"Flag"}""", "Flag")]
+    public void WriteKinds_ReturnTheMonitoredAttribute(string kind, string config, string expected)
+    {
+        Assert.True(ScriptTriggerAttribute.TryRead(kind, config, out var attribute));
+        Assert.Equal(expected, attribute);
+        Assert.True(ScriptTriggerAttribute.IsWriteKind(kind));
+    }
+
+    [Theory]
+    [InlineData("Call", """{"attributeName":"Level"}""")]
+    [InlineData("Interval", """{"intervalMs":1000}""")]
+    [InlineData("Expression", """{"expression":"true"}""")]
+    [InlineData(null, null)]
+    [InlineData("", "")]
+    public void OtherKinds_ReturnFalse_EvenWhenTheConfigNamesAnAttribute(string? kind, string? config)
+    {
+        Assert.False(ScriptTriggerAttribute.TryRead(kind, config, out var attribute));
+        Assert.Null(attribute);
+        Assert.False(ScriptTriggerAttribute.IsWriteKind(kind));
+    }
+
+    [Theory]
+    [InlineData("ValueChange", null)]
+    [InlineData("ValueChange", "")]
+    [InlineData("ValueChange", "not json")]
+    [InlineData("ValueChange", "[1,2]")]
+    [InlineData("ValueChange", """{"attributeName":""}""")]
+    [InlineData("ValueChange", """{"other":"x"}""")]
+    public void WriteKind_WithoutAReadableAttribute_ReturnsFalse_ButIsStillAWriteKind(string kind, string? config)
+    {
+        Assert.False(ScriptTriggerAttribute.TryRead(kind, config, out var attribute));
+        Assert.Null(attribute);
+        Assert.True(ScriptTriggerAttribute.IsWriteKind(kind));
+    }
+}