Merge pull request #68 from clerk/speakeasy-sdk-regen-1743638956

chore: 🐝 Update SDK - Generate 2.4.0

Author: speakeasybot

.gitattributes

@@ -8,5 +8,4 @@
 *.bat           text eol=crlf
 
 # This allows generated code to be indexed correctly
-*.java linguist-generated=false
-
+*.java linguist-generated=false

.gitignore

@@ -1,3 +1,5 @@
+**/.speakeasy/temp/
+**/.speakeasy/logs/
 .speakeasy/reports
 # Ignore Gradle project-specific cache directory
 .gradle

.speakeasy/gen.lock

@@ -1,21 +1,22 @@
 lockVersion: 2.0.0
 id: 1d22a5a4-8bac-42e3-b164-121fcacf66c9
 management:
-  docChecksum: 662be939df6caa6e3433d8c6d41c8719
+  docChecksum: b684ca32bc26235fae342e8e91c51f56
   docVersion: "2024-10-01"
-  speakeasyVersion: 1.526.5
-  generationVersion: 2.563.1
-  releaseVersion: 2.3.1
-  configChecksum: a786c6f591a522edb884ec3e63a95d8b
+  speakeasyVersion: 1.542.3
+  generationVersion: 2.597.9
+  releaseVersion: 2.4.0
+  configChecksum: c4f45121365eef47d63927cf7c32e270
   repoURL: https://github.com/clerk/clerk-sdk-java.git
   published: true
 features:
   java:
     additionalDependencies: 0.1.0
     additionalProperties: 0.0.1
     constsAndDefaults: 0.1.1
-    core: 3.36.0
+    core: 3.37.1
     deprecations: 2.81.1
+    examples: 2.81.5
     flattening: 2.81.1
     globalSecurity: 2.82.8
     globalSecurityCallbacks: 0.1.0
@@ -32,6 +33,8 @@ generatedFiles:
   - .gitattributes
   - USAGE.md
   - build.gradle
+  - docs/models/components/AccountlessApplication.md
+  - docs/models/components/AccountlessApplicationObject.md
   - docs/models/components/Actor.md
   - docs/models/components/ActorToken.md
   - docs/models/components/ActorTokenActor.md
@@ -101,6 +104,8 @@ generatedFiles:
   - docs/models/components/Meta.md
   - docs/models/components/NextAction.md
   - docs/models/components/Nonce.md
+  - docs/models/components/OAuthAccessToken.md
+  - docs/models/components/OAuthAccessTokenObject.md
   - docs/models/components/OAuthApplication.md
   - docs/models/components/OAuthApplicationObject.md
   - docs/models/components/OAuthApplicationWithSecret.md
@@ -230,6 +235,8 @@ generatedFiles:
   - docs/models/operations/ChangeProductionInstanceDomainResponse.md
   - docs/models/operations/Claims.md
   - docs/models/operations/CodeType.md
+  - docs/models/operations/CompleteAccountlessApplicationResponse.md
+  - docs/models/operations/CreateAccountlessApplicationResponse.md
   - docs/models/operations/CreateActorTokenRequestBody.md
   - docs/models/operations/CreateActorTokenResponse.md
   - docs/models/operations/CreateAllowlistIdentifierRequestBody.md
@@ -423,7 +430,6 @@ generatedFiles:
   - docs/models/operations/RefreshSessionRequestBody.md
   - docs/models/operations/RefreshSessionResponse.md
   - docs/models/operations/RequestBody.md
-  - docs/models/operations/ResponseBody.md
   - docs/models/operations/RevertTemplatePathParamTemplateType.md
   - docs/models/operations/RevertTemplateRequest.md
   - docs/models/operations/RevertTemplateResponse.md
@@ -546,6 +552,7 @@ generatedFiles:
   - docs/sdks/emailaddresses/README.md
   - docs/sdks/emailandsmstemplates/README.md
   - docs/sdks/emailsmstemplates/README.md
+  - docs/sdks/experimentalaccountlessapplications/README.md
   - docs/sdks/instancesettings/README.md
   - docs/sdks/invitations/README.md
   - docs/sdks/jwks/README.md
@@ -584,6 +591,7 @@ generatedFiles:
   - src/main/java/com/clerk/backend_api/EmailAddresses.java
   - src/main/java/com/clerk/backend_api/EmailAndSmsTemplates.java
   - src/main/java/com/clerk/backend_api/EmailSMSTemplates.java
+  - src/main/java/com/clerk/backend_api/ExperimentalAccountlessApplications.java
   - src/main/java/com/clerk/backend_api/InstanceSettings.java
   - src/main/java/com/clerk/backend_api/Invitations.java
   - src/main/java/com/clerk/backend_api/Jwks.java
@@ -608,6 +616,8 @@ generatedFiles:
   - src/main/java/com/clerk/backend_api/Users.java
   - src/main/java/com/clerk/backend_api/WaitlistEntries.java
   - src/main/java/com/clerk/backend_api/Webhooks.java
+  - src/main/java/com/clerk/backend_api/models/components/AccountlessApplication.java
+  - src/main/java/com/clerk/backend_api/models/components/AccountlessApplicationObject.java
   - src/main/java/com/clerk/backend_api/models/components/Actor.java
   - src/main/java/com/clerk/backend_api/models/components/ActorToken.java
   - src/main/java/com/clerk/backend_api/models/components/ActorTokenActor.java
@@ -677,6 +687,8 @@ generatedFiles:
   - src/main/java/com/clerk/backend_api/models/components/Meta.java
   - src/main/java/com/clerk/backend_api/models/components/NextAction.java
   - src/main/java/com/clerk/backend_api/models/components/Nonce.java
+  - src/main/java/com/clerk/backend_api/models/components/OAuthAccessToken.java
+  - src/main/java/com/clerk/backend_api/models/components/OAuthAccessTokenObject.java
   - src/main/java/com/clerk/backend_api/models/components/OAuthApplication.java
   - src/main/java/com/clerk/backend_api/models/components/OAuthApplicationObject.java
   - src/main/java/com/clerk/backend_api/models/components/OAuthApplicationWithSecret.java
@@ -811,6 +823,10 @@ generatedFiles:
   - src/main/java/com/clerk/backend_api/models/operations/ChangeProductionInstanceDomainResponse.java
   - src/main/java/com/clerk/backend_api/models/operations/Claims.java
   - src/main/java/com/clerk/backend_api/models/operations/CodeType.java
+  - src/main/java/com/clerk/backend_api/models/operations/CompleteAccountlessApplicationRequestBuilder.java
+  - src/main/java/com/clerk/backend_api/models/operations/CompleteAccountlessApplicationResponse.java
+  - src/main/java/com/clerk/backend_api/models/operations/CreateAccountlessApplicationRequestBuilder.java
+  - src/main/java/com/clerk/backend_api/models/operations/CreateAccountlessApplicationResponse.java
   - src/main/java/com/clerk/backend_api/models/operations/CreateActorTokenRequestBody.java
   - src/main/java/com/clerk/backend_api/models/operations/CreateActorTokenRequestBuilder.java
   - src/main/java/com/clerk/backend_api/models/operations/CreateActorTokenResponse.java
@@ -1091,7 +1107,6 @@ generatedFiles:
   - src/main/java/com/clerk/backend_api/models/operations/RefreshSessionRequestBuilder.java
   - src/main/java/com/clerk/backend_api/models/operations/RefreshSessionResponse.java
   - src/main/java/com/clerk/backend_api/models/operations/RequestBody.java
-  - src/main/java/com/clerk/backend_api/models/operations/ResponseBody.java
   - src/main/java/com/clerk/backend_api/models/operations/RevertTemplatePathParamTemplateType.java
   - src/main/java/com/clerk/backend_api/models/operations/RevertTemplateRequest.java
   - src/main/java/com/clerk/backend_api/models/operations/RevertTemplateRequestBuilder.java
@@ -1248,6 +1263,7 @@ generatedFiles:
   - src/main/java/com/clerk/backend_api/utils/BackoffStrategy.java
   - src/main/java/com/clerk/backend_api/utils/BigDecimalString.java
   - src/main/java/com/clerk/backend_api/utils/BigIntegerString.java
+  - src/main/java/com/clerk/backend_api/utils/Constants.java
   - src/main/java/com/clerk/backend_api/utils/Deserializers.java
   - src/main/java/com/clerk/backend_api/utils/EventStream.java
   - src/main/java/com/clerk/backend_api/utils/EventStreamLineReader.java
@@ -1329,7 +1345,7 @@ examples:
     speakeasy-default-create-email-address:
       responses:
         "200":
-          application/json: {"object": "email_address", "email_address": "[email protected]", "reserved": true, "verification": {"status": "unverified", "strategy": "reset_password_email_code", "expire_at": 586220, "attempts": 816588}, "linked_to": [{"type": "<value>", "id": "<id>"}, {"type": "<value>", "id": "<id>"}, {"type": "<value>", "id": "<id>"}], "created_at": 957409, "updated_at": 357021}
+          application/json: {"object": "email_address", "email_address": "[email protected]", "reserved": true, "verification": {"status": "unverified", "strategy": "reset_password_email_code", "attempts": 816588, "expire_at": 586220}, "linked_to": [{"type": "<value>", "id": "<id>"}, {"type": "<value>", "id": "<id>"}, {"type": "<value>", "id": "<id>"}], "created_at": 957409, "updated_at": 357021}
         "400":
           application/json: {"errors": [{"message": "<value>", "long_message": "<value>", "code": "<value>"}]}
   GetEmailAddress:
@@ -1359,7 +1375,7 @@ examples:
           email_address_id: "<id>"
       responses:
         "200":
-          application/json: {"object": "email_address", "email_address": "[email protected]", "reserved": true, "verification": {"status": "verified", "strategy": "ticket", "expire_at": 249440, "attempts": 311507}, "linked_to": [], "created_at": 789275, "updated_at": 889838}
+          application/json: {"object": "email_address", "email_address": "[email protected]", "reserved": true, "verification": {"status": "verified", "strategy": "ticket", "attempts": 311507, "expire_at": 249440}, "linked_to": [], "created_at": 789275, "updated_at": 889838}
         "400":
           application/json: {"errors": [{"message": "<value>", "long_message": "<value>", "code": "<value>"}]}
   CreatePhoneNumber:
@@ -1427,6 +1443,16 @@ examples:
           application/json: {"object": "session", "id": "<id>", "user_id": "<id>", "client_id": "<id>", "status": "removed", "last_active_at": 558834, "expire_at": 544221, "abandon_at": 521235, "updated_at": 969961, "created_at": 458049}
         "400":
           application/json: {"errors": [{"message": "<value>", "long_message": "<value>", "code": "<value>"}]}
+  RefreshSession:
+    speakeasy-default-refresh-session:
+      parameters:
+        path:
+          session_id: "<id>"
+      responses:
+        "200":
+          application/json: {"object": "cookies", "cookies": ["<value>", "<value>", "<value>"]}
+        "400":
+          application/json: {"errors": [{"message": "<value>", "long_message": "<value>", "code": "<value>"}, {"message": "<value>", "long_message": "<value>", "code": "<value>"}]}
   RevokeSession:
     speakeasy-default-revoke-session:
       parameters:
@@ -1691,9 +1717,9 @@ examples:
           offset: 0
       responses:
         "200":
-          application/json: [{}]
+          application/json: [{"object": "oauth_access_token", "external_account_id": "<id>", "provider_user_id": "<id>", "token": "<value>", "expires_at": 701535, "provider": "<value>", "public_metadata": {"key": "<value>"}, "label": "<value>"}]
         "400":
-          application/json: {"errors": [{"message": "<value>", "long_message": "<value>", "code": "<value>"}, {"message": "<value>", "long_message": "<value>", "code": "<value>"}]}
+          application/json: {"errors": []}
   UsersGetOrganizationMemberships:
     speakeasy-default-users-get-organization-memberships:
       parameters:
@@ -2567,15 +2593,19 @@ examples:
           application/json: {"object": "waitlist_entry", "id": "<id>", "email_address": "[email protected]", "status": "pending", "created_at": 86, "updated_at": 169727, "invitation": {"object": "invitation", "id": "<id>", "email_address": "[email protected]", "public_metadata": {"key": "<value>"}, "revoked": false, "status": "pending", "created_at": 17759, "updated_at": 230313}}
         "400":
           application/json: {"errors": []}
-  RefreshSession:
-    speakeasy-default-refresh-session:
-      parameters:
-        path:
-          session_id: "<id>"
+  CreateAccountlessApplication:
+    speakeasy-default-create-accountless-application:
       responses:
         "200":
-          application/json: {"object": "cookies", "cookies": ["<value>", "<value>", "<value>"]}
-        "400":
-          application/json: {"errors": [{"message": "<value>", "long_message": "<value>", "code": "<value>"}, {"message": "<value>", "long_message": "<value>", "code": "<value>"}]}
-examplesVersion: 1.0.0
+          application/json: {"object": "accountless_application", "publishable_key": "<value>"}
+        "500":
+          application/json: {"errors": [{"message": "<value>", "long_message": "<value>", "code": "<value>"}]}
+  CompleteAccountlessApplication:
+    speakeasy-default-complete-accountless-application:
+      responses:
+        "200":
+          application/json: {"object": "accountless_application", "publishable_key": "<value>"}
+        "500":
+          application/json: {"errors": [{"message": "<value>", "long_message": "<value>", "code": "<value>"}, {"message": "<value>", "long_message": "<value>", "code": "<value>"}, {"message": "<value>", "long_message": "<value>", "code": "<value>"}]}
+examplesVersion: 1.0.1
 generatedTests: {}

.speakeasy/gen.yaml

@@ -11,11 +11,12 @@ generation:
     parameterOrderingFeb2024: true
     requestResponseComponentNamesFeb2024: true
     securityFeb2025: false
+    sharedErrorComponentsApr2025: false
   auth:
     oAuth2ClientCredentialsEnabled: true
     oAuth2PasswordEnabled: false
 java:
-  version: 2.3.1
+  version: 2.4.0
   additionalDependencies: []
   additionalPlugins: []
   artifactID: backend-api

.speakeasy/workflow.lock

@@ -1,21 +1,21 @@
-speakeasyVersion: 1.526.5
+speakeasyVersion: 1.542.3
 sources:
     clerk-java-sdk:
         sourceNamespace: clerk-java-sdk
-        sourceRevisionDigest: sha256:f56f3cc544f4555e898c153ae5033e1a50525d9f3a9bdd6ad6ca2a27bfa148c8
-        sourceBlobDigest: sha256:42c60cb15ffe27b9b55ab263447f7ca5a50162bc65a9e692a92d6eba4a560e81
+        sourceRevisionDigest: sha256:61f94d9ac7765bbaee36f05f76b24d92d4e38cd1221d19038e69b6a8dadb1d44
+        sourceBlobDigest: sha256:340eb6887045d0ee9db88c570ae5623776b60d0b79dc89e0312505c3b476afe1
         tags:
             - latest
-            - speakeasy-sdk-regen-1743437104
+            - speakeasy-sdk-regen-1743638956
             - "2024-10-01"
 targets:
     clerk-java:
         source: clerk-java-sdk
         sourceNamespace: clerk-java-sdk
-        sourceRevisionDigest: sha256:f56f3cc544f4555e898c153ae5033e1a50525d9f3a9bdd6ad6ca2a27bfa148c8
-        sourceBlobDigest: sha256:42c60cb15ffe27b9b55ab263447f7ca5a50162bc65a9e692a92d6eba4a560e81
+        sourceRevisionDigest: sha256:61f94d9ac7765bbaee36f05f76b24d92d4e38cd1221d19038e69b6a8dadb1d44
+        sourceBlobDigest: sha256:340eb6887045d0ee9db88c570ae5623776b60d0b79dc89e0312505c3b476afe1
         codeSamplesNamespace: clerk-java-sdk-code-samples
-        codeSamplesRevisionDigest: sha256:8b78ade76844b9fd06e5b1f0ad29472b8b2ea3d009cd7ffb9711397c7cecfe01
+        codeSamplesRevisionDigest: sha256:02c0ff8976194ddec8cda4b6fcedb12994aac6cc721cb1c20da86c0986d26e9a
     my-first-target:
         source: clerk-java-sdk
         sourceNamespace: clerk-java-sdk

README.md

@@ -51,15 +51,15 @@ The samples below show how a published SDK artifact is used:
 
 Gradle:
 ```groovy
-implementation 'com.clerk:backend-api:2.3.1'
+implementation 'com.clerk:backend-api:2.4.0'
 ```
 
 Maven:
 ```xml
 <dependency>
     <groupId>com.clerk</groupId>
     <artifactId>backend-api</artifactId>
-    <version>2.3.1</version>
+    <version>2.4.0</version>
 </dependency>
 ```
 
@@ -76,6 +76,29 @@ 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] -->
@@ -87,25 +110,25 @@ gradlew.bat publishToMavenLocal -Pskip.signing
 package hello.world;
 
 import com.clerk.backend_api.Clerk;
-import com.clerk.backend_api.models.operations.GetPublicInterstitialRequest;
-import com.clerk.backend_api.models.operations.GetPublicInterstitialResponse;
+import com.clerk.backend_api.models.errors.ClerkErrors;
+import com.clerk.backend_api.models.operations.GetEmailAddressResponse;
 import java.lang.Exception;
 
 public class Application {
 
-    public static void main(String[] args) throws Exception {
+    public static void main(String[] args) throws ClerkErrors, Exception {
 
         Clerk sdk = Clerk.builder()
+                .bearerAuth("<YOUR_BEARER_TOKEN_HERE>")
             .build();
 
-        GetPublicInterstitialRequest req = GetPublicInterstitialRequest.builder()
-                .build();
-
-        GetPublicInterstitialResponse res = sdk.miscellaneous().getPublicInterstitial()
-                .request(req)
+        GetEmailAddressResponse res = sdk.emailAddresses().get()
+                .emailAddressId("<id>")
                 .call();
 
-        // handle response
+        if (res.emailAddress().isPresent()) {
+            // handle response
+        }
     }
 }
 ```
@@ -236,6 +259,11 @@ If the request is correctly authenticated, the token's claims are made available
 * [~~revert~~](docs/sdks/emailsmstemplates/README.md#revert) - Revert a template :warning: **Deprecated**
 * [~~toggleTemplateDelivery~~](docs/sdks/emailsmstemplates/README.md#toggletemplatedelivery) - Toggle the delivery by Clerk for a template of a given type and slug :warning: **Deprecated**
 
+### [experimentalAccountlessApplications()](docs/sdks/experimentalaccountlessapplications/README.md)
+
+* [create](docs/sdks/experimentalaccountlessapplications/README.md#create) - Create an accountless application [EXPERIMENTAL]
+* [complete](docs/sdks/experimentalaccountlessapplications/README.md#complete) - Complete an accountless application [EXPERIMENTAL]
+
 ### [instanceSettings()](docs/sdks/instancesettings/README.md)
 
 * [get](docs/sdks/instancesettings/README.md#get) - Fetch the current instance

RELEASES.md

@@ -278,4 +278,14 @@ Based on:
 ### Generated
 - [java v2.3.1] .
 ### Releases
-- [Maven Central v2.3.1] https://central.sonatype.com/artifact/com.clerk/backend-api/2.3.1 - .
+- [Maven Central v2.3.1] https://central.sonatype.com/artifact/com.clerk/backend-api/2.3.1 - .
+
+## 2025-05-06 00:10:01
+### Changes
+Based on:
+- OpenAPI Doc  
+- Speakeasy CLI 1.542.3 (2.597.9) https://github.com/speakeasy-api/speakeasy
+### Generated
+- [java v2.4.0] .
+### Releases
+- [Maven Central v2.4.0] https://central.sonatype.com/artifact/com.clerk/backend-api/2.4.0 - .