imagekitio 4.0.0 → 4.1.1

data/rbi/imagekitio/models/upload_pre_transform_success_event.rbi

@@ -583,6 +583,23 @@ module Imagekitio
           end
           attr_writer :ai_auto_description
 
+          sig do
+            returns(
+              T.nilable(
+                Imagekitio::UploadPreTransformSuccessEvent::Data::ExtensionStatus::AITasks::TaggedSymbol
+              )
+            )
+          end
+          attr_reader :ai_tasks
+
+          sig do
+            params(
+              ai_tasks:
+                Imagekitio::UploadPreTransformSuccessEvent::Data::ExtensionStatus::AITasks::OrSymbol
+            ).void
+          end
+          attr_writer :ai_tasks
+
           sig do
             returns(
               T.nilable(
@@ -647,6 +664,8 @@ module Imagekitio
             params(
               ai_auto_description:
                 Imagekitio::UploadPreTransformSuccessEvent::Data::ExtensionStatus::AIAutoDescription::OrSymbol,
+              ai_tasks:
+                Imagekitio::UploadPreTransformSuccessEvent::Data::ExtensionStatus::AITasks::OrSymbol,
               aws_auto_tagging:
                 Imagekitio::UploadPreTransformSuccessEvent::Data::ExtensionStatus::AwsAutoTagging::OrSymbol,
               google_auto_tagging:
@@ -657,6 +676,7 @@ module Imagekitio
           end
           def self.new(
             ai_auto_description: nil,
+            ai_tasks: nil,
             aws_auto_tagging: nil,
             google_auto_tagging: nil,
             remove_bg: nil
@@ -668,6 +688,8 @@ module Imagekitio
               {
                 ai_auto_description:
                   Imagekitio::UploadPreTransformSuccessEvent::Data::ExtensionStatus::AIAutoDescription::TaggedSymbol,
+                ai_tasks:
+                  Imagekitio::UploadPreTransformSuccessEvent::Data::ExtensionStatus::AITasks::TaggedSymbol,
                 aws_auto_tagging:
                   Imagekitio::UploadPreTransformSuccessEvent::Data::ExtensionStatus::AwsAutoTagging::TaggedSymbol,
                 google_auto_tagging:
@@ -719,6 +741,45 @@ module Imagekitio
             end
           end
 
+          module AITasks
+            extend Imagekitio::Internal::Type::Enum
+
+            TaggedSymbol =
+              T.type_alias do
+                T.all(
+                  Symbol,
+                  Imagekitio::UploadPreTransformSuccessEvent::Data::ExtensionStatus::AITasks
+                )
+              end
+            OrSymbol = T.type_alias { T.any(Symbol, String) }
+
+            SUCCESS =
+              T.let(
+                :success,
+                Imagekitio::UploadPreTransformSuccessEvent::Data::ExtensionStatus::AITasks::TaggedSymbol
+              )
+            PENDING =
+              T.let(
+                :pending,
+                Imagekitio::UploadPreTransformSuccessEvent::Data::ExtensionStatus::AITasks::TaggedSymbol
+              )
+            FAILED =
+              T.let(
+                :failed,
+                Imagekitio::UploadPreTransformSuccessEvent::Data::ExtensionStatus::AITasks::TaggedSymbol
+              )
+
+            sig do
+              override.returns(
+                T::Array[
+                  Imagekitio::UploadPreTransformSuccessEvent::Data::ExtensionStatus::AITasks::TaggedSymbol
+                ]
+              )
+            end
+            def self.values
+            end
+          end
+
           module AwsAutoTagging
             extend Imagekitio::Internal::Type::Enum
 

data/rbi/imagekitio/models/video_overlay.rbi

@@ -20,6 +20,12 @@ module Imagekitio
       # format automatically. To always use base64 encoding (`ie-{base64}`), set this
       # parameter to `base64`. To always use plain text (`i-{input}`), set it to
       # `plain`.
+      #
+      # Regardless of the encoding method:
+      #
+      # - Leading and trailing slashes are removed.
+      # - Remaining slashes within the path are replaced with `@@` when using plain
+      #   text.
       sig { returns(T.nilable(Imagekitio::VideoOverlay::Encoding::OrSymbol)) }
       attr_reader :encoding
 
@@ -53,6 +59,12 @@ module Imagekitio
         # format automatically. To always use base64 encoding (`ie-{base64}`), set this
         # parameter to `base64`. To always use plain text (`i-{input}`), set it to
         # `plain`.
+        #
+        # Regardless of the encoding method:
+        #
+        # - Leading and trailing slashes are removed.
+        # - Remaining slashes within the path are replaced with `@@` when using plain
+        #   text.
         encoding: nil,
         # Array of transformation to be applied to the overlay video. Except
         # `streamingResolutions`, all other video transformations are supported. See
@@ -80,6 +92,12 @@ module Imagekitio
       # format automatically. To always use base64 encoding (`ie-{base64}`), set this
       # parameter to `base64`. To always use plain text (`i-{input}`), set it to
       # `plain`.
+      #
+      # Regardless of the encoding method:
+      #
+      # - Leading and trailing slashes are removed.
+      # - Remaining slashes within the path are replaced with `@@` when using plain
+      #   text.
       module Encoding
         extend Imagekitio::Internal::Type::Enum
 

data/rbi/imagekitio/models.rbi

@@ -27,6 +27,8 @@ module Imagekitio
   CustomMetadataFieldUpdateParams =
     Imagekitio::Models::CustomMetadataFieldUpdateParams
 
+  ExtensionConfig = Imagekitio::Models::ExtensionConfig
+
   ExtensionItem = Imagekitio::Models::ExtensionItem
 
   Extensions =
@@ -78,6 +80,18 @@ module Imagekitio
 
   ResponsiveImageAttributes = Imagekitio::Models::ResponsiveImageAttributes
 
+  SavedExtension = Imagekitio::Models::SavedExtension
+
+  SavedExtensionCreateParams = Imagekitio::Models::SavedExtensionCreateParams
+
+  SavedExtensionDeleteParams = Imagekitio::Models::SavedExtensionDeleteParams
+
+  SavedExtensionGetParams = Imagekitio::Models::SavedExtensionGetParams
+
+  SavedExtensionListParams = Imagekitio::Models::SavedExtensionListParams
+
+  SavedExtensionUpdateParams = Imagekitio::Models::SavedExtensionUpdateParams
+
   SolidColorOverlay = Imagekitio::Models::SolidColorOverlay
 
   SolidColorOverlayTransformation =

data/rbi/imagekitio/resources/beta/v2/files.rbi

@@ -46,6 +46,8 @@ module Imagekitio
                   T.any(
                     Imagekitio::ExtensionItem::RemoveBg::OrHash,
                     Imagekitio::ExtensionItem::AIAutoDescription::OrHash,
+                    Imagekitio::ExtensionItem::AITasks::OrHash,
+                    Imagekitio::ExtensionItem::SavedExtension::OrHash,
                     Imagekitio::ExtensionItem::AutoTaggingExtension::OrHash
                   )
                 ],

data/rbi/imagekitio/resources/files.rbi

@@ -199,6 +199,8 @@ module Imagekitio
               T.any(
                 Imagekitio::ExtensionItem::RemoveBg::OrHash,
                 Imagekitio::ExtensionItem::AIAutoDescription::OrHash,
+                Imagekitio::ExtensionItem::AITasks::OrHash,
+                Imagekitio::ExtensionItem::SavedExtension::OrHash,
                 Imagekitio::ExtensionItem::AutoTaggingExtension::OrHash
               )
             ],

data/rbi/imagekitio/resources/saved_extensions.rbi

@@ -0,0 +1,114 @@
+# typed: strong
+
+module Imagekitio
+  module Resources
+    class SavedExtensions
+      # This API creates a new saved extension. Saved extensions allow you to save
+      # complex extension configurations (like AI tasks) and reuse them by referencing
+      # the ID in upload or update file APIs.
+      #
+      # **Saved extension limit** \
+      # You can create a maximum of 100 saved extensions per account.
+      sig do
+        params(
+          config:
+            T.any(
+              Imagekitio::ExtensionConfig::RemoveBg::OrHash,
+              Imagekitio::ExtensionConfig::AIAutoDescription::OrHash,
+              Imagekitio::ExtensionConfig::AITasks::OrHash,
+              Imagekitio::ExtensionConfig::AutoTaggingExtension::OrHash
+            ),
+          description: String,
+          name: String,
+          request_options: Imagekitio::RequestOptions::OrHash
+        ).returns(Imagekitio::SavedExtension)
+      end
+      def create(
+        # Configuration object for an extension (base extensions only, not saved extension
+        # references).
+        config:,
+        # Description of what the saved extension does.
+        description:,
+        # Name of the saved extension.
+        name:,
+        request_options: {}
+      )
+      end
+
+      # This API updates an existing saved extension. You can update the name,
+      # description, or config.
+      sig do
+        params(
+          id: String,
+          config:
+            T.any(
+              Imagekitio::ExtensionConfig::RemoveBg::OrHash,
+              Imagekitio::ExtensionConfig::AIAutoDescription::OrHash,
+              Imagekitio::ExtensionConfig::AITasks::OrHash,
+              Imagekitio::ExtensionConfig::AutoTaggingExtension::OrHash
+            ),
+          description: String,
+          name: String,
+          request_options: Imagekitio::RequestOptions::OrHash
+        ).returns(Imagekitio::SavedExtension)
+      end
+      def update(
+        # The unique ID of the saved extension.
+        id,
+        # Configuration object for an extension (base extensions only, not saved extension
+        # references).
+        config: nil,
+        # Updated description of the saved extension.
+        description: nil,
+        # Updated name of the saved extension.
+        name: nil,
+        request_options: {}
+      )
+      end
+
+      # This API returns an array of all saved extensions for your account. Saved
+      # extensions allow you to save complex extension configurations and reuse them by
+      # referencing them by ID in upload or update file APIs.
+      sig do
+        params(request_options: Imagekitio::RequestOptions::OrHash).returns(
+          T::Array[Imagekitio::SavedExtension]
+        )
+      end
+      def list(request_options: {})
+      end
+
+      # This API deletes a saved extension permanently.
+      sig do
+        params(
+          id: String,
+          request_options: Imagekitio::RequestOptions::OrHash
+        ).void
+      end
+      def delete(
+        # The unique ID of the saved extension.
+        id,
+        request_options: {}
+      )
+      end
+
+      # This API returns details of a specific saved extension by ID.
+      sig do
+        params(
+          id: String,
+          request_options: Imagekitio::RequestOptions::OrHash
+        ).returns(Imagekitio::SavedExtension)
+      end
+      def get(
+        # The unique ID of the saved extension.
+        id,
+        request_options: {}
+      )
+      end
+
+      # @api private
+      sig { params(client: Imagekitio::Client).returns(T.attached_class) }
+      def self.new(client:)
+      end
+    end
+  end
+end

data/sig/imagekitio/client.rbs

@@ -16,6 +16,8 @@ module Imagekitio
 
     attr_reader files: Imagekitio::Resources::Files
 
+    attr_reader saved_extensions: Imagekitio::Resources::SavedExtensions
+
     attr_reader assets: Imagekitio::Resources::Assets
 
     attr_reader cache: Imagekitio::Resources::Cache

data/sig/imagekitio/internal/transport/base_client.rbs

@@ -87,6 +87,8 @@ module Imagekitio
 
         private def auth_headers: -> ::Hash[String, String]
 
+        private def user_agent: -> String
+
         private def generate_idempotency_key: -> String
 
         private def build_request: (

data/sig/imagekitio/internal/transport/pooled_net_requester.rbs

@@ -17,7 +17,10 @@ module Imagekitio
 
         DEFAULT_MAX_CONNECTIONS: Integer
 
-        def self.connect: (URI::Generic url) -> top
+        def self.connect: (
+          cert_store: OpenSSL::X509::Store,
+          url: URI::Generic
+        ) -> top
 
         def self.calibrate_socket_timeout: (top conn, Float deadline) -> void
 

data/sig/imagekitio/models/base_overlay.rbs

@@ -2,11 +2,18 @@ module Imagekitio
   module Models
     type base_overlay =
       {
+        layer_mode: Imagekitio::Models::BaseOverlay::layer_mode,
         position: Imagekitio::OverlayPosition,
         timing: Imagekitio::OverlayTiming
       }
 
     class BaseOverlay < Imagekitio::Internal::Type::BaseModel
+      attr_reader layer_mode: Imagekitio::Models::BaseOverlay::layer_mode?
+
+      def layer_mode=: (
+        Imagekitio::Models::BaseOverlay::layer_mode
+      ) -> Imagekitio::Models::BaseOverlay::layer_mode
+
       attr_reader position: Imagekitio::OverlayPosition?
 
       def position=: (
@@ -18,14 +25,29 @@ module Imagekitio
       def timing=: (Imagekitio::OverlayTiming) -> Imagekitio::OverlayTiming
 
       def initialize: (
+        ?layer_mode: Imagekitio::Models::BaseOverlay::layer_mode,
         ?position: Imagekitio::OverlayPosition,
         ?timing: Imagekitio::OverlayTiming
       ) -> void
 
       def to_hash: -> {
+        layer_mode: Imagekitio::Models::BaseOverlay::layer_mode,
         position: Imagekitio::OverlayPosition,
         timing: Imagekitio::OverlayTiming
       }
+
+      type layer_mode = :multiply | :cutter | :cutout | :displace
+
+      module LayerMode
+        extend Imagekitio::Internal::Type::Enum
+
+        MULTIPLY: :multiply
+        CUTTER: :cutter
+        CUTOUT: :cutout
+        DISPLACE: :displace
+
+        def self?.values: -> ::Array[Imagekitio::Models::BaseOverlay::layer_mode]
+      end
     end
   end
 end

data/sig/imagekitio/models/beta/v2/file_upload_response.rbs

@@ -215,6 +215,7 @@ module Imagekitio
           type extension_status =
             {
               ai_auto_description: Imagekitio::Models::Beta::V2::FileUploadResponse::ExtensionStatus::ai_auto_description,
+              ai_tasks: Imagekitio::Models::Beta::V2::FileUploadResponse::ExtensionStatus::ai_tasks,
               aws_auto_tagging: Imagekitio::Models::Beta::V2::FileUploadResponse::ExtensionStatus::aws_auto_tagging,
               google_auto_tagging: Imagekitio::Models::Beta::V2::FileUploadResponse::ExtensionStatus::google_auto_tagging,
               remove_bg: Imagekitio::Models::Beta::V2::FileUploadResponse::ExtensionStatus::remove_bg
@@ -227,6 +228,12 @@ module Imagekitio
               Imagekitio::Models::Beta::V2::FileUploadResponse::ExtensionStatus::ai_auto_description
             ) -> Imagekitio::Models::Beta::V2::FileUploadResponse::ExtensionStatus::ai_auto_description
 
+            attr_reader ai_tasks: Imagekitio::Models::Beta::V2::FileUploadResponse::ExtensionStatus::ai_tasks?
+
+            def ai_tasks=: (
+              Imagekitio::Models::Beta::V2::FileUploadResponse::ExtensionStatus::ai_tasks
+            ) -> Imagekitio::Models::Beta::V2::FileUploadResponse::ExtensionStatus::ai_tasks
+
             attr_reader aws_auto_tagging: Imagekitio::Models::Beta::V2::FileUploadResponse::ExtensionStatus::aws_auto_tagging?
 
             def aws_auto_tagging=: (
@@ -247,6 +254,7 @@ module Imagekitio
 
             def initialize: (
               ?ai_auto_description: Imagekitio::Models::Beta::V2::FileUploadResponse::ExtensionStatus::ai_auto_description,
+              ?ai_tasks: Imagekitio::Models::Beta::V2::FileUploadResponse::ExtensionStatus::ai_tasks,
               ?aws_auto_tagging: Imagekitio::Models::Beta::V2::FileUploadResponse::ExtensionStatus::aws_auto_tagging,
               ?google_auto_tagging: Imagekitio::Models::Beta::V2::FileUploadResponse::ExtensionStatus::google_auto_tagging,
               ?remove_bg: Imagekitio::Models::Beta::V2::FileUploadResponse::ExtensionStatus::remove_bg
@@ -254,6 +262,7 @@ module Imagekitio
 
             def to_hash: -> {
               ai_auto_description: Imagekitio::Models::Beta::V2::FileUploadResponse::ExtensionStatus::ai_auto_description,
+              ai_tasks: Imagekitio::Models::Beta::V2::FileUploadResponse::ExtensionStatus::ai_tasks,
               aws_auto_tagging: Imagekitio::Models::Beta::V2::FileUploadResponse::ExtensionStatus::aws_auto_tagging,
               google_auto_tagging: Imagekitio::Models::Beta::V2::FileUploadResponse::ExtensionStatus::google_auto_tagging,
               remove_bg: Imagekitio::Models::Beta::V2::FileUploadResponse::ExtensionStatus::remove_bg
@@ -271,6 +280,18 @@ module Imagekitio
               def self?.values: -> ::Array[Imagekitio::Models::Beta::V2::FileUploadResponse::ExtensionStatus::ai_auto_description]
             end
 
+            type ai_tasks = :success | :pending | :failed
+
+            module AITasks
+              extend Imagekitio::Internal::Type::Enum
+
+              SUCCESS: :success
+              PENDING: :pending
+              FAILED: :failed
+
+              def self?.values: -> ::Array[Imagekitio::Models::Beta::V2::FileUploadResponse::ExtensionStatus::ai_tasks]
+            end
+
             type aws_auto_tagging = :success | :pending | :failed
 
             module AwsAutoTagging