feat: form schema router support, with test

Author: jwilkinson87

src/main/kotlin/com/ctrlhub/core/datacapture/response/FormSchema.kt

@@ -3,11 +3,13 @@ package com.ctrlhub.core.datacapture.response
 import com.fasterxml.jackson.annotation.JsonCreator
 import com.fasterxml.jackson.annotation.JsonProperty
 import com.fasterxml.jackson.databind.JsonNode
+import com.github.jasminb.jsonapi.StringIdHandler
+import com.github.jasminb.jsonapi.annotations.Id
 import com.github.jasminb.jsonapi.annotations.Type
 
-@Type("")
+@Type("form-schemas")
 data class FormSchema @JsonCreator constructor(
-    val id: String,
+    @Id(StringIdHandler::class) val id: String = "",
 
     @JsonProperty("model")
     private val modelNode: JsonNode,

src/test/kotlin/com/ctrlhub/core/datacapture/FormSchemasRouterTest.kt

@@ -0,0 +1,49 @@
+package com.ctrlhub.core.datacapture
+
+import com.ctrlhub.core.configureForTest
+import io.ktor.client.HttpClient
+import io.ktor.client.engine.mock.MockEngine
+import io.ktor.client.engine.mock.respond
+import io.ktor.http.HttpHeaders
+import io.ktor.http.HttpStatusCode
+import io.ktor.http.headersOf
+import io.ktor.utils.io.ByteReadChannel
+import kotlinx.coroutines.runBlocking
+import java.nio.file.Files
+import java.nio.file.Paths
+import kotlin.test.Test
+import kotlin.test.assertEquals
+import kotlin.test.assertTrue
+
+class FormSchemasRouterTest {
+
+    @Test
+    fun `test can get all form schemas successfully`() {
+        // Load mocked JSON response
+        val jsonFilePath = Paths.get("src/test/resources/datacapture/all-form-schemas-response.json")
+        val jsonContent = Files.readString(jsonFilePath)
+
+        // Create a mock engine to intercept HTTP calls
+        val mockEngine = MockEngine { request ->
+            respond(
+                content = ByteReadChannel(jsonContent),
+                status = HttpStatusCode.OK,
+                headers = headersOf(HttpHeaders.ContentType, "application/json")
+            )
+        }
+
+        val formSchemasRouter = FormSchemasRouter(httpClient = HttpClient(mockEngine).configureForTest())
+
+        runBlocking {
+            val organisationId = "test-org-id"
+            val formId = "test-form-id"
+
+            val response = formSchemasRouter.all(organisationId, formId)
+
+            assertEquals(1, response.data.size)
+            val formSchema = response.data[0]
+            assertEquals("1.0.0", formSchema.id)
+            assertTrue(formSchema.model.contains("properties"))
+        }
+    }
+}

src/test/resources/datacapture/all-form-schemas-response.json

@@ -0,0 +1,72 @@
+{
+  "data": [
+    {
+      "id": "1.0.0",
+      "type": "form-schemas",
+      "attributes": {
+        "model": {
+          "properties": {
+            "property": {
+              "x-source": {
+                "resource-type": "properties"
+              },
+              "format": "uuid",
+              "type": "string"
+            }
+          },
+          "type": "object"
+        },
+        "views": null
+      },
+      "relationships": {
+        "form": {
+          "data": {
+            "id": "66d36697-7e35-48d2-b759-273a22baa4a9",
+            "type": "forms"
+          }
+        },
+        "organisation": {
+          "data": {
+            "id": "ef0fcfd6-2a18-4c27-b2c2-b2563859b3b1",
+            "type": "organisations"
+          }
+        }
+      },
+      "meta": {
+        "created_at": "2025-05-21T09:38:51.621Z",
+        "updated_at": "2025-05-21T09:38:51.621Z"
+      }
+    }
+  ],
+  "meta": {
+    "pagination": {
+      "current_page": 1,
+      "counts": {
+        "resources": 1,
+        "pages": 1
+      },
+      "requested": {
+        "offset": 0,
+        "limit": 100
+      },
+      "offsets": {
+        "previous": null,
+        "next": null
+      }
+    },
+    "features": {
+      "params": {
+        "include": {
+          "options": null
+        },
+        "sort": {
+          "default": "",
+          "options": null
+        }
+      }
+    }
+  },
+  "jsonapi": {
+    "version": "1.0"
+  }
+}