matter-clusters 0.3.0

//! GroupKeyManagement cluster (0x003F).
//! @generated by `cargo xtask codegen` — do not edit.

#![allow(
    clippy::all,
    clippy::pedantic,
    dead_code,
    unreachable_pub,
    unused_imports
)]

use crate::datatypes::SemanticTagStruct;
use crate::error::ClusterError;
use crate::types::Nullable;
use matter_codec::{ContainerKind, Element, Tag, TlvReader, TlvWriter, Value};

/// Cluster ID.
pub const CLUSTER_ID: u32 = 0x003F;
/// Cluster revision.
pub const CLUSTER_REVISION: u16 = 2;

/// Command IDs (requests and responses).
pub mod command_id {
    /// `KeySetWrite` (request).
    pub const KEY_SET_WRITE: u32 = 0x00;
    /// `KeySetRead` (request).
    pub const KEY_SET_READ: u32 = 0x01;
    /// `KeySetReadResponse` (response).
    pub const KEY_SET_READ_RESPONSE: u32 = 0x02;
    /// `KeySetRemove` (request).
    pub const KEY_SET_REMOVE: u32 = 0x03;
    /// `KeySetReadAllIndices` (request).
    pub const KEY_SET_READ_ALL_INDICES: u32 = 0x04;
    /// `KeySetReadAllIndicesResponse` (response).
    pub const KEY_SET_READ_ALL_INDICES_RESPONSE: u32 = 0x05;
}

/// Attribute IDs (cluster-specific).
pub mod attribute_id {
    /// `GroupKeyMap`.
    pub const GROUP_KEY_MAP: u32 = 0x0000;
    /// `GroupTable`.
    pub const GROUP_TABLE: u32 = 0x0001;
    /// `MaxGroupsPerFabric`.
    pub const MAX_GROUPS_PER_FABRIC: u32 = 0x0002;
    /// `MaxGroupKeysPerFabric`.
    pub const MAX_GROUP_KEYS_PER_FABRIC: u32 = 0x0003;
}

bitflags::bitflags! {
    /// `GroupKeyManagement` feature bits (FeatureMap).
    #[derive(Copy, Clone, Debug, PartialEq, Eq, Hash)]
    pub struct Feature: u32 {
        /// CacheAndSync (CS).
        const CS = 1 << 0;
    }
}

/// `GroupInfoMapStruct` struct.
#[derive(Clone, Debug, PartialEq)]
#[non_exhaustive]
pub struct GroupInfoMapStruct {
    /// Field GroupId (tag 1).
    pub group_id: u16,
    /// Field Endpoints (tag 2).
    pub endpoints: Vec<u16>,
    /// Field GroupName (tag 3).
    pub group_name: Option<String>,
    /// Field FabricIndex (tag 254).
    pub fabric_index: u8,
}

/// `GroupKeyMapStruct` struct.
#[derive(Clone, Debug, PartialEq)]
#[non_exhaustive]
pub struct GroupKeyMapStruct {
    /// Field GroupId (tag 1).
    pub group_id: u16,
    /// Field GroupKeySetId (tag 2).
    pub group_key_set_id: u16,
    /// Field FabricIndex (tag 254).
    pub fabric_index: u8,
}

/// `GroupKeyMulticastPolicyEnum` (enum8).
#[derive(Copy, Clone, Debug, PartialEq, Eq)]
pub enum GroupKeyMulticastPolicyEnum {
    /// PerGroupId = 0.
    PerGroupId,
    /// AllNodes = 1.
    AllNodes,
    /// A value not known to this codegen revision.
    Unknown(u8),
}

impl GroupKeyMulticastPolicyEnum {
    /// Decode from its raw discriminant (unknown → `Unknown`).
    #[must_use]
    pub fn from_raw(v: u8) -> Self {
        match v {
            0 => Self::PerGroupId,
            1 => Self::AllNodes,
            other => Self::Unknown(other),
        }
    }
    /// The raw discriminant.
    #[must_use]
    pub fn to_raw(self) -> u8 {
        match self {
            Self::PerGroupId => 0,
            Self::AllNodes => 1,
            Self::Unknown(v) => v,
        }
    }
}

/// `GroupKeySecurityPolicyEnum` (enum8).
#[derive(Copy, Clone, Debug, PartialEq, Eq)]
pub enum GroupKeySecurityPolicyEnum {
    /// TrustFirst = 0.
    TrustFirst,
    /// CacheAndSync = 1.
    CacheAndSync,
    /// A value not known to this codegen revision.
    Unknown(u8),
}

impl GroupKeySecurityPolicyEnum {
    /// Decode from its raw discriminant (unknown → `Unknown`).
    #[must_use]
    pub fn from_raw(v: u8) -> Self {
        match v {
            0 => Self::TrustFirst,
            1 => Self::CacheAndSync,
            other => Self::Unknown(other),
        }
    }
    /// The raw discriminant.
    #[must_use]
    pub fn to_raw(self) -> u8 {
        match self {
            Self::TrustFirst => 0,
            Self::CacheAndSync => 1,
            Self::Unknown(v) => v,
        }
    }
}

/// `GroupKeySetStruct` struct.
#[derive(Clone, Debug, PartialEq)]
pub struct GroupKeySetStruct {
    /// Field GroupKeySetId (tag 0).
    pub group_key_set_id: u16,
    /// Field GroupKeySecurityPolicy (tag 1).
    pub group_key_security_policy: GroupKeySecurityPolicyEnum,
    /// Field EpochKey0 (tag 2).
    pub epoch_key0: Nullable<Vec<u8>>,
    /// Field EpochStartTime0 (tag 3).
    pub epoch_start_time0: Nullable<u64>,
    /// Field EpochKey1 (tag 4).
    pub epoch_key1: Nullable<Vec<u8>>,
    /// Field EpochStartTime1 (tag 5).
    pub epoch_start_time1: Nullable<u64>,
    /// Field EpochKey2 (tag 6).
    pub epoch_key2: Nullable<Vec<u8>>,
    /// Field EpochStartTime2 (tag 7).
    pub epoch_start_time2: Nullable<u64>,
    /// Field GroupKeyMulticastPolicy (tag 8).
    pub group_key_multicast_policy: Option<GroupKeyMulticastPolicyEnum>,
    /// Field FabricIndex (tag 254).
    pub fabric_index: Option<u8>,
}

impl GroupInfoMapStruct {
    /// Decode the fields of an already-opened anonymous structure
    /// (reader positioned after the struct start; consumes to its end).
    ///
    /// # Errors
    /// Returns [`ClusterError`] on a malformed structure or missing required field.
    pub fn decode_from(r: &mut TlvReader<'_>) -> Result<Self, ClusterError> {
        let mut f_group_id: Option<u16> = None;
        let mut f_endpoints: Option<Vec<u16>> = None;
        let mut f_group_name: Option<String> = None;
        let mut f_fabric_index: Option<u8> = None;
        loop {
            match r.next()? {
                Some(Element::ContainerEnd) => break,
                Some(Element::Scalar {
                    tag: Tag::Context(1),
                    value: Value::Uint(v),
                }) => {
                    f_group_id =
                        Some(u16::try_from(v).map_err(|_| ClusterError::InvalidLength("GroupId"))?)
                }
                Some(Element::ContainerStart {
                    tag: Tag::Context(2),
                    kind: ContainerKind::Array,
                }) => {
                    let mut out = Vec::new();
                    loop {
                        match r.next()? {
                            Some(Element::ContainerEnd) => break,
                            Some(Element::Scalar {
                                value: Value::Uint(v),
                                ..
                            }) => out.push(
                                u16::try_from(v)
                                    .map_err(|_| ClusterError::InvalidLength("Endpoints"))?,
                            ),
                            None => {
                                return Err(ClusterError::Tlv(
                                    matter_codec::Error::UnclosedContainer,
                                ))
                            }
                            Some(Element::ContainerStart { .. }) => r.skip_container()?,
                            Some(_) => {} // skip unknown scalar
                        }
                    }
                    f_endpoints = Some(out);
                }
                Some(Element::Scalar {
                    tag: Tag::Context(3),
                    value: Value::Utf8(v),
                }) => f_group_name = Some(v),
                Some(Element::Scalar {
                    tag: Tag::Context(254),
                    value: Value::Uint(v),
                }) => {
                    f_fabric_index = Some(
                        u8::try_from(v).map_err(|_| ClusterError::InvalidLength("FabricIndex"))?,
                    )
                }
                None => return Err(ClusterError::Tlv(matter_codec::Error::UnclosedContainer)),
                Some(Element::ContainerStart { .. }) => r.skip_container()?,
                Some(_) => {} // unknown/future scalar — skip
            }
        }
        Ok(Self {
            group_id: f_group_id.ok_or(ClusterError::MissingField("GroupId"))?,
            endpoints: f_endpoints.ok_or(ClusterError::MissingField("Endpoints"))?,
            group_name: f_group_name,
            fabric_index: f_fabric_index.ok_or(ClusterError::MissingField("FabricIndex"))?,
        })
    }
    /// Decode from a standalone anonymous TLV structure.
    ///
    /// # Errors
    /// Returns [`ClusterError`] if the bytes are not an anonymous structure or a field is malformed.
    pub fn decode(tlv: &[u8]) -> Result<Self, ClusterError> {
        let mut r = TlvReader::new(tlv);
        match r.next()? {
            Some(Element::ContainerStart {
                kind: ContainerKind::Structure,
                ..
            }) => {}
            _ => {
                return Err(ClusterError::UnexpectedType {
                    context: "GroupInfoMapStruct",
                })
            }
        }
        Self::decode_from(&mut r)
    }
}

impl GroupKeyMapStruct {
    /// Decode the fields of an already-opened anonymous structure
    /// (reader positioned after the struct start; consumes to its end).
    ///
    /// # Errors
    /// Returns [`ClusterError`] on a malformed structure or missing required field.
    pub fn decode_from(r: &mut TlvReader<'_>) -> Result<Self, ClusterError> {
        let mut f_group_id: Option<u16> = None;
        let mut f_group_key_set_id: Option<u16> = None;
        let mut f_fabric_index: Option<u8> = None;
        loop {
            match r.next()? {
                Some(Element::ContainerEnd) => break,
                Some(Element::Scalar {
                    tag: Tag::Context(1),
                    value: Value::Uint(v),
                }) => {
                    f_group_id =
                        Some(u16::try_from(v).map_err(|_| ClusterError::InvalidLength("GroupId"))?)
                }
                Some(Element::Scalar {
                    tag: Tag::Context(2),
                    value: Value::Uint(v),
                }) => {
                    f_group_key_set_id = Some(
                        u16::try_from(v)
                            .map_err(|_| ClusterError::InvalidLength("GroupKeySetId"))?,
                    )
                }
                Some(Element::Scalar {
                    tag: Tag::Context(254),
                    value: Value::Uint(v),
                }) => {
                    f_fabric_index = Some(
                        u8::try_from(v).map_err(|_| ClusterError::InvalidLength("FabricIndex"))?,
                    )
                }
                None => return Err(ClusterError::Tlv(matter_codec::Error::UnclosedContainer)),
                Some(Element::ContainerStart { .. }) => r.skip_container()?,
                Some(_) => {} // unknown/future scalar — skip
            }
        }
        Ok(Self {
            group_id: f_group_id.ok_or(ClusterError::MissingField("GroupId"))?,
            group_key_set_id: f_group_key_set_id
                .ok_or(ClusterError::MissingField("GroupKeySetId"))?,
            fabric_index: f_fabric_index.ok_or(ClusterError::MissingField("FabricIndex"))?,
        })
    }
    /// Decode from a standalone anonymous TLV structure.
    ///
    /// # Errors
    /// Returns [`ClusterError`] if the bytes are not an anonymous structure or a field is malformed.
    pub fn decode(tlv: &[u8]) -> Result<Self, ClusterError> {
        let mut r = TlvReader::new(tlv);
        match r.next()? {
            Some(Element::ContainerStart {
                kind: ContainerKind::Structure,
                ..
            }) => {}
            _ => {
                return Err(ClusterError::UnexpectedType {
                    context: "GroupKeyMapStruct",
                })
            }
        }
        Self::decode_from(&mut r)
    }
    /// Write this struct's fields into an already-open container.
    #[allow(clippy::expect_used)] // Vec-backed TlvWriter is infallible.
    pub fn write_fields(&self, w: &mut TlvWriter<'_>) {
        w.put_uint(Tag::Context(1), u64::from(self.group_id))
            .expect("infallible: vec writer");
        w.put_uint(Tag::Context(2), u64::from(self.group_key_set_id))
            .expect("infallible: vec writer");
        w.put_uint(Tag::Context(254), u64::from(self.fabric_index))
            .expect("infallible: vec writer");
    }
    /// Encode as a standalone anonymous TLV structure.
    #[must_use]
    #[allow(clippy::expect_used)] // Vec-backed TlvWriter is infallible.
    pub fn encode(&self) -> Vec<u8> {
        let mut buf = Vec::new();
        let mut w = TlvWriter::new(&mut buf);
        w.start_structure(Tag::Anonymous)
            .expect("infallible: vec writer");
        self.write_fields(&mut w);
        w.end_container().expect("infallible: vec writer");
        buf
    }
}

impl GroupKeySetStruct {
    /// Decode the fields of an already-opened anonymous structure
    /// (reader positioned after the struct start; consumes to its end).
    ///
    /// # Errors
    /// Returns [`ClusterError`] on a malformed structure or missing required field.
    pub fn decode_from(r: &mut TlvReader<'_>) -> Result<Self, ClusterError> {
        let mut f_group_key_set_id: Option<u16> = None;
        let mut f_group_key_security_policy: Option<GroupKeySecurityPolicyEnum> = None;
        let mut f_epoch_key0: Option<Nullable<Vec<u8>>> = None;
        let mut f_epoch_start_time0: Option<Nullable<u64>> = None;
        let mut f_epoch_key1: Option<Nullable<Vec<u8>>> = None;
        let mut f_epoch_start_time1: Option<Nullable<u64>> = None;
        let mut f_epoch_key2: Option<Nullable<Vec<u8>>> = None;
        let mut f_epoch_start_time2: Option<Nullable<u64>> = None;
        let mut f_group_key_multicast_policy: Option<GroupKeyMulticastPolicyEnum> = None;
        let mut f_fabric_index: Option<u8> = None;
        loop {
            match r.next()? {
                Some(Element::ContainerEnd) => break,
                Some(Element::Scalar {
                    tag: Tag::Context(0),
                    value: Value::Uint(v),
                }) => {
                    f_group_key_set_id = Some(
                        u16::try_from(v)
                            .map_err(|_| ClusterError::InvalidLength("GroupKeySetId"))?,
                    )
                }
                Some(Element::Scalar {
                    tag: Tag::Context(1),
                    value: Value::Uint(v),
                }) => {
                    f_group_key_security_policy = Some(GroupKeySecurityPolicyEnum::from_raw(
                        u8::try_from(v)
                            .map_err(|_| ClusterError::InvalidLength("GroupKeySecurityPolicy"))?,
                    ))
                }
                Some(Element::Scalar {
                    tag: Tag::Context(2),
                    value: Value::Null,
                }) => f_epoch_key0 = Some(Nullable::Null),
                Some(Element::Scalar {
                    tag: Tag::Context(2),
                    value: Value::Bytes(v),
                }) => f_epoch_key0 = Some(Nullable::Value(v)),
                Some(Element::Scalar {
                    tag: Tag::Context(3),
                    value: Value::Null,
                }) => f_epoch_start_time0 = Some(Nullable::Null),
                Some(Element::Scalar {
                    tag: Tag::Context(3),
                    value: Value::Uint(v),
                }) => {
                    f_epoch_start_time0 =
                        Some(Nullable::Value(u64::try_from(v).map_err(|_| {
                            ClusterError::InvalidLength("EpochStartTime0")
                        })?))
                }
                Some(Element::Scalar {
                    tag: Tag::Context(4),
                    value: Value::Null,
                }) => f_epoch_key1 = Some(Nullable::Null),
                Some(Element::Scalar {
                    tag: Tag::Context(4),
                    value: Value::Bytes(v),
                }) => f_epoch_key1 = Some(Nullable::Value(v)),
                Some(Element::Scalar {
                    tag: Tag::Context(5),
                    value: Value::Null,
                }) => f_epoch_start_time1 = Some(Nullable::Null),
                Some(Element::Scalar {
                    tag: Tag::Context(5),
                    value: Value::Uint(v),
                }) => {
                    f_epoch_start_time1 =
                        Some(Nullable::Value(u64::try_from(v).map_err(|_| {
                            ClusterError::InvalidLength("EpochStartTime1")
                        })?))
                }
                Some(Element::Scalar {
                    tag: Tag::Context(6),
                    value: Value::Null,
                }) => f_epoch_key2 = Some(Nullable::Null),
                Some(Element::Scalar {
                    tag: Tag::Context(6),
                    value: Value::Bytes(v),
                }) => f_epoch_key2 = Some(Nullable::Value(v)),
                Some(Element::Scalar {
                    tag: Tag::Context(7),
                    value: Value::Null,
                }) => f_epoch_start_time2 = Some(Nullable::Null),
                Some(Element::Scalar {
                    tag: Tag::Context(7),
                    value: Value::Uint(v),
                }) => {
                    f_epoch_start_time2 =
                        Some(Nullable::Value(u64::try_from(v).map_err(|_| {
                            ClusterError::InvalidLength("EpochStartTime2")
                        })?))
                }
                Some(Element::Scalar {
                    tag: Tag::Context(8),
                    value: Value::Uint(v),
                }) => {
                    f_group_key_multicast_policy = Some(GroupKeyMulticastPolicyEnum::from_raw(
                        u8::try_from(v)
                            .map_err(|_| ClusterError::InvalidLength("GroupKeyMulticastPolicy"))?,
                    ))
                }
                Some(Element::Scalar {
                    tag: Tag::Context(254),
                    value: Value::Uint(v),
                }) => {
                    f_fabric_index = Some(
                        u8::try_from(v).map_err(|_| ClusterError::InvalidLength("FabricIndex"))?,
                    )
                }
                None => return Err(ClusterError::Tlv(matter_codec::Error::UnclosedContainer)),
                Some(Element::ContainerStart { .. }) => r.skip_container()?,
                Some(_) => {} // unknown/future scalar — skip
            }
        }
        Ok(Self {
            group_key_set_id: f_group_key_set_id
                .ok_or(ClusterError::MissingField("GroupKeySetId"))?,
            group_key_security_policy: f_group_key_security_policy
                .ok_or(ClusterError::MissingField("GroupKeySecurityPolicy"))?,
            epoch_key0: f_epoch_key0.ok_or(ClusterError::MissingField("EpochKey0"))?,
            epoch_start_time0: f_epoch_start_time0
                .ok_or(ClusterError::MissingField("EpochStartTime0"))?,
            epoch_key1: f_epoch_key1.ok_or(ClusterError::MissingField("EpochKey1"))?,
            epoch_start_time1: f_epoch_start_time1
                .ok_or(ClusterError::MissingField("EpochStartTime1"))?,
            epoch_key2: f_epoch_key2.ok_or(ClusterError::MissingField("EpochKey2"))?,
            epoch_start_time2: f_epoch_start_time2
                .ok_or(ClusterError::MissingField("EpochStartTime2"))?,
            group_key_multicast_policy: f_group_key_multicast_policy,
            fabric_index: f_fabric_index,
        })
    }
    /// Decode from a standalone anonymous TLV structure.
    ///
    /// # Errors
    /// Returns [`ClusterError`] if the bytes are not an anonymous structure or a field is malformed.
    pub fn decode(tlv: &[u8]) -> Result<Self, ClusterError> {
        let mut r = TlvReader::new(tlv);
        match r.next()? {
            Some(Element::ContainerStart {
                kind: ContainerKind::Structure,
                ..
            }) => {}
            _ => {
                return Err(ClusterError::UnexpectedType {
                    context: "GroupKeySetStruct",
                })
            }
        }
        Self::decode_from(&mut r)
    }
    /// Write this struct's fields into an already-open container.
    #[allow(clippy::expect_used)] // Vec-backed TlvWriter is infallible.
    pub fn write_fields(&self, w: &mut TlvWriter<'_>) {
        w.put_uint(Tag::Context(0), u64::from(self.group_key_set_id))
            .expect("infallible: vec writer");
        w.put_uint(
            Tag::Context(1),
            u64::from(self.group_key_security_policy.to_raw()),
        )
        .expect("infallible: vec writer");
        match &self.epoch_key0 {
            Nullable::Null => w.put_null(Tag::Context(2)).expect("infallible: vec writer"),
            Nullable::Value(epoch_key0) => {
                w.put_bytes(Tag::Context(2), &*epoch_key0)
                    .expect("infallible: vec writer");
            }
        }
        match &self.epoch_start_time0 {
            Nullable::Null => w.put_null(Tag::Context(3)).expect("infallible: vec writer"),
            Nullable::Value(epoch_start_time0) => {
                w.put_uint(Tag::Context(3), u64::from(*epoch_start_time0))
                    .expect("infallible: vec writer");
            }
        }
        match &self.epoch_key1 {
            Nullable::Null => w.put_null(Tag::Context(4)).expect("infallible: vec writer"),
            Nullable::Value(epoch_key1) => {
                w.put_bytes(Tag::Context(4), &*epoch_key1)
                    .expect("infallible: vec writer");
            }
        }
        match &self.epoch_start_time1 {
            Nullable::Null => w.put_null(Tag::Context(5)).expect("infallible: vec writer"),
            Nullable::Value(epoch_start_time1) => {
                w.put_uint(Tag::Context(5), u64::from(*epoch_start_time1))
                    .expect("infallible: vec writer");
            }
        }
        match &self.epoch_key2 {
            Nullable::Null => w.put_null(Tag::Context(6)).expect("infallible: vec writer"),
            Nullable::Value(epoch_key2) => {
                w.put_bytes(Tag::Context(6), &*epoch_key2)
                    .expect("infallible: vec writer");
            }
        }
        match &self.epoch_start_time2 {
            Nullable::Null => w.put_null(Tag::Context(7)).expect("infallible: vec writer"),
            Nullable::Value(epoch_start_time2) => {
                w.put_uint(Tag::Context(7), u64::from(*epoch_start_time2))
                    .expect("infallible: vec writer");
            }
        }
        if let Some(group_key_multicast_policy) = &self.group_key_multicast_policy {
            w.put_uint(
                Tag::Context(8),
                u64::from((*group_key_multicast_policy).to_raw()),
            )
            .expect("infallible: vec writer");
        }
        if let Some(fabric_index) = &self.fabric_index {
            w.put_uint(Tag::Context(254), u64::from(*fabric_index))
                .expect("infallible: vec writer");
        }
    }
    /// Encode as a standalone anonymous TLV structure.
    #[must_use]
    #[allow(clippy::expect_used)] // Vec-backed TlvWriter is infallible.
    pub fn encode(&self) -> Vec<u8> {
        let mut buf = Vec::new();
        let mut w = TlvWriter::new(&mut buf);
        w.start_structure(Tag::Anonymous)
            .expect("infallible: vec writer");
        self.write_fields(&mut w);
        w.end_container().expect("infallible: vec writer");
        buf
    }
}

/// Decode the `GroupKeyMap` attribute value.
///
/// # Errors
/// Returns [`ClusterError`] on a type mismatch or out-of-range value.
pub fn decode_group_key_map(tlv: &[u8]) -> Result<Vec<GroupKeyMapStruct>, ClusterError> {
    let mut r = TlvReader::new(tlv);
    match r.next()? {
        Some(Element::ContainerStart {
            kind: ContainerKind::Array,
            ..
        }) => {}
        _ => {
            return Err(ClusterError::UnexpectedType {
                context: "GroupKeyMap",
            })
        }
    }
    let r = &mut r;
    let mut out = Vec::new();
    loop {
        match r.next()? {
            Some(Element::ContainerEnd) => break,
            Some(Element::ContainerStart {
                kind: ContainerKind::Structure,
                ..
            }) => {
                out.push(GroupKeyMapStruct::decode_from(r)?);
            }
            None => return Err(ClusterError::Tlv(matter_codec::Error::UnclosedContainer)),
            Some(Element::ContainerStart { .. }) => r.skip_container()?,
            Some(_) => {} // skip unknown scalar
        }
    }
    Ok(out)
}

/// Decode the `GroupTable` attribute value.
///
/// # Errors
/// Returns [`ClusterError`] on a type mismatch or out-of-range value.
pub fn decode_group_table(tlv: &[u8]) -> Result<Vec<GroupInfoMapStruct>, ClusterError> {
    let mut r = TlvReader::new(tlv);
    match r.next()? {
        Some(Element::ContainerStart {
            kind: ContainerKind::Array,
            ..
        }) => {}
        _ => {
            return Err(ClusterError::UnexpectedType {
                context: "GroupTable",
            })
        }
    }
    let r = &mut r;
    let mut out = Vec::new();
    loop {
        match r.next()? {
            Some(Element::ContainerEnd) => break,
            Some(Element::ContainerStart {
                kind: ContainerKind::Structure,
                ..
            }) => {
                out.push(GroupInfoMapStruct::decode_from(r)?);
            }
            None => return Err(ClusterError::Tlv(matter_codec::Error::UnclosedContainer)),
            Some(Element::ContainerStart { .. }) => r.skip_container()?,
            Some(_) => {} // skip unknown scalar
        }
    }
    Ok(out)
}

/// Decode the `MaxGroupsPerFabric` attribute value.
///
/// # Errors
/// Returns [`ClusterError`] on a type mismatch or out-of-range value.
pub fn decode_max_groups_per_fabric(tlv: &[u8]) -> Result<u16, ClusterError> {
    let mut r = TlvReader::new(tlv);
    match r.next()? {
        Some(Element::Scalar {
            value: Value::Uint(v),
            ..
        }) => Ok(u16::try_from(v).map_err(|_| ClusterError::InvalidLength("MaxGroupsPerFabric"))?),
        _ => Err(ClusterError::UnexpectedType {
            context: "MaxGroupsPerFabric",
        }),
    }
}

/// Decode the `MaxGroupKeysPerFabric` attribute value.
///
/// # Errors
/// Returns [`ClusterError`] on a type mismatch or out-of-range value.
pub fn decode_max_group_keys_per_fabric(tlv: &[u8]) -> Result<u16, ClusterError> {
    let mut r = TlvReader::new(tlv);
    match r.next()? {
        Some(Element::Scalar {
            value: Value::Uint(v),
            ..
        }) => {
            Ok(u16::try_from(v)
                .map_err(|_| ClusterError::InvalidLength("MaxGroupKeysPerFabric"))?)
        }
        _ => Err(ClusterError::UnexpectedType {
            context: "MaxGroupKeysPerFabric",
        }),
    }
}

/// Encode the `KeySetWrite` command request payload.
#[must_use]
#[allow(clippy::expect_used, clippy::missing_panics_doc)] // Vec-backed TlvWriter is infallible.
pub fn encode_key_set_write(group_key_set: GroupKeySetStruct) -> Vec<u8> {
    let mut buf = Vec::new();
    let mut w = TlvWriter::new(&mut buf);
    w.start_structure(Tag::Anonymous)
        .expect("infallible: vec writer");
    w.start_structure(Tag::Context(0))
        .expect("infallible: vec writer");
    group_key_set.write_fields(&mut w);
    w.end_container().expect("infallible: vec writer");
    w.end_container().expect("infallible: vec writer");
    buf
}

/// Encode the `KeySetRead` command request payload.
#[must_use]
#[allow(clippy::expect_used, clippy::missing_panics_doc)] // Vec-backed TlvWriter is infallible.
pub fn encode_key_set_read(group_key_set_id: u16) -> Vec<u8> {
    let mut buf = Vec::new();
    let mut w = TlvWriter::new(&mut buf);
    w.start_structure(Tag::Anonymous)
        .expect("infallible: vec writer");
    w.put_uint(Tag::Context(0), u64::from(group_key_set_id))
        .expect("infallible: vec writer");
    w.end_container().expect("infallible: vec writer");
    buf
}

/// Decoded `KeySetReadResponse` payload.
#[derive(Clone, Debug, PartialEq)]
#[non_exhaustive]
pub struct KeySetReadResponse {
    /// Field GroupKeySet (tag 0).
    pub group_key_set: GroupKeySetStruct,
}

impl KeySetReadResponse {
    /// Decode the fields of an already-opened anonymous structure
    /// (reader positioned after the struct start; consumes to its end).
    ///
    /// # Errors
    /// Returns [`ClusterError`] on a malformed structure or missing required field.
    pub fn decode_from(r: &mut TlvReader<'_>) -> Result<Self, ClusterError> {
        let mut f_group_key_set: Option<GroupKeySetStruct> = None;
        loop {
            match r.next()? {
                Some(Element::ContainerEnd) => break,
                Some(Element::ContainerStart {
                    tag: Tag::Context(0),
                    kind: ContainerKind::Structure,
                }) => f_group_key_set = Some(GroupKeySetStruct::decode_from(r)?),
                None => return Err(ClusterError::Tlv(matter_codec::Error::UnclosedContainer)),
                Some(Element::ContainerStart { .. }) => r.skip_container()?,
                Some(_) => {} // unknown/future scalar — skip
            }
        }
        Ok(Self {
            group_key_set: f_group_key_set.ok_or(ClusterError::MissingField("GroupKeySet"))?,
        })
    }
    /// Decode from a standalone anonymous TLV structure.
    ///
    /// # Errors
    /// Returns [`ClusterError`] if the bytes are not an anonymous structure or a field is malformed.
    pub fn decode(tlv: &[u8]) -> Result<Self, ClusterError> {
        let mut r = TlvReader::new(tlv);
        match r.next()? {
            Some(Element::ContainerStart {
                kind: ContainerKind::Structure,
                ..
            }) => {}
            _ => {
                return Err(ClusterError::UnexpectedType {
                    context: "KeySetReadResponse",
                })
            }
        }
        Self::decode_from(&mut r)
    }
}

/// Encode the `KeySetRemove` command request payload.
#[must_use]
#[allow(clippy::expect_used, clippy::missing_panics_doc)] // Vec-backed TlvWriter is infallible.
pub fn encode_key_set_remove(group_key_set_id: u16) -> Vec<u8> {
    let mut buf = Vec::new();
    let mut w = TlvWriter::new(&mut buf);
    w.start_structure(Tag::Anonymous)
        .expect("infallible: vec writer");
    w.put_uint(Tag::Context(0), u64::from(group_key_set_id))
        .expect("infallible: vec writer");
    w.end_container().expect("infallible: vec writer");
    buf
}

/// Encode the `KeySetReadAllIndices` command request payload.
#[must_use]
#[allow(clippy::expect_used, clippy::missing_panics_doc)] // Vec-backed TlvWriter is infallible.
pub fn encode_key_set_read_all_indices() -> Vec<u8> {
    let mut buf = Vec::new();
    let mut w = TlvWriter::new(&mut buf);
    w.start_structure(Tag::Anonymous)
        .expect("infallible: vec writer");
    w.end_container().expect("infallible: vec writer");
    buf
}

/// Decoded `KeySetReadAllIndicesResponse` payload.
#[derive(Clone, Debug, PartialEq)]
#[non_exhaustive]
pub struct KeySetReadAllIndicesResponse {
    /// Field GroupKeySetIDs (tag 0).
    pub group_key_set_i_ds: Vec<u16>,
}

impl KeySetReadAllIndicesResponse {
    /// Decode the fields of an already-opened anonymous structure
    /// (reader positioned after the struct start; consumes to its end).
    ///
    /// # Errors
    /// Returns [`ClusterError`] on a malformed structure or missing required field.
    pub fn decode_from(r: &mut TlvReader<'_>) -> Result<Self, ClusterError> {
        let mut f_group_key_set_i_ds: Option<Vec<u16>> = None;
        loop {
            match r.next()? {
                Some(Element::ContainerEnd) => break,
                Some(Element::ContainerStart {
                    tag: Tag::Context(0),
                    kind: ContainerKind::Array,
                }) => {
                    let mut out = Vec::new();
                    loop {
                        match r.next()? {
                            Some(Element::ContainerEnd) => break,
                            Some(Element::Scalar {
                                value: Value::Uint(v),
                                ..
                            }) => out.push(
                                u16::try_from(v)
                                    .map_err(|_| ClusterError::InvalidLength("GroupKeySetIDs"))?,
                            ),
                            None => {
                                return Err(ClusterError::Tlv(
                                    matter_codec::Error::UnclosedContainer,
                                ))
                            }
                            Some(Element::ContainerStart { .. }) => r.skip_container()?,
                            Some(_) => {} // skip unknown scalar
                        }
                    }
                    f_group_key_set_i_ds = Some(out);
                }
                None => return Err(ClusterError::Tlv(matter_codec::Error::UnclosedContainer)),
                Some(Element::ContainerStart { .. }) => r.skip_container()?,
                Some(_) => {} // unknown/future scalar — skip
            }
        }
        Ok(Self {
            group_key_set_i_ds: f_group_key_set_i_ds
                .ok_or(ClusterError::MissingField("GroupKeySetIDs"))?,
        })
    }
    /// Decode from a standalone anonymous TLV structure.
    ///
    /// # Errors
    /// Returns [`ClusterError`] if the bytes are not an anonymous structure or a field is malformed.
    pub fn decode(tlv: &[u8]) -> Result<Self, ClusterError> {
        let mut r = TlvReader::new(tlv);
        match r.next()? {
            Some(Element::ContainerStart {
                kind: ContainerKind::Structure,
                ..
            }) => {}
            _ => {
                return Err(ClusterError::UnexpectedType {
                    context: "KeySetReadAllIndicesResponse",
                })
            }
        }
        Self::decode_from(&mut r)
    }
}