using Mbproxy.Admin; using Mbproxy.Bcd; using Mbproxy.Options; using Mbproxy.Proxy; using Microsoft.Extensions.Configuration; using Microsoft.Extensions.DependencyInjection; using Microsoft.Extensions.Hosting; using Microsoft.Extensions.Logging.Abstractions; using Microsoft.Extensions.Options; using Serilog; using Shouldly; using Xunit; namespace Mbproxy.Tests.Admin; /// /// Unit tests for 's push-cycle logic — fleet always /// pushed, per-PLC pushed only for PLCs with a detail-page subscriber, and every /// capture disarmed on stop. The SignalR sink is faked; a real /// is resolved from a minimal in-process host. /// [Trait("Category", "Unit")] public sealed class StatusBroadcasterTests { private sealed record Harness( IHost Host, StatusBroadcaster Broadcaster, FakeStatusPushSink Sink, StatusSnapshotBuilder Builder, TagCaptureRegistry Registry, PlcSubscriptionTracker Tracker) : IAsyncDisposable { public async ValueTask DisposeAsync() { await Broadcaster.DisposeAsync(); using var cts = new CancellationTokenSource(TimeSpan.FromSeconds(5)); try { await Host.StopAsync(cts.Token); } catch { } Host.Dispose(); } } private static async Task BuildAsync(IStatusPushSink? sinkOverride = null) { var hostBuilder = Host.CreateApplicationBuilder(); hostBuilder.Configuration.AddInMemoryCollection(new Dictionary { ["Mbproxy:AdminPort"] = "0", // Fast tick so the LoopAsync test observes several cycles quickly. ["Mbproxy:AdminPushIntervalMs"] = "100", }); hostBuilder.Services.AddSerilog( new LoggerConfiguration().MinimumLevel.Fatal().CreateLogger(), dispose: false); hostBuilder.AddMbproxyOptions(); hostBuilder.Services.AddSingleton(); hostBuilder.Services.AddSingleton(); hostBuilder.Services.AddHostedService(sp => sp.GetRequiredService()); hostBuilder.Services.AddSingleton(); hostBuilder.Services.AddSingleton(); var host = hostBuilder.Build(); using var startCts = new CancellationTokenSource(TimeSpan.FromSeconds(15)); await host.StartAsync(startCts.Token); var builder = host.Services.GetRequiredService(); var registry = host.Services.GetRequiredService(); var options = host.Services.GetRequiredService>(); var tracker = new PlcSubscriptionTracker(); var sink = new FakeStatusPushSink(); var broadcaster = new StatusBroadcaster( sinkOverride ?? sink, builder, tracker, registry, options, NullLogger.Instance); return new Harness(host, broadcaster, sink, builder, registry, tracker); } [Fact] public async Task PushOnce_AlwaysPushesFleet() { await using var h = await BuildAsync(); await h.Broadcaster.PushOnceAsync(TestContext.Current.CancellationToken); h.Sink.FleetPushes.Count.ShouldBe(1); } [Fact] public async Task PushOnce_NoActivePlcs_SkipsPerPlcPush() { await using var h = await BuildAsync(); await h.Broadcaster.PushOnceAsync(TestContext.Current.CancellationToken); h.Sink.PlcPushes.ShouldBeEmpty(); } [Fact] public async Task PushOnce_ActivePlc_PushesDetailWithDebugSnapshot() { await using var h = await BuildAsync(); h.Registry.GetOrCreate("plc-x", BcdTagMap.Empty); h.Tracker.SubscribePlc("conn-1", "tab-1", "plc-x"); await h.Broadcaster.PushOnceAsync(TestContext.Current.CancellationToken); var push = h.Sink.PlcPushes.ShouldHaveSingleItem(); push.Plc.ShouldBe("plc-x"); push.Detail.Debug.ShouldNotBeNull(); } [Fact] public async Task PushOnce_ReconcilesCaptureArmState_FromActiveViewers() { await using var h = await BuildAsync(); h.Registry.GetOrCreate("plc-x", BcdTagMap.Empty); // No viewer yet — a push must leave the capture disarmed. await h.Broadcaster.PushOnceAsync(TestContext.Current.CancellationToken); h.Registry.TryGet("plc-x", out var capture).ShouldBeTrue(); capture.IsArmed.ShouldBeFalse("no detail page open — capture stays disarmed"); // A viewer opens the detail page — the next push arms the capture. h.Tracker.SubscribePlc("conn-1", "tab-1", "plc-x"); await h.Broadcaster.PushOnceAsync(TestContext.Current.CancellationToken); capture.IsArmed.ShouldBeTrue("the broadcaster reconciles the capture armed for a viewed PLC"); // The viewer leaves — the next push disarms it again. h.Tracker.RemoveConnection("conn-1"); await h.Broadcaster.PushOnceAsync(TestContext.Current.CancellationToken); capture.IsArmed.ShouldBeFalse("the broadcaster disarms a capture once its last viewer leaves"); } [Fact] public async Task PushOnce_SinkThrowsNonCancellation_FailureIsSwallowed() { // A SignalR transport fault on a push must not escape PushOnceAsync — the loop // has to survive it and retry on the next cycle. var throwing = new ThrowingStatusPushSink(() => new InvalidOperationException("boom")); await using var h = await BuildAsync(throwing); await Should.NotThrowAsync( () => h.Broadcaster.PushOnceAsync(TestContext.Current.CancellationToken)); } [Fact] public async Task PushOnce_SinkThrowsOperationCanceled_Propagates() { // The catch filters are `when (ex is not OperationCanceledException)` — a genuine // cancellation must propagate so the loop unwinds at shutdown instead of being // swallowed and retried. var throwing = new ThrowingStatusPushSink(() => new OperationCanceledException()); await using var h = await BuildAsync(throwing); await Should.ThrowAsync( () => h.Broadcaster.PushOnceAsync(TestContext.Current.CancellationToken)); } [Fact] public async Task StopAsync_DisarmsEveryCapture() { await using var h = await BuildAsync(); h.Registry.GetOrCreate("plc-x", BcdTagMap.Empty); h.Registry.ReconcileArmed(["plc-x"]); await h.Broadcaster.StopAsync(); h.Registry.TryGet("plc-x", out var capture).ShouldBeTrue(); capture.IsArmed.ShouldBeFalse(); } [Fact] public async Task Loop_PushesRepeatedly_ThenStopsAfterStopAsync() { await using var h = await BuildAsync(); h.Broadcaster.Start(); // The harness runs at AdminPushIntervalMs = 100 ms; wait (generously) for the // background loop to complete several cycles. var deadline = DateTime.UtcNow.AddSeconds(10); while (h.Sink.FleetPushes.Count < 3 && DateTime.UtcNow < deadline) await Task.Delay(50, TestContext.Current.CancellationToken); h.Sink.FleetPushes.Count.ShouldBeGreaterThanOrEqualTo(3, "the background loop must push the fleet snapshot every interval"); // StopAsync awaits the loop task before returning, so the loop is guaranteed // terminated here — no settling delay is needed for the assertion to be sound. await h.Broadcaster.StopAsync(); int afterStop = h.Sink.FleetPushes.Count; h.Sink.FleetPushes.Count.ShouldBe(afterStop, "no pushes may occur after StopAsync"); } }