@matter/general 0.16.0-alpha.0-20251107-6bcb5baf4 → 0.16.0-alpha.0-20251110-c4c70a41b

package/dist/cjs/net/Channel.d.ts

@@ -14,6 +14,8 @@ export interface Channel<T> {
     maxPayloadSize: number;
     /** Is the transport Reliable? UDP is not, TCP and BTP are. */
     isReliable: boolean;
+    /** Does the channel support large messages? */
+    supportsLargeMessages: boolean;
     /** Channel name */
     name: string;
     type: ChannelType;

package/dist/cjs/net/Channel.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Channel.d.ts","sourceRoot":"","sources":["../../../src/net/Channel.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAGzD,oBAAY,WAAW;IACnB,GAAG,QAAQ;IACX,GAAG,QAAQ;IACX,GAAG,QAAQ;CACd;AAED,MAAM,WAAW,OAAO,CAAC,CAAC;IACtB,4CAA4C;IAC5C,cAAc,EAAE,MAAM,CAAC;IAEvB,8DAA8D;IAC9D,UAAU,EAAE,OAAO,CAAC;IAEpB,mBAAmB;IACnB,IAAI,EAAE,MAAM,CAAC;IAEb,IAAI,EAAE,WAAW,CAAC;IAElB,iDAAiD;IACjD,IAAI,CAAC,IAAI,EAAE,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAE7B,kCAAkC;IAClC,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CAC1B;AAED,MAAM,WAAW,gBAAgB,CAAC,CAAC,CAAE,SAAQ,OAAO,CAAC,CAAC,CAAC;IACnD,cAAc,EAAE,gBAAgB,CAAC;CACpC;AAED,wBAAgB,kBAAkB,CAAC,CAAC,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,IAAI,gBAAgB,CAAC,CAAC,CAAC,CAEzF"}
+{"version":3,"file":"Channel.d.ts","sourceRoot":"","sources":["../../../src/net/Channel.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAGzD,oBAAY,WAAW;IACnB,GAAG,QAAQ;IACX,GAAG,QAAQ;IACX,GAAG,QAAQ;CACd;AAED,MAAM,WAAW,OAAO,CAAC,CAAC;IACtB,4CAA4C;IAC5C,cAAc,EAAE,MAAM,CAAC;IAEvB,8DAA8D;IAC9D,UAAU,EAAE,OAAO,CAAC;IAEpB,+CAA+C;IAC/C,qBAAqB,EAAE,OAAO,CAAC;IAE/B,mBAAmB;IACnB,IAAI,EAAE,MAAM,CAAC;IAEb,IAAI,EAAE,WAAW,CAAC;IAElB,iDAAiD;IACjD,IAAI,CAAC,IAAI,EAAE,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAE7B,kCAAkC;IAClC,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CAC1B;AAED,MAAM,WAAW,gBAAgB,CAAC,CAAC,CAAE,SAAQ,OAAO,CAAC,CAAC,CAAC;IACnD,cAAc,EAAE,gBAAgB,CAAC;CACpC;AAED,wBAAgB,kBAAkB,CAAC,CAAC,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,IAAI,gBAAgB,CAAC,CAAC,CAAC,CAEzF"}

package/dist/cjs/net/Channel.js.map

@@ -1,6 +1,6 @@
 {
   "version": 3,
   "sources": ["../../../src/net/Channel.ts"],
-  "mappings": ";;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAMA,kBAAyB;AANzB;AAAA;AAAA;AAAA;AAAA;AAQO,IAAK,cAAL,kBAAKA,iBAAL;AACH,EAAAA,aAAA,SAAM;AACN,EAAAA,aAAA,SAAM;AACN,EAAAA,aAAA,SAAM;AAHE,SAAAA;AAAA,GAAA;AA6BL,SAAS,mBAAsB,SAAqD;AACvF,aAAO,sBAAU,QAAgC,cAAc;AACnE;",
+  "mappings": ";;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAMA,kBAAyB;AANzB;AAAA;AAAA;AAAA;AAAA;AAQO,IAAK,cAAL,kBAAKA,iBAAL;AACH,EAAAA,aAAA,SAAM;AACN,EAAAA,aAAA,SAAM;AACN,EAAAA,aAAA,SAAM;AAHE,SAAAA;AAAA,GAAA;AAgCL,SAAS,mBAAsB,SAAqD;AACvF,aAAO,sBAAU,QAAgC,cAAc;AACnE;",
   "names": ["ChannelType"]
 }

package/dist/cjs/net/udp/UdpInterface.d.ts

@@ -25,6 +25,7 @@ export declare class UdpInterface implements ConnectionlessTransport {
 export declare class UdpConnection implements IpNetworkChannel<Bytes> {
     #private;
     readonly isReliable = false;
+    readonly supportsLargeMessages = false;
     readonly type = ChannelType.UDP;
     constructor(server: UdpChannel, peerAddress: string, peerPort: number);
     get maxPayloadSize(): number;

package/dist/cjs/net/udp/UdpInterface.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"UdpInterface.d.ts","sourceRoot":"","sources":["../../../../src/net/udp/UdpInterface.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,OAAO,EAAE,WAAW,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AACzE,OAAO,EAAE,uBAAuB,EAAE,MAAM,iCAAiC,CAAC;AAC1E,OAAO,EAAE,OAAO,EAAgB,MAAM,iBAAiB,CAAC;AACxD,OAAO,EAAE,KAAK,EAAE,MAAM,gBAAgB,CAAC;AACvC,OAAO,EAAE,aAAa,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AACtE,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAE7C,qBAAa,YAAa,YAAW,uBAAuB;;WAG3C,MAAM,CAAC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,EAAE,YAAY,CAAC,EAAE,MAAM;gBAMpG,MAAM,EAAE,UAAU;IAI9B,SAAS,KAAK,MAAM,eAEnB;IAED,QAAQ,CAAC,IAAI,EAAE,WAAW,EAAE,OAAO,EAAE,MAAM;IAIrC,WAAW,CAAC,OAAO,EAAE,aAAa;IAQxC,MAAM,CAAC,QAAQ,EAAE,CAAC,OAAO,EAAE,OAAO,CAAC,KAAK,CAAC,EAAE,YAAY,EAAE,KAAK,KAAK,IAAI,GAAG,uBAAuB,CAAC,QAAQ;IAM1G,IAAI,IAAI,WAEP;IAED,KAAK;IAIL,aAAa,CAAC,OAAO,EAAE,MAAM;IAI7B,cAAc,CAAC,OAAO,EAAE,MAAM;CAGjC;AAED,qBAAa,aAAc,YAAW,gBAAgB,CAAC,KAAK,CAAC;;IACzD,QAAQ,CAAC,UAAU,SAAS;IAC5B,QAAQ,CAAC,IAAI,mBAAmB;gBAKpB,MAAM,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM;IAMrE,IAAI,cAAc,WAEjB;IAED,IAAI,CAAC,IAAI,EAAE,KAAK;IAIhB,IAAI,IAAI,WAEP;IAED,IAAI,cAAc,IAAI,gBAAgB,CAErC;IAEK,KAAK;CAGd"}
+{"version":3,"file":"UdpInterface.d.ts","sourceRoot":"","sources":["../../../../src/net/udp/UdpInterface.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,OAAO,EAAE,WAAW,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AACzE,OAAO,EAAE,uBAAuB,EAAE,MAAM,iCAAiC,CAAC;AAC1E,OAAO,EAAE,OAAO,EAAgB,MAAM,iBAAiB,CAAC;AACxD,OAAO,EAAE,KAAK,EAAE,MAAM,gBAAgB,CAAC;AACvC,OAAO,EAAE,aAAa,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AACtE,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAE7C,qBAAa,YAAa,YAAW,uBAAuB;;WAG3C,MAAM,CAAC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,EAAE,YAAY,CAAC,EAAE,MAAM;gBAMpG,MAAM,EAAE,UAAU;IAI9B,SAAS,KAAK,MAAM,eAEnB;IAED,QAAQ,CAAC,IAAI,EAAE,WAAW,EAAE,OAAO,EAAE,MAAM;IAIrC,WAAW,CAAC,OAAO,EAAE,aAAa;IAQxC,MAAM,CAAC,QAAQ,EAAE,CAAC,OAAO,EAAE,OAAO,CAAC,KAAK,CAAC,EAAE,YAAY,EAAE,KAAK,KAAK,IAAI,GAAG,uBAAuB,CAAC,QAAQ;IAM1G,IAAI,IAAI,WAEP;IAED,KAAK;IAIL,aAAa,CAAC,OAAO,EAAE,MAAM;IAI7B,cAAc,CAAC,OAAO,EAAE,MAAM;CAGjC;AAED,qBAAa,aAAc,YAAW,gBAAgB,CAAC,KAAK,CAAC;;IACzD,QAAQ,CAAC,UAAU,SAAS;IAC5B,QAAQ,CAAC,qBAAqB,SAAS;IACvC,QAAQ,CAAC,IAAI,mBAAmB;gBAKpB,MAAM,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM;IAMrE,IAAI,cAAc,WAEjB;IAED,IAAI,CAAC,IAAI,EAAE,KAAK;IAIhB,IAAI,IAAI,WAEP;IAED,IAAI,cAAc,IAAI,gBAAgB,CAErC;IAEK,KAAK;CAGd"}

package/dist/cjs/net/udp/UdpInterface.js

@@ -72,6 +72,7 @@ class UdpInterface {
 }
 class UdpConnection {
   isReliable = false;
+  supportsLargeMessages = false;
   type = import_Channel.ChannelType.UDP;
   #server;
   #peerAddress;

package/dist/cjs/net/udp/UdpInterface.js.map

@@ -1,6 +1,6 @@
 {
   "version": 3,
   "sources": ["../../../../src/net/udp/UdpInterface.ts"],
-  "mappings": ";;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAMA,qBAAuD;AAEvD,qBAAsC;AARtC;AAAA;AAAA;AAAA;AAAA;AAaO,MAAM,aAAgD;AAAA,EAChD;AAAA,EAET,aAAa,OAAO,SAAkB,MAAuB,MAAe,MAAe,cAAuB;AAC9G,WAAO,IAAI;AAAA,MACP,MAAM,QAAQ,iBAAiB,EAAE,eAAe,MAAM,MAAM,cAAc,kBAAkB,KAAK,CAAC;AAAA,IACtG;AAAA,EACJ;AAAA,EAEA,YAAY,QAAoB;AAC5B,SAAK,UAAU;AAAA,EACnB;AAAA,EAEA,IAAc,SAAS;AACnB,WAAO,KAAK;AAAA,EAChB;AAAA,EAEA,SAAS,MAAmB,SAAiB;AACzC,WAAO,KAAK,QAAQ,SAAS,MAAM,OAAO;AAAA,EAC9C;AAAA,EAEA,MAAM,YAAY,SAAwB;AACtC,QAAI,QAAQ,SAAS,OAAO;AACxB,YAAM,IAAI,4BAAa,4BAA4B,QAAQ,IAAI,EAAE;AAAA,IACrE;AACA,UAAM,EAAE,IAAI,KAAK,IAAI;AACrB,WAAO,QAAQ,QAAQ,IAAI,cAAc,KAAK,SAAS,IAAI,IAAI,CAAC;AAAA,EACpE;AAAA,EAEA,OAAO,UAAoG;AACvG,WAAO,KAAK,QAAQ;AAAA,MAAO,CAAC,eAAe,UAAU,UAAU,SAC3D,SAAS,IAAI,cAAc,KAAK,SAAS,UAAU,QAAQ,GAAG,IAAI;AAAA,IACtE;AAAA,EACJ;AAAA,EAEA,IAAI,OAAO;AACP,WAAO,KAAK,QAAQ;AAAA,EACxB;AAAA,EAEA,QAAQ;AACJ,WAAO,KAAK,QAAQ,MAAM;AAAA,EAC9B;AAAA,EAEA,cAAc,SAAiB;AAC3B,WAAO,KAAK,QAAQ,cAAc,OAAO;AAAA,EAC7C;AAAA,EAEA,eAAe,SAAiB;AAC5B,WAAO,KAAK,QAAQ,eAAe,OAAO;AAAA,EAC9C;AACJ;AAEO,MAAM,cAAiD;AAAA,EACjD,aAAa;AAAA,EACb,OAAO,2BAAY;AAAA,EACnB;AAAA,EACA;AAAA,EACA;AAAA,EAET,YAAY,QAAoB,aAAqB,UAAkB;AACnE,SAAK,UAAU;AACf,SAAK,eAAe;AACpB,SAAK,YAAY;AAAA,EACrB;AAAA,EAEA,IAAI,iBAAiB;AACjB,WAAO,KAAK,QAAQ;AAAA,EACxB;AAAA,EAEA,KAAK,MAAa;AACd,WAAO,KAAK,QAAQ,KAAK,KAAK,cAAc,KAAK,WAAW,IAAI;AAAA,EACpE;AAAA,EAEA,IAAI,OAAO;AACP,WAAO,GAAG,KAAK,IAAI,OAAO,KAAK,YAAY,KAAK,KAAK,SAAS;AAAA,EAClE;AAAA,EAEA,IAAI,iBAAmC;AACnC,WAAO,EAAE,MAAM,OAAO,IAAI,KAAK,cAAc,MAAM,KAAK,UAAU;AAAA,EACtE;AAAA,EAEA,MAAM,QAAQ;AAAA,EAEd;AACJ;",
+  "mappings": ";;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAMA,qBAAuD;AAEvD,qBAAsC;AARtC;AAAA;AAAA;AAAA;AAAA;AAaO,MAAM,aAAgD;AAAA,EAChD;AAAA,EAET,aAAa,OAAO,SAAkB,MAAuB,MAAe,MAAe,cAAuB;AAC9G,WAAO,IAAI;AAAA,MACP,MAAM,QAAQ,iBAAiB,EAAE,eAAe,MAAM,MAAM,cAAc,kBAAkB,KAAK,CAAC;AAAA,IACtG;AAAA,EACJ;AAAA,EAEA,YAAY,QAAoB;AAC5B,SAAK,UAAU;AAAA,EACnB;AAAA,EAEA,IAAc,SAAS;AACnB,WAAO,KAAK;AAAA,EAChB;AAAA,EAEA,SAAS,MAAmB,SAAiB;AACzC,WAAO,KAAK,QAAQ,SAAS,MAAM,OAAO;AAAA,EAC9C;AAAA,EAEA,MAAM,YAAY,SAAwB;AACtC,QAAI,QAAQ,SAAS,OAAO;AACxB,YAAM,IAAI,4BAAa,4BAA4B,QAAQ,IAAI,EAAE;AAAA,IACrE;AACA,UAAM,EAAE,IAAI,KAAK,IAAI;AACrB,WAAO,QAAQ,QAAQ,IAAI,cAAc,KAAK,SAAS,IAAI,IAAI,CAAC;AAAA,EACpE;AAAA,EAEA,OAAO,UAAoG;AACvG,WAAO,KAAK,QAAQ;AAAA,MAAO,CAAC,eAAe,UAAU,UAAU,SAC3D,SAAS,IAAI,cAAc,KAAK,SAAS,UAAU,QAAQ,GAAG,IAAI;AAAA,IACtE;AAAA,EACJ;AAAA,EAEA,IAAI,OAAO;AACP,WAAO,KAAK,QAAQ;AAAA,EACxB;AAAA,EAEA,QAAQ;AACJ,WAAO,KAAK,QAAQ,MAAM;AAAA,EAC9B;AAAA,EAEA,cAAc,SAAiB;AAC3B,WAAO,KAAK,QAAQ,cAAc,OAAO;AAAA,EAC7C;AAAA,EAEA,eAAe,SAAiB;AAC5B,WAAO,KAAK,QAAQ,eAAe,OAAO;AAAA,EAC9C;AACJ;AAEO,MAAM,cAAiD;AAAA,EACjD,aAAa;AAAA,EACb,wBAAwB;AAAA,EACxB,OAAO,2BAAY;AAAA,EACnB;AAAA,EACA;AAAA,EACA;AAAA,EAET,YAAY,QAAoB,aAAqB,UAAkB;AACnE,SAAK,UAAU;AACf,SAAK,eAAe;AACpB,SAAK,YAAY;AAAA,EACrB;AAAA,EAEA,IAAI,iBAAiB;AACjB,WAAO,KAAK,QAAQ;AAAA,EACxB;AAAA,EAEA,KAAK,MAAa;AACd,WAAO,KAAK,QAAQ,KAAK,KAAK,cAAc,KAAK,WAAW,IAAI;AAAA,EACpE;AAAA,EAEA,IAAI,OAAO;AACP,WAAO,GAAG,KAAK,IAAI,OAAO,KAAK,YAAY,KAAK,KAAK,SAAS;AAAA,EAClE;AAAA,EAEA,IAAI,iBAAmC;AACnC,WAAO,EAAE,MAAM,OAAO,IAAI,KAAK,cAAc,MAAM,KAAK,UAAU;AAAA,EACtE;AAAA,EAEA,MAAM,QAAQ;AAAA,EAEd;AACJ;",
   "names": []
 }

package/dist/cjs/util/Mutex.d.ts

@@ -3,12 +3,20 @@
  * Copyright 2022-2025 Matter.js Authors
  * SPDX-License-Identifier: Apache-2.0
  */
+import { MatterError } from "#MatterError.js";
+export declare class MutexClosedError extends MatterError {
+    constructor();
+}
 /**
  * A mutex is a task queue where at most one task is active at a time.
  */
 export declare class Mutex implements PromiseLike<unknown> {
     #private;
     constructor(owner: {}, initial?: PromiseLike<unknown>);
+    /**
+     * Prevent new tasks and wait for remaining tasks to complete.
+     */
+    close(): Promise<void>;
     /**
      * As a PromiseLike, you can await the Mutex.  This promise resolves when current activity completes but the mutex
      * may engage in another activity immediately thereafter.  So the mutex is not guaranteed to be available after an
@@ -21,15 +29,23 @@ export declare class Mutex implements PromiseLike<unknown> {
      * If {@link task} is a function it runs when current activity completes.  If it is a promise then the mutex will
      * not clear until {@link task} resolves.
      */
-    run(task: PromiseLike<unknown> | (() => PromiseLike<unknown>), cancel?: () => void): void;
+    run(task: PromiseLike<unknown> | (() => PromiseLike<unknown>)): void;
     /**
      * Enqueue work with an awaitable result.
      */
-    produce<T>(task: () => PromiseLike<T>, cancel?: () => void): Promise<T>;
+    produce<T>(task: () => PromiseLike<T>): Promise<T>;
     /**
-     * Cancel remaining work and perform one last task with the Mutex held.
+     * Acquire the lock.
+     *
+     * This offers more natural mutex handling via a disposable.  The returned object must be disposed to unlock the
+     * mutex.
+     *
+     * Note that acquiring the lock is async but releasing is not, so you must use `using _lock = await mutex.lock()`
+     * rather than `await using _lock = mutex.lock()`.
+     *
+     * TODO - add abort support
      */
-    terminate(cleanup?: () => PromiseLike<void>): void;
+    lock(): Promise<Disposable>;
     /**
      * Activate a task.
      */

package/dist/cjs/util/Mutex.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Mutex.d.ts","sourceRoot":"","sources":["../../../src/util/Mutex.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAOH;;GAEG;AACH,qBAAa,KAAM,YAAW,WAAW,CAAC,OAAO,CAAC;;gBAMlC,KAAK,EAAE,EAAE,EAAE,OAAO,CAAC,EAAE,WAAW,CAAC,OAAO,CAAC;IAOrD;;;;OAIG;IACH,IAAI,CAAC,QAAQ,GAAG,IAAI,EAAE,QAAQ,GAAG,KAAK,EAClC,WAAW,CAAC,EAAE,CAAC,CAAC,KAAK,EAAE,OAAO,KAAK,QAAQ,GAAG,WAAW,CAAC,QAAQ,CAAC,CAAC,GAAG,IAAI,EAC3E,UAAU,CAAC,EAAE,CAAC,CAAC,MAAM,EAAE,GAAG,KAAK,QAAQ,GAAG,WAAW,CAAC,QAAQ,CAAC,CAAC,GAAG,IAAI,GACxE,WAAW,CAAC,QAAQ,GAAG,QAAQ,CAAC;IAInC;;;;;OAKG;IACH,GAAG,CAAC,IAAI,EAAE,WAAW,CAAC,OAAO,CAAC,GAAG,CAAC,MAAM,WAAW,CAAC,OAAO,CAAC,CAAC,EAAE,MAAM,CAAC,EAAE,MAAM,IAAI;IAuBlF;;OAEG;IACH,OAAO,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC,CAAC,CAAC,EAAE,MAAM,CAAC,EAAE,MAAM,IAAI,GAAG,OAAO,CAAC,CAAC,CAAC;IAYvE;;OAEG;IACH,SAAS,CAAC,OAAO,CAAC,EAAE,MAAM,WAAW,CAAC,IAAI,CAAC;IAoB3C;;OAEG;cACa,YAAY,CAAC,IAAI,EAAE,WAAW,CAAC,OAAO,CAAC,GAAG,CAAC,MAAM,WAAW,CAAC,OAAO,CAAC,CAAC;CAMzF"}
+{"version":3,"file":"Mutex.d.ts","sourceRoot":"","sources":["../../../src/util/Mutex.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAM9C,qBAAa,gBAAiB,SAAQ,WAAW;;CAIhD;AAED;;GAEG;AACH,qBAAa,KAAM,YAAW,WAAW,CAAC,OAAO,CAAC;;gBAKlC,KAAK,EAAE,EAAE,EAAE,OAAO,CAAC,EAAE,WAAW,CAAC,OAAO,CAAC;IAOrD;;OAEG;IACG,KAAK;IAKX;;;;OAIG;IACH,IAAI,CAAC,QAAQ,GAAG,IAAI,EAAE,QAAQ,GAAG,KAAK,EAClC,WAAW,CAAC,EAAE,CAAC,CAAC,KAAK,EAAE,OAAO,KAAK,QAAQ,GAAG,WAAW,CAAC,QAAQ,CAAC,CAAC,GAAG,IAAI,EAC3E,UAAU,CAAC,EAAE,CAAC,CAAC,MAAM,EAAE,GAAG,KAAK,QAAQ,GAAG,WAAW,CAAC,QAAQ,CAAC,CAAC,GAAG,IAAI,GACxE,WAAW,CAAC,QAAQ,GAAG,QAAQ,CAAC;IAInC;;;;;OAKG;IACH,GAAG,CAAC,IAAI,EAAE,WAAW,CAAC,OAAO,CAAC,GAAG,CAAC,MAAM,WAAW,CAAC,OAAO,CAAC,CAAC;IAc7D;;OAEG;IACH,OAAO,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC;IAgBlD;;;;;;;;;;OAUG;IACG,IAAI,IAAI,OAAO,CAAC,UAAU,CAAC;IAgBjC;;OAEG;cACa,YAAY,CAAC,IAAI,EAAE,WAAW,CAAC,OAAO,CAAC,GAAG,CAAC,MAAM,WAAW,CAAC,OAAO,CAAC,CAAC;CAMzF"}

package/dist/cjs/util/Mutex.js

@@ -18,9 +18,11 @@ var __copyProps = (to, from, except, desc) => {
 var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
 var Mutex_exports = {};
 __export(Mutex_exports, {
-  Mutex: () => Mutex
+  Mutex: () => Mutex,
+  MutexClosedError: () => MutexClosedError
 });
 module.exports = __toCommonJS(Mutex_exports);
+var import_MatterError = require("#MatterError.js");
 var import_Logger = require("../log/Logger.js");
 var import_Error = require("./Error.js");
 /**
@@ -29,10 +31,14 @@ var import_Error = require("./Error.js");
  * SPDX-License-Identifier: Apache-2.0
  */
 const logger = import_Logger.Logger.get("Mutex");
+class MutexClosedError extends import_MatterError.MatterError {
+  constructor() {
+    super("Cannot schedule task because mutex is closed");
+  }
+}
 class Mutex {
   #owner;
-  #cancel;
-  #canceled = false;
+  #closed = false;
   #promise;
   constructor(owner, initial) {
     this.#owner = owner;
@@ -40,6 +46,13 @@ class Mutex {
       this.run(() => initial);
     }
   }
+  /**
+   * Prevent new tasks and wait for remaining tasks to complete.
+   */
+  async close() {
+    this.#closed = true;
+    await this.#promise;
+  }
   /**
    * As a PromiseLike, you can await the Mutex.  This promise resolves when current activity completes but the mutex
    * may engage in another activity immediately thereafter.  So the mutex is not guaranteed to be available after an
@@ -54,30 +67,25 @@ class Mutex {
    * If {@link task} is a function it runs when current activity completes.  If it is a promise then the mutex will
    * not clear until {@link task} resolves.
    */
-  run(task, cancel) {
-    if (this.#canceled) {
-      cancel?.();
-      return;
+  run(task) {
+    if (this.#closed) {
+      throw new MutexClosedError();
     }
     if (!this.#promise) {
       this.#promise = this.initiateTask(task);
     } else {
       this.#promise = this.#promise.then(() => {
-        if (this.#canceled) {
-          cancel?.();
-          return;
-        }
-        this.#cancel = cancel;
-        return this.initiateTask(task).finally(() => {
-          this.#cancel = void 0;
-        });
+        return this.initiateTask(task);
       });
     }
   }
   /**
    * Enqueue work with an awaitable result.
    */
-  produce(task, cancel) {
+  produce(task) {
+    if (this.#closed) {
+      throw new MutexClosedError();
+    }
     return new Promise((resolve, reject) => {
       this.run(async () => {
         try {
@@ -85,27 +93,33 @@ class Mutex {
         } catch (e) {
           reject((0, import_Error.asError)(e));
         }
-      }, cancel);
+      });
     });
   }
   /**
-   * Cancel remaining work and perform one last task with the Mutex held.
+   * Acquire the lock.
+   *
+   * This offers more natural mutex handling via a disposable.  The returned object must be disposed to unlock the
+   * mutex.
+   *
+   * Note that acquiring the lock is async but releasing is not, so you must use `using _lock = await mutex.lock()`
+   * rather than `await using _lock = mutex.lock()`.
+   *
+   * TODO - add abort support
    */
-  terminate(cleanup) {
-    if (this.#canceled) {
-      return;
-    }
-    this.#canceled = true;
-    if (this.#cancel) {
-      this.#cancel();
-    }
-    if (cleanup) {
-      if (!this.#promise) {
-        this.#promise = this.initiateTask(cleanup);
-      } else {
-        this.#promise = this.#promise.then(() => this.initiateTask(cleanup));
-      }
+  async lock() {
+    if (this.#closed) {
+      throw new MutexClosedError();
     }
+    return new Promise((lockObtained) => {
+      this.run(async () => {
+        await new Promise((lockReleased) => {
+          lockObtained({
+            [Symbol.dispose]: lockReleased
+          });
+        });
+      });
+    });
   }
   /**
    * Activate a task.

package/dist/cjs/util/Mutex.js.map

@@ -1,6 +1,6 @@
 {
   "version": 3,
   "sources": ["../../../src/util/Mutex.ts"],
-  "mappings": ";;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAMA,oBAAuB;AACvB,mBAAwB;AAPxB;AAAA;AAAA;AAAA;AAAA;AASA,MAAM,SAAS,qBAAO,IAAI,OAAO;AAK1B,MAAM,MAAsC;AAAA,EAC/C;AAAA,EACA;AAAA,EACA,YAAY;AAAA,EACZ;AAAA,EAEA,YAAY,OAAW,SAAgC;AACnD,SAAK,SAAS;AACd,QAAI,SAAS;AACT,WAAK,IAAI,MAAM,OAAO;AAAA,IAC1B;AAAA,EACJ;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAOA,KACI,aACA,YACgC;AAChC,YAAQ,KAAK,YAAY,QAAQ,QAAQ,GAAG,KAAK,aAAa,UAAU;AAAA,EAC5E;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAQA,IAAI,MAA2D,QAAqB;AAChF,QAAI,KAAK,WAAW;AAChB,eAAS;AACT;AAAA,IACJ;AAEA,QAAI,CAAC,KAAK,UAAU;AAChB,WAAK,WAAW,KAAK,aAAa,IAAI;AAAA,IAC1C,OAAO;AACH,WAAK,WAAW,KAAK,SAAS,KAAK,MAAM;AACrC,YAAI,KAAK,WAAW;AAChB,mBAAS;AACT;AAAA,QACJ;AAEA,aAAK,UAAU;AACf,eAAO,KAAK,aAAa,IAAI,EAAE,QAAQ,MAAM;AACzC,eAAK,UAAU;AAAA,QACnB,CAAC;AAAA,MACL,CAAC;AAAA,IACL;AAAA,EACJ;AAAA;AAAA;AAAA;AAAA,EAKA,QAAW,MAA4B,QAAiC;AACpE,WAAO,IAAI,QAAW,CAAC,SAAS,WAAW;AACvC,WAAK,IAAI,YAAY;AACjB,YAAI;AACA,kBAAQ,MAAM,KAAK,CAAC;AAAA,QACxB,SAAS,GAAG;AACR,qBAAO,sBAAQ,CAAC,CAAC;AAAA,QACrB;AAAA,MACJ,GAAG,MAAM;AAAA,IACb,CAAC;AAAA,EACL;AAAA;AAAA;AAAA;AAAA,EAKA,UAAU,SAAmC;AACzC,QAAI,KAAK,WAAW;AAChB;AAAA,IACJ;AAEA,SAAK,YAAY;AAEjB,QAAI,KAAK,SAAS;AACd,WAAK,QAAQ;AAAA,IACjB;AAEA,QAAI,SAAS;AACT,UAAI,CAAC,KAAK,UAAU;AAChB,aAAK,WAAW,KAAK,aAAa,OAAO;AAAA,MAC7C,OAAO;AACH,aAAK,WAAW,KAAK,SAAS,KAAK,MAAM,KAAK,aAAa,OAAO,CAAC;AAAA,MACvE;AAAA,IACJ;AAAA,EACJ;AAAA;AAAA;AAAA;AAAA,EAKA,MAAgB,aAAa,MAA2D;AACpF,QAAI,OAAO,SAAS,YAAY;AAC5B,aAAO,KAAK;AAAA,IAChB;AACA,WAAO,QAAQ,QAAQ,IAAI,EAAE,MAAM,WAAS,OAAO,MAAM,sBAAsB,KAAK,MAAM,YAAY,KAAK,CAAC;AAAA,EAChH;AACJ;",
+  "mappings": ";;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAMA,yBAA4B;AAC5B,oBAAuB;AACvB,mBAAwB;AARxB;AAAA;AAAA;AAAA;AAAA;AAUA,MAAM,SAAS,qBAAO,IAAI,OAAO;AAE1B,MAAM,yBAAyB,+BAAY;AAAA,EAC9C,cAAc;AACV,UAAM,8CAA8C;AAAA,EACxD;AACJ;AAKO,MAAM,MAAsC;AAAA,EAC/C;AAAA,EACA,UAAU;AAAA,EACV;AAAA,EAEA,YAAY,OAAW,SAAgC;AACnD,SAAK,SAAS;AACd,QAAI,SAAS;AACT,WAAK,IAAI,MAAM,OAAO;AAAA,IAC1B;AAAA,EACJ;AAAA;AAAA;AAAA;AAAA,EAKA,MAAM,QAAQ;AACV,SAAK,UAAU;AACf,UAAM,KAAK;AAAA,EACf;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAOA,KACI,aACA,YACgC;AAChC,YAAQ,KAAK,YAAY,QAAQ,QAAQ,GAAG,KAAK,aAAa,UAAU;AAAA,EAC5E;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAQA,IAAI,MAA2D;AAC3D,QAAI,KAAK,SAAS;AACd,YAAM,IAAI,iBAAiB;AAAA,IAC/B;AAEA,QAAI,CAAC,KAAK,UAAU;AAChB,WAAK,WAAW,KAAK,aAAa,IAAI;AAAA,IAC1C,OAAO;AACH,WAAK,WAAW,KAAK,SAAS,KAAK,MAAM;AACrC,eAAO,KAAK,aAAa,IAAI;AAAA,MACjC,CAAC;AAAA,IACL;AAAA,EACJ;AAAA;AAAA;AAAA;AAAA,EAKA,QAAW,MAAwC;AAC/C,QAAI,KAAK,SAAS;AACd,YAAM,IAAI,iBAAiB;AAAA,IAC/B;AAEA,WAAO,IAAI,QAAW,CAAC,SAAS,WAAW;AACvC,WAAK,IAAI,YAAY;AACjB,YAAI;AACA,kBAAQ,MAAM,KAAK,CAAC;AAAA,QACxB,SAAS,GAAG;AACR,qBAAO,sBAAQ,CAAC,CAAC;AAAA,QACrB;AAAA,MACJ,CAAC;AAAA,IACL,CAAC;AAAA,EACL;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAaA,MAAM,OAA4B;AAC9B,QAAI,KAAK,SAAS;AACd,YAAM,IAAI,iBAAiB;AAAA,IAC/B;AAEA,WAAO,IAAI,QAAQ,kBAAgB;AAC/B,WAAK,IAAI,YAAY;AACjB,cAAM,IAAI,QAAc,kBAAgB;AACpC,uBAAa;AAAA,YACT,CAAC,OAAO,OAAO,GAAG;AAAA,UACtB,CAAC;AAAA,QACL,CAAC;AAAA,MACL,CAAC;AAAA,IACL,CAAC;AAAA,EACL;AAAA;AAAA;AAAA;AAAA,EAKA,MAAgB,aAAa,MAA2D;AACpF,QAAI,OAAO,SAAS,YAAY;AAC5B,aAAO,KAAK;AAAA,IAChB;AACA,WAAO,QAAQ,QAAQ,IAAI,EAAE,MAAM,WAAS,OAAO,MAAM,sBAAsB,KAAK,MAAM,YAAY,KAAK,CAAC;AAAA,EAChH;AACJ;",
   "names": []
 }

package/dist/esm/net/Channel.d.ts

@@ -14,6 +14,8 @@ export interface Channel<T> {
     maxPayloadSize: number;
     /** Is the transport Reliable? UDP is not, TCP and BTP are. */
     isReliable: boolean;
+    /** Does the channel support large messages? */
+    supportsLargeMessages: boolean;
     /** Channel name */
     name: string;
     type: ChannelType;

package/dist/esm/net/Channel.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Channel.d.ts","sourceRoot":"","sources":["../../../src/net/Channel.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAGzD,oBAAY,WAAW;IACnB,GAAG,QAAQ;IACX,GAAG,QAAQ;IACX,GAAG,QAAQ;CACd;AAED,MAAM,WAAW,OAAO,CAAC,CAAC;IACtB,4CAA4C;IAC5C,cAAc,EAAE,MAAM,CAAC;IAEvB,8DAA8D;IAC9D,UAAU,EAAE,OAAO,CAAC;IAEpB,mBAAmB;IACnB,IAAI,EAAE,MAAM,CAAC;IAEb,IAAI,EAAE,WAAW,CAAC;IAElB,iDAAiD;IACjD,IAAI,CAAC,IAAI,EAAE,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAE7B,kCAAkC;IAClC,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CAC1B;AAED,MAAM,WAAW,gBAAgB,CAAC,CAAC,CAAE,SAAQ,OAAO,CAAC,CAAC,CAAC;IACnD,cAAc,EAAE,gBAAgB,CAAC;CACpC;AAED,wBAAgB,kBAAkB,CAAC,CAAC,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,IAAI,gBAAgB,CAAC,CAAC,CAAC,CAEzF"}
+{"version":3,"file":"Channel.d.ts","sourceRoot":"","sources":["../../../src/net/Channel.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAGzD,oBAAY,WAAW;IACnB,GAAG,QAAQ;IACX,GAAG,QAAQ;IACX,GAAG,QAAQ;CACd;AAED,MAAM,WAAW,OAAO,CAAC,CAAC;IACtB,4CAA4C;IAC5C,cAAc,EAAE,MAAM,CAAC;IAEvB,8DAA8D;IAC9D,UAAU,EAAE,OAAO,CAAC;IAEpB,+CAA+C;IAC/C,qBAAqB,EAAE,OAAO,CAAC;IAE/B,mBAAmB;IACnB,IAAI,EAAE,MAAM,CAAC;IAEb,IAAI,EAAE,WAAW,CAAC;IAElB,iDAAiD;IACjD,IAAI,CAAC,IAAI,EAAE,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAE7B,kCAAkC;IAClC,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CAC1B;AAED,MAAM,WAAW,gBAAgB,CAAC,CAAC,CAAE,SAAQ,OAAO,CAAC,CAAC,CAAC;IACnD,cAAc,EAAE,gBAAgB,CAAC;CACpC;AAED,wBAAgB,kBAAkB,CAAC,CAAC,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,IAAI,gBAAgB,CAAC,CAAC,CAAC,CAEzF"}

package/dist/esm/net/Channel.js.map

@@ -1,6 +1,6 @@
 {
   "version": 3,
   "sources": ["../../../src/net/Channel.ts"],
-  "mappings": "AAAA;AAAA;AAAA;AAAA;AAAA;AAMA,SAAS,gBAAgB;AAElB,IAAK,cAAL,kBAAKA,iBAAL;AACH,EAAAA,aAAA,SAAM;AACN,EAAAA,aAAA,SAAM;AACN,EAAAA,aAAA,SAAM;AAHE,SAAAA;AAAA,GAAA;AA6BL,SAAS,mBAAsB,SAAqD;AACvF,SAAO,SAAU,QAAgC,cAAc;AACnE;",
+  "mappings": "AAAA;AAAA;AAAA;AAAA;AAAA;AAMA,SAAS,gBAAgB;AAElB,IAAK,cAAL,kBAAKA,iBAAL;AACH,EAAAA,aAAA,SAAM;AACN,EAAAA,aAAA,SAAM;AACN,EAAAA,aAAA,SAAM;AAHE,SAAAA;AAAA,GAAA;AAgCL,SAAS,mBAAsB,SAAqD;AACvF,SAAO,SAAU,QAAgC,cAAc;AACnE;",
   "names": ["ChannelType"]
 }

package/dist/esm/net/udp/UdpInterface.d.ts

@@ -25,6 +25,7 @@ export declare class UdpInterface implements ConnectionlessTransport {
 export declare class UdpConnection implements IpNetworkChannel<Bytes> {
     #private;
     readonly isReliable = false;
+    readonly supportsLargeMessages = false;
     readonly type = ChannelType.UDP;
     constructor(server: UdpChannel, peerAddress: string, peerPort: number);
     get maxPayloadSize(): number;

package/dist/esm/net/udp/UdpInterface.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"UdpInterface.d.ts","sourceRoot":"","sources":["../../../../src/net/udp/UdpInterface.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,OAAO,EAAE,WAAW,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AACzE,OAAO,EAAE,uBAAuB,EAAE,MAAM,iCAAiC,CAAC;AAC1E,OAAO,EAAE,OAAO,EAAgB,MAAM,iBAAiB,CAAC;AACxD,OAAO,EAAE,KAAK,EAAE,MAAM,gBAAgB,CAAC;AACvC,OAAO,EAAE,aAAa,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AACtE,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAE7C,qBAAa,YAAa,YAAW,uBAAuB;;WAG3C,MAAM,CAAC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,EAAE,YAAY,CAAC,EAAE,MAAM;gBAMpG,MAAM,EAAE,UAAU;IAI9B,SAAS,KAAK,MAAM,eAEnB;IAED,QAAQ,CAAC,IAAI,EAAE,WAAW,EAAE,OAAO,EAAE,MAAM;IAIrC,WAAW,CAAC,OAAO,EAAE,aAAa;IAQxC,MAAM,CAAC,QAAQ,EAAE,CAAC,OAAO,EAAE,OAAO,CAAC,KAAK,CAAC,EAAE,YAAY,EAAE,KAAK,KAAK,IAAI,GAAG,uBAAuB,CAAC,QAAQ;IAM1G,IAAI,IAAI,WAEP;IAED,KAAK;IAIL,aAAa,CAAC,OAAO,EAAE,MAAM;IAI7B,cAAc,CAAC,OAAO,EAAE,MAAM;CAGjC;AAED,qBAAa,aAAc,YAAW,gBAAgB,CAAC,KAAK,CAAC;;IACzD,QAAQ,CAAC,UAAU,SAAS;IAC5B,QAAQ,CAAC,IAAI,mBAAmB;gBAKpB,MAAM,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM;IAMrE,IAAI,cAAc,WAEjB;IAED,IAAI,CAAC,IAAI,EAAE,KAAK;IAIhB,IAAI,IAAI,WAEP;IAED,IAAI,cAAc,IAAI,gBAAgB,CAErC;IAEK,KAAK;CAGd"}
+{"version":3,"file":"UdpInterface.d.ts","sourceRoot":"","sources":["../../../../src/net/udp/UdpInterface.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,OAAO,EAAE,WAAW,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AACzE,OAAO,EAAE,uBAAuB,EAAE,MAAM,iCAAiC,CAAC;AAC1E,OAAO,EAAE,OAAO,EAAgB,MAAM,iBAAiB,CAAC;AACxD,OAAO,EAAE,KAAK,EAAE,MAAM,gBAAgB,CAAC;AACvC,OAAO,EAAE,aAAa,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AACtE,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAE7C,qBAAa,YAAa,YAAW,uBAAuB;;WAG3C,MAAM,CAAC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,EAAE,YAAY,CAAC,EAAE,MAAM;gBAMpG,MAAM,EAAE,UAAU;IAI9B,SAAS,KAAK,MAAM,eAEnB;IAED,QAAQ,CAAC,IAAI,EAAE,WAAW,EAAE,OAAO,EAAE,MAAM;IAIrC,WAAW,CAAC,OAAO,EAAE,aAAa;IAQxC,MAAM,CAAC,QAAQ,EAAE,CAAC,OAAO,EAAE,OAAO,CAAC,KAAK,CAAC,EAAE,YAAY,EAAE,KAAK,KAAK,IAAI,GAAG,uBAAuB,CAAC,QAAQ;IAM1G,IAAI,IAAI,WAEP;IAED,KAAK;IAIL,aAAa,CAAC,OAAO,EAAE,MAAM;IAI7B,cAAc,CAAC,OAAO,EAAE,MAAM;CAGjC;AAED,qBAAa,aAAc,YAAW,gBAAgB,CAAC,KAAK,CAAC;;IACzD,QAAQ,CAAC,UAAU,SAAS;IAC5B,QAAQ,CAAC,qBAAqB,SAAS;IACvC,QAAQ,CAAC,IAAI,mBAAmB;gBAKpB,MAAM,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM;IAMrE,IAAI,cAAc,WAEjB;IAED,IAAI,CAAC,IAAI,EAAE,KAAK;IAIhB,IAAI,IAAI,WAEP;IAED,IAAI,cAAc,IAAI,gBAAgB,CAErC;IAEK,KAAK;CAGd"}

package/dist/esm/net/udp/UdpInterface.js

@@ -48,6 +48,7 @@ class UdpInterface {
 }
 class UdpConnection {
   isReliable = false;
+  supportsLargeMessages = false;
   type = ChannelType.UDP;
   #server;
   #peerAddress;

package/dist/esm/net/udp/UdpInterface.js.map

@@ -1,6 +1,6 @@
 {
   "version": 3,
   "sources": ["../../../../src/net/udp/UdpInterface.ts"],
-  "mappings": "AAAA;AAAA;AAAA;AAAA;AAAA;AAMA,SAAkB,mBAAqC;AAEvD,SAAkB,oBAAoB;AAK/B,MAAM,aAAgD;AAAA,EAChD;AAAA,EAET,aAAa,OAAO,SAAkB,MAAuB,MAAe,MAAe,cAAuB;AAC9G,WAAO,IAAI;AAAA,MACP,MAAM,QAAQ,iBAAiB,EAAE,eAAe,MAAM,MAAM,cAAc,kBAAkB,KAAK,CAAC;AAAA,IACtG;AAAA,EACJ;AAAA,EAEA,YAAY,QAAoB;AAC5B,SAAK,UAAU;AAAA,EACnB;AAAA,EAEA,IAAc,SAAS;AACnB,WAAO,KAAK;AAAA,EAChB;AAAA,EAEA,SAAS,MAAmB,SAAiB;AACzC,WAAO,KAAK,QAAQ,SAAS,MAAM,OAAO;AAAA,EAC9C;AAAA,EAEA,MAAM,YAAY,SAAwB;AACtC,QAAI,QAAQ,SAAS,OAAO;AACxB,YAAM,IAAI,aAAa,4BAA4B,QAAQ,IAAI,EAAE;AAAA,IACrE;AACA,UAAM,EAAE,IAAI,KAAK,IAAI;AACrB,WAAO,QAAQ,QAAQ,IAAI,cAAc,KAAK,SAAS,IAAI,IAAI,CAAC;AAAA,EACpE;AAAA,EAEA,OAAO,UAAoG;AACvG,WAAO,KAAK,QAAQ;AAAA,MAAO,CAAC,eAAe,UAAU,UAAU,SAC3D,SAAS,IAAI,cAAc,KAAK,SAAS,UAAU,QAAQ,GAAG,IAAI;AAAA,IACtE;AAAA,EACJ;AAAA,EAEA,IAAI,OAAO;AACP,WAAO,KAAK,QAAQ;AAAA,EACxB;AAAA,EAEA,QAAQ;AACJ,WAAO,KAAK,QAAQ,MAAM;AAAA,EAC9B;AAAA,EAEA,cAAc,SAAiB;AAC3B,WAAO,KAAK,QAAQ,cAAc,OAAO;AAAA,EAC7C;AAAA,EAEA,eAAe,SAAiB;AAC5B,WAAO,KAAK,QAAQ,eAAe,OAAO;AAAA,EAC9C;AACJ;AAEO,MAAM,cAAiD;AAAA,EACjD,aAAa;AAAA,EACb,OAAO,YAAY;AAAA,EACnB;AAAA,EACA;AAAA,EACA;AAAA,EAET,YAAY,QAAoB,aAAqB,UAAkB;AACnE,SAAK,UAAU;AACf,SAAK,eAAe;AACpB,SAAK,YAAY;AAAA,EACrB;AAAA,EAEA,IAAI,iBAAiB;AACjB,WAAO,KAAK,QAAQ;AAAA,EACxB;AAAA,EAEA,KAAK,MAAa;AACd,WAAO,KAAK,QAAQ,KAAK,KAAK,cAAc,KAAK,WAAW,IAAI;AAAA,EACpE;AAAA,EAEA,IAAI,OAAO;AACP,WAAO,GAAG,KAAK,IAAI,OAAO,KAAK,YAAY,KAAK,KAAK,SAAS;AAAA,EAClE;AAAA,EAEA,IAAI,iBAAmC;AACnC,WAAO,EAAE,MAAM,OAAO,IAAI,KAAK,cAAc,MAAM,KAAK,UAAU;AAAA,EACtE;AAAA,EAEA,MAAM,QAAQ;AAAA,EAEd;AACJ;",
+  "mappings": "AAAA;AAAA;AAAA;AAAA;AAAA;AAMA,SAAkB,mBAAqC;AAEvD,SAAkB,oBAAoB;AAK/B,MAAM,aAAgD;AAAA,EAChD;AAAA,EAET,aAAa,OAAO,SAAkB,MAAuB,MAAe,MAAe,cAAuB;AAC9G,WAAO,IAAI;AAAA,MACP,MAAM,QAAQ,iBAAiB,EAAE,eAAe,MAAM,MAAM,cAAc,kBAAkB,KAAK,CAAC;AAAA,IACtG;AAAA,EACJ;AAAA,EAEA,YAAY,QAAoB;AAC5B,SAAK,UAAU;AAAA,EACnB;AAAA,EAEA,IAAc,SAAS;AACnB,WAAO,KAAK;AAAA,EAChB;AAAA,EAEA,SAAS,MAAmB,SAAiB;AACzC,WAAO,KAAK,QAAQ,SAAS,MAAM,OAAO;AAAA,EAC9C;AAAA,EAEA,MAAM,YAAY,SAAwB;AACtC,QAAI,QAAQ,SAAS,OAAO;AACxB,YAAM,IAAI,aAAa,4BAA4B,QAAQ,IAAI,EAAE;AAAA,IACrE;AACA,UAAM,EAAE,IAAI,KAAK,IAAI;AACrB,WAAO,QAAQ,QAAQ,IAAI,cAAc,KAAK,SAAS,IAAI,IAAI,CAAC;AAAA,EACpE;AAAA,EAEA,OAAO,UAAoG;AACvG,WAAO,KAAK,QAAQ;AAAA,MAAO,CAAC,eAAe,UAAU,UAAU,SAC3D,SAAS,IAAI,cAAc,KAAK,SAAS,UAAU,QAAQ,GAAG,IAAI;AAAA,IACtE;AAAA,EACJ;AAAA,EAEA,IAAI,OAAO;AACP,WAAO,KAAK,QAAQ;AAAA,EACxB;AAAA,EAEA,QAAQ;AACJ,WAAO,KAAK,QAAQ,MAAM;AAAA,EAC9B;AAAA,EAEA,cAAc,SAAiB;AAC3B,WAAO,KAAK,QAAQ,cAAc,OAAO;AAAA,EAC7C;AAAA,EAEA,eAAe,SAAiB;AAC5B,WAAO,KAAK,QAAQ,eAAe,OAAO;AAAA,EAC9C;AACJ;AAEO,MAAM,cAAiD;AAAA,EACjD,aAAa;AAAA,EACb,wBAAwB;AAAA,EACxB,OAAO,YAAY;AAAA,EACnB;AAAA,EACA;AAAA,EACA;AAAA,EAET,YAAY,QAAoB,aAAqB,UAAkB;AACnE,SAAK,UAAU;AACf,SAAK,eAAe;AACpB,SAAK,YAAY;AAAA,EACrB;AAAA,EAEA,IAAI,iBAAiB;AACjB,WAAO,KAAK,QAAQ;AAAA,EACxB;AAAA,EAEA,KAAK,MAAa;AACd,WAAO,KAAK,QAAQ,KAAK,KAAK,cAAc,KAAK,WAAW,IAAI;AAAA,EACpE;AAAA,EAEA,IAAI,OAAO;AACP,WAAO,GAAG,KAAK,IAAI,OAAO,KAAK,YAAY,KAAK,KAAK,SAAS;AAAA,EAClE;AAAA,EAEA,IAAI,iBAAmC;AACnC,WAAO,EAAE,MAAM,OAAO,IAAI,KAAK,cAAc,MAAM,KAAK,UAAU;AAAA,EACtE;AAAA,EAEA,MAAM,QAAQ;AAAA,EAEd;AACJ;",
   "names": []
 }

package/dist/esm/util/Mutex.d.ts

@@ -3,12 +3,20 @@
  * Copyright 2022-2025 Matter.js Authors
  * SPDX-License-Identifier: Apache-2.0
  */
+import { MatterError } from "#MatterError.js";
+export declare class MutexClosedError extends MatterError {
+    constructor();
+}
 /**
  * A mutex is a task queue where at most one task is active at a time.
  */
 export declare class Mutex implements PromiseLike<unknown> {
     #private;
     constructor(owner: {}, initial?: PromiseLike<unknown>);
+    /**
+     * Prevent new tasks and wait for remaining tasks to complete.
+     */
+    close(): Promise<void>;
     /**
      * As a PromiseLike, you can await the Mutex.  This promise resolves when current activity completes but the mutex
      * may engage in another activity immediately thereafter.  So the mutex is not guaranteed to be available after an
@@ -21,15 +29,23 @@ export declare class Mutex implements PromiseLike<unknown> {
      * If {@link task} is a function it runs when current activity completes.  If it is a promise then the mutex will
      * not clear until {@link task} resolves.
      */
-    run(task: PromiseLike<unknown> | (() => PromiseLike<unknown>), cancel?: () => void): void;
+    run(task: PromiseLike<unknown> | (() => PromiseLike<unknown>)): void;
     /**
      * Enqueue work with an awaitable result.
      */
-    produce<T>(task: () => PromiseLike<T>, cancel?: () => void): Promise<T>;
+    produce<T>(task: () => PromiseLike<T>): Promise<T>;
     /**
-     * Cancel remaining work and perform one last task with the Mutex held.
+     * Acquire the lock.
+     *
+     * This offers more natural mutex handling via a disposable.  The returned object must be disposed to unlock the
+     * mutex.
+     *
+     * Note that acquiring the lock is async but releasing is not, so you must use `using _lock = await mutex.lock()`
+     * rather than `await using _lock = mutex.lock()`.
+     *
+     * TODO - add abort support
      */
-    terminate(cleanup?: () => PromiseLike<void>): void;
+    lock(): Promise<Disposable>;
     /**
      * Activate a task.
      */

package/dist/esm/util/Mutex.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Mutex.d.ts","sourceRoot":"","sources":["../../../src/util/Mutex.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAOH;;GAEG;AACH,qBAAa,KAAM,YAAW,WAAW,CAAC,OAAO,CAAC;;gBAMlC,KAAK,EAAE,EAAE,EAAE,OAAO,CAAC,EAAE,WAAW,CAAC,OAAO,CAAC;IAOrD;;;;OAIG;IACH,IAAI,CAAC,QAAQ,GAAG,IAAI,EAAE,QAAQ,GAAG,KAAK,EAClC,WAAW,CAAC,EAAE,CAAC,CAAC,KAAK,EAAE,OAAO,KAAK,QAAQ,GAAG,WAAW,CAAC,QAAQ,CAAC,CAAC,GAAG,IAAI,EAC3E,UAAU,CAAC,EAAE,CAAC,CAAC,MAAM,EAAE,GAAG,KAAK,QAAQ,GAAG,WAAW,CAAC,QAAQ,CAAC,CAAC,GAAG,IAAI,GACxE,WAAW,CAAC,QAAQ,GAAG,QAAQ,CAAC;IAInC;;;;;OAKG;IACH,GAAG,CAAC,IAAI,EAAE,WAAW,CAAC,OAAO,CAAC,GAAG,CAAC,MAAM,WAAW,CAAC,OAAO,CAAC,CAAC,EAAE,MAAM,CAAC,EAAE,MAAM,IAAI;IAuBlF;;OAEG;IACH,OAAO,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC,CAAC,CAAC,EAAE,MAAM,CAAC,EAAE,MAAM,IAAI,GAAG,OAAO,CAAC,CAAC,CAAC;IAYvE;;OAEG;IACH,SAAS,CAAC,OAAO,CAAC,EAAE,MAAM,WAAW,CAAC,IAAI,CAAC;IAoB3C;;OAEG;cACa,YAAY,CAAC,IAAI,EAAE,WAAW,CAAC,OAAO,CAAC,GAAG,CAAC,MAAM,WAAW,CAAC,OAAO,CAAC,CAAC;CAMzF"}
+{"version":3,"file":"Mutex.d.ts","sourceRoot":"","sources":["../../../src/util/Mutex.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAM9C,qBAAa,gBAAiB,SAAQ,WAAW;;CAIhD;AAED;;GAEG;AACH,qBAAa,KAAM,YAAW,WAAW,CAAC,OAAO,CAAC;;gBAKlC,KAAK,EAAE,EAAE,EAAE,OAAO,CAAC,EAAE,WAAW,CAAC,OAAO,CAAC;IAOrD;;OAEG;IACG,KAAK;IAKX;;;;OAIG;IACH,IAAI,CAAC,QAAQ,GAAG,IAAI,EAAE,QAAQ,GAAG,KAAK,EAClC,WAAW,CAAC,EAAE,CAAC,CAAC,KAAK,EAAE,OAAO,KAAK,QAAQ,GAAG,WAAW,CAAC,QAAQ,CAAC,CAAC,GAAG,IAAI,EAC3E,UAAU,CAAC,EAAE,CAAC,CAAC,MAAM,EAAE,GAAG,KAAK,QAAQ,GAAG,WAAW,CAAC,QAAQ,CAAC,CAAC,GAAG,IAAI,GACxE,WAAW,CAAC,QAAQ,GAAG,QAAQ,CAAC;IAInC;;;;;OAKG;IACH,GAAG,CAAC,IAAI,EAAE,WAAW,CAAC,OAAO,CAAC,GAAG,CAAC,MAAM,WAAW,CAAC,OAAO,CAAC,CAAC;IAc7D;;OAEG;IACH,OAAO,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC;IAgBlD;;;;;;;;;;OAUG;IACG,IAAI,IAAI,OAAO,CAAC,UAAU,CAAC;IAgBjC;;OAEG;cACa,YAAY,CAAC,IAAI,EAAE,WAAW,CAAC,OAAO,CAAC,GAAG,CAAC,MAAM,WAAW,CAAC,OAAO,CAAC,CAAC;CAMzF"}

package/dist/esm/util/Mutex.js

@@ -3,13 +3,18 @@
  * Copyright 2022-2025 Matter.js Authors
  * SPDX-License-Identifier: Apache-2.0
  */
+import { MatterError } from "#MatterError.js";
 import { Logger } from "../log/Logger.js";
 import { asError } from "./Error.js";
 const logger = Logger.get("Mutex");
+class MutexClosedError extends MatterError {
+  constructor() {
+    super("Cannot schedule task because mutex is closed");
+  }
+}
 class Mutex {
   #owner;
-  #cancel;
-  #canceled = false;
+  #closed = false;
   #promise;
   constructor(owner, initial) {
     this.#owner = owner;
@@ -17,6 +22,13 @@ class Mutex {
       this.run(() => initial);
     }
   }
+  /**
+   * Prevent new tasks and wait for remaining tasks to complete.
+   */
+  async close() {
+    this.#closed = true;
+    await this.#promise;
+  }
   /**
    * As a PromiseLike, you can await the Mutex.  This promise resolves when current activity completes but the mutex
    * may engage in another activity immediately thereafter.  So the mutex is not guaranteed to be available after an
@@ -31,30 +43,25 @@ class Mutex {
    * If {@link task} is a function it runs when current activity completes.  If it is a promise then the mutex will
    * not clear until {@link task} resolves.
    */
-  run(task, cancel) {
-    if (this.#canceled) {
-      cancel?.();
-      return;
+  run(task) {
+    if (this.#closed) {
+      throw new MutexClosedError();
     }
     if (!this.#promise) {
       this.#promise = this.initiateTask(task);
     } else {
       this.#promise = this.#promise.then(() => {
-        if (this.#canceled) {
-          cancel?.();
-          return;
-        }
-        this.#cancel = cancel;
-        return this.initiateTask(task).finally(() => {
-          this.#cancel = void 0;
-        });
+        return this.initiateTask(task);
       });
     }
   }
   /**
    * Enqueue work with an awaitable result.
    */
-  produce(task, cancel) {
+  produce(task) {
+    if (this.#closed) {
+      throw new MutexClosedError();
+    }
     return new Promise((resolve, reject) => {
       this.run(async () => {
         try {
@@ -62,27 +69,33 @@ class Mutex {
         } catch (e) {
           reject(asError(e));
         }
-      }, cancel);
+      });
     });
   }
   /**
-   * Cancel remaining work and perform one last task with the Mutex held.
+   * Acquire the lock.
+   *
+   * This offers more natural mutex handling via a disposable.  The returned object must be disposed to unlock the
+   * mutex.
+   *
+   * Note that acquiring the lock is async but releasing is not, so you must use `using _lock = await mutex.lock()`
+   * rather than `await using _lock = mutex.lock()`.
+   *
+   * TODO - add abort support
    */
-  terminate(cleanup) {
-    if (this.#canceled) {
-      return;
-    }
-    this.#canceled = true;
-    if (this.#cancel) {
-      this.#cancel();
-    }
-    if (cleanup) {
-      if (!this.#promise) {
-        this.#promise = this.initiateTask(cleanup);
-      } else {
-        this.#promise = this.#promise.then(() => this.initiateTask(cleanup));
-      }
+  async lock() {
+    if (this.#closed) {
+      throw new MutexClosedError();
     }
+    return new Promise((lockObtained) => {
+      this.run(async () => {
+        await new Promise((lockReleased) => {
+          lockObtained({
+            [Symbol.dispose]: lockReleased
+          });
+        });
+      });
+    });
   }
   /**
    * Activate a task.
@@ -95,6 +108,7 @@ class Mutex {
   }
 }
 export {
-  Mutex
+  Mutex,
+  MutexClosedError
 };
 //# sourceMappingURL=Mutex.js.map

package/dist/esm/util/Mutex.js.map

@@ -1,6 +1,6 @@
 {
   "version": 3,
   "sources": ["../../../src/util/Mutex.ts"],
-  "mappings": "AAAA;AAAA;AAAA;AAAA;AAAA;AAMA,SAAS,cAAc;AACvB,SAAS,eAAe;AAExB,MAAM,SAAS,OAAO,IAAI,OAAO;AAK1B,MAAM,MAAsC;AAAA,EAC/C;AAAA,EACA;AAAA,EACA,YAAY;AAAA,EACZ;AAAA,EAEA,YAAY,OAAW,SAAgC;AACnD,SAAK,SAAS;AACd,QAAI,SAAS;AACT,WAAK,IAAI,MAAM,OAAO;AAAA,IAC1B;AAAA,EACJ;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAOA,KACI,aACA,YACgC;AAChC,YAAQ,KAAK,YAAY,QAAQ,QAAQ,GAAG,KAAK,aAAa,UAAU;AAAA,EAC5E;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAQA,IAAI,MAA2D,QAAqB;AAChF,QAAI,KAAK,WAAW;AAChB,eAAS;AACT;AAAA,IACJ;AAEA,QAAI,CAAC,KAAK,UAAU;AAChB,WAAK,WAAW,KAAK,aAAa,IAAI;AAAA,IAC1C,OAAO;AACH,WAAK,WAAW,KAAK,SAAS,KAAK,MAAM;AACrC,YAAI,KAAK,WAAW;AAChB,mBAAS;AACT;AAAA,QACJ;AAEA,aAAK,UAAU;AACf,eAAO,KAAK,aAAa,IAAI,EAAE,QAAQ,MAAM;AACzC,eAAK,UAAU;AAAA,QACnB,CAAC;AAAA,MACL,CAAC;AAAA,IACL;AAAA,EACJ;AAAA;AAAA;AAAA;AAAA,EAKA,QAAW,MAA4B,QAAiC;AACpE,WAAO,IAAI,QAAW,CAAC,SAAS,WAAW;AACvC,WAAK,IAAI,YAAY;AACjB,YAAI;AACA,kBAAQ,MAAM,KAAK,CAAC;AAAA,QACxB,SAAS,GAAG;AACR,iBAAO,QAAQ,CAAC,CAAC;AAAA,QACrB;AAAA,MACJ,GAAG,MAAM;AAAA,IACb,CAAC;AAAA,EACL;AAAA;AAAA;AAAA;AAAA,EAKA,UAAU,SAAmC;AACzC,QAAI,KAAK,WAAW;AAChB;AAAA,IACJ;AAEA,SAAK,YAAY;AAEjB,QAAI,KAAK,SAAS;AACd,WAAK,QAAQ;AAAA,IACjB;AAEA,QAAI,SAAS;AACT,UAAI,CAAC,KAAK,UAAU;AAChB,aAAK,WAAW,KAAK,aAAa,OAAO;AAAA,MAC7C,OAAO;AACH,aAAK,WAAW,KAAK,SAAS,KAAK,MAAM,KAAK,aAAa,OAAO,CAAC;AAAA,MACvE;AAAA,IACJ;AAAA,EACJ;AAAA;AAAA;AAAA;AAAA,EAKA,MAAgB,aAAa,MAA2D;AACpF,QAAI,OAAO,SAAS,YAAY;AAC5B,aAAO,KAAK;AAAA,IAChB;AACA,WAAO,QAAQ,QAAQ,IAAI,EAAE,MAAM,WAAS,OAAO,MAAM,sBAAsB,KAAK,MAAM,YAAY,KAAK,CAAC;AAAA,EAChH;AACJ;",
+  "mappings": "AAAA;AAAA;AAAA;AAAA;AAAA;AAMA,SAAS,mBAAmB;AAC5B,SAAS,cAAc;AACvB,SAAS,eAAe;AAExB,MAAM,SAAS,OAAO,IAAI,OAAO;AAE1B,MAAM,yBAAyB,YAAY;AAAA,EAC9C,cAAc;AACV,UAAM,8CAA8C;AAAA,EACxD;AACJ;AAKO,MAAM,MAAsC;AAAA,EAC/C;AAAA,EACA,UAAU;AAAA,EACV;AAAA,EAEA,YAAY,OAAW,SAAgC;AACnD,SAAK,SAAS;AACd,QAAI,SAAS;AACT,WAAK,IAAI,MAAM,OAAO;AAAA,IAC1B;AAAA,EACJ;AAAA;AAAA;AAAA;AAAA,EAKA,MAAM,QAAQ;AACV,SAAK,UAAU;AACf,UAAM,KAAK;AAAA,EACf;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAOA,KACI,aACA,YACgC;AAChC,YAAQ,KAAK,YAAY,QAAQ,QAAQ,GAAG,KAAK,aAAa,UAAU;AAAA,EAC5E;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAQA,IAAI,MAA2D;AAC3D,QAAI,KAAK,SAAS;AACd,YAAM,IAAI,iBAAiB;AAAA,IAC/B;AAEA,QAAI,CAAC,KAAK,UAAU;AAChB,WAAK,WAAW,KAAK,aAAa,IAAI;AAAA,IAC1C,OAAO;AACH,WAAK,WAAW,KAAK,SAAS,KAAK,MAAM;AACrC,eAAO,KAAK,aAAa,IAAI;AAAA,MACjC,CAAC;AAAA,IACL;AAAA,EACJ;AAAA;AAAA;AAAA;AAAA,EAKA,QAAW,MAAwC;AAC/C,QAAI,KAAK,SAAS;AACd,YAAM,IAAI,iBAAiB;AAAA,IAC/B;AAEA,WAAO,IAAI,QAAW,CAAC,SAAS,WAAW;AACvC,WAAK,IAAI,YAAY;AACjB,YAAI;AACA,kBAAQ,MAAM,KAAK,CAAC;AAAA,QACxB,SAAS,GAAG;AACR,iBAAO,QAAQ,CAAC,CAAC;AAAA,QACrB;AAAA,MACJ,CAAC;AAAA,IACL,CAAC;AAAA,EACL;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAaA,MAAM,OAA4B;AAC9B,QAAI,KAAK,SAAS;AACd,YAAM,IAAI,iBAAiB;AAAA,IAC/B;AAEA,WAAO,IAAI,QAAQ,kBAAgB;AAC/B,WAAK,IAAI,YAAY;AACjB,cAAM,IAAI,QAAc,kBAAgB;AACpC,uBAAa;AAAA,YACT,CAAC,OAAO,OAAO,GAAG;AAAA,UACtB,CAAC;AAAA,QACL,CAAC;AAAA,MACL,CAAC;AAAA,IACL,CAAC;AAAA,EACL;AAAA;AAAA;AAAA;AAAA,EAKA,MAAgB,aAAa,MAA2D;AACpF,QAAI,OAAO,SAAS,YAAY;AAC5B,aAAO,KAAK;AAAA,IAChB;AACA,WAAO,QAAQ,QAAQ,IAAI,EAAE,MAAM,WAAS,OAAO,MAAM,sBAAsB,KAAK,MAAM,YAAY,KAAK,CAAC;AAAA,EAChH;AACJ;",
   "names": []
 }

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@matter/general",
-    "version": "0.16.0-alpha.0-20251107-6bcb5baf4",
+    "version": "0.16.0-alpha.0-20251110-c4c70a41b",
     "description": "Non-Matter support for Matter.js",
     "keywords": [
         "iot",
@@ -36,7 +36,7 @@
         "@noble/curves": "^2.0.1"
     },
     "devDependencies": {
-        "@matter/testing": "0.16.0-alpha.0-20251107-6bcb5baf4"
+        "@matter/testing": "0.16.0-alpha.0-20251110-c4c70a41b"
     },
     "files": [
         "dist/**/*",

package/src/net/Channel.ts

@@ -19,6 +19,9 @@ export interface Channel<T> {
     /** Is the transport Reliable? UDP is not, TCP and BTP are. */
     isReliable: boolean;
 
+    /** Does the channel support large messages? */
+    supportsLargeMessages: boolean;
+
     /** Channel name */
     name: string;
 

package/src/net/udp/UdpInterface.ts

@@ -65,6 +65,7 @@ export class UdpInterface implements ConnectionlessTransport {
 
 export class UdpConnection implements IpNetworkChannel<Bytes> {
     readonly isReliable = false;
+    readonly supportsLargeMessages = false;
     readonly type = ChannelType.UDP;
     readonly #server: UdpChannel;
     readonly #peerAddress: string;

package/src/util/Mutex.ts

@@ -4,18 +4,24 @@
  * SPDX-License-Identifier: Apache-2.0
  */
 
+import { MatterError } from "#MatterError.js";
 import { Logger } from "../log/Logger.js";
 import { asError } from "./Error.js";
 
 const logger = Logger.get("Mutex");
 
+export class MutexClosedError extends MatterError {
+    constructor() {
+        super("Cannot schedule task because mutex is closed");
+    }
+}
+
 /**
  * A mutex is a task queue where at most one task is active at a time.
  */
 export class Mutex implements PromiseLike<unknown> {
     #owner: {};
-    #cancel?: () => void;
-    #canceled = false;
+    #closed = false;
     #promise?: Promise<unknown>;
 
     constructor(owner: {}, initial?: PromiseLike<unknown>) {
@@ -25,6 +31,14 @@ export class Mutex implements PromiseLike<unknown> {
         }
     }
 
+    /**
+     * Prevent new tasks and wait for remaining tasks to complete.
+     */
+    async close() {
+        this.#closed = true;
+        await this.#promise;
+    }
+
     /**
      * As a PromiseLike, you can await the Mutex.  This promise resolves when current activity completes but the mutex
      * may engage in another activity immediately thereafter.  So the mutex is not guaranteed to be available after an
@@ -43,25 +57,16 @@ export class Mutex implements PromiseLike<unknown> {
      * If {@link task} is a function it runs when current activity completes.  If it is a promise then the mutex will
      * not clear until {@link task} resolves.
      */
-    run(task: PromiseLike<unknown> | (() => PromiseLike<unknown>), cancel?: () => void) {
-        if (this.#canceled) {
-            cancel?.();
-            return;
+    run(task: PromiseLike<unknown> | (() => PromiseLike<unknown>)) {
+        if (this.#closed) {
+            throw new MutexClosedError();
         }
 
         if (!this.#promise) {
             this.#promise = this.initiateTask(task);
         } else {
             this.#promise = this.#promise.then(() => {
-                if (this.#canceled) {
-                    cancel?.();
-                    return;
-                }
-
-                this.#cancel = cancel;
-                return this.initiateTask(task).finally(() => {
-                    this.#cancel = undefined;
-                });
+                return this.initiateTask(task);
             });
         }
     }
@@ -69,7 +74,11 @@ export class Mutex implements PromiseLike<unknown> {
     /**
      * Enqueue work with an awaitable result.
      */
-    produce<T>(task: () => PromiseLike<T>, cancel?: () => void): Promise<T> {
+    produce<T>(task: () => PromiseLike<T>): Promise<T> {
+        if (this.#closed) {
+            throw new MutexClosedError();
+        }
+
         return new Promise<T>((resolve, reject) => {
             this.run(async () => {
                 try {
@@ -77,31 +86,35 @@ export class Mutex implements PromiseLike<unknown> {
                 } catch (e) {
                     reject(asError(e));
                 }
-            }, cancel);
+            });
         });
     }
 
     /**
-     * Cancel remaining work and perform one last task with the Mutex held.
+     * Acquire the lock.
+     *
+     * This offers more natural mutex handling via a disposable.  The returned object must be disposed to unlock the
+     * mutex.
+     *
+     * Note that acquiring the lock is async but releasing is not, so you must use `using _lock = await mutex.lock()`
+     * rather than `await using _lock = mutex.lock()`.
+     *
+     * TODO - add abort support
      */
-    terminate(cleanup?: () => PromiseLike<void>) {
-        if (this.#canceled) {
-            return;
-        }
-
-        this.#canceled = true;
-
-        if (this.#cancel) {
-            this.#cancel();
+    async lock(): Promise<Disposable> {
+        if (this.#closed) {
+            throw new MutexClosedError();
         }
 
-        if (cleanup) {
-            if (!this.#promise) {
-                this.#promise = this.initiateTask(cleanup);
-            } else {
-                this.#promise = this.#promise.then(() => this.initiateTask(cleanup));
-            }
-        }
+        return new Promise(lockObtained => {
+            this.run(async () => {
+                await new Promise<void>(lockReleased => {
+                    lockObtained({
+                        [Symbol.dispose]: lockReleased,
+                    });
+                });
+            });
+        });
     }
 
     /**