@matter/general 0.16.8-alpha.0-20260125-38e62bc3e → 0.16.8-alpha.0-20260127-de48449ad

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

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

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

@@ -0,0 +1,77 @@
+/**
+ * @license
+ * Copyright 2022-2026 Matter.js Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { DnsRecord } from "#codec/DnsCodec.js";
+import { Duration } from "#time/Duration.js";
+import { Entropy } from "#util/Entropy.js";
+import { Lifetime } from "#util/Lifetime.js";
+import { Observable } from "#util/Observable.js";
+import { DnssdName } from "./DnssdName.js";
+import { QueryMulticaster } from "./DnssdSolicitor.js";
+import { MdnsSocket } from "./MdnsSocket.js";
+/**
+ * Names collected via DNS-SD.
+ *
+ * TODO - API is designed to support Avahi, Bonjour etc. but current implementation is tied to local MDNS
+ */
+export declare class DnssdNames {
+    #private;
+    constructor({ socket, lifetime, entropy, filter, goodbyeProtectionWindow, minTtl: minTtl, }: DnssdNames.Context);
+    /**
+     * Test for existence of name.
+     */
+    has(name: string): boolean;
+    /**
+     * Retrieve the {@link DnssdName} for {@link name}.
+     *
+     * This will create the name if it does not exist, and if you do not add an observer then it will not automatically
+     * delete if there are no records.  So if you may not use the record test for existence with {@link has} first.
+     */
+    get(qname: string): DnssdName;
+    /**
+     * Retrieve the {@link DnssdName} if known.
+     */
+    maybeGet(name: string): DnssdName | undefined;
+    /**
+     * Wait for all workers and close all names.
+     */
+    close(): Promise<void>;
+    get socket(): MdnsSocket;
+    /**
+     * Emits when a {@link DnssdName} is first discovered.
+     */
+    get discovered(): Observable<[name: DnssdName], void>;
+    /**
+     * Shared solicitor.
+     *
+     * We offer solicitation in this object so there is not redundant solicitation across interested parties.
+     */
+    get solicitor(): QueryMulticaster;
+    get entropy(): Entropy;
+}
+export declare namespace DnssdNames {
+    interface Context {
+        socket: MdnsSocket;
+        lifetime?: Lifetime.Owner;
+        entropy: Entropy;
+        filter?: (record: DnsRecord) => boolean;
+        /**
+         * The interval after discovering a record for which we ignore goodbyes.
+         *
+         * This serves as protection for out-of-order messages when a device expires then broadcasts the same record
+         * in a very short amount of time.
+         */
+        goodbyeProtectionWindow?: Duration;
+        /**
+         * Minimum TTL for PTR records.
+         */
+        minTtl?: Duration;
+    }
+    const defaults: {
+        goodbyeProtectionWindow: Duration;
+        minTtl: Duration;
+    };
+}
+//# sourceMappingURL=DnssdNames.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"DnssdNames.d.ts","sourceRoot":"","sources":["../../../../src/net/dns-sd/DnssdNames.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAC/C,OAAO,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAI7C,OAAO,EAAE,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAC3C,OAAO,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAC7C,OAAO,EAAE,UAAU,EAAiB,MAAM,qBAAqB,CAAC;AAEhE,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAC3C,OAAO,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AACvD,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAE7C;;;;GAIG;AACH,qBAAa,UAAU;;gBAaP,EACR,MAAM,EACN,QAA2B,EAC3B,OAAO,EACP,MAAM,EACN,uBAAuB,EACvB,MAAM,EAAE,MAAM,GACjB,EAAE,UAAU,CAAC,OAAO;IAmDrB;;OAEG;IACH,GAAG,CAAC,IAAI,EAAE,MAAM;IAKhB;;;;;OAKG;IACH,GAAG,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS;IAS7B;;OAEG;IACH,QAAQ,CAAC,IAAI,EAAE,MAAM;IAKrB;;OAEG;IACG,KAAK;IAWX,IAAI,MAAM,eAET;IAED;;OAEG;IACH,IAAI,UAAU,wCAEb;IAED;;;;OAIG;IACH,IAAI,SAAS,qBAEZ;IAED,IAAI,OAAO,YAEV;CAkBJ;AAED,yBAAiB,UAAU,CAAC;IACxB,UAAiB,OAAO;QACpB,MAAM,EAAE,UAAU,CAAC;QACnB,QAAQ,CAAC,EAAE,QAAQ,CAAC,KAAK,CAAC;QAC1B,OAAO,EAAE,OAAO,CAAC;QACjB,MAAM,CAAC,EAAE,CAAC,MAAM,EAAE,SAAS,KAAK,OAAO,CAAC;QAExC;;;;;WAKG;QACH,uBAAuB,CAAC,EAAE,QAAQ,CAAC;QAEnC;;WAEG;QACH,MAAM,CAAC,EAAE,QAAQ,CAAC;KACrB;IAEM,MAAM,QAAQ;;;KAGpB,CAAC;CACL"}

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

@@ -0,0 +1,218 @@
+var __knownSymbol = (name, symbol) => (symbol = Symbol[name]) ? symbol : /* @__PURE__ */ Symbol.for("Symbol." + name);
+var __typeError = (msg) => {
+  throw TypeError(msg);
+};
+var __using = (stack, value, async) => {
+  if (value != null) {
+    if (typeof value !== "object" && typeof value !== "function") __typeError("Object expected");
+    var dispose, inner;
+    if (async) dispose = value[__knownSymbol("asyncDispose")];
+    if (dispose === void 0) {
+      dispose = value[__knownSymbol("dispose")];
+      if (async) inner = dispose;
+    }
+    if (typeof dispose !== "function") __typeError("Object not disposable");
+    if (inner) dispose = function() {
+      try {
+        inner.call(this);
+      } catch (e) {
+        return Promise.reject(e);
+      }
+    };
+    stack.push([async, dispose, value]);
+  } else if (async) {
+    stack.push([async]);
+  }
+  return value;
+};
+var __callDispose = (stack, error, hasError) => {
+  var E = typeof SuppressedError === "function" ? SuppressedError : function(e, s, m, _) {
+    return _ = Error(m), _.name = "SuppressedError", _.error = e, _.suppressed = s, _;
+  };
+  var fail = (e) => error = hasError ? new E(e, error, "An error was suppressed during disposal") : (hasError = true, e);
+  var next = (it) => {
+    while (it = stack.pop()) {
+      try {
+        var result = it[1] && it[1].call(it[2]);
+        if (it[0]) return Promise.resolve(result).then(next, (e) => (fail(e), next()));
+      } catch (e) {
+        fail(e);
+      }
+    }
+    if (hasError) throw error;
+  };
+  return next();
+};
+/**
+ * @license
+ * Copyright 2022-2026 Matter.js Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { Time } from "#time/Time.js";
+import { Timestamp } from "#time/Timestamp.js";
+import { Seconds } from "#time/TimeUnit.js";
+import { Lifetime } from "#util/Lifetime.js";
+import { Observable, ObserverGroup } from "#util/Observable.js";
+import { Scheduler } from "#util/Scheduler.js";
+import { DnssdName } from "./DnssdName.js";
+import { QueryMulticaster } from "./DnssdSolicitor.js";
+class DnssdNames {
+  #socket;
+  #lifetime;
+  #entropy;
+  #filter;
+  #solicitor;
+  #observers = new ObserverGroup();
+  #names = /* @__PURE__ */ new Map();
+  #expiration;
+  #discovered = new Observable();
+  #goodbyeProtectionWindow;
+  #minTtl;
+  constructor({
+    socket,
+    lifetime = Lifetime.process,
+    entropy,
+    filter,
+    goodbyeProtectionWindow,
+    minTtl
+  }) {
+    this.#socket = socket;
+    this.#lifetime = lifetime.join("mdns client");
+    this.#entropy = entropy;
+    this.#filter = filter;
+    this.#solicitor = new QueryMulticaster(this);
+    this.#goodbyeProtectionWindow = goodbyeProtectionWindow ?? DnssdNames.defaults.goodbyeProtectionWindow;
+    this.#minTtl = minTtl ?? DnssdNames.defaults.minTtl;
+    this.#observers.on(this.#socket.receipt, this.#handleMessage.bind(this));
+    this.#expiration = new Scheduler({
+      name: "expiration scheduler",
+      lifetime: this.#lifetime,
+      timeOf: (a) => {
+        return a.expiresAt;
+      },
+      run: (record) => {
+        const discoveryName = this.#names.get(record.name);
+        if (discoveryName) {
+          discoveryName.deleteRecord(record);
+        }
+      }
+    });
+  }
+  #handleMessage(message) {
+    let goodbyesBefore;
+    for (let record of [...message.answers, ...message.additionalRecords]) {
+      if (this.#filter && !this.#filter(record)) {
+        continue;
+      }
+      const name = this.get(record.name);
+      if (record.ttl) {
+        if (record.ttl < this.#minTtl) {
+          record = { ...record, ttl: this.#minTtl };
+        }
+        const wasDiscovered = name.isDiscovered;
+        name.installRecord(record);
+        if (!wasDiscovered && name.isDiscovered) {
+          this.#discovered.emit(name);
+        }
+      } else {
+        if (goodbyesBefore === void 0) {
+          goodbyesBefore = Timestamp(Time.nowMs - this.#goodbyeProtectionWindow);
+        }
+        name.deleteRecord(record, goodbyesBefore);
+      }
+    }
+  }
+  /**
+   * Test for existence of name.
+   */
+  has(name) {
+    name = name.toLowerCase();
+    return this.#names.has(name);
+  }
+  /**
+   * Retrieve the {@link DnssdName} for {@link name}.
+   *
+   * This will create the name if it does not exist, and if you do not add an observer then it will not automatically
+   * delete if there are no records.  So if you may not use the record test for existence with {@link has} first.
+   */
+  get(qname) {
+    let name = this.maybeGet(qname);
+    if (name === void 0) {
+      name = new DnssdName(qname, this.#nameContext);
+      this.#names.set(qname, name);
+    }
+    return name;
+  }
+  /**
+   * Retrieve the {@link DnssdName} if known.
+   */
+  maybeGet(name) {
+    name = name.toLowerCase();
+    return this.#names.get(name);
+  }
+  /**
+   * Wait for all workers and close all names.
+   */
+  async close() {
+    var _stack = [];
+    try {
+      const _closing = __using(_stack, this.#lifetime.closing());
+      this.#observers.close();
+      await this.#expiration.close();
+      for (const name of this.#names.values()) {
+        await name.close();
+        this.#names.delete(name.qname);
+      }
+      await this.#solicitor.close();
+    } catch (_) {
+      var _error = _, _hasError = true;
+    } finally {
+      __callDispose(_stack, _error, _hasError);
+    }
+  }
+  get socket() {
+    return this.#socket;
+  }
+  /**
+   * Emits when a {@link DnssdName} is first discovered.
+   */
+  get discovered() {
+    return this.#discovered;
+  }
+  /**
+   * Shared solicitor.
+   *
+   * We offer solicitation in this object so there is not redundant solicitation across interested parties.
+   */
+  get solicitor() {
+    return this.#solicitor;
+  }
+  get entropy() {
+    return this.#entropy;
+  }
+  #nameContext = {
+    delete: (name) => {
+      const known = this.#names.get(name.qname);
+      if (known === name) {
+        this.#names.delete(name.qname);
+      }
+    },
+    registerForExpiration: (record) => {
+      this.#expiration.add(record);
+    },
+    unregisterForExpiration: (record) => {
+      this.#expiration.delete(record);
+    }
+  };
+}
+((DnssdNames2) => {
+  DnssdNames2.defaults = {
+    goodbyeProtectionWindow: Seconds(1),
+    minTtl: Seconds(15)
+    // This is the value that Apple uses
+  };
+})(DnssdNames || (DnssdNames = {}));
+export {
+  DnssdNames
+};
+//# sourceMappingURL=DnssdNames.js.map

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

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

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

@@ -0,0 +1,80 @@
+/**
+ * @license
+ * Copyright 2022-2026 Matter.js Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { DnsRecordType } from "#codec/DnsCodec.js";
+import { RetrySchedule } from "#net/RetrySchedule.js";
+import type { DnssdName } from "./DnssdName.js";
+import type { DnssdNames } from "./DnssdNames.js";
+/**
+ * Solicits DNS-SD records for specific names.
+ */
+export interface DnssdSolicitor {
+    /**
+     * Send a single MDNS query for a specific DNS-SD name.
+     *
+     * Multiple solicitations for the same name are coalesced into the same query using a macrotask.
+     */
+    solicit(solicitation: DnssdSolicitor.Solicitation): void;
+    /**
+     * Send MDNS queries for a specific DNS-SD name using a standard MDNS transmission schedule.
+     *
+     * The solicitor does not have a notion of "discovery complete", so this function does not return until
+     * {@link DnssdSolicitor.Discovery.abort} signals abort (or the solicitor is closed).
+     *
+     * Multiple simultaneous attempts to complete discovery of the same name will not result in redundant solicitations.
+     *
+     * If fields in {@link discovery} change their value is used for the next solicitation.
+     */
+    discover(discovery: DnssdSolicitor.Discovery): Promise<void>;
+}
+/**
+ * Solicit one or more record types for a name.
+ *
+ * "Soliciting" consists of broadcasting a query for a DNS-SD name.  Groups multiple solicitations in the same
+ * macrotask into a single packet.
+ */
+export declare namespace DnssdSolicitor {
+    /**
+     * Configures solicitation of a single name.
+     */
+    interface Solicitation {
+        /**
+         * The name to solicit.
+         */
+        name: DnssdName;
+        /**
+         * Record types to request.
+         */
+        recordTypes: DnsRecordType[];
+        /**
+         * Additional names to include as known answers.
+         */
+        associatedNames?: Iterable<DnssdName>;
+    }
+    /**
+     * Configures repeated solicitation.
+     */
+    interface Discovery extends Solicitation {
+        /**
+         * Terminates discovery.
+         */
+        abort: AbortSignal;
+    }
+    /**
+     * Default retry schedule per RFC 6762 (initial delay of 20-120ms. handled separately).
+     */
+    const DefaultRetries: RetrySchedule.Configuration;
+}
+/**
+ * Concrete implementation of {@link DnssdSolicitor} that sends DNS-SD queries via multicast.
+ */
+export declare class QueryMulticaster implements DnssdSolicitor {
+    #private;
+    constructor(names: DnssdNames, retries?: RetrySchedule.Configuration);
+    solicit(solicitation: DnssdSolicitor.Solicitation): void;
+    discover(discovery: DnssdSolicitor.Discovery): Promise<void>;
+    close(): Promise<void>;
+}
+//# sourceMappingURL=DnssdSolicitor.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"DnssdSolicitor.d.ts","sourceRoot":"","sources":["../../../../src/net/dns-sd/DnssdSolicitor.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAuD,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAExG,OAAO,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAMtD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAChD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAIlD;;GAEG;AACH,MAAM,WAAW,cAAc;IAC3B;;;;OAIG;IACH,OAAO,CAAC,YAAY,EAAE,cAAc,CAAC,YAAY,GAAG,IAAI,CAAC;IAEzD;;;;;;;;;OASG;IACH,QAAQ,CAAC,SAAS,EAAE,cAAc,CAAC,SAAS,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAChE;AAED;;;;;GAKG;AACH,yBAAiB,cAAc,CAAC;IAC5B;;OAEG;IACH,UAAiB,YAAY;QACzB;;WAEG;QACH,IAAI,EAAE,SAAS,CAAC;QAEhB;;WAEG;QACH,WAAW,EAAE,aAAa,EAAE,CAAC;QAE7B;;WAEG;QACH,eAAe,CAAC,EAAE,QAAQ,CAAC,SAAS,CAAC,CAAC;KACzC;IAED;;OAEG;IACH,UAAiB,SAAU,SAAQ,YAAY;QAC3C;;WAEG;QACH,KAAK,EAAE,WAAW,CAAC;KACtB;IAED;;OAEG;IACI,MAAM,cAAc,EAAE,aAAa,CAAC,aAK1C,CAAC;CACL;AAED;;GAEG;AACH,qBAAa,gBAAiB,YAAW,cAAc;;gBASvC,KAAK,EAAE,UAAU,EAAE,OAAO,CAAC,EAAE,aAAa,CAAC,aAAa;IASpE,OAAO,CAAC,YAAY,EAAE,cAAc,CAAC,YAAY;IAoB3C,QAAQ,CAAC,SAAS,EAAE,cAAc,CAAC,SAAS;IA6C5C,KAAK;CAqDd"}

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

@@ -0,0 +1,192 @@
+var __knownSymbol = (name, symbol) => (symbol = Symbol[name]) ? symbol : /* @__PURE__ */ Symbol.for("Symbol." + name);
+var __typeError = (msg) => {
+  throw TypeError(msg);
+};
+var __using = (stack, value, async) => {
+  if (value != null) {
+    if (typeof value !== "object" && typeof value !== "function") __typeError("Object expected");
+    var dispose, inner;
+    if (async) dispose = value[__knownSymbol("asyncDispose")];
+    if (dispose === void 0) {
+      dispose = value[__knownSymbol("dispose")];
+      if (async) inner = dispose;
+    }
+    if (typeof dispose !== "function") __typeError("Object not disposable");
+    if (inner) dispose = function() {
+      try {
+        inner.call(this);
+      } catch (e) {
+        return Promise.reject(e);
+      }
+    };
+    stack.push([async, dispose, value]);
+  } else if (async) {
+    stack.push([async]);
+  }
+  return value;
+};
+var __callDispose = (stack, error, hasError) => {
+  var E = typeof SuppressedError === "function" ? SuppressedError : function(e, s, m, _) {
+    return _ = Error(m), _.name = "SuppressedError", _.error = e, _.suppressed = s, _;
+  };
+  var fail = (e) => error = hasError ? new E(e, error, "An error was suppressed during disposal") : (hasError = true, e);
+  var next = (it) => {
+    while (it = stack.pop()) {
+      try {
+        var result = it[1] && it[1].call(it[2]);
+        if (it[0]) return Promise.resolve(result).then(next, (e) => (fail(e), next()));
+      } catch (e) {
+        fail(e);
+      }
+    }
+    if (hasError) throw error;
+  };
+  return next();
+};
+/**
+ * @license
+ * Copyright 2022-2026 Matter.js Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { DnsMessageType, DnsRecordClass } from "#codec/DnsCodec.js";
+import { Logger } from "#log/Logger.js";
+import { RetrySchedule } from "#net/RetrySchedule.js";
+import { Time } from "#time/Time.js";
+import { Hours, Millis, Seconds } from "#time/TimeUnit.js";
+import { Abort } from "#util/Abort.js";
+import { BasicMultiplex } from "#util/Multiplex.js";
+import { ObservableValue } from "#util/Observable.js";
+const logger = new Logger("DiscoverySolicitor");
+var DnssdSolicitor;
+((DnssdSolicitor2) => {
+  DnssdSolicitor2.DefaultRetries = {
+    initialInterval: Seconds(1),
+    jitterFactor: 0.2,
+    backoffFactor: 2,
+    maximumInterval: Hours(1)
+  };
+})(DnssdSolicitor || (DnssdSolicitor = {}));
+class QueryMulticaster {
+  #names;
+  #schedule;
+  #abort = new Abort();
+  #toSolicit = /* @__PURE__ */ new Map();
+  #discovering = /* @__PURE__ */ new Map();
+  #namesReady = new ObservableValue();
+  #workers = new BasicMultiplex();
+  constructor(names, retries) {
+    this.#names = names;
+    this.#schedule = new RetrySchedule(
+      names.entropy,
+      RetrySchedule.Configuration(DnssdSolicitor.DefaultRetries, retries)
+    );
+    this.#workers.add(this.#emitSolicitations());
+  }
+  solicit(solicitation) {
+    if (this.#abort.aborted) {
+      return;
+    }
+    const entry = this.#toSolicit.get(solicitation.name);
+    if (entry === void 0) {
+      this.#toSolicit.set(solicitation.name, { ...solicitation });
+    } else {
+      entry.recordTypes = [.../* @__PURE__ */ new Set([...entry.recordTypes, ...solicitation.recordTypes])];
+      if (solicitation.associatedNames) {
+        if (!entry.associatedNames) {
+          entry.associatedNames = solicitation.associatedNames;
+        } else {
+          entry.associatedNames = [.../* @__PURE__ */ new Set([...entry.associatedNames, ...solicitation.associatedNames])];
+        }
+      }
+    }
+    this.#namesReady.emit(true);
+  }
+  async discover(discovery) {
+    let active = this.#discovering.get(discovery.name);
+    if (active) {
+      active.waiting.add(discovery);
+    } else {
+      const abort = new Abort({ abort: this.#abort });
+      active = {
+        abort,
+        finished: this.#discover(discovery, abort),
+        waiting: /* @__PURE__ */ new Set([discovery])
+      };
+      this.#discovering.set(discovery.name, active);
+    }
+    try {
+      await Abort.race(discovery.abort, active.finished);
+    } finally {
+      active.waiting.delete(discovery);
+      if (active.waiting.size === 0) {
+        active.abort();
+        this.#discovering.delete(discovery.name);
+      }
+    }
+  }
+  async #discover(solicitation, abort) {
+    let timeout = Millis.floor(Millis(20 + 100 * (this.#names.entropy.randomUint32 / Math.pow(2, 32))));
+    for (const nextTimeout of this.#schedule) {
+      var _stack = [];
+      try {
+        const delay = __using(_stack, new Abort({ abort, timeout }));
+        await delay;
+        if (abort.aborted) {
+          break;
+        }
+        timeout = nextTimeout;
+        this.solicit(solicitation);
+      } catch (_) {
+        var _error = _, _hasError = true;
+      } finally {
+        __callDispose(_stack, _error, _hasError);
+      }
+    }
+  }
+  async close() {
+    this.#abort();
+    await this.#workers;
+  }
+  async #emitSolicitations() {
+    while (true) {
+      await this.#abort.race(this.#namesReady);
+      if (this.#abort.aborted) {
+        return;
+      }
+      await this.#abort.race(Time.sleep("discovery solicitor delay", 0));
+      if (this.#abort.aborted) {
+        return;
+      }
+      const entries = [...this.#toSolicit.values()];
+      this.#namesReady.value = false;
+      this.#toSolicit.clear();
+      const queries = Array();
+      const answers = Array();
+      for (const {
+        name: { qname: name, records },
+        recordTypes
+      } of entries) {
+        for (const recordType of recordTypes) {
+          queries.push({ name, recordClass: DnsRecordClass.IN, recordType });
+        }
+        answers.push(...records);
+      }
+      try {
+        await this.#abort.race(
+          this.#names.socket.send({
+            messageType: DnsMessageType.Query,
+            queries,
+            answers
+          })
+        );
+      } catch (e) {
+        logger.error("Unhandled error soliciting DNS-SD names:", e);
+      }
+    }
+  }
+}
+export {
+  DnssdSolicitor,
+  QueryMulticaster
+};
+//# sourceMappingURL=DnssdSolicitor.js.map

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

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

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

@@ -0,0 +1,73 @@
+/**
+ * @license
+ * Copyright 2022-2026 Matter.js Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { ServerAddressUdp } from "#net/ServerAddress.js";
+import { ServerAddressSet } from "#net/ServerAddressSet.js";
+import { AsyncObservable } from "#util/Observable.js";
+import { DnssdName } from "./DnssdName.js";
+import { DnssdNames } from "./DnssdNames.js";
+import { IpServiceStatus } from "./IpServiceStatus.js";
+/**
+ * A service addressable by IP that updates as {@link DnssdNames} change.
+ */
+export declare class IpService {
+    #private;
+    constructor(name: string, via: string, names: DnssdNames);
+    /**
+     * The DNS-SD name.
+     */
+    get name(): DnssdName;
+    /**
+     * Other DNS-SD names.
+     */
+    get names(): DnssdNames;
+    /**
+     * Identifier used for logging.
+     */
+    get via(): string;
+    /**
+     * Status details of the service.
+     */
+    get status(): IpServiceStatus;
+    /**
+     * Release resources.
+     */
+    close(): Promise<void>;
+    /**
+     * Known addresses.
+     */
+    get addresses(): ServerAddressSet<ServerAddressUdp>;
+    /**
+     * Values from TXT records.
+     */
+    get parameters(): Map<string, string>;
+    /**
+     * Emits when the service changes.
+     */
+    get changed(): AsyncObservable<[], void>;
+    map<T>(fn: (addr: ServerAddressUdp) => T): T[];
+    /**
+     * Stream address updates, starting with initial set of addresses.
+     *
+     * Outputs addresses in priority order so the stream may be used directly for establishing new connections.
+     *
+     * If no addresses are present, triggers discovery using standard MDNS backoff schedule.
+     */
+    addressChanges({ abort, order, }?: {
+        abort?: AbortSignal;
+        order?: ServerAddressSet.Comparator;
+        ipv4?: boolean;
+    }): AsyncGenerator<{
+        kind: "add" | "delete";
+        address: ServerAddressUdp;
+    }>;
+}
+export declare namespace IpService {
+    interface AddressChange {
+        kind: "add" | "delete";
+        address: ServerAddressUdp;
+    }
+}
+//# sourceMappingURL=IpService.d.ts.map