hookburn_slack/
message.rs1use crate::error::SlackError;
3use serde::Serialize;
4
5#[derive(Debug, Clone, Serialize, Default)]
7pub struct SlackMessage {
8 #[serde(skip_serializing_if = "Option::is_none")]
10 pub text: Option<String>,
11 #[serde(skip_serializing_if = "Vec::is_empty")]
13 pub blocks: Vec<SlackBlock>,
14 #[serde(skip_serializing_if = "Vec::is_empty")]
16 pub attachments: Vec<SlackAttachment>,
17 #[serde(skip_serializing_if = "Option::is_none")]
19 pub thread_ts: Option<String>,
20 #[serde(skip_serializing_if = "Option::is_none")]
22 pub reply_broadcast: Option<bool>,
23 #[serde(skip_serializing_if = "Option::is_none")]
25 pub username: Option<String>,
26 #[serde(skip_serializing_if = "Option::is_none")]
28 pub icon_emoji: Option<String>,
29 #[serde(skip_serializing_if = "Option::is_none")]
31 pub icon_url: Option<String>,
32}
33
34impl SlackMessage {
35 pub fn builder() -> SlackMessageBuilder {
37 SlackMessageBuilder::default()
38 }
39}
40
41#[derive(Debug, Clone, Serialize)]
43#[serde(tag = "type")]
44pub enum SlackBlock {
45 #[serde(rename = "section")]
47 Section(SlackSectionBlock),
48 #[serde(rename = "divider")]
50 Divider,
51 #[serde(rename = "header")]
53 Header(SlackHeaderBlock),
54 #[serde(rename = "actions")]
56 Actions(SlackActionsBlock),
57 #[serde(rename = "context")]
59 Context(SlackContextBlock),
60}
61
62#[derive(Debug, Clone, Serialize)]
64pub struct SlackSectionBlock {
65 #[serde(skip_serializing_if = "Option::is_none")]
67 pub text: Option<SlackText>,
68 #[serde(skip_serializing_if = "Vec::is_empty")]
70 pub fields: Vec<SlackText>,
71 #[serde(skip_serializing_if = "Option::is_none")]
73 pub accessory: Option<SlackAccessory>,
74}
75
76#[derive(Debug, Clone, Serialize)]
78pub struct SlackHeaderBlock {
79 pub text: SlackText,
81}
82
83#[derive(Debug, Clone, Serialize)]
85pub struct SlackActionsBlock {
86 pub elements: Vec<SlackElement>,
88}
89
90#[derive(Debug, Clone, Serialize)]
92pub struct SlackContextBlock {
93 pub elements: Vec<SlackText>,
95}
96#[derive(Debug, Clone, Serialize)]
98#[serde(tag = "type")]
99pub enum SlackElement {
100 #[serde(rename = "button")]
102 Button(SlackButton),
103 #[serde(rename = "datepicker")]
105 DatePicker(SlackDatePicker),
106}
107
108#[derive(Debug, Clone, Serialize)]
110pub struct SlackButton {
111 pub text: SlackText,
113 pub value: String,
115 #[serde(skip_serializing_if = "Option::is_none")]
117 pub url: Option<String>,
118 #[serde(skip_serializing_if = "Option::is_none")]
120 pub style: Option<String>,
121}
122
123#[derive(Debug, Clone, Serialize)]
125pub struct SlackDatePicker {
126 pub placeholder: SlackText,
128 pub action_id: String,
130}
131
132#[derive(Debug, Clone, Serialize)]
134pub struct SlackText {
135 #[serde(rename = "type")]
137 pub text_type: SlackTextType,
138 pub text: String,
140 #[serde(skip_serializing_if = "Option::is_none")]
142 pub emoji: Option<bool>,
143}
144
145#[derive(Debug, Clone, Serialize)]
147#[serde(rename_all = "lowercase")]
148pub enum SlackTextType {
149 PlainText,
151 Mrkdwn,
153}
154
155#[derive(Debug, Clone, Serialize)]
157pub struct SlackAccessory {
158 #[serde(rename = "type")]
160 pub accessory_type: String,
161 pub image_url: String,
163 pub alt_text: String,
165}
166
167#[derive(Debug, Clone, Serialize)]
169pub struct SlackAttachment {
170 pub color: Option<String>,
172 pub pretext: Option<String>,
174 pub text: Option<String>,
176 pub fields: Vec<SlackAttachmentField>,
178}
179
180#[derive(Debug, Clone, Serialize)]
182pub struct SlackAttachmentField {
183 pub title: String,
185 pub value: String,
187 #[serde(skip_serializing_if = "Option::is_none")]
189 pub short: Option<bool>,
190}
191
192#[derive(Default)]
194pub struct SlackMessageBuilder {
195 inner: SlackMessage,
196}
197
198impl SlackMessageBuilder {
199 pub fn text(mut self, text: impl Into<String>) -> Self {
201 self.inner.text = Some(text.into());
202 self
203 }
204
205 pub fn block(mut self, block: SlackBlock) -> Self {
207 self.inner.blocks.push(block);
208 self
209 }
210
211 pub fn blocks(mut self, blocks: Vec<SlackBlock>) -> Self {
213 self.inner.blocks = blocks;
214 self
215 }
216
217 pub fn username(mut self, username: impl Into<String>) -> Self {
219 self.inner.username = Some(username.into());
220 self
221 }
222
223 pub fn icon_emoji(mut self, emoji: impl Into<String>) -> Self {
225 self.inner.icon_emoji = Some(emoji.into());
226 self
227 }
228
229 pub fn icon_url(mut self, url: impl Into<String>) -> Self {
231 self.inner.icon_url = Some(url.into());
232 self
233 }
234
235 pub fn thread_ts(mut self, ts: impl Into<String>) -> Self {
237 self.inner.thread_ts = Some(ts.into());
238 self
239 }
240
241 pub fn reply_broadcast(mut self, broadcast: bool) -> Self {
243 self.inner.reply_broadcast = Some(broadcast);
244 self
245 }
246
247 pub fn build(self) -> Result<SlackMessage, SlackError> {
253 if self.inner.text.is_none() && self.inner.blocks.is_empty() {
254 return Err(SlackError::EmptyMessage);
255 }
256 Ok(self.inner)
257 }
258}