@matter/protocol 0.11.0-alpha.0-20241005-e3e4e4a7a

package/dist/esm/mdns/MdnsBroadcaster.js

@@ -0,0 +1,351 @@
+/**
+ * @license
+ * Copyright 2022-2024 Matter.js Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import {
+  AAAARecord,
+  ARecord,
+  BasicSet,
+  Bytes,
+  Crypto,
+  Diagnostic,
+  ImplementationError,
+  Logger,
+  PtrRecord,
+  SrvRecord,
+  TxtRecord,
+  isIPv4,
+  isIPv6
+} from "#general";
+import { NodeId } from "#types";
+import {
+  PairingHintBitmapSchema
+} from "../common/InstanceBroadcaster.js";
+import {
+  SESSION_ACTIVE_INTERVAL_MS,
+  SESSION_ACTIVE_THRESHOLD_MS,
+  SESSION_IDLE_INTERVAL_MS
+} from "../session/Session.js";
+import {
+  MATTER_COMMISSIONER_SERVICE_QNAME,
+  MATTER_COMMISSION_SERVICE_QNAME,
+  MATTER_SERVICE_QNAME,
+  SERVICE_DISCOVERY_QNAME,
+  getCommissioningModeQname,
+  getDeviceInstanceQname,
+  getDeviceMatterQname,
+  getDeviceTypeQname,
+  getFabricQname,
+  getLongDiscriminatorQname,
+  getShortDiscriminatorQname,
+  getVendorQname
+} from "./MdnsConsts.js";
+import { MdnsInstanceBroadcaster } from "./MdnsInstanceBroadcaster.js";
+import { AnnouncementType, MdnsServer } from "./MdnsServer.js";
+const logger = Logger.get("MdnsBroadcaster");
+const DEFAULT_PAIRING_HINT = {
+  powerCycle: true,
+  deviceManual: true
+};
+class MdnsBroadcaster {
+  #activeCommissioningAnnouncements = /* @__PURE__ */ new Set();
+  #activeOperationalAnnouncements = /* @__PURE__ */ new Map();
+  #network;
+  #mdnsServer;
+  #enableIpv4;
+  #instances = new BasicSet();
+  static async create(network, options) {
+    const { enableIpv4, multicastInterface } = options ?? {};
+    return new MdnsBroadcaster(
+      network,
+      await MdnsServer.create(network, { enableIpv4, netInterface: multicastInterface }),
+      enableIpv4
+    );
+  }
+  constructor(network, mdnsServer, enableIpv4) {
+    this.#network = network;
+    this.#mdnsServer = mdnsServer;
+    this.#enableIpv4 = enableIpv4;
+  }
+  createInstanceBroadcaster(port) {
+    const instance = new MdnsInstanceBroadcaster(port, this, () => {
+      this.#instances.delete(instance);
+    });
+    this.#instances.add(instance);
+    return instance;
+  }
+  #validateCommissioningData(data) {
+    const { sessionIdleInterval, sessionActiveInterval, sessionActiveThreshold } = data;
+    if (sessionIdleInterval !== void 0 && sessionIdleInterval > 36e5) {
+      throw new ImplementationError("Session Idle Interval must be less than 1 hour");
+    }
+    if (sessionActiveInterval !== void 0 && sessionActiveInterval > 36e5) {
+      throw new ImplementationError("Session Active Interval must be less than 1 hour");
+    }
+    if (sessionActiveThreshold !== void 0 && sessionActiveThreshold > 65535) {
+      throw new ImplementationError("Session Active Threshold must be less than 65535 seconds");
+    }
+  }
+  #validatePairingInstructions(pairingHint, pairingInstructions) {
+    const needsInstructions = [
+      "customInstruction",
+      "pressRestButtonForNumberOfSeconds",
+      "pressResetButtonUntilLightBlinks",
+      "pressResetButtonForNumberOfSecondsWithApplicationOfPower",
+      "pressResetButtonUntilLightBlinksWithApplicationOfPower",
+      "pressResetButtonNumberOfTimes",
+      "pressSetupButtonForNumberOfSeconds",
+      "pressSetupButtonUntilLightBlinks",
+      "pressSetupButtonForNumberOfSecondsWithApplicationOfPower",
+      "pressSetupButtonUntilLightBlinksWithApplicationOfPower",
+      "pressSetupButtonNumberOfTimes"
+    ].find((hint) => pairingHint[hint] === true);
+    if (needsInstructions && pairingInstructions.length === 0) {
+      throw new ImplementationError(
+        `Pairing instructions required for Pairing Hint of type "${needsInstructions}"`
+      );
+    }
+  }
+  #getIpRecords(hostname, ips) {
+    const records = new Array();
+    ips.forEach((ip) => {
+      if (isIPv6(ip)) {
+        records.push(AAAARecord(hostname, ip));
+      } else if (isIPv4(ip)) {
+        if (this.#enableIpv4) {
+          records.push(ARecord(hostname, ip));
+        }
+      } else {
+        logger.warn(`Unknown IP address type: ${ip}`);
+      }
+    });
+    return records;
+  }
+  /** Set the Broadcaster data to announce a device ready for commissioning in a special mode */
+  async setCommissionMode(announcedNetPort, mode, commissioningModeData) {
+    this.#validateCommissioningData(commissioningModeData);
+    const {
+      name: deviceName,
+      deviceType,
+      vendorId,
+      productId,
+      discriminator,
+      sessionIdleInterval = SESSION_IDLE_INTERVAL_MS,
+      sessionActiveInterval = SESSION_ACTIVE_INTERVAL_MS,
+      sessionActiveThreshold = SESSION_ACTIVE_THRESHOLD_MS,
+      pairingHint = DEFAULT_PAIRING_HINT,
+      pairingInstructions = ""
+    } = commissioningModeData;
+    this.#validatePairingInstructions(pairingHint, pairingInstructions);
+    await this.expireCommissioningAnnouncement(announcedNetPort);
+    logger.debug(
+      `Announce commissioning mode ${mode} ${deviceName} ${deviceType} ${vendorId} ${productId} ${discriminator} ${announcedNetPort}`
+    );
+    this.#activeCommissioningAnnouncements.add(announcedNetPort);
+    const shortDiscriminator = discriminator >> 8 & 15;
+    const instanceId = Bytes.toHex(Crypto.getRandomData(8)).toUpperCase();
+    const vendorQname = getVendorQname(vendorId);
+    const deviceTypeQname = getDeviceTypeQname(deviceType);
+    const shortDiscriminatorQname = getShortDiscriminatorQname(shortDiscriminator);
+    const longDiscriminatorQname = getLongDiscriminatorQname(discriminator);
+    const commissionModeQname = getCommissioningModeQname();
+    const deviceQname = getDeviceInstanceQname(instanceId);
+    await this.#mdnsServer.setRecordsGenerator(
+      announcedNetPort,
+      AnnouncementType.Commissionable,
+      async (netInterface) => {
+        const ipMac = await this.#network.getIpMac(netInterface);
+        if (ipMac === void 0) return [];
+        const { mac, ipV4, ipV6 } = ipMac;
+        const hostname = mac.replace(/:/g, "").toUpperCase() + "0000.local";
+        logger.debug(
+          "Announcement Generator: Commission mode ",
+          Diagnostic.dict({
+            mode,
+            qname: deviceQname,
+            port: announcedNetPort,
+            interface: netInterface
+          })
+        );
+        const records = [
+          PtrRecord(SERVICE_DISCOVERY_QNAME, MATTER_COMMISSION_SERVICE_QNAME),
+          PtrRecord(SERVICE_DISCOVERY_QNAME, vendorQname),
+          PtrRecord(SERVICE_DISCOVERY_QNAME, deviceTypeQname),
+          PtrRecord(SERVICE_DISCOVERY_QNAME, shortDiscriminatorQname),
+          PtrRecord(SERVICE_DISCOVERY_QNAME, longDiscriminatorQname),
+          PtrRecord(SERVICE_DISCOVERY_QNAME, commissionModeQname),
+          PtrRecord(MATTER_COMMISSION_SERVICE_QNAME, deviceQname),
+          PtrRecord(vendorQname, deviceQname),
+          PtrRecord(deviceTypeQname, deviceQname),
+          PtrRecord(shortDiscriminatorQname, deviceQname),
+          PtrRecord(longDiscriminatorQname, deviceQname),
+          PtrRecord(commissionModeQname, deviceQname),
+          SrvRecord(deviceQname, { priority: 0, weight: 0, port: announcedNetPort, target: hostname }),
+          TxtRecord(deviceQname, [
+            `VP=${vendorId}+${productId}`,
+            `DT=${deviceType}`,
+            `DN=${deviceName}`,
+            `SII=${sessionIdleInterval}`,
+            `SAI=${sessionActiveInterval}`,
+            `SAT=${sessionActiveThreshold}`,
+            //`T=${TCP_SUPPORTED}` /* TCP not supported */,
+            `D=${discriminator}`,
+            `CM=${mode}`,
+            `PH=${PairingHintBitmapSchema.encode(pairingHint)}`,
+            `PI=${pairingInstructions}`
+            //`ICD=${ICD_SUPPORTED}` /* ICD not supported */,
+          ])
+        ];
+        records.push(...this.#getIpRecords(hostname, [...ipV6, ...ipV4]));
+        return records;
+      }
+    );
+  }
+  /** Set the Broadcaster Data to announce a device for operative discovery (aka "already paired") */
+  async setFabrics(announcedNetPort, fabrics, {
+    sessionIdleInterval = SESSION_IDLE_INTERVAL_MS,
+    sessionActiveInterval = SESSION_ACTIVE_INTERVAL_MS,
+    sessionActiveThreshold = SESSION_ACTIVE_THRESHOLD_MS
+  } = {}) {
+    const currentOperationalFabrics = this.#activeOperationalAnnouncements.get(announcedNetPort);
+    if (currentOperationalFabrics !== void 0) {
+      const fabricIndexesSet = new Set(fabrics.map((f) => f.fabricIndex));
+      if (!currentOperationalFabrics.every((fabricIndex) => fabricIndexesSet.has(fabricIndex))) {
+        await this.expireFabricAnnouncement(announcedNetPort);
+      }
+    }
+    this.#activeOperationalAnnouncements.set(
+      announcedNetPort,
+      fabrics.map((f) => f.fabricIndex)
+    );
+    await this.#mdnsServer.setRecordsGenerator(announcedNetPort, AnnouncementType.Operative, async (netInterface) => {
+      const ipMac = await this.#network.getIpMac(netInterface);
+      if (ipMac === void 0) return [];
+      const { mac, ipV4, ipV6 } = ipMac;
+      const hostname = mac.replace(/:/g, "").toUpperCase() + "0000.local";
+      const records = [PtrRecord(SERVICE_DISCOVERY_QNAME, MATTER_SERVICE_QNAME)];
+      fabrics.forEach((fabric) => {
+        const { operationalId, nodeId } = fabric;
+        const operationalIdString = Bytes.toHex(operationalId).toUpperCase();
+        const fabricQname = getFabricQname(operationalIdString);
+        const deviceMatterQname = getDeviceMatterQname(operationalIdString, NodeId.toHexString(nodeId));
+        logger.debug(
+          "Announcement Generator: Fabric",
+          Diagnostic.dict({
+            id: `${Bytes.toHex(operationalId)}/${nodeId}`,
+            qname: deviceMatterQname,
+            port: announcedNetPort,
+            interface: netInterface
+          })
+        );
+        const fabricRecords = [
+          PtrRecord(SERVICE_DISCOVERY_QNAME, fabricQname),
+          PtrRecord(MATTER_SERVICE_QNAME, deviceMatterQname),
+          PtrRecord(fabricQname, deviceMatterQname),
+          SrvRecord(deviceMatterQname, { priority: 0, weight: 0, port: announcedNetPort, target: hostname }),
+          TxtRecord(deviceMatterQname, [
+            `SII=${sessionIdleInterval}`,
+            `SAI=${sessionActiveInterval}`,
+            `SAT=${sessionActiveThreshold}`
+            //`T=${TCP_SUPPORTED}` /* TCP not supported */,
+            //`ICD=${ICD_SUPPORTED}` /* ICD not supported */,
+          ])
+        ];
+        records.push(...fabricRecords);
+      });
+      records.push(...this.#getIpRecords(hostname, [...ipV6, ...ipV4]));
+      return records;
+    });
+  }
+  /** Set the Broadcaster data to announce a Commissioner (aka Commissioner discovery) */
+  async setCommissionerInfo(announcedNetPort, {
+    deviceName,
+    deviceType,
+    vendorId,
+    productId,
+    sessionIdleInterval = SESSION_IDLE_INTERVAL_MS,
+    sessionActiveInterval = SESSION_ACTIVE_INTERVAL_MS,
+    sessionActiveThreshold = SESSION_ACTIVE_THRESHOLD_MS
+  }) {
+    logger.debug(
+      "Announcement: Commissioner",
+      Diagnostic.dict({
+        port: announcedNetPort,
+        deviceType
+      })
+    );
+    const instanceId = Bytes.toHex(Crypto.getRandomData(8)).toUpperCase();
+    const deviceTypeQname = `_T${deviceType}._sub.${MATTER_COMMISSIONER_SERVICE_QNAME}`;
+    const vendorQname = `_V${vendorId}._sub.${MATTER_COMMISSIONER_SERVICE_QNAME}`;
+    const deviceQname = `${instanceId}.${MATTER_COMMISSIONER_SERVICE_QNAME}`;
+    this.#activeCommissioningAnnouncements.add(announcedNetPort);
+    await this.#mdnsServer.setRecordsGenerator(
+      announcedNetPort,
+      AnnouncementType.Commissionable,
+      async (netInterface) => {
+        const ipMac = await this.#network.getIpMac(netInterface);
+        if (ipMac === void 0) return [];
+        const { mac, ipV4, ipV6 } = ipMac;
+        const hostname = mac.replace(/:/g, "").toUpperCase() + "0000.local";
+        const records = [
+          PtrRecord(SERVICE_DISCOVERY_QNAME, MATTER_COMMISSIONER_SERVICE_QNAME),
+          PtrRecord(MATTER_COMMISSIONER_SERVICE_QNAME, vendorQname),
+          PtrRecord(vendorQname, deviceQname),
+          SrvRecord(deviceQname, { priority: 0, weight: 0, port: announcedNetPort, target: hostname }),
+          TxtRecord(deviceQname, [
+            `VP=${vendorId}+${productId}`,
+            `DT=${deviceType}`,
+            `DN=${deviceName}`,
+            `SII=${sessionIdleInterval}`,
+            `SAI=${sessionActiveInterval}`,
+            `SAT=${sessionActiveThreshold}`
+            //`T=${TCP_SUPPORTED}` /* TCP not supported */,
+            //`ICD=${ICD_SUPPORTED}` /* ICD not supported */,
+          ])
+        ];
+        if (deviceType !== void 0) {
+          records.push(PtrRecord(SERVICE_DISCOVERY_QNAME, deviceTypeQname));
+          records.push(PtrRecord(deviceTypeQname, deviceQname));
+        }
+        records.push(...this.#getIpRecords(hostname, [...ipV6, ...ipV4]));
+        return records;
+      }
+    );
+  }
+  async announce(announcementPort) {
+    this.#mdnsServer.announce(announcementPort).catch((error) => logger.error(error));
+  }
+  async expireFabricAnnouncement(announcementPort) {
+    if (this.#activeOperationalAnnouncements.has(announcementPort)) {
+      await this.#mdnsServer.expireAnnouncements(announcementPort, AnnouncementType.Operative);
+      this.#activeOperationalAnnouncements.delete(announcementPort);
+    }
+  }
+  async expireCommissioningAnnouncement(announcementPort) {
+    if (this.#activeCommissioningAnnouncements.has(announcementPort)) {
+      await this.#mdnsServer.expireAnnouncements(announcementPort, AnnouncementType.Commissionable);
+      this.#activeCommissioningAnnouncements.delete(announcementPort);
+    }
+  }
+  async expireAllAnnouncements(announcementPort) {
+    if (!this.#activeCommissioningAnnouncements.has(announcementPort) && !this.#activeOperationalAnnouncements.has(announcementPort))
+      return;
+    await this.#mdnsServer.expireAnnouncements(announcementPort);
+    this.#activeCommissioningAnnouncements.delete(announcementPort);
+    this.#activeOperationalAnnouncements.delete(announcementPort);
+  }
+  async close() {
+    while (this.#instances.size) {
+      await this.#instances.deleted;
+    }
+    await this.#mdnsServer.expireAnnouncements();
+    this.#activeCommissioningAnnouncements.clear();
+    this.#activeOperationalAnnouncements.clear();
+    await this.#mdnsServer.close();
+  }
+}
+export {
+  MdnsBroadcaster
+};
+//# sourceMappingURL=MdnsBroadcaster.js.map

package/dist/esm/mdns/MdnsBroadcaster.js.map

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

package/dist/esm/mdns/MdnsConsts.d.ts

@@ -0,0 +1,19 @@
+/**
+ * @license
+ * Copyright 2022-2024 Matter.js Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { VendorId } from "#types";
+export declare const SERVICE_DISCOVERY_QNAME = "_services._dns-sd._udp.local";
+export declare const MATTER_COMMISSION_SERVICE_QNAME = "_matterc._udp.local";
+export declare const MATTER_COMMISSIONER_SERVICE_QNAME = "_matterd._udp.local";
+export declare const MATTER_SERVICE_QNAME = "_matter._tcp.local";
+export declare const getFabricQname: (operationalIdString: string) => string;
+export declare const getDeviceMatterQname: (operationalIdString: string, nodeIdString: string) => string;
+export declare const getVendorQname: (vendorId: VendorId) => string;
+export declare const getDeviceTypeQname: (deviceType: number) => string;
+export declare const getShortDiscriminatorQname: (shortDiscriminator: number) => string;
+export declare const getLongDiscriminatorQname: (longDiscriminator: number) => string;
+export declare const getCommissioningModeQname: () => string;
+export declare const getDeviceInstanceQname: (instanceId: string) => string;
+//# sourceMappingURL=MdnsConsts.d.ts.map

package/dist/esm/mdns/MdnsConsts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"MdnsConsts.d.ts","sourceRoot":"","sources":["../../../src/mdns/MdnsConsts.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,QAAQ,EAAE,MAAM,QAAQ,CAAC;AAElC,eAAO,MAAM,uBAAuB,iCAAiC,CAAC;AACtE,eAAO,MAAM,+BAA+B,wBAAwB,CAAC;AACrE,eAAO,MAAM,iCAAiC,wBAAwB,CAAC;AACvE,eAAO,MAAM,oBAAoB,uBAAuB,CAAC;AAEzD,eAAO,MAAM,cAAc,wBAAyB,MAAM,WAA4D,CAAC;AACvH,eAAO,MAAM,oBAAoB,wBAAyB,MAAM,gBAAgB,MAAM,WAClB,CAAC;AACrE,eAAO,MAAM,cAAc,aAAc,QAAQ,WAA4D,CAAC;AAC9G,eAAO,MAAM,kBAAkB,eAAgB,MAAM,WAA8D,CAAC;AACpH,eAAO,MAAM,0BAA0B,uBAAwB,MAAM,WACA,CAAC;AACtE,eAAO,MAAM,yBAAyB,sBAAuB,MAAM,WACC,CAAC;AACrE,eAAO,MAAM,yBAAyB,cAAsD,CAAC;AAC7F,eAAO,MAAM,sBAAsB,eAAgB,MAAM,WAAuD,CAAC"}

package/dist/esm/mdns/MdnsConsts.js

@@ -0,0 +1,32 @@
+/**
+ * @license
+ * Copyright 2022-2024 Matter.js Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+const SERVICE_DISCOVERY_QNAME = "_services._dns-sd._udp.local";
+const MATTER_COMMISSION_SERVICE_QNAME = "_matterc._udp.local";
+const MATTER_COMMISSIONER_SERVICE_QNAME = "_matterd._udp.local";
+const MATTER_SERVICE_QNAME = "_matter._tcp.local";
+const getFabricQname = (operationalIdString) => `_I${operationalIdString}._sub.${MATTER_SERVICE_QNAME}`;
+const getDeviceMatterQname = (operationalIdString, nodeIdString) => `${operationalIdString}-${nodeIdString}.${MATTER_SERVICE_QNAME}`;
+const getVendorQname = (vendorId) => `_V${vendorId}._sub.${MATTER_COMMISSION_SERVICE_QNAME}`;
+const getDeviceTypeQname = (deviceType) => `_T${deviceType}._sub.${MATTER_COMMISSION_SERVICE_QNAME}`;
+const getShortDiscriminatorQname = (shortDiscriminator) => `_S${shortDiscriminator}._sub.${MATTER_COMMISSION_SERVICE_QNAME}`;
+const getLongDiscriminatorQname = (longDiscriminator) => `_L${longDiscriminator}._sub.${MATTER_COMMISSION_SERVICE_QNAME}`;
+const getCommissioningModeQname = () => `_CM._sub.${MATTER_COMMISSION_SERVICE_QNAME}`;
+const getDeviceInstanceQname = (instanceId) => `${instanceId}.${MATTER_COMMISSION_SERVICE_QNAME}`;
+export {
+  MATTER_COMMISSIONER_SERVICE_QNAME,
+  MATTER_COMMISSION_SERVICE_QNAME,
+  MATTER_SERVICE_QNAME,
+  SERVICE_DISCOVERY_QNAME,
+  getCommissioningModeQname,
+  getDeviceInstanceQname,
+  getDeviceMatterQname,
+  getDeviceTypeQname,
+  getFabricQname,
+  getLongDiscriminatorQname,
+  getShortDiscriminatorQname,
+  getVendorQname
+};
+//# sourceMappingURL=MdnsConsts.js.map

package/dist/esm/mdns/MdnsConsts.js.map

@@ -0,0 +1,6 @@
+{
+  "version": 3,
+  "sources": ["../../../src/mdns/MdnsConsts.ts"],
+  "mappings": "AAAA;AAAA;AAAA;AAAA;AAAA;AAQO,MAAM,0BAA0B;AAChC,MAAM,kCAAkC;AACxC,MAAM,oCAAoC;AAC1C,MAAM,uBAAuB;AAE7B,MAAM,iBAAiB,CAAC,wBAAgC,KAAK,mBAAmB,SAAS,oBAAoB;AAC7G,MAAM,uBAAuB,CAAC,qBAA6B,iBAC9D,GAAG,mBAAmB,IAAI,YAAY,IAAI,oBAAoB;AAC3D,MAAM,iBAAiB,CAAC,aAAuB,KAAK,QAAQ,SAAS,+BAA+B;AACpG,MAAM,qBAAqB,CAAC,eAAuB,KAAK,UAAU,SAAS,+BAA+B;AAC1G,MAAM,6BAA6B,CAAC,uBACvC,KAAK,kBAAkB,SAAS,+BAA+B;AAC5D,MAAM,4BAA4B,CAAC,sBACtC,KAAK,iBAAiB,SAAS,+BAA+B;AAC3D,MAAM,4BAA4B,MAAM,YAAY,+BAA+B;AACnF,MAAM,yBAAyB,CAAC,eAAuB,GAAG,UAAU,IAAI,+BAA+B;",
+  "names": []
+}

package/dist/esm/mdns/MdnsInstanceBroadcaster.d.ts

@@ -0,0 +1,28 @@
+/**
+ * @license
+ * Copyright 2022-2024 Matter.js Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { CommissionerInstanceData, CommissioningModeInstanceData, InstanceBroadcaster } from "../common/InstanceBroadcaster.js";
+import { Fabric } from "../fabric/Fabric.js";
+import type { MdnsBroadcaster } from "./MdnsBroadcaster.js";
+/**
+ * This class is handing MDNS Announcements for one instance of a device aka "port".
+ *
+ * Obtain an instance via {@link MdnsBroadcaster.createInstanceBroadcaster}.
+ */
+export declare class MdnsInstanceBroadcaster implements InstanceBroadcaster {
+    #private;
+    constructor(instancePort: number, mdnsBroadcaster: MdnsBroadcaster, onclose: () => void);
+    close(): Promise<void>;
+    setCommissionMode(mode: number, deviceData: CommissioningModeInstanceData): Promise<void>;
+    /** Set the Broadcaster Data to announce a device for operative discovery (aka "already paired") */
+    setFabrics(fabrics: Fabric[], expireCommissioningAnnouncements?: boolean): Promise<void>;
+    /** Set the Broadcaster data to announce a Commissioner (aka Commissioner discovery) */
+    setCommissionerInfo(commissionerData: CommissionerInstanceData): Promise<void>;
+    announce(): Promise<void>;
+    expireFabricAnnouncement(): Promise<void>;
+    expireCommissioningAnnouncement(): Promise<void>;
+    expireAllAnnouncements(): Promise<void>;
+}
+//# sourceMappingURL=MdnsInstanceBroadcaster.d.ts.map

package/dist/esm/mdns/MdnsInstanceBroadcaster.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"MdnsInstanceBroadcaster.d.ts","sourceRoot":"","sources":["../../../src/mdns/MdnsInstanceBroadcaster.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,EACH,wBAAwB,EACxB,6BAA6B,EAC7B,mBAAmB,EACtB,MAAM,kCAAkC,CAAC;AAC1C,OAAO,EAAE,MAAM,EAAE,MAAM,qBAAqB,CAAC;AAC7C,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAE5D;;;;GAIG;AACH,qBAAa,uBAAwB,YAAW,mBAAmB;;gBAMnD,YAAY,EAAE,MAAM,EAAE,eAAe,EAAE,eAAe,EAAE,OAAO,EAAE,MAAM,IAAI;IAMjF,KAAK;IAUL,iBAAiB,CAAC,IAAI,EAAE,MAAM,EAAE,UAAU,EAAE,6BAA6B;IAK/E,mGAAmG;IAC7F,UAAU,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE,gCAAgC,UAAQ;IAQ5E,uFAAuF;IACjF,mBAAmB,CAAC,gBAAgB,EAAE,wBAAwB;IAK9D,QAAQ;IAKR,wBAAwB;IAKxB,+BAA+B;IAK/B,sBAAsB;CAU/B"}

package/dist/esm/mdns/MdnsInstanceBroadcaster.js

@@ -0,0 +1,67 @@
+/**
+ * @license
+ * Copyright 2022-2024 Matter.js Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { ImplementationError } from "#general";
+class MdnsInstanceBroadcaster {
+  #instancePort;
+  #mdnsBroadcaster;
+  #onclose;
+  #isClosed = false;
+  constructor(instancePort, mdnsBroadcaster, onclose) {
+    this.#instancePort = instancePort;
+    this.#mdnsBroadcaster = mdnsBroadcaster;
+    this.#onclose = onclose;
+  }
+  async close() {
+    if (this.#isClosed) {
+      return;
+    }
+    this.#isClosed = true;
+    await this.#mdnsBroadcaster.expireAllAnnouncements(this.#instancePort);
+    this.#onclose();
+  }
+  async setCommissionMode(mode, deviceData) {
+    this.#assertOpen();
+    await this.#mdnsBroadcaster.setCommissionMode(this.#instancePort, mode, deviceData);
+  }
+  /** Set the Broadcaster Data to announce a device for operative discovery (aka "already paired") */
+  async setFabrics(fabrics, expireCommissioningAnnouncements = false) {
+    this.#assertOpen();
+    if (expireCommissioningAnnouncements) {
+      await this.#mdnsBroadcaster.expireCommissioningAnnouncement(this.#instancePort);
+    }
+    await this.#mdnsBroadcaster.setFabrics(this.#instancePort, fabrics);
+  }
+  /** Set the Broadcaster data to announce a Commissioner (aka Commissioner discovery) */
+  async setCommissionerInfo(commissionerData) {
+    this.#assertOpen();
+    await this.#mdnsBroadcaster.setCommissionerInfo(this.#instancePort, commissionerData);
+  }
+  async announce() {
+    this.#assertOpen();
+    await this.#mdnsBroadcaster.announce(this.#instancePort);
+  }
+  async expireFabricAnnouncement() {
+    this.#assertOpen();
+    await this.#mdnsBroadcaster.expireFabricAnnouncement(this.#instancePort);
+  }
+  async expireCommissioningAnnouncement() {
+    this.#assertOpen();
+    await this.#mdnsBroadcaster.expireCommissioningAnnouncement(this.#instancePort);
+  }
+  async expireAllAnnouncements() {
+    this.#assertOpen();
+    await this.#mdnsBroadcaster.expireAllAnnouncements(this.#instancePort);
+  }
+  #assertOpen() {
+    if (this.#isClosed) {
+      throw new ImplementationError("Illegal operation on closed MdnsInstanceBroadcaster");
+    }
+  }
+}
+export {
+  MdnsInstanceBroadcaster
+};
+//# sourceMappingURL=MdnsInstanceBroadcaster.js.map

package/dist/esm/mdns/MdnsInstanceBroadcaster.js.map

@@ -0,0 +1,6 @@
+{
+  "version": 3,
+  "sources": ["../../../src/mdns/MdnsInstanceBroadcaster.ts"],
+  "mappings": "AAAA;AAAA;AAAA;AAAA;AAAA;AAMA,SAAS,2BAA2B;AAc7B,MAAM,wBAAuD;AAAA,EACvD;AAAA,EACA;AAAA,EACA;AAAA,EACT,YAAY;AAAA,EAEZ,YAAY,cAAsB,iBAAkC,SAAqB;AACrF,SAAK,gBAAgB;AACrB,SAAK,mBAAmB;AACxB,SAAK,WAAW;AAAA,EACpB;AAAA,EAEA,MAAM,QAAQ;AACV,QAAI,KAAK,WAAW;AAChB;AAAA,IACJ;AACA,SAAK,YAAY;AAEjB,UAAM,KAAK,iBAAiB,uBAAuB,KAAK,aAAa;AACrE,SAAK,SAAS;AAAA,EAClB;AAAA,EAEA,MAAM,kBAAkB,MAAc,YAA2C;AAC7E,SAAK,YAAY;AACjB,UAAM,KAAK,iBAAiB,kBAAkB,KAAK,eAAe,MAAM,UAAU;AAAA,EACtF;AAAA;AAAA,EAGA,MAAM,WAAW,SAAmB,mCAAmC,OAAO;AAC1E,SAAK,YAAY;AACjB,QAAI,kCAAkC;AAClC,YAAM,KAAK,iBAAiB,gCAAgC,KAAK,aAAa;AAAA,IAClF;AACA,UAAM,KAAK,iBAAiB,WAAW,KAAK,eAAe,OAAO;AAAA,EACtE;AAAA;AAAA,EAGA,MAAM,oBAAoB,kBAA4C;AAClE,SAAK,YAAY;AACjB,UAAM,KAAK,iBAAiB,oBAAoB,KAAK,eAAe,gBAAgB;AAAA,EACxF;AAAA,EAEA,MAAM,WAAW;AACb,SAAK,YAAY;AACjB,UAAM,KAAK,iBAAiB,SAAS,KAAK,aAAa;AAAA,EAC3D;AAAA,EAEA,MAAM,2BAA2B;AAC7B,SAAK,YAAY;AACjB,UAAM,KAAK,iBAAiB,yBAAyB,KAAK,aAAa;AAAA,EAC3E;AAAA,EAEA,MAAM,kCAAkC;AACpC,SAAK,YAAY;AACjB,UAAM,KAAK,iBAAiB,gCAAgC,KAAK,aAAa;AAAA,EAClF;AAAA,EAEA,MAAM,yBAAyB;AAC3B,SAAK,YAAY;AACjB,UAAM,KAAK,iBAAiB,uBAAuB,KAAK,aAAa;AAAA,EACzE;AAAA,EAEA,cAAc;AACV,QAAI,KAAK,WAAW;AAChB,YAAM,IAAI,oBAAoB,qDAAqD;AAAA,IACvF;AAAA,EACJ;AACJ;",
+  "names": []
+}

package/dist/esm/mdns/MdnsScanner.d.ts

@@ -0,0 +1,79 @@
+/**
+ * @license
+ * Copyright 2022-2024 Matter.js Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { ChannelType, Diagnostic, Network, ServerAddressIp, UdpMulticastServer } from "#general";
+import { NodeId } from "#types";
+import { CommissionableDevice, CommissionableDeviceIdentifiers, DiscoveryData, OperationalDevice, Scanner } from "../common/Scanner.js";
+import { Fabric } from "../fabric/Fabric.js";
+type MatterServerRecordWithExpire = ServerAddressIp & {
+    expires: number;
+};
+/**
+ * This class implements the Scanner interface for a MDNS scanner via UDP messages in a IP based network.
+ * It sends out queries to discover various types of Matter device types and listens for announcements.
+ */
+export declare class MdnsScanner implements Scanner {
+    #private;
+    get type(): ChannelType;
+    static create(network: Network, options?: {
+        enableIpv4?: boolean;
+        netInterface?: string;
+    }): Promise<MdnsScanner>;
+    constructor(multicastServer: UdpMulticastServer, enableIpv4?: boolean);
+    /**
+     * Method to find an operational device (already commissioned) and return a promise with the list of discovered
+     * IP/ports or an empty array if not found.
+     */
+    findOperationalDevice({ operationalId }: Fabric, nodeId: NodeId, timeoutSeconds?: number, ignoreExistingRecords?: boolean): Promise<OperationalDevice | undefined>;
+    cancelOperationalDeviceDiscovery(fabric: Fabric, nodeId: NodeId, resolvePromise?: boolean): void;
+    cancelCommissionableDeviceDiscovery(identifier: CommissionableDeviceIdentifiers, resolvePromise?: boolean): void;
+    getDiscoveredOperationalDevice({ operationalId }: Fabric, nodeId: NodeId): OperationalDevice | undefined;
+    /**
+     * Discovers commissionable devices based on a defined identifier for maximal given timeout, but returns the
+     * first found entries. If already a discovered device matches in the cache the response is returned directly and
+     * no query is triggered. If no record exists a query is sent out and the promise gets fulfilled as soon as at least
+     * one device is found. If no device is discovered in the defined timeframe an empty array is returned. When the
+     * promise got fulfilled no more queries are send out, but more device entries might be added when discovered later.
+     * These can be requested by the getCommissionableDevices method.
+     */
+    findCommissionableDevices(identifier: CommissionableDeviceIdentifiers, timeoutSeconds?: number, ignoreExistingRecords?: boolean): Promise<CommissionableDevice[]>;
+    /**
+     * Discovers commissionable devices based on a defined identifier and returns the first found entries. If already a
+     * @param identifier
+     * @param callback
+     * @param timeoutSeconds
+     */
+    findCommissionableDevicesContinuously(identifier: CommissionableDeviceIdentifiers, callback: (device: CommissionableDevice) => void, timeoutSeconds?: number): Promise<CommissionableDevice[]>;
+    getDiscoveredCommissionableDevices(identifier: CommissionableDeviceIdentifiers): {
+        addresses: ServerAddressIp[];
+        expires: undefined;
+        VP?: string | undefined;
+        DT?: number | undefined;
+        DN?: string | undefined;
+        RI?: string | undefined;
+        PH?: number | undefined;
+        PI?: string | undefined;
+        SII?: number | undefined;
+        SAI?: number | undefined;
+        SAT?: number | undefined;
+        T?: number | undefined;
+        ICD?: number | undefined;
+        deviceIdentifier: string;
+        D: number;
+        CM: number;
+        instanceId: string;
+        SD: number;
+        V?: number;
+        P?: number;
+    }[];
+    /**
+     * Close all connects, end all timers and resolve all pending promises.
+     */
+    close(): Promise<void>;
+    static discoveryDataDiagnostics(data: DiscoveryData): Record<string, unknown> & Diagnostic;
+    static deviceAddressDiagnostics(addresses: Map<string, MatterServerRecordWithExpire>): (Record<string, unknown> & Diagnostic)[];
+}
+export {};
+//# sourceMappingURL=MdnsScanner.d.ts.map

package/dist/esm/mdns/MdnsScanner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"MdnsScanner.d.ts","sourceRoot":"","sources":["../../../src/mdns/MdnsScanner.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAEH,WAAW,EACX,UAAU,EAWV,OAAO,EAEP,eAAe,EAIf,kBAAkB,EAGrB,MAAM,UAAU,CAAC;AAClB,OAAO,EAAE,MAAM,EAAY,MAAM,QAAQ,CAAC;AAC1C,OAAO,EACH,oBAAoB,EACpB,+BAA+B,EAC/B,aAAa,EACb,iBAAiB,EACjB,OAAO,EACV,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAAE,MAAM,EAAE,MAAM,qBAAqB,CAAC;AAgB7C,KAAK,4BAA4B,GAAG,eAAe,GAAG;IAClD,OAAO,EAAE,MAAM,CAAC;CACnB,CAAC;AAmBF;;;GAGG;AACH,qBAAa,WAAY,YAAW,OAAO;;IACvC,IAAI,IAAI,gBAEP;WAEY,MAAM,CAAC,OAAO,EAAE,OAAO,EAAE,OAAO,CAAC,EAAE;QAAE,UAAU,CAAC,EAAE,OAAO,CAAC;QAAC,YAAY,CAAC,EAAE,MAAM,CAAA;KAAE;gBAkCnF,eAAe,EAAE,kBAAkB,EAAE,UAAU,CAAC,EAAE,OAAO;IA8OrE;;;OAGG;IACG,qBAAqB,CACvB,EAAE,aAAa,EAAE,EAAE,MAAM,EACzB,MAAM,EAAE,MAAM,EACd,cAAc,CAAC,EAAE,MAAM,EACvB,qBAAqB,UAAQ,GAC9B,OAAO,CAAC,iBAAiB,GAAG,SAAS,CAAC;IAyBzC,gCAAgC,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,cAAc,UAAO;IAKtF,mCAAmC,CAAC,UAAU,EAAE,+BAA+B,EAAE,cAAc,UAAO;IAKtG,8BAA8B,CAAC,EAAE,aAAa,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM;IAsKxE;;;;;;;OAOG;IACG,yBAAyB,CAC3B,UAAU,EAAE,+BAA+B,EAC3C,cAAc,SAAI,EAClB,qBAAqB,UAAQ,GAC9B,OAAO,CAAC,oBAAoB,EAAE,CAAC;IAkBlC;;;;;OAKG;IACG,qCAAqC,CACvC,UAAU,EAAE,+BAA+B,EAC3C,QAAQ,EAAE,CAAC,MAAM,EAAE,oBAAoB,KAAK,IAAI,EAChD,cAAc,SAAM,GACrB,OAAO,CAAC,oBAAoB,EAAE,CAAC;IA0BlC,kCAAkC,CAAC,UAAU,EAAE,+BAA+B;mBAjM3D,eAAe,EAAE;;;;;;;;;;;;;;;;oBA1XxB,MAAM;YACd,MAAM;YACN,MAAM;YACN,MAAM;;IA4jBV;;OAEG;IACG,KAAK;IAyXX,MAAM,CAAC,wBAAwB,CAAC,IAAI,EAAE,aAAa;IAgBnD,MAAM,CAAC,wBAAwB,CAAC,SAAS,EAAE,GAAG,CAAC,MAAM,EAAE,4BAA4B,CAAC;CASvF"}