feat: add changeset validation and release workflow (#5673)

bjohansebas · bjohansebas · commit 4b4d81b22ab9 · 2026-07-01T14:25:56.000-05:00
* feat: add changeset validation and release workflow

* chore: add changes

* chore: fix package-lock

* chore: update http-proxy-middleware to v4

* docs: update migration guide with ESM-only and Express v5 changes

* chore: update webpack-dev-middleware to v8 and document breaking changes

* chore: update imports to use node: prefix and replace regex with replaceAll

* chore: update qs to v6.15.2 and ws to v8.21.0 in package-lock.json
diff --git a/.changeset/bump-dependencies.md b/.changeset/bump-dependencies.md
@@ -0,0 +1,5 @@
+---
+"webpack-dev-server": patch
+---
+
+Bump production dependencies, notably `open` to v11 and `p-retry` to v8.
diff --git a/.changeset/bump-express-5.md b/.changeset/bump-express-5.md
@@ -0,0 +1,5 @@
+---
+"webpack-dev-server": major
+---
+
+Bump Express to v5. See the [Express 5 migration guide](https://expressjs.com/en/guide/migrating-5.html) for the full list of breaking changes.
diff --git a/.changeset/bump-webpack-peer-dependency.md b/.changeset/bump-webpack-peer-dependency.md
@@ -0,0 +1,5 @@
+---
+"webpack-dev-server": major
+---
+
+Bump the `webpack` peer dependency range from `^5.0.0` to `^5.101.0`.
diff --git a/.changeset/compression-http2.md b/.changeset/compression-http2.md
@@ -0,0 +1,5 @@
+---
+"webpack-dev-server": minor
+---
+
+Enable the compression middleware for HTTP/2 connections.
diff --git a/.changeset/drop-node-below-22.15.md b/.changeset/drop-node-below-22.15.md
@@ -0,0 +1,5 @@
+---
+"webpack-dev-server": major
+---
+
+Drop support for Node.js < 22.15.0.
diff --git a/.changeset/fix-issameorigin-loopback-aliases.md b/.changeset/fix-issameorigin-loopback-aliases.md
@@ -0,0 +1,5 @@
+---
+"webpack-dev-server": patch
+---
+
+Treat loopback aliases (`127.0.0.1`, `::1`, `localhost`) as equivalent in `isSameOrigin` so the WebSocket client does not reject valid same-origin connections.
diff --git a/.changeset/migrate-to-esm.md b/.changeset/migrate-to-esm.md
@@ -0,0 +1,5 @@
+---
+"webpack-dev-server": major
+---
+
+Migrate the package to ES module syntax. The package is now published as ESM-only.
diff --git a/.changeset/migrate-to-node-test.md b/.changeset/migrate-to-node-test.md
@@ -0,0 +1,5 @@
+---
+"webpack-dev-server": patch
+---
+
+Migrate the test suite from Jest to `node:test` and set up the jsdom environment.
diff --git a/.changeset/remove-cli-flags.md b/.changeset/remove-cli-flags.md
@@ -0,0 +1,5 @@
+---
+"webpack-dev-server": major
+---
+
+Remove CLI flags. Use the `serve` command from `webpack-cli` together with a configuration file or the programmatic API instead.
diff --git a/.changeset/remove-colorette.md b/.changeset/remove-colorette.md
@@ -0,0 +1,5 @@
+---
+"webpack-dev-server": minor
+---
+
+Remove the `colorette` dependency in favor of native ANSI styling.
diff --git a/.changeset/remove-internalip-methods.md b/.changeset/remove-internalip-methods.md
@@ -0,0 +1,5 @@
+---
+"webpack-dev-server": major
+---
+
+Remove the `internalIP` and `internalIPSync` static methods from `Server`. Resolve the local IP yourself if you need it.
diff --git a/.changeset/remove-proxy-bypass.md b/.changeset/remove-proxy-bypass.md
@@ -0,0 +1,5 @@
+---
+"webpack-dev-server": major
+---
+
+Remove the `bypass` option from proxy configuration. Use the `router` or `context` options provided by `http-proxy-middleware` instead.
diff --git a/.changeset/remove-sockjs.md b/.changeset/remove-sockjs.md
@@ -0,0 +1,5 @@
+---
+"webpack-dev-server": major
+---
+
+Remove SockJS support. The `webSocketServer` option no longer accepts `"sockjs"`; use the default `"ws"` transport instead.
diff --git a/.changeset/remove-spdy.md b/.changeset/remove-spdy.md
@@ -0,0 +1,5 @@
+---
+"webpack-dev-server": major
+---
+
+Remove the `spdy` dependency. Use the built-in `node:http2` module via the `server` option for HTTP/2 support.
diff --git a/.changeset/update-chokidar.md b/.changeset/update-chokidar.md
@@ -0,0 +1,5 @@
+---
+"webpack-dev-server": minor
+---
+
+Update `chokidar` to v5 and extend `watchFiles.options.ignored` to support glob string patterns via `tinyglobby`.
diff --git a/.changeset/update-http-proxy-middleware-v4.md b/.changeset/update-http-proxy-middleware-v4.md
@@ -0,0 +1,5 @@
+---
+"webpack-dev-server": major
+---
+
+Update `http-proxy-middleware` to v4. See the [http-proxy-middleware v3 release notes](https://github.com/chimurai/http-proxy-middleware/releases/tag/v3.0.0) and [v4 release notes](https://github.com/chimurai/http-proxy-middleware/releases/tag/v4.0.0) for the full list of breaking changes.
diff --git a/.changeset/update-webpack-cli-v7.md b/.changeset/update-webpack-cli-v7.md
@@ -0,0 +1,5 @@
+---
+"webpack-dev-server": patch
+---
+
+Update `webpack-cli` to v7.0.2.
diff --git a/.changeset/update-webpack-dev-middleware.md b/.changeset/update-webpack-dev-middleware.md
@@ -0,0 +1,5 @@
+---
+"webpack-dev-server": major
+---
+
+Update `webpack-dev-middleware` to v8 and sync `originalUrl` for middleware compatibility. `server.middleware.getFilenameFromUrl()` is now asynchronous and resolves to `{ filename, extra: { stats, outputFileSystem } }`. See the [webpack-dev-middleware v8 release notes](https://github.com/webpack/webpack-dev-middleware/releases/tag/v8.0.0) for details.
diff --git a/.changeset/use-compiler-platform-target.md b/.changeset/use-compiler-platform-target.md
@@ -0,0 +1,5 @@
+---
+"webpack-dev-server": minor
+---
+
+Use `compiler.platform` to determine the target environment instead of inspecting the resolved `target` string.
diff --git a/.changeset/use-new-url-instead-of-url-parse.md b/.changeset/use-new-url-instead-of-url-parse.md
@@ -0,0 +1,5 @@
+---
+"webpack-dev-server": minor
+---
+
+Use the WHATWG `URL` API instead of the deprecated `url.parse`.
diff --git a/.cspell.json b/.cspell.json
@@ -74,7 +74,8 @@
     "hono",
     "privkey",
     "geomanist",
-    "nodenext"
+    "nodenext",
+    "WHATWG"
   ],
   "ignorePaths": [
     "CHANGELOG.md",
diff --git a/migration-v6.md b/migration-v6.md
@@ -6,6 +6,9 @@ This document serves as a migration guide for `webpack-dev-server@6.0.0`.
 
 - Minimum supported `Node.js` version is `22.15.0`.
 - Minimum supported `webpack` version is `5.101.0`.
+- The package is now published as **ESM-only**. Prefer `import` syntax. CommonJS consumers can still load it via [`require(esm)`](https://nodejs.org/api/modules.html#loading-ecmascript-modules-using-require), which is enabled by default in the supported Node.js versions (>= 22.15.0).
+- `webpack-dev-middleware` has been upgraded to **v8**. The most notable change for consumers is that `server.middleware.getFilenameFromUrl()` is now asynchronous and resolves to an object `{ filename, extra: { stats, outputFileSystem } }` instead of returning the filename synchronously. See the [webpack-dev-middleware v8 release notes](https://github.com/webpack/webpack-dev-middleware/releases/tag/v8.0.0) for the full list of changes.
+- The bundled Express has been upgraded to **v5**. This affects `setupMiddlewares`, the `app` option, and any custom middleware integration. Notably: path matching no longer supports the bare `*` wildcard (use `*splat` or named parameters), `req.query` is no longer mutable, and rejected promises in middleware are now forwarded to error handlers automatically. See the [Express 5 migration guide](https://expressjs.com/en/guide/migrating-5) for the full list of breaking changes.
 - Support for **SockJS** in the WebSocket transport has been removed. Now, only **native WebSocket** is supported, or **custom** client and server implementations can be used.
 - The options for passing to the `proxy` have changed. Please refer to the [http-proxy-middleware migration guide](https://github.com/chimurai/http-proxy-middleware/blob/master/MIGRATION.md) for details.
 - Remove support for the spdy server type.Use the http2 server type instead; however, since Express does not work correctly with it, a custom server (e.g., Connect or Hono) should be used.
diff --git a/package-lock.json b/package-lock.json

-Original file line number
+Diff line change
@@ @@ -0,0 +1,5 @@ @@
 +---
 +"webpack-dev-server": patch
 +---
++
 +Bump production dependencies, notably `open` to v11 and `p-retry` to v8.