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

@@ -33,7 +33,10 @@ image_kit = Imagekit::Client.new(
   password: ENV["OPTIONAL_IMAGEKIT_IGNORES_THIS"] # This is the default and can be omitted
 )
 
-response = image_kit.files.upload(file: "https://www.example.com/public-url.jpg", file_name: "file-name.jpg")
+response = image_kit.files.upload(
+  file: StringIO.new("https://www.example.com/public-url.jpg"),
+  file_name: "file-name.jpg"
+)
 
 puts(response.videoCodec)
 ```
@@ -66,7 +69,10 @@ When the library is unable to connect to the API, or if the API returns a non-su
 
 ```ruby
 begin
-  file = image_kit.files.upload(file: "https://www.example.com/public-url.jpg", file_name: "file-name.jpg")
+  file = image_kit.files.upload(
+    file: StringIO.new("https://www.example.com/public-url.jpg"),
+    file_name: "file-name.jpg"
+  )
 rescue Imagekit::Errors::APIConnectionError => e
   puts("The server could not be reached")
   puts(e.cause)  # an underlying Exception, likely raised within `net/http`
@@ -110,7 +116,7 @@ image_kit = Imagekit::Client.new(
 
 # Or, configure per-request:
 image_kit.files.upload(
-  file: "https://www.example.com/public-url.jpg",
+  file: StringIO.new("https://www.example.com/public-url.jpg"),
   file_name: "file-name.jpg",
   request_options: {max_retries: 5}
 )
@@ -128,7 +134,7 @@ image_kit = Imagekit::Client.new(
 
 # Or, configure per-request:
 image_kit.files.upload(
-  file: "https://www.example.com/public-url.jpg",
+  file: StringIO.new("https://www.example.com/public-url.jpg"),
   file_name: "file-name.jpg",
   request_options: {timeout: 5}
 )
@@ -163,7 +169,7 @@ Note: the `extra_` parameters of the same name overrides the documented paramete
 ```ruby
 response =
   image_kit.files.upload(
-    file: "https://www.example.com/public-url.jpg",
+    file: StringIO.new("https://www.example.com/public-url.jpg"),
     file_name: "file-name.jpg",
     request_options: {
       extra_query: {my_query_parameter: value},
@@ -210,17 +216,26 @@ This library provides comprehensive [RBI](https://sorbet.org/docs/rbi) definitio
 You can provide typesafe request parameters like so:
 
 ```ruby
-image_kit.files.upload(file: "https://www.example.com/public-url.jpg", file_name: "file-name.jpg")
+image_kit.files.upload(
+  file: StringIO.new("https://www.example.com/public-url.jpg"),
+  file_name: "file-name.jpg"
+)
 ```
 
 Or, equivalently:
 
 ```ruby
 # Hashes work, but are not typesafe:
-image_kit.files.upload(file: "https://www.example.com/public-url.jpg", file_name: "file-name.jpg")
+image_kit.files.upload(
+  file: StringIO.new("https://www.example.com/public-url.jpg"),
+  file_name: "file-name.jpg"
+)
 
 # You can also splat a full Params class:
-params = Imagekit::FileUploadParams.new(file: "https://www.example.com/public-url.jpg", file_name: "file-name.jpg")
+params = Imagekit::FileUploadParams.new(
+  file: StringIO.new("https://www.example.com/public-url.jpg"),
+  file_name: "file-name.jpg"
+)
 image_kit.files.upload(**params)
 ```
 

lib/imagekit/models/file_upload_params.rb

@@ -8,12 +8,18 @@ class FileUploadParams < Imagekit::Internal::Type::BaseModel
       include Imagekit::Internal::Type::RequestParameters
 
       # @!attribute file
-      #   The URL of the file to upload. A publicly reachable URL that ImageKit servers
-      #   can fetch. The server must receive the response headers within 8 seconds;
-      #   otherwise the request fails with 400 Bad Request.
+      #   The API accepts any of the following:
       #
-      #   @return [String]
-      required :file, String
+      #   - **Binary data** – send the raw bytes as `multipart/form-data`.
+      #   - **HTTP / HTTPS URL** – a publicly reachable URL that ImageKit’s servers can
+      #     fetch.
+      #   - **Base64 string** – the file encoded as a Base64 data URI or plain Base64.
+      #
+      #   When supplying a URL, the server must receive the response headers within 8
+      #   seconds; otherwise the request fails with 400 Bad Request.
+      #
+      #   @return [Pathname, StringIO, IO, String, Imagekit::FilePart]
+      required :file, Imagekit::Internal::Type::FileInput
 
       # @!attribute file_name
       #   The name with which the file has to be uploaded. The file name can contain:
@@ -234,7 +240,7 @@ class FileUploadParams < Imagekit::Internal::Type::BaseModel
       #   Some parameter documentations has been truncated, see
       #   {Imagekit::Models::FileUploadParams} for more details.
       #
-      #   @param file [String] The URL of the file to upload. A publicly reachable URL that ImageKit servers ca
+      #   @param file [Pathname, StringIO, IO, String, Imagekit::FilePart] The API accepts any of the following:
       #
       #   @param file_name [String] The name with which the file has to be uploaded.
       #

lib/imagekit/resources/files.rb

@@ -221,7 +221,7 @@ def rename(params)
       #
       # @overload upload(file:, file_name:, token: nil, checks: nil, custom_coordinates: nil, custom_metadata: nil, description: nil, expire: nil, extensions: nil, folder: nil, is_private_file: nil, is_published: nil, overwrite_ai_tags: nil, overwrite_custom_metadata: nil, overwrite_file: nil, overwrite_tags: nil, public_key: nil, response_fields: nil, signature: nil, tags: nil, transformation: nil, use_unique_file_name: nil, webhook_url: nil, request_options: {})
       #
-      # @param file [String] The URL of the file to upload. A publicly reachable URL that ImageKit servers ca
+      # @param file [Pathname, StringIO, IO, String, Imagekit::FilePart] The API accepts any of the following:
       #
       # @param file_name [String] The name with which the file has to be uploaded.
       #

rbi/imagekit/models/file_upload_params.rbi

@@ -11,10 +11,16 @@ module Imagekit
           T.any(Imagekit::FileUploadParams, Imagekit::Internal::AnyHash)
         end
 
-      # The URL of the file to upload. A publicly reachable URL that ImageKit servers
-      # can fetch. The server must receive the response headers within 8 seconds;
-      # otherwise the request fails with 400 Bad Request.
-      sig { returns(String) }
+      # The API accepts any of the following:
+      #
+      # - **Binary data** – send the raw bytes as `multipart/form-data`.
+      # - **HTTP / HTTPS URL** – a publicly reachable URL that ImageKit’s servers can
+      #   fetch.
+      # - **Base64 string** – the file encoded as a Base64 data URI or plain Base64.
+      #
+      # When supplying a URL, the server must receive the response headers within 8
+      # seconds; otherwise the request fails with 400 Bad Request.
+      sig { returns(Imagekit::Internal::FileInput) }
       attr_accessor :file
 
       # The name with which the file has to be uploaded. The file name can contain:
@@ -284,7 +290,7 @@ module Imagekit
 
       sig do
         params(
-          file: String,
+          file: Imagekit::Internal::FileInput,
           file_name: String,
           token: String,
           checks: String,
@@ -319,9 +325,15 @@ module Imagekit
         ).returns(T.attached_class)
       end
       def self.new(
-        # The URL of the file to upload. A publicly reachable URL that ImageKit servers
-        # can fetch. The server must receive the response headers within 8 seconds;
-        # otherwise the request fails with 400 Bad Request.
+        # The API accepts any of the following:
+        #
+        # - **Binary data** – send the raw bytes as `multipart/form-data`.
+        # - **HTTP / HTTPS URL** – a publicly reachable URL that ImageKit’s servers can
+        #   fetch.
+        # - **Base64 string** – the file encoded as a Base64 data URI or plain Base64.
+        #
+        # When supplying a URL, the server must receive the response headers within 8
+        # seconds; otherwise the request fails with 400 Bad Request.
         file:,
         # The name with which the file has to be uploaded. The file name can contain:
         #
@@ -450,7 +462,7 @@ module Imagekit
       sig do
         override.returns(
           {
-            file: String,
+            file: Imagekit::Internal::FileInput,
             file_name: String,
             token: String,
             checks: String,

rbi/imagekit/resources/files.rbi

@@ -189,7 +189,7 @@ module Imagekit
       #   technologies.
       sig do
         params(
-          file: String,
+          file: Imagekit::Internal::FileInput,
           file_name: String,
           token: String,
           checks: String,
@@ -224,9 +224,15 @@ module Imagekit
         ).returns(Imagekit::Models::FileUploadResponse)
       end
       def upload(
-        # The URL of the file to upload. A publicly reachable URL that ImageKit servers
-        # can fetch. The server must receive the response headers within 8 seconds;
-        # otherwise the request fails with 400 Bad Request.
+        # The API accepts any of the following:
+        #
+        # - **Binary data** – send the raw bytes as `multipart/form-data`.
+        # - **HTTP / HTTPS URL** – a publicly reachable URL that ImageKit’s servers can
+        #   fetch.
+        # - **Base64 string** – the file encoded as a Base64 data URI or plain Base64.
+        #
+        # When supplying a URL, the server must receive the response headers within 8
+        # seconds; otherwise the request fails with 400 Bad Request.
         file:,
         # The name with which the file has to be uploaded. The file name can contain:
         #

sig/imagekit/models/file_upload_params.rbs

@@ -2,7 +2,7 @@ module Imagekit
   module Models
     type file_upload_params =
       {
-        file: String,
+        file: Imagekit::Internal::file_input,
         file_name: String,
         token: String,
         checks: String,
@@ -32,7 +32,7 @@ module Imagekit
       extend Imagekit::Internal::Type::RequestParameters::Converter
       include Imagekit::Internal::Type::RequestParameters
 
-      attr_accessor file: String
+      attr_accessor file: Imagekit::Internal::file_input
 
       attr_accessor file_name: String
 
@@ -127,7 +127,7 @@ module Imagekit
       def webhook_url=: (String) -> String
 
       def initialize: (
-        file: String,
+        file: Imagekit::Internal::file_input,
         file_name: String,
         ?token: String,
         ?checks: String,
@@ -154,7 +154,7 @@ module Imagekit
       ) -> void
 
       def to_hash: -> {
-        file: String,
+        file: Imagekit::Internal::file_input,
         file_name: String,
         token: String,
         checks: String,

sig/imagekit/resources/files.rbs

@@ -44,7 +44,7 @@ module Imagekit
       ) -> Imagekit::Models::FileRenameResponse
 
       def upload: (
-        file: String,
+        file: Imagekit::Internal::file_input,
         file_name: String,
         ?token: String,
         ?checks: String,