@matter/general 0.16.8-alpha.0-20260123-dff2cae52 → 0.16.8-alpha.0-20260125-38e62bc3e

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

@@ -0,0 +1,21 @@
+/**
+ * @license
+ * Copyright 2022-2026 Matter.js Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+/**
+ * Utilities for working with async iterators.
+ */
+export declare namespace AsyncIterator {
+    /**
+     * Merge multiple async iterators, yielding results as they become available from any iterator.
+     *
+     * Results are yielded in the order they resolve, not the order of iterators.
+     * Errors from individual iterators are collected and thrown as an aggregate error after all iterators complete.
+     *
+     * @param iterators The async iterables to merge
+     * @param errorMessage Optional message for the aggregate error if any iterators fail
+     */
+    function merge<T>(iterators: AsyncIterable<T>[], errorMessage?: string): AsyncGenerator<T>;
+}
+//# sourceMappingURL=AsyncIterator.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"AsyncIterator.d.ts","sourceRoot":"","sources":["../../../src/util/AsyncIterator.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH;;GAEG;AACH,yBAAiB,aAAa,CAAC;IAC3B;;;;;;;;OAQG;IACH,SAAuB,KAAK,CAAC,CAAC,EAC1B,SAAS,EAAE,aAAa,CAAC,CAAC,CAAC,EAAE,EAC7B,YAAY,SAAuC,GACpD,cAAc,CAAC,CAAC,CAAC,CA8CnB;CACJ"}

package/dist/cjs/util/AsyncIterator.js

@@ -0,0 +1,71 @@
+"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 AsyncIterator_exports = {};
+__export(AsyncIterator_exports, {
+  AsyncIterator: () => AsyncIterator
+});
+module.exports = __toCommonJS(AsyncIterator_exports);
+/**
+ * @license
+ * Copyright 2022-2026 Matter.js Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+var AsyncIterator;
+((AsyncIterator2) => {
+  async function* merge(iterators, errorMessage = "One or more async iterators failed") {
+    const asyncIterators = iterators.map((iter) => iter[Symbol.asyncIterator]());
+    const pending = /* @__PURE__ */ new Map();
+    const errors = [];
+    for (let i = 0; i < asyncIterators.length; i++) {
+      pending.set(
+        i,
+        asyncIterators[i].next().then(
+          (result) => ({ index: i, result }),
+          (error) => {
+            errors.push(error);
+            return { index: i, result: { done: true, value: void 0 } };
+          }
+        )
+      );
+    }
+    while (pending.size > 0) {
+      const { index, result } = await Promise.race(pending.values());
+      if (result.done) {
+        pending.delete(index);
+      } else {
+        yield result.value;
+        pending.set(
+          index,
+          asyncIterators[index].next().then(
+            (result2) => ({ index, result: result2 }),
+            (error) => {
+              errors.push(error);
+              return { index, result: { done: true, value: void 0 } };
+            }
+          )
+        );
+      }
+    }
+    if (errors.length > 0) {
+      throw new AggregateError(errors, errorMessage);
+    }
+  }
+  AsyncIterator2.merge = merge;
+})(AsyncIterator || (AsyncIterator = {}));
+//# sourceMappingURL=AsyncIterator.js.map

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

@@ -0,0 +1,6 @@
+{
+  "version": 3,
+  "sources": ["../../../src/util/AsyncIterator.ts"],
+  "mappings": ";;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AASO,IAAU;AAAA,CAAV,CAAUA,mBAAV;AAUH,kBAAuB,MACnB,WACA,eAAe,sCACE;AACjB,UAAM,iBAAiB,UAAU,IAAI,UAAQ,KAAK,OAAO,aAAa,EAAE,CAAC;AACzE,UAAM,UAAU,oBAAI,IAAmE;AACvF,UAAM,SAAkB,CAAC;AAGzB,aAAS,IAAI,GAAG,IAAI,eAAe,QAAQ,KAAK;AAC5C,cAAQ;AAAA,QACJ;AAAA,QACA,eAAe,CAAC,EAAE,KAAK,EAAE;AAAA,UACrB,aAAW,EAAE,OAAO,GAAG,OAAO;AAAA,UAC9B,WAAS;AAEL,mBAAO,KAAK,KAAK;AACjB,mBAAO,EAAE,OAAO,GAAG,QAAQ,EAAE,MAAM,MAAM,OAAO,OAAU,EAAuB;AAAA,UACrF;AAAA,QACJ;AAAA,MACJ;AAAA,IACJ;AAEA,WAAO,QAAQ,OAAO,GAAG;AAErB,YAAM,EAAE,OAAO,OAAO,IAAI,MAAM,QAAQ,KAAK,QAAQ,OAAO,CAAC;AAE7D,UAAI,OAAO,MAAM;AACb,gBAAQ,OAAO,KAAK;AAAA,MACxB,OAAO;AACH,cAAM,OAAO;AAEb,gBAAQ;AAAA,UACJ;AAAA,UACA,eAAe,KAAK,EAAE,KAAK,EAAE;AAAA,YACzB,CAAAC,aAAW,EAAE,OAAO,QAAAA,QAAO;AAAA,YAC3B,WAAS;AACL,qBAAO,KAAK,KAAK;AACjB,qBAAO,EAAE,OAAO,QAAQ,EAAE,MAAM,MAAM,OAAO,OAAU,EAAuB;AAAA,YAClF;AAAA,UACJ;AAAA,QACJ;AAAA,MACJ;AAAA,IACJ;AAGA,QAAI,OAAO,SAAS,GAAG;AACnB,YAAM,IAAI,eAAe,QAAQ,YAAY;AAAA,IACjD;AAAA,EACJ;AAjDA,EAAAD,eAAuB;AAAA,GAVV;",
+  "names": ["AsyncIterator", "result"]
+}

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

@@ -5,6 +5,7 @@
  */
 export * from "./Abort.js";
 export * from "./Array.js";
+export * from "./AsyncIterator.js";
 export * from "./Boot.js";
 export * from "./Bytes.js";
 export * from "./Cache.js";

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/util/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,cAAc,YAAY,CAAC;AAC3B,cAAc,YAAY,CAAC;AAC3B,cAAc,WAAW,CAAC;AAC1B,cAAc,YAAY,CAAC;AAC3B,cAAc,YAAY,CAAC;AAC3B,cAAc,iBAAiB,CAAC;AAChC,cAAc,mBAAmB,CAAC;AAClC,cAAc,iBAAiB,CAAC;AAChC,cAAc,oBAAoB,CAAC;AACnC,cAAc,iBAAiB,CAAC;AAChC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,eAAe,CAAC;AAC9B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,cAAc,CAAC;AAC7B,cAAc,YAAY,CAAC;AAC3B,cAAc,oBAAoB,CAAC;AACnC,cAAc,eAAe,CAAC;AAC9B,cAAc,qBAAqB,CAAC;AACpC,cAAc,aAAa,CAAC;AAC5B,cAAc,WAAW,CAAC;AAC1B,cAAc,sBAAsB,CAAC;AACrC,cAAc,SAAS,CAAC;AACxB,cAAc,gBAAgB,CAAC;AAC/B,cAAc,eAAe,CAAC;AAC9B,cAAc,UAAU,CAAC;AACzB,cAAc,gBAAgB,CAAC;AAC/B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,YAAY,CAAC;AAC3B,cAAc,mBAAmB,CAAC;AAClC,cAAc,aAAa,CAAC;AAC5B,cAAc,iBAAiB,CAAC;AAChC,cAAc,eAAe,CAAC;AAC9B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,UAAU,CAAC;AACzB,cAAc,gBAAgB,CAAC;AAC/B,cAAc,cAAc,CAAC;AAC7B,cAAc,aAAa,CAAC;AAC5B,cAAc,WAAW,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/util/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,cAAc,YAAY,CAAC;AAC3B,cAAc,YAAY,CAAC;AAC3B,cAAc,oBAAoB,CAAC;AACnC,cAAc,WAAW,CAAC;AAC1B,cAAc,YAAY,CAAC;AAC3B,cAAc,YAAY,CAAC;AAC3B,cAAc,iBAAiB,CAAC;AAChC,cAAc,mBAAmB,CAAC;AAClC,cAAc,iBAAiB,CAAC;AAChC,cAAc,oBAAoB,CAAC;AACnC,cAAc,iBAAiB,CAAC;AAChC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,eAAe,CAAC;AAC9B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,cAAc,CAAC;AAC7B,cAAc,YAAY,CAAC;AAC3B,cAAc,oBAAoB,CAAC;AACnC,cAAc,eAAe,CAAC;AAC9B,cAAc,qBAAqB,CAAC;AACpC,cAAc,aAAa,CAAC;AAC5B,cAAc,WAAW,CAAC;AAC1B,cAAc,sBAAsB,CAAC;AACrC,cAAc,SAAS,CAAC;AACxB,cAAc,gBAAgB,CAAC;AAC/B,cAAc,eAAe,CAAC;AAC9B,cAAc,UAAU,CAAC;AACzB,cAAc,gBAAgB,CAAC;AAC/B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,YAAY,CAAC;AAC3B,cAAc,mBAAmB,CAAC;AAClC,cAAc,aAAa,CAAC;AAC5B,cAAc,iBAAiB,CAAC;AAChC,cAAc,eAAe,CAAC;AAC9B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,UAAU,CAAC;AACzB,cAAc,gBAAgB,CAAC;AAC/B,cAAc,cAAc,CAAC;AAC7B,cAAc,aAAa,CAAC;AAC5B,cAAc,WAAW,CAAC"}

package/dist/cjs/util/index.js

@@ -17,6 +17,7 @@ var util_exports = {};
 module.exports = __toCommonJS(util_exports);
 __reExport(util_exports, require("./Abort.js"), module.exports);
 __reExport(util_exports, require("./Array.js"), module.exports);
+__reExport(util_exports, require("./AsyncIterator.js"), module.exports);
 __reExport(util_exports, require("./Boot.js"), module.exports);
 __reExport(util_exports, require("./Bytes.js"), module.exports);
 __reExport(util_exports, require("./Cache.js"), module.exports);

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

@@ -1,6 +1,6 @@
 {
   "version": 3,
   "sources": ["../../../src/util/index.ts"],
-  "mappings": ";;;;;;;;;;;;;;;AAAA;AAAA;AAMA,yBAAc,uBANd;AAOA,yBAAc,uBAPd;AAQA,yBAAc,sBARd;AASA,yBAAc,uBATd;AAUA,yBAAc,uBAVd;AAWA,yBAAc,4BAXd;AAYA,yBAAc,8BAZd;AAaA,yBAAc,4BAbd;AAcA,yBAAc,+BAdd;AAeA,yBAAc,4BAfd;AAgBA,yBAAc,2BAhBd;AAiBA,yBAAc,0BAjBd;AAkBA,yBAAc,2BAlBd;AAmBA,yBAAc,yBAnBd;AAoBA,yBAAc,uBApBd;AAqBA,yBAAc,+BArBd;AAsBA,yBAAc,0BAtBd;AAuBA,yBAAc,gCAvBd;AAwBA,yBAAc,wBAxBd;AAyBA,yBAAc,sBAzBd;AA0BA,yBAAc,iCA1Bd;AA2BA,yBAAc,oBA3Bd;AA4BA,yBAAc,2BA5Bd;AA6BA,yBAAc,0BA7Bd;AA8BA,yBAAc,qBA9Bd;AA+BA,yBAAc,2BA/Bd;AAgCA,yBAAc,2BAhCd;AAiCA,yBAAc,uBAjCd;AAkCA,yBAAc,8BAlCd;AAmCA,yBAAc,wBAnCd;AAoCA,yBAAc,4BApCd;AAqCA,yBAAc,0BArCd;AAsCA,yBAAc,2BAtCd;AAuCA,yBAAc,2BAvCd;AAwCA,yBAAc,2BAxCd;AAyCA,yBAAc,qBAzCd;AA0CA,yBAAc,2BA1Cd;AA2CA,yBAAc,yBA3Cd;AA4CA,yBAAc,wBA5Cd;AA6CA,yBAAc,sBA7Cd;AAAA;AAAA;AAAA;AAAA;AAAA;",
+  "mappings": ";;;;;;;;;;;;;;;AAAA;AAAA;AAMA,yBAAc,uBANd;AAOA,yBAAc,uBAPd;AAQA,yBAAc,+BARd;AASA,yBAAc,sBATd;AAUA,yBAAc,uBAVd;AAWA,yBAAc,uBAXd;AAYA,yBAAc,4BAZd;AAaA,yBAAc,8BAbd;AAcA,yBAAc,4BAdd;AAeA,yBAAc,+BAfd;AAgBA,yBAAc,4BAhBd;AAiBA,yBAAc,2BAjBd;AAkBA,yBAAc,0BAlBd;AAmBA,yBAAc,2BAnBd;AAoBA,yBAAc,yBApBd;AAqBA,yBAAc,uBArBd;AAsBA,yBAAc,+BAtBd;AAuBA,yBAAc,0BAvBd;AAwBA,yBAAc,gCAxBd;AAyBA,yBAAc,wBAzBd;AA0BA,yBAAc,sBA1Bd;AA2BA,yBAAc,iCA3Bd;AA4BA,yBAAc,oBA5Bd;AA6BA,yBAAc,2BA7Bd;AA8BA,yBAAc,0BA9Bd;AA+BA,yBAAc,qBA/Bd;AAgCA,yBAAc,2BAhCd;AAiCA,yBAAc,2BAjCd;AAkCA,yBAAc,uBAlCd;AAmCA,yBAAc,8BAnCd;AAoCA,yBAAc,wBApCd;AAqCA,yBAAc,4BArCd;AAsCA,yBAAc,0BAtCd;AAuCA,yBAAc,2BAvCd;AAwCA,yBAAc,2BAxCd;AAyCA,yBAAc,2BAzCd;AA0CA,yBAAc,qBA1Cd;AA2CA,yBAAc,2BA3Cd;AA4CA,yBAAc,yBA5Cd;AA6CA,yBAAc,wBA7Cd;AA8CA,yBAAc,sBA9Cd;AAAA;AAAA;AAAA;AAAA;AAAA;",
   "names": []
 }

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

@@ -0,0 +1,21 @@
+/**
+ * @license
+ * Copyright 2022-2026 Matter.js Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+/**
+ * Utilities for working with async iterators.
+ */
+export declare namespace AsyncIterator {
+    /**
+     * Merge multiple async iterators, yielding results as they become available from any iterator.
+     *
+     * Results are yielded in the order they resolve, not the order of iterators.
+     * Errors from individual iterators are collected and thrown as an aggregate error after all iterators complete.
+     *
+     * @param iterators The async iterables to merge
+     * @param errorMessage Optional message for the aggregate error if any iterators fail
+     */
+    function merge<T>(iterators: AsyncIterable<T>[], errorMessage?: string): AsyncGenerator<T>;
+}
+//# sourceMappingURL=AsyncIterator.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"AsyncIterator.d.ts","sourceRoot":"","sources":["../../../src/util/AsyncIterator.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH;;GAEG;AACH,yBAAiB,aAAa,CAAC;IAC3B;;;;;;;;OAQG;IACH,SAAuB,KAAK,CAAC,CAAC,EAC1B,SAAS,EAAE,aAAa,CAAC,CAAC,CAAC,EAAE,EAC7B,YAAY,SAAuC,GACpD,cAAc,CAAC,CAAC,CAAC,CA8CnB;CACJ"}

package/dist/esm/util/AsyncIterator.js

@@ -0,0 +1,51 @@
+/**
+ * @license
+ * Copyright 2022-2026 Matter.js Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+var AsyncIterator;
+((AsyncIterator2) => {
+  async function* merge(iterators, errorMessage = "One or more async iterators failed") {
+    const asyncIterators = iterators.map((iter) => iter[Symbol.asyncIterator]());
+    const pending = /* @__PURE__ */ new Map();
+    const errors = [];
+    for (let i = 0; i < asyncIterators.length; i++) {
+      pending.set(
+        i,
+        asyncIterators[i].next().then(
+          (result) => ({ index: i, result }),
+          (error) => {
+            errors.push(error);
+            return { index: i, result: { done: true, value: void 0 } };
+          }
+        )
+      );
+    }
+    while (pending.size > 0) {
+      const { index, result } = await Promise.race(pending.values());
+      if (result.done) {
+        pending.delete(index);
+      } else {
+        yield result.value;
+        pending.set(
+          index,
+          asyncIterators[index].next().then(
+            (result2) => ({ index, result: result2 }),
+            (error) => {
+              errors.push(error);
+              return { index, result: { done: true, value: void 0 } };
+            }
+          )
+        );
+      }
+    }
+    if (errors.length > 0) {
+      throw new AggregateError(errors, errorMessage);
+    }
+  }
+  AsyncIterator2.merge = merge;
+})(AsyncIterator || (AsyncIterator = {}));
+export {
+  AsyncIterator
+};
+//# sourceMappingURL=AsyncIterator.js.map

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

@@ -0,0 +1,6 @@
+{
+  "version": 3,
+  "sources": ["../../../src/util/AsyncIterator.ts"],
+  "mappings": "AAAA;AAAA;AAAA;AAAA;AAAA;AASO,IAAU;AAAA,CAAV,CAAUA,mBAAV;AAUH,kBAAuB,MACnB,WACA,eAAe,sCACE;AACjB,UAAM,iBAAiB,UAAU,IAAI,UAAQ,KAAK,OAAO,aAAa,EAAE,CAAC;AACzE,UAAM,UAAU,oBAAI,IAAmE;AACvF,UAAM,SAAkB,CAAC;AAGzB,aAAS,IAAI,GAAG,IAAI,eAAe,QAAQ,KAAK;AAC5C,cAAQ;AAAA,QACJ;AAAA,QACA,eAAe,CAAC,EAAE,KAAK,EAAE;AAAA,UACrB,aAAW,EAAE,OAAO,GAAG,OAAO;AAAA,UAC9B,WAAS;AAEL,mBAAO,KAAK,KAAK;AACjB,mBAAO,EAAE,OAAO,GAAG,QAAQ,EAAE,MAAM,MAAM,OAAO,OAAU,EAAuB;AAAA,UACrF;AAAA,QACJ;AAAA,MACJ;AAAA,IACJ;AAEA,WAAO,QAAQ,OAAO,GAAG;AAErB,YAAM,EAAE,OAAO,OAAO,IAAI,MAAM,QAAQ,KAAK,QAAQ,OAAO,CAAC;AAE7D,UAAI,OAAO,MAAM;AACb,gBAAQ,OAAO,KAAK;AAAA,MACxB,OAAO;AACH,cAAM,OAAO;AAEb,gBAAQ;AAAA,UACJ;AAAA,UACA,eAAe,KAAK,EAAE,KAAK,EAAE;AAAA,YACzB,CAAAC,aAAW,EAAE,OAAO,QAAAA,QAAO;AAAA,YAC3B,WAAS;AACL,qBAAO,KAAK,KAAK;AACjB,qBAAO,EAAE,OAAO,QAAQ,EAAE,MAAM,MAAM,OAAO,OAAU,EAAuB;AAAA,YAClF;AAAA,UACJ;AAAA,QACJ;AAAA,MACJ;AAAA,IACJ;AAGA,QAAI,OAAO,SAAS,GAAG;AACnB,YAAM,IAAI,eAAe,QAAQ,YAAY;AAAA,IACjD;AAAA,EACJ;AAjDA,EAAAD,eAAuB;AAAA,GAVV;",
+  "names": ["AsyncIterator", "result"]
+}

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

@@ -5,6 +5,7 @@
  */
 export * from "./Abort.js";
 export * from "./Array.js";
+export * from "./AsyncIterator.js";
 export * from "./Boot.js";
 export * from "./Bytes.js";
 export * from "./Cache.js";

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/util/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,cAAc,YAAY,CAAC;AAC3B,cAAc,YAAY,CAAC;AAC3B,cAAc,WAAW,CAAC;AAC1B,cAAc,YAAY,CAAC;AAC3B,cAAc,YAAY,CAAC;AAC3B,cAAc,iBAAiB,CAAC;AAChC,cAAc,mBAAmB,CAAC;AAClC,cAAc,iBAAiB,CAAC;AAChC,cAAc,oBAAoB,CAAC;AACnC,cAAc,iBAAiB,CAAC;AAChC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,eAAe,CAAC;AAC9B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,cAAc,CAAC;AAC7B,cAAc,YAAY,CAAC;AAC3B,cAAc,oBAAoB,CAAC;AACnC,cAAc,eAAe,CAAC;AAC9B,cAAc,qBAAqB,CAAC;AACpC,cAAc,aAAa,CAAC;AAC5B,cAAc,WAAW,CAAC;AAC1B,cAAc,sBAAsB,CAAC;AACrC,cAAc,SAAS,CAAC;AACxB,cAAc,gBAAgB,CAAC;AAC/B,cAAc,eAAe,CAAC;AAC9B,cAAc,UAAU,CAAC;AACzB,cAAc,gBAAgB,CAAC;AAC/B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,YAAY,CAAC;AAC3B,cAAc,mBAAmB,CAAC;AAClC,cAAc,aAAa,CAAC;AAC5B,cAAc,iBAAiB,CAAC;AAChC,cAAc,eAAe,CAAC;AAC9B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,UAAU,CAAC;AACzB,cAAc,gBAAgB,CAAC;AAC/B,cAAc,cAAc,CAAC;AAC7B,cAAc,aAAa,CAAC;AAC5B,cAAc,WAAW,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/util/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,cAAc,YAAY,CAAC;AAC3B,cAAc,YAAY,CAAC;AAC3B,cAAc,oBAAoB,CAAC;AACnC,cAAc,WAAW,CAAC;AAC1B,cAAc,YAAY,CAAC;AAC3B,cAAc,YAAY,CAAC;AAC3B,cAAc,iBAAiB,CAAC;AAChC,cAAc,mBAAmB,CAAC;AAClC,cAAc,iBAAiB,CAAC;AAChC,cAAc,oBAAoB,CAAC;AACnC,cAAc,iBAAiB,CAAC;AAChC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,eAAe,CAAC;AAC9B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,cAAc,CAAC;AAC7B,cAAc,YAAY,CAAC;AAC3B,cAAc,oBAAoB,CAAC;AACnC,cAAc,eAAe,CAAC;AAC9B,cAAc,qBAAqB,CAAC;AACpC,cAAc,aAAa,CAAC;AAC5B,cAAc,WAAW,CAAC;AAC1B,cAAc,sBAAsB,CAAC;AACrC,cAAc,SAAS,CAAC;AACxB,cAAc,gBAAgB,CAAC;AAC/B,cAAc,eAAe,CAAC;AAC9B,cAAc,UAAU,CAAC;AACzB,cAAc,gBAAgB,CAAC;AAC/B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,YAAY,CAAC;AAC3B,cAAc,mBAAmB,CAAC;AAClC,cAAc,aAAa,CAAC;AAC5B,cAAc,iBAAiB,CAAC;AAChC,cAAc,eAAe,CAAC;AAC9B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,UAAU,CAAC;AACzB,cAAc,gBAAgB,CAAC;AAC/B,cAAc,cAAc,CAAC;AAC7B,cAAc,aAAa,CAAC;AAC5B,cAAc,WAAW,CAAC"}

package/dist/esm/util/index.js

@@ -5,6 +5,7 @@
  */
 export * from "./Abort.js";
 export * from "./Array.js";
+export * from "./AsyncIterator.js";
 export * from "./Boot.js";
 export * from "./Bytes.js";
 export * from "./Cache.js";

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

@@ -1,6 +1,6 @@
 {
   "version": 3,
   "sources": ["../../../src/util/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;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;",
+  "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;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;",
   "names": []
 }

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@matter/general",
-    "version": "0.16.8-alpha.0-20260123-dff2cae52",
+    "version": "0.16.8-alpha.0-20260125-38e62bc3e",
     "description": "Non-Matter support for Matter.js",
     "keywords": [
         "iot",
@@ -36,7 +36,7 @@
         "@noble/curves": "^2.0.1"
     },
     "devDependencies": {
-        "@matter/testing": "0.16.8-alpha.0-20260123-dff2cae52"
+        "@matter/testing": "0.16.8-alpha.0-20260125-38e62bc3e"
     },
     "files": [
         "dist/**/*",

package/src/util/AsyncIterator.ts

@@ -0,0 +1,70 @@
+/**
+ * @license
+ * Copyright 2022-2026 Matter.js Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+
+/**
+ * Utilities for working with async iterators.
+ */
+export namespace AsyncIterator {
+    /**
+     * Merge multiple async iterators, yielding results as they become available from any iterator.
+     *
+     * Results are yielded in the order they resolve, not the order of iterators.
+     * Errors from individual iterators are collected and thrown as an aggregate error after all iterators complete.
+     *
+     * @param iterators The async iterables to merge
+     * @param errorMessage Optional message for the aggregate error if any iterators fail
+     */
+    export async function* merge<T>(
+        iterators: AsyncIterable<T>[],
+        errorMessage = "One or more async iterators failed",
+    ): AsyncGenerator<T> {
+        const asyncIterators = iterators.map(iter => iter[Symbol.asyncIterator]());
+        const pending = new Map<number, Promise<{ index: number; result: IteratorResult<T> }>>();
+        const errors: Error[] = [];
+
+        // Initialize with first .next() call for each iterator
+        for (let i = 0; i < asyncIterators.length; i++) {
+            pending.set(
+                i,
+                asyncIterators[i].next().then(
+                    result => ({ index: i, result }),
+                    error => {
+                        // On error, mark as done and collect error
+                        errors.push(error);
+                        return { index: i, result: { done: true, value: undefined } as IteratorResult<T> };
+                    },
+                ),
+            );
+        }
+
+        while (pending.size > 0) {
+            // Race all pending promises
+            const { index, result } = await Promise.race(pending.values());
+
+            if (result.done) {
+                pending.delete(index);
+            } else {
+                yield result.value;
+                // Queue next value from this iterator
+                pending.set(
+                    index,
+                    asyncIterators[index].next().then(
+                        result => ({ index, result }),
+                        error => {
+                            errors.push(error);
+                            return { index, result: { done: true, value: undefined } as IteratorResult<T> };
+                        },
+                    ),
+                );
+            }
+        }
+
+        // After all iterators complete, throw aggregate error if any occurred
+        if (errors.length > 0) {
+            throw new AggregateError(errors, errorMessage);
+        }
+    }
+}

package/src/util/index.ts

@@ -6,6 +6,7 @@
 
 export * from "./Abort.js";
 export * from "./Array.js";
+export * from "./AsyncIterator.js";
 export * from "./Boot.js";
 export * from "./Bytes.js";
 export * from "./Cache.js";