@project-chip/matter.js 0.0.2 → 0.2.0

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),
+    }
+});

package/dist/es/cluster/IdentifyCluster.js

@@ -0,0 +1,52 @@
+/**
+ * @license
+ * Copyright 2022 Project CHIP Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { Attribute, WritableAttribute, Cluster, Command, OptionalCommand, TlvNoResponse, TlvNoArguments } from "./Cluster.js";
+import { TlvField, TlvObject } from "../tlv/TlvObject.js";
+import { TlvEnum, TlvUInt16 } from "../tlv/TlvNumber.js";
+import { BitFlag } from "../schema/BitmapSchema.js";
+/** @see {@link MatterApplicationClusterSpecificationV1_0} § 1.2.6.1 */
+const TlvIdentifyRequest = TlvObject({
+    identifyTime: TlvField(0, TlvUInt16),
+});
+/** @see {@link MatterApplicationClusterSpecificationV1_0} § 1.2.6.3 */
+const TlvTriggerEffectRequest = TlvObject({
+    effectIdentifier: TlvField(0, TlvEnum()),
+    effectVariant: TlvField(1, TlvEnum()),
+});
+/** @see {@link MatterApplicationClusterSpecificationV1_0} § 1.2.6.4 */
+const TlvIdentifyQueryResponse = TlvObject({
+    timeout: TlvField(0, TlvUInt16),
+});
+/**
+ * Attributes and commands for putting a device into Identification mode (e.g. flashing a light).
+ *
+ * @see {@link MatterApplicationClusterSpecificationV1_0} § 1.2
+ */
+export const IdentifyCluster = Cluster({
+    id: 0x03,
+    name: "Identify",
+    revision: 4,
+    features: {
+        /** Replies to multicast / groupcast queries if the identification state is active. */
+        query: BitFlag(0),
+    },
+    /** @see {@link MatterApplicationClusterSpecificationV1_0} § 1.2.5 */
+    attributes: {
+        /** Specifies the remaining length of time, in seconds, that the endpoint will continue to identify itself. */
+        identifyTime: WritableAttribute(0, TlvUInt16, { default: 0 }),
+        /** Specifies how the identification state is presented to the user. */
+        identifyType: Attribute(1, TlvEnum(), { default: 0 }),
+    },
+    /** @see {@link MatterApplicationClusterSpecificationV1_0} § 1.2.6 */
+    commands: {
+        /** Starts or stops the receiving device identifying itself. */
+        identify: Command(0, TlvIdentifyRequest, 0, TlvNoResponse),
+        /** Request the target or targets to respond if they are currently identifying themselves. */
+        identifyQuery: Command(1, TlvNoArguments, 0, TlvIdentifyQueryResponse),
+        /** Allows the support of feedback to the user, such as a certain light effect when identifying. */
+        triggerEffect: OptionalCommand(0x40, TlvTriggerEffectRequest, 0, TlvNoResponse),
+    },
+});

package/dist/es/cluster/LabelCluster.js

@@ -0,0 +1,52 @@
+/**
+ * @license
+ * Copyright 2022 Project CHIP Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { Attribute, Cluster, WritableAttribute } from "./Cluster.js";
+import { TlvField, TlvObject } from "../tlv/TlvObject.js";
+import { TlvString } from "../tlv/TlvString.js";
+import { TlvArray } from "../tlv/TlvArray.js";
+/**
+ * This is a string tuple with strings that are user defined.
+ *
+ * @see {@link MatterCoreSpecificationV1_0} § 9.7.5.1
+ */
+const TlvLabel = TlvObject({
+    /** Contains a string as label without a further defined semantic n this base cluster. */
+    label: TlvField(0, TlvString.bound({ length: 16 })),
+    /** Contains a string as value without a further defined semantic n this base cluster. */
+    value: TlvField(1, TlvString.bound({ length: 16 })), /* default: "" */
+});
+/**
+ * This cluster provides a feature to tag an endpoint with zero or more labels.
+ * Derived from LabelCluster ({@link MatterCoreSpecificationV1_0} § 9.7)
+ *
+ * @see {@link MatterCoreSpecificationV1_0} § 9.9
+ */
+export const UserLabelCluster = Cluster({
+    id: 0x41,
+    name: "User Label",
+    revision: 1,
+    /** @see {@link MatterCoreSpecificationV1_0} § 9.9.4 */
+    attributes: {
+        /** An implementation SHALL support at least 4 list entries per node for all User Label cluster instances on the node. */
+        labelList: WritableAttribute(0, TlvArray(TlvLabel), { default: [], writeAcl: 1 /* AccessLevel.Manage */ }), /* non-volatile */
+    },
+});
+/**
+ * This cluster provides a feature for the device to tag an endpoint with zero or more read only labels.
+ * Derived from LabelCluster ({@link MatterCoreSpecificationV1_0} § 9.7)
+ *
+ * @see {@link MatterCoreSpecificationV1_0} § 9.8
+ */
+export const FixedLabelCluster = Cluster({
+    id: 0x40,
+    name: "Fixed Label",
+    revision: 1,
+    /** @see {@link MatterCoreSpecificationV1_0} § 9.8.4 */
+    attributes: {
+        /** List of fixed labels. */
+        labelList: Attribute(0, TlvArray(TlvLabel), { default: [] }), /* non-volatile */
+    },
+});

package/dist/es/cluster/OnOffCluster.js

@@ -0,0 +1,102 @@
+/**
+ * @license
+ * Copyright 2022 Project CHIP Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { Attribute, Cluster, Command, TlvNoArguments, TlvNoResponse } from "./Cluster.js";
+import { BitFlag } from "../schema/BitmapSchema.js";
+import { TlvBoolean } from "../tlv/TlvBoolean.js";
+/** @see {@link MatterApplicationClusterSpecificationV1_0} § 1.5.7.4.2 */
+// const TlvEffectVariant = TlvUInt8 as TlvSchema<DyingLightEffectVariant | DelayedAllOffEffectVariant>;
+/** @see {@link MatterApplicationClusterSpecificationV1_0} § 1.5.7.4 */
+/* const TlvOffWithEffectRequest = TlvObject({
+    effectIdentifier: TlvField(0, TlvEnum<OnOffEffectIdentifier>()),
+    effectVariant: TlvField(1, TlvEffectVariant),
+}) as TlvSchema<
+    { effectIdentifier: OnOffEffectIdentifier.DelayedAllOff, effectVariant: DelayedAllOffEffectVariant } |
+    { effectIdentifier: OnOffEffectIdentifier.DyingLight, effectVariant: DyingLightEffectVariant }
+    >; */
+/** @see {@link MatterApplicationClusterSpecificationV1_0} § 1.5.7.4.2 */
+/* const TlvOnOffControlBitmap = TlvBitmap(TlvUInt8, {
+    acceptOnlyWhenOn: BitFlag(1),
+}) */
+/** @see {@link MatterApplicationClusterSpecificationV1_0} § 1.5.7.6. */
+/* const TlvOnWithTimedOffRequest = TlvObject({
+    onOffControl: TlvField(0, TlvOnOffControlBitmap),
+    onTime: TlvField(1, TlvNullable(TlvUInt8.bound({ min: 0, max: 254 }))),
+    offWaitTime: TlvField(2, TlvNullable(TlvUInt8.bound({ min: 0, max: 254 }))),
+}); */
+/**
+ * Attributes and commands for switching devices between 'On' and 'Off' states.
+ *
+ * @see {@link MatterApplicationClusterSpecificationV1_0} § 1.5
+ */
+export const OnOffCluster = Cluster({
+    id: 0x06,
+    name: "On/Off",
+    revision: 4,
+    features: {
+        /** Level Control for Lighting - Behavior that supports lighting applications */
+        lightingLevelControl: BitFlag(0),
+    },
+    /** @see {@link MatterApplicationClusterSpecificationV1_0} § 1.5.6 */
+    attributes: {
+        /** Indicates whether the device type implemented on the endpoint is turned off (false) or turned on (true). */
+        onOff: Attribute(0, TlvBoolean, { default: false }), /* reportable: true, scene:true */
+        // The following attributes are only needed for "Level Control for Lighting" support
+        /** Used to remember if a state is already storednin an old scene to not store one again when sending another Off command */
+        //globalSceneControl: OptionalAttribute(0x4000,  TlvBoolean, { default: true }),
+        /**
+         * Specifies the length of time (in 1/10ths second) that the ‘On’ state SHALL be maintained before
+         * automatically transitioning to the ‘Off’ state when using the OnWithTimedOff command.
+         */
+        //onTime: OptionalWritableAttribute(0x4001, TlvNullable(TlvUInt16)), { default: 0 }), /* unit: 1/10s */
+        /**
+         * Specifies the length of time (in 1/10ths second) that the ‘Off’ state SHALL be guarded to prevent
+         * another OnWithTimedOff command turning the server back to its ‘On’ state
+         */
+        //offWaitTime: OptionalWritableAttribute(0x4002, TlvNullable(TlvUInt16), { default: 0 }), /* unit: 1/10s */
+        /** Defines the desired startup behavior of a device when it is supplied with power. */
+        //startUpOnOff: OptionalWritableAttribute(0x4003, TlvNullable(TlvEnum<StartUpOnOff>()), { writeAcl: AccessLevel.Manage }),
+    },
+    /** @see {@link MatterApplicationClusterSpecificationV1_0} § 1.5.7 */
+    commands: {
+        /**
+         * On receipt of this command, a device SHALL enter its ‘Off’ state. This state is device dependent, but it is
+         * recommended that it is used for power off or similar functions. On receipt of the Off command, the OnTime
+         * attribute SHALL be set to 0.
+         */
+        off: Command(0, TlvNoArguments, 0, TlvNoResponse),
+        /**
+         * On receipt of this command, a device SHALL enter its ‘On’ state. This state is device dependent, but it is
+         * recommended that it is used for power on or similar functions. On receipt of the On command, if the value
+         * of the OnTime attribute is equal to 0, the device SHALL set the OffWaitTime attribute to 0.
+         */
+        on: Command(1, TlvNoArguments, 1, TlvNoResponse),
+        /**
+         * On receipt of this command, if a device is in its ‘Off’ state it SHALL enter its ‘On’ state. Otherwise,
+         * if it is in its ‘On’ state it SHALL enter its ‘Off’ state. On receipt of the Toggle command, if the value
+         * of the OnOff attribute is equal to FALSE and if the value of the OnTime attribute is equal to 0, the device
+         * SHALL set the OffWaitTime attribute to 0. If the value of the OnOff attribute is equal to TRUE, the OnTime
+         * attribute SHALL be set to 0.
+         */
+        toggle: Command(2, TlvNoArguments, 2, TlvNoResponse),
+        // The following attributes are only needed for "Level Control for Lighting" support
+        // So we declare them option for now!
+        // TODO: Split these out into a separate Cluster Spec that adds "Level Control for Lighting" support
+        /**
+         * The OffWithEffect command allows devices to be turned off using enhanced ways of fading.
+         */
+        //offWithEffect: OptionalCommand(0x40, OffWithEffectRequestT, 0x40, NoResponseT),
+        /**
+         * The OnWithRecallGlobalScene command allows the recall of the settings when the device was turned off.
+         */
+        //onWithRecallGlobalScene: OptionalCommand(0x41, NoArgumentsT, 0x41, NoResponseT),
+        /**
+         * The OnWithTimedOff command allows devices to be turned on for a specific duration with a guarded off
+         * duration so that SHOULD the device be subsequently switched off, further OnWithTimedOff commands, received
+         * during this time, are prevented from turning the devices back on.
+         */
+        //onWithTimedOff: OptionalCommand(0x42, OnWithTimedOffRequestT, 0x42, NoResponseT),
+    },
+});