Add XML documentation across gateway, worker, and .NET client

src/MxGateway.Worker/MxAccess/MxAccessEventMapper.cs

@@ -4,16 +4,21 @@ using MxGateway.Worker.Conversion;
 
 namespace MxGateway.Worker.MxAccess;
 
+/// <summary>Maps MXAccess COM events to protobuf MxEvent messages.</summary>
 public sealed class MxAccessEventMapper
 {
     private readonly VariantConverter variantConverter;
     private readonly MxStatusProxyConverter statusProxyConverter;
 
+    /// <summary>Initializes a new instance of the MxAccessEventMapper class with default converters.</summary>
     public MxAccessEventMapper()
         : this(new VariantConverter(), new MxStatusProxyConverter())
     {
     }
 
+    /// <summary>Initializes a new instance of the MxAccessEventMapper class with provided converters.</summary>
+    /// <param name="variantConverter">Converter for MXAccess variant values to MxValue protobuf messages.</param>
+    /// <param name="statusProxyConverter">Converter for MXAccess status arrays to MxStatusProxy protobuf messages.</param>
     public MxAccessEventMapper(
         VariantConverter variantConverter,
         MxStatusProxyConverter statusProxyConverter)
@@ -22,6 +27,14 @@ public sealed class MxAccessEventMapper
         this.statusProxyConverter = statusProxyConverter ?? throw new ArgumentNullException(nameof(statusProxyConverter));
     }
 
+    /// <summary>Creates an OnDataChange event from MXAccess COM event arguments.</summary>
+    /// <param name="sessionId">Identifier of the session.</param>
+    /// <param name="serverHandle">Handle returned by the worker.</param>
+    /// <param name="itemHandle">Handle returned by the worker.</param>
+    /// <param name="value">Item value received from MXAccess.</param>
+    /// <param name="quality">Item quality code from MXAccess.</param>
+    /// <param name="timestamp">Item timestamp from MXAccess.</param>
+    /// <param name="statuses">Array of MxStatusProxy values from MXAccess.</param>
     public MxEvent CreateOnDataChange(
         string sessionId,
         int serverHandle,
@@ -45,6 +58,11 @@ public sealed class MxAccessEventMapper
         return mxEvent;
     }
 
+    /// <summary>Creates an OnWriteComplete event from MXAccess COM event arguments.</summary>
+    /// <param name="sessionId">Identifier of the session.</param>
+    /// <param name="serverHandle">Handle returned by the worker.</param>
+    /// <param name="itemHandle">Handle returned by the worker.</param>
+    /// <param name="statuses">Array of MxStatusProxy values from MXAccess.</param>
     public MxEvent CreateOnWriteComplete(
         string sessionId,
         int serverHandle,
@@ -62,6 +80,11 @@ public sealed class MxAccessEventMapper
         return mxEvent;
     }
 
+    /// <summary>Creates an OperationComplete event from MXAccess COM event arguments.</summary>
+    /// <param name="sessionId">Identifier of the session.</param>
+    /// <param name="serverHandle">Handle returned by the worker.</param>
+    /// <param name="itemHandle">Handle returned by the worker.</param>
+    /// <param name="statuses">Array of MxStatusProxy values from MXAccess.</param>
     public MxEvent CreateOperationComplete(
         string sessionId,
         int serverHandle,
@@ -79,6 +102,15 @@ public sealed class MxAccessEventMapper
         return mxEvent;
     }
 
+    /// <summary>Creates an OnBufferedDataChange event from MXAccess COM event arguments.</summary>
+    /// <param name="sessionId">Identifier of the session.</param>
+    /// <param name="serverHandle">Handle returned by the worker.</param>
+    /// <param name="itemHandle">Handle returned by the worker.</param>
+    /// <param name="rawDataType">Raw MXAccess data type code for the buffered value.</param>
+    /// <param name="value">Item value received from MXAccess.</param>
+    /// <param name="quality">Array of quality values from MXAccess.</param>
+    /// <param name="timestamp">Array of timestamp values from MXAccess.</param>
+    /// <param name="statuses">Array of MxStatusProxy values from MXAccess.</param>
     public MxEvent CreateOnBufferedDataChange(
         string sessionId,
         int serverHandle,
@@ -108,6 +140,9 @@ public sealed class MxAccessEventMapper
         return mxEvent;
     }
 
+    /// <summary>Maps a raw MXAccess data type code to the MxDataType enum.</summary>
+    /// <param name="rawDataType">Raw MXAccess data type value to map.</param>
+    /// <returns>The corresponding MxDataType enum value.</returns>
     public static MxDataType MapMxDataType(int rawDataType)
     {
         return rawDataType switch