@matter/general 0.16.8-alpha.0-20260123-dff2cae52 → 0.16.8-alpha.0-20260127-65e1b40e2

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

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"}