@matter/node 0.17.4 → 0.17.5-alpha.0-20260702-a2cd6f764

package/src/devices/temperature-controlled-cabinet.ts

@@ -19,6 +19,9 @@ import { OvenModeServer as BaseOvenModeServer } from "../behaviors/oven-mode/Ove
 import {
     OvenCavityOperationalStateServer as BaseOvenCavityOperationalStateServer
 } from "../behaviors/oven-cavity-operational-state/OvenCavityOperationalStateServer.js";
+import {
+    TemperatureAlarmServer as BaseTemperatureAlarmServer
+} from "../behaviors/temperature-alarm/TemperatureAlarmServer.js";
 import { MutableEndpoint } from "../endpoint/type/MutableEndpoint.js";
 import { SupportedBehaviors } from "../endpoint/properties/SupportedBehaviors.js";
 import { Identity } from "@matter/general";
@@ -33,7 +36,7 @@ import { Identity } from "@matter/general";
  * because you must select the features your device supports. You can add manually using
  * TemperatureControlledCabinetDevice.with().
  *
- * @see {@link MatterSpecification.v151.Device} § 13.4
+ * @see {@link MatterSpecification.v16.Device} § 13.4
  */
 export interface TemperatureControlledCabinetDevice extends Identity<typeof TemperatureControlledCabinetDeviceDefinition> {}
 
@@ -75,6 +78,13 @@ export namespace TemperatureControlledCabinetRequirements {
     export const OvenCavityOperationalStateServer = BaseOvenCavityOperationalStateServer
         .alter({ events: { operationCompletion: { optional: false } } });
 
+    /**
+     * The TemperatureAlarm cluster is optional per the Matter specification.
+     *
+     * We provide this alias to the default implementation {@link TemperatureAlarmServer} for convenience.
+     */
+    export const TemperatureAlarmServer = BaseTemperatureAlarmServer;
+
     /**
      * An implementation for each server cluster supported by the endpoint per the Matter specification.
      */
@@ -85,7 +95,8 @@ export namespace TemperatureControlledCabinetRequirements {
             TemperatureMeasurement: TemperatureMeasurementServer,
             RefrigeratorAndTemperatureControlledCabinetMode: RefrigeratorAndTemperatureControlledCabinetModeServer,
             OvenMode: OvenModeServer,
-            OvenCavityOperationalState: OvenCavityOperationalStateServer
+            OvenCavityOperationalState: OvenCavityOperationalStateServer,
+            TemperatureAlarm: TemperatureAlarmServer
         }
     };
 }
@@ -93,7 +104,7 @@ export namespace TemperatureControlledCabinetRequirements {
 export const TemperatureControlledCabinetDeviceDefinition = MutableEndpoint({
     name: "TemperatureControlledCabinet",
     deviceType: 0x71,
-    deviceRevision: 5,
+    deviceRevision: 6,
     requirements: TemperatureControlledCabinetRequirements,
     behaviors: SupportedBehaviors()
 });

package/src/devices/temperature-sensor.ts

@@ -20,7 +20,7 @@ import { Identity } from "@matter/general";
 /**
  * A Temperature Sensor device reports measurements of temperature.
  *
- * @see {@link MatterSpecification.v151.Device} § 7.4
+ * @see {@link MatterSpecification.v16.Device} § 7.4
  */
 export interface TemperatureSensorDevice extends Identity<typeof TemperatureSensorDeviceDefinition> {}
 

package/src/devices/thermostat-controller.ts

@@ -19,7 +19,7 @@ import { Identity } from "@matter/general";
 /**
  * A Thermostat Controller is a device capable of controlling a Thermostat.
  *
- * @see {@link MatterSpecification.v151.Device} § 9.4
+ * @see {@link MatterSpecification.v16.Device} § 9.4
  */
 export interface ThermostatControllerDevice extends Identity<typeof ThermostatControllerDeviceDefinition> {}
 

package/src/devices/thermostat.ts

@@ -25,6 +25,9 @@ import {
 import {
     OccupancySensingClient as BaseOccupancySensingClient
 } from "../behaviors/occupancy-sensing/OccupancySensingClient.js";
+import {
+    AmbientContextSensingClient as BaseAmbientContextSensingClient
+} from "../behaviors/ambient-context-sensing/AmbientContextSensingClient.js";
 import { MutableEndpoint } from "../endpoint/type/MutableEndpoint.js";
 import { SupportedBehaviors } from "../endpoint/properties/SupportedBehaviors.js";
 import { Identity } from "@matter/general";
@@ -38,7 +41,7 @@ import { Identity } from "@matter/general";
  * ThermostatDevice requires Thermostat cluster but Thermostat is not added by default because you must select the
  * features your device supports. You can add manually using ThermostatDevice.with().
  *
- * @see {@link MatterSpecification.v151.Device} § 9.1
+ * @see {@link MatterSpecification.v16.Device} § 9.1
  */
 export interface ThermostatDevice extends Identity<typeof ThermostatDeviceDefinition> {}
 
@@ -107,6 +110,13 @@ export namespace ThermostatRequirements {
      */
     export const OccupancySensingClient = BaseOccupancySensingClient;
 
+    /**
+     * The AmbientContextSensing cluster is optional per the Matter specification.
+     *
+     * We provide this alias to the default implementation {@link AmbientContextSensingClient} for convenience.
+     */
+    export const AmbientContextSensingClient = BaseAmbientContextSensingClient;
+
     /**
      * An implementation for each server cluster supported by the endpoint per the Matter specification.
      */
@@ -127,7 +137,8 @@ export namespace ThermostatRequirements {
             FanControl: FanControlClient,
             TemperatureMeasurement: TemperatureMeasurementClient,
             RelativeHumidityMeasurement: RelativeHumidityMeasurementClient,
-            OccupancySensing: OccupancySensingClient
+            OccupancySensing: OccupancySensingClient,
+            AmbientContextSensing: AmbientContextSensingClient
         },
 
         mandatory: {}
@@ -137,7 +148,7 @@ export namespace ThermostatRequirements {
 export const ThermostatDeviceDefinition = MutableEndpoint({
     name: "Thermostat",
     deviceType: 0x301,
-    deviceRevision: 5,
+    deviceRevision: 6,
     requirements: ThermostatRequirements,
     behaviors: SupportedBehaviors(ThermostatRequirements.server.mandatory.Identify)
 });

package/src/devices/thread-border-router.ts

@@ -29,7 +29,7 @@ import { Identity } from "@matter/general";
  * The necessary hardware and software prerequisites are detailed within the clusters that are mandated by this device
  * type.
  *
- * @see {@link MatterSpecification.v151.Device} § 15.4
+ * @see {@link MatterSpecification.v16.Device} § 15.4
  */
 export interface ThreadBorderRouterDevice extends Identity<typeof ThreadBorderRouterDeviceDefinition> {}
 

package/src/devices/video-doorbell.ts

@@ -14,7 +14,7 @@ import { Identity } from "@matter/general";
  * A Video Doorbell device is a composite device which combines a camera and a switch to provide a doorbell with Video
  * and Audio streaming.
  *
- * @see {@link MatterSpecification.v151.Device} § 16.3
+ * @see {@link MatterSpecification.v16.Device} § 16.3
  */
 export interface VideoDoorbellDevice extends Identity<typeof VideoDoorbellDeviceDefinition> {}
 

package/src/devices/video-remote-control.ts

@@ -32,7 +32,7 @@ import { Identity } from "@matter/general";
  * A Video Remote Control is a client that can control a Video Player, for example, a traditional universal remote
  * control.
  *
- * @see {@link MatterSpecification.v151.Device} § 10.7
+ * @see {@link MatterSpecification.v16.Device} § 10.7
  */
 export interface VideoRemoteControlDevice extends Identity<typeof VideoRemoteControlDeviceDefinition> {}
 

package/src/devices/water-freeze-detector.ts

@@ -18,7 +18,7 @@ import { Identity } from "@matter/general";
 /**
  * This defines conformance to the Water Freeze Detector device type.
  *
- * @see {@link MatterSpecification.v151.Device} § 7.11
+ * @see {@link MatterSpecification.v16.Device} § 7.11
  */
 export interface WaterFreezeDetectorDevice extends Identity<typeof WaterFreezeDetectorDeviceDefinition> {}
 
@@ -56,7 +56,7 @@ export namespace WaterFreezeDetectorRequirements {
 export const WaterFreezeDetectorDeviceDefinition = MutableEndpoint({
     name: "WaterFreezeDetector",
     deviceType: 0x41,
-    deviceRevision: 1,
+    deviceRevision: 2,
     requirements: WaterFreezeDetectorRequirements,
     behaviors: SupportedBehaviors(
         WaterFreezeDetectorRequirements.server.mandatory.Identify,

package/src/devices/water-heater.ts

@@ -24,7 +24,7 @@ import { Identity } from "@matter/general";
  * WaterHeaterDevice requires Thermostat cluster but Thermostat is not added by default because you must select the
  * features your device supports. You can add manually using WaterHeaterDevice.with().
  *
- * @see {@link MatterSpecification.v151.Device} § 14.2
+ * @see {@link MatterSpecification.v16.Device} § 14.2
  */
 export interface WaterHeaterDevice extends Identity<typeof WaterHeaterDeviceDefinition> {}
 

package/src/devices/water-leak-detector.ts

@@ -18,7 +18,7 @@ import { Identity } from "@matter/general";
 /**
  * This defines conformance to the Water Leak Detector device type.
  *
- * @see {@link MatterSpecification.v151.Device} § 7.12
+ * @see {@link MatterSpecification.v16.Device} § 7.12
  */
 export interface WaterLeakDetectorDevice extends Identity<typeof WaterLeakDetectorDeviceDefinition> {}
 
@@ -56,7 +56,7 @@ export namespace WaterLeakDetectorRequirements {
 export const WaterLeakDetectorDeviceDefinition = MutableEndpoint({
     name: "WaterLeakDetector",
     deviceType: 0x43,
-    deviceRevision: 1,
+    deviceRevision: 2,
     requirements: WaterLeakDetectorRequirements,
     behaviors: SupportedBehaviors(
         WaterLeakDetectorRequirements.server.mandatory.Identify,

package/src/devices/water-valve.ts

@@ -19,7 +19,7 @@ import { Identity } from "@matter/general";
 /**
  * This defines conformance to the Water Valve device type.
  *
- * @see {@link MatterSpecification.v151.Device} § 5.6
+ * @see {@link MatterSpecification.v16.Device} § 5.6
  */
 export interface WaterValveDevice extends Identity<typeof WaterValveDeviceDefinition> {}
 

package/src/devices/window-covering-controller.ts

@@ -17,7 +17,7 @@ import { Identity } from "@matter/general";
 /**
  * A Window Covering Controller is a device that controls an automatic window covering.
  *
- * @see {@link MatterSpecification.v151.Device} § 8.4
+ * @see {@link MatterSpecification.v16.Device} § 8.4
  */
 export interface WindowCoveringControllerDevice extends Identity<typeof WindowCoveringControllerDeviceDefinition> {}
 

package/src/devices/window-covering.ts

@@ -19,7 +19,7 @@ import { Identity } from "@matter/general";
  * WindowCoveringDevice requires WindowCovering cluster but WindowCovering is not added by default because you must
  * select the features your device supports. You can add manually using WindowCoveringDevice.with().
  *
- * @see {@link MatterSpecification.v151.Device} § 8.3
+ * @see {@link MatterSpecification.v16.Device} § 8.3
  */
 export interface WindowCoveringDevice extends Identity<typeof WindowCoveringDeviceDefinition> {}
 

package/src/endpoint/properties/EndpointLifecycle.ts

@@ -30,6 +30,7 @@ export class EndpointLifecycle {
         this.emitError("changed", error),
     );
     #reset = AsyncObservable<[]>();
+    #configurationVersionChanged = Observable<[]>(error => this.emitError("configurationVersionChanged", error));
     #queuedUpdates?: Array<EndpointLifecycle.Change>;
 
     /**
@@ -88,6 +89,14 @@ export class EndpointLifecycle {
         return this.#reset;
     }
 
+    /**
+     * Emitted when the endpoint's `ConfigurationVersion` changes — from `BasicInformation` on a node's root endpoint or
+     * `BridgedDeviceBasicInformation` on a bridged endpoint. Wired for client peers by {@link Peers}.
+     */
+    get configurationVersionChanged() {
+        return this.#configurationVersionChanged;
+    }
+
     /**
      * Is the {@link Endpoint} installed in a {@link Node}?
      */

package/src/endpoints/aggregator.ts

@@ -28,7 +28,7 @@ import { Identity } from "@matter/general";
  * When using this device type as a collection of bridged nodes, please see the "Bridge" section in the System Model
  * specification.
  *
- * @see {@link MatterSpecification.v151.Device} § 11.2
+ * @see {@link MatterSpecification.v16.Device} § 11.2
  */
 export interface AggregatorEndpoint extends Identity<typeof AggregatorEndpointDefinition> {}
 

package/src/endpoints/bridged-node.ts

@@ -31,7 +31,7 @@ import { Identity } from "@matter/general";
  * describes itself and any other endpoints that make up the Bridged Node. A Bridged Node endpoint represents a device
  * on a foreign network, but is not the root endpoint of the bridge itself.
  *
- * @see {@link MatterSpecification.v151.Device} § 2.5
+ * @see {@link MatterSpecification.v16.Device} § 2.5
  */
 export interface BridgedNodeEndpoint extends Identity<typeof BridgedNodeEndpointDefinition> {}
 

package/src/endpoints/device-energy-management.ts

@@ -28,7 +28,7 @@ import { Identity } from "@matter/general";
  * default because you must select the features your device supports. You can add manually using
  * DeviceEnergyManagementEndpoint.with().
  *
- * @see {@link MatterSpecification.v151.Device} § 2.7
+ * @see {@link MatterSpecification.v16.Device} § 2.7
  */
 export interface DeviceEnergyManagementEndpoint extends Identity<typeof DeviceEnergyManagementEndpointDefinition> {}
 

package/src/endpoints/electrical-sensor.ts

@@ -24,7 +24,7 @@ import { Identity } from "@matter/general";
  * ElectricalSensorEndpoint requires PowerTopology cluster but PowerTopology is not added by default because you must
  * select the features your device supports. You can add manually using ElectricalSensorEndpoint.with().
  *
- * @see {@link MatterSpecification.v151.Device} § 2.6
+ * @see {@link MatterSpecification.v16.Device} § 2.6
  */
 export interface ElectricalSensorEndpoint extends Identity<typeof ElectricalSensorEndpointDefinition> {}
 

package/src/endpoints/joint-fabric-administrator.ts

@@ -25,7 +25,7 @@ import { Identity } from "@matter/general";
  * (as specified in the Matter core specification) to be commissioned onto the Joint Fabric. Once commissioned, a client
  * may access the capabilities of the Joint Fabric Administrator.
  *
- * @see {@link MatterSpecification.v151.Device} § 2.9
+ * @see {@link MatterSpecification.v16.Device} § 2.9
  */
 export interface JointFabricAdministratorEndpoint extends Identity<typeof JointFabricAdministratorEndpointDefinition> {}
 

package/src/endpoints/ota-provider.ts

@@ -20,7 +20,7 @@ import { Identity } from "@matter/general";
 /**
  * An OTA Provider is a node that is capable of providing an OTA software update to other nodes on the same fabric.
  *
- * @see {@link MatterSpecification.v151.Device} § 2.4
+ * @see {@link MatterSpecification.v16.Device} § 2.4
  */
 export interface OtaProviderEndpoint extends Identity<typeof OtaProviderEndpointDefinition> {}
 

package/src/endpoints/ota-requestor.ts

@@ -20,7 +20,7 @@ import { Identity } from "@matter/general";
 /**
  * An OTA Requestor is a device that is capable of receiving an OTA software update.
  *
- * @see {@link MatterSpecification.v151.Device} § 2.3
+ * @see {@link MatterSpecification.v16.Device} § 2.3
  */
 export interface OtaRequestorEndpoint extends Identity<typeof OtaRequestorEndpointDefinition> {}
 

package/src/endpoints/power-source.ts

@@ -18,7 +18,7 @@ import { Identity } from "@matter/general";
  * PowerSourceEndpoint requires PowerSource cluster but PowerSource is not added by default because you must select the
  * features your device supports. You can add manually using PowerSourceEndpoint.with().
  *
- * @see {@link MatterSpecification.v151.Device} § 2.2
+ * @see {@link MatterSpecification.v16.Device} § 2.2
  */
 export interface PowerSourceEndpoint extends Identity<typeof PowerSourceEndpointDefinition> {}
 

package/src/endpoints/root.ts

@@ -83,7 +83,7 @@ import { Identity } from "@matter/general";
  *
  *   - Other device types with Node scope may be supported on the same endpoint as this device type.
  *
- * @see {@link MatterSpecification.v151.Device} § 2.1
+ * @see {@link MatterSpecification.v16.Device} § 2.1
  */
 export interface RootEndpoint extends Identity<typeof RootEndpointDefinition> {}
 

package/src/endpoints/secondary-network-interface.ts

@@ -35,7 +35,7 @@ import { Identity } from "@matter/general";
  * default because you must select the features your device supports. You can add manually using
  * SecondaryNetworkInterfaceEndpoint.with().
  *
- * @see {@link MatterSpecification.v151.Device} § 2.8
+ * @see {@link MatterSpecification.v16.Device} § 2.8
  */
 export interface SecondaryNetworkInterfaceEndpoint extends Identity<typeof SecondaryNetworkInterfaceEndpointDefinition> {}
 

package/src/node/ServerNode.ts

@@ -210,7 +210,7 @@ export class ServerNode<T extends ServerNode.RootEndpoint = ServerNode.RootEndpo
      * If this is inappropriate for your application, you may override to alter the behavior.  Matter requires that all
      * "security- and privacy-related data and key material" is removed on factory reset.
      *
-     * @see {@link MatterSpecification.v12.Core} § 13.4
+     * @see {@link MatterSpecification.v16.Core} § 13.4
      */
     protected async resetStorage() {
         await this.env.get(SessionManager).clear();

package/src/node/client/Peers.ts

@@ -15,6 +15,7 @@ import { InstanceDiscovery } from "#behavior/system/controller/discovery/Instanc
 import { PaseDiscovery } from "#behavior/system/controller/discovery/PaseDiscovery.js";
 import { NetworkClient } from "#behavior/system/network/NetworkClient.js";
 import { BasicInformationClient } from "#behaviors/basic-information";
+import { BridgedDeviceBasicInformationClient } from "#behaviors/bridged-device-basic-information";
 import { OperationalCredentialsClient } from "#behaviors/operational-credentials";
 import { Endpoint } from "#endpoint/Endpoint.js";
 import { EndpointContainer } from "#endpoint/properties/EndpointContainer.js";
@@ -85,6 +86,9 @@ export class Peers extends EndpointContainer<ClientNode> {
         this.deleted.on(this.#manageExpiration.bind(this));
 
         this.clusterInstalled(BasicInformationClient).on(this.#instrumentBasicInformation.bind(this));
+        this.clusterInstalled(BridgedDeviceBasicInformationClient).on(
+            this.#instrumentBridgedConfigurationVersion.bind(this),
+        );
 
         const lifecycle = owner.lifecycle;
         lifecycle.online.on(this.#nodeOnline.bind(this));
@@ -478,6 +482,17 @@ export class Peers extends EndpointContainer<ClientNode> {
         node.eventsOf(type).leave?.on(({ fabricIndex }) => this.#onLeave(node, fabricIndex));
         node.eventsOf(type).shutDown?.on(() => this.#onShutdown(node));
         node.eventsOf(type).startUp?.on(() => this.#onStartUp(node));
+        node.eventsOf(type).configurationVersion$Changed?.on(() => node.lifecycle.configurationVersionChanged.emit());
+    }
+
+    /**
+     * Bridged endpoints carry their own `ConfigurationVersion` on `BridgedDeviceBasicInformation`; surface its changes
+     * through the same endpoint lifecycle event used for the node's `BasicInformation`.
+     */
+    #instrumentBridgedConfigurationVersion(endpoint: Endpoint, type: typeof BridgedDeviceBasicInformationClient) {
+        endpoint
+            .eventsOf(type)
+            .configurationVersion$Changed?.on(() => endpoint.lifecycle.configurationVersionChanged.emit());
     }
 
     #onLeave(node: ClientNode, fabricIndex: FabricIndex) {

package/src/node/integration/ProtocolService.ts

@@ -464,7 +464,7 @@ function clusterTypeProtocolOf(backing: BehaviorBacking): ClusterTypeProtocol |
                 }
 
                 if (id & 0xffff0000) {
-                    wildcardPathFlags |= WildcardPathFlags.skipGlobalAttributes;
+                    wildcardPathFlags |= WildcardPathFlags.skipCustomElements;
                 }
                 if (quality.fixed) {
                     wildcardPathFlags |= WildcardPathFlags.skipFixedAttributes;

package/src/node/paths/AttributePath.ts

@@ -21,7 +21,7 @@ export namespace AttributePath {
     /**
      * Addresses a collection (struct or list) within an attribute.
      *
-     * @see {@link MatterSpecification.v11.Core} § 8.9.2.2
+     * @see {@link MatterSpecification.v16.Core} § 8.9.2.2
      */
     export type Nested = ({ field: FieldAddress } | { entry: EntryIndex })[];
 
@@ -29,7 +29,7 @@ export namespace AttributePath {
      * Addresses attribute data for read operations.  Note that if you specify the attribute you must also specify the
      * cluster except for global attributes.
      *
-     * @see {@link MatterSpecification.v11.Core} § 8.9.2.1 & 8.9.2.3
+     * @see {@link MatterSpecification.v16.Core} § 8.9.2.1 & 8.9.2.6
      */
     export type Read = BasePath.Read & {
         attribute?: Address;
@@ -39,7 +39,7 @@ export namespace AttributePath {
     /**
      * Addresses attribute data for write operations.
      *
-     * @see {@link MatterSpecification.v11.Core} § 8.9.2.1 & 8.9.2.4
+     * @see {@link MatterSpecification.v16.Core} § 8.9.2.1 & 8.9.2.7
      */
     export type Write = BasePath.Write & {
         attribute: Address;

package/src/node/paths/BasePath.ts

@@ -16,7 +16,7 @@ export namespace BasePath {
      * Addresses clusters on a single node with optional endpoint and
      * cluster wildcards.
      *
-     * @see {@link MatterSpecification.v11.Core} § 8.9.1.1
+     * @see {@link MatterSpecification.v16.Core} § 8.9.1.1
      */
     export type Read = {
         node: NodeId;
@@ -27,7 +27,7 @@ export namespace BasePath {
     /**
      * Addresses clusters in a group of nodes.
      *
-     * @see {@link MatterSpecification.v11.Core} § 8.9.1.1
+     * @see {@link MatterSpecification.v16.Core} § 8.9.1.1
      */
     export type GroupWrite = {
         group: GroupId;
@@ -37,7 +37,7 @@ export namespace BasePath {
     /**
      * Addresses clusters on a single node with endpoint wildcards.
      *
-     * @see {@link MatterSpecification.v11.Core} § 8.9.1.1
+     * @see {@link MatterSpecification.v16.Core} § 8.9.1.1
      */
     export type NodeWrite = {
         node: NodeId;
@@ -57,7 +57,7 @@ export namespace BasePath {
     /**
      * Addresses clusters on a node or group of nodes.
      *
-     * @see {@link MatterSpecification.v11.Core} § 8.9.1.1
+     * @see {@link MatterSpecification.v16.Core} § 8.9.1.1
      */
     export type Write = GroupWrite | NodeWrite;
 }

package/src/node/paths/CommandPath.ts

@@ -16,7 +16,7 @@ export namespace CommandPath {
     /**
      * Addresses a command for invocation.
      *
-     * @see {@link MatterSpecification.v11.Core} § 8.9.4.1
+     * @see {@link MatterSpecification.v16.Core} § 8.9.4.1
      */
     export type Invoke = BasePath.Write & {
         command: Address;

package/src/node/paths/EventPath.ts

@@ -17,7 +17,7 @@ export namespace EventPath {
      * Addresses event data for reads.  Note that you can wildcard the
      * event but if you specify an event you must also specify the cluster.
      *
-     * @see {@link MatterSpecification.v11.Core} § 8.9.3.2
+     * @see {@link MatterSpecification.v16.Core} § 8.9.3.2
      */
     export type Read = BasePath.Read & {
         urgent?: boolean;