feat: Add TimeBand data class and router for time band operations

Author: jwilkinson87

src/main/kotlin/com/ctrlhub/core/settings/timebands/TimeBandsRouter.kt

@@ -0,0 +1,45 @@
+package com.ctrlhub.core.settings.timebands
+
+import com.ctrlhub.core.Api
+import com.ctrlhub.core.settings.timebands.response.TimeBand
+import com.ctrlhub.core.router.Router
+import com.ctrlhub.core.router.request.AbstractRequestParameters
+import com.ctrlhub.core.router.request.FilterOption
+import io.ktor.client.HttpClient
+
+class TimeBandsRequestParameters(
+    offset: Int? = 0,
+    limit: Int? = 100,
+    filterOptions: List<FilterOption> = emptyList()
+) : AbstractRequestParameters(offset, limit, filterOptions)
+
+class TimeBandsRouter(httpClient: HttpClient) : Router(httpClient) {
+    /**
+     * Retrieve a list of all time bands
+     *
+     * @return A list of all time bands
+     */
+    suspend fun all(
+        requestParameters: TimeBandsRequestParameters = TimeBandsRequestParameters()
+    ): java.util.List<TimeBand> {
+        val endpoint = "/settings/time-bands"
+        return fetchJsonApiResource(endpoint, requestParameters.toMap())
+    }
+
+    /**
+     * Retrieve a single time band by ID
+     *
+     * @param timeBandId String The time band ID to retrieve
+     * @return The time band with the given ID
+     */
+    suspend fun one(
+        timeBandId: String,
+        requestParameters: TimeBandsRequestParameters = TimeBandsRequestParameters()
+    ): TimeBand {
+        val endpoint = "/settings/time-bands/$timeBandId"
+        return fetchJsonApiResource(endpoint, requestParameters.toMap(), TimeBand::class.java)
+    }
+}
+
+val Api.timeBands: TimeBandsRouter
+    get() = TimeBandsRouter(httpClient)

src/main/kotlin/com/ctrlhub/core/settings/timebands/response/TimeBand.kt

@@ -0,0 +1,25 @@
+package com.ctrlhub.core.settings.timebands.response
+
+import com.fasterxml.jackson.annotation.JsonCreator
+import com.fasterxml.jackson.annotation.JsonIgnoreProperties
+import com.fasterxml.jackson.annotation.JsonProperty
+import com.github.jasminb.jsonapi.annotations.Id
+import com.github.jasminb.jsonapi.annotations.Meta
+import com.github.jasminb.jsonapi.annotations.Type
+
+@Type("time-bands")
+@JsonIgnoreProperties(ignoreUnknown = true)
+data class TimeBand @JsonCreator constructor(
+    @Id var id: String = "",
+    @JsonProperty("end") var end: String = "",
+    @JsonProperty("name") var name: String = "",
+    @JsonProperty("start") var start: String = "",
+    @JsonProperty("meta") @Meta var meta: TimeBandMeta? = null
+) {
+    @JsonIgnoreProperties(ignoreUnknown = true)
+    data class TimeBandMeta @JsonCreator constructor(
+        @JsonProperty("created_at") var createdAt: String = "",
+        @JsonProperty("updated_at") var updatedAt: String = "",
+        @JsonProperty("modified_at") var modifiedAt: String = ""
+    )
+}