Add SetTraceIdentifier to IHttpError and middleware

Introduce SetTraceIdentifier to IHttpError for trace correlation. Update exception middleware to set TraceIdentifier on errors. WebApiException implements the method (not yet implemented). This enables better tracking and diagnostics of errors.

Author: Vadim Belov

Sources/EasyExtensions.AspNetCore/Exceptions/WebApiException.cs

@@ -67,6 +67,16 @@ public ErrorModel GetErrorModel()
             };
         }
 
+        /// <summary>
+        /// Sets the trace identifier for the current context.
+        /// </summary>
+        /// <param name="traceId">The unique identifier to associate with the current trace. Cannot be null.</param>
+        /// <exception cref="NotImplementedException">Thrown when the method is called, as the implementation is not provided.</exception>
+        public void SetTraceIdentifier(string traceId)
+        {
+            throw new NotImplementedException();
+        }
+
         private static string GetRfcType(HttpStatusCode statusCode)
             => statusCode switch
             {

Sources/EasyExtensions.AspNetCore/Extensions/ServiceCollectionExtensions.cs

@@ -199,6 +199,11 @@ private static async Task HandleException(HttpContext context)
             var exception = exceptionHandlerPathFeature.Error;
             if (exception is IHttpError httpError)
             {
+                var traceId = context.TraceIdentifier;
+                if (!string.IsNullOrEmpty(traceId))
+                {
+                    httpError.SetTraceIdentifier(traceId);
+                }
                 context.Response.StatusCode = (int)httpError.StatusCode;
                 await context.Response.WriteAsJsonAsync(httpError.GetErrorModel());
             }

Sources/EasyExtensions/Abstractions/IHttpError.cs

@@ -17,6 +17,13 @@ public interface IHttpError
         /// <returns> Error model. </returns>
         ErrorModel GetErrorModel();
 
+        /// <summary>
+        /// Sets trace identifier for the error. This method can be used to associate a specific trace identifier
+        /// with the error, which can be useful for tracking and correlation purposes in logging and diagnostics.
+        /// </summary>
+        /// <param name="traceId">The trace identifier to associate with the error.</param>
+        void SetTraceIdentifier(string traceId);
+
         /// <summary>
         /// Gets status code.
         /// </summary>