aqara 0.1.1

Aqara SDK for Rust.
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167

//! Position-related request types.

/// Parameters for `config.position.create`.
#[derive(Clone, Debug)]
#[non_exhaustive]
pub struct CreatePositionParams {
    /// Position name.
    pub position_name: String,
    /// Optional description.
    pub description: Option<String>,
    /// Optional parent position id (empty for top-level).
    pub parent_position_id: Option<String>,
}

impl CreatePositionParams {
    /// Create params with required fields.
    pub fn new(position_name: impl Into<String>) -> Self {
        Self {
            position_name: position_name.into(),
            description: None,
            parent_position_id: None,
        }
    }

    /// Set description.
    pub fn with_description(mut self, description: impl Into<String>) -> Self {
        self.description = Some(description.into());
        self
    }

    /// Set parent position id.
    pub fn with_parent_position_id(mut self, parent_position_id: impl Into<String>) -> Self {
        self.parent_position_id = Some(parent_position_id.into());
        self
    }
}

/// Parameters for `config.position.update`.
#[derive(Clone, Debug)]
#[non_exhaustive]
pub struct UpdatePositionParams {
    /// Position id.
    pub position_id: String,
    /// Updated position name.
    pub position_name: String,
    /// Optional updated description.
    pub description: Option<String>,
}

impl UpdatePositionParams {
    /// Create params with required fields.
    pub fn new(position_id: impl Into<String>, position_name: impl Into<String>) -> Self {
        Self {
            position_id: position_id.into(),
            position_name: position_name.into(),
            description: None,
        }
    }

    /// Set updated description.
    pub fn with_description(mut self, description: impl Into<String>) -> Self {
        self.description = Some(description.into());
        self
    }
}

/// Parameters for `config.position.delete`.
#[derive(Clone, Debug)]
#[non_exhaustive]
pub struct DeletePositionParams {
    /// Position id.
    pub position_id: String,
}

impl DeletePositionParams {
    /// Create params.
    pub fn new(position_id: impl Into<String>) -> Self {
        Self {
            position_id: position_id.into(),
        }
    }
}

/// Parameters for `config.position.timeZone`.
#[derive(Clone, Debug)]
#[non_exhaustive]
pub struct SetPositionTimeZoneParams {
    /// Top-level position id.
    pub position_id: String,
    /// Optional timezone string (e.g. `"GMT+08:00"`).
    pub time_zone: Option<String>,
}

impl SetPositionTimeZoneParams {
    /// Create params with required fields.
    pub fn new(position_id: impl Into<String>) -> Self {
        Self {
            position_id: position_id.into(),
            time_zone: None,
        }
    }

    /// Set timezone string (e.g. `"GMT+08:00"`).
    pub fn with_time_zone(mut self, time_zone: impl Into<String>) -> Self {
        self.time_zone = Some(time_zone.into());
        self
    }
}

/// Parameters for `query.position.info`.
#[derive(Clone, Debug)]
#[non_exhaustive]
pub struct ListPositionsParams {
    /// Optional parent position id.
    pub parent_position_id: Option<String>,
    /// Page number (1-based).
    pub page_num: u32,
    /// Page size.
    pub page_size: u32,
}

impl Default for ListPositionsParams {
    fn default() -> Self {
        Self {
            parent_position_id: None,
            page_num: 1,
            page_size: 30,
        }
    }
}

impl ListPositionsParams {
    /// Set parent position id.
    pub fn with_parent_position_id(mut self, parent_position_id: impl Into<String>) -> Self {
        self.parent_position_id = Some(parent_position_id.into());
        self
    }

    /// Set page number (1-based).
    pub fn with_page_num(mut self, page_num: u32) -> Self {
        self.page_num = page_num;
        self
    }

    /// Set page size.
    pub fn with_page_size(mut self, page_size: u32) -> Self {
        self.page_size = page_size;
        self
    }
}

/// Parameters for `query.position.detail`.
#[derive(Clone, Debug)]
#[non_exhaustive]
pub struct PositionDetailParams {
    /// Position id list (max 50).
    pub position_ids: Vec<String>,
}

impl PositionDetailParams {
    /// Create params.
    pub fn new(position_ids: impl Into<Vec<String>>) -> Self {
        Self {
            position_ids: position_ids.into(),
        }
    }
}