@matter/protocol 0.16.0-alpha.0-20250913-0bc2515df → 0.16.0-alpha.0-20250920-809524dba

package/dist/cjs/bdx/flow/FollowingReceivingFlow.js

@@ -0,0 +1,60 @@
+"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 FollowingReceivingFlow_exports = {};
+__export(FollowingReceivingFlow_exports, {
+  FollowingReceivingFlow: () => FollowingReceivingFlow
+});
+module.exports = __toCommonJS(FollowingReceivingFlow_exports);
+var import_general = require("#general");
+var import_types = require("#types");
+var import_BdxMessenger = require("../BdxMessenger.js");
+var import_BdxMessage = require("../schema/BdxMessage.js");
+var import_OutboundFlow = require("./OutboundFlow.js");
+/**
+ * @license
+ * Copyright 2022-2025 Matter.js Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+const logger = import_general.Logger.get("BdxFollowingReceivingFlow");
+class FollowingReceivingFlow extends import_OutboundFlow.OutboundFlow {
+  async transferNextChunk() {
+    const { iterator, streamReader } = this.stream;
+    const blockQuery = await this.messenger.readBlockQuery();
+    const bytesToSkip = import_BdxMessage.BdxMessage.is(blockQuery, import_types.BdxMessageType.BlockQueryWithSkip) ? import_BdxMessenger.BdxMessenger.asSafeNumber(
+      blockQuery.message.bytesToSkip,
+      "BytesToSkip",
+      import_types.BdxStatusCode.TransferFailedUnknownError
+    ) : 0;
+    const { blockCounter } = blockQuery.message;
+    this.validateCounter(blockCounter);
+    if (bytesToSkip > 0) {
+      const skipped = await streamReader.skip(bytesToSkip);
+      logger.debug(`Skipped ${skipped}bytes of data (requested ${bytesToSkip}bytes)`);
+    }
+    const { data, done } = await this.readDataChunk(iterator);
+    if (done) {
+      await this.messenger.sendBlockEof({ data, blockCounter });
+      this.finalBlockCounter = blockCounter;
+      return true;
+    }
+    await this.messenger.sendBlock({ data, blockCounter });
+    return false;
+  }
+}
+//# sourceMappingURL=FollowingReceivingFlow.js.map

package/dist/cjs/bdx/flow/FollowingReceivingFlow.js.map

@@ -0,0 +1,6 @@
+{
+  "version": 3,
+  "sources": ["../../../../src/bdx/flow/FollowingReceivingFlow.ts"],
+  "mappings": ";;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAMA,qBAAuB;AACvB,mBAA8C;AAC9C,0BAA6B;AAC7B,wBAA2B;AAC3B,0BAA6B;AAV7B;AAAA;AAAA;AAAA;AAAA;AAYA,MAAM,SAAS,sBAAO,IAAI,2BAA2B;AAO9C,MAAM,+BAA+B,iCAAa;AAAA,EACrD,MAAgB,oBAAoB;AAChC,UAAM,EAAE,UAAU,aAAa,IAAI,KAAK;AAGxC,UAAM,aAAa,MAAM,KAAK,UAAU,eAAe;AACvD,UAAM,cAAc,6BAAW,GAAG,YAAY,4BAAe,kBAAkB,IACzE,iCAAa;AAAA,MACT,WAAW,QAAQ;AAAA,MACnB;AAAA,MACA,2BAAc;AAAA,IAClB,IACA;AAEN,UAAM,EAAE,aAAa,IAAI,WAAW;AACpC,SAAK,gBAAgB,YAAY;AAEjC,QAAI,cAAc,GAAG;AACjB,YAAM,UAAU,MAAM,aAAa,KAAK,WAAW;AACnD,aAAO,MAAM,WAAW,OAAO,4BAA4B,WAAW,QAAQ;AAAA,IAClF;AACA,UAAM,EAAE,MAAM,KAAK,IAAI,MAAM,KAAK,cAAc,QAAQ;AAExD,QAAI,MAAM;AACN,YAAM,KAAK,UAAU,aAAa,EAAE,MAAM,aAAa,CAAC;AACxD,WAAK,oBAAoB;AACzB,aAAO;AAAA,IACX;AAEA,UAAM,KAAK,UAAU,UAAU,EAAE,MAAM,aAAa,CAAC;AAErD,WAAO;AAAA,EACX;AACJ;",
+  "names": []
+}

package/dist/cjs/bdx/flow/FollowingSendingFlow.d.ts

@@ -0,0 +1,15 @@
+/**
+ * @license
+ * Copyright 2022-2025 Matter.js Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { InboundFlow } from "./InboundFlow.js";
+/**
+ * BDX Transport flow logic for a "BDX Following Sender":
+ * - Reads the Block and sends an Ack (if synchronous transfer is used)
+ * - Last message is confirmed with an AckEof
+ */
+export declare class FollowingSendingFlow extends InboundFlow {
+    protected transferNextChunk(): Promise<boolean>;
+}
+//# sourceMappingURL=FollowingSendingFlow.d.ts.map

package/dist/cjs/bdx/flow/FollowingSendingFlow.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"FollowingSendingFlow.d.ts","sourceRoot":"","sources":["../../../../src/bdx/flow/FollowingSendingFlow.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAE/C;;;;GAIG;AACH,qBAAa,oBAAqB,SAAQ,WAAW;cACjC,iBAAiB;CAuBpC"}

package/dist/cjs/bdx/flow/FollowingSendingFlow.js

@@ -0,0 +1,49 @@
+"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 FollowingSendingFlow_exports = {};
+__export(FollowingSendingFlow_exports, {
+  FollowingSendingFlow: () => FollowingSendingFlow
+});
+module.exports = __toCommonJS(FollowingSendingFlow_exports);
+var import_InboundFlow = require("./InboundFlow.js");
+/**
+ * @license
+ * Copyright 2022-2025 Matter.js Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+class FollowingSendingFlow extends import_InboundFlow.InboundFlow {
+  async transferNextChunk() {
+    const { asynchronousTransfer } = this.transferParameters;
+    const { writeController } = this.stream;
+    const {
+      kind: messageType,
+      message: { data, blockCounter }
+    } = await this.messenger.readBlock();
+    this.validateCounter(blockCounter);
+    if (this.writeDataChunk(writeController, data, messageType)) {
+      this.finalBlockCounter = blockCounter;
+      return true;
+    }
+    if (!asynchronousTransfer) {
+      await this.messenger.sendBlockAck({ blockCounter });
+    }
+    return false;
+  }
+}
+//# sourceMappingURL=FollowingSendingFlow.js.map

package/dist/cjs/bdx/flow/FollowingSendingFlow.js.map

@@ -0,0 +1,6 @@
+{
+  "version": 3,
+  "sources": ["../../../../src/bdx/flow/FollowingSendingFlow.ts"],
+  "mappings": ";;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAMA,yBAA4B;AAN5B;AAAA;AAAA;AAAA;AAAA;AAaO,MAAM,6BAA6B,+BAAY;AAAA,EAClD,MAAgB,oBAAoB;AAChC,UAAM,EAAE,qBAAqB,IAAI,KAAK;AACtC,UAAM,EAAE,gBAAgB,IAAI,KAAK;AAEjC,UAAM;AAAA,MACF,MAAM;AAAA,MACN,SAAS,EAAE,MAAM,aAAa;AAAA,IAClC,IAAI,MAAM,KAAK,UAAU,UAAU;AACnC,SAAK,gBAAgB,YAAY;AAGjC,QAAI,KAAK,eAAe,iBAAiB,MAAM,WAAW,GAAG;AACzD,WAAK,oBAAoB;AACzB,aAAO;AAAA,IACX;AAEA,QAAI,CAAC,sBAAsB;AAEvB,YAAM,KAAK,UAAU,aAAa,EAAE,aAAa,CAAC;AAAA,IACtD;AAEA,WAAO;AAAA,EACX;AACJ;",
+  "names": []
+}

package/dist/cjs/bdx/flow/InboundFlow.d.ts

@@ -0,0 +1,26 @@
+/**
+ * @license
+ * Copyright 2022-2025 Matter.js Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { Bytes } from "#general";
+import { BdxMessageType } from "#types";
+import { Flow } from "./Flow.js";
+/**
+ * Base class for inbound BDX transfer flows where data is received from the peer and written to our node.
+ */
+export declare abstract class InboundFlow extends Flow {
+    #private;
+    /**
+     * Returns initialized streams for the transfer and initializes the #closeStream class function
+     */
+    protected initTransfer(): Promise<void>;
+    protected get stream(): {
+        writeController: ReadableStreamDefaultController<AllowSharedBufferSource>;
+        writePromise: PromiseLike<void>;
+    };
+    protected finalizeTransfer(): Promise<void>;
+    protected writeDataChunk(writeController: ReadableStreamDefaultController<Bytes>, data: Bytes, messageType: BdxMessageType): boolean;
+    close(error?: unknown): Promise<void>;
+}
+//# sourceMappingURL=InboundFlow.d.ts.map

package/dist/cjs/bdx/flow/InboundFlow.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"InboundFlow.d.ts","sourceRoot":"","sources":["../../../../src/bdx/flow/InboundFlow.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,KAAK,EAA+B,MAAM,UAAU,CAAC;AAC9D,OAAO,EAAE,cAAc,EAAiB,MAAM,QAAQ,CAAC;AAEvD,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAEjC;;GAEG;AACH,8BAAsB,WAAY,SAAQ,IAAI;;IAK1C;;OAEG;cACa,YAAY;IAkC5B,SAAS,KAAK,MAAM;;;MAKnB;cAEe,gBAAgB;IAOhC,SAAS,CAAC,cAAc,CACpB,eAAe,EAAE,+BAA+B,CAAC,KAAK,CAAC,EACvD,IAAI,EAAE,KAAK,EACX,WAAW,EAAE,cAAc;IA0BhB,KAAK,CAAC,KAAK,CAAC,EAAE,OAAO;CAIvC"}

package/dist/cjs/bdx/flow/InboundFlow.js

@@ -0,0 +1,101 @@
+"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 InboundFlow_exports = {};
+__export(InboundFlow_exports, {
+  InboundFlow: () => InboundFlow
+});
+module.exports = __toCommonJS(InboundFlow_exports);
+var import_general = require("#general");
+var import_types = require("#types");
+var import_BdxError = require("../BdxError.js");
+var import_Flow = require("./Flow.js");
+/**
+ * @license
+ * Copyright 2022-2025 Matter.js Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+class InboundFlow extends import_Flow.Flow {
+  #closeStreams;
+  #writeController;
+  #writePromise;
+  /**
+   * Returns initialized streams for the transfer and initializes the #closeStream class function
+   */
+  async initTransfer() {
+    let writeController;
+    const stream = new ReadableStream({
+      start: (controller) => {
+        writeController = controller;
+      }
+    });
+    const { fileDesignator } = this.transferParameters;
+    const writePromise = fileDesignator.writeFromStream(stream);
+    this.#closeStreams = async (error) => {
+      if (writeController !== void 0) {
+        if (error != void 0) {
+          writeController.error(error);
+          try {
+            await writePromise;
+          } catch {
+          }
+        }
+      }
+      if (!stream.locked) {
+        await stream.cancel();
+      }
+    };
+    this.#writeController = writeController;
+    this.#writePromise = writePromise;
+  }
+  get stream() {
+    if (!this.#writeController || !this.#writePromise) {
+      throw new import_general.InternalError("Transfer not initialized. Call initTransfer() before starting the transfer.");
+    }
+    return { writeController: this.#writeController, writePromise: this.#writePromise };
+  }
+  async finalizeTransfer() {
+    const { writePromise } = this.stream;
+    const blockCounter = this.finalBlockCounter;
+    await writePromise;
+    await this.messenger.sendBlockAckEof({ blockCounter });
+  }
+  writeDataChunk(writeController, data, messageType) {
+    writeController.enqueue(data);
+    if (this.bytesLeft !== void 0) {
+      this.bytesLeft -= data.byteLength;
+    }
+    let done = false;
+    if (messageType === import_types.BdxMessageType.BlockEof) {
+      if (this.bytesLeft !== void 0 && this.bytesLeft !== 0) {
+        throw new import_BdxError.BdxError(
+          `Received BlockEof with ${this.bytesLeft}bytes left, but no more data available`,
+          this.bytesLeft > 0 ? import_types.BdxStatusCode.LengthTooShort : import_types.BdxStatusCode.LengthTooLarge
+        );
+      }
+      done = true;
+      writeController.close();
+    }
+    return done;
+  }
+  async close(error) {
+    await super.close(error);
+    await this.#closeStreams?.(error);
+  }
+}
+//# sourceMappingURL=InboundFlow.js.map

package/dist/cjs/bdx/flow/InboundFlow.js.map

@@ -0,0 +1,6 @@
+{
+  "version": 3,
+  "sources": ["../../../../src/bdx/flow/InboundFlow.ts"],
+  "mappings": ";;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAMA,qBAAmD;AACnD,mBAA8C;AAC9C,sBAAyB;AACzB,kBAAqB;AATrB;AAAA;AAAA;AAAA;AAAA;AAcO,MAAe,oBAAoB,iBAAK;AAAA,EAC3C;AAAA,EACA;AAAA,EACA;AAAA;AAAA;AAAA;AAAA,EAKA,MAAgB,eAAe;AAE3B,QAAI;AACJ,UAAM,SAAS,IAAI,eAAsB;AAAA,MACrC,OAAO,gBAAc;AACjB,0BAAkB;AAAA,MACtB;AAAA,IACJ,CAAC;AACD,UAAM,EAAE,eAAe,IAAI,KAAK;AAChC,UAAM,eAAe,eAAe,gBAAgB,MAAM;AAG1D,SAAK,gBAAgB,OAAO,UAAoB;AAC5C,UAAI,oBAAoB,QAAW;AAC/B,YAAI,SAAS,QAAW;AAEpB,0BAAgB,MAAM,KAAK;AAC3B,cAAI;AACA,kBAAM;AAAA,UACV,QAAQ;AAAA,UAER;AAAA,QACJ;AAAA,MACJ;AAEA,UAAI,CAAC,OAAO,QAAQ;AAChB,cAAM,OAAO,OAAO;AAAA,MACxB;AAAA,IACJ;AAEA,SAAK,mBAAmB;AACxB,SAAK,gBAAgB;AAAA,EACzB;AAAA,EAEA,IAAc,SAAS;AACnB,QAAI,CAAC,KAAK,oBAAoB,CAAC,KAAK,eAAe;AAC/C,YAAM,IAAI,6BAAc,6EAA6E;AAAA,IACzG;AACA,WAAO,EAAE,iBAAiB,KAAK,kBAAkB,cAAc,KAAK,cAAc;AAAA,EACtF;AAAA,EAEA,MAAgB,mBAAmB;AAC/B,UAAM,EAAE,aAAa,IAAI,KAAK;AAC9B,UAAM,eAAe,KAAK;AAC1B,UAAM;AACN,UAAM,KAAK,UAAU,gBAAgB,EAAE,aAAa,CAAC;AAAA,EACzD;AAAA,EAEU,eACN,iBACA,MACA,aACF;AAEE,oBAAgB,QAAQ,IAAI;AAC5B,QAAI,KAAK,cAAc,QAAW;AAC9B,WAAK,aAAa,KAAK;AAAA,IAC3B;AAEA,QAAI,OAAO;AAGX,QAAI,gBAAgB,4BAAe,UAAU;AACzC,UAAI,KAAK,cAAc,UAAa,KAAK,cAAc,GAAG;AACtD,cAAM,IAAI;AAAA,UACN,0BAA0B,KAAK,SAAS;AAAA,UACxC,KAAK,YAAY,IAAI,2BAAc,iBAAiB,2BAAc;AAAA,QACtE;AAAA,MACJ;AAEA,aAAO;AACP,sBAAgB,MAAM;AAAA,IAC1B;AAEA,WAAO;AAAA,EACX;AAAA,EAEA,MAAe,MAAM,OAAiB;AAClC,UAAM,MAAM,MAAM,KAAK;AACvB,UAAM,KAAK,gBAAgB,KAAK;AAAA,EACpC;AACJ;",
+  "names": []
+}

package/dist/cjs/bdx/flow/OutboundFlow.d.ts

@@ -0,0 +1,31 @@
+/**
+ * @license
+ * Copyright 2022-2025 Matter.js Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { BytesStreamReader } from "#general";
+import { Flow } from "./Flow.js";
+/**
+ * Base class for outbound BDX transfer flows where data is read from our node and sent to the peer.
+ */
+export declare abstract class OutboundFlow extends Flow {
+    #private;
+    protected get stream(): {
+        iterator: AsyncGenerator<Uint8Array<ArrayBufferLike>, void, unknown>;
+        streamReader: BytesStreamReader;
+    };
+    /**
+     * Returns initialized streams for the transfer and initializes the #closeStream class function
+     */
+    protected initTransfer(): Promise<void>;
+    /**
+     * Reads one data chunk from the reader and does some basic checks.
+     */
+    protected readDataChunk(reader: AsyncGenerator<Uint8Array<ArrayBufferLike>, void, unknown>): Promise<{
+        data: Uint8Array<ArrayBufferLike>;
+        done: boolean;
+    }>;
+    protected finalizeTransfer(): Promise<void>;
+    close(error?: unknown): Promise<void>;
+}
+//# sourceMappingURL=OutboundFlow.d.ts.map

package/dist/cjs/bdx/flow/OutboundFlow.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"OutboundFlow.d.ts","sourceRoot":"","sources":["../../../../src/bdx/flow/OutboundFlow.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,iBAAiB,EAAiB,MAAM,UAAU,CAAC;AAG5D,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAEjC;;GAEG;AACH,8BAAsB,YAAa,SAAQ,IAAI;;IAK3C,SAAS,KAAK,MAAM;;;MAKnB;IAED;;OAEG;cACa,YAAY;IAoC5B;;OAEG;cACa,aAAa,CAAC,MAAM,EAAE,cAAc,CAAC,UAAU,CAAC,eAAe,CAAC,EAAE,IAAI,EAAE,OAAO,CAAC;;;;cA6ChF,gBAAgB;IAMjB,KAAK,CAAC,KAAK,CAAC,EAAE,OAAO;CAIvC"}

package/dist/cjs/bdx/flow/OutboundFlow.js

@@ -0,0 +1,124 @@
+"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 OutboundFlow_exports = {};
+__export(OutboundFlow_exports, {
+  OutboundFlow: () => OutboundFlow
+});
+module.exports = __toCommonJS(OutboundFlow_exports);
+var import_general = require("#general");
+var import_types = require("#types");
+var import_BdxError = require("../BdxError.js");
+var import_Flow = require("./Flow.js");
+/**
+ * @license
+ * Copyright 2022-2025 Matter.js Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+class OutboundFlow extends import_Flow.Flow {
+  #closeStreams;
+  #iterator;
+  #streamReader;
+  get stream() {
+    if (this.#iterator === void 0 || this.#streamReader === void 0) {
+      throw new import_general.InternalError("Read stream not initialized");
+    }
+    return { iterator: this.#iterator, streamReader: this.#streamReader };
+  }
+  /**
+   * Returns initialized streams for the transfer and initializes the #closeStream class function
+   */
+  async initTransfer() {
+    const { blockSize } = this.transferParameters;
+    const blob = await this.transferParameters.fileDesignator.openBlob();
+    const blobSize = blob.size;
+    const { startOffset = 0, dataLength = blobSize } = this.transferParameters;
+    const dataBlob = startOffset > 0 || dataLength !== blobSize ? blob.slice(startOffset, startOffset + dataLength) : blob;
+    const stream = dataBlob.stream();
+    const reader = stream.getReader();
+    this.#closeStreams = async (_error) => {
+      if (stream.locked) {
+        reader?.releaseLock();
+        try {
+          await reader?.cancel();
+        } catch (error) {
+          if (!(error instanceof TypeError)) {
+            throw error;
+          }
+        }
+      }
+      await stream.cancel();
+    };
+    const streamReader = new import_general.BytesStreamReader(reader);
+    this.#iterator = streamReader.read(blockSize);
+    this.#streamReader = streamReader;
+  }
+  /**
+   * Reads one data chunk from the reader and does some basic checks.
+   */
+  async readDataChunk(reader) {
+    const { blockSize, dataLength } = this.transferParameters;
+    let { value, done = false } = await reader.next();
+    if (value === void 0) {
+      if (!done) {
+        throw new import_BdxError.BdxError(
+          `Data length too short, expected ${blockSize}bytes, but got less`,
+          import_types.BdxStatusCode.LengthTooShort
+        );
+      }
+      value = new Uint8Array();
+    } else if (value.byteLength < blockSize) {
+      ({ done = false } = await reader.next());
+      if (!done) {
+        throw new import_BdxError.BdxError(
+          `Data length too short, expected ${blockSize}bytes, but got less`,
+          import_types.BdxStatusCode.LengthTooShort
+        );
+      }
+    }
+    if (this.bytesLeft !== void 0 && dataLength !== void 0) {
+      this.bytesLeft -= value.byteLength;
+      if (this.bytesLeft < 0) {
+        throw new import_BdxError.BdxError(
+          `Data length exceeded, expected ${dataLength}bytes, but got ${-this.bytesLeft}bytes more`,
+          import_types.BdxStatusCode.LengthTooLarge
+        );
+      }
+      if (done && this.bytesLeft > 0) {
+        throw new import_BdxError.BdxError(
+          `Data length too short, expected ${dataLength}bytes, but got ${this.bytesLeft}bytes less`,
+          import_types.BdxStatusCode.LengthTooShort
+        );
+      }
+      if (this.bytesLeft === 0) {
+        done = true;
+      }
+    }
+    return { data: value, done };
+  }
+  async finalizeTransfer() {
+    const blockCounter = this.finalBlockCounter;
+    const { blockCounter: ackedBlockCounter } = await this.messenger.readBlockAckEof();
+    this.validateCounter(ackedBlockCounter, blockCounter);
+  }
+  async close(error) {
+    await super.close(error);
+    await this.#closeStreams?.(error);
+  }
+}
+//# sourceMappingURL=OutboundFlow.js.map

package/dist/cjs/bdx/flow/OutboundFlow.js.map

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

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

@@ -0,0 +1,16 @@
+/**
+ * @license
+ * Copyright 2022-2025 Matter.js Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+export * from "./BdxClient.js";
+export * from "./BdxError.js";
+export * from "./BdxMessenger.js";
+export * from "./BdxProtocol.js";
+export * from "./BdxSession.js";
+export * from "./BdxSessionConfiguration.js";
+export * from "./FileDesignator.js";
+export * from "./flow/Flow.js";
+export * from "./PersistedFileDesignator.js";
+export * from "./schema/index.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/bdx/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,cAAc,gBAAgB,CAAC;AAC/B,cAAc,eAAe,CAAC;AAC9B,cAAc,mBAAmB,CAAC;AAClC,cAAc,kBAAkB,CAAC;AACjC,cAAc,iBAAiB,CAAC;AAChC,cAAc,8BAA8B,CAAC;AAC7C,cAAc,qBAAqB,CAAC;AACpC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,8BAA8B,CAAC;AAC7C,cAAc,mBAAmB,CAAC"}

package/dist/cjs/bdx/index.js

@@ -0,0 +1,33 @@
+"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 bdx_exports = {};
+module.exports = __toCommonJS(bdx_exports);
+__reExport(bdx_exports, require("./BdxClient.js"), module.exports);
+__reExport(bdx_exports, require("./BdxError.js"), module.exports);
+__reExport(bdx_exports, require("./BdxMessenger.js"), module.exports);
+__reExport(bdx_exports, require("./BdxProtocol.js"), module.exports);
+__reExport(bdx_exports, require("./BdxSession.js"), module.exports);
+__reExport(bdx_exports, require("./BdxSessionConfiguration.js"), module.exports);
+__reExport(bdx_exports, require("./FileDesignator.js"), module.exports);
+__reExport(bdx_exports, require("./flow/Flow.js"), module.exports);
+__reExport(bdx_exports, require("./PersistedFileDesignator.js"), module.exports);
+__reExport(bdx_exports, require("./schema/index.js"), module.exports);
+/**
+ * @license
+ * Copyright 2022-2025 Matter.js Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1,6 @@
+{
+  "version": 3,
+  "sources": ["../../../src/bdx/index.ts"],
+  "mappings": ";;;;;;;;;;;;;;;AAAA;AAAA;AAMA,wBAAc,2BANd;AAOA,wBAAc,0BAPd;AAQA,wBAAc,8BARd;AASA,wBAAc,6BATd;AAUA,wBAAc,4BAVd;AAWA,wBAAc,yCAXd;AAYA,wBAAc,gCAZd;AAaA,wBAAc,2BAbd;AAcA,wBAAc,yCAdd;AAeA,wBAAc,8BAfd;AAAA;AAAA;AAAA;AAAA;AAAA;",
+  "names": []
+}

package/dist/cjs/bdx/schema/BdxAcceptMessagesSchema.d.ts

@@ -0,0 +1,50 @@
+/**
+ * @license
+ * Copyright 2022-2025 Matter.js Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { Bytes } from "#general";
+import { Schema, TypeFromPartialBitSchema } from "#types";
+import { BdxTransferControlBitmap } from "./BdxInitMessagesSchema.js";
+/** @see {@link MatterSpecification.v141.Core}, section 11.22.5.2 */
+export interface BdxSendAccept {
+    /**
+     * Transfer control details
+     * TC
+     * 1 octet
+     */
+    transferControl: TypeFromPartialBitSchema<typeof BdxTransferControlBitmap>;
+    /**
+     * Specifies the maximum data size (in bytes) of the block that the Initiator supports, exclusive of block header
+     * fields, such as a block counter.
+     * MBS, 2 octets
+     */
+    maxBlockSize: number;
+    /**
+     * Allows the Initiator to send additional application-specific information about the file to be transferred
+     * MD, Variable length, TLV
+     */
+    metaData?: Bytes;
+}
+/** @see {@link MatterSpecification.v141.Core}, section 11.22.5.3 */
+export interface BdxReceiveAccept extends BdxSendAccept {
+    /**
+     * Specifies a predetermined definite length for the transfer
+     * DEFLEN, 4/8 octets
+     */
+    length?: number | bigint;
+}
+/** Schema for BDX SendAccept message */
+export declare class BdxSendAcceptMessageSchema<M extends BdxSendAccept> extends Schema<M> {
+    encodeInternal(message: M): Uint8Array<ArrayBufferLike>;
+    decodeInternal(bytes: Bytes): M;
+    validate({ transferControl, maxBlockSize }: M): void;
+}
+export declare const BdxSendAcceptMessage: BdxSendAcceptMessageSchema<BdxSendAccept>;
+/** Schema for Bdx ReceiveAccept message */
+export declare class BdxReceiveAcceptMessageSchema extends BdxSendAcceptMessageSchema<BdxReceiveAccept> {
+    encodeInternal(message: BdxReceiveAccept): Uint8Array<ArrayBufferLike>;
+    decodeInternal(bytes: Bytes): BdxReceiveAccept;
+}
+export declare const BdxReceiveAcceptMessage: BdxReceiveAcceptMessageSchema;
+//# sourceMappingURL=BdxAcceptMessagesSchema.d.ts.map

package/dist/cjs/bdx/schema/BdxAcceptMessagesSchema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"BdxAcceptMessagesSchema.d.ts","sourceRoot":"","sources":["../../../../src/bdx/schema/BdxAcceptMessagesSchema.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,KAAK,EAAkC,MAAM,UAAU,CAAC;AACjE,OAAO,EAAiB,MAAM,EAAE,wBAAwB,EAAE,MAAM,QAAQ,CAAC;AAEzE,OAAO,EAGH,wBAAwB,EAE3B,MAAM,4BAA4B,CAAC;AAEpC,oEAAoE;AACpE,MAAM,WAAW,aAAa;IAC1B;;;;OAIG;IACH,eAAe,EAAE,wBAAwB,CAAC,OAAO,wBAAwB,CAAC,CAAC;IAE3E;;;;OAIG;IACH,YAAY,EAAE,MAAM,CAAC;IAErB;;;OAGG;IACH,QAAQ,CAAC,EAAE,KAAK,CAAC;CACpB;AAED,oEAAoE;AACpE,MAAM,WAAW,gBAAiB,SAAQ,aAAa;IACnD;;;OAGG;IACH,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;CAC5B;AAED,wCAAwC;AACxC,qBAAa,0BAA0B,CAAC,CAAC,SAAS,aAAa,CAAE,SAAQ,MAAM,CAAC,CAAC,CAAC;IAC9E,cAAc,CAAC,OAAO,EAAE,CAAC;IAezB,cAAc,CAAC,KAAK,EAAE,KAAK,GAAG,CAAC;IAgBtB,QAAQ,CAAC,EAAE,eAAe,EAAE,YAAY,EAAE,EAAE,CAAC;CAiBzD;AACD,eAAO,MAAM,oBAAoB,2CAAmC,CAAC;AAErE,2CAA2C;AAC3C,qBAAa,6BAA8B,SAAQ,0BAA0B,CAAC,gBAAgB,CAAC;IAClF,cAAc,CAAC,OAAO,EAAE,gBAAgB;IA6BxC,cAAc,CAAC,KAAK,EAAE,KAAK,GAAG,gBAAgB;CAyB1D;AACD,eAAO,MAAM,uBAAuB,+BAAsC,CAAC"}