Expand XML docs across bridge and test code

tests/ZB.MOM.WW.LmxOpcUa.Tests/Helpers/OpcUaTestClient.cs

@@ -16,11 +16,16 @@ namespace ZB.MOM.WW.LmxOpcUa.Tests.Helpers
     {
         private Session? _session;
 
+        /// <summary>
+        /// Gets the active OPC UA session used by integration tests once the helper has connected to the bridge.
+        /// </summary>
         public Session Session => _session ?? throw new InvalidOperationException("Not connected");
 
         /// <summary>
         /// Resolves the namespace index for a given namespace URI (e.g., "urn:TestGalaxy:LmxOpcUa").
         /// </summary>
+        /// <param name="galaxyName">The Galaxy name whose OPC UA namespace should be resolved on the test server.</param>
+        /// <returns>The namespace index assigned by the server for the requested Galaxy namespace.</returns>
         public ushort GetNamespaceIndex(string galaxyName = "TestGalaxy")
         {
             var nsUri = $"urn:{galaxyName}:LmxOpcUa";
@@ -32,11 +37,18 @@ namespace ZB.MOM.WW.LmxOpcUa.Tests.Helpers
         /// <summary>
         /// Creates a NodeId in the LmxOpcUa namespace using the server's actual namespace index.
         /// </summary>
+        /// <param name="identifier">The string identifier for the node inside the Galaxy namespace.</param>
+        /// <param name="galaxyName">The Galaxy name whose namespace should be used for the node identifier.</param>
+        /// <returns>A node identifier that targets the requested node on the test server.</returns>
         public NodeId MakeNodeId(string identifier, string galaxyName = "TestGalaxy")
         {
             return new NodeId(identifier, GetNamespaceIndex(galaxyName));
         }
 
+        /// <summary>
+        /// Connects the helper to an OPC UA endpoint exposed by the test bridge.
+        /// </summary>
+        /// <param name="endpointUrl">The OPC UA endpoint URL to connect to.</param>
         public async Task ConnectAsync(string endpointUrl)
         {
             var config = new ApplicationConfiguration
@@ -87,6 +99,8 @@ namespace ZB.MOM.WW.LmxOpcUa.Tests.Helpers
         /// <summary>
         /// Browse children of a node. Returns list of (DisplayName, NodeId, NodeClass).
         /// </summary>
+        /// <param name="nodeId">The node whose hierarchical children should be browsed.</param>
+        /// <returns>The child nodes exposed beneath the requested node.</returns>
         public async Task<List<(string Name, NodeId NodeId, NodeClass NodeClass)>> BrowseAsync(NodeId nodeId)
         {
             var results = new List<(string, NodeId, NodeClass)>();
@@ -109,6 +123,8 @@ namespace ZB.MOM.WW.LmxOpcUa.Tests.Helpers
         /// <summary>
         /// Read a node's value.
         /// </summary>
+        /// <param name="nodeId">The node whose current value should be read from the server.</param>
+        /// <returns>The OPC UA data value returned by the server.</returns>
         public DataValue Read(NodeId nodeId)
         {
             return Session.ReadValue(nodeId);
@@ -118,6 +134,10 @@ namespace ZB.MOM.WW.LmxOpcUa.Tests.Helpers
         /// Write a node's value, optionally using an OPC UA index range for array element writes.
         /// Returns the server status code for the write.
         /// </summary>
+        /// <param name="nodeId">The node whose value should be written.</param>
+        /// <param name="value">The value to send to the server.</param>
+        /// <param name="indexRange">An optional OPC UA index range used for array element writes.</param>
+        /// <returns>The server status code returned for the write request.</returns>
         public StatusCode Write(NodeId nodeId, object value, string? indexRange = null)
         {
             var nodesToWrite = new WriteValueCollection
@@ -139,6 +159,9 @@ namespace ZB.MOM.WW.LmxOpcUa.Tests.Helpers
         /// Create a subscription with a monitored item on the given node.
         /// Returns the subscription and monitored item for inspection.
         /// </summary>
+        /// <param name="nodeId">The node whose value changes should be monitored.</param>
+        /// <param name="intervalMs">The publishing and sampling interval, in milliseconds, for the test subscription.</param>
+        /// <returns>The created subscription and monitored item pair for later assertions and cleanup.</returns>
         public async Task<(Subscription Sub, MonitoredItem Item)> SubscribeAsync(
             NodeId nodeId, int intervalMs = 250)
         {
@@ -162,6 +185,9 @@ namespace ZB.MOM.WW.LmxOpcUa.Tests.Helpers
             return (subscription, item);
         }
 
+        /// <summary>
+        /// Closes the test session and releases OPC UA client resources.
+        /// </summary>
         public void Dispose()
         {
             if (_session != null)