discorb 0.18.0 → 0.20.0

data/sig/discorb/interaction/base.rbs

@@ -12,12 +12,45 @@ module Discorb
     # @param [Hash] data The data of the interaction.
     def initialize: (Discorb::Client client, Discorb::json data) -> void
 
+    %a{pure}
     def guild: -> Discorb::Guild?
 
+    %a{pure}
     def channel: -> Discorb::Channel
 
+    %a{pure}
     def inspect: -> String
 
+    #
+    # Edit the original response message.
+    # @async
+    # @macro edit
+    #
+    # @param [String] content The new content of the message.
+    # @param [Discorb::Embed] embed The new embed of the message.
+    # @param [Array<Discorb::Embed>] embeds The new embeds of the message.
+    # @param [Array<Discorb::Attachment>] attachments The attachments to remain.
+    # @param [Discorb::Attachment] file The file to send.
+    # @param [Array<Discorb::Attachment>] files The files to send.
+    #
+    # @return [Async::Task<void>] The task.
+    def edit_original_message: (
+      ?String? content,
+      ?embed: Discorb::Embed?,
+      ?embeds: ::Array[Discorb::Embed]?,
+      ?attachment: Discorb::Attachment?,
+      ?attachments: ::Array[Discorb::Attachment]?,
+      ?components: (::Array[Discorb::Component]
+      | ::Array[::Array[Discorb::Component]])?
+    ) -> Async::Task[void]
+
+    #
+    # Delete the original response message.
+    # @async
+    #
+    # @return [Async::Task<void>] The task.
+    def delete_original_message: -> Async::Task[void]
+
     #
     # Create a new Interaction instance from the data.
     # @private
@@ -62,5 +95,8 @@ module Discorb
     # @return [Symbol] The locale of the guild that created the interaction.
     # @note This modifies the language code, `-` will be replaced with `_`.
     attr_reader guild_locale: Symbol
+
+    # @return [Discorb::Permission] The permissions of the bot.
+    attr_reader app_permissions: Discorb::Permission
   end
 end

data/sig/discorb/interaction/message_component.rbs

@@ -107,8 +107,7 @@ module Discorb
       ?components: (::Array[Discorb::Component]
       | ::Array[::Array[Discorb::Component]])?,
       ?ephemeral: bool
-    ) -> (Discorb::Interaction::SourceResponder::CallbackMessage
-    | Discorb::Webhook::Message)
+    ) -> (Discorb::Interaction::CallbackMessage | Discorb::Webhook::Message)
 
     # @return [String] The content of the response.
     attr_reader custom_id: String

data/sig/discorb/interaction/modal.rbs

@@ -38,8 +38,7 @@ module Discorb
       ?components: (::Array[Discorb::Component]
       | ::Array[::Array[Discorb::Component]])?,
       ?ephemeral: bool
-    ) -> (Discorb::Interaction::SourceResponder::CallbackMessage
-    | Discorb::Webhook::Message)
+    ) -> (Discorb::Interaction::CallbackMessage | Discorb::Webhook::Message)
 
     # @return [String] The custom id of the modal.
     attr_reader custom_id: String

data/sig/discorb/interaction/responder.rbs

@@ -41,59 +41,59 @@ module Discorb
         ?components: (::Array[Discorb::Component]
         | ::Array[::Array[Discorb::Component]])?,
         ?ephemeral: bool
-      ) -> (Discorb::Interaction::SourceResponder::CallbackMessage
-      | Discorb::Webhook::Message)
+      ) -> (Discorb::Interaction::CallbackMessage | Discorb::Webhook::Message)
+    end
 
-      #
-      # Represents of a callback message of interaction.
-      class CallbackMessage
-        #
-        # Initializes a new instance of CallbackMessage.
-        # @private
-        #
-        # @param [Client] client The client.
-        # @param [Hash] data The payload.
-        # @param [String] application_id The application ID.
-        # @param [String] token The token.
-        def initialize: (
-          Client client,
-          Discorb::json data,
-          String application_id,
-          String token
-        ) -> void
+    #
+    # Represents of a callback message of interaction.
+    class CallbackMessage
+      #
+      # Initializes a new instance of CallbackMessage.
+      # @private
+      #
+      # @param [Client] client The client.
+      # @param [Hash] data The payload.
+      # @param [String] application_id The application ID.
+      # @param [String] token The token.
+      def initialize: (
+        Client client,
+        Discorb::json data,
+        String application_id,
+        String token
+      ) -> void
 
-        #
-        # Edits the callback message.
-        # @async
-        # @macro edit
-        #
-        # @param [String] content The new content of the message.
-        # @param [Discorb::Embed] embed The new embed of the message.
-        # @param [Array<Discorb::Embed>] embeds The new embeds of the message.
-        # @param [Array<Discorb::Attachment>] attachments The attachments to remain.
-        # @param [Discorb::Attachment] file The file to send.
-        # @param [Array<Discorb::Attachment>] files The files to send.
-        #
-        # @return [Async::Task<void>] The task.
-        def edit: (
-          ?String content,
-          ?embed: Discorb::Embed,
-          ?embeds: ::Array[Discorb::Embed],
-          ?file: Discorb::Attachment,
-          ?files: ::Array[Discorb::Attachment],
-          ?attachments: ::Array[Discorb::Attachment]
-        ) -> Async::Task[void]
+      #
+      # Edits the callback message.
+      # @async
+      # @macro edit
+      #
+      # @param [String] content The new content of the message.
+      # @param [Discorb::Embed] embed The new embed of the message.
+      # @param [Array<Discorb::Embed>] embeds The new embeds of the message.
+      # @param [Array<Discorb::Attachment>] attachments The attachments to remain.
+      # @param [Discorb::Attachment] file The file to send.
+      # @param [Array<Discorb::Attachment>] files The files to send.
+      #
+      # @return [Async::Task<void>] The task.
+      def edit: (
+        ?String content,
+        ?embed: Discorb::Embed,
+        ?embeds: ::Array[Discorb::Embed],
+        ?file: Discorb::Attachment,
+        ?files: ::Array[Discorb::Attachment],
+        ?attachments: ::Array[Discorb::Attachment]
+      ) -> Async::Task[void]
 
-        #
-        # Deletes the callback message.
-        # @async
-        # @note This will fail if the message is ephemeral.
-        #
-        # @return [Async::Task<void>] The task.
-        def delete!: -> Async::Task[void]
+      #
+      # Deletes the callback message.
+      # @async
+      # @note This will fail if the message is ephemeral.
+      #
+      # @return [Async::Task<void>] The task.
+      def delete: -> Async::Task[void]
 
-        def inspect: -> String
-      end
+      %a{pure}
+      def inspect: -> String
     end
 
     #

data/sig/discorb/invite.rbs

@@ -20,7 +20,7 @@ module Discorb
     # Delete the invite.
     # @async
     # @return [Async::Task<void>] The task.
-    def delete!: (?reason: String) -> Async::Task[void]
+    def delete: (?reason: String?) -> Async::Task[void]
 
     # @return [String] The code of invite.
     attr_reader code: String

data/sig/discorb/member.rbs

@@ -21,8 +21,10 @@ module Discorb
     # Format the member to `Username#Discriminator` style.
     #
     # @return [String] The formatted member.
+    %a{pure}
     def to_s: -> String
 
+    %a{pure}
     def inspect: -> String
 
     #

data/sig/discorb/message.rbs

@@ -68,7 +68,7 @@ module Discorb
     # @param [String] reason The reason for deleting the message.
     #
     # @return [Async::Task<void>] The task.
-    def delete!: (?reason: String?) -> Async::Task[void]
+    def delete: (?reason: String?) -> Async::Task[void]
 
     #
     # Convert the message to reference object.
@@ -171,6 +171,7 @@ module Discorb
     ) -> Async::Task[Discorb::ThreadChannel]
 
     # Meta
+    %a{pure}
     def inspect: -> String
 
     # @return [Discorb::Snowflake] The ID of the message.
@@ -343,6 +344,7 @@ module Discorb
     # |`1 << 5`|`:has_thread`|
     # |`1 << 6`|`:ephemeral`|
     # |`1 << 7`|`:loading`|
+    # |`1 << 8`|`:failed_to_mention_some_roles_in_thread`|
     class Flag < Discorb::Flag
       attr_accessor crossposted: bool
       attr_accessor crosspost: bool
@@ -352,6 +354,7 @@ module Discorb
       attr_accessor has_thread: bool
       attr_accessor ephemeral: bool
       attr_accessor loading: bool
+      attr_accessor failed_to_mention_some_roles_in_thread: bool
     end
 
     #
@@ -386,6 +389,7 @@ module Discorb
       # @see https://discord.com/developers/docs/resources/channel#message-reference-object
       def self.from_hash: (Discorb::json data) -> Discorb::Message::Reference
 
+      %a{pure}
       def inspect: -> String
 
       # @return [Discorb::Snowflake] The guild ID.
@@ -406,6 +410,7 @@ module Discorb
     class Sticker
       def initialize: (untyped data) -> void
 
+      %a{pure}
       def inspect: -> String
 
       # @return [Discorb::Snowflake] The sticker ID.
@@ -429,6 +434,7 @@ module Discorb
       # @param [Hash] data The interaction data.
       def initialize: (Discorb::Client client, Discorb::json data) -> void
 
+      %a{pure}
       def inspect: -> String
 
       # @return [Discorb::Snowflake] The interaction ID.
@@ -457,6 +463,7 @@ module Discorb
       # @param [Hash] data The activity data.
       def initialize: (Discorb::json data) -> void
 
+      %a{pure}
       def inspect: -> String
 
       # @return [String] The name of activity.

data/sig/discorb/messageable.rbs

@@ -72,10 +72,7 @@ module Discorb
     # @param [String] reason The reason for deleting the message.
     #
     # @return [Async::Task<void>] The task.
-    def delete_message!: (
-      _ToS message_id,
-      ?reason: String?
-    ) -> Async::Task[void]
+    def delete_message: (_ToS message_id, ?reason: String?) -> Async::Task[void]
 
     #
     # Fetch a message from ID.

data/sig/discorb/partial_emoji.rbs

@@ -13,14 +13,17 @@ module Discorb
     # Format the emoji for URI.
     #
     # @return [String] the formatted emoji.
+    %a{pure}
     def to_uri: -> String
 
+    %a{pure}
     def inspect: -> String
 
     #
     # Format the emoji for sending.
     #
     # @return [String] the formatted emoji.
+    %a{pure}
     def to_s: -> String
 
     # @return [Discorb::Snowflake] The ID of the emoji.

data/sig/discorb/permissions.rbs

@@ -91,20 +91,26 @@ module Discorb
     # @param deny [Integer] The denied permissions.
     def initialize: (Integer allow, Integer deny) -> void
 
+    %a{pure}
     def allow: -> Discorb::Permission
 
+    %a{pure}
     def deny: -> Discorb::Permission
 
+    %a{pure}
     def allow_value: -> Integer
 
+    %a{pure}
     def deny_value: -> Integer
 
+    %a{pure}
     def inspect: -> String
 
     #
     # Converts the permission overwrite to a hash.
     #
     # @return [Hash] The permission overwrite as a hash.
+    %a{pure}
     def to_hash: -> Hash[Symbol, bool]
 
     #
@@ -121,6 +127,7 @@ module Discorb
     # @param [Symbol] field The field to check.
     #
     # @return [true, false, nil] Whether the field is allowed, denied or not set.
+    %a{pure}
     def []: (Symbol field) -> bool?
 
     #

data/sig/discorb/presence.rbs

@@ -10,6 +10,7 @@ module Discorb
     # @param [Hash] data The data of the presence.
     def initialize: (Discorb::Client client, Discorb::json data) -> void
 
+    %a{pure}
     def inspect: -> String
 
     # @return [:online, :idle, :dnd, :offline] The status of the user.
@@ -46,6 +47,7 @@ module Discorb
       # Convert the activity to a string.
       #
       # @return [String] The string representation of the activity.
+      %a{pure}
       def to_s: -> String
 
       # @return [String] The name of the activity.

data/sig/discorb/reaction.rbs

@@ -16,7 +16,11 @@ module Discorb
     # @param (see Message#fetch_reacted_users)
     #
     # @return [Async::Task<Array<Discorb::User>>] The users that reacted with this emoji.
-    def fetch_users: -> Async::Task[::Array[Discorb::User]]
+    def fetch_users: (
+      Discorb::emoji emoji,
+      ?limit: Integer?,
+      ?after: Discorb::Snowflake?
+    ) -> Async::Task[::Array[Discorb::User]]
 
     # @return [Integer] The number of users that have reacted with this emoji.
     attr_reader count: Integer

data/sig/discorb/role.rbs

@@ -17,6 +17,7 @@ module Discorb
       Discorb::json data
     ) -> void
 
+    %a{pure}
     def icon: -> (Discorb::Asset | Discorb::emoji | nil)
 
     #
@@ -31,12 +32,16 @@ module Discorb
     # Formats the role as a string.
     #
     # @return [String] The formatted string.
+    %a{pure}
     def to_s: -> String
 
+    %a{pure}
     def mention: -> String
 
+    %a{pure}
     def color?: -> bool
 
+    %a{pure}
     def inspect: -> String
 
     #
@@ -79,8 +84,9 @@ module Discorb
     # @param [String] reason The reason for deleting the role.
     #
     # @return [Async::Task<void>] The task.
-    def delete!: (?reason: String?) -> Async::Task[void]
+    def delete: (?reason: String?) -> Async::Task[void]
 
+    %a{pure}
     def tag: -> Discorb::Role::Tag
 
     # @return [Discorb::Snowflake] The ID of the role.

data/sig/discorb/scheduled_event.rbs

@@ -57,7 +57,7 @@ module Discorb
     # @async
     #
     # @return [Async::Task<void>] The task.
-    def delete!: -> Async::Task[void]
+    def delete: -> Async::Task[void]
 
     #
     # Fetches the event users.
@@ -139,6 +139,7 @@ module Discorb
       # @!visibility private
       def initialize: (untyped data) -> void
 
+      %a{pure}
       def inspect: -> String
 
       # @return [String, nil] The location of the event. Only present if the event is a external event.

data/sig/discorb/shard.rbs

@@ -27,8 +27,9 @@ module Discorb
     # Stops the shard.
     #
     # @return [void]
-    def close!: -> void
+    def close: -> void
 
+    %a{pure}
     def inspect: -> String
 
     # @return [Integer] The ID of the shard.

data/sig/discorb/snowflake.rbs

@@ -24,8 +24,10 @@ module Discorb
     def eql?: (untyped other) -> bool
 
     # Return hash of snowflake.
+    %a{pure}
     def hash: -> untyped
 
+    %a{pure}
     def inspect: -> String
 
     # Timestamp of snowflake.

data/sig/discorb/stage_instance.rbs

@@ -15,16 +15,22 @@ module Discorb
       ?no_cache: bool
     ) -> void
 
-    def guild: -> untyped
+    %a{pure}
+    def guild: -> Discorb::Guild
 
-    def channel: -> untyped
+    %a{pure}
+    def channel: -> Discorb::StageChannel
 
+    %a{pure}
     def discoverable?: -> bool
 
+    %a{pure}
     def public?: -> bool
 
+    %a{pure}
     def guild_only?: -> bool
 
+    %a{pure}
     def inspect: -> String
 
     #
@@ -49,7 +55,7 @@ module Discorb
     # @param [String] reason The reason for deleting the stage instance.
     #
     # @return [Async::Task<void>] The task.
-    def delete!: (?reason: String?) -> Async::Task[void]
+    def delete: (?reason: String?) -> Async::Task[void]
 
     # @return [Discorb::Snowflake] The ID of the guild this voice state is for.
     attr_reader id: Discorb::Snowflake

data/sig/discorb/sticker.rbs

@@ -75,7 +75,7 @@ module Discorb
       # @async
       #
       # @param [String] reason The reason for the deletion.
-      def delete!: (?reason: String?) -> untyped
+      def delete: (?reason: String?) -> untyped
 
       # @!attribute [r] guild
       #   @macro client_cache

data/sig/discorb/unicode_emoji.rbs

@@ -10,14 +10,17 @@ module Discorb
     def initialize: (String name, ?tone: Integer) -> void
 
     # @return [String] The unicode string of the emoji.
+    %a{pure}
     def to_s: -> String
 
     #
     # Format the emoji for URI.
     #
     # @return [String] the formatted emoji.
+    %a{pure}
     def to_uri: -> String
 
+    %a{pure}
     def inspect: -> String
 
     #
@@ -25,6 +28,7 @@ module Discorb
     # @private
     #
     # @return [Hash] The hash represents the object.
+    %a{pure}
     def to_hash: -> Discorb::json
 
     # @return [String] The name of the emoji. (e.g. :grinning:)

data/sig/discorb/user.rbs

@@ -16,8 +16,10 @@ module Discorb
     # Format the user as `Username#Discriminator` style.
     #
     # @return [String] The formatted username.
+    %a{pure}
     def to_s: -> String
 
+    %a{pure}
     def inspect: -> String
 
     #
@@ -61,33 +63,35 @@ module Discorb
     #
     # Represents the user's flags.
     # ## Flag fields
-    # |`1 << 0`|`:discord_employee`|
-    # |`1 << 1`|`:partnered_server_owner`|
-    # |`1 << 2`|`:hypesquad_events`|
+    # |`1 << 0`|`:staff`|
+    # |`1 << 1`|`:partner`|
+    # |`1 << 2`|`:hypesquad`|
     # |`1 << 3`|`:bug_hunter_level_1`|
-    # |`1 << 6`|`:house_bravery`|
-    # |`1 << 7`|`:house_brilliance`|
-    # |`1 << 8`|`:house_balance`|
-    # |`1 << 9`|`:early_supporter`|
-    # |`1 << 10`|`:team_user`|
+    # |`1 << 6`|`:hypesquad_online_house_1`|
+    # |`1 << 7`|`:hypesquad_online_house_2`|
+    # |`1 << 8`|`:hypesquad_online_house_3`|
+    # |`1 << 9`|`:premium_early_supporter`|
+    # |`1 << 10`|`:team_psuedo_user`|
     # |`1 << 14`|`:bug_hunter_level_2`|
     # |`1 << 16`|`:verified_bot`|
-    # |`1 << 17`|`:early_verified_bot_developer`|
-    # |`1 << 18`|`:discord_certified_moderator`|
+    # |`1 << 17`|`:verified_developer`|
+    # |`1 << 18`|`:certified_moderator`|
+    # |`1 << 19`|`:bot_http_interactions`|
     class Flag < Discorb::Flag
-      attr_accessor discord_employee: bool
-      attr_accessor partnered_server_owner: bool
-      attr_accessor hypesquad_events: bool
+      attr_accessor staff: bool
+      attr_accessor partner: bool
+      attr_accessor hypesquad: bool
       attr_accessor bug_hunter_level_1: bool
-      attr_accessor house_bravery: bool
-      attr_accessor house_brilliance: bool
-      attr_accessor house_balance: bool
-      attr_accessor early_supporter: bool
-      attr_accessor team_user: bool
+      attr_accessor hypesquad_online_house_1: bool
+      attr_accessor hypesquad_online_house_2: bool
+      attr_accessor hypesquad_online_house_3: bool
+      attr_accessor premium_early_supporter: bool
+      attr_accessor team_psuedo_user: bool
       attr_accessor bug_hunter_level_2: bool
       attr_accessor verified_bot: bool
-      attr_accessor early_verified_bot_developer: bool
-      attr_accessor discord_certified_moderato: bool
+      attr_accessor verified_developer: bool
+      attr_accessor certified_moderator: bool
+      attr_accessor bot_http_interactions: bool
     end
   end
 end

data/sig/discorb/webhook.rbs

@@ -11,6 +11,7 @@ module Discorb
     # @param [Hash] data The data of the webhook.
     def initialize: (Discorb::Client client, Discorb::json data) -> void
 
+    %a{pure}
     def inspect: -> String
 
     #
@@ -64,7 +65,7 @@ module Discorb
     # @async
     #
     # @return [Async::Task<void>] The task.
-    def delete!: -> Async::Task[void]
+    def delete: -> Async::Task[void]
 
     #
     # Edits the webhook's message.
@@ -98,9 +99,7 @@ module Discorb
     # @param [Discorb::Webhook::Message] message The message to delete.
     #
     # @return [Async::Task<void>] The task.
-    def delete_message!: (
-      Discorb::Webhook::Message message
-    ) -> Async::Task[void]
+    def delete_message: (Discorb::Webhook::Message message) -> Async::Task[void]
 
     #
     # Creates URLWebhook.
@@ -209,6 +208,7 @@ module Discorb
         # @param [Hash] data The data of the guild.
         def initialize: (Discorb::json data) -> void
 
+        %a{pure}
         def inspect: -> String
 
         # @return [Discorb::Snowflake] The ID of the guild.
@@ -231,6 +231,7 @@ module Discorb
         # @param [Hash] data The data of the channel.
         def initialize: (Discorb::json data) -> void
 
+        %a{pure}
         def inspect: -> String
 
         # @return [Discorb::Snowflake] The ID of the channel.
@@ -272,14 +273,22 @@ module Discorb
       # @param (see Webhook#edit_message)
       #
       # @return [Async::Task<void>] The task.
-      def edit: -> Async::Task[void]
+      def edit: (
+        ?String content,
+        ?embed: Discorb::Embed,
+        ?embeds: ::Array[Discorb::Embed],
+        ?file: Discorb::Attachment,
+        ?files: ::Array[Discorb::Attachment],
+        ?attachments: ::Array[Discorb::Attachment],
+        ?allowed_mentions: Discorb::AllowedMentions
+      ) -> Async::Task[void]
 
       #
       # Deletes the message.
       # @async
       #
       # @return [Async::Task<void>] The task.
-      def delete!: -> Async::Task[void]
+      def delete: -> Async::Task[void]
 
       # @return [Discorb::Snowflake] The ID of the channel.
       attr_reader channel_id: Discorb::Snowflake
@@ -301,8 +310,10 @@ module Discorb
         # Format author with `Name#Discriminator` style.
         #
         # @return [String] Formatted author.
+        %a{pure}
         def to_s: -> String
 
+        %a{pure}
         def inspect: -> String
 
         # @return [Boolean] Whether the author is a bot.

data/sig/discorb/welcome_screen.rbs

@@ -44,6 +44,7 @@ module Discorb
       #
       # @return [Hash] The hash.
       # @see https://discord.com/developers/docs/resources/guild#welcome-screen-object
+      %a{pure}
       def to_hash: -> Discorb::json
 
       #