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

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

@@ -0,0 +1,238 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __knownSymbol = (name, symbol) => (symbol = Symbol[name]) ? symbol : /* @__PURE__ */ Symbol.for("Symbol." + name);
+var __typeError = (msg) => {
+  throw TypeError(msg);
+};
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var __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();
+};
+var DnssdNames_exports = {};
+__export(DnssdNames_exports, {
+  DnssdNames: () => DnssdNames
+});
+module.exports = __toCommonJS(DnssdNames_exports);
+var import_Time = require("#time/Time.js");
+var import_Timestamp = require("#time/Timestamp.js");
+var import_TimeUnit = require("#time/TimeUnit.js");
+var import_Lifetime = require("#util/Lifetime.js");
+var import_Observable = require("#util/Observable.js");
+var import_Scheduler = require("#util/Scheduler.js");
+var import_DnssdName = require("./DnssdName.js");
+var import_DnssdSolicitor = require("./DnssdSolicitor.js");
+/**
+ * @license
+ * Copyright 2022-2026 Matter.js Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+class DnssdNames {
+  #socket;
+  #lifetime;
+  #entropy;
+  #filter;
+  #solicitor;
+  #observers = new import_Observable.ObserverGroup();
+  #names = /* @__PURE__ */ new Map();
+  #expiration;
+  #discovered = new import_Observable.Observable();
+  #goodbyeProtectionWindow;
+  #minTtl;
+  constructor({
+    socket,
+    lifetime = import_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 import_DnssdSolicitor.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 import_Scheduler.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 = (0, import_Timestamp.Timestamp)(import_Time.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 import_DnssdName.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: (0, import_TimeUnit.Seconds)(1),
+    minTtl: (0, import_TimeUnit.Seconds)(15)
+    // This is the value that Apple uses
+  };
+})(DnssdNames || (DnssdNames = {}));
+//# sourceMappingURL=DnssdNames.js.map

package/dist/cjs/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/cjs/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/cjs/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/cjs/net/dns-sd/DnssdSolicitor.js

@@ -0,0 +1,212 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __knownSymbol = (name, symbol) => (symbol = Symbol[name]) ? symbol : /* @__PURE__ */ Symbol.for("Symbol." + name);
+var __typeError = (msg) => {
+  throw TypeError(msg);
+};
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var __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();
+};
+var DnssdSolicitor_exports = {};
+__export(DnssdSolicitor_exports, {
+  DnssdSolicitor: () => DnssdSolicitor,
+  QueryMulticaster: () => QueryMulticaster
+});
+module.exports = __toCommonJS(DnssdSolicitor_exports);
+var import_DnsCodec = require("#codec/DnsCodec.js");
+var import_Logger = require("#log/Logger.js");
+var import_RetrySchedule = require("#net/RetrySchedule.js");
+var import_Time = require("#time/Time.js");
+var import_TimeUnit = require("#time/TimeUnit.js");
+var import_Abort = require("#util/Abort.js");
+var import_Multiplex = require("#util/Multiplex.js");
+var import_Observable = require("#util/Observable.js");
+/**
+ * @license
+ * Copyright 2022-2026 Matter.js Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+const logger = new import_Logger.Logger("DiscoverySolicitor");
+var DnssdSolicitor;
+((DnssdSolicitor2) => {
+  DnssdSolicitor2.DefaultRetries = {
+    initialInterval: (0, import_TimeUnit.Seconds)(1),
+    jitterFactor: 0.2,
+    backoffFactor: 2,
+    maximumInterval: (0, import_TimeUnit.Hours)(1)
+  };
+})(DnssdSolicitor || (DnssdSolicitor = {}));
+class QueryMulticaster {
+  #names;
+  #schedule;
+  #abort = new import_Abort.Abort();
+  #toSolicit = /* @__PURE__ */ new Map();
+  #discovering = /* @__PURE__ */ new Map();
+  #namesReady = new import_Observable.ObservableValue();
+  #workers = new import_Multiplex.BasicMultiplex();
+  constructor(names, retries) {
+    this.#names = names;
+    this.#schedule = new import_RetrySchedule.RetrySchedule(
+      names.entropy,
+      import_RetrySchedule.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 import_Abort.Abort({ abort: this.#abort });
+      active = {
+        abort,
+        finished: this.#discover(discovery, abort),
+        waiting: /* @__PURE__ */ new Set([discovery])
+      };
+      this.#discovering.set(discovery.name, active);
+    }
+    try {
+      await import_Abort.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 = import_TimeUnit.Millis.floor((0, import_TimeUnit.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 import_Abort.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(import_Time.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: import_DnsCodec.DnsRecordClass.IN, recordType });
+        }
+        answers.push(...records);
+      }
+      try {
+        await this.#abort.race(
+          this.#names.socket.send({
+            messageType: import_DnsCodec.DnsMessageType.Query,
+            queries,
+            answers
+          })
+        );
+      } catch (e) {
+        logger.error("Unhandled error soliciting DNS-SD names:", e);
+      }
+    }
+  }
+}
+//# sourceMappingURL=DnssdSolicitor.js.map

package/dist/cjs/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/cjs/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

package/dist/cjs/net/dns-sd/IpService.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"IpService.d.ts","sourceRoot":"","sources":["../../../../src/net/dns-sd/IpService.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH,OAAO,EAAmB,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAC1E,OAAO,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AAI5D,OAAO,EAAE,eAAe,EAAuC,MAAM,qBAAqB,CAAC;AAC3F,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAC3C,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAC7C,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAEvD;;GAEG;AACH,qBAAa,SAAS;;gBAWN,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,UAAU;IAgBxD;;OAEG;IACH,IAAI,IAAI,cAEP;IAED;;OAEG;IACH,IAAI,KAAK,eAER;IAED;;OAEG;IACH,IAAI,GAAG,WAEN;IAED;;OAEG;IACH,IAAI,MAAM,oBAET;IAED;;OAEG;IACG,KAAK;IAQX;;OAEG;IACH,IAAI,SAAS,uCAEZ;IAED;;OAEG;IACH,IAAI,UAAU,wBAEb;IAED;;OAEG;IACH,IAAI,OAAO,8BAEV;IAED,GAAG,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,IAAI,EAAE,gBAAgB,KAAK,CAAC,GAAG,CAAC,EAAE;IAI9C;;;;;;OAMG;IACI,cAAc,CAAC,EAClB,KAAK,EACL,KAA4C,GAC/C,GAAE;QACC,KAAK,CAAC,EAAE,WAAW,CAAC;QACpB,KAAK,CAAC,EAAE,gBAAgB,CAAC,UAAU,CAAC;QACpC,IAAI,CAAC,EAAE,OAAO,CAAC;KACb,GAAG,cAAc,CAAC;QAAE,IAAI,EAAE,KAAK,GAAG,QAAQ,CAAC;QAAC,OAAO,EAAE,gBAAgB,CAAA;KAAE,CAAC;CAyLjF;AAED,yBAAiB,SAAS,CAAC;IACvB,UAAiB,aAAa;QAC1B,IAAI,EAAE,KAAK,GAAG,QAAQ,CAAC;QACvB,OAAO,EAAE,gBAAgB,CAAC;KAC7B;CACJ"}