onyxcord 1.1.0

data/lib/onyxcord/data/attachment.rb

@@ -0,0 +1,91 @@
+# frozen_string_literal: true
+
+module OnyxCord
+  # An attachment to a message
+  class Attachment
+    include IDObject
+
+    # @return [String] the CDN URL this attachment can be downloaded at.
+    attr_reader :url
+
+    # @return [String] the attachment's proxy URL - I'm not sure what exactly this does, but I think it has something to
+    #   do with CDNs.
+    attr_reader :proxy_url
+
+    # @return [String] the attachment's filename.
+    attr_reader :filename
+
+    # @return [Integer] the attachment's file size in bytes.
+    attr_reader :size
+
+    # @return [Integer, nil] the width of an image file, in pixels, or `nil` if the file is not an image.
+    attr_reader :width
+
+    # @return [Integer, nil] the height of an image file, in pixels, or `nil` if the file is not an image.
+    attr_reader :height
+
+    # @return [String, nil] the attachment's description.
+    attr_reader :description
+
+    # @return [String, nil] the attachment's media type.
+    attr_reader :content_type
+
+    # @return [true, false] whether this attachment is ephemeral.
+    attr_reader :ephemeral
+    alias_method :ephemeral?, :ephemeral
+
+    # @return [Float, nil] the duration of the voice message in seconds.
+    attr_reader :duration_seconds
+
+    # @return [String, nil] the base64 encoded bytearray representing a sampled waveform for a voice message.
+    attr_reader :waveform
+
+    # @return [Integer] the flags set on this attachment combined as a bitfield.
+    attr_reader :flags
+
+    # @!visibility private
+    def initialize(data, message, bot)
+      @bot = bot
+      @message = message
+
+      @id = data['id'].to_i
+      @url = data['url']
+      @proxy_url = data['proxy_url']
+      @filename = data['filename']
+
+      @size = data['size']
+
+      @width = data['width']
+      @height = data['height']
+
+      @description = data['description']
+      @content_type = data['content_type']
+
+      @ephemeral = data['ephemeral']
+
+      @duration_seconds = data['duration_secs']&.to_f
+      @waveform = data['waveform']
+      @flags = data['flags'] || 0
+    end
+
+    # @return [true, false] whether this file is an image file.
+    def image?
+      !(@width.nil? || @height.nil?)
+    end
+
+    # @return [true, false] whether this file is tagged as a spoiler.
+    def spoiler?
+      @filename.start_with? 'SPOILER_'
+    end
+
+    # @return [Message, nil] the message this attachment object belongs to.
+    def message
+      @message unless @message.is_a?(Snapshot)
+    end
+
+    # @return [Snapshot, nil] the message snapshot this attachment object belongs to.
+    def snapshot
+      @message unless @message.is_a?(Message)
+    end
+  end
+end

data/lib/onyxcord/data/audit_logs.rb

@@ -0,0 +1,438 @@
+# frozen_string_literal: true
+
+module OnyxCord
+  # A server's audit logs
+  class AuditLogs
+    # The numbers associated with the type of action.
+    ACTIONS = {
+      1 => :server_update,
+      10 => :channel_create,
+      11 => :channel_update,
+      12 => :channel_delete,
+      13 => :channel_overwrite_create,
+      14 => :channel_overwrite_update,
+      15 => :channel_overwrite_delete,
+      20 => :member_kick,
+      21 => :member_prune,
+      22 => :member_ban_add,
+      23 => :member_ban_remove,
+      24 => :member_update,
+      25 => :member_role_update,
+      26 => :member_move,
+      27 => :member_disconnect,
+      28 => :bot_add,
+      30 => :role_create,
+      31 => :role_update,
+      32 => :role_delete,
+      40 => :invite_create,
+      41 => :invite_update,
+      42 => :invite_delete,
+      50 => :webhook_create,
+      51 => :webhook_update,
+      52 => :webhook_delete,
+      60 => :emoji_create,
+      61 => :emoji_update,
+      62 => :emoji_delete,
+      # 70
+      # 71
+      72 => :message_delete,
+      73 => :message_bulk_delete,
+      74 => :message_pin,
+      75 => :message_unpin,
+      80 => :integration_create,
+      81 => :integration_update,
+      82 => :integration_delete,
+      83 => :stage_instance_create,
+      84 => :stage_instance_update,
+      85 => :stage_instance_delete,
+      90 => :sticker_create,
+      91 => :sticker_update,
+      92 => :sticker_delete,
+      100 => :scheduled_event_create,
+      101 => :scheduled_event_update,
+      102 => :scheduled_event_delete,
+      110 => :thread_create,
+      111 => :thread_update,
+      112 => :thread_delete,
+      121 => :application_command_permission_update,
+      130 => :soundboard_sound_create,
+      131 => :soundboard_sound_update,
+      132 => :soundboard_sound_delete,
+      140 => :auto_moderation_rule_create,
+      141 => :auto_moderation_rule_update,
+      142 => :auto_moderation_rule_delete,
+      143 => :auto_moderation_block_message,
+      144 => :auto_moderation_flag_to_channel,
+      145 => :auto_moderation_user_communication_disabled,
+      146 => :auto_moderation_quarantine_user,
+      150 => :creator_monetization_request_created,
+      151 => :creator_monetization_terms_accepted,
+      163 => :onboarding_prompt_create,
+      164 => :onboarding_prompt_update,
+      165 => :onboarding_prompt_delete,
+      166 => :onboarding_create,
+      167 => :onboarding_update,
+      190 => :home_settings_create,
+      191 => :home_settings_update
+    }.freeze
+
+    # @!visibility private
+    CREATE_ACTIONS = %i[
+      channel_create channel_overwrite_create member_ban_add role_create
+      invite_create webhook_create emoji_create integration_create
+      stage_instance_create sticker_create scheduled_event_create thread_create
+      soundboard_sound_create auto_moderation_rule_create onboarding_prompt_create
+      onboarding_create home_settings_create creator_monetization_request_created
+      message_pin auto_moderation_flag_to_channel
+    ].freeze
+
+    # @!visibility private
+    DELETE_ACTIONS = %i[
+      channel_delete channel_overwrite_delete member_kick member_prune
+      member_ban_remove role_delete invite_delete webhook_delete
+      emoji_delete message_delete message_bulk_delete integration_delete
+      stage_instance_delete sticker_delete scheduled_event_delete
+      thread_delete soundboard_sound_delete auto_moderation_rule_delete
+      onboarding_prompt_delete message_unpin auto_moderation_block_message
+    ].freeze
+
+    # @!visibility private
+    UPDATE_ACTIONS = %i[
+      server_update channel_update channel_overwrite_update member_update
+      member_role_update role_update invite_update webhook_update
+      emoji_update integration_update stage_instance_update sticker_update
+      scheduled_event_update thread_update application_command_permission_update
+      soundboard_sound_update auto_moderation_rule_update onboarding_prompt_update
+      onboarding_update home_settings_update creator_monetization_terms_accepted
+      auto_moderation_user_communication_disabled auto_moderation_quarantine_user
+    ].freeze
+
+    # @return [Hash<String => User>] the users included in the audit logs.
+    attr_reader :users
+
+    # @return [Hash<String => Webhook>] the webhooks included in the audit logs.
+    attr_reader :webhooks
+
+    # @return [Array<Entry>] the entries listed in the audit logs.
+    attr_reader :entries
+
+    # @!visibility private
+    def initialize(server, bot, data)
+      @bot = bot
+      @server = server
+      @users = {}
+      @webhooks = {}
+      @entries = data['audit_log_entries'].map { |entry| Entry.new(self, @server, @bot, entry) }
+
+      process_users(data['users'])
+      process_webhooks(data['webhooks'])
+    end
+
+    # An entry in a server's audit logs.
+    class Entry
+      include IDObject
+
+      # @return [Symbol] the action that was performed.
+      attr_reader :action
+
+      # @return [Symbol] the type action that was performed. (:create, :delete, :update, :unknown)
+      attr_reader :action_type
+
+      # @return [Symbol] the type of target being performed on. (:server, :channel, :user, :role, :invite, :webhook, :emoji, :unknown)
+      attr_reader :target_type
+
+      # @return [Integer, nil] the amount of messages deleted. Only present if the action is `:message_delete`.
+      attr_reader :count
+      alias_method :amount, :count
+
+      # @return [Integer, nil] the amount of days the members were inactive for. Only present if the action is `:member_prune`.
+      attr_reader :days
+
+      # @return [Integer, nil] the amount of members removed. Only present if the action is `:member_prune`.
+      attr_reader :members_removed
+
+      # @return [Integer, nil] the ID of the message that was pinned or unpinned.
+      attr_reader :message_id
+
+      # @return [String, nil] the type of the integration that updated the member's roles, or kicked the member.
+      attr_reader :integration_type
+
+      # @return [Integer, nil] the ID of the application whose application command permissions were updated.
+      attr_reader :application_id
+
+      # @return [String, nil] the name of the auto moderation rule that was triggered.
+      attr_reader :automod_rule_name
+
+      # @return [Integer, nil] the trigger type of the auto moderation rules that was triggered.
+      attr_reader :automod_rule_trigger_type
+
+      # @return [String, nil] the name of the role associated with the permission overwrite.
+      attr_reader :overwrite_role_name
+
+      # @return [Integer, nil] the ID of the permission overwrite.
+      attr_reader :overwrite_id
+
+      # @return [Symbol, nil] the type of the permission overwrite.
+      attr_reader :overwrite_type
+
+      # @return [String, nil] the reason for this action occurring.
+      attr_reader :reason
+
+      # @return [Hash<String => Change>, RoleChange, nil] the changes from this log, listing the key as the key changed. Will be a RoleChange object if the action is `:member_role_update`. Will be nil if the action is either `:message_delete` or `:member_prune`.
+      attr_reader :changes
+
+      # @!visibility private
+      def initialize(logs, server, bot, data)
+        @bot = bot
+        @id = data['id'].to_i
+        @logs = logs
+        @server = server
+        @data = data
+        @action = ACTIONS[data['action_type']]
+        @reason = data['reason']
+        @action_type = AuditLogs.action_type_for(data['action_type'])
+        @target_type = AuditLogs.target_type_for(data['action_type'])
+
+        # Sets the 'changes' variable to a empty hash if there are no special actions.
+        @changes = {} unless @action == :message_delete || @action == :member_prune || @action == :member_role_update
+
+        # Sets the 'changes' variable to a RoleChange class if there's a role update.
+        @changes = RoleChange.new(data['changes'][0], @server) if @action == :member_role_update
+
+        process_changes(data['changes']) unless @action == :member_role_update
+        return unless (options = data['options'])
+
+        # https://docs.discord.com/developers/resources/audit-log#audit-log-entry-object-optional-audit-entry-info
+        @count = options['count']&.to_i
+        @channel_id = options['channel_id']&.to_i
+        @days = options['delete_member_days']&.to_i
+        @members_removed = options['members_removed']&.to_i
+        @message_id = options['message_id']&.to_i
+        @integration_type = options['integration_type']
+        @application_id = options['application_id']&.to_i
+        @automod_rule_name = options['auto_moderation_rule_name']
+        @automod_rule_trigger_type = options['auto_moderation_rule_trigger_type']
+        @overwrite_role_name = options['role_name']
+        @overwrite_id = options['id']&.to_i
+        @overwrite_type = Overwrite::TYPES.key(options['type']) if options['type']
+      end
+
+      # @return [Server, Channel, Member, User, Role, Invite, Webhook, Emoji, nil] the target being performed on.
+      def target
+        @target ||= process_target(@data['target_id'], @target_type)
+      end
+
+      # @return [Member, User] the user that authored this action. Can be a User object if the user no longer exists in the server.
+      def user
+        @user ||= @server.member(@data['user_id'].to_i) || @bot.user(@data['user_id'].to_i) || @logs&.user(@data['user_id'].to_i)
+      end
+
+      alias_method :author, :user
+
+      # @return [Channel, nil] the channel associated with the audit log event.
+      def channel
+        return nil unless @channel_id
+
+        @channel ||= @bot.channel(@channel_id)
+      end
+
+      # @return [Message, nil] the message that was pinned or un-pinned.
+      def message
+        channel.load_message(@message_id) if @message_id
+      end
+
+      # @!visibility private
+      def process_target(id, type)
+        id = id.resolve_id unless id.nil?
+        case type
+        when :server then @server # Since it won't be anything else
+        when :channel then @bot.channel(id, @server)
+        when :user, :message then @server.member(id) || @bot.user(id) || @logs&.user(id)
+        when :role then @server.role(id)
+        when :invite then @bot.invite(@data['changes'].find { |change| change['key'] == 'code' }.values.delete_if { |v| v == 'code' }.first)
+        when :webhook then @server.webhooks.find { |webhook| webhook.id == id } || @logs&.webhook(id)
+        when :emoji then @server.emoji[id]
+        when :integration then @server.integrations.find { |integration| integration.id == id }
+        end
+      end
+
+      # The inspect method is overwritten to give more useful output
+      def inspect
+        "<AuditLogs::Entry id=#{@id} key=#{@key} action=#{@action} reason=#{@reason} action_type=#{@action_type} target_type=#{@target_type} count=#{@count} days=#{@days} members_removed=#{@members_removed}>"
+      end
+
+      # Process action changes
+      # @note For internal use only
+      # @!visibility private
+      def process_changes(changes)
+        return unless changes
+
+        changes.each do |element|
+          change = Change.new(element, @server, @bot, self)
+          @changes[change.key] = change
+        end
+      end
+    end
+
+    # A change in a audit log entry.
+    class Change
+      # @return [String] the key that was changed.
+      # @note You should check with the Discord API Documentation on what key gives out what value.
+      attr_reader :key
+
+      # @return [String, Integer, true, false, Permissions, Overwrite, nil] the value that was changed from.
+      attr_reader :old
+      alias_method :old_value, :old
+
+      # @return [String, Integer, true, false, Permissions, Overwrite, nil] the value that was changed to.
+      attr_reader :new
+      alias_method :new_value, :new
+
+      # @!visibility private
+      def initialize(data, server, bot, logs)
+        @key = data['key']
+        @old = data['old_value']
+        @new = data['new_value']
+        @server = server
+        @bot = bot
+        @logs = logs
+
+        @old = Permissions.new(@old) if @old && @key == 'permissions'
+        @new = Permissions.new(@new) if @new && @key == 'permissions'
+
+        @old = @old.map { |o| Overwrite.new(o['id'], type: o['type'], allow: o['allow'], deny: o['deny']) } if @old && @key == 'permission_overwrites'
+        @new = @new.map { |o| Overwrite.new(o['id'], type: o['type'], allow: o['allow'], deny: o['deny']) } if @new && @key == 'permission_overwrites'
+      end
+
+      # @return [Channel, nil] the channel that was previously used in the server widget. Only present if the key for this change is `widget_channel_id`.
+      def old_widget_channel
+        @bot.channel(@old, @server) if @old && @key == 'widget_channel_id'
+      end
+
+      # @return [Channel, nil] the channel that is used in the server widget prior to this change. Only present if the key for this change is `widget_channel_id`.
+      def new_widget_channel
+        @bot.channel(@new, @server) if @new && @key == 'widget_channel_id'
+      end
+
+      # @return [Channel, nil] the channel that was previously used in the server as an AFK channel. Only present if the key for this change is `afk_channel_id`.
+      def old_afk_channel
+        @bot.channel(@old, @server) if @old && @key == 'afk_channel_id'
+      end
+
+      # @return [Channel, nil] the channel that is used in the server as an AFK channel prior to this change. Only present if the key for this change is `afk_channel_id`.
+      def new_afk_channel
+        @bot.channel(@new, @server) if @new && @key == 'afk_channel_id'
+      end
+
+      # @return [Member, User, nil] the member that used to be the owner of the server. Only present if the for key for this change is `owner_id`.
+      def old_owner
+        @server.member(@old) || @bot.user(@old) || @logs&.user(@old) if @old && @key == 'owner_id'
+      end
+
+      # @return [Member, User, nil] the member that is now the owner of the server prior to this change. Only present if the key for this change is `owner_id`.
+      def new_owner
+        @server.member(@new) || @bot.user(@new) || @logs&.user(@new) if @new && @key == 'owner_id'
+      end
+    end
+
+    # A change that includes roles.
+    class RoleChange
+      # @return [Symbol] what type of change this is: (:add, :remove)
+      attr_reader :type
+
+      # @!visibility private
+      def initialize(data, server)
+        @type = data['key'].delete('$').to_sym
+        @role_id = data['new_value'][0]['id'].to_i
+        @server = server
+      end
+
+      # @return [Role] the role being used.
+      def role
+        @role ||= @server.role(@role_id)
+      end
+    end
+
+    # @return [Entry] the latest entry in the audit logs.
+    def latest
+      @entries.first
+    end
+    alias_method :first, :latest
+
+    # Gets a user in the audit logs data based on user ID
+    # @note This only uses data given by the audit logs request
+    # @param id [String, Integer] The user ID to look for
+    def user(id)
+      @users[id.resolve_id]
+    end
+
+    # Gets a webhook in the audit logs data based on webhook ID
+    # @note This only uses data given by the audit logs request
+    # @param id [String, Integer] The webhook ID to look for
+    def webhook(id)
+      @webhooks[id.resolve_id]
+    end
+
+    # Process user objects given by the request
+    # @note For internal use only
+    # @!visibility private
+    def process_users(users)
+      users.each do |element|
+        user = @bot.ensure_user(element)
+        @users[user.id] = user
+      end
+    end
+
+    # Process webhook objects given by the request
+    # @note For internal use only
+    # @!visibility private
+    def process_webhooks(webhooks)
+      webhooks.each do |element|
+        webhook = Webhook.new(element, @bot)
+        @webhooks[webhook.id] = webhook
+      end
+    end
+
+    # Find the type of target by it's action number
+    # @note For internal use only
+    # @!visibility private
+    def self.target_type_for(action)
+      case action
+      when 1 then :server
+      when 10..15 then :channel
+      when 20..28 then :user
+      when 30..32 then :role
+      when 40..42 then :invite
+      when 50..52 then :webhook
+      when 60..62 then :emoji
+      when 72..75 then :message
+      when 80..82 then :integration
+      when 83..85 then :stage_instance
+      when 90..92 then :sticker
+      when 100..102 then :scheduled_event
+      when 110..112 then :thread
+      when 121 then :application_command
+      when 130..132 then :soundboard_sound
+      when 140..146 then :auto_moderation
+      when 150..151 then :creator_monetization
+      when 163..165 then :onboarding_prompt
+      when 166..167 then :onboarding
+      when 190..191 then :home_settings
+
+      else :unknown
+      end
+    end
+
+    # Find the type of action by its action number
+    # @note For internal use only
+    # @!visibility private
+    def self.action_type_for(action)
+      action = ACTIONS[action]
+      return :create if CREATE_ACTIONS.include?(action)
+      return :delete if DELETE_ACTIONS.include?(action)
+      return :update if UPDATE_ACTIONS.include?(action)
+
+      :unknown
+    end
+  end
+end

data/lib/onyxcord/data/avatar_decoration.rb

@@ -0,0 +1,26 @@
+# frozen_string_literal: true
+
+module OnyxCord
+  # A decoration displayed on a user's avatar.
+  class AvatarDecoration
+    # @return [Integer] ID of the avatar decoration's SKU.
+    attr_reader :sku_id
+
+    # @return [String] ID that can be used to generate an avatar decoration URL.
+    # @see #url
+    attr_reader :decoration_id
+
+    # @!visibility private
+    def initialize(data, bot)
+      @bot = bot
+      @sku_id = data['sku_id']&.to_i
+      @decoration_id = data['asset']
+    end
+
+    # Utility method to get an avatar decoration URL.
+    # @return [String] the URL to the avatar decoration.
+    def url
+      API.avatar_decoration_url(@decoration_id)
+    end
+  end
+end

data/lib/onyxcord/data/call.rb

@@ -0,0 +1,22 @@
+# frozen_string_literal: true
+
+module OnyxCord
+  # A call in a private channel.
+  class Call
+    # @return [Time, nil] the time at when the call ended.
+    attr_reader :ended_at
+
+    # @!visibility private
+    def initialize(data, bot)
+      @bot = bot
+      @participant_ids = data['participants'] || []
+      @ended_at = Time.iso8601(data['ended_timestamp']) if data['ended_timestamp']
+    end
+
+    # Get the users that participated in this call.
+    # @return [Array<User>] the participants of this call.
+    def participants
+      @participants ||= @participant_ids.map { |participant| @bot.user(participant) }
+    end
+  end
+end