matterbridge-test 1.3.0-dev-20251016-f158fac → 2.0.0-dev-20251025-d87e883

package/CHANGELOG.md

@@ -23,6 +23,19 @@ 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>
 
+## [2.0.0] - 2025-10-24
+
+### Changed
+
+- [package]: Bumped platform to v. 2.0.0.
+- [package]: Updated dependencies.
+- [package]: Bumped package to automator v. 2.0.9.
+- [jest]: Updated jestHelpers to v. 1.0.9.
+
+<a href="https://www.buymeacoffee.com/luligugithub">
+  <img src="bmc-button.svg" alt="Buy me a coffee" width="80">
+</a>
+
 ## [1.3.0] - 2025-10-15
 
 ### Changed

package/dist/jestHelpers.js

@@ -5,12 +5,16 @@ import { jest } from '@jest/globals';
 import { DeviceTypeId, Endpoint, Environment, MdnsService, ServerNode, ServerNodeStore, VendorId, LogFormat as MatterLogFormat, LogLevel as MatterLogLevel, Lifecycle, } from 'matterbridge/matter';
 import { RootEndpoint, AggregatorEndpoint } from 'matterbridge/matter/endpoints';
 import { AnsiLogger } from 'matterbridge/logger';
+import { MATTER_STORAGE_NAME, Matterbridge } from 'matterbridge';
 export let loggerLogSpy;
 export let consoleLogSpy;
 export let consoleDebugSpy;
 export let consoleInfoSpy;
 export let consoleWarnSpy;
 export let consoleErrorSpy;
+export const addBridgedEndpointSpy = jest.spyOn(Matterbridge.prototype, 'addBridgedEndpoint');
+export const removeBridgedEndpointSpy = jest.spyOn(Matterbridge.prototype, 'removeBridgedEndpoint');
+export const removeAllBridgedEndpointSpy = jest.spyOn(Matterbridge.prototype, 'removeAllBridgedEndpoints');
 export function setupTest(name, debug = false) {
     expect(name).toBeDefined();
     expect(typeof name).toBe('string');
@@ -57,20 +61,97 @@ export function setDebug(debug) {
         consoleErrorSpy = jest.spyOn(console, 'error').mockImplementation(() => { });
     }
 }
-export function createTestEnvironment(homeDir) {
-    expect(homeDir).toBeDefined();
-    expect(typeof homeDir).toBe('string');
-    expect(homeDir.length).toBeGreaterThanOrEqual(4);
-    rmSync(homeDir, { recursive: true, force: true });
+export async function createMatterbridgeEnvironment(name) {
+    const matterbridge = await Matterbridge.loadInstance(false);
+    expect(matterbridge).toBeDefined();
+    expect(matterbridge).toBeInstanceOf(Matterbridge);
+    matterbridge.matterbridgeVersion = '3.3.0';
+    matterbridge.bridgeMode = 'bridge';
+    matterbridge.rootDirectory = path.join('jest', name);
+    matterbridge.homeDirectory = path.join('jest', name);
+    matterbridge.matterbridgeDirectory = path.join('jest', name, '.matterbridge');
+    matterbridge.matterbridgePluginDirectory = path.join('jest', name, 'Matterbridge');
+    matterbridge.matterbridgeCertDirectory = path.join('jest', name, '.mattercert');
+    matterbridge.environment = createTestEnvironment(name);
+    expect(matterbridge.environment).toBeDefined();
+    expect(matterbridge.environment).toBeInstanceOf(Environment);
+    return matterbridge;
+}
+export async function startMatterbridgeEnvironment(matterbridge, port = 5540) {
+    await matterbridge.startMatterStorage();
+    expect(matterbridge.matterStorageService).toBeDefined();
+    expect(matterbridge.matterStorageManager).toBeDefined();
+    expect(matterbridge.matterbridgeContext).toBeDefined();
+    const server = await matterbridge.createServerNode(matterbridge.matterbridgeContext, port);
+    expect(server).toBeDefined();
+    expect(server).toBeDefined();
+    expect(server.lifecycle.isReady).toBeTruthy();
+    matterbridge.serverNode = server;
+    const aggregator = await matterbridge.createAggregatorNode(matterbridge.matterbridgeContext);
+    expect(aggregator).toBeDefined();
+    matterbridge.aggregatorNode = aggregator;
+    expect(await server.add(aggregator)).toBeDefined();
+    expect(server.parts.has(aggregator.id)).toBeTruthy();
+    expect(server.parts.has(aggregator)).toBeTruthy();
+    expect(aggregator.lifecycle.isReady).toBeTruthy();
+    expect(server.lifecycle.isOnline).toBeFalsy();
+    await new Promise((resolve) => {
+        server.lifecycle.online.on(async () => {
+            resolve();
+        });
+        server.start();
+    });
+    expect(server.lifecycle.isReady).toBeTruthy();
+    expect(server.lifecycle.isOnline).toBeTruthy();
+    expect(server.lifecycle.isCommissioned).toBeFalsy();
+    expect(server.lifecycle.isPartsReady).toBeTruthy();
+    expect(server.lifecycle.hasId).toBeTruthy();
+    expect(server.lifecycle.hasNumber).toBeTruthy();
+    expect(aggregator.lifecycle.isReady).toBeTruthy();
+    expect(aggregator.lifecycle.isInstalled).toBeTruthy();
+    expect(aggregator.lifecycle.isPartsReady).toBeTruthy();
+    expect(aggregator.lifecycle.hasId).toBeTruthy();
+    expect(aggregator.lifecycle.hasNumber).toBeTruthy();
+    await flushAsync();
+    return [server, aggregator];
+}
+export async function stopMatterbridgeEnvironment(matterbridge, server, aggregator) {
+    expect(matterbridge).toBeDefined();
+    expect(server).toBeDefined();
+    expect(aggregator).toBeDefined();
+    await flushAllEndpointNumberPersistence(server);
+    await assertAllEndpointNumbersPersisted(server);
+    expect(server.lifecycle.isReady).toBeTruthy();
+    expect(server.lifecycle.isOnline).toBeTruthy();
+    await server.close();
+    expect(server.lifecycle.isReady).toBeTruthy();
+    expect(server.lifecycle.isOnline).toBeFalsy();
+    await server.env.get(MdnsService)[Symbol.asyncDispose]();
+    await matterbridge.stopMatterStorage();
+    expect(matterbridge.matterStorageService).not.toBeDefined();
+    expect(matterbridge.matterStorageManager).not.toBeDefined();
+    expect(matterbridge.matterbridgeContext).not.toBeDefined();
+    await flushAsync();
+}
+export async function destroyMatterbridgeEnvironment(matterbridge) {
+    await matterbridge.destroyInstance(10);
+    Matterbridge.instance = undefined;
+}
+export function createTestEnvironment(name) {
+    expect(name).toBeDefined();
+    expect(typeof name).toBe('string');
+    expect(name.length).toBeGreaterThanOrEqual(4);
+    rmSync(path.join('jest', name), { recursive: true, force: true });
     const environment = Environment.default;
     environment.vars.set('log.level', MatterLogLevel.DEBUG);
     environment.vars.set('log.format', MatterLogFormat.ANSI);
-    environment.vars.set('path.root', homeDir);
+    environment.vars.set('path.root', path.join('jest', name, '.matterbridge', MATTER_STORAGE_NAME));
     environment.vars.set('runtime.signals', false);
     environment.vars.set('runtime.exitcode', false);
+    new MdnsService(environment);
     return environment;
 }
-export async function flushAsync(ticks = 3, microTurns = 10, pause = 100) {
+export async function flushAsync(ticks = 3, microTurns = 10, pause = 250) {
     for (let i = 0; i < ticks; i++)
         await new Promise((resolve) => setImmediate(resolve));
     for (let i = 0; i < microTurns; i++)
@@ -113,9 +194,10 @@ export async function assertAllEndpointNumbersPersisted(targetServer) {
     }
     return all.length;
 }
-export async function startServerNode(name, port) {
+export async function startServerNode(name, port, environment) {
     const server = await ServerNode.create({
         id: name + 'ServerNode',
+        environment: environment,
         productDescription: {
             name: name + 'ServerNode',
             deviceType: DeviceTypeId(RootEndpoint.deviceType),
@@ -164,7 +246,7 @@ export async function startServerNode(name, port) {
     expect(aggregator.lifecycle.isPartsReady).toBeTruthy();
     expect(aggregator.lifecycle.hasId).toBeTruthy();
     expect(aggregator.lifecycle.hasNumber).toBeTruthy();
-    await flushAsync(undefined, undefined, 200);
+    await flushAsync();
     return [server, aggregator];
 }
 export async function stopServerNode(server) {
@@ -177,7 +259,7 @@ export async function stopServerNode(server) {
     expect(server.lifecycle.isReady).toBeTruthy();
     expect(server.lifecycle.isOnline).toBeFalsy();
     await server.env.get(MdnsService)[Symbol.asyncDispose]();
-    await flushAsync(undefined, undefined, 200);
+    await flushAsync();
 }
 export async function addDevice(owner, device, pause = 10) {
     expect(owner).toBeDefined();
@@ -201,7 +283,7 @@ export async function addDevice(owner, device, pause = 10) {
     expect(device.lifecycle.hasId).toBeTruthy();
     expect(device.lifecycle.hasNumber).toBeTruthy();
     expect(device.construction.status).toBe(Lifecycle.Status.Active);
-    await flushAsync(1, 1, pause);
+    await flushAsync(undefined, undefined, pause);
     return true;
 }
 export async function deleteDevice(owner, device, pause = 10) {
@@ -226,6 +308,6 @@ export async function deleteDevice(owner, device, pause = 10) {
     expect(device.lifecycle.hasId).toBeTruthy();
     expect(device.lifecycle.hasNumber).toBeTruthy();
     expect(device.construction.status).toBe(Lifecycle.Status.Destroyed);
-    await flushAsync(1, 1, pause);
+    await flushAsync(undefined, undefined, pause);
     return true;
 }

package/dist/{platform.js → module.js}

@@ -2,6 +2,9 @@ import { MatterbridgeDynamicPlatform, bridgedNode, electricalSensor, onOffSwitch
 import { isValidString, waiter } from 'matterbridge/utils';
 import { CYAN, er, nf } from 'matterbridge/logger';
 import { OnOffCluster, ElectricalPowerMeasurementCluster, ElectricalEnergyMeasurementCluster, ModeSelectCluster, PowerSource, BridgedDeviceBasicInformationCluster, } from 'matterbridge/matter/clusters';
+export default function initializePlugin(matterbridge, log, config) {
+    return new TestPlatform(matterbridge, log, config);
+}
 export class TestPlatform extends MatterbridgeDynamicPlatform {
     config;
     interval;
@@ -179,6 +182,14 @@ export class TestPlatform extends MatterbridgeDynamicPlatform {
             this.log.info(`- device ${device.deviceName} with serial ${device.serialNumber}`);
         }
     }
+    addPowerSource(device, type) {
+        if (type === 'wired')
+            device.createDefaultPowerSourceWiredClusterServer(PowerSource.WiredCurrentType.Ac);
+        else if (type === 'replaceable')
+            device.createDefaultPowerSourceReplaceableBatteryClusterServer(100);
+        else if (type === 'rechargeable')
+            device.createDefaultPowerSourceRechargeableBatteryClusterServer(100);
+    }
     addElectricalMeasurements(device) {
         device.createDefaultPowerTopologyClusterServer();
         device.createDefaultElectricalPowerMeasurementClusterServer(220 * 1000, 2.5 * 1000, 220 * 2.5 * 1000, 50 * 1000);
@@ -190,14 +201,6 @@ export class TestPlatform extends MatterbridgeDynamicPlatform {
             { label: 'Led OFF', mode: 2, semanticTags: [] },
         ], 1, 1);
     }
-    addPowerSource(device, type) {
-        if (type === 'wired')
-            device.createDefaultPowerSourceWiredClusterServer(PowerSource.WiredCurrentType.Ac);
-        else if (type === 'replaceable')
-            device.createDefaultPowerSourceReplaceableBatteryClusterServer(100);
-        else if (type === 'rechargeable')
-            device.createDefaultPowerSourceRechargeableBatteryClusterServer(100);
-    }
     async onConfigure() {
         await super.onConfigure();
         this.log.info('onConfigure called');

package/npm-shrinkwrap.json

@@ -1,19 +1,19 @@
 {
   "name": "matterbridge-test",
-  "version": "1.3.0-dev-20251016-f158fac",
+  "version": "2.0.0-dev-20251025-d87e883",
   "lockfileVersion": 3,
   "requires": true,
   "packages": {
     "": {
       "name": "matterbridge-test",
-      "version": "1.3.0-dev-20251016-f158fac",
+      "version": "2.0.0-dev-20251025-d87e883",
       "license": "Apache-2.0",
       "dependencies": {
         "node-ansi-logger": "3.1.1",
         "node-persist-manager": "2.0.0"
       },
       "engines": {
-        "node": ">=18.0.0 <19.0.0 || >=20.0.0 <21.0.0 || >=22.0.0 <23.0.0 || >=24.0.0 <25.0.0"
+        "node": ">=20.0.0 <21.0.0 || >=22.0.0 <23.0.0 || >=24.0.0 <25.0.0"
       },
       "funding": {
         "type": "buymeacoffee",

package/package.json

@@ -1,12 +1,12 @@
 {
   "name": "matterbridge-test",
-  "version": "1.3.0-dev-20251016-f158fac",
+  "version": "2.0.0-dev-20251025-d87e883",
   "description": "Matterbridge test plugin",
   "author": "https://github.com/Luligu",
   "license": "Apache-2.0",
   "homepage": "https://www.npmjs.com/package/matterbridge-test",
   "type": "module",
-  "main": "dist/index.js",
+  "main": "dist/module.js",
   "repository": {
     "type": "git",
     "url": "git+https://github.com/Luligu/matterbridge-test.git"
@@ -31,7 +31,7 @@
     "shelly"
   ],
   "engines": {
-    "node": ">=18.0.0 <19.0.0 || >=20.0.0 <21.0.0 || >=22.0.0 <23.0.0 || >=24.0.0 <25.0.0"
+    "node": ">=20.0.0 <21.0.0 || >=22.0.0 <23.0.0 || >=24.0.0 <25.0.0"
   },
   "dependencies": {
     "node-ansi-logger": "3.1.1",

package/dist/index.js

@@ -1,4 +0,0 @@
-import { TestPlatform } from './platform.js';
-export default function initializePlugin(matterbridge, log, config) {
-    return new TestPlatform(matterbridge, log, config);
-}