Release 3.0.5

Author: Luligu

.devcontainer/devcontainer.json

@@ -52,6 +52,8 @@ Dev containers have networking limitations depending on the host OS and Docker s
     // Use a shared bridge network to allow to access other containers with their names (dns resolution). With the default bridge, dns resolution does not work (only ip:port).
     "--network=matterbridge"
   ],
+  // Publish the Matterbridge UI port on the Docker host (so http://localhost:8283 works even without VS Code port forwarding)
+  "appPort": [8283],
   "customizations": {
     "vscode": {
       // Extensions to install in the dev container
@@ -67,6 +69,7 @@ Dev containers have networking limitations depending on the host OS and Docker s
       // Settings for the VS Code environment
       "settings": {
         "terminal.integrated.shell.linux": "/bin/bash",
+        "terminal.integrated.scrollback": 10000,
         "editor.tabSize": 2,
         "editor.formatOnSave": true,
         "editor.codeActionsOnSave": {

.github/workflows/build.yml

@@ -29,6 +29,12 @@ jobs:
           node-version: ${{ matrix.node-version }}
           cache: npm
 
+      - name: Verify Node.js version
+        run: node -v
+
+      - name: Verify Npm version
+        run: npm -v
+
       - name: Clone matterbridge repo
         run: git clone --depth 1 --single-branch --no-tags https://github.com/Luligu/matterbridge.git ../matterbridge
 

.github/workflows/codecov.yml

@@ -25,6 +25,12 @@ jobs:
           node-version: '24.x'
           cache: npm
 
+      - name: Verify Node.js version
+        run: node -v
+
+      - name: Verify Npm version
+        run: npm -v
+
       - name: Clone matterbridge repo
         run: git clone --depth 1 --single-branch --no-tags https://github.com/Luligu/matterbridge.git ../matterbridge
 
@@ -41,10 +47,10 @@ jobs:
         run: npm link --no-fund --no-audit
 
       - name: Install dependencies
-        run: npm ci
+        run: npm ci --no-fund --no-audit
 
       - name: Link matterbridge in the project
-        run: npm link matterbridge
+        run: npm link matterbridge --no-fund --no-audit
 
       - name: Run tests
         run: npm run test:coverage -- --forceExit

.github/workflows/publish.yml

@@ -56,10 +56,10 @@ jobs:
         run: npm link --no-fund --no-audit
 
       - name: Install plugin dependencies
-        run: npm ci
+        run: npm ci --no-fund --no-audit
 
       - name: Link matterbridge in the project
-        run: npm link matterbridge
+        run: npm link matterbridge --no-fund --no-audit
 
       - name: Build the plugin
         run: npm run build
@@ -149,10 +149,10 @@ jobs:
         run: npm link --no-fund --no-audit
 
       - name: Install plugin dependencies
-        run: npm ci
+        run: npm ci --no-fund --no-audit
 
       - name: Link matterbridge in the plugin
-        run: npm link matterbridge
+        run: npm link matterbridge --no-fund --no-audit
 
       - name: Build the plugin
         run: npm run build

CHANGELOG.md

@@ -11,6 +11,7 @@
 [![linted with eslint](https://img.shields.io/badge/linted_with-ES_Lint-4B32C3.svg?logo=eslint)](https://github.com/eslint/eslint)
 [![TypeScript](https://img.shields.io/badge/TypeScript-3178C6?logo=typescript&logoColor=white)](https://www.typescriptlang.org/)
 [![ESM](https://img.shields.io/badge/ESM-Node.js-339933?logo=node.js&logoColor=white)](https://nodejs.org/api/esm.html)
+[![matterbridge.io](https://img.shields.io/badge/matterbridge.io-online-brightgreen)](https://matterbridge.io)
 
 [![powered by](https://img.shields.io/badge/powered%20by-matterbridge-blue)](https://www.npmjs.com/package/matterbridge)
 [![powered by](https://img.shields.io/badge/powered%20by-matter--history-blue)](https://www.npmjs.com/package/matter-history)

README.md

@@ -11,6 +11,7 @@
 [![linted with eslint](https://img.shields.io/badge/linted_with-ES_Lint-4B32C3.svg?logo=eslint)](https://github.com/eslint/eslint)
 [![TypeScript](https://img.shields.io/badge/TypeScript-3178C6?logo=typescript&logoColor=white)](https://www.typescriptlang.org/)
 [![ESM](https://img.shields.io/badge/ESM-Node.js-339933?logo=node.js&logoColor=white)](https://nodejs.org/api/esm.html)
+[![matterbridge.io](https://img.shields.io/badge/matterbridge.io-online-brightgreen)](https://matterbridge.io)
 
 [![powered by](https://img.shields.io/badge/powered%20by-matterbridge-blue)](https://www.npmjs.com/package/matterbridge)
 [![powered by](https://img.shields.io/badge/powered%20by-matter--history-blue)](https://www.npmjs.com/package/matter-history)

package-lock.json

@@ -117,7 +117,7 @@
   },
   "dependencies": {
     "moment": "2.30.1",
-    "mqtt": "5.14.1",
+    "mqtt": "5.15.0",
     "node-ansi-logger": "3.1.1",
     "node-persist-manager": "2.0.0"
   },
@@ -132,7 +132,7 @@
     "eslint": "9.39.2",
     "eslint-config-prettier": "10.1.8",
     "eslint-plugin-import": "2.32.0",
-    "eslint-plugin-jest": "29.12.1",
+    "eslint-plugin-jest": "29.12.2",
     "eslint-plugin-jsdoc": "62.5.0",
     "eslint-plugin-n": "17.23.2",
     "eslint-plugin-prettier": "5.5.5",

package.json

@@ -1,9 +1,21 @@
+/* eslint-disable no-console */
+/* eslint-disable jsdoc/require-jsdoc */
+import { execFileSync } from 'node:child_process';
 import fs from 'node:fs/promises';
 import path from 'node:path';
 import { fileURLToPath } from 'node:url';
 
 function usage() {
-  return ['Usage: node scripts/version.mjs <dev|edge>', '', 'Updates package.json version to:', '  <baseVersion>-<dev|edge>-<yyyymmdd>-<7digitRandom>'].join('\n');
+  return [
+    'Usage: node scripts/version.mjs <dev|edge> [--dry-run]',
+    '   or: node scripts/version.mjs --dry-run <dev|edge>',
+    '',
+    'Updates package.json version to:',
+    '  <baseVersion>-<dev|edge>-<yyyymmdd>-<7charSha>',
+    '',
+    'Options:',
+    '  --dry-run, -n   Print the next version but do not write package.json',
+  ].join('\n');
 }
 
 function formatYyyymmdd(date) {
@@ -13,8 +25,25 @@ function formatYyyymmdd(date) {
   return `${year}${month}${day}`;
 }
 
-function random7Digits() {
-  return String(Math.floor(1_000_000 + Math.random() * 9_000_000));
+function shortSha7FromGit(repoRoot) {
+  const out = execFileSync('git', ['rev-parse', '--short=7', 'HEAD'], {
+    cwd: repoRoot,
+    encoding: 'utf8',
+    stdio: ['ignore', 'pipe', 'ignore'],
+  });
+  const sha = String(out).trim();
+  if (!/^[0-9a-f]{7}$/i.test(sha)) {
+    throw new Error(`Unexpected git short SHA output: ${JSON.stringify(sha)}`);
+  }
+  return sha.toLowerCase();
+}
+
+function getShortSha7(repoRoot) {
+  try {
+    return shortSha7FromGit(repoRoot);
+  } catch (err) {
+    throw new Error(`Unable to determine git short SHA. (${err instanceof Error ? err.message : String(err)})`);
+  }
 }
 
 function requirePlainSemver(version) {
@@ -25,7 +54,19 @@ function requirePlainSemver(version) {
   return trimmed;
 }
 
-const tag = process.argv[2]?.toLowerCase();
+const args = process.argv.slice(2);
+const knownFlags = new Set(['--dry-run', '-n']);
+const unknownFlags = args.filter((a) => a.startsWith('-') && !knownFlags.has(a));
+if (unknownFlags.length > 0) {
+  console.error(`Unknown option(s): ${unknownFlags.join(', ')}`);
+  console.error(usage());
+  process.exitCode = 1;
+  throw new Error('Unknown option(s).');
+}
+
+const dryRun = args.includes('--dry-run') || args.includes('-n');
+const positional = args.filter((a) => !a.startsWith('-'));
+const tag = positional[0]?.toLowerCase();
 if (tag !== 'dev' && tag !== 'edge') {
   console.error(usage());
   process.exitCode = 1;
@@ -43,10 +84,14 @@ const pkg = JSON.parse(raw);
 const currentVersion = pkg.version;
 const baseVersion = requirePlainSemver(currentVersion);
 const yyyymmdd = formatYyyymmdd(new Date());
-const rand = random7Digits();
+const sha7 = getShortSha7(repoRoot);
 
-const nextVersion = `${baseVersion}-${tag}-${yyyymmdd}-${rand}`;
+const nextVersion = `${baseVersion}-${tag}-${yyyymmdd}-${sha7}`;
 pkg.version = nextVersion;
 
-await fs.writeFile(packageJsonPath, `${JSON.stringify(pkg, null, 2)}\n`, 'utf8');
-console.log(`package.json version: ${currentVersion} -> ${nextVersion}`);
+if (dryRun) {
+  console.log(`[dry-run] package.json version: ${currentVersion} -> ${nextVersion}`);
+} else {
+  await fs.writeFile(packageJsonPath, `${JSON.stringify(pkg, null, 2)}\n`, 'utf8');
+  console.log(`package.json version: ${currentVersion} -> ${nextVersion}`);
+}

scripts/version.mjs

@@ -5,7 +5,7 @@
     "rootDir": "src",
     "incremental": false,
     "composite": false,
-    "declaration": true,
+    "declaration": false,
     "declarationMap": false,
     "sourceMap": false,
     "removeComments": true