@project-chip/matter.js 0.0.2 → 0.1.0

package/dist/es/cluster/AccessControlCluster.js

@@ -0,0 +1,102 @@
+/**
+ * @license
+ * Copyright 2022 Project CHIP Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { Cluster, WritableAttribute, Attribute, Event, OptionalWritableAttribute } from "./Cluster.js";
+import { TlvClusterId } from "../common/ClusterId.js";
+import { TlvEndpointNumber } from "../common/EndpointNumber.js";
+import { TlvDeviceTypeId } from "../common/DeviceTypeId.js";
+import { TlvNodeId } from "../common/NodeId.js";
+import { TlvSubjectId } from "../common/SubjectId.js";
+import { TlvField, TlvObject } from "../tlv/TlvObject.js";
+import { TlvNullable } from "../tlv/TlvNullable.js";
+import { TlvEnum, TlvUInt16 } from "../tlv/TlvNumber.js";
+import { TlvArray } from "../tlv/TlvArray.js";
+import { TlvByteString } from "../tlv/TlvString.js";
+/**
+ *
+ * Defines the clusters on this Node to which this Access Control Entry grants access.
+ *
+ * A single target SHALL contain at least one field (Cluster, Endpoint, or DeviceType), and SHALL NOT
+ * contain both an Endpoint field and a DeviceType field.
+ *
+ * @see {@link MatterCoreSpecificationV1_0} § 9.10.5.3
+ */
+const TlvTarget = TlvObject({
+    /** Cluster to grant access on. */
+    cluster: TlvField(0, TlvNullable(TlvClusterId)),
+    /** Endpoint to grant access on. */
+    endpoint: TlvField(1, TlvNullable(TlvEndpointNumber)),
+    /** Device type to grant access on. */
+    deviceType: TlvField(1, TlvNullable(TlvDeviceTypeId)),
+});
+/** @see {@link MatterCoreSpecificationV1_0} § 9.10.5.3 */
+const TlvAccessControlEntry = TlvObject({
+    /** Specifies the level of privilege granted by this Access Control Entry. */
+    privilege: TlvField(1, TlvEnum()),
+    /** Specifies the authentication mode required by this Access Control Entry. */
+    authMode: TlvField(2, TlvEnum()),
+    /** Specifies a list of Subject IDs, to which this Access Control Entry grants access. */
+    subjects: TlvField(3, TlvNullable(TlvArray(TlvSubjectId))),
+    /** Specifies a list of TargetStruct, which define the clusters on this Node to which this Access Control Entry grants access. */
+    targets: TlvField(4, TlvNullable(TlvArray(TlvTarget))), /* maxArrayLength: targetsPerAccessControlEntry */
+});
+/** @see {@link MatterCoreSpecificationV1_0} § 9.10.5.4 */
+const TlvAccessControlExtensionEntry = TlvObject({
+    /** Used by manufacturers to store arbitrary TLV-encoded data related to a fabric’s Access Control Entries. */
+    data: TlvField(1, TlvByteString.bound({ maxLength: 128 })),
+});
+/** @see {@link MatterCoreSpecificationV1_0} § 9.10.7.1 */
+const AccessChangeEvent = (entrySchema) => ({
+    /** The Node ID of the Administrator that made the change, if the change occurred via a CASE session. */
+    adminNodeID: TlvField(1, TlvNullable(TlvNodeId)),
+    /** The Passcode ID of the Administrator that made the change, if the change occurred via a PASE session. */
+    adminPasscodeID: TlvField(2, TlvNullable(TlvUInt16)),
+    /** The type of change as appropriate. */
+    changeType: TlvField(3, TlvEnum()),
+    /** The latest value of the changed entry. */
+    latestValue: TlvField(4, TlvNullable(entrySchema)),
+});
+/**
+ * The Access Control Cluster exposes a data model view of a Node’s Access Control List (ACL),
+ * which codifies the rules used to manage and enforce Access Control for the Node’s endpoints
+ * and their associated cluster instances. Access to this Access Control Cluster itself requires
+ * a special Administer privilege level, such that only Nodes granted such privilege (hereafter
+ * termed "Administrators") can manage the Access Control Cluster.
+ * The Access Control Cluster SHALL be present on the root node endpoint of each Node, and SHALL
+ * NOT be present on any other Endpoint of any Node.
+ *
+ * @see {@link MatterCoreSpecificationV1_0} § 9.10
+ */
+export const AccessControlCluster = Cluster({
+    id: 0x1f,
+    name: "Access Control",
+    revision: 1,
+    /** @see {@link MatterCoreSpecificationV1_0} § 9.10.5 */
+    attributes: {
+        /** Codifies a single grant of privilege on this Node. */
+        acl: WritableAttribute(0, TlvArray(TlvAccessControlEntry), { default: [], writeAcl: 2 /* AccessLevel.Administer */, readAcl: 2 /* AccessLevel.Administer */ }),
+        /** MAY be used by Administrators to store arbitrary data related to fabric’s Access Control Entries. */
+        extension: OptionalWritableAttribute(1, TlvArray(TlvAccessControlExtensionEntry), { default: [], writeAcl: 2 /* AccessLevel.Administer */, readAcl: 2 /* AccessLevel.Administer */ }),
+        /** Provide the minimum number of Subjects per entry that are supported by this server. */
+        subjectsPerAccessControlEntry: Attribute(2, TlvUInt16.bound({ min: 4 }), { default: 4 }),
+        /** Provides the minimum number of Targets per entry that are supported by this server. */
+        targetsPerAccessControlEntry: Attribute(3, TlvUInt16.bound({ min: 3 }), { default: 3 }),
+        /** Provides the minimum number of ACL Entries per fabric that are supported by this server. */
+        accessControlEntriesPerFabric: Attribute(4, TlvUInt16.bound({ min: 3 }), { default: 3 }),
+    },
+    /** @see {@link MatterCoreSpecificationV1_0} § 9.10.7 */
+    events: {
+        /**
+         * The cluster SHALL send AccessControlEntryChanged events whenever its ACL attribute data is changed by an
+         * Administrator.
+         */
+        accessControlEntryChanged: Event(0, 1 /* EventPriority.Info */, AccessChangeEvent(TlvAccessControlEntry)),
+        /**
+         * The cluster SHALL send AccessControlExtensionChanged events whenever its extension attribute data is changed
+         * by an Administrator.
+         */
+        accessControlExtensionChanged: Event(1, 1 /* EventPriority.Info */, AccessChangeEvent(TlvAccessControlExtensionEntry)), /* readAcl: AccessLevel.Administer */
+    },
+});

package/dist/es/cluster/BasicInformationCluster.js

@@ -0,0 +1,89 @@
+/**
+ * @license
+ * Copyright 2022 Project CHIP Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { TlvFabricIndex } from "../common/FabricIndex.js";
+import { TlvVendorId } from "../common/VendorId.js";
+import { TlvBoolean } from "../tlv/TlvBoolean.js";
+import { TlvUInt16, TlvUInt32 } from "../tlv/TlvNumber.js";
+import { TlvField, TlvObject } from "../tlv/TlvObject.js";
+import { TlvString, TlvString256max, TlvString32max, TlvString64max } from "../tlv/TlvString.js";
+import { Attribute, Cluster, Event, OptionalAttribute, OptionalEvent, OptionalWritableAttribute, WritableAttribute } from "./Cluster.js";
+/**
+ * Provides constant values related to overall global capabilities of this Node, that are not cluster-specific.
+ *
+ * @see {@link MatterCoreSpecificationV1_0} § 11.1.6.2
+ */
+const TlvCapabilityMinima = TlvObject({
+    /** Indicates the minimum number of concurrent CASE sessions that are supported per fabric. */
+    caseSessionsPerFabric: TlvField(0, TlvUInt16.bound({ min: 3 })),
+    /** Indicate the actual minimum number of concurrent subscriptions supported per fabric. */
+    subscriptionsPerFabric: TlvField(1, TlvUInt16.bound({ min: 3 })),
+});
+/**
+ * This cluster provides attributes and events for determining basic information about Nodes, which supports both
+ * commissioning and operational determination of Node characteristics, such as Vendor ID, Product ID and serial number,
+ * which apply to the whole Node. Also allows setting user device information such as location.
+ *
+ * @see {@link MatterCoreSpecificationV1_0} § 11.1
+ */
+export const BasicInformationCluster = Cluster({
+    id: 0x28,
+    name: "Basic Information",
+    revision: 1,
+    /** @see {@link MatterCoreSpecificationV1_0} § 11.1.6.3 */
+    attributes: {
+        /** Revision number of the Data Model against which the Node is certified */
+        dataModelRevision: Attribute(0, TlvUInt16),
+        /** Human-readable (displayable) name of the vendor for the Node. */
+        vendorName: Attribute(1, TlvString32max),
+        /** Specifies the {@link VendorId}. */
+        vendorId: Attribute(2, TlvVendorId),
+        /** Human-readable name of the model for the Node such as the model number assigned by the vendor. */
+        productName: Attribute(3, TlvString32max),
+        /** Product ID assigned by the vendor that is unique to the specific product of the Node. */
+        productId: Attribute(4, TlvUInt16),
+        /** User defined name for the Node. It is set during initial commissioning and may be updated by further reconfigurations. */
+        nodeLabel: WritableAttribute(5, TlvString32max, { default: "", writeAcl: 1 /* AccessLevel.Manage */ }),
+        /** ISO 3166-1 alpha-2 code where the Node is located. Might affect some regulatory aspects. */
+        location: WritableAttribute(6, TlvString.bound({ length: 2 }), { default: "XX", writeAcl: 2 /* AccessLevel.Administer */ }),
+        /** Version number of the hardware of the Node. The meaning of its value, and the versioning scheme, are vendor defined. */
+        hardwareVersion: Attribute(7, TlvUInt16, { default: 0 }),
+        /** Human-readable representation of the {@link BasicInformationCluster.attributes.hardwareVersion hardwareVersion} attribute. */
+        hardwareVersionString: Attribute(8, TlvString.bound({ minLength: 1, maxLength: 64 })),
+        /** Current version number for the software running on this Node. A larger value is newer than a lower value. */
+        softwareVersion: Attribute(9, TlvUInt32, { default: 0 }),
+        /** Human-readable representation of the {@link BasicInformationCluster.attributes.softwareVersion softwareVersion} attribute. */
+        softwareVersionString: Attribute(10, TlvString.bound({ minLength: 1, maxLength: 64 })),
+        /** Node manufacturing date formatted with YYYYMMDD. The additional 8 characters might include other vendor related information. */
+        manufacturingDate: OptionalAttribute(11, TlvString.bound({ minLength: 8, maxLength: 16 })),
+        /** Human-readable vendor assigned part number for the Node whose meaning and numbering scheme is vendor defined. */
+        partNumber: OptionalAttribute(12, TlvString32max),
+        /** Link to a product specific web page following the syntax as specified in RFC 3986. */
+        productURL: OptionalAttribute(13, TlvString256max),
+        /** Vendor specific human readable product label. */
+        productLabel: OptionalAttribute(14, TlvString64max),
+        /** Human readable serial number. */
+        serialNumber: OptionalAttribute(15, TlvString32max),
+        /** Allows to disable the ability to configure the Node through an on-Node user interface. */
+        localConfigDisabled: OptionalWritableAttribute(16, TlvBoolean, { default: false, writeAcl: 1 /* AccessLevel.Manage */ }),
+        /** Indicates whether the Node can be reached over the non-native network for bridged devices. */
+        reachable: OptionalAttribute(17, TlvBoolean, { default: true }),
+        /** Unique identifier for the device, which is constructed in a manufacturer specific manner, updated during factory reset. */
+        uniqueId: OptionalAttribute(18, TlvString32max),
+        /** Minimum guaranteed value for some system-wide, not cluster-specific, resource capabilities. */
+        capabilityMinima: Attribute(19, TlvCapabilityMinima, { default: { caseSessionsPerFabric: 3, subscriptionsPerFabric: 3 } }),
+    },
+    /** @see {@link MatterCoreSpecificationV1_0} § 11.1.6.5 */
+    events: {
+        /** First event fired as soon as reasonable after completing a boot or reboot process. */
+        startUp: Event(0, 0 /* EventPriority.Critical */, { softwareVersion: TlvField(0, TlvUInt32) }),
+        /** Last event fired prior to any orderly shutdown sequence on a best-effort basis. */
+        shutDown: OptionalEvent(1, 0 /* EventPriority.Critical */),
+        /** Fired prior to permanently leaving a given Fabric. */
+        leave: OptionalEvent(2, 1 /* EventPriority.Info */, { fabricIndex: TlvField(0, TlvFabricIndex) }),
+        /** Fired when there is a change in the {@link BasicInformationCluster.attributes.reachable reachable} attribute. */
+        reachableChanged: OptionalEvent(3, 1 /* EventPriority.Info */, { reachableNewValue: TlvField(0, TlvBoolean) }),
+    },
+});

package/dist/es/cluster/BindingCluster.js

@@ -0,0 +1,48 @@
+/**
+ * @license
+ * Copyright 2022 Project CHIP Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { Cluster, WritableAttribute } from "./Cluster.js";
+import { TlvClusterId } from "../common/ClusterId.js";
+import { TlvEndpointNumber } from "../common/EndpointNumber.js";
+import { TlvNodeId } from "../common/NodeId.js";
+import { TlvGroupId } from "../common/GroupId.js";
+import { TlvObject, TlvOptionalField } from "../tlv/TlvObject.js";
+import { TlvArray } from "../tlv/TlvArray.js";
+/**
+ * Provides information about endpoint conformance to a release of a device type definition.
+ *
+ * @see {@link MatterCoreSpecificationV1_0} § 9.5.5.1
+ */
+const TlvTarget = TlvObject({
+    /**  Contains the remote target node ID. If the Endpoint field is present, this field SHALL be present. */
+    node: TlvOptionalField(1, TlvNodeId),
+    /** Contains the target group ID that represents remote endpoints. If the Endpoint field is present, this field SHALL NOT be present. */
+    group: TlvOptionalField(2, TlvGroupId),
+    /** Contains the remote endpoint that the local endpoint is bound to. If the Group field is present, this field SHALL NOT be present. */
+    endpoint: TlvOptionalField(3, TlvEndpointNumber),
+    /**
+     * Contains the cluster ID (client & server) on the local and target endpoint(s). If this field is present, the
+     * client cluster SHALL also exist on this endpoint (with this Binding cluster). If this field is present, the
+     * target SHALL be this cluster on the target endpoint(s).
+     */
+    cluster: TlvOptionalField(4, TlvClusterId),
+});
+/**
+ * A binding represents a persistent relationship between an endpoint and one or more other local or
+ * remote endpoints. A binding does not require that the relationship exists. It is up to the node
+ * application to set up the relationship.
+ *
+ * @see {@link MatterCoreSpecificationV1_0} § 9.6
+ */
+export const BindingCluster = Cluster({
+    id: 0x1e,
+    name: "Binding",
+    revision: 1,
+    /** @see {@link MatterCoreSpecificationV1_0} § 9.6.5 */
+    attributes: {
+        /** List of device types and corresponding revisions declaring endpoint conformance. */
+        binding: WritableAttribute(0, TlvArray(TlvTarget), { default: [] }), /* non-volatile */
+    },
+});

package/dist/es/cluster/BridgedDeviceBasicInformationCluster.js

@@ -0,0 +1,72 @@
+/**
+ * @license
+ * Copyright 2022 Project CHIP Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { TlvFabricIndex } from "../common/FabricIndex.js";
+import { TlvVendorId } from "../common/VendorId.js";
+import { TlvBoolean } from "../tlv/TlvBoolean.js";
+import { TlvUInt16, TlvUInt32 } from "../tlv/TlvNumber.js";
+import { TlvField } from "../tlv/TlvObject.js";
+import { TlvString, TlvString256max, TlvString32max, TlvString64max } from "../tlv/TlvString.js";
+import { Attribute, Cluster, Event, OptionalAttribute, OptionalEvent, OptionalWritableAttribute } from "./Cluster.js";
+/**
+ * This Cluster serves two purposes towards a Node communicating with a Bridge:
+ * * indicate that the functionality on the Endpoint where it is placed (and its Parts) is bridged from a
+ *   non-Matter technology, and
+ * * provide a centralized collection of attributes that the Node MAY collect to aid in conveying information
+ *   regarding the Bridged Device to a user, such as the vendor name, the model name, or user-assigned name.
+ *
+ * This cluster is Derived from Basic Information Cluster.
+ *
+ * @see {@link MatterCoreSpecificationV1_0} § 9.13
+ */
+export const BridgedDeviceBasicInformationCluster = Cluster({
+    id: 0x39,
+    name: "Bridged Device Basic Information",
+    revision: 1,
+    /** @see {@link MatterCoreSpecificationV1_0} § 9.13.6 */
+    attributes: {
+        /** Human-readable (displayable) name of the vendor for the Node. */
+        vendorName: OptionalAttribute(1, TlvString32max),
+        /** Specifies the {@link VendorId}. */
+        vendorId: OptionalAttribute(2, TlvVendorId),
+        /** Human-readable name of the model for the Node such as the model number assigned by the vendor. */
+        productName: OptionalAttribute(3, TlvString32max),
+        /** User defined name for the Node. It is set during initial commissioning and may be updated by further reconfigurations. */
+        nodeLabel: OptionalWritableAttribute(5, TlvString32max, { default: "", writeAcl: 1 /* AccessLevel.Manage */ }),
+        /** Version number of the hardware of the Node. The meaning of its value, and the versioning scheme, are vendor defined. */
+        hardwareVersion: OptionalAttribute(7, TlvUInt16, { default: 0 }),
+        /** Human-readable representation of the {@link BasicInformationCluster.attributes.hardwareVersion hardwareVersion} attribute. */
+        hardwareVersionString: OptionalAttribute(8, TlvString.bound({ minLength: 1, maxLength: 64 })),
+        /** Current version number for the software running on this Node. A larger value is newer than a lower value. */
+        softwareVersion: OptionalAttribute(9, TlvUInt32, { default: 0 }),
+        /** Human-readable representation of the {@link BasicInformationCluster.attributes.softwareVersion softwareVersion} attribute. */
+        softwareVersionString: OptionalAttribute(10, TlvString.bound({ minLength: 1, maxLength: 64 })),
+        /** Node manufacturing date formatted with YYYYMMDD. The additional 8 characters might include other vendor related information. */
+        manufacturingDate: OptionalAttribute(11, TlvString.bound({ minLength: 8, maxLength: 16 })),
+        /** Human-readable vendor assigned part number for the Node whose meaning and numbering scheme is vendor defined. */
+        partNumber: OptionalAttribute(12, TlvString32max),
+        /** Link to a product specific web page following the syntax as specified in RFC 3986. */
+        productURL: OptionalAttribute(13, TlvString256max),
+        /** Vendor specific human readable product label. */
+        productLabel: OptionalAttribute(14, TlvString64max),
+        /** Human-readable serial number. */
+        serialNumber: OptionalAttribute(15, TlvString32max),
+        /** Indicates whether the bridged device is reachable by the bridge over the non-Matter network. */
+        reachable: Attribute(17, TlvBoolean, { default: true }),
+        /** Unique identifier for the device, which is constructed in a manufacturer specific manner, updated during factory reset. */
+        uniqueId: OptionalAttribute(18, TlvString32max),
+    },
+    /** @see {@link MatterCoreSpecificationV1_0} § 11.1.6.5 */
+    events: {
+        /** First event fired as soon as reasonable after completing a boot or reboot process. */
+        startUp: OptionalEvent(0, 0 /* EventPriority.Critical */, { softwareVersion: TlvField(0, TlvUInt32) }),
+        /** Last event fired prior to any orderly shutdown sequence on a best-effort basis. */
+        shutDown: OptionalEvent(1, 0 /* EventPriority.Critical */),
+        /** Fired prior to permanently leaving a given Fabric. */
+        leave: OptionalEvent(2, 1 /* EventPriority.Info */, { fabricIndex: TlvField(0, TlvFabricIndex) }),
+        /** Fired when there is a change in the {@link BasicInformationCluster.attributes.reachable reachable} attribute */
+        reachableChanged: Event(3, 1 /* EventPriority.Info */, { reachableNewValue: TlvField(0, TlvBoolean) }),
+    },
+});

package/dist/es/cluster/Cluster.js

@@ -0,0 +1,36 @@
+/**
+ * @license
+ * Copyright 2022 Project CHIP Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { TlvBitmap, TlvUInt16, TlvUInt32 } from "../tlv/TlvNumber.js";
+import { TlvObject } from "../tlv/TlvObject.js";
+import { TlvVoid } from "../tlv/TlvVoid.js";
+import { Merge } from "../util/Type.js";
+;
+export const Attribute = (id, schema, { default: conformanceValue, readAcl = 0 /* AccessLevel.View */ } = {}) => ({ id, schema, optional: false, writable: false, default: conformanceValue, readAcl });
+export const OptionalAttribute = (id, schema, { default: conformanceValue, readAcl = 0 /* AccessLevel.View */ } = {}) => ({ id, schema, optional: true, writable: false, default: conformanceValue, readAcl });
+export const WritableAttribute = (id, schema, { default: conformanceValue, readAcl = 0 /* AccessLevel.View */, writeAcl = 0 /* AccessLevel.View */ } = {}) => ({ id, schema, optional: false, writable: true, default: conformanceValue, readAcl, writeAcl });
+export const OptionalWritableAttribute = (id, schema, { default: conformanceValue, readAcl = 0 /* AccessLevel.View */, writeAcl = 0 /* AccessLevel.View */ } = {}) => ({ id, schema, optional: true, writable: true, default: conformanceValue, readAcl, writeAcl });
+/* Interfaces and helper methods to define a cluster command */
+export const TlvNoArguments = TlvObject({});
+export const TlvNoResponse = TlvVoid;
+;
+;
+export const Command = (requestId, requestSchema, responseId, responseSchema) => ({ optional: false, requestId, requestSchema, responseId, responseSchema });
+export const OptionalCommand = (requestId, requestSchema, responseId, responseSchema) => ({ optional: true, requestId, requestSchema, responseId, responseSchema });
+export const Event = (id, priority, data = {}) => ({ id, schema: TlvObject(data), priority, optional: false });
+export const OptionalEvent = (id, priority, data = {}) => ({ id, schema: TlvObject(data), priority, optional: true });
+export const GlobalAttributes = (features) => ({
+    clusterRevision: Attribute(0xFFFD, TlvUInt16),
+    featureMap: Attribute(0xFFFC, TlvBitmap(TlvUInt32, features)),
+});
+export const Cluster = ({ id, name, revision, features = {}, attributes = {}, commands = {}, events = {}, }) => ({
+    id,
+    name,
+    revision,
+    features,
+    commands,
+    attributes: Merge(attributes, GlobalAttributes(features)),
+    events,
+});

package/dist/es/cluster/DescriptorCluster.js

@@ -0,0 +1,50 @@
+/**
+ * @license
+ * Copyright 2022 Project CHIP Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { Attribute, Cluster } from "./Cluster.js";
+import { TlvDeviceTypeId } from "../common/DeviceTypeId.js";
+import { TlvClusterId } from "../common/ClusterId.js";
+import { TlvEndpointNumber } from "../common/EndpointNumber.js";
+import { TlvField, TlvObject } from "../tlv/TlvObject.js";
+import { TlvUInt16 } from "../tlv/TlvNumber.js";
+import { TlvArray } from "../tlv/TlvArray.js";
+/**
+ * Provides information about endpoint conformance to a release of a device type definition.
+ *
+ * @see {@link MatterCoreSpecificationV1_0} § 9.5.5.1
+ */
+const TlvDeviceType = TlvObject({
+    /** Indicates the device type definition */
+    type: TlvField(0, TlvDeviceTypeId),
+    /** Indicates the implemented revision of the device type definition */
+    revision: TlvField(1, TlvUInt16.bound({ min: 1 })),
+});
+/**
+ * This cluster describes an endpoint instance on the node, independently of other endpoints, but also
+ * allows composition of endpoints to conform to complex device type patterns.
+ * This Cluster is also meant to replace the support from the Zigbee Device Object (ZDO) for describing a node,
+ * its endpoints and clusters.
+ *
+ * @see {@link MatterCoreSpecificationV1_0} § 9.5
+ */
+export const DescriptorCluster = Cluster({
+    id: 0x1d,
+    name: "Descriptor",
+    revision: 1,
+    /** @see {@link MatterCoreSpecificationV1_0} § 9.5.4 */
+    attributes: {
+        /** List of device types and corresponding revisions declaring endpoint conformance. */
+        deviceTypeList: Attribute(0, TlvArray(TlvDeviceType, { minLength: 1 })),
+        /** List containing each cluster ID for the server clusters present on the endpoint instance. */
+        serverList: Attribute(1, TlvArray(TlvClusterId), { default: [] }),
+        /** List containing each cluster ID for the client clusters present on the endpoint instance. */
+        clientList: Attribute(3, TlvArray(TlvClusterId), { default: [] }),
+        /**
+         * This indicates composition of the device type instance. Device type instance composition SHALL
+         * include the endpoints in this list.
+         */
+        partsList: Attribute(4, TlvArray(TlvEndpointNumber), { default: [] }),
+    },
+});

package/dist/es/cluster/GeneralCommissioningCluster.js

@@ -0,0 +1,86 @@
+/**
+ * @license
+ * Copyright 2022 Project CHIP Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { Attribute, Cluster, Command, TlvNoArguments, WritableAttribute } from "./Cluster.js";
+import { TlvField, TlvObject } from "../tlv/TlvObject.js";
+import { TlvEnum, TlvUInt16, TlvUInt64 } from "../tlv/TlvNumber.js";
+import { TlvString } from "../tlv/TlvString.js";
+import { TlvBoolean } from "../tlv/TlvBoolean.js";
+/**
+ * This structure provides some constant values that MAY be of use to all commissioners.
+ *
+ * @see {@link MatterCoreSpecificationV1_0} § 11.9.5.2
+ */
+const TlvBasicCommissioningInfo = TlvObject({
+    /** Contains a conservative initial duration (in seconds) to set in the FailSafe for the commissioning flow to complete successfully. */
+    failSafeExpiryLengthSeconds: TlvField(0, TlvUInt16),
+    /** Contain a conservative value in seconds denoting the maximum total duration for which a fail-safe timer can be re-armed. */
+    maxCumulativeFailsafeSeconds: TlvField(1, TlvUInt16),
+});
+/**
+ * Used by the following commands as response payload:
+ * ArmFailSafeResponse, @see {@link MatterCoreSpecificationV1_0} § 11.9.7.3
+ * CommissioningCompleteResponse, @see {@link MatterCoreSpecificationV1_0} § 11.9.7.7
+ * CommissioningCompleteResponse, @see {@link MatterCoreSpecificationV1_0} § 11.9.7.7
+ */
+const TlvCommissioningSuccessFailureResponse = TlvObject({
+    /** Contain the result of the operation. */
+    errorCode: TlvField(0, TlvEnum()),
+    /** Should help developers in troubleshooting errors. The value MAY go into logs or crash reports, not User UIs. */
+    debugText: TlvField(1, TlvString.bound({ maxLength: 128 })),
+});
+/** @see {@link MatterCoreSpecificationV1_0} § 11.9.7.3. */
+const TlvArmFailSafeRequest = TlvObject({
+    /** Contains timeframe for fail-safe timer actions. */
+    expiryLengthSeconds: TlvField(0, TlvUInt16),
+    /** Value to atomically set the Breadcrumb attribute on success of this command. */
+    breadcrumbStep: TlvField(1, TlvUInt64),
+});
+/** @see {@link MatterCoreSpecificationV1_0} § 11.9.7.4 */
+const TlvSetRegulatoryConfigRequest = TlvObject({
+    /** Contains the new regulatory location to be set. */
+    newRegulatoryConfig: TlvField(0, TlvEnum()),
+    /** Contains a ISO 3166-1 alpha-2 country code*/
+    countryCode: TlvField(1, TlvString.bound({ length: 2 })),
+    /** Value to atomically set the Breadcrumb attribute on success of this command. */
+    breadcrumbStep: TlvField(2, TlvUInt64),
+});
+/**
+ * This cluster is used to manage global aspects of the Commissioning flow.
+ *
+ * @see {@link MatterCoreSpecificationV1_0} § 11.9
+ */
+export const GeneralCommissioningCluster = Cluster({
+    id: 0x30,
+    name: "General Commissioning",
+    revision: 1,
+    /** @see {@link MatterCoreSpecificationV1_0} § 11.9.6 */
+    attributes: {
+        /** Allows for the storage of a client-provided small payload which Administrators and Commissioners MAY write
+         * and then subsequently read, to keep track of their own progress.
+         */
+        breadcrumb: WritableAttribute(0, TlvUInt64, { default: BigInt(0), writeAcl: 2 /* AccessLevel.Administer */ }),
+        /** Describe critical parameters needed at the beginning of commissioning flow. */
+        commissioningInfo: Attribute(1, TlvBasicCommissioningInfo),
+        /** Indicates the regulatory configuration for the product. */
+        regulatoryConfig: Attribute(2, TlvEnum()),
+        /** Indicates if this Node needs to be told an exact RegulatoryLocation. */
+        locationCapability: Attribute(3, TlvEnum(), { default: 2 /* RegulatoryLocationType.IndoorOutdoor */ }),
+        /** Indicates whether this device supports "concurrent connection flow" commissioning mode */
+        supportsConcurrentConnections: Attribute(4, TlvBoolean, { default: true }),
+    },
+    /** @see {@link MatterCoreSpecificationV1_0} § 11.9.7 */
+    commands: {
+        /** Arms the persistent fail-safe timer with an expiry time of now + ExpiryLengthSeconds using device clock. */
+        armFailSafe: Command(0, TlvArmFailSafeRequest, 1, TlvCommissioningSuccessFailureResponse),
+        /** Sets or Updates the regulatory configuration to be used during commissioning. */
+        setRegulatoryConfig: Command(2, TlvSetRegulatoryConfigRequest, 3, TlvCommissioningSuccessFailureResponse),
+        /**
+         * Informs that all steps of Commissioning/Reconfiguration needed during the fail-safe period have been
+         * completed.
+         */
+        commissioningComplete: Command(4, TlvNoArguments, 5, TlvCommissioningSuccessFailureResponse),
+    },
+});

package/dist/es/cluster/GroupsCluster.js

@@ -0,0 +1,137 @@
+/**
+ * @license
+ * Copyright 2022 Project CHIP Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { Attribute, Cluster, Command, TlvNoArguments, TlvNoResponse } from "./Cluster.js";
+import { TlvGroupId } from "../common/GroupId.js";
+import { TlvField, TlvObject } from "../tlv/TlvObject.js";
+import { TlvString } from "../tlv/TlvString.js";
+import { TlvBitmap, TlvEnum, TlvUInt8 } from "../tlv/TlvNumber.js";
+import { TlvArray } from "../tlv/TlvArray.js";
+import { TlvNullable } from "../tlv/TlvNullable.js";
+import { BitFlag } from "../schema/BitmapSchema.js";
+/** @see {@link MatterApplicationClusterSpecificationV1_0} § 1.3.7.1 */
+const TlvAddGroupRequest = TlvObject({
+    groupId: TlvField(0, TlvGroupId),
+    groupName: TlvField(1, TlvString.bound({ maxLength: 16 })),
+});
+/** @see {@link MatterApplicationClusterSpecificationV1_0} § 1.3.7.7 */
+const TlvAddGroupResponse = TlvObject({
+    status: TlvField(0, TlvEnum()),
+    groupId: TlvField(1, TlvGroupId), /* type: min: 1 */
+});
+/** @see {@link MatterApplicationClusterSpecificationV1_0} § 1.3.7.2 */
+const TlvViewGroupRequest = TlvObject({
+    groupId: TlvField(0, TlvGroupId), /* type: min: 1 */
+});
+/** @see {@link MatterApplicationClusterSpecificationV1_0} § 1.3.7.8 */
+const TlvViewGroupResponse = TlvObject({
+    status: TlvField(0, TlvEnum()),
+    groupId: TlvField(1, TlvGroupId),
+    groupName: TlvField(2, TlvString.bound({ maxLength: 16 })),
+});
+/** @see {@link MatterApplicationClusterSpecificationV1_0} § 1.3.7.3 */
+const TlvGetGroupMembershipRequest = TlvObject({
+    groupList: TlvField(0, TlvArray(TlvGroupId)), /* groupId min: 1 */
+});
+/** @see {@link MatterApplicationClusterSpecificationV1_0} § 1.3.7.9 */
+const TlvGetGroupMembershipResponse = TlvObject({
+    /** contain the remaining capacity of the Group Table of the node. */
+    capacity: TlvField(0, TlvNullable(TlvUInt8)),
+    groupList: TlvField(1, TlvArray(TlvGroupId)), /* groupId min: 1 */
+});
+/** @see {@link MatterApplicationClusterSpecificationV1_0} § 1.3.7.4 */
+const TlvRemoveGroupRequest = TlvObject({
+    groupId: TlvField(0, TlvGroupId), /* min: 1 */
+});
+/** @see {@link MatterApplicationClusterSpecificationV1_0} § 1.3.7.10 */
+const TlvRemoveGroupResponse = TlvObject({
+    status: TlvField(0, TlvEnum()),
+    groupId: TlvField(1, TlvGroupId), /* min: 1 */
+});
+/**
+ * Formally not defined in specs state:
+ * If the RemoveAllGroups command was received as unicast and a response is not
+ * suppressed, the server SHALL generate a response with the Status field set to SUCCESS.
+ *
+ * @see {@link MatterApplicationClusterSpecificationV1_0} § 1.3.7.5.1
+ */
+const TlvRemoveAllGroupResponse = TlvObject({
+    status: TlvField(0, TlvEnum()),
+});
+/** @see {@link MatterApplicationClusterSpecificationV1_0} § 1.3.7.6 */
+const TlvAddGroupIfIdentifyingRequest = TlvObject({
+    groupId: TlvField(0, TlvGroupId),
+    groupName: TlvField(1, TlvString.bound({ maxLength: 16 })),
+});
+/** @see {@link MatterApplicationClusterSpecificationV1_0} § 1.3.6.1 */
+const TlvNameSupportBitmap = TlvBitmap(TlvUInt8, {
+    groupNames: BitFlag(7),
+});
+/**
+ * The Groups cluster manages, per endpoint, the content of the node-wide Group
+ * Table that is part of the underlying interaction layer.
+ *
+ * @see {@link MatterApplicationClusterSpecificationV1_0} § 1.3
+ */
+export const GroupsCluster = Cluster({
+    id: 0x04,
+    name: "Groups",
+    revision: 4,
+    features: {
+        /** The ability to store a name for a group. */
+        groupNames: BitFlag(0),
+    },
+    /** @see {@link MatterApplicationClusterSpecificationV1_0} § 1.3.6 */
+    attributes: {
+        /**
+         * This attribute provides legacy, read-only access to whether the Group
+         * Names feature is supported. The most significant bit, bit 7, SHALL be
+         * equal to bit 0 of the FeatureMap attribute. All other bits SHALL be 0.
+         *
+         * TODO because we (will) support group names we need to set bit 7 to 1, rest is 0
+         */
+        nameSupport: Attribute(0, TlvNameSupportBitmap, { default: { groupNames: true } }),
+    },
+    /** @see {@link MatterApplicationClusterSpecificationV1_0} § 1.3.7 */
+    commands: {
+        /**
+         * The AddGroup command allows a client to add group membership in a particular group for the server endpoint.
+         */
+        addGroup: Command(0, TlvAddGroupRequest, 0, TlvAddGroupResponse),
+        /**
+         * The ViewGroup command allows a client to request that the server responds with a ViewGroupResponse command
+         * containing the name string for a particular group.
+         *
+         */
+        viewGroup: Command(1, TlvViewGroupRequest, 0, TlvViewGroupResponse),
+        /**
+         * The GetGroupMembership command allows a client to inquire about the group membership of the server endpoint,
+         * in a number of ways.
+         */
+        getGroupMembership: Command(2, TlvGetGroupMembershipRequest, 2, TlvGetGroupMembershipResponse),
+        /**
+         * The RemoveGroup command allows a client to request that the server removes the membership for the server
+         * endpoint, if any, in a particular group.
+         */
+        removeGroup: Command(3, TlvRemoveGroupRequest, 3, TlvRemoveGroupResponse),
+        /**
+         * The RemoveAllGroups command allows a client to direct the server to remove all group associations for the
+         * server endpoint.
+         *
+         * TODO: According to specs the response might be suppressed:
+         * If the RemoveAllGroups command was received as unicast and a response is not suppressed, the server
+         * SHALL generate a response with the Status field set to SUCCESS.
+         * Else potentially no response?
+         *
+         */
+        removeAllGroups: Command(4, TlvNoArguments, 4, TlvRemoveAllGroupResponse),
+        /**
+         * The AddGroupIfIdentifying command allows a client to add group membership in a particular group for the
+         * server endpoint, on condition that the endpoint is identifying itself.
+         *
+         */
+        addGroupIfIdentifying: Command(5, TlvAddGroupIfIdentifyingRequest, 5, TlvNoResponse),
+    }
+});