chore(internal): codegen related update (#335)

Author: stainless-app[bot]

orb-java-core/src/main/kotlin/com/withorb/api/client/OrbClient.kt

@@ -19,33 +19,31 @@ import com.withorb.api.services.blocking.TopLevelService
 import com.withorb.api.services.blocking.WebhookService
 
 /**
- * A client for interacting with the Orb REST API synchronously. You can also
- * switch to asynchronous execution via the [async] method.
+ * A client for interacting with the Orb REST API synchronously. You can also switch to asynchronous
+ * execution via the [async] method.
  *
- * This client performs best when you create a single instance and reuse it for all
- * interactions with the REST API. This is because each client holds its own
- * connection pool and thread pools. Reusing connections and threads reduces
- * latency and saves memory. The client also handles rate limiting per client. This
- * means that creating and using multiple instances at the same time will not
- * respect rate limits.
+ * This client performs best when you create a single instance and reuse it for all interactions
+ * with the REST API. This is because each client holds its own connection pool and thread pools.
+ * Reusing connections and threads reduces latency and saves memory. The client also handles rate
+ * limiting per client. This means that creating and using multiple instances at the same time will
+ * not respect rate limits.
  *
- * The threads and connections that are held will be released automatically if they
- * remain idle. But if you are writing an application that needs to aggressively
- * release unused resources, then you may call [close].
+ * The threads and connections that are held will be released automatically if they remain idle. But
+ * if you are writing an application that needs to aggressively release unused resources, then you
+ * may call [close].
  */
 interface OrbClient {
 
     /**
      * Returns a version of this client that uses asynchronous execution.
      *
-     * The returned client shares its resources, like its connection pool and thread
-     * pools, with this client.
+     * The returned client shares its resources, like its connection pool and thread pools, with
+     * this client.
      */
     fun async(): OrbClientAsync
 
     /**
-     * Returns a view of this service that provides access to raw HTTP responses for
-     * each method.
+     * Returns a view of this service that provides access to raw HTTP responses for each method.
      */
     fun withRawResponse(): WithRawResponse
 
@@ -82,21 +80,17 @@ interface OrbClient {
     /**
      * Closes this client, relinquishing any underlying resources.
      *
-     * This is purposefully not inherited from [AutoCloseable] because the client is
-     * long-lived and usually should not be synchronously closed via
-     * try-with-resources.
+     * This is purposefully not inherited from [AutoCloseable] because the client is long-lived and
+     * usually should not be synchronously closed via try-with-resources.
      *
-     * It's also usually not necessary to call this method at all. the default HTTP
-     * client automatically releases threads and connections if they remain idle, but
-     * if you are writing an application that needs to aggressively release unused
-     * resources, then you may call this method.
+     * It's also usually not necessary to call this method at all. the default HTTP client
+     * automatically releases threads and connections if they remain idle, but if you are writing an
+     * application that needs to aggressively release unused resources, then you may call this
+     * method.
      */
     fun close()
 
-    /**
-     * A view of [OrbClient] that provides access to raw HTTP responses for each
-     * method.
-     */
+    /** A view of [OrbClient] that provides access to raw HTTP responses for each method. */
     interface WithRawResponse {
 
         fun topLevel(): TopLevelService.WithRawResponse

orb-java-core/src/main/kotlin/com/withorb/api/client/OrbClientAsync.kt

@@ -18,33 +18,31 @@ import com.withorb.api.services.async.SubscriptionServiceAsync
 import com.withorb.api.services.async.TopLevelServiceAsync
 
 /**
- * A client for interacting with the Orb REST API asynchronously. You can also
- * switch to synchronous execution via the [sync] method.
+ * A client for interacting with the Orb REST API asynchronously. You can also switch to synchronous
+ * execution via the [sync] method.
  *
- * This client performs best when you create a single instance and reuse it for all
- * interactions with the REST API. This is because each client holds its own
- * connection pool and thread pools. Reusing connections and threads reduces
- * latency and saves memory. The client also handles rate limiting per client. This
- * means that creating and using multiple instances at the same time will not
- * respect rate limits.
+ * This client performs best when you create a single instance and reuse it for all interactions
+ * with the REST API. This is because each client holds its own connection pool and thread pools.
+ * Reusing connections and threads reduces latency and saves memory. The client also handles rate
+ * limiting per client. This means that creating and using multiple instances at the same time will
+ * not respect rate limits.
  *
- * The threads and connections that are held will be released automatically if they
- * remain idle. But if you are writing an application that needs to aggressively
- * release unused resources, then you may call [close].
+ * The threads and connections that are held will be released automatically if they remain idle. But
+ * if you are writing an application that needs to aggressively release unused resources, then you
+ * may call [close].
  */
 interface OrbClientAsync {
 
     /**
      * Returns a version of this client that uses synchronous execution.
      *
-     * The returned client shares its resources, like its connection pool and thread
-     * pools, with this client.
+     * The returned client shares its resources, like its connection pool and thread pools, with
+     * this client.
      */
     fun sync(): OrbClient
 
     /**
-     * Returns a view of this service that provides access to raw HTTP responses for
-     * each method.
+     * Returns a view of this service that provides access to raw HTTP responses for each method.
      */
     fun withRawResponse(): WithRawResponse
 
@@ -79,21 +77,17 @@ interface OrbClientAsync {
     /**
      * Closes this client, relinquishing any underlying resources.
      *
-     * This is purposefully not inherited from [AutoCloseable] because the client is
-     * long-lived and usually should not be synchronously closed via
-     * try-with-resources.
+     * This is purposefully not inherited from [AutoCloseable] because the client is long-lived and
+     * usually should not be synchronously closed via try-with-resources.
      *
-     * It's also usually not necessary to call this method at all. the default HTTP
-     * client automatically releases threads and connections if they remain idle, but
-     * if you are writing an application that needs to aggressively release unused
-     * resources, then you may call this method.
+     * It's also usually not necessary to call this method at all. the default HTTP client
+     * automatically releases threads and connections if they remain idle, but if you are writing an
+     * application that needs to aggressively release unused resources, then you may call this
+     * method.
      */
     fun close()
 
-    /**
-     * A view of [OrbClientAsync] that provides access to raw HTTP responses for each
-     * method.
-     */
+    /** A view of [OrbClientAsync] that provides access to raw HTTP responses for each method. */
     interface WithRawResponse {
 
         fun topLevel(): TopLevelServiceAsync.WithRawResponse

orb-java-core/src/main/kotlin/com/withorb/api/client/OrbClientAsyncImpl.kt

@@ -33,49 +33,74 @@ import com.withorb.api.services.async.SubscriptionServiceAsyncImpl
 import com.withorb.api.services.async.TopLevelServiceAsync
 import com.withorb.api.services.async.TopLevelServiceAsyncImpl
 
-class OrbClientAsyncImpl(
-    private val clientOptions: ClientOptions,
-
-) : OrbClientAsync {
+class OrbClientAsyncImpl(private val clientOptions: ClientOptions) : OrbClientAsync {
 
     private val clientOptionsWithUserAgent =
-
-      if (clientOptions.headers.names().contains("User-Agent")) clientOptions
-
-      else clientOptions.toBuilder().putHeader("User-Agent", "${javaClass.simpleName}/Java ${getPackageVersion()}").build()
+        if (clientOptions.headers.names().contains("User-Agent")) clientOptions
+        else
+            clientOptions
+                .toBuilder()
+                .putHeader("User-Agent", "${javaClass.simpleName}/Java ${getPackageVersion()}")
+                .build()
 
     // Pass the original clientOptions so that this client sets its own User-Agent.
     private val sync: OrbClient by lazy { OrbClientImpl(clientOptions) }
 
-    private val withRawResponse: OrbClientAsync.WithRawResponse by lazy { WithRawResponseImpl(clientOptions) }
+    private val withRawResponse: OrbClientAsync.WithRawResponse by lazy {
+        WithRawResponseImpl(clientOptions)
+    }
 
-    private val topLevel: TopLevelServiceAsync by lazy { TopLevelServiceAsyncImpl(clientOptionsWithUserAgent) }
+    private val topLevel: TopLevelServiceAsync by lazy {
+        TopLevelServiceAsyncImpl(clientOptionsWithUserAgent)
+    }
 
-    private val coupons: CouponServiceAsync by lazy { CouponServiceAsyncImpl(clientOptionsWithUserAgent) }
+    private val coupons: CouponServiceAsync by lazy {
+        CouponServiceAsyncImpl(clientOptionsWithUserAgent)
+    }
 
-    private val creditNotes: CreditNoteServiceAsync by lazy { CreditNoteServiceAsyncImpl(clientOptionsWithUserAgent) }
+    private val creditNotes: CreditNoteServiceAsync by lazy {
+        CreditNoteServiceAsyncImpl(clientOptionsWithUserAgent)
+    }
 
-    private val customers: CustomerServiceAsync by lazy { CustomerServiceAsyncImpl(clientOptionsWithUserAgent) }
+    private val customers: CustomerServiceAsync by lazy {
+        CustomerServiceAsyncImpl(clientOptionsWithUserAgent)
+    }
 
-    private val events: EventServiceAsync by lazy { EventServiceAsyncImpl(clientOptionsWithUserAgent) }
+    private val events: EventServiceAsync by lazy {
+        EventServiceAsyncImpl(clientOptionsWithUserAgent)
+    }
 
-    private val invoiceLineItems: InvoiceLineItemServiceAsync by lazy { InvoiceLineItemServiceAsyncImpl(clientOptionsWithUserAgent) }
+    private val invoiceLineItems: InvoiceLineItemServiceAsync by lazy {
+        InvoiceLineItemServiceAsyncImpl(clientOptionsWithUserAgent)
+    }
 
-    private val invoices: InvoiceServiceAsync by lazy { InvoiceServiceAsyncImpl(clientOptionsWithUserAgent) }
+    private val invoices: InvoiceServiceAsync by lazy {
+        InvoiceServiceAsyncImpl(clientOptionsWithUserAgent)
+    }
 
     private val items: ItemServiceAsync by lazy { ItemServiceAsyncImpl(clientOptionsWithUserAgent) }
 
-    private val metrics: MetricServiceAsync by lazy { MetricServiceAsyncImpl(clientOptionsWithUserAgent) }
+    private val metrics: MetricServiceAsync by lazy {
+        MetricServiceAsyncImpl(clientOptionsWithUserAgent)
+    }
 
     private val plans: PlanServiceAsync by lazy { PlanServiceAsyncImpl(clientOptionsWithUserAgent) }
 
-    private val prices: PriceServiceAsync by lazy { PriceServiceAsyncImpl(clientOptionsWithUserAgent) }
+    private val prices: PriceServiceAsync by lazy {
+        PriceServiceAsyncImpl(clientOptionsWithUserAgent)
+    }
 
-    private val subscriptions: SubscriptionServiceAsync by lazy { SubscriptionServiceAsyncImpl(clientOptionsWithUserAgent) }
+    private val subscriptions: SubscriptionServiceAsync by lazy {
+        SubscriptionServiceAsyncImpl(clientOptionsWithUserAgent)
+    }
 
-    private val alerts: AlertServiceAsync by lazy { AlertServiceAsyncImpl(clientOptionsWithUserAgent) }
+    private val alerts: AlertServiceAsync by lazy {
+        AlertServiceAsyncImpl(clientOptionsWithUserAgent)
+    }
 
-    private val dimensionalPriceGroups: DimensionalPriceGroupServiceAsync by lazy { DimensionalPriceGroupServiceAsyncImpl(clientOptionsWithUserAgent) }
+    private val dimensionalPriceGroups: DimensionalPriceGroupServiceAsync by lazy {
+        DimensionalPriceGroupServiceAsyncImpl(clientOptionsWithUserAgent)
+    }
 
     override fun sync(): OrbClient = sync
 
@@ -107,42 +132,70 @@ class OrbClientAsyncImpl(
 
     override fun alerts(): AlertServiceAsync = alerts
 
-    override fun dimensionalPriceGroups(): DimensionalPriceGroupServiceAsync = dimensionalPriceGroups
+    override fun dimensionalPriceGroups(): DimensionalPriceGroupServiceAsync =
+        dimensionalPriceGroups
 
     override fun close() = clientOptions.httpClient.close()
 
-    class WithRawResponseImpl internal constructor(
-        private val clientOptions: ClientOptions,
-
-    ) : OrbClientAsync.WithRawResponse {
+    class WithRawResponseImpl internal constructor(private val clientOptions: ClientOptions) :
+        OrbClientAsync.WithRawResponse {
 
-        private val topLevel: TopLevelServiceAsync.WithRawResponse by lazy { TopLevelServiceAsyncImpl.WithRawResponseImpl(clientOptions) }
+        private val topLevel: TopLevelServiceAsync.WithRawResponse by lazy {
+            TopLevelServiceAsyncImpl.WithRawResponseImpl(clientOptions)
+        }
 
-        private val coupons: CouponServiceAsync.WithRawResponse by lazy { CouponServiceAsyncImpl.WithRawResponseImpl(clientOptions) }
+        private val coupons: CouponServiceAsync.WithRawResponse by lazy {
+            CouponServiceAsyncImpl.WithRawResponseImpl(clientOptions)
+        }
 
-        private val creditNotes: CreditNoteServiceAsync.WithRawResponse by lazy { CreditNoteServiceAsyncImpl.WithRawResponseImpl(clientOptions) }
+        private val creditNotes: CreditNoteServiceAsync.WithRawResponse by lazy {
+            CreditNoteServiceAsyncImpl.WithRawResponseImpl(clientOptions)
+        }
 
-        private val customers: CustomerServiceAsync.WithRawResponse by lazy { CustomerServiceAsyncImpl.WithRawResponseImpl(clientOptions) }
+        private val customers: CustomerServiceAsync.WithRawResponse by lazy {
+            CustomerServiceAsyncImpl.WithRawResponseImpl(clientOptions)
+        }
 
-        private val events: EventServiceAsync.WithRawResponse by lazy { EventServiceAsyncImpl.WithRawResponseImpl(clientOptions) }
+        private val events: EventServiceAsync.WithRawResponse by lazy {
+            EventServiceAsyncImpl.WithRawResponseImpl(clientOptions)
+        }
 
-        private val invoiceLineItems: InvoiceLineItemServiceAsync.WithRawResponse by lazy { InvoiceLineItemServiceAsyncImpl.WithRawResponseImpl(clientOptions) }
+        private val invoiceLineItems: InvoiceLineItemServiceAsync.WithRawResponse by lazy {
+            InvoiceLineItemServiceAsyncImpl.WithRawResponseImpl(clientOptions)
+        }
 
-        private val invoices: InvoiceServiceAsync.WithRawResponse by lazy { InvoiceServiceAsyncImpl.WithRawResponseImpl(clientOptions) }
+        private val invoices: InvoiceServiceAsync.WithRawResponse by lazy {
+            InvoiceServiceAsyncImpl.WithRawResponseImpl(clientOptions)
+        }
 
-        private val items: ItemServiceAsync.WithRawResponse by lazy { ItemServiceAsyncImpl.WithRawResponseImpl(clientOptions) }
+        private val items: ItemServiceAsync.WithRawResponse by lazy {
+            ItemServiceAsyncImpl.WithRawResponseImpl(clientOptions)
+        }
 
-        private val metrics: MetricServiceAsync.WithRawResponse by lazy { MetricServiceAsyncImpl.WithRawResponseImpl(clientOptions) }
+        private val metrics: MetricServiceAsync.WithRawResponse by lazy {
+            MetricServiceAsyncImpl.WithRawResponseImpl(clientOptions)
+        }
 
-        private val plans: PlanServiceAsync.WithRawResponse by lazy { PlanServiceAsyncImpl.WithRawResponseImpl(clientOptions) }
+        private val plans: PlanServiceAsync.WithRawResponse by lazy {
+            PlanServiceAsyncImpl.WithRawResponseImpl(clientOptions)
+        }
 
-        private val prices: PriceServiceAsync.WithRawResponse by lazy { PriceServiceAsyncImpl.WithRawResponseImpl(clientOptions) }
+        private val prices: PriceServiceAsync.WithRawResponse by lazy {
+            PriceServiceAsyncImpl.WithRawResponseImpl(clientOptions)
+        }
 
-        private val subscriptions: SubscriptionServiceAsync.WithRawResponse by lazy { SubscriptionServiceAsyncImpl.WithRawResponseImpl(clientOptions) }
+        private val subscriptions: SubscriptionServiceAsync.WithRawResponse by lazy {
+            SubscriptionServiceAsyncImpl.WithRawResponseImpl(clientOptions)
+        }
 
-        private val alerts: AlertServiceAsync.WithRawResponse by lazy { AlertServiceAsyncImpl.WithRawResponseImpl(clientOptions) }
+        private val alerts: AlertServiceAsync.WithRawResponse by lazy {
+            AlertServiceAsyncImpl.WithRawResponseImpl(clientOptions)
+        }
 
-        private val dimensionalPriceGroups: DimensionalPriceGroupServiceAsync.WithRawResponse by lazy { DimensionalPriceGroupServiceAsyncImpl.WithRawResponseImpl(clientOptions) }
+        private val dimensionalPriceGroups:
+            DimensionalPriceGroupServiceAsync.WithRawResponse by lazy {
+            DimensionalPriceGroupServiceAsyncImpl.WithRawResponseImpl(clientOptions)
+        }
 
         override fun topLevel(): TopLevelServiceAsync.WithRawResponse = topLevel
 
@@ -154,7 +207,8 @@ class OrbClientAsyncImpl(
 
         override fun events(): EventServiceAsync.WithRawResponse = events
 
-        override fun invoiceLineItems(): InvoiceLineItemServiceAsync.WithRawResponse = invoiceLineItems
+        override fun invoiceLineItems(): InvoiceLineItemServiceAsync.WithRawResponse =
+            invoiceLineItems
 
         override fun invoices(): InvoiceServiceAsync.WithRawResponse = invoices
 
@@ -170,6 +224,7 @@ class OrbClientAsyncImpl(
 
         override fun alerts(): AlertServiceAsync.WithRawResponse = alerts
 
-        override fun dimensionalPriceGroups(): DimensionalPriceGroupServiceAsync.WithRawResponse = dimensionalPriceGroups
+        override fun dimensionalPriceGroups(): DimensionalPriceGroupServiceAsync.WithRawResponse =
+            dimensionalPriceGroups
     }
 }