@project-chip/matter.js 0.2.0 → 0.2.1

package/dist/cjs/cluster/DescriptorCluster.js

@@ -43,11 +43,11 @@ exports.DescriptorCluster = (0, Cluster_js_1.Cluster)({
         /** List containing each cluster ID for the server clusters present on the endpoint instance. */
         serverList: (0, Cluster_js_1.Attribute)(1, (0, TlvArray_js_1.TlvArray)(ClusterId_js_1.TlvClusterId), { default: [] }),
         /** List containing each cluster ID for the client clusters present on the endpoint instance. */
-        clientList: (0, Cluster_js_1.Attribute)(3, (0, TlvArray_js_1.TlvArray)(ClusterId_js_1.TlvClusterId), { default: [] }),
+        clientList: (0, Cluster_js_1.Attribute)(2, (0, TlvArray_js_1.TlvArray)(ClusterId_js_1.TlvClusterId), { default: [] }),
         /**
          * This indicates composition of the device type instance. Device type instance composition SHALL
          * include the endpoints in this list.
          */
-        partsList: (0, Cluster_js_1.Attribute)(4, (0, TlvArray_js_1.TlvArray)(EndpointNumber_js_1.TlvEndpointNumber), { default: [] }),
+        partsList: (0, Cluster_js_1.Attribute)(3, (0, TlvArray_js_1.TlvArray)(EndpointNumber_js_1.TlvEndpointNumber), { default: [] }),
     },
 });

package/dist/cjs/cluster/OperationalCredentialsCluster.js

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

package/dist/cjs/schema/Schema.js

@@ -14,9 +14,11 @@ class Schema {
         return this.encodeInternal(value);
     }
     /** Decodes the encoded data using the schema. */
-    decode(encoded) {
+    decode(encoded, validate = true) {
         const result = this.decodeInternal(encoded);
-        this.validate(result);
+        if (validate) {
+            this.validate(result);
+        }
         return result;
     }
     /** Optional validator that can be used to enforce constraints on the data before encoding / after decoding. */

package/dist/cjs/tlv/TlvAny.js

@@ -66,6 +66,16 @@ class AnySchema extends TlvSchema_js_1.TlvSchema {
         }
         return tlvStream;
     }
+    validate(tlvStream) {
+        if (!Array.isArray(tlvStream))
+            throw new Error(`Expected TlvStream, got ${typeof tlvStream}.`);
+        tlvStream.forEach(({ typeLength }) => {
+            if (!typeLength || typeof typeLength !== "object")
+                throw new Error(`Expected typeLength properties in TlvStream, got ${typeof typeLength}.`);
+            if (typeof typeLength.type !== "number")
+                throw new Error(`Expected typeLength.type as number in TlvStream, got ${typeof typeLength.type}.`);
+        });
+    }
 }
 exports.AnySchema = AnySchema;
 exports.TlvAny = new AnySchema();

package/dist/cjs/tlv/TlvArray.js

@@ -36,14 +36,16 @@ class ArraySchema extends TlvSchema_js_1.TlvSchema {
                 break;
             result.push(this.elementSchema.decodeTlvInternalValue(reader, elementTypeLength));
         }
-        this.validate(result);
         return result;
     }
-    validate({ length }) {
-        if (length > this.maxLength)
-            throw new Error(`Array is too long: ${length}, max ${this.maxLength}.`);
-        if (length < this.minLength)
-            throw new Error(`Array is too short: ${length}, min ${this.minLength}.`);
+    validate(data) {
+        if (!Array.isArray(data))
+            throw new Error(`Expected array, got ${typeof data}.`);
+        if (data.length > this.maxLength)
+            throw new Error(`Array is too long: ${data.length}, max ${this.maxLength}.`);
+        if (data.length < this.minLength)
+            throw new Error(`Array is too short: ${data.length}, min ${this.minLength}.`);
+        data.forEach(element => this.elementSchema.validate(element));
     }
 }
 exports.ArraySchema = ArraySchema;

package/dist/cjs/tlv/TlvBoolean.js

@@ -21,6 +21,10 @@ class BooleanSchema extends TlvSchema_js_1.TlvSchema {
             throw new Error(`Unexpected type ${typeLength.type}.`);
         return typeLength.value;
     }
+    validate(value) {
+        if (typeof value !== "boolean")
+            throw new Error(`Expected boolean, got ${typeof value}.`);
+    }
 }
 exports.BooleanSchema = BooleanSchema;
 /** Boolean TLV schema. */

package/dist/cjs/tlv/TlvNullable.js

@@ -30,6 +30,10 @@ class NullableSchema extends TlvSchema_js_1.TlvSchema {
             return null;
         return this.schema.decodeTlvInternalValue(reader, typeLength);
     }
+    validate(value) {
+        if (value !== null)
+            this.schema.validate(value);
+    }
 }
 exports.NullableSchema = NullableSchema;
 /** Nullable TLV schema. */

package/dist/cjs/tlv/TlvNumber.js

@@ -33,11 +33,14 @@ class TlvNumericSchema extends TlvSchema_js_1.TlvSchema {
         if (typeLength.type !== this.type)
             throw new Error(`Unexpected type ${typeLength.type}, was expecting ${this.type}.`);
         const value = reader.readPrimitive(typeLength);
-        this.validate(value);
         return value;
     }
     validate(value) {
-        super.validate(value);
+        if (typeof value !== "number" && typeof value !== 'bigint')
+            throw new Error(`Expected number, got ${typeof value}.`);
+        this.validateBoundaries(value);
+    }
+    validateBoundaries(value) {
         if (this.min !== undefined && value < this.min)
             throw new Error(`Invalid value: ${value} is below the minimum, ${this.min}.`);
         if (this.max !== undefined && value > this.max)
@@ -60,6 +63,11 @@ class TlvNumberSchema extends TlvNumericSchema {
     bound({ min, max }) {
         return new TlvNumberSchema(this.type, this.lengthProvider, (0, Number_js_1.maxValue)(min, this.min), (0, Number_js_1.minValue)(max, this.max));
     }
+    validate(value) {
+        if (typeof value !== "number")
+            throw new Error(`Expected number, got ${typeof value}.`);
+        this.validateBoundaries(value);
+    }
 }
 exports.TlvNumberSchema = TlvNumberSchema;
 exports.TlvLongNumberSchema = (TlvNumericSchema);

package/dist/cjs/tlv/TlvObject.js

@@ -60,13 +60,28 @@ class ObjectSchema extends TlvSchema_js_1.TlvSchema {
             const { field, name } = fieldName;
             result[name] = field.schema.decodeTlvInternalValue(reader, elementTypeLength);
         }
-        this.validate(result);
+        // Check mandatory fields and, if missing, populate with fallback value if defined.
+        for (const name in this.fieldDefinitions) {
+            const { optional, fallback } = this.fieldDefinitions[name];
+            if (optional)
+                continue;
+            const value = result[name];
+            if (value !== undefined)
+                continue;
+            if (fallback === undefined)
+                throw new Error(`Missing mandatory field ${name}`);
+            result[name] = fallback;
+        }
         return result;
     }
     validate(value) {
         for (const name in this.fieldDefinitions) {
-            if (!this.fieldDefinitions[name].optional && value[name] === undefined)
+            const { optional, schema } = this.fieldDefinitions[name];
+            if (optional && value[name] === undefined)
+                continue;
+            if (!optional && value[name] === undefined)
                 throw new Error(`Missing mandatory field ${name}`);
+            schema.validate(value[name]);
         }
     }
 }
@@ -77,8 +92,12 @@ exports.TlvObject = TlvObject;
 /** List TLV schema. */
 const TlvList = (fields) => new ObjectSchema(fields, 23 /* TlvType.List */);
 exports.TlvList = TlvList;
-/** Object TLV mandatory field. */
-const TlvField = (id, schema) => ({ id, schema, optional: false });
+/**
+ * Object TLV mandatory field. Optionally provide a fallback value to initialize the field value when devices omit
+ * providing a value against the specifications or in special usecases. Make sure to use a value that is an equivalent
+ * to the value being empty.
+ */
+const TlvField = (id, schema, fallback) => ({ id, schema, fallback, optional: false });
 exports.TlvField = TlvField;
 /** Object TLV optional field. */
 const TlvOptionalField = (id, schema) => ({ id, schema, optional: true });

package/dist/cjs/tlv/TlvString.js

@@ -9,6 +9,7 @@ exports.TlvString256max = exports.TlvString64max = exports.TlvString32max = expo
 const TlvCodec_js_1 = require("./TlvCodec.js");
 const TlvSchema_js_1 = require("./TlvSchema.js");
 const Number_js_1 = require("../util/Number.js");
+const ByteArray_1 = require("../util/ByteArray");
 /**
  * Schema to encode an byte string or an Utf8 string in TLV.
  *
@@ -33,11 +34,15 @@ class StringSchema extends TlvSchema_js_1.TlvSchema {
             throw new Error(`Unexpected type ${typeLength.type}.`);
         return reader.readPrimitive(typeLength);
     }
-    validate({ length }) {
-        if (length > this.maxLength)
-            throw new Error(`Array is too long: ${length}, max ${this.maxLength}.`);
-        if (length < this.minLength)
-            throw new Error(`Array is too short: ${length}, min ${this.minLength}.`);
+    validate(value) {
+        if (this.type === 12 /* TlvType.Utf8String */ && typeof value !== "string")
+            throw new Error(`Expected string, got ${typeof value}.`);
+        if (this.type === 16 /* TlvType.ByteString */ && !(value instanceof ByteArray_1.ByteArray))
+            throw new Error(`Expected ByteArray, got ${typeof value}.`);
+        if (value.length > this.maxLength)
+            throw new Error(`String is too long: ${value.length}, max ${this.maxLength}.`);
+        if (value.length < this.minLength)
+            throw new Error(`String is too short: ${value.length}, min ${this.minLength}.`);
     }
     bound({ minLength, maxLength, length }) {
         return new StringSchema(this.type, length !== null && length !== void 0 ? length : (0, Number_js_1.maxValue)(this.minLength, minLength), length !== null && length !== void 0 ? length : (0, Number_js_1.minValue)(this.maxLength, maxLength));

package/dist/cjs/tlv/TlvVoid.js

@@ -20,6 +20,10 @@ class VoidSchema extends TlvSchema_js_1.TlvSchema {
     decodeTlvInternalValue(_reader, _typeLength) {
         throw new Error("decodeTlvInternalValue should never be called");
     }
+    validate(data) {
+        if (data !== undefined)
+            throw new Error(`Expected void, got ${typeof data}.`);
+    }
 }
 exports.VoidSchema = VoidSchema;
 /** Void TLV schema. */

package/dist/dts/cluster/AccessControlCluster.d.ts

@@ -3,7 +3,7 @@
  * Copyright 2022 Project CHIP Authors
  * SPDX-License-Identifier: Apache-2.0
  */
-import { Cluster, WritableAttribute, Attribute, Event } from "./Cluster.js";
+import { Cluster, WritableAttribute, Attribute, Event, OptionalWritableAttribute } from "./Cluster.js";
 /**
  * List of privileges that can be granted to a subject.
  *
@@ -65,7 +65,7 @@ export declare const AccessControlCluster: Cluster<import("../matter.js").BitSch
             deviceType: import("../common/DeviceTypeId.js").DeviceTypeId | null;
         }[] | null;
     }[]>;
-    extension: WritableAttribute<{
+    extension: OptionalWritableAttribute<{
         data: Uint8Array;
     }[]>;
     subjectsPerAccessControlEntry: Attribute<number>;

package/dist/dts/cluster/BasicInformationCluster.d.ts

@@ -3,7 +3,7 @@
  * Copyright 2022 Project CHIP Authors
  * SPDX-License-Identifier: Apache-2.0
  */
-import { Attribute, Cluster, Event, OptionalAttribute, WritableAttribute } from "./Cluster.js";
+import { Attribute, Cluster, Event, OptionalAttribute, OptionalWritableAttribute, WritableAttribute } from "./Cluster.js";
 /**
  * This cluster provides attributes and events for determining basic information about Nodes, which supports both
  * commissioning and operational determination of Node characteristics, such as Vendor ID, Product ID and serial number,
@@ -28,7 +28,7 @@ export declare const BasicInformationCluster: Cluster<import("../matter.js").Bit
     productURL: OptionalAttribute<string>;
     productLabel: OptionalAttribute<string>;
     serialNumber: OptionalAttribute<string>;
-    localConfigDisabled: WritableAttribute<boolean>;
+    localConfigDisabled: OptionalWritableAttribute<boolean>;
     reachable: OptionalAttribute<boolean>;
     uniqueId: OptionalAttribute<string>;
     capabilityMinima: Attribute<{

package/dist/dts/cluster/BridgedDeviceBasicInformationCluster.d.ts

@@ -3,7 +3,7 @@
  * Copyright 2022 Project CHIP Authors
  * SPDX-License-Identifier: Apache-2.0
  */
-import { Attribute, Cluster, Event, OptionalAttribute } from "./Cluster.js";
+import { Attribute, Cluster, Event, OptionalAttribute, OptionalWritableAttribute } from "./Cluster.js";
 /**
  * This Cluster serves two purposes towards a Node communicating with a Bridge:
  * * indicate that the functionality on the Endpoint where it is placed (and its Parts) is bridged from a
@@ -19,7 +19,7 @@ export declare const BridgedDeviceBasicInformationCluster: Cluster<import("../ma
     vendorName: OptionalAttribute<string>;
     vendorId: OptionalAttribute<import("../common/VendorId.js").VendorId>;
     productName: OptionalAttribute<string>;
-    nodeLabel: import("./Cluster.js").WritableAttribute<string>;
+    nodeLabel: OptionalWritableAttribute<string>;
     hardwareVersion: OptionalAttribute<number>;
     hardwareVersionString: OptionalAttribute<string>;
     softwareVersion: OptionalAttribute<number>;

package/dist/dts/cluster/Cluster.d.ts

@@ -39,7 +39,7 @@ interface AttributeOptions<T> {
 export declare const Attribute: <T, V extends T>(id: number, schema: TlvSchema<T>, { default: conformanceValue, readAcl }?: AttributeOptions<V>) => Attribute<T>;
 export declare const OptionalAttribute: <T, V extends T>(id: number, schema: TlvSchema<T>, { default: conformanceValue, readAcl }?: AttributeOptions<V>) => OptionalAttribute<T>;
 export declare const WritableAttribute: <T, V extends T>(id: number, schema: TlvSchema<T>, { default: conformanceValue, readAcl, writeAcl }?: AttributeOptions<V>) => WritableAttribute<T>;
-export declare const OptionalWritableAttribute: <T, V extends T>(id: number, schema: TlvSchema<T>, { default: conformanceValue, readAcl, writeAcl }?: AttributeOptions<V>) => WritableAttribute<T>;
+export declare const OptionalWritableAttribute: <T, V extends T>(id: number, schema: TlvSchema<T>, { default: conformanceValue, readAcl, writeAcl }?: AttributeOptions<V>) => OptionalWritableAttribute<T>;
 export declare const TlvNoArguments: import("../tlv/TlvObject.js").ObjectSchema<{}>;
 export declare const TlvNoResponse: import("../tlv/TlvVoid.js").VoidSchema;
 export interface Command<RequestT, ResponseT> {

package/dist/dts/cluster/OperationalCredentialsCluster.d.ts

@@ -12,9 +12,9 @@ export declare const RESP_MAX = 900;
  *
  * @see {@link MatterCoreSpecificationV1_0} § 11.17.5.8 */
 export declare const enum CertificateChainType {
-    /** Request the DER- encoded DAC certificate */
+    /** Requests the DER-encoded DAC certificate */
     DeviceAttestation = 1,
-    /** Request the DER- encoded PAI certificate */
+    /** Requests the DER-encoded PAI certificate */
     ProductAttestationIntermediate = 2
 }
 /**
@@ -73,8 +73,8 @@ export declare const OperationalCredentialsCluster: Cluster<import("../matter.js
         label: string;
         vendorId: import("../common/VendorId.js").VendorId;
         rootPublicKey: Uint8Array;
-        fabricID: import("../common/FabricId.js").FabricId;
-        nodeID: import("../common/NodeId.js").NodeId;
+        fabricId: import("../common/FabricId.js").FabricId;
+        nodeId: import("../common/NodeId.js").NodeId;
     }[]>;
     supportedFabrics: Attribute<number>;
     commissionedFabrics: Attribute<number>;
@@ -83,20 +83,20 @@ export declare const OperationalCredentialsCluster: Cluster<import("../matter.js
     clusterRevision: Attribute<number>;
     featureMap: Attribute<import("../matter.js").TypeFromBitSchema<import("../matter.js").BitSchema>>;
 }, {
-    /** Sender is requesting attestation information from the receiver. */
+    /** Requests attestation information. */
     requestAttestation: Command<{
         attestationNonce: Uint8Array;
     }, {
         elements: Uint8Array;
         signature: Uint8Array;
     }>;
-    /** Sender is requesting a device attestation certificate from the receiver. */
+    /** Requests a device attestation certificate. */
     requestCertChain: Command<{
         type: CertificateChainType;
     }, {
         certificate: Uint8Array;
     }>;
-    /** Sender is requesting a certificate signing request (CSR) from the receiver. */
+    /** Requests a certificate signing request (CSR). */
     requestCertSigning: Command<{
         certSigningRequestNonce: Uint8Array;
         isForUpdateNOC?: boolean | undefined;
@@ -104,7 +104,7 @@ export declare const OperationalCredentialsCluster: Cluster<import("../matter.js
         elements: Uint8Array;
         signature: Uint8Array;
     }>;
-    /** Sender is requesting to add the new node operational certificates. */
+    /** Adds new node operational certificates. */
     addOperationalCert: Command<{
         operationalCert: Uint8Array;
         identityProtectionKey: Uint8Array;
@@ -116,7 +116,7 @@ export declare const OperationalCredentialsCluster: Cluster<import("../matter.js
         fabricIndex?: import("../common/FabricIndex.js").FabricIndex | undefined;
         debugText?: string | undefined;
     }>;
-    /** Sender is requesting to update the node operational certificates. */
+    /** Updates the node operational certificates. */
     updateOperationalCert: Command<{
         operationalCert: Uint8Array;
         intermediateCaCert?: Uint8Array | undefined;
@@ -125,10 +125,7 @@ export declare const OperationalCredentialsCluster: Cluster<import("../matter.js
         fabricIndex?: import("../common/FabricIndex.js").FabricIndex | undefined;
         debugText?: string | undefined;
     }>;
-    /**
-     * This command SHALL be used by an Administrative Node to set the user-visible Label field for a given
-     * Fabric, as reflected by entries in the Fabrics attribute.
-     */
+    /** Sets the user-visible Label field for a given Fabric. */
     updateFabricLabel: Command<{
         label: string;
     }, {
@@ -136,10 +133,7 @@ export declare const OperationalCredentialsCluster: Cluster<import("../matter.js
         fabricIndex?: import("../common/FabricIndex.js").FabricIndex | undefined;
         debugText?: string | undefined;
     }>;
-    /**
-     * This command is used by Administrative Nodes to remove a given fabric index and delete all associated
-     * fabric-scoped data.
-     */
+    /** Removes a given fabric index and delete all associated fabric-scoped data. */
     removeFabric: Command<{
         fabricIndex: import("../common/FabricIndex.js").FabricIndex;
     }, {
@@ -147,9 +141,7 @@ export declare const OperationalCredentialsCluster: Cluster<import("../matter.js
         fabricIndex?: import("../common/FabricIndex.js").FabricIndex | undefined;
         debugText?: string | undefined;
     }>;
-    /**
-     * This command SHALL add a Trusted Root CA Certificate, provided as its CHIP Certificate representation.
-     */
+    /** Adds a Trusted Root CA Certificate, provided as its CHIP Certificate representation. */
     addRootCert: Command<{
         certificate: Uint8Array;
     }, void>;

package/dist/dts/schema/Schema.d.ts

@@ -8,7 +8,7 @@ export declare abstract class Schema<T, E> {
     /** Encodes the value using the schema. */
     encode(value: T): E;
     /** Decodes the encoded data using the schema. */
-    decode(encoded: E): T;
+    decode(encoded: E, validate?: boolean): T;
     protected abstract encodeInternal(value: T): E;
     protected abstract decodeInternal(encoded: E): T;
     /** Optional validator that can be used to enforce constraints on the data before encoding / after decoding. */

package/dist/dts/tlv/TlvAny.d.ts

@@ -9,5 +9,6 @@ export declare class AnySchema extends TlvSchema<TlvStream> {
     encodeTlvInternal(writer: TlvWriter, tlvStream: TlvStream, tagAssigned?: TlvTag | undefined): void;
     decodeTlvInternalValue(reader: TlvReader, typeLength: TlvTypeLength): TlvStream;
     decodeTlvValueRec(reader: TlvReader, typeLength: TlvTypeLength, tlvStream: TlvStream, tag?: TlvTag): TlvStream;
+    validate(tlvStream: TlvStream): void;
 }
 export declare const TlvAny: AnySchema;

package/dist/dts/tlv/TlvArray.d.ts

@@ -16,13 +16,13 @@ type LengthConstraints = {
  * @see {@link MatterCoreSpecificationV1_0} § A.11.2 and A.11.4
  */
 export declare class ArraySchema<T> extends TlvSchema<T[]> {
-    private readonly elementSchema;
+    readonly elementSchema: TlvSchema<T>;
     private readonly minLength;
     private readonly maxLength;
     constructor(elementSchema: TlvSchema<T>, minLength?: number, maxLength?: number);
     encodeTlvInternal(writer: TlvWriter, value: T[], tag?: TlvTag): void;
     decodeTlvInternalValue(reader: TlvReader, typeLength: TlvTypeLength): T[];
-    validate({ length }: T[]): void;
+    validate(data: T[]): void;
 }
 /** Array TLV schema. */
 export declare const TlvArray: <T>(elementSchema: TlvSchema<T>, { minLength, maxLength, length }?: LengthConstraints) => ArraySchema<T>;

package/dist/dts/tlv/TlvBoolean.d.ts

@@ -13,6 +13,7 @@ import { TlvReader, TlvSchema, TlvWriter } from "./TlvSchema.js";
 export declare class BooleanSchema extends TlvSchema<boolean> {
     encodeTlvInternal(writer: TlvWriter, value: boolean, tag?: TlvTag): void;
     decodeTlvInternalValue(_reader: TlvReader, typeLength: TlvTypeLength): boolean;
+    validate(value: boolean): void;
 }
 /** Boolean TLV schema. */
 export declare const TlvBoolean: BooleanSchema;

package/dist/dts/tlv/TlvNullable.d.ts

@@ -15,6 +15,7 @@ export declare class NullableSchema<T> extends TlvSchema<T | null> {
     constructor(schema: TlvSchema<T>);
     encodeTlvInternal(writer: TlvWriter, value: T | null, tag?: TlvTag): void;
     decodeTlvInternalValue(reader: TlvReader, typeLength: TlvTypeLength): T | null;
+    validate(value: T | null): void;
 }
 /** Nullable TLV schema. */
 export declare const TlvNullable: <T>(schema: TlvSchema<T>) => NullableSchema<T>;

package/dist/dts/tlv/TlvNumber.d.ts

@@ -16,6 +16,7 @@ export declare class TlvNumericSchema<T extends bigint | number> extends TlvSche
     encodeTlvInternal(writer: TlvWriter, value: T, tag?: TlvTag): void;
     decodeTlvInternalValue(reader: TlvReader, typeLength: TlvTypeLength): T;
     validate(value: T): void;
+    validateBoundaries(value: T): void;
     /** Restrict value range. */
     bound({ min, max }: NumericConstraints<T>): TlvNumericSchema<T>;
 }
@@ -27,6 +28,7 @@ export declare class TlvNumberSchema extends TlvNumericSchema<number> {
     constructor(type: TlvType.UnsignedInt | TlvType.SignedInt | TlvType.Float, lengthProvider: (value: number) => TlvLength, min?: number, max?: number);
     decodeTlvInternalValue(reader: TlvReader, typeLength: TlvTypeLength): number;
     bound({ min, max }: NumericConstraints<number>): TlvNumericSchema<number>;
+    validate(value: number): void;
 }
 export declare const TlvLongNumberSchema: {
     new (type: TlvType.UnsignedInt | TlvType.SignedInt | TlvType.Float, lengthProvider: (value: number | bigint) => TlvLength, min?: number | bigint | undefined, max?: number | bigint | undefined): TlvNumericSchema<number | bigint>;

package/dist/dts/tlv/TlvObject.d.ts

@@ -10,6 +10,7 @@ export interface FieldType<T> {
     id: number;
     schema: TlvSchema<T>;
     optional?: boolean;
+    fallback?: T;
 }
 export interface OptionalFieldType<T> extends FieldType<T> {
     optional: true;
@@ -49,8 +50,12 @@ export declare class ObjectSchema<F extends TlvFields> extends TlvSchema<TypeFro
 export declare const TlvObject: <F extends TlvFields>(fields: F) => ObjectSchema<F>;
 /** List TLV schema. */
 export declare const TlvList: <F extends TlvFields>(fields: F) => ObjectSchema<F>;
-/** Object TLV mandatory field. */
-export declare const TlvField: <T>(id: number, schema: TlvSchema<T>) => FieldType<T>;
+/**
+ * Object TLV mandatory field. Optionally provide a fallback value to initialize the field value when devices omit
+ * providing a value against the specifications or in special usecases. Make sure to use a value that is an equivalent
+ * to the value being empty.
+ */
+export declare const TlvField: <T>(id: number, schema: TlvSchema<T>, fallback?: T | undefined) => FieldType<T>;
 /** Object TLV optional field. */
 export declare const TlvOptionalField: <T>(id: number, schema: TlvSchema<T>) => OptionalFieldType<T>;
 export {};

package/dist/dts/tlv/TlvString.d.ts

@@ -22,7 +22,7 @@ export declare class StringSchema<T extends TlvType.ByteString | TlvType.Utf8Str
     constructor(type: T, minLength?: number, maxLength?: number);
     encodeTlvInternal(writer: TlvWriter, value: TlvToPrimitive[T], tag?: TlvTag): void;
     decodeTlvInternalValue(reader: TlvReader, typeLength: TlvTypeLength): TlvToPrimitive[T];
-    validate({ length }: TlvToPrimitive[T]): void;
+    validate(value: TlvToPrimitive[T]): void;
     bound({ minLength, maxLength, length }: LengthConstraints): StringSchema<T>;
 }
 /** ByteString TLV schema. */

package/dist/dts/tlv/TlvVoid.d.ts

@@ -12,6 +12,7 @@ export declare class VoidSchema extends TlvSchema<void> {
     encodeTlvInternal(_writer: TlvWriter, _value: void, _tag?: TlvTag): void;
     decodeTlv(_encoded: TlvStream): void;
     decodeTlvInternalValue(_reader: TlvReader, _typeLength: TlvTypeLength): void;
+    validate(data: void): void;
 }
 /** Void TLV schema. */
 export declare const TlvVoid: VoidSchema;

package/dist/es/cluster/DescriptorCluster.js

@@ -40,11 +40,11 @@ export const DescriptorCluster = Cluster({
         /** List containing each cluster ID for the server clusters present on the endpoint instance. */
         serverList: Attribute(1, TlvArray(TlvClusterId), { default: [] }),
         /** List containing each cluster ID for the client clusters present on the endpoint instance. */
-        clientList: Attribute(3, TlvArray(TlvClusterId), { default: [] }),
+        clientList: Attribute(2, TlvArray(TlvClusterId), { default: [] }),
         /**
          * This indicates composition of the device type instance. Device type instance composition SHALL
          * include the endpoints in this list.
          */
-        partsList: Attribute(4, TlvArray(TlvEndpointNumber), { default: [] }),
+        partsList: Attribute(3, TlvArray(TlvEndpointNumber), { default: [] }),
     },
 });

package/dist/es/cluster/OperationalCredentialsCluster.js

@@ -23,15 +23,15 @@ export const RESP_MAX = 900;
  * @see {@link MatterCoreSpecificationV1_0} § 11.17.5.3
  */
 const TlvFabricDescriptor = TlvObject({
-    /** Contains the public key for the trusted root that scopes the fabric referenced by FabricIndex and its associated operational credential. */
+    /** The public key for the trusted root that scopes the fabric referenced by FabricIndex and its associated operational credential. */
     rootPublicKey: TlvField(1, TlvByteString.bound({ length: 65 })),
-    /** Contains the value of AdminVendorID provided in the AddNOC command that led to the creation of this FabricDescriptorStruct. */
+    /** The value of AdminVendorID provided in the AddNOC command that led to the creation of this FabricDescriptorStruct. */
     vendorId: TlvField(2, TlvVendorId),
-    /** Contains the FabricID allocated to the fabric referenced by FabricIndex. */
-    fabricID: TlvField(3, TlvFabricId),
-    /** Contain the NodeID in use within the fabric referenced by FabricIndex. */
-    nodeID: TlvField(4, TlvNodeId),
-    /** Contains a commissioner-set label for the fabric referenced by FabricIndex. */
+    /** The FabricID allocated to the fabric referenced by FabricIndex. */
+    fabricId: TlvField(3, TlvFabricId),
+    /** The NodeID in use within the fabric referenced by FabricIndex. */
+    nodeId: TlvField(4, TlvNodeId),
+    /** A commissioner-set label for the fabric referenced by FabricIndex. */
     label: TlvField(5, TlvString.bound({ maxLength: 32 })), /* default: "" */
 });
 /**
@@ -40,86 +40,83 @@ const TlvFabricDescriptor = TlvObject({
  * @see {@link MatterCoreSpecificationV1_0} § 11.17.5.2
  */
 const TlvNoc = TlvObject({
-    /** Contains the NOC for the struct’s associated fabric. */
+    /** The NOC for the struct's associated fabric. */
     noc: TlvField(1, TlvByteString.bound({ maxLength: 400 })),
-    /** Contain the ICAC or the struct’s associated fabric. */
+    /** The ICAC or the struct's associated fabric. */
     icac: TlvField(2, TlvNullable(TlvByteString.bound({ maxLength: 400 }))), /* default(not present): null */
 });
 /** @see {@link MatterCoreSpecificationV1_0} § 11.17.7.1 */
 const TlvAttestationRequest = TlvObject({
-    /** Contains the attestation nonce to be used in the computation of the Attestation Information. */
+    /** The attestation nonce to be used in the computation of the Attestation Information. */
     attestationNonce: TlvField(0, TlvByteString.bound({ length: 32 })),
 });
 /** @see {@link MatterCoreSpecificationV1_0} § 11.17.7.2 */
 const TlvAttestationResponse = TlvObject({
-    /** Contains the octet string of the serialized attestation_elements_message. */
+    /** The octet string of the serialized attestation_elements_message. */
     elements: TlvField(0, TlvByteString.bound({ maxLength: RESP_MAX })),
-    /** Contain the octet string of the necessary attestation_signature. */
+    /** The octet string of the necessary attestation_signature. */
     signature: TlvField(1, TlvByteString.bound({ length: 64 })),
 });
 /** @see {@link MatterCoreSpecificationV1_0} § 11.17.7.5 */
 const TlvCertSigningRequestRequest = TlvObject({
-    /** Contains the CSRNonce to be used in the computation of the NOCSR information. */
+    /** The CSRNonce to be used in the computation of the NOCSR information. */
     certSigningRequestNonce: TlvField(0, TlvByteString.bound({ length: 32 })),
     /**
      * If set to true, the internal state of the CSR associated keypair SHALL be tagged as being for
      * a subsequent UpdateNOC, otherwise the internal state of the CSR SHALL be tagged as being for a
-     * subsequent AddNOC
+     * subsequent AddNOC.
      * */
     isForUpdateNOC: TlvOptionalField(1, TlvBoolean), /* default: false */
 });
 /** @see {@link MatterCoreSpecificationV1_0} § 11.17.7.6 */
 const TlvCertSigningRequestResponse = TlvObject({
-    /** Contains the octet string of the serialized nocsr_elements_message. */
+    /** The octet string of the serialized nocsr_elements_message. */
     elements: TlvField(0, TlvByteString.bound({ maxLength: RESP_MAX })),
-    /** Contain the octet string of the necessary attestation_signature. */
+    /** The octet string of the necessary attestation_signature. */
     signature: TlvField(1, TlvByteString.bound({ length: 64 })),
 });
 /** @see {@link MatterCoreSpecificationV1_0} § 11.17.7.3 */
 const TlvCertChainRequest = TlvObject({
-    /** Contains the type of certificate to be requested. */
+    /** The type of certificate to be requested. */
     type: TlvField(0, TlvEnum()),
 });
 /** @see {@link MatterCoreSpecificationV1_0} § 11.17.7.4 */
 const TlvCertChainResponse = TlvObject({
-    /** Contains the octet string of the requested certificate. */
+    /** The octet string of the requested certificate. */
     certificate: TlvField(0, TlvByteString.bound({ maxLength: 600 })),
 });
 /** @see {@link MatterCoreSpecificationV1_0} § 11.17.7.8 */
 const TlvAddNocRequest = TlvObject({
-    /** Contains the Node Operational Certificate (NOC) to be added. */
+    /** The Node Operational Certificate (NOC) to be added. */
     operationalCert: TlvField(0, TlvByteString.bound({ maxLength: 400 })),
-    /** Contains the Intermediate CA Certificate (ICAC). */
+    /** The Intermediate CA Certificate (ICAC). */
     intermediateCaCert: TlvOptionalField(1, TlvByteString.bound({ maxLength: 400 })),
-    /** Contains the value of the Epoch Key for the Identity Protection Key (IPK) to set for the Fabric which is to be added. */
+    /** The value of the Epoch Key for the Identity Protection Key (IPK). */
     identityProtectionKey: TlvField(2, TlvByteString.bound({ length: 16 })),
-    /**
-     * Used to atomically add an Access Control Entry enabling that Subject to subsequently administer
-     * the Node whose operational identity is being added by this command.
-     */
+    /** That Subject will have administration access on this node. */
     caseAdminNode: TlvField(3, TlvSubjectId),
-    /** Contains the Vendor ID of the entity issuing the AddNOC command. */
+    /** The Vendor ID of the entity issuing the AddNOC command. */
     adminVendorId: TlvField(4, TlvVendorId),
 });
 /** @see {@link MatterCoreSpecificationV1_0} § 11.17.7.9 */
 const TlvUpdateNocRequest = TlvObject({
-    /** Contains the Node Operational Certificate (NOC). */
+    /** The Node Operational Certificate (NOC). */
     operationalCert: TlvField(0, TlvByteString.bound({ maxLength: 400 })),
-    /** Contains the Intermediate CA Certificate (ICAC). */
+    /** The Intermediate CA Certificate (ICAC). */
     intermediateCaCert: TlvOptionalField(1, TlvByteString.bound({ maxLength: 400 })),
 });
 /** @see {@link MatterCoreSpecificationV1_0} § 11.17.7.13 */
 const TlvAddTrustedRootCertificateRequest = TlvObject({
-    /** Contains the Trusted Root Certificate (TRC) to be added. */
+    /** The Trusted Root Certificate (TRC) to be added. */
     certificate: TlvField(0, TlvByteString.bound({ maxLength: 400 })),
 });
 /** @see {@link MatterCoreSpecificationV1_0} § 11.17.7.10 */
 const TlvOperationalCertificateStatusResponse = TlvObject({
-    /** Contains a NOCStatus value representing the status of an operation involving a NOC. */
+    /** A NOCStatus value representing the status of an operation involving a NOC. */
     status: TlvField(0, TlvEnum()),
     /** When action was successful, contains the Fabric Index of the Fabric last added, removed or updated. */
     fabricIndex: TlvOptionalField(1, TlvFabricIndex),
-    /** Optionally contains debugging textual information from the cluster implementation and should be visible in logs, not User UI */
+    /** Optional debugging textual information from the cluster implementation and should be visible in logs, not User UI */
     debugText: TlvOptionalField(2, TlvString.bound({ maxLength: 128 })),
 });
 /** @see {@link MatterCoreSpecificationV1_0} § 11.17.5.4 */
@@ -139,12 +136,12 @@ export const TlvCertSigningRequest = TlvObject({
 });
 /** @see {@link MatterCoreSpecificationV1_0} § 11.17.7.11 */
 const TlvUpdateFabricLabelRequest = TlvObject({
-    /** Contains the label to set for the fabric associated with the current secure session. */
+    /** The label to set for the fabric associated with the current secure session. */
     label: TlvField(0, TlvString32max),
 });
 /** @see {@link MatterCoreSpecificationV1_0} § 11.17.7.12 */
 const TlvRemoveFabricRequest = TlvObject({
-    /** Contains the Fabric Index reference associated with the Fabric which is to be removed from the device. */
+    /** The Fabric Index reference associated with the Fabric which is to be removed from the device. */
     fabricIndex: TlvField(0, TlvFabricIndex),
 });
 /**
@@ -159,44 +156,36 @@ export const OperationalCredentialsCluster = Cluster({
     revision: 1,
     /** @see {@link MatterCoreSpecificationV1_0} § 11.17.6 */
     attributes: {
-        /** Contains all NOCs applicable to this Node. */
+        /** All NOCs applicable to this Node. */
         nocs: Attribute(0, TlvArray(TlvNoc), { readAcl: 2 /* AccessLevel.Administer */ }),
-        /** Describes all fabrics to which this Node is commissioned. */
+        /** Lists all fabrics to which this Node is commissioned. */
         fabrics: Attribute(1, TlvArray(TlvFabricDescriptor)),
-        /** Contains the number of Fabrics that are supported by the device. */
+        /** The number of Fabrics that are supported by the device. */
         supportedFabrics: Attribute(2, TlvUInt8.bound({ min: 5, max: 254 })),
-        /** Contains the number of Fabrics to which the device is currently commissioned. */
+        /** The number of Fabrics to which the device is currently commissioned. */
         commissionedFabrics: Attribute(3, TlvUInt8),
-        /** Contains a read-only list of Trusted Root CA Certificates installed on the Node. */
+        /** A read-only list of Trusted Root CA Certificates installed on the Node. */
         trustedRootCertificates: Attribute(4, TlvArray(TlvByteString, { maxLength: 400 })),
-        /** Contain accessing fabric index. */
+        /** Accessing fabric index. */
         currentFabricIndex: Attribute(5, TlvUInt8),
     },
     /** @see {@link MatterCoreSpecificationV1_0} § 11.17.7 */
     commands: {
-        /** Sender is requesting attestation information from the receiver. */
+        /** Requests attestation information. */
         requestAttestation: Command(0, TlvAttestationRequest, 1, TlvAttestationResponse),
-        /** Sender is requesting a device attestation certificate from the receiver. */
+        /** Requests a device attestation certificate. */
         requestCertChain: Command(2, TlvCertChainRequest, 3, TlvCertChainResponse),
-        /** Sender is requesting a certificate signing request (CSR) from the receiver. */
+        /** Requests a certificate signing request (CSR). */
         requestCertSigning: Command(4, TlvCertSigningRequestRequest, 5, TlvCertSigningRequestResponse),
-        /** Sender is requesting to add the new node operational certificates. */
+        /** Adds new node operational certificates. */
         addOperationalCert: Command(6, TlvAddNocRequest, 8, TlvOperationalCertificateStatusResponse),
-        /** Sender is requesting to update the node operational certificates. */
+        /** Updates the node operational certificates. */
         updateOperationalCert: Command(7, TlvUpdateNocRequest, 8, TlvOperationalCertificateStatusResponse),
-        /**
-         * This command SHALL be used by an Administrative Node to set the user-visible Label field for a given
-         * Fabric, as reflected by entries in the Fabrics attribute.
-         */
+        /** Sets the user-visible Label field for a given Fabric. */
         updateFabricLabel: Command(9, TlvUpdateFabricLabelRequest, 8, TlvOperationalCertificateStatusResponse),
-        /**
-         * This command is used by Administrative Nodes to remove a given fabric index and delete all associated
-         * fabric-scoped data.
-         */
+        /** Removes a given fabric index and delete all associated fabric-scoped data. */
         removeFabric: Command(10, TlvRemoveFabricRequest, 8, TlvOperationalCertificateStatusResponse),
-        /**
-         * This command SHALL add a Trusted Root CA Certificate, provided as its CHIP Certificate representation.
-         */
+        /** Adds a Trusted Root CA Certificate, provided as its CHIP Certificate representation. */
         addRootCert: Command(11, TlvAddTrustedRootCertificateRequest, 11, TlvNoResponse),
     },
 });

package/dist/es/schema/Schema.js

@@ -11,9 +11,11 @@ export class Schema {
         return this.encodeInternal(value);
     }
     /** Decodes the encoded data using the schema. */
-    decode(encoded) {
+    decode(encoded, validate = true) {
         const result = this.decodeInternal(encoded);
-        this.validate(result);
+        if (validate) {
+            this.validate(result);
+        }
         return result;
     }
     /** Optional validator that can be used to enforce constraints on the data before encoding / after decoding. */

package/dist/es/tlv/TlvAny.js

@@ -63,5 +63,15 @@ export class AnySchema extends TlvSchema {
         }
         return tlvStream;
     }
+    validate(tlvStream) {
+        if (!Array.isArray(tlvStream))
+            throw new Error(`Expected TlvStream, got ${typeof tlvStream}.`);
+        tlvStream.forEach(({ typeLength }) => {
+            if (!typeLength || typeof typeLength !== "object")
+                throw new Error(`Expected typeLength properties in TlvStream, got ${typeof typeLength}.`);
+            if (typeof typeLength.type !== "number")
+                throw new Error(`Expected typeLength.type as number in TlvStream, got ${typeof typeLength.type}.`);
+        });
+    }
 }
 export const TlvAny = new AnySchema();

package/dist/es/tlv/TlvArray.js

@@ -33,14 +33,16 @@ export class ArraySchema extends TlvSchema {
                 break;
             result.push(this.elementSchema.decodeTlvInternalValue(reader, elementTypeLength));
         }
-        this.validate(result);
         return result;
     }
-    validate({ length }) {
-        if (length > this.maxLength)
-            throw new Error(`Array is too long: ${length}, max ${this.maxLength}.`);
-        if (length < this.minLength)
-            throw new Error(`Array is too short: ${length}, min ${this.minLength}.`);
+    validate(data) {
+        if (!Array.isArray(data))
+            throw new Error(`Expected array, got ${typeof data}.`);
+        if (data.length > this.maxLength)
+            throw new Error(`Array is too long: ${data.length}, max ${this.maxLength}.`);
+        if (data.length < this.minLength)
+            throw new Error(`Array is too short: ${data.length}, min ${this.minLength}.`);
+        data.forEach(element => this.elementSchema.validate(element));
     }
 }
 /** Array TLV schema. */

package/dist/es/tlv/TlvBoolean.js

@@ -18,6 +18,10 @@ export class BooleanSchema extends TlvSchema {
             throw new Error(`Unexpected type ${typeLength.type}.`);
         return typeLength.value;
     }
+    validate(value) {
+        if (typeof value !== "boolean")
+            throw new Error(`Expected boolean, got ${typeof value}.`);
+    }
 }
 /** Boolean TLV schema. */
 export const TlvBoolean = new BooleanSchema();

package/dist/es/tlv/TlvNullable.js

@@ -27,6 +27,10 @@ export class NullableSchema extends TlvSchema {
             return null;
         return this.schema.decodeTlvInternalValue(reader, typeLength);
     }
+    validate(value) {
+        if (value !== null)
+            this.schema.validate(value);
+    }
 }
 /** Nullable TLV schema. */
 export const TlvNullable = (schema) => new NullableSchema(schema);

package/dist/es/tlv/TlvNumber.js

@@ -30,11 +30,14 @@ export class TlvNumericSchema extends TlvSchema {
         if (typeLength.type !== this.type)
             throw new Error(`Unexpected type ${typeLength.type}, was expecting ${this.type}.`);
         const value = reader.readPrimitive(typeLength);
-        this.validate(value);
         return value;
     }
     validate(value) {
-        super.validate(value);
+        if (typeof value !== "number" && typeof value !== 'bigint')
+            throw new Error(`Expected number, got ${typeof value}.`);
+        this.validateBoundaries(value);
+    }
+    validateBoundaries(value) {
         if (this.min !== undefined && value < this.min)
             throw new Error(`Invalid value: ${value} is below the minimum, ${this.min}.`);
         if (this.max !== undefined && value > this.max)
@@ -56,6 +59,11 @@ export class TlvNumberSchema extends TlvNumericSchema {
     bound({ min, max }) {
         return new TlvNumberSchema(this.type, this.lengthProvider, maxValue(min, this.min), minValue(max, this.max));
     }
+    validate(value) {
+        if (typeof value !== "number")
+            throw new Error(`Expected number, got ${typeof value}.`);
+        this.validateBoundaries(value);
+    }
 }
 export const TlvLongNumberSchema = (TlvNumericSchema);
 /** Unsigned integer TLV schema. */

package/dist/es/tlv/TlvObject.js

@@ -57,13 +57,28 @@ export class ObjectSchema extends TlvSchema {
             const { field, name } = fieldName;
             result[name] = field.schema.decodeTlvInternalValue(reader, elementTypeLength);
         }
-        this.validate(result);
+        // Check mandatory fields and, if missing, populate with fallback value if defined.
+        for (const name in this.fieldDefinitions) {
+            const { optional, fallback } = this.fieldDefinitions[name];
+            if (optional)
+                continue;
+            const value = result[name];
+            if (value !== undefined)
+                continue;
+            if (fallback === undefined)
+                throw new Error(`Missing mandatory field ${name}`);
+            result[name] = fallback;
+        }
         return result;
     }
     validate(value) {
         for (const name in this.fieldDefinitions) {
-            if (!this.fieldDefinitions[name].optional && value[name] === undefined)
+            const { optional, schema } = this.fieldDefinitions[name];
+            if (optional && value[name] === undefined)
+                continue;
+            if (!optional && value[name] === undefined)
                 throw new Error(`Missing mandatory field ${name}`);
+            schema.validate(value[name]);
         }
     }
 }
@@ -71,7 +86,11 @@ export class ObjectSchema extends TlvSchema {
 export const TlvObject = (fields) => new ObjectSchema(fields, 21 /* TlvType.Structure */);
 /** List TLV schema. */
 export const TlvList = (fields) => new ObjectSchema(fields, 23 /* TlvType.List */);
-/** Object TLV mandatory field. */
-export const TlvField = (id, schema) => ({ id, schema, optional: false });
+/**
+ * Object TLV mandatory field. Optionally provide a fallback value to initialize the field value when devices omit
+ * providing a value against the specifications or in special usecases. Make sure to use a value that is an equivalent
+ * to the value being empty.
+ */
+export const TlvField = (id, schema, fallback) => ({ id, schema, fallback, optional: false });
 /** Object TLV optional field. */
 export const TlvOptionalField = (id, schema) => ({ id, schema, optional: true });

package/dist/es/tlv/TlvString.js

@@ -6,6 +6,7 @@
 import { TlvCodec } from "./TlvCodec.js";
 import { TlvSchema } from "./TlvSchema.js";
 import { maxValue, minValue } from "../util/Number.js";
+import { ByteArray } from "../util/ByteArray";
 /**
  * Schema to encode an byte string or an Utf8 string in TLV.
  *
@@ -30,11 +31,15 @@ export class StringSchema extends TlvSchema {
             throw new Error(`Unexpected type ${typeLength.type}.`);
         return reader.readPrimitive(typeLength);
     }
-    validate({ length }) {
-        if (length > this.maxLength)
-            throw new Error(`Array is too long: ${length}, max ${this.maxLength}.`);
-        if (length < this.minLength)
-            throw new Error(`Array is too short: ${length}, min ${this.minLength}.`);
+    validate(value) {
+        if (this.type === 12 /* TlvType.Utf8String */ && typeof value !== "string")
+            throw new Error(`Expected string, got ${typeof value}.`);
+        if (this.type === 16 /* TlvType.ByteString */ && !(value instanceof ByteArray))
+            throw new Error(`Expected ByteArray, got ${typeof value}.`);
+        if (value.length > this.maxLength)
+            throw new Error(`String is too long: ${value.length}, max ${this.maxLength}.`);
+        if (value.length < this.minLength)
+            throw new Error(`String is too short: ${value.length}, min ${this.minLength}.`);
     }
     bound({ minLength, maxLength, length }) {
         return new StringSchema(this.type, length !== null && length !== void 0 ? length : maxValue(this.minLength, minLength), length !== null && length !== void 0 ? length : minValue(this.maxLength, maxLength));

package/dist/es/tlv/TlvVoid.js

@@ -17,6 +17,10 @@ export class VoidSchema extends TlvSchema {
     decodeTlvInternalValue(_reader, _typeLength) {
         throw new Error("decodeTlvInternalValue should never be called");
     }
+    validate(data) {
+        if (data !== undefined)
+            throw new Error(`Expected void, got ${typeof data}.`);
+    }
 }
 /** Void TLV schema. */
 export const TlvVoid = new VoidSchema();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@project-chip/matter.js",
-  "version": "0.2.0",
+  "version": "0.2.1",
   "description": "Matter protocol in pure js",
   "keywords": [
     "iot",
@@ -26,7 +26,7 @@
     "clean": "rm -rf dist; rm -rf out",
     "build": "npm run clean; tsc --project tsconfig.dist-es.json; tsc --project tsconfig.dist-cjs.json; tsc --project tsconfig.dist-dts.json",
     "test": "node --experimental-vm-modules node_modules/jest/bin/jest.js",
-    "test-web": "karma start karma.conf.cjs"
+    "test-web": "karma start test/karma.conf.cjs"
   },
   "devDependencies": {
     "@types/jasmine": "^4.3.0",