@matter/protocol 0.16.0-alpha.0-20250809-ee8375bcb → 0.16.0-alpha.0-20250812-285b75d83

package/dist/cjs/advertisement/index.js

@@ -0,0 +1,30 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+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 __reExport = (target, mod, secondTarget) => (__copyProps(target, mod, "default"), secondTarget && __copyProps(secondTarget, mod, "default"));
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var advertisement_exports = {};
+module.exports = __toCommonJS(advertisement_exports);
+__reExport(advertisement_exports, require("./Advertisement.js"), module.exports);
+__reExport(advertisement_exports, require("./Advertiser.js"), module.exports);
+__reExport(advertisement_exports, require("./ble/index.js"), module.exports);
+__reExport(advertisement_exports, require("./CommissioningMode.js"), module.exports);
+__reExport(advertisement_exports, require("./mdns/index.js"), module.exports);
+__reExport(advertisement_exports, require("./PairingHintBitmap.js"), module.exports);
+__reExport(advertisement_exports, require("./ServiceDescription.js"), module.exports);
+/**
+ * @license
+ * Copyright 2022-2025 Matter.js Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+//# sourceMappingURL=index.js.map

package/dist/cjs/advertisement/index.js.map

@@ -0,0 +1,6 @@
+{
+  "version": 3,
+  "sources": ["../../../src/advertisement/index.ts"],
+  "mappings": ";;;;;;;;;;;;;;;AAAA;AAAA;AAMA,kCAAc,+BANd;AAOA,kCAAc,4BAPd;AAQA,kCAAc,2BARd;AASA,kCAAc,mCATd;AAUA,kCAAc,4BAVd;AAWA,kCAAc,mCAXd;AAYA,kCAAc,oCAZd;AAAA;AAAA;AAAA;AAAA;AAAA;",
+  "names": []
+}

package/dist/cjs/advertisement/mdns/CommissionableMdnsAdvertisement.d.ts

@@ -0,0 +1,21 @@
+/**
+ * @license
+ * Copyright 2022-2025 Matter.js Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import type { Advertisement } from "#advertisement/Advertisement.js";
+import { ServiceDescription } from "#advertisement/ServiceDescription.js";
+import { MdnsAdvertisement } from "./MdnsAdvertisement.js";
+import type { MdnsAdvertiser } from "./MdnsAdvertiser.js";
+/**
+ * Advertise a node as commissionable.
+ */
+export declare class CommissionableMdnsAdvertisement extends MdnsAdvertisement<ServiceDescription.Commissionable> {
+    #private;
+    instanceId: string;
+    constructor(advertiser: MdnsAdvertiser, description: ServiceDescription.Commissionable);
+    get ptrRecords(): import("#general").DnsRecord<string>[];
+    get txtValues(): Record<string, unknown>;
+    isDuplicate(other: Advertisement): other is Advertisement<ServiceDescription.Commissionable> | Advertisement<ServiceDescription.Commissioner>;
+}
+//# sourceMappingURL=CommissionableMdnsAdvertisement.d.ts.map

package/dist/cjs/advertisement/mdns/CommissionableMdnsAdvertisement.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"CommissionableMdnsAdvertisement.d.ts","sourceRoot":"","sources":["../../../../src/advertisement/mdns/CommissionableMdnsAdvertisement.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,iCAAiC,CAAC;AAErE,OAAO,EAAE,kBAAkB,EAAE,MAAM,sCAAsC,CAAC;AAc1E,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAC3D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAE1D;;GAEG;AACH,qBAAa,+BAAgC,SAAQ,iBAAiB,CAAC,kBAAkB,CAAC,cAAc,CAAC;;IACrG,UAAU,EAAE,MAAM,CAAC;gBAEP,UAAU,EAAE,cAAc,EAAE,WAAW,EAAE,kBAAkB,CAAC,cAAc;IAWtF,IAAa,UAAU,2CA4BtB;IAED,IAAa,SAAS,4BA0BrB;IAEQ,WAAW,CAAC,KAAK,EAAE,aAAa;CAiB5C"}

package/dist/cjs/advertisement/mdns/CommissionableMdnsAdvertisement.js

@@ -0,0 +1,104 @@
+"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 CommissionableMdnsAdvertisement_exports = {};
+__export(CommissionableMdnsAdvertisement_exports, {
+  CommissionableMdnsAdvertisement: () => CommissionableMdnsAdvertisement
+});
+module.exports = __toCommonJS(CommissionableMdnsAdvertisement_exports);
+var import_PairingHintBitmap = require("#advertisement/PairingHintBitmap.js");
+var import_general = require("#general");
+var import_MdnsConsts = require("#mdns/MdnsConsts.js");
+var import_MdnsAdvertisement = require("./MdnsAdvertisement.js");
+/**
+ * @license
+ * Copyright 2022-2025 Matter.js Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+class CommissionableMdnsAdvertisement extends import_MdnsAdvertisement.MdnsAdvertisement {
+  instanceId;
+  constructor(advertiser, description) {
+    const instanceId = advertiser.createInstanceId();
+    const qname = (0, import_MdnsConsts.getCommissionableDeviceQname)(instanceId);
+    super(advertiser, qname, description);
+    this.instanceId = instanceId;
+    this.#validatePairingInstructions();
+  }
+  get ptrRecords() {
+    const { discriminator, deviceType, vendorId } = this.description;
+    const shortDiscriminator = discriminator >> 8 & 15;
+    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 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, 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, this.qname),
+      (0, import_general.PtrRecord)(deviceTypeQname, this.qname),
+      (0, import_general.PtrRecord)(shortDiscriminatorQname, this.qname),
+      (0, import_general.PtrRecord)(longDiscriminatorQname, this.qname),
+      (0, import_general.PtrRecord)(commissionModeQname, this.qname)
+    ];
+    if (!this.isPrivacyMasked) {
+      records.push((0, import_general.PtrRecord)(import_MdnsConsts.SERVICE_DISCOVERY_QNAME, vendorQname), (0, import_general.PtrRecord)(vendorQname, this.qname));
+    }
+    return records;
+  }
+  get txtValues() {
+    const {
+      vendorId,
+      productId,
+      deviceType,
+      name,
+      discriminator,
+      mode,
+      pairingHint = import_MdnsConsts.DEFAULT_PAIRING_HINT,
+      pairingInstructions
+    } = this.description;
+    const values = {
+      DN: name,
+      DT: deviceType,
+      D: discriminator,
+      CM: mode,
+      PH: import_PairingHintBitmap.PairingHintBitmapSchema.encode(pairingHint),
+      PI: pairingInstructions
+    };
+    if (!this.isPrivacyMasked) {
+      values.VP = `${vendorId}+${productId}`;
+    }
+    return values;
+  }
+  isDuplicate(other) {
+    return other.isCommissioning();
+  }
+  #validatePairingInstructions() {
+    const { pairingHint, pairingInstructions } = this.description;
+    const needsInstructions = pairingHint && import_MdnsConsts.PAIRING_HINTS_REQUIRING_INSTRUCTION.find((hint) => pairingHint[hint] === true);
+    if (needsInstructions && !pairingInstructions) {
+      throw new import_general.ImplementationError(
+        `Pairing instructions required for pairing hint of type "${needsInstructions}"`
+      );
+    }
+  }
+}
+//# sourceMappingURL=CommissionableMdnsAdvertisement.js.map

package/dist/cjs/advertisement/mdns/CommissionableMdnsAdvertisement.js.map

@@ -0,0 +1,6 @@
+{
+  "version": 3,
+  "sources": ["../../../../src/advertisement/mdns/CommissionableMdnsAdvertisement.ts"],
+  "mappings": ";;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAOA,+BAAwC;AAExC,qBAA+C;AAC/C,wBAWO;AACP,+BAAkC;AAtBlC;AAAA;AAAA;AAAA;AAAA;AA4BO,MAAM,wCAAwC,2CAAqD;AAAA,EACtG;AAAA,EAEA,YAAY,YAA4B,aAAgD;AACpF,UAAM,aAAa,WAAW,iBAAiB;AAC/C,UAAM,YAAQ,gDAA6B,UAAU;AAErD,UAAM,YAAY,OAAO,WAAW;AAEpC,SAAK,aAAa;AAElB,SAAK,6BAA6B;AAAA,EACtC;AAAA,EAEA,IAAa,aAAa;AACtB,UAAM,EAAE,eAAe,YAAY,SAAS,IAAI,KAAK;AAErD,UAAM,qBAAsB,iBAAiB,IAAK;AAClD,UAAM,kBAAc,kCAAe,QAAQ;AAC3C,UAAM,sBAAkB,sCAAmB,UAAU;AACrD,UAAM,8BAA0B,8CAA2B,kBAAkB;AAC7E,UAAM,6BAAyB,6CAA0B,aAAa;AACtE,UAAM,0BAAsB,6CAA0B;AAEtD,UAAM,UAAU;AAAA,UACZ,0BAAU,2CAAyB,iDAA+B;AAAA,UAClE,0BAAU,2CAAyB,eAAe;AAAA,UAClD,0BAAU,2CAAyB,uBAAuB;AAAA,UAC1D,0BAAU,2CAAyB,sBAAsB;AAAA,UACzD,0BAAU,2CAAyB,mBAAmB;AAAA,UACtD,0BAAU,mDAAiC,KAAK,KAAK;AAAA,UACrD,0BAAU,iBAAiB,KAAK,KAAK;AAAA,UACrC,0BAAU,yBAAyB,KAAK,KAAK;AAAA,UAC7C,0BAAU,wBAAwB,KAAK,KAAK;AAAA,UAC5C,0BAAU,qBAAqB,KAAK,KAAK;AAAA,IAC7C;AAEA,QAAI,CAAC,KAAK,iBAAiB;AACvB,cAAQ,SAAK,0BAAU,2CAAyB,WAAW,OAAG,0BAAU,aAAa,KAAK,KAAK,CAAC;AAAA,IACpG;AAEA,WAAO;AAAA,EACX;AAAA,EAEA,IAAa,YAAY;AACrB,UAAM;AAAA,MACF;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,MACA,cAAc;AAAA,MACd;AAAA,IACJ,IAAI,KAAK;AAET,UAAM,SAAkC;AAAA,MACpC,IAAI;AAAA,MACJ,IAAI;AAAA,MACJ,GAAG;AAAA,MACH,IAAI;AAAA,MACJ,IAAI,iDAAwB,OAAO,WAAW;AAAA,MAC9C,IAAI;AAAA,IACR;AAEA,QAAI,CAAC,KAAK,iBAAiB;AACvB,aAAO,KAAK,GAAG,QAAQ,IAAI,SAAS;AAAA,IACxC;AAEA,WAAO;AAAA,EACX;AAAA,EAES,YAAY,OAAsB;AAEvC,WAAO,MAAM,gBAAgB;AAAA,EACjC;AAAA,EAEA,+BAA+B;AAC3B,UAAM,EAAE,aAAa,oBAAoB,IAAI,KAAK;AAElD,UAAM,oBACF,eAAe,sDAAoC,KAAK,UAAQ,YAAY,IAAI,MAAM,IAAI;AAE9F,QAAI,qBAAqB,CAAC,qBAAqB;AAC3C,YAAM,IAAI;AAAA,QACN,2DAA2D,iBAAiB;AAAA,MAChF;AAAA,IACJ;AAAA,EACJ;AACJ;",
+  "names": []
+}

package/dist/cjs/advertisement/mdns/CommissionerMdnsAdvertisement.d.ts

@@ -0,0 +1,20 @@
+/**
+ * @license
+ * Copyright 2022-2025 Matter.js Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import type { Advertisement } from "#advertisement/Advertisement.js";
+import { ServiceDescription } from "#advertisement/ServiceDescription.js";
+import { MdnsAdvertisement } from "./MdnsAdvertisement.js";
+import type { MdnsAdvertiser } from "./MdnsAdvertiser.js";
+/**
+ * Advertise a node as a commissioner service.
+ */
+export declare class CommissionerMdnsAdvertisement extends MdnsAdvertisement<ServiceDescription.Commissioner> {
+    instanceId: string;
+    constructor(advertiser: MdnsAdvertiser, description: ServiceDescription.Commissioner);
+    get ptrRecords(): import("#general").DnsRecord<string>[];
+    get txtValues(): Record<string, unknown>;
+    isDuplicate(other: Advertisement): other is Advertisement<ServiceDescription.Commissionable> | Advertisement<ServiceDescription.Commissioner>;
+}
+//# sourceMappingURL=CommissionerMdnsAdvertisement.d.ts.map

package/dist/cjs/advertisement/mdns/CommissionerMdnsAdvertisement.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"CommissionerMdnsAdvertisement.d.ts","sourceRoot":"","sources":["../../../../src/advertisement/mdns/CommissionerMdnsAdvertisement.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,iCAAiC,CAAC;AACrE,OAAO,EAAE,kBAAkB,EAAE,MAAM,sCAAsC,CAAC;AAO1E,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAC3D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAE1D;;GAEG;AACH,qBAAa,6BAA8B,SAAQ,iBAAiB,CAAC,kBAAkB,CAAC,YAAY,CAAC;IACjG,UAAU,EAAE,MAAM,CAAC;gBAEP,UAAU,EAAE,cAAc,EAAE,WAAW,EAAE,kBAAkB,CAAC,YAAY;IASpF,IAAa,UAAU,2CAmBtB;IAED,IAAa,SAAS,4BAarB;IAEQ,WAAW,CAAC,KAAK,EAAE,aAAa;CAI5C"}

package/dist/cjs/advertisement/mdns/CommissionerMdnsAdvertisement.js

@@ -0,0 +1,70 @@
+"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 CommissionerMdnsAdvertisement_exports = {};
+__export(CommissionerMdnsAdvertisement_exports, {
+  CommissionerMdnsAdvertisement: () => CommissionerMdnsAdvertisement
+});
+module.exports = __toCommonJS(CommissionerMdnsAdvertisement_exports);
+var import_general = require("#general");
+var import_MdnsConsts = require("#mdns/MdnsConsts.js");
+var import_MdnsAdvertisement = require("./MdnsAdvertisement.js");
+/**
+ * @license
+ * Copyright 2022-2025 Matter.js Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+class CommissionerMdnsAdvertisement extends import_MdnsAdvertisement.MdnsAdvertisement {
+  instanceId;
+  constructor(advertiser, description) {
+    const instanceId = advertiser.createInstanceId();
+    const qname = (0, import_MdnsConsts.getCommissionerDeviceQname)(instanceId);
+    super(advertiser, qname, description);
+    this.instanceId = instanceId;
+  }
+  get ptrRecords() {
+    const { deviceType, vendorId } = this.description;
+    const vendorQname = `_V${vendorId}._sub.${import_MdnsConsts.MATTER_COMMISSIONER_SERVICE_QNAME}`;
+    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, this.qname)
+    ];
+    if (deviceType !== void 0) {
+      const deviceTypeQname = `_T${deviceType}._sub.${import_MdnsConsts.MATTER_COMMISSIONER_SERVICE_QNAME}`;
+      records.push((0, import_general.PtrRecord)(import_MdnsConsts.SERVICE_DISCOVERY_QNAME, deviceTypeQname));
+      records.push((0, import_general.PtrRecord)(deviceTypeQname, this.qname));
+    }
+    return records;
+  }
+  get txtValues() {
+    const { vendorId, productId, deviceType, name: deviceName } = this.description;
+    const values = {
+      DN: deviceName,
+      DT: deviceType
+    };
+    if (!this.isPrivacyMasked) {
+      values.VP = `${vendorId}+${productId}`;
+    }
+    return values;
+  }
+  isDuplicate(other) {
+    return other.isCommissioning();
+  }
+}
+//# sourceMappingURL=CommissionerMdnsAdvertisement.js.map

package/dist/cjs/advertisement/mdns/CommissionerMdnsAdvertisement.js.map

@@ -0,0 +1,6 @@
+{
+  "version": 3,
+  "sources": ["../../../../src/advertisement/mdns/CommissionerMdnsAdvertisement.ts"],
+  "mappings": ";;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAQA,qBAA0B;AAC1B,wBAIO;AACP,+BAAkC;AAdlC;AAAA;AAAA;AAAA;AAAA;AAoBO,MAAM,sCAAsC,2CAAmD;AAAA,EAClG;AAAA,EAEA,YAAY,YAA4B,aAA8C;AAClF,UAAM,aAAa,WAAW,iBAAiB;AAC/C,UAAM,YAAQ,8CAA2B,UAAU;AAEnD,UAAM,YAAY,OAAO,WAAW;AAEpC,SAAK,aAAa;AAAA,EACtB;AAAA,EAEA,IAAa,aAAa;AACtB,UAAM,EAAE,YAAY,SAAS,IAAI,KAAK;AAEtC,UAAM,cAAc,KAAK,QAAQ,SAAS,mDAAiC;AAE3E,UAAM,UAAU;AAAA,UACZ,0BAAU,2CAAyB,mDAAiC;AAAA,UACpE,0BAAU,qDAAmC,WAAW;AAAA,UACxD,0BAAU,aAAa,KAAK,KAAK;AAAA,IACrC;AAEA,QAAI,eAAe,QAAW;AAC1B,YAAM,kBAAkB,KAAK,UAAU,SAAS,mDAAiC;AAEjF,cAAQ,SAAK,0BAAU,2CAAyB,eAAe,CAAC;AAChE,cAAQ,SAAK,0BAAU,iBAAiB,KAAK,KAAK,CAAC;AAAA,IACvD;AAEA,WAAO;AAAA,EACX;AAAA,EAEA,IAAa,YAAY;AACrB,UAAM,EAAE,UAAU,WAAW,YAAY,MAAM,WAAW,IAAI,KAAK;AAEnE,UAAM,SAAkC;AAAA,MACpC,IAAI;AAAA,MACJ,IAAI;AAAA,IACR;AAEA,QAAI,CAAC,KAAK,iBAAiB;AACvB,aAAO,KAAK,GAAG,QAAQ,IAAI,SAAS;AAAA,IACxC;AAEA,WAAO;AAAA,EACX;AAAA,EAES,YAAY,OAAsB;AAEvC,WAAO,MAAM,gBAAgB;AAAA,EACjC;AACJ;",
+  "names": []
+}

package/dist/cjs/advertisement/mdns/MdnsAdvertisement.d.ts

@@ -0,0 +1,40 @@
+/**
+ * @license
+ * Copyright 2022-2025 Matter.js Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { Advertisement } from "#advertisement/Advertisement.js";
+import type { Advertiser } from "#advertisement/Advertiser.js";
+import type { ServiceDescription } from "#advertisement/ServiceDescription.js";
+import { DnsRecord } from "#general";
+import type { MdnsAdvertiser } from "./MdnsAdvertiser.js";
+/**
+ * Base class for MDNS advertisements.
+ *
+ * Individual classes specialize for each type of service.
+ */
+export declare abstract class MdnsAdvertisement<T extends ServiceDescription = ServiceDescription> extends Advertisement<T> {
+    #private;
+    advertiser: MdnsAdvertiser;
+    /**
+     * The device qname.
+     */
+    qname: string;
+    constructor(advertiser: MdnsAdvertiser, qname: string, description: T);
+    protected abstract ptrRecords: DnsRecord[];
+    protected get txtValues(): Record<string, unknown>;
+    run(context: Advertisement.ActivityContext, event?: Advertiser.BroadcastEvent): Promise<void>;
+    /**
+     * Broadcast a single announcement immediately.
+     */
+    broadcast(): Promise<void>;
+    /**
+     * Broadcast expiration announcement immediately.
+     */
+    expire(): Promise<void>;
+    serviceConnected(): void;
+    serviceDisconnected(): void;
+    protected onCreate(): Promise<void>;
+    protected onClose(): Promise<void>;
+}
+//# sourceMappingURL=MdnsAdvertisement.d.ts.map

package/dist/cjs/advertisement/mdns/MdnsAdvertisement.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"MdnsAdvertisement.d.ts","sourceRoot":"","sources":["../../../../src/advertisement/mdns/MdnsAdvertisement.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,aAAa,EAAE,MAAM,iCAAiC,CAAC;AAChE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,8BAA8B,CAAC;AAC/D,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,sCAAsC,CAAC;AAE/E,OAAO,EAAuB,SAAS,EAA+D,MAAM,UAAU,CAAC;AAGvH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAI1D;;;;GAIG;AACH,8BAAsB,iBAAiB,CAAC,CAAC,SAAS,kBAAkB,GAAG,kBAAkB,CAAE,SAAQ,aAAa,CAAC,CAAC,CAAC;;IACvG,UAAU,EAAE,cAAc,CAAC;IAEnC;;OAEG;IACH,KAAK,EAAE,MAAM,CAAC;gBAKF,UAAU,EAAE,cAAc,EAAE,KAAK,EAAE,MAAM,EAAE,WAAW,EAAE,CAAC;IAUrE,SAAS,CAAC,QAAQ,CAAC,UAAU,EAAE,SAAS,EAAE,CAAC;IAE3C,SAAS,KAAK,SAAS,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAEjD;IAEc,GAAG,CAAC,OAAO,EAAE,aAAa,CAAC,eAAe,EAAE,KAAK,GAAE,UAAU,CAAC,cAA0B;IAevG;;OAEG;IACG,SAAS;IASf;;OAEG;IACG,MAAM;IAKH,gBAAgB;IAehB,mBAAmB;cAIH,QAAQ;cASR,OAAO;CAsDnC"}

package/dist/cjs/advertisement/mdns/MdnsAdvertisement.js

@@ -0,0 +1,145 @@
+"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 MdnsAdvertisement_exports = {};
+__export(MdnsAdvertisement_exports, {
+  MdnsAdvertisement: () => MdnsAdvertisement
+});
+module.exports = __toCommonJS(MdnsAdvertisement_exports);
+var import_Advertisement = require("#advertisement/Advertisement.js");
+var import_SupportedTransportsBitmap = require("#common/SupportedTransportsBitmap.js");
+var import_general = require("#general");
+var import_SessionIntervals = require("#session/SessionIntervals.js");
+/**
+ * @license
+ * Copyright 2022-2025 Matter.js Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+const logger = import_general.Logger.get("MdnsAdvertisement");
+class MdnsAdvertisement extends import_Advertisement.Advertisement {
+  /**
+   * The device qname.
+   */
+  qname;
+  #isPrivacyMasked;
+  #stopAt;
+  constructor(advertiser, qname, description) {
+    description = {
+      ...description,
+      ...(0, import_SessionIntervals.SessionIntervals)(description)
+    };
+    super(advertiser, `mdns:${qname}`, description, { omitPrivateDetails: advertiser.omitPrivateDetails });
+    this.qname = qname;
+    this.#isPrivacyMasked = this.isPrivacyMasked;
+  }
+  get txtValues() {
+    return {};
+  }
+  async run(context, event = "startup") {
+    this.#stopAt = void 0;
+    let number = 0;
+    for (const retryInterval of this.advertiser.broadcastScheduleFor(this, event)) {
+      if (this.#stopAt !== void 0 && this.#stopAt <= import_general.Time.nowMs()) {
+        break;
+      }
+      number++;
+      logger.debug("Broadcast", this.dict({ number, next: retryInterval }));
+      await this.broadcast();
+      await context.sleep("MDNS repeat", retryInterval);
+    }
+  }
+  /**
+   * Broadcast a single announcement immediately.
+   */
+  async broadcast() {
+    if (!this.#isPrivacyMasked && this.isPrivacyMasked) {
+      this.#isPrivacyMasked = true;
+      await this.advertiser.server.setRecordsGenerator(this.service, this.#recordsGenerator);
+    }
+    await this.advertiser.server.broadcast(this.service);
+  }
+  /**
+   * Broadcast expiration announcement immediately.
+   */
+  async expire() {
+    logger.info("Unpublishing", this.dict({ time: this.duration }));
+    await this.advertiser.server.expireAnnouncements(this.service);
+  }
+  serviceConnected() {
+    const { broadcastAfterConnection } = this.advertiser.broadcastConfigFor(this);
+    if (broadcastAfterConnection === void 0) {
+      return;
+    }
+    if (broadcastAfterConnection <= 0) {
+      this.stop();
+      return;
+    }
+    this.#stopAt = import_general.Time.nowMs() + broadcastAfterConnection;
+  }
+  serviceDisconnected() {
+    this.start("reconnect");
+  }
+  async onCreate() {
+    await Promise.resolve().then(() => {
+      logger.info("Publishing", this.dict());
+      return this.advertiser.server.setRecordsGenerator(this.service, this.#recordsGenerator);
+    });
+  }
+  async onClose() {
+    await this.expire();
+  }
+  get #recordsGenerator() {
+    return (_intf, addrs) => this.#recordsFor(addrs);
+  }
+  #recordsFor(addrs) {
+    const hostname = addrs.mac.replace(/:/g, "").toUpperCase() + "0000.local";
+    const records = [
+      ...this.ptrRecords,
+      (0, import_general.SrvRecord)(this.qname, { priority: 0, weight: 0, port: this.advertiser.port, target: hostname }),
+      (0, import_general.TxtRecord)(
+        this.qname,
+        Object.entries(this.#txtValues).filter(([, v]) => v !== void 0).map(([k, v]) => `${k}=${v}`)
+      )
+    ];
+    for (const addr of addrs.ipV6) {
+      records.push((0, import_general.AAAARecord)(hostname, addr));
+    }
+    if (this.advertiser.server.supportsIpv4) {
+      for (const addr of addrs.ipV4) {
+        records.push((0, import_general.ARecord)(hostname, addr));
+      }
+    }
+    return records;
+  }
+  get #txtValues() {
+    const values = {
+      SII: this.description.idleIntervalMs,
+      SAI: this.description.activeIntervalMs,
+      SAT: this.description.activeThresholdMs,
+      ...this.txtValues
+    };
+    if (this.description.tcp !== void 0) {
+      values.T = import_SupportedTransportsBitmap.SupportedTransportsSchema.encode(this.description.tcp);
+    }
+    if (this.description.icd !== void 0) {
+      values.ICD = this.description.icd;
+    }
+    return values;
+  }
+}
+//# sourceMappingURL=MdnsAdvertisement.js.map

package/dist/cjs/advertisement/mdns/MdnsAdvertisement.js.map

@@ -0,0 +1,6 @@
+{
+  "version": 3,
+  "sources": ["../../../../src/advertisement/mdns/MdnsAdvertisement.ts"],
+  "mappings": ";;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAMA,2BAA8B;AAG9B,uCAA0C;AAC1C,qBAA4G;AAE5G,8BAAiC;AAZjC;AAAA;AAAA;AAAA;AAAA;AAeA,MAAM,SAAS,sBAAO,IAAI,mBAAmB;AAOtC,MAAe,0BAA6E,mCAAiB;AAAA;AAAA;AAAA;AAAA,EAMhH;AAAA,EAEA;AAAA,EACA;AAAA,EAEA,YAAY,YAA4B,OAAe,aAAgB;AACnE,kBAAc;AAAA,MACV,GAAG;AAAA,MACH,OAAG,0CAAiB,WAAW;AAAA,IACnC;AACA,UAAM,YAAY,QAAQ,KAAK,IAAI,aAAa,EAAE,oBAAoB,WAAW,mBAAmB,CAAC;AACrG,SAAK,QAAQ;AACb,SAAK,mBAAmB,KAAK;AAAA,EACjC;AAAA,EAIA,IAAc,YAAqC;AAC/C,WAAO,CAAC;AAAA,EACZ;AAAA,EAEA,MAAe,IAAI,SAAwC,QAAmC,WAAW;AACrG,SAAK,UAAU;AACf,QAAI,SAAS;AACb,eAAW,iBAAiB,KAAK,WAAW,qBAAqB,MAAM,KAAK,GAAG;AAC3E,UAAI,KAAK,YAAY,UAAa,KAAK,WAAW,oBAAK,MAAM,GAAG;AAC5D;AAAA,MACJ;AAEA;AACA,aAAO,MAAM,aAAa,KAAK,KAAK,EAAE,QAAQ,MAAM,cAAc,CAAC,CAAC;AACpE,YAAM,KAAK,UAAU;AACrB,YAAM,QAAQ,MAAM,eAAe,aAAa;AAAA,IACpD;AAAA,EACJ;AAAA;AAAA;AAAA;AAAA,EAKA,MAAM,YAAY;AACd,QAAI,CAAC,KAAK,oBAAoB,KAAK,iBAAiB;AAChD,WAAK,mBAAmB;AACxB,YAAM,KAAK,WAAW,OAAO,oBAAoB,KAAK,SAAS,KAAK,iBAAiB;AAAA,IACzF;AAEA,UAAM,KAAK,WAAW,OAAO,UAAU,KAAK,OAAO;AAAA,EACvD;AAAA;AAAA;AAAA;AAAA,EAKA,MAAM,SAAS;AACX,WAAO,KAAK,gBAAgB,KAAK,KAAK,EAAE,MAAM,KAAK,SAAS,CAAC,CAAC;AAC9D,UAAM,KAAK,WAAW,OAAO,oBAAoB,KAAK,OAAO;AAAA,EACjE;AAAA,EAES,mBAAmB;AACxB,UAAM,EAAE,yBAAyB,IAAI,KAAK,WAAW,mBAAmB,IAAI;AAE5E,QAAI,6BAA6B,QAAW;AACxC;AAAA,IACJ;AAEA,QAAI,4BAA4B,GAAG;AAC/B,WAAK,KAAK;AACV;AAAA,IACJ;AAEA,SAAK,UAAU,oBAAK,MAAM,IAAI;AAAA,EAClC;AAAA,EAES,sBAAsB;AAC3B,SAAK,MAAM,WAAW;AAAA,EAC1B;AAAA,EAEA,MAAyB,WAAW;AAEhC,UAAM,QAAQ,QAAQ,EAAE,KAAK,MAAM;AAE/B,aAAO,KAAK,cAAc,KAAK,KAAK,CAAC;AACrC,aAAO,KAAK,WAAW,OAAO,oBAAoB,KAAK,SAAS,KAAK,iBAAiB;AAAA,IAC1F,CAAC;AAAA,EACL;AAAA,EAEA,MAAyB,UAAU;AAE/B,UAAM,KAAK,OAAO;AAAA,EACtB;AAAA,EAEA,IAAI,oBAAgD;AAChD,WAAO,CAAC,OAAO,UAAU,KAAK,YAAY,KAAK;AAAA,EACnD;AAAA,EAEA,YAAY,OAAgC;AACxC,UAAM,WAAW,MAAM,IAAI,QAAQ,MAAM,EAAE,EAAE,YAAY,IAAI;AAE7D,UAAM,UAAuB;AAAA,MACzB,GAAG,KAAK;AAAA,UACR,0BAAU,KAAK,OAAO,EAAE,UAAU,GAAG,QAAQ,GAAG,MAAM,KAAK,WAAW,MAAM,QAAQ,SAAS,CAAC;AAAA,UAC9F;AAAA,QACI,KAAK;AAAA,QACL,OAAO,QAAQ,KAAK,UAAU,EACzB,OAAO,CAAC,CAAC,EAAE,CAAC,MAAM,MAAM,MAAS,EACjC,IAAI,CAAC,CAAC,GAAG,CAAC,MAAM,GAAG,CAAC,IAAI,CAAC,EAAE;AAAA,MACpC;AAAA,IACJ;AAEA,eAAW,QAAQ,MAAM,MAAM;AAC3B,cAAQ,SAAK,2BAAW,UAAU,IAAI,CAAC;AAAA,IAC3C;AAEA,QAAI,KAAK,WAAW,OAAO,cAAc;AACrC,iBAAW,QAAQ,MAAM,MAAM;AAC3B,gBAAQ,SAAK,wBAAQ,UAAU,IAAI,CAAC;AAAA,MACxC;AAAA,IACJ;AAEA,WAAO;AAAA,EACX;AAAA,EAEA,IAAI,aAAa;AACb,UAAM,SAAkC;AAAA,MACpC,KAAK,KAAK,YAAY;AAAA,MACtB,KAAK,KAAK,YAAY;AAAA,MACtB,KAAK,KAAK,YAAY;AAAA,MACtB,GAAG,KAAK;AAAA,IACZ;AAEA,QAAI,KAAK,YAAY,QAAQ,QAAW;AACpC,aAAO,IAAI,2DAA0B,OAAO,KAAK,YAAY,GAAG;AAAA,IACpE;AAEA,QAAI,KAAK,YAAY,QAAQ,QAAW;AACpC,aAAO,MAAM,KAAK,YAAY;AAAA,IAClC;AAEA,WAAO;AAAA,EACX;AACJ;",
+  "names": []
+}

package/dist/cjs/advertisement/mdns/MdnsAdvertiser.d.ts

@@ -0,0 +1,99 @@
+/**
+ * @license
+ * Copyright 2022-2025 Matter.js Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { Advertiser } from "#advertisement/Advertiser.js";
+import { ServiceDescription } from "#advertisement/ServiceDescription.js";
+import { Crypto, RetrySchedule } from "#general";
+import type { MdnsServer } from "#mdns/MdnsServer.js";
+import { DatatypeModel } from "#model";
+import type { MdnsAdvertisement } from "./MdnsAdvertisement.js";
+/**
+ * An {@link Advertiser} that advertises using an in-process MDNS implementation.
+ */
+export declare class MdnsAdvertiser extends Advertiser {
+    #private;
+    readonly crypto: Crypto;
+    readonly server: MdnsServer;
+    readonly port: number;
+    readonly omitPrivateDetails: boolean;
+    constructor(crypto: Crypto, server: MdnsServer, options?: MdnsAdvertiser.Options);
+    /**
+     * Create an advertisement for the specific service.
+     */
+    getAdvertisement(description: ServiceDescription): MdnsAdvertisement | undefined;
+    /**
+     * Generate a random 8-byte Matter instance identifier.
+     */
+    createInstanceId(): string;
+    /**
+     * Retrieve the broadcast schedule for a specific advertisement.
+     */
+    broadcastScheduleFor(advertisement: MdnsAdvertisement, event?: Advertiser.BroadcastEvent): RetrySchedule;
+    /**
+     * Retrieve broadcast configuration for a specific advertisement.
+     */
+    broadcastConfigFor(advertisement: MdnsAdvertisement, event?: Advertiser.BroadcastEvent): MdnsAdvertiser.BroadcastSchedule;
+}
+export declare namespace MdnsAdvertiser {
+    /**
+     * MDNS advertisement configuration options.
+     */
+    interface Options {
+        /**
+         * The port of the Matter service to advertise.
+         *
+         * Defaults to 5540.
+         */
+        readonly port?: number;
+        /**
+         * Omit the vendor and product ID from announcements for privacy reasons.
+         */
+        readonly omitPrivateDetails?: boolean;
+        /**
+         * Broadcast schedule.
+         *
+         * These control the intervals at which the server broadcasts the advertisement.  Note that order is important;
+         * more specific schedules should appear first.
+         *
+         * By default all broadcasts are configured using {@link DefaultBroadcastSchedule}.
+         */
+        readonly schedules?: readonly BroadcastSchedule[];
+    }
+    /**
+     * Schedule for automatic broadcasts.
+     *
+     * Schedules apply conditionally with {@link DefaultBroadcastSchedule} as the fallback.
+     */
+    interface BroadcastSchedule extends RetrySchedule.Configuration {
+        /**
+         * Limit this schedule to a particular service kind.
+         */
+        readonly serviceKind?: ServiceDescription["kind"];
+        /**
+         * Limit this schedule to initial broadcast or broadcast when reconnecting.
+         */
+        readonly event?: Advertiser.BroadcastEvent;
+        /**
+         * Extra time to broadcast after establishing an operational connection.
+         *
+         * Set to zero to terminate broadcast immediately after connection.  If undefined broadcasts will continue until
+         * terminated by {@link timeout} or {@link maximumCount}.
+         */
+        readonly broadcastAfterConnection?: number;
+    }
+    /**
+     * Default schedule for automatic broadcast.
+     */
+    const DefaultBroadcastSchedule: BroadcastSchedule;
+    /**
+     * Default schedule for retransmission broadcast.
+     */
+    const RetransmissionBroadcastSchedule: BroadcastSchedule;
+    /**
+     * Data model for MDNS advertiser configuration.
+     */
+    const OptionsSchema: DatatypeModel;
+}
+//# sourceMappingURL=MdnsAdvertiser.d.ts.map

package/dist/cjs/advertisement/mdns/MdnsAdvertiser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"MdnsAdvertiser.d.ts","sourceRoot":"","sources":["../../../../src/advertisement/mdns/MdnsAdvertiser.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,8BAA8B,CAAC;AAC1D,OAAO,EAAE,kBAAkB,EAAE,MAAM,sCAAsC,CAAC;AAC1E,OAAO,EAAS,MAAM,EAAsC,aAAa,EAAwB,MAAM,UAAU,CAAC;AAClH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AACtD,OAAO,EAAE,aAAa,EAAgB,MAAM,QAAQ,CAAC;AAIrD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAGhE;;GAEG;AACH,qBAAa,cAAe,SAAQ,UAAU;;IAOtC,QAAQ,CAAC,MAAM,EAAE,MAAM;IACvB,QAAQ,CAAC,MAAM,EAAE,UAAU;IAP/B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,kBAAkB,EAAE,OAAO,CAAC;gBAKxB,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,UAAU,EAC3B,OAAO,CAAC,EAAE,cAAc,CAAC,OAAO;IAkCpC;;OAEG;IACM,gBAAgB,CAAC,WAAW,EAAE,kBAAkB,GAAG,iBAAiB,GAAG,SAAS;IAqBzF;;OAEG;IACH,gBAAgB;IAIhB;;OAEG;IACH,oBAAoB,CAAC,aAAa,EAAE,iBAAiB,EAAE,KAAK,CAAC,EAAE,UAAU,CAAC,cAAc;IAaxF;;OAEG;IACH,kBAAkB,CAAC,aAAa,EAAE,iBAAiB,EAAE,KAAK,CAAC,EAAE,UAAU,CAAC,cAAc;CAyBzF;AAED,yBAAiB,cAAc,CAAC;IAC5B;;OAEG;IACH,UAAiB,OAAO;QACpB;;;;WAIG;QACH,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;QAEvB;;WAEG;QACH,QAAQ,CAAC,kBAAkB,CAAC,EAAE,OAAO,CAAC;QAEtC;;;;;;;WAOG;QACH,QAAQ,CAAC,SAAS,CAAC,EAAE,SAAS,iBAAiB,EAAE,CAAC;KACrD;IAED;;;;OAIG;IACH,UAAiB,iBAAkB,SAAQ,aAAa,CAAC,aAAa;QAClE;;WAEG;QACH,QAAQ,CAAC,WAAW,CAAC,EAAE,kBAAkB,CAAC,MAAM,CAAC,CAAC;QAElD;;WAEG;QACH,QAAQ,CAAC,KAAK,CAAC,EAAE,UAAU,CAAC,cAAc,CAAC;QAE3C;;;;;WAKG;QACH,QAAQ,CAAC,wBAAwB,CAAC,EAAE,MAAM,CAAC;KAC9C;IAED;;OAEG;IACI,MAAM,wBAAwB,EAAE,iBAmBtC,CAAC;IAEF;;OAEG;IACI,MAAM,+BAA+B,EAAE,iBAK7C,CAAC;IAEF;;OAEG;IACI,MAAM,aAAa,eAgBzB,CAAC;CACL"}