fix: export and type the custom server extension class

.changeset/export-base-server.md

@@ -0,0 +1,5 @@
+---
+"webpack-dev-server": patch
+---
+
+Export the documented `BaseServer` extension class and accept its constructors in the public `webSocketServer.type` declaration.

lib/Server.js

@@ -138,7 +138,7 @@ function loadWebpackPeer() {
 
 /**
  * @typedef {object} WebSocketServerConfiguration
- * @property {("ws" | string | (() => WebSocketServerConfiguration))=} type type
+ * @property {("ws" | string | typeof import("./servers/BaseServer.js").default)=} type type
  * @property {Record<string, EXPECTED_ANY>=} options options
  */
 

package.json

@@ -20,6 +20,12 @@
       "default": "./lib/Server.js"
     },
     "./client/*": "./client/*",
+    "./lib/servers/BaseServer.js": {
+      "types": "./types/lib/servers/BaseServer.d.ts",
+      "import": "./lib/servers/BaseServer.js",
+      "require": "./dist/servers/BaseServer.js",
+      "default": "./lib/servers/BaseServer.js"
+    },
     "./package.json": "./package.json"
   },
   "main": "./dist/Server.js",

scripts/finalize-cjs-build.mjs

@@ -12,9 +12,8 @@ import { fileURLToPath } from "node:url";
 //    files in `dist/` as CommonJS regardless of the package's root
 //    `"type": "module"`.
 // 2. Babel emits the loader as `exports.default`. Append the `module.exports`
-//    unwrap so `require("webpack-dev-server")` returns the `Server` class
-//    directly (parity with the pre-ESM `module.exports = Server`), while
-//    `.default` keeps pointing at it for interop.
+//    unwrap so the public Server and BaseServer entrypoints return their
+//    classes directly, while `.default` keeps pointing at them for interop.
 
 const CJS_DIR = path.resolve(
   path.dirname(fileURLToPath(import.meta.url)),
@@ -27,7 +26,9 @@ await writeFile(
   `${JSON.stringify({ type: "commonjs" }, null, 2)}\n`,
 );
 
-await appendFile(
-  path.join(CJS_DIR, "Server.js"),
-  "module.exports = exports.default;\nmodule.exports.default = exports.default;\n",
-);
+for (const entry of ["Server.js", "servers/BaseServer.js"]) {
+  await appendFile(
+    path.join(CJS_DIR, entry),
+    "module.exports = exports.default;\nmodule.exports.default = exports.default;\n",
+  );
+}

types/lib/Server.d.ts

@@ -157,7 +157,9 @@ export type WebSocketServerConfiguration = {
   /**
    * type
    */
-  type?: ("ws" | string | (() => WebSocketServerConfiguration)) | undefined;
+  type?:
+    | ("ws" | string | typeof import("./servers/BaseServer.js").default)
+    | undefined;
   /**
    * options
    */