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

Author: stainless-app[bot]

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

@@ -19,31 +19,33 @@ 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
 
@@ -80,17 +82,21 @@ 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,31 +18,33 @@ 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
 
@@ -77,17 +79,21 @@ 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,74 +33,49 @@ 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
 
@@ -132,70 +107,42 @@ class OrbClientAsyncImpl(private val clientOptions: ClientOptions) : OrbClientAs
 
     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
 
@@ -207,8 +154,7 @@ class OrbClientAsyncImpl(private val clientOptions: ClientOptions) : OrbClientAs
 
         override fun events(): EventServiceAsync.WithRawResponse = events
 
-        override fun invoiceLineItems(): InvoiceLineItemServiceAsync.WithRawResponse =
-            invoiceLineItems
+        override fun invoiceLineItems(): InvoiceLineItemServiceAsync.WithRawResponse = invoiceLineItems
 
         override fun invoices(): InvoiceServiceAsync.WithRawResponse = invoices
 
@@ -224,7 +170,6 @@ class OrbClientAsyncImpl(private val clientOptions: ClientOptions) : OrbClientAs
 
         override fun alerts(): AlertServiceAsync.WithRawResponse = alerts
 
-        override fun dimensionalPriceGroups(): DimensionalPriceGroupServiceAsync.WithRawResponse =
-            dimensionalPriceGroups
+        override fun dimensionalPriceGroups(): DimensionalPriceGroupServiceAsync.WithRawResponse = dimensionalPriceGroups
     }
 }