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

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

@@ -0,0 +1,50 @@
+/**
+ * @license
+ * Copyright 2022-2025 Matter.js Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import type { Fabric } from "#fabric/Fabric.js";
+import { Advertisement } from "./Advertisement.js";
+import type { ServiceDescription } from "./ServiceDescription.js";
+/**
+ * A component that advertises a Matter service.
+ */
+export declare abstract class Advertiser {
+    #private;
+    /**
+     * Begin advertising on configured schedule.
+     *
+     * Note that so long as the advertisement is installed the device will continue to respond to MDNS queries even if
+     * the advertisement schedule is elapsed.
+     *
+     * Returns undefined if the advertiser does not support this type of advertisement.
+     */
+    advertise(description: ServiceDescription, event: Advertiser.BroadcastEvent): Advertisement | undefined;
+    /**
+     * Create a new advertiser or retrieve existing advertiser.
+     */
+    protected abstract getAdvertisement(description: ServiceDescription): Advertisement | undefined;
+    /**
+     * Destroy the instance.
+     */
+    close(): Promise<void>;
+    /**
+     * The set of advertisements active for this advertiser.
+     */
+    get advertisements(): Set<Advertisement<ServiceDescription>>;
+    /**
+     * Obtain the active advertisement for {@link fabric}, if any.
+     */
+    advertisementForFabric(fabric: Fabric): Advertisement<ServiceDescription.Operational> | undefined;
+    /**
+     * Select advertisements using a predicate.
+     */
+    filter(predicate: (ad: Advertisement) => boolean): Advertisement<ServiceDescription>[];
+}
+export declare namespace Advertiser {
+    /**
+     * A hint for scheduling regarding why broadcast is initiated.
+     */
+    type BroadcastEvent = "startup" | "reconnect" | "retransmit";
+}
+//# sourceMappingURL=Advertiser.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"Advertiser.d.ts","sourceRoot":"","sources":["../../../src/advertisement/Advertiser.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACnD,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAElE;;GAEG;AACH,8BAAsB,UAAU;;IAI5B;;;;;;;OAOG;IACH,SAAS,CAAC,WAAW,EAAE,kBAAkB,EAAE,KAAK,EAAE,UAAU,CAAC,cAAc,GAAG,aAAa,GAAG,SAAS;IAavG;;OAEG;IACH,SAAS,CAAC,QAAQ,CAAC,gBAAgB,CAAC,WAAW,EAAE,kBAAkB,GAAG,aAAa,GAAG,SAAS;IAE/F;;OAEG;IACG,KAAK;IAKX;;OAEG;IACH,IAAI,cAAc,2CAEjB;IAED;;OAEG;IACH,sBAAsB,CAAC,MAAM,EAAE,MAAM;IAQrC;;OAEG;IACH,MAAM,CAAC,SAAS,EAAE,CAAC,EAAE,EAAE,aAAa,KAAK,OAAO;CAGnD;AAED,yBAAiB,UAAU,CAAC;IACxB;;OAEG;IACH,KAAY,cAAc,GAAG,SAAS,GAAG,WAAW,GAAG,YAAY,CAAC;CACvE"}

package/dist/esm/advertisement/Advertiser.js

@@ -0,0 +1,61 @@
+/**
+ * @license
+ * Copyright 2022-2025 Matter.js Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { Advertisement } from "./Advertisement.js";
+class Advertiser {
+  #advertisements = /* @__PURE__ */ new Set();
+  #isClosed = false;
+  /**
+   * Begin advertising on configured schedule.
+   *
+   * Note that so long as the advertisement is installed the device will continue to respond to MDNS queries even if
+   * the advertisement schedule is elapsed.
+   *
+   * Returns undefined if the advertiser does not support this type of advertisement.
+   */
+  advertise(description, event) {
+    if (this.#isClosed) {
+      return;
+    }
+    const ad = this.getAdvertisement(description);
+    if (ad) {
+      ad.start(event);
+    }
+    return ad;
+  }
+  /**
+   * Destroy the instance.
+   */
+  async close() {
+    this.#isClosed = true;
+    await Advertisement.closeAll(this.#advertisements);
+  }
+  /**
+   * The set of advertisements active for this advertiser.
+   */
+  get advertisements() {
+    return this.#advertisements;
+  }
+  /**
+   * Obtain the active advertisement for {@link fabric}, if any.
+   */
+  advertisementForFabric(fabric) {
+    for (const ad of this.#advertisements) {
+      if (ad.isOperational() && ad.description.fabric === fabric) {
+        return ad;
+      }
+    }
+  }
+  /**
+   * Select advertisements using a predicate.
+   */
+  filter(predicate) {
+    return [...this.#advertisements].filter(predicate);
+  }
+}
+export {
+  Advertiser
+};
+//# sourceMappingURL=Advertiser.js.map

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

@@ -0,0 +1,6 @@
+{
+  "version": 3,
+  "sources": ["../../../src/advertisement/Advertiser.ts"],
+  "mappings": "AAAA;AAAA;AAAA;AAAA;AAAA;AAOA,SAAS,qBAAqB;AAMvB,MAAe,WAAW;AAAA,EAC7B,kBAAkB,oBAAI,IAAmB;AAAA,EACzC,YAAY;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAUZ,UAAU,aAAiC,OAA6D;AACpG,QAAI,KAAK,WAAW;AAChB;AAAA,IACJ;AAEA,UAAM,KAAK,KAAK,iBAAiB,WAAW;AAC5C,QAAI,IAAI;AACJ,SAAG,MAAM,KAAK;AAAA,IAClB;AAEA,WAAO;AAAA,EACX;AAAA;AAAA;AAAA;AAAA,EAUA,MAAM,QAAQ;AACV,SAAK,YAAY;AACjB,UAAM,cAAc,SAAS,KAAK,eAAe;AAAA,EACrD;AAAA;AAAA;AAAA;AAAA,EAKA,IAAI,iBAAiB;AACjB,WAAO,KAAK;AAAA,EAChB;AAAA;AAAA;AAAA;AAAA,EAKA,uBAAuB,QAAgB;AACnC,eAAW,MAAM,KAAK,iBAAiB;AACnC,UAAI,GAAG,cAAc,KAAK,GAAG,YAAY,WAAW,QAAQ;AACxD,eAAO;AAAA,MACX;AAAA,IACJ;AAAA,EACJ;AAAA;AAAA;AAAA;AAAA,EAKA,OAAO,WAA2C;AAC9C,WAAO,CAAC,GAAG,KAAK,eAAe,EAAE,OAAO,SAAS;AAAA,EACrD;AACJ;",
+  "names": []
+}

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

@@ -0,0 +1,11 @@
+/**
+ * @license
+ * Copyright 2022-2025 Matter.js Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+export declare enum CommissioningMode {
+    NotCommissioning = 0,
+    Basic = 1,
+    Enhanced = 2
+}
+//# sourceMappingURL=CommissioningMode.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"CommissioningMode.d.ts","sourceRoot":"","sources":["../../../src/advertisement/CommissioningMode.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,oBAAY,iBAAiB;IACzB,gBAAgB,IAAI;IACpB,KAAK,IAAI;IACT,QAAQ,IAAI;CACf"}

package/dist/esm/advertisement/CommissioningMode.js

@@ -0,0 +1,15 @@
+/**
+ * @license
+ * Copyright 2022-2025 Matter.js Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+var CommissioningMode = /* @__PURE__ */ ((CommissioningMode2) => {
+  CommissioningMode2[CommissioningMode2["NotCommissioning"] = 0] = "NotCommissioning";
+  CommissioningMode2[CommissioningMode2["Basic"] = 1] = "Basic";
+  CommissioningMode2[CommissioningMode2["Enhanced"] = 2] = "Enhanced";
+  return CommissioningMode2;
+})(CommissioningMode || {});
+export {
+  CommissioningMode
+};
+//# sourceMappingURL=CommissioningMode.js.map

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

@@ -0,0 +1,6 @@
+{
+  "version": 3,
+  "sources": ["../../../src/advertisement/CommissioningMode.ts"],
+  "mappings": "AAAA;AAAA;AAAA;AAAA;AAAA;AAMO,IAAK,oBAAL,kBAAKA,uBAAL;AACH,EAAAA,sCAAA,sBAAmB,KAAnB;AACA,EAAAA,sCAAA,WAAQ,KAAR;AACA,EAAAA,sCAAA,cAAW,KAAX;AAHQ,SAAAA;AAAA,GAAA;",
+  "names": ["CommissioningMode"]
+}

package/dist/esm/{common/InstanceBroadcaster.d.ts → advertisement/PairingHintBitmap.d.ts}

@@ -3,8 +3,7 @@
  * Copyright 2022-2025 Matter.js Authors
  * SPDX-License-Identifier: Apache-2.0
  */
-import { BitFlag, ProductDescription, TypeFromPartialBitSchema, VendorId } from "#types";
-import { Fabric } from "../fabric/Fabric.js";
+import { BitFlag } from "@matter/types";
 export declare const PairingHintBitmap: {
     /**
      * The Device will automatically enter Commissioning Mode upon power cycle (unplug/re- plug, remove/re-insert
@@ -105,7 +104,7 @@ export declare const PairingHintBitmap: {
      */
     pressSetupButtonNumberOfTimes: BitFlag;
 };
-export declare const PairingHintBitmapSchema: import("#types").BitmapSchemaInternal<{
+export declare const PairingHintBitmapSchema: import("@matter/types").BitmapSchemaInternal<{
     /**
      * The Device will automatically enter Commissioning Mode upon power cycle (unplug/re- plug, remove/re-insert
      * batteries). This bit SHALL be set to 1 for devices using Standard Commissioning Flow, and set to 0 otherwise.
@@ -205,69 +204,4 @@ export declare const PairingHintBitmapSchema: import("#types").BitmapSchemaInter
      */
     pressSetupButtonNumberOfTimes: BitFlag;
 }>;
-export interface CommissioningModeInstanceData extends ProductDescription {
-    /** Device discriminator for commissionable announcements. */
-    discriminator: number;
-    /** Session Idle Interval of the device for commissionable announcements. */
-    sessionIdleInterval?: number;
-    /** Session Active Interval of the device for commissionable announcements. */
-    sessionActiveInterval?: number;
-    /** Duration of time the node should stay active after the last network activity. **/
-    sessionActiveThreshold?: number;
-    /** Pairing hint of the device for commissionable announcements. */
-    pairingHint?: TypeFromPartialBitSchema<typeof PairingHintBitmap>;
-    /** Pairing instruction of the device for commissionable announcements. */
-    pairingInstructions?: string;
-}
-export type CommissionerInstanceData = {
-    /** Device name for commissionable announcements. */
-    deviceName: string;
-    /** Device type for commissionable announcements. */
-    vendorId: VendorId;
-    /** Vendor ID for commissionable announcements. */
-    productId: number;
-    /** Device type for commissionable announcements. */
-    deviceType?: number;
-    /** Session Idle Interval of the device for commissionable announcements. */
-    sessionIdleInterval?: number;
-    /** Session Active Interval of the device for commissionable announcements. */
-    sessionActiveInterval?: number;
-    /** This key defines the duration of time the node stays Active after the last network activity. **/
-    sessionActiveThreshold?: number;
-};
-export type OperationalInstanceData = {
-    /** Session Idle Interval of the device for operational announcements. */
-    sessionIdleInterval?: number;
-    /** Session Active Interval of the device for operational announcements. */
-    sessionActiveInterval?: number;
-    /** This key defines the duration of time the node stays Active after the last network activity. **/
-    sessionActiveThreshold?: number;
-};
-export declare enum CommissioningMode {
-    NotCommissioning = 0,
-    Basic = 1,
-    Enhanced = 2
-}
-/** Interface for classes that allow to announce one Matter instance. */
-export interface InstanceBroadcaster {
-    /** Set a commissionable mode and details to announce a commissionable device. */
-    setCommissionMode(mode: CommissioningMode, deviceData: CommissioningModeInstanceData): Promise<void>;
-    /**
-     * Set operational details to Announce an operational device which is already commissioned.
-     * Use expireCommissioningAnnouncements = true when Fabrics are changed after a n commissioning process.
-     */
-    setFabrics(fabrics: Fabric[], expireCommissioningAnnouncements?: boolean): Promise<void>;
-    /** Set commissioner details to announce a commissioner service for User directed commissioning (UDC). */
-    setCommissionerInfo(commissionerData: CommissionerInstanceData): Promise<void>;
-    /** Send out announcements for this instance. */
-    announce(): Promise<void>;
-    /** Expire the announcement for this operative instance. */
-    expireFabricAnnouncement(): Promise<void>;
-    /** Expire the announcement for this commissioning instance. */
-    expireCommissioningAnnouncement(): Promise<void>;
-    /** Expire all announcements. */
-    expireAllAnnouncements(): Promise<void>;
-    /** Destroy the instance */
-    close(): Promise<void>;
-}
-//# sourceMappingURL=InstanceBroadcaster.d.ts.map
+//# sourceMappingURL=PairingHintBitmap.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"PairingHintBitmap.d.ts","sourceRoot":"","sources":["../../../src/advertisement/PairingHintBitmap.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,OAAO,EAAgB,MAAM,eAAe,CAAC;AAEtD,eAAO,MAAM,iBAAiB;IAC1B;;;OAGG;;IAGH;;;;;OAKG;;IAGH;;;OAGG;;IAGH;;OAEG;;IAGH;;;OAGG;;IAGH;;;;OAIG;;IAGH;;OAEG;;IAGH;;OAEG;;IAGH;;;OAGG;;IAGH;;;OAGG;;IAGH;;;OAGG;;IAGH;;;OAGG;;IAGH;;;OAGG;;IAGH;;OAEG;;IAGH;;OAEG;;IAGH;;;OAGG;;IAGH;;;OAGG;;IAGH;;;OAGG;;IAGH;;;OAGG;;IAGH;;;OAGG;;CAEN,CAAC;AAEF,eAAO,MAAM,uBAAuB;IAvHhC;;;OAGG;;IAGH;;;;;OAKG;;IAGH;;;OAGG;;IAGH;;OAEG;;IAGH;;;OAGG;;IAGH;;;;OAIG;;IAGH;;OAEG;;IAGH;;OAEG;;IAGH;;;OAGG;;IAGH;;;OAGG;;IAGH;;;OAGG;;IAGH;;;OAGG;;IAGH;;;OAGG;;IAGH;;OAEG;;IAGH;;OAEG;;IAGH;;;OAGG;;IAGH;;;OAGG;;IAGH;;;OAGG;;IAGH;;;OAGG;;IAGH;;;OAGG;;EAI+D,CAAC"}

package/dist/esm/{common/InstanceBroadcaster.js → advertisement/PairingHintBitmap.js}

@@ -3,7 +3,7 @@
  * Copyright 2022-2025 Matter.js Authors
  * SPDX-License-Identifier: Apache-2.0
  */
-import { BitFlag, BitmapSchema } from "#types";
+import { BitFlag, BitmapSchema } from "@matter/types";
 const PairingHintBitmap = {
   /**
    * The Device will automatically enter Commissioning Mode upon power cycle (unplug/re- plug, remove/re-insert
@@ -105,15 +105,8 @@ const PairingHintBitmap = {
   pressSetupButtonNumberOfTimes: BitFlag(19)
 };
 const PairingHintBitmapSchema = BitmapSchema(PairingHintBitmap);
-var CommissioningMode = /* @__PURE__ */ ((CommissioningMode2) => {
-  CommissioningMode2[CommissioningMode2["NotCommissioning"] = 0] = "NotCommissioning";
-  CommissioningMode2[CommissioningMode2["Basic"] = 1] = "Basic";
-  CommissioningMode2[CommissioningMode2["Enhanced"] = 2] = "Enhanced";
-  return CommissioningMode2;
-})(CommissioningMode || {});
 export {
-  CommissioningMode,
   PairingHintBitmap,
   PairingHintBitmapSchema
 };
-//# sourceMappingURL=InstanceBroadcaster.js.map
+//# sourceMappingURL=PairingHintBitmap.js.map

package/dist/esm/{common/InstanceBroadcaster.js.map → advertisement/PairingHintBitmap.js.map}

@@ -1,6 +1,6 @@
 {
   "version": 3,
-  "sources": ["../../../src/common/InstanceBroadcaster.ts"],
-  "mappings": "AAAA;AAAA;AAAA;AAAA;AAAA;AAMA,SAAS,SAAS,oBAA4E;AAGvF,MAAM,oBAAoB;AAAA;AAAA;AAAA;AAAA;AAAA,EAK7B,YAAY,QAAQ,CAAC;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAQrB,uBAAuB,QAAQ,CAAC;AAAA;AAAA;AAAA;AAAA;AAAA,EAMhC,eAAe,QAAQ,CAAC;AAAA;AAAA;AAAA;AAAA,EAKxB,oBAAoB,QAAQ,CAAC;AAAA;AAAA;AAAA;AAAA;AAAA,EAM7B,mBAAmB,QAAQ,CAAC;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAO5B,cAAc,QAAQ,CAAC;AAAA;AAAA;AAAA;AAAA,EAKvB,kBAAkB,QAAQ,CAAC;AAAA;AAAA;AAAA;AAAA,EAK3B,wCAAwC,QAAQ,CAAC;AAAA;AAAA;AAAA;AAAA;AAAA,EAMjD,mCAAmC,QAAQ,CAAC;AAAA;AAAA;AAAA;AAAA;AAAA,EAM5C,kCAAkC,QAAQ,CAAC;AAAA;AAAA;AAAA;AAAA;AAAA,EAM3C,0DAA0D,QAAQ,EAAE;AAAA;AAAA;AAAA;AAAA;AAAA,EAMpE,wDAAwD,QAAQ,EAAE;AAAA;AAAA;AAAA;AAAA;AAAA,EAMlE,+BAA+B,QAAQ,EAAE;AAAA;AAAA;AAAA;AAAA,EAKzC,kBAAkB,QAAQ,EAAE;AAAA;AAAA;AAAA;AAAA,EAK5B,wCAAwC,QAAQ,EAAE;AAAA;AAAA;AAAA;AAAA;AAAA,EAMlD,oCAAoC,QAAQ,EAAE;AAAA;AAAA;AAAA;AAAA;AAAA,EAM9C,kCAAkC,QAAQ,EAAE;AAAA;AAAA;AAAA;AAAA;AAAA,EAM5C,0DAA0D,QAAQ,EAAE;AAAA;AAAA;AAAA;AAAA;AAAA,EAMpE,wDAAwD,QAAQ,EAAE;AAAA;AAAA;AAAA;AAAA;AAAA,EAMlE,+BAA+B,QAAQ,EAAE;AAC7C;AAEO,MAAM,0BAA0B,aAAa,iBAAiB;AAwD9D,IAAK,oBAAL,kBAAKA,uBAAL;AACH,EAAAA,sCAAA,sBAAmB,KAAnB;AACA,EAAAA,sCAAA,WAAQ,KAAR;AACA,EAAAA,sCAAA,cAAW,KAAX;AAHQ,SAAAA;AAAA,GAAA;",
-  "names": ["CommissioningMode"]
+  "sources": ["../../../src/advertisement/PairingHintBitmap.ts"],
+  "mappings": "AAAA;AAAA;AAAA;AAAA;AAAA;AAMA,SAAS,SAAS,oBAAoB;AAE/B,MAAM,oBAAoB;AAAA;AAAA;AAAA;AAAA;AAAA,EAK7B,YAAY,QAAQ,CAAC;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAQrB,uBAAuB,QAAQ,CAAC;AAAA;AAAA;AAAA;AAAA;AAAA,EAMhC,eAAe,QAAQ,CAAC;AAAA;AAAA;AAAA;AAAA,EAKxB,oBAAoB,QAAQ,CAAC;AAAA;AAAA;AAAA;AAAA;AAAA,EAM7B,mBAAmB,QAAQ,CAAC;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAO5B,cAAc,QAAQ,CAAC;AAAA;AAAA;AAAA;AAAA,EAKvB,kBAAkB,QAAQ,CAAC;AAAA;AAAA;AAAA;AAAA,EAK3B,wCAAwC,QAAQ,CAAC;AAAA;AAAA;AAAA;AAAA;AAAA,EAMjD,mCAAmC,QAAQ,CAAC;AAAA;AAAA;AAAA;AAAA;AAAA,EAM5C,kCAAkC,QAAQ,CAAC;AAAA;AAAA;AAAA;AAAA;AAAA,EAM3C,0DAA0D,QAAQ,EAAE;AAAA;AAAA;AAAA;AAAA;AAAA,EAMpE,wDAAwD,QAAQ,EAAE;AAAA;AAAA;AAAA;AAAA;AAAA,EAMlE,+BAA+B,QAAQ,EAAE;AAAA;AAAA;AAAA;AAAA,EAKzC,kBAAkB,QAAQ,EAAE;AAAA;AAAA;AAAA;AAAA,EAK5B,wCAAwC,QAAQ,EAAE;AAAA;AAAA;AAAA;AAAA;AAAA,EAMlD,oCAAoC,QAAQ,EAAE;AAAA;AAAA;AAAA;AAAA;AAAA,EAM9C,kCAAkC,QAAQ,EAAE;AAAA;AAAA;AAAA;AAAA;AAAA,EAM5C,0DAA0D,QAAQ,EAAE;AAAA;AAAA;AAAA;AAAA;AAAA,EAMpE,wDAAwD,QAAQ,EAAE;AAAA;AAAA;AAAA;AAAA;AAAA,EAMlE,+BAA+B,QAAQ,EAAE;AAC7C;AAEO,MAAM,0BAA0B,aAAa,iBAAiB;",
+  "names": []
 }

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

@@ -0,0 +1,70 @@
+/**
+ * @license
+ * Copyright 2022-2025 Matter.js Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import type { PairingHintBitmap } from "#advertisement/PairingHintBitmap.js";
+import { SupportedTransportsBitmap } from "#common/SupportedTransportsBitmap.js";
+import type { Fabric } from "#fabric/Fabric.js";
+import { SessionIntervals } from "#session/SessionIntervals.js";
+import type { ProductDescription, TypeFromPartialBitSchema } from "@matter/types";
+import { IcdManagement } from "@matter/types/clusters/icd-management";
+import { CommissioningMode } from "./CommissioningMode.js";
+export type ServiceDescription = ServiceDescription.Operational | ServiceDescription.Commissionable | ServiceDescription.Commissioner;
+export declare namespace ServiceDescription {
+    function isCommissioning(description: ServiceDescription): description is Commissionable | Commissioner;
+    function isOperational(description: ServiceDescription): description is Operational;
+    interface Base extends Partial<SessionIntervals> {
+        /**
+         * The IP port for the Matter protocol.
+         */
+        port?: number;
+        /**
+         * Indicate support for TCP.
+         */
+        tcp?: SupportedTransportsBitmap;
+        /**
+         * Indicate support for ICD.
+         */
+        icd?: IcdManagement.OperatingMode;
+    }
+    interface Commissionable extends Base, ProductDescription {
+        readonly kind: "commissionable";
+        /**
+         * The commissioning mode.
+         */
+        readonly mode: CommissioningMode;
+        /**
+         * Device discriminator for commissionable announcements.
+         */
+        readonly discriminator: number;
+        /**
+         * Pairing hint of the device for commissionable announcements.
+         */
+        readonly pairingHint?: TypeFromPartialBitSchema<typeof PairingHintBitmap>;
+        /**
+         * Pairing instruction of the device for commissionable announcements.
+         */
+        readonly pairingInstructions?: string;
+    }
+    function Commissionable(definition: Omit<Commissionable, "kind">): Commissionable;
+    interface Operational extends Base {
+        readonly kind: "operational";
+        /**
+         * The advertised fabric.
+         */
+        readonly fabric: Fabric;
+    }
+    function Operational(definition: Omit<Operational, "kind">): Operational;
+    interface Commissioner extends Omit<ProductDescription, "deviceType">, Base {
+        readonly kind: "commissioner";
+        /**
+         * The device type.
+         *
+         * This is optional for commissioner advertisement.
+         */
+        readonly deviceType?: number;
+    }
+    function Commissioner(definition: Omit<Commissioner, "kind">): Commissioner;
+}
+//# sourceMappingURL=ServiceDescription.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ServiceDescription.d.ts","sourceRoot":"","sources":["../../../src/advertisement/ServiceDescription.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,qCAAqC,CAAC;AAC7E,OAAO,EAAE,yBAAyB,EAAE,MAAM,sCAAsC,CAAC;AACjF,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,EAAE,gBAAgB,EAAE,MAAM,8BAA8B,CAAC;AAChE,OAAO,KAAK,EAAE,kBAAkB,EAAE,wBAAwB,EAAE,MAAM,eAAe,CAAC;AAClF,OAAO,EAAE,aAAa,EAAE,MAAM,uCAAuC,CAAC;AACtE,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAE3D,MAAM,MAAM,kBAAkB,GACxB,kBAAkB,CAAC,WAAW,GAC9B,kBAAkB,CAAC,cAAc,GACjC,kBAAkB,CAAC,YAAY,CAAC;AAEtC,yBAAiB,kBAAkB,CAAC;IAChC,SAAgB,eAAe,CAAC,WAAW,EAAE,kBAAkB,GAAG,WAAW,IAAI,cAAc,GAAG,YAAY,CAE7G;IAED,SAAgB,aAAa,CAAC,WAAW,EAAE,kBAAkB,GAAG,WAAW,IAAI,WAAW,CAEzF;IAED,UAAiB,IAAK,SAAQ,OAAO,CAAC,gBAAgB,CAAC;QACnD;;WAEG;QACH,IAAI,CAAC,EAAE,MAAM,CAAC;QAEd;;WAEG;QACH,GAAG,CAAC,EAAE,yBAAyB,CAAC;QAEhC;;WAEG;QACH,GAAG,CAAC,EAAE,aAAa,CAAC,aAAa,CAAC;KACrC;IAED,UAAiB,cAAe,SAAQ,IAAI,EAAE,kBAAkB;QAC5D,QAAQ,CAAC,IAAI,EAAE,gBAAgB,CAAC;QAEhC;;WAEG;QACH,QAAQ,CAAC,IAAI,EAAE,iBAAiB,CAAC;QAEjC;;WAEG;QACH,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;QAE/B;;WAEG;QACH,QAAQ,CAAC,WAAW,CAAC,EAAE,wBAAwB,CAAC,OAAO,iBAAiB,CAAC,CAAC;QAE1E;;WAEG;QACH,QAAQ,CAAC,mBAAmB,CAAC,EAAE,MAAM,CAAC;KACzC;IAED,SAAgB,cAAc,CAAC,UAAU,EAAE,IAAI,CAAC,cAAc,EAAE,MAAM,CAAC,GAAG,cAAc,CAKvF;IAED,UAAiB,WAAY,SAAQ,IAAI;QACrC,QAAQ,CAAC,IAAI,EAAE,aAAa,CAAC;QAE7B;;WAEG;QACH,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;KAC3B;IAED,SAAgB,WAAW,CAAC,UAAU,EAAE,IAAI,CAAC,WAAW,EAAE,MAAM,CAAC,GAAG,WAAW,CAK9E;IAED,UAAiB,YAAa,SAAQ,IAAI,CAAC,kBAAkB,EAAE,YAAY,CAAC,EAAE,IAAI;QAC9E,QAAQ,CAAC,IAAI,EAAE,cAAc,CAAC;QAE9B;;;;WAIG;QACH,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;KAChC;IAED,SAAgB,YAAY,CAAC,UAAU,EAAE,IAAI,CAAC,YAAY,EAAE,MAAM,CAAC,GAAG,YAAY,CAKjF;CACJ"}

package/dist/esm/advertisement/ServiceDescription.js

@@ -0,0 +1,41 @@
+/**
+ * @license
+ * Copyright 2022-2025 Matter.js Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+var ServiceDescription;
+((ServiceDescription2) => {
+  function isCommissioning(description) {
+    return description.kind === "commissionable" || description.kind === "commissioner";
+  }
+  ServiceDescription2.isCommissioning = isCommissioning;
+  function isOperational(description) {
+    return description.kind === "operational";
+  }
+  ServiceDescription2.isOperational = isOperational;
+  function Commissionable(definition) {
+    return {
+      ...definition,
+      kind: "commissionable"
+    };
+  }
+  ServiceDescription2.Commissionable = Commissionable;
+  function Operational(definition) {
+    return {
+      ...definition,
+      kind: "operational"
+    };
+  }
+  ServiceDescription2.Operational = Operational;
+  function Commissioner(definition) {
+    return {
+      ...definition,
+      kind: "commissioner"
+    };
+  }
+  ServiceDescription2.Commissioner = Commissioner;
+})(ServiceDescription || (ServiceDescription = {}));
+export {
+  ServiceDescription
+};
+//# sourceMappingURL=ServiceDescription.js.map

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

@@ -0,0 +1,6 @@
+{
+  "version": 3,
+  "sources": ["../../../src/advertisement/ServiceDescription.ts"],
+  "mappings": "AAAA;AAAA;AAAA;AAAA;AAAA;AAmBO,IAAU;AAAA,CAAV,CAAUA,wBAAV;AACI,WAAS,gBAAgB,aAA+E;AAC3G,WAAO,YAAY,SAAS,oBAAoB,YAAY,SAAS;AAAA,EACzE;AAFO,EAAAA,oBAAS;AAIT,WAAS,cAAc,aAA6D;AACvF,WAAO,YAAY,SAAS;AAAA,EAChC;AAFO,EAAAA,oBAAS;AA6CT,WAAS,eAAe,YAA0D;AACrF,WAAO;AAAA,MACH,GAAG;AAAA,MACH,MAAM;AAAA,IACV;AAAA,EACJ;AALO,EAAAA,oBAAS;AAgBT,WAAS,YAAY,YAAoD;AAC5E,WAAO;AAAA,MACH,GAAG;AAAA,MACH,MAAM;AAAA,IACV;AAAA,EACJ;AALO,EAAAA,oBAAS;AAkBT,WAAS,aAAa,YAAsD;AAC/E,WAAO;AAAA,MACH,GAAG;AAAA,MACH,MAAM;AAAA,IACV;AAAA,EACJ;AALO,EAAAA,oBAAS;AAAA,GApFH;",
+  "names": ["ServiceDescription"]
+}

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

@@ -0,0 +1,16 @@
+/**
+ * @license
+ * Copyright 2022-2025 Matter.js Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { Advertisement } from "../Advertisement.js";
+import { ServiceDescription } from "../ServiceDescription.js";
+import type { BleAdvertiser } from "./BleAdvertiser.js";
+export declare class BleAdvertisement extends Advertisement<ServiceDescription.Commissionable> {
+    #private;
+    advertiser: BleAdvertiser;
+    constructor(advertiser: BleAdvertiser, description: ServiceDescription.Commissionable);
+    protected run(context: Advertisement.ActivityContext): Promise<void>;
+    isDuplicate(): boolean;
+}
+//# sourceMappingURL=BleAdvertisement.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"BleAdvertisement.d.ts","sourceRoot":"","sources":["../../../../src/advertisement/ble/BleAdvertisement.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACpD,OAAO,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AAC9D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAWxD,qBAAa,gBAAiB,SAAQ,aAAa,CAAC,kBAAkB,CAAC,cAAc,CAAC;;IAC1E,UAAU,EAAE,aAAa,CAAC;gBAEtB,UAAU,EAAE,aAAa,EAAE,WAAW,EAAE,kBAAkB,CAAC,cAAc;cAI5D,GAAG,CAAC,OAAO,EAAE,aAAa,CAAC,eAAe;IA0DnE,WAAW;CAId"}

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

@@ -0,0 +1,65 @@
+/**
+ * @license
+ * Copyright 2022-2025 Matter.js Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { BtpCodec } from "#codec/BtpCodec.js";
+import { Advertisement } from "../Advertisement.js";
+const EARLY_INTERVAL_SLEEP = 3e4;
+const LATE_INTERVAL_SLEEP = 15 * 6e4 - EARLY_INTERVAL_SLEEP;
+const EXTENDED_INTERVAL_SLEEP = 48 * 60 * 6e4 - LATE_INTERVAL_SLEEP;
+class BleAdvertisement extends Advertisement {
+  constructor(advertiser, description) {
+    super(advertiser, "ble:commissioning", description);
+  }
+  async run(context) {
+    const {
+      peripheral,
+      config: { earlyInterval, lateInterval, extendedInterval }
+    } = this.advertiser;
+    let aad = this.advertiser.config.aad;
+    let timeout = this.advertiser.config.timeout;
+    let advertisementData = this.#encodedAdvertisement;
+    let isExtended = false;
+    const intervals = [
+      { sleepTime: EARLY_INTERVAL_SLEEP, broadcastInterval: earlyInterval },
+      { sleepTime: LATE_INTERVAL_SLEEP, broadcastInterval: lateInterval },
+      { sleepTime: EXTENDED_INTERVAL_SLEEP, broadcastInterval: extendedInterval }
+    ];
+    try {
+      for (const { sleepTime, broadcastInterval } of intervals) {
+        if (!isExtended && this.isPrivacyMasked) {
+          isExtended = true;
+          advertisementData = this.#encodedAdvertisement;
+          aad = void 0;
+        }
+        await peripheral.advertise(advertisementData, aad, broadcastInterval);
+        await context.sleep("BLE advertisement interval", Math.min(timeout, sleepTime));
+        timeout -= sleepTime;
+        if ((timeout -= sleepTime) <= 0) {
+          break;
+        }
+      }
+    } finally {
+      await peripheral.stopAdvertising();
+    }
+  }
+  get #encodedAdvertisement() {
+    const { discriminator, vendorId, productId } = this.description;
+    const { isPrivacyMasked: isExtendedAnnouncement } = this;
+    return BtpCodec.encodeBleAdvertisementData(
+      discriminator,
+      isExtendedAnnouncement ? 0 : vendorId,
+      isExtendedAnnouncement ? 0 : productId,
+      !isExtendedAnnouncement && !!this.advertiser.config.aad?.length,
+      isExtendedAnnouncement
+    );
+  }
+  isDuplicate() {
+    return true;
+  }
+}
+export {
+  BleAdvertisement
+};
+//# sourceMappingURL=BleAdvertisement.js.map

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

@@ -0,0 +1,6 @@
+{
+  "version": 3,
+  "sources": ["../../../../src/advertisement/ble/BleAdvertisement.ts"],
+  "mappings": "AAAA;AAAA;AAAA;AAAA;AAAA;AAMA,SAAS,gBAAgB;AACzB,SAAS,qBAAqB;AAK9B,MAAM,uBAAuB;AAG7B,MAAM,sBAAsB,KAAK,MAAS;AAG1C,MAAM,0BAA0B,KAAK,KAAK,MAAS;AAE5C,MAAM,yBAAyB,cAAiD;AAAA,EAGnF,YAAY,YAA2B,aAAgD;AACnF,UAAM,YAAY,qBAAqB,WAAW;AAAA,EACtD;AAAA,EAEA,MAAyB,IAAI,SAAwC;AACjE,UAAM;AAAA,MACF;AAAA,MACA,QAAQ,EAAE,eAAe,cAAc,iBAAiB;AAAA,IAC5D,IAAI,KAAK;AAET,QAAI,MAAM,KAAK,WAAW,OAAO;AAEjC,QAAI,UAAU,KAAK,WAAW,OAAO;AAErC,QAAI,oBAAoB,KAAK;AAE7B,QAAI,aAAa;AAEjB,UAAM,YAAY;AAAA,MACd,EAAE,WAAW,sBAAsB,mBAAmB,cAAc;AAAA,MACpE,EAAE,WAAW,qBAAqB,mBAAmB,aAAa;AAAA,MAClE,EAAE,WAAW,yBAAyB,mBAAmB,iBAAiB;AAAA,IAC9E;AAEA,QAAI;AACA,iBAAW,EAAE,WAAW,kBAAkB,KAAK,WAAW;AAEtD,YAAI,CAAC,cAAc,KAAK,iBAAiB;AACrC,uBAAa;AACb,8BAAoB,KAAK;AACzB,gBAAM;AAAA,QACV;AAGA,cAAM,WAAW,UAAU,mBAAmB,KAAK,iBAAiB;AAGpE,cAAM,QAAQ,MAAM,8BAA8B,KAAK,IAAI,SAAS,SAAS,CAAC;AAE9E,mBAAW;AACX,aAAK,WAAW,cAAc,GAAG;AAC7B;AAAA,QACJ;AAAA,MACJ;AAAA,IACJ,UAAE;AACE,YAAM,WAAW,gBAAgB;AAAA,IACrC;AAAA,EACJ;AAAA,EAEA,IAAI,wBAAwB;AACxB,UAAM,EAAE,eAAe,UAAU,UAAU,IAAI,KAAK;AACpD,UAAM,EAAE,iBAAiB,uBAAuB,IAAI;AAEpD,WAAO,SAAS;AAAA,MACZ;AAAA,MACA,yBAAyB,IAAI;AAAA,MAC7B,yBAAyB,IAAI;AAAA,MAC7B,CAAC,0BAA0B,CAAC,CAAC,KAAK,WAAW,OAAO,KAAK;AAAA,MACzD;AAAA,IACJ;AAAA,EACJ;AAAA,EAEA,cAAc;AAEV,WAAO;AAAA,EACX;AACJ;",
+  "names": []
+}

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

@@ -0,0 +1,66 @@
+/**
+ * @license
+ * Copyright 2022-2025 Matter.js Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { BlePeripheralInterface } from "#ble/Ble.js";
+import { DatatypeModel } from "#model";
+import { Advertisement } from "../Advertisement.js";
+import { Advertiser } from "../Advertiser.js";
+import { ServiceDescription } from "../ServiceDescription.js";
+export declare class BleAdvertiser extends Advertiser {
+    #private;
+    constructor(peripheral: BlePeripheralInterface, options?: BleAdvertiser.Options);
+    get peripheral(): BlePeripheralInterface;
+    get config(): BleAdvertiser.Configuration;
+    getAdvertisement(description: ServiceDescription): Advertisement | undefined;
+}
+export declare namespace BleAdvertiser {
+    /**
+     * Advertisement configuration.
+     *
+     * All intervals are in milliseconds.
+     */
+    interface Configuration {
+        /**
+         * Additional advertisement data.
+         */
+        readonly aad?: Uint8Array;
+        /**
+         * Advertisement timeout.
+         */
+        readonly timeout: number;
+        /**
+         * Transmission interval for first 30 seconds.
+         *
+         * Per core spec 5.4.2.5.3 should be 20-60ms.
+         */
+        readonly earlyInterval: number;
+        /**
+         * Transmission interval after first 30 seconds but before 15 minutes.
+         *
+         * Per core spec 5.4.2.5.3 should be 150-1285ms.
+         */
+        readonly lateInterval: number;
+        /**
+         * Transmission interval after 15 minutes.
+         *
+         * Per core spec 5.4.2.5.3 should be ~1285ms.
+         */
+        readonly extendedInterval: number;
+    }
+    interface Options extends Partial<Configuration> {
+    }
+    function Configuration(options?: Options): {
+        aad?: Uint8Array;
+        timeout: number;
+        earlyInterval: number;
+        lateInterval: number;
+        extendedInterval: number;
+    };
+    /**
+     * Data model for BLE advertiser configuration.
+     */
+    const OptionsSchema: DatatypeModel;
+}
+//# sourceMappingURL=BleAdvertiser.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"BleAdvertiser.d.ts","sourceRoot":"","sources":["../../../../src/advertisement/ble/BleAdvertiser.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,sBAAsB,EAAE,MAAM,aAAa,CAAC;AAErD,OAAO,EAAE,aAAa,EAAgB,MAAM,QAAQ,CAAC;AAErD,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACpD,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAE9C,OAAO,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AAG9D,qBAAa,aAAc,SAAQ,UAAU;;gBAK7B,UAAU,EAAE,sBAAsB,EAAE,OAAO,CAAC,EAAE,aAAa,CAAC,OAAO;IAO/E,IAAI,UAAU,2BAEb;IAED,IAAI,MAAM,gCAET;IAED,gBAAgB,CAAC,WAAW,EAAE,kBAAkB,GAAG,aAAa,GAAG,SAAS;CAe/E;AAED,yBAAiB,aAAa,CAAC;IAC3B;;;;OAIG;IACH,UAAiB,aAAa;QAC1B;;WAEG;QACH,QAAQ,CAAC,GAAG,CAAC,EAAE,UAAU,CAAC;QAE1B;;WAEG;QACH,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;QAEzB;;;;WAIG;QACH,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;QAE/B;;;;WAIG;QACH,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;QAE9B;;;;WAIG;QACH,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAC;KACrC;IAED,UAAiB,OAAQ,SAAQ,OAAO,CAAC,aAAa,CAAC;KAAG;IAE1D,SAAgB,aAAa,CAAC,OAAO,CAAC,EAAE,OAAO;cA/B5B,UAAU;iBAKP,MAAM;uBAOA,MAAM;sBAOP,MAAM;0BAOF,MAAM;MAapC;IAED;;OAEG;IACI,MAAM,aAAa,eAOzB,CAAC;CACL"}

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

@@ -0,0 +1,63 @@
+/**
+ * @license
+ * Copyright 2022-2025 Matter.js Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { ImplementationError } from "#general";
+import { DatatypeModel, FieldElement } from "#model";
+import { MAXIMUM_COMMISSIONING_TIMEOUT_S } from "#types";
+import { Advertiser } from "../Advertiser.js";
+import { CommissioningMode } from "../CommissioningMode.js";
+import { BleAdvertisement } from "./BleAdvertisement.js";
+class BleAdvertiser extends Advertiser {
+  #peripheral;
+  #config;
+  #isClosed = false;
+  constructor(peripheral, options) {
+    super();
+    this.#peripheral = peripheral;
+    this.#config = BleAdvertiser.Configuration(options);
+  }
+  get peripheral() {
+    return this.#peripheral;
+  }
+  get config() {
+    return this.#config;
+  }
+  getAdvertisement(description) {
+    this.#assertOpen();
+    if (description.kind !== "commissionable" || description.mode !== CommissioningMode.Basic) {
+      return;
+    }
+    return new BleAdvertisement(this, description);
+  }
+  #assertOpen() {
+    if (this.#isClosed) {
+      throw new ImplementationError("Illegal operation on closed BleBroadcaster");
+    }
+  }
+}
+((BleAdvertiser2) => {
+  function Configuration(options) {
+    return {
+      timeout: MAXIMUM_COMMISSIONING_TIMEOUT_S,
+      earlyInterval: 20,
+      lateInterval: 150,
+      extendedInterval: 1285,
+      ...options
+    };
+  }
+  BleAdvertiser2.Configuration = Configuration;
+  BleAdvertiser2.OptionsSchema = new DatatypeModel(
+    { name: "BleAdvertiserOptions", type: "struct" },
+    FieldElement({ name: "add", type: "octstr" }),
+    FieldElement({ name: "timeout", type: "uint32" }),
+    FieldElement({ name: "earlyInterval", type: "uint32" }),
+    FieldElement({ name: "lateInterval", type: "uint32" }),
+    FieldElement({ name: "extendedInterval", type: "uint32" })
+  );
+})(BleAdvertiser || (BleAdvertiser = {}));
+export {
+  BleAdvertiser
+};
+//# sourceMappingURL=BleAdvertiser.js.map