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

package/dist/esm/environment/ProcessManager.d.ts

@@ -0,0 +1,45 @@
+/**
+ * @license
+ * Copyright 2022-2024 Matter.js Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { Destructable, Environment, RuntimeService } from "#general";
+/**
+ * ProcessManager watches Node.js signals SIGINT and SIGUSR2 to terminate the Matter.js runtime and trigger Matter.js
+ * diagnostics respectively.  It sets the process exit code to 0 if the runtime completes without error and to 1 if the
+ * runtime crashes.
+ *
+ * If enabled, SIGINT will perform a soft interrupt of the runtime once.  ProcessManager will not process subsequent
+ * interrupts so they will result in forced exit if no other handler exists.
+ *
+ * {@link NodeJsEnvironment} installs a ProcessManager into the default Matter.js {@link Environment}.
+ *
+ * You can modify behavior by:
+ *
+ *   - Passing an {@link Environment} other than {@link Environment.default} to your components
+ *
+ *   - Disabling signal and exit code support with {@link VariableService} variables "runtime.signals" and
+ *     "runtime.exitcode" respectively
+ *
+ *   - Destroying ProcessManager in the default environment using {@link ProcessManager.close}
+ *
+ *   - Subclassing ProcessManager, overriding specific functionality, and installing with {@link Environment.set}
+ */
+export declare class ProcessManager implements Destructable {
+    #private;
+    protected env: Environment;
+    protected runtime: RuntimeService;
+    constructor(env: Environment);
+    close(): void;
+    [Symbol.dispose](): void;
+    protected get hasSignalSupport(): true;
+    protected get hasExitCodeSupport(): true;
+    protected get hasUnhandledErrorSupport(): true;
+    protected startListener: () => void;
+    protected stopListener: () => void;
+    protected crashListener: () => void;
+    protected interruptHandler: (signal: string) => void;
+    protected exitHandler: () => void;
+    protected diagnosticHandler: () => void;
+}
+//# sourceMappingURL=ProcessManager.d.ts.map

package/dist/esm/environment/ProcessManager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ProcessManager.d.ts","sourceRoot":"","sources":["../../../src/environment/ProcessManager.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,YAAY,EAAE,WAAW,EAAU,cAAc,EAAmB,MAAM,UAAU,CAAC;AAK9F;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,qBAAa,cAAe,YAAW,YAAY;;IAInC,SAAS,CAAC,GAAG,EAAE,WAAW;IAHtC,SAAS,CAAC,OAAO,EAAE,cAAc,CAAC;gBAGZ,GAAG,EAAE,WAAW;IActC,KAAK;IAOL,CAAC,MAAM,CAAC,OAAO,CAAC;IAIhB,SAAS,KAAK,gBAAgB,SAE7B;IAED,SAAS,KAAK,kBAAkB,SAE/B;IAED,SAAS,KAAK,wBAAwB,SAErC;IAED,SAAS,CAAC,aAAa,aAcrB;IAEF,SAAS,CAAC,YAAY,aAMpB;IAEF,SAAS,CAAC,aAAa,aAIrB;IAEF,SAAS,CAAC,gBAAgB,WAAY,MAAM,UAG1C;IAEF,SAAS,CAAC,WAAW,aAInB;IAEF,SAAS,CAAC,iBAAiB,aAEzB;CAWL"}

package/dist/esm/environment/ProcessManager.js

@@ -0,0 +1,92 @@
+/**
+ * @license
+ * Copyright 2022-2024 Matter.js Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { Logger, RuntimeService } from "#general";
+const logger = Logger.get("ProcessManager");
+class ProcessManager {
+  constructor(env) {
+    this.env = env;
+    this.runtime = env.get(RuntimeService);
+    this.runtime.started.on(this.startListener);
+    this.runtime.stopped.on(this.stopListener);
+    this.runtime.crashed.on(this.crashListener);
+    if (this.hasUnhandledErrorSupport) {
+      process.addListener("uncaughtExceptionMonitor", (event) => {
+        Logger.reportUnhandledError(event);
+      });
+    }
+  }
+  runtime;
+  #signalHandlersInstalled = false;
+  close() {
+    this.runtime.started.off(this.startListener);
+    this.runtime.stopped.off(this.stopListener);
+    this.runtime.crashed.off(this.crashListener);
+    this.#ignoreSignals();
+  }
+  [Symbol.dispose]() {
+    this.close();
+  }
+  get hasSignalSupport() {
+    return this.env.vars.get("runtime.signals", true);
+  }
+  get hasExitCodeSupport() {
+    return this.env.vars.get("runtime.exitcode", true);
+  }
+  get hasUnhandledErrorSupport() {
+    return this.env.vars.get("runtime.unhandlederrors", true);
+  }
+  startListener = () => {
+    this.env.vars.use(() => {
+      if (this.hasSignalSupport) {
+        if (this.#signalHandlersInstalled) {
+          return;
+        }
+        process.on("SIGINT", this.interruptHandler);
+        process.on("SIGTERM", this.interruptHandler);
+        process.on("SIGUSR2", this.diagnosticHandler);
+        process.on("exit", this.exitHandler);
+      } else {
+        this.#ignoreSignals();
+      }
+    });
+  };
+  stopListener = () => {
+    this.#ignoreSignals();
+    if (this.hasExitCodeSupport && process.exitCode === void 0) {
+      process.exitCode = 0;
+    }
+  };
+  crashListener = () => {
+    if (this.hasExitCodeSupport) {
+      process.exitCode = 1;
+    }
+  };
+  interruptHandler = (signal) => {
+    process.off(signal, this.interruptHandler);
+    this.runtime.cancel();
+  };
+  exitHandler = () => {
+    if (process.exitCode === 13) {
+      logger.error("Internal error: Premature process exit because ongoing work has stalled");
+    }
+  };
+  diagnosticHandler = () => {
+    this.env.diagnose();
+  };
+  #ignoreSignals() {
+    if (this.#signalHandlersInstalled) {
+      process.off("SIGINT", this.interruptHandler);
+      process.off("SIGTERM", this.interruptHandler);
+      process.off("SIGUSR2", this.diagnosticHandler);
+      process.off("exit", this.exitHandler);
+      this.#signalHandlersInstalled = false;
+    }
+  }
+}
+export {
+  ProcessManager
+};
+//# sourceMappingURL=ProcessManager.js.map

package/dist/esm/environment/ProcessManager.js.map

@@ -0,0 +1,6 @@
+{
+  "version": 3,
+  "sources": ["../../../src/environment/ProcessManager.ts"],
+  "mappings": "AAAA;AAAA;AAAA;AAAA;AAAA;AAMA,SAAoC,QAAQ,sBAAuC;AAGnF,MAAM,SAAS,OAAO,IAAI,gBAAgB;AAuBnC,MAAM,eAAuC;AAAA,EAIhD,YAAsB,KAAkB;AAAlB;AAClB,SAAK,UAAU,IAAI,IAAI,cAAc;AAErC,SAAK,QAAQ,QAAQ,GAAG,KAAK,aAAa;AAC1C,SAAK,QAAQ,QAAQ,GAAG,KAAK,YAAY;AACzC,SAAK,QAAQ,QAAQ,GAAG,KAAK,aAAa;AAE1C,QAAI,KAAK,0BAA0B;AAC/B,cAAQ,YAAY,4BAA4B,WAAS;AACrD,eAAO,qBAAqB,KAAK;AAAA,MACrC,CAAC;AAAA,IACL;AAAA,EACJ;AAAA,EAfU;AAAA,EACV,2BAA2B;AAAA,EAgB3B,QAAQ;AACJ,SAAK,QAAQ,QAAQ,IAAI,KAAK,aAAa;AAC3C,SAAK,QAAQ,QAAQ,IAAI,KAAK,YAAY;AAC1C,SAAK,QAAQ,QAAQ,IAAI,KAAK,aAAa;AAC3C,SAAK,eAAe;AAAA,EACxB;AAAA,EAEA,CAAC,OAAO,OAAO,IAAI;AACf,SAAK,MAAM;AAAA,EACf;AAAA,EAEA,IAAc,mBAAmB;AAC7B,WAAO,KAAK,IAAI,KAAK,IAAI,mBAAmB,IAAI;AAAA,EACpD;AAAA,EAEA,IAAc,qBAAqB;AAC/B,WAAO,KAAK,IAAI,KAAK,IAAI,oBAAoB,IAAI;AAAA,EACrD;AAAA,EAEA,IAAc,2BAA2B;AACrC,WAAO,KAAK,IAAI,KAAK,IAAI,2BAA2B,IAAI;AAAA,EAC5D;AAAA,EAEU,gBAAgB,MAAM;AAC5B,SAAK,IAAI,KAAK,IAAI,MAAM;AACpB,UAAI,KAAK,kBAAkB;AACvB,YAAI,KAAK,0BAA0B;AAC/B;AAAA,QACJ;AACA,gBAAQ,GAAG,UAAU,KAAK,gBAAgB;AAC1C,gBAAQ,GAAG,WAAW,KAAK,gBAAgB;AAC3C,gBAAQ,GAAG,WAAW,KAAK,iBAAiB;AAC5C,gBAAQ,GAAG,QAAQ,KAAK,WAAW;AAAA,MACvC,OAAO;AACH,aAAK,eAAe;AAAA,MACxB;AAAA,IACJ,CAAC;AAAA,EACL;AAAA,EAEU,eAAe,MAAM;AAC3B,SAAK,eAAe;AAEpB,QAAI,KAAK,sBAAsB,QAAQ,aAAa,QAAW;AAC3D,cAAQ,WAAW;AAAA,IACvB;AAAA,EACJ;AAAA,EAEU,gBAAgB,MAAM;AAC5B,QAAI,KAAK,oBAAoB;AACzB,cAAQ,WAAW;AAAA,IACvB;AAAA,EACJ;AAAA,EAEU,mBAAmB,CAAC,WAAmB;AAC7C,YAAQ,IAAI,QAAQ,KAAK,gBAAgB;AACzC,SAAK,QAAQ,OAAO;AAAA,EACxB;AAAA,EAEU,cAAc,MAAM;AAC1B,QAAI,QAAQ,aAAa,IAAI;AACzB,aAAO,MAAM,yEAAyE;AAAA,IAC1F;AAAA,EACJ;AAAA,EAEU,oBAAoB,MAAM;AAChC,SAAK,IAAI,SAAS;AAAA,EACtB;AAAA,EAEA,iBAAiB;AACb,QAAI,KAAK,0BAA0B;AAC/B,cAAQ,IAAI,UAAU,KAAK,gBAAgB;AAC3C,cAAQ,IAAI,WAAW,KAAK,gBAAgB;AAC5C,cAAQ,IAAI,WAAW,KAAK,iBAAiB;AAC7C,cAAQ,IAAI,QAAQ,KAAK,WAAW;AACpC,WAAK,2BAA2B;AAAA,IACpC;AAAA,EACJ;AACJ;",
+  "names": []
+}

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

@@ -0,0 +1,10 @@
+/**
+ * @license
+ * Copyright 2022-2024 Matter.js Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import "./register.js";
+export * from "./NodeJsActionTracer.js";
+export * from "./NodeJsEnvironment.js";
+export * from "./ProcessManager.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/environment/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,eAAe,CAAC;AACvB,cAAc,yBAAyB,CAAC;AACxC,cAAc,wBAAwB,CAAC;AACvC,cAAc,qBAAqB,CAAC"}

package/dist/esm/environment/index.js

@@ -0,0 +1,10 @@
+/**
+ * @license
+ * Copyright 2022-2024 Matter.js Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import "./register.js";
+export * from "./NodeJsActionTracer.js";
+export * from "./NodeJsEnvironment.js";
+export * from "./ProcessManager.js";
+//# sourceMappingURL=index.js.map

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

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

package/dist/esm/environment/register.d.ts

@@ -0,0 +1,7 @@
+/**
+ * @license
+ * Copyright 2022-2024 Matter.js Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+export {};
+//# sourceMappingURL=register.d.ts.map

package/dist/esm/environment/register.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"register.d.ts","sourceRoot":"","sources":["../../../src/environment/register.ts"],"names":[],"mappings":"AAAA;;;;GAIG"}

package/dist/esm/environment/register.js

@@ -0,0 +1,9 @@
+/**
+ * @license
+ * Copyright 2022-2024 Matter.js Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { Environment } from "#general";
+import { NodeJsEnvironment } from "./NodeJsEnvironment.js";
+Environment.default = NodeJsEnvironment();
+//# sourceMappingURL=register.js.map

package/dist/esm/environment/register.js.map

@@ -0,0 +1,6 @@
+{
+  "version": 3,
+  "sources": ["../../../src/environment/register.ts"],
+  "mappings": "AAAA;AAAA;AAAA;AAAA;AAAA;AAMA,SAAS,mBAAmB;AAC5B,SAAS,yBAAyB;AAElC,YAAY,UAAU,kBAAkB;",
+  "names": []
+}

package/dist/esm/index.d.ts

@@ -0,0 +1,12 @@
+/**
+ * @license
+ * Copyright 2022-2024 Matter.js Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+export * from "./behavior/index.js";
+export * from "./crypto/index.js";
+export * from "./environment/index.js";
+export * from "./log/index.js";
+export * from "./net/index.js";
+export * from "./storage/index.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,cAAc,qBAAqB,CAAC;AACpC,cAAc,mBAAmB,CAAC;AAClC,cAAc,wBAAwB,CAAC;AACvC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,oBAAoB,CAAC"}

package/dist/esm/index.js

@@ -0,0 +1,12 @@
+/**
+ * @license
+ * Copyright 2022-2024 Matter.js Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+export * from "./behavior/index.js";
+export * from "./crypto/index.js";
+export * from "./environment/index.js";
+export * from "./log/index.js";
+export * from "./net/index.js";
+export * from "./storage/index.js";
+//# sourceMappingURL=index.js.map

package/dist/esm/index.js.map

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

package/dist/esm/log/FileLogger.d.ts

@@ -0,0 +1,13 @@
+/**
+ * @license
+ * Copyright 2022-2024 Matter.js Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { LogLevel } from "#general";
+/**
+ * Creates a file based logger to append to the given path.
+ * The file is opened on start and closed when the process shuts down.
+ * Errors are logged to the console.
+ */
+export declare function createFileLogger(path: string): Promise<(_level: LogLevel, formattedLog: string) => void>;
+//# sourceMappingURL=FileLogger.d.ts.map

package/dist/esm/log/FileLogger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"FileLogger.d.ts","sourceRoot":"","sources":["../../../src/log/FileLogger.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,QAAQ,EAAE,MAAM,UAAU,CAAC;AAGpC;;;;GAIG;AACH,wBAAsB,gBAAgB,CAAC,IAAI,EAAE,MAAM,oBAQ/B,QAAQ,gBAAgB,MAAM,WAOjD"}

package/dist/esm/log/FileLogger.js

@@ -0,0 +1,26 @@
+/**
+ * @license
+ * Copyright 2022-2024 Matter.js Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { open } from "fs/promises";
+async function createFileLogger(path) {
+  const fileHandle = await open(path, "a");
+  const writer = fileHandle.createWriteStream();
+  process.on(
+    "beforeExit",
+    () => void fileHandle.close().catch((err) => err && console.error(`Failed to close log file: ${err}`))
+  );
+  return (_level, formattedLog) => {
+    try {
+      writer.write(`${formattedLog}
+`);
+    } catch (error) {
+      console.error(`Failed to write to log file: ${error}`);
+    }
+  };
+}
+export {
+  createFileLogger
+};
+//# sourceMappingURL=FileLogger.js.map

package/dist/esm/log/FileLogger.js.map

@@ -0,0 +1,6 @@
+{
+  "version": 3,
+  "sources": ["../../../src/log/FileLogger.ts"],
+  "mappings": "AAAA;AAAA;AAAA;AAAA;AAAA;AAOA,SAAS,YAAY;AAOrB,eAAsB,iBAAiB,MAAc;AACjD,QAAM,aAAa,MAAM,KAAK,MAAM,GAAG;AACvC,QAAM,SAAS,WAAW,kBAAkB;AAC5C,UAAQ;AAAA,IACJ;AAAA,IACA,MAAM,KAAK,WAAW,MAAM,EAAE,MAAM,SAAO,OAAO,QAAQ,MAAM,6BAA6B,GAAG,EAAE,CAAC;AAAA,EACvG;AAEA,SAAO,CAAC,QAAkB,iBAAyB;AAC/C,QAAI;AACA,aAAO,MAAM,GAAG,YAAY;AAAA,CAAI;AAAA,IACpC,SAAS,OAAO;AACZ,cAAQ,MAAM,gCAAgC,KAAK,EAAE;AAAA,IACzD;AAAA,EACJ;AACJ;",
+  "names": []
+}

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

@@ -0,0 +1,7 @@
+/**
+ * @license
+ * Copyright 2022-2024 Matter.js Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+export * from "./FileLogger.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/log/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,cAAc,iBAAiB,CAAC"}

package/dist/esm/log/index.js

@@ -0,0 +1,7 @@
+/**
+ * @license
+ * Copyright 2022-2024 Matter.js Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+export * from "./FileLogger.js";
+//# sourceMappingURL=index.js.map

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

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

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

@@ -0,0 +1,27 @@
+/**
+ * @license
+ * Copyright 2022-2024 Matter.js Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { Network, NetworkInterface, NetworkInterfaceDetails, UdpChannel, UdpChannelOptions } from "#general";
+export declare class NodeJsNetwork extends Network {
+    static getMulticastInterfaceIpv4(netInterface: string): string | undefined;
+    static getMembershipMulticastInterfaces(netInterface: string | undefined, ipv4: boolean): (string | undefined)[];
+    static getNetInterfaceZoneIpv6(netInterface: string): string | undefined;
+    static getNetInterfaceForIp(ip: string): string | undefined;
+    private static readonly netInterfaces;
+    close(): Promise<void>;
+    private static getNetInterfaceForRemoteAddress;
+    private static getNetInterfaceZoneIpv6Internal;
+    /**
+     * Get all network interfaces.
+     * The optional configuration parameter allows to map interface names to types if this mapping is known.
+     * Each network interface which has no mapped type is returned as Ethernet for now.
+     *
+     * @param configuration - An array of objects with the name and type properties.
+     */
+    getNetInterfaces(configuration?: NetworkInterface[]): NetworkInterface[];
+    getIpMac(netInterface: string): NetworkInterfaceDetails | undefined;
+    createUdpChannel(options: UdpChannelOptions): Promise<UdpChannel>;
+}
+//# sourceMappingURL=NodeJsNetwork.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"NodeJsNetwork.d.ts","sourceRoot":"","sources":["../../../src/net/NodeJsNetwork.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAKH,OAAO,EAEP,gBAAgB,EAChB,uBAAuB,EAEvB,UAAU,EACV,iBAAiB,EACpB,MAAM,UAAU,CAAC;AAMlB,qBAAa,aAAc,SAAQ,OAAO;IACtC,MAAM,CAAC,yBAAyB,CAAC,YAAY,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS;IAW1E,MAAM,CAAC,gCAAgC,CAAC,YAAY,EAAE,MAAM,GAAG,SAAS,EAAE,IAAI,EAAE,OAAO,GAAG,CAAC,MAAM,GAAG,SAAS,CAAC,EAAE;IAwBhH,MAAM,CAAC,uBAAuB,CAAC,YAAY,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS;IAMxE,MAAM,CAAC,oBAAoB,CAAC,EAAE,EAAE,MAAM;IAMtC,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,aAAa,CAInC;IAEa,KAAK;IAIpB,OAAO,CAAC,MAAM,CAAC,+BAA+B;IAwB9C,OAAO,CAAC,MAAM,CAAC,+BAA+B;IAa9C;;;;;;OAMG;IACH,gBAAgB,CAAC,aAAa,GAAE,gBAAgB,EAAO,GAAG,gBAAgB,EAAE;IAmB5E,QAAQ,CAAC,YAAY,EAAE,MAAM,GAAG,uBAAuB,GAAG,SAAS;IAQ1D,gBAAgB,CAAC,OAAO,EAAE,iBAAiB,GAAG,OAAO,CAAC,UAAU,CAAC;CAG7E"}

package/dist/esm/net/NodeJsNetwork.js

@@ -0,0 +1,133 @@
+/**
+ * @license
+ * Copyright 2022-2024 Matter.js Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import {
+  Cache,
+  InterfaceType,
+  isIPv6,
+  Logger,
+  Network,
+  NetworkError,
+  onSameNetwork
+} from "#general";
+import { networkInterfaces } from "os";
+import { NodeJsUdpChannel } from "./NodeJsUdpChannel.js";
+const logger = Logger.get("NetworkNode");
+class NodeJsNetwork extends Network {
+  static getMulticastInterfaceIpv4(netInterface) {
+    const netInterfaceInfo = networkInterfaces()[netInterface];
+    if (netInterfaceInfo === void 0) throw new NetworkError(`Unknown interface: ${netInterface}`);
+    for (const { address, family } of netInterfaceInfo) {
+      if (family === "IPv4") {
+        return address;
+      }
+    }
+    return void 0;
+  }
+  static getMembershipMulticastInterfaces(netInterface, ipv4) {
+    if (ipv4) {
+      return [void 0];
+    } else {
+      let networkInterfaceEntries = Object.entries(networkInterfaces());
+      if (netInterface !== void 0) {
+        networkInterfaceEntries = networkInterfaceEntries.filter(([name]) => name === netInterface);
+      }
+      const multicastInterfaces = networkInterfaceEntries.flatMap(([netInterface2, netInterfaceInfo]) => {
+        if (netInterfaceInfo === void 0) return [];
+        const zone = this.getNetInterfaceZoneIpv6Internal(netInterface2, netInterfaceInfo);
+        return zone === void 0 ? [] : [`::%${zone}`];
+      });
+      if (multicastInterfaces.length === 0) {
+        logger.warn(
+          `No IPv6 multicast interface found${netInterface !== void 0 ? ` for interface ${netInterface}` : ""}.`
+        );
+      }
+      return multicastInterfaces;
+    }
+  }
+  static getNetInterfaceZoneIpv6(netInterface) {
+    const netInterfaceInfo = networkInterfaces()[netInterface];
+    if (netInterfaceInfo === void 0) throw new NetworkError(`Unknown interface: ${netInterface}`);
+    return this.getNetInterfaceZoneIpv6Internal(netInterface, netInterfaceInfo);
+  }
+  static getNetInterfaceForIp(ip) {
+    return this.netInterfaces.get(ip);
+  }
+  static netInterfaces = new Cache(
+    "Network interface",
+    (ip) => this.getNetInterfaceForRemoteAddress(ip),
+    5 * 60 * 1e3
+  );
+  async close() {
+    await NodeJsNetwork.netInterfaces.close();
+  }
+  static getNetInterfaceForRemoteAddress(ip) {
+    if (ip.includes("%")) {
+      return ip.split("%")[1];
+    } else {
+      const interfaces = networkInterfaces();
+      for (const name in interfaces) {
+        const netInterfaces = interfaces[name];
+        for (const { address, netmask } of netInterfaces) {
+          if (onSameNetwork(ip, address, netmask)) {
+            return this.getNetInterfaceZoneIpv6Internal(name, netInterfaces);
+          }
+        }
+      }
+      if (isIPv6(ip)) {
+        if (ip.startsWith("fd")) {
+          return "";
+        }
+      }
+      return void 0;
+    }
+  }
+  static getNetInterfaceZoneIpv6Internal(netInterface, netInterfaceInfos) {
+    if (process.platform !== "win32") {
+      return netInterface;
+    }
+    if (netInterfaceInfos === void 0) return void 0;
+    return netInterfaceInfos.find(({ address, family }) => family === "IPv6" && address.startsWith("fe80::"))?.scopeid?.toString();
+  }
+  /**
+   * Get all network interfaces.
+   * The optional configuration parameter allows to map interface names to types if this mapping is known.
+   * Each network interface which has no mapped type is returned as Ethernet for now.
+   *
+   * @param configuration - An array of objects with the name and type properties.
+   */
+  getNetInterfaces(configuration = []) {
+    const result = new Array();
+    const interfaces = networkInterfaces();
+    for (const name in interfaces) {
+      const netInterfaces = interfaces[name];
+      if (netInterfaces.length === 0) continue;
+      if (netInterfaces[0].internal) continue;
+      let type = InterfaceType.Ethernet;
+      if (configuration.length > 0) {
+        const nameType = configuration.find(({ name: mapName }) => name === mapName);
+        if (nameType !== void 0 && nameType.type !== void 0) {
+          type = nameType.type;
+        }
+      }
+      result.push({ name, type });
+    }
+    return result;
+  }
+  getIpMac(netInterface) {
+    const netInterfaceInfo = networkInterfaces()[netInterface];
+    if (netInterfaceInfo === void 0) return void 0;
+    const ipV4 = netInterfaceInfo.filter(({ family }) => family === "IPv4").map(({ address }) => address);
+    const ipV6 = netInterfaceInfo.filter(({ family }) => family === "IPv6").map(({ address }) => address);
+    return { mac: netInterfaceInfo[0].mac, ipV4, ipV6 };
+  }
+  createUdpChannel(options) {
+    return NodeJsUdpChannel.create(options);
+  }
+}
+export {
+  NodeJsNetwork
+};
+//# sourceMappingURL=NodeJsNetwork.js.map

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

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

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

@@ -0,0 +1,23 @@
+/**
+ * @license
+ * Copyright 2022-2024 Matter.js Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { ChannelType, UdpChannel, UdpChannelOptions } from "#general";
+import * as dgram from "dgram";
+export declare class NodeJsUdpChannel implements UdpChannel {
+    private readonly type;
+    private readonly socket;
+    private readonly netInterface?;
+    static create({ listeningPort, type, listeningAddress, netInterface, membershipAddresses, }: UdpChannelOptions): Promise<NodeJsUdpChannel>;
+    readonly maxPayloadSize: number;
+    constructor(type: "udp4" | "udp6", socket: dgram.Socket, netInterface?: string | undefined);
+    onData(listener: (netInterface: string, peerAddress: string, peerPort: number, data: Uint8Array) => void): {
+        close: () => Promise<void>;
+    };
+    send(host: string, port: number, data: Uint8Array): Promise<void>;
+    close(): Promise<void>;
+    get port(): number;
+    supports(type: ChannelType, address?: string): boolean;
+}
+//# sourceMappingURL=NodeJsUdpChannel.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"NodeJsUdpChannel.d.ts","sourceRoot":"","sources":["../../../src/net/NodeJsUdpChannel.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EACH,WAAW,EAOX,UAAU,EACV,iBAAiB,EACpB,MAAM,UAAU,CAAC;AAElB,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAiC/B,qBAAa,gBAAiB,YAAW,UAAU;IA6D3C,OAAO,CAAC,QAAQ,CAAC,IAAI;IACrB,OAAO,CAAC,QAAQ,CAAC,MAAM;IACvB,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAC;WA9DrB,MAAM,CAAC,EAChB,aAAa,EACb,IAAI,EACJ,gBAAgB,EAChB,YAAY,EACZ,mBAAmB,GACtB,EAAE,iBAAiB;IAmDpB,QAAQ,CAAC,cAAc,SAAwB;gBAG1B,IAAI,EAAE,MAAM,GAAG,MAAM,EACrB,MAAM,EAAE,KAAK,CAAC,MAAM,EACpB,YAAY,CAAC,EAAE,MAAM,YAAA;IAG1C,MAAM,CAAC,QAAQ,EAAE,CAAC,YAAY,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,UAAU,KAAK,IAAI;;;IAelG,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,UAAU;IAiBjD,KAAK;IAQX,IAAI,IAAI,WAEP;IAED,QAAQ,CAAC,IAAI,EAAE,WAAW,EAAE,OAAO,CAAC,EAAE,MAAM;CAiB/C"}