mij-discord 1.0.0

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

@@ -0,0 +1,465 @@
+# frozen_string_literal: true
+
+module MijDiscord::Core::API::Server
+  class << self
+    # Create a server
+    # https://discordapp.com/developers/docs/resources/guild#create-guild
+    def create(token, name, region = :'eu-central')
+      MijDiscord::Core::API.request(
+        :guilds,
+        nil,
+        :post,
+        "#{MijDiscord::Core::API::APIBASE_URL}/guilds",
+        { name: name, region: region.to_s }.to_json,
+        Authorization: token,
+        content_type: :json
+      )
+    end
+
+    # Get a server's data
+    # https://discordapp.com/developers/docs/resources/guild#get-guild
+    def resolve(token, server_id)
+      MijDiscord::Core::API.request(
+        :guilds_sid,
+        server_id,
+        :get,
+        "#{MijDiscord::Core::API::APIBASE_URL}/guilds/#{server_id}",
+        Authorization: token
+      )
+    end
+
+    # Update a server
+    # https://discordapp.com/developers/docs/resources/guild#modify-guild
+    def update(token, server_id, name, region, icon, afk_channel_id, afk_timeout, reason = nil)
+      MijDiscord::Core::API.request(
+        :guilds_sid,
+        server_id,
+        :patch,
+        "#{MijDiscord::Core::API::APIBASE_URL}/guilds/#{server_id}",
+        {
+          name: name, region: region, icon: icon,
+          afk_channel_id: afk_channel_id, afk_timeout: afk_timeout
+        }.delete_if {|_, v| v.nil? }.to_json,
+        Authorization: token,
+        content_type: :json,
+        'X-Audit-Log-Reason': reason
+      )
+    end
+
+    # Transfer server ownership
+    def transfer_ownership(token, server_id, user_id, reason = nil)
+      MijDiscord::Core::API.request(
+        :guilds_sid,
+        server_id,
+        :patch,
+        "#{MijDiscord::Core::API::APIBASE_URL}/guilds/#{server_id}",
+        { owner_id: user_id }.to_json,
+        Authorization: token,
+        content_type: :json,
+        'X-Audit-Log-Reason': reason
+      )
+    end
+
+    # Delete a server
+    # https://discordapp.com/developers/docs/resources/guild#delete-guild
+    def delete(token, server_id)
+      MijDiscord::Core::API.request(
+        :guilds_sid,
+        server_id,
+        :delete,
+        "#{MijDiscord::Core::API::APIBASE_URL}/guilds/#{server_id}",
+        Authorization: token
+      )
+    end
+
+    # Get a server's channels list
+    # https://discordapp.com/developers/docs/resources/guild#get-guild-channels
+    def channels(token, server_id)
+      MijDiscord::Core::API.request(
+        :guilds_sid_channels,
+        server_id,
+        :get,
+        "#{MijDiscord::Core::API::APIBASE_URL}/guilds/#{server_id}/channels",
+        Authorization: token
+      )
+    end
+
+    # Create a channel
+    # https://discordapp.com/developers/docs/resources/guild#create-guild-channel
+    def create_channel(token, server_id, name, type, bitrate, user_limit, permissions, nsfw, reason = nil)
+      MijDiscord::Core::API.request(
+        :guilds_sid_channels,
+        server_id,
+        :post,
+        "#{MijDiscord::Core::API::APIBASE_URL}/guilds/#{server_id}/channels",
+        { name: name, type: type, bitrate: bitrate, user_limit: user_limit, permission_overwrites: permissions, nsfw: nsfw }.to_json,
+        Authorization: token,
+        content_type: :json,
+        'X-Audit-Log-Reason': reason
+      )
+    end
+
+    # Update a channels position
+    # https://discordapp.com/developers/docs/resources/guild#modify-guild-channel
+    def update_channel_position(token, server_id, channel_id, position, reason = nil)
+      MijDiscord::Core::API.request(
+        :guilds_sid_channels,
+        server_id,
+        :patch,
+        "#{MijDiscord::Core::API::APIBASE_URL}/guilds/#{server_id}/channels",
+        { id: channel_id, position: position }.to_json,
+        Authorization: token,
+        content_type: :json,
+        'X-Audit-Log-Reason': reason
+      )
+    end
+
+    # Get a member's data
+    # https://discordapp.com/developers/docs/resources/guild#get-guild-member
+    def resolve_member(token, server_id, user_id)
+      MijDiscord::Core::API.request(
+        :guilds_sid_members_uid,
+        server_id,
+        :get,
+        "#{MijDiscord::Core::API::APIBASE_URL}/guilds/#{server_id}/members/#{user_id}",
+        Authorization: token
+      )
+    end
+
+    # Gets members from the server
+    # https://discordapp.com/developers/docs/resources/guild#list-guild-members
+    def resolve_members(token, server_id, limit, after = nil)
+      MijDiscord::Core::API.request(
+        :guilds_sid_members,
+        server_id,
+        :get,
+        "#{MijDiscord::Core::API::APIBASE_URL}/guilds/#{server_id}/members?limit=#{limit}#{"&after=#{after}" if after}",
+        Authorization: token
+      )
+    end
+
+    # Update a user properties
+    # https://discordapp.com/developers/docs/resources/guild#modify-guild-member
+    def update_member(token, server_id, user_id, reason = nil, nick: nil, roles: nil, mute: nil, deaf: nil, channel_id: nil)
+      MijDiscord::Core::API.request(
+        :guilds_sid_members_uid,
+        server_id,
+        :patch,
+        "#{MijDiscord::Core::API::APIBASE_URL}/guilds/#{server_id}/members/#{user_id}",
+        { roles: roles, nick: nick, mute: mute, deaf: deaf, channel_id: channel_id }.delete_if {|_,v| v.nil? }.to_json,
+        Authorization: token,
+        content_type: :json,
+        'X-Audit-Log-Reason': reason
+      )
+    end
+
+    # Remove user from server
+    # https://discordapp.com/developers/docs/resources/guild#remove-guild-member
+    def remove_member(token, server_id, user_id, reason = nil)
+      MijDiscord::Core::API.request(
+        :guilds_sid_members_uid,
+        server_id,
+        :delete,
+        "#{MijDiscord::Core::API::APIBASE_URL}/guilds/#{server_id}/members/#{user_id}",
+        Authorization: token,
+        content_type: :json,
+        'X-Audit-Log-Reason': reason
+      )
+    end
+
+    # Get a server's banned users
+    # https://discordapp.com/developers/docs/resources/guild#get-guild-bans
+    def bans(token, server_id)
+      MijDiscord::Core::API.request(
+        :guilds_sid_bans,
+        server_id,
+        :get,
+        "#{MijDiscord::Core::API::APIBASE_URL}/guilds/#{server_id}/bans",
+        Authorization: token
+      )
+    end
+
+    # Ban a user from a server and delete their messages from the last message_days days
+    # https://discordapp.com/developers/docs/resources/guild#create-guild-ban
+    def ban_user(token, server_id, user_id, message_days, reason = nil)
+      MijDiscord::Core::API.request(
+        :guilds_sid_bans_uid,
+        server_id,
+        :put,
+        "#{MijDiscord::Core::API::APIBASE_URL}/guilds/#{server_id}/bans/#{user_id}?delete-message-days=#{message_days}",
+        nil,
+        Authorization: token,
+        'X-Audit-Log-Reason': reason
+      )
+    end
+
+    # Unban a user from a server
+    # https://discordapp.com/developers/docs/resources/guild#remove-guild-ban
+    def unban_user(token, server_id, user_id, reason = nil)
+      MijDiscord::Core::API.request(
+        :guilds_sid_bans_uid,
+        server_id,
+        :delete,
+        "#{MijDiscord::Core::API::APIBASE_URL}/guilds/#{server_id}/bans/#{user_id}",
+        Authorization: token,
+        'X-Audit-Log-Reason': reason
+      )
+    end
+
+    # Get server roles
+    # https://discordapp.com/developers/docs/resources/guild#get-guild-roles
+    def roles(token, server_id)
+      MijDiscord::Core::API.request(
+        :guilds_sid_roles,
+        server_id,
+        :get,
+        "#{MijDiscord::Core::API::APIBASE_URL}/guilds/#{server_id}/roles",
+        Authorization: token
+      )
+    end
+
+    # Create a role (parameters such as name and colour if not set can be set by update_role afterwards)
+    # Permissions are the Discord defaults; allowed: invite creation, reading/sending messages,
+    # sending TTS messages, embedding links, sending files, reading the history, mentioning everybody,
+    # connecting to voice, speaking and voice activity (push-to-talk isn't mandatory)
+    # https://discordapp.com/developers/docs/resources/guild#get-guild-roles
+    def create_role(token, server_id, name, color, hoist, mentionable, permissions, reason = nil)
+      MijDiscord::Core::API.request(
+        :guilds_sid_roles,
+        server_id,
+        :post,
+        "#{MijDiscord::Core::API::APIBASE_URL}/guilds/#{server_id}/roles",
+        { color: color, name: name, hoist: hoist, mentionable: mentionable, permissions: permissions }.to_json,
+        Authorization: token,
+        content_type: :json,
+        'X-Audit-Log-Reason': reason
+      )
+    end
+
+    # Update a role
+    # Permissions are the Discord defaults; allowed: invite creation, reading/sending messages,
+    # sending TTS messages, embedding links, sending files, reading the history, mentioning everybody,
+    # connecting to voice, speaking and voice activity (push-to-talk isn't mandatory)
+    # https://discordapp.com/developers/docs/resources/guild#modify-guild-role
+    def update_role(token, server_id, role_id, name, color, hoist, mentionable, permissions, reason = nil)
+      MijDiscord::Core::API.request(
+        :guilds_sid_roles_rid,
+        server_id,
+        :patch,
+        "#{MijDiscord::Core::API::APIBASE_URL}/guilds/#{server_id}/roles/#{role_id}",
+        {
+          color: color, name: name, hoist: hoist,
+          mentionable: mentionable, permissions: permissions
+        }.delete_if {|_, v| v.nil? }.to_json,
+        Authorization: token,
+        content_type: :json,
+        'X-Audit-Log-Reason': reason
+      )
+    end
+
+    # Delete a role
+    # https://discordapp.com/developers/docs/resources/guild#delete-guild-role
+    def delete_role(token, server_id, role_id, reason = nil)
+      MijDiscord::Core::API.request(
+        :guilds_sid_roles_rid,
+        server_id,
+        :delete,
+        "#{MijDiscord::Core::API::APIBASE_URL}/guilds/#{server_id}/roles/#{role_id}",
+        Authorization: token,
+        'X-Audit-Log-Reason': reason
+      )
+    end
+
+    # Adds a single role to a member
+    # https://discordapp.com/developers/docs/resources/guild#add-guild-member-role
+    def add_member_role(token, server_id, user_id, role_id, reason = nil)
+      MijDiscord::Core::API.request(
+        :guilds_sid_members_uid_roles_rid,
+        server_id,
+        :put,
+        "#{MijDiscord::Core::API::APIBASE_URL}/guilds/#{server_id}/members/#{user_id}/roles/#{role_id}",
+        nil,
+        Authorization: token,
+        'X-Audit-Log-Reason': reason
+      )
+    end
+
+    # Removes a single role from a member
+    # https://discordapp.com/developers/docs/resources/guild#remove-guild-member-role
+    def remove_member_role(token, server_id, user_id, role_id, reason = nil)
+      MijDiscord::Core::API.request(
+        :guilds_sid_members_uid_roles_rid,
+        server_id,
+        :delete,
+        "#{MijDiscord::Core::API::APIBASE_URL}/guilds/#{server_id}/members/#{user_id}/roles/#{role_id}",
+        Authorization: token,
+        'X-Audit-Log-Reason': reason
+      )
+    end
+
+    # Get server prune count
+    # https://discordapp.com/developers/docs/resources/guild#get-guild-prune-count
+    def prune_count(token, server_id, days)
+      MijDiscord::Core::API.request(
+        :guilds_sid_prune,
+        server_id,
+        :get,
+        "#{MijDiscord::Core::API::APIBASE_URL}/guilds/#{server_id}/prune?days=#{days}",
+        Authorization: token
+      )
+    end
+
+    # Begin server prune
+    # https://discordapp.com/developers/docs/resources/guild#begin-guild-prune
+    def begin_prune(token, server_id, days, reason = nil)
+      MijDiscord::Core::API.request(
+        :guilds_sid_prune,
+        server_id,
+        :post,
+        "#{MijDiscord::Core::API::APIBASE_URL}/guilds/#{server_id}/prune",
+        { days: days }.to_json,
+        Authorization: token,
+        'X-Audit-Log-Reason': reason
+      )
+    end
+
+    # Get invites from server
+    # https://discordapp.com/developers/docs/resources/guild#get-guild-invites
+    def invites(token, server_id)
+      MijDiscord::Core::API.request(
+        :guilds_sid_invites,
+        server_id,
+        :get,
+        "#{MijDiscord::Core::API::APIBASE_URL}/guilds/#{server_id}/invites",
+        Authorization: token
+      )
+    end
+
+    # Get server integrations
+    # https://discordapp.com/developers/docs/resources/guild#get-guild-integrations
+    def integrations(token, server_id)
+      MijDiscord::Core::API.request(
+        :guilds_sid_integrations,
+        server_id,
+        :get,
+        "#{MijDiscord::Core::API::APIBASE_URL}/guilds/#{server_id}/integrations",
+        Authorization: token
+      )
+    end
+
+    # Create a server integration
+    # https://discordapp.com/developers/docs/resources/guild#create-guild-integration
+    def create_integration(token, server_id, type, id)
+      MijDiscord::Core::API.request(
+        :guilds_sid_integrations,
+        server_id,
+        :post,
+        "#{MijDiscord::Core::API::APIBASE_URL}/guilds/#{server_id}/integrations",
+        { type: type, id: id }.to_json,
+        Authorization: token
+      )
+    end
+
+    # Update integration from server
+    # https://discordapp.com/developers/docs/resources/guild#modify-guild-integration
+    def update_integration(token, server_id, integration_id, expire_behavior, expire_grace_period, enable_emoticons)
+      MijDiscord::Core::API.request(
+        :guilds_sid_integrations_iid,
+        server_id,
+        :patch,
+        "#{MijDiscord::Core::API::APIBASE_URL}/guilds/#{server_id}/integrations/#{integration_id}",
+        { expire_behavior: expire_behavior, expire_grace_period: expire_grace_period, enable_emoticons: enable_emoticons }.to_json,
+        Authorization: token,
+        content_type: :json
+      )
+    end
+
+    # Delete a server integration
+    # https://discordapp.com/developers/docs/resources/guild#delete-guild-integration
+    def delete_integration(token, server_id, integration_id)
+      MijDiscord::Core::API.request(
+        :guilds_sid_integrations_iid,
+        server_id,
+        :delete,
+        "#{MijDiscord::Core::API::APIBASE_URL}/guilds/#{server_id}/integrations/#{integration_id}",
+        Authorization: token
+      )
+    end
+
+    # Sync an integration
+    # https://discordapp.com/developers/docs/resources/guild#sync-guild-integration
+    def sync_integration(token, server_id, integration_id)
+      MijDiscord::Core::API.request(
+        :guilds_sid_integrations_iid_sync,
+        server_id,
+        :post,
+        "#{MijDiscord::Core::API::APIBASE_URL}/guilds/#{server_id}/integrations/#{integration_id}/sync",
+        nil,
+        Authorization: token
+      )
+    end
+
+    # Adds a custom emoji
+    def add_emoji(token, server_id, image, name, reason = nil)
+      MijDiscord::Core::API.request(
+        :guilds_sid_emojis,
+        server_id,
+        :post,
+        "#{MijDiscord::Core::API::APIBASE_URL}/guilds/#{server_id}/emojis",
+        { image: image, name: name }.to_json,
+        Authorization: token,
+        content_type: :json,
+        'X-Audit-Log-Reason': reason
+      )
+    end
+
+    # Changes an emoji name
+    def edit_emoji(token, server_id, emoji_id, name, reason = nil)
+      MijDiscord::Core::API.request(
+        :guilds_sid_emojis_eid,
+        server_id,
+        :patch,
+        "#{MijDiscord::Core::API::APIBASE_URL}/guilds/#{server_id}/emojis/#{emoji_id}",
+        { name: name }.to_json,
+        Authorization: token,
+        content_type: :json,
+        'X-Audit-Log-Reason': reason
+      )
+    end
+
+    # Deletes a custom emoji
+    def delete_emoji(token, server_id, emoji_id, reason = nil)
+      MijDiscord::Core::API.request(
+        :guilds_sid_emojis_eid,
+        server_id,
+        :delete,
+        "#{MijDiscord::Core::API::APIBASE_URL}/guilds/#{server_id}/emojis/#{emoji_id}",
+        Authorization: token,
+        'X-Audit-Log-Reason': reason
+      )
+    end
+
+    # Available voice regions for this server
+    def regions(token, server_id)
+      MijDiscord::Core::API.request(
+        :guilds_sid_regions,
+        server_id,
+        :get,
+        "#{MijDiscord::Core::API::APIBASE_URL}/guilds/#{server_id}/regions",
+        Authorization: token
+      )
+    end
+
+    # Get server webhooks
+    # https://discordapp.com/developers/docs/resources/webhook#get-guild-webhooks
+    def webhooks(token, server_id)
+      MijDiscord::Core::API.request(
+        :guilds_sid_webhooks,
+        server_id,
+        :get,
+        "#{MijDiscord::Core::API::APIBASE_URL}/guilds/#{server_id}/webhooks",
+        Authorization: token
+      )
+    end
+  end
+end