@matterbridge/core 3.6.2-dev-20260316-0b03ae0 → 3.6.2-dev-20260317-e291a17

package/dist/devices/closure.d.ts

@@ -299,6 +299,6 @@ export interface ClosureOptions {
 }
 export declare class Closure extends MatterbridgeEndpoint {
     constructor(name: string, serial: string, options?: ClosureOptions);
-    getMainState(): ClosureControl.MainState;
+    getMainState(): ClosureControl.MainState | undefined;
 }
 export {};

package/dist/devices/closure.js

@@ -47,6 +47,6 @@ export class Closure extends MatterbridgeEndpoint {
         });
     }
     getMainState() {
-        return this.getAttribute(ClosureControl.Cluster.id, 'mainState');
+        return this.getAttribute(ClosureControlServer, 'mainState');
     }
 }

package/dist/devices/soilSensor.d.ts

@@ -23,6 +23,6 @@ export interface SoilSensorOptions {
 export declare class SoilSensor extends MatterbridgeEndpoint {
     constructor(name: string, serial: string, options?: SoilSensorOptions);
     setSoilMoistureMeasuredValue(value: number | null): Promise<void>;
-    getSoilMoistureMeasuredValue(): number | null;
+    getSoilMoistureMeasuredValue(): number | null | undefined;
 }
 export {};

package/dist/devices/soilSensor.js

@@ -47,6 +47,6 @@ export class SoilSensor extends MatterbridgeEndpoint {
         await this.setAttribute(SoilMeasurement.Cluster.id, 'soilMoistureMeasuredValue', value);
     }
     getSoilMoistureMeasuredValue() {
-        return this.getAttribute(SoilMeasurement.Cluster.id, 'soilMoistureMeasuredValue');
+        return this.getAttribute(SoilMeasurement.Cluster, 'soilMoistureMeasuredValue');
     }
 }

package/dist/devices/speaker.d.ts

@@ -4,5 +4,5 @@ export declare class Speaker extends MatterbridgeEndpoint {
     setMuted(muted: boolean): Promise<void>;
     isMuted(): boolean;
     setVolume(level: number): Promise<void>;
-    getVolume(): number;
+    getVolume(): number | null | undefined;
 }

package/dist/devices/speaker.js

@@ -28,9 +28,9 @@ export class Speaker extends MatterbridgeEndpoint {
             level = 1;
         if (level > 254)
             level = 254;
-        await this.setAttribute(LevelControl.Cluster.id, 'currentLevel', level);
+        await this.setAttribute(LevelControl.Cluster, 'currentLevel', level);
     }
     getVolume() {
-        return this.getAttribute(LevelControl.Cluster.id, 'currentLevel');
+        return this.getAttribute(LevelControl.Cluster, 'currentLevel');
     }
 }

package/dist/devices/temperatureControl.js

@@ -19,10 +19,8 @@ export function createNumberTemperatureControlClusterServer(endpoint, temperatur
 }
 export class MatterbridgeLevelTemperatureControlServer extends TemperatureControlServer.with(TemperatureControl.Feature.TemperatureLevel) {
     initialize() {
-        if (this.state.supportedTemperatureLevels.length >= 2) {
-            const device = this.endpoint.stateOf(MatterbridgeServer);
-            device.log.info(`MatterbridgeLevelTemperatureControlServer initialized with selectedTemperatureLevel ${this.state.selectedTemperatureLevel} and supportedTemperatureLevels: ${this.state.supportedTemperatureLevels.join(', ')}`);
-        }
+        const device = this.endpoint.stateOf(MatterbridgeServer);
+        device.log.info(`MatterbridgeLevelTemperatureControlServer initialized with selectedTemperatureLevel ${this.state.selectedTemperatureLevel} and supportedTemperatureLevels: ${this.state.supportedTemperatureLevels.join(', ')}`);
     }
     setTemperature(request) {
         const device = this.endpoint.stateOf(MatterbridgeServer);

package/dist/frontend.js

@@ -1123,12 +1123,14 @@ export class Frontend extends EventEmitter {
         }
         return devices;
     }
-    getClusters(pluginName, endpointNumber) {
+    getClusters(pluginName, endpointNumber, serialNumber, uniqueId) {
         if (this.matterbridge.hasCleanupStarted)
             return;
-        const endpoint = this.matterbridge.devices.array().find((d) => d.plugin === pluginName && d.maybeNumber === endpointNumber);
+        const endpoint = this.matterbridge.devices
+            .array()
+            .find((d) => d.plugin === pluginName && d.maybeNumber === endpointNumber && (!serialNumber || d.serialNumber === serialNumber) && (!uniqueId || d.uniqueId === uniqueId));
         if (!endpoint || !endpoint.plugin || !endpoint.maybeNumber || !endpoint.maybeId || !endpoint.deviceName || !endpoint.serialNumber) {
-            this.log.error(`getClusters: no device found for plugin ${pluginName} and endpoint number ${endpointNumber}`);
+            this.log.error(`getClusters: no device found for plugin ${pluginName} and endpoint number ${endpointNumber} (serial: ${serialNumber ?? 'N/A'}, uniqueId: ${uniqueId ?? 'N/A'})`);
             return;
         }
         const deviceTypes = [];
@@ -1592,7 +1594,7 @@ export class Frontend extends EventEmitter {
                     sendResponse({ id: data.id, method: data.method, src: 'Matterbridge', dst: data.src, error: 'Wrong parameter endpoint in /api/clusters' });
                     return;
                 }
-                const response = this.getClusters(data.params.plugin, data.params.endpoint);
+                const response = this.getClusters(data.params.plugin, data.params.endpoint, data.params.serialNumber, data.params.uniqueId);
                 if (response) {
                     sendResponse({
                         id: data.id,

package/dist/matterbridgeEndpoint.d.ts

@@ -25,6 +25,13 @@ import { Semtag } from '@matter/types/globals';
 import { AnsiLogger, LogLevel } from 'node-ansi-logger';
 import { DeviceTypeDefinition } from './matterbridgeDeviceTypes.js';
 import { CommandHandlerFunction, MatterbridgeEndpointCommands, MatterbridgeEndpointOptions, SerializedMatterbridgeEndpoint } from './matterbridgeEndpointTypes.js';
+type BehaviorCommandName<T extends Behavior.Type> = {
+    [K in keyof CommandsOfBehavior<T>]: K;
+}[keyof CommandsOfBehavior<T>] & string;
+type CommandsOfBehavior<T extends Behavior.Type> = {
+    [K in keyof InstanceType<T> as InstanceType<T>[K] extends (...args: infer _P) => infer _R ? K : never]: InstanceType<T>[K] extends (...args: infer P) => infer R ? (input: P[0], context?: ActionContext) => Promise<Awaited<R>> : never;
+};
+type BehaviorCommandParams<T extends Behavior.Type, C extends BehaviorCommandName<T>> = CommandsOfBehavior<T>[C] extends (input: infer P, context?: ActionContext) => Promise<unknown> ? P : never;
 export declare function isMatterbridgeEndpoint(value: unknown): value is MatterbridgeEndpoint;
 export declare function assertMatterbridgeEndpoint(value: unknown, context?: string): asserts value is MatterbridgeEndpoint;
 export declare class MatterbridgeEndpoint extends Endpoint {
@@ -58,10 +65,18 @@ export declare class MatterbridgeEndpoint extends Endpoint {
     hasClusterServer(cluster: Behavior.Type | ClusterType | ClusterId | string): boolean;
     hasAttributeServer(cluster: Behavior.Type | ClusterType | ClusterId | string, attribute: string): boolean;
     getClusterServerOptions(cluster: Behavior.Type | ClusterType | ClusterId | string): Record<string, boolean | number | bigint | string | object | null> | undefined;
-    getAttribute(cluster: Behavior.Type | ClusterType | ClusterId | string, attribute: string, log?: AnsiLogger): any;
-    setAttribute(clusterId: Behavior.Type | ClusterType | ClusterId | string, attribute: string, value: boolean | number | bigint | string | object | null, log?: AnsiLogger): Promise<boolean>;
-    updateAttribute(cluster: Behavior.Type | ClusterType | ClusterId | string, attribute: string, value: boolean | number | bigint | string | object | null, log?: AnsiLogger): Promise<boolean>;
-    subscribeAttribute(cluster: Behavior.Type | ClusterType | ClusterId | string, attribute: string, listener: (newValue: any, oldValue: any, context: ActionContext) => void, log?: AnsiLogger): Promise<boolean>;
+    getAttribute<T extends Behavior.Type, A extends keyof Behavior.StateOf<T>>(cluster: T, attribute: A, log?: AnsiLogger): Behavior.StateOf<T>[A] | undefined;
+    getAttribute<T extends ClusterType, A extends keyof ClusterType.AttributeValues<T>>(cluster: T, attribute: A, log?: AnsiLogger): ClusterType.AttributeValues<T>[A] | undefined;
+    getAttribute(cluster: ClusterId | string, attribute: string, log?: AnsiLogger): any;
+    setAttribute<T extends Behavior.Type, A extends keyof Behavior.StateOf<T>>(clusterId: T, attribute: A, value: Behavior.StateOf<T>[A], log?: AnsiLogger): Promise<boolean>;
+    setAttribute<T extends ClusterType, A extends keyof ClusterType.AttributeValues<T>>(clusterId: T, attribute: A, value: ClusterType.AttributeValues<T>[A], log?: AnsiLogger): Promise<boolean>;
+    setAttribute(clusterId: ClusterId | string, attribute: string, value: boolean | number | bigint | string | object | null, log?: AnsiLogger): Promise<boolean>;
+    updateAttribute<T extends Behavior.Type, A extends keyof Behavior.StateOf<T>>(cluster: T, attribute: A, value: Behavior.StateOf<T>[A], log?: AnsiLogger): Promise<boolean>;
+    updateAttribute<T extends ClusterType, A extends keyof ClusterType.AttributeValues<T>>(cluster: T, attribute: A, value: ClusterType.AttributeValues<T>[A], log?: AnsiLogger): Promise<boolean>;
+    updateAttribute(cluster: ClusterId | string, attribute: string, value: boolean | number | bigint | string | object | null, log?: AnsiLogger): Promise<boolean>;
+    subscribeAttribute<T extends Behavior.Type, A extends keyof Behavior.StateOf<T>>(cluster: T, attribute: A, listener: (newValue: Behavior.StateOf<T>[A], oldValue: Behavior.StateOf<T>[A], context: ActionContext) => void, log?: AnsiLogger): Promise<boolean>;
+    subscribeAttribute<T extends ClusterType, A extends keyof ClusterType.AttributeValues<T>>(cluster: T, attribute: A, listener: (newValue: ClusterType.AttributeValues<T>[A], oldValue: ClusterType.AttributeValues<T>[A], context: ActionContext) => void, log?: AnsiLogger): Promise<boolean>;
+    subscribeAttribute(cluster: ClusterId | string, attribute: string, listener: (newValue: any, oldValue: any, context: ActionContext) => void, log?: AnsiLogger): Promise<boolean>;
     setCluster<T extends Behavior.Type>(cluster: T, value: Behavior.StateOf<T>, log?: AnsiLogger): Promise<boolean>;
     setCluster<T extends ClusterType>(cluster: T, value: ClusterType.AttributeValues<T>, log?: AnsiLogger): Promise<boolean>;
     setCluster(cluster: ClusterId | string, value: Record<string, boolean | number | bigint | string | object | undefined | null>, log?: AnsiLogger): Promise<boolean>;
@@ -74,11 +89,7 @@ export declare class MatterbridgeEndpoint extends Endpoint {
     addUserLabel(label: string, value: string): Promise<this>;
     addCommandHandler(command: keyof MatterbridgeEndpointCommands, handler: CommandHandlerFunction): this;
     executeCommandHandler(command: keyof MatterbridgeEndpointCommands, request?: Record<string, boolean | number | bigint | string | object | null>, cluster?: string, attributes?: Record<string, boolean | number | bigint | string | object | null>, endpoint?: MatterbridgeEndpoint): Promise<void>;
-    invokeBehaviorCommand<T extends Behavior.Type, C extends keyof {
-        [K in keyof InstanceType<T> as InstanceType<T>[K] extends (...args: unknown[]) => unknown ? K : never]: InstanceType<T>[K];
-    }>(cluster: T, command: C, params?: {
-        [K in keyof InstanceType<T> as InstanceType<T>[K] extends (...args: unknown[]) => unknown ? K : never]: InstanceType<T>[K];
-    }[C] extends (...args: infer P) => unknown ? P[0] : never): Promise<void>;
+    invokeBehaviorCommand<T extends Behavior.Type, C extends BehaviorCommandName<T>>(cluster: T, command: C, params?: BehaviorCommandParams<T, C>): Promise<void>;
     invokeBehaviorCommand<T extends ClusterType, C extends keyof ClusterType.CommandsOf<T>>(cluster: T, command: C, params?: ClusterType.CommandsOf<T>[C] extends {
         requestSchema: infer S extends import('@matter/types/tlv').TlvSchema<unknown>;
     } ? import('@matter/types/tlv').TypeFromSchema<S> : never): Promise<void>;
@@ -191,3 +202,4 @@ export declare class MatterbridgeEndpoint extends Endpoint {
     createDefaultRadonConcentrationMeasurementClusterServer(measuredValue?: number | null, measurementUnit?: ConcentrationMeasurement.MeasurementUnit, measurementMedium?: ConcentrationMeasurement.MeasurementMedium): this;
     createDefaultNitrogenDioxideConcentrationMeasurementClusterServer(measuredValue?: number | null, measurementUnit?: ConcentrationMeasurement.MeasurementUnit, measurementMedium?: ConcentrationMeasurement.MeasurementMedium): this;
 }
+export {};

package/dist/matterbridgeEndpoint.js

@@ -825,7 +825,7 @@ export class MatterbridgeEndpoint extends Endpoint {
             this.log.debug(`Set WindowCovering currentPositionTiltPercent100ths: ${tiltPosition} and targetPositionTiltPercent100ths: ${tiltPosition}.`);
         }
     }
-    createDefaultThermostatClusterServer(localTemperature = 23, occupiedHeatingSetpoint = 21, occupiedCoolingSetpoint = 25, minSetpointDeadBand = 1, minHeatSetpointLimit = 0, maxHeatSetpointLimit = 50, minCoolSetpointLimit = 0, maxCoolSetpointLimit = 50, unoccupiedHeatingSetpoint = undefined, unoccupiedCoolingSetpoint = undefined, occupied = undefined, outdoorTemperature = undefined) {
+    createDefaultThermostatClusterServer(localTemperature = 23, occupiedHeatingSetpoint = 21, occupiedCoolingSetpoint = 25, minSetpointDeadBand = 0, minHeatSetpointLimit = 0, maxHeatSetpointLimit = 50, minCoolSetpointLimit = 0, maxCoolSetpointLimit = 50, unoccupiedHeatingSetpoint = undefined, unoccupiedCoolingSetpoint = undefined, occupied = undefined, outdoorTemperature = undefined) {
         this.behaviors.require(MatterbridgeThermostatServer.with(Thermostat.Feature.Heating, Thermostat.Feature.Cooling, Thermostat.Feature.AutoMode, ...(occupied !== undefined ? [Thermostat.Feature.Occupancy] : [])), {
             localTemperature: localTemperature * 100,
             externalMeasuredIndoorTemperature: localTemperature * 100,
@@ -887,7 +887,7 @@ export class MatterbridgeEndpoint extends Endpoint {
         });
         return this;
     }
-    createDefaultPresetsThermostatClusterServer(localTemperature = 23, occupiedHeatingSetpoint = 21, occupiedCoolingSetpoint = 25, minSetpointDeadBand = 2, minHeatSetpointLimit = 0, maxHeatSetpointLimit = 50, minCoolSetpointLimit = 0, maxCoolSetpointLimit = 50, unoccupiedHeatingSetpoint = undefined, unoccupiedCoolingSetpoint = undefined, occupied = undefined, outdoorTemperature = undefined, activePresetHandle = undefined, presetsList = undefined, presetTypes = undefined) {
+    createDefaultPresetsThermostatClusterServer(localTemperature = 23, occupiedHeatingSetpoint = 21, occupiedCoolingSetpoint = 25, minSetpointDeadBand = 0, minHeatSetpointLimit = 0, maxHeatSetpointLimit = 50, minCoolSetpointLimit = 0, maxCoolSetpointLimit = 50, unoccupiedHeatingSetpoint = undefined, unoccupiedCoolingSetpoint = undefined, occupied = undefined, outdoorTemperature = undefined, activePresetHandle = undefined, presetsList = undefined, presetTypes = undefined) {
         this.behaviors.require(MatterbridgePresetThermostatServer.with(Thermostat.Feature.Heating, Thermostat.Feature.Cooling, Thermostat.Feature.AutoMode, ...(occupied !== undefined ? [Thermostat.Feature.Occupancy] : []), Thermostat.Feature.Presets), {
             localTemperature: localTemperature * 100,
             externalMeasuredIndoorTemperature: localTemperature * 100,

package/dist/matterbridgeEndpointHelpers.d.ts

@@ -23,6 +23,7 @@ import { MatterbridgeEndpoint } from './matterbridgeEndpoint.js';
 import { MatterbridgeEndpointCommands } from './matterbridgeEndpointTypes.js';
 export declare function capitalizeFirstLetter(name: string): string;
 export declare function lowercaseFirstLetter(name: string): string;
+export declare function getSnapshot<T>(value: T): T;
 export declare function checkNotLatinCharacters(deviceName: string): boolean;
 export declare function generateUniqueId(deviceName: string): string;
 export declare function createUniqueId(param1: string, param2: string, param3: string, param4: string): string;

package/dist/matterbridgeEndpointHelpers.js

@@ -79,7 +79,6 @@ import { UserLabel } from '@matter/types/clusters/user-label';
 import { ValveConfigurationAndControl } from '@matter/types/clusters/valve-configuration-and-control';
 import { WindowCovering } from '@matter/types/clusters/window-covering';
 import { MeasurementType } from '@matter/types/globals';
-import { deepCopy } from '@matterbridge/utils/deep-copy';
 import { deepEqual } from '@matterbridge/utils/deep-equal';
 import { isValidArray } from '@matterbridge/utils/validate';
 import { BLUE, CYAN, db, debugStringify, er, hk, or, YELLOW, zb } from 'node-ansi-logger';
@@ -94,6 +93,36 @@ export function lowercaseFirstLetter(name) {
         return name;
     return name.charAt(0).toLowerCase() + name.slice(1);
 }
+export function getSnapshot(value) {
+    if (typeof value !== 'object' || value === null)
+        return value;
+    if (Buffer.isBuffer(value))
+        return Buffer.from(value);
+    if (value instanceof Uint8Array)
+        return Uint8Array.from(value);
+    if (Array.isArray(value)) {
+        return value.map((entry) => getSnapshot(entry));
+    }
+    if (value instanceof Date)
+        return new Date(value.getTime());
+    if (value instanceof RegExp)
+        return new RegExp(value.source, value.flags);
+    if (value instanceof Map) {
+        const mapCopy = new Map();
+        for (const [key, entry] of value.entries()) {
+            mapCopy.set(getSnapshot(key), getSnapshot(entry));
+        }
+        return mapCopy;
+    }
+    if (value instanceof Set) {
+        return new Set(Array.from(value, (entry) => getSnapshot(entry)));
+    }
+    const plainObject = {};
+    for (const [key, entry] of Object.entries(value)) {
+        plainObject[key] = getSnapshot(entry);
+    }
+    return plainObject;
+}
 export function checkNotLatinCharacters(deviceName) {
     const nonLatinRegexList = [
         /[\u0400-\u04FF\u0500-\u052F]/,
@@ -463,7 +492,7 @@ export function getAttribute(endpoint, cluster, attribute, log) {
     }
     let value = state[clusterName][attribute];
     if (typeof value === 'object')
-        value = deepCopy(value);
+        value = getSnapshot(value);
     log?.info(`${db}Get endpoint ${or}${endpoint.id}${db}:${or}${endpoint.number}${db} attribute ${hk}${capitalizeFirstLetter(clusterName)}${db}.${hk}${attribute}${db} value ${YELLOW}${value !== null && typeof value === 'object' ? debugStringify(value) : value}${db}`);
     return value;
 }
@@ -485,7 +514,7 @@ export async function setAttribute(endpoint, cluster, attribute, value, log) {
     }
     let oldValue = state[clusterName][attribute];
     if (typeof oldValue === 'object')
-        oldValue = deepCopy(oldValue);
+        oldValue = getSnapshot(oldValue);
     await endpoint.setStateOf(endpoint.behaviors.supported[clusterName], { [attribute]: value });
     log?.info(`${db}Set endpoint ${or}${endpoint.id}${db}:${or}${endpoint.number}${db} attribute ${hk}${capitalizeFirstLetter(clusterName)}${db}.${hk}${attribute}${db} ` +
         `from ${YELLOW}${oldValue !== null && typeof oldValue === 'object' ? debugStringify(oldValue) : oldValue}${db} ` +
@@ -512,7 +541,7 @@ export async function updateAttribute(endpoint, cluster, attribute, value, log)
     if (typeof oldValue === 'object') {
         if (deepEqual(oldValue, value))
             return false;
-        oldValue = deepCopy(oldValue);
+        oldValue = getSnapshot(oldValue);
     }
     else if (oldValue === value)
         return false;
@@ -567,7 +596,7 @@ export function getCluster(endpoint, cluster, log) {
         return undefined;
     }
     const state = endpoint.state;
-    const value = deepCopy(state[clusterName]);
+    const value = getSnapshot(state[clusterName]);
     log?.info(`${db}Get endpoint ${or}${endpoint.id}${db}:${or}${endpoint.number}${db} cluster ${hk}${capitalizeFirstLetter(clusterName)}${db} state ${debugStringify(value)}}`);
     return value;
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@matterbridge/core",
-  "version": "3.6.2-dev-20260316-0b03ae0",
+  "version": "3.6.2-dev-20260317-e291a17",
   "description": "Matterbridge core library",
   "author": "https://github.com/Luligu",
   "homepage": "https://matterbridge.io/",
@@ -122,10 +122,10 @@
   ],
   "dependencies": {
     "@matter/main": "0.16.10",
-    "@matterbridge/dgram": "3.6.2-dev-20260316-0b03ae0",
-    "@matterbridge/thread": "3.6.2-dev-20260316-0b03ae0",
-    "@matterbridge/types": "3.6.2-dev-20260316-0b03ae0",
-    "@matterbridge/utils": "3.6.2-dev-20260316-0b03ae0",
+    "@matterbridge/dgram": "3.6.2-dev-20260317-e291a17",
+    "@matterbridge/thread": "3.6.2-dev-20260317-e291a17",
+    "@matterbridge/types": "3.6.2-dev-20260317-e291a17",
+    "@matterbridge/utils": "3.6.2-dev-20260317-e291a17",
     "express": "5.2.1",
     "multer": "2.1.1",
     "node-ansi-logger": "3.2.0",