Introducing auto moderation

.gitignore

@@ -44,3 +44,6 @@ src-old/examples/java/TestReceive.java
 src-old/main/java/net/dv8tion/jda/events/audio/AudioMovedEvent.java
 src-old/main/java/net/dv8tion/jda/ratelimit/Bucket.java
 src-old/main/java/net/dv8tion/jda/ratelimit/RateLimitControl.java
+
+# MacOS files
+.DS_Store

src/main/java/net/dv8tion/jda/api/audit/ActionType.java

@@ -533,6 +533,71 @@ public enum ActionType
      */
     THREAD_DELETE(112, TargetType.THREAD),
 
+    /**
+     * A user created an {@link net.dv8tion.jda.api.entities.AutoModerationRule auto moderation rule}
+     *
+     * <h4>Possible Keys</h4>
+     * <ul>
+     *     <li>{@link net.dv8tion.jda.api.audit.AuditLogKey#ID ID}</li>
+     *     <li>{@link net.dv8tion.jda.api.audit.AuditLogKey#AUTO_MODERATION_GUILD GUILD}</li>
+     *     <li>{@link net.dv8tion.jda.api.audit.AuditLogKey#AUTO_MODERATION_RULE_NAME RULE_NAME}</li>
+     *     <li>{@link net.dv8tion.jda.api.audit.AuditLogKey#AUTO_MODERATION_CREATOR CREATOR}</li>
+     *     <li>{@link net.dv8tion.jda.api.audit.AuditLogKey#AUTO_MODERATION_EVENT_TYPE EVENT_TYPE}</li>
+     *     <li>{@link net.dv8tion.jda.api.audit.AuditLogKey#AUTO_MODERATION_TRIGGER_TYPE TRIGGER_TYPE}</li>
+     *     <li>{@link net.dv8tion.jda.api.audit.AuditLogKey#AUTO_MODERATION_TRIGGER_METADATA METADETA}</li>
+     *     <li>{@link java.util.List}&lt;{@link net.dv8tion.jda.api.audit.AuditLogKey#AUTO_MODERATION_ACTIONS}&gt;</li>
+     *     <li>{@link net.dv8tion.jda.api.audit.AuditLogKey#AUTO_MODERATION_ENABLED ENABLED}</li>
+     *     <li>{@link java.util.List}&lt;{@link net.dv8tion.jda.api.audit.AuditLogKey#AUTO_MODERATION_EXEMPT_ROLES}&gt;</li>
+     *     <li>{@link java.util.List}&lt;{@link net.dv8tion.jda.api.audit.AuditLogKey#AUTO_MODERATION_EXEMPT_CHANNELS}&gt;</li>
+     * </ul>
+     */
+    AUTO_MODERATION_RULE_CREATE(140, TargetType.AUTO_MODERATION_RULE),
+
+    /**
+     * A user updated an {@link net.dv8tion.jda.api.entities.AutoModerationRule auto moderation rule}
+     *
+     * <h4>Possible Keys</h4>
+     * <ul>
+     *     <li>{@link net.dv8tion.jda.api.audit.AuditLogKey#ID ID}</li>
+     *     <li>{@link net.dv8tion.jda.api.audit.AuditLogKey#AUTO_MODERATION_GUILD GUILD}</li>
+     *     <li>{@link net.dv8tion.jda.api.audit.AuditLogKey#AUTO_MODERATION_RULE_NAME RULE_NAME}</li>
+     *     <li>{@link net.dv8tion.jda.api.audit.AuditLogKey#AUTO_MODERATION_CREATOR CREATOR}</li>
+     *     <li>{@link net.dv8tion.jda.api.audit.AuditLogKey#AUTO_MODERATION_EVENT_TYPE EVENT_TYPE}</li>
+     *     <li>{@link net.dv8tion.jda.api.audit.AuditLogKey#AUTO_MODERATION_TRIGGER_TYPE TRIGGER_TYPE}</li>
+     *     <li>{@link net.dv8tion.jda.api.audit.AuditLogKey#AUTO_MODERATION_TRIGGER_METADATA METADETA}</li>
+     *     <li>{@link java.util.List}&lt;{@link net.dv8tion.jda.api.audit.AuditLogKey#AUTO_MODERATION_ACTIONS}&gt;</li>
+     *     <li>{@link net.dv8tion.jda.api.audit.AuditLogKey#AUTO_MODERATION_ENABLED ENABLED}</li>
+     *     <li>{@link java.util.List}&lt;{@link net.dv8tion.jda.api.audit.AuditLogKey#AUTO_MODERATION_EXEMPT_ROLES}&gt;</li>
+     *     <li>{@link java.util.List}&lt;{@link net.dv8tion.jda.api.audit.AuditLogKey#AUTO_MODERATION_EXEMPT_CHANNELS}&gt;</li>
+     * </ul>
+     */
+    AUTO_MODERATION_RULE_UPDATE(141, TargetType.AUTO_MODERATION_RULE),
+
+    /**
+     * A user deleted an {@link net.dv8tion.jda.api.entities.AutoModerationRule auto moderation rule}
+     *
+     * <h4>Possible Keys</h4>
+     * <ul>
+     *     <li>{@link net.dv8tion.jda.api.audit.AuditLogKey#ID ID}</li>
+     *     <li>{@link net.dv8tion.jda.api.audit.AuditLogKey#AUTO_MODERATION_GUILD GUILD}</li>
+     *     <li>{@link net.dv8tion.jda.api.audit.AuditLogKey#AUTO_MODERATION_RULE_NAME RULE_NAME}</li>
+     *     <li>{@link net.dv8tion.jda.api.audit.AuditLogKey#AUTO_MODERATION_CREATOR CREATOR}</li>
+     *     <li>{@link net.dv8tion.jda.api.audit.AuditLogKey#AUTO_MODERATION_EVENT_TYPE EVENT_TYPE}</li>
+     *     <li>{@link net.dv8tion.jda.api.audit.AuditLogKey#AUTO_MODERATION_TRIGGER_TYPE TRIGGER_TYPE}</li>
+     *     <li>{@link net.dv8tion.jda.api.audit.AuditLogKey#AUTO_MODERATION_TRIGGER_METADATA METADETA}</li>
+     *     <li>{@link java.util.List}&lt;{@link net.dv8tion.jda.api.audit.AuditLogKey#AUTO_MODERATION_ACTIONS}&gt;</li>
+     *     <li>{@link net.dv8tion.jda.api.audit.AuditLogKey#AUTO_MODERATION_ENABLED ENABLED}</li>
+     *     <li>{@link java.util.List}&lt;{@link net.dv8tion.jda.api.audit.AuditLogKey#AUTO_MODERATION_EXEMPT_ROLES}&gt;</li>
+     *     <li>{@link java.util.List}&lt;{@link net.dv8tion.jda.api.audit.AuditLogKey#AUTO_MODERATION_EXEMPT_CHANNELS}&gt;</li>
+     * </ul>
+     */
+    AUTO_MODERATION_RULE_DELETE(142, TargetType.AUTO_MODERATION_RULE),
+
+    /**
+     * When a message is blocked by an {@link net.dv8tion.jda.api.entities.AutoModerationRule auto moderation rule}
+     */
+    AUTO_MODERATION_BLOCK_MESSAGE(143, TargetType.AUTO_MODERATION_RULE),
+
     UNKNOWN(-1, TargetType.UNKNOWN);
 
     private final int key;

src/main/java/net/dv8tion/jda/api/audit/AuditLogKey.java

@@ -20,6 +20,8 @@
 import net.dv8tion.jda.api.entities.GuildChannel;
 import net.dv8tion.jda.api.entities.ICategorizableChannel;
 import net.dv8tion.jda.api.entities.ThreadChannel;
+import net.dv8tion.jda.api.entities.automod.AutoModerationActionType;
+import net.dv8tion.jda.api.entities.automod.KeywordPresetType;
 import net.dv8tion.jda.api.entities.emoji.RichCustomEmoji;
 
 /**
@@ -560,8 +562,85 @@ public enum AuditLogKey
      *
      * <p>Expected type: <b>int</b>
      */
-    INVITE_MAX_USES("max_uses");
+    INVITE_MAX_USES("max_uses"),
 
+    /**
+     * The guild where the auto moderation rule was created.
+     *
+     * <p>Expected type: <b>String</b>
+     */
+    AUTO_MODERATION_GUILD("guild_id"),
+
+    /**
+     * The name of the auto moderation rule that was created/updated/deleted.
+     *
+     * <p>Expected type: <b>String</b>
+     */
+    AUTO_MODERATION_RULE_NAME("name"),
+
+    /**
+     * The user who created/updated/deleted the auto moderation rule.
+     *
+     * <p>Expected type: <b>String</b>
+     */
+    AUTO_MODERATION_CREATOR("user_id"),
+
+    /**
+     * The event that will cause the auto moderation system to check for a specific trigger.
+     *
+     * <p>Expected type: <b>Integer</b>
+     */
+    AUTO_MODERATION_EVENT_TYPE("event_type"),
+
+    /**
+     * What caused the auto moderation system to be triggered.
+     *
+     * <p>Expected type: <b>Integer</b>
+     */
+    AUTO_MODERATION_TRIGGER_TYPE("trigger_type"),
+
+    /**
+     * This is additional data used whether a rule should be executed or not.
+     *
+     * <p>Expected types:
+     * <ul>
+     *      <li><b>A list of keyword filter (String)</b></li>
+     *      <li><b>A list of presets values (int)</b></li>
+     * </ul>
+     */
+    AUTO_MODERATION_TRIGGER_METADATA("trigger_metadata"),
+
+    /**
+     * The actions which will be carried out when the auto moderation rule is executed.
+     *
+     * <p>Expected types:
+     * <ul>
+     *     <li><b>action type object</b></li>
+     *     <li><b>action metadata object</b></li>
+     * </ul>
+     */
+    AUTO_MODERATION_ACTIONS("actions"),
+
+    /**
+     * Whether this auto moderation rule is enabled or not.
+     *
+     * <p>Expected type: <b>boolean</b>
+     */
+    AUTO_MODERATION_ENABLED("enabled"),
+
+    /**
+     * The roles that are exempt from an auto moderation rule.
+     *
+     * <p>Expected type: <b>String</b>
+     */
+    AUTO_MODERATION_EXEMPT_ROLES("exempt_roles"),
+
+    /**
+     * The guild channels that are exempt from an auto moderation rule.
+     *
+     * <p>Expected type: <b>String</b>
+     */
+    AUTO_MODERATION_EXEMPT_CHANNELS("exempt_channels");
 
     private final String key;
 

src/main/java/net/dv8tion/jda/api/audit/TargetType.java

@@ -41,5 +41,6 @@ public enum TargetType
     INTEGRATION,
     STAGE_INSTANCE,
     THREAD,
+    AUTO_MODERATION_RULE,
     UNKNOWN
 }

src/main/java/net/dv8tion/jda/api/entities/AutoModerationRule.java

@@ -0,0 +1,111 @@
+/*
+ * Copyright 2015 Austin Keener, Michael Ritter, Florian Spieß, and the JDA contributors
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *    http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+package net.dv8tion.jda.api.entities;
+
+import net.dv8tion.jda.api.entities.automod.AutoModerationAction;
+import net.dv8tion.jda.api.entities.automod.EventType;
+import net.dv8tion.jda.api.entities.automod.TriggerMetadata;
+import net.dv8tion.jda.api.entities.automod.TriggerType;
+
+import javax.annotation.Nonnull;
+import java.util.List;
+
+/**
+ * Represents a Discord auto moderation rule.
+ * <br>
+ * Auto Moderation is a feature which allows each guild to set up rules that trigger based on some criteria.
+ * For example, a rule can trigger whenever a message contains a specific keyword.
+ */
+public interface AutoModerationRule extends ISnowflake, Comparable<AutoModerationRule>
+{
+    /**
+     * Returns the Guild that the rule belongs to.
+     *
+     * @return {@link Guild Guild}
+     */
+    @Nonnull
+    Guild getGuild();
+
+    /**
+     * Returns the name of the rule.
+     *
+     * @return {@link String String}
+     */
+    @Nonnull
+    String getName();
+
+    /**
+     * Returns the user who created the rule.
+     *
+     * @return {@link User User}
+     */
+    @Nonnull
+    User getUser();
+
+    /**
+     * Returns the type of event that can potentially trigger this rule.
+     *
+     * @return {@link EventType EventType}
+     */
+    @Nonnull
+    EventType getEventType();
+
+    /**
+     * Returns the type of trigger that can cause this rule to be executed.
+     *
+     * @return {@link TriggerType TriggerTypes}
+     */
+    @Nonnull
+    TriggerType getTriggerType();
+
+    /**
+     * Returns additional metadata for the trigger of this rule, used whenever this rule is executed.
+     *
+     * @return {@link TriggerMetadata TriggerMetadata}
+     */
+    @Nonnull
+    TriggerMetadata getTriggerMetadata();
+
+    /**
+     * Returns the actions that will be performed when this rule is executed.
+     *
+     * @return A {@link List List} of {@link AutoModerationAction Actions}
+     */
+    @Nonnull
+    List<AutoModerationAction> getActions();
+
+    /**
+     * Returns whether this rule is enabled or not.
+     *
+     * @return True, if this is enabled
+     */
+    boolean isEnabled();
+
+    /**
+     * Returns the roles that are exempt from this rule.
+     *
+     * @return A {@link List List} of {@link Role Roles} which are exempt from the rules.
+     */
+    List<Role> getExemptRoles();
+
+    /**
+     * Returns the channels that are exempt from this rule.
+     *
+     * @return A {@link List List} of {@link GuildChannel Channels} which are exempt from the rules.
+     */
+    List<GuildChannel> getExemptChannels();
+}