feat: add codecs and serializers for URL and Kotlin/Java Duration; enhance UUID codec with alternative formats

- Added `URL` codec and serializer using `URICodec` for conversion handling.
- Enhanced `JavaUUIDCodec` with support for string and byte representations.
- Introduced `KotlinDuration` and `JavaDuration` codecs and serializers.
- Integrated new codecs and serializers into `SurfCodecs` and `SurfSerializerModule`.

Author: twisti-dev

surf-api-core/surf-api-core-api/src/main/kotlin/dev/slne/surf/surfapi/core/api/serializer/SurfCodecs.kt

@@ -11,6 +11,7 @@ import dev.slne.surf.surfapi.core.api.serializer.adventure.resourcepack.info.Adv
 import dev.slne.surf.surfapi.core.api.serializer.adventure.sound.AdventureSoundCodec
 import dev.slne.surf.surfapi.core.api.serializer.adventure.sound.stop.AdventureSoundStopCodec
 import dev.slne.surf.surfapi.core.api.serializer.adventure.title.AdventureTitleCodec
+import dev.slne.surf.surfapi.core.api.serializer.java.JavaDurationCodec
 import dev.slne.surf.surfapi.core.api.serializer.java.datetime.date.date.DateCodec
 import dev.slne.surf.surfapi.core.api.serializer.java.datetime.date.local.LocalDateCodec
 import dev.slne.surf.surfapi.core.api.serializer.java.datetime.datetime.instant.InstantCodec
@@ -25,7 +26,9 @@ import dev.slne.surf.surfapi.core.api.serializer.java.ip.inetsocket.InetSocketAd
 import dev.slne.surf.surfapi.core.api.serializer.java.ip.ipv4.Inet4AddressCodec
 import dev.slne.surf.surfapi.core.api.serializer.java.ip.ipv6.Inet6AddressCodec
 import dev.slne.surf.surfapi.core.api.serializer.java.uri.URICodec
+import dev.slne.surf.surfapi.core.api.serializer.java.url.URLCodec
 import dev.slne.surf.surfapi.core.api.serializer.java.uuid.JavaUUIDCodec
+import dev.slne.surf.surfapi.core.api.serializer.kotlin.KotlinDurationCodec
 import dev.slne.surf.surfapi.core.api.serializer.spongepowered.math.matrix.m2d.SpongeMatrix2dCodec
 import dev.slne.surf.surfapi.core.api.serializer.spongepowered.math.matrix.m2f.SpongeMatrix2fCodec
 import dev.slne.surf.surfapi.core.api.serializer.spongepowered.math.matrix.m3d.SpongeMatrix3dCodec
@@ -99,6 +102,7 @@ object SurfCodecs {
 
     // region Java
     val URI = URICodec.CODEC
+    val URL = URLCodec.CODEC
     val UUID = JavaUUIDCodec.CODEC
     val DATE = DateCodec.CODEC
     val LOCAL_DATE = LocalDateCodec.CODEC
@@ -113,5 +117,10 @@ object SurfCodecs {
     val INET_SOCKET_ADDRESS = InetSocketAddressCodec.CODEC
     val INET4_ADDRESS = Inet4AddressCodec.CODEC
     val INET6_ADDRESS = Inet6AddressCodec.CODEC
+    val JAVA_DURATION = JavaDurationCodec.CODEC
+    // endregion
+
+    // region Kotlin
+    val KOTLIN_DURATION = KotlinDurationCodec.CODEC
     // endregion
 }

surf-api-core/surf-api-core-api/src/main/kotlin/dev/slne/surf/surfapi/core/api/serializer/SurfSerializerModule.kt

@@ -26,6 +26,7 @@ import dev.slne.surf.surfapi.core.api.serializer.java.ip.inetsocket.InetSocketAd
 import dev.slne.surf.surfapi.core.api.serializer.java.ip.ipv4.Inet4AddressSerializer
 import dev.slne.surf.surfapi.core.api.serializer.java.ip.ipv6.Inet6AddressSerializer
 import dev.slne.surf.surfapi.core.api.serializer.java.uri.URISerializer
+import dev.slne.surf.surfapi.core.api.serializer.java.url.URLSerializer
 import dev.slne.surf.surfapi.core.api.serializer.java.uuid.JavaUUIDSerializer
 import dev.slne.surf.surfapi.core.api.serializer.spongepowered.math.matrix.m2d.SpongeMatrix2dSerializer
 import dev.slne.surf.surfapi.core.api.serializer.spongepowered.math.matrix.m2f.SpongeMatrix2fSerializer
@@ -118,6 +119,7 @@ object SurfSerializerModule {
         contextual(InetSocketAddressSerializer)
         contextual(Inet4AddressSerializer)
         contextual(Inet6AddressSerializer)
+        contextual(URLSerializer)
     }
 
     val all = SerializersModule {

surf-api-core/surf-api-core-api/src/main/kotlin/dev/slne/surf/surfapi/core/api/serializer/java/uri/URICodec.kt

@@ -12,7 +12,5 @@ object URICodec {
         } catch (e: URISyntaxException) {
             DataResult.error { "Uri syntax error: ${e.message}" }
         }
-    }, { uri ->
-        uri.toString()
-    }).stable()
+    }, URI::toString).stable()
 }

surf-api-core/surf-api-core-api/src/main/kotlin/dev/slne/surf/surfapi/core/api/serializer/java/url/URLCodec.kt

@@ -2,18 +2,25 @@ package dev.slne.surf.surfapi.core.api.serializer.java.url
 
 import com.mojang.serialization.Codec
 import com.mojang.serialization.DataResult
-import java.net.URI
+import dev.slne.surf.surfapi.core.api.serializer.java.uri.URICodec
+import java.net.MalformedURLException
 import java.net.URISyntaxException
 import java.net.URL
 
 object URLCodec {
-    val CODEC: Codec<URL> = Codec.STRING.comapFlatMap({ string ->
+    val CODEC: Codec<URL> = URICodec.CODEC.flatXmap({ uri ->
         try {
-            DataResult.success(URI(string).toURL())
-        } catch (e: URISyntaxException) {
-            DataResult.error { "Url syntax error: ${e.message}" }
+            DataResult.success(uri.toURL())
+        } catch (e: MalformedURLException) {
+            DataResult.error { "Malformed URL: ${e.message}" }
+        } catch (e: IllegalArgumentException) {
+            DataResult.error { "URL is not absolute: ${e.message}" }
         }
     }, { url ->
-        url.toURI().toString()
-    }).stable()
+        try {
+            DataResult.success(url.toURI())
+        } catch (e: URISyntaxException) {
+            DataResult.error { "URI syntax error: ${e.message}" }
+        }
+    })
 }

surf-api-core/surf-api-core-api/src/main/kotlin/dev/slne/surf/surfapi/core/api/serializer/java/url/URLSerializer.kt

@@ -1,10 +1,23 @@
-@file:OptIn(ExperimentalSerializationApi::class)
-
 package dev.slne.surf.surfapi.core.api.serializer.java.url
 
-import kotlinx.serialization.ExperimentalSerializationApi
+import dev.slne.surf.surfapi.core.api.serializer.java.uri.URISerializer
+import kotlinx.serialization.KSerializer
+import kotlinx.serialization.Serializable
+import kotlinx.serialization.descriptors.SerialDescriptor
+import kotlinx.serialization.encoding.Decoder
+import kotlinx.serialization.encoding.Encoder
+import java.net.URL
+
+typealias SerializableURL = @Serializable(with = URLSerializer::class) URL
+
+object URLSerializer : KSerializer<URL> {
+    override val descriptor = SerialDescriptor("surfapi.JavaURL", URISerializer.descriptor)
+
+    override fun serialize(encoder: Encoder, value: URL) {
+        URISerializer.serialize(encoder, value.toURI())
+    }
 
-//typealias SerializableURL = @Serializable(with = URLSerializer::class) URL
-//
-//@Serializer(forClass = URL::class)
-//object URLSerializer : KSerializer<URL>
+    override fun deserialize(decoder: Decoder): URL {
+        return URISerializer.deserialize(decoder).toURL()
+    }
+}

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

@@ -5,11 +5,15 @@ import dev.slne.surf.surfapi.core.api.serializer.fixedSize
 import java.util.*
 
 object JavaUUIDCodec {
-    val CODEC: Codec<UUID> = Codec.LONG_STREAM
+    val CODEC_BYTES: Codec<UUID> = Codec.LONG_STREAM
         .fixedSize(2)
         .xmap({ bytes ->
             UUID(bytes[0], bytes[1])
         }, { uuid ->
             longArrayOf(uuid.mostSignificantBits, uuid.leastSignificantBits)
         })
+
+    val CODEC_STRING: Codec<UUID> = Codec.STRING.xmap(UUID::fromString, UUID::toString)
+
+    val CODEC: Codec<UUID> = Codec.withAlternative(CODEC_BYTES, CODEC_STRING)
 }