matterbridge 3.1.9-dev-20250729-d64715f → 3.2.0-dev-20250730-d04e6d8

package/CHANGELOG.md

@@ -8,14 +8,29 @@ If you like this project and find it useful, please consider giving it a star on
   <img src="bmc-button.svg" alt="Buy me a coffee" width="120">
 </a>
 
-## [3.1.9] - 2025-07-??
+### Breaking Changes
+
+Removed node 18 support.
+Please install Node.js 22 LTS.
+Don't use Node.js Current but always the Node.js LTS.
+Node.js 23, like all odd-numbered versions, is not supported.
+
+## [3.2.0] - 2025-07-??
 
 ### Added
 
+- [update]: Added a Snackbar message for available updates from npm. It differs for latest and dev versions. The update check, as always, is performed at restart (1 minute after) and each 12 hours. It can be triggered manually from the frontend.
+- [update]: First steps of update and log important messages from GitHub.
+- [build]: Added workflow_dispatch trigger and enhance dependency management in CI.
+- [build]: Added macOS 15 to the CI matrix for Node.js builds.
+- [frontend]: Bump version 2.7.2.
+- [frontend]: Added the plugin name on the QR/Fabrics when in childbridge mode. Changed operational mode to one click only.
+
 ### Changed
 
 - [package]: Updated dependencies.
 - [matter.js]: Bumped `matter.js` to 0.15.2 (https://github.com/project-chip/matter.js/discussions/2203). Great job matter.js!
+- [node.js]: Removed node 18 support.
 
 <a href="https://www.buymeacoffee.com/luligugithub">
   <img src="bmc-button.svg" alt="Buy me a coffee" width="80">

package/README.md

@@ -69,7 +69,7 @@ https://matter-smarthome.de/en/interview/an-alternative-to-the-official-matter-s
 To run Matterbridge, you need either a [Node.js](https://nodejs.org/en) environment or [Docker](https://docs.docker.com/get-started/get-docker/) installed on your system.
 
 If you don't have Node.js already install, please use this method to install it on a debian device: https://github.com/nodesource/distributions.
-The supported versions of node are 18, 20 and 22. Please install Node.js 22 LTS.
+The supported versions of node are 20 and 22. Please install Node.js 22 LTS. Don't use Node.js Current but always the Node.js LTS.
 Node.js 23, like all odd-numbered versions, is not supported.
 Nvm is not a good choice and should not be used for production.
 

package/dist/update.js

@@ -1,7 +1,9 @@
-import { db, nt, wr } from 'node-ansi-logger';
+import { db, debugStringify, nt, wr } from 'node-ansi-logger';
 import { plg } from './matterbridgeTypes.js';
+import { isValidString } from './utils/isvalid.js';
 export async function checkUpdates(matterbridge) {
     const { hasParameter } = await import('./utils/commandLine.js');
+    const update = checkUpdatesAndLog(matterbridge);
     const latestVersion = getMatterbridgeLatestVersion(matterbridge);
     const devVersion = getMatterbridgeDevVersion(matterbridge);
     const pluginsVersions = [];
@@ -20,7 +22,24 @@ export async function checkUpdates(matterbridge) {
         const mainUpdate = getShellyMainUpdate(matterbridge);
         shellyUpdates.push(mainUpdate);
     }
-    await Promise.all([latestVersion, devVersion, ...pluginsVersions, ...pluginsDevVersions, ...shellyUpdates]);
+    await Promise.all([update, latestVersion, devVersion, ...pluginsVersions, ...pluginsDevVersions, ...shellyUpdates]);
+}
+export async function checkUpdatesAndLog(matterbridge) {
+    const { getGitHubUpdate } = await import('./utils/network.js');
+    const branch = matterbridge.matterbridgeVersion.includes('-dev-') ? 'dev' : 'main';
+    try {
+        const updateJson = await getGitHubUpdate(branch, 'update.json', 5_000);
+        matterbridge.log.debug(`GitHub ${branch} update status: ${debugStringify(updateJson)}.`);
+        if (isValidString(branch === 'main' ? updateJson.latestMessage : updateJson.devMessage, 1) &&
+            isValidString(branch === 'main' ? updateJson.latestMessageSeverity : updateJson.devMessageSeverity, 4) &&
+            ['info', 'warning', 'error', 'success'].includes(branch === 'main' ? updateJson.latestMessageSeverity : updateJson.devMessageSeverity)) {
+            matterbridge.log.notice(`GitHub ${branch} update message: ${branch === 'main' ? updateJson.latestMessage : updateJson.devMessage}`);
+            matterbridge.frontend.wssSendSnackbarMessage(branch === 'main' ? updateJson.latestMessage : updateJson.devMessage, 0, branch === 'main' ? updateJson.latestMessageSeverity : updateJson.devMessageSeverity);
+        }
+    }
+    catch (error) {
+        matterbridge.log.debug(`Error checking GitHub ${branch} updates: ${error instanceof Error ? error.message : error}`);
+    }
 }
 export async function getMatterbridgeLatestVersion(matterbridge) {
     const { getNpmPackageVersion } = await import('./utils/network.js');
@@ -31,6 +50,7 @@ export async function getMatterbridgeLatestVersion(matterbridge) {
         await matterbridge.nodeContext?.set('matterbridgeLatestVersion', matterbridge.matterbridgeLatestVersion);
         if (matterbridge.matterbridgeVersion !== matterbridge.matterbridgeLatestVersion) {
             matterbridge.log.notice(`Matterbridge is out of date. Current version: ${matterbridge.matterbridgeVersion}. Latest version: ${matterbridge.matterbridgeLatestVersion}.`);
+            matterbridge.frontend.wssSendSnackbarMessage('Matterbridge latest update available', 0, 'info');
             matterbridge.frontend.wssSendRefreshRequired('matterbridgeLatestVersion');
             matterbridge.frontend.wssSendUpdateRequired();
         }
@@ -52,6 +72,7 @@ export async function getMatterbridgeDevVersion(matterbridge) {
         await matterbridge.nodeContext?.set('matterbridgeDevVersion', version);
         if (matterbridge.matterbridgeVersion.includes('-dev-') && matterbridge.matterbridgeVersion !== version) {
             matterbridge.log.notice(`Matterbridge@dev is out of date. Current version: ${matterbridge.matterbridgeVersion}. Latest dev version: ${matterbridge.matterbridgeDevVersion}.`);
+            matterbridge.frontend.wssSendSnackbarMessage('Matterbridge dev update available', 0, 'info');
             matterbridge.frontend.wssSendRefreshRequired('matterbridgeDevVersion');
             matterbridge.frontend.wssSendUpdateRequired(true);
         }

package/dist/utils/network.js

@@ -124,6 +124,44 @@ export async function getNpmPackageVersion(packageName, tag = 'latest', timeout
         });
     });
 }
+export async function getGitHubUpdate(branch, file, timeout = 10000) {
+    const https = await import('node:https');
+    return new Promise((resolve, reject) => {
+        const url = `https://raw.githubusercontent.com/Luligu/matterbridge/${branch}/public/${file}`;
+        const controller = new AbortController();
+        const timeoutId = setTimeout(() => {
+            controller.abort();
+            reject(new Error(`Request timed out after ${timeout / 1000} seconds`));
+        }, timeout);
+        const req = https.get(url, { signal: controller.signal }, (res) => {
+            let data = '';
+            if (res.statusCode !== 200) {
+                clearTimeout(timeoutId);
+                res.resume();
+                req.destroy();
+                reject(new Error(`Failed to fetch data. Status code: ${res.statusCode}`));
+                return;
+            }
+            res.on('data', (chunk) => {
+                data += chunk;
+            });
+            res.on('end', () => {
+                clearTimeout(timeoutId);
+                try {
+                    const jsonData = JSON.parse(data);
+                    resolve(jsonData);
+                }
+                catch (error) {
+                    reject(new Error(`Failed to parse response JSON: ${error instanceof Error ? error.message : error}`));
+                }
+            });
+        });
+        req.on('error', (error) => {
+            clearTimeout(timeoutId);
+            reject(new Error(`Request failed: ${error instanceof Error ? error.message : error}`));
+        });
+    });
+}
 export async function getGlobalNodeModules() {
     const { exec } = await import('node:child_process');
     return new Promise((resolve, reject) => {

package/dist/utils/wait.js

@@ -1,4 +1,4 @@
-import { AnsiLogger } from '../logger/export.js';
+import { AnsiLogger } from 'node-ansi-logger';
 export const log = new AnsiLogger({ logName: 'MatterbridgeUtils', logTimestampFormat: 4, logLevel: "info" });
 export async function waiter(name, check, exitWithReject = false, resolveTimeout = 5000, resolveInterval = 500, debug = false) {
     if (check())

package/frontend/build/asset-manifest.json

@@ -1,7 +1,7 @@
 {
   "files": {
     "main.css": "./static/css/main.944b63c3.css",
-    "main.js": "./static/js/main.6ab99f2a.js",
+    "main.js": "./static/js/main.41269326.js",
     "static/js/453.d855a71b.chunk.js": "./static/js/453.d855a71b.chunk.js",
     "static/media/roboto-latin-700-normal.woff2": "./static/media/roboto-latin-700-normal.c4d6cab43bec89049809.woff2",
     "static/media/roboto-latin-500-normal.woff2": "./static/media/roboto-latin-500-normal.599f66a60bdf974e578e.woff2",
@@ -77,11 +77,11 @@
     "static/media/roboto-greek-ext-300-normal.woff": "./static/media/roboto-greek-ext-300-normal.60729cafbded24073dfb.woff",
     "index.html": "./index.html",
     "main.944b63c3.css.map": "./static/css/main.944b63c3.css.map",
-    "main.6ab99f2a.js.map": "./static/js/main.6ab99f2a.js.map",
+    "main.41269326.js.map": "./static/js/main.41269326.js.map",
     "453.d855a71b.chunk.js.map": "./static/js/453.d855a71b.chunk.js.map"
   },
   "entrypoints": [
     "static/css/main.944b63c3.css",
-    "static/js/main.6ab99f2a.js"
+    "static/js/main.41269326.js"
   ]
 }

package/frontend/build/index.html

@@ -1 +1 @@
-<!doctype html><html lang="en"><head><meta charset="utf-8"/><base href="./"><link rel="icon" href="./matterbridge 32x32.png"/><meta name="viewport" content="width=device-width,initial-scale=1"/><meta name="theme-color" content="#000000"/><title>Matterbridge</title><link rel="manifest" href="./manifest.json"/><script defer="defer" src="./static/js/main.6ab99f2a.js"></script><link href="./static/css/main.944b63c3.css" rel="stylesheet"></head><body><noscript>You need to enable JavaScript to run this app.</noscript><div id="root"></div></body></html>
+<!doctype html><html lang="en"><head><meta charset="utf-8"/><base href="./"><link rel="icon" href="./matterbridge 32x32.png"/><meta name="viewport" content="width=device-width,initial-scale=1"/><meta name="theme-color" content="#000000"/><title>Matterbridge</title><link rel="manifest" href="./manifest.json"/><script defer="defer" src="./static/js/main.41269326.js"></script><link href="./static/css/main.944b63c3.css" rel="stylesheet"></head><body><noscript>You need to enable JavaScript to run this app.</noscript><div id="root"></div></body></html>