@matterbridge/core 3.6.0-dev-20260305-776ca2f → 3.6.0-dev-20260306-2d4caeb

package/dist/devices/irrigationSystem.js

@@ -2,6 +2,7 @@ import { LocationTag } from '@matter/main/node';
 import { OperationalState } from '@matter/types/clusters/operational-state';
 import { irrigationSystem, powerSource, waterValve } from '../matterbridgeDeviceTypes.js';
 import { MatterbridgeEndpoint } from '../matterbridgeEndpoint.js';
+import { getSemtag } from '../matterbridgeEndpointHelpers.js';
 export class IrrigationSystem extends MatterbridgeEndpoint {
     constructor(name, serial, options = {}) {
         const deviceTypes = options.singleZone ? [irrigationSystem, waterValve, powerSource] : [irrigationSystem, powerSource];
@@ -23,7 +24,7 @@ export class IrrigationSystem extends MatterbridgeEndpoint {
         this.addRequiredClusterServers();
     }
     addZone(tag) {
-        this.addChildDeviceType(`Zone ${tag.tag}`, waterValve, { tagList: [tag, LocationTag.Zone] })
+        this.addChildDeviceType(`Zone ${tag.tag}`, waterValve, { tagList: [getSemtag(tag), getSemtag(LocationTag.Zone)] })
             .createDefaultValveConfigurationAndControlClusterServer()
             .addRequiredClusterServers();
         return this;

package/dist/matterbridgeEndpoint.d.ts

@@ -62,6 +62,8 @@ export declare class MatterbridgeEndpoint extends Endpoint {
     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>;
+    setCluster(cluster: Behavior.Type | ClusterType | ClusterId | string, value: Record<string, boolean | number | bigint | string | object | undefined | null>, log?: AnsiLogger): Promise<boolean>;
+    getCluster(cluster: Behavior.Type | ClusterType | ClusterId | string, log?: AnsiLogger): Record<string, boolean | number | bigint | string | object | undefined | null> | undefined;
     triggerEvent(cluster: Behavior.Type | ClusterType | ClusterId | string, event: string, payload: Record<string, boolean | number | bigint | string | object | undefined | null>, log?: AnsiLogger): Promise<boolean>;
     addClusterServers(serverList: ClusterId[]): this;
     addFixedLabel(label: string, value: string): Promise<this>;

package/dist/matterbridgeEndpoint.js

@@ -62,7 +62,7 @@ import { VendorId } from '@matter/types/datatype';
 import { inspectError, isValidNumber, isValidObject, isValidString } from '@matterbridge/utils';
 import { AnsiLogger, CYAN, db, debugStringify, hk, or, YELLOW, zb } from 'node-ansi-logger';
 import { MatterbridgeActivatedCarbonFilterMonitoringServer, MatterbridgeBooleanStateConfigurationServer, MatterbridgeColorControlServer, MatterbridgeDeviceEnergyManagementModeServer, MatterbridgeDeviceEnergyManagementServer, MatterbridgeDoorLockServer, MatterbridgeEnhancedColorControlServer, MatterbridgeFanControlServer, MatterbridgeHepaFilterMonitoringServer, MatterbridgeIdentifyServer, MatterbridgeLevelControlServer, MatterbridgeLiftTiltWindowCoveringServer, MatterbridgeLiftWindowCoveringServer, MatterbridgeModeSelectServer, MatterbridgeOnOffServer, MatterbridgeOperationalStateServer, MatterbridgePowerSourceServer, MatterbridgePresetThermostatServer, MatterbridgeServer, MatterbridgeSmokeCoAlarmServer, MatterbridgeSwitchServer, MatterbridgeThermostatServer, MatterbridgeValveConfigurationAndControlServer, } from './matterbridgeBehaviors.js';
-import { addClusterServers, addFixedLabel, addOptionalClusterServers, addRequiredClusterServers, addUserLabel, checkNotLatinCharacters, createUniqueId, featuresFor, generateUniqueId, getApparentElectricalPowerMeasurementClusterServer, getAttribute, getAttributeId, getBehavior, getBehaviourTypesFromClusterClientIds, getBehaviourTypesFromClusterServerIds, getClusterId, getDefaultDeviceEnergyManagementClusterServer, getDefaultDeviceEnergyManagementModeClusterServer, getDefaultElectricalEnergyMeasurementClusterServer, getDefaultElectricalPowerMeasurementClusterServer, getDefaultFlowMeasurementClusterServer, getDefaultIlluminanceMeasurementClusterServer, getDefaultOccupancySensingClusterServer, getDefaultOperationalStateClusterServer, getDefaultPowerSourceBatteryClusterServer, getDefaultPowerSourceRechargeableBatteryClusterServer, getDefaultPowerSourceReplaceableBatteryClusterServer, getDefaultPowerSourceWiredClusterServer, getDefaultPressureMeasurementClusterServer, getDefaultRelativeHumidityMeasurementClusterServer, getDefaultTemperatureMeasurementClusterServer, invokeBehaviorCommand, lowercaseFirstLetter, setAttribute, subscribeAttribute, triggerEvent, updateAttribute, } from './matterbridgeEndpointHelpers.js';
+import { addClusterServers, addFixedLabel, addOptionalClusterServers, addRequiredClusterServers, addUserLabel, checkNotLatinCharacters, createUniqueId, featuresFor, generateUniqueId, getApparentElectricalPowerMeasurementClusterServer, getAttribute, getAttributeId, getBehavior, getBehaviourTypesFromClusterClientIds, getBehaviourTypesFromClusterServerIds, getCluster, getClusterId, getDefaultDeviceEnergyManagementClusterServer, getDefaultDeviceEnergyManagementModeClusterServer, getDefaultElectricalEnergyMeasurementClusterServer, getDefaultElectricalPowerMeasurementClusterServer, getDefaultFlowMeasurementClusterServer, getDefaultIlluminanceMeasurementClusterServer, getDefaultOccupancySensingClusterServer, getDefaultOperationalStateClusterServer, getDefaultPowerSourceBatteryClusterServer, getDefaultPowerSourceRechargeableBatteryClusterServer, getDefaultPowerSourceReplaceableBatteryClusterServer, getDefaultPowerSourceWiredClusterServer, getDefaultPressureMeasurementClusterServer, getDefaultRelativeHumidityMeasurementClusterServer, getDefaultTemperatureMeasurementClusterServer, invokeBehaviorCommand, lowercaseFirstLetter, setAttribute, setCluster, subscribeAttribute, triggerEvent, updateAttribute, } from './matterbridgeEndpointHelpers.js';
 const MATTERBRIDGE_ENDPOINT_BRAND = Symbol('MatterbridgeEndpoint.brand');
 export function isMatterbridgeEndpoint(value) {
     if (!value || typeof value !== 'object')
@@ -211,6 +211,12 @@ export class MatterbridgeEndpoint extends Endpoint {
     async subscribeAttribute(cluster, attribute, listener, log) {
         return await subscribeAttribute(this, cluster, attribute, listener, log);
     }
+    async setCluster(cluster, value, log) {
+        return await setCluster(this, cluster, value, log);
+    }
+    getCluster(cluster, log) {
+        return getCluster(this, cluster, log);
+    }
     async triggerEvent(cluster, event, payload, log) {
         return await triggerEvent(this, cluster, event, payload, log);
     }

package/dist/matterbridgeEndpointHelpers.d.ts

@@ -15,7 +15,7 @@ import { PowerSource } from '@matter/types/clusters/power-source';
 import { PressureMeasurement } from '@matter/types/clusters/pressure-measurement';
 import { RelativeHumidityMeasurement } from '@matter/types/clusters/relative-humidity-measurement';
 import { TemperatureMeasurement } from '@matter/types/clusters/temperature-measurement';
-import { ClusterId } from '@matter/types/datatype';
+import { ClusterId, VendorId } from '@matter/types/datatype';
 import { MeasurementType, Semtag } from '@matter/types/globals';
 import { AnsiLogger } from 'node-ansi-logger';
 import { MatterbridgeDeviceEnergyManagementModeServer, MatterbridgeDeviceEnergyManagementServer, MatterbridgeOperationalStateServer, MatterbridgePowerSourceServer } from './matterbridgeBehaviors.js';
@@ -26,7 +26,7 @@ export declare function lowercaseFirstLetter(name: string): string;
 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;
-export declare function getSemtag(semtag: Semtag, label?: Semtag['label'], mfgCode?: Semtag['mfgCode']): Semtag;
+export declare function getSemtag(semtag: Semtag, label?: string | null | undefined, mfgCode?: VendorId | null): Semtag;
 export declare function featuresFor(endpoint: MatterbridgeEndpoint, cluster: Behavior.Type | ClusterType | ClusterId | string): Record<string, boolean | undefined>;
 export declare function getBehaviourTypesFromClusterServerIds(clusterServerList: ClusterId[]): Behavior.Type[];
 export declare function getBehaviourTypesFromClusterClientIds(clusterClientList: ClusterId[]): Behavior.Type[];
@@ -47,6 +47,8 @@ export declare function getAttribute(endpoint: MatterbridgeEndpoint, cluster: Be
 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 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>;
 export declare function getDefaultPowerSourceWiredClusterServer(wiredCurrentType?: PowerSource.WiredCurrentType): Partial<import("@matter/node").ClusterState.Type<import("@matter/types/cluster").ClusterComposer.WithFeatures<ClusterType.Of<{
     readonly id: 47;

package/dist/matterbridgeEndpointHelpers.js

@@ -113,9 +113,11 @@ export function createUniqueId(param1, param2, param3, param4) {
     hash.update(param1 + param2 + param3 + param4);
     return hash.digest('hex');
 }
-export function getSemtag(semtag, label = null, mfgCode = null) {
-    if (label !== null && typeof label === 'string')
+export function getSemtag(semtag, label = undefined, mfgCode = null) {
+    if (label !== undefined && label !== null && typeof label === 'string')
         label = label.trim().slice(0, 64);
+    if (label === undefined)
+        return { mfgCode, namespaceId: semtag.namespaceId, tag: semtag.tag };
     return { mfgCode, namespaceId: semtag.namespaceId, tag: semtag.tag, label };
 }
 export function featuresFor(endpoint, cluster) {
@@ -538,6 +540,35 @@ export async function subscribeAttribute(endpoint, cluster, attribute, listener,
     log?.info(`${db}Subscribed endpoint ${or}${endpoint.id}${db}:${or}${endpoint.number}${db} attribute ${hk}${capitalizeFirstLetter(clusterName)}${db}.${hk}${attribute}${db}`);
     return true;
 }
+export async function setCluster(endpoint, cluster, value, log) {
+    const clusterName = getBehavior(endpoint, cluster)?.id;
+    if (!clusterName) {
+        endpoint.log.error(`setCluster 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.error(`setCluster ${hk}${capitalizeFirstLetter(clusterName)}${er} error: Endpoint ${or}${endpoint.maybeId}${er}:${or}${endpoint.maybeNumber}${er} is in the ${BLUE}${endpoint.construction.status}${er} state`);
+        return false;
+    }
+    await endpoint.setStateOf(endpoint.behaviors.supported[clusterName], value);
+    log?.info(`${db}Set endpoint ${or}${endpoint.id}${db}:${or}${endpoint.number}${db} cluster ${hk}${capitalizeFirstLetter(clusterName)}${db} to ${debugStringify(value)}`);
+    return true;
+}
+export function getCluster(endpoint, cluster, log) {
+    const clusterName = getBehavior(endpoint, cluster)?.id;
+    if (!clusterName) {
+        endpoint.log.error(`getCluster error: cluster not found on endpoint ${or}${endpoint.maybeId}${er}:${or}${endpoint.maybeNumber}${er}`);
+        return undefined;
+    }
+    if (endpoint.construction.status !== Lifecycle.Status.Active) {
+        endpoint.log.error(`getCluster ${hk}${capitalizeFirstLetter(clusterName)}${er} error: Endpoint ${or}${endpoint.maybeId}${er}:${or}${endpoint.maybeNumber}${er} is in the ${BLUE}${endpoint.construction.status}${er} state`);
+        return undefined;
+    }
+    const state = endpoint.state;
+    const value = deepCopy(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;
+}
 export async function triggerEvent(endpoint, cluster, event, payload, log) {
     const clusterName = getBehavior(endpoint, cluster)?.id;
     if (!clusterName) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@matterbridge/core",
-  "version": "3.6.0-dev-20260305-776ca2f",
+  "version": "3.6.0-dev-20260306-2d4caeb",
   "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.0-dev-20260305-776ca2f",
-    "@matterbridge/thread": "3.6.0-dev-20260305-776ca2f",
-    "@matterbridge/types": "3.6.0-dev-20260305-776ca2f",
-    "@matterbridge/utils": "3.6.0-dev-20260305-776ca2f",
+    "@matterbridge/dgram": "3.6.0-dev-20260306-2d4caeb",
+    "@matterbridge/thread": "3.6.0-dev-20260306-2d4caeb",
+    "@matterbridge/types": "3.6.0-dev-20260306-2d4caeb",
+    "@matterbridge/utils": "3.6.0-dev-20260306-2d4caeb",
     "archiver": "7.0.1",
     "express": "5.2.1",
     "glob": "13.0.6",