mij-discord 1.0.0

data/lib/mij-discord/core/api/channel.rb

@@ -0,0 +1,416 @@
+# frozen_string_literal: true
+
+module MijDiscord::Core::API::Channel
+  class << self
+    # Get a channel's data
+    # https://discordapp.com/developers/docs/resources/channel#get-channel
+    def resolve(token, channel_id)
+      MijDiscord::Core::API.request(
+        :channels_cid,
+        channel_id,
+        :get,
+        "#{MijDiscord::Core::API::APIBASE_URL}/channels/#{channel_id}",
+        Authorization: token
+      )
+    end
+
+    # Update a channel's data
+    # https://discordapp.com/developers/docs/resources/channel#modify-channel
+    def update(token, channel_id, name, topic, nsfw, parent_id, position, bitrate, user_limit, reason = nil)
+      MijDiscord::Core::API.request(
+        :channels_cid,
+        channel_id,
+        :patch,
+        "#{MijDiscord::Core::API::APIBASE_URL}/channels/#{channel_id}",
+        {
+          name: name, topic: topic, nsfw: nsfw,
+          parent_id: parent_id, position: position,
+          bitrate: bitrate, user_limit: user_limit
+        }.delete_if {|_, v| v.nil? }.to_json,
+        Authorization: token,
+        content_type: :json,
+        'X-Audit-Log-Reason': reason
+      )
+    end
+
+    # Delete a channel
+    # https://discordapp.com/developers/docs/resources/channel#deleteclose-channel
+    def delete(token, channel_id, reason = nil)
+      MijDiscord::Core::API.request(
+        :channels_cid,
+        channel_id,
+        :delete,
+        "#{MijDiscord::Core::API::APIBASE_URL}/channels/#{channel_id}",
+        Authorization: token,
+        'X-Audit-Log-Reason': reason
+      )
+    end
+
+    # Get a list of messages from a channel's history
+    # https://discordapp.com/developers/docs/resources/channel#get-channel-messages
+    def messages(token, channel_id, amount, before = nil, after = nil, around = nil)
+      MijDiscord::Core::API.request(
+        :channels_cid_messages,
+        channel_id,
+        :get,
+        "#{MijDiscord::Core::API::APIBASE_URL}/channels/#{channel_id}/messages?limit=#{amount}#{"&before=#{before}" if before}#{"&after=#{after}" if after}#{"&around=#{around}" if around}",
+        Authorization: token
+      )
+    end
+
+    # Get a single message from a channel's history by id
+    # https://discordapp.com/developers/docs/resources/channel#get-channel-message
+    def message(token, channel_id, message_id)
+      MijDiscord::Core::API.request(
+        :channels_cid_messages_mid,
+        channel_id,
+        :get,
+        "#{MijDiscord::Core::API::APIBASE_URL}/channels/#{channel_id}/messages/#{message_id}",
+        Authorization: token
+      )
+    end
+
+    # Send a message to a channel
+    # https://discordapp.com/developers/docs/resources/channel#create-message
+    def create_message(token, channel_id, message, tts = false, embed = nil, mentions = [])
+      MijDiscord::Core::API.request(
+        :channels_cid_messages_mid,
+        channel_id,
+        :post,
+        "#{MijDiscord::Core::API::APIBASE_URL}/channels/#{channel_id}/messages",
+        { content: message, mentions: mentions, tts: tts, embed: embed }.to_json,
+        Authorization: token,
+        content_type: :json
+      )
+    rescue RestClient::BadRequest => e
+      parsed = JSON.parse(e.response.body)
+      if (content = parsed['content']).is_a?(Array) && content.first == 'Must be 2000 or fewer characters long.'
+        raise MijDiscord::Core::Errors::MessageTooLong, "Message over the character limit (#{message.length} > 2000)"
+      end
+      raise
+    end
+
+    # Send a file as a message to a channel
+    # https://discordapp.com/developers/docs/resources/channel#upload-file
+    def upload_file(token, channel_id, file, caption = nil, tts = false)
+      MijDiscord::Core::API.request(
+        :channels_cid_messages_mid,
+        channel_id,
+        :post,
+        "#{MijDiscord::Core::API::APIBASE_URL}/channels/#{channel_id}/messages",
+        { file: file, content: caption, tts: tts },
+        Authorization: token
+      )
+    end
+
+    # Edit a message
+    # https://discordapp.com/developers/docs/resources/channel#edit-message
+    def edit_message(token, channel_id, message_id, message, mentions = [], embed = nil)
+      MijDiscord::Core::API.request(
+        :channels_cid_messages_mid,
+        channel_id,
+        :patch,
+        "#{MijDiscord::Core::API::APIBASE_URL}/channels/#{channel_id}/messages/#{message_id}",
+        { content: message, mentions: mentions, embed: embed }.to_json,
+        Authorization: token,
+        content_type: :json
+      )
+    end
+
+    # Delete a message
+    # https://discordapp.com/developers/docs/resources/channel#delete-message
+    def delete_message(token, channel_id, message_id)
+      MijDiscord::Core::API.request(
+        :channels_cid_messages_mid,
+        channel_id,
+        :delete,
+        "#{MijDiscord::Core::API::APIBASE_URL}/channels/#{channel_id}/messages/#{message_id}",
+        Authorization: token
+      )
+    end
+
+    # Delete messages in bulk
+    # https://discordapp.com/developers/docs/resources/channel#bulk-delete-messages
+    def bulk_delete_messages(token, channel_id, messages = [])
+      MijDiscord::Core::API.request(
+        :channels_cid_messages_bulk_delete,
+        channel_id,
+        :post,
+        "#{MijDiscord::Core::API::APIBASE_URL}/channels/#{channel_id}/messages/bulk-delete",
+        { messages: messages }.to_json,
+        Authorization: token,
+        content_type: :json
+      )
+    end
+
+    # Create a reaction on a message using this client
+    # https://discordapp.com/developers/docs/resources/channel#create-reaction
+    def create_reaction(token, channel_id, message_id, emoji)
+      emoji = URI.encode(emoji) unless emoji.ascii_only?
+      MijDiscord::Core::API.request(
+        :channels_cid_messages_mid_reactions_emoji_me,
+        channel_id,
+        :put,
+        "#{MijDiscord::Core::API::APIBASE_URL}/channels/#{channel_id}/messages/#{message_id}/reactions/#{emoji}/@me",
+        nil,
+        Authorization: token,
+        content_type: :json,
+        header_bypass_delay: 0.25
+      )
+    end
+
+    # Delete this client's own reaction on a message
+    # https://discordapp.com/developers/docs/resources/channel#delete-own-reaction
+    def delete_own_reaction(token, channel_id, message_id, emoji)
+      emoji = URI.encode(emoji) unless emoji.ascii_only?
+      MijDiscord::Core::API.request(
+        :channels_cid_messages_mid_reactions_emoji_me,
+        channel_id,
+        :delete,
+        "#{MijDiscord::Core::API::APIBASE_URL}/channels/#{channel_id}/messages/#{message_id}/reactions/#{emoji}/@me",
+        Authorization: token,
+        header_bypass_delay: 0.25
+      )
+    end
+
+    # Delete another client's reaction on a message
+    # https://discordapp.com/developers/docs/resources/channel#delete-user-reaction
+    def delete_user_reaction(token, channel_id, message_id, emoji, user_id)
+      emoji = URI.encode(emoji) unless emoji.ascii_only?
+      MijDiscord::Core::API.request(
+        :channels_cid_messages_mid_reactions_emoji_uid,
+        channel_id,
+        :delete,
+        "#{MijDiscord::Core::API::APIBASE_URL}/channels/#{channel_id}/messages/#{message_id}/reactions/#{emoji}/#{user_id}",
+        Authorization: token,
+        header_bypass_delay: 0.25
+      )
+    end
+
+    # Get a list of clients who reacted with a specific reaction on a message
+    # https://discordapp.com/developers/docs/resources/channel#get-reactions
+    def get_reactions(token, channel_id, message_id, emoji)
+      emoji = URI.encode(emoji) unless emoji.ascii_only?
+      MijDiscord::Core::API.request(
+        :channels_cid_messages_mid_reactions_emoji,
+        channel_id,
+        :get,
+        "#{MijDiscord::Core::API::APIBASE_URL}/channels/#{channel_id}/messages/#{message_id}/reactions/#{emoji}",
+        Authorization: token
+      )
+    end
+
+    # Deletes all reactions on a message from all clients
+    # https://discordapp.com/developers/docs/resources/channel#delete-all-reactions
+    def delete_all_reactions(token, channel_id, message_id)
+      MijDiscord::Core::API.request(
+        :channels_cid_messages_mid_reactions,
+        channel_id,
+        :delete,
+        "#{MijDiscord::Core::API::APIBASE_URL}/channels/#{channel_id}/messages/#{message_id}/reactions",
+        Authorization: token
+      )
+    end
+
+    # Update a channels permission for a role or member
+    # https://discordapp.com/developers/docs/resources/channel#edit-channel-permissions
+    def update_permission(token, channel_id, overwrite_id, allow, deny, type, reason = nil)
+      MijDiscord::Core::API.request(
+        :channels_cid_permissions_oid,
+        channel_id,
+        :put,
+        "#{MijDiscord::Core::API::APIBASE_URL}/channels/#{channel_id}/permissions/#{overwrite_id}",
+        { type: type, id: overwrite_id, allow: allow, deny: deny }.to_json,
+        Authorization: token,
+        content_type: :json,
+        'X-Audit-Log-Reason': reason
+      )
+    end
+
+    # Get a channel's invite list
+    # https://discordapp.com/developers/docs/resources/channel#get-channel-invites
+    def invites(token, channel_id)
+      MijDiscord::Core::API.request(
+        :channels_cid_invites,
+        channel_id,
+        :get,
+        "#{MijDiscord::Core::API::APIBASE_URL}/channels/#{channel_id}/invites",
+        Authorization: token
+      )
+    end
+
+    # Create an instant invite from a server or a channel id
+    # https://discordapp.com/developers/docs/resources/channel#create-channel-invite
+    def create_invite(token, channel_id, max_age = 0, max_uses = 0, temporary = false, unique = false, reason = nil)
+      MijDiscord::Core::API.request(
+        :channels_cid_invites,
+        channel_id,
+        :post,
+        "#{MijDiscord::Core::API::APIBASE_URL}/channels/#{channel_id}/invites",
+        { max_age: max_age, max_uses: max_uses, temporary: temporary, unique: unique }.to_json,
+        Authorization: token,
+        content_type: :json,
+        'X-Audit-Log-Reason': reason
+      )
+    end
+
+    # Delete channel permission
+    # https://discordapp.com/developers/docs/resources/channel#delete-channel-permission
+    def delete_permission(token, channel_id, overwrite_id, reason = nil)
+      MijDiscord::Core::API.request(
+        :channels_cid_permissions_oid,
+        channel_id,
+        :delete,
+        "#{MijDiscord::Core::API::APIBASE_URL}/channels/#{channel_id}/permissions/#{overwrite_id}",
+        Authorization: token,
+        'X-Audit-Log-Reason': reason
+      )
+    end
+
+    # Start typing (needs to be resent every 5 seconds to keep up the typing)
+    # https://discordapp.com/developers/docs/resources/channel#trigger-typing-indicator
+    def start_typing(token, channel_id)
+      MijDiscord::Core::API.request(
+        :channels_cid_typing,
+        channel_id,
+        :post,
+        "#{MijDiscord::Core::API::APIBASE_URL}/channels/#{channel_id}/typing",
+        nil,
+        Authorization: token
+      )
+    end
+
+    # Get a list of pinned messages in a channel
+    # https://discordapp.com/developers/docs/resources/channel#get-pinned-messages
+    def pinned_messages(token, channel_id)
+      MijDiscord::Core::API.request(
+        :channels_cid_pins,
+        channel_id,
+        :get,
+        "#{MijDiscord::Core::API::APIBASE_URL}/channels/#{channel_id}/pins",
+        Authorization: token
+      )
+    end
+
+    # Pin a message
+    # https://discordapp.com/developers/docs/resources/channel#add-pinned-channel-message
+    def pin_message(token, channel_id, message_id)
+      MijDiscord::Core::API.request(
+        :channels_cid_pins_mid,
+        channel_id,
+        :put,
+        "#{MijDiscord::Core::API::APIBASE_URL}/channels/#{channel_id}/pins/#{message_id}",
+        nil,
+        Authorization: token
+      )
+    end
+
+    # Unpin a message
+    # https://discordapp.com/developers/docs/resources/channel#delete-pinned-channel-message
+    def unpin_message(token, channel_id, message_id)
+      MijDiscord::Core::API.request(
+        :channels_cid_pins_mid,
+        channel_id,
+        :delete,
+        "#{MijDiscord::Core::API::APIBASE_URL}/channels/#{channel_id}/pins/#{message_id}",
+        Authorization: token
+      )
+    end
+
+    # Create an empty group channel.
+    def create_empty_group(token, bot_user_id)
+      MijDiscord::Core::API.request(
+        :users_uid_channels,
+        nil,
+        :post,
+        "#{MijDiscord::Core::API::APIBASE_URL}/users/#{bot_user_id}/channels",
+        {}.to_json,
+        Authorization: token,
+        content_type: :json
+      )
+    end
+
+    # Create a group channel.
+    def create_group(token, pm_channel_id, user_id)
+      MijDiscord::Core::API.request(
+        :channels_cid_recipients_uid,
+        nil,
+        :put,
+        "#{MijDiscord::Core::API::APIBASE_URL}/channels/#{pm_channel_id}/recipients/#{user_id}",
+        {}.to_json,
+        Authorization: token,
+        content_type: :json
+      )
+    rescue RestClient::InternalServerError
+      raise 'Attempted to add self as a new group channel recipient!'
+    rescue RestClient::NoContent
+      raise 'Attempted to create a group channel with the PM channel recipient!'
+    rescue RestClient::Forbidden
+      raise 'Attempted to add a user to group channel without permission!'
+    end
+
+    # Add a user to a group channel.
+    def add_group_user(token, group_channel_id, user_id)
+      MijDiscord::Core::API.request(
+        :channels_cid_recipients_uid,
+        nil,
+        :put,
+        "#{MijDiscord::Core::API::APIBASE_URL}/channels/#{group_channel_id}/recipients/#{user_id}",
+        {}.to_json,
+        Authorization: token,
+        content_type: :json
+      )
+    end
+
+    # Remove a user from a group channel.
+    def remove_group_user(token, group_channel_id, user_id)
+      MijDiscord::Core::API.request(
+        :channels_cid_recipients_uid,
+        nil,
+        :delete,
+        "#{MijDiscord::Core::API::APIBASE_URL}/channels/#{group_channel_id}/recipients/#{user_id}",
+        Authorization: token,
+        content_type: :json
+      )
+    end
+
+    # Leave a group channel.
+    def leave_group(token, group_channel_id)
+      MijDiscord::Core::API.request(
+        :channels_cid,
+        nil,
+        :delete,
+        "#{MijDiscord::Core::API::APIBASE_URL}/channels/#{group_channel_id}",
+        Authorization: token,
+        content_type: :json
+      )
+    end
+
+    # Create a webhook
+    # https://discordapp.com/developers/docs/resources/webhook#create-webhook
+    def create_webhook(token, channel_id, name, avatar = nil, reason = nil)
+      MijDiscord::Core::API.request(
+        :channels_cid_webhooks,
+        channel_id,
+        :post,
+        "#{MijDiscord::Core::API::APIBASE_URL}/channels/#{channel_id}/webhooks",
+        { name: name, avatar: avatar }.to_json,
+        Authorization: token,
+        content_type: :json,
+        'X-Audit-Log-Reason': reason
+      )
+    end
+
+    # Get channel webhooks
+    # https://discordapp.com/developers/docs/resources/webhook#get-channel-webhooks
+    def webhooks(token, channel_id)
+      MijDiscord::Core::API.request(
+        :channels_cid_webhooks,
+        channel_id,
+        :get,
+        "#{MijDiscord::Core::API::APIBASE_URL}/channels/#{channel_id}/webhooks",
+        Authorization: token
+      )
+    end
+  end
+end

data/lib/mij-discord/core/api/invite.rb

@@ -0,0 +1,43 @@
+# frozen_string_literal: true
+
+module MijDiscord::Core::API::Invite
+  class << self
+    # Resolve an invite
+    # https://discordapp.com/developers/docs/resources/invite#get-invite
+    def resolve(token, invite_code)
+      MijDiscord::Core::API.request(
+        :invite_code,
+        nil,
+        :get,
+        "#{MijDiscord::Core::API::APIBASE_URL}/invite/#{invite_code}",
+        Authorization: token
+      )
+    end
+
+    # Delete an invite by code
+    # https://discordapp.com/developers/docs/resources/invite#delete-invite
+    def delete(token, code, reason = nil)
+      MijDiscord::Core::API.request(
+        :invites_code,
+        nil,
+        :delete,
+        "#{MijDiscord::Core::API::APIBASE_URL}/invites/#{code}",
+        Authorization: token,
+        'X-Audit-Log-Reason': reason
+      )
+    end
+
+    # Join a server using an invite
+    # https://discordapp.com/developers/docs/resources/invite#accept-invite
+    def accept(token, invite_code)
+      MijDiscord::Core::API.request(
+        :invite_code,
+        nil,
+        :post,
+        "#{MijDiscord::Core::API::APIBASE_URL}/invite/#{invite_code}",
+        nil,
+        Authorization: token
+      )
+    end
+  end
+end