imagekitio 4.9.0 → 4.11.0

data/rbi/imagekitio/models/accounts/webhook_create_params.rbi

@@ -0,0 +1,78 @@
+# typed: strong
+
+module Imagekitio
+  module Models
+    module Accounts
+      class WebhookCreateParams < Imagekitio::Internal::Type::BaseModel
+        extend Imagekitio::Internal::Type::RequestParameters::Converter
+        include Imagekitio::Internal::Type::RequestParameters
+
+        OrHash =
+          T.type_alias do
+            T.any(
+              Imagekitio::Accounts::WebhookCreateParams,
+              Imagekitio::Internal::AnyHash
+            )
+          end
+
+        # The URL where ImageKit sends webhook events as `POST` requests. Must use the
+        # `http` or `https` protocol, and must be unique across all webhooks for your
+        # account.
+        sig { returns(String) }
+        attr_accessor :endpoint
+
+        # The event types this webhook is subscribed to. ImageKit sends a request to the
+        # `endpoint` only for these events.
+        sig do
+          returns(T::Array[Imagekitio::Accounts::WebhookEventType::OrSymbol])
+        end
+        attr_accessor :events
+
+        # Whether the webhook is enabled. When `false`, ImageKit doesn't send any events
+        # to the `endpoint`.
+        sig { returns(T.nilable(T::Boolean)) }
+        attr_reader :enabled
+
+        sig { params(enabled: T::Boolean).void }
+        attr_writer :enabled
+
+        sig do
+          params(
+            endpoint: String,
+            events: T::Array[Imagekitio::Accounts::WebhookEventType::OrSymbol],
+            enabled: T::Boolean,
+            request_options: Imagekitio::RequestOptions::OrHash
+          ).returns(T.attached_class)
+        end
+        def self.new(
+          # The URL where ImageKit sends webhook events as `POST` requests. Must use the
+          # `http` or `https` protocol, and must be unique across all webhooks for your
+          # account.
+          endpoint:,
+          # The event types this webhook is subscribed to. ImageKit sends a request to the
+          # `endpoint` only for these events.
+          events:,
+          # Whether the webhook is enabled. When `false`, ImageKit doesn't send any events
+          # to the `endpoint`.
+          enabled: nil,
+          request_options: {}
+        )
+        end
+
+        sig do
+          override.returns(
+            {
+              endpoint: String,
+              events:
+                T::Array[Imagekitio::Accounts::WebhookEventType::OrSymbol],
+              enabled: T::Boolean,
+              request_options: Imagekitio::RequestOptions
+            }
+          )
+        end
+        def to_hash
+        end
+      end
+    end
+  end
+end

data/rbi/imagekitio/models/accounts/webhook_delete_params.rbi

@@ -0,0 +1,45 @@
+# typed: strong
+
+module Imagekitio
+  module Models
+    module Accounts
+      class WebhookDeleteParams < Imagekitio::Internal::Type::BaseModel
+        extend Imagekitio::Internal::Type::RequestParameters::Converter
+        include Imagekitio::Internal::Type::RequestParameters
+
+        OrHash =
+          T.type_alias do
+            T.any(
+              Imagekitio::Accounts::WebhookDeleteParams,
+              Imagekitio::Internal::AnyHash
+            )
+          end
+
+        # Unique identifier for a webhook.
+        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 webhook.
+          id:,
+          request_options: {}
+        )
+        end
+
+        sig do
+          override.returns(
+            { id: String, request_options: Imagekitio::RequestOptions }
+          )
+        end
+        def to_hash
+        end
+      end
+    end
+  end
+end

data/rbi/imagekitio/models/accounts/webhook_event_type.rbi

@@ -0,0 +1,101 @@
+# typed: strong
+
+module Imagekitio
+  module Models
+    module Accounts
+      # A webhook event type. Learn more about the payload of each
+      # [webhook event](https://imagekit.io/docs/webhooks#list-of-events).
+      module WebhookEventType
+        extend Imagekitio::Internal::Type::Enum
+
+        TaggedSymbol =
+          T.type_alias { T.all(Symbol, Imagekitio::Accounts::WebhookEventType) }
+        OrSymbol = T.type_alias { T.any(Symbol, String) }
+
+        VIDEO_TRANSFORMATION_ACCEPTED =
+          T.let(
+            :"video.transformation.accepted",
+            Imagekitio::Accounts::WebhookEventType::TaggedSymbol
+          )
+        VIDEO_TRANSFORMATION_READY =
+          T.let(
+            :"video.transformation.ready",
+            Imagekitio::Accounts::WebhookEventType::TaggedSymbol
+          )
+        VIDEO_TRANSFORMATION_ERROR =
+          T.let(
+            :"video.transformation.error",
+            Imagekitio::Accounts::WebhookEventType::TaggedSymbol
+          )
+        UPLOAD_PRE_TRANSFORM_SUCCESS =
+          T.let(
+            :"upload.pre-transform.success",
+            Imagekitio::Accounts::WebhookEventType::TaggedSymbol
+          )
+        UPLOAD_PRE_TRANSFORM_ERROR =
+          T.let(
+            :"upload.pre-transform.error",
+            Imagekitio::Accounts::WebhookEventType::TaggedSymbol
+          )
+        UPLOAD_POST_TRANSFORM_SUCCESS =
+          T.let(
+            :"upload.post-transform.success",
+            Imagekitio::Accounts::WebhookEventType::TaggedSymbol
+          )
+        UPLOAD_POST_TRANSFORM_ERROR =
+          T.let(
+            :"upload.post-transform.error",
+            Imagekitio::Accounts::WebhookEventType::TaggedSymbol
+          )
+        FILE_CREATED =
+          T.let(
+            :"file.created",
+            Imagekitio::Accounts::WebhookEventType::TaggedSymbol
+          )
+        FILE_UPDATED =
+          T.let(
+            :"file.updated",
+            Imagekitio::Accounts::WebhookEventType::TaggedSymbol
+          )
+        FILE_DELETED =
+          T.let(
+            :"file.deleted",
+            Imagekitio::Accounts::WebhookEventType::TaggedSymbol
+          )
+        FILE_VERSION_CREATED =
+          T.let(
+            :"file-version.created",
+            Imagekitio::Accounts::WebhookEventType::TaggedSymbol
+          )
+        FILE_VERSION_DELETED =
+          T.let(
+            :"file-version.deleted",
+            Imagekitio::Accounts::WebhookEventType::TaggedSymbol
+          )
+        FOLDER_CREATED =
+          T.let(
+            :"folder.created",
+            Imagekitio::Accounts::WebhookEventType::TaggedSymbol
+          )
+        FOLDER_UPDATED =
+          T.let(
+            :"folder.updated",
+            Imagekitio::Accounts::WebhookEventType::TaggedSymbol
+          )
+        FOLDER_DELETED =
+          T.let(
+            :"folder.deleted",
+            Imagekitio::Accounts::WebhookEventType::TaggedSymbol
+          )
+
+        sig do
+          override.returns(
+            T::Array[Imagekitio::Accounts::WebhookEventType::TaggedSymbol]
+          )
+        end
+        def self.values
+        end
+      end
+    end
+  end
+end

data/rbi/imagekitio/models/accounts/webhook_get_params.rbi

@@ -0,0 +1,45 @@
+# typed: strong
+
+module Imagekitio
+  module Models
+    module Accounts
+      class WebhookGetParams < Imagekitio::Internal::Type::BaseModel
+        extend Imagekitio::Internal::Type::RequestParameters::Converter
+        include Imagekitio::Internal::Type::RequestParameters
+
+        OrHash =
+          T.type_alias do
+            T.any(
+              Imagekitio::Accounts::WebhookGetParams,
+              Imagekitio::Internal::AnyHash
+            )
+          end
+
+        # Unique identifier for a webhook.
+        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 webhook.
+          id:,
+          request_options: {}
+        )
+        end
+
+        sig do
+          override.returns(
+            { id: String, request_options: Imagekitio::RequestOptions }
+          )
+        end
+        def to_hash
+        end
+      end
+    end
+  end
+end

data/rbi/imagekitio/models/accounts/webhook_list_params.rbi

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

data/rbi/imagekitio/models/accounts/webhook_list_response.rbi

@@ -0,0 +1,13 @@
+# typed: strong
+
+module Imagekitio
+  module Models
+    module Accounts
+      WebhookListResponse =
+        T.let(
+          Imagekitio::Internal::Type::ArrayOf[Imagekitio::Accounts::Webhook],
+          Imagekitio::Internal::Type::Converter
+        )
+    end
+  end
+end

data/rbi/imagekitio/models/accounts/webhook_update_params.rbi

@@ -0,0 +1,98 @@
+# typed: strong
+
+module Imagekitio
+  module Models
+    module Accounts
+      class WebhookUpdateParams < Imagekitio::Internal::Type::BaseModel
+        extend Imagekitio::Internal::Type::RequestParameters::Converter
+        include Imagekitio::Internal::Type::RequestParameters
+
+        OrHash =
+          T.type_alias do
+            T.any(
+              Imagekitio::Accounts::WebhookUpdateParams,
+              Imagekitio::Internal::AnyHash
+            )
+          end
+
+        # Unique identifier for a webhook.
+        sig { returns(String) }
+        attr_accessor :id
+
+        # Whether the webhook 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
+
+        # The URL where ImageKit sends webhook events as `POST` requests. Must use the
+        # `http` or `https` protocol, and must be unique across all webhooks for your
+        # account.
+        sig { returns(T.nilable(String)) }
+        attr_reader :endpoint
+
+        sig { params(endpoint: String).void }
+        attr_writer :endpoint
+
+        # The event types this webhook is subscribed to. Replaces the existing list. Omit
+        # to leave the current value unchanged.
+        sig do
+          returns(
+            T.nilable(
+              T::Array[Imagekitio::Accounts::WebhookEventType::OrSymbol]
+            )
+          )
+        end
+        attr_reader :events
+
+        sig do
+          params(
+            events: T::Array[Imagekitio::Accounts::WebhookEventType::OrSymbol]
+          ).void
+        end
+        attr_writer :events
+
+        sig do
+          params(
+            id: String,
+            enabled: T::Boolean,
+            endpoint: String,
+            events: T::Array[Imagekitio::Accounts::WebhookEventType::OrSymbol],
+            request_options: Imagekitio::RequestOptions::OrHash
+          ).returns(T.attached_class)
+        end
+        def self.new(
+          # Unique identifier for a webhook.
+          id:,
+          # Whether the webhook is enabled. Omit to leave the current value unchanged.
+          enabled: nil,
+          # The URL where ImageKit sends webhook events as `POST` requests. Must use the
+          # `http` or `https` protocol, and must be unique across all webhooks for your
+          # account.
+          endpoint: nil,
+          # The event types this webhook is subscribed to. Replaces the existing list. Omit
+          # to leave the current value unchanged.
+          events: nil,
+          request_options: {}
+        )
+        end
+
+        sig do
+          override.returns(
+            {
+              id: String,
+              enabled: T::Boolean,
+              endpoint: String,
+              events:
+                T::Array[Imagekitio::Accounts::WebhookEventType::OrSymbol],
+              request_options: Imagekitio::RequestOptions
+            }
+          )
+        end
+        def to_hash
+        end
+      end
+    end
+  end
+end

data/rbi/imagekitio/models/asset_list_params.rbi

@@ -73,6 +73,15 @@ module Imagekitio
 
       # Sort the results by one of the supported fields in ascending or descending
       # order.
+      #
+      # `ASC_ORIGINAL_CREATION_DATE` and `DESC_ORIGINAL_CREATION_DATE` sort files by the
+      # value of the reserved `_internal_original_created_datetime` custom metadata
+      # field (labelled "Original creation date" in the dashboard). This field exists
+      # only after you enable the original creation date setting under the Custom
+      # Metadata tab of the media library settings. Files that have no value set for
+      # this field fall back to their upload time, so migrated assets carrying a
+      # preserved original date and natively uploaded assets are ordered together in a
+      # single timeline.
       sig { returns(T.nilable(Imagekitio::AssetListParams::Sort::OrSymbol)) }
       attr_reader :sort
 
@@ -137,6 +146,15 @@ module Imagekitio
         skip: nil,
         # Sort the results by one of the supported fields in ascending or descending
         # order.
+        #
+        # `ASC_ORIGINAL_CREATION_DATE` and `DESC_ORIGINAL_CREATION_DATE` sort files by the
+        # value of the reserved `_internal_original_created_datetime` custom metadata
+        # field (labelled "Original creation date" in the dashboard). This field exists
+        # only after you enable the original creation date setting under the Custom
+        # Metadata tab of the media library settings. Files that have no value set for
+        # this field fall back to their upload time, so migrated assets carrying a
+        # preserved original date and natively uploaded assets are ordered together in a
+        # single timeline.
         sort: nil,
         # Filter results by asset type.
         #
@@ -198,6 +216,15 @@ module Imagekitio
 
       # Sort the results by one of the supported fields in ascending or descending
       # order.
+      #
+      # `ASC_ORIGINAL_CREATION_DATE` and `DESC_ORIGINAL_CREATION_DATE` sort files by the
+      # value of the reserved `_internal_original_created_datetime` custom metadata
+      # field (labelled "Original creation date" in the dashboard). This field exists
+      # only after you enable the original creation date setting under the Custom
+      # Metadata tab of the media library settings. Files that have no value set for
+      # this field fall back to their upload time, so migrated assets carrying a
+      # preserved original date and natively uploaded assets are ordered together in a
+      # single timeline.
       module Sort
         extend Imagekitio::Internal::Type::Enum
 
@@ -236,6 +263,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/beta/v2/file_upload_params.rbi

@@ -75,7 +75,11 @@ module Imagekitio
           attr_writer :custom_coordinates
 
           # JSON key-value pairs to associate with the asset. Create the custom metadata
-          # fields before setting these values.
+          # fields before setting these values. To preserve the original creation date of an
+          # asset migrated from another system, set the reserved
+          # `_internal_original_created_datetime` key to an ISO 8601 date string. This key
+          # is available once the original creation date setting is enabled in the media
+          # library settings.
           sig { returns(T.nilable(T::Hash[Symbol, T.anything])) }
           attr_reader :custom_metadata
 
@@ -349,7 +353,11 @@ module Imagekitio
             #   customCoordinates will be removed.
             custom_coordinates: nil,
             # JSON key-value pairs to associate with the asset. Create the custom metadata
-            # fields before setting these values.
+            # fields before setting these values. To preserve the original creation date of an
+            # asset migrated from another system, set the reserved
+            # `_internal_original_created_datetime` key to an ISO 8601 date string. This key
+            # is available once the original creation date setting is enabled in the media
+            # library settings.
             custom_metadata: nil,
             # Optional text to describe the contents of the file.
             description: nil,

data/rbi/imagekitio/models/custom_metadata_field.rbi

@@ -41,6 +41,27 @@ module Imagekitio
       sig { params(description: String).void }
       attr_writer :description
 
+      # Present and set to `true` when the field is reserved, i.e. created and managed
+      # by ImageKit rather than by you. Omitted for regular fields.
+      #
+      # Currently the only reserved field is `_internal_original_created_datetime`
+      # (label "Original creation date", type `Date`). ImageKit creates it when you
+      # enable the original creation date setting under the Custom Metadata tab of the
+      # media library settings in the dashboard. Use it to preserve the original
+      # creation date of assets migrated from another system: set its value through the
+      # `customMetadata` object in the upload or update file details API, then sort with
+      # `ASC_ORIGINAL_CREATION_DATE` or `DESC_ORIGINAL_CREATION_DATE` in the list and
+      # search assets API, or filter with
+      # `"customMetadata._internal_original_created_datetime"` in `searchQuery`.
+      #
+      # Reserved fields cannot be deleted, and their name cannot be reused when creating
+      # a new field.
+      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 +69,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 +88,23 @@ 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, i.e. created and managed
+        # by ImageKit rather than by you. Omitted for regular fields.
+        #
+        # Currently the only reserved field is `_internal_original_created_datetime`
+        # (label "Original creation date", type `Date`). ImageKit creates it when you
+        # enable the original creation date setting under the Custom Metadata tab of the
+        # media library settings in the dashboard. Use it to preserve the original
+        # creation date of assets migrated from another system: set its value through the
+        # `customMetadata` object in the upload or update file details API, then sort with
+        # `ASC_ORIGINAL_CREATION_DATE` or `DESC_ORIGINAL_CREATION_DATE` in the list and
+        # search assets API, or filter with
+        # `"customMetadata._internal_original_created_datetime"` in `searchQuery`.
+        #
+        # Reserved fields cannot be deleted, and their name cannot be reused when creating
+        # a new field.
+        reserved: nil
       )
       end
 
@@ -77,7 +115,8 @@ module Imagekitio
             label: String,
             name: String,
             schema: Imagekitio::CustomMetadataField::Schema,
-            description: String
+            description: String,
+            reserved: T::Boolean
           }
         )
       end

data/rbi/imagekitio/models/custom_metadata_field_create_params.rbi

@@ -23,6 +23,10 @@ module Imagekitio
 
       # API name of the custom metadata field. This should be unique across all
       # (including deleted) custom metadata fields.
+      #
+      # `_internal_original_created_datetime` is a reserved name and cannot be used.
+      # ImageKit creates that field automatically when you enable the original creation
+      # date setting in the media library settings.
       sig { returns(String) }
       attr_accessor :name
 
@@ -62,6 +66,10 @@ module Imagekitio
         label:,
         # API name of the custom metadata field. This should be unique across all
         # (including deleted) custom metadata fields.
+        #
+        # `_internal_original_created_datetime` is a reserved name and cannot be used.
+        # ImageKit creates that field automatically when you enable the original creation
+        # date setting in the media library settings.
         name:,
         schema:,
         # Optional description for the custom metadata field. Can be up to 500 characters.

data/rbi/imagekitio/models/file_upload_params.rbi

@@ -70,7 +70,11 @@ module Imagekitio
       attr_writer :custom_coordinates
 
       # JSON key-value pairs to associate with the asset. Create the custom metadata
-      # fields before setting these values.
+      # fields before setting these values. To preserve the original creation date of an
+      # asset migrated from another system, set the reserved
+      # `_internal_original_created_datetime` key to an ISO 8601 date string. This key
+      # is available once the original creation date setting is enabled in the media
+      # library settings.
       sig { returns(T.nilable(T::Hash[Symbol, T.anything])) }
       attr_reader :custom_metadata
 
@@ -371,7 +375,11 @@ module Imagekitio
         #   customCoordinates will be removed.
         custom_coordinates: nil,
         # JSON key-value pairs to associate with the asset. Create the custom metadata
-        # fields before setting these values.
+        # fields before setting these values. To preserve the original creation date of an
+        # asset migrated from another system, set the reserved
+        # `_internal_original_created_datetime` key to an ISO 8601 date string. This key
+        # is available once the original creation date setting is enabled in the media
+        # library settings.
         custom_metadata: nil,
         # Optional text to describe the contents of the file.
         description: nil,