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

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

@@ -0,0 +1,81 @@
+/**
+ * @license
+ * Copyright 2022-2025 Matter.js Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { InternalError } from "#general";
+import { BdxMessageType, BdxStatusCode } from "#types";
+import { BdxError } from "../BdxError.js";
+import { Flow } from "./Flow.js";
+class InboundFlow extends 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 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 === BdxMessageType.BlockEof) {
+      if (this.bytesLeft !== void 0 && this.bytesLeft !== 0) {
+        throw new BdxError(
+          `Received BlockEof with ${this.bytesLeft}bytes left, but no more data available`,
+          this.bytesLeft > 0 ? BdxStatusCode.LengthTooShort : BdxStatusCode.LengthTooLarge
+        );
+      }
+      done = true;
+      writeController.close();
+    }
+    return done;
+  }
+  async close(error) {
+    await super.close(error);
+    await this.#closeStreams?.(error);
+  }
+}
+export {
+  InboundFlow
+};
+//# sourceMappingURL=InboundFlow.js.map

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

@@ -0,0 +1,6 @@
+{
+  "version": 3,
+  "sources": ["../../../../src/bdx/flow/InboundFlow.ts"],
+  "mappings": "AAAA;AAAA;AAAA;AAAA;AAAA;AAMA,SAAgB,qBAAmC;AACnD,SAAS,gBAAgB,qBAAqB;AAC9C,SAAS,gBAAgB;AACzB,SAAS,YAAY;AAKd,MAAe,oBAAoB,KAAK;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,cAAc,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,eAAe,UAAU;AACzC,UAAI,KAAK,cAAc,UAAa,KAAK,cAAc,GAAG;AACtD,cAAM,IAAI;AAAA,UACN,0BAA0B,KAAK,SAAS;AAAA,UACxC,KAAK,YAAY,IAAI,cAAc,iBAAiB,cAAc;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/esm/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/esm/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/esm/bdx/flow/OutboundFlow.js

@@ -0,0 +1,104 @@
+/**
+ * @license
+ * Copyright 2022-2025 Matter.js Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { BytesStreamReader, InternalError } from "#general";
+import { BdxStatusCode } from "#types";
+import { BdxError } from "../BdxError.js";
+import { Flow } from "./Flow.js";
+class OutboundFlow extends Flow {
+  #closeStreams;
+  #iterator;
+  #streamReader;
+  get stream() {
+    if (this.#iterator === void 0 || this.#streamReader === void 0) {
+      throw new 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 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 BdxError(
+          `Data length too short, expected ${blockSize}bytes, but got less`,
+          BdxStatusCode.LengthTooShort
+        );
+      }
+      value = new Uint8Array();
+    } else if (value.byteLength < blockSize) {
+      ({ done = false } = await reader.next());
+      if (!done) {
+        throw new BdxError(
+          `Data length too short, expected ${blockSize}bytes, but got less`,
+          BdxStatusCode.LengthTooShort
+        );
+      }
+    }
+    if (this.bytesLeft !== void 0 && dataLength !== void 0) {
+      this.bytesLeft -= value.byteLength;
+      if (this.bytesLeft < 0) {
+        throw new BdxError(
+          `Data length exceeded, expected ${dataLength}bytes, but got ${-this.bytesLeft}bytes more`,
+          BdxStatusCode.LengthTooLarge
+        );
+      }
+      if (done && this.bytesLeft > 0) {
+        throw new BdxError(
+          `Data length too short, expected ${dataLength}bytes, but got ${this.bytesLeft}bytes less`,
+          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);
+  }
+}
+export {
+  OutboundFlow
+};
+//# sourceMappingURL=OutboundFlow.js.map

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

@@ -0,0 +1,6 @@
+{
+  "version": 3,
+  "sources": ["../../../../src/bdx/flow/OutboundFlow.ts"],
+  "mappings": "AAAA;AAAA;AAAA;AAAA;AAAA;AAMA,SAAS,mBAAmB,qBAAqB;AACjD,SAAS,qBAAqB;AAC9B,SAAS,gBAAgB;AACzB,SAAS,YAAY;AAKd,MAAe,qBAAqB,KAAK;AAAA,EAC5C;AAAA,EACA;AAAA,EACA;AAAA,EAEA,IAAc,SAAS;AACnB,QAAI,KAAK,cAAc,UAAa,KAAK,kBAAkB,QAAW;AAClE,YAAM,IAAI,cAAc,6BAA6B;AAAA,IACzD;AACA,WAAO,EAAE,UAAU,KAAK,WAAW,cAAc,KAAK,cAAc;AAAA,EACxE;AAAA;AAAA;AAAA;AAAA,EAKA,MAAgB,eAAe;AAC3B,UAAM,EAAE,UAAU,IAAI,KAAK;AAE3B,UAAM,OAAO,MAAM,KAAK,mBAAmB,eAAe,SAAS;AACnE,UAAM,WAAW,KAAK;AAGtB,UAAM,EAAE,cAAc,GAAG,aAAa,SAAS,IAAI,KAAK;AAExD,UAAM,WACF,cAAc,KAAK,eAAe,WAAW,KAAK,MAAM,aAAa,cAAc,UAAU,IAAI;AAErG,UAAM,SAAS,SAAS,OAAO;AAE/B,UAAM,SAAS,OAAO,UAAU;AAEhC,SAAK,gBAAgB,OAAO,WAAqB;AAC7C,UAAI,OAAO,QAAQ;AACf,gBAAQ,YAAY;AACpB,YAAI;AACA,gBAAM,QAAQ,OAAO;AAAA,QACzB,SAAS,OAAO;AAEZ,cAAI,EAAE,iBAAiB,YAAY;AAC/B,kBAAM;AAAA,UACV;AAAA,QACJ;AAAA,MACJ;AACA,YAAM,OAAO,OAAO;AAAA,IACxB;AAEA,UAAM,eAAe,IAAI,kBAAkB,MAAM;AACjD,SAAK,YAAY,aAAa,KAAK,SAAS;AAC5C,SAAK,gBAAgB;AAAA,EACzB;AAAA;AAAA;AAAA;AAAA,EAKA,MAAgB,cAAc,QAAoE;AAC9F,UAAM,EAAE,WAAW,WAAW,IAAI,KAAK;AACvC,QAAI,EAAE,OAAO,OAAO,MAAM,IAAI,MAAM,OAAO,KAAK;AAChD,QAAI,UAAU,QAAW;AAErB,UAAI,CAAC,MAAM;AACP,cAAM,IAAI;AAAA,UACN,mCAAmC,SAAS;AAAA,UAC5C,cAAc;AAAA,QAClB;AAAA,MACJ;AACA,cAAQ,IAAI,WAAW;AAAA,IAC3B,WAAW,MAAM,aAAa,WAAW;AAErC,OAAC,EAAE,OAAO,MAAM,IAAI,MAAM,OAAO,KAAK;AACtC,UAAI,CAAC,MAAM;AACP,cAAM,IAAI;AAAA,UACN,mCAAmC,SAAS;AAAA,UAC5C,cAAc;AAAA,QAClB;AAAA,MACJ;AAAA,IACJ;AAEA,QAAI,KAAK,cAAc,UAAa,eAAe,QAAW;AAC1D,WAAK,aAAa,MAAM;AACxB,UAAI,KAAK,YAAY,GAAG;AACpB,cAAM,IAAI;AAAA,UACN,kCAAkC,UAAU,kBAAkB,CAAC,KAAK,SAAS;AAAA,UAC7E,cAAc;AAAA,QAClB;AAAA,MACJ;AACA,UAAI,QAAQ,KAAK,YAAY,GAAG;AAC5B,cAAM,IAAI;AAAA,UACN,mCAAmC,UAAU,kBAAkB,KAAK,SAAS;AAAA,UAC7E,cAAc;AAAA,QAClB;AAAA,MACJ;AACA,UAAI,KAAK,cAAc,GAAG;AACtB,eAAO;AAAA,MACX;AAAA,IACJ;AAEA,WAAO,EAAE,MAAM,OAAO,KAAK;AAAA,EAC/B;AAAA,EAEA,MAAgB,mBAAmB;AAC/B,UAAM,eAAe,KAAK;AAC1B,UAAM,EAAE,cAAc,kBAAkB,IAAI,MAAM,KAAK,UAAU,gBAAgB;AACjF,SAAK,gBAAgB,mBAAmB,YAAY;AAAA,EACxD;AAAA,EAEA,MAAe,MAAM,OAAiB;AAClC,UAAM,MAAM,MAAM,KAAK;AACvB,UAAM,KAAK,gBAAgB,KAAK;AAAA,EACpC;AACJ;",
+  "names": []
+}

package/dist/esm/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/esm/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/esm/bdx/index.js

@@ -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.js.map

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

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

package/dist/esm/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/esm/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"}

package/dist/esm/bdx/schema/BdxAcceptMessagesSchema.js

@@ -0,0 +1,109 @@
+/**
+ * @license
+ * Copyright 2022-2025 Matter.js Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { DataReader, DataWriter, Endian } from "#general";
+import { BdxStatusCode, Schema } from "#types";
+import { BdxError } from "../BdxError.js";
+import {
+  BDX_VERSION,
+  BdxRangeControlSchema,
+  BdxTransferControlSchema
+} from "./BdxInitMessagesSchema.js";
+class BdxSendAcceptMessageSchema extends Schema {
+  encodeInternal(message) {
+    this.validate(message);
+    const { transferControl, maxBlockSize, metaData } = message;
+    const writer = new DataWriter(Endian.Little);
+    writer.writeUInt8(BdxTransferControlSchema.encode(transferControl));
+    writer.writeUInt16(maxBlockSize);
+    if (metaData && metaData.byteLength > 0) {
+      writer.writeByteArray(metaData);
+    }
+    return writer.toByteArray();
+  }
+  decodeInternal(bytes) {
+    const reader = new DataReader(bytes, Endian.Little);
+    const transferControl = BdxTransferControlSchema.decode(reader.readUInt8());
+    const maxBlockSize = reader.readUInt16();
+    const metaData = reader.remainingBytesCount > 0 ? reader.remainingBytes : void 0;
+    const result = {
+      transferControl,
+      maxBlockSize,
+      metaData
+    };
+    this.validate(result);
+    return result;
+  }
+  validate({ transferControl, maxBlockSize }) {
+    if (transferControl.version !== BDX_VERSION) {
+      throw new BdxError(
+        `Unsupported BDX version: ${transferControl.version}`,
+        BdxStatusCode.VersionNotSupported
+      );
+    }
+    if (!transferControl.senderDrive && !transferControl.receiverDrive && !transferControl.asynchronousTransfer) {
+      throw new BdxError(
+        "BDX transfer control need to specify at least one of sender drive, receiver drive or asynchronousTransfer",
+        BdxStatusCode.BadMessageContent
+      );
+    }
+    if (maxBlockSize < 1 || maxBlockSize > 65535) {
+      throw new BdxError("Max Block Size must be between 1 and 65535bytes", BdxStatusCode.BadMessageContent);
+    }
+  }
+}
+const BdxSendAcceptMessage = new BdxSendAcceptMessageSchema();
+class BdxReceiveAcceptMessageSchema extends BdxSendAcceptMessageSchema {
+  encodeInternal(message) {
+    this.validate(message);
+    const { transferControl, maxBlockSize, metaData, length } = message;
+    const rangeControl = {
+      definiteLength: length !== void 0 && length !== 0,
+      wideRange: typeof length === "bigint"
+    };
+    const writer = new DataWriter(Endian.Little);
+    writer.writeUInt8(BdxTransferControlSchema.encode(transferControl));
+    writer.writeUInt8(BdxRangeControlSchema.encode(rangeControl));
+    writer.writeUInt16(maxBlockSize);
+    if (length !== void 0 && length !== 0) {
+      if (rangeControl.wideRange) {
+        writer.writeUInt64(length);
+      } else {
+        writer.writeUInt32(length);
+      }
+    }
+    if (metaData && metaData.byteLength > 0) {
+      writer.writeByteArray(metaData);
+    }
+    return writer.toByteArray();
+  }
+  decodeInternal(bytes) {
+    const reader = new DataReader(bytes, Endian.Little);
+    const transferControl = BdxTransferControlSchema.decode(reader.readUInt8());
+    const rangeControl = BdxRangeControlSchema.decode(reader.readUInt8());
+    const maxBlockSize = reader.readUInt16();
+    let length = rangeControl.definiteLength ? rangeControl.wideRange ? reader.readUInt64() : reader.readUInt32() : void 0;
+    if (length === 0) {
+      length = void 0;
+    }
+    const metaData = reader.remainingBytesCount > 0 ? reader.remainingBytes : void 0;
+    const result = {
+      transferControl,
+      maxBlockSize,
+      metaData,
+      length
+    };
+    this.validate(result);
+    return result;
+  }
+}
+const BdxReceiveAcceptMessage = new BdxReceiveAcceptMessageSchema();
+export {
+  BdxReceiveAcceptMessage,
+  BdxReceiveAcceptMessageSchema,
+  BdxSendAcceptMessage,
+  BdxSendAcceptMessageSchema
+};
+//# sourceMappingURL=BdxAcceptMessagesSchema.js.map

package/dist/esm/bdx/schema/BdxAcceptMessagesSchema.js.map

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

package/dist/esm/bdx/schema/BdxBlockMessagesSchema.d.ts

@@ -0,0 +1,53 @@
+/**
+ * @license
+ * Copyright 2022-2025 Matter.js Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { Bytes } from "#general";
+import { Schema } from "#types";
+interface BdxCounterOnly {
+    blockCounter: number;
+}
+/** @see {@link MatterSpecification.v141.Core}, section 11.22.6.2 */
+export interface BdxBlockQuery extends BdxCounterOnly {
+}
+/** @see {@link MatterSpecification.v141.Core}, section 11.22.6.6 */
+export interface BdxBlockAck extends BdxCounterOnly {
+}
+/** @see {@link MatterSpecification.v141.Core}, section 11.22.6.7 */
+export interface BdxBlockAckEof extends BdxCounterOnly {
+}
+/** @see {@link MatterSpecification.v141.Core}, section 11.22.6.3 */
+export interface BdxBlockQueryWithSkip extends BdxCounterOnly {
+    bytesToSkip: number | bigint;
+}
+/** @see {@link MatterSpecification.v141.Core}, section 11.22.6.4 */
+export interface BdxBlock extends BdxCounterOnly {
+    data: Bytes;
+}
+/** @see {@link MatterSpecification.v141.Core}, section 11.22.6.5 */
+export interface BdxBlockEof extends BdxBlock {
+}
+/** Schema for BDX messages that only contain a block counter: BlockQuery, BlockAck, BlockAckEof. */
+export declare class BdxCounterOnlyMessageSchema extends Schema<BdxCounterOnly> {
+    encodeInternal(message: BdxCounterOnly): Uint8Array<ArrayBufferLike>;
+    decodeInternal(bytes: Bytes): BdxCounterOnly;
+}
+export declare const BdxBlockQueryMessage: BdxCounterOnlyMessageSchema;
+export declare const BdxBlockAckMessage: BdxCounterOnlyMessageSchema;
+export declare const BdxBlockAckEofMessage: BdxCounterOnlyMessageSchema;
+/** Schema for BDX BlockQueryWithSkip message. */
+export declare class BdxBlockQueryWithSkipMessageSchema extends Schema<BdxBlockQueryWithSkip> {
+    encodeInternal(message: BdxBlockQueryWithSkip): Uint8Array<ArrayBufferLike>;
+    decodeInternal(bytes: Bytes): BdxBlockQueryWithSkip;
+}
+export declare const BdxBlockQueryWithSkipMessage: BdxBlockQueryWithSkipMessageSchema;
+/** Schema for BDX Block and BlockEof message that contain Block data. */
+export declare class BdxBlockMessageSchema extends Schema<BdxBlock> {
+    encodeInternal(message: BdxBlock): Uint8Array<ArrayBufferLike>;
+    decodeInternal(bytes: Bytes): BdxBlock;
+}
+export declare const BdxBlockMessage: BdxBlockMessageSchema;
+export declare const BdxBlockEofMessage: BdxBlockMessageSchema;
+export {};
+//# sourceMappingURL=BdxBlockMessagesSchema.d.ts.map

package/dist/esm/bdx/schema/BdxBlockMessagesSchema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"BdxBlockMessagesSchema.d.ts","sourceRoot":"","sources":["../../../../src/bdx/schema/BdxBlockMessagesSchema.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,KAAK,EAAkC,MAAM,UAAU,CAAC;AACjE,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAEhC,UAAU,cAAc;IACpB,YAAY,EAAE,MAAM,CAAC;CACxB;AAED,oEAAoE;AACpE,MAAM,WAAW,aAAc,SAAQ,cAAc;CAAG;AAExD,oEAAoE;AACpE,MAAM,WAAW,WAAY,SAAQ,cAAc;CAAG;AAEtD,oEAAoE;AACpE,MAAM,WAAW,cAAe,SAAQ,cAAc;CAAG;AAEzD,oEAAoE;AACpE,MAAM,WAAW,qBAAsB,SAAQ,cAAc;IACzD,WAAW,EAAE,MAAM,GAAG,MAAM,CAAC;CAChC;AAED,oEAAoE;AACpE,MAAM,WAAW,QAAS,SAAQ,cAAc;IAC5C,IAAI,EAAE,KAAK,CAAC;CACf;AAED,oEAAoE;AACpE,MAAM,WAAW,WAAY,SAAQ,QAAQ;CAAG;AAEhD,oGAAoG;AACpG,qBAAa,2BAA4B,SAAQ,MAAM,CAAC,cAAc,CAAC;IACnE,cAAc,CAAC,OAAO,EAAE,cAAc;IAQtC,cAAc,CAAC,KAAK,EAAE,KAAK,GAAG,cAAc;CAM/C;AAED,eAAO,MAAM,oBAAoB,6BAAwB,CAAC;AAC1D,eAAO,MAAM,kBAAkB,6BAAwB,CAAC;AACxD,eAAO,MAAM,qBAAqB,6BAAwB,CAAC;AAE3D,iDAAiD;AACjD,qBAAa,kCAAmC,SAAQ,MAAM,CAAC,qBAAqB,CAAC;IACjF,cAAc,CAAC,OAAO,EAAE,qBAAqB;IAS7C,cAAc,CAAC,KAAK,EAAE,KAAK,GAAG,qBAAqB;CAOtD;AACD,eAAO,MAAM,4BAA4B,oCAA2C,CAAC;AAErF,yEAAyE;AACzE,qBAAa,qBAAsB,SAAQ,MAAM,CAAC,QAAQ,CAAC;IACvD,cAAc,CAAC,OAAO,EAAE,QAAQ;IAShC,cAAc,CAAC,KAAK,EAAE,KAAK,GAAG,QAAQ;CAOzC;AACD,eAAO,MAAM,eAAe,uBAA8B,CAAC;AAC3D,eAAO,MAAM,kBAAkB,uBAAkB,CAAC"}

package/dist/esm/bdx/schema/BdxBlockMessagesSchema.js

@@ -0,0 +1,72 @@
+/**
+ * @license
+ * Copyright 2022-2025 Matter.js Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { DataReader, DataWriter, Endian } from "#general";
+import { Schema } from "#types";
+class BdxCounterOnlyMessageSchema extends Schema {
+  encodeInternal(message) {
+    const { blockCounter } = message;
+    const writer = new DataWriter(Endian.Little);
+    writer.writeUInt32(blockCounter);
+    return writer.toByteArray();
+  }
+  decodeInternal(bytes) {
+    const reader = new DataReader(bytes, Endian.Little);
+    return {
+      blockCounter: reader.readUInt32()
+    };
+  }
+}
+const BdxCounterOnlyMessage = new BdxCounterOnlyMessageSchema();
+const BdxBlockQueryMessage = BdxCounterOnlyMessage;
+const BdxBlockAckMessage = BdxCounterOnlyMessage;
+const BdxBlockAckEofMessage = BdxCounterOnlyMessage;
+class BdxBlockQueryWithSkipMessageSchema extends Schema {
+  encodeInternal(message) {
+    const { blockCounter, bytesToSkip } = message;
+    const writer = new DataWriter(Endian.Little);
+    writer.writeUInt32(blockCounter);
+    writer.writeUInt64(bytesToSkip);
+    return writer.toByteArray();
+  }
+  decodeInternal(bytes) {
+    const reader = new DataReader(bytes, Endian.Little);
+    return {
+      blockCounter: reader.readUInt32(),
+      bytesToSkip: reader.readUInt64()
+    };
+  }
+}
+const BdxBlockQueryWithSkipMessage = new BdxBlockQueryWithSkipMessageSchema();
+class BdxBlockMessageSchema extends Schema {
+  encodeInternal(message) {
+    const { blockCounter, data } = message;
+    const writer = new DataWriter(Endian.Little);
+    writer.writeUInt32(blockCounter);
+    writer.writeByteArray(data);
+    return writer.toByteArray();
+  }
+  decodeInternal(bytes) {
+    const reader = new DataReader(bytes, Endian.Little);
+    return {
+      blockCounter: reader.readUInt32(),
+      data: reader.remainingBytes
+    };
+  }
+}
+const BdxBlockMessage = new BdxBlockMessageSchema();
+const BdxBlockEofMessage = BdxBlockMessage;
+export {
+  BdxBlockAckEofMessage,
+  BdxBlockAckMessage,
+  BdxBlockEofMessage,
+  BdxBlockMessage,
+  BdxBlockMessageSchema,
+  BdxBlockQueryMessage,
+  BdxBlockQueryWithSkipMessage,
+  BdxBlockQueryWithSkipMessageSchema,
+  BdxCounterOnlyMessageSchema
+};
+//# sourceMappingURL=BdxBlockMessagesSchema.js.map

package/dist/esm/bdx/schema/BdxBlockMessagesSchema.js.map

@@ -0,0 +1,6 @@
+{
+  "version": 3,
+  "sources": ["../../../../src/bdx/schema/BdxBlockMessagesSchema.ts"],
+  "mappings": "AAAA;AAAA;AAAA;AAAA;AAAA;AAMA,SAAgB,YAAY,YAAY,cAAc;AACtD,SAAS,cAAc;AA6BhB,MAAM,oCAAoC,OAAuB;AAAA,EACpE,eAAe,SAAyB;AACpC,UAAM,EAAE,aAAa,IAAI;AAEzB,UAAM,SAAS,IAAI,WAAW,OAAO,MAAM;AAC3C,WAAO,YAAY,YAAY;AAC/B,WAAO,OAAO,YAAY;AAAA,EAC9B;AAAA,EAEA,eAAe,OAA8B;AACzC,UAAM,SAAS,IAAI,WAAW,OAAO,OAAO,MAAM;AAClD,WAAO;AAAA,MACH,cAAc,OAAO,WAAW;AAAA,IACpC;AAAA,EACJ;AACJ;AACA,MAAM,wBAAwB,IAAI,4BAA4B;AACvD,MAAM,uBAAuB;AAC7B,MAAM,qBAAqB;AAC3B,MAAM,wBAAwB;AAG9B,MAAM,2CAA2C,OAA8B;AAAA,EAClF,eAAe,SAAgC;AAC3C,UAAM,EAAE,cAAc,YAAY,IAAI;AAEtC,UAAM,SAAS,IAAI,WAAW,OAAO,MAAM;AAC3C,WAAO,YAAY,YAAY;AAC/B,WAAO,YAAY,WAAW;AAC9B,WAAO,OAAO,YAAY;AAAA,EAC9B;AAAA,EAEA,eAAe,OAAqC;AAChD,UAAM,SAAS,IAAI,WAAW,OAAO,OAAO,MAAM;AAClD,WAAO;AAAA,MACH,cAAc,OAAO,WAAW;AAAA,MAChC,aAAa,OAAO,WAAW;AAAA,IACnC;AAAA,EACJ;AACJ;AACO,MAAM,+BAA+B,IAAI,mCAAmC;AAG5E,MAAM,8BAA8B,OAAiB;AAAA,EACxD,eAAe,SAAmB;AAC9B,UAAM,EAAE,cAAc,KAAK,IAAI;AAE/B,UAAM,SAAS,IAAI,WAAW,OAAO,MAAM;AAC3C,WAAO,YAAY,YAAY;AAC/B,WAAO,eAAe,IAAI;AAC1B,WAAO,OAAO,YAAY;AAAA,EAC9B;AAAA,EAEA,eAAe,OAAwB;AACnC,UAAM,SAAS,IAAI,WAAW,OAAO,OAAO,MAAM;AAClD,WAAO;AAAA,MACH,cAAc,OAAO,WAAW;AAAA,MAChC,MAAM,OAAO;AAAA,IACjB;AAAA,EACJ;AACJ;AACO,MAAM,kBAAkB,IAAI,sBAAsB;AAClD,MAAM,qBAAqB;",
+  "names": []
+}