ci: regenerated with OpenAPI Doc , Speakeasy CLI 1.581.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,6 @@
+**/.speakeasy/temp/
+**/.speakeasy/logs/
+.speakeasy/reports
 # Ignore Gradle project-specific cache directory
 .gradle
 # Ignore Gradle build output directory

.speakeasy/gen.lock

@@ -4,25 +4,35 @@ generation:
   maintainOpenAPIOrder: true
   usageSnippets:
     optionalPropertyRendering: withExample
+    sdkInitStyle: constructor
   useClassNamesForArrayFields: true
   fixes:
     nameResolutionDec2023: true
+    nameResolutionFeb2025: false
     parameterOrderingFeb2024: true
     requestResponseComponentNamesFeb2024: true
+    securityFeb2025: false
+    sharedErrorComponentsApr2025: false
   auth:
     oAuth2ClientCredentialsEnabled: true
     oAuth2PasswordEnabled: false
+  tests:
+    generateTests: true
+    generateNewTests: false
+    skipResponseBodyAssertions: false
 java:
-  version: 1.0.0-beta
+  version: 1.0.0-beta.1
   additionalDependencies: []
   additionalPlugins:
     - id 'org.jreleaser' version '1.15.0'
   artifactID: shippo-sdk
+  baseErrorName: ShippoError
   clientServerStatusCodesAsErrors: true
   companyEmail: [email protected]
   companyName: Shippo
   companyURL: www.goshippo.com
   defaultErrorName: SDKError
+  enableCustomCodeRegions: false
   externalDocs:
     url: https://github.com/goshippo/shippo-java-sdk
     version: ""
@@ -41,11 +51,13 @@ java:
     descriptions: Maven library which integrates with Shippo Multi Carrier Shipping API. This library provides access to Shippo (goshippo.com) API capabilities. Including label generation, rating, tracking and more.
     version: ""
   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,20 +1,21 @@
-speakeasyVersion: 1.448.2
+speakeasyVersion: 1.581.0
 sources:
     my-first-source:
         sourceNamespace: my-first-source
-        sourceRevisionDigest: sha256:480494c08f99f68cd119fdb481d81d31d37e4e22211cc6fd8a5197857b7580b4
-        sourceBlobDigest: sha256:422c969f0c8ded72f1dc9d756407a9d51740270b9d16fd9c4f4a9d50f4e714ba
+        sourceRevisionDigest: sha256:c7975b03b0e922bd14ceb9f47b00751e5ab098fca449707d2e20845cf7cc50f5
+        sourceBlobDigest: sha256:38d48412b95b3b5c0ed071f4887b46472950b923b239a773d7830c0ee92c6c14
         tags:
             - latest
+            - speakeasy-sdk-regen-1733703738
             - "2018-02-08"
 targets:
     my-first-target:
         source: my-first-source
         sourceNamespace: my-first-source
-        sourceRevisionDigest: sha256:480494c08f99f68cd119fdb481d81d31d37e4e22211cc6fd8a5197857b7580b4
-        sourceBlobDigest: sha256:422c969f0c8ded72f1dc9d756407a9d51740270b9d16fd9c4f4a9d50f4e714ba
+        sourceRevisionDigest: sha256:c7975b03b0e922bd14ceb9f47b00751e5ab098fca449707d2e20845cf7cc50f5
+        sourceBlobDigest: sha256:38d48412b95b3b5c0ed071f4887b46472950b923b239a773d7830c0ee92c6c14
         codeSamplesNamespace: my-first-source-java-code-samples
-        codeSamplesRevisionDigest: sha256:2b960672ec02abfbb6692e804ee954c218ece797c765654fab7f71084709ef08
+        codeSamplesRevisionDigest: sha256:329337d24c9de0e0cd3902dcc398e2f40d8ebacb90d7d4d1ac9c1caed8166159
 workflow:
     workflowVersion: 1.0.0
     speakeasyVersion: latest

.speakeasy/workflow.lock

@@ -12,7 +12,6 @@ targets:
         source: my-first-source
         publish:
             java:
-                useSonatypeLegacy: false
                 ossrhUsername: $ossrh_username
                 ossrhPassword: $ossrh_password
                 gpgSecretKey: $java_gpg_secret_key

.speakeasy/workflow.yaml

@@ -36,6 +36,7 @@ Shippo external API.: Use this API to integrate with the Shippo service
   * [Error Handling](#error-handling)
   * [Server Selection](#server-selection)
   * [Authentication](#authentication)
+  * [Debugging](#debugging)
 
 <!-- End Table of Contents [toc] -->
 
@@ -290,9 +291,7 @@ By default, an API error will throw a `models/errors/SDKError` exception. When c
 package hello.world;
 
 import com.goshippo.shippo_sdk.Shippo;
-import com.goshippo.shippo_sdk.models.errors.InitiateOauth2SigninCarrierAccountsResponseBody;
-import com.goshippo.shippo_sdk.models.errors.InitiateOauth2SigninCarrierAccountsResponseResponseBody;
-import com.goshippo.shippo_sdk.models.errors.InitiateOauth2SigninResponseBody;
+import com.goshippo.shippo_sdk.models.errors.*;
 import com.goshippo.shippo_sdk.models.operations.InitiateOauth2SigninResponse;
 import java.lang.Exception;
 
@@ -301,15 +300,13 @@ public class Application {
     public static void main(String[] args) throws InitiateOauth2SigninResponseBody, InitiateOauth2SigninCarrierAccountsResponseBody, InitiateOauth2SigninCarrierAccountsResponseResponseBody, Exception {
 
         Shippo sdk = Shippo.builder()
-                .apiKeyHeader("<YOUR_API_KEY_HERE>")
                 .shippoApiVersion("2018-02-08")
+                .apiKeyHeader(System.getenv().getOrDefault("API_KEY_HEADER", ""))
             .build();
 
         InitiateOauth2SigninResponse res = sdk.carrierAccounts().initiateOauth2Signin()
                 .carrierAccountObjectId("<id>")
-                .redirectUri("https://enlightened-mortise.com/")
-                .state("Louisiana")
-                .shippoApiVersion("2018-02-08")
+                .redirectUri("https://ashamed-reporter.biz")
                 .call();
 
         // handle response
@@ -323,7 +320,7 @@ public class Application {
 
 ### Override Server URL Per-Client
 
-The default server can also be overridden globally using the `.serverURL(String serverUrl)` builder method when initializing the SDK client instance. For example:
+The default server can be overridden globally using the `.serverURL(String serverUrl)` builder method when initializing the SDK client instance. For example:
 ```java
 package hello.world;
 
@@ -337,14 +334,13 @@ public class Application {
 
         Shippo sdk = Shippo.builder()
                 .serverURL("https://api.goshippo.com")
-                .apiKeyHeader("<YOUR_API_KEY_HERE>")
                 .shippoApiVersion("2018-02-08")
+                .apiKeyHeader(System.getenv().getOrDefault("API_KEY_HEADER", ""))
             .build();
 
         ListAddressesResponse res = sdk.addresses().list()
                 .page(1L)
                 .results(5L)
-                .shippoApiVersion("2018-02-08")
                 .call();
 
         if (res.addressPaginatedList().isPresent()) {
@@ -379,14 +375,13 @@ public class Application {
     public static void main(String[] args) throws Exception {
 
         Shippo sdk = Shippo.builder()
-                .apiKeyHeader("<YOUR_API_KEY_HERE>")
+                .apiKeyHeader(System.getenv().getOrDefault("API_KEY_HEADER", ""))
                 .shippoApiVersion("2018-02-08")
             .build();
 
         ListAddressesResponse res = sdk.addresses().list()
                 .page(1L)
                 .results(5L)
-                .shippoApiVersion("2018-02-08")
                 .call();
 
         if (res.addressPaginatedList().isPresent()) {
@@ -402,6 +397,37 @@ public class Application {
 <!-- No SDK Installation -->
 <!-- No SDK Example Usage -->
 <!-- No SDK Available Operations -->
+<!-- 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 -->
 
 

README.md

@@ -60,4 +60,14 @@ Based on:
 ### Generated
 - [java v1.0.0-beta.3] .
 ### Releases
-- [Maven Central v1.0.0-beta.3] https://central.sonatype.com/artifact/com.goshippo/sdk/1.0.0-beta.3 - .
+- [Maven Central v1.0.0-beta.3] https://central.sonatype.com/artifact/com.goshippo/sdk/1.0.0-beta.3 - .
+
+## 2025-07-14 00:25:31
+### Changes
+Based on:
+- OpenAPI Doc  
+- Speakeasy CLI 1.581.0 (2.656.5) https://github.com/speakeasy-api/speakeasy
+### Generated
+- [java v1.0.0-beta.1] .
+### Releases
+- [Maven Central v1.0.0-beta.1] https://central.sonatype.com/artifact/com.goshippo/shippo-sdk/1.0.0-beta.1 - .

RELEASES.md

@@ -11,14 +11,13 @@ public class Application {
     public static void main(String[] args) throws Exception {
 
         Shippo sdk = Shippo.builder()
-                .apiKeyHeader("<YOUR_API_KEY_HERE>")
                 .shippoApiVersion("2018-02-08")
+                .apiKeyHeader(System.getenv().getOrDefault("API_KEY_HEADER", ""))
             .build();
 
         ListAddressesResponse res = sdk.addresses().list()
                 .page(1L)
                 .results(5L)
-                .shippoApiVersion("2018-02-08")
                 .call();
 
         if (res.addressPaginatedList().isPresent()) {

USAGE.md

@@ -28,8 +28,6 @@ repositories {
 }
 
 java {
-    sourceCompatibility = JavaVersion.VERSION_11
-    targetCompatibility = JavaVersion.VERSION_11
     withSourcesJar()
     withJavadocJar()
 }
@@ -40,9 +38,12 @@ model {
     }
 }
 
+version = "${version}"
+group = "${groupId}"
+
 jar {
     dependsOn(":generatePomFileForMavenPublication")
-    archiveBaseName = "shippo-sdk"
+    archiveBaseName = "${artifactId}"
 
     into("META-INF/maven/com.goshippo/shippo-sdk") {
         from("$buildDir/pom.xml")
@@ -63,15 +64,16 @@ tasks.withType(Javadoc) {
   options.addStringOption('Xdoclint:none', '-quiet')
 }
 
-group = "com.goshippo"
-version = "1.0.0-beta"
+tasks.withType(JavaCompile).configureEach {
+    options.release = 11
+}
 
 sourcesJar {
-    archiveBaseName = "shippo-sdk"
+    archiveBaseName = "${artifactId}"
 }
 
 javadocJar {
-    archiveBaseName = "shippo-sdk"
+    archiveBaseName = "${artifactId}"
 }
 sonatypeCentralUpload {
     // This is your Sonatype generated username
@@ -81,9 +83,9 @@ sonatypeCentralUpload {
 
     // This is a list of files to upload. Ideally you would point to your jar file, source and javadoc jar (required by central)
     archives = files(
-      "$buildDir/libs/shippo-sdk-${version}.jar",
-      "$buildDir/libs/shippo-sdk-${version}-sources.jar",
-      "$buildDir/libs/shippo-sdk-${version}-javadoc.jar"
+      "$buildDir/libs/${artifactId}-${version}.jar",
+      "$buildDir/libs/${artifactId}-${version}-sources.jar",
+      "$buildDir/libs/${artifactId}-${version}-javadoc.jar"
     )
 
     // This is the pom file to upload. This is required by central
@@ -100,13 +102,19 @@ publishing {
 
     publications {
         maven(MavenPublication) {
-            groupId = 'com.goshippo'
-            artifactId = 'shippo-sdk'
-            version = '1.0.0-beta'
+            // note that properties can't yet be used below!
+            // https://github.com/gradle/gradle/issues/18619
+            groupId = "com.goshippo"
+            artifactId = "shippo-sdk"
+            version = "1.0.0-beta.1"
 
             from components.java
 
             pom {
+                properties = [
+                    'maven.compiler.source': '11',
+                    'maven.compiler.target': '11',
+                ]
                 name = 'Shippo Java SDK'
                 description = 'SDK enabling Java developers to easily integrate with the Shippo API.'
                 url = 'https://https://github.com/goshippo/shippo-java-sdk'
@@ -145,17 +153,15 @@ if (!project.hasProperty('skip.signing')) {
     }
 }
 
+
+
 dependencies {
-    api 'com.fasterxml.jackson.core:jackson-annotations:2.17.2'
-    implementation 'com.fasterxml.jackson.core:jackson-databind:2.17.2'
-    implementation 'com.fasterxml.jackson.datatype:jackson-datatype-jsr310:2.17.2'
-    implementation 'com.fasterxml.jackson.datatype:jackson-datatype-jdk8:2.17.2'
+    api 'com.fasterxml.jackson.core:jackson-annotations:2.18.2'
+    implementation 'com.fasterxml.jackson.core:jackson-databind:2.18.2'
+    implementation 'com.fasterxml.jackson.datatype:jackson-datatype-jsr310:2.18.2'
+    implementation 'com.fasterxml.jackson.datatype:jackson-datatype-jdk8:2.18.2'
     api('org.openapitools:jackson-databind-nullable:0.2.6') {exclude group: 'com.fasterxml.jackson.core', module: 'jackson-databind'}
-    implementation 'org.apache.httpcomponents:httpclient:4.5.14'
-    implementation 'org.apache.httpcomponents:httpmime:4.5.14'
-    implementation 'commons-io:commons-io:2.15.1'
+    implementation 'commons-io:commons-io:2.18.0'
 }
 
-
-
-apply from: 'build-extras.gradle'
+apply from: 'build-extras.gradle'