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-667f7f4988b44bc587d6eb9960ff5c8326e9f7e9b072f3f724f9f54166eff8b1.yml
-openapi_spec_hash: f2081864a4abee0480e5ff991b4c936a
+openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/imagekit-inc%2Fimagekit-9ae7b43dcfd6208ca37c32c887630ae186ec338bcdd36902b6fe5d1cc66459dc.yml
+openapi_spec_hash: 25fb64c067e64bcff6eaaabda26de397
 config_hash: 70f9408b8d1dfbcf262a20d6eed50e1c

README.md

@@ -33,10 +33,7 @@ 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: StringIO.new("https://www.example.com/public-url.jpg"),
-  file_name: "file-name.jpg"
-)
+response = image_kit.files.upload(file: "https://www.example.com/public-url.jpg", file_name: "file-name.jpg")
 
 puts(response.videoCodec)
 ```
@@ -69,10 +66,7 @@ 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: StringIO.new("https://www.example.com/public-url.jpg"),
-    file_name: "file-name.jpg"
-  )
+  file = image_kit.files.upload(file: "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`
@@ -116,7 +110,7 @@ image_kit = Imagekit::Client.new(
 
 # Or, configure per-request:
 image_kit.files.upload(
-  file: StringIO.new("https://www.example.com/public-url.jpg"),
+  file: "https://www.example.com/public-url.jpg",
   file_name: "file-name.jpg",
   request_options: {max_retries: 5}
 )
@@ -134,7 +128,7 @@ image_kit = Imagekit::Client.new(
 
 # Or, configure per-request:
 image_kit.files.upload(
-  file: StringIO.new("https://www.example.com/public-url.jpg"),
+  file: "https://www.example.com/public-url.jpg",
   file_name: "file-name.jpg",
   request_options: {timeout: 5}
 )
@@ -169,7 +163,7 @@ Note: the `extra_` parameters of the same name overrides the documented paramete
 ```ruby
 response =
   image_kit.files.upload(
-    file: StringIO.new("https://www.example.com/public-url.jpg"),
+    file: "https://www.example.com/public-url.jpg",
     file_name: "file-name.jpg",
     request_options: {
       extra_query: {my_query_parameter: value},
@@ -216,26 +210,17 @@ 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: StringIO.new("https://www.example.com/public-url.jpg"),
-  file_name: "file-name.jpg"
-)
+image_kit.files.upload(file: "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: StringIO.new("https://www.example.com/public-url.jpg"),
-  file_name: "file-name.jpg"
-)
+image_kit.files.upload(file: "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: StringIO.new("https://www.example.com/public-url.jpg"),
-  file_name: "file-name.jpg"
-)
+params = Imagekit::FileUploadParams.new(file: "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,18 +8,12 @@ class FileUploadParams < Imagekit::Internal::Type::BaseModel
       include Imagekit::Internal::Type::RequestParameters
 
       # @!attribute file
-      #   The API accepts any of the following:
+      #   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.
       #
-      #   - **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
+      #   @return [String]
+      required :file, String
 
       # @!attribute file_name
       #   The name with which the file has to be uploaded. The file name can contain:
@@ -240,7 +234,7 @@ class FileUploadParams < Imagekit::Internal::Type::BaseModel
       #   Some parameter documentations has been truncated, see
       #   {Imagekit::Models::FileUploadParams} for more details.
       #
-      #   @param file [Pathname, StringIO, IO, String, Imagekit::FilePart] The API accepts any of the following:
+      #   @param file [String] The URL of the file to upload. A publicly reachable URL that ImageKit servers ca
       #
       #   @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 [Pathname, StringIO, IO, String, Imagekit::FilePart] The API accepts any of the following:
+      # @param file [String] The URL of the file to upload. A publicly reachable URL that ImageKit servers ca
       #
       # @param file_name [String] The name with which the file has to be uploaded.
       #

rbi/imagekit/models/file_upload_params.rbi

@@ -11,16 +11,10 @@ module Imagekit
           T.any(Imagekit::FileUploadParams, Imagekit::Internal::AnyHash)
         end
 
-      # 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) }
+      # 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) }
       attr_accessor :file
 
       # The name with which the file has to be uploaded. The file name can contain:
@@ -290,7 +284,7 @@ module Imagekit
 
       sig do
         params(
-          file: Imagekit::Internal::FileInput,
+          file: String,
           file_name: String,
           token: String,
           checks: String,
@@ -325,15 +319,9 @@ module Imagekit
         ).returns(T.attached_class)
       end
       def self.new(
-        # 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.
+        # 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.
         file:,
         # The name with which the file has to be uploaded. The file name can contain:
         #
@@ -462,7 +450,7 @@ module Imagekit
       sig do
         override.returns(
           {
-            file: Imagekit::Internal::FileInput,
+            file: String,
             file_name: String,
             token: String,
             checks: String,

rbi/imagekit/resources/files.rbi

@@ -189,7 +189,7 @@ module Imagekit
       #   technologies.
       sig do
         params(
-          file: Imagekit::Internal::FileInput,
+          file: String,
           file_name: String,
           token: String,
           checks: String,
@@ -224,15 +224,9 @@ module Imagekit
         ).returns(Imagekit::Models::FileUploadResponse)
       end
       def upload(
-        # 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.
+        # 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.
         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: Imagekit::Internal::file_input,
+        file: String,
         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: Imagekit::Internal::file_input
+      attr_accessor file: String
 
       attr_accessor file_name: String
 
@@ -127,7 +127,7 @@ module Imagekit
       def webhook_url=: (String) -> String
 
       def initialize: (
-        file: Imagekit::Internal::file_input,
+        file: String,
         file_name: String,
         ?token: String,
         ?checks: String,
@@ -154,7 +154,7 @@ module Imagekit
       ) -> void
 
       def to_hash: -> {
-        file: Imagekit::Internal::file_input,
+        file: String,
         file_name: String,
         token: String,
         checks: String,

sig/imagekit/resources/files.rbs

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