onyxcord 2.0.13 → 3.2.0

data/lib/onyxcord/rest/routes/channel/threads.rb

@@ -0,0 +1,176 @@
+# frozen_string_literal: true
+
+module OnyxCord::REST::Channel
+  module_function
+
+  # Start a thread based off a channel message.
+  # https://discord.com/developers/docs/resources/channel#start-thread-with-message
+  def start_thread_with_message(token, channel_id, message_id, name, auto_archive_duration)
+    OnyxCord::REST.request(
+      :channels_cid_messages_mid_threads,
+      channel_id,
+      :post,
+      "#{OnyxCord::REST.api_base}/channels/#{channel_id}/messages/#{message_id}/threads",
+      { name: name, auto_archive_duration: auto_archive_duration }.to_json,
+      Authorization: token,
+      content_type: :json
+    )
+  end
+
+  # Start a thread without an associated message.
+  # https://discord.com/developers/docs/resources/channel#start-thread-without-message
+  def start_thread_without_message(token, channel_id, name, auto_archive_duration, type = 11)
+    OnyxCord::REST.request(
+      :channels_cid_threads,
+      channel_id,
+      :post,
+      "#{OnyxCord::REST.api_base}/channels/#{channel_id}/threads",
+      { name: name, auto_archive_duration: auto_archive_duration, type: type },
+      Authorization: token,
+      content_type: :json
+    )
+  end
+
+  # Add the current user to a thread.
+  # https://discord.com/developers/docs/resources/channel#join-thread
+  def join_thread(token, channel_id)
+    OnyxCord::REST.request(
+      :channels_cid_thread_members_me,
+      channel_id,
+      :put,
+      "#{OnyxCord::REST.api_base}/channels/#{channel_id}/thread-members/@me",
+      nil,
+      Authorization: token
+    )
+  end
+
+  # Add a user to a thread.
+  # https://discord.com/developers/docs/resources/channel#add-thread-member
+  def add_thread_member(token, channel_id, user_id)
+    OnyxCord::REST.request(
+      :channels_cid_thread_members_uid,
+      channel_id,
+      :put,
+      "#{OnyxCord::REST.api_base}/channels/#{channel_id}/thread-members/#{user_id}",
+      nil,
+      Authorization: token
+    )
+  end
+
+  # Remove the current user from a thread.
+  # https://discord.com/developers/docs/resources/channel#leave-thread
+  def leave_thread(token, channel_id)
+    OnyxCord::REST.request(
+      :channels_cid_thread_members_me,
+      channel_id,
+      :delete,
+      "#{OnyxCord::REST.api_base}/channels/#{channel_id}/thread-members/#{user_id}",
+      Authorization: token
+    )
+  end
+
+  # Remove a user from a thread.
+  # https://discord.com/developers/docs/resources/channel#remove-thread-member
+  def remove_thread_member(token, channel_id, user_id)
+    OnyxCord::REST.request(
+      :channels_cid_thread_members_uid,
+      channel_id,
+      :delete,
+      "#{OnyxCord::REST.api_base}/channels/#{channel_id}/thread-members/#{user_id}",
+      Authorization: token
+    )
+  end
+
+  # Get the members of a thread.
+  # https://discord.com/developers/docs/resources/channel#list-thread-members
+  def list_thread_members(token, channel_id, before, limit)
+    query = URI.encode_www_form({ before: before, limit: limit }.compact)
+
+    OnyxCord::REST.request(
+      :channels_cid_thread_members,
+      channel_id,
+      :get,
+      "#{OnyxCord::REST.api_base}/channels/#{channel_id}/thread-members?#{query}",
+      Authorization: token
+    )
+  end
+
+  # List active threads
+  # https://discord.com/developers/docs/resources/channel#list-active-threads
+  def list_active_threads(token, channel_id)
+    OnyxCord::REST.request(
+      :channels_cid_threads_active,
+      channel_id,
+      :get,
+      "#{OnyxCord::REST.api_base}/channels/#{channel_id}/threads/active",
+      Authorization: token
+    )
+  end
+
+  # List public archived threads.
+  # https://discord.com/developers/docs/resources/channel#list-public-archived-threads
+  def list_public_archived_threads(token, channel_id, before = nil, limit = nil)
+    query = URI.encode_www_form({ before: before, limit: limit }.compact)
+
+    OnyxCord::REST.request(
+      :channels_cid_threads_archived_public,
+      channel_id,
+      :get,
+      "#{OnyxCord::REST.api_base}/channels/#{channel_id}/threads/archived/public?#{query}",
+      Authorization: token
+    )
+  end
+
+  # List private archived threads.
+  # https://discord.com/developers/docs/resources/channel#list-private-archived-threads
+  def list_private_archived_threads(token, channel_id, before = nil, limit = nil)
+    query = URI.encode_www_form({ before: before, limit: limit }.compact)
+
+    OnyxCord::REST.request(
+      :channels_cid_threads_archived_private,
+      channel_id,
+      :get,
+      "#{OnyxCord::REST.api_base}/channels/#{channel_id}/threads/archived/private?#{query}",
+      Authorization: token
+    )
+  end
+
+  # List joined private archived threads.
+  # https://discord.com/developers/docs/resources/channel#list-joined-private-archived-threads
+  def list_joined_private_archived_threads(token, channel_id, before = nil, limit = nil)
+    query = URI.encode_www_form({ before: before, limit: limit }.compact)
+
+    OnyxCord::REST.request(
+      :channels_cid_users_me_threads_archived_private,
+      channel_id,
+      :get,
+      "#{OnyxCord::REST.api_base}/channels/#{channel_id}/users/@me/threads/archived/private?#{query}",
+      Authorization: token
+    )
+  end
+
+  # Start a thread in a forum or media channel.
+  # https://discord.com/developers/docs/resources/channel#start-thread-in-forum-or-media-channel
+  def start_thread_in_forum_or_media_channel(token, channel_id, name, message, attachments = nil, rate_limit_per_user = nil, auto_archive_duration = nil, applied_tags = nil, reason = nil)
+    OnyxCord::MessagePayload.validate!(attachments: attachments)
+    body = { name: name, message: message, rate_limit_per_user: rate_limit_per_user, auto_archive_duration: auto_archive_duration, applied_tags: applied_tags }.compact
+
+    body = if attachments
+             multipart_body(body, attachments)
+           else
+             body.to_json
+           end
+
+    headers = { Authorization: token, 'X-Audit-Log-Reason': reason }
+    headers[:content_type] = :json unless attachments
+
+    OnyxCord::REST.request(
+      :channels_cid_threads,
+      channel_id,
+      :post,
+      "#{OnyxCord::REST.api_base}/channels/#{channel_id}/threads",
+      body,
+      headers
+    )
+  end
+end

data/lib/onyxcord/rest/routes/channel/webhooks.rb

@@ -0,0 +1,47 @@
+# frozen_string_literal: true
+
+module OnyxCord::REST::Channel
+  module_function
+
+  # Create a webhook
+  # https://discord.com/developers/docs/resources/webhook#create-webhook
+  def create_webhook(token, channel_id, name, avatar = nil, reason = nil)
+    OnyxCord::REST.request(
+      :channels_cid_webhooks,
+      channel_id,
+      :post,
+      "#{OnyxCord::REST.api_base}/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://discord.com/developers/docs/resources/webhook#get-channel-webhooks
+  def webhooks(token, channel_id)
+    OnyxCord::REST.request(
+      :channels_cid_webhooks,
+      channel_id,
+      :get,
+      "#{OnyxCord::REST.api_base}/channels/#{channel_id}/webhooks",
+      Authorization: token
+    )
+  end
+
+  # Follow an annoucement channel.
+  # https://discord.com/developers/docs/resources/channel#follow-announcement-channel
+  def follow_channel(token, channel_id, webhook_channel_id, reason = nil)
+    OnyxCord::REST.request(
+      :channels_cid_followers,
+      channel_id,
+      :post,
+      "#{OnyxCord::REST.api_base}/channels/#{channel_id}/followers",
+      { webhook_channel_id: webhook_channel_id }.to_json,
+      Authorization: token,
+      content_type: :json,
+      'X-Audit-Log-Reason': reason
+    )
+  end
+end

data/lib/onyxcord/rest/routes/channel.rb

@@ -0,0 +1,12 @@
+# frozen_string_literal: true
+
+require 'onyxcord/internal/message_payload'
+require 'onyxcord/rest/routes/channel/base'
+require 'onyxcord/rest/routes/channel/messages'
+require 'onyxcord/rest/routes/channel/reactions'
+require 'onyxcord/rest/routes/channel/permissions'
+require 'onyxcord/rest/routes/channel/pins'
+require 'onyxcord/rest/routes/channel/groups'
+require 'onyxcord/rest/routes/channel/webhooks'
+require 'onyxcord/rest/routes/channel/threads'
+require 'onyxcord/rest/routes/channel/polls'

data/lib/onyxcord/{api/interaction.rb → rest/routes/interaction/base.rb}

@@ -1,26 +1,20 @@
 # frozen_string_literal: true
 
-require 'onyxcord/message_components'
+require 'onyxcord/internal/message_payload'
 
-# API calls for interactions.
-module OnyxCord::API::Interaction
+# API calls for interactions — base response methods.
+module OnyxCord::REST::Interaction
   module_function
 
   # Build attachment metadata payload for multipart uploads.
   # Returns an array of { id:, filename: } hashes.
   def attachment_payload(attachments)
-    Array(attachments).map.with_index do |attachment, index|
-      { id: index, filename: File.basename(attachment.path) }
-    end
+    OnyxCord::MessagePayload.attachment_payload(attachments)
   end
 
   # Build multipart body with named file fields and JSON payload.
   def multipart_body(body, attachments)
-    files = Array(attachments).map.with_index.to_h do |attachment, index|
-      ["files[#{index}]", attachment]
-    end
-
-    { **files, payload_json: body.to_json }
+    OnyxCord::MessagePayload.multipart_body(body, attachments)
   end
 
   # Respond to an interaction.
@@ -28,6 +22,7 @@ module OnyxCord::API::Interaction
   def create_interaction_response(interaction_token, interaction_id, type, content = nil, tts = nil, embeds = nil, allowed_mentions = nil, flags = nil, components = nil, attachments = nil, choices = nil, with_response = nil, poll = nil)
     components = OnyxCord::MessageComponents.payload(components) unless components.nil?
     flags = OnyxCord::MessageComponents.apply_v2_flag(flags, components)
+    OnyxCord::MessagePayload.validate!(content: content, embeds: embeds, components: components, flags: flags, attachments: attachments, poll: poll)
     data = { tts: tts, content: content, embeds: embeds, allowed_mentions: allowed_mentions, flags: flags, components: components, attachments: attachments ? attachment_payload(attachments) : nil, choices: choices, poll: poll }.compact
 
     body = if attachments
@@ -38,11 +33,11 @@ module OnyxCord::API::Interaction
 
     headers = { content_type: :json } unless attachments
 
-    OnyxCord::API.request(
+    OnyxCord::REST.request(
       :interactions_iid_token_callback,
       interaction_id,
       :post,
-      "#{OnyxCord::API.api_base}/interactions/#{interaction_id}/#{interaction_token}/callback?with_response=#{with_response ? 'true' : 'false'}",
+      "#{OnyxCord::REST.api_base}/interactions/#{interaction_id}/#{interaction_token}/callback?with_response=#{with_response ? 'true' : 'false'}",
       body,
       headers
     )
@@ -53,31 +48,13 @@ module OnyxCord::API::Interaction
   def create_interaction_modal_response(interaction_token, interaction_id, custom_id, title, components)
     data = { custom_id: custom_id, title: title, components: components.to_a }.compact
 
-    OnyxCord::API.request(
+    OnyxCord::REST.request(
       :interactions_iid_token_callback,
       interaction_id,
       :post,
-      "#{OnyxCord::API.api_base}/interactions/#{interaction_id}/#{interaction_token}/callback",
+      "#{OnyxCord::REST.api_base}/interactions/#{interaction_id}/#{interaction_token}/callback",
       { type: 9, data: data }.to_json,
       content_type: :json
     )
   end
-
-  # Get the original response to an interaction.
-  # https://discord.com/developers/docs/interactions/slash-commands#get-original-interaction-response
-  def get_original_interaction_response(interaction_token, application_id)
-    OnyxCord::API::Webhook.token_get_message(interaction_token, application_id, '@original')
-  end
-
-  # Edit the original response to an interaction.
-  # https://discord.com/developers/docs/interactions/slash-commands#edit-original-interaction-response
-  def edit_original_interaction_response(interaction_token, application_id, content = nil, embeds = nil, allowed_mentions = nil, components = nil, attachments = nil, flags = nil, poll = nil)
-    OnyxCord::API::Webhook.token_edit_message(interaction_token, application_id, '@original', content, embeds, allowed_mentions, components, attachments, flags, poll)
-  end
-
-  # Delete the original response to an interaction.
-  # https://discord.com/developers/docs/interactions/slash-commands#delete-original-interaction-response
-  def delete_original_interaction_response(interaction_token, application_id)
-    OnyxCord::API::Webhook.token_delete_message(interaction_token, application_id, '@original')
-  end
 end

data/lib/onyxcord/rest/routes/interaction/response.rb

@@ -0,0 +1,24 @@
+# frozen_string_literal: true
+
+# API calls for interactions — response management.
+module OnyxCord::REST::Interaction
+  module_function
+
+  # Get the original response to an interaction.
+  # https://discord.com/developers/docs/interactions/slash-commands#get-original-interaction-response
+  def get_original_interaction_response(interaction_token, application_id)
+    OnyxCord::REST::Webhook.token_get_message(interaction_token, application_id, '@original')
+  end
+
+  # Edit the original response to an interaction.
+  # https://discord.com/developers/docs/interactions/slash-commands#edit-original-interaction-response
+  def edit_original_interaction_response(interaction_token, application_id, content = nil, embeds = nil, allowed_mentions = nil, components = nil, attachments = nil, flags = nil, poll = nil)
+    OnyxCord::REST::Webhook.token_edit_message(interaction_token, application_id, '@original', content, embeds, allowed_mentions, components, attachments, flags, poll)
+  end
+
+  # Delete the original response to an interaction.
+  # https://discord.com/developers/docs/interactions/slash-commands#delete-original-interaction-response
+  def delete_original_interaction_response(interaction_token, application_id)
+    OnyxCord::REST::Webhook.token_delete_message(interaction_token, application_id, '@original')
+  end
+end

data/lib/onyxcord/rest/routes/interaction.rb

@@ -0,0 +1,4 @@
+# frozen_string_literal: true
+
+require 'onyxcord/rest/routes/interaction/base'
+require 'onyxcord/rest/routes/interaction/response'

data/lib/onyxcord/{api → rest/routes}/invite.rb

@@ -1,17 +1,17 @@
 # frozen_string_literal: true
 
 # API calls for Invite object
-module OnyxCord::API::Invite
+module OnyxCord::REST::Invite
   module_function
 
   # Resolve an invite
   # https://discord.com/developers/docs/resources/invite#get-invite
   def resolve(token, invite_code, counts = true)
-    OnyxCord::API.request(
+    OnyxCord::REST.request(
       :invite_code,
       nil,
       :get,
-      "#{OnyxCord::API.api_base}/invites/#{invite_code}#{'?with_counts=true' if counts}",
+      "#{OnyxCord::REST.api_base}/invites/#{invite_code}#{'?with_counts=true' if counts}",
       Authorization: token
     )
   end
@@ -19,11 +19,11 @@ module OnyxCord::API::Invite
   # Delete an invite by code
   # https://discord.com/developers/docs/resources/invite#delete-invite
   def delete(token, code, reason = nil)
-    OnyxCord::API.request(
+    OnyxCord::REST.request(
       :invites_code,
       nil,
       :delete,
-      "#{OnyxCord::API.api_base}/invites/#{code}",
+      "#{OnyxCord::REST.api_base}/invites/#{code}",
       Authorization: token,
       'X-Audit-Log-Reason': reason
     )
@@ -32,11 +32,11 @@ module OnyxCord::API::Invite
   # Join a server using an invite
   # https://discord.com/developers/docs/resources/invite#accept-invite
   def accept(token, invite_code)
-    OnyxCord::API.request(
+    OnyxCord::REST.request(
       :invite_code,
       nil,
       :post,
-      "#{OnyxCord::API.api_base}/invites/#{invite_code}",
+      "#{OnyxCord::REST.api_base}/invites/#{invite_code}",
       nil,
       Authorization: token
     )

data/lib/onyxcord/rest/routes/server/admin.rb

@@ -0,0 +1,174 @@
+# frozen_string_literal: true
+
+module OnyxCord::REST::Server
+  module_function
+
+  # Get server prune count
+  # https://discord.com/developers/docs/resources/guild#get-guild-prune-count
+  def prune_count(token, server_id, days)
+    OnyxCord::REST.request(
+      :guilds_sid_prune,
+      server_id,
+      :get,
+      "#{OnyxCord::REST.api_base}/guilds/#{server_id}/prune?days=#{days}",
+      Authorization: token
+    )
+  end
+
+  # Begin server prune
+  # https://discord.com/developers/docs/resources/guild#begin-guild-prune
+  def begin_prune(token, server_id, days, reason = nil)
+    OnyxCord::REST.request(
+      :guilds_sid_prune,
+      server_id,
+      :post,
+      "#{OnyxCord::REST.api_base}/guilds/#{server_id}/prune",
+      { days: days },
+      Authorization: token,
+      'X-Audit-Log-Reason': reason
+    )
+  end
+
+  # Get invites from server
+  # https://discord.com/developers/docs/resources/guild#get-guild-invites
+  def invites(token, server_id)
+    OnyxCord::REST.request(
+      :guilds_sid_invites,
+      server_id,
+      :get,
+      "#{OnyxCord::REST.api_base}/guilds/#{server_id}/invites",
+      Authorization: token
+    )
+  end
+
+  # Gets a server's audit logs
+  # https://discord.com/developers/docs/resources/audit-log#get-guild-audit-log
+  def audit_logs(token, server_id, limit, user_id = nil, action_type = nil, before = nil)
+    OnyxCord::REST.request(
+      :guilds_sid_auditlogs,
+      server_id,
+      :get,
+      "#{OnyxCord::REST.api_base}/guilds/#{server_id}/audit-logs?limit=#{limit}#{"&user_id=#{user_id}" if user_id}#{"&action_type=#{action_type}" if action_type}#{"&before=#{before}" if before}",
+      Authorization: token
+    )
+  end
+
+  # Get server integrations
+  # https://discord.com/developers/docs/resources/guild#get-guild-integrations
+  def integrations(token, server_id)
+    OnyxCord::REST.request(
+      :guilds_sid_integrations,
+      server_id,
+      :get,
+      "#{OnyxCord::REST.api_base}/guilds/#{server_id}/integrations",
+      Authorization: token
+    )
+  end
+
+  # Create a server integration
+  # https://discord.com/developers/docs/resources/guild#create-guild-integration
+  def create_integration(token, server_id, type, id, reason = nil)
+    OnyxCord::REST.request(
+      :guilds_sid_integrations,
+      server_id,
+      :post,
+      "#{OnyxCord::REST.api_base}/guilds/#{server_id}/integrations",
+      { type: type, id: id },
+      Authorization: token,
+      'X-Audit-Log-Reason': reason
+    )
+  end
+
+  # Update integration from server
+  # https://discord.com/developers/docs/resources/guild#modify-guild-integration
+  def update_integration(token, server_id, integration_id, expire_behavior, expire_grace_period, enable_emoticons)
+    OnyxCord::REST.request(
+      :guilds_sid_integrations_iid,
+      server_id,
+      :patch,
+      "#{OnyxCord::REST.api_base}/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://discord.com/developers/docs/resources/guild#delete-guild-integration
+  def delete_integration(token, server_id, integration_id, reason = nil)
+    OnyxCord::REST.request(
+      :guilds_sid_integrations_iid,
+      server_id,
+      :delete,
+      "#{OnyxCord::REST.api_base}/guilds/#{server_id}/integrations/#{integration_id}",
+      Authorization: token,
+      'X-Audit-Log-Reason': reason
+    )
+  end
+
+  # Sync an integration
+  # https://discord.com/developers/docs/resources/guild#sync-guild-integration
+  def sync_integration(token, server_id, integration_id)
+    OnyxCord::REST.request(
+      :guilds_sid_integrations_iid_sync,
+      server_id,
+      :post,
+      "#{OnyxCord::REST.api_base}/guilds/#{server_id}/integrations/#{integration_id}/sync",
+      nil,
+      Authorization: token
+    )
+  end
+
+  # Retrieves a server's widget information
+  # https://discord.com/developers/docs/resources/guild#get-guild-widget
+  def widget(token, server_id)
+    OnyxCord::REST.request(
+      :guilds_sid_embed,
+      server_id,
+      :get,
+      "#{OnyxCord::REST.api_base}/guilds/#{server_id}/widget",
+      Authorization: token
+    )
+  end
+  alias embed widget
+
+  # Modify a server's widget settings
+  # https://discord.com/developers/docs/resources/guild#modify-guild-widget
+  def modify_widget(token, server_id, enabled, channel_id, reason = nil)
+    OnyxCord::REST.request(
+      :guilds_sid_embed,
+      server_id,
+      :patch,
+      "#{OnyxCord::REST.api_base}/guilds/#{server_id}/widget",
+      { enabled: enabled, channel_id: channel_id }.to_json,
+      Authorization: token,
+      'X-Audit-Log-Reason': reason,
+      content_type: :json
+    )
+  end
+  alias modify_embed modify_widget
+
+  # Available voice regions for this server
+  # https://discord.com/developers/docs/resources/guild#get-guild-voice-regions
+  def regions(token, server_id)
+    OnyxCord::REST.request(
+      :guilds_sid_regions,
+      server_id,
+      :get,
+      "#{OnyxCord::REST.api_base}/guilds/#{server_id}/regions",
+      Authorization: token
+    )
+  end
+
+  # Get server webhooks
+  # https://discord.com/developers/docs/resources/webhook#get-guild-webhooks
+  def webhooks(token, server_id)
+    OnyxCord::REST.request(
+      :guilds_sid_webhooks,
+      server_id,
+      :get,
+      "#{OnyxCord::REST.api_base}/guilds/#{server_id}/webhooks",
+      Authorization: token
+    )
+  end
+end

data/lib/onyxcord/rest/routes/server/assets.rb

@@ -0,0 +1,25 @@
+# frozen_string_literal: true
+
+module OnyxCord::REST::Server
+  module_function
+
+  # Make an member avatar URL from the server, user and avatar IDs
+  def avatar_url(server_id, user_id, avatar_id, format = nil)
+    format ||= if avatar_id.start_with?('a_')
+                 'gif'
+               else
+                 'webp'
+               end
+    "#{OnyxCord::REST.cdn_url}/guilds/#{server_id}/users/#{user_id}/avatars/#{avatar_id}.#{format}"
+  end
+
+  # Make a banner URL from the server, user and banner IDs
+  def banner_url(server_id, user_id, banner_id, format = nil)
+    format ||= if banner_id.start_with?('a_')
+                 'gif'
+               else
+                 'webp'
+               end
+    "#{OnyxCord::REST.cdn_url}/guilds/#{server_id}/users/#{user_id}/banners/#{banner_id}.#{format}"
+  end
+end

data/lib/onyxcord/rest/routes/server/bans.rb

@@ -0,0 +1,67 @@
+# frozen_string_literal: true
+
+module OnyxCord::REST::Server
+  module_function
+
+  # Get a server's banned users
+  # https://discord.com/developers/docs/resources/guild#get-guild-bans
+  def bans(token, server_id, limit = nil, before = nil, after = nil)
+    query_string = URI.encode_www_form({ limit: limit, before: before, after: after }.compact)
+    OnyxCord::REST.request(
+      :guilds_sid_bans,
+      server_id,
+      :get,
+      "#{OnyxCord::REST.api_base}/guilds/#{server_id}/bans?#{query_string}",
+      Authorization: token
+    )
+  end
+
+  # @deprecated Please use {ban_user!} instead.
+  # https://discord.com/developers/docs/resources/guild#create-guild-ban
+  def ban_user(token, server_id, user_id, message_days, reason = nil)
+    ban_user!(token, server_id, user_id, message_days * 86_400, reason)
+  end
+
+  # Ban a user from a server and delete their messages up to a given amount of time.
+  # https://discord.com/developers/docs/resources/guild#create-guild-ban
+  def ban_user!(token, server_id, user_id, message_seconds, reason = nil)
+    OnyxCord::REST.request(
+      :guilds_sid_bans_uid,
+      server_id,
+      :put,
+      "#{OnyxCord::REST.api_base}/guilds/#{server_id}/bans/#{user_id}",
+      { delete_message_seconds: message_seconds }.to_json,
+      Authorization: token,
+      content_type: :json,
+      'X-Audit-Log-Reason': reason
+    )
+  end
+
+  # Unban a user from a server
+  # https://discord.com/developers/docs/resources/guild#remove-guild-ban
+  def unban_user(token, server_id, user_id, reason = nil)
+    OnyxCord::REST.request(
+      :guilds_sid_bans_uid,
+      server_id,
+      :delete,
+      "#{OnyxCord::REST.api_base}/guilds/#{server_id}/bans/#{user_id}",
+      Authorization: token,
+      'X-Audit-Log-Reason': reason
+    )
+  end
+
+  # Ban multiple users in one go
+  # https://discord.com/developers/docs/resources/guild#bulk-guild-ban
+  def bulk_ban(token, server_id, users, message_seconds, reason = nil)
+    OnyxCord::REST.request(
+      :guilds_sid_bulk_bans,
+      server_id,
+      :post,
+      "#{OnyxCord::REST.api_base}/guilds/#{server_id}/bulk-ban",
+      { user_ids: users, delete_message_seconds: message_seconds }.compact.to_json,
+      content_type: :json,
+      Authorization: token,
+      'X-Audit-Log-Reason': reason
+    )
+  end
+end