bandwidth-sdk 0.1.0 → 1.0.0.pre

data/lib/bandwidth/voice_lib/bxml/verbs/xml_verb.rb

@@ -0,0 +1,27 @@
+
+module Bandwidth 
+  module Voice 
+    module XmlVerb
+      def initialize(data = nil)
+        @data = (data || {}).clone()
+      end
+
+      def method_missing(name, *args, &block)
+        if name[name.size - 1] == '='
+          @data[name[0..-2].to_sym] = args[0]
+        else
+          @data[name]
+        end
+      end
+
+      def compact_hash(hash)
+        hash.inject({}) do |new_hash, (k,v)|
+          if !v.nil?
+            new_hash[k] = v.class == Hash ? compact_hash(v) : v
+          end
+          new_hash
+        end
+      end
+    end
+  end
+end

data/lib/bandwidth/voice_lib/voice.rb

@@ -1,23 +1,27 @@
-# bandwidth
-#
-# This file was automatically generated by APIMATIC v2.0
-# ( https://apimatic.io ).
-
-
-require_relative 'voice/client.rb'
-
-# Models
-require_relative 'voice/models/api_call_response.rb'
-require_relative 'voice/models/api_create_call_request.rb'
-require_relative 'voice/models/api_modify_call_request.rb'
-require_relative 'voice/models/bandwidth_callback_message_voice.rb'
-require_relative 'voice/models/answer_method_enum.rb'
-require_relative 'voice/models/disconnect_method_enum.rb'
-require_relative 'voice/models/redirect_method_enum.rb'
-require_relative 'voice/models/state_enum.rb'
-
-require_relative 'voice/bxml/bxml.rb'
-
-# Controllers
-require_relative 'voice/controllers/base_controller.rb'
-require_relative 'voice/controllers/calls_controller.rb'
+# bandwidth
+#
+# This file was automatically generated by APIMATIC v2.0
+# ( https://apimatic.io ).
+
+
+require_relative 'voice/client.rb'
+
+# Models
+require_relative 'voice/models/field_error.rb'
+require_relative 'voice/models/api_call_response.rb'
+require_relative 'voice/models/api_create_call_request.rb'
+require_relative 'voice/models/api_modify_call_request.rb'
+require_relative 'voice/models/bandwidth_callback_message_voice.rb'
+require_relative 'voice/models/answer_method_enum.rb'
+require_relative 'voice/models/disconnect_method_enum.rb'
+require_relative 'voice/models/redirect_method_enum.rb'
+require_relative 'voice/models/state_enum.rb'
+
+# Exceptions
+require_relative 'voice/exceptions/bandwidth_exception.rb'
+require_relative 'voice/exceptions/bandwidth_not_found_exception.rb'
+require_relative 'voice/exceptions/bandwidth_rate_limit_error_exception.rb'
+# Controllers
+require_relative 'voice/controllers/base_controller.rb'
+require_relative 'voice/controllers/api_controller.rb'
+require_relative 'bxml/bxml.rb'

data/lib/bandwidth/voice_lib/voice/client.rb

@@ -1,36 +1,40 @@
-# bandwidth
-#
-# This file was automatically generated by APIMATIC v2.0
-# ( https://apimatic.io ).
-
-module Bandwidth
-    module Voice
-      #  bandwidth client class.
-      class Client
-        attr_reader :config
-
-        # Access to calls controller.
-        # @return [CallsController] Returns the controller instance.
-        def calls
-          @calls ||= CallsController.new config
-        end
-
-        def initialize(timeout: 60, max_retries: 0, retry_interval: 1,
-                       backoff_factor: 1, environment: Environment::PRODUCTION,
-                       voice_basic_auth_user_name: 'TODO: Replace',
-                       voice_basic_auth_password: 'TODO: Replace', config: nil)
-          @config = if config.nil?
-                      Configuration.new(timeout: timeout,
-                                        max_retries: max_retries,
-                                        retry_interval: retry_interval,
-                                        backoff_factor: backoff_factor,
-                                        environment: environment,
-                                        voice_basic_auth_user_name: voice_basic_auth_user_name,
-                                        voice_basic_auth_password: voice_basic_auth_password)
-                    else
-                      config
-                    end
-        end
-  end
-end
-end
+# bandwidth
+#
+# This file was automatically generated by APIMATIC v2.0
+# ( https://apimatic.io ).
+
+module Bandwidth
+    module Voice
+      #  bandwidth client class.
+      class Client
+        attr_reader :config
+
+        # Access to client controller.
+        # @return [APIController] Returns the controller instance.
+        def client
+          @client ||= APIController.new config
+        end
+
+        def initialize(timeout: 0, max_retries: 0, retry_interval: 1,
+                       backoff_factor: 1, environment: Environment::PRODUCTION,
+                       messaging_basic_auth_user_name: 'TODO: Replace',
+                       messaging_basic_auth_password: 'TODO: Replace',
+                       voice_basic_auth_user_name: 'TODO: Replace',
+                       voice_basic_auth_password: 'TODO: Replace', config: nil)
+          @config = if config.nil?
+                      Configuration.new(timeout: timeout,
+                                        max_retries: max_retries,
+                                        retry_interval: retry_interval,
+                                        backoff_factor: backoff_factor,
+                                        environment: environment,
+                                        messaging_basic_auth_user_name: messaging_basic_auth_user_name,
+                                        messaging_basic_auth_password: messaging_basic_auth_password,
+                                        voice_basic_auth_user_name: voice_basic_auth_user_name,
+                                        voice_basic_auth_password: voice_basic_auth_password)
+                    else
+                      config
+                    end
+        end
+  end
+end
+end

data/lib/bandwidth/voice_lib/voice/controllers/api_controller.rb

@@ -0,0 +1,184 @@
+# bandwidth
+#
+# This file was automatically generated by APIMATIC v2.0
+# ( https://apimatic.io ).
+
+module Bandwidth
+module Voice
+  # APIController
+  class APIController < BaseController
+    def initialize(config, http_call_back: nil)
+      super(config, http_call_back: http_call_back)
+    end
+
+    # Creates a call request
+    # @param [String] account_id Required parameter: Example:
+    # @param [ApiCreateCallRequest] body Optional parameter: Example:
+    # @return [ApiCallResponse] response from the API call
+    def create_call(account_id,
+                    body: nil)
+      # Prepare query url.
+      _query_builder = config.get_base_uri(Server::VOICEDEFAULT)
+      _query_builder << '/accounts/{accountId}/calls'
+      _query_builder = APIHelper.append_url_with_template_parameters(
+        _query_builder,
+        'accountId' => account_id
+      )
+      _query_url = APIHelper.clean_url _query_builder
+
+      # Prepare headers.
+      _headers = {
+        'accept' => 'application/json',
+        'content-type' => 'application/json; charset=utf-8'
+      }
+
+      # Prepare and execute HttpRequest.
+      _request = config.http_client.post(
+        _query_url,
+        headers: _headers,
+        parameters: body.to_json
+      )
+      VoiceBasicAuth.apply(config, _request)
+      _response = execute_request(_request)
+
+      # Validate response against endpoint and global error codes.
+      if _response.status_code == 400
+        raise BandwidthException.new(
+          '400 request is malformed or invalid',
+          _response
+        )
+      elsif _response.status_code == 401
+        raise BandwidthException.new(
+          '401 The specified user does not have access to the account',
+          _response
+        )
+      elsif _response.status_code == 403
+        raise BandwidthException.new(
+          '403  The user does not have access to the API',
+          _response
+        )
+      elsif _response.status_code == 404
+        raise BandwidthNotFoundException.new(
+          '404 he call-id is no longer active, or the path is not found',
+          _response
+        )
+      elsif _response.status_code == 409
+        raise BandwidthException.new(
+          '409 Error when modifying a call that is unable to be modified',
+          _response
+        )
+      elsif _response.status_code == 415
+        raise BandwidthException.new(
+          '415 The content-type of the request is incorrect',
+          _response
+        )
+      elsif _response.status_code == 429
+        raise BandwidthRateLimitErrorException.new(
+          '429 The rate limit has been reached',
+          _response
+        )
+      elsif _response.status_code == 500
+        raise BandwidthException.new(
+          '500 Unknown server error',
+          _response
+        )
+      elsif _response.status_code == 503
+        raise BandwidthException.new(
+          '503 The service is unavailable for some reason',
+          _response
+        )
+      end
+      validate_response(_response)
+
+      # Return appropriate response type.
+      decoded = APIHelper.json_deserialize(_response.raw_body)
+      ApiResponse.new(_response, data: ApiCallResponse.from_hash(decoded))
+    end
+
+    # Creates a call request
+    # @param [String] account_id Required parameter: Example:
+    # @param [String] call_id Required parameter: Example:
+    # @param [ApiModifyCallRequest] body Optional parameter: Example:
+    # @return [void] response from the API call
+    def modify_call(account_id,
+                    call_id,
+                    body: nil)
+      # Prepare query url.
+      _query_builder = config.get_base_uri(Server::VOICEDEFAULT)
+      _query_builder << '/accounts/{accountId}/calls/{callId}'
+      _query_builder = APIHelper.append_url_with_template_parameters(
+        _query_builder,
+        'accountId' => account_id,
+        'callId' => call_id
+      )
+      _query_url = APIHelper.clean_url _query_builder
+
+      # Prepare headers.
+      _headers = {
+        'content-type' => 'application/json; charset=utf-8'
+      }
+
+      # Prepare and execute HttpRequest.
+      _request = config.http_client.post(
+        _query_url,
+        headers: _headers,
+        parameters: body.to_json
+      )
+      VoiceBasicAuth.apply(config, _request)
+      _response = execute_request(_request)
+
+      # Validate response against endpoint and global error codes.
+      if _response.status_code == 400
+        raise BandwidthException.new(
+          '400 request is malformed or invalid',
+          _response
+        )
+      elsif _response.status_code == 401
+        raise BandwidthException.new(
+          '401 The specified user does not have access to the account',
+          _response
+        )
+      elsif _response.status_code == 403
+        raise BandwidthException.new(
+          '403  The user does not have access to the API',
+          _response
+        )
+      elsif _response.status_code == 404
+        raise BandwidthNotFoundException.new(
+          '404 he call-id is no longer active, or the path is not found',
+          _response
+        )
+      elsif _response.status_code == 409
+        raise BandwidthException.new(
+          '409 Error when modifying a call that is unable to be modified',
+          _response
+        )
+      elsif _response.status_code == 415
+        raise BandwidthException.new(
+          '415 The content-type of the request is incorrect',
+          _response
+        )
+      elsif _response.status_code == 429
+        raise BandwidthRateLimitErrorException.new(
+          '429 The rate limit has been reached',
+          _response
+        )
+      elsif _response.status_code == 500
+        raise BandwidthException.new(
+          '500 Unknown server error',
+          _response
+        )
+      elsif _response.status_code == 503
+        raise BandwidthException.new(
+          '503 The service is unavailable for some reason',
+          _response
+        )
+      end
+      validate_response(_response)
+
+      # Return appropriate response type.
+      ApiResponse.new(_response)
+    end
+  end
+end
+end

data/lib/bandwidth/voice_lib/voice/controllers/base_controller.rb

@@ -1,49 +1,49 @@
-# bandwidth
-#
-# This file was automatically generated by APIMATIC v2.0
-# ( https://apimatic.io ).
-
-module Bandwidth
-  # BaseController.
-  class BaseController
-    attr_accessor :config, :http_call_back
-
-    def initialize(config, http_call_back: nil)
-      @config = config
-      @http_call_back = http_call_back
-
-      @global_headers = {
-        'user-agent' => 'APIMATIC 2.0'
-      }
-    end
-
-    def validate_parameters(args)
-      args.each do |_name, value|
-        if value.nil?
-          raise ArgumentError, "Required parameter #{_name} cannot be nil."
-        end
-      end
-    end
-
-    def execute_request(request, binary: false)
-      @http_call_back.on_before_request(request) if @http_call_back
-
-      APIHelper.clean_hash(request.headers)
-      request.headers = @global_headers.clone.merge(request.headers)
-
-      response = if binary
-                   config.http_client.execute_as_binary(request)
-                 else
-                   config.http_client.execute_as_string(request)
-                 end
-      @http_call_back.on_after_response(response) if @http_call_back
-
-      response
-    end
-
-    def validate_response(response)
-      raise APIException.new 'HTTP Response Not OK', response unless
-        response.status_code.between?(200, 208) # [200,208] = HTTP OK
-    end
-  end
-end
+# bandwidth
+#
+# This file was automatically generated by APIMATIC v2.0
+# ( https://apimatic.io ).
+
+module Bandwidth
+  # BaseController.
+  class BaseController
+    attr_accessor :config, :http_call_back
+
+    def initialize(config, http_call_back: nil)
+      @config = config
+      @http_call_back = http_call_back
+
+      @global_headers = {
+        'user-agent' => 'APIMATIC 2.0'
+      }
+    end
+
+    def validate_parameters(args)
+      args.each do |_name, value|
+        if value.nil?
+          raise ArgumentError, "Required parameter #{_name} cannot be nil."
+        end
+      end
+    end
+
+    def execute_request(request, binary: false)
+      @http_call_back.on_before_request(request) if @http_call_back
+
+      APIHelper.clean_hash(request.headers)
+      request.headers = @global_headers.clone.merge(request.headers)
+
+      response = if binary
+                   config.http_client.execute_as_binary(request)
+                 else
+                   config.http_client.execute_as_string(request)
+                 end
+      @http_call_back.on_after_response(response) if @http_call_back
+
+      response
+    end
+
+    def validate_response(response)
+      raise APIException.new 'HTTP Response Not OK', response unless
+        response.status_code.between?(200, 208) # [200,208] = HTTP OK
+    end
+  end
+end

data/lib/bandwidth/voice_lib/voice/exceptions/bandwidth_exception.rb

@@ -0,0 +1,51 @@
+# bandwidth
+#
+# This file was automatically generated by APIMATIC v2.0
+# ( https://apimatic.io ).
+
+module Bandwidth
+  # BandwidthException class.
+  class BandwidthException < APIException
+    # TODO: Write general description for this method
+    # @return [String]
+    attr_accessor :type
+
+    # TODO: Write general description for this method
+    # @return [String]
+    attr_accessor :description
+
+    # TODO: Write general description for this method
+    # @return [String]
+    attr_accessor :id
+
+    # TODO: Write general description for this method
+    # @return [List of FieldError]
+    attr_accessor :field_errors
+
+    # The constructor.
+    # @param [String] The reason for raising an exception.
+    # @param [HttpResponse] The HttpReponse of the API call.
+    def initialize(reason, response)
+      super(reason, response)
+      hash = APIHelper.json_deserialize(@response.raw_body)
+      unbox(hash)
+    end
+
+    # Populates this object by extracting properties from a hash.
+    # @param [Hash] The deserialized response sent by the server in the
+    # response body.
+    def unbox(hash)
+      @type = hash['type']
+      @description = hash['description']
+      @id = hash['id']
+      # Parameter is an array, so we need to iterate through it
+      @field_errors = nil
+      unless hash['fieldErrors'].nil?
+        @field_errors = []
+        hash['fieldErrors'].each do |structure|
+          @field_errors << (FieldError.from_hash(structure) if structure)
+        end
+      end
+    end
+  end
+end