bandwidth-sdk 3.13.2 → 6.2.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 7336e9d451418630a0a7114a1f5e6d7ca929a7069afe71d5a81c96d3580f6ded
-  data.tar.gz: e4da49bb09e35ab947352c4d0b92ee6a970450ed9aec84b89bfcbf31b079791a
+  metadata.gz: 5539a17ccb877e0e80a53959cbbc354314c0300c3c3ce1e90de0c4b5eae9f18a
+  data.tar.gz: 1f0466592184f21361287991b49a596c46d5de6f34dca9b727884f077591bf72
 SHA512:
-  metadata.gz: ea2a492118247060435f24d8d1fdc5421293b4abcb4d321495b25dc5be178eab4b5b58a22f49363f5b254719a357bbb8a2def4cb412f00ce9633ddb1be05e792
-  data.tar.gz: 79588ec737914f87a947b957b9e5a8f06335ba82d86fbe0eff55289df3109f21b6f55f33208cfe36fa6d491c63b31885fe910e98b21b72d5b37044cbf775ab9e
+  metadata.gz: fd6452d48d8a62e0bce5fb173132aac42f52918632c696e4153bfedc6d3c6db9769ab2941c0031d5c70b4ed245d35f0bee4929c54a6511441ad60e59c77c1fb5
+  data.tar.gz: 677a0c3e526b2d0f90d4d7905f7b914ce44f8d7a8eee47760693682da200c441cd476030a5e051dc87fdb716aea287d0184584d3c91691cb636ed49ecdaa07be

data/LICENSE

@@ -3,7 +3,7 @@ License:
 The MIT License (MIT)
 http://opensource.org/licenses/MIT
 
-Copyright (c) 2014 - 2016 APIMATIC Limited
+Copyright (c) 2014 - 2020 APIMATIC Limited
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal

data/README.md

@@ -1,16 +1,14 @@
 # Bandwidth Ruby SDK
-  
-Bandwidth's API docs can be found at https://dev.bandwidth.com
 
-Ruby specific docs can be found at https://dev.bandwidth.com/sdks/ruby.html
+## Getting Started
 
-## Download & Install
+### Installation
 
 ```
 gem install bandwidth-sdk
 ```
 
-## Initialize Bandwidth Client
+### Initialize
 
 ```ruby
 require 'bandwidth'
@@ -18,21 +16,27 @@ require 'bandwidth'
 include Bandwidth
 include Bandwidth::Voice
 include Bandwidth::Messaging
+include Bandwidth::WebRtc
+include Bandwidth::TwoFactorAuth
 
 bandwidth_client = Bandwidth::Client.new(
     voice_basic_auth_user_name: 'username',
     voice_basic_auth_password: 'password',
-    messaging_basic_auth_user_name: 'token',
-    messaging_basic_auth_password: 'secret',
+    messaging_basic_auth_user_name: 'username',
+    messaging_basic_auth_password: 'username',
+    two_factor_auth_basic_auth_user_name: 'username',
+    two_factor_auth_basic_auth_password: 'password',
+    web_rtc_basic_auth_user_name: 'username',
+    web_rtc_basic_auth_password: 'password'
 )
+account_id = "12345"
 ```
 
-## Create Phone Call
+### Create Phone Call
 
 ```ruby
 voice_client = bandwidth_client.voice_client.client
 
-account_id = '1'
 body = ApiCreateCallRequest.new
 body.from = '+16666666666'
 body.to = '+17777777777'
@@ -49,7 +53,7 @@ rescue Bandwidth::ErrorResponseException => e
 end
 ```
 
-## Generate BXML
+### Generate BXML
 
 ```ruby
 response = Bandwidth::Voice::Response.new()
@@ -59,12 +63,11 @@ response.push(hangup)
 puts response.to_bxml()
 ```
 
-## Send Text Message
+### Send Text Message
 
 ```ruby
 messaging_client = bandwidth_client.messaging_client.client
 
-account_id = '1'
 body = MessageRequest.new
 body.application_id = '1-2-3'
 body.to = ['+17777777777']
@@ -72,7 +75,7 @@ body.from = '+18888888888'
 body.text = 'Hello from Bandwidth'
 
 begin
-    response = messaging_client.create_message(account_id, :body => body)
+    response = messaging_client.create_message(account_id, body)
     puts response.data.id #1570740275373xbn7mbhsfewasdr
     puts response.status_code #202
 rescue Bandwidth::GenericClientException => e
@@ -83,3 +86,77 @@ rescue Bandwidth::PathClientException => e
     puts e.response_code #400
 end
 ```
+
+### Create A MFA Request
+
+```ruby
+auth_client = bandwidth_client.two_factor_auth_client.mfa
+
+from_phone = "+18888888888"
+to_phone = "+17777777777"
+messaging_application_id = "1-d-b"
+scope = "scope"
+digits = 6
+
+body = TwoFactorCodeRequestSchema.new
+body.from = from_phone
+body.to = to_phone
+body.application_id = messaging_application_id
+body.scope = scope
+body.digits = digits
+body.message = "Your temporary {NAME} {SCOPE} code is {CODE}"
+
+auth_client.create_messaging_two_factor(account_id, body)
+
+code = "123456" #This is the user input to validate
+
+body = TwoFactorVerifyRequestSchema.new
+body.from = from_phone
+body.to = to_phone
+body.application_id = application_id
+body.scope = scope
+body.code = code
+body.digits = digits
+body.expiration_time_in_minutes = 3
+
+response = auth_client.create_verify_two_factor(account_id, body)
+puts "Auth status: " + response.data.valid.to_s
+```
+
+### WebRtc Participant & Session Management
+
+```ruby
+web_rtc_client = bandwidth_client.web_rtc_client.client
+
+create_session_body = Session.new
+create_session_body.tag = 'new-session'
+
+create_session_response = web_rtc_client.create_session(account_id, :body => create_session_body)
+session_id = create_session_response.data.id
+puts session_id
+
+create_participant_body = Participant.new
+create_participant_body.publish_permissions = [
+    PublishPermissionEnum::AUDIO,
+    PublishPermissionEnum::VIDEO
+]
+create_participant_body.callback_url = "https://sample.com"
+
+create_participant_response = web_rtc_client.create_participant(account_id, :body => create_participant_body)
+participant_id = create_participant_response.data.participant.id
+puts participant_id
+
+web_rtc_client.add_participant_to_session(account_id, session_id, participant_id)
+```
+
+## Supported Ruby Versions
+
+This package can be used with Ruby >= 2.0 
+
+## Documentation
+
+Documentation for this package can be found at https://dev.bandwidth.com/sdks/ruby.html
+
+## Credentials
+
+Information for credentials for this package can be found at https://dev.bandwidth.com/guides/accountCredentials.html

data/lib/bandwidth.rb

@@ -37,6 +37,8 @@ require_relative 'bandwidth/messaging_lib/messaging'
 require_relative 'bandwidth/http/auth/messaging_basic_auth.rb'
 require_relative 'bandwidth/two_factor_auth_lib/two_factor_auth'
 require_relative 'bandwidth/http/auth/two_factor_auth_basic_auth.rb'
+require_relative 'bandwidth/phone_number_lookup_lib/phone_number_lookup'
+require_relative 'bandwidth/http/auth/phone_number_lookup_basic_auth.rb'
 require_relative 'bandwidth/voice_lib/voice'
 require_relative 'bandwidth/http/auth/voice_basic_auth.rb'
 require_relative 'bandwidth/web_rtc_lib/web_rtc'

data/lib/bandwidth/api_helper.rb

@@ -68,9 +68,7 @@ module Bandwidth
     # Appends the given set of parameters to the given query string.
     # @param [String] The query string builder to add the query parameters to.
     # @param [Hash] The parameters to append.
-    # @param [String] The format of array parameter serialization.
-    def self.append_url_with_query_parameters(query_builder, parameters,
-                                              array_serialization: 'indexed')
+    def self.append_url_with_query_parameters(query_builder, parameters)
       # Perform parameter validation.
       unless query_builder.instance_of? String
         raise ArgumentError, 'Given value for parameter \"query_builder\"
@@ -80,6 +78,8 @@ module Bandwidth
       # Return if there are no parameters to replace.
       return query_builder if parameters.nil?
 
+      array_serialization = 'indexed'
+
       parameters.each do |key, value|
         seperator = query_builder.include?('?') ? '&' : '?'
         unless value.nil?
@@ -156,8 +156,8 @@ module Bandwidth
     # Form encodes a hash of parameters.
     # @param [Hash] The hash of parameters to encode.
     # @return [Hash] A hash with the same parameters form encoded.
-    def self.form_encode_parameters(form_parameters,
-                                    array_serialization: 'indexed')
+    def self.form_encode_parameters(form_parameters)
+      array_serialization = 'indexed'
       encoded = {}
       form_parameters.each do |key, value|
         encoded.merge!(APIHelper.form_encode(value, key, formatting:

data/lib/bandwidth/client.rb

@@ -17,6 +17,11 @@ module Bandwidth
     def two_factor_auth_client
       @two_factor_auth_client ||= TwoFactorAuth::Client.new(config: config)
     end
+    # Access to phone_number_lookup_client controller.
+    # @return [PhoneNumberLookup::Client] Returns the client instance.
+    def phone_number_lookup_client
+      @phone_number_lookup_client ||= PhoneNumberLookup::Client.new(config: config)
+    end
     # Access to voice_client controller.
     # @return [Voice::Client] Returns the client instance.
     def voice_client
@@ -29,12 +34,17 @@ module Bandwidth
     end
 
     def initialize(timeout: 60, max_retries: 0, retry_interval: 1,
-                   backoff_factor: 1, environment: Environment::PRODUCTION,
+                   backoff_factor: 2,
+                   retry_statuses: [408, 413, 429, 500, 502, 503, 504, 521, 522, 524, 408, 413, 429, 500, 502, 503, 504, 521, 522, 524],
+                   retry_methods: %i[get put get put],
+                   environment: Environment::PRODUCTION,
                    base_url: 'https://www.example.com',
                    messaging_basic_auth_user_name: 'TODO: Replace',
                    messaging_basic_auth_password: 'TODO: Replace',
                    two_factor_auth_basic_auth_user_name: 'TODO: Replace',
                    two_factor_auth_basic_auth_password: 'TODO: Replace',
+                   phone_number_lookup_basic_auth_user_name: 'TODO: Replace',
+                   phone_number_lookup_basic_auth_password: 'TODO: Replace',
                    voice_basic_auth_user_name: 'TODO: Replace',
                    voice_basic_auth_password: 'TODO: Replace',
                    web_rtc_basic_auth_user_name: 'TODO: Replace',
@@ -43,12 +53,16 @@ module Bandwidth
                   Configuration.new(timeout: timeout, max_retries: max_retries,
                                     retry_interval: retry_interval,
                                     backoff_factor: backoff_factor,
+                                    retry_statuses: retry_statuses,
+                                    retry_methods: retry_methods,
                                     environment: environment,
                                     base_url: base_url,
                                     messaging_basic_auth_user_name: messaging_basic_auth_user_name,
                                     messaging_basic_auth_password: messaging_basic_auth_password,
                                     two_factor_auth_basic_auth_user_name: two_factor_auth_basic_auth_user_name,
                                     two_factor_auth_basic_auth_password: two_factor_auth_basic_auth_password,
+                                    phone_number_lookup_basic_auth_user_name: phone_number_lookup_basic_auth_user_name,
+                                    phone_number_lookup_basic_auth_password: phone_number_lookup_basic_auth_password,
                                     voice_basic_auth_user_name: voice_basic_auth_user_name,
                                     voice_basic_auth_password: voice_basic_auth_password,
                                     web_rtc_basic_auth_user_name: web_rtc_basic_auth_user_name,

data/lib/bandwidth/configuration.rb

@@ -18,6 +18,7 @@ module Bandwidth
       DEFAULT = 'default'.freeze,
       MESSAGINGDEFAULT = 'MessagingDefault'.freeze,
       TWOFACTORAUTHDEFAULT = 'TwoFactorAuthDefault'.freeze,
+      PHONENUMBERLOOKUPDEFAULT = 'PhoneNumberLookupDefault'.freeze,
       VOICEDEFAULT = 'VoiceDefault'.freeze,
       WEBRTCDEFAULT = 'WebRtcDefault'.freeze
     ].freeze
@@ -32,12 +33,16 @@ module Bandwidth
     attr_reader :max_retries
     attr_reader :retry_interval
     attr_reader :backoff_factor
+    attr_reader :retry_statuses
+    attr_reader :retry_methods
     attr_reader :environment
     attr_reader :base_url
     attr_reader :messaging_basic_auth_user_name
     attr_reader :messaging_basic_auth_password
     attr_reader :two_factor_auth_basic_auth_user_name
     attr_reader :two_factor_auth_basic_auth_password
+    attr_reader :phone_number_lookup_basic_auth_user_name
+    attr_reader :phone_number_lookup_basic_auth_password
     attr_reader :voice_basic_auth_user_name
     attr_reader :voice_basic_auth_password
     attr_reader :web_rtc_basic_auth_user_name
@@ -48,12 +53,17 @@ module Bandwidth
     end
 
     def initialize(timeout: 60, max_retries: 0, retry_interval: 1,
-                   backoff_factor: 1, environment: Environment::PRODUCTION,
+                   backoff_factor: 2,
+                   retry_statuses: [408, 413, 429, 500, 502, 503, 504, 521, 522, 524, 408, 413, 429, 500, 502, 503, 504, 521, 522, 524],
+                   retry_methods: %i[get put get put],
+                   environment: Environment::PRODUCTION,
                    base_url: 'https://www.example.com',
                    messaging_basic_auth_user_name: 'TODO: Replace',
                    messaging_basic_auth_password: 'TODO: Replace',
                    two_factor_auth_basic_auth_user_name: 'TODO: Replace',
                    two_factor_auth_basic_auth_password: 'TODO: Replace',
+                   phone_number_lookup_basic_auth_user_name: 'TODO: Replace',
+                   phone_number_lookup_basic_auth_password: 'TODO: Replace',
                    voice_basic_auth_user_name: 'TODO: Replace',
                    voice_basic_auth_password: 'TODO: Replace',
                    web_rtc_basic_auth_user_name: 'TODO: Replace',
@@ -71,6 +81,12 @@ module Bandwidth
       # by in order to provide backoff
       @backoff_factor = backoff_factor
 
+      # A list of HTTP statuses to retry
+      @retry_statuses = retry_statuses
+
+      # A list of HTTP methods to retry
+      @retry_methods = retry_methods
+
       # Current API environment
       @environment = String(environment)
 
@@ -89,6 +105,12 @@ module Bandwidth
       # The password to use with basic authentication
       @two_factor_auth_basic_auth_password = two_factor_auth_basic_auth_password
 
+      # The username to use with basic authentication
+      @phone_number_lookup_basic_auth_user_name = phone_number_lookup_basic_auth_user_name
+
+      # The password to use with basic authentication
+      @phone_number_lookup_basic_auth_password = phone_number_lookup_basic_auth_password
+
       # The username to use with basic authentication
       @voice_basic_auth_user_name = voice_basic_auth_user_name
 
@@ -106,11 +128,14 @@ module Bandwidth
     end
 
     def clone_with(timeout: nil, max_retries: nil, retry_interval: nil,
-                   backoff_factor: nil, environment: nil, base_url: nil,
+                   backoff_factor: nil, retry_statuses: nil, retry_methods: nil,
+                   environment: nil, base_url: nil,
                    messaging_basic_auth_user_name: nil,
                    messaging_basic_auth_password: nil,
                    two_factor_auth_basic_auth_user_name: nil,
                    two_factor_auth_basic_auth_password: nil,
+                   phone_number_lookup_basic_auth_user_name: nil,
+                   phone_number_lookup_basic_auth_password: nil,
                    voice_basic_auth_user_name: nil,
                    voice_basic_auth_password: nil,
                    web_rtc_basic_auth_user_name: nil,
@@ -119,12 +144,16 @@ module Bandwidth
       max_retries ||= self.max_retries
       retry_interval ||= self.retry_interval
       backoff_factor ||= self.backoff_factor
+      retry_statuses ||= self.retry_statuses
+      retry_methods ||= self.retry_methods
       environment ||= self.environment
       base_url ||= self.base_url
       messaging_basic_auth_user_name ||= self.messaging_basic_auth_user_name
       messaging_basic_auth_password ||= self.messaging_basic_auth_password
       two_factor_auth_basic_auth_user_name ||= self.two_factor_auth_basic_auth_user_name
       two_factor_auth_basic_auth_password ||= self.two_factor_auth_basic_auth_password
+      phone_number_lookup_basic_auth_user_name ||= self.phone_number_lookup_basic_auth_user_name
+      phone_number_lookup_basic_auth_password ||= self.phone_number_lookup_basic_auth_password
       voice_basic_auth_user_name ||= self.voice_basic_auth_user_name
       voice_basic_auth_password ||= self.voice_basic_auth_password
       web_rtc_basic_auth_user_name ||= self.web_rtc_basic_auth_user_name
@@ -133,11 +162,14 @@ module Bandwidth
       Configuration.new(
         timeout: timeout, max_retries: max_retries,
         retry_interval: retry_interval, backoff_factor: backoff_factor,
+        retry_statuses: retry_statuses, retry_methods: retry_methods,
         environment: environment, base_url: base_url,
         messaging_basic_auth_user_name: messaging_basic_auth_user_name,
         messaging_basic_auth_password: messaging_basic_auth_password,
         two_factor_auth_basic_auth_user_name: two_factor_auth_basic_auth_user_name,
         two_factor_auth_basic_auth_password: two_factor_auth_basic_auth_password,
+        phone_number_lookup_basic_auth_user_name: phone_number_lookup_basic_auth_user_name,
+        phone_number_lookup_basic_auth_password: phone_number_lookup_basic_auth_password,
         voice_basic_auth_user_name: voice_basic_auth_user_name,
         voice_basic_auth_password: voice_basic_auth_password,
         web_rtc_basic_auth_user_name: web_rtc_basic_auth_user_name,
@@ -148,7 +180,9 @@ module Bandwidth
     def create_http_client
       FaradayClient.new(timeout: timeout, max_retries: max_retries,
                         retry_interval: retry_interval,
-                        backoff_factor: backoff_factor)
+                        backoff_factor: backoff_factor,
+                        retry_statuses: retry_statuses,
+                        retry_methods: retry_methods)
     end
 
     # All the environments the SDK can run in.
@@ -156,7 +190,8 @@ module Bandwidth
       Environment::PRODUCTION => {
         Server::DEFAULT => 'api.bandwidth.com',
         Server::MESSAGINGDEFAULT => 'https://messaging.bandwidth.com/api/v2',
-        Server::TWOFACTORAUTHDEFAULT => 'https://mfa.bandwidth.com/api/v1/',
+        Server::TWOFACTORAUTHDEFAULT => 'https://mfa.bandwidth.com/api/v1',
+        Server::PHONENUMBERLOOKUPDEFAULT => 'https://numbers.bandwidth.com/api/v1',
         Server::VOICEDEFAULT => 'https://voice.bandwidth.com',
         Server::WEBRTCDEFAULT => 'https://api.webrtc.bandwidth.com/v1'
       },
@@ -164,6 +199,7 @@ module Bandwidth
         Server::DEFAULT => '{base_url}',
         Server::MESSAGINGDEFAULT => '{base_url}',
         Server::TWOFACTORAUTHDEFAULT => '{base_url}',
+        Server::PHONENUMBERLOOKUPDEFAULT => '{base_url}',
         Server::VOICEDEFAULT => '{base_url}',
         Server::WEBRTCDEFAULT => '{base_url}'
       }

data/lib/bandwidth/http/api_response.rb

@@ -25,10 +25,12 @@ module Bandwidth
       @errors = errors
     end
 
+    # returns true if status_code is between 200-300
     def success?
       status_code >= 200 && status_code < 300
     end
 
+    # returns true if status_code is between 400-600
     def error?
       status_code >= 400 && status_code < 600
     end

data/lib/bandwidth/http/auth/phone_number_lookup_basic_auth.rb

@@ -0,0 +1,22 @@
+# bandwidth
+#
+# This file was automatically generated by APIMATIC v2.0
+# ( https://apimatic.io ).
+
+require 'base64'
+
+module Bandwidth
+  # Utility class for basic authorization.
+  class PhoneNumberLookupBasicAuth
+    # Add basic authentication to the request.
+    # @param [HttpRequest] The HttpRequest object to which authentication will
+    # be added.
+    def self.apply(config, http_request)
+      username = config.phone_number_lookup_basic_auth_user_name
+      password = config.phone_number_lookup_basic_auth_password
+      value = Base64.strict_encode64("#{username}:#{password}")
+      header_value = "Basic #{value}"
+      http_request.headers['Authorization'] = header_value
+    end
+  end
+end