@project-chip/matter.js 0.0.1 → 0.1.0

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

package/dist/es/cluster/OperationalCredentialsCluster.js

@@ -0,0 +1,202 @@
+/**
+ * @license
+ * Copyright 2022 Project CHIP Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { TlvVendorId } from "../common/VendorId.js";
+import { TlvNodeId } from "../common/NodeId.js";
+import { TlvSubjectId } from "../common/SubjectId.js";
+import { TlvFabricId } from "../common/FabricId.js";
+import { TlvFabricIndex } from "../common/FabricIndex.js";
+import { Attribute, Cluster, Command, TlvNoResponse } from "./Cluster.js";
+import { TlvField, TlvObject, TlvOptionalField } from "../tlv/TlvObject.js";
+import { TlvByteString, TlvString, TlvString32max } from "../tlv/TlvString.js";
+import { TlvNullable } from "../tlv/TlvNullable.js";
+import { TlvBoolean } from "../tlv/TlvBoolean.js";
+import { TlvEnum, TlvUInt32, TlvUInt8 } from "../tlv/TlvNumber.js";
+import { TlvArray } from "../tlv/TlvArray.js";
+/** @see {@link MatterCoreSpecificationV1_0} § 11.17.5.1 */
+export const RESP_MAX = 900;
+/**
+ * Encodes a Fabric Reference for a fabric within which a given Node is currently commissioned.
+ *
+ * @see {@link MatterCoreSpecificationV1_0} § 11.17.5.3
+ */
+const TlvFabricDescriptor = TlvObject({
+    /** Contains the public key for the trusted root that scopes the fabric referenced by FabricIndex and its associated operational credential. */
+    rootPublicKey: TlvField(1, TlvByteString.bound({ length: 65 })),
+    /** Contains the value of AdminVendorID provided in the AddNOC command that led to the creation of this FabricDescriptorStruct. */
+    vendorId: TlvField(2, TlvVendorId),
+    /** Contains the FabricID allocated to the fabric referenced by FabricIndex. */
+    fabricID: TlvField(3, TlvFabricId),
+    /** Contain the NodeID in use within the fabric referenced by FabricIndex. */
+    nodeID: TlvField(4, TlvNodeId),
+    /** Contains a commissioner-set label for the fabric referenced by FabricIndex. */
+    label: TlvField(5, TlvString.bound({ maxLength: 32 })), /* default: "" */
+});
+/**
+ * Encodes a fabric sensitive NOC chain, underpinning a commissioned Operational Identity for a given Node.
+ *
+ * @see {@link MatterCoreSpecificationV1_0} § 11.17.5.2
+ */
+const TlvNoc = TlvObject({
+    /** Contains the NOC for the struct’s associated fabric. */
+    noc: TlvField(1, TlvByteString.bound({ maxLength: 400 })),
+    /** Contain the ICAC or the struct’s associated fabric. */
+    icac: TlvField(2, TlvNullable(TlvByteString.bound({ maxLength: 400 }))), /* default(not present): null */
+});
+/** @see {@link MatterCoreSpecificationV1_0} § 11.17.7.1 */
+const TlvAttestationRequest = TlvObject({
+    /** Contains the attestation nonce to be used in the computation of the Attestation Information. */
+    attestationNonce: TlvField(0, TlvByteString.bound({ length: 32 })),
+});
+/** @see {@link MatterCoreSpecificationV1_0} § 11.17.7.2 */
+const TlvAttestationResponse = TlvObject({
+    /** Contains the octet string of the serialized attestation_elements_message. */
+    elements: TlvField(0, TlvByteString.bound({ maxLength: RESP_MAX })),
+    /** Contain the octet string of the necessary attestation_signature. */
+    signature: TlvField(1, TlvByteString.bound({ length: 64 })),
+});
+/** @see {@link MatterCoreSpecificationV1_0} § 11.17.7.5 */
+const TlvCertSigningRequestRequest = TlvObject({
+    /** Contains the CSRNonce to be used in the computation of the NOCSR information. */
+    certSigningRequestNonce: TlvField(0, TlvByteString.bound({ length: 32 })),
+    /**
+     * If set to true, the internal state of the CSR associated keypair SHALL be tagged as being for
+     * a subsequent UpdateNOC, otherwise the internal state of the CSR SHALL be tagged as being for a
+     * subsequent AddNOC
+     * */
+    isForUpdateNOC: TlvOptionalField(1, TlvBoolean), /* default: false */
+});
+/** @see {@link MatterCoreSpecificationV1_0} § 11.17.7.6 */
+const TlvCertSigningRequestResponse = TlvObject({
+    /** Contains the octet string of the serialized nocsr_elements_message. */
+    elements: TlvField(0, TlvByteString.bound({ maxLength: RESP_MAX })),
+    /** Contain the octet string of the necessary attestation_signature. */
+    signature: TlvField(1, TlvByteString.bound({ length: 64 })),
+});
+/** @see {@link MatterCoreSpecificationV1_0} § 11.17.7.3 */
+const TlvCertChainRequest = TlvObject({
+    /** Contains the type of certificate to be requested. */
+    type: TlvField(0, TlvEnum()),
+});
+/** @see {@link MatterCoreSpecificationV1_0} § 11.17.7.4 */
+const TlvCertChainResponse = TlvObject({
+    /** Contains the octet string of the requested certificate. */
+    certificate: TlvField(0, TlvByteString.bound({ maxLength: 600 })),
+});
+/** @see {@link MatterCoreSpecificationV1_0} § 11.17.7.8 */
+const TlvAddNocRequest = TlvObject({
+    /** Contains the Node Operational Certificate (NOC) to be added. */
+    operationalCert: TlvField(0, TlvByteString.bound({ maxLength: 400 })),
+    /** Contains the Intermediate CA Certificate (ICAC). */
+    intermediateCaCert: TlvOptionalField(1, TlvByteString.bound({ maxLength: 400 })),
+    /** Contains the value of the Epoch Key for the Identity Protection Key (IPK) to set for the Fabric which is to be added. */
+    identityProtectionKey: TlvField(2, TlvByteString.bound({ length: 16 })),
+    /**
+     * Used to atomically add an Access Control Entry enabling that Subject to subsequently administer
+     * the Node whose operational identity is being added by this command.
+     */
+    caseAdminNode: TlvField(3, TlvSubjectId),
+    /** Contains the Vendor ID of the entity issuing the AddNOC command. */
+    adminVendorId: TlvField(4, TlvVendorId),
+});
+/** @see {@link MatterCoreSpecificationV1_0} § 11.17.7.9 */
+const TlvUpdateNocRequest = TlvObject({
+    /** Contains the Node Operational Certificate (NOC). */
+    operationalCert: TlvField(0, TlvByteString.bound({ maxLength: 400 })),
+    /** Contains the Intermediate CA Certificate (ICAC). */
+    intermediateCaCert: TlvOptionalField(1, TlvByteString.bound({ maxLength: 400 })),
+});
+/** @see {@link MatterCoreSpecificationV1_0} § 11.17.7.13 */
+const TlvAddTrustedRootCertificateRequest = TlvObject({
+    /** Contains the Trusted Root Certificate (TRC) to be added. */
+    certificate: TlvField(0, TlvByteString.bound({ maxLength: 400 })),
+});
+/** @see {@link MatterCoreSpecificationV1_0} § 11.17.7.10 */
+const TlvOperationalCertificateStatusResponse = TlvObject({
+    /** Contains a NOCStatus value representing the status of an operation involving a NOC. */
+    status: TlvField(0, TlvEnum()),
+    /** When action was successful, contains the Fabric Index of the Fabric last added, removed or updated. */
+    fabricIndex: TlvOptionalField(1, TlvFabricIndex),
+    /** Optionally contains debugging textual information from the cluster implementation and should be visible in logs, not User UI */
+    debugText: TlvOptionalField(2, TlvString.bound({ maxLength: 128 })),
+});
+/** @see {@link MatterCoreSpecificationV1_0} § 11.17.5.4 */
+export const TlvAttestation = TlvObject({
+    declaration: TlvField(1, TlvByteString),
+    attestationNonce: TlvField(2, TlvByteString.bound({ length: 32 })),
+    timestamp: TlvField(3, TlvUInt32),
+    firmwareInfo: TlvOptionalField(4, TlvByteString),
+});
+/** @see {@link MatterCoreSpecificationV1_0} § 11.17.5.6 */
+export const TlvCertSigningRequest = TlvObject({
+    certSigningRequest: TlvField(1, TlvByteString),
+    certSigningRequestNonce: TlvField(2, TlvByteString.bound({ length: 32 })),
+    vendorReserved1: TlvOptionalField(3, TlvByteString),
+    vendorReserved2: TlvOptionalField(4, TlvByteString),
+    vendorReserved3: TlvOptionalField(5, TlvByteString),
+});
+/** @see {@link MatterCoreSpecificationV1_0} § 11.17.7.11 */
+const TlvUpdateFabricLabelRequest = TlvObject({
+    /** Contains the label to set for the fabric associated with the current secure session. */
+    label: TlvField(0, TlvString32max),
+});
+/** @see {@link MatterCoreSpecificationV1_0} § 11.17.7.12 */
+const TlvRemoveFabricRequest = TlvObject({
+    /** Contains the Fabric Index reference associated with the Fabric which is to be removed from the device. */
+    fabricIndex: TlvField(0, TlvFabricIndex),
+});
+/**
+ * This cluster is used to add or remove Operational Credentials on a Commissionee or Node, as well as manage the
+ * associated Fabrics.
+ *
+ * @see {@link MatterCoreSpecificationV1_0} § 11.17
+ */
+export const OperationalCredentialsCluster = Cluster({
+    id: 0x3e,
+    name: "Operational Credentials",
+    revision: 1,
+    /** @see {@link MatterCoreSpecificationV1_0} § 11.17.6 */
+    attributes: {
+        /** Contains all NOCs applicable to this Node. */
+        nocs: Attribute(0, TlvArray(TlvNoc), { readAcl: 2 /* AccessLevel.Administer */ }),
+        /** Describes all fabrics to which this Node is commissioned. */
+        fabrics: Attribute(1, TlvArray(TlvFabricDescriptor)),
+        /** Contains the number of Fabrics that are supported by the device. */
+        supportedFabrics: Attribute(2, TlvUInt8.bound({ min: 5, max: 254 })),
+        /** Contains the number of Fabrics to which the device is currently commissioned. */
+        commissionedFabrics: Attribute(3, TlvUInt8),
+        /** Contains a read-only list of Trusted Root CA Certificates installed on the Node. */
+        trustedRootCertificates: Attribute(4, TlvArray(TlvByteString, { maxLength: 400 })),
+        /** Contain accessing fabric index. */
+        currentFabricIndex: Attribute(5, TlvUInt8),
+    },
+    /** @see {@link MatterCoreSpecificationV1_0} § 11.17.7 */
+    commands: {
+        /** Sender is requesting attestation information from the receiver. */
+        requestAttestation: Command(0, TlvAttestationRequest, 1, TlvAttestationResponse),
+        /** Sender is requesting a device attestation certificate from the receiver. */
+        requestCertChain: Command(2, TlvCertChainRequest, 3, TlvCertChainResponse),
+        /** Sender is requesting a certificate signing request (CSR) from the receiver. */
+        requestCertSigning: Command(4, TlvCertSigningRequestRequest, 5, TlvCertSigningRequestResponse),
+        /** Sender is requesting to add the new node operational certificates. */
+        addOperationalCert: Command(6, TlvAddNocRequest, 8, TlvOperationalCertificateStatusResponse),
+        /** Sender is requesting to update the node operational certificates. */
+        updateOperationalCert: Command(7, TlvUpdateNocRequest, 8, TlvOperationalCertificateStatusResponse),
+        /**
+         * This command SHALL be used by an Administrative Node to set the user-visible Label field for a given
+         * Fabric, as reflected by entries in the Fabrics attribute.
+         */
+        updateFabricLabel: Command(9, TlvUpdateFabricLabelRequest, 8, TlvOperationalCertificateStatusResponse),
+        /**
+         * This command is used by Administrative Nodes to remove a given fabric index and delete all associated
+         * fabric-scoped data.
+         */
+        removeFabric: Command(10, TlvRemoveFabricRequest, 8, TlvOperationalCertificateStatusResponse),
+        /**
+         * This command SHALL add a Trusted Root CA Certificate, provided as its CHIP Certificate representation.
+         */
+        addRootCert: Command(11, TlvAddTrustedRootCertificateRequest, 11, TlvNoResponse),
+    },
+});