using System.Reflection; using Bunit; using Bunit.TestDoubles; using Microsoft.AspNetCore.Components; using Microsoft.Extensions.DependencyInjection; using Shouldly; using Xunit; using ZB.MOM.WW.OtOpcUa.AdminUI.Components.Pages.Uns; using ZB.MOM.WW.OtOpcUa.AdminUI.Components.Shared.Raw; using ZB.MOM.WW.OtOpcUa.AdminUI.Components.Shared.Uns; using ZB.MOM.WW.OtOpcUa.AdminUI.Uns; using ZB.MOM.WW.OtOpcUa.Configuration.Enums; namespace ZB.MOM.WW.OtOpcUa.AdminUI.Tests.Pages; /// Equipment route ownership, captured callers and read-only post-commit recovery. [Trait("Category","Unit")] public sealed class EquipmentCallerPresentationTests:BunitContext { private readonly EquipmentService _service; public EquipmentCallerPresentationTests() { var service=DispatchProxy.Create();_service=(EquipmentService)(object)service;Services.AddSingleton(service); ComponentFactories.AddStub();ComponentFactories.AddStub();ComponentFactories.AddStub();ComponentFactories.AddStub(); JSInterop.SetupVoid("Blazor._internal.domWrapper.focus",_=>true).SetVoidResult(); } [Fact] public void DetailsFieldsHaveVisibleUniqueNamesAndLinkedHelpErrors() { var a=Render(p=>p.Add(x=>x.EquipmentId,"A"));var b=Render(p=>p.Add(x=>x.EquipmentId,"B")); foreach(var cut in new[]{a,b})foreach(var field in cut.FindAll("input,select,textarea")) { field.Id.ShouldNotBeNullOrWhiteSpace();cut.FindAll("label").ShouldContain(x=>x.GetAttribute("for")==field.Id); foreach(var id in(field.GetAttribute("aria-describedby")??"").Split(' ',StringSplitOptions.RemoveEmptyEntries))cut.Find("#"+id).ShouldNotBeNull(); } var ids=a.FindAll("[id]").Concat(b.FindAll("[id]")).Select(x=>x.Id).ToArray();ids.Distinct().Count().ShouldBe(ids.Length); } [Theory] [InlineData("references",false)] [InlineData("references",true)] [InlineData("virtual",false)] [InlineData("virtual",true)] [InlineData("alarm",false)] [InlineData("alarm",true)] public async Task RetiredChildSavedOrCancelCannotReadOrCloseReplacement(string kind,bool cancel) { var cut=Render(p=>p.Add(x=>x.EquipmentId,"A"));await Open(cut,kind);var old=Callback(cut,kind,cancel); await Route(cut,"B");await Open(cut,kind);var count=_service.Reads.Count; await cut.InvokeAsync(()=>old.InvokeAsync()); Visible(cut,kind).ShouldBeTrue();_service.Reads.Count.ShouldBe(count); Target(cut,kind).ShouldNotBeNull(); } [Fact] public async Task RetiredConfirmCannotConsumeCurrentOperationAndCurrentRunsOnlyOnce() { var cut=Render(p=>p.Add(x=>x.EquipmentId,"A"));await Tab(cut,"Tags"); cut.FindAll("button").First(x=>x.TextContent.Trim()=="Remove").Click();var old=cut.FindComponent>().Instance.Parameters.Get(x=>x.OnConfirm); await cut.InvokeAsync(()=>cut.FindComponent>().Instance.Parameters.Get(x=>x.VisibleChanged).InvokeAsync(false)); cut.FindAll("button").Last(x=>x.TextContent.Trim()=="Remove").Click();var current=cut.FindComponent>().Instance.Parameters.Get(x=>x.OnConfirm); await cut.InvokeAsync(()=>old.InvokeAsync());_service.Writes.ShouldBeEmpty(); cut.FindComponent>().Instance.Parameters.Get(x=>x.Visible).ShouldBeTrue(); await cut.InvokeAsync(()=>current.InvokeAsync());await cut.InvokeAsync(()=>current.InvokeAsync()); _service.Writes.Count.ShouldBe(1);_service.Writes[0].Args[0].ShouldBe("A-ref-2"); } [Theory] [InlineData("virtual")] [InlineData("alarm")] public async Task LateEditReadCannotOpenUnderReplacementEquipment(string kind) { var cut=Render(p=>p.Add(x=>x.EquipmentId,"A"));await Tab(cut,kind=="virtual"?"Virtual Tags":"Alarms"); _service.HoldEdit=true;var opening=cut.FindAll("button").Single(x=>x.TextContent.Trim()=="Edit").ClickAsync(new()); await _service.Entered.Task.WaitAsync(TimeSpan.FromSeconds(10),Xunit.TestContext.Current.CancellationToken); await Route(cut,"B");await Open(cut,kind);_service.Release.TrySetResult();await opening; if(kind=="virtual")cut.FindComponent>().Instance.Parameters.Get(x=>x.IsNew).ShouldBeTrue(); else cut.FindComponent>().Instance.Parameters.Get(x=>x.IsNew).ShouldBeTrue(); Visible(cut,kind).ShouldBeTrue();_service.Writes.ShouldBeEmpty(); } [Fact] public async Task LateEquipmentReadCannotReplaceCurrentRoute() { var cut=Render(p=>p.Add(x=>x.EquipmentId,"BASE"));_service.HoldEquipmentA=true; var opening=Route(cut,"A");await _service.Entered.Task.WaitAsync(TimeSpan.FromSeconds(10),Xunit.TestContext.Current.CancellationToken); await Route(cut,"B");_service.Release.TrySetResult();await opening; cut.Find("input[id$=eq-name]").GetAttribute("value").ShouldBe("equipment-b");cut.Find("h1").TextContent.ShouldBe("equipment-b"); } [Fact] public async Task DetailWriteKeepsCapturedVersionAndDoesNotReloadNewRoute() { var cut=Render(p=>p.Add(x=>x.EquipmentId,"A"));cut.Find("input[id$=eq-name]").Change("submitted-a");_service.HoldWrite=true; var saving=cut.Find("form").TriggerEventAsync("onsubmit",EventArgs.Empty); await _service.Entered.Task.WaitAsync(TimeSpan.FromSeconds(10),Xunit.TestContext.Current.CancellationToken); _service.Version[0]=9;await Route(cut,"B");var before=_service.Reads.Count; _service.Release.TrySetResult();await saving; _service.Writes.Count.ShouldBe(1);_service.Writes[0].Args[0].ShouldBe("A"); Assert.IsType(_service.Writes[0].Args[1]).Name.ShouldBe("submitted-a");((byte[])_service.Writes[0].Args[2]!).ShouldBe(new byte[]{1,2}); _service.Reads.Count.ShouldBe(before);cut.Find("input[id$=eq-name]").GetAttribute("value").ShouldBe("equipment-b"); } [Fact] public async Task ConfirmedDetailsWriteWithFailedRefreshOffersReadOnlyRetryNotMutationReplay() { var cut=Render(p=>p.Add(x=>x.EquipmentId,"A"));_service.FailPostWriteRead=true; await cut.Find("form").TriggerEventAsync("onsubmit",EventArgs.Empty); cut.Markup.ShouldNotContain("data-testid=\"page-error-boundary\"");_service.Writes.Count.ShouldBe(1); cut.Find("button[type=submit]").HasAttribute("disabled").ShouldBeTrue(); cut.FindAll("button").Single(x=>x.TextContent.Trim()=="Retry view load").Click(); _service.Writes.Count.ShouldBe(1);cut.Find("button[type=submit]").HasAttribute("disabled").ShouldBeFalse(); } [Fact] public async Task TabReadsStayLazyAndSelectedTabLoadsForReplacementWithoutClobberingSameRouteDraft() { var cut=Render(p=>p.Add(x=>x.EquipmentId,"A")); _service.Reads.ShouldNotContain(x=>x.Contains("References",StringComparison.Ordinal)||x.Contains("VirtualTags",StringComparison.Ordinal)||x.Contains("Alarms",StringComparison.Ordinal)); await Tab(cut,"Tags");await Tab(cut,"Details");await Tab(cut,"Tags"); _service.Reads.Count(x=>x=="LoadReferencesForEquipmentAsync:A").ShouldBe(1); await Route(cut,"B");_service.Reads.Count(x=>x=="LoadReferencesForEquipmentAsync:B").ShouldBe(1); await Tab(cut,"Details");cut.Find("input[id$=eq-name]").Change("queued-draft");var before=_service.Reads.Count; await Route(cut,"B");_service.Reads.Count.ShouldBe(before);cut.Find("input[id$=eq-name]").GetAttribute("value").ShouldBe("queued-draft"); } [Theory] [InlineData("references")] [InlineData("virtual")] [InlineData("alarm")] public async Task SavedCallbackAlreadyReloadingCannotOverwriteOrCloseNewRouteModal(string kind) { var cut=Render(p=>p.Add(x=>x.EquipmentId,"A"));await Open(cut,kind);var saved=Callback(cut,kind,false); _service.HoldSurface=kind;var pending=cut.InvokeAsync(()=>saved.InvokeAsync()); await _service.Entered.Task.WaitAsync(TimeSpan.FromSeconds(10),Xunit.TestContext.Current.CancellationToken); await Route(cut,"B");await Open(cut,kind);_service.Release.TrySetResult();await pending; Visible(cut,kind).ShouldBeTrue(); cut.Find("tbody").TextContent.ShouldContain(kind=="references"?"B-first":kind=="virtual"?"virtual-tag-B":"alarm-B"); } [Theory] [InlineData("virtual")] [InlineData("alarm")] public async Task DeleteReadRetiredBeforeDispatchDoesNotMutateEitherEquipment(string kind) { var cut=Render(p=>p.Add(x=>x.EquipmentId,"A"));await Tab(cut,kind=="virtual"?"Virtual Tags":"Alarms"); cut.FindAll("button").Single(x=>x.TextContent.Trim()=="Delete").Click();_service.HoldEdit=true; var action=cut.FindComponent>().Instance.Parameters.Get(x=>x.OnConfirm); var deleting=cut.InvokeAsync(()=>action.InvokeAsync());await _service.Entered.Task.WaitAsync(TimeSpan.FromSeconds(10),Xunit.TestContext.Current.CancellationToken); await Route(cut,"B");_service.Release.TrySetResult();await deleting; _service.Writes.ShouldBeEmpty();cut.Find("h1").TextContent.ShouldBe("equipment-b"); } [Fact] public async Task ConfirmedOverrideWithFailedReadRetainsRowsAndOnlyRetriesRead() { var cut=Render(p=>p.Add(x=>x.EquipmentId,"A"));await Tab(cut,"Tags");_service.FailReferenceReadAfterWrite=true; cut.FindAll("button").First(x=>x.TextContent.Trim()=="Save name").Click(); _service.Writes.Count.ShouldBe(1);cut.FindAll("tbody tr").Count.ShouldBe(2);cut.Markup.ShouldContain("Changes were saved"); cut.FindAll("button").Where(x=>x.TextContent.Trim()=="Save name").ShouldAllBe(x=>x.HasAttribute("disabled")); cut.FindAll("button").Single(x=>x.TextContent.Trim()=="Retry view load").Click(); _service.Writes.Count.ShouldBe(1);cut.FindAll("button").First(x=>x.TextContent.Trim()=="Save name").HasAttribute("disabled").ShouldBeFalse(); await Task.CompletedTask; } [Fact] public async Task RetiredDetailsSubmitAfterSuccessfulRefreshCannotReplayMutation() { var cut=Render(p=>p.Add(x=>x.EquipmentId,"A"));var old=cut.FindComponent().Instance; var submit=old.OnValidSubmit;var context=new Microsoft.AspNetCore.Components.Forms.EditContext(old.Model!); await cut.Find("form").TriggerEventAsync("onsubmit",EventArgs.Empty);_service.Writes.Count.ShouldBe(1); await cut.InvokeAsync(()=>submit.InvokeAsync(context));_service.Writes.Count.ShouldBe(1); } [Fact] public async Task YearParserErrorIsNamedAndLinkedWithoutAddingARangeRule() { var cut=Render(p=>p.Add(x=>x.EquipmentId,"A"));var year=cut.FindAll("input").Single(x=>x.GetAttribute("type")=="number");year.Change("40000"); await cut.Find("form").TriggerEventAsync("onsubmit",EventArgs.Empty); year=cut.FindAll("input").Single(x=>x.GetAttribute("type")=="number");year.GetAttribute("aria-invalid").ShouldBe("true"); cut.Find("#"+year.GetAttribute("aria-describedby")!.Split(' ')[0]).TextContent.ShouldContain("Year of construction");_service.Writes.ShouldBeEmpty(); } [Fact] public async Task CreateRedirectsOnceWithOriginalDefaultPayload() { var cut=NewEquipment();await cut.Find("form").TriggerEventAsync("onsubmit",EventArgs.Empty); var navigation=Services.GetRequiredService();navigation.Uri.ShouldEndWith("/uns/equipment/created-fixture"); _service.Writes.Count.ShouldBe(1);_service.Writes[0].Name.ShouldBe("CreateEquipmentAsync"); var input=Assert.IsType(_service.Writes[0].Args[0]);input.Name.ShouldBe("new-equipment");input.MachineCode.ShouldBe("MC-NEW");input.UnsLineId.ShouldBe("LINE");input.Enabled.ShouldBeTrue();input.YearOfConstruction.ShouldBeNull(); await cut.Find("form").TriggerEventAsync("onsubmit",EventArgs.Empty);_service.Writes.Count.ShouldBe(1); } [Fact] public async Task RetiredCreateCompletionCannotRedirectReplacementRoute() { var cut=NewEquipment();_service.HoldWrite=true;var saving=cut.Find("form").TriggerEventAsync("onsubmit",EventArgs.Empty); await _service.Entered.Task.WaitAsync(TimeSpan.FromSeconds(10),Xunit.TestContext.Current.CancellationToken); await Route(cut,"B");var before=_service.Reads.Count;_service.Release.TrySetResult();await saving; Services.GetRequiredService().Uri.ShouldNotContain("created-fixture");_service.Writes.Count.ShouldBe(1);_service.Reads.Count.ShouldBe(before); } [Fact] public async Task ConfirmedCreateWithoutReturnedIdDoesNotAllowReplayOrPretendToRefresh() { var cut=NewEquipment();_service.CreatedId=null;await cut.Find("form").TriggerEventAsync("onsubmit",EventArgs.Empty); cut.Markup.ShouldContain("Equipment was created but no id was returned");cut.Markup.ShouldNotContain("Refreshing the view"); cut.Find("button[type=submit]").HasAttribute("disabled").ShouldBeTrue();await cut.Find("form").TriggerEventAsync("onsubmit",EventArgs.Empty);_service.Writes.Count.ShouldBe(1); } private IRenderedComponent NewEquipment() { var cut=Render();cut.Find("input[id$=eq-name]").Change("new-equipment");cut.Find("input[id$=eq-machinecode]").Change("MC-NEW");cut.Find("select[id$=eq-line]").Change("LINE");return cut; } [Theory] [InlineData("success")] [InlineData("failure")] [InlineData("exception")] public async Task ReplacementOwnsBusyAndOldCompletionCannotUnlockItsIndependentWrite(string outcome) { _service.HoldWritesByTarget=true;var cut=Render(p=>p.Add(x=>x.EquipmentId,"A")); var a=cut.Find("form").TriggerEventAsync("onsubmit",EventArgs.Empty);cut.WaitForAssertion(()=>_service.PendingWrites.ContainsKey("A").ShouldBeTrue()); await Route(cut,"B");cut.Find("button[type=submit]").HasAttribute("disabled").ShouldBeFalse(); var b=cut.Find("form").TriggerEventAsync("onsubmit",EventArgs.Empty);cut.WaitForAssertion(()=>_service.PendingWrites.ContainsKey("B").ShouldBeTrue()); var reads=_service.Reads.Count; if(outcome=="exception")_service.PendingWrites["A"].SetException(new InvalidOperationException("Retired A write failure")); else _service.PendingWrites["A"].SetResult(new(outcome=="success",outcome=="failure"?"Retired A failure":null)); await a;cut.Find("button[type=submit]").HasAttribute("disabled").ShouldBeTrue();_service.Reads.Count.ShouldBe(reads);cut.Markup.ShouldNotContain("Retired A"); _service.PendingWrites["B"].SetResult(new(true,null));await b;cut.Find("button[type=submit]").HasAttribute("disabled").ShouldBeFalse();_service.Writes.Count.ShouldBe(2); } [Fact] public async Task RetryControlGuardsSingleFlightAndKeepsStableOutcomeId() { var cut=Render(p=>p.Add(x=>x.EquipmentId,"A"));_service.FailPostWriteRead=true; await cut.Find("form").TriggerEventAsync("onsubmit",EventArgs.Empty); var retry=cut.Find("button[id$=details-retry]");var retryId=retry.Id;_service.HoldEquipmentA=true; var pending=retry.ClickAsync(new());await _service.Entered.Task.WaitAsync(TimeSpan.FromSeconds(10),Xunit.TestContext.Current.CancellationToken); var count=_service.Reads.Count;retry=cut.Find("button[id$=details-retry]");retry.Id.ShouldBe(retryId); retry.GetAttribute("aria-disabled").ShouldBe("true");await retry.ClickAsync(new());_service.Reads.Count.ShouldBe(count); _service.Release.TrySetResult();await pending; retry=cut.Find("button[id$=details-retry]");retry.Id.ShouldBe(retryId);retry.TextContent.ShouldContain("View refreshed");retry.GetAttribute("aria-disabled").ShouldBe("true"); await retry.ClickAsync(new());_service.Reads.Count.ShouldBe(count);_service.Writes.Count.ShouldBe(1); } private static Task Route(IRenderedComponent cut,string id)=>cut.InvokeAsync(()=>cut.Instance.SetParametersAsync(ParameterView.FromDictionary(new Dictionary{{"EquipmentId",id}}))); private static Task Tab(IRenderedComponent cut,string name)=>cut.FindAll("button").Single(x=>x.TextContent.Trim()==name).ClickAsync(new()); private static async Task Open(IRenderedComponent cut,string kind) {await Tab(cut,kind=="references"?"Tags":kind=="virtual"?"Virtual Tags":"Alarms");await cut.FindAll("button").Single(x=>x.TextContent.Trim()==(kind=="references"?"+ Add reference":kind=="virtual"?"Add virtual tag":"Add alarm")).ClickAsync(new());} private static EventCallback Callback(IRenderedComponent cut,string kind,bool cancel)=>kind switch { "references"=>cancel?cut.FindComponent>().Instance.Parameters.Get(x=>x.OnCancel):cut.FindComponent>().Instance.Parameters.Get(x=>x.OnCommitted), "virtual"=>cancel?cut.FindComponent>().Instance.Parameters.Get(x=>x.OnCancel):cut.FindComponent>().Instance.Parameters.Get(x=>x.OnSaved), _=>cancel?cut.FindComponent>().Instance.Parameters.Get(x=>x.OnCancel):cut.FindComponent>().Instance.Parameters.Get(x=>x.OnSaved) }; private static bool Visible(IRenderedComponent cut,string kind)=>kind switch{"references"=>cut.FindComponent>().Instance.Parameters.Get(x=>x.Visible),"virtual"=>cut.FindComponent>().Instance.Parameters.Get(x=>x.Visible),_=>cut.FindComponent>().Instance.Parameters.Get(x=>x.Visible)}; private static object? Target(IRenderedComponent cut,string kind)=>kind switch{"references"=>cut.FindComponent>().Instance.Parameters.Get(x=>x.Target),"virtual"=>cut.FindComponent>().Instance.Parameters.Get(x=>x.Target),_=>cut.FindComponent>().Instance.Parameters.Get(x=>x.Target)}; public sealed record Mutation(string Name,object?[] Args); public class EquipmentService:DispatchProxy { public readonly List Reads=new();public readonly List Writes=new();public readonly byte[] Version=[1,2]; public bool HoldEdit,HoldEquipmentA,HoldWrite,FailPostWriteRead,FailReferenceReadAfterWrite,HoldWritesByTarget; public readonly System.Collections.Concurrent.ConcurrentDictionary> PendingWrites=new(); public string? HoldSurface; public string? CreatedId="created-fixture"; public readonly TaskCompletionSource Entered=new(TaskCreationOptions.RunContinuationsAsynchronously),Release=new(TaskCreationOptions.RunContinuationsAsynchronously); public EquipmentEditDto Equipment(string id)=>new(id,"equipment-"+id.ToLowerInvariant(),"MC-"+id,"LINE",null,null,null,"Maker","Model","Serial","Hardware","Software",2020,"Location","https://fixture/manufacturer","https://fixture/manual",true,Version); protected override object? Invoke(MethodInfo? method,object?[]? args) { var name=method!.Name;var id=args is{Length:>0}?args[0]?.ToString()??"":""; if(name.StartsWith("Load",StringComparison.Ordinal))Reads.Add(name+":"+id); return name switch { "LoadEquipmentAsync"=>ReadEquipment(id), "LoadEquipmentPickContextAsync"=>Task.FromResult(new EquipmentPickContext([("LINE","Synthetic line")],[])), "LoadReferencesForEquipmentAsync"=>ReadReferences(id), "LoadVirtualTagsForEquipmentAsync"=>ReadVirtualRows(id), "LoadAlarmsForEquipmentAsync"=>ReadAlarmRows(id), "LoadScriptsAsync"=>Task.FromResult>([("S1","Synthetic script")]), "LoadVirtualTagAsync"=>ReadVirtual(id), "LoadScriptedAlarmAsync"=>ReadAlarm(id), "UpdateEquipmentAsync" or "CreateEquipmentAsync" or "RemoveReferenceAsync" or "SetReferenceOverrideAsync" or "DeleteVirtualTagAsync" or "DeleteScriptedAlarmAsync"=>Write(name,args!), _=>throw new InvalidOperationException("Refused operation: "+name) }; } private async Task HoldRows(string surface) {if(HoldSurface==surface){HoldSurface=null;Entered.TrySetResult();await Release.Task;}} private async Task> ReadReferences(string id) { await HoldRows("references"); if(FailReferenceReadAfterWrite&&Writes.Count>0){FailReferenceReadAfterWrite=false;throw new InvalidOperationException("Synthetic reference read failure");} return [new(id+"-ref-1",id+"-first","raw/first","Double",TagAccessLevel.Read,null,0,Version),new(id+"-ref-2",id+"-second","raw/second","Double",TagAccessLevel.Read,null,1,Version)]; } private async Task> ReadVirtualRows(string id) {await HoldRows("virtual");return [new(id+"-vtag","virtual-tag-"+id,"Double","S1",true)];} private async Task> ReadAlarmRows(string id) {await HoldRows("alarm");return [new(id+"-alarm","alarm-"+id,"LimitAlarm",500,"S1",true)];} private async Task ReadEquipment(string id) {if(HoldEquipmentA&&id=="A"){Entered.TrySetResult();await Release.Task;}if(FailPostWriteRead&&Writes.Count>0){FailPostWriteRead=false;throw new InvalidOperationException("Synthetic post-commit read failure");}return Equipment(id);} private async Task ReadVirtual(string id){if(HoldEdit&&id.StartsWith("A",StringComparison.Ordinal)){Entered.TrySetResult();await Release.Task;}return new(id,id[..1],"virtual-tag","Double","S1",true,null,false,true,Version);} private async Task ReadAlarm(string id){if(HoldEdit&&id.StartsWith("A",StringComparison.Ordinal)){Entered.TrySetResult();await Release.Task;}return new(id,id[..1],"alarm","LimitAlarm",500,"message","S1",true,true,true,Version);} private async Task Write(string name,object?[] args){Writes.Add(new(name,args));if(HoldWritesByTarget&&name=="UpdateEquipmentAsync"){var pending=new TaskCompletionSource(TaskCreationOptions.RunContinuationsAsynchronously);PendingWrites[(string)args[0]!]=pending;return await pending.Task;}if(HoldWrite){Entered.TrySetResult();await Release.Task;}return new(true,null,CreatedId);} } }