imagekitio 4.8.0 → 4.9.0

data/rbi/imagekitio/models/custom_metadata_field.rbi

@@ -32,13 +32,23 @@ module Imagekitio
       end
       attr_writer :schema
 
+      # 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.
+      sig { returns(T.nilable(String)) }
+      attr_reader :description
+
+      sig { params(description: String).void }
+      attr_writer :description
+
       # Object containing details of a custom metadata field.
       sig do
         params(
           id: String,
           label: String,
           name: String,
-          schema: Imagekitio::CustomMetadataField::Schema::OrHash
+          schema: Imagekitio::CustomMetadataField::Schema::OrHash,
+          description: String
         ).returns(T.attached_class)
       end
       def self.new(
@@ -52,7 +62,11 @@ module Imagekitio
         # `customMetadata` (key-value object) for an asset using upload or update API.
         name:,
         # An object that describes the rules for the custom metadata field value.
-        schema:
+        schema:,
+        # 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
       )
       end
 
@@ -62,7 +76,8 @@ module Imagekitio
             id: String,
             label: String,
             name: String,
-            schema: Imagekitio::CustomMetadataField::Schema
+            schema: Imagekitio::CustomMetadataField::Schema,
+            description: String
           }
         )
       end

data/rbi/imagekitio/models/custom_metadata_field_create_params.rbi

@@ -36,11 +36,21 @@ module Imagekitio
       end
       attr_writer :schema
 
+      # Optional description for the custom metadata field. Can be up to 500 characters.
+      # This is shown as a hint to the users while setting the field's value on an asset
+      # in the media library UI.
+      sig { returns(T.nilable(String)) }
+      attr_reader :description
+
+      sig { params(description: String).void }
+      attr_writer :description
+
       sig do
         params(
           label: String,
           name: String,
           schema: Imagekitio::CustomMetadataFieldCreateParams::Schema::OrHash,
+          description: String,
           request_options: Imagekitio::RequestOptions::OrHash
         ).returns(T.attached_class)
       end
@@ -54,6 +64,10 @@ module Imagekitio
         # (including deleted) custom metadata fields.
         name:,
         schema:,
+        # Optional description for the custom metadata field. Can be up to 500 characters.
+        # This is shown as a hint to the users while setting the field's value on an asset
+        # in the media library UI.
+        description: nil,
         request_options: {}
       )
       end
@@ -64,6 +78,7 @@ module Imagekitio
             label: String,
             name: String,
             schema: Imagekitio::CustomMetadataFieldCreateParams::Schema,
+            description: String,
             request_options: Imagekitio::RequestOptions
           }
         )

data/rbi/imagekitio/models/custom_metadata_field_update_params.rbi

@@ -17,6 +17,16 @@ module Imagekitio
       sig { returns(String) }
       attr_accessor :id
 
+      # Optional description for the custom metadata field. Can be up to 500 characters.
+      # Send an empty string to clear an existing description. This is shown as a hint
+      # to the users while setting the field's value on an asset in the media library
+      # UI.
+      sig { returns(T.nilable(String)) }
+      attr_reader :description
+
+      sig { params(description: String).void }
+      attr_writer :description
+
       # Human readable name of the custom metadata field. This should be unique across
       # all non deleted custom metadata fields. This name is displayed as form field
       # label to the users while setting field value on an asset in the media library
@@ -46,6 +56,7 @@ module Imagekitio
       sig do
         params(
           id: String,
+          description: String,
           label: String,
           schema: Imagekitio::CustomMetadataFieldUpdateParams::Schema::OrHash,
           request_options: Imagekitio::RequestOptions::OrHash
@@ -53,6 +64,11 @@ module Imagekitio
       end
       def self.new(
         id:,
+        # Optional description for the custom metadata field. Can be up to 500 characters.
+        # Send an empty string to clear an existing description. This is shown as a hint
+        # to the users while setting the field's value on an asset in the media library
+        # UI.
+        description: nil,
         # Human readable name of the custom metadata field. This should be unique across
         # all non deleted custom metadata fields. This name is displayed as form field
         # label to the users while setting field value on an asset in the media library
@@ -71,6 +87,7 @@ module Imagekitio
         override.returns(
           {
             id: String,
+            description: String,
             label: String,
             schema: Imagekitio::CustomMetadataFieldUpdateParams::Schema,
             request_options: Imagekitio::RequestOptions

data/rbi/imagekitio/models/named_transformation.rbi

@@ -0,0 +1,81 @@
+# typed: strong
+
+module Imagekitio
+  module Models
+    class NamedTransformation < Imagekitio::Internal::Type::BaseModel
+      OrHash =
+        T.type_alias do
+          T.any(Imagekitio::NamedTransformation, Imagekitio::Internal::AnyHash)
+        end
+
+      # Unique identifier for a named transformation.
+      sig { returns(String) }
+      attr_accessor :id
+
+      # ISO 8601 timestamp of when the named transformation was created.
+      sig { returns(Time) }
+      attr_accessor :created_at
+
+      # Whether the named transformation is currently enabled. When set to `false`,
+      # requests using this named transformation fail at delivery time.
+      sig { returns(T::Boolean) }
+      attr_accessor :enabled
+
+      # Alias for the transformation string, used in URLs as `tr:n-<name>`. This is
+      # case-sensitive, contains only alphanumeric characters or `_` (underscore), and
+      # is unique across all named transformations for your account.
+      sig { returns(String) }
+      attr_accessor :name
+
+      # The transformation string this named transformation refers to. Learn more about
+      # the [transformation string syntax](https://imagekit.io/docs/transformations).
+      sig { returns(String) }
+      attr_accessor :transformation
+
+      # A named transformation is an alias for a transformation string, letting you
+      # apply and later update complex transformations without changing your image or
+      # video URLs. Learn more about
+      # [named transformations](https://imagekit.io/docs/transformations#named-transformations).
+      sig do
+        params(
+          id: String,
+          created_at: Time,
+          enabled: T::Boolean,
+          name: String,
+          transformation: String
+        ).returns(T.attached_class)
+      end
+      def self.new(
+        # Unique identifier for a named transformation.
+        id:,
+        # ISO 8601 timestamp of when the named transformation was created.
+        created_at:,
+        # Whether the named transformation is currently enabled. When set to `false`,
+        # requests using this named transformation fail at delivery time.
+        enabled:,
+        # Alias for the transformation string, used in URLs as `tr:n-<name>`. This is
+        # case-sensitive, contains only alphanumeric characters or `_` (underscore), and
+        # is unique across all named transformations for your account.
+        name:,
+        # The transformation string this named transformation refers to. Learn more about
+        # the [transformation string syntax](https://imagekit.io/docs/transformations).
+        transformation:
+      )
+      end
+
+      sig do
+        override.returns(
+          {
+            id: String,
+            created_at: Time,
+            enabled: T::Boolean,
+            name: String,
+            transformation: String
+          }
+        )
+      end
+      def to_hash
+      end
+    end
+  end
+end

data/rbi/imagekitio/models/named_transformation_create_params.rbi

@@ -0,0 +1,73 @@
+# typed: strong
+
+module Imagekitio
+  module Models
+    class NamedTransformationCreateParams < Imagekitio::Internal::Type::BaseModel
+      extend Imagekitio::Internal::Type::RequestParameters::Converter
+      include Imagekitio::Internal::Type::RequestParameters
+
+      OrHash =
+        T.type_alias do
+          T.any(
+            Imagekitio::NamedTransformationCreateParams,
+            Imagekitio::Internal::AnyHash
+          )
+        end
+
+      # Alias for the transformation string, used in URLs as `tr:n-<name>`. This is
+      # case-sensitive, contains only alphanumeric characters or `_` (underscore), and
+      # is unique across all named transformations for your account.
+      sig { returns(String) }
+      attr_accessor :name
+
+      # The transformation string this named transformation refers to. Learn more about
+      # the [transformation string syntax](https://imagekit.io/docs/transformations).
+      sig { returns(String) }
+      attr_accessor :transformation
+
+      # Whether the named transformation is currently enabled. When set to `false`,
+      # requests using this named transformation fail at delivery time.
+      sig { returns(T.nilable(T::Boolean)) }
+      attr_reader :enabled
+
+      sig { params(enabled: T::Boolean).void }
+      attr_writer :enabled
+
+      sig do
+        params(
+          name: String,
+          transformation: String,
+          enabled: T::Boolean,
+          request_options: Imagekitio::RequestOptions::OrHash
+        ).returns(T.attached_class)
+      end
+      def self.new(
+        # Alias for the transformation string, used in URLs as `tr:n-<name>`. This is
+        # case-sensitive, contains only alphanumeric characters or `_` (underscore), and
+        # is unique across all named transformations for your account.
+        name:,
+        # The transformation string this named transformation refers to. Learn more about
+        # the [transformation string syntax](https://imagekit.io/docs/transformations).
+        transformation:,
+        # Whether the named transformation is currently enabled. When set to `false`,
+        # requests using this named transformation fail at delivery time.
+        enabled: nil,
+        request_options: {}
+      )
+      end
+
+      sig do
+        override.returns(
+          {
+            name: String,
+            transformation: String,
+            enabled: T::Boolean,
+            request_options: Imagekitio::RequestOptions
+          }
+        )
+      end
+      def to_hash
+      end
+    end
+  end
+end

data/rbi/imagekitio/models/named_transformation_delete_params.rbi

@@ -0,0 +1,43 @@
+# typed: strong
+
+module Imagekitio
+  module Models
+    class NamedTransformationDeleteParams < Imagekitio::Internal::Type::BaseModel
+      extend Imagekitio::Internal::Type::RequestParameters::Converter
+      include Imagekitio::Internal::Type::RequestParameters
+
+      OrHash =
+        T.type_alias do
+          T.any(
+            Imagekitio::NamedTransformationDeleteParams,
+            Imagekitio::Internal::AnyHash
+          )
+        end
+
+      # Unique identifier for a named transformation.
+      sig { returns(String) }
+      attr_accessor :id
+
+      sig do
+        params(
+          id: String,
+          request_options: Imagekitio::RequestOptions::OrHash
+        ).returns(T.attached_class)
+      end
+      def self.new(
+        # Unique identifier for a named transformation.
+        id:,
+        request_options: {}
+      )
+      end
+
+      sig do
+        override.returns(
+          { id: String, request_options: Imagekitio::RequestOptions }
+        )
+      end
+      def to_hash
+      end
+    end
+  end
+end

data/rbi/imagekitio/models/named_transformation_get_params.rbi

@@ -0,0 +1,43 @@
+# typed: strong
+
+module Imagekitio
+  module Models
+    class NamedTransformationGetParams < Imagekitio::Internal::Type::BaseModel
+      extend Imagekitio::Internal::Type::RequestParameters::Converter
+      include Imagekitio::Internal::Type::RequestParameters
+
+      OrHash =
+        T.type_alias do
+          T.any(
+            Imagekitio::NamedTransformationGetParams,
+            Imagekitio::Internal::AnyHash
+          )
+        end
+
+      # Unique identifier for a named transformation.
+      sig { returns(String) }
+      attr_accessor :id
+
+      sig do
+        params(
+          id: String,
+          request_options: Imagekitio::RequestOptions::OrHash
+        ).returns(T.attached_class)
+      end
+      def self.new(
+        # Unique identifier for a named transformation.
+        id:,
+        request_options: {}
+      )
+      end
+
+      sig do
+        override.returns(
+          { id: String, request_options: Imagekitio::RequestOptions }
+        )
+      end
+      def to_hash
+      end
+    end
+  end
+end

data/rbi/imagekitio/models/named_transformation_list_params.rbi

@@ -0,0 +1,30 @@
+# typed: strong
+
+module Imagekitio
+  module Models
+    class NamedTransformationListParams < Imagekitio::Internal::Type::BaseModel
+      extend Imagekitio::Internal::Type::RequestParameters::Converter
+      include Imagekitio::Internal::Type::RequestParameters
+
+      OrHash =
+        T.type_alias do
+          T.any(
+            Imagekitio::NamedTransformationListParams,
+            Imagekitio::Internal::AnyHash
+          )
+        end
+
+      sig do
+        params(request_options: Imagekitio::RequestOptions::OrHash).returns(
+          T.attached_class
+        )
+      end
+      def self.new(request_options: {})
+      end
+
+      sig { override.returns({ request_options: Imagekitio::RequestOptions }) }
+      def to_hash
+      end
+    end
+  end
+end

data/rbi/imagekitio/models/named_transformation_list_response.rbi

@@ -0,0 +1,11 @@
+# typed: strong
+
+module Imagekitio
+  module Models
+    NamedTransformationListResponse =
+      T.let(
+        Imagekitio::Internal::Type::ArrayOf[Imagekitio::NamedTransformation],
+        Imagekitio::Internal::Type::Converter
+      )
+  end
+end

data/rbi/imagekitio/models/named_transformation_update_params.rbi

@@ -0,0 +1,87 @@
+# typed: strong
+
+module Imagekitio
+  module Models
+    class NamedTransformationUpdateParams < Imagekitio::Internal::Type::BaseModel
+      extend Imagekitio::Internal::Type::RequestParameters::Converter
+      include Imagekitio::Internal::Type::RequestParameters
+
+      OrHash =
+        T.type_alias do
+          T.any(
+            Imagekitio::NamedTransformationUpdateParams,
+            Imagekitio::Internal::AnyHash
+          )
+        end
+
+      # Unique identifier for a named transformation.
+      sig { returns(String) }
+      attr_accessor :id
+
+      # Whether the named transformation is enabled. Omit to leave the current value
+      # unchanged.
+      sig { returns(T.nilable(T::Boolean)) }
+      attr_reader :enabled
+
+      sig { params(enabled: T::Boolean).void }
+      attr_writer :enabled
+
+      # Alias for the transformation string, used in URLs as `tr:n-<name>`. This is
+      # case-sensitive, contains only alphanumeric characters or `_` (underscore), and
+      # is unique across all named transformations for your account.
+      sig { returns(T.nilable(String)) }
+      attr_reader :name
+
+      sig { params(name: String).void }
+      attr_writer :name
+
+      # The transformation string this named transformation refers to. Learn more about
+      # the [transformation string syntax](https://imagekit.io/docs/transformations).
+      sig { returns(T.nilable(String)) }
+      attr_reader :transformation
+
+      sig { params(transformation: String).void }
+      attr_writer :transformation
+
+      sig do
+        params(
+          id: String,
+          enabled: T::Boolean,
+          name: String,
+          transformation: String,
+          request_options: Imagekitio::RequestOptions::OrHash
+        ).returns(T.attached_class)
+      end
+      def self.new(
+        # Unique identifier for a named transformation.
+        id:,
+        # Whether the named transformation is enabled. Omit to leave the current value
+        # unchanged.
+        enabled: nil,
+        # Alias for the transformation string, used in URLs as `tr:n-<name>`. This is
+        # case-sensitive, contains only alphanumeric characters or `_` (underscore), and
+        # is unique across all named transformations for your account.
+        name: nil,
+        # The transformation string this named transformation refers to. Learn more about
+        # the [transformation string syntax](https://imagekit.io/docs/transformations).
+        transformation: nil,
+        request_options: {}
+      )
+      end
+
+      sig do
+        override.returns(
+          {
+            id: String,
+            enabled: T::Boolean,
+            name: String,
+            transformation: String,
+            request_options: Imagekitio::RequestOptions
+          }
+        )
+      end
+      def to_hash
+      end
+    end
+  end
+end

data/rbi/imagekitio/models.rbi

@@ -96,6 +96,23 @@ module Imagekitio
 
   Metadata = Imagekitio::Models::Metadata
 
+  NamedTransformation = Imagekitio::Models::NamedTransformation
+
+  NamedTransformationCreateParams =
+    Imagekitio::Models::NamedTransformationCreateParams
+
+  NamedTransformationDeleteParams =
+    Imagekitio::Models::NamedTransformationDeleteParams
+
+  NamedTransformationGetParams =
+    Imagekitio::Models::NamedTransformationGetParams
+
+  NamedTransformationListParams =
+    Imagekitio::Models::NamedTransformationListParams
+
+  NamedTransformationUpdateParams =
+    Imagekitio::Models::NamedTransformationUpdateParams
+
   Overlay = Imagekitio::Models::Overlay
 
   OverlayPosition = Imagekitio::Models::OverlayPosition

data/rbi/imagekitio/resources/custom_metadata_fields.rbi

@@ -12,6 +12,7 @@ module Imagekitio
           label: String,
           name: String,
           schema: Imagekitio::CustomMetadataFieldCreateParams::Schema::OrHash,
+          description: String,
           request_options: Imagekitio::RequestOptions::OrHash
         ).returns(Imagekitio::CustomMetadataField)
       end
@@ -25,14 +26,20 @@ module Imagekitio
         # (including deleted) custom metadata fields.
         name:,
         schema:,
+        # Optional description for the custom metadata field. Can be up to 500 characters.
+        # This is shown as a hint to the users while setting the field's value on an asset
+        # in the media library UI.
+        description: nil,
         request_options: {}
       )
       end
 
-      # This API updates the label or schema of an existing custom metadata field.
+      # This API updates the label, description, or schema of an existing custom
+      # metadata field.
       sig do
         params(
           id: String,
+          description: String,
           label: String,
           schema: Imagekitio::CustomMetadataFieldUpdateParams::Schema::OrHash,
           request_options: Imagekitio::RequestOptions::OrHash
@@ -41,6 +48,11 @@ module Imagekitio
       def update(
         # Should be a valid custom metadata field id.
         id,
+        # Optional description for the custom metadata field. Can be up to 500 characters.
+        # Send an empty string to clear an existing description. This is shown as a hint
+        # to the users while setting the field's value on an asset in the media library
+        # UI.
+        description: nil,
         # Human readable name of the custom metadata field. This should be unique across
         # all non deleted custom metadata fields. This name is displayed as form field
         # label to the users while setting field value on an asset in the media library

data/rbi/imagekitio/resources/named_transformations.rbi

@@ -0,0 +1,119 @@
+# typed: strong
+
+module Imagekitio
+  module Resources
+    class NamedTransformations
+      # Creates a new named transformation and returns the created object.
+      #
+      # A named transformation is a short, reusable name for a transformation string.
+      # Use it in image and video URLs as `tr:n-<name>`, and update the underlying
+      # transformation later without changing existing URLs. Learn more about
+      # [named transformations](https://imagekit.io/docs/transformations#named-transformations).
+      #
+      # You can create up to 250 named transformations per account.
+      sig do
+        params(
+          name: String,
+          transformation: String,
+          enabled: T::Boolean,
+          request_options: Imagekitio::RequestOptions::OrHash
+        ).returns(Imagekitio::NamedTransformation)
+      end
+      def create(
+        # Alias for the transformation string, used in URLs as `tr:n-<name>`. This is
+        # case-sensitive, contains only alphanumeric characters or `_` (underscore), and
+        # is unique across all named transformations for your account.
+        name:,
+        # The transformation string this named transformation refers to. Learn more about
+        # the [transformation string syntax](https://imagekit.io/docs/transformations).
+        transformation:,
+        # Whether the named transformation is currently enabled. When set to `false`,
+        # requests using this named transformation fail at delivery time.
+        enabled: nil,
+        request_options: {}
+      )
+      end
+
+      # Updates the named transformation identified by `id` and returns the updated
+      # object. Only the fields present in the request body are updated; other fields
+      # stay unchanged.
+      #
+      # Renaming or disabling a named transformation fails with a `409` error if it is
+      # still referenced (via the `n-<name>` token) by an upload pre-transformation or
+      # post-transformation setting. This check is best-effort and can't detect
+      # references in your own application code or in previously generated URLs.
+      sig do
+        params(
+          id: String,
+          enabled: T::Boolean,
+          name: String,
+          transformation: String,
+          request_options: Imagekitio::RequestOptions::OrHash
+        ).returns(Imagekitio::NamedTransformation)
+      end
+      def update(
+        # Unique identifier for a named transformation.
+        id,
+        # Whether the named transformation is enabled. Omit to leave the current value
+        # unchanged.
+        enabled: nil,
+        # Alias for the transformation string, used in URLs as `tr:n-<name>`. This is
+        # case-sensitive, contains only alphanumeric characters or `_` (underscore), and
+        # is unique across all named transformations for your account.
+        name: nil,
+        # The transformation string this named transformation refers to. Learn more about
+        # the [transformation string syntax](https://imagekit.io/docs/transformations).
+        transformation: nil,
+        request_options: {}
+      )
+      end
+
+      # Returns an array of all named transformations configured for your account.
+      sig do
+        params(request_options: Imagekitio::RequestOptions::OrHash).returns(
+          T::Array[Imagekitio::NamedTransformation]
+        )
+      end
+      def list(request_options: {})
+      end
+
+      # Permanently deletes the named transformation identified by `id`.
+      #
+      # Deletion fails with a `409` error if the named transformation is still
+      # referenced (via the `n-<name>` token) by an upload pre-transformation or
+      # post-transformation setting. This check is best-effort and can't detect
+      # references in your own application code or in previously generated URLs.
+      sig do
+        params(
+          id: String,
+          request_options: Imagekitio::RequestOptions::OrHash
+        ).void
+      end
+      def delete(
+        # Unique identifier for a named transformation.
+        id,
+        request_options: {}
+      )
+      end
+
+      # Retrieves the named transformation identified by `id`.
+      sig do
+        params(
+          id: String,
+          request_options: Imagekitio::RequestOptions::OrHash
+        ).returns(Imagekitio::NamedTransformation)
+      end
+      def get(
+        # Unique identifier for a named transformation.
+        id,
+        request_options: {}
+      )
+      end
+
+      # @api private
+      sig { params(client: Imagekitio::Client).returns(T.attached_class) }
+      def self.new(client:)
+      end
+    end
+  end
+end