feat: Add findClanByUuid method to APIs and service implementations

- Introduce `findClanByUuid(clanUuid: UUID)` in `ClanService` and `SurfClanApi` to enable clan lookup by UUID.
- Update `ClanServiceImpl` and `SurfClanApiImpl` to implement the new method.

Author: TheBjoRedCraft

surf-clan-api/src/main/kotlin/dev/slne/clan/api/SurfClanApi.kt

@@ -12,6 +12,7 @@ val surfClanApi = requiredService<SurfClanApi>()
 interface SurfClanApi {
     fun findClan(player: Player): Clan?
     fun findClan(playerUuid: UUID): Clan?
+    fun findClanByUuid(clanUuid: UUID): Clan?
     suspend fun findClanPlayer(player: Player): ClanPlayer
 
     fun getWhitelistedClans(): ObjectSet<String>

surf-clan-core/src/main/kotlin/dev/slne/clan/core/service/ClanService.kt

@@ -14,6 +14,7 @@ interface ClanService {
     fun findClanByTag(tag: String): Clan?
     fun findClanByName(name: String): Clan?
     fun findClanByMember(uuid: UUID): Clan?
+    fun findClanByUuid(clanUuid: UUID): Clan?
     fun findInvitesByMember(memberUuid: UUID): ObjectSet<ClanInvite>
     fun findClanByInvite(invite: ClanInvite): Clan?
 

surf-clan-fallback/src/main/kotlin/dev/slne/surf/clan/fallback/service/ClanServiceImpl.kt

@@ -44,6 +44,9 @@ class ClanServiceImpl : ClanService, Services.Fallback {
     override fun findClanByMember(uuid: UUID) =
         clans.find { it.members.any { member -> member.uuid == uuid } }
 
+    override fun findClanByUuid(clanUuid: UUID): Clan? =
+        clans.find { it.uuid == clanUuid }
+
     override fun findInvitesByMember(memberUuid: UUID) =
         clans.flatMap { it.invites }.filter { it.invited == memberUuid }.toObjectSet()
 

surf-clan-velocity/src/main/kotlin/dev/slne/clan/velocity/api/SurfClanApiImpl.kt

@@ -17,6 +17,7 @@ import java.util.*
 class SurfClanApiImpl : SurfClanApi, Services.Fallback {
     override fun findClan(player: Player) = clanService.findClanByMember(player.uniqueId)
     override fun findClan(playerUuid: UUID) = clanService.findClanByMember(playerUuid)
+    override fun findClanByUuid(clanUuid: UUID) = clanService.findClanByUuid(clanUuid)
 
     override suspend fun findClanPlayer(player: Player) =
         clanPlayerService.findClanPlayerByUuid(player.uniqueId) ?: error("ClanPlayer not found")