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

package/dist/cjs/behavior/cluster/ClusterBehaviorUtil.js.map

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

package/dist/cjs/behavior/cluster/ClusterEvents.d.ts

@@ -0,0 +1,51 @@
+/**
+ * @license
+ * Copyright 2022-2024 Matter.js Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import type { AsyncObservable, Observable } from "#general";
+import type { ClusterType, TypeFromSchema } from "#types";
+import type { Behavior } from "../Behavior.js";
+import type { ActionContext } from "../context/ActionContext.js";
+import type { ClusterOf } from "./ClusterBehaviorUtil.js";
+/**
+ * Event instance type for ClusterBehaviors.
+ */
+export type ClusterEvents<ClusterT extends ClusterType, BaseT extends Behavior.Type> = Omit<InstanceType<BaseT["Events"]>, keyof ClusterEvents.Properties<ClusterOf<BaseT>>> & ClusterEvents.Properties<ClusterT>;
+export declare namespace ClusterEvents {
+    type Type<C extends ClusterType, B extends Behavior.Type> = {
+        new (): ClusterEvents<C, B>;
+    };
+    /**
+     * Properties the cluster contributes to Events.
+     */
+    type Properties<C> = AttributeObservables<ClusterType.AttributesOf<C>, "Changing"> & AttributeObservables<ClusterType.AttributesOf<C>, "Changed"> & EventObservables<ClusterType.EventsOf<C>>;
+    type AttributeObservables<A extends Record<string, ClusterType.Attribute>, N extends string> = {
+        [K in keyof A as string extends K ? never : K extends string ? A[K] extends {
+            optional: true;
+        } ? never : `${K}$${N}` : never]: AttributeObservable<A[K]>;
+    } & {
+        [K in keyof A as string extends K ? never : K extends string ? A[K] extends {
+            optional: true;
+        } ? `${K}$${N}` : never : never]?: AttributeObservable<A[K]>;
+    };
+    type AttributeObservable<A extends ClusterType.Attribute = ClusterType.Attribute> = AsyncObservable<[
+        value: TypeFromSchema<A["schema"]>,
+        oldValue: TypeFromSchema<A["schema"]>,
+        context: ActionContext
+    ]>;
+    type EventObservables<E extends Record<string, ClusterType.Event>> = {
+        [K in keyof E as string extends K ? never : K extends string ? E[K] extends {
+            optional: true;
+        } ? never : K : never]: EventObservable<E[K]>;
+    } & {
+        [K in keyof E as string extends K ? never : K extends string ? E[K] extends {
+            optional: true;
+        } ? K : never : never]?: EventObservable<E[K]>;
+    };
+    type EventObservable<E extends ClusterType.Event = ClusterType.Event> = Observable<[
+        payload: TypeFromSchema<E["schema"]>,
+        context: ActionContext
+    ]>;
+}
+//# sourceMappingURL=ClusterEvents.d.ts.map

package/dist/cjs/behavior/cluster/ClusterEvents.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ClusterEvents.d.ts","sourceRoot":"","sources":["../../../../src/behavior/cluster/ClusterEvents.ts"],"names":[],"mappings":"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"}

package/dist/cjs/behavior/cluster/ClusterEvents.js

@@ -0,0 +1,22 @@
+"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 __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var ClusterEvents_exports = {};
+module.exports = __toCommonJS(ClusterEvents_exports);
+/**
+ * @license
+ * Copyright 2022-2024 Matter.js Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+//# sourceMappingURL=ClusterEvents.js.map

package/dist/cjs/behavior/cluster/ClusterEvents.js.map

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

package/dist/cjs/behavior/cluster/ClusterInterface.d.ts

@@ -0,0 +1,76 @@
+/**
+ * @license
+ * Copyright 2022-2024 Matter.js Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import type { MaybePromise } from "#general";
+import type { BitSchema, ClusterComposer, ClusterType, TypeFromPartialBitSchema, TypeFromSchema } from "#types";
+/**
+ * This type defines methods for a behavior grouped by named cluster component.
+ *
+ * Ideally we would do this using a simple mapped type.  Unfortunately as of TypeScript 5.2 there is no way to define a
+ * method using a mapped type. Instead the mapped type defines function properties.
+ *
+ * Function properties work identically to methods semantically but TypeScript doesn't allow you to override them with
+ * standard methods (see error TS2425).
+ *
+ * Thus we are forced to generate an interface for every cluster component and assemble based on selected features using
+ * logic that mirrors {@link ClusterComposer.Of}.
+ *
+ * Note that we only need to do this for commands.  The public interface for attributes and events consists solely of
+ * properties so we generate using mapped types.  This is handled by ClusterState and ClusterEvents respectively.
+ *
+ * If TS team ever fixes:
+ *
+ *   https://github.com/microsoft/TypeScript/issues/27965
+ *
+ * ...then we can remove the interface and just use {@link ClusterInterface.MappedMethodsOf}.
+ *
+ * This appears to be a duplicate (but is still open):
+ *
+ *   https://github.com/microsoft/TypeScript/issues/27689
+ *
+ * Proposed solution is to just remove the error:
+ *
+ *   https://github.com/microsoft/TypeScript/issues/48125
+ *
+ */
+export type ClusterInterface<F extends BitSchema = {}> = {
+    components: ClusterInterface.Component<F>[];
+};
+export declare namespace ClusterInterface {
+    const Empty: {
+        components: never[];
+    };
+    interface Empty {
+        components: [];
+    }
+    interface Component<F extends BitSchema = {}> {
+        flags: TypeFromPartialBitSchema<F>;
+        methods: {};
+    }
+    type InterfaceOf<B> = B extends {
+        Interface: infer I extends ClusterInterface;
+    } ? I : ClusterInterface;
+    type MethodsOf<I extends ClusterInterface, C extends ClusterType> = InterfaceMethodsOf<I, C["supportedFeatures"]> & Omit<MappedMethodsOf<C["commands"]>, keyof InterfaceMethodsOf<I, C["supportedFeatures"]>>;
+    type InterfaceMethodsOf<I extends ClusterInterface, S extends ClusterComposer.FeatureFlags> = ClusterInterface extends I ? {} : AppliedMethodsOf<ApplicableComponents<I["components"], S>>;
+    type AppliedMethodsOf<CA extends Component[]> = CA extends [
+        infer C extends Component,
+        ...infer R extends Component[]
+    ] ? C["methods"] & AppliedMethodsOf<R> : {};
+    type ApplicableComponents<CA extends Component[], S extends ClusterComposer.FeatureFlags> = CA extends [
+        infer C extends Component,
+        ...infer R extends Component[]
+    ] ? S extends C["flags"] ? [C, ...ApplicableComponents<R, S>] : ApplicableComponents<R, S> : [];
+    type MethodForCommand<C extends ClusterType.Command> = (request: TypeFromSchema<C["requestSchema"]>) => MaybePromise<TypeFromSchema<C["responseSchema"]>>;
+    type MappedMethodsOf<C extends Record<string, ClusterType.Command>> = string extends keyof C ? {} : {
+        readonly [K in keyof C as C[K] extends {
+            optional: true;
+        } ? never : K]: MethodForCommand<C[K]>;
+    } & {
+        readonly [K in keyof C as C[K] extends {
+            optional: true;
+        } ? K : never]?: MethodForCommand<C[K]>;
+    };
+}
+//# sourceMappingURL=ClusterInterface.d.ts.map

package/dist/cjs/behavior/cluster/ClusterInterface.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ClusterInterface.d.ts","sourceRoot":"","sources":["../../../../src/behavior/cluster/ClusterInterface.ts"],"names":[],"mappings":"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"}

package/dist/cjs/behavior/cluster/ClusterInterface.js

@@ -0,0 +1,33 @@
+"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 ClusterInterface_exports = {};
+__export(ClusterInterface_exports, {
+  ClusterInterface: () => ClusterInterface
+});
+module.exports = __toCommonJS(ClusterInterface_exports);
+/**
+ * @license
+ * Copyright 2022-2024 Matter.js Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+var ClusterInterface;
+((ClusterInterface2) => {
+  ClusterInterface2.Empty = { components: [] };
+})(ClusterInterface || (ClusterInterface = {}));
+//# sourceMappingURL=ClusterInterface.js.map

package/dist/cjs/behavior/cluster/ClusterInterface.js.map

@@ -0,0 +1,6 @@
+{
+  "version": 3,
+  "sources": ["../../../../src/behavior/cluster/ClusterInterface.ts"],
+  "mappings": ";;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AA2CO,IAAU;AAAA,CAAV,CAAUA,sBAAV;AACI,EAAMA,kBAAA,QAAQ,EAAE,YAAY,CAAC,EAAE;AAAA,GADzB;",
+  "names": ["ClusterInterface"]
+}

package/dist/cjs/behavior/cluster/ClusterState.d.ts

@@ -0,0 +1,64 @@
+/**
+ * @license
+ * Copyright 2022-2024 Matter.js Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import type { ClusterType, TypeFromSchema } from "#types";
+import { AttributeId, BitSchema, CommandId, EventId, TypeFromPartialBitSchema } from "#types";
+import type { Behavior } from "../Behavior.js";
+import type { ClusterOf } from "./ClusterBehaviorUtil.js";
+/**
+ * Instance type for complete (endpoint + fabric) state.
+ */
+export type ClusterState<C extends ClusterType, B extends Behavior.Type> = ClusterState.Type<C, B>;
+/**
+ * State values for global attributes.
+ *
+ * These properties are present in the state object for all cluster behaviors.  We manage them automatically and they
+ * would add unnecessary noise in the API so we omit them from public types.  But they are accessible in TypeScript by
+ * casting state to GlobalAttributeState.
+ */
+export interface GlobalAttributeState {
+    clusterRevision: number;
+    featureMap: TypeFromPartialBitSchema<BitSchema>;
+    attributeList: AttributeId[];
+    acceptedCommandList: CommandId[];
+    generatedCommandList: CommandId[];
+    eventList: EventId[];
+}
+export declare namespace ClusterState {
+    /**
+     * Instance type for ClusterBehavior state.
+     */
+    type Type<C extends ClusterType, B extends Behavior.Type> = Omit<InstanceType<B["State"]>, keyof PropertiesOf<ClusterOf<B>>> & PropertiesOf<C>;
+    /**
+     * Properties a cluster contributes state.
+     */
+    type PropertiesOf<C> = PropertiesOfAttributes<ClusterType.AttributesOf<C>>;
+    type PropertiesOfAttributes<A extends Record<string, ClusterType.Attribute>> = {
+        -readonly [N in keyof A as A[N] extends {
+            fixed: true;
+        } ? never : A[N] extends {
+            optional: true;
+        } ? never : N]: TypeFromSchema<A[N]["schema"]>;
+    } & {
+        -readonly [N in keyof A as A[N] extends {
+            fixed: true;
+        } ? never : A[N] extends {
+            optional: true;
+        } ? N : never]?: TypeFromSchema<A[N]["schema"]>;
+    } & {
+        -readonly [N in keyof A as A[N] extends {
+            fixed: true;
+        } ? A[N] extends {
+            optional: true;
+        } ? never : N : never]: TypeFromSchema<A[N]["schema"]>;
+    } & {
+        -readonly [N in keyof A as A[N] extends {
+            fixed: true;
+        } ? A[N] extends {
+            optional: true;
+        } ? N : never : never]?: TypeFromSchema<A[N]["schema"]>;
+    };
+}
+//# sourceMappingURL=ClusterState.d.ts.map

package/dist/cjs/behavior/cluster/ClusterState.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ClusterState.d.ts","sourceRoot":"","sources":["../../../../src/behavior/cluster/ClusterState.ts"],"names":[],"mappings":"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"}

package/dist/cjs/behavior/cluster/ClusterState.js

@@ -0,0 +1,22 @@
+"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 __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var ClusterState_exports = {};
+module.exports = __toCommonJS(ClusterState_exports);
+/**
+ * @license
+ * Copyright 2022-2024 Matter.js Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+//# sourceMappingURL=ClusterState.js.map

package/dist/cjs/behavior/cluster/ClusterState.js.map

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

package/dist/cjs/behavior/cluster/ValidatedElements.d.ts

@@ -0,0 +1,54 @@
+/**
+ * @license
+ * Copyright 2022-2024 Matter.js Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { Behavior } from "../Behavior.js";
+import { ClusterBehavior } from "./ClusterBehavior.js";
+/**
+ * Analyzes a ClusterBehavior implementation to ensure it conforms to the Matter specification.
+ *
+ * As this API is accessible via vanilla JavaScript, validation includes tests for errors that TypeScript otherwise
+ * prevents.
+ *
+ * Records elements supported and a list of errors if validation fails.
+ */
+export declare class ValidatedElements {
+    #private;
+    /**
+     * Supported attributes.
+     */
+    attributes: Set<string>;
+    /**
+     * Supported commands.
+     */
+    commands: Set<string>;
+    /**
+     * Supported events.
+     */
+    events: Set<string>;
+    /**
+     * A list of implementation errors, if any.
+     */
+    errors?: {
+        element: string;
+        message: string;
+        fatal: boolean;
+    }[];
+    /**
+     * Obtain validation information.
+     *
+     * Validation may run against the type alone or with a specific instance of the behavior.  The latter option allows
+     * for per-instance specialization.
+     *
+     * @param type the behavior type to analyze
+     * @param instance optional concrete instance of the behavior
+     */
+    constructor(type: ClusterBehavior.Type, instance?: Behavior);
+    /**
+     * If there are errors, log and throw an exception.
+     */
+    report(): void;
+    private error;
+}
+//# sourceMappingURL=ValidatedElements.d.ts.map

package/dist/cjs/behavior/cluster/ValidatedElements.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ValidatedElements.d.ts","sourceRoot":"","sources":["../../../../src/behavior/cluster/ValidatedElements.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAC1C,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAKvD;;;;;;;GAOG;AACH,qBAAa,iBAAiB;;IAC1B;;OAEG;IACH,UAAU,cAAqB;IAE/B;;OAEG;IACH,QAAQ,cAAqB;IAE7B;;OAEG;IACH,MAAM,cAAqB;IAE3B;;OAEG;IACH,MAAM,CAAC,EAAE;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,OAAO,CAAA;KAAE,EAAE,CAAC;IAOhE;;;;;;;;OAQG;gBACS,IAAI,EAAE,eAAe,CAAC,IAAI,EAAE,QAAQ,CAAC,EAAE,QAAQ;IA0B3D;;OAEG;IACH,MAAM;IAkLN,OAAO,CAAC,KAAK;CAQhB"}

package/dist/cjs/behavior/cluster/ValidatedElements.js

@@ -0,0 +1,237 @@
+"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 ValidatedElements_exports = {};
+__export(ValidatedElements_exports, {
+  ValidatedElements: () => ValidatedElements
+});
+module.exports = __toCommonJS(ValidatedElements_exports);
+var import_general = require("#general");
+var import_Behavior = require("../Behavior.js");
+var import_ClusterBehaviorUtil = require("./ClusterBehaviorUtil.js");
+/**
+ * @license
+ * Copyright 2022-2024 Matter.js Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+const logger = import_general.Logger.get("ValidatedElements");
+class ValidatedElements {
+  /**
+   * Supported attributes.
+   */
+  attributes = /* @__PURE__ */ new Set();
+  /**
+   * Supported commands.
+   */
+  commands = /* @__PURE__ */ new Set();
+  /**
+   * Supported events.
+   */
+  events = /* @__PURE__ */ new Set();
+  /**
+   * A list of implementation errors, if any.
+   */
+  errors;
+  #name;
+  #type;
+  #instance;
+  #cluster;
+  /**
+   * Obtain validation information.
+   *
+   * Validation may run against the type alone or with a specific instance of the behavior.  The latter option allows
+   * for per-instance specialization.
+   *
+   * @param type the behavior type to analyze
+   * @param instance optional concrete instance of the behavior
+   */
+  constructor(type, instance) {
+    this.#type = type;
+    this.#instance = instance;
+    this.#name = type.name;
+    this.#cluster = type.cluster;
+    if (typeof type !== "function") {
+      this.error(void 0, "Is not a class", true);
+    }
+    if (this.#cluster === void 0) {
+      this.error("cluster", "Property missing", true);
+      return;
+    }
+    if (typeof this.#cluster !== "object") {
+      this.error("cluster", "Property is not an object", true);
+      return;
+    }
+    if (instance !== void 0 && (instance === null || typeof instance !== "object")) {
+      this.error("instance", "Is not an object", true);
+    }
+    this.#validateAttributes();
+    this.#validateCommands();
+    this.#validateEvents();
+  }
+  /**
+   * If there are errors, log and throw an exception.
+   */
+  report() {
+    if (!this.errors) {
+      return;
+    }
+    let crashed = false;
+    for (const error of this.errors) {
+      const diagnostic = import_general.Diagnostic.squash("Error in ", import_general.Diagnostic.strong(error.element), ": ", error.message);
+      if (error.fatal) {
+        crashed = true;
+        logger.error(diagnostic);
+      } else {
+        logger.warn(diagnostic);
+      }
+    }
+    if (crashed) {
+      throw new import_general.ImplementationError(
+        `There ${this.errors.length > 1 ? `are ${this.errors.length} errors` : `is 1 error`} in a ClusterBehavior implementation for property ${this.#name} (see log for details)`
+      );
+    }
+  }
+  #validateAttributes() {
+    const attributes = this.#cluster.attributes;
+    if (!attributes) {
+      this.error("cluster.attributes", "Property missing", true);
+      return;
+    }
+    let state;
+    if (this.#instance) {
+      state = this.#instance.state;
+    } else {
+      const constructor = this.#type.State;
+      if (!constructor) {
+        this.error("State", "Property missing", true);
+        return;
+      }
+      try {
+        state = new constructor();
+      } catch (e) {
+        this.error("State", "Not constructable", true);
+        return;
+      }
+    }
+    for (const name in attributes) {
+      const attr = attributes[name];
+      if (!attr) {
+        this.error(`cluster.attributes.${name}`, "Undefined element in cluster definition", true);
+        continue;
+      }
+      if (state[name] === void 0) {
+        if (!attr.optional) {
+          this.error(`State.${name}`, "Mandatory element unsupported", false);
+        }
+        continue;
+      }
+      this.attributes.add(name);
+    }
+  }
+  #validateCommands() {
+    const commands = this.#cluster.commands;
+    if (!commands) {
+      this.error("cluster.commands", "Property missing", true);
+      return;
+    }
+    let implementations;
+    if (this.#instance) {
+      implementations = this.#instance;
+    } else {
+      try {
+        implementations = (0, import_ClusterBehaviorUtil.introspectionInstanceOf)(this.#type);
+      } catch (e) {
+        this.error("constructor", "Not constructable", true);
+        return;
+      }
+    }
+    for (const name in commands) {
+      const command = commands[name];
+      if (!command) {
+        this.error(`cluster.commands.${name}`, "Undefined element in cluster definition", true);
+        continue;
+      }
+      const implementation = implementations[name];
+      if (!(name in implementations) || implementation === void 0) {
+        if (!command.optional) {
+          this.error(name, `Implementation missing`, true);
+        }
+        continue;
+      }
+      if (typeof implementation !== "function") {
+        this.error(name, `Implementation is not a function`, true);
+        continue;
+      }
+      if (implementation === import_Behavior.Behavior.unimplemented) {
+        if (!command.optional) {
+          if (this.#name.match(/^(?:Groups|Scenes|GroupKeyManagement)(?:Server|Behavior)/)) {
+            continue;
+          }
+          this.error(name, `Throws unimplemented exception`, false);
+        }
+        continue;
+      }
+      this.commands.add(name);
+    }
+  }
+  #validateEvents() {
+    const expected = this.#cluster.events;
+    if (typeof expected !== "object" || expected === null) {
+      this.error("cluster.events", "Invalid definition", true);
+      return;
+    }
+    const constructor = this.#type.Events;
+    if (!constructor) {
+      this.error("Events", "Implementation missing", true);
+      return;
+    }
+    let emitters;
+    if (this.#instance) {
+      emitters = this.#instance.events;
+    } else {
+      try {
+        emitters = new constructor();
+      } catch (e) {
+        this.error("Events", "Not constructable", true);
+        return;
+      }
+    }
+    for (const name in expected) {
+      const event = expected[name];
+      if (!event) {
+        this.error(`cluster.events.${name}`, "Undefined element in cluster definition", true);
+        continue;
+      }
+      if (!(name in emitters)) {
+        if (!event.optional) {
+          this.error(`cluster.events.${name}`, "Implementation missing", true);
+        }
+        continue;
+      }
+      this.events.add(name);
+    }
+  }
+  error(element, message, fatal) {
+    if (!this.errors) {
+      this.errors = [];
+    }
+    const name = element === void 0 ? this.#name : `${this.#name}.${element}`;
+    this.errors?.push({ element: name, message, fatal });
+  }
+}
+//# sourceMappingURL=ValidatedElements.js.map

package/dist/cjs/behavior/cluster/ValidatedElements.js.map

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

package/dist/cjs/behavior/cluster/index.d.ts

@@ -0,0 +1,12 @@
+/**
+ * @license
+ * Copyright 2022-2024 Matter.js Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+export * from "./ClusterBehavior.js";
+export * from "./ClusterBehaviorUtil.js";
+export * from "./ClusterEvents.js";
+export * from "./ClusterInterface.js";
+export * from "./ClusterState.js";
+export * from "./ValidatedElements.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/cjs/behavior/cluster/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/behavior/cluster/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,cAAc,sBAAsB,CAAC;AACrC,cAAc,0BAA0B,CAAC;AACzC,cAAc,oBAAoB,CAAC;AACnC,cAAc,uBAAuB,CAAC;AACtC,cAAc,mBAAmB,CAAC;AAClC,cAAc,wBAAwB,CAAC"}