feat(api): add Optional parameter overloads to transaction response builders

Author: stainless-app[bot]

.stats.yml

@@ -1,4 +1,4 @@
 configured_endpoints: 214
-openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/lithic/lithic-2d2600072500797474f0d7798c1a8b668bfbc4e0c6a8f076ca7b4cc7ad82058b.yml
-openapi_spec_hash: 7605eb6be77a3d150078916f0eb0e9ac
+openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/lithic/lithic-6683cf82e93cfd95e17b0386f070333486fe8e7b857b47c62e09682362d5991d.yml
+openapi_spec_hash: ce2c1f6201bb2036d05602238503eb6b
 config_hash: 5bb913c05ebeb301ec925b16e75bb251

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

@@ -24,7 +24,7 @@ import kotlin.jvm.optionals.getOrNull
 /**
  * Card program's response to Authorization Challenge. Programs that have Authorization Challenges
  * configured as Out of Band receive a
- * [card_authorization.challenge](https://docs.lithic.com/reference/post_card-authorization-challenge)
+ * [card_authorization.challenge](https://docs.lithic.com/reference/cardauthorizationchallengewebhook)
  * webhook when an authorization attempt triggers a challenge. The card program should respond using
  * this endpoint after the cardholder completes the challenge.
  */

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

@@ -151,7 +151,7 @@ private constructor(
      *   receiving this request, the Card Program should issue its own challenge to the cardholder.
      *   After a cardholder challenge is successfully completed, the Card Program needs to respond
      *   back to Lithic by call to
-     *   [/v1/three_ds_decisioning/challenge_response](https://docs.lithic.com/reference/post_v1-three-ds-decisioning-challenge-response).
+     *   [/v1/three_ds_decisioning/challenge_response](https://docs.lithic.com/reference/postthreedschallengeresponse).
      *   Then the cardholder must navigate back to the merchant checkout flow to complete the
      *   transaction. Some merchants will include an `app_requestor_url` for app-based purchases;
      *   Lithic recommends triggering a redirect to that URL after the cardholder completes an
@@ -374,7 +374,7 @@ private constructor(
          *   receiving this request, the Card Program should issue its own challenge to the
          *   cardholder. After a cardholder challenge is successfully completed, the Card Program
          *   needs to respond back to Lithic by call to
-         *   [/v1/three_ds_decisioning/challenge_response](https://docs.lithic.com/reference/post_v1-three-ds-decisioning-challenge-response).
+         *   [/v1/three_ds_decisioning/challenge_response](https://docs.lithic.com/reference/postthreedschallengeresponse).
          *   Then the cardholder must navigate back to the merchant checkout flow to complete the
          *   transaction. Some merchants will include an `app_requestor_url` for app-based
          *   purchases; Lithic recommends triggering a redirect to that URL after the cardholder
@@ -588,7 +588,7 @@ private constructor(
      *   receiving this request, the Card Program should issue its own challenge to the cardholder.
      *   After a cardholder challenge is successfully completed, the Card Program needs to respond
      *   back to Lithic by call to
-     *   [/v1/three_ds_decisioning/challenge_response](https://docs.lithic.com/reference/post_v1-three-ds-decisioning-challenge-response).
+     *   [/v1/three_ds_decisioning/challenge_response](https://docs.lithic.com/reference/postthreedschallengeresponse).
      *   Then the cardholder must navigate back to the merchant checkout flow to complete the
      *   transaction. Some merchants will include an `app_requestor_url` for app-based purchases;
      *   Lithic recommends triggering a redirect to that URL after the cardholder completes an

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

@@ -409,7 +409,7 @@ private constructor(
      *   receiving this request, the Card Program should issue its own challenge to the cardholder.
      *   After a cardholder challenge is successfully completed, the Card Program needs to respond
      *   back to Lithic by call to
-     *   [/v1/three_ds_decisioning/challenge_response](https://docs.lithic.com/reference/post_v1-three-ds-decisioning-challenge-response).
+     *   [/v1/three_ds_decisioning/challenge_response](https://docs.lithic.com/reference/postthreedschallengeresponse).
      *   Then the cardholder must navigate back to the merchant checkout flow to complete the
      *   transaction. Some merchants will include an `app_requestor_url` for app-based purchases;
      *   Lithic recommends triggering a redirect to that URL after the cardholder completes an

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

@@ -419,7 +419,7 @@ private constructor(
      *   receiving this request, the Card Program should issue its own challenge to the cardholder.
      *   After a cardholder challenge is successfully completed, the Card Program needs to respond
      *   back to Lithic by call to
-     *   [/v1/three_ds_decisioning/challenge_response](https://docs.lithic.com/reference/post_v1-three-ds-decisioning-challenge-response).
+     *   [/v1/three_ds_decisioning/challenge_response](https://docs.lithic.com/reference/postthreedschallengeresponse).
      *   Then the cardholder must navigate back to the merchant checkout flow to complete the
      *   transaction. Some merchants will include an `app_requestor_url` for app-based purchases;
      *   Lithic recommends triggering a redirect to that URL after the cardholder completes an

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

@@ -742,7 +742,7 @@ private constructor(
      *   receiving this request, the Card Program should issue its own challenge to the cardholder.
      *   After a cardholder challenge is successfully completed, the Card Program needs to respond
      *   back to Lithic by call to
-     *   [/v1/three_ds_decisioning/challenge_response](https://docs.lithic.com/reference/post_v1-three-ds-decisioning-challenge-response).
+     *   [/v1/three_ds_decisioning/challenge_response](https://docs.lithic.com/reference/postthreedschallengeresponse).
      *   Then the cardholder must navigate back to the merchant checkout flow to complete the
      *   transaction. Some merchants will include an `app_requestor_url` for app-based purchases;
      *   Lithic recommends triggering a redirect to that URL after the cardholder completes an

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

@@ -765,7 +765,7 @@ private constructor(
      *   receiving this request, the Card Program should issue its own challenge to the cardholder.
      *   After a cardholder challenge is successfully completed, the Card Program needs to respond
      *   back to Lithic by call to
-     *   [/v1/three_ds_decisioning/challenge_response](https://docs.lithic.com/reference/post_v1-three-ds-decisioning-challenge-response).
+     *   [/v1/three_ds_decisioning/challenge_response](https://docs.lithic.com/reference/postthreedschallengeresponse).
      *   Then the cardholder must navigate back to the merchant checkout flow to complete the
      *   transaction. Some merchants will include an `app_requestor_url` for app-based purchases;
      *   Lithic recommends triggering a redirect to that URL after the cardholder completes an

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

@@ -11,7 +11,7 @@ import java.util.Objects
 
 /**
  * Card program's response to a 3DS Challenge Request. Challenge Request is emitted as a webhook
- * [three_ds_authentication.challenge](https://docs.lithic.com/reference/post_three-ds-authentication-challenge)
+ * [three_ds_authentication.challenge](https://docs.lithic.com/reference/threedsauthenticationchallengewebhook)
  * and your Card Program needs to be configured with Out of Band (OOB) Challenges in order to
  * receive it (see https://docs.lithic.com/docs/3ds-challenge-flow for more information).
  */

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

@@ -278,7 +278,10 @@ private constructor(
         }
 
         /** Provides additional context or details about the fraud report. */
-        fun comment(comment: String) = comment(JsonField.of(comment))
+        fun comment(comment: String?) = comment(JsonField.ofNullable(comment))
+
+        /** Alias for calling [Builder.comment] with `comment.orElse(null)`. */
+        fun comment(comment: Optional<String>) = comment(comment.getOrNull())
 
         /**
          * Sets [Builder.comment] to an arbitrary JSON value.
@@ -289,7 +292,10 @@ private constructor(
         fun comment(comment: JsonField<String>) = apply { this.comment = comment }
 
         /** Timestamp representing when the fraud report was created. */
-        fun createdAt(createdAt: OffsetDateTime) = createdAt(JsonField.of(createdAt))
+        fun createdAt(createdAt: OffsetDateTime?) = createdAt(JsonField.ofNullable(createdAt))
+
+        /** Alias for calling [Builder.createdAt] with `createdAt.orElse(null)`. */
+        fun createdAt(createdAt: Optional<OffsetDateTime>) = createdAt(createdAt.getOrNull())
 
         /**
          * Sets [Builder.createdAt] to an arbitrary JSON value.
@@ -320,7 +326,10 @@ private constructor(
          *   coerces a legitimate cardholder into unauthorized transactions, often through social
          *   engineering tactics.
          */
-        fun fraudType(fraudType: FraudType) = fraudType(JsonField.of(fraudType))
+        fun fraudType(fraudType: FraudType?) = fraudType(JsonField.ofNullable(fraudType))
+
+        /** Alias for calling [Builder.fraudType] with `fraudType.orElse(null)`. */
+        fun fraudType(fraudType: Optional<FraudType>) = fraudType(fraudType.getOrNull())
 
         /**
          * Sets [Builder.fraudType] to an arbitrary JSON value.
@@ -332,7 +341,10 @@ private constructor(
         fun fraudType(fraudType: JsonField<FraudType>) = apply { this.fraudType = fraudType }
 
         /** Timestamp representing the last update to the fraud report. */
-        fun updatedAt(updatedAt: OffsetDateTime) = updatedAt(JsonField.of(updatedAt))
+        fun updatedAt(updatedAt: OffsetDateTime?) = updatedAt(JsonField.ofNullable(updatedAt))
+
+        /** Alias for calling [Builder.updatedAt] with `updatedAt.orElse(null)`. */
+        fun updatedAt(updatedAt: Optional<OffsetDateTime>) = updatedAt(updatedAt.getOrNull())
 
         /**
          * Sets [Builder.updatedAt] to an arbitrary JSON value.

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

@@ -278,7 +278,10 @@ private constructor(
         }
 
         /** Provides additional context or details about the fraud report. */
-        fun comment(comment: String) = comment(JsonField.of(comment))
+        fun comment(comment: String?) = comment(JsonField.ofNullable(comment))
+
+        /** Alias for calling [Builder.comment] with `comment.orElse(null)`. */
+        fun comment(comment: Optional<String>) = comment(comment.getOrNull())
 
         /**
          * Sets [Builder.comment] to an arbitrary JSON value.
@@ -289,7 +292,10 @@ private constructor(
         fun comment(comment: JsonField<String>) = apply { this.comment = comment }
 
         /** Timestamp representing when the fraud report was created. */
-        fun createdAt(createdAt: OffsetDateTime) = createdAt(JsonField.of(createdAt))
+        fun createdAt(createdAt: OffsetDateTime?) = createdAt(JsonField.ofNullable(createdAt))
+
+        /** Alias for calling [Builder.createdAt] with `createdAt.orElse(null)`. */
+        fun createdAt(createdAt: Optional<OffsetDateTime>) = createdAt(createdAt.getOrNull())
 
         /**
          * Sets [Builder.createdAt] to an arbitrary JSON value.
@@ -320,7 +326,10 @@ private constructor(
          *   coerces a legitimate cardholder into unauthorized transactions, often through social
          *   engineering tactics.
          */
-        fun fraudType(fraudType: FraudType) = fraudType(JsonField.of(fraudType))
+        fun fraudType(fraudType: FraudType?) = fraudType(JsonField.ofNullable(fraudType))
+
+        /** Alias for calling [Builder.fraudType] with `fraudType.orElse(null)`. */
+        fun fraudType(fraudType: Optional<FraudType>) = fraudType(fraudType.getOrNull())
 
         /**
          * Sets [Builder.fraudType] to an arbitrary JSON value.
@@ -332,7 +341,10 @@ private constructor(
         fun fraudType(fraudType: JsonField<FraudType>) = apply { this.fraudType = fraudType }
 
         /** Timestamp representing the last update to the fraud report. */
-        fun updatedAt(updatedAt: OffsetDateTime) = updatedAt(JsonField.of(updatedAt))
+        fun updatedAt(updatedAt: OffsetDateTime?) = updatedAt(JsonField.ofNullable(updatedAt))
+
+        /** Alias for calling [Builder.updatedAt] with `updatedAt.orElse(null)`. */
+        fun updatedAt(updatedAt: Optional<OffsetDateTime>) = updatedAt(updatedAt.getOrNull())
 
         /**
          * Sets [Builder.updatedAt] to an arbitrary JSON value.