Merge pull request #17 from brand-dot-dev/release-please--branches--main--changes--next

release: 0.1.0-alpha.15

Author: YahiaBakour

.release-please-manifest.json

@@ -1,3 +1,3 @@
 {
-  ".": "0.1.0-alpha.14"
+  ".": "0.1.0-alpha.15"
 }

.stats.yml

@@ -1,4 +1,4 @@
 configured_endpoints: 8
-openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/brand-dev%2Fbrand.dev-558cea4d1e47f7f79e5a42b1113401d9488399f96ce57000488ba82eefc74119.yml
-openapi_spec_hash: 576db82fb9e7648107687ee308db7eae
+openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/brand-dev%2Fbrand.dev-ace647670dd24a6335738fb26360272dd0764b0f402e0186df0e92ecd0881c13.yml
+openapi_spec_hash: c21512e10bd012cd347bb4afff7da9ae
 config_hash: 4e76a07aea49753a61313dcd8c10fb0f

CHANGELOG.md

@@ -1,5 +1,26 @@
 # Changelog
 
+## 0.1.0-alpha.15 (2025-09-26)
+
+Full Changelog: [v0.1.0-alpha.14...v0.1.0-alpha.15](https://github.com/brand-dot-dev/java-sdk/compare/v0.1.0-alpha.14...v0.1.0-alpha.15)
+
+### Features
+
+* **api:** api update ([aac4e9e](https://github.com/brand-dot-dev/java-sdk/commit/aac4e9e863a225e8d0ea9bac88addbf8fc588894))
+* **client:** expose sleeper option ([ae2f570](https://github.com/brand-dot-dev/java-sdk/commit/ae2f570de5403c9e4387c3a19474de25e0389d64))
+
+
+### Bug Fixes
+
+* **client:** deserialization of empty objects ([fac2a8c](https://github.com/brand-dot-dev/java-sdk/commit/fac2a8c36227803782d90709dda826adc638bfa0))
+* **client:** ensure single timer is created per client ([ae2f570](https://github.com/brand-dot-dev/java-sdk/commit/ae2f570de5403c9e4387c3a19474de25e0389d64))
+* **client:** incorrect `getPackageVersion` impl ([e63e7b9](https://github.com/brand-dot-dev/java-sdk/commit/e63e7b99e34764bd21c8fbb95b1fa8f1b54f4163))
+
+
+### Chores
+
+* **internal:** codegen related update ([4b5343e](https://github.com/brand-dot-dev/java-sdk/commit/4b5343efe7d87afec1f527b0dc1583efa310bc74))
+
 ## 0.1.0-alpha.14 (2025-09-14)
 
 Full Changelog: [v0.1.0-alpha.13...v0.1.0-alpha.14](https://github.com/brand-dot-dev/java-sdk/compare/v0.1.0-alpha.13...v0.1.0-alpha.14)

README.md

@@ -2,8 +2,8 @@
 
 <!-- x-release-please-start-version -->
 
-[![Maven Central](https://img.shields.io/maven-central/v/com.branddev.api/brand-dev-java)](https://central.sonatype.com/artifact/com.branddev.api/brand-dev-java/0.1.0-alpha.14)
-[![javadoc](https://javadoc.io/badge2/com.branddev.api/brand-dev-java/0.1.0-alpha.14/javadoc.svg)](https://javadoc.io/doc/com.branddev.api/brand-dev-java/0.1.0-alpha.14)
+[![Maven Central](https://img.shields.io/maven-central/v/com.branddev.api/brand-dev-java)](https://central.sonatype.com/artifact/com.branddev.api/brand-dev-java/0.1.0-alpha.15)
+[![javadoc](https://javadoc.io/badge2/com.branddev.api/brand-dev-java/0.1.0-alpha.15/javadoc.svg)](https://javadoc.io/doc/com.branddev.api/brand-dev-java/0.1.0-alpha.15)
 
 <!-- x-release-please-end -->
 
@@ -13,7 +13,7 @@ It is generated with [Stainless](https://www.stainless.com/).
 
 <!-- x-release-please-start-version -->
 
-The REST API documentation can be found on [docs.brand.dev](https://docs.brand.dev/). Javadocs are available on [javadoc.io](https://javadoc.io/doc/com.branddev.api/brand-dev-java/0.1.0-alpha.14).
+The REST API documentation can be found on [docs.brand.dev](https://docs.brand.dev/). Javadocs are available on [javadoc.io](https://javadoc.io/doc/com.branddev.api/brand-dev-java/0.1.0-alpha.15).
 
 <!-- x-release-please-end -->
 
@@ -24,7 +24,7 @@ The REST API documentation can be found on [docs.brand.dev](https://docs.brand.d
 ### Gradle
 
 ```kotlin
-implementation("com.branddev.api:brand-dev-java:0.1.0-alpha.14")
+implementation("com.branddev.api:brand-dev-java:0.1.0-alpha.15")
 ```
 
 ### Maven
@@ -33,7 +33,7 @@ implementation("com.branddev.api:brand-dev-java:0.1.0-alpha.14")
 <dependency>
   <groupId>com.branddev.api</groupId>
   <artifactId>brand-dev-java</artifactId>
-  <version>0.1.0-alpha.14</version>
+  <version>0.1.0-alpha.15</version>
 </dependency>
 ```
 

brand-dev-java-client-okhttp/src/main/kotlin/com/branddev/api/client/okhttp/BrandDevOkHttpClient.kt

@@ -5,6 +5,7 @@ package com.branddev.api.client.okhttp
 import com.branddev.api.client.BrandDevClient
 import com.branddev.api.client.BrandDevClientImpl
 import com.branddev.api.core.ClientOptions
+import com.branddev.api.core.Sleeper
 import com.branddev.api.core.Timeout
 import com.branddev.api.core.http.Headers
 import com.branddev.api.core.http.HttpClient
@@ -120,6 +121,17 @@ class BrandDevOkHttpClient private constructor() {
          */
         fun jsonMapper(jsonMapper: JsonMapper) = apply { clientOptions.jsonMapper(jsonMapper) }
 
+        /**
+         * The interface to use for delaying execution, like during retries.
+         *
+         * This is primarily useful for using fake delays in tests.
+         *
+         * Defaults to real execution delays.
+         *
+         * This class takes ownership of the sleeper and closes it when closed.
+         */
+        fun sleeper(sleeper: Sleeper) = apply { clientOptions.sleeper(sleeper) }
+
         /**
          * The clock to use for operations that require timing, like retries.
          *

brand-dev-java-client-okhttp/src/main/kotlin/com/branddev/api/client/okhttp/BrandDevOkHttpClientAsync.kt

@@ -5,6 +5,7 @@ package com.branddev.api.client.okhttp
 import com.branddev.api.client.BrandDevClientAsync
 import com.branddev.api.client.BrandDevClientAsyncImpl
 import com.branddev.api.core.ClientOptions
+import com.branddev.api.core.Sleeper
 import com.branddev.api.core.Timeout
 import com.branddev.api.core.http.Headers
 import com.branddev.api.core.http.HttpClient
@@ -120,6 +121,17 @@ class BrandDevOkHttpClientAsync private constructor() {
          */
         fun jsonMapper(jsonMapper: JsonMapper) = apply { clientOptions.jsonMapper(jsonMapper) }
 
+        /**
+         * The interface to use for delaying execution, like during retries.
+         *
+         * This is primarily useful for using fake delays in tests.
+         *
+         * Defaults to real execution delays.
+         *
+         * This class takes ownership of the sleeper and closes it when closed.
+         */
+        fun sleeper(sleeper: Sleeper) = apply { clientOptions.sleeper(sleeper) }
+
         /**
          * The clock to use for operations that require timing, like retries.
          *

brand-dev-java-core/src/main/kotlin/com/branddev/api/core/ClientOptions.kt

@@ -40,6 +40,16 @@ private constructor(
      * needs to be overridden.
      */
     @get:JvmName("jsonMapper") val jsonMapper: JsonMapper,
+    /**
+     * The interface to use for delaying execution, like during retries.
+     *
+     * This is primarily useful for using fake delays in tests.
+     *
+     * Defaults to real execution delays.
+     *
+     * This class takes ownership of the sleeper and closes it when closed.
+     */
+    @get:JvmName("sleeper") val sleeper: Sleeper,
     /**
      * The clock to use for operations that require timing, like retries.
      *
@@ -130,6 +140,7 @@ private constructor(
         private var httpClient: HttpClient? = null
         private var checkJacksonVersionCompatibility: Boolean = true
         private var jsonMapper: JsonMapper = jsonMapper()
+        private var sleeper: Sleeper? = null
         private var clock: Clock = Clock.systemUTC()
         private var baseUrl: String? = null
         private var headers: Headers.Builder = Headers.builder()
@@ -144,6 +155,7 @@ private constructor(
             httpClient = clientOptions.originalHttpClient
             checkJacksonVersionCompatibility = clientOptions.checkJacksonVersionCompatibility
             jsonMapper = clientOptions.jsonMapper
+            sleeper = clientOptions.sleeper
             clock = clientOptions.clock
             baseUrl = clientOptions.baseUrl
             headers = clientOptions.headers.toBuilder()
@@ -184,6 +196,17 @@ private constructor(
          */
         fun jsonMapper(jsonMapper: JsonMapper) = apply { this.jsonMapper = jsonMapper }
 
+        /**
+         * The interface to use for delaying execution, like during retries.
+         *
+         * This is primarily useful for using fake delays in tests.
+         *
+         * Defaults to real execution delays.
+         *
+         * This class takes ownership of the sleeper and closes it when closed.
+         */
+        fun sleeper(sleeper: Sleeper) = apply { this.sleeper = PhantomReachableSleeper(sleeper) }
+
         /**
          * The clock to use for operations that require timing, like retries.
          *
@@ -367,6 +390,7 @@ private constructor(
          */
         fun build(): ClientOptions {
             val httpClient = checkRequired("httpClient", httpClient)
+            val sleeper = sleeper ?: PhantomReachableSleeper(DefaultSleeper())
             val apiKey = checkRequired("apiKey", apiKey)
 
             val headers = Headers.builder()
@@ -390,11 +414,13 @@ private constructor(
                 httpClient,
                 RetryingHttpClient.builder()
                     .httpClient(httpClient)
+                    .sleeper(sleeper)
                     .clock(clock)
                     .maxRetries(maxRetries)
                     .build(),
                 checkJacksonVersionCompatibility,
                 jsonMapper,
+                sleeper,
                 clock,
                 baseUrl,
                 headers.build(),
@@ -419,5 +445,6 @@ private constructor(
      */
     fun close() {
         httpClient.close()
+        sleeper.close()
     }
 }

brand-dev-java-core/src/main/kotlin/com/branddev/api/core/DefaultSleeper.kt

@@ -0,0 +1,28 @@
+package com.branddev.api.core
+
+import java.time.Duration
+import java.util.Timer
+import java.util.TimerTask
+import java.util.concurrent.CompletableFuture
+
+class DefaultSleeper : Sleeper {
+
+    private val timer = Timer("DefaultSleeper", true)
+
+    override fun sleep(duration: Duration) = Thread.sleep(duration.toMillis())
+
+    override fun sleepAsync(duration: Duration): CompletableFuture<Void> {
+        val future = CompletableFuture<Void>()
+        timer.schedule(
+            object : TimerTask() {
+                override fun run() {
+                    future.complete(null)
+                }
+            },
+            duration.toMillis(),
+        )
+        return future
+    }
+
+    override fun close() = timer.cancel()
+}

brand-dev-java-core/src/main/kotlin/com/branddev/api/core/PhantomReachableSleeper.kt

@@ -0,0 +1,23 @@
+package com.branddev.api.core
+
+import java.time.Duration
+import java.util.concurrent.CompletableFuture
+
+/**
+ * A delegating wrapper around a [Sleeper] that closes it once it's only phantom reachable.
+ *
+ * This class ensures the [Sleeper] is closed even if the user forgets to do it.
+ */
+internal class PhantomReachableSleeper(private val sleeper: Sleeper) : Sleeper {
+
+    init {
+        closeWhenPhantomReachable(this, sleeper)
+    }
+
+    override fun sleep(duration: Duration) = sleeper.sleep(duration)
+
+    override fun sleepAsync(duration: Duration): CompletableFuture<Void> =
+        sleeper.sleepAsync(duration)
+
+    override fun close() = sleeper.close()
+}

brand-dev-java-core/src/main/kotlin/com/branddev/api/core/Properties.kt

@@ -2,7 +2,7 @@
 
 package com.branddev.api.core
 
-import java.util.Properties
+import com.branddev.api.client.BrandDevClient
 
 fun getOsArch(): String {
     val osArch = System.getProperty("os.arch")
@@ -16,7 +16,7 @@ fun getOsArch(): String {
         "x86_64" -> "x64"
         "arm" -> "arm"
         "aarch64" -> "arm64"
-        else -> "other:${osArch}"
+        else -> "other:$osArch"
     }
 }
 
@@ -30,13 +30,13 @@ fun getOsName(): String {
         osName.startsWith("Linux") -> "Linux"
         osName.startsWith("Mac OS") -> "MacOS"
         osName.startsWith("Windows") -> "Windows"
-        else -> "Other:${osName}"
+        else -> "Other:$osName"
     }
 }
 
 fun getOsVersion(): String = System.getProperty("os.version", "unknown")
 
 fun getPackageVersion(): String =
-    Properties::class.java.`package`.implementationVersion ?: "unknown"
+    BrandDevClient::class.java.`package`.implementationVersion ?: "unknown"
 
 fun getJavaVersion(): String = System.getProperty("java.version", "unknown")