mqute_codec/protocol/v5/
unsubscribe.rs

1//! # Unsubscribe Packet - MQTT v5
2//!
3//! This module implements the MQTT v5 `Unsubscribe` packet, which is sent by clients to
4//! request unsubscription from one or more topics. The packet includes the list of
5//! topic filters to unsubscribe from and optional properties.
6
7use crate::codec::util::decode_byte;
8use crate::codec::{Decode, Encode, RawPacket};
9use crate::protocol::v5::property::{
10    property_decode, property_encode, property_len, Property, PropertyFrame,
11};
12use crate::protocol::v5::util::id_header;
13use crate::protocol::{FixedHeader, Flags, PacketType, QoS, TopicFilters};
14use crate::Error;
15use bytes::{Buf, Bytes, BytesMut};
16
17/// Properties specific to `Unsubscribe` packets
18///
19/// In MQTT v5, `Unsubscribe` packets can include:
20/// - User Properties (key-value pairs for extended metadata)
21///
22/// # Example
23///
24/// ```rust
25/// use mqute_codec::protocol::v5::UnsubscribeProperties;
26///
27/// let properties = UnsubscribeProperties {
28///     user_properties: vec![("client".into(), "rust".into())],
29/// };
30/// ```
31#[derive(Debug, Clone, PartialEq, Eq)]
32pub struct UnsubscribeProperties {
33    /// User-defined key-value properties
34    pub user_properties: Vec<(String, String)>,
35}
36
37impl PropertyFrame for UnsubscribeProperties {
38    /// Calculates the encoded length of the properties
39    fn encoded_len(&self) -> usize {
40        let mut len = 0usize;
41        len += property_len!(&self.user_properties);
42        len
43    }
44
45    /// Encodes the properties into a byte buffer
46    fn encode(&self, buf: &mut BytesMut) {
47        property_encode!(&self.user_properties, Property::UserProp, buf);
48    }
49
50    /// Decodes properties from a byte buffer
51    fn decode(buf: &mut Bytes) -> Result<Option<Self>, Error>
52    where
53        Self: Sized,
54    {
55        if buf.is_empty() {
56            return Ok(None);
57        }
58
59        let mut user_properties: Vec<(String, String)> = Vec::new();
60
61        while buf.has_remaining() {
62            let property: Property = decode_byte(buf)?.try_into()?;
63            match property {
64                Property::UserProp => {
65                    property_decode!(&mut user_properties, buf);
66                }
67                _ => return Err(Error::PropertyMismatch),
68            }
69        }
70
71        Ok(Some(UnsubscribeProperties { user_properties }))
72    }
73}
74
75// Internal header structure for `Unsubscribe` packets
76id_header!(UnsubscribeHeader, UnsubscribeProperties);
77
78/// Represents an MQTT v5 `Unsubscribe` packet
79///
80/// The `Unsubscribe` packet is sent by clients to request removal of existing
81/// subscriptions. It contains:
82/// - Packet Identifier (for QoS 1 acknowledgment)
83/// - List of topic filters to unsubscribe from
84/// - Optional properties (v5 only)
85///
86/// # Example
87///
88/// ```rust
89/// use mqute_codec::protocol::TopicFilters;
90/// use mqute_codec::protocol::v5::{Unsubscribe, UnsubscribeProperties};
91///
92/// // Simple unsubscribe with no properties
93/// let unsubscribe = Unsubscribe::new(
94///     1234,
95///     None,
96///     vec!["sensors/temperature", "control/#"]
97/// );
98///
99/// assert_eq!(unsubscribe.packet_id(), 1234u16);
100///
101/// // Unsubscribe with properties
102/// let properties = UnsubscribeProperties {
103///     user_properties: vec![("reason".into(), "client_shutdown".into())],
104/// };
105/// let unsubscribe = Unsubscribe::new(
106///     5678,
107///     Some(properties),
108///     vec!["debug/logs"]
109/// );
110///
111/// assert_eq!(unsubscribe.filters(), TopicFilters::new(vec!["debug/logs"]));
112/// ```
113#[derive(Debug, Clone, PartialEq, Eq)]
114pub struct Unsubscribe {
115    header: UnsubscribeHeader,
116    filters: TopicFilters,
117}
118
119impl Unsubscribe {
120    /// Creates a new `Unsubscribe` packet
121    pub fn new<T: IntoIterator<Item: Into<String>>>(
122        packet_id: u16,
123        properties: Option<UnsubscribeProperties>,
124        filters: T,
125    ) -> Self {
126        let filters: Vec<String> = filters.into_iter().map(|x| x.into()).collect();
127
128        Unsubscribe {
129            header: UnsubscribeHeader::new(packet_id, properties),
130            filters: filters.into(),
131        }
132    }
133
134    /// Returns the packet identifier
135    pub fn packet_id(&self) -> u16 {
136        self.header.packet_id
137    }
138
139    /// Returns the unsubscribe properties
140    pub fn properties(&self) -> Option<UnsubscribeProperties> {
141        self.header.properties.clone()
142    }
143
144    /// Returns the topic filters to unsubscribe from
145    pub fn filters(&self) -> TopicFilters {
146        self.filters.clone()
147    }
148}
149
150impl Encode for Unsubscribe {
151    /// Encodes the `Unsubscribe` packet into a byte buffer
152    fn encode(&self, buf: &mut BytesMut) -> Result<(), Error> {
153        let header = FixedHeader::with_flags(
154            PacketType::Unsubscribe,
155            Flags::new(QoS::AtLeastOnce),
156            self.payload_len(),
157        );
158        header.encode(buf)?;
159
160        self.header.encode(buf)?;
161        self.filters.encode(buf);
162        Ok(())
163    }
164
165    /// Calculates the total packet length
166    fn payload_len(&self) -> usize {
167        self.header.encoded_len() + self.filters.encoded_len()
168    }
169}
170
171impl Decode for Unsubscribe {
172    /// Decodes an `Unsubscribe` packet from raw bytes
173    fn decode(mut packet: RawPacket) -> Result<Self, Error> {
174        // Validate header flags
175        if packet.header.packet_type() != PacketType::Unsubscribe
176            || packet.header.flags() != Flags::new(QoS::AtLeastOnce)
177        {
178            return Err(Error::MalformedPacket);
179        }
180
181        let header = UnsubscribeHeader::decode(&mut packet.payload)?;
182        let filters = TopicFilters::decode(&mut packet.payload)?;
183
184        Ok(Unsubscribe::new(
185            header.packet_id,
186            header.properties,
187            filters,
188        ))
189    }
190}
mqute_codec/protocol/v5/unsubscribe.rs

mqute_codec/protocol/v5/
unsubscribe.rs
