@matter/general 0.13.0-alpha.0-20250324-d7b7d9731 → 0.13.0-alpha.0-20250325-ddb67eace

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

@@ -8,6 +8,8 @@ import { MaybePromise } from "../util/Promises.js";
 import { UdpChannel, UdpChannelOptions } from "./UdpChannel.js";
 export declare class NetworkError extends MatterError {
 }
+export declare class NoAddressAvailableError extends NetworkError {
+}
 /**
  * @see {@link MatterSpecification.v11.Core} § 11.11.4.4
  * Duplicated from the GeneralDiagnostics cluster to avoid circular dependencies.

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

@@ -1 +1 @@
-{"version":3,"file":"Network.d.ts","sourceRoot":"","sources":["../../../src/net/Network.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,WAAW,EAAmB,MAAM,mBAAmB,CAAC;AACjE,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACnD,OAAO,EAAE,UAAU,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AAEhE,qBAAa,YAAa,SAAQ,WAAW;CAAG;AAEhD;;;GAGG;AACH,oBAAY,aAAa;IACrB;;OAEG;IACH,WAAW,IAAI;IAEf;;OAEG;IACH,IAAI,IAAI;IAER;;OAEG;IACH,QAAQ,IAAI;IAEZ;;OAEG;IACH,QAAQ,IAAI;IAEZ;;OAEG;IACH,MAAM,IAAI;CACb;AAED,MAAM,MAAM,gBAAgB,GAAG;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,aAAa,CAAC;CACxB,CAAC;AAEF,MAAM,MAAM,uBAAuB,GAAG;IAClC,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,IAAI,EAAE,MAAM,EAAE,CAAC;CAClB,CAAC;AAEF,MAAM,MAAM,wBAAwB,GAAG,gBAAgB,GAAG,uBAAuB,CAAC;AAElF,8BAAsB,OAAO;IAEzB,MAAM,CAAC,GAAG,EAAE,MAAM,OAAO,CAEvB;IAEF,QAAQ,CAAC,gBAAgB,CAAC,aAAa,CAAC,EAAE,gBAAgB,EAAE,GAAG,YAAY,CAAC,gBAAgB,EAAE,CAAC;IAC/F,QAAQ,CAAC,QAAQ,CAAC,YAAY,EAAE,MAAM,GAAG,YAAY,CAAC,uBAAuB,GAAG,SAAS,CAAC;IAC1F,QAAQ,CAAC,gBAAgB,CAAC,OAAO,EAAE,iBAAiB,GAAG,OAAO,CAAC,UAAU,CAAC;IAEpE,KAAK;CAGd"}
+{"version":3,"file":"Network.d.ts","sourceRoot":"","sources":["../../../src/net/Network.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,WAAW,EAAmB,MAAM,mBAAmB,CAAC;AACjE,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACnD,OAAO,EAAE,UAAU,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AAEhE,qBAAa,YAAa,SAAQ,WAAW;CAAG;AAEhD,qBAAa,uBAAwB,SAAQ,YAAY;CAAG;AAE5D;;;GAGG;AACH,oBAAY,aAAa;IACrB;;OAEG;IACH,WAAW,IAAI;IAEf;;OAEG;IACH,IAAI,IAAI;IAER;;OAEG;IACH,QAAQ,IAAI;IAEZ;;OAEG;IACH,QAAQ,IAAI;IAEZ;;OAEG;IACH,MAAM,IAAI;CACb;AAED,MAAM,MAAM,gBAAgB,GAAG;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,aAAa,CAAC;CACxB,CAAC;AAEF,MAAM,MAAM,uBAAuB,GAAG;IAClC,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,IAAI,EAAE,MAAM,EAAE,CAAC;CAClB,CAAC;AAEF,MAAM,MAAM,wBAAwB,GAAG,gBAAgB,GAAG,uBAAuB,CAAC;AAElF,8BAAsB,OAAO;IAEzB,MAAM,CAAC,GAAG,EAAE,MAAM,OAAO,CAEvB;IAEF,QAAQ,CAAC,gBAAgB,CAAC,aAAa,CAAC,EAAE,gBAAgB,EAAE,GAAG,YAAY,CAAC,gBAAgB,EAAE,CAAC;IAC/F,QAAQ,CAAC,QAAQ,CAAC,YAAY,EAAE,MAAM,GAAG,YAAY,CAAC,uBAAuB,GAAG,SAAS,CAAC;IAC1F,QAAQ,CAAC,gBAAgB,CAAC,OAAO,EAAE,iBAAiB,GAAG,OAAO,CAAC,UAAU,CAAC;IAEpE,KAAK;CAGd"}

package/dist/cjs/net/Network.js

@@ -20,7 +20,8 @@ var Network_exports = {};
 __export(Network_exports, {
   InterfaceType: () => InterfaceType,
   Network: () => Network,
-  NetworkError: () => NetworkError
+  NetworkError: () => NetworkError,
+  NoAddressAvailableError: () => NoAddressAvailableError
 });
 module.exports = __toCommonJS(Network_exports);
 var import_MatterError = require("../MatterError.js");
@@ -31,6 +32,8 @@ var import_MatterError = require("../MatterError.js");
  */
 class NetworkError extends import_MatterError.MatterError {
 }
+class NoAddressAvailableError extends NetworkError {
+}
 var InterfaceType = /* @__PURE__ */ ((InterfaceType2) => {
   InterfaceType2[InterfaceType2["Unspecified"] = 0] = "Unspecified";
   InterfaceType2[InterfaceType2["WiFi"] = 1] = "WiFi";

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

@@ -1,6 +1,6 @@
 {
   "version": 3,
   "sources": ["../../../src/net/Network.ts"],
-  "mappings": ";;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAMA,yBAA6C;AAN7C;AAAA;AAAA;AAAA;AAAA;AAUO,MAAM,qBAAqB,+BAAY;AAAC;AAMxC,IAAK,gBAAL,kBAAKA,mBAAL;AAIH,EAAAA,8BAAA,iBAAc,KAAd;AAKA,EAAAA,8BAAA,UAAO,KAAP;AAKA,EAAAA,8BAAA,cAAW,KAAX;AAKA,EAAAA,8BAAA,cAAW,KAAX;AAKA,EAAAA,8BAAA,YAAS,KAAT;AAxBQ,SAAAA;AAAA,GAAA;AAwCL,MAAe,QAAQ;AAAA;AAAA,EAE1B,OAAO,MAAqB,MAAM;AAC9B,UAAM,IAAI,mCAAgB,wBAAwB;AAAA,EACtD;AAAA,EAMA,MAAM,QAAQ;AAAA,EAEd;AACJ;",
+  "mappings": ";;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAMA,yBAA6C;AAN7C;AAAA;AAAA;AAAA;AAAA;AAUO,MAAM,qBAAqB,+BAAY;AAAC;AAExC,MAAM,gCAAgC,aAAa;AAAC;AAMpD,IAAK,gBAAL,kBAAKA,mBAAL;AAIH,EAAAA,8BAAA,iBAAc,KAAd;AAKA,EAAAA,8BAAA,UAAO,KAAP;AAKA,EAAAA,8BAAA,cAAW,KAAX;AAKA,EAAAA,8BAAA,cAAW,KAAX;AAKA,EAAAA,8BAAA,YAAS,KAAT;AAxBQ,SAAAA;AAAA,GAAA;AAwCL,MAAe,QAAQ;AAAA;AAAA,EAE1B,OAAO,MAAqB,MAAM;AAC9B,UAAM,IAAI,mCAAgB,wBAAwB;AAAA,EACtD;AAAA,EAMA,MAAM,QAAQ;AAAA,EAEd;AACJ;",
   "names": ["InterfaceType"]
 }

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

@@ -1 +1 @@
-{"version":3,"file":"UdpMulticastServer.d.ts","sourceRoot":"","sources":["../../../src/net/UdpMulticastServer.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAOH,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAKvC,MAAM,WAAW,yBAAyB;IACtC,OAAO,EAAE,OAAO,CAAC;IACjB,aAAa,EAAE,MAAM,CAAC;IACtB,oBAAoB,EAAE,MAAM,CAAC;IAC7B,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAC9B,YAAY,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,qBAAa,kBAAkB;IAuCvB,OAAO,CAAC,QAAQ,CAAC,OAAO;IACxB,OAAO,CAAC,QAAQ,CAAC,oBAAoB;IACrC,OAAO,CAAC,QAAQ,CAAC,oBAAoB;IACrC,OAAO,CAAC,QAAQ,CAAC,aAAa;IAC9B,OAAO,CAAC,QAAQ,CAAC,UAAU;IAC3B,OAAO,CAAC,QAAQ,CAAC,UAAU;IAC3B,OAAO,CAAC,QAAQ,CAAC,YAAY;WA5CpB,MAAM,CAAC,EAChB,YAAY,EACZ,oBAAoB,EACpB,oBAAoB,EACpB,aAAa,EACb,OAAO,GACV,EAAE,yBAAyB;IAwB5B,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAKhC;IAEF,OAAO;IAUP,SAAS,CAAC,QAAQ,EAAE,CAAC,OAAO,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,KAAK,IAAI;IAStF,IAAI,CAAC,OAAO,EAAE,UAAU,EAAE,YAAY,CAAC,EAAE,MAAM,EAAE,aAAa,CAAC,EAAE,MAAM;YA+C/D,sBAAsB;IAQ9B,KAAK;CAKd"}
+{"version":3,"file":"UdpMulticastServer.d.ts","sourceRoot":"","sources":["../../../src/net/UdpMulticastServer.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAOH,OAAO,EAAE,OAAO,EAA2B,MAAM,cAAc,CAAC;AAKhE,MAAM,WAAW,yBAAyB;IACtC,OAAO,EAAE,OAAO,CAAC;IACjB,aAAa,EAAE,MAAM,CAAC;IACtB,oBAAoB,EAAE,MAAM,CAAC;IAC7B,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAC9B,YAAY,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,qBAAa,kBAAkB;IAqDvB,OAAO,CAAC,QAAQ,CAAC,OAAO;IACxB,OAAO,CAAC,QAAQ,CAAC,oBAAoB;IACrC,OAAO,CAAC,QAAQ,CAAC,oBAAoB;IACrC,OAAO,CAAC,QAAQ,CAAC,aAAa;IAC9B,OAAO,CAAC,QAAQ,CAAC,UAAU;IAC3B,OAAO,CAAC,QAAQ,CAAC,UAAU;IAC3B,OAAO,CAAC,QAAQ,CAAC,YAAY;WA1DpB,MAAM,CAAC,EAChB,YAAY,EACZ,oBAAoB,EACpB,oBAAoB,EACpB,aAAa,EACb,OAAO,GACV,EAAE,yBAAyB;IAsC5B,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAKhC;IAEF,OAAO;IAUP,SAAS,CAAC,QAAQ,EAAE,CAAC,OAAO,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,KAAK,IAAI;IAStF,IAAI,CAAC,OAAO,EAAE,UAAU,EAAE,YAAY,CAAC,EAAE,MAAM,EAAE,aAAa,CAAC,EAAE,MAAM;YA+C/D,sBAAsB;IAQ9B,KAAK;CAKd"}

package/dist/cjs/net/UdpMulticastServer.js

@@ -26,6 +26,7 @@ var import_Logger = require("../log/Logger.js");
 var import_Cache = require("../util/Cache.js");
 var import_Error = require("../util/Error.js");
 var import_Ip = require("../util/Ip.js");
+var import_Network = require("./Network.js");
 /**
  * @license
  * Copyright 2022-2025 Matter.js Authors
@@ -49,25 +50,40 @@ class UdpMulticastServer {
     listeningPort,
     network
   }) {
-    return new UdpMulticastServer(
-      network,
-      broadcastAddressIpv4,
-      broadcastAddressIpv6,
-      listeningPort,
-      broadcastAddressIpv4 === void 0 ? void 0 : await network.createUdpChannel({
-        type: "udp4",
-        netInterface,
-        listeningPort,
-        membershipAddresses: [broadcastAddressIpv4]
-      }),
-      await network.createUdpChannel({
-        type: "udp6",
-        netInterface,
+    let ipv4UdpChannel = void 0;
+    if (broadcastAddressIpv4 !== void 0) {
+      try {
+        ipv4UdpChannel = await network.createUdpChannel({
+          type: "udp4",
+          netInterface,
+          listeningPort,
+          membershipAddresses: [broadcastAddressIpv4]
+        });
+      } catch (error) {
+        import_Network.NoAddressAvailableError.accept(error);
+        logger.info(`IPv4 UDP channel not created because IPv4 is not available: ${(0, import_Error.asError)(error).message}`);
+      }
+    }
+    try {
+      return new UdpMulticastServer(
+        network,
+        broadcastAddressIpv4,
+        broadcastAddressIpv6,
         listeningPort,
-        membershipAddresses: [broadcastAddressIpv6]
-      }),
-      netInterface
-    );
+        ipv4UdpChannel,
+        await network.createUdpChannel({
+          type: "udp6",
+          netInterface,
+          listeningPort,
+          membershipAddresses: [broadcastAddressIpv6]
+        }),
+        netInterface
+      );
+    } catch (error) {
+      import_Network.NoAddressAvailableError.accept(error);
+      logger.info(`IPv6 UDP interface not created because IPv6 is not available, but required my Matter.`);
+      throw error;
+    }
   }
   broadcastChannels = new import_Cache.Cache(
     "UDP broadcast channel",

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

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

package/dist/cjs/transaction/Transaction.d.ts

@@ -144,16 +144,16 @@ export declare const Transaction: {
      */
     act<T>(via: string, actor: (transaction: Transaction) => MaybePromise<T>): MaybePromise<T>;
     ReadOnly: {
-        "__#14705@#participants": Set<Participant>;
-        "__#14705@#roles": Map<{}, Participant>;
-        "__#14705@#resources": Set<Resource>;
-        "__#14705@#status": Status;
-        "__#14705@#waitingOn"?: Iterable<Transaction>;
-        "__#14705@#via": string;
-        "__#14705@#shared"?: import("../index.js").Observable<[]>;
-        "__#14705@#closed"?: import("../index.js").Observable<[]>;
-        "__#14705@#isAsync": boolean;
-        "__#14705@#reportingLocks": boolean;
+        "__#14878@#participants": Set<Participant>;
+        "__#14878@#roles": Map<{}, Participant>;
+        "__#14878@#resources": Set<Resource>;
+        "__#14878@#status": Status;
+        "__#14878@#waitingOn"?: Iterable<Transaction>;
+        "__#14878@#via": string;
+        "__#14878@#shared"?: import("../index.js").Observable<[]>;
+        "__#14878@#closed"?: import("../index.js").Observable<[]>;
+        "__#14878@#isAsync": boolean;
+        "__#14878@#reportingLocks": boolean;
         close(): void;
         readonly via: string;
         readonly status: Status;
@@ -175,15 +175,15 @@ export declare const Transaction: {
         waitFor(others: Set<Transaction>): Promise<void>;
         toString(): string;
         treatAsSlow(): void;
-        "__#14705@#finalize"(status: Status, why: string, finalizer: () => MaybePromise): Promise<void> | undefined;
-        "__#14705@#executePreCommit"(): MaybePromise<void>;
-        "__#14705@#executeCommit"(): MaybePromise;
-        "__#14705@#executeCommit1"(): MaybePromise;
-        "__#14705@#executeCommit2"(): Promise<void> | undefined;
-        "__#14705@#executePostCommit"(participants: Participant[]): MaybePromise;
-        "__#14705@#executeRollback"(): Promise<void> | undefined;
-        "__#14705@#locksChanged"(resources: Set<Resource>, how?: string): void;
-        "__#14705@#assertAvailable"(): void;
+        "__#14878@#finalize"(status: Status, why: string, finalizer: () => MaybePromise): Promise<void> | undefined;
+        "__#14878@#executePreCommit"(): MaybePromise<void>;
+        "__#14878@#executeCommit"(): MaybePromise;
+        "__#14878@#executeCommit1"(): MaybePromise;
+        "__#14878@#executeCommit2"(): Promise<void> | undefined;
+        "__#14878@#executePostCommit"(participants: Participant[]): MaybePromise;
+        "__#14878@#executeRollback"(): Promise<void> | undefined;
+        "__#14878@#locksChanged"(resources: Set<Resource>, how?: string): void;
+        "__#14878@#assertAvailable"(): void;
     };
     Status: typeof Status;
     Resource: typeof Resource;

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

@@ -8,6 +8,8 @@ import { MaybePromise } from "../util/Promises.js";
 import { UdpChannel, UdpChannelOptions } from "./UdpChannel.js";
 export declare class NetworkError extends MatterError {
 }
+export declare class NoAddressAvailableError extends NetworkError {
+}
 /**
  * @see {@link MatterSpecification.v11.Core} § 11.11.4.4
  * Duplicated from the GeneralDiagnostics cluster to avoid circular dependencies.

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

@@ -1 +1 @@
-{"version":3,"file":"Network.d.ts","sourceRoot":"","sources":["../../../src/net/Network.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,WAAW,EAAmB,MAAM,mBAAmB,CAAC;AACjE,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACnD,OAAO,EAAE,UAAU,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AAEhE,qBAAa,YAAa,SAAQ,WAAW;CAAG;AAEhD;;;GAGG;AACH,oBAAY,aAAa;IACrB;;OAEG;IACH,WAAW,IAAI;IAEf;;OAEG;IACH,IAAI,IAAI;IAER;;OAEG;IACH,QAAQ,IAAI;IAEZ;;OAEG;IACH,QAAQ,IAAI;IAEZ;;OAEG;IACH,MAAM,IAAI;CACb;AAED,MAAM,MAAM,gBAAgB,GAAG;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,aAAa,CAAC;CACxB,CAAC;AAEF,MAAM,MAAM,uBAAuB,GAAG;IAClC,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,IAAI,EAAE,MAAM,EAAE,CAAC;CAClB,CAAC;AAEF,MAAM,MAAM,wBAAwB,GAAG,gBAAgB,GAAG,uBAAuB,CAAC;AAElF,8BAAsB,OAAO;IAEzB,MAAM,CAAC,GAAG,EAAE,MAAM,OAAO,CAEvB;IAEF,QAAQ,CAAC,gBAAgB,CAAC,aAAa,CAAC,EAAE,gBAAgB,EAAE,GAAG,YAAY,CAAC,gBAAgB,EAAE,CAAC;IAC/F,QAAQ,CAAC,QAAQ,CAAC,YAAY,EAAE,MAAM,GAAG,YAAY,CAAC,uBAAuB,GAAG,SAAS,CAAC;IAC1F,QAAQ,CAAC,gBAAgB,CAAC,OAAO,EAAE,iBAAiB,GAAG,OAAO,CAAC,UAAU,CAAC;IAEpE,KAAK;CAGd"}
+{"version":3,"file":"Network.d.ts","sourceRoot":"","sources":["../../../src/net/Network.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,WAAW,EAAmB,MAAM,mBAAmB,CAAC;AACjE,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACnD,OAAO,EAAE,UAAU,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AAEhE,qBAAa,YAAa,SAAQ,WAAW;CAAG;AAEhD,qBAAa,uBAAwB,SAAQ,YAAY;CAAG;AAE5D;;;GAGG;AACH,oBAAY,aAAa;IACrB;;OAEG;IACH,WAAW,IAAI;IAEf;;OAEG;IACH,IAAI,IAAI;IAER;;OAEG;IACH,QAAQ,IAAI;IAEZ;;OAEG;IACH,QAAQ,IAAI;IAEZ;;OAEG;IACH,MAAM,IAAI;CACb;AAED,MAAM,MAAM,gBAAgB,GAAG;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,aAAa,CAAC;CACxB,CAAC;AAEF,MAAM,MAAM,uBAAuB,GAAG;IAClC,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,IAAI,EAAE,MAAM,EAAE,CAAC;CAClB,CAAC;AAEF,MAAM,MAAM,wBAAwB,GAAG,gBAAgB,GAAG,uBAAuB,CAAC;AAElF,8BAAsB,OAAO;IAEzB,MAAM,CAAC,GAAG,EAAE,MAAM,OAAO,CAEvB;IAEF,QAAQ,CAAC,gBAAgB,CAAC,aAAa,CAAC,EAAE,gBAAgB,EAAE,GAAG,YAAY,CAAC,gBAAgB,EAAE,CAAC;IAC/F,QAAQ,CAAC,QAAQ,CAAC,YAAY,EAAE,MAAM,GAAG,YAAY,CAAC,uBAAuB,GAAG,SAAS,CAAC;IAC1F,QAAQ,CAAC,gBAAgB,CAAC,OAAO,EAAE,iBAAiB,GAAG,OAAO,CAAC,UAAU,CAAC;IAEpE,KAAK;CAGd"}

package/dist/esm/net/Network.js

@@ -6,6 +6,8 @@
 import { MatterError, NoProviderError } from "../MatterError.js";
 class NetworkError extends MatterError {
 }
+class NoAddressAvailableError extends NetworkError {
+}
 var InterfaceType = /* @__PURE__ */ ((InterfaceType2) => {
   InterfaceType2[InterfaceType2["Unspecified"] = 0] = "Unspecified";
   InterfaceType2[InterfaceType2["WiFi"] = 1] = "WiFi";
@@ -25,6 +27,7 @@ class Network {
 export {
   InterfaceType,
   Network,
-  NetworkError
+  NetworkError,
+  NoAddressAvailableError
 };
 //# sourceMappingURL=Network.js.map

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

@@ -1,6 +1,6 @@
 {
   "version": 3,
   "sources": ["../../../src/net/Network.ts"],
-  "mappings": "AAAA;AAAA;AAAA;AAAA;AAAA;AAMA,SAAS,aAAa,uBAAuB;AAItC,MAAM,qBAAqB,YAAY;AAAC;AAMxC,IAAK,gBAAL,kBAAKA,mBAAL;AAIH,EAAAA,8BAAA,iBAAc,KAAd;AAKA,EAAAA,8BAAA,UAAO,KAAP;AAKA,EAAAA,8BAAA,cAAW,KAAX;AAKA,EAAAA,8BAAA,cAAW,KAAX;AAKA,EAAAA,8BAAA,YAAS,KAAT;AAxBQ,SAAAA;AAAA,GAAA;AAwCL,MAAe,QAAQ;AAAA;AAAA,EAE1B,OAAO,MAAqB,MAAM;AAC9B,UAAM,IAAI,gBAAgB,wBAAwB;AAAA,EACtD;AAAA,EAMA,MAAM,QAAQ;AAAA,EAEd;AACJ;",
+  "mappings": "AAAA;AAAA;AAAA;AAAA;AAAA;AAMA,SAAS,aAAa,uBAAuB;AAItC,MAAM,qBAAqB,YAAY;AAAC;AAExC,MAAM,gCAAgC,aAAa;AAAC;AAMpD,IAAK,gBAAL,kBAAKA,mBAAL;AAIH,EAAAA,8BAAA,iBAAc,KAAd;AAKA,EAAAA,8BAAA,UAAO,KAAP;AAKA,EAAAA,8BAAA,cAAW,KAAX;AAKA,EAAAA,8BAAA,cAAW,KAAX;AAKA,EAAAA,8BAAA,YAAS,KAAT;AAxBQ,SAAAA;AAAA,GAAA;AAwCL,MAAe,QAAQ;AAAA;AAAA,EAE1B,OAAO,MAAqB,MAAM;AAC9B,UAAM,IAAI,gBAAgB,wBAAwB;AAAA,EACtD;AAAA,EAMA,MAAM,QAAQ;AAAA,EAEd;AACJ;",
   "names": ["InterfaceType"]
 }

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

@@ -1 +1 @@
-{"version":3,"file":"UdpMulticastServer.d.ts","sourceRoot":"","sources":["../../../src/net/UdpMulticastServer.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAOH,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAKvC,MAAM,WAAW,yBAAyB;IACtC,OAAO,EAAE,OAAO,CAAC;IACjB,aAAa,EAAE,MAAM,CAAC;IACtB,oBAAoB,EAAE,MAAM,CAAC;IAC7B,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAC9B,YAAY,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,qBAAa,kBAAkB;IAuCvB,OAAO,CAAC,QAAQ,CAAC,OAAO;IACxB,OAAO,CAAC,QAAQ,CAAC,oBAAoB;IACrC,OAAO,CAAC,QAAQ,CAAC,oBAAoB;IACrC,OAAO,CAAC,QAAQ,CAAC,aAAa;IAC9B,OAAO,CAAC,QAAQ,CAAC,UAAU;IAC3B,OAAO,CAAC,QAAQ,CAAC,UAAU;IAC3B,OAAO,CAAC,QAAQ,CAAC,YAAY;WA5CpB,MAAM,CAAC,EAChB,YAAY,EACZ,oBAAoB,EACpB,oBAAoB,EACpB,aAAa,EACb,OAAO,GACV,EAAE,yBAAyB;IAwB5B,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAKhC;IAEF,OAAO;IAUP,SAAS,CAAC,QAAQ,EAAE,CAAC,OAAO,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,KAAK,IAAI;IAStF,IAAI,CAAC,OAAO,EAAE,UAAU,EAAE,YAAY,CAAC,EAAE,MAAM,EAAE,aAAa,CAAC,EAAE,MAAM;YA+C/D,sBAAsB;IAQ9B,KAAK;CAKd"}
+{"version":3,"file":"UdpMulticastServer.d.ts","sourceRoot":"","sources":["../../../src/net/UdpMulticastServer.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAOH,OAAO,EAAE,OAAO,EAA2B,MAAM,cAAc,CAAC;AAKhE,MAAM,WAAW,yBAAyB;IACtC,OAAO,EAAE,OAAO,CAAC;IACjB,aAAa,EAAE,MAAM,CAAC;IACtB,oBAAoB,EAAE,MAAM,CAAC;IAC7B,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAC9B,YAAY,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,qBAAa,kBAAkB;IAqDvB,OAAO,CAAC,QAAQ,CAAC,OAAO;IACxB,OAAO,CAAC,QAAQ,CAAC,oBAAoB;IACrC,OAAO,CAAC,QAAQ,CAAC,oBAAoB;IACrC,OAAO,CAAC,QAAQ,CAAC,aAAa;IAC9B,OAAO,CAAC,QAAQ,CAAC,UAAU;IAC3B,OAAO,CAAC,QAAQ,CAAC,UAAU;IAC3B,OAAO,CAAC,QAAQ,CAAC,YAAY;WA1DpB,MAAM,CAAC,EAChB,YAAY,EACZ,oBAAoB,EACpB,oBAAoB,EACpB,aAAa,EACb,OAAO,GACV,EAAE,yBAAyB;IAsC5B,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAKhC;IAEF,OAAO;IAUP,SAAS,CAAC,QAAQ,EAAE,CAAC,OAAO,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,KAAK,IAAI;IAStF,IAAI,CAAC,OAAO,EAAE,UAAU,EAAE,YAAY,CAAC,EAAE,MAAM,EAAE,aAAa,CAAC,EAAE,MAAM;YA+C/D,sBAAsB;IAQ9B,KAAK;CAKd"}

package/dist/esm/net/UdpMulticastServer.js

@@ -8,6 +8,7 @@ import { Logger } from "../log/Logger.js";
 import { Cache } from "../util/Cache.js";
 import { asError } from "../util/Error.js";
 import { isIPv4 } from "../util/Ip.js";
+import { NoAddressAvailableError } from "./Network.js";
 const logger = Logger.get("UdpMulticastServer");
 class UdpMulticastServer {
   constructor(network, broadcastAddressIpv4, broadcastAddressIpv6, broadcastPort, serverIpv4, serverIpv6, netInterface) {
@@ -26,25 +27,40 @@ class UdpMulticastServer {
     listeningPort,
     network
   }) {
-    return new UdpMulticastServer(
-      network,
-      broadcastAddressIpv4,
-      broadcastAddressIpv6,
-      listeningPort,
-      broadcastAddressIpv4 === void 0 ? void 0 : await network.createUdpChannel({
-        type: "udp4",
-        netInterface,
-        listeningPort,
-        membershipAddresses: [broadcastAddressIpv4]
-      }),
-      await network.createUdpChannel({
-        type: "udp6",
-        netInterface,
+    let ipv4UdpChannel = void 0;
+    if (broadcastAddressIpv4 !== void 0) {
+      try {
+        ipv4UdpChannel = await network.createUdpChannel({
+          type: "udp4",
+          netInterface,
+          listeningPort,
+          membershipAddresses: [broadcastAddressIpv4]
+        });
+      } catch (error) {
+        NoAddressAvailableError.accept(error);
+        logger.info(`IPv4 UDP channel not created because IPv4 is not available: ${asError(error).message}`);
+      }
+    }
+    try {
+      return new UdpMulticastServer(
+        network,
+        broadcastAddressIpv4,
+        broadcastAddressIpv6,
         listeningPort,
-        membershipAddresses: [broadcastAddressIpv6]
-      }),
-      netInterface
-    );
+        ipv4UdpChannel,
+        await network.createUdpChannel({
+          type: "udp6",
+          netInterface,
+          listeningPort,
+          membershipAddresses: [broadcastAddressIpv6]
+        }),
+        netInterface
+      );
+    } catch (error) {
+      NoAddressAvailableError.accept(error);
+      logger.info(`IPv6 UDP interface not created because IPv6 is not available, but required my Matter.`);
+      throw error;
+    }
   }
   broadcastChannels = new Cache(
     "UDP broadcast channel",

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

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

package/dist/esm/transaction/Transaction.d.ts

@@ -144,16 +144,16 @@ export declare const Transaction: {
      */
     act<T>(via: string, actor: (transaction: Transaction) => MaybePromise<T>): MaybePromise<T>;
     ReadOnly: {
-        "__#14705@#participants": Set<Participant>;
-        "__#14705@#roles": Map<{}, Participant>;
-        "__#14705@#resources": Set<Resource>;
-        "__#14705@#status": Status;
-        "__#14705@#waitingOn"?: Iterable<Transaction>;
-        "__#14705@#via": string;
-        "__#14705@#shared"?: import("../index.js").Observable<[]>;
-        "__#14705@#closed"?: import("../index.js").Observable<[]>;
-        "__#14705@#isAsync": boolean;
-        "__#14705@#reportingLocks": boolean;
+        "__#14878@#participants": Set<Participant>;
+        "__#14878@#roles": Map<{}, Participant>;
+        "__#14878@#resources": Set<Resource>;
+        "__#14878@#status": Status;
+        "__#14878@#waitingOn"?: Iterable<Transaction>;
+        "__#14878@#via": string;
+        "__#14878@#shared"?: import("../index.js").Observable<[]>;
+        "__#14878@#closed"?: import("../index.js").Observable<[]>;
+        "__#14878@#isAsync": boolean;
+        "__#14878@#reportingLocks": boolean;
         close(): void;
         readonly via: string;
         readonly status: Status;
@@ -175,15 +175,15 @@ export declare const Transaction: {
         waitFor(others: Set<Transaction>): Promise<void>;
         toString(): string;
         treatAsSlow(): void;
-        "__#14705@#finalize"(status: Status, why: string, finalizer: () => MaybePromise): Promise<void> | undefined;
-        "__#14705@#executePreCommit"(): MaybePromise<void>;
-        "__#14705@#executeCommit"(): MaybePromise;
-        "__#14705@#executeCommit1"(): MaybePromise;
-        "__#14705@#executeCommit2"(): Promise<void> | undefined;
-        "__#14705@#executePostCommit"(participants: Participant[]): MaybePromise;
-        "__#14705@#executeRollback"(): Promise<void> | undefined;
-        "__#14705@#locksChanged"(resources: Set<Resource>, how?: string): void;
-        "__#14705@#assertAvailable"(): void;
+        "__#14878@#finalize"(status: Status, why: string, finalizer: () => MaybePromise): Promise<void> | undefined;
+        "__#14878@#executePreCommit"(): MaybePromise<void>;
+        "__#14878@#executeCommit"(): MaybePromise;
+        "__#14878@#executeCommit1"(): MaybePromise;
+        "__#14878@#executeCommit2"(): Promise<void> | undefined;
+        "__#14878@#executePostCommit"(participants: Participant[]): MaybePromise;
+        "__#14878@#executeRollback"(): Promise<void> | undefined;
+        "__#14878@#locksChanged"(resources: Set<Resource>, how?: string): void;
+        "__#14878@#assertAvailable"(): void;
     };
     Status: typeof Status;
     Resource: typeof Resource;

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@matter/general",
-    "version": "0.13.0-alpha.0-20250324-d7b7d9731",
+    "version": "0.13.0-alpha.0-20250325-ddb67eace",
     "description": "Non-Matter support for Matter.js",
     "keywords": [
         "iot",
@@ -36,7 +36,7 @@
         "@noble/curves": "^1.8.1"
     },
     "devDependencies": {
-        "@matter/testing": "0.13.0-alpha.0-20250324-d7b7d9731"
+        "@matter/testing": "0.13.0-alpha.0-20250325-ddb67eace"
     },
     "files": [
         "dist/**/*",

package/src/net/Network.ts

@@ -10,6 +10,8 @@ import { UdpChannel, UdpChannelOptions } from "./UdpChannel.js";
 
 export class NetworkError extends MatterError {}
 
+export class NoAddressAvailableError extends NetworkError {}
+
 /**
  * @see {@link MatterSpecification.v11.Core} § 11.11.4.4
  * Duplicated from the GeneralDiagnostics cluster to avoid circular dependencies.

package/src/net/UdpMulticastServer.ts

@@ -9,7 +9,7 @@ import { Logger } from "../log/Logger.js";
 import { Cache } from "../util/Cache.js";
 import { asError } from "../util/Error.js";
 import { isIPv4 } from "../util/Ip.js";
-import { Network } from "./Network.js";
+import { Network, NoAddressAvailableError } from "./Network.js";
 import { UdpChannel } from "./UdpChannel.js";
 
 const logger = Logger.get("UdpMulticastServer");
@@ -30,27 +30,41 @@ export class UdpMulticastServer {
         listeningPort,
         network,
     }: UdpMulticastServerOptions) {
-        return new UdpMulticastServer(
-            network,
-            broadcastAddressIpv4,
-            broadcastAddressIpv6,
-            listeningPort,
-            broadcastAddressIpv4 === undefined
-                ? undefined
-                : await network.createUdpChannel({
-                      type: "udp4",
-                      netInterface,
-                      listeningPort,
-                      membershipAddresses: [broadcastAddressIpv4],
-                  }),
-            await network.createUdpChannel({
-                type: "udp6",
-                netInterface,
+        let ipv4UdpChannel: UdpChannel | undefined = undefined;
+        if (broadcastAddressIpv4 !== undefined) {
+            try {
+                ipv4UdpChannel = await network.createUdpChannel({
+                    type: "udp4",
+                    netInterface,
+                    listeningPort,
+                    membershipAddresses: [broadcastAddressIpv4],
+                });
+            } catch (error) {
+                NoAddressAvailableError.accept(error);
+                logger.info(`IPv4 UDP channel not created because IPv4 is not available: ${asError(error).message}`);
+            }
+        }
+
+        try {
+            return new UdpMulticastServer(
+                network,
+                broadcastAddressIpv4,
+                broadcastAddressIpv6,
                 listeningPort,
-                membershipAddresses: [broadcastAddressIpv6],
-            }),
-            netInterface,
-        );
+                ipv4UdpChannel,
+                await network.createUdpChannel({
+                    type: "udp6",
+                    netInterface,
+                    listeningPort,
+                    membershipAddresses: [broadcastAddressIpv6],
+                }),
+                netInterface,
+            );
+        } catch (error) {
+            NoAddressAvailableError.accept(error);
+            logger.info(`IPv6 UDP interface not created because IPv6 is not available, but required my Matter.`);
+            throw error;
+        }
     }
 
     private readonly broadcastChannels = new Cache<Promise<UdpChannel>>(