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

package/dist/cjs/protocol/MessageReceptionState.d.ts

@@ -0,0 +1,65 @@
+/**
+ * @license
+ * Copyright 2022-2024 Matter.js Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { MatterError } from "#general";
+export declare class DuplicateMessageError extends MatterError {
+}
+export declare abstract class MessageReceptionState {
+    abstract updateMessageCounter(messageCounter: number): void;
+}
+/**
+ * Implements a message reception state for encrypted messages without rollover.
+ * A counter in the range [(max_message_counter + 1) to (232 - 1)] SHALL be considered new, and cause the
+ * max_message_counter value to be updated.
+ * Message counters within the range of the bitmap SHALL be considered duplicate if the corresponding bit
+ * offset is set to true. All other message counters SHALL be considered duplicate.
+ */
+export declare class MessageReceptionStateEncryptedWithoutRollover extends MessageReceptionState {
+    protected maximumMessageCounter: number | undefined;
+    private messageCounterBitmap;
+    constructor(messageCounter?: number);
+    /** Initialize the message counter state. */
+    private initialize;
+    /**
+     * Calculate plain diff without rollover.
+     * This method is mainly overridden for other counter types and follow the following semantic
+     * Return number is:
+     * * negative if the new message counter is smaller than the current maximum. Smaller values within the Window size
+     *   are check separately within the window. Other smaller values are considered DUPLICATE
+     * * positive if the new message counter is larger than the current maximum and are always NEW
+     */
+    protected calculateDiff(messageCounter: number): number;
+    /** Update or move the message counter window. */
+    private calculateMessageCounterBitmap;
+    /** Update the message counter and window. */
+    private updateMessageCounterAndBitmap;
+    /** Check if the message counter is known in the bitmap. */
+    private isCounterKnownInBitmap;
+    /**
+     * Returns true if the message counter is a duplicate.
+     */
+    updateMessageCounter(messageCounter: number): void;
+}
+/**
+ * Implements a message reception state for encrypted messages with rollover.
+ * A message counter with rollover is a free running message counter that monotonically increases, but rolls
+ * over to zero when it exceeds the maximum value of the counter (32-bits). If the difference is below 2^31 then it is
+ * considered a rollover and not a smaller value
+ */
+export declare class MessageReceptionStateEncryptedWithRollover extends MessageReceptionStateEncryptedWithoutRollover {
+    protected calculateDiff(messageCounter: number): number;
+}
+/**
+ * Implements a message reception state for unencrypted messages without rollover.
+ * Any message counter equal to max_message_counter or within the message counter window, where the corresponding bit
+ * is set to true SHALL be considered duplicate. All other message counters, whether behind the window or ahead of
+ * max_message_counter, are considered new and SHALL update max_message_counter and shift the window accordingly.
+ * Messages with a counter behind the window are likely caused by a node rebooting and are thus processed as rolling
+ * back the window to the current location.
+ */
+export declare class MessageReceptionStateUnencryptedWithRollover extends MessageReceptionStateEncryptedWithoutRollover {
+    protected calculateDiff(messageCounter: number): number;
+}
+//# sourceMappingURL=MessageReceptionState.d.ts.map

package/dist/cjs/protocol/MessageReceptionState.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"MessageReceptionState.d.ts","sourceRoot":"","sources":["../../../src/protocol/MessageReceptionState.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAiB,WAAW,EAAE,MAAM,UAAU,CAAC;AAStD,qBAAa,qBAAsB,SAAQ,WAAW;CAAG;AAEzD,8BAAsB,qBAAqB;IACvC,QAAQ,CAAC,oBAAoB,CAAC,cAAc,EAAE,MAAM,GAAG,IAAI;CAC9D;AAED;;;;;;GAMG;AACH,qBAAa,6CAA8C,SAAQ,qBAAqB;IACpF,SAAS,CAAC,qBAAqB,EAAE,MAAM,GAAG,SAAS,CAAC;IACpD,OAAO,CAAC,oBAAoB,CAAc;gBAE9B,cAAc,CAAC,EAAE,MAAM;IAOnC,4CAA4C;IAC5C,OAAO,CAAC,UAAU;IAKlB;;;;;;;OAOG;IACH,SAAS,CAAC,aAAa,CAAC,cAAc,EAAE,MAAM;IAO9C,iDAAiD;IACjD,OAAO,CAAC,6BAA6B;IAuBrC,6CAA6C;IAC7C,OAAO,CAAC,6BAA6B;IAarC,2DAA2D;IAC3D,OAAO,CAAC,sBAAsB;IAQ9B;;OAEG;IACH,oBAAoB,CAAC,cAAc,EAAE,MAAM;CA2B9C;AAED;;;;;GAKG;AACH,qBAAa,0CAA2C,SAAQ,6CAA6C;cACtF,aAAa,CAAC,cAAc,EAAE,MAAM;CAuB1D;AAED;;;;;;;GAOG;AACH,qBAAa,4CAA6C,SAAQ,6CAA6C;cACxF,aAAa,CAAC,cAAc,EAAE,MAAM;CA0B1D"}

package/dist/cjs/protocol/MessageReceptionState.js

@@ -0,0 +1,173 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var MessageReceptionState_exports = {};
+__export(MessageReceptionState_exports, {
+  DuplicateMessageError: () => DuplicateMessageError,
+  MessageReceptionState: () => MessageReceptionState,
+  MessageReceptionStateEncryptedWithRollover: () => MessageReceptionStateEncryptedWithRollover,
+  MessageReceptionStateEncryptedWithoutRollover: () => MessageReceptionStateEncryptedWithoutRollover,
+  MessageReceptionStateUnencryptedWithRollover: () => MessageReceptionStateUnencryptedWithRollover
+});
+module.exports = __toCommonJS(MessageReceptionState_exports);
+var import_general = require("#general");
+var import_MessageCounter = require("./MessageCounter.js");
+/**
+ * @license
+ * Copyright 2022-2024 Matter.js Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+const MAX_COUNTER_INCREASE_2POW31 = Math.pow(2, 31);
+const MSG_COUNTER_WINDOW_SIZE = 32;
+class DuplicateMessageError extends import_general.MatterError {
+}
+class MessageReceptionState {
+}
+class MessageReceptionStateEncryptedWithoutRollover extends MessageReceptionState {
+  maximumMessageCounter;
+  messageCounterBitmap = 4294967295;
+  // All bits set to 1
+  constructor(messageCounter) {
+    super();
+    if (messageCounter !== void 0) {
+      this.initialize(messageCounter);
+    }
+  }
+  /** Initialize the message counter state. */
+  initialize(messageCounter) {
+    this.maximumMessageCounter = messageCounter;
+    this.messageCounterBitmap = 4294967295;
+  }
+  /**
+   * Calculate plain diff without rollover.
+   * This method is mainly overridden for other counter types and follow the following semantic
+   * Return number is:
+   * * negative if the new message counter is smaller than the current maximum. Smaller values within the Window size
+   *   are check separately within the window. Other smaller values are considered DUPLICATE
+   * * positive if the new message counter is larger than the current maximum and are always NEW
+   */
+  calculateDiff(messageCounter) {
+    if (this.maximumMessageCounter === void 0) {
+      return 0;
+    }
+    return messageCounter - this.maximumMessageCounter;
+  }
+  /** Update or move the message counter window. */
+  calculateMessageCounterBitmap(messageCounterBitmap, diff) {
+    if (diff < 0) {
+      if (diff < -MSG_COUNTER_WINDOW_SIZE) {
+        throw new import_general.InternalError(`Message counter difference too large: ${diff}`);
+      }
+      const bit = 1 << -diff - 1;
+      messageCounterBitmap |= bit;
+    } else if (diff > 0) {
+      if (diff <= MSG_COUNTER_WINDOW_SIZE) {
+        const bit = 1 << diff - 1;
+        messageCounterBitmap = messageCounterBitmap << diff >>> 0 | bit;
+      } else {
+        messageCounterBitmap = 0;
+      }
+    }
+    return messageCounterBitmap >>> 0;
+  }
+  /** Update the message counter and window. */
+  updateMessageCounterAndBitmap(messageCounter, diff) {
+    if (this.maximumMessageCounter === void 0) {
+      this.initialize(messageCounter);
+      return;
+    }
+    this.messageCounterBitmap = this.calculateMessageCounterBitmap(this.messageCounterBitmap, diff);
+    if (diff > 0 || diff < -MSG_COUNTER_WINDOW_SIZE) {
+      this.maximumMessageCounter = messageCounter;
+    }
+  }
+  /** Check if the message counter is known in the bitmap. */
+  isCounterKnownInBitmap(diff) {
+    if (diff < -MSG_COUNTER_WINDOW_SIZE || diff >= 0) {
+      throw new import_general.InternalError(`Invalid Message counter difference for check: ${diff}`);
+    }
+    const bit = 1 << -diff - 1;
+    return (this.messageCounterBitmap & bit) !== 0;
+  }
+  /**
+   * Returns true if the message counter is a duplicate.
+   */
+  updateMessageCounter(messageCounter) {
+    if (messageCounter < 0 || messageCounter > import_MessageCounter.MAX_COUNTER_VALUE_32BIT) {
+      throw new import_general.InternalError(`Invalid message counter value: ${messageCounter}`);
+    }
+    if (this.maximumMessageCounter === void 0) {
+      this.updateMessageCounterAndBitmap(messageCounter, 0);
+      return;
+    }
+    if (messageCounter === this.maximumMessageCounter) {
+      throw new DuplicateMessageError("Message counter equals the maximum message counter.");
+    }
+    const diff = this.calculateDiff(messageCounter);
+    if (diff < 0) {
+      if (diff < -MSG_COUNTER_WINDOW_SIZE) {
+        throw new DuplicateMessageError("Message counter is considered duplicate.");
+      }
+      if (this.isCounterKnownInBitmap(diff)) {
+        throw new DuplicateMessageError("Message counter is within the message counter window and duplicate.");
+      }
+    }
+    this.updateMessageCounterAndBitmap(messageCounter, diff);
+  }
+}
+class MessageReceptionStateEncryptedWithRollover extends MessageReceptionStateEncryptedWithoutRollover {
+  calculateDiff(messageCounter) {
+    if (this.maximumMessageCounter === void 0) {
+      return 0;
+    }
+    const diff = messageCounter - this.maximumMessageCounter;
+    if (diff > 0) {
+      if (diff < MAX_COUNTER_INCREASE_2POW31) {
+        return diff;
+      }
+      return diff - import_MessageCounter.MAX_COUNTER_VALUE_32BIT - 1;
+    } else if (diff < 0) {
+      if (diff >= -MAX_COUNTER_INCREASE_2POW31) {
+        return diff;
+      }
+      return diff + import_MessageCounter.MAX_COUNTER_VALUE_32BIT + 1;
+    }
+    return 0;
+  }
+}
+class MessageReceptionStateUnencryptedWithRollover extends MessageReceptionStateEncryptedWithoutRollover {
+  calculateDiff(messageCounter) {
+    if (this.maximumMessageCounter === void 0) {
+      return 0;
+    }
+    const diff = messageCounter - this.maximumMessageCounter;
+    if (diff > 0) {
+      if (-diff + import_MessageCounter.MAX_COUNTER_VALUE_32BIT < MSG_COUNTER_WINDOW_SIZE) {
+        return diff - import_MessageCounter.MAX_COUNTER_VALUE_32BIT - 1;
+      }
+      return diff;
+    } else if (diff < 0) {
+      if (diff < -MSG_COUNTER_WINDOW_SIZE) {
+        return import_MessageCounter.MAX_COUNTER_VALUE_32BIT + diff;
+      }
+      return diff;
+    }
+    return 0;
+  }
+}
+//# sourceMappingURL=MessageReceptionState.js.map

package/dist/cjs/protocol/MessageReceptionState.js.map

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

package/dist/cjs/protocol/ProtocolHandler.d.ts

@@ -0,0 +1,13 @@
+/**
+ * @license
+ * Copyright 2022-2024 Matter.js Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { Message } from "../codec/MessageCodec.js";
+import { MessageExchange } from "./MessageExchange.js";
+export interface ProtocolHandler {
+    getId(): number;
+    onNewExchange(exchange: MessageExchange, message: Message): Promise<void>;
+    close(): Promise<void>;
+}
+//# sourceMappingURL=ProtocolHandler.d.ts.map

package/dist/cjs/protocol/ProtocolHandler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ProtocolHandler.d.ts","sourceRoot":"","sources":["../../../src/protocol/ProtocolHandler.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,0BAA0B,CAAC;AACnD,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAEvD,MAAM,WAAW,eAAe;IAC5B,KAAK,IAAI,MAAM,CAAC;IAChB,aAAa,CAAC,QAAQ,EAAE,eAAe,EAAE,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC1E,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CAC1B"}

package/dist/cjs/protocol/ProtocolHandler.js

@@ -0,0 +1,22 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var ProtocolHandler_exports = {};
+module.exports = __toCommonJS(ProtocolHandler_exports);
+/**
+ * @license
+ * Copyright 2022-2024 Matter.js Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+//# sourceMappingURL=ProtocolHandler.js.map

package/dist/cjs/protocol/ProtocolHandler.js.map

@@ -0,0 +1,6 @@
+{
+  "version": 3,
+  "sources": ["../../../src/protocol/ProtocolHandler.ts"],
+  "mappings": ";;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;",
+  "names": []
+}

package/dist/cjs/protocol/index.d.ts

@@ -0,0 +1,14 @@
+/**
+ * @license
+ * Copyright 2022-2024 Matter.js Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+export * from "./ChannelManager.js";
+export * from "./DeviceAdvertiser.js";
+export * from "./DeviceCommissioner.js";
+export * from "./ExchangeManager.js";
+export * from "./MessageCounter.js";
+export * from "./MessageExchange.js";
+export * from "./MessageReceptionState.js";
+export * from "./ProtocolHandler.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/cjs/protocol/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/protocol/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,cAAc,qBAAqB,CAAC;AACpC,cAAc,uBAAuB,CAAC;AACtC,cAAc,yBAAyB,CAAC;AACxC,cAAc,sBAAsB,CAAC;AACrC,cAAc,qBAAqB,CAAC;AACpC,cAAc,sBAAsB,CAAC;AACrC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,sBAAsB,CAAC"}

package/dist/cjs/protocol/index.js

@@ -0,0 +1,31 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __reExport = (target, mod, secondTarget) => (__copyProps(target, mod, "default"), secondTarget && __copyProps(secondTarget, mod, "default"));
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var protocol_exports = {};
+module.exports = __toCommonJS(protocol_exports);
+__reExport(protocol_exports, require("./ChannelManager.js"), module.exports);
+__reExport(protocol_exports, require("./DeviceAdvertiser.js"), module.exports);
+__reExport(protocol_exports, require("./DeviceCommissioner.js"), module.exports);
+__reExport(protocol_exports, require("./ExchangeManager.js"), module.exports);
+__reExport(protocol_exports, require("./MessageCounter.js"), module.exports);
+__reExport(protocol_exports, require("./MessageExchange.js"), module.exports);
+__reExport(protocol_exports, require("./MessageReceptionState.js"), module.exports);
+__reExport(protocol_exports, require("./ProtocolHandler.js"), module.exports);
+/**
+ * @license
+ * Copyright 2022-2024 Matter.js Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+//# sourceMappingURL=index.js.map

package/dist/cjs/protocol/index.js.map

@@ -0,0 +1,6 @@
+{
+  "version": 3,
+  "sources": ["../../../src/protocol/index.ts"],
+  "mappings": ";;;;;;;;;;;;;;;AAAA;AAAA;AAMA,6BAAc,gCANd;AAOA,6BAAc,kCAPd;AAQA,6BAAc,oCARd;AASA,6BAAc,iCATd;AAUA,6BAAc,gCAVd;AAWA,6BAAc,iCAXd;AAYA,6BAAc,uCAZd;AAaA,6BAAc,iCAbd;AAAA;AAAA;AAAA;AAAA;AAAA;",
+  "names": []
+}

package/dist/cjs/securechannel/SecureChannelMessenger.d.ts

@@ -0,0 +1,53 @@
+/**
+ * @license
+ * Copyright 2022-2024 Matter.js Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { MatterError } from "#general";
+import { GeneralStatusCode, ProtocolStatusCode, TlvSchema } from "#types";
+import { Message } from "../codec/MessageCodec.js";
+import { ExchangeSendOptions, MessageExchange } from "../protocol/MessageExchange.js";
+/** Error base Class for all errors related to the status response messages. */
+export declare class ChannelStatusResponseError extends MatterError {
+    readonly generalStatusCode: GeneralStatusCode;
+    readonly protocolStatusCode: ProtocolStatusCode;
+    constructor(message: string, generalStatusCode: GeneralStatusCode, protocolStatusCode: ProtocolStatusCode);
+}
+/** This value is used by chip SDK when performance wise heavy crypto operations are expected. */
+export declare const EXPECTED_CRYPTO_PROCESSING_TIME_MS = 30000;
+/** This value is used by chip SDK when normal processing time is expected. */
+export declare const DEFAULT_NORMAL_PROCESSING_TIME_MS = 2000;
+export declare class SecureChannelMessenger {
+    #private;
+    protected readonly exchange: MessageExchange;
+    constructor(exchange: MessageExchange, defaultExpectedProcessingTimeMs?: number);
+    /**
+     * Waits for the next message and returns it.
+     * When no expectedProcessingTimeMs is provided, the default value of EXPECTED_CRYPTO_PROCESSING_TIME_MS is used.
+     */
+    nextMessage(expectedMessageInfo: string, expectedMessageType?: number, expectedProcessingTimeMs?: number): Promise<Message>;
+    /**
+     * Waits for the next message and decodes it.
+     * When no expectedProcessingTimeMs is provided, the default value of EXPECTED_CRYPTO_PROCESSING_TIME_MS is used.
+     */
+    nextMessageDecoded<T>(expectedMessageType: number, schema: TlvSchema<T>, expectedMessageInfo: string, expectedProcessingTimeMs?: number): Promise<T>;
+    /**
+     * Waits for the next message and returns it.
+     * When no expectedProcessingTimeMs is provided, the default value of EXPECTED_CRYPTO_PROCESSING_TIME_MS is used.
+     */
+    waitForSuccess(expectedMessageInfo: string, expectedProcessingTimeMs?: number): Promise<void>;
+    /**
+     * Sends a message of the given type with the given payload.
+     * If no ExchangeSendOptions are provided, the expectedProcessingTimeMs will be set to
+     * EXPECTED_CRYPTO_PROCESSING_TIME_MS.
+     */
+    send<T>(message: T, type: number, schema: TlvSchema<T>, options?: ExchangeSendOptions): Promise<Uint8Array>;
+    sendError(code: ProtocolStatusCode): Promise<void>;
+    sendSuccess(): Promise<void>;
+    sendCloseSession(): Promise<void>;
+    getChannelName(): string;
+    close(): Promise<void>;
+    private sendStatusReport;
+    protected throwIfErrorStatusReport(message: Message, logHint?: string): void;
+}
+//# sourceMappingURL=SecureChannelMessenger.d.ts.map

package/dist/cjs/securechannel/SecureChannelMessenger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SecureChannelMessenger.d.ts","sourceRoot":"","sources":["../../../src/securechannel/SecureChannelMessenger.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,WAAW,EAAuB,MAAM,UAAU,CAAC;AAC5D,OAAO,EACH,iBAAiB,EACjB,kBAAkB,EAGlB,SAAS,EACZ,MAAM,QAAQ,CAAC;AAChB,OAAO,EAAE,OAAO,EAAE,MAAM,0BAA0B,CAAC;AACnD,OAAO,EAAE,mBAAmB,EAAE,eAAe,EAAE,MAAM,gCAAgC,CAAC;AAGtF,+EAA+E;AAC/E,qBAAa,0BAA2B,SAAQ,WAAW;aAGnC,iBAAiB,EAAE,iBAAiB;aACpC,kBAAkB,EAAE,kBAAkB;gBAFtD,OAAO,EAAE,MAAM,EACC,iBAAiB,EAAE,iBAAiB,EACpC,kBAAkB,EAAE,kBAAkB;CAI7D;AAED,iGAAiG;AACjG,eAAO,MAAM,kCAAkC,QAAS,CAAC;AAEzD,8EAA8E;AAC9E,eAAO,MAAM,iCAAiC,OAAQ,CAAC;AAEvD,qBAAa,sBAAsB;;IAI3B,SAAS,CAAC,QAAQ,CAAC,QAAQ,EAAE,eAAe;gBAAzB,QAAQ,EAAE,eAAe,EAC5C,+BAA+B,SAAqC;IAKxE;;;OAGG;IACG,WAAW,CACb,mBAAmB,EAAE,MAAM,EAC3B,mBAAmB,CAAC,EAAE,MAAM,EAC5B,wBAAwB,SAAwC;IAYpE;;;OAGG;IACG,kBAAkB,CAAC,CAAC,EACtB,mBAAmB,EAAE,MAAM,EAC3B,MAAM,EAAE,SAAS,CAAC,CAAC,CAAC,EACpB,mBAAmB,EAAE,MAAM,EAC3B,wBAAwB,SAAwC;IAOpE;;;OAGG;IACG,cAAc,CAChB,mBAAmB,EAAE,MAAM,EAC3B,wBAAwB,SAAwC;IAMpE;;;;OAIG;IACG,IAAI,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,SAAS,CAAC,CAAC,CAAC,EAAE,OAAO,CAAC,EAAE,mBAAmB;IAU3F,SAAS,CAAC,IAAI,EAAE,kBAAkB;IAIlC,WAAW;IAIX,gBAAgB;IAIhB,cAAc;IAIR,KAAK;YAIG,gBAAgB;IAgB9B,SAAS,CAAC,wBAAwB,CAAC,OAAO,EAAE,OAAO,EAAE,OAAO,CAAC,EAAE,MAAM;CAuBxE"}

package/dist/cjs/securechannel/SecureChannelMessenger.js

@@ -0,0 +1,143 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var SecureChannelMessenger_exports = {};
+__export(SecureChannelMessenger_exports, {
+  ChannelStatusResponseError: () => ChannelStatusResponseError,
+  DEFAULT_NORMAL_PROCESSING_TIME_MS: () => DEFAULT_NORMAL_PROCESSING_TIME_MS,
+  EXPECTED_CRYPTO_PROCESSING_TIME_MS: () => EXPECTED_CRYPTO_PROCESSING_TIME_MS,
+  SecureChannelMessenger: () => SecureChannelMessenger
+});
+module.exports = __toCommonJS(SecureChannelMessenger_exports);
+var import_general = require("#general");
+var import_types = require("#types");
+var import_SecureChannelStatusMessageSchema = require("./SecureChannelStatusMessageSchema.js");
+/**
+ * @license
+ * Copyright 2022-2024 Matter.js Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+class ChannelStatusResponseError extends import_general.MatterError {
+  constructor(message, generalStatusCode, protocolStatusCode) {
+    super(`(${generalStatusCode}/${protocolStatusCode}) ${message}`);
+    this.generalStatusCode = generalStatusCode;
+    this.protocolStatusCode = protocolStatusCode;
+  }
+}
+const EXPECTED_CRYPTO_PROCESSING_TIME_MS = 3e4;
+const DEFAULT_NORMAL_PROCESSING_TIME_MS = 2e3;
+class SecureChannelMessenger {
+  constructor(exchange, defaultExpectedProcessingTimeMs = EXPECTED_CRYPTO_PROCESSING_TIME_MS) {
+    this.exchange = exchange;
+    this.#defaultExpectedProcessingTimeMs = defaultExpectedProcessingTimeMs;
+  }
+  #defaultExpectedProcessingTimeMs;
+  /**
+   * Waits for the next message and returns it.
+   * When no expectedProcessingTimeMs is provided, the default value of EXPECTED_CRYPTO_PROCESSING_TIME_MS is used.
+   */
+  async nextMessage(expectedMessageInfo, expectedMessageType, expectedProcessingTimeMs = this.#defaultExpectedProcessingTimeMs) {
+    const message = await this.exchange.nextMessage(expectedProcessingTimeMs);
+    const messageType = message.payloadHeader.messageType;
+    this.throwIfErrorStatusReport(message, expectedMessageInfo);
+    if (expectedMessageType !== void 0 && messageType !== expectedMessageType)
+      throw new import_general.UnexpectedDataError(
+        `Received unexpected message type: ${messageType}, expected: ${expectedMessageType} (${expectedMessageInfo})`
+      );
+    return message;
+  }
+  /**
+   * Waits for the next message and decodes it.
+   * When no expectedProcessingTimeMs is provided, the default value of EXPECTED_CRYPTO_PROCESSING_TIME_MS is used.
+   */
+  async nextMessageDecoded(expectedMessageType, schema, expectedMessageInfo, expectedProcessingTimeMs = this.#defaultExpectedProcessingTimeMs) {
+    return schema.decode(
+      (await this.nextMessage(expectedMessageInfo, expectedMessageType, expectedProcessingTimeMs)).payload
+    );
+  }
+  /**
+   * Waits for the next message and returns it.
+   * When no expectedProcessingTimeMs is provided, the default value of EXPECTED_CRYPTO_PROCESSING_TIME_MS is used.
+   */
+  async waitForSuccess(expectedMessageInfo, expectedProcessingTimeMs = this.#defaultExpectedProcessingTimeMs) {
+    await this.nextMessage(expectedMessageInfo, import_types.SecureMessageType.StatusReport, expectedProcessingTimeMs);
+  }
+  /**
+   * Sends a message of the given type with the given payload.
+   * If no ExchangeSendOptions are provided, the expectedProcessingTimeMs will be set to
+   * EXPECTED_CRYPTO_PROCESSING_TIME_MS.
+   */
+  async send(message, type, schema, options) {
+    options = {
+      ...options,
+      expectedProcessingTimeMs: options?.expectedProcessingTimeMs ?? this.#defaultExpectedProcessingTimeMs
+    };
+    const payload = schema.encode(message);
+    await this.exchange.send(type, payload, options);
+    return payload;
+  }
+  sendError(code) {
+    return this.sendStatusReport(import_types.GeneralStatusCode.Failure, code);
+  }
+  sendSuccess() {
+    return this.sendStatusReport(import_types.GeneralStatusCode.Success, import_types.ProtocolStatusCode.Success);
+  }
+  sendCloseSession() {
+    return this.sendStatusReport(import_types.GeneralStatusCode.Success, import_types.ProtocolStatusCode.CloseSession, false);
+  }
+  getChannelName() {
+    return this.exchange.channel.channel.name;
+  }
+  async close() {
+    await this.exchange.close();
+  }
+  async sendStatusReport(generalStatus, protocolStatus, requiresAck) {
+    await this.exchange.send(
+      import_types.SecureMessageType.StatusReport,
+      import_SecureChannelStatusMessageSchema.TlvSecureChannelStatusMessage.encode({
+        generalStatus,
+        protocolId: import_types.SECURE_CHANNEL_PROTOCOL_ID,
+        protocolStatus
+      }),
+      { requiresAck }
+    );
+  }
+  throwIfErrorStatusReport(message, logHint) {
+    const {
+      payloadHeader: { messageType },
+      payload
+    } = message;
+    if (messageType !== import_types.SecureMessageType.StatusReport) return;
+    const { generalStatus, protocolId, protocolStatus } = import_SecureChannelStatusMessageSchema.TlvSecureChannelStatusMessage.decode(payload);
+    if (generalStatus !== import_types.GeneralStatusCode.Success) {
+      throw new ChannelStatusResponseError(
+        `Received general error status for protocol ${protocolId}${logHint ? ` (${logHint})` : ""}`,
+        generalStatus,
+        protocolStatus
+      );
+    }
+    if (protocolStatus !== import_types.ProtocolStatusCode.Success) {
+      throw new ChannelStatusResponseError(
+        `Received general success status, but protocol status is not Success${logHint ? ` (${logHint})` : ""}`,
+        generalStatus,
+        protocolStatus
+      );
+    }
+  }
+}
+//# sourceMappingURL=SecureChannelMessenger.js.map

package/dist/cjs/securechannel/SecureChannelMessenger.js.map

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

package/dist/cjs/securechannel/SecureChannelProtocol.d.ts

@@ -0,0 +1,31 @@
+/**
+ * @license
+ * Copyright 2022-2024 Matter.js Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { FabricManager } from "#fabric/FabricManager.js";
+import { AsyncObservable } from "#general";
+import { SessionManager } from "#session/SessionManager.js";
+import { Message } from "../codec/MessageCodec.js";
+import { MessageExchange } from "../protocol/MessageExchange.js";
+import { ProtocolHandler } from "../protocol/ProtocolHandler.js";
+import { PaseServer } from "../session/pase/PaseServer.js";
+export declare class StatusReportOnlySecureChannelProtocol implements ProtocolHandler {
+    getId(): number;
+    onNewExchange(exchange: MessageExchange, message: Message): Promise<void>;
+    handleInitialStatusReport(exchange: MessageExchange, message: Message): Promise<void>;
+    close(): Promise<void>;
+}
+export declare class SecureChannelProtocol extends StatusReportOnlySecureChannelProtocol {
+    #private;
+    constructor(sessions: SessionManager, fabrics: FabricManager);
+    /**
+     * Emitted when the active PASE session hits the maximum error threshold.
+     */
+    get tooManyPaseErrors(): AsyncObservable<[], void>;
+    setPaseCommissioner(paseServer: PaseServer): void;
+    removePaseCommissioner(): void;
+    onNewExchange(exchange: MessageExchange, message: Message): Promise<void>;
+    static isStandaloneAck(protocolId: number, messageType: number): boolean;
+}
+//# sourceMappingURL=SecureChannelProtocol.d.ts.map

package/dist/cjs/securechannel/SecureChannelProtocol.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SecureChannelProtocol.d.ts","sourceRoot":"","sources":["../../../src/securechannel/SecureChannelProtocol.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AACzD,OAAO,EAAE,eAAe,EAA2B,MAAM,UAAU,CAAC;AACpE,OAAO,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAC;AAS5D,OAAO,EAAE,OAAO,EAAE,MAAM,0BAA0B,CAAC;AACnD,OAAO,EAAE,eAAe,EAAE,MAAM,gCAAgC,CAAC;AACjE,OAAO,EAAE,eAAe,EAAE,MAAM,gCAAgC,CAAC;AAGjE,OAAO,EAAwC,UAAU,EAAE,MAAM,+BAA+B,CAAC;AAMjG,qBAAa,qCAAsC,YAAW,eAAe;IACzE,KAAK,IAAI,MAAM;IAIT,aAAa,CAAC,QAAQ,EAAE,eAAe,EAAE,OAAO,EAAE,OAAO;IAkBzD,yBAAyB,CAAC,QAAQ,EAAE,eAAe,EAAE,OAAO,EAAE,OAAO;IAoCrE,KAAK;CAGd;AAED,qBAAa,qBAAsB,SAAQ,qCAAqC;;gBAKhE,QAAQ,EAAE,cAAc,EAAE,OAAO,EAAE,aAAa;IAK5D;;OAEG;IACH,IAAI,iBAAiB,8BAEpB;IAED,mBAAmB,CAAC,UAAU,EAAE,UAAU;IAI1C,sBAAsB;IAIP,aAAa,CAAC,QAAQ,EAAE,eAAe,EAAE,OAAO,EAAE,OAAO;IA6BxE,MAAM,CAAC,eAAe,CAAC,UAAU,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM;CAGjE"}