@project-chip/matter.js 0.2.1 → 0.3.0

package/dist/cjs/cluster/OnOffCluster.js

@@ -1,42 +1,53 @@
 "use strict";
 /**
  * @license
- * Copyright 2022 Project CHIP Authors
+ * Copyright 2022-2023 Project CHIP Authors
  * SPDX-License-Identifier: Apache-2.0
  */
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.OnOffCluster = void 0;
-const Cluster_js_1 = require("./Cluster.js");
 const BitmapSchema_js_1 = require("../schema/BitmapSchema.js");
 const TlvBoolean_js_1 = require("../tlv/TlvBoolean.js");
+const TlvNoArguments_js_1 = require("../tlv/TlvNoArguments.js");
+const Cluster_js_1 = require("./Cluster.js");
 /** @see {@link MatterApplicationClusterSpecificationV1_0} § 1.5.7.4.2 */
-// const TlvEffectVariant = TlvUInt8 as TlvSchema<DyingLightEffectVariant | DelayedAllOffEffectVariant>;
+/*
+const TlvEffectVariant = TlvUInt8 as TlvSchema<DyingLightEffectVariant | DelayedAllOffEffectVariant>;
+*/
 /** @see {@link MatterApplicationClusterSpecificationV1_0} § 1.5.7.4 */
-/* const TlvOffWithEffectRequest = TlvObject({
+/*
+const TlvOffWithEffectRequest = TlvObject({
     effectIdentifier: TlvField(0, TlvEnum<OnOffEffectIdentifier>()),
     effectVariant: TlvField(1, TlvEffectVariant),
 }) as TlvSchema<
     { effectIdentifier: OnOffEffectIdentifier.DelayedAllOff, effectVariant: DelayedAllOffEffectVariant } |
     { effectIdentifier: OnOffEffectIdentifier.DyingLight, effectVariant: DyingLightEffectVariant }
-    >; */
+>;
+*/
 /** @see {@link MatterApplicationClusterSpecificationV1_0} § 1.5.7.4.2 */
-/* const TlvOnOffControlBitmap = TlvBitmap(TlvUInt8, {
-    acceptOnlyWhenOn: BitFlag(1),
-}) */
+/*
+const TlvOnOffControlBitmap = TlvBitmap(TlvUInt8, {
+    acceptOnlyWhenOn: BitFlag(0),
+});
+*/
 /** @see {@link MatterApplicationClusterSpecificationV1_0} § 1.5.7.6. */
-/* const TlvOnWithTimedOffRequest = TlvObject({
+/*
+const TlvOnWithTimedOffRequest = TlvObject({
     onOffControl: TlvField(0, TlvOnOffControlBitmap),
     onTime: TlvField(1, TlvNullable(TlvUInt8.bound({ min: 0, max: 254 }))),
     offWaitTime: TlvField(2, TlvNullable(TlvUInt8.bound({ min: 0, max: 254 }))),
-}); */
+});
+*/
 /**
  * Attributes and commands for switching devices between 'On' and 'Off' states.
  *
  * @see {@link MatterApplicationClusterSpecificationV1_0} § 1.5
  */
 exports.OnOffCluster = (0, Cluster_js_1.Cluster)({
+    // TODO create two cluster definitions ... One with set Lighting Flag and one without to make
+    //  Attributes and Comments correctly optional
     id: 0x06,
-    name: "On/Off",
+    name: "OnOff",
     revision: 4,
     features: {
         /** Level Control for Lighting - Behavior that supports lighting applications */
@@ -45,22 +56,30 @@ exports.OnOffCluster = (0, Cluster_js_1.Cluster)({
     /** @see {@link MatterApplicationClusterSpecificationV1_0} § 1.5.6 */
     attributes: {
         /** Indicates whether the device type implemented on the endpoint is turned off (false) or turned on (true). */
-        onOff: (0, Cluster_js_1.Attribute)(0, TlvBoolean_js_1.TlvBoolean, { default: false }), /* reportable: true, scene:true */
+        onOff: (0, Cluster_js_1.Attribute)(0, TlvBoolean_js_1.TlvBoolean, { persistent: true, default: false }), /* reportable: true, scene:true - Specs 1.0 wrong here, using chip XMLs*/
         // The following attributes are only needed for "Level Control for Lighting" support
-        /** Used to remember if a state is already storednin an old scene to not store one again when sending another Off command */
-        //globalSceneControl: OptionalAttribute(0x4000,  TlvBoolean, { default: true }),
         /**
+         * Mandatory Attribute when extended lightingLevelControl is used!
+         * Used to remember if a state is already stored in an old scene to not store one again when sending another Off command
+         */
+        //globalSceneControl: OptionalAttribute(0x4000, TlvBoolean, { default: true }),
+        /**
+         * Mandatory Attribute when extended lightingLevelControl is used!
          * Specifies the length of time (in 1/10ths second) that the ‘On’ state SHALL be maintained before
          * automatically transitioning to the ‘Off’ state when using the OnWithTimedOff command.
          */
-        //onTime: OptionalWritableAttribute(0x4001, TlvNullable(TlvUInt16)), { default: 0 }), /* unit: 1/10s */
+        //onTime: OptionalWritableAttribute(0x4001, TlvNullable(TlvUInt16), { default: 0 }), /* unit: 1/10s */
         /**
+         * Mandatory Attribute when extended lightingLevelControl is used!
          * Specifies the length of time (in 1/10ths second) that the ‘Off’ state SHALL be guarded to prevent
          * another OnWithTimedOff command turning the server back to its ‘On’ state
          */
         //offWaitTime: OptionalWritableAttribute(0x4002, TlvNullable(TlvUInt16), { default: 0 }), /* unit: 1/10s */
-        /** Defines the desired startup behavior of a device when it is supplied with power. */
-        //startUpOnOff: OptionalWritableAttribute(0x4003, TlvNullable(TlvEnum<StartUpOnOff>()), { writeAcl: AccessLevel.Manage }),
+        /**
+         * Mandatory Attribute when extended lightingLevelControl is used!
+         * Defines the desired startup behavior of a device when it is supplied with power.
+         */
+        //startUpOnOff: OptionalWritableAttribute(0x4003, TlvNullable(TlvEnum<StartUpOnOff>()), { persistent: true, writeAcl: AccessLevel.Manage }),
     },
     /** @see {@link MatterApplicationClusterSpecificationV1_0} § 1.5.7 */
     commands: {
@@ -69,13 +88,13 @@ exports.OnOffCluster = (0, Cluster_js_1.Cluster)({
          * recommended that it is used for power off or similar functions. On receipt of the Off command, the OnTime
          * attribute SHALL be set to 0.
          */
-        off: (0, Cluster_js_1.Command)(0, Cluster_js_1.TlvNoArguments, 0, Cluster_js_1.TlvNoResponse),
+        off: (0, Cluster_js_1.Command)(0, TlvNoArguments_js_1.TlvNoArguments, 0, Cluster_js_1.TlvNoResponse),
         /**
          * On receipt of this command, a device SHALL enter its ‘On’ state. This state is device dependent, but it is
          * recommended that it is used for power on or similar functions. On receipt of the On command, if the value
          * of the OnTime attribute is equal to 0, the device SHALL set the OffWaitTime attribute to 0.
          */
-        on: (0, Cluster_js_1.Command)(1, Cluster_js_1.TlvNoArguments, 1, Cluster_js_1.TlvNoResponse),
+        on: (0, Cluster_js_1.Command)(1, TlvNoArguments_js_1.TlvNoArguments, 1, Cluster_js_1.TlvNoResponse),
         /**
          * On receipt of this command, if a device is in its ‘Off’ state it SHALL enter its ‘On’ state. Otherwise,
          * if it is in its ‘On’ state it SHALL enter its ‘Off’ state. On receipt of the Toggle command, if the value
@@ -83,23 +102,26 @@ exports.OnOffCluster = (0, Cluster_js_1.Cluster)({
          * SHALL set the OffWaitTime attribute to 0. If the value of the OnOff attribute is equal to TRUE, the OnTime
          * attribute SHALL be set to 0.
          */
-        toggle: (0, Cluster_js_1.Command)(2, Cluster_js_1.TlvNoArguments, 2, Cluster_js_1.TlvNoResponse),
+        toggle: (0, Cluster_js_1.Command)(2, TlvNoArguments_js_1.TlvNoArguments, 2, Cluster_js_1.TlvNoResponse),
         // The following attributes are only needed for "Level Control for Lighting" support
         // So we declare them option for now!
         // TODO: Split these out into a separate Cluster Spec that adds "Level Control for Lighting" support
         /**
+         * Mandatory Command when extended lightingLevelControl is used!
          * The OffWithEffect command allows devices to be turned off using enhanced ways of fading.
          */
-        //offWithEffect: OptionalCommand(0x40, OffWithEffectRequestT, 0x40, NoResponseT),
+        //offWithEffect: OptionalCommand(0x40, TlvOffWithEffectRequest, 0x40, TlvNoResponse),
         /**
+         * Mandatory Command when extended lightingLevelControl is used!
          * The OnWithRecallGlobalScene command allows the recall of the settings when the device was turned off.
          */
-        //onWithRecallGlobalScene: OptionalCommand(0x41, NoArgumentsT, 0x41, NoResponseT),
+        //onWithRecallGlobalScene: OptionalCommand(0x41, TlvNoArguments, 0x41, TlvNoResponse),
         /**
+         * Mandatory Command when extended lightingLevelControl is used!
          * The OnWithTimedOff command allows devices to be turned on for a specific duration with a guarded off
          * duration so that SHOULD the device be subsequently switched off, further OnWithTimedOff commands, received
          * during this time, are prevented from turning the devices back on.
          */
-        //onWithTimedOff: OptionalCommand(0x42, OnWithTimedOffRequestT, 0x42, NoResponseT),
+        //onWithTimedOff: OptionalCommand(0x42, TlvOnWithTimedOffRequest, 0x42, TlvNoResponse),
     },
 });

package/dist/{dts → cjs}/cluster/OperationalCredentialsCluster.d.ts

@@ -1,9 +1,10 @@
 /**
  * @license
- * Copyright 2022 Project CHIP Authors
+ * Copyright 2022-2023 Project CHIP Authors
  * SPDX-License-Identifier: Apache-2.0
  */
 import { Attribute, Cluster, Command } from "./Cluster.js";
+import { FabricIndex } from "../datatype/FabricIndex.js";
 /** @see {@link MatterCoreSpecificationV1_0} § 11.17.5.1 */
 export declare const RESP_MAX = 900;
 /**
@@ -12,13 +13,13 @@ export declare const RESP_MAX = 900;
  *
  * @see {@link MatterCoreSpecificationV1_0} § 11.17.5.8 */
 export declare const enum CertificateChainType {
-    /** Requests the DER-encoded DAC certificate */
+    /** Request the DER- encoded DAC certificate */
     DeviceAttestation = 1,
-    /** Requests the DER-encoded PAI certificate */
+    /** Request the DER- encoded PAI certificate */
     ProductAttestationIntermediate = 2
 }
 /**
- * Used by the NOCResponse common response command to convey detailed outcome of several of this cluster’s operations.
+ * Used by the NOCResponse datatype response command to convey detailed outcome of several of this cluster’s operations.
  *
  * @see {@link MatterCoreSpecificationV1_0} § 11.17.5.9 */
 export declare const enum OperationalCertStatus {
@@ -64,85 +65,99 @@ export declare const TlvCertSigningRequest: import("../tlv/TlvObject.js").Object
  *
  * @see {@link MatterCoreSpecificationV1_0} § 11.17
  */
-export declare const OperationalCredentialsCluster: Cluster<import("../matter.js").BitSchema, {
+export declare const OperationalCredentialsCluster: Cluster<import("../schema/BitmapSchema.js").BitSchema, {
     nocs: Attribute<{
         noc: Uint8Array;
         icac: Uint8Array | null;
     }[]>;
     fabrics: Attribute<{
-        label: string;
-        vendorId: import("../common/VendorId.js").VendorId;
+        fabricId: import("../datatype/FabricId.js").FabricId;
+        nodeId: import("../datatype/NodeId.js").NodeId;
+        vendorId: import("../datatype/VendorId.js").VendorId;
+        fabricIndex: FabricIndex;
         rootPublicKey: Uint8Array;
-        fabricId: import("../common/FabricId.js").FabricId;
-        nodeId: import("../common/NodeId.js").NodeId;
+        label: string;
     }[]>;
     supportedFabrics: Attribute<number>;
     commissionedFabrics: Attribute<number>;
     trustedRootCertificates: Attribute<Uint8Array[]>;
-    currentFabricIndex: Attribute<number>;
+    currentFabricIndex: Attribute<FabricIndex>;
     clusterRevision: Attribute<number>;
-    featureMap: Attribute<import("../matter.js").TypeFromBitSchema<import("../matter.js").BitSchema>>;
+    featureMap: Attribute<import("../schema/BitmapSchema.js").TypeFromBitSchema<import("../schema/BitmapSchema.js").BitSchema>>;
+    attributeList: Attribute<import("../datatype/AttributeId.js").AttributeId[]>;
+    eventList: Attribute<import("../datatype/EventId.js").EventId[]>;
+    acceptedCommandList: Attribute<import("../datatype/CommandId.js").CommandId[]>;
+    generatedCommandList: Attribute<import("../datatype/CommandId.js").CommandId[]>;
 }, {
-    /** Requests attestation information. */
+    /** Sender is requesting attestation information from the receiver. */
     requestAttestation: Command<{
         attestationNonce: Uint8Array;
     }, {
-        elements: Uint8Array;
         signature: Uint8Array;
+        elements: Uint8Array;
     }>;
-    /** Requests a device attestation certificate. */
+    /** Sender is requesting a device attestation certificate from the receiver. */
     requestCertChain: Command<{
         type: CertificateChainType;
     }, {
         certificate: Uint8Array;
     }>;
-    /** Requests a certificate signing request (CSR). */
+    /** Sender is requesting a certificate signing request (CSR) from the receiver. */
     requestCertSigning: Command<{
         certSigningRequestNonce: Uint8Array;
         isForUpdateNOC?: boolean | undefined;
     }, {
-        elements: Uint8Array;
         signature: Uint8Array;
+        elements: Uint8Array;
     }>;
-    /** Adds new node operational certificates. */
+    /** Sender is requesting to add the new node operational certificates. */
     addOperationalCert: Command<{
-        operationalCert: Uint8Array;
         identityProtectionKey: Uint8Array;
-        caseAdminNode: import("../common/NodeId.js").NodeId;
-        adminVendorId: import("../common/VendorId.js").VendorId;
+        operationalCert: Uint8Array;
+        adminVendorId: import("../datatype/VendorId.js").VendorId;
+        caseAdminNode: import("../datatype/NodeId.js").NodeId;
         intermediateCaCert?: Uint8Array | undefined;
     }, {
         status: OperationalCertStatus;
-        fabricIndex?: import("../common/FabricIndex.js").FabricIndex | undefined;
+        fabricIndex?: FabricIndex | undefined;
         debugText?: string | undefined;
     }>;
-    /** Updates the node operational certificates. */
+    /** Sender is requesting to update the node operational certificates. */
     updateOperationalCert: Command<{
         operationalCert: Uint8Array;
         intermediateCaCert?: Uint8Array | undefined;
     }, {
         status: OperationalCertStatus;
-        fabricIndex?: import("../common/FabricIndex.js").FabricIndex | undefined;
+        fabricIndex?: FabricIndex | undefined;
         debugText?: string | undefined;
     }>;
-    /** Sets the user-visible Label field for a given Fabric. */
+    /**
+     * This command SHALL be used by an Administrative Node to set the user-visible Label field for a given
+     * Fabric, as reflected by entries in the Fabrics attribute.
+     */
     updateFabricLabel: Command<{
         label: string;
     }, {
         status: OperationalCertStatus;
-        fabricIndex?: import("../common/FabricIndex.js").FabricIndex | undefined;
+        fabricIndex?: FabricIndex | undefined;
         debugText?: string | undefined;
     }>;
-    /** Removes a given fabric index and delete all associated fabric-scoped data. */
+    /**
+     * This command is used by Administrative Nodes to remove a given fabric index and delete all associated
+     * fabric-scoped data.
+     */
     removeFabric: Command<{
-        fabricIndex: import("../common/FabricIndex.js").FabricIndex;
+        fabricIndex: FabricIndex;
     }, {
         status: OperationalCertStatus;
-        fabricIndex?: import("../common/FabricIndex.js").FabricIndex | undefined;
+        fabricIndex?: FabricIndex | undefined;
         debugText?: string | undefined;
     }>;
-    /** Adds a Trusted Root CA Certificate, provided as its CHIP Certificate representation. */
+    /**
+     * This command SHALL add a Trusted Root CA Certificate, provided as its CHIP Certificate representation.
+     */
     addRootCert: Command<{
         certificate: Uint8Array;
     }, void>;
 }, import("./Cluster.js").Events>;
+//# sourceMappingURL=OperationalCredentialsCluster.d.ts.map

package/dist/cjs/cluster/OperationalCredentialsCluster.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"OperationalCredentialsCluster.d.ts","sourceRoot":"","sources":["../../../src/cluster/OperationalCredentialsCluster.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAe,SAAS,EAAE,OAAO,EAAE,OAAO,EAAiB,MAAM,cAAc,CAAC;AAMvF,OAAO,EAAE,WAAW,EAAkB,MAAM,4BAA4B,CAAC;AAUzE,2DAA2D;AAC3D,eAAO,MAAM,QAAQ,MAAM,CAAC;AAwC5B;;;;0DAI0D;AAC1D,0BAAkB,oBAAoB;IAClC,+CAA+C;IAC/C,iBAAiB,IAAI;IAErB,+CAA+C;IAC/C,8BAA8B,IAAI;CACrC;AAuFD;;;0DAG0D;AAC1D,0BAAkB,qBAAqB;IACnC,oBAAoB;IACpB,OAAO,IAAO;IAEd,wEAAwE;IACxE,gBAAgB,IAAO;IAEvB,qEAAqE;IACrE,eAAe,IAAO;IAEtB,+CAA+C;IAC/C,sBAAsB,IAAO;IAE7B,6DAA6D;IAC7D,UAAU,IAAO;IAEjB,+CAA+C;IAC/C,SAAS,IAAO;IAEhB,4DAA4D;IAC5D,mBAAmB,IAAO;IAE1B,wEAAwE;IACxE,cAAc,IAAO;IAErB,8CAA8C;IAC9C,aAAa,KAAO;IAEpB,uCAAuC;IACvC,kBAAkB,KAAO;CAC5B;AAcD,2DAA2D;AAC3D,eAAO,MAAM,cAAc;;;;;EAKzB,CAAC;AAEH,2DAA2D;AAC3D,eAAO,MAAM,qBAAqB;;;;;;EAMhC,CAAC;AAcH;;;;;GAKG;AACH,eAAO,MAAM,6BAA6B;;;;;;;;;;;;;;;;;;;;;;;;IA4BlC,sEAAsE;;;;;;;IAGtE,+EAA+E;;;;;;IAG/E,kFAAkF;;;;;;;;IAGlF,yEAAyE;;;;;;;;;;;;IAGzE,wEAAwE;;;;;;;;;IAGxE;;;OAGG;;;;;;;;IAGH;;;OAGG;;;;;;;;IAGH;;OAEG;;;;iCAGT,CAAC"}

package/dist/cjs/cluster/OperationalCredentialsCluster.js

@@ -1,23 +1,24 @@
 "use strict";
 /**
  * @license
- * Copyright 2022 Project CHIP Authors
+ * Copyright 2022-2023 Project CHIP Authors
  * SPDX-License-Identifier: Apache-2.0
  */
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.OperationalCredentialsCluster = exports.TlvCertSigningRequest = exports.TlvAttestation = exports.RESP_MAX = void 0;
-const VendorId_js_1 = require("../common/VendorId.js");
-const NodeId_js_1 = require("../common/NodeId.js");
-const SubjectId_js_1 = require("../common/SubjectId.js");
-const FabricId_js_1 = require("../common/FabricId.js");
-const FabricIndex_js_1 = require("../common/FabricIndex.js");
 const Cluster_js_1 = require("./Cluster.js");
 const TlvObject_js_1 = require("../tlv/TlvObject.js");
 const TlvString_js_1 = require("../tlv/TlvString.js");
+const VendorId_js_1 = require("../datatype/VendorId.js");
+const FabricId_js_1 = require("../datatype/FabricId.js");
+const NodeId_js_1 = require("../datatype/NodeId.js");
+const FabricIndex_js_1 = require("../datatype/FabricIndex.js");
 const TlvNullable_js_1 = require("../tlv/TlvNullable.js");
 const TlvBoolean_js_1 = require("../tlv/TlvBoolean.js");
 const TlvNumber_js_1 = require("../tlv/TlvNumber.js");
+const SubjectId_js_1 = require("../datatype/SubjectId.js");
 const TlvArray_js_1 = require("../tlv/TlvArray.js");
+// TODO: Rename to NodeOperationalCredentialsCluster to match with specs
 /** @see {@link MatterCoreSpecificationV1_0} § 11.17.5.1 */
 exports.RESP_MAX = 900;
 /**
@@ -26,16 +27,18 @@ exports.RESP_MAX = 900;
  * @see {@link MatterCoreSpecificationV1_0} § 11.17.5.3
  */
 const TlvFabricDescriptor = (0, TlvObject_js_1.TlvObject)({
-    /** The public key for the trusted root that scopes the fabric referenced by FabricIndex and its associated operational credential. */
+    /** Contains the public key for the trusted root that scopes the fabric referenced by FabricIndex and its associated operational credential. */
     rootPublicKey: (0, TlvObject_js_1.TlvField)(1, TlvString_js_1.TlvByteString.bound({ length: 65 })),
-    /** The value of AdminVendorID provided in the AddNOC command that led to the creation of this FabricDescriptorStruct. */
+    /** Contains the value of AdminVendorID provided in the AddNOC command that led to the creation of this FabricDescriptorStruct. */
     vendorId: (0, TlvObject_js_1.TlvField)(2, VendorId_js_1.TlvVendorId),
-    /** The FabricID allocated to the fabric referenced by FabricIndex. */
+    /** Contains the FabricID allocated to the fabric referenced by FabricIndex. */
     fabricId: (0, TlvObject_js_1.TlvField)(3, FabricId_js_1.TlvFabricId),
-    /** The NodeID in use within the fabric referenced by FabricIndex. */
+    /** Contain the NodeID in use within the fabric referenced by FabricIndex. */
     nodeId: (0, TlvObject_js_1.TlvField)(4, NodeId_js_1.TlvNodeId),
-    /** A commissioner-set label for the fabric referenced by FabricIndex. */
-    label: (0, TlvObject_js_1.TlvField)(5, TlvString_js_1.TlvString.bound({ maxLength: 32 })), /* default: "" */
+    /** Contains a commissioner-set label for the fabric referenced by FabricIndex. */
+    label: (0, TlvObject_js_1.TlvField)(5, TlvString_js_1.TlvString.bound({ maxLength: 32 })),
+    // TODO: this data is scoped in the fabric context and should be marked as such
+    fabricIndex: (0, TlvObject_js_1.TlvField)(0xfe, FabricIndex_js_1.TlvFabricIndex),
 });
 /**
  * Encodes a fabric sensitive NOC chain, underpinning a commissioned Operational Identity for a given Node.
@@ -43,83 +46,86 @@ const TlvFabricDescriptor = (0, TlvObject_js_1.TlvObject)({
  * @see {@link MatterCoreSpecificationV1_0} § 11.17.5.2
  */
 const TlvNoc = (0, TlvObject_js_1.TlvObject)({
-    /** The NOC for the struct's associated fabric. */
+    /** Contains the NOC for the struct’s associated fabric. */
     noc: (0, TlvObject_js_1.TlvField)(1, TlvString_js_1.TlvByteString.bound({ maxLength: 400 })),
-    /** The ICAC or the struct's associated fabric. */
-    icac: (0, TlvObject_js_1.TlvField)(2, (0, TlvNullable_js_1.TlvNullable)(TlvString_js_1.TlvByteString.bound({ maxLength: 400 }))), /* default(not present): null */
+    /** Contains the ICAC or the struct’s associated fabric. */
+    icac: (0, TlvObject_js_1.TlvField)(2, (0, TlvNullable_js_1.TlvNullable)(TlvString_js_1.TlvByteString.bound({ maxLength: 400 }))), /* default(not present): null, fabricSensitive: true */
 });
 /** @see {@link MatterCoreSpecificationV1_0} § 11.17.7.1 */
 const TlvAttestationRequest = (0, TlvObject_js_1.TlvObject)({
-    /** The attestation nonce to be used in the computation of the Attestation Information. */
+    /** Contains the attestation nonce to be used in the computation of the Attestation Information. */
     attestationNonce: (0, TlvObject_js_1.TlvField)(0, TlvString_js_1.TlvByteString.bound({ length: 32 })),
 });
 /** @see {@link MatterCoreSpecificationV1_0} § 11.17.7.2 */
 const TlvAttestationResponse = (0, TlvObject_js_1.TlvObject)({
-    /** The octet string of the serialized attestation_elements_message. */
+    /** Contains the octet string of the serialized attestation_elements_message. */
     elements: (0, TlvObject_js_1.TlvField)(0, TlvString_js_1.TlvByteString.bound({ maxLength: exports.RESP_MAX })),
-    /** The octet string of the necessary attestation_signature. */
+    /** Contains the octet string of the necessary attestation_signature. */
     signature: (0, TlvObject_js_1.TlvField)(1, TlvString_js_1.TlvByteString.bound({ length: 64 })),
 });
 /** @see {@link MatterCoreSpecificationV1_0} § 11.17.7.5 */
 const TlvCertSigningRequestRequest = (0, TlvObject_js_1.TlvObject)({
-    /** The CSRNonce to be used in the computation of the NOCSR information. */
+    /** Contains the CSRNonce to be used in the computation of the NOCSR information. */
     certSigningRequestNonce: (0, TlvObject_js_1.TlvField)(0, TlvString_js_1.TlvByteString.bound({ length: 32 })),
     /**
      * If set to true, the internal state of the CSR associated keypair 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.
+     * subsequent AddNOC
      * */
     isForUpdateNOC: (0, TlvObject_js_1.TlvOptionalField)(1, TlvBoolean_js_1.TlvBoolean), /* default: false */
 });
 /** @see {@link MatterCoreSpecificationV1_0} § 11.17.7.6 */
 const TlvCertSigningRequestResponse = (0, TlvObject_js_1.TlvObject)({
-    /** The octet string of the serialized nocsr_elements_message. */
+    /** Contains the octet string of the serialized nocsr_elements_message. */
     elements: (0, TlvObject_js_1.TlvField)(0, TlvString_js_1.TlvByteString.bound({ maxLength: exports.RESP_MAX })),
-    /** The octet string of the necessary attestation_signature. */
+    /** Contains the octet string of the necessary attestation_signature. */
     signature: (0, TlvObject_js_1.TlvField)(1, TlvString_js_1.TlvByteString.bound({ length: 64 })),
 });
 /** @see {@link MatterCoreSpecificationV1_0} § 11.17.7.3 */
 const TlvCertChainRequest = (0, TlvObject_js_1.TlvObject)({
-    /** The type of certificate to be requested. */
+    /** Contains the type of certificate to be requested. */
     type: (0, TlvObject_js_1.TlvField)(0, (0, TlvNumber_js_1.TlvEnum)()),
 });
 /** @see {@link MatterCoreSpecificationV1_0} § 11.17.7.4 */
 const TlvCertChainResponse = (0, TlvObject_js_1.TlvObject)({
-    /** The octet string of the requested certificate. */
+    /** Contains the octet string of the requested certificate. */
     certificate: (0, TlvObject_js_1.TlvField)(0, TlvString_js_1.TlvByteString.bound({ maxLength: 600 })),
 });
 /** @see {@link MatterCoreSpecificationV1_0} § 11.17.7.8 */
 const TlvAddNocRequest = (0, TlvObject_js_1.TlvObject)({
-    /** The Node Operational Certificate (NOC) to be added. */
+    /** Contains the Node Operational Certificate (NOC) to be added. */
     operationalCert: (0, TlvObject_js_1.TlvField)(0, TlvString_js_1.TlvByteString.bound({ maxLength: 400 })),
-    /** The Intermediate CA Certificate (ICAC). */
+    /** Contains the Intermediate CA Certificate (ICAC). */
     intermediateCaCert: (0, TlvObject_js_1.TlvOptionalField)(1, TlvString_js_1.TlvByteString.bound({ maxLength: 400 })),
-    /** The value of the Epoch Key for the Identity Protection Key (IPK). */
+    /** Contains the value of the Epoch Key for the Identity Protection Key (IPK) to set for the Fabric which is to be added. */
     identityProtectionKey: (0, TlvObject_js_1.TlvField)(2, TlvString_js_1.TlvByteString.bound({ length: 16 })),
-    /** That Subject will have administration access on this node. */
+    /**
+     * Used to atomically add an Access Control Entry enabling that Subject to subsequently administer
+     * the Node whose operational identity is being added by this command.
+     */
     caseAdminNode: (0, TlvObject_js_1.TlvField)(3, SubjectId_js_1.TlvSubjectId),
-    /** The Vendor ID of the entity issuing the AddNOC command. */
+    /** Contains the Vendor ID of the entity issuing the AddNOC command. */
     adminVendorId: (0, TlvObject_js_1.TlvField)(4, VendorId_js_1.TlvVendorId),
 });
 /** @see {@link MatterCoreSpecificationV1_0} § 11.17.7.9 */
 const TlvUpdateNocRequest = (0, TlvObject_js_1.TlvObject)({
-    /** The Node Operational Certificate (NOC). */
+    /** Contains the Node Operational Certificate (NOC). */
     operationalCert: (0, TlvObject_js_1.TlvField)(0, TlvString_js_1.TlvByteString.bound({ maxLength: 400 })),
-    /** The Intermediate CA Certificate (ICAC). */
+    /** Contains the Intermediate CA Certificate (ICAC). */
     intermediateCaCert: (0, TlvObject_js_1.TlvOptionalField)(1, TlvString_js_1.TlvByteString.bound({ maxLength: 400 })),
 });
 /** @see {@link MatterCoreSpecificationV1_0} § 11.17.7.13 */
 const TlvAddTrustedRootCertificateRequest = (0, TlvObject_js_1.TlvObject)({
-    /** The Trusted Root Certificate (TRC) to be added. */
+    /** Contains the Trusted Root Certificate (TRC) to be added. */
     certificate: (0, TlvObject_js_1.TlvField)(0, TlvString_js_1.TlvByteString.bound({ maxLength: 400 })),
 });
 /** @see {@link MatterCoreSpecificationV1_0} § 11.17.7.10 */
 const TlvOperationalCertificateStatusResponse = (0, TlvObject_js_1.TlvObject)({
-    /** A NOCStatus value representing the status of an operation involving a NOC. */
+    /** Contains a NOCStatus value representing the status of an operation involving a NOC. */
     status: (0, TlvObject_js_1.TlvField)(0, (0, TlvNumber_js_1.TlvEnum)()),
     /** When action was successful, contains the Fabric Index of the Fabric last added, removed or updated. */
     fabricIndex: (0, TlvObject_js_1.TlvOptionalField)(1, FabricIndex_js_1.TlvFabricIndex),
-    /** Optional debugging textual information from the cluster implementation and should be visible in logs, not User UI */
+    /** Optionally contains debugging textual information from the cluster implementation and should be visible in logs, not User UI */
     debugText: (0, TlvObject_js_1.TlvOptionalField)(2, TlvString_js_1.TlvString.bound({ maxLength: 128 })),
 });
 /** @see {@link MatterCoreSpecificationV1_0} § 11.17.5.4 */
@@ -139,12 +145,12 @@ exports.TlvCertSigningRequest = (0, TlvObject_js_1.TlvObject)({
 });
 /** @see {@link MatterCoreSpecificationV1_0} § 11.17.7.11 */
 const TlvUpdateFabricLabelRequest = (0, TlvObject_js_1.TlvObject)({
-    /** The label to set for the fabric associated with the current secure session. */
+    /** Contains the label to set for the fabric associated with the current secure session. */
     label: (0, TlvObject_js_1.TlvField)(0, TlvString_js_1.TlvString32max),
 });
 /** @see {@link MatterCoreSpecificationV1_0} § 11.17.7.12 */
 const TlvRemoveFabricRequest = (0, TlvObject_js_1.TlvObject)({
-    /** The Fabric Index reference associated with the Fabric which is to be removed from the device. */
+    /** Contains the Fabric Index reference associated with the Fabric which is to be removed from the device. */
     fabricIndex: (0, TlvObject_js_1.TlvField)(0, FabricIndex_js_1.TlvFabricIndex),
 });
 /**
@@ -155,40 +161,48 @@ const TlvRemoveFabricRequest = (0, TlvObject_js_1.TlvObject)({
  */
 exports.OperationalCredentialsCluster = (0, Cluster_js_1.Cluster)({
     id: 0x3e,
-    name: "Operational Credentials",
+    name: "OperationalCredentials",
     revision: 1,
     /** @see {@link MatterCoreSpecificationV1_0} § 11.17.6 */
     attributes: {
-        /** All NOCs applicable to this Node. */
-        nocs: (0, Cluster_js_1.Attribute)(0, (0, TlvArray_js_1.TlvArray)(TlvNoc), { readAcl: 2 /* AccessLevel.Administer */ }),
-        /** Lists all fabrics to which this Node is commissioned. */
-        fabrics: (0, Cluster_js_1.Attribute)(1, (0, TlvArray_js_1.TlvArray)(TlvFabricDescriptor)),
-        /** The number of Fabrics that are supported by the device. */
+        /** Contains all NOCs applicable to this Node. */
+        nocs: (0, Cluster_js_1.Attribute)(0, (0, TlvArray_js_1.TlvArray)(TlvNoc), { persistent: true, omitChanges: true, readAcl: 2 /* AccessLevel.Administer */ }),
+        /** Describes all fabrics to which this Node is commissioned. */
+        fabrics: (0, Cluster_js_1.Attribute)(1, (0, TlvArray_js_1.TlvArray)(TlvFabricDescriptor), { persistent: true }),
+        /** Contains the number of Fabrics that are supported by the device. */
         supportedFabrics: (0, Cluster_js_1.Attribute)(2, TlvNumber_js_1.TlvUInt8.bound({ min: 5, max: 254 })),
-        /** The number of Fabrics to which the device is currently commissioned. */
-        commissionedFabrics: (0, Cluster_js_1.Attribute)(3, TlvNumber_js_1.TlvUInt8),
-        /** A read-only list of Trusted Root CA Certificates installed on the Node. */
-        trustedRootCertificates: (0, Cluster_js_1.Attribute)(4, (0, TlvArray_js_1.TlvArray)(TlvString_js_1.TlvByteString, { maxLength: 400 })),
-        /** Accessing fabric index. */
-        currentFabricIndex: (0, Cluster_js_1.Attribute)(5, TlvNumber_js_1.TlvUInt8),
+        /** Contains the number of Fabrics to which the device is currently commissioned. */
+        commissionedFabrics: (0, Cluster_js_1.Attribute)(3, TlvNumber_js_1.TlvUInt8, { persistent: true }),
+        /** Contains a read-only list of Trusted Root CA Certificates installed on the Node. */
+        trustedRootCertificates: (0, Cluster_js_1.Attribute)(4, (0, TlvArray_js_1.TlvArray)(TlvString_js_1.TlvByteString, { maxLength: 400 }), { persistent: true, omitChanges: true }),
+        /** Contains accessing fabric index. */
+        currentFabricIndex: (0, Cluster_js_1.Attribute)(5, FabricIndex_js_1.TlvFabricIndex, { default: new FabricIndex_js_1.FabricIndex(0) }),
     },
     /** @see {@link MatterCoreSpecificationV1_0} § 11.17.7 */
     commands: {
-        /** Requests attestation information. */
+        /** Sender is requesting attestation information from the receiver. */
         requestAttestation: (0, Cluster_js_1.Command)(0, TlvAttestationRequest, 1, TlvAttestationResponse),
-        /** Requests a device attestation certificate. */
+        /** Sender is requesting a device attestation certificate from the receiver. */
         requestCertChain: (0, Cluster_js_1.Command)(2, TlvCertChainRequest, 3, TlvCertChainResponse),
-        /** Requests a certificate signing request (CSR). */
+        /** Sender is requesting a certificate signing request (CSR) from the receiver. */
         requestCertSigning: (0, Cluster_js_1.Command)(4, TlvCertSigningRequestRequest, 5, TlvCertSigningRequestResponse),
-        /** Adds new node operational certificates. */
+        /** Sender is requesting to add the new node operational certificates. */
         addOperationalCert: (0, Cluster_js_1.Command)(6, TlvAddNocRequest, 8, TlvOperationalCertificateStatusResponse),
-        /** Updates the node operational certificates. */
+        /** Sender is requesting to update the node operational certificates. */
         updateOperationalCert: (0, Cluster_js_1.Command)(7, TlvUpdateNocRequest, 8, TlvOperationalCertificateStatusResponse),
-        /** Sets the user-visible Label field for a given Fabric. */
+        /**
+         * This command SHALL be used by an Administrative Node to set the user-visible Label field for a given
+         * Fabric, as reflected by entries in the Fabrics attribute.
+         */
         updateFabricLabel: (0, Cluster_js_1.Command)(9, TlvUpdateFabricLabelRequest, 8, TlvOperationalCertificateStatusResponse),
-        /** Removes a given fabric index and delete all associated fabric-scoped data. */
+        /**
+         * This command is used by Administrative Nodes to remove a given fabric index and delete all associated
+         * fabric-scoped data.
+         */
         removeFabric: (0, Cluster_js_1.Command)(10, TlvRemoveFabricRequest, 8, TlvOperationalCertificateStatusResponse),
-        /** Adds a Trusted Root CA Certificate, provided as its CHIP Certificate representation. */
+        /**
+         * This command SHALL add a Trusted Root CA Certificate, provided as its CHIP Certificate representation.
+         */
         addRootCert: (0, Cluster_js_1.Command)(11, TlvAddTrustedRootCertificateRequest, 11, Cluster_js_1.TlvNoResponse),
     },
 });