Document client stack XML docs progress

tests/ZB.MOM.WW.LmxOpcUa.Client.Shared.Tests/Fakes/FakeSubscriptionAdapter.cs

@@ -3,6 +3,9 @@ using ZB.MOM.WW.LmxOpcUa.Client.Shared.Adapters;
 
 namespace ZB.MOM.WW.LmxOpcUa.Client.Shared.Tests.Fakes;
 
+/// <summary>
+/// Test double for <see cref="ISubscriptionAdapter" /> used to drive monitored-item behavior in shared-client tests.
+/// </summary>
 internal sealed class FakeSubscriptionAdapter : ISubscriptionAdapter
 {
     private readonly
@@ -10,8 +13,19 @@ internal sealed class FakeSubscriptionAdapter : ISubscriptionAdapter
             )> _items = new();
 
     private uint _nextHandle = 100;
+    /// <summary>
+    /// Gets a value indicating whether the fake subscription has been deleted.
+    /// </summary>
     public bool Deleted { get; private set; }
+
+    /// <summary>
+    /// Gets a value indicating whether a condition refresh was requested by the client under test.
+    /// </summary>
     public bool ConditionRefreshCalled { get; private set; }
+
+    /// <summary>
+    /// Gets or sets a value indicating whether condition refresh should throw to simulate unsupported servers.
+    /// </summary>
     public bool ThrowOnConditionRefresh { get; set; }
     public int AddDataChangeCount { get; private set; }
     public int AddEventCount { get; private set; }
@@ -22,8 +36,10 @@ internal sealed class FakeSubscriptionAdapter : ISubscriptionAdapter
     /// </summary>
     public IReadOnlyCollection<uint> ActiveHandles => _items.Keys.ToList();
 
+    /// <inheritdoc />
     public uint SubscriptionId { get; set; } = 42;
 
+    /// <inheritdoc />
     public Task<uint> AddDataChangeMonitoredItemAsync(NodeId nodeId, int samplingIntervalMs,
         Action<string, DataValue> onDataChange, CancellationToken ct)
     {
@@ -33,6 +49,7 @@ internal sealed class FakeSubscriptionAdapter : ISubscriptionAdapter
         return Task.FromResult(handle);
     }
 
+    /// <inheritdoc />
     public Task RemoveMonitoredItemAsync(uint clientHandle, CancellationToken ct)
     {
         RemoveCount++;
@@ -40,6 +57,7 @@ internal sealed class FakeSubscriptionAdapter : ISubscriptionAdapter
         return Task.CompletedTask;
     }
 
+    /// <inheritdoc />
     public Task<uint> AddEventMonitoredItemAsync(NodeId nodeId, int samplingIntervalMs, EventFilter filter,
         Action<EventFieldList> onEvent, CancellationToken ct)
     {
@@ -49,6 +67,7 @@ internal sealed class FakeSubscriptionAdapter : ISubscriptionAdapter
         return Task.FromResult(handle);
     }
 
+    /// <inheritdoc />
     public Task ConditionRefreshAsync(CancellationToken ct)
     {
         ConditionRefreshCalled = true;
@@ -57,6 +76,7 @@ internal sealed class FakeSubscriptionAdapter : ISubscriptionAdapter
         return Task.CompletedTask;
     }
 
+    /// <inheritdoc />
     public Task DeleteAsync(CancellationToken ct)
     {
         Deleted = true;
@@ -64,6 +84,9 @@ internal sealed class FakeSubscriptionAdapter : ISubscriptionAdapter
         return Task.CompletedTask;
     }
 
+    /// <summary>
+    /// Clears tracked monitored items when the fake subscription is disposed by the client under test.
+    /// </summary>
     public void Dispose()
     {
         _items.Clear();
@@ -85,4 +108,4 @@ internal sealed class FakeSubscriptionAdapter : ISubscriptionAdapter
     {
         if (_items.TryGetValue(handle, out var item) && item.EventCallback != null) item.EventCallback(eventFields);
     }
-}
+}