@rsbuild/core 2.2.7 → 2.2.8

package/dist/server/assets-middleware/memoryFileSystem.d.ts

@@ -0,0 +1,2 @@
+import { type IFs } from 'memfs';
+export declare function createMemoryFileSystem(): IFs;

package/dist/server/buildManager.d.ts

@@ -1,11 +1,12 @@
 import type { InternalContext, NormalizedConfig, Rspack } from '../types/index.js';
 import { type AssetsMiddleware } from './assets-middleware/index.js';
-import { SocketServer } from './socketServer.js';
+import { type SocketConnectionListener, SocketServer } from './socketServer.js';
 type Options = {
     context: InternalContext;
     config: NormalizedConfig;
     compiler: Rspack.Compiler | Rspack.MultiCompiler;
     resolvedPort: number;
+    onSocketConnect?: SocketConnectionListener;
 };
 /**
  * Setup compiler related logic:
@@ -19,7 +20,7 @@ type Options = {
     private config;
     private resolvedPort;
     private context;
-    constructor({ config, context, compiler, resolvedPort }: Options);
+    constructor({ config, context, compiler, resolvedPort, onSocketConnect }: Options);
     init(): Promise<void>;
     /**
    * Call `compiler.watch()` to start compiling.

package/dist/server/devServer.d.ts

@@ -10,6 +10,11 @@ type ExtractSocketMessageData<T extends ServerMessage['type']> = 'data' extends
     type: T;
 }>['data'] : undefined;
 export type HotSend = <T extends ServerMessage['type']>(type: T, data?: ExtractSocketMessageData<T>) => void;
+export type HotClient = {
+    /** Send an HMR message to this connection only. */ send: HotSend;
+};
+type HotConnectCallback = (client: HotClient) => void | Promise<void>;
+export type HotOnConnect = (callback: HotConnectCallback) => () => void;
 export type RsbuildDevServer = RsbuildServerBase & {
     /**
    * Notifies Rsbuild that the custom server has successfully started.

package/dist/server/socketServer.d.ts

@@ -1,5 +1,6 @@
 import type { IncomingMessage } from 'node:http';
 import type { Socket } from 'node:net';
+import type { WebSocket } from 'ws';
 import type { DevConfig, InternalContext, Rspack } from '../types/index.js';
 export type ServerMessageFullReload = {
     type: 'full-reload';
@@ -61,6 +62,7 @@ export type ClientMessagePing = {
     type: 'ping';
 };
 export type ClientMessage = ClientMessagePing | ClientMessageError;
+export type SocketConnectionListener = (socket: WebSocket, token: string) => void;
 export declare class SocketServer {
     private wsServer;
     private readonly socketsMap;
@@ -71,7 +73,8 @@ export declare class SocketServer {
     private getOutputFileSystem;
     private reportedBrowserLogs;
     private currentHash;
-    constructor(context: InternalContext, options: DevConfig, getOutputFileSystem: () => Rspack.OutputFileSystem);
+    private onSocketConnect?;
+    constructor(context: InternalContext, options: DevConfig, getOutputFileSystem: () => Rspack.OutputFileSystem, onSocketConnect?: SocketConnectionListener);
     // subscribe upgrade event to handle socket
     upgrade: (req: IncomingMessage, socket: Socket, head: Buffer) => void;
     // detect and close broken connections
@@ -90,9 +93,9 @@ export declare class SocketServer {
     /**
    * Send a server message to matching client sockets.
    * @param message - The message to send
-   * @param token - The token of the socket to send the message to,
-   * if not provided, the message will be sent to all sockets
-   */ sendMessage(message: ServerMessage, token?: string): void;
+   * @param target - An environment token or a single socket.
+   * If not provided, the message will be sent to all sockets.
+   */ sendMessage(message: ServerMessage, target?: string | WebSocket): void;
     close(): Promise<void>;
     private onConnect;
     private getEnvironmentByToken;

package/dist/types/config.d.ts

@@ -8,7 +8,7 @@ import type Cors from '../../compiled/cors/index.js';
 import type { Options as HttpProxyOptions, Filter as ProxyFilter } from '../../compiled/http-proxy-middleware/index.js';
 import type { RspackChain } from '../../compiled/rspack-chain/types/index.js';
 import type { FileDescriptor } from '../../compiled/rspack-manifest-plugin/index.js';
-import type { HotSend, RsbuildDevServer } from '../server/devServer.js';
+import type { HotOnConnect, HotSend, RsbuildDevServer } from '../server/devServer.js';
 import type { RsbuildPreviewServer } from '../server/previewServer.js';
 import type { Logger } from '../logger.js';
 import type { EnvironmentContext, ModifyBundlerChainUtils, ModifyChainUtils, ReadonlyRoutes, WatchFileEvent } from './hooks.js';
@@ -1444,9 +1444,13 @@ export type EnvironmentAPI = Record<string, {
      * Get the compiled HTML template.
      */ getTransformedHtml: (entryName: string) => Promise<string>;
     /**
-     * Send HMR message to the current environment only.
+     * HMR communication for the current environment.
      */ hot: {
         send: HotSend;
+        /**
+       * Listen for accepted HMR connections in this environment.
+       * Returns a function that removes the listener.
+       */ onConnect: HotOnConnect;
     };
     /**
      * Provides some context information about the current environment

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@rsbuild/core",
-  "version": "2.2.7",
+  "version": "2.2.8",
   "description": "The Rspack-based build tool.",
   "homepage": "https://rsbuild.rs",
   "bugs": {
@@ -35,12 +35,13 @@
     "types.d.ts"
   ],
   "dependencies": {
-    "@rspack/core": "~2.2.5",
+    "@rspack/core": "~2.2.6",
     "@swc/helpers": "^0.5.23"
   },
   "devDependencies": {
     "@jridgewell/remapping": "^2.3.5",
     "@jridgewell/trace-mapping": "^0.3.31",
+    "@jsonjoy.com/fs-core": "4.78.0",
     "@rstackjs/load-config": "^1.0.0",
     "@types/cors": "^2.8.19",
     "@types/node": "^24.13.4",
@@ -61,7 +62,7 @@
     "http-proxy-middleware": "4.2.0",
     "jiti": "^2.7.0",
     "launch-editor-middleware": "^2.14.1",
-    "memfs": "^4.76.0",
+    "memfs": "4.78.0",
     "mrmime": "^2.0.1",
     "on-finished": "2.4.1",
     "open": "^11.0.3",