release: 0.1.0-alpha.3 (#15)

* feat(api): add 'status' to plan creation params (#14)

* chore(docs): document minimum Java version (Java 8) in README (#16)

* chore(ci): also run workflows for PRs targeting `next` (#17)

* docs(examples): update example values (#18)

* chore(docs): minor update to formatting of API link in README (#19)

* chore: minor updates (#20)

* feat(api): add methods to prices and invoices (#21)

* chore(ci): limit release doctor target branches (#22)

* chore(internal): refactor release doctor script (#23)

* chore(tests): update prism version (#24)

* feat(api): add cadence enum value 'custom' (#25)

* chore(internal): remove unused test file (#26)

* feat(client): improve binary return values (#27)

* chore(ci): run tests in CI (#28)

* feat(api): deprecate methods 'customers.usage.create' and 'customers.usage.update_by_external_id' (#29)

Please use the 'events.backfills.create' instead.
See https://docs.withorb.com/reference/create-backfill for more details.

* feat(api)!: remove methods 'customers.usage.create' and 'customers.usage.update_by_external_id' (#30)

## Migration
The two methods `customers.usage.create` and `customers.usage.update_by_external_id` have been removed from the SDK and the API.
Please use 'events.backfills.create' instead.
More details for this endpoint can be found at https://docs.withorb.com/reference/create-backfill

* release: 0.1.0-alpha.3

---------

Co-authored-by: stainless-app[bot] <142633134+stainless-app[bot]@users.noreply.github.com>

Author: stainless-app[bot]

.github/workflows/ci.yml

@@ -6,6 +6,7 @@ on:
   pull_request:
     branches:
       - main
+      - next
 
 jobs:
   lint:
@@ -33,4 +34,26 @@ jobs:
 
       - name: Run lints
         run: ./scripts/lint
+  test:
+    name: test
+    runs-on: ubuntu-latest
+    if: github.repository == 'orbcorp/orb-java'
+
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Set up Java
+        uses: actions/setup-java@v4
+        with:
+          distribution: temurin
+          java-version: |
+            8
+            17
+          cache: gradle
+
+      - name: Set up Gradle
+        uses: gradle/gradle-build-action@v2
+
+      - name: Run tests
+        run: ./scripts/test
 

.github/workflows/release-doctor.yml

@@ -1,6 +1,8 @@
 name: Release Doctor
 on:
   pull_request:
+    branches:
+      - main
   workflow_dispatch:
 
 jobs:

.release-please-manifest.json

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

.stats.yml

@@ -1,2 +1,2 @@
-configured_endpoints: 90
-openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/orb-75733a914692b0abe72ba99d622fc55b20da1c7fa7f73e2bfee30dfe32b66a51.yml
+configured_endpoints: 91
+openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/orb-83ae433113181f3839cc63db01cc7c815de1fff597a1cbaf8ffda48ba98268c9.yml

CHANGELOG.md

@@ -1,5 +1,40 @@
 # Changelog
 
+## 0.1.0-alpha.3 (2024-08-02)
+
+Full Changelog: [v0.1.0-alpha.2...v0.1.0-alpha.3](https://github.com/orbcorp/orb-java/compare/v0.1.0-alpha.2...v0.1.0-alpha.3)
+
+### ⚠ BREAKING CHANGES
+
+* **api:** remove methods 'customers.usage.create' and 'customers.usage.update_by_external_id' ([#30](https://github.com/orbcorp/orb-java/issues/30))
+
+### Features
+
+* **api:** add 'status' to plan creation params ([#14](https://github.com/orbcorp/orb-java/issues/14)) ([02ccf47](https://github.com/orbcorp/orb-java/commit/02ccf47af0f4af169c64181f8c2a429c3bd806d5))
+* **api:** add cadence enum value 'custom' ([#25](https://github.com/orbcorp/orb-java/issues/25)) ([61cf205](https://github.com/orbcorp/orb-java/commit/61cf205b1471425231e68a84f6fd09aafce2906a))
+* **api:** add methods to prices and invoices ([#21](https://github.com/orbcorp/orb-java/issues/21)) ([5dbd997](https://github.com/orbcorp/orb-java/commit/5dbd9976b888c451807d1bc89e4a6648b262ada3))
+* **api:** deprecate methods 'customers.usage.create' and 'customers.usage.update_by_external_id' ([#29](https://github.com/orbcorp/orb-java/issues/29)) ([756a150](https://github.com/orbcorp/orb-java/commit/756a1508b262870be8ebccef56e5485655296494))
+* **api:** remove methods 'customers.usage.create' and 'customers.usage.update_by_external_id' ([#30](https://github.com/orbcorp/orb-java/issues/30)) ([988218e](https://github.com/orbcorp/orb-java/commit/988218ee7687b8864ebc9efcffd7d790db2cd193))
+* **client:** improve binary return values ([#27](https://github.com/orbcorp/orb-java/issues/27)) ([e5abbb9](https://github.com/orbcorp/orb-java/commit/e5abbb9aed50ce44038e3fb3e305283c550411e0))
+
+
+### Chores
+
+* **ci:** also run workflows for PRs targeting `next` ([#17](https://github.com/orbcorp/orb-java/issues/17)) ([9f47531](https://github.com/orbcorp/orb-java/commit/9f47531a64cd4e8a53d209e4e5b151de480c3fd8))
+* **ci:** limit release doctor target branches ([#22](https://github.com/orbcorp/orb-java/issues/22)) ([92f41a2](https://github.com/orbcorp/orb-java/commit/92f41a24e12e4296f8413aa91f754c35bb09eecc))
+* **ci:** run tests in CI ([#28](https://github.com/orbcorp/orb-java/issues/28)) ([e4c2eb6](https://github.com/orbcorp/orb-java/commit/e4c2eb6ff95f34422415bf3fb54535da2fdc3d82))
+* **docs:** document minimum Java version (Java 8) in README ([#16](https://github.com/orbcorp/orb-java/issues/16)) ([3630a08](https://github.com/orbcorp/orb-java/commit/3630a08e5894b62f238e9531dadcee4a20670cb2))
+* **docs:** minor update to formatting of API link in README ([#19](https://github.com/orbcorp/orb-java/issues/19)) ([65f8385](https://github.com/orbcorp/orb-java/commit/65f8385253f16aec74d69690829ce3f3e2c05ca3))
+* **internal:** refactor release doctor script ([#23](https://github.com/orbcorp/orb-java/issues/23)) ([c039b0e](https://github.com/orbcorp/orb-java/commit/c039b0ea8b1643d7bcd8d4dc1553bdc6e041f7fe))
+* **internal:** remove unused test file ([#26](https://github.com/orbcorp/orb-java/issues/26)) ([71b39db](https://github.com/orbcorp/orb-java/commit/71b39dbe04efeed6d9c20363f00950334266d93e))
+* minor updates ([#20](https://github.com/orbcorp/orb-java/issues/20)) ([42c2a5c](https://github.com/orbcorp/orb-java/commit/42c2a5c9bca4a2af016fa724ce78197fc6a05549))
+* **tests:** update prism version ([#24](https://github.com/orbcorp/orb-java/issues/24)) ([b14155d](https://github.com/orbcorp/orb-java/commit/b14155d55ee6c312d415037fccce9a90ccd0b58f))
+
+
+### Documentation
+
+* **examples:** update example values ([#18](https://github.com/orbcorp/orb-java/issues/18)) ([7943f58](https://github.com/orbcorp/orb-java/commit/7943f58bb9615f95d33dba70040c2cfcc4edb7db))
+
 ## 0.1.0-alpha.2 (2024-06-28)
 
 Full Changelog: [v0.1.0-alpha.1...v0.1.0-alpha.2](https://github.com/orbcorp/orb-java/compare/v0.1.0-alpha.1...v0.1.0-alpha.2)

README.md

@@ -2,7 +2,7 @@
 
 <!-- x-release-please-start-version -->
 
-[![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.1.0-alpha.2)
+[![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.1.0-alpha.3)
 
 <!-- x-release-please-end -->
 
@@ -12,7 +12,7 @@ The Orb Java SDK is similar to the Orb Kotlin SDK but with minor differences tha
 
 ## Documentation
 
-The REST API documentation can be found [on docs.withorb.com](https://docs.withorb.com/reference/api-reference).
+The REST API documentation can be found on [docs.withorb.com](https://docs.withorb.com/reference/api-reference).
 
 ---
 
@@ -25,7 +25,7 @@ The REST API documentation can be found [on docs.withorb.com](https://docs.with
 <!-- x-release-please-start-version -->
 
 ```kotlin
-implementation("com.withorb.api:orb-java:0.1.0-alpha.2")
+implementation("com.withorb.api:orb-java:0.1.0-alpha.3")
 ```
 
 #### Maven
@@ -34,7 +34,7 @@ implementation("com.withorb.api:orb-java:0.1.0-alpha.2")
 <dependency>
     <groupId>com.withorb.api</groupId>
     <artifactId>orb-java</artifactId>
-    <version>0.1.0-alpha.2</version>
+    <version>0.1.0-alpha.3</version>
 </dependency>
 ```
 
@@ -319,3 +319,7 @@ This package generally follows [SemVer](https://semver.org/spec/v2.0.0.html) con
 We take backwards-compatibility seriously and work hard to ensure you can rely on a smooth upgrade experience.
 
 We are keen for your feedback; please open an [issue](https://www.github.com/orbcorp/orb-java/issues) with questions, bugs, or suggestions.
+
+## Requirements
+
+This library requires Java 8 or later.

bin/check-release-environment

@@ -1,32 +1,21 @@
 #!/usr/bin/env bash
 
-warnings=()
 errors=()
 
 if [ -z "${SONATYPE_USERNAME}" ]; then
-  warnings+=("The ORB_SONATYPE_USERNAME secret has not been set. Please set it in either this repository's secrets or your organization secrets")
+  errors+=("The ORB_SONATYPE_USERNAME secret has not been set. Please set it in either this repository's secrets or your organization secrets")
 fi
 
 if [ -z "${SONATYPE_PASSWORD}" ]; then
-  warnings+=("The ORB_SONATYPE_PASSWORD secret has not been set. Please set it in either this repository's secrets or your organization secrets")
+  errors+=("The ORB_SONATYPE_PASSWORD secret has not been set. Please set it in either this repository's secrets or your organization secrets")
 fi
 
 if [ -z "${GPG_SIGNING_KEY}" ]; then
-  warnings+=("The ORB_SONATYPE_GPG_SIGNING_KEY secret has not been set. Please set it in either this repository's secrets or your organization secrets")
+  errors+=("The ORB_SONATYPE_GPG_SIGNING_KEY secret has not been set. Please set it in either this repository's secrets or your organization secrets")
 fi
 
 if [ -z "${GPG_SIGNING_PASSWORD}" ]; then
-  warnings+=("The ORB_SONATYPE_GPG_SIGNING_PASSWORD secret has not been set. Please set it in either this repository's secrets or your organization secrets")
-fi
-
-lenWarnings=${#warnings[@]}
-
-if [[ lenWarnings -gt 0 ]]; then
-  echo -e "Found the following warnings in the release environment:\n"
-
-  for warning in "${warnings[@]}"; do
-    echo -e "- $warning\n"
-  done
+  errors+=("The ORB_SONATYPE_GPG_SIGNING_PASSWORD secret has not been set. Please set it in either this repository's secrets or your organization secrets")
 fi
 
 lenErrors=${#errors[@]}

build.gradle.kts

@@ -4,7 +4,7 @@ plugins {
 
 allprojects {
     group = "com.withorb.api"
-    version = "0.1.0-alpha.2" // x-release-please-version
+    version = "0.1.0-alpha.3" // x-release-please-version
 }
 
 

orb-java-core/src/main/kotlin/com/withorb/api/core/http/BinaryResponseContent.kt

@@ -1,13 +1,14 @@
 package com.withorb.api.core.http
 
-import java.io.Closeable
 import java.io.IOException
 import java.io.InputStream
 import java.io.OutputStream
+import java.lang.AutoCloseable
+import java.util.Optional
 
-interface BinaryResponseContent : Closeable {
+interface BinaryResponseContent : AutoCloseable {
 
-    fun contentType(): String?
+    fun contentType(): Optional<String>
 
     fun body(): InputStream
 

orb-java-core/src/main/kotlin/com/withorb/api/core/http/HttpClient.kt

@@ -1,10 +1,10 @@
 package com.withorb.api.core.http
 
 import com.withorb.api.core.RequestOptions
-import java.io.Closeable
+import java.lang.AutoCloseable
 import java.util.concurrent.CompletableFuture
 
-interface HttpClient : Closeable {
+interface HttpClient : AutoCloseable {
 
     fun execute(
         request: HttpRequest,