mb-run 1.1.4-dev-20261026-e0e9bae → 1.1.4

package/CHANGELOG.md

@@ -22,12 +22,22 @@ If you like this project and find it useful, please consider giving it a star on
 
 <a href="https://www.buymeacoffee.com/luligugithub"><img src="https://matterbridge.io/assets/bmc-button.svg" alt="Buy me a coffee" width="120"></a>
 
-## [1.1.4] - Dev branch
+## [1.1.4] - 2026-10-28
 
 ### Changed
 
+- [upgrade]: Install jsdom in root devDependencies when `automator.frontend` is true.
+- [upgrade]: Align frontend package scripts with the frontend template when `automator.frontend` is true.
+- [upgrade]: Copy frontend TypeScript and Vitest configuration from the template when `automator.frontend` is true.
 - [template]: Update `.vscode/tasks.json` to 1.0.8: add `local` after `--pack` in the `Pack`, `Pack Minify` and `Pack Obfuscate` tasks.
 - [template]: Update the plugin frontend guide to v.1.0.1: build API URLs from Vite's base URL to preserve Home Assistant Ingress paths.
+- [package]: Bump `rollup` to v.4.65.1.
+- [package]: Bump `oxfmt` to v.0.75.0.
+- [package]: Bump `oxlint` to v.1.90.0.
+
+### Fixed
+
+- [scripts]: Update `downloads.mjs` to v.2.1.0 in the package and the template: query an explicit 30-day date range instead of the npm `last-month` period, which returns stale data.
 
 <a href="https://www.buymeacoffee.com/luligugithub"><img src="https://matterbridge.io/assets/bmc-button.svg" alt="Buy me a coffee" width="80"></a>
 

package/dist/upgrade.js

@@ -595,6 +595,36 @@ export async function runPackageJsonUpgrade(opts, pkgPath, pkgJson, isMonorepo =
                 : undefined,
         };
     }
+    if (!isWorkspace && automator?.frontend === true) {
+        copyRecursive('apps/frontend/tsconfig.json', 'apps/frontend/tsconfig.json');
+        copyRecursive('apps/frontend/vitest.config.ts', 'apps/frontend/vitest.config.ts');
+    }
+    if (!isWorkspace && automator?.frontend === true) {
+        const frontendPkgPath = path.join(path.dirname(pkgPath), 'apps', 'frontend', 'package.json');
+        const frontendPackageJson = JSON.parse(readFileSync(frontendPkgPath, 'utf8'));
+        frontendPackageJson.scripts = {
+            'dev': 'vite',
+            'build': 'vite build',
+            'preview': 'vite preview',
+            'typecheck': 'tsc --project tsconfig.json --noEmit',
+            'test': 'vitest run',
+            'test:watch': 'vitest watch',
+            'test:verbose': 'vitest run --reporter verbose',
+            'test:coverage': 'vitest run --coverage --coverage.thresholds.statements=100 --coverage.thresholds.branches=100 --coverage.thresholds.lines=100 --coverage.thresholds.functions=100',
+            'lint': 'oxlint',
+            'lint:fix': 'oxlint --fix',
+            'format': 'oxfmt',
+            'format:check': 'oxfmt --check',
+            'clean': 'node ../../scripts/clean.mjs',
+            'deepClean': 'node ../../scripts/deep-clean.mjs',
+            'reset': 'npm run deepClean && npm run softReset',
+            'softReset': 'npm install --no-fund --no-audit && npm prune --no-fund --no-audit && npm run build && npm run typecheck',
+            'checkDependencies': 'npx --yes --package npm-check-updates@latest ncu',
+            'updateDependencies': 'npx --yes --package npm-check-updates@latest ncu -u && npm run softReset',
+            'runMeBeforePublish': 'npm run format && npm run lint && npm run build && npm run typecheck',
+        };
+        writeFileSync(frontendPkgPath, JSON.stringify(frontendPackageJson, null, 2) + '\n', 'utf8');
+    }
     const devDeps = pkgJson.devDependencies;
     delete devDeps?.['npm-check-updates'];
     delete devDeps?.['shx'];
@@ -644,6 +674,7 @@ export async function runPackageJsonUpgrade(opts, pkgPath, pkgJson, isMonorepo =
             : `npm install --no-fund --no-audit --save-dev --save-exact ${opts.useNode ? `@types/node` : ''} ${opts.useBun ? '@types/bun' : ''} ${automator?.jestTypes ? '@types/jest' : ''} ${automator?.vitestTypes ? 'vitest' : ''} typescript oxlint oxlint-tsgolint oxfmt`,
         opts.enableJest ? `npm install --no-fund --no-audit --save-dev --save-exact jest ts-jest @types/jest @jest/globals cross-env` : null,
         opts.enableVitest ? `npm install --no-fund --no-audit --save-dev --save-exact vitest @vitest/coverage-v8` : null,
+        !isWorkspace && automator?.frontend === true ? `npm install --no-fund --no-audit --save-dev --save-exact jsdom` : null,
         `npm prune --no-fund --no-audit`,
         isPlugin && !isWorkspace ? `npm link --no-fund --no-audit matterbridge` : null,
         isWorkspace ? null : `npm run format`,

package/npm-shrinkwrap.json

@@ -1,12 +1,12 @@
 {
   "name": "mb-run",
-  "version": "1.1.4-dev-20261026-e0e9bae",
+  "version": "1.1.4",
   "lockfileVersion": 3,
   "requires": true,
   "packages": {
     "": {
       "name": "mb-run",
-      "version": "1.1.4-dev-20261026-e0e9bae",
+      "version": "1.1.4",
       "license": "Apache-2.0",
       "dependencies": {
         "@typescript/typescript6": "6.0.2",
@@ -14,7 +14,7 @@
         "esbuild": "0.28.2",
         "javascript-obfuscator": "5.9.0",
         "npm-check-updates": "23.1.1",
-        "rollup": "4.65.0",
+        "rollup": "4.65.1",
         "rollup-plugin-dts": "6.5.1"
       },
       "bin": {
@@ -620,9 +620,9 @@
       }
     },
     "node_modules/@rollup/rollup-android-arm-eabi": {
-      "version": "4.65.0",
-      "resolved": "https://registry.npmjs.org/@rollup/rollup-android-arm-eabi/-/rollup-android-arm-eabi-4.65.0.tgz",
-      "integrity": "sha512-t2AnVba25baFdq7gczzS13JyVcdubLVbFX1X04mxrggDrTQPUXNv3XM0k9H1hr5tqvg7AVvtQ720QHAj0iYqhg==",
+      "version": "4.65.1",
+      "resolved": "https://registry.npmjs.org/@rollup/rollup-android-arm-eabi/-/rollup-android-arm-eabi-4.65.1.tgz",
+      "integrity": "sha512-5coxNSjqOI2J3NkVhlp3u+zGcyjnowQFsU9sg7MMz4UPXY4Dv63kFGLt7ConXz9CNq2i0yuOJZAF/2RMrgI2OA==",
       "cpu": [
         "arm"
       ],
@@ -633,9 +633,9 @@
       ]
     },
     "node_modules/@rollup/rollup-android-arm64": {
-      "version": "4.65.0",
-      "resolved": "https://registry.npmjs.org/@rollup/rollup-android-arm64/-/rollup-android-arm64-4.65.0.tgz",
-      "integrity": "sha512-dNONUaEwPGhl/nuO2KV8VABWlcjYyU6KtZGN8dQv5OS5JU7JSCxPijVNKXbRJd0iuTzTiJ4TjPt/4bbvDRNiMQ==",
+      "version": "4.65.1",
+      "resolved": "https://registry.npmjs.org/@rollup/rollup-android-arm64/-/rollup-android-arm64-4.65.1.tgz",
+      "integrity": "sha512-K0HFf6XMB3IYs+jDZ1/RRhZaVOwxNXrl0n4MDEyGDjuK7+B6K/nDJp8DCBitO3S1sK/fzNxAf9QZAny4AIUPtg==",
       "cpu": [
         "arm64"
       ],
@@ -646,9 +646,9 @@
       ]
     },
     "node_modules/@rollup/rollup-darwin-arm64": {
-      "version": "4.65.0",
-      "resolved": "https://registry.npmjs.org/@rollup/rollup-darwin-arm64/-/rollup-darwin-arm64-4.65.0.tgz",
-      "integrity": "sha512-zWQqUH+9zavr2Bxuzfpuv2SIF3X31cr58TvSQC9o1GhpOvkqRwr60GkZdQcudyT/BEgdpdSafjgd2I13MbTL7g==",
+      "version": "4.65.1",
+      "resolved": "https://registry.npmjs.org/@rollup/rollup-darwin-arm64/-/rollup-darwin-arm64-4.65.1.tgz",
+      "integrity": "sha512-zkZrXYwNlIcSUmcwY2DpsaDHr0XjVUeQHCuSunG3eQD7/5Wn/DvI7OMUE8NRRweK87yG8ebJ1xGOzmwpMsbZQA==",
       "cpu": [
         "arm64"
       ],
@@ -659,9 +659,9 @@
       ]
     },
     "node_modules/@rollup/rollup-darwin-x64": {
-      "version": "4.65.0",
-      "resolved": "https://registry.npmjs.org/@rollup/rollup-darwin-x64/-/rollup-darwin-x64-4.65.0.tgz",
-      "integrity": "sha512-RQYreBFWtO4//hIuOaZkYUnF/lPU4lz35dveDimDshWCJvVisVtJ/shmT9bkXK8wFJY+FJF89X6F3Cq1qI3LCw==",
+      "version": "4.65.1",
+      "resolved": "https://registry.npmjs.org/@rollup/rollup-darwin-x64/-/rollup-darwin-x64-4.65.1.tgz",
+      "integrity": "sha512-Zaed+R3cpkkA3aiNd7NO0GV5KFh/LVf8j6bGcoRdpoXkSm/mWH8M0oX2/3u/nyGcx/bHEovD9CzX+w9/gcpI4A==",
       "cpu": [
         "x64"
       ],
@@ -672,9 +672,9 @@
       ]
     },
     "node_modules/@rollup/rollup-freebsd-arm64": {
-      "version": "4.65.0",
-      "resolved": "https://registry.npmjs.org/@rollup/rollup-freebsd-arm64/-/rollup-freebsd-arm64-4.65.0.tgz",
-      "integrity": "sha512-A0NfMj6Cuh/9BE5k3awJKv6HoxFVXIcLAb6SZqAMoxUHPA1ZNNK4RsGuUPD/vL7nEAm9LG+ZzXWWTrnC0XtkpA==",
+      "version": "4.65.1",
+      "resolved": "https://registry.npmjs.org/@rollup/rollup-freebsd-arm64/-/rollup-freebsd-arm64-4.65.1.tgz",
+      "integrity": "sha512-h12p3WJWhyJ9kir0zqAPr0rKNmBzOWIjoaOMT9OULs9KZQZCeOMKd+mGSvERjd9VxJYShd3zIxtrVxkYz6BEVA==",
       "cpu": [
         "arm64"
       ],
@@ -685,9 +685,9 @@
       ]
     },
     "node_modules/@rollup/rollup-freebsd-x64": {
-      "version": "4.65.0",
-      "resolved": "https://registry.npmjs.org/@rollup/rollup-freebsd-x64/-/rollup-freebsd-x64-4.65.0.tgz",
-      "integrity": "sha512-BI6/H7q3aP0I7S7GOrjyxTjgEJlSnovXE38+bdxBpuKN6z+d//uF+T+VQ3Q7ltJL/71p17ufartARX9Ja5gOGQ==",
+      "version": "4.65.1",
+      "resolved": "https://registry.npmjs.org/@rollup/rollup-freebsd-x64/-/rollup-freebsd-x64-4.65.1.tgz",
+      "integrity": "sha512-yRBwh/5imKY4DydDulVtrjy8Jf7h7NQJUqZbgmZ3zFsCD9QqlnWvZ7RtEF+ecO1b+IukKjXlu5Bb9fehV3tIbg==",
       "cpu": [
         "x64"
       ],
@@ -698,9 +698,9 @@
       ]
     },
     "node_modules/@rollup/rollup-linux-arm-gnueabihf": {
-      "version": "4.65.0",
-      "resolved": "https://registry.npmjs.org/@rollup/rollup-linux-arm-gnueabihf/-/rollup-linux-arm-gnueabihf-4.65.0.tgz",
-      "integrity": "sha512-W1vUprf09RWaVWnsFP1vlUkEWJzTZlpObOEAYZXt9Fq0UVAOYEkeGr7wBX7McKqqIQskXdBnpiOMgwPujordgA==",
+      "version": "4.65.1",
+      "resolved": "https://registry.npmjs.org/@rollup/rollup-linux-arm-gnueabihf/-/rollup-linux-arm-gnueabihf-4.65.1.tgz",
+      "integrity": "sha512-1XuPiWYYaLE1UDOqhbKVOfsqxvfmFS/lYPSk92U1hEX1qRfSYH0hNeAlbxFIgjp4d6+YQmL95EPRgdvjbZEddA==",
       "cpu": [
         "arm"
       ],
@@ -714,9 +714,9 @@
       ]
     },
     "node_modules/@rollup/rollup-linux-arm-musleabihf": {
-      "version": "4.65.0",
-      "resolved": "https://registry.npmjs.org/@rollup/rollup-linux-arm-musleabihf/-/rollup-linux-arm-musleabihf-4.65.0.tgz",
-      "integrity": "sha512-s8QTcZWgrl9haFzEGIqyE5BWyo89pFDGLMBFZ752WYxk8DJwNU/O1X6pZgPw829d9/sm6CCHyrMP3aurt76p1Q==",
+      "version": "4.65.1",
+      "resolved": "https://registry.npmjs.org/@rollup/rollup-linux-arm-musleabihf/-/rollup-linux-arm-musleabihf-4.65.1.tgz",
+      "integrity": "sha512-Y3C5e55Yrf6p2r5rBcc4P9hFWVNi6oqWy/53I/AyCJJGlp3KRSpTP8eoUmVntchTbEnhgBgAgLO9flj9AvOdUw==",
       "cpu": [
         "arm"
       ],
@@ -730,9 +730,9 @@
       ]
     },
     "node_modules/@rollup/rollup-linux-arm64-gnu": {
-      "version": "4.65.0",
-      "resolved": "https://registry.npmjs.org/@rollup/rollup-linux-arm64-gnu/-/rollup-linux-arm64-gnu-4.65.0.tgz",
-      "integrity": "sha512-ke1f6dLRzkqveyjjF2fkEwQYZvxHtNNwjegY8nJrwcO0Bdqr8CzFO/pKE0Bns13cx0qz2Ba2Y0Hs3dSwMdnHxA==",
+      "version": "4.65.1",
+      "resolved": "https://registry.npmjs.org/@rollup/rollup-linux-arm64-gnu/-/rollup-linux-arm64-gnu-4.65.1.tgz",
+      "integrity": "sha512-Itj6coSswkYPIcVLczObXmwdplHNQQxyfnK1ppBg4czDaX8RiEzLKqU7EMc64BiBuiDZEUS+M93ktM18rv5llw==",
       "cpu": [
         "arm64"
       ],
@@ -746,9 +746,9 @@
       ]
     },
     "node_modules/@rollup/rollup-linux-arm64-musl": {
-      "version": "4.65.0",
-      "resolved": "https://registry.npmjs.org/@rollup/rollup-linux-arm64-musl/-/rollup-linux-arm64-musl-4.65.0.tgz",
-      "integrity": "sha512-926SMeUcy4y18Rz/w2aJiUKOnyAnm6czg72bXkQEaeemsll+Wr0hnsjb2BGRpHvWgwAMYy5ACJCotbvfLCfj0A==",
+      "version": "4.65.1",
+      "resolved": "https://registry.npmjs.org/@rollup/rollup-linux-arm64-musl/-/rollup-linux-arm64-musl-4.65.1.tgz",
+      "integrity": "sha512-KeO8jTEqdrnhvcahufbimyMoI44vedRUp1bVz2QUnRX2vDm/hxzCPt5F8fERVD5fsHyTW/vXmCElT054VOSVOA==",
       "cpu": [
         "arm64"
       ],
@@ -762,9 +762,9 @@
       ]
     },
     "node_modules/@rollup/rollup-linux-loong64-gnu": {
-      "version": "4.65.0",
-      "resolved": "https://registry.npmjs.org/@rollup/rollup-linux-loong64-gnu/-/rollup-linux-loong64-gnu-4.65.0.tgz",
-      "integrity": "sha512-6T7JNRP1hc4hqF2dUsEoVLOt9K8tmODoCLldtQRYnrddGGQY8Gqe2pM/qMMUo7EMowpP7oa2N95k0/8sYK/ipw==",
+      "version": "4.65.1",
+      "resolved": "https://registry.npmjs.org/@rollup/rollup-linux-loong64-gnu/-/rollup-linux-loong64-gnu-4.65.1.tgz",
+      "integrity": "sha512-dDOz5VZZ+ZGnglpmET6VJefamWXFsgaVtuhSClf2/URZBp048jprD6z1hddsIMN6n1w+oUzGZEBp9u6Mlszsfg==",
       "cpu": [
         "loong64"
       ],
@@ -778,9 +778,9 @@
       ]
     },
     "node_modules/@rollup/rollup-linux-loong64-musl": {
-      "version": "4.65.0",
-      "resolved": "https://registry.npmjs.org/@rollup/rollup-linux-loong64-musl/-/rollup-linux-loong64-musl-4.65.0.tgz",
-      "integrity": "sha512-SImGFl1Je5kpyAgOCPONVT7h6ASV8mAUwGRjY7eZvVjPg//PfHOXgI+P241RF/+HqsA4PP3qD527ysWFKNQyhQ==",
+      "version": "4.65.1",
+      "resolved": "https://registry.npmjs.org/@rollup/rollup-linux-loong64-musl/-/rollup-linux-loong64-musl-4.65.1.tgz",
+      "integrity": "sha512-JbfRKz8nJCuo8gn1Dqx8lQWEHw4qhZ3uRaHphw5vrSjnSptJTKTRC/bLKHh8QQMsEnhL4uq+bdg3tkiXbJ2q/A==",
       "cpu": [
         "loong64"
       ],
@@ -794,9 +794,9 @@
       ]
     },
     "node_modules/@rollup/rollup-linux-ppc64-gnu": {
-      "version": "4.65.0",
-      "resolved": "https://registry.npmjs.org/@rollup/rollup-linux-ppc64-gnu/-/rollup-linux-ppc64-gnu-4.65.0.tgz",
-      "integrity": "sha512-XeDTbmPF1Yu5asfXGPrMkWoxTDhgryQbmw5Q1+R582O51VNCk23J6f2pDrsAp5YkneBVBwtExx6ZGOb9D2aQ6A==",
+      "version": "4.65.1",
+      "resolved": "https://registry.npmjs.org/@rollup/rollup-linux-ppc64-gnu/-/rollup-linux-ppc64-gnu-4.65.1.tgz",
+      "integrity": "sha512-3oQpe1q0emSeCAssVHMQdOz5fz3PBH5my/Fr0ZekV2UMNL4ZiRa1ciikYlGQXyDkeqseYYv1InwOY8YPqY7RIQ==",
       "cpu": [
         "ppc64"
       ],
@@ -810,9 +810,9 @@
       ]
     },
     "node_modules/@rollup/rollup-linux-ppc64-musl": {
-      "version": "4.65.0",
-      "resolved": "https://registry.npmjs.org/@rollup/rollup-linux-ppc64-musl/-/rollup-linux-ppc64-musl-4.65.0.tgz",
-      "integrity": "sha512-VS55JUI/1nsljmV/jfqNkLZXFw8uMO8nNlfoHmSevNf6fO3neuhyDvx9dv3c/Ytt8r/431SL8Qax1dpYvOMZTg==",
+      "version": "4.65.1",
+      "resolved": "https://registry.npmjs.org/@rollup/rollup-linux-ppc64-musl/-/rollup-linux-ppc64-musl-4.65.1.tgz",
+      "integrity": "sha512-nNV3HHi23o1LtpGGwH+Bav4hqnc4+klQtC96tSvCfvql8bLlNFTnTFiGl/jai2nve3eEr/vT2ocuyf+h+eMnYQ==",
       "cpu": [
         "ppc64"
       ],
@@ -826,9 +826,9 @@
       ]
     },
     "node_modules/@rollup/rollup-linux-riscv64-gnu": {
-      "version": "4.65.0",
-      "resolved": "https://registry.npmjs.org/@rollup/rollup-linux-riscv64-gnu/-/rollup-linux-riscv64-gnu-4.65.0.tgz",
-      "integrity": "sha512-Vblw84TbX7RS4la1Y4+yQ7aore/oSyaNtFbppuBr5Vs/4LfBeXKq9dIfoExw6zOvRERqd2rRAjnZRaMhH/0x5w==",
+      "version": "4.65.1",
+      "resolved": "https://registry.npmjs.org/@rollup/rollup-linux-riscv64-gnu/-/rollup-linux-riscv64-gnu-4.65.1.tgz",
+      "integrity": "sha512-b5zab0FryBxuocuDeqOsYGAg2EzjKw4mKA6LjQXCyewXjGv/BXqACBsY2cO45xM4hV2weYtdjGThP2VB2ByAYg==",
       "cpu": [
         "riscv64"
       ],
@@ -842,9 +842,9 @@
       ]
     },
     "node_modules/@rollup/rollup-linux-riscv64-musl": {
-      "version": "4.65.0",
-      "resolved": "https://registry.npmjs.org/@rollup/rollup-linux-riscv64-musl/-/rollup-linux-riscv64-musl-4.65.0.tgz",
-      "integrity": "sha512-7+gHjtONvKgwR9InTKFaLq53f6YzBJkgeMRBENdWTsQr+spahGqQm8HF5aXpq8i4JaRrOqYyv6Zn1WltDTxaZQ==",
+      "version": "4.65.1",
+      "resolved": "https://registry.npmjs.org/@rollup/rollup-linux-riscv64-musl/-/rollup-linux-riscv64-musl-4.65.1.tgz",
+      "integrity": "sha512-Rh08xZakiUxKNgI3hbgH9mivlx478lSqckS9s+Oc3/TX1VrAH3W8z/5wpJXR/v5VjqcJ/jJNVBg64PU1+iQsTQ==",
       "cpu": [
         "riscv64"
       ],
@@ -858,9 +858,9 @@
       ]
     },
     "node_modules/@rollup/rollup-linux-s390x-gnu": {
-      "version": "4.65.0",
-      "resolved": "https://registry.npmjs.org/@rollup/rollup-linux-s390x-gnu/-/rollup-linux-s390x-gnu-4.65.0.tgz",
-      "integrity": "sha512-KvNDC0J6s4vVHhtJ6KrDXU0Er0au/hmRIBq/+1maCV8TseGupeKizq0bWcrbp2HE1T8xoknvN0Q/KZ/YF0qX3w==",
+      "version": "4.65.1",
+      "resolved": "https://registry.npmjs.org/@rollup/rollup-linux-s390x-gnu/-/rollup-linux-s390x-gnu-4.65.1.tgz",
+      "integrity": "sha512-qDgtS6juN3/k97y4kcD6XLFpXEo4f6CnG8lTOGYwlhrUYTrMyhN0WHdZCPAW5rqS0MqQG7qI7dxnjugt6QB39Q==",
       "cpu": [
         "s390x"
       ],
@@ -874,9 +874,9 @@
       ]
     },
     "node_modules/@rollup/rollup-linux-x64-gnu": {
-      "version": "4.65.0",
-      "resolved": "https://registry.npmjs.org/@rollup/rollup-linux-x64-gnu/-/rollup-linux-x64-gnu-4.65.0.tgz",
-      "integrity": "sha512-GExdD15WPvu/x/drELjVam7vX8EsPgvTMOa/iJL/p/4m/oOqzbb7JXZg8fXR4hlXtg/sF2zyTZ3bR0AEtEMlhQ==",
+      "version": "4.65.1",
+      "resolved": "https://registry.npmjs.org/@rollup/rollup-linux-x64-gnu/-/rollup-linux-x64-gnu-4.65.1.tgz",
+      "integrity": "sha512-44IKzBPqXXVm0kt1O+F5eW4juR5FyIxGNlFkpP8qwIDzucBsjM1HCbdYUQrQw8rU/g6HRl/tfBm0+Qq4H4Ro3w==",
       "cpu": [
         "x64"
       ],
@@ -890,9 +890,9 @@
       ]
     },
     "node_modules/@rollup/rollup-linux-x64-musl": {
-      "version": "4.65.0",
-      "resolved": "https://registry.npmjs.org/@rollup/rollup-linux-x64-musl/-/rollup-linux-x64-musl-4.65.0.tgz",
-      "integrity": "sha512-8sT9PemIZfIMED4Vd4KGoOXVDj5CMSWNcGdbheRUx9TYS03yOWdT2Q0lXPyEyNBB9YTilwewIQKNIBk6Nxi0Kg==",
+      "version": "4.65.1",
+      "resolved": "https://registry.npmjs.org/@rollup/rollup-linux-x64-musl/-/rollup-linux-x64-musl-4.65.1.tgz",
+      "integrity": "sha512-tvYWZ/h2PCHs558Xu7B6LptuRCV8lXV2xI75ONMcldII1m2zlFwuI4BJZi9M6rSMkYqcPLLtPUPrjyqfbzLOdg==",
       "cpu": [
         "x64"
       ],
@@ -906,9 +906,9 @@
       ]
     },
     "node_modules/@rollup/rollup-openbsd-x64": {
-      "version": "4.65.0",
-      "resolved": "https://registry.npmjs.org/@rollup/rollup-openbsd-x64/-/rollup-openbsd-x64-4.65.0.tgz",
-      "integrity": "sha512-pO6Ehi0jo5yE0R6PltKhJhv9mlIiyzBJk5N5NUF2OF6xtVKI+1bdXxj/rb0jGXy3hck1ELVT0QPY3tzkAm360w==",
+      "version": "4.65.1",
+      "resolved": "https://registry.npmjs.org/@rollup/rollup-openbsd-x64/-/rollup-openbsd-x64-4.65.1.tgz",
+      "integrity": "sha512-gdyeucgZCnei3pXwadKVTEAOgRx0B+c847DUPR/PdOMmp3olhfkYo6r0J4PzRFZB5ZICZQTxntyvgmWH5xT7rg==",
       "cpu": [
         "x64"
       ],
@@ -919,9 +919,9 @@
       ]
     },
     "node_modules/@rollup/rollup-openharmony-arm64": {
-      "version": "4.65.0",
-      "resolved": "https://registry.npmjs.org/@rollup/rollup-openharmony-arm64/-/rollup-openharmony-arm64-4.65.0.tgz",
-      "integrity": "sha512-vo7N3/+cjjPDYr8vtxC+qSNgWa9sDvJ7g8N8R5SWqFY4WiNH1ULcAU70SKVyHeiIZOYYwNP9pTipmhN5sl1NPw==",
+      "version": "4.65.1",
+      "resolved": "https://registry.npmjs.org/@rollup/rollup-openharmony-arm64/-/rollup-openharmony-arm64-4.65.1.tgz",
+      "integrity": "sha512-Wf/NEKdn2SAL4Nvt8HyDtdkseWTwiLbZEOoNYnEaHkbso0B9eHO42vKnZh+OYsn+IMhAMcWcuIwPlBOgOXsUzg==",
       "cpu": [
         "arm64"
       ],
@@ -932,9 +932,9 @@
       ]
     },
     "node_modules/@rollup/rollup-win32-arm64-msvc": {
-      "version": "4.65.0",
-      "resolved": "https://registry.npmjs.org/@rollup/rollup-win32-arm64-msvc/-/rollup-win32-arm64-msvc-4.65.0.tgz",
-      "integrity": "sha512-ArwvgFAbjKcDM7qqotZ4OVYf+UMT9xH2YzkCzK4+AuZSDihMlz1Ekoe4INwBVXzn2mnJzuIYOcSx07iTBijGRQ==",
+      "version": "4.65.1",
+      "resolved": "https://registry.npmjs.org/@rollup/rollup-win32-arm64-msvc/-/rollup-win32-arm64-msvc-4.65.1.tgz",
+      "integrity": "sha512-x9VSsDmsMsEWy4cr/mFeaEsXnVJ6Kc4NCAU/lCnwml3s7LQbZoa9+/qwc9etWHbuuDT5mYxdyyKUwo76njtjZw==",
       "cpu": [
         "arm64"
       ],
@@ -945,9 +945,9 @@
       ]
     },
     "node_modules/@rollup/rollup-win32-ia32-msvc": {
-      "version": "4.65.0",
-      "resolved": "https://registry.npmjs.org/@rollup/rollup-win32-ia32-msvc/-/rollup-win32-ia32-msvc-4.65.0.tgz",
-      "integrity": "sha512-QGMmK4/cxKE/36FoLMSHQBCyymv/eFTnsCvvsBF0rgmOvVbvX78VWZRerL3dHa77f4pM6Xcc2iGDhJ10w/svKQ==",
+      "version": "4.65.1",
+      "resolved": "https://registry.npmjs.org/@rollup/rollup-win32-ia32-msvc/-/rollup-win32-ia32-msvc-4.65.1.tgz",
+      "integrity": "sha512-RIDbiVvvLkN45mOFpbo6eYMgnuiBEB62BGR/0s4QJgGg2AvVxucDDNn67kpAcUoYyfmY8iX8/RifMcmxmmnejA==",
       "cpu": [
         "ia32"
       ],
@@ -958,9 +958,9 @@
       ]
     },
     "node_modules/@rollup/rollup-win32-x64-gnu": {
-      "version": "4.65.0",
-      "resolved": "https://registry.npmjs.org/@rollup/rollup-win32-x64-gnu/-/rollup-win32-x64-gnu-4.65.0.tgz",
-      "integrity": "sha512-XfKYFWHIPs4HPODIMsGF1IKlS3H1e3WokUZIgpmn4+uNnZBlnRDDHEylNyazbQXwhMKZre68OjtRYbKqb5+j8w==",
+      "version": "4.65.1",
+      "resolved": "https://registry.npmjs.org/@rollup/rollup-win32-x64-gnu/-/rollup-win32-x64-gnu-4.65.1.tgz",
+      "integrity": "sha512-+KN8HIr88vN59JNxlrM2fMimzY43Y0lQB7+0xdVsFbvFCAA74CLKCdfzIHzzvndJryBc94Pm+MvwtukKjaS2ug==",
       "cpu": [
         "x64"
       ],
@@ -971,9 +971,9 @@
       ]
     },
     "node_modules/@rollup/rollup-win32-x64-msvc": {
-      "version": "4.65.0",
-      "resolved": "https://registry.npmjs.org/@rollup/rollup-win32-x64-msvc/-/rollup-win32-x64-msvc-4.65.0.tgz",
-      "integrity": "sha512-wPWi++K4Bs1VR4XihOhfGi4IGX6Cub7FlerTf8X2v+2BtDHddgSqWCXwGD+h2yAe4/niIhNDwAltioOC+wEogQ==",
+      "version": "4.65.1",
+      "resolved": "https://registry.npmjs.org/@rollup/rollup-win32-x64-msvc/-/rollup-win32-x64-msvc-4.65.1.tgz",
+      "integrity": "sha512-+Y1Sd49cSDq60UOl8/U2HI0ebUvnSl/hDhMHQn+ouw17yb8fYwMWIazzJ4JFpSkjPE7sj5NTNSX9IoyEqcFfyQ==",
       "cpu": [
         "x64"
       ],
@@ -1496,24 +1496,6 @@
         "util": "^0.12.5"
       }
     },
-    "node_modules/async-function": {
-      "version": "1.0.0",
-      "resolved": "https://registry.npmjs.org/async-function/-/async-function-1.0.0.tgz",
-      "integrity": "sha512-hsU18Ae8CDTR6Kgu9DYf0EbCr/a5iGL0rytQDobUcdpYOKokk8LEjVphnXkDkgpi0wYVsqrXuP0bZxJaTqdgoA==",
-      "license": "MIT",
-      "engines": {
-        "node": ">= 0.4"
-      }
-    },
-    "node_modules/async-generator-function": {
-      "version": "1.0.0",
-      "resolved": "https://registry.npmjs.org/async-generator-function/-/async-generator-function-1.0.0.tgz",
-      "integrity": "sha512-+NAXNqgCrB95ya4Sr66i1CL2hqLVckAk7xwRYWdcm39/ELQ6YNn1aw5r0bdQtqNZgQpEWzc5yc/igXc7aL5SLA==",
-      "license": "MIT",
-      "engines": {
-        "node": ">= 0.4"
-      }
-    },
     "node_modules/async-retry": {
       "version": "1.3.3",
       "resolved": "https://registry.npmjs.org/async-retry/-/async-retry-1.3.3.tgz",
@@ -2008,19 +1990,16 @@
       }
     },
     "node_modules/get-intrinsic": {
-      "version": "1.3.1",
-      "resolved": "https://registry.npmjs.org/get-intrinsic/-/get-intrinsic-1.3.1.tgz",
-      "integrity": "sha512-fk1ZVEeOX9hVZ6QzoBNEC55+Ucqg4sTVwrVuigZhuRPESVFpMyXnd3sbXvPOwp7Y9riVyANiqhEuRF0G1aVSeQ==",
+      "version": "1.3.0",
+      "resolved": "https://registry.npmjs.org/get-intrinsic/-/get-intrinsic-1.3.0.tgz",
+      "integrity": "sha512-9fSjSaos/fRIVIp+xSJlE6lfwhES7LNtKaCBIamHsjr2na1BiABJPo0mOjjz8GJDURarmCPGqaiVg5mfjb98CQ==",
       "license": "MIT",
       "dependencies": {
-        "async-function": "^1.0.0",
-        "async-generator-function": "^1.0.0",
         "call-bind-apply-helpers": "^1.0.2",
         "es-define-property": "^1.0.1",
         "es-errors": "^1.3.0",
         "es-object-atoms": "^1.1.1",
         "function-bind": "^1.1.2",
-        "generator-function": "^2.0.0",
         "get-proto": "^1.0.1",
         "gopd": "^1.2.0",
         "has-symbols": "^1.1.0",
@@ -2637,9 +2616,9 @@
       }
     },
     "node_modules/rollup": {
-      "version": "4.65.0",
-      "resolved": "https://registry.npmjs.org/rollup/-/rollup-4.65.0.tgz",
-      "integrity": "sha512-QVCvQUTGDN6JRwi3jVGCY3H4aTHvi9rX0LyoBMkGUvdh/Z6O51CzcLz85BWZaTCDGhl6ySGqYZs+xI1jmPqGcw==",
+      "version": "4.65.1",
+      "resolved": "https://registry.npmjs.org/rollup/-/rollup-4.65.1.tgz",
+      "integrity": "sha512-HzD4IdphaPMvuAacnL/vtoq5B8FwqewKvxTtqYibWvP6VDyZ+UsTtlw5F8HIOIIpLQAkN2NOP/0sM3puo9xN/A==",
       "license": "MIT",
       "dependencies": {
         "@types/estree": "1.0.9"
@@ -2653,31 +2632,31 @@
       },
       "optionalDependencies": {
         "@napi-rs/lzma-linux-x64-gnu": "1.5.1",
-        "@rollup/rollup-android-arm-eabi": "4.65.0",
-        "@rollup/rollup-android-arm64": "4.65.0",
-        "@rollup/rollup-darwin-arm64": "4.65.0",
-        "@rollup/rollup-darwin-x64": "4.65.0",
-        "@rollup/rollup-freebsd-arm64": "4.65.0",
-        "@rollup/rollup-freebsd-x64": "4.65.0",
-        "@rollup/rollup-linux-arm-gnueabihf": "4.65.0",
-        "@rollup/rollup-linux-arm-musleabihf": "4.65.0",
-        "@rollup/rollup-linux-arm64-gnu": "4.65.0",
-        "@rollup/rollup-linux-arm64-musl": "4.65.0",
-        "@rollup/rollup-linux-loong64-gnu": "4.65.0",
-        "@rollup/rollup-linux-loong64-musl": "4.65.0",
-        "@rollup/rollup-linux-ppc64-gnu": "4.65.0",
-        "@rollup/rollup-linux-ppc64-musl": "4.65.0",
-        "@rollup/rollup-linux-riscv64-gnu": "4.65.0",
-        "@rollup/rollup-linux-riscv64-musl": "4.65.0",
-        "@rollup/rollup-linux-s390x-gnu": "4.65.0",
-        "@rollup/rollup-linux-x64-gnu": "4.65.0",
-        "@rollup/rollup-linux-x64-musl": "4.65.0",
-        "@rollup/rollup-openbsd-x64": "4.65.0",
-        "@rollup/rollup-openharmony-arm64": "4.65.0",
-        "@rollup/rollup-win32-arm64-msvc": "4.65.0",
-        "@rollup/rollup-win32-ia32-msvc": "4.65.0",
-        "@rollup/rollup-win32-x64-gnu": "4.65.0",
-        "@rollup/rollup-win32-x64-msvc": "4.65.0",
+        "@rollup/rollup-android-arm-eabi": "4.65.1",
+        "@rollup/rollup-android-arm64": "4.65.1",
+        "@rollup/rollup-darwin-arm64": "4.65.1",
+        "@rollup/rollup-darwin-x64": "4.65.1",
+        "@rollup/rollup-freebsd-arm64": "4.65.1",
+        "@rollup/rollup-freebsd-x64": "4.65.1",
+        "@rollup/rollup-linux-arm-gnueabihf": "4.65.1",
+        "@rollup/rollup-linux-arm-musleabihf": "4.65.1",
+        "@rollup/rollup-linux-arm64-gnu": "4.65.1",
+        "@rollup/rollup-linux-arm64-musl": "4.65.1",
+        "@rollup/rollup-linux-loong64-gnu": "4.65.1",
+        "@rollup/rollup-linux-loong64-musl": "4.65.1",
+        "@rollup/rollup-linux-ppc64-gnu": "4.65.1",
+        "@rollup/rollup-linux-ppc64-musl": "4.65.1",
+        "@rollup/rollup-linux-riscv64-gnu": "4.65.1",
+        "@rollup/rollup-linux-riscv64-musl": "4.65.1",
+        "@rollup/rollup-linux-s390x-gnu": "4.65.1",
+        "@rollup/rollup-linux-x64-gnu": "4.65.1",
+        "@rollup/rollup-linux-x64-musl": "4.65.1",
+        "@rollup/rollup-openbsd-x64": "4.65.1",
+        "@rollup/rollup-openharmony-arm64": "4.65.1",
+        "@rollup/rollup-win32-arm64-msvc": "4.65.1",
+        "@rollup/rollup-win32-ia32-msvc": "4.65.1",
+        "@rollup/rollup-win32-x64-gnu": "4.65.1",
+        "@rollup/rollup-win32-x64-msvc": "4.65.1",
         "fsevents": "~2.3.2"
       }
     },

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "mb-run",
-  "version": "1.1.4-dev-20261026-e0e9bae",
+  "version": "1.1.4",
   "description": "Matterbridge command line executor",
   "author": "https://github.com/Luligu",
   "license": "Apache-2.0",
@@ -71,7 +71,7 @@
     "esbuild": "0.28.2",
     "javascript-obfuscator": "5.9.0",
     "npm-check-updates": "23.1.1",
-    "rollup": "4.65.0",
+    "rollup": "4.65.1",
     "rollup-plugin-dts": "6.5.1"
   }
 }

package/template/.agents-plugin/rules/plugin-frontend.instructions.md

@@ -1,5 +1,5 @@
 ---
-description: 'How a plugin serves its own frontend SPA and custom REST API via onFetch v.1.0.1'
+description: 'How a plugin serves its own frontend SPA and custom REST API via onFetch v.1.0.2'
 ---
 
 # Matterbridge Plugin Frontend Guide
@@ -16,7 +16,7 @@ When a plugin package contains a built SPA at `apps/frontend/build/index.html`,
 - `/plugins/<pluginName>/api/:path` exposes the plugin REST namespace backed by `onFetch`, with JSON body parsing included.
 - `/plugins/<pluginName>/{*splat}` serves the plugin's `index.html` as the SPA fallback for unmatched routes.
 
-A plugin frontend must call its own `/plugins/<pluginName>/api/...` namespace rather than the core `/api/...` endpoints.
+A plugin frontend must call its own plugin API namespace (built from `import.meta.env.BASE_URL`, see below) rather than the core `/api/...` endpoints.
 
 ## Preserve the base path through Home Assistant Ingress
 
@@ -37,7 +37,19 @@ The frontend template's `vite.config.ts` uses `/plugins/<pluginName>/` as its de
 
 Do not hardcode `fetch('/plugins/<pluginName>/api/events')`, a core `/api/...` URL or the Matterbridge host/port in frontend code. A root-relative URL discards the Ingress prefix and sends the request outside the addon route. The absolute plugin paths listed above describe server routes, not URLs to hardcode in browser requests.
 
-Open the plugin frontend at its directory URL with a trailing slash, as Matterbridge does. Relative production URLs resolve against the document URL; if adding nested history-based SPA routes, ensure requests still resolve from the plugin root. Verify API requests during Vite development, direct Matterbridge access and Home Assistant Ingress access.
+## Open the plugin frontend with a trailing slash
+
+Matterbridge always opens a plugin frontend at its directory URL with a trailing slash (`<basePath>plugins/<pluginName>/`). This is required, not cosmetic:
+
+- **Relative URLs resolve against the document's directory.** The browser drops everything after the last `/` of the page URL. At `/plugins/my-plugin` the directory is `/plugins/`, so `./assets/index.js` becomes `/plugins/assets/index.js` and `./api/events` becomes `/plugins/api/events`. Both miss the plugin's routes, and the SPA does not even load its scripts and styles. At `/plugins/my-plugin/` they resolve to `/plugins/my-plugin/assets/index.js` and `/plugins/my-plugin/api/events`.
+- **The server redirect breaks under Ingress.** When a directory is requested without the slash, `express.static` answers with a 301 to the same path plus `/`. Behind Home Assistant Ingress the proxy has already stripped `/api/hassio_ingress/<token>`. The redirect therefore points to `/plugins/<pluginName>/` at the Home Assistant origin root, outside the add-on. Adding the slash in the client avoids the redirect.
+- **The slash goes on the path, before any query or hash.** The right form is `plugins/my-plugin/?device=1`; `plugins/my-plugin?device=1/` is wrong.
+
+A device `configUrl` that starts with `/plugins/<pluginName>` or `./plugins/<pluginName>` opens the plugin frontend in the Matterbridge dialog. Matterbridge prefixes the base path and inserts the trailing slash before any query string. Prefer writing it with the slash anyway (`./plugins/<pluginName>/?device=<id>`) so the URL is also correct when opened directly.
+
+Avoid nested history-based routes (for example `/plugins/<pluginName>/devices/42`). They change the document directory, and since the production `BASE_URL` is `./`, assets and API calls would resolve from the nested path. Use hash-based routing (`/plugins/<pluginName>/#/devices/42`) instead, which keeps the document at the plugin root.
+
+Verify API requests during Vite development, direct Matterbridge access and Home Assistant Ingress access.
 
 ## Use `onFetch` for a plugin's custom API
 
@@ -65,4 +77,4 @@ The base implementation only logs the request and returns `undefined`, so overri
 ## Avoid unsupported routing patterns
 
 - Do not invent custom WebSocket method names for plugin frontend traffic. The WebSocket dispatch list is fixed; use `onFetch` through `/plugins/<pluginName>/api/...`.
-- Do not call core `/api/...` routes from a plugin's custom frontend. Use the plugin's own `/plugins/<pluginName>/api/...` namespace.
+- Do not call core `/api/...` routes from a plugin's custom frontend. Use the plugin's own namespace via `${import.meta.env.BASE_URL}api/...`.

package/template/.claude-plugin/rules/plugin-frontend/plugin-frontend.instructions.md

@@ -1,5 +1,5 @@
 ---
-description: 'How a plugin serves its own frontend SPA and custom REST API via onFetch v.1.0.1'
+description: 'How a plugin serves its own frontend SPA and custom REST API via onFetch v.1.0.2'
 paths:
   - 'apps/frontend/**'
   - 'src/*.ts'

package/template/.github-plugin/instructions/plugin-frontend/plugin-frontend.instructions.md

@@ -1,5 +1,5 @@
 ---
-name: 'Matterbridge Plugin Frontend Guide v.1.0.1'
+name: 'Matterbridge Plugin Frontend Guide v.1.0.2'
 description: 'How a plugin serves its own frontend SPA and custom REST API via onFetch'
 applyTo: 'apps/frontend/**, src/*.ts'
 ---

package/template/apps/frontend/package.json

@@ -11,6 +11,10 @@
     "build": "vite build",
     "preview": "vite preview",
     "typecheck": "tsc --project tsconfig.json --noEmit",
+    "test": "vitest run",
+    "test:watch": "vitest watch",
+    "test:verbose": "vitest run --reporter verbose",
+    "test:coverage": "vitest run --coverage --coverage.thresholds.statements=100 --coverage.thresholds.branches=100 --coverage.thresholds.lines=100 --coverage.thresholds.functions=100",
     "lint": "oxlint",
     "lint:fix": "oxlint --fix",
     "format": "oxfmt",
@@ -35,6 +39,6 @@
     "@types/react": "19.3.0",
     "@types/react-dom": "19.3.0",
     "@vitejs/plugin-react": "6.1.2",
-    "vite": "8.3.4"
+    "vite": "8.3.5"
   }
 }

package/template/apps/frontend/tsconfig.json

@@ -1,27 +1,18 @@
-// tsconfig.json 1.0.0
+// apps/frontend/tsconfig.json v.1.0.0
 
-// This TypeScript configuration is designed for a Vite/React/TypeScript frontend using ESM modules.
+// This TypeScript configuration is designed for a Vite / React / TypeScript frontend.
 {
   "compilerOptions": {
     "target": "ESNext",
-    "lib": ["ESNext", "DOM", "DOM.Iterable"],
     "module": "ESNext",
-    "moduleResolution": "bundler",
+    "types": ["vite/client", "vitest/globals"],
     "jsx": "react-jsx",
-    "useDefineForClassFields": true,
-    "resolveJsonModule": true,
-    "allowImportingTsExtensions": true,
-    "verbatimModuleSyntax": true,
-    "isolatedModules": true,
-    "noEmit": true,
     "strict": true,
-    "noImplicitOverride": true,
-    "noUnusedLocals": true,
-    "noUnusedParameters": true,
-    "noFallthroughCasesInSwitch": true,
-    "forceConsistentCasingInFileNames": true,
+    "moduleResolution": "bundler",
+    "esModuleInterop": true,
+    "allowImportingTsExtensions": true,
     "skipLibCheck": true,
-    "types": ["vite/client"]
+    "noEmit": true
   },
-  "include": ["src"]
+  "include": ["src/**/*.ts", "src/**/*.tsx", "vitest/**/*.ts", "vitest/**/*.tsx", "vite.config.ts", "vitest.config.ts"]
 }

package/template/apps/frontend/vitest/theme.test.ts

@@ -0,0 +1,29 @@
+/**
+ * @file apps/frontend/vitest/theme.test.ts
+ * @description Tests for the frontend application theme.
+ * @author Luligu
+ */
+
+import { describe, expect, it } from 'vitest';
+
+import { createAppTheme } from '../src/theme.js';
+
+describe('createAppTheme', () => {
+  it('should create a light theme when the mode is light', () => {
+    const theme = createAppTheme('light');
+
+    expect(theme.palette.mode).toBe('light');
+    expect(theme.palette.primary.main).toBe('#1976d2');
+    expect(theme.palette.background.default).toBe('#fff');
+    expect(theme.palette.background.paper).toBe('#fff');
+  });
+
+  it('should create a dark theme when the mode is dark', () => {
+    const theme = createAppTheme('dark');
+
+    expect(theme.palette.mode).toBe('dark');
+    expect(theme.palette.primary.main).toBe('#1976d2');
+    expect(theme.palette.background.default).toBe('#121212');
+    expect(theme.palette.background.paper).toBe('#121212');
+  });
+});

package/template/apps/frontend/vitest.config.ts

@@ -0,0 +1,33 @@
+// apps/frontend/vitest.config.ts v.2.0.8
+
+// Vitest configuration file for a Vite / React / TypeScript frontend.
+
+import react from '@vitejs/plugin-react';
+import { defineConfig } from 'vitest/config';
+
+export default defineConfig({
+  envDir: false,
+  plugins: react(),
+  test: {
+    environment: 'jsdom',
+    globals: true,
+    // Disable Node's experimental built-in webstorage so the jsdom `localStorage` is used.
+    // It is a Node bootstrap flag, so it must be passed to the pool worker processes (where
+    // the tests run) via execArgv rather than set from within this config at runtime.
+    execArgv: ['--no-experimental-webstorage'],
+    // Every run also writes a JUnit XML report with the duration of each test (handy to find slow tests).
+    // A --reporter passed on the command line replaces this list.
+    reporters: ['default', 'junit'],
+    outputFile: { junit: '.cache/vitest/junit.xml' },
+    coverage: {
+      provider: 'v8',
+      reporter: ['lcov', 'text', 'json'],
+      thresholds: {
+        lines: 100,
+        functions: 100,
+        branches: 100,
+        statements: 100,
+      },
+    },
+  },
+});

package/template/scripts/downloads.mjs

@@ -1,8 +1,9 @@
 /**
  * downloads.mjs
- * Version: 2.0.0
+ * Version: 2.1.0
  *
- * Prints daily npm downloads for the last month for the package in ../package.json.
+ * Prints daily npm downloads for the last 30 days and today for the package in ../package.json.
+ * It queries an explicit date range because the npm `last-week` / `last-month` periods can return stale data.
  *
  * Usage:
  *   node scripts/downloads.mjs --version, -v  Show the script version
@@ -23,7 +24,13 @@ import { readFile } from 'node:fs/promises';
 import path from 'node:path';
 import { fileURLToPath } from 'node:url';
 
-const scriptVersion = '2.0.0';
+const scriptVersion = '2.1.0';
+
+/** Number of days before today to include in the range. */
+const rangeDays = 30;
+
+/** Maximum number of trailing zero days treated as not yet published by npm. */
+const maxPendingDays = 2;
 
 /**
  * @typedef {{ day: string, downloads: number }} DownloadRow
@@ -33,10 +40,6 @@ const scriptVersion = '2.0.0';
  * @typedef {{ start: string, end: string, package: string, downloads: DownloadRow[] }} NpmDownloadsRangeResponse
  */
 
-/**
- * @typedef {{ start: string, end: string, package: string, downloads: number }} NpmDownloadsPointResponse
- */
-
 /**
  * Builds the help text.
  *
@@ -46,7 +49,7 @@ function usage() {
   return [
     'Usage: node scripts/downloads.mjs [--dry-run|-n]',
     '',
-    'Print the daily npm downloads of the last month for the package in ../package.json.',
+    'Print the daily npm downloads of the last 30 days and today for the package in ../package.json.',
     '',
     '  --dry-run, -n  Print the package name without querying the npm registry',
     '  --version, -v  Show the script version',
@@ -66,38 +69,25 @@ async function readJson(path) {
 }
 
 /**
- * Fetch npm daily download stats for the last month.
+ * Format a date as YYYY-MM-DD (UTC).
  *
- * @param {string} pkgName - NPM package name.
- * @returns {Promise<NpmDownloadsRangeResponse>} Range response.
+ * @param {Date} date - Date to format.
+ * @returns {string} The day key.
  */
-async function fetchLastMonthDownloads(pkgName) {
-  const url = `https://api.npmjs.org/downloads/range/last-month/${encodeURIComponent(pkgName)}`;
-  const res = await fetch(url, {
-    headers: { accept: 'application/json' },
-  });
-
-  if (!res.ok) {
-    const text = await res.text().catch(() => '');
-    throw new Error(`HTTP ${res.status} fetching ${url}\n${text}`);
-  }
-
-  const data = /** @type {NpmDownloadsRangeResponse} */ (await res.json());
-  if (!data || !Array.isArray(data.downloads)) {
-    throw new Error(`Unexpected response shape from ${url}`);
-  }
-  return data;
+function dayKey(date) {
+  return date.toISOString().slice(0, 10);
 }
 
 /**
- * Fetch npm download stats for the current day.
+ * Fetch npm daily download stats for an explicit date range.
  *
  * @param {string} pkgName - NPM package name.
- * @returns {Promise<NpmDownloadsPointResponse>} Point response.
+ * @param {string} start - First day (YYYY-MM-DD).
+ * @param {string} end - Last day (YYYY-MM-DD).
+ * @returns {Promise<NpmDownloadsRangeResponse>} Range response.
  */
-async function fetchCurrentDayDownloads(pkgName) {
-  const today = new Date().toISOString().slice(0, 10);
-  const url = `https://api.npmjs.org/downloads/point/${today}:${today}/${encodeURIComponent(pkgName)}`;
+async function fetchRangeDownloads(pkgName, start, end) {
+  const url = `https://api.npmjs.org/downloads/range/${start}:${end}/${encodeURIComponent(pkgName)}`;
   const res = await fetch(url, {
     headers: { accept: 'application/json' },
   });
@@ -107,8 +97,8 @@ async function fetchCurrentDayDownloads(pkgName) {
     throw new Error(`HTTP ${res.status} fetching ${url}\n${text}`);
   }
 
-  const data = /** @type {NpmDownloadsPointResponse} */ (await res.json());
-  if (!data || typeof data.downloads !== 'number') {
+  const data = /** @type {NpmDownloadsRangeResponse} */ (await res.json());
+  if (!data || !Array.isArray(data.downloads)) {
     throw new Error(`Unexpected response shape from ${url}`);
   }
   return data;
@@ -247,17 +237,21 @@ async function printDownloads(pkgPath, dryRun) {
     return;
   }
 
-  const [lastMonthData, currentDayData] = await Promise.all([fetchLastMonthDownloads(name), fetchCurrentDayDownloads(name)]);
+  const today = new Date();
+  const end = dayKey(today);
+  const start = dayKey(new Date(today.getTime() - rangeDays * 24 * 60 * 60 * 1000));
+  const rangeData = await fetchRangeDownloads(name, start, end);
 
-  const rows = lastMonthData.downloads.map((r) => ({ day: String(r.day), downloads: Number(r.downloads) || 0 }));
-  const currentDayRow = { day: String(currentDayData.end), downloads: Number(currentDayData.downloads) || 0 };
-  const currentDayPending = currentDayRow.day > lastMonthData.end && currentDayRow.downloads === 0;
-  if (!rows.some((r) => r.day === currentDayRow.day)) {
-    rows.push(currentDayRow);
-  }
+  const rows = rangeData.downloads.map((r) => ({ day: String(r.day), downloads: Number(r.downloads) || 0 }));
   rows.sort((a, b) => a.day.localeCompare(b.day));
 
-  const summaryRows = currentDayPending ? rows.filter((r) => r.day !== currentDayRow.day) : rows;
+  // npm reports 0 for the latest days until it publishes their counts: mark the trailing zero days as pending.
+  const pendingDays = new Set();
+  for (let i = rows.length - 1; i >= 0 && pendingDays.size < maxPendingDays && rows[i].downloads === 0; i -= 1) {
+    pendingDays.add(rows[i].day);
+  }
+
+  const summaryRows = rows.filter((r) => !pendingDays.has(r.day));
   const total = sumDownloads(summaryRows);
   const days = summaryRows.length || 1;
   const avg = Math.round(total / days);
@@ -271,11 +265,11 @@ async function printDownloads(pkgPath, dryRun) {
   const dayWidth = Math.max(3, ...rows.map((r) => r.day.length));
   const downloadStrings = rows.map((r) => formatNumber(r.downloads));
   const downloadsWidth = Math.max('DOWNLOADS'.length, ...downloadStrings.map((s) => s.length));
-  const rangeStart = rows[0]?.day ?? lastMonthData.start;
-  const rangeEnd = rows[rows.length - 1]?.day ?? currentDayData.end;
+  const rangeStart = rows[0]?.day ?? rangeData.start;
+  const rangeEnd = rows[rows.length - 1]?.day ?? rangeData.end;
 
-  console.log(style.bold(style.cyan('npm downloads (last-month + today)')));
-  console.log(`${style.dim('Package:')} ${lastMonthData.package}`);
+  console.log(style.bold(style.cyan(`npm downloads (last ${rangeDays} days + today)`)));
+  console.log(`${style.dim('Package:')} ${rangeData.package}`);
   console.log(`${style.dim('Range:  ')} ${rangeStart} .. ${rangeEnd}`);
   console.log('');
 
@@ -285,14 +279,14 @@ async function printDownloads(pkgPath, dryRun) {
   for (let i = 0; i < rows.length; i += 1) {
     const r = rows[i];
     const downloads = downloadStrings[i];
-    const renderedDownloads = currentDayPending && r.day === currentDayRow.day ? style.dim(padLeft('pending', downloadsWidth)) : padLeft(downloads, downloadsWidth);
+    const renderedDownloads = pendingDays.has(r.day) ? style.dim(padLeft('pending', downloadsWidth)) : padLeft(downloads, downloadsWidth);
     console.log(`${padRight(r.day, dayWidth)} ${renderedDownloads}`);
   }
 
   console.log('');
   console.log(style.dim('Summary'));
-  if (currentDayPending) {
-    console.log(style.dim("Today:    npm has not published today's count yet"));
+  if (pendingDays.size > 0) {
+    console.log(style.dim(`Pending:  npm has not published the count of ${[...pendingDays].sort().join(', ')} yet`));
   }
   console.log(`${style.dim('Total:   ')} ${style.bold(style.green(formatNumber(total)))}`);
   console.log(`${style.dim('Avg/day: ')} ${style.yellow(formatNumber(avg))}`);