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

package/src/clusters/operational-state.ts

@@ -44,7 +44,7 @@ export namespace OperationalState {
      *
      * The following table defines the generally applicable states.
      *
-     * @see {@link MatterSpecification.v14.Cluster} § 1.14.4.1
+     * @see {@link MatterSpecification.v141.Cluster} § 1.14.4.1
      */
     export enum OperationalStateEnum {
         /**
@@ -71,13 +71,13 @@ export namespace OperationalState {
     /**
      * The OperationalStateStruct is used to indicate a possible state of the device.
      *
-     * @see {@link MatterSpecification.v14.Cluster} § 1.14.4.2
+     * @see {@link MatterSpecification.v141.Cluster} § 1.14.4.2
      */
     export const TlvOperationalStateStruct = TlvObject({
         /**
          * This shall be populated with a value from the OperationalStateEnum.
          *
-         * @see {@link MatterSpecification.v14.Cluster} § 1.14.4.2.1
+         * @see {@link MatterSpecification.v141.Cluster} § 1.14.4.2.1
          */
         operationalStateId: TlvField(0, TlvEnum<OperationalStateEnum>()),
 
@@ -86,7 +86,7 @@ export namespace OperationalState {
          * States, otherwise it shall NOT be present. If present, this shall contain a human-readable description of the
          * operational state.
          *
-         * @see {@link MatterSpecification.v14.Cluster} § 1.14.4.2.2
+         * @see {@link MatterSpecification.v141.Cluster} § 1.14.4.2.2
          */
         operationalStateLabel: TlvOptionalField(1, TlvString.bound({ maxLength: 64 }))
     });
@@ -94,7 +94,7 @@ export namespace OperationalState {
     /**
      * The OperationalStateStruct is used to indicate a possible state of the device.
      *
-     * @see {@link MatterSpecification.v14.Cluster} § 1.14.4.2
+     * @see {@link MatterSpecification.v141.Cluster} § 1.14.4.2
      */
     export interface OperationalStateStruct extends TypeFromSchema<typeof TlvOperationalStateStruct> {}
 
@@ -117,7 +117,7 @@ export namespace OperationalState {
      * The set of ErrorStateID field values defined in each of the generic or derived Operational State cluster
      * specifications is called ErrorState.
      *
-     * @see {@link MatterSpecification.v14.Cluster} § 1.14.4.3
+     * @see {@link MatterSpecification.v141.Cluster} § 1.14.4.3
      */
     export enum ErrorState {
         /**
@@ -142,13 +142,13 @@ export namespace OperationalState {
     }
 
     /**
-     * @see {@link MatterSpecification.v14.Cluster} § 1.14.4.4
+     * @see {@link MatterSpecification.v141.Cluster} § 1.14.4.4
      */
     export const TlvErrorStateStruct = TlvObject({
         /**
          * This shall be populated with a value from the ErrorStateEnum.
          *
-         * @see {@link MatterSpecification.v14.Cluster} § 1.14.4.4.1
+         * @see {@link MatterSpecification.v141.Cluster} § 1.14.4.4.1
          */
         errorStateId: TlvField(0, TlvEnum<ErrorState>()),
 
@@ -158,7 +158,7 @@ export namespace OperationalState {
          * ErrorStateID; e.g. for a manufacturer specific ErrorStateID of "0x80" the ErrorStateLabel may contain "My
          * special error".
          *
-         * @see {@link MatterSpecification.v14.Cluster} § 1.14.4.4.2
+         * @see {@link MatterSpecification.v141.Cluster} § 1.14.4.4.2
          */
         errorStateLabel: TlvOptionalField(1, TlvString.bound({ maxLength: 64 })),
 
@@ -167,13 +167,13 @@ export namespace OperationalState {
          * ErrorStateID indicates that the device is a Robotic Vacuum that is stuck, the ErrorStateDetails contains
          * "left wheel blocked".
          *
-         * @see {@link MatterSpecification.v14.Cluster} § 1.14.4.4.3
+         * @see {@link MatterSpecification.v141.Cluster} § 1.14.4.4.3
          */
         errorStateDetails: TlvOptionalField(2, TlvString.bound({ maxLength: 64 }))
     });
 
     /**
-     * @see {@link MatterSpecification.v14.Cluster} § 1.14.4.4
+     * @see {@link MatterSpecification.v141.Cluster} § 1.14.4.4
      */
     export interface ErrorStateStruct extends TypeFromSchema<typeof TlvErrorStateStruct> {}
 
@@ -184,7 +184,7 @@ export namespace OperationalState {
      *
      * This command shall be generated in response to any of the Start, Stop, Pause, or Resume commands.
      *
-     * @see {@link MatterSpecification.v14.Cluster} § 1.14.6.5
+     * @see {@link MatterSpecification.v141.Cluster} § 1.14.6.5
      */
     export const TlvOperationalCommandResponse = TlvObject({
         /**
@@ -192,7 +192,7 @@ export namespace OperationalState {
          * of the attempted command, the ErrorStateID shall be populated with NoError. Please see the individual command
          * sections for additional specific requirements on population.
          *
-         * @see {@link MatterSpecification.v14.Cluster} § 1.14.6.5.1
+         * @see {@link MatterSpecification.v141.Cluster} § 1.14.6.5.1
          */
         commandResponseState: TlvField(0, TlvErrorStateStruct)
     });
@@ -204,35 +204,35 @@ export namespace OperationalState {
      *
      * This command shall be generated in response to any of the Start, Stop, Pause, or Resume commands.
      *
-     * @see {@link MatterSpecification.v14.Cluster} § 1.14.6.5
+     * @see {@link MatterSpecification.v141.Cluster} § 1.14.6.5
      */
     export interface OperationalCommandResponse extends TypeFromSchema<typeof TlvOperationalCommandResponse> {}
 
     /**
      * Body of the OperationalState operationalError event
      *
-     * @see {@link MatterSpecification.v14.Cluster} § 1.14.7.1
+     * @see {@link MatterSpecification.v141.Cluster} § 1.14.7.1
      */
     export const TlvOperationalErrorEvent = TlvObject({ errorState: TlvField(0, TlvErrorStateStruct) });
 
     /**
      * Body of the OperationalState operationalError event
      *
-     * @see {@link MatterSpecification.v14.Cluster} § 1.14.7.1
+     * @see {@link MatterSpecification.v141.Cluster} § 1.14.7.1
      */
     export interface OperationalErrorEvent extends TypeFromSchema<typeof TlvOperationalErrorEvent> {}
 
     /**
      * Body of the OperationalState operationCompletion event
      *
-     * @see {@link MatterSpecification.v14.Cluster} § 1.14.7.2
+     * @see {@link MatterSpecification.v141.Cluster} § 1.14.7.2
      */
     export const TlvOperationCompletionEvent = TlvObject({
         /**
          * This field provides an indication of the state at the end of the operation. This field shall have a value
          * from the ErrorStateEnum set. A value of NoError indicates success, that is, no error has been detected.
          *
-         * @see {@link MatterSpecification.v14.Cluster} § 1.14.7.2.1
+         * @see {@link MatterSpecification.v141.Cluster} § 1.14.7.2.1
          */
         completionErrorCode: TlvField(0, TlvUInt8),
 
@@ -242,7 +242,7 @@ export namespace OperationalState {
          * There may be cases whereby the total operational time exceeds the maximum value that can be conveyed by this
          * attribute, in such instances, this attribute shall be populated with null.
          *
-         * @see {@link MatterSpecification.v14.Cluster} § 1.14.7.2.2
+         * @see {@link MatterSpecification.v141.Cluster} § 1.14.7.2.2
          */
         totalOperationalTime: TlvOptionalField(1, TlvNullable(TlvUInt32)),
 
@@ -251,7 +251,7 @@ export namespace OperationalState {
          * exceeds the maximum value that can be conveyed by this attribute, in such instances, this attribute shall be
          * populated with null.
          *
-         * @see {@link MatterSpecification.v14.Cluster} § 1.14.7.2.3
+         * @see {@link MatterSpecification.v141.Cluster} § 1.14.7.2.3
          */
         pausedTime: TlvOptionalField(2, TlvNullable(TlvUInt32))
     });
@@ -259,7 +259,7 @@ export namespace OperationalState {
     /**
      * Body of the OperationalState operationCompletion event
      *
-     * @see {@link MatterSpecification.v14.Cluster} § 1.14.7.2
+     * @see {@link MatterSpecification.v141.Cluster} § 1.14.7.2
      */
     export interface OperationCompletionEvent extends TypeFromSchema<typeof TlvOperationCompletionEvent> {}
 
@@ -281,7 +281,7 @@ export namespace OperationalState {
              * A null value indicates that the device does not present phases during its operation. When this
              * attribute’s value is null, the CurrentPhase attribute shall also be set to null.
              *
-             * @see {@link MatterSpecification.v14.Cluster} § 1.14.5.1
+             * @see {@link MatterSpecification.v141.Cluster} § 1.14.5.1
              */
             phaseList: Attribute(0x0, TlvNullable(TlvArray(TlvString, { maxLength: 32 }))),
 
@@ -293,7 +293,7 @@ export namespace OperationalState {
              *
              * Null if the PhaseList attribute is null or if the PhaseList attribute is an empty list.
              *
-             * @see {@link MatterSpecification.v14.Cluster} § 1.14.5.2
+             * @see {@link MatterSpecification.v141.Cluster} § 1.14.5.2
              */
             currentPhase: Attribute(0x1, TlvNullable(TlvUInt8)),
 
@@ -326,7 +326,7 @@ export namespace OperationalState {
              * As this attribute is not being reported during a regular countdown, clients SHOULD NOT rely on the
              * reporting of this attribute in order to keep track of the remaining duration.
              *
-             * @see {@link MatterSpecification.v14.Cluster} § 1.14.5.3
+             * @see {@link MatterSpecification.v141.Cluster} § 1.14.5.3
              */
             countdownTime: OptionalAttribute(0x2, TlvNullable(TlvUInt32.bound({ max: 259200 })), { default: null }),
 
@@ -340,7 +340,7 @@ export namespace OperationalState {
              * OperationalStateEnum. A device type requiring implementation of this cluster shall define the set of
              * states that are applicable to that specific device type.
              *
-             * @see {@link MatterSpecification.v14.Cluster} § 1.14.5.4
+             * @see {@link MatterSpecification.v141.Cluster} § 1.14.5.4
              */
             operationalStateList: Attribute(0x3, TlvArray(TlvOperationalStateStruct), { default: [] }),
 
@@ -348,7 +348,7 @@ export namespace OperationalState {
              * This attribute specifies the current operational state of a device. This shall be populated with a valid
              * OperationalStateID from the set of values in the OperationalStateList Attribute.
              *
-             * @see {@link MatterSpecification.v14.Cluster} § 1.14.5.5
+             * @see {@link MatterSpecification.v141.Cluster} § 1.14.5.5
              */
             operationalState: Attribute(0x4, TlvEnum<OperationalStateEnum>()),
 
@@ -359,7 +359,7 @@ export namespace OperationalState {
              *
              * When there is no error detected, this shall have an ErrorStateID of NoError.
              *
-             * @see {@link MatterSpecification.v14.Cluster} § 1.14.5.6
+             * @see {@link MatterSpecification.v141.Cluster} § 1.14.5.6
              */
             operationalError: Attribute(0x5, TlvErrorStateStruct)
         },
@@ -402,7 +402,7 @@ export namespace OperationalState {
              *
              * ### Table 3. Pause Compatibility
              *
-             * @see {@link MatterSpecification.v14.Cluster} § 1.14.6.1
+             * @see {@link MatterSpecification.v141.Cluster} § 1.14.6.1
              */
             pause: OptionalCommand(0x0, TlvNoArguments, 0x4, TlvOperationalCommandResponse),
 
@@ -427,7 +427,7 @@ export namespace OperationalState {
              *
              *   • The device shall respond with an OperationalCommandResponse command with an ErrorStateID of NoError.
              *
-             * @see {@link MatterSpecification.v14.Cluster} § 1.14.6.2
+             * @see {@link MatterSpecification.v141.Cluster} § 1.14.6.2
              */
             stop: OptionalCommand(0x1, TlvNoArguments, 0x4, TlvOperationalCommandResponse),
 
@@ -454,7 +454,7 @@ export namespace OperationalState {
              *
              *   • The device shall respond with an OperationalCommandResponse command with an ErrorStateID of NoError.
              *
-             * @see {@link MatterSpecification.v14.Cluster} § 1.14.6.3
+             * @see {@link MatterSpecification.v141.Cluster} § 1.14.6.3
              */
             start: OptionalCommand(0x2, TlvNoArguments, 0x4, TlvOperationalCommandResponse),
 
@@ -496,7 +496,7 @@ export namespace OperationalState {
              *
              *   • The device shall respond with an OperationalCommandResponse command with an ErrorStateID of NoError.
              *
-             * @see {@link MatterSpecification.v14.Cluster} § 1.14.6.4
+             * @see {@link MatterSpecification.v141.Cluster} § 1.14.6.4
              */
             resume: OptionalCommand(0x3, TlvNoArguments, 0x4, TlvOperationalCommandResponse)
         },
@@ -508,7 +508,7 @@ export namespace OperationalState {
              *
              * This event shall contain the following fields:
              *
-             * @see {@link MatterSpecification.v14.Cluster} § 1.14.7.1
+             * @see {@link MatterSpecification.v141.Cluster} § 1.14.7.1
              */
             operationalError: Event(0x0, EventPriority.Critical, TlvOperationalErrorEvent),
 
@@ -523,7 +523,7 @@ export namespace OperationalState {
              *
              * This event shall contain the following fields:
              *
-             * @see {@link MatterSpecification.v14.Cluster} § 1.14.7.2
+             * @see {@link MatterSpecification.v141.Cluster} § 1.14.7.2
              */
             operationCompletion: OptionalEvent(0x1, EventPriority.Info, TlvOperationCompletionEvent)
         }
@@ -549,7 +549,7 @@ export namespace OperationalState {
      *
      * Additionally, this cluster provides events for monitoring the operational state of the device.
      *
-     * @see {@link MatterSpecification.v14.Cluster} § 1.14
+     * @see {@link MatterSpecification.v141.Cluster} § 1.14
      */
     export interface Cluster extends Identity<typeof ClusterInstance> {}
 

package/src/clusters/ota-software-update-provider.ts

@@ -15,6 +15,8 @@ import { TlvArray } from "../tlv/TlvArray.js";
 import { TlvString, TlvByteString } from "../tlv/TlvString.js";
 import { TlvBoolean } from "../tlv/TlvBoolean.js";
 import { TypeFromSchema } from "../tlv/TlvSchema.js";
+import { StatusResponseError } from "../common/StatusResponseError.js";
+import { Status as GlobalStatus } from "../globals/Status.js";
 import { Identity } from "#general";
 import { ClusterRegistry } from "../cluster/ClusterRegistry.js";
 
@@ -23,7 +25,7 @@ export namespace OtaSoftwareUpdateProvider {
      * Note that only HTTP over TLS (HTTPS) is supported (see RFC 7230). Using HTTP without TLS shall NOT be supported,
      * as there is no way to authenticate the involved participants.
      *
-     * @see {@link MatterSpecification.v14.Core} § 11.20.6.4.3
+     * @see {@link MatterSpecification.v141.Core} § 11.20.6.4.3
      */
     export enum DownloadProtocol {
         /**
@@ -50,14 +52,14 @@ export namespace OtaSoftwareUpdateProvider {
     /**
      * Input to the OtaSoftwareUpdateProvider queryImage command
      *
-     * @see {@link MatterSpecification.v14.Core} § 11.20.6.5.1
+     * @see {@link MatterSpecification.v141.Core} § 11.20.6.5.1
      */
     export const TlvQueryImageRequest = TlvObject({
         /**
          * The value shall be the Vendor ID applying to the OTA Requestor’s Node and shall match the value reported by
          * the Basic Information Cluster VendorID attribute.
          *
-         * @see {@link MatterSpecification.v14.Core} § 11.20.6.5.1.1
+         * @see {@link MatterSpecification.v141.Core} § 11.20.6.5.1.1
          */
         vendorId: TlvField(0, TlvVendorId),
 
@@ -65,7 +67,7 @@ export namespace OtaSoftwareUpdateProvider {
          * The value shall be the Product ID applying to the OTA Requestor’s Node and shall match the value reported by
          * the Basic Information Cluster ProductID attribute.
          *
-         * @see {@link MatterSpecification.v14.Core} § 11.20.6.5.1.2
+         * @see {@link MatterSpecification.v141.Core} § 11.20.6.5.1.2
          */
         productId: TlvField(1, TlvUInt16),
 
@@ -74,7 +76,7 @@ export namespace OtaSoftwareUpdateProvider {
          * running on the OTA Requestor invoking the command. This version shall be equal to the Software Version
          * attribute of the Basic Information Cluster.
          *
-         * @see {@link MatterSpecification.v14.Core} § 11.20.6.5.1.3
+         * @see {@link MatterSpecification.v141.Core} § 11.20.6.5.1.3
          */
         softwareVersion: TlvField(2, TlvUInt32),
 
@@ -93,7 +95,7 @@ export namespace OtaSoftwareUpdateProvider {
          * See Section 11.20.3.2, “Querying the OTA Provider” and Section 11.20.3.5, “Transfer of OTA Software Update
          * images” for more details about usage of this field.
          *
-         * @see {@link MatterSpecification.v14.Core} § 11.20.6.5.1.4
+         * @see {@link MatterSpecification.v141.Core} § 11.20.6.5.1.4
          */
         protocolsSupported: TlvField(3, TlvArray(TlvEnum<DownloadProtocol>(), { maxLength: 8 })),
 
@@ -101,7 +103,7 @@ export namespace OtaSoftwareUpdateProvider {
          * The value of this field, if present, shall contain the OTA Requestor’s hardware version, and shall be equal
          * to the HardwareVersion attribute of the Basic Information Cluster.
          *
-         * @see {@link MatterSpecification.v14.Core} § 11.20.6.5.1.5
+         * @see {@link MatterSpecification.v141.Core} § 11.20.6.5.1.5
          */
         hardwareVersion: TlvOptionalField(4, TlvUInt16),
 
@@ -110,7 +112,7 @@ export namespace OtaSoftwareUpdateProvider {
          * for the OTA Requestor as configured. This may be used by the OTA Provider logic to allow per-region selection
          * of the Software Image.
          *
-         * @see {@link MatterSpecification.v14.Core} § 11.20.6.5.1.6
+         * @see {@link MatterSpecification.v141.Core} § 11.20.6.5.1.6
          */
         location: TlvOptionalField(5, TlvString.bound({ length: 2 })),
 
@@ -120,7 +122,7 @@ export namespace OtaSoftwareUpdateProvider {
          *
          * See Section 11.20.3.4, “Obtaining user consent for updating software” for application details about usage.
          *
-         * @see {@link MatterSpecification.v14.Core} § 11.20.6.5.1.7
+         * @see {@link MatterSpecification.v141.Core} § 11.20.6.5.1.7
          */
         requestorCanConsent: TlvOptionalField(6, TlvBoolean),
 
@@ -152,7 +154,7 @@ export namespace OtaSoftwareUpdateProvider {
          * See Section 11.20.3.2, “Querying the OTA Provider” for full details about the OTA Software Update Query flow
          * which makes use of this command.
          *
-         * @see {@link MatterSpecification.v14.Core} § 11.20.6.5.1.8
+         * @see {@link MatterSpecification.v141.Core} § 11.20.6.5.1.8
          */
         metadataForProvider: TlvOptionalField(7, TlvByteString.bound({ maxLength: 512 }))
     });
@@ -160,14 +162,14 @@ export namespace OtaSoftwareUpdateProvider {
     /**
      * Input to the OtaSoftwareUpdateProvider queryImage command
      *
-     * @see {@link MatterSpecification.v14.Core} § 11.20.6.5.1
+     * @see {@link MatterSpecification.v141.Core} § 11.20.6.5.1
      */
     export interface QueryImageRequest extends TypeFromSchema<typeof TlvQueryImageRequest> {}
 
     /**
      * See Section 11.20.3.2, “Querying the OTA Provider” for the semantics of these values.
      *
-     * @see {@link MatterSpecification.v14.Core} § 11.20.6.4.1
+     * @see {@link MatterSpecification.v141.Core} § 11.20.6.4.1
      */
     export enum Status {
         /**
@@ -192,7 +194,67 @@ export namespace OtaSoftwareUpdateProvider {
     }
 
     /**
-     * @see {@link MatterSpecification.v14.Core} § 11.20.6.5.2
+     * Thrown for cluster status code {@link Status.UpdateAvailable}.
+     *
+     * @see {@link MatterSpecification.v141.Core} § 11.20.6.4.1
+     */
+    export class UpdateAvailableError extends StatusResponseError {
+        constructor(
+            message = "Indicates that the OTA Provider has an update available",
+            code = GlobalStatus.Failure,
+            clusterCode = Status.UpdateAvailable
+        ) {
+            super(message, code, clusterCode);
+        }
+    }
+
+    /**
+     * Thrown for cluster status code {@link Status.Busy}.
+     *
+     * @see {@link MatterSpecification.v141.Core} § 11.20.6.4.1
+     */
+    export class BusyError extends StatusResponseError {
+        constructor(
+            message = "Indicates OTA Provider may have an update, but it is not ready yet",
+            code = GlobalStatus.Failure,
+            clusterCode = Status.Busy
+        ) {
+            super(message, code, clusterCode);
+        }
+    }
+
+    /**
+     * Thrown for cluster status code {@link Status.NotAvailable}.
+     *
+     * @see {@link MatterSpecification.v141.Core} § 11.20.6.4.1
+     */
+    export class NotAvailableError extends StatusResponseError {
+        constructor(
+            message = "Indicates that there is definitely no update currently available from the OTA Provider",
+            code = GlobalStatus.Failure,
+            clusterCode = Status.NotAvailable
+        ) {
+            super(message, code, clusterCode);
+        }
+    }
+
+    /**
+     * Thrown for cluster status code {@link Status.DownloadProtocolNotSupported}.
+     *
+     * @see {@link MatterSpecification.v141.Core} § 11.20.6.4.1
+     */
+    export class DownloadProtocolNotSupportedError extends StatusResponseError {
+        constructor(
+            message = "Indicates that the requested download protocol is not supported by the OTA Provider",
+            code = GlobalStatus.Failure,
+            clusterCode = Status.DownloadProtocolNotSupported
+        ) {
+            super(message, code, clusterCode);
+        }
+    }
+
+    /**
+     * @see {@link MatterSpecification.v141.Core} § 11.20.6.5.2
      */
     export const TlvQueryImageResponse = TlvObject({
         /**
@@ -201,7 +263,7 @@ export namespace OtaSoftwareUpdateProvider {
          * See Section 11.20.3.2, “Querying the OTA Provider” for details about the possible values for this field and
          * their meaning.
          *
-         * @see {@link MatterSpecification.v14.Core} § 11.20.6.5.2.1
+         * @see {@link MatterSpecification.v141.Core} § 11.20.6.5.2.1
          */
         status: TlvField(0, TlvEnum<Status>()),
 
@@ -216,7 +278,7 @@ export namespace OtaSoftwareUpdateProvider {
          *
          * See Section 11.20.3.2, “Querying the OTA Provider” for details about the rules regarding this field.
          *
-         * @see {@link MatterSpecification.v14.Core} § 11.20.6.5.2.2
+         * @see {@link MatterSpecification.v141.Core} § 11.20.6.5.2.2
          */
         delayedActionTime: TlvOptionalField(1, TlvUInt32),
 
@@ -317,7 +379,7 @@ export namespace OtaSoftwareUpdateProvider {
          *
          * See Section 11.20.3.2, “Querying the OTA Provider” for additional details about the flow.
          *
-         * @see {@link MatterSpecification.v14.Core} § 11.20.6.5.2.3
+         * @see {@link MatterSpecification.v141.Core} § 11.20.6.5.2.3
          */
         imageUri: TlvOptionalField(2, TlvString.bound({ maxLength: 256 })),
 
@@ -330,7 +392,7 @@ export namespace OtaSoftwareUpdateProvider {
          * See Section 11.20.3.2, “Querying the OTA Provider” for additional details about the flow and acceptable
          * values.
          *
-         * @see {@link MatterSpecification.v14.Core} § 11.20.6.5.2.4
+         * @see {@link MatterSpecification.v141.Core} § 11.20.6.5.2.4
          */
         softwareVersion: TlvOptionalField(3, TlvUInt32),
 
@@ -343,7 +405,7 @@ export namespace OtaSoftwareUpdateProvider {
          * See Section 11.20.3.2, “Querying the OTA Provider” for additional details about the flow and acceptable
          * values.
          *
-         * @see {@link MatterSpecification.v14.Core} § 11.20.6.5.2.5
+         * @see {@link MatterSpecification.v141.Core} § 11.20.6.5.2.5
          */
         softwareVersionString: TlvOptionalField(4, TlvString.bound({ minLength: 1, maxLength: 64 })),
 
@@ -353,7 +415,7 @@ export namespace OtaSoftwareUpdateProvider {
          * See Section 11.20.3.6.1, “UpdateToken usage” for additional details about the generation and usage of
          * UpdateToken.
          *
-         * @see {@link MatterSpecification.v14.Core} § 11.20.6.5.2.6
+         * @see {@link MatterSpecification.v141.Core} § 11.20.6.5.2.6
          */
         updateToken: TlvOptionalField(5, TlvByteString.bound({ minLength: 8, maxLength: 32 })),
 
@@ -365,7 +427,7 @@ export namespace OtaSoftwareUpdateProvider {
          *
          * See Section 11.20.3.4, “Obtaining user consent for updating software” for application details about usage.
          *
-         * @see {@link MatterSpecification.v14.Core} § 11.20.6.5.2.7
+         * @see {@link MatterSpecification.v141.Core} § 11.20.6.5.2.7
          */
         userConsentNeeded: TlvOptionalField(6, TlvBoolean),
 
@@ -382,20 +444,20 @@ export namespace OtaSoftwareUpdateProvider {
          * by an OTA Provider with this additional knowledge if it has knowledge that the receiving OTA Requestor may be
          * able to use it.
          *
-         * @see {@link MatterSpecification.v14.Core} § 11.20.6.5.2.8
+         * @see {@link MatterSpecification.v141.Core} § 11.20.6.5.2.8
          */
         metadataForRequestor: TlvOptionalField(7, TlvByteString.bound({ maxLength: 512 }))
     });
 
     /**
-     * @see {@link MatterSpecification.v14.Core} § 11.20.6.5.2
+     * @see {@link MatterSpecification.v141.Core} § 11.20.6.5.2
      */
     export interface QueryImageResponse extends TypeFromSchema<typeof TlvQueryImageResponse> {}
 
     /**
      * Input to the OtaSoftwareUpdateProvider applyUpdateRequest command
      *
-     * @see {@link MatterSpecification.v14.Core} § 11.20.6.5.3
+     * @see {@link MatterSpecification.v141.Core} § 11.20.6.5.3
      */
     export const TlvApplyUpdateRequest = TlvObject({
         /**
@@ -403,7 +465,7 @@ export namespace OtaSoftwareUpdateProvider {
          * may be used by the OTA Provider to track minimal lifecycle state to allow finer-grained scheduling of the
          * application of Software Images by OTA Requestors.
          *
-         * @see {@link MatterSpecification.v14.Core} § 11.20.6.5.3.1
+         * @see {@link MatterSpecification.v141.Core} § 11.20.6.5.3.1
          */
         updateToken: TlvField(0, TlvByteString.bound({ minLength: 8, maxLength: 32 })),
 
@@ -427,7 +489,7 @@ export namespace OtaSoftwareUpdateProvider {
          *
          * See Section 11.20.3.6, “Applying a software update” for all error-handling information.
          *
-         * @see {@link MatterSpecification.v14.Core} § 11.20.6.5.3.2
+         * @see {@link MatterSpecification.v141.Core} § 11.20.6.5.3.2
          */
         newVersion: TlvField(1, TlvUInt32)
     });
@@ -435,7 +497,7 @@ export namespace OtaSoftwareUpdateProvider {
     /**
      * Input to the OtaSoftwareUpdateProvider applyUpdateRequest command
      *
-     * @see {@link MatterSpecification.v14.Core} § 11.20.6.5.3
+     * @see {@link MatterSpecification.v141.Core} § 11.20.6.5.3
      */
     export interface ApplyUpdateRequest extends TypeFromSchema<typeof TlvApplyUpdateRequest> {}
 
@@ -443,7 +505,7 @@ export namespace OtaSoftwareUpdateProvider {
      * See Section 11.20.3.6, “Applying a software update” for the semantics of the values. This enumeration is used in
      * the Action field of the ApplyUpdateResponse command. See (Action).
      *
-     * @see {@link MatterSpecification.v14.Core} § 11.20.6.4.2
+     * @see {@link MatterSpecification.v141.Core} § 11.20.6.4.2
      */
     export enum ApplyUpdateAction {
         /**
@@ -463,7 +525,7 @@ export namespace OtaSoftwareUpdateProvider {
     }
 
     /**
-     * @see {@link MatterSpecification.v14.Core} § 11.20.6.5.4
+     * @see {@link MatterSpecification.v141.Core} § 11.20.6.5.4
      */
     export const TlvApplyUpdateResponse = TlvObject({
         /**
@@ -471,7 +533,7 @@ export namespace OtaSoftwareUpdateProvider {
          * 11.20.3.6, “Applying a software update” for a description of the Action values provided in response to an OTA
          * Provider receiving an invocation of this command.
          *
-         * @see {@link MatterSpecification.v14.Core} § 11.20.6.5.4.1
+         * @see {@link MatterSpecification.v141.Core} § 11.20.6.5.4.1
          */
         action: TlvField(0, TlvEnum<ApplyUpdateAction>()),
 
@@ -481,26 +543,26 @@ export namespace OtaSoftwareUpdateProvider {
          * If this field has a value higher than 86400 seconds (24 hours), then the OTA Requestor may assume a value of
          * 86400, in order to reduce undue Software Image application delays.
          *
-         * @see {@link MatterSpecification.v14.Core} § 11.20.6.5.4.2
+         * @see {@link MatterSpecification.v141.Core} § 11.20.6.5.4.2
          */
         delayedActionTime: TlvField(1, TlvUInt32)
     });
 
     /**
-     * @see {@link MatterSpecification.v14.Core} § 11.20.6.5.4
+     * @see {@link MatterSpecification.v141.Core} § 11.20.6.5.4
      */
     export interface ApplyUpdateResponse extends TypeFromSchema<typeof TlvApplyUpdateResponse> {}
 
     /**
      * Input to the OtaSoftwareUpdateProvider notifyUpdateApplied command
      *
-     * @see {@link MatterSpecification.v14.Core} § 11.20.6.5.5
+     * @see {@link MatterSpecification.v141.Core} § 11.20.6.5.5
      */
     export const TlvNotifyUpdateAppliedRequest = TlvObject({
         /**
          * This field shall contain the UpdateToken as specified in Section 11.20.3.6.1, “UpdateToken usage”.
          *
-         * @see {@link MatterSpecification.v14.Core} § 11.20.6.5.5.1
+         * @see {@link MatterSpecification.v141.Core} § 11.20.6.5.5.1
          */
         updateToken: TlvField(0, TlvByteString.bound({ minLength: 8, maxLength: 32 })),
 
@@ -530,7 +592,7 @@ export namespace OtaSoftwareUpdateProvider {
          * On receiving this command, an OTA Provider may use the information to update its bookkeeping of cached
          * Software Images, or use it for other similar administrative purposes.
          *
-         * @see {@link MatterSpecification.v14.Core} § 11.20.6.5.5.2
+         * @see {@link MatterSpecification.v141.Core} § 11.20.6.5.5.2
          */
         softwareVersion: TlvField(1, TlvUInt32)
     });
@@ -538,7 +600,7 @@ export namespace OtaSoftwareUpdateProvider {
     /**
      * Input to the OtaSoftwareUpdateProvider notifyUpdateApplied command
      *
-     * @see {@link MatterSpecification.v14.Core} § 11.20.6.5.5
+     * @see {@link MatterSpecification.v141.Core} § 11.20.6.5.5
      */
     export interface NotifyUpdateAppliedRequest extends TypeFromSchema<typeof TlvNotifyUpdateAppliedRequest> {}
 
@@ -555,24 +617,24 @@ export namespace OtaSoftwareUpdateProvider {
              * Upon receipt, this command shall trigger an attempt to find an updated Software Image by the OTA Provider
              * to match the OTA Requestor’s constraints provided in the payload fields.
              *
-             * @see {@link MatterSpecification.v14.Core} § 11.20.6.5.1
+             * @see {@link MatterSpecification.v141.Core} § 11.20.6.5.1
              */
             queryImage: Command(0x0, TlvQueryImageRequest, 0x1, TlvQueryImageResponse),
 
             /**
-             * @see {@link MatterSpecification.v14.Core} § 11.20.6.5.3
+             * @see {@link MatterSpecification.v141.Core} § 11.20.6.5.3
              */
             applyUpdateRequest: Command(0x2, TlvApplyUpdateRequest, 0x3, TlvApplyUpdateResponse),
 
             /**
-             * @see {@link MatterSpecification.v14.Core} § 11.20.6.5.5
+             * @see {@link MatterSpecification.v141.Core} § 11.20.6.5.5
              */
             notifyUpdateApplied: Command(0x4, TlvNotifyUpdateAppliedRequest, 0x4, TlvNoResponse)
         }
     });
 
     /**
-     * @see {@link MatterSpecification.v14.Core} § 11.20.6
+     * @see {@link MatterSpecification.v141.Core} § 11.20.6
      */
     export interface Cluster extends Identity<typeof ClusterInstance> {}