docs: add comment for arbitrary value fields

Author: stainless-app[bot]

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

@@ -103,7 +103,14 @@ private constructor(
      */
     fun customerProductId(): Optional<String> = customerProductId.getOptional("customer_product_id")
 
-    /** Shipping address for all cards in this bulk order */
+    /**
+     * Shipping address for all cards in this bulk order
+     *
+     * This arbitrary value can be deserialized into a custom type using the `convert` method:
+     * ```java
+     * MyClass myObject = cardBulkOrder.shippingAddress().convert(MyClass.class);
+     * ```
+     */
     @JsonProperty("shipping_address")
     @ExcludeMissing
     fun _shippingAddress(): JsonValue = shippingAddress

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

@@ -43,7 +43,14 @@ private constructor(
      */
     fun customerProductId(): String = body.customerProductId()
 
-    /** Shipping address for all cards in this bulk order */
+    /**
+     * Shipping address for all cards in this bulk order
+     *
+     * This arbitrary value can be deserialized into a custom type using the `convert` method:
+     * ```java
+     * MyClass myObject = cardBulkOrderCreateParams.shippingAddress().convert(MyClass.class);
+     * ```
+     */
     fun _shippingAddress(): JsonValue = body._shippingAddress()
 
     /**
@@ -340,7 +347,14 @@ private constructor(
          */
         fun customerProductId(): String = customerProductId.getRequired("customer_product_id")
 
-        /** Shipping address for all cards in this bulk order */
+        /**
+         * Shipping address for all cards in this bulk order
+         *
+         * This arbitrary value can be deserialized into a custom type using the `convert` method:
+         * ```java
+         * MyClass myObject = createBulkOrderRequest.shippingAddress().convert(MyClass.class);
+         * ```
+         */
         @JsonProperty("shipping_address")
         @ExcludeMissing
         fun _shippingAddress(): JsonValue = shippingAddress

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

@@ -55,7 +55,14 @@ private constructor(
      */
     fun eventType(): EventType = eventType.getRequired("event_type")
 
-    /** The previous values of the fields that were updated. */
+    /**
+     * The previous values of the fields that were updated.
+     *
+     * This arbitrary value can be deserialized into a custom type using the `convert` method:
+     * ```java
+     * MyClass myObject = cardUpdatedWebhookEvent.previousFields().convert(MyClass.class);
+     * ```
+     */
     @JsonProperty("previous_fields")
     @ExcludeMissing
     fun _previousFields(): JsonValue = previousFields

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

@@ -130,13 +130,34 @@ private constructor(
      */
     fun purchases(): Long = purchases.getRequired("purchases")
 
-    /** Breakdown of credits */
+    /**
+     * Breakdown of credits
+     *
+     * This arbitrary value can be deserialized into a custom type using the `convert` method:
+     * ```java
+     * MyClass myObject = statementTotals.creditDetails().convert(MyClass.class);
+     * ```
+     */
     @JsonProperty("credit_details") @ExcludeMissing fun _creditDetails(): JsonValue = creditDetails
 
-    /** Breakdown of debits */
+    /**
+     * Breakdown of debits
+     *
+     * This arbitrary value can be deserialized into a custom type using the `convert` method:
+     * ```java
+     * MyClass myObject = statementTotals.debitDetails().convert(MyClass.class);
+     * ```
+     */
     @JsonProperty("debit_details") @ExcludeMissing fun _debitDetails(): JsonValue = debitDetails
 
-    /** Breakdown of payments */
+    /**
+     * Breakdown of payments
+     *
+     * This arbitrary value can be deserialized into a custom type using the `convert` method:
+     * ```java
+     * MyClass myObject = statementTotals.paymentDetails().convert(MyClass.class);
+     * ```
+     */
     @JsonProperty("payment_details")
     @ExcludeMissing
     fun _paymentDetails(): JsonValue = paymentDetails