@matterbridge/jest-utils 3.8.0 → 3.8.1-dev-20260607-08cd4da

package/dist/jestMatterTest.d.ts

@@ -1,6 +1,8 @@
 import '@matter/nodejs';
 import { Environment } from '@matter/general';
 import { Endpoint, ServerNode } from '@matter/node';
+import { BridgedDeviceBasicInformationServer } from '@matter/node/behaviors/bridged-device-basic-information';
+import { OnOffServer } from '@matter/node/behaviors/on-off';
 import { AggregatorEndpoint } from '@matter/node/endpoints';
 import { DeviceTypeId } from '@matter/types/datatype';
 import { type PlatformMatterbridge } from '@matterbridge/types';
@@ -10,6 +12,60 @@ export declare let aggregator: Endpoint<AggregatorEndpoint>;
 export declare function createTestEnvironment(): Promise<Environment>;
 export declare function destroyTestEnvironment(): Promise<void>;
 export declare function getMatterbridge(): Promise<PlatformMatterbridge>;
+export declare const addBridgedEndpointMatterbridgeSpy: import("jest-mock").Mock<(pluginName: string, device: Endpoint) => Promise<boolean>>;
+export declare const removeBridgedEndpointMatterbridgeSpy: import("jest-mock").Mock<(pluginName: string, device: Endpoint) => Promise<boolean>>;
+export declare const removeAllBridgedEndpointsMatterbridgeSpy: import("jest-mock").Mock<(pluginName: string, _delay?: number) => Promise<boolean>>;
+export declare const addVirtualEndpointMatterbridgeSpy: import("jest-mock").Mock<(pluginName: string, name: string, type: "light" | "outlet" | "switch" | "mounted_switch", callback: () => Promise<void>) => Promise<Endpoint<import("@matter/node").MutableEndpoint.With<import("@matter/node").EndpointType.For<{
+    readonly name: "MountedOnOffControl";
+    readonly deviceType: 271;
+    readonly deviceRevision: 2;
+    readonly requirements: typeof import("@matter/node/devices/mounted-on-off-control").MountedOnOffControlRequirements;
+    readonly behaviors: {
+        readonly identify: import("@matter/node").ClusterBehavior.Type<typeof import("@matter/node/behaviors").IdentifyServer, import("@matter/types").ClusterType.WithEnabledAttributes<import("@matter/types").ClusterType.WithEnabledEvents<import("@matter/types/clusters/identify").Identify, never>, never>, import("@matter/types").ClusterType.Concrete, typeof import("@matter/node/behaviors").IdentifyServer.Internal, "identify">;
+    } & {
+        readonly groups: typeof import("@matter/node/behaviors").GroupsServer;
+    } & {
+        readonly onOff: import("@matter/node").ClusterBehavior.Type<typeof OnOffServer, import("@matter/types").ClusterType.WithSupportedFeatures<import("@matter/types").ClusterType.WithSupportedFeatures<import("@matter/types").ClusterType.WithSupportedFeatures<import("@matter/types/clusters/on-off").OnOff, {
+            deadFrontBehavior: false;
+            lighting: true;
+            offOnly: false;
+        }>, {
+            deadFrontBehavior: false;
+            lighting: false;
+            offOnly: false;
+        }>, {
+            deadFrontBehavior: false;
+            lighting: true;
+            offOnly: false;
+        }>, import("@matter/types").ClusterType.Concrete, typeof import("@matter/node/behaviors/on-off").OnOffBaseServer.Internal, "onOff">;
+    } & {
+        readonly scenesManagement: import("@matter/node").ClusterBehavior.Type<typeof import("@matter/node/behaviors").ScenesManagementServer, import("@matter/types").ClusterType.WithEnabledAttributes<import("@matter/types").ClusterType.WithEnabledEvents<import("@matter/types").ClusterType.WithSupportedFeatures<import("@matter/types/clusters/scenes-management").ScenesManagement, {
+            sceneNames: true;
+        }>, never>, never>, import("@matter/types").ClusterType.Concrete, typeof import("@matter/node/behaviors").ScenesManagementServer.Internal, "scenesManagement">;
+    };
+}>, import("@matter/node").SupportedBehaviors.With<{
+    readonly identify: import("@matter/node").ClusterBehavior.Type<typeof import("@matter/node/behaviors").IdentifyServer, import("@matter/types").ClusterType.WithEnabledAttributes<import("@matter/types").ClusterType.WithEnabledEvents<import("@matter/types/clusters/identify").Identify, never>, never>, import("@matter/types").ClusterType.Concrete, typeof import("@matter/node/behaviors").IdentifyServer.Internal, "identify">;
+} & {
+    readonly groups: typeof import("@matter/node/behaviors").GroupsServer;
+} & {
+    readonly onOff: import("@matter/node").ClusterBehavior.Type<typeof OnOffServer, import("@matter/types").ClusterType.WithSupportedFeatures<import("@matter/types").ClusterType.WithSupportedFeatures<import("@matter/types").ClusterType.WithSupportedFeatures<import("@matter/types/clusters/on-off").OnOff, {
+        deadFrontBehavior: false;
+        lighting: true;
+        offOnly: false;
+    }>, {
+        deadFrontBehavior: false;
+        lighting: false;
+        offOnly: false;
+    }>, {
+        deadFrontBehavior: false;
+        lighting: true;
+        offOnly: false;
+    }>, import("@matter/types").ClusterType.Concrete, typeof import("@matter/node/behaviors/on-off").OnOffBaseServer.Internal, "onOff">;
+} & {
+    readonly scenesManagement: import("@matter/node").ClusterBehavior.Type<typeof import("@matter/node/behaviors").ScenesManagementServer, import("@matter/types").ClusterType.WithEnabledAttributes<import("@matter/types").ClusterType.WithEnabledEvents<import("@matter/types").ClusterType.WithSupportedFeatures<import("@matter/types/clusters/scenes-management").ScenesManagement, {
+        sceneNames: true;
+    }>, never>, never>, import("@matter/types").ClusterType.Concrete, typeof import("@matter/node/behaviors").ScenesManagementServer.Internal, "scenesManagement">;
+}, readonly [typeof BridgedDeviceBasicInformationServer]>, {}>>>>;
 export declare function addMatterbridge(platform: object): void;
 export declare function flushAllEndpointNumberPersistence(targetServer: ServerNode, rounds?: number, ticks?: number, microTurns?: number, pause?: number): Promise<void>;
 export declare function assertAllEndpointNumbersPersisted(targetServer: ServerNode): Promise<number>;

package/dist/jestMatterTest.js

@@ -1,8 +1,13 @@
 import '@matter/nodejs';
 import path from 'node:path';
 import { inspect } from 'node:util';
+import { jest } from '@jest/globals';
 import { Environment, Lifecycle, LogFormat as MatterLogFormat, LogLevel as MatterLogLevel } from '@matter/general';
 import { Endpoint, ServerNode, ServerNodeStore } from '@matter/node';
+import { BridgedDeviceBasicInformationServer } from '@matter/node/behaviors/bridged-device-basic-information';
+import { DescriptorServer } from '@matter/node/behaviors/descriptor';
+import { OnOffServer } from '@matter/node/behaviors/on-off';
+import { MountedOnOffControlDevice } from '@matter/node/devices/mounted-on-off-control';
 import { AggregatorEndpoint } from '@matter/node/endpoints';
 import { DeviceTypeId, VendorId } from '@matter/types/datatype';
 import { MATTER_STORAGE_DIR } from '@matterbridge/types';
@@ -27,7 +32,6 @@ export async function createTestEnvironment() {
 export async function destroyTestEnvironment() {
 }
 export async function getMatterbridge() {
-    const { jest } = await import('@jest/globals');
     const matterbridge = {
         systemInformation: {
             interfaceName: 'eth0',
@@ -58,10 +62,10 @@ export async function getMatterbridge() {
         matterbridgePluginDirectory: path.join(HOMEDIR, 'Matterbridge'),
         matterbridgeCertDirectory: path.join(HOMEDIR, '.mattercert'),
         globalModulesDirectory: path.join(HOMEDIR, 'node_modules'),
-        matterbridgeVersion: '3.8.0',
-        matterbridgeLatestVersion: '3.8.0',
-        matterbridgeDevVersion: '3.8.0',
-        frontendVersion: '3.8.0',
+        matterbridgeVersion: '3.8.1',
+        matterbridgeLatestVersion: '3.8.1',
+        matterbridgeDevVersion: '3.8.1',
+        frontendVersion: '3.8.1',
         bridgeMode: '',
         restartMode: '',
         virtualMode: 'mounted_switch',
@@ -70,25 +74,58 @@ export async function getMatterbridge() {
         aggregatorProductId: 0x8000,
         aggregatorProductName: 'Matterbridge Jest',
     };
-    const injectedFunctions = {
-        addBridgedEndpoint: jest.fn(async () => {
-            return Promise.resolve(true);
-        }),
-        removeBridgedEndpoint: jest.fn(async () => {
-            return Promise.resolve(true);
-        }),
-        removeAllBridgedEndpoints: jest.fn(async () => {
-            return Promise.resolve(true);
-        }),
-        addVirtualEndpoint: jest.fn(async () => {
-            return Promise.resolve(true);
-        }),
-    };
-    return { ...matterbridge, ...injectedFunctions };
+    return matterbridge;
 }
+const addBridgedEndpoint = jest.fn(async (pluginName, device) => {
+    await aggregator.add(device);
+    return Promise.resolve(true);
+});
+const removeBridgedEndpoint = jest.fn(async (pluginName, device) => {
+    await device.delete();
+    return Promise.resolve(true);
+});
+const removeAllBridgedEndpoints = jest.fn(async (pluginName, _delay = 0) => {
+    for (const device of aggregator.parts) {
+        await device.delete();
+    }
+    return Promise.resolve(true);
+});
+const addVirtualEndpoint = jest.fn(async (pluginName, name, type, callback) => {
+    const device = new Endpoint(MountedOnOffControlDevice.with(BridgedDeviceBasicInformationServer), {
+        id: name.replaceAll(' ', '') + ':' + type,
+        bridgedDeviceBasicInformation: {
+            vendorId: VendorId(0xfff1),
+            vendorName: 'Matterbridge',
+            productName: 'Matterbridge Virtual Device',
+            nodeLabel: name.slice(0, 32),
+            softwareVersion: 20000,
+            softwareVersionString: '2.0.0',
+        },
+        onOff: { onOff: false },
+    });
+    device.events.onOff.onOff$Changed.on((value) => {
+        if (value) {
+            void callback().catch(() => { });
+            void device.setStateOf(OnOffServer, { onOff: false }).catch(() => { });
+        }
+    });
+    await aggregator.add(device);
+    if (type === 'mounted_switch') {
+        await device.act(async (agent) => {
+            const descriptor = await agent.load(DescriptorServer);
+            descriptor.addDeviceTypes('OnOffPlugInUnit');
+        });
+    }
+    await device.setStateOf(OnOffServer, { onOff: false });
+    return device;
+});
+export const addBridgedEndpointMatterbridgeSpy = addBridgedEndpoint;
+export const removeBridgedEndpointMatterbridgeSpy = removeBridgedEndpoint;
+export const removeAllBridgedEndpointsMatterbridgeSpy = removeAllBridgedEndpoints;
+export const addVirtualEndpointMatterbridgeSpy = addVirtualEndpoint;
 export function addMatterbridge(platform) {
     expect(platform).toBeDefined();
-    platform.setMatterNode(platform.matterbridge.addBridgedEndpoint, platform.matterbridge.removeBridgedEndpoint, platform.matterbridge.removeAllBridgedEndpoints, platform.matterbridge.addVirtualEndpoint);
+    platform.setMatterNode(addBridgedEndpoint, removeBridgedEndpoint, removeAllBridgedEndpoints, addVirtualEndpoint);
 }
 export async function flushAllEndpointNumberPersistence(targetServer, rounds = 3, ticks = 1, microTurns = 1, pause = 10) {
     const nodeStore = targetServer.env.get(ServerNodeStore);
@@ -154,7 +191,8 @@ export async function createServerNode(port, deviceType = DeviceTypeId(0x000e),
             vendorName: 'Matterbridge',
             productId: 0x8000,
             productName: ('Matterbridge ' + NAME).slice(0, 32),
-            nodeLabel: NAME + 'ServerNode',
+            productLabel: ('Label ' + NAME).slice(0, 64),
+            nodeLabel: (NAME + 'ServerNode').slice(0, 32),
             hardwareVersion: 1,
             softwareVersion: 1,
             reachable: true,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@matterbridge/jest-utils",
-  "version": "3.8.0",
+  "version": "3.8.1-dev-20260607-08cd4da",
   "description": "Matterbridge jest utility library",
   "author": "https://github.com/Luligu",
   "homepage": "https://matterbridge.io/",
@@ -65,7 +65,7 @@
     "CHANGELOG.md"
   ],
   "dependencies": {
-    "@matterbridge/types": "3.8.0",
+    "@matterbridge/types": "3.8.1-dev-20260607-08cd4da",
     "node-ansi-logger": "3.3.0-dev-20260524-cac9dd5"
   }
 }