matterbridge 3.5.2-dev-20260128-beb91f9 → 3.5.2-dev-20260129-e83daf7

package/CHANGELOG.md

@@ -17,7 +17,7 @@ The project will evolve to a multi-threaded architecture (the CLI will become th
 - all plugins in bridge mode;
 - each plugin in childbridge mode;
 
-- check updates;
+- ✅ check updates;
 - npm install;
 - ✅ get the global node_modules directory;
 
@@ -41,6 +41,7 @@ Advantages:
 - [docker]: Added instructions about how to disable the health check when you override the frontend port.
 - [Alexa]: Added a full review of supported device types and known issues. Thanks [Tamer Salah](https://github.com/tammeryousef1006).
 - [virtual]: Added outlet to mounted switch device type in virtual devices (Matter .1.4.2).
+- [package]: Added @matterbridge/thread monorepo scoped package.
 
 ### Changed
 
@@ -48,6 +49,7 @@ Advantages:
 - [docker]: Clarified in [README-DOCKER.md](README-DOCKER.md) the content of the matterbridge docker images on Docker Hub.
 - [frontend]: Bumped `frontend` version to v. 3.4.3.
 - [frontend]: For the matterbridge docker image with tag dev, the frontend now shows the versions with the tag git.
+- [worker]: Bumped worker module to v. 1.1.0.
 
 <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/bin/mb_health.js

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+const { mbHealthMain } = await import('../dist/mb_health.js');
+await mbHealthMain();

package/dist/broadcastServerTypes.d.ts

@@ -1,8 +1,8 @@
 import { LogLevel } from 'node-ansi-logger';
 import { EndpointNumber } from '@matter/types/datatype';
 import type { RefreshRequiredChanged, WsMessageBroadcast } from './frontendTypes.js';
-import type { PlatformConfig, PlatformSchema } from './matterbridgePlatform.js';
-import type { ApiMatter, ApiPlugin, BaseDevice, Plugin, StoragePlugin } from './matterbridgeTypes.js';
+import type { PlatformConfig, PlatformMatterbridge, PlatformSchema } from './matterbridgePlatformTypes.js';
+import type { ApiMatter, ApiPlugin, BaseDevice, Plugin, SharedMatterbridge, StoragePlugin } from './matterbridgeTypes.js';
 export type WorkerSrcType = 'manager' | 'matterbridge' | 'plugins' | 'devices' | 'frontend' | 'matter' | 'platform' | 'spawn' | 'updates';
 export type WorkerDstType = 'manager' | 'matterbridge' | 'plugins' | 'devices' | 'frontend' | 'matter' | 'platform' | 'spawn' | 'updates' | 'all';
 type NormalizeRequest<T> = T extends {
@@ -184,6 +184,28 @@ export type WorkerMessageTypes = {
             };
         };
     };
+    'matterbridge_platform': {
+        request: {
+            params: undefined;
+        };
+        response: {
+            result: {
+                data: PlatformMatterbridge;
+                success: true;
+            };
+        };
+    };
+    'matterbridge_shared': {
+        request: {
+            params: undefined;
+        };
+        response: {
+            result: {
+                data: SharedMatterbridge;
+                success: true;
+            };
+        };
+    };
     'matter_start': {
         request: {
             params: {

package/dist/checkUpdates.js

@@ -11,10 +11,15 @@ export async function checkUpdates(matterbridge) {
     const pluginsVersionPromises = [];
     const pluginsDevVersionPromises = [];
     const shellyUpdatesPromises = [];
-    const plugins = (await server.fetch({ type: 'plugins_apipluginarray', src: server.name, dst: 'plugins' }, 1000)).result.plugins;
-    for (const plugin of plugins) {
-        pluginsVersionPromises.push(getPluginLatestVersion(log, server, plugin));
-        pluginsDevVersionPromises.push(getPluginDevVersion(log, server, plugin));
+    try {
+        const plugins = (await server.fetch({ type: 'plugins_apipluginarray', src: server.name, dst: 'plugins' }, 1000)).result.plugins;
+        for (const plugin of plugins) {
+            pluginsVersionPromises.push(getPluginLatestVersion(log, server, plugin));
+            pluginsDevVersionPromises.push(getPluginDevVersion(log, server, plugin));
+        }
+    }
+    catch (error) {
+        log.debug(`Error fetching plugins for update check: ${error instanceof Error ? error.message : error}`);
     }
     if (hasParameter('shelly')) {
         const { getShellySysUpdate, getShellyMainUpdate } = await import('./shelly.js');

package/dist/frontendTypes.d.ts

@@ -1,5 +1,5 @@
 import type { EndpointNumber } from '@matter/types';
-import type { PlatformConfig } from './matterbridgePlatform.js';
+import type { PlatformConfig } from './matterbridgePlatformTypes.js';
 import type { ApiClusters, ApiDevice, ApiMatter, ApiPlugin, MatterbridgeInformation, SystemInformation } from './matterbridgeTypes.js';
 export type RefreshRequiredChanged = 'settings' | 'plugins' | 'devices' | 'matter';
 export interface ApiSettings {

package/dist/index.d.ts

@@ -8,4 +8,5 @@ export * from './matterbridgeDeviceTypes.js';
 export * from './matterbridgePlatform.js';
 export * from './matterbridgeAccessoryPlatform.js';
 export * from './matterbridgeDynamicPlatform.js';
+export * from './matterbridgePlatformTypes.js';
 export { addVirtualDevice } from './helpers.js';

package/dist/index.js

@@ -10,4 +10,5 @@ export * from './matterbridgeDeviceTypes.js';
 export * from './matterbridgePlatform.js';
 export * from './matterbridgeAccessoryPlatform.js';
 export * from './matterbridgeDynamicPlatform.js';
+export * from './matterbridgePlatformTypes.js';
 export { addVirtualDevice } from './helpers.js';

package/dist/matterbridge.d.ts

@@ -12,7 +12,7 @@ import { PluginManager } from './pluginManager.js';
 import { DeviceManager } from './deviceManager.js';
 import { MatterbridgeEndpoint } from './matterbridgeEndpoint.js';
 import { Frontend } from './frontend.js';
-import { PlatformMatterbridge } from './matterbridgePlatform.js';
+import { PlatformMatterbridge } from './matterbridgePlatformTypes.js';
 interface MatterbridgeEvents {
     shutdown: [];
     restart: [];

package/dist/matterbridge.js

@@ -214,6 +214,12 @@ export class Matterbridge extends EventEmitter {
                     this.shellyMainUpdate = true;
                     this.server.respond({ ...msg, result: { success: true } });
                     break;
+                case 'matterbridge_platform':
+                    this.server.respond({ ...msg, result: { data: this.getPlatformMatterbridge(), success: true } });
+                    break;
+                case 'matterbridge_shared':
+                    this.server.respond({ ...msg, result: { data: this.getSharedMatterbridge(), success: true } });
+                    break;
                 default:
                     if (this.verbose)
                         this.log.debug(`Unknown broadcast request ${CYAN}${msg.type}${db} from ${CYAN}${msg.src}${db}`);

package/dist/matterbridgeAccessoryPlatform.d.ts

@@ -1,5 +1,6 @@
 import { AnsiLogger } from 'node-ansi-logger';
-import { MatterbridgePlatform, PlatformConfig, PlatformMatterbridge } from './matterbridgePlatform.js';
+import { MatterbridgePlatform } from './matterbridgePlatform.js';
+import type { PlatformConfig, PlatformMatterbridge } from './matterbridgePlatformTypes.js';
 export declare function isMatterbridgeAccessoryPlatform(value: unknown): value is MatterbridgeAccessoryPlatform;
 export declare class MatterbridgeAccessoryPlatform extends MatterbridgePlatform {
     constructor(matterbridge: PlatformMatterbridge, log: AnsiLogger, config: PlatformConfig);

package/dist/matterbridgeDynamicPlatform.d.ts

@@ -1,5 +1,6 @@
 import { AnsiLogger } from 'node-ansi-logger';
-import { MatterbridgePlatform, PlatformConfig, PlatformMatterbridge } from './matterbridgePlatform.js';
+import { MatterbridgePlatform } from './matterbridgePlatform.js';
+import type { PlatformConfig, PlatformMatterbridge } from './matterbridgePlatformTypes.js';
 export declare function isMatterbridgeDynamicPlatform(value: unknown): value is MatterbridgeDynamicPlatform;
 export declare class MatterbridgeDynamicPlatform extends MatterbridgePlatform {
     constructor(matterbridge: PlatformMatterbridge, log: AnsiLogger, config: PlatformConfig);

package/dist/matterbridgePlatform.d.ts

@@ -1,39 +1,9 @@
 import { AnsiLogger, LogLevel } from 'node-ansi-logger';
 import { NodeStorage } from 'node-persist-manager';
-import { EndpointNumber, VendorId } from '@matter/types/datatype';
+import { EndpointNumber } from '@matter/types/datatype';
 import { MatterbridgeEndpoint } from './matterbridgeEndpoint.js';
 import { ApiSelectDevice, ApiSelectEntity } from './frontendTypes.js';
-import { SystemInformation } from './matterbridgeTypes.js';
-export type PlatformConfigValue = string | number | boolean | bigint | object | undefined | null;
-export type PlatformConfig = {
-    name: string;
-    type: string;
-    version: string;
-    debug: boolean;
-    unregisterOnShutdown: boolean;
-} & Record<string, PlatformConfigValue>;
-export type PlatformSchemaValue = string | number | boolean | bigint | object | undefined | null;
-export type PlatformSchema = Record<string, PlatformSchemaValue>;
-export type PlatformMatterbridge = {
-    readonly systemInformation: Readonly<Pick<SystemInformation, 'interfaceName' | 'macAddress' | 'ipv4Address' | 'ipv6Address' | 'nodeVersion' | 'hostname' | 'user' | 'osType' | 'osRelease' | 'osPlatform' | 'osArch' | 'totalMemory' | 'freeMemory' | 'systemUptime' | 'processUptime' | 'cpuUsage' | 'processCpuUsage' | 'rss' | 'heapTotal' | 'heapUsed'>>;
-    readonly rootDirectory: string;
-    readonly homeDirectory: string;
-    readonly matterbridgeDirectory: string;
-    readonly matterbridgePluginDirectory: string;
-    readonly matterbridgeCertDirectory: string;
-    readonly globalModulesDirectory: string;
-    readonly matterbridgeVersion: string;
-    readonly matterbridgeLatestVersion: string;
-    readonly matterbridgeDevVersion: string;
-    readonly frontendVersion: string;
-    readonly bridgeMode: 'bridge' | 'childbridge' | 'controller' | '';
-    readonly restartMode: 'service' | 'docker' | '';
-    readonly virtualMode: 'disabled' | 'outlet' | 'light' | 'switch' | 'mounted_switch';
-    readonly aggregatorVendorId: VendorId;
-    readonly aggregatorVendorName: string;
-    readonly aggregatorProductId: number;
-    readonly aggregatorProductName: string;
-};
+import { PlatformConfig, PlatformMatterbridge, PlatformSchema } from './matterbridgePlatformTypes.js';
 export declare function isMatterbridgePlatform(value: unknown): value is MatterbridgePlatform;
 export declare function assertMatterbridgePlatform(value: unknown, context?: string): asserts value is MatterbridgePlatform;
 export declare class MatterbridgePlatform {

package/dist/matterbridgePlatformTypes.d.ts

@@ -0,0 +1,32 @@
+import type { VendorId } from '@matter/main/types';
+import type { SystemInformation } from './matterbridgeTypes.js';
+export type PlatformConfigValue = string | number | boolean | bigint | object | undefined | null;
+export type PlatformConfig = {
+    name: string;
+    type: string;
+    version: string;
+    debug: boolean;
+    unregisterOnShutdown: boolean;
+} & Record<string, PlatformConfigValue>;
+export type PlatformSchemaValue = string | number | boolean | bigint | object | undefined | null;
+export type PlatformSchema = Record<string, PlatformSchemaValue>;
+export type PlatformMatterbridge = {
+    readonly systemInformation: Readonly<Pick<SystemInformation, 'interfaceName' | 'macAddress' | 'ipv4Address' | 'ipv6Address' | 'nodeVersion' | 'hostname' | 'user' | 'osType' | 'osRelease' | 'osPlatform' | 'osArch' | 'totalMemory' | 'freeMemory' | 'systemUptime' | 'processUptime' | 'cpuUsage' | 'processCpuUsage' | 'rss' | 'heapTotal' | 'heapUsed'>>;
+    readonly rootDirectory: string;
+    readonly homeDirectory: string;
+    readonly matterbridgeDirectory: string;
+    readonly matterbridgePluginDirectory: string;
+    readonly matterbridgeCertDirectory: string;
+    readonly globalModulesDirectory: string;
+    readonly matterbridgeVersion: string;
+    readonly matterbridgeLatestVersion: string;
+    readonly matterbridgeDevVersion: string;
+    readonly frontendVersion: string;
+    readonly bridgeMode: 'bridge' | 'childbridge' | 'controller' | '';
+    readonly restartMode: 'service' | 'docker' | '';
+    readonly virtualMode: 'disabled' | 'outlet' | 'light' | 'switch' | 'mounted_switch';
+    readonly aggregatorVendorId: VendorId;
+    readonly aggregatorVendorName: string;
+    readonly aggregatorProductId: number;
+    readonly aggregatorProductName: string;
+};

package/dist/matterbridgePlatformTypes.js

@@ -0,0 +1 @@
+export {};

package/dist/matterbridgeTypes.d.ts

@@ -6,7 +6,8 @@ import type { FabricIndex, VendorId, EndpointNumber, Semtag } from '@matter/type
 import type { AggregatorEndpoint } from '@matter/node/endpoints/aggregator';
 import type { AdministratorCommissioning } from '@matter/types/clusters/administrator-commissioning';
 import type { Matterbridge } from './matterbridge.js';
-import type { MatterbridgePlatform, PlatformConfig, PlatformSchema } from './matterbridgePlatform.js';
+import type { MatterbridgePlatform } from './matterbridgePlatform.js';
+import type { PlatformConfig, PlatformSchema } from './matterbridgePlatformTypes.js';
 import type { MatterbridgeEndpoint } from './matterbridgeEndpoint.js';
 export declare const plg = "\u001B[38;5;33m";
 export declare const dev = "\u001B[38;5;79m";

package/dist/mb_health.d.ts

@@ -0,0 +1,10 @@
+export declare function checkHealth(url: string, timeoutMs: number): Promise<boolean>;
+export declare function fetchHealth(url: string, timeoutMs: number): Promise<{
+    ok: boolean;
+    statusCode: number;
+    body: string;
+    json?: unknown;
+}>;
+export declare function mbHealthExitCode(url: string, timeoutMs: number): Promise<number>;
+export declare function mbHealthCli(url: string, timeoutMs: number, exitFn?: (code: number) => never | void): Promise<void>;
+export declare function mbHealthMain(exitFn?: (code: number) => never | void): Promise<void>;

package/dist/mb_health.js

@@ -0,0 +1,77 @@
+import http from 'node:http';
+import https from 'node:https';
+export function checkHealth(url, timeoutMs) {
+    return fetchHealth(url, timeoutMs)
+        .then(({ ok }) => ok)
+        .catch(() => false);
+}
+export function fetchHealth(url, timeoutMs) {
+    return new Promise((resolve) => {
+        const parsedUrl = new URL(url);
+        const requestImpl = parsedUrl.protocol === 'https:' ? https : http;
+        const request = requestImpl.request({
+            protocol: parsedUrl.protocol,
+            hostname: parsedUrl.hostname,
+            port: parsedUrl.port,
+            path: parsedUrl.pathname + parsedUrl.search,
+            method: 'GET',
+            headers: {
+                'cache-control': 'no-store',
+                accept: 'application/json',
+            },
+        }, (response) => {
+            const chunks = [];
+            response.on('data', (chunk) => {
+                chunks.push(Buffer.isBuffer(chunk) ? chunk : Buffer.from(chunk));
+            });
+            response.on('end', () => {
+                const statusCode = response.statusCode ?? 0;
+                const ok = statusCode >= 200 && statusCode < 300;
+                const body = Buffer.concat(chunks).toString('utf8');
+                let json;
+                try {
+                    if (body.trim().length > 0)
+                        json = JSON.parse(body);
+                }
+                catch {
+                    json = undefined;
+                }
+                resolve({ ok, statusCode, body, json });
+            });
+            response.on('error', () => {
+                resolve({ ok: false, statusCode: response.statusCode ?? 0, body: '' });
+            });
+        });
+        request.on('error', () => resolve({ ok: false, statusCode: 0, body: '' }));
+        request.setTimeout(timeoutMs, () => {
+            request.destroy();
+            resolve({ ok: false, statusCode: 0, body: '' });
+        });
+        request.end();
+    });
+}
+export async function mbHealthExitCode(url, timeoutMs) {
+    try {
+        const { ok } = await fetchHealth(url, timeoutMs);
+        return ok ? 0 : 1;
+    }
+    catch {
+        return 1;
+    }
+}
+export async function mbHealthCli(url, timeoutMs, exitFn = process.exit) {
+    const { ok, statusCode, body, json } = await fetchHealth(url, timeoutMs);
+    if (json !== undefined) {
+        console.log(JSON.stringify(json, null, 2));
+    }
+    else if (body) {
+        console.log(body);
+    }
+    else {
+        console.log(JSON.stringify({ ok, statusCode }, null, 2));
+    }
+    exitFn(ok ? 0 : 1);
+}
+export async function mbHealthMain(exitFn = process.exit) {
+    await mbHealthCli('http://localhost:8283/health', 5000, exitFn);
+}

package/dist/pluginManager.d.ts

@@ -1,7 +1,8 @@
 import EventEmitter from 'node:events';
 import { LogLevel } from 'node-ansi-logger';
 import type { Matterbridge } from './matterbridge.js';
-import { type MatterbridgePlatform, type PlatformConfig, type PlatformSchema } from './matterbridgePlatform.js';
+import type { PlatformConfig, PlatformSchema } from './matterbridgePlatformTypes.js';
+import { type MatterbridgePlatform } from './matterbridgePlatform.js';
 import { ApiPlugin, Plugin, PluginName, StoragePlugin } from './matterbridgeTypes.js';
 interface PluginManagerEvents {
     added: [name: string];

package/dist/worker.d.ts

@@ -5,4 +5,3 @@ export declare function parentPost(message: ParentPortMessage): void;
 export declare function parentLog(logName: string | undefined, logLevel: LogLevel, message: string): void;
 export declare function createESMWorker(name: string, relativePath: string, workerData?: Record<string, boolean | number | string | object>, argv?: string[], env?: NodeJS.ProcessEnv, execArgv?: string[]): Worker;
 export declare function logWorkerInfo(log: AnsiLogger, logEnv?: boolean): void;
-export { ParentPortMessage };

package/dist/workerCheckUpdates.js

@@ -3,6 +3,7 @@ import { AnsiLogger } from 'node-ansi-logger';
 import { hasParameter, inspectError } from '@matterbridge/utils';
 import { BroadcastServer } from './broadcastServer.js';
 import { logWorkerInfo, parentLog, parentPost } from './worker.js';
+import { checkUpdates } from './checkUpdates.js';
 const debug = hasParameter('debug') || hasParameter('verbose');
 const verbose = hasParameter('verbose');
 if (!isMainThread && parentPort) {
@@ -16,6 +17,8 @@ if (verbose)
     logWorkerInfo(log, verbose);
 let success = false;
 try {
+    const shared = (await server.fetch({ type: 'matterbridge_shared', src: `matterbridge`, dst: 'matterbridge' })).result.data;
+    await checkUpdates(shared);
     success = true;
     log.debug(`Check updates succeeded`);
     if (!isMainThread && parentPort)

package/dist/workerTypes.d.ts

@@ -1,4 +1,4 @@
-import { LogLevel } from 'node-ansi-logger';
+import type { LogLevel } from 'node-ansi-logger';
 export type ParentPortMessage = {
     type: 'init';
     threadName: string | null;

package/npm-shrinkwrap.json

@@ -1,17 +1,18 @@
 {
   "name": "matterbridge",
-  "version": "3.5.2-dev-20260128-beb91f9",
+  "version": "3.5.2-dev-20260129-e83daf7",
   "lockfileVersion": 3,
   "requires": true,
   "packages": {
     "": {
       "name": "matterbridge",
-      "version": "3.5.2-dev-20260128-beb91f9",
+      "version": "3.5.2-dev-20260129-e83daf7",
       "license": "Apache-2.0",
       "dependencies": {
         "@matter/main": "0.16.7",
         "@matterbridge/dgram": "0.0.3",
         "@matterbridge/jest-utils": "0.0.1",
+        "@matterbridge/thread": "0.0.1",
         "@matterbridge/utils": "0.0.2",
         "@matterbridge/vitest-utils": "0.0.1",
         "archiver": "7.0.1",
@@ -25,6 +26,7 @@
       "bin": {
         "matterbridge": "bin/matterbridge.js",
         "mb_coap": "bin/mb_coap.js",
+        "mb_health": "bin/mb_health.js",
         "mb_mdns": "bin/mb_mdns.js"
       },
       "engines": {
@@ -189,6 +191,22 @@
         "url": "https://www.buymeacoffee.com/luligugithub"
       }
     },
+    "node_modules/@matterbridge/thread": {
+      "version": "0.0.1",
+      "resolved": "https://registry.npmjs.org/@matterbridge/thread/-/thread-0.0.1.tgz",
+      "integrity": "sha512-jKmsuPACQXmv2PBLIVSf11CfXW9+u5lJTBJ4j9CzYeRN85Jm7ptkiJH888Uf2wW3kSvk0wvuUO7I+sA1fORkFg==",
+      "license": "Apache-2.0",
+      "dependencies": {
+        "node-ansi-logger": "3.1.1"
+      },
+      "engines": {
+        "node": ">=20.0.0 <21.0.0 || >=22.0.0 <23.0.0 || >=24.0.0 <25.0.0"
+      },
+      "funding": {
+        "type": "buymeacoffee",
+        "url": "https://www.buymeacoffee.com/luligugithub"
+      }
+    },
     "node_modules/@matterbridge/utils": {
       "version": "0.0.2",
       "resolved": "https://registry.npmjs.org/@matterbridge/utils/-/utils-0.0.2.tgz",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "matterbridge",
-  "version": "3.5.2-dev-20260128-beb91f9",
+  "version": "3.5.2-dev-20260129-e83daf7",
   "description": "Matterbridge plugin manager for Matter",
   "author": "https://github.com/Luligu",
   "license": "Apache-2.0",
@@ -44,7 +44,8 @@
   "bin": {
     "matterbridge": "bin/matterbridge.js",
     "mb_mdns": "bin/mb_mdns.js",
-    "mb_coap": "bin/mb_coap.js"
+    "mb_coap": "bin/mb_coap.js",
+    "mb_health": "bin/mb_health.js"
   },
   "engines": {
     "node": ">=20.0.0 <21.0.0 || >=22.0.0 <23.0.0 || >=24.0.0 <25.0.0"
@@ -111,6 +112,7 @@
     "@matter/main": "0.16.7",
     "@matterbridge/dgram": "0.0.3",
     "@matterbridge/jest-utils": "0.0.1",
+    "@matterbridge/thread": "0.0.1",
     "@matterbridge/utils": "0.0.2",
     "@matterbridge/vitest-utils": "0.0.1",
     "archiver": "7.0.1",