slacko 0.2.2

Comprehensive Rust SDK for the Slack API with stealth mode support
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
168
169
170

//! Emoji API
//!
//! Methods for listing and managing custom emoji.

use crate::client::SlackClient;
use crate::error::Result;
use serde::{Deserialize, Serialize};
use std::collections::HashMap;

/// Emoji API client
pub struct EmojiApi {
    client: SlackClient,
}

impl EmojiApi {
    pub(crate) fn new(client: SlackClient) -> Self {
        Self { client }
    }

    /// List all custom emoji for a team
    pub async fn list(&self) -> Result<EmojiListResponse> {
        let params: [(&str, &str); 0] = [];

        self.client.get("emoji.list", &params).await
    }

    /// Add a custom emoji
    ///
    /// # Arguments
    ///
    /// * `name` - Name of the emoji (without colons)
    /// * `url` - URL of the emoji image
    ///
    /// # Note
    ///
    /// This is an admin API that requires admin.teams:write scope
    /// or workspace admin privileges.
    pub async fn add(&self, name: &str, url: &str) -> Result<EmojiAddResponse> {
        let params = EmojiAddRequest {
            name: name.to_string(),
            url: url.to_string(),
        };

        self.client.post("admin.emoji.add", &params).await
    }

    /// Add an emoji alias
    ///
    /// # Arguments
    ///
    /// * `name` - Name of the new alias (without colons)
    /// * `alias_for` - Name of the existing emoji to alias
    pub async fn add_alias(&self, name: &str, alias_for: &str) -> Result<EmojiAddResponse> {
        let params = EmojiAddAliasRequest {
            name: name.to_string(),
            alias_for: alias_for.to_string(),
        };

        self.client.post("admin.emoji.addAlias", &params).await
    }

    /// Remove a custom emoji
    ///
    /// # Arguments
    ///
    /// * `name` - Name of the emoji to remove (without colons)
    ///
    /// # Note
    ///
    /// This is an admin API that requires admin.teams:write scope
    /// or workspace admin privileges.
    pub async fn remove(&self, name: &str) -> Result<EmojiRemoveResponse> {
        let params = EmojiRemoveRequest {
            name: name.to_string(),
        };

        self.client.post("admin.emoji.remove", &params).await
    }

    /// Rename a custom emoji
    ///
    /// # Arguments
    ///
    /// * `name` - Current name of the emoji
    /// * `new_name` - New name for the emoji
    pub async fn rename(&self, name: &str, new_name: &str) -> Result<EmojiRenameResponse> {
        let params = EmojiRenameRequest {
            name: name.to_string(),
            new_name: new_name.to_string(),
        };

        self.client.post("admin.emoji.rename", &params).await
    }

    /// List custom emoji with pagination (admin API)
    pub async fn admin_list(&self) -> Result<EmojiAdminListResponse> {
        let params = EmojiAdminListRequest {
            cursor: None,
            limit: Some(100),
        };

        self.client.post("admin.emoji.list", &params).await
    }
}

// Request/Response types

#[derive(Debug, Deserialize)]
pub struct EmojiListResponse {
    pub emoji: HashMap<String, String>,
    #[serde(skip_serializing_if = "Option::is_none")]
    pub cache_ts: Option<String>,
}

#[derive(Debug, Serialize)]
pub struct EmojiAddRequest {
    pub name: String,
    pub url: String,
}

#[derive(Debug, Deserialize)]
pub struct EmojiAddResponse {}

#[derive(Debug, Serialize)]
pub struct EmojiAddAliasRequest {
    pub name: String,
    pub alias_for: String,
}

#[derive(Debug, Serialize)]
pub struct EmojiRemoveRequest {
    pub name: String,
}

#[derive(Debug, Deserialize)]
pub struct EmojiRemoveResponse {}

#[derive(Debug, Serialize)]
pub struct EmojiRenameRequest {
    pub name: String,
    pub new_name: String,
}

#[derive(Debug, Deserialize)]
pub struct EmojiRenameResponse {}

#[derive(Debug, Serialize)]
pub struct EmojiAdminListRequest {
    #[serde(skip_serializing_if = "Option::is_none")]
    pub cursor: Option<String>,
    #[serde(skip_serializing_if = "Option::is_none")]
    pub limit: Option<u32>,
}

#[derive(Debug, Deserialize)]
pub struct EmojiAdminListResponse {
    pub emoji: Vec<AdminEmoji>,
    #[serde(skip_serializing_if = "Option::is_none")]
    pub response_metadata: Option<crate::types::ResponseMetadata>,
}

#[derive(Debug, Deserialize)]
pub struct AdminEmoji {
    pub name: String,
    pub url: String,
    #[serde(skip_serializing_if = "Option::is_none")]
    pub date_created: Option<i64>,
    #[serde(skip_serializing_if = "Option::is_none")]
    pub uploaded_by: Option<String>,
}