feat: define a form schema resource type and a router to retrieve resources for it

Author: jwilkinson87

src/main/kotlin/com/ctrlhub/core/datacapture/FormSchemasRouter.kt

@@ -0,0 +1,27 @@
+package com.ctrlhub.core.datacapture
+
+import com.ctrlhub.core.api.response.PaginatedList
+import com.ctrlhub.core.datacapture.response.FormSchema
+import com.ctrlhub.core.router.Router
+import com.ctrlhub.core.router.request.RequestParameters
+import io.ktor.client.HttpClient
+
+/**
+ * A router that interacts with the form schemas realm of the Ctrl Hub API
+ */
+class FormSchemasRouter(httpClient: HttpClient): Router(httpClient) {
+
+    /**
+     * Get all form schemas for a given form and organisation
+     *
+     * @param organisationId String The organisation ID to retrieve all for schemas for
+     * @param formId String The form ID to retrieve all schemas for
+     *
+     * @return A paginated response of all form schemas
+     */
+    suspend fun all(organisationId: String, formId: String, requestParameters: RequestParameters = RequestParameters()): PaginatedList<FormSchema> {
+        val endpoint = "/v3/orgs/${organisationId}/data-capture/forms/{$formId}/schemas"
+
+        return fetchPaginatedJsonApiResources(endpoint, requestParameters.toMap(), FormSchema::class.java)
+    }
+}

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

@@ -0,0 +1,20 @@
+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.annotations.Type
+
+@Type("")
+data class FormSchema @JsonCreator constructor(
+    val id: String,
+
+    @JsonProperty("model")
+    private val modelNode: JsonNode,
+
+    @JsonProperty("views")
+    private val viewsNode: JsonNode?
+) {
+    val model: String = modelNode.toString()
+    val views: String? = viewsNode?.toString()
+}