rspack-dev-middleware 0.4.0 → 0.4.2

package/esm/server/hot/Message.d.ts

@@ -2,17 +2,19 @@
  * @module message
  */
 import * as rspack from '@rspack/core';
-import { GetProp } from '../interface.js';
-export interface Invalid {
-  action: 'invalid';
-  payload: {
+export interface Messages {
+  ok: {
+    timestamp: number;
+  };
+  hash: {
+    hash: string;
+    timestamp: number;
+  };
+  invalid: {
     timestamp: number;
     path: string | null;
   };
-}
-export interface Progress {
-  action: 'progress';
-  payload: {
+  progress: {
     stage: string;
     percent: number;
     details: {
@@ -20,33 +22,15 @@ export interface Progress {
       moduleIdentifier?: string;
     };
   };
-}
-export interface Hash {
-  action: 'hash';
-  payload: {
-    hash: string;
-    timestamp: number;
-  };
-}
-export interface Issues {
-  action: 'issues';
-  payload: {
+  issues: {
     timestamp: number;
     errors: rspack.StatsError[];
     warnings: rspack.StatsError[];
   };
 }
-export interface Ok {
-  action: 'ok';
-  payload: {
-    timestamp: number;
+export type Message = {
+  [A in keyof Messages]: {
+    action: A;
+    payload: Messages[A];
   };
-}
-export interface Messages {
-  ok: GetProp<Ok, 'payload'>;
-  hash: GetProp<Hash, 'payload'>;
-  issues: GetProp<Issues, 'payload'>;
-  invalid: GetProp<Invalid, 'payload'>;
-  progress: GetProp<Progress, 'payload'>;
-}
-export type Message = Invalid | Progress | Hash | Issues | Ok;
+}[keyof Messages];

package/esm/server/hot/Socket.js

@@ -2,16 +2,16 @@
  * @module rspack-dev-middleware
  * @package rspack-dev-middleware
  * @license MIT
- * @version 0.4.0
+ * @version 0.4.2
  * @author nuintun <nuintun@qq.com>
  * @description A koa 2 middleware for rspack development and hot reloading.
  * @see https://github.com/nuintun/rspack-dev-middleware#readme
  */
 
-import { v7 } from 'uuid';
 import { Buffer } from 'node:buffer';
 import * as rspack from '@rspack/core';
 import { fileURLToPath } from 'node:url';
+import { randomUUID } from 'node:crypto';
 import { resolve, dirname } from 'node:path';
 import WebSocket, { WebSocketServer } from 'ws';
 import { PLUGIN_NAME, getCompilers } from '../utils.js';
@@ -37,7 +37,7 @@ class Socket {
     const compilers = getCompilers(compiler);
     const contexts = new Map();
     for (const compiler of compilers) {
-      const uuid = v7();
+      const uuid = randomUUID();
       const context = {
         uuid,
         stats: null,
@@ -81,7 +81,7 @@ class Socket {
       process.nextTick(() => {
         const { stats } = context;
         // Broadcast stats.
-        if (stats) {
+        if (stats != null && context.clients.size > 0) {
           this.#broadcastStats(context.clients, stats);
         }
       });
@@ -132,7 +132,7 @@ class Socket {
       const uuid = url.searchParams.get('uuid');
       if (uuid) {
         const context = contexts.get(uuid);
-        if (context) {
+        if (context != null) {
           const { stats } = context;
           context.clients.add(client);
           logger.log('client connected');
@@ -140,9 +140,8 @@ class Socket {
             context.clients.delete(client);
             logger.log('client disconnected');
           });
-          if (stats) {
-            const clients = new Set([client]);
-            this.#broadcastStats(clients, stats);
+          if (stats != null) {
+            this.#broadcastStats([client], stats);
           }
         } else {
           client.close(4001, 'compiler not found');
@@ -156,21 +155,21 @@ class Socket {
     });
   }
   #broadcast(clients, action, payload) {
+    // Serialize once, send to all.
+    const message = JSON.stringify({ action, payload });
     for (const client of clients) {
       if (client.readyState === WebSocket.OPEN) {
-        client.send(JSON.stringify({ action, payload }));
+        client.send(message);
       }
     }
   }
   #broadcastStats(clients, stats) {
-    if (clients.size > 0) {
-      const { hash, errors, warnings, builtAt: timestamp } = stats;
-      this.#broadcast(clients, 'hash', { hash, timestamp });
-      if (hasIssues(errors) || hasIssues(warnings)) {
-        this.#broadcast(clients, 'issues', { errors, warnings, timestamp });
-      } else {
-        this.#broadcast(clients, 'ok', { timestamp });
-      }
+    const { hash, errors, warnings, builtAt: timestamp } = stats;
+    this.#broadcast(clients, 'hash', { hash, timestamp });
+    if (hasIssues(errors) || hasIssues(warnings)) {
+      this.#broadcast(clients, 'issues', { errors, warnings, timestamp });
+    } else {
+      this.#broadcast(clients, 'ok', { timestamp });
     }
   }
   upgrade(context) {

package/esm/server/hot/index.js

@@ -2,7 +2,7 @@
  * @module rspack-dev-middleware
  * @package rspack-dev-middleware
  * @license MIT
- * @version 0.4.0
+ * @version 0.4.2
  * @author nuintun <nuintun@qq.com>
  * @description A koa 2 middleware for rspack development and hot reloading.
  * @see https://github.com/nuintun/rspack-dev-middleware#readme

package/esm/server/hot/utils.js

@@ -2,13 +2,13 @@
  * @module rspack-dev-middleware
  * @package rspack-dev-middleware
  * @license MIT
- * @version 0.4.0
+ * @version 0.4.2
  * @author nuintun <nuintun@qq.com>
  * @description A koa 2 middleware for rspack development and hot reloading.
  * @see https://github.com/nuintun/rspack-dev-middleware#readme
  */
 
-import { isString, isBoolean } from '../utils.js';
+import { toStatsPreset } from '../utils.js';
 
 /**
  * @module utils
@@ -34,14 +34,8 @@ function hasIssues(issues) {
   return Array.isArray(issues) && issues.length > 0;
 }
 function getStatsOptions(compiler) {
-  let statsOptions = compiler.options.stats;
-  if (isString(statsOptions)) {
-    statsOptions = { preset: statsOptions };
-  } else if (isBoolean(statsOptions)) {
-    statsOptions = statsOptions ? { preset: 'normal' } : { preset: 'none' };
-  }
   return {
-    ...statsOptions,
+    ...toStatsPreset(compiler.options.stats),
     all: false,
     hash: true,
     colors: true,

package/esm/server/index.js

@@ -2,7 +2,7 @@
  * @module rspack-dev-middleware
  * @package rspack-dev-middleware
  * @license MIT
- * @version 0.4.0
+ * @version 0.4.2
  * @author nuintun <nuintun@qq.com>
  * @description A koa 2 middleware for rspack development and hot reloading.
  * @see https://github.com/nuintun/rspack-dev-middleware#readme

package/esm/server/schema.js

@@ -2,7 +2,7 @@
  * @module rspack-dev-middleware
  * @package rspack-dev-middleware
  * @license MIT
- * @version 0.4.0
+ * @version 0.4.2
  * @author nuintun <nuintun@qq.com>
  * @description A koa 2 middleware for rspack development and hot reloading.
  * @see https://github.com/nuintun/rspack-dev-middleware#readme
@@ -15,7 +15,7 @@ const schema = {
   type: 'object',
   properties: {
     hot: {
-      description: 'Enable or disable HMR server.',
+      description: 'Configure the HMR server, or set to false to disable.',
       anyOf: [
         {
           type: 'boolean',
@@ -38,7 +38,7 @@ const schema = {
             },
             reload: {
               type: 'boolean',
-              description: 'Control whether the full page should be reloaded when HMR failure.'
+              description: 'Control whether the full page should be reloaded when HMR fails.'
             },
             overlay: {
               type: 'boolean',
@@ -99,9 +99,30 @@ const schema = {
       type: 'object',
       description: 'The output file system used by the dev server.'
     },
+    highWaterMark: {
+      description: 'The size of the read stream buffer.',
+      anyOf: [
+        {
+          type: 'number'
+        },
+        {
+          instanceof: 'Function'
+        }
+      ]
+    },
     stats: {
-      type: 'object',
-      description: 'Options for the statistics output.'
+      description: 'Options for the statistics output.',
+      anyOf: [
+        {
+          type: 'boolean'
+        },
+        {
+          type: 'string'
+        },
+        {
+          type: 'object'
+        }
+      ]
     },
     writeToDisk: {
       anyOf: [
@@ -117,7 +138,7 @@ const schema = {
     },
     onCompilationDone: {
       instanceof: 'Function',
-      description: 'Callback function when the compilation is done, providing statistics and options.'
+      description: 'Callback function when the compilation is done, providing stats and stats options.'
     }
   },
   additionalProperties: false

package/esm/server/utils.d.ts

@@ -9,4 +9,5 @@ export declare function isBoolean(value: unknown): value is boolean;
 export declare function isFunction(value: unknown): value is Function;
 export declare function assertPublicPath(compiler: UnionCompiler): never | void;
 export declare function getCompilers(compiler: UnionCompiler): rspack.Compiler[];
+export declare function toStatsPreset(stats?: rspack.StatsValue): rspack.StatsOptions;
 export declare function isMultiCompiler(compiler: UnionCompiler): compiler is rspack.MultiCompiler;

package/esm/server/utils.js

@@ -2,7 +2,7 @@
  * @module rspack-dev-middleware
  * @package rspack-dev-middleware
  * @license MIT
- * @version 0.4.0
+ * @version 0.4.2
  * @author nuintun <nuintun@qq.com>
  * @description A koa 2 middleware for rspack development and hot reloading.
  * @see https://github.com/nuintun/rspack-dev-middleware#readme
@@ -36,8 +36,18 @@ function getCompilers(compiler) {
   }
   return [compiler];
 }
+function toStatsPreset(stats) {
+  if (stats == null) {
+    return { preset: 'normal' };
+  } else if (isString(stats)) {
+    return { preset: stats };
+  } else if (isBoolean(stats)) {
+    return stats ? { preset: 'normal' } : { preset: 'none' };
+  }
+  return stats;
+}
 function isMultiCompiler(compiler) {
   return 'compilers' in compiler;
 }
 
-export { PLUGIN_NAME, assertPublicPath, getCompilers, isBoolean, isFunction, isMultiCompiler, isString };
+export { PLUGIN_NAME, assertPublicPath, getCompilers, isBoolean, isFunction, isMultiCompiler, isString, toStatsPreset };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "rspack-dev-middleware",
-  "version": "0.4.0",
+  "version": "0.4.2",
   "description": "A koa 2 middleware for rspack development and hot reloading.",
   "type": "module",
   "sideEffects": [
@@ -47,55 +47,53 @@
     "url": "https://github.com/nuintun/rspack-dev-middleware/issues"
   },
   "homepage": "https://github.com/nuintun/rspack-dev-middleware#readme",
+  "scripts": {
+    "lint": "tsc --noEmit",
+    "pretest": "pnpm build",
+    "clean": "node tools/clean.ts",
+    "prepublishOnly": "pnpm build",
+    "test": "cd tests && node rspack.config.ts",
+    "build:cjs": "rollup -c tools/rollup.cjs.ts",
+    "build:esm": "rollup -c tools/rollup.esm.ts",
+    "build:fix-types": "node tools/fix-types.ts",
+    "build": "pnpm clean && pnpm build:main && pnpm format",
+    "format": "prettier --write . --ignore-path .prettierignore",
+    "build:main": "pnpm build:cjs && pnpm build:esm && pnpm build:fix-types"
+  },
   "dependencies": {
     "@nuintun/ansi": "^0.3.13",
-    "@types/koa": "^3.0.2",
-    "@types/ws": "^8.18.1",
-    "etag": "^1.8.1",
-    "memfs": "^4.57.2",
-    "range-parser": "^1.2.1",
-    "schema-utils": "^4.3.3",
-    "supports-color": "^10.2.2",
+    "@types/koa": "^3.0.3",
+    "@types/ws": "^8.18.2",
+    "memfs": "^4.80.0",
+    "range-parser": "^1.3.0",
+    "schema-utils": "^4.8.1",
+    "supports-color": "^11.0.0",
     "tslib": "^2.8.1",
-    "uuid": "^14.0.0",
-    "ws": "^8.20.0"
+    "ws": "^8.22.0"
   },
   "devDependencies": {
     "@rollup/plugin-replace": "^6.0.3",
     "@rollup/plugin-typescript": "^12.3.0",
     "@rollup/plugin-url": "^8.0.2",
-    "@rspack/core": "^2.0.0",
-    "@rspack/plugin-react-refresh": "^2.0.0",
-    "@types/etag": "^1.8.4",
-    "@types/node": "^25.6.0",
+    "@rspack/core": "^2.2.9",
+    "@rspack/plugin-react-refresh": "^2.0.2",
+    "@types/node": "^26.6.5",
     "@types/range-parser": "^1.2.7",
-    "@types/react": "^19.2.14",
-    "@types/react-dom": "^19.2.3",
-    "dts-paths": "^2.2.1",
-    "koa": "^3.2.0",
-    "koa-compress": "^5.2.1",
-    "prettier": "^3.8.3",
-    "react": "^19.2.5",
-    "react-dom": "^19.2.5",
-    "react-refresh": "^0.18.0",
+    "@types/react": "^19.3.0",
+    "@types/react-dom": "^19.3.0",
+    "dts-paths": "^2.2.2",
+    "koa": "^3.2.1",
+    "koa-compress": "^5.2.2",
+    "prettier": "^3.9.10",
+    "react": "^19.3.1",
+    "react-dom": "^19.3.1",
+    "react-refresh": "^0.19.0",
     "rimraf": "^6.1.3",
-    "rollup": "^4.60.2",
+    "rollup": "^4.64.12",
     "typescript": "^6.0.3"
   },
   "peerDependencies": {
     "@rspack/core": ">=1.0.7",
     "koa": ">=2.0.0"
-  },
-  "scripts": {
-    "lint": "tsc --noEmit",
-    "pretest": "pnpm build",
-    "clean": "node tools/clean.ts",
-    "test": "cd tests && node rspack.config.ts",
-    "build:cjs": "rollup -c tools/rollup.cjs.ts",
-    "build:esm": "rollup -c tools/rollup.esm.ts",
-    "build:fix-types": "node tools/fix-types.ts",
-    "build": "pnpm clean && pnpm build:main && pnpm format",
-    "format": "prettier --write . --ignore-path .prettierignore",
-    "build:main": "pnpm build:cjs && pnpm build:esm && pnpm build:fix-types"
   }
-}
+}

package/cjs/server/dev/utils/hash.cjs

@@ -1,47 +0,0 @@
-/**
- * @module rspack-dev-middleware
- * @package rspack-dev-middleware
- * @license MIT
- * @version 0.4.0
- * @author nuintun <nuintun@qq.com>
- * @description A koa 2 middleware for rspack development and hot reloading.
- * @see https://github.com/nuintun/rspack-dev-middleware#readme
- */
-
-'use strict';
-
-const node_crypto = require('node:crypto');
-
-/**
- * @module hash
- */
-// prettier-ignore
-const CHARS = [
-    // 0-9
-    '0', '1', '2', '3', '4', '5', '6', '7', '8', '9',
-    // A-M
-    'A', 'B', 'C', 'D', 'E', 'F', 'G', 'H', 'I', 'J', 'K', 'L', 'M',
-    // N-Z
-    'N', 'O', 'P', 'Q', 'R', 'S', 'T', 'U', 'V', 'W', 'X', 'Y', 'Z',
-    // a-m
-    'a', 'b', 'c', 'd', 'e', 'f', 'g', 'h', 'i', 'j', 'k', 'l', 'm',
-    // n-z
-    'n', 'o', 'p', 'q', 'r', 's', 't', 'u', 'v', 'w', 'x', 'y', 'z'
-];
-/**
- * @function generate
- * @description Generate a hash.
- * @param length The length of hash.
- */
-function generate(length) {
-  let hash = '';
-  const randomValues = node_crypto.getRandomValues(new Uint8Array(length));
-  // Create hash.
-  for (const value of randomValues) {
-    hash += CHARS[value % 62];
-  }
-  // Return hash.
-  return hash;
-}
-
-exports.generate = generate;

package/cjs/server/dev/utils/hash.d.cts

@@ -1,9 +0,0 @@
-/**
- * @module hash
- */
-/**
- * @function generate
- * @description Generate a hash.
- * @param length The length of hash.
- */
-export declare function generate(length: number): string;

package/cjs/server/dev/utils/ready.cjs

@@ -1,24 +0,0 @@
-/**
- * @module rspack-dev-middleware
- * @package rspack-dev-middleware
- * @license MIT
- * @version 0.4.0
- * @author nuintun <nuintun@qq.com>
- * @description A koa 2 middleware for rspack development and hot reloading.
- * @see https://github.com/nuintun/rspack-dev-middleware#readme
- */
-
-'use strict';
-
-/**
- * @module ready
- */
-function ready({ stats, callbacks }, callback) {
-  if (stats) {
-    callback(stats);
-  } else {
-    callbacks.push(callback);
-  }
-}
-
-exports.ready = ready;

package/cjs/server/dev/utils/ready.d.cts

@@ -1,5 +0,0 @@
-/**
- * @module ready
- */
-import { Callback, Context } from '../interface.cjs';
-export declare function ready({ stats, callbacks }: Context, callback: Callback): void;

package/esm/server/dev/utils/hash.d.ts

@@ -1,9 +0,0 @@
-/**
- * @module hash
- */
-/**
- * @function generate
- * @description Generate a hash.
- * @param length The length of hash.
- */
-export declare function generate(length: number): string;

package/esm/server/dev/utils/hash.js

@@ -1,45 +0,0 @@
-/**
- * @module rspack-dev-middleware
- * @package rspack-dev-middleware
- * @license MIT
- * @version 0.4.0
- * @author nuintun <nuintun@qq.com>
- * @description A koa 2 middleware for rspack development and hot reloading.
- * @see https://github.com/nuintun/rspack-dev-middleware#readme
- */
-
-import { getRandomValues } from 'node:crypto';
-
-/**
- * @module hash
- */
-// prettier-ignore
-const CHARS = [
-    // 0-9
-    '0', '1', '2', '3', '4', '5', '6', '7', '8', '9',
-    // A-M
-    'A', 'B', 'C', 'D', 'E', 'F', 'G', 'H', 'I', 'J', 'K', 'L', 'M',
-    // N-Z
-    'N', 'O', 'P', 'Q', 'R', 'S', 'T', 'U', 'V', 'W', 'X', 'Y', 'Z',
-    // a-m
-    'a', 'b', 'c', 'd', 'e', 'f', 'g', 'h', 'i', 'j', 'k', 'l', 'm',
-    // n-z
-    'n', 'o', 'p', 'q', 'r', 's', 't', 'u', 'v', 'w', 'x', 'y', 'z'
-];
-/**
- * @function generate
- * @description Generate a hash.
- * @param length The length of hash.
- */
-function generate(length) {
-  let hash = '';
-  const randomValues = getRandomValues(new Uint8Array(length));
-  // Create hash.
-  for (const value of randomValues) {
-    hash += CHARS[value % 62];
-  }
-  // Return hash.
-  return hash;
-}
-
-export { generate };

package/esm/server/dev/utils/ready.d.ts

@@ -1,5 +0,0 @@
-/**
- * @module ready
- */
-import { Callback, Context } from '../interface.js';
-export declare function ready({ stats, callbacks }: Context, callback: Callback): void;

package/esm/server/dev/utils/ready.js

@@ -1,22 +0,0 @@
-/**
- * @module rspack-dev-middleware
- * @package rspack-dev-middleware
- * @license MIT
- * @version 0.4.0
- * @author nuintun <nuintun@qq.com>
- * @description A koa 2 middleware for rspack development and hot reloading.
- * @see https://github.com/nuintun/rspack-dev-middleware#readme
- */
-
-/**
- * @module ready
- */
-function ready({ stats, callbacks }, callback) {
-  if (stats) {
-    callback(stats);
-  } else {
-    callbacks.push(callback);
-  }
-}
-
-export { ready };