feat: support mocking WebSocket APIs

[kettanaito]

• Closes Support mocking WebSocket APIs #156
• Discussed in WebSocket Support Beta #2010

Roadmap

• Support runtime overrides for event handlers.
• Extend Handler in RequestHandler. This way HttpHandler and GraphQLHandler will be assignable to type Handler, and Array<Handler> can annotate both HTTP and WebSocket handlers.
  • Bad idea. Even abstracted, RequestHandler relies on caching to clone requests, parsed result, etc. Not enough common ground to reuse between it and WebSocketHandler. WS handler is better off as a standalone class (doesn't support once anyway).
• Call handleWebSocketEvent() in SetupWorkerApi and SetupServerApi.
• handleRequest: Check that the handler is instanceof RequestHandler to skip WebSocket handlers.
• Update to @mswjs/interceptors that ships WebSocketInterceptor.
• Improve types. The data argument of message listeners must be annotated across the board (includes annotating the MessageEvent in the Interceptors).
• Add links to jsdoc blocks of the new API.
• Bug: look into why pnpm test:modules:node hangs forever on setupServer() without the explicit process.exit() in the generated runtime.* scripts.
• Add Node.js tests.
• Add browser tests.
• Add .use() override tests (i.e. event.stopImmediatePropagation()).
• Defer the interceptor application to the .start()/.listen() calls.
• Add server.close() API (a task for Interceptors, here just add tests).
• Invoke onUnhandledRequest() (or similar) for unhandled WebSocket connections. Technically, there are no requests, so the existing method reads weird. WebSocket Support Beta #2010 (comment)
• feat(ws): add logging to WebSocket connections #2112
• WebSocket: Decide how to handle actual server errors interceptors#539
• Forward client events to the server by default (WebSocket Support Beta #2010 (comment)).
• Fix .broadcast() not broadcasting from N(1) -> N+ but working from N+ -> N+. (discovered in add WebSocket + ws example examples#111) (fix(WebSocketClientManager): use localStorage for clients persistence #2127).
• Annotate this: WebSocket in the client/server event listeners.
• Refreshing the page keeps adding the same client under a new ID to the localStorage (fix: fix: purge persisted clients on page reload #2133)

[kettanaito]

Intentionally pushed failing tests as verification of #2010 (reply in thread).

Edit: Removed these. More context in the discussion.

[kettanaito]

📦 v2.3.0-ws.rc-2

• Logging.
• New server and client events.

[kettanaito]

📦 v2.3.0-ws.rc-3

• TypeScript improvements.

[kettanaito]

📦 v2.3.0-ws.rc-6

• Uses localStorage for persisting all WebSocket clients (.clients).