@matterbridge/core 3.6.2-dev-20260316-21bfabd → 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/matterbridgeEndpoint.d.ts

@@ -65,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>;

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-21bfabd",
+  "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-21bfabd",
-    "@matterbridge/thread": "3.6.2-dev-20260316-21bfabd",
-    "@matterbridge/types": "3.6.2-dev-20260316-21bfabd",
-    "@matterbridge/utils": "3.6.2-dev-20260316-21bfabd",
+    "@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",