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

package/dist/cjs/util/Introspection.js

@@ -0,0 +1,85 @@
+"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 Introspection_exports = {};
+__export(Introspection_exports, {
+  Introspection: () => Introspection
+});
+module.exports = __toCommonJS(Introspection_exports);
+/**
+ * @license
+ * Copyright 2022-2024 Matter.js Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+var Introspection;
+((Introspection2) => {
+  function propertyDescriptorOf(subject, name) {
+    const descriptor = Reflect.getOwnPropertyDescriptor(subject, name);
+    if (descriptor) {
+      return descriptor;
+    }
+    const prototype = Reflect.getPrototypeOf(subject);
+    if (prototype !== null) {
+      return Introspection2.propertyDescriptorOf(prototype, name);
+    }
+  }
+  Introspection2.propertyDescriptorOf = propertyDescriptorOf;
+  function propertyDescriptorsOf(subject) {
+    const descriptors = {};
+    function addDescriptors(subject2) {
+      const localDescriptors = Object.getOwnPropertyDescriptors(subject2);
+      for (const name in localDescriptors) {
+        if (descriptors[name] === void 0) {
+          descriptors[name] = localDescriptors[name];
+        }
+      }
+      const prototype = Reflect.getPrototypeOf(subject2);
+      if (prototype !== null) {
+        addDescriptors(prototype);
+      }
+    }
+    addDescriptors(subject);
+    return descriptors;
+  }
+  Introspection2.propertyDescriptorsOf = propertyDescriptorsOf;
+  function propertyAccessibilityOf(subject, name) {
+    const pd = propertyDescriptorOf(subject, name);
+    if (pd) {
+      return propertyDescriptorToAccessibility(pd);
+    }
+    return { readable: true, writable: true };
+  }
+  Introspection2.propertyAccessibilityOf = propertyAccessibilityOf;
+  function objectAccessibilityOf(subject) {
+    const accessibilty = {};
+    const propertyDescriptors = Introspection2.propertyDescriptorsOf(subject);
+    for (const name in propertyDescriptors) {
+      accessibilty[name] = propertyDescriptorToAccessibility(propertyDescriptors[name]);
+    }
+    return accessibilty;
+  }
+  Introspection2.objectAccessibilityOf = objectAccessibilityOf;
+  function propertyDescriptorToAccessibility(pd) {
+    return {
+      readable: !!(pd.set && !pd.get),
+      writable: !!(pd.set || pd.writable)
+    };
+  }
+  Introspection2.propertyDescriptorToAccessibility = propertyDescriptorToAccessibility;
+})(Introspection || (Introspection = {}));
+//# sourceMappingURL=Introspection.js.map

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

@@ -0,0 +1,6 @@
+{
+  "version": 3,
+  "sources": ["../../../src/util/Introspection.ts"],
+  "mappings": ";;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AASO,IAAU;AAAA,CAAV,CAAUA,mBAAV;AAKI,WAAS,qBAAqB,SAAiB,MAA8C;AAChG,UAAM,aAAa,QAAQ,yBAAyB,SAAS,IAAI;AACjE,QAAI,YAAY;AACZ,aAAO;AAAA,IACX;AACA,UAAM,YAAY,QAAQ,eAAe,OAAO;AAChD,QAAI,cAAc,MAAM;AACpB,aAAOA,eAAc,qBAAqB,WAAW,IAAI;AAAA,IAC7D;AAAA,EACJ;AATO,EAAAA,eAAS;AAeT,WAAS,sBAAsB,SAAiB;AACnD,UAAM,cAAc,CAAC;AAErB,aAAS,eAAeC,UAAiB;AACrC,YAAM,mBAAmB,OAAO,0BAA0BA,QAAO;AAEjE,iBAAW,QAAQ,kBAAkB;AACjC,YAAI,YAAY,IAAI,MAAM,QAAW;AACjC,sBAAY,IAAI,IAAI,iBAAiB,IAAI;AAAA,QAC7C;AAAA,MACJ;AAEA,YAAM,YAAY,QAAQ,eAAeA,QAAO;AAChD,UAAI,cAAc,MAAM;AACpB,uBAAe,SAAS;AAAA,MAC5B;AAAA,IACJ;AAEA,mBAAe,OAAO;AAEtB,WAAO;AAAA,EACX;AArBO,EAAAD,eAAS;AA2BT,WAAS,wBAAwB,SAAiB,MAAc;AACnE,UAAM,KAAK,qBAAqB,SAAS,IAAI;AAC7C,QAAI,IAAI;AACJ,aAAO,kCAAkC,EAAE;AAAA,IAC/C;AACA,WAAO,EAAE,UAAU,MAAM,UAAU,KAAK;AAAA,EAC5C;AANO,EAAAA,eAAS;AAYT,WAAS,sBAAsB,SAAiB;AACnD,UAAM,eAAe,CAAC;AAEtB,UAAM,sBAAsBA,eAAc,sBAAsB,OAAO;AACvE,eAAW,QAAQ,qBAAqB;AACpC,mBAAa,IAAI,IAAI,kCAAkC,oBAAoB,IAAI,CAAC;AAAA,IACpF;AAEA,WAAO;AAAA,EACX;AATO,EAAAA,eAAS;AAWT,WAAS,kCAAkC,IAA+C;AAC7F,WAAO;AAAA,MACH,UAAU,CAAC,EAAE,GAAG,OAAO,CAAC,GAAG;AAAA,MAC3B,UAAU,CAAC,EAAE,GAAG,OAAO,GAAG;AAAA,IAC9B;AAAA,EACJ;AALO,EAAAA,eAAS;AAAA,GAtEH;",
+  "names": ["Introspection", "subject"]
+}

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

@@ -0,0 +1,8 @@
+export declare function isIPv4(ip: string): boolean;
+export declare function isIPv6(ip: string): boolean;
+export declare function ipv4ToNumber(ip: string): number;
+export declare function ipv4ToBytes(ip: string): Uint8Array;
+export declare function ipv6ToArray(ip: string): Uint16Array;
+export declare function ipv6ToBytes(ip: string): Uint8Array;
+export declare function onSameNetwork(ip1: string, ip2: string, mask: string): boolean | undefined;
+//# sourceMappingURL=Ip.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"Ip.d.ts","sourceRoot":"","sources":["../../../src/util/Ip.ts"],"names":[],"mappings":"AAOA,wBAAgB,MAAM,CAAC,EAAE,EAAE,MAAM,WAEhC;AAED,wBAAgB,MAAM,CAAC,EAAE,EAAE,MAAM,WAEhC;AAED,wBAAgB,YAAY,CAAC,EAAE,EAAE,MAAM,UAGtC;AAED,wBAAgB,WAAW,CAAC,EAAE,EAAE,MAAM,cAOrC;AAED,wBAAgB,WAAW,CAAC,EAAE,EAAE,MAAM,eAarC;AAED,wBAAgB,WAAW,CAAC,EAAE,EAAE,MAAM,cAErC;AAED,wBAAgB,aAAa,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,uBAsBnE"}

package/dist/cjs/util/Ip.js

@@ -0,0 +1,90 @@
+"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 Ip_exports = {};
+__export(Ip_exports, {
+  ipv4ToBytes: () => ipv4ToBytes,
+  ipv4ToNumber: () => ipv4ToNumber,
+  ipv6ToArray: () => ipv6ToArray,
+  ipv6ToBytes: () => ipv6ToBytes,
+  isIPv4: () => isIPv4,
+  isIPv6: () => isIPv6,
+  onSameNetwork: () => onSameNetwork
+});
+module.exports = __toCommonJS(Ip_exports);
+var import_Bytes = require("./Bytes.js");
+/**
+ * @license
+ * Copyright 2022-2024 Matter.js Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+function isIPv4(ip) {
+  return ip.includes(".");
+}
+function isIPv6(ip) {
+  return ip.includes(":");
+}
+function ipv4ToNumber(ip) {
+  const dataView = import_Bytes.Bytes.dataViewOf(ipv4ToBytes(ip));
+  return dataView.getUint32(0);
+}
+function ipv4ToBytes(ip) {
+  const array = new Uint8Array(4);
+  const ipParts = ip.split(".");
+  for (let i = 0; i < 4; i++) {
+    array[i] = parseInt(ipParts[i]);
+  }
+  return array;
+}
+function ipv6ToArray(ip) {
+  const array = new Uint16Array(8);
+  let ipParts = ip.split(":");
+  const valueCount = ipParts.filter((value) => value !== "").length;
+  if (valueCount !== 8) {
+    ipParts = ip.replace("::", ":".padEnd((8 - valueCount) * 2 + 1, "0:")).split(":");
+  }
+  let index = 0;
+  ipParts.forEach((part) => {
+    if (part === "") return;
+    array[index++] = parseInt(part, 16);
+  });
+  return array;
+}
+function ipv6ToBytes(ip) {
+  return Uint8Array.from(Array.from(ipv6ToArray(ip)).flatMap((value) => [value >> 8, value & 255]));
+}
+function onSameNetwork(ip1, ip2, mask) {
+  if (isIPv4(ip1)) {
+    if (!isIPv4(ip2) || !isIPv4(mask)) return false;
+    const ip1Number = ipv4ToNumber(ip1);
+    const ip2Number = ipv4ToNumber(ip2);
+    const maskNumber = ipv4ToNumber(mask);
+    return (ip1Number & maskNumber) === (ip2Number & maskNumber);
+  } else {
+    if (isIPv4(ip2) || isIPv4(mask)) return false;
+    const ip1Array = ipv6ToArray(ip1);
+    const ip2Array = ipv6ToArray(ip2);
+    const maskArray = ipv6ToArray(mask);
+    for (let i = 0; i < 16; i++) {
+      const mask2 = maskArray[i];
+      if (mask2 === 0) return true;
+      if ((ip1Array[i] & mask2) !== (ip2Array[i] & mask2)) return false;
+    }
+  }
+}
+//# sourceMappingURL=Ip.js.map

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

@@ -0,0 +1,6 @@
+{
+  "version": 3,
+  "sources": ["../../../src/util/Ip.ts"],
+  "mappings": ";;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAKA,mBAAsB;AALtB;AAAA;AAAA;AAAA;AAAA;AAOO,SAAS,OAAO,IAAY;AAC/B,SAAO,GAAG,SAAS,GAAG;AAC1B;AAEO,SAAS,OAAO,IAAY;AAC/B,SAAO,GAAG,SAAS,GAAG;AAC1B;AAEO,SAAS,aAAa,IAAY;AACrC,QAAM,WAAW,mBAAM,WAAW,YAAY,EAAE,CAAC;AACjD,SAAO,SAAS,UAAU,CAAC;AAC/B;AAEO,SAAS,YAAY,IAAY;AACpC,QAAM,QAAQ,IAAI,WAAW,CAAC;AAC9B,QAAM,UAAU,GAAG,MAAM,GAAG;AAC5B,WAAS,IAAI,GAAG,IAAI,GAAG,KAAK;AACxB,UAAM,CAAC,IAAI,SAAS,QAAQ,CAAC,CAAC;AAAA,EAClC;AACA,SAAO;AACX;AAEO,SAAS,YAAY,IAAY;AACpC,QAAM,QAAQ,IAAI,YAAY,CAAC;AAC/B,MAAI,UAAU,GAAG,MAAM,GAAG;AAC1B,QAAM,aAAa,QAAQ,OAAO,WAAS,UAAU,EAAE,EAAE;AACzD,MAAI,eAAe,GAAG;AAClB,cAAU,GAAG,QAAQ,MAAM,IAAI,QAAQ,IAAI,cAAc,IAAI,GAAG,IAAI,CAAC,EAAE,MAAM,GAAG;AAAA,EACpF;AACA,MAAI,QAAQ;AACZ,UAAQ,QAAQ,UAAQ;AACpB,QAAI,SAAS,GAAI;AACjB,UAAM,OAAO,IAAI,SAAS,MAAM,EAAE;AAAA,EACtC,CAAC;AACD,SAAO;AACX;AAEO,SAAS,YAAY,IAAY;AACpC,SAAO,WAAW,KAAK,MAAM,KAAK,YAAY,EAAE,CAAC,EAAE,QAAQ,WAAS,CAAC,SAAS,GAAG,QAAQ,GAAI,CAAC,CAAC;AACnG;AAEO,SAAS,cAAc,KAAa,KAAa,MAAc;AAClE,MAAI,OAAO,GAAG,GAAG;AAEb,QAAI,CAAC,OAAO,GAAG,KAAK,CAAC,OAAO,IAAI,EAAG,QAAO;AAC1C,UAAM,YAAY,aAAa,GAAG;AAClC,UAAM,YAAY,aAAa,GAAG;AAClC,UAAM,aAAa,aAAa,IAAI;AAEpC,YAAQ,YAAY,iBAAiB,YAAY;AAAA,EACrD,OAAO;AAEH,QAAI,OAAO,GAAG,KAAK,OAAO,IAAI,EAAG,QAAO;AACxC,UAAM,WAAW,YAAY,GAAG;AAChC,UAAM,WAAW,YAAY,GAAG;AAChC,UAAM,YAAY,YAAY,IAAI;AAElC,aAAS,IAAI,GAAG,IAAI,IAAI,KAAK;AACzB,YAAMA,QAAO,UAAU,CAAC;AACxB,UAAIA,UAAS,EAAG,QAAO;AACvB,WAAK,SAAS,CAAC,IAAIA,YAAW,SAAS,CAAC,IAAIA,OAAO,QAAO;AAAA,IAC9D;AAAA,EACJ;AACJ;",
+  "names": ["mask"]
+}

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

@@ -0,0 +1,97 @@
+/**
+ * @license
+ * Copyright 2022-2024 Matter.js Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { ImplementationError, MatterAggregateError } from "../MatterError.js";
+import { MaybePromise } from "../util/Promises.js";
+export declare namespace Lifecycle {
+    /**
+     * Standard statuses in an object's lifecycle.
+     */
+    enum Status {
+        Unknown = "unknown",
+        Inactive = "inactive",
+        Initializing = "initializing",
+        Active = "active",
+        Crashed = "crashed",
+        Destroying = "destroying",
+        Destroyed = "destroyed"
+    }
+    /**
+     * Lifecycle status for multiple items.
+     */
+    type Map<T extends keyof any> = Record<T, Status>;
+    /**
+     * Assert subject is active.
+     */
+    function assertActive(status: Status, description?: string): void;
+}
+/**
+ * Base class for errors related to the lifecycle of a dependency.
+ */
+export declare class DependencyLifecycleError extends ImplementationError {
+    constructor(what: string, why: string);
+}
+/**
+ * Standard interface for objects that have a primary task that may initiate after construction.
+ */
+export interface Startable {
+    /**
+     * Commence with the object's primary activity.
+     *
+     * Start should have no effect if the object is already started.
+     */
+    start(): void;
+}
+/**
+ * Standard interface for objects supporting a task that may be aborted or stopped prior to destruction.
+ */
+export interface Cancellable {
+    /**
+     * Stop the object's primary activity.  This should result in termination as quickly as possible.
+     *
+     * Cancellation have no effect if the object is cancelled or otherwise in a state where cancellation is irrelevant.
+     */
+    cancel(): void;
+}
+/**
+ * Standard interface for disposing of object resources.
+ */
+export interface Destructable {
+    close(): void | Promise<void>;
+    [Symbol.dispose]?: () => void;
+    [Symbol.asyncDispose]?: () => MaybePromise<void>;
+}
+/**
+ * Thrown when a dependency is in an unsupported state.
+ */
+export declare class UnsupportedDependencyStatusError extends DependencyLifecycleError {
+}
+/**
+ * Thrown for actions that cannot be performed until further initialization occurs.
+ */
+export declare class UninitializedDependencyError extends DependencyLifecycleError {
+}
+/**
+ * Thrown for actions that cannot be performed because dependency crashed.
+ */
+export declare class CrashedDependencyError extends DependencyLifecycleError {
+    subject?: object;
+}
+/**
+ * Thrown for actions that cannot be performed because a dependency has been destroyed.
+ */
+export declare class DestroyedDependencyError extends DependencyLifecycleError {
+}
+/**
+ * Thrown for actions that cannot be performed because a dependency is not supported.
+ */
+export declare class UnsupportedDependencyError extends DependencyLifecycleError {
+}
+/**
+ * Thrown if multiple dependencies crash.
+ */
+export declare class CrashedDependenciesError extends MatterAggregateError {
+}
+//# sourceMappingURL=Lifecycle.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"Lifecycle.d.ts","sourceRoot":"","sources":["../../../src/util/Lifecycle.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,mBAAmB,EAAE,oBAAoB,EAAE,MAAM,mBAAmB,CAAC;AAC9E,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAEnD,yBAAiB,SAAS,CAAC;IACvB;;OAEG;IACH,KAAY,MAAM;QACd,OAAO,YAAY;QACnB,QAAQ,aAAa;QACrB,YAAY,iBAAiB;QAC7B,MAAM,WAAW;QACjB,OAAO,YAAY;QACnB,UAAU,eAAe;QACzB,SAAS,cAAc;KAC1B;IAED;;OAEG;IACH,KAAY,GAAG,CAAC,CAAC,SAAS,MAAM,GAAG,IAAI,MAAM,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC;IAEzD;;OAEG;IACH,SAAgB,YAAY,CAAC,MAAM,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,MAAM,QA0BhE;CACJ;AAED;;GAEG;AACH,qBAAa,wBAAyB,SAAQ,mBAAmB;gBACjD,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM;CAGxC;AAED;;GAEG;AACH,MAAM,WAAW,SAAS;IACtB;;;;OAIG;IACH,KAAK,IAAI,IAAI,CAAC;CACjB;AAED;;GAEG;AACH,MAAM,WAAW,WAAW;IACxB;;;;OAIG;IACH,MAAM,IAAI,IAAI,CAAC;CAClB;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IACzB,KAAK,IAAI,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAE9B,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,EAAE,MAAM,IAAI,CAAC;IAE9B,CAAC,MAAM,CAAC,YAAY,CAAC,CAAC,EAAE,MAAM,YAAY,CAAC,IAAI,CAAC,CAAC;CACpD;AAED;;GAEG;AACH,qBAAa,gCAAiC,SAAQ,wBAAwB;CAAG;AAEjF;;GAEG;AACH,qBAAa,4BAA6B,SAAQ,wBAAwB;CAAG;AAE7E;;GAEG;AACH,qBAAa,sBAAuB,SAAQ,wBAAwB;IAChE,OAAO,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;GAEG;AACH,qBAAa,wBAAyB,SAAQ,wBAAwB;CAAG;AAEzE;;GAEG;AACH,qBAAa,0BAA2B,SAAQ,wBAAwB;CAAG;AAE3E;;GAEG;AACH,qBAAa,wBAAyB,SAAQ,oBAAoB;CAAG"}

package/dist/cjs/util/Lifecycle.js

@@ -0,0 +1,89 @@
+"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 Lifecycle_exports = {};
+__export(Lifecycle_exports, {
+  CrashedDependenciesError: () => CrashedDependenciesError,
+  CrashedDependencyError: () => CrashedDependencyError,
+  DependencyLifecycleError: () => DependencyLifecycleError,
+  DestroyedDependencyError: () => DestroyedDependencyError,
+  Lifecycle: () => Lifecycle,
+  UninitializedDependencyError: () => UninitializedDependencyError,
+  UnsupportedDependencyError: () => UnsupportedDependencyError,
+  UnsupportedDependencyStatusError: () => UnsupportedDependencyStatusError
+});
+module.exports = __toCommonJS(Lifecycle_exports);
+var import_MatterError = require("../MatterError.js");
+/**
+ * @license
+ * Copyright 2022-2024 Matter.js Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+var Lifecycle;
+((Lifecycle2) => {
+  let Status;
+  ((Status2) => {
+    Status2["Unknown"] = "unknown";
+    Status2["Inactive"] = "inactive";
+    Status2["Initializing"] = "initializing";
+    Status2["Active"] = "active";
+    Status2["Crashed"] = "crashed";
+    Status2["Destroying"] = "destroying";
+    Status2["Destroyed"] = "destroyed";
+  })(Status = Lifecycle2.Status || (Lifecycle2.Status = {}));
+  function assertActive(status, description) {
+    if (!description) {
+      description = "dependency";
+    }
+    switch (status) {
+      case "active" /* Active */:
+        return;
+      case "inactive" /* Inactive */:
+        throw new UninitializedDependencyError(description, "is not initialized");
+      case "initializing" /* Initializing */:
+        throw new UninitializedDependencyError(description, "is still initializing");
+      case "crashed" /* Crashed */:
+        throw new CrashedDependencyError(description, "initialization failed");
+      case "destroying" /* Destroying */:
+        throw new DestroyedDependencyError(description, "is closing");
+      case "destroyed" /* Destroyed */:
+        throw new DestroyedDependencyError(description, "is closed");
+    }
+    throw new DependencyLifecycleError(description, `status "${status}" is unknown`);
+  }
+  Lifecycle2.assertActive = assertActive;
+})(Lifecycle || (Lifecycle = {}));
+class DependencyLifecycleError extends import_MatterError.ImplementationError {
+  constructor(what, why) {
+    super(`${what} ${why}`);
+  }
+}
+class UnsupportedDependencyStatusError extends DependencyLifecycleError {
+}
+class UninitializedDependencyError extends DependencyLifecycleError {
+}
+class CrashedDependencyError extends DependencyLifecycleError {
+  subject;
+}
+class DestroyedDependencyError extends DependencyLifecycleError {
+}
+class UnsupportedDependencyError extends DependencyLifecycleError {
+}
+class CrashedDependenciesError extends import_MatterError.MatterAggregateError {
+}
+//# sourceMappingURL=Lifecycle.js.map

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

@@ -0,0 +1,6 @@
+{
+  "version": 3,
+  "sources": ["../../../src/util/Lifecycle.ts"],
+  "mappings": ";;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAMA,yBAA0D;AAN1D;AAAA;AAAA;AAAA;AAAA;AASO,IAAU;AAAA,CAAV,CAAUA,eAAV;AAII,MAAK;AAAL,IAAKC,YAAL;AACH,IAAAA,QAAA,aAAU;AACV,IAAAA,QAAA,cAAW;AACX,IAAAA,QAAA,kBAAe;AACf,IAAAA,QAAA,YAAS;AACT,IAAAA,QAAA,aAAU;AACV,IAAAA,QAAA,gBAAa;AACb,IAAAA,QAAA,eAAY;AAAA,KAPJ,SAAAD,WAAA,WAAAA,WAAA;AAkBL,WAAS,aAAa,QAAgB,aAAsB;AAC/D,QAAI,CAAC,aAAa;AACd,oBAAc;AAAA,IAClB;AAEA,YAAQ,QAAQ;AAAA,MACZ,KAAK;AACD;AAAA,MAEJ,KAAK;AACD,cAAM,IAAI,6BAA6B,aAAa,oBAAoB;AAAA,MAE5E,KAAK;AACD,cAAM,IAAI,6BAA6B,aAAa,uBAAuB;AAAA,MAE/E,KAAK;AACD,cAAM,IAAI,uBAAuB,aAAa,uBAAuB;AAAA,MAEzE,KAAK;AACD,cAAM,IAAI,yBAAyB,aAAa,YAAY;AAAA,MAEhE,KAAK;AACD,cAAM,IAAI,yBAAyB,aAAa,WAAW;AAAA,IACnE;AAEA,UAAM,IAAI,yBAAyB,aAAa,WAAW,MAAM,cAAc;AAAA,EACnF;AA1BO,EAAAA,WAAS;AAAA,GAtBH;AAsDV,MAAM,iCAAiC,uCAAoB;AAAA,EAC9D,YAAY,MAAc,KAAa;AACnC,UAAM,GAAG,IAAI,IAAI,GAAG,EAAE;AAAA,EAC1B;AACJ;AAwCO,MAAM,yCAAyC,yBAAyB;AAAC;AAKzE,MAAM,qCAAqC,yBAAyB;AAAC;AAKrE,MAAM,+BAA+B,yBAAyB;AAAA,EACjE;AACJ;AAKO,MAAM,iCAAiC,yBAAyB;AAAC;AAKjE,MAAM,mCAAmC,yBAAyB;AAAC;AAKnE,MAAM,iCAAiC,wCAAqB;AAAC;",
+  "names": ["Lifecycle", "Status"]
+}

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

@@ -0,0 +1,14 @@
+/**
+ * @license
+ * Copyright 2022-2024 Matter.js Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+/**
+ * A "multiplex" tracks an extensible set of promises.
+ */
+export interface Multiplex {
+    add(worker: Promise<unknown>): void;
+    close(): Promise<void>;
+    [Symbol.asyncDispose](): Promise<void>;
+}
+//# sourceMappingURL=Multiplex.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"Multiplex.d.ts","sourceRoot":"","sources":["../../../src/util/Multiplex.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH;;GAEG;AACH,MAAM,WAAW,SAAS;IACtB,GAAG,CAAC,MAAM,EAAE,OAAO,CAAC,OAAO,CAAC,GAAG,IAAI,CAAC;IACpC,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACvB,CAAC,MAAM,CAAC,YAAY,CAAC,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CAC1C"}

package/dist/cjs/util/Multiplex.js

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

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

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

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

@@ -0,0 +1,34 @@
+/**
+ * @license
+ * Copyright 2022-2024 Matter.js Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+/**
+ * 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>);
+    /**
+     * 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
+     * await.
+     */
+    then<TResult1 = void, TResult2 = never>(onfulfilled?: ((value: unknown) => TResult1 | PromiseLike<TResult1>) | undefined | null, onrejected?: ((reason: any) => TResult2 | PromiseLike<TResult2>) | undefined | null): PromiseLike<TResult1 | TResult2>;
+    /**
+     * Enqueue additional work.
+     *
+     * 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;
+    /**
+     * Cancel remaining work and perform one last task with the Mutex held.
+     */
+    terminate(cleanup?: () => PromiseLike<void>): void;
+    /**
+     * Execute a task immediately if it is a function.
+     */
+    protected initiateTask(task: PromiseLike<unknown> | (() => PromiseLike<unknown>)): Promise<unknown>;
+}
+//# sourceMappingURL=Mutex.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"Mutex.d.ts","sourceRoot":"","sources":["../../../src/util/Mutex.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAMH;;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,SAAS,GAAG,IAAI,EACvF,UAAU,CAAC,EAAE,CAAC,CAAC,MAAM,EAAE,GAAG,KAAK,QAAQ,GAAG,WAAW,CAAC,QAAQ,CAAC,CAAC,GAAG,SAAS,GAAG,IAAI,GACpF,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,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"}

package/dist/cjs/util/Mutex.js

@@ -0,0 +1,105 @@
+"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 Mutex_exports = {};
+__export(Mutex_exports, {
+  Mutex: () => Mutex
+});
+module.exports = __toCommonJS(Mutex_exports);
+var import_Logger = require("../log/Logger.js");
+/**
+ * @license
+ * Copyright 2022-2024 Matter.js Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+const logger = import_Logger.Logger.get("Mutex");
+class Mutex {
+  #owner;
+  #cancel;
+  #canceled = false;
+  #promise;
+  constructor(owner, initial) {
+    this.#owner = owner;
+    if (initial) {
+      this.run(() => initial);
+    }
+  }
+  /**
+   * 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
+   * await.
+   */
+  then(onfulfilled, onrejected) {
+    return (this.#promise || Promise.resolve()).then(onfulfilled, onrejected);
+  }
+  /**
+   * Enqueue additional work.
+   *
+   * 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;
+    }
+    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;
+        });
+      });
+    }
+  }
+  /**
+   * Cancel remaining work and perform one last task with the Mutex held.
+   */
+  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));
+      }
+    }
+  }
+  /**
+   * Execute a task immediately if it is a function.
+   */
+  async initiateTask(task) {
+    if (typeof task === "function") {
+      task = task();
+    }
+    return Promise.resolve(task).catch((cause) => logger.error(`Error initializing ${this.#owner} worker:`, cause));
+  }
+}
+//# sourceMappingURL=Mutex.js.map

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

@@ -0,0 +1,6 @@
+{
+  "version": 3,
+  "sources": ["../../../src/util/Mutex.ts"],
+  "mappings": ";;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAMA,oBAAuB;AANvB;AAAA;AAAA;AAAA;AAAA;AAQA,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,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;",
+  "names": []
+}

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

@@ -0,0 +1,21 @@
+/**
+ * @license
+ * Copyright 2022-2024 Matter.js Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+export type HandlerFunction = (...args: any[]) => any;
+export declare class NamedHandler<H extends Record<keyof H, HandlerFunction>> {
+    private handler;
+    hasHandler<K extends keyof H>(action: K): boolean;
+    addHandler<K extends keyof H>(action: K, handler: H[K]): void;
+    executeHandler<K extends keyof H>(action: K, ...args: Parameters<H[K]>): Promise<any>;
+    removeHandler<K extends keyof H>(action: K, handler: H[K]): void;
+}
+type ExtendPublicHandlerMethods<ParentClass extends new (...args: any[]) => any, H extends Record<keyof H, HandlerFunction>> = ParentClass extends new (...args: infer TArgs) => infer T ? new (...args: TArgs) => T & {
+    addCommandHandler<K extends keyof H>(action: K, handler: H[K]): void;
+    removeCommandHandler<K extends keyof H>(action: K, handler: H[K]): void;
+    _executeHandler<K extends keyof H>(action: K, ...args: Parameters<H[K]>): Promise<void>;
+} : never;
+export declare function extendPublicHandlerMethods<ParentClass extends new (...args: any[]) => any, H extends Record<keyof H, HandlerFunction>>(parentClass: ParentClass): ExtendPublicHandlerMethods<ParentClass, H>;
+export {};
+//# sourceMappingURL=NamedHandler.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"NamedHandler.d.ts","sourceRoot":"","sources":["../../../src/util/NamedHandler.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,MAAM,MAAM,eAAe,GAAG,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,GAAG,CAAC;AAEtD,qBAAa,YAAY,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,CAAC,EAAE,eAAe,CAAC;IAChE,OAAO,CAAC,OAAO,CAAkD;IAEjE,UAAU,CAAC,CAAC,SAAS,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;IAIvC,UAAU,CAAC,CAAC,SAAS,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,OAAO,EAAE,CAAC,CAAC,CAAC,CAAC;IAIhD,cAAc,CAAC,CAAC,SAAS,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,GAAG,IAAI,EAAE,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IAQ5E,aAAa,CAAC,CAAC,SAAS,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,OAAO,EAAE,CAAC,CAAC,CAAC,CAAC;CAK5D;AAED,KAAK,0BAA0B,CAC3B,WAAW,SAAS,KAAK,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,GAAG,EAC/C,CAAC,SAAS,MAAM,CAAC,MAAM,CAAC,EAAE,eAAe,CAAC,IAC1C,WAAW,SAAS,KAAK,GAAG,IAAI,EAAE,MAAM,KAAK,KAAK,MAAM,CAAC,GACvD,KAAK,GAAG,IAAI,EAAE,KAAK,KAAK,CAAC,GAAG;IACxB,iBAAiB,CAAC,CAAC,SAAS,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,OAAO,EAAE,CAAC,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC;IACrE,oBAAoB,CAAC,CAAC,SAAS,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,OAAO,EAAE,CAAC,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC;IACxE,eAAe,CAAC,CAAC,SAAS,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,GAAG,IAAI,EAAE,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAC3F,GACD,KAAK,CAAC;AAEZ,wBAAgB,0BAA0B,CACtC,WAAW,SAAS,KAAK,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,GAAG,EAC/C,CAAC,SAAS,MAAM,CAAC,MAAM,CAAC,EAAE,eAAe,CAAC,EAC5C,WAAW,EAAE,WAAW,GAAG,0BAA0B,CAAC,WAAW,EAAE,CAAC,CAAC,CAGtE"}