imagekitio 4.9.0 → 4.10.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: e0425b66fb8987f249e1e4157d7fd10b1566c58991a8cb87e981f60a3538de16
-  data.tar.gz: df52e7f1f8d6cfafee7c2e214147a32f7f6cbb715255e6c9220ad8cffd015a11
+  metadata.gz: 3c30ed9b6589210d2b0d5c5cac947cdc09a678c5974b4751287991c9c17c3078
+  data.tar.gz: 49416c6585634a0925a298524cf57ec20043c2acd42b37b8de792a70f4d1f2b4
 SHA512:
-  metadata.gz: 29ac74104d1e46f88b0b641833da899ff84bc4c1da4d51b0136a61add69d21c21792a9ef968f10ef6adb7f55e7f6ea31c2048412d06c4b4b391b87e84f8dadce
-  data.tar.gz: d4909caff4e5459175ef690f70ccf9a28ec50967199a8b713a510e4314891c120b38b862788b06535b8855a95c8d2b924f13fcaaaba1aed47ce3fee532c681b1
+  metadata.gz: 2b7ffb1d472b479d128ae5eab7983c7ebdf24e7197dcaa7fa8a95c6015069fe08472b3f7e8378ae8071d442d66bd34884504a7c6388ec00facc9f4ef39b879cf
+  data.tar.gz: 889a5b70b8537fef0a4cce92d97be64c7467bcb58d1d9c35b8d03bb337a756423d207a1a70ae112cca591c007ce55bee1730c2704c21ba31e55c3c6b8802fa31

data/CHANGELOG.md

@@ -1,5 +1,12 @@
 # Changelog
 
+## [4.10.0](https://github.com/imagekit-developer/imagekit-ruby/compare/v4.9.0...v4.10.0) (2026-09-16)
+
+
+### Features
+
+* serialize density as dn in SDK URL builders ([7815ad6](https://github.com/imagekit-developer/imagekit-ruby/commit/7815ad6897fc4ed6bd943443a87aede62ed354d9))
+
 ## [4.9.0](https://github.com/imagekit-developer/imagekit-ruby/compare/v4.8.0...v4.9.0) (2026-08-15)
 
 

data/README.md

@@ -46,7 +46,7 @@ To use this gem, install via Bundler by adding the following to your application
 <!-- x-release-please-start-version -->
 
 ```ruby
-gem "imagekitio", "~> 4.9.0"
+gem "imagekitio", "~> 4.10.0"
 ```
 
 <!-- x-release-please-end -->

data/lib/imagekitio/helpers/transformation_utils.rb

@@ -93,6 +93,7 @@ module Imagekitio
       "color_profile" => "cp",
       "colorProfile" => "cp",
       "metadata" => "md",
+      "density" => "dn",
       "opacity" => "o",
       "trim" => "t",
       "zoom" => "z",

data/lib/imagekitio/models/asset_list_params.rb

@@ -131,6 +131,10 @@ module Imagekitio
         DESC_SIZE = :DESC_SIZE
         ASC_RELEVANCE = :ASC_RELEVANCE
         DESC_RELEVANCE = :DESC_RELEVANCE
+        ASC_DURATION = :ASC_DURATION
+        DESC_DURATION = :DESC_DURATION
+        ASC_ORIGINAL_CREATION_DATE = :ASC_ORIGINAL_CREATION_DATE
+        DESC_ORIGINAL_CREATION_DATE = :DESC_ORIGINAL_CREATION_DATE
 
         # @!method self.values
         #   @return [Array<Symbol>]

data/lib/imagekitio/models/custom_metadata_field.rb

@@ -39,7 +39,14 @@ module Imagekitio
       #   @return [String, nil]
       optional :description, String
 
-      # @!method initialize(id:, label:, name:, schema:, description: nil)
+      # @!attribute reserved
+      #   Present and set to `true` when the field is reserved. Omitted for regular
+      #   fields. Reserved fields cannot be deleted.
+      #
+      #   @return [Boolean, nil]
+      optional :reserved, Imagekitio::Internal::Type::Boolean
+
+      # @!method initialize(id:, label:, name:, schema:, description: nil, reserved: nil)
       #   Some parameter documentations has been truncated, see
       #   {Imagekitio::Models::CustomMetadataField} for more details.
       #
@@ -54,6 +61,8 @@ module Imagekitio
       #   @param schema [Imagekitio::Models::CustomMetadataField::Schema] An object that describes the rules for the custom metadata field value.
       #
       #   @param description [String] Optional description of the custom metadata field. Only present when a descripti
+      #
+      #   @param reserved [Boolean] Present and set to `true` when the field is reserved. Omitted for regular fields
 
       # @see Imagekitio::Models::CustomMetadataField#schema
       class Schema < Imagekitio::Internal::Type::BaseModel

data/lib/imagekitio/models/transformation.rb

@@ -201,6 +201,17 @@ module Imagekitio
       #   @return [String, nil]
       optional :default_image, String, api_name: :defaultImage
 
+      # @!attribute density
+      #   Sets the output image density in dots per inch (DPI). Accepts an integer from 1
+      #   to 1200 or an arithmetic expression using the `idn` variable, such as
+      #   `idn_mul_2`. For raster images, this updates density metadata without changing
+      #   dimensions. For vector images, it controls the DPI used during rasterization.
+      #   Cannot be used inside layers. See
+      #   [Density](https://imagekit.io/docs/image-optimization#density---dn).
+      #
+      #   @return [Integer, String, nil]
+      optional :density, union: -> { Imagekitio::Transformation::Density }
+
       # @!attribute distort
       #   Distorts the shape of an image. Supports two modes:
       #
@@ -510,7 +521,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, colorize: 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)
+      # @!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, colorize: nil, color_profile: nil, color_replace: nil, contrast_stretch: nil, crop: nil, crop_mode: nil, default_image: nil, density: 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.
       #
@@ -561,6 +572,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 density [Integer, String] Sets the output image density in dots per inch (DPI). Accepts an integer from 1
+      #
       #   @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
@@ -802,6 +815,25 @@ module Imagekitio
         #   @return [Array<Symbol>]
       end
 
+      # Sets the output image density in dots per inch (DPI). Accepts an integer from 1
+      # to 1200 or an arithmetic expression using the `idn` variable, such as
+      # `idn_mul_2`. For raster images, this updates density metadata without changing
+      # dimensions. For vector images, it controls the DPI used during rasterization.
+      # Cannot be used inside layers. See
+      # [Density](https://imagekit.io/docs/image-optimization#density---dn).
+      #
+      # @see Imagekitio::Models::Transformation#density
+      module Density
+        extend Imagekitio::Internal::Type::Union
+
+        variant Integer
+
+        variant String
+
+        # @!method self.variants
+        #   @return [Array(Integer, String)]
+      end
+
       # Specifies the duration (in seconds) for trimming videos, e.g., `5` or `10.5`.
       # Typically used with startOffset to indicate the length from the start offset.
       # Arithmetic expressions are supported. See

data/lib/imagekitio/version.rb

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

data/rbi/imagekitio/models/asset_list_params.rbi

@@ -236,6 +236,20 @@ module Imagekitio
             :DESC_RELEVANCE,
             Imagekitio::AssetListParams::Sort::TaggedSymbol
           )
+        ASC_DURATION =
+          T.let(:ASC_DURATION, Imagekitio::AssetListParams::Sort::TaggedSymbol)
+        DESC_DURATION =
+          T.let(:DESC_DURATION, Imagekitio::AssetListParams::Sort::TaggedSymbol)
+        ASC_ORIGINAL_CREATION_DATE =
+          T.let(
+            :ASC_ORIGINAL_CREATION_DATE,
+            Imagekitio::AssetListParams::Sort::TaggedSymbol
+          )
+        DESC_ORIGINAL_CREATION_DATE =
+          T.let(
+            :DESC_ORIGINAL_CREATION_DATE,
+            Imagekitio::AssetListParams::Sort::TaggedSymbol
+          )
 
         sig do
           override.returns(

data/rbi/imagekitio/models/custom_metadata_field.rbi

@@ -41,6 +41,14 @@ module Imagekitio
       sig { params(description: String).void }
       attr_writer :description
 
+      # Present and set to `true` when the field is reserved. Omitted for regular
+      # fields. Reserved fields cannot be deleted.
+      sig { returns(T.nilable(T::Boolean)) }
+      attr_reader :reserved
+
+      sig { params(reserved: T::Boolean).void }
+      attr_writer :reserved
+
       # Object containing details of a custom metadata field.
       sig do
         params(
@@ -48,7 +56,8 @@ module Imagekitio
           label: String,
           name: String,
           schema: Imagekitio::CustomMetadataField::Schema::OrHash,
-          description: String
+          description: String,
+          reserved: T::Boolean
         ).returns(T.attached_class)
       end
       def self.new(
@@ -66,7 +75,10 @@ module Imagekitio
         # Optional description of the custom metadata field. Only present when a
         # description has been set. Shown as a hint to the users while setting the field's
         # value on an asset in the media library UI.
-        description: nil
+        description: nil,
+        # Present and set to `true` when the field is reserved. Omitted for regular
+        # fields. Reserved fields cannot be deleted.
+        reserved: nil
       )
       end
 
@@ -77,7 +89,8 @@ module Imagekitio
             label: String,
             name: String,
             schema: Imagekitio::CustomMetadataField::Schema,
-            description: String
+            description: String,
+            reserved: T::Boolean
           }
         )
       end

data/rbi/imagekitio/models/transformation.rbi

@@ -277,6 +277,20 @@ module Imagekitio
       sig { params(default_image: String).void }
       attr_writer :default_image
 
+      # Sets the output image density in dots per inch (DPI). Accepts an integer from 1
+      # to 1200 or an arithmetic expression using the `idn` variable, such as
+      # `idn_mul_2`. For raster images, this updates density metadata without changing
+      # dimensions. For vector images, it controls the DPI used during rasterization.
+      # Cannot be used inside layers. See
+      # [Density](https://imagekit.io/docs/image-optimization#density---dn).
+      sig { returns(T.nilable(Imagekitio::Transformation::Density::Variants)) }
+      attr_reader :density
+
+      sig do
+        params(density: Imagekitio::Transformation::Density::Variants).void
+      end
+      attr_writer :density
+
       # Distorts the shape of an image. Supports two modes:
       #
       # - Perspective distortion: `p-x1_y1_x2_y2_x3_y3_x4_y4` changes the position of
@@ -685,6 +699,7 @@ module Imagekitio
           crop: Imagekitio::Transformation::Crop::OrSymbol,
           crop_mode: Imagekitio::Transformation::CropMode::OrSymbol,
           default_image: String,
+          density: Imagekitio::Transformation::Density::Variants,
           distort: String,
           dpr: Float,
           duration: Imagekitio::Transformation::Duration::Variants,
@@ -832,6 +847,13 @@ module Imagekitio
         # path. See
         # [Default image](https://imagekit.io/docs/image-transformation#default-image---di).
         default_image: nil,
+        # Sets the output image density in dots per inch (DPI). Accepts an integer from 1
+        # to 1200 or an arithmetic expression using the `idn` variable, such as
+        # `idn_mul_2`. For raster images, this updates density metadata without changing
+        # dimensions. For vector images, it controls the DPI used during rasterization.
+        # Cannot be used inside layers. See
+        # [Density](https://imagekit.io/docs/image-optimization#density---dn).
+        density: nil,
         # Distorts the shape of an image. Supports two modes:
         #
         # - Perspective distortion: `p-x1_y1_x2_y2_x3_y3_x4_y4` changes the position of
@@ -1028,6 +1050,7 @@ module Imagekitio
             crop: Imagekitio::Transformation::Crop::OrSymbol,
             crop_mode: Imagekitio::Transformation::CropMode::OrSymbol,
             default_image: String,
+            density: Imagekitio::Transformation::Density::Variants,
             distort: String,
             dpr: Float,
             duration: Imagekitio::Transformation::Duration::Variants,
@@ -1361,6 +1384,26 @@ module Imagekitio
         end
       end
 
+      # Sets the output image density in dots per inch (DPI). Accepts an integer from 1
+      # to 1200 or an arithmetic expression using the `idn` variable, such as
+      # `idn_mul_2`. For raster images, this updates density metadata without changing
+      # dimensions. For vector images, it controls the DPI used during rasterization.
+      # Cannot be used inside layers. See
+      # [Density](https://imagekit.io/docs/image-optimization#density---dn).
+      module Density
+        extend Imagekitio::Internal::Type::Union
+
+        Variants = T.type_alias { T.any(Integer, String) }
+
+        sig do
+          override.returns(
+            T::Array[Imagekitio::Transformation::Density::Variants]
+          )
+        end
+        def self.variants
+        end
+      end
+
       # Specifies the duration (in seconds) for trimming videos, e.g., `5` or `10.5`.
       # Typically used with startOffset to indicate the length from the start offset.
       # Arithmetic expressions are supported. See

data/sig/imagekitio/models/asset_list_params.rbs

@@ -99,6 +99,10 @@ module Imagekitio
         | :DESC_SIZE
         | :ASC_RELEVANCE
         | :DESC_RELEVANCE
+        | :ASC_DURATION
+        | :DESC_DURATION
+        | :ASC_ORIGINAL_CREATION_DATE
+        | :DESC_ORIGINAL_CREATION_DATE
 
       module Sort
         extend Imagekitio::Internal::Type::Enum
@@ -117,6 +121,10 @@ module Imagekitio
         DESC_SIZE: :DESC_SIZE
         ASC_RELEVANCE: :ASC_RELEVANCE
         DESC_RELEVANCE: :DESC_RELEVANCE
+        ASC_DURATION: :ASC_DURATION
+        DESC_DURATION: :DESC_DURATION
+        ASC_ORIGINAL_CREATION_DATE: :ASC_ORIGINAL_CREATION_DATE
+        DESC_ORIGINAL_CREATION_DATE: :DESC_ORIGINAL_CREATION_DATE
 
         def self?.values: -> ::Array[Imagekitio::Models::AssetListParams::sort]
       end

data/sig/imagekitio/models/custom_metadata_field.rbs

@@ -6,7 +6,8 @@ module Imagekitio
         label: String,
         name: String,
         schema: Imagekitio::CustomMetadataField::Schema,
-        description: String
+        description: String,
+        reserved: bool
       }
 
     class CustomMetadataField < Imagekitio::Internal::Type::BaseModel
@@ -22,12 +23,17 @@ module Imagekitio
 
       def description=: (String) -> String
 
+      attr_reader reserved: bool?
+
+      def reserved=: (bool) -> bool
+
       def initialize: (
         id: String,
         label: String,
         name: String,
         schema: Imagekitio::CustomMetadataField::Schema,
-        ?description: String
+        ?description: String,
+        ?reserved: bool
       ) -> void
 
       def to_hash: -> {
@@ -35,7 +41,8 @@ module Imagekitio
         label: String,
         name: String,
         schema: Imagekitio::CustomMetadataField::Schema,
-        description: String
+        description: String,
+        reserved: bool
       }
 
       type schema =

data/sig/imagekitio/models/transformation.rbs

@@ -22,6 +22,7 @@ module Imagekitio
         crop: Imagekitio::Models::Transformation::crop,
         crop_mode: Imagekitio::Models::Transformation::crop_mode,
         default_image: String,
+        density: Imagekitio::Models::Transformation::density,
         distort: String,
         dpr: Float,
         duration: Imagekitio::Models::Transformation::duration,
@@ -162,6 +163,12 @@ module Imagekitio
 
       def default_image=: (String) -> String
 
+      attr_reader density: Imagekitio::Models::Transformation::density?
+
+      def density=: (
+        Imagekitio::Models::Transformation::density
+      ) -> Imagekitio::Models::Transformation::density
+
       attr_reader distort: String?
 
       def distort=: (String) -> String
@@ -367,6 +374,7 @@ module Imagekitio
         ?crop: Imagekitio::Models::Transformation::crop,
         ?crop_mode: Imagekitio::Models::Transformation::crop_mode,
         ?default_image: String,
+        ?density: Imagekitio::Models::Transformation::density,
         ?distort: String,
         ?dpr: Float,
         ?duration: Imagekitio::Models::Transformation::duration,
@@ -425,6 +433,7 @@ module Imagekitio
         crop: Imagekitio::Models::Transformation::crop,
         crop_mode: Imagekitio::Models::Transformation::crop_mode,
         default_image: String,
+        density: Imagekitio::Models::Transformation::density,
         distort: String,
         dpr: Float,
         duration: Imagekitio::Models::Transformation::duration,
@@ -590,6 +599,14 @@ module Imagekitio
         def self?.values: -> ::Array[Imagekitio::Models::Transformation::crop_mode]
       end
 
+      type density = Integer | String
+
+      module Density
+        extend Imagekitio::Internal::Type::Union
+
+        def self?.variants: -> ::Array[Imagekitio::Models::Transformation::density]
+      end
+
       type duration = Float | String
 
       module Duration

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: imagekitio
 version: !ruby/object:Gem::Version
-  version: 4.9.0
+  version: 4.10.0
 platform: ruby
 authors:
 - ImageKit
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2026-08-15 00:00:00.000000000 Z
+date: 2026-09-16 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: cgi