imagekitio 4.0.0 → 4.1.1

data/lib/imagekitio/models/transformation.rb

@@ -104,6 +104,12 @@ module Imagekitio
       #
       #   - A solid color: e.g., `red`, `F3F3F3`, `AAFF0010`. See
       #     [Solid color background](https://imagekit.io/docs/effects-and-enhancements#solid-color-background).
+      #   - Dominant color: `dominant` extracts the dominant color from the image. See
+      #     [Dominant color background](https://imagekit.io/docs/effects-and-enhancements#dominant-color-background).
+      #   - Gradient: `gradient_dominant` or `gradient_dominant_2` creates a gradient
+      #     using the dominant colors. Optionally specify palette size (2 or 4), e.g.,
+      #     `gradient_dominant_4`. See
+      #     [Gradient background](https://imagekit.io/docs/effects-and-enhancements#gradient-background).
       #   - A blurred background: e.g., `blurred`, `blurred_25_N15`, etc. See
       #     [Blurred background](https://imagekit.io/docs/effects-and-enhancements#blurred-background).
       #   - Expand the image boundaries using generative fill: `genfill`. Not supported
@@ -139,6 +145,19 @@ module Imagekitio
       #   @return [Boolean, nil]
       optional :color_profile, Imagekitio::Internal::Type::Boolean, api_name: :colorProfile
 
+      # @!attribute color_replace
+      #   Replaces colors in the image. Supports three formats:
+      #
+      #   - `toColor` - Replace dominant color with the specified color.
+      #   - `toColor_tolerance` - Replace dominant color with specified tolerance (0-100).
+      #   - `toColor_tolerance_fromColor` - Replace a specific color with another within
+      #     tolerance range. Colors can be hex codes (e.g., `FF0022`) or names (e.g.,
+      #     `red`, `blue`). See
+      #     [Color replacement](https://imagekit.io/docs/effects-and-enhancements#color-replace---cr).
+      #
+      #   @return [String, nil]
+      optional :color_replace, String, api_name: :colorReplace
+
       # @!attribute contrast_stretch
       #   Automatically enhances the contrast of an image (contrast stretch). See
       #   [Contrast Stretch](https://imagekit.io/docs/effects-and-enhancements#contrast-stretch---e-contrast).
@@ -170,10 +189,25 @@ module Imagekitio
       #   @return [String, nil]
       optional :default_image, String, api_name: :defaultImage
 
+      # @!attribute distort
+      #   Distorts the shape of an image. Supports two modes:
+      #
+      #   - Perspective distortion: `p-x1_y1_x2_y2_x3_y3_x4_y4` changes the position of
+      #     the four corners starting clockwise from top-left.
+      #   - Arc distortion: `a-degrees` curves the image upwards (positive values) or
+      #     downwards (negative values). See
+      #     [Distort effect](https://imagekit.io/docs/effects-and-enhancements#distort---e-distort).
+      #
+      #   @return [String, nil]
+      optional :distort, String
+
       # @!attribute dpr
       #   Accepts values between 0.1 and 5, or `auto` for automatic device pixel ratio
-      #   (DPR) calculation. See
-      #   [DPR](https://imagekit.io/docs/image-resize-and-crop#dpr---dpr).
+      #   (DPR) calculation. Also accepts arithmetic expressions.
+      #
+      #   - Learn about
+      #     [Arithmetic expressions](https://imagekit.io/docs/arithmetic-expressions-in-transformations).
+      #   - See [DPR](https://imagekit.io/docs/image-resize-and-crop#dpr---dpr).
       #
       #   @return [Float, nil]
       optional :dpr, Float
@@ -330,11 +364,16 @@ module Imagekitio
       optional :quality, Float
 
       # @!attribute radius
-      #   Specifies the corner radius for rounded corners (e.g., 20) or `max` for circular
-      #   or oval shape. See
-      #   [Radius](https://imagekit.io/docs/effects-and-enhancements#radius---r).
+      #   Specifies the corner radius for rounded corners.
+      #
+      #   - Single value (positive integer): Applied to all corners (e.g., `20`).
+      #   - `max`: Creates a circular or oval shape.
+      #   - Per-corner array: Provide four underscore-separated values representing
+      #     top-left, top-right, bottom-right, and bottom-left corners respectively (e.g.,
+      #     `10_20_30_40`). See
+      #     [Radius](https://imagekit.io/docs/effects-and-enhancements#radius---r).
       #
-      #   @return [Float, Symbol, :max, nil]
+      #   @return [Float, Symbol, :max, String, nil]
       optional :radius, union: -> { Imagekitio::Transformation::Radius }
 
       # @!attribute raw
@@ -459,7 +498,7 @@ module Imagekitio
       #   @return [Float, nil]
       optional :zoom, Float
 
-      # @!method initialize(ai_change_background: nil, ai_drop_shadow: nil, ai_edit: nil, ai_remove_background: nil, ai_remove_background_external: nil, ai_retouch: nil, ai_upscale: nil, ai_variation: nil, aspect_ratio: nil, audio_codec: nil, background: nil, blur: nil, border: nil, color_profile: nil, contrast_stretch: nil, crop: nil, crop_mode: nil, default_image: nil, dpr: nil, duration: nil, end_offset: nil, flip: nil, focus: nil, format_: nil, gradient: nil, grayscale: nil, height: nil, lossless: nil, metadata: nil, named: nil, opacity: nil, original: nil, overlay: nil, page: nil, progressive: nil, quality: nil, radius: nil, raw: nil, rotation: nil, shadow: nil, sharpen: nil, start_offset: nil, streaming_resolutions: nil, trim: nil, unsharp_mask: nil, video_codec: nil, width: nil, x: nil, x_center: nil, y_: nil, y_center: nil, zoom: nil)
+      # @!method initialize(ai_change_background: nil, ai_drop_shadow: nil, ai_edit: nil, ai_remove_background: nil, ai_remove_background_external: nil, ai_retouch: nil, ai_upscale: nil, ai_variation: nil, aspect_ratio: nil, audio_codec: nil, background: nil, blur: nil, border: nil, color_profile: nil, color_replace: nil, contrast_stretch: nil, crop: nil, crop_mode: nil, default_image: nil, distort: nil, dpr: nil, duration: nil, end_offset: nil, flip: nil, focus: nil, format_: nil, gradient: nil, grayscale: nil, height: nil, lossless: nil, metadata: nil, named: nil, opacity: nil, original: nil, overlay: nil, page: nil, progressive: nil, quality: nil, radius: nil, raw: nil, rotation: nil, shadow: nil, sharpen: nil, start_offset: nil, streaming_resolutions: nil, trim: nil, unsharp_mask: nil, video_codec: nil, width: nil, x: nil, x_center: nil, y_: nil, y_center: nil, zoom: nil)
       #   Some parameter documentations has been truncated, see
       #   {Imagekitio::Models::Transformation} for more details.
       #
@@ -498,6 +537,8 @@ module Imagekitio
       #
       #   @param color_profile [Boolean] Indicates whether the output image should retain the original color profile.
       #
+      #   @param color_replace [String] Replaces colors in the image. Supports three formats:
+      #
       #   @param contrast_stretch [Boolean, Imagekitio::Models::Transformation::ContrastStretch] Automatically enhances the contrast of an image (contrast stretch).
       #
       #   @param crop [Symbol, Imagekitio::Models::Transformation::Crop] Crop modes for image resizing. See [Crop modes & focus](https://imagekit.io/docs
@@ -506,6 +547,8 @@ module Imagekitio
       #
       #   @param default_image [String] Specifies a fallback image if the resource is not found, e.g., a URL or file pat
       #
+      #   @param distort [String] Distorts the shape of an image. Supports two modes:
+      #
       #   @param dpr [Float] Accepts values between 0.1 and 5, or `auto` for automatic device pixel ratio (DP
       #
       #   @param duration [Float, String] Specifies the duration (in seconds) for trimming videos, e.g., `5` or `10.5`.
@@ -542,7 +585,7 @@ module Imagekitio
       #
       #   @param quality [Float] Specifies the quality of the output image for lossy formats such as JPEG, WebP,
       #
-      #   @param radius [Float, Symbol, :max] Specifies the corner radius for rounded corners (e.g., 20) or `max` for circular
+      #   @param radius [Float, Symbol, :max, String] Specifies the corner radius for rounded corners.
       #
       #   @param raw [String] Pass any transformation not directly supported by the SDK.
       #
@@ -886,9 +929,14 @@ module Imagekitio
         #   @return [Array(Float, String)]
       end
 
-      # Specifies the corner radius for rounded corners (e.g., 20) or `max` for circular
-      # or oval shape. See
-      # [Radius](https://imagekit.io/docs/effects-and-enhancements#radius---r).
+      # Specifies the corner radius for rounded corners.
+      #
+      # - Single value (positive integer): Applied to all corners (e.g., `20`).
+      # - `max`: Creates a circular or oval shape.
+      # - Per-corner array: Provide four underscore-separated values representing
+      #   top-left, top-right, bottom-right, and bottom-left corners respectively (e.g.,
+      #   `10_20_30_40`). See
+      #   [Radius](https://imagekit.io/docs/effects-and-enhancements#radius---r).
       #
       # @see Imagekitio::Models::Transformation#radius
       module Radius
@@ -898,8 +946,10 @@ module Imagekitio
 
         variant const: :max
 
+        variant String
+
         # @!method self.variants
-        #   @return [Array(Float, Symbol, :max)]
+        #   @return [Array(Float, Symbol, :max, String)]
       end
 
       # Specifies the rotation angle in degrees. Positive values rotate the image

data/lib/imagekitio/models/unsafe_unwrap_webhook_event.rb

@@ -8,6 +8,8 @@ module Imagekitio
     module UnsafeUnwrapWebhookEvent
       extend Imagekitio::Internal::Type::Union
 
+      discriminator :type
+
       # Triggered when a new video transformation request is accepted for processing. This event confirms that ImageKit has received and queued your transformation request. Use this for debugging and tracking transformation lifecycle.
       variant -> { Imagekitio::VideoTransformationAcceptedEvent }
 

data/lib/imagekitio/models/unwrap_webhook_event.rb

@@ -8,6 +8,8 @@ module Imagekitio
     module UnwrapWebhookEvent
       extend Imagekitio::Internal::Type::Union
 
+      discriminator :type
+
       # Triggered when a new video transformation request is accepted for processing. This event confirms that ImageKit has received and queued your transformation request. Use this for debugging and tracking transformation lifecycle.
       variant -> { Imagekitio::VideoTransformationAcceptedEvent }
 

data/lib/imagekitio/models/update_file_request.rb

@@ -38,7 +38,7 @@ module Imagekitio
         #   Array of extensions to be applied to the asset. Each extension can be configured
         #   with specific parameters based on the extension type.
         #
-        #   @return [Array<Imagekitio::Models::ExtensionItem::RemoveBg, Imagekitio::Models::ExtensionItem::AIAutoDescription, Imagekitio::Models::ExtensionItem::AutoTaggingExtension>, nil]
+        #   @return [Array<Imagekitio::Models::ExtensionItem::RemoveBg, Imagekitio::Models::ExtensionItem::AIAutoDescription, Imagekitio::Models::ExtensionItem::AITasks, Imagekitio::Models::ExtensionItem::SavedExtension, Imagekitio::Models::ExtensionItem::AutoTaggingExtension>, nil]
         optional :extensions, -> { Imagekitio::Internal::Type::ArrayOf[union: Imagekitio::ExtensionItem] }
 
         # @!attribute remove_ai_tags
@@ -82,7 +82,7 @@ module Imagekitio
         #
         #   @param description [String] Optional text to describe the contents of the file.
         #
-        #   @param extensions [Array<Imagekitio::Models::ExtensionItem::RemoveBg, Imagekitio::Models::ExtensionItem::AIAutoDescription, Imagekitio::Models::ExtensionItem::AutoTaggingExtension>] Array of extensions to be applied to the asset. Each extension can be configured
+        #   @param extensions [Array<Imagekitio::Models::ExtensionItem::RemoveBg, Imagekitio::Models::ExtensionItem::AIAutoDescription, Imagekitio::Models::ExtensionItem::AITasks, Imagekitio::Models::ExtensionItem::SavedExtension, Imagekitio::Models::ExtensionItem::AutoTaggingExtension>] Array of extensions to be applied to the asset. Each extension can be configured
         #
         #   @param remove_ai_tags [Array<String>, Symbol, :all] An array of AITags associated with the file that you want to remove, e.g. `["car
         #

data/lib/imagekitio/models/upload_pre_transform_success_event.rb

@@ -339,6 +339,13 @@ module Imagekitio
                    },
                    api_name: :"ai-auto-description"
 
+          # @!attribute ai_tasks
+          #
+          #   @return [Symbol, Imagekitio::Models::UploadPreTransformSuccessEvent::Data::ExtensionStatus::AITasks, nil]
+          optional :ai_tasks,
+                   enum: -> { Imagekitio::UploadPreTransformSuccessEvent::Data::ExtensionStatus::AITasks },
+                   api_name: :"ai-tasks"
+
           # @!attribute aws_auto_tagging
           #
           #   @return [Symbol, Imagekitio::Models::UploadPreTransformSuccessEvent::Data::ExtensionStatus::AwsAutoTagging, nil]
@@ -364,7 +371,7 @@ module Imagekitio
                    enum: -> { Imagekitio::UploadPreTransformSuccessEvent::Data::ExtensionStatus::RemoveBg },
                    api_name: :"remove-bg"
 
-          # @!method initialize(ai_auto_description: nil, aws_auto_tagging: nil, google_auto_tagging: nil, remove_bg: nil)
+          # @!method initialize(ai_auto_description: nil, ai_tasks: nil, aws_auto_tagging: nil, google_auto_tagging: nil, remove_bg: nil)
           #   Extension names with their processing status at the time of completion of the
           #   request. It could have one of the following status values:
           #
@@ -376,6 +383,7 @@ module Imagekitio
           #   If no extension was requested, then this parameter is not returned.
           #
           #   @param ai_auto_description [Symbol, Imagekitio::Models::UploadPreTransformSuccessEvent::Data::ExtensionStatus::AIAutoDescription]
+          #   @param ai_tasks [Symbol, Imagekitio::Models::UploadPreTransformSuccessEvent::Data::ExtensionStatus::AITasks]
           #   @param aws_auto_tagging [Symbol, Imagekitio::Models::UploadPreTransformSuccessEvent::Data::ExtensionStatus::AwsAutoTagging]
           #   @param google_auto_tagging [Symbol, Imagekitio::Models::UploadPreTransformSuccessEvent::Data::ExtensionStatus::GoogleAutoTagging]
           #   @param remove_bg [Symbol, Imagekitio::Models::UploadPreTransformSuccessEvent::Data::ExtensionStatus::RemoveBg]
@@ -392,6 +400,18 @@ module Imagekitio
             #   @return [Array<Symbol>]
           end
 
+          # @see Imagekitio::Models::UploadPreTransformSuccessEvent::Data::ExtensionStatus#ai_tasks
+          module AITasks
+            extend Imagekitio::Internal::Type::Enum
+
+            SUCCESS = :success
+            PENDING = :pending
+            FAILED = :failed
+
+            # @!method self.values
+            #   @return [Array<Symbol>]
+          end
+
           # @see Imagekitio::Models::UploadPreTransformSuccessEvent::Data::ExtensionStatus#aws_auto_tagging
           module AwsAutoTagging
             extend Imagekitio::Internal::Type::Enum

data/lib/imagekitio/models/video_overlay.rb

@@ -21,6 +21,12 @@ module Imagekitio
       #   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.
+      #
       #   @return [Symbol, Imagekitio::Models::VideoOverlay::Encoding, nil]
       optional :encoding, enum: -> { Imagekitio::VideoOverlay::Encoding }
 
@@ -49,6 +55,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/lib/imagekitio/models.rb

@@ -61,6 +61,8 @@ module Imagekitio
 
   CustomMetadataFieldUpdateParams = Imagekitio::Models::CustomMetadataFieldUpdateParams
 
+  ExtensionConfig = Imagekitio::Models::ExtensionConfig
+
   ExtensionItem = Imagekitio::Models::ExtensionItem
 
   # @type [Imagekitio::Internal::Type::Converter]
@@ -112,6 +114,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 = Imagekitio::Models::SolidColorOverlayTransformation

data/lib/imagekitio/resources/beta/v2/files.rb

@@ -52,7 +52,7 @@ module Imagekitio
           #
           # @param description [String] Optional text to describe the contents of the file.
           #
-          # @param extensions [Array<Imagekitio::Models::ExtensionItem::RemoveBg, Imagekitio::Models::ExtensionItem::AIAutoDescription, Imagekitio::Models::ExtensionItem::AutoTaggingExtension>] Array of extensions to be applied to the asset. Each extension can be configured
+          # @param extensions [Array<Imagekitio::Models::ExtensionItem::RemoveBg, Imagekitio::Models::ExtensionItem::AIAutoDescription, Imagekitio::Models::ExtensionItem::AITasks, Imagekitio::Models::ExtensionItem::SavedExtension, Imagekitio::Models::ExtensionItem::AutoTaggingExtension>] Array of extensions to be applied to the asset. Each extension can be configured
           #
           # @param folder [String] The folder path in which the image has to be uploaded. If the folder(s) didn't e
           #

data/lib/imagekitio/resources/files/metadata.rb

@@ -50,7 +50,7 @@ module Imagekitio
           parsed, options = Imagekitio::Files::MetadataGetFromURLParams.dump_request(params)
           @client.request(
             method: :get,
-            path: "v1/files/metadata",
+            path: "v1/metadata",
             query: parsed,
             model: Imagekitio::Metadata,
             options: options

data/lib/imagekitio/resources/files.rb

@@ -242,7 +242,7 @@ module Imagekitio
       #
       # @param expire [Integer] The time until your signature is valid. It must be a [Unix time](https://en.wiki
       #
-      # @param extensions [Array<Imagekitio::Models::ExtensionItem::RemoveBg, Imagekitio::Models::ExtensionItem::AIAutoDescription, Imagekitio::Models::ExtensionItem::AutoTaggingExtension>] Array of extensions to be applied to the asset. Each extension can be configured
+      # @param extensions [Array<Imagekitio::Models::ExtensionItem::RemoveBg, Imagekitio::Models::ExtensionItem::AIAutoDescription, Imagekitio::Models::ExtensionItem::AITasks, Imagekitio::Models::ExtensionItem::SavedExtension, Imagekitio::Models::ExtensionItem::AutoTaggingExtension>] Array of extensions to be applied to the asset. Each extension can be configured
       #
       # @param folder [String] The folder path in which the image has to be uploaded. If the folder(s) didn't e
       #

data/lib/imagekitio/resources/saved_extensions.rb

@@ -0,0 +1,146 @@
+# frozen_string_literal: true
+
+module Imagekitio
+  module Resources
+    class SavedExtensions
+      # Some parameter documentations has been truncated, see
+      # {Imagekitio::Models::SavedExtensionCreateParams} for more details.
+      #
+      # 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.
+      #
+      # @overload create(config:, description:, name:, request_options: {})
+      #
+      # @param config [Imagekitio::Models::ExtensionConfig::RemoveBg, Imagekitio::Models::ExtensionConfig::AIAutoDescription, Imagekitio::Models::ExtensionConfig::AITasks, Imagekitio::Models::ExtensionConfig::AutoTaggingExtension] Configuration object for an extension (base extensions only, not saved extension
+      #
+      # @param description [String] Description of what the saved extension does.
+      #
+      # @param name [String] Name of the saved extension.
+      #
+      # @param request_options [Imagekitio::RequestOptions, Hash{Symbol=>Object}, nil]
+      #
+      # @return [Imagekitio::Models::SavedExtension]
+      #
+      # @see Imagekitio::Models::SavedExtensionCreateParams
+      def create(params)
+        parsed, options = Imagekitio::SavedExtensionCreateParams.dump_request(params)
+        @client.request(
+          method: :post,
+          path: "v1/saved-extensions",
+          body: parsed,
+          model: Imagekitio::SavedExtension,
+          options: options
+        )
+      end
+
+      # Some parameter documentations has been truncated, see
+      # {Imagekitio::Models::SavedExtensionUpdateParams} for more details.
+      #
+      # This API updates an existing saved extension. You can update the name,
+      # description, or config.
+      #
+      # @overload update(id, config: nil, description: nil, name: nil, request_options: {})
+      #
+      # @param id [String] The unique ID of the saved extension.
+      #
+      # @param config [Imagekitio::Models::ExtensionConfig::RemoveBg, Imagekitio::Models::ExtensionConfig::AIAutoDescription, Imagekitio::Models::ExtensionConfig::AITasks, Imagekitio::Models::ExtensionConfig::AutoTaggingExtension] Configuration object for an extension (base extensions only, not saved extension
+      #
+      # @param description [String] Updated description of the saved extension.
+      #
+      # @param name [String] Updated name of the saved extension.
+      #
+      # @param request_options [Imagekitio::RequestOptions, Hash{Symbol=>Object}, nil]
+      #
+      # @return [Imagekitio::Models::SavedExtension]
+      #
+      # @see Imagekitio::Models::SavedExtensionUpdateParams
+      def update(id, params = {})
+        parsed, options = Imagekitio::SavedExtensionUpdateParams.dump_request(params)
+        @client.request(
+          method: :patch,
+          path: ["v1/saved-extensions/%1$s", id],
+          body: parsed,
+          model: Imagekitio::SavedExtension,
+          options: 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.
+      #
+      # @overload list(request_options: {})
+      #
+      # @param request_options [Imagekitio::RequestOptions, Hash{Symbol=>Object}, nil]
+      #
+      # @return [Array<Imagekitio::Models::SavedExtension>]
+      #
+      # @see Imagekitio::Models::SavedExtensionListParams
+      def list(params = {})
+        @client.request(
+          method: :get,
+          path: "v1/saved-extensions",
+          model: Imagekitio::Internal::Type::ArrayOf[Imagekitio::SavedExtension],
+          options: params[:request_options]
+        )
+      end
+
+      # Some parameter documentations has been truncated, see
+      # {Imagekitio::Models::SavedExtensionDeleteParams} for more details.
+      #
+      # This API deletes a saved extension permanently.
+      #
+      # @overload delete(id, request_options: {})
+      #
+      # @param id [String] The unique ID of the saved extension.
+      #
+      # @param request_options [Imagekitio::RequestOptions, Hash{Symbol=>Object}, nil]
+      #
+      # @return [nil]
+      #
+      # @see Imagekitio::Models::SavedExtensionDeleteParams
+      def delete(id, params = {})
+        @client.request(
+          method: :delete,
+          path: ["v1/saved-extensions/%1$s", id],
+          model: NilClass,
+          options: params[:request_options]
+        )
+      end
+
+      # Some parameter documentations has been truncated, see
+      # {Imagekitio::Models::SavedExtensionGetParams} for more details.
+      #
+      # This API returns details of a specific saved extension by ID.
+      #
+      # @overload get(id, request_options: {})
+      #
+      # @param id [String] The unique ID of the saved extension.
+      #
+      # @param request_options [Imagekitio::RequestOptions, Hash{Symbol=>Object}, nil]
+      #
+      # @return [Imagekitio::Models::SavedExtension]
+      #
+      # @see Imagekitio::Models::SavedExtensionGetParams
+      def get(id, params = {})
+        @client.request(
+          method: :get,
+          path: ["v1/saved-extensions/%1$s", id],
+          model: Imagekitio::SavedExtension,
+          options: params[:request_options]
+        )
+      end
+
+      # @api private
+      #
+      # @param client [Imagekitio::Client]
+      def initialize(client:)
+        @client = client
+      end
+    end
+  end
+end

data/lib/imagekitio/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Imagekitio
-  VERSION = "4.0.0"
+  VERSION = "4.1.1"
 end

data/lib/imagekitio.rb

@@ -3,12 +3,14 @@
 # Standard libraries.
 # rubocop:disable Lint/RedundantRequireStatement
 require "English"
+require "base64"
 require "cgi"
 require "date"
 require "erb"
 require "etc"
 require "json"
 require "net/http"
+require "openssl"
 require "pathname"
 require "rbconfig"
 require "securerandom"
@@ -16,7 +18,6 @@ require "set"
 require "stringio"
 require "time"
 require "uri"
-require "base64"
 # rubocop:enable Lint/RedundantRequireStatement
 
 # We already ship the preferred sorbet manifests in the package itself.
@@ -89,6 +90,7 @@ require_relative "imagekitio/models/custom_metadata_field_delete_response"
 require_relative "imagekitio/models/custom_metadata_field_list_params"
 require_relative "imagekitio/models/custom_metadata_field_list_response"
 require_relative "imagekitio/models/custom_metadata_field_update_params"
+require_relative "imagekitio/models/extension_config"
 require_relative "imagekitio/models/extensions"
 require_relative "imagekitio/models/file_copy_params"
 require_relative "imagekitio/models/file_copy_response"
@@ -138,6 +140,13 @@ require_relative "imagekitio/models/overlay"
 require_relative "imagekitio/models/overlay_position"
 require_relative "imagekitio/models/overlay_timing"
 require_relative "imagekitio/models/responsive_image_attributes"
+require_relative "imagekitio/models/saved_extension"
+require_relative "imagekitio/models/saved_extension_create_params"
+require_relative "imagekitio/models/saved_extension_delete_params"
+require_relative "imagekitio/models/saved_extension_get_params"
+require_relative "imagekitio/models/saved_extension_list_params"
+require_relative "imagekitio/models/saved_extension_list_response"
+require_relative "imagekitio/models/saved_extension_update_params"
 require_relative "imagekitio/models/solid_color_overlay"
 require_relative "imagekitio/models/solid_color_overlay_transformation"
 require_relative "imagekitio/models/streaming_resolution"
@@ -177,5 +186,6 @@ require_relative "imagekitio/resources/files/metadata"
 require_relative "imagekitio/resources/files/versions"
 require_relative "imagekitio/resources/folders"
 require_relative "imagekitio/resources/folders/job"
+require_relative "imagekitio/resources/saved_extensions"
 require_relative "imagekitio/resources/webhooks"
 require_relative "imagekitio/helpers/helper"

data/manifest.yaml

@@ -1,11 +1,13 @@
 dependencies:
   - English
+  - base64
   - cgi
   - date
   - erb
   - etc
   - json
   - net/http
+  - openssl
   - pathname
   - rbconfig
   - securerandom

data/rbi/imagekitio/client.rbi

@@ -26,6 +26,9 @@ module Imagekitio
     sig { returns(Imagekitio::Resources::Files) }
     attr_reader :files
 
+    sig { returns(Imagekitio::Resources::SavedExtensions) }
+    attr_reader :saved_extensions
+
     sig { returns(Imagekitio::Resources::Assets) }
     attr_reader :assets
 

data/rbi/imagekitio/internal/transport/base_client.rbi

@@ -178,6 +178,11 @@ module Imagekitio
         private def auth_headers
         end
 
+        # @api private
+        sig { returns(String) }
+        private def user_agent
+        end
+
         # @api private
         sig { returns(String) }
         private def generate_idempotency_key

data/rbi/imagekitio/internal/transport/pooled_net_requester.rbi

@@ -26,8 +26,12 @@ module Imagekitio
 
         class << self
           # @api private
-          sig { params(url: URI::Generic).returns(Net::HTTP) }
-          def connect(url)
+          sig do
+            params(cert_store: OpenSSL::X509::Store, url: URI::Generic).returns(
+              Net::HTTP
+            )
+          end
+          def connect(cert_store:, url:)
           end
 
           # @api private

data/rbi/imagekitio/internal/type/base_model.rbi

@@ -31,7 +31,7 @@ module Imagekitio
           #
           # Assumes superclass fields are totally defined before fields are accessed /
           # defined on subclasses.
-          sig { params(child: T.self_type).void }
+          sig { params(child: Imagekitio::Internal::Type::BaseModel).void }
           def inherited(child)
           end
 
@@ -276,9 +276,13 @@ module Imagekitio
 
         # Create a new instance of a model.
         sig do
-          params(data: T.any(T::Hash[Symbol, T.anything], T.self_type)).returns(
-            T.attached_class
-          )
+          params(
+            data:
+              T.any(
+                T::Hash[Symbol, T.anything],
+                Imagekitio::Internal::Type::BaseModel
+              )
+          ).returns(T.attached_class)
         end
         def self.new(data = {})
         end