✨ Add circe support

build.sbt

@@ -1,5 +1,5 @@
 // https://typelevel.org/sbt-typelevel/faq.html#what-is-a-base-version-anyway
-ThisBuild / tlBaseVersion := "0.2" // your current series x.y
+ThisBuild / tlBaseVersion := "0.2"
 
 ThisBuild / organization     := "me.wojnowski"
 ThisBuild / organizationName := "Jakub Wojnowski"
@@ -58,4 +58,16 @@ lazy val scuid =
       )
     )
 
-lazy val root = tlCrossRootProject.aggregate(core, scuid, uuid)
+lazy val circe =
+  project
+    .in(file("circe"))
+    .dependsOn(core)
+    .settings(
+      name := "humanoid-circe",
+      libraryDependencies ++= Seq(
+        "io.circe"      %% "circe-core" % "0.14.6",
+        "org.scalameta" %% "munit"      % "0.7.29" % Test
+      )
+    )
+
+lazy val root = tlCrossRootProject.aggregate(core, scuid, uuid, circe)

circe/src/main/scala/me/wojnowski/humanoid/circe/CirceInstances.scala

@@ -0,0 +1,45 @@
+/*
+ * Copyright (c) 2023 Jakub Wojnowski
+ *
+ * Permission is hereby granted, free of charge, to any person obtaining a copy of
+ * this software and associated documentation files (the "Software"), to deal in
+ * the Software without restriction, including without limitation the rights to
+ * use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of
+ * the Software, and to permit persons to whom the Software is furnished to do so,
+ * subject to the following conditions:
+ *
+ * The above copyright notice and this permission notice shall be included in all
+ * copies or substantial portions of the Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS
+ * FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR
+ * COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER
+ * IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN
+ * CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
+ */
+
+package me.wojnowski.humanoid.circe
+
+import io.circe.Decoder
+import io.circe.Encoder
+import io.circe.KeyDecoder
+import io.circe.KeyEncoder
+import me.wojnowski.humanoid.HumanId
+import me.wojnowski.humanoid.IdConverter
+
+trait CirceInstances {
+
+  implicit def humanIdEncoder[P <: String, Id]: Encoder[HumanId[P, Id]] =
+    Encoder.encodeString.contramap(_.renderWithPrefix)
+
+  implicit def humanIdDecoder[P <: String, Id](implicit valueOfPrefix: ValueOf[P], idable: IdConverter[Id]): Decoder[HumanId[P, Id]] =
+    Decoder.decodeString.emap(HumanId.parsePrefixOptional[P, Id])
+
+  implicit def humanIdKeyEncoder[P <: String, Id]: KeyEncoder[HumanId[P, Id]] =
+    KeyEncoder.instance(_.renderWithPrefix)
+
+  implicit def humanIdKeyDecoder[P <: String, Id](implicit valueOfPrefix: ValueOf[P], idable: IdConverter[Id]): KeyDecoder[HumanId[P, Id]] =
+    KeyDecoder.instance(HumanId.parsePrefixOptional[P, Id](_).toOption)
+
+}

circe/src/main/scala/me/wojnowski/humanoid/circe/package.scala

@@ -0,0 +1,24 @@
+/*
+ * Copyright (c) 2023 Jakub Wojnowski
+ *
+ * Permission is hereby granted, free of charge, to any person obtaining a copy of
+ * this software and associated documentation files (the "Software"), to deal in
+ * the Software without restriction, including without limitation the rights to
+ * use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of
+ * the Software, and to permit persons to whom the Software is furnished to do so,
+ * subject to the following conditions:
+ *
+ * The above copyright notice and this permission notice shall be included in all
+ * copies or substantial portions of the Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS
+ * FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR
+ * COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER
+ * IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN
+ * CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
+ */
+
+package me.wojnowski.humanoid
+
+package object circe extends CirceInstances