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

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

@@ -0,0 +1,329 @@
+"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 IpService_exports = {};
+__export(IpService_exports, {
+  IpService: () => IpService
+});
+module.exports = __toCommonJS(IpService_exports);
+var import_DnsCodec = require("#codec/DnsCodec.js");
+var import_Diagnostic = require("#log/Diagnostic.js");
+var import_ServerAddressSet = require("#net/ServerAddressSet.js");
+var import_Time = require("#time/Time.js");
+var import_Abort = require("#util/Abort.js");
+var import_Observable = require("#util/Observable.js");
+var import_IpServiceStatus = require("./IpServiceStatus.js");
+/**
+ * @license
+ * Copyright 2022-2026 Matter.js Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+class IpService {
+  #name;
+  #via;
+  #names;
+  #observers = new import_Observable.ObserverGroup(this);
+  #services = /* @__PURE__ */ new Map();
+  #changed = new import_Observable.AsyncObservable();
+  #addresses = (0, import_ServerAddressSet.ServerAddressSet)();
+  #status = new import_IpServiceStatus.IpServiceStatus(this);
+  #notified;
+  constructor(name, via, names) {
+    this.#name = names.get(name);
+    this.#names = names;
+    this.#via = import_Diagnostic.Diagnostic.via(via);
+    this.#observers.on(this.#name, this.#onServiceChanged);
+    for (const record of this.#name.records) {
+      const service = serviceOf(record);
+      if (!service) {
+        continue;
+      }
+      this.#updateService(record.ttl, service);
+    }
+  }
+  /**
+   * The DNS-SD name.
+   */
+  get name() {
+    return this.#name;
+  }
+  /**
+   * Other DNS-SD names.
+   */
+  get names() {
+    return this.#names;
+  }
+  /**
+   * Identifier used for logging.
+   */
+  get via() {
+    return this.#via;
+  }
+  /**
+   * Status details of the service.
+   */
+  get status() {
+    return this.#status;
+  }
+  /**
+   * Release resources.
+   */
+  async close() {
+    this.#observers.close();
+    await this.#status.close();
+    if (this.#notified) {
+      await this.#notified;
+    }
+  }
+  /**
+   * Known addresses.
+   */
+  get addresses() {
+    return this.#addresses;
+  }
+  /**
+   * Values from TXT records.
+   */
+  get parameters() {
+    return this.#name.parameters;
+  }
+  /**
+   * Emits when the service changes.
+   */
+  get changed() {
+    return this.#changed;
+  }
+  map(fn) {
+    return [...this.addresses].map(fn);
+  }
+  /**
+   * 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.
+   */
+  async *addressChanges({
+    abort,
+    order = import_ServerAddressSet.ServerAddressSet.compareDesirability
+  } = {}) {
+    var _stack = [];
+    try {
+      let knownAddresses = /* @__PURE__ */ new Set();
+      const dirty = new import_Observable.AsyncObservableValue();
+      const _changed = __using(_stack, this.changed.use(() => dirty.emit(true)));
+      loop: while (true) {
+        dirty.emit(false);
+        const addresses = (0, import_ServerAddressSet.ServerAddressSet)(this.addresses, order);
+        let changes = new Array();
+        const oldKnownAddresses = knownAddresses;
+        knownAddresses = /* @__PURE__ */ new Set();
+        for (const address of addresses) {
+          knownAddresses.add(address);
+          if (oldKnownAddresses.has(address)) {
+            oldKnownAddresses.delete(address);
+            continue;
+          }
+          changes.push({ kind: "add", address });
+        }
+        if (oldKnownAddresses.size) {
+          const deletedAddresses = [...oldKnownAddresses.values()];
+          const deletes = deletedAddresses.map((address) => ({ kind: "delete", address }));
+          changes = [...deletes, ...changes];
+        }
+        for (const change of changes) {
+          yield change;
+          if (import_Abort.Abort.is(abort)) {
+            return;
+          }
+          if (dirty.value) {
+            continue loop;
+          }
+        }
+        await import_Abort.Abort.race(abort, dirty);
+        if (import_Abort.Abort.is(abort)) {
+          return;
+        }
+      }
+    } catch (_) {
+      var _error = _, _hasError = true;
+    } finally {
+      __callDispose(_stack, _error, _hasError);
+    }
+  }
+  #onServiceChanged = async ({ updated, deleted }) => {
+    if (updated) {
+      for (const record of updated) {
+        const service = serviceOf(record);
+        if (service) {
+          this.#updateService(record.ttl, service);
+        }
+      }
+    }
+    if (deleted) {
+      for (const record of deleted) {
+        const service = serviceOf(record);
+        if (service) {
+          this.#deleteService(service);
+        }
+      }
+    }
+  };
+  #updateService(ttl, { target, port, priority, weight }) {
+    const key = hostKeyOf(target, port);
+    let service = this.#services.get(key);
+    if (service) {
+      service.discoveredAt = import_Time.Time.nowMs;
+      service.ttl = ttl;
+      service.port = port;
+      service.priority = priority;
+      service.weight = weight;
+      return;
+    }
+    service = {
+      name: this.#names.get(target),
+      discoveredAt: import_Time.Time.nowMs,
+      ttl,
+      port,
+      priority,
+      weight,
+      onChange: (changes) => this.#onAddressChanged(service, changes)
+    };
+    this.#observers.on(service.name, service.onChange);
+    this.#onAddressChanged(service, { name: service.name, updated: [...service.name.records] });
+    this.#services.set(key, service);
+  }
+  #deleteService({ target, port }) {
+    const key = hostKeyOf(target, port);
+    const service = this.#services.get(key);
+    if (!service) {
+      return;
+    }
+    this.#services.delete(key);
+    this.#observers.off(service.name, service.onChange);
+    this.#onAddressChanged(service, { name: service.name, deleted: [...service.name.records] });
+    return;
+  }
+  #onAddressChanged = (service, { updated, deleted }) => {
+    if (updated) {
+      for (const record of updated) {
+        const addr = addressOf(record);
+        if (addr) {
+          this.#updateAddress(service, addr);
+        }
+      }
+    }
+    if (deleted) {
+      for (const record of deleted) {
+        const addr = addressOf(record);
+        if (addr) {
+          this.#deleteAddress(service, addr);
+        }
+      }
+    }
+  };
+  #updateAddress(service, ip) {
+    const address = { type: "udp", ip, port: service.port };
+    if (this.#addresses.has(address)) {
+      return;
+    }
+    this.#addresses.add(address);
+    this.#status.isReachable = true;
+    this.#notify();
+  }
+  #deleteAddress(service, ip) {
+    const address = { type: "udp", ip, port: service.port };
+    if (!this.#addresses.has(address)) {
+      return;
+    }
+    this.#addresses.delete(address);
+    this.#notify();
+  }
+  #notify = () => {
+    if (this.#notified) {
+      return;
+    }
+    this.#notified = this.#emitNotification();
+  };
+  async #emitNotification() {
+    await import_Time.Time.sleep("discovery service coalescence", 0);
+    this.#notified = void 0;
+    await this.changed.emit();
+  }
+}
+function serviceOf(record) {
+  if (record.recordType !== import_DnsCodec.DnsRecordType.SRV) {
+    return;
+  }
+  return record.value;
+}
+function hostKeyOf(name, port) {
+  return `${name}:${port}`;
+}
+function addressOf(record) {
+  if (record.recordType !== import_DnsCodec.DnsRecordType.A && record.recordType !== import_DnsCodec.DnsRecordType.AAAA) {
+    return;
+  }
+  return record.value;
+}
+//# sourceMappingURL=IpService.js.map

package/dist/cjs/net/dns-sd/IpService.js.map

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

package/dist/cjs/net/dns-sd/IpServiceResolution.d.ts

@@ -0,0 +1,16 @@
+/**
+ * @license
+ * Copyright 2022-2026 Matter.js Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { IpService } from "./IpService.js";
+/**
+ * Discovers new IP addresses for an {@link IpService}.
+ *
+ * This primarily involves sending queries for SRV records using {@link DnssdSolicitor#discover}.  We also query for
+ * A and AAAA records for any SRV target hostnames for which we do not know IP addresses.
+ *
+ * Runs until aborted or we discover a new IP address (we ignore existing addresses).
+ */
+export declare function IpServiceResolution(service: IpService, abort: AbortSignal, ipv4?: boolean): Promise<void>;
+//# sourceMappingURL=IpServiceResolution.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"IpServiceResolution.d.ts","sourceRoot":"","sources":["../../../../src/net/dns-sd/IpServiceResolution.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAWH,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAE3C;;;;;;;GAOG;AACH,wBAAsB,mBAAmB,CAAC,OAAO,EAAE,SAAS,EAAE,KAAK,EAAE,WAAW,EAAE,IAAI,UAAO,iBA4G5F"}

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

@@ -0,0 +1,162 @@
+"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 IpServiceResolution_exports = {};
+__export(IpServiceResolution_exports, {
+  IpServiceResolution: () => IpServiceResolution
+});
+module.exports = __toCommonJS(IpServiceResolution_exports);
+var import_DnsCodec = require("#codec/DnsCodec.js");
+var import_ServerAddressSet = require("#net/ServerAddressSet.js");
+var import_Abort = require("#util/Abort.js");
+var import_Ip = require("#util/Ip.js");
+var import_Multiplex = require("#util/Multiplex.js");
+var import_Observable = require("#util/Observable.js");
+var import_Set = require("#util/Set.js");
+/**
+ * @license
+ * Copyright 2022-2026 Matter.js Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+async function IpServiceResolution(service, abort, ipv4 = true) {
+  var _stack = [];
+  try {
+    const localAbort = __using(_stack, new import_Abort.Abort({ abort }));
+    const workers = __using(_stack, new import_Multiplex.BasicMultiplex(), true);
+    const observers = __using(_stack, new import_Observable.ObserverGroup());
+    const hosts = new import_Set.BasicSet();
+    let hostResolvers;
+    observers.on(hosts.added, (name) => {
+      if ([...name.records].find(
+        (record) => record.recordType === import_DnsCodec.DnsRecordType.AAAA || record.recordType === import_DnsCodec.DnsRecordType.A
+      )) {
+        return;
+      }
+      if (!hostResolvers) {
+        hostResolvers = /* @__PURE__ */ new Map();
+      }
+      const hostAbort = new import_Abort.Abort({ abort: localAbort });
+      hostResolvers.set(name, hostAbort);
+      workers.add(
+        service.names.solicitor.discover({
+          name,
+          recordTypes: ipv4 ? [import_DnsCodec.DnsRecordType.A, import_DnsCodec.DnsRecordType.AAAA] : [import_DnsCodec.DnsRecordType.AAAA],
+          abort: hostAbort
+        }).finally(hostAbort.close.bind(hostAbort))
+      );
+    });
+    observers.on(hosts.deleted, (name) => {
+      const abortHost = hostResolvers?.get(name);
+      if (!abortHost) {
+        return;
+      }
+      hostResolvers?.delete(name);
+      abortHost();
+    });
+    for (const record of service.name.records) {
+      if (record.recordType !== import_DnsCodec.DnsRecordType.SRV) {
+        continue;
+      }
+      hosts.add(service.names.get(record.name));
+    }
+    const existingAddresses = (0, import_ServerAddressSet.ServerAddressSet)(service.addresses);
+    observers.on(service.changed, () => {
+      for (const address of service.addresses) {
+        if (!ipv4 && (0, import_Ip.isIPv4)(address.ip)) {
+          continue;
+        }
+        if (!existingAddresses.has(address) && (ipv4 || (0, import_Ip.isIPv6)(address.ip))) {
+          localAbort();
+        }
+      }
+      const srvs = [...service.name.records].filter((record) => record.recordType === import_DnsCodec.DnsRecordType.SRV);
+      const newHostnames = new Set(srvs.map((record) => record.value.target));
+      for (const hostname of newHostnames) {
+        hosts.add(service.names.get(hostname));
+      }
+      for (const name of hosts) {
+        if (newHostnames.has(name.qname)) {
+          continue;
+        }
+        hosts.delete(name);
+      }
+    });
+    workers.add(
+      service.names.solicitor.discover({
+        abort: localAbort,
+        name: service.name,
+        recordTypes: [import_DnsCodec.DnsRecordType.SRV],
+        get associatedNames() {
+          return hosts;
+        }
+      })
+    );
+    await localAbort;
+  } catch (_) {
+    var _error = _, _hasError = true;
+  } finally {
+    var _promise = __callDispose(_stack, _error, _hasError);
+    _promise && await _promise;
+  }
+}
+//# sourceMappingURL=IpServiceResolution.js.map

package/dist/cjs/net/dns-sd/IpServiceResolution.js.map

@@ -0,0 +1,6 @@
+{
+  "version": 3,
+  "sources": ["../../../../src/net/dns-sd/IpServiceResolution.ts"],
+  "mappings": ";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAMA,sBAA8B;AAC9B,8BAAiC;AACjC,mBAAsB;AACtB,gBAA+B;AAC/B,uBAA+B;AAC/B,wBAA8B;AAC9B,iBAAyB;AAZzB;AAAA;AAAA;AAAA;AAAA;AAyBA,eAAsB,oBAAoB,SAAoB,OAAoB,OAAO,MAAM;AAC3F;AAAA;AAAA,UAAM,aAAa,oBAAI,mBAAM,EAAE,MAAM,CAAC;AACtC,UAAY,UAAU,oBAAI,gCAAe,GAAnB;AACtB,UAAM,YAAY,oBAAI,gCAAc;AAIpC,UAAM,QAAQ,IAAI,oBAAoB;AAGtC,QAAI;AAGJ,cAAU,GAAG,MAAM,OAAO,UAAQ;AAE9B,UACI,CAAC,GAAG,KAAK,OAAO,EAAE;AAAA,QACd,YAAU,OAAO,eAAe,8BAAc,QAAQ,OAAO,eAAe,8BAAc;AAAA,MAC9F,GACF;AACE;AAAA,MACJ;AAGA,UAAI,CAAC,eAAe;AAChB,wBAAgB,oBAAI,IAAI;AAAA,MAC5B;AACA,YAAM,YAAY,IAAI,mBAAM,EAAE,OAAO,WAAW,CAAC;AACjD,oBAAc,IAAI,MAAM,SAAS;AACjC,cAAQ;AAAA,QACJ,QAAQ,MAAM,UACT,SAAS;AAAA,UACN;AAAA,UACA,aAAa,OAAO,CAAC,8BAAc,GAAG,8BAAc,IAAI,IAAI,CAAC,8BAAc,IAAI;AAAA,UAC/E,OAAO;AAAA,QACX,CAAC,EACA,QAAQ,UAAU,MAAM,KAAK,SAAS,CAAC;AAAA,MAChD;AAAA,IACJ,CAAC;AAGD,cAAU,GAAG,MAAM,SAAS,UAAQ;AAChC,YAAM,YAAY,eAAe,IAAI,IAAI;AACzC,UAAI,CAAC,WAAW;AACZ;AAAA,MACJ;AAEA,qBAAe,OAAO,IAAI;AAC1B,gBAAU;AAAA,IACd,CAAC;AAGD,eAAW,UAAU,QAAQ,KAAK,SAAS;AACvC,UAAI,OAAO,eAAe,8BAAc,KAAK;AACzC;AAAA,MACJ;AAEA,YAAM,IAAI,QAAQ,MAAM,IAAI,OAAO,IAAI,CAAC;AAAA,IAC5C;AAGA,UAAM,wBAAoB,0CAAiB,QAAQ,SAAS;AAC5D,cAAU,GAAG,QAAQ,SAAS,MAAM;AAEhC,iBAAW,WAAW,QAAQ,WAAW;AACrC,YAAI,CAAC,YAAQ,kBAAO,QAAQ,EAAE,GAAG;AAE7B;AAAA,QACJ;AAEA,YAAI,CAAC,kBAAkB,IAAI,OAAO,MAAM,YAAQ,kBAAO,QAAQ,EAAE,IAAI;AAEjE,qBAAW;AAAA,QACf;AAAA,MACJ;AAGA,YAAM,OAAO,CAAC,GAAG,QAAQ,KAAK,OAAO,EAAE,OAAO,YAAU,OAAO,eAAe,8BAAc,GAAG;AAC/F,YAAM,eAAe,IAAI,IAAI,KAAK,IAAI,YAAU,OAAO,MAAM,MAAM,CAAC;AACpE,iBAAW,YAAY,cAAc;AAEjC,cAAM,IAAI,QAAQ,MAAM,IAAI,QAAQ,CAAC;AAAA,MACzC;AACA,iBAAW,QAAQ,OAAO;AACtB,YAAI,aAAa,IAAI,KAAK,KAAK,GAAG;AAC9B;AAAA,QACJ;AAGA,cAAM,OAAO,IAAI;AAAA,MACrB;AAAA,IACJ,CAAC;AAGD,YAAQ;AAAA,MACJ,QAAQ,MAAM,UAAU,SAAS;AAAA,QAC7B,OAAO;AAAA,QACP,MAAM,QAAQ;AAAA,QACd,aAAa,CAAC,8BAAc,GAAG;AAAA,QAE/B,IAAI,kBAAkB;AAClB,iBAAO;AAAA,QACX;AAAA,MACJ,CAAC;AAAA,IACL;AAGA,UAAM;AAAA,WA1GN;AAAA;AAAA;AAAA;AAAA;AAAA;AA2GJ;",
+  "names": []
+}

package/dist/cjs/net/dns-sd/IpServiceStatus.d.ts

@@ -0,0 +1,58 @@
+/**
+ * @license
+ * Copyright 2022-2026 Matter.js Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { Timestamp } from "#time/Timestamp.js";
+import type { IpService } from "./IpService.js";
+/**
+ * Tracks status of an {@link IpService}, logs state changes and manages service discovery.
+ */
+export declare class IpServiceStatus {
+    #private;
+    constructor(service: IpService);
+    close(): Promise<void>;
+    /**
+     * Is the service actively connecting?
+     *
+     * This is true so long as a promise passed to {@link connecting} is unresolved.
+     */
+    get isConnecting(): boolean;
+    /**
+     * Is the service currently reachable?
+     *
+     * This value is writable.  If you set {@link isReachable} to false and {@link isConnecting} is true, the service
+     * enters discovery mode and begins active solicitation so long as neither condition changes.
+     *
+     * The service sets {@link isReachable} to true automatically if:
+     *
+     * - It discovers a new (previously unknown) address, or
+     *
+     * - The input promise to {@link connecting} resolves to true
+     *
+     * The service sets {@link isReachable} to false automatically if the input promise to {@link connecting} resolves
+     * to false.
+     */
+    get isReachable(): boolean;
+    /**
+     * Are we actively performing MDNS discovery for the service?
+     */
+    get isResolving(): boolean;
+    set isReachable(isReachable: boolean);
+    get lastReceiptAt(): Timestamp | undefined;
+    set lastReceiptAt(time: Timestamp);
+    get connectionInitiatedAt(): Timestamp | undefined;
+    /**
+     * Register a new connection attempt.
+     *
+     * If {@link result} resolves as true the service is marked as reachable.  If {@link result} resolves as false
+     * reachability is not modified.
+     *
+     * If {@link result} throws an error other than {@link AbortedError}, the service is marked as unreachable and if
+     * the error logged.
+     *
+     * {@link isConnecting} will be true until {@link result} resolves.
+     */
+    connecting(result: PromiseLike<boolean>): void;
+}
+//# sourceMappingURL=IpServiceStatus.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"IpServiceStatus.d.ts","sourceRoot":"","sources":["../../../../src/net/dns-sd/IpServiceStatus.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAOH,OAAO,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAI/C,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAKhD;;GAEG;AACH,qBAAa,eAAe;;gBASZ,OAAO,EAAE,SAAS;IAIxB,KAAK;IAOX;;;;OAIG;IACH,IAAI,YAAY,YAEf;IAED;;;;;;;;;;;;;;OAcG;IACH,IAAI,WAAW,IAWc,OAAO,CATnC;IAED;;OAEG;IACH,IAAI,WAAW,YAEd;IAED,IAAI,WAAW,CAAC,WAAW,EAAE,OAAO,EAYnC;IAED,IAAI,aAAa,IAAI,SAAS,GAAG,SAAS,CAEzC;IAED,IAAI,aAAa,CAAC,IAAI,EAAE,SAAS,EAEhC;IAED,IAAI,qBAAqB,0BAExB;IAED;;;;;;;;;;OAUG;IACH,UAAU,CAAC,MAAM,EAAE,WAAW,CAAC,OAAO,CAAC;CAgG1C"}