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

package/dist/esm/codec/BtpCodec.js

@@ -0,0 +1,234 @@
+/**
+ * @license
+ * Copyright 2022-2024 Matter.js Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { Bytes, DataReader, DataWriter, Endian } from "#general";
+import { BleError } from "../ble/Ble.js";
+import { BtpProtocolError } from "../ble/BtpSessionHandler.js";
+var BtpHeaderBits = /* @__PURE__ */ ((BtpHeaderBits2) => {
+  BtpHeaderBits2[BtpHeaderBits2["HandshakeBit"] = 64] = "HandshakeBit";
+  BtpHeaderBits2[BtpHeaderBits2["ManagementMsg"] = 32] = "ManagementMsg";
+  BtpHeaderBits2[BtpHeaderBits2["AckMsg"] = 8] = "AckMsg";
+  BtpHeaderBits2[BtpHeaderBits2["EndSegment"] = 4] = "EndSegment";
+  BtpHeaderBits2[BtpHeaderBits2["ContinuingSegment"] = 2] = "ContinuingSegment";
+  BtpHeaderBits2[BtpHeaderBits2["BeginSegment"] = 1] = "BeginSegment";
+  return BtpHeaderBits2;
+})(BtpHeaderBits || {});
+var BtpOpcode = /* @__PURE__ */ ((BtpOpcode2) => {
+  BtpOpcode2[BtpOpcode2["HandshakeManagementOpcode"] = 108] = "HandshakeManagementOpcode";
+  return BtpOpcode2;
+})(BtpOpcode || {});
+const HANDSHAKE_HEADER = 101;
+class BtpCodec {
+  static decodeBtpHandshakeRequest(data) {
+    const reader = new DataReader(data, Endian.Little);
+    return this.decodeHandshakeRequestPayload(reader);
+  }
+  static decodeBtpPacket(data) {
+    const reader = new DataReader(data, Endian.Little);
+    const header = this.decodeBtpPacketHeader(reader);
+    return {
+      header,
+      payload: this.decodeBtpPacketPayload(reader, header)
+    };
+  }
+  static encodeBtpPacket({ header, payload }) {
+    return Bytes.concat(this.encodeBtpPacketHeader(header), this.encodeBtpPacketPayload(header, payload));
+  }
+  static encodeBtpHandshakeRequest({ versions, attMtu, clientWindowSize }) {
+    const writer = new DataWriter(Endian.Little);
+    writer.writeUInt8(HANDSHAKE_HEADER);
+    writer.writeUInt8(108 /* HandshakeManagementOpcode */);
+    writer.writeUInt8(versions[1] << 4 | versions[0]);
+    writer.writeUInt8(versions[3] << 4 | versions[2]);
+    writer.writeUInt8(versions[5] << 4 | versions[4]);
+    writer.writeUInt8(versions[7] << 4 | versions[6]);
+    writer.writeUInt16(attMtu);
+    writer.writeUInt8(clientWindowSize);
+    return writer.toByteArray();
+  }
+  static encodeBtpHandshakeResponse({ version, attMtu, windowSize }) {
+    const writer = new DataWriter(Endian.Little);
+    writer.writeUInt8(HANDSHAKE_HEADER);
+    writer.writeUInt8(108 /* HandshakeManagementOpcode */);
+    writer.writeUInt8(version & 15);
+    writer.writeUInt16(attMtu);
+    writer.writeUInt8(windowSize);
+    return writer.toByteArray();
+  }
+  static decodeBtpPacketPayload(reader, header) {
+    const { hasAckNumber, isBeginningSegment } = header;
+    const ackNumber = hasAckNumber ? reader.readUInt8() : void 0;
+    const sequenceNumber = reader.readUInt8();
+    const messageLength = isBeginningSegment ? reader.readUInt16() : void 0;
+    const segmentPayload = reader.getRemainingBytes();
+    return { ackNumber, sequenceNumber, messageLength, segmentPayload };
+  }
+  static encodeBtpPacketPayload({ hasAckNumber, isBeginningSegment, isContinuingSegment, isEndingSegment }, { ackNumber, sequenceNumber, messageLength, segmentPayload }) {
+    const writer = new DataWriter(Endian.Little);
+    if (!hasAckNumber && ackNumber !== void 0) {
+      throw new BtpProtocolError("Ack number shouldn't be set because header flag is not set.");
+    }
+    if (hasAckNumber && ackNumber === void 0) {
+      throw new BtpProtocolError("Ack number needs to be set because header flag is set.");
+    }
+    if (isBeginningSegment && isContinuingSegment) {
+      throw new BtpProtocolError("Beginning and continuing segment flags can't be set at the same time.");
+    }
+    if (isEndingSegment && !isContinuingSegment && !isBeginningSegment) {
+      throw new BtpProtocolError("Ending segment flag can't be set without continuing segment flag.");
+    }
+    if ((isBeginningSegment || isContinuingSegment) && (segmentPayload === void 0 || segmentPayload.length === 0)) {
+      throw new BtpProtocolError("Payload needs to be set because header flag indicates a message with payload.");
+    }
+    if (isBeginningSegment && messageLength === void 0) {
+      throw new BtpProtocolError("Message length needs to be set because packet is a beginning segment.");
+    }
+    if (!isBeginningSegment && messageLength !== void 0) {
+      throw new BtpProtocolError(
+        "Message length shouldn't be set because the package is not a beginning segment."
+      );
+    }
+    if (ackNumber !== void 0) {
+      writer.writeUInt8(ackNumber);
+    }
+    writer.writeUInt8(sequenceNumber);
+    if (messageLength !== void 0) {
+      writer.writeUInt16(messageLength);
+    }
+    if (segmentPayload !== void 0) {
+      writer.writeByteArray(segmentPayload);
+    }
+    return writer.toByteArray();
+  }
+  static decodeHandshakeRequestPayload(reader) {
+    const header = reader.readUInt8();
+    const opcode = reader.readUInt8();
+    let version = reader.readUInt8();
+    if (header !== HANDSHAKE_HEADER) {
+      throw new BtpProtocolError("Header for expected BTP Handshake Request is incorrect.");
+    }
+    if (opcode !== 108 /* HandshakeManagementOpcode */) {
+      throw new BtpProtocolError("Management Opcode for BTP Handshake Request is incorrect.");
+    }
+    const ver = [];
+    ver[0] = (version & 240) >> 4;
+    ver[1] = version & 15;
+    version = reader.readUInt8();
+    ver[2] = (version & 240) >> 4;
+    ver[3] = version & 15;
+    version = reader.readUInt8();
+    ver[4] = (version & 240) >> 4;
+    ver[5] = version & 15;
+    version = reader.readUInt8();
+    ver[6] = (version & 240) >> 4;
+    ver[7] = version & 15;
+    const versions = ver.filter((v) => v !== 0);
+    if (versions.length === 0) {
+      throw new BtpProtocolError("No valid version provided.");
+    }
+    const attMtu = reader.readUInt16();
+    const clientWindowSize = reader.readUInt8();
+    return { versions, attMtu, clientWindowSize };
+  }
+  static decodeBtpHandshakeResponsePayload(data) {
+    const reader = new DataReader(data, Endian.Little);
+    const header = reader.readUInt8();
+    if (header !== HANDSHAKE_HEADER) {
+      throw new BtpProtocolError("Header for expected BTP Handshake Request is incorrect.");
+    }
+    const opcode = reader.readUInt8();
+    if (opcode !== 108 /* HandshakeManagementOpcode */) {
+      throw new BtpProtocolError("Management Opcode for BTP Handshake Request is incorrect.");
+    }
+    const version = reader.readUInt8() & 15;
+    const attMtu = reader.readUInt16();
+    const windowSize = reader.readUInt8();
+    return { version, attMtu, windowSize };
+  }
+  static decodeBtpPacketHeader(reader) {
+    const headerBits = reader.readUInt8();
+    const isHandshakeRequest = (headerBits & 64 /* HandshakeBit */) !== 0;
+    const hasManagementOpcode = (headerBits & 32 /* ManagementMsg */) !== 0;
+    const hasAckNumber = (headerBits & 8 /* AckMsg */) !== 0;
+    const isEndingSegment = (headerBits & 4 /* EndSegment */) !== 0;
+    const isContinuingSegment = (headerBits & 2 /* ContinuingSegment */) !== 0;
+    const isBeginningSegment = (headerBits & 1 /* BeginSegment */) !== 0;
+    if (hasManagementOpcode) {
+      throw new BtpProtocolError("Management Opcode for BTPHandshake Request is not expected");
+    }
+    return {
+      isHandshakeRequest,
+      hasManagementOpcode,
+      hasAckNumber,
+      isEndingSegment,
+      isContinuingSegment,
+      isBeginningSegment
+    };
+  }
+  static encodeBtpPacketHeader({
+    isHandshakeRequest,
+    hasManagementOpcode,
+    hasAckNumber,
+    isEndingSegment,
+    isContinuingSegment,
+    isBeginningSegment
+  }) {
+    const writer = new DataWriter(Endian.Little);
+    if (isHandshakeRequest || hasManagementOpcode) {
+      throw new BtpProtocolError("Please use the specific methods to encode a Handshake packet");
+    }
+    const header = (
+      // (isHandshakeRequest ? BtpHeaderBits.HandshakeBit : 0) | ... but always false here
+      // (hasManagementOpcode ? BtpHeaderBits.ManagementMsg : 0) | ... but alw<ys false here
+      (hasAckNumber ? 8 /* AckMsg */ : 0) | (isEndingSegment ? 4 /* EndSegment */ : 0) | (isContinuingSegment ? 2 /* ContinuingSegment */ : 0) | (isBeginningSegment ? 1 /* BeginSegment */ : 0)
+    );
+    writer.writeUInt8(header);
+    return writer.toByteArray();
+  }
+  static encodeBleAdvertisementData(discriminator, vendorId, productId, hasAdditionalAdvertisementData = false) {
+    const writer = new DataWriter(Endian.Little);
+    writer.writeUInt8(2);
+    writer.writeUInt8(1);
+    writer.writeUInt8(6);
+    writer.writeUInt8(11);
+    writer.writeUInt8(22);
+    writer.writeUInt16(65526);
+    writer.writeUInt8(0);
+    writer.writeUInt16(discriminator);
+    writer.writeUInt16(vendorId);
+    writer.writeUInt16(productId);
+    writer.writeUInt8(hasAdditionalAdvertisementData ? 1 : 0);
+    return writer.toByteArray();
+  }
+  static decodeBleAdvertisementData(data) {
+    const reader = new DataReader(data, Endian.Little);
+    if (reader.readUInt8() !== 2 || reader.readUInt8() !== 1 || reader.readUInt8() !== 6 || reader.readUInt8() !== 11 || reader.readUInt8() !== 22) {
+      throw new BleError("Invalid BLE advertisement data");
+    }
+    const serviceUuid = reader.readUInt16();
+    if (serviceUuid !== 65526) {
+      throw new BleError("Invalid BLE advertisement data");
+    }
+    const { discriminator, vendorId, productId, hasAdditionalAdvertisementData } = this.decodeBleAdvertisementServiceData(reader.getRemainingBytes());
+    return { discriminator, vendorId, productId, hasAdditionalAdvertisementData };
+  }
+  static decodeBleAdvertisementServiceData(data) {
+    const reader = new DataReader(data, Endian.Little);
+    if (reader.readUInt8() !== 0) {
+      throw new BleError("Invalid BLE advertisement data");
+    }
+    const discriminator = reader.readUInt16();
+    const vendorId = reader.readUInt16();
+    const productId = reader.readUInt16();
+    const hasAdditionalAdvertisementData = !!reader.readUInt8();
+    return { discriminator, vendorId, productId, hasAdditionalAdvertisementData };
+  }
+}
+export {
+  BtpCodec,
+  BtpHeaderBits,
+  BtpOpcode
+};
+//# sourceMappingURL=BtpCodec.js.map

package/dist/esm/codec/BtpCodec.js.map

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

package/dist/esm/codec/MessageCodec.d.ts

@@ -0,0 +1,63 @@
+/**
+ * @license
+ * Copyright 2022-2024 Matter.js Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { Diagnostic } from "#general";
+import { NodeId } from "#types";
+export interface PacketHeader {
+    sessionId: number;
+    sessionType: SessionType;
+    hasPrivacyEnhancements: boolean;
+    isControlMessage: boolean;
+    hasMessageExtensions: boolean;
+    messageId: number;
+    sourceNodeId?: NodeId;
+    destNodeId?: NodeId;
+    destGroupId?: number;
+}
+export interface DecodedPacketHeader extends PacketHeader {
+    securityFlags: number;
+}
+export interface PayloadHeader {
+    exchangeId: number;
+    protocolId: number;
+    messageType: number;
+    isInitiatorMessage: boolean;
+    requiresAck: boolean;
+    ackedMessageId?: number;
+    hasSecuredExtension: boolean;
+}
+export interface Packet {
+    header: PacketHeader;
+    messageExtension?: Uint8Array;
+    applicationPayload: Uint8Array;
+}
+export interface DecodedPacket extends Packet {
+    header: DecodedPacketHeader;
+}
+export interface Message {
+    packetHeader: PacketHeader;
+    payloadHeader: PayloadHeader;
+    securityExtension?: Uint8Array;
+    payload: Uint8Array;
+}
+export interface DecodedMessage extends Message {
+    packetHeader: DecodedPacketHeader;
+}
+export declare enum SessionType {
+    Group = 1,
+    Unicast = 0
+}
+export declare class MessageCodec {
+    static decodePacket(data: Uint8Array): DecodedPacket;
+    static decodePayload({ header, applicationPayload }: DecodedPacket): DecodedMessage;
+    static encodePayload({ packetHeader, payloadHeader, payload, securityExtension }: Message): Packet;
+    static encodePacket({ header, applicationPayload, messageExtension }: Packet): Uint8Array;
+    private static decodePacketHeader;
+    private static decodePayloadHeader;
+    static encodePacketHeader({ messageId: messageCounter, sessionId, destGroupId, destNodeId, sourceNodeId, sessionType, }: PacketHeader): Uint8Array;
+    static messageDiagnostics({ packetHeader: { messageId, sessionId }, payloadHeader: { exchangeId, messageType, protocolId, ackedMessageId, requiresAck }, payload, }: Message, isDuplicate?: boolean): Record<string, unknown> & Diagnostic;
+    private static encodePayloadHeader;
+}
+//# sourceMappingURL=MessageCodec.d.ts.map

package/dist/esm/codec/MessageCodec.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"MessageCodec.d.ts","sourceRoot":"","sources":["../../../src/codec/MessageCodec.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAiC,UAAU,EAAoD,MAAM,UAAU,CAAC;AACvH,OAAO,EAAW,MAAM,EAAE,MAAM,QAAQ,CAAC;AAEzC,MAAM,WAAW,YAAY;IACzB,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,WAAW,CAAC;IACzB,sBAAsB,EAAE,OAAO,CAAC;IAChC,gBAAgB,EAAE,OAAO,CAAC;IAC1B,oBAAoB,EAAE,OAAO,CAAC;IAC9B,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,WAAW,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,mBAAoB,SAAQ,YAAY;IACrD,aAAa,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,WAAW,aAAa;IAC1B,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,kBAAkB,EAAE,OAAO,CAAC;IAC5B,WAAW,EAAE,OAAO,CAAC;IACrB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,mBAAmB,EAAE,OAAO,CAAC;CAChC;AAED,MAAM,WAAW,MAAM;IACnB,MAAM,EAAE,YAAY,CAAC;IACrB,gBAAgB,CAAC,EAAE,UAAU,CAAC;IAC9B,kBAAkB,EAAE,UAAU,CAAC;CAClC;AAED,MAAM,WAAW,aAAc,SAAQ,MAAM;IACzC,MAAM,EAAE,mBAAmB,CAAC;CAC/B;AACD,MAAM,WAAW,OAAO;IACpB,YAAY,EAAE,YAAY,CAAC;IAC3B,aAAa,EAAE,aAAa,CAAC;IAC7B,iBAAiB,CAAC,EAAE,UAAU,CAAC;IAC/B,OAAO,EAAE,UAAU,CAAC;CACvB;AAED,MAAM,WAAW,cAAe,SAAQ,OAAO;IAC3C,YAAY,EAAE,mBAAmB,CAAC;CACrC;AAID,oBAAY,WAAW;IACnB,KAAK,IAAI;IACT,OAAO,IAAI;CACd;AA0BD,qBAAa,YAAY;IACrB,MAAM,CAAC,YAAY,CAAC,IAAI,EAAE,UAAU,GAAG,aAAa;IAkBpD,MAAM,CAAC,aAAa,CAAC,EAAE,MAAM,EAAE,kBAAkB,EAAE,EAAE,aAAa,GAAG,cAAc;IAgBnF,MAAM,CAAC,aAAa,CAAC,EAAE,YAAY,EAAE,aAAa,EAAE,OAAO,EAAE,iBAAiB,EAAE,EAAE,OAAO,GAAG,MAAM;IAWlG,MAAM,CAAC,YAAY,CAAC,EAAE,MAAM,EAAE,kBAAkB,EAAE,gBAAgB,EAAE,EAAE,MAAM,GAAG,UAAU;IAOzF,OAAO,CAAC,MAAM,CAAC,kBAAkB;IA4CjC,OAAO,CAAC,MAAM,CAAC,mBAAmB;IAyBlC,MAAM,CAAC,kBAAkB,CAAC,EACtB,SAAS,EAAE,cAAc,EACzB,SAAS,EACT,WAAW,EACX,UAAU,EACV,YAAY,EACZ,WAAW,GACd,EAAE,YAAY;IAmBf,MAAM,CAAC,kBAAkB,CACrB,EACI,YAAY,EAAE,EAAE,SAAS,EAAE,SAAS,EAAE,EACtC,aAAa,EAAE,EAAE,UAAU,EAAE,WAAW,EAAE,UAAU,EAAE,cAAc,EAAE,WAAW,EAAE,EACnF,OAAO,GACV,EAAE,OAAO,EACV,WAAW,UAAQ;IAYvB,OAAO,CAAC,MAAM,CAAC,mBAAmB;CAuBrC"}

package/dist/esm/codec/MessageCodec.js

@@ -0,0 +1,200 @@
+/**
+ * @license
+ * Copyright 2022-2024 Matter.js Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { Bytes, DataReader, DataWriter, Diagnostic, Endian, NotImplementedError, UnexpectedDataError } from "#general";
+import { GroupId, NodeId } from "#types";
+const HEADER_VERSION = 0;
+var SessionType = /* @__PURE__ */ ((SessionType2) => {
+  SessionType2[SessionType2["Group"] = 1] = "Group";
+  SessionType2[SessionType2["Unicast"] = 0] = "Unicast";
+  return SessionType2;
+})(SessionType || {});
+const COMMON_VENDOR_ID = 0;
+var PacketHeaderFlag = /* @__PURE__ */ ((PacketHeaderFlag2) => {
+  PacketHeaderFlag2[PacketHeaderFlag2["HasDestNodeId"] = 1] = "HasDestNodeId";
+  PacketHeaderFlag2[PacketHeaderFlag2["HasDestGroupId"] = 2] = "HasDestGroupId";
+  PacketHeaderFlag2[PacketHeaderFlag2["HasSourceNodeId"] = 4] = "HasSourceNodeId";
+  PacketHeaderFlag2[PacketHeaderFlag2["Reserved"] = 8] = "Reserved";
+  PacketHeaderFlag2[PacketHeaderFlag2["VersionMask"] = 240] = "VersionMask";
+  return PacketHeaderFlag2;
+})(PacketHeaderFlag || {});
+var PayloadHeaderFlag = /* @__PURE__ */ ((PayloadHeaderFlag2) => {
+  PayloadHeaderFlag2[PayloadHeaderFlag2["IsInitiatorMessage"] = 1] = "IsInitiatorMessage";
+  PayloadHeaderFlag2[PayloadHeaderFlag2["IsAckMessage"] = 2] = "IsAckMessage";
+  PayloadHeaderFlag2[PayloadHeaderFlag2["RequiresAck"] = 4] = "RequiresAck";
+  PayloadHeaderFlag2[PayloadHeaderFlag2["HasSecureExtension"] = 8] = "HasSecureExtension";
+  PayloadHeaderFlag2[PayloadHeaderFlag2["HasVendorId"] = 16] = "HasVendorId";
+  return PayloadHeaderFlag2;
+})(PayloadHeaderFlag || {});
+var SecurityFlag = /* @__PURE__ */ ((SecurityFlag2) => {
+  SecurityFlag2[SecurityFlag2["HasPrivacyEnhancements"] = 128] = "HasPrivacyEnhancements";
+  SecurityFlag2[SecurityFlag2["IsControlMessage"] = 64] = "IsControlMessage";
+  SecurityFlag2[SecurityFlag2["HasMessageExtension"] = 32] = "HasMessageExtension";
+  return SecurityFlag2;
+})(SecurityFlag || {});
+class MessageCodec {
+  static decodePacket(data) {
+    const reader = new DataReader(data, Endian.Little);
+    const header = this.decodePacketHeader(reader);
+    let messageExtension = void 0;
+    if (header.hasMessageExtensions) {
+      const extensionLength = reader.readUInt16();
+      messageExtension = reader.readByteArray(extensionLength);
+    }
+    const applicationPayload = reader.getRemainingBytes();
+    return {
+      header,
+      messageExtension,
+      applicationPayload
+    };
+  }
+  static decodePayload({ header, applicationPayload }) {
+    const reader = new DataReader(applicationPayload, Endian.Little);
+    const payloadHeader = this.decodePayloadHeader(reader);
+    let securityExtension = void 0;
+    if (payloadHeader.hasSecuredExtension) {
+      const extensionLength = reader.readUInt16();
+      securityExtension = reader.readByteArray(extensionLength);
+    }
+    return {
+      packetHeader: header,
+      payloadHeader,
+      securityExtension,
+      payload: reader.getRemainingBytes()
+    };
+  }
+  static encodePayload({ packetHeader, payloadHeader, payload, securityExtension }) {
+    if (securityExtension !== void 0 || payloadHeader.hasSecuredExtension) {
+      throw new NotImplementedError(`Security extensions not supported when encoding a payload.`);
+    }
+    return {
+      header: packetHeader,
+      applicationPayload: Bytes.concat(this.encodePayloadHeader(payloadHeader), payload)
+    };
+  }
+  static encodePacket({ header, applicationPayload, messageExtension }) {
+    if (messageExtension !== void 0 || header.hasMessageExtensions) {
+      throw new NotImplementedError(`Message extensions not supported when encoding a packet.`);
+    }
+    return Bytes.concat(this.encodePacketHeader(header), applicationPayload);
+  }
+  static decodePacketHeader(reader) {
+    const flags = reader.readUInt8();
+    const version = (flags & 240 /* VersionMask */) >> 4;
+    const hasDestNodeId = (flags & 1 /* HasDestNodeId */) !== 0;
+    const hasDestGroupId = (flags & 2 /* HasDestGroupId */) !== 0;
+    const hasSourceNodeId = (flags & 4 /* HasSourceNodeId */) !== 0;
+    if (hasDestNodeId && hasDestGroupId)
+      throw new UnexpectedDataError(
+        "The header cannot contain destination group and node at the same time. Reserved for future use. Discard message."
+      );
+    if (version !== HEADER_VERSION) throw new NotImplementedError(`Unsupported header version ${version}.`);
+    const sessionId = reader.readUInt16();
+    const securityFlags = reader.readUInt8();
+    const messageId = reader.readUInt32();
+    const sourceNodeId = hasSourceNodeId ? NodeId(reader.readUInt64()) : void 0;
+    const destNodeId = hasDestNodeId ? NodeId(reader.readUInt64()) : void 0;
+    const destGroupId = hasDestGroupId ? GroupId(reader.readUInt16()) : void 0;
+    const sessionType = securityFlags & 3;
+    if (sessionType !== 1 /* Group */ && sessionType !== 0 /* Unicast */)
+      throw new UnexpectedDataError(`Unsupported session type ${sessionType}`);
+    const hasPrivacyEnhancements = (securityFlags & 128 /* HasPrivacyEnhancements */) !== 0;
+    if (hasPrivacyEnhancements) throw new NotImplementedError(`Privacy enhancements not supported`);
+    const isControlMessage = (securityFlags & 64 /* IsControlMessage */) !== 0;
+    if (isControlMessage) throw new NotImplementedError(`Control Messages not supported`);
+    const hasMessageExtensions = (securityFlags & 32 /* HasMessageExtension */) !== 0;
+    return {
+      securityFlags,
+      sessionId,
+      sourceNodeId,
+      messageId,
+      destGroupId,
+      destNodeId,
+      sessionType,
+      hasPrivacyEnhancements,
+      isControlMessage,
+      hasMessageExtensions
+    };
+  }
+  static decodePayloadHeader(reader) {
+    const exchangeFlags = reader.readUInt8();
+    const isInitiatorMessage = (exchangeFlags & 1 /* IsInitiatorMessage */) !== 0;
+    const isAckMessage = (exchangeFlags & 2 /* IsAckMessage */) !== 0;
+    const requiresAck = (exchangeFlags & 4 /* RequiresAck */) !== 0;
+    const hasSecuredExtension = (exchangeFlags & 8 /* HasSecureExtension */) !== 0;
+    const hasVendorId = (exchangeFlags & 16 /* HasVendorId */) !== 0;
+    const messageType = reader.readUInt8();
+    const exchangeId = reader.readUInt16();
+    const vendorId = hasVendorId ? reader.readUInt16() : COMMON_VENDOR_ID;
+    const protocolId = vendorId << 16 | reader.readUInt16();
+    const ackedMessageId = isAckMessage ? reader.readUInt32() : void 0;
+    return {
+      protocolId,
+      exchangeId,
+      messageType,
+      isInitiatorMessage,
+      requiresAck,
+      ackedMessageId,
+      hasSecuredExtension
+    };
+  }
+  static encodePacketHeader({
+    messageId: messageCounter,
+    sessionId,
+    destGroupId,
+    destNodeId,
+    sourceNodeId,
+    sessionType
+  }) {
+    const writer = new DataWriter(Endian.Little);
+    const flags = HEADER_VERSION << 4 | (destGroupId !== void 0 ? 2 /* HasDestGroupId */ : 0) | (destNodeId !== void 0 ? 1 /* HasDestNodeId */ : 0) | (sourceNodeId !== void 0 ? 4 /* HasSourceNodeId */ : 0);
+    const securityFlags = sessionType;
+    writer.writeUInt8(flags);
+    writer.writeUInt16(sessionId);
+    writer.writeUInt8(securityFlags);
+    writer.writeUInt32(messageCounter);
+    if (sourceNodeId !== void 0) writer.writeUInt64(sourceNodeId);
+    if (destNodeId !== void 0) writer.writeUInt64(destNodeId);
+    if (destGroupId !== void 0) writer.writeUInt32(destGroupId);
+    return writer.toByteArray();
+  }
+  static messageDiagnostics({
+    packetHeader: { messageId, sessionId },
+    payloadHeader: { exchangeId, messageType, protocolId, ackedMessageId, requiresAck },
+    payload
+  }, isDuplicate = false) {
+    return Diagnostic.dict({
+      id: `${sessionId}/${exchangeId}/${messageId}`,
+      type: `${protocolId}/${messageType}`,
+      acked: ackedMessageId,
+      reqAck: requiresAck,
+      duplicate: isDuplicate,
+      payload
+    });
+  }
+  static encodePayloadHeader({
+    exchangeId,
+    isInitiatorMessage,
+    messageType,
+    protocolId,
+    requiresAck,
+    ackedMessageId: ackedMessageCounter
+  }) {
+    const writer = new DataWriter(Endian.Little);
+    const vendorId = (protocolId & 4294901760) >> 16;
+    const flags = (isInitiatorMessage ? 1 /* IsInitiatorMessage */ : 0) | (ackedMessageCounter !== void 0 ? 2 /* IsAckMessage */ : 0) | (requiresAck ? 4 /* RequiresAck */ : 0) | (vendorId !== COMMON_VENDOR_ID ? 16 /* HasVendorId */ : 0);
+    writer.writeUInt8(flags);
+    writer.writeUInt8(messageType);
+    writer.writeUInt16(exchangeId);
+    vendorId !== COMMON_VENDOR_ID ? writer.writeUInt32(protocolId) : writer.writeUInt16(protocolId);
+    if (ackedMessageCounter !== void 0) writer.writeUInt32(ackedMessageCounter);
+    return writer.toByteArray();
+  }
+}
+export {
+  MessageCodec,
+  SessionType
+};
+//# sourceMappingURL=MessageCodec.js.map

package/dist/esm/codec/MessageCodec.js.map

@@ -0,0 +1,6 @@
+{
+  "version": 3,
+  "sources": ["../../../src/codec/MessageCodec.ts"],
+  "mappings": "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",
+  "names": ["SessionType", "PacketHeaderFlag", "PayloadHeaderFlag", "SecurityFlag"]
+}

package/dist/esm/codec/index.d.ts

@@ -0,0 +1,9 @@
+/**
+ * @license
+ * Copyright 2022-2024 Matter.js Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+export { Base64, DerCodec, DerKey, DnsCodec, type DerNode } from "#general";
+export * from "./BtpCodec.js";
+export * from "./MessageCodec.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/esm/codec/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/codec/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,KAAK,OAAO,EAAE,MAAM,UAAU,CAAC;AAC5E,cAAc,eAAe,CAAC;AAC9B,cAAc,mBAAmB,CAAC"}

package/dist/esm/codec/index.js

@@ -0,0 +1,15 @@
+/**
+ * @license
+ * Copyright 2022-2024 Matter.js Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { Base64, DerCodec, DerKey, DnsCodec } from "#general";
+export * from "./BtpCodec.js";
+export * from "./MessageCodec.js";
+export {
+  Base64,
+  DerCodec,
+  DerKey,
+  DnsCodec
+};
+//# sourceMappingURL=index.js.map

package/dist/esm/codec/index.js.map

@@ -0,0 +1,6 @@
+{
+  "version": 3,
+  "sources": ["../../../src/codec/index.ts"],
+  "mappings": "AAAA;AAAA;AAAA;AAAA;AAAA;AAMA,SAAS,QAAQ,UAAU,QAAQ,gBAA8B;AACjE,cAAc;AACd,cAAc;",
+  "names": []
+}

package/dist/esm/common/FailsafeContext.d.ts

@@ -0,0 +1,79 @@
+/**
+ * @license
+ * Copyright 2022-2024 Matter.js Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { AsyncObservable, Construction, MatterFlowError } from "#general";
+import { NodeId, VendorId } from "#types";
+import { Fabric } from "../fabric/Fabric.js";
+import { FabricManager } from "../fabric/FabricManager.js";
+import { SessionManager } from "../session/SessionManager.js";
+import { FailsafeTimer } from "./FailsafeTimer.js";
+export declare class MatterFabricInvalidAdminSubjectError extends MatterFlowError {
+}
+/**
+ * A "timed operation" is a command or sequence of commands that operate with a failsafe timer that will abort the
+ * operation if it does not complete within a specific window.
+ *
+ * FailsafeContext maintains the failsafe timer and tracks information required to rollback state if the operation
+ * aborts.
+ *
+ * Timed operations are exclusive for a node.
+ */
+export declare abstract class FailsafeContext {
+    #private;
+    constructor(options: FailsafeContext.Options);
+    extend(fabric: Fabric | undefined, expiryLengthSeconds: number): Promise<void>;
+    get fabricIndex(): import("#types").FabricIndex | undefined;
+    get construction(): Construction<FailsafeContext>;
+    get commissioned(): AsyncObservable<[], void>;
+    get associatedFabric(): Fabric | undefined;
+    get csrSessionId(): number | undefined;
+    get forUpdateNoc(): boolean | undefined;
+    get hasRootCert(): boolean;
+    get rootCert(): Uint8Array | undefined;
+    completeCommission(): Promise<void>;
+    getFailSafeContext(): FailsafeTimer;
+    getNextFabricIndex(): import("#types").FabricIndex;
+    addFabric(fabric: Fabric): Promise<import("#types").FabricIndex>;
+    updateFabric(fabric: Fabric): Promise<void>;
+    /**
+     * Handles a CSR from OperationalCredentials cluster and stores additional internal information for further
+     * validity checks.
+     */
+    createCertificateSigningRequest(isForUpdateNoc: boolean, sessionId: number): Uint8Array;
+    removePaseSession(): Promise<void>;
+    close(): Promise<void>;
+    /** Handles adding a trusted root certificate from Operational Credentials cluster. */
+    setRootCert(rootCert: Uint8Array): void;
+    /**
+     * Build a new Fabric object based on an existing fabric for the "UpdateNoc" case of the Operational Credentials
+     * cluster.
+     */
+    buildUpdatedFabric(nocValue: Uint8Array, icacValue: Uint8Array | undefined): Promise<Fabric>;
+    /** Build a new Fabric object for a new fabric for the "AddNoc" case of the Operational Credentials cluster. */
+    buildFabric(nocData: {
+        nocValue: Uint8Array;
+        icacValue: Uint8Array | undefined;
+        adminVendorId: VendorId;
+        ipkValue: Uint8Array;
+        caseAdminSubject: NodeId;
+    }): Promise<Fabric>;
+    protected rollback(): Promise<void>;
+    abstract storeEndpointState(): Promise<void>;
+    /** Restore Cluster data when the FailSafe context expired. */
+    abstract restoreNetworkState(): Promise<void>;
+    restoreFabric(fabric: Fabric): Promise<void>;
+    abstract revokeFabric(fabric: Fabric): Promise<void>;
+    abstract restoreBreadcrumb(): Promise<void>;
+}
+export declare namespace FailsafeContext {
+    interface Options {
+        sessions: SessionManager;
+        fabrics: FabricManager;
+        expiryLengthSeconds: number;
+        maxCumulativeFailsafeSeconds: number;
+        associatedFabric: Fabric | undefined;
+    }
+}
+//# sourceMappingURL=FailsafeContext.d.ts.map

package/dist/esm/common/FailsafeContext.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"FailsafeContext.d.ts","sourceRoot":"","sources":["../../../src/common/FailsafeContext.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,eAAe,EAAE,YAAY,EAAU,eAAe,EAAuB,MAAM,UAAU,CAAC;AACvG,OAAO,EAAwB,MAAM,EAAmB,QAAQ,EAAE,MAAM,QAAQ,CAAC;AACjF,OAAO,EAAE,MAAM,EAAiB,MAAM,qBAAqB,CAAC;AAC5D,OAAO,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAC;AAC3D,OAAO,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC;AAC9D,OAAO,EAAE,aAAa,EAA6B,MAAM,oBAAoB,CAAC;AAI9E,qBAAa,oCAAqC,SAAQ,eAAe;CAAG;AAE5E;;;;;;;;GAQG;AACH,8BAAsB,eAAe;;gBAYrB,OAAO,EAAE,eAAe,CAAC,OAAO;IAyBtC,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,EAAE,mBAAmB,EAAE,MAAM;IAQpE,IAAI,WAAW,6CAEd;IAED,IAAI,YAAY,kCAEf;IAED,IAAI,YAAY,8BAEf;IAED,IAAI,gBAAgB,uBAEnB;IAED,IAAI,YAAY,uBAEf;IAED,IAAI,YAAY,wBAEf;IAED,IAAI,WAAW,YAEd;IAED,IAAI,QAAQ,2BAEX;IAEK,kBAAkB;IAwBxB,kBAAkB;IAKlB,kBAAkB;IAIZ,SAAS,CAAC,MAAM,EAAE,MAAM;IAQxB,YAAY,CAAC,MAAM,EAAE,MAAM;IAKjC;;;OAGG;IACH,+BAA+B,CAAC,cAAc,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM;IAWpE,iBAAiB;IAOjB,KAAK;IAWX,sFAAsF;IACtF,WAAW,CAAC,QAAQ,EAAE,UAAU;IAIhC;;;OAGG;IACG,kBAAkB,CAAC,QAAQ,EAAE,UAAU,EAAE,SAAS,EAAE,UAAU,GAAG,SAAS;IAShF,+GAA+G;IACzG,WAAW,CAAC,OAAO,EAAE;QACvB,QAAQ,EAAE,UAAU,CAAC;QACrB,SAAS,EAAE,UAAU,GAAG,SAAS,CAAC;QAClC,aAAa,EAAE,QAAQ,CAAC;QACxB,QAAQ,EAAE,UAAU,CAAC;QACrB,gBAAgB,EAAE,MAAM,CAAC;KAC5B;cA2Ce,QAAQ;IAyDxB,QAAQ,CAAC,kBAAkB,IAAI,OAAO,CAAC,IAAI,CAAC;IAE5C,8DAA8D;IAC9D,QAAQ,CAAC,mBAAmB,IAAI,OAAO,CAAC,IAAI,CAAC;IAEvC,aAAa,CAAC,MAAM,EAAE,MAAM;IAIlC,QAAQ,CAAC,YAAY,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAEpD,QAAQ,CAAC,iBAAiB,IAAI,OAAO,CAAC,IAAI,CAAC;CAC9C;AAED,yBAAiB,eAAe,CAAC;IAC7B,UAAiB,OAAO;QACpB,QAAQ,EAAE,cAAc,CAAC;QACzB,OAAO,EAAE,aAAa,CAAC;QACvB,mBAAmB,EAAE,MAAM,CAAC;QAC5B,4BAA4B,EAAE,MAAM,CAAC;QACrC,gBAAgB,EAAE,MAAM,GAAG,SAAS,CAAC;KACxC;CACJ"}