Merge branch 'main' into perpetual/gateway-dev

src/api/channels/messages.rs

@@ -1,4 +1,3 @@
-pub mod messages {
 use http::header::CONTENT_DISPOSITION;
 use http::HeaderMap;
 use reqwest::{multipart, Client};
@@ -110,4 +109,3 @@ pub mod messages {
         Message::send(self, channel_id, message, files).await
     }
 }
-}

src/api/channels/mod.rs

@@ -1,5 +1,7 @@
 pub mod channels;
 pub mod messages;
+pub mod reactions;
 
 pub use channels::*;
 pub use messages::*;
+pub use reactions::*;

src/api/channels/reactions.rs

@@ -0,0 +1,183 @@
+use reqwest::Client;
+
+use crate::{
+    instance::UserMeta,
+    limit::LimitedRequester,
+    types::{self, Snowflake},
+};
+
+/**
+Extends the [`types::Reaction`] struct with useful metadata.
+ */
+pub struct ReactionMeta {
+    pub message_id: types::Snowflake,
+    pub channel_id: types::Snowflake,
+    pub reaction: types::Reaction,
+}
+
+impl ReactionMeta {
+    /**
+     Deletes all reactions for a message.
+    # Arguments
+     * `user` - A mutable reference to a [`UserMeta`] instance.
+
+     # Returns
+     A `Result` containing a [`reqwest::Response`] or a [`crate::errors::InstanceServerError`].
+
+    # Reference
+    See [https://discord.com/developers/docs/resources/channel#delete-all-reactions](https://discord.com/developers/docs/resources/channel#delete-all-reactions)
+     */
+    pub async fn delete_all(
+        &self,
+        user: &mut UserMeta,
+    ) -> Result<reqwest::Response, crate::errors::InstanceServerError> {
+        let mut belongs_to = user.belongs_to.borrow_mut();
+        let url = format!(
+            "{}/channels/{}/messages/{}/reactions/",
+            belongs_to.urls.get_api(),
+            self.channel_id,
+            self.message_id
+        );
+        let request = Client::new().delete(url).bearer_auth(user.token());
+        LimitedRequester::new()
+            .await
+            .send_request(
+                request,
+                crate::api::limits::LimitType::Channel,
+                &mut belongs_to.limits,
+                &mut user.limits,
+            )
+            .await
+    }
+
+    /**
+    Gets a list of users that reacted with a specific emoji to a message.
+
+    # Arguments
+    * `emoji` - A string slice containing the emoji to search for. The emoji must be URL Encoded or
+    the request will fail with 10014: Unknown Emoji. To use custom emoji, you must encode it in the
+    format name:id with the emoji name and emoji id.
+    * `user` - A mutable reference to a [`UserMeta`] instance.
+
+    # Returns
+    A `Result` containing a [`reqwest::Response`] or a [`crate::errors::InstanceServerError`].
+
+    # Reference
+    See [https://discord.com/developers/docs/resources/channel#get-reactions](https://discord.com/developers/docs/resources/channel#get-reactions)
+    */
+    pub async fn get(
+        &self,
+        emoji: &str,
+        user: &mut UserMeta,
+    ) -> Result<reqwest::Response, crate::errors::InstanceServerError> {
+        let mut belongs_to = user.belongs_to.borrow_mut();
+        let url = format!(
+            "{}/channels/{}/messages/{}/reactions/{}/",
+            belongs_to.urls.get_api(),
+            self.channel_id,
+            self.message_id,
+            emoji
+        );
+        let request = Client::new().get(url).bearer_auth(user.token());
+        LimitedRequester::new()
+            .await
+            .send_request(
+                request,
+                crate::api::limits::LimitType::Channel,
+                &mut belongs_to.limits,
+                &mut user.limits,
+            )
+            .await
+    }
+
+    /**
+    Deletes all the reactions for a given `emoji` on a message. This endpoint requires the
+    MANAGE_MESSAGES permission to be present on the current user. Fires a `Message Reaction
+    Remove Emoji` Gateway event.
+
+    # Arguments
+    * `emoji` - A string slice containing the emoji to delete. The `emoji` must be URL Encoded or
+    the request will fail with 10014: Unknown Emoji. To use custom emoji, you must encode it in the
+    format name:id with the emoji name and emoji id.
+    * `user` - A mutable reference to a [`UserMeta`] instance.
+
+    # Returns
+    A `Result` containing a [`reqwest::Response`] or a [`crate::errors::InstanceServerError`].
+
+    # Reference
+    See [https://discord.com/developers/docs/resources/channel#delete-all-reactions-for-emoji](https://discord.com/developers/docs/resources/channel#delete-all-reactions-for-emoji)
+    */
+    pub async fn delete_emoji(
+        &self,
+        emoji: &str,
+        user: &mut UserMeta,
+    ) -> Result<reqwest::Response, crate::errors::InstanceServerError> {
+        let mut belongs_to = user.belongs_to.borrow_mut();
+        let url = format!(
+            "{}/channels/{}/messages/{}/reactions/{}/",
+            belongs_to.urls.get_api(),
+            self.channel_id,
+            self.message_id,
+            emoji
+        );
+        let request = Client::new().delete(url).bearer_auth(user.token());
+        LimitedRequester::new()
+            .await
+            .send_request(
+                request,
+                crate::api::limits::LimitType::Channel,
+                &mut belongs_to.limits,
+                &mut user.limits,
+            )
+            .await
+    }
+}
+
+impl types::Reaction {
+    /**
+    Create a reaction for the message.
+
+    This endpoint requires the READ_MESSAGE_HISTORY permission
+    to be present on the current user. Additionally, if nobody else has reacted to the message using
+    this emoji, this endpoint requires the ADD_REACTIONS permission to be present on the current
+    user. Fires a Message Reaction Add Gateway event.
+
+     # Arguments
+    * `emoji` - A string slice containing the emoji to delete. The `emoji` must be URL Encoded or
+    the request will fail with 10014: Unknown Emoji. To use custom emoji, you must encode it in the
+    format name:id with the emoji name and emoji id.
+    * `user` - A mutable reference to a [`UserMeta`] instance.
+
+    # Returns
+    A `Result` containing a [`reqwest::Response`] or a [`crate::errors::InstanceServerError`].
+    Returns a 204 empty response on success.
+
+    # Reference
+    See [https://discord.com/developers/docs/resources/channel#create-reaction](https://discord.com/developers/docs/resources/channel#create-reaction)
+    */
+    pub async fn create(
+        channel_id: &Snowflake,
+        message_id: &Snowflake,
+        emoji: &str,
+        user: &mut UserMeta,
+    ) -> Result<reqwest::Response, crate::errors::InstanceServerError> {
+        let mut belongs_to = user.belongs_to.borrow_mut();
+        let url = format!(
+            "{}/channels/{}/messages/{}/reactions/{}/@me/",
+            belongs_to.urls.get_api(),
+            channel_id,
+            message_id,
+            emoji
+        );
+        let request = Client::new().put(url).bearer_auth(user.token());
+        LimitedRequester::new()
+            .await
+            .send_request(
+                request,
+                crate::api::limits::LimitType::Channel,
+                &mut belongs_to.limits,
+                &mut user.limits,
+            )
+            .await
+    }
+}