feat: add whitelist support and associated networking protocols

- Implemented whitelist service, repository, and data models (`WhitelistEntry`, `MutableWhitelistEntry`, `WhitelistStatus`, etc.).
- Added new network protocols for whitelist operations, including `ServerboundRequestWhitelistPacket`, `WhitelistResponsePacket`, and others.
- Introduced `CloudPlayerWhitelistManagerImpl` for managing player whitelists.
- Enhanced `CloudServer` and `ProxyCloudServer` with companion methods for retrieving entries.
- Integrated whitelist handling across Cloud API and Core modules.
- Removed unused `ArgumentSuggestion` and `LtwTestAspect` components.

Author: twisti-dev

.idea/externalDependencies.xml

@@ -1,5 +1,7 @@
 import com.github.jengelman.gradle.plugins.shadow.tasks.ShadowJar
 import dev.slne.surf.surfapi.gradle.util.slnePublic
+import jdk.javadoc.internal.tool.resources.javadoc
+import org.jetbrains.kotlin.gradle.dsl.KotlinJvmExtension
 
 buildscript {
     repositories {
@@ -45,6 +47,13 @@ allprojects {
         testImplementation(kotlin("test"))
     }
 
+    afterEvaluate {
+        extensions.findByType<KotlinJvmExtension>()?.apply {
+            compilerOptions {
+                freeCompilerArgs.add("-Xnested-type-aliases")
+            }
+        }
+    }
 
     tasks {
         configureShadowJar()

build.gradle.kts

@@ -2,12 +2,28 @@ package dev.slne.surf.cloud.api.client.server
 
 import dev.slne.surf.cloud.api.common.server.CloudServer
 import dev.slne.surf.cloud.api.common.server.CloudServerManager
+import dev.slne.surf.cloud.api.common.server.CommonCloudServer
+import dev.slne.surf.cloud.api.common.server.ProxyCloudServer
 import dev.slne.surf.cloud.api.common.util.annotation.InternalApi
 
 interface CloudClientServerManager : CloudServerManager {
+    fun current(): CommonCloudServer
     fun currentServer(): CloudServer
+    fun currentProxy(): ProxyCloudServer
 
     @OptIn(InternalApi::class)
     companion object :
         CloudClientServerManager by CloudServerManager.instance as CloudClientServerManager
+}
+
+fun CommonCloudServer.Companion.current(): CommonCloudServer {
+    return CloudClientServerManager.current()
+}
+
+fun CloudServer.Companion.current(): CloudServer {
+    return CloudClientServerManager.currentServer()
+}
+
+fun ProxyCloudServer.Companion.current(): ProxyCloudServer {
+    return CloudClientServerManager.currentProxy()
 }

surf-cloud-api/surf-cloud-api-client/surf-cloud-api-client-common/src/main/kotlin/dev/slne/surf/cloud/api/client/server/CloudClientServerManager.kt

@@ -11,6 +11,7 @@ import dev.jorel.commandapi.arguments.ArgumentSuggestions
 import dev.jorel.commandapi.arguments.CommandAPIArgumentType
 import dev.jorel.commandapi.executors.CommandArguments
 import dev.slne.surf.cloud.api.common.server.CloudServerManager
+import dev.slne.surf.cloud.api.common.server.CommonCloudServer
 import dev.slne.surf.cloud.api.common.util.annotation.InternalApi
 import dev.slne.surf.surfapi.core.api.messages.adventure.text
 
@@ -22,7 +23,7 @@ class CloudServerGroupArgument(nodeName: String) :
 
     init {
         replaceSuggestions(ArgumentSuggestions.stringCollection {
-            CloudServerManager.retrieveAllServers()
+            CommonCloudServer.all()
                 .filter { it.group.isNotEmpty() }
                 .map { it.group }
                 .distinct()

surf-cloud-api/surf-cloud-api-client/surf-cloud-api-client-velocity/src/main/kotlin/dev/slne/surf/cloud/api/client/velocity/command/args/CloudServerGroupArgument.kt

@@ -4,6 +4,7 @@ import dev.slne.surf.cloud.api.common.netty.network.codec.kotlinx.cloud.OfflineC
 import dev.slne.surf.cloud.api.common.player.name.NameHistory
 import dev.slne.surf.cloud.api.common.player.playtime.Playtime
 import dev.slne.surf.cloud.api.common.player.punishment.CloudPlayerPunishmentManager
+import dev.slne.surf.cloud.api.common.player.whitelist.CloudPlayerWhitelistManager
 import dev.slne.surf.cloud.api.common.server.CloudServer
 import kotlinx.serialization.Serializable
 import net.kyori.adventure.text.Component
@@ -34,6 +35,7 @@ interface OfflineCloudPlayer {
     val player: CloudPlayer?
 
     val punishmentManager: CloudPlayerPunishmentManager
+    val whitelistManager: CloudPlayerWhitelistManager
 
     /**
      * Suspends until the display name of the player is retrieved.

surf-cloud-api/surf-cloud-api-common/src/main/kotlin/dev/slne/surf/cloud/api/common/player/OfflineCloudPlayer.kt

@@ -0,0 +1,35 @@
+package dev.slne.surf.cloud.api.common.player.whitelist
+
+import dev.slne.surf.cloud.api.common.server.CloudServer
+import org.jetbrains.annotations.ApiStatus
+
+@ApiStatus.NonExtendable
+interface CloudPlayerWhitelistManager {
+    suspend fun whitelistStatusForGroup(group: WhitelistEntry.Group): WhitelistStatus
+    suspend fun whitelistStatusForServer(server: CloudServer): WhitelistStatus
+    suspend fun whitelistStatusForServer(serverName: WhitelistEntry.ServerName): WhitelistStatus
+
+    suspend fun whitelistForGroup(group: WhitelistEntry.Group): WhitelistEntry?
+    suspend fun whitelistForServer(server: CloudServer): WhitelistEntry?
+    suspend fun whitelistForServer(serverName: WhitelistEntry.ServerName): WhitelistEntry?
+
+
+    suspend fun editWhitelistForGroup(
+        group: WhitelistEntry.Group,
+        edit: MutableWhitelistEntry.() -> Unit
+    ): Boolean
+
+    suspend fun editWhitelistForServer(
+        server: CloudServer,
+        edit: MutableWhitelistEntry.() -> Unit
+    ): Boolean
+
+    suspend fun editWhitelistForServer(
+        serverName: WhitelistEntry.ServerName,
+        edit: MutableWhitelistEntry.() -> Unit
+    ): Boolean
+
+    suspend fun createWhitelistForGroup(blocked: Boolean, group: WhitelistEntry.Group): WhitelistEntry?
+    suspend fun createWhitelistForServer(blocked: Boolean, server: CloudServer): WhitelistEntry?
+    suspend fun createWhitelistForServer(blocked: Boolean, serverName: WhitelistEntry.ServerName): WhitelistEntry?
+}

surf-cloud-api/surf-cloud-api-common/src/main/kotlin/dev/slne/surf/cloud/api/common/player/whitelist/CloudPlayerWhitelistManager.kt

@@ -0,0 +1,26 @@
+package dev.slne.surf.cloud.api.common.player.whitelist
+
+import dev.slne.surf.cloud.api.common.server.CloudServer
+import dev.slne.surf.cloud.api.common.util.Either
+import java.time.ZonedDateTime
+import java.util.*
+
+interface WhitelistEntry {
+    val uuid: UUID
+    val groupOrServerName: Either<Group, ServerName>
+    val blocked: Boolean
+
+    val createdAt: ZonedDateTime
+    val updatedAt: ZonedDateTime
+
+    typealias Group = String
+    typealias ServerName = String
+}
+
+
+interface MutableWhitelistEntry : WhitelistEntry {
+    override var blocked: Boolean
+    fun forGroup(group: String)
+    fun forServer(server: CloudServer)
+    fun forServer(serverName: String)
+}

surf-cloud-api/surf-cloud-api-common/src/main/kotlin/dev/slne/surf/cloud/api/common/player/whitelist/WhitelistEntry.kt

@@ -0,0 +1,32 @@
+package dev.slne.surf.cloud.api.common.player.whitelist
+
+import dev.slne.surf.cloud.api.common.CloudInstance
+import dev.slne.surf.cloud.api.common.server.CloudServer
+import it.unimi.dsi.fastutil.objects.ObjectSet
+import org.jetbrains.annotations.Unmodifiable
+
+interface WhitelistSettings {
+    fun enforcedGroups(): @Unmodifiable ObjectSet<String>
+    fun enforcedServers(): @Unmodifiable ObjectSet<String>
+
+    fun isWhitelistEnforcedFor(server: CloudServer): Boolean
+    fun isWhitelistEnforcedForGroup(group: String): Boolean
+    fun isWhitelistEnforcedForServer(server: String): Boolean
+
+    fun enforceWhitelistForGroup(group: String)
+    fun enforceWhitelistForServer(server: String)
+    fun enforceWhitelistForServer(server: CloudServer)
+
+    fun disableWhitelistForGroup(group: String)
+    fun disableWhitelistForServer(server: String)
+    fun disableWhitelistForServer(server: CloudServer)
+
+
+    /**
+     * Refreshes the whitelist-enforcement state for all online players
+     * and disconnects anyone that is not permitted to stay.
+     */
+    fun refresh()
+
+    companion object : WhitelistSettings by CloudInstance.getBean(WhitelistSettings::class.java)
+}

surf-cloud-api/surf-cloud-api-common/src/main/kotlin/dev/slne/surf/cloud/api/common/player/whitelist/WhitelistSettings.kt

@@ -0,0 +1,8 @@
+package dev.slne.surf.cloud.api.common.player.whitelist
+
+enum class WhitelistStatus {
+    NONE,
+    ACTIVE,
+    BLOCKED,
+    UNKNOWN;
+}

surf-cloud-api/surf-cloud-api-common/src/main/kotlin/dev/slne/surf/cloud/api/common/player/whitelist/WhitelistStatus.kt

@@ -27,4 +27,8 @@ interface CloudServer : CommonCloudServer {
     val lobby: Boolean
 
     suspend fun pullPlayers(players: Collection<CloudPlayer>): @Unmodifiable ObjectList<Pair<CloudPlayer, ConnectionResultEnum>>
+
+    companion object {
+        fun all() = CloudServerManager.retrieveServers()
+    }
 }