fluxer/

http.rs

//! HTTP client for the Fluxer REST API.
//!
//! Handles auth headers, serialization, and error handling. You'll usually
//! access this through `ctx.http` in your event handlers.

use reqwest::{
    header::{HeaderMap, HeaderValue, AUTHORIZATION, CONTENT_TYPE, USER_AGENT},
    StatusCode,
};
use crate::error::ClientError;
use crate::model::*;
use serde::de::DeserializeOwned;
use serde_json::json;

/// HTTP client for making REST API calls.
///
/// Created automatically by the client builder. Available as `ctx.http` in event handlers
/// or directly if you just need REST calls without a gateway connection:
///
/// ```rust,no_run
/// use fluxer::http::Http;
///
/// #[tokio::main]
/// async fn main() {
///     let http = Http::new("your-bot-token", "https://api.fluxer.app/v1".to_string());
///     let me = http.get_me().await.unwrap();
///     println!("Bot user: {}", me.username);
/// }
/// ```
pub struct Http {
    pub client: reqwest::Client,
    pub base_url: String,
    token: String,
}

impl Http {
    /// Creates a new HTTP client. The token is sent as `Bot {token}` in the
    /// Authorization header on every request.
    pub fn new(token: &str, base_url: String) -> Self {
        Self::new_with_prefix(token, base_url, &format!("Bot {}", token))
    }

    /// Creates a new HTTP client for a user token (no `Bot ` prefix).
    pub fn new_user(token: &str, base_url: String) -> Self {
        Self::new_with_prefix(token, base_url, token)
    }

    fn new_with_prefix(token: &str, base_url: String, auth_value: &str) -> Self {
        let mut headers = HeaderMap::new();
        headers.insert(AUTHORIZATION, HeaderValue::from_str(auth_value).unwrap());
        headers.insert(CONTENT_TYPE, HeaderValue::from_static("application/json"));
        headers.insert(USER_AGENT, HeaderValue::from_static("fluxer-rust"));

        Self {
            client: reqwest::Client::builder()
                .default_headers(headers)
                .build()
                .unwrap(),
            base_url,
            token: token.to_string(),
        }
    }

    pub fn get_token(&self) -> &str {
        &self.token
    }

    async fn request_json<T: DeserializeOwned>(
        &self,
        req: reqwest::RequestBuilder,
    ) -> Result<T, ClientError> {
        let resp = req.send().await.map_err(ClientError::Http)?;
        let status = resp.status();
        if status == StatusCode::NO_CONTENT {
            return Err(ClientError::Api("Expected body but got 204".into()));
        }
        if !status.is_success() {
            let text = resp.text().await.unwrap_or_default();
            return Err(ClientError::Api(format!("HTTP {}: {}", status, text)));
        }
        resp.json::<T>().await.map_err(ClientError::Http)
    }

    async fn request_empty(&self, req: reqwest::RequestBuilder) -> Result<(), ClientError> {
        let resp = req.send().await.map_err(ClientError::Http)?;
        let status = resp.status();
        if !status.is_success() {
            let text = resp.text().await.unwrap_or_default();
            return Err(ClientError::Api(format!("HTTP {}: {}", status, text)));
        }
        Ok(())
    }

    /// Fetches the gateway URL. Used internally during connection setup.
    pub async fn get_gateway(&self) -> Result<String, ClientError> {
        let url = format!("{}/gateway/bot", self.base_url);
        let res = self
            .request_json::<GatewayBotResponse>(self.client.get(&url))
            .await?;
        Ok(res.url)
    }

    /// Returns the instance discovery document for the current base URL.
    pub async fn get_well_known_fluxer(&self) -> Result<WellKnownFluxerResponse, ClientError> {
        let mut url = reqwest::Url::parse(&self.base_url)
            .map_err(|e| ClientError::Api(format!("invalid base URL: {}", e)))?;
        let mut path = url.path().trim_end_matches('/').to_string();
        if let Some(prefix) = path.strip_suffix("/v1") {
            path = prefix.to_string();
        }
        if path.is_empty() {
            path.push('/');
        }
        if !path.ends_with('/') {
            path.push('/');
        }
        path.push_str(".well-known/fluxer");
        url.set_path(&path);
        url.set_query(None);
        self.request_json(self.client.get(url)).await
    }

    /// Fetches the bot's own user object.
    pub async fn get_me(&self) -> Result<User, ClientError> {
        let url = format!("{}/users/@me", self.base_url);
        self.request_json(self.client.get(&url)).await
    }

    /// Fetches a user by ID.
    pub async fn get_user(&self, user_id: &str) -> Result<User, ClientError> {
        let url = format!("{}/users/{}", self.base_url, user_id);
        self.request_json(self.client.get(&url)).await
    }

    /// Returns all guilds the bot is in.
    pub async fn get_current_user_guilds(&self) -> Result<Vec<Guild>, ClientError> {
        let url = format!("{}/users/@me/guilds", self.base_url);
        self.request_json(self.client.get(&url)).await
    }

    /// Fetches a channel by ID.
    pub async fn get_channel(&self, channel_id: &str) -> Result<Channel, ClientError> {
        let url = format!("{}/channels/{}", self.base_url, channel_id);
        self.request_json(self.client.get(&url)).await
    }

    /// Edits a channel. Only the fields you set in the payload will change.
    pub async fn edit_channel(
        &self,
        channel_id: &str,
        payload: &ChannelCreatePayload,
    ) -> Result<Channel, ClientError> {
        let url = format!("{}/channels/{}", self.base_url, channel_id);
        self.request_json(self.client.patch(&url).json(payload)).await
    }

    /// Permanently deletes a channel. Can't be undone.
    pub async fn delete_channel(&self, channel_id: &str) -> Result<(), ClientError> {
        let url = format!("{}/channels/{}", self.base_url, channel_id);
        self.request_empty(self.client.delete(&url)).await
    }

    /// Triggers the "Bot is typing..." indicator. Lasts ~10 seconds or until
    /// the bot sends a message. (I actually haven't tested this)
    pub async fn trigger_typing(&self, channel_id: &str) -> Result<(), ClientError> {
        let url = format!("{}/channels/{}/typing", self.base_url, channel_id);
        self.request_empty(self.client.post(&url).body("{}")).await
    }

    /// Fetches messages from a channel. Use [`GetMessagesQuery`] to paginate.
    ///
    /// ```rust,no_run
    /// # async fn example(http: &fluxer::http::Http) {
    /// use fluxer::prelude::*;
    ///
    /// let query = GetMessagesQuery {
    ///     limit: Some(10),
    ///     ..Default::default()
    /// };
    /// let messages = http.get_messages("channel_id", query).await.unwrap();
    /// # }
    /// ```
    pub async fn get_messages(
        &self,
        channel_id: &str,
        query: GetMessagesQuery,
    ) -> Result<Vec<Message>, ClientError> {
        let url = format!(
            "{}/channels/{}/messages{}",
            self.base_url,
            channel_id,
            query.to_query_string()
        );
        self.request_json(self.client.get(&url)).await
    }

    /// Fetches a single message by ID.
    pub async fn get_message(
        &self,
        channel_id: &str,
        message_id: &str,
    ) -> Result<Message, ClientError> {
        let url = format!(
            "{}/channels/{}/messages/{}",
            self.base_url, channel_id, message_id
        );
        self.request_json(self.client.get(&url)).await
    }

    /// Sends a text message. For embeds or other options, use
    /// [`send_message_advanced`](Http::send_message_advanced).
    pub async fn send_message(
        &self,
        channel_id: &str,
        content: &str,
    ) -> Result<Message, ClientError> {
        let url = format!("{}/channels/{}/messages", self.base_url, channel_id);
        let body = json!({ "content": content });
        self.request_json(self.client.post(&url).json(&body)).await
    }

    /// Sends a message with full control over the payload (embeds, TTS, replies, etc).
    pub async fn send_message_advanced(
        &self,
        channel_id: &str,
        payload: &MessageCreatePayload,
    ) -> Result<Message, ClientError> {
        let url = format!("{}/channels/{}/messages", self.base_url, channel_id);
        self.request_json(self.client.post(&url).json(payload)).await
    }

    /// Shorthand for sending embeds. Wraps [`send_message_advanced`](Http::send_message_advanced).
    pub async fn send_embed(
        &self,
        channel_id: &str,
        content: Option<&str>,
        embeds: Vec<Embed>,
    ) -> Result<Message, ClientError> {
        let payload = MessageCreatePayload {
            content: content.map(|s| s.to_string()),
            embeds: Some(embeds),
            ..Default::default()
        };
        self.send_message_advanced(channel_id, &payload).await
    }

    /// Replies to a specific message. The client will render it as a reply thread.
    /// Fails with a 404 if the referenced message no longer exists.
    pub async fn reply_to_message(
        &self,
        channel_id: &str,
        message_id: &str,
        content: &str,
    ) -> Result<Message, ClientError> {
        let payload = MessageCreatePayload {
            content: Some(content.to_string()),
            message_reference: Some(MessageReference {
                message_id: message_id.to_string(),
                channel_id: None,
                guild_id: None,
                fail_if_not_exists: Some(true),
            }),
            ..Default::default()
        };
        self.send_message_advanced(channel_id, &payload).await
    }

    /// Edits a message's content. Bot must be the author.
    pub async fn edit_message(
        &self,
        channel_id: &str,
        message_id: &str,
        content: &str,
    ) -> Result<Message, ClientError> {
        let url = format!(
            "{}/channels/{}/messages/{}",
            self.base_url, channel_id, message_id
        );
        let body = json!({ "content": content });
        self.request_json(self.client.patch(&url).json(&body)).await
    }

    /// Edits a message with full control over the payload.
    pub async fn edit_message_advanced(
        &self,
        channel_id: &str,
        message_id: &str,
        payload: &MessageCreatePayload,
    ) -> Result<Message, ClientError> {
        let url = format!(
            "{}/channels/{}/messages/{}",
            self.base_url, channel_id, message_id
        );
        self.request_json(self.client.patch(&url).json(payload)).await
    }

    /// Deletes a message. Bot must be the author, or have Manage Messages.
    pub async fn delete_message(
        &self,
        channel_id: &str,
        message_id: &str,
    ) -> Result<(), ClientError> {
        let url = format!(
            "{}/channels/{}/messages/{}",
            self.base_url, channel_id, message_id
        );
        self.request_empty(self.client.delete(&url)).await
    }

    /// Deletes multiple messages at once. Way faster than deleting one by one.
    pub async fn bulk_delete_messages(
        &self,
        channel_id: &str,
        message_ids: Vec<&str>,
    ) -> Result<(), ClientError> {
        let url = format!(
            "{}/channels/{}/messages/bulk-delete",
            self.base_url, channel_id
        );
        let body = json!({ "message_ids": message_ids });
        self.request_empty(self.client.post(&url).json(&body)).await
    }

    /// Reacts to a message as the bot. `emoji` should be a unicode emoji like
    /// `"👍"` or a custom emoji in `name:id` format. You can use
    /// [`Emoji::to_reaction_string`] to get the right format.
    pub async fn add_reaction(
        &self,
        channel_id: &str,
        message_id: &str,
        emoji: &str,
    ) -> Result<(), ClientError> {
        let encoded = urlencoded(emoji);
        let url = format!(
            "{}/channels/{}/messages/{}/reactions/{}/@me",
            self.base_url, channel_id, message_id, encoded
        );
        self.request_empty(self.client.put(&url).body("")).await
    }

    /// Removes the bot's own reaction from a message.
    pub async fn remove_own_reaction(
        &self,
        channel_id: &str,
        message_id: &str,
        emoji: &str,
    ) -> Result<(), ClientError> {
        let encoded = urlencoded(emoji);
        let url = format!(
            "{}/channels/{}/messages/{}/reactions/{}/@me",
            self.base_url, channel_id, message_id, encoded
        );
        self.request_empty(self.client.delete(&url)).await
    }

    /// Removes someone else's reaction. Needs Manage Messages permission.
    pub async fn remove_user_reaction(
        &self,
        channel_id: &str,
        message_id: &str,
        emoji: &str,
        user_id: &str,
    ) -> Result<(), ClientError> {
        let encoded = urlencoded(emoji);
        let url = format!(
            "{}/channels/{}/messages/{}/reactions/{}/{}",
            self.base_url, channel_id, message_id, encoded, user_id
        );
        self.request_empty(self.client.delete(&url)).await
    }

    /// Gets the list of users who reacted with a specific emoji.
    pub async fn get_reactions(
        &self,
        channel_id: &str,
        message_id: &str,
        emoji: &str,
    ) -> Result<Vec<User>, ClientError> {
        let encoded = urlencoded(emoji);
        let url = format!(
            "{}/channels/{}/messages/{}/reactions/{}",
            self.base_url, channel_id, message_id, encoded
        );
        self.request_json(self.client.get(&url)).await
    }

    /// Removes all reactions from a message. Needs Manage Messages.
    pub async fn clear_reactions(
        &self,
        channel_id: &str,
        message_id: &str,
    ) -> Result<(), ClientError> {
        let url = format!(
            "{}/channels/{}/messages/{}/reactions",
            self.base_url, channel_id, message_id
        );
        self.request_empty(self.client.delete(&url)).await
    }

    /// Removes all reactions for a specific emoji. Needs Manage Messages.
    pub async fn clear_reactions_for_emoji(
        &self,
        channel_id: &str,
        message_id: &str,
        emoji: &str,
    ) -> Result<(), ClientError> {
        let encoded = urlencoded(emoji);
        let url = format!(
            "{}/channels/{}/messages/{}/reactions/{}",
            self.base_url, channel_id, message_id, encoded
        );
        self.request_empty(self.client.delete(&url)).await
    }

    /// Fetches pinned messages in a channel.
    pub async fn get_pins(&self, channel_id: &str) -> Result<PinsResponse, ClientError> {
        let url = format!("{}/channels/{}/messages/pins", self.base_url, channel_id);
        self.request_json(self.client.get(&url)).await
    }

    /// Pins a message. Needs Manage Messages.
    pub async fn pin_message(&self, channel_id: &str, message_id: &str) -> Result<(), ClientError> {
        let url = format!(
            "{}/channels/{}/pins/{}",
            self.base_url, channel_id, message_id
        );
        self.request_empty(self.client.put(&url).body("")).await
    }

    /// Unpins a message. Needs Manage Messages.
    pub async fn unpin_message(
        &self,
        channel_id: &str,
        message_id: &str,
    ) -> Result<(), ClientError> {
        let url = format!(
            "{}/channels/{}/pins/{}",
            self.base_url, channel_id, message_id
        );
        self.request_empty(self.client.delete(&url)).await
    }

    /// Fetches an invite by code. Includes approximate member counts.
    pub async fn get_invite(&self, invite_code: &str) -> Result<Invite, ClientError> {
        let url = format!("{}/invites/{}?with_counts=true", self.base_url, invite_code);
        self.request_json(self.client.get(&url)).await
    }

    /// Creates an invite for a channel.
    pub async fn create_invite(
        &self,
        channel_id: &str,
        payload: &CreateInvitePayload,
    ) -> Result<Invite, ClientError> {
        let url = format!("{}/channels/{}/invites", self.base_url, channel_id);
        self.request_json(self.client.post(&url).json(payload)).await
    }

    /// Deletes an invite by code.
    pub async fn delete_invite(&self, invite_code: &str) -> Result<(), ClientError> {
        let url = format!("{}/invites/{}", self.base_url, invite_code);
        self.request_empty(self.client.delete(&url)).await
    }

    /// Accepts an invite.
    pub async fn accept_invite(&self, invite_code: &str) -> Result<Invite, ClientError> {
        let url = format!("{}/invites/{}", self.base_url, invite_code);
        self.request_json(self.client.post(&url).body("")).await
    }

    /// Returns all active invites for a channel.
    pub async fn get_channel_invites(&self, channel_id: &str) -> Result<Vec<Invite>, ClientError> {
        let url = format!("{}/channels/{}/invites", self.base_url, channel_id);
        self.request_json(self.client.get(&url)).await
    }

    /// Returns all active invites for a guild.
    pub async fn get_guild_invites(&self, guild_id: &str) -> Result<Vec<Invite>, ClientError> {
        let url = format!("{}/guilds/{}/invites", self.base_url, guild_id);
        self.request_json(self.client.get(&url)).await
    }

    /// Fetches a guild by ID.
    pub async fn get_guild(&self, guild_id: &str) -> Result<Guild, ClientError> {
        let url = format!("{}/guilds/{}", self.base_url, guild_id);
        self.request_json(self.client.get(&url)).await
    }

    /// Edits guild settings. Only fields you set in the payload will change.
    pub async fn edit_guild(
        &self,
        guild_id: &str,
        payload: &EditGuildPayload,
    ) -> Result<Guild, ClientError> {
        let url = format!("{}/guilds/{}", self.base_url, guild_id);
        self.request_json(self.client.patch(&url).json(payload)).await
    }

    /// Permanently deletes a guild. The bot must be the owner. (not tested)
    pub async fn delete_guild(&self, guild_id: &str) -> Result<(), ClientError> {
        let url = format!("{}/guilds/{}/delete", self.base_url, guild_id);
        self.request_empty(self.client.post(&url).body("")).await
    }

    /// Creates a guild.
    pub async fn create_guild(&self, payload: &GuildCreatePayload) -> Result<Guild, ClientError> {
        let url = format!("{}/guilds", self.base_url);
        self.request_json(self.client.post(&url).json(payload))
            .await
    }

    /// Returns all channels in a guild.
    pub async fn get_guild_channels(&self, guild_id: &str) -> Result<Vec<Channel>, ClientError> {
        let url = format!("{}/guilds/{}/channels", self.base_url, guild_id);
        self.request_json(self.client.get(&url)).await
    }

    /// Creates a channel in a guild. You need at least `name` in the payload.
    pub async fn create_channel(
        &self,
        guild_id: &str,
        payload: &ChannelCreatePayload,
    ) -> Result<Channel, ClientError> {
        let url = format!("{}/guilds/{}/channels", self.base_url, guild_id);
        self.request_json(self.client.post(&url).json(payload)).await
    }

    /// Fetches a single guild member.
    pub async fn get_guild_member(
        &self,
        guild_id: &str,
        user_id: &str,
    ) -> Result<Member, ClientError> {
        let url = format!("{}/guilds/{}/members/{}", self.base_url, guild_id, user_id);
        self.request_json(self.client.get(&url)).await
    }

    /// Fetches guild members. `limit` caps at 1000, `after` is a user ID for pagination.
    pub async fn get_guild_members(
        &self,
        guild_id: &str,
        limit: Option<u16>,
        after: Option<&str>,
    ) -> Result<Vec<Member>, ClientError> {
        let mut url = format!("{}/guilds/{}/members?", self.base_url, guild_id);
        if let Some(l) = limit {
            url.push_str(&format!("limit={}&", l.min(1000)));
        }
        if let Some(a) = after {
            url.push_str(&format!("after={}", a));
        }
        self.request_json(self.client.get(&url)).await
    }

    /// Kicks a member from the guild.
    pub async fn kick_member(&self, guild_id: &str, user_id: &str) -> Result<(), ClientError> {
        let url = format!("{}/guilds/{}/members/{}", self.base_url, guild_id, user_id);
        self.request_empty(self.client.delete(&url)).await
    }

    /// Edits a member's properties. To clear a nullable field like `nick`,
    /// set it to `Some(None)`.
    pub async fn edit_member(
        &self,
        guild_id: &str,
        user_id: &str,
        payload: &EditMemberPayload,
    ) -> Result<Member, ClientError> {
        let url = format!("{}/guilds/{}/members/{}", self.base_url, guild_id, user_id);
        self.request_json(self.client.patch(&url).json(payload)).await
    }

    /// Grants a role to a guild member. Requires Manage Roles.
    pub async fn add_member_role(
        &self,
        guild_id: &str,
        user_id: &str,
        role_id: &str,
    ) -> Result<(), ClientError> {
        let url = format!(
            "{}/guilds/{}/members/{}/roles/{}",
            self.base_url, guild_id, user_id, role_id
        );
        self.request_empty(self.client.put(&url).body("")).await
    }

    /// Removes a role from a guild member. Requires Manage Roles.
    pub async fn remove_member_role(
        &self,
        guild_id: &str,
        user_id: &str,
        role_id: &str,
    ) -> Result<(), ClientError> {
        let url = format!(
            "{}/guilds/{}/members/{}/roles/{}",
            self.base_url, guild_id, user_id, role_id
        );
        self.request_empty(self.client.delete(&url)).await
    }

    /// Bans a member. `reason` is stored in the audit log.
    pub async fn ban_member(
        &self,
        guild_id: &str,
        user_id: &str,
        reason: &str,
    ) -> Result<(), ClientError> {
        let url = format!("{}/guilds/{}/bans/{}", self.base_url, guild_id, user_id);
        let body = json!({ "reason": reason });
        self.request_empty(self.client.put(&url).json(&body)).await
    }

    /// Removes a ban.
    pub async fn unban_member(&self, guild_id: &str, user_id: &str) -> Result<(), ClientError> {
        let url = format!("{}/guilds/{}/bans/{}", self.base_url, guild_id, user_id);
        self.request_empty(self.client.delete(&url)).await
    }

    /// Returns the guild's ban list.
    pub async fn get_guild_bans(
        &self,
        guild_id: &str,
    ) -> Result<Vec<serde_json::Value>, ClientError> {
        let url = format!("{}/guilds/{}/bans", self.base_url, guild_id);
        self.request_json(self.client.get(&url)).await
    }

    /// Returns all roles in a guild.
    pub async fn get_guild_roles(&self, guild_id: &str) -> Result<Vec<Role>, ClientError> {
        let url = format!("{}/guilds/{}/roles", self.base_url, guild_id);
        self.request_json(self.client.get(&url)).await
    }

    /// Creates a new role in a guild.
    pub async fn create_role(
        &self,
        guild_id: &str,
        payload: &CreateRolePayload,
    ) -> Result<Role, ClientError> {
        let url = format!("{}/guilds/{}/roles", self.base_url, guild_id);
        self.request_json(self.client.post(&url).json(payload)).await
    }

    /// Edits a role's properties.
    pub async fn edit_role(
        &self,
        guild_id: &str,
        role_id: &str,
        payload: &EditRolePayload,
    ) -> Result<Role, ClientError> {
        let url = format!("{}/guilds/{}/roles/{}", self.base_url, guild_id, role_id);
        self.request_json(self.client.patch(&url).json(payload)).await
    }

    /// Deletes a role.
    pub async fn delete_role(&self, guild_id: &str, role_id: &str) -> Result<(), ClientError> {
        let url = format!("{}/guilds/{}/roles/{}", self.base_url, guild_id, role_id);
        self.request_empty(self.client.delete(&url)).await
    }

    /// Returns all custom emojis in a guild.
    pub async fn get_guild_emojis(&self, guild_id: &str) -> Result<Vec<Emoji>, ClientError> {
        let url = format!("{}/guilds/{}/emojis", self.base_url, guild_id);
        self.request_json(self.client.get(&url)).await
    }

    /// Returns metadata about an emoji.
    pub async fn get_emoji_metadata(
        &self,
        emoji_id: &str,
    ) -> Result<GuildEmojiMetadata, ClientError> {
        let url = format!("{}/emojis/{}/metadata", self.base_url, emoji_id);
        self.request_json(self.client.get(&url)).await
    }

    /// Deletes a custom emoji from a guild.
    pub async fn delete_guild_emoji(
        &self,
        guild_id: &str,
        emoji_id: &str,
    ) -> Result<(), ClientError> {
        let url = format!("{}/guilds/{}/emojis/{}", self.base_url, guild_id, emoji_id);
        self.request_empty(self.client.delete(&url)).await
    }

    /// Returns all webhooks for a channel.
    pub async fn get_channel_webhooks(
        &self,
        channel_id: &str,
    ) -> Result<Vec<Webhook>, ClientError> {
        let url = format!("{}/channels/{}/webhooks", self.base_url, channel_id);
        self.request_json(self.client.get(&url)).await
    }

    /// Returns all webhooks for a guild.
    pub async fn get_guild_webhooks(&self, guild_id: &str) -> Result<Vec<Webhook>, ClientError> {
        let url = format!("{}/guilds/{}/webhooks", self.base_url, guild_id);
        self.request_json(self.client.get(&url)).await
    }

    /// `avatar` should be a data URI if provided.
    pub async fn create_webhook(
        &self,
        channel_id: &str,
        name: &str,
        avatar: Option<&str>,
    ) -> Result<Webhook, ClientError> {
        let url = format!("{}/channels/{}/webhooks", self.base_url, channel_id);
        let mut body = json!({ "name": name });
        if let Some(av) = avatar {
            body["avatar"] = serde_json::Value::String(av.to_string());
        }
        self.request_json(self.client.post(&url).json(&body)).await
    }

    /// Deletes a webhook.
    pub async fn delete_webhook(&self, webhook_id: &str) -> Result<(), ClientError> {
        let url = format!("{}/webhooks/{}", self.base_url, webhook_id);
        self.request_empty(self.client.delete(&url)).await
    }

    /// Sends a message with one or more file attachments. `content` is optional
    /// if you just want to upload files with no text.
    pub async fn send_files(
        &self,
        channel_id: &str,
        files: Vec<AttachmentFile>,
        content: Option<&str>,
    ) -> Result<Message, ClientError> {
        let payload = MessageCreatePayload {
            content: content.map(|s| s.to_string()),
            ..Default::default()
        };
        self.send_message_with_files(channel_id, &payload, files).await
    }

    /// Like [`send_message_advanced`](Http::send_message_advanced) but also uploads files as attachments.
    pub async fn send_message_with_files(
        &self,
        channel_id: &str,
        payload: &MessageCreatePayload,
        files: Vec<AttachmentFile>,
    ) -> Result<Message, ClientError> {
        use reqwest::multipart::{Form, Part};

        let url = format!("{}/channels/{}/messages", self.base_url, channel_id);

        let mut payload = payload.clone();
        payload.attachments = Some(
            files
                .iter()
                .enumerate()
                .map(|(i, f)| AttachmentMetadata {
                    id: i as u64,
                    filename: f.filename.clone(),
                    description: None,
                })
                .collect(),
        );
        let json_string = serde_json::to_string(&payload)?;

        let mut form = Form::new().text("payload_json", json_string);
        for (i, file) in files.into_iter().enumerate() {
            let content_type = file
                .content_type
                .unwrap_or_else(|| "application/octet-stream".to_string());
            let part = Part::bytes(file.data)
                .file_name(file.filename)
                .mime_str(&content_type)
                .map_err(ClientError::Http)?;
            form = form.part(format!("files[{}]", i), part);
        }

        let req = self.client.post(&url).multipart(form);
        self.request_json(req).await
    }

    /// Lists RTC regions available for a voice channel.
    pub async fn get_rtc_regions(&self, channel_id: &str) -> Result<Vec<RtcRegion>, ClientError> {
        let url = format!("{}/channels/{}/rtc-regions", self.base_url, channel_id);
        self.request_json(self.client.get(&url)).await
    }

    /// Returns the current slowmode state for the caller in a channel.
    pub async fn get_channel_slowmode(
        &self,
        channel_id: &str,
    ) -> Result<ChannelSlowmodeState, ClientError> {
        let url = format!("{}/channels/{}/slowmode", self.base_url, channel_id);
        self.request_json(self.client.get(&url)).await
    }

    /// Searches messages across the platform. See [`SearchMessagesQuery`] for
    /// all available filters (content, author, channel, attachments, etc).
    pub async fn search_messages(
        &self,
        query: &SearchMessagesQuery,
    ) -> Result<SearchMessagesResponse, ClientError> {
        let url = format!("{}/search/messages", self.base_url);
        self.request_json(self.client.post(&url).json(query)).await
    }

    /// Marks multiple channels as read in a single request. Pass up to 100
    /// `(channel_id, last_message_id)` pairs.
    pub async fn ack_bulk(&self, states: Vec<ReadStateAck>) -> Result<(), ClientError> {
        let url = format!("{}/read-states/ack-bulk", self.base_url);
        let body = json!({ "read_states": states });
        self.request_empty(self.client.post(&url).json(&body)).await
    }

    /// Returns the guild audit log and referenced users/webhooks.
    pub async fn get_guild_audit_logs(
        &self,
        guild_id: &str,
    ) -> Result<GuildAuditLogList, ClientError> {
        let url = format!("{}/guilds/{}/audit-logs", self.base_url, guild_id);
        self.request_json(self.client.get(&url)).await
    }

    /// Returns the guild vanity invite code and usage count.
    pub async fn get_guild_vanity_url(
        &self,
        guild_id: &str,
    ) -> Result<GuildVanityUrl, ClientError> {
        let url = format!("{}/guilds/{}/vanity-url", self.base_url, guild_id);
        self.request_json(self.client.get(&url)).await
    }

    /// Sets or clears the guild vanity invite code.
    pub async fn update_guild_vanity_url(
        &self,
        guild_id: &str,
        payload: &GuildVanityUrlUpdatePayload,
    ) -> Result<GuildVanityUrlUpdateResponse, ClientError> {
        let url = format!("{}/guilds/{}/vanity-url", self.base_url, guild_id);
        self.request_json(self.client.patch(&url).json(payload)).await
    }

    /// Executes a webhook (sends a message through it). Uses `wait=true` so
    /// the response includes the full message object.
    pub async fn execute_webhook(
        &self,
        webhook_id: &str,
        webhook_token: &str,
        payload: &WebhookExecutePayload,
    ) -> Result<Option<Message>, ClientError> {
        let url = format!(
            "{}/webhooks/{}/{}?wait=true",
            self.base_url, webhook_id, webhook_token
        );
        self.request_json(self.client.post(&url).json(payload)).await
    }

    /// Gets a message previously sent by a webhook.
    pub async fn get_webhook_message(
        &self,
        webhook_id: &str,
        webhook_token: &str,
        message_id: &str,
    ) -> Result<Message, ClientError> {
        let url = format!(
            "{}/webhooks/{}/{}/messages/{}",
            self.base_url, webhook_id, webhook_token, message_id
        );
        self.request_json(self.client.get(&url)).await
    }

    /// Edits a message previously sent by a webhook.
    pub async fn edit_webhook_message(
        &self,
        webhook_id: &str,
        webhook_token: &str,
        message_id: &str,
        payload: &WebhookEditPayload,
    ) -> Result<Message, ClientError> {
        let url = format!(
            "{}/webhooks/{}/{}/messages/{}",
            self.base_url, webhook_id, webhook_token, message_id
        );
        self.request_json(self.client.patch(&url).json(payload)).await
    }
}

fn urlencoded(s: &str) -> String {
    s.chars()
        .flat_map(|c| {
            let mut buf = [0u8; 4];
            c.encode_utf8(&mut buf);
            let bytes = &buf[..c.len_utf8()];
            bytes
                .iter()
                .map(|b| match b {
                    b'A'..=b'Z' | b'a'..=b'z' | b'0'..=b'9' | b'-' | b'_' | b'.' | b'~' | b':' => {
                        char::from(*b).to_string()
                    }
                    other => format!("%{:02X}", other),
                })
                .collect::<Vec<_>>()
        })
        .collect()
}