feat(opcuaclient): add BuildBaseEventFilter + MapHistoryEvents pure cores

2026-06-18 06:02:11 -04:00
parent 767bc56d97
commit e859963853
2 changed files with 156 additions and 0 deletions
@@ -96,4 +96,75 @@ public sealed class OpcUaClientHistoryTests
                maxEvents: 100,
                cancellationToken: TestContext.Current.CancellationToken));
    }
+
+    /// <summary>BuildBaseEventFilter emits the six canonical BaseEventType select clauses in order.</summary>
+    [Fact]
+    public void BuildBaseEventFilter_has_six_canonical_BaseEventType_value_clauses()
+    {
+        var filter = OpcUaClientDriver.BuildBaseEventFilter();
+
+        filter.SelectClauses.Count.ShouldBe(6);
+        string[] expected = ["EventId", "SourceName", "Time", "ReceiveTime", "Message", "Severity"];
+        for (var i = 0; i < expected.Length; i++)
+        {
+            var clause = filter.SelectClauses[i];
+            clause.TypeDefinitionId.ShouldBe(ObjectTypeIds.BaseEventType);
+            clause.AttributeId.ShouldBe(Attributes.Value);
+            clause.BrowsePath.Count.ShouldBe(1);
+            clause.BrowsePath[0].Name.ShouldBe(expected[i]);
+        }
+    }
+
+    /// <summary>MapHistoryEvents maps every field by its canonical select-clause index.</summary>
+    [Fact]
+    public void MapHistoryEvents_maps_all_six_fields_by_canonical_index()
+    {
+        var eventTime = new DateTime(2026, 6, 18, 10, 0, 0, DateTimeKind.Utc);
+        var recvTime = eventTime.AddSeconds(1);
+        var he = new HistoryEvent();
+        var fields = new HistoryEventFieldList();
+        fields.EventFields.Add(new Variant(new byte[] { 1, 2, 3 }));            // 0 EventId
+        fields.EventFields.Add(new Variant("Pump17"));                          // 1 SourceName
+        fields.EventFields.Add(new Variant(eventTime));                         // 2 Time
+        fields.EventFields.Add(new Variant(recvTime));                          // 3 ReceiveTime
+        fields.EventFields.Add(new Variant(new LocalizedText("High temp")));    // 4 Message
+        fields.EventFields.Add(new Variant((ushort)700));                       // 5 Severity
+        he.Events.Add(fields);
+
+        var mapped = OpcUaClientDriver.MapHistoryEvents(he);
+
+        mapped.Count.ShouldBe(1);
+        var e = mapped[0];
+        e.EventId.ShouldBe(Convert.ToBase64String(new byte[] { 1, 2, 3 }));
+        e.SourceName.ShouldBe("Pump17");
+        e.EventTimeUtc.ShouldBe(eventTime);
+        e.ReceivedTimeUtc.ShouldBe(recvTime);
+        e.Message.ShouldBe("High temp");
+        e.Severity.ShouldBe((ushort)700);
+    }
+
+    /// <summary>MapHistoryEvents returns empty for a HistoryEvent with no rows.</summary>
+    [Fact]
+    public void MapHistoryEvents_with_no_events_returns_empty()
+    {
+        OpcUaClientDriver.MapHistoryEvents(new HistoryEvent()).ShouldBeEmpty();
+    }
+
+    /// <summary>MapHistoryEvents tolerates a field list shorter than six without throwing.</summary>
+    [Fact]
+    public void MapHistoryEvents_tolerates_short_field_list_without_throwing()
+    {
+        var he = new HistoryEvent();
+        var fields = new HistoryEventFieldList();
+        fields.EventFields.Add(new Variant(new byte[] { 9 })); // only EventId present
+        he.Events.Add(fields);
+
+        var mapped = OpcUaClientDriver.MapHistoryEvents(he);
+
+        mapped.Count.ShouldBe(1);
+        mapped[0].EventId.ShouldBe(Convert.ToBase64String(new byte[] { 9 }));
+        mapped[0].SourceName.ShouldBeNull();
+        mapped[0].EventTimeUtc.ShouldBe(DateTime.MinValue);
+        mapped[0].Severity.ShouldBe((ushort)0);
+    }
 }