@matter/general 0.16.1 → 0.16.2-alpha.0-20260114-d3127faee

package/dist/esm/net/ServerAddress.js

@@ -5,12 +5,15 @@
  */
 import { Diagnostic } from "#log/Diagnostic.js";
 import { Duration } from "#time/Duration.js";
-import { Seconds } from "#time/TimeUnit.js";
 function ServerAddress(definition) {
   return {
+    ttl: void 0,
     discoveredAt: void 0,
-    ...definition,
-    ttl: Seconds(definition.ttl)
+    healthyAt: void 0,
+    unhealthyAt: void 0,
+    priority: void 0,
+    weight: void 0,
+    ...definition
   };
 }
 ((ServerAddress2) => {
@@ -59,10 +62,42 @@ function ServerAddress(definition) {
     return false;
   }
   ServerAddress2.isEqual = isEqual;
-  function definitionOf(address) {
-    return address;
+  function healthOf(health) {
+    if (health.unhealthyAt === void 0) {
+      return health;
+    }
+    if (health.healthyAt !== void 0 && health.healthyAt > health.unhealthyAt) {
+      return {
+        healthyAt: health.healthyAt
+      };
+    }
+    return health;
+  }
+  ServerAddress2.healthOf = healthOf;
+  let SelectionPreference;
+  ((SelectionPreference2) => {
+    SelectionPreference2[SelectionPreference2["IPV6_ULA"] = 0] = "IPV6_ULA";
+    SelectionPreference2[SelectionPreference2["IPV6_LINK_LOCAL"] = 1] = "IPV6_LINK_LOCAL";
+    SelectionPreference2[SelectionPreference2["IPV6"] = 2] = "IPV6";
+    SelectionPreference2[SelectionPreference2["IPV4"] = 3] = "IPV4";
+    SelectionPreference2[SelectionPreference2["NOT_IP"] = 3] = "NOT_IP";
+  })(SelectionPreference = ServerAddress2.SelectionPreference || (ServerAddress2.SelectionPreference = {}));
+  function selectionPreferenceOf(address) {
+    if (!("ip" in address)) {
+      return 3 /* NOT_IP */;
+    }
+    if (address.ip.startsWith("fd")) {
+      return 0 /* IPV6_ULA */;
+    }
+    if (address.ip.startsWith("fe00")) {
+      return 1 /* IPV6_LINK_LOCAL */;
+    }
+    if (address.ip.includes(":")) {
+      return 2 /* IPV6 */;
+    }
+    return 3 /* IPV4 */;
   }
-  ServerAddress2.definitionOf = definitionOf;
+  ServerAddress2.selectionPreferenceOf = selectionPreferenceOf;
 })(ServerAddress || (ServerAddress = {}));
 export {
   ServerAddress

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

@@ -1,6 +1,6 @@
 {
   "version": 3,
   "sources": ["../../../src/net/ServerAddress.ts"],
-  "mappings": "AAAA;AAAA;AAAA;AAAA;AAAA;AAMA,SAAS,kBAAkB;AAC3B,SAAS,gBAAgB;AAEzB,SAAS,eAAe;AA6BjB,SAAS,cAAc,YAAsC;AAChE,SAAO;AAAA,IACH,cAAc;AAAA,IACd,GAAG;AAAA,IACH,KAAK,QAAQ,WAAW,GAAG;AAAA,EAC/B;AACJ;AAAA,CAEO,CAAUA,mBAAV;AACI,WAAS,OAAO,SAAgC;AACnD,YAAQ,QAAQ,MAAM;AAAA,MAClB,KAAK;AAAA,MACL,KAAK;AACD,eAAO,GAAG,QAAQ,IAAI,MAAM,QAAQ,EAAE,IAAI,QAAQ,IAAI;AAAA,MAE1D,KAAK;AACD,eAAO,SAAS,QAAQ,iBAAiB;AAAA,MAE7C;AACI,eAAO,GAAI,QAAgB,IAAI;AAAA,IACvC;AAAA,EACJ;AAZO,EAAAA,eAAS;AAcT,WAAS,cAAc,SAAwB;AAClD,UAAM,aAAa,MAAe;AAElC,YAAQ,QAAQ,MAAM;AAAA,MAClB,KAAK;AAAA,MACL,KAAK;AACD,mBAAW,KAAK,GAAG,QAAQ,IAAI,OAAO,WAAW,OAAO,QAAQ,EAAE,GAAG,KAAK,QAAQ,IAAI;AACtF;AAAA,MAEJ,KAAK;AACD,mBAAW,KAAK,UAAU,WAAW,OAAO,QAAQ,iBAAiB,CAAC;AACtE;AAAA,MAEJ;AACI,mBAAW,KAAK,GAAI,QAAgB,IAAI,KAAK;AAC7C;AAAA,IACR;AAEA,QAAI,SAAS,WAAW,OAAO,QAAQ,QAAQ,UAAU;AACrD,iBAAW,KAAK,SAAS,SAAS,OAAO,QAAQ,GAAG,CAAC;AAAA,IACzD;AAEA,WAAO,WAAW,OAAO,GAAG,UAAU;AAAA,EAC1C;AAvBO,EAAAA,eAAS;AAyBT,WAAS,QAAQ,GAAkB,GAA2B;AACjE,QAAI,EAAE,SAAS,EAAE,MAAM;AACnB,aAAO;AAAA,IACX;AAEA,QAAI,EAAE,SAAS,SAAS,EAAE,SAAS,OAAO;AACtC,aAAO,EAAE,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE;AAAA,IACzC;AAEA,QAAI,EAAE,SAAS,SAAS,EAAE,SAAS,OAAO;AACtC,aAAO,EAAE,sBAAsB,EAAE;AAAA,IACrC;AAEA,WAAO;AAAA,EACX;AAdO,EAAAA,eAAS;AAgBT,WAAS,aAAa,SAAoC;AAC7D,WAAO;AAAA,EACX;AAFO,EAAAA,eAAS;AAAA,GAxDH;",
-  "names": ["ServerAddress"]
+  "mappings": "AAAA;AAAA;AAAA;AAAA;AAAA;AAMA,SAAS,kBAAkB;AAC3B,SAAS,gBAAgB;AAwDlB,SAAS,cAAc,YAA2B;AACrD,SAAO;AAAA,IACH,KAAK;AAAA,IACL,cAAc;AAAA,IACd,WAAW;AAAA,IACX,aAAa;AAAA,IACb,UAAU;AAAA,IACV,QAAQ;AAAA,IACR,GAAG;AAAA,EACP;AACJ;AAAA,CAEO,CAAUA,mBAAV;AACI,WAAS,OAAO,SAAgC;AACnD,YAAQ,QAAQ,MAAM;AAAA,MAClB,KAAK;AAAA,MACL,KAAK;AACD,eAAO,GAAG,QAAQ,IAAI,MAAM,QAAQ,EAAE,IAAI,QAAQ,IAAI;AAAA,MAE1D,KAAK;AACD,eAAO,SAAS,QAAQ,iBAAiB;AAAA,MAE7C;AACI,eAAO,GAAI,QAAgB,IAAI;AAAA,IACvC;AAAA,EACJ;AAZO,EAAAA,eAAS;AAcT,WAAS,cAAc,SAAwB;AAClD,UAAM,aAAa,MAAe;AAElC,YAAQ,QAAQ,MAAM;AAAA,MAClB,KAAK;AAAA,MACL,KAAK;AACD,mBAAW,KAAK,GAAG,QAAQ,IAAI,OAAO,WAAW,OAAO,QAAQ,EAAE,GAAG,KAAK,QAAQ,IAAI;AACtF;AAAA,MAEJ,KAAK;AACD,mBAAW,KAAK,UAAU,WAAW,OAAO,QAAQ,iBAAiB,CAAC;AACtE;AAAA,MAEJ;AACI,mBAAW,KAAK,GAAI,QAAgB,IAAI,KAAK;AAC7C;AAAA,IACR;AAEA,QAAI,SAAS,WAAW,OAAO,QAAQ,QAAQ,UAAU;AACrD,iBAAW,KAAK,SAAS,SAAS,OAAO,QAAQ,GAAG,CAAC;AAAA,IACzD;AAEA,WAAO,WAAW,OAAO,GAAG,UAAU;AAAA,EAC1C;AAvBO,EAAAA,eAAS;AAyBT,WAAS,QAAQ,GAAkB,GAA2B;AACjE,QAAI,EAAE,SAAS,EAAE,MAAM;AACnB,aAAO;AAAA,IACX;AAEA,QAAI,EAAE,SAAS,SAAS,EAAE,SAAS,OAAO;AACtC,aAAO,EAAE,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE;AAAA,IACzC;AAEA,QAAI,EAAE,SAAS,SAAS,EAAE,SAAS,OAAO;AACtC,aAAO,EAAE,sBAAsB,EAAE;AAAA,IACrC;AAEA,WAAO;AAAA,EACX;AAdO,EAAAA,eAAS;AAsBT,WAAS,SAAS,QAAsC;AAC3D,QAAI,OAAO,gBAAgB,QAAW;AAClC,aAAO;AAAA,IACX;AAEA,QAAI,OAAO,cAAc,UAAa,OAAO,YAAY,OAAO,aAAa;AACzE,aAAO;AAAA,QACH,WAAW,OAAO;AAAA,MACtB;AAAA,IACJ;AAEA,WAAO;AAAA,EACX;AAZO,EAAAA,eAAS;AAmBT,MAAK;AAAL,IAAKC,yBAAL;AACH,IAAAA,0CAAA;AACA,IAAAA,0CAAA;AACA,IAAAA,0CAAA;AACA,IAAAA,0CAAA;AACA,IAAAA,0CAAA,YAAS,KAAT;AAAA,KALQ,sBAAAD,eAAA,wBAAAA,eAAA;AAQL,WAAS,sBAAsB,SAAwB;AAC1D,QAAI,EAAE,QAAQ,UAAU;AACpB,aAAO;AAAA,IACX;AAEA,QAAI,QAAQ,GAAG,WAAW,IAAI,GAAG;AAC7B,aAAO;AAAA,IACX;AAEA,QAAI,QAAQ,GAAG,WAAW,MAAM,GAAG;AAC/B,aAAO;AAAA,IACX;AAEA,QAAI,QAAQ,GAAG,SAAS,GAAG,GAAG;AAC1B,aAAO;AAAA,IACX;AAEA,WAAO;AAAA,EACX;AAlBO,EAAAA,eAAS;AAAA,GAzFH;",
+  "names": ["ServerAddress", "SelectionPreference"]
 }

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

@@ -0,0 +1,65 @@
+/**
+ * @license
+ * Copyright 2022-2026 Matter.js Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { AddressStatus, ServerAddress } from "./ServerAddress.js";
+/**
+ * A set of server addresses ordered by a comparator.
+ */
+export interface ServerAddressSet<T extends ServerAddress> {
+    /**
+     * Add an address.
+     *
+     * If the address alreay exists, returns the existing address to facilitate comparison by value.  If not, returns
+     * the input address.
+     */
+    add(address: T): T;
+    /**
+     * Delete an address.
+     */
+    delete(address: T): boolean;
+    /**
+     * Replace the stored addresses.
+     */
+    replace(newAddresses: Iterable<T>): void;
+    /**
+     * Test for existence of address.
+     */
+    has(address: T): boolean;
+    /**
+     * The number of addresses.
+     */
+    size: number;
+    /**
+     * Iterate.
+     *
+     * If you replace addresses during iteration only addresses not already produced will be covered by remaining
+     * iterations.
+     */
+    [Symbol.iterator](): Iterator<T>;
+}
+/**
+ * Create a new {@link ServerAddressSet}.
+ */
+export declare function ServerAddressSet<T extends ServerAddress>(initial?: Iterable<T>, comparator?: typeof ServerAddressSet.compareDesirability): ServerAddressSet<T>;
+export declare namespace ServerAddressSet {
+    interface Comparator<T extends ServerAddress = ServerAddress> {
+        (addr1: T, addr2: T): number;
+    }
+    /**
+     * Update a list of addresses with health information from another list.
+     */
+    function copyHealth<T extends ServerAddress>(targetAddresses: Iterable<T>, sourceAddresses: Iterable<T>): T[];
+    /**
+     * Compare the "desirability" of two addresses for communication.
+     */
+    function compareDesirability(a: ServerAddress, b: ServerAddress): number;
+    /**
+     * Compare the health of two addresses.
+     *
+     * Returns a negative number if a is healthier, positive if b is healthier and 0 if assessment is neutral.
+     */
+    function compareHealth(a: AddressStatus, b: AddressStatus): number;
+}
+//# sourceMappingURL=ServerAddressSet.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ServerAddressSet.d.ts","sourceRoot":"","sources":["../../../src/net/ServerAddressSet.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAElE;;GAEG;AACH,MAAM,WAAW,gBAAgB,CAAC,CAAC,SAAS,aAAa;IACrD;;;;;OAKG;IACH,GAAG,CAAC,OAAO,EAAE,CAAC,GAAG,CAAC,CAAC;IAEnB;;OAEG;IACH,MAAM,CAAC,OAAO,EAAE,CAAC,GAAG,OAAO,CAAC;IAE5B;;OAEG;IACH,OAAO,CAAC,YAAY,EAAE,QAAQ,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC;IAEzC;;OAEG;IACH,GAAG,CAAC,OAAO,EAAE,CAAC,GAAG,OAAO,CAAC;IAEzB;;OAEG;IACH,IAAI,EAAE,MAAM,CAAC;IAEb;;;;;OAKG;IACH,CAAC,MAAM,CAAC,QAAQ,CAAC,IAAI,QAAQ,CAAC,CAAC,CAAC,CAAC;CACpC;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,CAAC,SAAS,aAAa,EACpD,OAAO,CAAC,EAAE,QAAQ,CAAC,CAAC,CAAC,EACrB,UAAU,8CAAuC,uBA+EpD;AAED,yBAAiB,gBAAgB,CAAC;IAC9B,UAAiB,UAAU,CAAC,CAAC,SAAS,aAAa,GAAG,aAAa;QAC/D,CAAC,KAAK,EAAE,CAAC,EAAE,KAAK,EAAE,CAAC,GAAG,MAAM,CAAC;KAChC;IAED;;OAEG;IACH,SAAgB,UAAU,CAAC,CAAC,SAAS,aAAa,EAAE,eAAe,EAAE,QAAQ,CAAC,CAAC,CAAC,EAAE,eAAe,EAAE,QAAQ,CAAC,CAAC,CAAC,OAgB7G;IAED;;OAEG;IACH,SAAgB,mBAAmB,CAAC,CAAC,EAAE,aAAa,EAAE,CAAC,EAAE,aAAa,UAmBrE;IAED;;;;OAIG;IACH,SAAgB,aAAa,CAAC,CAAC,EAAE,aAAa,EAAE,CAAC,EAAE,aAAa,UAiC/D;CACJ"}

package/dist/esm/net/ServerAddressSet.js

@@ -0,0 +1,124 @@
+/**
+ * @license
+ * Copyright 2022-2026 Matter.js Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { ServerAddress } from "./ServerAddress.js";
+function ServerAddressSet(initial, comparator = ServerAddressSet.compareDesirability) {
+  let version = 0;
+  let addresses;
+  const set = {
+    add(address) {
+      version++;
+      const key = ServerAddress.urlFor(address);
+      const existing = addresses?.get(key);
+      if (existing) {
+        return existing;
+      }
+      if (!addresses) {
+        addresses = /* @__PURE__ */ new Map();
+      }
+      addresses.set(key, address);
+      return address;
+    },
+    delete(address) {
+      version++;
+      return addresses?.delete(ServerAddress.urlFor(address)) ?? false;
+    },
+    has(address) {
+      return addresses?.has(ServerAddress.urlFor(address)) ?? false;
+    },
+    replace(newAddresses) {
+      version++;
+      const oldAddresses = addresses;
+      addresses = /* @__PURE__ */ new Map();
+      for (const address of newAddresses) {
+        const key = ServerAddress.urlFor(address);
+        addresses.set(key, oldAddresses?.get(key) ?? address);
+      }
+    },
+    get size() {
+      return addresses?.size ?? 0;
+    },
+    *[Symbol.iterator]() {
+      const tried = /* @__PURE__ */ new Set();
+      all: while (true) {
+        const currentVersion = version;
+        const ordered = addresses ? [...addresses.entries()].map(([, address]) => address).sort(comparator) : [];
+        for (const address of ordered) {
+          const key = ServerAddress.urlFor(address);
+          if (tried.has(key)) {
+            continue;
+          }
+          yield address;
+          if (currentVersion !== version) {
+            continue all;
+          }
+        }
+        break;
+      }
+    }
+  };
+  if (initial) {
+    set.replace(initial);
+  }
+  return set;
+}
+((ServerAddressSet2) => {
+  function copyHealth(targetAddresses, sourceAddresses) {
+    const output = [...targetAddresses];
+    nextTarget: for (let i = 0; i < output.length; i++) {
+      const target = output[i];
+      for (const source of sourceAddresses) {
+        if (ServerAddress.isEqual(target, source)) {
+          if (source.healthyAt !== void 0 || source.unhealthyAt !== void 0) {
+            output[i] = { ...target, healthyAt: source.healthyAt, unhealthyAt: source.unhealthyAt };
+          }
+          continue nextTarget;
+        }
+      }
+    }
+    return output;
+  }
+  ServerAddressSet2.copyHealth = copyHealth;
+  function compareDesirability(a, b) {
+    const value = ServerAddress.selectionPreferenceOf(a) - ServerAddress.selectionPreferenceOf(b);
+    if (value) {
+      return value;
+    }
+    const relativeHealth = compareHealth(a, b);
+    if (relativeHealth) {
+      return relativeHealth;
+    }
+    if (a.priority !== void 0 && b.priority !== void 0) {
+      return b.priority - a.priority;
+    }
+    return 0;
+  }
+  ServerAddressSet2.compareDesirability = compareDesirability;
+  function compareHealth(a, b) {
+    const ha = ServerAddress.healthOf(a);
+    const hb = ServerAddress.healthOf(b);
+    if (ha.unhealthyAt) {
+      if (hb.unhealthyAt) {
+        return ha.unhealthyAt - hb.unhealthyAt;
+      }
+      return 1;
+    }
+    if (hb.unhealthyAt) {
+      return -1;
+    }
+    if (ha.healthyAt) {
+      if (hb.healthyAt) {
+        return hb.healthyAt - ha.healthyAt;
+      }
+      return -1;
+    }
+    return 0;
+  }
+  ServerAddressSet2.compareHealth = compareHealth;
+})(ServerAddressSet || (ServerAddressSet = {}));
+export {
+  ServerAddressSet
+};
+//# sourceMappingURL=ServerAddressSet.js.map

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

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

package/dist/esm/net/dns-sd/MdnsSocket.d.ts

@@ -0,0 +1,40 @@
+/**
+ * @license
+ * Copyright 2022-2026 Matter.js Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { DnsMessage, DnsMessageType } from "#codec/DnsCodec.js";
+import { Network } from "#net/Network.js";
+import { UdpMulticastServer } from "#net/udp/UdpMulticastServer.js";
+import { Lifetime } from "#util/Lifetime.js";
+import { AsyncObservable } from "#util/Observable.js";
+/**
+ * Manages the UDP socket for other components that implement MDNS logic.
+ */
+export declare class MdnsSocket {
+    #private;
+    static create(network: Network, options?: {
+        enableIpv4?: boolean;
+        netInterface?: string;
+        lifetime?: Lifetime.Owner;
+    }): Promise<MdnsSocket>;
+    constructor(socket: UdpMulticastServer);
+    get network(): Network;
+    get supportsIpv4(): boolean;
+    get netInterface(): string | undefined;
+    get receipt(): AsyncObservable<[message: MdnsSocket.Message], void>;
+    send(message: Partial<DnsMessage> & {
+        messageType: DnsMessageType;
+    }, intf?: string, unicastDest?: string): Promise<void>;
+    close(): Promise<void>;
+}
+export declare namespace MdnsSocket {
+    interface Message extends DnsMessage {
+        sourceIp: string;
+        sourceIntf: string;
+    }
+    const BROADCAST_IPV4 = "224.0.0.251";
+    const BROADCAST_IPV6 = "ff02::fb";
+    const BROADCAST_PORT = 5353;
+}
+//# sourceMappingURL=MdnsSocket.d.ts.map

package/dist/esm/net/dns-sd/MdnsSocket.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"MdnsSocket.d.ts","sourceRoot":"","sources":["../../../../src/net/dns-sd/MdnsSocket.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAEH,UAAU,EAEV,cAAc,EAGjB,MAAM,oBAAoB,CAAC;AAI5B,OAAO,EAAE,OAAO,EAAE,MAAM,iBAAiB,CAAC;AAC1C,OAAO,EAAE,kBAAkB,EAAE,MAAM,gCAAgC,CAAC;AAEpE,OAAO,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAC7C,OAAO,EAAE,eAAe,EAAmB,MAAM,qBAAqB,CAAC;AAKvE;;GAEG;AACH,qBAAa,UAAU;;WASN,MAAM,CACf,OAAO,EAAE,OAAO,EAChB,OAAO,CAAC,EAAE;QAAE,UAAU,CAAC,EAAE,OAAO,CAAC;QAAC,YAAY,CAAC,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,EAAE,QAAQ,CAAC,KAAK,CAAA;KAAE;gBAgB5E,MAAM,EAAE,kBAAkB;IAKtC,IAAI,OAAO,YAEV;IAED,IAAI,YAAY,YAEf;IAED,IAAI,YAAY,uBAEf;IAED,IAAI,OAAO,yDAEV;IAEK,IAAI,CAAC,OAAO,EAAE,OAAO,CAAC,UAAU,CAAC,GAAG;QAAE,WAAW,EAAE,cAAc,CAAA;KAAE,EAAE,IAAI,CAAC,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,MAAM;IA+ExG,KAAK;CAmCd;AAED,yBAAiB,UAAU,CAAC;IACxB,UAAiB,OAAQ,SAAQ,UAAU;QACvC,QAAQ,EAAE,MAAM,CAAC;QACjB,UAAU,EAAE,MAAM,CAAC;KACtB;IAEM,MAAM,cAAc,gBAAgB,CAAC;IACrC,MAAM,cAAc,aAAa,CAAC;IAClC,MAAM,cAAc,OAAO,CAAC;CACtC"}

package/dist/esm/net/dns-sd/MdnsSocket.js

@@ -0,0 +1,149 @@
+/**
+ * @license
+ * Copyright 2022-2026 Matter.js Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import {
+  DnsCodec,
+  DnsMessageType,
+  DnsMessageTypeFlag,
+  MAX_MDNS_MESSAGE_SIZE
+} from "#codec/DnsCodec.js";
+import { Diagnostic } from "#log/Diagnostic.js";
+import { Logger } from "#log/Logger.js";
+import { MatterAggregateError } from "#MatterError.js";
+import { UdpMulticastServer } from "#net/udp/UdpMulticastServer.js";
+import { BasicObservable } from "#util/Observable.js";
+import { MaybePromise } from "#util/Promises.js";
+const logger = Logger.get("MdnsListener");
+class MdnsSocket {
+  #socket;
+  #handlers;
+  #isClosed = false;
+  #receipt = new BasicObservable(
+    (error) => logger.error("Unhandled error in MDNS listener", error),
+    true
+  );
+  static async create(network, options) {
+    const { enableIpv4 = true, netInterface, lifetime } = options ?? {};
+    const socket = new MdnsSocket(
+      await UdpMulticastServer.create({
+        lifetime,
+        network,
+        netInterface,
+        broadcastAddressIpv4: enableIpv4 ? MdnsSocket.BROADCAST_IPV4 : void 0,
+        broadcastAddressIpv6: MdnsSocket.BROADCAST_IPV6,
+        listeningPort: MdnsSocket.BROADCAST_PORT
+      })
+    );
+    return socket;
+  }
+  constructor(socket) {
+    this.#socket = socket;
+    socket.onMessage(this.#handleMessage.bind(this));
+  }
+  get network() {
+    return this.#socket.network;
+  }
+  get supportsIpv4() {
+    return this.#socket.supportsIpv4;
+  }
+  get netInterface() {
+    return this.#socket.netInterface;
+  }
+  get receipt() {
+    return this.#receipt;
+  }
+  async send(message, intf, unicastDest) {
+    const { messageType } = message;
+    const truncatedMessageType = DnsMessageType.isQuery(messageType) ? messageType | DnsMessageTypeFlag.TC : messageType;
+    const chunk = {
+      transactionId: 0,
+      queries: [],
+      authorities: [],
+      ...message,
+      answers: [],
+      additionalRecords: []
+    };
+    let encodedChunkWithoutAnswers = DnsCodec.encode(chunk);
+    let chunkSize = encodedChunkWithoutAnswers.byteLength;
+    for (const answer of message.answers ?? []) {
+      const answerEncoded = DnsCodec.encodeRecord(answer);
+      if (chunkSize + answerEncoded.byteLength > MAX_MDNS_MESSAGE_SIZE) {
+        if (chunk.answers.length === 0) {
+          logger.warn(
+            `MDNS message with ${Diagnostic.json(
+              chunk.queries
+            )} is too big to fit into a single MDNS message. Send anyway, but please report!`
+          );
+        }
+        await this.#send(
+          {
+            ...chunk,
+            messageType: truncatedMessageType
+          },
+          intf,
+          unicastDest
+        );
+        if (chunk.queries.length) {
+          chunk.queries.length = 0;
+          encodedChunkWithoutAnswers = DnsCodec.encode(chunk);
+        }
+        chunk.answers.length = 0;
+        chunkSize = encodedChunkWithoutAnswers.byteLength + answerEncoded.byteLength;
+      } else {
+        chunkSize += answerEncoded.byteLength;
+      }
+      chunk.answers.push(answerEncoded);
+    }
+    const additionalRecords = message.additionalRecords ?? [];
+    for (const additionalRecord of additionalRecords) {
+      const additionalRecordEncoded = DnsCodec.encodeRecord(additionalRecord);
+      chunkSize += additionalRecordEncoded.byteLength;
+      if (chunkSize > MAX_MDNS_MESSAGE_SIZE) {
+        break;
+      }
+      chunk.additionalRecords.push(additionalRecordEncoded);
+    }
+    await this.#send(chunk, intf, unicastDest);
+  }
+  async #send(message, intf, unicastDest) {
+    await this.#socket.send(DnsCodec.encode(message), intf, unicastDest);
+  }
+  async close() {
+    this.#isClosed = true;
+    await this.#socket.close();
+    if (this.#handlers) {
+      await MatterAggregateError.allSettled(this.#handlers);
+    }
+  }
+  #handleMessage(bytes, sourceIp, sourceIntf) {
+    if (this.#isClosed) {
+      return;
+    }
+    const parsed = DnsCodec.decode(bytes);
+    if (parsed === void 0) {
+      return;
+    }
+    let promise = this.#receipt.emit({
+      ...parsed,
+      sourceIp,
+      sourceIntf
+    });
+    if (MaybePromise.is(promise)) {
+      if (this.#handlers === void 0) {
+        this.#handlers = /* @__PURE__ */ new Set();
+      }
+      promise = Promise.resolve(promise).finally(() => this.#handlers?.delete(promise));
+    }
+  }
+}
+((MdnsSocket2) => {
+  MdnsSocket2.BROADCAST_IPV4 = "224.0.0.251";
+  MdnsSocket2.BROADCAST_IPV6 = "ff02::fb";
+  MdnsSocket2.BROADCAST_PORT = 5353;
+})(MdnsSocket || (MdnsSocket = {}));
+export {
+  MdnsSocket
+};
+//# sourceMappingURL=MdnsSocket.js.map

package/dist/esm/net/dns-sd/MdnsSocket.js.map

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

package/dist/esm/net/dns-sd/index.d.ts

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

package/dist/esm/net/dns-sd/index.d.ts.map

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

package/dist/esm/net/dns-sd/index.js

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

package/dist/esm/net/dns-sd/index.js.map

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

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

@@ -6,11 +6,13 @@
 export * from "./AppAddress.js";
 export * from "./Channel.js";
 export * from "./ConnectionlessTransport.js";
+export * from "./dns-sd/index.js";
 export * from "./http/index.js";
 export * from "./mock/index.js";
 export * from "./mqtt/index.js";
 export * from "./Network.js";
 export * from "./RetrySchedule.js";
 export * from "./ServerAddress.js";
+export * from "./ServerAddressSet.js";
 export * from "./udp/index.js";
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/net/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,cAAc,iBAAiB,CAAC;AAChC,cAAc,cAAc,CAAC;AAC7B,cAAc,8BAA8B,CAAC;AAC7C,cAAc,iBAAiB,CAAC;AAChC,cAAc,iBAAiB,CAAC;AAChC,cAAc,iBAAiB,CAAC;AAChC,cAAc,cAAc,CAAC;AAC7B,cAAc,oBAAoB,CAAC;AACnC,cAAc,oBAAoB,CAAC;AACnC,cAAc,gBAAgB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/net/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,cAAc,iBAAiB,CAAC;AAChC,cAAc,cAAc,CAAC;AAC7B,cAAc,8BAA8B,CAAC;AAC7C,cAAc,mBAAmB,CAAC;AAClC,cAAc,iBAAiB,CAAC;AAChC,cAAc,iBAAiB,CAAC;AAChC,cAAc,iBAAiB,CAAC;AAChC,cAAc,cAAc,CAAC;AAC7B,cAAc,oBAAoB,CAAC;AACnC,cAAc,oBAAoB,CAAC;AACnC,cAAc,uBAAuB,CAAC;AACtC,cAAc,gBAAgB,CAAC"}

package/dist/esm/net/index.js

@@ -6,11 +6,13 @@
 export * from "./AppAddress.js";
 export * from "./Channel.js";
 export * from "./ConnectionlessTransport.js";
+export * from "./dns-sd/index.js";
 export * from "./http/index.js";
 export * from "./mock/index.js";
 export * from "./mqtt/index.js";
 export * from "./Network.js";
 export * from "./RetrySchedule.js";
 export * from "./ServerAddress.js";
+export * from "./ServerAddressSet.js";
 export * from "./udp/index.js";
 //# sourceMappingURL=index.js.map

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

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

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

@@ -28,6 +28,10 @@ export declare class Abort extends Callable<[reason?: Error]> implements AbortCo
      * If aborted returns undefined.
      */
     race<T>(...promises: Array<T | PromiseLike<T>>): Promise<Awaited<T> | void>;
+    /**
+     * Race with throw on abort.
+     */
+    attempt<T>(...promises: Array<T | PromiseLike<T>>): Promise<T>;
     /**
      * Free resources.
      *
@@ -36,6 +40,7 @@ export declare class Abort extends Callable<[reason?: Error]> implements AbortCo
      */
     close(): void;
     [Symbol.dispose](): void;
+    if(condition?: unknown, reason?: Error): void;
     get aborted(): boolean;
     set onabort(onabort: ((this: AbortSignal, ev: Event) => any) | null);
     get onabort(): ((this: AbortSignal, ev: Event) => any) | null;
@@ -91,6 +96,10 @@ export declare namespace Abort {
      * abort reason.
      */
     function race<T>(signal: Signal | undefined, ...promises: Array<T | PromiseLike<T>>): Promise<Awaited<T> | void>;
+    /**
+     * Race with throw on abort.
+     */
+    function attempt<T>(signal: Signal | undefined, ...promises: Array<T | PromiseLike<T>>): Promise<T>;
     /**
      * Perform abortable sleep.
      */

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

@@ -1 +1 @@
-{"version":3,"file":"Abort.d.ts","sourceRoot":"","sources":["../../../src/util/Abort.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"Abort.d.ts","sourceRoot":"","sources":["../../../src/util/Abort.ts"],"names":[],"mappings":"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"}

package/dist/esm/util/Abort.js

@@ -64,6 +64,12 @@ class Abort extends Callable {
   async race(...promises) {
     return Abort.race(this, ...promises);
   }
+  /**
+   * Race with throw on abort.
+   */
+  async attempt(...promises) {
+    return Abort.attempt(this, ...promises);
+  }
   /**
    * Free resources.
    *
@@ -81,6 +87,11 @@ class Abort extends Callable {
   [Symbol.dispose]() {
     this.close();
   }
+  if(condition, reason) {
+    if (condition) {
+      this.abort(reason);
+    }
+  }
   get aborted() {
     return this.signal.aborted;
   }
@@ -143,6 +154,15 @@ class Abort extends Callable {
     return SafePromise.race(promises);
   }
   Abort2.race = race;
+  async function attempt(signal, ...promises) {
+    if (signal && "signal" in signal) {
+      signal = signal.signal;
+    }
+    const result = await race(signal, ...promises);
+    signal?.throwIfAborted();
+    return result;
+  }
+  Abort2.attempt = attempt;
   function sleep(description, abort, duration) {
     let timer;
     const rested = new Promise((resolve) => {