Add WebSockets (#1423)

* Add WebSockets

* Add tests

* fix

* more tests

* Add tests

* ...

* remove IOwin

* -

* tests

* fluent

* ok

* match

* .

* byte[]

* x

* func

* func

* byte

* trans

* ...

* frameworks.........

* jmes

* xxx

* sc

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