feat(client): allow configuring env via system properties

Author: stainless-app[bot]

README.md

@@ -51,7 +51,8 @@ import com.lithic.api.client.okhttp.LithicOkHttpClient;
 import com.lithic.api.models.Card;
 import com.lithic.api.models.CardCreateParams;
 
-// Configures using the `LITHIC_API_KEY`, `LITHIC_WEBHOOK_SECRET` and `LITHIC_BASE_URL` environment variables
+// Configures using the `lithic.apiKey`, `lithic.webhookSecret` and `lithic.baseUrl` system properties
+// Or configures using the `LITHIC_API_KEY`, `LITHIC_WEBHOOK_SECRET` and `LITHIC_BASE_URL` environment variables
 LithicClient client = LithicOkHttpClient.fromEnv();
 
 CardCreateParams params = CardCreateParams.builder()
@@ -62,13 +63,14 @@ Card card = client.cards().create(params);
 
 ## Client configuration
 
-Configure the client using environment variables:
+Configure the client using system properties or environment variables:
 
 ```java
 import com.lithic.api.client.LithicClient;
 import com.lithic.api.client.okhttp.LithicOkHttpClient;
 
-// Configures using the `LITHIC_API_KEY`, `LITHIC_WEBHOOK_SECRET` and `LITHIC_BASE_URL` environment variables
+// Configures using the `lithic.apiKey`, `lithic.webhookSecret` and `lithic.baseUrl` system properties
+// Or configures using the `LITHIC_API_KEY`, `LITHIC_WEBHOOK_SECRET` and `LITHIC_BASE_URL` environment variables
 LithicClient client = LithicOkHttpClient.fromEnv();
 ```
 
@@ -90,19 +92,22 @@ import com.lithic.api.client.LithicClient;
 import com.lithic.api.client.okhttp.LithicOkHttpClient;
 
 LithicClient client = LithicOkHttpClient.builder()
-    // Configures using the `LITHIC_API_KEY`, `LITHIC_WEBHOOK_SECRET` and `LITHIC_BASE_URL` environment variables
+    // Configures using the `lithic.apiKey`, `lithic.webhookSecret` and `lithic.baseUrl` system properties
+    Or configures using the `LITHIC_API_KEY`, `LITHIC_WEBHOOK_SECRET` and `LITHIC_BASE_URL` environment variables
     .fromEnv()
     .apiKey("My Lithic API Key")
     .build();
 ```
 
 See this table for the available options:
 
-| Setter          | Environment variable    | Required | Default value              |
-| --------------- | ----------------------- | -------- | -------------------------- |
-| `apiKey`        | `LITHIC_API_KEY`        | true     | -                          |
-| `webhookSecret` | `LITHIC_WEBHOOK_SECRET` | false    | -                          |
-| `baseUrl`       | `LITHIC_BASE_URL`       | true     | `"https://api.lithic.com"` |
+| Setter          | System property        | Environment variable    | Required | Default value              |
+| --------------- | ---------------------- | ----------------------- | -------- | -------------------------- |
+| `apiKey`        | `lithic.apiKey`        | `LITHIC_API_KEY`        | true     | -                          |
+| `webhookSecret` | `lithic.webhookSecret` | `LITHIC_WEBHOOK_SECRET` | false    | -                          |
+| `baseUrl`       | `lithic.baseUrl`       | `LITHIC_BASE_URL`       | true     | `"https://api.lithic.com"` |
+
+System properties take precedence over environment variables.
 
 > [!TIP]
 > Don't create more than one client in the same application. Each client has a connection pool and
@@ -148,7 +153,8 @@ import com.lithic.api.models.Card;
 import com.lithic.api.models.CardCreateParams;
 import java.util.concurrent.CompletableFuture;
 
-// Configures using the `LITHIC_API_KEY`, `LITHIC_WEBHOOK_SECRET` and `LITHIC_BASE_URL` environment variables
+// Configures using the `lithic.apiKey`, `lithic.webhookSecret` and `lithic.baseUrl` system properties
+// Or configures using the `LITHIC_API_KEY`, `LITHIC_WEBHOOK_SECRET` and `LITHIC_BASE_URL` environment variables
 LithicClient client = LithicOkHttpClient.fromEnv();
 
 CardCreateParams params = CardCreateParams.builder()
@@ -166,7 +172,8 @@ import com.lithic.api.models.Card;
 import com.lithic.api.models.CardCreateParams;
 import java.util.concurrent.CompletableFuture;
 
-// Configures using the `LITHIC_API_KEY`, `LITHIC_WEBHOOK_SECRET` and `LITHIC_BASE_URL` environment variables
+// Configures using the `lithic.apiKey`, `lithic.webhookSecret` and `lithic.baseUrl` system properties
+// Or configures using the `LITHIC_API_KEY`, `LITHIC_WEBHOOK_SECRET` and `LITHIC_BASE_URL` environment variables
 LithicClientAsync client = LithicOkHttpClientAsync.fromEnv();
 
 CardCreateParams params = CardCreateParams.builder()

lithic-java-core/src/main/kotlin/com/lithic/api/core/ClientOptions.kt

@@ -246,9 +246,14 @@ private constructor(
         fun timeout(): Timeout = timeout
 
         fun fromEnv() = apply {
-            System.getenv("LITHIC_BASE_URL")?.let { baseUrl(it) }
-            System.getenv("LITHIC_API_KEY")?.let { apiKey(it) }
-            System.getenv("LITHIC_WEBHOOK_SECRET")?.let { webhookSecret(it) }
+            (System.getProperty("lithic.baseUrl") ?: System.getenv("LITHIC_BASE_URL"))?.let {
+                baseUrl(it)
+            }
+            (System.getProperty("lithic.apiKey") ?: System.getenv("LITHIC_API_KEY"))?.let {
+                apiKey(it)
+            }
+            (System.getProperty("lithic.webhookSecret") ?: System.getenv("LITHIC_WEBHOOK_SECRET"))
+                ?.let { webhookSecret(it) }
         }
 
         /**