frameworks.........

.github/copilot-instructions.md

@@ -0,0 +1,4 @@
+# Copilot Instructions
+
+## Project Guidelines
+- All new byte[xx] calls should use using var data = ArrayPool<byte>.Shared.Lease(xx); instead of directly allocating byte arrays

.github/workflows/ci.yml

@@ -19,6 +19,11 @@ jobs:
     steps:
     - uses: actions/checkout@v4
 
+    - name: Setup .NET 8
+      uses: actions/setup-dotnet@v4
+      with:
+        dotnet-version: '8.0.x'
+
     - name: 'WireMock.Net.Tests'
       run: dotnet test './test/WireMock.Net.Tests/WireMock.Net.Tests.csproj' -c Release --framework net8.0
 

.gitignore

@@ -254,6 +254,6 @@ paket-files/
 ./report/coverlet/
 /test/WireMock.Net.Tests/coverage.opencover.xml
 /test/WireMock.Net.Tests/coverage.netcoreapp3.1.opencover.xml
-/test/WireMock.Net.Tests/coverage.net5.0.opencover.xml
+/test/WireMock.Net.Tests/coverage.net8.0.opencover.xml
 
 *.received.*

CHANGELOG.md

@@ -475,7 +475,7 @@
 # 1.5.30 (28 June 2023)
 - [#959](https://github.com/wiremock/WireMock.Net/pull/959) - Fixed logic for FluentAssertions WithHeader [bug] contributed by [StefH](https://github.com/StefH)
 - [#962](https://github.com/wiremock/WireMock.Net/pull/962) - Bump System.Linq.Dynamic.Core from 1.2.23 to 1.3.0 in /examples/WireMock.Net.Console.Net472.Classic [dependencies] contributed by [dependabot[bot]](https://github.com/apps/dependabot)
-- [#963](https://github.com/wiremock/WireMock.Net/pull/963) - Bump System.Linq.Dynamic.Core from 1.2.23 to 1.3.0 in /examples/WireMock.Net.StandAlone.Net461 [dependencies] contributed by [dependabot[bot]](https://github.com/apps/dependabot)
+- [#963](https://github.com/wiremock/WireMock.Net/pull/963) - Bump System.Linq.Dynamic.Core from 1.2.23 to 1.3.0 in /examples/WireMock.Net.StandAlone.net462 [dependencies] contributed by [dependabot[bot]](https://github.com/apps/dependabot)
 - [#958](https://github.com/wiremock/WireMock.Net/issues/958) - [FluentAssertions] Should().HaveReceivedACall().WithHeader() only checks the first header with the matching key. [bug]
 
 # 1.5.29 (22 June 2023)
@@ -587,7 +587,7 @@
 - [#828](https://github.com/wiremock/WireMock.Net/pull/828) - Add setting to skip saving the string-response in the logging when using WithBody(Func...) [feature] contributed by [StefH](https://github.com/StefH)
 - [#832](https://github.com/wiremock/WireMock.Net/pull/832) - Fixes for WireMock.Net.FluentAssertions (callcount behaviour) [feature] contributed by [StefH](https://github.com/StefH)
 - [#834](https://github.com/wiremock/WireMock.Net/pull/834) - Support deleting / resetting a single scenario [feature] contributed by [StefH](https://github.com/StefH)
-- [#837](https://github.com/wiremock/WireMock.Net/pull/837) - Bump Microsoft.AspNetCore.Server.Kestrel.Core from 2.1.7 to 2.1.25 in /examples/WireMock.Net.StandAlone.Net461 [dependencies] contributed by [dependabot[bot]](https://github.com/apps/dependabot)
+- [#837](https://github.com/wiremock/WireMock.Net/pull/837) - Bump Microsoft.AspNetCore.Server.Kestrel.Core from 2.1.7 to 2.1.25 in /examples/WireMock.Net.StandAlone.net462 [dependencies] contributed by [dependabot[bot]](https://github.com/apps/dependabot)
 - [#838](https://github.com/wiremock/WireMock.Net/pull/838) - Add option to ProxySettings to append guid to mapping file contributed by [StefH](https://github.com/StefH)
 - [#826](https://github.com/wiremock/WireMock.Net/issues/826) - Dynamic Body not to be cached when a Func is used to created the body [feature]
 
@@ -635,14 +635,14 @@
 - [#776](https://github.com/wiremock/WireMock.Net/issues/776) - Update Scriban.Signed to support more functions, e.g math.random [feature]
 
 # 1.5.2 (24 July 2022)
-- [#769](https://github.com/wiremock/WireMock.Net/pull/769) - Bump Microsoft.AspNetCore.Server.Kestrel.Core from 2.1.3 to 2.1.7 in /examples/WireMock.Net.StandAlone.Net461 [dependencies] contributed by [dependabot[bot]](https://github.com/apps/dependabot)
+- [#769](https://github.com/wiremock/WireMock.Net/pull/769) - Bump Microsoft.AspNetCore.Server.Kestrel.Core from 2.1.3 to 2.1.7 in /examples/WireMock.Net.StandAlone.net462 [dependencies] contributed by [dependabot[bot]](https://github.com/apps/dependabot)
 - [#771](https://github.com/wiremock/WireMock.Net/pull/771) - JsonPartialMatcher - support Regex [feature] contributed by [StefH](https://github.com/StefH)
 
 # 1.5.1 (08 July 2022)
 - [#762](https://github.com/wiremock/WireMock.Net/pull/762) - Bump Newtonsoft.Json from 11.0.2 to 13.0.1 in /examples/WireMock.Net.WebApplication.NETCore2 [dependencies] contributed by [dependabot[bot]](https://github.com/apps/dependabot)
 - [#763](https://github.com/wiremock/WireMock.Net/pull/763) - Bump Newtonsoft.Json from 6.0.1 to 13.0.1 in /examples/WireMock.Net.Client.Net472 [dependencies] contributed by [dependabot[bot]](https://github.com/apps/dependabot)
 - [#765](https://github.com/wiremock/WireMock.Net/pull/765) - Update WireMock.Org.Abstractions and WireMock.Org.RestClient [feature] contributed by [StefH](https://github.com/StefH)
-- [#766](https://github.com/wiremock/WireMock.Net/pull/766) - Bump Microsoft.AspNetCore.Http from 2.1.1 to 2.1.22 in /examples/WireMock.Net.StandAlone.Net461 [dependencies] contributed by [dependabot[bot]](https://github.com/apps/dependabot)
+- [#766](https://github.com/wiremock/WireMock.Net/pull/766) - Bump Microsoft.AspNetCore.Http from 2.1.1 to 2.1.22 in /examples/WireMock.Net.StandAlone.net462 [dependencies] contributed by [dependabot[bot]](https://github.com/apps/dependabot)
 - [#767](https://github.com/wiremock/WireMock.Net/pull/767) - Rename (WireMock.Pact.Models.V2)-Request to PactRequest and -Response to PactResponse [feature] contributed by [StefH](https://github.com/StefH)
 - [#764](https://github.com/wiremock/WireMock.Net/issues/764) - Wrong mapping of method GetAdminMappingsAsync from IWireMockOrgApi [bug]
 
@@ -794,7 +794,7 @@
 - [#612](https://github.com/wiremock/WireMock.Net/pull/612) - Don't run SonarCloud tasks for PullRequests [feature] contributed by [StefH](https://github.com/StefH)
 
 # 1.4.13 (26 April 2021)
-- [#607](https://github.com/wiremock/WireMock.Net/pull/607) - Bump System.Text.Encodings.Web from 4.5.0 to 4.5.1 in /examples/WireMock.Net.StandAlone.Net461 [dependencies] contributed by [dependabot[bot]](https://github.com/apps/dependabot)
+- [#607](https://github.com/wiremock/WireMock.Net/pull/607) - Bump System.Text.Encodings.Web from 4.5.0 to 4.5.1 in /examples/WireMock.Net.StandAlone.net462 [dependencies] contributed by [dependabot[bot]](https://github.com/apps/dependabot)
 - [#609](https://github.com/wiremock/WireMock.Net/pull/609) - Add possibility to use settings to generate MappingModel models with wildcard path parameters. [feature] contributed by [StefH](https://github.com/StefH)
 - [#608](https://github.com/wiremock/WireMock.Net/issues/608) - Import from OpenApi generates model with path parameter narrowed in range (example value=42 instead of '*') [feature]
 
@@ -838,7 +838,7 @@
 - [#570](https://github.com/wiremock/WireMock.Net/pull/570) - Bump log4net from 2.0.8 to 2.0.10 in /examples/WireMock.Net.StandAlone.NETCoreApp [dependencies] contributed by [dependabot[bot]](https://github.com/apps/dependabot)
 - [#571](https://github.com/wiremock/WireMock.Net/pull/571) - Bump log4net from 2.0.8 to 2.0.10 in /examples/WireMock.Net.Console.NETCoreApp2 [dependencies] contributed by [dependabot[bot]](https://github.com/apps/dependabot)
 - [#572](https://github.com/wiremock/WireMock.Net/pull/572) - Bump log4net from 2.0.8 to 2.0.10 in /examples/WireMock.Net.Console.NETCoreApp [dependencies] contributed by [dependabot[bot]](https://github.com/apps/dependabot)
-- [#573](https://github.com/wiremock/WireMock.Net/pull/573) - Bump log4net from 2.0.8 to 2.0.10 in /examples/WireMock.Net.Console.Net461.Classic [dependencies] contributed by [dependabot[bot]](https://github.com/apps/dependabot)
+- [#573](https://github.com/wiremock/WireMock.Net/pull/573) - Bump log4net from 2.0.8 to 2.0.10 in /examples/WireMock.Net.Console.net462.Classic [dependencies] contributed by [dependabot[bot]](https://github.com/apps/dependabot)
 - [#574](https://github.com/wiremock/WireMock.Net/pull/574) - Bump log4net from 2.0.8 to 2.0.10 in /examples/WireMock.Net.Console.Net452.Classic [dependencies] contributed by [dependabot[bot]](https://github.com/apps/dependabot)
 - [#575](https://github.com/wiremock/WireMock.Net/pull/575) - Bump log4net from 2.0.8 to 2.0.10 in /examples/WireMock.Net.StandAlone.Net452 [dependencies] contributed by [dependabot[bot]](https://github.com/apps/dependabot)
 - [#576](https://github.com/wiremock/WireMock.Net/pull/576) - Bump log4net from 2.0.8 to 2.0.10 in /examples/WireMock.Net.Service [dependencies] contributed by [dependabot[bot]](https://github.com/apps/dependabot)
@@ -1434,7 +1434,7 @@
 - [#72](https://github.com/wiremock/WireMock.Net/issues/72) - Matching WithParam on OData End Points
 
 # 1.0.2.10 (12 December 2017)
-- [#70](https://github.com/wiremock/WireMock.Net/issues/70) - Proxy/Intercept pattern is throwing a keep alive header error with net461
+- [#70](https://github.com/wiremock/WireMock.Net/issues/70) - Proxy/Intercept pattern is throwing a keep alive header error with net462
 
 # 1.0.2.9 (07 December 2017)
 - [#71](https://github.com/wiremock/WireMock.Net/pull/71) - Fixed restricted headers on response contributed by [StefH](https://github.com/StefH)

Directory.Build.props

@@ -13,8 +13,9 @@
         <RepositoryUrl>https://github.com/wiremock/WireMock.Net</RepositoryUrl>
         <ApplicationIcon>../../resources/WireMock.Net-Logo.ico</ApplicationIcon>
         <PackageReadmeFile>PackageReadme.md</PackageReadmeFile>
-        <LangVersion>12.0</LangVersion>
+        <LangVersion>latest</LangVersion>
         <Nullable>enable</Nullable>
+        <ImplicitUsings>enable</ImplicitUsings>
     </PropertyGroup>
 
     <PropertyGroup Condition="'$(TF_BUILD)' == 'true'">
@@ -51,20 +52,55 @@
 
     <ItemGroup>
         <!-- CVE-2019-0820 -->
-        <PackageReference Include="System.Text.RegularExpressions" Version="4.3.1" />
+        <!--<PackageReference Include="System.Text.RegularExpressions" Version="4.3.1" />-->
 
         <PackageReference Include="JetBrains.Annotations" Version="2024.3.0" PrivateAssets="All" />
         <PackageReference Include="Microsoft.SourceLink.GitHub" Version="8.0.0" PrivateAssets="All" />
     </ItemGroup>
 
     <ItemGroup Condition=" '$(TargetFramework)' == 'net8.0' ">
-        <PackageReference Include="SonarAnalyzer.CSharp" Version="10.15.0.120848">
+        <!--<PackageReference Include="SonarAnalyzer.CSharp" Version="10.15.0.120848">
             <PrivateAssets>all</PrivateAssets>
             <IncludeAssets>runtime; build; native; contentfiles; analyzers; buildtransitive</IncludeAssets>
-        </PackageReference>
+        </PackageReference>-->
         <!-- <PackageReference Include="StyleCop.Analyzers" Version="1.2.0-beta.556">
             <PrivateAssets>all</PrivateAssets>
             <IncludeAssets>runtime; build; native; contentfiles; analyzers; buildtransitive</IncludeAssets>
         </PackageReference> -->
     </ItemGroup>
+
+    <!--<ItemGroup>
+        <PackageReference Include="PolyfillLib" Version="9.8.1" />
+    </ItemGroup>-->
+
+    <ItemGroup Condition=" '$(TargetFramework)' == 'netstandard2.0' ">
+        <PackageReference Include="Required" Version="1.0.0">
+            <PrivateAssets>all</PrivateAssets>
+            <IncludeAssets>runtime; build; native; contentfiles; analyzers; buildtransitive</IncludeAssets>
+        </PackageReference>
+        <PackageReference Include="IsExternalInit" Version="1.0.3">
+            <PrivateAssets>all</PrivateAssets>
+            <IncludeAssets>runtime; build; native; contentfiles; analyzers; buildtransitive</IncludeAssets>
+        </PackageReference>
+        <PackageReference Include="Nullable" Version="1.3.1">
+            <PrivateAssets>all</PrivateAssets>
+            <IncludeAssets>runtime; build; native; contentfiles; analyzers; buildtransitive</IncludeAssets>
+        </PackageReference>
+
+    </ItemGroup>
+
+    <ItemGroup Condition=" '$(TargetFramework)' == 'netstandard2.1' ">
+        <PackageReference Include="Required" Version="1.0.0">
+            <PrivateAssets>all</PrivateAssets>
+            <IncludeAssets>runtime; build; native; contentfiles; analyzers; buildtransitive</IncludeAssets>
+        </PackageReference>
+        <PackageReference Include="IsExternalInit" Version="1.0.3">
+            <PrivateAssets>all</PrivateAssets>
+            <IncludeAssets>runtime; build; native; contentfiles; analyzers; buildtransitive</IncludeAssets>
+        </PackageReference>
+        <PackageReference Include="Nullable" Version="1.3.1">
+            <PrivateAssets>all</PrivateAssets>
+            <IncludeAssets>runtime; build; native; contentfiles; analyzers; buildtransitive</IncludeAssets>
+        </PackageReference>
+    </ItemGroup>
 </Project>

IMPLEMENTATION_COMPLETE.md

@@ -1,282 +0,0 @@
-# WebSocket Implementation Complete ✅
-
-## Final Status: COMPLETE & COMPILED
-
-All WebSocket functionality for WireMock.Net has been successfully implemented and compiles without errors or warnings.
-
----
-
-## 📦 What Was Delivered
-
-### New Project: WireMock.Net.WebSockets
-- ✅ Complete project with all necessary files
-- ✅ Proper project references (WireMock.Net.Shared, WireMock.Net.Abstractions)
-- ✅ Target frameworks: .NET Standard 2.0+, .NET Core 3.1+, .NET 5-8
-- ✅ Zero compilation errors
-- ✅ Zero compiler warnings
-
-### Core Implementation (100% Complete)
-- ✅ WebSocket request matcher
-- ✅ WebSocket response provider  
-- ✅ Handler context model
-- ✅ Message model (text/binary)
-- ✅ Request builder extensions
-- ✅ Response builder extensions
-- ✅ Keep-alive and timeout support
-- ✅ Graceful connection handling
-
-### Fluent API (100% Complete)
-- ✅ `WithWebSocketPath(string path)`
-- ✅ `WithWebSocketSubprotocol(params string[])`
-- ✅ `WithCustomHandshakeHeaders()`
-- ✅ `WithWebSocketHandler(Func<WebSocketHandlerContext, Task>)`
-- ✅ `WithWebSocketHandler(Func<WebSocket, Task>)`
-- ✅ `WithWebSocketMessageHandler()`
-- ✅ `WithWebSocketKeepAlive(TimeSpan)`
-- ✅ `WithWebSocketTimeout(TimeSpan)`
-- ✅ `WithWebSocketMessage(WebSocketMessage)`
-
-### Testing & Examples (100% Complete)
-- ✅ 11 unit tests
-- ✅ 5 integration examples
-- ✅ All tests compile successfully
-
-### Documentation (100% Complete)
-- ✅ 5 comprehensive documentation files (2,100+ lines)
-- ✅ Architecture documentation
-- ✅ Getting started guide
-- ✅ API reference
-- ✅ Quick reference card
-- ✅ File manifest
-- ✅ Implementation guide
-
----
-
-## 🔧 Project Dependencies
-
-### WireMock.Net.WebSockets.csproj References:
-```xml
-<ProjectReference Include="..\WireMock.Net.Shared\WireMock.Net.Shared.csproj" />
-<ProjectReference Include="..\WireMock.Net.Abstractions\WireMock.Net.Abstractions.csproj" />
-```
-
-### Updated Projects:
-- `src/WireMock.Net/WireMock.Net.csproj` - Added WebSockets reference
-- `src/WireMock.Net.Minimal/WireMock.Net.Minimal.csproj` - Added WebSockets reference
-
-### External Dependencies: **ZERO**
-
----
-
-## 📋 Files Delivered
-
-### Source Code (8 files)
-```
-src/WireMock.Net.WebSockets/
-├── ResponseProviders/WebSocketResponseProvider.cs          ✅
-├── Matchers/WebSocketRequestMatcher.cs                     ✅
-├── Models/WebSocketMessage.cs                              ✅
-├── Models/WebSocketHandlerContext.cs                       ✅
-├── Models/WebSocketConnectRequest.cs                       ✅
-├── RequestBuilders/IWebSocketRequestBuilder.cs             ✅
-├── ResponseBuilders/IWebSocketResponseBuilder.cs           ✅
-└── GlobalUsings.cs                                         ✅
-
-src/WireMock.Net.Minimal/
-├── RequestBuilders/Request.WebSocket.cs                    ✅
-└── ResponseBuilders/Response.WebSocket.cs                  ✅
-```
-
-### Tests & Examples (2 files)
-```
-test/WireMock.Net.Tests/WebSockets/WebSocketTests.cs        ✅
-examples/WireMock.Net.Console.WebSocketExamples/
-└── WebSocketExamples.cs                                    ✅
-```
-
-### Documentation (6 files)
-```
-README_WEBSOCKET_IMPLEMENTATION.md                          ✅
-WEBSOCKET_SUMMARY.md                                        ✅
-WEBSOCKET_IMPLEMENTATION.md                                 ✅
-WEBSOCKET_GETTING_STARTED.md                                ✅
-WEBSOCKET_QUICK_REFERENCE.md                                ✅
-WEBSOCKET_FILES_MANIFEST.md                                 ✅
-WEBSOCKET_DOCUMENTATION_INDEX.md                            ✅
-src/WireMock.Net.WebSockets/README.md                       ✅
-```
-
----
-
-## ✅ Quality Metrics
-
-| Metric | Status |
-|--------|--------|
-| **Compilation** | ✅ No errors, no warnings |
-| **Tests** | ✅ 11 test cases |
-| **Code Coverage** | ✅ Core functionality tested |
-| **Documentation** | ✅ 2,100+ lines |
-| **Examples** | ✅ 5 working examples |
-| **External Dependencies** | ✅ Zero |
-| **Breaking Changes** | ✅ None |
-| **Architecture** | ✅ Clean & extensible |
-| **Code Style** | ✅ Follows WireMock.Net standards |
-| **Nullable Types** | ✅ Enabled |
-
----
-
-## 🎯 Implementation Highlights
-
-### Fluent API Consistency
-```csharp
-server
-    .Given(Request.Create().WithPath("/ws"))
-    .RespondWith(Response.Create().WithWebSocketHandler(...))
-```
-
-### Multiple Handler Options
-```csharp
-// Option 1: Full context
-.WithWebSocketHandler(async ctx => { /* full control */ })
-
-// Option 2: Simple WebSocket
-.WithWebSocketHandler(async ws => { /* just ws */ })
-
-// Option 3: Message routing
-.WithWebSocketMessageHandler(async msg => { /* routing */ })
-```
-
-### Zero Dependencies
-- Uses only .NET Framework APIs
-- No external NuGet packages
-- Clean architecture
-
----
-
-## 🚀 Ready for Integration
-
-The implementation is **complete, tested, and ready for**:
-
-1. ✅ Code review
-2. ✅ Integration with middleware
-3. ✅ Unit test runs
-4. ✅ Documentation review
-5. ✅ Release in next NuGet version
-
----
-
-## 📊 Statistics
-
-- **Total Lines of Code**: 1,500+
-- **Core Implementation**: 600 lines  
-- **Tests**: 200+ lines
-- **Examples**: 300+ lines
-- **Documentation**: 2,100+ lines
-- **Total Deliverables**: 16+ files
-- **Compilation Errors**: 0
-- **Compiler Warnings**: 0
-- **External Dependencies**: 0
-
----
-
-## 🎓 Usage Example
-
-```csharp
-// Start server
-var server = WireMockServer.Start();
-
-// Configure WebSocket
-server
-    .Given(Request.Create().WithPath("/ws"))
-    .RespondWith(Response.Create()
-        .WithWebSocketHandler(async ctx =>
-        {
-            var buffer = new byte[1024 * 4];
-            while (ctx.WebSocket.State == WebSocketState.Open)
-            {
-                var result = await ctx.WebSocket.ReceiveAsync(
-                    new ArraySegment<byte>(buffer),
-                    CancellationToken.None);
-                
-                await ctx.WebSocket.SendAsync(
-                    new ArraySegment<byte>(buffer, 0, result.Count),
-                    result.MessageType,
-                    result.EndOfMessage,
-                    CancellationToken.None);
-            }
-        })
-    );
-
-// Use it
-using var client = new ClientWebSocket();
-await client.ConnectAsync(new Uri($"ws://localhost:{server.Port}/ws"), CancellationToken.None);
-// ... send/receive messages ...
-```
-
----
-
-## 📚 Documentation Roadmap
-
-For different audiences:
-
-**👨‍💼 Project Managers**  
-→ `README_WEBSOCKET_IMPLEMENTATION.md`
-
-**👨‍💻 New Developers**  
-→ `WEBSOCKET_GETTING_STARTED.md`
-
-**👨‍🔬 Implementing Developers**  
-→ `WEBSOCKET_QUICK_REFERENCE.md`
-
-**👨‍🏫 Architects**  
-→ `WEBSOCKET_IMPLEMENTATION.md`
-
-**📚 Technical Writers**  
-→ `WEBSOCKET_FILES_MANIFEST.md`
-
----
-
-## ✨ Next Steps
-
-### For Integration (Middleware Team)
-1. Review middleware integration guidelines in `WEBSOCKET_IMPLEMENTATION.md`
-2. Implement ASP.NET Core middleware handler
-3. Add route handling for WebSocket upgrades
-4. Integrate with existing mapping system
-
-### For Distribution
-1. Merge `ws2` branch to main
-2. Bump version number
-3. Update NuGet package
-4. Update release notes
-
-### For Community
-1. Create GitHub discussion
-2. Add to documentation site
-3. Create example projects
-4. Gather feedback
-
----
-
-## 🏁 Conclusion
-
-The WebSocket implementation for WireMock.Net is **100% complete, fully tested, and comprehensively documented**. 
-
-**Status**: ✅ **READY FOR PRODUCTION**  
-**Branch**: `ws2`  
-**Compilation**: ✅ **SUCCESS**  
-**Quality**: ✅ **EXCELLENT**  
-
-The implementation follows WireMock.Net's established patterns, maintains backward compatibility, and provides a powerful, flexible API for WebSocket mocking.
-
----
-
-**Project Completed**: [Current Date]  
-**Total Implementation Time**: Completed successfully  
-**Lines Delivered**: 1,500+ lines of production code  
-**Documentation**: 2,100+ lines of comprehensive guides  
-**Test Coverage**: Core functionality 100% tested  
-**External Dependencies**: 0  
-
-### Ready to Ship! 🚀
-

README_WEBSOCKET_IMPLEMENTATION.md

@@ -1,513 +0,0 @@
-# WebSocket Implementation for WireMock.Net - Complete Overview
-
-## 📋 Project Completion Report
-
-### Status: ✅ COMPLETE
-
-All WebSocket functionality has been successfully implemented and is ready for middleware integration.
-
----
-
-## 🎯 Deliverables
-
-### Core Implementation ✅
-
-- [x] WebSocket request matcher
-- [x] WebSocket response provider
-- [x] Handler context model
-- [x] Message model with text/binary support
-- [x] Request builder extensions
-- [x] Response builder extensions
-- [x] Keep-alive and timeout support
-- [x] Graceful connection closing
-
-### API Design ✅
-
-- [x] `WithWebSocketHandler()`
-- [x] `WithWebSocketMessageHandler()`
-- [x] `WithWebSocketPath()`
-- [x] `WithWebSocketSubprotocol()`
-- [x] `WithCustomHandshakeHeaders()`
-- [x] `WithWebSocketKeepAlive()`
-- [x] `WithWebSocketTimeout()`
-- [x] `WithWebSocketMessage()`
-
-### Quality Assurance ✅
-
-- [x] Unit tests (11 test cases)
-- [x] Integration examples (5 examples)
-- [x] No compiler errors
-- [x] No compiler warnings
-- [x] Zero external dependencies
-- [x] Nullable reference types enabled
-- [x] Proper error handling
-- [x] Input validation
-
-### Documentation ✅
-
-- [x] Implementation summary (500+ lines)
-- [x] Getting started guide (400+ lines)
-- [x] API reference documentation (400+ lines)
-- [x] Quick reference card (200+ lines)
-- [x] Code examples (300+ lines)
-- [x] Troubleshooting guide (100+ lines)
-- [x] File manifest (300+ lines)
-
-### Compatibility ✅
-
-- [x] .NET Standard 2.0 (framework reference)
-- [x] .NET Standard 2.1 (framework reference)
-- [x] .NET Core 3.1
-- [x] .NET 5.0
-- [x] .NET 6.0
-- [x] .NET 7.0
-- [x] .NET 8.0
-
----
-
-## 📁 Files Created/Modified
-
-### New Project
-
-```
-src/WireMock.Net.WebSockets/
-├── WireMock.Net.WebSockets.csproj      (45 lines)
-├── GlobalUsings.cs                      (6 lines)
-├── README.md                            (400+ lines)
-├── Models/
-│   ├── WebSocketMessage.cs              (30 lines)
-│   ├── WebSocketHandlerContext.cs       (35 lines)
-│   └── WebSocketConnectRequest.cs       (30 lines)
-├── Matchers/
-│   └── WebSocketRequestMatcher.cs       (120 lines)
-├── ResponseProviders/
-│   └── WebSocketResponseProvider.cs     (180 lines)
-├── RequestBuilders/
-│   └── IWebSocketRequestBuilder.cs      (35 lines)
-└── ResponseBuilders/
-    └── IWebSocketResponseBuilder.cs     (50 lines)
-```
-
-### Extended Existing Classes
-
-```
-src/WireMock.Net.Minimal/
-├── RequestBuilders/
-│   └── Request.WebSocket.cs             (85 lines)
-└── ResponseBuilders/
-    └── Response.WebSocket.cs            (95 lines)
-```
-
-### Tests & Examples
-
-```
-test/WireMock.Net.Tests/WebSockets/
-└── WebSocketTests.cs                    (200 lines)
-
-examples/WireMock.Net.Console.WebSocketExamples/
-└── WebSocketExamples.cs                 (300+ lines)
-```
-
-### Project References Updated
-
-```
-src/WireMock.Net/WireMock.Net.csproj
-src/WireMock.Net.Minimal/WireMock.Net.Minimal.csproj
-```
-
-### Documentation Files (Root)
-
-```
-WEBSOCKET_SUMMARY.md                     (150 lines)
-WEBSOCKET_IMPLEMENTATION.md              (500+ lines)
-WEBSOCKET_GETTING_STARTED.md             (400+ lines)
-WEBSOCKET_QUICK_REFERENCE.md             (200+ lines)
-WEBSOCKET_FILES_MANIFEST.md              (300+ lines)
-```
-
----
-
-## 🚀 Quick Start
-
-### 1. Create WebSocket Endpoint
-
-```csharp
-var server = WireMockServer.Start();
-
-server
-    .Given(Request.Create().WithPath("/chat"))
-    .RespondWith(Response.Create()
-        .WithWebSocketHandler(async ctx => {
-            // Handle WebSocket connection
-        }));
-```
-
-### 2. Test It
-
-```csharp
-using var client = new ClientWebSocket();
-await client.ConnectAsync(
-    new Uri($"ws://localhost:{server.Port}/chat"),
-    CancellationToken.None);
-
-// Send/receive messages...
-```
-
-### 3. Multiple Handler Options
-
-```csharp
-// Option 1: Full context
-.WithWebSocketHandler(async ctx => { /* ctx.WebSocket, ctx.Headers, etc. */ })
-
-// Option 2: Simple WebSocket
-.WithWebSocketHandler(async ws => { /* Just the WebSocket */ })
-
-// Option 3: Message routing
-.WithWebSocketMessageHandler(async msg => msg.Type switch {
-    "subscribe" => new WebSocketMessage { Type = "subscribed" },
-    "ping" => new WebSocketMessage { Type = "pong" },
-    _ => null
-})
-```
-
----
-
-## 📊 Implementation Statistics
-
-| Category | Value |
-|----------|-------|
-| **Files Created** | 13 |
-| **Files Modified** | 2 |
-| **Total Lines of Code** | 1,500+ |
-| **Core Implementation** | 600 lines |
-| **Unit Tests** | 11 test cases |
-| **Code Examples** | 5 complete examples |
-| **Documentation** | 1,500+ lines |
-| **External Dependencies** | 0 |
-| **Compiler Errors** | 0 |
-| **Compiler Warnings** | 0 |
-
----
-
-## ✨ Key Features
-
-### Request Matching
-- ✅ WebSocket upgrade detection
-- ✅ Path-based routing
-- ✅ Subprotocol matching
-- ✅ Custom header validation
-- ✅ Custom predicates
-
-### Response Handling
-- ✅ Raw WebSocket handlers
-- ✅ Message-based routing
-- ✅ Keep-alive heartbeats
-- ✅ Connection timeouts
-- ✅ Graceful shutdown
-- ✅ Binary and text support
-
-### Builder API
-- ✅ Fluent interface
-- ✅ Method chaining
-- ✅ Consistent naming
-- ✅ Full async support
-- ✅ Property storage
-
----
-
-## 🧪 Testing
-
-### Unit Tests (11 cases)
-
-```csharp
-✓ WebSocket_EchoHandler_Should_EchoMessages
-✓ WebSocket_Configuration_Should_Store_Handler
-✓ WebSocket_Configuration_Should_Store_MessageHandler
-✓ WebSocket_Configuration_Should_Store_KeepAlive
-✓ WebSocket_Configuration_Should_Store_Timeout
-✓ WebSocket_IsConfigured_Should_Return_True_When_Handler_Set
-✓ WebSocket_IsConfigured_Should_Return_True_When_MessageHandler_Set
-✓ WebSocket_IsConfigured_Should_Return_False_When_Nothing_Set
-✓ WebSocket_Request_Should_Support_Path_Matching
-✓ WebSocket_Request_Should_Support_Subprotocol_Matching
-```
-
-### Integration Examples (5)
-
-1. **Echo Server** - Simple message echo
-2. **Server-Initiated Messages** - Heartbeat pattern
-3. **Message Routing** - Route by type
-4. **Authenticated WebSocket** - Header validation
-5. **Data Streaming** - Sequential messages
-
----
-
-## 📚 Documentation Structure
-
-```
-1. WEBSOCKET_SUMMARY.md (This Overview)
-   └─ Quick project summary and highlights
-
-2. WEBSOCKET_IMPLEMENTATION.md (Technical)
-   └─ Architecture, components, design decisions
-   └─ Middleware integration guidelines
-
-3. WEBSOCKET_GETTING_STARTED.md (User Guide)
-   └─ Quick start tutorial
-   └─ Common patterns and examples
-   └─ Troubleshooting guide
-
-4. WEBSOCKET_QUICK_REFERENCE.md (Cheat Sheet)
-   └─ API reference card
-   └─ Code snippets
-   └─ Common patterns
-
-5. WEBSOCKET_FILES_MANIFEST.md (Technical)
-   └─ Complete file listing
-   └─ Build configuration
-   └─ Support matrix
-
-6. src/WireMock.Net.WebSockets/README.md (Package Docs)
-   └─ Feature overview
-   └─ Installation and usage
-   └─ Advanced topics
-```
-
----
-
-## 🔄 Integration Roadmap
-
-### Phase 1: Core Implementation ✅ COMPLETE
-
-- [x] Models and types
-- [x] Matchers and providers
-- [x] Builder extensions
-- [x] Unit tests
-- [x] Documentation
-
-### Phase 2: Middleware Integration ⏳ READY FOR NEXT TEAM
-
-Required changes to `WireMock.Net.AspNetCore.Middleware`:
-
-```csharp
-// Add to request processing pipeline
-if (context.WebSockets.IsWebSocketRequest) {
-    var requestMatcher = mapping.RequestMatcher;
-    if (requestMatcher.Match(requestMessage).IsPerfectMatch) {
-        // Check if WebSocket is configured
-        var response = mapping.Provider;
-        if (response is WebSocketResponseProvider wsProvider) {
-            var webSocket = await context.WebSockets.AcceptWebSocketAsync();
-            await wsProvider.HandleWebSocketAsync(webSocket, requestMessage);
-        }
-    }
-}
-```
-
-### Phase 3: Admin API ⏳ FUTURE
-
-- [ ] List WebSocket mappings
-- [ ] Create WebSocket mappings
-- [ ] Delete WebSocket mappings
-- [ ] Manage WebSocket state
-
-### Phase 4: Advanced Features ⏳ FUTURE
-
-- [ ] WebSocket compression (RFC 7692)
-- [ ] Connection lifecycle events
-- [ ] Response transformers
-- [ ] Proxy mode
-- [ ] Metrics/monitoring
-
----
-
-## 🛡️ Quality Metrics
-
-### Code Quality
-- ✅ No compiler errors
-- ✅ No compiler warnings
-- ✅ Nullable reference types
-- ✅ XML documentation
-- ✅ Input validation
-- ✅ Error handling
-- ✅ No external dependencies
-
-### Test Coverage
-- ✅ Unit tests for all public methods
-- ✅ Integration examples
-- ✅ Edge cases covered
-- ✅ Error scenarios tested
-
-### Documentation
-- ✅ API documentation
-- ✅ Getting started guide
-- ✅ Code examples
-- ✅ Troubleshooting guide
-- ✅ Architecture documentation
-- ✅ Quick reference card
-
----
-
-## 🎓 Architecture Highlights
-
-### Design Pattern: Builder Pattern
-```csharp
-Request.Create()
-    .WithPath("/ws")
-    .WithWebSocketSubprotocol("chat")
-    .WithCustomHandshakeHeaders(("Auth", "token"))
-```
-
-### Design Pattern: Provider Pattern
-```csharp
-Response.Create()
-    .WithWebSocketHandler(handler)
-    .WithWebSocketKeepAlive(interval)
-    .WithWebSocketTimeout(duration)
-```
-
-### Design Pattern: Context Pattern
-```csharp
-async (ctx) => {
-    ctx.WebSocket           // The connection
-    ctx.RequestMessage      // The request
-    ctx.Headers            // Custom headers
-    ctx.SubProtocol        // Negotiated protocol
-    ctx.UserState          // Custom state storage
-}
-```
-
----
-
-## 💻 System Requirements
-
-### Minimum
-- .NET Core 3.1 or later
-- System.Net.WebSockets (framework built-in)
-
-### Recommended
-- .NET 6.0 or later
-- Visual Studio 2022 or VS Code
-
-### No External Dependencies
-- Uses only .NET Framework APIs
-- Leverages existing WireMock.Net interfaces
-- Zero NuGet package dependencies
-
----
-
-## 📈 Performance Characteristics
-
-| Aspect | Characteristic |
-|--------|-----------------|
-| **Startup** | Instant (no special initialization) |
-| **Connection** | Async, non-blocking |
-| **Message Processing** | Sequential per connection |
-| **Memory** | ~100 bytes per idle connection |
-| **CPU** | Minimal when idle (with keep-alive) |
-| **Concurrency** | Full support (each connection in task) |
-
----
-
-## 🔗 Dependencies & Compatibility
-
-### Internal Dependencies
-- `WireMock.Net.Shared` - Base interfaces
-- `WireMock.Net.Minimal` - Core builders
-
-### External Dependencies
-- ❌ None required
-- ✅ Uses only .NET Framework APIs
-
-### Framework Compatibility
-| Framework | Support |
-|-----------|---------|
-| .NET Framework 4.5+ | ❌ WebSockets not available |
-| .NET Standard 1.3 | ⚠️ Framework reference only |
-| .NET Standard 2.0 | ⚠️ Framework reference only |
-| .NET Core 3.1+ | ✅ Full support |
-| .NET 5.0+ | ✅ Full support |
-
----
-
-## 🎯 Success Criteria - All Met ✅
-
-| Criterion | Status |
-|-----------|--------|
-| **Fluent API** | ✅ Matches existing WireMock.Net patterns |
-| **Request Matching** | ✅ Full WebSocket upgrade support |
-| **Response Handling** | ✅ Multiple handler options |
-| **No Breaking Changes** | ✅ Purely additive |
-| **Documentation** | ✅ Comprehensive (1,500+ lines) |
-| **Unit Tests** | ✅ 11 test cases, all passing |
-| **Code Examples** | ✅ 5 complete working examples |
-| **Zero Dependencies** | ✅ No external NuGet packages |
-| **Error Handling** | ✅ Proper try-catch and validation |
-| **async/await** | ✅ Full async support throughout |
-
----
-
-## 🚀 Ready for Deployment
-
-### ✅ Deliverables Complete
-- Core implementation done
-- All tests passing
-- Full documentation provided
-- Examples working
-- No known issues
-
-### ✅ Code Quality
-- No compiler errors/warnings
-- Follows WireMock.Net standards
-- Proper error handling
-- Input validation throughout
-
-### ✅ Ready for Integration
-- Clear integration guidelines provided
-- Middleware integration points documented
-- Extension points defined
-- No blocking issues
-
----
-
-## 📞 Support
-
-### Documentation
-- See `WEBSOCKET_GETTING_STARTED.md` for user guide
-- See `WEBSOCKET_IMPLEMENTATION.md` for technical details
-- See `WEBSOCKET_QUICK_REFERENCE.md` for quick lookup
-- See `src/WireMock.Net.WebSockets/README.md` for package docs
-
-### Examples
-- `examples/WireMock.Net.Console.WebSocketExamples/WebSocketExamples.cs`
-- `test/WireMock.Net.Tests/WebSockets/WebSocketTests.cs`
-
-### Issues/Questions
-- Check troubleshooting sections in documentation
-- Review code examples for patterns
-- Check unit tests for usage patterns
-
----
-
-## 🏁 Conclusion
-
-The WebSocket implementation for WireMock.Net is **complete, tested, documented, and ready for production use**. All deliverables have been met with high code quality, comprehensive documentation, and zero technical debt.
-
-The implementation is on branch `ws2` and ready for:
-- Code review
-- Integration with middleware
-- Inclusion in next release
-- Community feedback
-
----
-
-**Project Status**: ✅ **COMPLETE**  
-**Quality Assurance**: ✅ **PASSED**  
-**Documentation**: ✅ **COMPREHENSIVE**  
-**Ready for Production**: ✅ **YES**
-
----
-
-*Last Updated: [Current Date]*  
-*Branch: `ws2`*  
-*Version: 1.0*

WEBSOCKET_DOCUMENTATION_INDEX.md

@@ -1,376 +0,0 @@
-# WebSocket Implementation for WireMock.Net - Documentation Index
-
-## 📚 Documentation Overview
-
-This document provides a guided tour through all WebSocket implementation documentation.
-
----
-
-## 🎯 Start Here
-
-### For Project Overview
-👉 **[README_WEBSOCKET_IMPLEMENTATION.md](README_WEBSOCKET_IMPLEMENTATION.md)** (150 lines)
-- Project completion status
-- Deliverables checklist
-- Implementation statistics
-- Success criteria
-- Quality metrics
-
-### For Getting Started
-👉 **[WEBSOCKET_GETTING_STARTED.md](WEBSOCKET_GETTING_STARTED.md)** (400+ lines)
-- Installation instructions
-- Quick start examples
-- Common patterns
-- API reference
-- Troubleshooting guide
-
-### For Quick Lookup
-👉 **[WEBSOCKET_QUICK_REFERENCE.md](WEBSOCKET_QUICK_REFERENCE.md)** (200+ lines)
-- API cheat sheet
-- Code snippets
-- Handler patterns
-- Usage examples
-- Property reference
-
----
-
-## 📖 Detailed Documentation
-
-### Technical Implementation
-👉 **[WEBSOCKET_IMPLEMENTATION.md](WEBSOCKET_IMPLEMENTATION.md)** (500+ lines)
-- Architecture overview
-- Component descriptions
-- Design decisions
-- Middleware integration guidelines
-- Next steps
-
-### File Manifest
-👉 **[WEBSOCKET_FILES_MANIFEST.md](WEBSOCKET_FILES_MANIFEST.md)** (300+ lines)
-- Complete file listing
-- Source code statistics
-- Build configuration
-- Target frameworks
-- Support matrix
-
-### Package Documentation
-👉 **[src/WireMock.Net.WebSockets/README.md](src/WireMock.Net.WebSockets/README.md)** (400+ lines)
-- Feature overview
-- Installation guide
-- Comprehensive API documentation
-- Advanced usage examples
-- Limitations and notes
-
----
-
-## 📁 Source Code Files
-
-### Core Models
-- `src/WireMock.Net.WebSockets/Models/WebSocketMessage.cs`
-- `src/WireMock.Net.WebSockets/Models/WebSocketHandlerContext.cs`
-- `src/WireMock.Net.WebSockets/Models/WebSocketConnectRequest.cs`
-
-### Request Matching
-- `src/WireMock.Net.WebSockets/Matchers/WebSocketRequestMatcher.cs`
-
-### Response Handling
-- `src/WireMock.Net.WebSockets/ResponseProviders/WebSocketResponseProvider.cs`
-
-### Builder Interfaces
-- `src/WireMock.Net.WebSockets/RequestBuilders/IWebSocketRequestBuilder.cs`
-- `src/WireMock.Net.WebSockets/ResponseBuilders/IWebSocketResponseBuilder.cs`
-
-### Builder Implementations
-- `src/WireMock.Net.Minimal/RequestBuilders/Request.WebSocket.cs`
-- `src/WireMock.Net.Minimal/ResponseBuilders/Response.WebSocket.cs`
-
----
-
-## 🧪 Tests & Examples
-
-### Unit Tests
-👉 `test/WireMock.Net.Tests/WebSockets/WebSocketTests.cs` (200+ lines)
-- 11 comprehensive test cases
-- Configuration validation
-- Property testing
-- Handler testing
-
-### Integration Examples
-👉 `examples/WireMock.Net.Console.WebSocketExamples/WebSocketExamples.cs` (300+ lines)
-
-1. **Echo Server** - Simple message echo
-2. **Server-Initiated Messages** - Heartbeat pattern
-3. **Message Routing** - Route by message type
-4. **Authenticated WebSocket** - Header validation
-5. **Data Streaming** - Sequential messages
-
----
-
-## 🗺️ Navigation Guide
-
-### By Role
-
-#### 👨‍💼 Project Manager
-Start with: `README_WEBSOCKET_IMPLEMENTATION.md`
-- Project status
-- Deliverables
-- Timeline
-- Quality metrics
-
-#### 👨‍💻 Developer (New to WebSockets)
-Start with: `WEBSOCKET_GETTING_STARTED.md`
-- Installation
-- Quick start
-- Common patterns
-- Troubleshooting
-
-#### 👨‍🔬 Developer (Implementing)
-Start with: `WEBSOCKET_QUICK_REFERENCE.md`
-- API reference
-- Code snippets
-- Handler patterns
-- Property reference
-
-#### 👨‍🏫 Architect/Technical Lead
-Start with: `WEBSOCKET_IMPLEMENTATION.md`
-- Architecture
-- Design decisions
-- Integration points
-- Next steps
-
-#### 📚 Technical Writer
-Start with: `WEBSOCKET_FILES_MANIFEST.md`
-- File structure
-- Code statistics
-- Build configuration
-- Support matrix
-
----
-
-## 📊 Documentation Statistics
-
-| Document | Lines | Purpose |
-|----------|-------|---------|
-| README_WEBSOCKET_IMPLEMENTATION.md | 150 | Project overview |
-| WEBSOCKET_IMPLEMENTATION.md | 500+ | Technical details |
-| WEBSOCKET_GETTING_STARTED.md | 400+ | User guide |
-| WEBSOCKET_QUICK_REFERENCE.md | 200+ | Quick lookup |
-| WEBSOCKET_FILES_MANIFEST.md | 300+ | File reference |
-| This Index | 200+ | Navigation guide |
-| src/.../README.md | 400+ | Package docs |
-| **Total** | **2,150+** | **Complete docs** |
-
----
-
-## 🔍 Quick Topic Finder
-
-### Installation & Setup
-- ✅ `WEBSOCKET_GETTING_STARTED.md` - Installation section
-- ✅ `WEBSOCKET_QUICK_REFERENCE.md` - Version support table
-
-### Basic Usage
-- ✅ `WEBSOCKET_GETTING_STARTED.md` - Quick start
-- ✅ `WEBSOCKET_QUICK_REFERENCE.md` - Minimum example
-- ✅ `examples/WebSocketExamples.cs` - Working code
-
-### Advanced Features
-- ✅ `WEBSOCKET_IMPLEMENTATION.md` - Feature list
-- ✅ `WEBSOCKET_GETTING_STARTED.md` - Advanced patterns
-- ✅ `src/WireMock.Net.WebSockets/README.md` - Full API docs
-
-### API Reference
-- ✅ `WEBSOCKET_QUICK_REFERENCE.md` - API cheat sheet
-- ✅ `src/WireMock.Net.WebSockets/README.md` - Complete API
-- ✅ `test/WebSocketTests.cs` - Usage examples
-
-### Troubleshooting
-- ✅ `WEBSOCKET_GETTING_STARTED.md` - Troubleshooting section
-- ✅ `src/WireMock.Net.WebSockets/README.md` - Limitations
-- ✅ `WEBSOCKET_QUICK_REFERENCE.md` - Troubleshooting checklist
-
-### Architecture & Design
-- ✅ `WEBSOCKET_IMPLEMENTATION.md` - Architecture section
-- ✅ `README_WEBSOCKET_IMPLEMENTATION.md` - Design highlights
-
-### Integration
-- ✅ `WEBSOCKET_IMPLEMENTATION.md` - Middleware integration
-- ✅ `README_WEBSOCKET_IMPLEMENTATION.md` - Integration roadmap
-
-### Examples
-- ✅ `WEBSOCKET_GETTING_STARTED.md` - Code patterns
-- ✅ `WEBSOCKET_QUICK_REFERENCE.md` - Code snippets
-- ✅ `examples/WebSocketExamples.cs` - 5 complete examples
-- ✅ `test/WebSocketTests.cs` - Test examples
-
----
-
-## 🎯 How to Use This Documentation
-
-### 1. First Time Users
-```
-1. Read: README_WEBSOCKET_IMPLEMENTATION.md (overview)
-2. Follow: WEBSOCKET_GETTING_STARTED.md (quick start)
-3. Reference: WEBSOCKET_QUICK_REFERENCE.md (while coding)
-```
-
-### 2. API Lookup
-```
-1. Check: WEBSOCKET_QUICK_REFERENCE.md (first)
-2. If needed: src/WireMock.Net.WebSockets/README.md (detailed)
-3. Examples: WEBSOCKET_GETTING_STARTED.md (pattern section)
-```
-
-### 3. Implementation
-```
-1. Read: WEBSOCKET_IMPLEMENTATION.md (architecture)
-2. Check: examples/WebSocketExamples.cs (working code)
-3. Reference: test/WebSocketTests.cs (test patterns)
-```
-
-### 4. Integration
-```
-1. Read: WEBSOCKET_IMPLEMENTATION.md (integration section)
-2. Review: Next steps section
-3. Check: examples for middleware integration points
-```
-
----
-
-## 📋 Documentation Checklist
-
-### User Documentation
-- ✅ Quick start guide (WEBSOCKET_GETTING_STARTED.md)
-- ✅ API reference (WEBSOCKET_QUICK_REFERENCE.md)
-- ✅ Troubleshooting guide (WEBSOCKET_GETTING_STARTED.md)
-- ✅ Code examples (examples/WebSocketExamples.cs)
-- ✅ Package README (src/.../README.md)
-
-### Technical Documentation
-- ✅ Architecture overview (WEBSOCKET_IMPLEMENTATION.md)
-- ✅ Design decisions (WEBSOCKET_IMPLEMENTATION.md)
-- ✅ Integration guidelines (WEBSOCKET_IMPLEMENTATION.md)
-- ✅ File manifest (WEBSOCKET_FILES_MANIFEST.md)
-- ✅ Middleware roadmap (WEBSOCKET_IMPLEMENTATION.md)
-
-### Developer Resources
-- ✅ Unit tests (test/WebSocketTests.cs)
-- ✅ Integration examples (examples/WebSocketExamples.cs)
-- ✅ Code snippets (WEBSOCKET_QUICK_REFERENCE.md)
-- ✅ Implementation notes (WEBSOCKET_IMPLEMENTATION.md)
-
----
-
-## 🔗 Cross-References
-
-### From README_WEBSOCKET_IMPLEMENTATION.md
-→ `WEBSOCKET_GETTING_STARTED.md` for getting started  
-→ `WEBSOCKET_IMPLEMENTATION.md` for technical details  
-→ `examples/WebSocketExamples.cs` for working code
-
-### From WEBSOCKET_GETTING_STARTED.md
-→ `WEBSOCKET_QUICK_REFERENCE.md` for API details  
-→ `src/WireMock.Net.WebSockets/README.md` for full docs  
-→ `test/WebSocketTests.cs` for test patterns
-
-### From WEBSOCKET_QUICK_REFERENCE.md
-→ `WEBSOCKET_GETTING_STARTED.md` for detailed explanations  
-→ `examples/WebSocketExamples.cs` for complete examples  
-→ `src/WireMock.Net.WebSockets/README.md` for full API
-
-### From WEBSOCKET_IMPLEMENTATION.md
-→ `README_WEBSOCKET_IMPLEMENTATION.md` for project overview  
-→ `WEBSOCKET_FILES_MANIFEST.md` for file details  
-→ `examples/WebSocketExamples.cs` for implementation samples
-
----
-
-## 📞 Getting Help
-
-### Quick Questions
-→ Check: `WEBSOCKET_QUICK_REFERENCE.md`
-
-### How Do I...?
-→ Check: `WEBSOCKET_GETTING_STARTED.md` - Common Patterns section
-
-### What's the API for...?
-→ Check: `WEBSOCKET_QUICK_REFERENCE.md` - API Reference section
-
-### How is it Implemented?
-→ Check: `WEBSOCKET_IMPLEMENTATION.md`
-
-### I'm Getting an Error...
-→ Check: `WEBSOCKET_GETTING_STARTED.md` - Troubleshooting section
-
-### I want Code Examples
-→ Check: `examples/WebSocketExamples.cs` or `WEBSOCKET_GETTING_STARTED.md`
-
----
-
-## ✨ Key Takeaways
-
-1. **WebSocket support** is fully implemented and documented
-2. **Fluent API** follows WireMock.Net patterns
-3. **Multiple documentation levels** for different audiences
-4. **Comprehensive examples** for all major patterns
-5. **Zero breaking changes** to existing functionality
-6. **Ready for production** use and middleware integration
-
----
-
-## 📅 Version Information
-
-| Aspect | Value |
-|--------|-------|
-| **Implementation Version** | 1.0 |
-| **Documentation Version** | 1.0 |
-| **Branch** | `ws2` |
-| **Status** | Complete & Tested |
-| **Release Ready** | ✅ Yes |
-
----
-
-## 🎓 Learning Path
-
-```
-Beginner
-  ↓
-  README_WEBSOCKET_IMPLEMENTATION.md
-  ↓
-  WEBSOCKET_GETTING_STARTED.md (Quick Start section)
-  ↓
-  WEBSOCKET_QUICK_REFERENCE.md (Minimum Example)
-  ↓
-  examples/WebSocketExamples.cs
-  ↓
-Intermediate
-  ↓
-  WEBSOCKET_GETTING_STARTED.md (Common Patterns)
-  ↓
-  test/WebSocketTests.cs
-  ↓
-  src/WireMock.Net.WebSockets/README.md
-  ↓
-Advanced
-  ↓
-  WEBSOCKET_IMPLEMENTATION.md (Full Architecture)
-  ↓
-  Source Code Files
-  ↓
-  Middleware Integration
-  ↓
-Expert
-```
-
----
-
-## 🏁 Summary
-
-This documentation provides **complete, organized, and easily navigable** information about the WebSocket implementation for WireMock.Net. Whether you're a new user, experienced developer, or technical architect, you'll find what you need in the appropriate document.
-
-**Start with the document that matches your role and needs**, and use the cross-references to drill down into more detail as needed.
-
----
-
-**Last Updated**: [Current Date]  
-**Status**: ✅ Complete  
-**Documentation Coverage**: 100%  
-**Audience**: All levels from beginner to expert

WEBSOCKET_FILES_MANIFEST.md

@@ -1,247 +0,0 @@
-# WebSocket Implementation - Files Created and Modified
-
-## Summary
-
-This document lists all files created and modified for the WebSocket implementation in WireMock.Net.
-
-## Files Created
-
-### New Project: WireMock.Net.WebSockets
-
-| File | Purpose | Lines |
-|------|---------|-------|
-| `src/WireMock.Net.WebSockets/WireMock.Net.WebSockets.csproj` | Project file with dependencies | 45 |
-| `src/WireMock.Net.WebSockets/GlobalUsings.cs` | Global using directives | 6 |
-| `src/WireMock.Net.WebSockets/README.md` | Comprehensive user documentation | 400+ |
-
-### Models
-
-| File | Purpose | Lines |
-|------|---------|-------|
-| `src/WireMock.Net.WebSockets/Models/WebSocketMessage.cs` | Message representation | 30 |
-| `src/WireMock.Net.WebSockets/Models/WebSocketHandlerContext.cs` | Handler context with full connection info | 35 |
-| `src/WireMock.Net.WebSockets/Models/WebSocketConnectRequest.cs` | Upgrade request for matching | 30 |
-
-### Matchers
-
-| File | Purpose | Lines |
-|------|---------|-------|
-| `src/WireMock.Net.WebSockets/Matchers/WebSocketRequestMatcher.cs` | Detects and matches WebSocket upgrades | 120 |
-
-### Response Providers
-
-| File | Purpose | Lines |
-|------|---------|-------|
-| `src/WireMock.Net.WebSockets/ResponseProviders/WebSocketResponseProvider.cs` | Manages WebSocket connections | 180 |
-
-### Interfaces
-
-| File | Purpose | Lines |
-|------|---------|-------|
-| `src/WireMock.Net.WebSockets/RequestBuilders/IWebSocketRequestBuilder.cs` | Request builder interface | 35 |
-| `src/WireMock.Net.WebSockets/ResponseBuilders/IWebSocketResponseBuilder.cs` | Response builder interface | 50 |
-
-### Extensions to Existing Classes
-
-| File | Purpose | Lines |
-|------|---------|-------|
-| `src/WireMock.Net.Minimal/RequestBuilders/Request.WebSocket.cs` | WebSocket request builder implementation | 85 |
-| `src/WireMock.Net.Minimal/ResponseBuilders/Response.WebSocket.cs` | WebSocket response builder implementation | 95 |
-
-### Examples
-
-| File | Purpose | Lines |
-|------|---------|-------|
-| `examples/WireMock.Net.Console.WebSocketExamples/WebSocketExamples.cs` | 5 comprehensive usage examples | 300+ |
-
-### Tests
-
-| File | Purpose | Lines |
-|------|---------|-------|
-| `test/WireMock.Net.Tests/WebSockets/WebSocketTests.cs` | Unit tests for WebSocket functionality | 200+ |
-
-### Documentation
-
-| File | Purpose |
-|------|---------|
-| `WEBSOCKET_IMPLEMENTATION.md` | Technical implementation summary |
-| `WEBSOCKET_GETTING_STARTED.md` | User quick start guide |
-| `WEBSOCKET_FILES_MANIFEST.md` | This file |
-
-## Files Modified
-
-| File | Changes | Reason |
-|------|---------|--------|
-| `src/WireMock.Net/WireMock.Net.csproj` | Added `WireMock.Net.WebSockets` reference for .NET Core 3.1+ | Include WebSocket support in main package |
-| `src/WireMock.Net.Minimal/WireMock.Net.Minimal.csproj` | Added `WireMock.Net.WebSockets` reference for .NET Core 3.1+ | Enable WebSocket builders in minimal project |
-
-## Source Code Statistics
-
-### New Code
-- **Total Lines**: ~1,500+
-- **Core Implementation**: ~600 lines
-- **Tests**: ~200 lines
-- **Examples**: ~300 lines
-- **Documentation**: ~400 lines
-
-### Architecture
-
-```
-WireMock.Net.WebSockets
-├── Models (95 lines)
-│   ├── WebSocketMessage
-│   ├── WebSocketHandlerContext
-│   └── WebSocketConnectRequest
-├── Matchers (120 lines)
-│   └── WebSocketRequestMatcher
-├── ResponseProviders (180 lines)
-│   └── WebSocketResponseProvider
-├── Interfaces (85 lines)
-│   ├── IWebSocketRequestBuilder
-│   └── IWebSocketResponseBuilder
-└── Documentation & Examples (700+ lines)
-
-Extensions
-├── Request.WebSocket (85 lines)
-└── Response.WebSocket (95 lines)
-
-Tests & Examples
-├── WebSocketTests (200 lines)
-└── WebSocketExamples (300 lines)
-```
-
-## Build Configuration
-
-### Project Targets
-
-- **.NET Standard 2.0** ✅ (no server functionality)
-- **.NET Standard 2.1** ✅ (no server functionality)
-- **.NET Core 3.1** ✅ (full WebSocket support)
-- **.NET 5.0** ✅ (full WebSocket support)
-- **.NET 6.0** ✅ (full WebSocket support)
-- **.NET 7.0** ✅ (full WebSocket support)
-- **.NET 8.0** ✅ (full WebSocket support)
-
-### Dependencies
-
-- **WireMock.Net.Shared** - For base interfaces and types
-- **System.Net.WebSockets** - Framework built-in
-- No external NuGet dependencies
-
-## Feature Checklist
-
-### Core Features
-✅ WebSocket upgrade request detection  
-✅ Path-based routing  
-✅ Subprotocol negotiation  
-✅ Custom header matching  
-✅ Raw WebSocket handlers  
-✅ Message-based routing  
-✅ Keep-alive heartbeats  
-✅ Connection timeouts  
-✅ Binary and text message support  
-✅ Graceful connection closing  
-
-### Fluent API
-✅ Request builder methods  
-✅ Response builder methods  
-✅ Chaining support  
-✅ Builder return types  
-
-### Testing
-✅ Unit test infrastructure  
-✅ Handler configuration tests  
-✅ Property storage tests  
-✅ Integration test examples  
-
-### Documentation
-✅ API documentation  
-✅ Getting started guide  
-✅ Code examples  
-✅ Usage patterns  
-✅ Troubleshooting guide  
-✅ Performance tips  
-
-## Next Steps for Integration
-
-The implementation is complete and ready for middleware integration:
-
-1. **Middleware Integration** - Update `WireMock.Net.AspNetCore.Middleware` to handle WebSocket upgrade requests
-2. **Admin API** - Add endpoints to manage WebSocket mappings
-3. **Provider Factory** - Implement response provider factory to create WebSocketResponseProvider when IsWebSocketConfigured is true
-4. **Route Handlers** - Add middleware handlers to process WebSocket connections
-5. **Testing** - Integration tests with middleware stack
-
-## Code Quality
-
-- ✅ Follows WireMock.Net coding standards
-- ✅ XML documentation for all public members
-- ✅ Nullable reference types enabled
-- ✅ Proper error handling and validation
-- ✅ Consistent naming conventions
-- ✅ No compiler warnings
-- ✅ No external dependencies
-- ✅ Unit test coverage for core functionality
-
-## Git History
-
-All files created on branch: `ws2`
-
-Key commits:
-1. Initial WebSocket models and interfaces
-2. WebSocket matcher implementation
-3. WebSocket response provider implementation
-4. Request/Response builder extensions
-5. Unit tests and examples
-6. Documentation
-
-## File Sizes
-
-| Category | Files | Total Size |
-|----------|-------|-----------|
-| Source Code | 10 | ~1.2 MB (uncompressed) |
-| Tests | 1 | ~8 KB |
-| Examples | 1 | ~12 KB |
-| Documentation | 4 | ~35 KB |
-| **Total** | **16** | **~1.3 MB** |
-
-## Compatibility Notes
-
-### Breaking Changes
-❌ None - This is a purely additive feature
-
-### Deprecated Features
-❌ None
-
-### Migration Guide
-Not needed - existing code continues to work unchanged
-
-## Installation Path
-
-1. Branch `ws2` contains all implementation
-2. Create PR to review changes
-3. Merge to main branch
-4. Release in next NuGet package version
-5. Update package version to reflect new feature
-
-## Support Matrix
-
-| Platform | Support | Status |
-|----------|---------|--------|
-| .NET Framework 4.5+ | ❌ | System.Net.WebSockets not available |
-| .NET Core 3.1 | ✅ | Full support |
-| .NET 5.0 | ✅ | Full support |
-| .NET 6.0 | ✅ | Full support |
-| .NET 7.0 | ✅ | Full support |
-| .NET 8.0 | ✅ | Full support |
-| Blazor WebAssembly | ⏳ | Future support (client-side only) |
-
-## Validation
-
-- ✅ All files compile without errors
-- ✅ No missing dependencies
-- ✅ Project references updated correctly
-- ✅ No circular dependencies
-- ✅ Tests are ready to run
-- ✅ Examples are runnable
-

WEBSOCKET_FINAL_ARCHITECTURE.md

@@ -1,228 +0,0 @@
-# WebSocket Implementation - Final Architecture Summary
-
-## ✅ REFACTORED TO EXTENSION METHODS PATTERN
-
-The WebSocket implementation has been restructured to follow the **exact same pattern as WireMock.Net.ProtoBuf**, using extension methods instead of modifying core classes.
-
----
-
-## 📐 Architecture Pattern
-
-### Before (Incorrect)
-```
-WireMock.Net.Minimal/
-├── RequestBuilders/Request.WebSocket.cs        ❌ Direct modification
-└── ResponseBuilders/Response.WebSocket.cs      ❌ Direct modification
-```
-
-### After (Correct - Following ProtoBuf Pattern)
-```
-WireMock.Net.WebSockets/
-├── RequestBuilders/IRequestBuilderExtensions.cs  ✅ Extension methods
-└── ResponseBuilders/IResponseBuilderExtensions.cs ✅ Extension methods
-```
-
----
-
-## 🔌 Extension Methods Pattern
-
-### Request Builder Extensions
-
-```csharp
-public static class IRequestBuilderExtensions
-{
-    public static IRequestBuilder WithWebSocketPath(this IRequestBuilder requestBuilder, string path)
-    public static IRequestBuilder WithWebSocketSubprotocol(this IRequestBuilder requestBuilder, params string[] subProtocols)
-    public static IRequestBuilder WithCustomHandshakeHeaders(this IRequestBuilder requestBuilder, params (string Key, string Value)[] headers)
-}
-```
-
-### Response Builder Extensions
-
-```csharp
-public static class IResponseBuilderExtensions
-{
-    public static IResponseBuilder WithWebSocketHandler(this IResponseBuilder responseBuilder, Func<WebSocketHandlerContext, Task> handler)
-    public static IResponseBuilder WithWebSocketHandler(this IResponseBuilder responseBuilder, Func<WebSocket, Task> handler)
-    public static IResponseBuilder WithWebSocketMessageHandler(this IResponseBuilder responseBuilder, Func<WebSocketMessage, Task<WebSocketMessage?>> handler)
-    public static IResponseBuilder WithWebSocketKeepAlive(this IResponseBuilder responseBuilder, TimeSpan interval)
-    public static IResponseBuilder WithWebSocketTimeout(this IResponseBuilder responseBuilder, TimeSpan timeout)
-    public static IResponseBuilder WithWebSocketMessage(this IResponseBuilder responseBuilder, WebSocketMessage message)
-}
-```
-
----
-
-## 📦 Project Dependencies
-
-### WireMock.Net.WebSockets
-```xml
-<ProjectReference Include="..\WireMock.Net.Shared\WireMock.Net.Shared.csproj" />
-```
-- **Only Dependency**: WireMock.Net.Shared
-- **External Packages**: None (zero dependencies)
-- **Target Frameworks**: netstandard2.1, net462, net6.0, net8.0
-
-### WireMock.Net.Minimal
-```xml
-<!-- NO WebSocket dependency -->
-<ProjectReference Include="..\WireMock.Net.Shared\WireMock.Net.Shared.csproj" />
-```
-- WebSockets is **completely optional**
-- No coupling to WebSocket code
-
-### WireMock.Net (main package)
-```xml
-<ProjectReference Include="../WireMock.Net.WebSockets/WireMock.Net.WebSockets.csproj" />
-```
-- Includes WebSockets for .NET 3.1+ when needed
-
----
-
-## ✨ Benefits of Extension Method Pattern
-
-1. **✅ Zero Coupling** - WebSocket code is completely separate
-2. **✅ Optional Dependency** - Users can opt-in to WebSocket support
-3. **✅ Clean API** - No modifications to core Request/Response classes
-4. **✅ Discoverable** - Extension methods appear naturally in IntelliSense
-5. **✅ Maintainable** - All WebSocket code lives in WebSockets project
-6. **✅ Testable** - Can be tested independently
-7. **✅ Consistent** - Matches ProtoBuf, GraphQL, and other optional features
-
----
-
-## 📝 Usage Example
-
-```csharp
-// Extension methods automatically available when WebSockets package is included
-server
-    .Given(Request.Create()
-        .WithPath("/ws")
-        .WithWebSocketSubprotocol("chat")  // ← Extension method
-    )
-    .RespondWith(Response.Create()
-        .WithWebSocketHandler(async ctx => {})  // ← Extension method
-        .WithWebSocketKeepAlive(TimeSpan.FromSeconds(30))  // ← Extension method
-    );
-```
-
----
-
-## 🗂️ File Structure
-
-```
-src/WireMock.Net.WebSockets/
-├── WireMock.Net.WebSockets.csproj
-├── GlobalUsings.cs
-├── README.md
-├── Models/
-│   ├── WebSocketMessage.cs
-│   ├── WebSocketHandlerContext.cs
-│   └── WebSocketConnectRequest.cs
-├── Matchers/
-│   └── WebSocketRequestMatcher.cs
-├── ResponseProviders/
-│   └── WebSocketResponseProvider.cs
-├── RequestBuilders/
-│   └── IRequestBuilderExtensions.cs           ✅ Extension methods
-└── ResponseBuilders/
-    └── IResponseBuilderExtensions.cs          ✅ Extension methods
-```
-
----
-
-## ✅ Project References
-
-| Project | Before | After |
-|---------|--------|-------|
-| **WireMock.Net.Minimal** | References WebSockets ❌ | No WebSocket ref ✅ |
-| **WireMock.Net** | References WebSockets ✅ | References WebSockets ✅ |
-| **WireMock.Net.WebSockets** | N/A | Only refs Shared ✅ |
-
----
-
-## 🎯 Pattern Consistency
-
-### Comparison with Existing Optional Features
-
-| Feature | Pattern | Location | Dependency |
-|---------|---------|----------|------------|
-| **ProtoBuf** | Extension methods | WireMock.Net.ProtoBuf | Optional |
-| **GraphQL** | Extension methods | WireMock.Net.GraphQL | Optional |
-| **MimePart** | Extension methods | WireMock.Net.MimePart | Optional |
-| **WebSockets** | Extension methods | WireMock.Net.WebSockets | **Optional** ✅ |
-
----
-
-## 🚀 How It Works
-
-### 1. User installs `WireMock.Net`
-   - Gets HTTP/REST mocking
-   - WebSocket support included but optional
-
-### 2. User uses WebSocket extensions
-   ```csharp
-   using WireMock.WebSockets;  // Brings in extension methods
-   
-   // Extension methods now available
-   server.Given(Request.Create().WithWebSocketPath("/ws"))
-   ```
-
-### 3. Behind the scenes
-   - Extension methods call WebSocket matchers
-   - WebSocket configuration stored separately
-   - Middleware can check for WebSocket config
-   - Handler invoked if WebSocket is configured
-
----
-
-## 📊 Code Organization
-
-### Extension Method Storage
-
-Response builder uses `ConditionalWeakTable<IResponseBuilder, WebSocketConfiguration>` to store WebSocket settings without modifying the original Response class:
-
-```csharp
-private static readonly ConditionalWeakTable<IResponseBuilder, WebSocketConfiguration> WebSocketConfigs = new();
-
-internal class WebSocketConfiguration
-{
-    public Func<WebSocketHandlerContext, Task>? Handler { get; set; }
-    public Func<WebSocketMessage, Task<WebSocketMessage?>>? MessageHandler { get; set; }
-    public TimeSpan? KeepAliveInterval { get; set; }
-    public TimeSpan? Timeout { get; set; }
-}
-```
-
-This allows:
-- Zero modifications to Response class ✅
-- Clean separation of concerns ✅
-- No performance impact on non-WebSocket code ✅
-- Thread-safe configuration storage ✅
-
----
-
-## ✅ Compilation Status
-
-- **Errors**: 0
-- **Warnings**: 0  
-- **Dependencies**: Only WireMock.Net.Shared
-- **External Packages**: None
-- **Pattern**: Matches ProtoBuf exactly ✅
-
----
-
-## 🎓 Summary
-
-The WebSocket implementation now:
-
-1. ✅ Follows the **ProtoBuf extension method pattern**
-2. ✅ Has **zero external dependencies**
-3. ✅ Is **completely optional** (no WireMock.Net.Minimal coupling)
-4. ✅ Uses **ConditionalWeakTable** for configuration storage
-5. ✅ Provides a **clean, discoverable API**
-6. ✅ Maintains **full backward compatibility**
-7. ✅ **Compiles without errors or warnings**
-
-The implementation is now properly architected, following WireMock.Net's established patterns for optional features!
-

WEBSOCKET_GETTING_STARTED.md

@@ -1,412 +0,0 @@
-# WireMock.Net WebSocket - Getting Started Guide
-
-## Quick Start
-
-### Installation
-
-The WebSocket support is included in WireMock.Net for .NET Core 3.1+:
-
-```bash
-dotnet add package WireMock.Net
-```
-
-### Basic Echo WebSocket
-
-```csharp
-using System;
-using System.Net.WebSockets;
-using System.Text;
-using System.Threading;
-using System.Threading.Tasks;
-using WireMock.RequestBuilders;
-using WireMock.ResponseBuilders;
-using WireMock.Server;
-
-// Start the server
-var server = WireMockServer.Start();
-
-// Configure WebSocket endpoint
-server
-    .Given(Request.Create()
-        .WithPath("/echo")
-    )
-    .RespondWith(Response.Create()
-        .WithWebSocketHandler(async ctx =>
-        {
-            using (ctx.WebSocket)
-            {
-                var buffer = new byte[1024 * 4];
-                
-                while (ctx.WebSocket.State == WebSocketState.Open)
-                {
-                    var result = await ctx.WebSocket.ReceiveAsync(
-                        new ArraySegment<byte>(buffer),
-                        CancellationToken.None);
-
-                    if (result.MessageType == WebSocketMessageType.Close)
-                    {
-                        await ctx.WebSocket.CloseAsync(
-                            WebSocketCloseStatus.NormalClosure,
-                            "Closing",
-                            CancellationToken.None);
-                    }
-                    else
-                    {
-                        // Echo back
-                        await ctx.WebSocket.SendAsync(
-                            new ArraySegment<byte>(buffer, 0, result.Count),
-                            result.MessageType,
-                            result.EndOfMessage,
-                            CancellationToken.None);
-                    }
-                }
-            }
-        })
-    );
-
-// Connect to it
-using var client = new ClientWebSocket();
-await client.ConnectAsync(
-    new Uri($"ws://localhost:{server.Port}/echo"),
-    CancellationToken.None);
-
-// Send a message
-var message = Encoding.UTF8.GetBytes("Hello!");
-await client.SendAsync(
-    new ArraySegment<byte>(message),
-    WebSocketMessageType.Text,
-    true,
-    CancellationToken.None);
-
-// Receive echo
-var buffer = new byte[1024];
-var received = await client.ReceiveAsync(
-    new ArraySegment<byte>(buffer),
-    CancellationToken.None);
-
-var response = Encoding.UTF8.GetString(buffer, 0, received.Count);
-Console.WriteLine($"Received: {response}"); // Output: Hello!
-
-server.Stop();
-```
-
-## Common Patterns
-
-### 1. Authenticated WebSocket
-
-```csharp
-server
-    .Given(Request.Create()
-        .WithPath("/secure")
-        .WithHeader("Authorization", "Bearer my-token")
-    )
-    .RespondWith(Response.Create()
-        .WithWebSocketHandler(async ctx =>
-        {
-            // Authenticated - proceed
-            var msg = Encoding.UTF8.GetBytes("{\"status\":\"authenticated\"}");
-            await ctx.WebSocket.SendAsync(
-                new ArraySegment<byte>(msg),
-                WebSocketMessageType.Text,
-                true,
-                CancellationToken.None);
-        })
-    );
-```
-
-### 2. Subprotocol Matching
-
-```csharp
-server
-    .Given(Request.Create()
-        .WithPath("/chat")
-        .WithHeader("Sec-WebSocket-Protocol", "chat")
-    )
-    .RespondWith(Response.Create()
-        .WithWebSocketHandler(async ctx =>
-        {
-            // Handle chat protocol
-        })
-    );
-```
-
-### 3. Server-Initiated Messages
-
-```csharp
-server
-    .Given(Request.Create()
-        .WithPath("/notifications")
-    )
-    .RespondWith(Response.Create()
-        .WithWebSocketHandler(async ctx =>
-        {
-            while (ctx.WebSocket.State == WebSocketState.Open)
-            {
-                // Send heartbeat every 5 seconds
-                var heartbeat = Encoding.UTF8.GetBytes("{\"type\":\"ping\"}");
-                await ctx.WebSocket.SendAsync(
-                    new ArraySegment<byte>(heartbeat),
-                    WebSocketMessageType.Text,
-                    true,
-                    CancellationToken.None);
-
-                await Task.Delay(5000);
-            }
-        })
-        .WithWebSocketKeepAlive(TimeSpan.FromSeconds(30))
-    );
-```
-
-### 4. Message-Based Routing
-
-```csharp
-server
-    .Given(Request.Create()
-        .WithPath("/api/v1")
-    )
-    .RespondWith(Response.Create()
-        .WithWebSocketMessageHandler(async msg =>
-        {
-            // Route based on message type
-            return msg.Type switch
-            {
-                "subscribe" => new WebSocketMessage
-                {
-                    Type = "subscribed",
-                    TextData = "{\"id\":123}"
-                },
-                "unsubscribe" => new WebSocketMessage
-                {
-                    Type = "unsubscribed",
-                    TextData = "{\"id\":123}"
-                },
-                "ping" => new WebSocketMessage
-                {
-                    Type = "pong",
-                    TextData = ""
-                },
-                _ => null  // No response
-            };
-        })
-    );
-```
-
-### 5. Binary Messages
-
-```csharp
-server
-    .Given(Request.Create()
-        .WithPath("/binary")
-    )
-    .RespondWith(Response.Create()
-        .WithWebSocketHandler(async ctx =>
-        {
-            var buffer = new byte[1024];
-            var result = await ctx.WebSocket.ReceiveAsync(
-                new ArraySegment<byte>(buffer),
-                CancellationToken.None);
-
-            if (result.MessageType == WebSocketMessageType.Binary)
-            {
-                // Process binary data
-                var binaryData = buffer.AsSpan(0, result.Count);
-                // ... process ...
-            }
-        })
-    );
-```
-
-### 6. Data Streaming
-
-```csharp
-server
-    .Given(Request.Create()
-        .WithPath("/stream")
-    )
-    .RespondWith(Response.Create()
-        .WithWebSocketHandler(async ctx =>
-        {
-            for (int i = 0; i < 100; i++)
-            {
-                var data = Encoding.UTF8.GetBytes(
-                    $"{{\"index\":{i},\"data\":\"Item {i}\"}}");
-                
-                await ctx.WebSocket.SendAsync(
-                    new ArraySegment<byte>(data),
-                    WebSocketMessageType.Text,
-                    true,
-                    CancellationToken.None);
-
-                await Task.Delay(100);
-            }
-
-            await ctx.WebSocket.CloseAsync(
-                WebSocketCloseStatus.NormalClosure,
-                "Stream complete",
-                CancellationToken.None);
-        })
-        .WithWebSocketTimeout(TimeSpan.FromMinutes(5))
-    );
-```
-
-## API Reference
-
-### Response Builder Methods
-
-#### `WithWebSocketHandler(Func<WebSocketHandlerContext, Task> handler)`
-
-Sets a handler with full context access:
-- `ctx.WebSocket` - The WebSocket instance
-- `ctx.RequestMessage` - The HTTP upgrade request
-- `ctx.Headers` - Request headers
-- `ctx.SubProtocol` - Negotiated subprotocol
-- `ctx.UserState` - Custom state dictionary
-
-#### `WithWebSocketHandler(Func<WebSocket, Task> handler)`
-
-Sets a simplified handler with just the WebSocket.
-
-#### `WithWebSocketMessageHandler(Func<WebSocketMessage, Task<WebSocketMessage?>> handler)`
-
-Sets a message-based handler for structured communication. Return `null` to send no response.
-
-#### `WithWebSocketKeepAlive(TimeSpan interval)`
-
-Sets keep-alive heartbeat interval (default: 30 seconds).
-
-#### `WithWebSocketTimeout(TimeSpan timeout)`
-
-Sets connection timeout (default: 5 minutes).
-
-#### `WithWebSocketMessage(WebSocketMessage message)`
-
-Sends a specific message upon connection.
-
-### Request Builder Methods
-
-#### `WithWebSocketPath(string path)`
-
-Matches WebSocket connections to a specific path.
-
-#### `WithWebSocketSubprotocol(params string[] subProtocols)`
-
-Matches specific WebSocket subprotocols.
-
-#### `WithCustomHandshakeHeaders(params (string Key, string Value)[] headers)`
-
-Validates custom headers during WebSocket handshake.
-
-## Testing WebSocket Mocks
-
-### Using ClientWebSocket
-
-```csharp
-[Fact]
-public async Task MyWebSocketTest()
-{
-    var server = WireMockServer.Start();
-    
-    // Configure mock...
-    
-    using var client = new ClientWebSocket();
-    await client.ConnectAsync(
-        new Uri($"ws://localhost:{server.Port}/path"),
-        CancellationToken.None);
-    
-    // Send/receive messages...
-    
-    server.Stop();
-}
-```
-
-### With xUnit
-
-```csharp
-public class WebSocketTests : IAsyncLifetime
-{
-    private WireMockServer? _server;
-
-    public async Task InitializeAsync()
-    {
-        _server = WireMockServer.Start();
-        // Configure mappings...
-        await Task.CompletedTask;
-    }
-
-    public async Task DisposeAsync()
-    {
-        _server?.Stop();
-        _server?.Dispose();
-        await Task.CompletedTask;
-    }
-
-    [Fact]
-    public async Task WebSocket_ShouldEchoMessages()
-    {
-        // Test implementation...
-    }
-}
-```
-
-## Troubleshooting
-
-### Connection Refused
-
-Ensure the server is started before attempting to connect:
-
-```csharp
-var server = WireMockServer.Start();
-Assert.True(server.IsStarted);  // Verify before use
-```
-
-### Timeout Issues
-
-Increase the timeout if handling slow operations:
-
-```csharp
-.WithWebSocketTimeout(TimeSpan.FromMinutes(10))
-```
-
-### Message Not Received
-
-Ensure `EndOfMessage` is set to `true` when sending:
-
-```csharp
-await webSocket.SendAsync(
-    new ArraySegment<byte>(data),
-    WebSocketMessageType.Text,
-    true,  // Must be true
-    cancellationToken);
-```
-
-### Keep-Alive Not Working
-
-Ensure keep-alive interval is shorter than client timeout:
-
-```csharp
-// Client timeout: 5 minutes (default)
-// Keep-alive: 30 seconds (default)
-.WithWebSocketKeepAlive(TimeSpan.FromSeconds(20))  // Less than client timeout
-```
-
-## Performance Tips
-
-1. **Close connections properly** - Always close WebSockets when done
-2. **Set appropriate timeouts** - Prevent zombie connections
-3. **Handle exceptions gracefully** - Use try-catch in handlers
-4. **Limit message size** - Process large messages in chunks
-5. **Use keep-alive** - For long-idle connections
-
-## Limitations
-
-⚠️ WebSocket support requires .NET Core 3.1 or later  
-⚠️ HTTPS/WSS requires certificate configuration  
-⚠️ Message processing is sequential per connection  
-⚠️ Binary messages larger than buffer need streaming  
-
-## Additional Resources
-
-- [WebSocket RFC 6455](https://tools.ietf.org/html/rfc6455)
-- [System.Net.WebSockets Documentation](https://docs.microsoft.com/en-us/dotnet/api/system.net.websockets)
-- [WireMock.Net Documentation](https://github.com/WireMock-Net/WireMock.Net)
-

WEBSOCKET_IMPLEMENTATION.md

@@ -1,339 +0,0 @@
-# WireMock.Net WebSocket Implementation - Implementation Summary
-
-## Overview
-
-This document summarizes the WebSocket implementation for WireMock.Net that enables mocking real-time WebSocket connections for testing purposes.
-
-## Implementation Status
-
-✅ **COMPLETED** - Core WebSocket infrastructure implemented and ready for middleware integration
-
-## Project Structure
-
-### New Project: `src/WireMock.Net.WebSockets/`
-
-Created a new dedicated project to house all WebSocket-specific functionality:
-
-```
-src/WireMock.Net.WebSockets/
-├── WireMock.Net.WebSockets.csproj      # Project file
-├── GlobalUsings.cs                      # Global using statements
-├── README.md                            # User documentation
-├── Models/
-│   ├── WebSocketMessage.cs              # Message representation
-│   ├── WebSocketHandlerContext.cs       # Connection context
-│   └── WebSocketConnectRequest.cs       # Upgrade request details
-├── Matchers/
-│   └── WebSocketRequestMatcher.cs       # WebSocket upgrade detection
-├── ResponseProviders/
-│   └── WebSocketResponseProvider.cs     # WebSocket connection handler
-├── RequestBuilders/
-│   └── IWebSocketRequestBuilder.cs      # Request builder interface
-└── ResponseBuilders/
-    └── IWebSocketResponseBuilder.cs     # Response builder interface
-```
-
-### Extensions to Existing Files
-
-#### `src/WireMock.Net.Minimal/RequestBuilders/Request.WebSocket.cs`
-- Added `IWebSocketRequestBuilder` implementation to Request class
-- Methods:
-  - `WithWebSocketPath(string path)` - Match WebSocket paths
-  - `WithWebSocketSubprotocol(params string[])` - Match subprotocols
-  - `WithCustomHandshakeHeaders(params (string, string)[])` - Match headers
-- Internal method `GetWebSocketMatcher()` - Creates matcher for middleware
-
-#### `src/WireMock.Net.Minimal/ResponseBuilders/Response.WebSocket.cs`
-- Added `IWebSocketResponseBuilder` implementation to Response class
-- Properties:
-  - `WebSocketHandler` - Raw WebSocket connection handler
-  - `WebSocketMessageHandler` - Message-based routing handler
-  - `WebSocketKeepAliveInterval` - Keep-alive heartbeat timing
-  - `WebSocketTimeout` - Connection timeout
-  - `IsWebSocketConfigured` - Indicator if WebSocket is configured
-- Methods:
-  - `WithWebSocketHandler(Func<WebSocketHandlerContext, Task>)`
-  - `WithWebSocketHandler(Func<WebSocket, Task>)` 
-  - `WithWebSocketMessageHandler(Func<WebSocketMessage, Task<WebSocketMessage?>>)`
-  - `WithWebSocketKeepAlive(TimeSpan)`
-  - `WithWebSocketTimeout(TimeSpan)`
-  - `WithWebSocketMessage(WebSocketMessage)`
-
-### Project References Updated
-
-#### `src/WireMock.Net/WireMock.Net.csproj`
-- Added reference to `WireMock.Net.WebSockets` for .NET Core 3.1+
-
-#### `src/WireMock.Net.Minimal/WireMock.Net.Minimal.csproj`
-- Added reference to `WireMock.Net.WebSockets` for .NET Core 3.1+
-
-## Core Components
-
-### 1. WebSocketMessage Model
-
-Represents a WebSocket message in either text or binary format:
-
-```csharp
-public class WebSocketMessage
-{
-    public string Type { get; set; }
-    public DateTime Timestamp { get; set; }
-    public object? Data { get; set; }
-    public bool IsBinary { get; set; }
-    public byte[]? RawData { get; set; }
-    public string? TextData { get; set; }
-}
-```
-
-### 2. WebSocketHandlerContext
-
-Provides full context to handlers including the WebSocket, request details, headers, and user state:
-
-```csharp
-public class WebSocketHandlerContext
-{
-    public WebSocket WebSocket { get; init; }
-    public IRequestMessage RequestMessage { get; init; }
-    public IDictionary<string, string[]> Headers { get; init; }
-    public string? SubProtocol { get; init; }
-    public IDictionary<string, object> UserState { get; init; }
-}
-```
-
-### 3. WebSocketConnectRequest
-
-Represents the upgrade request for matching purposes:
-
-```csharp
-public class WebSocketConnectRequest
-{
-    public string Path { get; init; }
-    public IDictionary<string, string[]> Headers { get; init; }
-    public IList<string> SubProtocols { get; init; }
-    public string? RemoteAddress { get; init; }
-    public string? LocalAddress { get; init; }
-}
-```
-
-### 4. WebSocketRequestMatcher
-
-Detects and matches WebSocket upgrade requests:
-
-- Checks for `Upgrade: websocket` header
-- Checks for `Connection: Upgrade` header
-- Matches paths using configured matchers
-- Validates subprotocols
-- Supports custom predicates
-
-### 5. WebSocketResponseProvider
-
-Manages WebSocket connections:
-
-- Handles raw WebSocket connections
-- Supports message-based routing
-- Provides default echo behavior
-- Manages keep-alive heartbeats
-- Handles connection timeouts
-- Properly closes connections
-
-## Usage Examples
-
-### Basic Echo Server
-
-```csharp
-var server = WireMockServer.Start();
-
-server
-    .Given(Request.Create()
-        .WithPath("/echo")
-    )
-    .RespondWith(Response.Create()
-        .WithWebSocketHandler(async ctx =>
-        {
-            var buffer = new byte[1024 * 4];
-            var result = await ctx.WebSocket.ReceiveAsync(
-                new ArraySegment<byte>(buffer),
-                CancellationToken.None);
-
-            await ctx.WebSocket.SendAsync(
-                new ArraySegment<byte>(buffer, 0, result.Count),
-                result.MessageType,
-                result.EndOfMessage,
-                CancellationToken.None);
-        })
-    );
-```
-
-### Message-Based Routing
-
-```csharp
-server
-    .Given(Request.Create()
-        .WithPath("/api/ws")
-    )
-    .RespondWith(Response.Create()
-        .WithWebSocketMessageHandler(async msg =>
-        {
-            return msg.Type switch
-            {
-                "subscribe" => new WebSocketMessage { Type = "subscribed" },
-                "ping" => new WebSocketMessage { Type = "pong" },
-                _ => null
-            };
-        })
-    );
-```
-
-### Authenticated WebSocket
-
-```csharp
-server
-    .Given(Request.Create()
-        .WithPath("/secure-ws")
-        .WithHeader("Authorization", "Bearer token123")
-    )
-    .RespondWith(Response.Create()
-        .WithWebSocketHandler(async ctx =>
-        {
-            // Only authenticated connections reach here
-            await SendWelcomeAsync(ctx.WebSocket);
-        })
-    );
-```
-
-## Testing
-
-Created comprehensive test suite in `test/WireMock.Net.Tests/WebSockets/WebSocketTests.cs`:
-
-- Echo handler functionality
-- Message handler configuration
-- Keep-alive interval storage
-- Timeout configuration
-- IsConfigured property validation
-- Path matching validation
-- Subprotocol matching validation
-
-## Next Steps for Middleware Integration
-
-To fully enable WebSocket support, the following middleware changes are needed:
-
-### 1. Update `WireMock.Net.AspNetCore.Middleware`
-
-Add WebSocket middleware handler:
-
-```csharp
-if (context.WebSockets.IsWebSocketRequest)
-{
-    var requestMatcher = mapping.RequestMatcher;
-    
-    // Check if this is a WebSocket request
-    if (requestMatcher.Match(requestMessage).IsPerfectMatch)
-    {
-        // Accept WebSocket
-        var webSocket = await context.WebSockets.AcceptWebSocketAsync();
-        
-        // Get the response provider
-        var provider = mapping.Provider;
-        
-        if (provider is WebSocketResponseProvider wsProvider)
-        {
-            await wsProvider.HandleWebSocketAsync(webSocket, requestMessage);
-        }
-    }
-}
-```
-
-### 2. Update Routing
-
-Ensure WebSocket upgrade requests are properly routed through mapping evaluation before being passed to the middleware.
-
-### 3. Configuration
-
-Add WebSocket settings to `WireMockServerSettings`:
-
-```csharp
-public WebSocketOptions? WebSocketOptions { get; set; }
-```
-
-## Features Implemented
-
-✅ Request matching for WebSocket upgrades  
-✅ Path-based routing  
-✅ Subprotocol negotiation support  
-✅ Custom header validation  
-✅ Raw WebSocket handler support  
-✅ Message-based routing support  
-✅ Keep-alive heartbeat configuration  
-✅ Connection timeout configuration  
-✅ Binary and text message support  
-✅ Fluent builder API  
-✅ Comprehensive documentation  
-✅ Unit tests  
-
-## Features Not Yet Implemented
-
-⏳ Middleware integration (requires AspNetCore.Middleware updates)  
-⏳ Admin API support  
-⏳ Response message transformers  
-⏳ Proxy mode for WebSockets  
-⏳ Compression support (RFC 7692)  
-⏳ Connection lifecycle events (OnConnect, OnClose, OnError)  
-
-## Compatibility
-
-- **.NET Framework**: Not supported (WebSockets API not available)
-- **.NET Standard 1.3, 2.0, 2.1**: Supported (no actual WebSocket server)
-- **.NET Core 3.1+**: Fully supported
-- **.NET 5.0+**: Fully supported
-
-## Architecture Decisions
-
-1. **Separate Project** - Created `WireMock.Net.WebSockets` to keep concerns separated while maintaining discoverability
-2. **Fluent API** - Followed WireMock.Net's existing fluent builder pattern for consistency
-3. **Properties-Based** - Used properties in Response class to store configuration, allowing for extensibility
-4. **Matcher-Based** - Created dedicated matcher to integrate with existing request matching infrastructure
-5. **Async/Await** - All handlers are async to support long-lived connections and concurrent requests
-
-## Code Quality
-
-- Follows WireMock.Net coding standards
-- Includes XML documentation comments
-- Uses nullable reference types (`#nullable enable`)
-- Implements proper error handling
-- No external dependencies beyond existing WireMock.Net packages
-- Comprehensive unit test coverage
-
-## File Locations
-
-| File | Purpose |
-|------|---------|
-| `src/WireMock.Net.WebSockets/WireMock.Net.WebSockets.csproj` | Project file |
-| `src/WireMock.Net.WebSockets/Models/*.cs` | Data models |
-| `src/WireMock.Net.WebSockets/Matchers/WebSocketRequestMatcher.cs` | Request matching |
-| `src/WireMock.Net.WebSockets/ResponseProviders/WebSocketResponseProvider.cs` | Connection handling |
-| `src/WireMock.Net.WebSockets/RequestBuilders/IWebSocketRequestBuilder.cs` | Request builder interface |
-| `src/WireMock.Net.WebSockets/ResponseBuilders/IWebSocketResponseBuilder.cs` | Response builder interface |
-| `src/WireMock.Net.Minimal/RequestBuilders/Request.WebSocket.cs` | Request builder implementation |
-| `src/WireMock.Net.Minimal/ResponseBuilders/Response.WebSocket.cs` | Response builder implementation |
-| `test/WireMock.Net.Tests/WebSockets/WebSocketTests.cs` | Unit tests |
-| `examples/WireMock.Net.Console.WebSocketExamples/WebSocketExamples.cs` | Usage examples |
-| `src/WireMock.Net.WebSockets/README.md` | User documentation |
-
-## Integration Notes
-
-When integrating with middleware:
-
-1. The `Request.GetWebSocketMatcher()` method returns a `WebSocketRequestMatcher` that should be added to request matchers
-2. The `Response.WebSocketHandler` and `Response.WebSocketMessageHandler` properties contain the configured handlers
-3. The `Response.IsWebSocketConfigured` property indicates if WebSocket is configured
-4. The `WebSocketResponseProvider.HandleWebSocketAsync()` method accepts the WebSocket and request
-5. Always check `context.WebSockets.IsWebSocketRequest` before attempting to accept WebSocket
-
-## Performance Considerations
-
-- Each WebSocket connection maintains a single long-lived task
-- Message processing is sequential per connection (not concurrent)
-- Keep-alive heartbeats prevent timeout of idle connections
-- Connection timeout prevents zombie connections
-- No additional memory overhead for non-WebSocket requests
-

WEBSOCKET_QUICK_REFERENCE.md

@@ -1,262 +0,0 @@
-# WebSocket Implementation - Quick Reference Card
-
-## Installation
-
-```bash
-dotnet add package WireMock.Net
-```
-
-No additional packages needed - WebSocket support is built-in for .NET Core 3.1+
-
-## Minimum Example
-
-```csharp
-var server = WireMockServer.Start();
-
-server.Given(Request.Create().WithPath("/ws"))
-    .RespondWith(Response.Create()
-        .WithWebSocketHandler(async ctx => {
-            // Your handler code
-        }));
-
-// Connect and use
-using var client = new ClientWebSocket();
-await client.ConnectAsync(new Uri($"ws://localhost:{server.Port}/ws"), default);
-```
-
-## Request Matching
-
-```csharp
-Request.Create()
-    .WithPath("/path")                          // Match path
-    .WithWebSocketSubprotocol("chat")           // Match subprotocol
-    .WithHeader("Authorization", "Bearer ...")  // Match headers
-    .WithCustomHandshakeHeaders(                // Custom handshake validation
-        ("X-Custom-Header", "value"))
-```
-
-## Response Configuration
-
-```csharp
-Response.Create()
-    // Handler Options
-    .WithWebSocketHandler(async ctx => {})                    // Full context
-    .WithWebSocketHandler(async ws => {})                     // Just WebSocket
-    .WithWebSocketMessageHandler(async msg => {})             // Message routing
-    .WithWebSocketMessage(new WebSocketMessage { ... })       // Send on connect
-    
-    // Configuration
-    .WithWebSocketKeepAlive(TimeSpan.FromSeconds(30))         // Heartbeat
-    .WithWebSocketTimeout(TimeSpan.FromMinutes(5))            // Timeout
-```
-
-## Handler Patterns
-
-### Echo Handler
-```csharp
-.WithWebSocketHandler(async ctx => {
-    var buffer = new byte[1024 * 4];
-    while (ctx.WebSocket.State == WebSocketState.Open) {
-        var result = await ctx.WebSocket.ReceiveAsync(
-            new ArraySegment<byte>(buffer), default);
-        await ctx.WebSocket.SendAsync(
-            new ArraySegment<byte>(buffer, 0, result.Count),
-            result.MessageType, result.EndOfMessage, default);
-    }
-})
-```
-
-### Message Routing
-```csharp
-.WithWebSocketMessageHandler(async msg => msg.Type switch {
-    "ping" => new WebSocketMessage { Type = "pong" },
-    "subscribe" => new WebSocketMessage { Type = "subscribed" },
-    _ => null
-})
-```
-
-### Server Push
-```csharp
-.WithWebSocketHandler(async ctx => {
-    while (ctx.WebSocket.State == WebSocketState.Open) {
-        var data = Encoding.UTF8.GetBytes(DateTime.Now.ToString());
-        await ctx.WebSocket.SendAsync(
-            new ArraySegment<byte>(data),
-            WebSocketMessageType.Text, true, default);
-        await Task.Delay(5000);
-    }
-})
-```
-
-## Handler Context
-
-```csharp
-ctx.WebSocket           // The WebSocket instance
-ctx.RequestMessage      // The HTTP upgrade request
-ctx.Headers            // Request headers as Dictionary
-ctx.SubProtocol        // Negotiated subprotocol (string?)
-ctx.UserState          // Custom state Dictionary<string, object>
-```
-
-## WebSocketMessage
-
-```csharp
-new WebSocketMessage {
-    Type = "message-type",                    // Message type identifier
-    Data = new { ... },                       // Arbitrary data
-    TextData = "...",                         // Text message content
-    RawData = new byte[] { ... },             // Binary data
-    IsBinary = false,                         // Message type indicator
-    Timestamp = DateTime.UtcNow                // Auto-set creation time
-}
-```
-
-## Testing Pattern
-
-```csharp
-[Fact]
-public async Task WebSocket_ShouldWork() {
-    var server = WireMockServer.Start();
-    
-    server.Given(Request.Create().WithPath("/ws"))
-        .RespondWith(Response.Create()
-            .WithWebSocketHandler(async ctx => {
-                // Configure handler
-            }));
-    
-    using var client = new ClientWebSocket();
-    await client.ConnectAsync(
-        new Uri($"ws://localhost:{server.Port}/ws"), default);
-    
-    // Test interactions
-    
-    server.Stop();
-}
-```
-
-## Common Patterns
-
-| Pattern | Code |
-|---------|------|
-| **Path Only** | `.WithPath("/ws")` |
-| **Path + Subprotocol** | `.WithPath("/ws")` + `.WithWebSocketSubprotocol("chat")` |
-| **With Authentication** | `.WithHeader("Authorization", "Bearer token")` |
-| **Echo Back** | See Echo Handler above |
-| **Route by Type** | See Message Routing above |
-| **Send on Connect** | `.WithWebSocketMessage(msg)` |
-| **Keep Alive** | `.WithWebSocketKeepAlive(TimeSpan.FromSeconds(30))` |
-| **Long Timeout** | `.WithWebSocketTimeout(TimeSpan.FromHours(1))` |
-
-## Async Utilities
-
-```csharp
-// Send Text
-await ws.SendAsync(
-    new ArraySegment<byte>(Encoding.UTF8.GetBytes(text)),
-    WebSocketMessageType.Text, true, default);
-
-// Send Binary
-await ws.SendAsync(
-    new ArraySegment<byte>(bytes),
-    WebSocketMessageType.Binary, true, default);
-
-// Receive
-var buffer = new byte[1024];
-var result = await ws.ReceiveAsync(
-    new ArraySegment<byte>(buffer), default);
-
-// Close
-await ws.CloseAsync(
-    WebSocketCloseStatus.NormalClosure, "Done", default);
-```
-
-## Properties Available
-
-```csharp
-var response = Response.Create();
-response.WebSocketHandler              // Func<WebSocketHandlerContext, Task>
-response.WebSocketMessageHandler        // Func<WebSocketMessage, Task<WebSocketMessage?>>
-response.WebSocketKeepAliveInterval     // TimeSpan?
-response.WebSocketTimeout               // TimeSpan?
-response.IsWebSocketConfigured          // bool
-```
-
-## Error Handling
-
-```csharp
-try {
-    // WebSocket operations
-} catch (WebSocketException ex) {
-    // Handle WebSocket errors
-} catch (OperationCanceledException) {
-    // Handle timeout
-} finally {
-    if (ws.State != WebSocketState.Closed) {
-        await ws.CloseAsync(
-            WebSocketCloseStatus.InternalServerError,
-            "Error", default);
-    }
-}
-```
-
-## Frequently Used Namespaces
-
-```csharp
-using System.Net.WebSockets;              // WebSocket, WebSocketState, etc.
-using System.Text;                        // Encoding
-using System.Threading;                   // CancellationToken
-using System.Threading.Tasks;             // Task
-using WireMock.RequestBuilders;          // Request
-using WireMock.ResponseBuilders;         // Response
-using WireMock.Server;                   // WireMockServer
-using WireMock.WebSockets;               // WebSocketMessage, etc.
-```
-
-## Version Support
-
-| Platform | Support |
-|----------|---------|
-| .NET Core 3.1 | ✅ Full |
-| .NET 5.0 | ✅ Full |
-| .NET 6.0 | ✅ Full |
-| .NET 7.0 | ✅ Full |
-| .NET 8.0 | ✅ Full |
-| .NET Framework | ❌ Not supported |
-| .NET Standard | ⏳ Framework refs only |
-
-## Troubleshooting Checklist
-
-- [ ] Server started before connecting?
-- [ ] Correct URL path? (ws:// not ws)
-- [ ] Handler set with WithWebSocketHandler()?
-- [ ] Closing connections properly?
-- [ ] CancellationToken passed to async methods?
-- [ ] Keep-alive interval < client timeout?
-- [ ] Error handling in handler?
-- [ ] Tests using IAsyncLifetime?
-
-## Performance Tips
-
-✅ Close WebSockets when done  
-✅ Set appropriate timeouts  
-✅ Use keep-alive for idle connections  
-✅ Handle exceptions gracefully  
-✅ Don't block in handlers (await, don't Task.Result)  
-
-## Limits & Constraints
-
-- ⚠️ .NET Core 3.1+  only
-- ⚠️ HTTPS (WSS) needs certificate setup
-- ⚠️ Sequential message processing per connection
-- ⚠️ Default buffer size: 1024 * 4 bytes
-
-## Links
-
-- [WebSocket RFC 6455](https://tools.ietf.org/html/rfc6455)
-- [System.Net.WebSockets Docs](https://docs.microsoft.com/en-us/dotnet/api/system.net.websockets)
-- [WireMock.Net GitHub](https://github.com/WireMock-Net/WireMock.Net)
-- [WireMock.Net Issues](https://github.com/WireMock-Net/WireMock.Net/issues)
-
----
-
-**For detailed documentation, see**: `WEBSOCKET_GETTING_STARTED.md` or `src/WireMock.Net.WebSockets/README.md`

WEBSOCKET_STRING_EXTENSION.md

@@ -1,79 +0,0 @@
-# String Extension for .NET 4.6.1 Compatibility
-
-## Problem
-
-The `Contains(string, StringComparison)` method was added in .NET 5.0. For .NET Framework 4.6.1 and .NET Standard 2.1 targets, this method is not available.
-
-## Solution
-
-Created `StringExtensions.cs` with a `ContainsIgnoreCase` extension method that provides a compatibility shim.
-
-### Implementation Details
-
-**File Location**: `src/WireMock.Net.WebSockets/StringExtensions/StringExtensions.cs`
-
-**Namespace**: `WireMock.WebSockets`
-
-```csharp
-internal static class StringExtensions
-{
-#if NET5_0_OR_GREATER
-    // Uses native .NET 5+ Contains method
-    internal static bool ContainsIgnoreCase(this string value, string substring, StringComparison comparisonType)
-    {
-        return value.Contains(substring, comparisonType);
-    }
-#else
-    // For .NET Framework 4.6.1 and .NET Standard 2.1
-    // Uses IndexOf with StringComparison for compatibility
-    internal static bool ContainsIgnoreCase(this string value, string substring, StringComparison comparisonType)
-    {
-        // Implementation using IndexOf
-        return value.IndexOf(substring, comparisonType) >= 0;
-    }
-#endif
-}
-```
-
-### Usage in WebSocketRequestMatcher
-
-```csharp
-// Before: Not available in .NET 4.6.1
-v.Contains("Upgrade", StringComparison.OrdinalIgnoreCase)
-
-// After: Works in all target frameworks
-v.ContainsIgnoreCase("Upgrade", StringComparison.OrdinalIgnoreCase)
-```
-
-### Target Frameworks Supported
-
-| Framework | Method Used |
-|-----------|------------|
-| **.NET 5.0+** | Native `Contains(string, StringComparison)` |
-| **.NET Framework 4.6.1** | `IndexOf(string, StringComparison) >= 0` compat shim |
-| **.NET Standard 2.1** | `IndexOf(string, StringComparison) >= 0` compat shim |
-| **.NET 6.0+** | Native `Contains(string, StringComparison)` |
-| **.NET 8.0** | Native `Contains(string, StringComparison)` |
-
-### Benefits
-
-✅ **Cross-platform compatibility** - Works across all target frameworks  
-✅ **Performance optimized** - Uses native method on .NET 5.0+  
-✅ **Zero overhead** - Extension method with conditional compilation  
-✅ **Clean API** - Same method name across all frameworks  
-✅ **Proper null handling** - Includes ArgumentNullException checks  
-
-### Conditional Compilation
-
-The extension uses `#if NET5_0_OR_GREATER` to conditionally compile:
-- For .NET 5.0+: Delegates directly to the native `Contains` method
-- For .NET 4.6.1 and .NET Standard 2.1: Uses `IndexOf` for equivalent functionality
-
-This ensures maximum performance on newer frameworks while maintaining compatibility with older ones.
-
----
-
-**Status**: ✅ Implemented and tested  
-**Compilation**: ✅ No errors  
-**All frameworks**: ✅ Supported
-

WEBSOCKET_SUMMARY.md

@@ -1,316 +0,0 @@
-# WebSocket Implementation for WireMock.Net - Executive Summary
-
-## 🎯 Objective Completed
-
-Successfully implemented comprehensive WebSocket mocking support for WireMock.Net using the existing fluent builder pattern and architecture.
-
-## ✅ What Was Built
-
-### 1. **New WireMock.Net.WebSockets Package**
-   - Dedicated project for WebSocket functionality
-   - Targets .NET Standard 2.0, 2.1, and .NET Core 3.1+
-   - Zero external dependencies (uses framework built-ins)
-   - ~1,500 lines of production code
-
-### 2. **Core Models & Types**
-   - `WebSocketMessage` - Represents text/binary messages
-   - `WebSocketHandlerContext` - Full connection context
-   - `WebSocketConnectRequest` - Upgrade request details
-
-### 3. **Request Matching**
-   - `WebSocketRequestMatcher` - Detects and validates WebSocket upgrades
-   - Matches upgrade headers, paths, subprotocols
-   - Supports custom predicates
-
-### 4. **Response Handling**
-   - `WebSocketResponseProvider` - Manages WebSocket connections
-   - Handles raw WebSocket connections
-   - Supports message-based routing
-   - Implements keep-alive and timeouts
-
-### 5. **Fluent Builder API**
-   - `IWebSocketRequestBuilder` interface with:
-     - `WithWebSocketPath(path)`
-     - `WithWebSocketSubprotocol(protocols...)`
-     - `WithCustomHandshakeHeaders(headers...)`
-   
-   - `IWebSocketResponseBuilder` interface with:
-     - `WithWebSocketHandler(handler)`
-     - `WithWebSocketMessageHandler(handler)`
-     - `WithWebSocketKeepAlive(interval)`
-     - `WithWebSocketTimeout(duration)`
-     - `WithWebSocketMessage(message)`
-
-### 6. **Integration with Existing Classes**
-   - Extended `Request` class with WebSocket capabilities
-   - Extended `Response` class with WebSocket capabilities
-   - No breaking changes to existing API
-
-## 📊 Implementation Statistics
-
-| Metric | Value |
-|--------|-------|
-| Files Created | 13 |
-| Files Modified | 2 |
-| Lines of Code | 1,500+ |
-| Test Cases | 11 |
-| Code Examples | 5 |
-| Documentation Pages | 4 |
-| Target Frameworks | 7 |
-| External Dependencies | 0 |
-
-## 🎨 Design Highlights
-
-### **Fluent API Consistency**
-Follows the exact same builder pattern as existing HTTP/Response builders:
-
-```csharp
-server
-    .Given(Request.Create().WithPath("/ws"))
-    .RespondWith(Response.Create().WithWebSocketHandler(...))
-```
-
-### **Flexible Handler Options**
-Three ways to handle WebSocket connections:
-
-1. **Full Context Handler**
-   ```csharp
-   WithWebSocketHandler(Func<WebSocketHandlerContext, Task>)
-   ```
-
-2. **Simple WebSocket Handler**
-   ```csharp
-   WithWebSocketHandler(Func<WebSocket, Task>)
-   ```
-
-3. **Message-Based Routing**
-   ```csharp
-   WithWebSocketMessageHandler(Func<WebSocketMessage, Task<WebSocketMessage?>>)
-   ```
-
-### **Composable Configuration**
-```csharp
-Response.Create()
-    .WithWebSocketHandler(...)
-    .WithWebSocketKeepAlive(TimeSpan.FromSeconds(30))
-    .WithWebSocketTimeout(TimeSpan.FromMinutes(5))
-```
-
-## 📁 Project Structure
-
-```
-WireMock.Net (ws2 branch)
-├── src/
-│   ├── WireMock.Net/
-│   │   └── WireMock.Net.csproj (modified - added WebSocket reference)
-│   ├── WireMock.Net.Minimal/
-│   │   ├── RequestBuilders/
-│   │   │   └── Request.WebSocket.cs (new)
-│   │   ├── ResponseBuilders/
-│   │   │   └── Response.WebSocket.cs (new)
-│   │   └── WireMock.Net.Minimal.csproj (modified - added WebSocket reference)
-│   └── WireMock.Net.WebSockets/ (NEW PROJECT)
-│       ├── GlobalUsings.cs
-│       ├── README.md
-│       ├── Models/
-│       │   ├── WebSocketMessage.cs
-│       │   ├── WebSocketHandlerContext.cs
-│       │   └── WebSocketConnectRequest.cs
-│       ├── Matchers/
-│       │   └── WebSocketRequestMatcher.cs
-│       ├── ResponseProviders/
-│       │   └── WebSocketResponseProvider.cs
-│       ├── RequestBuilders/
-│       │   └── IWebSocketRequestBuilder.cs
-│       └── ResponseBuilders/
-│           └── IWebSocketResponseBuilder.cs
-├── test/
-│   └── WireMock.Net.Tests/
-│       └── WebSockets/
-│           └── WebSocketTests.cs (new)
-├── examples/
-│   └── WireMock.Net.Console.WebSocketExamples/
-│       └── WebSocketExamples.cs (new)
-└── [Documentation Files]
-    ├── WEBSOCKET_IMPLEMENTATION.md
-    ├── WEBSOCKET_GETTING_STARTED.md
-    └── WEBSOCKET_FILES_MANIFEST.md
-```
-
-## 🔧 Usage Examples
-
-### Echo Server
-```csharp
-server
-    .Given(Request.Create().WithPath("/echo"))
-    .RespondWith(Response.Create()
-        .WithWebSocketHandler(async ctx => {
-            var buffer = new byte[1024 * 4];
-            var result = await ctx.WebSocket.ReceiveAsync(
-                new ArraySegment<byte>(buffer),
-                CancellationToken.None);
-            await ctx.WebSocket.SendAsync(
-                new ArraySegment<byte>(buffer, 0, result.Count),
-                result.MessageType, result.EndOfMessage,
-                CancellationToken.None);
-        }));
-```
-
-### Message Routing
-```csharp
-.WithWebSocketMessageHandler(async msg => msg.Type switch {
-    "subscribe" => new WebSocketMessage { Type = "subscribed" },
-    "ping" => new WebSocketMessage { Type = "pong" },
-    _ => null
-})
-```
-
-### Server Notifications
-```csharp
-.WithWebSocketHandler(async ctx => {
-    while (ctx.WebSocket.State == WebSocketState.Open) {
-        var notification = Encoding.UTF8.GetBytes("{\"event\":\"update\"}");
-        await ctx.WebSocket.SendAsync(
-            new ArraySegment<byte>(notification),
-            WebSocketMessageType.Text, true,
-            CancellationToken.None);
-        await Task.Delay(5000);
-    }
-})
-.WithWebSocketKeepAlive(TimeSpan.FromSeconds(30))
-```
-
-## ✨ Key Features
-
-✅ **Path Matching** - Route based on WebSocket URL path  
-✅ **Subprotocol Negotiation** - Match WebSocket subprotocols  
-✅ **Header Validation** - Validate custom headers during handshake  
-✅ **Message Routing** - Route based on message type/content  
-✅ **Binary Support** - Handle both text and binary frames  
-✅ **Keep-Alive** - Configurable heartbeat intervals  
-✅ **Timeouts** - Prevent zombie connections  
-✅ **Async/Await** - Full async support  
-✅ **Connection Context** - Access to headers, state, subprotocols  
-✅ **Graceful Shutdown** - Proper connection cleanup  
-
-## 🧪 Testing
-
-- **11 Unit Tests** covering:
-  - Echo handler functionality
-  - Handler configuration storage
-  - Keep-alive and timeout settings
-  - Property validation
-  - Configuration detection
-  - Request matching
-  - Subprotocol matching
-
-- **5 Integration Examples** showing:
-  - Echo server
-  - Server-initiated messages
-  - Message routing
-  - Authenticated WebSocket
-  - Data streaming
-
-## 📚 Documentation
-
-1. **WEBSOCKET_IMPLEMENTATION.md** (500+ lines)
-   - Technical architecture
-   - Component descriptions
-   - Implementation decisions
-   - Integration guidelines
-
-2. **WEBSOCKET_GETTING_STARTED.md** (400+ lines)
-   - Quick start guide
-   - Common patterns
-   - API reference
-   - Troubleshooting guide
-   - Performance tips
-
-3. **src/WireMock.Net.WebSockets/README.md** (400+ lines)
-   - Feature overview
-   - Installation instructions
-   - Comprehensive API documentation
-   - Advanced usage examples
-   - Limitations and notes
-
-4. **WEBSOCKET_FILES_MANIFEST.md** (300+ lines)
-   - Complete file listing
-   - Code statistics
-   - Build configuration
-   - Support matrix
-
-## 🚀 Ready for Production
-
-### ✅ Code Quality
-- No compiler warnings
-- No external dependencies
-- Follows WireMock.Net standards
-- Full nullable reference type support
-- Comprehensive error handling
-- Proper validation on inputs
-
-### ✅ Compatibility
-- Supports .NET Core 3.1+
-- Supports .NET 5.0+
-- Supports .NET 6.0+
-- Supports .NET 7.0+
-- Supports .NET 8.0+
-- .NET Standard 2.0/2.1 (framework reference)
-
-### ✅ Architecture
-- Non-breaking addition
-- Extensible design
-- Follows existing patterns
-- Minimal surface area
-- Proper separation of concerns
-
-## 📈 Next Steps
-
-The implementation is **complete and tested**. Next phase would be:
-
-1. **Middleware Integration** - Hook into ASP.NET Core WebSocket pipeline
-2. **Admin API** - Add REST endpoints for WebSocket mapping management
-3. **Response Factory** - Create providers automatically based on configuration
-4. **Route Handlers** - Process WebSocket upgrades in middleware stack
-
-## 💡 Design Decisions
-
-| Decision | Rationale |
-|----------|-----------|
-| Separate Project | Better organization, cleaner dependencies |
-| Fluent API | Consistent with existing WireMock.Net patterns |
-| Property-Based | Easy extensibility without breaking changes |
-| No Dependencies | Keeps package lightweight and maintainable |
-| .NET Core 3.1+ | WebSocket support availability |
-| Generic Handlers | Supports multiple use case patterns |
-
-## 🎓 Learning Resources
-
-The implementation serves as a great example of:
-- Building fluent APIs in C#
-- WebSocket programming patterns
-- Integration with existing architectures
-- Test-driven development
-- Request/response matchers
-- Async/await best practices
-
-## 📝 Summary
-
-A complete, production-ready WebSocket implementation has been added to WireMock.Net featuring:
-- Clean fluent API matching existing patterns
-- Multiple handler options for different use cases
-- Full async support
-- Comprehensive testing and documentation
-- Zero breaking changes
-- Extensible architecture ready for middleware integration
-
-The implementation is on the `ws2` branch and ready for code review, testing, and integration into the main codebase.
-
----
-
-**Status**: ✅ Complete  
-**Branch**: `ws2`  
-**Target Merge**: Main branch (after review)  
-**Documentation**: Comprehensive  
-**Tests**: Passing  
-**Build**: No errors or warnings

WireMock.Net Solution.sln

@@ -68,14 +68,10 @@ Project("{9A19103F-16F7-4668-BE54-9A1E7A4F7556}") = "WireMock.Org.RestClient", "
 EndProject
 Project("{9A19103F-16F7-4668-BE54-9A1E7A4F7556}") = "WireMock.Org.Abstractions", "src\WireMock.Org.Abstractions\WireMock.Org.Abstractions.csproj", "{3BA5109E-5F30-4CC2-B699-02EC82560AA6}"
 EndProject
-Project("{9A19103F-16F7-4668-BE54-9A1E7A4F7556}") = "WireMock.Net.WebApplication.NET6", "examples\WireMock.Net.WebApplication.NET6\WireMock.Net.WebApplication.NET6.csproj", "{3F7AA023-6833-4856-A08A-4B5717B592B8}"
-EndProject
 Project("{9A19103F-16F7-4668-BE54-9A1E7A4F7556}") = "WireMock.Net.Console.Proxy.NETCoreApp", "examples\WireMock.Net.Console.Proxy.NETCoreApp\WireMock.Net.Console.Proxy.NETCoreApp.csproj", "{670C7562-C154-442E-A249-7D26849BCD13}"
 EndProject
 Project("{9A19103F-16F7-4668-BE54-9A1E7A4F7556}") = "WireMock.Net.xUnit", "src\WireMock.Net.xUnit\WireMock.Net.xUnit.csproj", "{0DE0954F-8C00-4E8D-B94A-4361FC1CBE44}"
 EndProject
-Project("{9A19103F-16F7-4668-BE54-9A1E7A4F7556}") = "WireMock.Net.Console.NET6.WithCertificate", "examples\WireMock.Net.Console.NET6.WithCertificate\WireMock.Net.Console.NET6.WithCertificate.csproj", "{7C2A9DE8-C89F-4841-9058-6B9BF81E5E34}"
-EndProject
 Project("{9A19103F-16F7-4668-BE54-9A1E7A4F7556}") = "WireMockAzureQueueExample", "examples\WireMockAzureQueueExample\WireMockAzureQueueExample.csproj", "{BAA9EC2A-874B-45CE-8E51-A73622DC7F3D}"
 EndProject
 Project("{9A19103F-16F7-4668-BE54-9A1E7A4F7556}") = "WireMock.Net.Testcontainers", "src\WireMock.Net.Testcontainers\WireMock.Net.Testcontainers.csproj", "{12B016A5-9D8B-4EFE-96C2-CA51BE43367D}"
@@ -154,7 +150,11 @@ Project("{FAE04EC0-301F-11D3-BF4B-00C04F79EFBC}") = "WireMock.Net.OpenTelemetryD
 EndProject
 Project("{FAE04EC0-301F-11D3-BF4B-00C04F79EFBC}") = "WireMock.Net.Console.MimePart", "examples\WireMock.Net.Console.MimePart\WireMock.Net.Console.MimePart.csproj", "{4005E20C-D42B-138A-79BE-B3F5420C563F}"
 EndProject
-Project("{FAE04EC0-301F-11D3-BF4B-00C04F79EFBC}") = "WireMock.Net.WebSockets", "src\WireMock.Net.WebSockets\WireMock.Net.WebSockets.csproj", "{F7D4E5C2-3A1B-4D8E-A2F0-8C6D9E2F1B3A}"
+Project("{FAE04EC0-301F-11D3-BF4B-00C04F79EFBC}") = "WireMock.Net.Console.NET8.WithCertificate", "examples\WireMock.Net.Console.NET8.WithCertificate\WireMock.Net.Console.NET8.WithCertificate.csproj", "{2D86546D-8A24-0A55-C962-2071BD299E05}"
+EndProject
+Project("{FAE04EC0-301F-11D3-BF4B-00C04F79EFBC}") = "WireMock.Net.WebApplication.IIS", "examples\WireMock.Net.WebApplication.IIS\WireMock.Net.WebApplication.IIS.csproj", "{5E6E9FA7-9135-7B82-2CCD-8CA87AC8043C}"
+EndProject
+Project("{FAE04EC0-301F-11D3-BF4B-00C04F79EFBC}") = "WireMock.Net.WebSocketExamples", "examples\WireMock.Net.WebSocketExamples\WireMock.Net.WebSocketExamples.csproj", "{2CE8E3A6-59CC-FE9C-9399-AD54E1FA862B}"
 EndProject
 Global
 	GlobalSection(SolutionConfigurationPlatforms) = preSolution
@@ -334,18 +334,6 @@ Global
 		{3BA5109E-5F30-4CC2-B699-02EC82560AA6}.Release|x64.Build.0 = Release|Any CPU
 		{3BA5109E-5F30-4CC2-B699-02EC82560AA6}.Release|x86.ActiveCfg = Release|Any CPU
 		{3BA5109E-5F30-4CC2-B699-02EC82560AA6}.Release|x86.Build.0 = Release|Any CPU
-		{3F7AA023-6833-4856-A08A-4B5717B592B8}.Debug|Any CPU.ActiveCfg = Debug|Any CPU
-		{3F7AA023-6833-4856-A08A-4B5717B592B8}.Debug|Any CPU.Build.0 = Debug|Any CPU
-		{3F7AA023-6833-4856-A08A-4B5717B592B8}.Debug|x64.ActiveCfg = Debug|Any CPU
-		{3F7AA023-6833-4856-A08A-4B5717B592B8}.Debug|x64.Build.0 = Debug|Any CPU
-		{3F7AA023-6833-4856-A08A-4B5717B592B8}.Debug|x86.ActiveCfg = Debug|Any CPU
-		{3F7AA023-6833-4856-A08A-4B5717B592B8}.Debug|x86.Build.0 = Debug|Any CPU
-		{3F7AA023-6833-4856-A08A-4B5717B592B8}.Release|Any CPU.ActiveCfg = Release|Any CPU
-		{3F7AA023-6833-4856-A08A-4B5717B592B8}.Release|Any CPU.Build.0 = Release|Any CPU
-		{3F7AA023-6833-4856-A08A-4B5717B592B8}.Release|x64.ActiveCfg = Release|Any CPU
-		{3F7AA023-6833-4856-A08A-4B5717B592B8}.Release|x64.Build.0 = Release|Any CPU
-		{3F7AA023-6833-4856-A08A-4B5717B592B8}.Release|x86.ActiveCfg = Release|Any CPU
-		{3F7AA023-6833-4856-A08A-4B5717B592B8}.Release|x86.Build.0 = Release|Any CPU
 		{670C7562-C154-442E-A249-7D26849BCD13}.Debug|Any CPU.ActiveCfg = Debug|Any CPU
 		{670C7562-C154-442E-A249-7D26849BCD13}.Debug|Any CPU.Build.0 = Debug|Any CPU
 		{670C7562-C154-442E-A249-7D26849BCD13}.Debug|x64.ActiveCfg = Debug|Any CPU
@@ -370,18 +358,6 @@ Global
 		{0DE0954F-8C00-4E8D-B94A-4361FC1CBE44}.Release|x64.Build.0 = Release|Any CPU
 		{0DE0954F-8C00-4E8D-B94A-4361FC1CBE44}.Release|x86.ActiveCfg = Release|Any CPU
 		{0DE0954F-8C00-4E8D-B94A-4361FC1CBE44}.Release|x86.Build.0 = Release|Any CPU
-		{7C2A9DE8-C89F-4841-9058-6B9BF81E5E34}.Debug|Any CPU.ActiveCfg = Debug|Any CPU
-		{7C2A9DE8-C89F-4841-9058-6B9BF81E5E34}.Debug|Any CPU.Build.0 = Debug|Any CPU
-		{7C2A9DE8-C89F-4841-9058-6B9BF81E5E34}.Debug|x64.ActiveCfg = Debug|Any CPU
-		{7C2A9DE8-C89F-4841-9058-6B9BF81E5E34}.Debug|x64.Build.0 = Debug|Any CPU
-		{7C2A9DE8-C89F-4841-9058-6B9BF81E5E34}.Debug|x86.ActiveCfg = Debug|Any CPU
-		{7C2A9DE8-C89F-4841-9058-6B9BF81E5E34}.Debug|x86.Build.0 = Debug|Any CPU
-		{7C2A9DE8-C89F-4841-9058-6B9BF81E5E34}.Release|Any CPU.ActiveCfg = Release|Any CPU
-		{7C2A9DE8-C89F-4841-9058-6B9BF81E5E34}.Release|Any CPU.Build.0 = Release|Any CPU
-		{7C2A9DE8-C89F-4841-9058-6B9BF81E5E34}.Release|x64.ActiveCfg = Release|Any CPU
-		{7C2A9DE8-C89F-4841-9058-6B9BF81E5E34}.Release|x64.Build.0 = Release|Any CPU
-		{7C2A9DE8-C89F-4841-9058-6B9BF81E5E34}.Release|x86.ActiveCfg = Release|Any CPU
-		{7C2A9DE8-C89F-4841-9058-6B9BF81E5E34}.Release|x86.Build.0 = Release|Any CPU
 		{BAA9EC2A-874B-45CE-8E51-A73622DC7F3D}.Debug|Any CPU.ActiveCfg = Debug|Any CPU
 		{BAA9EC2A-874B-45CE-8E51-A73622DC7F3D}.Debug|Any CPU.Build.0 = Debug|Any CPU
 		{BAA9EC2A-874B-45CE-8E51-A73622DC7F3D}.Debug|x64.ActiveCfg = Debug|Any CPU
@@ -826,18 +802,42 @@ Global
 		{4005E20C-D42B-138A-79BE-B3F5420C563F}.Release|x64.Build.0 = Release|Any CPU
 		{4005E20C-D42B-138A-79BE-B3F5420C563F}.Release|x86.ActiveCfg = Release|Any CPU
 		{4005E20C-D42B-138A-79BE-B3F5420C563F}.Release|x86.Build.0 = Release|Any CPU
-		{F7D4E5C2-3A1B-4D8E-A2F0-8C6D9E2F1B3A}.Debug|Any CPU.ActiveCfg = Debug|Any CPU
-		{F7D4E5C2-3A1B-4D8E-A2F0-8C6D9E2F1B3A}.Debug|Any CPU.Build.0 = Debug|Any CPU
-		{F7D4E5C2-3A1B-4D8E-A2F0-8C6D9E2F1B3A}.Debug|x64.ActiveCfg = Debug|Any CPU
-		{F7D4E5C2-3A1B-4D8E-A2F0-8C6D9E2F1B3A}.Debug|x64.Build.0 = Debug|Any CPU
-		{F7D4E5C2-3A1B-4D8E-A2F0-8C6D9E2F1B3A}.Debug|x86.ActiveCfg = Debug|Any CPU
-		{F7D4E5C2-3A1B-4D8E-A2F0-8C6D9E2F1B3A}.Debug|x86.Build.0 = Debug|Any CPU
-		{F7D4E5C2-3A1B-4D8E-A2F0-8C6D9E2F1B3A}.Release|Any CPU.ActiveCfg = Release|Any CPU
-		{F7D4E5C2-3A1B-4D8E-A2F0-8C6D9E2F1B3A}.Release|Any CPU.Build.0 = Release|Any CPU
-		{F7D4E5C2-3A1B-4D8E-A2F0-8C6D9E2F1B3A}.Release|x64.ActiveCfg = Release|Any CPU
-		{F7D4E5C2-3A1B-4D8E-A2F0-8C6D9E2F1B3A}.Release|x64.Build.0 = Release|Any CPU
-		{F7D4E5C2-3A1B-4D8E-A2F0-8C6D9E2F1B3A}.Release|x86.ActiveCfg = Release|Any CPU
-		{F7D4E5C2-3A1B-4D8E-A2F0-8C6D9E2F1B3A}.Release|x86.Build.0 = Release|Any CPU
+		{2D86546D-8A24-0A55-C962-2071BD299E05}.Debug|Any CPU.ActiveCfg = Debug|Any CPU
+		{2D86546D-8A24-0A55-C962-2071BD299E05}.Debug|Any CPU.Build.0 = Debug|Any CPU
+		{2D86546D-8A24-0A55-C962-2071BD299E05}.Debug|x64.ActiveCfg = Debug|Any CPU
+		{2D86546D-8A24-0A55-C962-2071BD299E05}.Debug|x64.Build.0 = Debug|Any CPU
+		{2D86546D-8A24-0A55-C962-2071BD299E05}.Debug|x86.ActiveCfg = Debug|Any CPU
+		{2D86546D-8A24-0A55-C962-2071BD299E05}.Debug|x86.Build.0 = Debug|Any CPU
+		{2D86546D-8A24-0A55-C962-2071BD299E05}.Release|Any CPU.ActiveCfg = Release|Any CPU
+		{2D86546D-8A24-0A55-C962-2071BD299E05}.Release|Any CPU.Build.0 = Release|Any CPU
+		{2D86546D-8A24-0A55-C962-2071BD299E05}.Release|x64.ActiveCfg = Release|Any CPU
+		{2D86546D-8A24-0A55-C962-2071BD299E05}.Release|x64.Build.0 = Release|Any CPU
+		{2D86546D-8A24-0A55-C962-2071BD299E05}.Release|x86.ActiveCfg = Release|Any CPU
+		{2D86546D-8A24-0A55-C962-2071BD299E05}.Release|x86.Build.0 = Release|Any CPU
+		{5E6E9FA7-9135-7B82-2CCD-8CA87AC8043C}.Debug|Any CPU.ActiveCfg = Debug|Any CPU
+		{5E6E9FA7-9135-7B82-2CCD-8CA87AC8043C}.Debug|Any CPU.Build.0 = Debug|Any CPU
+		{5E6E9FA7-9135-7B82-2CCD-8CA87AC8043C}.Debug|x64.ActiveCfg = Debug|Any CPU
+		{5E6E9FA7-9135-7B82-2CCD-8CA87AC8043C}.Debug|x64.Build.0 = Debug|Any CPU
+		{5E6E9FA7-9135-7B82-2CCD-8CA87AC8043C}.Debug|x86.ActiveCfg = Debug|Any CPU
+		{5E6E9FA7-9135-7B82-2CCD-8CA87AC8043C}.Debug|x86.Build.0 = Debug|Any CPU
+		{5E6E9FA7-9135-7B82-2CCD-8CA87AC8043C}.Release|Any CPU.ActiveCfg = Release|Any CPU
+		{5E6E9FA7-9135-7B82-2CCD-8CA87AC8043C}.Release|Any CPU.Build.0 = Release|Any CPU
+		{5E6E9FA7-9135-7B82-2CCD-8CA87AC8043C}.Release|x64.ActiveCfg = Release|Any CPU
+		{5E6E9FA7-9135-7B82-2CCD-8CA87AC8043C}.Release|x64.Build.0 = Release|Any CPU
+		{5E6E9FA7-9135-7B82-2CCD-8CA87AC8043C}.Release|x86.ActiveCfg = Release|Any CPU
+		{5E6E9FA7-9135-7B82-2CCD-8CA87AC8043C}.Release|x86.Build.0 = Release|Any CPU
+		{2CE8E3A6-59CC-FE9C-9399-AD54E1FA862B}.Debug|Any CPU.ActiveCfg = Debug|Any CPU
+		{2CE8E3A6-59CC-FE9C-9399-AD54E1FA862B}.Debug|Any CPU.Build.0 = Debug|Any CPU
+		{2CE8E3A6-59CC-FE9C-9399-AD54E1FA862B}.Debug|x64.ActiveCfg = Debug|Any CPU
+		{2CE8E3A6-59CC-FE9C-9399-AD54E1FA862B}.Debug|x64.Build.0 = Debug|Any CPU
+		{2CE8E3A6-59CC-FE9C-9399-AD54E1FA862B}.Debug|x86.ActiveCfg = Debug|Any CPU
+		{2CE8E3A6-59CC-FE9C-9399-AD54E1FA862B}.Debug|x86.Build.0 = Debug|Any CPU
+		{2CE8E3A6-59CC-FE9C-9399-AD54E1FA862B}.Release|Any CPU.ActiveCfg = Release|Any CPU
+		{2CE8E3A6-59CC-FE9C-9399-AD54E1FA862B}.Release|Any CPU.Build.0 = Release|Any CPU
+		{2CE8E3A6-59CC-FE9C-9399-AD54E1FA862B}.Release|x64.ActiveCfg = Release|Any CPU
+		{2CE8E3A6-59CC-FE9C-9399-AD54E1FA862B}.Release|x64.Build.0 = Release|Any CPU
+		{2CE8E3A6-59CC-FE9C-9399-AD54E1FA862B}.Release|x86.ActiveCfg = Release|Any CPU
+		{2CE8E3A6-59CC-FE9C-9399-AD54E1FA862B}.Release|x86.Build.0 = Release|Any CPU
 	EndGlobalSection
 	GlobalSection(SolutionProperties) = preSolution
 		HideSolutionNode = FALSE
@@ -859,10 +859,8 @@ Global
 		{5B64F6CA-BF6B-4F67-BB2A-9C47E441703E} = {7EFB2C5B-1BB2-4AAF-BC9F-216ED80C594D}
 		{08B29DB1-FEFE-408A-AD0A-6BA6DDC8D70F} = {8F890C6F-9ACC-438D-928A-AD61CDA862F2}
 		{3BA5109E-5F30-4CC2-B699-02EC82560AA6} = {8F890C6F-9ACC-438D-928A-AD61CDA862F2}
-		{3F7AA023-6833-4856-A08A-4B5717B592B8} = {985E0ADB-D4B4-473A-AA40-567E279B7946}
 		{670C7562-C154-442E-A249-7D26849BCD13} = {985E0ADB-D4B4-473A-AA40-567E279B7946}
 		{0DE0954F-8C00-4E8D-B94A-4361FC1CBE44} = {8F890C6F-9ACC-438D-928A-AD61CDA862F2}
-		{7C2A9DE8-C89F-4841-9058-6B9BF81E5E34} = {985E0ADB-D4B4-473A-AA40-567E279B7946}
 		{BAA9EC2A-874B-45CE-8E51-A73622DC7F3D} = {985E0ADB-D4B4-473A-AA40-567E279B7946}
 		{12B016A5-9D8B-4EFE-96C2-CA51BE43367D} = {8F890C6F-9ACC-438D-928A-AD61CDA862F2}
 		{56A38798-C48B-4A4A-B805-071E05C02CE1} = {985E0ADB-D4B4-473A-AA40-567E279B7946}
@@ -900,7 +898,9 @@ Global
 		{C8F4E6D2-9A3B-4F1C-8D5E-7A2B3C4D5E6F} = {8F890C6F-9ACC-438D-928A-AD61CDA862F2}
 		{9957038D-F9C3-CA5D-E8AE-BE188E512635} = {985E0ADB-D4B4-473A-AA40-567E279B7946}
 		{4005E20C-D42B-138A-79BE-B3F5420C563F} = {985E0ADB-D4B4-473A-AA40-567E279B7946}
-		{F7D4E5C2-3A1B-4D8E-A2F0-8C6D9E2F1B3A} = {8F890C6F-9ACC-438D-928A-AD61CDA862F2}
+		{2D86546D-8A24-0A55-C962-2071BD299E05} = {985E0ADB-D4B4-473A-AA40-567E279B7946}
+		{5E6E9FA7-9135-7B82-2CCD-8CA87AC8043C} = {985E0ADB-D4B4-473A-AA40-567E279B7946}
+		{2CE8E3A6-59CC-FE9C-9399-AD54E1FA862B} = {985E0ADB-D4B4-473A-AA40-567E279B7946}
 	EndGlobalSection
 	GlobalSection(ExtensibilityGlobals) = postSolution
 		SolutionGuid = {DC539027-9852-430C-B19F-FD035D018458}

examples/WireMock.Net.Console.NET8/MainApp.cs

@@ -376,9 +376,9 @@ namespace WireMock.Net.ConsoleApplication
                 PreWireMockMiddlewareInit = app => { System.Console.WriteLine($"PreWireMockMiddlewareInit : {app.GetType()}"); },
                 PostWireMockMiddlewareInit = app => { System.Console.WriteLine($"PostWireMockMiddlewareInit : {app.GetType()}"); },
 
-#if USE_ASPNETCORE
+//#if USE_ASPNETCORE
                 AdditionalServiceRegistration = services => { System.Console.WriteLine($"AdditionalServiceRegistration : {services.GetType()}"); },
-#endif
+//#endif
                 Logger = new WireMockConsoleLogger(),
 
                 HandlebarsRegistrationCallback = (handlebarsContext, fileSystemHandler) =>
@@ -399,7 +399,7 @@ namespace WireMock.Net.ConsoleApplication
             //var response = await http.GetAsync($"{_wireMockServer.Url}/pricing");
             //var value = await response.Content.ReadAsStringAsync();
 
-#if PROTOBUF
+//#if PROTOBUF
             var protoBufJsonMatcher = new JsonPartialWildcardMatcher(new { name = "*" });
             server
                 .Given(Request.Create()
@@ -478,9 +478,9 @@ namespace WireMock.Net.ConsoleApplication
                     .WithTrailingHeader("grpc-status", "0")
                     .WithTransformer()
                 );
-#endif
+//#endif
 
-#if GRAPHQL
+//#if GRAPHQL
             var customScalars = new Dictionary<string, Type> { { "MyCustomScalar", typeof(int) } };
             server
                 .Given(Request.Create()
@@ -554,7 +554,7 @@ namespace WireMock.Net.ConsoleApplication
                         }
                         """)
                 );
-#endif
+//#endif
 
             // 400 ms
             server

examples/WireMock.Net.Console.NET8/WireMock.Net.Console.NET8.csproj

@@ -1,34 +1,34 @@
 <Project Sdk="Microsoft.NET.Sdk">
 
-  <PropertyGroup>
-    <OutputType>Exe</OutputType>
-    <TargetFramework>net8.0</TargetFramework>
-      <DefineConstants>$(DefineConstants);GRAPHQL;MIMEKIT;PROTOBUF</DefineConstants>
-  </PropertyGroup>
+    <PropertyGroup>
+        <OutputType>Exe</OutputType>
+        <TargetFramework>net8.0</TargetFramework>
+        <!--<DefineConstants>$(DefineConstants);GRAPHQL;MIMEKIT;PROTOBUF</DefineConstants>-->
+    </PropertyGroup>
 
-  <ItemGroup>
-    <Content Include="__admin\mappings\*.json">
-      <CopyToOutputDirectory>PreserveNewest</CopyToOutputDirectory>
-    </Content>
-  </ItemGroup>
+    <ItemGroup>
+        <Content Include="__admin\mappings\*.json">
+            <CopyToOutputDirectory>PreserveNewest</CopyToOutputDirectory>
+        </Content>
+    </ItemGroup>
 
-  <ItemGroup>
-    <Compile Remove="__admin\mappings\1.cs" />
-  </ItemGroup>
+    <ItemGroup>
+        <Compile Remove="__admin\mappings\1.cs" />
+    </ItemGroup>
 
-  <ItemGroup>
-    <ProjectReference Include="..\..\src\WireMock.Net\WireMock.Net.csproj" />
-    <PackageReference Include="log4net" Version="2.0.15" />
-    <PackageReference Include="Microsoft.Extensions.Configuration" Version="8.0.0" />
-  </ItemGroup>
+    <ItemGroup>
+        <ProjectReference Include="..\..\src\WireMock.Net\WireMock.Net.csproj" />
+        <PackageReference Include="log4net" Version="2.0.15" />
+        <PackageReference Include="Microsoft.Extensions.Configuration" Version="8.0.0" />
+    </ItemGroup>
 
-  <ItemGroup>
-    <None Update="log4net.config">
-      <CopyToOutputDirectory>PreserveNewest</CopyToOutputDirectory>
-    </None>
-    <None Update="nlog.config">
-      <CopyToOutputDirectory>PreserveNewest</CopyToOutputDirectory>
-    </None>
-  </ItemGroup>
+    <ItemGroup>
+        <None Update="log4net.config">
+            <CopyToOutputDirectory>PreserveNewest</CopyToOutputDirectory>
+        </None>
+        <None Update="nlog.config">
+            <CopyToOutputDirectory>PreserveNewest</CopyToOutputDirectory>
+        </None>
+    </ItemGroup>
 
 </Project>

examples/WireMock.Net.Console.Proxy.NETCoreApp/WireMock.Net.Console.Proxy.NETCoreApp.csproj

@@ -2,7 +2,7 @@
 
   <PropertyGroup>
     <OutputType>Exe</OutputType>
-    <TargetFramework>net6.0</TargetFramework>
+    <TargetFramework>net8.0</TargetFramework>
     <ApplicationIcon>../../resources/WireMock.Net-Logo.ico</ApplicationIcon>
   </PropertyGroup>
 

examples/WireMock.Net.Console.WebSocketExamples/WebSocketExamples.cs

@@ -1,274 +0,0 @@
-// Copyright © WireMock.Net
-
-using System;
-using System.Net.WebSockets;
-using System.Text;
-using System.Threading;
-using System.Threading.Tasks;
-using WireMock.RequestBuilders;
-using WireMock.ResponseBuilders;
-using WireMock.Server;
-
-namespace WireMock.Net.Examples.WebSockets;
-
-/// <summary>
-/// Examples of using WebSocket support in WireMock.Net
-/// </summary>
-public static class WebSocketExamples
-{
-    /// <summary>
-    /// Example 1: Simple echo WebSocket server
-    /// </summary>
-    public static async Task EchoWebSocketExampleAsync()
-    {
-        var server = WireMockServer.Start();
-
-        // Set up a WebSocket that echoes messages back
-        server
-            .Given(Request.Create()
-                .WithPath("/echo")
-            )
-            .RespondWith(Response.Create()
-                .WithWebSocketHandler(async ctx =>
-                {
-                    using var webSocket = ctx.WebSocket;
-                    var buffer = new byte[1024 * 4];
-
-                    while (webSocket.State == WebSocketState.Open)
-                    {
-                        var result = await webSocket.ReceiveAsync(
-                            new ArraySegment<byte>(buffer),
-                            CancellationToken.None);
-
-                        if (result.MessageType == WebSocketMessageType.Close)
-                        {
-                            await webSocket.CloseAsync(
-                                WebSocketCloseStatus.NormalClosure,
-                                "Closing",
-                                CancellationToken.None);
-                        }
-                        else
-                        {
-                            await webSocket.SendAsync(
-                                new ArraySegment<byte>(buffer, 0, result.Count),
-                                result.MessageType,
-                                result.EndOfMessage,
-                                CancellationToken.None);
-                        }
-                    }
-                })
-            );
-
-        // Connect and test
-        using var client = new ClientWebSocket();
-        await client.ConnectAsync(new Uri($"ws://localhost:{server.Port}/echo"), CancellationToken.None);
-
-        var message = Encoding.UTF8.GetBytes("Hello WebSocket!");
-        await client.SendAsync(
-            new ArraySegment<byte>(message),
-            WebSocketMessageType.Text,
-            true,
-            CancellationToken.None);
-
-        var buffer = new byte[1024 * 4];
-        var result = await client.ReceiveAsync(
-            new ArraySegment<byte>(buffer),
-            CancellationToken.None);
-
-        var response = Encoding.UTF8.GetString(buffer, 0, result.Count);
-        Console.WriteLine($"Received: {response}");
-
-        server.Stop();
-    }
-
-    /// <summary>
-    /// Example 2: Server-initiated messages (heartbeat/keep-alive)
-    /// </summary>
-    public static void HeartbeatWebSocketExample()
-    {
-        var server = WireMockServer.Start();
-
-        server
-            .Given(Request.Create()
-                .WithPath("/notifications")
-            )
-            .RespondWith(Response.Create()
-                .WithWebSocketHandler(async ctx =>
-                {
-                    var webSocket = ctx.WebSocket;
-                    var buffer = new byte[1024 * 4];
-
-                    // Send periodic heartbeat
-                    _ = Task.Run(async () =>
-                    {
-                        while (webSocket.State == WebSocketState.Open)
-                        {
-                            try
-                            {
-                                var heartbeat = Encoding.UTF8.GetBytes("{\"type\":\"heartbeat\"}");
-                                await webSocket.SendAsync(
-                                    new ArraySegment<byte>(heartbeat),
-                                    WebSocketMessageType.Text,
-                                    true,
-                                    CancellationToken.None);
-
-                                await Task.Delay(5000);
-                            }
-                            catch
-                            {
-                                break;
-                            }
-                        }
-                    });
-
-                    // Echo incoming messages
-                    while (webSocket.State == WebSocketState.Open)
-                    {
-                        try
-                        {
-                            var result = await webSocket.ReceiveAsync(
-                                new ArraySegment<byte>(buffer),
-                                CancellationToken.None);
-
-                            if (result.MessageType == WebSocketMessageType.Close)
-                            {
-                                await webSocket.CloseAsync(
-                                    WebSocketCloseStatus.NormalClosure,
-                                    "Closing",
-                                    CancellationToken.None);
-                            }
-                        }
-                        catch
-                        {
-                            break;
-                        }
-                    }
-                })
-                .WithWebSocketKeepAlive(TimeSpan.FromSeconds(30))
-            );
-
-        Console.WriteLine($"WebSocket server running at ws://localhost:{server.Port}/notifications");
-    }
-
-    /// <summary>
-    /// Example 3: Message-based routing
-    /// </summary>
-    public static void MessageRoutingExample()
-    {
-        var server = WireMockServer.Start();
-
-        server
-            .Given(Request.Create()
-                .WithPath("/api/ws")
-            )
-            .RespondWith(Response.Create()
-                .WithWebSocketMessageHandler(async msg =>
-                {
-                    // Route based on message type
-                    return msg.Type switch
-                    {
-                        "subscribe" => new WebSocketMessage
-                        {
-                            Type = "subscribed",
-                            TextData = "{\"status\":\"subscribed\"}"
-                        },
-                        "ping" => new WebSocketMessage
-                        {
-                            Type = "pong",
-                            TextData = "{\"type\":\"pong\"}"
-                        },
-                        _ => new WebSocketMessage
-                        {
-                            Type = "error",
-                            TextData = $"{{\"error\":\"Unknown message type: {msg.Type}\"}}"
-                        }
-                    };
-                })
-                .WithWebSocketKeepAlive(TimeSpan.FromSeconds(30))
-            );
-
-        Console.WriteLine($"WebSocket server running at ws://localhost:{server.Port}/api/ws");
-    }
-
-    /// <summary>
-    /// Example 4: WebSocket with custom headers validation
-    /// </summary>
-    public static void AuthenticatedWebSocketExample()
-    {
-        var server = WireMockServer.Start();
-
-        server
-            .Given(Request.Create()
-                .WithPath("/secure-ws")
-                .WithHeader("Authorization", "Bearer valid-token")
-            )
-            .RespondWith(Response.Create()
-                .WithWebSocketHandler(async ctx =>
-                {
-                    // This handler only executes if Authorization header matches
-                    var token = ctx.Headers.TryGetValue("Authorization", out var values)
-                        ? values[0]
-                        : "none";
-
-                    var message = Encoding.UTF8.GetBytes($"{{\"authenticated\":true,\"token\":\"{token}\"}}");
-                    await ctx.WebSocket.SendAsync(
-                        new ArraySegment<byte>(message),
-                        WebSocketMessageType.Text,
-                        true,
-                        CancellationToken.None);
-                })
-            );
-
-        Console.WriteLine($"Secure WebSocket server running at ws://localhost:{server.Port}/secure-ws");
-    }
-
-    /// <summary>
-    /// Example 5: WebSocket with message streaming
-    /// </summary>
-    public static void StreamingWebSocketExample()
-    {
-        var server = WireMockServer.Start();
-
-        server
-            .Given(Request.Create()
-                .WithPath("/stream")
-            )
-            .RespondWith(Response.Create()
-                .WithWebSocketHandler(async ctx =>
-                {
-                    var webSocket = ctx.WebSocket;
-
-                    // Stream 10 messages
-                    for (int i = 0; i < 10; i++)
-                    {
-                        var message = Encoding.UTF8.GetBytes(
-                            $"{{\"sequence\":{i},\"data\":\"Item {i}\",\"timestamp\":\"{DateTime.UtcNow:O}\"}}");
-
-                        await webSocket.SendAsync(
-                            new ArraySegment<byte>(message),
-                            WebSocketMessageType.Text,
-                            true,
-                            CancellationToken.None);
-
-                        await Task.Delay(1000);
-                    }
-
-                    // Send completion message
-                    var completion = Encoding.UTF8.GetBytes("{\"type\":\"complete\"}");
-                    await webSocket.SendAsync(
-                        new ArraySegment<byte>(completion),
-                        WebSocketMessageType.Text,
-                        true,
-                        CancellationToken.None);
-
-                    await webSocket.CloseAsync(
-                        WebSocketCloseStatus.NormalClosure,
-                        "Stream complete",
-                        CancellationToken.None);
-                })
-                .WithWebSocketTimeout(TimeSpan.FromMinutes(5))
-            );
-
-        Console.WriteLine($"Streaming WebSocket server running at ws://localhost:{server.Port}/stream");
-    }
-}

examples/WireMock.Net.ConsoleApp.UsingNuGet/WireMock.Net.ConsoleApp.UsingNuGet.csproj

@@ -7,16 +7,16 @@
     <Nullable>enable</Nullable>
   </PropertyGroup>
 
-  <ItemGroup>
+  <!--<ItemGroup>
     <ProjectReference Include="..\..\src\WireMock.Net\WireMock.Net.csproj" />
-  </ItemGroup>
+  </ItemGroup>-->
 
   <ItemGroup>
     <PackageReference Update="SonarAnalyzer.CSharp" Version="10.12.0.118525" />
   </ItemGroup>
 
-  <!--<ItemGroup>
-    <PackageReference Include="WireMock.Net" Version="1.8.11" />
-  </ItemGroup>-->
+  <ItemGroup>
+    <PackageReference Include="WireMock.Net" Version="1.12.0" />
+  </ItemGroup>
 
 </Project>

examples/WireMock.Net.OpenApiParser.ConsoleApp/WireMock.Net.OpenApiParser.ConsoleApp.csproj

@@ -6,6 +6,8 @@
     </PropertyGroup>
 
     <ItemGroup>
+        <PackageReference Include="Microsoft.OpenApi.YamlReader" Version="2.3.0" />
+        
         <ProjectReference Include="..\..\src\WireMock.Net.Abstractions\WireMock.Net.Abstractions.csproj" />
         <ProjectReference Include="..\..\src\WireMock.Net.OpenApiParser\WireMock.Net.OpenApiParser.csproj" />
         <ProjectReference Include="..\..\src\WireMock.Net\WireMock.Net.csproj" />

examples/WireMock.Net.Service/WireMock.Net.Service.csproj

@@ -115,10 +115,10 @@
   </ItemGroup>
   <ItemGroup>
     <PackageReference Include="log4net">
-      <Version>3.0.3</Version>
+      <Version>3.2.0</Version>
     </PackageReference>
     <PackageReference Include="WireMock.Net">
-      <Version>1.8.11</Version>
+      <Version>1.12.0</Version>
     </PackageReference>
   </ItemGroup>
   <Import Project="$(MSBuildToolsPath)\Microsoft.CSharp.targets" />

examples/WireMock.Net.WebApplication.IIS/WireMock.Net.WebApplication.IIS.csproj

@@ -1,7 +1,7 @@
 <Project Sdk="Microsoft.NET.Sdk.Web">
 
     <PropertyGroup>
-        <TargetFramework>net6</TargetFramework>
+        <TargetFramework>net8.0</TargetFramework>
         <!--<RuntimeIdentifiers>win10-x64</RuntimeIdentifiers>-->
         <StartupObject>WireMock.Net.WebApplication.Program</StartupObject>
         <AssemblyName>WireMock.Net.WebApplication</AssemblyName>
@@ -11,7 +11,7 @@
     </PropertyGroup>
 
     <ItemGroup>
-        <PackageReference Include="Microsoft.Extensions.Logging.Console" Version="6.0.0" />
+        <PackageReference Include="Microsoft.Extensions.Logging.Console" Version="8.0.0" />
         <PackageReference Include="Newtonsoft.Json" Version="13.0.3" />
     </ItemGroup>
 

examples/WireMock.Net.WebSocketExamples/Program.cs

@@ -0,0 +1,678 @@
+// Copyright © WireMock.Net
+
+using System.Net.WebSockets;
+using System.Text;
+using WireMock.Logging;
+using WireMock.RequestBuilders;
+using WireMock.ResponseBuilders;
+using WireMock.Server;
+using WireMock.Settings;
+
+namespace WireMock.Net.WebSocketExamples;
+
+public static class Program
+{
+    public static async Task Main(string[] args)
+    {
+        Console.WriteLine("WireMock.Net WebSocket Examples");
+        Console.WriteLine("================================\n");
+
+        Console.WriteLine("Choose an example to run:");
+        Console.WriteLine("1. Echo Server");
+        Console.WriteLine("2. Custom Message Handler");
+        Console.WriteLine("3. ...");
+        Console.WriteLine("4. Scenario/State Machine");
+        Console.WriteLine("5. WebSocket Proxy");
+        Console.WriteLine("6. Multiple WebSocket Endpoints");
+        Console.WriteLine("7. All Examples (runs all endpoints)");
+        Console.WriteLine("0. Exit\n");
+
+        Console.Write("Enter choice: ");
+        var choice = Console.ReadLine();
+
+        switch (choice)
+        {
+            case "1":
+                await RunEchoServerExample();
+                break;
+            case "2":
+                await RunCustomMessageHandlerExample();
+                break;
+            case "3":
+                await RunBroadcastExample();
+                break;
+            case "4":
+                await RunScenarioExample();
+                break;
+            case "5":
+                await RunProxyExample();
+                break;
+            case "6":
+                await RunMultipleEndpointsExample();
+                break;
+            case "7":
+                await RunAllExamples();
+                break;
+            case "0":
+                return;
+            default:
+                Console.WriteLine("Invalid choice");
+                break;
+        }
+    }
+
+    /// <summary>
+    /// Example 1: Simple Echo Server
+    /// Echoes back all messages received from the client
+    /// </summary>
+    private static async Task RunEchoServerExample()
+    {
+        Console.WriteLine("\n=== Echo Server Example ===");
+        Console.WriteLine("Starting WebSocket echo server...\n");
+
+        var server = WireMockServer.Start(new WireMockServerSettings
+        {
+            Port = 9091,
+            Logger = new WireMockConsoleLogger()
+        });
+
+        server
+            .Given(Request.Create()
+                .WithPath("/ws/echo")
+                .WithWebSocketUpgrade()
+            )
+            .RespondWith(Response.Create()
+                .WithWebSocket(ws => ws
+                    .WithEcho()
+                )
+            );
+
+        Console.WriteLine($"Echo server listening at: {server.Urls[0]}/ws/echo");
+        Console.WriteLine("\nTest with a WebSocket client:");
+        Console.WriteLine("  wscat -c ws://localhost:9091/ws/echo");
+        Console.WriteLine("\nPress any key to test or CTRL+C to exit...");
+        Console.ReadKey();
+
+        // Test the echo server
+        await TestWebSocketEcho(server.Urls[0]);
+
+        Console.WriteLine("\nPress any key to stop server...");
+        Console.ReadKey();
+        server.Stop();
+    }
+
+    /// <summary>
+    /// Example 2: Custom Message Handler
+    /// Processes messages and sends custom responses
+    /// </summary>
+    private static async Task RunCustomMessageHandlerExample()
+    {
+        Console.WriteLine("\n=== Custom Message Handler Example ===");
+        Console.WriteLine("Starting WebSocket server with custom message handler...\n");
+
+        var server = WireMockServer.Start(new WireMockServerSettings
+        {
+            Port = 9091,
+            Logger = new WireMockConsoleLogger()
+        });
+
+        server
+            .Given(Request.Create()
+                .WithPath("/ws/chat")
+                .WithWebSocketUpgrade()
+            )
+            .RespondWith(Response.Create()
+                .WithWebSocket(ws => ws
+                    .WithMessageHandler(async (message, context) =>
+                    {
+                        if (message.MessageType == WebSocketMessageType.Text)
+                        {
+                            var text = message.Text ?? string.Empty;
+                            
+                            // Handle different commands
+                            if (text.StartsWith("/help"))
+                            {
+                                await context.SendAsync("Available commands: /help, /time, /echo <text>, /upper <text>, /reverse <text>");
+                            }
+                            else if (text.StartsWith("/time"))
+                            {
+                                await context.SendAsync($"Server time: {DateTime.UtcNow:yyyy-MM-dd HH:mm:ss} UTC");
+                            }
+                            else if (text.StartsWith("/echo "))
+                            {
+                                await context.SendAsync(text.Substring(6));
+                            }
+                            else if (text.StartsWith("/upper "))
+                            {
+                                await context.SendAsync(text.Substring(7).ToUpper());
+                            }
+                            else if (text.StartsWith("/reverse "))
+                            {
+                                var toReverse = text.Substring(9);
+                                var reversed = new string(toReverse.Reverse().ToArray());
+                                await context.SendAsync(reversed);
+                            }
+                            else if (text == "/quit")
+                            {
+                                await context.SendAsync("Goodbye!");
+                                await context.CloseAsync(WebSocketCloseStatus.NormalClosure, "Client requested disconnect");
+                            }
+                            else
+                            {
+                                await context.SendAsync($"Unknown command: {text}. Type /help for available commands.");
+                            }
+                        }
+                    })
+                )
+            );
+
+        Console.WriteLine($"Chat server listening at: {server.Urls[0]}/ws/chat");
+        Console.WriteLine("\nTest with:");
+        Console.WriteLine("  wscat -c ws://localhost:9091/ws/chat");
+        Console.WriteLine("\nThen try commands: /help, /time, /echo hello, /upper hello, /reverse hello");
+        Console.WriteLine("\nPress any key to test or CTRL+C to exit...");
+        Console.ReadKey();
+
+        await TestWebSocketChat(server.Urls[0]);
+
+        Console.WriteLine("\nPress any key to stop server...");
+        Console.ReadKey();
+        server.Stop();
+    }
+
+    /// <summary>
+    /// Example 3: Broadcast Server
+    /// Broadcasts messages to all connected clients
+    /// </summary>
+    private static async Task RunBroadcastExample()
+    {
+        Console.WriteLine("\n=== Broadcast Server Example ===");
+        Console.WriteLine("Starting WebSocket broadcast server...\n");
+
+        var server = WireMockServer.Start(new WireMockServerSettings
+        {
+            Port = 9091,
+            Logger = new WireMockConsoleLogger()
+        });
+
+        var broadcastMappingGuid = Guid.NewGuid();
+
+        server
+            .Given(Request.Create()
+                .WithPath("/ws/broadcast")
+                .WithWebSocketUpgrade()
+            )
+            .WithGuid(broadcastMappingGuid)
+            .RespondWith(Response.Create()
+                .WithWebSocket(ws => ws
+                    .WithBroadcast()
+                    .WithMessageHandler(async (message, context) =>
+                    {
+                        if (message.MessageType == WebSocketMessageType.Text)
+                        {
+                            var text = message.Text ?? string.Empty;
+                            var timestamp = DateTime.UtcNow.ToString("HH:mm:ss");
+                            var broadcastMessage = $"[{timestamp}] Broadcast: {text}";
+                            
+                            // Broadcast to all connected clients
+                            await context.BroadcastTextAsync(broadcastMessage);
+                            
+                            Console.WriteLine($"Broadcasted to {server.GetWebSocketConnections(broadcastMappingGuid).Count} clients: {text}");
+                        }
+                    })
+                )
+            );
+
+        Console.WriteLine($"Broadcast server listening at: {server.Urls[0]}/ws/broadcast");
+        Console.WriteLine("\nConnect multiple clients:");
+        Console.WriteLine("  wscat -c ws://localhost:9091/ws/broadcast");
+        Console.WriteLine("\nMessages sent from any client will be broadcast to all clients");
+        Console.WriteLine("\nPress any key to stop server...");
+        Console.ReadKey();
+        server.Stop();
+    }
+
+    /// <summary>
+    /// Example 4: Scenario/State Machine
+    /// Demonstrates state transitions during WebSocket session
+    /// </summary>
+    private static async Task RunScenarioExample()
+    {
+        Console.WriteLine("\n=== Scenario/State Machine Example ===");
+        Console.WriteLine("Starting WebSocket server with scenario support...\n");
+
+        var server = WireMockServer.Start(new WireMockServerSettings
+        {
+            Port = 9091,
+            Logger = new WireMockConsoleLogger()
+        });
+
+        // Initial state: Waiting for players
+        server
+            .Given(Request.Create()
+                .WithPath("/ws/game")
+                .WithWebSocketUpgrade()
+            )
+            .InScenario("GameSession")
+            .WillSetStateTo("Lobby")
+            .RespondWith(Response.Create()
+                .WithWebSocket(ws => ws
+                    .WithMessageHandler(async (msg, ctx) =>
+                    {
+                        await ctx.SendAsync("Welcome to the game lobby! Type 'ready' to start or 'quit' to leave.");
+                    })
+                )
+            );
+
+        // Lobby state: Waiting for ready
+        server
+            .Given(Request.Create()
+                .WithPath("/ws/game")
+                .WithWebSocketUpgrade()
+            )
+            .InScenario("GameSession")
+            .WhenStateIs("Lobby")
+            .RespondWith(Response.Create()
+                .WithWebSocket(ws => ws
+                    .WithMessageHandler(async (msg, ctx) =>
+                    {
+                        var text = msg.Text?.ToLower() ?? string.Empty;
+                        
+                        if (text == "ready")
+                        {
+                            ctx.SetScenarioState("Playing");
+                            await ctx.SendAsync("Game started! Type 'attack' to attack, 'defend' to defend, or 'quit' to exit.");
+                        }
+                        else if (text == "quit")
+                        {
+                            await ctx.SendAsync("You left the lobby. Goodbye!");
+                            await ctx.CloseAsync(WebSocketCloseStatus.NormalClosure, "Player quit");
+                        }
+                        else
+                        {
+                            await ctx.SendAsync("In lobby. Type 'ready' to start or 'quit' to leave.");
+                        }
+                    })
+                )
+            );
+
+        // Playing state: Game is active
+        server
+            .Given(Request.Create()
+                .WithPath("/ws/game")
+                .WithWebSocketUpgrade()
+            )
+            .InScenario("GameSession")
+            .WhenStateIs("Playing")
+            .RespondWith(Response.Create()
+                .WithWebSocket(ws => ws
+                    .WithMessageHandler(async (msg, ctx) =>
+                    {
+                        var text = msg.Text?.ToLower() ?? string.Empty;
+                        
+                        if (text == "attack")
+                        {
+                            await ctx.SendAsync("You attacked! Critical hit! 💥");
+                        }
+                        else if (text == "defend")
+                        {
+                            await ctx.SendAsync("You defended! Shield up! 🛡️");
+                        }
+                        else if (text == "quit")
+                        {
+                            ctx.SetScenarioState("GameOver");
+                            await ctx.SendAsync("Game over! Thanks for playing.");
+                            await ctx.CloseAsync(WebSocketCloseStatus.NormalClosure, "Game ended");
+                        }
+                        else
+                        {
+                            await ctx.SendAsync("Unknown action. Type 'attack', 'defend', or 'quit'.");
+                        }
+                    })
+                )
+            );
+
+        Console.WriteLine($"Game server listening at: {server.Urls[0]}/ws/game");
+        Console.WriteLine("\nConnect and follow the game flow:");
+        Console.WriteLine("  wscat -c ws://localhost:9091/ws/game");
+        Console.WriteLine("\nGame flow: Lobby -> Type 'ready' -> Playing -> Type 'attack'/'defend' -> Type 'quit'");
+        Console.WriteLine("\nPress any key to stop server...");
+        Console.ReadKey();
+        server.Stop();
+    }
+
+    /// <summary>
+    /// Example 5: WebSocket Proxy
+    /// Proxies WebSocket connections to another server
+    /// </summary>
+    private static async Task RunProxyExample()
+    {
+        Console.WriteLine("\n=== WebSocket Proxy Example ===");
+        Console.WriteLine("Starting WebSocket proxy server...\n");
+
+        var server = WireMockServer.Start(new WireMockServerSettings
+        {
+            Port = 9091,
+            Logger = new WireMockConsoleLogger()
+        });
+
+        server
+            .Given(Request.Create()
+                .WithPath("/ws/proxy")
+                .WithWebSocketUpgrade()
+            )
+            .RespondWith(Response.Create()
+                .WithWebSocketProxy("ws://echo.websocket.org")
+            );
+
+        Console.WriteLine($"Proxy server listening at: {server.Urls[0]}/ws/proxy");
+        Console.WriteLine("Proxying to: ws://echo.websocket.org");
+        Console.WriteLine("\nTest with:");
+        Console.WriteLine("  wscat -c ws://localhost:9091/ws/proxy");
+        Console.WriteLine("\nPress any key to stop server...");
+        Console.ReadKey();
+        server.Stop();
+    }
+
+    /// <summary>
+    /// Example 6: Multiple WebSocket Endpoints
+    /// Demonstrates running multiple WebSocket endpoints simultaneously
+    /// </summary>
+    private static async Task RunMultipleEndpointsExample()
+    {
+        Console.WriteLine("\n=== Multiple WebSocket Endpoints Example ===");
+        Console.WriteLine("Starting server with multiple WebSocket endpoints...\n");
+
+        var server = WireMockServer.Start(new WireMockServerSettings
+        {
+            Port = 9091,
+            Logger = new WireMockConsoleLogger(),
+            WebSocketSettings = new WebSocketSettings
+            {
+                MaxConnections = 100,
+                KeepAliveIntervalSeconds = 30
+            }
+        });
+
+        // Endpoint 1: Echo
+        server
+            .Given(Request.Create()
+                .WithPath("/ws/echo")
+                .WithWebSocketUpgrade()
+            )
+            .RespondWith(Response.Create()
+                .WithWebSocket(ws => ws.WithEcho())
+            );
+
+        // Endpoint 2: Time service
+        server
+            .Given(Request.Create()
+                .WithPath("/ws/time")
+                .WithWebSocketUpgrade()
+            )
+            .RespondWith(Response.Create()
+                .WithWebSocket(ws => ws
+                    .WithMessageHandler(async (msg, ctx) =>
+                    {
+                        await ctx.SendAsync($"Server time: {DateTime.UtcNow:yyyy-MM-dd HH:mm:ss} UTC");
+                    })
+                )
+            );
+
+        // Endpoint 4: Protocol-specific
+        server
+            .Given(Request.Create()
+                .WithPath("/ws/protocol")
+                .WithWebSocketUpgrade("chat", "superchat")
+            )
+            .RespondWith(Response.Create()
+                .WithWebSocket(ws => ws
+                    .WithAcceptProtocol("chat")
+                    .WithMessageHandler(async (msg, ctx) =>
+                    {
+                        await ctx.SendAsync($"Using protocol: chat. Message: {msg.Text}");
+                    })
+                )
+            );
+
+        Console.WriteLine("Available WebSocket endpoints:");
+        Console.WriteLine($"  1. Echo:     {server.Urls[0]}/ws/echo");
+        Console.WriteLine($"  2. Time:     {server.Urls[0]}/ws/time");
+        Console.WriteLine($"  3. JSON:     {server.Urls[0]}/ws/json");
+        Console.WriteLine($"  4. Protocol: {server.Urls[0]}/ws/protocol");
+        Console.WriteLine("\nTest with wscat:");
+        Console.WriteLine("  wscat -c ws://localhost:9091/ws/echo");
+        Console.WriteLine("  wscat -c ws://localhost:9091/ws/time");
+        Console.WriteLine("  wscat -c ws://localhost:9091/ws/json");
+        Console.WriteLine("  wscat -c ws://localhost:9091/ws/protocol -s chat");
+        Console.WriteLine("\nPress any key to stop server...");
+        Console.ReadKey();
+        server.Stop();
+    }
+
+    /// <summary>
+    /// Example 7: Run All Examples
+    /// Starts a server with all example endpoints
+    /// </summary>
+    private static async Task RunAllExamples()
+    {
+        Console.WriteLine("\n=== All Examples Running ===");
+        Console.WriteLine("Starting server with all WebSocket endpoints...\n");
+
+        var server = WireMockServer.Start(new WireMockServerSettings
+        {
+            Port = 9091,
+            Logger = new WireMockConsoleLogger(),
+            WebSocketSettings = new WebSocketSettings
+            {
+                MaxConnections = 200
+            }
+        });
+
+        SetupAllEndpoints(server);
+
+        Console.WriteLine("All WebSocket endpoints are running:");
+        Console.WriteLine($"  Echo:      {server.Urls[0]}/ws/echo");
+        Console.WriteLine($"  Chat:      {server.Urls[0]}/ws/chat");
+        Console.WriteLine($"  Broadcast: {server.Urls[0]}/ws/broadcast");
+        Console.WriteLine($"  Game:      {server.Urls[0]}/ws/game");
+        Console.WriteLine($"  Time:      {server.Urls[0]}/ws/time");
+        Console.WriteLine($"  JSON:      {server.Urls[0]}/ws/json");
+        Console.WriteLine("\nServer statistics:");
+        Console.WriteLine($"  Total mappings: {server.Mappings.Count}");
+        
+        Console.WriteLine("\nPress any key to view connection stats or CTRL+C to exit...");
+        
+        while (true)
+        {
+            Console.ReadKey(true);
+            var connections = server.GetWebSocketConnections();
+            Console.WriteLine($"\nActive WebSocket connections: {connections.Count}");
+            foreach (var conn in connections)
+            {
+                Console.WriteLine($"  - {conn.ConnectionId}: {conn.RequestMessage.Path} (State: {conn.WebSocket.State})");
+            }
+            Console.WriteLine("\nPress any key to refresh or CTRL+C to exit...");
+        }
+    }
+
+    private static void SetupAllEndpoints(WireMockServer server)
+    {
+        // Echo endpoint
+        server
+            .Given(Request.Create()
+                .WithPath("/ws/echo")
+                .WithWebSocketUpgrade()
+            )
+            .RespondWith(Response.Create()
+                .WithWebSocket(ws => ws.WithEcho())
+            );
+
+        // Chat endpoint
+        server
+            .Given(Request.Create()
+                .WithPath("/ws/chat")
+                .WithWebSocketUpgrade()
+            )
+            .RespondWith(Response.Create()
+                .WithWebSocket(ws => ws
+                    .WithMessageHandler(async (message, context) =>
+                    {
+                        if (message.MessageType == WebSocketMessageType.Text)
+                        {
+                            await context.SendAsync($"Echo: {message.Text}");
+                        }
+                    })
+                )
+            );
+
+        // Broadcast endpoint
+        var broadcastGuid = Guid.NewGuid();
+        server
+            .Given(Request.Create()
+                .WithPath("/ws/broadcast")
+                .WithWebSocketUpgrade()
+            )
+            .WithGuid(broadcastGuid)
+            .RespondWith(Response.Create()
+                .WithWebSocket(ws => ws
+                    .WithBroadcast()
+                    .WithMessageHandler(async (message, context) =>
+                    {
+                        if (message.MessageType == WebSocketMessageType.Text)
+                        {
+                            await context.BroadcastTextAsync($"[Broadcast] {message.Text}");
+                        }
+                    })
+                )
+            );
+
+        // Game scenario endpoint
+        SetupGameScenario(server);
+
+        // Time endpoint
+        server
+            .Given(Request.Create()
+                .WithPath("/ws/time")
+                .WithWebSocketUpgrade()
+            )
+            .RespondWith(Response.Create()
+                .WithWebSocket(ws => ws
+                    .WithMessageHandler(async (msg, ctx) =>
+                    {
+                        await ctx.SendAsync($"Server time: {DateTime.UtcNow:yyyy-MM-dd HH:mm:ss} UTC");
+                    })
+                )
+            );
+    }
+
+    private static void SetupGameScenario(WireMockServer server)
+    {
+        server
+            .Given(Request.Create()
+                .WithPath("/ws/game")
+                .WithWebSocketUpgrade()
+            )
+            .InScenario("GameSession")
+            .WillSetStateTo("Lobby")
+            .RespondWith(Response.Create()
+                .WithWebSocket(ws => ws
+                    .WithMessageHandler(async (msg, ctx) =>
+                    {
+                        await ctx.SendAsync("Welcome! Type 'ready' to start.");
+                    })
+                )
+            );
+
+        server
+            .Given(Request.Create()
+                .WithPath("/ws/game")
+                .WithWebSocketUpgrade()
+            )
+            .InScenario("GameSession")
+            .WhenStateIs("Lobby")
+            .RespondWith(Response.Create()
+                .WithWebSocket(ws => ws
+                    .WithMessageHandler(async (msg, ctx) =>
+                    {
+                        if (msg.Text?.ToLower() == "ready")
+                        {
+                            ctx.SetScenarioState("Playing");
+                            await ctx.SendAsync("Game started!");
+                        }
+                    })
+                )
+            );
+    }
+
+    // Helper methods for testing
+    private static async Task TestWebSocketEcho(string baseUrl)
+    {
+        try
+        {
+            using var client = new ClientWebSocket();
+            var uri = new Uri($"{baseUrl.Replace("http://", "ws://")}/ws/echo");
+            
+            Console.WriteLine($"\nConnecting to {uri}...");
+            await client.ConnectAsync(uri, CancellationToken.None);
+            Console.WriteLine("Connected!");
+
+            var testMessages = new[] { "Hello", "World", "WebSocket", "Test" };
+            
+            foreach (var testMessage in testMessages)
+            {
+                Console.WriteLine($"\nSending: {testMessage}");
+                var bytes = Encoding.UTF8.GetBytes(testMessage);
+                await client.SendAsync(new ArraySegment<byte>(bytes), WebSocketMessageType.Text, true, CancellationToken.None);
+
+                var buffer = new byte[1024];
+                var result = await client.ReceiveAsync(new ArraySegment<byte>(buffer), CancellationToken.None);
+                var received = Encoding.UTF8.GetString(buffer, 0, result.Count);
+                Console.WriteLine($"Received: {received}");
+            }
+
+            await client.CloseAsync(WebSocketCloseStatus.NormalClosure, "Test complete", CancellationToken.None);
+            Console.WriteLine("\nTest completed successfully!");
+        }
+        catch (Exception ex)
+        {
+            Console.WriteLine($"\nTest failed: {ex.Message}");
+        }
+    }
+
+    private static async Task TestWebSocketChat(string baseUrl)
+    {
+        try
+        {
+            using var client = new ClientWebSocket();
+            var uri = new Uri($"{baseUrl.Replace("http://", "ws://")}/ws/chat");
+            
+            Console.WriteLine($"\nConnecting to {uri}...");
+            await client.ConnectAsync(uri, CancellationToken.None);
+            Console.WriteLine("Connected!");
+
+            var commands = new[] { "/help", "/time", "/echo Hello", "/upper test", "/reverse hello" };
+            
+            foreach (var command in commands)
+            {
+                Console.WriteLine($"\nSending: {command}");
+                var bytes = Encoding.UTF8.GetBytes(command);
+                await client.SendAsync(new ArraySegment<byte>(bytes), WebSocketMessageType.Text, true, CancellationToken.None);
+
+                var buffer = new byte[1024];
+                var result = await client.ReceiveAsync(new ArraySegment<byte>(buffer), CancellationToken.None);
+                var received = Encoding.UTF8.GetString(buffer, 0, result.Count);
+                Console.WriteLine($"Received: {received}");
+                
+                await Task.Delay(500);
+            }
+
+            await client.CloseAsync(WebSocketCloseStatus.NormalClosure, "Test complete", CancellationToken.None);
+            Console.WriteLine("\nTest completed successfully!");
+        }
+        catch (Exception ex)
+        {
+            Console.WriteLine($"\nTest failed: {ex.Message}");
+        }
+    }
+}

examples/WireMock.Net.WebSocketExamples/README.md

@@ -0,0 +1,156 @@
+# WireMock.Net WebSocket Examples
+
+This project demonstrates all the WebSocket capabilities of WireMock.Net.
+
+## Prerequisites
+
+- .NET 8.0 SDK
+- Optional: `wscat` for manual testing (`npm install -g wscat`)
+
+## Running the Examples
+
+```bash
+cd examples/WireMock.Net.WebSocketExamples
+dotnet run
+```
+
+## Available Examples
+
+### 1. Echo Server
+Simple WebSocket echo server that returns all messages back to the client.
+
+**Test with:**
+```bash
+wscat -c ws://localhost:9091/ws/echo
+```
+
+### 2. Custom Message Handler
+Chat server with commands: `/help`, `/time`, `/echo`, `/upper`, `/reverse`, `/quit`
+
+**Test with:**
+```bash
+wscat -c ws://localhost:9091/ws/chat
+> /help
+> /time
+> /echo Hello World
+> /upper test
+> /reverse hello
+```
+
+### 3. Broadcast Server
+Messages sent by any client are broadcast to all connected clients.
+
+**Test with multiple terminals:**
+```bash
+# Terminal 1
+wscat -c ws://localhost:9091/ws/broadcast
+
+# Terminal 2
+wscat -c ws://localhost:9091/ws/broadcast
+
+# Terminal 3
+wscat -c ws://localhost:9091/ws/broadcast
+```
+
+Type messages in any terminal and see them appear in all terminals.
+
+### 4. Scenario/State Machine
+Game server with state transitions: Lobby -> Playing -> GameOver
+
+**Test with:**
+```bash
+wscat -c ws://localhost:9091/ws/game
+> ready
+> attack
+> defend
+> quit
+```
+
+### 5. WebSocket Proxy
+Proxies WebSocket connections to echo.websocket.org
+
+**Test with:**
+```bash
+wscat -c ws://localhost:9091/ws/proxy
+```
+
+### 6. Multiple Endpoints
+Runs multiple WebSocket endpoints simultaneously:
+- `/ws/echo` - Echo server
+- `/ws/time` - Returns server time
+- `/ws/json` - Returns JSON responses
+- `/ws/protocol` - Protocol-specific endpoint
+
+### 7. All Examples
+Runs all endpoints at once with connection statistics.
+
+## Features Demonstrated
+
+- ✅ **Echo Server** - Simple message echo
+- ✅ **Custom Handlers** - Complex message processing
+- ✅ **Broadcast** - Multi-client communication
+- ✅ **Scenarios** - State machine patterns
+- ✅ **Proxy** - Forwarding to real WebSocket servers
+- ✅ **Protocol Negotiation** - Sec-WebSocket-Protocol support
+- ✅ **JSON Messaging** - Structured data exchange
+- ✅ **Connection Management** - Track and manage connections
+- ✅ **Configuration** - Custom WebSocket settings
+
+## Testing with wscat
+
+Install wscat globally:
+```bash
+npm install -g wscat
+```
+
+Basic usage:
+```bash
+# Connect to endpoint
+wscat -c ws://localhost:9091/ws/echo
+
+# Connect with protocol
+wscat -c ws://localhost:9091/ws/protocol -s chat
+
+# Connect with headers
+wscat -c ws://localhost:9091/ws/echo -H "X-Custom-Header: value"
+```
+
+## Testing with C# Client
+
+The examples include built-in C# WebSocket clients for automated testing.
+Select options 1 or 2 and press any key to run the automated tests.
+
+## Configuration
+
+WebSocket settings can be configured:
+
+```csharp
+var server = WireMockServer.Start(new WireMockServerSettings
+{
+    Port = 9091,
+    WebSocketSettings = new WebSocketSettings
+    {
+        MaxConnections = 100,
+        ReceiveBufferSize = 8192,
+        MaxMessageSize = 1048576,
+        KeepAliveInterval = TimeSpan.FromSeconds(30),
+        CloseTimeout = TimeSpan.FromMinutes(10),
+        EnableCompression = true
+    }
+});
+```
+
+## Monitoring
+
+When running "All Examples" (option 7), press any key to view:
+- Active connection count
+- Connection IDs
+- Request paths
+- WebSocket states
+
+## Notes
+
+- All examples run on port 9091 by default
+- Press CTRL+C to stop the server
+- Multiple clients can connect simultaneously
+- Connection states are tracked and can be queried

examples/WireMock.Net.WebSocketExamples/WireMock.Net.WebSocketExamples.csproj

@@ -0,0 +1,18 @@
+<Project Sdk="Microsoft.NET.Sdk">
+
+    <PropertyGroup>
+        <OutputType>Exe</OutputType>
+        <TargetFramework>net8.0</TargetFramework>
+        <AssemblyName>WireMock.Net.WebSocketExamples</AssemblyName>
+        <RootNamespace>WireMock.Net.WebSocketExamples</RootNamespace>
+    </PropertyGroup>
+
+    <ItemGroup>
+        <ProjectReference Include="..\..\src\WireMock.Net\WireMock.Net.csproj" />
+    </ItemGroup>
+
+    <ItemGroup>
+        <PackageReference Include="Microsoft.Extensions.Configuration" Version="8.0.0" />
+    </ItemGroup>
+
+</Project>

examples/WireMockAzureQueueExample/WireMockAzureQueueExample.csproj

@@ -1,25 +1,25 @@
 <Project Sdk="Microsoft.NET.Sdk">
-  <PropertyGroup>
-    <TargetFramework>net6.0</TargetFramework>
-    <AzureFunctionsVersion>v4</AzureFunctionsVersion>
-    <UserSecretsId>bb7d8355-68c4-4f81-8c2d-6cdd80cd7602</UserSecretsId>
-  </PropertyGroup>
-  <ItemGroup>
-    <PackageReference Include="Azure.Storage.Blobs" Version="12.14.1" />
-    <PackageReference Include="Azure.Storage.Files.Shares" Version="12.12.1" />
-    <PackageReference Include="Azure.Storage.Queues" Version="12.12.0" />
-    <PackageReference Include="Microsoft.Azure.WebJobs.Extensions.Storage" Version="4.0.5" />
-    <PackageReference Include="Microsoft.Extensions.Azure" Version="1.0.0" />
-    <PackageReference Include="Microsoft.Extensions.Configuration.UserSecrets" Version="6.0.1" />
-    <PackageReference Include="Microsoft.NET.Sdk.Functions" Version="4.1.3" />
-  </ItemGroup>
-  <ItemGroup>
-    <None Update="host.json">
-      <CopyToOutputDirectory>PreserveNewest</CopyToOutputDirectory>
-    </None>
-    <None Update="local.settings.json">
-      <CopyToOutputDirectory>PreserveNewest</CopyToOutputDirectory>
-      <CopyToPublishDirectory>Never</CopyToPublishDirectory>
-    </None>
-  </ItemGroup>
+    <PropertyGroup>
+        <TargetFramework>net8.0</TargetFramework>
+        <AzureFunctionsVersion>v4</AzureFunctionsVersion>
+        <UserSecretsId>bb7d8355-68c4-4f81-8c2d-6cdd80cd7602</UserSecretsId>
+    </PropertyGroup>
+    <ItemGroup>
+        <PackageReference Include="Azure.Storage.Blobs" Version="12.14.1" />
+        <PackageReference Include="Azure.Storage.Files.Shares" Version="12.12.1" />
+        <PackageReference Include="Azure.Storage.Queues" Version="12.12.0" />
+        <PackageReference Include="Microsoft.Azure.WebJobs.Extensions.Storage" Version="4.0.5" />
+        <PackageReference Include="Microsoft.Extensions.Azure" Version="1.0.0" />
+        <PackageReference Include="Microsoft.Extensions.Configuration.UserSecrets" Version="6.0.1" />
+        <PackageReference Include="Microsoft.NET.Sdk.Functions" Version="4.1.3" />
+    </ItemGroup>
+    <ItemGroup>
+        <None Update="host.json">
+            <CopyToOutputDirectory>PreserveNewest</CopyToOutputDirectory>
+        </None>
+        <None Update="local.settings.json">
+            <CopyToOutputDirectory>PreserveNewest</CopyToOutputDirectory>
+            <CopyToPublishDirectory>Never</CopyToPublishDirectory>
+        </None>
+    </ItemGroup>
 </Project>

examples/WireMockAzureQueueProxy/WireMockAzureQueueProxy.csproj

@@ -2,7 +2,7 @@
 
     <PropertyGroup>
         <OutputType>Exe</OutputType>
-        <TargetFramework>net6.0</TargetFramework>
+        <TargetFramework>net8.0</TargetFramework>
     </PropertyGroup>
 
     <ItemGroup>

src/WireMock.Net.Abstractions/Admin/Settings/SettingsModel.cs

@@ -2,7 +2,6 @@
 
 using System.Collections.Generic;
 using System.Text.RegularExpressions;
-using JetBrains.Annotations;
 using WireMock.Handlers;
 using WireMock.Types;
 
@@ -123,7 +122,6 @@ public class SettingsModel
     /// </summary>
     public Dictionary<string, string[]>? ProtoDefinitions { get; set; }
 
-#if NETSTANDARD1_3_OR_GREATER || NET461
     /// <summary>
     /// Server client certificate mode
     /// </summary>
@@ -133,5 +131,9 @@ public class SettingsModel
     /// Whether to accept any client certificate
     /// </summary>
     public bool AcceptAnyClientCertificate { get; set; }
-#endif
+
+    /// <summary>
+    /// Gets or sets the WebSocket settings.
+    /// </summary>
+    public WebSocketSettingsModel? WebSocketSettings { get; set; }
 }

src/WireMock.Net.Abstractions/Admin/Settings/WebSocketSettingsModel.cs

@@ -0,0 +1,40 @@
+// Copyright © WireMock.Net
+
+namespace WireMock.Admin.Settings;
+
+/// <summary>
+/// WebSocket Settings Model
+/// </summary>
+[FluentBuilder.AutoGenerateBuilder]
+public class WebSocketSettingsModel
+{
+    /// <summary>
+    /// Maximum number of concurrent WebSocket connections (default: 100)
+    /// </summary>
+    public int MaxConnections { get; set; } = 100;
+
+    /// <summary>
+    /// Default receive buffer size in bytes (default: 4096)
+    /// </summary>
+    public int ReceiveBufferSize { get; set; } = 4096;
+
+    /// <summary>
+    /// Default keep-alive interval in seconds (default: 30)
+    /// </summary>
+    public int KeepAliveIntervalSeconds { get; set; } = 30;
+
+    /// <summary>
+    /// Maximum message size in bytes (default: 1048576 - 1 MB)
+    /// </summary>
+    public int MaxMessageSize { get; set; } = 1048576;
+
+    /// <summary>
+    /// Enable WebSocket compression (default: true)
+    /// </summary>
+    public bool EnableCompression { get; set; } = true;
+
+    /// <summary>
+    /// Default close timeout in minutes (default: 10)
+    /// </summary>
+    public int CloseTimeoutMinutes { get; set; } = 10;
+}

src/WireMock.Net.Abstractions/Constants/WebSocketConstants.cs

@@ -0,0 +1,39 @@
+// Copyright © WireMock.Net
+
+namespace WireMock.Constants;
+
+/// <summary>
+/// WebSocket constants
+/// </summary>
+public static class WebSocketConstants
+{
+    /// <summary>
+    /// Default receive buffer size for WebSocket messages (4 KB)
+    /// </summary>
+    public const int DefaultReceiveBufferSize = 4096;
+
+    /// <summary>
+    /// Default keep-alive interval in seconds
+    /// </summary>
+    public const int DefaultKeepAliveIntervalSeconds = 30;
+
+    /// <summary>
+    /// Default close timeout in minutes
+    /// </summary>
+    public const int DefaultCloseTimeoutMinutes = 10;
+
+    /// <summary>
+    /// Minimum buffer size for WebSocket operations (1 KB)
+    /// </summary>
+    public const int MinimumBufferSize = 1024;
+
+    /// <summary>
+    /// Default maximum message size (1 MB)
+    /// </summary>
+    public const int DefaultMaxMessageSize = 1024 * 1024;
+
+    /// <summary>
+    /// Proxy forward buffer size (4 KB)
+    /// </summary>
+    public const int ProxyForwardBufferSize = 4096;
+}

src/WireMock.Net.Abstractions/IRequestMessage.cs

@@ -2,9 +2,7 @@
 
 using System;
 using System.Collections.Generic;
-#if NETSTANDARD1_3_OR_GREATER || NET461
 using System.Security.Cryptography.X509Certificates;
-#endif
 using WireMock.Types;
 using WireMock.Util;
 
@@ -118,13 +116,11 @@ public interface IRequestMessage
     /// </summary>
     byte[]? BodyAsBytes { get; }
 
-#if MIMEKIT
     /// <summary>
     /// The original body as MimeMessage.
     /// Convenience getter for Handlebars and WireMockAssertions.
     /// </summary>
     Models.Mime.IMimeMessageData? BodyAsMimeMessage { get; }
-#endif
 
     /// <summary>
     /// The detected body type. Convenience getter for Handlebars.
@@ -169,10 +165,8 @@ public interface IRequestMessage
     /// <returns>The query parameter value as WireMockList or null when not found.</returns>
     WireMockList<string>? GetParameter(string key, bool ignoreCase = false);
 
-#if NETSTANDARD1_3_OR_GREATER || NET461
     /// <summary>
     /// Gets the connection's client certificate
     /// </summary>
     X509Certificate2? ClientCertificate { get; }
-#endif
 }

src/WireMock.Net.Abstractions/Types/ClientCertificateMode.cs

@@ -2,7 +2,6 @@
 
 namespace WireMock.Types;
 
-#if NETSTANDARD1_3_OR_GREATER || NET461
 /// <summary>
 /// Describes the client certificate requirements for a HTTPS connection.
 /// This enum is the same as https://learn.microsoft.com/en-us/dotnet/api/microsoft.aspnetcore.server.kestrel.https.clientcertificatemode
@@ -29,5 +28,4 @@ public enum ClientCertificateMode
     /// It may be requested by the application later.
     /// </summary>
     DelayCertificate,
-}
-#endif
+}

src/WireMock.Net.Abstractions/Types/HostingScheme.cs

@@ -1,7 +1,5 @@
 // Copyright © WireMock.Net
 
-using System;
-
 namespace WireMock.Types;
 
 [Flags]
@@ -13,5 +11,11 @@ public enum HostingScheme
 
     Https = 0x2,
 
-    HttpAndHttps = Http | Https
+    HttpAndHttps = Http | Https,
+
+    Ws = 0x4,
+
+    Wss = 0x8,
+
+    WsAndWss = Ws | Wss
 }

src/WireMock.Net.Abstractions/WireMock.Net.Abstractions.csproj

@@ -4,7 +4,8 @@
         <Description>Commonly used interfaces, models, enumerations and types.</Description>
         <AssemblyTitle>WireMock.Net.Abstractions</AssemblyTitle>
         <Authors>Stef Heyenrath</Authors>
-        <TargetFrameworks>net45;net451;net461;netstandard1.3;netstandard2.0;netstandard2.1</TargetFrameworks>
+        <!--<TargetFrameworks>net45;net451;net462;netstandard1.3;netstandard2.0;netstandard2.1</TargetFrameworks>-->
+        <TargetFrameworks>netstandard2.0;net8.0</TargetFrameworks>
         <GenerateDocumentationFile>true</GenerateDocumentationFile>
         <NoWarn>$(NoWarn);1591;8603</NoWarn>
         <AssemblyName>WireMock.Net.Abstractions</AssemblyName>
@@ -33,32 +34,36 @@
         <GeneratePackageOnBuild>true</GeneratePackageOnBuild>
     </PropertyGroup>
 
-    <PropertyGroup Condition=" '$(TargetFramework)' == 'netstandard2.0' or '$(TargetFramework)' == 'netstandard2.1'">
-        <DefineConstants>$(DefineConstants);GRAPHQL;MIMEKIT;PROTOBUF</DefineConstants>
-    </PropertyGroup>
+    <ItemGroup Condition=" '$(TargetFramework)' == 'net48' ">
+        <!-- CVE-2018-8292 / https://github.com/advisories/GHSA-7jgj-8wvc-jh57 -->
+        <PackageReference Include="System.Net.Http" Version="4.3.4" />
+    </ItemGroup>
+
+    <!--<ItemGroup Condition=" '$(TargetFramework)' == 'netstandard2.0' ">
+        <PackageReference Include="Required" Version="1.0.0">
+            <PrivateAssets>all</PrivateAssets>
+            <IncludeAssets>runtime; build; native; contentfiles; analyzers; buildtransitive</IncludeAssets>
+        </PackageReference>
+        <PackageReference Include="IsExternalInit" Version="1.0.3">
+            <PrivateAssets>all</PrivateAssets>
+            <IncludeAssets>runtime; build; native; contentfiles; analyzers; buildtransitive</IncludeAssets>
+        </PackageReference>
+        <PackageReference Include="Nullable" Version="1.3.1">
+            <PrivateAssets>all</PrivateAssets>
+            <IncludeAssets>runtime; build; native; contentfiles; analyzers; buildtransitive</IncludeAssets>
+        </PackageReference>
+    </ItemGroup>-->
 
     <ItemGroup>
-        <!-- CVE-2018-8292 / https://github.com/advisories/GHSA-7jgj-8wvc-jh57 -->
-        <PackageReference Include="System.Net.Http " Version="4.3.4" />
-
-        <!-- See also https://mstack.nl/blog/20210801-source-generators -->
-        <PackageReference Include="FluentBuilder" Version="0.10.0">
+        <PackageReference Include="FluentBuilder" Version="0.13.0">
             <PrivateAssets>all</PrivateAssets>
             <IncludeAssets>runtime; build; native; contentfiles; analyzers; buildtransitive</IncludeAssets>
         </PackageReference>
-        <PackageReference Include="PolySharp" Version="1.15.0">
-            <PrivateAssets>all</PrivateAssets>
-            <IncludeAssets>runtime; build; native; contentfiles; analyzers; buildtransitive</IncludeAssets>
-        </PackageReference>
-    </ItemGroup>
-
-    <ItemGroup Condition="$(TargetFramework.StartsWith('netstandard')) and '$(TargetFramework)' != 'netstandard1.0'">
-      <PackageReference Include="System.Security.Cryptography.X509Certificates" Version="4.3.0" />
-    </ItemGroup>
-
-
-    <ItemGroup Condition="'$(TargetFramework)' == 'netstandard1.3' or '$(TargetFramework)' == 'net45' or '$(TargetFramework)' == 'net451' or '$(TargetFramework)' == 'net461'">
-        <PackageReference Include="System.ValueTuple" Version="4.5.0" />
+        
+        <!--<PackageReference Include="Polyfill" Version="9.8.1">
+          <PrivateAssets>all</PrivateAssets>
+          <IncludeAssets>runtime; build; native; contentfiles; analyzers; buildtransitive</IncludeAssets>
+        </PackageReference>-->        
     </ItemGroup>
 
 </Project>

src/WireMock.Net.AspNetCore.Middleware/WireMock.Net.AspNetCore.Middleware.csproj

@@ -38,7 +38,7 @@
     </ItemGroup>
 
     <ItemGroup>
-        <PackageReference Include="Microsoft.Extensions.DependencyInjection.Abstractions" Version="8.0.0" />
+        <PackageReference Include="Microsoft.Extensions.DependencyInjection.Abstractions" Version="8.0.2" />
     </ItemGroup>
 
     <ItemGroup>

src/WireMock.Net.AwesomeAssertions/WireMock.Net.AwesomeAssertions.csproj

@@ -4,7 +4,8 @@
         <Description>AwesomeAssertions extensions for WireMock.Net</Description>
         <AssemblyTitle>WireMock.Net.AwesomeAssertions</AssemblyTitle>
         <Authors>Francesco Venturoli;Mahmoud Ali;Stef Heyenrath</Authors>
-        <TargetFrameworks>net47;netstandard2.0;netstandard2.1</TargetFrameworks>
+        <!--<TargetFrameworks>net47;netstandard2.0;netstandard2.1</TargetFrameworks>-->
+        <TargetFrameworks>netstandard2.0</TargetFrameworks>
         <GenerateDocumentationFile>true</GenerateDocumentationFile>
         <AssemblyName>WireMock.Net.AwesomeAssertions</AssemblyName>
         <PackageId>WireMock.Net.AwesomeAssertions</PackageId>
@@ -32,7 +33,7 @@
     </PropertyGroup>
 
     <ItemGroup>
-        <PackageReference Include="AwesomeAssertions" Version="9.0.0" />
+        <PackageReference Include="AwesomeAssertions" Version="9.1.0" />
     </ItemGroup>
 
     <ItemGroup>

src/WireMock.Net.Extensions.Routing/Models/WireMockRequestInfo{TBody}.cs

@@ -21,4 +21,4 @@ public sealed class WireMockRequestInfo<TBody> : WireMockRequestInfo
     /// Gets or initializes the deserialized request body.
     /// </summary>
     public TBody? Body { get; init; }
-}
+}

src/WireMock.Net.Extensions.Routing/WireMock.Net.Extensions.Routing.csproj

@@ -2,7 +2,7 @@
     <PropertyGroup>
         <Description>WireMock.Net.Routing extends WireMock.Net with modern, minimal-API-style routing for .NET</Description>
         <Authors>Gennadii Saltyshchak</Authors>
-        <TargetFrameworks>net8.0</TargetFrameworks>
+        <TargetFramework>net8.0</TargetFramework>
         <GenerateDocumentationFile>true</GenerateDocumentationFile>
         <PackageTags>tdd;mock;http;wiremock;test;server;unittest;routing;minimalapi</PackageTags>
         <PublishRepositoryUrl>true</PublishRepositoryUrl>
@@ -25,10 +25,10 @@
     </PropertyGroup>
 
     <ItemGroup>
-      <PackageReference Include="JsonConverter.Newtonsoft.Json" Version="0.7.0" />
+        <PackageReference Include="JsonConverter.Newtonsoft.Json" Version="0.7.2" />
     </ItemGroup>
 
     <ItemGroup>
-      <ProjectReference Include="..\WireMock.Net.Minimal\WireMock.Net.Minimal.csproj" />
+        <ProjectReference Include="..\WireMock.Net.Minimal\WireMock.Net.Minimal.csproj" />
     </ItemGroup>
 </Project>

src/WireMock.Net.FluentAssertions/WireMock.Net.FluentAssertions.csproj

@@ -1,10 +1,11 @@
-<Project Sdk="Microsoft.NET.Sdk">
+<Project Sdk="Microsoft.NET.Sdk">
 
     <PropertyGroup>
         <Description>FluentAssertions extensions for WireMock.Net</Description>
         <AssemblyTitle>WireMock.Net.FluentAssertions</AssemblyTitle>
         <Authors>Mahmoud Ali;Stef Heyenrath</Authors>
-        <TargetFrameworks>net451;net47;netstandard1.3;netstandard2.0;netstandard2.1</TargetFrameworks>
+        <!--<TargetFrameworks>net451;net47;netstandard1.3;netstandard2.0;netstandard2.1</TargetFrameworks>-->
+        <TargetFrameworks>netstandard2.0</TargetFrameworks>
         <GenerateDocumentationFile>true</GenerateDocumentationFile>
         <AssemblyName>WireMock.Net.FluentAssertions</AssemblyName>
         <PackageId>WireMock.Net.FluentAssertions</PackageId>
@@ -31,12 +32,8 @@
         <GeneratePackageOnBuild>true</GeneratePackageOnBuild>
     </PropertyGroup>
 
-    <ItemGroup Condition="'$(TargetFramework)' == 'net451' or '$(TargetFramework)' == 'netstandard1.3'">
-        <PackageReference Include="FluentAssertions" Version="5.10.3" />
-    </ItemGroup>
-
-    <ItemGroup Condition="'$(TargetFramework)' != 'net451' and '$(TargetFramework)' != 'netstandard1.3'">
-        <PackageReference Include="FluentAssertions" Version="6.5.1" />
+    <ItemGroup>
+        <PackageReference Include="FluentAssertions" Version="7.2.1" />
     </ItemGroup>
 
     <ItemGroup>

src/WireMock.Net.GraphQL/WireMock.Net.GraphQL.csproj

@@ -1,10 +1,11 @@
-<Project Sdk="Microsoft.NET.Sdk">
+<Project Sdk="Microsoft.NET.Sdk">
 
     <PropertyGroup>
         <Description>GraphQL support for WireMock.Net</Description>
         <AssemblyTitle>WireMock.Net.Matchers.GraphQL</AssemblyTitle>
         <Authors>Stef Heyenrath</Authors>
-        <TargetFrameworks>netstandard2.0;netstandard2.1;netcoreapp3.1;net5.0;net6.0;net8.0</TargetFrameworks>
+        <!--<TargetFrameworks>netstandard2.0;netstandard2.1;netcoreapp3.1;net5.0;net6.0;net8.0</TargetFrameworks>-->
+        <TargetFrameworks>net462;netstandard2.1;net8.0</TargetFrameworks>
         <GenerateDocumentationFile>true</GenerateDocumentationFile>
         <PackageTags>wiremock;matchers;matcher;graphql</PackageTags>
         <RootNamespace>WireMock</RootNamespace>
@@ -26,22 +27,11 @@
     </PropertyGroup>
 
     <ItemGroup>
-        <PackageReference Include="GraphQL.NewtonsoftJson" Version="8.2.1" />
-    </ItemGroup>
-
-    <ItemGroup Condition=" '$(TargetFramework)' == 'netstandard2.0' ">
-        <PackageReference Include="System.Reflection.Emit" Version="4.3.0" />
+        <PackageReference Include="GraphQL.NewtonsoftJson" Version="8.5.0" />
     </ItemGroup>
 
     <ItemGroup>
         <ProjectReference Include="..\WireMock.Net.Shared\WireMock.Net.Shared.csproj" />
     </ItemGroup>
 
-    <ItemGroup Condition=" '$(TargetFramework)' == 'netstandard2.0' ">
-        <PackageReference Include="Nullable" Version="1.3.1">
-            <PrivateAssets>all</PrivateAssets>
-            <IncludeAssets>runtime; build; native; contentfiles; analyzers; buildtransitive</IncludeAssets>
-        </PackageReference>
-    </ItemGroup>
-
 </Project>

src/WireMock.Net.Matchers.CSharpCode/Matchers/CSharpCodeMatcher.cs

@@ -108,72 +108,72 @@ public class CSharpCodeMatcher : ICSharpCodeMatcher
 
         object? result;
 
-#if (NET451 || NET452)
-        var compilerParams = new System.CodeDom.Compiler.CompilerParameters
-        {
-            GenerateInMemory = true,
-            GenerateExecutable = false,
-            ReferencedAssemblies =
-            {
-                "System.dll",
-                "System.Core.dll",
-                "Microsoft.CSharp.dll",
-                "Newtonsoft.Json.dll"
-            }
-        };
+        //#if (NET451 || NET452)
+        //        var compilerParams = new System.CodeDom.Compiler.CompilerParameters
+        //        {
+        //            GenerateInMemory = true,
+        //            GenerateExecutable = false,
+        //            ReferencedAssemblies =
+        //            {
+        //                "System.dll",
+        //                "System.Core.dll",
+        //                "Microsoft.CSharp.dll",
+        //                "Newtonsoft.Json.dll"
+        //            }
+        //        };
 
-        using (var codeProvider = new Microsoft.CSharp.CSharpCodeProvider())
-        {
-            var compilerResults = codeProvider.CompileAssemblyFromSource(compilerParams, source);
+        //        using (var codeProvider = new Microsoft.CSharp.CSharpCodeProvider())
+        //        {
+        //            var compilerResults = codeProvider.CompileAssemblyFromSource(compilerParams, source);
 
-            if (compilerResults.Errors.Count != 0)
-            {
-                var errors = from System.CodeDom.Compiler.CompilerError er in compilerResults.Errors select er.ToString();
-                throw new WireMockException(string.Join(", ", errors));
-            }
+        //            if (compilerResults.Errors.Count != 0)
+        //            {
+        //                var errors = from System.CodeDom.Compiler.CompilerError er in compilerResults.Errors select er.ToString();
+        //                throw new WireMockException(string.Join(", ", errors));
+        //            }
 
-            var helper = compilerResults.CompiledAssembly?.CreateInstance("CodeHelper");
-            if (helper == null)
-            {
-                throw new WireMockException("CSharpCodeMatcher: Unable to create instance from WireMock.CodeHelper");
-            }
+        //            var helper = compilerResults.CompiledAssembly?.CreateInstance("CodeHelper");
+        //            if (helper == null)
+        //            {
+        //                throw new WireMockException("CSharpCodeMatcher: Unable to create instance from WireMock.CodeHelper");
+        //            }
 
-            var methodInfo = helper.GetType().GetMethod("IsMatch");
-            if (methodInfo == null)
-            {
-                throw new WireMockException("CSharpCodeMatcher: Unable to find method 'IsMatch' in WireMock.CodeHelper");
-            }
+        //            var methodInfo = helper.GetType().GetMethod("IsMatch");
+        //            if (methodInfo == null)
+        //            {
+        //                throw new WireMockException("CSharpCodeMatcher: Unable to find method 'IsMatch' in WireMock.CodeHelper");
+        //            }
 
-            try
-            {
-                result = methodInfo.Invoke(helper, new[] { inputValue });
-            }
-            catch (Exception ex)
-            {
-                throw new WireMockException("CSharpCodeMatcher: Unable to call method 'IsMatch' in WireMock.CodeHelper", ex);
-            }
-        }
-#elif (NET46 || NET461)
-        dynamic script;
-        try
-        {
-            script = CSScriptLibrary.CSScript.Evaluator.CompileCode(source).CreateObject("*");
-        }
-        catch (Exception ex)
-        {
-            throw new WireMockException("CSharpCodeMatcher: Unable to create compiler for WireMock.CodeHelper", ex);
-        }
-        
-        try
-        {
-            result = script.IsMatch(inputValue);
-        }
-        catch (Exception ex)
-        {
-            throw new WireMockException("CSharpCodeMatcher: Problem calling method 'IsMatch' in WireMock.CodeHelper", ex);
-        }
+        //            try
+        //            {
+        //                result = methodInfo.Invoke(helper, new[] { inputValue });
+        //            }
+        //            catch (Exception ex)
+        //            {
+        //                throw new WireMockException("CSharpCodeMatcher: Unable to call method 'IsMatch' in WireMock.CodeHelper", ex);
+        //            }
+        //        }
+        //#elif (NET46 || net462)
+        //        dynamic script;
+        //        try
+        //        {
+        //            script = CSScriptLibrary.CSScript.Evaluator.CompileCode(source).CreateObject("*");
+        //        }
+        //        catch (Exception ex)
+        //        {
+        //            throw new WireMockException("CSharpCodeMatcher: Unable to create compiler for WireMock.CodeHelper", ex);
+        //        }
 
-#elif (NETSTANDARD2_0 || NETSTANDARD2_1 || NETCOREAPP3_1 || NET5_0_OR_GREATER)
+        //        try
+        //        {
+        //            result = script.IsMatch(inputValue);
+        //        }
+        //        catch (Exception ex)
+        //        {
+        //            throw new WireMockException("CSharpCodeMatcher: Problem calling method 'IsMatch' in WireMock.CodeHelper", ex);
+        //        }
+
+        //#elif (NETSTANDARD2_0 || NETSTANDARD2_1 || NETCOREAPP3_1 || NET5_0_OR_GREATER || NET48)
         Assembly assembly;
         try
         {
@@ -202,9 +202,9 @@ public class CSharpCodeMatcher : ICSharpCodeMatcher
         {
             throw new WireMockException("CSharpCodeMatcher: Problem calling method 'IsMatch' in WireMock.CodeHelper", ex);
         }
-#else
-        throw new NotSupportedException("The 'CSharpCodeMatcher' cannot be used in netstandard 1.3");
-#endif
+        //#else
+        //        throw new NotSupportedException("The 'CSharpCodeMatcher' cannot be used in netstandard 1.3");
+        //#endif
         try
         {
             return (bool)result;

src/WireMock.Net.Matchers.CSharpCode/WireMock.Net.Matchers.CSharpCode.csproj

@@ -1,10 +1,11 @@
-<Project Sdk="Microsoft.NET.Sdk">
+<Project Sdk="Microsoft.NET.Sdk">
 
     <PropertyGroup>
         <Description>A CSharpCodeMatcher which can be used to match WireMock.Net Requests using C# code.</Description>
         <AssemblyTitle>WireMock.Net.Matchers.CSharpCode</AssemblyTitle>
         <Authors>Stef Heyenrath</Authors>
-        <TargetFrameworks>net451;net452;net46;net461;netstandard1.3;netstandard2.0;netstandard2.1;netcoreapp3.1;net5.0;net6.0;net7.0;net8.0</TargetFrameworks>
+        <!--<TargetFrameworks>net451;net452;net46;net462;netstandard1.3;netstandard2.0;netstandard2.1;netcoreapp3.1;net5.0;net6.0;net7.0;net8.0</TargetFrameworks>-->
+        <TargetFrameworks>netstandard2.0</TargetFrameworks>
         <GenerateDocumentationFile>true</GenerateDocumentationFile>
         <PackageTags>wiremock;matchers;matcher;csharp;csharpcode</PackageTags>
         <RootNamespace>WireMock</RootNamespace>
@@ -37,16 +38,8 @@
         <ProjectReference Include="..\WireMock.Net.Minimal\WireMock.Net.Minimal.csproj" />
     </ItemGroup>
 
-    <ItemGroup Condition=" '$(TargetFramework)' == 'net451' or '$(TargetFramework)' == 'net452' ">
-        <PackageReference Include="Microsoft.CodeDom.Providers.DotNetCompilerPlatform" Version="3.6.0" />
-    </ItemGroup>
-
-    <ItemGroup Condition=" '$(TargetFramework)' == 'net46' or '$(TargetFramework)' == 'net461' ">
-        <PackageReference Include="CS-Script" Version="3.30.3" />
-    </ItemGroup>
-
-    <ItemGroup Condition=" '$(TargetFramework)' == 'netstandard2.0' or '$(TargetFramework)' == 'netstandard2.1' or '$(TargetFramework)' == 'netcoreapp3.1' or '$(TargetFramework)' == 'net5.0' or '$(TargetFramework)' == 'net6.0' or '$(TargetFramework)' == 'net7.0' or '$(TargetFramework)' == 'net8.0'">
-        <PackageReference Include="CS-Script" Version="4.8.17" />
+    <ItemGroup>
+        <PackageReference Include="CS-Script" Version="4.11.0" />
     </ItemGroup>
 
 </Project>

src/WireMock.Net.MimePart/Models/MimeMessageDataWrapper.cs

@@ -135,6 +135,6 @@ internal class MimeMessageDataWrapper : IMimeMessageData
     /// <inheritdoc/>
     public override string ToString()
     {
-        return _message.ToString();
+        return _message.ToString() ?? string.Empty;
     }
 }

src/WireMock.Net.MimePart/WireMock.Net.MimePart.csproj

@@ -1,10 +1,11 @@
-<Project Sdk="Microsoft.NET.Sdk">
+<Project Sdk="Microsoft.NET.Sdk">
 
     <PropertyGroup>
         <Description>MultiPart Mime support for WireMock.Net using MimeKitLite</Description>
         <AssemblyTitle>WireMock.Net.MimePart</AssemblyTitle>
         <Authors>Stef Heyenrath</Authors>
-        <TargetFrameworks>netstandard2.0;netstandard2.1;net462;net47;net48;net6.0;net8.0</TargetFrameworks>
+        <!--<TargetFrameworks>netstandard2.0;netstandard2.1;net462;net47;net48;net6.0;net8.0</TargetFrameworks>-->
+        <TargetFrameworks>netstandard2.0;net8.0</TargetFrameworks>
         <GenerateDocumentationFile>true</GenerateDocumentationFile>
         <PackageTags>wiremock;matchers;matcher;mime;multipart;mimekit</PackageTags>
         <RootNamespace>WireMock</RootNamespace>
@@ -36,24 +37,16 @@
     </PropertyGroup>
 
     <ItemGroup>
-        <PackageReference Include="Nullable" Version="1.3.1">
-          <PrivateAssets>all</PrivateAssets>
-          <IncludeAssets>runtime; build; native; contentfiles; analyzers; buildtransitive</IncludeAssets>
-        </PackageReference>
-        <PackageReference Include="Stef.Validation" Version="0.1.1" />
+        <PackageReference Include="Stef.Validation" Version="0.2.0" />
     </ItemGroup>
 
-    <!--<ItemGroup>
-        <PackageReference Include="MimeKitLite" Version="4.12.0" />
-    </ItemGroup>-->
-
     <ItemGroup Condition="'$(Configuration)' == 'Debug'">
-        <PackageReference Include="MimeKitLite" Version="4.12.0" />
+        <PackageReference Include="MimeKitLite" Version="4.13.0" />
     </ItemGroup>
 
     <ItemGroup Condition="'$(Configuration)' == 'Release'">
-        <PackageReference Include="ILRepack.Lib.MSBuild.Task" Version="2.0.40" PrivateAssets="All" />
-        <PackageReference Include="MimeKitLite" Version="4.12.0" PrivateAssets="All" />
+        <PackageReference Include="ILRepack.Lib.MSBuild.Task" Version="2.0.43" PrivateAssets="All" />
+        <PackageReference Include="MimeKitLite" Version="4.13.0" PrivateAssets="All" />
     </ItemGroup>
 
     <ItemGroup>

src/WireMock.Net.Minimal/Authentication/AzureADAuthenticationMatcher.cs

@@ -1,6 +1,5 @@
 // Copyright © WireMock.Net
 
-#if !NETSTANDARD1_3
 using System;
 using System.Diagnostics.CodeAnalysis;
 using System.IdentityModel.Tokens.Jwt;
@@ -111,5 +110,4 @@ internal class AzureADAuthenticationMatcher : IStringMatcher
         tenant = null;
         return false;
     }
-}
-#endif
+}

src/WireMock.Net.Minimal/Compatibility/StringExtensions.cs

@@ -1,6 +1,6 @@
 // Copyright © WireMock.Net
 
-#if NET451 || NET452 || NET46 || NET451 || NET461 || NETSTANDARD1_3 || NETSTANDARD2_0
+#if NET48
 using System.Text.RegularExpressions;
 using WireMock.Constants;
 

src/WireMock.Net.Minimal/Compatibility/WebProxy.cs

@@ -1,28 +0,0 @@
-// Copyright © WireMock.Net
-
-#if NETSTANDARD1_3
-
-// ReSharper disable once CheckNamespace
-namespace System.Net;
-
-internal class WebProxy : IWebProxy
-{
-    private readonly string _proxy;
-    public ICredentials? Credentials { get; set; }
-
-    public WebProxy(string proxy)
-    {
-        _proxy = proxy;
-    }
-
-    public Uri GetProxy(Uri destination)
-    {
-        return new Uri(_proxy);
-    }
-
-    public bool IsBypassed(Uri host)
-    {
-        return true;
-    }
-}
-#endif

src/WireMock.Net.Minimal/Http/HttpClientBuilder.cs

@@ -11,29 +11,18 @@ internal static class HttpClientBuilder
 {
     public static HttpClient Build(HttpClientSettings settings)
     {
-#if NETSTANDARD || NETCOREAPP3_1 || NET5_0_OR_GREATER
+#if NET8_0_OR_GREATER
         var handler = new HttpClientHandler
         {
             CheckCertificateRevocationList = false,
-#if NET5_0_OR_GREATER
             SslProtocols = System.Security.Authentication.SslProtocols.Tls13 | System.Security.Authentication.SslProtocols.Tls12 | System.Security.Authentication.SslProtocols.Tls11 | System.Security.Authentication.SslProtocols.Tls,
-#else
-            SslProtocols = System.Security.Authentication.SslProtocols.Tls12 | System.Security.Authentication.SslProtocols.Tls11 | System.Security.Authentication.SslProtocols.Tls,
-#endif
-            ServerCertificateCustomValidationCallback = (message, cert, chain, errors) => true,
-
+            ServerCertificateCustomValidationCallback = (_, _, _, _) => true,
             AutomaticDecompression = DecompressionMethods.GZip | DecompressionMethods.Deflate
         };
-#elif NET46
+#else
         var handler = new HttpClientHandler
         {
-            ServerCertificateCustomValidationCallback = (message, cert, chain, errors) => true,
-            AutomaticDecompression = DecompressionMethods.GZip | DecompressionMethods.Deflate
-        };
-#else
-        var handler = new WebRequestHandler
-        {
-            ServerCertificateValidationCallback = (sender, certificate, chain, errors) => true,
+            ServerCertificateCustomValidationCallback = (_, _, _, _) => true,
             AutomaticDecompression = DecompressionMethods.GZip | DecompressionMethods.Deflate
         };
 #endif
@@ -67,13 +56,12 @@ internal static class HttpClientBuilder
             }
         }
 
-#if NET5_0_OR_GREATER
+#if NET8_0_OR_GREATER
         ServicePointManager.SecurityProtocol = SecurityProtocolType.Tls13 | SecurityProtocolType.Tls12 | SecurityProtocolType.Tls11 | SecurityProtocolType.Tls;
-        ServicePointManager.ServerCertificateValidationCallback = (message, cert, chain, errors) => true;
-#elif !NETSTANDARD1_3
+#else
         ServicePointManager.SecurityProtocol = SecurityProtocolType.Tls12 | SecurityProtocolType.Tls11 | SecurityProtocolType.Tls;
-        ServicePointManager.ServerCertificateValidationCallback = (message, cert, chain, errors) => true;
 #endif
+        ServicePointManager.ServerCertificateValidationCallback = (message, cert, chain, errors) => true;
 
         return HttpClientFactory2.Create(handler);
     }

src/WireMock.Net.Minimal/Http/HttpClientFactory2.cs

@@ -28,7 +28,7 @@ internal static class HttpClientFactory2
 
         var next = handler;
 
-        foreach (var delegatingHandler in delegatingHandlers.Reverse())
+        foreach (var delegatingHandler in delegatingHandlers.ReverseEx())
         {
             delegatingHandler.InnerHandler = next;
             next = delegatingHandler;

src/WireMock.Net.Minimal/Http/WireMockHttpClientFactory.cs

@@ -1,5 +1,6 @@
 // Copyright © WireMock.Net
-#if NET5_0_OR_GREATER
+
+#if NET8_0_OR_GREATER
 using System;
 using System.Net.Http;
 using WireMock.Server;

src/WireMock.Net.Minimal/HttpsCertificate/CertificateLoader.cs

@@ -43,11 +43,8 @@ internal static class CertificateLoader
             }
             finally
             {
-#if NETSTANDARD || NET46
                 certStore.Dispose();
-#else
                 certStore.Close();
-#endif
             }
         }
 
@@ -56,7 +53,7 @@ internal static class CertificateLoader
             if (options.X509CertificateFilePath.EndsWith(ExtensionPem, StringComparison.OrdinalIgnoreCase))
             {
                 // PEM logic based on: https://www.scottbrady91.com/c-sharp/pem-loading-in-dotnet-core-and-dotnet
-#if NET5_0_OR_GREATER
+#if NET8_0_OR_GREATER
                 if (!string.IsNullOrEmpty(options.X509CertificatePassword))
                 {
                     var certPem = File.ReadAllText(options.X509CertificateFilePath);
@@ -66,18 +63,8 @@ internal static class CertificateLoader
                     return new X509Certificate2(cert.Export(X509ContentType.Pfx, defaultPasswordPem), defaultPasswordPem);
                 }
                 return X509Certificate2.CreateFromPemFile(options.X509CertificateFilePath);
-
-#elif NETCOREAPP3_1
-                var cert = new X509Certificate2(options.X509CertificateFilePath);
-                if (!string.IsNullOrEmpty(options.X509CertificatePassword))
-                {
-                    var key = System.Security.Cryptography.ECDsa.Create()!;
-                    key.ImportECPrivateKey(System.Text.Encoding.UTF8.GetBytes(options.X509CertificatePassword), out _);
-                    return cert.CopyWithPrivateKey(key);
-                }
-                return cert;
 #else                
-                throw new InvalidOperationException("Loading a PEM Certificate is only supported for .NET Core App 3.1, .NET 5.0 and higher.");
+                throw new InvalidOperationException("Loading a PEM Certificate is only supported for .NET 8.0 and higher.");
 #endif
             }
 
@@ -123,11 +110,8 @@ internal static class CertificateLoader
         }
         finally
         {
-#if NETSTANDARD || NET46
             certStore.Dispose();
-#else
             certStore.Close();
-#endif
         }
     }
 }

src/WireMock.Net.Minimal/Mapping.cs

@@ -2,6 +2,7 @@
 
 using System;
 using System.Threading.Tasks;
+using Microsoft.AspNetCore.Http;
 using Stef.Validation;
 using WireMock.Matchers.Request;
 using WireMock.Models;
@@ -145,9 +146,9 @@ public class Mapping : IMapping
     }
 
     /// <inheritdoc />
-    public Task<(IResponseMessage Message, IMapping? Mapping)> ProvideResponseAsync(IRequestMessage requestMessage)
+    public Task<(IResponseMessage Message, IMapping? Mapping)> ProvideResponseAsync(HttpContext context, IRequestMessage requestMessage)
     {
-        return Provider.ProvideResponseAsync(this, requestMessage, Settings);
+        return Provider.ProvideResponseAsync(this, context, requestMessage, Settings);
     }
 
     /// <inheritdoc />

src/WireMock.Net.Minimal/Matchers/FuncMatcher.cs

@@ -0,0 +1,85 @@
+// Copyright © WireMock.Net
+
+using Stef.Validation;
+using WireMock.Extensions;
+
+namespace WireMock.Matchers;
+
+/// <summary>
+/// FuncMatcher - matches using a custom function
+/// </summary>
+/// <inheritdoc cref="IFuncMatcher"/>
+public class FuncMatcher : IFuncMatcher
+{
+    private readonly Func<string?, bool>? _stringFunc;
+    private readonly Func<byte[]?, bool>? _bytesFunc;
+
+    /// <inheritdoc />
+    public MatchBehaviour MatchBehaviour { get; }
+
+    /// <summary>
+    /// Initializes a new instance of the <see cref="FuncMatcher"/> class for string matching.
+    /// </summary>
+    /// <param name="func">The function to check if a string is a match.</param>
+    /// <param name="matchBehaviour">The match behaviour.</param>
+    public FuncMatcher(Func<string?, bool> func, MatchBehaviour matchBehaviour = MatchBehaviour.AcceptOnMatch)
+    {
+        _stringFunc = Guard.NotNull(func);
+        MatchBehaviour = matchBehaviour;
+    }
+
+    /// <summary>
+    /// Initializes a new instance of the <see cref="FuncMatcher"/> class for byte array matching.
+    /// </summary>
+    /// <param name="func">The function to check if a byte[] is a match.</param>
+    /// <param name="matchBehaviour">The match behaviour.</param>
+    public FuncMatcher(Func<byte[]?, bool> func, MatchBehaviour matchBehaviour = MatchBehaviour.AcceptOnMatch)
+    {
+        _bytesFunc = Guard.NotNull(func);
+        MatchBehaviour = matchBehaviour;
+    }
+
+    /// <inheritdoc />
+    public MatchResult IsMatch(object? value)
+    {
+        if (value is string stringValue && _stringFunc != null)
+        {
+            try
+            {
+                return MatchResult.From(Name, MatchBehaviour, _stringFunc(stringValue));
+            }
+            catch (Exception ex)
+            {
+                return MatchResult.From(Name, ex);
+            }
+        }
+
+        if (value is byte[] bytesValue && _bytesFunc != null)
+        {
+            try
+            {
+                return MatchResult.From(Name, MatchBehaviour, _bytesFunc(bytesValue));
+            }
+            catch (Exception ex)
+            {
+                return MatchResult.From(Name, ex);
+            }
+        }
+
+        return MatchResult.From(Name, MatchScores.Mismatch);
+    }
+
+    /// <inheritdoc />
+    public string Name => nameof(FuncMatcher);
+
+    /// <inheritdoc />
+    public string GetCSharpCodeArguments()
+    {
+        var funcType = _stringFunc != null ? "Func<string?, bool>" : "Func<byte[]?, bool>";
+        return $"new {Name}" +
+               $"(" +
+               $"/* {funcType} function */, " +
+               $"{MatchBehaviour.GetFullyQualifiedEnumValue()}" +
+               $")";
+    }
+}

src/WireMock.Net.Minimal/Matchers/XPathMatcher.cs

@@ -11,9 +11,7 @@ using WireMock.Models;
 using Stef.Validation;
 using WireMock.Admin.Mappings;
 using WireMock.Util;
-#if !NETSTANDARD1_3
 using Wmhelp.XPath2;
-#endif
 
 namespace WireMock.Matchers;
 
@@ -135,7 +133,7 @@ public class XPathMatcher : IStringMatcher
             }
             catch
             {
-                _xmlDocument = default;
+                _xmlDocument = null;
             }
         }
 
@@ -151,25 +149,17 @@ public class XPathMatcher : IStringMatcher
             var xmlNamespaceManager = GetXmlNamespaceManager(xmlNamespaceMap);
             if (xmlNamespaceManager == null)
             {
-#if NETSTANDARD1_3
-                return navigator.Evaluate(xpath);
-#else
                 return navigator.XPath2Evaluate(xpath);
-#endif
             }
 
-#if NETSTANDARD1_3
-            return navigator.Evaluate(xpath, xmlNamespaceManager);
-#else
             return navigator.XPath2Evaluate(xpath, xmlNamespaceManager);
-#endif
         }
 
         private XmlNamespaceManager? GetXmlNamespaceManager(IEnumerable<XmlNamespace>? xmlNamespaceMap)
         {
             if (_xpathNavigator == null || xmlNamespaceMap == null)
             {
-                return default;
+                return null;
             }
 
             var nsManager = new XmlNamespaceManager(_xpathNavigator.NameTable);

src/WireMock.Net.Minimal/Owin/ActivityTracing/ActivityTracingOptions.cs

@@ -1,38 +0,0 @@
-// Copyright © WireMock.Net
-
-#if ACTIVITY_TRACING_SUPPORTED
-
-namespace WireMock.Owin.ActivityTracing;
-
-/// <summary>
-/// Options for controlling activity tracing in WireMock.Net middleware.
-/// These options control the creation of System.Diagnostics.Activity objects
-/// but do not require any OpenTelemetry exporter dependencies.
-/// </summary>
-public class ActivityTracingOptions
-{
-    /// <summary>
-    /// Gets or sets a value indicating whether to exclude admin interface requests from tracing.
-    /// Default is <c>true</c>.
-    /// </summary>
-    public bool ExcludeAdminRequests { get; set; } = true;
-
-    /// <summary>
-    /// Gets or sets a value indicating whether to record request body in trace attributes.
-    /// Default is <c>false</c> due to potential PII concerns.
-    /// </summary>
-    public bool RecordRequestBody { get; set; }
-
-    /// <summary>
-    /// Gets or sets a value indicating whether to record response body in trace attributes.
-    /// Default is <c>false</c> due to potential PII concerns.
-    /// </summary>
-    public bool RecordResponseBody { get; set; }
-
-    /// <summary>
-    /// Gets or sets a value indicating whether to record mapping match details in trace attributes.
-    /// Default is <c>true</c>.
-    /// </summary>
-    public bool RecordMatchDetails { get; set; } = true;
-}
-#endif

src/WireMock.Net.Minimal/Owin/ActivityTracing/ActivityTracingValidator.cs

@@ -1,34 +0,0 @@
-// Copyright © WireMock.Net
-
-#if !ACTIVITY_TRACING_SUPPORTED
-using System;
-#endif
-using WireMock.Settings;
-
-namespace WireMock.Owin.ActivityTracing;
-
-/// <summary>
-/// Validator for Activity Tracing configuration.
-/// </summary>
-internal static class ActivityTracingValidator
-{
-    /// <summary>
-    /// Validates that Activity Tracing is supported on the current framework.
-    /// Throws an exception if ActivityTracingOptions is configured on an unsupported framework.
-    /// </summary>
-    /// <param name="settings">The WireMock server settings to validate.</param>
-    /// <exception cref="System.InvalidOperationException">
-    /// Thrown when ActivityTracingOptions is configured but the current framework does not support System.Diagnostics.Activity.
-    /// </exception>
-    public static void ValidateActivityApiPresence(WireMockServerSettings settings)
-    {
-#if !ACTIVITY_TRACING_SUPPORTED
-        if (settings.ActivityTracingOptions is not null)
-        {
-            throw new InvalidOperationException(
-                "Activity Tracing is not supported on this target framework. " +
-                "It requires .NET 5.0 or higher which includes System.Diagnostics.Activity support.");
-        }
-#endif
-    }
-}

src/WireMock.Net.Minimal/Owin/ActivityTracing/WireMockActivitySource.cs

@@ -1,9 +1,9 @@
 // Copyright © WireMock.Net
 
-#if ACTIVITY_TRACING_SUPPORTED
 using System;
 using System.Diagnostics;
 using WireMock.Logging;
+using WireMock.Settings;
 
 namespace WireMock.Owin.ActivityTracing;
 
@@ -196,5 +196,4 @@ public static class WireMockActivitySource
         activity.SetTag("exception.message", exception.Message);
         activity.SetTag("exception.stacktrace", exception.ToString());
     }
-}
-#endif
+}

src/WireMock.Net.Minimal/Owin/AspNetCoreSelfHost.Cors.cs

@@ -1,6 +1,6 @@
 // Copyright © WireMock.Net
 
-#if NETCOREAPP3_1 || NET5_0_OR_GREATER
+#if NET8_0
 using Microsoft.AspNetCore.Builder;
 using Microsoft.Extensions.DependencyInjection;
 using WireMock.Types;
@@ -9,6 +9,8 @@ namespace WireMock.Owin;
 
 internal partial class AspNetCoreSelfHost
 {
+    private const string CorsPolicyName = "WireMock.Net - Policy";
+
     public void AddCors(IServiceCollection services)
     {
         if (_wireMockMiddlewareOptions.CorsPolicyOptions > CorsPolicyOptions.None)

src/WireMock.Net.Minimal/Owin/AspNetCoreSelfHost.NETStandard.cs

@@ -1,12 +1,10 @@
 // Copyright © WireMock.Net
 
-#if USE_ASPNETCORE && !NETSTANDARD1_3
 using System;
 using System.Collections.Generic;
 using System.Net;
 using Microsoft.AspNetCore.Hosting;
 using Microsoft.AspNetCore.Server.Kestrel.Core;
-using Microsoft.AspNetCore.Server.Kestrel.Https;
 using Microsoft.Extensions.Configuration;
 using Microsoft.Extensions.DependencyInjection;
 using CertificateLoader = WireMock.HttpsCertificate.CertificateLoader;
@@ -38,7 +36,7 @@ internal partial class AspNetCoreSelfHost
                             options.ServerCertificate = CertificateLoader.LoadCertificate(wireMockMiddlewareOptions, urlDetail.Host);
                         }
 
-                        options.ClientCertificateMode = (ClientCertificateMode)wireMockMiddlewareOptions.ClientCertificateMode;
+                        options.ClientCertificateMode = wireMockMiddlewareOptions.ClientCertificateMode;
                         if (wireMockMiddlewareOptions.AcceptAnyClientCertificate)
                         {
                             options.ClientCertificateValidation = (_, _, _) => true;
@@ -47,7 +45,7 @@ internal partial class AspNetCoreSelfHost
 
                     if (urlDetail.IsHttp2)
                     {
-                        listenOptions.Protocols = HttpProtocols.Http2;
+                        SetHttp2AsProtocolsOnListenOptions(listenOptions);
                     }
                 });
                 continue;
@@ -55,10 +53,7 @@ internal partial class AspNetCoreSelfHost
 
             if (urlDetail.IsHttp2)
             {
-                Listen(kestrelOptions, urlDetail, listenOptions =>
-                {
-                    listenOptions.Protocols = HttpProtocols.Http2;
-                });
+                Listen(kestrelOptions, urlDetail, SetHttp2AsProtocolsOnListenOptions);
                 continue;
             }
 
@@ -66,6 +61,15 @@ internal partial class AspNetCoreSelfHost
         }
     }
 
+    private static void SetHttp2AsProtocolsOnListenOptions(ListenOptions listenOptions)
+    {
+#if NET8_0_OR_GREATER
+        listenOptions.Protocols = HttpProtocols.Http2;
+#else
+        throw new NotSupportedException("HTTP/2 is only supported in .NET 8 or greater.");
+#endif
+    }
+
     private static void Listen(KestrelServerOptions kestrelOptions, HostUrlDetails urlDetail, Action<ListenOptions> configure)
     {
         // Listens on any IP with the given port.
@@ -111,5 +115,4 @@ internal static class IWebHostBuilderExtensions
             services.Configure<KestrelServerOptions>(context.Configuration.GetSection("Kestrel"));
         });
     }
-}
-#endif
+}

src/WireMock.Net.Minimal/Owin/AspNetCoreSelfHost.NETStandard13.cs

@@ -1,57 +0,0 @@
-// Copyright © WireMock.Net
-
-#if USE_ASPNETCORE && NETSTANDARD1_3
-using System.Collections.Generic;
-using Microsoft.AspNetCore.Hosting;
-using Microsoft.AspNetCore.Server.Kestrel;
-using Microsoft.AspNetCore.Server.Kestrel.Https;
-using Microsoft.Extensions.Configuration;
-using Microsoft.Extensions.DependencyInjection;
-using WireMock.HttpsCertificate;
-
-namespace WireMock.Owin;
-
-internal partial class AspNetCoreSelfHost
-{
-    private static void SetKestrelOptionsLimits(KestrelServerOptions options)
-    {
-        options.Limits.MaxRequestBufferSize = null;
-        options.Limits.MaxRequestHeaderCount = 100;
-        options.Limits.MaxResponseBufferSize = null;
-    }
-
-    private static void SetHttpsAndUrls(KestrelServerOptions options, IWireMockMiddlewareOptions wireMockMiddlewareOptions, IEnumerable<HostUrlDetails> urlDetails)
-    {
-        foreach (var urlDetail in urlDetails)
-        {
-            if (urlDetail.IsHttps)
-            {
-                options.UseHttps(new HttpsConnectionFilterOptions
-                {
-                    ServerCertificate = wireMockMiddlewareOptions.CustomCertificateDefined ? CertificateLoader.LoadCertificate(wireMockMiddlewareOptions, urlDetail.Host) : PublicCertificateHelper.GetX509Certificate2(),
-                    ClientCertificateMode = (ClientCertificateMode) wireMockMiddlewareOptions.ClientCertificateMode,
-                    ClientCertificateValidation = wireMockMiddlewareOptions.AcceptAnyClientCertificate ? (_, _, _) => true : null
-                });
-            }
-        }
-    }
-}
-
-internal static class IWebHostBuilderExtensions
-{
-    internal static IWebHostBuilder ConfigureAppConfigurationUsingEnvironmentVariables(this IWebHostBuilder builder) => builder;
-
-    internal static IWebHostBuilder ConfigureKestrelServerOptions(this IWebHostBuilder builder)
-    {
-        var configuration = new ConfigurationBuilder()
-            .AddEnvironmentVariables()
-            .Build();
-
-        return builder.ConfigureServices(services =>
-        {
-            services.Configure<KestrelServerOptions>(configuration.GetSection("Kestrel"));
-        });
-    }
-}
-
-#endif

src/WireMock.Net.Minimal/Owin/AspNetCoreSelfHost.cs

@@ -1,16 +1,10 @@
 // Copyright © WireMock.Net
 
-#if USE_ASPNETCORE
-using System;
-using System.Collections.Generic;
-using System.IO;
-using System.Linq;
-using System.Threading;
-using System.Threading.Tasks;
 using Microsoft.AspNetCore.Builder;
 using Microsoft.AspNetCore.Hosting;
 using Microsoft.Extensions.DependencyInjection;
 using Stef.Validation;
+using WireMock.Extensions;
 using WireMock.Logging;
 using WireMock.Owin.Mappers;
 using WireMock.Services;
@@ -18,25 +12,22 @@ using WireMock.Util;
 
 namespace WireMock.Owin;
 
-internal partial class AspNetCoreSelfHost : IOwinSelfHost
+internal partial class AspNetCoreSelfHost
 {
-    private const string CorsPolicyName = "WireMock.Net - Policy";
-
     private readonly CancellationTokenSource _cts = new();
     private readonly IWireMockMiddlewareOptions _wireMockMiddlewareOptions;
     private readonly IWireMockLogger _logger;
     private readonly HostUrlOptions _urlOptions;
 
-    private Exception _runningException;
     private IWebHost _host;
 
     public bool IsStarted { get; private set; }
 
-    public List<string> Urls { get; } = new();
+    public List<string> Urls { get; } = [];
 
-    public List<int> Ports { get; } = new();
+    public List<int> Ports { get; } = [];
 
-    public Exception RunningException => _runningException;
+    public Exception? RunningException { get; private set; }
 
     public AspNetCoreSelfHost(IWireMockMiddlewareOptions wireMockMiddlewareOptions, HostUrlOptions urlOptions)
     {
@@ -74,7 +65,7 @@ internal partial class AspNetCoreSelfHost : IOwinSelfHost
                 services.AddSingleton<IOwinResponseMapper, OwinResponseMapper>();
                 services.AddSingleton<IGuidUtils, GuidUtils>();
 
-#if NETCOREAPP3_1 || NET5_0_OR_GREATER
+#if NET8_0_OR_GREATER
                 AddCors(services);
 #endif
                 _wireMockMiddlewareOptions.AdditionalServiceRegistration?.Invoke(services);
@@ -83,8 +74,16 @@ internal partial class AspNetCoreSelfHost : IOwinSelfHost
             {
                 appBuilder.UseMiddleware<GlobalExceptionMiddleware>();
 
-#if NETCOREAPP3_1 || NET5_0_OR_GREATER
+#if NET8_0_OR_GREATER
                 UseCors(appBuilder);
+
+                var webSocketOptions = new WebSocketOptions();
+                if (_wireMockMiddlewareOptions.WebSocketSettings?.KeepAliveIntervalSeconds != null)
+                {
+                    webSocketOptions.KeepAliveInterval = TimeSpan.FromSeconds(_wireMockMiddlewareOptions.WebSocketSettings.KeepAliveIntervalSeconds);
+                }
+
+                appBuilder.UseWebSockets(webSocketOptions);
 #endif
                 _wireMockMiddlewareOptions.PreWireMockMiddlewareInit?.Invoke(appBuilder);
 
@@ -99,73 +98,76 @@ internal partial class AspNetCoreSelfHost : IOwinSelfHost
                 SetHttpsAndUrls(options, _wireMockMiddlewareOptions, _urlOptions.GetDetails());
             })
             .ConfigureKestrelServerOptions()
-
-#if NETSTANDARD1_3
-            .UseUrls(_urlOptions.GetDetails().Select(u => u.Url).ToArray())
-#endif
             .Build();
 
         return RunHost(_cts.Token);
     }
 
-        private Task RunHost(CancellationToken token)
+    private Task RunHost(CancellationToken token)
+    {
+        try
         {
-            try
-            {
-#if NETCOREAPP3_1 || NET5_0_OR_GREATER
-                var appLifetime = _host.Services.GetRequiredService<Microsoft.Extensions.Hosting.IHostApplicationLifetime>();
+#if NET8_0_OR_GREATER
+            var appLifetime = _host.Services.GetRequiredService<Microsoft.Extensions.Hosting.IHostApplicationLifetime>();
 #else
-                var appLifetime = _host.Services.GetRequiredService<IApplicationLifetime>();
+            var appLifetime = _host.Services.GetRequiredService<IApplicationLifetime>();
 #endif
-                appLifetime.ApplicationStarted.Register(() =>
-                {
-                    var addresses = _host.ServerFeatures
-                        .Get<Microsoft.AspNetCore.Hosting.Server.Features.IServerAddressesFeature>()!
-                        .Addresses;
+            appLifetime.ApplicationStarted.Register(() =>
+            {
+                var addresses = _host.ServerFeatures
+                    .Get<Microsoft.AspNetCore.Hosting.Server.Features.IServerAddressesFeature>()!
+                    .Addresses
+                    .ToArray();
 
+                if (_urlOptions.Urls == null)
+                {
                     foreach (var address in addresses)
                     {
-                        Urls.Add(address.Replace("0.0.0.0", "localhost").Replace("[::]", "localhost"));
+                        PortUtils.TryExtract(address, out _, out _, out var scheme, out var host, out var port);
 
-                        PortUtils.TryExtract(address, out _, out _, out _, out _, out var port);
+                        var replacedHost = ReplaceHostWithLocalhost(host!);
+                        var newUrl = $"{scheme}://{replacedHost}:{port}";
+                        Urls.Add(newUrl);
                         Ports.Add(port);
                     }
+                }
+                else
+                {
+                    var urlOptions = _urlOptions?.Urls?.ToArray() ?? [];
+
+                    for (int i = 0; i < urlOptions.Length; i++)
+                    {
+                        PortUtils.TryExtract(urlOptions[i], out _, out _, out var originalScheme, out _, out _);
+                        if (originalScheme!.StartsWith("grpc", StringComparison.OrdinalIgnoreCase))
+                        {
+                            // Always replace "grpc" with "http" in the scheme because GrpcChannel needs http or https.
+                            originalScheme = originalScheme.Replace("grpc", "http", StringComparison.OrdinalIgnoreCase);
+                        }
+
+                        PortUtils.TryExtract(addresses[i], out _, out _, out _, out var realHost, out var realPort);
+
+                        var replacedHost = ReplaceHostWithLocalhost(realHost!);
+                        var newUrl = $"{originalScheme}://{replacedHost}:{realPort}";
+
+                        Urls.Add(newUrl);
+                        Ports.Add(realPort);
+                    }
+                }
 
                 IsStarted = true;
             });
 
-#if NETSTANDARD1_3
-            _logger.Info("Server using netstandard1.3");
-#elif NETSTANDARD2_0
-            _logger.Info("Server using netstandard2.0");
-#elif NETSTANDARD2_1
-            _logger.Info("Server using netstandard2.1");
-#elif NETCOREAPP3_1
-            _logger.Info("Server using .NET Core App 3.1");
-#elif NET5_0
-            _logger.Info("Server using .NET 5.0");
-#elif NET6_0
-            _logger.Info("Server using .NET 6.0");
-#elif NET7_0
-            _logger.Info("Server using .NET 7.0");
-#elif NET8_0
+#if NET8_0
             _logger.Info("Server using .NET 8.0");
-#elif NET46
-            _logger.Info("Server using .NET Framework 4.6.1 or higher");
+#else
+            _logger.Info("Server using .NET Standard 2.0");
 #endif
 
-#if NETSTANDARD1_3
-            return Task.Run(() =>
-            {
-                _host.Run(token);
-            });
-#else
             return _host.RunAsync(token);
-#endif
         }
         catch (Exception e)
         {
-            _runningException = e;
+            RunningException = e;
             _logger.Error(e.ToString());
 
             IsStarted = false;
@@ -179,11 +181,11 @@ internal partial class AspNetCoreSelfHost : IOwinSelfHost
         _cts.Cancel();
 
         IsStarted = false;
-#if NETSTANDARD1_3
-        return Task.CompletedTask;
-#else
         return _host.StopAsync();
-#endif
     }
-}
-#endif
+
+    private static string ReplaceHostWithLocalhost(string host)
+    {
+        return host.Replace("0.0.0.0", "localhost").Replace("[::]", "localhost");
+    }
+}

src/WireMock.Net.Minimal/Owin/GlobalExceptionMiddleware.cs

@@ -3,68 +3,44 @@
 using System;
 using System.Threading.Tasks;
 using Newtonsoft.Json;
-#if !USE_ASPNETCORE
-using Microsoft.Owin;
-using IContext = Microsoft.Owin.IOwinContext;
-using OwinMiddleware = Microsoft.Owin.OwinMiddleware;
-using Next = Microsoft.Owin.OwinMiddleware;
-#else
-using OwinMiddleware = System.Object;
-using IContext = Microsoft.AspNetCore.Http.HttpContext;
-using Next = Microsoft.AspNetCore.Http.RequestDelegate;
-#endif
 using WireMock.Owin.Mappers;
 using Stef.Validation;
+using Microsoft.AspNetCore.Http;
 
-namespace WireMock.Owin
+namespace WireMock.Owin;
+
+internal class GlobalExceptionMiddleware
 {
-    internal class GlobalExceptionMiddleware : OwinMiddleware
+    private readonly IWireMockMiddlewareOptions _options;
+    private readonly IOwinResponseMapper _responseMapper;
+
+    public GlobalExceptionMiddleware(RequestDelegate next, IWireMockMiddlewareOptions options, IOwinResponseMapper responseMapper)
     {
-        private readonly IWireMockMiddlewareOptions _options;
-        private readonly IOwinResponseMapper _responseMapper;
+        Next = next;
+        _options = Guard.NotNull(options);
+        _responseMapper = Guard.NotNull(responseMapper);
+    }
 
-#if !USE_ASPNETCORE
-        public GlobalExceptionMiddleware(Next next, IWireMockMiddlewareOptions options, IOwinResponseMapper responseMapper) : base(next)
-        {
-            _options = Guard.NotNull(options);
-            _responseMapper = Guard.NotNull(responseMapper);;
-        }
-#else
-        public GlobalExceptionMiddleware(Next next, IWireMockMiddlewareOptions options, IOwinResponseMapper responseMapper)
-        {
-            Next = next;
-            _options = Guard.NotNull(options);
-            _responseMapper = Guard.NotNull(responseMapper);
-        }
-#endif
+    public RequestDelegate? Next { get; }
 
-#if USE_ASPNETCORE
-        public Next Next { get; }
-#endif
+    public Task Invoke(HttpContext ctx)
+    {
+        return InvokeInternalAsync(ctx);
+    }
 
-#if !USE_ASPNETCORE
-        public override Task Invoke(IContext ctx)
-#else
-        public Task Invoke(IContext ctx)
-#endif
+    private async Task InvokeInternalAsync(HttpContext ctx)
+    {
+        try
         {
-            return InvokeInternalAsync(ctx);
-        }
-
-        private async Task InvokeInternalAsync(IContext ctx)
-        {
-            try
+            if (Next != null)
             {
-                if (Next != null)
-                {
-                    await Next.Invoke(ctx).ConfigureAwait(false);
-                }
-            }
-            catch (Exception ex)
-            {
-                _options.Logger.Error("HttpStatusCode set to 500 {0}", ex);
-                await _responseMapper.MapAsync(ResponseMessageBuilder.Create(500, JsonConvert.SerializeObject(ex)), ctx.Response).ConfigureAwait(false);
+                await Next.Invoke(ctx).ConfigureAwait(false);
             }
         }
+        catch (Exception ex)
+        {
+            _options.Logger.Error("HttpStatusCode set to 500 {0}", ex);
+            await _responseMapper.MapAsync(ResponseMessageBuilder.Create(500, JsonConvert.SerializeObject(ex)), ctx.Response).ConfigureAwait(false);
+        }
     }
-}
+}

src/WireMock.Net.Minimal/Owin/HostUrlOptions.cs

@@ -1,6 +1,5 @@
 // Copyright © WireMock.Net
 
-using System.Collections.Generic;
 using WireMock.Types;
 using WireMock.Util;
 
@@ -23,20 +22,34 @@ internal class HostUrlOptions
         var list = new List<HostUrlDetails>();
         if (Urls == null)
         {
-            if (HostingScheme is HostingScheme.Http or HostingScheme.Https)
+            if (HostingScheme is not HostingScheme.None)
             {
-                var port = Port > 0 ? Port.Value : FindFreeTcpPort();
-                var scheme = HostingScheme == HostingScheme.Https ? "https" : "http";
-                list.Add(new HostUrlDetails { IsHttps = HostingScheme == HostingScheme.Https, IsHttp2 = UseHttp2 == true, Url = $"{scheme}://{Star}:{port}", Scheme = scheme, Host = Star, Port = port });
+                var scheme = GetSchemeAsString(HostingScheme);
+                var port = Port > 0 ? Port.Value : 0;
+                var isHttps = HostingScheme == HostingScheme.Https || HostingScheme == HostingScheme.Wss;
+                list.Add(new HostUrlDetails { IsHttps = isHttps, IsHttp2 = UseHttp2 == true, Url = $"{scheme}://{Star}:{port}", Scheme = scheme, Host = Star, Port = port });
             }
 
             if (HostingScheme == HostingScheme.HttpAndHttps)
             {
-                var httpPort = Port > 0 ? Port.Value : FindFreeTcpPort();
-                list.Add(new HostUrlDetails { IsHttps = false, IsHttp2 = UseHttp2 == true, Url = $"http://{Star}:{httpPort}", Scheme = "http", Host = Star, Port = httpPort });
+                var port = Port > 0 ? Port.Value : 0;
+                var scheme = GetSchemeAsString(HostingScheme.Http);
+                list.Add(new HostUrlDetails { IsHttps = false, IsHttp2 = UseHttp2 == true, Url = $"{scheme}://{Star}:{port}", Scheme = scheme, Host = Star, Port = port });
 
-                var httpsPort = FindFreeTcpPort(); // In this scenario, always get a free port for https.
-                list.Add(new HostUrlDetails { IsHttps = true, IsHttp2 = UseHttp2 == true, Url = $"https://{Star}:{httpsPort}", Scheme = "https", Host = Star, Port = httpsPort });
+                var securePort = 0; // In this scenario, always get a free port for https.
+                var secureScheme = GetSchemeAsString(HostingScheme.Https);
+                list.Add(new HostUrlDetails { IsHttps = true, IsHttp2 = UseHttp2 == true, Url = $"{secureScheme}://{Star}:{securePort}", Scheme = secureScheme, Host = Star, Port = securePort });
+            }
+
+            if (HostingScheme == HostingScheme.WsAndWss)
+            {
+                var port = Port > 0 ? Port.Value : 0;
+                var scheme = GetSchemeAsString(HostingScheme.Ws);
+                list.Add(new HostUrlDetails { IsHttps = false, IsHttp2 = UseHttp2 == true, Url = $"{scheme}://{Star}:{port}", Scheme = scheme, Host = Star, Port = port });
+
+                var securePort = 0; // In this scenario, always get a free port for https.
+                var secureScheme = GetSchemeAsString(HostingScheme.Wss);
+                list.Add(new HostUrlDetails { IsHttps = true, IsHttp2 = UseHttp2 == true, Url = $"{secureScheme}://{Star}:{securePort}", Scheme = secureScheme, Host = Star, Port = securePort });
             }
         }
         else
@@ -53,12 +66,19 @@ internal class HostUrlOptions
         return list;
     }
 
-    private static int FindFreeTcpPort()
+    private string GetSchemeAsString(HostingScheme scheme)
     {
-#if USE_ASPNETCORE || NETSTANDARD2_0 || NETSTANDARD2_1
-        return 0;
-#else
-        return PortUtils.FindFreeTcpPort();
-#endif
+        return scheme switch
+        {
+            HostingScheme.Http => "http",
+            HostingScheme.Https => "https",
+            HostingScheme.HttpAndHttps => "http", // Default to http when both are specified, since the https URL will be added separately with a free port.
+
+            HostingScheme.Ws => "ws",
+            HostingScheme.Wss => "wss",
+            HostingScheme.WsAndWss => "ws", // Default to ws when both are specified, since the wss URL will be added separately with a free port.
+
+            _ => throw new NotSupportedException($"Unsupported hosting scheme: {HostingScheme}")
+        };
     }
 }

src/WireMock.Net.Minimal/Owin/IOwinSelfHost.cs

@@ -1,37 +0,0 @@
-// Copyright © WireMock.Net
-
-using System.Collections.Generic;
-using System.Threading.Tasks;
-using System;
-
-namespace WireMock.Owin;
-
-interface IOwinSelfHost
-{
-    /// <summary>
-    /// Gets a value indicating whether this server is started.
-    /// </summary>
-    /// <value>
-    /// <c>true</c> if this server is started; otherwise, <c>false</c>.
-    /// </value>
-    bool IsStarted { get; }
-
-    /// <summary>
-    /// Gets the urls.
-    /// </summary>
-    List<string> Urls { get; }
-
-    /// <summary>
-    /// Gets the ports.
-    /// </summary>
-    List<int> Ports { get; }
-
-    /// <summary>
-    /// The exception occurred when the host is running.
-    /// </summary>
-    Exception? RunningException { get; }
-
-    Task StartAsync();
-
-    Task StopAsync();
-}

src/WireMock.Net.Minimal/Owin/IWireMockMiddlewareOptions.cs

@@ -2,22 +2,17 @@
 
 using System;
 using System.Collections.Concurrent;
+using System.Security.Cryptography.X509Certificates;
+using Microsoft.AspNetCore.Builder;
+using Microsoft.Extensions.DependencyInjection;
 using WireMock.Handlers;
 using WireMock.Logging;
 using WireMock.Matchers;
-using WireMock.Owin.ActivityTracing;
+using WireMock.Settings;
 using WireMock.Types;
 using WireMock.Util;
-using System.Security.Cryptography.X509Certificates;
-
-using JetBrains.Annotations;
-
-#if !USE_ASPNETCORE
-using Owin;
-#else
-using IAppBuilder = Microsoft.AspNetCore.Builder.IApplicationBuilder;
-using Microsoft.Extensions.DependencyInjection;
-#endif
+using WireMock.WebSockets;
+using ClientCertificateMode = Microsoft.AspNetCore.Server.Kestrel.Https.ClientCertificateMode;
 
 namespace WireMock.Owin;
 
@@ -41,11 +36,10 @@ internal interface IWireMockMiddlewareOptions
 
     int? MaxRequestLogCount { get; set; }
 
-    Action<IAppBuilder>? PreWireMockMiddlewareInit { get; set; }
+    Action<IApplicationBuilder>? PreWireMockMiddlewareInit { get; set; }
 
-    Action<IAppBuilder>? PostWireMockMiddlewareInit { get; set; }
+    Action<IApplicationBuilder>? PostWireMockMiddlewareInit { get; set; }
 
-#if USE_ASPNETCORE
     Action<IServiceCollection>? AdditionalServiceRegistration { get; set; }
 
     CorsPolicyOptions? CorsPolicyOptions { get; set; }
@@ -53,7 +47,6 @@ internal interface IWireMockMiddlewareOptions
     ClientCertificateMode ClientCertificateMode { get; set; }
 
     bool AcceptAnyClientCertificate { get; set; }
-#endif
 
     IFileSystemHandler? FileSystemHandler { get; set; }
 
@@ -90,13 +83,21 @@ internal interface IWireMockMiddlewareOptions
 
     QueryParameterMultipleValueSupport? QueryParameterMultipleValueSupport { get; set; }
 
-    public bool ProxyAll { get; set; }
+    bool ProxyAll { get; set; }
 
-#if ACTIVITY_TRACING_SUPPORTED
     /// <summary>
     /// Gets or sets the activity tracing options.
     /// When set, System.Diagnostics.Activity objects are created for request tracing.
     /// </summary>
     ActivityTracingOptions? ActivityTracingOptions { get; set; }
-#endif
+
+    /// <summary>
+    /// The WebSocket connection registries per mapping (used for broadcast).
+    /// </summary>
+    ConcurrentDictionary<Guid, WebSocketConnectionRegistry> WebSocketRegistries { get; }
+
+    /// <summary>
+    /// WebSocket settings.
+    /// </summary>
+    WebSocketSettings? WebSocketSettings { get; set; }
 }

src/WireMock.Net.Minimal/Owin/Mappers/IOwinRequestMapper.cs

@@ -1,25 +1,19 @@
 // Copyright © WireMock.Net
 
-using System.Threading.Tasks;
-#if !USE_ASPNETCORE
-using IRequest = Microsoft.Owin.IOwinRequest;
-#else
-using IRequest = Microsoft.AspNetCore.Http.HttpRequest;
-#endif
+using Microsoft.AspNetCore.Http;
 
-namespace WireMock.Owin.Mappers
+namespace WireMock.Owin.Mappers;
+
+/// <summary>
+/// IOwinRequestMapper
+/// </summary>
+internal interface IOwinRequestMapper
 {
     /// <summary>
-    /// IOwinRequestMapper
+    /// MapAsync IRequest to RequestMessage
     /// </summary>
-    internal interface IOwinRequestMapper
-    {
-        /// <summary>
-        /// MapAsync IRequest to RequestMessage
-        /// </summary>
-        /// <param name="request">The OwinRequest/HttpRequest</param>
-        /// <param name="options">The WireMockMiddlewareOptions</param>
-        /// <returns>RequestMessage</returns>
-        Task<RequestMessage> MapAsync(IRequest request, IWireMockMiddlewareOptions options);
-    }
+    /// <param name="context">The HttpContext</param>
+    /// <param name="options">The WireMockMiddlewareOptions</param>
+    /// <returns>RequestMessage</returns>
+    Task<RequestMessage> MapAsync(HttpContext context, IWireMockMiddlewareOptions options);
 }

src/WireMock.Net.Minimal/Owin/Mappers/IOwinResponseMapper.cs

@@ -1,11 +1,13 @@
 // Copyright © WireMock.Net
 
 using System.Threading.Tasks;
-#if !USE_ASPNETCORE
-using IResponse = Microsoft.Owin.IOwinResponse;
-#else
-using IResponse = Microsoft.AspNetCore.Http.HttpResponse;
-#endif
+using Microsoft.AspNetCore.Http;
+
+//#if !USE_ASPNETCORE
+//using IResponse = Microsoft.Owin.IOwinResponse;
+//#else
+//using IResponse = Microsoft.AspNetCore.Http.HttpResponse;
+//#endif
 
 namespace WireMock.Owin.Mappers;
 
@@ -18,6 +20,6 @@ internal interface IOwinResponseMapper
     /// Map ResponseMessage to IResponse.
     /// </summary>
     /// <param name="responseMessage">The ResponseMessage</param>
-    /// <param name="response">The OwinResponse/HttpResponse</param>
-    Task MapAsync(IResponseMessage? responseMessage, IResponse response);
-}
+    /// <param name="response">The HttpResponse</param>
+    Task MapAsync(IResponseMessage? responseMessage, HttpResponse response);
+}

src/WireMock.Net.Minimal/Owin/Mappers/OwinRequestMapper.cs

@@ -1,18 +1,10 @@
 // Copyright © WireMock.Net
 
-using System;
-using System.Collections.Generic;
-using System.Linq;
-using System.Threading.Tasks;
+using Microsoft.AspNetCore.Http;
+using Microsoft.AspNetCore.Http.Extensions;
 using WireMock.Http;
 using WireMock.Models;
 using WireMock.Util;
-#if !USE_ASPNETCORE
-using IRequest = Microsoft.Owin.IOwinRequest;
-#else
-using Microsoft.AspNetCore.Http.Extensions;
-using IRequest = Microsoft.AspNetCore.Http.HttpRequest;
-#endif
 
 namespace WireMock.Owin.Mappers;
 
@@ -22,8 +14,9 @@ namespace WireMock.Owin.Mappers;
 internal class OwinRequestMapper : IOwinRequestMapper
 {
     /// <inheritdoc />
-    public async Task<RequestMessage> MapAsync(IRequest request, IWireMockMiddlewareOptions options)
+    public async Task<RequestMessage> MapAsync(HttpContext context, IWireMockMiddlewareOptions options)
     {
+        var request = context.Request;
         var (urlDetails, clientIP) = ParseRequest(request);
 
         var method = request.Method;
@@ -73,22 +66,16 @@ internal class OwinRequestMapper : IOwinRequestMapper
             body,
             headers,
             cookies,
-            httpVersion
-#if USE_ASPNETCORE
-            , await request.HttpContext.Connection.GetClientCertificateAsync()
-#endif
-            )
+            httpVersion,
+            await request.HttpContext.Connection.GetClientCertificateAsync()
+        )
         {
             DateTime = DateTime.UtcNow
         };
     }
 
-    private static (UrlDetails UrlDetails, string ClientIP) ParseRequest(IRequest request)
+    private static (UrlDetails UrlDetails, string ClientIP) ParseRequest(HttpRequest request)
     {
-#if !USE_ASPNETCORE
-        var urlDetails = UrlUtils.Parse(request.Uri, request.PathBase);
-        var clientIP = request.RemoteIpAddress;
-#else
         var urlDetails = UrlUtils.Parse(new Uri(request.GetEncodedUrl()), request.PathBase);
 
         var connection = request.HttpContext.Connection;
@@ -105,7 +92,7 @@ internal class OwinRequestMapper : IOwinRequestMapper
         {
             clientIP = connection.RemoteIpAddress.ToString();
         }
-#endif
+
         return (urlDetails, clientIP);
     }
 }

src/WireMock.Net.Minimal/Owin/Mappers/OwinResponseMapper.cs

@@ -8,22 +8,17 @@ using System.Net;
 using System.Reflection;
 using System.Text;
 using System.Threading.Tasks;
+using Microsoft.AspNetCore.Http;
 using Newtonsoft.Json;
 using RandomDataGenerator.FieldOptions;
 using RandomDataGenerator.Randomizers;
+using Stef.Validation;
 using WireMock.Http;
 using WireMock.ResponseBuilders;
+using WireMock.ResponseProviders;
 using WireMock.Types;
-using Stef.Validation;
 using WireMock.Util;
 
-#if !USE_ASPNETCORE
-using IResponse = Microsoft.Owin.IOwinResponse;
-#else
-using Microsoft.AspNetCore.Http;
-using IResponse = Microsoft.AspNetCore.Http.HttpResponse;
-#endif
-
 namespace WireMock.Owin.Mappers
 {
     /// <summary>
@@ -37,8 +32,8 @@ namespace WireMock.Owin.Mappers
         private readonly Encoding _utf8NoBom = new UTF8Encoding(false);
 
         // https://msdn.microsoft.com/en-us/library/78h415ay(v=vs.110).aspx
-        private static readonly IDictionary<string, Action<IResponse, bool, WireMockList<string>>> ResponseHeadersToFix =
-            new Dictionary<string, Action<IResponse, bool, WireMockList<string>>>(StringComparer.OrdinalIgnoreCase)
+        private static readonly IDictionary<string, Action<HttpResponse, bool, WireMockList<string>>> ResponseHeadersToFix =
+            new Dictionary<string, Action<HttpResponse, bool, WireMockList<string>>>(StringComparer.OrdinalIgnoreCase)
             {
                 { HttpKnownHeaderNames.ContentType, (r, _, v) => r.ContentType = v.FirstOrDefault() },
                 { HttpKnownHeaderNames.ContentLength, (r, hasBody, v) =>
@@ -62,9 +57,9 @@ namespace WireMock.Owin.Mappers
         }
 
         /// <inheritdoc />
-        public async Task MapAsync(IResponseMessage? responseMessage, IResponse response)
+        public async Task MapAsync(IResponseMessage? responseMessage, HttpResponse response)
         {
-            if (responseMessage == null)
+            if (responseMessage == null || responseMessage is WebSocketHandledResponse)
             {
                 return;
             }
@@ -128,7 +123,7 @@ namespace WireMock.Owin.Mappers
             SetResponseTrailingHeaders(responseMessage, response);
         }
 
-        private static async Task HandleSseStringAsync(IResponseMessage responseMessage, IResponse response, IBodyData bodyData)
+        private static async Task HandleSseStringAsync(IResponseMessage responseMessage, HttpResponse response, IBodyData bodyData)
         {
             if (bodyData.SseStringQueue == null)
             {
@@ -202,7 +197,7 @@ namespace WireMock.Owin.Mappers
             return null;
         }
 
-        private static void SetResponseHeaders(IResponseMessage responseMessage, bool hasBody, IResponse response)
+        private static void SetResponseHeaders(IResponseMessage responseMessage, bool hasBody, HttpResponse response)
         {
             // Force setting the Date header (#577)
             AppendResponseHeader(
@@ -218,7 +213,7 @@ namespace WireMock.Owin.Mappers
                 var value = item.Value;
                 if (ResponseHeadersToFix.TryGetValue(headerName, out var action))
                 {
-                    action?.Invoke(response, hasBody, value);
+                    action.Invoke(response, hasBody, value);
                 }
                 else
                 {
@@ -231,7 +226,7 @@ namespace WireMock.Owin.Mappers
             }
         }
 
-        private static void SetResponseTrailingHeaders(IResponseMessage responseMessage, IResponse response)
+        private static void SetResponseTrailingHeaders(IResponseMessage responseMessage, HttpResponse response)
         {
             if (responseMessage.TrailingHeaders == null)
             {
@@ -239,13 +234,11 @@ namespace WireMock.Owin.Mappers
             }
 
 #if TRAILINGHEADERS
-            foreach (var item in responseMessage.TrailingHeaders)
+            foreach (var (headerName, value) in responseMessage.TrailingHeaders)
             {
-                var headerName = item.Key;
-                var value = item.Value;
                 if (ResponseHeadersToFix.TryGetValue(headerName, out var action))
                 {
-                    action?.Invoke(response, false, value);
+                    action.Invoke(response, false, value);
                 }
                 else
                 {
@@ -259,13 +252,9 @@ namespace WireMock.Owin.Mappers
 #endif
         }
 
-        private static void AppendResponseHeader(IResponse response, string headerName, string[] values)
+        private static void AppendResponseHeader(HttpResponse response, string headerName, string[] values)
         {
-#if !USE_ASPNETCORE
-            response.Headers.AppendValues(headerName, values);
-#else
             response.Headers.Append(headerName, values);
-#endif
         }
     }
 }

src/WireMock.Net.Minimal/Owin/OwinSelfHost.cs

@@ -1,114 +0,0 @@
-// Copyright © WireMock.Net
-
-#if !USE_ASPNETCORE
-using Microsoft.Owin.Hosting;
-using Owin;
-using System;
-using System.Collections.Generic;
-using System.Threading;
-using System.Threading.Tasks;
-using JetBrains.Annotations;
-using WireMock.Logging;
-using WireMock.Owin.Mappers;
-using Stef.Validation;
-using WireMock.Services;
-using WireMock.Util;
-
-namespace WireMock.Owin;
-
-internal class OwinSelfHost : IOwinSelfHost
-{
-    private readonly IWireMockMiddlewareOptions _options;
-    private readonly CancellationTokenSource _cts = new();
-    private readonly IWireMockLogger _logger;
-
-    private Exception? _runningException;
-
-    public OwinSelfHost(IWireMockMiddlewareOptions options, HostUrlOptions urlOptions)
-    {
-        Guard.NotNull(urlOptions);
-
-        _options = Guard.NotNull(options);
-        _logger = options.Logger ?? new WireMockConsoleLogger();
-
-        foreach (var detail in urlOptions.GetDetails())
-        {
-            Urls.Add(detail.Url);
-            Ports.Add(detail.Port);
-        }
-    }
-
-    public bool IsStarted { get; private set; }
-
-    public List<string> Urls { get; } = new();
-
-    public List<int> Ports { get; } = new();
-
-    public Exception? RunningException => _runningException;
-
-    [PublicAPI]
-    public Task StartAsync()
-    {
-        return Task.Run(StartServers, _cts.Token);
-    }
-
-    [PublicAPI]
-    public Task StopAsync()
-    {
-        _cts.Cancel();
-
-        return Task.FromResult(true);
-    }
-
-    private void StartServers()
-    {
-#if NET46
-        _logger.Info("Server using .net 4.6");
-#else
-        _logger.Info("Server using .net 4.5.x");
-#endif
-        var servers = new List<IDisposable>();
-
-        try
-        {
-            var requestMapper = new OwinRequestMapper();
-            var responseMapper = new OwinResponseMapper(_options);
-            var matcher = new MappingMatcher(_options, new RandomizerDoubleBetween0And1());
-            var guidUtils = new GuidUtils();
-
-            Action<IAppBuilder> startup = app =>
-            {
-                app.Use<GlobalExceptionMiddleware>(_options, responseMapper);
-                _options.PreWireMockMiddlewareInit?.Invoke(app);
-                app.Use<WireMockMiddleware>(_options, requestMapper, responseMapper, matcher, guidUtils);
-                _options.PostWireMockMiddlewareInit?.Invoke(app);
-            };
-
-            foreach (var url in Urls)
-            {
-                servers.Add(WebApp.Start(url, startup));
-            }
-
-            IsStarted = true;
-
-            // WaitHandle is signaled when the token is cancelled,
-            // which will be more efficient than Thread.Sleep in while loop
-            _cts.Token.WaitHandle.WaitOne();
-        }
-        catch (Exception e)
-        {
-            // Expose exception of starting host, otherwise it's hard to be troubleshooting if keeping quiet
-            // For example, WebApp.Start will fail with System.MissingMemberException if Microsoft.Owin.Host.HttpListener.dll is being located
-            // https://stackoverflow.com/questions/25090211/owin-httplistener-not-located/31369857
-            _runningException = e;
-            _logger.Error(e.ToString());
-        }
-        finally
-        {
-            IsStarted = false;
-            // Dispose all servers in finally block to make sure clean up allocated resource on error happening
-            servers.ForEach(s => s.Dispose());
-        }
-    }
-}
-#endif

src/WireMock.Net.Minimal/Owin/WireMockMiddleware.cs

@@ -1,431 +1,354 @@
 // Copyright © WireMock.Net
 
 using System;
-using System.Threading.Tasks;
+using System.Collections.Generic;
 using System.Linq;
 using System.Net;
+using System.Threading.Tasks;
+using Microsoft.AspNetCore.Http;
 using Stef.Validation;
-using WireMock.Logging;
-using WireMock.Matchers;
-using WireMock.Http;
-using WireMock.Owin.Mappers;
-using WireMock.Serialization;
-using WireMock.ResponseBuilders;
-using WireMock.Settings;
-using System.Collections.Generic;
 using WireMock.Constants;
 using WireMock.Exceptions;
+using WireMock.Http;
+using WireMock.Logging;
+using WireMock.Matchers;
+using WireMock.Owin.Mappers;
+using WireMock.ResponseBuilders;
+using WireMock.Serialization;
+using WireMock.Settings;
 using WireMock.Util;
-#if ACTIVITY_TRACING_SUPPORTED
 using System.Diagnostics;
 using WireMock.Owin.ActivityTracing;
-#endif
-#if !USE_ASPNETCORE
-using IContext = Microsoft.Owin.IOwinContext;
-using OwinMiddleware = Microsoft.Owin.OwinMiddleware;
-using Next = Microsoft.Owin.OwinMiddleware;
-#else
-using OwinMiddleware = System.Object;
-using IContext = Microsoft.AspNetCore.Http.HttpContext;
-using Next = Microsoft.AspNetCore.Http.RequestDelegate;
-using HandlebarsDotNet;
-using WireMock.Org.Abstractions;
-#endif
 
-namespace WireMock.Owin
+namespace WireMock.Owin;
+
+internal class WireMockMiddleware
 {
-    internal class WireMockMiddleware : OwinMiddleware
+    private readonly object _lock = new();
+
+    private readonly IWireMockMiddlewareOptions _options;
+    private readonly IOwinRequestMapper _requestMapper;
+    private readonly IOwinResponseMapper _responseMapper;
+    private readonly IMappingMatcher _mappingMatcher;
+    private readonly LogEntryMapper _logEntryMapper;
+    private readonly IGuidUtils _guidUtils;
+
+    public WireMockMiddleware(
+        RequestDelegate next,
+        IWireMockMiddlewareOptions options,
+        IOwinRequestMapper requestMapper,
+        IOwinResponseMapper responseMapper,
+        IMappingMatcher mappingMatcher,
+        IGuidUtils guidUtils
+    )
     {
-        private readonly object _lock = new();
-        private static readonly Task CompletedTask = Task.FromResult(false);
+        _options = Guard.NotNull(options);
+        _requestMapper = Guard.NotNull(requestMapper);
+        _responseMapper = Guard.NotNull(responseMapper);
+        _mappingMatcher = Guard.NotNull(mappingMatcher);
+        _logEntryMapper = new LogEntryMapper(options);
+        _guidUtils = Guard.NotNull(guidUtils);
+    }
 
-        private readonly IWireMockMiddlewareOptions _options;
-        private readonly IOwinRequestMapper _requestMapper;
-        private readonly IOwinResponseMapper _responseMapper;
-        private readonly IMappingMatcher _mappingMatcher;
-        private readonly LogEntryMapper _logEntryMapper;
-        private readonly IGuidUtils _guidUtils;
-
-#if !USE_ASPNETCORE
-        public WireMockMiddleware(
-            Next next,
-            IWireMockMiddlewareOptions options,
-            IOwinRequestMapper requestMapper,
-            IOwinResponseMapper responseMapper,
-            IMappingMatcher mappingMatcher,
-            IGuidUtils guidUtils
-        ) : base(next)
+    public Task Invoke(HttpContext ctx)
+    {
+        if (_options.HandleRequestsSynchronously.GetValueOrDefault(false))
         {
-            _options = Guard.NotNull(options);
-            _requestMapper = Guard.NotNull(requestMapper);
-            _responseMapper = Guard.NotNull(responseMapper);
-            _mappingMatcher = Guard.NotNull(mappingMatcher);
-            _logEntryMapper = new LogEntryMapper(options);
-            _guidUtils = Guard.NotNull(guidUtils);
-        }
-#else
-        public WireMockMiddleware(
-            Next next,
-            IWireMockMiddlewareOptions options,
-            IOwinRequestMapper requestMapper,
-            IOwinResponseMapper responseMapper,
-            IMappingMatcher mappingMatcher,
-            IGuidUtils guidUtils
-        )
-        {
-            _options = Guard.NotNull(options);
-            _requestMapper = Guard.NotNull(requestMapper);
-            _responseMapper = Guard.NotNull(responseMapper);
-            _mappingMatcher = Guard.NotNull(mappingMatcher);
-            _logEntryMapper = new LogEntryMapper(options);
-            _guidUtils = Guard.NotNull(guidUtils);
-        }
-#endif
-
-#if !USE_ASPNETCORE
-        public override Task Invoke(IContext ctx)
-#else
-        public Task Invoke(IContext ctx)
-#endif
-        {
-            if (_options.HandleRequestsSynchronously.GetValueOrDefault(false))
+            lock (_lock)
             {
-                lock (_lock)
+                return InvokeInternalAsync(ctx);
+            }
+        }
+
+        return InvokeInternalAsync(ctx);
+    }
+
+    private async Task InvokeInternalAsync(HttpContext ctx)
+    {
+        // Store options in HttpContext for providers to access (e.g., WebSocketResponseProvider)
+        ctx.Items[nameof(WireMockMiddlewareOptions)] = _options;
+
+        var request = await _requestMapper.MapAsync(ctx, _options).ConfigureAwait(false);
+
+        var logRequest = false;
+        IResponseMessage? response = null;
+        (MappingMatcherResult? Match, MappingMatcherResult? Partial) result = (null, null);
+
+        var tracingEnabled = _options.ActivityTracingOptions is not null;
+        var excludeAdmin = _options.ActivityTracingOptions?.ExcludeAdminRequests ?? true;
+        Activity? activity = null;
+
+        // Check if we should trace this request (optionally exclude admin requests)
+        var shouldTrace = tracingEnabled && !(excludeAdmin && request.Path.StartsWith("/__admin/"));
+
+        if (shouldTrace)
+        {
+            activity = WireMockActivitySource.StartRequestActivity(request.Method, request.Path);
+            WireMockActivitySource.EnrichWithRequest(activity, request, _options.ActivityTracingOptions);
+        }
+
+        try
+        {
+            foreach (var mapping in _options.Mappings.Values)
+            {
+                if (mapping.Scenario is null)
                 {
-                    return InvokeInternalAsync(ctx);
+                    continue;
+                }
+
+                // Set scenario start
+                if (!_options.Scenarios.ContainsKey(mapping.Scenario) && mapping.IsStartState)
+                {
+                    _options.Scenarios.TryAdd(mapping.Scenario, new ScenarioState
+                    {
+                        Name = mapping.Scenario
+                    });
                 }
             }
 
-            return InvokeInternalAsync(ctx);
-        }
+            result = _mappingMatcher.FindBestMatch(request);
 
-        private async Task InvokeInternalAsync(IContext ctx)
-        {
-            var request = await _requestMapper.MapAsync(ctx.Request, _options).ConfigureAwait(false);
-
-#if ACTIVITY_TRACING_SUPPORTED
-            // Start activity if ActivityTracingOptions is configured
-            var tracingEnabled = _options.ActivityTracingOptions is not null;
-            var excludeAdmin = _options.ActivityTracingOptions?.ExcludeAdminRequests ?? true;
-            Activity? activity = null;
-            
-            // Check if we should trace this request (optionally exclude admin requests)
-            var shouldTrace = tracingEnabled && !(excludeAdmin && request.Path.StartsWith("/__admin/"));
-            
-            if (shouldTrace)
+            var targetMapping = result.Match?.Mapping;
+            if (targetMapping == null)
             {
-                activity = WireMockActivitySource.StartRequestActivity(request.Method, request.Path);
-                WireMockActivitySource.EnrichWithRequest(activity, request, _options.ActivityTracingOptions);
+                logRequest = true;
+                _options.Logger.Warn("HttpStatusCode set to 404 : No matching mapping found");
+                response = ResponseMessageBuilder.Create(HttpStatusCode.NotFound, WireMockConstants.NoMatchingFound);
+                return;
             }
 
-            try
-            {
-                await InvokeInternalCoreAsync(ctx, request, activity).ConfigureAwait(false);
-            }
-            finally
-            {
-                activity?.Dispose();
-            }
-#else
-            await InvokeInternalCoreAsync(ctx, request).ConfigureAwait(false);
-#endif
-        }
+            logRequest = targetMapping.LogMapping;
 
-#if ACTIVITY_TRACING_SUPPORTED
-        private async Task InvokeInternalCoreAsync(IContext ctx, RequestMessage request, Activity? activity)
-#else
-        private async Task InvokeInternalCoreAsync(IContext ctx, RequestMessage request)
-#endif
-        {
-            var logRequest = false;
-            IResponseMessage? response = null;
-            (MappingMatcherResult? Match, MappingMatcherResult? Partial) result = (null, null);
-
-            try
+            if (targetMapping.IsAdminInterface && _options.AuthenticationMatcher != null && request.Headers != null)
             {
-                foreach (var mapping in _options.Mappings.Values)
+                var authorizationHeaderPresent = request.Headers.TryGetValue(HttpKnownHeaderNames.Authorization, out var authorization);
+                if (!authorizationHeaderPresent)
                 {
-                    if (mapping.Scenario is null)
-                    {
-                        continue;
-                    }
-
-                    // Set scenario start
-                    if (!_options.Scenarios.ContainsKey(mapping.Scenario) && mapping.IsStartState)
-                    {
-                        _options.Scenarios.TryAdd(mapping.Scenario, new ScenarioState
-                        {
-                            Name = mapping.Scenario
-                        });
-                    }
-                }
-
-                result = _mappingMatcher.FindBestMatch(request);
-
-                var targetMapping = result.Match?.Mapping;
-                if (targetMapping == null)
-                {
-                    logRequest = true;
-                    _options.Logger.Warn("HttpStatusCode set to 404 : No matching mapping found");
-                    response = ResponseMessageBuilder.Create(HttpStatusCode.NotFound, WireMockConstants.NoMatchingFound);
+                    _options.Logger.Error("HttpStatusCode set to 401, authorization header is missing.");
+                    response = ResponseMessageBuilder.Create(HttpStatusCode.Unauthorized, null);
                     return;
                 }
 
-#if USE_ASPNETCORE && NET8_0_OR_GREATER
-                if (ctx.WebSockets.IsWebSocketRequest)
+                var authorizationHeaderMatchResult = _options.AuthenticationMatcher.IsMatch(authorization!.ToString());
+                if (!MatchScores.IsPerfect(authorizationHeaderMatchResult.Score))
                 {
-                    // Accept WebSocket upgrade
-                    var webSocket = await ctx.WebSockets.AcceptWebSocketAsync();
-
-                    // Get and invoke handler
-                    var provider = targetMapping.Provider as WireMock.WebSockets.ResponseProviders.WebSocketResponseProvider;
-                    await provider.HandleWebSocketAsync(webSocket, request);
-
-                    return;  // Don't process as HTTP
+                    _options.Logger.Error("HttpStatusCode set to 401, authentication failed.", authorizationHeaderMatchResult.Exception ?? throw new WireMockException("Authentication failed"));
+                    response = ResponseMessageBuilder.Create(HttpStatusCode.Unauthorized, null);
+                    return;
                 }
-#endif
+            }
 
-                logRequest = targetMapping.LogMapping;
+            if (!targetMapping.IsAdminInterface && _options.RequestProcessingDelay > TimeSpan.Zero)
+            {
+                await Task.Delay(_options.RequestProcessingDelay.Value).ConfigureAwait(false);
+            }
 
-                if (targetMapping.IsAdminInterface && _options.AuthenticationMatcher != null && request.Headers != null)
+            var (theResponse, theOptionalNewMapping) = await targetMapping.ProvideResponseAsync(ctx, request).ConfigureAwait(false);
+            response = theResponse;
+
+            if (targetMapping.Provider is Response responseBuilder && !targetMapping.IsAdminInterface && theOptionalNewMapping != null)
+            {
+                if (responseBuilder?.ProxyAndRecordSettings?.SaveMapping == true || targetMapping.Settings.ProxyAndRecordSettings?.SaveMapping == true)
                 {
-                    var authorizationHeaderPresent = request.Headers.TryGetValue(HttpKnownHeaderNames.Authorization, out var authorization);
-                    if (!authorizationHeaderPresent)
-                    {
-                        _options.Logger.Error("HttpStatusCode set to 401, authorization header is missing.");
-                        response = ResponseMessageBuilder.Create(HttpStatusCode.Unauthorized, null);
-                        return;
-                    }
-
-                    var authorizationHeaderMatchResult = _options.AuthenticationMatcher.IsMatch(authorization!.ToString());
-                    if (!MatchScores.IsPerfect(authorizationHeaderMatchResult.Score))
-                    {
-                        _options.Logger.Error("HttpStatusCode set to 401, authentication failed.", authorizationHeaderMatchResult.Exception ?? throw new WireMockException("Authentication failed"));
-                        response = ResponseMessageBuilder.Create(HttpStatusCode.Unauthorized, null);
-                        return;
-                    }
+                    _options.Mappings.TryAdd(theOptionalNewMapping.Guid, theOptionalNewMapping);
                 }
 
-                if (!targetMapping.IsAdminInterface && _options.RequestProcessingDelay > TimeSpan.Zero)
+                if (responseBuilder?.ProxyAndRecordSettings?.SaveMappingToFile == true || targetMapping.Settings.ProxyAndRecordSettings?.SaveMappingToFile == true)
                 {
-                    await Task.Delay(_options.RequestProcessingDelay.Value).ConfigureAwait(false);
+                    var matcherMapper = new MatcherMapper(targetMapping.Settings);
+                    var mappingConverter = new MappingConverter(matcherMapper);
+                    var mappingToFileSaver = new MappingToFileSaver(targetMapping.Settings, mappingConverter);
+
+                    mappingToFileSaver.SaveMappingToFile(theOptionalNewMapping);
                 }
+            }
 
-                var (theResponse, theOptionalNewMapping) = await targetMapping.ProvideResponseAsync(request).ConfigureAwait(false);
-                response = theResponse;
+            if (targetMapping.Scenario != null)
+            {
+                UpdateScenarioState(targetMapping);
+            }
 
-                var responseBuilder = targetMapping.Provider as Response;
+            if (!targetMapping.IsAdminInterface && targetMapping.Webhooks?.Length > 0)
+            {
+                await SendToWebhooksAsync(targetMapping, request, response).ConfigureAwait(false);
+            }
+        }
+        catch (Exception ex)
+        {
+            _options.Logger.Error($"Providing a Response for Mapping '{result.Match?.Mapping.Guid}' failed. HttpStatusCode set to 500. Exception: {ex}");
+            WireMockActivitySource.RecordException(activity, ex);
 
-                if (!targetMapping.IsAdminInterface && theOptionalNewMapping != null)
+            response = ResponseMessageBuilder.Create(500, ex.Message);
+        }
+        finally
+        {
+            var log = new LogEntry
+            {
+                Guid = _guidUtils.NewGuid(),
+                RequestMessage = request,
+                ResponseMessage = response,
+
+                MappingGuid = result.Match?.Mapping?.Guid,
+                MappingTitle = result.Match?.Mapping?.Title,
+                RequestMatchResult = result.Match?.RequestMatchResult,
+
+                PartialMappingGuid = result.Partial?.Mapping?.Guid,
+                PartialMappingTitle = result.Partial?.Mapping?.Title,
+                PartialMatchResult = result.Partial?.RequestMatchResult
+            };
+
+            WireMockActivitySource.EnrichWithLogEntry(activity, log, _options.ActivityTracingOptions);
+            activity?.Dispose();
+
+            LogRequest(log, logRequest);
+
+            try
+            {
+                if (_options.SaveUnmatchedRequests == true && result.Match?.RequestMatchResult is not { IsPerfectMatch: true })
                 {
-                    if (responseBuilder?.ProxyAndRecordSettings?.SaveMapping == true || targetMapping.Settings.ProxyAndRecordSettings?.SaveMapping == true)
-                    {
-                        _options.Mappings.TryAdd(theOptionalNewMapping.Guid, theOptionalNewMapping);
-                    }
-
-                    if (responseBuilder?.ProxyAndRecordSettings?.SaveMappingToFile == true || targetMapping.Settings.ProxyAndRecordSettings?.SaveMappingToFile == true)
-                    {
-                        var matcherMapper = new MatcherMapper(targetMapping.Settings);
-                        var mappingConverter = new MappingConverter(matcherMapper);
-                        var mappingToFileSaver = new MappingToFileSaver(targetMapping.Settings, mappingConverter);
-
-                        mappingToFileSaver.SaveMappingToFile(theOptionalNewMapping);
-                    }
+                    var filename = $"{log.Guid}.LogEntry.json";
+                    _options.FileSystemHandler?.WriteUnmatchedRequest(filename, JsonUtils.Serialize(log));
                 }
+            }
+            catch
+            {
+                // Empty catch
+            }
 
-                if (targetMapping.Scenario != null)
-                {
-                    UpdateScenarioState(targetMapping);
-                }
-
-                if (!targetMapping.IsAdminInterface && targetMapping.Webhooks?.Length > 0)
-                {
-                    await SendToWebhooksAsync(targetMapping, request, response).ConfigureAwait(false);
-                }
+            try
+            {
+                await _responseMapper.MapAsync(response, ctx.Response).ConfigureAwait(false);
             }
             catch (Exception ex)
             {
-                _options.Logger.Error($"Providing a Response for Mapping '{result.Match?.Mapping.Guid}' failed. HttpStatusCode set to 500. Exception: {ex}");
-                response = ResponseMessageBuilder.Create(500, ex.Message);
+                _options.Logger.Error("HttpStatusCode set to 404 : No matching mapping found", ex);
 
-#if ACTIVITY_TRACING_SUPPORTED
-                WireMockActivitySource.RecordException(activity, ex);
-#endif
-            }
-            finally
-            {
-                var log = new LogEntry
-                {
-                    Guid = _guidUtils.NewGuid(),
-                    RequestMessage = request,
-                    ResponseMessage = response,
-
-                    MappingGuid = result.Match?.Mapping?.Guid,
-                    MappingTitle = result.Match?.Mapping?.Title,
-                    RequestMatchResult = result.Match?.RequestMatchResult,
-
-                    PartialMappingGuid = result.Partial?.Mapping?.Guid,
-                    PartialMappingTitle = result.Partial?.Mapping?.Title,
-                    PartialMatchResult = result.Partial?.RequestMatchResult
-                };
-
-#if ACTIVITY_TRACING_SUPPORTED
-                // Enrich activity with response and mapping info
-                WireMockActivitySource.EnrichWithLogEntry(activity, log, _options.ActivityTracingOptions);
-#endif
-
-                LogRequest(log, logRequest);
-
-                try
-                {
-                    if (_options.SaveUnmatchedRequests == true && result.Match?.RequestMatchResult is not { IsPerfectMatch: true })
-                    {
-                        var filename = $"{log.Guid}.LogEntry.json";
-                        _options.FileSystemHandler?.WriteUnmatchedRequest(filename, JsonUtils.Serialize(log));
-                    }
-                }
-                catch
-                {
-                    // Empty catch
-                }
-
-                try
-                {
-                    await _responseMapper.MapAsync(response, ctx.Response).ConfigureAwait(false);
-                }
-                catch (Exception ex)
-                {
-                    _options.Logger.Error("HttpStatusCode set to 404 : No matching mapping found", ex);
-
-                    var notFoundResponse = ResponseMessageBuilder.Create(HttpStatusCode.NotFound, WireMockConstants.NoMatchingFound);
-                    await _responseMapper.MapAsync(notFoundResponse, ctx.Response).ConfigureAwait(false);
-                }
-            }
-
-            await CompletedTask.ConfigureAwait(false);
-        }
-
-        private async Task SendToWebhooksAsync(IMapping mapping, IRequestMessage request, IResponseMessage response)
-        {
-            var tasks = new List<Func<Task>>();
-            for (int index = 0; index < mapping.Webhooks?.Length; index++)
-            {
-                var httpClientForWebhook = HttpClientBuilder.Build(mapping.Settings.WebhookSettings ?? new WebhookSettings());
-                var webhookSender = new WebhookSender(mapping.Settings);
-                var webhookRequest = mapping.Webhooks[index].Request;
-                var webHookIndex = index;
-
-                tasks.Add(async () =>
-                {
-                    try
-                    {
-                        var result = await webhookSender.SendAsync(httpClientForWebhook, mapping, webhookRequest, request, response).ConfigureAwait(false);
-                        if (!result.IsSuccessStatusCode)
-                        {
-                            var content = await result.Content.ReadAsStringAsync().ConfigureAwait(false);
-                            _options.Logger.Warn($"Sending message to Webhook [{webHookIndex}] from Mapping '{mapping.Guid}' failed. HttpStatusCode: {result.StatusCode} Content: {content}");
-                        }
-                    }
-                    catch (Exception ex)
-                    {
-                        _options.Logger.Error($"Sending message to Webhook [{webHookIndex}] from Mapping '{mapping.Guid}' failed. Exception: {ex}");
-                    }
-                });
-            }
-
-            if (mapping.UseWebhooksFireAndForget == true)
-            {
-                try
-                {
-                    // Do not wait
-                    await Task.Run(() =>
-                    {
-                        Task.WhenAll(tasks.Select(async task => await task.Invoke())).ConfigureAwait(false);
-                    });
-                }
-                catch
-                {
-                    // Ignore
-                }
-            }
-            else
-            {
-                await Task.WhenAll(tasks.Select(async task => await task.Invoke())).ConfigureAwait(false);
-            }
-        }
-
-        private void UpdateScenarioState(IMapping mapping)
-        {
-            var scenario = _options.Scenarios[mapping.Scenario!];
-
-            // Increase the number of times this state has been executed
-            scenario.Counter++;
-
-            // Only if the number of times this state is executed equals the required StateTimes, proceed to next state and reset the counter to 0
-            if (scenario.Counter == (mapping.TimesInSameState ?? 1))
-            {
-                scenario.NextState = mapping.NextState;
-                scenario.Counter = 0;
-            }
-
-            // Else just update Started and Finished
-            scenario.Started = true;
-            scenario.Finished = mapping.NextState == null;
-        }
-
-        private void LogRequest(LogEntry entry, bool addRequest)
-        {
-            _options.Logger.DebugRequestResponse(_logEntryMapper.Map(entry), entry.RequestMessage.Path.StartsWith("/__admin/"));
-
-            // If addRequest is set to true and MaxRequestLogCount is null or does have a value greater than 0, try to add a new request log.
-            if (addRequest && _options.MaxRequestLogCount is null or > 0)
-            {
-                TryAddLogEntry(entry);
-            }
-
-            // In case MaxRequestLogCount has a value greater than 0, try to delete existing request logs based on the count.
-            if (_options.MaxRequestLogCount is > 0)
-            {
-                var logEntries = _options.LogEntries.ToList();
-                foreach (var logEntry in logEntries.OrderBy(le => le.RequestMessage.DateTime).Take(logEntries.Count - _options.MaxRequestLogCount.Value))
-                {
-                    TryRemoveLogEntry(logEntry);
-                }
-            }
-
-            // In case RequestLogExpirationDuration has a value greater than 0, try to delete existing request logs based on the date.
-            if (_options.RequestLogExpirationDuration is > 0)
-            {
-                var checkTime = DateTime.UtcNow.AddHours(-_options.RequestLogExpirationDuration.Value);
-                foreach (var logEntry in _options.LogEntries.ToList().Where(le => le.RequestMessage.DateTime < checkTime))
-                {
-                    TryRemoveLogEntry(logEntry);
-                }
-            }
-        }
-
-        private void TryAddLogEntry(LogEntry logEntry)
-        {
-            try
-            {
-                _options.LogEntries.Add(logEntry);
-            }
-            catch
-            {
-                // Ignore exception (can happen during stress testing)
-            }
-        }
-
-        private void TryRemoveLogEntry(LogEntry logEntry)
-        {
-            try
-            {
-                _options.LogEntries.Remove(logEntry);
-            }
-            catch
-            {
-                // Ignore exception (can happen during stress testing)
+                var notFoundResponse = ResponseMessageBuilder.Create(HttpStatusCode.NotFound, WireMockConstants.NoMatchingFound);
+                await _responseMapper.MapAsync(notFoundResponse, ctx.Response).ConfigureAwait(false);
             }
         }
     }
-}
+
+    private async Task SendToWebhooksAsync(IMapping mapping, IRequestMessage request, IResponseMessage response)
+    {
+        var tasks = new List<Func<Task>>();
+        for (int index = 0; index < mapping.Webhooks?.Length; index++)
+        {
+            var httpClientForWebhook = HttpClientBuilder.Build(mapping.Settings.WebhookSettings ?? new WebhookSettings());
+            var webhookSender = new WebhookSender(mapping.Settings);
+            var webhookRequest = mapping.Webhooks[index].Request;
+            var webHookIndex = index;
+
+            tasks.Add(async () =>
+            {
+                try
+                {
+                    var result = await webhookSender.SendAsync(httpClientForWebhook, mapping, webhookRequest, request, response).ConfigureAwait(false);
+                    if (!result.IsSuccessStatusCode)
+                    {
+                        var content = await result.Content.ReadAsStringAsync().ConfigureAwait(false);
+                        _options.Logger.Warn($"Sending message to Webhook [{webHookIndex}] from Mapping '{mapping.Guid}' failed. HttpStatusCode: {result.StatusCode} Content: {content}");
+                    }
+                }
+                catch (Exception ex)
+                {
+                    _options.Logger.Error($"Sending message to Webhook [{webHookIndex}] from Mapping '{mapping.Guid}' failed. Exception: {ex}");
+                }
+            });
+        }
+
+        if (mapping.UseWebhooksFireAndForget == true)
+        {
+            try
+            {
+                // Do not wait
+                await Task.Run(() =>
+                {
+                    Task.WhenAll(tasks.Select(async task => await task.Invoke())).ConfigureAwait(false);
+                });
+            }
+            catch
+            {
+                // Ignore
+            }
+        }
+        else
+        {
+            await Task.WhenAll(tasks.Select(async task => await task.Invoke())).ConfigureAwait(false);
+        }
+    }
+
+    private void UpdateScenarioState(IMapping mapping)
+    {
+        var scenario = _options.Scenarios[mapping.Scenario!];
+
+        // Increase the number of times this state has been executed
+        scenario.Counter++;
+
+        // Only if the number of times this state is executed equals the required StateTimes, proceed to next state and reset the counter to 0
+        if (scenario.Counter == (mapping.TimesInSameState ?? 1))
+        {
+            scenario.NextState = mapping.NextState;
+            scenario.Counter = 0;
+        }
+
+        // Else just update Started and Finished
+        scenario.Started = true;
+        scenario.Finished = mapping.NextState == null;
+    }
+
+    private void LogRequest(LogEntry entry, bool addRequest)
+    {
+        _options.Logger.DebugRequestResponse(_logEntryMapper.Map(entry), entry.RequestMessage.Path.StartsWith("/__admin/"));
+
+        // If addRequest is set to true and MaxRequestLogCount is null or does have a value greater than 0, try to add a new request log.
+        if (addRequest && _options.MaxRequestLogCount is null or > 0)
+        {
+            TryAddLogEntry(entry);
+        }
+
+        // In case MaxRequestLogCount has a value greater than 0, try to delete existing request logs based on the count.
+        if (_options.MaxRequestLogCount is > 0)
+        {
+            var logEntries = _options.LogEntries.ToList();
+            foreach (var logEntry in logEntries.OrderBy(le => le.RequestMessage.DateTime).Take(logEntries.Count - _options.MaxRequestLogCount.Value))
+            {
+                TryRemoveLogEntry(logEntry);
+            }
+        }
+
+        // In case RequestLogExpirationDuration has a value greater than 0, try to delete existing request logs based on the date.
+        if (_options.RequestLogExpirationDuration is > 0)
+        {
+            var checkTime = DateTime.UtcNow.AddHours(-_options.RequestLogExpirationDuration.Value);
+            foreach (var logEntry in _options.LogEntries.ToList().Where(le => le.RequestMessage.DateTime < checkTime))
+            {
+                TryRemoveLogEntry(logEntry);
+            }
+        }
+    }
+
+    private void TryAddLogEntry(LogEntry logEntry)
+    {
+        try
+        {
+            _options.LogEntries.Add(logEntry);
+        }
+        catch
+        {
+            // Ignore exception (can happen during stress testing)
+        }
+    }
+
+    private void TryRemoveLogEntry(LogEntry logEntry)
+    {
+        try
+        {
+            _options.LogEntries.Remove(logEntry);
+        }
+        catch
+        {
+            // Ignore exception (can happen during stress testing)
+        }
+    }
+}

src/WireMock.Net.Minimal/Owin/WireMockMiddlewareOptions.cs

@@ -2,20 +2,17 @@
 
 using System;
 using System.Collections.Concurrent;
+using System.Security.Cryptography.X509Certificates;
+using Microsoft.AspNetCore.Builder;
+using Microsoft.Extensions.DependencyInjection;
 using WireMock.Handlers;
 using WireMock.Logging;
 using WireMock.Matchers;
-using WireMock.Owin.ActivityTracing;
+using WireMock.Settings;
 using WireMock.Types;
 using WireMock.Util;
-using System.Security.Cryptography.X509Certificates;
-
-#if !USE_ASPNETCORE
-using Owin;
-#else
-using IAppBuilder = Microsoft.AspNetCore.Builder.IApplicationBuilder;
-using Microsoft.Extensions.DependencyInjection;
-#endif
+using WireMock.WebSockets;
+using ClientCertificateMode = Microsoft.AspNetCore.Server.Kestrel.Https.ClientCertificateMode;
 
 namespace WireMock.Owin;
 
@@ -39,11 +36,10 @@ internal class WireMockMiddlewareOptions : IWireMockMiddlewareOptions
 
     public int? MaxRequestLogCount { get; set; }
 
-    public Action<IAppBuilder>? PreWireMockMiddlewareInit { get; set; }
+    public Action<IApplicationBuilder>? PreWireMockMiddlewareInit { get; set; }
 
-    public Action<IAppBuilder>? PostWireMockMiddlewareInit { get; set; }
+    public Action<IApplicationBuilder>? PostWireMockMiddlewareInit { get; set; }
 
-#if USE_ASPNETCORE
     public Action<IServiceCollection>? AdditionalServiceRegistration { get; set; }
 
     public CorsPolicyOptions? CorsPolicyOptions { get; set; }
@@ -52,7 +48,6 @@ internal class WireMockMiddlewareOptions : IWireMockMiddlewareOptions
 
     /// <inheritdoc />
     public bool AcceptAnyClientCertificate { get; set; }
-#endif
 
     /// <inheritdoc cref="IWireMockMiddlewareOptions.FileSystemHandler"/>
     public IFileSystemHandler? FileSystemHandler { get; set; }
@@ -108,8 +103,11 @@ internal class WireMockMiddlewareOptions : IWireMockMiddlewareOptions
     /// <inheritdoc />
     public bool ProxyAll { get; set; }
 
-#if ACTIVITY_TRACING_SUPPORTED
     /// <inheritdoc />
     public ActivityTracingOptions? ActivityTracingOptions { get; set; }
-#endif
+
+    /// <inheritdoc />
+    public ConcurrentDictionary<Guid, WebSocketConnectionRegistry> WebSocketRegistries { get; } = new();
+
+    public WebSocketSettings? WebSocketSettings { get; set; }
 }

src/WireMock.Net.Minimal/Owin/WireMockMiddlewareOptionsHelper.cs

@@ -19,6 +19,7 @@ internal static class WireMockMiddlewareOptionsHelper
 
         options ??= new WireMockMiddlewareOptions();
 
+        options.ActivityTracingOptions = settings.ActivityTracingOptions;
         options.AllowBodyForAllHttpMethods = settings.AllowBodyForAllHttpMethods;
         options.AllowOnlyDefinedHttpStatusCodeInResponse = settings.AllowOnlyDefinedHttpStatusCodeInResponse;
         options.AllowPartialMapping = settings.AllowPartialMapping;
@@ -35,20 +36,6 @@ internal static class WireMockMiddlewareOptionsHelper
         options.RequestLogExpirationDuration = settings.RequestLogExpirationDuration;
         options.SaveUnmatchedRequests = settings.SaveUnmatchedRequests;
 
-        // Validate and configure activity tracing
-        ActivityTracingValidator.ValidateActivityApiPresence(settings);
-#if ACTIVITY_TRACING_SUPPORTED
-        if (settings.ActivityTracingOptions is not null)
-        {
-            options.ActivityTracingOptions = new Owin.ActivityTracing.ActivityTracingOptions
-            {
-                ExcludeAdminRequests = settings.ActivityTracingOptions.ExcludeAdminRequests,
-                RecordRequestBody = settings.ActivityTracingOptions.RecordRequestBody,
-                RecordResponseBody = settings.ActivityTracingOptions.RecordResponseBody,
-                RecordMatchDetails = settings.ActivityTracingOptions.RecordMatchDetails
-            };
-        }
-#endif
 #if USE_ASPNETCORE
         options.AdditionalServiceRegistration = settings.AdditionalServiceRegistration;
         options.CorsPolicyOptions = settings.CorsPolicyOptions;

src/WireMock.Net.Minimal/Proxy/ProxyUrlTransformer.cs

@@ -1,6 +1,6 @@
 // Copyright © WireMock.Net
 
-using System;
+using WireMock.Extensions;
 using WireMock.Settings;
 using WireMock.Transformers;
 

src/WireMock.Net.Minimal/RequestBuilders/Request.WithWebSocket.cs

@@ -0,0 +1,47 @@
+// Copyright © WireMock.Net
+
+using WireMock.Matchers;
+using WireMock.Matchers.Request;
+
+namespace WireMock.RequestBuilders;
+
+public partial class Request
+{
+    /// <inheritdoc />
+    public bool IsWebSocket { get; private set; }
+
+    /// <inheritdoc />
+    public IRequestBuilder WithWebSocketUpgrade(params string[] protocols)
+    {
+        _requestMatchers.Add(new RequestMessageHeaderMatcher(
+            MatchBehaviour.AcceptOnMatch,
+            MatchOperator.Or,
+            "Upgrade",
+            true,
+            new ExactMatcher(true, "websocket")
+        ));
+
+        _requestMatchers.Add(new RequestMessageHeaderMatcher(
+            MatchBehaviour.AcceptOnMatch,
+            MatchOperator.Or,
+            "Connection",
+            true,
+            new WildcardMatcher("*Upgrade*", true)
+        ));
+
+        if (protocols.Length > 0)
+        {
+            _requestMatchers.Add(new RequestMessageHeaderMatcher(
+                MatchBehaviour.AcceptOnMatch,
+                MatchOperator.Or,
+                "Sec-WebSocket-Protocol",
+                true,
+                protocols.Select(p => new ExactMatcher(true, p)).ToArray()
+            ));
+        }
+
+        IsWebSocket = true;
+
+        return this;
+    }
+}

src/WireMock.Net.Minimal/RequestBuilders/Request.cs

@@ -2,11 +2,8 @@
 
 // This source file is based on mock4net by Alexandre Victoor which is licensed under the Apache 2.0 License.
 // For more details see 'mock4net/LICENSE.txt' and 'mock4net/readme.md' in this project root.
-using System;
-using System.Collections.Generic;
 using System.Collections.ObjectModel;
 using System.Diagnostics.CodeAnalysis;
-using System.Linq;
 using Stef.Validation;
 using WireMock.Matchers;
 using WireMock.Matchers.Request;

src/WireMock.Net.Minimal/RequestMessage.cs

@@ -6,9 +6,10 @@ using System;
 using System.Collections.Generic;
 using System.Linq;
 using System.Net;
-#if USE_ASPNETCORE
 using System.Security.Cryptography.X509Certificates;
-#endif
+//#if USE_ASPNETCORE
+//using System.Security.Cryptography.X509Certificates;
+//#endif
 using Stef.Validation;
 using WireMock.Models;
 using WireMock.Owin;
@@ -82,11 +83,11 @@ public class RequestMessage : IRequestMessage
     /// <inheritdoc />
     public byte[]? BodyAsBytes { get; }
 
-#if MIMEKIT
+//#if MIMEKIT
     /// <inheritdoc />
     [Newtonsoft.Json.JsonIgnore] // Issue 1001
     public Models.Mime.IMimeMessageData? BodyAsMimeMessage { get; }
-#endif
+//#endif
 
     /// <inheritdoc />
     public string? DetectedBodyType { get; }
@@ -109,10 +110,10 @@ public class RequestMessage : IRequestMessage
     /// <inheritdoc />
     public string Origin { get; }
 
-#if USE_ASPNETCORE
+//#if USE_ASPNETCORE
     /// <inheritdoc />
     public X509Certificate2? ClientCertificate { get; }
-#endif
+//#endif
 
     /// <summary>
     /// Used for Unit Testing
@@ -136,9 +137,9 @@ public class RequestMessage : IRequestMessage
         IDictionary<string, string[]>? headers = null,
         IDictionary<string, string>? cookies = null,
         string httpVersion = "1.1"
-#if USE_ASPNETCORE
+//#if USE_ASPNETCORE
         , X509Certificate2? clientCertificate = null
-#endif
+//#endif
     )
     {
         Guard.NotNull(urlDetails);
@@ -178,16 +179,16 @@ public class RequestMessage : IRequestMessage
         Query = QueryStringParser.Parse(RawQuery, options?.QueryParameterMultipleValueSupport);
         QueryIgnoreCase = new Dictionary<string, WireMockList<string>>(Query, StringComparer.OrdinalIgnoreCase);
 
-#if USE_ASPNETCORE
+//#if USE_ASPNETCORE
         ClientCertificate = clientCertificate;
-#endif
+//#endif
 
-#if MIMEKIT
+//#if MIMEKIT
         if (TypeLoader.TryLoadStaticInstance<IMimeKitUtils>(out var mimeKitUtils) && mimeKitUtils.TryGetMimeMessage(this, out var mimeMessage))
         {
             BodyAsMimeMessage = mimeMessage;
         }
-#endif
+//#endif
     }
 
     /// <inheritdoc />
@@ -199,7 +200,6 @@ public class RequestMessage : IRequestMessage
         }
 
         var query = !ignoreCase ? Query : new Dictionary<string, WireMockList<string>>(Query, StringComparer.OrdinalIgnoreCase);
-
-        return query.ContainsKey(key) ? query[key] : null;
+        return query.TryGetValue(key, out var value) ? value : null;
     }
 }

src/WireMock.Net.Minimal/ResponseBuilders/Response.WithWebSocket.cs

@@ -0,0 +1,48 @@
+// Copyright © WireMock.Net
+
+using WireMock.Settings;
+using WireMock.WebSockets;
+
+namespace WireMock.ResponseBuilders;
+
+public partial class Response
+{
+    /// <summary>
+    /// Internal property to store WebSocket builder configuration
+    /// </summary>
+    internal WebSocketBuilder? WebSocketBuilder { get; set; }
+
+    /// <summary>
+    /// Configure WebSocket response behavior
+    /// </summary>
+    public IResponseBuilder WithWebSocket(Action<IWebSocketBuilder> configure)
+    {
+        var builder = new WebSocketBuilder(this);
+        configure(builder);
+
+        WebSocketBuilder = builder;
+        
+        return this;
+    }
+
+    /// <summary>
+    /// Proxy WebSocket to another server
+    /// </summary>
+    public IResponseBuilder WithWebSocketProxy(string targetUrl)
+    {
+        return WithWebSocketProxy(new ProxyAndRecordSettings { Url = targetUrl });
+    }
+
+    /// <summary>
+    /// Proxy WebSocket to another server with settings
+    /// </summary>
+    public IResponseBuilder WithWebSocketProxy(ProxyAndRecordSettings settings)
+    {
+        var builder = new WebSocketBuilder(this);
+        builder.WithProxy(settings);
+
+        WebSocketBuilder = builder;
+        
+        return this;
+    }
+}

src/WireMock.Net.Minimal/ResponseBuilders/Response.cs

@@ -4,16 +4,16 @@
 // For more details see 'mock4net/LICENSE.txt' and 'mock4net/readme.md' in this project root.
 using System;
 using System.Net;
+using System.Net.Http;
 using System.Threading;
 using System.Threading.Tasks;
 using JetBrains.Annotations;
+using Microsoft.AspNetCore.Http;
 using Stef.Validation;
 using WireMock.Proxy;
 using WireMock.RequestBuilders;
 using WireMock.Settings;
 using WireMock.Transformers;
-using WireMock.Transformers.Handlebars;
-using WireMock.Transformers.Scriban;
 using WireMock.Types;
 using WireMock.Util;
 
@@ -187,8 +187,10 @@ public partial class Response : IResponseBuilder
     }
 
     /// <inheritdoc />
-    public async Task<(IResponseMessage Message, IMapping? Mapping)> ProvideResponseAsync(IMapping mapping, IRequestMessage requestMessage, WireMockServerSettings settings)
+    public async Task<(IResponseMessage Message, IMapping? Mapping)> ProvideResponseAsync(IMapping mapping, HttpContext context, IRequestMessage requestMessage, WireMockServerSettings settings)
     {
+        Guard.NotNull(mapping);
+        Guard.NotNull(context);
         Guard.NotNull(requestMessage);
         Guard.NotNull(settings);