imagekitio 3.0.0 → 4.0.0

data/lib/imagekitio/models/video_transformation_ready_event.rb

@@ -0,0 +1,379 @@
+# frozen_string_literal: true
+
+module Imagekitio
+  module Models
+    class VideoTransformationReadyEvent < Imagekitio::Models::BaseWebhookEvent
+      # @!attribute created_at
+      #   Timestamp when the event was created in ISO8601 format.
+      #
+      #   @return [Time]
+      required :created_at, Time
+
+      # @!attribute data
+      #
+      #   @return [Imagekitio::Models::VideoTransformationReadyEvent::Data]
+      required :data, -> { Imagekitio::VideoTransformationReadyEvent::Data }
+
+      # @!attribute request
+      #   Information about the original request that triggered the video transformation.
+      #
+      #   @return [Imagekitio::Models::VideoTransformationReadyEvent::Request]
+      required :request, -> { Imagekitio::VideoTransformationReadyEvent::Request }
+
+      # @!attribute type
+      #
+      #   @return [Symbol, :"video.transformation.ready"]
+      required :type, const: :"video.transformation.ready"
+
+      # @!attribute timings
+      #   Performance metrics for the transformation process.
+      #
+      #   @return [Imagekitio::Models::VideoTransformationReadyEvent::Timings, nil]
+      optional :timings, -> { Imagekitio::VideoTransformationReadyEvent::Timings }
+
+      # @!method initialize(created_at:, data:, request:, timings: nil, type: :"video.transformation.ready")
+      #   Triggered when video encoding is finished and the transformed resource is ready
+      #   to be served. This is the key event to listen for - update your database or CMS
+      #   flags when you receive this so your application can start showing the
+      #   transformed video to users.
+      #
+      #   @param created_at [Time] Timestamp when the event was created in ISO8601 format.
+      #
+      #   @param data [Imagekitio::Models::VideoTransformationReadyEvent::Data]
+      #
+      #   @param request [Imagekitio::Models::VideoTransformationReadyEvent::Request] Information about the original request that triggered the video transformation.
+      #
+      #   @param timings [Imagekitio::Models::VideoTransformationReadyEvent::Timings] Performance metrics for the transformation process.
+      #
+      #   @param type [Symbol, :"video.transformation.ready"]
+
+      class Data < Imagekitio::Internal::Type::BaseModel
+        # @!attribute asset
+        #   Information about the source video asset being transformed.
+        #
+        #   @return [Imagekitio::Models::VideoTransformationReadyEvent::Data::Asset]
+        required :asset, -> { Imagekitio::VideoTransformationReadyEvent::Data::Asset }
+
+        # @!attribute transformation
+        #
+        #   @return [Imagekitio::Models::VideoTransformationReadyEvent::Data::Transformation]
+        required :transformation, -> { Imagekitio::VideoTransformationReadyEvent::Data::Transformation }
+
+        # @!method initialize(asset:, transformation:)
+        #   @param asset [Imagekitio::Models::VideoTransformationReadyEvent::Data::Asset] Information about the source video asset being transformed.
+        #
+        #   @param transformation [Imagekitio::Models::VideoTransformationReadyEvent::Data::Transformation]
+
+        # @see Imagekitio::Models::VideoTransformationReadyEvent::Data#asset
+        class Asset < Imagekitio::Internal::Type::BaseModel
+          # @!attribute url
+          #   URL to download or access the source video file.
+          #
+          #   @return [String]
+          required :url, String
+
+          # @!method initialize(url:)
+          #   Information about the source video asset being transformed.
+          #
+          #   @param url [String] URL to download or access the source video file.
+        end
+
+        # @see Imagekitio::Models::VideoTransformationReadyEvent::Data#transformation
+        class Transformation < Imagekitio::Internal::Type::BaseModel
+          # @!attribute type
+          #   Type of video transformation:
+          #
+          #   - `video-transformation`: Standard video processing (resize, format conversion,
+          #     etc.)
+          #   - `gif-to-video`: Convert animated GIF to video format
+          #   - `video-thumbnail`: Generate thumbnail image from video
+          #
+          #   @return [Symbol, Imagekitio::Models::VideoTransformationReadyEvent::Data::Transformation::Type]
+          required :type, enum: -> { Imagekitio::VideoTransformationReadyEvent::Data::Transformation::Type }
+
+          # @!attribute options
+          #   Configuration options for video transformations.
+          #
+          #   @return [Imagekitio::Models::VideoTransformationReadyEvent::Data::Transformation::Options, nil]
+          optional :options, -> { Imagekitio::VideoTransformationReadyEvent::Data::Transformation::Options }
+
+          # @!attribute output
+          #   Information about the transformed output video.
+          #
+          #   @return [Imagekitio::Models::VideoTransformationReadyEvent::Data::Transformation::Output, nil]
+          optional :output, -> { Imagekitio::VideoTransformationReadyEvent::Data::Transformation::Output }
+
+          # @!method initialize(type:, options: nil, output: nil)
+          #   Some parameter documentations has been truncated, see
+          #   {Imagekitio::Models::VideoTransformationReadyEvent::Data::Transformation} for
+          #   more details.
+          #
+          #   @param type [Symbol, Imagekitio::Models::VideoTransformationReadyEvent::Data::Transformation::Type] Type of video transformation:
+          #
+          #   @param options [Imagekitio::Models::VideoTransformationReadyEvent::Data::Transformation::Options] Configuration options for video transformations.
+          #
+          #   @param output [Imagekitio::Models::VideoTransformationReadyEvent::Data::Transformation::Output] Information about the transformed output video.
+
+          # Type of video transformation:
+          #
+          # - `video-transformation`: Standard video processing (resize, format conversion,
+          #   etc.)
+          # - `gif-to-video`: Convert animated GIF to video format
+          # - `video-thumbnail`: Generate thumbnail image from video
+          #
+          # @see Imagekitio::Models::VideoTransformationReadyEvent::Data::Transformation#type
+          module Type
+            extend Imagekitio::Internal::Type::Enum
+
+            VIDEO_TRANSFORMATION = :"video-transformation"
+            GIF_TO_VIDEO = :"gif-to-video"
+            VIDEO_THUMBNAIL = :"video-thumbnail"
+
+            # @!method self.values
+            #   @return [Array<Symbol>]
+          end
+
+          # @see Imagekitio::Models::VideoTransformationReadyEvent::Data::Transformation#options
+          class Options < Imagekitio::Internal::Type::BaseModel
+            # @!attribute audio_codec
+            #   Audio codec used for encoding (aac or opus).
+            #
+            #   @return [Symbol, Imagekitio::Models::VideoTransformationReadyEvent::Data::Transformation::Options::AudioCodec, nil]
+            optional :audio_codec,
+                     enum: -> { Imagekitio::VideoTransformationReadyEvent::Data::Transformation::Options::AudioCodec }
+
+            # @!attribute auto_rotate
+            #   Whether to automatically rotate the video based on metadata.
+            #
+            #   @return [Boolean, nil]
+            optional :auto_rotate, Imagekitio::Internal::Type::Boolean
+
+            # @!attribute format_
+            #   Output format for the transformed video or thumbnail.
+            #
+            #   @return [Symbol, Imagekitio::Models::VideoTransformationReadyEvent::Data::Transformation::Options::Format, nil]
+            optional :format_,
+                     enum: -> {
+                       Imagekitio::VideoTransformationReadyEvent::Data::Transformation::Options::Format
+                     },
+                     api_name: :format
+
+            # @!attribute quality
+            #   Quality setting for the output video.
+            #
+            #   @return [Integer, nil]
+            optional :quality, Integer
+
+            # @!attribute stream_protocol
+            #   Streaming protocol for adaptive bitrate streaming.
+            #
+            #   @return [Symbol, Imagekitio::Models::VideoTransformationReadyEvent::Data::Transformation::Options::StreamProtocol, nil]
+            optional :stream_protocol,
+                     enum: -> { Imagekitio::VideoTransformationReadyEvent::Data::Transformation::Options::StreamProtocol }
+
+            # @!attribute variants
+            #   Array of quality representations for adaptive bitrate streaming.
+            #
+            #   @return [Array<String>, nil]
+            optional :variants, Imagekitio::Internal::Type::ArrayOf[String]
+
+            # @!attribute video_codec
+            #   Video codec used for encoding (h264, vp9, or av1).
+            #
+            #   @return [Symbol, Imagekitio::Models::VideoTransformationReadyEvent::Data::Transformation::Options::VideoCodec, nil]
+            optional :video_codec,
+                     enum: -> { Imagekitio::VideoTransformationReadyEvent::Data::Transformation::Options::VideoCodec }
+
+            # @!method initialize(audio_codec: nil, auto_rotate: nil, format_: nil, quality: nil, stream_protocol: nil, variants: nil, video_codec: nil)
+            #   Configuration options for video transformations.
+            #
+            #   @param audio_codec [Symbol, Imagekitio::Models::VideoTransformationReadyEvent::Data::Transformation::Options::AudioCodec] Audio codec used for encoding (aac or opus).
+            #
+            #   @param auto_rotate [Boolean] Whether to automatically rotate the video based on metadata.
+            #
+            #   @param format_ [Symbol, Imagekitio::Models::VideoTransformationReadyEvent::Data::Transformation::Options::Format] Output format for the transformed video or thumbnail.
+            #
+            #   @param quality [Integer] Quality setting for the output video.
+            #
+            #   @param stream_protocol [Symbol, Imagekitio::Models::VideoTransformationReadyEvent::Data::Transformation::Options::StreamProtocol] Streaming protocol for adaptive bitrate streaming.
+            #
+            #   @param variants [Array<String>] Array of quality representations for adaptive bitrate streaming.
+            #
+            #   @param video_codec [Symbol, Imagekitio::Models::VideoTransformationReadyEvent::Data::Transformation::Options::VideoCodec] Video codec used for encoding (h264, vp9, or av1).
+
+            # Audio codec used for encoding (aac or opus).
+            #
+            # @see Imagekitio::Models::VideoTransformationReadyEvent::Data::Transformation::Options#audio_codec
+            module AudioCodec
+              extend Imagekitio::Internal::Type::Enum
+
+              AAC = :aac
+              OPUS = :opus
+
+              # @!method self.values
+              #   @return [Array<Symbol>]
+            end
+
+            # Output format for the transformed video or thumbnail.
+            #
+            # @see Imagekitio::Models::VideoTransformationReadyEvent::Data::Transformation::Options#format_
+            module Format
+              extend Imagekitio::Internal::Type::Enum
+
+              MP4 = :mp4
+              WEBM = :webm
+              JPG = :jpg
+              PNG = :png
+              WEBP = :webp
+
+              # @!method self.values
+              #   @return [Array<Symbol>]
+            end
+
+            # Streaming protocol for adaptive bitrate streaming.
+            #
+            # @see Imagekitio::Models::VideoTransformationReadyEvent::Data::Transformation::Options#stream_protocol
+            module StreamProtocol
+              extend Imagekitio::Internal::Type::Enum
+
+              HLS = :HLS
+              DASH = :DASH
+
+              # @!method self.values
+              #   @return [Array<Symbol>]
+            end
+
+            # Video codec used for encoding (h264, vp9, or av1).
+            #
+            # @see Imagekitio::Models::VideoTransformationReadyEvent::Data::Transformation::Options#video_codec
+            module VideoCodec
+              extend Imagekitio::Internal::Type::Enum
+
+              H264 = :h264
+              VP9 = :vp9
+              AV1 = :av1
+
+              # @!method self.values
+              #   @return [Array<Symbol>]
+            end
+          end
+
+          # @see Imagekitio::Models::VideoTransformationReadyEvent::Data::Transformation#output
+          class Output < Imagekitio::Internal::Type::BaseModel
+            # @!attribute url
+            #   URL to access the transformed video.
+            #
+            #   @return [String]
+            required :url, String
+
+            # @!attribute video_metadata
+            #   Metadata of the output video file.
+            #
+            #   @return [Imagekitio::Models::VideoTransformationReadyEvent::Data::Transformation::Output::VideoMetadata, nil]
+            optional :video_metadata,
+                     -> { Imagekitio::VideoTransformationReadyEvent::Data::Transformation::Output::VideoMetadata }
+
+            # @!method initialize(url:, video_metadata: nil)
+            #   Information about the transformed output video.
+            #
+            #   @param url [String] URL to access the transformed video.
+            #
+            #   @param video_metadata [Imagekitio::Models::VideoTransformationReadyEvent::Data::Transformation::Output::VideoMetadata] Metadata of the output video file.
+
+            # @see Imagekitio::Models::VideoTransformationReadyEvent::Data::Transformation::Output#video_metadata
+            class VideoMetadata < Imagekitio::Internal::Type::BaseModel
+              # @!attribute bitrate
+              #   Bitrate of the output video in bits per second.
+              #
+              #   @return [Integer]
+              required :bitrate, Integer
+
+              # @!attribute duration
+              #   Duration of the output video in seconds.
+              #
+              #   @return [Float]
+              required :duration, Float
+
+              # @!attribute height
+              #   Height of the output video in pixels.
+              #
+              #   @return [Integer]
+              required :height, Integer
+
+              # @!attribute width
+              #   Width of the output video in pixels.
+              #
+              #   @return [Integer]
+              required :width, Integer
+
+              # @!method initialize(bitrate:, duration:, height:, width:)
+              #   Metadata of the output video file.
+              #
+              #   @param bitrate [Integer] Bitrate of the output video in bits per second.
+              #
+              #   @param duration [Float] Duration of the output video in seconds.
+              #
+              #   @param height [Integer] Height of the output video in pixels.
+              #
+              #   @param width [Integer] Width of the output video in pixels.
+            end
+          end
+        end
+      end
+
+      class Request < Imagekitio::Internal::Type::BaseModel
+        # @!attribute url
+        #   Full URL of the transformation request that was submitted.
+        #
+        #   @return [String]
+        required :url, String
+
+        # @!attribute x_request_id
+        #   Unique identifier for the originating transformation request.
+        #
+        #   @return [String]
+        required :x_request_id, String
+
+        # @!attribute user_agent
+        #   User-Agent header from the original request that triggered the transformation.
+        #
+        #   @return [String, nil]
+        optional :user_agent, String
+
+        # @!method initialize(url:, x_request_id:, user_agent: nil)
+        #   Information about the original request that triggered the video transformation.
+        #
+        #   @param url [String] Full URL of the transformation request that was submitted.
+        #
+        #   @param x_request_id [String] Unique identifier for the originating transformation request.
+        #
+        #   @param user_agent [String] User-Agent header from the original request that triggered the transformation.
+      end
+
+      class Timings < Imagekitio::Internal::Type::BaseModel
+        # @!attribute download_duration
+        #   Time spent downloading the source video from your origin or media library, in
+        #   milliseconds.
+        #
+        #   @return [Integer, nil]
+        optional :download_duration, Integer
+
+        # @!attribute encoding_duration
+        #   Time spent encoding the video, in milliseconds.
+        #
+        #   @return [Integer, nil]
+        optional :encoding_duration, Integer
+
+        # @!method initialize(download_duration: nil, encoding_duration: nil)
+        #   Some parameter documentations has been truncated, see
+        #   {Imagekitio::Models::VideoTransformationReadyEvent::Timings} for more details.
+        #
+        #   Performance metrics for the transformation process.
+        #
+        #   @param download_duration [Integer] Time spent downloading the source video from your origin or media library, in mi
+        #
+        #   @param encoding_duration [Integer] Time spent encoding the video, in milliseconds.
+      end
+    end
+  end
+end

data/lib/imagekitio/models/webhook_unsafe_unwrap_params.rb

@@ -0,0 +1,14 @@
+# frozen_string_literal: true
+
+module Imagekitio
+  module Models
+    # @see Imagekitio::Resources::Webhooks#unsafe_unwrap
+    class WebhookUnsafeUnwrapParams < Imagekitio::Internal::Type::BaseModel
+      extend Imagekitio::Internal::Type::RequestParameters::Converter
+      include Imagekitio::Internal::Type::RequestParameters
+
+      # @!method initialize(request_options: {})
+      #   @param request_options [Imagekitio::RequestOptions, Hash{Symbol=>Object}]
+    end
+  end
+end

data/lib/imagekitio/models/webhook_unwrap_params.rb

@@ -0,0 +1,14 @@
+# frozen_string_literal: true
+
+module Imagekitio
+  module Models
+    # @see Imagekitio::Resources::Webhooks#unwrap
+    class WebhookUnwrapParams < Imagekitio::Internal::Type::BaseModel
+      extend Imagekitio::Internal::Type::RequestParameters::Converter
+      include Imagekitio::Internal::Type::RequestParameters
+
+      # @!method initialize(request_options: {})
+      #   @param request_options [Imagekitio::RequestOptions, Hash{Symbol=>Object}]
+    end
+  end
+end

data/lib/imagekitio/models.rb

@@ -0,0 +1,160 @@
+# frozen_string_literal: true
+
+module Imagekitio
+  [Imagekitio::Internal::Type::BaseModel, *Imagekitio::Internal::Type::BaseModel.subclasses].each do |cls|
+    cls.define_sorbet_constant!(:OrHash) { T.type_alias { T.any(cls, Imagekitio::Internal::AnyHash) } }
+  end
+
+  Imagekitio::Internal::Util.walk_namespaces(Imagekitio::Models).each do |mod|
+    case mod
+    in Imagekitio::Internal::Type::Enum | Imagekitio::Internal::Type::Union
+      mod.constants.each do |name|
+        case mod.const_get(name)
+        in true | false
+          mod.define_sorbet_constant!(:TaggedBoolean) { T.type_alias { T::Boolean } }
+          mod.define_sorbet_constant!(:OrBoolean) { T.type_alias { T::Boolean } }
+        in Integer
+          mod.define_sorbet_constant!(:TaggedInteger) { T.type_alias { Integer } }
+          mod.define_sorbet_constant!(:OrInteger) { T.type_alias { Integer } }
+        in Float
+          mod.define_sorbet_constant!(:TaggedFloat) { T.type_alias { Float } }
+          mod.define_sorbet_constant!(:OrFloat) { T.type_alias { Float } }
+        in Symbol
+          mod.define_sorbet_constant!(:TaggedSymbol) { T.type_alias { Symbol } }
+          mod.define_sorbet_constant!(:OrSymbol) { T.type_alias { T.any(Symbol, String) } }
+        else
+        end
+      end
+    else
+    end
+  end
+
+  Imagekitio::Internal::Util.walk_namespaces(Imagekitio::Models)
+                            .lazy
+                            .grep(Imagekitio::Internal::Type::Union)
+                            .each do |mod|
+    const = :Variants
+    next if mod.sorbet_constant_defined?(const)
+
+    mod.define_sorbet_constant!(const) { T.type_alias { mod.to_sorbet_type } }
+  end
+
+  Accounts = Imagekitio::Models::Accounts
+
+  AssetListParams = Imagekitio::Models::AssetListParams
+
+  BaseOverlay = Imagekitio::Models::BaseOverlay
+
+  BaseWebhookEvent = Imagekitio::Models::BaseWebhookEvent
+
+  Beta = Imagekitio::Models::Beta
+
+  Cache = Imagekitio::Models::Cache
+
+  CustomMetadataField = Imagekitio::Models::CustomMetadataField
+
+  CustomMetadataFieldCreateParams = Imagekitio::Models::CustomMetadataFieldCreateParams
+
+  CustomMetadataFieldDeleteParams = Imagekitio::Models::CustomMetadataFieldDeleteParams
+
+  CustomMetadataFieldListParams = Imagekitio::Models::CustomMetadataFieldListParams
+
+  CustomMetadataFieldUpdateParams = Imagekitio::Models::CustomMetadataFieldUpdateParams
+
+  ExtensionItem = Imagekitio::Models::ExtensionItem
+
+  # @type [Imagekitio::Internal::Type::Converter]
+  Extensions = Imagekitio::Models::Extensions
+
+  File = Imagekitio::Models::File
+
+  FileCopyParams = Imagekitio::Models::FileCopyParams
+
+  FileDeleteParams = Imagekitio::Models::FileDeleteParams
+
+  FileGetParams = Imagekitio::Models::FileGetParams
+
+  FileMoveParams = Imagekitio::Models::FileMoveParams
+
+  FileRenameParams = Imagekitio::Models::FileRenameParams
+
+  Files = Imagekitio::Models::Files
+
+  FileUpdateParams = Imagekitio::Models::FileUpdateParams
+
+  FileUploadParams = Imagekitio::Models::FileUploadParams
+
+  Folder = Imagekitio::Models::Folder
+
+  FolderCopyParams = Imagekitio::Models::FolderCopyParams
+
+  FolderCreateParams = Imagekitio::Models::FolderCreateParams
+
+  FolderDeleteParams = Imagekitio::Models::FolderDeleteParams
+
+  FolderMoveParams = Imagekitio::Models::FolderMoveParams
+
+  FolderRenameParams = Imagekitio::Models::FolderRenameParams
+
+  Folders = Imagekitio::Models::Folders
+
+  GetImageAttributesOptions = Imagekitio::Models::GetImageAttributesOptions
+
+  ImageOverlay = Imagekitio::Models::ImageOverlay
+
+  Metadata = Imagekitio::Models::Metadata
+
+  Overlay = Imagekitio::Models::Overlay
+
+  OverlayPosition = Imagekitio::Models::OverlayPosition
+
+  OverlayTiming = Imagekitio::Models::OverlayTiming
+
+  ResponsiveImageAttributes = Imagekitio::Models::ResponsiveImageAttributes
+
+  SolidColorOverlay = Imagekitio::Models::SolidColorOverlay
+
+  SolidColorOverlayTransformation = Imagekitio::Models::SolidColorOverlayTransformation
+
+  SrcOptions = Imagekitio::Models::SrcOptions
+
+  StreamingResolution = Imagekitio::Models::StreamingResolution
+
+  SubtitleOverlay = Imagekitio::Models::SubtitleOverlay
+
+  SubtitleOverlayTransformation = Imagekitio::Models::SubtitleOverlayTransformation
+
+  TextOverlay = Imagekitio::Models::TextOverlay
+
+  TextOverlayTransformation = Imagekitio::Models::TextOverlayTransformation
+
+  Transformation = Imagekitio::Models::Transformation
+
+  TransformationPosition = Imagekitio::Models::TransformationPosition
+
+  UnsafeUnwrapWebhookEvent = Imagekitio::Models::UnsafeUnwrapWebhookEvent
+
+  UnwrapWebhookEvent = Imagekitio::Models::UnwrapWebhookEvent
+
+  UpdateFileRequest = Imagekitio::Models::UpdateFileRequest
+
+  UploadPostTransformErrorEvent = Imagekitio::Models::UploadPostTransformErrorEvent
+
+  UploadPostTransformSuccessEvent = Imagekitio::Models::UploadPostTransformSuccessEvent
+
+  UploadPreTransformErrorEvent = Imagekitio::Models::UploadPreTransformErrorEvent
+
+  UploadPreTransformSuccessEvent = Imagekitio::Models::UploadPreTransformSuccessEvent
+
+  VideoOverlay = Imagekitio::Models::VideoOverlay
+
+  VideoTransformationAcceptedEvent = Imagekitio::Models::VideoTransformationAcceptedEvent
+
+  VideoTransformationErrorEvent = Imagekitio::Models::VideoTransformationErrorEvent
+
+  VideoTransformationReadyEvent = Imagekitio::Models::VideoTransformationReadyEvent
+
+  WebhookUnsafeUnwrapParams = Imagekitio::Models::WebhookUnsafeUnwrapParams
+
+  WebhookUnwrapParams = Imagekitio::Models::WebhookUnwrapParams
+end

data/lib/imagekitio/request_options.rb

@@ -0,0 +1,77 @@
+# frozen_string_literal: true
+
+module Imagekitio
+  # Specify HTTP behaviour to use for a specific request. These options supplement
+  # or override those provided at the client level.
+  #
+  # When making a request, you can pass an actual {RequestOptions} instance, or
+  # simply pass a Hash with symbol keys matching the attributes on this class.
+  class RequestOptions < Imagekitio::Internal::Type::BaseModel
+    # @api private
+    #
+    # @param opts [Imagekitio::RequestOptions, Hash{Symbol=>Object}]
+    #
+    # @raise [ArgumentError]
+    def self.validate!(opts)
+      case opts
+      in Imagekitio::RequestOptions | Hash
+        opts.to_h.each_key do |k|
+          unless fields.include?(k)
+            raise ArgumentError.new("Request `opts` keys must be one of #{fields.keys}, got #{k.inspect}")
+          end
+        end
+      else
+        raise ArgumentError.new("Request `opts` must be a Hash or RequestOptions, got #{opts.inspect}")
+      end
+    end
+
+    # @!attribute idempotency_key
+    #   Idempotency key to send with request and all associated retries. Will only be
+    #   sent for write requests.
+    #
+    #   @return [String, nil]
+    optional :idempotency_key, String
+
+    # @!attribute extra_query
+    #   Extra query params to send with the request. These are `.merge`’d into any
+    #   `query` given at the client level.
+    #
+    #   @return [Hash{String=>Array<String>, String, nil}, nil]
+    optional :extra_query, Imagekitio::Internal::Type::HashOf[Imagekitio::Internal::Type::ArrayOf[String]]
+
+    # @!attribute extra_headers
+    #   Extra headers to send with the request. These are `.merged`’d into any
+    #   `extra_headers` given at the client level.
+    #
+    #   @return [Hash{String=>String, nil}, nil]
+    optional :extra_headers, Imagekitio::Internal::Type::HashOf[String, nil?: true]
+
+    # @!attribute extra_body
+    #   Extra data to send with the request. These are deep merged into any data
+    #   generated as part of the normal request.
+    #
+    #   @return [Object, nil]
+    optional :extra_body, Imagekitio::Internal::Type::HashOf[Imagekitio::Internal::Type::Unknown]
+
+    # @!attribute max_retries
+    #   Maximum number of retries to attempt after a failed initial request.
+    #
+    #   @return [Integer, nil]
+    optional :max_retries, Integer
+
+    # @!attribute timeout
+    #   Request timeout in seconds.
+    #
+    #   @return [Float, nil]
+    optional :timeout, Float
+
+    # @!method initialize(values = {})
+    #   Returns a new instance of RequestOptions.
+    #
+    #   @param values [Hash{Symbol=>Object}]
+
+    define_sorbet_constant!(:OrHash) do
+      T.type_alias { T.any(Imagekitio::RequestOptions, Imagekitio::Internal::AnyHash) }
+    end
+  end
+end