discorb 0.6.0 → 0.7.2

data/lib/discorb/{command.rb → app_command.rb}

@@ -4,9 +4,9 @@ module Discorb
   #
   # Handles application commands.
   #
-  module Command
+  module ApplicationCommand
     #
-    # Module to handle commands.
+    # Module to handle application commands.
     #
     module Handler
       #
@@ -27,13 +27,13 @@ module Discorb
       # @param [Array<#to_s>, false, nil] guild_ids Guild IDs to set the command to. `false` to global command, `nil` to use default.
       # @param [Proc] block Command block.
       #
-      # @return [Discorb::Command::Command::SlashCommand]
+      # @return [Discorb::ApplicationCommand::Command::SlashCommand] Command object.
       #
       # @see file:docs/application_command.md#register-slash-command
       # @see file:docs/cli/setup.md
       #
       def slash(command_name, description, options = {}, guild_ids: nil, &block)
-        command = Discorb::Command::Command::SlashCommand.new(command_name, description, options, guild_ids, block, 1, "")
+        command = Discorb::ApplicationCommand::Command::SlashCommand.new(command_name, description, options, guild_ids, block, 1, "")
         @commands << command
         @bottom_commands << command
         command
@@ -46,17 +46,17 @@ module Discorb
       # @param [String] description Command description.
       # @param [Array<#to_s>, false, nil] guild_ids Guild IDs to set the command to. `false` to global command, `nil` to use default.
       #
-      # @yield Block to execute as the command. It can be used to define sub-commands.
-      # @yieldself [Discorb::Command::Command::GroupCommand] Group command.
+      # @yield Block to yield with the command.
+      # @yieldparam [Discorb::ApplicationCommand::Command::GroupCommand] group Group command.
       #
-      # @return [Discorb::Command::Command::GroupCommand] Command object.
+      # @return [Discorb::ApplicationCommand::Command::GroupCommand] Command object.
       #
       # @see file:docs/slash_command.md
       # @see file:docs/cli/setup.md
       #
       def slash_group(command_name, description, guild_ids: nil, &block)
-        command = Discorb::Command::Command::GroupCommand.new(command_name, description, guild_ids, nil, self)
-        command.instance_eval(&block) if block_given?
+        command = Discorb::ApplicationCommand::Command::GroupCommand.new(command_name, description, guild_ids, nil, self)
+        command.yield_self(&block) if block_given?
         @commands << command
         command
       end
@@ -68,13 +68,13 @@ module Discorb
       # @param [Array<#to_s>, false, nil] guild_ids Guild IDs to set the command to. `false` to global command, `nil` to use default.
       # @param [Proc] block Command block.
       # @yield [interaction, message] Block to execute.
-      # @yieldparam [Discorb::CommandInteraction::UserMenuCommand] interaction Interaction object.
+      # @yieldparam [Discorb::ApplicationCommandInteraction::UserMenuCommand] interaction Interaction object.
       # @yieldparam [Discorb::Message] message Message object.
       #
-      # @return [Discorb::Command::Command] Command object.
+      # @return [Discorb::ApplicationCommand::Command] Command object.
       #
       def message_command(command_name, guild_ids: nil, &block)
-        command = Discorb::Command::Command.new(command_name, guild_ids, block, 3)
+        command = Discorb::ApplicationCommand::Command.new(command_name, guild_ids, block, 3)
         @commands << command
         command
       end
@@ -86,13 +86,13 @@ module Discorb
       # @param [Array<#to_s>, false, nil] guild_ids Guild IDs to set the command to. `false` to global command, `nil` to use default.
       # @param [Proc] block Command block.
       # @yield [interaction, user] Block to execute.
-      # @yieldparam [Discorb::CommandInteraction::UserMenuCommand] interaction Interaction object.
+      # @yieldparam [Discorb::ApplicationCommandInteraction::UserMenuCommand] interaction Interaction object.
       # @yieldparam [Discorb::User] user User object.
       #
-      # @return [Discorb::Command::Command] Command object.
+      # @return [Discorb::ApplicationCommand::Command] Command object.
       #
       def user_command(command_name, guild_ids: nil, &block)
-        command = Discorb::Command::Command.new(command_name, guild_ids, block, 2)
+        command = Discorb::ApplicationCommand::Command.new(command_name, guild_ids, block, 2)
         @commands << command
         command
       end
@@ -163,7 +163,7 @@ module Discorb
         @guild_ids = guild_ids&.map(&:to_s)
         @block = block
         @raw_type = type
-        @type = Discorb::Command::Command.types[type]
+        @type = Discorb::ApplicationCommand::Command.types[type]
         @type_raw = type
         @id_map = Discorb::Dictionary.new
       end
@@ -251,7 +251,7 @@ module Discorb
       # Represents the command with subcommands.
       #
       class GroupCommand < Command
-        # @return [Array<Discorb::Command::Command::SlashCommand, Discorb::Command::Command::SubcommandGroup>] The subcommands of the command.
+        # @return [Array<Discorb::ApplicationCommand::Command::SlashCommand, Discorb::ApplicationCommand::Command::SubcommandGroup>] The subcommands of the command.
         attr_reader :commands
         # @return [String] The description of the command.
         attr_reader :description
@@ -268,11 +268,11 @@ module Discorb
         #
         # Add new subcommand.
         #
-        # @param (see Discorb::Command::Handler#slash)
-        # @return [Discorb::Command::Command::SlashCommand] The added subcommand.
+        # @param (see Discorb::ApplicationCommand::Handler#slash)
+        # @return [Discorb::ApplicationCommand::Command::SlashCommand] The added subcommand.
         #
         def slash(command_name, description, options = {}, &block)
-          command = Discorb::Command::Command::SlashCommand.new(command_name, description, options, [], block, 1, @name)
+          command = Discorb::ApplicationCommand::Command::SlashCommand.new(command_name, description, options, [], block, 1, @name)
           @client.bottom_commands << command
           @commands << command
           command
@@ -284,16 +284,16 @@ module Discorb
         # @param [String] command_name Group name.
         # @param [String] description Group description.
         #
-        # @yield Block to execute as the command. It can be used to define sub-commands.
-        # @yieldself [Discorb::Command::Command::SubcommandGroup] Group command.
+        # @yield Block to yield with the command.
+        # @yieldparam [Discorb::ApplicationCommand::Command::SubcommandGroup] group Group command.
         #
-        # @return [Discorb::Command::Command::SubcommandGroup] Command object.
+        # @return [Discorb::ApplicationCommand::Command::SubcommandGroup] Command object.
         #
         # @see file:docs/slash_command.md
         #
         def group(command_name, description, &block)
-          command = Discorb::Command::Command::SubcommandGroup.new(command_name, description, @name, @client)
-          command.instance_eval(&block) if block_given?
+          command = Discorb::ApplicationCommand::Command::SubcommandGroup.new(command_name, description, @name, @client)
+          command.yield_self(&block) if block_given?
           @commands << command
           command
         end
@@ -342,7 +342,7 @@ module Discorb
       # Represents the subcommand group.
       #
       class SubcommandGroup < GroupCommand
-        # @return [Array<Discorb::Command::Command::SlashCommand>] The subcommands of the command.
+        # @return [Array<Discorb::ApplicationCommand::Command::SlashCommand>] The subcommands of the command.
         attr_reader :commands
 
         # @!visibility private
@@ -359,11 +359,11 @@ module Discorb
 
         #
         # Add new subcommand.
-        # @param (see Discorb::Command::Handler#slash)
-        # @return [Discorb::Command::Command::SlashCommand] The added subcommand.
+        # @param (see Discorb::ApplicationCommand::Handler#slash)
+        # @return [Discorb::ApplicationCommand::Command::SlashCommand] The added subcommand.
         #
         def slash(command_name, description, options = {}, &block)
-          command = Discorb::Command::Command::SlashCommand.new(command_name, description, options, [], block, 1, @parent + " " + @name)
+          command = Discorb::ApplicationCommand::Command::SlashCommand.new(command_name, description, options, [], block, 1, @parent + " " + @name)
           @commands << command
           @client.bottom_commands << command
           command

data/lib/discorb/client.rb

@@ -41,7 +41,7 @@ module Discorb
     attr_reader :messages
     # @return [Discorb::Logger] The logger.
     attr_reader :log
-    # @return [Array<Discorb::Command::Command>] The commands that the client is using.
+    # @return [Array<Discorb::ApplicationCommand::Command>] The commands that the client is using.
     attr_reader :commands
     # @return [Float] The ping of the client.
     #   @note This will be calculated from heartbeat and heartbeat_ack.
@@ -91,6 +91,7 @@ module Discorb
       @commands = []
       @bottom_commands = []
       @status = :initialized
+      set_default_events
     end
 
     #
@@ -99,14 +100,15 @@ module Discorb
     #
     # @param [Symbol] event_name The name of the event.
     # @param [Symbol] id Custom ID of the event.
-    # @param [Hash] discriminator The discriminator of the event.
+    # @param [Hash] metadata The metadata of the event.
     # @param [Proc] block The block to execute when the event is triggered.
     #
     # @return [Discorb::Event] The event.
     #
-    def on(event_name, id: nil, **discriminator, &block)
-      ne = Event.new(block, id, discriminator)
+    def on(event_name, id: nil, **metadata, &block)
+      ne = Event.new(block, id, metadata)
       @events[event_name] ||= []
+      @events[event_name].delete_if { |e| e.metadata[:override] }
       @events[event_name] << ne
       ne
     end
@@ -118,12 +120,9 @@ module Discorb
     #
     # @return [Discorb::Event] The event.
     #
-    def once(event_name, id: nil, **discriminator, &block)
-      discriminator[:once] = true
-      ne = Event.new(block, id, discriminator)
-      @events[event_name] ||= []
-      @events[event_name] << ne
-      ne
+    def once(event_name, id: nil, **metadata, &block)
+      metadata[:once] = true
+      on(event_name, id: id, **metadata, &block)
     end
 
     #
@@ -174,23 +173,17 @@ module Discorb
         end
         @log.debug "Dispatching event #{event_name}"
         events.each do |block|
-          lambda { |event_args|
+          Async do
             Async(annotation: "Discorb event: #{event_name}") do |task|
               if block.is_a?(Discorb::Event)
-                @events[event_name].delete(block) if block.discriminator[:once]
+                @events[event_name].delete(block) if block.metadata[:once]
               end
-              block.call(*event_args)
+              block.call(*args)
               @log.debug "Dispatched proc with ID #{block.id.inspect}"
             rescue StandardError, ScriptError => e
-              message = "An error occurred while dispatching proc with ID #{block.id.inspect}\n#{e.full_message}"
-              dispatch(:error, event_name, event_args, e)
-              if @log.out
-                @log.error message
-              else
-                warn message
-              end
+              dispatch(:error, event_name, args, e)
             end
-          }.call(args)
+          end
         end
       end
     end
@@ -369,10 +362,11 @@ module Discorb
     def extend(mod)
       if mod.respond_to?(:events)
         @events.each_value do |event|
-          event.delete_if { |c| c.discriminator[:extension] == mod.name }
+          event.delete_if { |c| c.metadata[:extension] == mod.name }
         end
         mod.events.each do |name, events|
-          @events[name] = [] if @events[name].nil?
+          @events[name] ||= []
+          @events[name].delete_if { |c| c.metadata[:override] }
           events.each do |event|
             @events[name] << event
           end
@@ -391,7 +385,7 @@ module Discorb
     end
 
     include Discorb::Gateway::Handler
-    include Discorb::Command::Handler
+    include Discorb::ApplicationCommand::Handler
 
     #
     # Starts the client.
@@ -483,5 +477,12 @@ module Discorb
         @main_task.stop
       end
     end
+
+    def set_default_events
+      on :error, override: true do |event_name, _args, e|
+        message = "An error occurred while dispatching #{event_name}:\n#{e.full_message}"
+        @log.error message, fallback: $stderr
+      end
+    end
   end
 end

data/lib/discorb/color.rb

@@ -130,35 +130,65 @@ module Discorb
     #
     # Create a color from a Discord's color.
     # Currently these colors are supported:
-    #   - teal (0x1abc9c)
-    #   - dark_teal (0x11806a)
-    #   - green (0x2ecc71)
-    #   - dark_green (0x1f8b4c)
-    #   - blue (0x3498db)
-    #   - dark_blue (0x206694)
-    #   - purple (0x9b59b6)
-    #   - dark_purple (0x71368a)
-    #   - magenta (0xe91e63)
-    #   - dark_magenta (0xad1457)
-    #   - gold (0xf1c40f)
-    #   - dark_gold (0xc27c0e)
-    #   - orange (0xe67e22)
-    #   - dark_orange (0xa84300)
-    #   - red (0xe74c3c)
-    #   - dark_red (0x992d22)
-    #   - lighter_grey (0x95a5a6)
-    #   - lighter_gray (0x95a5a6)
-    #   - dark_grey (0x607d8b)
-    #   - dark_gray (0x607d8b)
-    #   - light_grey (0x979c9f)
-    #   - light_gray (0x979c9f)
-    #   - darker_grey (0x546e7a)
-    #   - darker_gray (0x546e7a)
-    #   - og_blurple (0x7289da)
-    #   - blurple (0x5865f2)
-    #   - greyple (0x99aab5)
-    #   - dark_theme (0x36393f)
-    #   - fuchsia (0xeb459e)
+    # | Color Name | Hexadecimal |
+    # |------------|------------|
+    # | `:teal` | `#1abc9c` |
+    # | `:dark_teal` | `#11806a` |
+    # | `:green` | `#2ecc71` |
+    # | `:dark_green` | `#1f8b4c` |
+    # | `:blue` | `#3498db` |
+    # | `:dark_blue` | `#206694` |
+    # | `:purple` | `#9b59b6` |
+    # | `:dark_purple` | `#71368a` |
+    # | `:magenta` | `#e91e63` |
+    # | `:dark_magenta` | `#ad1457` |
+    # | `:gold` | `#f1c40f` |
+    # | `:dark_gold` | `#c27c0e` |
+    # | `:orange` | `#e67e22` |
+    # | `:dark_orange` | `#a84300` |
+    # | `:red` | `#e74c3c` |
+    # | `:dark_red` | `#992d22` |
+    # | `:lighter_grey` | `#95a5a6` |
+    # | `:lighter_gray` | `#95a5a6` |
+    # | `:dark_grey` | `#607d8b` |
+    # | `:dark_gray` | `#607d8b` |
+    # | `:light_grey` | `#979c9f` |
+    # | `:light_gray` | `#979c9f` |
+    # | `:darker_grey` | `#546e7a` |
+    # | `:darker_gray` | `#546e7a` |
+    # | `:og_blurple` | `#7289da` |
+    # | `:blurple` | `#5865f2` |
+    # | `:greyple` | `#99aab5` |
+    # | `:dark_theme` | `#36393f` |
+    # | `:fuchsia` | `#eb459e` |
+    # | `:dark_teal` | `#11806a` |
+    # | `:green` | `#2ecc71` |
+    # | `:dark_green` | `#1f8b4c` |
+    # | `:blue` | `#3498db` |
+    # | `:dark_blue` | `#206694` |
+    # | `:purple` | `#9b59b6` |
+    # | `:dark_purple` | `#71368a` |
+    # | `:magenta` | `#e91e63` |
+    # | `:dark_magenta` | `#ad1457` |
+    # | `:gold` | `#f1c40f` |
+    # | `:dark_gold` | `#c27c0e` |
+    # | `:orange` | `#e67e22` |
+    # | `:dark_orange` | `#a84300` |
+    # | `:red` | `#e74c3c` |
+    # | `:dark_red` | `#992d22` |
+    # | `:lighter_grey` | `#95a5a6` |
+    # | `:lighter_gray` | `#95a5a6` |
+    # | `:dark_grey` | `#607d8b` |
+    # | `:dark_gray` | `#607d8b` |
+    # | `:light_grey` | `#979c9f` |
+    # | `:light_gray` | `#979c9f` |
+    # | `:darker_grey` | `#546e7a` |
+    # | `:darker_gray` | `#546e7a` |
+    # | `:og_blurple` | `#7289da` |
+    # | `:blurple` | `#5865f2` |
+    # | `:greyple` | `#99aab5` |
+    # | `:dark_theme` | `#36393f` |
+    # | `:fuchsia` | `#eb459e` |
     #
     # @param [Symbol] color A Discord color name.
     #

data/lib/discorb/common.rb

@@ -4,7 +4,7 @@ module Discorb
   # @return [String] The API base URL.
   API_BASE_URL = "https://discord.com/api/v9"
   # @return [String] The version of discorb.
-  VERSION = "0.6.0"
+  VERSION = "0.7.2"
   # @return [String] The user agent for the bot.
   USER_AGENT = "DiscordBot (https://github.com/discorb-lib/discorb #{VERSION}) Ruby/#{RUBY_VERSION}"
 

data/lib/discorb/embed.rb

@@ -93,18 +93,18 @@ module Discorb
     # @return [Hash] Converted embed.
     #
     def to_hash
-      {
-        title: @title,
-        description: @description,
-        url: @url,
-        timestamp: @timestamp&.iso8601,
-        color: @color&.to_i,
-        footer: @footer&.to_hash,
-        image: @image&.to_hash,
-        thumbnail: @thumbnail&.to_hash,
-        author: @author&.to_hash,
-        fields: @fields&.map { |f| f.to_hash },
-      }
+      ret = { type: "rich" }
+      ret[:title] = @title if @title
+      ret[:description] = @description if @description
+      ret[:url] = @url if @url
+      ret[:timestamp] = @timestamp&.iso8601 if @timestamp
+      ret[:color] = @color&.to_i if @color
+      ret[:footer] = @footer&.to_hash if @footer
+      ret[:image] = @image&.to_hash if @image
+      ret[:thumbnail] = @thumbnail&.to_hash if @thumbnail
+      ret[:author] = @author&.to_hash if @author
+      ret[:fields] = @fields&.map { |f| f.to_hash } if @fields.any?
+      ret
     end
 
     #

data/lib/discorb/error.rb

@@ -94,7 +94,7 @@ module Discorb
       @client.close!
       DiscorbError.instance_method(:initialize).bind(self).call(<<~MESSAGE)
         The client is banned from CloudFlare.
-        Hint: Try to increase the number of requests per second, e.g. Use sleep in between requests.
+        Hint: Try to decrease the number of requests per second, e.g. Use sleep in between requests.
       MESSAGE
     end
   end

data/lib/discorb/event.rb

@@ -11,17 +11,17 @@ module Discorb
     attr_reader :block
     # @return [Symbol] the event id.
     attr_reader :id
-    # @return [Hash] the event discriminator.
-    attr_reader :discriminator
+    # @return [Hash] the event metadata.
+    attr_reader :metadata
     # @return [Boolean] whether the event is once or not.
     attr_reader :once
     alias once? once
 
-    def initialize(block, id, discriminator)
+    def initialize(block, id, metadata)
       @block = block
       @id = id
-      @once = discriminator.fetch(:once, false)
-      @discriminator = discriminator
+      @once = metadata.fetch(:once, false)
+      @metadata = metadata
       @rescue = nil
     end
 

data/lib/discorb/extension.rb

@@ -8,7 +8,7 @@ module Discorb
   # @abstract
   #
   module Extension
-    include Discorb::Command::Handler
+    include Discorb::ApplicationCommand::Handler
     undef setup_commands
 
     @events = {}
@@ -19,18 +19,18 @@ module Discorb
     #
     # @param [Symbol] event_name The name of the event.
     # @param [Symbol] id The id of the event. Used to delete the event.
-    # @param [Hash] discriminator Other discriminators.
+    # @param [Hash] metadata Other metadata.
     # @param [Proc] block The block to execute when the event is triggered.
     #
     # @return [Discorb::Event] The event.
     #
-    def event(event_name, id: nil, **discriminator, &block)
+    def event(event_name, id: nil, **metadata, &block)
       raise ArgumentError, "Event name must be a symbol" unless event_name.is_a?(Symbol)
       raise ArgumentError, "block must be a Proc" unless block.is_a?(Proc)
 
       @events[event_name] ||= []
-      discriminator[:extension] = self.name
-      @events[event_name] << Discorb::Event.new(block, id, discriminator)
+      metadata[:extension] = self.name
+      @events[event_name] << Discorb::Event.new(block, id, metadata)
     end
 
     #
@@ -38,18 +38,18 @@ module Discorb
     #
     # @param [Symbol] event_name The name of the event.
     # @param [Symbol] id The id of the event. Used to delete the event.
-    # @param [Hash] discriminator Other discriminators.
+    # @param [Hash] metadata Other metadata.
     # @param [Proc] block The block to execute when the event is triggered.
     #
     # @return [Discorb::Event] The event.
     #
-    def once_event(event_name, id: nil, **discriminator, &block)
-      event(event_name, id: id, once: true, **discriminator, &block)
+    def once_event(event_name, id: nil, **metadata, &block)
+      event(event_name, id: id, once: true, **metadata, &block)
     end
 
     # @return [Hash{Symbol => Array<Discorb::Event>}] The events of the extension.
     attr_reader :events
-    # @return [Array<Discorb::Command::Command>] The commands of the extension.
+    # @return [Array<Discorb::ApplicationCommand::Command>] The commands of the extension.
     attr_reader :commands
     # @private
     attr_reader :bottom_commands

data/lib/discorb/gateway.rb

@@ -53,6 +53,12 @@ module Discorb
       attr_reader :member
       # @return [Discorb::UnicodeEmoji, Discorb::PartialEmoji] The emoji that was reacted with.
       attr_reader :emoji
+      # @macro client_cache
+      # @return [Discorb::Member, Discorb::User] The user or member who reacted.
+      attr_reader :fired_by
+
+      alias reactor fired_by
+      alias from fired_by
 
       # @!visibility private
       def initialize(client, data)
@@ -79,6 +85,8 @@ module Discorb
             end
         end
 
+        @fired_by = @member || @user || @client.users[data[:user_id]]
+
         @message = client.messages[data[:message_id]]
         @emoji = data[:emoji][:id].nil? ? UnicodeEmoji.new(data[:emoji][:name]) : PartialEmoji.new(data[:emoji])
       end
@@ -355,6 +363,9 @@ module Discorb
     class TypingStartEvent < GatewayEvent
       # @return [Discorb::Snowflake] The ID of the channel the user is typing in.
       attr_reader :user_id
+      # @macro client_cache
+      # @return [Discorb::Member] The member that is typing.
+      attr_reader :member
 
       # @!attribute [r] channel
       #   @macro client_cache
@@ -365,6 +376,9 @@ module Discorb
       # @!attribute [r] user
       #   @macro client_cache
       #   @return [Discorb::User] The user that is typing.
+      # @!attribute [r] fired_by
+      #   @macro client_cache
+      #   @return [Discorb::Member, Discorb::User] The member or user that started typing.
 
       # @!visibility private
       def initialize(client, data)
@@ -388,6 +402,12 @@ module Discorb
       def guild
         @client.guilds[@guild_id]
       end
+
+      def fired_by
+        @member || user
+      end
+
+      alias from fired_by
     end
 
     #
@@ -584,10 +604,10 @@ module Discorb
           @session_id = data[:session_id]
           @user = ClientUser.new(self, data[:user])
           @uncached_guilds = data[:guilds].map { |g| g[:id] }
-          if @uncached_guilds == []
+          if @uncached_guilds == [] or !@intents.guilds
             @ready = true
             dispatch(:ready)
-            @log.info("Guilds were cached")
+            @log.info("Successfully connected to Discord.")
           end
           @tasks << handle_heartbeat(@heartbeat_interval)
         when "GUILD_CREATE"
@@ -597,7 +617,7 @@ module Discorb
             if @uncached_guilds == []
               @ready = true
               dispatch(:ready)
-              @log.info("Guilds were cached")
+              @log.info("Successfully connected to Discord, and cached all guilds.")
             end
           elsif @guilds.has?(data[:id])
             @guilds[data[:id]].send(:_set_data, data)

data/lib/discorb/integration.rb

@@ -80,7 +80,7 @@ module Discorb
       @enable_emoticons = data[:enable_emoticons]
       @expire_behavior = self.class.expire_behavior[data[:expire_behavior]]
       @expire_grace_period = data[:expire_grace_period]
-      @user = client.users[data[:user].to_i]
+      @user = @client.users[data[:user].to_i]
       @account = Account.new(data[:account])
       @subscriber_count = data[:subscriber_count]
       @revoked = data[:revoked]

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,