@matter/types 0.12.6-alpha.0-20250304-03716637c → 0.13.0-alpha.0-20250307-ebf84a05a

package/src/clusters/commissioner-control.ts

@@ -0,0 +1,282 @@
+/**
+ * @license
+ * Copyright 2022-2025 Matter.js Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+
+/*** THIS FILE IS GENERATED, DO NOT EDIT ***/
+
+import { MutableCluster } from "../cluster/mutation/MutableCluster.js";
+import { Attribute, Command, TlvNoResponse, Event, EventPriority } from "../cluster/Cluster.js";
+import { BitFlag } from "../schema/BitmapSchema.js";
+import { TlvUInt32, TlvBitmap, TlvUInt64, TlvUInt16, TlvEnum } from "../tlv/TlvNumber.js";
+import { AccessLevel } from "#model";
+import { TlvField, TlvOptionalField, TlvObject } from "../tlv/TlvObject.js";
+import { TlvVendorId } from "../datatype/VendorId.js";
+import { TlvString, TlvByteString } from "../tlv/TlvString.js";
+import { TypeFromSchema } from "../tlv/TlvSchema.js";
+import { TlvNodeId } from "../datatype/NodeId.js";
+import { Status } from "../globals/Status.js";
+import { TlvFabricIndex } from "../datatype/FabricIndex.js";
+import { Identity } from "#general";
+import { ClusterRegistry } from "../cluster/ClusterRegistry.js";
+
+export namespace CommissionerControl {
+    /**
+     * @see {@link MatterSpecification.v13.Core} § 11.26.4.1
+     */
+    export const SupportedDeviceCategory = {
+        /**
+         * Aggregators which support Fabric Synchronization may be commissioned.
+         *
+         * The FabricSynchronization bit shall be set to 1 if and only if the server supports commissioning nodes that
+         * support Fabric Synchronization.
+         *
+         * @see {@link MatterSpecification.v13.Core} § 11.26.4.1.1
+         */
+        fabricSynchronization: BitFlag(0)
+    };
+
+    /**
+     * Input to the CommissionerControl requestCommissioningApproval command
+     *
+     * @see {@link MatterSpecification.v13.Core} § 11.26.6.1
+     */
+    export const TlvRequestCommissioningApprovalRequest = TlvObject({
+        requestId: TlvField(0, TlvUInt64),
+        vendorId: TlvField(1, TlvVendorId),
+        productId: TlvField(2, TlvUInt16),
+        label: TlvOptionalField(3, TlvString.bound({ maxLength: 64 }))
+    });
+
+    /**
+     * Input to the CommissionerControl requestCommissioningApproval command
+     *
+     * @see {@link MatterSpecification.v13.Core} § 11.26.6.1
+     */
+    export interface RequestCommissioningApprovalRequest extends TypeFromSchema<typeof TlvRequestCommissioningApprovalRequest> {}
+
+    /**
+     * Input to the CommissionerControl commissionNode command
+     *
+     * @see {@link MatterSpecification.v13.Core} § 11.26.6.5
+     */
+    export const TlvCommissionNodeRequest = TlvObject({
+        requestId: TlvField(0, TlvUInt64),
+        responseTimeoutSeconds: TlvField(1, TlvUInt16.bound({ min: 30, max: 120 }))
+    });
+
+    /**
+     * Input to the CommissionerControl commissionNode command
+     *
+     * @see {@link MatterSpecification.v13.Core} § 11.26.6.5
+     */
+    export interface CommissionNodeRequest extends TypeFromSchema<typeof TlvCommissionNodeRequest> {}
+
+    /**
+     * When received within the timeout specified by ResponseTimeoutSeconds in the CommissionNode command, the client
+     * shall open a commissioning window on a node which matches the VendorID and ProductID provided in the associated
+     * RequestCommissioningApproval command.
+     *
+     * When commissioning this node, the server shall check that the VendorID and ProductID fields provided in the
+     * RequestCommissioningApproval command match the VendorID and ProductID attributes of the Basic Information
+     * Cluster which have already been verified during the Device Attestation Procedure. If they do not match, the
+     * server shall NOT complete commissioning and SHOULD indicate an error to the user.
+     *
+     * NOTE
+     *
+     * This is an alias onto the Open Commissioning Window command within the Administrator Commissioning Cluster.
+     * Refer to the Open Commissioning Window command for a description of the command behavior and parameters.
+     *
+     * The parameters for ReverseOpenCommissioningWindow command are as follows:
+     *
+     * @see {@link MatterSpecification.v13.Core} § 11.26.6.8
+     */
+    export const TlvReverseOpenCommissioningWindowResponse = TlvObject({
+        commissioningTimeout: TlvField(0, TlvUInt16),
+        pakePasscodeVerifier: TlvField(1, TlvByteString),
+        discriminator: TlvField(2, TlvUInt16.bound({ max: 4095 })),
+        iterations: TlvField(3, TlvUInt32.bound({ min: 1000, max: 100000 })),
+        salt: TlvField(4, TlvByteString.bound({ minLength: 16, maxLength: 32 }))
+    });
+
+    /**
+     * When received within the timeout specified by ResponseTimeoutSeconds in the CommissionNode command, the client
+     * shall open a commissioning window on a node which matches the VendorID and ProductID provided in the associated
+     * RequestCommissioningApproval command.
+     *
+     * When commissioning this node, the server shall check that the VendorID and ProductID fields provided in the
+     * RequestCommissioningApproval command match the VendorID and ProductID attributes of the Basic Information
+     * Cluster which have already been verified during the Device Attestation Procedure. If they do not match, the
+     * server shall NOT complete commissioning and SHOULD indicate an error to the user.
+     *
+     * NOTE
+     *
+     * This is an alias onto the Open Commissioning Window command within the Administrator Commissioning Cluster.
+     * Refer to the Open Commissioning Window command for a description of the command behavior and parameters.
+     *
+     * The parameters for ReverseOpenCommissioningWindow command are as follows:
+     *
+     * @see {@link MatterSpecification.v13.Core} § 11.26.6.8
+     */
+    export interface ReverseOpenCommissioningWindowResponse extends TypeFromSchema<typeof TlvReverseOpenCommissioningWindowResponse> {}
+
+    /**
+     * Body of the CommissionerControl commissioningRequestResult event
+     *
+     * @see {@link MatterSpecification.v13.Core} § 11.26.7.1
+     */
+    export const TlvCommissioningRequestResultEvent = TlvObject({
+        requestId: TlvField(0, TlvUInt64),
+        clientNodeId: TlvField(1, TlvNodeId),
+        statusCode: TlvField(2, TlvEnum<Status>()),
+        fabricIndex: TlvField(254, TlvFabricIndex)
+    });
+
+    /**
+     * Body of the CommissionerControl commissioningRequestResult event
+     *
+     * @see {@link MatterSpecification.v13.Core} § 11.26.7.1
+     */
+    export interface CommissioningRequestResultEvent extends TypeFromSchema<typeof TlvCommissioningRequestResultEvent> {}
+
+    /**
+     * @see {@link Cluster}
+     */
+    export const ClusterInstance = MutableCluster({
+        id: 0x751,
+        name: "CommissionerControl",
+        revision: 1,
+
+        attributes: {
+            /**
+             * Indicates the device categories specified in SupportedDeviceCategoryBitmap that are supported by this
+             * Commissioner Control Cluster server.
+             *
+             * A client shall NOT send the RequestCommissioningApproval command if the intended node to be commissioned
+             * does not conform to any of the values specified in SupportedDeviceCategories.
+             *
+             * @see {@link MatterSpecification.v13.Core} § 11.26.5.1
+             */
+            supportedDeviceCategories: Attribute(
+                0x0,
+                TlvBitmap(TlvUInt32, SupportedDeviceCategory),
+                { readAcl: AccessLevel.Manage, writeAcl: AccessLevel.Manage }
+            )
+        },
+
+        commands: {
+            /**
+             * This command is sent by a client to request approval for a future CommissionNode call. This is required
+             * to be a separate step in order to provide the server time for interacting with a user before informing
+             * the client that the CommissionNode operation may be successful.
+             *
+             * If the command is not executed via a CASE session, the command shall fail with a status code of
+             * UNSUPPORTED_ACCESS.
+             *
+             * The server may request approval from the user, but it is not required.
+             *
+             * The server shall always return SUCCESS to a correctly formatted RequestCommissioningApproval command,
+             * and then generate a CommissioningRequestResult event associated with the command’s
+             *
+             * accessing fabric once the result is ready.
+             *
+             * Clients SHOULD avoid using the same RequestID. If the RequestID and client NodeID of a
+             * RequestCommissioningApproval match a previously received RequestCommissioningApproval and the server has
+             * not returned an error or completed commissioning of a device for the prior request, then the server
+             * SHOULD return FAILURE.
+             *
+             * The parameters for RequestCommissioningApproval command are as follows:
+             *
+             * @see {@link MatterSpecification.v13.Core} § 11.26.6.1
+             */
+            requestCommissioningApproval: Command(
+                0x0,
+                TlvRequestCommissioningApprovalRequest,
+                0x0,
+                TlvNoResponse,
+                { invokeAcl: AccessLevel.Manage }
+            ),
+
+            /**
+             * This command is sent by a client to request that the server begins commissioning a previously approved
+             * request.
+             *
+             * The server shall return FAILURE if the CommissionNode command is not sent from the same NodeID and on
+             * the same fabric as the RequestCommissioningApproval or if the provided RequestID to CommissionNode does
+             * not match the value provided to RequestCommissioningApproval.
+             *
+             * If the command is not executed via a CASE session, the command shall fail with a status code of
+             *
+             * UNSUPPORTED_ACCESS.
+             *
+             * Upon receipt, the server shall respond with ReverseOpenCommissioningWindow if CommissioningRequestResult
+             * was generated with StatusCode of SUCCESS for the matching RequestID field and NodeID of the client.
+             *
+             * The server shall return FAILURE if the CommissionNode command is received after the server has already
+             * responded to a client with ReverseOpenCommissioningWindow for a matching RequestID field and NodeID of
+             * the client unless the client has sent another RequestCommissioningApproval and received an additional
+             * CommissioningRequestResult.
+             *
+             * The parameters for CommissionNode command are as follows:
+             *
+             * @see {@link MatterSpecification.v13.Core} § 11.26.6.5
+             */
+            commissionNode: Command(
+                0x1,
+                TlvCommissionNodeRequest,
+                0x2,
+                TlvReverseOpenCommissioningWindowResponse,
+                { invokeAcl: AccessLevel.Manage }
+            )
+        },
+
+        events: {
+            /**
+             * This event shall be generated by the server following a RequestCommissioningApproval command which the
+             * server responded to with SUCCESS.
+             *
+             * NOTE
+             *
+             * The approval is valid for a period determined by the manufacturer and characteristics of the node
+             * presenting the Commissioner Control Cluster. Clients SHOULD send the CommissionNode command immediately
+             * upon receiving a CommissioningRequestResult event.
+             *
+             * 11.26.7.2. RequestID / ClientNodeID Fields
+             *
+             * The RequestID shall match the RequestID provided to RequestCommissioningApproval and the ClientNodeID
+             * shall match the NodeID of the client which generated the RequestCommissioningAp
+             *
+             * proval command.
+             *
+             * @see {@link MatterSpecification.v13.Core} § 11.26.7.1
+             */
+            commissioningRequestResult: Event(
+                0x0,
+                EventPriority.Info,
+                TlvCommissioningRequestResultEvent,
+                { readAcl: AccessLevel.Manage }
+            )
+        }
+    });
+
+    /**
+     * The Commissioner Control Cluster supports the ability for clients to request the commissioning of themselves or
+     * other nodes onto a fabric which the cluster server can commission onto. An example use case is ecosystem to
+     * ecosystem Fabric Synchronization setup.
+     *
+     * The generalized flow supported by the Commissioner Control Cluster can be seen in the following diagram.
+     *
+     * Figure 101. Commissioner Control Cluster - General Flow
+     *
+     * @see {@link MatterSpecification.v13.Core} § 11.26
+     */
+    export interface Cluster extends Identity<typeof ClusterInstance> {}
+
+    export const Cluster: Cluster = ClusterInstance;
+    export const Complete = Cluster;
+}
+
+export type CommissionerControlCluster = CommissionerControl.Cluster;
+export const CommissionerControlCluster = CommissionerControl.Cluster;
+ClusterRegistry.register(CommissionerControl.Complete);

package/src/clusters/content-control.ts

@@ -13,7 +13,7 @@ import { TlvField, TlvOptionalField, TlvObject } from "../tlv/TlvObject.js";
 import { TlvString } from "../tlv/TlvString.js";
 import { TypeFromSchema } from "../tlv/TlvSchema.js";
 import { AccessLevel } from "#model";
-import { TlvUInt32, TlvUInt16, TlvEnum, TlvUInt8 } from "../tlv/TlvNumber.js";
+import { TlvUInt32, TlvUInt16, TlvUInt8, TlvBitmap } from "../tlv/TlvNumber.js";
 import { TlvNoArguments } from "../tlv/TlvNoArguments.js";
 import { TlvBoolean } from "../tlv/TlvBoolean.js";
 import { TlvNullable } from "../tlv/TlvNullable.js";
@@ -87,7 +87,7 @@ export namespace ContentControl {
     }
 
     /**
-     * @see {@link MatterSpecification.v13.Cluster} § 6.13.5.1
+     * @see {@link MatterSpecification.v13.Cluster} § 6.13.5.2
      */
     export const TlvRatingName = TlvObject({
         /**
@@ -95,20 +95,20 @@ export namespace ContentControl {
          * system is dependent upon the region or country where the Node has been provisioned, and may vary from one
          * country to another.
          *
-         * @see {@link MatterSpecification.v13.Cluster} § 6.13.5.1.1
+         * @see {@link MatterSpecification.v13.Cluster} § 6.13.5.2.1
          */
         ratingName: TlvField(0, TlvString.bound({ maxLength: 8 })),
 
         /**
          * This field shall specify a human readable (displayable) description for RatingName.
          *
-         * @see {@link MatterSpecification.v13.Cluster} § 6.13.5.1.2
+         * @see {@link MatterSpecification.v13.Cluster} § 6.13.5.2.2
          */
         ratingNameDesc: TlvOptionalField(1, TlvString.bound({ maxLength: 64 }))
     });
 
     /**
-     * @see {@link MatterSpecification.v13.Cluster} § 6.13.5.1
+     * @see {@link MatterSpecification.v13.Cluster} § 6.13.5.2
      */
     export interface RatingName extends TypeFromSchema<typeof TlvRatingName> {}
 
@@ -141,9 +141,8 @@ export namespace ContentControl {
      */
     export const TlvSetScheduledContentRatingThresholdRequest = TlvObject({
         /**
-         * This field indicates a threshold rating for filtering scheduled content. This field shall be set to one
-         *
-         * of the values present in the ScheduledContentRatings attribute.
+         * This field indicates a threshold rating for filtering scheduled content. This field shall be set to one of
+         * the values present in the ScheduledContentRatings attribute.
          *
          * @see {@link MatterSpecification.v13.Cluster} § 6.13.8.11.1
          */
@@ -177,7 +176,7 @@ export namespace ContentControl {
 
         /**
          * This field shall indicate the amount of extra time (in seconds) to increase RemainingScreenTime. This field
-         * shall not exceed the remaining time of this day.
+         * shall NOT exceed the remaining time of this day.
          *
          * @see {@link MatterSpecification.v13.Cluster} § 6.13.8.6.2
          */
@@ -198,9 +197,8 @@ export namespace ContentControl {
      */
     export const TlvSetScreenDailyTimeRequest = TlvObject({
         /**
-         * This field shall indicate the time (in seconds) which the User is allowed to spend watching TV on
-         *
-         * this media device within one day.
+         * This field shall indicate the time (in seconds) which the User is allowed to spend watching TV on this media
+         * device within one day.
          *
          * @see {@link MatterSpecification.v13.Cluster} § 6.13.8.7.1
          */
@@ -215,16 +213,14 @@ export namespace ContentControl {
     export interface SetScreenDailyTimeRequest extends TypeFromSchema<typeof TlvSetScreenDailyTimeRequest> {}
 
     /**
-     * [options="header",valign="middle"]b
-     *
-     * @see {@link MatterSpecification.v13.Cluster} § 6.13.5.2
+     * @see {@link MatterSpecification.v13.Cluster} § 6.13.5.3
      */
     export const TlvBlockChannel = TlvObject({
         /**
          * This field shall indicate a unique index value for a blocked channel. This value may be used to indicate one
          * selected channel which will be removed from BlockChannelList attribute.
          *
-         * @see {@link MatterSpecification.v13.Cluster} § 6.13.5.2.1
+         * @see {@link MatterSpecification.v13.Cluster} § 6.13.5.3.1
          */
         blockChannelIndex: TlvField(0, TlvNullable(TlvUInt16)),
 
@@ -234,7 +230,7 @@ export namespace ContentControl {
          * This field is required but shall be set to 0 for channels such as over-the-top channels that are not
          * represented by a major or minor number.
          *
-         * @see {@link MatterSpecification.v13.Cluster} § 6.13.5.2.2
+         * @see {@link MatterSpecification.v13.Cluster} § 6.13.5.3.2
          */
         majorNumber: TlvField(1, TlvUInt16),
 
@@ -244,7 +240,7 @@ export namespace ContentControl {
          * This field is required but shall be set to 0 for channels such as over-the-top channels that are not
          * represented by a major or minor number.
          *
-         * @see {@link MatterSpecification.v13.Cluster} § 6.13.5.2.3
+         * @see {@link MatterSpecification.v13.Cluster} § 6.13.5.3.3
          */
         minorNumber: TlvField(2, TlvUInt16),
 
@@ -252,15 +248,13 @@ export namespace ContentControl {
          * This field shall indicate the unique identifier for a specific channel. This field is optional, but SHOULD
          * be provided when MajorNumber and MinorNumber are not available.
          *
-         * @see {@link MatterSpecification.v13.Cluster} § 6.13.5.2.4
+         * @see {@link MatterSpecification.v13.Cluster} § 6.13.5.3.4
          */
         identifier: TlvOptionalField(3, TlvString)
     });
 
     /**
-     * [options="header",valign="middle"]b
-     *
-     * @see {@link MatterSpecification.v13.Cluster} § 6.13.5.2
+     * @see {@link MatterSpecification.v13.Cluster} § 6.13.5.3
      */
     export interface BlockChannel extends TypeFromSchema<typeof TlvBlockChannel> {}
 
@@ -310,7 +304,7 @@ export namespace ContentControl {
     export interface RemoveBlockChannelsRequest extends TypeFromSchema<typeof TlvRemoveBlockChannelsRequest> {}
 
     /**
-     * @see {@link MatterSpecification.v13.Cluster} § 6.13.5.3
+     * @see {@link MatterSpecification.v13.Cluster} § 6.13.5.4
      */
     export const TlvAppInfo = TlvObject({
         /**
@@ -319,7 +313,7 @@ export namespace ContentControl {
          * Content App Platform providers will have their own catalog vendor ID (set to their own Vendor ID) and will
          * assign an ApplicationID to each Content App.
          *
-         * @see {@link MatterSpecification.v13.Cluster} § 6.13.5.3.1
+         * @see {@link MatterSpecification.v13.Cluster} § 6.13.5.4.1
          */
         catalogVendorId: TlvField(0, TlvUInt16),
 
@@ -327,13 +321,13 @@ export namespace ContentControl {
          * This field shall indicate the application identifier, expressed as a string, such as "PruneVideo" or
          * "Company X". This field shall be unique within a catalog.
          *
-         * @see {@link MatterSpecification.v13.Cluster} § 6.13.5.3.2
+         * @see {@link MatterSpecification.v13.Cluster} § 6.13.5.4.2
          */
         applicationId: TlvField(1, TlvString)
     });
 
     /**
-     * @see {@link MatterSpecification.v13.Cluster} § 6.13.5.3
+     * @see {@link MatterSpecification.v13.Cluster} § 6.13.5.4
      */
     export interface AppInfo extends TypeFromSchema<typeof TlvAppInfo> {}
 
@@ -381,44 +375,44 @@ export namespace ContentControl {
     export interface RemoveBlockApplicationsRequest extends TypeFromSchema<typeof TlvRemoveBlockApplicationsRequest> {}
 
     /**
-     * @see {@link MatterSpecification.v13.Cluster} § 6.13.5.5
+     * @see {@link MatterSpecification.v13.Cluster} § 6.13.5.1
      */
-    export enum DayOfWeek {
+    export const DayOfWeek = {
         /**
          * Sunday
          */
-        Sunday = 0,
+        sunday: BitFlag(0),
 
         /**
          * Monday
          */
-        Monday = 1,
+        monday: BitFlag(1),
 
         /**
          * Tuesday
          */
-        Tuesday = 2,
+        tuesday: BitFlag(2),
 
         /**
          * Wednesday
          */
-        Wednesday = 3,
+        wednesday: BitFlag(3),
 
         /**
          * Thursday
          */
-        Thursday = 4,
+        thursday: BitFlag(4),
 
         /**
          * Friday
          */
-        Friday = 5,
+        friday: BitFlag(5),
 
         /**
          * Saturday
          */
-        Saturday = 6
-    }
+        saturday: BitFlag(6)
+    };
 
     /**
      * @see {@link MatterSpecification.v13.Cluster} § 6.13.5.6
@@ -461,34 +455,34 @@ export namespace ContentControl {
     export interface TimePeriod extends TypeFromSchema<typeof TlvTimePeriod> {}
 
     /**
-     * @see {@link MatterSpecification.v13.Cluster} § 6.13.5.4
+     * @see {@link MatterSpecification.v13.Cluster} § 6.13.5.5
      */
     export const TlvTimeWindow = TlvObject({
         /**
          * This field shall indicate a unique index of a specific time window. This value may be used to indicate a
          * selected time window which will be removed from the BlockContentTimeWindow attribute.
          *
-         * @see {@link MatterSpecification.v13.Cluster} § 6.13.5.4.1
+         * @see {@link MatterSpecification.v13.Cluster} § 6.13.5.5.1
          */
         timeWindowIndex: TlvField(0, TlvNullable(TlvUInt16)),
 
         /**
          * This field shall indicate a day of week.
          *
-         * @see {@link MatterSpecification.v13.Cluster} § 6.13.5.4.2
+         * @see {@link MatterSpecification.v13.Cluster} § 6.13.5.5.2
          */
-        dayOfWeek: TlvField(1, TlvEnum<DayOfWeek>()),
+        dayOfWeek: TlvField(1, TlvBitmap(TlvUInt8, DayOfWeek)),
 
         /**
          * This field shall indicate one or more discrete time periods.
          *
-         * @see {@link MatterSpecification.v13.Cluster} § 6.13.5.4.3
+         * @see {@link MatterSpecification.v13.Cluster} § 6.13.5.5.3
          */
         timePeriod: TlvField(2, TlvArray(TlvTimePeriod))
     });
 
     /**
-     * @see {@link MatterSpecification.v13.Cluster} § 6.13.5.4
+     * @see {@link MatterSpecification.v13.Cluster} § 6.13.5.5
      */
     export interface TimeWindow extends TypeFromSchema<typeof TlvTimeWindow> {}
 
@@ -788,9 +782,8 @@ export namespace ContentControl {
             /**
              * The purpose of this command is to add the extra screen time for the user.
              *
-             * If a client with Operate privilege invokes this command, the media device shall check whether
-             *
-             * the PINCode passed in the command matches the current PINCode value. If these match, then the
+             * If a client with Operate privilege invokes this command, the media device shall check whether the
+             * PINCode passed in the command matches the current PINCode value. If these match, then the
              * RemainingScreenTime attribute shall be increased by the specified BonusTime value.
              *
              * If the PINs do not match, then a response with InvalidPINCode error status shall be returned, and no
@@ -844,9 +837,8 @@ export namespace ContentControl {
         attributes: {
             /**
              * Indicates whether the playback of unrated content is allowed when the Content Control feature is
-             * activated. If this attribute equals FALSE, then playback of unrated content
-             *
-             * shall be permitted. Otherwise, the media device shall prevent the playback of unrated content.
+             * activated. If this attribute equals FALSE, then playback of unrated content shall be permitted.
+             * Otherwise, the media device shall prevent the playback of unrated content.
              *
              * When this attribute changes, the device SHOULD make the user aware of any limits of this feature. For
              * example, if the feature does not control content within apps, then the device should make this clear to
@@ -899,9 +891,10 @@ export namespace ContentControl {
             /**
              * The purpose of this command is to set BlockChannelList attribute.
              *
-             * Upon receipt of the AddBlockChannels command, the media device shall check if the channels passed in
-             * this command are valid. If the channel is invalid, then a response with InvalidChannel error Status
-             * shall be returned.
+             * Upon receipt of the AddBlockChannels command, the media device shall check if the channels
+             *
+             * passed in this command are valid. If the channel is invalid, then a response with InvalidChannel error
+             * Status shall be returned.
              *
              * If there is at least one channel in Channels field which is not in the BlockChannelList attribute, the
              * media device shall process the request by adding these new channels into the BlockChannelList attribute
@@ -960,7 +953,9 @@ export namespace ContentControl {
              *
              * Upon receipt of the AddBlockApplications command, the media device shall check if the Applications
              * passed in this command are installed. If there is an application in Applications field which is not
-             * identified by media device, then a response with UnidentifiableApplication error Status may be returned.
+             * identified by media device, then a response with UnidentifiableApplication error Status may be
+             *
+             * returned.
              *
              * If there is one or more applications which are not present in BlockApplicationList attribute, the media
              * device shall process the request by adding the new application to the BlockApplicationList attribute and
@@ -1009,7 +1004,7 @@ export namespace ContentControl {
              * the Content Control feature is activated. The media device shall reject any request to play content
              * during one period of this attribute. If it is entering any one period of this attribute, the media
              * device shall block content which is playing and generate an event EnteringBlockContentTimeWindow. There
-             * shall not be multiple entries in this attribute list for the same day of week.
+             * shall NOT be multiple entries in this attribute list for the same day of week.
              *
              * @see {@link MatterSpecification.v13.Cluster} § 6.13.7.11
              */
@@ -1021,7 +1016,6 @@ export namespace ContentControl {
              * The purpose of this command is to set the BlockContentTimeWindow attribute.
              *
              * Upon receipt of the SetBlockContentTimeWindow command, the media device shall check if the
-             *
              * TimeWindowIndex field passed in this command is NULL. If the TimeWindowIndex field is NULL, the media
              * device shall check if there is an entry in the BlockContentTimeWindow attribute which matches with the
              * TimePeriod and DayOfWeek fields passed in this command. * If Yes, then a response with