feat(api): add WALLET_RECOMMENDATION_REASONS attribute for tokenization rules

feat(api): provide a unified model for AuthRule
fix(api): make certain payoff fields nullable
fix(api): fix examples in spec that were not fully valid

Author: stainless-app[bot]

.stats.yml

@@ -1,4 +1,4 @@
 configured_endpoints: 172
-openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/lithic%2Flithic-9791980619fc7ce8afb01f77dfe3c660a540975327378287cb666136ae4b0a99.yml
-openapi_spec_hash: 0752074b2a7b0534329a1e3176c94a62
-config_hash: aab05d0cf41f1f6b9f4d5677273c1600
+openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/lithic%2Flithic-a9de2732e7a28b7fc5b8b7b171781d617337b6223d82ef7d6a554d0bd2b33bab.yml
+openapi_spec_hash: fc6111d286c7002cd854af23841d137e
+config_hash: f6f5c7f37033e89a3cf91a48371a718a

README.md

@@ -546,6 +546,22 @@ CardCreateParams params = CardCreateParams.builder()
 
 These can be accessed on the built object later using the `_additionalHeaders()`, `_additionalQueryParams()`, and `_additionalBodyProperties()` methods.
 
+To set undocumented parameters on _nested_ headers, query params, or body classes, call the `putAdditionalProperty` method on the nested class:
+
+```java
+import com.lithic.api.core.JsonValue;
+import com.lithic.api.models.CardCreateParams;
+import com.lithic.api.models.ShippingAddress;
+
+CardCreateParams params = CardCreateParams.builder()
+    .shippingAddress(ShippingAddress.builder()
+        .putAdditionalProperty("secretProperty", JsonValue.from("42"))
+        .build())
+    .build();
+```
+
+These properties can be accessed on the nested built object later using the `_additionalProperties()` method.
+
 To set a documented parameter or property to an undocumented or not yet supported _value_, pass a [`JsonValue`](lithic-java-core/src/main/kotlin/com/lithic/api/core/Values.kt) object to its setter:
 
 ```java

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

@@ -16,15 +16,14 @@ private constructor(
     private val service: V2Service,
     private val params: AuthRuleV2ListParams,
     private val response: AuthRuleV2ListPageResponse,
-) : Page<V2ListResponse> {
+) : Page<AuthRule> {
 
     /**
      * Delegates to [AuthRuleV2ListPageResponse], but gracefully handles missing data.
      *
      * @see AuthRuleV2ListPageResponse.data
      */
-    fun data(): List<V2ListResponse> =
-        response._data().getOptional("data").getOrNull() ?: emptyList()
+    fun data(): List<AuthRule> = response._data().getOptional("data").getOrNull() ?: emptyList()
 
     /**
      * Delegates to [AuthRuleV2ListPageResponse], but gracefully handles missing data.
@@ -33,7 +32,7 @@ private constructor(
      */
     fun hasMore(): Optional<Boolean> = response._hasMore().getOptional("has_more")
 
-    override fun items(): List<V2ListResponse> = data()
+    override fun items(): List<AuthRule> = data()
 
     override fun hasNextPage(): Boolean = items().isNotEmpty()
 
@@ -46,7 +45,7 @@ private constructor(
 
     override fun nextPage(): AuthRuleV2ListPage = service.list(nextPageParams())
 
-    fun autoPager(): AutoPager<V2ListResponse> = AutoPager.from(this)
+    fun autoPager(): AutoPager<AuthRule> = AutoPager.from(this)
 
     /** The parameters that were used to request this page. */
     fun params(): AuthRuleV2ListParams = params

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

@@ -19,15 +19,14 @@ private constructor(
     private val streamHandlerExecutor: Executor,
     private val params: AuthRuleV2ListParams,
     private val response: AuthRuleV2ListPageResponse,
-) : PageAsync<V2ListResponse> {
+) : PageAsync<AuthRule> {
 
     /**
      * Delegates to [AuthRuleV2ListPageResponse], but gracefully handles missing data.
      *
      * @see AuthRuleV2ListPageResponse.data
      */
-    fun data(): List<V2ListResponse> =
-        response._data().getOptional("data").getOrNull() ?: emptyList()
+    fun data(): List<AuthRule> = response._data().getOptional("data").getOrNull() ?: emptyList()
 
     /**
      * Delegates to [AuthRuleV2ListPageResponse], but gracefully handles missing data.
@@ -36,7 +35,7 @@ private constructor(
      */
     fun hasMore(): Optional<Boolean> = response._hasMore().getOptional("has_more")
 
-    override fun items(): List<V2ListResponse> = data()
+    override fun items(): List<AuthRule> = data()
 
     override fun hasNextPage(): Boolean = items().isNotEmpty()
 
@@ -50,8 +49,7 @@ private constructor(
     override fun nextPage(): CompletableFuture<AuthRuleV2ListPageAsync> =
         service.list(nextPageParams())
 
-    fun autoPager(): AutoPagerAsync<V2ListResponse> =
-        AutoPagerAsync.from(this, streamHandlerExecutor)
+    fun autoPager(): AutoPagerAsync<AuthRule> = AutoPagerAsync.from(this, streamHandlerExecutor)
 
     /** The parameters that were used to request this page. */
     fun params(): AuthRuleV2ListParams = params

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

@@ -21,24 +21,22 @@ import kotlin.jvm.optionals.getOrNull
 class AuthRuleV2ListPageResponse
 @JsonCreator(mode = JsonCreator.Mode.DISABLED)
 private constructor(
-    private val data: JsonField<List<V2ListResponse>>,
+    private val data: JsonField<List<AuthRule>>,
     private val hasMore: JsonField<Boolean>,
     private val additionalProperties: MutableMap<String, JsonValue>,
 ) {
 
     @JsonCreator
     private constructor(
-        @JsonProperty("data")
-        @ExcludeMissing
-        data: JsonField<List<V2ListResponse>> = JsonMissing.of(),
+        @JsonProperty("data") @ExcludeMissing data: JsonField<List<AuthRule>> = JsonMissing.of(),
         @JsonProperty("has_more") @ExcludeMissing hasMore: JsonField<Boolean> = JsonMissing.of(),
     ) : this(data, hasMore, mutableMapOf())
 
     /**
      * @throws LithicInvalidDataException if the JSON field has an unexpected type or is
      *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
      */
-    fun data(): List<V2ListResponse> = data.getRequired("data")
+    fun data(): List<AuthRule> = data.getRequired("data")
 
     /**
      * Indicates whether there are more Auth Rules to be retrieved by paging through the results.
@@ -53,7 +51,7 @@ private constructor(
      *
      * Unlike [data], this method doesn't throw if the JSON field has an unexpected type.
      */
-    @JsonProperty("data") @ExcludeMissing fun _data(): JsonField<List<V2ListResponse>> = data
+    @JsonProperty("data") @ExcludeMissing fun _data(): JsonField<List<AuthRule>> = data
 
     /**
      * Returns the raw JSON value of [hasMore].
@@ -91,7 +89,7 @@ private constructor(
     /** A builder for [AuthRuleV2ListPageResponse]. */
     class Builder internal constructor() {
 
-        private var data: JsonField<MutableList<V2ListResponse>>? = null
+        private var data: JsonField<MutableList<AuthRule>>? = null
         private var hasMore: JsonField<Boolean>? = null
         private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
 
@@ -102,25 +100,25 @@ private constructor(
             additionalProperties = authRuleV2ListPageResponse.additionalProperties.toMutableMap()
         }
 
-        fun data(data: List<V2ListResponse>) = data(JsonField.of(data))
+        fun data(data: List<AuthRule>) = data(JsonField.of(data))
 
         /**
          * Sets [Builder.data] to an arbitrary JSON value.
          *
-         * You should usually call [Builder.data] with a well-typed `List<V2ListResponse>` value
-         * instead. This method is primarily for setting the field to an undocumented or not yet
-         * supported value.
+         * You should usually call [Builder.data] with a well-typed `List<AuthRule>` value instead.
+         * This method is primarily for setting the field to an undocumented or not yet supported
+         * value.
          */
-        fun data(data: JsonField<List<V2ListResponse>>) = apply {
+        fun data(data: JsonField<List<AuthRule>>) = apply {
             this.data = data.map { it.toMutableList() }
         }
 
         /**
-         * Adds a single [V2ListResponse] to [Builder.data].
+         * Adds a single [AuthRule] to [Builder.data].
          *
          * @throws IllegalStateException if the field was previously set to a non-list.
          */
-        fun addData(data: V2ListResponse) = apply {
+        fun addData(data: AuthRule) = apply {
             this.data =
                 (this.data ?: JsonField.of(mutableListOf())).also {
                     checkKnown("data", it).add(data)