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

package/dist/cjs/mdns/MdnsBroadcaster.js

@@ -0,0 +1,338 @@
+"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 MdnsBroadcaster_exports = {};
+__export(MdnsBroadcaster_exports, {
+  MdnsBroadcaster: () => MdnsBroadcaster
+});
+module.exports = __toCommonJS(MdnsBroadcaster_exports);
+var import_general = require("#general");
+var import_types = require("#types");
+var import_InstanceBroadcaster = require("../common/InstanceBroadcaster.js");
+var import_Session = require("../session/Session.js");
+var import_MdnsConsts = require("./MdnsConsts.js");
+var import_MdnsInstanceBroadcaster = require("./MdnsInstanceBroadcaster.js");
+var import_MdnsServer = require("./MdnsServer.js");
+/**
+ * @license
+ * Copyright 2022-2024 Matter.js Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+const logger = import_general.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 import_general.BasicSet();
+  static async create(network, options) {
+    const { enableIpv4, multicastInterface } = options ?? {};
+    return new MdnsBroadcaster(
+      network,
+      await import_MdnsServer.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 import_MdnsInstanceBroadcaster.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 import_general.ImplementationError("Session Idle Interval must be less than 1 hour");
+    }
+    if (sessionActiveInterval !== void 0 && sessionActiveInterval > 36e5) {
+      throw new import_general.ImplementationError("Session Active Interval must be less than 1 hour");
+    }
+    if (sessionActiveThreshold !== void 0 && sessionActiveThreshold > 65535) {
+      throw new import_general.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 import_general.ImplementationError(
+        `Pairing instructions required for Pairing Hint of type "${needsInstructions}"`
+      );
+    }
+  }
+  #getIpRecords(hostname, ips) {
+    const records = new Array();
+    ips.forEach((ip) => {
+      if ((0, import_general.isIPv6)(ip)) {
+        records.push((0, import_general.AAAARecord)(hostname, ip));
+      } else if ((0, import_general.isIPv4)(ip)) {
+        if (this.#enableIpv4) {
+          records.push((0, import_general.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 = import_Session.SESSION_IDLE_INTERVAL_MS,
+      sessionActiveInterval = import_Session.SESSION_ACTIVE_INTERVAL_MS,
+      sessionActiveThreshold = import_Session.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 = import_general.Bytes.toHex(import_general.Crypto.getRandomData(8)).toUpperCase();
+    const vendorQname = (0, import_MdnsConsts.getVendorQname)(vendorId);
+    const deviceTypeQname = (0, import_MdnsConsts.getDeviceTypeQname)(deviceType);
+    const shortDiscriminatorQname = (0, import_MdnsConsts.getShortDiscriminatorQname)(shortDiscriminator);
+    const longDiscriminatorQname = (0, import_MdnsConsts.getLongDiscriminatorQname)(discriminator);
+    const commissionModeQname = (0, import_MdnsConsts.getCommissioningModeQname)();
+    const deviceQname = (0, import_MdnsConsts.getDeviceInstanceQname)(instanceId);
+    await this.#mdnsServer.setRecordsGenerator(
+      announcedNetPort,
+      import_MdnsServer.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 ",
+          import_general.Diagnostic.dict({
+            mode,
+            qname: deviceQname,
+            port: announcedNetPort,
+            interface: netInterface
+          })
+        );
+        const records = [
+          (0, import_general.PtrRecord)(import_MdnsConsts.SERVICE_DISCOVERY_QNAME, import_MdnsConsts.MATTER_COMMISSION_SERVICE_QNAME),
+          (0, import_general.PtrRecord)(import_MdnsConsts.SERVICE_DISCOVERY_QNAME, vendorQname),
+          (0, import_general.PtrRecord)(import_MdnsConsts.SERVICE_DISCOVERY_QNAME, deviceTypeQname),
+          (0, import_general.PtrRecord)(import_MdnsConsts.SERVICE_DISCOVERY_QNAME, shortDiscriminatorQname),
+          (0, import_general.PtrRecord)(import_MdnsConsts.SERVICE_DISCOVERY_QNAME, longDiscriminatorQname),
+          (0, import_general.PtrRecord)(import_MdnsConsts.SERVICE_DISCOVERY_QNAME, commissionModeQname),
+          (0, import_general.PtrRecord)(import_MdnsConsts.MATTER_COMMISSION_SERVICE_QNAME, deviceQname),
+          (0, import_general.PtrRecord)(vendorQname, deviceQname),
+          (0, import_general.PtrRecord)(deviceTypeQname, deviceQname),
+          (0, import_general.PtrRecord)(shortDiscriminatorQname, deviceQname),
+          (0, import_general.PtrRecord)(longDiscriminatorQname, deviceQname),
+          (0, import_general.PtrRecord)(commissionModeQname, deviceQname),
+          (0, import_general.SrvRecord)(deviceQname, { priority: 0, weight: 0, port: announcedNetPort, target: hostname }),
+          (0, import_general.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=${import_InstanceBroadcaster.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 = import_Session.SESSION_IDLE_INTERVAL_MS,
+    sessionActiveInterval = import_Session.SESSION_ACTIVE_INTERVAL_MS,
+    sessionActiveThreshold = import_Session.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, import_MdnsServer.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 = [(0, import_general.PtrRecord)(import_MdnsConsts.SERVICE_DISCOVERY_QNAME, import_MdnsConsts.MATTER_SERVICE_QNAME)];
+      fabrics.forEach((fabric) => {
+        const { operationalId, nodeId } = fabric;
+        const operationalIdString = import_general.Bytes.toHex(operationalId).toUpperCase();
+        const fabricQname = (0, import_MdnsConsts.getFabricQname)(operationalIdString);
+        const deviceMatterQname = (0, import_MdnsConsts.getDeviceMatterQname)(operationalIdString, import_types.NodeId.toHexString(nodeId));
+        logger.debug(
+          "Announcement Generator: Fabric",
+          import_general.Diagnostic.dict({
+            id: `${import_general.Bytes.toHex(operationalId)}/${nodeId}`,
+            qname: deviceMatterQname,
+            port: announcedNetPort,
+            interface: netInterface
+          })
+        );
+        const fabricRecords = [
+          (0, import_general.PtrRecord)(import_MdnsConsts.SERVICE_DISCOVERY_QNAME, fabricQname),
+          (0, import_general.PtrRecord)(import_MdnsConsts.MATTER_SERVICE_QNAME, deviceMatterQname),
+          (0, import_general.PtrRecord)(fabricQname, deviceMatterQname),
+          (0, import_general.SrvRecord)(deviceMatterQname, { priority: 0, weight: 0, port: announcedNetPort, target: hostname }),
+          (0, import_general.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 = import_Session.SESSION_IDLE_INTERVAL_MS,
+    sessionActiveInterval = import_Session.SESSION_ACTIVE_INTERVAL_MS,
+    sessionActiveThreshold = import_Session.SESSION_ACTIVE_THRESHOLD_MS
+  }) {
+    logger.debug(
+      "Announcement: Commissioner",
+      import_general.Diagnostic.dict({
+        port: announcedNetPort,
+        deviceType
+      })
+    );
+    const instanceId = import_general.Bytes.toHex(import_general.Crypto.getRandomData(8)).toUpperCase();
+    const deviceTypeQname = `_T${deviceType}._sub.${import_MdnsConsts.MATTER_COMMISSIONER_SERVICE_QNAME}`;
+    const vendorQname = `_V${vendorId}._sub.${import_MdnsConsts.MATTER_COMMISSIONER_SERVICE_QNAME}`;
+    const deviceQname = `${instanceId}.${import_MdnsConsts.MATTER_COMMISSIONER_SERVICE_QNAME}`;
+    this.#activeCommissioningAnnouncements.add(announcedNetPort);
+    await this.#mdnsServer.setRecordsGenerator(
+      announcedNetPort,
+      import_MdnsServer.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 = [
+          (0, import_general.PtrRecord)(import_MdnsConsts.SERVICE_DISCOVERY_QNAME, import_MdnsConsts.MATTER_COMMISSIONER_SERVICE_QNAME),
+          (0, import_general.PtrRecord)(import_MdnsConsts.MATTER_COMMISSIONER_SERVICE_QNAME, vendorQname),
+          (0, import_general.PtrRecord)(vendorQname, deviceQname),
+          (0, import_general.SrvRecord)(deviceQname, { priority: 0, weight: 0, port: announcedNetPort, target: hostname }),
+          (0, import_general.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((0, import_general.PtrRecord)(import_MdnsConsts.SERVICE_DISCOVERY_QNAME, deviceTypeQname));
+          records.push((0, import_general.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, import_MdnsServer.AnnouncementType.Operative);
+      this.#activeOperationalAnnouncements.delete(announcementPort);
+    }
+  }
+  async expireCommissioningAnnouncement(announcementPort) {
+    if (this.#activeCommissioningAnnouncements.has(announcementPort)) {
+      await this.#mdnsServer.expireAnnouncements(announcementPort, import_MdnsServer.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();
+  }
+}
+//# sourceMappingURL=MdnsBroadcaster.js.map

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

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

package/dist/cjs/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/cjs/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/cjs/mdns/MdnsConsts.js

@@ -0,0 +1,52 @@
+"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 MdnsConsts_exports = {};
+__export(MdnsConsts_exports, {
+  MATTER_COMMISSIONER_SERVICE_QNAME: () => MATTER_COMMISSIONER_SERVICE_QNAME,
+  MATTER_COMMISSION_SERVICE_QNAME: () => MATTER_COMMISSION_SERVICE_QNAME,
+  MATTER_SERVICE_QNAME: () => MATTER_SERVICE_QNAME,
+  SERVICE_DISCOVERY_QNAME: () => SERVICE_DISCOVERY_QNAME,
+  getCommissioningModeQname: () => getCommissioningModeQname,
+  getDeviceInstanceQname: () => getDeviceInstanceQname,
+  getDeviceMatterQname: () => getDeviceMatterQname,
+  getDeviceTypeQname: () => getDeviceTypeQname,
+  getFabricQname: () => getFabricQname,
+  getLongDiscriminatorQname: () => getLongDiscriminatorQname,
+  getShortDiscriminatorQname: () => getShortDiscriminatorQname,
+  getVendorQname: () => getVendorQname
+});
+module.exports = __toCommonJS(MdnsConsts_exports);
+/**
+ * @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}`;
+//# sourceMappingURL=MdnsConsts.js.map

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

@@ -0,0 +1,6 @@
+{
+  "version": 3,
+  "sources": ["../../../src/mdns/MdnsConsts.ts"],
+  "mappings": ";;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;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/cjs/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/cjs/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/cjs/mdns/MdnsInstanceBroadcaster.js

@@ -0,0 +1,87 @@
+"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 MdnsInstanceBroadcaster_exports = {};
+__export(MdnsInstanceBroadcaster_exports, {
+  MdnsInstanceBroadcaster: () => MdnsInstanceBroadcaster
+});
+module.exports = __toCommonJS(MdnsInstanceBroadcaster_exports);
+var import_general = require("#general");
+/**
+ * @license
+ * Copyright 2022-2024 Matter.js Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+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 import_general.ImplementationError("Illegal operation on closed MdnsInstanceBroadcaster");
+    }
+  }
+}
+//# sourceMappingURL=MdnsInstanceBroadcaster.js.map

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

@@ -0,0 +1,6 @@
+{
+  "version": 3,
+  "sources": ["../../../src/mdns/MdnsInstanceBroadcaster.ts"],
+  "mappings": ";;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAMA,qBAAoC;AANpC;AAAA;AAAA;AAAA;AAAA;AAoBO,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,mCAAoB,qDAAqD;AAAA,IACvF;AAAA,EACJ;AACJ;",
+  "names": []
+}

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