@matterbridge/jest-utils 3.9.1-dev-20260614-89d7aeb → 3.9.1-dev-20260617-b1e1b99

package/README.md

@@ -6,10 +6,12 @@
 [![Docker Pulls](https://img.shields.io/docker/pulls/luligu/matterbridge?label=docker%20pulls)](https://hub.docker.com/r/luligu/matterbridge)
 ![Node.js CI](https://github.com/Luligu/matterbridge/actions/workflows/build.yml/badge.svg)
 ![CodeQL](https://github.com/Luligu/matterbridge/actions/workflows/codeql.yml/badge.svg)
-[![codecov](https://codecov.io/gh/Luligu/matterbridge/branch/main/graph/badge.svg)](https://codecov.io/gh/Luligu/matterbridge)
-[![styled with prettier](https://img.shields.io/badge/styled_with-Prettier-f8bc45.svg?logo=prettier)](https://prettier.io/)
-[![linted with eslint](https://img.shields.io/badge/linted_with-ES_Lint-4B32C3.svg?logo=eslint)](https://eslint.org/)
+[![Codecov](https://codecov.io/gh/Luligu/matterbridge/branch/main/graph/badge.svg)](https://codecov.io/gh/Luligu/matterbridge)
+[![tested with Vitest](https://img.shields.io/badge/tested_with-Vitest-6E9F18.svg?logo=vitest&logoColor=white)](https://vitest.dev)
+[![styled with Oxc](https://img.shields.io/badge/styled_with-Oxc-9BE4E0.svg?logo=oxc&logoColor=white)](https://oxc.rs/docs/guide/usage/formatter.html)
+[![linted with Oxc](https://img.shields.io/badge/linted_with-Oxc-9BE4E0.svg?logo=oxc&logoColor=white)](https://oxc.rs/docs/guide/usage/linter.html)
 [![TypeScript](https://img.shields.io/badge/TypeScript-3178C6?logo=typescript&logoColor=white)](https://www.typescriptlang.org/)
+[![TypeScript Native](https://img.shields.io/badge/TypeScript_Native-3178C6?logo=typescript&logoColor=white)](https://github.com/microsoft/typescript-go)
 [![ESM](https://img.shields.io/badge/ESM-Node.js-339933?logo=node.js&logoColor=white)](https://nodejs.org/)
 [![matterbridge.io](https://img.shields.io/badge/matterbridge.io-online-brightgreen)](https://matterbridge.io)
 

package/dist/jestMatterTest.d.ts

@@ -10,14 +10,10 @@ export declare let aggregator: Endpoint<AggregatorEndpoint>;
 export declare function createTestEnvironment(): Promise<Environment>;
 export declare function destroyTestEnvironment(): Promise<void>;
 export declare function getMatterbridge(): PlatformMatterbridge;
-export declare const addBridgedEndpoint: import("jest-mock").Mock<(pluginName: string, device: Endpoint) => Promise<boolean>>;
-export declare const removeBridgedEndpoint: import("jest-mock").Mock<(pluginName: string, device: Endpoint) => Promise<boolean>>;
-export declare const removeAllBridgedEndpoints: import("jest-mock").Mock<(pluginName: string, _delay?: number) => Promise<boolean>>;
-export declare const addVirtualEndpoint: import("jest-mock").Mock<(pluginName: string, name: string, type: 'light' | 'outlet' | 'switch' | 'mounted_switch', callback: () => Promise<void>) => Promise<boolean>>;
-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<boolean>>;
+export declare const addBridgedEndpoint: (pluginName: string, device: Endpoint) => Promise<boolean>;
+export declare const removeBridgedEndpoint: (pluginName: string, device: Endpoint) => Promise<boolean>;
+export declare const removeAllBridgedEndpoints: (_pluginName: string, _delay?: number) => Promise<boolean>;
+export declare const addVirtualEndpoint: (pluginName: string, name: string, type: "light" | "outlet" | "switch" | "mounted_switch", callback: () => Promise<void>) => Promise<boolean>;
 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,7 +1,5 @@
 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';
@@ -11,12 +9,14 @@ import { MountedOnOffControlDevice } from '@matter/node/devices/mounted-on-off-c
 import { AggregatorEndpoint } from '@matter/node/endpoints';
 import { DeviceTypeId, VendorId } from '@matter/types/datatype';
 import { MATTER_STORAGE_DIR } from '@matterbridge/types';
+import { inspectError } from '@matterbridge/utils/error';
 import { er, rs } from 'node-ansi-logger';
 import { flushAsync } from './flushAsync.js';
-import { HOMEDIR, NAME } from './jestSetupTest.js';
+import { HOMEDIR, log, NAME } from './jestSetupTest.js';
 export let environment;
 export let server;
 export let aggregator;
+const noop = () => undefined;
 export async function createTestEnvironment() {
     expect(NAME).toBeDefined();
     expect(typeof NAME).toBe('string');
@@ -76,7 +76,7 @@ export function getMatterbridge() {
     };
     return matterbridge;
 }
-export const addBridgedEndpoint = jest.fn(async (pluginName, device) => {
+export const addBridgedEndpoint = async (pluginName, device) => {
     try {
         await aggregator.add(device);
         return Promise.resolve(true);
@@ -84,8 +84,8 @@ export const addBridgedEndpoint = jest.fn(async (pluginName, device) => {
     catch (error) {
         return Promise.reject(error);
     }
-});
-export const removeBridgedEndpoint = jest.fn(async (pluginName, device) => {
+};
+export const removeBridgedEndpoint = async (pluginName, device) => {
     try {
         await device.delete();
         return Promise.resolve(true);
@@ -93,8 +93,8 @@ export const removeBridgedEndpoint = jest.fn(async (pluginName, device) => {
     catch (error) {
         return Promise.reject(error);
     }
-});
-export const removeAllBridgedEndpoints = jest.fn(async (pluginName, _delay = 0) => {
+};
+export const removeAllBridgedEndpoints = async (_pluginName, _delay = 0) => {
     try {
         for (const device of aggregator.parts) {
             await device.delete();
@@ -104,8 +104,8 @@ export const removeAllBridgedEndpoints = jest.fn(async (pluginName, _delay = 0)
     catch (error) {
         return Promise.reject(error);
     }
-});
-export const addVirtualEndpoint = jest.fn(async (pluginName, name, type, callback) => {
+};
+export const addVirtualEndpoint = async (pluginName, name, type, callback) => {
     try {
         const device = new Endpoint(MountedOnOffControlDevice.with(BridgedDeviceBasicInformationServer), {
             id: name.replaceAll(' ', '') + ':' + type,
@@ -121,8 +121,8 @@ export const addVirtualEndpoint = jest.fn(async (pluginName, name, type, callbac
         });
         device.events.onOff.onOff$Changed.on((value) => {
             if (value) {
-                void callback().catch(() => { });
-                void device.setStateOf(OnOffServer, { onOff: false }).catch(() => { });
+                void callback().catch(noop);
+                void device.setStateOf(OnOffServer, { onOff: false }).catch(noop);
             }
         });
         await aggregator.add(device);
@@ -136,11 +136,7 @@ export const addVirtualEndpoint = jest.fn(async (pluginName, name, type, callbac
     catch (error) {
         return Promise.reject(error);
     }
-});
-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(addBridgedEndpoint, removeBridgedEndpoint, removeAllBridgedEndpoints, addVirtualEndpoint);
@@ -163,10 +159,8 @@ function collectAllEndpoints(root) {
     const list = [];
     const walk = (ep) => {
         list.push(ep);
-        if (ep.parts) {
-            for (const child of ep.parts) {
-                walk(child);
-            }
+        for (const child of ep.parts) {
+            walk(child);
         }
     };
     walk(root);
@@ -188,9 +182,8 @@ export async function assertAllEndpointNumbersPersisted(targetServer) {
     return all.length;
 }
 export async function closeServerNodeStores(targetServer) {
-    if (!targetServer)
-        targetServer = server;
-    await targetServer?.env.get(ServerNodeStore)?.endpointStores.close();
+    const resolvedTargetServer = targetServer ?? server;
+    await resolvedTargetServer?.env.get(ServerNodeStore)?.endpointStores.close();
 }
 export async function createServerNode(port, deviceType = DeviceTypeId(0x000e), ticks = 1, microTurns = 1, pause = 10) {
     const { randomBytes } = await import('node:crypto');
@@ -247,7 +240,7 @@ export async function startServerNode(ticks = 1, microTurns = 1, pause = 10) {
         throw new Error('Server node and aggregator must be created before starting the server. Call createServerNode() first.');
     }
     await new Promise((resolve, reject) => {
-        server.lifecycle.online.on(async () => {
+        server.lifecycle.online.on(() => {
             resolve();
         });
         server.start().catch((err) => reject(err));
@@ -300,9 +293,8 @@ export async function addDevice(owner, device, rounds = 3, pause = 10) {
         await owner.add(device);
     }
     catch (error) {
-        const errorMessage = error instanceof Error ? error.message : error;
-        const errorInspect = inspect(error, { depth: 10 });
-        process.stderr.write(`${er}Error adding device ${device.maybeId}.${device.maybeNumber}: ${errorMessage}${rs}\nStack: ${errorInspect}\n`);
+        inspectError(log, `Error adding device ${device.maybeId}.${device.maybeNumber}`, error);
+        process.stderr.write(`${er}Error adding device ${device.maybeId}.${device.maybeNumber}${rs}\n`);
         return false;
     }
     await device.construction.ready;
@@ -328,9 +320,8 @@ export async function deleteDevice(owner, device, rounds = 3, pause = 10) {
         await device.delete();
     }
     catch (error) {
-        const errorMessage = error instanceof Error ? error.message : error;
-        const errorInspect = inspect(error, { depth: 10 });
-        process.stderr.write(`${er}Error deleting device ${device.maybeId}.${device.maybeNumber}: ${errorMessage}${rs}\nStack: ${errorInspect}\n`);
+        inspectError(log, `Error deleting device ${device.maybeId}.${device.maybeNumber}`, error);
+        process.stderr.write(`${er}Error deleting device ${device.maybeId}.${device.maybeNumber}${rs}\n`);
         return false;
     }
     expect(owner.parts.has(device)).toBeFalsy();

package/dist/jestSetupTest.d.ts

@@ -1,4 +1,3 @@
-import type { jest } from '@jest/globals';
 import { AnsiLogger } from 'node-ansi-logger';
 export declare const originalProcessArgv: readonly string[];
 export declare const originalProcessEnv: Readonly<Record<string, string | undefined>>;
@@ -17,5 +16,5 @@ export declare let consoleErrorSpy: jest.SpiedFunction<typeof console.error>;
 export declare let NAME: string;
 export declare let HOMEDIR: string;
 export declare let log: AnsiLogger;
-export declare function setupTest(name: string, debug?: boolean): Promise<void>;
+export declare function setupTest(name: string, debug?: boolean, argv?: string[], env?: Record<string, string>): Promise<void>;
 export declare function setDebug(debug: boolean): Promise<void>;

package/dist/jestSetupTest.js

@@ -18,12 +18,17 @@ export let consoleErrorSpy;
 export let NAME;
 export let HOMEDIR;
 export let log;
-export async function setupTest(name, debug = false) {
+const noop = () => undefined;
+export async function setupTest(name, debug = false, argv = [], env = {}) {
     expect(name).toBeDefined();
     expect(typeof name).toBe('string');
     expect(name.length).toBeGreaterThanOrEqual(4);
     NAME = name;
     HOMEDIR = path.join('.cache', 'jest', name);
+    process.argv = ['jest', name, ...argv];
+    for (const [key, value] of Object.entries(env)) {
+        process.env[key] = value;
+    }
     log = new AnsiLogger({ logName: name, logTimestampFormat: 4, logLevel: "debug" });
     rmSync(HOMEDIR, { recursive: true, force: true });
     mkdirSync(HOMEDIR, { recursive: true });
@@ -43,12 +48,12 @@ export async function setupTest(name, debug = false) {
         consoleErrorSpy = jest.spyOn(console, 'error');
     }
     else {
-        loggerLogSpy = jest.spyOn(AnsiLogger.prototype, 'log').mockImplementation(() => { });
-        consoleLogSpy = jest.spyOn(console, 'log').mockImplementation(() => { });
-        consoleDebugSpy = jest.spyOn(console, 'debug').mockImplementation(() => { });
-        consoleInfoSpy = jest.spyOn(console, 'info').mockImplementation(() => { });
-        consoleWarnSpy = jest.spyOn(console, 'warn').mockImplementation(() => { });
-        consoleErrorSpy = jest.spyOn(console, 'error').mockImplementation(() => { });
+        loggerLogSpy = jest.spyOn(AnsiLogger.prototype, 'log').mockImplementation(noop);
+        consoleLogSpy = jest.spyOn(console, 'log').mockImplementation(noop);
+        consoleDebugSpy = jest.spyOn(console, 'debug').mockImplementation(noop);
+        consoleInfoSpy = jest.spyOn(console, 'info').mockImplementation(noop);
+        consoleWarnSpy = jest.spyOn(console, 'warn').mockImplementation(noop);
+        consoleErrorSpy = jest.spyOn(console, 'error').mockImplementation(noop);
     }
 }
 export async function setDebug(debug) {
@@ -68,11 +73,11 @@ export async function setDebug(debug) {
         consoleErrorSpy = jest.spyOn(console, 'error');
     }
     else {
-        loggerLogSpy = jest.spyOn(AnsiLogger.prototype, 'log').mockImplementation(() => { });
-        consoleLogSpy = jest.spyOn(console, 'log').mockImplementation(() => { });
-        consoleDebugSpy = jest.spyOn(console, 'debug').mockImplementation(() => { });
-        consoleInfoSpy = jest.spyOn(console, 'info').mockImplementation(() => { });
-        consoleWarnSpy = jest.spyOn(console, 'warn').mockImplementation(() => { });
-        consoleErrorSpy = jest.spyOn(console, 'error').mockImplementation(() => { });
+        loggerLogSpy = jest.spyOn(AnsiLogger.prototype, 'log').mockImplementation(noop);
+        consoleLogSpy = jest.spyOn(console, 'log').mockImplementation(noop);
+        consoleDebugSpy = jest.spyOn(console, 'debug').mockImplementation(noop);
+        consoleInfoSpy = jest.spyOn(console, 'info').mockImplementation(noop);
+        consoleWarnSpy = jest.spyOn(console, 'warn').mockImplementation(noop);
+        consoleErrorSpy = jest.spyOn(console, 'error').mockImplementation(noop);
     }
 }

package/dist/matterRequest.d.ts

@@ -1,5 +1,5 @@
 import { ColorControl } from '@matter/types/clusters/color-control';
-import { type LevelControl } from '@matter/types/clusters/level-control';
+import type { LevelControl } from '@matter/types/clusters/level-control';
 export declare function getMoveToLevelRequest(level: number, transitionTime: number, executeIfOff: boolean): LevelControl.MoveToLevelRequest;
 export declare function getMoveToColorTemperatureRequest(colorTemperatureMireds: number, transitionTime: number, executeIfOff: boolean): ColorControl.MoveToColorTemperatureRequest;
 export declare function getMoveToHueRequest(hue: number, transitionTime: number, executeIfOff: boolean): ColorControl.MoveToHueRequest;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@matterbridge/jest-utils",
-  "version": "3.9.1-dev-20260614-89d7aeb",
+  "version": "3.9.1-dev-20260617-b1e1b99",
   "description": "Matterbridge jest utility library",
   "author": "https://github.com/Luligu",
   "homepage": "https://matterbridge.io/",
@@ -65,7 +65,9 @@
     "CHANGELOG.md"
   ],
   "dependencies": {
-    "@matterbridge/types": "3.9.1-dev-20260614-89d7aeb",
+    "@matter/main": "0.17.3",
+    "@matterbridge/types": "3.9.1-dev-20260617-b1e1b99",
+    "@matterbridge/utils": "3.9.1-dev-20260617-b1e1b99",
     "node-ansi-logger": "3.3.0-dev-20260607-585945a"
   }
 }