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

package/dist/esm/advertisement/ble/BleAdvertiser.js.map

@@ -0,0 +1,6 @@
+{
+  "version": 3,
+  "sources": ["../../../../src/advertisement/ble/BleAdvertiser.ts"],
+  "mappings": "AAAA;AAAA;AAAA;AAAA;AAAA;AAOA,SAAS,2BAA2B;AACpC,SAAS,eAAe,oBAAoB;AAC5C,SAAS,uCAAuC;AAEhD,SAAS,kBAAkB;AAC3B,SAAS,yBAAyB;AAElC,SAAS,wBAAwB;AAE1B,MAAM,sBAAsB,WAAW;AAAA,EAC1C;AAAA,EACA;AAAA,EACA,YAAY;AAAA,EAEZ,YAAY,YAAoC,SAAiC;AAC7E,UAAM;AAEN,SAAK,cAAc;AACnB,SAAK,UAAU,cAAc,cAAc,OAAO;AAAA,EACtD;AAAA,EAEA,IAAI,aAAa;AACb,WAAO,KAAK;AAAA,EAChB;AAAA,EAEA,IAAI,SAAS;AACT,WAAO,KAAK;AAAA,EAChB;AAAA,EAEA,iBAAiB,aAA4D;AACzE,SAAK,YAAY;AAEjB,QAAI,YAAY,SAAS,oBAAoB,YAAY,SAAS,kBAAkB,OAAO;AACvF;AAAA,IACJ;AAEA,WAAO,IAAI,iBAAiB,MAAM,WAAW;AAAA,EACjD;AAAA,EAEA,cAAc;AACV,QAAI,KAAK,WAAW;AAChB,YAAM,IAAI,oBAAoB,4CAA4C;AAAA,IAC9E;AAAA,EACJ;AACJ;AAAA,CAEO,CAAUA,mBAAV;AAyCI,WAAS,cAAc,SAAmB;AAC7C,WAAO;AAAA,MACH,SAAS;AAAA,MACT,eAAe;AAAA,MACf,cAAc;AAAA,MACd,kBAAkB;AAAA,MAClB,GAAG;AAAA,IACP;AAAA,EACJ;AARO,EAAAA,eAAS;AAaT,EAAMA,eAAA,gBAAgB,IAAI;AAAA,IAC7B,EAAE,MAAM,wBAAwB,MAAM,SAAS;AAAA,IAC/C,aAAa,EAAE,MAAM,OAAO,MAAM,SAAS,CAAC;AAAA,IAC5C,aAAa,EAAE,MAAM,WAAW,MAAM,SAAS,CAAC;AAAA,IAChD,aAAa,EAAE,MAAM,iBAAiB,MAAM,SAAS,CAAC;AAAA,IACtD,aAAa,EAAE,MAAM,gBAAgB,MAAM,SAAS,CAAC;AAAA,IACrD,aAAa,EAAE,MAAM,oBAAoB,MAAM,SAAS,CAAC;AAAA,EAC7D;AAAA,GA7Da;",
+  "names": ["BleAdvertiser"]
+}

package/dist/esm/advertisement/ble/index.d.ts

@@ -0,0 +1,8 @@
+/**
+ * @license
+ * Copyright 2022-2025 Matter.js Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+export * from "./BleAdvertisement.js";
+export * from "./BleAdvertiser.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/esm/advertisement/ble/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/advertisement/ble/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,cAAc,uBAAuB,CAAC;AACtC,cAAc,oBAAoB,CAAC"}

package/dist/esm/advertisement/ble/index.js

@@ -0,0 +1,8 @@
+/**
+ * @license
+ * Copyright 2022-2025 Matter.js Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+export * from "./BleAdvertisement.js";
+export * from "./BleAdvertiser.js";
+//# sourceMappingURL=index.js.map

package/dist/esm/advertisement/ble/index.js.map

@@ -0,0 +1,6 @@
+{
+  "version": 3,
+  "sources": ["../../../../src/advertisement/ble/index.ts"],
+  "mappings": "AAAA;AAAA;AAAA;AAAA;AAAA;AAMA,cAAc;AACd,cAAc;",
+  "names": []
+}

package/dist/esm/advertisement/index.d.ts

@@ -0,0 +1,13 @@
+/**
+ * @license
+ * Copyright 2022-2025 Matter.js Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+export * from "./Advertisement.js";
+export * from "./Advertiser.js";
+export * from "./ble/index.js";
+export * from "./CommissioningMode.js";
+export * from "./mdns/index.js";
+export * from "./PairingHintBitmap.js";
+export * from "./ServiceDescription.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/esm/advertisement/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/advertisement/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,cAAc,oBAAoB,CAAC;AACnC,cAAc,iBAAiB,CAAC;AAChC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,wBAAwB,CAAC;AACvC,cAAc,iBAAiB,CAAC;AAChC,cAAc,wBAAwB,CAAC;AACvC,cAAc,yBAAyB,CAAC"}

package/dist/esm/advertisement/index.js

@@ -0,0 +1,13 @@
+/**
+ * @license
+ * Copyright 2022-2025 Matter.js Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+export * from "./Advertisement.js";
+export * from "./Advertiser.js";
+export * from "./ble/index.js";
+export * from "./CommissioningMode.js";
+export * from "./mdns/index.js";
+export * from "./PairingHintBitmap.js";
+export * from "./ServiceDescription.js";
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1,6 @@
+{
+  "version": 3,
+  "sources": ["../../../src/advertisement/index.ts"],
+  "mappings": "AAAA;AAAA;AAAA;AAAA;AAAA;AAMA,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;",
+  "names": []
+}

package/dist/esm/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/esm/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/esm/advertisement/mdns/CommissionableMdnsAdvertisement.js

@@ -0,0 +1,95 @@
+/**
+ * @license
+ * Copyright 2022-2025 Matter.js Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { PairingHintBitmapSchema } from "#advertisement/PairingHintBitmap.js";
+import { ImplementationError, PtrRecord } from "#general";
+import {
+  DEFAULT_PAIRING_HINT,
+  getCommissionableDeviceQname,
+  getCommissioningModeQname,
+  getDeviceTypeQname,
+  getLongDiscriminatorQname,
+  getShortDiscriminatorQname,
+  getVendorQname,
+  MATTER_COMMISSION_SERVICE_QNAME,
+  PAIRING_HINTS_REQUIRING_INSTRUCTION,
+  SERVICE_DISCOVERY_QNAME
+} from "#mdns/MdnsConsts.js";
+import { MdnsAdvertisement } from "./MdnsAdvertisement.js";
+class CommissionableMdnsAdvertisement extends MdnsAdvertisement {
+  instanceId;
+  constructor(advertiser, description) {
+    const instanceId = advertiser.createInstanceId();
+    const qname = 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 = getVendorQname(vendorId);
+    const deviceTypeQname = getDeviceTypeQname(deviceType);
+    const shortDiscriminatorQname = getShortDiscriminatorQname(shortDiscriminator);
+    const longDiscriminatorQname = getLongDiscriminatorQname(discriminator);
+    const commissionModeQname = getCommissioningModeQname();
+    const records = [
+      PtrRecord(SERVICE_DISCOVERY_QNAME, MATTER_COMMISSION_SERVICE_QNAME),
+      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, this.qname),
+      PtrRecord(deviceTypeQname, this.qname),
+      PtrRecord(shortDiscriminatorQname, this.qname),
+      PtrRecord(longDiscriminatorQname, this.qname),
+      PtrRecord(commissionModeQname, this.qname)
+    ];
+    if (!this.isPrivacyMasked) {
+      records.push(PtrRecord(SERVICE_DISCOVERY_QNAME, vendorQname), PtrRecord(vendorQname, this.qname));
+    }
+    return records;
+  }
+  get txtValues() {
+    const {
+      vendorId,
+      productId,
+      deviceType,
+      name,
+      discriminator,
+      mode,
+      pairingHint = DEFAULT_PAIRING_HINT,
+      pairingInstructions
+    } = this.description;
+    const values = {
+      DN: name,
+      DT: deviceType,
+      D: discriminator,
+      CM: mode,
+      PH: 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 && PAIRING_HINTS_REQUIRING_INSTRUCTION.find((hint) => pairingHint[hint] === true);
+    if (needsInstructions && !pairingInstructions) {
+      throw new ImplementationError(
+        `Pairing instructions required for pairing hint of type "${needsInstructions}"`
+      );
+    }
+  }
+}
+export {
+  CommissionableMdnsAdvertisement
+};
+//# sourceMappingURL=CommissionableMdnsAdvertisement.js.map

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

@@ -0,0 +1,6 @@
+{
+  "version": 3,
+  "sources": ["../../../../src/advertisement/mdns/CommissionableMdnsAdvertisement.ts"],
+  "mappings": "AAAA;AAAA;AAAA;AAAA;AAAA;AAOA,SAAS,+BAA+B;AAExC,SAAS,qBAAqB,iBAAiB;AAC/C;AAAA,EACI;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OACG;AACP,SAAS,yBAAyB;AAM3B,MAAM,wCAAwC,kBAAqD;AAAA,EACtG;AAAA,EAEA,YAAY,YAA4B,aAAgD;AACpF,UAAM,aAAa,WAAW,iBAAiB;AAC/C,UAAM,QAAQ,6BAA6B,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,cAAc,eAAe,QAAQ;AAC3C,UAAM,kBAAkB,mBAAmB,UAAU;AACrD,UAAM,0BAA0B,2BAA2B,kBAAkB;AAC7E,UAAM,yBAAyB,0BAA0B,aAAa;AACtE,UAAM,sBAAsB,0BAA0B;AAEtD,UAAM,UAAU;AAAA,MACZ,UAAU,yBAAyB,+BAA+B;AAAA,MAClE,UAAU,yBAAyB,eAAe;AAAA,MAClD,UAAU,yBAAyB,uBAAuB;AAAA,MAC1D,UAAU,yBAAyB,sBAAsB;AAAA,MACzD,UAAU,yBAAyB,mBAAmB;AAAA,MACtD,UAAU,iCAAiC,KAAK,KAAK;AAAA,MACrD,UAAU,iBAAiB,KAAK,KAAK;AAAA,MACrC,UAAU,yBAAyB,KAAK,KAAK;AAAA,MAC7C,UAAU,wBAAwB,KAAK,KAAK;AAAA,MAC5C,UAAU,qBAAqB,KAAK,KAAK;AAAA,IAC7C;AAEA,QAAI,CAAC,KAAK,iBAAiB;AACvB,cAAQ,KAAK,UAAU,yBAAyB,WAAW,GAAG,UAAU,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,wBAAwB,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,oCAAoC,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/esm/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/esm/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/esm/advertisement/mdns/CommissionerMdnsAdvertisement.js

@@ -0,0 +1,54 @@
+/**
+ * @license
+ * Copyright 2022-2025 Matter.js Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { PtrRecord } from "#general";
+import {
+  getCommissionerDeviceQname,
+  MATTER_COMMISSIONER_SERVICE_QNAME,
+  SERVICE_DISCOVERY_QNAME
+} from "#mdns/MdnsConsts.js";
+import { MdnsAdvertisement } from "./MdnsAdvertisement.js";
+class CommissionerMdnsAdvertisement extends MdnsAdvertisement {
+  instanceId;
+  constructor(advertiser, description) {
+    const instanceId = advertiser.createInstanceId();
+    const qname = getCommissionerDeviceQname(instanceId);
+    super(advertiser, qname, description);
+    this.instanceId = instanceId;
+  }
+  get ptrRecords() {
+    const { deviceType, vendorId } = this.description;
+    const vendorQname = `_V${vendorId}._sub.${MATTER_COMMISSIONER_SERVICE_QNAME}`;
+    const records = [
+      PtrRecord(SERVICE_DISCOVERY_QNAME, MATTER_COMMISSIONER_SERVICE_QNAME),
+      PtrRecord(MATTER_COMMISSIONER_SERVICE_QNAME, vendorQname),
+      PtrRecord(vendorQname, this.qname)
+    ];
+    if (deviceType !== void 0) {
+      const deviceTypeQname = `_T${deviceType}._sub.${MATTER_COMMISSIONER_SERVICE_QNAME}`;
+      records.push(PtrRecord(SERVICE_DISCOVERY_QNAME, deviceTypeQname));
+      records.push(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();
+  }
+}
+export {
+  CommissionerMdnsAdvertisement
+};
+//# sourceMappingURL=CommissionerMdnsAdvertisement.js.map

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

@@ -0,0 +1,6 @@
+{
+  "version": 3,
+  "sources": ["../../../../src/advertisement/mdns/CommissionerMdnsAdvertisement.ts"],
+  "mappings": "AAAA;AAAA;AAAA;AAAA;AAAA;AAQA,SAAS,iBAAiB;AAC1B;AAAA,EACI;AAAA,EACA;AAAA,EACA;AAAA,OACG;AACP,SAAS,yBAAyB;AAM3B,MAAM,sCAAsC,kBAAmD;AAAA,EAClG;AAAA,EAEA,YAAY,YAA4B,aAA8C;AAClF,UAAM,aAAa,WAAW,iBAAiB;AAC/C,UAAM,QAAQ,2BAA2B,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,iCAAiC;AAE3E,UAAM,UAAU;AAAA,MACZ,UAAU,yBAAyB,iCAAiC;AAAA,MACpE,UAAU,mCAAmC,WAAW;AAAA,MACxD,UAAU,aAAa,KAAK,KAAK;AAAA,IACrC;AAEA,QAAI,eAAe,QAAW;AAC1B,YAAM,kBAAkB,KAAK,UAAU,SAAS,iCAAiC;AAEjF,cAAQ,KAAK,UAAU,yBAAyB,eAAe,CAAC;AAChE,cAAQ,KAAK,UAAU,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/esm/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/esm/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/esm/advertisement/mdns/MdnsAdvertisement.js

@@ -0,0 +1,125 @@
+/**
+ * @license
+ * Copyright 2022-2025 Matter.js Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { Advertisement } from "#advertisement/Advertisement.js";
+import { SupportedTransportsSchema } from "#common/SupportedTransportsBitmap.js";
+import { AAAARecord, ARecord, Logger, SrvRecord, Time, TxtRecord } from "#general";
+import { SessionIntervals } from "#session/SessionIntervals.js";
+const logger = Logger.get("MdnsAdvertisement");
+class MdnsAdvertisement extends Advertisement {
+  /**
+   * The device qname.
+   */
+  qname;
+  #isPrivacyMasked;
+  #stopAt;
+  constructor(advertiser, qname, description) {
+    description = {
+      ...description,
+      ...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 <= 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 = 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,
+      SrvRecord(this.qname, { priority: 0, weight: 0, port: this.advertiser.port, target: hostname }),
+      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(AAAARecord(hostname, addr));
+    }
+    if (this.advertiser.server.supportsIpv4) {
+      for (const addr of addrs.ipV4) {
+        records.push(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 = SupportedTransportsSchema.encode(this.description.tcp);
+    }
+    if (this.description.icd !== void 0) {
+      values.ICD = this.description.icd;
+    }
+    return values;
+  }
+}
+export {
+  MdnsAdvertisement
+};
+//# sourceMappingURL=MdnsAdvertisement.js.map

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

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

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