feat(api): add new endpoints for pay statement items (#526)

Author: stainless-app[bot]

.stats.yml

@@ -1,4 +1,4 @@
-configured_endpoints: 40
+configured_endpoints: 45
 openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/finch%2Ffinch-972e563922dedeeb94dca9a3ca8bac536488fcee56b55fcf09e6af044d3740e3.yml
 openapi_spec_hash: 08b86ecbec3323717d48e4aaee48ed54
-config_hash: 8303e755d3e16cf28542d5f0aec83851
+config_hash: b839955f81dcf0a060366274f202b185

finch-java-core/src/main/kotlin/com/tryfinch/api/models/HrisCompanyPayStatementItemListPage.kt

@@ -0,0 +1,196 @@
+// File generated from our OpenAPI spec by Stainless.
+
+package com.tryfinch.api.models
+
+import com.fasterxml.jackson.annotation.JsonAnyGetter
+import com.fasterxml.jackson.annotation.JsonAnySetter
+import com.fasterxml.jackson.annotation.JsonCreator
+import com.fasterxml.jackson.annotation.JsonProperty
+import com.tryfinch.api.core.ExcludeMissing
+import com.tryfinch.api.core.JsonField
+import com.tryfinch.api.core.JsonMissing
+import com.tryfinch.api.core.JsonValue
+import com.tryfinch.api.errors.FinchInvalidDataException
+import com.tryfinch.api.services.blocking.hris.company.PayStatementItemService
+import java.util.Collections
+import java.util.Objects
+import java.util.Optional
+import java.util.stream.Stream
+import java.util.stream.StreamSupport
+import kotlin.jvm.optionals.getOrNull
+
+/**
+ * **Beta:** this endpoint currently serves employers onboarded after March 4th and historical
+ * support will be added soon Retrieve a list of detailed pay statement items for the access token's
+ * connection account.
+ */
+class HrisCompanyPayStatementItemListPage
+private constructor(
+    private val payStatementItemService: PayStatementItemService,
+    private val params: HrisCompanyPayStatementItemListParams,
+    private val response: Response,
+) {
+
+    fun response(): Response = response
+
+    fun responses(): List<PayStatementItemListResponse> = response().responses()
+
+    override fun equals(other: Any?): Boolean {
+        if (this === other) {
+            return true
+        }
+
+        return /* spotless:off */ other is HrisCompanyPayStatementItemListPage && payStatementItemService == other.payStatementItemService && params == other.params && response == other.response /* spotless:on */
+    }
+
+    override fun hashCode(): Int = /* spotless:off */ Objects.hash(payStatementItemService, params, response) /* spotless:on */
+
+    override fun toString() =
+        "HrisCompanyPayStatementItemListPage{payStatementItemService=$payStatementItemService, params=$params, response=$response}"
+
+    fun hasNextPage(): Boolean {
+        return !responses().isEmpty()
+    }
+
+    fun getNextPageParams(): Optional<HrisCompanyPayStatementItemListParams> {
+        return Optional.empty()
+    }
+
+    fun getNextPage(): Optional<HrisCompanyPayStatementItemListPage> {
+        return getNextPageParams().map { payStatementItemService.list(it) }
+    }
+
+    fun autoPager(): AutoPager = AutoPager(this)
+
+    companion object {
+
+        @JvmStatic
+        fun of(
+            payStatementItemService: PayStatementItemService,
+            params: HrisCompanyPayStatementItemListParams,
+            response: Response,
+        ) = HrisCompanyPayStatementItemListPage(payStatementItemService, params, response)
+    }
+
+    class Response(
+        private val responses: JsonField<List<PayStatementItemListResponse>>,
+        private val additionalProperties: MutableMap<String, JsonValue>,
+    ) {
+
+        @JsonCreator
+        private constructor(
+            @JsonProperty("responses")
+            responses: JsonField<List<PayStatementItemListResponse>> = JsonMissing.of()
+        ) : this(responses, mutableMapOf())
+
+        fun responses(): List<PayStatementItemListResponse> =
+            responses.getNullable("responses") ?: listOf()
+
+        @JsonProperty("responses")
+        fun _responses(): Optional<JsonField<List<PayStatementItemListResponse>>> =
+            Optional.ofNullable(responses)
+
+        @JsonAnySetter
+        private fun putAdditionalProperty(key: String, value: JsonValue) {
+            additionalProperties.put(key, value)
+        }
+
+        @JsonAnyGetter
+        @ExcludeMissing
+        fun _additionalProperties(): Map<String, JsonValue> =
+            Collections.unmodifiableMap(additionalProperties)
+
+        private var validated: Boolean = false
+
+        fun validate(): Response = apply {
+            if (validated) {
+                return@apply
+            }
+
+            responses().map { it.validate() }
+            validated = true
+        }
+
+        fun isValid(): Boolean =
+            try {
+                validate()
+                true
+            } catch (e: FinchInvalidDataException) {
+                false
+            }
+
+        fun toBuilder() = Builder().from(this)
+
+        override fun equals(other: Any?): Boolean {
+            if (this === other) {
+                return true
+            }
+
+            return /* spotless:off */ other is Response && responses == other.responses && additionalProperties == other.additionalProperties /* spotless:on */
+        }
+
+        override fun hashCode(): Int = /* spotless:off */ Objects.hash(responses, additionalProperties) /* spotless:on */
+
+        override fun toString() =
+            "Response{responses=$responses, additionalProperties=$additionalProperties}"
+
+        companion object {
+
+            /**
+             * Returns a mutable builder for constructing an instance of
+             * [HrisCompanyPayStatementItemListPage].
+             */
+            @JvmStatic fun builder() = Builder()
+        }
+
+        class Builder {
+
+            private var responses: JsonField<List<PayStatementItemListResponse>> = JsonMissing.of()
+            private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
+
+            @JvmSynthetic
+            internal fun from(page: Response) = apply {
+                this.responses = page.responses
+                this.additionalProperties.putAll(page.additionalProperties)
+            }
+
+            fun responses(responses: List<PayStatementItemListResponse>) =
+                responses(JsonField.of(responses))
+
+            fun responses(responses: JsonField<List<PayStatementItemListResponse>>) = apply {
+                this.responses = responses
+            }
+
+            fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+                this.additionalProperties.put(key, value)
+            }
+
+            /**
+             * Returns an immutable instance of [Response].
+             *
+             * Further updates to this [Builder] will not mutate the returned instance.
+             */
+            fun build(): Response = Response(responses, additionalProperties.toMutableMap())
+        }
+    }
+
+    class AutoPager(private val firstPage: HrisCompanyPayStatementItemListPage) :
+        Iterable<PayStatementItemListResponse> {
+
+        override fun iterator(): Iterator<PayStatementItemListResponse> = iterator {
+            var page = firstPage
+            var index = 0
+            while (true) {
+                while (index < page.responses().size) {
+                    yield(page.responses()[index++])
+                }
+                page = page.getNextPage().getOrNull() ?: break
+                index = 0
+            }
+        }
+
+        fun stream(): Stream<PayStatementItemListResponse> {
+            return StreamSupport.stream(spliterator(), false)
+        }
+    }
+}