ci: regenerated with OpenAPI Doc , Speakeasy CLI 1.581.0

Author: speakeasybot

.speakeasy/gen.lock

@@ -16,8 +16,12 @@ generation:
   auth:
     oAuth2ClientCredentialsEnabled: true
     oAuth2PasswordEnabled: false
+  tests:
+    generateTests: true
+    generateNewTests: false
+    skipResponseBodyAssertions: false
 java:
-  version: 3.0.3
+  version: 3.1.0
   additionalDependencies: []
   additionalPlugins: []
   artifactID: backend-api
@@ -27,6 +31,7 @@ java:
   companyName: My Company
   companyURL: www.mycompany.com
   defaultErrorName: SDKError
+  enableCustomCodeRegions: false
   flattenGlobalSecurity: true
   githubURL: github.com/owner/repo
   groupID: com.clerk
@@ -39,11 +44,13 @@ java:
       shared: models/components
       webhooks: models/webhooks
   inputModelSuffix: input
+  languageVersion: 11
   license:
     name: The MIT License (MIT)
     shortName: MIT
     url: https://mit-license.org/
   maxMethodParams: 4
+  nullFriendlyParameters: false
   outputModelSuffix: output
   projectName: api
   templateVersion: v2

.speakeasy/gen.yaml

@@ -1,21 +1,21 @@
-speakeasyVersion: 1.557.1
+speakeasyVersion: 1.581.0
 sources:
     clerk-java-sdk:
         sourceNamespace: clerk-java-sdk
-        sourceRevisionDigest: sha256:9a7f600b8eaae8695f69a25e152d156a7a06c7596a669524fd69d0fb7898dcc1
-        sourceBlobDigest: sha256:7d364a0a7b05961ccc0d3990c9ca939ff08a410b6b6855ea60a6041c9ef4bfbf
+        sourceRevisionDigest: sha256:a0369948fffa0b0b8b15040dde660eaf6539e8432246114045a245e3c67d7d23
+        sourceBlobDigest: sha256:8f0e9fa692ea41f67ecc4d340d53a1db022a6e949c11bb0f73e333b910400bf1
         tags:
             - latest
-            - speakeasy-sdk-regen-1749475071
+            - speakeasy-sdk-regen-1752252043
             - "2025-03-12"
 targets:
     clerk-java:
         source: clerk-java-sdk
         sourceNamespace: clerk-java-sdk
-        sourceRevisionDigest: sha256:9a7f600b8eaae8695f69a25e152d156a7a06c7596a669524fd69d0fb7898dcc1
-        sourceBlobDigest: sha256:7d364a0a7b05961ccc0d3990c9ca939ff08a410b6b6855ea60a6041c9ef4bfbf
+        sourceRevisionDigest: sha256:a0369948fffa0b0b8b15040dde660eaf6539e8432246114045a245e3c67d7d23
+        sourceBlobDigest: sha256:8f0e9fa692ea41f67ecc4d340d53a1db022a6e949c11bb0f73e333b910400bf1
         codeSamplesNamespace: clerk-java-sdk-code-samples
-        codeSamplesRevisionDigest: sha256:592bd5abfdbbb3b973a6ceced9e3aa6df96b009905191ff187a3df7fd8c22d43
+        codeSamplesRevisionDigest: sha256:3576a97da095b39c8caa9d7dacc5159d9fdfb8c8e51a3bf5c38eefebe98bc077
     my-first-target:
         source: clerk-java-sdk
         sourceNamespace: clerk-java-sdk

.speakeasy/workflow.lock

@@ -34,6 +34,7 @@ More information about the API can be found at https://clerk.com/docs
   * [Retries](#retries)
   * [Error Handling](#error-handling)
   * [Server Selection](#server-selection)
+  * [Debugging](#debugging)
 * [Development](#development)
   * [Contributions](#contributions)
 
@@ -50,15 +51,15 @@ The samples below show how a published SDK artifact is used:
 
 Gradle:
 ```groovy
-implementation 'com.clerk:backend-api:3.0.3'
+implementation 'com.clerk:backend-api:3.1.0'
 ```
 
 Maven:
 ```xml
 <dependency>
     <groupId>com.clerk</groupId>
     <artifactId>backend-api</artifactId>
-    <version>3.0.3</version>
+    <version>3.1.0</version>
 </dependency>
 ```
 
@@ -75,29 +76,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] -->
@@ -152,7 +130,7 @@ public class Application {
     public static void main(String[] args) throws Exception {
 
         Clerk sdk = Clerk.builder()
-                .bearerAuth("<YOUR_BEARER_TOKEN_HERE>")
+                .bearerAuth(System.getenv().getOrDefault("BEARER_AUTH", ""))
             .build();
 
         GetPublicInterstitialResponse res = sdk.miscellaneous().getPublicInterstitial()
@@ -553,7 +531,7 @@ public class Application {
     public static void main(String[] args) throws ClerkErrors, Exception {
 
         Clerk sdk = Clerk.builder()
-                .bearerAuth("<YOUR_BEARER_TOKEN_HERE>")
+                .bearerAuth(System.getenv().getOrDefault("BEARER_AUTH", ""))
             .build();
 
         VerifyClientResponse res = sdk.clients().verify()
@@ -598,6 +576,37 @@ public class Application {
 <!-- End Server Selection [server] -->
 
 
+<!-- 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 -->
 
 # Development

README.md

@@ -328,4 +328,14 @@ Based on:
 ### Generated
 - [java v3.0.3] .
 ### Releases
-- [Maven Central v3.0.3] https://central.sonatype.com/artifact/com.clerk/backend-api/3.0.3 - .
+- [Maven Central v3.0.3] https://central.sonatype.com/artifact/com.clerk/backend-api/3.0.3 - .
+
+## 2025-07-11 16:40:26
+### Changes
+Based on:
+- OpenAPI Doc  
+- Speakeasy CLI 1.581.0 (2.656.5) https://github.com/speakeasy-api/speakeasy
+### Generated
+- [java v3.1.0] .
+### Releases
+- [Maven Central v3.1.0] https://central.sonatype.com/artifact/com.clerk/backend-api/3.1.0 - .

RELEASES.md

@@ -27,8 +27,6 @@ repositories {
 }
 
 java {
-    sourceCompatibility = JavaVersion.VERSION_11
-    targetCompatibility = JavaVersion.VERSION_11
     withSourcesJar()
     withJavadocJar()
 }
@@ -65,6 +63,10 @@ tasks.withType(Javadoc) {
   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 = "com.clerk"
             artifactId = "backend-api"
-            version = "3.0.3"
+            version = "3.1.0"
 
             from components.java
 
             pom {
+                properties = [
+                    'maven.compiler.source': '11',
+                    'maven.compiler.target': '11',
+                ]
                 name = 'My Company Java SDK'
                 description = 'SDK enabling Java developers to easily integrate with the My Company API.'
                 url = 'https://github.com/owner/repo'
@@ -157,4 +163,4 @@ dependencies {
     implementation 'commons-io:commons-io:2.18.0'
 }
 
-apply from: 'build-extras.gradle'
+apply from: 'build-extras.gradle'

build.gradle

@@ -28,7 +28,7 @@ public class Application {
     public static void main(String[] args) throws ClerkErrors, Exception {
 
         Clerk sdk = Clerk.builder()
-                .bearerAuth("<YOUR_BEARER_TOKEN_HERE>")
+                .bearerAuth(System.getenv().getOrDefault("BEARER_AUTH", ""))
             .build();
 
         CreateActorTokenRequestBody req = CreateActorTokenRequestBody.builder()
@@ -85,7 +85,7 @@ public class Application {
     public static void main(String[] args) throws ClerkErrors, Exception {
 
         Clerk sdk = Clerk.builder()
-                .bearerAuth("<YOUR_BEARER_TOKEN_HERE>")
+                .bearerAuth(System.getenv().getOrDefault("BEARER_AUTH", ""))
             .build();
 
         RevokeActorTokenResponse res = sdk.actorTokens().revoke()

docs/sdks/actortokens/README.md

@@ -28,7 +28,7 @@ public class Application {
     public static void main(String[] args) throws ClerkErrors, Exception {
 
         Clerk sdk = Clerk.builder()
-                .bearerAuth("<YOUR_BEARER_TOKEN_HERE>")
+                .bearerAuth(System.getenv().getOrDefault("BEARER_AUTH", ""))
             .build();
 
         ListAllowlistIdentifiersResponse res = sdk.allowlistIdentifiers().list()
@@ -81,7 +81,7 @@ public class Application {
     public static void main(String[] args) throws ClerkErrors, Exception {
 
         Clerk sdk = Clerk.builder()
-                .bearerAuth("<YOUR_BEARER_TOKEN_HERE>")
+                .bearerAuth(System.getenv().getOrDefault("BEARER_AUTH", ""))
             .build();
 
         CreateAllowlistIdentifierResponse res = sdk.allowlistIdentifiers().create()
@@ -130,7 +130,7 @@ public class Application {
     public static void main(String[] args) throws ClerkErrors, Exception {
 
         Clerk sdk = Clerk.builder()
-                .bearerAuth("<YOUR_BEARER_TOKEN_HERE>")
+                .bearerAuth(System.getenv().getOrDefault("BEARER_AUTH", ""))
             .build();
 
         DeleteAllowlistIdentifierResponse res = sdk.allowlistIdentifiers().delete()

docs/sdks/allowlistidentifiers/README.md

@@ -27,7 +27,7 @@ public class Application {
     public static void main(String[] args) throws ClerkErrors, Exception {
 
         Clerk sdk = Clerk.builder()
-                .bearerAuth("<YOUR_BEARER_TOKEN_HERE>")
+                .bearerAuth(System.getenv().getOrDefault("BEARER_AUTH", ""))
             .build();
 
         UpdateInstanceAuthConfigResponse res = sdk.betaFeatures().updateInstanceSettings()
@@ -82,7 +82,7 @@ public class Application {
     public static void main(String[] args) throws ClerkErrors, Exception {
 
         Clerk sdk = Clerk.builder()
-                .bearerAuth("<YOUR_BEARER_TOKEN_HERE>")
+                .bearerAuth(System.getenv().getOrDefault("BEARER_AUTH", ""))
             .build();
 
         UpdateProductionInstanceDomainResponse res = sdk.betaFeatures().updateProductionInstanceDomain()

docs/sdks/betafeatures/README.md

@@ -28,7 +28,7 @@ public class Application {
     public static void main(String[] args) throws ClerkErrors, Exception {
 
         Clerk sdk = Clerk.builder()
-                .bearerAuth("<YOUR_BEARER_TOKEN_HERE>")
+                .bearerAuth(System.getenv().getOrDefault("BEARER_AUTH", ""))
             .build();
 
         ListBlocklistIdentifiersResponse res = sdk.blocklistIdentifiers().list()
@@ -71,7 +71,7 @@ public class Application {
     public static void main(String[] args) throws ClerkErrors, Exception {
 
         Clerk sdk = Clerk.builder()
-                .bearerAuth("<YOUR_BEARER_TOKEN_HERE>")
+                .bearerAuth(System.getenv().getOrDefault("BEARER_AUTH", ""))
             .build();
 
         CreateBlocklistIdentifierResponse res = sdk.blocklistIdentifiers().create()
@@ -120,7 +120,7 @@ public class Application {
     public static void main(String[] args) throws ClerkErrors, Exception {
 
         Clerk sdk = Clerk.builder()
-                .bearerAuth("<YOUR_BEARER_TOKEN_HERE>")
+                .bearerAuth(System.getenv().getOrDefault("BEARER_AUTH", ""))
             .build();
 
         DeleteBlocklistIdentifierResponse res = sdk.blocklistIdentifiers().delete()