@matter/node 0.16.0-alpha.0-20251022-5a69ce65a → 0.16.0-alpha.0-20251027-17770fb28

package/src/behaviors/fan-control/FanControlInterface.ts

@@ -12,10 +12,19 @@ import { FanControl } from "#clusters/fan-control";
 export namespace FanControlInterface {
     export interface Step {
         /**
-         * This command speeds up or slows down the fan, in steps, without the client having to know the fan speed. This
-         * command supports, for example, a user operated wall switch, where the user provides the feedback or control
-         * to stop sending this command when the proper speed is reached. The step speed values are implementation
-         * specific. How many step speeds are implemented is implementation specific.
+         * This command indirectly changes the speed-oriented attributes of the fan in steps rather than using the
+         * speed-oriented attributes, FanMode, PercentSetting, or SpeedSetting, directly. This command supports, for
+         * example, a user-operated and wall-mounted toggle switch that can be used to increase or decrease the speed of
+         * the fan by pressing the toggle switch up or down until the desired fan speed is reached. How this command is
+         * interpreted by the server and how it affects the values of the speed-oriented attributes is implementation
+         * specific.
+         *
+         * For example, a fan supports this command, and the value of the FanModeSequence attribute is 0. The current
+         * value of the FanMode attribute is 2, or Medium. This command is received with the Direction field set to
+         * Increase. As per it’s specific implementation, the server reacts to the command by setting the value of the
+         * FanMode attribute to 3, or High, which in turn sets the PercentSetting and SpeedSetting (if present)
+         * attributes to appropriate values, as defined by Section 4.4.6.3.1, “Percent Rules” and Section 4.4.6.6.1,
+         * “Speed Rules” respectively.
          *
          * This command supports these fields:
          *

package/src/behaviors/fan-control/FanControlServer.ts

@@ -4,11 +4,16 @@
  * SPDX-License-Identifier: Apache-2.0
  */
 
-/*** THIS FILE WILL BE REGENERATED IF YOU DO NOT REMOVE THIS MESSAGE ***/
-
+import { FanControl } from "#clusters/fan-control";
 import { FanControlBehavior } from "./FanControlBehavior.js";
 
 /**
  * This is the default server implementation of {@link FanControlBehavior}.
  */
-export class FanControlServer extends FanControlBehavior {}
+export class FanControlServer extends FanControlBehavior {
+    override initialize() {
+        if (this.state.fanMode === undefined) {
+            this.state.fanMode = FanControl.FanMode.Off;
+        }
+    }
+}

package/src/behaviors/general-commissioning/GeneralCommissioningInterface.ts

@@ -12,6 +12,8 @@ import { GeneralCommissioning } from "#clusters/general-commissioning";
 export namespace GeneralCommissioningInterface {
     export interface Base {
         /**
+         * This command is used to arm or disarm the fail-safe timer.
+         *
          * Success or failure of this command shall be communicated by the ArmFailSafeResponse command, unless some data
          * model validations caused a failure status code to be issued during the processing of the command.
          *
@@ -61,9 +63,9 @@ export namespace GeneralCommissioningInterface {
          *
          *   • Whether an AddNOC command or UpdateNOC command has taken place.
          *
-         *   • A Fabric Index for the fabric-scoping of the context, starting at the accessing fabric index for the
-         *     ArmFailSafe command, and updated with the Fabric Index associated with an AddNOC command or an UpdateNOC
-         *     command being invoked successfully during the ongoing Fail-Safe timer period.
+         *   • A fabric-index for the fabric-scoping of the context, starting at the accessing fabric index for the
+         *     ArmFailSafe command, and updated with the Fabric Index associated with an AddNOC or an UpdateNOC command
+         *     being invoked successfully during the ongoing Fail-Safe timer period.
          *
          *   • The operational credentials associated with any Fabric whose configuration is affected by the UpdateNOC
          *     command.
@@ -100,8 +102,8 @@ export namespace GeneralCommissioningInterface {
          *      “Bootstrapping of the Access Control Cluster”) at the Server.
          *
          *   3. If an AddNOC or UpdateNOC command has been successfully invoked, terminate all CASE sessions associated
-         *      with the Fabric whose Fabric Index is recorded in the Fail-Safe context (see ArmFailSafe) by clearing
-         *      any associated Secure Session Context at the Server.
+         *      with the Fabric whose Fabric Index is recorded in the Fail-Safe context (see Section 11.10.7.2,
+         *      “ArmFailSafe Command”) by clearing any associated Secure Session Context at the Server.
          *
          *   4. Reset the configuration of all Network Commissioning Networks attribute to their state prior to the
          *      Fail-Safe being armed.
@@ -111,14 +113,15 @@ export namespace GeneralCommissioningInterface {
          *      was the subject of the UpdateNOC command.
          *
          *   6. If an AddNOC command had been successfully invoked, achieve the equivalent effect of invoking the
-         *      RemoveFabric command against the Fabric Index stored in the Fail-Safe Context for the Fabric Index that
+         *      RemoveFabric command against the fabric-index stored in the Fail-Safe Context for the Fabric Index that
          *      was the subject of the AddNOC command. This shall remove all associations to that Fabric including all
          *      fabric-scoped data, and may possibly factory-reset the device depending on current device state. This
          *      shall only apply to Fabrics added during the fail-safe period as the result of the AddNOC command.
          *
          *   7. If the CSRRequest command had been successfully invoked, but no AddNOC or UpdateNOC command had been
          *      successfully invoked, then the new operational key pair temporarily generated for the purposes of NOC
-         *      addition or update (see Node Operational CSR Procedure) shall be removed as it is no longer needed.
+         *      addition or update (see Section 6.4.6.1, “Node Operational Certificate Signing Request (NOCSR)
+         *      Procedure”) shall be removed as it is no longer needed.
          *
          *   8. Remove any RCACs added by the AddTrustedRootCertificate command that are not currently referenced by any
          *      entry in the Fabrics attribute.
@@ -133,6 +136,8 @@ export namespace GeneralCommissioningInterface {
         armFailSafe(request: GeneralCommissioning.ArmFailSafeRequest): MaybePromise<GeneralCommissioning.ArmFailSafeResponse>;
 
         /**
+         * This command is used to set the regulatory configuration for the device.
+         *
          * This shall add or update the regulatory configuration in the RegulatoryConfig Attribute to the value provided
          * in the NewRegulatoryConfig field.
          *
@@ -167,7 +172,7 @@ export namespace GeneralCommissioningInterface {
         setRegulatoryConfig(request: GeneralCommissioning.SetRegulatoryConfigRequest): MaybePromise<GeneralCommissioning.SetRegulatoryConfigResponse>;
 
         /**
-         * This command has no data.
+         * This command is used to indicate that the commissioning process is complete.
          *
          * Success or failure of this command shall be communicated by the CommissioningCompleteResponse command, unless
          * some data model validations caused a failure status code to be issued during the processing of the command.
@@ -184,9 +189,7 @@ export namespace GeneralCommissioningInterface {
          * received when no Fail-Safe context exists.
          *
          * If Terms and Conditions are required, then an ErrorCode of TCAcknowledgementsNotReceived shall be responded
-         * to the invoker if the user acknowledgements to the required Terms and Conditions have not been provided. If
-         * the TCAcceptedVersion for the provided acknowledgements is less than TCMinRequiredVersion, then an ErrorCode
-         * of TCMinVersionNotMet shall be responded to the invoker.
+         * to the invoker if the user acknowledgements to the required Terms and Conditions have not been provided.
          *
          * This command is fabric-scoped, so cannot be issued over a session that does not have an associated fabric,
          * i.e. over PASE session prior to an AddNOC command. In addition, this command is only permitted over CASE and
@@ -230,8 +233,8 @@ export namespace GeneralCommissioningInterface {
 
     export interface TermsAndConditions {
         /**
-         * This command sets the user acknowledgements received in the Enhanced Setup Flow Terms & Conditions into the
-         * node.
+         * This command is used to set the user acknowledgements received in the Enhanced Setup Flow Terms & Conditions
+         * into the node.
          *
          * @see {@link MatterSpecification.v141.Core} § 11.10.7.8
          */

package/src/behaviors/group-key-management/GroupKeyManagementInterface.ts

@@ -27,8 +27,8 @@ export namespace GroupKeyManagementInterface {
          *
          *   • If the EpochStartTime0 is set to 0, then this command shall fail with an INVALID_COMMAND status code
          *     responded to the client. Note that internally, a GroupKeySetStruct’s EpochStartTime0 may be set to zero,
-         *     due to the behavior of the AddNOC command which synthesizes a GroupKeySetStruct (see IPKValue). However,
-         *     the value 0 is illegal in the GroupKeySet field sent by a client.
+         *     due to the behavior of the AddNOC command which synthesizes a GroupKeySetStruct (see Section 11.18.6.8.1,
+         *     “IPKValue Field”). However, the value 0 is illegal in the GroupKeySet field sent by a client.
          *
          *   • If the EpochKey1 field is not null, then the EpochKey0 field shall NOT be null. Otherwise this command
          *     shall fail with an INVALID_COMMAND status code responded to the client.
@@ -69,7 +69,7 @@ export namespace GroupKeyManagementInterface {
          *     SUCCESS.
          *
          *   • If there are insufficient resources on the receiver to store an additional Group Key Set, the status code
-         *     shall be set to RESOURCE_EXHAUSTED (see group key limits);
+         *     shall be set to RESOURCE_EXHAUSTED (see Section 2.11.1.2, “Group Limits”);
          *
          *   • Otherwise, this status code shall be set to FAILURE.
          *

package/src/behaviors/icd-management/IcdManagementInterface.ts

@@ -20,7 +20,25 @@ export namespace IcdManagementInterface {
          * exchanges during that period. The client may slightly overestimate the duration it wants the ICD to be active
          * for, in order to account for network delays.
          *
-         * @see {@link MatterSpecification.v141.Core} § 9.17.7.4
+         * ### Effect on Receipt
+         *
+         * When receiving a StayActiveRequest command, the server shall calculate the maximum PromisedActiveDuration it
+         * can remain active as the greater of the following two values:
+         *
+         *   • StayActiveDuration: Specified in the received command by the client.
+         *
+         *   • Remaining Active Time: The server’s planned remaining active time based on the ActiveModeThreshold and
+         *     its internal resources and power budget.
+         *
+         * A server may replace StayActiveDuration with Minimum Active Duration in the above calculation.
+         *
+         * PromisedActiveDuration represents the guaranteed minimum time the server will remain active, taking into
+         * account both the requested duration and the server’s capabilities.
+         *
+         * The ICD shall report the calculated PromisedActiveDuration in a StayActiveResponse message back to the
+         * client.
+         *
+         * @see {@link MatterSpecification.v141.Core} § 9.16.7.4
          */
         stayActiveRequest(request: IcdManagement.StayActiveRequest): MaybePromise<IcdManagement.StayActiveResponse>;
     }
@@ -30,7 +48,7 @@ export namespace IcdManagementInterface {
          * This command allows a client to register itself with the ICD to be notified when the device is available for
          * communication.
          *
-         * @see {@link MatterSpecification.v141.Core} § 9.17.7.1
+         * @see {@link MatterSpecification.v141.Core} § 9.16.7.1
          */
         registerClient(request: IcdManagement.RegisterClientRequest): MaybePromise<IcdManagement.RegisterClientResponse>;
 
@@ -39,7 +57,7 @@ export namespace IcdManagementInterface {
          * (e.g. running on a phone which is leaving the home) can (and should) remove its subscriptions and send this
          * UnregisterClient command before leaving to prevent the burden on the ICD of an absent client.
          *
-         * @see {@link MatterSpecification.v141.Core} § 9.17.7.3
+         * @see {@link MatterSpecification.v141.Core} § 9.16.7.3
          */
         unregisterClient(request: IcdManagement.UnregisterClientRequest): MaybePromise;
     }
@@ -54,7 +72,25 @@ export namespace IcdManagementInterface {
          * exchanges during that period. The client may slightly overestimate the duration it wants the ICD to be active
          * for, in order to account for network delays.
          *
-         * @see {@link MatterSpecification.v141.Core} § 9.17.7.4
+         * ### Effect on Receipt
+         *
+         * When receiving a StayActiveRequest command, the server shall calculate the maximum PromisedActiveDuration it
+         * can remain active as the greater of the following two values:
+         *
+         *   • StayActiveDuration: Specified in the received command by the client.
+         *
+         *   • Remaining Active Time: The server’s planned remaining active time based on the ActiveModeThreshold and
+         *     its internal resources and power budget.
+         *
+         * A server may replace StayActiveDuration with Minimum Active Duration in the above calculation.
+         *
+         * PromisedActiveDuration represents the guaranteed minimum time the server will remain active, taking into
+         * account both the requested duration and the server’s capabilities.
+         *
+         * The ICD shall report the calculated PromisedActiveDuration in a StayActiveResponse message back to the
+         * client.
+         *
+         * @see {@link MatterSpecification.v141.Core} § 9.16.7.4
          */
         stayActiveRequest(request: IcdManagement.StayActiveRequest): MaybePromise<IcdManagement.StayActiveResponse>;
     }

package/src/behaviors/index.ts

@@ -16,7 +16,6 @@ export * from "./alarm-base/index.js";
 export * from "./application-basic/index.js";
 export * from "./application-launcher/index.js";
 export * from "./audio-output/index.js";
-export * from "./ballast-configuration/index.js";
 export * from "./basic-information/index.js";
 export * from "./binding/index.js";
 export * from "./boolean-state-configuration/index.js";
@@ -57,8 +56,8 @@ export * from "./hepa-filter-monitoring/index.js";
 export * from "./icd-management/index.js";
 export * from "./identify/index.js";
 export * from "./illuminance-measurement/index.js";
+export * from "./joint-fabric-administrator/index.js";
 export * from "./joint-fabric-datastore/index.js";
-export * from "./joint-fabric-pki/index.js";
 export * from "./keypad-input/index.js";
 export * from "./label/index.js";
 export * from "./laundry-dryer-controls/index.js";
@@ -92,8 +91,6 @@ export * from "./power-source-configuration/index.js";
 export * from "./power-source/index.js";
 export * from "./power-topology/index.js";
 export * from "./pressure-measurement/index.js";
-export * from "./proxy-configuration/index.js";
-export * from "./proxy-discovery/index.js";
 export * from "./pump-configuration-and-control/index.js";
 export * from "./radon-concentration-measurement/index.js";
 export * from "./refrigerator-alarm/index.js";
@@ -121,7 +118,6 @@ export * from "./time-synchronization/index.js";
 export * from "./total-volatile-organic-compounds-concentration-measurement/index.js";
 export * from "./unit-localization/index.js";
 export * from "./user-label/index.js";
-export * from "./valid-proxies/index.js";
 export * from "./valve-configuration-and-control/index.js";
 export * from "./wake-on-lan/index.js";
 export * from "./water-heater-management/index.js";

package/src/behaviors/joint-fabric-administrator/JointFabricAdministratorBehavior.ts

@@ -0,0 +1,27 @@
+/**
+ * @license
+ * Copyright 2022-2025 Matter.js Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+
+/*** THIS FILE IS GENERATED, DO NOT EDIT ***/
+
+import { JointFabricAdministrator } from "#clusters/joint-fabric-administrator";
+import { ClusterBehavior } from "../../behavior/cluster/ClusterBehavior.js";
+import { JointFabricAdministratorInterface } from "./JointFabricAdministratorInterface.js";
+import { Identity } from "#general";
+
+/**
+ * JointFabricAdministratorBehavior is the base class for objects that support interaction with
+ * {@link JointFabricAdministrator.Cluster}.
+ */
+export const JointFabricAdministratorBehaviorConstructor = ClusterBehavior
+    .withInterface<JointFabricAdministratorInterface>()
+    .for(JointFabricAdministrator.Cluster);
+
+export interface JointFabricAdministratorBehaviorConstructor extends Identity<typeof JointFabricAdministratorBehaviorConstructor> {}
+export const JointFabricAdministratorBehavior: JointFabricAdministratorBehaviorConstructor = JointFabricAdministratorBehaviorConstructor;
+export interface JointFabricAdministratorBehavior extends InstanceType<JointFabricAdministratorBehaviorConstructor> {}
+export namespace JointFabricAdministratorBehavior {
+    export interface State extends InstanceType<typeof JointFabricAdministratorBehavior.State> {}
+}

package/src/behaviors/joint-fabric-administrator/JointFabricAdministratorClient.ts

@@ -0,0 +1,15 @@
+/**
+ * @license
+ * Copyright 2022-2025 Matter.js Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+
+/*** THIS FILE IS GENERATED, DO NOT EDIT ***/
+
+import { JointFabricAdministratorBehavior } from "./JointFabricAdministratorBehavior.js";
+import { Identity } from "#general";
+
+export const JointFabricAdministratorClientConstructor = JointFabricAdministratorBehavior;
+export interface JointFabricAdministratorClient extends JointFabricAdministratorBehavior {}
+export interface JointFabricAdministratorClientConstructor extends Identity<typeof JointFabricAdministratorClientConstructor> {}
+export const JointFabricAdministratorClient: JointFabricAdministratorClientConstructor = JointFabricAdministratorClientConstructor;

package/src/behaviors/joint-fabric-administrator/JointFabricAdministratorInterface.ts

@@ -0,0 +1,94 @@
+/**
+ * @license
+ * Copyright 2022-2025 Matter.js Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+
+/*** THIS FILE IS GENERATED, DO NOT EDIT ***/
+
+import { MaybePromise } from "#general";
+import { JointFabricAdministrator } from "#clusters/joint-fabric-administrator";
+
+export namespace JointFabricAdministratorInterface {
+    export interface Base {
+        /**
+         * This command shall be generated during Joint Commissioning Method and subsequently be responded in the form
+         * of an ICACCSRResponse command.
+         *
+         * 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 this command is received from a peer against FabricFabric Table Vendor ID Verification Procedure hasn’t
+         * been executed then it shall fail with a JfVidNotVerified status code sent back to the initiator.
+         *
+         * If a prior AddICAC 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.
+         *
+         * @see {@link MatterSpecification.v141.Core} § 11.25.7.1
+         */
+        icaccsrRequest(): MaybePromise<JointFabricAdministrator.IcaccsrResponse>;
+
+        /**
+         * This command shall be generated and executed during Joint Commissioning Method and subsequently be responded
+         * in the form of an ICACResponse command.
+         *
+         * A Commissioner or Administrator shall issue this command after issuing the ICACCSRRequest command and
+         * receiving its response.
+         *
+         * A Commissioner or Administrator shall issue this command after performing the Attestation Procedure, Fabric
+         * Table VID Verification and after validating that the peer is authorized to act as an Administrator in its own
+         * Fabric.
+         *
+         * Check ICA Cross Signing for details about the generation of ICACValue.
+         *
+         * @see {@link MatterSpecification.v141.Core} § 11.25.7.3
+         */
+        addIcac(request: JointFabricAdministrator.AddIcacRequest): MaybePromise<JointFabricAdministrator.IcacResponse>;
+
+        /**
+         * > [!NOTE]
+         *
+         * > This is an alias onto the OpenCommissioningWindow command within the Joint Fabric Administrator Cluster.
+         *   Refer to the OpenCommissioningWindow command for a description of the command behavior and parameters.
+         *
+         * This command shall fail with a InvalidAdministratorFabricIndex status code sent back to the initiator if the
+         * AdministratorFabricIndex field has the value of null.
+         *
+         * The parameters for OpenJointCommissioningWindow command are as follows:
+         *
+         * @see {@link MatterSpecification.v141.Core} § 11.25.7.5
+         */
+        openJointCommissioningWindow(request: JointFabricAdministrator.OpenJointCommissioningWindowRequest): MaybePromise;
+
+        /**
+         * This command shall be sent by a candidate Joint Fabric Anchor Administrator to the current Joint Fabric
+         * Anchor Administrator to request transfer of the Anchor Fabric.
+         *
+         * @see {@link MatterSpecification.v141.Core} § 11.25.7.6
+         */
+        transferAnchorRequest(): MaybePromise<JointFabricAdministrator.TransferAnchorResponse>;
+
+        /**
+         * This command shall indicate the completion of the transfer of the Anchor Fabric to another Joint Fabric
+         * Ecosystem Administrator.
+         *
+         * @see {@link MatterSpecification.v141.Core} § 11.25.7.8
+         */
+        transferAnchorComplete(): MaybePromise;
+
+        /**
+         * This command shall be used for communicating to client the endpoint that holds the Joint Fabric Administrator
+         * Cluster.
+         *
+         * ### This field shall contain the unique identifier for the endpoint that holds the Joint Fabric Administrator
+         * Cluster.
+         *
+         * @see {@link MatterSpecification.v141.Core} § 11.25.7.9
+         */
+        announceJointFabricAdministrator(request: JointFabricAdministrator.AnnounceJointFabricAdministratorRequest): MaybePromise;
+    }
+}
+
+export type JointFabricAdministratorInterface = {
+    components: [{ flags: {}, methods: JointFabricAdministratorInterface.Base }]
+};

package/src/behaviors/{joint-fabric-pki/JointFabricPkiServer.ts → joint-fabric-administrator/JointFabricAdministratorServer.ts}

@@ -6,9 +6,9 @@
 
 /*** THIS FILE WILL BE REGENERATED IF YOU DO NOT REMOVE THIS MESSAGE ***/
 
-import { JointFabricPkiBehavior } from "./JointFabricPkiBehavior.js";
+import { JointFabricAdministratorBehavior } from "./JointFabricAdministratorBehavior.js";
 
 /**
- * This is the default server implementation of {@link JointFabricPkiBehavior}.
+ * This is the default server implementation of {@link JointFabricAdministratorBehavior}.
  */
-export class JointFabricPkiServer extends JointFabricPkiBehavior {}
+export class JointFabricAdministratorServer extends JointFabricAdministratorBehavior {}

package/src/behaviors/joint-fabric-administrator/index.ts

@@ -0,0 +1,12 @@
+/**
+ * @license
+ * Copyright 2022-2025 Matter.js Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+
+/*** THIS FILE WILL BE REGENERATED IF YOU DO NOT REMOVE THIS MESSAGE ***/
+
+export * from "./JointFabricAdministratorInterface.js";
+export * from "./JointFabricAdministratorBehavior.js";
+export * from "./JointFabricAdministratorServer.js";
+export * from "./JointFabricAdministratorClient.js";