fastpixapi 1.1.2 → 1.1.3

data/lib/fastpix_client/simulcast_stream.rb

@@ -14,6 +14,58 @@ module FastpixClient
   extend T::Sig
   class SimulcastStream
     extend T::Sig
+
+    API_ERROR_OCCURRED = 'API error occurred'
+    CONTENT_TYPE_HEADER = 'Content-Type'
+    CONTENT_TYPE_JSON = 'application/json'
+    DEFAULT_CONTENT_TYPE = 'application/octet-stream'
+    SIMULCAST_PATH = '/live/streams/{streamId}/simulcast/{simulcastId}'
+    UNKNOWN_CONTENT_TYPE_ERROR = 'Unknown content type received'
+    USER_AGENT_HEADER = 'user-agent'
+
+    # Applies the SDK after-request hooks and ensures a usable response is present.
+    sig { params(http_response: T.nilable(Faraday::Response), error: T.nilable(StandardError), hook_ctx: SDKHooks::HookContext).returns(Faraday::Response) }
+    def apply_after_request_hooks(http_response, error, hook_ctx)
+      if http_response.nil? || Utils.error_status?(http_response.status)
+        http_response = @sdk_configuration.hooks.after_error(
+          error: error,
+          hook_ctx: SDKHooks::AfterErrorHookContext.new(
+            hook_ctx: hook_ctx
+          ),
+          response: http_response
+        )
+      else
+        http_response = @sdk_configuration.hooks.after_success(
+          hook_ctx: SDKHooks::AfterSuccessHookContext.new(
+            hook_ctx: hook_ctx
+          ),
+          response: http_response
+        )
+      end
+
+      if http_response.nil?
+        raise error unless error.nil?
+        raise ::FastpixClient::Models::Errors::EmptyResponseError, 'no response'
+      end
+
+      http_response
+    end
+    private :apply_after_request_hooks
+
+    # Encodes the request body based on its serialized content type.
+    sig { params(req_content_type: T.nilable(String), data: T.untyped, form: T.untyped).returns(T.untyped) }
+    def encode_request_body(req_content_type, data, form)
+      raise ArgumentError, 'request body is required' if data.nil? && form.nil?
+
+      if form
+        Utils.encode_form(form)
+      elsif Utils.match_content_type(req_content_type, 'application/x-www-form-urlencoded')
+        URI.encode_www_form(T.cast(data, T::Hash[Symbol, Object]))
+      else
+        data
+      end
+    end
+    private :encode_request_body
     
     # Operations for simulcast stream management
 
@@ -69,17 +121,9 @@ module FastpixClient
       headers = T.cast(headers, T::Hash[String, String])
       req_content_type, data, form = Utils.serialize_request_body(request, false, false, :body, :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(T.cast(data, T::Hash[Symbol, Object]))
-      else
-        body = data
-      end
-      headers['Accept'] = 'application/json'
-      headers['user-agent'] = @sdk_configuration.user_agent
+      body = encode_request_body(req_content_type, data, form)
+      headers['Accept'] = CONTENT_TYPE_JSON
+      headers[USER_AGENT_HEADER] = @sdk_configuration.user_agent
 
       security = @sdk_configuration.security_source&.call
 
@@ -118,32 +162,12 @@ module FastpixClient
       rescue StandardError => e
         error = e
       ensure
-        if http_response.nil? || Utils.error_status?(http_response.status)
-          http_response = @sdk_configuration.hooks.after_error(
-            error: error,
-            hook_ctx: SDKHooks::AfterErrorHookContext.new(
-              hook_ctx: hook_ctx
-            ),
-            response: http_response
-          )
-        else
-          http_response = @sdk_configuration.hooks.after_success(
-            hook_ctx: SDKHooks::AfterSuccessHookContext.new(
-              hook_ctx: hook_ctx
-            ),
-            response: http_response
-          )
-        end
-        
-        if http_response.nil?
-          raise error if !error.nil?
-          raise 'no response'
-        end
+        http_response = apply_after_request_hooks(http_response, error, hook_ctx)
       end
       
-      content_type = http_response.headers.fetch('Content-Type', 'application/octet-stream')
+      content_type = http_response.headers.fetch(CONTENT_TYPE_HEADER, DEFAULT_CONTENT_TYPE)
       if Utils.match_status_code(http_response.status, ['201'])
-        if Utils.match_content_type(content_type, 'application/json')
+        if Utils.match_content_type(content_type, CONTENT_TYPE_JSON)
           http_response = @sdk_configuration.hooks.after_success(
             hook_ctx: SDKHooks::AfterSuccessHookContext.new(
               hook_ctx: hook_ctx
@@ -161,14 +185,14 @@ module FastpixClient
 
           return response
         else
-          raise ::FastpixClient::Models::Errors::APIError.new(status_code: http_response.status, body: http_response.env.response_body, raw_response: http_response), 'Unknown content type received'
+          raise ::FastpixClient::Models::Errors::APIError.new(status_code: http_response.status, body: http_response.env.response_body, raw_response: http_response), UNKNOWN_CONTENT_TYPE_ERROR
         end
       elsif Utils.match_status_code(http_response.status, ['4XX'])
-        raise ::FastpixClient::Models::Errors::APIError.new(status_code: http_response.status, body: http_response.env.response_body, raw_response: http_response), 'API error occurred'
+        raise ::FastpixClient::Models::Errors::APIError.new(status_code: http_response.status, body: http_response.env.response_body, raw_response: http_response), API_ERROR_OCCURRED
       elsif Utils.match_status_code(http_response.status, ['5XX'])
-        raise ::FastpixClient::Models::Errors::APIError.new(status_code: http_response.status, body: http_response.env.response_body, raw_response: http_response), 'API error occurred'
+        raise ::FastpixClient::Models::Errors::APIError.new(status_code: http_response.status, body: http_response.env.response_body, raw_response: http_response), API_ERROR_OCCURRED
       else
-        if Utils.match_content_type(content_type, 'application/json')
+        if Utils.match_content_type(content_type, CONTENT_TYPE_JSON)
           http_response = @sdk_configuration.hooks.after_success(
             hook_ctx: SDKHooks::AfterSuccessHookContext.new(
               hook_ctx: hook_ctx
@@ -186,7 +210,7 @@ module FastpixClient
 
           return response
         else
-          raise ::FastpixClient::Models::Errors::APIError.new(status_code: http_response.status, body: http_response.env.response_body, raw_response: http_response), 'Unknown content type received'
+          raise ::FastpixClient::Models::Errors::APIError.new(status_code: http_response.status, body: http_response.env.response_body, raw_response: http_response), UNKNOWN_CONTENT_TYPE_ERROR
         end
       end
     end
@@ -211,13 +235,13 @@ module FastpixClient
       url = Utils.generate_url(
         Models::Operations::DeleteSimulcastOfStreamRequest,
         base_url,
-        '/live/streams/{streamId}/simulcast/{simulcastId}',
+        SIMULCAST_PATH,
         request
       )
       headers = {}
       headers = T.cast(headers, T::Hash[String, String])
-      headers['Accept'] = 'application/json'
-      headers['user-agent'] = @sdk_configuration.user_agent
+      headers['Accept'] = CONTENT_TYPE_JSON
+      headers[USER_AGENT_HEADER] = @sdk_configuration.user_agent
 
       security = @sdk_configuration.security_source&.call
 
@@ -255,32 +279,12 @@ module FastpixClient
       rescue StandardError => e
         error = e
       ensure
-        if http_response.nil? || Utils.error_status?(http_response.status)
-          http_response = @sdk_configuration.hooks.after_error(
-            error: error,
-            hook_ctx: SDKHooks::AfterErrorHookContext.new(
-              hook_ctx: hook_ctx
-            ),
-            response: http_response
-          )
-        else
-          http_response = @sdk_configuration.hooks.after_success(
-            hook_ctx: SDKHooks::AfterSuccessHookContext.new(
-              hook_ctx: hook_ctx
-            ),
-            response: http_response
-          )
-        end
-        
-        if http_response.nil?
-          raise error if !error.nil?
-          raise 'no response'
-        end
+        http_response = apply_after_request_hooks(http_response, error, hook_ctx)
       end
       
-      content_type = http_response.headers.fetch('Content-Type', 'application/octet-stream')
+      content_type = http_response.headers.fetch(CONTENT_TYPE_HEADER, DEFAULT_CONTENT_TYPE)
       if Utils.match_status_code(http_response.status, ['200'])
-        if Utils.match_content_type(content_type, 'application/json')
+        if Utils.match_content_type(content_type, CONTENT_TYPE_JSON)
           http_response = @sdk_configuration.hooks.after_success(
             hook_ctx: SDKHooks::AfterSuccessHookContext.new(
               hook_ctx: hook_ctx
@@ -298,14 +302,14 @@ module FastpixClient
 
           return response
         else
-          raise ::FastpixClient::Models::Errors::APIError.new(status_code: http_response.status, body: http_response.env.response_body, raw_response: http_response), 'Unknown content type received'
+          raise ::FastpixClient::Models::Errors::APIError.new(status_code: http_response.status, body: http_response.env.response_body, raw_response: http_response), UNKNOWN_CONTENT_TYPE_ERROR
         end
       elsif Utils.match_status_code(http_response.status, ['4XX'])
-        raise ::FastpixClient::Models::Errors::APIError.new(status_code: http_response.status, body: http_response.env.response_body, raw_response: http_response), 'API error occurred'
+        raise ::FastpixClient::Models::Errors::APIError.new(status_code: http_response.status, body: http_response.env.response_body, raw_response: http_response), API_ERROR_OCCURRED
       elsif Utils.match_status_code(http_response.status, ['5XX'])
-        raise ::FastpixClient::Models::Errors::APIError.new(status_code: http_response.status, body: http_response.env.response_body, raw_response: http_response), 'API error occurred'
+        raise ::FastpixClient::Models::Errors::APIError.new(status_code: http_response.status, body: http_response.env.response_body, raw_response: http_response), API_ERROR_OCCURRED
       else
-        if Utils.match_content_type(content_type, 'application/json')
+        if Utils.match_content_type(content_type, CONTENT_TYPE_JSON)
           http_response = @sdk_configuration.hooks.after_success(
             hook_ctx: SDKHooks::AfterSuccessHookContext.new(
               hook_ctx: hook_ctx
@@ -323,7 +327,7 @@ module FastpixClient
 
           return response
         else
-          raise ::FastpixClient::Models::Errors::APIError.new(status_code: http_response.status, body: http_response.env.response_body, raw_response: http_response), 'Unknown content type received'
+          raise ::FastpixClient::Models::Errors::APIError.new(status_code: http_response.status, body: http_response.env.response_body, raw_response: http_response), UNKNOWN_CONTENT_TYPE_ERROR
         end
       end
     end
@@ -345,13 +349,13 @@ module FastpixClient
       url = Utils.generate_url(
         Models::Operations::GetSpecificSimulcastOfStreamRequest,
         base_url,
-        '/live/streams/{streamId}/simulcast/{simulcastId}',
+        SIMULCAST_PATH,
         request
       )
       headers = {}
       headers = T.cast(headers, T::Hash[String, String])
-      headers['Accept'] = 'application/json'
-      headers['user-agent'] = @sdk_configuration.user_agent
+      headers['Accept'] = CONTENT_TYPE_JSON
+      headers[USER_AGENT_HEADER] = @sdk_configuration.user_agent
 
       security = @sdk_configuration.security_source&.call
 
@@ -389,32 +393,12 @@ module FastpixClient
       rescue StandardError => e
         error = e
       ensure
-        if http_response.nil? || Utils.error_status?(http_response.status)
-          http_response = @sdk_configuration.hooks.after_error(
-            error: error,
-            hook_ctx: SDKHooks::AfterErrorHookContext.new(
-              hook_ctx: hook_ctx
-            ),
-            response: http_response
-          )
-        else
-          http_response = @sdk_configuration.hooks.after_success(
-            hook_ctx: SDKHooks::AfterSuccessHookContext.new(
-              hook_ctx: hook_ctx
-            ),
-            response: http_response
-          )
-        end
-        
-        if http_response.nil?
-          raise error if !error.nil?
-          raise 'no response'
-        end
+        http_response = apply_after_request_hooks(http_response, error, hook_ctx)
       end
       
-      content_type = http_response.headers.fetch('Content-Type', 'application/octet-stream')
+      content_type = http_response.headers.fetch(CONTENT_TYPE_HEADER, DEFAULT_CONTENT_TYPE)
       if Utils.match_status_code(http_response.status, ['200'])
-        if Utils.match_content_type(content_type, 'application/json')
+        if Utils.match_content_type(content_type, CONTENT_TYPE_JSON)
           http_response = @sdk_configuration.hooks.after_success(
             hook_ctx: SDKHooks::AfterSuccessHookContext.new(
               hook_ctx: hook_ctx
@@ -432,14 +416,14 @@ module FastpixClient
 
           return response
         else
-          raise ::FastpixClient::Models::Errors::APIError.new(status_code: http_response.status, body: http_response.env.response_body, raw_response: http_response), 'Unknown content type received'
+          raise ::FastpixClient::Models::Errors::APIError.new(status_code: http_response.status, body: http_response.env.response_body, raw_response: http_response), UNKNOWN_CONTENT_TYPE_ERROR
         end
       elsif Utils.match_status_code(http_response.status, ['4XX'])
-        raise ::FastpixClient::Models::Errors::APIError.new(status_code: http_response.status, body: http_response.env.response_body, raw_response: http_response), 'API error occurred'
+        raise ::FastpixClient::Models::Errors::APIError.new(status_code: http_response.status, body: http_response.env.response_body, raw_response: http_response), API_ERROR_OCCURRED
       elsif Utils.match_status_code(http_response.status, ['5XX'])
-        raise ::FastpixClient::Models::Errors::APIError.new(status_code: http_response.status, body: http_response.env.response_body, raw_response: http_response), 'API error occurred'
+        raise ::FastpixClient::Models::Errors::APIError.new(status_code: http_response.status, body: http_response.env.response_body, raw_response: http_response), API_ERROR_OCCURRED
       else
-        if Utils.match_content_type(content_type, 'application/json')
+        if Utils.match_content_type(content_type, CONTENT_TYPE_JSON)
           http_response = @sdk_configuration.hooks.after_success(
             hook_ctx: SDKHooks::AfterSuccessHookContext.new(
               hook_ctx: hook_ctx
@@ -457,7 +441,7 @@ module FastpixClient
 
           return response
         else
-          raise ::FastpixClient::Models::Errors::APIError.new(status_code: http_response.status, body: http_response.env.response_body, raw_response: http_response), 'Unknown content type received'
+          raise ::FastpixClient::Models::Errors::APIError.new(status_code: http_response.status, body: http_response.env.response_body, raw_response: http_response), UNKNOWN_CONTENT_TYPE_ERROR
         end
       end
     end
@@ -482,24 +466,16 @@ module FastpixClient
       url = Utils.generate_url(
         Models::Operations::UpdateSpecificSimulcastOfStreamRequest,
         base_url,
-        '/live/streams/{streamId}/simulcast/{simulcastId}',
+        SIMULCAST_PATH,
         request
       )
       headers = {}
       headers = T.cast(headers, T::Hash[String, String])
       req_content_type, data, form = Utils.serialize_request_body(request, false, false, :body, :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(T.cast(data, T::Hash[Symbol, Object]))
-      else
-        body = data
-      end
-      headers['Accept'] = 'application/json'
-      headers['user-agent'] = @sdk_configuration.user_agent
+      body = encode_request_body(req_content_type, data, form)
+      headers['Accept'] = CONTENT_TYPE_JSON
+      headers[USER_AGENT_HEADER] = @sdk_configuration.user_agent
 
       security = @sdk_configuration.security_source&.call
 
@@ -538,32 +514,12 @@ module FastpixClient
       rescue StandardError => e
         error = e
       ensure
-        if http_response.nil? || Utils.error_status?(http_response.status)
-          http_response = @sdk_configuration.hooks.after_error(
-            error: error,
-            hook_ctx: SDKHooks::AfterErrorHookContext.new(
-              hook_ctx: hook_ctx
-            ),
-            response: http_response
-          )
-        else
-          http_response = @sdk_configuration.hooks.after_success(
-            hook_ctx: SDKHooks::AfterSuccessHookContext.new(
-              hook_ctx: hook_ctx
-            ),
-            response: http_response
-          )
-        end
-        
-        if http_response.nil?
-          raise error if !error.nil?
-          raise 'no response'
-        end
+        http_response = apply_after_request_hooks(http_response, error, hook_ctx)
       end
       
-      content_type = http_response.headers.fetch('Content-Type', 'application/octet-stream')
+      content_type = http_response.headers.fetch(CONTENT_TYPE_HEADER, DEFAULT_CONTENT_TYPE)
       if Utils.match_status_code(http_response.status, ['200'])
-        if Utils.match_content_type(content_type, 'application/json')
+        if Utils.match_content_type(content_type, CONTENT_TYPE_JSON)
           http_response = @sdk_configuration.hooks.after_success(
             hook_ctx: SDKHooks::AfterSuccessHookContext.new(
               hook_ctx: hook_ctx
@@ -581,14 +537,14 @@ module FastpixClient
 
           return response
         else
-          raise ::FastpixClient::Models::Errors::APIError.new(status_code: http_response.status, body: http_response.env.response_body, raw_response: http_response), 'Unknown content type received'
+          raise ::FastpixClient::Models::Errors::APIError.new(status_code: http_response.status, body: http_response.env.response_body, raw_response: http_response), UNKNOWN_CONTENT_TYPE_ERROR
         end
       elsif Utils.match_status_code(http_response.status, ['4XX'])
-        raise ::FastpixClient::Models::Errors::APIError.new(status_code: http_response.status, body: http_response.env.response_body, raw_response: http_response), 'API error occurred'
+        raise ::FastpixClient::Models::Errors::APIError.new(status_code: http_response.status, body: http_response.env.response_body, raw_response: http_response), API_ERROR_OCCURRED
       elsif Utils.match_status_code(http_response.status, ['5XX'])
-        raise ::FastpixClient::Models::Errors::APIError.new(status_code: http_response.status, body: http_response.env.response_body, raw_response: http_response), 'API error occurred'
+        raise ::FastpixClient::Models::Errors::APIError.new(status_code: http_response.status, body: http_response.env.response_body, raw_response: http_response), API_ERROR_OCCURRED
       else
-        if Utils.match_content_type(content_type, 'application/json')
+        if Utils.match_content_type(content_type, CONTENT_TYPE_JSON)
           http_response = @sdk_configuration.hooks.after_success(
             hook_ctx: SDKHooks::AfterSuccessHookContext.new(
               hook_ctx: hook_ctx
@@ -606,7 +562,7 @@ module FastpixClient
 
           return response
         else
-          raise ::FastpixClient::Models::Errors::APIError.new(status_code: http_response.status, body: http_response.env.response_body, raw_response: http_response), 'Unknown content type received'
+          raise ::FastpixClient::Models::Errors::APIError.new(status_code: http_response.status, body: http_response.env.response_body, raw_response: http_response), UNKNOWN_CONTENT_TYPE_ERROR
         end
       end
     end

data/lib/fastpix_client/start_live_stream.rb

@@ -14,6 +14,52 @@ module FastpixClient
   extend T::Sig
   class StartLiveStream
     extend T::Sig
+
+    CONTENT_TYPE_JSON = 'application/json'
+
+    # Applies the SDK after-request hooks and ensures a usable response is present.
+    sig { params(http_response: T.nilable(Faraday::Response), error: T.nilable(StandardError), hook_ctx: SDKHooks::HookContext).returns(Faraday::Response) }
+    def apply_after_request_hooks(http_response, error, hook_ctx)
+      if http_response.nil? || Utils.error_status?(http_response.status)
+        http_response = @sdk_configuration.hooks.after_error(
+          error: error,
+          hook_ctx: SDKHooks::AfterErrorHookContext.new(
+            hook_ctx: hook_ctx
+          ),
+          response: http_response
+        )
+      else
+        http_response = @sdk_configuration.hooks.after_success(
+          hook_ctx: SDKHooks::AfterSuccessHookContext.new(
+            hook_ctx: hook_ctx
+          ),
+          response: http_response
+        )
+      end
+
+      if http_response.nil?
+        raise error unless error.nil?
+        raise ::FastpixClient::Models::Errors::EmptyResponseError, 'no response'
+      end
+
+      http_response
+    end
+    private :apply_after_request_hooks
+
+    # Encodes the request body based on its serialized content type.
+    sig { params(req_content_type: T.nilable(String), data: T.untyped, form: T.untyped).returns(T.untyped) }
+    def encode_request_body(req_content_type, data, form)
+      raise ArgumentError, 'request body is required' if data.nil? && form.nil?
+
+      if form
+        Utils.encode_form(form)
+      elsif Utils.match_content_type(req_content_type, 'application/x-www-form-urlencoded')
+        URI.encode_www_form(T.cast(data, T::Hash[Symbol, Object]))
+      else
+        data
+      end
+    end
+    private :encode_request_body
     
     # Operations for starting live streams
 
@@ -69,16 +115,8 @@ module FastpixClient
       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(T.cast(data, T::Hash[Symbol, Object]))
-      else
-        body = data
-      end
-      headers['Accept'] = 'application/json'
+      body = encode_request_body(req_content_type, data, form)
+      headers['Accept'] = CONTENT_TYPE_JSON
       headers['user-agent'] = @sdk_configuration.user_agent
 
       security = @sdk_configuration.security_source&.call
@@ -118,32 +156,12 @@ module FastpixClient
       rescue StandardError => e
         error = e
       ensure
-        if http_response.nil? || Utils.error_status?(http_response.status)
-          http_response = @sdk_configuration.hooks.after_error(
-            error: error,
-            hook_ctx: SDKHooks::AfterErrorHookContext.new(
-              hook_ctx: hook_ctx
-            ),
-            response: http_response
-          )
-        else
-          http_response = @sdk_configuration.hooks.after_success(
-            hook_ctx: SDKHooks::AfterSuccessHookContext.new(
-              hook_ctx: hook_ctx
-            ),
-            response: http_response
-          )
-        end
-        
-        if http_response.nil?
-          raise error if !error.nil?
-          raise 'no response'
-        end
+        http_response = apply_after_request_hooks(http_response, error, hook_ctx)
       end
       
       content_type = http_response.headers.fetch('Content-Type', 'application/octet-stream')
       if Utils.match_status_code(http_response.status, ['201'])
-        if Utils.match_content_type(content_type, 'application/json')
+        if Utils.match_content_type(content_type, CONTENT_TYPE_JSON)
           http_response = @sdk_configuration.hooks.after_success(
             hook_ctx: SDKHooks::AfterSuccessHookContext.new(
               hook_ctx: hook_ctx
@@ -168,7 +186,7 @@ module FastpixClient
       elsif Utils.match_status_code(http_response.status, ['5XX'])
         raise ::FastpixClient::Models::Errors::APIError.new(status_code: http_response.status, body: http_response.env.response_body, raw_response: http_response), 'API error occurred'
       else
-        if Utils.match_content_type(content_type, 'application/json')
+        if Utils.match_content_type(content_type, CONTENT_TYPE_JSON)
           http_response = @sdk_configuration.hooks.after_success(
             hook_ctx: SDKHooks::AfterSuccessHookContext.new(
               hook_ctx: hook_ctx