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

package/dist/esm/behavior/supervision/ValueSupervisor.d.ts

@@ -0,0 +1,92 @@
+/**
+ * @license
+ * Copyright 2022-2024 Matter.js Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { AsyncObservable } from "#general";
+import { DataModelPath } from "#model";
+import type { AccessControl } from "../AccessControl.js";
+import { ActionTracer } from "../context/ActionTracer.js";
+import type { Val } from "../state/Val.js";
+import type { Transaction } from "../state/transaction/Transaction.js";
+import type { ValidationLocation } from "../state/validation/location.js";
+import type { RootSupervisor } from "./RootSupervisor.js";
+import type { Schema } from "./Schema.js";
+/**
+ * Value supervisor implements schema-based supervision of a specific value.
+ *
+ * Supervision functions include:
+ *
+ *   - Access controls
+ *
+ *   - Datatype validation
+ *
+ *   - Managed instance generation
+ *
+ * Supervision is implemented via schema-driven runtime compilation.  We
+ * perform as much logic as possible at startup to minimize overhead during
+ * server operation.
+ *
+ * This means we typically ingest schema, create a compact form of denormalized
+ * metadata, and/or generate functions to perform required operations.
+ */
+export interface ValueSupervisor {
+    /**
+     * The schema manager that owns this ValueSupervisor.
+     */
+    readonly owner: RootSupervisor;
+    /**
+     * The logical schema that controls the value's behavior.
+     */
+    readonly schema: Schema;
+    /**
+     * Consolidated access control information for the schema.
+     */
+    readonly access: AccessControl;
+    /**
+     * Perform validation.
+     */
+    readonly validate: ValueSupervisor.Validate | undefined;
+    /**
+     * Create a managed instance of a value.
+     */
+    readonly manage: ValueSupervisor.Manage;
+    /**
+     * Apply changes.  Does not validate perform validation.
+     */
+    readonly patch: ValueSupervisor.Patch;
+    /**
+     * Convert a JS value to the appropriate JS type for the schema.
+     */
+    readonly cast: ValueSupervisor.Cast;
+}
+export declare namespace ValueSupervisor {
+    /**
+     * Session information required for value management.
+     */
+    interface Session extends AccessControl.Session {
+        /**
+         * The transaction used for isolating state changes associated with this session.
+         */
+        transaction: Transaction;
+        /**
+         * A target for instrumentation information.  If present, various components will populate with diagnostic
+         * information during the action.
+         */
+        trace?: ActionTracer.Action;
+        /**
+         * If this is true, data validation is disabled.  This should only be used in contexts where data validation is
+         * deferred.
+         */
+        acceptInvalid?: boolean;
+        /**
+         * If present the session is associated with an online interaction.  Emits when the interaction ends.
+         */
+        interactionComplete?: AsyncObservable<[]>;
+    }
+    type Validate = (value: Val, session: Session, location: ValidationLocation) => void;
+    type Manage = (reference: Val.Reference, session: Session) => Val;
+    type Patch = (changes: Val.Collection, target: Val.Collection, path: DataModelPath) => Val;
+    type Cast = (value: Val) => Val;
+}
+//# sourceMappingURL=ValueSupervisor.d.ts.map

package/dist/esm/behavior/supervision/ValueSupervisor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ValueSupervisor.d.ts","sourceRoot":"","sources":["../../../../src/behavior/supervision/ValueSupervisor.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,eAAe,EAAE,MAAM,UAAU,CAAC;AAC3C,OAAO,EAAE,aAAa,EAAE,MAAM,QAAQ,CAAC;AACvC,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACzD,OAAO,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAC;AAC1D,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,iBAAiB,CAAC;AAC3C,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,qCAAqC,CAAC;AACvE,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,iCAAiC,CAAC;AAC1E,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAC1D,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAE1C;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,WAAW,eAAe;IAC5B;;OAEG;IACH,QAAQ,CAAC,KAAK,EAAE,cAAc,CAAC;IAE/B;;OAEG;IACH,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IAExB;;OAEG;IACH,QAAQ,CAAC,MAAM,EAAE,aAAa,CAAC;IAE/B;;OAEG;IACH,QAAQ,CAAC,QAAQ,EAAE,eAAe,CAAC,QAAQ,GAAG,SAAS,CAAC;IAExD;;OAEG;IACH,QAAQ,CAAC,MAAM,EAAE,eAAe,CAAC,MAAM,CAAC;IAExC;;OAEG;IACH,QAAQ,CAAC,KAAK,EAAE,eAAe,CAAC,KAAK,CAAC;IAEtC;;OAEG;IACH,QAAQ,CAAC,IAAI,EAAE,eAAe,CAAC,IAAI,CAAC;CACvC;AAED,yBAAiB,eAAe,CAAC;IAC7B;;OAEG;IACH,UAAiB,OAAQ,SAAQ,aAAa,CAAC,OAAO;QAClD;;WAEG;QACH,WAAW,EAAE,WAAW,CAAC;QAEzB;;;WAGG;QACH,KAAK,CAAC,EAAE,YAAY,CAAC,MAAM,CAAC;QAE5B;;;WAGG;QACH,aAAa,CAAC,EAAE,OAAO,CAAC;QAExB;;WAEG;QACH,mBAAmB,CAAC,EAAE,eAAe,CAAC,EAAE,CAAC,CAAC;KAC7C;IAED,KAAY,QAAQ,GAAG,CAAC,KAAK,EAAE,GAAG,EAAE,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,kBAAkB,KAAK,IAAI,CAAC;IAE5F,KAAY,MAAM,GAAG,CAAC,SAAS,EAAE,GAAG,CAAC,SAAS,EAAE,OAAO,EAAE,OAAO,KAAK,GAAG,CAAC;IAEzE,KAAY,KAAK,GAAG,CAAC,OAAO,EAAE,GAAG,CAAC,UAAU,EAAE,MAAM,EAAE,GAAG,CAAC,UAAU,EAAE,IAAI,EAAE,aAAa,KAAK,GAAG,CAAC;IAElG,KAAY,IAAI,GAAG,CAAC,KAAK,EAAE,GAAG,KAAK,GAAG,CAAC;CAC1C"}

package/dist/esm/behavior/supervision/ValueSupervisor.js

@@ -0,0 +1,6 @@
+/**
+ * @license
+ * Copyright 2022-2024 Matter.js Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+//# sourceMappingURL=ValueSupervisor.js.map

package/dist/esm/behavior/supervision/ValueSupervisor.js.map

@@ -0,0 +1,6 @@
+{
+  "version": 3,
+  "sources": ["../../../../src/behavior/supervision/ValueSupervisor.ts"],
+  "mappings": "AAAA;AAAA;AAAA;AAAA;AAAA;",
+  "names": []
+}

package/dist/esm/behavior/supervision/index.d.ts

@@ -0,0 +1,10 @@
+/**
+ * @license
+ * Copyright 2022-2024 Matter.js Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+export * from "./BehaviorSupervisor.js";
+export * from "./RootSupervisor.js";
+export * from "./Schema.js";
+export * from "./ValueSupervisor.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/esm/behavior/supervision/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/behavior/supervision/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,cAAc,yBAAyB,CAAC;AACxC,cAAc,qBAAqB,CAAC;AACpC,cAAc,aAAa,CAAC;AAC5B,cAAc,sBAAsB,CAAC"}

package/dist/esm/behavior/supervision/index.js

@@ -0,0 +1,10 @@
+/**
+ * @license
+ * Copyright 2022-2024 Matter.js Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+export * from "./BehaviorSupervisor.js";
+export * from "./RootSupervisor.js";
+export * from "./Schema.js";
+export * from "./ValueSupervisor.js";
+//# sourceMappingURL=index.js.map

package/dist/esm/behavior/supervision/index.js.map

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

package/dist/esm/behavior/system/commissioning/CommissioningBehavior.d.ts

@@ -0,0 +1,78 @@
+/**
+ * @license
+ * Copyright 2022-2024 Matter.js Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { Endpoint } from "#endpoint/Endpoint.js";
+import { EventEmitter, Observable } from "#general";
+import { DatatypeModel } from "#model";
+import { ExposedFabricInformation, FabricAction } from "#protocol";
+import { CommissioningFlowType, CommissioningOptions, FabricIndex } from "#types";
+import { Behavior } from "../../Behavior.js";
+import { ActionContext } from "../../context/ActionContext.js";
+import { Val } from "../../state/Val.js";
+/**
+ * Server functionality related to commissioning used by {@link EndpointServer}.
+ *
+ * Better name would be CommissioningServer but we already have one of those.
+ */
+export declare class CommissioningBehavior extends Behavior {
+    #private;
+    static readonly id = "commissioning";
+    state: CommissioningBehavior.State;
+    events: CommissioningBehavior.Events;
+    internal: CommissioningBehavior.Internal;
+    static early: boolean;
+    initialize(): void;
+    [Symbol.asyncDispose](): void;
+    handleFabricChange(fabricIndex: FabricIndex, fabricAction: FabricAction): void;
+    /**
+     * The server invokes this method when the node is active but not yet commissioned.
+     *
+     * An uncommissioned node is not yet associated with fabrics.  It cannot be used until commissioned by a controller.
+     *
+     * The default implementation logs the QR code and credentials.
+     */
+    initiateCommissioning(): void;
+    /**
+     * Obtain pairing codes for a node.
+     */
+    static pairingCodesFor(node: Endpoint): {
+        manualPairingCode: string;
+        qrPairingCode: string;
+    };
+    /**
+     * Define logical schema to make passcode and discriminator persistent.
+     */
+    static readonly schema: DatatypeModel;
+}
+export declare namespace CommissioningBehavior {
+    interface PairingCodes {
+        manualPairingCode: string;
+        qrPairingCode: string;
+    }
+    class Internal {
+        unregisterFailsafeListener?: () => void;
+    }
+    class State implements CommissioningOptions {
+        commissioned: boolean;
+        fabrics: Record<FabricIndex, ExposedFabricInformation>;
+        passcode: number;
+        discriminator: number;
+        flowType: CommissioningFlowType;
+        additionalBleAdvertisementData?: Uint8Array;
+        pairingCodes: PairingCodes;
+        [Val.properties](endpoint: Endpoint): {
+            readonly pairingCodes: {
+                manualPairingCode: string;
+                qrPairingCode: string;
+            };
+        };
+    }
+    class Events extends EventEmitter {
+        commissioned: Observable<[session: ActionContext], void>;
+        decommissioned: Observable<[session: ActionContext], void>;
+        fabricsChanged: Observable<[fabricIndex: FabricIndex, action: FabricAction], void>;
+    }
+}
+//# sourceMappingURL=CommissioningBehavior.d.ts.map

package/dist/esm/behavior/system/commissioning/CommissioningBehavior.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"CommissioningBehavior.d.ts","sourceRoot":"","sources":["../../../../../src/behavior/system/commissioning/CommissioningBehavior.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AAEjD,OAAO,EAEH,YAAY,EAKZ,UAAU,EACb,MAAM,UAAU,CAAC;AAClB,OAAO,EAAE,aAAa,EAAgB,MAAM,QAAQ,CAAC;AAIrD,OAAO,EAAE,wBAAwB,EAAE,YAAY,EAA8C,MAAM,WAAW,CAAC;AAC/G,OAAO,EACH,qBAAqB,EACrB,oBAAoB,EAEpB,WAAW,EAId,MAAM,QAAQ,CAAC;AAGhB,OAAO,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAC7C,OAAO,EAAE,aAAa,EAAE,MAAM,gCAAgC,CAAC;AAC/D,OAAO,EAAE,GAAG,EAAE,MAAM,oBAAoB,CAAC;AAMzC;;;;GAIG;AACH,qBAAa,qBAAsB,SAAQ,QAAQ;;IAC/C,gBAAyB,EAAE,mBAAmB;IAEtC,KAAK,EAAE,qBAAqB,CAAC,KAAK,CAAC;IACnC,MAAM,EAAE,qBAAqB,CAAC,MAAM,CAAC;IACrC,QAAQ,EAAE,qBAAqB,CAAC,QAAQ,CAAC;IAEjD,OAAgB,KAAK,UAAQ;IAEpB,UAAU;IAgBV,CAAC,MAAM,CAAC,YAAY,CAAC;IAI9B,kBAAkB,CAAC,WAAW,EAAE,WAAW,EAAE,YAAY,EAAE,YAAY;IA+GvE;;;;;;OAMG;IACH,qBAAqB;IAoBrB;;OAEG;IACH,MAAM,CAAC,eAAe,CAAC,IAAI,EAAE,QAAQ;;;;IA0BrC;;OAEG;IACH,gBAAyB,MAAM,gBAQ5B;CAmBN;AAED,yBAAiB,qBAAqB,CAAC;IACnC,UAAiB,YAAY;QACzB,iBAAiB,EAAE,MAAM,CAAC;QAC1B,aAAa,EAAE,MAAM,CAAC;KACzB;IAED,MAAa,QAAQ;QACjB,0BAA0B,CAAC,EAAE,MAAM,IAAI,CAAa;KACvD;IAED,MAAa,KAAM,YAAW,oBAAoB;QAC9C,YAAY,UAAS;QACrB,OAAO,EAAE,MAAM,CAAC,WAAW,EAAE,wBAAwB,CAAC,CAAM;QAC5D,QAAQ,SAAM;QACd,aAAa,SAAM;QACnB,QAAQ,wBAAkC;QAC1C,8BAA8B,CAAC,EAAE,UAAU,CAAa;QACxD,YAAY,EAAS,YAAY,CAAC;QAElC,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC,QAAQ,EAAE,QAAQ;;;;;;KAOtC;IAED,MAAa,MAAO,SAAQ,YAAY;QACpC,YAAY,6CAA0C;QACtD,cAAc,6CAA0C;QACxD,cAAc,qEAAkE;KACnF;CACJ"}

package/dist/esm/behavior/system/commissioning/CommissioningBehavior.js

@@ -0,0 +1,252 @@
+/**
+ * @license
+ * Copyright 2022-2024 Matter.js Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import {
+  Diagnostic,
+  EventEmitter,
+  ImplementationError,
+  Lifecycle,
+  Logger,
+  MatterFlowError,
+  Observable
+} from "#general";
+import { DatatypeModel, FieldElement } from "#model";
+import { FabricAction, FabricManager, FailsafeContext, PaseClient } from "#protocol";
+import {
+  CommissioningFlowType,
+  CommissioningOptions,
+  DiscoveryCapabilitiesSchema,
+  ManualPairingCodeCodec,
+  QrCode,
+  QrPairingCodeCodec
+} from "#types";
+import { BasicInformationBehavior } from "../../../behaviors/basic-information/BasicInformationBehavior.js";
+import { OperationalCredentialsBehavior } from "../../../behaviors/operational-credentials/OperationalCredentialsBehavior.js";
+import { Behavior } from "../../Behavior.js";
+import { Val } from "../../state/Val.js";
+import { NetworkServer } from "../network/NetworkServer.js";
+import { SessionsBehavior } from "../sessions/SessionsBehavior.js";
+const logger = Logger.get("Commissioning");
+class CommissioningBehavior extends Behavior {
+  static id = "commissioning";
+  static early = true;
+  initialize() {
+    if (this.state.passcode === -1) {
+      this.state.passcode = PaseClient.generateRandomPasscode();
+    } else if (CommissioningOptions.FORBIDDEN_PASSCODES.includes(this.state.passcode)) {
+      throw new ImplementationError(`Passcode ${this.state.passcode} is not allowed`);
+    }
+    if (this.state.discriminator === -1) {
+      this.state.discriminator = PaseClient.generateRandomDiscriminator();
+    }
+    this.reactTo(this.endpoint.lifecycle.online, this.#nodeOnline);
+    this.reactTo(this.endpoint.lifecycle.partsReady, this.#initializeNode);
+  }
+  [Symbol.asyncDispose]() {
+    this.internal.unregisterFailsafeListener?.();
+  }
+  handleFabricChange(fabricIndex, fabricAction) {
+    if (this.env.has(FailsafeContext)) {
+      const failsafe = this.env.get(FailsafeContext);
+      if (fabricAction === FabricAction.Added || fabricAction === FabricAction.Updated) {
+        if (failsafe.construction.status !== Lifecycle.Status.Destroyed) {
+          if (failsafe.fabricIndex === fabricIndex) {
+            this.#monitorFailsafe(failsafe);
+            return;
+          } else {
+            throw new MatterFlowError(
+              `Failsafe owns a different fabricIndex then ${failsafe.forUpdateNoc ? "updated" : "added"}.`
+            );
+          }
+        }
+      } else if (fabricAction === FabricAction.Removed) {
+        if (failsafe.fabricIndex !== fabricIndex) {
+          throw new MatterFlowError("Failsafe owns a different fabricIndex then removed.");
+        }
+      }
+    }
+    const fabrics = this.env.get(FabricManager).getFabrics();
+    const commissioned = !!fabrics.length;
+    if (fabricAction === FabricAction.Removed) {
+      delete this.state.fabrics[fabricIndex];
+    } else {
+      const fabric = fabrics.find((fabric2) => fabric2.fabricIndex === fabricIndex);
+      if (fabric !== void 0) {
+        this.state.fabrics[fabricIndex] = {
+          fabricIndex: fabric.fabricIndex,
+          fabricId: fabric.fabricId,
+          nodeId: fabric.nodeId,
+          rootNodeId: fabric.rootNodeId,
+          rootVendorId: fabric.rootVendorId,
+          label: fabric.label
+        };
+      }
+    }
+    let doFactoryReset = false;
+    if (commissioned !== this.state.commissioned) {
+      this.state.commissioned = commissioned;
+      if (commissioned) {
+        this.events.commissioned.emit(this.context);
+        this.endpoint.lifecycle.commissioned.emit(this.context);
+      } else {
+        this.events.decommissioned.emit(this.context);
+        this.endpoint.lifecycle.decommissioned.emit(this.context);
+        doFactoryReset = true;
+      }
+    }
+    this.events.fabricsChanged.emit(fabricIndex, fabricAction);
+    if (doFactoryReset) {
+      const sessions = this.agent.get(SessionsBehavior);
+      if (Object.keys(sessions.state.sessions).length > 0) {
+        this.reactTo(sessions.events.closed, this.#handleSessionClosed);
+      } else {
+        this.#triggerFactoryReset();
+      }
+    }
+  }
+  #handleSessionClosed() {
+    const sessions = this.agent.get(SessionsBehavior);
+    if (Object.keys(sessions.state.sessions).length === 0) {
+      this.#triggerFactoryReset();
+    }
+  }
+  #triggerFactoryReset() {
+    this.env.runtime.add(
+      this.endpoint.factoryReset().then(this.callback(this.initiateCommissioning))
+    );
+  }
+  #monitorFailsafe(failsafe) {
+    if (this.internal.unregisterFailsafeListener) {
+      return;
+    }
+    const listener = this.callback(function(status) {
+      if (status === Lifecycle.Status.Destroyed) {
+        if (failsafe.fabricIndex !== void 0) {
+          this.handleFabricChange(
+            failsafe.fabricIndex,
+            failsafe.forUpdateNoc ? FabricAction.Updated : FabricAction.Added
+          );
+        }
+        this.internal.unregisterFailsafeListener?.();
+      }
+    });
+    this.internal.unregisterFailsafeListener = this.callback(function() {
+      failsafe.construction.change.off(listener);
+      this.internal.unregisterFailsafeListener = void 0;
+    });
+    failsafe.construction.change.on(listener);
+  }
+  /**
+   * The server invokes this method when the node is active but not yet commissioned.
+   *
+   * An uncommissioned node is not yet associated with fabrics.  It cannot be used until commissioned by a controller.
+   *
+   * The default implementation logs the QR code and credentials.
+   */
+  initiateCommissioning() {
+    const { passcode, discriminator } = this.state;
+    const { qrPairingCode, manualPairingCode } = this.state.pairingCodes;
+    logger.notice(
+      Diagnostic.strong(this.endpoint.toString()),
+      "is uncommissioned",
+      Diagnostic.dict({
+        passcode,
+        discriminator,
+        "manual pairing code": manualPairingCode
+      }),
+      Diagnostic.list([
+        QrCode.get(qrPairingCode).trim(),
+        `QR code URL: https://project-chip.github.io/connectedhomeip/qrcode.html?data=${qrPairingCode}
+`
+      ])
+    );
+  }
+  /**
+   * Obtain pairing codes for a node.
+   */
+  static pairingCodesFor(node) {
+    const bi = node.stateOf(BasicInformationBehavior);
+    const comm = node.stateOf(CommissioningBehavior);
+    const net = node.stateOf(NetworkServer);
+    const qrPairingCode = QrPairingCodeCodec.encode([
+      {
+        version: 0,
+        vendorId: bi.vendorId,
+        productId: bi.productId,
+        flowType: comm.flowType,
+        discriminator: comm.discriminator,
+        passcode: comm.passcode,
+        discoveryCapabilities: DiscoveryCapabilitiesSchema.encode(net.discoveryCapabilities)
+      }
+    ]);
+    return {
+      manualPairingCode: ManualPairingCodeCodec.encode({
+        discriminator: comm.discriminator,
+        passcode: comm.passcode
+      }),
+      qrPairingCode
+    };
+  }
+  /**
+   * Define logical schema to make passcode and discriminator persistent.
+   */
+  static schema = new DatatypeModel({
+    name: "CommissioningState",
+    type: "struct",
+    children: [
+      FieldElement({ name: "passcode", type: "uint32", quality: "N" }),
+      FieldElement({ name: "discriminator", type: "uint16", quality: "N" })
+    ]
+  });
+  #nodeOnline() {
+    const fabrics = this.env.get(FabricManager).getFabrics();
+    if (!fabrics.length) {
+      this.initiateCommissioning();
+    } else {
+      const exposedFabrics = {};
+      fabrics.forEach(
+        ({ fabricIndex, externalInformation }) => exposedFabrics[fabricIndex] = externalInformation
+      );
+      this.state.fabrics = exposedFabrics;
+    }
+  }
+  #initializeNode() {
+    this.state.commissioned = !!this.agent.get(OperationalCredentialsBehavior).state.commissionedFabrics;
+    this.endpoint.lifecycle.initialized.emit(this.state.commissioned);
+  }
+}
+((CommissioningBehavior2) => {
+  class Internal {
+    unregisterFailsafeListener = void 0;
+  }
+  CommissioningBehavior2.Internal = Internal;
+  class State {
+    commissioned = false;
+    fabrics = {};
+    passcode = -1;
+    discriminator = -1;
+    flowType = CommissioningFlowType.Standard;
+    additionalBleAdvertisementData = void 0;
+    pairingCodes = {};
+    [Val.properties](endpoint) {
+      return {
+        get pairingCodes() {
+          return CommissioningBehavior2.pairingCodesFor(endpoint);
+        }
+      };
+    }
+  }
+  CommissioningBehavior2.State = State;
+  class Events extends EventEmitter {
+    commissioned = Observable();
+    decommissioned = Observable();
+    fabricsChanged = Observable();
+  }
+  CommissioningBehavior2.Events = Events;
+})(CommissioningBehavior || (CommissioningBehavior = {}));
+export {
+  CommissioningBehavior
+};
+//# sourceMappingURL=CommissioningBehavior.js.map

package/dist/esm/behavior/system/commissioning/CommissioningBehavior.js.map

@@ -0,0 +1,6 @@
+{
+  "version": 3,
+  "sources": ["../../../../../src/behavior/system/commissioning/CommissioningBehavior.ts"],
+  "mappings": "AAAA;AAAA;AAAA;AAAA;AAAA;AAQA;AAAA,EACI;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OACG;AACP,SAAS,eAAe,oBAAoB;AAI5C,SAAmC,cAAc,eAAe,iBAAiB,kBAAkB;AACnG;AAAA,EACI;AAAA,EACA;AAAA,EACA;AAAA,EAEA;AAAA,EACA;AAAA,EACA;AAAA,OACG;AACP,SAAS,gCAAgC;AACzC,SAAS,sCAAsC;AAC/C,SAAS,gBAAgB;AAEzB,SAAS,WAAW;AACpB,SAAS,qBAAqB;AAC9B,SAAS,wBAAwB;AAEjC,MAAM,SAAS,OAAO,IAAI,eAAe;AAOlC,MAAM,8BAA8B,SAAS;AAAA,EAChD,OAAyB,KAAK;AAAA,EAM9B,OAAgB,QAAQ;AAAA,EAEf,aAAa;AAClB,QAAI,KAAK,MAAM,aAAa,IAAI;AAC5B,WAAK,MAAM,WAAW,WAAW,uBAAuB;AAAA,IAC5D,WAAW,qBAAqB,oBAAoB,SAAS,KAAK,MAAM,QAAQ,GAAG;AAC/E,YAAM,IAAI,oBAAoB,YAAY,KAAK,MAAM,QAAQ,iBAAiB;AAAA,IAClF;AAEA,QAAI,KAAK,MAAM,kBAAkB,IAAI;AACjC,WAAK,MAAM,gBAAgB,WAAW,4BAA4B;AAAA,IACtE;AAEA,SAAK,QAAS,KAAK,SAAkB,UAAU,QAAQ,KAAK,WAAW;AAEvE,SAAK,QAAS,KAAK,SAAkB,UAAU,YAAY,KAAK,eAAe;AAAA,EACnF;AAAA,EAEA,CAAU,OAAO,YAAY,IAAI;AAC7B,SAAK,SAAS,6BAA6B;AAAA,EAC/C;AAAA,EAEA,mBAAmB,aAA0B,cAA4B;AAGrE,QAAI,KAAK,IAAI,IAAI,eAAe,GAAG;AAC/B,YAAM,WAAW,KAAK,IAAI,IAAI,eAAe;AAC7C,UAAI,iBAAiB,aAAa,SAAS,iBAAiB,aAAa,SAAS;AAE9E,YAAI,SAAS,aAAa,WAAW,UAAU,OAAO,WAAW;AAC7D,cAAI,SAAS,gBAAgB,aAAa;AACtC,iBAAK,iBAAiB,QAAQ;AAC9B;AAAA,UACJ,OAAO;AACH,kBAAM,IAAI;AAAA,cACN,8CAA8C,SAAS,eAAe,YAAY,OAAO;AAAA,YAC7F;AAAA,UACJ;AAAA,QACJ;AAAA,MACJ,WAAW,iBAAiB,aAAa,SAAS;AAE9C,YAAI,SAAS,gBAAgB,aAAa;AACtC,gBAAM,IAAI,gBAAgB,qDAAqD;AAAA,QACnF;AAAA,MACJ;AAAA,IACJ;AAEA,UAAM,UAAU,KAAK,IAAI,IAAI,aAAa,EAAE,WAAW;AACvD,UAAM,eAAe,CAAC,CAAC,QAAQ;AAC/B,QAAI,iBAAiB,aAAa,SAAS;AACvC,aAAO,KAAK,MAAM,QAAQ,WAAW;AAAA,IACzC,OAAO;AACH,YAAM,SAAS,QAAQ,KAAK,CAAAA,YAAUA,QAAO,gBAAgB,WAAW;AACxE,UAAI,WAAW,QAAW;AACtB,aAAK,MAAM,QAAQ,WAAW,IAAI;AAAA,UAC9B,aAAa,OAAO;AAAA,UACpB,UAAU,OAAO;AAAA,UACjB,QAAQ,OAAO;AAAA,UACf,YAAY,OAAO;AAAA,UACnB,cAAc,OAAO;AAAA,UACrB,OAAO,OAAO;AAAA,QAClB;AAAA,MACJ;AAAA,IACJ;AAEA,QAAI,iBAAiB;AACrB,QAAI,iBAAiB,KAAK,MAAM,cAAc;AAC1C,WAAK,MAAM,eAAe;AAC1B,UAAI,cAAc;AACd,aAAK,OAAO,aAAa,KAAK,KAAK,OAAO;AAC1C,QAAC,KAAK,SAAS,UAA4B,aAAa,KAAK,KAAK,OAAO;AAAA,MAC7E,OAAO;AACH,aAAK,OAAO,eAAe,KAAK,KAAK,OAAO;AAC5C,QAAC,KAAK,SAAS,UAA4B,eAAe,KAAK,KAAK,OAAO;AAE3E,yBAAiB;AAAA,MACrB;AAAA,IACJ;AAEA,SAAK,OAAO,eAAe,KAAK,aAAa,YAAY;AAEzD,QAAI,gBAAgB;AAChB,YAAM,WAAW,KAAK,MAAM,IAAI,gBAAgB;AAChD,UAAI,OAAO,KAAK,SAAS,MAAM,QAAQ,EAAE,SAAS,GAAG;AAEjD,aAAK,QAAQ,SAAS,OAAO,QAAQ,KAAK,oBAAoB;AAAA,MAClE,OAAO;AACH,aAAK,qBAAqB;AAAA,MAC9B;AAAA,IACJ;AAAA,EACJ;AAAA,EAEA,uBAAuB;AACnB,UAAM,WAAW,KAAK,MAAM,IAAI,gBAAgB;AAChD,QAAI,OAAO,KAAK,SAAS,MAAM,QAAQ,EAAE,WAAW,GAAG;AACnD,WAAK,qBAAqB;AAAA,IAC9B;AAAA,EACJ;AAAA,EAEA,uBAAuB;AACnB,SAAK,IAAI,QAAQ;AAAA,MACZ,KAAK,SAAwB,aAAa,EAAE,KAAK,KAAK,SAAS,KAAK,qBAAqB,CAAC;AAAA,IAC/F;AAAA,EACJ;AAAA,EAEA,iBAAiB,UAA2B;AACxC,QAAI,KAAK,SAAS,4BAA4B;AAC1C;AAAA,IACJ;AAGA,UAAM,WAAW,KAAK,SAAS,SAAuC,QAA0B;AAC5F,UAAI,WAAW,UAAU,OAAO,WAAW;AACvC,YAAI,SAAS,gBAAgB,QAAW;AACpC,eAAK;AAAA,YACD,SAAS;AAAA,YACT,SAAS,eAAe,aAAa,UAAU,aAAa;AAAA,UAChE;AAAA,QACJ;AACA,aAAK,SAAS,6BAA6B;AAAA,MAC/C;AAAA,IACJ,CAAC;AAGD,SAAK,SAAS,6BAA6B,KAAK,SAAS,WAAuC;AAC5F,eAAS,aAAa,OAAO,IAAI,QAAQ;AACzC,WAAK,SAAS,6BAA6B;AAAA,IAC/C,CAAC;AAGD,aAAS,aAAa,OAAO,GAAG,QAAQ;AAAA,EAC5C;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EASA,wBAAwB;AACpB,UAAM,EAAE,UAAU,cAAc,IAAI,KAAK;AAEzC,UAAM,EAAE,eAAe,kBAAkB,IAAI,KAAK,MAAM;AAExD,WAAO;AAAA,MACH,WAAW,OAAO,KAAK,SAAS,SAAS,CAAC;AAAA,MAC1C;AAAA,MACA,WAAW,KAAK;AAAA,QACZ;AAAA,QACA;AAAA,QACA,uBAAuB;AAAA,MAC3B,CAAC;AAAA,MACD,WAAW,KAAK;AAAA,QACZ,OAAO,IAAI,aAAa,EAAE,KAAK;AAAA,QAC/B,gFAAgF,aAAa;AAAA;AAAA,MACjG,CAAC;AAAA,IACL;AAAA,EACJ;AAAA;AAAA;AAAA;AAAA,EAKA,OAAO,gBAAgB,MAAgB;AACnC,UAAM,KAAK,KAAK,QAAQ,wBAAwB;AAChD,UAAM,OAAO,KAAK,QAAQ,qBAAqB;AAC/C,UAAM,MAAM,KAAK,QAAQ,aAAa;AAEtC,UAAM,gBAAgB,mBAAmB,OAAO;AAAA,MAC5C;AAAA,QACI,SAAS;AAAA,QACT,UAAU,GAAG;AAAA,QACb,WAAW,GAAG;AAAA,QACd,UAAU,KAAK;AAAA,QACf,eAAe,KAAK;AAAA,QACpB,UAAU,KAAK;AAAA,QACf,uBAAuB,4BAA4B,OAAO,IAAI,qBAAqB;AAAA,MACvF;AAAA,IACJ,CAAC;AAED,WAAO;AAAA,MACH,mBAAmB,uBAAuB,OAAO;AAAA,QAC7C,eAAe,KAAK;AAAA,QACpB,UAAU,KAAK;AAAA,MACnB,CAAC;AAAA,MACD;AAAA,IACJ;AAAA,EACJ;AAAA;AAAA;AAAA;AAAA,EAKA,OAAyB,SAAS,IAAI,cAAc;AAAA,IAChD,MAAM;AAAA,IACN,MAAM;AAAA,IAEN,UAAU;AAAA,MACN,aAAa,EAAE,MAAM,YAAY,MAAM,UAAU,SAAS,IAAI,CAAC;AAAA,MAC/D,aAAa,EAAE,MAAM,iBAAiB,MAAM,UAAU,SAAS,IAAI,CAAC;AAAA,IACxE;AAAA,EACJ,CAAC;AAAA,EAED,cAAc;AACV,UAAM,UAAU,KAAK,IAAI,IAAI,aAAa,EAAE,WAAW;AACvD,QAAI,CAAC,QAAQ,QAAQ;AACjB,WAAK,sBAAsB;AAAA,IAC/B,OAAO;AACH,YAAM,iBAAgE,CAAC;AACvE,cAAQ;AAAA,QACJ,CAAC,EAAE,aAAa,oBAAoB,MAAO,eAAe,WAAW,IAAI;AAAA,MAC7E;AACA,WAAK,MAAM,UAAU;AAAA,IACzB;AAAA,EACJ;AAAA,EAEA,kBAAkB;AACd,SAAK,MAAM,eAAe,CAAC,CAAC,KAAK,MAAM,IAAI,8BAA8B,EAAE,MAAM;AACjF,IAAC,KAAK,SAAS,UAA4B,YAAY,KAAK,KAAK,MAAM,YAAY;AAAA,EACvF;AACJ;AAAA,CAEO,CAAUC,2BAAV;AAAA,EAMI,MAAM,SAAS;AAAA,IAClB,6BAA0C;AAAA,EAC9C;AAFO,EAAAA,uBAAM;AAAA,EAIN,MAAM,MAAsC;AAAA,IAC/C,eAAe;AAAA,IACf,UAAyD,CAAC;AAAA,IAC1D,WAAW;AAAA,IACX,gBAAgB;AAAA,IAChB,WAAW,sBAAsB;AAAA,IACjC,iCAA8C;AAAA,IAC9C,eAAe,CAAC;AAAA,IAEhB,CAAC,IAAI,UAAU,EAAE,UAAoB;AACjC,aAAO;AAAA,QACH,IAAI,eAAe;AACf,iBAAOA,uBAAsB,gBAAgB,QAAQ;AAAA,QACzD;AAAA,MACJ;AAAA,IACJ;AAAA,EACJ;AAhBO,EAAAA,uBAAM;AAAA,EAkBN,MAAM,eAAe,aAAa;AAAA,IACrC,eAAe,WAAqC;AAAA,IACpD,iBAAiB,WAAqC;AAAA,IACtD,iBAAiB,WAA6D;AAAA,EAClF;AAJO,EAAAA,uBAAM;AAAA,GA5BA;",
+  "names": ["fabric", "CommissioningBehavior"]
+}

package/dist/esm/behavior/system/commissioning/index.d.ts

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

package/dist/esm/behavior/system/commissioning/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/behavior/system/commissioning/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,cAAc,4BAA4B,CAAC"}

package/dist/esm/behavior/system/commissioning/index.js

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

package/dist/esm/behavior/system/commissioning/index.js.map

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

package/dist/esm/behavior/system/index/IndexBehavior.d.ts

@@ -0,0 +1,52 @@
+/**
+ * @license
+ * Copyright 2022-2024 Matter.js Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import type { Endpoint } from "#endpoint/Endpoint.js";
+import { EventEmitter, Observable, Timer } from "#general";
+import { Behavior } from "../../Behavior.js";
+/**
+ * This behavior indexes all descendents of a {@link Endpoint} by number.
+ *
+ * IndexBehavior should only be present on root and aggregator parts as its presence causes the endpoint's PartsList
+ * attribute to reflect a flat namespace as required by the Matter standard.
+ */
+export declare class IndexBehavior extends Behavior {
+    #private;
+    static readonly id = "index";
+    internal: IndexBehavior.Internal;
+    events: IndexBehavior.Events;
+    static readonly early = true;
+    initialize(): void;
+    [Symbol.asyncDispose](): void;
+    get partsById(): Record<string, Endpoint<import("../../../index.js").EndpointType.Empty> | undefined>;
+    get partsByNumber(): Record<number, Endpoint<import("../../../index.js").EndpointType.Empty> | undefined>;
+    /**
+     * Retrieve a {@link Endpoint} by number.
+     *
+     * Note that {@link state.partsByNumber} does not include {@link endpoint} but this method will return it if the number
+     * matches.
+     */
+    forNumber(number: number): Endpoint<import("../../../index.js").EndpointType.Empty> | undefined;
+}
+export declare namespace IndexBehavior {
+    class Internal {
+        changeBroadcaster?: Timer;
+        /**
+         * Map of ID to {@link Endpoint}.
+         */
+        partsById: Record<string, Endpoint | undefined>;
+        /**
+         * Map of number to {@link Endpoint}.
+         */
+        partsByNumber: Record<number, Endpoint | undefined>;
+    }
+    class Events extends EventEmitter {
+        /**
+         * Emitted when the index changes.
+         */
+        change: Observable<[], void>;
+    }
+}
+//# sourceMappingURL=IndexBehavior.d.ts.map

package/dist/esm/behavior/system/index/IndexBehavior.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"IndexBehavior.d.ts","sourceRoot":"","sources":["../../../../../src/behavior/system/index/IndexBehavior.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AAEtD,OAAO,EAAE,YAAY,EAAE,UAAU,EAAE,KAAK,EAAE,MAAM,UAAU,CAAC;AAE3D,OAAO,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAE7C;;;;;GAKG;AACH,qBAAa,aAAc,SAAQ,QAAQ;;IACvC,gBAAyB,EAAE,WAAW;IAE9B,QAAQ,EAAE,aAAa,CAAC,QAAQ,CAAC;IACjC,MAAM,EAAE,aAAa,CAAC,MAAM,CAAC;IAErC,gBAAyB,KAAK,QAAQ;IAE7B,UAAU;IAIV,CAAC,MAAM,CAAC,YAAY,CAAC;IAK9B,IAAI,SAAS,yFAEZ;IAED,IAAI,aAAa,yFAEhB;IAED;;;;;OAKG;IACH,SAAS,CAAC,MAAM,EAAE,MAAM;CA+D3B;AAED,yBAAiB,aAAa,CAAC;IAC3B,MAAa,QAAQ;QACjB,iBAAiB,CAAC,EAAE,KAAK,CAAC;QAE1B;;WAEG;QACH,SAAS,EAAS,MAAM,CAAC,MAAM,EAAE,QAAQ,GAAG,SAAS,CAAC,CAAC;QAEvD;;WAEG;QACH,aAAa,EAAS,MAAM,CAAC,MAAM,EAAE,QAAQ,GAAG,SAAS,CAAC,CAAC;KAC9D;IAED,MAAa,MAAO,SAAQ,YAAY;QACpC;;WAEG;QACH,MAAM,uBAAoB;KAC7B;CACJ"}