fastpixapi 0.0.1 → 1.0.0

data/lib/fastpix_api_sdk/input_video.rb

@@ -1,4 +1,3 @@
-# Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
 
 # typed: true
 # frozen_string_literal: true
@@ -14,7 +13,7 @@ module FastpixApiSDK
   extend T::Sig
   class InputVideo
     extend T::Sig
-    attr_accessor 
+    
 
 
     sig { params(sdk_config: SDKConfiguration).void }
@@ -23,7 +22,7 @@ module FastpixApiSDK
       
     end
 
-    sig { params(base_url: String, url_variables: T.nilable(T::Hash[Symbol, String])).returns(String) }
+    sig { params(base_url: String, url_variables: T.nilable(T::Hash[Symbol, T.any(String, T::Enum)])).returns(String) }
     def get_url(base_url:, url_variables: nil)
       sd_base_url, sd_options = @sdk_configuration.get_server_details
 
@@ -39,8 +38,8 @@ module FastpixApiSDK
     end
 
 
-    sig { params(request: T.nilable(Models::Components::CreateMediaRequest), timeout_ms: T.nilable(Integer)).returns(Models::Operations::CreateMediaResponse) }
-    def create_media(request: nil, timeout_ms: nil)
+    sig { params(request: Models::Components::CreateMediaRequest, retries: T.nilable(Utils::RetryConfig), timeout_ms: T.nilable(Integer)).returns(Models::Operations::CreateMediaResponse) }
+    def create_media(request:, retries: nil, timeout_ms: nil)
       # create_media - Create media from URL
       # This endpoint allows developers or users to create a new video or audio media in FastPix using a publicly accessible URL. FastPix will fetch the media from the provided URL, process it, and store it on the platform for use. 
       # 
@@ -66,61 +65,71 @@ module FastpixApiSDK
       # 
       # * **Public CDNs:** URLs from public content delivery networks that host video files. 
       # 
-      # Upon successful creation, the API returns an id that should be retained for future operations related to this media. 
+      # Upon successful creation, the API returns an `id` that should be retained for future operations related to this media. 
       # 
       # #### How it works
       # 
       # 
-      # 1. Send a POST request to the /on-demand endpoint with the media URL (typically a video or audio file) and optional media settings. 
+      # 1. Send a POST request to this endpoint with the media URL (typically a video or audio file) and optional media settings. 
       # 
       # 2. FastPix uploads the video from the provided URL to its storage. 
       # 
       # 3. Receive a response containing the unique id for the newly created media item. 
       # 
-      # 4. Use the id in subsequent API calls, such as checking the status of the media with the **Get Media by ID** endpoint to determine when the media is ready for playback. 
+      # 4. Use the id in subsequent API calls, such as checking the status of the media with the <a href="https://docs.fastpix.io/reference/get-media">Get Media by ID</a> endpoint to determine when the media is ready for playback. 
       # 
-      # FastPix uses webhooks to tell your application about things that happen in the background, outside of the API regular request flow. For instance, once the media file is created (but not yet processed or encoded), we'll shoot a POST message to the address you give us with the webhook event video.media.created. 
+      # FastPix uses webhooks to tell your application about things that happen in the background, outside of the API regular request flow. For instance, once the media file is created (but not yet processed or encoded), we'll shoot a `POST` message to the address you give us with the webhook event <a href="https://docs.fastpix.io/docs/media-events#videomediacreated">video.media.created</a>. 
       # 
       # 
-      # Once processing is done you can look for the events video.media.ready and video.media.failed to see the status of your new media file.
+      # Once processing is done you can look for the events <a href="https://docs.fastpix.io/docs/media-events#/videomediaready">video.media.ready<a/> and <a href="https://docs.fastpix.io/docs/media-events#videomediafailed">video.media.failed</a> to see the status of your new media file.
       # 
-      # #### Use case scenario
-      # 
-      # 
-      # * **Use case:** A developer wants to integrate a user-generated content platform where users can upload links to their videos hosted on third-party platforms like AWS or Google Cloud Storage. This endpoint is used to create media directly from those URLs. 
-      # 
-      # 
-      # * **Detailed example:** 
-      # Say you're building an online learning platform where instructors upload video URLs hosted on their private cloud servers. By providing the video URL to this endpoint, the platform processes and adds it to your media library, ready for playback. 
+      # Related guide: <a href="https://docs.fastpix.io/docs/upload-videos-from-url">Upload videos from URL</a>
       # 
       url, params = @sdk_configuration.get_server_details
       base_url = Utils.template_url(url, params)
       url = "#{base_url}/on-demand"
       headers = {}
-      req_content_type, data, form = Utils.serialize_request_body(request, false, true, :request, :json)
+      headers = T.cast(headers, T::Hash[String, String])
+      req_content_type, data, form = Utils.serialize_request_body(request, false, false, :request, :json)
       headers['content-type'] = req_content_type
+      raise StandardError, 'request body is required' if data.nil? && form.nil?
 
       if form
         body = Utils.encode_form(form)
       elsif Utils.match_content_type(req_content_type, 'application/x-www-form-urlencoded')
-        body = URI.encode_www_form(data)
+        body = URI.encode_www_form(T.cast(data, T::Hash[Symbol, Object]))
       else
         body = data
       end
       headers['Accept'] = 'application/json'
       headers['user-agent'] = @sdk_configuration.user_agent
+      retries ||= @sdk_configuration.retry_config
+      retries ||= Utils::RetryConfig.new(
+        backoff: Utils::BackoffStrategy.new(
+          exponent: 1.5,
+          initial_interval: 1000,
+          max_elapsed_time: 3_600_000,
+          max_interval: 10_000
+        ),
+        retry_connection_errors: true,
+        strategy: 'backoff'
+      )
+      retry_options = retries.to_faraday_retry_options(initial_time: Time.now)
+      retry_options[:retry_statuses] = [408, 429, 500, 502, 503, 504]
 
-      security = !@sdk_configuration.nil? && !@sdk_configuration.security_source.nil? ? @sdk_configuration.security_source.call : nil
+      security = @sdk_configuration.security_source&.call
 
       timeout = (timeout_ms.to_f / 1000) unless timeout_ms.nil?
       timeout ||= @sdk_configuration.timeout
+      
 
-      connection = @sdk_configuration.client
+      connection = @sdk_configuration.client.dup
+      connection.request :retry, retry_options
 
       hook_ctx = SDKHooks::HookContext.new(
         config: @sdk_configuration,
         base_url: base_url,
-        oauth2_scopes: [],
+        oauth2_scopes: nil,
         operation_id: 'create-media',
         security_source: @sdk_configuration.security_source
       )
@@ -130,7 +139,7 @@ module FastpixApiSDK
       
       
       begin
-        http_response = connection.post(url) do |req|
+        http_response = T.must(connection).post(url) do |req|
           req.body = body
           req.headers.merge!(headers)
           req.options.timeout = timeout unless timeout.nil?
@@ -179,12 +188,12 @@ module FastpixApiSDK
             response: http_response
           )
           response_data = http_response.env.response_body
-          obj = Crystalline.unmarshal_json(JSON.parse(response_data), Models::Operations::CreateMediaResponseBody)
+          obj = Crystalline.unmarshal_json(JSON.parse(response_data), Models::Components::CreateMediaSuccessResponse)
           response = Models::Operations::CreateMediaResponse.new(
             status_code: http_response.status,
             content_type: content_type,
             raw_response: http_response,
-            object: obj
+            create_media_success_response: T.unsafe(obj)
           )
 
           return response
@@ -201,7 +210,8 @@ module FastpixApiSDK
           )
           response_data = http_response.env.response_body
           obj = Crystalline.unmarshal_json(JSON.parse(response_data), Models::Errors::BadRequestError)
-          throw obj
+          obj.raw_response = http_response
+          raise obj
         else
           raise ::FastpixApiSDK::Models::Errors::APIError.new(status_code: http_response.status, body: http_response.env.response_body, raw_response: http_response), 'Unknown content type received'
         end
@@ -215,7 +225,8 @@ module FastpixApiSDK
           )
           response_data = http_response.env.response_body
           obj = Crystalline.unmarshal_json(JSON.parse(response_data), Models::Errors::InvalidPermissionError)
-          throw obj
+          obj.raw_response = http_response
+          raise obj
         else
           raise ::FastpixApiSDK::Models::Errors::APIError.new(status_code: http_response.status, body: http_response.env.response_body, raw_response: http_response), 'Unknown content type received'
         end
@@ -229,7 +240,8 @@ module FastpixApiSDK
           )
           response_data = http_response.env.response_body
           obj = Crystalline.unmarshal_json(JSON.parse(response_data), Models::Errors::ForbiddenError)
-          throw obj
+          obj.raw_response = http_response
+          raise obj
         else
           raise ::FastpixApiSDK::Models::Errors::APIError.new(status_code: http_response.status, body: http_response.env.response_body, raw_response: http_response), 'Unknown content type received'
         end
@@ -243,7 +255,8 @@ module FastpixApiSDK
           )
           response_data = http_response.env.response_body
           obj = Crystalline.unmarshal_json(JSON.parse(response_data), Models::Errors::ValidationErrorResponse)
-          throw obj
+          obj.raw_response = http_response
+          raise obj
         else
           raise ::FastpixApiSDK::Models::Errors::APIError.new(status_code: http_response.status, body: http_response.env.response_body, raw_response: http_response), 'Unknown content type received'
         end
@@ -258,63 +271,99 @@ module FastpixApiSDK
     end
 
 
-    sig { params(request: T.nilable(Models::Operations::DirectUploadVideoMediaRequest), timeout_ms: T.nilable(Integer)).returns(Models::Operations::DirectUploadVideoMediaResponse) }
-    def direct_upload_video_media(request: nil, timeout_ms: nil)
+    sig { params(cors_origin: T.nilable(String), push_media_settings: T.nilable(Models::Operations::PushMediaSettings), metadata: T.nilable(T::Hash[Symbol, String]), access_policy: T.nilable(Models::Components::BasicAccessPolicy), request: T.nilable(Models::Operations::DirectUploadVideoMediaRequest), retries: T.nilable(Utils::RetryConfig), timeout_ms: T.nilable(Integer)).returns(Models::Operations::DirectUploadVideoMediaResponse) }
+    def direct_upload_video_media(cors_origin: nil, push_media_settings: nil, metadata: nil, access_policy: nil, request: nil, retries: nil, timeout_ms: nil)
       # direct_upload_video_media - Upload media from device
-      # This endpoint enables you to upload a video file directly from your local device to FastPix for processing, storage. When you invoke this API with your preferred media settings, the response returns an uploadId and a pre-signed URL, providing a streamlined experience for uploading.
-      # 
+      # This endpoint enables accelerated uploads of large media files directly from your local device to FastPix for processing and storage.
       # 
+      # > **PLEASE NOTE**
+      # >
+      # > This version now supports uploads with no file size limitations and offers faster uploads. The previous endpoint (which had a 500MB size limit) is now deprecated. You can find details in the [changelog](https://docs.fastpix.io/changelog/api-update-direct-upload-media-from-device).
       # 
       # #### How it works
       # 
-      # 1. Send a POST request to the /on-demand/uploads endpoint with optional media settings.  
+      # 1. Send a POST request to this endpoint with optional media settings.  
       # 
-      # 2. The response includes an **uploadId** and a pre-signed URL for direct video file upload.
+      # 2. The response includes an `uploadId` and a signed `url` for direct video file upload.
       # 
-      # 3. Upload your video file to the provided **URL** by making **PUT** request. The API accepts the media file from the device and uploads it to the FastPix platform. 
+      # 3. Upload your video file to the provided `url` by making `PUT` request. The API accepts the media file from the device and uploads it to the FastPix platform. 
       # 
-      # 4. Once uploaded, the media undergoes processing and is assigned a unique ID for tracking. Retain this **uploadId** for any future operations related to this upload. 
+      # 4. Once uploaded, the media undergoes processing and is assigned a unique ID for tracking. Retain this `uploadId` for any future operations related to this upload. 
       # 
       # 
       # 
       # 
-      # After uploading, you can use the **Get Media by ID** endpoint to check the status of the uploaded media asset and see if it has transitioned to a "ready" status for playback. 
+      # After uploading, you can use the <a href="https://docs.fastpix.io/reference/get-media">Get Media by ID</a> endpoint to check the status of the uploaded media asset and see if it has transitioned to a `ready` status for playback. 
       # 
-      # To notify your application about the status of this API request check for the webhooks for Upload related events.  
+      # To notify your application about the status of this API request check for the webhooks for <a href="https://docs.fastpix.io/docs/webhooks-collection#media-related-events">media related events</a>.  
       # 
       # 
-      # #### Use case scenario 
+      # #### Example
       # 
-      # **Use case:** A social media platform allows users to upload video content directly from their phones or computers. This endpoint facilitates the upload process. For example, if you are developing a video-sharing app where users can upload short clips from their mobile devices, this endpoint enables them to select a video, upload it to the platform.
+      # A social media platform allows users to upload video content directly from their phones or computers. This endpoint facilitates the upload process. For example, if you are developing a video-sharing app where users can upload short clips from their mobile devices, this endpoint enables them to select a video, upload it to the platform.
       # 
+      # Related guide: <a href="https://docs.fastpix.io/docs/upload-videos-directly">Upload videos directly</a>
+      # 
+      # Create request object if direct parameters are provided
+      if request.nil? && !cors_origin.nil?
+        # Create push_media_settings if metadata or access_policy are provided
+        if push_media_settings.nil? && (metadata || access_policy)
+          push_media_settings = Models::Operations::PushMediaSettings.new(
+            access_policy: access_policy || Models::Components::BasicAccessPolicy::PUBLIC,
+            metadata: metadata
+          )
+        end
+        
+        request = Models::Operations::DirectUploadVideoMediaRequest.new(
+          cors_origin: cors_origin,
+          push_media_settings: push_media_settings
+        )
+      end
+      
       url, params = @sdk_configuration.get_server_details
       base_url = Utils.template_url(url, params)
-      url = "#{base_url}/on-demand/uploads"
+      url = "#{base_url}/on-demand/upload"
       headers = {}
+      headers = T.cast(headers, T::Hash[String, String])
       req_content_type, data, form = Utils.serialize_request_body(request, false, true, :request, :json)
       headers['content-type'] = req_content_type
 
       if form
         body = Utils.encode_form(form)
       elsif Utils.match_content_type(req_content_type, 'application/x-www-form-urlencoded')
-        body = URI.encode_www_form(data)
+        body = URI.encode_www_form(T.cast(data, T::Hash[Symbol, Object]))
       else
         body = data
       end
       headers['Accept'] = 'application/json'
       headers['user-agent'] = @sdk_configuration.user_agent
+      retries ||= @sdk_configuration.retry_config
+      retries ||= Utils::RetryConfig.new(
+        backoff: Utils::BackoffStrategy.new(
+          exponent: 1.5,
+          initial_interval: 1000,
+          max_elapsed_time: 3_600_000,
+          max_interval: 10_000
+        ),
+        retry_connection_errors: true,
+        strategy: 'backoff'
+      )
+      retry_options = retries.to_faraday_retry_options(initial_time: Time.now)
+      retry_options[:retry_statuses] = [408, 429, 500, 502, 503, 504]
 
-      security = !@sdk_configuration.nil? && !@sdk_configuration.security_source.nil? ? @sdk_configuration.security_source.call : nil
+      security = @sdk_configuration.security_source&.call
 
       timeout = (timeout_ms.to_f / 1000) unless timeout_ms.nil?
       timeout ||= @sdk_configuration.timeout
+      
 
-      connection = @sdk_configuration.client
+      connection = @sdk_configuration.client.dup
+      connection.request :retry, retry_options
 
       hook_ctx = SDKHooks::HookContext.new(
         config: @sdk_configuration,
         base_url: base_url,
-        oauth2_scopes: [],
+        oauth2_scopes: nil,
         operation_id: 'direct-upload-video-media',
         security_source: @sdk_configuration.security_source
       )
@@ -324,7 +373,7 @@ module FastpixApiSDK
       
       
       begin
-        http_response = connection.post(url) do |req|
+        http_response = T.must(connection).post(url) do |req|
           req.body = body
           req.headers.merge!(headers)
           req.options.timeout = timeout unless timeout.nil?
@@ -378,7 +427,7 @@ module FastpixApiSDK
             status_code: http_response.status,
             content_type: content_type,
             raw_response: http_response,
-            object: obj
+            object: T.unsafe(obj)
           )
 
           return response
@@ -395,7 +444,8 @@ module FastpixApiSDK
           )
           response_data = http_response.env.response_body
           obj = Crystalline.unmarshal_json(JSON.parse(response_data), Models::Errors::BadRequestError)
-          throw obj
+          obj.raw_response = http_response
+          raise obj
         else
           raise ::FastpixApiSDK::Models::Errors::APIError.new(status_code: http_response.status, body: http_response.env.response_body, raw_response: http_response), 'Unknown content type received'
         end
@@ -409,7 +459,8 @@ module FastpixApiSDK
           )
           response_data = http_response.env.response_body
           obj = Crystalline.unmarshal_json(JSON.parse(response_data), Models::Errors::InvalidPermissionError)
-          throw obj
+          obj.raw_response = http_response
+          raise obj
         else
           raise ::FastpixApiSDK::Models::Errors::APIError.new(status_code: http_response.status, body: http_response.env.response_body, raw_response: http_response), 'Unknown content type received'
         end
@@ -423,7 +474,8 @@ module FastpixApiSDK
           )
           response_data = http_response.env.response_body
           obj = Crystalline.unmarshal_json(JSON.parse(response_data), Models::Errors::ForbiddenError)
-          throw obj
+          obj.raw_response = http_response
+          raise obj
         else
           raise ::FastpixApiSDK::Models::Errors::APIError.new(status_code: http_response.status, body: http_response.env.response_body, raw_response: http_response), 'Unknown content type received'
         end
@@ -437,7 +489,8 @@ module FastpixApiSDK
           )
           response_data = http_response.env.response_body
           obj = Crystalline.unmarshal_json(JSON.parse(response_data), Models::Errors::ValidationErrorResponse)
-          throw obj
+          obj.raw_response = http_response
+          raise obj
         else
           raise ::FastpixApiSDK::Models::Errors::APIError.new(status_code: http_response.status, body: http_response.env.response_body, raw_response: http_response), 'Unknown content type received'
         end