vite-plugin-testem 1.0.0 → 1.0.2

package/CHANGELOG.md

@@ -0,0 +1,46 @@
+# Changelog
+
+All notable changes to this project will be documented in this file.
+
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
+and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+## [Unreleased]
+
+## [1.0.2] - 2026-10-07
+
+### Changed
+
+- Optional `testem` peer range is now `^3.20.0 || ^4.0.0-beta.1`. `^4.0.0` does not match `4.0.0-beta.1`.
+- Node.js engines are `^20.19.0 || ^22.12.0 || ^24.0.0 || >=26.0.0`. Node 25 is not supported.
+
+### Fixed
+
+- **`createTestemViteMiddleware`:** Transform `*.html` with Vite so `vitePluginTestem` injection runs in middleware mode. `appType` stays `custom`, so paths Vite does not serve still fall through to Testem.
+
+## [1.0.1] - 2026-04-19
+
+### Fixed
+
+- **`createTestemViteMiddleware`:** Strip Testem’s per-browser URL prefix (`/<sessionId>/…`) before forwarding to Vite so the runner page and assets resolve correctly when Testem opens `/:id/tests_run.html` (fixes “testem.js not loaded” / connection timeout in CI).
+
+## [1.0.0] - 2026-04-19
+
+First stable release: Vite plugin and Testem middleware helper for browser tests.
+
+### Install
+
+```bash
+npm install vite-plugin-testem --save-dev
+```
+
+Install a compatible **Vite** version (peer dependency: `^7.0.0 || ^8.0.0`). To run browser tests with Testem, install **Testem** (optional peer: `^3.20.0`):
+
+```bash
+npm install testem@^3.20.0 --save-dev
+```
+
+### Links
+
+- **npm:** [vite-plugin-testem](https://www.npmjs.com/package/vite-plugin-testem)
+- **Docs:** [README on GitHub](https://github.com/Gaurav0/vite-plugin-testem#readme)

package/README.md

@@ -8,12 +8,16 @@
 npm install vite-plugin-testem --save-dev
 ```
 
+Node.js `^20.19.0 || ^22.12.0 || ^24.0.0 || >=26.0.0` is required.
+
 You must also install a compatible Vite version (peer dependency: `^7.0.0 || ^8.0.0`).
 
-To run browser tests with Testem, install Testem in your project (optional peer dependency: `^3.20.0`):
+To run browser tests with Testem, install Testem in your project (optional peer dependency: `^3.20.0 || ^4.0.0-beta.1`):
 
 ```bash
 npm install testem@^3.20.0 --save-dev
+# or, on Node ^22.17.0 || ^24.0.0 || >=26.0.0:
+npm install testem@^4.0.0-beta.1 --save-dev
 ```
 
 ## `vitePluginTestem(options)`
@@ -65,6 +69,16 @@ module.exports = async function testemConfig() {
 };
 ```
 
+## Development
+
+`npm test` runs the smoke test. It does not need Testem or a browser.
+
+`npm run test:integration` installs Testem into `fixtures/integration` and runs headless Chrome. `TESTEM_VERSION` defaults to `3.20.0`. Testem 4 needs Chrome and Node `^22.17.0 || ^24.0.0 || >=26.0.0`:
+
+```bash
+TESTEM_VERSION=4.0.0-beta.1 npm run test:integration
+```
+
 ## License
 
 MIT

package/index.js

@@ -1,5 +1,6 @@
 'use strict';
 
+const fs = require('fs/promises');
 const path = require('path');
 const vite = require('vite');
 
@@ -47,6 +48,9 @@ Testem.handleConsoleMessage = function (msg) {
 
 /**
  * Creates Express middleware (for Testem `middleware:`) that forwards requests to Vite in middleware mode.
+ * Strips Testem’s per-browser session prefix (`/:id/…`) so Vite resolves paths from the project root.
+ * Transforms `*.html` with `server.transformIndexHtml` so plugins such as `vitePluginTestem` run.
+ * `appType: 'custom'` stays in place so a missing file falls through to Testem instead of Vite’s 404.
  * Skips `/testem.js`, `/testem/*`, and `/socket.io` so Testem’s own routes run later in the stack.
  *
  * @param {import('vite').InlineConfig} [inlineConfig] merged after defaults; set `configFile: false` to skip loading `vite.config.js`
@@ -76,7 +80,23 @@ async function createTestemViteMiddleware(inlineConfig = {}) {
 
   function middleware(app) {
     app.use((req, res, next) => {
-      const pathname = req.url.split('?')[0];
+      let url = req.url;
+      const qIdx = url.indexOf('?');
+      const pathPart = qIdx === -1 ? url : url.slice(0, qIdx);
+      const queryPart = qIdx === -1 ? '' : url.slice(qIdx);
+      // Testem opens the runner under /:id/… (browser session). Strip it so Vite resolves files
+      // from project root (same path layout as bare /tests_run.html).
+      const withPath = pathPart.match(/^\/-?\d+\/(.+)$/);
+      const idOnly = pathPart.match(/^\/-?\d+$/);
+      if (withPath) {
+        req.url = `/${withPath[1]}${queryPart}`;
+        url = req.url;
+      } else if (idOnly) {
+        req.url = `/${queryPart}`;
+        url = req.url;
+      }
+
+      const pathname = url.split('?')[0];
       if (
         pathname === '/testem.js' ||
         pathname.startsWith('/testem/') ||
@@ -84,6 +104,29 @@ async function createTestemViteMiddleware(inlineConfig = {}) {
       ) {
         return next();
       }
+
+      if (pathname.endsWith('.html')) {
+        const rootPath = path.resolve(cwd);
+        const filePath = path.resolve(rootPath, pathname.slice(1));
+        const relative = path.relative(rootPath, filePath);
+        if (!relative.startsWith('..') && !path.isAbsolute(relative)) {
+          fs.readFile(filePath, 'utf8')
+            .then((html) => server.transformIndexHtml(url, html))
+            .then((html) => {
+              res.statusCode = 200;
+              res.setHeader('Content-Type', 'text/html; charset=utf-8');
+              res.end(html);
+            })
+            .catch((err) => {
+              if (err && err.code === 'ENOENT') {
+                return server.middlewares(req, res, next);
+              }
+              return next(err);
+            });
+          return;
+        }
+      }
+
       server.middlewares(req, res, next);
     });
   }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "vite-plugin-testem",
-  "version": "1.0.0",
+  "version": "1.0.2",
   "description": "Vite plugin and Testem middleware helper for running browser tests with Testem",
   "keywords": [
     "vite",
@@ -19,7 +19,7 @@
     "url": "https://github.com/Gaurav0/vite-plugin-testem/issues"
   },
   "engines": {
-    "node": "^20.19.0 || ^22.12.0 || >=24.0.0"
+    "node": "^20.19.0 || ^22.12.0 || ^24.0.0 || >=26.0.0"
   },
   "main": "./index.js",
   "exports": {
@@ -31,11 +31,12 @@
   "files": [
     "index.js",
     "README.md",
+    "CHANGELOG.md",
     "LICENSE"
   ],
   "peerDependencies": {
     "vite": "^7.0.0 || ^8.0.0",
-    "testem": "^3.20.0"
+    "testem": "^3.20.0 || ^4.0.0-beta.1"
   },
   "peerDependenciesMeta": {
     "testem": {
@@ -44,7 +45,8 @@
   },
   "scripts": {
     "lint": "eslint .",
-    "test": "node scripts/smoke-test.js"
+    "test": "node scripts/smoke-test.js",
+    "test:integration": "node scripts/integration-test.js"
   },
   "devDependencies": {
     "@eslint/js": "^10.0.0",