onyxcord 2.0.13 → 3.2.0

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

@@ -0,0 +1,73 @@
+# frozen_string_literal: true
+
+module OnyxCord::REST::Channel
+  module_function
+
+  # Build attachment metadata payload for multipart uploads.
+  # Returns an array of { id:, filename: } hashes.
+  def attachment_payload(attachments)
+    OnyxCord::MessagePayload.attachment_payload(attachments)
+  end
+
+  # Build multipart body with named file fields and JSON payload.
+  def multipart_body(body, attachments)
+    OnyxCord::MessagePayload.multipart_body(body, attachments)
+  end
+
+  # Get a channel's data
+  # https://discord.com/developers/docs/resources/channel#get-channel
+  def resolve(token, channel_id)
+    OnyxCord::REST.request(
+      :channels_cid,
+      channel_id,
+      :get,
+      "#{OnyxCord::REST.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::REST.request(
+      :channels_cid,
+      channel_id,
+      :patch,
+      "#{OnyxCord::REST.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::REST.request(
+      :channels_cid,
+      channel_id,
+      :patch,
+      "#{OnyxCord::REST.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::REST.request(
+      :channels_cid,
+      channel_id,
+      :delete,
+      "#{OnyxCord::REST.api_base}/channels/#{channel_id}",
+      Authorization: token,
+      'X-Audit-Log-Reason': reason
+    )
+  end
+end

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

@@ -0,0 +1,78 @@
+# frozen_string_literal: true
+
+module OnyxCord::REST::Channel
+  module_function
+
+  # 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::REST.request(
+      :users_uid_channels,
+      nil,
+      :post,
+      "#{OnyxCord::REST.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::REST.request(
+      :channels_cid_recipients_uid,
+      nil,
+      :put,
+      "#{OnyxCord::REST.api_base}/channels/#{pm_channel_id}/recipients/#{user_id}",
+      {}.to_json,
+      Authorization: token,
+      content_type: :json
+    )
+  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::REST.request(
+      :channels_cid_recipients_uid,
+      nil,
+      :put,
+      "#{OnyxCord::REST.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::REST.request(
+      :channels_cid_recipients_uid,
+      nil,
+      :delete,
+      "#{OnyxCord::REST.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::REST.request(
+      :channels_cid,
+      nil,
+      :delete,
+      "#{OnyxCord::REST.api_base}/channels/#{group_channel_id}",
+      Authorization: token,
+      content_type: :json
+    )
+  end
+end

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

@@ -0,0 +1,130 @@
+# frozen_string_literal: true
+
+module OnyxCord::REST::Channel
+  module_function
+
+  # 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::REST.request(
+      :channels_cid_messages,
+      channel_id,
+      :get,
+      "#{OnyxCord::REST.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::REST.request(
+      :channels_cid_messages_mid,
+      channel_id,
+      :get,
+      "#{OnyxCord::REST.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)
+    tts = false unless [true, false].include?(tts)
+    components = OnyxCord::MessageComponents.payload(components) unless components.nil?
+    flags = OnyxCord::MessageComponents.apply_v2_flag(flags, components)
+    OnyxCord::MessagePayload.validate!(content: message, embeds: embeds, components: components, flags: flags, attachments: attachments, poll: poll)
+    body = { content: message, tts: tts == true, embeds: embeds, nonce: nonce, allowed_mentions: allowed_mentions, message_reference: message_reference, components: components, attachments: attachments ? attachment_payload(attachments) : nil, flags: flags, enforce_nonce: enforce_nonce, poll: poll }.compact
+    body = if attachments
+             multipart_body(body, attachments)
+           else
+             body.to_json
+           end
+
+    headers = { Authorization: token }
+    headers[:content_type] = :json unless attachments
+
+    OnyxCord::REST.request(
+      :channels_cid_messages_mid,
+      channel_id,
+      :post,
+      "#{OnyxCord::REST.api_base}/channels/#{channel_id}/messages",
+      body,
+      **headers
+    )
+  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::REST.request(
+      :channels_cid_messages_mid,
+      channel_id,
+      :post,
+      "#{OnyxCord::REST.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)
+    body = OnyxCord::MessagePayload.edit_body(message, embeds)
+    body.merge!(allowed_mentions: mentions, components: components, flags: flags)
+    OnyxCord::REST.request(
+      :channels_cid_messages_mid,
+      channel_id,
+      :patch,
+      "#{OnyxCord::REST.api_base}/channels/#{channel_id}/messages/#{message_id}",
+      body.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::REST.request(
+      :channels_cid_messages_mid,
+      channel_id,
+      :delete,
+      "#{OnyxCord::REST.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::REST.request(
+      :channels_cid_messages_mid,
+      channel_id,
+      :post,
+      "#{OnyxCord::REST.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::REST.request(
+      :channels_cid_messages_bulk_delete,
+      channel_id,
+      :post,
+      "#{OnyxCord::REST.api_base}/channels/#{channel_id}/messages/bulk-delete",
+      { messages: messages }.to_json,
+      Authorization: token,
+      content_type: :json,
+      'X-Audit-Log-Reason': reason
+    )
+  end
+end

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

@@ -0,0 +1,73 @@
+# frozen_string_literal: true
+
+module OnyxCord::REST::Channel
+  module_function
+
+  # 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::REST.request(
+      :channels_cid_permissions_oid,
+      channel_id,
+      :put,
+      "#{OnyxCord::REST.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::REST.request(
+      :channels_cid_invites,
+      channel_id,
+      :get,
+      "#{OnyxCord::REST.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::REST.request(
+      :channels_cid_invites,
+      channel_id,
+      :post,
+      "#{OnyxCord::REST.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::REST.request(
+      :channels_cid_permissions_oid,
+      channel_id,
+      :delete,
+      "#{OnyxCord::REST.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::REST.request(
+      :channels_cid_typing,
+      channel_id,
+      :post,
+      "#{OnyxCord::REST.api_base}/channels/#{channel_id}/typing",
+      nil,
+      Authorization: token
+    )
+  end
+end

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

@@ -0,0 +1,45 @@
+# frozen_string_literal: true
+
+module OnyxCord::REST::Channel
+  module_function
+
+  # 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::REST.request(
+      :channels_cid_pins,
+      channel_id,
+      :get,
+      "#{OnyxCord::REST.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::REST.request(
+      :channels_cid_pins_mid,
+      channel_id,
+      :put,
+      "#{OnyxCord::REST.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::REST.request(
+      :channels_cid_pins_mid,
+      channel_id,
+      :delete,
+      "#{OnyxCord::REST.api_base}/channels/#{channel_id}/messages/pins/#{message_id}",
+      Authorization: token,
+      'X-Audit-Log-Reason': reason
+    )
+  end
+end

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

@@ -0,0 +1,32 @@
+# frozen_string_literal: true
+
+module OnyxCord::REST::Channel
+  module_function
+
+  # 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::REST.request(
+      :channels_cid_polls_mid_answers_aid,
+      channel_id,
+      :get,
+      "#{OnyxCord::REST.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::REST.request(
+      :channels_cid_polls_mid_expire,
+      channel_id,
+      :post,
+      "#{OnyxCord::REST.api_base}/channels/#{channel_id}/polls/#{message_id}/expire",
+      nil,
+      Authorization: token
+    )
+  end
+end

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

@@ -0,0 +1,86 @@
+# frozen_string_literal: true
+
+module OnyxCord::REST::Channel
+  module_function
+
+  # 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::REST.request(
+      :channels_cid_messages_mid_reactions_emoji_me,
+      channel_id,
+      :put,
+      "#{OnyxCord::REST.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::REST.request(
+      :channels_cid_messages_mid_reactions_emoji_me,
+      channel_id,
+      :delete,
+      "#{OnyxCord::REST.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::REST.request(
+      :channels_cid_messages_mid_reactions_emoji_uid,
+      channel_id,
+      :delete,
+      "#{OnyxCord::REST.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::REST.request(
+      :channels_cid_messages_mid_reactions_emoji,
+      channel_id,
+      :get,
+      "#{OnyxCord::REST.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::REST.request(
+      :channels_cid_messages_mid_reactions,
+      channel_id,
+      :delete,
+      "#{OnyxCord::REST.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::REST.request(
+      :channels_cid_messages_mid_reactions_emoji,
+      channel_id,
+      :delete,
+      "#{OnyxCord::REST.api_base}/channels/#{channel_id}/messages/#{message_id}/reactions/#{emoji}",
+      Authorization: token
+    )
+  end
+end