discorb 0.5.4 → 0.6.1

data/lib/discorb/http.rb

@@ -25,8 +25,8 @@ module Discorb
     # @param [String] audit_log_reason The audit log reason to send with the request.
     # @param [Hash] kwargs The keyword arguments.
     #
-    # @return [Array[Net::HTTPResponse, Hash]] The response and as JSON.
-    # @return [Array[Net::HTTPResponse, nil]] The response was 204.
+    # @return [Array(Net::HTTPResponse, Hash)] The response and as JSON.
+    # @return [Async::Task<Array(Net::HTTPResponse, nil)>] The response was 204.
     #
     # @raise [Discorb::HTTPError] The request was failed.
     #
@@ -56,8 +56,8 @@ module Discorb
     # @param [String] audit_log_reason The audit log reason to send with the request.
     # @param [Hash] kwargs The keyword arguments.
     #
-    # @return [Array[Net::HTTPResponse, Hash]] The response and as JSON.
-    # @return [Array[Net::HTTPResponse, nil]] The response was 204.
+    # @return [Array(Net::HTTPResponse, Hash)] The response and as JSON.
+    # @return [Async::Task<Array(Net::HTTPResponse, nil)>] The response was 204.
     #
     # @raise [Discorb::HTTPError] The request was failed.
     #
@@ -86,8 +86,8 @@ module Discorb
     # @param [String] audit_log_reason The audit log reason to send with the request.
     # @param [Hash] kwargs The keyword arguments.
     #
-    # @return [Array[Net::HTTPResponse, Hash]] The response and as JSON.
-    # @return [Array[Net::HTTPResponse, nil]] The response was 204.
+    # @return [Array(Net::HTTPResponse, Hash)] The response and as JSON.
+    # @return [Async::Task<Array(Net::HTTPResponse, nil)>] The response was 204.
     #
     # @raise [Discorb::HTTPError] The request was failed.
     #
@@ -116,8 +116,8 @@ module Discorb
     # @param [String] audit_log_reason The audit log reason to send with the request.
     # @param [Hash] kwargs The keyword arguments.
     #
-    # @return [Array[Net::HTTPResponse, Hash]] The response and as JSON.
-    # @return [Array[Net::HTTPResponse, nil]] The response was 204.
+    # @return [Array(Net::HTTPResponse, Hash)] The response and as JSON.
+    # @return [Async::Task<Array(Net::HTTPResponse, nil)>] The response was 204.
     #
     # @raise [Discorb::HTTPError] The request was failed.
     #
@@ -145,8 +145,8 @@ module Discorb
     # @param [String] audit_log_reason The audit log reason to send with the request.
     # @param [Hash] kwargs The keyword arguments.
     #
-    # @return [Array[Net::HTTPResponse, Hash]] The response and as JSON.
-    # @return [Array[Net::HTTPResponse, nil]] The response was 204.
+    # @return [Array(Net::HTTPResponse, Hash)] The response and as JSON.
+    # @return [Async::Task<Array(Net::HTTPResponse, nil)>] The response was 204.
     #
     # @raise [Discorb::HTTPError] The request was failed.
     #
@@ -175,7 +175,7 @@ module Discorb
     # @param [Hash] payload The payload to send.
     # @param [Array<Discorb::File>] files The files to send.
     #
-    # @return [Array[String, String]] The boundary and body.
+    # @return [Array(String, String)] The boundary and body.
     #
     def self.multipart(payload, files)
       boundary = "DiscorbBySevenC7CMultipartFormData#{Time.now.to_f}"
@@ -203,6 +203,8 @@ module Discorb
       case resp.code
       when "400"
         raise BadRequestError.new(resp, data)
+      when "401"
+        raise UnauthorizedError.new(resp, data)
       when "403"
         raise ForbiddenError.new(resp, data)
       when "404"

data/lib/discorb/intents.rb

@@ -26,7 +26,6 @@ module Discorb
     #
     # @param guilds [Boolean] Whether guild related events are enabled.
     # @param members [Boolean] Whether guild members related events are enabled.
-    #   @note You must enable members intent on developers portal.
     # @param bans [Boolean] Whether guild ban related events are enabled.
     # @param emojis [Boolean] Whether guild emojis related events are enabled.
     # @param integrations [Boolean] Whether guild integration related events are enabled.
@@ -34,13 +33,14 @@ module Discorb
     # @param invites [Boolean] Whether guild invite related events are enabled.
     # @param voice_states [Boolean] Whether guild voice state related events are enabled.
     # @param presences [Boolean] Whether guild presences related events are enabled.
-    #   @note You must enable members intent on developers portal.
     # @param messages [Boolean] Whether guild messages related events are enabled.
     # @param reactions [Boolean] Whether guild reaction related events are enabled.
     # @param dm_messages [Boolean] Whether dm messages related events are enabled.
     # @param dm_reactions [Boolean] Whether dm reactions related events are enabled.
     # @param dm_typing [Boolean] Whether dm typing related events are enabled.
     #
+    # @note You must enable privileged intents to use `members` and/or `presences` intents.
+    #
     def initialize(guilds: true,
                    members: false,
                    bans: true,

data/lib/discorb/interaction.rb

@@ -121,7 +121,7 @@ module Discorb
       # @param [Discorb::Embed] embed The embed to send.
       # @param [Array<Discorb::Embed>] embeds The embeds to send. (max: 10)
       # @param [Discorb::AllowedMentions] allowed_mentions The allowed mentions to send.
-      # @param [Array<Discorb::Components>, Array<Array<Discorb::Components>>] components The components to send.
+      # @param [Array<Discorb::Component>, Array<Array<Discorb::Component>>] components The components to send.
       # @param [Boolean] ephemeral Whether to make the response ephemeral.
       #
       def post(content = nil, tts: false, embed: nil, embeds: nil, allowed_mentions: nil, components: nil, ephemeral: false)
@@ -195,7 +195,7 @@ module Discorb
       # @param [Discorb::Embed] embed The embed to send.
       # @param [Array<Discorb::Embed>] embeds The embeds to send. (max: 10)
       # @param [Discorb::AllowedMentions] allowed_mentions The allowed mentions to send.
-      # @param [Array<Discorb::Components>, Array<Array<Discorb::Components>>] components The components to send.
+      # @param [Array<Discorb::Component>, Array<Array<Discorb::Component>>] components The components to send.
       # @param [Boolean] ephemeral Whether to make the response ephemeral.
       #
       def edit(content, tts: false, embed: nil, embeds: nil, allowed_mentions: nil, components: nil, ephemeral: false)
@@ -336,7 +336,7 @@ module Discorb
       private
 
       def _set_data(data)
-        @target = Message.new(@client, data[:resolved][:messages][data[:target_id].to_sym].merge({ guild_id: @guild_id.to_s }))
+        @target = Message.new(@client, data[:resolved][:messages][data[:target_id].to_sym])
         @client.commands.find { |c| c.name == data[:name] && c.type_raw == 3 }.block.call(self, @target)
       end
     end

data/lib/discorb/member.rb

@@ -211,7 +211,7 @@ module Discorb
     # @param [Integer] delete_message_days The number of days to delete messages.
     # @param [String] reason The reason for the action.
     #
-    # @return [Discorb::Guild::Ban] The ban.
+    # @return [Async::Task<Discorb::Guild::Ban>] The ban.
     #
     def ban(delete_message_days: 0, reason: nil)
       Async do

data/lib/discorb/message.rb

@@ -128,7 +128,7 @@ module Discorb
     attr_reader :interaction
     # @return [Discorb::ThreadChannel] The thread channel of the message.
     attr_reader :thread
-    # @return [Array<Array<Discorb::Components>>] The components of the message.
+    # @return [Array<Array<Discorb::Component>>] The components of the message.
     attr_reader :components
     # @return [Boolean] Whether the message is deleted.
     attr_reader :deleted
@@ -218,7 +218,7 @@ module Discorb
     #
     # @param [String] content The message content.
     # @param [Discorb::Embed] embed The embed to send.
-    # @param [Array<Discord::Embed>] embeds The embeds to send.
+    # @param [Array<Discorb::Embed>] embeds The embeds to send.
     # @param [Discorb::AllowedMentions] allowed_mentions The allowed mentions.
     # @param [Array<Discorb::Component>, Array<Array<Discorb::Component>>] components The components to send.
     # @param [Boolean] supress Whether to supress embeds.
@@ -266,7 +266,7 @@ module Discorb
     # @macro async
     # @macro http
     # @param (see #post)
-    # @return [Discorb::Message] The message.
+    # @return [Async::Task<Discorb::Message>] The message.
     def reply(*args, **kwargs)
       Async do
         channel.post(*args, reference: self, **kwargs).wait
@@ -339,7 +339,7 @@ module Discorb
     # @param [Integer, nil] limit The maximum number of users to fetch. `nil` for no limit.
     # @param [Discorb::Snowflake, nil] after The ID of the user to start fetching from.
     #
-    # @return [Array<Discorb::User>] The users.
+    # @return [Async::Task<Array<Discorb::User>>] The users.
     #
     def fetch_reacted_users(emoji, limit: nil, after: 0)
       Async do
@@ -393,7 +393,7 @@ module Discorb
     #
     # @param (see Discorb::Channel#start_thread)
     #
-    # @return [<Type>] <description>
+    # @return [Async::Task<<Type>>] <description>
     #
     def start_thread(*args, **kwargs)
       Async do

data/lib/discorb/modules.rb

@@ -16,11 +16,11 @@ module Discorb
     # @param [Array<Discorb::Embed>] embeds The embeds to send.
     # @param [Discorb::AllowedMentions] allowed_mentions The allowed mentions.
     # @param [Discorb::Message, Discorb::Message::Reference] reference The message to reply to.
-    # @param [Array<Discorb::Components>, Array<Array<Discorb::Components>>] components The components to send.
+    # @param [Array<Discorb::Component>, Array<Array<Discorb::Component>>] components The components to send.
     # @param [Discorb::File] file The file to send.
     # @param [Array<Discorb::File>] files The files to send.
     #
-    # @return [Discorb::Message] The message sent.
+    # @return [Async::Task<Discorb::Message>] The message sent.
     #
     def post(content = nil, tts: false, embed: nil, embeds: nil, allowed_mentions: nil,
                             reference: nil, components: nil, file: nil, files: nil)
@@ -76,7 +76,7 @@ module Discorb
     # @param [#to_s] message_id The message id.
     # @param [String] content The message content.
     # @param [Discorb::Embed] embed The embed to send.
-    # @param [Array<Discord::Embed>] embeds The embeds to send.
+    # @param [Array<Discorb::Embed>] embeds The embeds to send.
     # @param [Discorb::AllowedMentions] allowed_mentions The allowed mentions.
     # @param [Array<Discorb::Component>, Array<Array<Discorb::Component>>] components The components to send.
     # @param [Boolean] supress Whether to supress embeds.
@@ -142,7 +142,7 @@ module Discorb
     #
     # @param [Discorb::Snowflake] id The ID of the message.
     #
-    # @return [Discorb::Message] The message.
+    # @return [Async::Task<Discorb::Message>] The message.
     # @raise [Discorb::NotFoundError] If the message is not found.
     #
     def fetch_message(id)
@@ -162,7 +162,7 @@ module Discorb
     # @param [Discorb::Snowflake] after The ID of the message to fetch after.
     # @param [Discorb::Snowflake] around The ID of the message to fetch around.
     #
-    # @return [Array<Discorb::Message>] The messages.
+    # @return [Async::Task<Array<Discorb::Message>>] The messages.
     #
     def fetch_messages(limit = 50, before: nil, after: nil, around: nil)
       Async do

data/lib/discorb/user.rb

@@ -56,7 +56,7 @@ module Discorb
     #
     # @param [Boolean] strict Whether don't allow if the user is a member of the team.
     #
-    # @return [Boolean] Whether the user is a owner of the client.
+    # @return [Async::Task<Boolean>] Whether the user is a owner of the client.
     #
     def bot_owner?(strict: false)
       Async do

data/lib/discorb/webhook.rb

@@ -58,7 +58,7 @@ module Discorb
     # @param [Boolean] wait Whether to wait for the message to be sent.
     #
     # @return [Discorb::Webhook::Message] The message that was sent.
-    # @return [nil] If `wait` is false.
+    # @return [Async::Task<nil>] If `wait` is false.
     #
     def post(content = nil, tts: false, embed: nil, embeds: nil, allowed_mentions: nil,
                             file: nil, files: nil, username: nil, avatar_url: :unset, wait: true)

data/lib/discorb.rb

@@ -44,7 +44,7 @@ require_order = %w[common flag dictionary error rate_limit http intents emoji_ta
                 %w[application audit_logs color components event] +
                 %w[file guild_template image integration interaction invite log permission] +
                 %w[presence reaction role sticker utils voice_state webhook] +
-                %w[gateway_requests gateway command] +
+                %w[gateway_requests gateway app_command] +
                 %w[asset extension client extend]
 require_order.each do |name|
   require_relative "discorb/#{name}.rb"

data/po/yard.pot

@@ -322,7 +322,7 @@ msgid "## How do I register an application command?"
 msgstr ""
 
 #: ../docs/application_command.md:13
-msgid "Use {Discorb::Command::Handler#slash}, {Discorb::Command::Handler#group} for slash commands, {Discorb::Command::Handler#user_command} for user menu commands, and {Discorb::Command::Handler#message_command} for message menu commands."
+msgid "Use {Discorb::ApplicationCommand::Handler#slash}, {Discorb::ApplicationCommand::Handler#group} for slash commands, {Discorb::ApplicationCommand::Handler#user_command} for user menu commands, and {Discorb::ApplicationCommand::Handler#message_command} for message menu commands."
 msgstr ""
 
 #: ../docs/application_command.md:15
@@ -349,7 +349,7 @@ msgid "client.slash(\"hello\", \"Greet for you\") do |interaction|\n"
 msgstr ""
 
 #: ../docs/application_command.md:36
-msgid "{Discorb::Command::Handler#slash} takes 5 arguments:"
+msgid "{Discorb::ApplicationCommand::Handler#slash} takes 5 arguments:"
 msgstr ""
 
 #: ../docs/application_command.md:38
@@ -441,7 +441,7 @@ msgid "### Group Slash Commands"
 msgstr ""
 
 #: ../docs/application_command.md:104
-msgid "To register a group of slash commands, use {Discorb::Command::Handler#slash_group}."
+msgid "To register a group of slash commands, use {Discorb::ApplicationCommand::Handler#slash_group}."
 msgstr ""
 
 #: ../docs/application_command.md:106
@@ -473,7 +473,7 @@ msgid "group.slash(\"bump_alert\", \"Whether bot should notify DISBOARD bump.\",
 msgstr ""
 
 #: ../docs/application_command.md:128
-msgid "You can make subcommand group by using {Discorb::Command::GroupCommand#group}."
+msgid "You can make subcommand group by using {Discorb::ApplicationCommand::GroupCommand#group}."
 msgstr ""
 
 #: ../docs/application_command.md:130
@@ -558,7 +558,7 @@ msgid "```ruby\n"
 "  interaction.post(\"Hello, #{user.name}!\")\n"
 "end\n"
 "```\n"
-"{Discorb::Command::Handler#user_command} takes 3 arguments:"
+"{Discorb::ApplicationCommand::Handler#user_command} takes 3 arguments:"
 msgstr ""
 
 #: ../docs/application_command.md:216
@@ -595,7 +595,7 @@ msgid "```ruby\n"
 msgstr ""
 
 #: ../docs/application_command.md:238
-msgid "{Discorb::Command::Handler#message_command} takes 3 arguments:"
+msgid "{Discorb::ApplicationCommand::Handler#message_command} takes 3 arguments:"
 msgstr ""
 
 #: ../docs/application_command.md:248
@@ -4592,7 +4592,7 @@ msgstr ""
 msgid "The logger."
 msgstr ""
 
-# @return [Array<Discorb::Command::Command>]
+# @return [Array<Discorb::ApplicationCommand::Command>]
 #: ../lib/discorb/client.rb:45
 msgid "The commands that the client is using."
 msgstr ""
@@ -5262,17 +5262,17 @@ msgstr ""
 msgid "A Discord color name."
 msgstr ""
 
-# Discorb::Command
+# Discorb::ApplicationCommand
 #: ../lib/discorb/command.rb:5
 msgid "Handles application commands."
 msgstr ""
 
-# Discorb::Command::Handler
+# Discorb::ApplicationCommand::Handler
 #: ../lib/discorb/command.rb:9
 msgid "Module to handle commands."
 msgstr ""
 
-# Discorb::Command::Handler#slash
+# Discorb::ApplicationCommand::Handler#slash
 #: ../lib/discorb/command.rb:13
 msgid "Add new top-level command."
 msgstr ""
@@ -5364,14 +5364,14 @@ msgstr ""
 msgid "tag|param|options"
 msgstr ""
 
-# Discorb::Command::Handler#slash_group
+# Discorb::ApplicationCommand::Handler#slash_group
 #: ../lib/discorb/command.rb:41
 msgid "Add new command with group."
 msgstr ""
 
-# @return [Discorb::Command::Command::GroupCommand]
-# @return [Discorb::Command::Command::SubcommandGroup]
-# @return [Discorb::Command::Command]
+# @return [Discorb::ApplicationCommand::Command::GroupCommand]
+# @return [Discorb::ApplicationCommand::Command::SubcommandGroup]
+# @return [Discorb::ApplicationCommand::Command]
 #: ../lib/discorb/command.rb:51
 #: ../lib/discorb/command.rb:69
 #: ../lib/discorb/command.rb:87
@@ -5385,7 +5385,7 @@ msgstr ""
 msgid "tag|see|file:docs/slash_command.md"
 msgstr ""
 
-# Discorb::Command::Handler#message_command
+# Discorb::ApplicationCommand::Handler#message_command
 #: ../lib/discorb/command.rb:58
 msgid "Add message context menu command."
 msgstr ""
@@ -5397,13 +5397,13 @@ msgstr ""
 msgid "Block to execute."
 msgstr ""
 
-# @yieldparam [Discorb::CommandInteraction::UserMenuCommand]
+# @yieldparam [Discorb::ApplicationCommandInteraction::UserMenuCommand]
 #: ../lib/discorb/command.rb:69
 #: ../lib/discorb/command.rb:87
 msgid "tag|yieldparam|Interaction"
 msgstr ""
 
-# @yieldparam [Discorb::CommandInteraction::UserMenuCommand] Interaction
+# @yieldparam [Discorb::ApplicationCommandInteraction::UserMenuCommand] Interaction
 #: ../lib/discorb/command.rb:69
 #: ../lib/discorb/command.rb:87
 msgid "object."
@@ -5421,7 +5421,7 @@ msgstr ""
 msgid "Message object."
 msgstr ""
 
-# Discorb::Command::Handler#user_command
+# Discorb::ApplicationCommand::Handler#user_command
 #: ../lib/discorb/command.rb:76
 msgid "Add user context menu command."
 msgstr ""
@@ -5431,7 +5431,7 @@ msgstr ""
 msgid "User object."
 msgstr ""
 
-# Discorb::Command::Handler#setup_commands
+# Discorb::ApplicationCommand::Handler#setup_commands
 #: ../lib/discorb/command.rb:94
 msgid "Setup commands."
 msgstr ""
@@ -5456,7 +5456,7 @@ msgstr ""
 msgid "tag|see|Client#initialize"
 msgstr ""
 
-# Discorb::Command::Command
+# Discorb::ApplicationCommand::Command
 #: ../lib/discorb/command.rb:119
 msgid "Represents a application command."
 msgstr ""
@@ -5497,7 +5497,7 @@ msgstr ""
 msgid "a new instance of Command"
 msgstr ""
 
-# Discorb::Command::Command::SlashCommand
+# Discorb::ApplicationCommand::Command::SlashCommand
 #: ../lib/discorb/command.rb:163
 msgid "Represents the slash command."
 msgstr ""
@@ -5518,18 +5518,18 @@ msgstr ""
 msgid "a new instance of SlashCommand"
 msgstr ""
 
-# Discorb::Command::Command::SlashCommand#to_s
+# Discorb::ApplicationCommand::Command::SlashCommand#to_s
 #: ../lib/discorb/command.rb:185
 msgid "Returns the commands name."
 msgstr ""
 
-# Discorb::Command::Command::GroupCommand
+# Discorb::ApplicationCommand::Command::GroupCommand
 #: ../lib/discorb/command.rb:236
 msgid "Represents the command with subcommands."
 msgstr ""
 
-# @return [Array<Discorb::Command::Command::SlashCommand, Discorb::Command::Command::SubcommandGroup>]
-# @return [Array<Discorb::Command::Command::SlashCommand>]
+# @return [Array<Discorb::ApplicationCommand::Command::SlashCommand, Discorb::ApplicationCommand::Command::SubcommandGroup>]
+# @return [Array<Discorb::ApplicationCommand::Command::SlashCommand>]
 #: ../lib/discorb/command.rb:240
 #: ../lib/discorb/command.rb:361
 msgid "The subcommands of the command."
@@ -5540,20 +5540,20 @@ msgstr ""
 msgid "a new instance of GroupCommand"
 msgstr ""
 
-# Discorb::Command::Command::GroupCommand#slash
-# Discorb::Command::Command::SubcommandGroup#slash
+# Discorb::ApplicationCommand::Command::GroupCommand#slash
+# Discorb::ApplicationCommand::Command::SubcommandGroup#slash
 #: ../lib/discorb/command.rb:253
 #: ../lib/discorb/command.rb:376
 msgid "Add new subcommand."
 msgstr ""
 
-# @return [Discorb::Command::Command::SlashCommand]
+# @return [Discorb::ApplicationCommand::Command::SlashCommand]
 #: ../lib/discorb/command.rb:258
 #: ../lib/discorb/command.rb:380
 msgid "The added subcommand."
 msgstr ""
 
-# Discorb::Command::Command::GroupCommand#group
+# Discorb::ApplicationCommand::Command::GroupCommand#group
 #: ../lib/discorb/command.rb:301
 msgid "Add new subcommand group."
 msgstr ""
@@ -5568,7 +5568,7 @@ msgstr ""
 msgid "Group description."
 msgstr ""
 
-# Discorb::Command::Command::GroupCommand#to_s
+# Discorb::ApplicationCommand::Command::GroupCommand#to_s
 #: ../lib/discorb/command.rb:317
 msgid "Returns the command name."
 msgstr ""
@@ -5578,7 +5578,7 @@ msgstr ""
 msgid "The command name."
 msgstr ""
 
-# Discorb::Command::Command::SubcommandGroup
+# Discorb::ApplicationCommand::Command::SubcommandGroup
 #: ../lib/discorb/command.rb:357
 msgid "Represents the subcommand group."
 msgstr ""
@@ -5589,7 +5589,7 @@ msgid "a new instance of SubcommandGroup"
 msgstr ""
 
 # Discorb::Activity.types
-# Discorb::Command::Command.types
+# Discorb::ApplicationCommand::Command.types
 #: ../lib/discorb/command.rb:390
 #: ../lib/discorb/gateway_requests.rb:45
 msgid "Returns the value of attribute types."
@@ -9873,7 +9873,7 @@ msgstr ""
 msgid "Response with `UPDATE_MESSAGE`(`7`)."
 msgstr ""
 
-# Discorb::CommandInteraction
+# Discorb::ApplicationCommandInteraction
 #: ../lib/discorb/interaction.rb:245
 msgid "Represents a command interaction."
 msgstr ""
@@ -9883,12 +9883,12 @@ msgstr ""
 msgid "Implement this."
 msgstr ""
 
-# Discorb::CommandInteraction::SlashCommand
+# Discorb::ApplicationCommandInteraction::SlashCommand
 #: ../lib/discorb/interaction.rb:254
 msgid "Represents a slash command interaction."
 msgstr ""
 
-# Discorb::CommandInteraction::UserMenuCommand
+# Discorb::ApplicationCommandInteraction::UserMenuCommand
 #: ../lib/discorb/interaction.rb:310
 msgid "Represents a user context menu interaction."
 msgstr ""
@@ -9898,7 +9898,7 @@ msgstr ""
 msgid "The target user."
 msgstr ""
 
-# Discorb::CommandInteraction::MessageMenuCommand
+# Discorb::ApplicationCommandInteraction::MessageMenuCommand
 #: ../lib/discorb/interaction.rb:325
 msgid "Represents a message context menu interaction."
 msgstr ""
@@ -9908,7 +9908,7 @@ msgstr ""
 msgid "The target message."
 msgstr ""
 
-# Discorb::CommandInteraction.command_type
+# Discorb::ApplicationCommandInteraction.command_type
 #: ../lib/discorb/interaction.rb:348
 msgid "Returns the value of attribute command_type."
 msgstr ""