@matterbridge/core 3.8.0 → 3.8.1-dev-20260607-08cd4da

package/dist/behaviors/doorLockServer.d.ts

@@ -1,6 +1,7 @@
 import { DoorLockServer } from '@matter/node/behaviors/door-lock';
 import { DoorLock } from '@matter/types/clusters/door-lock';
 declare const MatterbridgeDoorLockServer_base: import("@matter/node").ClusterBehavior.Type<import("@matter/node").ClusterBehavior.Type<typeof DoorLockServer, import("@matter/types").ClusterType.WithSupportedFeatures<DoorLock, {
+    user: true;
     pinCredential: true;
     rfidCredential: false;
     fingerCredentials: false;
@@ -8,13 +9,13 @@ declare const MatterbridgeDoorLockServer_base: import("@matter/node").ClusterBeh
     doorPositionSensor: false;
     faceCredentials: false;
     credentialOverTheAirAccess: false;
-    user: true;
     yearDayAccessSchedules: false;
     holidaySchedules: false;
     unbolting: false;
     aliroProvisioning: false;
     aliroBleuwb: false;
 }>, import("@matter/types").ClusterType.Concrete, typeof import("@matter/node/behaviors/door-lock").DoorLockBaseServer.Internal, "doorLock">, import("@matter/types").ClusterType.WithEnabledAttributes<import("@matter/types").ClusterType.WithEnabledEvents<import("@matter/types").ClusterType.WithSupportedFeatures<DoorLock, {
+    user: true;
     pinCredential: true;
     rfidCredential: false;
     fingerCredentials: false;
@@ -22,7 +23,6 @@ declare const MatterbridgeDoorLockServer_base: import("@matter/node").ClusterBeh
     doorPositionSensor: false;
     faceCredentials: false;
     credentialOverTheAirAccess: false;
-    user: true;
     yearDayAccessSchedules: false;
     holidaySchedules: false;
     unbolting: false;

package/dist/devices/extractorHood.js

@@ -10,26 +10,26 @@ export class ExtractorHood extends MatterbridgeEndpoint {
         this.createBaseFanControlClusterServer();
         this.createDefaultHepaFilterMonitoringClusterServer(hepaCondition, hepaChangeIndication, hepaInPlaceIndicator, hepaLastChangedTime, hepaReplacementProductList);
         this.createDefaultActivatedCarbonFilterMonitoringClusterServer(activatedCarbonCondition, activatedCarbonChangeIndication, activatedCarbonInPlaceIndicator, activatedCarbonLastChangedTime, activatedCarbonReplacementProductList);
-        void this.subscribeAttribute('fanControl', 'fanMode', (newValue, oldValue, context) => {
+        this.subscribeAttribute('fanControl', 'fanMode', (newValue, oldValue, context) => {
             if (context.offline === true)
                 return;
             this.log.info(`Fan control fanMode attribute changed: ${newValue}`);
-        }).catch(() => { });
-        void this.subscribeAttribute('fanControl', 'percentSetting', (newValue, oldValue, context) => {
+        });
+        this.subscribeAttribute('fanControl', 'percentSetting', (newValue, oldValue, context) => {
             if (context.offline === true)
                 return;
             this.log.info(`Fan control percentSetting attribute changed: ${newValue}`);
             void this.setAttribute('fanControl', 'percentCurrent', newValue, this.log).catch(() => { });
-        }).catch(() => { });
-        void this.subscribeAttribute('hepaFilterMonitoring', 'lastChangedTime', (newValue, oldValue, context) => {
+        });
+        this.subscribeAttribute('hepaFilterMonitoring', 'lastChangedTime', (newValue, oldValue, context) => {
             if (context.offline === true)
                 return;
             this.log.info(`Hepa filter monitoring lastChangedTime attribute changed: ${newValue}`);
-        }).catch(() => { });
-        void this.subscribeAttribute('activatedCarbonFilterMonitoring', 'lastChangedTime', (newValue, oldValue, context) => {
+        });
+        this.subscribeAttribute('activatedCarbonFilterMonitoring', 'lastChangedTime', (newValue, oldValue, context) => {
             if (context.offline === true)
                 return;
             this.log.info(`Activated carbon filter monitoring lastChangedTime attribute changed: ${newValue}`);
-        }).catch(() => { });
+        });
     }
 }

package/dist/jestutils/jestMatterTest.js

@@ -56,10 +56,10 @@ export function getPlatformMatterbridge() {
         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',
@@ -144,8 +144,9 @@ export async function createServerNode(port, deviceType = DeviceTypeId(0x000e),
             vendorId: VendorId(0xfff1),
             vendorName: 'Matterbridge',
             productId: 0x8000,
-            productName: 'Matterbridge ' + NAME,
-            nodeLabel: NAME + 'ServerNode',
+            productName: ('Matterbridge ' + NAME).slice(0, 32),
+            productLabel: ('Label ' + NAME).slice(0, 64),
+            nodeLabel: (NAME + 'ServerNode').slice(0, 32),
             hardwareVersion: 1,
             softwareVersion: 1,
             reachable: true,

package/dist/jestutils/jestMatterbridgeEndpointSpy.d.ts

@@ -1,8 +1,9 @@
+import { MatterbridgeEndpoint } from '../matterbridgeEndpoint.js';
 export declare const setClusterMatterbridgeEndpointSpy: import("jest-mock").SpiedFunction<{
     <T extends import("@matter/node").Behavior.Type>(cluster: T, value: import("@matter/node").Behavior.StateOf<T>, log?: import("node-ansi-logger").AnsiLogger): Promise<boolean>;
-    <T extends import("@matter/types").ClusterType>(cluster: T, value: T["Typing"] extends {
+    <T extends import("@matter/types").ClusterType>(cluster: T, value: Partial<T["Typing"] extends {
         Attributes: infer Attributes;
-    } ? Attributes : {}, log?: import("node-ansi-logger").AnsiLogger): Promise<boolean>;
+    } ? Attributes : {}>, log?: import("node-ansi-logger").AnsiLogger): Promise<boolean>;
     (cluster: import("@matter/types").ClusterId | string, value: Record<string, boolean | number | bigint | string | object | undefined | null>, log?: import("node-ansi-logger").AnsiLogger): Promise<boolean>;
 }>;
 export declare const setAttributeMatterbridgeEndpointSpy: import("jest-mock").SpiedFunction<{
@@ -24,15 +25,15 @@ export declare const updateAttributeMatterbridgeEndpointSpy: import("jest-mock")
     (cluster: import("@matter/types").ClusterId | string, attribute: string, value: boolean | number | bigint | string | object | null, log?: import("node-ansi-logger").AnsiLogger): Promise<boolean>;
 }>;
 export declare const subscribeAttributeMatterbridgeEndpointSpy: import("jest-mock").SpiedFunction<{
-    <T extends import("@matter/node").Behavior.Type, A extends keyof import("@matter/node").Behavior.StateOf<T>>(cluster: T, attribute: A, listener: (newValue: import("@matter/node").Behavior.StateOf<T>[A], oldValue: import("@matter/node").Behavior.StateOf<T>[A], context: import("@matter/node").ActionContext) => void, log?: import("node-ansi-logger").AnsiLogger): Promise<boolean>;
+    <T extends import("@matter/node").Behavior.Type, A extends keyof import("@matter/node").Behavior.StateOf<T>>(cluster: T, attribute: A, listener: (newValue: import("@matter/node").Behavior.StateOf<T>[A], oldValue: import("@matter/node").Behavior.StateOf<T>[A], context: import("@matter/node").ActionContext) => void, log?: import("node-ansi-logger").AnsiLogger): MatterbridgeEndpoint;
     <T extends import("@matter/types").ClusterType, A extends keyof (T["Typing"] extends {
         Attributes: infer Attributes;
     } ? Attributes : {})>(cluster: T, attribute: A, listener: (newValue: (T["Typing"] extends {
         Attributes: infer Attributes;
     } ? Attributes : {})[A], oldValue: (T["Typing"] extends {
         Attributes: infer Attributes;
-    } ? Attributes : {})[A], context: import("@matter/node").ActionContext) => void, log?: import("node-ansi-logger").AnsiLogger): Promise<boolean>;
-    (cluster: import("@matter/types").ClusterId | string, attribute: string, listener: (newValue: any, oldValue: any, context: import("@matter/node").ActionContext) => void, log?: import("node-ansi-logger").AnsiLogger): Promise<boolean>;
+    } ? Attributes : {})[A], context: import("@matter/node").ActionContext) => void, log?: import("node-ansi-logger").AnsiLogger): MatterbridgeEndpoint;
+    (cluster: import("@matter/types").ClusterId | string, attribute: string, listener: (newValue: any, oldValue: any, context: import("@matter/node").ActionContext) => void, log?: import("node-ansi-logger").AnsiLogger): MatterbridgeEndpoint;
 }>;
 export declare const triggerEventMatterbridgeEndpointSpy: import("jest-mock").SpiedFunction<{
     <T extends import("@matter/node").Behavior.Type, E extends keyof ((T extends {

package/dist/jestutils/jestMatterbridgePlatformSpy.d.ts

@@ -1,4 +1,4 @@
-export declare const destroyMatterbridgePlatformSpy: import("jest-mock").SpiedGetter<string | boolean | import("node-ansi-logger").AnsiLogger | Promise<void> | import("../matterbridgePlatform.js").PlatformConfig | import("../matterbridgePlatform.js").PlatformMatterbridge | import("node-persist-manager").NodeStorage> | import("jest-mock").SpiedSetter<string | boolean | import("node-ansi-logger").AnsiLogger | Promise<void> | import("../matterbridgePlatform.js").PlatformConfig | import("../matterbridgePlatform.js").PlatformMatterbridge | import("node-persist-manager").NodeStorage>;
+export declare const destroyMatterbridgePlatformSpy: import("jest-mock").SpiedGetter<string | boolean | import("node-ansi-logger").AnsiLogger | import("../matterbridgePlatform.js").PlatformConfig | import("../matterbridgePlatform.js").PlatformMatterbridge | Promise<void> | import("node-persist-manager").NodeStorage> | import("jest-mock").SpiedSetter<string | boolean | import("node-ansi-logger").AnsiLogger | import("../matterbridgePlatform.js").PlatformConfig | import("../matterbridgePlatform.js").PlatformMatterbridge | Promise<void> | import("node-persist-manager").NodeStorage>;
 export declare const onStartMatterbridgePlatformSpy: import("jest-mock").SpiedFunction<(reason?: string) => Promise<void>>;
 export declare const onConfigureMatterbridgePlatformSpy: import("jest-mock").SpiedFunction<() => Promise<void>>;
 export declare const onShutdownMatterbridgePlatformSpy: import("jest-mock").SpiedFunction<(reason?: string) => Promise<void>>;
@@ -24,7 +24,7 @@ export declare const registerVirtualDeviceMatterbridgePlatformSpy: import("jest-
 export declare const registerDeviceMatterbridgePlatformSpy: import("jest-mock").SpiedFunction<(device: import("../matterbridgeEndpoint.js").MatterbridgeEndpoint) => Promise<void>>;
 export declare const unregisterDeviceMatterbridgePlatformSpy: import("jest-mock").SpiedFunction<(device: import("../matterbridgeEndpoint.js").MatterbridgeEndpoint) => Promise<void>>;
 export declare const unregisterAllDevicesMatterbridgePlatformSpy: import("jest-mock").SpiedFunction<(delay?: number) => Promise<void>>;
-export declare const saveSelectsMatterbridgePlatformSpy: import("jest-mock").SpiedGetter<string | boolean | import("node-ansi-logger").AnsiLogger | Promise<void> | import("../matterbridgePlatform.js").PlatformConfig | import("../matterbridgePlatform.js").PlatformMatterbridge | import("node-persist-manager").NodeStorage> | import("jest-mock").SpiedSetter<string | boolean | import("node-ansi-logger").AnsiLogger | Promise<void> | import("../matterbridgePlatform.js").PlatformConfig | import("../matterbridgePlatform.js").PlatformMatterbridge | import("node-persist-manager").NodeStorage>;
+export declare const saveSelectsMatterbridgePlatformSpy: import("jest-mock").SpiedGetter<string | boolean | import("node-ansi-logger").AnsiLogger | import("../matterbridgePlatform.js").PlatformConfig | import("../matterbridgePlatform.js").PlatformMatterbridge | Promise<void> | import("node-persist-manager").NodeStorage> | import("jest-mock").SpiedSetter<string | boolean | import("node-ansi-logger").AnsiLogger | import("../matterbridgePlatform.js").PlatformConfig | import("../matterbridgePlatform.js").PlatformMatterbridge | Promise<void> | import("node-persist-manager").NodeStorage>;
 export declare const clearSelectMatterbridgePlatformSpy: import("jest-mock").SpiedFunction<() => Promise<void>>;
 export declare const clearDeviceSelectMatterbridgePlatformSpy: import("jest-mock").SpiedFunction<(serial: string) => Promise<void>>;
 export declare const clearEntitySelectMatterbridgePlatformSpy: import("jest-mock").SpiedFunction<(name: string) => Promise<void>>;
@@ -56,5 +56,5 @@ export declare const getSelectEntitiesMatterbridgePlatformSpy: import("jest-mock
 export declare const verifyMatterbridgeVersionMatterbridgePlatformSpy: import("jest-mock").SpiedFunction<(requiredVersion: string, destroy?: boolean) => boolean>;
 export declare const validateDeviceMatterbridgePlatformSpy: import("jest-mock").SpiedFunction<(device: string | string[], log?: boolean) => boolean>;
 export declare const validateEntityMatterbridgePlatformSpy: import("jest-mock").SpiedFunction<(device: string, entity: string, log?: boolean) => boolean>;
-export declare const clearEndpointNumbersMatterbridgePlatformSpy: import("jest-mock").SpiedGetter<string | boolean | import("node-ansi-logger").AnsiLogger | Promise<void> | import("../matterbridgePlatform.js").PlatformConfig | import("../matterbridgePlatform.js").PlatformMatterbridge | import("node-persist-manager").NodeStorage> | import("jest-mock").SpiedSetter<string | boolean | import("node-ansi-logger").AnsiLogger | Promise<void> | import("../matterbridgePlatform.js").PlatformConfig | import("../matterbridgePlatform.js").PlatformMatterbridge | import("node-persist-manager").NodeStorage>;
-export declare const checkEndpointNumbersMatterbridgePlatformSpy: import("jest-mock").SpiedGetter<string | boolean | import("node-ansi-logger").AnsiLogger | Promise<void> | import("../matterbridgePlatform.js").PlatformConfig | import("../matterbridgePlatform.js").PlatformMatterbridge | import("node-persist-manager").NodeStorage> | import("jest-mock").SpiedSetter<string | boolean | import("node-ansi-logger").AnsiLogger | Promise<void> | import("../matterbridgePlatform.js").PlatformConfig | import("../matterbridgePlatform.js").PlatformMatterbridge | import("node-persist-manager").NodeStorage>;
+export declare const clearEndpointNumbersMatterbridgePlatformSpy: import("jest-mock").SpiedGetter<string | boolean | import("node-ansi-logger").AnsiLogger | import("../matterbridgePlatform.js").PlatformConfig | import("../matterbridgePlatform.js").PlatformMatterbridge | Promise<void> | import("node-persist-manager").NodeStorage> | import("jest-mock").SpiedSetter<string | boolean | import("node-ansi-logger").AnsiLogger | import("../matterbridgePlatform.js").PlatformConfig | import("../matterbridgePlatform.js").PlatformMatterbridge | Promise<void> | import("node-persist-manager").NodeStorage>;
+export declare const checkEndpointNumbersMatterbridgePlatformSpy: import("jest-mock").SpiedGetter<string | boolean | import("node-ansi-logger").AnsiLogger | import("../matterbridgePlatform.js").PlatformConfig | import("../matterbridgePlatform.js").PlatformMatterbridge | Promise<void> | import("node-persist-manager").NodeStorage> | import("jest-mock").SpiedSetter<string | boolean | import("node-ansi-logger").AnsiLogger | import("../matterbridgePlatform.js").PlatformConfig | import("../matterbridgePlatform.js").PlatformMatterbridge | Promise<void> | import("node-persist-manager").NodeStorage>;

package/dist/jestutils/jestMatterbridgeTest.js

@@ -109,7 +109,7 @@ export async function createMatterbridgeEnvironment() {
     matterbridge = await Matterbridge.loadInstance(false);
     expect(matterbridge).toBeDefined();
     expect(matterbridge).toBeInstanceOf(Matterbridge);
-    matterbridge.matterbridgeVersion = '3.8.0';
+    matterbridge.matterbridgeVersion = '3.8.1';
     matterbridge.bridgeMode = 'bridge';
     matterbridge.rootDirectory = path.join(HOMEDIR);
     matterbridge.homeDirectory = path.join(HOMEDIR);

package/dist/matterNode.js

@@ -13,7 +13,7 @@ import { BroadcastServer } from '@matterbridge/thread/server';
 import { dev, MATTER_LOGGER_FILE, MATTER_STORAGE_DIR, MATTERBRIDGE_LOGGER_FILE, NODE_STORAGE_DIR, plg } from '@matterbridge/types';
 import { getIntParameter, getParameter, hasParameter } from '@matterbridge/utils/cli';
 import { copyDirectory } from '@matterbridge/utils/copy-dir';
-import { inspectError } from '@matterbridge/utils/error';
+import { getErrorMessage, inspectError } from '@matterbridge/utils/error';
 import { isValidNumber, isValidString, parseVersionString } from '@matterbridge/utils/validate';
 import { wait, withTimeout } from '@matterbridge/utils/wait';
 import { AnsiLogger, BLUE, CYAN, db, debugStringify, er, nf, or, zb } from 'node-ansi-logger';
@@ -22,7 +22,6 @@ import { toBaseDevice } from './deviceManager.js';
 import { addVirtualDevice } from './helpers.js';
 import { bridge } from './matterbridgeDeviceTypes.js';
 import { PluginManager } from './pluginManager.js';
-import { getErrorMessage } from './utils/export.js';
 export class MatterNode extends EventEmitter {
     matterbridge;
     pluginName;
@@ -852,7 +851,7 @@ export class MatterNode extends EventEmitter {
         for (const sub of subscriptions) {
             if (device.hasAttributeServer(sub.cluster, sub.attribute)) {
                 this.log.debug(`Subscribing to endpoint ${plg}${plugin.name}${db}:${dev}${device.deviceName}${db}:${or}${device.id}${db}:${or}${device.number}${db} attribute ${dev}${sub.cluster}${db}.${dev}${sub.attribute}${db} changes...`);
-                await device.subscribeAttribute(sub.cluster, sub.attribute, (value) => {
+                device.subscribeAttribute(sub.cluster, sub.attribute, (value) => {
                     if (!device.plugin || !device.serialNumber || !device.uniqueId)
                         return;
                     this.log.debug(`Bridged endpoint ${plg}${plugin.name}${db}:${dev}${device.deviceName}${db}:${or}${device.id}${db}:${or}${device.number}${db} attribute ${dev}${sub.cluster}${db}.${dev}${sub.attribute}${db} changed to ${CYAN}${value}${db}`);
@@ -876,7 +875,7 @@ export class MatterNode extends EventEmitter {
             for (const child of device.getChildEndpoints()) {
                 if (child.hasAttributeServer(sub.cluster, sub.attribute)) {
                     this.log.debug(`Subscribing to child endpoint ${plg}${plugin.name}${db}:${dev}${device.deviceName}${db}:${or}${child.id}${db}:${or}${child.number}${db} attribute ${dev}${sub.cluster}${db}.${dev}${sub.attribute}${db} changes...`);
-                    await child.subscribeAttribute(sub.cluster, sub.attribute, (value) => {
+                    child.subscribeAttribute(sub.cluster, sub.attribute, (value) => {
                         if (!device.plugin || !device.serialNumber || !device.uniqueId)
                             return;
                         this.log.debug(`Bridged child endpoint ${plg}${plugin.name}${db}:${dev}${device.deviceName}${db}:${or}${child.id}${db}:${or}${child.number}${db} attribute ${dev}${sub.cluster}${db}.${dev}${sub.attribute}${db} changed to ${CYAN}${value}${db}`);

package/dist/matterbridge.js

@@ -2105,7 +2105,7 @@ export class Matterbridge extends EventEmitter {
         for (const sub of subscriptions) {
             if (device.hasAttributeServer(sub.cluster, sub.attribute)) {
                 this.log.debug(`Subscribing to endpoint ${or}${device.id}${db}:${or}${device.number}${db} attribute ${dev}${sub.cluster}${db}.${dev}${sub.attribute}${db} changes...`);
-                await device.subscribeAttribute(sub.cluster, sub.attribute, (value) => {
+                device.subscribeAttribute(sub.cluster, sub.attribute, (value) => {
                     this.log.debug(`Bridged endpoint ${or}${device.id}${db}:${or}${device.number}${db} attribute ${dev}${sub.cluster}${db}.${dev}${sub.attribute}${db} changed to ${CYAN}${isValidObject(value) ? debugStringify(value) : value}${db}`);
                     this.frontend.wssSendAttributeChangedMessage(device.plugin, device.serialNumber, device.uniqueId, device.number, device.id, sub.cluster, sub.attribute, value);
                 });
@@ -2113,7 +2113,7 @@ export class Matterbridge extends EventEmitter {
             for (const child of device.getChildEndpoints()) {
                 if (child.hasAttributeServer(sub.cluster, sub.attribute)) {
                     this.log.debug(`Subscribing to child endpoint ${or}${child.id}${db}:${or}${child.number}${db} attribute ${dev}${sub.cluster}${db}.${dev}${sub.attribute}${db} changes...`);
-                    await child.subscribeAttribute(sub.cluster, sub.attribute, (value) => {
+                    child.subscribeAttribute(sub.cluster, sub.attribute, (value) => {
                         this.log.debug(`Bridged child endpoint ${or}${child.id}${db}:${or}${child.number}${db} attribute ${dev}${sub.cluster}${db}.${dev}${sub.attribute}${db} changed to ${CYAN}${isValidObject(value) ? debugStringify(value) : value}${db}`);
                         this.frontend.wssSendAttributeChangedMessage(device.plugin, device.serialNumber, device.uniqueId, child.number, child.id, sub.cluster, sub.attribute, value);
                     });

package/dist/matterbridgeEndpoint.d.ts

@@ -96,11 +96,11 @@ export declare class MatterbridgeEndpoint extends Endpoint {
     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 ClusterAttributesOf<T>>(cluster: T, attribute: A, value: ClusterAttributesOf<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 ClusterAttributesOf<T>>(cluster: T, attribute: A, listener: (newValue: ClusterAttributesOf<T>[A], oldValue: ClusterAttributesOf<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>;
+    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): MatterbridgeEndpoint;
+    subscribeAttribute<T extends ClusterType, A extends keyof ClusterAttributesOf<T>>(cluster: T, attribute: A, listener: (newValue: ClusterAttributesOf<T>[A], oldValue: ClusterAttributesOf<T>[A], context: ActionContext) => void, log?: AnsiLogger): MatterbridgeEndpoint;
+    subscribeAttribute(cluster: ClusterId | string, attribute: string, listener: (newValue: any, oldValue: any, context: ActionContext) => void, log?: AnsiLogger): MatterbridgeEndpoint;
     setCluster<T extends Behavior.Type>(cluster: T, value: Behavior.StateOf<T>, log?: AnsiLogger): Promise<boolean>;
-    setCluster<T extends ClusterType>(cluster: T, value: ClusterAttributesOf<T>, log?: AnsiLogger): Promise<boolean>;
+    setCluster<T extends ClusterType>(cluster: T, value: Partial<ClusterAttributesOf<T>>, log?: AnsiLogger): Promise<boolean>;
     setCluster(cluster: ClusterId | string, value: Record<string, boolean | number | bigint | string | object | undefined | null>, log?: AnsiLogger): Promise<boolean>;
     getCluster<T extends Behavior.Type>(cluster: T, log?: AnsiLogger): Behavior.StateOf<T> | undefined;
     getCluster<T extends ClusterType>(cluster: T, log?: AnsiLogger): ClusterAttributesOf<T> | undefined;

package/dist/matterbridgeEndpoint.js

@@ -240,8 +240,8 @@ export class MatterbridgeEndpoint extends Endpoint {
     async updateAttribute(cluster, attribute, value, log) {
         return await updateAttribute(this, cluster, attribute, value, log);
     }
-    async subscribeAttribute(cluster, attribute, listener, log) {
-        return await subscribeAttribute(this, cluster, attribute, listener, log);
+    subscribeAttribute(cluster, attribute, listener, log) {
+        return subscribeAttribute(this, cluster, attribute, listener, log);
     }
     async setCluster(cluster, value, log) {
         return await setCluster(this, cluster, value, log);
@@ -821,28 +821,28 @@ export class MatterbridgeEndpoint extends Endpoint {
         return this;
     }
     async setWindowCoveringTargetAsCurrentAndStopped() {
-        const position = this.getAttribute(WindowCovering.Cluster.id, 'currentPositionLiftPercent100ths', this.log);
+        const position = this.getAttribute(WindowCovering, 'currentPositionLiftPercent100ths', this.log);
         if (isValidNumber(position, 0, 10000)) {
-            await this.setAttribute(WindowCovering.Cluster.id, 'targetPositionLiftPercent100ths', position, this.log);
-            await this.setAttribute(WindowCovering.Cluster.id, 'operationalStatus', {
+            await this.setAttribute(WindowCovering, 'targetPositionLiftPercent100ths', position, this.log);
+            await this.setAttribute(WindowCovering, 'operationalStatus', {
                 global: WindowCovering.MovementStatus.Stopped,
                 lift: WindowCovering.MovementStatus.Stopped,
                 tilt: WindowCovering.MovementStatus.Stopped,
             }, this.log);
         }
         this.log.debug(`Set WindowCovering currentPositionLiftPercent100ths and targetPositionLiftPercent100ths to ${position} and operationalStatus to Stopped.`);
-        if (this.hasAttributeServer(WindowCovering.Cluster.id, 'currentPositionTiltPercent100ths')) {
-            const position = this.getAttribute(WindowCovering.Cluster.id, 'currentPositionTiltPercent100ths', this.log);
+        if (this.hasAttributeServer(WindowCovering, 'currentPositionTiltPercent100ths')) {
+            const position = this.getAttribute(WindowCovering, 'currentPositionTiltPercent100ths', this.log);
             if (isValidNumber(position, 0, 10000)) {
-                await this.setAttribute(WindowCovering.Cluster.id, 'targetPositionTiltPercent100ths', position, this.log);
+                await this.setAttribute(WindowCovering, 'targetPositionTiltPercent100ths', position, this.log);
             }
             this.log.debug(`Set WindowCovering currentPositionTiltPercent100ths and targetPositionTiltPercent100ths to ${position} and operationalStatus to Stopped.`);
         }
     }
     async setWindowCoveringCurrentTargetStatus(current, target, status) {
-        await this.setAttribute(WindowCovering.Cluster.id, 'currentPositionLiftPercent100ths', current, this.log);
-        await this.setAttribute(WindowCovering.Cluster.id, 'targetPositionLiftPercent100ths', target, this.log);
-        await this.setAttribute(WindowCovering.Cluster.id, 'operationalStatus', {
+        await this.setAttribute(WindowCovering, 'currentPositionLiftPercent100ths', current, this.log);
+        await this.setAttribute(WindowCovering, 'targetPositionLiftPercent100ths', target, this.log);
+        await this.setAttribute(WindowCovering, 'operationalStatus', {
             global: status,
             lift: status,
             tilt: status,
@@ -850,7 +850,7 @@ export class MatterbridgeEndpoint extends Endpoint {
         this.log.debug(`Set WindowCovering currentPositionLiftPercent100ths: ${current}, targetPositionLiftPercent100ths: ${target} and operationalStatus: ${status}.`);
     }
     async setWindowCoveringStatus(status) {
-        await this.setAttribute(WindowCovering.Cluster.id, 'operationalStatus', {
+        await this.setAttribute(WindowCovering, 'operationalStatus', {
             global: status,
             lift: status,
             tilt: status,
@@ -858,19 +858,19 @@ export class MatterbridgeEndpoint extends Endpoint {
         this.log.debug(`Set WindowCovering operationalStatus: ${status}`);
     }
     getWindowCoveringStatus() {
-        const status = this.getAttribute(WindowCovering.Cluster.id, 'operationalStatus', this.log);
+        const status = this.getAttribute(WindowCovering, 'operationalStatus', this.log);
         if (isValidObject(status, 3) && 'global' in status && typeof status.global === 'number') {
             this.log.debug(`Get WindowCovering operationalStatus: ${status.global}`);
             return status.global;
         }
     }
     async setWindowCoveringTargetAndCurrentPosition(liftPosition, tiltPosition) {
-        await this.setAttribute(WindowCovering.Cluster.id, 'currentPositionLiftPercent100ths', liftPosition, this.log);
-        await this.setAttribute(WindowCovering.Cluster.id, 'targetPositionLiftPercent100ths', liftPosition, this.log);
+        await this.setAttribute(WindowCovering, 'currentPositionLiftPercent100ths', liftPosition, this.log);
+        await this.setAttribute(WindowCovering, 'targetPositionLiftPercent100ths', liftPosition, this.log);
         this.log.debug(`Set WindowCovering currentPositionLiftPercent100ths: ${liftPosition} and targetPositionLiftPercent100ths: ${liftPosition}.`);
-        if (tiltPosition && this.hasAttributeServer(WindowCovering.Cluster.id, 'currentPositionTiltPercent100ths')) {
-            await this.setAttribute(WindowCovering.Cluster.id, 'currentPositionTiltPercent100ths', tiltPosition, this.log);
-            await this.setAttribute(WindowCovering.Cluster.id, 'targetPositionTiltPercent100ths', tiltPosition, this.log);
+        if (tiltPosition && this.hasAttributeServer(WindowCovering, 'currentPositionTiltPercent100ths')) {
+            await this.setAttribute(WindowCovering, 'currentPositionTiltPercent100ths', tiltPosition, this.log);
+            await this.setAttribute(WindowCovering, 'targetPositionTiltPercent100ths', tiltPosition, this.log);
             this.log.debug(`Set WindowCovering currentPositionTiltPercent100ths: ${tiltPosition} and targetPositionTiltPercent100ths: ${tiltPosition}.`);
         }
     }

package/dist/matterbridgeEndpointHelpers.d.ts

@@ -56,7 +56,7 @@ export declare function getAttributeId(endpoint: Endpoint, cluster: string, attr
 export declare function getAttribute(endpoint: MatterbridgeEndpoint, cluster: Behavior.Type | ClusterType | ClusterId | string, attribute: string, log?: AnsiLogger): any;
 export declare function setAttribute(endpoint: MatterbridgeEndpoint, cluster: Behavior.Type | ClusterType | ClusterId | string, attribute: string, value: boolean | number | bigint | string | object | null, log?: AnsiLogger): Promise<boolean>;
 export declare function updateAttribute(endpoint: MatterbridgeEndpoint, cluster: Behavior.Type | ClusterType | ClusterId | string, attribute: string, value: boolean | number | bigint | string | object | null, log?: AnsiLogger): Promise<boolean>;
-export declare function subscribeAttribute(endpoint: MatterbridgeEndpoint, cluster: Behavior.Type | ClusterType | ClusterId | string, attribute: string, listener: (newValue: any, oldValue: any, context: ActionContext) => void, log?: AnsiLogger): Promise<boolean>;
+export declare function subscribeAttribute(endpoint: MatterbridgeEndpoint, cluster: Behavior.Type | ClusterType | ClusterId | string, attribute: string, listener: (newValue: any, oldValue: any, context: ActionContext) => void, log?: AnsiLogger): MatterbridgeEndpoint;
 export declare function setCluster(endpoint: MatterbridgeEndpoint, cluster: Behavior.Type | ClusterType | ClusterId | string, value: Record<string, boolean | number | bigint | string | object | undefined | null>, log?: AnsiLogger): Promise<boolean>;
 export declare function getCluster(endpoint: MatterbridgeEndpoint, cluster: Behavior.Type | ClusterType | ClusterId | string, log?: AnsiLogger): Record<string, boolean | number | bigint | string | object | undefined | null> | undefined;
 export declare function triggerEvent(endpoint: MatterbridgeEndpoint, cluster: Behavior.Type | ClusterType | ClusterId | string, event: string, payload: Record<string, boolean | number | bigint | string | object | undefined | null>, log?: AnsiLogger): Promise<boolean>;

package/dist/matterbridgeEndpointHelpers.js

@@ -719,25 +719,21 @@ export async function updateAttribute(endpoint, cluster, attribute, value, log)
         `to ${YELLOW}${value !== null && typeof value === 'object' ? debugStringify(value) : value}${db}`);
     return true;
 }
-export async function subscribeAttribute(endpoint, cluster, attribute, listener, log) {
+export function subscribeAttribute(endpoint, cluster, attribute, listener, log) {
     const clusterName = getBehavior(endpoint, cluster)?.id;
     if (!clusterName) {
         endpoint.log.error(`subscribeAttribute ${hk}${attribute}${er} error: cluster not found on endpoint ${or}${endpoint.maybeId}${er}:${or}${endpoint.maybeNumber}${er}`);
-        return false;
-    }
-    if (endpoint.construction.status !== Lifecycle.Status.Active) {
-        endpoint.log.debug(`subscribeAttribute ${hk}${clusterName}.${attribute}${db}: Endpoint ${or}${endpoint.maybeId}${db}:${or}${endpoint.maybeNumber}${db} is in the ${BLUE}${endpoint.construction.status}${db} state`);
-        await endpoint.construction.ready;
+        return endpoint;
     }
     const events = endpoint.events;
     attribute = lowercaseFirstLetter(attribute) + '$Changed';
     if (!(clusterName in events) || !(attribute in events[clusterName])) {
         endpoint.log.error(`subscribeAttribute error: Attribute ${hk}${attribute.replace('$Changed', '')}${er} not found on Cluster ${'0x' + getClusterId(endpoint, clusterName)?.toString(16).padStart(4, '0')}:${clusterName} on endpoint ${or}${endpoint.maybeId}${er}:${or}${endpoint.maybeNumber}${er}`);
-        return false;
+        return endpoint;
     }
     events[clusterName][attribute].on(listener);
-    log?.info(`${db}Subscribed endpoint ${or}${endpoint.id}${db}:${or}${endpoint.number}${db} attribute ${hk}${capitalizeFirstLetter(clusterName)}${db}.${hk}${attribute}${db}`);
-    return true;
+    log?.info(`${db}Subscribed endpoint ${or}${endpoint.maybeId}${db}:${or}${endpoint.maybeNumber}${db} attribute ${hk}${capitalizeFirstLetter(clusterName)}${db}.${hk}${attribute}${db}`);
+    return endpoint;
 }
 export async function setCluster(endpoint, cluster, value, log) {
     const clusterName = getBehavior(endpoint, cluster)?.id;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@matterbridge/core",
-  "version": "3.8.0",
+  "version": "3.8.1-dev-20260607-08cd4da",
   "description": "Matterbridge core library",
   "author": "https://github.com/Luligu",
   "homepage": "https://matterbridge.io/",
@@ -130,10 +130,10 @@
   ],
   "dependencies": {
     "@matter/main": "0.17.1",
-    "@matterbridge/dgram": "3.8.0",
-    "@matterbridge/thread": "3.8.0",
-    "@matterbridge/types": "3.8.0",
-    "@matterbridge/utils": "3.8.0",
+    "@matterbridge/dgram": "3.8.1-dev-20260607-08cd4da",
+    "@matterbridge/thread": "3.8.1-dev-20260607-08cd4da",
+    "@matterbridge/types": "3.8.1-dev-20260607-08cd4da",
+    "@matterbridge/utils": "3.8.1-dev-20260607-08cd4da",
     "escape-html": "1.0.3",
     "express": "5.2.1",
     "express-rate-limit": "8.5.2",