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

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

@@ -0,0 +1,191 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+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 IpServiceStatus_exports = {};
+__export(IpServiceStatus_exports, {
+  IpServiceStatus: () => IpServiceStatus
+});
+module.exports = __toCommonJS(IpServiceStatus_exports);
+var import_Diagnostic = require("#log/Diagnostic.js");
+var import_Logger = require("#log/Logger.js");
+var import_MatterError = require("#MatterError.js");
+var import_ServerAddress = require("#net/ServerAddress.js");
+var import_Time = require("#time/Time.js");
+var import_Abort = require("#util/Abort.js");
+var import_Error = require("#util/Error.js");
+var import_Set = require("#util/Set.js");
+var import_IpServiceResolution = require("./IpServiceResolution.js");
+/**
+ * @license
+ * Copyright 2022-2026 Matter.js Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+const logger = import_Logger.Logger.get("IpServiceStatus");
+class IpServiceStatus {
+  #service;
+  #isReachable = false;
+  #connecting = new import_Set.BasicSet();
+  #resolveAbort;
+  #resolving;
+  #connectionInitiatedAt;
+  #lastReceiptAt;
+  constructor(service) {
+    this.#service = service;
+  }
+  async close() {
+    this.#stopResolving();
+    if (this.#resolving) {
+      await this.#resolving;
+    }
+  }
+  /**
+   * Is the service actively connecting?
+   *
+   * This is true so long as a promise passed to {@link connecting} is unresolved.
+   */
+  get isConnecting() {
+    return this.#connecting.size > 0;
+  }
+  /**
+   * 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() {
+    return this.#isReachable;
+  }
+  /**
+   * Are we actively performing MDNS discovery for the service?
+   */
+  get isResolving() {
+    return this.#resolving !== void 0;
+  }
+  set isReachable(isReachable) {
+    if (this.#isReachable === isReachable) {
+      return;
+    }
+    this.#isReachable = isReachable;
+    if (isReachable) {
+      this.#maybeStopResolving();
+    } else {
+      this.#maybeStartResolving();
+    }
+  }
+  get lastReceiptAt() {
+    return this.#lastReceiptAt;
+  }
+  set lastReceiptAt(time) {
+    this.#lastReceiptAt = time;
+  }
+  get connectionInitiatedAt() {
+    return this.#connectionInitiatedAt;
+  }
+  /**
+   * 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) {
+    logger.debug(this.#service.via, "Connecting");
+    result.then(
+      (returned) => {
+        this.#connecting.delete(result);
+        if (!this.#connecting.size) {
+          this.#connectionInitiatedAt = void 0;
+        }
+        if (returned) {
+          this.isReachable = true;
+          logger.info(this.#service.via, "Connected");
+        } else {
+          logger.debug(this.#service.via, "Connect attempt aborted");
+        }
+        this.#maybeStopResolving();
+      },
+      (error) => {
+        this.#connecting.delete(result);
+        if (!(error instanceof import_MatterError.AbortedError)) {
+          return;
+        }
+        logger.error(this.#service.via, "Connection error:", (0, import_Error.asError)(error));
+        this.#isReachable = false;
+        this.#maybeStartResolving();
+      }
+    );
+    this.#connectionInitiatedAt = import_Time.Time.nowMs;
+    this.#connecting.add(result);
+    this.#maybeStartResolving();
+  }
+  #maybeStartResolving() {
+    if (this.#isReachable || !this.isConnecting || this.#resolveAbort) {
+      return;
+    }
+    const numAddresses = this.#service.addresses.size;
+    let why;
+    switch (numAddresses) {
+      case 0:
+        why = "need address";
+        break;
+      case 1:
+        why = "address is unreachable";
+        break;
+      default:
+        why = `${numAddresses} known addresses are unreachable`;
+    }
+    logger.info(this.#service.via, "Resolving", import_Diagnostic.Diagnostic.weak(`(${why})`));
+    this.#resolveAbort = new import_Abort.Abort();
+    this.#resolving = (0, import_IpServiceResolution.IpServiceResolution)(this.#service, this.#resolveAbort).finally(() => {
+      if (this.#resolveAbort?.aborted === false) {
+        const addresses = [...this.#service.addresses].map(import_ServerAddress.ServerAddress.urlFor);
+        logger.debug(this.#service.via, `Resolved as ${addresses.join(", ")}`);
+      }
+      this.#resolveAbort?.close();
+      this.#resolveAbort = void 0;
+      this.#resolving = void 0;
+    });
+  }
+  #maybeStopResolving() {
+    if (!this.#isReachable || this.isConnecting || !this.#resolveAbort) {
+      return;
+    }
+    this.#stopResolving();
+  }
+  #stopResolving() {
+    if (!this.#resolveAbort) {
+      return;
+    }
+    this.#resolveAbort();
+    logger.debug(this.#service.via, "Stopped resolving");
+  }
+}
+//# sourceMappingURL=IpServiceStatus.js.map

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

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

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

@@ -3,5 +3,11 @@
  * Copyright 2022-2026 Matter.js Authors
  * SPDX-License-Identifier: Apache-2.0
  */
+export * from "./DnssdName.js";
+export * from "./DnssdNames.js";
+export * from "./DnssdSolicitor.js";
+export * from "./IpService.js";
+export * from "./IpServiceResolution.js";
+export * from "./IpServiceStatus.js";
 export * from "./MdnsSocket.js";
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/net/dns-sd/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,cAAc,iBAAiB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/net/dns-sd/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,cAAc,gBAAgB,CAAC;AAC/B,cAAc,iBAAiB,CAAC;AAChC,cAAc,qBAAqB,CAAC;AACpC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,0BAA0B,CAAC;AACzC,cAAc,sBAAsB,CAAC;AACrC,cAAc,iBAAiB,CAAC"}

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

@@ -15,6 +15,12 @@ var __reExport = (target, mod, secondTarget) => (__copyProps(target, mod, "defau
 var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
 var dns_sd_exports = {};
 module.exports = __toCommonJS(dns_sd_exports);
+__reExport(dns_sd_exports, require("./DnssdName.js"), module.exports);
+__reExport(dns_sd_exports, require("./DnssdNames.js"), module.exports);
+__reExport(dns_sd_exports, require("./DnssdSolicitor.js"), module.exports);
+__reExport(dns_sd_exports, require("./IpService.js"), module.exports);
+__reExport(dns_sd_exports, require("./IpServiceResolution.js"), module.exports);
+__reExport(dns_sd_exports, require("./IpServiceStatus.js"), module.exports);
 __reExport(dns_sd_exports, require("./MdnsSocket.js"), module.exports);
 /**
  * @license

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

@@ -1,6 +1,6 @@
 {
   "version": 3,
   "sources": ["../../../../src/net/dns-sd/index.ts"],
-  "mappings": ";;;;;;;;;;;;;;;AAAA;AAAA;AAMA,2BAAc,4BANd;AAAA;AAAA;AAAA;AAAA;AAAA;",
+  "mappings": ";;;;;;;;;;;;;;;AAAA;AAAA;AAMA,2BAAc,2BANd;AAOA,2BAAc,4BAPd;AAQA,2BAAc,gCARd;AASA,2BAAc,2BATd;AAUA,2BAAc,qCAVd;AAWA,2BAAc,iCAXd;AAYA,2BAAc,4BAZd;AAAA;AAAA;AAAA;AAAA;AAAA;",
   "names": []
 }

package/dist/cjs/net/udp/UdpInterface.d.ts

@@ -7,6 +7,7 @@ import { Channel, ChannelType, IpNetworkChannel } from "#net/Channel.js";
 import { ConnectionlessTransport } from "#net/ConnectionlessTransport.js";
 import { Network } from "#net/Network.js";
 import { Bytes } from "#util/Bytes.js";
+import { Observable } from "#util/index.js";
 import { ServerAddress, ServerAddressUdp } from "../ServerAddress.js";
 import { UdpChannel } from "./UdpChannel.js";
 export declare class UdpInterface implements ConnectionlessTransport {
@@ -19,14 +20,15 @@ export declare class UdpInterface implements ConnectionlessTransport {
     onData(listener: (channel: Channel<Bytes>, messageBytes: Bytes) => void): ConnectionlessTransport.Listener;
     get port(): number;
     close(): Promise<void>;
-    addMembership(address: string): import("../../index.js").MaybePromise<void>;
-    dropMembership(address: string): import("../../index.js").MaybePromise<void>;
+    addMembership(address: string): import("#util/index.js").MaybePromise<void>;
+    dropMembership(address: string): import("#util/index.js").MaybePromise<void>;
 }
 export declare class UdpConnection implements IpNetworkChannel<Bytes> {
     #private;
     readonly isReliable = false;
     readonly supportsLargeMessages = false;
     readonly type = ChannelType.UDP;
+    readonly networkAddressChanged: Observable<[ServerAddressUdp], void>;
     constructor(server: UdpChannel, peerAddress: string, peerPort: number);
     get maxPayloadSize(): number;
     send(data: Bytes): Promise<void>;

package/dist/cjs/net/udp/UdpInterface.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"UdpInterface.d.ts","sourceRoot":"","sources":["../../../../src/net/udp/UdpInterface.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,OAAO,EAAE,WAAW,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AACzE,OAAO,EAAE,uBAAuB,EAAE,MAAM,iCAAiC,CAAC;AAC1E,OAAO,EAAE,OAAO,EAAgB,MAAM,iBAAiB,CAAC;AACxD,OAAO,EAAE,KAAK,EAAE,MAAM,gBAAgB,CAAC;AACvC,OAAO,EAAE,aAAa,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AACtE,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAE7C,qBAAa,YAAa,YAAW,uBAAuB;;WAG3C,MAAM,CAAC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,EAAE,YAAY,CAAC,EAAE,MAAM;gBAMpG,MAAM,EAAE,UAAU;IAI9B,SAAS,KAAK,MAAM,eAEnB;IAED,QAAQ,CAAC,IAAI,EAAE,WAAW,EAAE,OAAO,EAAE,MAAM;IAIrC,WAAW,CAAC,OAAO,EAAE,aAAa;IAQxC,MAAM,CAAC,QAAQ,EAAE,CAAC,OAAO,EAAE,OAAO,CAAC,KAAK,CAAC,EAAE,YAAY,EAAE,KAAK,KAAK,IAAI,GAAG,uBAAuB,CAAC,QAAQ;IAM1G,IAAI,IAAI,WAEP;IAED,KAAK;IAIL,aAAa,CAAC,OAAO,EAAE,MAAM;IAI7B,cAAc,CAAC,OAAO,EAAE,MAAM;CAGjC;AAED,qBAAa,aAAc,YAAW,gBAAgB,CAAC,KAAK,CAAC;;IACzD,QAAQ,CAAC,UAAU,SAAS;IAC5B,QAAQ,CAAC,qBAAqB,SAAS;IACvC,QAAQ,CAAC,IAAI,mBAAmB;gBAKpB,MAAM,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM;IAMrE,IAAI,cAAc,WAEjB;IAED,IAAI,CAAC,IAAI,EAAE,KAAK;IAIhB,IAAI,IAAI,WAEP;IAED,IAAI,cAAc,IAAI,gBAAgB,CAErC;IAEK,KAAK;CAGd"}
+{"version":3,"file":"UdpInterface.d.ts","sourceRoot":"","sources":["../../../../src/net/udp/UdpInterface.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,OAAO,EAAE,WAAW,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AACzE,OAAO,EAAE,uBAAuB,EAAE,MAAM,iCAAiC,CAAC;AAC1E,OAAO,EAAE,OAAO,EAAgB,MAAM,iBAAiB,CAAC;AACxD,OAAO,EAAE,KAAK,EAAE,MAAM,gBAAgB,CAAC;AACvC,OAAO,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAC5C,OAAO,EAAE,aAAa,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AACtE,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAE7C,qBAAa,YAAa,YAAW,uBAAuB;;WAG3C,MAAM,CAAC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,EAAE,YAAY,CAAC,EAAE,MAAM;gBAMpG,MAAM,EAAE,UAAU;IAI9B,SAAS,KAAK,MAAM,eAEnB;IAED,QAAQ,CAAC,IAAI,EAAE,WAAW,EAAE,OAAO,EAAE,MAAM;IAIrC,WAAW,CAAC,OAAO,EAAE,aAAa;IAQxC,MAAM,CAAC,QAAQ,EAAE,CAAC,OAAO,EAAE,OAAO,CAAC,KAAK,CAAC,EAAE,YAAY,EAAE,KAAK,KAAK,IAAI,GAAG,uBAAuB,CAAC,QAAQ;IAM1G,IAAI,IAAI,WAEP;IAED,KAAK;IAIL,aAAa,CAAC,OAAO,EAAE,MAAM;IAI7B,cAAc,CAAC,OAAO,EAAE,MAAM;CAGjC;AAED,qBAAa,aAAc,YAAW,gBAAgB,CAAC,KAAK,CAAC;;IACzD,QAAQ,CAAC,UAAU,SAAS;IAC5B,QAAQ,CAAC,qBAAqB,SAAS;IACvC,QAAQ,CAAC,IAAI,mBAAmB;IAIhC,QAAQ,CAAC,qBAAqB,uCAAoC;gBAEtD,MAAM,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM;IAMrE,IAAI,cAAc,WAEjB;IAED,IAAI,CAAC,IAAI,EAAE,KAAK;IAIhB,IAAI,IAAI,WAEP;IAED,IAAI,cAAc,IAAI,gBAAgB,CAErC;IAEK,KAAK;CAGd"}

package/dist/cjs/net/udp/UdpInterface.js

@@ -24,6 +24,7 @@ __export(UdpInterface_exports, {
 module.exports = __toCommonJS(UdpInterface_exports);
 var import_Channel = require("#net/Channel.js");
 var import_Network = require("#net/Network.js");
+var import_util = require("#util/index.js");
 /**
  * @license
  * Copyright 2022-2026 Matter.js Authors
@@ -77,6 +78,8 @@ class UdpConnection {
   #server;
   #peerAddress;
   #peerPort;
+  networkAddressChanged = (0, import_util.Observable)();
+  // no change so will basically never emit
   constructor(server, peerAddress, peerPort) {
     this.#server = server;
     this.#peerAddress = peerAddress;
@@ -89,7 +92,7 @@ class UdpConnection {
     return this.#server.send(this.#peerAddress, this.#peerPort, data);
   }
   get name() {
-    return `${this.type}://[${this.#peerAddress}]:${this.#peerPort}`;
+    return `${this.type}://${this.#peerAddress.includes(":") ? `[${this.#peerAddress}]` : this.#peerAddress}:${this.#peerPort}`;
   }
   get networkAddress() {
     return { type: "udp", ip: this.#peerAddress, port: this.#peerPort };

package/dist/cjs/net/udp/UdpInterface.js.map

@@ -1,6 +1,6 @@
 {
   "version": 3,
   "sources": ["../../../../src/net/udp/UdpInterface.ts"],
-  "mappings": ";;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAMA,qBAAuD;AAEvD,qBAAsC;AARtC;AAAA;AAAA;AAAA;AAAA;AAaO,MAAM,aAAgD;AAAA,EAChD;AAAA,EAET,aAAa,OAAO,SAAkB,MAAuB,MAAe,MAAe,cAAuB;AAC9G,WAAO,IAAI;AAAA,MACP,MAAM,QAAQ,iBAAiB,EAAE,eAAe,MAAM,MAAM,cAAc,kBAAkB,KAAK,CAAC;AAAA,IACtG;AAAA,EACJ;AAAA,EAEA,YAAY,QAAoB;AAC5B,SAAK,UAAU;AAAA,EACnB;AAAA,EAEA,IAAc,SAAS;AACnB,WAAO,KAAK;AAAA,EAChB;AAAA,EAEA,SAAS,MAAmB,SAAiB;AACzC,WAAO,KAAK,QAAQ,SAAS,MAAM,OAAO;AAAA,EAC9C;AAAA,EAEA,MAAM,YAAY,SAAwB;AACtC,QAAI,QAAQ,SAAS,OAAO;AACxB,YAAM,IAAI,4BAAa,4BAA4B,QAAQ,IAAI,EAAE;AAAA,IACrE;AACA,UAAM,EAAE,IAAI,KAAK,IAAI;AACrB,WAAO,QAAQ,QAAQ,IAAI,cAAc,KAAK,SAAS,IAAI,IAAI,CAAC;AAAA,EACpE;AAAA,EAEA,OAAO,UAAoG;AACvG,WAAO,KAAK,QAAQ;AAAA,MAAO,CAAC,eAAe,UAAU,UAAU,SAC3D,SAAS,IAAI,cAAc,KAAK,SAAS,UAAU,QAAQ,GAAG,IAAI;AAAA,IACtE;AAAA,EACJ;AAAA,EAEA,IAAI,OAAO;AACP,WAAO,KAAK,QAAQ;AAAA,EACxB;AAAA,EAEA,QAAQ;AACJ,WAAO,KAAK,QAAQ,MAAM;AAAA,EAC9B;AAAA,EAEA,cAAc,SAAiB;AAC3B,WAAO,KAAK,QAAQ,cAAc,OAAO;AAAA,EAC7C;AAAA,EAEA,eAAe,SAAiB;AAC5B,WAAO,KAAK,QAAQ,eAAe,OAAO;AAAA,EAC9C;AACJ;AAEO,MAAM,cAAiD;AAAA,EACjD,aAAa;AAAA,EACb,wBAAwB;AAAA,EACxB,OAAO,2BAAY;AAAA,EACnB;AAAA,EACA;AAAA,EACA;AAAA,EAET,YAAY,QAAoB,aAAqB,UAAkB;AACnE,SAAK,UAAU;AACf,SAAK,eAAe;AACpB,SAAK,YAAY;AAAA,EACrB;AAAA,EAEA,IAAI,iBAAiB;AACjB,WAAO,KAAK,QAAQ;AAAA,EACxB;AAAA,EAEA,KAAK,MAAa;AACd,WAAO,KAAK,QAAQ,KAAK,KAAK,cAAc,KAAK,WAAW,IAAI;AAAA,EACpE;AAAA,EAEA,IAAI,OAAO;AACP,WAAO,GAAG,KAAK,IAAI,OAAO,KAAK,YAAY,KAAK,KAAK,SAAS;AAAA,EAClE;AAAA,EAEA,IAAI,iBAAmC;AACnC,WAAO,EAAE,MAAM,OAAO,IAAI,KAAK,cAAc,MAAM,KAAK,UAAU;AAAA,EACtE;AAAA,EAEA,MAAM,QAAQ;AAAA,EAEd;AACJ;",
+  "mappings": ";;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAMA,qBAAuD;AAEvD,qBAAsC;AAEtC,kBAA2B;AAV3B;AAAA;AAAA;AAAA;AAAA;AAcO,MAAM,aAAgD;AAAA,EAChD;AAAA,EAET,aAAa,OAAO,SAAkB,MAAuB,MAAe,MAAe,cAAuB;AAC9G,WAAO,IAAI;AAAA,MACP,MAAM,QAAQ,iBAAiB,EAAE,eAAe,MAAM,MAAM,cAAc,kBAAkB,KAAK,CAAC;AAAA,IACtG;AAAA,EACJ;AAAA,EAEA,YAAY,QAAoB;AAC5B,SAAK,UAAU;AAAA,EACnB;AAAA,EAEA,IAAc,SAAS;AACnB,WAAO,KAAK;AAAA,EAChB;AAAA,EAEA,SAAS,MAAmB,SAAiB;AACzC,WAAO,KAAK,QAAQ,SAAS,MAAM,OAAO;AAAA,EAC9C;AAAA,EAEA,MAAM,YAAY,SAAwB;AACtC,QAAI,QAAQ,SAAS,OAAO;AACxB,YAAM,IAAI,4BAAa,4BAA4B,QAAQ,IAAI,EAAE;AAAA,IACrE;AACA,UAAM,EAAE,IAAI,KAAK,IAAI;AACrB,WAAO,QAAQ,QAAQ,IAAI,cAAc,KAAK,SAAS,IAAI,IAAI,CAAC;AAAA,EACpE;AAAA,EAEA,OAAO,UAAoG;AACvG,WAAO,KAAK,QAAQ;AAAA,MAAO,CAAC,eAAe,UAAU,UAAU,SAC3D,SAAS,IAAI,cAAc,KAAK,SAAS,UAAU,QAAQ,GAAG,IAAI;AAAA,IACtE;AAAA,EACJ;AAAA,EAEA,IAAI,OAAO;AACP,WAAO,KAAK,QAAQ;AAAA,EACxB;AAAA,EAEA,QAAQ;AACJ,WAAO,KAAK,QAAQ,MAAM;AAAA,EAC9B;AAAA,EAEA,cAAc,SAAiB;AAC3B,WAAO,KAAK,QAAQ,cAAc,OAAO;AAAA,EAC7C;AAAA,EAEA,eAAe,SAAiB;AAC5B,WAAO,KAAK,QAAQ,eAAe,OAAO;AAAA,EAC9C;AACJ;AAEO,MAAM,cAAiD;AAAA,EACjD,aAAa;AAAA,EACb,wBAAwB;AAAA,EACxB,OAAO,2BAAY;AAAA,EACnB;AAAA,EACA;AAAA,EACA;AAAA,EACA,4BAAwB,wBAA+B;AAAA;AAAA,EAEhE,YAAY,QAAoB,aAAqB,UAAkB;AACnE,SAAK,UAAU;AACf,SAAK,eAAe;AACpB,SAAK,YAAY;AAAA,EACrB;AAAA,EAEA,IAAI,iBAAiB;AACjB,WAAO,KAAK,QAAQ;AAAA,EACxB;AAAA,EAEA,KAAK,MAAa;AACd,WAAO,KAAK,QAAQ,KAAK,KAAK,cAAc,KAAK,WAAW,IAAI;AAAA,EACpE;AAAA,EAEA,IAAI,OAAO;AACP,WAAO,GAAG,KAAK,IAAI,MAAM,KAAK,aAAa,SAAS,GAAG,IAAI,IAAI,KAAK,YAAY,MAAM,KAAK,YAAY,IAAI,KAAK,SAAS;AAAA,EAC7H;AAAA,EAEA,IAAI,iBAAmC;AACnC,WAAO,EAAE,MAAM,OAAO,IAAI,KAAK,cAAc,MAAM,KAAK,UAAU;AAAA,EACtE;AAAA,EAEA,MAAM,QAAQ;AAAA,EAEd;AACJ;",
   "names": []
 }

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

@@ -4,6 +4,7 @@
  * SPDX-License-Identifier: Apache-2.0
  */
 import { ServerAddressUdp } from "#net/ServerAddress.js";
+import { Observable } from "#util/index.js";
 export declare enum ChannelType {
     UDP = "udp",
     BLE = "ble",
@@ -26,6 +27,15 @@ export interface Channel<T> {
 }
 export interface IpNetworkChannel<T> extends Channel<T> {
     networkAddress: ServerAddressUdp;
+    networkAddressChanged: Observable<[ServerAddressUdp]>;
 }
+/**
+ * Returns true (and guards types) if the channel is an IP channel
+ */
 export declare function isIpNetworkChannel<T>(channel?: Channel<T>): channel is IpNetworkChannel<T>;
+/**
+ * Checks if two IPNetworkChannels are referencing the same address.
+ * Both the channel type (UDP/TCP) and the address (including port) need to match.
+ */
+export declare function sameIpNetworkChannel<T>(channel1: IpNetworkChannel<T>, channel2: IpNetworkChannel<T>): boolean;
 //# sourceMappingURL=Channel.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"Channel.d.ts","sourceRoot":"","sources":["../../../src/net/Channel.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAGzD,oBAAY,WAAW;IACnB,GAAG,QAAQ;IACX,GAAG,QAAQ;IACX,GAAG,QAAQ;CACd;AAED,MAAM,WAAW,OAAO,CAAC,CAAC;IACtB,4CAA4C;IAC5C,cAAc,EAAE,MAAM,CAAC;IAEvB,8DAA8D;IAC9D,UAAU,EAAE,OAAO,CAAC;IAEpB,+CAA+C;IAC/C,qBAAqB,EAAE,OAAO,CAAC;IAE/B,mBAAmB;IACnB,IAAI,EAAE,MAAM,CAAC;IAEb,IAAI,EAAE,WAAW,CAAC;IAElB,iDAAiD;IACjD,IAAI,CAAC,IAAI,EAAE,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAE7B,kCAAkC;IAClC,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CAC1B;AAED,MAAM,WAAW,gBAAgB,CAAC,CAAC,CAAE,SAAQ,OAAO,CAAC,CAAC,CAAC;IACnD,cAAc,EAAE,gBAAgB,CAAC;CACpC;AAED,wBAAgB,kBAAkB,CAAC,CAAC,EAAE,OAAO,CAAC,EAAE,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,IAAI,gBAAgB,CAAC,CAAC,CAAC,CAE1F"}
+{"version":3,"file":"Channel.d.ts","sourceRoot":"","sources":["../../../src/net/Channel.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAEzD,OAAO,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAE5C,oBAAY,WAAW;IACnB,GAAG,QAAQ;IACX,GAAG,QAAQ;IACX,GAAG,QAAQ;CACd;AAED,MAAM,WAAW,OAAO,CAAC,CAAC;IACtB,4CAA4C;IAC5C,cAAc,EAAE,MAAM,CAAC;IAEvB,8DAA8D;IAC9D,UAAU,EAAE,OAAO,CAAC;IAEpB,+CAA+C;IAC/C,qBAAqB,EAAE,OAAO,CAAC;IAE/B,mBAAmB;IACnB,IAAI,EAAE,MAAM,CAAC;IAEb,IAAI,EAAE,WAAW,CAAC;IAElB,iDAAiD;IACjD,IAAI,CAAC,IAAI,EAAE,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAE7B,kCAAkC;IAClC,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CAC1B;AAGD,MAAM,WAAW,gBAAgB,CAAC,CAAC,CAAE,SAAQ,OAAO,CAAC,CAAC,CAAC;IACnD,cAAc,EAAE,gBAAgB,CAAC;IACjC,qBAAqB,EAAE,UAAU,CAAC,CAAC,gBAAgB,CAAC,CAAC,CAAC;CACzD;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,CAAC,EAAE,OAAO,CAAC,EAAE,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,IAAI,gBAAgB,CAAC,CAAC,CAAC,CAE1F;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,CAAC,EAAE,QAAQ,EAAE,gBAAgB,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,gBAAgB,CAAC,CAAC,CAAC,WAInG"}

package/dist/esm/net/Channel.js

@@ -13,8 +13,14 @@ var ChannelType = /* @__PURE__ */ ((ChannelType2) => {
 function isIpNetworkChannel(channel) {
   return isObject(channel?.networkAddress);
 }
+function sameIpNetworkChannel(channel1, channel2) {
+  const { networkAddress: addr1 } = channel1;
+  const { networkAddress: addr2 } = channel2;
+  return addr1.type === addr2.type && addr1.ip === addr2.ip && addr1.port === addr2.port;
+}
 export {
   ChannelType,
-  isIpNetworkChannel
+  isIpNetworkChannel,
+  sameIpNetworkChannel
 };
 //# sourceMappingURL=Channel.js.map

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

@@ -1,6 +1,6 @@
 {
   "version": 3,
   "sources": ["../../../src/net/Channel.ts"],
-  "mappings": "AAAA;AAAA;AAAA;AAAA;AAAA;AAMA,SAAS,gBAAgB;AAElB,IAAK,cAAL,kBAAKA,iBAAL;AACH,EAAAA,aAAA,SAAM;AACN,EAAAA,aAAA,SAAM;AACN,EAAAA,aAAA,SAAM;AAHE,SAAAA;AAAA,GAAA;AAgCL,SAAS,mBAAsB,SAAsD;AACxF,SAAO,SAAU,SAA6C,cAAc;AAChF;",
+  "mappings": "AAAA;AAAA;AAAA;AAAA;AAAA;AAMA,SAAS,gBAAgB;AAGlB,IAAK,cAAL,kBAAKA,iBAAL;AACH,EAAAA,aAAA,SAAM;AACN,EAAAA,aAAA,SAAM;AACN,EAAAA,aAAA,SAAM;AAHE,SAAAA;AAAA,GAAA;AAqCL,SAAS,mBAAsB,SAAsD;AACxF,SAAO,SAAU,SAA6C,cAAc;AAChF;AAMO,SAAS,qBAAwB,UAA+B,UAA+B;AAClG,QAAM,EAAE,gBAAgB,MAAM,IAAI;AAClC,QAAM,EAAE,gBAAgB,MAAM,IAAI;AAClC,SAAO,MAAM,SAAS,MAAM,QAAQ,MAAM,OAAO,MAAM,MAAM,MAAM,SAAS,MAAM;AACtF;",
   "names": ["ChannelType"]
 }

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

@@ -1 +1 @@
-{"version":3,"file":"ServerAddress.d.ts","sourceRoot":"","sources":["../../../src/net/ServerAddress.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAChD,OAAO,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAC7C,OAAO,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAE/C,MAAM,WAAW,eAAe;IAC5B;;OAEG;IACH,YAAY,EAAE,SAAS,CAAC;IAExB;;OAEG;IACH,GAAG,EAAE,QAAQ,CAAC;CACjB;AAED,MAAM,WAAW,aAAc,SAAQ,OAAO,CAAC,eAAe,CAAC;IAC3D;;OAEG;IACH,SAAS,CAAC,EAAE,SAAS,CAAC;IAEtB;;OAEG;IACH,WAAW,CAAC,EAAE,SAAS,CAAC;IAExB;;OAEG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAElB;;OAEG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,MAAM,gBAAgB,GAAG;IAC3B,IAAI,EAAE,KAAK,CAAC;IACZ,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;CAChB,GAAG,aAAa,CAAC;AAElB,MAAM,MAAM,gBAAgB,GAAG;IAC3B,IAAI,EAAE,KAAK,CAAC;IACZ,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;CAChB,GAAG,aAAa,CAAC;AAElB,MAAM,MAAM,gBAAgB,GAAG;IAC3B,IAAI,EAAE,KAAK,CAAC;IACZ,iBAAiB,EAAE,MAAM,CAAC;CAC7B,GAAG,aAAa,CAAC;AAElB,MAAM,MAAM,aAAa,GAAG,gBAAgB,GAAG,gBAAgB,GAAG,gBAAgB,CAAC;AAEnF,wBAAgB,aAAa,CAAC,UAAU,EAAE,aAAa,GAS9C,aAAa,CACrB;AAED,yBAAiB,aAAa,CAAC;IAC3B,SAAgB,MAAM,CAAC,OAAO,EAAE,aAAa,GAAG,MAAM,CAYrD;IAED,SAAgB,aAAa,CAAC,OAAO,EAAE,aAAa,cAuBnD;IAED,SAAgB,OAAO,CAAC,CAAC,EAAE,aAAa,EAAE,CAAC,EAAE,aAAa,GAAG,OAAO,CAcnE;IAED;;;;;OAKG;IACH,SAAgB,QAAQ,CAAC,MAAM,EAAE,aAAa,GAAG,aAAa,CAY7D;IAED;;;;OAIG;IACH,KAAY,mBAAmB;QAC3B,QAAQ,IAAA;QACR,eAAe,IAAA;QACf,IAAI,IAAA;QACJ,IAAI,IAAA;QACJ,MAAM,IAAI;KACb;IAED,SAAgB,qBAAqB,CAAC,OAAO,EAAE,aAAa,uBAkB3D;CACJ"}
+{"version":3,"file":"ServerAddress.d.ts","sourceRoot":"","sources":["../../../src/net/ServerAddress.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAChD,OAAO,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAC7C,OAAO,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAE/C,MAAM,WAAW,eAAe;IAC5B;;OAEG;IACH,YAAY,EAAE,SAAS,CAAC;IAExB;;OAEG;IACH,GAAG,EAAE,QAAQ,CAAC;CACjB;AAED,MAAM,WAAW,aAAc,SAAQ,OAAO,CAAC,eAAe,CAAC;IAC3D;;OAEG;IACH,SAAS,CAAC,EAAE,SAAS,CAAC;IAEtB;;OAEG;IACH,WAAW,CAAC,EAAE,SAAS,CAAC;IAExB;;OAEG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAElB;;OAEG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,MAAM,gBAAgB,GAAG;IAC3B,IAAI,EAAE,KAAK,CAAC;IACZ,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;CAChB,GAAG,aAAa,CAAC;AAElB,MAAM,MAAM,gBAAgB,GAAG;IAC3B,IAAI,EAAE,KAAK,CAAC;IACZ,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;CAChB,GAAG,aAAa,CAAC;AAElB,MAAM,MAAM,gBAAgB,GAAG;IAC3B,IAAI,EAAE,KAAK,CAAC;IACZ,iBAAiB,EAAE,MAAM,CAAC;CAC7B,GAAG,aAAa,CAAC;AAElB,MAAM,MAAM,aAAa,GAAG,gBAAgB,GAAG,gBAAgB,GAAG,gBAAgB,CAAC;AAEnF,wBAAgB,aAAa,CAAC,UAAU,EAAE,aAAa,GAS9C,aAAa,CACrB;AAED,yBAAiB,aAAa,CAAC;IAC3B,SAAgB,MAAM,CAAC,OAAO,EAAE,aAAa,GAAG,MAAM,CAarD;IAED,SAAgB,aAAa,CAAC,OAAO,EAAE,aAAa,cAuBnD;IAED,SAAgB,OAAO,CAAC,CAAC,EAAE,aAAa,EAAE,CAAC,EAAE,aAAa,GAAG,OAAO,CAcnE;IAED;;;;;OAKG;IACH,SAAgB,QAAQ,CAAC,MAAM,EAAE,aAAa,GAAG,aAAa,CAY7D;IAED;;;;OAIG;IACH,KAAY,mBAAmB;QAC3B,QAAQ,IAAA;QACR,eAAe,IAAA;QACf,IAAI,IAAA;QACJ,IAAI,IAAA;QACJ,MAAM,IAAI;KACb;IAED,SAAgB,qBAAqB,CAAC,OAAO,EAAE,aAAa,uBAkB3D;CACJ"}

package/dist/esm/net/ServerAddress.js

@@ -21,7 +21,8 @@ function ServerAddress(definition) {
     switch (address.type) {
       case "udp":
       case "tcp":
-        return `${address.type}://${address.ip}:${address.port}`;
+        const ip = address.ip;
+        return `${address.type}://${ip.includes(":") ? `[${ip}]` : ip}:${address.port}`;
       case "ble":
         return `ble://${address.peripheralAddress}`;
       default:

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;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;",
+  "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,cAAM,KAAK,QAAQ;AACnB,eAAO,GAAG,QAAQ,IAAI,MAAM,GAAG,SAAS,GAAG,IAAI,IAAI,EAAE,MAAM,EAAE,IAAI,QAAQ,IAAI;AAAA,MAEjF,KAAK;AACD,eAAO,SAAS,QAAQ,iBAAiB;AAAA,MAE7C;AACI,eAAO,GAAI,QAAgB,IAAI;AAAA,IACvC;AAAA,EACJ;AAbO,EAAAA,eAAS;AAeT,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,GA1FH;",
   "names": ["ServerAddress", "SelectionPreference"]
 }

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

@@ -0,0 +1,56 @@
+/**
+ * @license
+ * Copyright 2022-2026 Matter.js Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { DnsRecord, DnsRecordType, SrvRecordValue } from "#codec/DnsCodec.js";
+import type { Timestamp } from "#time/Timestamp.js";
+import { AsyncObserver, BasicObservable } from "#util/Observable.js";
+import { MaybePromise } from "#util/Promises.js";
+/**
+ * Manages records associated with a single DNS-SD qname.
+ *
+ * Every DNS-SD qname of interest has a 1:1 relationship with a single instance of this class in the context of a
+ * {@link DnssdNames}.  We therefore can use the qname or {@link DnssdName} interchangeably.
+ *
+ * An {@link DnssdName} is created when a new name is discovered or requested by another component.  The name
+ * automatically deletes when there are no longer observers or unexpired records.
+ */
+export declare class DnssdName extends BasicObservable<[changes: DnssdName.Changes], MaybePromise> {
+    #private;
+    readonly qname: string;
+    constructor(qname: string, context: DnssdName.Context);
+    off(observer: AsyncObserver<[]>): void;
+    close(): Promise<void>;
+    get records(): MapIterator<DnssdName.Record>;
+    get parameters(): Map<string, string>;
+    get isDiscovered(): boolean;
+    installRecord(record: DnsRecord<any>): false | undefined;
+    deleteRecord(record: DnsRecord, ifOlderThan?: Timestamp): void;
+}
+export declare namespace DnssdName {
+    interface Context {
+        delete(name: DnssdName): void;
+        registerForExpiration(record: Record): void;
+        unregisterForExpiration(record: Record): void;
+    }
+    interface Expiration {
+        expiresAt: Timestamp;
+    }
+    interface PointerRecord extends DnsRecord<string>, Expiration {
+        recordType: DnsRecordType.PTR;
+    }
+    interface HostRecord extends DnsRecord<string>, Expiration {
+        recordType: DnsRecordType.A | DnsRecordType.AAAA;
+    }
+    interface ServiceRecord extends DnsRecord<SrvRecordValue>, Expiration {
+        recordType: DnsRecordType.SRV;
+    }
+    type Record = PointerRecord | ServiceRecord | HostRecord;
+    interface Changes {
+        name: DnssdName;
+        updated?: Record[];
+        deleted?: Record[];
+    }
+}
+//# sourceMappingURL=DnssdName.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"DnssdName.d.ts","sourceRoot":"","sources":["../../../../src/net/dns-sd/DnssdName.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,SAAS,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAG9E,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AACpD,OAAO,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AACrE,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAKjD;;;;;;;;GAQG;AACH,qBAAa,SAAU,SAAQ,eAAe,CAAC,CAAC,OAAO,EAAE,SAAS,CAAC,OAAO,CAAC,EAAE,YAAY,CAAC;;IAUlF,QAAQ,CAAC,KAAK,EAAE,MAAM;gBAAb,KAAK,EAAE,MAAM,EACtB,OAAO,EAAE,SAAS,CAAC,OAAO;IAMrB,GAAG,CAAC,QAAQ,EAAE,aAAa,CAAC,EAAE,CAAC;IAKlC,KAAK;IASX,IAAI,OAAO,kCAEV;IAED,IAAI,UAAU,wBAKb;IAED,IAAI,YAAY,YAEf;IAED,aAAa,CAAC,MAAM,EAAE,SAAS,CAAC,GAAG,CAAC;IAoCpC,YAAY,CAAC,MAAM,EAAE,SAAS,EAAE,WAAW,CAAC,EAAE,SAAS;CA6F1D;AAqBD,yBAAiB,SAAS,CAAC;IACvB,UAAiB,OAAO;QACpB,MAAM,CAAC,IAAI,EAAE,SAAS,GAAG,IAAI,CAAC;QAC9B,qBAAqB,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;QAC5C,uBAAuB,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;KACjD;IAED,UAAiB,UAAU;QACvB,SAAS,EAAE,SAAS,CAAC;KACxB;IAED,UAAiB,aAAc,SAAQ,SAAS,CAAC,MAAM,CAAC,EAAE,UAAU;QAChE,UAAU,EAAE,aAAa,CAAC,GAAG,CAAC;KACjC;IAED,UAAiB,UAAW,SAAQ,SAAS,CAAC,MAAM,CAAC,EAAE,UAAU;QAC7D,UAAU,EAAE,aAAa,CAAC,CAAC,GAAG,aAAa,CAAC,IAAI,CAAC;KACpD;IAED,UAAiB,aAAc,SAAQ,SAAS,CAAC,cAAc,CAAC,EAAE,UAAU;QACxE,UAAU,EAAE,aAAa,CAAC,GAAG,CAAC;KACjC;IAED,KAAY,MAAM,GAAG,aAAa,GAAG,aAAa,GAAG,UAAU,CAAC;IAEhE,UAAiB,OAAO;QACpB,IAAI,EAAE,SAAS,CAAC;QAChB,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;QACnB,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;KACtB;CACJ"}

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

@@ -0,0 +1,173 @@
+/**
+ * @license
+ * Copyright 2022-2026 Matter.js Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { DnsRecordType } from "#codec/DnsCodec.js";
+import { Logger } from "#log/Logger.js";
+import { Time } from "#time/Time.js";
+import { BasicObservable } from "#util/Observable.js";
+const logger = Logger.get("DnssdName");
+class DnssdName extends BasicObservable {
+  constructor(qname, context) {
+    super((e) => logger.error(`Unhandled error in observer for DNS name "${qname}":`, e));
+    this.qname = qname;
+    this.#context = context;
+  }
+  #context;
+  #records = /* @__PURE__ */ new Map();
+  #recordCount = 0;
+  #changes;
+  #notified;
+  #maybeDeleting;
+  #parameters;
+  off(observer) {
+    super.off(observer);
+    this.#deleteIfUnused();
+  }
+  async close() {
+    if (this.#notified) {
+      await this.#notified;
+    }
+    if (this.#maybeDeleting) {
+      await this.#maybeDeleting;
+    }
+  }
+  get records() {
+    return this.#records.values();
+  }
+  get parameters() {
+    if (this.#parameters === void 0) {
+      this.#parameters = /* @__PURE__ */ new Map();
+    }
+    return this.#parameters;
+  }
+  get isDiscovered() {
+    return !!this.#recordCount;
+  }
+  installRecord(record) {
+    if (record.recordType === DnsRecordType.TXT) {
+      const entries = record.value;
+      for (const entry of entries) {
+        const pos = entry.indexOf("=");
+        if (pos === -1) {
+          this.parameters.set(entry, "");
+        } else {
+          this.parameters.set(entry.slice(0, pos), entry.slice(pos + 1));
+        }
+      }
+    }
+    const key = keyOf(record);
+    if (key === void 0) {
+      this.#deleteIfUnused();
+      return false;
+    }
+    const oldRecord = this.#records.get(key);
+    if (oldRecord) {
+      this.#context.unregisterForExpiration(oldRecord);
+    } else {
+      this.#recordCount++;
+    }
+    const recordWithExpire = { ...record, expiresAt: Time.nowMs + record.ttl };
+    this.#records.set(key, recordWithExpire);
+    this.#context.registerForExpiration(recordWithExpire);
+    this.#notify("update", key, recordWithExpire);
+  }
+  deleteRecord(record, ifOlderThan) {
+    const key = keyOf(record);
+    if (key === void 0) {
+      this.#deleteIfUnused();
+      return;
+    }
+    const recordWithExpire = this.#records?.get(key);
+    if (!recordWithExpire) {
+      this.#deleteIfUnused();
+      return;
+    }
+    if (ifOlderThan !== void 0 && recordWithExpire.expiresAt - recordWithExpire.ttl >= ifOlderThan) {
+      return;
+    }
+    this.#records.delete(key);
+    this.#recordCount--;
+    this.#context.unregisterForExpiration(recordWithExpire);
+    if (this.#deleteIfUnused()) {
+      return;
+    }
+    this.#notify("delete", key, recordWithExpire);
+  }
+  /**
+   * Delete if unused.
+   *
+   * This is async so we assess whether deletion is appropriate after a batch of updates.
+   */
+  #deleteIfUnused() {
+    if (this.isObserved || this.isDiscovered) {
+      return false;
+    }
+    if (this.#maybeDeleting) {
+      return true;
+    }
+    const maybeDelete = async () => {
+      this.#maybeDeleting = void 0;
+      if (this.isObserved || this.isDiscovered) {
+        return;
+      }
+      this.#context.delete(this);
+    };
+    this.#maybeDeleting = maybeDelete();
+    return true;
+  }
+  /**
+   * Notification of observers.
+   *
+   * This is async so we coalesce changes into a single notification.
+   */
+  #notify(kind, key, record) {
+    if (this.#changes === void 0) {
+      this.#changes = /* @__PURE__ */ new Map();
+    }
+    this.#changes.set(key, { kind, record });
+    if (this.#notified) {
+      return;
+    }
+    const notify = async () => {
+      while (this.#changes?.size) {
+        const changes = { name: this };
+        for (const { kind: kind2, record: record2 } of this.#changes.values()) {
+          const key2 = `${kind2}d`;
+          const list = changes[key2];
+          if (list === void 0) {
+            changes[key2] = [record2];
+          } else {
+            list.push(record2);
+          }
+        }
+        this.#changes.clear();
+        await this.emit(changes);
+      }
+      this.#notified = void 0;
+    };
+    this.#notified = notify();
+  }
+}
+function keyOf(record) {
+  switch (record.recordType) {
+    case DnsRecordType.A:
+    case DnsRecordType.AAAA:
+    case DnsRecordType.PTR:
+      if (typeof record.value === "string") {
+        return `${record.recordType} ${record.value}`;
+      }
+      break;
+    case DnsRecordType.SRV:
+      if (typeof record.value === "object") {
+        const srv = record.value;
+        return `${record.recordType} ${srv.target}:${srv.port}`;
+      }
+      break;
+  }
+}
+export {
+  DnssdName
+};
+//# sourceMappingURL=DnssdName.js.map