@project-chip/matter.js 0.2.1 → 0.4.0

package/dist/cjs/{common → datatype}/NodeId.js

@@ -1,15 +1,18 @@
 "use strict";
 /**
  * @license
- * Copyright 2022 Project CHIP Authors
+ * Copyright 2022-2023 Project CHIP Authors
  * SPDX-License-Identifier: Apache-2.0
  */
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.TlvNodeId = exports.NodeId = void 0;
 const TlvNumber_js_1 = require("../tlv/TlvNumber.js");
 const TlvWrapper_js_1 = require("../tlv/TlvWrapper.js");
-const ByteArray_js_1 = require("../util/ByteArray.js");
+const Crypto_js_1 = require("../crypto/Crypto.js");
 const DataWriter_js_1 = require("../util/DataWriter.js");
+const ByteArray_js_1 = require("../util/ByteArray.js");
+const OPERATIONAL_NODE_MIN = BigInt('0x0000000000000001');
+const OPERATIONAL_NODE_MAX = BigInt('0xFFFFFFEFFFFFFFFF');
 /**
  * A Node Identifier (Node ID) is a 64-bit number that uniquely identifies an individual Node or a
  * group of Nodes on a Fabric.
@@ -25,7 +28,22 @@ class NodeId {
         writer.writeUInt64(this.id);
         return writer.toByteArray().toHex().toUpperCase();
     }
+    static getRandomOperationalNodeId() {
+        while (true) {
+            const randomBigInt = BigInt('0x' + Crypto_js_1.Crypto.getRandomData(8).toHex());
+            if (randomBigInt >= OPERATIONAL_NODE_MIN && randomBigInt <= OPERATIONAL_NODE_MAX) {
+                return new NodeId(randomBigInt);
+            }
+        }
+    }
+    static getGroupNodeId(groupId) {
+        if (groupId < 0 || groupId > 0xFFFF) {
+            throw new Error(`Invalid group ID: ${groupId}`);
+        }
+        return new NodeId(BigInt('0xFFFFFFFFFFFF' + groupId.toString(16).padStart(4, "0")));
+    }
 }
 exports.NodeId = NodeId;
 /** Tlv schema for a Node Identifier. */
 exports.TlvNodeId = new TlvWrapper_js_1.TlvWrapper(TlvNumber_js_1.TlvUInt64, nodeId => nodeId.id, value => new NodeId(BigInt(value)));
+//# sourceMappingURL=NodeId.js.map

package/dist/cjs/datatype/NodeId.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"NodeId.js","sourceRoot":"","sources":["../../../src/datatype/NodeId.ts"],"names":[],"mappings":";AAAA;;;;GAIG;;;AAEH,sDAAgD;AAChD,wDAAkD;AAClD,mDAA6C;AAC7C,yDAAmD;AACnD,uDAA8C;AAG9C,MAAM,oBAAoB,GAAG,MAAM,CAAC,oBAAoB,CAAC,CAAC;AAC1D,MAAM,oBAAoB,GAAG,MAAM,CAAC,oBAAoB,CAAC,CAAC;AAE1D;;;;;GAKG;AACH,MAAa,MAAM;IACf,YACa,EAAU;QAAV,OAAE,GAAF,EAAE,CAAQ;IACnB,CAAC;IAEL,QAAQ;QACJ,MAAM,MAAM,GAAG,IAAI,0BAAU,CAAC,qBAAM,CAAC,GAAG,CAAC,CAAC;QAC1C,MAAM,CAAC,WAAW,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QAC5B,OAAO,MAAM,CAAC,WAAW,EAAE,CAAC,KAAK,EAAE,CAAC,WAAW,EAAE,CAAC;IACtD,CAAC;IAED,MAAM,CAAC,0BAA0B;QAC7B,OAAO,IAAI,EAAE;YACT,MAAM,YAAY,GAAG,MAAM,CAAC,IAAI,GAAG,kBAAM,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC,KAAK,EAAE,CAAC,CAAC;YACpE,IAAI,YAAY,IAAI,oBAAoB,IAAI,YAAY,IAAI,oBAAoB,EAAE;gBAC9E,OAAO,IAAI,MAAM,CAAC,YAAY,CAAC,CAAC;aACnC;SACJ;IACL,CAAC;IAED,MAAM,CAAC,cAAc,CAAC,OAAe;QACjC,IAAI,OAAO,GAAG,CAAC,IAAI,OAAO,GAAG,MAAM,EAAE;YACjC,MAAM,IAAI,KAAK,CAAC,qBAAqB,OAAO,EAAE,CAAC,CAAC;SACnD;QACD,OAAO,IAAI,MAAM,CAAC,MAAM,CAAC,gBAAgB,GAAG,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC,CAAC,CAAC;IACxF,CAAC;CACJ;AA1BD,wBA0BC;AAED,wCAAwC;AAC3B,QAAA,SAAS,GAAG,IAAI,0BAAU,CACnC,wBAAS,EACT,MAAM,CAAC,EAAE,CAAC,MAAM,CAAC,EAAE,EACnB,KAAK,CAAC,EAAE,CAAC,IAAI,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CACrC,CAAC"}

package/dist/{dts/common → cjs/datatype}/SubjectId.d.ts

@@ -1,6 +1,6 @@
 /**
  * @license
- * Copyright 2022 Project CHIP Authors
+ * Copyright 2022-2023 Project CHIP Authors
  * SPDX-License-Identifier: Apache-2.0
  */
 import { NodeId } from "./NodeId.js";
@@ -12,4 +12,5 @@ import { NodeId } from "./NodeId.js";
  */
 export type SubjectId = NodeId;
 /** Tlv schema for a Subject Id */
-export declare const TlvSubjectId: import("../matter.js").TlvWrapper<NodeId, number | bigint>;
+export declare const TlvSubjectId: import("../tlv/TlvWrapper.js").TlvWrapper<NodeId, number | bigint>;
+//# sourceMappingURL=SubjectId.d.ts.map

package/dist/cjs/datatype/SubjectId.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SubjectId.d.ts","sourceRoot":"","sources":["../../../src/datatype/SubjectId.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,MAAM,EAAa,MAAM,aAAa,CAAC;AAGhD;;;;;GAKG;AACH,MAAM,MAAM,SAAS,GAAG,MAAM,CAAC;AAE/B,kCAAkC;AAClC,eAAO,MAAM,YAAY,oEAAY,CAAC"}

package/dist/cjs/{common → datatype}/SubjectId.js

@@ -1,7 +1,7 @@
 "use strict";
 /**
  * @license
- * Copyright 2022 Project CHIP Authors
+ * Copyright 2022-2023 Project CHIP Authors
  * SPDX-License-Identifier: Apache-2.0
  */
 Object.defineProperty(exports, "__esModule", { value: true });
@@ -9,3 +9,4 @@ exports.TlvSubjectId = void 0;
 const NodeId_js_1 = require("./NodeId.js");
 /** Tlv schema for a Subject Id */
 exports.TlvSubjectId = NodeId_js_1.TlvNodeId;
+//# sourceMappingURL=SubjectId.js.map

package/dist/cjs/datatype/SubjectId.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"SubjectId.js","sourceRoot":"","sources":["../../../src/datatype/SubjectId.ts"],"names":[],"mappings":";AAAA;;;;GAIG;;;AAEH,2CAAgD;AAWhD,kCAAkC;AACrB,QAAA,YAAY,GAAG,qBAAS,CAAC"}

package/dist/{dts/common → cjs/datatype}/VendorId.d.ts

@@ -1,6 +1,6 @@
 /**
  * @license
- * Copyright 2022 Project CHIP Authors
+ * Copyright 2022-2023 Project CHIP Authors
  * SPDX-License-Identifier: Apache-2.0
  */
 import { TlvWrapper } from "../tlv/TlvWrapper.js";
@@ -17,3 +17,4 @@ export declare class VendorId {
 }
 /** Data model for a Vendor Identifier. */
 export declare const TlvVendorId: TlvWrapper<VendorId, number>;
+//# sourceMappingURL=VendorId.d.ts.map

package/dist/cjs/datatype/VendorId.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"VendorId.d.ts","sourceRoot":"","sources":["../../../src/datatype/VendorId.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAGlD;;;;;;GAMG;AACH,qBAAa,QAAQ;IAEb,QAAQ,CAAC,EAAE,EAAE,MAAM;gBAAV,EAAE,EAAE,MAAM;CAE1B;AAED,0CAA0C;AAC1C,eAAO,MAAM,WAAW,8BAIvB,CAAC"}

package/dist/cjs/{common → datatype}/VendorId.js

@@ -1,7 +1,7 @@
 "use strict";
 /**
  * @license
- * Copyright 2022 Project CHIP Authors
+ * Copyright 2022-2023 Project CHIP Authors
  * SPDX-License-Identifier: Apache-2.0
  */
 Object.defineProperty(exports, "__esModule", { value: true });
@@ -23,3 +23,4 @@ class VendorId {
 exports.VendorId = VendorId;
 /** Data model for a Vendor Identifier. */
 exports.TlvVendorId = new TlvWrapper_js_1.TlvWrapper(TlvNumber_js_1.TlvUInt16, vendorId => vendorId.id, value => new VendorId(value));
+//# sourceMappingURL=VendorId.js.map

package/dist/cjs/datatype/VendorId.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"VendorId.js","sourceRoot":"","sources":["../../../src/datatype/VendorId.ts"],"names":[],"mappings":";AAAA;;;;GAIG;;;AAEH,sDAAgD;AAChD,wDAAkD;AAGlD;;;;;;GAMG;AACH,MAAa,QAAQ;IACjB,YACa,EAAU;QAAV,OAAE,GAAF,EAAE,CAAQ;IACnB,CAAC;CACR;AAJD,4BAIC;AAED,0CAA0C;AAC7B,QAAA,WAAW,GAAG,IAAI,0BAAU,CACrC,wBAAS,EACT,QAAQ,CAAC,EAAE,CAAC,QAAQ,CAAC,EAAE,EACvB,KAAK,CAAC,EAAE,CAAC,IAAI,QAAQ,CAAC,KAAK,CAAC,CAC/B,CAAC"}

package/dist/cjs/datatype/index.d.ts

@@ -0,0 +1,18 @@
+/**
+ * @license
+ * Copyright 2022-2023 Project CHIP Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+export * from "./AttributeId.js";
+export * from "./ClusterId.js";
+export * from "./CommandId.js";
+export * from "./DeviceTypeId.js";
+export * from "./EndpointNumber.js";
+export * from "./EventId.js";
+export * from "./FabricId.js";
+export * from "./FabricIndex.js";
+export * from "./GroupId.js";
+export * from "./NodeId.js";
+export * from "./SubjectId.js";
+export * from "./VendorId.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/cjs/datatype/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/datatype/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,cAAc,kBAAkB,CAAC;AACjC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,mBAAmB,CAAC;AAClC,cAAc,qBAAqB,CAAC;AACpC,cAAc,cAAc,CAAC;AAC7B,cAAc,eAAe,CAAC;AAC9B,cAAc,kBAAkB,CAAC;AACjC,cAAc,cAAc,CAAC;AAC7B,cAAc,aAAa,CAAC;AAC5B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,eAAe,CAAC"}

package/dist/cjs/datatype/index.js

@@ -0,0 +1,35 @@
+"use strict";
+/**
+ * @license
+ * Copyright 2022-2023 Project CHIP Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+// Export Common types
+__exportStar(require("./AttributeId.js"), exports);
+__exportStar(require("./ClusterId.js"), exports);
+__exportStar(require("./CommandId.js"), exports);
+__exportStar(require("./DeviceTypeId.js"), exports);
+__exportStar(require("./EndpointNumber.js"), exports);
+__exportStar(require("./EventId.js"), exports);
+__exportStar(require("./FabricId.js"), exports);
+__exportStar(require("./FabricIndex.js"), exports);
+__exportStar(require("./GroupId.js"), exports);
+__exportStar(require("./NodeId.js"), exports);
+__exportStar(require("./SubjectId.js"), exports);
+__exportStar(require("./VendorId.js"), exports);
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/datatype/index.ts"],"names":[],"mappings":";AAAA;;;;GAIG;;;;;;;;;;;;;;;;AAEH,sBAAsB;AACtB,mDAAiC;AACjC,iDAA+B;AAC/B,iDAA+B;AAC/B,oDAAkC;AAClC,sDAAoC;AACpC,+CAA6B;AAC7B,gDAA8B;AAC9B,mDAAiC;AACjC,+CAA6B;AAC7B,8CAA4B;AAC5B,iDAA+B;AAC/B,gDAA8B"}

package/dist/cjs/device/Aggregator.d.ts

@@ -0,0 +1,55 @@
+/**
+ * @license
+ * Copyright 2022 The matter.js Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { Device } from "./Device.js";
+import { ComposedDevice } from "./ComposedDevice.js";
+import { AttributeInitialValues } from "../cluster/server/ClusterServer.js";
+import { BridgedDeviceBasicInformationCluster } from "../cluster/BridgedDeviceBasicInformationCluster.js";
+/**
+ * An Aggregator is a special endpoint that exposes multiple devices as a "bridge" into the matter ecosystem.
+ * Use the `addBridgedDevice` or `addBridgedDeviceWithPowerSourceInfo` method to add the devices and provide the details
+ * for the "Bridged Device Basic Information Cluster". The BridgedDeviceBasicInformationCluster is then added automatically.
+ * If Power source information should be provided you need to also add the needed clusters (PowerSourceConfigurationCluster
+ * and PowerSourceCluster) to the device!
+ */
+export declare class Aggregator extends ComposedDevice {
+    /**
+     * Create a new Aggregator instance and optionally directly add devices to it. If this is used the devices must
+     * already have the BridgedDeviceBasicInformationCluster added!
+     * @param devices Array of devices to add
+     * @param endpointId Optional endpoint ID to use. If not provided will automatically be assigned
+     */
+    constructor(devices?: Device[], endpointId?: number);
+    /**
+     * @deprecated Use addBridgedDevice or addBridgedDeviceWithPowerSourceInfo instead
+     */
+    addDevice(): void;
+    /**
+     * Add a bridged device to the Aggregator. If provided the bridgedBasicInformation is used to automatically add the
+     * BridgedDeviceBasicInformationCluster to the device. If not provided the BridgedDeviceBasicInformationCluster must
+     * be already existing on the device!
+     *
+     * @param device Device instance to add
+     * @param bridgedBasicInformation Optional BridgedDeviceBasicInformationCluster attribute values to
+     */
+    addBridgedDevice(device: Device, bridgedBasicInformation?: AttributeInitialValues<typeof BridgedDeviceBasicInformationCluster.attributes>): void;
+    /**
+     * Add a bridged device with power source information to the Aggregator. If provided the bridgedBasicInformation is
+     * used to automatically add the BridgedDeviceBasicInformationCluster to the device. If not provided the
+     * BridgedDeviceBasicInformationCluster must be already existing on the device!
+     * The required clusters PowerSourceConfigurationCluster and PowerSourceCluster needs to be added manually to the device!
+     *
+     * @param device Device instance to add
+     * @param bridgedBasicInformation Optional BridgedDeviceBasicInformationCluster attribute values to
+     */
+    addBridgedDeviceWithPowerSourceInfo(device: Device, bridgedBasicInformation?: AttributeInitialValues<typeof BridgedDeviceBasicInformationCluster.attributes>): void;
+    /**
+     * Returns all bridged devices added to the Aggregator
+     *
+     * @returns Array of bridged devices
+     */
+    getBridgedDevices(): import("./Endpoint.js").Endpoint[];
+}
+//# sourceMappingURL=Aggregator.d.ts.map

package/dist/cjs/device/Aggregator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Aggregator.d.ts","sourceRoot":"","sources":["../../../src/device/Aggregator.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAErC,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AACrD,OAAO,EAAE,sBAAsB,EAAE,MAAM,oCAAoC,CAAC;AAC5E,OAAO,EAAE,oCAAoC,EAAE,MAAM,oDAAoD,CAAC;AAG1G;;;;;;GAMG;AACH,qBAAa,UAAW,SAAQ,cAAc;IAC1C;;;;;OAKG;gBACS,OAAO,GAAE,MAAM,EAAO,EAAE,UAAU,CAAC,EAAE,MAAM;IAMvD;;OAEG;IACM,SAAS,IAAI,IAAI;IAI1B;;;;;;;OAOG;IACH,gBAAgB,CAAC,MAAM,EAAE,MAAM,EAAE,uBAAuB,CAAC,EAAE,sBAAsB,CAAC,OAAO,oCAAoC,CAAC,UAAU,CAAC,GAAG,IAAI;IAiBhJ;;;;;;;;OAQG;IACH,mCAAmC,CAAC,MAAM,EAAE,MAAM,EAAE,uBAAuB,CAAC,EAAE,sBAAsB,CAAC,OAAO,oCAAoC,CAAC,UAAU,CAAC,GAAG,IAAI;IAiBnK;;;;OAIG;IACH,iBAAiB;CAGpB"}

package/dist/cjs/device/Aggregator.js

@@ -0,0 +1,94 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Aggregator = void 0;
+const DeviceTypes_js_1 = require("./DeviceTypes.js");
+const ComposedDevice_js_1 = require("./ComposedDevice.js");
+const BridgedDeviceBasicInformationCluster_js_1 = require("../cluster/BridgedDeviceBasicInformationCluster.js");
+const InteractionServer_js_1 = require("../protocol/interaction/InteractionServer.js");
+/**
+ * An Aggregator is a special endpoint that exposes multiple devices as a "bridge" into the matter ecosystem.
+ * Use the `addBridgedDevice` or `addBridgedDeviceWithPowerSourceInfo` method to add the devices and provide the details
+ * for the "Bridged Device Basic Information Cluster". The BridgedDeviceBasicInformationCluster is then added automatically.
+ * If Power source information should be provided you need to also add the needed clusters (PowerSourceConfigurationCluster
+ * and PowerSourceCluster) to the device!
+ */
+class Aggregator extends ComposedDevice_js_1.ComposedDevice {
+    /**
+     * Create a new Aggregator instance and optionally directly add devices to it. If this is used the devices must
+     * already have the BridgedDeviceBasicInformationCluster added!
+     * @param devices Array of devices to add
+     * @param endpointId Optional endpoint ID to use. If not provided will automatically be assigned
+     */
+    constructor(devices = [], endpointId) {
+        // Aggregator is a Composed device with an DeviceTypes.AGGREGATOR device type
+        super([DeviceTypes_js_1.DeviceTypes.AGGREGATOR], [], endpointId);
+        devices.forEach(device => this.addBridgedDevice(device));
+    }
+    /**
+     * @deprecated Use addBridgedDevice or addBridgedDeviceWithPowerSourceInfo instead
+     */
+    addDevice() {
+        throw new Error("Aggregator does not support addDevice. Use addBridgedDevice instead.");
+    }
+    /**
+     * Add a bridged device to the Aggregator. If provided the bridgedBasicInformation is used to automatically add the
+     * BridgedDeviceBasicInformationCluster to the device. If not provided the BridgedDeviceBasicInformationCluster must
+     * be already existing on the device!
+     *
+     * @param device Device instance to add
+     * @param bridgedBasicInformation Optional BridgedDeviceBasicInformationCluster attribute values to
+     */
+    addBridgedDevice(device, bridgedBasicInformation) {
+        // Add DeviceTypes.BRIDGED_DEVICE device type to the device exposed via Aggregator
+        const deviceTypes = device.getDeviceTypes();
+        if (!deviceTypes.includes(DeviceTypes_js_1.DeviceTypes.BRIDGED_NODE)) {
+            deviceTypes.push(DeviceTypes_js_1.DeviceTypes.BRIDGED_NODE);
+            device.setDeviceTypes(deviceTypes);
+        }
+        if (bridgedBasicInformation !== undefined) {
+            device.addClusterServer((0, InteractionServer_js_1.ClusterServer)(BridgedDeviceBasicInformationCluster_js_1.BridgedDeviceBasicInformationCluster, bridgedBasicInformation, {}));
+        }
+        else {
+            if (!device.hasClusterServer(BridgedDeviceBasicInformationCluster_js_1.BridgedDeviceBasicInformationCluster)) {
+                throw new Error("BridgedDeviceBasicInformationCluster is required for bridged devices. Please add yourself or provide as second parameter");
+            }
+        }
+        super.addDevice(device);
+    }
+    /**
+     * Add a bridged device with power source information to the Aggregator. If provided the bridgedBasicInformation is
+     * used to automatically add the BridgedDeviceBasicInformationCluster to the device. If not provided the
+     * BridgedDeviceBasicInformationCluster must be already existing on the device!
+     * The required clusters PowerSourceConfigurationCluster and PowerSourceCluster needs to be added manually to the device!
+     *
+     * @param device Device instance to add
+     * @param bridgedBasicInformation Optional BridgedDeviceBasicInformationCluster attribute values to
+     */
+    addBridgedDeviceWithPowerSourceInfo(device, bridgedBasicInformation) {
+        // Add DeviceTypes.BRIDGED_DEVICE_WITH_POWER_SOURCE_INFORMATION device type to the device exposed via Aggregator
+        const deviceTypes = device.getDeviceTypes();
+        if (!deviceTypes.includes(DeviceTypes_js_1.DeviceTypes.BRIDGED_DEVICE_WITH_POWER_SOURCE_INFORMATION)) {
+            deviceTypes.push(DeviceTypes_js_1.DeviceTypes.BRIDGED_DEVICE_WITH_POWER_SOURCE_INFORMATION);
+            device.setDeviceTypes(deviceTypes);
+        }
+        if (bridgedBasicInformation !== undefined) {
+            device.addClusterServer((0, InteractionServer_js_1.ClusterServer)(BridgedDeviceBasicInformationCluster_js_1.BridgedDeviceBasicInformationCluster, bridgedBasicInformation, {}));
+        }
+        else {
+            if (!device.hasClusterServer(BridgedDeviceBasicInformationCluster_js_1.BridgedDeviceBasicInformationCluster)) {
+                throw new Error("BridgedDeviceBasicInformationCluster is required for bridged devices. Please add yourself or provide as second parameter");
+            }
+        }
+        super.addDevice(device);
+    }
+    /**
+     * Returns all bridged devices added to the Aggregator
+     *
+     * @returns Array of bridged devices
+     */
+    getBridgedDevices() {
+        return super.getDevices();
+    }
+}
+exports.Aggregator = Aggregator;
+//# sourceMappingURL=Aggregator.js.map

package/dist/cjs/device/Aggregator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Aggregator.js","sourceRoot":"","sources":["../../../src/device/Aggregator.ts"],"names":[],"mappings":";;;AAMA,qDAA+C;AAC/C,2DAAqD;AAErD,gHAA0G;AAC1G,uFAA6E;AAE7E;;;;;;GAMG;AACH,MAAa,UAAW,SAAQ,kCAAc;IAC1C;;;;;OAKG;IACH,YAAY,UAAoB,EAAE,EAAE,UAAmB;QACnD,6EAA6E;QAC7E,KAAK,CAAC,CAAC,4BAAW,CAAC,UAAU,CAAC,EAAE,EAAE,EAAE,UAAU,CAAC,CAAC;QAChD,OAAO,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC,IAAI,CAAC,gBAAgB,CAAC,MAAM,CAAC,CAAC,CAAC;IAC7D,CAAC;IAED;;OAEG;IACM,SAAS;QACd,MAAM,IAAI,KAAK,CAAC,sEAAsE,CAAC,CAAC;IAC5F,CAAC;IAED;;;;;;;OAOG;IACH,gBAAgB,CAAC,MAAc,EAAE,uBAAwG;QACrI,kFAAkF;QAClF,MAAM,WAAW,GAAG,MAAM,CAAC,cAAc,EAAE,CAAC;QAC5C,IAAI,CAAC,WAAW,CAAC,QAAQ,CAAC,4BAAW,CAAC,YAAY,CAAC,EAAE;YACjD,WAAW,CAAC,IAAI,CAAC,4BAAW,CAAC,YAAY,CAAC,CAAC;YAC3C,MAAM,CAAC,cAAc,CAAC,WAAW,CAAC,CAAC;SACtC;QACD,IAAI,uBAAuB,KAAK,SAAS,EAAE;YACvC,MAAM,CAAC,gBAAgB,CAAC,IAAA,oCAAa,EAAC,8EAAoC,EAAE,uBAAuB,EAAE,EAAE,CAAC,CAAC,CAAC;SAC7G;aAAM;YACH,IAAI,CAAC,MAAM,CAAC,gBAAgB,CAAC,8EAAoC,CAAC,EAAE;gBAChE,MAAM,IAAI,KAAK,CAAC,0HAA0H,CAAC,CAAC;aAC/I;SACJ;QACD,KAAK,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;IAC5B,CAAC;IAED;;;;;;;;OAQG;IACH,mCAAmC,CAAC,MAAc,EAAE,uBAAwG;QACxJ,gHAAgH;QAChH,MAAM,WAAW,GAAG,MAAM,CAAC,cAAc,EAAE,CAAC;QAC5C,IAAI,CAAC,WAAW,CAAC,QAAQ,CAAC,4BAAW,CAAC,4CAA4C,CAAC,EAAE;YACjF,WAAW,CAAC,IAAI,CAAC,4BAAW,CAAC,4CAA4C,CAAC,CAAC;YAC3E,MAAM,CAAC,cAAc,CAAC,WAAW,CAAC,CAAC;SACtC;QACD,IAAI,uBAAuB,KAAK,SAAS,EAAE;YACvC,MAAM,CAAC,gBAAgB,CAAC,IAAA,oCAAa,EAAC,8EAAoC,EAAE,uBAAuB,EAAE,EAAE,CAAC,CAAC,CAAC;SAC7G;aAAM;YACH,IAAI,CAAC,MAAM,CAAC,gBAAgB,CAAC,8EAAoC,CAAC,EAAE;gBAChE,MAAM,IAAI,KAAK,CAAC,0HAA0H,CAAC,CAAC;aAC/I;SACJ;QACD,KAAK,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;IAC5B,CAAC;IAED;;;;OAIG;IACH,iBAAiB;QACb,OAAO,KAAK,CAAC,UAAU,EAAE,CAAC;IAC9B,CAAC;CACJ;AA/ED,gCA+EC"}

package/dist/cjs/device/ComposedDevice.d.ts

@@ -0,0 +1,39 @@
+/**
+ * @license
+ * Copyright 2022 The matter.js Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { Endpoint } from "./Endpoint.js";
+import { Device } from "./Device.js";
+import { DeviceTypeDefinition } from "./DeviceTypes.js";
+import { AtLeastOne } from "../util/Array.js";
+/**
+ * A ComposedDevice is a special endpoint that allows to combine multiple sub devices and expose this as one device
+ * (e.g. a fan and a light).
+ */
+export declare class ComposedDevice extends Endpoint {
+    /**
+     * Creates a new ComposedDevice.
+     *
+     * @param deviceTypes Array with Device types how this device should be presented to the Matter ecosystem.
+     * @param devices Array with devices that should be combined into one device that are directly added.
+     * @param endpointId Optional endpoint ID to use. If not provided will automatically be assigned
+     */
+    constructor(deviceTypes: AtLeastOne<DeviceTypeDefinition>, devices?: Device[], endpointId?: number);
+    /**
+     * Add a sub-device to the composed device.
+     * @param device Device instance to add
+     */
+    addDevice(device: Device): void;
+    /**
+     * Get all sub-devices of the composed device.
+     *
+     * @returns Array with all sub-devices
+     */
+    getDevices(): Endpoint[];
+    /**
+     * Verify that the required clusters exists on the device.
+     */
+    protected verifyRequiredClusters(): void;
+}
+//# sourceMappingURL=ComposedDevice.d.ts.map

package/dist/cjs/device/ComposedDevice.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ComposedDevice.d.ts","sourceRoot":"","sources":["../../../src/device/ComposedDevice.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AACzC,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AACrC,OAAO,EAAE,oBAAoB,EAAE,MAAM,kBAAkB,CAAC;AACxD,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAE9C;;;GAGG;AACH,qBAAa,cAAe,SAAQ,QAAQ;IACxC;;;;;;OAMG;gBAEC,WAAW,EAAE,UAAU,CAAC,oBAAoB,CAAC,EAC7C,OAAO,GAAE,MAAM,EAAO,EACtB,UAAU,CAAC,EAAE,MAAM;IAMvB;;;OAGG;IACH,SAAS,CAAC,MAAM,EAAE,MAAM;IAIxB;;;;OAIG;IACH,UAAU;IAIV;;OAEG;cACgB,sBAAsB;CAM5C"}

package/dist/cjs/device/ComposedDevice.js

@@ -0,0 +1,52 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ComposedDevice = void 0;
+/**
+ * @license
+ * Copyright 2022 The matter.js Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+const Endpoint_js_1 = require("./Endpoint.js");
+/**
+ * A ComposedDevice is a special endpoint that allows to combine multiple sub devices and expose this as one device
+ * (e.g. a fan and a light).
+ */
+class ComposedDevice extends Endpoint_js_1.Endpoint {
+    /**
+     * Creates a new ComposedDevice.
+     *
+     * @param deviceTypes Array with Device types how this device should be presented to the Matter ecosystem.
+     * @param devices Array with devices that should be combined into one device that are directly added.
+     * @param endpointId Optional endpoint ID to use. If not provided will automatically be assigned
+     */
+    constructor(deviceTypes, devices = [], endpointId) {
+        super(deviceTypes, [], endpointId);
+        devices.forEach(device => this.addDevice(device));
+    }
+    /**
+     * Add a sub-device to the composed device.
+     * @param device Device instance to add
+     */
+    addDevice(device) {
+        this.addChildEndpoint(device);
+    }
+    /**
+     * Get all sub-devices of the composed device.
+     *
+     * @returns Array with all sub-devices
+     */
+    getDevices() {
+        return this.getChildEndpoints();
+    }
+    /**
+     * Verify that the required clusters exists on the device.
+     */
+    verifyRequiredClusters() {
+        // TODO find out what to really check here and how ... most likely we need to verify that the added sub devices
+        //      somehow match with the device types of the composed device?!
+        //      For now we do not check this
+        return;
+    }
+}
+exports.ComposedDevice = ComposedDevice;
+//# sourceMappingURL=ComposedDevice.js.map

package/dist/cjs/device/ComposedDevice.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ComposedDevice.js","sourceRoot":"","sources":["../../../src/device/ComposedDevice.ts"],"names":[],"mappings":";;;AAAA;;;;GAIG;AACH,+CAAyC;AAKzC;;;GAGG;AACH,MAAa,cAAe,SAAQ,sBAAQ;IACxC;;;;;;OAMG;IACH,YACI,WAA6C,EAC7C,UAAoB,EAAE,EACtB,UAAmB;QAEnB,KAAK,CAAC,WAAW,EAAE,EAAE,EAAE,UAAU,CAAC,CAAC;QACnC,OAAO,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC,CAAC;IACtD,CAAC;IAED;;;OAGG;IACH,SAAS,CAAC,MAAc;QACpB,IAAI,CAAC,gBAAgB,CAAC,MAAM,CAAC,CAAC;IAClC,CAAC;IAED;;;;OAIG;IACH,UAAU;QACN,OAAO,IAAI,CAAC,iBAAiB,EAAE,CAAC;IACpC,CAAC;IAED;;OAEG;IACgB,sBAAsB;QACrC,+GAA+G;QAC/G,oEAAoE;QACpE,oCAAoC;QACpC,OAAO;IACX,CAAC;CACJ;AA3CD,wCA2CC"}

package/dist/cjs/device/Device.d.ts

@@ -0,0 +1,91 @@
+/**
+ * @license
+ * Copyright 2022 The matter.js Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { DeviceTypeDefinition } from "./DeviceTypes.js";
+import { Endpoint } from "./Endpoint.js";
+import { AtLeastOne } from "../util/Array.js";
+import { HandlerFunction } from "../util/NamedHandler.js";
+import { ClusterClientObj } from "../cluster/client/ClusterClient.js";
+import { ClusterServerObj } from "../cluster/server/ClusterServer.js";
+import { Attributes, Cluster, Commands, Events } from "../cluster/Cluster.js";
+import { BitSchema, TypeFromBitSchema } from "../schema/BitmapSchema.js";
+/**
+ * Temporary used device class for paired devices until we added a layer to choose the right specialized device class
+ * based on the device classes and features of the paired device
+ */
+export declare class PairedDevice extends Endpoint {
+    private declineAddingMoreClusters;
+    /**
+     * Create a new PairedDevice instance. All data are automatically parsed from the paired device!
+     *
+     * @param definition DeviceTypeDefinitions of the paired device as reported by the device
+     * @param clusters Clusters of the paired device as reported by the device
+     * @param endpointId Endpoint ID of the paired device as reported by the device
+     */
+    constructor(definition: AtLeastOne<DeviceTypeDefinition>, clusters: (ClusterServerObj<Attributes, Commands> | ClusterClientObj<Attributes, Commands>)[] | undefined, endpointId: number);
+    /**
+     * @deprecated PairedDevice does not support adding additional clusters
+     */
+    addClusterServer<A extends Attributes, C extends Commands>(cluster: ClusterServerObj<A, C>): void;
+    /**
+     * @deprecated PairedDevice does not support adding additional clusters
+     */
+    addClusterClient<A extends Attributes, C extends Commands>(cluster: ClusterClientObj<A, C>): void;
+}
+/**
+ * Root endpoint of a device. This is used internally and not needed to be instanced by the user.
+ */
+export declare class RootEndpoint extends Endpoint {
+    readonly deviceType: number;
+    /**
+     * Create a new RootEndpoint instance. This is automatically instanced by the CommissioningServer class.
+     */
+    constructor();
+}
+/**
+ * Base class for all devices. This class should be extended by all devices.
+ */
+export declare class Device extends Endpoint {
+    readonly deviceType: number;
+    private commandHandler;
+    /**
+     * Create a new Device instance.
+     *
+     * @param definition DeviceTypeDefinitions of the device
+     * @param clusters Optional Array of clusters to be added to the device directly
+     * @param endpointId Optional endpoint ID of the device. If not set, the device will be instanced as a root device
+     */
+    constructor(definition: DeviceTypeDefinition, clusters?: (ClusterServerObj<Attributes, Commands> | ClusterClientObj<Attributes, Commands>)[], endpointId?: number);
+    /**
+     * Method to add command handlers to the device.
+     * The base class do not expose any commands!
+     *
+     * @param command Command name to add a handler for
+     * @param handler Handler function to be executed when the command is received
+     */
+    addCommandHandler(command: never, handler: HandlerFunction): void;
+    /**
+     * Method to remove command handlers from the device.
+     * The base class do not expose any commands!
+     *
+     * @param command Command name to remove the handler from
+     * @param handler Handler function to be removed
+     */
+    removeCommandHandler(command: never, handler: HandlerFunction): void;
+    /**
+     * Execute a command handler. Should only be used internally, but can not be declared as protected officially
+     * because needed public for derived classes.
+     *
+     * @protected
+     * @param command Command name to execute the handler for
+     * @param args Arguments to be passed to the handler
+     */
+    protected _executeHandler(command: never, ...args: any[]): Promise<void>;
+    protected createOptionalClusterServer<F extends BitSchema, SF extends TypeFromBitSchema<F>, A extends Attributes, C extends Commands, E extends Events>(_cluster: Cluster<F, SF, A, C, E>): ClusterServerObj<A, C>;
+    protected createOptionalClusterClient<F extends BitSchema, SF extends TypeFromBitSchema<F>, A extends Attributes, C extends Commands, E extends Events>(_cluster: Cluster<F, SF, A, C, E>): ClusterClientObj<A, C>;
+    getClusterServer<F extends BitSchema, SF extends TypeFromBitSchema<F>, A extends Attributes, C extends Commands, E extends Events>(cluster: Cluster<F, SF, A, C, E>): ClusterServerObj<A, C> | undefined;
+    getClusterClient<F extends BitSchema, SF extends TypeFromBitSchema<F>, A extends Attributes, C extends Commands, E extends Events>(cluster: Cluster<F, SF, A, C, E>): ClusterClientObj<A, C> | undefined;
+}
+//# sourceMappingURL=Device.d.ts.map

package/dist/cjs/device/Device.d.ts.map

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