feat(api): OpenAPI spec update via Stainless API (#59)

Author: stainless-app[bot]

.stats.yml

@@ -1,2 +1,2 @@
 configured_endpoints: 93
-openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/orb%2Forb-5b28e83c3230be7d858ce20741c7b5debdad3e7720e2fa6e3a2d1774ca02a337.yml
+openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/orb%2Forb-c41cb3efa0bdffe6bae3146ed10c044b7905560bb24f0bd34166c34bd26cbfbf.yml

orb-java-core/src/main/kotlin/com/withorb/api/models/Invoice.kt

@@ -161,6 +161,10 @@ private constructor(
 
     fun customer(): Customer = customer.getRequired("customer")
 
+    /**
+     * This field is deprecated in favor of `discounts`. If a `discounts` list is provided, the
+     * first discount in the list will be returned. If the list is empty, `None` will be returned.
+     */
     fun discount(): Optional<Discount> = Optional.ofNullable(discount.getNullable("discount"))
 
     fun discounts(): List<Discount> = discounts.getRequired("discounts")
@@ -417,6 +421,10 @@ private constructor(
 
     @JsonProperty("customer") @ExcludeMissing fun _customer() = customer
 
+    /**
+     * This field is deprecated in favor of `discounts`. If a `discounts` list is provided, the
+     * first discount in the list will be returned. If the list is empty, `None` will be returned.
+     */
     @JsonProperty("discount") @ExcludeMissing fun _discount() = discount
 
     @JsonProperty("discounts") @ExcludeMissing fun _discounts() = discounts
@@ -1036,8 +1044,18 @@ private constructor(
         @ExcludeMissing
         fun customer(customer: JsonField<Customer>) = apply { this.customer = customer }
 
+        /**
+         * This field is deprecated in favor of `discounts`. If a `discounts` list is provided, the
+         * first discount in the list will be returned. If the list is empty, `None` will be
+         * returned.
+         */
         fun discount(discount: Discount) = discount(JsonField.of(discount))
 
+        /**
+         * This field is deprecated in favor of `discounts`. If a `discounts` list is provided, the
+         * first discount in the list will be returned. If the list is empty, `None` will be
+         * returned.
+         */
         @JsonProperty("discount")
         @ExcludeMissing
         fun discount(discount: JsonField<Discount>) = apply { this.discount = discount }

orb-java-core/src/main/kotlin/com/withorb/api/models/InvoiceFetchUpcomingResponse.kt

@@ -154,6 +154,10 @@ private constructor(
 
     fun customer(): Customer = customer.getRequired("customer")
 
+    /**
+     * This field is deprecated in favor of `discounts`. If a `discounts` list is provided, the
+     * first discount in the list will be returned. If the list is empty, `None` will be returned.
+     */
     fun discount(): Optional<Discount> = Optional.ofNullable(discount.getNullable("discount"))
 
     fun discounts(): List<Discount> = discounts.getRequired("discounts")
@@ -410,6 +414,10 @@ private constructor(
 
     @JsonProperty("customer") @ExcludeMissing fun _customer() = customer
 
+    /**
+     * This field is deprecated in favor of `discounts`. If a `discounts` list is provided, the
+     * first discount in the list will be returned. If the list is empty, `None` will be returned.
+     */
     @JsonProperty("discount") @ExcludeMissing fun _discount() = discount
 
     @JsonProperty("discounts") @ExcludeMissing fun _discounts() = discounts
@@ -1030,8 +1038,18 @@ private constructor(
         @ExcludeMissing
         fun customer(customer: JsonField<Customer>) = apply { this.customer = customer }
 
+        /**
+         * This field is deprecated in favor of `discounts`. If a `discounts` list is provided, the
+         * first discount in the list will be returned. If the list is empty, `None` will be
+         * returned.
+         */
         fun discount(discount: Discount) = discount(JsonField.of(discount))
 
+        /**
+         * This field is deprecated in favor of `discounts`. If a `discounts` list is provided, the
+         * first discount in the list will be returned. If the list is empty, `None` will be
+         * returned.
+         */
         @JsonProperty("discount")
         @ExcludeMissing
         fun discount(discount: JsonField<Discount>) = apply { this.discount = discount }

orb-java-core/src/main/kotlin/com/withorb/api/services/async/CustomerServiceAsync.kt

@@ -72,9 +72,10 @@ interface CustomerServiceAsync {
     ): CompletableFuture<CustomerListPageAsync>
 
     /**
-     * This performs a deletion of this customer, its subscriptions, and its invoices. This
-     * operation is irreversible. Note that this is a _soft_ deletion, but the data will be
-     * inaccessible through the API and Orb dashboard. For hard-deletion, please reach out to the
+     * This performs a deletion of this customer, its subscriptions, and its invoices, provided the
+     * customer does not have any issued invoices. Customers with issued invoices cannot be deleted.
+     * This operation is irreversible. Note that this is a _soft_ deletion, but the data will be
+     * inaccessible through the API and Orb dashboard. For a hard-deletion, please reach out to the
      * Orb team directly.
      *
      * **Note**: This operation happens asynchronously and can be expected to take a few minutes to

orb-java-core/src/main/kotlin/com/withorb/api/services/async/CustomerServiceAsyncImpl.kt

@@ -168,9 +168,10 @@ constructor(
     private val deleteHandler: Handler<Void?> = emptyHandler().withErrorHandler(errorHandler)
 
     /**
-     * This performs a deletion of this customer, its subscriptions, and its invoices. This
-     * operation is irreversible. Note that this is a _soft_ deletion, but the data will be
-     * inaccessible through the API and Orb dashboard. For hard-deletion, please reach out to the
+     * This performs a deletion of this customer, its subscriptions, and its invoices, provided the
+     * customer does not have any issued invoices. Customers with issued invoices cannot be deleted.
+     * This operation is irreversible. Note that this is a _soft_ deletion, but the data will be
+     * inaccessible through the API and Orb dashboard. For a hard-deletion, please reach out to the
      * Orb team directly.
      *
      * **Note**: This operation happens asynchronously and can be expected to take a few minutes to

orb-java-core/src/main/kotlin/com/withorb/api/services/blocking/CustomerService.kt

@@ -71,9 +71,10 @@ interface CustomerService {
     ): CustomerListPage
 
     /**
-     * This performs a deletion of this customer, its subscriptions, and its invoices. This
-     * operation is irreversible. Note that this is a _soft_ deletion, but the data will be
-     * inaccessible through the API and Orb dashboard. For hard-deletion, please reach out to the
+     * This performs a deletion of this customer, its subscriptions, and its invoices, provided the
+     * customer does not have any issued invoices. Customers with issued invoices cannot be deleted.
+     * This operation is irreversible. Note that this is a _soft_ deletion, but the data will be
+     * inaccessible through the API and Orb dashboard. For a hard-deletion, please reach out to the
      * Orb team directly.
      *
      * **Note**: This operation happens asynchronously and can be expected to take a few minutes to

orb-java-core/src/main/kotlin/com/withorb/api/services/blocking/CustomerServiceImpl.kt

@@ -158,9 +158,10 @@ constructor(
     private val deleteHandler: Handler<Void?> = emptyHandler().withErrorHandler(errorHandler)
 
     /**
-     * This performs a deletion of this customer, its subscriptions, and its invoices. This
-     * operation is irreversible. Note that this is a _soft_ deletion, but the data will be
-     * inaccessible through the API and Orb dashboard. For hard-deletion, please reach out to the
+     * This performs a deletion of this customer, its subscriptions, and its invoices, provided the
+     * customer does not have any issued invoices. Customers with issued invoices cannot be deleted.
+     * This operation is irreversible. Note that this is a _soft_ deletion, but the data will be
+     * inaccessible through the API and Orb dashboard. For a hard-deletion, please reach out to the
      * Orb team directly.
      *
      * **Note**: This operation happens asynchronously and can be expected to take a few minutes to