fix(server): skip hot channel client normalization for wsServer (#18782)

Co-authored-by: sapphi-red <[email protected]>

packages/vite/src/node/server/hmr.ts

@@ -173,6 +173,7 @@ export interface NormalizedHotChannel<Api = any> {
 export const normalizeHotChannel = (
   channel: HotChannel,
   enableHmr: boolean,
+  normalizeClient = true,
 ): NormalizedHotChannel => {
   const normalizedListenerMap = new WeakMap<
     (data: any, client: NormalizedHotChannelClient) => void | Promise<void>,
@@ -225,7 +226,7 @@ export const normalizeHotChannel = (
       event: string,
       fn: (data: any, client: NormalizedHotChannelClient) => void,
     ) => {
-      if (event === 'connection') {
+      if (event === 'connection' || !normalizeClient) {
         channel.on?.(event, fn as () => void)
         return
       }
@@ -260,7 +261,7 @@ export const normalizeHotChannel = (
       listenersForEvents.get(event)!.add(listenerWithNormalizedClient)
     },
     off: (event: string, fn: () => void) => {
-      if (event === 'connection') {
+      if (event === 'connection' || !normalizeClient) {
         channel.off?.(event, fn as () => void)
         return
       }

packages/vite/src/node/server/ws.ts

@@ -9,11 +9,12 @@ import colors from 'picocolors'
 import type { WebSocket as WebSocketRaw } from 'ws'
 import { WebSocketServer as WebSocketServerRaw_ } from 'ws'
 import type { WebSocket as WebSocketTypes } from 'dep-types/ws'
-import type { ErrorPayload } from 'types/hmrPayload'
+import type { ErrorPayload, HotPayload } from 'types/hmrPayload'
 import type { InferCustomEventPayload } from 'types/customEvent'
-import type { HotChannelClient, ResolvedConfig } from '..'
+import type { ResolvedConfig } from '..'
 import { isObject } from '../utils'
-import { type NormalizedHotChannel, normalizeHotChannel } from './hmr'
+import type { NormalizedHotChannel, NormalizedHotChannelClient } from './hmr'
+import { normalizeHotChannel } from './hmr'
 import type { HttpServer } from '.'
 
 /* In Bun, the `ws` module is overridden to hook into the native code. Using the bundled `js` version
@@ -66,7 +67,7 @@ export interface WebSocketServer extends NormalizedHotChannel {
   clients: Set<WebSocketClient>
 }
 
-export interface WebSocketClient extends HotChannelClient {
+export interface WebSocketClient extends NormalizedHotChannelClient {
   /**
    * The raw WebSocket instance
    * @advanced
@@ -255,7 +256,17 @@ export function createWebSocketServer(
   function getSocketClient(socket: WebSocketRaw) {
     if (!clientsMap.has(socket)) {
       clientsMap.set(socket, {
-        send: (payload) => {
+        send: (...args: any[]) => {
+          let payload: HotPayload
+          if (typeof args[0] === 'string') {
+            payload = {
+              type: 'custom',
+              event: args[0],
+              data: args[1],
+            }
+          } else {
+            payload = args[0]
+          }
           socket.send(JSON.stringify(payload))
         },
         socket,
@@ -329,6 +340,8 @@ export function createWebSocketServer(
       },
     },
     config.server.hmr !== false,
+    // Don't normalize client as we already handles the send, and to keep `.socket`
+    false,
   )
   return {
     ...normalizedHotChannel,