lib_discord 0.1.0.pre2 → 0.1.1

data/lib/lib_discord/auto_moderation.rb

@@ -0,0 +1,106 @@
+# frozen_string_literal: true
+
+require "lib_discord/resource"
+
+module LibDiscord
+  ##
+  # Auto Moderation
+  #
+  # Do not instantiate an {AutoModeration} directly. Instead request one from
+  # an instance of {Client}.
+  #
+  #   client = LibDiscord::Client.new("Bot auth.token")
+  #   a = client["auto_moderation"]
+  #
+  # @see https://discord.com/developers/docs/resources/auto-moderation Discord
+  #   documentation "Auto Moderation"
+  class AutoModeration < Resource
+    ##
+    # @param guild_id [#to_s]
+    #   {https://discord.com/developers/docs/reference#snowflakes Discord
+    #   documentation "Snowflakes"}
+    #
+    # @return [Response]
+    #
+    # @raise [TimeoutError] if the HTTP request times out
+    #
+    # @see https://discord.com/developers/docs/resources/auto-moderation#list-auto-moderation-rules-for-guild
+    #   Discord documentation "List Auto Moderation Rules for Guild"
+    def list_auto_moderation_rules_for_guild(guild_id:)
+      send_request(:get, "/guilds/#{guild_id}/auto-moderation/rules")
+    end
+
+    ##
+    # @param guild_id [#to_s]
+    #   {https://discord.com/developers/docs/reference#snowflakes Discord
+    #   documentation "Snowflakes"}
+    # @param auto_moderation_rule_id [#to_s]
+    #   {https://discord.com/developers/docs/reference#snowflakes Discord
+    #   documentation "Snowflakes"}
+    #
+    # @return [Response]
+    #
+    # @raise [TimeoutError] if the HTTP request times out
+    #
+    # @see https://discord.com/developers/docs/resources/auto-moderation#get-auto-moderation-rule
+    #   Discord documentation "Get Auto Moderation Rule"
+    def get_auto_moderation_rule(guild_id:, auto_moderation_rule_id:)
+      send_request(:get, "/guilds/#{guild_id}/auto-moderation/rules/#{auto_moderation_rule_id}")
+    end
+
+    ##
+    # @param guild_id [#to_s]
+    #   {https://discord.com/developers/docs/reference#snowflakes Discord
+    #   documentation "Snowflakes"}
+    # @param json [Hash] JSON serializable payload
+    #
+    # @return [Response]
+    #
+    # @raise [TimeoutError] if the HTTP request times out
+    # @raise [ConstraintError] if +json+ cannot be serialized to JSON
+    #
+    # @see https://discord.com/developers/docs/resources/auto-moderation#create-auto-moderation-rule
+    #   Discord documentation "Create Auto Moderation Rule"
+    def create_auto_moderation_rule(guild_id:, json:)
+      send_request(:post, "/guilds/#{guild_id}/auto-moderation/rules", json:)
+    end
+
+    ##
+    # @param guild_id [#to_s]
+    #   {https://discord.com/developers/docs/reference#snowflakes Discord
+    #   documentation "Snowflakes"}
+    # @param auto_moderation_rule_id [#to_s]
+    #   {https://discord.com/developers/docs/reference#snowflakes Discord
+    #   documentation "Snowflakes"}
+    # @param json [Hash] JSON serializable payload
+    #
+    # @return [Response]
+    #
+    # @raise [TimeoutError] if the HTTP request times out
+    # @raise [ConstraintError] if +json+ cannot be serialized to JSON
+    #
+    # @see https://discord.com/developers/docs/resources/auto-moderation#modify-auto-moderation-rule
+    #   Discord documentation "Modify Auto Moderation Rule"
+    def modify_auto_moderation_rule(guild_id:, auto_moderation_rule_id:, json:)
+      send_request(:patch, "/guilds/#{guild_id}/auto-moderation/rules/#{auto_moderation_rule_id}", json:)
+    end
+
+    ##
+    # @param guild_id [#to_s]
+    #   {https://discord.com/developers/docs/reference#snowflakes Discord
+    #   documentation "Snowflakes"}
+    # @param auto_moderation_rule_id [#to_s]
+    #   {https://discord.com/developers/docs/reference#snowflakes Discord
+    #   documentation "Snowflakes"}
+    #
+    # @return [Response]
+    #
+    # @raise [TimeoutError] if the HTTP request times out
+    #
+    # @see https://discord.com/developers/docs/resources/auto-moderation#delete-auto-moderation-rule
+    #   Discord documentation "Delete Auto Moderation Rule"
+    def delete_auto_moderation_rule(guild_id:, auto_moderation_rule_id:)
+      send_request(:delete, "/guilds/#{guild_id}/auto-moderation/rules/#{auto_moderation_rule_id}")
+    end
+  end
+end