@matter/types 0.14.0-alpha.0-20250531-7ed2d6da8 → 0.14.0-alpha.0-20250602-37f27bb02

package/src/clusters/channel.ts

@@ -14,6 +14,8 @@ import { TlvUInt16, TlvEnum, TlvEpochS, TlvUInt8, TlvBitmap, TlvInt16 } from "..
 import { TlvString, TlvByteString } from "../tlv/TlvString.js";
 import { TypeFromSchema } from "../tlv/TlvSchema.js";
 import { TlvNullable } from "../tlv/TlvNullable.js";
+import { StatusResponseError } from "../common/StatusResponseError.js";
+import { Status as GlobalStatus } from "../globals/Status.js";
 import { BitFlag } from "../schema/BitmapSchema.js";
 import { ContentLauncher } from "./content-launcher.js";
 import { TlvBoolean } from "../tlv/TlvBoolean.js";
@@ -24,7 +26,7 @@ export namespace Channel {
     /**
      * These are optional features supported by ChannelCluster.
      *
-     * @see {@link MatterSpecification.v14.Cluster} § 6.6.4
+     * @see {@link MatterSpecification.v141.Cluster} § 6.6.4
      */
     export enum Feature {
         /**
@@ -57,7 +59,7 @@ export namespace Channel {
     }
 
     /**
-     * @see {@link MatterSpecification.v14.Cluster} § 6.6.5.4
+     * @see {@link MatterSpecification.v141.Cluster} § 6.6.5.4
      */
     export enum ChannelType {
         /**
@@ -87,7 +89,7 @@ export namespace Channel {
      * While the major and minor numbers in the ChannelInfoStruct support use of ATSC channel format, a lineup may use
      * other formats which can map into these numeric values.
      *
-     * @see {@link MatterSpecification.v14.Cluster} § 6.6.5.5
+     * @see {@link MatterSpecification.v141.Cluster} § 6.6.5.5
      */
     export const TlvChannelInfo = TlvObject({
         /**
@@ -96,7 +98,7 @@ export namespace Channel {
          * 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.v14.Cluster} § 6.6.5.5.1
+         * @see {@link MatterSpecification.v141.Cluster} § 6.6.5.5.1
          */
         majorNumber: TlvField(0, TlvUInt16),
 
@@ -106,7 +108,7 @@ export namespace Channel {
          * 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.v14.Cluster} § 6.6.5.5.2
+         * @see {@link MatterSpecification.v141.Cluster} § 6.6.5.5.2
          */
         minorNumber: TlvField(1, TlvUInt16),
 
@@ -114,7 +116,7 @@ export namespace Channel {
          * This field shall indicate the marketing name for the channel, such as “The CW" or "Comedy Central". This
          * field is optional, but SHOULD be provided when known.
          *
-         * @see {@link MatterSpecification.v14.Cluster} § 6.6.5.5.3
+         * @see {@link MatterSpecification.v141.Cluster} § 6.6.5.5.3
          */
         name: TlvOptionalField(2, TlvString),
 
@@ -122,7 +124,7 @@ export namespace Channel {
          * This field shall indicate the call sign of the channel, such as "PBS". This field is optional, but SHOULD be
          * provided when known.
          *
-         * @see {@link MatterSpecification.v14.Cluster} § 6.6.5.5.4
+         * @see {@link MatterSpecification.v141.Cluster} § 6.6.5.5.4
          */
         callSign: TlvOptionalField(3, TlvString),
 
@@ -130,7 +132,7 @@ export namespace Channel {
          * This field shall indicate the local affiliate call sign, such as "KCTS". This field is optional, but SHOULD
          * be provided when known.
          *
-         * @see {@link MatterSpecification.v14.Cluster} § 6.6.5.5.5
+         * @see {@link MatterSpecification.v141.Cluster} § 6.6.5.5.5
          */
         affiliateCallSign: TlvOptionalField(4, TlvString),
 
@@ -138,7 +140,7 @@ export namespace Channel {
          * This 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.v14.Cluster} § 6.6.5.5.6
+         * @see {@link MatterSpecification.v141.Cluster} § 6.6.5.5.6
          */
         identifier: TlvOptionalField(5, TlvString),
 
@@ -146,7 +148,7 @@ export namespace Channel {
          * This shall indicate the type or grouping of a specific channel. This field is optional, but SHOULD be
          * provided when known.
          *
-         * @see {@link MatterSpecification.v14.Cluster} § 6.6.5.5.7
+         * @see {@link MatterSpecification.v141.Cluster} § 6.6.5.5.7
          */
         type: TlvOptionalField(6, TlvEnum<ChannelType>())
     });
@@ -157,12 +159,12 @@ export namespace Channel {
      * While the major and minor numbers in the ChannelInfoStruct support use of ATSC channel format, a lineup may use
      * other formats which can map into these numeric values.
      *
-     * @see {@link MatterSpecification.v14.Cluster} § 6.6.5.5
+     * @see {@link MatterSpecification.v141.Cluster} § 6.6.5.5
      */
     export interface ChannelInfo extends TypeFromSchema<typeof TlvChannelInfo> {}
 
     /**
-     * @see {@link MatterSpecification.v14.Cluster} § 6.6.5.2
+     * @see {@link MatterSpecification.v141.Cluster} § 6.6.5.2
      */
     export enum LineupInfoType {
         /**
@@ -175,13 +177,13 @@ export namespace Channel {
      * The Lineup Info allows references to external lineup sources like Gracenote. The combination of OperatorName,
      * LineupName, and PostalCode MUST uniquely identify a lineup.
      *
-     * @see {@link MatterSpecification.v14.Cluster} § 6.6.5.6
+     * @see {@link MatterSpecification.v141.Cluster} § 6.6.5.6
      */
     export const TlvLineupInfo = TlvObject({
         /**
          * This field shall indicate the name of the operator, for example “Comcast”.
          *
-         * @see {@link MatterSpecification.v14.Cluster} § 6.6.5.6.1
+         * @see {@link MatterSpecification.v141.Cluster} § 6.6.5.6.1
          */
         operatorName: TlvField(0, TlvString),
 
@@ -189,7 +191,7 @@ export namespace Channel {
          * This field shall indicate the name of the provider lineup, for example "Comcast King County". This field is
          * optional, but SHOULD be provided when known.
          *
-         * @see {@link MatterSpecification.v14.Cluster} § 6.6.5.6.2
+         * @see {@link MatterSpecification.v141.Cluster} § 6.6.5.6.2
          */
         lineupName: TlvOptionalField(1, TlvString),
 
@@ -197,14 +199,14 @@ export namespace Channel {
          * This field shall indicate the postal code (zip code) for the location of the device, such as "98052". This
          * field is optional, but SHOULD be provided when known.
          *
-         * @see {@link MatterSpecification.v14.Cluster} § 6.6.5.6.3
+         * @see {@link MatterSpecification.v141.Cluster} § 6.6.5.6.3
          */
         postalCode: TlvOptionalField(2, TlvString),
 
         /**
          * This field shall indicate the type of lineup. This field is optional, but SHOULD be provided when known.
          *
-         * @see {@link MatterSpecification.v14.Cluster} § 6.6.5.6.4
+         * @see {@link MatterSpecification.v141.Cluster} § 6.6.5.6.4
          */
         lineupInfoType: TlvField(3, TlvEnum<LineupInfoType>())
     });
@@ -213,20 +215,20 @@ export namespace Channel {
      * The Lineup Info allows references to external lineup sources like Gracenote. The combination of OperatorName,
      * LineupName, and PostalCode MUST uniquely identify a lineup.
      *
-     * @see {@link MatterSpecification.v14.Cluster} § 6.6.5.6
+     * @see {@link MatterSpecification.v141.Cluster} § 6.6.5.6
      */
     export interface LineupInfo extends TypeFromSchema<typeof TlvLineupInfo> {}
 
     /**
      * Input to the Channel changeChannel command
      *
-     * @see {@link MatterSpecification.v14.Cluster} § 6.6.7.1
+     * @see {@link MatterSpecification.v141.Cluster} § 6.6.7.1
      */
     export const TlvChangeChannelRequest = TlvObject({
         /**
          * This field shall contain a user-input string to match in order to identify the target channel.
          *
-         * @see {@link MatterSpecification.v14.Cluster} § 6.6.7.1.1
+         * @see {@link MatterSpecification.v141.Cluster} § 6.6.7.1.1
          */
         match: TlvField(0, TlvString)
     });
@@ -234,12 +236,12 @@ export namespace Channel {
     /**
      * Input to the Channel changeChannel command
      *
-     * @see {@link MatterSpecification.v14.Cluster} § 6.6.7.1
+     * @see {@link MatterSpecification.v141.Cluster} § 6.6.7.1
      */
     export interface ChangeChannelRequest extends TypeFromSchema<typeof TlvChangeChannelRequest> {}
 
     /**
-     * @see {@link MatterSpecification.v14.Cluster} § 6.6.5.3
+     * @see {@link MatterSpecification.v141.Cluster} § 6.6.5.3
      */
     export enum Status {
         /**
@@ -258,23 +260,53 @@ export namespace Channel {
         NoMatches = 2
     }
 
+    /**
+     * Thrown for cluster status code {@link Status.MultipleMatches}.
+     *
+     * @see {@link MatterSpecification.v141.Cluster} § 6.6.5.3
+     */
+    export class MultipleMatchesError extends StatusResponseError {
+        constructor(
+            message = "More than one equal match for the ChannelInfoStruct passed in",
+            code = GlobalStatus.Failure,
+            clusterCode = Status.MultipleMatches
+        ) {
+            super(message, code, clusterCode);
+        }
+    }
+
+    /**
+     * Thrown for cluster status code {@link Status.NoMatches}.
+     *
+     * @see {@link MatterSpecification.v141.Cluster} § 6.6.5.3
+     */
+    export class NoMatchesError extends StatusResponseError {
+        constructor(
+            message = "No matches for the ChannelInfoStruct passed in",
+            code = GlobalStatus.Failure,
+            clusterCode = Status.NoMatches
+        ) {
+            super(message, code, clusterCode);
+        }
+    }
+
     /**
      * This command shall be generated in response to a ChangeChannel command.
      *
-     * @see {@link MatterSpecification.v14.Cluster} § 6.6.7.2
+     * @see {@link MatterSpecification.v141.Cluster} § 6.6.7.2
      */
     export const TlvChangeChannelResponse = TlvObject({
         /**
          * This field shall indicate the status of the command which resulted in this response.
          *
-         * @see {@link MatterSpecification.v14.Cluster} § 6.6.7.2.1
+         * @see {@link MatterSpecification.v141.Cluster} § 6.6.7.2.1
          */
         status: TlvField(0, TlvEnum<Status>()),
 
         /**
          * This field shall indicate Optional app-specific data.
          *
-         * @see {@link MatterSpecification.v14.Cluster} § 6.6.7.2.2
+         * @see {@link MatterSpecification.v141.Cluster} § 6.6.7.2.2
          */
         data: TlvOptionalField(1, TlvString)
     });
@@ -282,21 +314,21 @@ export namespace Channel {
     /**
      * This command shall be generated in response to a ChangeChannel command.
      *
-     * @see {@link MatterSpecification.v14.Cluster} § 6.6.7.2
+     * @see {@link MatterSpecification.v141.Cluster} § 6.6.7.2
      */
     export interface ChangeChannelResponse extends TypeFromSchema<typeof TlvChangeChannelResponse> {}
 
     /**
      * This object defines the pagination structure.
      *
-     * @see {@link MatterSpecification.v14.Cluster} § 6.6.5.11
+     * @see {@link MatterSpecification.v141.Cluster} § 6.6.5.11
      */
     export const TlvPageToken = TlvObject({
         /**
          * This field shall indicate the maximum number of entries that should be retrieved from the program guide in a
          * single response. It allows clients to specify the size of the paginated result set based on their needs.
          *
-         * @see {@link MatterSpecification.v14.Cluster} § 6.6.5.11.1
+         * @see {@link MatterSpecification.v141.Cluster} § 6.6.5.11.1
          */
         limit: TlvOptionalField(0, TlvUInt16),
 
@@ -306,7 +338,7 @@ export namespace Channel {
          * the data following the specified cursor. In a Offset-based pagination system, the field, along with limit,
          * indicate the offset from which entries in the program guide will be retrieved.
          *
-         * @see {@link MatterSpecification.v14.Cluster} § 6.6.5.11.2
+         * @see {@link MatterSpecification.v141.Cluster} § 6.6.5.11.2
          */
         after: TlvOptionalField(1, TlvString.bound({ maxLength: 8192 })),
 
@@ -316,7 +348,7 @@ export namespace Channel {
          * the data preceding the specified cursor. In a Offset-based pagination system, the field, along with limit,
          * indicate the offset from which entries in the program guide will be retrieved.
          *
-         * @see {@link MatterSpecification.v14.Cluster} § 6.6.5.11.3
+         * @see {@link MatterSpecification.v141.Cluster} § 6.6.5.11.3
          */
         before: TlvOptionalField(2, TlvString.bound({ maxLength: 8192 }))
     });
@@ -324,12 +356,12 @@ export namespace Channel {
     /**
      * This object defines the pagination structure.
      *
-     * @see {@link MatterSpecification.v14.Cluster} § 6.6.5.11
+     * @see {@link MatterSpecification.v141.Cluster} § 6.6.5.11
      */
     export interface PageToken extends TypeFromSchema<typeof TlvPageToken> {}
 
     /**
-     * @see {@link MatterSpecification.v14.Cluster} § 6.6.5.1
+     * @see {@link MatterSpecification.v141.Cluster} § 6.6.5.1
      */
     export const RecordingFlag = {
         /**
@@ -351,14 +383,14 @@ export namespace Channel {
     /**
      * Input to the Channel getProgramGuide command
      *
-     * @see {@link MatterSpecification.v14.Cluster} § 6.6.7.5
+     * @see {@link MatterSpecification.v141.Cluster} § 6.6.7.5
      */
     export const TlvGetProgramGuideRequest = TlvObject({
         /**
          * This field shall indicate the beginning of the time window for which program guide entries are to be
          * retrieved, as a UTC time. Entries with a start time on or after this value will be included in the results.
          *
-         * @see {@link MatterSpecification.v14.Cluster} § 6.6.7.5.1
+         * @see {@link MatterSpecification.v141.Cluster} § 6.6.7.5.1
          */
         startTime: TlvField(0, TlvEpochS),
 
@@ -367,7 +399,7 @@ export namespace Channel {
          * a UTC time. Entries with an end time on or before this value will be included in the results. This field can
          * represent a past or future value but shall be greater than the StartTime.
          *
-         * @see {@link MatterSpecification.v14.Cluster} § 6.6.7.5.2
+         * @see {@link MatterSpecification.v141.Cluster} § 6.6.7.5.2
          */
         endTime: TlvField(1, TlvEpochS),
 
@@ -376,35 +408,35 @@ export namespace Channel {
          * a list of channels in this field, the response will only include entries corresponding to the specified
          * channels.
          *
-         * @see {@link MatterSpecification.v14.Cluster} § 6.6.7.5.3
+         * @see {@link MatterSpecification.v141.Cluster} § 6.6.7.5.3
          */
         channelList: TlvOptionalField(2, TlvArray(TlvChannelInfo, { maxLength: 255 })),
 
         /**
          * This field shall indicate the pagination token used for managing pagination progression.
          *
-         * @see {@link MatterSpecification.v14.Cluster} § 6.6.7.5.4
+         * @see {@link MatterSpecification.v141.Cluster} § 6.6.7.5.4
          */
         pageToken: TlvOptionalField(3, TlvNullable(TlvPageToken)),
 
         /**
          * This field shall indicate the flags of the programs for which entries should be fetched.
          *
-         * @see {@link MatterSpecification.v14.Cluster} § 6.6.7.5.5
+         * @see {@link MatterSpecification.v141.Cluster} § 6.6.7.5.5
          */
         recordingFlag: TlvOptionalField(5, TlvNullable(TlvBitmap(TlvUInt8, RecordingFlag))),
 
         /**
          * This field shall indicate the list of additional external content identifiers.
          *
-         * @see {@link MatterSpecification.v14.Cluster} § 6.6.7.5.6
+         * @see {@link MatterSpecification.v141.Cluster} § 6.6.7.5.6
          */
         externalIdList: TlvOptionalField(6, TlvArray(ContentLauncher.TlvAdditionalInfo, { maxLength: 255 })),
 
         /**
          * This field shall indicate Optional app-specific data.
          *
-         * @see {@link MatterSpecification.v14.Cluster} § 6.6.7.5.7
+         * @see {@link MatterSpecification.v141.Cluster} § 6.6.7.5.7
          */
         data: TlvOptionalField(7, TlvByteString.bound({ maxLength: 8092 }))
     });
@@ -412,21 +444,21 @@ export namespace Channel {
     /**
      * Input to the Channel getProgramGuide command
      *
-     * @see {@link MatterSpecification.v14.Cluster} § 6.6.7.5
+     * @see {@link MatterSpecification.v141.Cluster} § 6.6.7.5
      */
     export interface GetProgramGuideRequest extends TypeFromSchema<typeof TlvGetProgramGuideRequest> {}
 
     /**
      * This object defines the paging structure that includes the previous and next pagination tokens.
      *
-     * @see {@link MatterSpecification.v14.Cluster} § 6.6.5.12
+     * @see {@link MatterSpecification.v141.Cluster} § 6.6.5.12
      */
     export const TlvChannelPaging = TlvObject({
         /**
          * This field shall indicate the token to retrieve the preceding page. Absence of this field denotes the
          * response as the initial page.
          *
-         * @see {@link MatterSpecification.v14.Cluster} § 6.6.5.12.1
+         * @see {@link MatterSpecification.v141.Cluster} § 6.6.5.12.1
          */
         previousToken: TlvOptionalField(0, TlvNullable(TlvPageToken)),
 
@@ -434,7 +466,7 @@ export namespace Channel {
          * This field shall indicate the token to retrieve the next page. Absence of this field denotes the response as
          * the last page.
          *
-         * @see {@link MatterSpecification.v14.Cluster} § 6.6.5.12.2
+         * @see {@link MatterSpecification.v141.Cluster} § 6.6.5.12.2
          */
         nextToken: TlvOptionalField(1, TlvNullable(TlvPageToken))
     });
@@ -442,27 +474,27 @@ export namespace Channel {
     /**
      * This object defines the paging structure that includes the previous and next pagination tokens.
      *
-     * @see {@link MatterSpecification.v14.Cluster} § 6.6.5.12
+     * @see {@link MatterSpecification.v141.Cluster} § 6.6.5.12
      */
     export interface ChannelPaging extends TypeFromSchema<typeof TlvChannelPaging> {}
 
     /**
      * This object provides the episode information related to a program.
      *
-     * @see {@link MatterSpecification.v14.Cluster} § 6.6.5.9
+     * @see {@link MatterSpecification.v141.Cluster} § 6.6.5.9
      */
     export const TlvSeriesInfo = TlvObject({
         /**
          * This field shall represent the season of the series associated to the program.
          *
-         * @see {@link MatterSpecification.v14.Cluster} § 6.6.5.9.1
+         * @see {@link MatterSpecification.v141.Cluster} § 6.6.5.9.1
          */
         season: TlvField(0, TlvString.bound({ maxLength: 256 })),
 
         /**
          * This field shall represent the episode of the program.
          *
-         * @see {@link MatterSpecification.v14.Cluster} § 6.6.5.9.2
+         * @see {@link MatterSpecification.v141.Cluster} § 6.6.5.9.2
          */
         episode: TlvField(1, TlvString.bound({ maxLength: 256 }))
     });
@@ -470,27 +502,27 @@ export namespace Channel {
     /**
      * This object provides the episode information related to a program.
      *
-     * @see {@link MatterSpecification.v14.Cluster} § 6.6.5.9
+     * @see {@link MatterSpecification.v141.Cluster} § 6.6.5.9
      */
     export interface SeriesInfo extends TypeFromSchema<typeof TlvSeriesInfo> {}
 
     /**
      * This object defines the category associated to a program.
      *
-     * @see {@link MatterSpecification.v14.Cluster} § 6.6.5.8
+     * @see {@link MatterSpecification.v141.Cluster} § 6.6.5.8
      */
     export const TlvProgramCategory = TlvObject({
         /**
          * This field shall represent the category or genre of the program. Ex. News.
          *
-         * @see {@link MatterSpecification.v14.Cluster} § 6.6.5.8.1
+         * @see {@link MatterSpecification.v141.Cluster} § 6.6.5.8.1
          */
         category: TlvField(0, TlvString.bound({ maxLength: 256 })),
 
         /**
          * This field shall represent the sub-category or sub-genre of the program. Ex. Local.
          *
-         * @see {@link MatterSpecification.v14.Cluster} § 6.6.5.8.2
+         * @see {@link MatterSpecification.v141.Cluster} § 6.6.5.8.2
          */
         subCategory: TlvOptionalField(1, TlvString.bound({ maxLength: 256 }))
     });
@@ -498,27 +530,27 @@ export namespace Channel {
     /**
      * This object defines the category associated to a program.
      *
-     * @see {@link MatterSpecification.v14.Cluster} § 6.6.5.8
+     * @see {@link MatterSpecification.v141.Cluster} § 6.6.5.8
      */
     export interface ProgramCategory extends TypeFromSchema<typeof TlvProgramCategory> {}
 
     /**
      * This object provides the cast information related to a program.
      *
-     * @see {@link MatterSpecification.v14.Cluster} § 6.6.5.10
+     * @see {@link MatterSpecification.v141.Cluster} § 6.6.5.10
      */
     export const TlvProgramCast = TlvObject({
         /**
          * This field shall represent the name of the cast member.
          *
-         * @see {@link MatterSpecification.v14.Cluster} § 6.6.5.10.1
+         * @see {@link MatterSpecification.v141.Cluster} § 6.6.5.10.1
          */
         name: TlvField(0, TlvString.bound({ maxLength: 256 })),
 
         /**
          * This field shall represent the role of the cast member. Ex. Actor, Director.
          *
-         * @see {@link MatterSpecification.v14.Cluster} § 6.6.5.10.2
+         * @see {@link MatterSpecification.v141.Cluster} § 6.6.5.10.2
          */
         role: TlvField(1, TlvString.bound({ maxLength: 256 }))
     });
@@ -526,28 +558,28 @@ export namespace Channel {
     /**
      * This object provides the cast information related to a program.
      *
-     * @see {@link MatterSpecification.v14.Cluster} § 6.6.5.10
+     * @see {@link MatterSpecification.v141.Cluster} § 6.6.5.10
      */
     export interface ProgramCast extends TypeFromSchema<typeof TlvProgramCast> {}
 
     /**
      * This indicates a program within an electronic program guide (EPG).
      *
-     * @see {@link MatterSpecification.v14.Cluster} § 6.6.5.7
+     * @see {@link MatterSpecification.v141.Cluster} § 6.6.5.7
      */
     export const TlvProgram = TlvObject({
         /**
          * This field shall indicate a unique identifier for a program within an electronic program guide list. The
          * identifier shall be unique across multiple channels.
          *
-         * @see {@link MatterSpecification.v14.Cluster} § 6.6.5.7.1
+         * @see {@link MatterSpecification.v141.Cluster} § 6.6.5.7.1
          */
         identifier: TlvField(0, TlvString.bound({ maxLength: 255 })),
 
         /**
          * This field shall indicate the channel associated to the program.
          *
-         * @see {@link MatterSpecification.v14.Cluster} § 6.6.5.7.2
+         * @see {@link MatterSpecification.v141.Cluster} § 6.6.5.7.2
          */
         channel: TlvField(1, TlvChannelInfo),
 
@@ -555,7 +587,7 @@ export namespace Channel {
          * This field shall indicate an epoch time in seconds indicating the start time of a program, as a UTC time.
          * This field can represent a past or future value.
          *
-         * @see {@link MatterSpecification.v14.Cluster} § 6.6.5.7.3
+         * @see {@link MatterSpecification.v141.Cluster} § 6.6.5.7.3
          */
         startTime: TlvField(2, TlvEpochS),
 
@@ -563,14 +595,14 @@ export namespace Channel {
          * This field shall indicate an epoch time in seconds indicating the end time of a program, as a UTC time. This
          * field can represent a past or future value but shall be greater than the StartTime.
          *
-         * @see {@link MatterSpecification.v14.Cluster} § 6.6.5.7.4
+         * @see {@link MatterSpecification.v141.Cluster} § 6.6.5.7.4
          */
         endTime: TlvField(3, TlvEpochS),
 
         /**
          * This field shall indicate the title or name for the specific program. For example, “MCIS: Los Angeles”.
          *
-         * @see {@link MatterSpecification.v14.Cluster} § 6.6.5.7.5
+         * @see {@link MatterSpecification.v141.Cluster} § 6.6.5.7.5
          */
         title: TlvField(4, TlvString.bound({ maxLength: 255 })),
 
@@ -578,7 +610,7 @@ export namespace Channel {
          * This field shall indicate the subtitle for the specific program. For example, “Maybe Today" which is an
          * episode name for “MCIS: Los Angeles”. This field is optional but shall be provided if applicable and known.
          *
-         * @see {@link MatterSpecification.v14.Cluster} § 6.6.5.7.6
+         * @see {@link MatterSpecification.v141.Cluster} § 6.6.5.7.6
          */
         subtitle: TlvOptionalField(5, TlvString.bound({ maxLength: 255 })),
 
@@ -586,7 +618,7 @@ export namespace Channel {
          * This field shall indicate the brief description for the specific program. For example, a description of an
          * episode. This field is optional but shall be provided if known.
          *
-         * @see {@link MatterSpecification.v14.Cluster} § 6.6.5.7.7
+         * @see {@link MatterSpecification.v141.Cluster} § 6.6.5.7.7
          */
         description: TlvOptionalField(6, TlvString.bound({ maxLength: 8192 })),
 
@@ -595,7 +627,7 @@ export namespace Channel {
          * of the standard Tags for Identifying Languages RFC 5646. This field is optional but shall be provided if
          * known.
          *
-         * @see {@link MatterSpecification.v14.Cluster} § 6.6.5.7.8
+         * @see {@link MatterSpecification.v141.Cluster} § 6.6.5.7.8
          */
         audioLanguages: TlvOptionalField(7, TlvArray(TlvString, { maxLength: 10 })),
 
@@ -606,7 +638,7 @@ export namespace Channel {
          * children but can be accepted in general for older children. This field is optional but shall be provided if
          * known.
          *
-         * @see {@link MatterSpecification.v14.Cluster} § 6.6.5.7.9
+         * @see {@link MatterSpecification.v141.Cluster} § 6.6.5.7.9
          */
         ratings: TlvOptionalField(8, TlvArray(TlvString, { maxLength: 255 })),
 
@@ -614,7 +646,7 @@ export namespace Channel {
          * This field shall represent a URL of a thumbnail that clients can use to render an image for the program. The
          * syntax of this field shall follow the syntax as specified in RFC 1738 and shall use the https scheme.
          *
-         * @see {@link MatterSpecification.v14.Cluster} § 6.6.5.7.10
+         * @see {@link MatterSpecification.v141.Cluster} § 6.6.5.7.10
          */
         thumbnailUrl: TlvOptionalField(9, TlvString.bound({ maxLength: 8192 })),
 
@@ -623,7 +655,7 @@ export namespace Channel {
          * detail view. The syntax of this field shall follow the syntax as specified in RFC 1738 and shall use the
          * https scheme.
          *
-         * @see {@link MatterSpecification.v14.Cluster} § 6.6.5.7.11
+         * @see {@link MatterSpecification.v141.Cluster} § 6.6.5.7.11
          */
         posterArtUrl: TlvOptionalField(10, TlvString.bound({ maxLength: 8192 })),
 
@@ -631,7 +663,7 @@ export namespace Channel {
          * This field shall represent the DVB-I URL associated to the program. The syntax of this field shall follow the
          * syntax as specified in RFC 1738 and shall use the https scheme.
          *
-         * @see {@link MatterSpecification.v14.Cluster} § 6.6.5.7.12
+         * @see {@link MatterSpecification.v141.Cluster} § 6.6.5.7.12
          */
         dvbiUrl: TlvOptionalField(11, TlvString.bound({ maxLength: 8192 })),
 
@@ -639,7 +671,7 @@ export namespace Channel {
          * This field shall be a string, in ISO 8601 format, representing the date on which the program was released.
          * This field is optional but when provided, the year shall be provided as part of the string.
          *
-         * @see {@link MatterSpecification.v14.Cluster} § 6.6.5.7.13
+         * @see {@link MatterSpecification.v141.Cluster} § 6.6.5.7.13
          */
         releaseDate: TlvOptionalField(12, TlvString.bound({ maxLength: 30 })),
 
@@ -647,7 +679,7 @@ export namespace Channel {
          * This field shall represent a string providing additional information on the parental guidance. This field is
          * optional.
          *
-         * @see {@link MatterSpecification.v14.Cluster} § 6.6.5.7.14
+         * @see {@link MatterSpecification.v141.Cluster} § 6.6.5.7.14
          */
         parentalGuidanceText: TlvOptionalField(13, TlvString.bound({ maxLength: 255 })),
 
@@ -655,7 +687,7 @@ export namespace Channel {
          * This field shall represent the recording status of the program. This field is required if the RecordProgram
          * feature is set.
          *
-         * @see {@link MatterSpecification.v14.Cluster} § 6.6.5.7.15
+         * @see {@link MatterSpecification.v141.Cluster} § 6.6.5.7.15
          */
         recordingFlag: TlvOptionalField(14, TlvBitmap(TlvUInt8, RecordingFlag)),
 
@@ -663,7 +695,7 @@ export namespace Channel {
          * This field shall represent the information of a series such as season and episode number. This field is
          * optional but SHOULD be provided if the program represents a series and this information is available.
          *
-         * @see {@link MatterSpecification.v14.Cluster} § 6.6.5.7.16
+         * @see {@link MatterSpecification.v141.Cluster} § 6.6.5.7.16
          */
         seriesInfo: TlvOptionalField(15, TlvNullable(TlvSeriesInfo)),
 
@@ -671,7 +703,7 @@ export namespace Channel {
          * This field shall represent the category of a particular program. This field is optional but shall be provided
          * if known.
          *
-         * @see {@link MatterSpecification.v14.Cluster} § 6.6.5.7.17
+         * @see {@link MatterSpecification.v141.Cluster} § 6.6.5.7.17
          */
         categoryList: TlvOptionalField(16, TlvArray(TlvProgramCategory, { maxLength: 255 })),
 
@@ -679,14 +711,14 @@ export namespace Channel {
          * This field shall represent a list of the cast or the crew on the program. A single cast member may have more
          * than one role. This field is optional but shall be provided if known.
          *
-         * @see {@link MatterSpecification.v14.Cluster} § 6.6.5.7.18
+         * @see {@link MatterSpecification.v141.Cluster} § 6.6.5.7.18
          */
         castList: TlvOptionalField(17, TlvArray(TlvProgramCast, { maxLength: 255 })),
 
         /**
          * This field shall indicate the list of additional external content identifiers.
          *
-         * @see {@link MatterSpecification.v14.Cluster} § 6.6.5.7.19
+         * @see {@link MatterSpecification.v141.Cluster} § 6.6.5.7.19
          */
         externalIdList: TlvOptionalField(18, TlvArray(ContentLauncher.TlvAdditionalInfo, { maxLength: 255 }))
     });
@@ -694,28 +726,28 @@ export namespace Channel {
     /**
      * This indicates a program within an electronic program guide (EPG).
      *
-     * @see {@link MatterSpecification.v14.Cluster} § 6.6.5.7
+     * @see {@link MatterSpecification.v141.Cluster} § 6.6.5.7
      */
     export interface Program extends TypeFromSchema<typeof TlvProgram> {}
 
     /**
      * This command is a response to the GetProgramGuide command.
      *
-     * @see {@link MatterSpecification.v14.Cluster} § 6.6.7.6
+     * @see {@link MatterSpecification.v141.Cluster} § 6.6.7.6
      */
     export const TlvProgramGuideResponse = TlvObject({
         /**
          * This field shall indicate the necessary pagination attributes that define information for both the succeeding
          * and preceding data pages.
          *
-         * @see {@link MatterSpecification.v14.Cluster} § 6.6.7.6.1
+         * @see {@link MatterSpecification.v141.Cluster} § 6.6.7.6.1
          */
         paging: TlvField(0, TlvChannelPaging),
 
         /**
          * This field shall indicate the list of programs.
          *
-         * @see {@link MatterSpecification.v14.Cluster} § 6.6.7.6.2
+         * @see {@link MatterSpecification.v141.Cluster} § 6.6.7.6.2
          */
         programList: TlvField(1, TlvArray(TlvProgram))
     });
@@ -723,21 +755,21 @@ export namespace Channel {
     /**
      * This command is a response to the GetProgramGuide command.
      *
-     * @see {@link MatterSpecification.v14.Cluster} § 6.6.7.6
+     * @see {@link MatterSpecification.v141.Cluster} § 6.6.7.6
      */
     export interface ProgramGuideResponse extends TypeFromSchema<typeof TlvProgramGuideResponse> {}
 
     /**
      * Input to the Channel recordProgram command
      *
-     * @see {@link MatterSpecification.v14.Cluster} § 6.6.7.7
+     * @see {@link MatterSpecification.v141.Cluster} § 6.6.7.7
      */
     export const TlvRecordProgramRequest = TlvObject({
         /**
          * This field shall indicate the program identifier for the program that should be recorded. This value is
          * provided by the identifier field in ProgramStruct.
          *
-         * @see {@link MatterSpecification.v14.Cluster} § 6.6.7.7.1
+         * @see {@link MatterSpecification.v141.Cluster} § 6.6.7.7.1
          */
         programIdentifier: TlvField(0, TlvString.bound({ maxLength: 255 })),
 
@@ -746,21 +778,21 @@ export namespace Channel {
          * invoking record program on an episode with that flag set to true, the target should schedule record the whole
          * series.
          *
-         * @see {@link MatterSpecification.v14.Cluster} § 6.6.7.7.2
+         * @see {@link MatterSpecification.v141.Cluster} § 6.6.7.7.2
          */
         shouldRecordSeries: TlvField(1, TlvBoolean),
 
         /**
          * This field, if present, shall indicate the list of additional external content identifiers.
          *
-         * @see {@link MatterSpecification.v14.Cluster} § 6.6.7.7.3
+         * @see {@link MatterSpecification.v141.Cluster} § 6.6.7.7.3
          */
         externalIdList: TlvOptionalField(2, TlvArray(ContentLauncher.TlvAdditionalInfo, { maxLength: 255 })),
 
         /**
          * This field, if present, shall indicate app-specific data.
          *
-         * @see {@link MatterSpecification.v14.Cluster} § 6.6.7.7.4
+         * @see {@link MatterSpecification.v141.Cluster} § 6.6.7.7.4
          */
         data: TlvOptionalField(3, TlvByteString.bound({ maxLength: 8092 }))
     });
@@ -768,21 +800,21 @@ export namespace Channel {
     /**
      * Input to the Channel recordProgram command
      *
-     * @see {@link MatterSpecification.v14.Cluster} § 6.6.7.7
+     * @see {@link MatterSpecification.v141.Cluster} § 6.6.7.7
      */
     export interface RecordProgramRequest extends TypeFromSchema<typeof TlvRecordProgramRequest> {}
 
     /**
      * Input to the Channel cancelRecordProgram command
      *
-     * @see {@link MatterSpecification.v14.Cluster} § 6.6.7.8
+     * @see {@link MatterSpecification.v141.Cluster} § 6.6.7.8
      */
     export const TlvCancelRecordProgramRequest = TlvObject({
         /**
          * This field shall indicate the program identifier for the program that should be cancelled from recording.
          * This value is provided by the identifier field in ProgramStruct.
          *
-         * @see {@link MatterSpecification.v14.Cluster} § 6.6.7.8.1
+         * @see {@link MatterSpecification.v141.Cluster} § 6.6.7.8.1
          */
         programIdentifier: TlvField(0, TlvString.bound({ maxLength: 255 })),
 
@@ -791,21 +823,21 @@ export namespace Channel {
          * recording. For example, invoking record program on an episode with that flag set to true, the target should
          * schedule record the whole series.
          *
-         * @see {@link MatterSpecification.v14.Cluster} § 6.6.7.8.2
+         * @see {@link MatterSpecification.v141.Cluster} § 6.6.7.8.2
          */
         shouldRecordSeries: TlvField(1, TlvBoolean),
 
         /**
          * This field, if present, shall indicate the list of additional external content identifiers.
          *
-         * @see {@link MatterSpecification.v14.Cluster} § 6.6.7.8.3
+         * @see {@link MatterSpecification.v141.Cluster} § 6.6.7.8.3
          */
         externalIdList: TlvOptionalField(2, TlvArray(ContentLauncher.TlvAdditionalInfo, { maxLength: 255 })),
 
         /**
          * This field, if present, shall indicate app-specific data.
          *
-         * @see {@link MatterSpecification.v14.Cluster} § 6.6.7.8.4
+         * @see {@link MatterSpecification.v141.Cluster} § 6.6.7.8.4
          */
         data: TlvOptionalField(3, TlvByteString.bound({ maxLength: 8092 }))
     });
@@ -813,27 +845,27 @@ export namespace Channel {
     /**
      * Input to the Channel cancelRecordProgram command
      *
-     * @see {@link MatterSpecification.v14.Cluster} § 6.6.7.8
+     * @see {@link MatterSpecification.v141.Cluster} § 6.6.7.8
      */
     export interface CancelRecordProgramRequest extends TypeFromSchema<typeof TlvCancelRecordProgramRequest> {}
 
     /**
      * Input to the Channel changeChannelByNumber command
      *
-     * @see {@link MatterSpecification.v14.Cluster} § 6.6.7.3
+     * @see {@link MatterSpecification.v141.Cluster} § 6.6.7.3
      */
     export const TlvChangeChannelByNumberRequest = TlvObject({
         /**
          * This field shall indicate the channel major number value (ATSC format) to which the channel should change.
          *
-         * @see {@link MatterSpecification.v14.Cluster} § 6.6.7.3.1
+         * @see {@link MatterSpecification.v141.Cluster} § 6.6.7.3.1
          */
         majorNumber: TlvField(0, TlvUInt16),
 
         /**
          * This field shall indicate the channel minor number value (ATSC format) to which the channel should change.
          *
-         * @see {@link MatterSpecification.v14.Cluster} § 6.6.7.3.2
+         * @see {@link MatterSpecification.v141.Cluster} § 6.6.7.3.2
          */
         minorNumber: TlvField(1, TlvUInt16)
     });
@@ -841,21 +873,21 @@ export namespace Channel {
     /**
      * Input to the Channel changeChannelByNumber command
      *
-     * @see {@link MatterSpecification.v14.Cluster} § 6.6.7.3
+     * @see {@link MatterSpecification.v141.Cluster} § 6.6.7.3
      */
     export interface ChangeChannelByNumberRequest extends TypeFromSchema<typeof TlvChangeChannelByNumberRequest> {}
 
     /**
      * Input to the Channel skipChannel command
      *
-     * @see {@link MatterSpecification.v14.Cluster} § 6.6.7.4
+     * @see {@link MatterSpecification.v141.Cluster} § 6.6.7.4
      */
     export const TlvSkipChannelRequest = TlvObject({
         /**
          * This field shall indicate the number of steps to increase (Count is positive) or decrease (Count is negative)
          * the current channel.
          *
-         * @see {@link MatterSpecification.v14.Cluster} § 6.6.7.4.1
+         * @see {@link MatterSpecification.v141.Cluster} § 6.6.7.4.1
          */
         count: TlvField(0, TlvInt16)
     });
@@ -863,7 +895,7 @@ export namespace Channel {
     /**
      * Input to the Channel skipChannel command
      *
-     * @see {@link MatterSpecification.v14.Cluster} § 6.6.7.4
+     * @see {@link MatterSpecification.v141.Cluster} § 6.6.7.4
      */
     export interface SkipChannelRequest extends TypeFromSchema<typeof TlvSkipChannelRequest> {}
 
@@ -875,7 +907,7 @@ export namespace Channel {
             /**
              * This attribute shall provide the list of supported channels.
              *
-             * @see {@link MatterSpecification.v14.Cluster} § 6.6.6.1
+             * @see {@link MatterSpecification.v141.Cluster} § 6.6.6.1
              */
             channelList: Attribute(0x0, TlvArray(TlvChannelInfo), { default: [] })
         }
@@ -889,7 +921,7 @@ export namespace Channel {
             /**
              * This attribute shall identify the channel lineup using external data sources.
              *
-             * @see {@link MatterSpecification.v14.Cluster} § 6.6.6.2
+             * @see {@link MatterSpecification.v141.Cluster} § 6.6.6.2
              */
             lineup: Attribute(0x1, TlvNullable(TlvLineupInfo), { default: null })
         }
@@ -910,7 +942,7 @@ export namespace Channel {
              *
              * Upon success, the CurrentChannel attribute, if supported, shall be updated to reflect the change.
              *
-             * @see {@link MatterSpecification.v14.Cluster} § 6.6.7.1
+             * @see {@link MatterSpecification.v141.Cluster} § 6.6.7.1
              */
             changeChannel: Command(0x0, TlvChangeChannelRequest, 0x1, TlvChangeChannelResponse)
         }
@@ -927,7 +959,7 @@ export namespace Channel {
              * ProgramGuideResponse. Standard error codes shall be used when arguments provided are not valid. For
              * example, if StartTime is greater than EndTime, the status code INVALID_ACTION shall be returned.
              *
-             * @see {@link MatterSpecification.v14.Cluster} § 6.6.7.5
+             * @see {@link MatterSpecification.v141.Cluster} § 6.6.7.5
              */
             getProgramGuide: Command(0x4, TlvGetProgramGuideRequest, 0x5, TlvProgramGuideResponse)
         }
@@ -941,14 +973,14 @@ export namespace Channel {
             /**
              * Record a specific program or series when it goes live. This functionality enables DVR recording features.
              *
-             * @see {@link MatterSpecification.v14.Cluster} § 6.6.7.7
+             * @see {@link MatterSpecification.v141.Cluster} § 6.6.7.7
              */
             recordProgram: Command(0x6, TlvRecordProgramRequest, 0x6, TlvNoResponse),
 
             /**
              * Cancel recording for a specific program or series.
              *
-             * @see {@link MatterSpecification.v14.Cluster} § 6.6.7.8
+             * @see {@link MatterSpecification.v141.Cluster} § 6.6.7.8
              */
             cancelRecordProgram: Command(0x7, TlvCancelRecordProgramRequest, 0x7, TlvNoResponse)
         }
@@ -989,7 +1021,7 @@ export namespace Channel {
              * This attribute shall contain the current channel. When supported but a channel is not currently tuned to
              * (if a content application is in foreground), the value of the field shall be null.
              *
-             * @see {@link MatterSpecification.v14.Cluster} § 6.6.6.3
+             * @see {@link MatterSpecification.v141.Cluster} § 6.6.6.3
              */
             currentChannel: OptionalAttribute(0x2, TlvNullable(TlvChannelInfo), { default: null })
         },
@@ -998,7 +1030,7 @@ export namespace Channel {
             /**
              * Change the channel to the channel with the given Number in the ChannelList attribute.
              *
-             * @see {@link MatterSpecification.v14.Cluster} § 6.6.7.3
+             * @see {@link MatterSpecification.v141.Cluster} § 6.6.7.3
              */
             changeChannelByNumber: Command(0x2, TlvChangeChannelByNumberRequest, 0x2, TlvNoResponse),
 
@@ -1011,7 +1043,7 @@ export namespace Channel {
              * continue. For example, if the current channel is at index 0 and count value of -1 is given, then the
              * current channel should change to the last channel.
              *
-             * @see {@link MatterSpecification.v14.Cluster} § 6.6.7.4
+             * @see {@link MatterSpecification.v141.Cluster} § 6.6.7.4
              */
             skipChannel: Command(0x3, TlvSkipChannelRequest, 0x3, TlvNoResponse)
         },
@@ -1052,7 +1084,7 @@ export namespace Channel {
      *
      * ChannelCluster supports optional features that you can enable with the ChannelCluster.with() factory method.
      *
-     * @see {@link MatterSpecification.v14.Cluster} § 6.6
+     * @see {@link MatterSpecification.v141.Cluster} § 6.6
      */
     export interface Cluster extends Identity<typeof ClusterInstance> {}