Merge pull request #70 from hathora/speakeasy-sdk-regen-1756253357

chore: 🐝 Update SDK - Generate 3.2.0

Author: hpx7

.speakeasy/gen.lock

@@ -1,21 +1,21 @@
-speakeasyVersion: 1.552.0
+speakeasyVersion: 1.606.6
 sources:
     java-source:
         sourceNamespace: java-source
-        sourceRevisionDigest: sha256:ec4e4b2248bf073eae30616ae548ebb528bd7dd450661459e7f8a4417cd2023b
-        sourceBlobDigest: sha256:cf474b64da154302d2fd12b2f60c31bad84ceb2d89aa94b74ce02722532ca75e
+        sourceRevisionDigest: sha256:577401c910d4e5966fd680144e0ef3d38620dee02ce6a7cc70bd64ee90d0dcaa
+        sourceBlobDigest: sha256:7037c4a3cfad22d533120b46da9b211a5f42427f8b70e36998095e3bf84b6bb1
         tags:
             - latest
-            - speakeasy-sdk-regen-1748389981
+            - speakeasy-sdk-regen-1756253357
             - 0.0.1
 targets:
     hathora-java:
         source: java-source
         sourceNamespace: java-source
-        sourceRevisionDigest: sha256:ec4e4b2248bf073eae30616ae548ebb528bd7dd450661459e7f8a4417cd2023b
-        sourceBlobDigest: sha256:cf474b64da154302d2fd12b2f60c31bad84ceb2d89aa94b74ce02722532ca75e
+        sourceRevisionDigest: sha256:577401c910d4e5966fd680144e0ef3d38620dee02ce6a7cc70bd64ee90d0dcaa
+        sourceBlobDigest: sha256:7037c4a3cfad22d533120b46da9b211a5f42427f8b70e36998095e3bf84b6bb1
         codeSamplesNamespace: code-samples-java-hathora-java
-        codeSamplesRevisionDigest: sha256:0cea5bbd21bf26cec86660584d915d6a0a0e180f04620e775aedec46aa60f88b
+        codeSamplesRevisionDigest: sha256:cd1ce58fba3f87119d56205751f2fa15390bdeb8b5bedffd8d65c1155c24bcd2
 workflow:
     workflowVersion: 1.0.0
     speakeasyVersion: latest

.speakeasy/workflow.lock

@@ -22,6 +22,7 @@ Hathora Cloud API: Welcome to the Hathora Cloud API documentation! Learn how to
   * [Error Handling](#error-handling)
   * [Server Selection](#server-selection)
   * [Authentication](#authentication)
+  * [Debugging](#debugging)
 
 <!-- End Table of Contents [toc] -->
 
@@ -36,15 +37,15 @@ The samples below show how a published SDK artifact is used:
 
 Gradle:
 ```groovy
-implementation 'dev.hathora:cloud-sdk:3.1.10'
+implementation 'dev.hathora:cloud-sdk:3.2.0'
 ```
 
 Maven:
 ```xml
 <dependency>
     <groupId>dev.hathora</groupId>
     <artifactId>cloud-sdk</artifactId>
-    <version>3.1.10</version>
+    <version>3.2.0</version>
 </dependency>
 ```
 
@@ -61,29 +62,6 @@ On Windows:
 ```bash
 gradlew.bat publishToMavenLocal -Pskip.signing
 ```
-
-### Logging
-A logging framework/facade has not yet been adopted but is under consideration.
-
-For request and response logging (especially json bodies) use:
-```java
-SpeakeasyHTTPClient.setDebugLogging(true); // experimental API only (may change without warning)
-```
-Example output:
-```
-Sending request: http://localhost:35123/bearer#global GET
-Request headers: {Accept=[application/json], Authorization=[******], Client-Level-Header=[added by client], Idempotency-Key=[some-key], x-speakeasy-user-agent=[speakeasy-sdk/java 0.0.1 internal 0.1.0 org.openapis.openapi]}
-Received response: (GET http://localhost:35123/bearer#global) 200
-Response headers: {access-control-allow-credentials=[true], access-control-allow-origin=[*], connection=[keep-alive], content-length=[50], content-type=[application/json], date=[Wed, 09 Apr 2025 01:43:29 GMT], server=[gunicorn/19.9.0]}
-Response body:
-{
-  "authenticated": true, 
-  "token": "global"
-}
-```
-WARNING: This should only used for temporary debugging purposes. Leaving this option on in a production system could expose credentials/secrets in logs. <i>Authorization</i> headers are redacted by default and there is the ability to specify redacted header names via `SpeakeasyHTTPClient.setRedactedHeaders`.
-
-Another option is to set the System property `-Djdk.httpclient.HttpClient.log=all`. However, this second option does not log bodies.
 <!-- End SDK Installation [installation] -->
 
 <!-- Start SDK Example Usage [usage] -->
@@ -105,15 +83,14 @@ public class Application {
     public static void main(String[] args) throws ApiError, ApiError, Exception {
 
         HathoraCloud sdk = HathoraCloud.builder()
+                .orgId("org-6f706e83-0ec1-437a-9a46-7d4281eb2f39")
                 .security(Security.builder()
-                    .hathoraDevToken("<YOUR_BEARER_TOKEN_HERE>")
+                    .hathoraDevToken(System.getenv().getOrDefault("HATHORA_DEV_TOKEN", ""))
                     .build())
-                .appId("app-af469a92-5b45-4565-b3c4-b79878de67d2")
-                .orgId("org-6f706e83-0ec1-437a-9a46-7d4281eb2f39")
             .build();
 
         CreateAppResponse res = sdk.appsV2().createApp()
-                .appConfig(AppConfig.builder()
+                .createAppConfig(CreateAppConfig.builder()
                     .appName("minecraft")
                     .authConfiguration(AuthConfiguration.builder()
                         .build())
@@ -368,15 +345,15 @@ public class Application {
     public static void main(String[] args) throws ApiError, ApiError, Exception {
 
         HathoraCloud sdk = HathoraCloud.builder()
+                .orgId("org-6f706e83-0ec1-437a-9a46-7d4281eb2f39")
+                .appId("app-af469a92-5b45-4565-b3c4-b79878de67d2")
                 .security(Security.builder()
-                    .hathoraDevToken("<YOUR_BEARER_TOKEN_HERE>")
+                    .hathoraDevToken(System.getenv().getOrDefault("HATHORA_DEV_TOKEN", ""))
                     .build())
-                .appId("app-af469a92-5b45-4565-b3c4-b79878de67d2")
-                .orgId("org-6f706e83-0ec1-437a-9a46-7d4281eb2f39")
             .build();
 
         CreateAppResponse res = sdk.appsV2().createApp()
-                .appConfig(AppConfig.builder()
+                .createAppConfig(CreateAppConfig.builder()
                     .appName("minecraft")
                     .authConfiguration(AuthConfiguration.builder()
                         .build())
@@ -420,15 +397,14 @@ public class Application {
     public static void main(String[] args) throws ApiError, ApiError, Exception {
 
         HathoraCloud sdk = HathoraCloud.builder()
+                .orgId("org-6f706e83-0ec1-437a-9a46-7d4281eb2f39")
                 .security(Security.builder()
-                    .hathoraDevToken("<YOUR_BEARER_TOKEN_HERE>")
+                    .hathoraDevToken(System.getenv().getOrDefault("HATHORA_DEV_TOKEN", ""))
                     .build())
-                .appId("app-af469a92-5b45-4565-b3c4-b79878de67d2")
-                .orgId("org-6f706e83-0ec1-437a-9a46-7d4281eb2f39")
             .build();
 
         CreateAppResponse res = sdk.appsV2().createApp()
-                .appConfig(AppConfig.builder()
+                .createAppConfig(CreateAppConfig.builder()
                     .appName("minecraft")
                     .authConfiguration(AuthConfiguration.builder()
                         .build())
@@ -472,15 +448,14 @@ public class Application {
 
         HathoraCloud sdk = HathoraCloud.builder()
                 .serverIndex(1)
+                .orgId("org-6f706e83-0ec1-437a-9a46-7d4281eb2f39")
                 .security(Security.builder()
-                    .hathoraDevToken("<YOUR_BEARER_TOKEN_HERE>")
+                    .hathoraDevToken(System.getenv().getOrDefault("HATHORA_DEV_TOKEN", ""))
                     .build())
-                .appId("app-af469a92-5b45-4565-b3c4-b79878de67d2")
-                .orgId("org-6f706e83-0ec1-437a-9a46-7d4281eb2f39")
             .build();
 
         CreateAppResponse res = sdk.appsV2().createApp()
-                .appConfig(AppConfig.builder()
+                .createAppConfig(CreateAppConfig.builder()
                     .appName("minecraft")
                     .authConfiguration(AuthConfiguration.builder()
                         .build())
@@ -512,15 +487,14 @@ public class Application {
 
         HathoraCloud sdk = HathoraCloud.builder()
                 .serverURL("https://api.hathora.dev")
+                .orgId("org-6f706e83-0ec1-437a-9a46-7d4281eb2f39")
                 .security(Security.builder()
-                    .hathoraDevToken("<YOUR_BEARER_TOKEN_HERE>")
+                    .hathoraDevToken(System.getenv().getOrDefault("HATHORA_DEV_TOKEN", ""))
                     .build())
-                .appId("app-af469a92-5b45-4565-b3c4-b79878de67d2")
-                .orgId("org-6f706e83-0ec1-437a-9a46-7d4281eb2f39")
             .build();
 
         CreateAppResponse res = sdk.appsV2().createApp()
-                .appConfig(AppConfig.builder()
+                .createAppConfig(CreateAppConfig.builder()
                     .appName("minecraft")
                     .authConfiguration(AuthConfiguration.builder()
                         .build())
@@ -562,14 +536,13 @@ public class Application {
 
         HathoraCloud sdk = HathoraCloud.builder()
                 .security(Security.builder()
-                    .hathoraDevToken("<YOUR_BEARER_TOKEN_HERE>")
+                    .hathoraDevToken(System.getenv().getOrDefault("HATHORA_DEV_TOKEN", ""))
                     .build())
-                .appId("app-af469a92-5b45-4565-b3c4-b79878de67d2")
                 .orgId("org-6f706e83-0ec1-437a-9a46-7d4281eb2f39")
             .build();
 
         CreateAppResponse res = sdk.appsV2().createApp()
-                .appConfig(AppConfig.builder()
+                .createAppConfig(CreateAppConfig.builder()
                     .appName("minecraft")
                     .authConfiguration(AuthConfiguration.builder()
                         .build())
@@ -601,7 +574,6 @@ public class Application {
 
         HathoraCloud sdk = HathoraCloud.builder()
                 .appId("app-af469a92-5b45-4565-b3c4-b79878de67d2")
-                .orgId("org-6f706e83-0ec1-437a-9a46-7d4281eb2f39")
             .build();
 
         CreateLobbyRequest req = CreateLobbyRequest.builder()
@@ -610,15 +582,14 @@ public class Application {
                     .visibility(LobbyVisibility.PRIVATE)
                     .roomConfig("{\"name\":\"my-room\"}")
                     .build())
-                .appId("app-af469a92-5b45-4565-b3c4-b79878de67d2")
                 .roomId("2swovpy1fnunu")
                 .shortCode("LFG4")
                 .build();
 
         CreateLobbyResponse res = sdk.lobbiesV3().createLobby()
                 .request(req)
                 .security(CreateLobbySecurity.builder()
-                    .playerAuth("<YOUR_BEARER_TOKEN_HERE>")
+                    .playerAuth(System.getenv().getOrDefault("PLAYER_AUTH", ""))
                     .build())
                 .call();
 
@@ -630,6 +601,37 @@ public class Application {
 ```
 <!-- End Authentication [security] -->
 
+<!-- Start Debugging [debug] -->
+## Debugging
+
+### Debug
+You can setup your SDK to emit debug logs for SDK requests and responses.
+
+For request and response logging (especially json bodies), call `enableHTTPDebugLogging(boolean)` on the SDK builder like so:
+```java
+SDK.builder()
+    .enableHTTPDebugLogging(true)
+    .build();
+```
+Example output:
+```
+Sending request: http://localhost:35123/bearer#global GET
+Request headers: {Accept=[application/json], Authorization=[******], Client-Level-Header=[added by client], Idempotency-Key=[some-key], x-speakeasy-user-agent=[speakeasy-sdk/java 0.0.1 internal 0.1.0 org.openapis.openapi]}
+Received response: (GET http://localhost:35123/bearer#global) 200
+Response headers: {access-control-allow-credentials=[true], access-control-allow-origin=[*], connection=[keep-alive], content-length=[50], content-type=[application/json], date=[Wed, 09 Apr 2025 01:43:29 GMT], server=[gunicorn/19.9.0]}
+Response body:
+{
+  "authenticated": true, 
+  "token": "global"
+}
+```
+__WARNING__: This should only used for temporary debugging purposes. Leaving this option on in a production system could expose credentials/secrets in logs. <i>Authorization</i> headers are redacted by default and there is the ability to specify redacted header names via `SpeakeasyHTTPClient.setRedactedHeaders`.
+
+__NOTE__: This is a convenience method that calls `HTTPClient.enableDebugLogging()`. The `SpeakeasyHTTPClient` honors this setting. If you are using a custom HTTP client, it is up to the custom client to honor this setting.
+
+Another option is to set the System property `-Djdk.httpclient.HttpClient.log=all`. However, this second option does not log bodies.
+<!-- End Debugging [debug] -->
+
 <!-- Placeholder for Future Speakeasy SDK Sections -->
 
 ### Maturity

README.md

@@ -1159,4 +1159,14 @@ Based on:
 ### Generated
 - [java v3.1.10] .
 ### Releases
-- [Maven Central v3.1.10] https://central.sonatype.com/artifact/dev.hathora/cloud-sdk/3.1.10 - .
+- [Maven Central v3.1.10] https://central.sonatype.com/artifact/dev.hathora/cloud-sdk/3.1.10 - .
+
+## 2025-08-27 12:39:59
+### Changes
+Based on:
+- OpenAPI Doc  
+- Speakeasy CLI 1.606.6 (2.687.11) https://github.com/speakeasy-api/speakeasy
+### Generated
+- [java v3.2.0] .
+### Releases
+- [Maven Central v3.2.0] https://central.sonatype.com/artifact/dev.hathora/cloud-sdk/3.2.0 - .

RELEASES.md

@@ -13,15 +13,14 @@ public class Application {
     public static void main(String[] args) throws ApiError, ApiError, Exception {
 
         HathoraCloud sdk = HathoraCloud.builder()
+                .orgId("org-6f706e83-0ec1-437a-9a46-7d4281eb2f39")
                 .security(Security.builder()
-                    .hathoraDevToken("<YOUR_BEARER_TOKEN_HERE>")
+                    .hathoraDevToken(System.getenv().getOrDefault("HATHORA_DEV_TOKEN", ""))
                     .build())
-                .appId("app-af469a92-5b45-4565-b3c4-b79878de67d2")
-                .orgId("org-6f706e83-0ec1-437a-9a46-7d4281eb2f39")
             .build();
 
         CreateAppResponse res = sdk.appsV2().createApp()
-                .appConfig(AppConfig.builder()
+                .createAppConfig(CreateAppConfig.builder()
                     .appName("minecraft")
                     .authConfiguration(AuthConfiguration.builder()
                         .build())

USAGE.md

@@ -27,8 +27,6 @@ repositories {
 }
 
 java {
-    sourceCompatibility = JavaVersion.VERSION_11
-    targetCompatibility = JavaVersion.VERSION_11
     withSourcesJar()
     withJavadocJar()
 }
@@ -61,10 +59,14 @@ javadoc {
 }
 
 tasks.withType(Javadoc) {
-  failOnError false
+  failOnError = false
   options.addStringOption('Xdoclint:none', '-quiet')
 }
 
+tasks.withType(JavaCompile).configureEach {
+    options.release = 11
+}
+
 sourcesJar {
     archiveBaseName = "${artifactId}"
 }
@@ -103,11 +105,15 @@ publishing {
             // https://github.com/gradle/gradle/issues/18619
             groupId = "dev.hathora"
             artifactId = "cloud-sdk"
-            version = "3.1.10"
+            version = "3.2.0"
 
             from components.java
 
             pom {
+                properties = [
+                    'maven.compiler.source': '11',
+                    'maven.compiler.target': '11',
+                ]
                 name = 'Hathora Java SDK'
                 description = 'SDK enabling Java developers to easily integrate with the Hathora API.'
                 url = 'https://github.com/hathora/cloud-sdk-java'
@@ -160,4 +166,4 @@ dependencies {
     implementation 'commons-io:commons-io:2.18.0'
 }
 
-apply from: 'build-extras.gradle'
+apply from: 'build-extras.gradle'