imagekitio 4.6.0 → 4.8.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: fedc066efa6b23de05d5fbde2a58620df0367b19bc0fe3c4c4088c814341f371
-  data.tar.gz: e63e496269f464dfea1b230ae3db7d4dbb31139b776fb5b98204aa7ed53b8afb
+  metadata.gz: 53589b5e387cc2e3919aaea2e515bc77f13f77d81cf9b244ba2b1749868acb8e
+  data.tar.gz: 2b8701182074f45b8e43235229cff8d2112dfc6063a307e97431110a7419a19b
 SHA512:
-  metadata.gz: 86ce4087b4dc5d08936d4b0909b76cd134196ed0afb410c7dbdf101ea03acf7b6f6eff8857acd6738265a3eff8738b42dcd07e0971f63da0ee6252eb21edfb09
-  data.tar.gz: 785de1bdd7be3bcd73991b87789539b7cce8e1a45088cb477cef9c5d4dd57c0d3e1193f5f9e540cae9df28350ede54327a226a9f36356f2861da358ac64b984e
+  metadata.gz: bc8f6b4f36557e0419313bdb688c243736a3139e9e1095300d0af2f8c2af339858881d51c67b92d41b1b2493d031cdbed69c116fd6a992ba8bacb54ab5f1bdfb
+  data.tar.gz: b4033a82d0f7960904b513ccd4f01cb662698b0abbba368727889a3aee987438c6f78768efe30b577e35f3f249b4d4cde55bad1c3c27b1418030471f719463ac

data/CHANGELOG.md

@@ -1,5 +1,24 @@
 # Changelog
 
+## [4.8.0](https://github.com/imagekit-developer/imagekit-ruby/compare/v4.7.0...v4.8.0) (2026-07-14)
+
+
+### Features
+
+* **api:** add usage analytics breakdown endpoint ([82b2909](https://github.com/imagekit-developer/imagekit-ruby/commit/82b29099bc232601ad99dd3b304be8edf59e2179))
+
+## [4.7.0](https://github.com/imagekit-developer/imagekit-ruby/compare/v4.6.0...v4.7.0) (2026-06-18)
+
+
+### Features
+
+* **origins:** add useIAMRole for IAM role authentication ([c38cc1b](https://github.com/imagekit-developer/imagekit-ruby/commit/c38cc1bea8028c2c10ae543e027dc71a63170222))
+
+
+### Documentation
+
+* update default value in description for intensity in colorize transformation ([7b128c5](https://github.com/imagekit-developer/imagekit-ruby/commit/7b128c59d1da7435e6137ebad7a60251e941defa))
+
 ## [4.6.0](https://github.com/imagekit-developer/imagekit-ruby/compare/v4.5.1...v4.6.0) (2026-06-03)
 
 

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.6.0"
+gem "imagekitio", "~> 4.8.0"
 ```
 
 <!-- x-release-please-end -->

data/lib/imagekitio/internal/transport/base_client.rb

@@ -306,7 +306,10 @@ module Imagekitio
               Imagekitio::Internal::Util.deep_merge(*[req[:body], opts[:extra_body]].compact)
             end
 
-          headers.delete("content-type") if body.nil?
+          # Generated methods always pass `req[:body]` for operations that define a
+          # request body, so only elide the content-type header when the operation
+          # has no body at all, not when an optional body param was omitted.
+          headers.delete("content-type") if body.nil? && !req.key?(:body)
 
           url = Imagekitio::Internal::Util.join_parsed_uri(
             @base_url_components,

data/lib/imagekitio/models/accounts/origin_request.rb

@@ -27,7 +27,7 @@ module Imagekitio
 
         class S3 < Imagekitio::Internal::Type::BaseModel
           # @!attribute access_key
-          #   Access key for the bucket.
+          #   Access key for the bucket. When `useIAMRole` is `true`, send an empty string.
           #
           #   @return [String]
           required :access_key, String, api_name: :accessKey
@@ -45,7 +45,7 @@ module Imagekitio
           required :name, String
 
           # @!attribute secret_key
-          #   Secret key for the bucket.
+          #   Secret key for the bucket. When `useIAMRole` is `true`, send an empty string.
           #
           #   @return [String]
           required :secret_key, String, api_name: :secretKey
@@ -75,14 +75,24 @@ module Imagekitio
           #   @return [String, nil]
           optional :prefix, String
 
-          # @!method initialize(access_key:, bucket:, name:, secret_key:, base_url_for_canonical_header: nil, include_canonical_header: nil, prefix: nil, type: :S3)
-          #   @param access_key [String] Access key for the bucket.
+          # @!attribute use_iam_role
+          #   Use IAM role for authentication instead of access/secret keys. When set to
+          #   `true`, send an empty string for both `accessKey` and `secretKey`.
+          #
+          #   @return [Boolean, nil]
+          optional :use_iam_role, Imagekitio::Internal::Type::Boolean, api_name: :useIAMRole
+
+          # @!method initialize(access_key:, bucket:, name:, secret_key:, base_url_for_canonical_header: nil, include_canonical_header: nil, prefix: nil, use_iam_role: nil, type: :S3)
+          #   Some parameter documentations has been truncated, see
+          #   {Imagekitio::Models::Accounts::OriginRequest::S3} for more details.
+          #
+          #   @param access_key [String] Access key for the bucket. When `useIAMRole` is `true`, send an empty string.
           #
           #   @param bucket [String] S3 bucket name.
           #
           #   @param name [String] Display name of the origin.
           #
-          #   @param secret_key [String] Secret key for the bucket.
+          #   @param secret_key [String] Secret key for the bucket. When `useIAMRole` is `true`, send an empty string.
           #
           #   @param base_url_for_canonical_header [String] URL used in the Canonical header (if enabled).
           #
@@ -90,6 +100,8 @@ module Imagekitio
           #
           #   @param prefix [String] Path prefix inside the bucket.
           #
+          #   @param use_iam_role [Boolean] Use IAM role for authentication instead of access/secret keys. When set to `true
+          #
           #   @param type [Symbol, :S3]
         end
 
@@ -179,7 +191,7 @@ module Imagekitio
 
         class CloudinaryBackup < Imagekitio::Internal::Type::BaseModel
           # @!attribute access_key
-          #   Access key for the bucket.
+          #   Access key for the bucket. When `useIAMRole` is `true`, send an empty string.
           #
           #   @return [String]
           required :access_key, String, api_name: :accessKey
@@ -197,7 +209,7 @@ module Imagekitio
           required :name, String
 
           # @!attribute secret_key
-          #   Secret key for the bucket.
+          #   Secret key for the bucket. When `useIAMRole` is `true`, send an empty string.
           #
           #   @return [String]
           required :secret_key, String, api_name: :secretKey
@@ -227,14 +239,25 @@ module Imagekitio
           #   @return [String, nil]
           optional :prefix, String
 
-          # @!method initialize(access_key:, bucket:, name:, secret_key:, base_url_for_canonical_header: nil, include_canonical_header: nil, prefix: nil, type: :CLOUDINARY_BACKUP)
-          #   @param access_key [String] Access key for the bucket.
+          # @!attribute use_iam_role
+          #   Use IAM role for authentication instead of access/secret keys. When set to
+          #   `true`, send an empty string for both `accessKey` and `secretKey`.
+          #
+          #   @return [Boolean, nil]
+          optional :use_iam_role, Imagekitio::Internal::Type::Boolean, api_name: :useIAMRole
+
+          # @!method initialize(access_key:, bucket:, name:, secret_key:, base_url_for_canonical_header: nil, include_canonical_header: nil, prefix: nil, use_iam_role: nil, type: :CLOUDINARY_BACKUP)
+          #   Some parameter documentations has been truncated, see
+          #   {Imagekitio::Models::Accounts::OriginRequest::CloudinaryBackup} for more
+          #   details.
+          #
+          #   @param access_key [String] Access key for the bucket. When `useIAMRole` is `true`, send an empty string.
           #
           #   @param bucket [String] S3 bucket name.
           #
           #   @param name [String] Display name of the origin.
           #
-          #   @param secret_key [String] Secret key for the bucket.
+          #   @param secret_key [String] Secret key for the bucket. When `useIAMRole` is `true`, send an empty string.
           #
           #   @param base_url_for_canonical_header [String] URL used in the Canonical header (if enabled).
           #
@@ -242,6 +265,8 @@ module Imagekitio
           #
           #   @param prefix [String] Path prefix inside the bucket.
           #
+          #   @param use_iam_role [Boolean] Use IAM role for authentication instead of access/secret keys. When set to `true
+          #
           #   @param type [Symbol, :CLOUDINARY_BACKUP]
         end
 

data/lib/imagekitio/models/accounts/origin_response.rb

@@ -65,6 +65,13 @@ module Imagekitio
           #   @return [String, nil]
           optional :base_url_for_canonical_header, String, api_name: :baseUrlForCanonicalHeader
 
+          # @!attribute use_iam_role
+          #   Whether the origin authenticates using an IAM role instead of access/secret
+          #   keys.
+          #
+          #   @return [Boolean, nil]
+          optional :use_iam_role, Imagekitio::Internal::Type::Boolean, api_name: :useIAMRole
+
           response_only do
             # @!attribute id
             #   Unique identifier for the origin. This is generated by ImageKit when you create
@@ -74,7 +81,7 @@ module Imagekitio
             required :id, String
           end
 
-          # @!method initialize(id:, bucket:, include_canonical_header:, name:, prefix:, base_url_for_canonical_header: nil, type: :S3)
+          # @!method initialize(id:, bucket:, include_canonical_header:, name:, prefix:, base_url_for_canonical_header: nil, use_iam_role: nil, type: :S3)
           #   Some parameter documentations has been truncated, see
           #   {Imagekitio::Models::Accounts::OriginResponse::S3} for more details.
           #
@@ -90,6 +97,8 @@ module Imagekitio
           #
           #   @param base_url_for_canonical_header [String] URL used in the Canonical header (if enabled).
           #
+          #   @param use_iam_role [Boolean] Whether the origin authenticates using an IAM role instead of access/secret keys
+          #
           #   @param type [Symbol, :S3]
         end
 
@@ -213,6 +222,13 @@ module Imagekitio
           #   @return [String, nil]
           optional :base_url_for_canonical_header, String, api_name: :baseUrlForCanonicalHeader
 
+          # @!attribute use_iam_role
+          #   Whether the origin authenticates using an IAM role instead of access/secret
+          #   keys.
+          #
+          #   @return [Boolean, nil]
+          optional :use_iam_role, Imagekitio::Internal::Type::Boolean, api_name: :useIAMRole
+
           response_only do
             # @!attribute id
             #   Unique identifier for the origin. This is generated by ImageKit when you create
@@ -222,7 +238,7 @@ module Imagekitio
             required :id, String
           end
 
-          # @!method initialize(id:, bucket:, include_canonical_header:, name:, prefix:, base_url_for_canonical_header: nil, type: :CLOUDINARY_BACKUP)
+          # @!method initialize(id:, bucket:, include_canonical_header:, name:, prefix:, base_url_for_canonical_header: nil, use_iam_role: nil, type: :CLOUDINARY_BACKUP)
           #   Some parameter documentations has been truncated, see
           #   {Imagekitio::Models::Accounts::OriginResponse::CloudinaryBackup} for more
           #   details.
@@ -239,6 +255,8 @@ module Imagekitio
           #
           #   @param base_url_for_canonical_header [String] URL used in the Canonical header (if enabled).
           #
+          #   @param use_iam_role [Boolean] Whether the origin authenticates using an IAM role instead of access/secret keys
+          #
           #   @param type [Symbol, :CLOUDINARY_BACKUP]
         end
 

data/lib/imagekitio/models/accounts/request_bandwidth_entry.rb

@@ -0,0 +1,26 @@
+# frozen_string_literal: true
+
+module Imagekitio
+  module Models
+    module Accounts
+      class RequestBandwidthEntry < Imagekitio::Internal::Type::BaseModel
+        # @!attribute bandwidth_bytes
+        #   Total bandwidth used in bytes.
+        #
+        #   @return [Float]
+        required :bandwidth_bytes, Float, api_name: :bandwidthBytes
+
+        # @!attribute request_count
+        #   Number of requests.
+        #
+        #   @return [Float]
+        required :request_count, Float, api_name: :requestCount
+
+        # @!method initialize(bandwidth_bytes:, request_count:)
+        #   @param bandwidth_bytes [Float] Total bandwidth used in bytes.
+        #
+        #   @param request_count [Float] Number of requests.
+      end
+    end
+  end
+end

data/lib/imagekitio/models/accounts/usage_analytics_get_params.rb

@@ -0,0 +1,39 @@
+# frozen_string_literal: true
+
+module Imagekitio
+  module Models
+    module Accounts
+      # @see Imagekitio::Resources::Accounts::UsageAnalytics#get
+      class UsageAnalyticsGetParams < Imagekitio::Internal::Type::BaseModel
+        extend Imagekitio::Internal::Type::RequestParameters::Converter
+        include Imagekitio::Internal::Type::RequestParameters
+
+        # @!attribute end_date
+        #   Specify an `endDate` in `YYYY-MM-DD` format, interpreted as a UTC calendar day.
+        #   It should be after the `startDate`. The difference between `startDate` and
+        #   `endDate` should be less than 90 days.
+        #
+        #   @return [Date]
+        required :end_date, Date
+
+        # @!attribute start_date
+        #   Specify a `startDate` in `YYYY-MM-DD` format, interpreted as a UTC calendar day.
+        #   It should be before the `endDate`. The difference between `startDate` and
+        #   `endDate` should be less than 90 days.
+        #
+        #   @return [Date]
+        required :start_date, Date
+
+        # @!method initialize(end_date:, start_date:, request_options: {})
+        #   Some parameter documentations has been truncated, see
+        #   {Imagekitio::Models::Accounts::UsageAnalyticsGetParams} for more details.
+        #
+        #   @param end_date [Date] Specify an `endDate` in `YYYY-MM-DD` format, interpreted as a UTC calendar day.
+        #
+        #   @param start_date [Date] Specify a `startDate` in `YYYY-MM-DD` format, interpreted as a UTC calendar day.
+        #
+        #   @param request_options [Imagekitio::RequestOptions, Hash{Symbol=>Object}]
+      end
+    end
+  end
+end