Implement temporary bans (#391)

* Revert "Create a moderation arguments class to shrink the arguments down"

This reverts commit b82f7ef.

* Implement temporary bans

* Apply review comments
- Remove temp-ban remove, incorporate into unban
- Remove soft-ban, incorporate into main ban command

* Fix typo in command option description

docs/commands.md

@@ -345,22 +345,32 @@ None
 	* `user` - Person to ban - User
 	* `delete-message-days` - The number of days worth of messages to delete - Int
 	* `reason` - The reason for the ban - Defaulting String
+	* `soft-ban` - Weather to soft-ban this user (unban them once messages are deleted) - Defaulting Boolean
 	* `dm` - Whether to send a direct message to the user about the ban - Defaulting Boolean
 	* `image` - An image you'd like to provide as extra context for the action - Optional Attachment
 
 ---
-### Command name: `soft-ban`
-**Description**: Soft-bans a user.
+### Command name: `temp-ban add`
+**Description**: Temporarily bans a user
 
 **Required Member Permissions**: Ban Members
 
-* Arguments:
-	* `user` - Person to Soft ban - User
-	* `delete-message-days` - The number of days worth of messages to delete - Optional Int/Long
+* **Arguments**:
+	* `user` - Person to ban - User
+	* `delete-message-days` - The number of days worth of messages to delete - Int
+	* `duration` - The duration of the temporary ban. - Coalescing Duration
 	* `reason` - The reason for the ban - Defaulting String
-	* `dm` - Whether to send a direct message to the user about the soft-ban - Defaulting Boolean
+	* `dm` - Whether to send a direct message to the user about the ban - Defaulting Boolean
 	* `image` - An image you'd like to provide as extra context for the action - Optional Attachment
 
+---
+### Command name: `temp-ban view-all`
+**Description**: View all temporary bans for this guild
+
+**Required Member Permissions**: Ban Members
+
+* **Arguments**:
+None
 ---
 ### Command name: `unban`
 **Description**: Unbans a user.

src/main/kotlin/org/hyacinthbots/lilybot/database/collections/ReminderCollection.kt

@@ -11,7 +11,7 @@ import org.koin.core.component.inject
 import org.litote.kmongo.eq
 
 /**
- * This class contains the functions for interacting with []the reminder database][ReminderData]. This
+ * This class contains the functions for interacting with [the reminder database][ReminderData]. This
  * class contains functions for setting reminders, getting reminders based of various parameters, removing reminders and
  * repeating them.
  *

src/main/kotlin/org/hyacinthbots/lilybot/database/collections/TemporaryBanCollection.kt

@@ -0,0 +1,79 @@
+package org.hyacinthbots.lilybot.database.collections
+
+import com.kotlindiscord.kord.extensions.koin.KordExKoinComponent
+import dev.kord.common.entity.Snowflake
+import org.hyacinthbots.lilybot.database.Database
+import org.hyacinthbots.lilybot.database.entities.TemporaryBanData
+import org.koin.core.component.inject
+import org.litote.kmongo.eq
+
+/**
+ * This class contains the functions for interacting with [the temporary ban database][TemporaryBanData]. This class
+ * contains functions for settings temporary bans, getting temporary bans based off of various parameters and removing
+ * them.
+ *
+ * @since 5.0.0
+ * @see getAllTempBans
+ * @see getTempBansForGuild
+ * @see getUserTempBan
+ * @see setTempBan
+ * @see removeTempBan
+ */
+class TemporaryBanCollection : KordExKoinComponent {
+	private val db: Database by inject()
+
+	@PublishedApi
+	internal val collection = db.mainDatabase.getCollection<TemporaryBanData>()
+
+	/**
+	 * Gets all the temporary bans currently in the database.
+	 *
+	 * @return A list of temporary bans in the database
+	 * @author NoComment1105
+	 * @since 5.0.0
+	 */
+	suspend inline fun getAllTempBans(): List<TemporaryBanData> = collection.find().toList()
+
+	/**
+	 * Gets all the temporary bans for a given guild.
+	 *
+	 * @param guildId The ID of the guild to get the bans in
+	 * @return A list of Temporary bans for the given [guildId]
+	 * @author NoComment1105
+	 * @since 5.0.0
+	 */
+	suspend inline fun getTempBansForGuild(guildId: Snowflake): List<TemporaryBanData> =
+		collection.find(TemporaryBanData::guildId eq guildId).toList()
+
+	/**
+	 * Gets a temporary ban for a given user.
+	 *
+	 * @param guildId The ID of the guild the temporary ban occurred in
+	 * @param bannedUserId The ID of the user that was temporarily banned
+	 * @return The [TemporaryBanData] for the [bannedUserId]
+	 * @author NoComment1105
+	 * @since 5.0.0
+	 */
+	suspend inline fun getUserTempBan(guildId: Snowflake, bannedUserId: Snowflake): TemporaryBanData? =
+		collection.findOne(TemporaryBanData::guildId eq guildId, TemporaryBanData::bannedUserId eq bannedUserId)
+
+	/**
+	 * Sets a temporary ban.
+	 *
+	 * @param tempBanData The data for the temporary ban
+	 * @author NoComment1105
+	 * @since 5.0.0
+	 */
+	suspend inline fun setTempBan(tempBanData: TemporaryBanData) = collection.insertOne(tempBanData)
+
+	/**
+	 * Removes the temporary ban for a user in a given guild. This is called once a temporary ban is completed.
+	 *
+	 * @param guildId The guild the temporary ban is being removed from
+	 * @param bannedUserId The ID of the user to remove the temporary ban from
+	 * @author NoComment1105
+	 * @since 5.0.0
+	 */
+	suspend inline fun removeTempBan(guildId: Snowflake, bannedUserId: Snowflake) =
+		collection.deleteOne(TemporaryBanData::guildId eq guildId, TemporaryBanData::bannedUserId eq bannedUserId)
+}

src/main/kotlin/org/hyacinthbots/lilybot/database/entities/TemporaryBanData.kt

@@ -0,0 +1,25 @@
+package org.hyacinthbots.lilybot.database.entities
+
+import dev.kord.common.entity.Snowflake
+import kotlinx.datetime.Instant
+import kotlinx.serialization.Serializable
+
+/**
+ * The data for temporary bans in a guild.
+ *
+ * @property guildId The ID of the guild the ban occurred in
+ * @property bannedUserId The ID of the user that was banned
+ * @property moderatorUserId The ID of the moderator that applied the ban
+ * @property startTime The time the ban was applied
+ * @property endTime The time the ban will complete
+ *
+ * @since 5.0.0
+ */
+@Serializable
+data class TemporaryBanData(
+	val guildId: Snowflake,
+	val bannedUserId: Snowflake,
+	val moderatorUserId: Snowflake,
+	val startTime: Instant,
+	val endTime: Instant
+)

src/main/kotlin/org/hyacinthbots/lilybot/database/migrations/main/mainV10.kt

@@ -9,4 +9,5 @@ suspend fun mainV10(db: CoroutineDatabase) {
 	with(db.getCollection<AutoThreadingData>()) {
 		updateMany(AutoThreadingData::extraRoleIds exists false, setValue(AutoThreadingData::extraRoleIds, emptyList()))
 	}
+	db.createCollection("temporaryBanData")
 }