feat(api): manual updates

Author: stainless-app[bot]

.stats.yml

@@ -1,4 +1,4 @@
 configured_endpoints: 42
-openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/imagekit-inc%2Fimagekit-5ce78cb448cc4520f5fbcc753452e0237b50a4bf64902e0548a8ad24bbdc82cf.yml
-openapi_spec_hash: fd8ac4c2cdddc3d3a0b0c81be6a9edfe
+openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/imagekit-inc%2Fimagekit-667f7f4988b44bc587d6eb9960ff5c8326e9f7e9b072f3f724f9f54166eff8b1.yml
+openapi_spec_hash: f2081864a4abee0480e5ff991b4c936a
 config_hash: 70f9408b8d1dfbcf262a20d6eed50e1c

README.md

@@ -50,12 +50,17 @@ import com.imagekit.api.client.ImageKitClient;
 import com.imagekit.api.client.okhttp.ImageKitOkHttpClient;
 import com.imagekit.api.models.files.FileUploadParams;
 import com.imagekit.api.models.files.FileUploadResponse;
+import java.io.ByteArrayInputStream;
 
 // Configures using the `imagekit.imagekitPrivateApiKey`, `imagekit.optionalImagekitIgnoresThis`, `imagekit.imagekitWebhookSecret` and `imagekit.baseUrl` system properties
 // Or configures using the `IMAGEKIT_PRIVATE_API_KEY`, `OPTIONAL_IMAGEKIT_IGNORES_THIS`, `IMAGEKIT_WEBHOOK_SECRET` and `IMAGE_KIT_BASE_URL` environment variables
 ImageKitClient client = ImageKitOkHttpClient.fromEnv();
 
-FileUploadResponse response = client.files().upload();
+FileUploadParams params = FileUploadParams.builder()
+    .file(ByteArrayInputStream("https://www.example.com/public-url.jpg".getBytes()))
+    .fileName("file-name.jpg")
+    .build();
+FileUploadResponse response = client.files().upload(params);
 ```
 
 ## Client configuration
@@ -150,13 +155,18 @@ import com.imagekit.api.client.ImageKitClient;
 import com.imagekit.api.client.okhttp.ImageKitOkHttpClient;
 import com.imagekit.api.models.files.FileUploadParams;
 import com.imagekit.api.models.files.FileUploadResponse;
+import java.io.ByteArrayInputStream;
 import java.util.concurrent.CompletableFuture;
 
 // Configures using the `imagekit.imagekitPrivateApiKey`, `imagekit.optionalImagekitIgnoresThis`, `imagekit.imagekitWebhookSecret` and `imagekit.baseUrl` system properties
 // Or configures using the `IMAGEKIT_PRIVATE_API_KEY`, `OPTIONAL_IMAGEKIT_IGNORES_THIS`, `IMAGEKIT_WEBHOOK_SECRET` and `IMAGE_KIT_BASE_URL` environment variables
 ImageKitClient client = ImageKitOkHttpClient.fromEnv();
 
-CompletableFuture<FileUploadResponse> response = client.async().files().upload();
+FileUploadParams params = FileUploadParams.builder()
+    .file(ByteArrayInputStream("https://www.example.com/public-url.jpg".getBytes()))
+    .fileName("file-name.jpg")
+    .build();
+CompletableFuture<FileUploadResponse> response = client.async().files().upload(params);
 ```
 
 Or create an asynchronous client from the beginning:
@@ -166,13 +176,18 @@ import com.imagekit.api.client.ImageKitClientAsync;
 import com.imagekit.api.client.okhttp.ImageKitOkHttpClientAsync;
 import com.imagekit.api.models.files.FileUploadParams;
 import com.imagekit.api.models.files.FileUploadResponse;
+import java.io.ByteArrayInputStream;
 import java.util.concurrent.CompletableFuture;
 
 // Configures using the `imagekit.imagekitPrivateApiKey`, `imagekit.optionalImagekitIgnoresThis`, `imagekit.imagekitWebhookSecret` and `imagekit.baseUrl` system properties
 // Or configures using the `IMAGEKIT_PRIVATE_API_KEY`, `OPTIONAL_IMAGEKIT_IGNORES_THIS`, `IMAGEKIT_WEBHOOK_SECRET` and `IMAGE_KIT_BASE_URL` environment variables
 ImageKitClientAsync client = ImageKitOkHttpClientAsync.fromEnv();
 
-CompletableFuture<FileUploadResponse> response = client.files().upload();
+FileUploadParams params = FileUploadParams.builder()
+    .file(ByteArrayInputStream("https://www.example.com/public-url.jpg".getBytes()))
+    .fileName("file-name.jpg")
+    .build();
+CompletableFuture<FileUploadResponse> response = client.files().upload(params);
 ```
 
 The asynchronous client supports the same options as the synchronous one, except most methods return `CompletableFuture`s.
@@ -184,50 +199,50 @@ The SDK defines methods that accept files.
 To upload a file, pass a [`Path`](https://docs.oracle.com/javase/8/docs/api/java/nio/file/Path.html):
 
 ```java
-import com.imagekit.api.models.beta.v2.files.FileUploadParams;
-import com.imagekit.api.models.beta.v2.files.FileUploadResponse;
+import com.imagekit.api.models.files.FileUploadParams;
+import com.imagekit.api.models.files.FileUploadResponse;
 import java.nio.file.Paths;
 
 FileUploadParams params = FileUploadParams.builder()
     .fileName("fileName")
     .file(Paths.get("/path/to/file"))
     .build();
-FileUploadResponse response = client.beta().v2().files().upload(params);
+FileUploadResponse response = client.files().upload(params);
 ```
 
 Or an arbitrary [`InputStream`](https://docs.oracle.com/javase/8/docs/api/java/io/InputStream.html):
 
 ```java
-import com.imagekit.api.models.beta.v2.files.FileUploadParams;
-import com.imagekit.api.models.beta.v2.files.FileUploadResponse;
+import com.imagekit.api.models.files.FileUploadParams;
+import com.imagekit.api.models.files.FileUploadResponse;
 import java.net.URL;
 
 FileUploadParams params = FileUploadParams.builder()
     .fileName("fileName")
     .file(new URL("https://example.com//path/to/file").openStream())
     .build();
-FileUploadResponse response = client.beta().v2().files().upload(params);
+FileUploadResponse response = client.files().upload(params);
 ```
 
 Or a `byte[]` array:
 
 ```java
-import com.imagekit.api.models.beta.v2.files.FileUploadParams;
-import com.imagekit.api.models.beta.v2.files.FileUploadResponse;
+import com.imagekit.api.models.files.FileUploadParams;
+import com.imagekit.api.models.files.FileUploadResponse;
 
 FileUploadParams params = FileUploadParams.builder()
     .fileName("fileName")
     .file("content".getBytes())
     .build();
-FileUploadResponse response = client.beta().v2().files().upload(params);
+FileUploadResponse response = client.files().upload(params);
 ```
 
 Note that when passing a non-`Path` its filename is unknown so it will not be included in the request. To manually set a filename, pass a [`MultipartField`](image-kit-java-core/src/main/kotlin/com/imagekit/api/core/Values.kt):
 
 ```java
 import com.imagekit.api.core.MultipartField;
-import com.imagekit.api.models.beta.v2.files.FileUploadParams;
-import com.imagekit.api.models.beta.v2.files.FileUploadResponse;
+import com.imagekit.api.models.files.FileUploadParams;
+import com.imagekit.api.models.files.FileUploadResponse;
 import java.io.InputStream;
 import java.net.URL;
 
@@ -238,7 +253,7 @@ FileUploadParams params = FileUploadParams.builder()
         .filename("/path/to/file")
         .build())
     .build();
-FileUploadResponse response = client.beta().v2().files().upload(params);
+FileUploadResponse response = client.files().upload(params);
 ```
 
 ## Raw responses
@@ -252,8 +267,13 @@ import com.imagekit.api.core.http.Headers;
 import com.imagekit.api.core.http.HttpResponseFor;
 import com.imagekit.api.models.files.FileUploadParams;
 import com.imagekit.api.models.files.FileUploadResponse;
+import java.io.ByteArrayInputStream;
 
-HttpResponseFor<FileUploadResponse> response = client.files().withRawResponse().upload();
+FileUploadParams params = FileUploadParams.builder()
+    .file(ByteArrayInputStream("https://www.example.com/public-url.jpg".getBytes()))
+    .fileName("file-name.jpg")
+    .build();
+HttpResponseFor<FileUploadResponse> response = client.files().withRawResponse().upload(params);
 
 int statusCode = response.statusCode();
 Headers headers = response.headers();
@@ -362,7 +382,9 @@ To set a custom timeout, configure the method call using the `timeout` method:
 ```java
 import com.imagekit.api.models.files.FileUploadResponse;
 
-FileUploadResponse response = client.files().upload(RequestOptions.builder().timeout(Duration.ofSeconds(30)).build());
+FileUploadResponse response = client.files().upload(
+  params, RequestOptions.builder().timeout(Duration.ofSeconds(30)).build()
+);
 ```
 
 Or configure the default for all method calls at the client level:
@@ -480,10 +502,10 @@ To set undocumented parameters on _nested_ headers, query params, or body classe
 
 ```java
 import com.imagekit.api.core.JsonValue;
-import com.imagekit.api.models.custommetadatafields.CustomMetadataFieldCreateParams;
+import com.imagekit.api.models.files.FileUploadParams;
 
-CustomMetadataFieldCreateParams params = CustomMetadataFieldCreateParams.builder()
-    .schema(CustomMetadataFieldCreateParams.Schema.builder()
+FileUploadParams params = FileUploadParams.builder()
+    .transformation(FileUploadParams.Transformation.builder()
         .putAdditionalProperty("secretProperty", JsonValue.from("42"))
         .build())
     .build();
@@ -494,9 +516,13 @@ These properties can be accessed on the nested built object later using the `_ad
 To set a documented parameter or property to an undocumented or not yet supported _value_, pass a [`JsonValue`](image-kit-java-core/src/main/kotlin/com/imagekit/api/core/Values.kt) object to its setter:
 
 ```java
+import com.imagekit.api.core.JsonValue;
 import com.imagekit.api.models.files.FileUploadParams;
 
-FileUploadParams params = FileUploadParams.builder().build();
+FileUploadParams params = FileUploadParams.builder()
+    .file(JsonValue.from(42))
+    .fileName("file-name.jpg")
+    .build();
 ```
 
 The most straightforward way to create a [`JsonValue`](image-kit-java-core/src/main/kotlin/com/imagekit/api/core/Values.kt) is using its `from(...)` method:
@@ -544,15 +570,11 @@ To forcibly omit a required parameter or property, pass [`JsonMissing`](image-ki
 
 ```java
 import com.imagekit.api.core.JsonMissing;
-import com.imagekit.api.models.custommetadatafields.CustomMetadataFieldCreateParams;
 import com.imagekit.api.models.files.FileUploadParams;
 
-FileUploadParams params = CustomMetadataFieldCreateParams.builder()
-    .name("price")
-    .schema(CustomMetadataFieldCreateParams.Schema.builder()
-        .type(CustomMetadataFieldCreateParams.Schema.Type.NUMBER)
-        .build())
-    .label(JsonMissing.of())
+FileUploadParams params = FileUploadParams.builder()
+    .fileName("fileName")
+    .file(JsonMissing.of())
     .build();
 ```
 
@@ -592,21 +614,22 @@ To access a property's raw JSON value, which may be undocumented, call its `_` p
 
 ```java
 import com.imagekit.api.core.JsonField;
+import java.io.InputStream;
 import java.util.Optional;
 
-JsonField<Object> field = client.files().upload(params)._field();
+JsonField<InputStream> file = client.files().upload(params)._file();
 
-if (field.isMissing()) {
+if (file.isMissing()) {
   // The property is absent from the JSON response
-} else if (field.isNull()) {
+} else if (file.isNull()) {
   // The property was set to literal null
 } else {
   // Check if value was provided as a string
   // Other methods include `asNumber()`, `asBoolean()`, etc.
-  Optional<String> jsonString = field.asString();
+  Optional<String> jsonString = file.asString();
 
   // Try to deserialize into a custom type
-  MyClass myObject = field.asUnknown().orElseThrow().convert(MyClass.class);
+  MyClass myObject = file.asUnknown().orElseThrow().convert(MyClass.class);
 }
 ```
 
@@ -629,7 +652,9 @@ Or configure the method call to validate the response using the `responseValidat
 ```java
 import com.imagekit.api.models.files.FileUploadResponse;
 
-FileUploadResponse response = client.files().upload(RequestOptions.builder().responseValidation(true).build());
+FileUploadResponse response = client.files().upload(
+  params, RequestOptions.builder().responseValidation(true).build()
+);
 ```
 
 Or configure the default for all method calls at the client level: