onyxcord 2.1.0 → 3.2.0

data/lib/onyxcord/events/handlers/guilds.rb

@@ -0,0 +1,375 @@
+# frozen_string_literal: true
+
+module OnyxCord
+  module EventContainer
+    # This **event** is raised when a new user joins a server.
+    # @param attributes [Hash] The event's attributes.
+    # @option attributes [String] :username Matches the username of the joined user.
+    # @yield The block is executed when the event is raised.
+    # @yieldparam event [ServerMemberAddEvent] The event that was raised.
+    # @return [ServerMemberAddEventHandler] the event handler that was registered.
+    def member_join(attributes = {}, &block)
+      register_event(ServerMemberAddEvent, attributes, block)
+    end
+
+    # This **event** is raised when a member update happens. This includes when a members nickname
+    # or roles are updated.
+    # @param attributes [Hash] The event's attributes.
+    # @option attributes [String] :username Matches the username of the updated user.
+    # @yield The block is executed when the event is raised.
+    # @yieldparam event [ServerMemberUpdateEvent] The event that was raised.
+    # @return [ServerMemberUpdateEventHandler] the event handler that was registered.
+
+    # This **event** is raised when a member update happens. This includes when a members nickname
+    # or roles are updated.
+    # @param attributes [Hash] The event's attributes.
+    # @option attributes [String] :username Matches the username of the updated user.
+    # @yield The block is executed when the event is raised.
+    # @yieldparam event [ServerMemberUpdateEvent] The event that was raised.
+    # @return [ServerMemberUpdateEventHandler] the event handler that was registered.
+    def member_update(attributes = {}, &block)
+      register_event(ServerMemberUpdateEvent, attributes, block)
+    end
+
+    # This **event** is raised when a member leaves a server.
+    # @param attributes [Hash] The event's attributes.
+    # @option attributes [String] :username Matches the username of the member.
+    # @yield The block is executed when the event is raised.
+    # @yieldparam event [ServerMemberDeleteEvent] The event that was raised.
+    # @return [ServerMemberDeleteEventHandler] the event handler that was registered.
+
+    # This **event** is raised when a member leaves a server.
+    # @param attributes [Hash] The event's attributes.
+    # @option attributes [String] :username Matches the username of the member.
+    # @yield The block is executed when the event is raised.
+    # @yieldparam event [ServerMemberDeleteEvent] The event that was raised.
+    # @return [ServerMemberDeleteEventHandler] the event handler that was registered.
+    def member_leave(attributes = {}, &block)
+      register_event(ServerMemberDeleteEvent, attributes, block)
+    end
+
+    # This **event** is raised when a user is banned from a server.
+    # @param attributes [Hash] The event's attributes.
+    # @option attributes [String, Integer, User] :user Matches the user that was banned.
+    # @option attributes [String, Integer, Server] :server Matches the server from which the user was banned.
+    # @yield The block is executed when the event is raised.
+    # @yieldparam event [UserBanEvent] The event that was raised.
+    # @return [UserBanEventHandler] the event handler that was registered.
+
+    # This **event** is raised when a user is banned from a server.
+    # @param attributes [Hash] The event's attributes.
+    # @option attributes [String, Integer, User] :user Matches the user that was banned.
+    # @option attributes [String, Integer, Server] :server Matches the server from which the user was banned.
+    # @yield The block is executed when the event is raised.
+    # @yieldparam event [UserBanEvent] The event that was raised.
+    # @return [UserBanEventHandler] the event handler that was registered.
+    def user_ban(attributes = {}, &block)
+      register_event(UserBanEvent, attributes, block)
+    end
+
+    # This **event** is raised whenever an audit log entry is created in a server.
+    # @param attributes [Hash] The event's attributes.
+    # @option attributes [String, Integer, Server] :server Matches the server the entry was created in.
+    # @option attributes [String, Symbol, Integer] :action Matches the type of the entry.
+    # @option attributes [String, Regexp] :reason Matches the reason associated with the entry.
+    # @option attributes [String, Integer, User, Member, Recipient] :user Matches the user or bot that made the changes.
+    # @option attributes [String, Integer, #resolve_id] :target Matches the ID of the affected entity.
+    # @yield The block is executed when the event is raised.
+    # @yieldparam event [AuditLogEntryCreateEvent] The event that was raised.
+    # @return [AuditLogEntryCreateEventHandler] the event handler that was registered.
+
+    # This **event** is raised whenever an audit log entry is created in a server.
+    # @param attributes [Hash] The event's attributes.
+    # @option attributes [String, Integer, Server] :server Matches the server the entry was created in.
+    # @option attributes [String, Symbol, Integer] :action Matches the type of the entry.
+    # @option attributes [String, Regexp] :reason Matches the reason associated with the entry.
+    # @option attributes [String, Integer, User, Member, Recipient] :user Matches the user or bot that made the changes.
+    # @option attributes [String, Integer, #resolve_id] :target Matches the ID of the affected entity.
+    # @yield The block is executed when the event is raised.
+    # @yieldparam event [AuditLogEntryCreateEvent] The event that was raised.
+    # @return [AuditLogEntryCreateEventHandler] the event handler that was registered.
+    def audit_log_entry(attributes = {}, &block)
+      register_event(AuditLogEntryCreateEvent, attributes, block)
+    end
+
+    # This **event** is raised when a user is unbanned from a server.
+    # @param attributes [Hash] The event's attributes.
+    # @option attributes [String, Integer, User] :user Matches the user that was unbanned.
+    # @option attributes [String, Integer, Server] :server Matches the server from which the user was unbanned.
+    # @yield The block is executed when the event is raised.
+    # @yieldparam event [UserUnbanEvent] The event that was raised.
+    # @return [UserUnbanEventHandler] the event handler that was registered.
+
+    # This **event** is raised when a user is unbanned from a server.
+    # @param attributes [Hash] The event's attributes.
+    # @option attributes [String, Integer, User] :user Matches the user that was unbanned.
+    # @option attributes [String, Integer, Server] :server Matches the server from which the user was unbanned.
+    # @yield The block is executed when the event is raised.
+    # @yieldparam event [UserUnbanEvent] The event that was raised.
+    # @return [UserUnbanEventHandler] the event handler that was registered.
+    def user_unban(attributes = {}, &block)
+      register_event(UserUnbanEvent, attributes, block)
+    end
+
+    # This **event** is raised when a server is created respective to the bot, i.e. the bot joins a server or creates
+    # a new one itself.
+    # @param attributes [Hash] The event's attributes.
+    # @option attributes [String, Integer, Server] :server Matches the server that was created.
+    # @yield The block is executed when the event is raised.
+    # @yieldparam event [ServerCreateEvent] The event that was raised.
+    # @return [ServerCreateEventHandler] the event handler that was registered.
+
+    # This **event** is raised when a server is created respective to the bot, i.e. the bot joins a server or creates
+    # a new one itself.
+    # @param attributes [Hash] The event's attributes.
+    # @option attributes [String, Integer, Server] :server Matches the server that was created.
+    # @yield The block is executed when the event is raised.
+    # @yieldparam event [ServerCreateEvent] The event that was raised.
+    # @return [ServerCreateEventHandler] the event handler that was registered.
+    def server_create(attributes = {}, &block)
+      register_event(ServerCreateEvent, attributes, block)
+    end
+
+    # This **event** is raised when a server is updated, for example if the name or region has changed.
+    # @param attributes [Hash] The event's attributes.
+    # @option attributes [String, Integer, Server] :server Matches the server that was updated.
+    # @yield The block is executed when the event is raised.
+    # @yieldparam event [ServerUpdateEvent] The event that was raised.
+    # @return [ServerUpdateEventHandler] the event handler that was registered.
+
+    # This **event** is raised when a server is updated, for example if the name or region has changed.
+    # @param attributes [Hash] The event's attributes.
+    # @option attributes [String, Integer, Server] :server Matches the server that was updated.
+    # @yield The block is executed when the event is raised.
+    # @yieldparam event [ServerUpdateEvent] The event that was raised.
+    # @return [ServerUpdateEventHandler] the event handler that was registered.
+    def server_update(attributes = {}, &block)
+      register_event(ServerUpdateEvent, attributes, block)
+    end
+
+    # This **event** is raised when a server is deleted, or when the bot leaves a server. (These two cases are identical
+    # to Discord.)
+    # @param attributes [Hash] The event's attributes.
+    # @option attributes [String, Integer, Server] :server Matches the server that was deleted.
+    # @yield The block is executed when the event is raised.
+    # @yieldparam event [ServerDeleteEvent] The event that was raised.
+    # @return [ServerDeleteEventHandler] the event handler that was registered.
+
+    # This **event** is raised when a server is deleted, or when the bot leaves a server. (These two cases are identical
+    # to Discord.)
+    # @param attributes [Hash] The event's attributes.
+    # @option attributes [String, Integer, Server] :server Matches the server that was deleted.
+    # @yield The block is executed when the event is raised.
+    # @yieldparam event [ServerDeleteEvent] The event that was raised.
+    # @return [ServerDeleteEventHandler] the event handler that was registered.
+    def server_delete(attributes = {}, &block)
+      register_event(ServerDeleteEvent, attributes, block)
+    end
+
+    # This **event** is raised when an emoji or collection of emojis is created/deleted/updated.
+    # @param attributes [Hash] The event's attributes.
+    # @option attributes [String, Integer, Server] :server Matches the server.
+    # @yield The block is executed when the event is raised.
+    # @yieldparam event [ServerEmojiChangeEvent] The event that was raised.
+    # @return [ServerEmojiChangeEventHandler] the event handler that was registered.
+
+    # This **event** is raised when an emoji or collection of emojis is created/deleted/updated.
+    # @param attributes [Hash] The event's attributes.
+    # @option attributes [String, Integer, Server] :server Matches the server.
+    # @yield The block is executed when the event is raised.
+    # @yieldparam event [ServerEmojiChangeEvent] The event that was raised.
+    # @return [ServerEmojiChangeEventHandler] the event handler that was registered.
+    def server_emoji(attributes = {}, &block)
+      register_event(ServerEmojiChangeEvent, attributes, block)
+    end
+
+    # This **event** is raised when an emoji is created.
+    # @param attributes [Hash] The event's attributes.
+    # @option attributes [String, Integer, Server] :server Matches the server.
+    # @option attributes [String, Integer] :id Matches the ID of the emoji.
+    # @option attributes [String] :name Matches the name of the emoji.
+    # @yield The block is executed when the event is raised.
+    # @yieldparam event [ServerEmojiCreateEvent] The event that was raised.
+    # @return [ServerEmojiCreateEventHandler] the event handler that was registered.
+
+    # This **event** is raised when an emoji is created.
+    # @param attributes [Hash] The event's attributes.
+    # @option attributes [String, Integer, Server] :server Matches the server.
+    # @option attributes [String, Integer] :id Matches the ID of the emoji.
+    # @option attributes [String] :name Matches the name of the emoji.
+    # @yield The block is executed when the event is raised.
+    # @yieldparam event [ServerEmojiCreateEvent] The event that was raised.
+    # @return [ServerEmojiCreateEventHandler] the event handler that was registered.
+    def server_emoji_create(attributes = {}, &block)
+      register_event(ServerEmojiCreateEvent, attributes, block)
+    end
+
+    # This **event** is raised when an emoji is deleted.
+    # @param attributes [Hash] The event's attributes.
+    # @option attributes [String, Integer, Server] :server Matches the server.
+    # @option attributes [String, Integer] :id Matches the ID of the emoji.
+    # @option attributes [String] :name Matches the name of the emoji.
+    # @yield The block is executed when the event is raised.
+    # @yieldparam event [ServerEmojiDeleteEvent] The event that was raised.
+    # @return [ServerEmojiDeleteEventHandler] the event handler that was registered.
+
+    # This **event** is raised when an emoji is deleted.
+    # @param attributes [Hash] The event's attributes.
+    # @option attributes [String, Integer, Server] :server Matches the server.
+    # @option attributes [String, Integer] :id Matches the ID of the emoji.
+    # @option attributes [String] :name Matches the name of the emoji.
+    # @yield The block is executed when the event is raised.
+    # @yieldparam event [ServerEmojiDeleteEvent] The event that was raised.
+    # @return [ServerEmojiDeleteEventHandler] the event handler that was registered.
+    def server_emoji_delete(attributes = {}, &block)
+      register_event(ServerEmojiDeleteEvent, attributes, block)
+    end
+
+    # This **event** is raised when an emoji is updated.
+    # @param attributes [Hash] The event's attributes.
+    # @option attributes [String, Integer, Server] :server Matches the server.
+    # @option attributes [String, Integer] :id Matches the ID of the emoji.
+    # @option attributes [String] :name Matches the name of the emoji.
+    # @option attributes [String] :old_name Matches the name of the emoji before the update.
+    # @yield The block is executed when the event is raised.
+    # @yieldparam event [ServerEmojiUpdateEvent] The event that was raised.
+    # @return [ServerEmojiUpdateEventHandler] the event handler that was registered.
+
+    # This **event** is raised when an emoji is updated.
+    # @param attributes [Hash] The event's attributes.
+    # @option attributes [String, Integer, Server] :server Matches the server.
+    # @option attributes [String, Integer] :id Matches the ID of the emoji.
+    # @option attributes [String] :name Matches the name of the emoji.
+    # @option attributes [String] :old_name Matches the name of the emoji before the update.
+    # @yield The block is executed when the event is raised.
+    # @yieldparam event [ServerEmojiUpdateEvent] The event that was raised.
+    # @return [ServerEmojiUpdateEventHandler] the event handler that was registered.
+    def server_emoji_update(attributes = {}, &block)
+      register_event(ServerEmojiUpdateEvent, attributes, block)
+    end
+
+    # This **event** is raised when a role is created.
+    # @param attributes [Hash] The event's attributes.
+    # @option attributes [String] :name Matches the role name.
+    # @yield The block is executed when the event is raised.
+    # @yieldparam event [ServerRoleCreateEvent] The event that was raised.
+    # @return [ServerRoleCreateEventHandler] the event handler that was registered.
+
+    # This **event** is raised when a role is created.
+    # @param attributes [Hash] The event's attributes.
+    # @option attributes [String] :name Matches the role name.
+    # @yield The block is executed when the event is raised.
+    # @yieldparam event [ServerRoleCreateEvent] The event that was raised.
+    # @return [ServerRoleCreateEventHandler] the event handler that was registered.
+    def server_role_create(attributes = {}, &block)
+      register_event(ServerRoleCreateEvent, attributes, block)
+    end
+
+    # This **event** is raised when a role is deleted.
+    # @param attributes [Hash] The event's attributes.
+    # @option attributes [String, Integer] :id Matches the role ID.
+    # @yield The block is executed when the event is raised.
+    # @yieldparam event [ServerRoleDeleteEvent] The event that was raised.
+    # @return [ServerRoleDeleteEventHandler] the event handler that was registered.
+
+    # This **event** is raised when a role is deleted.
+    # @param attributes [Hash] The event's attributes.
+    # @option attributes [String, Integer] :id Matches the role ID.
+    # @yield The block is executed when the event is raised.
+    # @yieldparam event [ServerRoleDeleteEvent] The event that was raised.
+    # @return [ServerRoleDeleteEventHandler] the event handler that was registered.
+    def server_role_delete(attributes = {}, &block)
+      register_event(ServerRoleDeleteEvent, attributes, block)
+    end
+
+    # This **event** is raised when a role is updated.
+    # @param attributes [Hash] The event's attributes.
+    # @option attributes [String] :name Matches the role name.
+    # @yield The block is executed when the event is raised.
+    # @yieldparam event [ServerRoleUpdateEvent] The event that was raised.
+    # @return [ServerRoleUpdateEventHandler] the event handler that was registered.
+
+    # This **event** is raised when a role is updated.
+    # @param attributes [Hash] The event's attributes.
+    # @option attributes [String] :name Matches the role name.
+    # @yield The block is executed when the event is raised.
+    # @yieldparam event [ServerRoleUpdateEvent] The event that was raised.
+    # @return [ServerRoleUpdateEventHandler] the event handler that was registered.
+    def server_role_update(attributes = {}, &block)
+      register_event(ServerRoleUpdateEvent, attributes, block)
+    end
+
+    # This **event** is raised when a webhook is updated.
+    # @param attributes [Hash] The event's attributes.
+    # @option attributes [String, Integer, Server] :server Matches the server by name, ID or instance.
+    # @option attributes [String, Integer, Channel] :channel Matches the channel by name, ID or instance.
+    # @option attribute [String, Integer, Webhook] :webhook Matches the webhook by name, ID or instance.
+    # @yield The block is executed when the event is raised.
+    # @yieldparam event [WebhookUpdateEvent] The event that was raised.
+    # @return [WebhookUpdateEventHandler] the event handler that was registered.
+
+    # This **event** is raised when a webhook is updated.
+    # @param attributes [Hash] The event's attributes.
+    # @option attributes [String, Integer, Server] :server Matches the server by name, ID or instance.
+    # @option attributes [String, Integer, Channel] :channel Matches the channel by name, ID or instance.
+    # @option attribute [String, Integer, Webhook] :webhook Matches the webhook by name, ID or instance.
+    # @yield The block is executed when the event is raised.
+    # @yieldparam event [WebhookUpdateEvent] The event that was raised.
+    # @return [WebhookUpdateEventHandler] the event handler that was registered.
+    def webhook_update(attributes = {}, &block)
+      register_event(WebhookUpdateEvent, attributes, block)
+    end
+
+    # This **event** is raised when an {Await} is triggered. It provides an easy way to execute code
+    # on an await without having to rely on the await's block.
+    # @param attributes [Hash] The event's attributes.
+    # @option attributes [Symbol] :key Exactly matches the await's key.
+    # @option attributes [Class] :type Exactly matches the event's type.
+    # @yield The block is executed when the event is raised.
+    # @yieldparam event [AwaitEvent] The event that was raised.
+    # @return [AwaitEventHandler] the event handler that was registered.
+
+    # This **event** is raised when an invite is created.
+    # @param attributes [Hash] The event's attributes.
+    # @option attributes [String, Integer, User] :inviter Matches the user that created the invite.
+    # @option attributes [String, Integer, Channel] :channel Matches the channel the invite was created for.
+    # @option attributes [String, Integer, Server] :server Matches the server the invite was created for.
+    # @option attributes [true, false] :temporary Matches whether the invite is temporary or not.
+    # @yield The block is executed when the event is raised.
+    # @yieldparam event [InviteCreateEvent] The event that was raised.
+    # @return [InviteCreateEventHandler] The event handler that was registered.
+    def invite_create(attributes = {}, &block)
+      register_event(InviteCreateEvent, attributes, block)
+    end
+
+    # This **event** is raised when an invite is deleted.
+    # @param attributes [Hash] The event's attributes.
+    # @option attributes [String, Integer, Channel] :channel Matches the channel the deleted invite was for.
+    # @option attributes [String, Integer, Server] :server Matches the server the deleted invite was for.
+    # @yield The block is executed when the event is raised
+    # @yieldparam event [InviteDeleteEvent] The event that was raised.
+    # @return [InviteDeleteEventHandler] The event handler that was registered.
+
+    # This **event** is raised when an invite is deleted.
+    # @param attributes [Hash] The event's attributes.
+    # @option attributes [String, Integer, Channel] :channel Matches the channel the deleted invite was for.
+    # @option attributes [String, Integer, Server] :server Matches the server the deleted invite was for.
+    # @yield The block is executed when the event is raised
+    # @yieldparam event [InviteDeleteEvent] The event that was raised.
+    # @return [InviteDeleteEventHandler] The event handler that was registered.
+    def invite_delete(attributes = {}, &block)
+      register_event(InviteDeleteEvent, attributes, block)
+    end
+
+    # This **event** is raised whenever an interaction event is received.
+    # @param attributes [Hash] The event's attributes.
+    # @option attributes [Integer, Symbol, String] :type The interaction type, can be the integer value or the name
+    #   of the key in {OnyxCord::Interaction::TYPES}.
+    # @option attributes [String, Integer, Server, nil] :server The server where this event was created. `nil` for DM channels.
+    # @option attributes [String, Integer, Channel] :channel The channel where this event was created.
+    # @option attributes [String, Integer, User] :user The user that triggered this event.
+    # @yield The block is executed when the event is raised.
+    # @yieldparam event [InteractionCreateEvent] The event that was raised.
+    # @return [InteractionCreateEventHandler] The event handler that was registered.
+  end
+end

data/lib/onyxcord/events/handlers/interactions.rb

@@ -0,0 +1,238 @@
+# frozen_string_literal: true
+
+module OnyxCord
+  module EventContainer
+    # This **event** is raised whenever an interaction event is received.
+    # @param attributes [Hash] The event's attributes.
+    # @option attributes [Integer, Symbol, String] :type The interaction type, can be the integer value or the name
+    #   of the key in {OnyxCord::Interaction::TYPES}.
+    # @option attributes [String, Integer, Server, nil] :server The server where this event was created. `nil` for DM channels.
+    # @option attributes [String, Integer, Channel] :channel The channel where this event was created.
+    # @option attributes [String, Integer, User] :user The user that triggered this event.
+    # @yield The block is executed when the event is raised.
+    # @yieldparam event [InteractionCreateEvent] The event that was raised.
+    # @return [InteractionCreateEventHandler] The event handler that was registered.
+    def interaction_create(attributes = {}, &block)
+      register_event(InteractionCreateEvent, attributes, block)
+    end
+
+    # This **event** is raised whenever an application command (slash command) is executed.
+    # @param name [Symbol, String] The name of the application command this handler is for.
+    # @param attributes [Hash] The event's attributes.
+    # @yield The block is executed when the event is raised.
+    # @yieldparam event [ApplicationCommandEvent] The event that was raised.
+    # @return [ApplicationCommandEventHandler] The event handler that was registered.
+
+    # This **event** is raised whenever an application command (slash command) is executed.
+    # @param name [Symbol, String] The name of the application command this handler is for.
+    # @param attributes [Hash] The event's attributes.
+    # @yield The block is executed when the event is raised.
+    # @yieldparam event [ApplicationCommandEvent] The event that was raised.
+    # @return [ApplicationCommandEventHandler] The event handler that was registered.
+    def application_command(name, attributes = {}, &block)
+      name = name.to_sym
+      @application_commands ||= {}
+
+      unless block
+        @application_commands[name] ||= ApplicationCommandEventHandler.new(attributes, nil)
+        return @application_commands[name]
+      end
+
+      @application_commands[name] = ApplicationCommandEventHandler.new(attributes, block)
+    end
+
+    # This **event** is raised whenever an button interaction is created.
+    # @param attributes [Hash] The event's attributes.
+    # @option attributes [String, Regexp] :custom_id A custom_id to match against.
+    # @option attributes [String, Integer, Message] :message The message to filter for.
+    # @yield The block is executed when the event is raised.
+    # @yieldparam event [ButtonEvent] The event that was raised.
+    # @return [ButtonEventHandler] The event handler that was registered.
+
+    # This **event** is raised whenever an button interaction is created.
+    # @param attributes [Hash] The event's attributes.
+    # @option attributes [String, Regexp] :custom_id A custom_id to match against.
+    # @option attributes [String, Integer, Message] :message The message to filter for.
+    # @yield The block is executed when the event is raised.
+    # @yieldparam event [ButtonEvent] The event that was raised.
+    # @return [ButtonEventHandler] The event handler that was registered.
+    def button(attributes = {}, &block)
+      register_event(ButtonEvent, attributes, block)
+    end
+
+    # This **event** is raised whenever an select string interaction is created.
+    # @param attributes [Hash] The event's attributes.
+    # @option attributes [String, Regexp] :custom_id A custom_id to match against.
+    # @option attributes [String, Integer, Message] :message The message to filter for.
+    # @yield The block is executed when the event is raised.
+    # @yieldparam event [StringSelectEvent] The event that was raised.
+    # @return [StringSelectEventHandler] The event handler that was registered.
+
+    # This **event** is raised whenever an select string interaction is created.
+    # @param attributes [Hash] The event's attributes.
+    # @option attributes [String, Regexp] :custom_id A custom_id to match against.
+    # @option attributes [String, Integer, Message] :message The message to filter for.
+    # @yield The block is executed when the event is raised.
+    # @yieldparam event [StringSelectEvent] The event that was raised.
+    # @return [StringSelectEventHandler] The event handler that was registered.
+    def string_select(attributes = {}, &block)
+      register_event(StringSelectEvent, attributes, block)
+    end
+
+    alias_method :select_menu, :string_select
+
+    # This **event** is raised whenever a modal is submitted.
+    # @param attributes [Hash] The event's attributes.
+    # @option attributes [String, Regexp] :custom_id A custom_id to match against.
+    # @option attributes [String, Integer, Message] :message The message to filter for.
+    # @option attributes [String, Integer, Server, nil] :server The server where this event was created. `nil` for DM channels.
+    # @option attributes [String, Integer, Channel] :channel The channel where this event was created.
+    # @option attributes [String, Integer, User] :user The user that triggered this event.    # @yield The block is executed when the event is raised.
+    # @yieldparam event [ModalSubmitEvent] The event that was raised.
+    # @return [ModalSubmitEventHandler] The event handler that was registered.
+
+    # This **event** is raised whenever a modal is submitted.
+    # @param attributes [Hash] The event's attributes.
+    # @option attributes [String, Regexp] :custom_id A custom_id to match against.
+    # @option attributes [String, Integer, Message] :message The message to filter for.
+    # @option attributes [String, Integer, Server, nil] :server The server where this event was created. `nil` for DM channels.
+    # @option attributes [String, Integer, Channel] :channel The channel where this event was created.
+    # @option attributes [String, Integer, User] :user The user that triggered this event.    # @yield The block is executed when the event is raised.
+    # @yieldparam event [ModalSubmitEvent] The event that was raised.
+    # @return [ModalSubmitEventHandler] The event handler that was registered.
+    def modal_submit(attributes = {}, &block)
+      register_event(ModalSubmitEvent, attributes, block)
+    end
+
+    # This **event** is raised whenever an select user interaction is created.
+    # @param attributes [Hash] The event's attributes.
+    # @option attributes [String, Regexp] :custom_id A custom_id to match against.
+    # @option attributes [String, Integer, Message] :message The message to filter for.
+    # @yield The block is executed when the event is raised.
+    # @yieldparam event [UserSelectEvent] The event that was raised.
+    # @return [UserSelectEventHandler] The event handler that was registered.
+
+    # This **event** is raised whenever an select user interaction is created.
+    # @param attributes [Hash] The event's attributes.
+    # @option attributes [String, Regexp] :custom_id A custom_id to match against.
+    # @option attributes [String, Integer, Message] :message The message to filter for.
+    # @yield The block is executed when the event is raised.
+    # @yieldparam event [UserSelectEvent] The event that was raised.
+    # @return [UserSelectEventHandler] The event handler that was registered.
+    def user_select(attributes = {}, &block)
+      register_event(UserSelectEvent, attributes, block)
+    end
+
+    # This **event** is raised whenever an select role interaction is created.
+    # @param attributes [Hash] The event's attributes.
+    # @option attributes [String, Regexp] :custom_id A custom_id to match against.
+    # @option attributes [String, Integer, Message] :message The message to filter for.
+    # @yield The block is executed when the event is raised.
+    # @yieldparam event [RoleSelectEvent] The event that was raised.
+    # @return [RoleSelectEventHandler] The event handler that was registered.
+
+    # This **event** is raised whenever an select role interaction is created.
+    # @param attributes [Hash] The event's attributes.
+    # @option attributes [String, Regexp] :custom_id A custom_id to match against.
+    # @option attributes [String, Integer, Message] :message The message to filter for.
+    # @yield The block is executed when the event is raised.
+    # @yieldparam event [RoleSelectEvent] The event that was raised.
+    # @return [RoleSelectEventHandler] The event handler that was registered.
+    def role_select(attributes = {}, &block)
+      register_event(RoleSelectEvent, attributes, block)
+    end
+
+    # This **event** is raised whenever an select mentionable interaction is created.
+    # @param attributes [Hash] The event's attributes.
+    # @option attributes [String, Regexp] :custom_id A custom_id to match against.
+    # @option attributes [String, Integer, Message] :message The message to filter for.
+    # @yield The block is executed when the event is raised.
+    # @yieldparam event [MentionableSelectEvent] The event that was raised.
+    # @return [MentionableSelectEventHandler] The event handler that was registered.
+
+    # This **event** is raised whenever an select mentionable interaction is created.
+    # @param attributes [Hash] The event's attributes.
+    # @option attributes [String, Regexp] :custom_id A custom_id to match against.
+    # @option attributes [String, Integer, Message] :message The message to filter for.
+    # @yield The block is executed when the event is raised.
+    # @yieldparam event [MentionableSelectEvent] The event that was raised.
+    # @return [MentionableSelectEventHandler] The event handler that was registered.
+    def mentionable_select(attributes = {}, &block)
+      register_event(MentionableSelectEvent, attributes, block)
+    end
+
+    # This **event** is raised whenever an select channel interaction is created.
+    # @param attributes [Hash] The event's attributes.
+    # @option attributes [String, Regexp] :custom_id A custom_id to match against.
+    # @option attributes [String, Integer, Message] :message The message to filter for.
+    # @yield The block is executed when the event is raised.
+    # @yieldparam event [ChannelSelectEvent] The event that was raised.
+    # @return [ChannelSelectEventHandler] The event handler that was registered.
+
+    # This **event** is raised whenever an select channel interaction is created.
+    # @param attributes [Hash] The event's attributes.
+    # @option attributes [String, Regexp] :custom_id A custom_id to match against.
+    # @option attributes [String, Integer, Message] :message The message to filter for.
+    # @yield The block is executed when the event is raised.
+    # @yieldparam event [ChannelSelectEvent] The event that was raised.
+    # @return [ChannelSelectEventHandler] The event handler that was registered.
+    def channel_select(attributes = {}, &block)
+      register_event(ChannelSelectEvent, attributes, block)
+    end
+
+    # This **event** is raised whenever a message is pinned or unpinned.
+    # @param attributes [Hash] The event's attributes.
+    # @option attributes [String, Integer, Channel] :channel A channel to match against.
+    # @option attributes [String, Integer, Server] :server A server to match against.
+    # @yield The block is executed when the event is raised.
+    # @yieldparam event [ChannelPinsUpdateEvent] The event that was raised.
+    # @return [ChannelPinsUpdateEventHandler] The event handler that was registered.
+
+    # This **event** is raised whenever an autocomplete interaction is created.
+    # @param name [String, Symbol, nil] An option name to match against.
+    # @param attributes [Hash] The event's attributes.
+    # @option attributes [String, Integer] :command_id A command ID to match against.
+    # @option attributes [String, Symbol] :subcommand A subcommand name to match against.
+    # @option attributes [String, Symbol] :subcommand_group A subcommand group to match against.
+    # @option attributes [String, Symbol] :command_name A command name to match against.
+    # @option attributes [String, Integer, Server] :server A server to match against.
+    # @yield The block is executed when the event is raised.
+    # @yieldparam event [AutocompleteEvent] The event that was raised.
+    # @return [AutocompleteEventHandler] The event handler that was registered.
+    def autocomplete(name = nil, attributes = {}, &block)
+      register_event(AutocompleteEvent, attributes.merge!({ name: name&.to_s }), block)
+    end
+
+    # This **event** is raised whenever an application command's permissions are updated.
+    # @param attributes [Hash] The event's attributes.
+    # @option attributes [String, Integer] :command_id A command ID to match against.
+    # @option attributes [String, Integer] :application_id An application ID to match against.
+    # @option attributes [String, Integer, Server] :server A server to match against.
+    # @yield The block is executed when the event is raised.
+    # @yieldparam event [ApplicationCommandPermissionsUpdateEvent] The event that was raised.
+    # @return [ApplicationCommandPermissionsUpdateEventHandler] The event handler that was registered.
+
+    # This **event** is raised whenever an application command's permissions are updated.
+    # @param attributes [Hash] The event's attributes.
+    # @option attributes [String, Integer] :command_id A command ID to match against.
+    # @option attributes [String, Integer] :application_id An application ID to match against.
+    # @option attributes [String, Integer, Server] :server A server to match against.
+    # @yield The block is executed when the event is raised.
+    # @yieldparam event [ApplicationCommandPermissionsUpdateEvent] The event that was raised.
+    # @return [ApplicationCommandPermissionsUpdateEventHandler] The event handler that was registered.
+    def application_command_permissions_update(attributes = {}, &block)
+      register_event(ApplicationCommandPermissionsUpdateEvent, attributes, block)
+    end
+
+    # This **event** is raised whenever a user votes on a poll.
+    # @param attributes [Hash] The event's attributes.
+    # @option attributes [String, Integer, User, Member] :user A user to match against.
+    # @option attributes [String, Integer, Channel] :channel A channel to match against.
+    # @option attributes [String, Integer, Server] :server A server to match against.
+    # @option attributes [String, Integer, Message] :message A message to match against.
+    # @option attributes [String, Integer, Answer] :answer A poll answer to match against.
+    # @yield The block is executed when the event is raised.
+    # @yieldparam event [PollVoteAddEvent] The event that was raised.
+    # @return [PollVoteAddEventHandler] The event handler that was registered.
+  end
+end