onyxcord 1.1.0

data/lib/onyxcord/api/channel.rb

@@ -0,0 +1,700 @@
+# frozen_string_literal: true
+
+require 'onyxcord/message_components'
+
+# API calls for Channel
+module OnyxCord::API::Channel
+  module_function
+
+  # Get a channel's data
+  # https://discord.com/developers/docs/resources/channel#get-channel
+  def resolve(token, channel_id)
+    OnyxCord::API.request(
+      :channels_cid,
+      channel_id,
+      :get,
+      "#{OnyxCord::API.api_base}/channels/#{channel_id}",
+      Authorization: token
+    )
+  end
+
+  # Update a channel's data
+  # https://discord.com/developers/docs/resources/channel#modify-channel
+  def update(token, channel_id, name, topic, position, bitrate, user_limit, nsfw, permission_overwrites = nil, parent_id = nil, rate_limit_per_user = nil, reason = nil, archived = nil, auto_archive_duration = nil, locked = nil, invitable = nil, flags = nil, applied_tags = nil)
+    data = { name: name, position: position, topic: topic, bitrate: bitrate, user_limit: user_limit, nsfw: nsfw, parent_id: parent_id, rate_limit_per_user: rate_limit_per_user, archived: archived, auto_archive_duration: auto_archive_duration, locked: locked, invitable: invitable, flags: flags, applied_tags: applied_tags }
+    data[:permission_overwrites] = permission_overwrites unless permission_overwrites.nil?
+    OnyxCord::API.request(
+      :channels_cid,
+      channel_id,
+      :patch,
+      "#{OnyxCord::API.api_base}/channels/#{channel_id}",
+      data.to_json,
+      Authorization: token,
+      content_type: :json,
+      'X-Audit-Log-Reason': reason
+    )
+  end
+
+  # Modify the properties of a channel.
+  # https://discord.com/developers/docs/resources/channel#modify-channel
+  def update!(token, channel_id, name: :undef, type: :undef, position: :undef, topic: :undef, nsfw: :undef, rate_limit_per_user: :undef, bitrate: :undef, user_limit: :undef, permission_overwrites: :undef, parent_id: :undef, rtc_region: :undef, video_quality_mode: :undef, default_auto_archive_duration: :undef, flags: :undef, available_tags: :undef, default_reaction_emoji: :undef, default_thread_rate_limit_per_user: :undef, default_sort_order: :undef, default_forum_layout: :undef, archived: :undef, auto_archive_duration: :undef, locked: :undef, invitable: :undef, applied_tags: :undef, reason: nil)
+    OnyxCord::API.request(
+      :channels_cid,
+      channel_id,
+      :patch,
+      "#{OnyxCord::API.api_base}/channels/#{channel_id}",
+      { name:, type:, position:, topic:, nsfw:, rate_limit_per_user:, bitrate:, user_limit:, permission_overwrites:, parent_id:, rtc_region:, video_quality_mode:, default_auto_archive_duration:, flags:, available_tags:, default_reaction_emoji:, default_thread_rate_limit_per_user:, default_sort_order:, default_forum_layout:, archived:, auto_archive_duration:, locked:, invitable:, applied_tags: }.reject { |_, value| value == :undef }.to_json,
+      Authorization: token,
+      content_type: :json,
+      'X-Audit-Log-Reason': reason
+    )
+  end
+
+  # Delete a channel
+  # https://discord.com/developers/docs/resources/channel#deleteclose-channel
+  def delete(token, channel_id, reason = nil)
+    OnyxCord::API.request(
+      :channels_cid,
+      channel_id,
+      :delete,
+      "#{OnyxCord::API.api_base}/channels/#{channel_id}",
+      Authorization: token,
+      'X-Audit-Log-Reason': reason
+    )
+  end
+
+  # Get a list of messages from a channel's history
+  # https://discord.com/developers/docs/resources/channel#get-channel-messages
+  def messages(token, channel_id, amount, before = nil, after = nil, around = nil)
+    query_string = URI.encode_www_form({ limit: amount, before: before, after: after, around: around }.compact)
+    OnyxCord::API.request(
+      :channels_cid_messages,
+      channel_id,
+      :get,
+      "#{OnyxCord::API.api_base}/channels/#{channel_id}/messages?#{query_string}",
+      Authorization: token
+    )
+  end
+
+  # Get a single message from a channel's history by id
+  # https://discord.com/developers/docs/resources/channel#get-channel-message
+  def message(token, channel_id, message_id)
+    OnyxCord::API.request(
+      :channels_cid_messages_mid,
+      channel_id,
+      :get,
+      "#{OnyxCord::API.api_base}/channels/#{channel_id}/messages/#{message_id}",
+      Authorization: token
+    )
+  end
+
+  # Send a message to a channel
+  # https://discord.com/developers/docs/resources/channel#create-message
+  # @param attachments [Array<File>, nil] Attachments to use with `attachment://` in embeds. See
+  #   https://discord.com/developers/docs/resources/channel#create-message-using-attachments-within-embeds
+  def create_message(token, channel_id, message, tts = false, embeds = nil, nonce = nil, attachments = nil, allowed_mentions = nil, message_reference = nil, components = nil, flags = nil, enforce_nonce = false, poll = nil)
+    components = OnyxCord::MessageComponents.payload(components) unless components.nil?
+    flags = OnyxCord::MessageComponents.apply_v2_flag(flags, components)
+    body = { content: message, tts: tts, embeds: embeds, nonce: nonce, allowed_mentions: allowed_mentions, message_reference: message_reference, components: components, flags: flags, enforce_nonce: enforce_nonce, poll: poll }
+    body = if attachments
+             files = [*0...attachments.size].zip(attachments).to_h
+             { **files, payload_json: body.to_json }
+           else
+             body.to_json
+           end
+
+    headers = { Authorization: token }
+    headers[:content_type] = :json unless attachments
+
+    OnyxCord::API.request(
+      :channels_cid_messages_mid,
+      channel_id,
+      :post,
+      "#{OnyxCord::API.api_base}/channels/#{channel_id}/messages",
+      body,
+      **headers
+    )
+  rescue RestClient::BadRequest => e
+    parsed = JSON.parse(e.response.body)
+    raise OnyxCord::Errors::MessageTooLong, "Message over the character limit (#{message.length} > 2000)" if parsed['content'].is_a?(Array) && parsed['content'].first == 'Must be 2000 or fewer in length.'
+
+    raise
+  end
+
+  # Send a file as a message to a channel
+  # https://discord.com/developers/docs/resources/channel#upload-file
+  def upload_file(token, channel_id, file, caption: nil, tts: false)
+    OnyxCord::API.request(
+      :channels_cid_messages_mid,
+      channel_id,
+      :post,
+      "#{OnyxCord::API.api_base}/channels/#{channel_id}/messages",
+      { file: file, content: caption, tts: tts },
+      Authorization: token
+    )
+  end
+
+  # Edit a message
+  # https://discord.com/developers/docs/resources/channel#edit-message
+  def edit_message(token, channel_id, message_id, message, mentions = nil, embeds = nil, components = nil, flags = nil)
+    components = OnyxCord::MessageComponents.payload(components) unless components.nil? || components == :undef
+    flags = OnyxCord::MessageComponents.apply_v2_flag(flags, components)
+    OnyxCord::API.request(
+      :channels_cid_messages_mid,
+      channel_id,
+      :patch,
+      "#{OnyxCord::API.api_base}/channels/#{channel_id}/messages/#{message_id}",
+      { content: message, allowed_mentions: mentions, embeds: embeds, components: components, flags: flags }.reject { |_, v| v == :undef }.to_json,
+      Authorization: token,
+      content_type: :json
+    )
+  end
+
+  # Delete a message
+  # https://discord.com/developers/docs/resources/channel#delete-message
+  def delete_message(token, channel_id, message_id, reason = nil)
+    OnyxCord::API.request(
+      :channels_cid_messages_mid,
+      channel_id,
+      :delete,
+      "#{OnyxCord::API.api_base}/channels/#{channel_id}/messages/#{message_id}",
+      Authorization: token,
+      'X-Audit-Log-Reason': reason
+    )
+  end
+
+  # Crosspost a message
+  # https://discord.com/developers/docs/resources/message#crosspost-message
+  def crosspost_message(token, channel_id, message_id)
+    OnyxCord::API.request(
+      :channels_cid_messages_mid,
+      channel_id,
+      :post,
+      "#{OnyxCord::API.api_base}/channels/#{channel_id}/messages/#{message_id}/crosspost",
+      Authorization: token
+    )
+  end
+
+  # Delete messages in bulk
+  # https://discord.com/developers/docs/resources/channel#bulk-delete-messages
+  def bulk_delete_messages(token, channel_id, messages = [], reason = nil)
+    OnyxCord::API.request(
+      :channels_cid_messages_bulk_delete,
+      channel_id,
+      :post,
+      "#{OnyxCord::API.api_base}/channels/#{channel_id}/messages/bulk-delete",
+      { messages: messages }.to_json,
+      Authorization: token,
+      content_type: :json,
+      'X-Audit-Log-Reason': reason
+    )
+  end
+
+  # Create a reaction on a message using this client
+  # https://discord.com/developers/docs/resources/channel#create-reaction
+  def create_reaction(token, channel_id, message_id, emoji)
+    emoji = URI.encode_www_form_component(emoji) unless emoji.ascii_only?
+    OnyxCord::API.request(
+      :channels_cid_messages_mid_reactions_emoji_me,
+      channel_id,
+      :put,
+      "#{OnyxCord::API.api_base}/channels/#{channel_id}/messages/#{message_id}/reactions/#{emoji}/@me",
+      nil,
+      Authorization: token,
+      content_type: :json
+    )
+  end
+
+  # Delete this client's own reaction on a message
+  # https://discord.com/developers/docs/resources/channel#delete-own-reaction
+  def delete_own_reaction(token, channel_id, message_id, emoji)
+    emoji = URI.encode_www_form_component(emoji) unless emoji.ascii_only?
+    OnyxCord::API.request(
+      :channels_cid_messages_mid_reactions_emoji_me,
+      channel_id,
+      :delete,
+      "#{OnyxCord::API.api_base}/channels/#{channel_id}/messages/#{message_id}/reactions/#{emoji}/@me",
+      Authorization: token
+    )
+  end
+
+  # Delete another client's reaction on a message
+  # https://discord.com/developers/docs/resources/channel#delete-user-reaction
+  def delete_user_reaction(token, channel_id, message_id, emoji, user_id)
+    emoji = URI.encode_www_form_component(emoji) unless emoji.ascii_only?
+    OnyxCord::API.request(
+      :channels_cid_messages_mid_reactions_emoji_uid,
+      channel_id,
+      :delete,
+      "#{OnyxCord::API.api_base}/channels/#{channel_id}/messages/#{message_id}/reactions/#{emoji}/#{user_id}",
+      Authorization: token
+    )
+  end
+
+  # Get a list of clients who reacted with a specific reaction on a message
+  # https://discord.com/developers/docs/resources/channel#get-reactions
+  def get_reactions(token, channel_id, message_id, emoji, before_id, after_id, limit = 100, type = 0)
+    emoji = URI.encode_www_form_component(emoji) unless emoji.ascii_only?
+    query_string = URI.encode_www_form({ limit: limit || 100, before: before_id, after: after_id, type: type }.compact)
+    OnyxCord::API.request(
+      :channels_cid_messages_mid_reactions_emoji,
+      channel_id,
+      :get,
+      "#{OnyxCord::API.api_base}/channels/#{channel_id}/messages/#{message_id}/reactions/#{emoji}?#{query_string}",
+      Authorization: token
+    )
+  end
+
+  # Deletes all reactions on a message from all clients
+  # https://discord.com/developers/docs/resources/channel#delete-all-reactions
+  def delete_all_reactions(token, channel_id, message_id)
+    OnyxCord::API.request(
+      :channels_cid_messages_mid_reactions,
+      channel_id,
+      :delete,
+      "#{OnyxCord::API.api_base}/channels/#{channel_id}/messages/#{message_id}/reactions",
+      Authorization: token
+    )
+  end
+
+  # Deletes all the reactions for a given emoji on a message
+  # https://discord.com/developers/docs/resources/channel#delete-all-reactions-for-emoji
+  def delete_all_emoji_reactions(token, channel_id, message_id, emoji)
+    emoji = URI.encode_www_form_component(emoji) unless emoji.ascii_only?
+
+    OnyxCord::API.request(
+      :channels_cid_messages_mid_reactions_emoji,
+      channel_id,
+      :delete,
+      "#{OnyxCord::API.api_base}/channels/#{channel_id}/messages/#{message_id}/reactions/#{emoji}",
+      Authorization: token
+    )
+  end
+
+  # Update a channels permission for a role or member
+  # https://discord.com/developers/docs/resources/channel#edit-channel-permissions
+  def update_permission(token, channel_id, overwrite_id, allow, deny, type, reason = nil)
+    OnyxCord::API.request(
+      :channels_cid_permissions_oid,
+      channel_id,
+      :put,
+      "#{OnyxCord::API.api_base}/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://discord.com/developers/docs/resources/channel#get-channel-invites
+  def invites(token, channel_id)
+    OnyxCord::API.request(
+      :channels_cid_invites,
+      channel_id,
+      :get,
+      "#{OnyxCord::API.api_base}/channels/#{channel_id}/invites",
+      Authorization: token
+    )
+  end
+
+  # Create an instant invite from a server or a channel id
+  # https://discord.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)
+    OnyxCord::API.request(
+      :channels_cid_invites,
+      channel_id,
+      :post,
+      "#{OnyxCord::API.api_base}/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://discord.com/developers/docs/resources/channel#delete-channel-permission
+  def delete_permission(token, channel_id, overwrite_id, reason = nil)
+    OnyxCord::API.request(
+      :channels_cid_permissions_oid,
+      channel_id,
+      :delete,
+      "#{OnyxCord::API.api_base}/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://discord.com/developers/docs/resources/channel#trigger-typing-indicator
+  def start_typing(token, channel_id)
+    OnyxCord::API.request(
+      :channels_cid_typing,
+      channel_id,
+      :post,
+      "#{OnyxCord::API.api_base}/channels/#{channel_id}/typing",
+      nil,
+      Authorization: token
+    )
+  end
+
+  # Get a list of pinned messages in a channel
+  # https://discord.com/developers/docs/resources/message#get-channel-pins
+  def pinned_messages(token, channel_id, limit = 50, before = nil)
+    query = URI.encode_www_form({ limit: limit, before: before }.compact)
+    OnyxCord::API.request(
+      :channels_cid_pins,
+      channel_id,
+      :get,
+      "#{OnyxCord::API.api_base}/channels/#{channel_id}/messages/pins?#{query}",
+      Authorization: token
+    )
+  end
+
+  # Pin a message
+  # https://discord.com/developers/docs/resources/message#pin-message
+  def pin_message(token, channel_id, message_id, reason = nil)
+    OnyxCord::API.request(
+      :channels_cid_pins_mid,
+      channel_id,
+      :put,
+      "#{OnyxCord::API.api_base}/channels/#{channel_id}/messages/pins/#{message_id}",
+      nil,
+      Authorization: token,
+      'X-Audit-Log-Reason': reason
+    )
+  end
+
+  # Unpin a message
+  # https://discord.com/developers/docs/resources/message#unpin-message
+  def unpin_message(token, channel_id, message_id, reason = nil)
+    OnyxCord::API.request(
+      :channels_cid_pins_mid,
+      channel_id,
+      :delete,
+      "#{OnyxCord::API.api_base}/channels/#{channel_id}/messages/pins/#{message_id}",
+      Authorization: token,
+      'X-Audit-Log-Reason': reason
+    )
+  end
+
+  # Create an empty group channel.
+  # @deprecated Discord no longer supports bots in group DMs, this endpoint was repurposed and no longer works as implemented here.
+  # https://discord.com/developers/docs/resources/user#create-group-dm
+  def create_empty_group(token, bot_user_id)
+    OnyxCord::API.request(
+      :users_uid_channels,
+      nil,
+      :post,
+      "#{OnyxCord::API.api_base}/users/#{bot_user_id}/channels",
+      {}.to_json,
+      Authorization: token,
+      content_type: :json
+    )
+  end
+
+  # Create a group channel.
+  # @deprecated Discord no longer supports bots in group DMs, this endpoint was repurposed and no longer works as implemented here.
+  # https://discord.com/developers/docs/resources/channel#group-dm-add-recipient
+  def create_group(token, pm_channel_id, user_id)
+    OnyxCord::API.request(
+      :channels_cid_recipients_uid,
+      nil,
+      :put,
+      "#{OnyxCord::API.api_base}/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.
+  # @deprecated Discord no longer supports bots in group DMs, this endpoint was repurposed and no longer works as implemented here.
+  # https://discord.com/developers/docs/resources/channel#group-dm-add-recipient
+  def add_group_user(token, group_channel_id, user_id)
+    OnyxCord::API.request(
+      :channels_cid_recipients_uid,
+      nil,
+      :put,
+      "#{OnyxCord::API.api_base}/channels/#{group_channel_id}/recipients/#{user_id}",
+      {}.to_json,
+      Authorization: token,
+      content_type: :json
+    )
+  end
+
+  # Remove a user from a group channel.
+  # @deprecated Discord no longer supports bots in group DMs, this endpoint was repurposed and no longer works as implemented here.
+  # https://discord.com/developers/docs/resources/channel#group-dm-remove-recipient
+  def remove_group_user(token, group_channel_id, user_id)
+    OnyxCord::API.request(
+      :channels_cid_recipients_uid,
+      nil,
+      :delete,
+      "#{OnyxCord::API.api_base}/channels/#{group_channel_id}/recipients/#{user_id}",
+      Authorization: token,
+      content_type: :json
+    )
+  end
+
+  # Leave a group channel.
+  # @deprecated Discord no longer supports bots in group DMs, this endpoint was repurposed and no longer works as implemented here.
+  # https://discord.com/developers/docs/resources/channel#deleteclose-channel
+  def leave_group(token, group_channel_id)
+    OnyxCord::API.request(
+      :channels_cid,
+      nil,
+      :delete,
+      "#{OnyxCord::API.api_base}/channels/#{group_channel_id}",
+      Authorization: token,
+      content_type: :json
+    )
+  end
+
+  # Create a webhook
+  # https://discord.com/developers/docs/resources/webhook#create-webhook
+  def create_webhook(token, channel_id, name, avatar = nil, reason = nil)
+    OnyxCord::API.request(
+      :channels_cid_webhooks,
+      channel_id,
+      :post,
+      "#{OnyxCord::API.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::API.request(
+      :channels_cid_webhooks,
+      channel_id,
+      :get,
+      "#{OnyxCord::API.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::API.request(
+      :channels_cid_followers,
+      channel_id,
+      :post,
+      "#{OnyxCord::API.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
+
+  # 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::API.request(
+      :channels_cid_messages_mid_threads,
+      channel_id,
+      :post,
+      "#{OnyxCord::API.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::API.request(
+      :channels_cid_threads,
+      channel_id,
+      :post,
+      "#{OnyxCord::API.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::API.request(
+      :channels_cid_thread_members_me,
+      channel_id,
+      :put,
+      "#{OnyxCord::API.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::API.request(
+      :channels_cid_thread_members_uid,
+      channel_id,
+      :put,
+      "#{OnyxCord::API.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::API.request(
+      :channels_cid_thread_members_me,
+      channel_id,
+      :delete,
+      "#{OnyxCord::API.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::API.request(
+      :channels_cid_thread_members_uid,
+      channel_id,
+      :delete,
+      "#{OnyxCord::API.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::API.request(
+      :channels_cid_thread_members,
+      channel_id,
+      :get,
+      "#{OnyxCord::API.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::API.request(
+      :channels_cid_threads_active,
+      channel_id,
+      :get,
+      "#{OnyxCord::API.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::API.request(
+      :channels_cid_threads_archived_public,
+      channel_id,
+      :get,
+      "#{OnyxCord::API.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::API.request(
+      :channels_cid_threads_archived_private,
+      channel_id,
+      :get,
+      "#{OnyxCord::API.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::API.request(
+      :channels_cid_users_me_threads_archived_private,
+      channel_id,
+      :get,
+      "#{OnyxCord::API.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)
+    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
+             files = [*0...attachments.size].zip(attachments).to_h
+             { **files, payload_json: body.to_json }
+           else
+             body.to_json
+           end
+
+    headers = { Authorization: token, 'X-Audit-Log-Reason': reason }
+    headers[:content_type] = :json unless attachments
+
+    OnyxCord::API.request(
+      :channels_cid_threads,
+      channel_id,
+      :post,
+      "#{OnyxCord::API.api_base}/channels/#{channel_id}/threads",
+      body,
+      headers
+    )
+  end
+
+  # Get a list of users that have voted for a poll answer.
+  # https://discord.com/developers/docs/resources/poll#get-answer-voters
+  def get_poll_voters(token, channel_id, message_id, answer_id, limit: 100, after: nil)
+    query = URI.encode_www_form({ limit:, after: }.compact)
+
+    OnyxCord::API.request(
+      :channels_cid_polls_mid_answers_aid,
+      channel_id,
+      :get,
+      "#{OnyxCord::API.api_base}/channels/#{channel_id}/polls/#{message_id}/answers/#{answer_id}?#{query}",
+      Authorization: token
+    )
+  end
+
+  # End a poll created by the current user.
+  # https://discord.com/developers/docs/resources/poll#end-poll
+  def end_poll(token, channel_id, message_id)
+    OnyxCord::API.request(
+      :channels_cid_polls_mid_expire,
+      channel_id,
+      :post,
+      "#{OnyxCord::API.api_base}/channels/#{channel_id}/polls/#{message_id}/expire",
+      nil,
+      Authorization: token
+    )
+  end
+end