vonage 7.25.0 → 7.26.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 508c457f8278aae1d8cc3951a8b4c38423ab63307917c4bbc09960f45cbafa9f
-  data.tar.gz: '00329df94f3ab44d6ab8d2552931438358f92ad59c121db87e1668bd1c336814'
+  metadata.gz: 5d3865caa299175327806358dbe9a66e59abefa41240a5d9a847e5e73a37ea50
+  data.tar.gz: 861a7ae004b3908083af43cae0809330732dc07aa7be22a3cc362dc8b538fdab
 SHA512:
-  metadata.gz: 80d9743779edc4dca5c4c9babb6a8591d616e4ac2f393ca4932a5a8640574561b28c61c803dc7c397c99221f0a086bd4604f62e8b36b97c7fd2b7da85ddc88d0
-  data.tar.gz: 40756daa0add532dead58f6d7d057e5bfc8f5d39a9bd84515bcdc08f9a6686eb983b6859f45b71fde9e11b8f474dbecb8a2973ff7270fe8256d813e281783341
+  metadata.gz: 336c7b033206cf204f41e513a2dc8a4c56b57750660e17b37aede3d200aedcced48352ab18ffa3d44f7924df34548f767f19c9189dc385d9f2557a584d399bd7
+  data.tar.gz: da28e64d300d4f70c789e670c10f60beb9fbb058c1da3af8f2f995a8a61541d5b73cea93342f0a5f3b1b0a620dbba5c277fe5b8617259a52446bbbbeed09042e

data/README.md

@@ -528,6 +528,8 @@ The following is a list of Vonage APIs for which the Ruby SDK currently provides
 * [Conversation API](https://developer.vonage.com/en/conversation/overview)
 * [Meetings API](https://developer.vonage.com/en/meetings/overview)
 * [Messages API](https://developer.vonage.com/en/messages/overview)
+* [Network Number Verification API](https://developer.vonage.com/en/number-verification/overview)
+* [Network SIM Swap API](https://developer.vonage.com/en/sim-swap/overview)
 * [Number Insight API](https://developer.vonage.com/en/number-insight/overview)
 * [Numbers API](https://developer.vonage.com/en/numbers/overview)
 * [Proactive Connect API](https://developer.vonage.com/en/proactive-connect/overview) *

data/lib/vonage/basic.rb

@@ -2,7 +2,7 @@
 
 module Vonage
   class Basic < AbstractAuthentication
-    def update(object)
+    def update(object, data)
       return unless object.is_a?(Net::HTTPRequest)
 
       object.basic_auth(@config.api_key, @config.api_secret)

data/lib/vonage/bearer_token.rb

@@ -3,7 +3,7 @@
 
 module Vonage
   class BearerToken < AbstractAuthentication
-    def update(object)
+    def update(object, data)
       return unless object.is_a?(Net::HTTPRequest)
 
       object['Authorization'] = 'Bearer ' + @config.token

data/lib/vonage/client.rb

@@ -91,6 +91,20 @@ module Vonage
       @messaging ||= T.let(Messaging.new(config), T.nilable(Vonage::Messaging))
     end
 
+    # @return [NetworkNumberVerification]
+    #
+    sig { returns(T.nilable(Vonage::NetworkNumberVerification)) }
+    def network_number_verification
+      @network_number_verification ||= T.let(NetworkNumberVerification.new(config), T.nilable(Vonage::NetworkNumberVerification))
+    end
+
+    # @return [NetworkSIMSwap]
+    #
+    sig { returns(T.nilable(Vonage::NetworkSIMSwap)) }
+    def network_sim_swap
+      @network_sim_swap ||= T.let(NetworkSIMSwap.new(config), T.nilable(Vonage::NetworkSIMSwap))
+    end
+
     # @return [NumberInsight]
     #
     sig { returns(T.nilable(Vonage::NumberInsight)) }

data/lib/vonage/key_secret_params.rb

@@ -5,9 +5,10 @@ module Vonage
     extend T::Sig
 
     sig { params(
-      object: T.any(T::Hash[T.untyped, T.untyped], URI::HTTPS, Net::HTTP::Post, Net::HTTP::Get)
+      object: T.any(T::Hash[T.untyped, T.untyped], URI::HTTPS, Net::HTTP::Post, Net::HTTP::Get),
+      data:  T.nilable(Hash)
     ).void }
-    def update(object)
+    def update(object, data)
       return unless object.is_a?(Hash)
 
       @config = T.let(@config, T.nilable(Vonage::Config))

data/lib/vonage/keys.rb

@@ -34,7 +34,10 @@ module Vonage
         'max_duration',
         'partial_captions',
         'status_callback_url',
-        'audio_rate'
+        'audio_rate',
+        'phone_number',
+        'hashed_phone_number',
+        'max_age'
       ]
       hash.transform_keys do |k|
         if exceptions.include?(k.to_s)

data/lib/vonage/namespace.rb

@@ -57,18 +57,15 @@ module Vonage
     Post = Net::HTTP::Post
     Delete = Net::HTTP::Delete
 
-    def build_request(path:, type: Get, params: {})
+    def build_request(path:, type: Get, params: {}, auth_data: nil)
       authentication = self.class.authentication.new(@config)
-      authentication.update(params)
+      authentication.update(params, auth_data)
 
       uri = URI("https://" + @host + path)
       unless type.const_get(:REQUEST_HAS_BODY) || params.empty?
         uri.query = Params.encode(params)
       end
 
-      # Set BasicAuth if neeeded
-      authentication.update(uri)
-
       # instantiate request
       request = type.new(uri)
 
@@ -80,8 +77,8 @@ module Vonage
       request["Accept"] = "application/json"
       self.class.request_headers.each { |key, value| request[key] = value }
 
-      # Set BearerToken if needed
-      authentication.update(request)
+      # Set Authorization header if needed
+      authentication.update(request, auth_data)
 
       # set body
       if type.const_get(:REQUEST_HAS_BODY)
@@ -106,7 +103,7 @@ module Vonage
       response
     end
 
-    def request(path, params: nil, type: Get, response_class: Response, &block)
+    def request(path, params: nil, type: Get, response_class: Response, auth_data: nil, &block)
       auto_advance =
         (
           if !params.nil? && params.key?(:auto_advance)
@@ -120,7 +117,7 @@ module Vonage
         params.tap { |params| params.delete(:auto_advance) } if !params.nil? &&
         params.key?(:auto_advance)
 
-      request = build_request(path: path, params: params || {}, type: type)
+      request = build_request(path: path, params: params || {}, type: type, auth_data: auth_data)
 
       response = make_request!(request, &block)
 
@@ -139,7 +136,7 @@ module Vonage
       end
     end
 
-    def multipart_post_request(path, filepath:, file_name:, mime_type:, params: {}, override_uri: nil, no_auth: false, response_class: Response, &block)
+    def multipart_post_request(path, filepath:, file_name:, mime_type:, params: {}, override_uri: nil, no_auth: false, response_class: Response, auth_data: nil, &block)
       authentication = self.class.authentication.new(@config) unless no_auth
 
       uri = override_uri ? URI(override_uri) : URI('https://' + @host + path)
@@ -156,8 +153,8 @@ module Vonage
 
         request['User-Agent'] = UserAgent.string(@config.app_name, @config.app_version)
 
-        # Set BearerToken if needed
-        authentication.update(request) unless no_auth
+        # Set Authorization header if needed
+        authentication.update(request, auth_data) unless no_auth
 
         logger.log_request_info(request)
 

data/lib/vonage/network_authentication/client_authentication.rb

@@ -0,0 +1,39 @@
+# typed: true
+# frozen_string_literal: true
+
+module Vonage
+  class NetworkAuthentication::ClientAuthentication < Namespace
+    extend T::Sig
+
+    self.authentication = BearerToken
+
+    self.host = :vonage_host
+
+    self.request_headers['Content-Type'] = 'application/x-www-form-urlencoded'
+
+    def token(oidc_auth_code:, redirect_uri:, **params)
+      request(
+        '/oauth2/token',
+        params: {
+          grant_type: 'authorization_code',
+          code: oidc_auth_code,
+          redirect_uri: redirect_uri
+        },
+        type: Post
+      ).access_token
+    end
+
+    def generate_oidc_uri(purpose:, api_scope:, login_hint:, redirect_uri:, state:)
+      scope = "openid%20dpv:#{purpose}%23#{api_scope}"
+      uri = "https://oidc.idp.vonage.com/oauth2/auth?" +
+        "client_id=#{@config.application_id}" +
+        "&response_type=code" +
+        "&scope=#{scope}" +
+        "&login_hint=#{login_hint}" +
+        "&redirect_uri=#{redirect_uri}" +
+        "&state=#{state}"
+
+      uri
+    end
+  end
+end

data/lib/vonage/network_authentication/server_authentication.rb

@@ -0,0 +1,47 @@
+# typed: true
+# frozen_string_literal: true
+
+module Vonage
+  class NetworkAuthentication::ServerAuthentication < Namespace
+    extend T::Sig
+
+    self.authentication = BearerToken
+
+    self.host = :vonage_host
+
+    self.request_headers['Content-Type'] = 'application/x-www-form-urlencoded'
+
+    def token(purpose:, api_scope:, login_hint:, **params)
+      auth_req_id = bc_authorize(
+        purpose: purpose,
+        api_scope: api_scope,
+        login_hint: login_hint
+      ).auth_req_id
+
+      request_access_token(auth_req_id: auth_req_id).access_token
+    end
+
+    def bc_authorize(purpose:, api_scope:, login_hint:)
+      scope = "openid dpv:#{purpose}##{api_scope}"
+      request(
+        "/oauth2/bc-authorize",
+        params: {
+          scope: scope,
+          login_hint: login_hint
+        },
+        type: Post
+      )
+    end
+
+    def request_access_token(auth_req_id:)
+      request(
+        "/oauth2/token",
+        params: {
+          grant_type: 'urn:openid:params:grant-type:ciba',
+          auth_req_id: auth_req_id
+        },
+        type: Post
+      )
+    end
+  end
+end

data/lib/vonage/network_authentication.rb

@@ -0,0 +1,22 @@
+# typed: true
+# frozen_string_literal: true
+
+module Vonage
+  class NetworkAuthentication < AbstractAuthentication
+    def update(object, data)
+      return unless object.is_a?(Net::HTTPRequest)
+
+      token = self.public_send(data[:auth_flow]).token(**data)
+
+      object['Authorization'] = 'Bearer ' + token
+    end
+
+    def client_authentication
+      @client_authentication ||= ClientAuthentication.new(@config)
+    end
+
+    def server_authentication
+      @server_authentication ||= ServerAuthentication.new(@config)
+    end
+  end
+end

data/lib/vonage/network_number_verification.rb

@@ -0,0 +1,92 @@
+# typed: strict
+# frozen_string_literal: true
+require 'phonelib'
+
+module Vonage
+  class NetworkNumberVerification < Namespace
+    extend T::Sig
+    include Keys
+
+    self.authentication = NetworkAuthentication
+
+    self.host = :vonage_host
+
+    self.request_body = JSON
+
+    # Verifies if the specified phone number (plain text or hashed format) matches the one that the user is currently using.
+    #
+    # @example
+    #   response = client.network_number_verification.verify(
+    #     phone_number: '+447900000000',
+    #     auth_data: {
+    #       oidc_auth_code: '0dadaeb4-7c79-4d39-b4b0-5a6cc08bf537',
+    #       redirect_uri: 'https://example.com/callback'
+    #     }
+    #   )
+    #
+    # @param [required, String] :phone_number The phone number to check, in the E.164 format, prepended with a `+`.
+    #
+    # @param [required, Hash] :auth_data A hash of authentication data required for the client token request. Must contain the following keys:
+    # @option auth_data [required, String] :oidc_auth_code The OIDC auth code.
+    # @option auth_data [required, String] :redirect_uri The redirect URI.
+    # @see https://developer.vonage.com/en/getting-started-network/authentication#client-authentication-flow
+    #
+    # @return [Response]
+    #
+    # @see https://developer.vonage.com/en/api/camara/number-verification#verifyNumberVerification
+    #
+    sig { params(phone_number: String, auth_data: Hash).returns(Vonage::Response) }
+    def verify(phone_number:, auth_data:)
+      raise ArgumentError.new("`phone_number` must be in E.164 format") unless Phonelib.parse(phone_number).valid?
+      raise ArgumentError.new("`phone_number` must be prepended with a `+`") unless phone_number.start_with?('+')
+      raise ArgumentError.new("`auth_data` must contain key `:oidc_auth_code`") unless auth_data.has_key?(:oidc_auth_code)
+      raise ArgumentError.new("`auth_data[:oidc_auth_code]` must be a String") unless auth_data[:oidc_auth_code].is_a?(String)
+      raise ArgumentError.new("`auth_data` must contain key `:redirect_uri`") unless auth_data.has_key?(:redirect_uri)
+      raise ArgumentError.new("`auth_data[:redirect_uri]` must be a String") unless auth_data[:redirect_uri].is_a?(String)
+
+      params = {phone_number: phone_number}
+
+      request(
+        '/camara/number-verification/v031/verify',
+        params: camelcase(params),
+        type: Post,
+        auth_data: {
+          oidc_auth_code: auth_data[:oidc_auth_code],
+          redirect_uri: auth_data[:redirect_uri],
+          auth_flow: :client_authentication
+        }
+      )
+    end
+
+    # Creates a URL for a client-side OIDC request.
+    #
+    # @example
+    #   response = client.network_number_verification.generate_oidc_uri(
+    #     phone_number: '+447900000000',
+    #     redirect_uri: 'https://example.com/callback'
+    #   )
+    #
+    # @param [required, String] :phone_number The phone number that will be checked during the verification request.
+    #
+    # @param [required, String] :redirect_uri The URI that will receive the callback containing the OIDC auth code.
+    #
+    # @param [required, String] :state A string that you can use for tracking. 
+    #   Used to set a unique identifier for each access token you generate.
+    #
+    # @return [String]
+    #
+    # @see https://developer.vonage.com/en/getting-started-network/authentication#1-make-an-oidc-request
+    sig { params(phone_number: String, redirect_uri: String, state: String).returns(String) }
+    def generate_oidc_uri(phone_number:, redirect_uri:, state:)
+      params = {
+        purpose: 'FraudPreventionAndDetection',
+        api_scope: 'number-verification-verify-read',
+        login_hint: phone_number,
+        redirect_uri: redirect_uri,
+        state: state
+      }
+
+      Vonage::NetworkAuthentication::ClientAuthentication.new(@config).generate_oidc_uri(**params)
+    end
+  end
+end

data/lib/vonage/network_sim_swap.rb

@@ -0,0 +1,84 @@
+# typed: strict
+# frozen_string_literal: true
+require 'phonelib'
+
+module Vonage
+  class NetworkSIMSwap < Namespace
+    extend T::Sig
+    include Keys
+
+    self.authentication = NetworkAuthentication
+
+    self.host = :vonage_host
+
+    self.request_body = JSON
+
+    # Check if SIM swap has been performed during a past period.
+    #
+    # @example
+    #   response = client.network_sim_swap.check(phone_number: '+447900000000')
+    #
+    # @param [required, String] :phone_number The phone number to check, in the E.164 format, prepended with a `+`.
+    #
+    # @param [optional, Integer] :max_age Period in hours to be checked for SIM swap
+    #
+    # @return [Response]
+    #
+    # @see https://developer.vonage.com/en/api/camara/sim-swap#checkSimSwap
+    #
+    sig { params(phone_number: String, max_age: T.nilable(Integer)).returns(Vonage::Response) }
+    def check(phone_number:, max_age: nil)
+      raise ArgumentError.new("`phone_number` must be in E.164 format") unless Phonelib.parse(phone_number).valid?
+      raise ArgumentError.new("`phone_number` must be prepended with a `+`") unless phone_number.start_with?('+')
+      if max_age
+        raise ArgumentError.new("`max_age` must between 1 and 2400") unless max_age.between?(1, 2400)
+      end
+
+      params = {phone_number: phone_number}
+      params[:max_age] = max_age if max_age
+
+      request(
+        '/camara/sim-swap/v040/check',
+        params: camelcase(params),
+        type: Post,
+        auth_data: {
+          login_hint: phone_number,
+          purpose: 'FraudPreventionAndDetection',
+          api_scope: 'check-sim-swap',
+          auth_flow: :server_authentication
+        }
+      )
+    end
+
+    # Get timestamp of last MSISDN <-> IMSI pairing change for a mobile user account provided with MSIDN.
+    #
+    # @example
+    #   response = client.network_sim_swap.retrieve_date(phone_number: '+447900000000')
+    #
+    # @param [required, String] :phone_number The phone number to check, in the E.164 format, prepended with a `+`.
+    #
+    # @return [Response]
+    #
+    # @see https://developer.vonage.com/en/api/camara/sim-swap#retrieveSimSwapDate
+    #
+    sig { params(phone_number: String).returns(Vonage::Response) }
+    def retrieve_date(phone_number:)
+      raise ArgumentError.new("`phone_number` must be in E.164 format") unless Phonelib.parse(phone_number).valid?
+      raise ArgumentError.new("`phone_number` must be prepended with a `+`") unless phone_number.start_with?('+')
+
+      params = {phone_number: phone_number}
+
+      request(
+        '/camara/sim-swap/v040/retrieve-date',
+        params: camelcase(params),
+        type: Post,
+        auth_data: {
+          login_hint: phone_number,
+          purpose: 'FraudPreventionAndDetection',
+          api_scope: 'retrieve-sim-swap-date',
+          auth_flow: :server_authentication
+        }
+      )
+    end
+  end
+end

data/lib/vonage/verify2/start_verification_options.rb

@@ -5,7 +5,7 @@ module Vonage
   class Verify2::StartVerificationOptions
     VALID_OPTS = [:locale, :channel_timeout, :client_ref, :code_length, :code, :fraud_check].freeze
 
-    MIN_CHANNEL_TIMEOUT, MAX_CHANNEL_TIMEOUT = [60, 900]
+    MIN_CHANNEL_TIMEOUT, MAX_CHANNEL_TIMEOUT = [15, 900]
 
     MIN_CODE_LENGTH, MAX_CODE_LENGTH = [4, 10]
 
@@ -22,6 +22,7 @@ module Vonage
     end
 
     def channel_timeout=(channel_timeout)
+      raise ArgumentError, "Invalid 'channel_timeout' #{channel_timeout}. Must be an integer" unless channel_timeout.is_a?(Integer)
       unless channel_timeout.between?(MIN_CHANNEL_TIMEOUT, MAX_CHANNEL_TIMEOUT)
         raise ArgumentError, "Invalid 'channel_timeout' #{channel_timeout}. Must be between #{MIN_CHANNEL_TIMEOUT} and #{MAX_CHANNEL_TIMEOUT} (inclusive)"
       end

data/lib/vonage/version.rb

@@ -1,5 +1,5 @@
 # typed: strong
 
 module Vonage
-  VERSION = '7.25.0'
+  VERSION = '7.26.0'
 end

data/lib/vonage/voice/actions/connect.rb

@@ -209,6 +209,7 @@ module Vonage
       }
 
       hash.merge!(headers: endpoint_attrs[:headers]) if endpoint_attrs[:headers]
+      hash.merge!(standardHeaders: endpoint_attrs[:standardHeaders]) if endpoint_attrs[:standardHeaders]
 
       hash
     end

data/lib/vonage/voice.rb

@@ -18,6 +18,8 @@ module Vonage
     #
     # @option params [required, Array<Hash>] :to
     #   Connect to a Phone (PSTN) number, SIP Endpoint, Websocket, or VBC extension.
+    #   The `to` Hash can contain a number of different properties depending on the `type`.
+    #   See the API reference for specific details.
     #
     # @option params [Hash] :from
     #   Connect to a Phone (PSTN) number. Should not be set if **:random_from_number** is **true**

data/lib/vonage.rb

@@ -15,6 +15,7 @@ module Vonage
     'jwt' => 'JWT',
     'sip' => 'SIP',
     'sms' => 'SMS',
+    'network_sim_swap' => 'NetworkSIMSwap',
     'mms' => 'MMS',
     'tfa' => 'TFA',
     'version' => 'VERSION',

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: vonage
 version: !ruby/object:Gem::Version
-  version: 7.25.0
+  version: 7.26.0
 platform: ruby
 authors:
 - Vonage
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2024-06-19 00:00:00.000000000 Z
+date: 2024-08-08 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: vonage-jwt
@@ -189,6 +189,11 @@ files:
 - lib/vonage/messaging/channels/whats_app.rb
 - lib/vonage/messaging/message.rb
 - lib/vonage/namespace.rb
+- lib/vonage/network_authentication.rb
+- lib/vonage/network_authentication/client_authentication.rb
+- lib/vonage/network_authentication/server_authentication.rb
+- lib/vonage/network_number_verification.rb
+- lib/vonage/network_sim_swap.rb
 - lib/vonage/number_insight.rb
 - lib/vonage/number_insight_2.rb
 - lib/vonage/numbers.rb