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

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

@@ -0,0 +1,6 @@
+{
+  "version": 3,
+  "sources": ["../../../src/tlv/TlvCodec.ts"],
+  "mappings": "AAAA;AAAA;AAAA;AAAA;AAAA;AAMA;AAAA,EACI;AAAA,EAIA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OACG;AACP,SAAS,UAAU,cAAc,oBAAoB;AAO9C,IAAK,UAAL,kBAAKA,aAAL;AACH,EAAAA,kBAAA,eAAY,KAAZ;AACA,EAAAA,kBAAA,iBAAc,KAAd;AACA,EAAAA,kBAAA,aAAU,KAAV;AACA,EAAAA,kBAAA,WAAQ,MAAR;AACA,EAAAA,kBAAA,gBAAa,MAAb;AACA,EAAAA,kBAAA,gBAAa,MAAb;AACA,EAAAA,kBAAA,UAAO,MAAP;AACA,EAAAA,kBAAA,eAAY,MAAZ;AACA,EAAAA,kBAAA,WAAQ,MAAR;AACA,EAAAA,kBAAA,UAAO,MAAP;AACA,EAAAA,kBAAA,oBAAiB,MAAjB;AAXQ,SAAAA;AAAA,GAAA;AAeL,IAAK,YAAL,kBAAKC,eAAL;AACH,EAAAA,sBAAA,aAAU,KAAV;AACA,EAAAA,sBAAA,cAAW,KAAX;AACA,EAAAA,sBAAA,eAAY,KAAZ;AACA,EAAAA,sBAAA,gBAAa,KAAb;AAJQ,SAAAA;AAAA,GAAA;AAyCZ,IAAW,aAAX,kBAAWC,gBAAX;AACI,EAAAA,wBAAA,eAAY,KAAZ;AACA,EAAAA,wBAAA,qBAAkB,KAAlB;AACA,EAAAA,wBAAA,qBAAkB,KAAlB;AACA,EAAAA,wBAAA,qBAAkB,KAAlB;AACA,EAAAA,wBAAA,uBAAoB,KAApB;AACA,EAAAA,wBAAA,uBAAoB,KAApB;AACA,EAAAA,wBAAA,sBAAmB,KAAnB;AACA,EAAAA,wBAAA,sBAAmB,KAAnB;AARO,SAAAA;AAAA,GAAA;AAgBX,MAAM,oBAAoB,aAAa;AAAA,EACnC,YAAY,SAAS,GAAG,CAAC;AAAA,EACzB,YAAY,aAAyB,GAAG,CAAC;AAC7C,CAAC;AAGD,MAAM,wBAAwB;AAQvB,MAAM,SAAS;AAAA,EAClB,OAAc,iBAAiB,OAAwB;AACnD,QAAI,SAAS,WAAW;AACpB,aAAO;AAAA,IACX,WAAW,SAAS,YAAY;AAC5B,aAAO;AAAA,IACX,WAAW,SAAS,YAAY;AAC5B,aAAO;AAAA,IACX,OAAO;AACH,aAAO;AAAA,IACX;AAAA,EACJ;AAAA,EAEA,OAAc,gBAAgB,OAAwB;AAClD,QAAI,QAAQ,GAAG;AACX,UAAI,SAAS,UAAU;AACnB,eAAO;AAAA,MACX,WAAW,SAAS,WAAW;AAC3B,eAAO;AAAA,MACX,WAAW,SAAS,WAAW;AAC3B,eAAO;AAAA,MACX,OAAO;AACH,eAAO;AAAA,MACX;AAAA,IACJ,OAAO;AACH,UAAI,SAAS,UAAU;AACnB,eAAO;AAAA,MACX,WAAW,SAAS,WAAW;AAC3B,eAAO;AAAA,MACX,WAAW,SAAS,WAAW;AAC3B,eAAO;AAAA,MACX,OAAO;AACH,eAAO;AAAA,MACX;AAAA,IACJ;AAAA,EACJ;AAAA;AAAA,EAGA,OAAc,YAAY,QAAgF;AACtG,UAAM,EAAE,YAAY,WAAW,IAAI,kBAAkB,OAAO,OAAO,UAAU,CAAC;AAC9E,WAAO,EAAE,KAAK,KAAK,QAAQ,QAAQ,UAAU,GAAG,YAAY,KAAK,gBAAgB,UAAU,EAAE;AAAA,EACjG;AAAA,EAEA,OAAe,QAAQ,QAAmC,YAA4C;AAClG,YAAQ,YAAY;AAAA,MAChB,KAAK;AACD,eAAO;AAAA,MACX,KAAK;AACD,eAAO,EAAE,IAAI,OAAO,UAAU,EAAE;AAAA,MACpC,KAAK;AACD,eAAO,EAAE,SAAS,uBAAuB,IAAI,OAAO,WAAW,EAAE;AAAA,MACrE,KAAK;AACD,eAAO,EAAE,SAAS,uBAAuB,IAAI,OAAO,WAAW,EAAE;AAAA,MACrE,KAAK;AAAA,MACL,KAAK;AACD,cAAM,IAAI,oBAAoB,gCAAgC,UAAU,EAAE;AAAA,MAC9E,KAAK;AACD,eAAO,EAAE,SAAS,OAAO,WAAW,GAAG,IAAI,OAAO,WAAW,EAAE;AAAA,MACnE;AACI,cAAM,IAAI,oBAAoB,yBAAyB,UAAU,EAAE;AAAA,IAC3E;AAAA,EACJ;AAAA,EAEA,OAAe,gBAAgB,YAAmC;AAC9D,UAAM,SAAU,aAAa;AAC7B,UAAM,OAAO,aAAa;AAC1B,YAAQ,MAAM;AAAA,MACV,KAAK;AAAA,MACL,KAAK;AAAA,MACL,KAAK;AAAA,MACL,KAAK;AACD,eAAO,EAAE,MAAM,OAAO;AAAA,MAC1B,KAAK;AACD,gBAAQ,QAAQ;AAAA,UACZ,KAAK;AACD,mBAAO,EAAE,MAAM,OAAO,MAAM;AAAA,UAChC,KAAK;AACD,mBAAO,EAAE,MAAM,OAAO,KAAK;AAAA,UAC/B,KAAK;AACD,mBAAO,EAAE,MAAM,gBAAe,OAAO;AAAA,UACzC,KAAK;AACD,mBAAO,EAAE,MAAM,gBAAe,OAAO;AAAA,UACzC;AACI,kBAAM,IAAI,oBAAoB,6BAA6B,MAAM,EAAE;AAAA,QAC3E;AAAA,MACJ;AACI,eAAO,EAAE,MAAM,WAAW;AAAA,IAClC;AAAA,EACJ;AAAA,EAEA,OAAc,cACV,QACA,YACC;AACD,YAAQ,WAAW,MAAM;AAAA,MACrB,KAAK,mBAAmB;AACpB,cAAM,SAAS,WAAW;AAC1B,gBAAQ,QAAQ;AAAA,UACZ,KAAK;AACD,mBAAO,OAAO,SAAS;AAAA,UAC3B,KAAK;AACD,mBAAO,OAAO,UAAU;AAAA,UAC5B,KAAK;AACD,mBAAO,OAAO,UAAU;AAAA,UAC5B,KAAK;AACD,mBAAO,OAAO,UAAU;AAAA,UAC5B;AACI,kBAAM,IAAI,oBAAoB,+BAA+B,MAAM,EAAE;AAAA,QAC7E;AAAA,MACJ;AAAA,MACA,KAAK,qBAAqB;AACtB,cAAM,SAAS,WAAW;AAC1B,gBAAQ,QAAQ;AAAA,UACZ,KAAK;AACD,mBAAO,OAAO,UAAU;AAAA,UAC5B,KAAK;AACD,mBAAO,OAAO,WAAW;AAAA,UAC7B,KAAK;AACD,mBAAO,OAAO,WAAW;AAAA,UAC7B,KAAK;AACD,mBAAO,OAAO,WAAW;AAAA,UAC7B;AACI,kBAAM,IAAI,oBAAoB,iCAAiC,MAAM,EAAE;AAAA,QAC/E;AAAA,MACJ;AAAA,MACA,KAAK,gBAAe;AAChB,cAAM,SAAS,WAAW;AAC1B,gBAAQ,QAAQ;AAAA,UACZ,KAAK;AACD,mBAAO,OAAO,UAAU;AAAA,UAC5B,KAAK;AACD,mBAAO,OAAO,WAAW;AAAA,UAC7B;AACI,kBAAM,IAAI,oBAAoB,2BAA2B,MAAM,EAAE;AAAA,QACzE;AAAA,MACJ;AAAA,MACA,KAAK,qBAAoB;AACrB,cAAM,SAAS,WAAW;AAC1B,gBAAQ,QAAQ;AAAA,UACZ,KAAK;AACD,mBAAO,OAAO,eAAe,OAAO,UAAU,CAAC;AAAA,UACnD,KAAK;AACD,mBAAO,OAAO,eAAe,OAAO,WAAW,CAAC;AAAA,UACpD,KAAK;AACD,mBAAO,OAAO,eAAe,OAAO,WAAW,CAAC;AAAA,UACpD,KAAK;AACD,mBAAO,OAAO,eAAe,OAAO,OAAO,WAAW,CAAC,CAAC;AAAA,UAC5D;AACI,kBAAM,IAAI,oBAAoB,gCAAgC,MAAM,EAAE;AAAA,QAC9E;AAAA,MACJ;AAAA,MACA,KAAK,qBAAoB;AACrB,cAAM,SAAS,WAAW;AAC1B,gBAAQ,QAAQ;AAAA,UACZ,KAAK;AACD,mBAAO,OAAO,cAAc,OAAO,UAAU,CAAC;AAAA,UAClD,KAAK;AACD,mBAAO,OAAO,cAAc,OAAO,WAAW,CAAC;AAAA,UACnD,KAAK;AACD,mBAAO,OAAO,cAAc,OAAO,WAAW,CAAC;AAAA,UACnD,KAAK;AACD,mBAAO,OAAO,cAAc,OAAO,OAAO,WAAW,CAAC,CAAC;AAAA,UAC3D;AACI,kBAAM,IAAI,oBAAoB,gCAAgC,MAAM,EAAE;AAAA,QAC9E;AAAA,MACJ;AAAA,MACA,KAAK;AACD,eAAO,WAAW;AAAA,MACtB,KAAK;AACD,eAAO;AAAA,MACX;AACI,cAAM,IAAI,oBAAoB,uBAAuB,WAAW,IAAI,EAAE;AAAA,IAC9E;AAAA,EACJ;AAAA;AAAA,EAGA,OAAc,SAAS,QAAmC,iBAAgC,KAAc;AACpG,UAAM,EAAE,SAAS,GAAG,IAAI,OAAO,CAAC;AAChC,QAAI;AACJ,YAAQ,gBAAgB,MAAM;AAAA,MAC1B,KAAK;AAAA,MACL,KAAK;AAAA,MACL,KAAK;AAAA,MACL,KAAK;AAAA,MACL,KAAK;AACD,qBAAa,gBAAgB,OAAO,gBAAgB;AACpD;AAAA,MACJ,KAAK;AACD,qBAAa,gBAAgB,QAAQ,gBAAgB,QAAQ,IAAI;AACjE;AAAA,MACJ;AACI,qBAAa,gBAAgB;AAAA,IACrC;AAEA,QAAI,YAAY,UAAa,OAAO,QAAW;AAC3C,aAAO,WAAW,kBAAkB,OAAO,EAAE,YAAY,mBAAsB,WAAW,CAAC,CAAC;AAAA,IAChG,WAAW,YAAY,QAAW;AAC9B,UAAI,OAAO;AACP,cAAM,IAAI,oBAAoB,mEAAmE;AACrG,aAAO,WAAW,kBAAkB,OAAO,EAAE,YAAY,yBAA4B,WAAW,CAAC,CAAC;AAClG,aAAO,WAAW,EAAE;AAAA,IACxB,WAAW,YAAY,uBAAuB;AAC1C,UAAI,OAAO;AACP,cAAM,IAAI,oBAAoB,+DAA+D;AACjG,WAAK,KAAK,gBAAgB,GAAG;AACzB,eAAO,WAAW,kBAAkB,OAAO,EAAE,YAAY,yBAA4B,WAAW,CAAC,CAAC;AAClG,eAAO,YAAY,EAAE;AAAA,MACzB,OAAO;AACH,eAAO,WAAW,kBAAkB,OAAO,EAAE,YAAY,yBAA4B,WAAW,CAAC,CAAC;AAClG,eAAO,YAAY,EAAE;AAAA,MACzB;AAAA,IACJ,OAAO;AACH,UAAI,OAAO;AACP,cAAM,IAAI,oBAAoB,6DAA6D;AAC/F,WAAK,KAAK,gBAAgB,GAAG;AACzB,eAAO,WAAW,kBAAkB,OAAO,EAAE,YAAY,0BAA6B,WAAW,CAAC,CAAC;AACnG,eAAO,YAAY,OAAO;AAC1B,eAAO,YAAY,EAAE;AAAA,MACzB,OAAO;AACH,eAAO,WAAW,kBAAkB,OAAO,EAAE,YAAY,0BAA6B,WAAW,CAAC,CAAC;AACnG,eAAO,YAAY,OAAO;AAC1B,eAAO,YAAY,EAAE;AAAA,MACzB;AAAA,IACJ;AAAA,EACJ;AAAA,EAEA,OAAc,iBAAiB,KAAc;AACzC,UAAM,EAAE,SAAS,GAAG,IAAI,OAAO,CAAC;AAEhC,QAAI,YAAY,UAAa,OAAO,QAAW;AAC3C,aAAO;AAAA,IACX,WAAW,YAAY,QAAW;AAC9B,UAAI,OAAO;AACP,cAAM,IAAI,oBAAoB,mEAAmE;AACrG,aAAO;AAAA,IACX,WAAW,YAAY,uBAAuB;AAC1C,UAAI,OAAO;AACP,cAAM,IAAI,oBAAoB,+DAA+D;AACjG,WAAK,KAAK,gBAAgB,GAAG;AACzB,eAAO;AAAA,MACX,OAAO;AACH,eAAO;AAAA,MACX;AAAA,IACJ,OAAO;AACH,UAAI,OAAO;AACP,cAAM,IAAI,oBAAoB,6DAA6D;AAC/F,WAAK,KAAK,gBAAgB,GAAG;AACzB,eAAO;AAAA,MACX,OAAO;AACH,eAAO;AAAA,MACX;AAAA,IACJ;AAAA,EACJ;AAAA,EAEA,OAAc,eACV,QACA,YACA,OACF;AACE,YAAQ,WAAW,MAAM;AAAA,MACrB,KAAK;AACD,eAAO,KAAK,UAAU,QAAQ,WAAW,QAAQ,KAA+C;AAAA,MACpG,KAAK,qBAAqB;AACtB,cAAM,SAAS,WAAW;AAC1B,gBAAQ,QAAQ;AAAA,UACZ,KAAK;AACD,mBAAO,OAAO,WAAW,KAA+C;AAAA,UAC5E,KAAK;AACD,mBAAO,OAAO,YAAY,KAA+C;AAAA,UAC7E,KAAK;AACD,mBAAO,OAAO,YAAY,KAA+C;AAAA,UAC7E,KAAK;AACD,mBAAO,OAAO,YAAY,KAA+C;AAAA,UAC7E;AACI,kBAAM,IAAI,oBAAoB,iCAAiC,MAAM,EAAE;AAAA,QAC/E;AAAA,MACJ;AAAA,MACA,KAAK,gBAAe;AAChB,cAAM,SAAS,WAAW;AAC1B,gBAAQ,QAAQ;AAAA,UACZ,KAAK;AACD,mBAAO,OAAO,WAAW,KAA+C;AAAA,UAC5E,KAAK;AACD,mBAAO,OAAO,YAAY,KAA+C;AAAA,UAC7E;AACI,kBAAM,IAAI,oBAAoB,2BAA2B,MAAM,EAAE;AAAA,QACzE;AAAA,MACJ;AAAA,MACA,KAAK,qBAAoB;AACrB,cAAM,SAAS;AACf,cAAM,aAAa,MAAM,WAAW,MAAM;AAC1C,aAAK,UAAU,QAAQ,WAAW,QAAQ,WAAW,MAAM;AAC3D,eAAO,OAAO,eAAe,UAAU;AAAA,MAC3C;AAAA,MACA,KAAK,qBAAoB;AACrB,cAAM,YAAY;AAClB,aAAK,UAAU,QAAQ,WAAW,QAAQ,UAAU,MAAM;AAC1D,eAAO,OAAO,eAAe,SAAS;AAAA,MAC1C;AAAA,MACA,KAAK;AACD;AAAA,MACJ;AACI,cAAM,IAAI,oBAAoB,uBAAuB,WAAW,IAAI,EAAE;AAAA,IAC9E;AAAA,EACJ;AAAA,EAEA,OAAc,uBAAgD,YAAe,OAAkC;AAC3G,YAAQ,WAAW,MAAM;AAAA,MACrB,KAAK;AAAA,MACL,KAAK;AAAA,MACL,KAAK;AACD,eAAO,KAAK,kBAAkB,WAAW,MAAM;AAAA,MACnD,KAAK,qBAAoB;AACrB,cAAM,SAAS;AACf,cAAM,aAAa,MAAM,WAAW,MAAM;AAC1C,eAAO,KAAK,kBAAkB,WAAW,MAAM,IAAI,WAAW;AAAA,MAClE;AAAA,MACA,KAAK,qBAAoB;AACrB,cAAM,YAAY;AAClB,eAAO,KAAK,kBAAkB,WAAW,MAAM,IAAI,UAAU;AAAA,MACjE;AAAA,MACA,KAAK;AACD,eAAO;AAAA,MACX;AACI,cAAM,IAAI,oBAAoB,uBAAuB,WAAW,IAAI,EAAE;AAAA,IAC9E;AAAA,EACJ;AAAA,EAEA,OAAe,UAAU,QAAmC,QAAmB,OAAwB;AACnG,YAAQ,QAAQ;AAAA,MACZ,KAAK;AACD,eAAO,OAAO,UAAU,KAAK;AAAA,MACjC,KAAK;AACD,eAAO,OAAO,WAAW,KAAK;AAAA,MAClC,KAAK;AACD,eAAO,OAAO,WAAW,KAAK;AAAA,MAClC,KAAK;AACD,eAAO,OAAO,WAAW,KAAK;AAAA,IACtC;AAAA,EACJ;AAAA,EAEA,OAAe,kBAAkB,QAAmB;AAChD,YAAQ,QAAQ;AAAA,MACZ,KAAK;AACD,eAAO;AAAA,MACX,KAAK;AACD,eAAO;AAAA,MACX,KAAK;AACD,eAAO;AAAA,MACX,KAAK;AACD,eAAO;AAAA,IACf;AAAA,EACJ;AACJ;",
+  "names": ["TlvType", "TlvLength", "TagControl"]
+}

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

@@ -0,0 +1,17 @@
+/**
+ * @license
+ * Copyright 2022-2024 Matter.js Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { TlvTag } from "./TlvCodec.js";
+import { TlvWriter } from "./TlvSchema.js";
+import { VoidSchema } from "./TlvVoid.js";
+/**
+ * Schema to encode void.
+ */
+export declare class NoArgumentsSchema extends VoidSchema {
+    encodeTlvInternal(writer: TlvWriter, value: void, tag?: TlvTag): void;
+}
+/** Void TLV schema. */
+export declare const TlvNoArguments: NoArgumentsSchema;
+//# sourceMappingURL=TlvNoArguments.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"TlvNoArguments.d.ts","sourceRoot":"","sources":["../../../src/tlv/TlvNoArguments.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,EAAE,MAAM,EAAE,MAAM,eAAe,CAAC;AAEvC,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAC3C,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAI1C;;GAEG;AACH,qBAAa,iBAAkB,SAAQ,UAAU;IACpC,iBAAiB,CAAC,MAAM,EAAE,SAAS,EAAE,KAAK,EAAE,IAAI,EAAE,GAAG,CAAC,EAAE,MAAM,GAAG,IAAI;CAIjF;AAED,uBAAuB;AACvB,eAAO,MAAM,cAAc,mBAA0B,CAAC"}

package/dist/esm/tlv/TlvNoArguments.js

@@ -0,0 +1,21 @@
+/**
+ * @license
+ * Copyright 2022-2024 Matter.js Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { UnexpectedDataError } from "#general";
+import { TlvObject } from "./TlvObject.js";
+import { VoidSchema } from "./TlvVoid.js";
+const TlvEmptyObject = TlvObject({});
+class NoArgumentsSchema extends VoidSchema {
+  encodeTlvInternal(writer, value, tag) {
+    if (value !== void 0) throw new UnexpectedDataError("No value should be passed");
+    TlvEmptyObject.encodeTlvInternal(writer, {}, tag);
+  }
+}
+const TlvNoArguments = new NoArgumentsSchema();
+export {
+  NoArgumentsSchema,
+  TlvNoArguments
+};
+//# sourceMappingURL=TlvNoArguments.js.map

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

@@ -0,0 +1,6 @@
+{
+  "version": 3,
+  "sources": ["../../../src/tlv/TlvNoArguments.ts"],
+  "mappings": "AAAA;AAAA;AAAA;AAAA;AAAA;AAMA,SAAS,2BAA2B;AAEpC,SAAS,iBAAiB;AAE1B,SAAS,kBAAkB;AAE3B,MAAM,iBAAiB,UAAU,CAAC,CAAC;AAK5B,MAAM,0BAA0B,WAAW;AAAA,EACrC,kBAAkB,QAAmB,OAAa,KAAoB;AAC3E,QAAI,UAAU,OAAW,OAAM,IAAI,oBAAoB,2BAA2B;AAClF,mBAAe,kBAAkB,QAAQ,CAAC,GAAG,GAAG;AAAA,EACpD;AACJ;AAGO,MAAM,iBAAiB,IAAI,kBAAkB;",
+  "names": []
+}

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

@@ -0,0 +1,24 @@
+/**
+ * @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";
+/**
+ * Schema to encode a nullable value in TLV.
+ *
+ * @see {@link MatterSpecification.v10.Core} § A.11.6
+ */
+export declare class NullableSchema<T> extends TlvSchema<T | null> {
+    private readonly schema;
+    constructor(schema: TlvSchema<T>);
+    encodeTlvInternal(writer: TlvWriter, value: T | null, tag?: TlvTag, options?: TlvEncodingOptions): void;
+    decodeTlvInternalValue(reader: TlvReader, typeLength: TlvTypeLength): T | null;
+    validate(value: T | null): void;
+    injectField(value: T, fieldId: number, fieldValue: any, injectChecker: (fieldValue: any) => boolean): T;
+    removeField(value: T, fieldId: number, removeChecker: (fieldValue: any) => boolean): T;
+}
+/** Nullable TLV schema. */
+export declare const TlvNullable: <T>(schema: TlvSchema<T>) => NullableSchema<T>;
+//# sourceMappingURL=TlvNullable.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"TlvNullable.d.ts","sourceRoot":"","sources":["../../../src/tlv/TlvNullable.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,EAAE,MAAM,EAAW,aAAa,EAAE,MAAM,eAAe,CAAC;AAC/D,OAAO,EAAE,kBAAkB,EAAE,SAAS,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAGrF;;;;GAIG;AACH,qBAAa,cAAc,CAAC,CAAC,CAAE,SAAQ,SAAS,CAAC,CAAC,GAAG,IAAI,CAAC;IAC1C,OAAO,CAAC,QAAQ,CAAC,MAAM;gBAAN,MAAM,EAAE,SAAS,CAAC,CAAC,CAAC;IAIxC,iBAAiB,CAAC,MAAM,EAAE,SAAS,EAAE,KAAK,EAAE,CAAC,GAAG,IAAI,EAAE,GAAG,CAAC,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,kBAAkB,GAAG,IAAI;IAQvG,sBAAsB,CAAC,MAAM,EAAE,SAAS,EAAE,UAAU,EAAE,aAAa,GAAG,CAAC,GAAG,IAAI;IAgB9E,QAAQ,CAAC,KAAK,EAAE,CAAC,GAAG,IAAI,GAAG,IAAI;IAI/B,WAAW,CAAC,KAAK,EAAE,CAAC,EAAE,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,GAAG,EAAE,aAAa,EAAE,CAAC,UAAU,EAAE,GAAG,KAAK,OAAO,GAAG,CAAC;IAOvG,WAAW,CAAC,KAAK,EAAE,CAAC,EAAE,OAAO,EAAE,MAAM,EAAE,aAAa,EAAE,CAAC,UAAU,EAAE,GAAG,KAAK,OAAO,GAAG,CAAC;CAMlG;AAED,2BAA2B;AAC3B,eAAO,MAAM,WAAW,GAAI,CAAC,UAAU,SAAS,CAAC,CAAC,CAAC,sBAA+B,CAAC"}

package/dist/esm/tlv/TlvNullable.js

@@ -0,0 +1,51 @@
+/**
+ * @license
+ * Copyright 2022-2024 Matter.js Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { ArraySchema } from "./TlvArray.js";
+import { TlvType } from "./TlvCodec.js";
+import { TlvSchema } from "./TlvSchema.js";
+import { StringSchema } from "./TlvString.js";
+class NullableSchema extends TlvSchema {
+  constructor(schema) {
+    super();
+    this.schema = schema;
+  }
+  encodeTlvInternal(writer, value, tag, options) {
+    if (value === null) {
+      writer.writeTag({ type: TlvType.Null }, tag);
+    } else {
+      this.schema.encodeTlvInternal(writer, value, tag, options);
+    }
+  }
+  decodeTlvInternalValue(reader, typeLength) {
+    if (typeLength.type === TlvType.Null) return null;
+    const value = this.schema.decodeTlvInternalValue(reader, typeLength);
+    if (value !== null && (this.schema instanceof ArraySchema || this.schema instanceof StringSchema) && value.length === 0) {
+      return null;
+    }
+    return value;
+  }
+  validate(value) {
+    if (value !== null) this.schema.validate(value);
+  }
+  injectField(value, fieldId, fieldValue, injectChecker) {
+    if (value !== null) {
+      return this.schema.injectField(value, fieldId, fieldValue, injectChecker);
+    }
+    return value;
+  }
+  removeField(value, fieldId, removeChecker) {
+    if (value !== null) {
+      return this.schema.removeField(value, fieldId, removeChecker);
+    }
+    return value;
+  }
+}
+const TlvNullable = (schema) => new NullableSchema(schema);
+export {
+  NullableSchema,
+  TlvNullable
+};
+//# sourceMappingURL=TlvNullable.js.map

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

@@ -0,0 +1,6 @@
+{
+  "version": 3,
+  "sources": ["../../../src/tlv/TlvNullable.ts"],
+  "mappings": "AAAA;AAAA;AAAA;AAAA;AAAA;AAMA,SAAS,mBAAmB;AAC5B,SAAiB,eAA8B;AAC/C,SAAwC,iBAA4B;AACpE,SAAS,oBAAoB;AAOtB,MAAM,uBAA0B,UAAoB;AAAA,EACvD,YAA6B,QAAsB;AAC/C,UAAM;AADmB;AAAA,EAE7B;AAAA,EAES,kBAAkB,QAAmB,OAAiB,KAAc,SAAoC;AAC7G,QAAI,UAAU,MAAM;AAChB,aAAO,SAAS,EAAE,MAAM,QAAQ,KAAK,GAAG,GAAG;AAAA,IAC/C,OAAO;AACH,WAAK,OAAO,kBAAkB,QAAQ,OAAO,KAAK,OAAO;AAAA,IAC7D;AAAA,EACJ;AAAA,EAES,uBAAuB,QAAmB,YAAqC;AACpF,QAAI,WAAW,SAAS,QAAQ,KAAM,QAAO;AAC7C,UAAM,QAAQ,KAAK,OAAO,uBAAuB,QAAQ,UAAU;AAInE,QACI,UAAU,SACT,KAAK,kBAAkB,eAAe,KAAK,kBAAkB,iBAC7D,MAAc,WAAW,GAC5B;AACE,aAAO;AAAA,IACX;AACA,WAAO;AAAA,EACX;AAAA,EAES,SAAS,OAAuB;AACrC,QAAI,UAAU,KAAM,MAAK,OAAO,SAAS,KAAK;AAAA,EAClD;AAAA,EAES,YAAY,OAAU,SAAiB,YAAiB,eAAgD;AAC7G,QAAI,UAAU,MAAM;AAChB,aAAO,KAAK,OAAO,YAAY,OAAO,SAAS,YAAY,aAAa;AAAA,IAC5E;AACA,WAAO;AAAA,EACX;AAAA,EAES,YAAY,OAAU,SAAiB,eAAgD;AAC5F,QAAI,UAAU,MAAM;AAChB,aAAO,KAAK,OAAO,YAAY,OAAO,SAAS,aAAa;AAAA,IAChE;AACA,WAAO;AAAA,EACX;AACJ;AAGO,MAAM,cAAc,CAAI,WAAyB,IAAI,eAAe,MAAM;",
+  "names": []
+}

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

@@ -0,0 +1,57 @@
+import { BitSchema, TypeFromPartialBitSchema } from "../schema/BitmapSchema.js";
+import { TlvLength, TlvTag, TlvType, TlvTypeLength } from "./TlvCodec.js";
+import { TlvReader, TlvSchema, TlvWriter } from "./TlvSchema.js";
+import { TlvWrapper } from "./TlvWrapper.js";
+/**
+ * Schema to encode an unsigned integer in TLV.
+ *
+ * @see {@link MatterSpecification.v10.Core} § A.11.1
+ */
+export declare class TlvNumericSchema<T extends bigint | number> extends TlvSchema<T> {
+    protected readonly type: TlvType.UnsignedInt | TlvType.SignedInt | TlvType.Float;
+    protected readonly lengthProvider: (value: T) => TlvLength;
+    protected readonly min?: T | undefined;
+    protected readonly max?: T | undefined;
+    constructor(type: TlvType.UnsignedInt | TlvType.SignedInt | TlvType.Float, lengthProvider: (value: T) => TlvLength, min?: T | undefined, max?: T | undefined);
+    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>;
+}
+export type NumericConstraints<T extends number | bigint = number | bigint> = {
+    min?: T;
+    max?: T;
+};
+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>;
+};
+/** Unsigned integer TLV schema. */
+export declare const TlvFloat: TlvNumberSchema;
+export declare const TlvDouble: TlvNumberSchema;
+export declare const TlvInt8: TlvNumberSchema;
+export declare const TlvInt16: TlvNumberSchema;
+export declare const TlvInt32: TlvNumberSchema;
+export declare const TlvInt64: TlvNumericSchema<number | bigint>;
+export declare const TlvUInt8: TlvNumberSchema;
+export declare const TlvUInt16: TlvNumberSchema;
+export declare const TlvUInt24: TlvNumberSchema;
+export declare const TlvUInt32: TlvNumberSchema;
+export declare const TlvUInt64: TlvNumericSchema<number | bigint>;
+export declare const TlvEnum: <T>() => TlvSchema<T>;
+export declare const TlvBitmap: <T extends BitSchema>(underlyingSchema: TlvNumberSchema, bitSchema: T) => TlvWrapper<TypeFromPartialBitSchema<T>, number>;
+export declare const TlvPercent: TlvNumericSchema<number>;
+export declare const TlvPercent100ths: TlvNumericSchema<number>;
+export declare const TlvEpochUs: TlvNumericSchema<number | bigint>;
+export declare const TlvEpochS: TlvNumberSchema;
+export declare const TlvPosixMs: TlvNumericSchema<number | bigint>;
+export declare const TlvSysTimeUs: TlvNumericSchema<number | bigint>;
+export declare const TlvSysTimeMS: TlvNumericSchema<number | bigint>;
+//# sourceMappingURL=TlvNumber.d.ts.map

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

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

package/dist/esm/tlv/TlvNumber.js

@@ -0,0 +1,185 @@
+/**
+ * @license
+ * Copyright 2022-2024 Matter.js Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import {
+  FLOAT32_MAX,
+  FLOAT32_MIN,
+  INT16_MAX,
+  INT16_MIN,
+  INT32_MAX,
+  INT32_MIN,
+  INT64_MAX,
+  INT64_MIN,
+  INT8_MAX,
+  INT8_MIN,
+  UINT16_MAX,
+  UINT24_MAX,
+  UINT32_MAX,
+  UINT64_MAX,
+  UINT8_MAX,
+  UnexpectedDataError,
+  maxValue,
+  minValue
+} from "#general";
+import { ValidationDatatypeMismatchError, ValidationOutOfBoundsError } from "../common/ValidationError.js";
+import { BitmapSchema } from "../schema/BitmapSchema.js";
+import { TlvCodec, TlvLength, TlvType } from "./TlvCodec.js";
+import { TlvSchema } from "./TlvSchema.js";
+import { TlvWrapper } from "./TlvWrapper.js";
+class TlvNumericSchema extends TlvSchema {
+  constructor(type, lengthProvider, min, max) {
+    super();
+    this.type = type;
+    this.lengthProvider = lengthProvider;
+    this.min = min;
+    this.max = max;
+  }
+  encodeTlvInternal(writer, value, tag) {
+    const typeLength = { type: this.type, length: this.lengthProvider(value) };
+    writer.writeTag(typeLength, tag);
+    writer.writePrimitive(typeLength, value);
+  }
+  decodeTlvInternalValue(reader, typeLength) {
+    if (typeLength.type !== this.type)
+      throw new UnexpectedDataError(`Unexpected type ${typeLength.type}, was expecting ${this.type}.`);
+    return reader.readPrimitive(typeLength);
+  }
+  validate(value) {
+    if (typeof value !== "number" && typeof value !== "bigint")
+      throw new ValidationDatatypeMismatchError(`Expected number, got ${typeof value}.`);
+    this.validateBoundaries(value);
+  }
+  validateBoundaries(value) {
+    if (this.min !== void 0 && value < this.min)
+      throw new ValidationOutOfBoundsError(`Invalid value: ${value} is below the minimum, ${this.min}.`);
+    if (this.max !== void 0 && value > this.max)
+      throw new ValidationOutOfBoundsError(`Invalid value: ${value} is above the maximum, ${this.max}.`);
+  }
+  /** Restrict value range. */
+  bound({ min, max }) {
+    return new TlvNumericSchema(
+      this.type,
+      this.lengthProvider,
+      maxValue(min, this.min),
+      minValue(max, this.max)
+    );
+  }
+}
+class TlvNumberSchema extends TlvNumericSchema {
+  constructor(type, lengthProvider, min, max) {
+    super(type, lengthProvider, min, max);
+  }
+  decodeTlvInternalValue(reader, typeLength) {
+    const value = super.decodeTlvInternalValue(reader, typeLength);
+    return typeof value === "bigint" ? Number(value) : value;
+  }
+  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 ValidationDatatypeMismatchError(`Expected number, got ${typeof value}.`);
+    this.validateBoundaries(value);
+  }
+}
+const TlvLongNumberSchema = TlvNumericSchema;
+const TlvFloat = new TlvNumberSchema(TlvType.Float, (_value) => TlvLength.FourBytes, FLOAT32_MIN, FLOAT32_MAX);
+const TlvDouble = new TlvNumberSchema(TlvType.Float, (_value) => TlvLength.EightBytes);
+const TlvInt8 = new TlvNumberSchema(
+  TlvType.SignedInt,
+  (value) => TlvCodec.getIntTlvLength(value),
+  INT8_MIN,
+  INT8_MAX
+);
+const TlvInt16 = new TlvNumberSchema(
+  TlvType.SignedInt,
+  (value) => TlvCodec.getIntTlvLength(value),
+  INT16_MIN,
+  INT16_MAX
+);
+const TlvInt32 = new TlvNumberSchema(
+  TlvType.SignedInt,
+  (value) => TlvCodec.getIntTlvLength(value),
+  INT32_MIN,
+  INT32_MAX
+);
+const TlvInt64 = new TlvLongNumberSchema(
+  TlvType.SignedInt,
+  (value) => TlvCodec.getIntTlvLength(value),
+  INT64_MIN,
+  INT64_MAX
+);
+const TlvUInt8 = new TlvNumberSchema(
+  TlvType.UnsignedInt,
+  (value) => TlvCodec.getUIntTlvLength(value),
+  0,
+  UINT8_MAX
+);
+const TlvUInt16 = new TlvNumberSchema(
+  TlvType.UnsignedInt,
+  (value) => TlvCodec.getUIntTlvLength(value),
+  0,
+  UINT16_MAX
+);
+const TlvUInt24 = new TlvNumberSchema(
+  TlvType.UnsignedInt,
+  (value) => TlvCodec.getUIntTlvLength(value),
+  0,
+  UINT24_MAX
+);
+const TlvUInt32 = new TlvNumberSchema(
+  TlvType.UnsignedInt,
+  (value) => TlvCodec.getUIntTlvLength(value),
+  0,
+  UINT32_MAX
+);
+const TlvUInt64 = new TlvLongNumberSchema(
+  TlvType.UnsignedInt,
+  (value) => TlvCodec.getUIntTlvLength(value),
+  0,
+  UINT64_MAX
+);
+const TlvEnum = () => TlvUInt32;
+const TlvBitmap = (underlyingSchema, bitSchema) => {
+  const bitmapSchema = BitmapSchema(bitSchema);
+  return new TlvWrapper(
+    underlyingSchema,
+    (bitmapData) => bitmapSchema.encode(bitmapData),
+    (value) => bitmapSchema.decode(value)
+  );
+};
+const TlvPercent = TlvUInt8.bound({ max: 100 });
+const TlvPercent100ths = TlvUInt16.bound({ max: 1e4 });
+const TlvEpochUs = TlvUInt64;
+const TlvEpochS = TlvUInt32;
+const TlvPosixMs = TlvUInt64;
+const TlvSysTimeUs = TlvUInt64;
+const TlvSysTimeMS = TlvUInt64;
+export {
+  TlvBitmap,
+  TlvDouble,
+  TlvEnum,
+  TlvEpochS,
+  TlvEpochUs,
+  TlvFloat,
+  TlvInt16,
+  TlvInt32,
+  TlvInt64,
+  TlvInt8,
+  TlvLongNumberSchema,
+  TlvNumberSchema,
+  TlvNumericSchema,
+  TlvPercent,
+  TlvPercent100ths,
+  TlvPosixMs,
+  TlvSysTimeMS,
+  TlvSysTimeUs,
+  TlvUInt16,
+  TlvUInt24,
+  TlvUInt32,
+  TlvUInt64,
+  TlvUInt8
+};
+//# sourceMappingURL=TlvNumber.js.map

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

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

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

@@ -0,0 +1,103 @@
+/**
+ * @license
+ * Copyright 2022-2024 Matter.js Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { Merge } from "#general";
+import { LengthConstraints } from "./TlvArray.js";
+import { TlvTag, TlvType, TlvTypeLength } from "./TlvCodec.js";
+import { TlvEncodingOptions, TlvReader, TlvSchema, TlvWriter } from "./TlvSchema.js";
+export interface FieldType<T> {
+    id: number;
+    schema: TlvSchema<T>;
+    optional?: boolean;
+    repeated?: boolean;
+    fallback?: T;
+}
+export interface RepeatedFieldType<T> extends FieldType<T> {
+    repeated: true;
+    minLength?: number;
+    maxLength?: number;
+}
+export interface OptionalFieldType<T> extends FieldType<T> {
+    optional: true;
+}
+export interface OptionalRepeatedFieldType<T> extends OptionalFieldType<T> {
+    repeated: true;
+    maxLength?: number;
+}
+export type TlvFields = {
+    [field: string]: FieldType<any>;
+};
+type MandatoryFieldNames<F extends TlvFields> = {
+    [K in keyof F]: F[K] extends OptionalFieldType<any> ? never : K;
+}[keyof F];
+type OptionalFieldNames<F extends TlvFields> = {
+    [K in keyof F]: F[K] extends OptionalFieldType<any> ? K : never;
+}[keyof F];
+type TypeFromField<F extends FieldType<any>> = F extends FieldType<infer T> ? T : never;
+type TypeForMandatoryFields<F extends TlvFields, MF extends keyof F> = {
+    [K in MF]: TypeFromField<F[K]>;
+};
+type TypeForOptionalFields<F extends TlvFields, MF extends keyof F> = {
+    [K in MF]?: TypeFromField<F[K]>;
+};
+export type TypeFromFields<F extends TlvFields> = Merge<TypeForMandatoryFields<F, MandatoryFieldNames<F>>, TypeForOptionalFields<F, OptionalFieldNames<F>>>;
+/**
+ * Schema to encode an object in TLV.
+ *
+ * @see {@link MatterSpecification.v10.Core} § A.5.1 and § A.11.4
+ */
+export declare class ObjectSchema<F extends TlvFields> extends TlvSchema<TypeFromFields<F>> {
+    #private;
+    private readonly fieldDefinitions;
+    private readonly type;
+    private readonly allowProtocolSpecificTags;
+    private readonly fieldById;
+    constructor(fieldDefinitions: F, type?: TlvType.Structure | TlvType.List, allowProtocolSpecificTags?: boolean);
+    encodeTlvInternal(writer: TlvWriter, value: TypeFromFields<F>, tag?: TlvTag, options?: TlvEncodingOptions): void;
+    decodeTlvInternalValue(reader: TlvReader, typeLength: TlvTypeLength): TypeFromFields<F>;
+    validate(value: TypeFromFields<F>): void;
+    injectField(value: TypeFromFields<F>, fieldId: number, fieldValue: any, injectChecker: (fieldValue: any) => boolean): TypeFromFields<F>;
+    removeField(value: TypeFromFields<F>, fieldId: number, removeChecker: (fieldValue: any) => boolean): TypeFromFields<F>;
+}
+/** Object TLV schema. */
+export declare const TlvObject: <F extends TlvFields>(fields: F) => ObjectSchema<F>;
+export declare class ObjectSchemaWithMaxSize<F extends TlvFields> extends ObjectSchema<F> {
+    protected readonly maxSize: number;
+    constructor(fieldDefinitions: F, maxSize: number, type?: TlvType.Structure | TlvType.List, allowProtocolSpecificTags?: boolean);
+    encode(value: TypeFromFields<F>): Uint8Array;
+}
+export declare const TlvObjectWithMaxSize: <F extends TlvFields>(fields: F, maxSize: number) => ObjectSchemaWithMaxSize<F>;
+/**
+ * List TLV schema with all tagged entries.
+ * List entries that can appear multiple times can be defined using TlvRepeatedField/TlvOptionalRepeatedField and are
+ * represented as Arrays.
+ * TODO: We represent Tlv Lists right now as named object properties. This formally does not match the spec, which
+ *      defines a list as a sequence of TLV elements with optional tag where the order matters. That's ok for now
+ *      (also with the help of "Repeated Fields") because it not makes any real difference for now for the current
+ *      existing data structures. We need to change once this changes.
+ */
+export declare const TlvTaggedList: <F extends TlvFields>(fields: F, allowProtocolSpecificTags?: boolean) => ObjectSchema<F>;
+/**
+ * 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 use cases. 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) => FieldType<T>;
+/** Object TLV optional field. */
+export declare const TlvOptionalField: <T>(id: number, schema: TlvSchema<T>) => OptionalFieldType<T>;
+/**
+ * Object TLV mandatory field that can exist repeated in a TLV List structure. The order is preserved on encoding and
+ * decoding.
+ */
+export declare const TlvRepeatedField: <T>(id: number, schema: TlvSchema<T>, lengthOptions?: LengthConstraints) => RepeatedFieldType<T[]>;
+/**
+ * Object TLV optional field that can exist repeated in a TLV List structure. The order is preserved on encoding and
+ * decoding.
+ */
+export declare const TlvOptionalRepeatedField: <T>(id: number, schema: TlvSchema<T>, lengthOptions?: {
+    maxLength: number;
+}) => OptionalRepeatedFieldType<T[]>;
+export {};
+//# sourceMappingURL=TlvObject.d.ts.map

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

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