Automatically update Java SDK

Author: github-actions[bot]

.gitignore

@@ -22,3 +22,6 @@
 # virtual machine crash logs, see http://www.java.com/en/download/help/error_hotspot.xml
 hs_err_pid*
 replay_pid*
+
+# OSX
+.DS_Store

pom.xml

@@ -8,7 +8,7 @@
   <!-- General project information -->
   <groupId>so.trophy</groupId>
   <artifactId>trophy-java</artifactId>
-  <version>1.0.29</version>
+  <version>1.0.30</version>
   <packaging>jar</packaging>
   <name>Trophy</name>
   <description>Java client library for the Trophy API</description>

src/main/java/so/trophy/AsyncTrophyApiClient.java

@@ -0,0 +1,77 @@
+package so.trophy;
+
+/**
+ * This file was auto-generated by Fern from our API Definition.
+ */
+
+import so.trophy.core.ClientOptions;
+import so.trophy.core.Suppliers;
+import java.util.function.Supplier;
+import so.trophy.resources.achievements.AsyncAchievementsClient;
+import so.trophy.resources.admin.AsyncAdminClient;
+import so.trophy.resources.leaderboards.AsyncLeaderboardsClient;
+import so.trophy.resources.metrics.AsyncMetricsClient;
+import so.trophy.resources.points.AsyncPointsClient;
+import so.trophy.resources.streaks.AsyncStreaksClient;
+import so.trophy.resources.users.AsyncUsersClient;
+
+public class AsyncTrophyApiClient {
+  protected final ClientOptions clientOptions;
+
+  protected final Supplier<AsyncAchievementsClient> achievementsClient;
+
+  protected final Supplier<AsyncMetricsClient> metricsClient;
+
+  protected final Supplier<AsyncUsersClient> usersClient;
+
+  protected final Supplier<AsyncStreaksClient> streaksClient;
+
+  protected final Supplier<AsyncPointsClient> pointsClient;
+
+  protected final Supplier<AsyncLeaderboardsClient> leaderboardsClient;
+
+  protected final Supplier<AsyncAdminClient> adminClient;
+
+  public AsyncTrophyApiClient(ClientOptions clientOptions) {
+    this.clientOptions = clientOptions;
+    this.achievementsClient = Suppliers.memoize(() -> new AsyncAchievementsClient(clientOptions));
+    this.metricsClient = Suppliers.memoize(() -> new AsyncMetricsClient(clientOptions));
+    this.usersClient = Suppliers.memoize(() -> new AsyncUsersClient(clientOptions));
+    this.streaksClient = Suppliers.memoize(() -> new AsyncStreaksClient(clientOptions));
+    this.pointsClient = Suppliers.memoize(() -> new AsyncPointsClient(clientOptions));
+    this.leaderboardsClient = Suppliers.memoize(() -> new AsyncLeaderboardsClient(clientOptions));
+    this.adminClient = Suppliers.memoize(() -> new AsyncAdminClient(clientOptions));
+  }
+
+  public AsyncAchievementsClient achievements() {
+    return this.achievementsClient.get();
+  }
+
+  public AsyncMetricsClient metrics() {
+    return this.metricsClient.get();
+  }
+
+  public AsyncUsersClient users() {
+    return this.usersClient.get();
+  }
+
+  public AsyncStreaksClient streaks() {
+    return this.streaksClient.get();
+  }
+
+  public AsyncPointsClient points() {
+    return this.pointsClient.get();
+  }
+
+  public AsyncLeaderboardsClient leaderboards() {
+    return this.leaderboardsClient.get();
+  }
+
+  public AsyncAdminClient admin() {
+    return this.adminClient.get();
+  }
+
+  public static AsyncTrophyApiClientBuilder builder() {
+    return new AsyncTrophyApiClientBuilder();
+  }
+}

src/main/java/so/trophy/AsyncTrophyApiClientBuilder.java

@@ -0,0 +1,203 @@
+package so.trophy;
+
+/**
+ * This file was auto-generated by Fern from our API Definition.
+ */
+
+import so.trophy.core.ClientOptions;
+import so.trophy.core.Environment;
+import java.lang.Integer;
+import java.lang.String;
+import java.util.HashMap;
+import java.util.Map;
+import java.util.Optional;
+import okhttp3.OkHttpClient;
+
+public class AsyncTrophyApiClientBuilder {
+  private Optional<Integer> timeout = Optional.empty();
+
+  private Optional<Integer> maxRetries = Optional.empty();
+
+  private final Map<String, String> customHeaders = new HashMap<>();
+
+  private String apiKey = null;
+
+  private Environment environment = Environment.PRODUCTION;
+
+  private OkHttpClient httpClient;
+
+  /**
+   * Sets apiKey
+   */
+  public AsyncTrophyApiClientBuilder apiKey(String apiKey) {
+    this.apiKey = apiKey;
+    return this;
+  }
+
+  public AsyncTrophyApiClientBuilder environment(Environment environment) {
+    this.environment = environment;
+    return this;
+  }
+
+  /**
+   * Sets the timeout (in seconds) for the client. Defaults to 60 seconds.
+   */
+  public AsyncTrophyApiClientBuilder timeout(int timeout) {
+    this.timeout = Optional.of(timeout);
+    return this;
+  }
+
+  /**
+   * Sets the maximum number of retries for the client. Defaults to 2 retries.
+   */
+  public AsyncTrophyApiClientBuilder maxRetries(int maxRetries) {
+    this.maxRetries = Optional.of(maxRetries);
+    return this;
+  }
+
+  /**
+   * Sets the underlying OkHttp client
+   */
+  public AsyncTrophyApiClientBuilder httpClient(OkHttpClient httpClient) {
+    this.httpClient = httpClient;
+    return this;
+  }
+
+  /**
+   * Add a custom header to be sent with all requests.
+   * For headers that need to be computed dynamically or conditionally, use the setAdditional() method override instead.
+   *
+   * @param name The header name
+   * @param value The header value
+   * @return This builder for method chaining
+   */
+  public AsyncTrophyApiClientBuilder addHeader(String name, String value) {
+    this.customHeaders.put(name, value);
+    return this;
+  }
+
+  protected ClientOptions buildClientOptions() {
+    ClientOptions.Builder builder = ClientOptions.builder();
+    setEnvironment(builder);
+    setAuthentication(builder);
+    setHttpClient(builder);
+    setTimeouts(builder);
+    setRetries(builder);
+    for (Map.Entry<String, String> header : this.customHeaders.entrySet()) {
+      builder.addHeader(header.getKey(), header.getValue());
+    }
+    setAdditional(builder);
+    return builder.build();
+  }
+
+  /**
+   * Sets the environment configuration for the client.
+   * Override this method to modify URLs or add environment-specific logic.
+   *
+   * @param builder The ClientOptions.Builder to configure
+   */
+  protected void setEnvironment(ClientOptions.Builder builder) {
+    builder.environment(this.environment);
+  }
+
+  /**
+   * Override this method to customize authentication.
+   * This method is called during client options construction to set up authentication headers.
+   *
+   * @param builder The ClientOptions.Builder to configure
+   *
+   * Example:
+   * <pre>{@code
+   * &#64;Override
+   * protected void setAuthentication(ClientOptions.Builder builder) {
+   *     super.setAuthentication(builder); // Keep existing auth
+   *     builder.addHeader("X-API-Key", this.apiKey);
+   * }
+   * }</pre>
+   */
+  protected void setAuthentication(ClientOptions.Builder builder) {
+    builder.addHeader("X-API-KEY", this.apiKey);
+  }
+
+  /**
+   * Sets the request timeout configuration.
+   * Override this method to customize timeout behavior.
+   *
+   * @param builder The ClientOptions.Builder to configure
+   */
+  protected void setTimeouts(ClientOptions.Builder builder) {
+    if (this.timeout.isPresent()) {
+      builder.timeout(this.timeout.get());
+    }
+  }
+
+  /**
+   * Sets the retry configuration for failed requests.
+   * Override this method to implement custom retry strategies.
+   *
+   * @param builder The ClientOptions.Builder to configure
+   */
+  protected void setRetries(ClientOptions.Builder builder) {
+    if (this.maxRetries.isPresent()) {
+      builder.maxRetries(this.maxRetries.get());
+    }
+  }
+
+  /**
+   * Sets the OkHttp client configuration.
+   * Override this method to customize HTTP client behavior (interceptors, connection pools, etc).
+   *
+   * @param builder The ClientOptions.Builder to configure
+   */
+  protected void setHttpClient(ClientOptions.Builder builder) {
+    if (this.httpClient != null) {
+      builder.httpClient(this.httpClient);
+    }
+  }
+
+  /**
+   * Override this method to add any additional configuration to the client.
+   * This method is called at the end of the configuration chain, allowing you to add
+   * custom headers, modify settings, or perform any other client customization.
+   *
+   * @param builder The ClientOptions.Builder to configure
+   *
+   * Example:
+   * <pre>{@code
+   * &#64;Override
+   * protected void setAdditional(ClientOptions.Builder builder) {
+   *     builder.addHeader("X-Request-ID", () -&gt; UUID.randomUUID().toString());
+   *     builder.addHeader("X-Client-Version", "1.0.0");
+   * }
+   * }</pre>
+   */
+  protected void setAdditional(ClientOptions.Builder builder) {
+  }
+
+  /**
+   * Override this method to add custom validation logic before the client is built.
+   * This method is called at the beginning of the build() method to ensure the configuration is valid.
+   * Throw an exception to prevent client creation if validation fails.
+   *
+   * Example:
+   * <pre>{@code
+   * &#64;Override
+   * protected void validateConfiguration() {
+   *     super.validateConfiguration(); // Run parent validations
+   *     if (tenantId == null || tenantId.isEmpty()) {
+   *         throw new IllegalStateException("tenantId is required");
+   *     }
+   * }
+   * }</pre>
+   */
+  protected void validateConfiguration() {
+  }
+
+  public AsyncTrophyApiClient build() {
+    if (apiKey == null) {
+      throw new RuntimeException("Please provide apiKey");
+    }
+    validateConfiguration();
+    return new AsyncTrophyApiClient(buildClientOptions());
+  }
+}