feat: add JavaUUIDStringSerializer for UUID serialization and bump version to 1.21.10-2.42.0

- Introduced `JavaUUIDStringSerializer` for UUID serialization to/from strings with a custom format.
- Added `SerializableStringUUID` type alias for seamless usage.
- Updated `gradle.properties` to version 1.21.10-2.42.0.

Author: twisti-dev

gradle.properties

@@ -7,6 +7,6 @@ org.jetbrains.dokka.experimental.gradle.pluginMode=V2Enabled
 javaVersion=21
 mcVersion=1.21.10
 group=dev.slne.surf
-version=1.21.10-2.41.0
+version=1.21.10-2.42.0
 relocationPrefix=dev.slne.surf.surfapi.libs
 snapshot=false

surf-api-bukkit/surf-api-bukkit-api/api/surf-api-bukkit-api.api

@@ -13505,6 +13505,17 @@ public final class dev/slne/surf/surfapi/core/api/serializer/java/uuid/JavaUUIDS
 	public fun serialize (Lkotlinx/serialization/encoding/Encoder;Ljava/util/UUID;)V
 }
 
+public final class dev/slne/surf/surfapi/core/api/serializer/java/uuid/JavaUUIDStringSerializer : kotlinx/serialization/KSerializer {
+	public static final field INSTANCE Ldev/slne/surf/surfapi/core/api/serializer/java/uuid/JavaUUIDStringSerializer;
+	public synthetic fun deserialize (Lkotlinx/serialization/encoding/Decoder;)Ljava/lang/Object;
+	public fun deserialize (Lkotlinx/serialization/encoding/Decoder;)Ljava/util/UUID;
+	public final fun fromString (Ljava/lang/String;)Ljava/util/UUID;
+	public final fun fromUUID (Ljava/util/UUID;)Ljava/lang/String;
+	public fun getDescriptor ()Lkotlinx/serialization/descriptors/SerialDescriptor;
+	public synthetic fun serialize (Lkotlinx/serialization/encoding/Encoder;Ljava/lang/Object;)V
+	public fun serialize (Lkotlinx/serialization/encoding/Encoder;Ljava/util/UUID;)V
+}
+
 public final class dev/slne/surf/surfapi/core/api/serializer/kotlin/KotlinDurationCodec {
 	public static final field INSTANCE Ldev/slne/surf/surfapi/core/api/serializer/kotlin/KotlinDurationCodec;
 	public final fun getCODEC ()Lcom/mojang/serialization/Codec;

surf-api-core/surf-api-core-api/api/surf-api-core-api.api

@@ -8132,6 +8132,17 @@ public final class dev/slne/surf/surfapi/core/api/serializer/java/uuid/JavaUUIDS
 	public fun serialize (Lkotlinx/serialization/encoding/Encoder;Ljava/util/UUID;)V
 }
 
+public final class dev/slne/surf/surfapi/core/api/serializer/java/uuid/JavaUUIDStringSerializer : kotlinx/serialization/KSerializer {
+	public static final field INSTANCE Ldev/slne/surf/surfapi/core/api/serializer/java/uuid/JavaUUIDStringSerializer;
+	public synthetic fun deserialize (Lkotlinx/serialization/encoding/Decoder;)Ljava/lang/Object;
+	public fun deserialize (Lkotlinx/serialization/encoding/Decoder;)Ljava/util/UUID;
+	public final fun fromString (Ljava/lang/String;)Ljava/util/UUID;
+	public final fun fromUUID (Ljava/util/UUID;)Ljava/lang/String;
+	public fun getDescriptor ()Lkotlinx/serialization/descriptors/SerialDescriptor;
+	public synthetic fun serialize (Lkotlinx/serialization/encoding/Encoder;Ljava/lang/Object;)V
+	public fun serialize (Lkotlinx/serialization/encoding/Encoder;Ljava/util/UUID;)V
+}
+
 public final class dev/slne/surf/surfapi/core/api/serializer/kotlin/KotlinDurationCodec {
 	public static final field INSTANCE Ldev/slne/surf/surfapi/core/api/serializer/kotlin/KotlinDurationCodec;
 	public final fun getCODEC ()Ldev/slne/surf/surfapi/libs/mojang/serialization/Codec;

surf-api-core/surf-api-core-api/src/main/kotlin/dev/slne/surf/surfapi/core/api/serializer/java/uuid/JavaUUIDStringSerializer.kt

@@ -0,0 +1,35 @@
+package dev.slne.surf.surfapi.core.api.serializer.java.uuid
+
+import kotlinx.serialization.KSerializer
+import kotlinx.serialization.Serializable
+import kotlinx.serialization.descriptors.PrimitiveKind
+import kotlinx.serialization.descriptors.PrimitiveSerialDescriptor
+import kotlinx.serialization.encoding.Decoder
+import kotlinx.serialization.encoding.Encoder
+import java.util.*
+
+typealias SerializableStringUUID = @Serializable(with = JavaUUIDStringSerializer::class) UUID
+
+object JavaUUIDStringSerializer : KSerializer<UUID> {
+    override val descriptor = PrimitiveSerialDescriptor("surfapi.StringUuid", PrimitiveKind.STRING)
+
+    override fun serialize(encoder: Encoder, value: UUID) {
+        encoder.encodeString(value.toString())
+    }
+
+    override fun deserialize(decoder: Decoder): UUID {
+        return fromString(decoder.decodeString())
+    }
+
+    fun fromUUID(value: UUID): String {
+        return value.toString().replace("-", "")
+    }
+
+    fun fromString(input: String): UUID {
+        return UUID.fromString(
+            input.replaceFirst(
+                "(\\w{8})(\\w{4})(\\w{4})(\\w{4})(\\w{12})".toRegex(), "$1-$2-$3-$4-$5"
+            )
+        )
+    }
+}

surf-api-velocity/surf-api-velocity-api/api/surf-api-velocity-api.api

@@ -11438,6 +11438,17 @@ public final class dev/slne/surf/surfapi/core/api/serializer/java/uuid/JavaUUIDS
 	public fun serialize (Lkotlinx/serialization/encoding/Encoder;Ljava/util/UUID;)V
 }
 
+public final class dev/slne/surf/surfapi/core/api/serializer/java/uuid/JavaUUIDStringSerializer : kotlinx/serialization/KSerializer {
+	public static final field INSTANCE Ldev/slne/surf/surfapi/core/api/serializer/java/uuid/JavaUUIDStringSerializer;
+	public synthetic fun deserialize (Lkotlinx/serialization/encoding/Decoder;)Ljava/lang/Object;
+	public fun deserialize (Lkotlinx/serialization/encoding/Decoder;)Ljava/util/UUID;
+	public final fun fromString (Ljava/lang/String;)Ljava/util/UUID;
+	public final fun fromUUID (Ljava/util/UUID;)Ljava/lang/String;
+	public fun getDescriptor ()Lkotlinx/serialization/descriptors/SerialDescriptor;
+	public synthetic fun serialize (Lkotlinx/serialization/encoding/Encoder;Ljava/lang/Object;)V
+	public fun serialize (Lkotlinx/serialization/encoding/Encoder;Ljava/util/UUID;)V
+}
+
 public final class dev/slne/surf/surfapi/core/api/serializer/kotlin/KotlinDurationCodec {
 	public static final field INSTANCE Ldev/slne/surf/surfapi/core/api/serializer/kotlin/KotlinDurationCodec;
 	public final fun getCODEC ()Lcom/mojang/serialization/Codec;