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

package/src/clusters/media-playback.ts

@@ -19,6 +19,8 @@ import { TlvEpochUs, TlvUInt64, TlvFloat, TlvEnum, TlvUInt8 } from "../tlv/TlvNu
 import { TlvNullable } from "../tlv/TlvNullable.js";
 import { TlvField, TlvObject, TlvOptionalField } from "../tlv/TlvObject.js";
 import { TypeFromSchema } from "../tlv/TlvSchema.js";
+import { StatusResponseError } from "../common/StatusResponseError.js";
+import { Status as GlobalStatus } from "../globals/Status.js";
 import { TlvString, TlvByteString } from "../tlv/TlvString.js";
 import { TlvArray } from "../tlv/TlvArray.js";
 import { TlvNoArguments } from "../tlv/TlvNoArguments.js";
@@ -31,7 +33,7 @@ export namespace MediaPlayback {
     /**
      * These are optional features supported by MediaPlaybackCluster.
      *
-     * @see {@link MatterSpecification.v14.Cluster} § 6.10.4
+     * @see {@link MatterSpecification.v141.Cluster} § 6.10.4
      */
     export enum Feature {
         /**
@@ -41,7 +43,7 @@ export namespace MediaPlayback {
          * to a specific location using time offsets. This enables clients to implement more advanced media seeking
          * behavior in their user interface, for instance a "seek bar".
          *
-         * @see {@link MatterSpecification.v14.Cluster} § 6.10.4.1
+         * @see {@link MatterSpecification.v141.Cluster} § 6.10.4.1
          */
         AdvancedSeek = "AdvancedSeek",
 
@@ -50,7 +52,7 @@ export namespace MediaPlayback {
          *
          * This feature is for a device which supports variable speed playback on media that supports it.
          *
-         * @see {@link MatterSpecification.v14.Cluster} § 6.10.4.2
+         * @see {@link MatterSpecification.v141.Cluster} § 6.10.4.2
          */
         VariableSpeed = "VariableSpeed",
 
@@ -59,7 +61,7 @@ export namespace MediaPlayback {
          *
          * This feature is for a device or app that supports Text Tracks.
          *
-         * @see {@link MatterSpecification.v14.Cluster} § 6.10.4.3
+         * @see {@link MatterSpecification.v141.Cluster} § 6.10.4.3
          */
         TextTracks = "TextTracks",
 
@@ -68,7 +70,7 @@ export namespace MediaPlayback {
          *
          * This feature is for a device or app that supports Audio Tracks.
          *
-         * @see {@link MatterSpecification.v14.Cluster} § 6.10.4.4
+         * @see {@link MatterSpecification.v141.Cluster} § 6.10.4.4
          */
         AudioTracks = "AudioTracks",
 
@@ -81,7 +83,7 @@ export namespace MediaPlayback {
          *
          * A cluster implementing AA shall implement AS.
          *
-         * @see {@link MatterSpecification.v14.Cluster} § 6.10.4.5
+         * @see {@link MatterSpecification.v141.Cluster} § 6.10.4.5
          */
         AudioAdvance = "AudioAdvance"
     }
@@ -89,13 +91,13 @@ export namespace MediaPlayback {
     /**
      * This structure defines a playback position within a media stream being played.
      *
-     * @see {@link MatterSpecification.v14.Cluster} § 6.10.5.4
+     * @see {@link MatterSpecification.v141.Cluster} § 6.10.5.4
      */
     export const TlvPlaybackPosition = TlvObject({
         /**
          * This field shall indicate the time when the position was last updated.
          *
-         * @see {@link MatterSpecification.v14.Cluster} § 6.10.5.4.1
+         * @see {@link MatterSpecification.v141.Cluster} § 6.10.5.4.1
          */
         updatedAt: TlvField(0, TlvEpochUs),
 
@@ -108,7 +110,7 @@ export namespace MediaPlayback {
          * A value of null shall indicate that playback position is not applicable for the current state of the media
          * playback (For example : Live media with no known duration and where seek is not supported).
          *
-         * @see {@link MatterSpecification.v14.Cluster} § 6.10.5.4.2
+         * @see {@link MatterSpecification.v141.Cluster} § 6.10.5.4.2
          */
         position: TlvField(1, TlvNullable(TlvUInt64))
     });
@@ -116,14 +118,14 @@ export namespace MediaPlayback {
     /**
      * This structure defines a playback position within a media stream being played.
      *
-     * @see {@link MatterSpecification.v14.Cluster} § 6.10.5.4
+     * @see {@link MatterSpecification.v141.Cluster} § 6.10.5.4
      */
     export interface PlaybackPosition extends TypeFromSchema<typeof TlvPlaybackPosition> {}
 
     /**
      * Input to the MediaPlayback seek command
      *
-     * @see {@link MatterSpecification.v14.Cluster} § 6.10.7.11
+     * @see {@link MatterSpecification.v141.Cluster} § 6.10.7.11
      */
     export const TlvSeekRequest = TlvObject({
         /**
@@ -134,7 +136,7 @@ export namespace MediaPlayback {
          * the status of SEEK_OUT_OF_RANGE shall be returned and no change shall be made to the position of the
          * playback.
          *
-         * @see {@link MatterSpecification.v14.Cluster} § 6.10.7.11.1
+         * @see {@link MatterSpecification.v141.Cluster} § 6.10.7.11.1
          */
         position: TlvField(0, TlvUInt64)
     });
@@ -142,12 +144,12 @@ export namespace MediaPlayback {
     /**
      * Input to the MediaPlayback seek command
      *
-     * @see {@link MatterSpecification.v14.Cluster} § 6.10.7.11
+     * @see {@link MatterSpecification.v141.Cluster} § 6.10.7.11
      */
     export interface SeekRequest extends TypeFromSchema<typeof TlvSeekRequest> {}
 
     /**
-     * @see {@link MatterSpecification.v14.Cluster} § 6.10.5.2
+     * @see {@link MatterSpecification.v141.Cluster} § 6.10.5.2
      */
     export enum Status {
         /**
@@ -183,23 +185,98 @@ export namespace MediaPlayback {
         SeekOutOfRange = 5
     }
 
+    /**
+     * Thrown for cluster status code {@link Status.InvalidStateForCommand}.
+     *
+     * @see {@link MatterSpecification.v141.Cluster} § 6.10.5.2
+     */
+    export class InvalidStateForCommandError extends StatusResponseError {
+        constructor(
+            message = "Requested playback command is invalid in the current playback state",
+            code = GlobalStatus.Failure,
+            clusterCode = Status.InvalidStateForCommand
+        ) {
+            super(message, code, clusterCode);
+        }
+    }
+
+    /**
+     * Thrown for cluster status code {@link Status.NotAllowed}.
+     *
+     * @see {@link MatterSpecification.v141.Cluster} § 6.10.5.2
+     */
+    export class NotAllowedError extends StatusResponseError {
+        constructor(
+            message = "Requested playback command is not allowed in the current playback state. For example, attempting to fast-forward during a commercial might return NotAllowed",
+            code = GlobalStatus.Failure,
+            clusterCode = Status.NotAllowed
+        ) {
+            super(message, code, clusterCode);
+        }
+    }
+
+    /**
+     * Thrown for cluster status code {@link Status.NotActive}.
+     *
+     * @see {@link MatterSpecification.v141.Cluster} § 6.10.5.2
+     */
+    export class NotActiveError extends StatusResponseError {
+        constructor(
+            message = "This endpoint is not active for playback",
+            code = GlobalStatus.Failure,
+            clusterCode = Status.NotActive
+        ) {
+            super(message, code, clusterCode);
+        }
+    }
+
+    /**
+     * Thrown for cluster status code {@link Status.SpeedOutOfRange}.
+     *
+     * @see {@link MatterSpecification.v141.Cluster} § 6.10.5.2
+     */
+    export class SpeedOutOfRangeError extends StatusResponseError {
+        constructor(
+            message = "The FastForward or Rewind Command was issued but the media is already playing back at the fastest speed supported by the server in the respective direction",
+            code = GlobalStatus.Failure,
+            clusterCode = Status.SpeedOutOfRange
+        ) {
+            super(message, code, clusterCode);
+        }
+    }
+
+    /**
+     * Thrown for cluster status code {@link Status.SeekOutOfRange}.
+     *
+     * @see {@link MatterSpecification.v141.Cluster} § 6.10.5.2
+     */
+    export class SeekOutOfRangeError extends StatusResponseError {
+        constructor(
+            message = "The Seek Command was issued with a value of position outside of the allowed seek range of the media",
+            code = GlobalStatus.Failure,
+            clusterCode = Status.SeekOutOfRange
+        ) {
+            super(message, code, clusterCode);
+        }
+    }
+
     /**
      * This command shall be generated in response to various Playback Commands.
      *
-     * @see {@link MatterSpecification.v14.Cluster} § 6.10.7.12
+     * @see {@link MatterSpecification.v141.Cluster} § 6.10.7.12
      */
     export const TlvPlaybackResponse = TlvObject({
         /**
          * This field shall indicate the status of the command which resulted in this response.
          *
-         * @see {@link MatterSpecification.v14.Cluster} § 6.10.7.12.1
+         * @see {@link MatterSpecification.v141.Cluster} § 6.10.7.12.1
          */
         status: TlvField(0, TlvEnum<Status>()),
 
         /**
          * This field shall indicate Optional app-specific data.
          *
-         * @see {@link MatterSpecification.v14.Cluster} § 6.10.7.12.2
+         * @see {@link MatterSpecification.v141.Cluster} § 6.10.7.12.2
          */
         data: TlvOptionalField(1, TlvString)
     });
@@ -207,12 +284,12 @@ export namespace MediaPlayback {
     /**
      * This command shall be generated in response to various Playback Commands.
      *
-     * @see {@link MatterSpecification.v14.Cluster} § 6.10.7.12
+     * @see {@link MatterSpecification.v141.Cluster} § 6.10.7.12
      */
     export interface PlaybackResponse extends TypeFromSchema<typeof TlvPlaybackResponse> {}
 
     /**
-     * @see {@link MatterSpecification.v14.Cluster} § 6.10.5.3
+     * @see {@link MatterSpecification.v141.Cluster} § 6.10.5.3
      */
     export enum Characteristic {
         /**
@@ -321,14 +398,14 @@ export namespace MediaPlayback {
     /**
      * This structure includes the attributes associated with a Text/Audio Track
      *
-     * @see {@link MatterSpecification.v14.Cluster} § 6.10.5.6
+     * @see {@link MatterSpecification.v141.Cluster} § 6.10.5.6
      */
     export const TlvTrackAttributes = TlvObject({
         /**
          * The value is a String containing one of the standard Tags for Identifying Languages RFC 5646, which
          * identifies the primary language used in the Track.
          *
-         * @see {@link MatterSpecification.v14.Cluster} § 6.10.5.6.1
+         * @see {@link MatterSpecification.v141.Cluster} § 6.10.5.6.1
          */
         languageCode: TlvField(0, TlvString.bound({ maxLength: 32 })),
 
@@ -336,7 +413,7 @@ export namespace MediaPlayback {
          * This is a list of enumerated CharacteristicEnum values that indicate a purpose, trait or feature associated
          * with the Track. A value of null shall indicate that there are no Characteristics corresponding to the Track.
          *
-         * @see {@link MatterSpecification.v14.Cluster} § 6.10.5.6.2
+         * @see {@link MatterSpecification.v141.Cluster} § 6.10.5.6.2
          */
         characteristics: TlvOptionalField(1, TlvNullable(TlvArray(TlvEnum<Characteristic>()))),
 
@@ -344,7 +421,7 @@ export namespace MediaPlayback {
          * The value is a String containing a user displayable name for the Track. A value of null shall indicate that
          * there is no DisplayName corresponding to the Track.
          *
-         * @see {@link MatterSpecification.v14.Cluster} § 6.10.5.6.3
+         * @see {@link MatterSpecification.v141.Cluster} § 6.10.5.6.3
          */
         displayName: TlvOptionalField(2, TlvNullable(TlvString.bound({ maxLength: 256 })))
     });
@@ -352,28 +429,28 @@ export namespace MediaPlayback {
     /**
      * This structure includes the attributes associated with a Text/Audio Track
      *
-     * @see {@link MatterSpecification.v14.Cluster} § 6.10.5.6
+     * @see {@link MatterSpecification.v141.Cluster} § 6.10.5.6
      */
     export interface TrackAttributes extends TypeFromSchema<typeof TlvTrackAttributes> {}
 
     /**
      * This structure defines a uniquely identifiable Text Track or Audio Track.
      *
-     * @see {@link MatterSpecification.v14.Cluster} § 6.10.5.5
+     * @see {@link MatterSpecification.v141.Cluster} § 6.10.5.5
      */
     export const TlvTrack = TlvObject({
         /**
          * This field shall indicate the Identifier for the Track which is unique within the Track catalog. The Track
          * catalog contains all the Text/Audio tracks corresponding to the main media content.
          *
-         * @see {@link MatterSpecification.v14.Cluster} § 6.10.5.5.1
+         * @see {@link MatterSpecification.v141.Cluster} § 6.10.5.5.1
          */
         id: TlvField(0, TlvString.bound({ maxLength: 32 })),
 
         /**
          * This field shall indicate the Attributes associated to the Track, like languageCode.
          *
-         * @see {@link MatterSpecification.v14.Cluster} § 6.10.5.5.2
+         * @see {@link MatterSpecification.v141.Cluster} § 6.10.5.5.2
          */
         trackAttributes: TlvField(1, TlvTrackAttributes)
     });
@@ -381,20 +458,20 @@ export namespace MediaPlayback {
     /**
      * This structure defines a uniquely identifiable Text Track or Audio Track.
      *
-     * @see {@link MatterSpecification.v14.Cluster} § 6.10.5.5
+     * @see {@link MatterSpecification.v141.Cluster} § 6.10.5.5
      */
     export interface Track extends TypeFromSchema<typeof TlvTrack> {}
 
     /**
      * Input to the MediaPlayback activateAudioTrack command
      *
-     * @see {@link MatterSpecification.v14.Cluster} § 6.10.7.13
+     * @see {@link MatterSpecification.v141.Cluster} § 6.10.7.13
      */
     export const TlvActivateAudioTrackRequest = TlvObject({
         /**
          * This field shall indicate the Audio Track to activate.
          *
-         * @see {@link MatterSpecification.v14.Cluster} § 6.10.7.13.1
+         * @see {@link MatterSpecification.v141.Cluster} § 6.10.7.13.1
          */
         trackId: TlvField(0, TlvString.bound({ maxLength: 32 })),
 
@@ -404,7 +481,7 @@ export namespace MediaPlayback {
          * Tracks and only present for Audio Tracks. A value of null shall indicate that the server can choose the audio
          * output(s) to play the Audio Track on.
          *
-         * @see {@link MatterSpecification.v14.Cluster} § 6.10.7.13.2
+         * @see {@link MatterSpecification.v141.Cluster} § 6.10.7.13.2
          */
         audioOutputIndex: TlvOptionalField(1, TlvNullable(TlvUInt8))
     });
@@ -412,20 +489,20 @@ export namespace MediaPlayback {
     /**
      * Input to the MediaPlayback activateAudioTrack command
      *
-     * @see {@link MatterSpecification.v14.Cluster} § 6.10.7.13
+     * @see {@link MatterSpecification.v141.Cluster} § 6.10.7.13
      */
     export interface ActivateAudioTrackRequest extends TypeFromSchema<typeof TlvActivateAudioTrackRequest> {}
 
     /**
      * Input to the MediaPlayback activateTextTrack command
      *
-     * @see {@link MatterSpecification.v14.Cluster} § 6.10.7.14
+     * @see {@link MatterSpecification.v141.Cluster} § 6.10.7.14
      */
     export const TlvActivateTextTrackRequest = TlvObject({
         /**
          * This field shall indicate the Text Track to activate.
          *
-         * @see {@link MatterSpecification.v14.Cluster} § 6.10.7.14.1
+         * @see {@link MatterSpecification.v141.Cluster} § 6.10.7.14.1
          */
         trackId: TlvField(0, TlvString.bound({ maxLength: 32 }))
     });
@@ -433,14 +510,14 @@ export namespace MediaPlayback {
     /**
      * Input to the MediaPlayback activateTextTrack command
      *
-     * @see {@link MatterSpecification.v14.Cluster} § 6.10.7.14
+     * @see {@link MatterSpecification.v141.Cluster} § 6.10.7.14
      */
     export interface ActivateTextTrackRequest extends TypeFromSchema<typeof TlvActivateTextTrackRequest> {}
 
     /**
      * Input to the MediaPlayback rewind command
      *
-     * @see {@link MatterSpecification.v14.Cluster} § 6.10.7.7
+     * @see {@link MatterSpecification.v141.Cluster} § 6.10.7.7
      */
     export const TlvRewindRequest = TlvObject({
         /**
@@ -449,7 +526,7 @@ export namespace MediaPlayback {
          * A value of true does not guarantee that audio can be heard by the user since the speaker may be muted, turned
          * down to a low level and/or unplugged.
          *
-         * @see {@link MatterSpecification.v14.Cluster} § 6.10.7.7.1
+         * @see {@link MatterSpecification.v141.Cluster} § 6.10.7.7.1
          */
         audioAdvanceUnmuted: TlvOptionalField(0, TlvBoolean)
     });
@@ -457,14 +534,14 @@ export namespace MediaPlayback {
     /**
      * Input to the MediaPlayback rewind command
      *
-     * @see {@link MatterSpecification.v14.Cluster} § 6.10.7.7
+     * @see {@link MatterSpecification.v141.Cluster} § 6.10.7.7
      */
     export interface RewindRequest extends TypeFromSchema<typeof TlvRewindRequest> {}
 
     /**
      * Input to the MediaPlayback fastForward command
      *
-     * @see {@link MatterSpecification.v14.Cluster} § 6.10.7.8
+     * @see {@link MatterSpecification.v141.Cluster} § 6.10.7.8
      */
     export const TlvFastForwardRequest = TlvObject({
         /**
@@ -473,7 +550,7 @@ export namespace MediaPlayback {
          * A value of true does not guarantee that audio can be heard by the user since the speaker may be muted, turned
          * down to a low level and/or unplugged.
          *
-         * @see {@link MatterSpecification.v14.Cluster} § 6.10.7.8.1
+         * @see {@link MatterSpecification.v141.Cluster} § 6.10.7.8.1
          */
         audioAdvanceUnmuted: TlvOptionalField(0, TlvBoolean)
     });
@@ -481,12 +558,12 @@ export namespace MediaPlayback {
     /**
      * Input to the MediaPlayback fastForward command
      *
-     * @see {@link MatterSpecification.v14.Cluster} § 6.10.7.8
+     * @see {@link MatterSpecification.v141.Cluster} § 6.10.7.8
      */
     export interface FastForwardRequest extends TypeFromSchema<typeof TlvFastForwardRequest> {}
 
     /**
-     * @see {@link MatterSpecification.v14.Cluster} § 6.10.5.1
+     * @see {@link MatterSpecification.v141.Cluster} § 6.10.5.1
      */
     export enum PlaybackState {
         /**
@@ -513,7 +590,7 @@ export namespace MediaPlayback {
     /**
      * Input to the MediaPlayback skipForward command
      *
-     * @see {@link MatterSpecification.v14.Cluster} § 6.10.7.9
+     * @see {@link MatterSpecification.v141.Cluster} § 6.10.7.9
      */
     export const TlvSkipForwardRequest = TlvObject({
         /**
@@ -524,7 +601,7 @@ export namespace MediaPlayback {
          * should be set to that furthest valid position. If the SampledPosition attribute is supported it shall be
          * updated on the cluster accordingly.
          *
-         * @see {@link MatterSpecification.v14.Cluster} § 6.10.7.9.1
+         * @see {@link MatterSpecification.v141.Cluster} § 6.10.7.9.1
          */
         deltaPositionMilliseconds: TlvField(0, TlvUInt64)
     });
@@ -532,14 +609,14 @@ export namespace MediaPlayback {
     /**
      * Input to the MediaPlayback skipForward command
      *
-     * @see {@link MatterSpecification.v14.Cluster} § 6.10.7.9
+     * @see {@link MatterSpecification.v141.Cluster} § 6.10.7.9
      */
     export interface SkipForwardRequest extends TypeFromSchema<typeof TlvSkipForwardRequest> {}
 
     /**
      * Input to the MediaPlayback skipBackward command
      *
-     * @see {@link MatterSpecification.v14.Cluster} § 6.10.7.10
+     * @see {@link MatterSpecification.v141.Cluster} § 6.10.7.10
      */
     export const TlvSkipBackwardRequest = TlvObject({
         /**
@@ -550,7 +627,7 @@ export namespace MediaPlayback {
          * set to that earliest valid position. If the SampledPosition attribute is supported it shall be updated on the
          * cluster accordingly.
          *
-         * @see {@link MatterSpecification.v14.Cluster} § 6.10.7.10.1
+         * @see {@link MatterSpecification.v141.Cluster} § 6.10.7.10.1
          */
         deltaPositionMilliseconds: TlvField(0, TlvUInt64)
     });
@@ -558,21 +635,21 @@ export namespace MediaPlayback {
     /**
      * Input to the MediaPlayback skipBackward command
      *
-     * @see {@link MatterSpecification.v14.Cluster} § 6.10.7.10
+     * @see {@link MatterSpecification.v141.Cluster} § 6.10.7.10
      */
     export interface SkipBackwardRequest extends TypeFromSchema<typeof TlvSkipBackwardRequest> {}
 
     /**
      * Body of the MediaPlayback stateChanged event
      *
-     * @see {@link MatterSpecification.v14.Cluster} § 6.10.8.1
+     * @see {@link MatterSpecification.v141.Cluster} § 6.10.8.1
      */
     export const TlvStateChangedEvent = TlvObject({
         /**
          * This field shall indicate the updated playback state as defined by the CurrentState attribute, and has the
          * same constraint as that attribute.
          *
-         * @see {@link MatterSpecification.v14.Cluster} § 6.10.8.1.1
+         * @see {@link MatterSpecification.v141.Cluster} § 6.10.8.1.1
          */
         currentState: TlvField(0, TlvEnum<PlaybackState>()),
 
@@ -580,7 +657,7 @@ export namespace MediaPlayback {
          * This field shall indicate the updated start time as defined by the StartTime attribute, and has the same
          * constraint as that attribute.
          *
-         * @see {@link MatterSpecification.v14.Cluster} § 6.10.8.1.2
+         * @see {@link MatterSpecification.v141.Cluster} § 6.10.8.1.2
          */
         startTime: TlvOptionalField(1, TlvEpochUs),
 
@@ -588,7 +665,7 @@ export namespace MediaPlayback {
          * This field shall indicate the updated duration as defined by the Duration attribute, and has the same
          * constraint as that attribute.
          *
-         * @see {@link MatterSpecification.v14.Cluster} § 6.10.8.1.3
+         * @see {@link MatterSpecification.v141.Cluster} § 6.10.8.1.3
          */
         duration: TlvOptionalField(2, TlvUInt64),
 
@@ -596,7 +673,7 @@ export namespace MediaPlayback {
          * This field shall indicate the updated position of playback as defined by the SampledPosition attribute, and
          * has the same constraint as that attribute.
          *
-         * @see {@link MatterSpecification.v14.Cluster} § 6.10.8.1.4
+         * @see {@link MatterSpecification.v141.Cluster} § 6.10.8.1.4
          */
         sampledPosition: TlvOptionalField(3, TlvPlaybackPosition),
 
@@ -604,7 +681,7 @@ export namespace MediaPlayback {
          * This field shall indicate the updated speed at which the current media is being played as defined by the
          * PlaybackSpeed attribute, and has the same constraint as that attribute.
          *
-         * @see {@link MatterSpecification.v14.Cluster} § 6.10.8.1.5
+         * @see {@link MatterSpecification.v141.Cluster} § 6.10.8.1.5
          */
         playbackSpeed: TlvOptionalField(4, TlvFloat),
 
@@ -612,7 +689,7 @@ export namespace MediaPlayback {
          * This field shall indicate the updated start of the seek range end as defined by the SeekRangeEnd attribute,
          * and has the same constraint as that attribute.
          *
-         * @see {@link MatterSpecification.v14.Cluster} § 6.10.8.1.7
+         * @see {@link MatterSpecification.v141.Cluster} § 6.10.8.1.7
          */
         seekRangeEnd: TlvOptionalField(5, TlvUInt64),
 
@@ -620,14 +697,14 @@ export namespace MediaPlayback {
          * This field shall indicate the updated start of the seek range start as defined by the SeekRangeStart
          * attribute, and has the same constraint as that attribute.
          *
-         * @see {@link MatterSpecification.v14.Cluster} § 6.10.8.1.6
+         * @see {@link MatterSpecification.v141.Cluster} § 6.10.8.1.6
          */
         seekRangeStart: TlvOptionalField(6, TlvUInt64),
 
         /**
          * This field shall indicate Optional app-specific data.
          *
-         * @see {@link MatterSpecification.v14.Cluster} § 6.10.8.1.8
+         * @see {@link MatterSpecification.v141.Cluster} § 6.10.8.1.8
          */
         data: TlvOptionalField(7, TlvByteString.bound({ maxLength: 900 })),
 
@@ -640,7 +717,7 @@ export namespace MediaPlayback {
          * A value of true does not guarantee that audio can be heard by the user since the speaker may be muted, turned
          * down to a low level and/or unplugged.
          *
-         * @see {@link MatterSpecification.v14.Cluster} § 6.10.8.1.9
+         * @see {@link MatterSpecification.v141.Cluster} § 6.10.8.1.9
          */
         audioAdvanceUnmuted: TlvOptionalField(8, TlvBoolean)
     });
@@ -648,7 +725,7 @@ export namespace MediaPlayback {
     /**
      * Body of the MediaPlayback stateChanged event
      *
-     * @see {@link MatterSpecification.v14.Cluster} § 6.10.8.1
+     * @see {@link MatterSpecification.v141.Cluster} § 6.10.8.1
      */
     export interface StateChangedEvent extends TypeFromSchema<typeof TlvStateChangedEvent> {}
 
@@ -663,7 +740,7 @@ export namespace MediaPlayback {
              * video-on-demand). This time is a UTC time. The client needs to handle conversion to local time, as
              * required, taking in account time zone and possible local DST offset.
              *
-             * @see {@link MatterSpecification.v14.Cluster} § 6.10.6.2
+             * @see {@link MatterSpecification.v141.Cluster} § 6.10.6.2
              */
             startTime: Attribute(0x1, TlvNullable(TlvEpochUs), { default: null }),
 
@@ -672,7 +749,7 @@ export namespace MediaPlayback {
              * not applicable (for example, in live streaming content with no known duration). This attribute shall
              * never be 0.
              *
-             * @see {@link MatterSpecification.v14.Cluster} § 6.10.6.3
+             * @see {@link MatterSpecification.v141.Cluster} § 6.10.6.3
              */
             duration: Attribute(0x2, TlvNullable(TlvUInt64), { default: null }),
 
@@ -694,7 +771,7 @@ export namespace MediaPlayback {
              *
              *   • Updating of playback speed as a result of explicit request, or as a result of buffering events
              *
-             * @see {@link MatterSpecification.v14.Cluster} § 6.10.6.4
+             * @see {@link MatterSpecification.v141.Cluster} § 6.10.6.4
              */
             sampledPosition: Attribute(0x3, TlvNullable(TlvPlaybackPosition), { default: null }),
 
@@ -729,7 +806,7 @@ export namespace MediaPlayback {
              *
              * Following examples illustrate the PlaybackSpeed attribute values in various conditions.
              *
-             * @see {@link MatterSpecification.v14.Cluster} § 6.10.6.5
+             * @see {@link MatterSpecification.v141.Cluster} § 6.10.6.5
              */
             playbackSpeed: Attribute(0x4, TlvFloat, { default: 0 }),
 
@@ -741,7 +818,7 @@ export namespace MediaPlayback {
              * truncating fractional milliseconds towards 0. A value of Nas when StartTime is not specified shall
              * indicate that seeking forward is not allowed.
              *
-             * @see {@link MatterSpecification.v14.Cluster} § 6.10.6.7
+             * @see {@link MatterSpecification.v141.Cluster} § 6.10.6.7
              */
             seekRangeEnd: Attribute(0x5, TlvNullable(TlvUInt64), { default: null }),
 
@@ -749,7 +826,7 @@ export namespace MediaPlayback {
              * Indicates the earliest valid position to which a client may seek back, in milliseconds from start of the
              * media. A value of Nas shall indicate that seeking backwards is not allowed.
              *
-             * @see {@link MatterSpecification.v14.Cluster} § 6.10.6.6
+             * @see {@link MatterSpecification.v141.Cluster} § 6.10.6.6
              */
             seekRangeStart: Attribute(0x6, TlvNullable(TlvUInt64), { default: null })
         },
@@ -758,7 +835,7 @@ export namespace MediaPlayback {
             /**
              * Upon receipt, this shall change the playback position in the media to the given position.
              *
-             * @see {@link MatterSpecification.v14.Cluster} § 6.10.7.11
+             * @see {@link MatterSpecification.v141.Cluster} § 6.10.7.11
              */
             seek: Command(0xb, TlvSeekRequest, 0xa, TlvPlaybackResponse)
         }
@@ -773,7 +850,7 @@ export namespace MediaPlayback {
              * ActiveTrack refers to the Audio track currently set and being used for the streaming media. A value of
              * null shall indicate that no Audio Track corresponding to the current media is currently being played.
              *
-             * @see {@link MatterSpecification.v14.Cluster} § 6.10.6.8
+             * @see {@link MatterSpecification.v141.Cluster} § 6.10.6.8
              */
             activeAudioTrack: Attribute(0x7, TlvNullable(TlvTrack), { default: null }),
 
@@ -782,7 +859,7 @@ export namespace MediaPlayback {
              * value of null shall indicate that no Audio Tracks corresponding to the current media are selectable by
              * the client.
              *
-             * @see {@link MatterSpecification.v14.Cluster} § 6.10.6.9
+             * @see {@link MatterSpecification.v141.Cluster} § 6.10.6.9
              */
             availableAudioTracks: Attribute(0x8, TlvNullable(TlvArray(TlvTrack)), { default: null })
         },
@@ -794,7 +871,7 @@ export namespace MediaPlayback {
              * correspond to the streaming media OR no media is being streamed at the time of receipt of this command,
              * the server will return an error status of INVALID_ARGUMENT.
              *
-             * @see {@link MatterSpecification.v14.Cluster} § 6.10.7.13
+             * @see {@link MatterSpecification.v141.Cluster} § 6.10.7.13
              */
             activateAudioTrack: Command(0xc, TlvActivateAudioTrackRequest, 0xc, TlvNoResponse)
         }
@@ -810,7 +887,7 @@ export namespace MediaPlayback {
              * nil. A value of null shall indicate that no Text Track corresponding to the current media is currently
              * being displayed.
              *
-             * @see {@link MatterSpecification.v14.Cluster} § 6.10.6.10
+             * @see {@link MatterSpecification.v141.Cluster} § 6.10.6.10
              */
             activeTextTrack: Attribute(0x9, TlvNullable(TlvTrack), { default: null }),
 
@@ -819,7 +896,7 @@ export namespace MediaPlayback {
              * can be an empty list. A value of null shall indicate that no Text Tracks corresponding to the current
              * media are selectable by the client.
              *
-             * @see {@link MatterSpecification.v14.Cluster} § 6.10.6.11
+             * @see {@link MatterSpecification.v141.Cluster} § 6.10.6.11
              */
             availableTextTracks: Attribute(0xa, TlvNullable(TlvArray(TlvTrack)), { default: null })
         },
@@ -831,7 +908,7 @@ export namespace MediaPlayback {
              * correspond to the streaming media OR no media is being streamed at the time of receipt of this command,
              * the server shall return an error status of INVALID_ARGUMENT.
              *
-             * @see {@link MatterSpecification.v14.Cluster} § 6.10.7.14
+             * @see {@link MatterSpecification.v141.Cluster} § 6.10.7.14
              */
             activateTextTrack: Command(0xd, TlvActivateTextTrackRequest, 0xd, TlvNoResponse),
 
@@ -839,7 +916,7 @@ export namespace MediaPlayback {
              * If a Text Track is active (i.e. being displayed), upon receipt of this command, the server shall stop
              * displaying it.
              *
-             * @see {@link MatterSpecification.v14.Cluster} § 6.10.7.15
+             * @see {@link MatterSpecification.v141.Cluster} § 6.10.7.15
              */
             deactivateTextTrack: Command(0xe, TlvNoArguments, 0xe, TlvNoResponse)
         }
@@ -863,7 +940,7 @@ export namespace MediaPlayback {
              * returned. If the playback speed has reached the maximum supported speed for media playing backwards, the
              * status of SPEED_OUT_OF_RANGE shall be returned.
              *
-             * @see {@link MatterSpecification.v14.Cluster} § 6.10.7.7
+             * @see {@link MatterSpecification.v141.Cluster} § 6.10.7.7
              */
             rewind: Command(0x6, TlvRewindRequest, 0xa, TlvPlaybackResponse),
 
@@ -880,7 +957,7 @@ export namespace MediaPlayback {
              * returned. If the playback speed has reached the maximum supported speed for media playing forward, the
              * status of SPEED_OUT_OF_RANGE shall be returned.
              *
-             * @see {@link MatterSpecification.v14.Cluster} § 6.10.7.8
+             * @see {@link MatterSpecification.v141.Cluster} § 6.10.7.8
              */
             fastForward: Command(0x7, TlvFastForwardRequest, 0xa, TlvPlaybackResponse)
         }
@@ -900,28 +977,28 @@ export namespace MediaPlayback {
              * jumping to a specific location using time offsets. This enables clients to implement more advanced media
              * seeking behavior in their user interface, for instance a "seek bar".
              *
-             * @see {@link MatterSpecification.v14.Cluster} § 6.10.4.1
+             * @see {@link MatterSpecification.v141.Cluster} § 6.10.4.1
              */
             advancedSeek: BitFlag(0),
 
             /**
              * This feature is for a device which supports variable speed playback on media that supports it.
              *
-             * @see {@link MatterSpecification.v14.Cluster} § 6.10.4.2
+             * @see {@link MatterSpecification.v141.Cluster} § 6.10.4.2
              */
             variableSpeed: BitFlag(1),
 
             /**
              * This feature is for a device or app that supports Text Tracks.
              *
-             * @see {@link MatterSpecification.v14.Cluster} § 6.10.4.3
+             * @see {@link MatterSpecification.v141.Cluster} § 6.10.4.3
              */
             textTracks: BitFlag(2),
 
             /**
              * This feature is for a device or app that supports Audio Tracks.
              *
-             * @see {@link MatterSpecification.v14.Cluster} § 6.10.4.4
+             * @see {@link MatterSpecification.v141.Cluster} § 6.10.4.4
              */
             audioTracks: BitFlag(3),
 
@@ -932,7 +1009,7 @@ export namespace MediaPlayback {
              *
              * A cluster implementing AA shall implement AS.
              *
-             * @see {@link MatterSpecification.v14.Cluster} § 6.10.4.5
+             * @see {@link MatterSpecification.v141.Cluster} § 6.10.4.5
              */
             audioAdvance: BitFlag(4)
         },
@@ -943,7 +1020,7 @@ export namespace MediaPlayback {
              *
              * During fast-forward, rewind, and other seek operations; this attribute shall be set to PLAYING.
              *
-             * @see {@link MatterSpecification.v14.Cluster} § 6.10.6.1
+             * @see {@link MatterSpecification.v141.Cluster} § 6.10.6.1
              */
             currentState: Attribute(0x0, TlvEnum<PlaybackState>())
         },
@@ -953,14 +1030,14 @@ export namespace MediaPlayback {
              * Upon receipt, this shall play media. If content is currently in a FastForward or Rewind state. Play shall
              * return media to normal playback speed.
              *
-             * @see {@link MatterSpecification.v14.Cluster} § 6.10.7.1
+             * @see {@link MatterSpecification.v141.Cluster} § 6.10.7.1
              */
             play: Command(0x0, TlvNoArguments, 0xa, TlvPlaybackResponse),
 
             /**
              * Upon receipt, this shall pause playback of the media.
              *
-             * @see {@link MatterSpecification.v14.Cluster} § 6.10.7.2
+             * @see {@link MatterSpecification.v141.Cluster} § 6.10.7.2
              */
             pause: Command(0x1, TlvNoArguments, 0xa, TlvPlaybackResponse),
 
@@ -968,14 +1045,14 @@ export namespace MediaPlayback {
              * Upon receipt, this shall stop playback of the media. User-visible outcome is context-specific. This may
              * navigate the user back to the location from where the media was originally launched.
              *
-             * @see {@link MatterSpecification.v14.Cluster} § 6.10.7.3
+             * @see {@link MatterSpecification.v141.Cluster} § 6.10.7.3
              */
             stop: Command(0x2, TlvNoArguments, 0xa, TlvPlaybackResponse),
 
             /**
              * Upon receipt, this shall Start Over with the current media playback item.
              *
-             * @see {@link MatterSpecification.v14.Cluster} § 6.10.7.4
+             * @see {@link MatterSpecification.v141.Cluster} § 6.10.7.4
              */
             startOver: OptionalCommand(0x3, TlvNoArguments, 0xa, TlvPlaybackResponse),
 
@@ -983,7 +1060,7 @@ export namespace MediaPlayback {
              * Upon receipt, this shall cause the handler to be invoked for "Previous". User experience is
              * context-specific. This will often Go back to the previous media playback item.
              *
-             * @see {@link MatterSpecification.v14.Cluster} § 6.10.7.5
+             * @see {@link MatterSpecification.v141.Cluster} § 6.10.7.5
              */
             previous: OptionalCommand(0x4, TlvNoArguments, 0xa, TlvPlaybackResponse),
 
@@ -991,21 +1068,21 @@ export namespace MediaPlayback {
              * Upon receipt, this shall cause the handler to be invoked for "Next". User experience is context-specific.
              * This will often Go forward to the next media playback item.
              *
-             * @see {@link MatterSpecification.v14.Cluster} § 6.10.7.6
+             * @see {@link MatterSpecification.v141.Cluster} § 6.10.7.6
              */
             next: OptionalCommand(0x5, TlvNoArguments, 0xa, TlvPlaybackResponse),
 
             /**
              * Upon receipt, this shall Skip forward in the media by the given number of milliseconds.
              *
-             * @see {@link MatterSpecification.v14.Cluster} § 6.10.7.9
+             * @see {@link MatterSpecification.v141.Cluster} § 6.10.7.9
              */
             skipForward: OptionalCommand(0x8, TlvSkipForwardRequest, 0xa, TlvPlaybackResponse),
 
             /**
              * Upon receipt, this shall Skip backward in the media by the given number of milliseconds.
              *
-             * @see {@link MatterSpecification.v14.Cluster} § 6.10.7.10
+             * @see {@link MatterSpecification.v141.Cluster} § 6.10.7.10
              */
             skipBackward: OptionalCommand(0x9, TlvSkipBackwardRequest, 0xa, TlvPlaybackResponse)
         },
@@ -1015,7 +1092,7 @@ export namespace MediaPlayback {
              * If supported, this event shall be generated when there is a change in any of the supported attributes of
              * the Media Playback cluster.
              *
-             * @see {@link MatterSpecification.v14.Cluster} § 6.10.8.1
+             * @see {@link MatterSpecification.v141.Cluster} § 6.10.8.1
              */
             stateChanged: OptionalEvent(0x0, EventPriority.Info, TlvStateChangedEvent)
         },
@@ -1047,7 +1124,7 @@ export namespace MediaPlayback {
      * MediaPlaybackCluster supports optional features that you can enable with the MediaPlaybackCluster.with() factory
      * method.
      *
-     * @see {@link MatterSpecification.v14.Cluster} § 6.10
+     * @see {@link MatterSpecification.v141.Cluster} § 6.10
      */
     export interface Cluster extends Identity<typeof ClusterInstance> {}