@matter/types 0.11.0-alpha.0-20241005-e3e4e4a7a

package/dist/esm/tlv/TlvObject.js

@@ -0,0 +1,260 @@
+/**
+ * @license
+ * Copyright 2022-2024 Matter.js Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { ImplementationError, InternalError, UnexpectedDataError } from "#general";
+import { FabricIndex } from "#model";
+import {
+  ValidationDatatypeMismatchError,
+  ValidationError,
+  ValidationMandatoryFieldMissingError,
+  ValidationOutOfBoundsError
+} from "../common/ValidationError.js";
+import { TlvAny } from "./TlvAny.js";
+import { TlvType } from "./TlvCodec.js";
+import { TlvSchema } from "./TlvSchema.js";
+class ObjectSchema extends TlvSchema {
+  constructor(fieldDefinitions, type = TlvType.Structure, allowProtocolSpecificTags = false) {
+    super();
+    this.fieldDefinitions = fieldDefinitions;
+    this.type = type;
+    this.allowProtocolSpecificTags = allowProtocolSpecificTags;
+    for (const name in this.fieldDefinitions) {
+      const field = this.fieldDefinitions[name];
+      if (field.repeated && type !== TlvType.List) {
+        throw new Error("Repeated fields are only allowed in TLV List.");
+      }
+      this.fieldById[field.id] = { name, field };
+    }
+  }
+  fieldById = new Array();
+  #encodeEntryToTlv(writer, name, value, options) {
+    const { id, schema, optional: isOptional, repeated: isRepeated } = this.fieldDefinitions[name];
+    const { forWriteInteraction = false, allowMissingFieldsForNonFabricFilteredRead = false } = options ?? {};
+    if (forWriteInteraction && allowMissingFieldsForNonFabricFilteredRead) {
+      throw new InternalError(
+        "Encode options cannot indicate a write interaction and a fabric filtered read interaction at the same time."
+      );
+    }
+    const fieldValue = value[name];
+    if (fieldValue === void 0) {
+      if (!isOptional && !allowMissingFieldsForNonFabricFilteredRead) {
+        if (forWriteInteraction && id === FabricIndex.id) {
+          return;
+        }
+        throw new ValidationMandatoryFieldMissingError(`Missing mandatory field ${name}`, name);
+      }
+      return;
+    }
+    if (isRepeated) {
+      if (!Array.isArray(fieldValue)) {
+        throw new ValidationDatatypeMismatchError(`Repeated field ${name} should be an array.`, name);
+      }
+      for (const element of fieldValue) {
+        schema.encodeTlvInternal(writer, element, { id }, options);
+      }
+    } else {
+      schema.encodeTlvInternal(writer, fieldValue, { id }, options);
+    }
+  }
+  /**
+   * Encode the object as Structure, by the order of field definitions.
+   */
+  #encodeStructure(writer, value, options) {
+    for (const name in this.fieldDefinitions) {
+      this.#encodeEntryToTlv(writer, name, value, options);
+    }
+  }
+  /**
+   * Encode the object as List, by the order of the fields in the object.
+   */
+  #encodeList(writer, value, options) {
+    const encodedFields = /* @__PURE__ */ new Set();
+    for (const name of Object.keys(value)) {
+      this.#encodeEntryToTlv(writer, name, value, options);
+      encodedFields.add(name);
+    }
+    for (const name in this.fieldDefinitions) {
+      if (encodedFields.has(name)) continue;
+      this.#encodeEntryToTlv(writer, name, value, options);
+    }
+  }
+  encodeTlvInternal(writer, value, tag, options) {
+    writer.writeTag({ type: this.type }, tag);
+    if (this.type === TlvType.Structure) {
+      this.#encodeStructure(writer, value, options);
+    } else {
+      this.#encodeList(writer, value, options);
+    }
+    writer.writeTag({ type: TlvType.EndOfContainer });
+  }
+  decodeTlvInternalValue(reader, typeLength) {
+    if (typeLength.type !== this.type)
+      throw new UnexpectedDataError(`Unexpected type ${typeLength.type} (expected ${this.type}).`);
+    const result = {};
+    while (true) {
+      const { tag: { profile, id } = {}, typeLength: elementTypeLength } = reader.readTagType();
+      if (elementTypeLength.type === TlvType.EndOfContainer) break;
+      if (profile !== void 0 && !this.allowProtocolSpecificTags)
+        throw new UnexpectedDataError("Structure element tags should be context-specific.");
+      if (id === void 0) throw new UnexpectedDataError("Structure element tags should have an id.");
+      const fieldName = this.fieldById[id];
+      if (fieldName === void 0) {
+        TlvAny.decodeTlvInternalValue(reader, elementTypeLength);
+        continue;
+      }
+      const { field, name } = fieldName;
+      const decoded = field.schema.decodeTlvInternalValue(reader, elementTypeLength);
+      if (field.repeated) {
+        if (result[name] === void 0) {
+          result[name] = [decoded];
+        } else {
+          result[name].push(decoded);
+        }
+      } else {
+        result[name] = decoded;
+      }
+    }
+    for (const name in this.fieldDefinitions) {
+      const { optional, fallback, repeated } = this.fieldDefinitions[name];
+      if (optional) continue;
+      const value = result[name];
+      if (value !== void 0) continue;
+      if (fallback !== void 0) {
+        if (repeated) {
+          result[name] = [fallback];
+        } else {
+          result[name] = fallback;
+        }
+      }
+    }
+    return result;
+  }
+  validate(value) {
+    for (const name in this.fieldDefinitions) {
+      const { optional, schema, repeated: isRepeated } = this.fieldDefinitions[name];
+      const data = value[name];
+      if (data === void 0) {
+        if (optional) {
+          continue;
+        }
+        throw new ValidationMandatoryFieldMissingError(`Missing mandatory field ${name}`, name);
+      }
+      if (isRepeated) {
+        const { minLength = 2, maxLength = 65535 } = this.fieldDefinitions[name];
+        if (!Array.isArray(data)) {
+          throw new ValidationDatatypeMismatchError(`Repeated field ${name} should be an array.`, name);
+        }
+        if (data.length > maxLength)
+          throw new ValidationOutOfBoundsError(
+            `Repeated field list for ${name} is too long: ${data.length}, max ${maxLength}.`,
+            name
+          );
+        if (data.length < minLength)
+          throw new ValidationOutOfBoundsError(
+            `Repeated field list for ${name} is too short: ${data.length}, min ${minLength}.`,
+            name
+          );
+        for (const element of data) {
+          try {
+            schema.validate(element);
+          } catch (e) {
+            ValidationError.accept(e);
+            e.fieldName = `${name}${e.fieldName !== void 0 ? `.${e.fieldName}` : ""}`;
+            throw e;
+          }
+        }
+      } else {
+        try {
+          schema.validate(data);
+        } catch (e) {
+          ValidationError.accept(e);
+          e.fieldName = `${name}${e.fieldName !== void 0 ? `.${e.fieldName}` : ""}`;
+          throw e;
+        }
+      }
+    }
+  }
+  injectField(value, fieldId, fieldValue, injectChecker) {
+    for (const k in this.fieldDefinitions) {
+      const field = this.fieldDefinitions[k];
+      if (field.id === fieldId) {
+        if (injectChecker(value[k])) {
+          field.schema.validate(fieldValue);
+          value[k] = fieldValue;
+        }
+      } else {
+        value[k] = field.schema.injectField(value[k], fieldId, fieldValue, injectChecker);
+      }
+    }
+    return value;
+  }
+  removeField(value, fieldId, removeChecker) {
+    for (const k in this.fieldDefinitions) {
+      const field = this.fieldDefinitions[k];
+      if (field.id === fieldId) {
+        if (value[k] !== void 0 && removeChecker(value[k])) {
+          delete value[k];
+        }
+      } else {
+        value[k] = field.schema.removeField(value[k], fieldId, removeChecker);
+      }
+    }
+    return value;
+  }
+}
+const TlvObject = (fields) => new ObjectSchema(fields, TlvType.Structure);
+class ObjectSchemaWithMaxSize extends ObjectSchema {
+  constructor(fieldDefinitions, maxSize, type = TlvType.Structure, allowProtocolSpecificTags = false) {
+    super(fieldDefinitions, type, allowProtocolSpecificTags);
+    this.maxSize = maxSize;
+  }
+  encode(value) {
+    const encoded = super.encode(value);
+    if (encoded.length > this.maxSize) {
+      throw new ImplementationError(
+        `Encoded TLV object with ${encoded.length} bytes exceeds maximum size of ${this.maxSize} bytes.`
+      );
+    }
+    return encoded;
+  }
+}
+const TlvObjectWithMaxSize = (fields, maxSize) => new ObjectSchemaWithMaxSize(fields, maxSize, TlvType.Structure);
+const TlvTaggedList = (fields, allowProtocolSpecificTags = false) => new ObjectSchema(fields, TlvType.List, allowProtocolSpecificTags);
+const TlvField = (id, schema, fallback) => ({ id, schema, fallback, optional: false });
+const TlvOptionalField = (id, schema) => ({ id, schema, optional: true });
+const TlvRepeatedField = (id, schema, lengthOptions) => {
+  const { minLength, maxLength, length } = lengthOptions ?? {};
+  return {
+    id,
+    schema,
+    optional: false,
+    repeated: true,
+    minLength: length ?? minLength,
+    maxLength: length ?? maxLength
+  };
+};
+const TlvOptionalRepeatedField = (id, schema, lengthOptions) => {
+  const { maxLength } = lengthOptions ?? {};
+  return {
+    id,
+    schema,
+    optional: true,
+    repeated: true,
+    minLength: 0,
+    maxLength
+  };
+};
+export {
+  ObjectSchema,
+  ObjectSchemaWithMaxSize,
+  TlvField,
+  TlvObject,
+  TlvObjectWithMaxSize,
+  TlvOptionalField,
+  TlvOptionalRepeatedField,
+  TlvRepeatedField,
+  TlvTaggedList
+};
+//# sourceMappingURL=TlvObject.js.map

package/dist/esm/tlv/TlvObject.js.map

@@ -0,0 +1,6 @@
+{
+  "version": 3,
+  "sources": ["../../../src/tlv/TlvObject.ts"],
+  "mappings": "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",
+  "names": []
+}

package/dist/esm/tlv/TlvSchema.d.ts

@@ -0,0 +1,81 @@
+/**
+ * @license
+ * Copyright 2022-2024 Matter.js Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { Schema } from "../schema/Schema.js";
+import { TlvTag, TlvToPrimitive, TlvTypeLength } from "./TlvCodec.js";
+export type TlvEncodingOptions = {
+    /**
+     * When true, the fabricIndex field will be excluded from the TLV encoding for list entries.
+     * This flag must not be set together with the following flag.
+     */
+    forWriteInteraction?: boolean;
+    /**
+     * When true, mandatory field validation is skipped when encoding TLV for list entries.
+     * This flag must not be set together with the former flag.
+     */
+    allowMissingFieldsForNonFabricFilteredRead?: boolean;
+};
+export declare abstract class TlvSchema<T> extends Schema<T, Uint8Array> implements TlvSchema<T> {
+    decodeInternal(encoded: Uint8Array): T;
+    encodeInternal(value: T): Uint8Array;
+    encodeTlv(value: T, options?: TlvEncodingOptions): TlvStream;
+    decodeTlv(encoded: TlvStream): T;
+    decodeTlvInternal(reader: TlvReader): {
+        value: T;
+        tag?: TlvTag;
+    };
+    abstract decodeTlvInternalValue(reader: TlvReader, typeLength: TlvTypeLength): T;
+    abstract encodeTlvInternal(writer: TlvWriter, value: T, tag?: TlvTag, options?: TlvEncodingOptions): void;
+    injectField(value: T, _fieldId: number, _fieldValue: any, _injectChecker: (fieldValue: any) => boolean): T;
+    removeField(value: T, _fieldId: number, _removeChecker: (fieldValue: any) => boolean): T;
+}
+export type TlvStream = TlvElement<any>[];
+export type TlvElement<T extends TlvTypeLength> = {
+    tag?: TlvTag;
+    typeLength: T;
+    value?: TlvToPrimitive[T["type"]];
+};
+export declare class TlvArrayWriter implements TlvWriter {
+    private readonly tlvArray;
+    writeTag(typeLength: TlvTypeLength, tag?: TlvTag): void;
+    writePrimitive<T extends TlvTypeLength>(_typeLength: T, value: TlvToPrimitive[T["type"]]): void;
+    toTlvArray(): TlvElement<any>[];
+}
+export declare class TlvArrayReader implements TlvReader {
+    private readonly tlvElements;
+    private index;
+    constructor(tlvElements: TlvElement<any>[]);
+    readTagType(): TlvElement<any>;
+    readPrimitive<T extends TlvTypeLength, V = TlvToPrimitive[T["type"]]>(_typeLength: T): V;
+}
+/** Type defined by the TLV schema. */
+export type TypeFromSchema<S extends TlvSchema<any>> = S extends TlvSchema<infer T> ? T : never;
+export interface TlvReader {
+    readTagType(): {
+        tag?: TlvTag;
+        typeLength: TlvTypeLength;
+    };
+    readPrimitive<T extends TlvTypeLength, V = TlvToPrimitive[T["type"]]>(typeLength: T): V;
+}
+export interface TlvWriter {
+    writeTag(typeLength: TlvTypeLength, tag?: TlvTag): void;
+    writePrimitive<T extends TlvTypeLength>(typeLength: T, value: TlvToPrimitive[T["type"]]): void;
+}
+export declare class TlvByteArrayWriter implements TlvWriter {
+    private readonly writer;
+    writeTag(typeLength: TlvTypeLength, tag?: TlvTag): void;
+    writePrimitive<T extends TlvTypeLength>(typeLength: T, value: TlvToPrimitive[T["type"]]): void;
+    toByteArray(): Uint8Array;
+}
+export declare class TlvByteArrayReader implements TlvReader {
+    private readonly reader;
+    constructor(byteArray: Uint8Array);
+    readTagType(): {
+        tag?: TlvTag;
+        typeLength: TlvTypeLength;
+    };
+    readPrimitive<T extends TlvTypeLength, V = TlvToPrimitive[T["type"]]>(typeLength: T): V;
+}
+//# sourceMappingURL=TlvSchema.d.ts.map

package/dist/esm/tlv/TlvSchema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"TlvSchema.d.ts","sourceRoot":"","sources":["../../../src/tlv/TlvSchema.ts"],"names":[],"mappings":"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"}

package/dist/esm/tlv/TlvSchema.js

@@ -0,0 +1,93 @@
+/**
+ * @license
+ * Copyright 2022-2024 Matter.js Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { DataReader, DataWriter, Endian } from "#general";
+import { Schema } from "../schema/Schema.js";
+import { TlvCodec } from "./TlvCodec.js";
+class TlvSchema extends Schema {
+  decodeInternal(encoded) {
+    return this.decodeTlvInternal(new TlvByteArrayReader(encoded)).value;
+  }
+  encodeInternal(value) {
+    const writer = new TlvByteArrayWriter();
+    this.encodeTlvInternal(writer, value);
+    return writer.toByteArray();
+  }
+  encodeTlv(value, options) {
+    const writer = new TlvArrayWriter();
+    this.encodeTlvInternal(writer, value, void 0, options);
+    return writer.toTlvArray();
+  }
+  decodeTlv(encoded) {
+    return this.decodeTlvInternal(new TlvArrayReader(encoded)).value;
+  }
+  decodeTlvInternal(reader) {
+    const { tag, typeLength } = reader.readTagType();
+    return { tag, value: this.decodeTlvInternalValue(reader, typeLength) };
+  }
+  injectField(value, _fieldId, _fieldValue, _injectChecker) {
+    return value;
+  }
+  removeField(value, _fieldId, _removeChecker) {
+    return value;
+  }
+}
+class TlvArrayWriter {
+  tlvArray = new Array();
+  writeTag(typeLength, tag) {
+    this.tlvArray.push({ tag, typeLength });
+  }
+  writePrimitive(_typeLength, value) {
+    this.tlvArray[this.tlvArray.length - 1].value = value;
+  }
+  toTlvArray() {
+    return this.tlvArray;
+  }
+}
+class TlvArrayReader {
+  constructor(tlvElements) {
+    this.tlvElements = tlvElements;
+  }
+  index = -1;
+  readTagType() {
+    this.index++;
+    return this.tlvElements[this.index];
+  }
+  readPrimitive(_typeLength) {
+    return this.tlvElements[this.index].value;
+  }
+}
+class TlvByteArrayWriter {
+  writer = new DataWriter(Endian.Little);
+  writeTag(typeLength, tag) {
+    TlvCodec.writeTag(this.writer, typeLength, tag);
+  }
+  writePrimitive(typeLength, value) {
+    TlvCodec.writePrimitive(this.writer, typeLength, value);
+  }
+  toByteArray() {
+    return this.writer.toByteArray();
+  }
+}
+class TlvByteArrayReader {
+  reader;
+  constructor(byteArray) {
+    this.reader = new DataReader(byteArray, Endian.Little);
+  }
+  readTagType() {
+    return TlvCodec.readTagType(this.reader);
+  }
+  readPrimitive(typeLength) {
+    return TlvCodec.readPrimitive(this.reader, typeLength);
+  }
+}
+export {
+  TlvArrayReader,
+  TlvArrayWriter,
+  TlvByteArrayReader,
+  TlvByteArrayWriter,
+  TlvSchema
+};
+//# sourceMappingURL=TlvSchema.js.map

package/dist/esm/tlv/TlvSchema.js.map

@@ -0,0 +1,6 @@
+{
+  "version": 3,
+  "sources": ["../../../src/tlv/TlvSchema.ts"],
+  "mappings": "AAAA;AAAA;AAAA;AAAA;AAAA;AAMA,SAAS,YAAY,YAAY,cAAc;AAC/C,SAAS,cAAc;AACvB,SAAS,gBAAuD;AAgBzD,MAAe,kBAAqB,OAA8C;AAAA,EAC5E,eAAe,SAAwB;AAC5C,WAAO,KAAK,kBAAkB,IAAI,mBAAmB,OAAO,CAAC,EAAE;AAAA,EACnE;AAAA,EAES,eAAe,OAAsB;AAC1C,UAAM,SAAS,IAAI,mBAAmB;AACtC,SAAK,kBAAkB,QAAQ,KAAK;AACpC,WAAO,OAAO,YAAY;AAAA,EAC9B;AAAA,EAEA,UAAU,OAAU,SAAyC;AACzD,UAAM,SAAS,IAAI,eAAe;AAClC,SAAK,kBAAkB,QAAQ,OAAO,QAAW,OAAO;AACxD,WAAO,OAAO,WAAW;AAAA,EAC7B;AAAA,EAEA,UAAU,SAAuB;AAC7B,WAAO,KAAK,kBAAkB,IAAI,eAAe,OAAO,CAAC,EAAE;AAAA,EAC/D;AAAA,EAEA,kBAAkB,QAA+C;AAC7D,UAAM,EAAE,KAAK,WAAW,IAAI,OAAO,YAAY;AAC/C,WAAO,EAAE,KAAK,OAAO,KAAK,uBAAuB,QAAQ,UAAU,EAAE;AAAA,EACzE;AAAA,EAMA,YAAY,OAAU,UAAkB,aAAkB,gBAAiD;AACvG,WAAO;AAAA,EACX;AAAA,EAEA,YAAY,OAAU,UAAkB,gBAAiD;AACrF,WAAO;AAAA,EACX;AACJ;AAUO,MAAM,eAAoC;AAAA,EAC5B,WAAW,IAAI,MAAuB;AAAA,EAEvD,SAAS,YAA2B,KAAc;AAC9C,SAAK,SAAS,KAAK,EAAE,KAAK,WAAW,CAAC;AAAA,EAC1C;AAAA,EAEA,eAAwC,aAAgB,OAAkC;AACtF,SAAK,SAAS,KAAK,SAAS,SAAS,CAAC,EAAE,QAAQ;AAAA,EACpD;AAAA,EAEA,aAAa;AACT,WAAO,KAAK;AAAA,EAChB;AACJ;AAEO,MAAM,eAAoC;AAAA,EAG7C,YAA6B,aAAgC;AAAhC;AAAA,EAAiC;AAAA,EAFtD,QAAQ;AAAA,EAIhB,cAAc;AACV,SAAK;AACL,WAAO,KAAK,YAAY,KAAK,KAAK;AAAA,EACtC;AAAA,EAEA,cAAsE,aAAmB;AACrF,WAAO,KAAK,YAAY,KAAK,KAAK,EAAE;AAAA,EACxC;AACJ;AAiBO,MAAM,mBAAwC;AAAA,EAChC,SAAS,IAAI,WAAW,OAAO,MAAM;AAAA,EAEtD,SAAS,YAA2B,KAAc;AAC9C,aAAS,SAAS,KAAK,QAAQ,YAAY,GAAG;AAAA,EAClD;AAAA,EAEA,eAAwC,YAAe,OAAkC;AACrF,aAAS,eAAe,KAAK,QAAQ,YAAY,KAAK;AAAA,EAC1D;AAAA,EAEA,cAAc;AACV,WAAO,KAAK,OAAO,YAAY;AAAA,EACnC;AACJ;AAEO,MAAM,mBAAwC;AAAA,EAChC;AAAA,EAEjB,YAAY,WAAuB;AAC/B,SAAK,SAAS,IAAI,WAAW,WAAW,OAAO,MAAM;AAAA,EACzD;AAAA,EAEA,cAAc;AACV,WAAO,SAAS,YAAY,KAAK,MAAM;AAAA,EAC3C;AAAA,EAEA,cAAsE,YAAkB;AACpF,WAAO,SAAS,cAAc,KAAK,QAAQ,UAAU;AAAA,EACzD;AACJ;",
+  "names": []
+}

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

@@ -0,0 +1,40 @@
+/**
+ * @license
+ * Copyright 2022-2024 Matter.js Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { TlvTag, TlvToPrimitive, TlvType, TlvTypeLength } from "./TlvCodec.js";
+import { TlvReader, TlvSchema, TlvWriter } from "./TlvSchema.js";
+type LengthConstraints = {
+    minLength?: number;
+    maxLength?: number;
+    length?: number;
+};
+/**
+ * Schema to encode an byte string or an Utf8 string in TLV.
+ *
+ * @see {@link MatterSpecification.v10.Core} § A.11.2
+ */
+export declare class StringSchema<T extends TlvType.ByteString | TlvType.Utf8String> extends TlvSchema<TlvToPrimitive[T]> {
+    private type;
+    readonly minLength: number;
+    readonly maxLength: number;
+    constructor(type: T, minLength?: number, maxLength?: number);
+    encodeTlvInternal(writer: TlvWriter, value: TlvToPrimitive[T], tag?: TlvTag): void;
+    decodeTlvInternalValue(reader: TlvReader, typeLength: TlvTypeLength): TlvToPrimitive[T];
+    validate(value: TlvToPrimitive[T]): void;
+    bound({ minLength, maxLength, length }: LengthConstraints): StringSchema<T>;
+}
+/** ByteString TLV schema. */
+export declare const TlvByteString: StringSchema<TlvType.ByteString>;
+/** String TLV schema. */
+export declare const TlvString: StringSchema<TlvType.Utf8String>;
+/** String TLV schema. */
+export declare const TlvString32max: StringSchema<TlvType.Utf8String>;
+/** String TLV schema. */
+export declare const TlvString64max: StringSchema<TlvType.Utf8String>;
+/** String TLV schema. */
+export declare const TlvString256max: StringSchema<TlvType.Utf8String>;
+export declare const TlvHardwareAddress: StringSchema<TlvType.ByteString>;
+export {};
+//# sourceMappingURL=TlvString.d.ts.map

package/dist/esm/tlv/TlvString.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"TlvString.d.ts","sourceRoot":"","sources":["../../../src/tlv/TlvString.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH,OAAO,EAAY,MAAM,EAAE,cAAc,EAAE,OAAO,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AACzF,OAAO,EAAE,SAAS,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAEjE,KAAK,iBAAiB,GAAG;IACrB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,MAAM,CAAC;CACnB,CAAC;AAEF;;;;GAIG;AACH,qBAAa,YAAY,CAAC,CAAC,SAAS,OAAO,CAAC,UAAU,GAAG,OAAO,CAAC,UAAU,CAAE,SAAQ,SAAS,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC;IAEzG,OAAO,CAAC,IAAI;IACZ,QAAQ,CAAC,SAAS,EAAE,MAAM;IAC1B,QAAQ,CAAC,SAAS,EAAE,MAAM;gBAFlB,IAAI,EAAE,CAAC,EACN,SAAS,GAAE,MAAU,EACrB,SAAS,GAAE,MAAa;IAO5B,iBAAiB,CAAC,MAAM,EAAE,SAAS,EAAE,KAAK,EAAE,cAAc,CAAC,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,MAAM,GAAG,IAAI;IAMlF,sBAAsB,CAAC,MAAM,EAAE,SAAS,EAAE,UAAU,EAAE,aAAa,GAAG,cAAc,CAAC,CAAC,CAAC;IAKvF,QAAQ,CAAC,KAAK,EAAE,cAAc,CAAC,CAAC,CAAC,GAAG,IAAI;IAejD,KAAK,CAAC,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,EAAE,EAAE,iBAAiB;CAO5D;AAED,6BAA6B;AAC7B,eAAO,MAAM,aAAa,kCAAuC,CAAC;AAElE,yBAAyB;AACzB,eAAO,MAAM,SAAS,kCAAuC,CAAC;AAE9D,yBAAyB;AACzB,eAAO,MAAM,cAAc,kCAAqC,CAAC;AAEjE,yBAAyB;AACzB,eAAO,MAAM,cAAc,kCAAqC,CAAC;AAEjE,yBAAyB;AACzB,eAAO,MAAM,eAAe,kCAAsC,CAAC;AAEnE,eAAO,MAAM,kBAAkB,kCAAsD,CAAC"}

package/dist/esm/tlv/TlvString.js

@@ -0,0 +1,64 @@
+/**
+ * @license
+ * Copyright 2022-2024 Matter.js Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { InternalError, maxValue, minValue, serialize, UnexpectedDataError } from "#general";
+import { ValidationDatatypeMismatchError, ValidationOutOfBoundsError } from "../common/ValidationError.js";
+import { TlvCodec, TlvType } from "./TlvCodec.js";
+import { TlvSchema } from "./TlvSchema.js";
+class StringSchema extends TlvSchema {
+  constructor(type, minLength = 0, maxLength = 1024) {
+    super();
+    this.type = type;
+    this.minLength = minLength;
+    this.maxLength = maxLength;
+    if (minLength < 0) throw new InternalError("Minimum length should be a positive number.");
+  }
+  encodeTlvInternal(writer, value, tag) {
+    const typeLength = { type: this.type, length: TlvCodec.getUIntTlvLength(value.length) };
+    writer.writeTag(typeLength, tag);
+    writer.writePrimitive(typeLength, value);
+  }
+  decodeTlvInternalValue(reader, typeLength) {
+    if (typeLength.type !== this.type) throw new UnexpectedDataError(`Unexpected type ${typeLength.type}.`);
+    return reader.readPrimitive(typeLength);
+  }
+  validate(value) {
+    if (this.type === TlvType.Utf8String && typeof value !== "string")
+      throw new ValidationDatatypeMismatchError(`Expected string, got ${typeof value}.`);
+    if (this.type === TlvType.ByteString && !(value instanceof Uint8Array))
+      throw new ValidationDatatypeMismatchError(`Expected Uint8Array, got ${typeof value}.`);
+    if (value.length > this.maxLength)
+      throw new ValidationOutOfBoundsError(
+        `String ${serialize(value)} is too long: ${value.length}, max ${this.maxLength}.`
+      );
+    if (value.length < this.minLength)
+      throw new ValidationOutOfBoundsError(
+        `String ${serialize(value)} is too short: ${value.length}, min ${this.minLength}.`
+      );
+  }
+  bound({ minLength, maxLength, length }) {
+    return new StringSchema(
+      this.type,
+      length ?? maxValue(this.minLength, minLength),
+      length ?? minValue(this.maxLength, maxLength)
+    );
+  }
+}
+const TlvByteString = new StringSchema(TlvType.ByteString);
+const TlvString = new StringSchema(TlvType.Utf8String);
+const TlvString32max = TlvString.bound({ maxLength: 32 });
+const TlvString64max = TlvString.bound({ maxLength: 64 });
+const TlvString256max = TlvString.bound({ maxLength: 256 });
+const TlvHardwareAddress = TlvByteString.bound({ minLength: 6, maxLength: 8 });
+export {
+  StringSchema,
+  TlvByteString,
+  TlvHardwareAddress,
+  TlvString,
+  TlvString256max,
+  TlvString32max,
+  TlvString64max
+};
+//# sourceMappingURL=TlvString.js.map

package/dist/esm/tlv/TlvString.js.map

@@ -0,0 +1,6 @@
+{
+  "version": 3,
+  "sources": ["../../../src/tlv/TlvString.ts"],
+  "mappings": "AAAA;AAAA;AAAA;AAAA;AAAA;AAMA,SAAS,eAAe,UAAU,UAAU,WAAW,2BAA2B;AAClF,SAAS,iCAAiC,kCAAkC;AAC5E,SAAS,UAAkC,eAA8B;AACzE,SAAoB,iBAA4B;AAazC,MAAM,qBAAwE,UAA6B;AAAA,EAC9G,YACY,MACC,YAAoB,GACpB,YAAoB,MAC/B;AACE,UAAM;AAJE;AACC;AACA;AAIT,QAAI,YAAY,EAAG,OAAM,IAAI,cAAc,6CAA6C;AAAA,EAC5F;AAAA,EAES,kBAAkB,QAAmB,OAA0B,KAAoB;AACxF,UAAM,aAA4B,EAAE,MAAM,KAAK,MAAM,QAAQ,SAAS,iBAAiB,MAAM,MAAM,EAAE;AACrG,WAAO,SAAS,YAAY,GAAG;AAC/B,WAAO,eAAe,YAAY,KAAK;AAAA,EAC3C;AAAA,EAES,uBAAuB,QAAmB,YAA8C;AAC7F,QAAI,WAAW,SAAS,KAAK,KAAM,OAAM,IAAI,oBAAoB,mBAAmB,WAAW,IAAI,GAAG;AACtG,WAAO,OAAO,cAAc,UAAU;AAAA,EAC1C;AAAA,EAES,SAAS,OAAgC;AAC9C,QAAI,KAAK,SAAS,QAAQ,cAAc,OAAO,UAAU;AACrD,YAAM,IAAI,gCAAgC,wBAAwB,OAAO,KAAK,GAAG;AACrF,QAAI,KAAK,SAAS,QAAQ,cAAc,EAAE,iBAAiB;AACvD,YAAM,IAAI,gCAAgC,4BAA4B,OAAO,KAAK,GAAG;AACzF,QAAI,MAAM,SAAS,KAAK;AACpB,YAAM,IAAI;AAAA,QACN,UAAU,UAAU,KAAK,CAAC,iBAAiB,MAAM,MAAM,SAAS,KAAK,SAAS;AAAA,MAClF;AACJ,QAAI,MAAM,SAAS,KAAK;AACpB,YAAM,IAAI;AAAA,QACN,UAAU,UAAU,KAAK,CAAC,kBAAkB,MAAM,MAAM,SAAS,KAAK,SAAS;AAAA,MACnF;AAAA,EACR;AAAA,EAEA,MAAM,EAAE,WAAW,WAAW,OAAO,GAAsB;AACvD,WAAO,IAAI;AAAA,MACP,KAAK;AAAA,MACL,UAAU,SAAS,KAAK,WAAW,SAAS;AAAA,MAC5C,UAAU,SAAS,KAAK,WAAW,SAAS;AAAA,IAChD;AAAA,EACJ;AACJ;AAGO,MAAM,gBAAgB,IAAI,aAAa,QAAQ,UAAU;AAGzD,MAAM,YAAY,IAAI,aAAa,QAAQ,UAAU;AAGrD,MAAM,iBAAiB,UAAU,MAAM,EAAE,WAAW,GAAG,CAAC;AAGxD,MAAM,iBAAiB,UAAU,MAAM,EAAE,WAAW,GAAG,CAAC;AAGxD,MAAM,kBAAkB,UAAU,MAAM,EAAE,WAAW,IAAI,CAAC;AAE1D,MAAM,qBAAqB,cAAc,MAAM,EAAE,WAAW,GAAG,WAAW,EAAE,CAAC;",
+  "names": []
+}

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

@@ -0,0 +1,19 @@
+/**
+ * @license
+ * Copyright 2022-2024 Matter.js Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { TlvTag, TlvTypeLength } from "./TlvCodec.js";
+import { TlvReader, TlvSchema, TlvStream, TlvWriter } from "./TlvSchema.js";
+/**
+ * Schema to encode void.
+ */
+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;
+//# sourceMappingURL=TlvVoid.d.ts.map

package/dist/esm/tlv/TlvVoid.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"TlvVoid.d.ts","sourceRoot":"","sources":["../../../src/tlv/TlvVoid.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH,OAAO,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AACtD,OAAO,EAAE,SAAS,EAAE,SAAS,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAE5E;;GAEG;AACH,qBAAa,UAAW,SAAQ,SAAS,CAAC,IAAI,CAAC;IAClC,iBAAiB,CAAC,OAAO,EAAE,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI;IAIxE,SAAS,CAAC,QAAQ,EAAE,SAAS,GAAG,IAAI;IAIpC,sBAAsB,CAAC,OAAO,EAAE,SAAS,EAAE,WAAW,EAAE,aAAa,GAAG,IAAI;IAI5E,QAAQ,CAAC,IAAI,EAAE,IAAI,GAAG,IAAI;CAGtC;AAED,uBAAuB;AACvB,eAAO,MAAM,OAAO,YAAmB,CAAC"}

package/dist/esm/tlv/TlvVoid.js

@@ -0,0 +1,26 @@
+/**
+ * @license
+ * Copyright 2022-2024 Matter.js Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { InternalError } from "#general";
+import { ValidationDatatypeMismatchError } from "../common/ValidationError.js";
+import { TlvSchema } from "./TlvSchema.js";
+class VoidSchema extends TlvSchema {
+  encodeTlvInternal(_writer, _value, _tag) {
+  }
+  decodeTlv(_encoded) {
+  }
+  decodeTlvInternalValue(_reader, _typeLength) {
+    throw new InternalError("decodeTlvInternalValue should never be called");
+  }
+  validate(data) {
+    if (data !== void 0) throw new ValidationDatatypeMismatchError(`Expected void, got ${typeof data}.`);
+  }
+}
+const TlvVoid = new VoidSchema();
+export {
+  TlvVoid,
+  VoidSchema
+};
+//# sourceMappingURL=TlvVoid.js.map

package/dist/esm/tlv/TlvVoid.js.map

@@ -0,0 +1,6 @@
+{
+  "version": 3,
+  "sources": ["../../../src/tlv/TlvVoid.ts"],
+  "mappings": "AAAA;AAAA;AAAA;AAAA;AAAA;AAMA,SAAS,qBAAqB;AAC9B,SAAS,uCAAuC;AAEhD,SAAoB,iBAAuC;AAKpD,MAAM,mBAAmB,UAAgB;AAAA,EACnC,kBAAkB,SAAoB,QAAc,MAAqB;AAAA,EAElF;AAAA,EAES,UAAU,UAA2B;AAAA,EAE9C;AAAA,EAES,uBAAuB,SAAoB,aAAkC;AAClF,UAAM,IAAI,cAAc,+CAA+C;AAAA,EAC3E;AAAA,EAES,SAAS,MAAkB;AAChC,QAAI,SAAS,OAAW,OAAM,IAAI,gCAAgC,sBAAsB,OAAO,IAAI,GAAG;AAAA,EAC1G;AACJ;AAGO,MAAM,UAAU,IAAI,WAAW;",
+  "names": []
+}

package/dist/esm/tlv/TlvWrapper.d.ts

@@ -0,0 +1,17 @@
+/**
+ * @license
+ * Copyright 2022-2024 Matter.js Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { TlvTag, TlvTypeLength } from "./TlvCodec.js";
+import { TlvEncodingOptions, TlvReader, TlvSchema, TlvWriter } from "./TlvSchema.js";
+export declare class TlvWrapper<O, T> extends TlvSchema<O> {
+    protected readonly underlyingSchema: TlvSchema<T>;
+    protected readonly wrap: (object: O) => T;
+    private readonly unwrap;
+    constructor(underlyingSchema: TlvSchema<T>, wrap: (object: O) => T, unwrap: (value: T) => O);
+    decodeTlvInternalValue(reader: TlvReader, typeLength: TlvTypeLength): O;
+    encodeTlvInternal(writer: TlvWriter, value: O, tag?: TlvTag, options?: TlvEncodingOptions): void;
+    validate(value: O): void;
+}
+//# sourceMappingURL=TlvWrapper.d.ts.map

package/dist/esm/tlv/TlvWrapper.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"TlvWrapper.d.ts","sourceRoot":"","sources":["../../../src/tlv/TlvWrapper.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AACtD,OAAO,EAAE,kBAAkB,EAAE,SAAS,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAErF,qBAAa,UAAU,CAAC,CAAC,EAAE,CAAC,CAAE,SAAQ,SAAS,CAAC,CAAC,CAAC;IAE1C,SAAS,CAAC,QAAQ,CAAC,gBAAgB,EAAE,SAAS,CAAC,CAAC,CAAC;IACjD,SAAS,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC,MAAM,EAAE,CAAC,KAAK,CAAC;IACzC,OAAO,CAAC,QAAQ,CAAC,MAAM;gBAFJ,gBAAgB,EAAE,SAAS,CAAC,CAAC,CAAC,EAC9B,IAAI,EAAE,CAAC,MAAM,EAAE,CAAC,KAAK,CAAC,EACxB,MAAM,EAAE,CAAC,KAAK,EAAE,CAAC,KAAK,CAAC;IAKnC,sBAAsB,CAAC,MAAM,EAAE,SAAS,EAAE,UAAU,EAAE,aAAa,GAAG,CAAC;IAIvE,iBAAiB,CAAC,MAAM,EAAE,SAAS,EAAE,KAAK,EAAE,CAAC,EAAE,GAAG,CAAC,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,kBAAkB,GAAG,IAAI;IAIhG,QAAQ,CAAC,KAAK,EAAE,CAAC,GAAG,IAAI;CAGpC"}