imagekitio 3.0.0 → 4.0.0

data/lib/imagekitio/models/video_overlay.rb

@@ -0,0 +1,64 @@
+# frozen_string_literal: true
+
+module Imagekitio
+  module Models
+    class VideoOverlay < Imagekitio::Models::BaseOverlay
+      # @!attribute input
+      #   Specifies the relative path to the video used as an overlay.
+      #
+      #   @return [String]
+      required :input, String
+
+      # @!attribute type
+      #
+      #   @return [Symbol, :video]
+      required :type, const: :video
+
+      # @!attribute encoding
+      #   The input path can be included in the layer as either `i-{input}` or
+      #   `ie-{base64_encoded_input}`. By default, the SDK determines the appropriate
+      #   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`.
+      #
+      #   @return [Symbol, Imagekitio::Models::VideoOverlay::Encoding, nil]
+      optional :encoding, enum: -> { Imagekitio::VideoOverlay::Encoding }
+
+      # @!attribute transformation
+      #   Array of transformation to be applied to the overlay video. Except
+      #   `streamingResolutions`, all other video transformations are supported. See
+      #   [Video transformations](https://imagekit.io/docs/video-transformation).
+      #
+      #   @return [Array<Imagekitio::Models::Transformation>, nil]
+      optional :transformation, -> { Imagekitio::Internal::Type::ArrayOf[Imagekitio::Transformation] }
+
+      # @!method initialize(input:, encoding: nil, transformation: nil, type: :video)
+      #   Some parameter documentations has been truncated, see
+      #   {Imagekitio::Models::VideoOverlay} for more details.
+      #
+      #   @param input [String] Specifies the relative path to the video used as an overlay.
+      #
+      #   @param encoding [Symbol, Imagekitio::Models::VideoOverlay::Encoding] The input path can be included in the layer as either `i-{input}` or `ie-{base64
+      #
+      #   @param transformation [Array<Imagekitio::Models::Transformation>] Array of transformation to be applied to the overlay video. Except `streamingRes
+      #
+      #   @param type [Symbol, :video]
+
+      # The input path can be included in the layer as either `i-{input}` or
+      # `ie-{base64_encoded_input}`. By default, the SDK determines the appropriate
+      # 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`.
+      module Encoding
+        extend Imagekitio::Internal::Type::Enum
+
+        AUTO = :auto
+        PLAIN = :plain
+        BASE64 = :base64
+
+        # @!method self.values
+        #   @return [Array<Symbol>]
+      end
+    end
+  end
+end

data/lib/imagekitio/models/video_transformation_accepted_event.rb

@@ -0,0 +1,279 @@
+# frozen_string_literal: true
+
+module Imagekitio
+  module Models
+    class VideoTransformationAcceptedEvent < Imagekitio::Models::BaseWebhookEvent
+      # @!attribute created_at
+      #   Timestamp when the event was created in ISO8601 format.
+      #
+      #   @return [Time]
+      required :created_at, Time
+
+      # @!attribute data
+      #
+      #   @return [Imagekitio::Models::VideoTransformationAcceptedEvent::Data]
+      required :data, -> { Imagekitio::VideoTransformationAcceptedEvent::Data }
+
+      # @!attribute request
+      #   Information about the original request that triggered the video transformation.
+      #
+      #   @return [Imagekitio::Models::VideoTransformationAcceptedEvent::Request]
+      required :request, -> { Imagekitio::VideoTransformationAcceptedEvent::Request }
+
+      # @!attribute type
+      #
+      #   @return [Symbol, :"video.transformation.accepted"]
+      required :type, const: :"video.transformation.accepted"
+
+      # @!method initialize(created_at:, data:, request:, type: :"video.transformation.accepted")
+      #   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.
+      #
+      #   @param created_at [Time] Timestamp when the event was created in ISO8601 format.
+      #
+      #   @param data [Imagekitio::Models::VideoTransformationAcceptedEvent::Data]
+      #
+      #   @param request [Imagekitio::Models::VideoTransformationAcceptedEvent::Request] Information about the original request that triggered the video transformation.
+      #
+      #   @param type [Symbol, :"video.transformation.accepted"]
+
+      class Data < Imagekitio::Internal::Type::BaseModel
+        # @!attribute asset
+        #   Information about the source video asset being transformed.
+        #
+        #   @return [Imagekitio::Models::VideoTransformationAcceptedEvent::Data::Asset]
+        required :asset, -> { Imagekitio::VideoTransformationAcceptedEvent::Data::Asset }
+
+        # @!attribute transformation
+        #   Base information about a video transformation request.
+        #
+        #   @return [Imagekitio::Models::VideoTransformationAcceptedEvent::Data::Transformation]
+        required :transformation, -> { Imagekitio::VideoTransformationAcceptedEvent::Data::Transformation }
+
+        # @!method initialize(asset:, transformation:)
+        #   @param asset [Imagekitio::Models::VideoTransformationAcceptedEvent::Data::Asset] Information about the source video asset being transformed.
+        #
+        #   @param transformation [Imagekitio::Models::VideoTransformationAcceptedEvent::Data::Transformation] Base information about a video transformation request.
+
+        # @see Imagekitio::Models::VideoTransformationAcceptedEvent::Data#asset
+        class Asset < Imagekitio::Internal::Type::BaseModel
+          # @!attribute url
+          #   URL to download or access the source video file.
+          #
+          #   @return [String]
+          required :url, String
+
+          # @!method initialize(url:)
+          #   Information about the source video asset being transformed.
+          #
+          #   @param url [String] URL to download or access the source video file.
+        end
+
+        # @see Imagekitio::Models::VideoTransformationAcceptedEvent::Data#transformation
+        class Transformation < Imagekitio::Internal::Type::BaseModel
+          # @!attribute type
+          #   Type of video transformation:
+          #
+          #   - `video-transformation`: Standard video processing (resize, format conversion,
+          #     etc.)
+          #   - `gif-to-video`: Convert animated GIF to video format
+          #   - `video-thumbnail`: Generate thumbnail image from video
+          #
+          #   @return [Symbol, Imagekitio::Models::VideoTransformationAcceptedEvent::Data::Transformation::Type]
+          required :type, enum: -> { Imagekitio::VideoTransformationAcceptedEvent::Data::Transformation::Type }
+
+          # @!attribute options
+          #   Configuration options for video transformations.
+          #
+          #   @return [Imagekitio::Models::VideoTransformationAcceptedEvent::Data::Transformation::Options, nil]
+          optional :options, -> { Imagekitio::VideoTransformationAcceptedEvent::Data::Transformation::Options }
+
+          # @!method initialize(type:, options: nil)
+          #   Some parameter documentations has been truncated, see
+          #   {Imagekitio::Models::VideoTransformationAcceptedEvent::Data::Transformation} for
+          #   more details.
+          #
+          #   Base information about a video transformation request.
+          #
+          #   @param type [Symbol, Imagekitio::Models::VideoTransformationAcceptedEvent::Data::Transformation::Type] Type of video transformation:
+          #
+          #   @param options [Imagekitio::Models::VideoTransformationAcceptedEvent::Data::Transformation::Options] Configuration options for video transformations.
+
+          # Type of video transformation:
+          #
+          # - `video-transformation`: Standard video processing (resize, format conversion,
+          #   etc.)
+          # - `gif-to-video`: Convert animated GIF to video format
+          # - `video-thumbnail`: Generate thumbnail image from video
+          #
+          # @see Imagekitio::Models::VideoTransformationAcceptedEvent::Data::Transformation#type
+          module Type
+            extend Imagekitio::Internal::Type::Enum
+
+            VIDEO_TRANSFORMATION = :"video-transformation"
+            GIF_TO_VIDEO = :"gif-to-video"
+            VIDEO_THUMBNAIL = :"video-thumbnail"
+
+            # @!method self.values
+            #   @return [Array<Symbol>]
+          end
+
+          # @see Imagekitio::Models::VideoTransformationAcceptedEvent::Data::Transformation#options
+          class Options < Imagekitio::Internal::Type::BaseModel
+            # @!attribute audio_codec
+            #   Audio codec used for encoding (aac or opus).
+            #
+            #   @return [Symbol, Imagekitio::Models::VideoTransformationAcceptedEvent::Data::Transformation::Options::AudioCodec, nil]
+            optional :audio_codec,
+                     enum: -> { Imagekitio::VideoTransformationAcceptedEvent::Data::Transformation::Options::AudioCodec }
+
+            # @!attribute auto_rotate
+            #   Whether to automatically rotate the video based on metadata.
+            #
+            #   @return [Boolean, nil]
+            optional :auto_rotate, Imagekitio::Internal::Type::Boolean
+
+            # @!attribute format_
+            #   Output format for the transformed video or thumbnail.
+            #
+            #   @return [Symbol, Imagekitio::Models::VideoTransformationAcceptedEvent::Data::Transformation::Options::Format, nil]
+            optional :format_,
+                     enum: -> {
+                       Imagekitio::VideoTransformationAcceptedEvent::Data::Transformation::Options::Format
+                     },
+                     api_name: :format
+
+            # @!attribute quality
+            #   Quality setting for the output video.
+            #
+            #   @return [Integer, nil]
+            optional :quality, Integer
+
+            # @!attribute stream_protocol
+            #   Streaming protocol for adaptive bitrate streaming.
+            #
+            #   @return [Symbol, Imagekitio::Models::VideoTransformationAcceptedEvent::Data::Transformation::Options::StreamProtocol, nil]
+            optional :stream_protocol,
+                     enum: -> { Imagekitio::VideoTransformationAcceptedEvent::Data::Transformation::Options::StreamProtocol }
+
+            # @!attribute variants
+            #   Array of quality representations for adaptive bitrate streaming.
+            #
+            #   @return [Array<String>, nil]
+            optional :variants, Imagekitio::Internal::Type::ArrayOf[String]
+
+            # @!attribute video_codec
+            #   Video codec used for encoding (h264, vp9, or av1).
+            #
+            #   @return [Symbol, Imagekitio::Models::VideoTransformationAcceptedEvent::Data::Transformation::Options::VideoCodec, nil]
+            optional :video_codec,
+                     enum: -> { Imagekitio::VideoTransformationAcceptedEvent::Data::Transformation::Options::VideoCodec }
+
+            # @!method initialize(audio_codec: nil, auto_rotate: nil, format_: nil, quality: nil, stream_protocol: nil, variants: nil, video_codec: nil)
+            #   Configuration options for video transformations.
+            #
+            #   @param audio_codec [Symbol, Imagekitio::Models::VideoTransformationAcceptedEvent::Data::Transformation::Options::AudioCodec] Audio codec used for encoding (aac or opus).
+            #
+            #   @param auto_rotate [Boolean] Whether to automatically rotate the video based on metadata.
+            #
+            #   @param format_ [Symbol, Imagekitio::Models::VideoTransformationAcceptedEvent::Data::Transformation::Options::Format] Output format for the transformed video or thumbnail.
+            #
+            #   @param quality [Integer] Quality setting for the output video.
+            #
+            #   @param stream_protocol [Symbol, Imagekitio::Models::VideoTransformationAcceptedEvent::Data::Transformation::Options::StreamProtocol] Streaming protocol for adaptive bitrate streaming.
+            #
+            #   @param variants [Array<String>] Array of quality representations for adaptive bitrate streaming.
+            #
+            #   @param video_codec [Symbol, Imagekitio::Models::VideoTransformationAcceptedEvent::Data::Transformation::Options::VideoCodec] Video codec used for encoding (h264, vp9, or av1).
+
+            # Audio codec used for encoding (aac or opus).
+            #
+            # @see Imagekitio::Models::VideoTransformationAcceptedEvent::Data::Transformation::Options#audio_codec
+            module AudioCodec
+              extend Imagekitio::Internal::Type::Enum
+
+              AAC = :aac
+              OPUS = :opus
+
+              # @!method self.values
+              #   @return [Array<Symbol>]
+            end
+
+            # Output format for the transformed video or thumbnail.
+            #
+            # @see Imagekitio::Models::VideoTransformationAcceptedEvent::Data::Transformation::Options#format_
+            module Format
+              extend Imagekitio::Internal::Type::Enum
+
+              MP4 = :mp4
+              WEBM = :webm
+              JPG = :jpg
+              PNG = :png
+              WEBP = :webp
+
+              # @!method self.values
+              #   @return [Array<Symbol>]
+            end
+
+            # Streaming protocol for adaptive bitrate streaming.
+            #
+            # @see Imagekitio::Models::VideoTransformationAcceptedEvent::Data::Transformation::Options#stream_protocol
+            module StreamProtocol
+              extend Imagekitio::Internal::Type::Enum
+
+              HLS = :HLS
+              DASH = :DASH
+
+              # @!method self.values
+              #   @return [Array<Symbol>]
+            end
+
+            # Video codec used for encoding (h264, vp9, or av1).
+            #
+            # @see Imagekitio::Models::VideoTransformationAcceptedEvent::Data::Transformation::Options#video_codec
+            module VideoCodec
+              extend Imagekitio::Internal::Type::Enum
+
+              H264 = :h264
+              VP9 = :vp9
+              AV1 = :av1
+
+              # @!method self.values
+              #   @return [Array<Symbol>]
+            end
+          end
+        end
+      end
+
+      class Request < Imagekitio::Internal::Type::BaseModel
+        # @!attribute url
+        #   Full URL of the transformation request that was submitted.
+        #
+        #   @return [String]
+        required :url, String
+
+        # @!attribute x_request_id
+        #   Unique identifier for the originating transformation request.
+        #
+        #   @return [String]
+        required :x_request_id, String
+
+        # @!attribute user_agent
+        #   User-Agent header from the original request that triggered the transformation.
+        #
+        #   @return [String, nil]
+        optional :user_agent, String
+
+        # @!method initialize(url:, x_request_id:, user_agent: nil)
+        #   Information about the original request that triggered the video transformation.
+        #
+        #   @param url [String] Full URL of the transformation request that was submitted.
+        #
+        #   @param x_request_id [String] Unique identifier for the originating transformation request.
+        #
+        #   @param user_agent [String] User-Agent header from the original request that triggered the transformation.
+      end
+    end
+  end
+end

data/lib/imagekitio/models/video_transformation_error_event.rb

@@ -0,0 +1,326 @@
+# frozen_string_literal: true
+
+module Imagekitio
+  module Models
+    class VideoTransformationErrorEvent < Imagekitio::Models::BaseWebhookEvent
+      # @!attribute created_at
+      #   Timestamp when the event was created in ISO8601 format.
+      #
+      #   @return [Time]
+      required :created_at, Time
+
+      # @!attribute data
+      #
+      #   @return [Imagekitio::Models::VideoTransformationErrorEvent::Data]
+      required :data, -> { Imagekitio::VideoTransformationErrorEvent::Data }
+
+      # @!attribute request
+      #   Information about the original request that triggered the video transformation.
+      #
+      #   @return [Imagekitio::Models::VideoTransformationErrorEvent::Request]
+      required :request, -> { Imagekitio::VideoTransformationErrorEvent::Request }
+
+      # @!attribute type
+      #
+      #   @return [Symbol, :"video.transformation.error"]
+      required :type, const: :"video.transformation.error"
+
+      # @!method initialize(created_at:, data:, request:, type: :"video.transformation.error")
+      #   Triggered when an error occurs during video encoding. Listen to this webhook to
+      #   log error reasons and debug issues. Check your origin and URL endpoint settings
+      #   if the reason is related to download failure. For other errors, contact ImageKit
+      #   support.
+      #
+      #   @param created_at [Time] Timestamp when the event was created in ISO8601 format.
+      #
+      #   @param data [Imagekitio::Models::VideoTransformationErrorEvent::Data]
+      #
+      #   @param request [Imagekitio::Models::VideoTransformationErrorEvent::Request] Information about the original request that triggered the video transformation.
+      #
+      #   @param type [Symbol, :"video.transformation.error"]
+
+      class Data < Imagekitio::Internal::Type::BaseModel
+        # @!attribute asset
+        #   Information about the source video asset being transformed.
+        #
+        #   @return [Imagekitio::Models::VideoTransformationErrorEvent::Data::Asset]
+        required :asset, -> { Imagekitio::VideoTransformationErrorEvent::Data::Asset }
+
+        # @!attribute transformation
+        #
+        #   @return [Imagekitio::Models::VideoTransformationErrorEvent::Data::Transformation]
+        required :transformation, -> { Imagekitio::VideoTransformationErrorEvent::Data::Transformation }
+
+        # @!method initialize(asset:, transformation:)
+        #   @param asset [Imagekitio::Models::VideoTransformationErrorEvent::Data::Asset] Information about the source video asset being transformed.
+        #
+        #   @param transformation [Imagekitio::Models::VideoTransformationErrorEvent::Data::Transformation]
+
+        # @see Imagekitio::Models::VideoTransformationErrorEvent::Data#asset
+        class Asset < Imagekitio::Internal::Type::BaseModel
+          # @!attribute url
+          #   URL to download or access the source video file.
+          #
+          #   @return [String]
+          required :url, String
+
+          # @!method initialize(url:)
+          #   Information about the source video asset being transformed.
+          #
+          #   @param url [String] URL to download or access the source video file.
+        end
+
+        # @see Imagekitio::Models::VideoTransformationErrorEvent::Data#transformation
+        class Transformation < Imagekitio::Internal::Type::BaseModel
+          # @!attribute type
+          #   Type of video transformation:
+          #
+          #   - `video-transformation`: Standard video processing (resize, format conversion,
+          #     etc.)
+          #   - `gif-to-video`: Convert animated GIF to video format
+          #   - `video-thumbnail`: Generate thumbnail image from video
+          #
+          #   @return [Symbol, Imagekitio::Models::VideoTransformationErrorEvent::Data::Transformation::Type]
+          required :type, enum: -> { Imagekitio::VideoTransformationErrorEvent::Data::Transformation::Type }
+
+          # @!attribute error
+          #   Details about the transformation error.
+          #
+          #   @return [Imagekitio::Models::VideoTransformationErrorEvent::Data::Transformation::Error, nil]
+          optional :error, -> { Imagekitio::VideoTransformationErrorEvent::Data::Transformation::Error }
+
+          # @!attribute options
+          #   Configuration options for video transformations.
+          #
+          #   @return [Imagekitio::Models::VideoTransformationErrorEvent::Data::Transformation::Options, nil]
+          optional :options, -> { Imagekitio::VideoTransformationErrorEvent::Data::Transformation::Options }
+
+          # @!method initialize(type:, error: nil, options: nil)
+          #   Some parameter documentations has been truncated, see
+          #   {Imagekitio::Models::VideoTransformationErrorEvent::Data::Transformation} for
+          #   more details.
+          #
+          #   @param type [Symbol, Imagekitio::Models::VideoTransformationErrorEvent::Data::Transformation::Type] Type of video transformation:
+          #
+          #   @param error [Imagekitio::Models::VideoTransformationErrorEvent::Data::Transformation::Error] Details about the transformation error.
+          #
+          #   @param options [Imagekitio::Models::VideoTransformationErrorEvent::Data::Transformation::Options] Configuration options for video transformations.
+
+          # Type of video transformation:
+          #
+          # - `video-transformation`: Standard video processing (resize, format conversion,
+          #   etc.)
+          # - `gif-to-video`: Convert animated GIF to video format
+          # - `video-thumbnail`: Generate thumbnail image from video
+          #
+          # @see Imagekitio::Models::VideoTransformationErrorEvent::Data::Transformation#type
+          module Type
+            extend Imagekitio::Internal::Type::Enum
+
+            VIDEO_TRANSFORMATION = :"video-transformation"
+            GIF_TO_VIDEO = :"gif-to-video"
+            VIDEO_THUMBNAIL = :"video-thumbnail"
+
+            # @!method self.values
+            #   @return [Array<Symbol>]
+          end
+
+          # @see Imagekitio::Models::VideoTransformationErrorEvent::Data::Transformation#error
+          class Error < Imagekitio::Internal::Type::BaseModel
+            # @!attribute reason
+            #   Specific reason for the transformation failure:
+            #
+            #   - `encoding_failed`: Error during video encoding process
+            #   - `download_failed`: Could not download source video
+            #   - `internal_server_error`: Unexpected server error
+            #
+            #   @return [Symbol, Imagekitio::Models::VideoTransformationErrorEvent::Data::Transformation::Error::Reason]
+            required :reason,
+                     enum: -> { Imagekitio::VideoTransformationErrorEvent::Data::Transformation::Error::Reason }
+
+            # @!method initialize(reason:)
+            #   Some parameter documentations has been truncated, see
+            #   {Imagekitio::Models::VideoTransformationErrorEvent::Data::Transformation::Error}
+            #   for more details.
+            #
+            #   Details about the transformation error.
+            #
+            #   @param reason [Symbol, Imagekitio::Models::VideoTransformationErrorEvent::Data::Transformation::Error::Reason] Specific reason for the transformation failure:
+
+            # Specific reason for the transformation failure:
+            #
+            # - `encoding_failed`: Error during video encoding process
+            # - `download_failed`: Could not download source video
+            # - `internal_server_error`: Unexpected server error
+            #
+            # @see Imagekitio::Models::VideoTransformationErrorEvent::Data::Transformation::Error#reason
+            module Reason
+              extend Imagekitio::Internal::Type::Enum
+
+              ENCODING_FAILED = :encoding_failed
+              DOWNLOAD_FAILED = :download_failed
+              INTERNAL_SERVER_ERROR = :internal_server_error
+
+              # @!method self.values
+              #   @return [Array<Symbol>]
+            end
+          end
+
+          # @see Imagekitio::Models::VideoTransformationErrorEvent::Data::Transformation#options
+          class Options < Imagekitio::Internal::Type::BaseModel
+            # @!attribute audio_codec
+            #   Audio codec used for encoding (aac or opus).
+            #
+            #   @return [Symbol, Imagekitio::Models::VideoTransformationErrorEvent::Data::Transformation::Options::AudioCodec, nil]
+            optional :audio_codec,
+                     enum: -> { Imagekitio::VideoTransformationErrorEvent::Data::Transformation::Options::AudioCodec }
+
+            # @!attribute auto_rotate
+            #   Whether to automatically rotate the video based on metadata.
+            #
+            #   @return [Boolean, nil]
+            optional :auto_rotate, Imagekitio::Internal::Type::Boolean
+
+            # @!attribute format_
+            #   Output format for the transformed video or thumbnail.
+            #
+            #   @return [Symbol, Imagekitio::Models::VideoTransformationErrorEvent::Data::Transformation::Options::Format, nil]
+            optional :format_,
+                     enum: -> {
+                       Imagekitio::VideoTransformationErrorEvent::Data::Transformation::Options::Format
+                     },
+                     api_name: :format
+
+            # @!attribute quality
+            #   Quality setting for the output video.
+            #
+            #   @return [Integer, nil]
+            optional :quality, Integer
+
+            # @!attribute stream_protocol
+            #   Streaming protocol for adaptive bitrate streaming.
+            #
+            #   @return [Symbol, Imagekitio::Models::VideoTransformationErrorEvent::Data::Transformation::Options::StreamProtocol, nil]
+            optional :stream_protocol,
+                     enum: -> { Imagekitio::VideoTransformationErrorEvent::Data::Transformation::Options::StreamProtocol }
+
+            # @!attribute variants
+            #   Array of quality representations for adaptive bitrate streaming.
+            #
+            #   @return [Array<String>, nil]
+            optional :variants, Imagekitio::Internal::Type::ArrayOf[String]
+
+            # @!attribute video_codec
+            #   Video codec used for encoding (h264, vp9, or av1).
+            #
+            #   @return [Symbol, Imagekitio::Models::VideoTransformationErrorEvent::Data::Transformation::Options::VideoCodec, nil]
+            optional :video_codec,
+                     enum: -> { Imagekitio::VideoTransformationErrorEvent::Data::Transformation::Options::VideoCodec }
+
+            # @!method initialize(audio_codec: nil, auto_rotate: nil, format_: nil, quality: nil, stream_protocol: nil, variants: nil, video_codec: nil)
+            #   Configuration options for video transformations.
+            #
+            #   @param audio_codec [Symbol, Imagekitio::Models::VideoTransformationErrorEvent::Data::Transformation::Options::AudioCodec] Audio codec used for encoding (aac or opus).
+            #
+            #   @param auto_rotate [Boolean] Whether to automatically rotate the video based on metadata.
+            #
+            #   @param format_ [Symbol, Imagekitio::Models::VideoTransformationErrorEvent::Data::Transformation::Options::Format] Output format for the transformed video or thumbnail.
+            #
+            #   @param quality [Integer] Quality setting for the output video.
+            #
+            #   @param stream_protocol [Symbol, Imagekitio::Models::VideoTransformationErrorEvent::Data::Transformation::Options::StreamProtocol] Streaming protocol for adaptive bitrate streaming.
+            #
+            #   @param variants [Array<String>] Array of quality representations for adaptive bitrate streaming.
+            #
+            #   @param video_codec [Symbol, Imagekitio::Models::VideoTransformationErrorEvent::Data::Transformation::Options::VideoCodec] Video codec used for encoding (h264, vp9, or av1).
+
+            # Audio codec used for encoding (aac or opus).
+            #
+            # @see Imagekitio::Models::VideoTransformationErrorEvent::Data::Transformation::Options#audio_codec
+            module AudioCodec
+              extend Imagekitio::Internal::Type::Enum
+
+              AAC = :aac
+              OPUS = :opus
+
+              # @!method self.values
+              #   @return [Array<Symbol>]
+            end
+
+            # Output format for the transformed video or thumbnail.
+            #
+            # @see Imagekitio::Models::VideoTransformationErrorEvent::Data::Transformation::Options#format_
+            module Format
+              extend Imagekitio::Internal::Type::Enum
+
+              MP4 = :mp4
+              WEBM = :webm
+              JPG = :jpg
+              PNG = :png
+              WEBP = :webp
+
+              # @!method self.values
+              #   @return [Array<Symbol>]
+            end
+
+            # Streaming protocol for adaptive bitrate streaming.
+            #
+            # @see Imagekitio::Models::VideoTransformationErrorEvent::Data::Transformation::Options#stream_protocol
+            module StreamProtocol
+              extend Imagekitio::Internal::Type::Enum
+
+              HLS = :HLS
+              DASH = :DASH
+
+              # @!method self.values
+              #   @return [Array<Symbol>]
+            end
+
+            # Video codec used for encoding (h264, vp9, or av1).
+            #
+            # @see Imagekitio::Models::VideoTransformationErrorEvent::Data::Transformation::Options#video_codec
+            module VideoCodec
+              extend Imagekitio::Internal::Type::Enum
+
+              H264 = :h264
+              VP9 = :vp9
+              AV1 = :av1
+
+              # @!method self.values
+              #   @return [Array<Symbol>]
+            end
+          end
+        end
+      end
+
+      class Request < Imagekitio::Internal::Type::BaseModel
+        # @!attribute url
+        #   Full URL of the transformation request that was submitted.
+        #
+        #   @return [String]
+        required :url, String
+
+        # @!attribute x_request_id
+        #   Unique identifier for the originating transformation request.
+        #
+        #   @return [String]
+        required :x_request_id, String
+
+        # @!attribute user_agent
+        #   User-Agent header from the original request that triggered the transformation.
+        #
+        #   @return [String, nil]
+        optional :user_agent, String
+
+        # @!method initialize(url:, x_request_id:, user_agent: nil)
+        #   Information about the original request that triggered the video transformation.
+        #
+        #   @param url [String] Full URL of the transformation request that was submitted.
+        #
+        #   @param x_request_id [String] Unique identifier for the originating transformation request.
+        #
+        #   @param user_agent [String] User-Agent header from the original request that triggered the transformation.
+      end
+    end
+  end
+end