diff --git a/.release-please-manifest.json b/.release-please-manifest.json index 5ba086cf..141e7cde 100644 --- a/.release-please-manifest.json +++ b/.release-please-manifest.json @@ -1,3 +1,3 @@ { - ".": "0.46.1" + ".": "0.47.0" } \ No newline at end of file diff --git a/.stats.yml b/.stats.yml index 58bce287..f6e24a32 100644 --- a/.stats.yml +++ b/.stats.yml @@ -1,2 +1,2 @@ configured_endpoints: 103 -openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/orb%2Forb-6797b438a8e6a6856e28f4304a5a3c81bb67e74fa2d6fcc20e734880c725295a.yml +openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/orb%2Forb-04f02fa57c3ab8d15ecf0a16a41a83814c21cdc2a830fae4d65f1b7b2196d819.yml diff --git a/CHANGELOG.md b/CHANGELOG.md index 4ed86daa..422a9a0d 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -1,5 +1,25 @@ # Changelog +## 0.47.0 (2025-03-10) + +Full Changelog: [v0.46.1...v0.47.0](https://github.com/orbcorp/orb-java/compare/v0.46.1...v0.47.0) + +### Features + +* **api:** api update ([#331](https://github.com/orbcorp/orb-java/issues/331)) ([6aea587](https://github.com/orbcorp/orb-java/commit/6aea5874c48a82b78b072e04f5773bb07ed896b6)) + + +### Chores + +* **internal:** don't use `JvmOverloads` in interfaces ([19acfcf](https://github.com/orbcorp/orb-java/commit/19acfcfd105bacde55593bc1d6d7b1c9621fc996)) +* **internal:** reenable warnings as errors ([#327](https://github.com/orbcorp/orb-java/issues/327)) ([19acfcf](https://github.com/orbcorp/orb-java/commit/19acfcfd105bacde55593bc1d6d7b1c9621fc996)) + + +### Documentation + +* document `JsonValue` construction in readme ([#330](https://github.com/orbcorp/orb-java/issues/330)) ([9401e34](https://github.com/orbcorp/orb-java/commit/9401e349149fe4cbc37ee2174e8609cf60d107b0)) +* revise readme docs about nested params ([#329](https://github.com/orbcorp/orb-java/issues/329)) ([9a2a812](https://github.com/orbcorp/orb-java/commit/9a2a812cc9aa3b4ab369a28784e0afaaf37badb4)) + ## 0.46.1 (2025-03-07) Full Changelog: [v0.46.0...v0.46.1](https://github.com/orbcorp/orb-java/compare/v0.46.0...v0.46.1) diff --git a/README.md b/README.md index 928d92f0..e279c294 100644 --- a/README.md +++ b/README.md @@ -2,7 +2,7 @@ -[![Maven Central](https://img.shields.io/maven-central/v/com.withorb.api/orb-java)](https://central.sonatype.com/artifact/com.withorb.api/orb-java/0.46.1) +[![Maven Central](https://img.shields.io/maven-central/v/com.withorb.api/orb-java)](https://central.sonatype.com/artifact/com.withorb.api/orb-java/0.47.0) @@ -19,7 +19,7 @@ The REST API documentation can be found on [docs.withorb.com](https://docs.witho ### Gradle ```kotlin -implementation("com.withorb.api:orb-java:0.46.1") +implementation("com.withorb.api:orb-java:0.47.0") ``` ### Maven @@ -28,7 +28,7 @@ implementation("com.withorb.api:orb-java:0.46.1") com.withorb.api orb-java - 0.46.1 + 0.47.0 ``` @@ -385,9 +385,24 @@ CustomerCreateParams params = CustomerCreateParams.builder() .build(); ``` -These can be accessed on the built object later using the `_additionalHeaders()`, `_additionalQueryParams()`, and `_additionalBodyProperties()` methods. You can also set undocumented parameters on nested headers, query params, or body classes using the `putAdditionalProperty` method. These properties can be accessed on the built object later using the `_additionalProperties()` method. +These can be accessed on the built object later using the `_additionalHeaders()`, `_additionalQueryParams()`, and `_additionalBodyProperties()` methods. -To set a documented parameter or property to an undocumented or not yet supported _value_, pass a [`JsonValue`](orb-java-core/src/main/kotlin/com/withorb/api/core/JsonValue.kt) object to its setter: +To set undocumented parameters on _nested_ headers, query params, or body classes, call the `putAdditionalProperty` method on the nested class: + +```java +import com.withorb.api.core.JsonValue; +import com.withorb.api.models.CustomerCreateParams; + +CustomerCreateParams params = CustomerCreateParams.builder() + .billingAddress(CustomerCreateParams.BillingAddress.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`](orb-java-core/src/main/kotlin/com/withorb/api/core/Values.kt) object to its setter: ```java import com.withorb.api.core.JsonValue; @@ -399,6 +414,45 @@ CustomerCreateParams params = CustomerCreateParams.builder() .build(); ``` +The most straightforward way to create a [`JsonValue`](orb-java-core/src/main/kotlin/com/withorb/api/core/Values.kt) is using its `from(...)` method: + +```java +import com.withorb.api.core.JsonValue; +import java.util.List; +import java.util.Map; + +// Create primitive JSON values +JsonValue nullValue = JsonValue.from(null); +JsonValue booleanValue = JsonValue.from(true); +JsonValue numberValue = JsonValue.from(42); +JsonValue stringValue = JsonValue.from("Hello World!"); + +// Create a JSON array value equivalent to `["Hello", "World"]` +JsonValue arrayValue = JsonValue.from(List.of( + "Hello", "World" +)); + +// Create a JSON object value equivalent to `{ "a": 1, "b": 2 }` +JsonValue objectValue = JsonValue.from(Map.of( + "a", 1, + "b", 2 +)); + +// Create an arbitrarily nested JSON equivalent to: +// { +// "a": [1, 2], +// "b": [3, 4] +// } +JsonValue complexValue = JsonValue.from(Map.of( + "a", List.of( + 1, 2 + ), + "b", List.of( + 3, 4 + ) +)); +``` + ### Response properties To access undocumented response properties, call the `_additionalProperties()` method: diff --git a/build.gradle.kts b/build.gradle.kts index 45f8d5a0..b029c0ed 100644 --- a/build.gradle.kts +++ b/build.gradle.kts @@ -1,4 +1,4 @@ allprojects { group = "com.withorb.api" - version = "0.46.1" // x-release-please-version + version = "0.47.0" // x-release-please-version } diff --git a/buildSrc/src/main/kotlin/orb.kotlin.gradle.kts b/buildSrc/src/main/kotlin/orb.kotlin.gradle.kts index 1cf56f97..b4bc5d0d 100644 --- a/buildSrc/src/main/kotlin/orb.kotlin.gradle.kts +++ b/buildSrc/src/main/kotlin/orb.kotlin.gradle.kts @@ -22,11 +22,12 @@ configure { tasks.withType().configureEach { compilerOptions { + allWarningsAsErrors = true freeCompilerArgs = listOf( - "-Xjvm-default=all", - "-Xjdk-release=1.8", - // Suppress deprecation warnings because we may still reference and test deprecated members. - "-Xsuppress-warning=DEPRECATION" + "-Xjvm-default=all", + "-Xjdk-release=1.8", + // Suppress deprecation warnings because we may still reference and test deprecated members. + "-Xsuppress-warning=DEPRECATION" ) jvmTarget.set(JvmTarget.JVM_1_8) } diff --git a/orb-java-core/src/main/kotlin/com/withorb/api/core/http/HttpClient.kt b/orb-java-core/src/main/kotlin/com/withorb/api/core/http/HttpClient.kt index d035290d..5fe830d6 100644 --- a/orb-java-core/src/main/kotlin/com/withorb/api/core/http/HttpClient.kt +++ b/orb-java-core/src/main/kotlin/com/withorb/api/core/http/HttpClient.kt @@ -1,5 +1,3 @@ -@file:Suppress("OVERLOADS_INTERFACE") // See https://youtrack.jetbrains.com/issue/KT-36102 - package com.withorb.api.core.http import com.withorb.api.core.RequestOptions @@ -8,18 +6,21 @@ import java.util.concurrent.CompletableFuture interface HttpClient : AutoCloseable { - @JvmOverloads fun execute( request: HttpRequest, requestOptions: RequestOptions = RequestOptions.none(), ): HttpResponse - @JvmOverloads + fun execute(request: HttpRequest): HttpResponse = execute(request, RequestOptions.none()) + fun executeAsync( request: HttpRequest, requestOptions: RequestOptions = RequestOptions.none(), ): CompletableFuture + fun executeAsync(request: HttpRequest): CompletableFuture = + executeAsync(request, RequestOptions.none()) + /** Overridden from [AutoCloseable] to not have a checked exception in its signature. */ override fun close() } diff --git a/orb-java-core/src/main/kotlin/com/withorb/api/models/SubscriptionPriceIntervalsParams.kt b/orb-java-core/src/main/kotlin/com/withorb/api/models/SubscriptionPriceIntervalsParams.kt index 3c47565b..e80a87dd 100644 --- a/orb-java-core/src/main/kotlin/com/withorb/api/models/SubscriptionPriceIntervalsParams.kt +++ b/orb-java-core/src/main/kotlin/com/withorb/api/models/SubscriptionPriceIntervalsParams.kt @@ -49642,13 +49642,17 @@ private constructor( /** * The start date of the adjustment interval. This is the date that the adjustment will - * start affecting prices on the subscription. + * start affecting prices on the subscription. The adjustment will apply to invoice dates + * that overlap with this `start_date`. This `start_date` is treated as inclusive for + * in-advance prices, and exclusive for in-arrears prices. */ fun startDate(): StartDate = startDate.getRequired("start_date") /** * The end date of the adjustment interval. This is the date that the adjustment will stop - * affecting prices on the subscription. + * affecting prices on the subscription. The adjustment will apply to invoice dates that + * overlap with this `end_date`.This `end_date` is treated as exclusive for in-advance + * prices, and inclusive for in-arrears prices. */ fun endDate(): Optional = Optional.ofNullable(endDate.getNullable("end_date")) @@ -49659,7 +49663,9 @@ private constructor( /** * The start date of the adjustment interval. This is the date that the adjustment will - * start affecting prices on the subscription. + * start affecting prices on the subscription. The adjustment will apply to invoice dates + * that overlap with this `start_date`. This `start_date` is treated as inclusive for + * in-advance prices, and exclusive for in-arrears prices. */ @JsonProperty("start_date") @ExcludeMissing @@ -49667,7 +49673,9 @@ private constructor( /** * The end date of the adjustment interval. This is the date that the adjustment will stop - * affecting prices on the subscription. + * affecting prices on the subscription. The adjustment will apply to invoice dates that + * overlap with this `end_date`.This `end_date` is treated as exclusive for in-advance + * prices, and inclusive for in-arrears prices. */ @JsonProperty("end_date") @ExcludeMissing fun _endDate(): JsonField = endDate @@ -49750,56 +49758,74 @@ private constructor( /** * The start date of the adjustment interval. This is the date that the adjustment will - * start affecting prices on the subscription. + * start affecting prices on the subscription. The adjustment will apply to invoice + * dates that overlap with this `start_date`. This `start_date` is treated as inclusive + * for in-advance prices, and exclusive for in-arrears prices. */ fun startDate(startDate: StartDate) = startDate(JsonField.of(startDate)) /** * The start date of the adjustment interval. This is the date that the adjustment will - * start affecting prices on the subscription. + * start affecting prices on the subscription. The adjustment will apply to invoice + * dates that overlap with this `start_date`. This `start_date` is treated as inclusive + * for in-advance prices, and exclusive for in-arrears prices. */ fun startDate(startDate: JsonField) = apply { this.startDate = startDate } /** * The start date of the adjustment interval. This is the date that the adjustment will - * start affecting prices on the subscription. + * start affecting prices on the subscription. The adjustment will apply to invoice + * dates that overlap with this `start_date`. This `start_date` is treated as inclusive + * for in-advance prices, and exclusive for in-arrears prices. */ fun startDate(dateTime: OffsetDateTime) = startDate(StartDate.ofDateTime(dateTime)) /** * The start date of the adjustment interval. This is the date that the adjustment will - * start affecting prices on the subscription. + * start affecting prices on the subscription. The adjustment will apply to invoice + * dates that overlap with this `start_date`. This `start_date` is treated as inclusive + * for in-advance prices, and exclusive for in-arrears prices. */ fun startDate(billingCycleRelative: BillingCycleRelativeDate) = startDate(StartDate.ofBillingCycleRelative(billingCycleRelative)) /** * The end date of the adjustment interval. This is the date that the adjustment will - * stop affecting prices on the subscription. + * stop affecting prices on the subscription. The adjustment will apply to invoice dates + * that overlap with this `end_date`.This `end_date` is treated as exclusive for + * in-advance prices, and inclusive for in-arrears prices. */ fun endDate(endDate: EndDate?) = endDate(JsonField.ofNullable(endDate)) /** * The end date of the adjustment interval. This is the date that the adjustment will - * stop affecting prices on the subscription. + * stop affecting prices on the subscription. The adjustment will apply to invoice dates + * that overlap with this `end_date`.This `end_date` is treated as exclusive for + * in-advance prices, and inclusive for in-arrears prices. */ fun endDate(endDate: Optional) = endDate(endDate.getOrNull()) /** * The end date of the adjustment interval. This is the date that the adjustment will - * stop affecting prices on the subscription. + * stop affecting prices on the subscription. The adjustment will apply to invoice dates + * that overlap with this `end_date`.This `end_date` is treated as exclusive for + * in-advance prices, and inclusive for in-arrears prices. */ fun endDate(endDate: JsonField) = apply { this.endDate = endDate } /** * The end date of the adjustment interval. This is the date that the adjustment will - * stop affecting prices on the subscription. + * stop affecting prices on the subscription. The adjustment will apply to invoice dates + * that overlap with this `end_date`.This `end_date` is treated as exclusive for + * in-advance prices, and inclusive for in-arrears prices. */ fun endDate(dateTime: OffsetDateTime) = endDate(EndDate.ofDateTime(dateTime)) /** * The end date of the adjustment interval. This is the date that the adjustment will - * stop affecting prices on the subscription. + * stop affecting prices on the subscription. The adjustment will apply to invoice dates + * that overlap with this `end_date`.This `end_date` is treated as exclusive for + * in-advance prices, and inclusive for in-arrears prices. */ fun endDate(billingCycleRelative: BillingCycleRelativeDate) = endDate(EndDate.ofBillingCycleRelative(billingCycleRelative)) @@ -51651,7 +51677,9 @@ private constructor( /** * The start date of the adjustment interval. This is the date that the adjustment will - * start affecting prices on the subscription. + * start affecting prices on the subscription. The adjustment will apply to invoice dates + * that overlap with this `start_date`. This `start_date` is treated as inclusive for + * in-advance prices, and exclusive for in-arrears prices. */ @JsonDeserialize(using = StartDate.Deserializer::class) @JsonSerialize(using = StartDate.Serializer::class) @@ -51795,7 +51823,9 @@ private constructor( /** * The end date of the adjustment interval. This is the date that the adjustment will stop - * affecting prices on the subscription. + * affecting prices on the subscription. The adjustment will apply to invoice dates that + * overlap with this `end_date`.This `end_date` is treated as exclusive for in-advance + * prices, and inclusive for in-arrears prices. */ @JsonDeserialize(using = EndDate.Deserializer::class) @JsonSerialize(using = EndDate.Serializer::class) diff --git a/orb-java-core/src/main/kotlin/com/withorb/api/services/async/AlertServiceAsync.kt b/orb-java-core/src/main/kotlin/com/withorb/api/services/async/AlertServiceAsync.kt index 56bf4b3e..c2b19190 100644 --- a/orb-java-core/src/main/kotlin/com/withorb/api/services/async/AlertServiceAsync.kt +++ b/orb-java-core/src/main/kotlin/com/withorb/api/services/async/AlertServiceAsync.kt @@ -1,7 +1,5 @@ // File generated from our OpenAPI spec by Stainless. -@file:Suppress("OVERLOADS_INTERFACE") // See https://youtrack.jetbrains.com/issue/KT-36102 - package com.withorb.api.services.async import com.google.errorprone.annotations.MustBeClosed @@ -27,14 +25,20 @@ interface AlertServiceAsync { fun withRawResponse(): WithRawResponse /** This endpoint retrieves an alert by its ID. */ - @JvmOverloads + fun retrieve(params: AlertRetrieveParams): CompletableFuture = + retrieve(params, RequestOptions.none()) + + /** @see [retrieve] */ fun retrieve( params: AlertRetrieveParams, requestOptions: RequestOptions = RequestOptions.none(), ): CompletableFuture /** This endpoint updates the thresholds of an alert. */ - @JvmOverloads + fun update(params: AlertUpdateParams): CompletableFuture = + update(params, RequestOptions.none()) + + /** @see [update] */ fun update( params: AlertUpdateParams, requestOptions: RequestOptions = RequestOptions.none(), @@ -51,23 +55,20 @@ interface AlertServiceAsync { * The list of alerts is ordered starting from the most recently created alert. This endpoint * follows Orb's [standardized pagination format](/api-reference/pagination). */ - @JvmOverloads + fun list(): CompletableFuture = list(AlertListParams.none()) + + /** @see [list] */ fun list( params: AlertListParams = AlertListParams.none(), requestOptions: RequestOptions = RequestOptions.none(), ): CompletableFuture - /** - * This endpoint returns a list of alerts within Orb. - * - * The request must specify one of `customer_id`, `external_customer_id`, or `subscription_id`. - * - * If querying by subscripion_id, the endpoint will return the subscription level alerts as well - * as the plan level alerts associated with the subscription. - * - * The list of alerts is ordered starting from the most recently created alert. This endpoint - * follows Orb's [standardized pagination format](/api-reference/pagination). - */ + /** @see [list] */ + fun list( + params: AlertListParams = AlertListParams.none() + ): CompletableFuture = list(params, RequestOptions.none()) + + /** @see [list] */ fun list(requestOptions: RequestOptions): CompletableFuture = list(AlertListParams.none(), requestOptions) @@ -79,7 +80,10 @@ interface AlertServiceAsync { * `credit_balance_dropped` alerts require a list of thresholds to be provided while * `credit_balance_depleted` and `credit_balance_recovered` alerts do not require thresholds. */ - @JvmOverloads + fun createForCustomer(params: AlertCreateForCustomerParams): CompletableFuture = + createForCustomer(params, RequestOptions.none()) + + /** @see [createForCustomer] */ fun createForCustomer( params: AlertCreateForCustomerParams, requestOptions: RequestOptions = RequestOptions.none(), @@ -93,7 +97,11 @@ interface AlertServiceAsync { * `credit_balance_dropped` alerts require a list of thresholds to be provided while * `credit_balance_depleted` and `credit_balance_recovered` alerts do not require thresholds. */ - @JvmOverloads + fun createForExternalCustomer( + params: AlertCreateForExternalCustomerParams + ): CompletableFuture = createForExternalCustomer(params, RequestOptions.none()) + + /** @see [createForExternalCustomer] */ fun createForExternalCustomer( params: AlertCreateForExternalCustomerParams, requestOptions: RequestOptions = RequestOptions.none(), @@ -111,7 +119,10 @@ interface AlertServiceAsync { * per metric that is a part of the subscription. Alerts are triggered based on usage or cost * conditions met during the current billing cycle. */ - @JvmOverloads + fun createForSubscription(params: AlertCreateForSubscriptionParams): CompletableFuture = + createForSubscription(params, RequestOptions.none()) + + /** @see [createForSubscription] */ fun createForSubscription( params: AlertCreateForSubscriptionParams, requestOptions: RequestOptions = RequestOptions.none(), @@ -122,7 +133,10 @@ interface AlertServiceAsync { * subscription, you must include the `subscription_id`. The `subscription_id` is not required * for customer or subscription level alerts. */ - @JvmOverloads + fun disable(params: AlertDisableParams): CompletableFuture = + disable(params, RequestOptions.none()) + + /** @see [disable] */ fun disable( params: AlertDisableParams, requestOptions: RequestOptions = RequestOptions.none(), @@ -133,7 +147,10 @@ interface AlertServiceAsync { * subscription, you must include the `subscription_id`. The `subscription_id` is not required * for customer or subscription level alerts. */ - @JvmOverloads + fun enable(params: AlertEnableParams): CompletableFuture = + enable(params, RequestOptions.none()) + + /** @see [enable] */ fun enable( params: AlertEnableParams, requestOptions: RequestOptions = RequestOptions.none(), @@ -146,7 +163,11 @@ interface AlertServiceAsync { * Returns a raw HTTP response for `get /alerts/{alert_id}`, but is otherwise the same as * [AlertServiceAsync.retrieve]. */ - @JvmOverloads + @MustBeClosed + fun retrieve(params: AlertRetrieveParams): CompletableFuture> = + retrieve(params, RequestOptions.none()) + + /** @see [retrieve] */ @MustBeClosed fun retrieve( params: AlertRetrieveParams, @@ -157,7 +178,11 @@ interface AlertServiceAsync { * Returns a raw HTTP response for `put /alerts/{alert_configuration_id}`, but is otherwise * the same as [AlertServiceAsync.update]. */ - @JvmOverloads + @MustBeClosed + fun update(params: AlertUpdateParams): CompletableFuture> = + update(params, RequestOptions.none()) + + /** @see [update] */ @MustBeClosed fun update( params: AlertUpdateParams, @@ -168,17 +193,25 @@ interface AlertServiceAsync { * Returns a raw HTTP response for `get /alerts`, but is otherwise the same as * [AlertServiceAsync.list]. */ - @JvmOverloads + @MustBeClosed + fun list(): CompletableFuture> = + list(AlertListParams.none()) + + /** @see [list] */ @MustBeClosed fun list( params: AlertListParams = AlertListParams.none(), requestOptions: RequestOptions = RequestOptions.none(), ): CompletableFuture> - /** - * Returns a raw HTTP response for `get /alerts`, but is otherwise the same as - * [AlertServiceAsync.list]. - */ + /** @see [list] */ + @MustBeClosed + fun list( + params: AlertListParams = AlertListParams.none() + ): CompletableFuture> = + list(params, RequestOptions.none()) + + /** @see [list] */ @MustBeClosed fun list( requestOptions: RequestOptions @@ -189,7 +222,13 @@ interface AlertServiceAsync { * Returns a raw HTTP response for `post /alerts/customer_id/{customer_id}`, but is * otherwise the same as [AlertServiceAsync.createForCustomer]. */ - @JvmOverloads + @MustBeClosed + fun createForCustomer( + params: AlertCreateForCustomerParams + ): CompletableFuture> = + createForCustomer(params, RequestOptions.none()) + + /** @see [createForCustomer] */ @MustBeClosed fun createForCustomer( params: AlertCreateForCustomerParams, @@ -201,7 +240,13 @@ interface AlertServiceAsync { * /alerts/external_customer_id/{external_customer_id}`, but is otherwise the same as * [AlertServiceAsync.createForExternalCustomer]. */ - @JvmOverloads + @MustBeClosed + fun createForExternalCustomer( + params: AlertCreateForExternalCustomerParams + ): CompletableFuture> = + createForExternalCustomer(params, RequestOptions.none()) + + /** @see [createForExternalCustomer] */ @MustBeClosed fun createForExternalCustomer( params: AlertCreateForExternalCustomerParams, @@ -212,7 +257,13 @@ interface AlertServiceAsync { * Returns a raw HTTP response for `post /alerts/subscription_id/{subscription_id}`, but is * otherwise the same as [AlertServiceAsync.createForSubscription]. */ - @JvmOverloads + @MustBeClosed + fun createForSubscription( + params: AlertCreateForSubscriptionParams + ): CompletableFuture> = + createForSubscription(params, RequestOptions.none()) + + /** @see [createForSubscription] */ @MustBeClosed fun createForSubscription( params: AlertCreateForSubscriptionParams, @@ -223,7 +274,11 @@ interface AlertServiceAsync { * Returns a raw HTTP response for `post /alerts/{alert_configuration_id}/disable`, but is * otherwise the same as [AlertServiceAsync.disable]. */ - @JvmOverloads + @MustBeClosed + fun disable(params: AlertDisableParams): CompletableFuture> = + disable(params, RequestOptions.none()) + + /** @see [disable] */ @MustBeClosed fun disable( params: AlertDisableParams, @@ -234,7 +289,11 @@ interface AlertServiceAsync { * Returns a raw HTTP response for `post /alerts/{alert_configuration_id}/enable`, but is * otherwise the same as [AlertServiceAsync.enable]. */ - @JvmOverloads + @MustBeClosed + fun enable(params: AlertEnableParams): CompletableFuture> = + enable(params, RequestOptions.none()) + + /** @see [enable] */ @MustBeClosed fun enable( params: AlertEnableParams, diff --git a/orb-java-core/src/main/kotlin/com/withorb/api/services/async/CouponServiceAsync.kt b/orb-java-core/src/main/kotlin/com/withorb/api/services/async/CouponServiceAsync.kt index 9b15744c..d3cbe42e 100644 --- a/orb-java-core/src/main/kotlin/com/withorb/api/services/async/CouponServiceAsync.kt +++ b/orb-java-core/src/main/kotlin/com/withorb/api/services/async/CouponServiceAsync.kt @@ -1,7 +1,5 @@ // File generated from our OpenAPI spec by Stainless. -@file:Suppress("OVERLOADS_INTERFACE") // See https://youtrack.jetbrains.com/issue/KT-36102 - package com.withorb.api.services.async import com.google.errorprone.annotations.MustBeClosed @@ -29,7 +27,10 @@ interface CouponServiceAsync { * This endpoint allows the creation of coupons, which can then be redeemed at subscription * creation or plan change. */ - @JvmOverloads + fun create(params: CouponCreateParams): CompletableFuture = + create(params, RequestOptions.none()) + + /** @see [create] */ fun create( params: CouponCreateParams, requestOptions: RequestOptions = RequestOptions.none(), @@ -43,20 +44,20 @@ interface CouponServiceAsync { * if they exist. More information about pagination can be found in the Pagination-metadata * schema. */ - @JvmOverloads + fun list(): CompletableFuture = list(CouponListParams.none()) + + /** @see [list] */ fun list( params: CouponListParams = CouponListParams.none(), requestOptions: RequestOptions = RequestOptions.none(), ): CompletableFuture - /** - * This endpoint returns a list of all coupons for an account in a list format. - * - * The list of coupons is ordered starting from the most recently created coupon. The response - * also includes `pagination_metadata`, which lets the caller retrieve the next page of results - * if they exist. More information about pagination can be found in the Pagination-metadata - * schema. - */ + /** @see [list] */ + fun list( + params: CouponListParams = CouponListParams.none() + ): CompletableFuture = list(params, RequestOptions.none()) + + /** @see [list] */ fun list(requestOptions: RequestOptions): CompletableFuture = list(CouponListParams.none(), requestOptions) @@ -65,7 +66,10 @@ interface CouponServiceAsync { * will be hidden from lists of active coupons. Additionally, once a coupon is archived, its * redemption code can be reused for a different coupon. */ - @JvmOverloads + fun archive(params: CouponArchiveParams): CompletableFuture = + archive(params, RequestOptions.none()) + + /** @see [archive] */ fun archive( params: CouponArchiveParams, requestOptions: RequestOptions = RequestOptions.none(), @@ -75,7 +79,10 @@ interface CouponServiceAsync { * This endpoint retrieves a coupon by its ID. To fetch coupons by their redemption code, use * the [List coupons](list-coupons) endpoint with the redemption_code parameter. */ - @JvmOverloads + fun fetch(params: CouponFetchParams): CompletableFuture = + fetch(params, RequestOptions.none()) + + /** @see [fetch] */ fun fetch( params: CouponFetchParams, requestOptions: RequestOptions = RequestOptions.none(), @@ -92,7 +99,11 @@ interface CouponServiceAsync { * Returns a raw HTTP response for `post /coupons`, but is otherwise the same as * [CouponServiceAsync.create]. */ - @JvmOverloads + @MustBeClosed + fun create(params: CouponCreateParams): CompletableFuture> = + create(params, RequestOptions.none()) + + /** @see [create] */ @MustBeClosed fun create( params: CouponCreateParams, @@ -103,17 +114,25 @@ interface CouponServiceAsync { * Returns a raw HTTP response for `get /coupons`, but is otherwise the same as * [CouponServiceAsync.list]. */ - @JvmOverloads + @MustBeClosed + fun list(): CompletableFuture> = + list(CouponListParams.none()) + + /** @see [list] */ @MustBeClosed fun list( params: CouponListParams = CouponListParams.none(), requestOptions: RequestOptions = RequestOptions.none(), ): CompletableFuture> - /** - * Returns a raw HTTP response for `get /coupons`, but is otherwise the same as - * [CouponServiceAsync.list]. - */ + /** @see [list] */ + @MustBeClosed + fun list( + params: CouponListParams = CouponListParams.none() + ): CompletableFuture> = + list(params, RequestOptions.none()) + + /** @see [list] */ @MustBeClosed fun list( requestOptions: RequestOptions @@ -124,7 +143,11 @@ interface CouponServiceAsync { * Returns a raw HTTP response for `post /coupons/{coupon_id}/archive`, but is otherwise the * same as [CouponServiceAsync.archive]. */ - @JvmOverloads + @MustBeClosed + fun archive(params: CouponArchiveParams): CompletableFuture> = + archive(params, RequestOptions.none()) + + /** @see [archive] */ @MustBeClosed fun archive( params: CouponArchiveParams, @@ -135,7 +158,11 @@ interface CouponServiceAsync { * Returns a raw HTTP response for `get /coupons/{coupon_id}`, but is otherwise the same as * [CouponServiceAsync.fetch]. */ - @JvmOverloads + @MustBeClosed + fun fetch(params: CouponFetchParams): CompletableFuture> = + fetch(params, RequestOptions.none()) + + /** @see [fetch] */ @MustBeClosed fun fetch( params: CouponFetchParams, diff --git a/orb-java-core/src/main/kotlin/com/withorb/api/services/async/CreditNoteServiceAsync.kt b/orb-java-core/src/main/kotlin/com/withorb/api/services/async/CreditNoteServiceAsync.kt index 652339bf..dbf8afee 100644 --- a/orb-java-core/src/main/kotlin/com/withorb/api/services/async/CreditNoteServiceAsync.kt +++ b/orb-java-core/src/main/kotlin/com/withorb/api/services/async/CreditNoteServiceAsync.kt @@ -1,7 +1,5 @@ // File generated from our OpenAPI spec by Stainless. -@file:Suppress("OVERLOADS_INTERFACE") // See https://youtrack.jetbrains.com/issue/KT-36102 - package com.withorb.api.services.async import com.google.errorprone.annotations.MustBeClosed @@ -22,7 +20,10 @@ interface CreditNoteServiceAsync { fun withRawResponse(): WithRawResponse /** This endpoint is used to create a single [`Credit Note`](/invoicing/credit-notes). */ - @JvmOverloads + fun create(params: CreditNoteCreateParams): CompletableFuture = + create(params, RequestOptions.none()) + + /** @see [create] */ fun create( params: CreditNoteCreateParams, requestOptions: RequestOptions = RequestOptions.none(), @@ -33,17 +34,20 @@ interface CreditNoteServiceAsync { * or external_customer_id. The credit notes will be returned in reverse chronological order by * `creation_time`. */ - @JvmOverloads + fun list(): CompletableFuture = list(CreditNoteListParams.none()) + + /** @see [list] */ fun list( params: CreditNoteListParams = CreditNoteListParams.none(), requestOptions: RequestOptions = RequestOptions.none(), ): CompletableFuture - /** - * Get a paginated list of CreditNotes. Users can also filter by customer_id, subscription_id, - * or external_customer_id. The credit notes will be returned in reverse chronological order by - * `creation_time`. - */ + /** @see [list] */ + fun list( + params: CreditNoteListParams = CreditNoteListParams.none() + ): CompletableFuture = list(params, RequestOptions.none()) + + /** @see [list] */ fun list(requestOptions: RequestOptions): CompletableFuture = list(CreditNoteListParams.none(), requestOptions) @@ -51,7 +55,10 @@ interface CreditNoteServiceAsync { * This endpoint is used to fetch a single [`Credit Note`](/invoicing/credit-notes) given an * identifier. */ - @JvmOverloads + fun fetch(params: CreditNoteFetchParams): CompletableFuture = + fetch(params, RequestOptions.none()) + + /** @see [fetch] */ fun fetch( params: CreditNoteFetchParams, requestOptions: RequestOptions = RequestOptions.none(), @@ -67,7 +74,11 @@ interface CreditNoteServiceAsync { * Returns a raw HTTP response for `post /credit_notes`, but is otherwise the same as * [CreditNoteServiceAsync.create]. */ - @JvmOverloads + @MustBeClosed + fun create(params: CreditNoteCreateParams): CompletableFuture> = + create(params, RequestOptions.none()) + + /** @see [create] */ @MustBeClosed fun create( params: CreditNoteCreateParams, @@ -78,17 +89,25 @@ interface CreditNoteServiceAsync { * Returns a raw HTTP response for `get /credit_notes`, but is otherwise the same as * [CreditNoteServiceAsync.list]. */ - @JvmOverloads + @MustBeClosed + fun list(): CompletableFuture> = + list(CreditNoteListParams.none()) + + /** @see [list] */ @MustBeClosed fun list( params: CreditNoteListParams = CreditNoteListParams.none(), requestOptions: RequestOptions = RequestOptions.none(), ): CompletableFuture> - /** - * Returns a raw HTTP response for `get /credit_notes`, but is otherwise the same as - * [CreditNoteServiceAsync.list]. - */ + /** @see [list] */ + @MustBeClosed + fun list( + params: CreditNoteListParams = CreditNoteListParams.none() + ): CompletableFuture> = + list(params, RequestOptions.none()) + + /** @see [list] */ @MustBeClosed fun list( requestOptions: RequestOptions @@ -99,7 +118,11 @@ interface CreditNoteServiceAsync { * Returns a raw HTTP response for `get /credit_notes/{credit_note_id}`, but is otherwise * the same as [CreditNoteServiceAsync.fetch]. */ - @JvmOverloads + @MustBeClosed + fun fetch(params: CreditNoteFetchParams): CompletableFuture> = + fetch(params, RequestOptions.none()) + + /** @see [fetch] */ @MustBeClosed fun fetch( params: CreditNoteFetchParams, diff --git a/orb-java-core/src/main/kotlin/com/withorb/api/services/async/CustomerServiceAsync.kt b/orb-java-core/src/main/kotlin/com/withorb/api/services/async/CustomerServiceAsync.kt index edaa48d4..89ee4cb0 100644 --- a/orb-java-core/src/main/kotlin/com/withorb/api/services/async/CustomerServiceAsync.kt +++ b/orb-java-core/src/main/kotlin/com/withorb/api/services/async/CustomerServiceAsync.kt @@ -1,7 +1,5 @@ // File generated from our OpenAPI spec by Stainless. -@file:Suppress("OVERLOADS_INTERFACE") // See https://youtrack.jetbrains.com/issue/KT-36102 - package com.withorb.api.services.async import com.google.errorprone.annotations.MustBeClosed @@ -50,7 +48,10 @@ interface CustomerServiceAsync { * - [Timezone localization](/essentials/timezones) can be configured on a per-customer basis by * setting the `timezone` parameter */ - @JvmOverloads + fun create(params: CustomerCreateParams): CompletableFuture = + create(params, RequestOptions.none()) + + /** @see [create] */ fun create( params: CustomerCreateParams, requestOptions: RequestOptions = RequestOptions.none(), @@ -62,7 +63,10 @@ interface CustomerServiceAsync { * `billing_address`, and `additional_emails` of an existing customer. Other fields on a * customer are currently immutable. */ - @JvmOverloads + fun update(params: CustomerUpdateParams): CompletableFuture = + update(params, RequestOptions.none()) + + /** @see [update] */ fun update( params: CustomerUpdateParams, requestOptions: RequestOptions = RequestOptions.none(), @@ -75,19 +79,20 @@ interface CustomerServiceAsync { * * See [Customer](/core-concepts##customer) for an overview of the customer model. */ - @JvmOverloads + fun list(): CompletableFuture = list(CustomerListParams.none()) + + /** @see [list] */ fun list( params: CustomerListParams = CustomerListParams.none(), requestOptions: RequestOptions = RequestOptions.none(), ): CompletableFuture - /** - * This endpoint returns a list of all customers for an account. The list of customers is - * ordered starting from the most recently created customer. This endpoint follows Orb's - * [standardized pagination format](/api-reference/pagination). - * - * See [Customer](/core-concepts##customer) for an overview of the customer model. - */ + /** @see [list] */ + fun list( + params: CustomerListParams = CustomerListParams.none() + ): CompletableFuture = list(params, RequestOptions.none()) + + /** @see [list] */ fun list(requestOptions: RequestOptions): CompletableFuture = list(CustomerListParams.none(), requestOptions) @@ -106,7 +111,10 @@ interface CustomerServiceAsync { * * On successful processing, this returns an empty dictionary (`{}`) in the API. */ - @JvmOverloads + fun delete(params: CustomerDeleteParams): CompletableFuture = + delete(params, RequestOptions.none()) + + /** @see [delete] */ fun delete( params: CustomerDeleteParams, requestOptions: RequestOptions = RequestOptions.none(), @@ -119,7 +127,10 @@ interface CustomerServiceAsync { * See the [Customer resource](/core-concepts#customer) for a full discussion of the Customer * model. */ - @JvmOverloads + fun fetch(params: CustomerFetchParams): CompletableFuture = + fetch(params, RequestOptions.none()) + + /** @see [fetch] */ fun fetch( params: CustomerFetchParams, requestOptions: RequestOptions = RequestOptions.none(), @@ -132,7 +143,10 @@ interface CustomerServiceAsync { * Note that the resource and semantics of this endpoint exactly mirror * [Get Customer](fetch-customer). */ - @JvmOverloads + fun fetchByExternalId(params: CustomerFetchByExternalIdParams): CompletableFuture = + fetchByExternalId(params, RequestOptions.none()) + + /** @see [fetchByExternalId] */ fun fetchByExternalId( params: CustomerFetchByExternalIdParams, requestOptions: RequestOptions = RequestOptions.none(), @@ -146,7 +160,11 @@ interface CustomerServiceAsync { * * **Note**: This functionality is currently only available for Stripe. */ - @JvmOverloads + fun syncPaymentMethodsFromGateway( + params: CustomerSyncPaymentMethodsFromGatewayParams + ): CompletableFuture = syncPaymentMethodsFromGateway(params, RequestOptions.none()) + + /** @see [syncPaymentMethodsFromGateway] */ fun syncPaymentMethodsFromGateway( params: CustomerSyncPaymentMethodsFromGatewayParams, requestOptions: RequestOptions = RequestOptions.none(), @@ -160,7 +178,12 @@ interface CustomerServiceAsync { * * **Note**: This functionality is currently only available for Stripe. */ - @JvmOverloads + fun syncPaymentMethodsFromGatewayByExternalCustomerId( + params: CustomerSyncPaymentMethodsFromGatewayByExternalCustomerIdParams + ): CompletableFuture = + syncPaymentMethodsFromGatewayByExternalCustomerId(params, RequestOptions.none()) + + /** @see [syncPaymentMethodsFromGatewayByExternalCustomerId] */ fun syncPaymentMethodsFromGatewayByExternalCustomerId( params: CustomerSyncPaymentMethodsFromGatewayByExternalCustomerIdParams, requestOptions: RequestOptions = RequestOptions.none(), @@ -171,7 +194,10 @@ interface CustomerServiceAsync { * [Customer ID Aliases](/events-and-metrics/customer-aliases)). Note that the resource and * semantics of this endpoint exactly mirror [Update Customer](update-customer). */ - @JvmOverloads + fun updateByExternalId(params: CustomerUpdateByExternalIdParams): CompletableFuture = + updateByExternalId(params, RequestOptions.none()) + + /** @see [updateByExternalId] */ fun updateByExternalId( params: CustomerUpdateByExternalIdParams, requestOptions: RequestOptions = RequestOptions.none(), @@ -192,7 +218,11 @@ interface CustomerServiceAsync { * Returns a raw HTTP response for `post /customers`, but is otherwise the same as * [CustomerServiceAsync.create]. */ - @JvmOverloads + @MustBeClosed + fun create(params: CustomerCreateParams): CompletableFuture> = + create(params, RequestOptions.none()) + + /** @see [create] */ @MustBeClosed fun create( params: CustomerCreateParams, @@ -203,7 +233,11 @@ interface CustomerServiceAsync { * Returns a raw HTTP response for `put /customers/{customer_id}`, but is otherwise the same * as [CustomerServiceAsync.update]. */ - @JvmOverloads + @MustBeClosed + fun update(params: CustomerUpdateParams): CompletableFuture> = + update(params, RequestOptions.none()) + + /** @see [update] */ @MustBeClosed fun update( params: CustomerUpdateParams, @@ -214,17 +248,25 @@ interface CustomerServiceAsync { * Returns a raw HTTP response for `get /customers`, but is otherwise the same as * [CustomerServiceAsync.list]. */ - @JvmOverloads + @MustBeClosed + fun list(): CompletableFuture> = + list(CustomerListParams.none()) + + /** @see [list] */ @MustBeClosed fun list( params: CustomerListParams = CustomerListParams.none(), requestOptions: RequestOptions = RequestOptions.none(), ): CompletableFuture> - /** - * Returns a raw HTTP response for `get /customers`, but is otherwise the same as - * [CustomerServiceAsync.list]. - */ + /** @see [list] */ + @MustBeClosed + fun list( + params: CustomerListParams = CustomerListParams.none() + ): CompletableFuture> = + list(params, RequestOptions.none()) + + /** @see [list] */ @MustBeClosed fun list( requestOptions: RequestOptions @@ -235,7 +277,11 @@ interface CustomerServiceAsync { * Returns a raw HTTP response for `delete /customers/{customer_id}`, but is otherwise the * same as [CustomerServiceAsync.delete]. */ - @JvmOverloads + @MustBeClosed + fun delete(params: CustomerDeleteParams): CompletableFuture = + delete(params, RequestOptions.none()) + + /** @see [delete] */ @MustBeClosed fun delete( params: CustomerDeleteParams, @@ -246,7 +292,11 @@ interface CustomerServiceAsync { * Returns a raw HTTP response for `get /customers/{customer_id}`, but is otherwise the same * as [CustomerServiceAsync.fetch]. */ - @JvmOverloads + @MustBeClosed + fun fetch(params: CustomerFetchParams): CompletableFuture> = + fetch(params, RequestOptions.none()) + + /** @see [fetch] */ @MustBeClosed fun fetch( params: CustomerFetchParams, @@ -258,7 +308,13 @@ interface CustomerServiceAsync { * /customers/external_customer_id/{external_customer_id}`, but is otherwise the same as * [CustomerServiceAsync.fetchByExternalId]. */ - @JvmOverloads + @MustBeClosed + fun fetchByExternalId( + params: CustomerFetchByExternalIdParams + ): CompletableFuture> = + fetchByExternalId(params, RequestOptions.none()) + + /** @see [fetchByExternalId] */ @MustBeClosed fun fetchByExternalId( params: CustomerFetchByExternalIdParams, @@ -270,7 +326,13 @@ interface CustomerServiceAsync { * /customers/external_customer_id/{external_customer_id}/sync_payment_methods_from_gateway`, * but is otherwise the same as [CustomerServiceAsync.syncPaymentMethodsFromGateway]. */ - @JvmOverloads + @MustBeClosed + fun syncPaymentMethodsFromGateway( + params: CustomerSyncPaymentMethodsFromGatewayParams + ): CompletableFuture = + syncPaymentMethodsFromGateway(params, RequestOptions.none()) + + /** @see [syncPaymentMethodsFromGateway] */ @MustBeClosed fun syncPaymentMethodsFromGateway( params: CustomerSyncPaymentMethodsFromGatewayParams, @@ -282,7 +344,13 @@ interface CustomerServiceAsync { * /customers/{customer_id}/sync_payment_methods_from_gateway`, but is otherwise the same as * [CustomerServiceAsync.syncPaymentMethodsFromGatewayByExternalCustomerId]. */ - @JvmOverloads + @MustBeClosed + fun syncPaymentMethodsFromGatewayByExternalCustomerId( + params: CustomerSyncPaymentMethodsFromGatewayByExternalCustomerIdParams + ): CompletableFuture = + syncPaymentMethodsFromGatewayByExternalCustomerId(params, RequestOptions.none()) + + /** @see [syncPaymentMethodsFromGatewayByExternalCustomerId] */ @MustBeClosed fun syncPaymentMethodsFromGatewayByExternalCustomerId( params: CustomerSyncPaymentMethodsFromGatewayByExternalCustomerIdParams, @@ -294,7 +362,13 @@ interface CustomerServiceAsync { * /customers/external_customer_id/{external_customer_id}`, but is otherwise the same as * [CustomerServiceAsync.updateByExternalId]. */ - @JvmOverloads + @MustBeClosed + fun updateByExternalId( + params: CustomerUpdateByExternalIdParams + ): CompletableFuture> = + updateByExternalId(params, RequestOptions.none()) + + /** @see [updateByExternalId] */ @MustBeClosed fun updateByExternalId( params: CustomerUpdateByExternalIdParams, diff --git a/orb-java-core/src/main/kotlin/com/withorb/api/services/async/DimensionalPriceGroupServiceAsync.kt b/orb-java-core/src/main/kotlin/com/withorb/api/services/async/DimensionalPriceGroupServiceAsync.kt index 9ab07e06..d50338f5 100644 --- a/orb-java-core/src/main/kotlin/com/withorb/api/services/async/DimensionalPriceGroupServiceAsync.kt +++ b/orb-java-core/src/main/kotlin/com/withorb/api/services/async/DimensionalPriceGroupServiceAsync.kt @@ -1,7 +1,5 @@ // File generated from our OpenAPI spec by Stainless. -@file:Suppress("OVERLOADS_INTERFACE") // See https://youtrack.jetbrains.com/issue/KT-36102 - package com.withorb.api.services.async import com.google.errorprone.annotations.MustBeClosed @@ -33,27 +31,43 @@ interface DimensionalPriceGroupServiceAsync { * group with a dimension "color" and two prices: one that charges $10 per red widget and one * that charges $20 per blue widget. */ - @JvmOverloads + fun create( + params: DimensionalPriceGroupCreateParams + ): CompletableFuture = create(params, RequestOptions.none()) + + /** @see [create] */ fun create( params: DimensionalPriceGroupCreateParams, requestOptions: RequestOptions = RequestOptions.none(), ): CompletableFuture /** Fetch dimensional price group */ - @JvmOverloads + fun retrieve( + params: DimensionalPriceGroupRetrieveParams + ): CompletableFuture = retrieve(params, RequestOptions.none()) + + /** @see [retrieve] */ fun retrieve( params: DimensionalPriceGroupRetrieveParams, requestOptions: RequestOptions = RequestOptions.none(), ): CompletableFuture /** List dimensional price groups */ - @JvmOverloads + fun list(): CompletableFuture = + list(DimensionalPriceGroupListParams.none()) + + /** @see [list] */ fun list( params: DimensionalPriceGroupListParams = DimensionalPriceGroupListParams.none(), requestOptions: RequestOptions = RequestOptions.none(), ): CompletableFuture - /** List dimensional price groups */ + /** @see [list] */ + fun list( + params: DimensionalPriceGroupListParams = DimensionalPriceGroupListParams.none() + ): CompletableFuture = list(params, RequestOptions.none()) + + /** @see [list] */ fun list( requestOptions: RequestOptions ): CompletableFuture = @@ -72,7 +86,13 @@ interface DimensionalPriceGroupServiceAsync { * Returns a raw HTTP response for `post /dimensional_price_groups`, but is otherwise the * same as [DimensionalPriceGroupServiceAsync.create]. */ - @JvmOverloads + @MustBeClosed + fun create( + params: DimensionalPriceGroupCreateParams + ): CompletableFuture> = + create(params, RequestOptions.none()) + + /** @see [create] */ @MustBeClosed fun create( params: DimensionalPriceGroupCreateParams, @@ -84,7 +104,13 @@ interface DimensionalPriceGroupServiceAsync { * /dimensional_price_groups/{dimensional_price_group_id}`, but is otherwise the same as * [DimensionalPriceGroupServiceAsync.retrieve]. */ - @JvmOverloads + @MustBeClosed + fun retrieve( + params: DimensionalPriceGroupRetrieveParams + ): CompletableFuture> = + retrieve(params, RequestOptions.none()) + + /** @see [retrieve] */ @MustBeClosed fun retrieve( params: DimensionalPriceGroupRetrieveParams, @@ -95,17 +121,25 @@ interface DimensionalPriceGroupServiceAsync { * Returns a raw HTTP response for `get /dimensional_price_groups`, but is otherwise the * same as [DimensionalPriceGroupServiceAsync.list]. */ - @JvmOverloads + @MustBeClosed + fun list(): CompletableFuture> = + list(DimensionalPriceGroupListParams.none()) + + /** @see [list] */ @MustBeClosed fun list( params: DimensionalPriceGroupListParams = DimensionalPriceGroupListParams.none(), requestOptions: RequestOptions = RequestOptions.none(), ): CompletableFuture> - /** - * Returns a raw HTTP response for `get /dimensional_price_groups`, but is otherwise the - * same as [DimensionalPriceGroupServiceAsync.list]. - */ + /** @see [list] */ + @MustBeClosed + fun list( + params: DimensionalPriceGroupListParams = DimensionalPriceGroupListParams.none() + ): CompletableFuture> = + list(params, RequestOptions.none()) + + /** @see [list] */ @MustBeClosed fun list( requestOptions: RequestOptions diff --git a/orb-java-core/src/main/kotlin/com/withorb/api/services/async/EventServiceAsync.kt b/orb-java-core/src/main/kotlin/com/withorb/api/services/async/EventServiceAsync.kt index 26e89877..8d64fda3 100644 --- a/orb-java-core/src/main/kotlin/com/withorb/api/services/async/EventServiceAsync.kt +++ b/orb-java-core/src/main/kotlin/com/withorb/api/services/async/EventServiceAsync.kt @@ -1,7 +1,5 @@ // File generated from our OpenAPI spec by Stainless. -@file:Suppress("OVERLOADS_INTERFACE") // See https://youtrack.jetbrains.com/issue/KT-36102 - package com.withorb.api.services.async import com.google.errorprone.annotations.MustBeClosed @@ -71,7 +69,10 @@ interface EventServiceAsync { * period. For higher volume updates, consider using the [event backfill](create-backfill) * endpoint. */ - @JvmOverloads + fun update(params: EventUpdateParams): CompletableFuture = + update(params, RequestOptions.none()) + + /** @see [update] */ fun update( params: EventUpdateParams, requestOptions: RequestOptions = RequestOptions.none(), @@ -113,7 +114,10 @@ interface EventServiceAsync { * period. For higher volume updates, consider using the [event backfill](create-backfill) * endpoint. */ - @JvmOverloads + fun deprecate(params: EventDeprecateParams): CompletableFuture = + deprecate(params, RequestOptions.none()) + + /** @see [deprecate] */ fun deprecate( params: EventDeprecateParams, requestOptions: RequestOptions = RequestOptions.none(), @@ -310,7 +314,10 @@ interface EventServiceAsync { * } * ``` */ - @JvmOverloads + fun ingest(params: EventIngestParams): CompletableFuture = + ingest(params, RequestOptions.none()) + + /** @see [ingest] */ fun ingest( params: EventIngestParams, requestOptions: RequestOptions = RequestOptions.none(), @@ -332,7 +339,10 @@ interface EventServiceAsync { * By default, Orb will not throw a `404` if no events matched, Orb will return an empty array * for `data` instead. */ - @JvmOverloads + fun search(params: EventSearchParams): CompletableFuture = + search(params, RequestOptions.none()) + + /** @see [search] */ fun search( params: EventSearchParams, requestOptions: RequestOptions = RequestOptions.none(), @@ -349,7 +359,13 @@ interface EventServiceAsync { * Returns a raw HTTP response for `put /events/{event_id}`, but is otherwise the same as * [EventServiceAsync.update]. */ - @JvmOverloads + @MustBeClosed + fun update( + params: EventUpdateParams + ): CompletableFuture> = + update(params, RequestOptions.none()) + + /** @see [update] */ @MustBeClosed fun update( params: EventUpdateParams, @@ -360,7 +376,13 @@ interface EventServiceAsync { * Returns a raw HTTP response for `put /events/{event_id}/deprecate`, but is otherwise the * same as [EventServiceAsync.deprecate]. */ - @JvmOverloads + @MustBeClosed + fun deprecate( + params: EventDeprecateParams + ): CompletableFuture> = + deprecate(params, RequestOptions.none()) + + /** @see [deprecate] */ @MustBeClosed fun deprecate( params: EventDeprecateParams, @@ -371,7 +393,13 @@ interface EventServiceAsync { * Returns a raw HTTP response for `post /ingest`, but is otherwise the same as * [EventServiceAsync.ingest]. */ - @JvmOverloads + @MustBeClosed + fun ingest( + params: EventIngestParams + ): CompletableFuture> = + ingest(params, RequestOptions.none()) + + /** @see [ingest] */ @MustBeClosed fun ingest( params: EventIngestParams, @@ -382,7 +410,13 @@ interface EventServiceAsync { * Returns a raw HTTP response for `post /events/search`, but is otherwise the same as * [EventServiceAsync.search]. */ - @JvmOverloads + @MustBeClosed + fun search( + params: EventSearchParams + ): CompletableFuture> = + search(params, RequestOptions.none()) + + /** @see [search] */ @MustBeClosed fun search( params: EventSearchParams, diff --git a/orb-java-core/src/main/kotlin/com/withorb/api/services/async/InvoiceLineItemServiceAsync.kt b/orb-java-core/src/main/kotlin/com/withorb/api/services/async/InvoiceLineItemServiceAsync.kt index 103cc5ce..9a14d344 100644 --- a/orb-java-core/src/main/kotlin/com/withorb/api/services/async/InvoiceLineItemServiceAsync.kt +++ b/orb-java-core/src/main/kotlin/com/withorb/api/services/async/InvoiceLineItemServiceAsync.kt @@ -1,7 +1,5 @@ // File generated from our OpenAPI spec by Stainless. -@file:Suppress("OVERLOADS_INTERFACE") // See https://youtrack.jetbrains.com/issue/KT-36102 - package com.withorb.api.services.async import com.google.errorprone.annotations.MustBeClosed @@ -22,7 +20,11 @@ interface InvoiceLineItemServiceAsync { * This creates a one-off fixed fee invoice line item on an Invoice. This can only be done for * invoices that are in a `draft` status. */ - @JvmOverloads + fun create( + params: InvoiceLineItemCreateParams + ): CompletableFuture = create(params, RequestOptions.none()) + + /** @see [create] */ fun create( params: InvoiceLineItemCreateParams, requestOptions: RequestOptions = RequestOptions.none(), @@ -38,7 +40,13 @@ interface InvoiceLineItemServiceAsync { * Returns a raw HTTP response for `post /invoice_line_items`, but is otherwise the same as * [InvoiceLineItemServiceAsync.create]. */ - @JvmOverloads + @MustBeClosed + fun create( + params: InvoiceLineItemCreateParams + ): CompletableFuture> = + create(params, RequestOptions.none()) + + /** @see [create] */ @MustBeClosed fun create( params: InvoiceLineItemCreateParams, diff --git a/orb-java-core/src/main/kotlin/com/withorb/api/services/async/InvoiceServiceAsync.kt b/orb-java-core/src/main/kotlin/com/withorb/api/services/async/InvoiceServiceAsync.kt index 3193efcf..46eeeaa5 100644 --- a/orb-java-core/src/main/kotlin/com/withorb/api/services/async/InvoiceServiceAsync.kt +++ b/orb-java-core/src/main/kotlin/com/withorb/api/services/async/InvoiceServiceAsync.kt @@ -1,7 +1,5 @@ // File generated from our OpenAPI spec by Stainless. -@file:Suppress("OVERLOADS_INTERFACE") // See https://youtrack.jetbrains.com/issue/KT-36102 - package com.withorb.api.services.async import com.google.errorprone.annotations.MustBeClosed @@ -29,7 +27,10 @@ interface InvoiceServiceAsync { fun withRawResponse(): WithRawResponse /** This endpoint is used to create a one-off invoice for a customer. */ - @JvmOverloads + fun create(params: InvoiceCreateParams): CompletableFuture = + create(params, RequestOptions.none()) + + /** @see [create] */ fun create( params: InvoiceCreateParams, requestOptions: RequestOptions = RequestOptions.none(), @@ -41,7 +42,10 @@ interface InvoiceServiceAsync { * * `metadata` can be modified regardless of invoice state. */ - @JvmOverloads + fun update(params: InvoiceUpdateParams): CompletableFuture = + update(params, RequestOptions.none()) + + /** @see [update] */ fun update( params: InvoiceUpdateParams, requestOptions: RequestOptions = RequestOptions.none(), @@ -61,33 +65,30 @@ interface InvoiceServiceAsync { * draft invoice, which may not always be up-to-date since Orb regularly refreshes invoices * asynchronously. */ - @JvmOverloads + fun list(): CompletableFuture = list(InvoiceListParams.none()) + + /** @see [list] */ fun list( params: InvoiceListParams = InvoiceListParams.none(), requestOptions: RequestOptions = RequestOptions.none(), ): CompletableFuture - /** - * This endpoint returns a list of all [`Invoice`](/core-concepts#invoice)s for an account in a - * list format. - * - * The list of invoices is ordered starting from the most recently issued invoice date. The - * response also includes [`pagination_metadata`](/api-reference/pagination), which lets the - * caller retrieve the next page of results if they exist. - * - * By default, this only returns invoices that are `issued`, `paid`, or `synced`. - * - * When fetching any `draft` invoices, this returns the last-computed invoice values for each - * draft invoice, which may not always be up-to-date since Orb regularly refreshes invoices - * asynchronously. - */ + /** @see [list] */ + fun list( + params: InvoiceListParams = InvoiceListParams.none() + ): CompletableFuture = list(params, RequestOptions.none()) + + /** @see [list] */ fun list(requestOptions: RequestOptions): CompletableFuture = list(InvoiceListParams.none(), requestOptions) /** * This endpoint is used to fetch an [`Invoice`](/core-concepts#invoice) given an identifier. */ - @JvmOverloads + fun fetch(params: InvoiceFetchParams): CompletableFuture = + fetch(params, RequestOptions.none()) + + /** @see [fetch] */ fun fetch( params: InvoiceFetchParams, requestOptions: RequestOptions = RequestOptions.none(), @@ -97,7 +98,12 @@ interface InvoiceServiceAsync { * This endpoint can be used to fetch the upcoming [invoice](/core-concepts#invoice) for the * current billing period given a subscription. */ - @JvmOverloads + fun fetchUpcoming( + params: InvoiceFetchUpcomingParams + ): CompletableFuture = + fetchUpcoming(params, RequestOptions.none()) + + /** @see [fetchUpcoming] */ fun fetchUpcoming( params: InvoiceFetchUpcomingParams, requestOptions: RequestOptions = RequestOptions.none(), @@ -110,7 +116,10 @@ interface InvoiceServiceAsync { * could be customer-visible (e.g. sending emails, auto-collecting payment, syncing the invoice * to external providers, etc). */ - @JvmOverloads + fun issue(params: InvoiceIssueParams): CompletableFuture = + issue(params, RequestOptions.none()) + + /** @see [issue] */ fun issue( params: InvoiceIssueParams, requestOptions: RequestOptions = RequestOptions.none(), @@ -120,7 +129,10 @@ interface InvoiceServiceAsync { * This endpoint allows an invoice's status to be set the `paid` status. This can only be done * to invoices that are in the `issued` status. */ - @JvmOverloads + fun markPaid(params: InvoiceMarkPaidParams): CompletableFuture = + markPaid(params, RequestOptions.none()) + + /** @see [markPaid] */ fun markPaid( params: InvoiceMarkPaidParams, requestOptions: RequestOptions = RequestOptions.none(), @@ -130,7 +142,10 @@ interface InvoiceServiceAsync { * This endpoint collects payment for an invoice using the customer's default payment method. * This action can only be taken on invoices with status "issued". */ - @JvmOverloads + fun pay(params: InvoicePayParams): CompletableFuture = + pay(params, RequestOptions.none()) + + /** @see [pay] */ fun pay( params: InvoicePayParams, requestOptions: RequestOptions = RequestOptions.none(), @@ -148,7 +163,10 @@ interface InvoiceServiceAsync { * credit block will be voided. If the invoice was created due to a top-up, the top-up will be * disabled. */ - @JvmOverloads + fun voidInvoice(params: InvoiceVoidInvoiceParams): CompletableFuture = + voidInvoice(params, RequestOptions.none()) + + /** @see [voidInvoice] */ fun voidInvoice( params: InvoiceVoidInvoiceParams, requestOptions: RequestOptions = RequestOptions.none(), @@ -163,7 +181,11 @@ interface InvoiceServiceAsync { * Returns a raw HTTP response for `post /invoices`, but is otherwise the same as * [InvoiceServiceAsync.create]. */ - @JvmOverloads + @MustBeClosed + fun create(params: InvoiceCreateParams): CompletableFuture> = + create(params, RequestOptions.none()) + + /** @see [create] */ @MustBeClosed fun create( params: InvoiceCreateParams, @@ -174,7 +196,11 @@ interface InvoiceServiceAsync { * Returns a raw HTTP response for `put /invoices/{invoice_id}`, but is otherwise the same * as [InvoiceServiceAsync.update]. */ - @JvmOverloads + @MustBeClosed + fun update(params: InvoiceUpdateParams): CompletableFuture> = + update(params, RequestOptions.none()) + + /** @see [update] */ @MustBeClosed fun update( params: InvoiceUpdateParams, @@ -185,17 +211,25 @@ interface InvoiceServiceAsync { * Returns a raw HTTP response for `get /invoices`, but is otherwise the same as * [InvoiceServiceAsync.list]. */ - @JvmOverloads + @MustBeClosed + fun list(): CompletableFuture> = + list(InvoiceListParams.none()) + + /** @see [list] */ @MustBeClosed fun list( params: InvoiceListParams = InvoiceListParams.none(), requestOptions: RequestOptions = RequestOptions.none(), ): CompletableFuture> - /** - * Returns a raw HTTP response for `get /invoices`, but is otherwise the same as - * [InvoiceServiceAsync.list]. - */ + /** @see [list] */ + @MustBeClosed + fun list( + params: InvoiceListParams = InvoiceListParams.none() + ): CompletableFuture> = + list(params, RequestOptions.none()) + + /** @see [list] */ @MustBeClosed fun list( requestOptions: RequestOptions @@ -206,7 +240,11 @@ interface InvoiceServiceAsync { * Returns a raw HTTP response for `get /invoices/{invoice_id}`, but is otherwise the same * as [InvoiceServiceAsync.fetch]. */ - @JvmOverloads + @MustBeClosed + fun fetch(params: InvoiceFetchParams): CompletableFuture> = + fetch(params, RequestOptions.none()) + + /** @see [fetch] */ @MustBeClosed fun fetch( params: InvoiceFetchParams, @@ -217,7 +255,13 @@ interface InvoiceServiceAsync { * Returns a raw HTTP response for `get /invoices/upcoming`, but is otherwise the same as * [InvoiceServiceAsync.fetchUpcoming]. */ - @JvmOverloads + @MustBeClosed + fun fetchUpcoming( + params: InvoiceFetchUpcomingParams + ): CompletableFuture> = + fetchUpcoming(params, RequestOptions.none()) + + /** @see [fetchUpcoming] */ @MustBeClosed fun fetchUpcoming( params: InvoiceFetchUpcomingParams, @@ -228,7 +272,11 @@ interface InvoiceServiceAsync { * Returns a raw HTTP response for `post /invoices/{invoice_id}/issue`, but is otherwise the * same as [InvoiceServiceAsync.issue]. */ - @JvmOverloads + @MustBeClosed + fun issue(params: InvoiceIssueParams): CompletableFuture> = + issue(params, RequestOptions.none()) + + /** @see [issue] */ @MustBeClosed fun issue( params: InvoiceIssueParams, @@ -239,7 +287,11 @@ interface InvoiceServiceAsync { * Returns a raw HTTP response for `post /invoices/{invoice_id}/mark_paid`, but is otherwise * the same as [InvoiceServiceAsync.markPaid]. */ - @JvmOverloads + @MustBeClosed + fun markPaid(params: InvoiceMarkPaidParams): CompletableFuture> = + markPaid(params, RequestOptions.none()) + + /** @see [markPaid] */ @MustBeClosed fun markPaid( params: InvoiceMarkPaidParams, @@ -250,7 +302,11 @@ interface InvoiceServiceAsync { * Returns a raw HTTP response for `post /invoices/{invoice_id}/pay`, but is otherwise the * same as [InvoiceServiceAsync.pay]. */ - @JvmOverloads + @MustBeClosed + fun pay(params: InvoicePayParams): CompletableFuture> = + pay(params, RequestOptions.none()) + + /** @see [pay] */ @MustBeClosed fun pay( params: InvoicePayParams, @@ -261,7 +317,12 @@ interface InvoiceServiceAsync { * Returns a raw HTTP response for `post /invoices/{invoice_id}/void`, but is otherwise the * same as [InvoiceServiceAsync.voidInvoice]. */ - @JvmOverloads + @MustBeClosed + fun voidInvoice( + params: InvoiceVoidInvoiceParams + ): CompletableFuture> = voidInvoice(params, RequestOptions.none()) + + /** @see [voidInvoice] */ @MustBeClosed fun voidInvoice( params: InvoiceVoidInvoiceParams, diff --git a/orb-java-core/src/main/kotlin/com/withorb/api/services/async/ItemServiceAsync.kt b/orb-java-core/src/main/kotlin/com/withorb/api/services/async/ItemServiceAsync.kt index fb3b5075..2cb003e2 100644 --- a/orb-java-core/src/main/kotlin/com/withorb/api/services/async/ItemServiceAsync.kt +++ b/orb-java-core/src/main/kotlin/com/withorb/api/services/async/ItemServiceAsync.kt @@ -1,7 +1,5 @@ // File generated from our OpenAPI spec by Stainless. -@file:Suppress("OVERLOADS_INTERFACE") // See https://youtrack.jetbrains.com/issue/KT-36102 - package com.withorb.api.services.async import com.google.errorprone.annotations.MustBeClosed @@ -23,32 +21,47 @@ interface ItemServiceAsync { fun withRawResponse(): WithRawResponse /** This endpoint is used to create an [Item](/core-concepts#item). */ - @JvmOverloads + fun create(params: ItemCreateParams): CompletableFuture = + create(params, RequestOptions.none()) + + /** @see [create] */ fun create( params: ItemCreateParams, requestOptions: RequestOptions = RequestOptions.none(), ): CompletableFuture /** This endpoint can be used to update properties on the Item. */ - @JvmOverloads + fun update(params: ItemUpdateParams): CompletableFuture = + update(params, RequestOptions.none()) + + /** @see [update] */ fun update( params: ItemUpdateParams, requestOptions: RequestOptions = RequestOptions.none(), ): CompletableFuture /** This endpoint returns a list of all Items, ordered in descending order by creation time. */ - @JvmOverloads + fun list(): CompletableFuture = list(ItemListParams.none()) + + /** @see [list] */ fun list( params: ItemListParams = ItemListParams.none(), requestOptions: RequestOptions = RequestOptions.none(), ): CompletableFuture - /** This endpoint returns a list of all Items, ordered in descending order by creation time. */ + /** @see [list] */ + fun list(params: ItemListParams = ItemListParams.none()): CompletableFuture = + list(params, RequestOptions.none()) + + /** @see [list] */ fun list(requestOptions: RequestOptions): CompletableFuture = list(ItemListParams.none(), requestOptions) /** This endpoint returns an item identified by its item_id. */ - @JvmOverloads + fun fetch(params: ItemFetchParams): CompletableFuture = + fetch(params, RequestOptions.none()) + + /** @see [fetch] */ fun fetch( params: ItemFetchParams, requestOptions: RequestOptions = RequestOptions.none(), @@ -61,7 +74,11 @@ interface ItemServiceAsync { * Returns a raw HTTP response for `post /items`, but is otherwise the same as * [ItemServiceAsync.create]. */ - @JvmOverloads + @MustBeClosed + fun create(params: ItemCreateParams): CompletableFuture> = + create(params, RequestOptions.none()) + + /** @see [create] */ @MustBeClosed fun create( params: ItemCreateParams, @@ -72,7 +89,11 @@ interface ItemServiceAsync { * Returns a raw HTTP response for `put /items/{item_id}`, but is otherwise the same as * [ItemServiceAsync.update]. */ - @JvmOverloads + @MustBeClosed + fun update(params: ItemUpdateParams): CompletableFuture> = + update(params, RequestOptions.none()) + + /** @see [update] */ @MustBeClosed fun update( params: ItemUpdateParams, @@ -83,17 +104,25 @@ interface ItemServiceAsync { * Returns a raw HTTP response for `get /items`, but is otherwise the same as * [ItemServiceAsync.list]. */ - @JvmOverloads + @MustBeClosed + fun list(): CompletableFuture> = + list(ItemListParams.none()) + + /** @see [list] */ @MustBeClosed fun list( params: ItemListParams = ItemListParams.none(), requestOptions: RequestOptions = RequestOptions.none(), ): CompletableFuture> - /** - * Returns a raw HTTP response for `get /items`, but is otherwise the same as - * [ItemServiceAsync.list]. - */ + /** @see [list] */ + @MustBeClosed + fun list( + params: ItemListParams = ItemListParams.none() + ): CompletableFuture> = + list(params, RequestOptions.none()) + + /** @see [list] */ @MustBeClosed fun list( requestOptions: RequestOptions @@ -104,7 +133,11 @@ interface ItemServiceAsync { * Returns a raw HTTP response for `get /items/{item_id}`, but is otherwise the same as * [ItemServiceAsync.fetch]. */ - @JvmOverloads + @MustBeClosed + fun fetch(params: ItemFetchParams): CompletableFuture> = + fetch(params, RequestOptions.none()) + + /** @see [fetch] */ @MustBeClosed fun fetch( params: ItemFetchParams, diff --git a/orb-java-core/src/main/kotlin/com/withorb/api/services/async/MetricServiceAsync.kt b/orb-java-core/src/main/kotlin/com/withorb/api/services/async/MetricServiceAsync.kt index 2668fe5c..554e58ce 100644 --- a/orb-java-core/src/main/kotlin/com/withorb/api/services/async/MetricServiceAsync.kt +++ b/orb-java-core/src/main/kotlin/com/withorb/api/services/async/MetricServiceAsync.kt @@ -1,7 +1,5 @@ // File generated from our OpenAPI spec by Stainless. -@file:Suppress("OVERLOADS_INTERFACE") // See https://youtrack.jetbrains.com/issue/KT-36102 - package com.withorb.api.services.async import com.google.errorprone.annotations.MustBeClosed @@ -27,7 +25,10 @@ interface MetricServiceAsync { * [SQL support](/extensibility/advanced-metrics#sql-support) for a description of constructing * SQL queries with examples. */ - @JvmOverloads + fun create(params: MetricCreateParams): CompletableFuture = + create(params, RequestOptions.none()) + + /** @see [create] */ fun create( params: MetricCreateParams, requestOptions: RequestOptions = RequestOptions.none(), @@ -37,7 +38,10 @@ interface MetricServiceAsync { * This endpoint allows you to update the `metadata` property on a metric. If you pass `null` * for the metadata value, it will clear any existing metadata for that invoice. */ - @JvmOverloads + fun update(params: MetricUpdateParams): CompletableFuture = + update(params, RequestOptions.none()) + + /** @see [update] */ fun update( params: MetricUpdateParams, requestOptions: RequestOptions = RequestOptions.none(), @@ -48,17 +52,20 @@ interface MetricServiceAsync { * identifier. It returns information about the metrics including its name, description, and * item. */ - @JvmOverloads + fun list(): CompletableFuture = list(MetricListParams.none()) + + /** @see [list] */ fun list( params: MetricListParams = MetricListParams.none(), requestOptions: RequestOptions = RequestOptions.none(), ): CompletableFuture - /** - * This endpoint is used to fetch [metric](/core-concepts##metric) details given a metric - * identifier. It returns information about the metrics including its name, description, and - * item. - */ + /** @see [list] */ + fun list( + params: MetricListParams = MetricListParams.none() + ): CompletableFuture = list(params, RequestOptions.none()) + + /** @see [list] */ fun list(requestOptions: RequestOptions): CompletableFuture = list(MetricListParams.none(), requestOptions) @@ -66,7 +73,10 @@ interface MetricServiceAsync { * This endpoint is used to list [metrics](/core-concepts#metric). It returns information about * the metrics including its name, description, and item. */ - @JvmOverloads + fun fetch(params: MetricFetchParams): CompletableFuture = + fetch(params, RequestOptions.none()) + + /** @see [fetch] */ fun fetch( params: MetricFetchParams, requestOptions: RequestOptions = RequestOptions.none(), @@ -81,7 +91,11 @@ interface MetricServiceAsync { * Returns a raw HTTP response for `post /metrics`, but is otherwise the same as * [MetricServiceAsync.create]. */ - @JvmOverloads + @MustBeClosed + fun create(params: MetricCreateParams): CompletableFuture> = + create(params, RequestOptions.none()) + + /** @see [create] */ @MustBeClosed fun create( params: MetricCreateParams, @@ -92,7 +106,11 @@ interface MetricServiceAsync { * Returns a raw HTTP response for `put /metrics/{metric_id}`, but is otherwise the same as * [MetricServiceAsync.update]. */ - @JvmOverloads + @MustBeClosed + fun update(params: MetricUpdateParams): CompletableFuture> = + update(params, RequestOptions.none()) + + /** @see [update] */ @MustBeClosed fun update( params: MetricUpdateParams, @@ -103,17 +121,25 @@ interface MetricServiceAsync { * Returns a raw HTTP response for `get /metrics`, but is otherwise the same as * [MetricServiceAsync.list]. */ - @JvmOverloads + @MustBeClosed + fun list(): CompletableFuture> = + list(MetricListParams.none()) + + /** @see [list] */ @MustBeClosed fun list( params: MetricListParams = MetricListParams.none(), requestOptions: RequestOptions = RequestOptions.none(), ): CompletableFuture> - /** - * Returns a raw HTTP response for `get /metrics`, but is otherwise the same as - * [MetricServiceAsync.list]. - */ + /** @see [list] */ + @MustBeClosed + fun list( + params: MetricListParams = MetricListParams.none() + ): CompletableFuture> = + list(params, RequestOptions.none()) + + /** @see [list] */ @MustBeClosed fun list( requestOptions: RequestOptions @@ -124,7 +150,11 @@ interface MetricServiceAsync { * Returns a raw HTTP response for `get /metrics/{metric_id}`, but is otherwise the same as * [MetricServiceAsync.fetch]. */ - @JvmOverloads + @MustBeClosed + fun fetch(params: MetricFetchParams): CompletableFuture> = + fetch(params, RequestOptions.none()) + + /** @see [fetch] */ @MustBeClosed fun fetch( params: MetricFetchParams, diff --git a/orb-java-core/src/main/kotlin/com/withorb/api/services/async/PlanServiceAsync.kt b/orb-java-core/src/main/kotlin/com/withorb/api/services/async/PlanServiceAsync.kt index 7c238c0a..28590f41 100644 --- a/orb-java-core/src/main/kotlin/com/withorb/api/services/async/PlanServiceAsync.kt +++ b/orb-java-core/src/main/kotlin/com/withorb/api/services/async/PlanServiceAsync.kt @@ -1,7 +1,5 @@ // File generated from our OpenAPI spec by Stainless. -@file:Suppress("OVERLOADS_INTERFACE") // See https://youtrack.jetbrains.com/issue/KT-36102 - package com.withorb.api.services.async import com.google.errorprone.annotations.MustBeClosed @@ -26,7 +24,10 @@ interface PlanServiceAsync { fun externalPlanId(): ExternalPlanIdServiceAsync /** This endpoint allows creation of plans including their prices. */ - @JvmOverloads + fun create(params: PlanCreateParams): CompletableFuture = + create(params, RequestOptions.none()) + + /** @see [create] */ fun create( params: PlanCreateParams, requestOptions: RequestOptions = RequestOptions.none(), @@ -38,7 +39,10 @@ interface PlanServiceAsync { * * Other fields on a customer are currently immutable. */ - @JvmOverloads + fun update(params: PlanUpdateParams): CompletableFuture = + update(params, RequestOptions.none()) + + /** @see [update] */ fun update( params: PlanUpdateParams, requestOptions: RequestOptions = RequestOptions.none(), @@ -50,18 +54,19 @@ interface PlanServiceAsync { * response also includes [`pagination_metadata`](/api-reference/pagination), which lets the * caller retrieve the next page of results if they exist. */ - @JvmOverloads + fun list(): CompletableFuture = list(PlanListParams.none()) + + /** @see [list] */ fun list( params: PlanListParams = PlanListParams.none(), requestOptions: RequestOptions = RequestOptions.none(), ): CompletableFuture - /** - * This endpoint returns a list of all [plans](/core-concepts#plan-and-price) for an account in - * a list format. The list of plans is ordered starting from the most recently created plan. The - * response also includes [`pagination_metadata`](/api-reference/pagination), which lets the - * caller retrieve the next page of results if they exist. - */ + /** @see [list] */ + fun list(params: PlanListParams = PlanListParams.none()): CompletableFuture = + list(params, RequestOptions.none()) + + /** @see [list] */ fun list(requestOptions: RequestOptions): CompletableFuture = list(PlanListParams.none(), requestOptions) @@ -83,7 +88,10 @@ interface PlanServiceAsync { * Orb supports plan phases, also known as contract ramps. For plans with phases, the serialized * prices refer to all prices across all phases. */ - @JvmOverloads + fun fetch(params: PlanFetchParams): CompletableFuture = + fetch(params, RequestOptions.none()) + + /** @see [fetch] */ fun fetch( params: PlanFetchParams, requestOptions: RequestOptions = RequestOptions.none(), @@ -98,7 +106,11 @@ interface PlanServiceAsync { * Returns a raw HTTP response for `post /plans`, but is otherwise the same as * [PlanServiceAsync.create]. */ - @JvmOverloads + @MustBeClosed + fun create(params: PlanCreateParams): CompletableFuture> = + create(params, RequestOptions.none()) + + /** @see [create] */ @MustBeClosed fun create( params: PlanCreateParams, @@ -109,7 +121,11 @@ interface PlanServiceAsync { * Returns a raw HTTP response for `put /plans/{plan_id}`, but is otherwise the same as * [PlanServiceAsync.update]. */ - @JvmOverloads + @MustBeClosed + fun update(params: PlanUpdateParams): CompletableFuture> = + update(params, RequestOptions.none()) + + /** @see [update] */ @MustBeClosed fun update( params: PlanUpdateParams, @@ -120,17 +136,25 @@ interface PlanServiceAsync { * Returns a raw HTTP response for `get /plans`, but is otherwise the same as * [PlanServiceAsync.list]. */ - @JvmOverloads + @MustBeClosed + fun list(): CompletableFuture> = + list(PlanListParams.none()) + + /** @see [list] */ @MustBeClosed fun list( params: PlanListParams = PlanListParams.none(), requestOptions: RequestOptions = RequestOptions.none(), ): CompletableFuture> - /** - * Returns a raw HTTP response for `get /plans`, but is otherwise the same as - * [PlanServiceAsync.list]. - */ + /** @see [list] */ + @MustBeClosed + fun list( + params: PlanListParams = PlanListParams.none() + ): CompletableFuture> = + list(params, RequestOptions.none()) + + /** @see [list] */ @MustBeClosed fun list( requestOptions: RequestOptions @@ -141,7 +165,11 @@ interface PlanServiceAsync { * Returns a raw HTTP response for `get /plans/{plan_id}`, but is otherwise the same as * [PlanServiceAsync.fetch]. */ - @JvmOverloads + @MustBeClosed + fun fetch(params: PlanFetchParams): CompletableFuture> = + fetch(params, RequestOptions.none()) + + /** @see [fetch] */ @MustBeClosed fun fetch( params: PlanFetchParams, diff --git a/orb-java-core/src/main/kotlin/com/withorb/api/services/async/PriceServiceAsync.kt b/orb-java-core/src/main/kotlin/com/withorb/api/services/async/PriceServiceAsync.kt index ab40d8b9..ae0f5ebb 100644 --- a/orb-java-core/src/main/kotlin/com/withorb/api/services/async/PriceServiceAsync.kt +++ b/orb-java-core/src/main/kotlin/com/withorb/api/services/async/PriceServiceAsync.kt @@ -1,7 +1,5 @@ // File generated from our OpenAPI spec by Stainless. -@file:Suppress("OVERLOADS_INTERFACE") // See https://youtrack.jetbrains.com/issue/KT-36102 - package com.withorb.api.services.async import com.google.errorprone.annotations.MustBeClosed @@ -39,7 +37,10 @@ interface PriceServiceAsync { * See the [Price resource](/product-catalog/price-configuration) for the specification of * different price model configurations possible in this endpoint. */ - @JvmOverloads + fun create(params: PriceCreateParams): CompletableFuture = + create(params, RequestOptions.none()) + + /** @see [create] */ fun create( params: PriceCreateParams, requestOptions: RequestOptions = RequestOptions.none(), @@ -49,7 +50,10 @@ interface PriceServiceAsync { * This endpoint allows you to update the `metadata` property on a price. If you pass null for * the metadata value, it will clear any existing metadata for that price. */ - @JvmOverloads + fun update(params: PriceUpdateParams): CompletableFuture = + update(params, RequestOptions.none()) + + /** @see [update] */ fun update( params: PriceUpdateParams, requestOptions: RequestOptions = RequestOptions.none(), @@ -59,16 +63,20 @@ interface PriceServiceAsync { * This endpoint is used to list all add-on prices created using the * [price creation endpoint](/api-reference/price/create-price). */ - @JvmOverloads + fun list(): CompletableFuture = list(PriceListParams.none()) + + /** @see [list] */ fun list( params: PriceListParams = PriceListParams.none(), requestOptions: RequestOptions = RequestOptions.none(), ): CompletableFuture - /** - * This endpoint is used to list all add-on prices created using the - * [price creation endpoint](/api-reference/price/create-price). - */ + /** @see [list] */ + fun list( + params: PriceListParams = PriceListParams.none() + ): CompletableFuture = list(params, RequestOptions.none()) + + /** @see [list] */ fun list(requestOptions: RequestOptions): CompletableFuture = list(PriceListParams.none(), requestOptions) @@ -91,14 +99,20 @@ interface PriceServiceAsync { * the results must be no greater than 1000. Note that this is a POST endpoint rather than a GET * endpoint because it employs a JSON body rather than query parameters. */ - @JvmOverloads + fun evaluate(params: PriceEvaluateParams): CompletableFuture = + evaluate(params, RequestOptions.none()) + + /** @see [evaluate] */ fun evaluate( params: PriceEvaluateParams, requestOptions: RequestOptions = RequestOptions.none(), ): CompletableFuture /** This endpoint returns a price given an identifier. */ - @JvmOverloads + fun fetch(params: PriceFetchParams): CompletableFuture = + fetch(params, RequestOptions.none()) + + /** @see [fetch] */ fun fetch( params: PriceFetchParams, requestOptions: RequestOptions = RequestOptions.none(), @@ -113,7 +127,11 @@ interface PriceServiceAsync { * Returns a raw HTTP response for `post /prices`, but is otherwise the same as * [PriceServiceAsync.create]. */ - @JvmOverloads + @MustBeClosed + fun create(params: PriceCreateParams): CompletableFuture> = + create(params, RequestOptions.none()) + + /** @see [create] */ @MustBeClosed fun create( params: PriceCreateParams, @@ -124,7 +142,11 @@ interface PriceServiceAsync { * Returns a raw HTTP response for `put /prices/{price_id}`, but is otherwise the same as * [PriceServiceAsync.update]. */ - @JvmOverloads + @MustBeClosed + fun update(params: PriceUpdateParams): CompletableFuture> = + update(params, RequestOptions.none()) + + /** @see [update] */ @MustBeClosed fun update( params: PriceUpdateParams, @@ -135,17 +157,25 @@ interface PriceServiceAsync { * Returns a raw HTTP response for `get /prices`, but is otherwise the same as * [PriceServiceAsync.list]. */ - @JvmOverloads + @MustBeClosed + fun list(): CompletableFuture> = + list(PriceListParams.none()) + + /** @see [list] */ @MustBeClosed fun list( params: PriceListParams = PriceListParams.none(), requestOptions: RequestOptions = RequestOptions.none(), ): CompletableFuture> - /** - * Returns a raw HTTP response for `get /prices`, but is otherwise the same as - * [PriceServiceAsync.list]. - */ + /** @see [list] */ + @MustBeClosed + fun list( + params: PriceListParams = PriceListParams.none() + ): CompletableFuture> = + list(params, RequestOptions.none()) + + /** @see [list] */ @MustBeClosed fun list( requestOptions: RequestOptions @@ -156,7 +186,13 @@ interface PriceServiceAsync { * Returns a raw HTTP response for `post /prices/{price_id}/evaluate`, but is otherwise the * same as [PriceServiceAsync.evaluate]. */ - @JvmOverloads + @MustBeClosed + fun evaluate( + params: PriceEvaluateParams + ): CompletableFuture> = + evaluate(params, RequestOptions.none()) + + /** @see [evaluate] */ @MustBeClosed fun evaluate( params: PriceEvaluateParams, @@ -167,7 +203,11 @@ interface PriceServiceAsync { * Returns a raw HTTP response for `get /prices/{price_id}`, but is otherwise the same as * [PriceServiceAsync.fetch]. */ - @JvmOverloads + @MustBeClosed + fun fetch(params: PriceFetchParams): CompletableFuture> = + fetch(params, RequestOptions.none()) + + /** @see [fetch] */ @MustBeClosed fun fetch( params: PriceFetchParams, diff --git a/orb-java-core/src/main/kotlin/com/withorb/api/services/async/SubscriptionServiceAsync.kt b/orb-java-core/src/main/kotlin/com/withorb/api/services/async/SubscriptionServiceAsync.kt index 1412610c..8796f2ad 100644 --- a/orb-java-core/src/main/kotlin/com/withorb/api/services/async/SubscriptionServiceAsync.kt +++ b/orb-java-core/src/main/kotlin/com/withorb/api/services/async/SubscriptionServiceAsync.kt @@ -1,7 +1,5 @@ // File generated from our OpenAPI spec by Stainless. -@file:Suppress("OVERLOADS_INTERFACE") // See https://youtrack.jetbrains.com/issue/KT-36102 - package com.withorb.api.services.async import com.google.errorprone.annotations.MustBeClosed @@ -285,7 +283,10 @@ interface SubscriptionServiceAsync { * subscription's invoicing currency, when creating a subscription. E.g. pass in `10.00` to * issue an invoice when usage amounts hit $10.00 for a subscription that invoices in USD. */ - @JvmOverloads + fun create(params: SubscriptionCreateParams): CompletableFuture = + create(params, RequestOptions.none()) + + /** @see [create] */ fun create( params: SubscriptionCreateParams, requestOptions: RequestOptions = RequestOptions.none(), @@ -295,7 +296,10 @@ interface SubscriptionServiceAsync { * This endpoint can be used to update the `metadata`, `net terms`, `auto_collection`, * `invoicing_threshold`, and `default_invoice_memo` properties on a subscription. */ - @JvmOverloads + fun update(params: SubscriptionUpdateParams): CompletableFuture = + update(params, RequestOptions.none()) + + /** @see [update] */ fun update( params: SubscriptionUpdateParams, requestOptions: RequestOptions = RequestOptions.none(), @@ -311,22 +315,20 @@ interface SubscriptionServiceAsync { * external_customer_id query parameters. To filter subscriptions for multiple customers, use * the customer_id[] or external_customer_id[] query parameters. */ - @JvmOverloads + fun list(): CompletableFuture = list(SubscriptionListParams.none()) + + /** @see [list] */ fun list( params: SubscriptionListParams = SubscriptionListParams.none(), requestOptions: RequestOptions = RequestOptions.none(), ): CompletableFuture - /** - * This endpoint returns a list of all subscriptions for an account as a - * [paginated](/api-reference/pagination) list, ordered starting from the most recently created - * subscription. For a full discussion of the subscription resource, see - * [Subscription](/core-concepts##subscription). - * - * Subscriptions can be filtered for a specific customer by using either the customer_id or - * external_customer_id query parameters. To filter subscriptions for multiple customers, use - * the customer_id[] or external_customer_id[] query parameters. - */ + /** @see [list] */ + fun list( + params: SubscriptionListParams = SubscriptionListParams.none() + ): CompletableFuture = list(params, RequestOptions.none()) + + /** @see [list] */ fun list(requestOptions: RequestOptions): CompletableFuture = list(SubscriptionListParams.none(), requestOptions) @@ -383,7 +385,10 @@ interface SubscriptionServiceAsync { * invoice and generate a new one based on the new dates for the subscription. See the section * on [cancellation behaviors](/product-catalog/creating-subscriptions#cancellation-behaviors). */ - @JvmOverloads + fun cancel(params: SubscriptionCancelParams): CompletableFuture = + cancel(params, RequestOptions.none()) + + /** @see [cancel] */ fun cancel( params: SubscriptionCancelParams, requestOptions: RequestOptions = RequestOptions.none(), @@ -393,7 +398,10 @@ interface SubscriptionServiceAsync { * This endpoint is used to fetch a [Subscription](/core-concepts##subscription) given an * identifier. */ - @JvmOverloads + fun fetch(params: SubscriptionFetchParams): CompletableFuture = + fetch(params, RequestOptions.none()) + + /** @see [fetch] */ fun fetch( params: SubscriptionFetchParams, requestOptions: RequestOptions = RequestOptions.none(), @@ -410,7 +418,11 @@ interface SubscriptionServiceAsync { * of costs to a specific subscription for the customer (e.g. to de-aggregate costs when a * customer's subscription has started and stopped on the same day). */ - @JvmOverloads + fun fetchCosts( + params: SubscriptionFetchCostsParams + ): CompletableFuture = fetchCosts(params, RequestOptions.none()) + + /** @see [fetchCosts] */ fun fetchCosts( params: SubscriptionFetchCostsParams, requestOptions: RequestOptions = RequestOptions.none(), @@ -421,7 +433,12 @@ interface SubscriptionServiceAsync { * with a subscription along with their start and end dates. This list contains the * subscription's initial plan along with past and future plan changes. */ - @JvmOverloads + fun fetchSchedule( + params: SubscriptionFetchScheduleParams + ): CompletableFuture = + fetchSchedule(params, RequestOptions.none()) + + /** @see [fetchSchedule] */ fun fetchSchedule( params: SubscriptionFetchScheduleParams, requestOptions: RequestOptions = RequestOptions.none(), @@ -604,7 +621,10 @@ interface SubscriptionServiceAsync { * - `second_dimension_key`: `provider` * - `second_dimension_value`: `aws` */ - @JvmOverloads + fun fetchUsage(params: SubscriptionFetchUsageParams): CompletableFuture = + fetchUsage(params, RequestOptions.none()) + + /** @see [fetchUsage] */ fun fetchUsage( params: SubscriptionFetchUsageParams, requestOptions: RequestOptions = RequestOptions.none(), @@ -677,7 +697,12 @@ interface SubscriptionServiceAsync { * using the `fixed_fee_quantity_transitions` property on a subscription’s serialized price * intervals. */ - @JvmOverloads + fun priceIntervals( + params: SubscriptionPriceIntervalsParams + ): CompletableFuture = + priceIntervals(params, RequestOptions.none()) + + /** @see [priceIntervals] */ fun priceIntervals( params: SubscriptionPriceIntervalsParams, requestOptions: RequestOptions = RequestOptions.none(), @@ -849,7 +874,12 @@ interface SubscriptionServiceAsync { * change, adjusting the customer balance as needed. For details on this behavior, see * [Modifying subscriptions](/product-catalog/modifying-subscriptions#prorations-for-in-advance-fees). */ - @JvmOverloads + fun schedulePlanChange( + params: SubscriptionSchedulePlanChangeParams + ): CompletableFuture = + schedulePlanChange(params, RequestOptions.none()) + + /** @see [schedulePlanChange] */ fun schedulePlanChange( params: SubscriptionSchedulePlanChangeParams, requestOptions: RequestOptions = RequestOptions.none(), @@ -858,7 +888,12 @@ interface SubscriptionServiceAsync { /** * Manually trigger a phase, effective the given date (or the current time, if not specified). */ - @JvmOverloads + fun triggerPhase( + params: SubscriptionTriggerPhaseParams + ): CompletableFuture = + triggerPhase(params, RequestOptions.none()) + + /** @see [triggerPhase] */ fun triggerPhase( params: SubscriptionTriggerPhaseParams, requestOptions: RequestOptions = RequestOptions.none(), @@ -871,7 +906,12 @@ interface SubscriptionServiceAsync { * This operation will turn on auto-renew, ensuring that the subscription does not end at the * currently scheduled cancellation time. */ - @JvmOverloads + fun unscheduleCancellation( + params: SubscriptionUnscheduleCancellationParams + ): CompletableFuture = + unscheduleCancellation(params, RequestOptions.none()) + + /** @see [unscheduleCancellation] */ fun unscheduleCancellation( params: SubscriptionUnscheduleCancellationParams, requestOptions: RequestOptions = RequestOptions.none(), @@ -883,7 +923,12 @@ interface SubscriptionServiceAsync { * If there are no updates scheduled, a request validation error will be returned with a 400 * status code. */ - @JvmOverloads + fun unscheduleFixedFeeQuantityUpdates( + params: SubscriptionUnscheduleFixedFeeQuantityUpdatesParams + ): CompletableFuture = + unscheduleFixedFeeQuantityUpdates(params, RequestOptions.none()) + + /** @see [unscheduleFixedFeeQuantityUpdates] */ fun unscheduleFixedFeeQuantityUpdates( params: SubscriptionUnscheduleFixedFeeQuantityUpdatesParams, requestOptions: RequestOptions = RequestOptions.none(), @@ -892,7 +937,12 @@ interface SubscriptionServiceAsync { /** * This endpoint can be used to unschedule any pending plan changes on an existing subscription. */ - @JvmOverloads + fun unschedulePendingPlanChanges( + params: SubscriptionUnschedulePendingPlanChangesParams + ): CompletableFuture = + unschedulePendingPlanChanges(params, RequestOptions.none()) + + /** @see [unschedulePendingPlanChanges] */ fun unschedulePendingPlanChanges( params: SubscriptionUnschedulePendingPlanChangesParams, requestOptions: RequestOptions = RequestOptions.none(), @@ -912,7 +962,12 @@ interface SubscriptionServiceAsync { * If the fee is an in-advance fixed fee, it will also issue an immediate invoice for the * difference for the remainder of the billing period. */ - @JvmOverloads + fun updateFixedFeeQuantity( + params: SubscriptionUpdateFixedFeeQuantityParams + ): CompletableFuture = + updateFixedFeeQuantity(params, RequestOptions.none()) + + /** @see [updateFixedFeeQuantity] */ fun updateFixedFeeQuantity( params: SubscriptionUpdateFixedFeeQuantityParams, requestOptions: RequestOptions = RequestOptions.none(), @@ -936,7 +991,12 @@ interface SubscriptionServiceAsync { * scheduled or an add-on price was added, that change will be pushed back by the same amount of * time the trial is extended). */ - @JvmOverloads + fun updateTrial( + params: SubscriptionUpdateTrialParams + ): CompletableFuture = + updateTrial(params, RequestOptions.none()) + + /** @see [updateTrial] */ fun updateTrial( params: SubscriptionUpdateTrialParams, requestOptions: RequestOptions = RequestOptions.none(), @@ -952,7 +1012,13 @@ interface SubscriptionServiceAsync { * Returns a raw HTTP response for `post /subscriptions`, but is otherwise the same as * [SubscriptionServiceAsync.create]. */ - @JvmOverloads + @MustBeClosed + fun create( + params: SubscriptionCreateParams + ): CompletableFuture> = + create(params, RequestOptions.none()) + + /** @see [create] */ @MustBeClosed fun create( params: SubscriptionCreateParams, @@ -963,7 +1029,12 @@ interface SubscriptionServiceAsync { * Returns a raw HTTP response for `put /subscriptions/{subscription_id}`, but is otherwise * the same as [SubscriptionServiceAsync.update]. */ - @JvmOverloads + @MustBeClosed + fun update( + params: SubscriptionUpdateParams + ): CompletableFuture> = update(params, RequestOptions.none()) + + /** @see [update] */ @MustBeClosed fun update( params: SubscriptionUpdateParams, @@ -974,17 +1045,25 @@ interface SubscriptionServiceAsync { * Returns a raw HTTP response for `get /subscriptions`, but is otherwise the same as * [SubscriptionServiceAsync.list]. */ - @JvmOverloads + @MustBeClosed + fun list(): CompletableFuture> = + list(SubscriptionListParams.none()) + + /** @see [list] */ @MustBeClosed fun list( params: SubscriptionListParams = SubscriptionListParams.none(), requestOptions: RequestOptions = RequestOptions.none(), ): CompletableFuture> - /** - * Returns a raw HTTP response for `get /subscriptions`, but is otherwise the same as - * [SubscriptionServiceAsync.list]. - */ + /** @see [list] */ + @MustBeClosed + fun list( + params: SubscriptionListParams = SubscriptionListParams.none() + ): CompletableFuture> = + list(params, RequestOptions.none()) + + /** @see [list] */ @MustBeClosed fun list( requestOptions: RequestOptions @@ -995,7 +1074,13 @@ interface SubscriptionServiceAsync { * Returns a raw HTTP response for `post /subscriptions/{subscription_id}/cancel`, but is * otherwise the same as [SubscriptionServiceAsync.cancel]. */ - @JvmOverloads + @MustBeClosed + fun cancel( + params: SubscriptionCancelParams + ): CompletableFuture> = + cancel(params, RequestOptions.none()) + + /** @see [cancel] */ @MustBeClosed fun cancel( params: SubscriptionCancelParams, @@ -1006,7 +1091,12 @@ interface SubscriptionServiceAsync { * Returns a raw HTTP response for `get /subscriptions/{subscription_id}`, but is otherwise * the same as [SubscriptionServiceAsync.fetch]. */ - @JvmOverloads + @MustBeClosed + fun fetch( + params: SubscriptionFetchParams + ): CompletableFuture> = fetch(params, RequestOptions.none()) + + /** @see [fetch] */ @MustBeClosed fun fetch( params: SubscriptionFetchParams, @@ -1017,7 +1107,13 @@ interface SubscriptionServiceAsync { * Returns a raw HTTP response for `get /subscriptions/{subscription_id}/costs`, but is * otherwise the same as [SubscriptionServiceAsync.fetchCosts]. */ - @JvmOverloads + @MustBeClosed + fun fetchCosts( + params: SubscriptionFetchCostsParams + ): CompletableFuture> = + fetchCosts(params, RequestOptions.none()) + + /** @see [fetchCosts] */ @MustBeClosed fun fetchCosts( params: SubscriptionFetchCostsParams, @@ -1028,7 +1124,13 @@ interface SubscriptionServiceAsync { * Returns a raw HTTP response for `get /subscriptions/{subscription_id}/schedule`, but is * otherwise the same as [SubscriptionServiceAsync.fetchSchedule]. */ - @JvmOverloads + @MustBeClosed + fun fetchSchedule( + params: SubscriptionFetchScheduleParams + ): CompletableFuture> = + fetchSchedule(params, RequestOptions.none()) + + /** @see [fetchSchedule] */ @MustBeClosed fun fetchSchedule( params: SubscriptionFetchScheduleParams, @@ -1039,7 +1141,13 @@ interface SubscriptionServiceAsync { * Returns a raw HTTP response for `get /subscriptions/{subscription_id}/usage`, but is * otherwise the same as [SubscriptionServiceAsync.fetchUsage]. */ - @JvmOverloads + @MustBeClosed + fun fetchUsage( + params: SubscriptionFetchUsageParams + ): CompletableFuture> = + fetchUsage(params, RequestOptions.none()) + + /** @see [fetchUsage] */ @MustBeClosed fun fetchUsage( params: SubscriptionFetchUsageParams, @@ -1050,7 +1158,13 @@ interface SubscriptionServiceAsync { * Returns a raw HTTP response for `post /subscriptions/{subscription_id}/price_intervals`, * but is otherwise the same as [SubscriptionServiceAsync.priceIntervals]. */ - @JvmOverloads + @MustBeClosed + fun priceIntervals( + params: SubscriptionPriceIntervalsParams + ): CompletableFuture> = + priceIntervals(params, RequestOptions.none()) + + /** @see [priceIntervals] */ @MustBeClosed fun priceIntervals( params: SubscriptionPriceIntervalsParams, @@ -1062,7 +1176,13 @@ interface SubscriptionServiceAsync { * /subscriptions/{subscription_id}/schedule_plan_change`, but is otherwise the same as * [SubscriptionServiceAsync.schedulePlanChange]. */ - @JvmOverloads + @MustBeClosed + fun schedulePlanChange( + params: SubscriptionSchedulePlanChangeParams + ): CompletableFuture> = + schedulePlanChange(params, RequestOptions.none()) + + /** @see [schedulePlanChange] */ @MustBeClosed fun schedulePlanChange( params: SubscriptionSchedulePlanChangeParams, @@ -1073,7 +1193,13 @@ interface SubscriptionServiceAsync { * Returns a raw HTTP response for `post /subscriptions/{subscription_id}/trigger_phase`, * but is otherwise the same as [SubscriptionServiceAsync.triggerPhase]. */ - @JvmOverloads + @MustBeClosed + fun triggerPhase( + params: SubscriptionTriggerPhaseParams + ): CompletableFuture> = + triggerPhase(params, RequestOptions.none()) + + /** @see [triggerPhase] */ @MustBeClosed fun triggerPhase( params: SubscriptionTriggerPhaseParams, @@ -1085,7 +1211,13 @@ interface SubscriptionServiceAsync { * /subscriptions/{subscription_id}/unschedule_cancellation`, but is otherwise the same as * [SubscriptionServiceAsync.unscheduleCancellation]. */ - @JvmOverloads + @MustBeClosed + fun unscheduleCancellation( + params: SubscriptionUnscheduleCancellationParams + ): CompletableFuture> = + unscheduleCancellation(params, RequestOptions.none()) + + /** @see [unscheduleCancellation] */ @MustBeClosed fun unscheduleCancellation( params: SubscriptionUnscheduleCancellationParams, @@ -1097,7 +1229,14 @@ interface SubscriptionServiceAsync { * /subscriptions/{subscription_id}/unschedule_fixed_fee_quantity_updates`, but is otherwise * the same as [SubscriptionServiceAsync.unscheduleFixedFeeQuantityUpdates]. */ - @JvmOverloads + @MustBeClosed + fun unscheduleFixedFeeQuantityUpdates( + params: SubscriptionUnscheduleFixedFeeQuantityUpdatesParams + ): CompletableFuture< + HttpResponseFor + > = unscheduleFixedFeeQuantityUpdates(params, RequestOptions.none()) + + /** @see [unscheduleFixedFeeQuantityUpdates] */ @MustBeClosed fun unscheduleFixedFeeQuantityUpdates( params: SubscriptionUnscheduleFixedFeeQuantityUpdatesParams, @@ -1109,7 +1248,13 @@ interface SubscriptionServiceAsync { * /subscriptions/{subscription_id}/unschedule_pending_plan_changes`, but is otherwise the * same as [SubscriptionServiceAsync.unschedulePendingPlanChanges]. */ - @JvmOverloads + @MustBeClosed + fun unschedulePendingPlanChanges( + params: SubscriptionUnschedulePendingPlanChangesParams + ): CompletableFuture> = + unschedulePendingPlanChanges(params, RequestOptions.none()) + + /** @see [unschedulePendingPlanChanges] */ @MustBeClosed fun unschedulePendingPlanChanges( params: SubscriptionUnschedulePendingPlanChangesParams, @@ -1121,7 +1266,13 @@ interface SubscriptionServiceAsync { * /subscriptions/{subscription_id}/update_fixed_fee_quantity`, but is otherwise the same as * [SubscriptionServiceAsync.updateFixedFeeQuantity]. */ - @JvmOverloads + @MustBeClosed + fun updateFixedFeeQuantity( + params: SubscriptionUpdateFixedFeeQuantityParams + ): CompletableFuture> = + updateFixedFeeQuantity(params, RequestOptions.none()) + + /** @see [updateFixedFeeQuantity] */ @MustBeClosed fun updateFixedFeeQuantity( params: SubscriptionUpdateFixedFeeQuantityParams, @@ -1132,7 +1283,13 @@ interface SubscriptionServiceAsync { * Returns a raw HTTP response for `post /subscriptions/{subscription_id}/update_trial`, but * is otherwise the same as [SubscriptionServiceAsync.updateTrial]. */ - @JvmOverloads + @MustBeClosed + fun updateTrial( + params: SubscriptionUpdateTrialParams + ): CompletableFuture> = + updateTrial(params, RequestOptions.none()) + + /** @see [updateTrial] */ @MustBeClosed fun updateTrial( params: SubscriptionUpdateTrialParams, diff --git a/orb-java-core/src/main/kotlin/com/withorb/api/services/async/TopLevelServiceAsync.kt b/orb-java-core/src/main/kotlin/com/withorb/api/services/async/TopLevelServiceAsync.kt index 451fdb1b..d482a3af 100644 --- a/orb-java-core/src/main/kotlin/com/withorb/api/services/async/TopLevelServiceAsync.kt +++ b/orb-java-core/src/main/kotlin/com/withorb/api/services/async/TopLevelServiceAsync.kt @@ -1,7 +1,5 @@ // File generated from our OpenAPI spec by Stainless. -@file:Suppress("OVERLOADS_INTERFACE") // See https://youtrack.jetbrains.com/issue/KT-36102 - package com.withorb.api.services.async import com.google.errorprone.annotations.MustBeClosed @@ -26,20 +24,20 @@ interface TopLevelServiceAsync { * * This API does not have any side-effects or return any Orb resources. */ - @JvmOverloads + fun ping(): CompletableFuture = ping(TopLevelPingParams.none()) + + /** @see [ping] */ fun ping( params: TopLevelPingParams = TopLevelPingParams.none(), requestOptions: RequestOptions = RequestOptions.none(), ): CompletableFuture - /** - * This endpoint allows you to test your connection to the Orb API and check the validity of - * your API key, passed in the Authorization header. This is particularly useful for checking - * that your environment is set up properly, and is a great choice for connectors and - * integrations. - * - * This API does not have any side-effects or return any Orb resources. - */ + /** @see [ping] */ + fun ping( + params: TopLevelPingParams = TopLevelPingParams.none() + ): CompletableFuture = ping(params, RequestOptions.none()) + + /** @see [ping] */ fun ping(requestOptions: RequestOptions): CompletableFuture = ping(TopLevelPingParams.none(), requestOptions) @@ -52,17 +50,25 @@ interface TopLevelServiceAsync { * Returns a raw HTTP response for `get /ping`, but is otherwise the same as * [TopLevelServiceAsync.ping]. */ - @JvmOverloads + @MustBeClosed + fun ping(): CompletableFuture> = + ping(TopLevelPingParams.none()) + + /** @see [ping] */ @MustBeClosed fun ping( params: TopLevelPingParams = TopLevelPingParams.none(), requestOptions: RequestOptions = RequestOptions.none(), ): CompletableFuture> - /** - * Returns a raw HTTP response for `get /ping`, but is otherwise the same as - * [TopLevelServiceAsync.ping]. - */ + /** @see [ping] */ + @MustBeClosed + fun ping( + params: TopLevelPingParams = TopLevelPingParams.none() + ): CompletableFuture> = + ping(params, RequestOptions.none()) + + /** @see [ping] */ @MustBeClosed fun ping( requestOptions: RequestOptions diff --git a/orb-java-core/src/main/kotlin/com/withorb/api/services/async/coupons/SubscriptionServiceAsync.kt b/orb-java-core/src/main/kotlin/com/withorb/api/services/async/coupons/SubscriptionServiceAsync.kt index 8a33f595..751bbd3c 100644 --- a/orb-java-core/src/main/kotlin/com/withorb/api/services/async/coupons/SubscriptionServiceAsync.kt +++ b/orb-java-core/src/main/kotlin/com/withorb/api/services/async/coupons/SubscriptionServiceAsync.kt @@ -1,7 +1,5 @@ // File generated from our OpenAPI spec by Stainless. -@file:Suppress("OVERLOADS_INTERFACE") // See https://youtrack.jetbrains.com/issue/KT-36102 - package com.withorb.api.services.async.coupons import com.google.errorprone.annotations.MustBeClosed @@ -24,7 +22,11 @@ interface SubscriptionServiceAsync { * subscription. For a full discussion of the subscription resource, see * [Subscription](/core-concepts#subscription). */ - @JvmOverloads + fun list( + params: CouponSubscriptionListParams + ): CompletableFuture = list(params, RequestOptions.none()) + + /** @see [list] */ fun list( params: CouponSubscriptionListParams, requestOptions: RequestOptions = RequestOptions.none(), @@ -40,7 +42,13 @@ interface SubscriptionServiceAsync { * Returns a raw HTTP response for `get /coupons/{coupon_id}/subscriptions`, but is * otherwise the same as [SubscriptionServiceAsync.list]. */ - @JvmOverloads + @MustBeClosed + fun list( + params: CouponSubscriptionListParams + ): CompletableFuture> = + list(params, RequestOptions.none()) + + /** @see [list] */ @MustBeClosed fun list( params: CouponSubscriptionListParams, diff --git a/orb-java-core/src/main/kotlin/com/withorb/api/services/async/customers/BalanceTransactionServiceAsync.kt b/orb-java-core/src/main/kotlin/com/withorb/api/services/async/customers/BalanceTransactionServiceAsync.kt index a470a235..7cbf4b6a 100644 --- a/orb-java-core/src/main/kotlin/com/withorb/api/services/async/customers/BalanceTransactionServiceAsync.kt +++ b/orb-java-core/src/main/kotlin/com/withorb/api/services/async/customers/BalanceTransactionServiceAsync.kt @@ -1,7 +1,5 @@ // File generated from our OpenAPI spec by Stainless. -@file:Suppress("OVERLOADS_INTERFACE") // See https://youtrack.jetbrains.com/issue/KT-36102 - package com.withorb.api.services.async.customers import com.google.errorprone.annotations.MustBeClosed @@ -24,7 +22,12 @@ interface BalanceTransactionServiceAsync { * Creates an immutable balance transaction that updates the customer's balance and returns back * the newly created transaction. */ - @JvmOverloads + fun create( + params: CustomerBalanceTransactionCreateParams + ): CompletableFuture = + create(params, RequestOptions.none()) + + /** @see [create] */ fun create( params: CustomerBalanceTransactionCreateParams, requestOptions: RequestOptions = RequestOptions.none(), @@ -57,7 +60,12 @@ interface BalanceTransactionServiceAsync { * synced to a separate invoicing provider. If a payment gateway such as Stripe is used, the * balance will be applied to the invoice before forwarding payment to the gateway. */ - @JvmOverloads + fun list( + params: CustomerBalanceTransactionListParams + ): CompletableFuture = + list(params, RequestOptions.none()) + + /** @see [list] */ fun list( params: CustomerBalanceTransactionListParams, requestOptions: RequestOptions = RequestOptions.none(), @@ -73,7 +81,13 @@ interface BalanceTransactionServiceAsync { * Returns a raw HTTP response for `post /customers/{customer_id}/balance_transactions`, but * is otherwise the same as [BalanceTransactionServiceAsync.create]. */ - @JvmOverloads + @MustBeClosed + fun create( + params: CustomerBalanceTransactionCreateParams + ): CompletableFuture> = + create(params, RequestOptions.none()) + + /** @see [create] */ @MustBeClosed fun create( params: CustomerBalanceTransactionCreateParams, @@ -84,7 +98,13 @@ interface BalanceTransactionServiceAsync { * Returns a raw HTTP response for `get /customers/{customer_id}/balance_transactions`, but * is otherwise the same as [BalanceTransactionServiceAsync.list]. */ - @JvmOverloads + @MustBeClosed + fun list( + params: CustomerBalanceTransactionListParams + ): CompletableFuture> = + list(params, RequestOptions.none()) + + /** @see [list] */ @MustBeClosed fun list( params: CustomerBalanceTransactionListParams, diff --git a/orb-java-core/src/main/kotlin/com/withorb/api/services/async/customers/CostServiceAsync.kt b/orb-java-core/src/main/kotlin/com/withorb/api/services/async/customers/CostServiceAsync.kt index c8fd9f8d..1474003b 100644 --- a/orb-java-core/src/main/kotlin/com/withorb/api/services/async/customers/CostServiceAsync.kt +++ b/orb-java-core/src/main/kotlin/com/withorb/api/services/async/customers/CostServiceAsync.kt @@ -1,7 +1,5 @@ // File generated from our OpenAPI spec by Stainless. -@file:Suppress("OVERLOADS_INTERFACE") // See https://youtrack.jetbrains.com/issue/KT-36102 - package com.withorb.api.services.async.customers import com.google.errorprone.annotations.MustBeClosed @@ -130,7 +128,10 @@ interface CostServiceAsync { * `secondary_grouping_key` based on the matrix price definition, for each `grouping_value` and * `secondary_grouping_value` available. */ - @JvmOverloads + fun list(params: CustomerCostListParams): CompletableFuture = + list(params, RequestOptions.none()) + + /** @see [list] */ fun list( params: CustomerCostListParams, requestOptions: RequestOptions = RequestOptions.none(), @@ -246,7 +247,12 @@ interface CostServiceAsync { * `secondary_grouping_key` based on the matrix price definition, for each `grouping_value` and * `secondary_grouping_value` available. */ - @JvmOverloads + fun listByExternalId( + params: CustomerCostListByExternalIdParams + ): CompletableFuture = + listByExternalId(params, RequestOptions.none()) + + /** @see [listByExternalId] */ fun listByExternalId( params: CustomerCostListByExternalIdParams, requestOptions: RequestOptions = RequestOptions.none(), @@ -259,7 +265,13 @@ interface CostServiceAsync { * Returns a raw HTTP response for `get /customers/{customer_id}/costs`, but is otherwise * the same as [CostServiceAsync.list]. */ - @JvmOverloads + @MustBeClosed + fun list( + params: CustomerCostListParams + ): CompletableFuture> = + list(params, RequestOptions.none()) + + /** @see [list] */ @MustBeClosed fun list( params: CustomerCostListParams, @@ -271,7 +283,13 @@ interface CostServiceAsync { * /customers/external_customer_id/{external_customer_id}/costs`, but is otherwise the same * as [CostServiceAsync.listByExternalId]. */ - @JvmOverloads + @MustBeClosed + fun listByExternalId( + params: CustomerCostListByExternalIdParams + ): CompletableFuture> = + listByExternalId(params, RequestOptions.none()) + + /** @see [listByExternalId] */ @MustBeClosed fun listByExternalId( params: CustomerCostListByExternalIdParams, diff --git a/orb-java-core/src/main/kotlin/com/withorb/api/services/async/customers/CreditServiceAsync.kt b/orb-java-core/src/main/kotlin/com/withorb/api/services/async/customers/CreditServiceAsync.kt index f8602de8..a07d73d2 100644 --- a/orb-java-core/src/main/kotlin/com/withorb/api/services/async/customers/CreditServiceAsync.kt +++ b/orb-java-core/src/main/kotlin/com/withorb/api/services/async/customers/CreditServiceAsync.kt @@ -1,7 +1,5 @@ // File generated from our OpenAPI spec by Stainless. -@file:Suppress("OVERLOADS_INTERFACE") // See https://youtrack.jetbrains.com/issue/KT-36102 - package com.withorb.api.services.async.customers import com.google.errorprone.annotations.MustBeClosed @@ -35,7 +33,10 @@ interface CreditServiceAsync { * Note that `currency` defaults to credits if not specified. To use a real world currency, set * `currency` to an ISO 4217 string. */ - @JvmOverloads + fun list(params: CustomerCreditListParams): CompletableFuture = + list(params, RequestOptions.none()) + + /** @see [list] */ fun list( params: CustomerCreditListParams, requestOptions: RequestOptions = RequestOptions.none(), @@ -50,7 +51,12 @@ interface CreditServiceAsync { * Note that `currency` defaults to credits if not specified. To use a real world currency, set * `currency` to an ISO 4217 string. */ - @JvmOverloads + fun listByExternalId( + params: CustomerCreditListByExternalIdParams + ): CompletableFuture = + listByExternalId(params, RequestOptions.none()) + + /** @see [listByExternalId] */ fun listByExternalId( params: CustomerCreditListByExternalIdParams, requestOptions: RequestOptions = RequestOptions.none(), @@ -69,7 +75,13 @@ interface CreditServiceAsync { * Returns a raw HTTP response for `get /customers/{customer_id}/credits`, but is otherwise * the same as [CreditServiceAsync.list]. */ - @JvmOverloads + @MustBeClosed + fun list( + params: CustomerCreditListParams + ): CompletableFuture> = + list(params, RequestOptions.none()) + + /** @see [list] */ @MustBeClosed fun list( params: CustomerCreditListParams, @@ -81,7 +93,13 @@ interface CreditServiceAsync { * /customers/external_customer_id/{external_customer_id}/credits`, but is otherwise the * same as [CreditServiceAsync.listByExternalId]. */ - @JvmOverloads + @MustBeClosed + fun listByExternalId( + params: CustomerCreditListByExternalIdParams + ): CompletableFuture> = + listByExternalId(params, RequestOptions.none()) + + /** @see [listByExternalId] */ @MustBeClosed fun listByExternalId( params: CustomerCreditListByExternalIdParams, diff --git a/orb-java-core/src/main/kotlin/com/withorb/api/services/async/customers/credits/LedgerServiceAsync.kt b/orb-java-core/src/main/kotlin/com/withorb/api/services/async/customers/credits/LedgerServiceAsync.kt index a96b7e82..3b9bc08a 100644 --- a/orb-java-core/src/main/kotlin/com/withorb/api/services/async/customers/credits/LedgerServiceAsync.kt +++ b/orb-java-core/src/main/kotlin/com/withorb/api/services/async/customers/credits/LedgerServiceAsync.kt @@ -1,7 +1,5 @@ // File generated from our OpenAPI spec by Stainless. -@file:Suppress("OVERLOADS_INTERFACE") // See https://youtrack.jetbrains.com/issue/KT-36102 - package com.withorb.api.services.async.customers.credits import com.google.errorprone.annotations.MustBeClosed @@ -103,7 +101,11 @@ interface LedgerServiceAsync { * When credits are added to a customer's balance as a result of a correction, this entry will * be added to the ledger to indicate the adjustment of credits. */ - @JvmOverloads + fun list( + params: CustomerCreditLedgerListParams + ): CompletableFuture = list(params, RequestOptions.none()) + + /** @see [list] */ fun list( params: CustomerCreditLedgerListParams, requestOptions: RequestOptions = RequestOptions.none(), @@ -212,7 +214,12 @@ interface LedgerServiceAsync { * decremented from, and `amount` indicates how many credits to return to the customer, up to * the block's initial balance. */ - @JvmOverloads + fun createEntry( + params: CustomerCreditLedgerCreateEntryParams + ): CompletableFuture = + createEntry(params, RequestOptions.none()) + + /** @see [createEntry] */ fun createEntry( params: CustomerCreditLedgerCreateEntryParams, requestOptions: RequestOptions = RequestOptions.none(), @@ -321,7 +328,12 @@ interface LedgerServiceAsync { * decremented from, and `amount` indicates how many credits to return to the customer, up to * the block's initial balance. */ - @JvmOverloads + fun createEntryByExternalId( + params: CustomerCreditLedgerCreateEntryByExternalIdParams + ): CompletableFuture = + createEntryByExternalId(params, RequestOptions.none()) + + /** @see [createEntryByExternalId] */ fun createEntryByExternalId( params: CustomerCreditLedgerCreateEntryByExternalIdParams, requestOptions: RequestOptions = RequestOptions.none(), @@ -406,7 +418,12 @@ interface LedgerServiceAsync { * When credits are added to a customer's balance as a result of a correction, this entry will * be added to the ledger to indicate the adjustment of credits. */ - @JvmOverloads + fun listByExternalId( + params: CustomerCreditLedgerListByExternalIdParams + ): CompletableFuture = + listByExternalId(params, RequestOptions.none()) + + /** @see [listByExternalId] */ fun listByExternalId( params: CustomerCreditLedgerListByExternalIdParams, requestOptions: RequestOptions = RequestOptions.none(), @@ -421,7 +438,13 @@ interface LedgerServiceAsync { * Returns a raw HTTP response for `get /customers/{customer_id}/credits/ledger`, but is * otherwise the same as [LedgerServiceAsync.list]. */ - @JvmOverloads + @MustBeClosed + fun list( + params: CustomerCreditLedgerListParams + ): CompletableFuture> = + list(params, RequestOptions.none()) + + /** @see [list] */ @MustBeClosed fun list( params: CustomerCreditLedgerListParams, @@ -432,7 +455,13 @@ interface LedgerServiceAsync { * Returns a raw HTTP response for `post /customers/{customer_id}/credits/ledger_entry`, but * is otherwise the same as [LedgerServiceAsync.createEntry]. */ - @JvmOverloads + @MustBeClosed + fun createEntry( + params: CustomerCreditLedgerCreateEntryParams + ): CompletableFuture> = + createEntry(params, RequestOptions.none()) + + /** @see [createEntry] */ @MustBeClosed fun createEntry( params: CustomerCreditLedgerCreateEntryParams, @@ -444,7 +473,13 @@ interface LedgerServiceAsync { * /customers/external_customer_id/{external_customer_id}/credits/ledger_entry`, but is * otherwise the same as [LedgerServiceAsync.createEntryByExternalId]. */ - @JvmOverloads + @MustBeClosed + fun createEntryByExternalId( + params: CustomerCreditLedgerCreateEntryByExternalIdParams + ): CompletableFuture> = + createEntryByExternalId(params, RequestOptions.none()) + + /** @see [createEntryByExternalId] */ @MustBeClosed fun createEntryByExternalId( params: CustomerCreditLedgerCreateEntryByExternalIdParams, @@ -456,7 +491,13 @@ interface LedgerServiceAsync { * /customers/external_customer_id/{external_customer_id}/credits/ledger`, but is otherwise * the same as [LedgerServiceAsync.listByExternalId]. */ - @JvmOverloads + @MustBeClosed + fun listByExternalId( + params: CustomerCreditLedgerListByExternalIdParams + ): CompletableFuture> = + listByExternalId(params, RequestOptions.none()) + + /** @see [listByExternalId] */ @MustBeClosed fun listByExternalId( params: CustomerCreditLedgerListByExternalIdParams, diff --git a/orb-java-core/src/main/kotlin/com/withorb/api/services/async/customers/credits/TopUpServiceAsync.kt b/orb-java-core/src/main/kotlin/com/withorb/api/services/async/customers/credits/TopUpServiceAsync.kt index d3f4a846..0dce0c98 100644 --- a/orb-java-core/src/main/kotlin/com/withorb/api/services/async/customers/credits/TopUpServiceAsync.kt +++ b/orb-java-core/src/main/kotlin/com/withorb/api/services/async/customers/credits/TopUpServiceAsync.kt @@ -1,7 +1,5 @@ // File generated from our OpenAPI spec by Stainless. -@file:Suppress("OVERLOADS_INTERFACE") // See https://youtrack.jetbrains.com/issue/KT-36102 - package com.withorb.api.services.async.customers.credits import com.google.errorprone.annotations.MustBeClosed @@ -35,14 +33,22 @@ interface TopUpServiceAsync { * If a top-up already exists for this customer in the same currency, the existing top-up will * be replaced. */ - @JvmOverloads + fun create( + params: CustomerCreditTopUpCreateParams + ): CompletableFuture = create(params, RequestOptions.none()) + + /** @see [create] */ fun create( params: CustomerCreditTopUpCreateParams, requestOptions: RequestOptions = RequestOptions.none(), ): CompletableFuture /** List top-ups */ - @JvmOverloads + fun list( + params: CustomerCreditTopUpListParams + ): CompletableFuture = list(params, RequestOptions.none()) + + /** @see [list] */ fun list( params: CustomerCreditTopUpListParams, requestOptions: RequestOptions = RequestOptions.none(), @@ -52,7 +58,10 @@ interface TopUpServiceAsync { * This deactivates the top-up and voids any invoices associated with pending credit blocks * purchased through the top-up. */ - @JvmOverloads + fun delete(params: CustomerCreditTopUpDeleteParams): CompletableFuture = + delete(params, RequestOptions.none()) + + /** @see [delete] */ fun delete( params: CustomerCreditTopUpDeleteParams, requestOptions: RequestOptions = RequestOptions.none(), @@ -66,7 +75,12 @@ interface TopUpServiceAsync { * If a top-up already exists for this customer in the same currency, the existing top-up will * be replaced. */ - @JvmOverloads + fun createByExternalId( + params: CustomerCreditTopUpCreateByExternalIdParams + ): CompletableFuture = + createByExternalId(params, RequestOptions.none()) + + /** @see [createByExternalId] */ fun createByExternalId( params: CustomerCreditTopUpCreateByExternalIdParams, requestOptions: RequestOptions = RequestOptions.none(), @@ -76,14 +90,23 @@ interface TopUpServiceAsync { * This deactivates the top-up and voids any invoices associated with pending credit blocks * purchased through the top-up. */ - @JvmOverloads + fun deleteByExternalId( + params: CustomerCreditTopUpDeleteByExternalIdParams + ): CompletableFuture = deleteByExternalId(params, RequestOptions.none()) + + /** @see [deleteByExternalId] */ fun deleteByExternalId( params: CustomerCreditTopUpDeleteByExternalIdParams, requestOptions: RequestOptions = RequestOptions.none(), ): CompletableFuture /** List top-ups by external ID */ - @JvmOverloads + fun listByExternalId( + params: CustomerCreditTopUpListByExternalIdParams + ): CompletableFuture = + listByExternalId(params, RequestOptions.none()) + + /** @see [listByExternalId] */ fun listByExternalId( params: CustomerCreditTopUpListByExternalIdParams, requestOptions: RequestOptions = RequestOptions.none(), @@ -96,7 +119,13 @@ interface TopUpServiceAsync { * Returns a raw HTTP response for `post /customers/{customer_id}/credits/top_ups`, but is * otherwise the same as [TopUpServiceAsync.create]. */ - @JvmOverloads + @MustBeClosed + fun create( + params: CustomerCreditTopUpCreateParams + ): CompletableFuture> = + create(params, RequestOptions.none()) + + /** @see [create] */ @MustBeClosed fun create( params: CustomerCreditTopUpCreateParams, @@ -107,7 +136,13 @@ interface TopUpServiceAsync { * Returns a raw HTTP response for `get /customers/{customer_id}/credits/top_ups`, but is * otherwise the same as [TopUpServiceAsync.list]. */ - @JvmOverloads + @MustBeClosed + fun list( + params: CustomerCreditTopUpListParams + ): CompletableFuture> = + list(params, RequestOptions.none()) + + /** @see [list] */ @MustBeClosed fun list( params: CustomerCreditTopUpListParams, @@ -119,7 +154,11 @@ interface TopUpServiceAsync { * /customers/{customer_id}/credits/top_ups/{top_up_id}`, but is otherwise the same as * [TopUpServiceAsync.delete]. */ - @JvmOverloads + @MustBeClosed + fun delete(params: CustomerCreditTopUpDeleteParams): CompletableFuture = + delete(params, RequestOptions.none()) + + /** @see [delete] */ @MustBeClosed fun delete( params: CustomerCreditTopUpDeleteParams, @@ -131,7 +170,13 @@ interface TopUpServiceAsync { * /customers/external_customer_id/{external_customer_id}/credits/top_ups`, but is otherwise * the same as [TopUpServiceAsync.createByExternalId]. */ - @JvmOverloads + @MustBeClosed + fun createByExternalId( + params: CustomerCreditTopUpCreateByExternalIdParams + ): CompletableFuture> = + createByExternalId(params, RequestOptions.none()) + + /** @see [createByExternalId] */ @MustBeClosed fun createByExternalId( params: CustomerCreditTopUpCreateByExternalIdParams, @@ -143,7 +188,12 @@ interface TopUpServiceAsync { * /customers/external_customer_id/{external_customer_id}/credits/top_ups/{top_up_id}`, but * is otherwise the same as [TopUpServiceAsync.deleteByExternalId]. */ - @JvmOverloads + @MustBeClosed + fun deleteByExternalId( + params: CustomerCreditTopUpDeleteByExternalIdParams + ): CompletableFuture = deleteByExternalId(params, RequestOptions.none()) + + /** @see [deleteByExternalId] */ @MustBeClosed fun deleteByExternalId( params: CustomerCreditTopUpDeleteByExternalIdParams, @@ -155,7 +205,13 @@ interface TopUpServiceAsync { * /customers/external_customer_id/{external_customer_id}/credits/top_ups`, but is otherwise * the same as [TopUpServiceAsync.listByExternalId]. */ - @JvmOverloads + @MustBeClosed + fun listByExternalId( + params: CustomerCreditTopUpListByExternalIdParams + ): CompletableFuture> = + listByExternalId(params, RequestOptions.none()) + + /** @see [listByExternalId] */ @MustBeClosed fun listByExternalId( params: CustomerCreditTopUpListByExternalIdParams, diff --git a/orb-java-core/src/main/kotlin/com/withorb/api/services/async/dimensionalPriceGroups/ExternalDimensionalPriceGroupIdServiceAsync.kt b/orb-java-core/src/main/kotlin/com/withorb/api/services/async/dimensionalPriceGroups/ExternalDimensionalPriceGroupIdServiceAsync.kt index 74032cf5..eeb23832 100644 --- a/orb-java-core/src/main/kotlin/com/withorb/api/services/async/dimensionalPriceGroups/ExternalDimensionalPriceGroupIdServiceAsync.kt +++ b/orb-java-core/src/main/kotlin/com/withorb/api/services/async/dimensionalPriceGroups/ExternalDimensionalPriceGroupIdServiceAsync.kt @@ -1,7 +1,5 @@ // File generated from our OpenAPI spec by Stainless. -@file:Suppress("OVERLOADS_INTERFACE") // See https://youtrack.jetbrains.com/issue/KT-36102 - package com.withorb.api.services.async.dimensionalPriceGroups import com.google.errorprone.annotations.MustBeClosed @@ -19,7 +17,11 @@ interface ExternalDimensionalPriceGroupIdServiceAsync { fun withRawResponse(): WithRawResponse /** Fetch dimensional price group by external ID */ - @JvmOverloads + fun retrieve( + params: DimensionalPriceGroupExternalDimensionalPriceGroupIdRetrieveParams + ): CompletableFuture = retrieve(params, RequestOptions.none()) + + /** @see [retrieve] */ fun retrieve( params: DimensionalPriceGroupExternalDimensionalPriceGroupIdRetrieveParams, requestOptions: RequestOptions = RequestOptions.none(), @@ -36,7 +38,13 @@ interface ExternalDimensionalPriceGroupIdServiceAsync { * /dimensional_price_groups/external_dimensional_price_group_id/{external_dimensional_price_group_id}`, * but is otherwise the same as [ExternalDimensionalPriceGroupIdServiceAsync.retrieve]. */ - @JvmOverloads + @MustBeClosed + fun retrieve( + params: DimensionalPriceGroupExternalDimensionalPriceGroupIdRetrieveParams + ): CompletableFuture> = + retrieve(params, RequestOptions.none()) + + /** @see [retrieve] */ @MustBeClosed fun retrieve( params: DimensionalPriceGroupExternalDimensionalPriceGroupIdRetrieveParams, diff --git a/orb-java-core/src/main/kotlin/com/withorb/api/services/async/events/BackfillServiceAsync.kt b/orb-java-core/src/main/kotlin/com/withorb/api/services/async/events/BackfillServiceAsync.kt index bb778d66..aeace6ac 100644 --- a/orb-java-core/src/main/kotlin/com/withorb/api/services/async/events/BackfillServiceAsync.kt +++ b/orb-java-core/src/main/kotlin/com/withorb/api/services/async/events/BackfillServiceAsync.kt @@ -1,7 +1,5 @@ // File generated from our OpenAPI spec by Stainless. -@file:Suppress("OVERLOADS_INTERFACE") // See https://youtrack.jetbrains.com/issue/KT-36102 - package com.withorb.api.services.async.events import com.google.errorprone.annotations.MustBeClosed @@ -56,7 +54,10 @@ interface BackfillServiceAsync { * expressiveness of computed properties allows you to deprecate existing events based on both a * period of time and specific property values. */ - @JvmOverloads + fun create(params: EventBackfillCreateParams): CompletableFuture = + create(params, RequestOptions.none()) + + /** @see [create] */ fun create( params: EventBackfillCreateParams, requestOptions: RequestOptions = RequestOptions.none(), @@ -70,20 +71,20 @@ interface BackfillServiceAsync { * caller retrieve the next page of results if they exist. More information about pagination can * be found in the [Pagination-metadata schema](pagination). */ - @JvmOverloads + fun list(): CompletableFuture = list(EventBackfillListParams.none()) + + /** @see [list] */ fun list( params: EventBackfillListParams = EventBackfillListParams.none(), requestOptions: RequestOptions = RequestOptions.none(), ): CompletableFuture - /** - * This endpoint returns a list of all backfills in a list format. - * - * The list of backfills is ordered starting from the most recently created backfill. The - * response also includes [`pagination_metadata`](/api-reference/pagination), which lets the - * caller retrieve the next page of results if they exist. More information about pagination can - * be found in the [Pagination-metadata schema](pagination). - */ + /** @see [list] */ + fun list( + params: EventBackfillListParams = EventBackfillListParams.none() + ): CompletableFuture = list(params, RequestOptions.none()) + + /** @see [list] */ fun list(requestOptions: RequestOptions): CompletableFuture = list(EventBackfillListParams.none(), requestOptions) @@ -92,14 +93,20 @@ interface BackfillServiceAsync { * asynchronously reflect the updated usage in invoice amounts and usage graphs. Once all of the * updates are complete, the backfill's status will transition to `reflected`. */ - @JvmOverloads + fun close(params: EventBackfillCloseParams): CompletableFuture = + close(params, RequestOptions.none()) + + /** @see [close] */ fun close( params: EventBackfillCloseParams, requestOptions: RequestOptions = RequestOptions.none(), ): CompletableFuture /** This endpoint is used to fetch a backfill given an identifier. */ - @JvmOverloads + fun fetch(params: EventBackfillFetchParams): CompletableFuture = + fetch(params, RequestOptions.none()) + + /** @see [fetch] */ fun fetch( params: EventBackfillFetchParams, requestOptions: RequestOptions = RequestOptions.none(), @@ -113,7 +120,10 @@ interface BackfillServiceAsync { * If a backfill is reverted before its closed, no usage will be updated as a result of the * backfill and it will immediately transition to `reverted`. */ - @JvmOverloads + fun revert(params: EventBackfillRevertParams): CompletableFuture = + revert(params, RequestOptions.none()) + + /** @see [revert] */ fun revert( params: EventBackfillRevertParams, requestOptions: RequestOptions = RequestOptions.none(), @@ -128,7 +138,13 @@ interface BackfillServiceAsync { * Returns a raw HTTP response for `post /events/backfills`, but is otherwise the same as * [BackfillServiceAsync.create]. */ - @JvmOverloads + @MustBeClosed + fun create( + params: EventBackfillCreateParams + ): CompletableFuture> = + create(params, RequestOptions.none()) + + /** @see [create] */ @MustBeClosed fun create( params: EventBackfillCreateParams, @@ -139,17 +155,25 @@ interface BackfillServiceAsync { * Returns a raw HTTP response for `get /events/backfills`, but is otherwise the same as * [BackfillServiceAsync.list]. */ - @JvmOverloads + @MustBeClosed + fun list(): CompletableFuture> = + list(EventBackfillListParams.none()) + + /** @see [list] */ @MustBeClosed fun list( params: EventBackfillListParams = EventBackfillListParams.none(), requestOptions: RequestOptions = RequestOptions.none(), ): CompletableFuture> - /** - * Returns a raw HTTP response for `get /events/backfills`, but is otherwise the same as - * [BackfillServiceAsync.list]. - */ + /** @see [list] */ + @MustBeClosed + fun list( + params: EventBackfillListParams = EventBackfillListParams.none() + ): CompletableFuture> = + list(params, RequestOptions.none()) + + /** @see [list] */ @MustBeClosed fun list( requestOptions: RequestOptions @@ -160,7 +184,13 @@ interface BackfillServiceAsync { * Returns a raw HTTP response for `post /events/backfills/{backfill_id}/close`, but is * otherwise the same as [BackfillServiceAsync.close]. */ - @JvmOverloads + @MustBeClosed + fun close( + params: EventBackfillCloseParams + ): CompletableFuture> = + close(params, RequestOptions.none()) + + /** @see [close] */ @MustBeClosed fun close( params: EventBackfillCloseParams, @@ -171,7 +201,13 @@ interface BackfillServiceAsync { * Returns a raw HTTP response for `get /events/backfills/{backfill_id}`, but is otherwise * the same as [BackfillServiceAsync.fetch]. */ - @JvmOverloads + @MustBeClosed + fun fetch( + params: EventBackfillFetchParams + ): CompletableFuture> = + fetch(params, RequestOptions.none()) + + /** @see [fetch] */ @MustBeClosed fun fetch( params: EventBackfillFetchParams, @@ -182,7 +218,13 @@ interface BackfillServiceAsync { * Returns a raw HTTP response for `post /events/backfills/{backfill_id}/revert`, but is * otherwise the same as [BackfillServiceAsync.revert]. */ - @JvmOverloads + @MustBeClosed + fun revert( + params: EventBackfillRevertParams + ): CompletableFuture> = + revert(params, RequestOptions.none()) + + /** @see [revert] */ @MustBeClosed fun revert( params: EventBackfillRevertParams, diff --git a/orb-java-core/src/main/kotlin/com/withorb/api/services/async/events/VolumeServiceAsync.kt b/orb-java-core/src/main/kotlin/com/withorb/api/services/async/events/VolumeServiceAsync.kt index 0eea889f..8bba8462 100644 --- a/orb-java-core/src/main/kotlin/com/withorb/api/services/async/events/VolumeServiceAsync.kt +++ b/orb-java-core/src/main/kotlin/com/withorb/api/services/async/events/VolumeServiceAsync.kt @@ -1,7 +1,5 @@ // File generated from our OpenAPI spec by Stainless. -@file:Suppress("OVERLOADS_INTERFACE") // See https://youtrack.jetbrains.com/issue/KT-36102 - package com.withorb.api.services.async.events import com.google.errorprone.annotations.MustBeClosed @@ -31,7 +29,10 @@ interface VolumeServiceAsync { * and end time are hour-aligned and in UTC. When a specific timestamp is passed in for either * start or end time, the response includes the hours the timestamp falls in. */ - @JvmOverloads + fun list(params: EventVolumeListParams): CompletableFuture = + list(params, RequestOptions.none()) + + /** @see [list] */ fun list( params: EventVolumeListParams, requestOptions: RequestOptions = RequestOptions.none(), @@ -46,7 +47,11 @@ interface VolumeServiceAsync { * Returns a raw HTTP response for `get /events/volume`, but is otherwise the same as * [VolumeServiceAsync.list]. */ - @JvmOverloads + @MustBeClosed + fun list(params: EventVolumeListParams): CompletableFuture> = + list(params, RequestOptions.none()) + + /** @see [list] */ @MustBeClosed fun list( params: EventVolumeListParams, diff --git a/orb-java-core/src/main/kotlin/com/withorb/api/services/async/plans/ExternalPlanIdServiceAsync.kt b/orb-java-core/src/main/kotlin/com/withorb/api/services/async/plans/ExternalPlanIdServiceAsync.kt index 4ae9dc35..fc671e06 100644 --- a/orb-java-core/src/main/kotlin/com/withorb/api/services/async/plans/ExternalPlanIdServiceAsync.kt +++ b/orb-java-core/src/main/kotlin/com/withorb/api/services/async/plans/ExternalPlanIdServiceAsync.kt @@ -1,7 +1,5 @@ // File generated from our OpenAPI spec by Stainless. -@file:Suppress("OVERLOADS_INTERFACE") // See https://youtrack.jetbrains.com/issue/KT-36102 - package com.withorb.api.services.async.plans import com.google.errorprone.annotations.MustBeClosed @@ -25,7 +23,10 @@ interface ExternalPlanIdServiceAsync { * * Other fields on a customer are currently immutable. */ - @JvmOverloads + fun update(params: PlanExternalPlanIdUpdateParams): CompletableFuture = + update(params, RequestOptions.none()) + + /** @see [update] */ fun update( params: PlanExternalPlanIdUpdateParams, requestOptions: RequestOptions = RequestOptions.none(), @@ -48,7 +49,10 @@ interface ExternalPlanIdServiceAsync { * detailed explanation of price types can be found in the * [Price schema](/core-concepts#plan-and-price). " */ - @JvmOverloads + fun fetch(params: PlanExternalPlanIdFetchParams): CompletableFuture = + fetch(params, RequestOptions.none()) + + /** @see [fetch] */ fun fetch( params: PlanExternalPlanIdFetchParams, requestOptions: RequestOptions = RequestOptions.none(), @@ -64,7 +68,12 @@ interface ExternalPlanIdServiceAsync { * Returns a raw HTTP response for `put /plans/external_plan_id/{external_plan_id}`, but is * otherwise the same as [ExternalPlanIdServiceAsync.update]. */ - @JvmOverloads + @MustBeClosed + fun update( + params: PlanExternalPlanIdUpdateParams + ): CompletableFuture> = update(params, RequestOptions.none()) + + /** @see [update] */ @MustBeClosed fun update( params: PlanExternalPlanIdUpdateParams, @@ -75,7 +84,11 @@ interface ExternalPlanIdServiceAsync { * Returns a raw HTTP response for `get /plans/external_plan_id/{external_plan_id}`, but is * otherwise the same as [ExternalPlanIdServiceAsync.fetch]. */ - @JvmOverloads + @MustBeClosed + fun fetch(params: PlanExternalPlanIdFetchParams): CompletableFuture> = + fetch(params, RequestOptions.none()) + + /** @see [fetch] */ @MustBeClosed fun fetch( params: PlanExternalPlanIdFetchParams, diff --git a/orb-java-core/src/main/kotlin/com/withorb/api/services/async/prices/ExternalPriceIdServiceAsync.kt b/orb-java-core/src/main/kotlin/com/withorb/api/services/async/prices/ExternalPriceIdServiceAsync.kt index a02e2771..702ab415 100644 --- a/orb-java-core/src/main/kotlin/com/withorb/api/services/async/prices/ExternalPriceIdServiceAsync.kt +++ b/orb-java-core/src/main/kotlin/com/withorb/api/services/async/prices/ExternalPriceIdServiceAsync.kt @@ -1,7 +1,5 @@ // File generated from our OpenAPI spec by Stainless. -@file:Suppress("OVERLOADS_INTERFACE") // See https://youtrack.jetbrains.com/issue/KT-36102 - package com.withorb.api.services.async.prices import com.google.errorprone.annotations.MustBeClosed @@ -23,7 +21,10 @@ interface ExternalPriceIdServiceAsync { * This endpoint allows you to update the `metadata` property on a price. If you pass null for * the metadata value, it will clear any existing metadata for that price. */ - @JvmOverloads + fun update(params: PriceExternalPriceIdUpdateParams): CompletableFuture = + update(params, RequestOptions.none()) + + /** @see [update] */ fun update( params: PriceExternalPriceIdUpdateParams, requestOptions: RequestOptions = RequestOptions.none(), @@ -34,7 +35,10 @@ interface ExternalPriceIdServiceAsync { * [price creation API](/api-reference/price/create-price) for more information about external * price aliases. */ - @JvmOverloads + fun fetch(params: PriceExternalPriceIdFetchParams): CompletableFuture = + fetch(params, RequestOptions.none()) + + /** @see [fetch] */ fun fetch( params: PriceExternalPriceIdFetchParams, requestOptions: RequestOptions = RequestOptions.none(), @@ -50,7 +54,12 @@ interface ExternalPriceIdServiceAsync { * Returns a raw HTTP response for `put /prices/external_price_id/{external_price_id}`, but * is otherwise the same as [ExternalPriceIdServiceAsync.update]. */ - @JvmOverloads + @MustBeClosed + fun update( + params: PriceExternalPriceIdUpdateParams + ): CompletableFuture> = update(params, RequestOptions.none()) + + /** @see [update] */ @MustBeClosed fun update( params: PriceExternalPriceIdUpdateParams, @@ -61,7 +70,12 @@ interface ExternalPriceIdServiceAsync { * Returns a raw HTTP response for `get /prices/external_price_id/{external_price_id}`, but * is otherwise the same as [ExternalPriceIdServiceAsync.fetch]. */ - @JvmOverloads + @MustBeClosed + fun fetch( + params: PriceExternalPriceIdFetchParams + ): CompletableFuture> = fetch(params, RequestOptions.none()) + + /** @see [fetch] */ @MustBeClosed fun fetch( params: PriceExternalPriceIdFetchParams, diff --git a/orb-java-core/src/main/kotlin/com/withorb/api/services/blocking/AlertService.kt b/orb-java-core/src/main/kotlin/com/withorb/api/services/blocking/AlertService.kt index f3e2aa5b..e2b633a3 100644 --- a/orb-java-core/src/main/kotlin/com/withorb/api/services/blocking/AlertService.kt +++ b/orb-java-core/src/main/kotlin/com/withorb/api/services/blocking/AlertService.kt @@ -1,7 +1,5 @@ // File generated from our OpenAPI spec by Stainless. -@file:Suppress("OVERLOADS_INTERFACE") // See https://youtrack.jetbrains.com/issue/KT-36102 - package com.withorb.api.services.blocking import com.google.errorprone.annotations.MustBeClosed @@ -26,14 +24,18 @@ interface AlertService { fun withRawResponse(): WithRawResponse /** This endpoint retrieves an alert by its ID. */ - @JvmOverloads + fun retrieve(params: AlertRetrieveParams): Alert = retrieve(params, RequestOptions.none()) + + /** @see [retrieve] */ fun retrieve( params: AlertRetrieveParams, requestOptions: RequestOptions = RequestOptions.none(), ): Alert /** This endpoint updates the thresholds of an alert. */ - @JvmOverloads + fun update(params: AlertUpdateParams): Alert = update(params, RequestOptions.none()) + + /** @see [update] */ fun update( params: AlertUpdateParams, requestOptions: RequestOptions = RequestOptions.none(), @@ -50,23 +52,19 @@ interface AlertService { * The list of alerts is ordered starting from the most recently created alert. This endpoint * follows Orb's [standardized pagination format](/api-reference/pagination). */ - @JvmOverloads + fun list(): AlertListPage = list(AlertListParams.none()) + + /** @see [list] */ fun list( params: AlertListParams = AlertListParams.none(), requestOptions: RequestOptions = RequestOptions.none(), ): AlertListPage - /** - * This endpoint returns a list of alerts within Orb. - * - * The request must specify one of `customer_id`, `external_customer_id`, or `subscription_id`. - * - * If querying by subscripion_id, the endpoint will return the subscription level alerts as well - * as the plan level alerts associated with the subscription. - * - * The list of alerts is ordered starting from the most recently created alert. This endpoint - * follows Orb's [standardized pagination format](/api-reference/pagination). - */ + /** @see [list] */ + fun list(params: AlertListParams = AlertListParams.none()): AlertListPage = + list(params, RequestOptions.none()) + + /** @see [list] */ fun list(requestOptions: RequestOptions): AlertListPage = list(AlertListParams.none(), requestOptions) @@ -78,7 +76,10 @@ interface AlertService { * `credit_balance_dropped` alerts require a list of thresholds to be provided while * `credit_balance_depleted` and `credit_balance_recovered` alerts do not require thresholds. */ - @JvmOverloads + fun createForCustomer(params: AlertCreateForCustomerParams): Alert = + createForCustomer(params, RequestOptions.none()) + + /** @see [createForCustomer] */ fun createForCustomer( params: AlertCreateForCustomerParams, requestOptions: RequestOptions = RequestOptions.none(), @@ -92,7 +93,10 @@ interface AlertService { * `credit_balance_dropped` alerts require a list of thresholds to be provided while * `credit_balance_depleted` and `credit_balance_recovered` alerts do not require thresholds. */ - @JvmOverloads + fun createForExternalCustomer(params: AlertCreateForExternalCustomerParams): Alert = + createForExternalCustomer(params, RequestOptions.none()) + + /** @see [createForExternalCustomer] */ fun createForExternalCustomer( params: AlertCreateForExternalCustomerParams, requestOptions: RequestOptions = RequestOptions.none(), @@ -110,7 +114,10 @@ interface AlertService { * per metric that is a part of the subscription. Alerts are triggered based on usage or cost * conditions met during the current billing cycle. */ - @JvmOverloads + fun createForSubscription(params: AlertCreateForSubscriptionParams): Alert = + createForSubscription(params, RequestOptions.none()) + + /** @see [createForSubscription] */ fun createForSubscription( params: AlertCreateForSubscriptionParams, requestOptions: RequestOptions = RequestOptions.none(), @@ -121,7 +128,9 @@ interface AlertService { * subscription, you must include the `subscription_id`. The `subscription_id` is not required * for customer or subscription level alerts. */ - @JvmOverloads + fun disable(params: AlertDisableParams): Alert = disable(params, RequestOptions.none()) + + /** @see [disable] */ fun disable( params: AlertDisableParams, requestOptions: RequestOptions = RequestOptions.none(), @@ -132,7 +141,9 @@ interface AlertService { * subscription, you must include the `subscription_id`. The `subscription_id` is not required * for customer or subscription level alerts. */ - @JvmOverloads + fun enable(params: AlertEnableParams): Alert = enable(params, RequestOptions.none()) + + /** @see [enable] */ fun enable( params: AlertEnableParams, requestOptions: RequestOptions = RequestOptions.none(), @@ -145,7 +156,11 @@ interface AlertService { * Returns a raw HTTP response for `get /alerts/{alert_id}`, but is otherwise the same as * [AlertService.retrieve]. */ - @JvmOverloads + @MustBeClosed + fun retrieve(params: AlertRetrieveParams): HttpResponseFor = + retrieve(params, RequestOptions.none()) + + /** @see [retrieve] */ @MustBeClosed fun retrieve( params: AlertRetrieveParams, @@ -156,7 +171,11 @@ interface AlertService { * Returns a raw HTTP response for `put /alerts/{alert_configuration_id}`, but is otherwise * the same as [AlertService.update]. */ - @JvmOverloads + @MustBeClosed + fun update(params: AlertUpdateParams): HttpResponseFor = + update(params, RequestOptions.none()) + + /** @see [update] */ @MustBeClosed fun update( params: AlertUpdateParams, @@ -167,17 +186,21 @@ interface AlertService { * Returns a raw HTTP response for `get /alerts`, but is otherwise the same as * [AlertService.list]. */ - @JvmOverloads + @MustBeClosed fun list(): HttpResponseFor = list(AlertListParams.none()) + + /** @see [list] */ @MustBeClosed fun list( params: AlertListParams = AlertListParams.none(), requestOptions: RequestOptions = RequestOptions.none(), ): HttpResponseFor - /** - * Returns a raw HTTP response for `get /alerts`, but is otherwise the same as - * [AlertService.list]. - */ + /** @see [list] */ + @MustBeClosed + fun list(params: AlertListParams = AlertListParams.none()): HttpResponseFor = + list(params, RequestOptions.none()) + + /** @see [list] */ @MustBeClosed fun list(requestOptions: RequestOptions): HttpResponseFor = list(AlertListParams.none(), requestOptions) @@ -186,7 +209,11 @@ interface AlertService { * Returns a raw HTTP response for `post /alerts/customer_id/{customer_id}`, but is * otherwise the same as [AlertService.createForCustomer]. */ - @JvmOverloads + @MustBeClosed + fun createForCustomer(params: AlertCreateForCustomerParams): HttpResponseFor = + createForCustomer(params, RequestOptions.none()) + + /** @see [createForCustomer] */ @MustBeClosed fun createForCustomer( params: AlertCreateForCustomerParams, @@ -198,7 +225,12 @@ interface AlertService { * /alerts/external_customer_id/{external_customer_id}`, but is otherwise the same as * [AlertService.createForExternalCustomer]. */ - @JvmOverloads + @MustBeClosed + fun createForExternalCustomer( + params: AlertCreateForExternalCustomerParams + ): HttpResponseFor = createForExternalCustomer(params, RequestOptions.none()) + + /** @see [createForExternalCustomer] */ @MustBeClosed fun createForExternalCustomer( params: AlertCreateForExternalCustomerParams, @@ -209,7 +241,12 @@ interface AlertService { * Returns a raw HTTP response for `post /alerts/subscription_id/{subscription_id}`, but is * otherwise the same as [AlertService.createForSubscription]. */ - @JvmOverloads + @MustBeClosed + fun createForSubscription( + params: AlertCreateForSubscriptionParams + ): HttpResponseFor = createForSubscription(params, RequestOptions.none()) + + /** @see [createForSubscription] */ @MustBeClosed fun createForSubscription( params: AlertCreateForSubscriptionParams, @@ -220,7 +257,11 @@ interface AlertService { * Returns a raw HTTP response for `post /alerts/{alert_configuration_id}/disable`, but is * otherwise the same as [AlertService.disable]. */ - @JvmOverloads + @MustBeClosed + fun disable(params: AlertDisableParams): HttpResponseFor = + disable(params, RequestOptions.none()) + + /** @see [disable] */ @MustBeClosed fun disable( params: AlertDisableParams, @@ -231,7 +272,11 @@ interface AlertService { * Returns a raw HTTP response for `post /alerts/{alert_configuration_id}/enable`, but is * otherwise the same as [AlertService.enable]. */ - @JvmOverloads + @MustBeClosed + fun enable(params: AlertEnableParams): HttpResponseFor = + enable(params, RequestOptions.none()) + + /** @see [enable] */ @MustBeClosed fun enable( params: AlertEnableParams, diff --git a/orb-java-core/src/main/kotlin/com/withorb/api/services/blocking/CouponService.kt b/orb-java-core/src/main/kotlin/com/withorb/api/services/blocking/CouponService.kt index 2a4bca51..6a9a557a 100644 --- a/orb-java-core/src/main/kotlin/com/withorb/api/services/blocking/CouponService.kt +++ b/orb-java-core/src/main/kotlin/com/withorb/api/services/blocking/CouponService.kt @@ -1,7 +1,5 @@ // File generated from our OpenAPI spec by Stainless. -@file:Suppress("OVERLOADS_INTERFACE") // See https://youtrack.jetbrains.com/issue/KT-36102 - package com.withorb.api.services.blocking import com.google.errorprone.annotations.MustBeClosed @@ -28,7 +26,9 @@ interface CouponService { * This endpoint allows the creation of coupons, which can then be redeemed at subscription * creation or plan change. */ - @JvmOverloads + fun create(params: CouponCreateParams): Coupon = create(params, RequestOptions.none()) + + /** @see [create] */ fun create( params: CouponCreateParams, requestOptions: RequestOptions = RequestOptions.none(), @@ -42,20 +42,19 @@ interface CouponService { * if they exist. More information about pagination can be found in the Pagination-metadata * schema. */ - @JvmOverloads + fun list(): CouponListPage = list(CouponListParams.none()) + + /** @see [list] */ fun list( params: CouponListParams = CouponListParams.none(), requestOptions: RequestOptions = RequestOptions.none(), ): CouponListPage - /** - * This endpoint returns a list of all coupons for an account in a list format. - * - * The list of coupons is ordered starting from the most recently created coupon. The response - * also includes `pagination_metadata`, which lets the caller retrieve the next page of results - * if they exist. More information about pagination can be found in the Pagination-metadata - * schema. - */ + /** @see [list] */ + fun list(params: CouponListParams = CouponListParams.none()): CouponListPage = + list(params, RequestOptions.none()) + + /** @see [list] */ fun list(requestOptions: RequestOptions): CouponListPage = list(CouponListParams.none(), requestOptions) @@ -64,7 +63,9 @@ interface CouponService { * will be hidden from lists of active coupons. Additionally, once a coupon is archived, its * redemption code can be reused for a different coupon. */ - @JvmOverloads + fun archive(params: CouponArchiveParams): Coupon = archive(params, RequestOptions.none()) + + /** @see [archive] */ fun archive( params: CouponArchiveParams, requestOptions: RequestOptions = RequestOptions.none(), @@ -74,7 +75,9 @@ interface CouponService { * This endpoint retrieves a coupon by its ID. To fetch coupons by their redemption code, use * the [List coupons](list-coupons) endpoint with the redemption_code parameter. */ - @JvmOverloads + fun fetch(params: CouponFetchParams): Coupon = fetch(params, RequestOptions.none()) + + /** @see [fetch] */ fun fetch( params: CouponFetchParams, requestOptions: RequestOptions = RequestOptions.none(), @@ -89,7 +92,11 @@ interface CouponService { * Returns a raw HTTP response for `post /coupons`, but is otherwise the same as * [CouponService.create]. */ - @JvmOverloads + @MustBeClosed + fun create(params: CouponCreateParams): HttpResponseFor = + create(params, RequestOptions.none()) + + /** @see [create] */ @MustBeClosed fun create( params: CouponCreateParams, @@ -100,17 +107,22 @@ interface CouponService { * Returns a raw HTTP response for `get /coupons`, but is otherwise the same as * [CouponService.list]. */ - @JvmOverloads + @MustBeClosed fun list(): HttpResponseFor = list(CouponListParams.none()) + + /** @see [list] */ @MustBeClosed fun list( params: CouponListParams = CouponListParams.none(), requestOptions: RequestOptions = RequestOptions.none(), ): HttpResponseFor - /** - * Returns a raw HTTP response for `get /coupons`, but is otherwise the same as - * [CouponService.list]. - */ + /** @see [list] */ + @MustBeClosed + fun list( + params: CouponListParams = CouponListParams.none() + ): HttpResponseFor = list(params, RequestOptions.none()) + + /** @see [list] */ @MustBeClosed fun list(requestOptions: RequestOptions): HttpResponseFor = list(CouponListParams.none(), requestOptions) @@ -119,7 +131,11 @@ interface CouponService { * Returns a raw HTTP response for `post /coupons/{coupon_id}/archive`, but is otherwise the * same as [CouponService.archive]. */ - @JvmOverloads + @MustBeClosed + fun archive(params: CouponArchiveParams): HttpResponseFor = + archive(params, RequestOptions.none()) + + /** @see [archive] */ @MustBeClosed fun archive( params: CouponArchiveParams, @@ -130,7 +146,11 @@ interface CouponService { * Returns a raw HTTP response for `get /coupons/{coupon_id}`, but is otherwise the same as * [CouponService.fetch]. */ - @JvmOverloads + @MustBeClosed + fun fetch(params: CouponFetchParams): HttpResponseFor = + fetch(params, RequestOptions.none()) + + /** @see [fetch] */ @MustBeClosed fun fetch( params: CouponFetchParams, diff --git a/orb-java-core/src/main/kotlin/com/withorb/api/services/blocking/CreditNoteService.kt b/orb-java-core/src/main/kotlin/com/withorb/api/services/blocking/CreditNoteService.kt index 01ad2181..a2e0cba4 100644 --- a/orb-java-core/src/main/kotlin/com/withorb/api/services/blocking/CreditNoteService.kt +++ b/orb-java-core/src/main/kotlin/com/withorb/api/services/blocking/CreditNoteService.kt @@ -1,7 +1,5 @@ // File generated from our OpenAPI spec by Stainless. -@file:Suppress("OVERLOADS_INTERFACE") // See https://youtrack.jetbrains.com/issue/KT-36102 - package com.withorb.api.services.blocking import com.google.errorprone.annotations.MustBeClosed @@ -21,7 +19,9 @@ interface CreditNoteService { fun withRawResponse(): WithRawResponse /** This endpoint is used to create a single [`Credit Note`](/invoicing/credit-notes). */ - @JvmOverloads + fun create(params: CreditNoteCreateParams): CreditNote = create(params, RequestOptions.none()) + + /** @see [create] */ fun create( params: CreditNoteCreateParams, requestOptions: RequestOptions = RequestOptions.none(), @@ -32,17 +32,19 @@ interface CreditNoteService { * or external_customer_id. The credit notes will be returned in reverse chronological order by * `creation_time`. */ - @JvmOverloads + fun list(): CreditNoteListPage = list(CreditNoteListParams.none()) + + /** @see [list] */ fun list( params: CreditNoteListParams = CreditNoteListParams.none(), requestOptions: RequestOptions = RequestOptions.none(), ): CreditNoteListPage - /** - * Get a paginated list of CreditNotes. Users can also filter by customer_id, subscription_id, - * or external_customer_id. The credit notes will be returned in reverse chronological order by - * `creation_time`. - */ + /** @see [list] */ + fun list(params: CreditNoteListParams = CreditNoteListParams.none()): CreditNoteListPage = + list(params, RequestOptions.none()) + + /** @see [list] */ fun list(requestOptions: RequestOptions): CreditNoteListPage = list(CreditNoteListParams.none(), requestOptions) @@ -50,7 +52,9 @@ interface CreditNoteService { * This endpoint is used to fetch a single [`Credit Note`](/invoicing/credit-notes) given an * identifier. */ - @JvmOverloads + fun fetch(params: CreditNoteFetchParams): CreditNote = fetch(params, RequestOptions.none()) + + /** @see [fetch] */ fun fetch( params: CreditNoteFetchParams, requestOptions: RequestOptions = RequestOptions.none(), @@ -63,7 +67,11 @@ interface CreditNoteService { * Returns a raw HTTP response for `post /credit_notes`, but is otherwise the same as * [CreditNoteService.create]. */ - @JvmOverloads + @MustBeClosed + fun create(params: CreditNoteCreateParams): HttpResponseFor = + create(params, RequestOptions.none()) + + /** @see [create] */ @MustBeClosed fun create( params: CreditNoteCreateParams, @@ -74,17 +82,23 @@ interface CreditNoteService { * Returns a raw HTTP response for `get /credit_notes`, but is otherwise the same as * [CreditNoteService.list]. */ - @JvmOverloads + @MustBeClosed + fun list(): HttpResponseFor = list(CreditNoteListParams.none()) + + /** @see [list] */ @MustBeClosed fun list( params: CreditNoteListParams = CreditNoteListParams.none(), requestOptions: RequestOptions = RequestOptions.none(), ): HttpResponseFor - /** - * Returns a raw HTTP response for `get /credit_notes`, but is otherwise the same as - * [CreditNoteService.list]. - */ + /** @see [list] */ + @MustBeClosed + fun list( + params: CreditNoteListParams = CreditNoteListParams.none() + ): HttpResponseFor = list(params, RequestOptions.none()) + + /** @see [list] */ @MustBeClosed fun list(requestOptions: RequestOptions): HttpResponseFor = list(CreditNoteListParams.none(), requestOptions) @@ -93,7 +107,11 @@ interface CreditNoteService { * Returns a raw HTTP response for `get /credit_notes/{credit_note_id}`, but is otherwise * the same as [CreditNoteService.fetch]. */ - @JvmOverloads + @MustBeClosed + fun fetch(params: CreditNoteFetchParams): HttpResponseFor = + fetch(params, RequestOptions.none()) + + /** @see [fetch] */ @MustBeClosed fun fetch( params: CreditNoteFetchParams, diff --git a/orb-java-core/src/main/kotlin/com/withorb/api/services/blocking/CustomerService.kt b/orb-java-core/src/main/kotlin/com/withorb/api/services/blocking/CustomerService.kt index 359f426d..c77e438d 100644 --- a/orb-java-core/src/main/kotlin/com/withorb/api/services/blocking/CustomerService.kt +++ b/orb-java-core/src/main/kotlin/com/withorb/api/services/blocking/CustomerService.kt @@ -1,7 +1,5 @@ // File generated from our OpenAPI spec by Stainless. -@file:Suppress("OVERLOADS_INTERFACE") // See https://youtrack.jetbrains.com/issue/KT-36102 - package com.withorb.api.services.blocking import com.google.errorprone.annotations.MustBeClosed @@ -49,7 +47,9 @@ interface CustomerService { * - [Timezone localization](/essentials/timezones) can be configured on a per-customer basis by * setting the `timezone` parameter */ - @JvmOverloads + fun create(params: CustomerCreateParams): Customer = create(params, RequestOptions.none()) + + /** @see [create] */ fun create( params: CustomerCreateParams, requestOptions: RequestOptions = RequestOptions.none(), @@ -61,7 +61,9 @@ interface CustomerService { * `billing_address`, and `additional_emails` of an existing customer. Other fields on a * customer are currently immutable. */ - @JvmOverloads + fun update(params: CustomerUpdateParams): Customer = update(params, RequestOptions.none()) + + /** @see [update] */ fun update( params: CustomerUpdateParams, requestOptions: RequestOptions = RequestOptions.none(), @@ -74,19 +76,19 @@ interface CustomerService { * * See [Customer](/core-concepts##customer) for an overview of the customer model. */ - @JvmOverloads + fun list(): CustomerListPage = list(CustomerListParams.none()) + + /** @see [list] */ fun list( params: CustomerListParams = CustomerListParams.none(), requestOptions: RequestOptions = RequestOptions.none(), ): CustomerListPage - /** - * This endpoint returns a list of all customers for an account. The list of customers is - * ordered starting from the most recently created customer. This endpoint follows Orb's - * [standardized pagination format](/api-reference/pagination). - * - * See [Customer](/core-concepts##customer) for an overview of the customer model. - */ + /** @see [list] */ + fun list(params: CustomerListParams = CustomerListParams.none()): CustomerListPage = + list(params, RequestOptions.none()) + + /** @see [list] */ fun list(requestOptions: RequestOptions): CustomerListPage = list(CustomerListParams.none(), requestOptions) @@ -105,7 +107,9 @@ interface CustomerService { * * On successful processing, this returns an empty dictionary (`{}`) in the API. */ - @JvmOverloads + fun delete(params: CustomerDeleteParams) = delete(params, RequestOptions.none()) + + /** @see [delete] */ fun delete(params: CustomerDeleteParams, requestOptions: RequestOptions = RequestOptions.none()) /** @@ -115,7 +119,9 @@ interface CustomerService { * See the [Customer resource](/core-concepts#customer) for a full discussion of the Customer * model. */ - @JvmOverloads + fun fetch(params: CustomerFetchParams): Customer = fetch(params, RequestOptions.none()) + + /** @see [fetch] */ fun fetch( params: CustomerFetchParams, requestOptions: RequestOptions = RequestOptions.none(), @@ -128,7 +134,10 @@ interface CustomerService { * Note that the resource and semantics of this endpoint exactly mirror * [Get Customer](fetch-customer). */ - @JvmOverloads + fun fetchByExternalId(params: CustomerFetchByExternalIdParams): Customer = + fetchByExternalId(params, RequestOptions.none()) + + /** @see [fetchByExternalId] */ fun fetchByExternalId( params: CustomerFetchByExternalIdParams, requestOptions: RequestOptions = RequestOptions.none(), @@ -142,7 +151,10 @@ interface CustomerService { * * **Note**: This functionality is currently only available for Stripe. */ - @JvmOverloads + fun syncPaymentMethodsFromGateway(params: CustomerSyncPaymentMethodsFromGatewayParams) = + syncPaymentMethodsFromGateway(params, RequestOptions.none()) + + /** @see [syncPaymentMethodsFromGateway] */ fun syncPaymentMethodsFromGateway( params: CustomerSyncPaymentMethodsFromGatewayParams, requestOptions: RequestOptions = RequestOptions.none(), @@ -156,7 +168,11 @@ interface CustomerService { * * **Note**: This functionality is currently only available for Stripe. */ - @JvmOverloads + fun syncPaymentMethodsFromGatewayByExternalCustomerId( + params: CustomerSyncPaymentMethodsFromGatewayByExternalCustomerIdParams + ) = syncPaymentMethodsFromGatewayByExternalCustomerId(params, RequestOptions.none()) + + /** @see [syncPaymentMethodsFromGatewayByExternalCustomerId] */ fun syncPaymentMethodsFromGatewayByExternalCustomerId( params: CustomerSyncPaymentMethodsFromGatewayByExternalCustomerIdParams, requestOptions: RequestOptions = RequestOptions.none(), @@ -167,7 +183,10 @@ interface CustomerService { * [Customer ID Aliases](/events-and-metrics/customer-aliases)). Note that the resource and * semantics of this endpoint exactly mirror [Update Customer](update-customer). */ - @JvmOverloads + fun updateByExternalId(params: CustomerUpdateByExternalIdParams): Customer = + updateByExternalId(params, RequestOptions.none()) + + /** @see [updateByExternalId] */ fun updateByExternalId( params: CustomerUpdateByExternalIdParams, requestOptions: RequestOptions = RequestOptions.none(), @@ -186,7 +205,11 @@ interface CustomerService { * Returns a raw HTTP response for `post /customers`, but is otherwise the same as * [CustomerService.create]. */ - @JvmOverloads + @MustBeClosed + fun create(params: CustomerCreateParams): HttpResponseFor = + create(params, RequestOptions.none()) + + /** @see [create] */ @MustBeClosed fun create( params: CustomerCreateParams, @@ -197,7 +220,11 @@ interface CustomerService { * Returns a raw HTTP response for `put /customers/{customer_id}`, but is otherwise the same * as [CustomerService.update]. */ - @JvmOverloads + @MustBeClosed + fun update(params: CustomerUpdateParams): HttpResponseFor = + update(params, RequestOptions.none()) + + /** @see [update] */ @MustBeClosed fun update( params: CustomerUpdateParams, @@ -208,17 +235,23 @@ interface CustomerService { * Returns a raw HTTP response for `get /customers`, but is otherwise the same as * [CustomerService.list]. */ - @JvmOverloads + @MustBeClosed + fun list(): HttpResponseFor = list(CustomerListParams.none()) + + /** @see [list] */ @MustBeClosed fun list( params: CustomerListParams = CustomerListParams.none(), requestOptions: RequestOptions = RequestOptions.none(), ): HttpResponseFor - /** - * Returns a raw HTTP response for `get /customers`, but is otherwise the same as - * [CustomerService.list]. - */ + /** @see [list] */ + @MustBeClosed + fun list( + params: CustomerListParams = CustomerListParams.none() + ): HttpResponseFor = list(params, RequestOptions.none()) + + /** @see [list] */ @MustBeClosed fun list(requestOptions: RequestOptions): HttpResponseFor = list(CustomerListParams.none(), requestOptions) @@ -227,7 +260,11 @@ interface CustomerService { * Returns a raw HTTP response for `delete /customers/{customer_id}`, but is otherwise the * same as [CustomerService.delete]. */ - @JvmOverloads + @MustBeClosed + fun delete(params: CustomerDeleteParams): HttpResponse = + delete(params, RequestOptions.none()) + + /** @see [delete] */ @MustBeClosed fun delete( params: CustomerDeleteParams, @@ -238,7 +275,11 @@ interface CustomerService { * Returns a raw HTTP response for `get /customers/{customer_id}`, but is otherwise the same * as [CustomerService.fetch]. */ - @JvmOverloads + @MustBeClosed + fun fetch(params: CustomerFetchParams): HttpResponseFor = + fetch(params, RequestOptions.none()) + + /** @see [fetch] */ @MustBeClosed fun fetch( params: CustomerFetchParams, @@ -250,7 +291,11 @@ interface CustomerService { * /customers/external_customer_id/{external_customer_id}`, but is otherwise the same as * [CustomerService.fetchByExternalId]. */ - @JvmOverloads + @MustBeClosed + fun fetchByExternalId(params: CustomerFetchByExternalIdParams): HttpResponseFor = + fetchByExternalId(params, RequestOptions.none()) + + /** @see [fetchByExternalId] */ @MustBeClosed fun fetchByExternalId( params: CustomerFetchByExternalIdParams, @@ -262,7 +307,12 @@ interface CustomerService { * /customers/external_customer_id/{external_customer_id}/sync_payment_methods_from_gateway`, * but is otherwise the same as [CustomerService.syncPaymentMethodsFromGateway]. */ - @JvmOverloads + @MustBeClosed + fun syncPaymentMethodsFromGateway( + params: CustomerSyncPaymentMethodsFromGatewayParams + ): HttpResponse = syncPaymentMethodsFromGateway(params, RequestOptions.none()) + + /** @see [syncPaymentMethodsFromGateway] */ @MustBeClosed fun syncPaymentMethodsFromGateway( params: CustomerSyncPaymentMethodsFromGatewayParams, @@ -274,7 +324,13 @@ interface CustomerService { * /customers/{customer_id}/sync_payment_methods_from_gateway`, but is otherwise the same as * [CustomerService.syncPaymentMethodsFromGatewayByExternalCustomerId]. */ - @JvmOverloads + @MustBeClosed + fun syncPaymentMethodsFromGatewayByExternalCustomerId( + params: CustomerSyncPaymentMethodsFromGatewayByExternalCustomerIdParams + ): HttpResponse = + syncPaymentMethodsFromGatewayByExternalCustomerId(params, RequestOptions.none()) + + /** @see [syncPaymentMethodsFromGatewayByExternalCustomerId] */ @MustBeClosed fun syncPaymentMethodsFromGatewayByExternalCustomerId( params: CustomerSyncPaymentMethodsFromGatewayByExternalCustomerIdParams, @@ -286,7 +342,12 @@ interface CustomerService { * /customers/external_customer_id/{external_customer_id}`, but is otherwise the same as * [CustomerService.updateByExternalId]. */ - @JvmOverloads + @MustBeClosed + fun updateByExternalId( + params: CustomerUpdateByExternalIdParams + ): HttpResponseFor = updateByExternalId(params, RequestOptions.none()) + + /** @see [updateByExternalId] */ @MustBeClosed fun updateByExternalId( params: CustomerUpdateByExternalIdParams, diff --git a/orb-java-core/src/main/kotlin/com/withorb/api/services/blocking/DimensionalPriceGroupService.kt b/orb-java-core/src/main/kotlin/com/withorb/api/services/blocking/DimensionalPriceGroupService.kt index e13932c6..862f9925 100644 --- a/orb-java-core/src/main/kotlin/com/withorb/api/services/blocking/DimensionalPriceGroupService.kt +++ b/orb-java-core/src/main/kotlin/com/withorb/api/services/blocking/DimensionalPriceGroupService.kt @@ -1,7 +1,5 @@ // File generated from our OpenAPI spec by Stainless. -@file:Suppress("OVERLOADS_INTERFACE") // See https://youtrack.jetbrains.com/issue/KT-36102 - package com.withorb.api.services.blocking import com.google.errorprone.annotations.MustBeClosed @@ -32,27 +30,40 @@ interface DimensionalPriceGroupService { * group with a dimension "color" and two prices: one that charges $10 per red widget and one * that charges $20 per blue widget. */ - @JvmOverloads + fun create(params: DimensionalPriceGroupCreateParams): DimensionalPriceGroup = + create(params, RequestOptions.none()) + + /** @see [create] */ fun create( params: DimensionalPriceGroupCreateParams, requestOptions: RequestOptions = RequestOptions.none(), ): DimensionalPriceGroup /** Fetch dimensional price group */ - @JvmOverloads + fun retrieve(params: DimensionalPriceGroupRetrieveParams): DimensionalPriceGroup = + retrieve(params, RequestOptions.none()) + + /** @see [retrieve] */ fun retrieve( params: DimensionalPriceGroupRetrieveParams, requestOptions: RequestOptions = RequestOptions.none(), ): DimensionalPriceGroup /** List dimensional price groups */ - @JvmOverloads + fun list(): DimensionalPriceGroupListPage = list(DimensionalPriceGroupListParams.none()) + + /** @see [list] */ fun list( params: DimensionalPriceGroupListParams = DimensionalPriceGroupListParams.none(), requestOptions: RequestOptions = RequestOptions.none(), ): DimensionalPriceGroupListPage - /** List dimensional price groups */ + /** @see [list] */ + fun list( + params: DimensionalPriceGroupListParams = DimensionalPriceGroupListParams.none() + ): DimensionalPriceGroupListPage = list(params, RequestOptions.none()) + + /** @see [list] */ fun list(requestOptions: RequestOptions): DimensionalPriceGroupListPage = list(DimensionalPriceGroupListParams.none(), requestOptions) @@ -69,7 +80,12 @@ interface DimensionalPriceGroupService { * Returns a raw HTTP response for `post /dimensional_price_groups`, but is otherwise the * same as [DimensionalPriceGroupService.create]. */ - @JvmOverloads + @MustBeClosed + fun create( + params: DimensionalPriceGroupCreateParams + ): HttpResponseFor = create(params, RequestOptions.none()) + + /** @see [create] */ @MustBeClosed fun create( params: DimensionalPriceGroupCreateParams, @@ -81,7 +97,12 @@ interface DimensionalPriceGroupService { * /dimensional_price_groups/{dimensional_price_group_id}`, but is otherwise the same as * [DimensionalPriceGroupService.retrieve]. */ - @JvmOverloads + @MustBeClosed + fun retrieve( + params: DimensionalPriceGroupRetrieveParams + ): HttpResponseFor = retrieve(params, RequestOptions.none()) + + /** @see [retrieve] */ @MustBeClosed fun retrieve( params: DimensionalPriceGroupRetrieveParams, @@ -92,17 +113,24 @@ interface DimensionalPriceGroupService { * Returns a raw HTTP response for `get /dimensional_price_groups`, but is otherwise the * same as [DimensionalPriceGroupService.list]. */ - @JvmOverloads + @MustBeClosed + fun list(): HttpResponseFor = + list(DimensionalPriceGroupListParams.none()) + + /** @see [list] */ @MustBeClosed fun list( params: DimensionalPriceGroupListParams = DimensionalPriceGroupListParams.none(), requestOptions: RequestOptions = RequestOptions.none(), ): HttpResponseFor - /** - * Returns a raw HTTP response for `get /dimensional_price_groups`, but is otherwise the - * same as [DimensionalPriceGroupService.list]. - */ + /** @see [list] */ + @MustBeClosed + fun list( + params: DimensionalPriceGroupListParams = DimensionalPriceGroupListParams.none() + ): HttpResponseFor = list(params, RequestOptions.none()) + + /** @see [list] */ @MustBeClosed fun list(requestOptions: RequestOptions): HttpResponseFor = list(DimensionalPriceGroupListParams.none(), requestOptions) diff --git a/orb-java-core/src/main/kotlin/com/withorb/api/services/blocking/EventService.kt b/orb-java-core/src/main/kotlin/com/withorb/api/services/blocking/EventService.kt index 346cd12a..fbf459ff 100644 --- a/orb-java-core/src/main/kotlin/com/withorb/api/services/blocking/EventService.kt +++ b/orb-java-core/src/main/kotlin/com/withorb/api/services/blocking/EventService.kt @@ -1,7 +1,5 @@ // File generated from our OpenAPI spec by Stainless. -@file:Suppress("OVERLOADS_INTERFACE") // See https://youtrack.jetbrains.com/issue/KT-36102 - package com.withorb.api.services.blocking import com.google.errorprone.annotations.MustBeClosed @@ -70,7 +68,10 @@ interface EventService { * period. For higher volume updates, consider using the [event backfill](create-backfill) * endpoint. */ - @JvmOverloads + fun update(params: EventUpdateParams): EventUpdateResponse = + update(params, RequestOptions.none()) + + /** @see [update] */ fun update( params: EventUpdateParams, requestOptions: RequestOptions = RequestOptions.none(), @@ -112,7 +113,10 @@ interface EventService { * period. For higher volume updates, consider using the [event backfill](create-backfill) * endpoint. */ - @JvmOverloads + fun deprecate(params: EventDeprecateParams): EventDeprecateResponse = + deprecate(params, RequestOptions.none()) + + /** @see [deprecate] */ fun deprecate( params: EventDeprecateParams, requestOptions: RequestOptions = RequestOptions.none(), @@ -309,7 +313,10 @@ interface EventService { * } * ``` */ - @JvmOverloads + fun ingest(params: EventIngestParams): EventIngestResponse = + ingest(params, RequestOptions.none()) + + /** @see [ingest] */ fun ingest( params: EventIngestParams, requestOptions: RequestOptions = RequestOptions.none(), @@ -331,7 +338,10 @@ interface EventService { * By default, Orb will not throw a `404` if no events matched, Orb will return an empty array * for `data` instead. */ - @JvmOverloads + fun search(params: EventSearchParams): EventSearchResponse = + search(params, RequestOptions.none()) + + /** @see [search] */ fun search( params: EventSearchParams, requestOptions: RequestOptions = RequestOptions.none(), @@ -348,7 +358,11 @@ interface EventService { * Returns a raw HTTP response for `put /events/{event_id}`, but is otherwise the same as * [EventService.update]. */ - @JvmOverloads + @MustBeClosed + fun update(params: EventUpdateParams): HttpResponseFor = + update(params, RequestOptions.none()) + + /** @see [update] */ @MustBeClosed fun update( params: EventUpdateParams, @@ -359,7 +373,11 @@ interface EventService { * Returns a raw HTTP response for `put /events/{event_id}/deprecate`, but is otherwise the * same as [EventService.deprecate]. */ - @JvmOverloads + @MustBeClosed + fun deprecate(params: EventDeprecateParams): HttpResponseFor = + deprecate(params, RequestOptions.none()) + + /** @see [deprecate] */ @MustBeClosed fun deprecate( params: EventDeprecateParams, @@ -370,7 +388,11 @@ interface EventService { * Returns a raw HTTP response for `post /ingest`, but is otherwise the same as * [EventService.ingest]. */ - @JvmOverloads + @MustBeClosed + fun ingest(params: EventIngestParams): HttpResponseFor = + ingest(params, RequestOptions.none()) + + /** @see [ingest] */ @MustBeClosed fun ingest( params: EventIngestParams, @@ -381,7 +403,11 @@ interface EventService { * Returns a raw HTTP response for `post /events/search`, but is otherwise the same as * [EventService.search]. */ - @JvmOverloads + @MustBeClosed + fun search(params: EventSearchParams): HttpResponseFor = + search(params, RequestOptions.none()) + + /** @see [search] */ @MustBeClosed fun search( params: EventSearchParams, diff --git a/orb-java-core/src/main/kotlin/com/withorb/api/services/blocking/InvoiceLineItemService.kt b/orb-java-core/src/main/kotlin/com/withorb/api/services/blocking/InvoiceLineItemService.kt index ea309a84..c85d74a0 100644 --- a/orb-java-core/src/main/kotlin/com/withorb/api/services/blocking/InvoiceLineItemService.kt +++ b/orb-java-core/src/main/kotlin/com/withorb/api/services/blocking/InvoiceLineItemService.kt @@ -1,7 +1,5 @@ // File generated from our OpenAPI spec by Stainless. -@file:Suppress("OVERLOADS_INTERFACE") // See https://youtrack.jetbrains.com/issue/KT-36102 - package com.withorb.api.services.blocking import com.google.errorprone.annotations.MustBeClosed @@ -21,7 +19,10 @@ interface InvoiceLineItemService { * This creates a one-off fixed fee invoice line item on an Invoice. This can only be done for * invoices that are in a `draft` status. */ - @JvmOverloads + fun create(params: InvoiceLineItemCreateParams): InvoiceLineItemCreateResponse = + create(params, RequestOptions.none()) + + /** @see [create] */ fun create( params: InvoiceLineItemCreateParams, requestOptions: RequestOptions = RequestOptions.none(), @@ -37,7 +38,12 @@ interface InvoiceLineItemService { * Returns a raw HTTP response for `post /invoice_line_items`, but is otherwise the same as * [InvoiceLineItemService.create]. */ - @JvmOverloads + @MustBeClosed + fun create( + params: InvoiceLineItemCreateParams + ): HttpResponseFor = create(params, RequestOptions.none()) + + /** @see [create] */ @MustBeClosed fun create( params: InvoiceLineItemCreateParams, diff --git a/orb-java-core/src/main/kotlin/com/withorb/api/services/blocking/InvoiceService.kt b/orb-java-core/src/main/kotlin/com/withorb/api/services/blocking/InvoiceService.kt index bf6b8006..8aa45bfb 100644 --- a/orb-java-core/src/main/kotlin/com/withorb/api/services/blocking/InvoiceService.kt +++ b/orb-java-core/src/main/kotlin/com/withorb/api/services/blocking/InvoiceService.kt @@ -1,7 +1,5 @@ // File generated from our OpenAPI spec by Stainless. -@file:Suppress("OVERLOADS_INTERFACE") // See https://youtrack.jetbrains.com/issue/KT-36102 - package com.withorb.api.services.blocking import com.google.errorprone.annotations.MustBeClosed @@ -28,7 +26,9 @@ interface InvoiceService { fun withRawResponse(): WithRawResponse /** This endpoint is used to create a one-off invoice for a customer. */ - @JvmOverloads + fun create(params: InvoiceCreateParams): Invoice = create(params, RequestOptions.none()) + + /** @see [create] */ fun create( params: InvoiceCreateParams, requestOptions: RequestOptions = RequestOptions.none(), @@ -40,7 +40,9 @@ interface InvoiceService { * * `metadata` can be modified regardless of invoice state. */ - @JvmOverloads + fun update(params: InvoiceUpdateParams): Invoice = update(params, RequestOptions.none()) + + /** @see [update] */ fun update( params: InvoiceUpdateParams, requestOptions: RequestOptions = RequestOptions.none(), @@ -60,33 +62,28 @@ interface InvoiceService { * draft invoice, which may not always be up-to-date since Orb regularly refreshes invoices * asynchronously. */ - @JvmOverloads + fun list(): InvoiceListPage = list(InvoiceListParams.none()) + + /** @see [list] */ fun list( params: InvoiceListParams = InvoiceListParams.none(), requestOptions: RequestOptions = RequestOptions.none(), ): InvoiceListPage - /** - * This endpoint returns a list of all [`Invoice`](/core-concepts#invoice)s for an account in a - * list format. - * - * The list of invoices is ordered starting from the most recently issued invoice date. The - * response also includes [`pagination_metadata`](/api-reference/pagination), which lets the - * caller retrieve the next page of results if they exist. - * - * By default, this only returns invoices that are `issued`, `paid`, or `synced`. - * - * When fetching any `draft` invoices, this returns the last-computed invoice values for each - * draft invoice, which may not always be up-to-date since Orb regularly refreshes invoices - * asynchronously. - */ + /** @see [list] */ + fun list(params: InvoiceListParams = InvoiceListParams.none()): InvoiceListPage = + list(params, RequestOptions.none()) + + /** @see [list] */ fun list(requestOptions: RequestOptions): InvoiceListPage = list(InvoiceListParams.none(), requestOptions) /** * This endpoint is used to fetch an [`Invoice`](/core-concepts#invoice) given an identifier. */ - @JvmOverloads + fun fetch(params: InvoiceFetchParams): Invoice = fetch(params, RequestOptions.none()) + + /** @see [fetch] */ fun fetch( params: InvoiceFetchParams, requestOptions: RequestOptions = RequestOptions.none(), @@ -96,7 +93,10 @@ interface InvoiceService { * This endpoint can be used to fetch the upcoming [invoice](/core-concepts#invoice) for the * current billing period given a subscription. */ - @JvmOverloads + fun fetchUpcoming(params: InvoiceFetchUpcomingParams): InvoiceFetchUpcomingResponse = + fetchUpcoming(params, RequestOptions.none()) + + /** @see [fetchUpcoming] */ fun fetchUpcoming( params: InvoiceFetchUpcomingParams, requestOptions: RequestOptions = RequestOptions.none(), @@ -109,7 +109,9 @@ interface InvoiceService { * could be customer-visible (e.g. sending emails, auto-collecting payment, syncing the invoice * to external providers, etc). */ - @JvmOverloads + fun issue(params: InvoiceIssueParams): Invoice = issue(params, RequestOptions.none()) + + /** @see [issue] */ fun issue( params: InvoiceIssueParams, requestOptions: RequestOptions = RequestOptions.none(), @@ -119,7 +121,9 @@ interface InvoiceService { * This endpoint allows an invoice's status to be set the `paid` status. This can only be done * to invoices that are in the `issued` status. */ - @JvmOverloads + fun markPaid(params: InvoiceMarkPaidParams): Invoice = markPaid(params, RequestOptions.none()) + + /** @see [markPaid] */ fun markPaid( params: InvoiceMarkPaidParams, requestOptions: RequestOptions = RequestOptions.none(), @@ -129,7 +133,9 @@ interface InvoiceService { * This endpoint collects payment for an invoice using the customer's default payment method. * This action can only be taken on invoices with status "issued". */ - @JvmOverloads + fun pay(params: InvoicePayParams): Invoice = pay(params, RequestOptions.none()) + + /** @see [pay] */ fun pay( params: InvoicePayParams, requestOptions: RequestOptions = RequestOptions.none(), @@ -147,7 +153,10 @@ interface InvoiceService { * credit block will be voided. If the invoice was created due to a top-up, the top-up will be * disabled. */ - @JvmOverloads + fun voidInvoice(params: InvoiceVoidInvoiceParams): Invoice = + voidInvoice(params, RequestOptions.none()) + + /** @see [voidInvoice] */ fun voidInvoice( params: InvoiceVoidInvoiceParams, requestOptions: RequestOptions = RequestOptions.none(), @@ -160,7 +169,11 @@ interface InvoiceService { * Returns a raw HTTP response for `post /invoices`, but is otherwise the same as * [InvoiceService.create]. */ - @JvmOverloads + @MustBeClosed + fun create(params: InvoiceCreateParams): HttpResponseFor = + create(params, RequestOptions.none()) + + /** @see [create] */ @MustBeClosed fun create( params: InvoiceCreateParams, @@ -171,7 +184,11 @@ interface InvoiceService { * Returns a raw HTTP response for `put /invoices/{invoice_id}`, but is otherwise the same * as [InvoiceService.update]. */ - @JvmOverloads + @MustBeClosed + fun update(params: InvoiceUpdateParams): HttpResponseFor = + update(params, RequestOptions.none()) + + /** @see [update] */ @MustBeClosed fun update( params: InvoiceUpdateParams, @@ -182,17 +199,22 @@ interface InvoiceService { * Returns a raw HTTP response for `get /invoices`, but is otherwise the same as * [InvoiceService.list]. */ - @JvmOverloads + @MustBeClosed fun list(): HttpResponseFor = list(InvoiceListParams.none()) + + /** @see [list] */ @MustBeClosed fun list( params: InvoiceListParams = InvoiceListParams.none(), requestOptions: RequestOptions = RequestOptions.none(), ): HttpResponseFor - /** - * Returns a raw HTTP response for `get /invoices`, but is otherwise the same as - * [InvoiceService.list]. - */ + /** @see [list] */ + @MustBeClosed + fun list( + params: InvoiceListParams = InvoiceListParams.none() + ): HttpResponseFor = list(params, RequestOptions.none()) + + /** @see [list] */ @MustBeClosed fun list(requestOptions: RequestOptions): HttpResponseFor = list(InvoiceListParams.none(), requestOptions) @@ -201,7 +223,11 @@ interface InvoiceService { * Returns a raw HTTP response for `get /invoices/{invoice_id}`, but is otherwise the same * as [InvoiceService.fetch]. */ - @JvmOverloads + @MustBeClosed + fun fetch(params: InvoiceFetchParams): HttpResponseFor = + fetch(params, RequestOptions.none()) + + /** @see [fetch] */ @MustBeClosed fun fetch( params: InvoiceFetchParams, @@ -212,7 +238,13 @@ interface InvoiceService { * Returns a raw HTTP response for `get /invoices/upcoming`, but is otherwise the same as * [InvoiceService.fetchUpcoming]. */ - @JvmOverloads + @MustBeClosed + fun fetchUpcoming( + params: InvoiceFetchUpcomingParams + ): HttpResponseFor = + fetchUpcoming(params, RequestOptions.none()) + + /** @see [fetchUpcoming] */ @MustBeClosed fun fetchUpcoming( params: InvoiceFetchUpcomingParams, @@ -223,7 +255,11 @@ interface InvoiceService { * Returns a raw HTTP response for `post /invoices/{invoice_id}/issue`, but is otherwise the * same as [InvoiceService.issue]. */ - @JvmOverloads + @MustBeClosed + fun issue(params: InvoiceIssueParams): HttpResponseFor = + issue(params, RequestOptions.none()) + + /** @see [issue] */ @MustBeClosed fun issue( params: InvoiceIssueParams, @@ -234,7 +270,11 @@ interface InvoiceService { * Returns a raw HTTP response for `post /invoices/{invoice_id}/mark_paid`, but is otherwise * the same as [InvoiceService.markPaid]. */ - @JvmOverloads + @MustBeClosed + fun markPaid(params: InvoiceMarkPaidParams): HttpResponseFor = + markPaid(params, RequestOptions.none()) + + /** @see [markPaid] */ @MustBeClosed fun markPaid( params: InvoiceMarkPaidParams, @@ -245,7 +285,11 @@ interface InvoiceService { * Returns a raw HTTP response for `post /invoices/{invoice_id}/pay`, but is otherwise the * same as [InvoiceService.pay]. */ - @JvmOverloads + @MustBeClosed + fun pay(params: InvoicePayParams): HttpResponseFor = + pay(params, RequestOptions.none()) + + /** @see [pay] */ @MustBeClosed fun pay( params: InvoicePayParams, @@ -256,7 +300,11 @@ interface InvoiceService { * Returns a raw HTTP response for `post /invoices/{invoice_id}/void`, but is otherwise the * same as [InvoiceService.voidInvoice]. */ - @JvmOverloads + @MustBeClosed + fun voidInvoice(params: InvoiceVoidInvoiceParams): HttpResponseFor = + voidInvoice(params, RequestOptions.none()) + + /** @see [voidInvoice] */ @MustBeClosed fun voidInvoice( params: InvoiceVoidInvoiceParams, diff --git a/orb-java-core/src/main/kotlin/com/withorb/api/services/blocking/ItemService.kt b/orb-java-core/src/main/kotlin/com/withorb/api/services/blocking/ItemService.kt index 0eeb19d7..df39426f 100644 --- a/orb-java-core/src/main/kotlin/com/withorb/api/services/blocking/ItemService.kt +++ b/orb-java-core/src/main/kotlin/com/withorb/api/services/blocking/ItemService.kt @@ -1,7 +1,5 @@ // File generated from our OpenAPI spec by Stainless. -@file:Suppress("OVERLOADS_INTERFACE") // See https://youtrack.jetbrains.com/issue/KT-36102 - package com.withorb.api.services.blocking import com.google.errorprone.annotations.MustBeClosed @@ -22,32 +20,44 @@ interface ItemService { fun withRawResponse(): WithRawResponse /** This endpoint is used to create an [Item](/core-concepts#item). */ - @JvmOverloads + fun create(params: ItemCreateParams): Item = create(params, RequestOptions.none()) + + /** @see [create] */ fun create( params: ItemCreateParams, requestOptions: RequestOptions = RequestOptions.none(), ): Item /** This endpoint can be used to update properties on the Item. */ - @JvmOverloads + fun update(params: ItemUpdateParams): Item = update(params, RequestOptions.none()) + + /** @see [update] */ fun update( params: ItemUpdateParams, requestOptions: RequestOptions = RequestOptions.none(), ): Item /** This endpoint returns a list of all Items, ordered in descending order by creation time. */ - @JvmOverloads + fun list(): ItemListPage = list(ItemListParams.none()) + + /** @see [list] */ fun list( params: ItemListParams = ItemListParams.none(), requestOptions: RequestOptions = RequestOptions.none(), ): ItemListPage - /** This endpoint returns a list of all Items, ordered in descending order by creation time. */ + /** @see [list] */ + fun list(params: ItemListParams = ItemListParams.none()): ItemListPage = + list(params, RequestOptions.none()) + + /** @see [list] */ fun list(requestOptions: RequestOptions): ItemListPage = list(ItemListParams.none(), requestOptions) /** This endpoint returns an item identified by its item_id. */ - @JvmOverloads + fun fetch(params: ItemFetchParams): Item = fetch(params, RequestOptions.none()) + + /** @see [fetch] */ fun fetch(params: ItemFetchParams, requestOptions: RequestOptions = RequestOptions.none()): Item /** A view of [ItemService] that provides access to raw HTTP responses for each method. */ @@ -57,7 +67,11 @@ interface ItemService { * Returns a raw HTTP response for `post /items`, but is otherwise the same as * [ItemService.create]. */ - @JvmOverloads + @MustBeClosed + fun create(params: ItemCreateParams): HttpResponseFor = + create(params, RequestOptions.none()) + + /** @see [create] */ @MustBeClosed fun create( params: ItemCreateParams, @@ -68,7 +82,11 @@ interface ItemService { * Returns a raw HTTP response for `put /items/{item_id}`, but is otherwise the same as * [ItemService.update]. */ - @JvmOverloads + @MustBeClosed + fun update(params: ItemUpdateParams): HttpResponseFor = + update(params, RequestOptions.none()) + + /** @see [update] */ @MustBeClosed fun update( params: ItemUpdateParams, @@ -79,17 +97,21 @@ interface ItemService { * Returns a raw HTTP response for `get /items`, but is otherwise the same as * [ItemService.list]. */ - @JvmOverloads + @MustBeClosed fun list(): HttpResponseFor = list(ItemListParams.none()) + + /** @see [list] */ @MustBeClosed fun list( params: ItemListParams = ItemListParams.none(), requestOptions: RequestOptions = RequestOptions.none(), ): HttpResponseFor - /** - * Returns a raw HTTP response for `get /items`, but is otherwise the same as - * [ItemService.list]. - */ + /** @see [list] */ + @MustBeClosed + fun list(params: ItemListParams = ItemListParams.none()): HttpResponseFor = + list(params, RequestOptions.none()) + + /** @see [list] */ @MustBeClosed fun list(requestOptions: RequestOptions): HttpResponseFor = list(ItemListParams.none(), requestOptions) @@ -98,7 +120,11 @@ interface ItemService { * Returns a raw HTTP response for `get /items/{item_id}`, but is otherwise the same as * [ItemService.fetch]. */ - @JvmOverloads + @MustBeClosed + fun fetch(params: ItemFetchParams): HttpResponseFor = + fetch(params, RequestOptions.none()) + + /** @see [fetch] */ @MustBeClosed fun fetch( params: ItemFetchParams, diff --git a/orb-java-core/src/main/kotlin/com/withorb/api/services/blocking/MetricService.kt b/orb-java-core/src/main/kotlin/com/withorb/api/services/blocking/MetricService.kt index c5453e7c..9042fb36 100644 --- a/orb-java-core/src/main/kotlin/com/withorb/api/services/blocking/MetricService.kt +++ b/orb-java-core/src/main/kotlin/com/withorb/api/services/blocking/MetricService.kt @@ -1,7 +1,5 @@ // File generated from our OpenAPI spec by Stainless. -@file:Suppress("OVERLOADS_INTERFACE") // See https://youtrack.jetbrains.com/issue/KT-36102 - package com.withorb.api.services.blocking import com.google.errorprone.annotations.MustBeClosed @@ -26,7 +24,9 @@ interface MetricService { * [SQL support](/extensibility/advanced-metrics#sql-support) for a description of constructing * SQL queries with examples. */ - @JvmOverloads + fun create(params: MetricCreateParams): BillableMetric = create(params, RequestOptions.none()) + + /** @see [create] */ fun create( params: MetricCreateParams, requestOptions: RequestOptions = RequestOptions.none(), @@ -36,7 +36,9 @@ interface MetricService { * This endpoint allows you to update the `metadata` property on a metric. If you pass `null` * for the metadata value, it will clear any existing metadata for that invoice. */ - @JvmOverloads + fun update(params: MetricUpdateParams): BillableMetric = update(params, RequestOptions.none()) + + /** @see [update] */ fun update( params: MetricUpdateParams, requestOptions: RequestOptions = RequestOptions.none(), @@ -47,17 +49,19 @@ interface MetricService { * identifier. It returns information about the metrics including its name, description, and * item. */ - @JvmOverloads + fun list(): MetricListPage = list(MetricListParams.none()) + + /** @see [list] */ fun list( params: MetricListParams = MetricListParams.none(), requestOptions: RequestOptions = RequestOptions.none(), ): MetricListPage - /** - * This endpoint is used to fetch [metric](/core-concepts##metric) details given a metric - * identifier. It returns information about the metrics including its name, description, and - * item. - */ + /** @see [list] */ + fun list(params: MetricListParams = MetricListParams.none()): MetricListPage = + list(params, RequestOptions.none()) + + /** @see [list] */ fun list(requestOptions: RequestOptions): MetricListPage = list(MetricListParams.none(), requestOptions) @@ -65,7 +69,9 @@ interface MetricService { * This endpoint is used to list [metrics](/core-concepts#metric). It returns information about * the metrics including its name, description, and item. */ - @JvmOverloads + fun fetch(params: MetricFetchParams): BillableMetric = fetch(params, RequestOptions.none()) + + /** @see [fetch] */ fun fetch( params: MetricFetchParams, requestOptions: RequestOptions = RequestOptions.none(), @@ -78,7 +84,11 @@ interface MetricService { * Returns a raw HTTP response for `post /metrics`, but is otherwise the same as * [MetricService.create]. */ - @JvmOverloads + @MustBeClosed + fun create(params: MetricCreateParams): HttpResponseFor = + create(params, RequestOptions.none()) + + /** @see [create] */ @MustBeClosed fun create( params: MetricCreateParams, @@ -89,7 +99,11 @@ interface MetricService { * Returns a raw HTTP response for `put /metrics/{metric_id}`, but is otherwise the same as * [MetricService.update]. */ - @JvmOverloads + @MustBeClosed + fun update(params: MetricUpdateParams): HttpResponseFor = + update(params, RequestOptions.none()) + + /** @see [update] */ @MustBeClosed fun update( params: MetricUpdateParams, @@ -100,17 +114,22 @@ interface MetricService { * Returns a raw HTTP response for `get /metrics`, but is otherwise the same as * [MetricService.list]. */ - @JvmOverloads + @MustBeClosed fun list(): HttpResponseFor = list(MetricListParams.none()) + + /** @see [list] */ @MustBeClosed fun list( params: MetricListParams = MetricListParams.none(), requestOptions: RequestOptions = RequestOptions.none(), ): HttpResponseFor - /** - * Returns a raw HTTP response for `get /metrics`, but is otherwise the same as - * [MetricService.list]. - */ + /** @see [list] */ + @MustBeClosed + fun list( + params: MetricListParams = MetricListParams.none() + ): HttpResponseFor = list(params, RequestOptions.none()) + + /** @see [list] */ @MustBeClosed fun list(requestOptions: RequestOptions): HttpResponseFor = list(MetricListParams.none(), requestOptions) @@ -119,7 +138,11 @@ interface MetricService { * Returns a raw HTTP response for `get /metrics/{metric_id}`, but is otherwise the same as * [MetricService.fetch]. */ - @JvmOverloads + @MustBeClosed + fun fetch(params: MetricFetchParams): HttpResponseFor = + fetch(params, RequestOptions.none()) + + /** @see [fetch] */ @MustBeClosed fun fetch( params: MetricFetchParams, diff --git a/orb-java-core/src/main/kotlin/com/withorb/api/services/blocking/PlanService.kt b/orb-java-core/src/main/kotlin/com/withorb/api/services/blocking/PlanService.kt index c2f18988..95f39fad 100644 --- a/orb-java-core/src/main/kotlin/com/withorb/api/services/blocking/PlanService.kt +++ b/orb-java-core/src/main/kotlin/com/withorb/api/services/blocking/PlanService.kt @@ -1,7 +1,5 @@ // File generated from our OpenAPI spec by Stainless. -@file:Suppress("OVERLOADS_INTERFACE") // See https://youtrack.jetbrains.com/issue/KT-36102 - package com.withorb.api.services.blocking import com.google.errorprone.annotations.MustBeClosed @@ -25,7 +23,9 @@ interface PlanService { fun externalPlanId(): ExternalPlanIdService /** This endpoint allows creation of plans including their prices. */ - @JvmOverloads + fun create(params: PlanCreateParams): Plan = create(params, RequestOptions.none()) + + /** @see [create] */ fun create( params: PlanCreateParams, requestOptions: RequestOptions = RequestOptions.none(), @@ -37,7 +37,9 @@ interface PlanService { * * Other fields on a customer are currently immutable. */ - @JvmOverloads + fun update(params: PlanUpdateParams): Plan = update(params, RequestOptions.none()) + + /** @see [update] */ fun update( params: PlanUpdateParams, requestOptions: RequestOptions = RequestOptions.none(), @@ -49,18 +51,19 @@ interface PlanService { * response also includes [`pagination_metadata`](/api-reference/pagination), which lets the * caller retrieve the next page of results if they exist. */ - @JvmOverloads + fun list(): PlanListPage = list(PlanListParams.none()) + + /** @see [list] */ fun list( params: PlanListParams = PlanListParams.none(), requestOptions: RequestOptions = RequestOptions.none(), ): PlanListPage - /** - * This endpoint returns a list of all [plans](/core-concepts#plan-and-price) for an account in - * a list format. The list of plans is ordered starting from the most recently created plan. The - * response also includes [`pagination_metadata`](/api-reference/pagination), which lets the - * caller retrieve the next page of results if they exist. - */ + /** @see [list] */ + fun list(params: PlanListParams = PlanListParams.none()): PlanListPage = + list(params, RequestOptions.none()) + + /** @see [list] */ fun list(requestOptions: RequestOptions): PlanListPage = list(PlanListParams.none(), requestOptions) @@ -82,7 +85,9 @@ interface PlanService { * Orb supports plan phases, also known as contract ramps. For plans with phases, the serialized * prices refer to all prices across all phases. */ - @JvmOverloads + fun fetch(params: PlanFetchParams): Plan = fetch(params, RequestOptions.none()) + + /** @see [fetch] */ fun fetch(params: PlanFetchParams, requestOptions: RequestOptions = RequestOptions.none()): Plan /** A view of [PlanService] that provides access to raw HTTP responses for each method. */ @@ -94,7 +99,11 @@ interface PlanService { * Returns a raw HTTP response for `post /plans`, but is otherwise the same as * [PlanService.create]. */ - @JvmOverloads + @MustBeClosed + fun create(params: PlanCreateParams): HttpResponseFor = + create(params, RequestOptions.none()) + + /** @see [create] */ @MustBeClosed fun create( params: PlanCreateParams, @@ -105,7 +114,11 @@ interface PlanService { * Returns a raw HTTP response for `put /plans/{plan_id}`, but is otherwise the same as * [PlanService.update]. */ - @JvmOverloads + @MustBeClosed + fun update(params: PlanUpdateParams): HttpResponseFor = + update(params, RequestOptions.none()) + + /** @see [update] */ @MustBeClosed fun update( params: PlanUpdateParams, @@ -116,17 +129,21 @@ interface PlanService { * Returns a raw HTTP response for `get /plans`, but is otherwise the same as * [PlanService.list]. */ - @JvmOverloads + @MustBeClosed fun list(): HttpResponseFor = list(PlanListParams.none()) + + /** @see [list] */ @MustBeClosed fun list( params: PlanListParams = PlanListParams.none(), requestOptions: RequestOptions = RequestOptions.none(), ): HttpResponseFor - /** - * Returns a raw HTTP response for `get /plans`, but is otherwise the same as - * [PlanService.list]. - */ + /** @see [list] */ + @MustBeClosed + fun list(params: PlanListParams = PlanListParams.none()): HttpResponseFor = + list(params, RequestOptions.none()) + + /** @see [list] */ @MustBeClosed fun list(requestOptions: RequestOptions): HttpResponseFor = list(PlanListParams.none(), requestOptions) @@ -135,7 +152,11 @@ interface PlanService { * Returns a raw HTTP response for `get /plans/{plan_id}`, but is otherwise the same as * [PlanService.fetch]. */ - @JvmOverloads + @MustBeClosed + fun fetch(params: PlanFetchParams): HttpResponseFor = + fetch(params, RequestOptions.none()) + + /** @see [fetch] */ @MustBeClosed fun fetch( params: PlanFetchParams, diff --git a/orb-java-core/src/main/kotlin/com/withorb/api/services/blocking/PriceService.kt b/orb-java-core/src/main/kotlin/com/withorb/api/services/blocking/PriceService.kt index fd7423cd..1648965a 100644 --- a/orb-java-core/src/main/kotlin/com/withorb/api/services/blocking/PriceService.kt +++ b/orb-java-core/src/main/kotlin/com/withorb/api/services/blocking/PriceService.kt @@ -1,7 +1,5 @@ // File generated from our OpenAPI spec by Stainless. -@file:Suppress("OVERLOADS_INTERFACE") // See https://youtrack.jetbrains.com/issue/KT-36102 - package com.withorb.api.services.blocking import com.google.errorprone.annotations.MustBeClosed @@ -38,7 +36,9 @@ interface PriceService { * See the [Price resource](/product-catalog/price-configuration) for the specification of * different price model configurations possible in this endpoint. */ - @JvmOverloads + fun create(params: PriceCreateParams): Price = create(params, RequestOptions.none()) + + /** @see [create] */ fun create( params: PriceCreateParams, requestOptions: RequestOptions = RequestOptions.none(), @@ -48,7 +48,9 @@ interface PriceService { * This endpoint allows you to update the `metadata` property on a price. If you pass null for * the metadata value, it will clear any existing metadata for that price. */ - @JvmOverloads + fun update(params: PriceUpdateParams): Price = update(params, RequestOptions.none()) + + /** @see [update] */ fun update( params: PriceUpdateParams, requestOptions: RequestOptions = RequestOptions.none(), @@ -58,16 +60,19 @@ interface PriceService { * This endpoint is used to list all add-on prices created using the * [price creation endpoint](/api-reference/price/create-price). */ - @JvmOverloads + fun list(): PriceListPage = list(PriceListParams.none()) + + /** @see [list] */ fun list( params: PriceListParams = PriceListParams.none(), requestOptions: RequestOptions = RequestOptions.none(), ): PriceListPage - /** - * This endpoint is used to list all add-on prices created using the - * [price creation endpoint](/api-reference/price/create-price). - */ + /** @see [list] */ + fun list(params: PriceListParams = PriceListParams.none()): PriceListPage = + list(params, RequestOptions.none()) + + /** @see [list] */ fun list(requestOptions: RequestOptions): PriceListPage = list(PriceListParams.none(), requestOptions) @@ -90,14 +95,19 @@ interface PriceService { * the results must be no greater than 1000. Note that this is a POST endpoint rather than a GET * endpoint because it employs a JSON body rather than query parameters. */ - @JvmOverloads + fun evaluate(params: PriceEvaluateParams): PriceEvaluateResponse = + evaluate(params, RequestOptions.none()) + + /** @see [evaluate] */ fun evaluate( params: PriceEvaluateParams, requestOptions: RequestOptions = RequestOptions.none(), ): PriceEvaluateResponse /** This endpoint returns a price given an identifier. */ - @JvmOverloads + fun fetch(params: PriceFetchParams): Price = fetch(params, RequestOptions.none()) + + /** @see [fetch] */ fun fetch( params: PriceFetchParams, requestOptions: RequestOptions = RequestOptions.none(), @@ -112,7 +122,11 @@ interface PriceService { * Returns a raw HTTP response for `post /prices`, but is otherwise the same as * [PriceService.create]. */ - @JvmOverloads + @MustBeClosed + fun create(params: PriceCreateParams): HttpResponseFor = + create(params, RequestOptions.none()) + + /** @see [create] */ @MustBeClosed fun create( params: PriceCreateParams, @@ -123,7 +137,11 @@ interface PriceService { * Returns a raw HTTP response for `put /prices/{price_id}`, but is otherwise the same as * [PriceService.update]. */ - @JvmOverloads + @MustBeClosed + fun update(params: PriceUpdateParams): HttpResponseFor = + update(params, RequestOptions.none()) + + /** @see [update] */ @MustBeClosed fun update( params: PriceUpdateParams, @@ -134,17 +152,21 @@ interface PriceService { * Returns a raw HTTP response for `get /prices`, but is otherwise the same as * [PriceService.list]. */ - @JvmOverloads + @MustBeClosed fun list(): HttpResponseFor = list(PriceListParams.none()) + + /** @see [list] */ @MustBeClosed fun list( params: PriceListParams = PriceListParams.none(), requestOptions: RequestOptions = RequestOptions.none(), ): HttpResponseFor - /** - * Returns a raw HTTP response for `get /prices`, but is otherwise the same as - * [PriceService.list]. - */ + /** @see [list] */ + @MustBeClosed + fun list(params: PriceListParams = PriceListParams.none()): HttpResponseFor = + list(params, RequestOptions.none()) + + /** @see [list] */ @MustBeClosed fun list(requestOptions: RequestOptions): HttpResponseFor = list(PriceListParams.none(), requestOptions) @@ -153,7 +175,11 @@ interface PriceService { * Returns a raw HTTP response for `post /prices/{price_id}/evaluate`, but is otherwise the * same as [PriceService.evaluate]. */ - @JvmOverloads + @MustBeClosed + fun evaluate(params: PriceEvaluateParams): HttpResponseFor = + evaluate(params, RequestOptions.none()) + + /** @see [evaluate] */ @MustBeClosed fun evaluate( params: PriceEvaluateParams, @@ -164,7 +190,11 @@ interface PriceService { * Returns a raw HTTP response for `get /prices/{price_id}`, but is otherwise the same as * [PriceService.fetch]. */ - @JvmOverloads + @MustBeClosed + fun fetch(params: PriceFetchParams): HttpResponseFor = + fetch(params, RequestOptions.none()) + + /** @see [fetch] */ @MustBeClosed fun fetch( params: PriceFetchParams, diff --git a/orb-java-core/src/main/kotlin/com/withorb/api/services/blocking/SubscriptionService.kt b/orb-java-core/src/main/kotlin/com/withorb/api/services/blocking/SubscriptionService.kt index 1d02a5f2..0944d2af 100644 --- a/orb-java-core/src/main/kotlin/com/withorb/api/services/blocking/SubscriptionService.kt +++ b/orb-java-core/src/main/kotlin/com/withorb/api/services/blocking/SubscriptionService.kt @@ -1,7 +1,5 @@ // File generated from our OpenAPI spec by Stainless. -@file:Suppress("OVERLOADS_INTERFACE") // See https://youtrack.jetbrains.com/issue/KT-36102 - package com.withorb.api.services.blocking import com.google.errorprone.annotations.MustBeClosed @@ -284,7 +282,10 @@ interface SubscriptionService { * subscription's invoicing currency, when creating a subscription. E.g. pass in `10.00` to * issue an invoice when usage amounts hit $10.00 for a subscription that invoices in USD. */ - @JvmOverloads + fun create(params: SubscriptionCreateParams): SubscriptionCreateResponse = + create(params, RequestOptions.none()) + + /** @see [create] */ fun create( params: SubscriptionCreateParams, requestOptions: RequestOptions = RequestOptions.none(), @@ -294,7 +295,10 @@ interface SubscriptionService { * This endpoint can be used to update the `metadata`, `net terms`, `auto_collection`, * `invoicing_threshold`, and `default_invoice_memo` properties on a subscription. */ - @JvmOverloads + fun update(params: SubscriptionUpdateParams): Subscription = + update(params, RequestOptions.none()) + + /** @see [update] */ fun update( params: SubscriptionUpdateParams, requestOptions: RequestOptions = RequestOptions.none(), @@ -310,22 +314,19 @@ interface SubscriptionService { * external_customer_id query parameters. To filter subscriptions for multiple customers, use * the customer_id[] or external_customer_id[] query parameters. */ - @JvmOverloads + fun list(): SubscriptionListPage = list(SubscriptionListParams.none()) + + /** @see [list] */ fun list( params: SubscriptionListParams = SubscriptionListParams.none(), requestOptions: RequestOptions = RequestOptions.none(), ): SubscriptionListPage - /** - * This endpoint returns a list of all subscriptions for an account as a - * [paginated](/api-reference/pagination) list, ordered starting from the most recently created - * subscription. For a full discussion of the subscription resource, see - * [Subscription](/core-concepts##subscription). - * - * Subscriptions can be filtered for a specific customer by using either the customer_id or - * external_customer_id query parameters. To filter subscriptions for multiple customers, use - * the customer_id[] or external_customer_id[] query parameters. - */ + /** @see [list] */ + fun list(params: SubscriptionListParams = SubscriptionListParams.none()): SubscriptionListPage = + list(params, RequestOptions.none()) + + /** @see [list] */ fun list(requestOptions: RequestOptions): SubscriptionListPage = list(SubscriptionListParams.none(), requestOptions) @@ -382,7 +383,10 @@ interface SubscriptionService { * invoice and generate a new one based on the new dates for the subscription. See the section * on [cancellation behaviors](/product-catalog/creating-subscriptions#cancellation-behaviors). */ - @JvmOverloads + fun cancel(params: SubscriptionCancelParams): SubscriptionCancelResponse = + cancel(params, RequestOptions.none()) + + /** @see [cancel] */ fun cancel( params: SubscriptionCancelParams, requestOptions: RequestOptions = RequestOptions.none(), @@ -392,7 +396,9 @@ interface SubscriptionService { * This endpoint is used to fetch a [Subscription](/core-concepts##subscription) given an * identifier. */ - @JvmOverloads + fun fetch(params: SubscriptionFetchParams): Subscription = fetch(params, RequestOptions.none()) + + /** @see [fetch] */ fun fetch( params: SubscriptionFetchParams, requestOptions: RequestOptions = RequestOptions.none(), @@ -409,7 +415,10 @@ interface SubscriptionService { * of costs to a specific subscription for the customer (e.g. to de-aggregate costs when a * customer's subscription has started and stopped on the same day). */ - @JvmOverloads + fun fetchCosts(params: SubscriptionFetchCostsParams): SubscriptionFetchCostsResponse = + fetchCosts(params, RequestOptions.none()) + + /** @see [fetchCosts] */ fun fetchCosts( params: SubscriptionFetchCostsParams, requestOptions: RequestOptions = RequestOptions.none(), @@ -420,7 +429,10 @@ interface SubscriptionService { * with a subscription along with their start and end dates. This list contains the * subscription's initial plan along with past and future plan changes. */ - @JvmOverloads + fun fetchSchedule(params: SubscriptionFetchScheduleParams): SubscriptionFetchSchedulePage = + fetchSchedule(params, RequestOptions.none()) + + /** @see [fetchSchedule] */ fun fetchSchedule( params: SubscriptionFetchScheduleParams, requestOptions: RequestOptions = RequestOptions.none(), @@ -603,7 +615,10 @@ interface SubscriptionService { * - `second_dimension_key`: `provider` * - `second_dimension_value`: `aws` */ - @JvmOverloads + fun fetchUsage(params: SubscriptionFetchUsageParams): SubscriptionUsage = + fetchUsage(params, RequestOptions.none()) + + /** @see [fetchUsage] */ fun fetchUsage( params: SubscriptionFetchUsageParams, requestOptions: RequestOptions = RequestOptions.none(), @@ -676,7 +691,11 @@ interface SubscriptionService { * using the `fixed_fee_quantity_transitions` property on a subscription’s serialized price * intervals. */ - @JvmOverloads + fun priceIntervals( + params: SubscriptionPriceIntervalsParams + ): SubscriptionPriceIntervalsResponse = priceIntervals(params, RequestOptions.none()) + + /** @see [priceIntervals] */ fun priceIntervals( params: SubscriptionPriceIntervalsParams, requestOptions: RequestOptions = RequestOptions.none(), @@ -848,7 +867,11 @@ interface SubscriptionService { * change, adjusting the customer balance as needed. For details on this behavior, see * [Modifying subscriptions](/product-catalog/modifying-subscriptions#prorations-for-in-advance-fees). */ - @JvmOverloads + fun schedulePlanChange( + params: SubscriptionSchedulePlanChangeParams + ): SubscriptionSchedulePlanChangeResponse = schedulePlanChange(params, RequestOptions.none()) + + /** @see [schedulePlanChange] */ fun schedulePlanChange( params: SubscriptionSchedulePlanChangeParams, requestOptions: RequestOptions = RequestOptions.none(), @@ -857,7 +880,10 @@ interface SubscriptionService { /** * Manually trigger a phase, effective the given date (or the current time, if not specified). */ - @JvmOverloads + fun triggerPhase(params: SubscriptionTriggerPhaseParams): SubscriptionTriggerPhaseResponse = + triggerPhase(params, RequestOptions.none()) + + /** @see [triggerPhase] */ fun triggerPhase( params: SubscriptionTriggerPhaseParams, requestOptions: RequestOptions = RequestOptions.none(), @@ -870,7 +896,12 @@ interface SubscriptionService { * This operation will turn on auto-renew, ensuring that the subscription does not end at the * currently scheduled cancellation time. */ - @JvmOverloads + fun unscheduleCancellation( + params: SubscriptionUnscheduleCancellationParams + ): SubscriptionUnscheduleCancellationResponse = + unscheduleCancellation(params, RequestOptions.none()) + + /** @see [unscheduleCancellation] */ fun unscheduleCancellation( params: SubscriptionUnscheduleCancellationParams, requestOptions: RequestOptions = RequestOptions.none(), @@ -882,7 +913,12 @@ interface SubscriptionService { * If there are no updates scheduled, a request validation error will be returned with a 400 * status code. */ - @JvmOverloads + fun unscheduleFixedFeeQuantityUpdates( + params: SubscriptionUnscheduleFixedFeeQuantityUpdatesParams + ): SubscriptionUnscheduleFixedFeeQuantityUpdatesResponse = + unscheduleFixedFeeQuantityUpdates(params, RequestOptions.none()) + + /** @see [unscheduleFixedFeeQuantityUpdates] */ fun unscheduleFixedFeeQuantityUpdates( params: SubscriptionUnscheduleFixedFeeQuantityUpdatesParams, requestOptions: RequestOptions = RequestOptions.none(), @@ -891,7 +927,12 @@ interface SubscriptionService { /** * This endpoint can be used to unschedule any pending plan changes on an existing subscription. */ - @JvmOverloads + fun unschedulePendingPlanChanges( + params: SubscriptionUnschedulePendingPlanChangesParams + ): SubscriptionUnschedulePendingPlanChangesResponse = + unschedulePendingPlanChanges(params, RequestOptions.none()) + + /** @see [unschedulePendingPlanChanges] */ fun unschedulePendingPlanChanges( params: SubscriptionUnschedulePendingPlanChangesParams, requestOptions: RequestOptions = RequestOptions.none(), @@ -911,7 +952,12 @@ interface SubscriptionService { * If the fee is an in-advance fixed fee, it will also issue an immediate invoice for the * difference for the remainder of the billing period. */ - @JvmOverloads + fun updateFixedFeeQuantity( + params: SubscriptionUpdateFixedFeeQuantityParams + ): SubscriptionUpdateFixedFeeQuantityResponse = + updateFixedFeeQuantity(params, RequestOptions.none()) + + /** @see [updateFixedFeeQuantity] */ fun updateFixedFeeQuantity( params: SubscriptionUpdateFixedFeeQuantityParams, requestOptions: RequestOptions = RequestOptions.none(), @@ -935,7 +981,10 @@ interface SubscriptionService { * scheduled or an add-on price was added, that change will be pushed back by the same amount of * time the trial is extended). */ - @JvmOverloads + fun updateTrial(params: SubscriptionUpdateTrialParams): SubscriptionUpdateTrialResponse = + updateTrial(params, RequestOptions.none()) + + /** @see [updateTrial] */ fun updateTrial( params: SubscriptionUpdateTrialParams, requestOptions: RequestOptions = RequestOptions.none(), @@ -950,7 +999,11 @@ interface SubscriptionService { * Returns a raw HTTP response for `post /subscriptions`, but is otherwise the same as * [SubscriptionService.create]. */ - @JvmOverloads + @MustBeClosed + fun create(params: SubscriptionCreateParams): HttpResponseFor = + create(params, RequestOptions.none()) + + /** @see [create] */ @MustBeClosed fun create( params: SubscriptionCreateParams, @@ -961,7 +1014,11 @@ interface SubscriptionService { * Returns a raw HTTP response for `put /subscriptions/{subscription_id}`, but is otherwise * the same as [SubscriptionService.update]. */ - @JvmOverloads + @MustBeClosed + fun update(params: SubscriptionUpdateParams): HttpResponseFor = + update(params, RequestOptions.none()) + + /** @see [update] */ @MustBeClosed fun update( params: SubscriptionUpdateParams, @@ -972,17 +1029,23 @@ interface SubscriptionService { * Returns a raw HTTP response for `get /subscriptions`, but is otherwise the same as * [SubscriptionService.list]. */ - @JvmOverloads + @MustBeClosed + fun list(): HttpResponseFor = list(SubscriptionListParams.none()) + + /** @see [list] */ @MustBeClosed fun list( params: SubscriptionListParams = SubscriptionListParams.none(), requestOptions: RequestOptions = RequestOptions.none(), ): HttpResponseFor - /** - * Returns a raw HTTP response for `get /subscriptions`, but is otherwise the same as - * [SubscriptionService.list]. - */ + /** @see [list] */ + @MustBeClosed + fun list( + params: SubscriptionListParams = SubscriptionListParams.none() + ): HttpResponseFor = list(params, RequestOptions.none()) + + /** @see [list] */ @MustBeClosed fun list(requestOptions: RequestOptions): HttpResponseFor = list(SubscriptionListParams.none(), requestOptions) @@ -991,7 +1054,11 @@ interface SubscriptionService { * Returns a raw HTTP response for `post /subscriptions/{subscription_id}/cancel`, but is * otherwise the same as [SubscriptionService.cancel]. */ - @JvmOverloads + @MustBeClosed + fun cancel(params: SubscriptionCancelParams): HttpResponseFor = + cancel(params, RequestOptions.none()) + + /** @see [cancel] */ @MustBeClosed fun cancel( params: SubscriptionCancelParams, @@ -1002,7 +1069,11 @@ interface SubscriptionService { * Returns a raw HTTP response for `get /subscriptions/{subscription_id}`, but is otherwise * the same as [SubscriptionService.fetch]. */ - @JvmOverloads + @MustBeClosed + fun fetch(params: SubscriptionFetchParams): HttpResponseFor = + fetch(params, RequestOptions.none()) + + /** @see [fetch] */ @MustBeClosed fun fetch( params: SubscriptionFetchParams, @@ -1013,7 +1084,13 @@ interface SubscriptionService { * Returns a raw HTTP response for `get /subscriptions/{subscription_id}/costs`, but is * otherwise the same as [SubscriptionService.fetchCosts]. */ - @JvmOverloads + @MustBeClosed + fun fetchCosts( + params: SubscriptionFetchCostsParams + ): HttpResponseFor = + fetchCosts(params, RequestOptions.none()) + + /** @see [fetchCosts] */ @MustBeClosed fun fetchCosts( params: SubscriptionFetchCostsParams, @@ -1024,7 +1101,13 @@ interface SubscriptionService { * Returns a raw HTTP response for `get /subscriptions/{subscription_id}/schedule`, but is * otherwise the same as [SubscriptionService.fetchSchedule]. */ - @JvmOverloads + @MustBeClosed + fun fetchSchedule( + params: SubscriptionFetchScheduleParams + ): HttpResponseFor = + fetchSchedule(params, RequestOptions.none()) + + /** @see [fetchSchedule] */ @MustBeClosed fun fetchSchedule( params: SubscriptionFetchScheduleParams, @@ -1035,7 +1118,11 @@ interface SubscriptionService { * Returns a raw HTTP response for `get /subscriptions/{subscription_id}/usage`, but is * otherwise the same as [SubscriptionService.fetchUsage]. */ - @JvmOverloads + @MustBeClosed + fun fetchUsage(params: SubscriptionFetchUsageParams): HttpResponseFor = + fetchUsage(params, RequestOptions.none()) + + /** @see [fetchUsage] */ @MustBeClosed fun fetchUsage( params: SubscriptionFetchUsageParams, @@ -1046,7 +1133,13 @@ interface SubscriptionService { * Returns a raw HTTP response for `post /subscriptions/{subscription_id}/price_intervals`, * but is otherwise the same as [SubscriptionService.priceIntervals]. */ - @JvmOverloads + @MustBeClosed + fun priceIntervals( + params: SubscriptionPriceIntervalsParams + ): HttpResponseFor = + priceIntervals(params, RequestOptions.none()) + + /** @see [priceIntervals] */ @MustBeClosed fun priceIntervals( params: SubscriptionPriceIntervalsParams, @@ -1058,7 +1151,13 @@ interface SubscriptionService { * /subscriptions/{subscription_id}/schedule_plan_change`, but is otherwise the same as * [SubscriptionService.schedulePlanChange]. */ - @JvmOverloads + @MustBeClosed + fun schedulePlanChange( + params: SubscriptionSchedulePlanChangeParams + ): HttpResponseFor = + schedulePlanChange(params, RequestOptions.none()) + + /** @see [schedulePlanChange] */ @MustBeClosed fun schedulePlanChange( params: SubscriptionSchedulePlanChangeParams, @@ -1069,7 +1168,13 @@ interface SubscriptionService { * Returns a raw HTTP response for `post /subscriptions/{subscription_id}/trigger_phase`, * but is otherwise the same as [SubscriptionService.triggerPhase]. */ - @JvmOverloads + @MustBeClosed + fun triggerPhase( + params: SubscriptionTriggerPhaseParams + ): HttpResponseFor = + triggerPhase(params, RequestOptions.none()) + + /** @see [triggerPhase] */ @MustBeClosed fun triggerPhase( params: SubscriptionTriggerPhaseParams, @@ -1081,7 +1186,13 @@ interface SubscriptionService { * /subscriptions/{subscription_id}/unschedule_cancellation`, but is otherwise the same as * [SubscriptionService.unscheduleCancellation]. */ - @JvmOverloads + @MustBeClosed + fun unscheduleCancellation( + params: SubscriptionUnscheduleCancellationParams + ): HttpResponseFor = + unscheduleCancellation(params, RequestOptions.none()) + + /** @see [unscheduleCancellation] */ @MustBeClosed fun unscheduleCancellation( params: SubscriptionUnscheduleCancellationParams, @@ -1093,7 +1204,13 @@ interface SubscriptionService { * /subscriptions/{subscription_id}/unschedule_fixed_fee_quantity_updates`, but is otherwise * the same as [SubscriptionService.unscheduleFixedFeeQuantityUpdates]. */ - @JvmOverloads + @MustBeClosed + fun unscheduleFixedFeeQuantityUpdates( + params: SubscriptionUnscheduleFixedFeeQuantityUpdatesParams + ): HttpResponseFor = + unscheduleFixedFeeQuantityUpdates(params, RequestOptions.none()) + + /** @see [unscheduleFixedFeeQuantityUpdates] */ @MustBeClosed fun unscheduleFixedFeeQuantityUpdates( params: SubscriptionUnscheduleFixedFeeQuantityUpdatesParams, @@ -1105,7 +1222,13 @@ interface SubscriptionService { * /subscriptions/{subscription_id}/unschedule_pending_plan_changes`, but is otherwise the * same as [SubscriptionService.unschedulePendingPlanChanges]. */ - @JvmOverloads + @MustBeClosed + fun unschedulePendingPlanChanges( + params: SubscriptionUnschedulePendingPlanChangesParams + ): HttpResponseFor = + unschedulePendingPlanChanges(params, RequestOptions.none()) + + /** @see [unschedulePendingPlanChanges] */ @MustBeClosed fun unschedulePendingPlanChanges( params: SubscriptionUnschedulePendingPlanChangesParams, @@ -1117,7 +1240,13 @@ interface SubscriptionService { * /subscriptions/{subscription_id}/update_fixed_fee_quantity`, but is otherwise the same as * [SubscriptionService.updateFixedFeeQuantity]. */ - @JvmOverloads + @MustBeClosed + fun updateFixedFeeQuantity( + params: SubscriptionUpdateFixedFeeQuantityParams + ): HttpResponseFor = + updateFixedFeeQuantity(params, RequestOptions.none()) + + /** @see [updateFixedFeeQuantity] */ @MustBeClosed fun updateFixedFeeQuantity( params: SubscriptionUpdateFixedFeeQuantityParams, @@ -1128,7 +1257,13 @@ interface SubscriptionService { * Returns a raw HTTP response for `post /subscriptions/{subscription_id}/update_trial`, but * is otherwise the same as [SubscriptionService.updateTrial]. */ - @JvmOverloads + @MustBeClosed + fun updateTrial( + params: SubscriptionUpdateTrialParams + ): HttpResponseFor = + updateTrial(params, RequestOptions.none()) + + /** @see [updateTrial] */ @MustBeClosed fun updateTrial( params: SubscriptionUpdateTrialParams, diff --git a/orb-java-core/src/main/kotlin/com/withorb/api/services/blocking/TopLevelService.kt b/orb-java-core/src/main/kotlin/com/withorb/api/services/blocking/TopLevelService.kt index 19e58815..ce992e00 100644 --- a/orb-java-core/src/main/kotlin/com/withorb/api/services/blocking/TopLevelService.kt +++ b/orb-java-core/src/main/kotlin/com/withorb/api/services/blocking/TopLevelService.kt @@ -1,7 +1,5 @@ // File generated from our OpenAPI spec by Stainless. -@file:Suppress("OVERLOADS_INTERFACE") // See https://youtrack.jetbrains.com/issue/KT-36102 - package com.withorb.api.services.blocking import com.google.errorprone.annotations.MustBeClosed @@ -25,20 +23,19 @@ interface TopLevelService { * * This API does not have any side-effects or return any Orb resources. */ - @JvmOverloads + fun ping(): TopLevelPingResponse = ping(TopLevelPingParams.none()) + + /** @see [ping] */ fun ping( params: TopLevelPingParams = TopLevelPingParams.none(), requestOptions: RequestOptions = RequestOptions.none(), ): TopLevelPingResponse - /** - * This endpoint allows you to test your connection to the Orb API and check the validity of - * your API key, passed in the Authorization header. This is particularly useful for checking - * that your environment is set up properly, and is a great choice for connectors and - * integrations. - * - * This API does not have any side-effects or return any Orb resources. - */ + /** @see [ping] */ + fun ping(params: TopLevelPingParams = TopLevelPingParams.none()): TopLevelPingResponse = + ping(params, RequestOptions.none()) + + /** @see [ping] */ fun ping(requestOptions: RequestOptions): TopLevelPingResponse = ping(TopLevelPingParams.none(), requestOptions) @@ -49,17 +46,23 @@ interface TopLevelService { * Returns a raw HTTP response for `get /ping`, but is otherwise the same as * [TopLevelService.ping]. */ - @JvmOverloads + @MustBeClosed + fun ping(): HttpResponseFor = ping(TopLevelPingParams.none()) + + /** @see [ping] */ @MustBeClosed fun ping( params: TopLevelPingParams = TopLevelPingParams.none(), requestOptions: RequestOptions = RequestOptions.none(), ): HttpResponseFor - /** - * Returns a raw HTTP response for `get /ping`, but is otherwise the same as - * [TopLevelService.ping]. - */ + /** @see [ping] */ + @MustBeClosed + fun ping( + params: TopLevelPingParams = TopLevelPingParams.none() + ): HttpResponseFor = ping(params, RequestOptions.none()) + + /** @see [ping] */ @MustBeClosed fun ping(requestOptions: RequestOptions): HttpResponseFor = ping(TopLevelPingParams.none(), requestOptions) diff --git a/orb-java-core/src/main/kotlin/com/withorb/api/services/blocking/coupons/SubscriptionService.kt b/orb-java-core/src/main/kotlin/com/withorb/api/services/blocking/coupons/SubscriptionService.kt index 56f58553..60beb8ac 100644 --- a/orb-java-core/src/main/kotlin/com/withorb/api/services/blocking/coupons/SubscriptionService.kt +++ b/orb-java-core/src/main/kotlin/com/withorb/api/services/blocking/coupons/SubscriptionService.kt @@ -1,7 +1,5 @@ // File generated from our OpenAPI spec by Stainless. -@file:Suppress("OVERLOADS_INTERFACE") // See https://youtrack.jetbrains.com/issue/KT-36102 - package com.withorb.api.services.blocking.coupons import com.google.errorprone.annotations.MustBeClosed @@ -23,7 +21,10 @@ interface SubscriptionService { * subscription. For a full discussion of the subscription resource, see * [Subscription](/core-concepts#subscription). */ - @JvmOverloads + fun list(params: CouponSubscriptionListParams): CouponSubscriptionListPage = + list(params, RequestOptions.none()) + + /** @see [list] */ fun list( params: CouponSubscriptionListParams, requestOptions: RequestOptions = RequestOptions.none(), @@ -38,7 +39,12 @@ interface SubscriptionService { * Returns a raw HTTP response for `get /coupons/{coupon_id}/subscriptions`, but is * otherwise the same as [SubscriptionService.list]. */ - @JvmOverloads + @MustBeClosed + fun list( + params: CouponSubscriptionListParams + ): HttpResponseFor = list(params, RequestOptions.none()) + + /** @see [list] */ @MustBeClosed fun list( params: CouponSubscriptionListParams, diff --git a/orb-java-core/src/main/kotlin/com/withorb/api/services/blocking/customers/BalanceTransactionService.kt b/orb-java-core/src/main/kotlin/com/withorb/api/services/blocking/customers/BalanceTransactionService.kt index 51afb307..58496cd0 100644 --- a/orb-java-core/src/main/kotlin/com/withorb/api/services/blocking/customers/BalanceTransactionService.kt +++ b/orb-java-core/src/main/kotlin/com/withorb/api/services/blocking/customers/BalanceTransactionService.kt @@ -1,7 +1,5 @@ // File generated from our OpenAPI spec by Stainless. -@file:Suppress("OVERLOADS_INTERFACE") // See https://youtrack.jetbrains.com/issue/KT-36102 - package com.withorb.api.services.blocking.customers import com.google.errorprone.annotations.MustBeClosed @@ -23,7 +21,11 @@ interface BalanceTransactionService { * Creates an immutable balance transaction that updates the customer's balance and returns back * the newly created transaction. */ - @JvmOverloads + fun create( + params: CustomerBalanceTransactionCreateParams + ): CustomerBalanceTransactionCreateResponse = create(params, RequestOptions.none()) + + /** @see [create] */ fun create( params: CustomerBalanceTransactionCreateParams, requestOptions: RequestOptions = RequestOptions.none(), @@ -56,7 +58,10 @@ interface BalanceTransactionService { * synced to a separate invoicing provider. If a payment gateway such as Stripe is used, the * balance will be applied to the invoice before forwarding payment to the gateway. */ - @JvmOverloads + fun list(params: CustomerBalanceTransactionListParams): CustomerBalanceTransactionListPage = + list(params, RequestOptions.none()) + + /** @see [list] */ fun list( params: CustomerBalanceTransactionListParams, requestOptions: RequestOptions = RequestOptions.none(), @@ -72,7 +77,13 @@ interface BalanceTransactionService { * Returns a raw HTTP response for `post /customers/{customer_id}/balance_transactions`, but * is otherwise the same as [BalanceTransactionService.create]. */ - @JvmOverloads + @MustBeClosed + fun create( + params: CustomerBalanceTransactionCreateParams + ): HttpResponseFor = + create(params, RequestOptions.none()) + + /** @see [create] */ @MustBeClosed fun create( params: CustomerBalanceTransactionCreateParams, @@ -83,7 +94,12 @@ interface BalanceTransactionService { * Returns a raw HTTP response for `get /customers/{customer_id}/balance_transactions`, but * is otherwise the same as [BalanceTransactionService.list]. */ - @JvmOverloads + @MustBeClosed + fun list( + params: CustomerBalanceTransactionListParams + ): HttpResponseFor = list(params, RequestOptions.none()) + + /** @see [list] */ @MustBeClosed fun list( params: CustomerBalanceTransactionListParams, diff --git a/orb-java-core/src/main/kotlin/com/withorb/api/services/blocking/customers/CostService.kt b/orb-java-core/src/main/kotlin/com/withorb/api/services/blocking/customers/CostService.kt index 64c0abdd..7a480744 100644 --- a/orb-java-core/src/main/kotlin/com/withorb/api/services/blocking/customers/CostService.kt +++ b/orb-java-core/src/main/kotlin/com/withorb/api/services/blocking/customers/CostService.kt @@ -1,7 +1,5 @@ // File generated from our OpenAPI spec by Stainless. -@file:Suppress("OVERLOADS_INTERFACE") // See https://youtrack.jetbrains.com/issue/KT-36102 - package com.withorb.api.services.blocking.customers import com.google.errorprone.annotations.MustBeClosed @@ -129,7 +127,10 @@ interface CostService { * `secondary_grouping_key` based on the matrix price definition, for each `grouping_value` and * `secondary_grouping_value` available. */ - @JvmOverloads + fun list(params: CustomerCostListParams): CustomerCostListResponse = + list(params, RequestOptions.none()) + + /** @see [list] */ fun list( params: CustomerCostListParams, requestOptions: RequestOptions = RequestOptions.none(), @@ -245,7 +246,11 @@ interface CostService { * `secondary_grouping_key` based on the matrix price definition, for each `grouping_value` and * `secondary_grouping_value` available. */ - @JvmOverloads + fun listByExternalId( + params: CustomerCostListByExternalIdParams + ): CustomerCostListByExternalIdResponse = listByExternalId(params, RequestOptions.none()) + + /** @see [listByExternalId] */ fun listByExternalId( params: CustomerCostListByExternalIdParams, requestOptions: RequestOptions = RequestOptions.none(), @@ -258,7 +263,11 @@ interface CostService { * Returns a raw HTTP response for `get /customers/{customer_id}/costs`, but is otherwise * the same as [CostService.list]. */ - @JvmOverloads + @MustBeClosed + fun list(params: CustomerCostListParams): HttpResponseFor = + list(params, RequestOptions.none()) + + /** @see [list] */ @MustBeClosed fun list( params: CustomerCostListParams, @@ -270,7 +279,13 @@ interface CostService { * /customers/external_customer_id/{external_customer_id}/costs`, but is otherwise the same * as [CostService.listByExternalId]. */ - @JvmOverloads + @MustBeClosed + fun listByExternalId( + params: CustomerCostListByExternalIdParams + ): HttpResponseFor = + listByExternalId(params, RequestOptions.none()) + + /** @see [listByExternalId] */ @MustBeClosed fun listByExternalId( params: CustomerCostListByExternalIdParams, diff --git a/orb-java-core/src/main/kotlin/com/withorb/api/services/blocking/customers/CreditService.kt b/orb-java-core/src/main/kotlin/com/withorb/api/services/blocking/customers/CreditService.kt index 1f6fdeb2..9d6638e1 100644 --- a/orb-java-core/src/main/kotlin/com/withorb/api/services/blocking/customers/CreditService.kt +++ b/orb-java-core/src/main/kotlin/com/withorb/api/services/blocking/customers/CreditService.kt @@ -1,7 +1,5 @@ // File generated from our OpenAPI spec by Stainless. -@file:Suppress("OVERLOADS_INTERFACE") // See https://youtrack.jetbrains.com/issue/KT-36102 - package com.withorb.api.services.blocking.customers import com.google.errorprone.annotations.MustBeClosed @@ -34,7 +32,10 @@ interface CreditService { * Note that `currency` defaults to credits if not specified. To use a real world currency, set * `currency` to an ISO 4217 string. */ - @JvmOverloads + fun list(params: CustomerCreditListParams): CustomerCreditListPage = + list(params, RequestOptions.none()) + + /** @see [list] */ fun list( params: CustomerCreditListParams, requestOptions: RequestOptions = RequestOptions.none(), @@ -49,7 +50,11 @@ interface CreditService { * Note that `currency` defaults to credits if not specified. To use a real world currency, set * `currency` to an ISO 4217 string. */ - @JvmOverloads + fun listByExternalId( + params: CustomerCreditListByExternalIdParams + ): CustomerCreditListByExternalIdPage = listByExternalId(params, RequestOptions.none()) + + /** @see [listByExternalId] */ fun listByExternalId( params: CustomerCreditListByExternalIdParams, requestOptions: RequestOptions = RequestOptions.none(), @@ -66,7 +71,11 @@ interface CreditService { * Returns a raw HTTP response for `get /customers/{customer_id}/credits`, but is otherwise * the same as [CreditService.list]. */ - @JvmOverloads + @MustBeClosed + fun list(params: CustomerCreditListParams): HttpResponseFor = + list(params, RequestOptions.none()) + + /** @see [list] */ @MustBeClosed fun list( params: CustomerCreditListParams, @@ -78,7 +87,13 @@ interface CreditService { * /customers/external_customer_id/{external_customer_id}/credits`, but is otherwise the * same as [CreditService.listByExternalId]. */ - @JvmOverloads + @MustBeClosed + fun listByExternalId( + params: CustomerCreditListByExternalIdParams + ): HttpResponseFor = + listByExternalId(params, RequestOptions.none()) + + /** @see [listByExternalId] */ @MustBeClosed fun listByExternalId( params: CustomerCreditListByExternalIdParams, diff --git a/orb-java-core/src/main/kotlin/com/withorb/api/services/blocking/customers/credits/LedgerService.kt b/orb-java-core/src/main/kotlin/com/withorb/api/services/blocking/customers/credits/LedgerService.kt index 5e925e4a..27473ba1 100644 --- a/orb-java-core/src/main/kotlin/com/withorb/api/services/blocking/customers/credits/LedgerService.kt +++ b/orb-java-core/src/main/kotlin/com/withorb/api/services/blocking/customers/credits/LedgerService.kt @@ -1,7 +1,5 @@ // File generated from our OpenAPI spec by Stainless. -@file:Suppress("OVERLOADS_INTERFACE") // See https://youtrack.jetbrains.com/issue/KT-36102 - package com.withorb.api.services.blocking.customers.credits import com.google.errorprone.annotations.MustBeClosed @@ -102,7 +100,10 @@ interface LedgerService { * When credits are added to a customer's balance as a result of a correction, this entry will * be added to the ledger to indicate the adjustment of credits. */ - @JvmOverloads + fun list(params: CustomerCreditLedgerListParams): CustomerCreditLedgerListPage = + list(params, RequestOptions.none()) + + /** @see [list] */ fun list( params: CustomerCreditLedgerListParams, requestOptions: RequestOptions = RequestOptions.none(), @@ -211,7 +212,11 @@ interface LedgerService { * decremented from, and `amount` indicates how many credits to return to the customer, up to * the block's initial balance. */ - @JvmOverloads + fun createEntry( + params: CustomerCreditLedgerCreateEntryParams + ): CustomerCreditLedgerCreateEntryResponse = createEntry(params, RequestOptions.none()) + + /** @see [createEntry] */ fun createEntry( params: CustomerCreditLedgerCreateEntryParams, requestOptions: RequestOptions = RequestOptions.none(), @@ -320,7 +325,12 @@ interface LedgerService { * decremented from, and `amount` indicates how many credits to return to the customer, up to * the block's initial balance. */ - @JvmOverloads + fun createEntryByExternalId( + params: CustomerCreditLedgerCreateEntryByExternalIdParams + ): CustomerCreditLedgerCreateEntryByExternalIdResponse = + createEntryByExternalId(params, RequestOptions.none()) + + /** @see [createEntryByExternalId] */ fun createEntryByExternalId( params: CustomerCreditLedgerCreateEntryByExternalIdParams, requestOptions: RequestOptions = RequestOptions.none(), @@ -405,7 +415,11 @@ interface LedgerService { * When credits are added to a customer's balance as a result of a correction, this entry will * be added to the ledger to indicate the adjustment of credits. */ - @JvmOverloads + fun listByExternalId( + params: CustomerCreditLedgerListByExternalIdParams + ): CustomerCreditLedgerListByExternalIdPage = listByExternalId(params, RequestOptions.none()) + + /** @see [listByExternalId] */ fun listByExternalId( params: CustomerCreditLedgerListByExternalIdParams, requestOptions: RequestOptions = RequestOptions.none(), @@ -418,7 +432,12 @@ interface LedgerService { * Returns a raw HTTP response for `get /customers/{customer_id}/credits/ledger`, but is * otherwise the same as [LedgerService.list]. */ - @JvmOverloads + @MustBeClosed + fun list( + params: CustomerCreditLedgerListParams + ): HttpResponseFor = list(params, RequestOptions.none()) + + /** @see [list] */ @MustBeClosed fun list( params: CustomerCreditLedgerListParams, @@ -429,7 +448,13 @@ interface LedgerService { * Returns a raw HTTP response for `post /customers/{customer_id}/credits/ledger_entry`, but * is otherwise the same as [LedgerService.createEntry]. */ - @JvmOverloads + @MustBeClosed + fun createEntry( + params: CustomerCreditLedgerCreateEntryParams + ): HttpResponseFor = + createEntry(params, RequestOptions.none()) + + /** @see [createEntry] */ @MustBeClosed fun createEntry( params: CustomerCreditLedgerCreateEntryParams, @@ -441,7 +466,13 @@ interface LedgerService { * /customers/external_customer_id/{external_customer_id}/credits/ledger_entry`, but is * otherwise the same as [LedgerService.createEntryByExternalId]. */ - @JvmOverloads + @MustBeClosed + fun createEntryByExternalId( + params: CustomerCreditLedgerCreateEntryByExternalIdParams + ): HttpResponseFor = + createEntryByExternalId(params, RequestOptions.none()) + + /** @see [createEntryByExternalId] */ @MustBeClosed fun createEntryByExternalId( params: CustomerCreditLedgerCreateEntryByExternalIdParams, @@ -453,7 +484,13 @@ interface LedgerService { * /customers/external_customer_id/{external_customer_id}/credits/ledger`, but is otherwise * the same as [LedgerService.listByExternalId]. */ - @JvmOverloads + @MustBeClosed + fun listByExternalId( + params: CustomerCreditLedgerListByExternalIdParams + ): HttpResponseFor = + listByExternalId(params, RequestOptions.none()) + + /** @see [listByExternalId] */ @MustBeClosed fun listByExternalId( params: CustomerCreditLedgerListByExternalIdParams, diff --git a/orb-java-core/src/main/kotlin/com/withorb/api/services/blocking/customers/credits/TopUpService.kt b/orb-java-core/src/main/kotlin/com/withorb/api/services/blocking/customers/credits/TopUpService.kt index 07ae3198..6714d22a 100644 --- a/orb-java-core/src/main/kotlin/com/withorb/api/services/blocking/customers/credits/TopUpService.kt +++ b/orb-java-core/src/main/kotlin/com/withorb/api/services/blocking/customers/credits/TopUpService.kt @@ -1,7 +1,5 @@ // File generated from our OpenAPI spec by Stainless. -@file:Suppress("OVERLOADS_INTERFACE") // See https://youtrack.jetbrains.com/issue/KT-36102 - package com.withorb.api.services.blocking.customers.credits import com.google.errorprone.annotations.MustBeClosed @@ -34,14 +32,20 @@ interface TopUpService { * If a top-up already exists for this customer in the same currency, the existing top-up will * be replaced. */ - @JvmOverloads + fun create(params: CustomerCreditTopUpCreateParams): CustomerCreditTopUpCreateResponse = + create(params, RequestOptions.none()) + + /** @see [create] */ fun create( params: CustomerCreditTopUpCreateParams, requestOptions: RequestOptions = RequestOptions.none(), ): CustomerCreditTopUpCreateResponse /** List top-ups */ - @JvmOverloads + fun list(params: CustomerCreditTopUpListParams): CustomerCreditTopUpListPage = + list(params, RequestOptions.none()) + + /** @see [list] */ fun list( params: CustomerCreditTopUpListParams, requestOptions: RequestOptions = RequestOptions.none(), @@ -51,7 +55,9 @@ interface TopUpService { * This deactivates the top-up and voids any invoices associated with pending credit blocks * purchased through the top-up. */ - @JvmOverloads + fun delete(params: CustomerCreditTopUpDeleteParams) = delete(params, RequestOptions.none()) + + /** @see [delete] */ fun delete( params: CustomerCreditTopUpDeleteParams, requestOptions: RequestOptions = RequestOptions.none(), @@ -65,7 +71,12 @@ interface TopUpService { * If a top-up already exists for this customer in the same currency, the existing top-up will * be replaced. */ - @JvmOverloads + fun createByExternalId( + params: CustomerCreditTopUpCreateByExternalIdParams + ): CustomerCreditTopUpCreateByExternalIdResponse = + createByExternalId(params, RequestOptions.none()) + + /** @see [createByExternalId] */ fun createByExternalId( params: CustomerCreditTopUpCreateByExternalIdParams, requestOptions: RequestOptions = RequestOptions.none(), @@ -75,14 +86,21 @@ interface TopUpService { * This deactivates the top-up and voids any invoices associated with pending credit blocks * purchased through the top-up. */ - @JvmOverloads + fun deleteByExternalId(params: CustomerCreditTopUpDeleteByExternalIdParams) = + deleteByExternalId(params, RequestOptions.none()) + + /** @see [deleteByExternalId] */ fun deleteByExternalId( params: CustomerCreditTopUpDeleteByExternalIdParams, requestOptions: RequestOptions = RequestOptions.none(), ) /** List top-ups by external ID */ - @JvmOverloads + fun listByExternalId( + params: CustomerCreditTopUpListByExternalIdParams + ): CustomerCreditTopUpListByExternalIdPage = listByExternalId(params, RequestOptions.none()) + + /** @see [listByExternalId] */ fun listByExternalId( params: CustomerCreditTopUpListByExternalIdParams, requestOptions: RequestOptions = RequestOptions.none(), @@ -95,7 +113,13 @@ interface TopUpService { * Returns a raw HTTP response for `post /customers/{customer_id}/credits/top_ups`, but is * otherwise the same as [TopUpService.create]. */ - @JvmOverloads + @MustBeClosed + fun create( + params: CustomerCreditTopUpCreateParams + ): HttpResponseFor = + create(params, RequestOptions.none()) + + /** @see [create] */ @MustBeClosed fun create( params: CustomerCreditTopUpCreateParams, @@ -106,7 +130,12 @@ interface TopUpService { * Returns a raw HTTP response for `get /customers/{customer_id}/credits/top_ups`, but is * otherwise the same as [TopUpService.list]. */ - @JvmOverloads + @MustBeClosed + fun list( + params: CustomerCreditTopUpListParams + ): HttpResponseFor = list(params, RequestOptions.none()) + + /** @see [list] */ @MustBeClosed fun list( params: CustomerCreditTopUpListParams, @@ -118,7 +147,11 @@ interface TopUpService { * /customers/{customer_id}/credits/top_ups/{top_up_id}`, but is otherwise the same as * [TopUpService.delete]. */ - @JvmOverloads + @MustBeClosed + fun delete(params: CustomerCreditTopUpDeleteParams): HttpResponse = + delete(params, RequestOptions.none()) + + /** @see [delete] */ @MustBeClosed fun delete( params: CustomerCreditTopUpDeleteParams, @@ -130,7 +163,13 @@ interface TopUpService { * /customers/external_customer_id/{external_customer_id}/credits/top_ups`, but is otherwise * the same as [TopUpService.createByExternalId]. */ - @JvmOverloads + @MustBeClosed + fun createByExternalId( + params: CustomerCreditTopUpCreateByExternalIdParams + ): HttpResponseFor = + createByExternalId(params, RequestOptions.none()) + + /** @see [createByExternalId] */ @MustBeClosed fun createByExternalId( params: CustomerCreditTopUpCreateByExternalIdParams, @@ -142,7 +181,11 @@ interface TopUpService { * /customers/external_customer_id/{external_customer_id}/credits/top_ups/{top_up_id}`, but * is otherwise the same as [TopUpService.deleteByExternalId]. */ - @JvmOverloads + @MustBeClosed + fun deleteByExternalId(params: CustomerCreditTopUpDeleteByExternalIdParams): HttpResponse = + deleteByExternalId(params, RequestOptions.none()) + + /** @see [deleteByExternalId] */ @MustBeClosed fun deleteByExternalId( params: CustomerCreditTopUpDeleteByExternalIdParams, @@ -154,7 +197,13 @@ interface TopUpService { * /customers/external_customer_id/{external_customer_id}/credits/top_ups`, but is otherwise * the same as [TopUpService.listByExternalId]. */ - @JvmOverloads + @MustBeClosed + fun listByExternalId( + params: CustomerCreditTopUpListByExternalIdParams + ): HttpResponseFor = + listByExternalId(params, RequestOptions.none()) + + /** @see [listByExternalId] */ @MustBeClosed fun listByExternalId( params: CustomerCreditTopUpListByExternalIdParams, diff --git a/orb-java-core/src/main/kotlin/com/withorb/api/services/blocking/dimensionalPriceGroups/ExternalDimensionalPriceGroupIdService.kt b/orb-java-core/src/main/kotlin/com/withorb/api/services/blocking/dimensionalPriceGroups/ExternalDimensionalPriceGroupIdService.kt index f5910be9..d1ac55cd 100644 --- a/orb-java-core/src/main/kotlin/com/withorb/api/services/blocking/dimensionalPriceGroups/ExternalDimensionalPriceGroupIdService.kt +++ b/orb-java-core/src/main/kotlin/com/withorb/api/services/blocking/dimensionalPriceGroups/ExternalDimensionalPriceGroupIdService.kt @@ -1,7 +1,5 @@ // File generated from our OpenAPI spec by Stainless. -@file:Suppress("OVERLOADS_INTERFACE") // See https://youtrack.jetbrains.com/issue/KT-36102 - package com.withorb.api.services.blocking.dimensionalPriceGroups import com.google.errorprone.annotations.MustBeClosed @@ -18,7 +16,11 @@ interface ExternalDimensionalPriceGroupIdService { fun withRawResponse(): WithRawResponse /** Fetch dimensional price group by external ID */ - @JvmOverloads + fun retrieve( + params: DimensionalPriceGroupExternalDimensionalPriceGroupIdRetrieveParams + ): DimensionalPriceGroup = retrieve(params, RequestOptions.none()) + + /** @see [retrieve] */ fun retrieve( params: DimensionalPriceGroupExternalDimensionalPriceGroupIdRetrieveParams, requestOptions: RequestOptions = RequestOptions.none(), @@ -35,7 +37,12 @@ interface ExternalDimensionalPriceGroupIdService { * /dimensional_price_groups/external_dimensional_price_group_id/{external_dimensional_price_group_id}`, * but is otherwise the same as [ExternalDimensionalPriceGroupIdService.retrieve]. */ - @JvmOverloads + @MustBeClosed + fun retrieve( + params: DimensionalPriceGroupExternalDimensionalPriceGroupIdRetrieveParams + ): HttpResponseFor = retrieve(params, RequestOptions.none()) + + /** @see [retrieve] */ @MustBeClosed fun retrieve( params: DimensionalPriceGroupExternalDimensionalPriceGroupIdRetrieveParams, diff --git a/orb-java-core/src/main/kotlin/com/withorb/api/services/blocking/events/BackfillService.kt b/orb-java-core/src/main/kotlin/com/withorb/api/services/blocking/events/BackfillService.kt index dfd4a3af..37532f16 100644 --- a/orb-java-core/src/main/kotlin/com/withorb/api/services/blocking/events/BackfillService.kt +++ b/orb-java-core/src/main/kotlin/com/withorb/api/services/blocking/events/BackfillService.kt @@ -1,7 +1,5 @@ // File generated from our OpenAPI spec by Stainless. -@file:Suppress("OVERLOADS_INTERFACE") // See https://youtrack.jetbrains.com/issue/KT-36102 - package com.withorb.api.services.blocking.events import com.google.errorprone.annotations.MustBeClosed @@ -55,7 +53,10 @@ interface BackfillService { * expressiveness of computed properties allows you to deprecate existing events based on both a * period of time and specific property values. */ - @JvmOverloads + fun create(params: EventBackfillCreateParams): EventBackfillCreateResponse = + create(params, RequestOptions.none()) + + /** @see [create] */ fun create( params: EventBackfillCreateParams, requestOptions: RequestOptions = RequestOptions.none(), @@ -69,20 +70,20 @@ interface BackfillService { * caller retrieve the next page of results if they exist. More information about pagination can * be found in the [Pagination-metadata schema](pagination). */ - @JvmOverloads + fun list(): EventBackfillListPage = list(EventBackfillListParams.none()) + + /** @see [list] */ fun list( params: EventBackfillListParams = EventBackfillListParams.none(), requestOptions: RequestOptions = RequestOptions.none(), ): EventBackfillListPage - /** - * This endpoint returns a list of all backfills in a list format. - * - * The list of backfills is ordered starting from the most recently created backfill. The - * response also includes [`pagination_metadata`](/api-reference/pagination), which lets the - * caller retrieve the next page of results if they exist. More information about pagination can - * be found in the [Pagination-metadata schema](pagination). - */ + /** @see [list] */ + fun list( + params: EventBackfillListParams = EventBackfillListParams.none() + ): EventBackfillListPage = list(params, RequestOptions.none()) + + /** @see [list] */ fun list(requestOptions: RequestOptions): EventBackfillListPage = list(EventBackfillListParams.none(), requestOptions) @@ -91,14 +92,20 @@ interface BackfillService { * asynchronously reflect the updated usage in invoice amounts and usage graphs. Once all of the * updates are complete, the backfill's status will transition to `reflected`. */ - @JvmOverloads + fun close(params: EventBackfillCloseParams): EventBackfillCloseResponse = + close(params, RequestOptions.none()) + + /** @see [close] */ fun close( params: EventBackfillCloseParams, requestOptions: RequestOptions = RequestOptions.none(), ): EventBackfillCloseResponse /** This endpoint is used to fetch a backfill given an identifier. */ - @JvmOverloads + fun fetch(params: EventBackfillFetchParams): EventBackfillFetchResponse = + fetch(params, RequestOptions.none()) + + /** @see [fetch] */ fun fetch( params: EventBackfillFetchParams, requestOptions: RequestOptions = RequestOptions.none(), @@ -112,7 +119,10 @@ interface BackfillService { * If a backfill is reverted before its closed, no usage will be updated as a result of the * backfill and it will immediately transition to `reverted`. */ - @JvmOverloads + fun revert(params: EventBackfillRevertParams): EventBackfillRevertResponse = + revert(params, RequestOptions.none()) + + /** @see [revert] */ fun revert( params: EventBackfillRevertParams, requestOptions: RequestOptions = RequestOptions.none(), @@ -125,7 +135,12 @@ interface BackfillService { * Returns a raw HTTP response for `post /events/backfills`, but is otherwise the same as * [BackfillService.create]. */ - @JvmOverloads + @MustBeClosed + fun create( + params: EventBackfillCreateParams + ): HttpResponseFor = create(params, RequestOptions.none()) + + /** @see [create] */ @MustBeClosed fun create( params: EventBackfillCreateParams, @@ -136,17 +151,23 @@ interface BackfillService { * Returns a raw HTTP response for `get /events/backfills`, but is otherwise the same as * [BackfillService.list]. */ - @JvmOverloads + @MustBeClosed + fun list(): HttpResponseFor = list(EventBackfillListParams.none()) + + /** @see [list] */ @MustBeClosed fun list( params: EventBackfillListParams = EventBackfillListParams.none(), requestOptions: RequestOptions = RequestOptions.none(), ): HttpResponseFor - /** - * Returns a raw HTTP response for `get /events/backfills`, but is otherwise the same as - * [BackfillService.list]. - */ + /** @see [list] */ + @MustBeClosed + fun list( + params: EventBackfillListParams = EventBackfillListParams.none() + ): HttpResponseFor = list(params, RequestOptions.none()) + + /** @see [list] */ @MustBeClosed fun list(requestOptions: RequestOptions): HttpResponseFor = list(EventBackfillListParams.none(), requestOptions) @@ -155,7 +176,11 @@ interface BackfillService { * Returns a raw HTTP response for `post /events/backfills/{backfill_id}/close`, but is * otherwise the same as [BackfillService.close]. */ - @JvmOverloads + @MustBeClosed + fun close(params: EventBackfillCloseParams): HttpResponseFor = + close(params, RequestOptions.none()) + + /** @see [close] */ @MustBeClosed fun close( params: EventBackfillCloseParams, @@ -166,7 +191,11 @@ interface BackfillService { * Returns a raw HTTP response for `get /events/backfills/{backfill_id}`, but is otherwise * the same as [BackfillService.fetch]. */ - @JvmOverloads + @MustBeClosed + fun fetch(params: EventBackfillFetchParams): HttpResponseFor = + fetch(params, RequestOptions.none()) + + /** @see [fetch] */ @MustBeClosed fun fetch( params: EventBackfillFetchParams, @@ -177,7 +206,12 @@ interface BackfillService { * Returns a raw HTTP response for `post /events/backfills/{backfill_id}/revert`, but is * otherwise the same as [BackfillService.revert]. */ - @JvmOverloads + @MustBeClosed + fun revert( + params: EventBackfillRevertParams + ): HttpResponseFor = revert(params, RequestOptions.none()) + + /** @see [revert] */ @MustBeClosed fun revert( params: EventBackfillRevertParams, diff --git a/orb-java-core/src/main/kotlin/com/withorb/api/services/blocking/events/VolumeService.kt b/orb-java-core/src/main/kotlin/com/withorb/api/services/blocking/events/VolumeService.kt index cd540600..8241b016 100644 --- a/orb-java-core/src/main/kotlin/com/withorb/api/services/blocking/events/VolumeService.kt +++ b/orb-java-core/src/main/kotlin/com/withorb/api/services/blocking/events/VolumeService.kt @@ -1,7 +1,5 @@ // File generated from our OpenAPI spec by Stainless. -@file:Suppress("OVERLOADS_INTERFACE") // See https://youtrack.jetbrains.com/issue/KT-36102 - package com.withorb.api.services.blocking.events import com.google.errorprone.annotations.MustBeClosed @@ -30,7 +28,9 @@ interface VolumeService { * and end time are hour-aligned and in UTC. When a specific timestamp is passed in for either * start or end time, the response includes the hours the timestamp falls in. */ - @JvmOverloads + fun list(params: EventVolumeListParams): EventVolumes = list(params, RequestOptions.none()) + + /** @see [list] */ fun list( params: EventVolumeListParams, requestOptions: RequestOptions = RequestOptions.none(), @@ -43,7 +43,11 @@ interface VolumeService { * Returns a raw HTTP response for `get /events/volume`, but is otherwise the same as * [VolumeService.list]. */ - @JvmOverloads + @MustBeClosed + fun list(params: EventVolumeListParams): HttpResponseFor = + list(params, RequestOptions.none()) + + /** @see [list] */ @MustBeClosed fun list( params: EventVolumeListParams, diff --git a/orb-java-core/src/main/kotlin/com/withorb/api/services/blocking/plans/ExternalPlanIdService.kt b/orb-java-core/src/main/kotlin/com/withorb/api/services/blocking/plans/ExternalPlanIdService.kt index c733588e..0a64853c 100644 --- a/orb-java-core/src/main/kotlin/com/withorb/api/services/blocking/plans/ExternalPlanIdService.kt +++ b/orb-java-core/src/main/kotlin/com/withorb/api/services/blocking/plans/ExternalPlanIdService.kt @@ -1,7 +1,5 @@ // File generated from our OpenAPI spec by Stainless. -@file:Suppress("OVERLOADS_INTERFACE") // See https://youtrack.jetbrains.com/issue/KT-36102 - package com.withorb.api.services.blocking.plans import com.google.errorprone.annotations.MustBeClosed @@ -24,7 +22,9 @@ interface ExternalPlanIdService { * * Other fields on a customer are currently immutable. */ - @JvmOverloads + fun update(params: PlanExternalPlanIdUpdateParams): Plan = update(params, RequestOptions.none()) + + /** @see [update] */ fun update( params: PlanExternalPlanIdUpdateParams, requestOptions: RequestOptions = RequestOptions.none(), @@ -47,7 +47,9 @@ interface ExternalPlanIdService { * detailed explanation of price types can be found in the * [Price schema](/core-concepts#plan-and-price). " */ - @JvmOverloads + fun fetch(params: PlanExternalPlanIdFetchParams): Plan = fetch(params, RequestOptions.none()) + + /** @see [fetch] */ fun fetch( params: PlanExternalPlanIdFetchParams, requestOptions: RequestOptions = RequestOptions.none(), @@ -62,7 +64,11 @@ interface ExternalPlanIdService { * Returns a raw HTTP response for `put /plans/external_plan_id/{external_plan_id}`, but is * otherwise the same as [ExternalPlanIdService.update]. */ - @JvmOverloads + @MustBeClosed + fun update(params: PlanExternalPlanIdUpdateParams): HttpResponseFor = + update(params, RequestOptions.none()) + + /** @see [update] */ @MustBeClosed fun update( params: PlanExternalPlanIdUpdateParams, @@ -73,7 +79,11 @@ interface ExternalPlanIdService { * Returns a raw HTTP response for `get /plans/external_plan_id/{external_plan_id}`, but is * otherwise the same as [ExternalPlanIdService.fetch]. */ - @JvmOverloads + @MustBeClosed + fun fetch(params: PlanExternalPlanIdFetchParams): HttpResponseFor = + fetch(params, RequestOptions.none()) + + /** @see [fetch] */ @MustBeClosed fun fetch( params: PlanExternalPlanIdFetchParams, diff --git a/orb-java-core/src/main/kotlin/com/withorb/api/services/blocking/prices/ExternalPriceIdService.kt b/orb-java-core/src/main/kotlin/com/withorb/api/services/blocking/prices/ExternalPriceIdService.kt index 543f9c5d..24353ff8 100644 --- a/orb-java-core/src/main/kotlin/com/withorb/api/services/blocking/prices/ExternalPriceIdService.kt +++ b/orb-java-core/src/main/kotlin/com/withorb/api/services/blocking/prices/ExternalPriceIdService.kt @@ -1,7 +1,5 @@ // File generated from our OpenAPI spec by Stainless. -@file:Suppress("OVERLOADS_INTERFACE") // See https://youtrack.jetbrains.com/issue/KT-36102 - package com.withorb.api.services.blocking.prices import com.google.errorprone.annotations.MustBeClosed @@ -22,7 +20,10 @@ interface ExternalPriceIdService { * This endpoint allows you to update the `metadata` property on a price. If you pass null for * the metadata value, it will clear any existing metadata for that price. */ - @JvmOverloads + fun update(params: PriceExternalPriceIdUpdateParams): Price = + update(params, RequestOptions.none()) + + /** @see [update] */ fun update( params: PriceExternalPriceIdUpdateParams, requestOptions: RequestOptions = RequestOptions.none(), @@ -33,7 +34,9 @@ interface ExternalPriceIdService { * [price creation API](/api-reference/price/create-price) for more information about external * price aliases. */ - @JvmOverloads + fun fetch(params: PriceExternalPriceIdFetchParams): Price = fetch(params, RequestOptions.none()) + + /** @see [fetch] */ fun fetch( params: PriceExternalPriceIdFetchParams, requestOptions: RequestOptions = RequestOptions.none(), @@ -49,7 +52,11 @@ interface ExternalPriceIdService { * Returns a raw HTTP response for `put /prices/external_price_id/{external_price_id}`, but * is otherwise the same as [ExternalPriceIdService.update]. */ - @JvmOverloads + @MustBeClosed + fun update(params: PriceExternalPriceIdUpdateParams): HttpResponseFor = + update(params, RequestOptions.none()) + + /** @see [update] */ @MustBeClosed fun update( params: PriceExternalPriceIdUpdateParams, @@ -60,7 +67,11 @@ interface ExternalPriceIdService { * Returns a raw HTTP response for `get /prices/external_price_id/{external_price_id}`, but * is otherwise the same as [ExternalPriceIdService.fetch]. */ - @JvmOverloads + @MustBeClosed + fun fetch(params: PriceExternalPriceIdFetchParams): HttpResponseFor = + fetch(params, RequestOptions.none()) + + /** @see [fetch] */ @MustBeClosed fun fetch( params: PriceExternalPriceIdFetchParams, diff --git a/orb-java-core/src/test/kotlin/com/withorb/api/models/CustomerCreateParamsTest.kt b/orb-java-core/src/test/kotlin/com/withorb/api/models/CustomerCreateParamsTest.kt index c9c30408..be7b2a5b 100644 --- a/orb-java-core/src/test/kotlin/com/withorb/api/models/CustomerCreateParamsTest.kt +++ b/orb-java-core/src/test/kotlin/com/withorb/api/models/CustomerCreateParamsTest.kt @@ -26,7 +26,7 @@ class CustomerCreateParamsTest { .excluded(true) .build() ) - .addAdditionalEmail("string") + .addAdditionalEmail("dev@stainless.com") .autoCollection(true) .billingAddress( CustomerCreateParams.BillingAddress.builder() @@ -106,7 +106,7 @@ class CustomerCreateParamsTest { .excluded(true) .build() ) - .addAdditionalEmail("string") + .addAdditionalEmail("dev@stainless.com") .autoCollection(true) .billingAddress( CustomerCreateParams.BillingAddress.builder() @@ -186,7 +186,7 @@ class CustomerCreateParamsTest { .excluded(true) .build() ) - assertThat(body.additionalEmails()).contains(listOf("string")) + assertThat(body.additionalEmails()).contains(listOf("dev@stainless.com")) assertThat(body.autoCollection()).contains(true) assertThat(body.billingAddress()) .contains( diff --git a/orb-java-core/src/test/kotlin/com/withorb/api/services/ErrorHandlingTest.kt b/orb-java-core/src/test/kotlin/com/withorb/api/services/ErrorHandlingTest.kt index c9a93cd9..ab974324 100644 --- a/orb-java-core/src/test/kotlin/com/withorb/api/services/ErrorHandlingTest.kt +++ b/orb-java-core/src/test/kotlin/com/withorb/api/services/ErrorHandlingTest.kt @@ -85,7 +85,7 @@ class ErrorHandlingTest { .excluded(true) .build() ) - .addAdditionalEmail("string") + .addAdditionalEmail("dev@stainless.com") .autoCollection(true) .billingAddress( CustomerCreateParams.BillingAddress.builder() @@ -184,7 +184,7 @@ class ErrorHandlingTest { .excluded(true) .build() ) - .addAdditionalEmail("string") + .addAdditionalEmail("dev@stainless.com") .autoCollection(true) .billingAddress( CustomerCreateParams.BillingAddress.builder() @@ -283,7 +283,7 @@ class ErrorHandlingTest { .excluded(true) .build() ) - .addAdditionalEmail("string") + .addAdditionalEmail("dev@stainless.com") .autoCollection(true) .billingAddress( CustomerCreateParams.BillingAddress.builder() @@ -382,7 +382,7 @@ class ErrorHandlingTest { .excluded(true) .build() ) - .addAdditionalEmail("string") + .addAdditionalEmail("dev@stainless.com") .autoCollection(true) .billingAddress( CustomerCreateParams.BillingAddress.builder() @@ -481,7 +481,7 @@ class ErrorHandlingTest { .excluded(true) .build() ) - .addAdditionalEmail("string") + .addAdditionalEmail("dev@stainless.com") .autoCollection(true) .billingAddress( CustomerCreateParams.BillingAddress.builder() @@ -580,7 +580,7 @@ class ErrorHandlingTest { .excluded(true) .build() ) - .addAdditionalEmail("string") + .addAdditionalEmail("dev@stainless.com") .autoCollection(true) .billingAddress( CustomerCreateParams.BillingAddress.builder() @@ -679,7 +679,7 @@ class ErrorHandlingTest { .excluded(true) .build() ) - .addAdditionalEmail("string") + .addAdditionalEmail("dev@stainless.com") .autoCollection(true) .billingAddress( CustomerCreateParams.BillingAddress.builder() @@ -778,7 +778,7 @@ class ErrorHandlingTest { .excluded(true) .build() ) - .addAdditionalEmail("string") + .addAdditionalEmail("dev@stainless.com") .autoCollection(true) .billingAddress( CustomerCreateParams.BillingAddress.builder() @@ -877,7 +877,7 @@ class ErrorHandlingTest { .excluded(true) .build() ) - .addAdditionalEmail("string") + .addAdditionalEmail("dev@stainless.com") .autoCollection(true) .billingAddress( CustomerCreateParams.BillingAddress.builder() diff --git a/orb-java-core/src/test/kotlin/com/withorb/api/services/ServiceParamsTest.kt b/orb-java-core/src/test/kotlin/com/withorb/api/services/ServiceParamsTest.kt index 59b94c03..120c2a73 100644 --- a/orb-java-core/src/test/kotlin/com/withorb/api/services/ServiceParamsTest.kt +++ b/orb-java-core/src/test/kotlin/com/withorb/api/services/ServiceParamsTest.kt @@ -54,7 +54,7 @@ internal class ServiceParamsTest { .excluded(true) .build() ) - .addAdditionalEmail("string") + .addAdditionalEmail("dev@stainless.com") .autoCollection(true) .billingAddress( CustomerCreateParams.BillingAddress.builder() diff --git a/orb-java-core/src/test/kotlin/com/withorb/api/services/async/CustomerServiceAsyncTest.kt b/orb-java-core/src/test/kotlin/com/withorb/api/services/async/CustomerServiceAsyncTest.kt index 91d1a134..5fdc3398 100644 --- a/orb-java-core/src/test/kotlin/com/withorb/api/services/async/CustomerServiceAsyncTest.kt +++ b/orb-java-core/src/test/kotlin/com/withorb/api/services/async/CustomerServiceAsyncTest.kt @@ -45,7 +45,7 @@ class CustomerServiceAsyncTest { .excluded(true) .build() ) - .addAdditionalEmail("string") + .addAdditionalEmail("dev@stainless.com") .autoCollection(true) .billingAddress( CustomerCreateParams.BillingAddress.builder() diff --git a/orb-java-core/src/test/kotlin/com/withorb/api/services/blocking/CustomerServiceTest.kt b/orb-java-core/src/test/kotlin/com/withorb/api/services/blocking/CustomerServiceTest.kt index 1cec0a8f..968641ea 100644 --- a/orb-java-core/src/test/kotlin/com/withorb/api/services/blocking/CustomerServiceTest.kt +++ b/orb-java-core/src/test/kotlin/com/withorb/api/services/blocking/CustomerServiceTest.kt @@ -45,7 +45,7 @@ class CustomerServiceTest { .excluded(true) .build() ) - .addAdditionalEmail("string") + .addAdditionalEmail("dev@stainless.com") .autoCollection(true) .billingAddress( CustomerCreateParams.BillingAddress.builder()