test(opcuaclient): event-history smoke + docs(historian): driver event passthrough

2026-06-18 06:12:51 -04:00
parent 68637396b5
commit 7a3d2712c0
2 changed files with 41 additions and 0 deletions
@@ -92,4 +92,32 @@ public sealed class OpcUaClientSmokeTests(OpcPlcFixture sim)

        await drv.UnsubscribeAsync(handle, TestContext.Current.CancellationToken);
    }
+
+    /// <summary>
+    ///     Verifies HistoryReadEvents passthrough issues a well-formed request and returns a
+    ///     result without throwing. opc-plc exposes live alarm conditions (--alm) but is NOT a
+    ///     historian, so the upstream may return zero historical events or reject the service —
+    ///     either way the driver must produce a HistoricalEventsResult, never throw. This proves
+    ///     the wire request + unwrap path; a non-empty event list is infra-gated on an upstream
+    ///     that historizes events.
+    /// </summary>
+    [Fact]
+    public async Task Client_reads_events_returns_result_without_throwing()
+    {
+        if (sim.SkipReason is not null) Assert.Skip(sim.SkipReason);
+
+        var options = OpcPlcProfile.BuildOptions(sim.EndpointUrl);
+        await using var drv = new OpcUaClientDriver(options, driverInstanceId: "opcua-smoke-events");
+        await drv.InitializeAsync("{}", TestContext.Current.CancellationToken);
+
+        var result = await drv.ReadEventsAsync(
+            sourceName: null,                       // null → upstream Server object (i=2253)
+            startUtc: DateTime.UtcNow.AddHours(-1),
+            endUtc: DateTime.UtcNow,
+            maxEvents: 100,
+            cancellationToken: TestContext.Current.CancellationToken);
+
+        result.ShouldNotBeNull();
+        result.Events.ShouldNotBeNull();
+    }
 }