@matter/node 0.16.0-alpha.0-20251023-bb23617e5 → 0.16.0-alpha.0-20251029-bd92894d4

package/src/behaviors/media-playback/MediaPlaybackInterface.ts

@@ -12,6 +12,8 @@ import { MediaPlayback } from "#clusters/media-playback";
 export namespace MediaPlaybackInterface {
     export interface Base {
         /**
+         * This command is used to start playback of the media.
+         *
          * Upon receipt, this shall play media. If content is currently in a FastForward or Rewind state. Play shall
          * return media to normal playback speed.
          *
@@ -20,13 +22,15 @@ export namespace MediaPlaybackInterface {
         play(): MaybePromise<MediaPlayback.PlaybackResponse>;
 
         /**
-         * Upon receipt, this shall pause playback of the media.
+         * This command is used to pause playback of the media. Upon receipt, this shall pause playback of the media.
          *
          * @see {@link MatterSpecification.v141.Cluster} § 6.10.7.2
          */
         pause(): MaybePromise<MediaPlayback.PlaybackResponse>;
 
         /**
+         * This command is used to stop playback of the media.
+         *
          * Upon receipt, this shall stop playback of the media. User-visible outcome is context-specific. This may
          * navigate the user back to the location from where the media was originally launched.
          *
@@ -35,13 +39,16 @@ export namespace MediaPlaybackInterface {
         stop(): MaybePromise<MediaPlayback.PlaybackResponse>;
 
         /**
-         * Upon receipt, this shall Start Over with the current media playback item.
+         * This command is used to start playback of the media from the beginning. Upon receipt, this shall Start Over
+         * with the current media playback item.
          *
          * @see {@link MatterSpecification.v141.Cluster} § 6.10.7.4
          */
         startOver(): MaybePromise<MediaPlayback.PlaybackResponse>;
 
         /**
+         * This command is used to go back to the previous media playback item.
+         *
          * Upon receipt, this shall cause the handler to be invoked for "Previous". User experience is context-specific.
          * This will often Go back to the previous media playback item.
          *
@@ -50,6 +57,8 @@ export namespace MediaPlaybackInterface {
         previous(): MaybePromise<MediaPlayback.PlaybackResponse>;
 
         /**
+         * This command is used to go to the next media playback item.
+         *
          * Upon receipt, this shall cause the handler to be invoked for "Next". User experience is context-specific.
          * This will often Go forward to the next media playback item.
          *
@@ -58,6 +67,8 @@ export namespace MediaPlaybackInterface {
         next(): MaybePromise<MediaPlayback.PlaybackResponse>;
 
         /**
+         * This command is used to skip forward in the media.
+         *
          * Upon receipt, this shall Skip forward in the media by the given number of milliseconds.
          *
          * @see {@link MatterSpecification.v141.Cluster} § 6.10.7.9
@@ -65,6 +76,8 @@ export namespace MediaPlaybackInterface {
         skipForward(request: MediaPlayback.SkipForwardRequest): MaybePromise<MediaPlayback.PlaybackResponse>;
 
         /**
+         * This command is used to skip backward in the media.
+         *
          * Upon receipt, this shall Skip backward in the media by the given number of milliseconds.
          *
          * @see {@link MatterSpecification.v141.Cluster} § 6.10.7.10
@@ -74,6 +87,8 @@ export namespace MediaPlaybackInterface {
 
     export interface AdvancedSeek {
         /**
+         * This command is used to seek to a specific position in the media.
+         *
          * Upon receipt, this shall change the playback position in the media to the given position.
          *
          * @see {@link MatterSpecification.v141.Cluster} § 6.10.7.11
@@ -83,6 +98,8 @@ export namespace MediaPlaybackInterface {
 
     export interface AudioTracks {
         /**
+         * This command is used to activate a specific Audio Track for the media being played.
+         *
          * Upon receipt, the server shall set the active Audio Track to the one identified by the TrackID in the Track
          * catalog for the streaming media. If the TrackID does not exist in the Track catalog, OR does not correspond
          * to the streaming media OR no media is being streamed at the time of receipt of this command, the server will
@@ -95,6 +112,8 @@ export namespace MediaPlaybackInterface {
 
     export interface TextTracks {
         /**
+         * This command is used to activate a specific Text Track for the media being played.
+         *
          * Upon receipt, the server shall set the active Text Track to the one identified by the TrackID in the Track
          * catalog for the streaming media. If the TrackID does not exist in the Track catalog, OR does not correspond
          * to the streaming media OR no media is being streamed at the time of receipt of this command, the server shall
@@ -105,6 +124,8 @@ export namespace MediaPlaybackInterface {
         activateTextTrack(request: MediaPlayback.ActivateTextTrackRequest): MaybePromise;
 
         /**
+         * This command is used to deactivate a specific Text Track for the media being played.
+         *
          * If a Text Track is active (i.e. being displayed), upon receipt of this command, the server shall stop
          * displaying it.
          *
@@ -115,6 +136,8 @@ export namespace MediaPlaybackInterface {
 
     export interface VariableSpeed {
         /**
+         * This command is used to rewind the media.
+         *
          * Upon receipt, this shall start playback of the media backward in case the media is currently playing in the
          * forward direction or is not playing. If the playback is already happening in the backwards direction receipt
          * of this command shall increase the speed of the media playback backwards.
@@ -132,6 +155,8 @@ export namespace MediaPlaybackInterface {
         rewind(request: MediaPlayback.RewindRequest): MaybePromise<MediaPlayback.PlaybackResponse>;
 
         /**
+         * This command is used to fast forward the media.
+         *
          * Upon receipt, this shall start playback of the media in the forward direction in case the media is currently
          * playing in the backward direction or is not playing. If the playback is already happening in the forward
          * direction receipt of this command shall increase the speed of the media playback.

package/src/behaviors/network-commissioning/NetworkCommissioningInterface.ts

@@ -12,6 +12,9 @@ import { NetworkCommissioning } from "#clusters/network-commissioning";
 export namespace NetworkCommissioningInterface {
     export interface WiFiNetworkInterfaceOrThreadNetworkInterface {
         /**
+         * This command is used to scan for available networks on the network interface associated with the cluster
+         * instance.
+         *
          * This command shall scan on the Cluster instance’s associated network interface for either of:
          *
          *   • All available networks (non-directed scanning)
@@ -27,8 +30,8 @@ export namespace NetworkCommissioningInterface {
          * SSID) is provided in the command arguments. Directed scanning shall restrict the result set to the specified
          * network only.
          *
-         * If this command is received without an armed fail-safe context (see ArmFailSafe), then this command shall
-         * fail with a FAILSAFE_REQUIRED status code sent back to the initiator.
+         * If this command is received without an armed fail-safe context (see Section 11.10.7.2, “ArmFailSafe
+         * Command”), then this command shall fail with a FAILSAFE_REQUIRED status code sent back to the initiator.
          *
          * The client shall NOT expect the server to be done scanning and have responded with ScanNetworksResponse
          * before ScanMaxTimeSeconds seconds have elapsed. Enough transport time affordances for retries SHOULD be
@@ -56,12 +59,15 @@ export namespace NetworkCommissioningInterface {
         scanNetworks(request: NetworkCommissioning.ScanNetworksRequest): MaybePromise<NetworkCommissioning.ScanNetworksResponse>;
 
         /**
+         * This command is used to remove a network configuration on the network interface associated with the cluster
+         * instance.
+         *
          * This command shall remove the network configuration from the Cluster if there was already a network
          * configuration with the same NetworkID. The relative order of the entries in the Networks attribute shall
          * remain unchanged, except for the removal of the requested network configuration.
          *
-         * If this command is received without an armed fail-safe context (see ArmFailSafe), then this command shall
-         * fail with a FAILSAFE_REQUIRED status code sent back to the initiator.
+         * If this command is received without an armed fail-safe context (see Section 11.10.7.2, “ArmFailSafe
+         * Command”), then this command shall fail with a FAILSAFE_REQUIRED status code sent back to the initiator.
          *
          * If the Networks attribute does not contain a matching entry, the command shall immediately respond with
          * NetworkConfigResponse having NetworkingStatus status field set to NetworkIdNotFound.
@@ -75,6 +81,8 @@ export namespace NetworkCommissioningInterface {
         removeNetwork(request: NetworkCommissioning.RemoveNetworkRequest): MaybePromise<NetworkCommissioning.NetworkConfigResponse>;
 
         /**
+         * This command is used to connect to a network on the network interface associated with the cluster instance.
+         *
          * This command shall attempt to connect to a network whose configuration was previously added by either the
          * AddOrUpdateWiFiNetwork or AddOrUpdateThreadNetwork commands. Network is identified by its NetworkID.
          *
@@ -82,8 +90,8 @@ export namespace NetworkCommissioningInterface {
          * to proceed with such an operation, such as if it is currently attempting to connect in the background, or is
          * already proceeding with a prior ConnectNetwork.
          *
-         * If this command is received without an armed fail-safe context (see ArmFailSafe), then this command shall
-         * fail with a FAILSAFE_REQUIRED status code sent back to the initiator.
+         * If this command is received without an armed fail-safe context (see Section 11.10.7.2, “ArmFailSafe
+         * Command”), then this command shall fail with a FAILSAFE_REQUIRED status code sent back to the initiator.
          *
          * Before connecting to the new network, the Node shall disconnect the operational network connections managed
          * by any other Network Commissioning cluster instances (whether under the Root Node or a Secondary Network
@@ -115,8 +123,8 @@ export namespace NetworkCommissioningInterface {
          * The precedence order of any entry subject to ConnectNetwork shall NOT change within the Networks attribute.
          *
          * Even after successfully connecting to a network, the configuration shall revert to the prior state of
-         * configuration if the CommissioningComplete command (see CommissioningComplete) is not successfully invoked
-         * before expiry of the Fail-Safe timer.
+         * configuration if the CommissioningComplete command (see Section 11.10.7.6, “CommissioningComplete Command”)
+         * is not successfully invoked before expiry of the Fail-Safe timer.
          *
          * When non-concurrent commissioning is being used by a Commissioner or Administrator, the
          * ConnectNetworkResponse shall be sent with the NetworkingStatus field set to Success prior to closing the
@@ -127,8 +135,8 @@ export namespace NetworkCommissioningInterface {
          * the new operational network. Therefore, before invoking the ConnectNetwork command, the client SHOULD
          * re-invoke the Arm Fail-Safe command with a duration that meets the following:
          *
-         *   1. Sufficient time to meet the minimum required time (see ConnectMaxTimeSeconds) that may be taken by the
-         *      server to connect to the desired network.
+         *   1. Sufficient time to meet the minimum required time (see Section 11.9.6.4, “ConnectMaxTimeSeconds
+         *      Attribute”) that may be taken by the server to connect to the desired network.
          *
          *   2. Sufficient time to account for possible message-layer retries when a response is requested.
          *
@@ -152,6 +160,8 @@ export namespace NetworkCommissioningInterface {
         connectNetwork(request: NetworkCommissioning.ConnectNetworkRequest): MaybePromise<NetworkCommissioning.ConnectNetworkResponse>;
 
         /**
+         * This command is used to re-order the network configuration list.
+         *
          * This command shall set the specific order of the network configuration selected by its NetworkID in the
          * Networks attribute to match the position given by NetworkIndex.
          *
@@ -162,10 +172,12 @@ export namespace NetworkCommissioningInterface {
 
     export interface WiFiNetworkInterface {
         /**
+         * This command is used to add or update a Wi-Fi network configuration.
+         *
          * This command shall be used to add or modify Wi-Fi network configurations.
          *
-         * If this command is received without an armed fail-safe context (see ArmFailSafe), then this command shall
-         * fail with a FAILSAFE_REQUIRED status code sent back to the initiator.
+         * If this command is received without an armed fail-safe context (see Section 11.10.7.2, “ArmFailSafe
+         * Command”), then this command shall fail with a FAILSAFE_REQUIRED status code sent back to the initiator.
          *
          * The Credentials associated with the network are not readable after execution of this command, as they do not
          * appear in the Networks attribute, for security reasons.
@@ -183,10 +195,12 @@ export namespace NetworkCommissioningInterface {
 
     export interface ThreadNetworkInterface {
         /**
+         * This command is used to add or update a Thread network configuration.
+         *
          * This command shall be used to add or modify Thread network configurations.
          *
-         * If this command is received without an armed fail-safe context (see ArmFailSafe), then this command shall
-         * fail with a FAILSAFE_REQUIRED status code sent back to the initiator.
+         * If this command is received without an armed fail-safe context (see Section 11.10.7.2, “ArmFailSafe
+         * Command”), then this command shall fail with a FAILSAFE_REQUIRED status code sent back to the initiator.
          *
          * See Section 11.9.7.5, “Common processing of AddOrUpdateWiFiNetwork and AddOrUpdateThreadNetwork” for behavior
          * of addition/update.

package/src/behaviors/operational-credentials/OperationalCredentialsInterface.ts

@@ -12,6 +12,8 @@ import { OperationalCredentials } from "#clusters/operational-credentials";
 export namespace OperationalCredentialsInterface {
     export interface Base {
         /**
+         * This command is used to perform an attestation request.
+         *
          * This command shall be generated to request the Attestation Information, in the form of an AttestationResponse
          * Command. If the AttestationNonce that is provided in the command is malformed, a recipient shall fail the
          * command with a Status Code of INVALID_COMMAND. The AttestationNonce field shall be used in the computation of
@@ -22,6 +24,8 @@ export namespace OperationalCredentialsInterface {
         attestationRequest(request: OperationalCredentials.AttestationRequest): MaybePromise<OperationalCredentials.AttestationResponse>;
 
         /**
+         * This command is used to request a certificate from the device attestation certificate chain.
+         *
          * If the CertificateType is not a valid value per CertificateChainTypeEnum then the command shall fail with a
          * Status Code of INVALID_COMMAND.
          *
@@ -30,6 +34,8 @@ export namespace OperationalCredentialsInterface {
         certificateChainRequest(request: OperationalCredentials.CertificateChainRequest): MaybePromise<OperationalCredentials.CertificateChainResponse>;
 
         /**
+         * This command is used to perform a CSR request.
+         *
          * This command shall be generated to execute the Node Operational CSR Procedure and subsequently return the
          * NOCSR Information, in the form of a CSRResponse Command.
          *
@@ -40,12 +46,13 @@ export namespace OperationalCredentialsInterface {
          * command shall fail with an INVALID_COMMAND status code, as it would never be possible to use a resulting
          * subsequent certificate issued from the CSR with the UpdateNOC command, which is forbidden over PASE sessions.
          *
-         * If the IsForUpdateNOC field is present and set to true, the internal state of the CSR associated keypair
+         * If the IsForUpdateNOC field is present and set to true, the internal state of the CSR associated key pair
          * shall be tagged as being for a subsequent UpdateNOC, otherwise the internal state of the CSR shall be tagged
-         * as being for a subsequent AddNOC. See AddNOC and UpdateNOC for details about the processing.
+         * as being for a subsequent AddNOC. See Section 11.18.6.8, “AddNOC Command” and Section 11.18.6.9, “UpdateNOC
+         * Command” for details about the processing.
          *
-         * If this command is received without an armed fail-safe context (see ArmFailSafe), then this command shall
-         * fail with a FAILSAFE_REQUIRED status code sent back to the initiator.
+         * If this command is received without an armed fail-safe context (see Section 11.10.7.2, “ArmFailSafe
+         * Command”), then this command shall fail with a FAILSAFE_REQUIRED status code sent back to the initiator.
          *
          * If a prior UpdateNOC or AddNOC command was successfully executed within the fail-safe timer period, then this
          * command shall fail with a CONSTRAINT_ERROR status code sent back to the initiator.
@@ -59,6 +66,8 @@ export namespace OperationalCredentialsInterface {
         csrRequest(request: OperationalCredentials.CsrRequest): MaybePromise<OperationalCredentials.CsrResponse>;
 
         /**
+         * This command is used to add a new NOC to the device.
+         *
          * This command shall add a new NOC chain to the device and commission a new Fabric association upon successful
          * validation of all arguments and preconditions.
          *
@@ -74,6 +83,8 @@ export namespace OperationalCredentialsInterface {
         addNoc(request: OperationalCredentials.AddNocRequest): MaybePromise<OperationalCredentials.NocResponse>;
 
         /**
+         * This command is used to update an existing NOC on the device.
+         *
          * This command shall replace the NOC and optional associated ICAC (if present) scoped under the accessing
          * fabric upon successful validation of all arguments and preconditions. The new value shall immediately be
          * reflected in the NOCs list attribute.
@@ -83,10 +94,10 @@ export namespace OperationalCredentialsInterface {
          *
          * A Commissioner or Administrator SHOULD issue this command after performing the Attestation Procedure.
          *
-         * ### Effect When Received
+         * ### Effect on Receipt
          *
-         * If this command is received without an armed fail-safe context (see ArmFailSafe), then this command shall
-         * fail with a FAILSAFE_REQUIRED status code sent back to the initiator.
+         * If this command is received without an armed fail-safe context (see Section 11.10.7.2, “ArmFailSafe
+         * Command”), then this command shall fail with a FAILSAFE_REQUIRED status code sent back to the initiator.
          *
          * If a prior UpdateNOC or AddNOC command was successfully executed within the fail-safe timer period, then this
          * command shall fail with a CONSTRAINT_ERROR status code sent back to the initiator.
@@ -133,6 +144,8 @@ export namespace OperationalCredentialsInterface {
         updateNoc(request: OperationalCredentials.UpdateNocRequest): MaybePromise<OperationalCredentials.NocResponse>;
 
         /**
+         * This command is used to set the user-visible fabric label for a given Fabric.
+         *
          * This command shall be used by an Administrator to set the user-visible Label field for a given Fabric, as
          * reflected by entries in the Fabrics attribute. An Administrator shall use this command to set the Label to a
          * string (possibly selected by the user themselves) that the user can recognize and relate to this
@@ -151,11 +164,15 @@ export namespace OperationalCredentialsInterface {
         updateFabricLabel(request: OperationalCredentials.UpdateFabricLabelRequest): MaybePromise<OperationalCredentials.NocResponse>;
 
         /**
+         * This command is used to remove a Fabric from the device.
+         *
          * This command is used by Administrators to remove a given Fabric and delete all associated fabric-scoped data.
          *
          * If the given Fabric being removed is the last one to reference a given Trusted Root CA Certificate stored in
          * the Trusted Root Certificates list, then that Trusted Root Certificate shall be removed.
          *
+         * ### WARNING
+         *
          * This command, if referring to an already existing Fabric not under the control of the invoking Administrator,
          * shall ONLY be invoked after obtaining some form of explicit user consent through some method executed by the
          * Administrator or Commissioner. This method of obtaining consent SHOULD employ as much data as possible about
@@ -170,6 +187,8 @@ export namespace OperationalCredentialsInterface {
         removeFabric(request: OperationalCredentials.RemoveFabricRequest): MaybePromise<OperationalCredentials.NocResponse>;
 
         /**
+         * This command is used to add a trusted root certificate to the device.
+         *
          * This command shall add a Trusted Root CA Certificate, provided as its Matter Certificate Encoding
          * representation, to the TrustedRootCertificates Attribute list and shall ensure the next AddNOC command
          * executed uses the provided certificate as its root of trust.
@@ -177,8 +196,8 @@ export namespace OperationalCredentialsInterface {
          * If the certificate from the RootCACertificate field is already installed, based on exact byte-for-byte
          * equality, then this command shall succeed with no change to the list.
          *
-         * If this command is received without an armed fail-safe context (see ArmFailSafe), then this command shall
-         * fail with a FAILSAFE_REQUIRED status code sent back to the initiator.
+         * If this command is received without an armed fail-safe context (see Section 11.10.7.2, “ArmFailSafe
+         * Command”), then this command shall fail with a FAILSAFE_REQUIRED status code sent back to the initiator.
          *
          * If a prior AddTrustedRootCertificate command was successfully invoked within the fail-safe timer period,
          * which would cause the new invocation to add a second root certificate within a given fail-safe timer period,
@@ -197,6 +216,86 @@ export namespace OperationalCredentialsInterface {
          * @see {@link MatterSpecification.v141.Core} § 11.18.6.13
          */
         addTrustedRootCertificate(request: OperationalCredentials.AddTrustedRootCertificateRequest): MaybePromise;
+
+        /**
+         * This command is used to manage the VendorID and VIDVerificationStatement fields of the Fabrics attribute, and
+         * the VVSC field of an entry in the NOCs attribute.
+         *
+         * This command shall be used to one or more of the following:
+         *
+         *   • Update the VendorID associated with an entry in the Fabrics attribute.
+         *
+         *   • Associate or remove a VIDVerificationStatement associated with an entry in the Fabrics attribute.
+         *
+         *   • Associate or remove a VendorVerificationSigningCertificate (VVSC) associated with an entry in the NOCs
+         *     attribute.
+         *
+         * This command shall only operate against the Fabrics and NOCs attribute entries associated with the accessing
+         * fabric index.
+         *
+         * ### Effect on Receipt
+         *
+         * If the VendorID field is present, the value of the VendorID in the Fabrics attribute entry associated with
+         * the accessing fabric index shall have its value replaced with the value from the command field.
+         *
+         * If the VVSC field is present, but the ICAC field is already present in the NOCs attribute entry associated
+         * with the accessing fabric index, then the command shall fail with a status code of INVALID_COMMAND.
+         *
+         * If the VIDVerificationStatement field is present:
+         *
+         *   • If the length of the field’s value is neither exactly 0 nor exactly 85, then the command shall fail with
+         *     a status code of CONSTRAINT_ERROR.
+         *
+         *   • If the length of the field’s value is exactly 0, then the VIDVerificationStatement field in the Fabrics
+         *     attribute entry associated with the accessing fabric index shall be erased and the field shall disappear
+         *     from the Fabrics entry.
+         *
+         *   • If the length of the field’s value is exactly 85, then the VIDVerificationStatement field in the Fabrics
+         *     attribute entry associated with the accessing fabric index shall have its value replaced with the value
+         *     from the command field.
+         *
+         * If the VVSC field is present:
+         *
+         *   • If the length of the field’s value is exactly 0, then the VVSC field in the NOCs attribute entry
+         *     associated with the accessing fabric index shall be erased and the field shall disappear from the NOCs
+         *     entry.
+         *
+         *   • If the length of the field’s value is not 0, then the VVSC field in the NOCs attribute entry associated
+         *     with the accessing fabric index shall have its value replaced with the value from the command field. The
+         *     contents of the certificate need not be validated by the server. Clients shall validate the contents at
+         *     time of use.
+         *
+         * If the command was invoked within a fail-safe context after a successful AddNOC or UpdateNOC command, then
+         * the field updates shall apply to the pending update state that will be reverted if fail-safe expires prior to
+         * a CommissioningComplete command. In other words, field updates apply to the state of the Fabrics Attribute as
+         * currently visible, even for an existing fabric currently in process of being updated.
+         *
+         * @see {@link MatterSpecification.v141.Core} § 11.18.6.14
+         */
+        setVidVerificationStatement(request: OperationalCredentials.SetVidVerificationStatementRequest): MaybePromise;
+
+        /**
+         * This command is used to authenticate the fabric associated with the FabricIndex.
+         *
+         * This command shall be used to request that the server authenticate the fabric associated with the FabricIndex
+         * given by generating the response described in Section 6.4.10, “Fabric Table Vendor ID Verification
+         * Procedure”.
+         *
+         * The FabricIndex field shall contain the fabric index being targeted by the request.
+         *
+         * The ClientChallenge field shall contain a client-provided random challenge to be used during the signature
+         * procedure.
+         *
+         * ### Effect on Receipt
+         *
+         * If the FabricIndex field contains a fabric index which does not have an associated entry in the Fabrics
+         * attribute, then the command shall fail with a status code of CONSTRAINT_ERROR.
+         *
+         * Otherwise, if no other errors have occurred, the command shall generate a SignVIDVerificationResponse.
+         *
+         * @see {@link MatterSpecification.v141.Core} § 11.18.6.15
+         */
+        signVidVerificationRequest(request: OperationalCredentials.SignVidVerificationRequest): MaybePromise<OperationalCredentials.SignVidVerificationResponse>;
     }
 }
 

package/src/behaviors/operational-credentials/OperationalCredentialsServer.ts

@@ -86,7 +86,7 @@ export class OperationalCredentialsServer extends OperationalCredentialsBehavior
 
     override initialize(): MaybePromise {
         // maximum number of fabrics. Also FabricBuilder uses 254 as max!
-        if (this.state.supportedFabrics === undefined) {
+        if (!this.state.supportedFabrics) {
             this.state.supportedFabrics = 254;
         }
         this.state.commissionedFabrics = this.state.fabrics.length;

package/src/behaviors/service-area/ServiceAreaInterface.ts

@@ -24,9 +24,6 @@ export namespace ServiceAreaInterface {
          * This command is used to skip the given area, and to attempt operating at other areas on the SupportedAreas
          * attribute list.
          *
-         * This command shall NOT be implemented if the CurrentArea attribute and the Progress attribute are both not
-         * implemented. Else, this command shall be optionally implemented.
-         *
          * On receipt of this command the device shall respond with a SkipAreaResponse command.
          *
          * @see {@link MatterSpecification.v141.Cluster} § 1.17.7.3

package/src/behaviors/service-area/ServiceAreaServer.ts

@@ -40,9 +40,9 @@ export class ServiceAreaBaseServer extends ServiceAreaBase {
         this.reactTo(this.events.supportedMaps$Changing, this.#assertSupportedMaps);
         this.#assertSelectedAreas(this.state.selectedAreas);
         this.reactTo(this.events.selectedAreas$Changing, this.#assertSelectedAreas);
-        if (this.state.currentArea !== undefined && this.events.currentArea$Changing !== undefined) {
+        if (this.state.currentArea !== undefined) {
             this.#assertCurrentArea(this.state.currentArea);
-            this.reactTo(this.events.currentArea$Changing, this.#assertCurrentArea);
+            this.maybeReactTo(this.events.currentArea$Changing, this.#assertCurrentArea);
         }
         if (this.state.progress !== undefined) {
             this.#assertProgress(this.state.progress);

package/src/behaviors/software-diagnostics/SoftwareDiagnosticsInterface.ts

@@ -11,11 +11,13 @@ import { MaybePromise } from "#general";
 export namespace SoftwareDiagnosticsInterface {
     export interface Watermarks {
         /**
+         * This command is used to reset the high watermarks for heap and stack memory.
+         *
          * Receipt of this command shall reset the following values which track high and lower watermarks:
          *
          *   • The StackFreeMinimum field of the ThreadMetrics attribute
          *
-         *   • The CurrentHeapHighWatermark attribute This command has no payload.
+         *   • The CurrentHeapHighWatermark attribute
          *
          * ### Effect on Receipt
          *

package/src/behaviors/switch/SwitchServer.ts

@@ -346,6 +346,10 @@ export namespace SwitchBaseServer {
 
         /** Number of the position considered as the neutral position for the momentary switch. */
         momentaryNeutralPosition: number = 0;
+
+        // These are mandatory; provide reasonable defaults
+        override numberOfPositions = 2;
+        override multiPressMax = 2;
     }
 
     /** Enhance the relevant events for rawPosition attribute. */

package/src/behaviors/temperature-control/TemperatureControlInterface.ts

@@ -12,6 +12,8 @@ import { TemperatureControl } from "#clusters/temperature-control";
 export namespace TemperatureControlInterface {
     export interface Base {
         /**
+         * This command is used to set the temperature setpoint.
+         *
          * @see {@link MatterSpecification.v141.Cluster} § 8.2.6.1
          */
         setTemperature(request: TemperatureControl.SetTemperatureRequest): MaybePromise;