feat(api): declare AccountHolderBusinessResponse and remove entity_token from BusinessEntity (#297)

Author: stainless-app[bot]

lithic-java-core/src/main/kotlin/com/lithic/api/models/AccountHolder.kt

@@ -24,10 +24,10 @@ import java.util.Optional
 class AccountHolder
 private constructor(
     private val accountToken: JsonField<String>,
-    private val beneficialOwnerEntities: JsonField<List<BusinessEntity>>,
+    private val beneficialOwnerEntities: JsonField<List<AccountHolderBusinessResponse>>,
     private val beneficialOwnerIndividuals: JsonField<List<AccountHolderIndividualResponse>>,
     private val businessAccountToken: JsonField<String>,
-    private val businessEntity: JsonField<BusinessEntity>,
+    private val businessEntity: JsonField<AccountHolderBusinessResponse>,
     private val controlPerson: JsonField<AccountHolderIndividualResponse>,
     private val created: JsonField<OffsetDateTime>,
     private val email: JsonField<String>,
@@ -58,7 +58,7 @@ private constructor(
      * Only present when user_type == "BUSINESS". List of all entities with >25% ownership in the
      * company.
      */
-    fun beneficialOwnerEntities(): Optional<List<BusinessEntity>> =
+    fun beneficialOwnerEntities(): Optional<List<AccountHolderBusinessResponse>> =
         Optional.ofNullable(beneficialOwnerEntities.getNullable("beneficial_owner_entities"))
 
     /**
@@ -80,7 +80,7 @@ private constructor(
      * Only present when user_type == "BUSINESS". Information about the business for which the
      * account is being opened and KYB is being run.
      */
-    fun businessEntity(): Optional<BusinessEntity> =
+    fun businessEntity(): Optional<AccountHolderBusinessResponse> =
         Optional.ofNullable(businessEntity.getNullable("business_entity"))
 
     /**
@@ -399,11 +399,12 @@ private constructor(
     class Builder {
 
         private var accountToken: JsonField<String> = JsonMissing.of()
-        private var beneficialOwnerEntities: JsonField<List<BusinessEntity>> = JsonMissing.of()
+        private var beneficialOwnerEntities: JsonField<List<AccountHolderBusinessResponse>> =
+            JsonMissing.of()
         private var beneficialOwnerIndividuals: JsonField<List<AccountHolderIndividualResponse>> =
             JsonMissing.of()
         private var businessAccountToken: JsonField<String> = JsonMissing.of()
-        private var businessEntity: JsonField<BusinessEntity> = JsonMissing.of()
+        private var businessEntity: JsonField<AccountHolderBusinessResponse> = JsonMissing.of()
         private var controlPerson: JsonField<AccountHolderIndividualResponse> = JsonMissing.of()
         private var created: JsonField<OffsetDateTime> = JsonMissing.of()
         private var email: JsonField<String> = JsonMissing.of()
@@ -461,7 +462,7 @@ private constructor(
          * Only present when user_type == "BUSINESS". List of all entities with >25% ownership in
          * the company.
          */
-        fun beneficialOwnerEntities(beneficialOwnerEntities: List<BusinessEntity>) =
+        fun beneficialOwnerEntities(beneficialOwnerEntities: List<AccountHolderBusinessResponse>) =
             beneficialOwnerEntities(JsonField.of(beneficialOwnerEntities))
 
         /**
@@ -470,10 +471,9 @@ private constructor(
          */
         @JsonProperty("beneficial_owner_entities")
         @ExcludeMissing
-        fun beneficialOwnerEntities(beneficialOwnerEntities: JsonField<List<BusinessEntity>>) =
-            apply {
-                this.beneficialOwnerEntities = beneficialOwnerEntities
-            }
+        fun beneficialOwnerEntities(
+            beneficialOwnerEntities: JsonField<List<AccountHolderBusinessResponse>>
+        ) = apply { this.beneficialOwnerEntities = beneficialOwnerEntities }
 
         /**
          * Only present when user_type == "BUSINESS". List of all individuals with >25% ownership in
@@ -516,7 +516,7 @@ private constructor(
          * Only present when user_type == "BUSINESS". Information about the business for which the
          * account is being opened and KYB is being run.
          */
-        fun businessEntity(businessEntity: BusinessEntity) =
+        fun businessEntity(businessEntity: AccountHolderBusinessResponse) =
             businessEntity(JsonField.of(businessEntity))
 
         /**
@@ -525,7 +525,7 @@ private constructor(
          */
         @JsonProperty("business_entity")
         @ExcludeMissing
-        fun businessEntity(businessEntity: JsonField<BusinessEntity>) = apply {
+        fun businessEntity(businessEntity: JsonField<AccountHolderBusinessResponse>) = apply {
             this.businessEntity = businessEntity
         }
 
@@ -795,9 +795,9 @@ private constructor(
             )
     }
 
-    @JsonDeserialize(builder = BusinessEntity.Builder::class)
+    @JsonDeserialize(builder = AccountHolderBusinessResponse.Builder::class)
     @NoAutoDetect
-    class BusinessEntity
+    class AccountHolderBusinessResponse
     private constructor(
         private val address: JsonField<Address>,
         private val dbaBusinessName: JsonField<String>,
@@ -823,8 +823,7 @@ private constructor(
          * Any name that the business operates under that is not its legal business name (if
          * applicable).
          */
-        fun dbaBusinessName(): Optional<String> =
-            Optional.ofNullable(dbaBusinessName.getNullable("dba_business_name"))
+        fun dbaBusinessName(): String = dbaBusinessName.getRequired("dba_business_name")
 
         /**
          * Government-issued identification number. US Federal Employer Identification Numbers (EIN)
@@ -881,7 +880,7 @@ private constructor(
         @ExcludeMissing
         fun _additionalProperties(): Map<String, JsonValue> = additionalProperties
 
-        fun validate(): BusinessEntity = apply {
+        fun validate(): AccountHolderBusinessResponse = apply {
             if (!validated) {
                 address().validate()
                 dbaBusinessName()
@@ -901,7 +900,7 @@ private constructor(
                 return true
             }
 
-            return other is BusinessEntity &&
+            return other is AccountHolderBusinessResponse &&
                 this.address == other.address &&
                 this.dbaBusinessName == other.dbaBusinessName &&
                 this.governmentId == other.governmentId &&
@@ -930,7 +929,7 @@ private constructor(
         }
 
         override fun toString() =
-            "BusinessEntity{address=$address, dbaBusinessName=$dbaBusinessName, governmentId=$governmentId, legalBusinessName=$legalBusinessName, parentCompany=$parentCompany, phoneNumbers=$phoneNumbers, entityToken=$entityToken, additionalProperties=$additionalProperties}"
+            "AccountHolderBusinessResponse{address=$address, dbaBusinessName=$dbaBusinessName, governmentId=$governmentId, legalBusinessName=$legalBusinessName, parentCompany=$parentCompany, phoneNumbers=$phoneNumbers, entityToken=$entityToken, additionalProperties=$additionalProperties}"
 
         companion object {
 
@@ -949,16 +948,17 @@ private constructor(
             private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
 
             @JvmSynthetic
-            internal fun from(businessEntity: BusinessEntity) = apply {
-                this.address = businessEntity.address
-                this.dbaBusinessName = businessEntity.dbaBusinessName
-                this.governmentId = businessEntity.governmentId
-                this.legalBusinessName = businessEntity.legalBusinessName
-                this.parentCompany = businessEntity.parentCompany
-                this.phoneNumbers = businessEntity.phoneNumbers
-                this.entityToken = businessEntity.entityToken
-                additionalProperties(businessEntity.additionalProperties)
-            }
+            internal fun from(accountHolderBusinessResponse: AccountHolderBusinessResponse) =
+                apply {
+                    this.address = accountHolderBusinessResponse.address
+                    this.dbaBusinessName = accountHolderBusinessResponse.dbaBusinessName
+                    this.governmentId = accountHolderBusinessResponse.governmentId
+                    this.legalBusinessName = accountHolderBusinessResponse.legalBusinessName
+                    this.parentCompany = accountHolderBusinessResponse.parentCompany
+                    this.phoneNumbers = accountHolderBusinessResponse.phoneNumbers
+                    this.entityToken = accountHolderBusinessResponse.entityToken
+                    additionalProperties(accountHolderBusinessResponse.additionalProperties)
+                }
 
             /**
              * Business's physical address - PO boxes, UPS drops, and FedEx drops are not
@@ -1062,8 +1062,8 @@ private constructor(
                 this.additionalProperties.putAll(additionalProperties)
             }
 
-            fun build(): BusinessEntity =
-                BusinessEntity(
+            fun build(): AccountHolderBusinessResponse =
+                AccountHolderBusinessResponse(
                     address,
                     dbaBusinessName,
                     governmentId,

lithic-java-core/src/main/kotlin/com/lithic/api/models/AccountHolderListParams.kt

@@ -5,33 +5,67 @@ package com.lithic.api.models
 import com.lithic.api.core.NoAutoDetect
 import com.lithic.api.core.toUnmodifiable
 import com.lithic.api.models.*
+import java.time.OffsetDateTime
+import java.time.format.DateTimeFormatter
 import java.util.Objects
 import java.util.Optional
 
 class AccountHolderListParams
 constructor(
+    private val begin: OffsetDateTime?,
+    private val email: String?,
+    private val end: OffsetDateTime?,
     private val endingBefore: String?,
     private val externalId: String?,
+    private val firstName: String?,
+    private val lastName: String?,
+    private val legalBusinessName: String?,
     private val limit: Long?,
+    private val phoneNumber: String?,
     private val startingAfter: String?,
     private val additionalQueryParams: Map<String, List<String>>,
     private val additionalHeaders: Map<String, List<String>>,
 ) {
 
+    fun begin(): Optional<OffsetDateTime> = Optional.ofNullable(begin)
+
+    fun email(): Optional<String> = Optional.ofNullable(email)
+
+    fun end(): Optional<OffsetDateTime> = Optional.ofNullable(end)
+
     fun endingBefore(): Optional<String> = Optional.ofNullable(endingBefore)
 
     fun externalId(): Optional<String> = Optional.ofNullable(externalId)
 
+    fun firstName(): Optional<String> = Optional.ofNullable(firstName)
+
+    fun lastName(): Optional<String> = Optional.ofNullable(lastName)
+
+    fun legalBusinessName(): Optional<String> = Optional.ofNullable(legalBusinessName)
+
     fun limit(): Optional<Long> = Optional.ofNullable(limit)
 
+    fun phoneNumber(): Optional<String> = Optional.ofNullable(phoneNumber)
+
     fun startingAfter(): Optional<String> = Optional.ofNullable(startingAfter)
 
     @JvmSynthetic
     internal fun getQueryParams(): Map<String, List<String>> {
         val params = mutableMapOf<String, List<String>>()
+        this.begin?.let {
+            params.put("begin", listOf(DateTimeFormatter.ISO_OFFSET_DATE_TIME.format(it)))
+        }
+        this.email?.let { params.put("email", listOf(it.toString())) }
+        this.end?.let {
+            params.put("end", listOf(DateTimeFormatter.ISO_OFFSET_DATE_TIME.format(it)))
+        }
         this.endingBefore?.let { params.put("ending_before", listOf(it.toString())) }
         this.externalId?.let { params.put("external_id", listOf(it.toString())) }
+        this.firstName?.let { params.put("first_name", listOf(it.toString())) }
+        this.lastName?.let { params.put("last_name", listOf(it.toString())) }
+        this.legalBusinessName?.let { params.put("legal_business_name", listOf(it.toString())) }
         this.limit?.let { params.put("limit", listOf(it.toString())) }
+        this.phoneNumber?.let { params.put("phone_number", listOf(it.toString())) }
         this.startingAfter?.let { params.put("starting_after", listOf(it.toString())) }
         params.putAll(additionalQueryParams)
         return params.toUnmodifiable()
@@ -49,27 +83,41 @@ constructor(
         }
 
         return other is AccountHolderListParams &&
+            this.begin == other.begin &&
+            this.email == other.email &&
+            this.end == other.end &&
             this.endingBefore == other.endingBefore &&
             this.externalId == other.externalId &&
+            this.firstName == other.firstName &&
+            this.lastName == other.lastName &&
+            this.legalBusinessName == other.legalBusinessName &&
             this.limit == other.limit &&
+            this.phoneNumber == other.phoneNumber &&
             this.startingAfter == other.startingAfter &&
             this.additionalQueryParams == other.additionalQueryParams &&
             this.additionalHeaders == other.additionalHeaders
     }
 
     override fun hashCode(): Int {
         return Objects.hash(
+            begin,
+            email,
+            end,
             endingBefore,
             externalId,
+            firstName,
+            lastName,
+            legalBusinessName,
             limit,
+            phoneNumber,
             startingAfter,
             additionalQueryParams,
             additionalHeaders,
         )
     }
 
     override fun toString() =
-        "AccountHolderListParams{endingBefore=$endingBefore, externalId=$externalId, limit=$limit, startingAfter=$startingAfter, additionalQueryParams=$additionalQueryParams, additionalHeaders=$additionalHeaders}"
+        "AccountHolderListParams{begin=$begin, email=$email, end=$end, endingBefore=$endingBefore, externalId=$externalId, firstName=$firstName, lastName=$lastName, legalBusinessName=$legalBusinessName, limit=$limit, phoneNumber=$phoneNumber, startingAfter=$startingAfter, additionalQueryParams=$additionalQueryParams, additionalHeaders=$additionalHeaders}"
 
     fun toBuilder() = Builder().from(this)
 
@@ -81,23 +129,54 @@ constructor(
     @NoAutoDetect
     class Builder {
 
+        private var begin: OffsetDateTime? = null
+        private var email: String? = null
+        private var end: OffsetDateTime? = null
         private var endingBefore: String? = null
         private var externalId: String? = null
+        private var firstName: String? = null
+        private var lastName: String? = null
+        private var legalBusinessName: String? = null
         private var limit: Long? = null
+        private var phoneNumber: String? = null
         private var startingAfter: String? = null
         private var additionalQueryParams: MutableMap<String, MutableList<String>> = mutableMapOf()
         private var additionalHeaders: MutableMap<String, MutableList<String>> = mutableMapOf()
 
         @JvmSynthetic
         internal fun from(accountHolderListParams: AccountHolderListParams) = apply {
+            this.begin = accountHolderListParams.begin
+            this.email = accountHolderListParams.email
+            this.end = accountHolderListParams.end
             this.endingBefore = accountHolderListParams.endingBefore
             this.externalId = accountHolderListParams.externalId
+            this.firstName = accountHolderListParams.firstName
+            this.lastName = accountHolderListParams.lastName
+            this.legalBusinessName = accountHolderListParams.legalBusinessName
             this.limit = accountHolderListParams.limit
+            this.phoneNumber = accountHolderListParams.phoneNumber
             this.startingAfter = accountHolderListParams.startingAfter
             additionalQueryParams(accountHolderListParams.additionalQueryParams)
             additionalHeaders(accountHolderListParams.additionalHeaders)
         }
 
+        /**
+         * Date string in RFC 3339 format. Only entries created after the specified time will be
+         * included. UTC time zone.
+         */
+        fun begin(begin: OffsetDateTime) = apply { this.begin = begin }
+
+        /**
+         * Email address of the account holder. The query must be an exact match, case insensitive.
+         */
+        fun email(email: String) = apply { this.email = email }
+
+        /**
+         * Date string in RFC 3339 format. Only entries created before the specified time will be
+         * included. UTC time zone.
+         */
+        fun end(end: OffsetDateTime) = apply { this.end = end }
+
         /**
          * A cursor representing an item's token before which a page of results should end. Used to
          * retrieve the previous page of results before this item.
@@ -107,9 +186,32 @@ constructor(
         /** If applicable, represents the external_id associated with the account_holder. */
         fun externalId(externalId: String) = apply { this.externalId = externalId }
 
+        /**
+         * (Individual Account Holders only) The first name of the account holder. The query is case
+         * insensitive and supports partial matches.
+         */
+        fun firstName(firstName: String) = apply { this.firstName = firstName }
+
+        /**
+         * (Individual Account Holders only) The last name of the account holder. The query is case
+         * insensitive and supports partial matches.
+         */
+        fun lastName(lastName: String) = apply { this.lastName = lastName }
+
+        /**
+         * (Business Account Holders only) The legal business name of the account holder. The query
+         * is case insensitive and supports partial matches.
+         */
+        fun legalBusinessName(legalBusinessName: String) = apply {
+            this.legalBusinessName = legalBusinessName
+        }
+
         /** The number of account_holders to limit the response to. */
         fun limit(limit: Long) = apply { this.limit = limit }
 
+        /** Phone number of the account holder. The query must be an exact match. */
+        fun phoneNumber(phoneNumber: String) = apply { this.phoneNumber = phoneNumber }
+
         /**
          * A cursor representing an item's token after which a page of results should begin. Used to
          * retrieve the next page of results after this item.
@@ -158,9 +260,16 @@ constructor(
 
         fun build(): AccountHolderListParams =
             AccountHolderListParams(
+                begin,
+                email,
+                end,
                 endingBefore,
                 externalId,
+                firstName,
+                lastName,
+                legalBusinessName,
                 limit,
+                phoneNumber,
                 startingAfter,
                 additionalQueryParams.mapValues { it.value.toUnmodifiable() }.toUnmodifiable(),
                 additionalHeaders.mapValues { it.value.toUnmodifiable() }.toUnmodifiable(),