Feature/early mismatch (#1451)

* feat(request matchers): Add support for early mismatch in mapping processing

* test(request matchers): Add unit test for early mismatch functionality

* test(grpc): Add test for grpc requests early mismatch and error logging (Issue #1442)

* feat(request matchers): RequestMatcherType

Add `RequestMatcherType` to request matchers for improved type
identification

Closes #1442

* refactor(request matchers): Request

Replace `EarlyMatcherSelector` with `EarlyMatcherType` for improved
clarity and consistency

Closes #1442

* feat(request): conversion

Add EarlyMatcherType support in request models and mapping conversion

Closes #1442

* test(mapping): new tests

add unit tests for EarlyMatcherType in mapping conversion and
serialization

Closes #1442

* refactor(request matchers): RequestMessageEarlyMatcher

Replaced inline `EarlyMatcherType` logic with the new
`RequestMessageEarlyMatcher` class to support cases when several
matchers of the same type are present. For instance - Header, Cookie,
Param

Closes #1442

* test(request matchers): Early Mismatch

add unit tests for early mismatch scenarios with several matchers of
same type. Currently, headers and parameters

Closes #1442

* refactor(mapping): RequestModel.EarlyMatcherType

use fully qualified enum for EarlyMatcherType in serialization

Closes #1442

* style(review): fixes

- removed unused method
- added missing curly brackets

Closes #1442

test/WireMock.Net.Tests/Serialization/MappingConverterTests.cs

@@ -1,6 +1,7 @@
 // Copyright © WireMock.Net
 
 using WireMock.Matchers;
+using WireMock.Matchers.Request;
 using WireMock.Models;
 using WireMock.RequestBuilders;
 using WireMock.ResponseBuilders;
@@ -538,7 +539,7 @@ message HelloReply {
    id:ID!
    firstName:String
    lastName:String
-   fullName:String 
+   fullName:String
   }";
         var request = Request.Create().WithGraphQLSchema(schema);
         var response = Response.Create();
@@ -640,4 +641,25 @@ message HelloReply {
         // Verify
         return Verify(model);
     }
+
+    [Fact]
+    public Task ToMappingModel_Request_WithEarlyMismatch_ReturnsCorrectModel()
+    {
+        // Arrange
+        var request = Request.Create().WithEarlyMismatch(RequestMatcherType.ClientIP)
+            .WithHeader("x1", "y")
+            .WithClientIP("1.2.3.4");
+        var response = Response.Create();
+        var mapping = new Mapping(_guid, _updatedAt, string.Empty, string.Empty, null, _settings, request, response, 42, null, null, null, null, null, false, null, null);
+
+        // Act
+        var model = _sut.ToMappingModel(mapping);
+
+        // Assert
+        model.Should().NotBeNull();
+        model.Request.EarlyMatcherType.Should().Be(RequestMatcherType.ClientIP);
+
+        // Verify
+        return Verify(model);
+    }
 }