vonage 7.9.0 → 7.11.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 9d8620ac3418486f818675d3b75efdf29a572c38100d00aeb8f36ab36aae4fb0
-  data.tar.gz: 7c1f845f11ba6b1eb625cdf20b703c2b19af2f789dd41e5368ce99465eab2d05
+  metadata.gz: 95210747eb477199b15e3e5349e2bddfe7650928e8caae6a0275dde92381b835
+  data.tar.gz: '00917603bc90d21275328916969cd1af6b5925e6d034aa557705027ae514f7f8'
 SHA512:
-  metadata.gz: 04e95b2647f1d19323fa512b803de87baa245379957fa051c3b13cb12571bf5cb93e735aa28ef332b47f5cf1ccaded503f628b88ee73856ab1e94ee09573d175
-  data.tar.gz: 37ae894d0413c3b72d4c9d8d65462fcb5853740cd8bfcc254f4701fd1529dc3fc3a66fed0888db1e8b0de2ea28461cb4822d7e7e3f06ba5a5db53fce202c4ab3
+  metadata.gz: 523f1f2cb099dfe781a065eb538fd45fd5d06bdb1b71156f10e119c3d4890f1df1c86ce29bfa17a3fb28231d8906deec0a2a66d41b8780e1fe5a892be6bea5b8
+  data.tar.gz: ecbfe4149f794e02ab6835de0fee165bc708036cb8ff4e672d77437e94bda0a4a1fef836eddc4ba0583b6058a2f8cc7ee81a5c29b0f28dad84416ccd8b694e09

data/README.md

@@ -17,6 +17,8 @@ need a Vonage account. Sign up [for free at vonage.com][signup].
     * [Webhook signatures](#webhook-signatures)
     * [Pagination](#pagination)
     * [NCCO Builder](#ncco-builder)
+    * [Messages API](#messages-api)
+    * [Verify API v2](#verify-api-v2)
 * [Documentation](#documentation)
 * [Frequently Asked Questions](#frequently-asked-questions)
     * [Supported APIs](#supported-apis)
@@ -220,11 +222,136 @@ Once the message data is created, you can then send the message.
 response = client.messaging.send(to: "447700900000", from: "447700900001", **message)
 ```
 
+## Verify API v2
+
+The [Vonage Verify API v2](https://developer.vonage.com/en/verify/verify-v2/overview) allows you to manage 2FA verification workflows over a number of different channels such as SMS, WhatsApp, WhatsApp Interactive, Voice, Email, and Silent Authentication, either individually or in combination with each other. See the Vonage Developer Documentation for a [complete API reference](https://developer.vonage.com/en/api/verify.v2) listing all the channels, verification options, and callback types.
+
+The Ruby SDK provides two methods for interacting with the Verify v2 API:
+
+- `Verify2#start_verification`: starts a new verification request. Here you can specify options for the request and the workflow to be used.
+- `Verify2#check_code`: for channels where the end-user is sent a one-time code, this method is used to verify the code against the `request_id` of the verification request created by the `start_verification` method.
+
+### Creating a Verify2 Object
+
+```ruby
+verify = client.verify2
+```
+
+### Making a verification request
+
+For simple requests, you may prefer to manually set the value for `workflow` (an array of one or more hashes containing the settings for a particular channel) and any optional params.
+
+Example with the required `:brand` and `:workflow` arguments:
+
+```ruby
+verification_request = verify.start_verification(
+  brand: 'Acme',
+  workflow: [{channel: 'sms', to: '447000000000'}]
+)
+```
+
+Example with the required `:brand` and `:workflow` arguments, and an optional `code_length`:
+
+```ruby
+verification_request = verify.start_verification(
+  brand: 'Acme',
+  workflow: [{channel: 'sms', to: '447000000000'}],
+  code_length: 6
+)
+```
+
+For more complex requests (e.g. with mutliple workflow channels or addtional options), or to take advantage of built-in input validation, you can use the `StartVerificationOptions` object and the `Workflow` and various channel objects or the `WorkflowBuilder`:
+
+#### Create options using StartVerificationOptions object
+
+```ruby
+opts = verify.start_verification_options(
+  locale: 'fr-fr',
+  code_length: 6,
+  client_ref: 'abc-123'
+).to_h
+
+verification_request = verify.start_verification(
+  brand: 'Acme',
+  workflow: [{channel: 'email', to: 'alice.example.com'}],
+  **opts
+)
+```
+
+#### Create workflow using Workflow and Channel objects
+
+```ruby
+# Instantiate a Workflow object
+workflow = verify.workflow
+
+# Add channels to the workflow
+workflow << workflow.sms(to: '447000000000')
+workflow << workflow.email(to: 'alice.example.com')
+
+# Channel data is encpsulated in channel objects stored in the Workflow list array
+workflow.list
+# => [ #<Vonage::Verify2::Channels::SMS:0x0000561474a74778 @channel="sms", @to="447000000000">,
+  #<Vonage::Verify2::Channels::Email:0x0000561474c51a28 @channel="email", @to="alice.example.com">]
+
+# To use the list as the value for `:workflow` in a `start_verification` request call,
+# the objects must be hashified
+workflow_list = workflow.hashified_list
+# => [{:channel=>"sms", :to=>"447000000000"}, {:channel=>"email", :to=>"alice.example.com"}]
+
+verification_request = verify.start_verification(brand: 'Acme', workflow: workflow_list)
+```
+
+#### Create a workflow using the WorkflowBuilder
+
+```ruby
+workflow = verify.workflow_builder.build do |builder|
+  builder.add_voice(to: '447000000001')
+  builder.add_whatsapp(to: '447000000000')
+end
+
+workflow_list = workflow.hashified_list
+# => [{:channel=>"voice", :to=>"447000000001"}, {:channel=>"whatsapp", :to=>"447000000000"}]
+
+verification_request = verify.start_verification(brand: 'Acme', workflow: workflow_list)
+```
+
+### Cancelling a request
+
+You can cancel in in-progress verification request
+
+```ruby
+# Get the `request_id` from the Vonage#Response object returned by the `start_verification` method call
+request_id = verification_request.request_id
+
+verify.cancel_verification_request(request_id: request_id)
+```
+
+### Checking a code
+
+```ruby
+# Get the `request_id` from the Vonage#Response object returned by the `start_verification` method call
+request_id = verification_request.request_id
+
+# Get the one-time code via user input
+# e.g. from params in a route handler or controller action for a form input
+code = params[:code]
+
+begin
+  code_check = verify.check_code(request_id: request_id, code: code)
+rescue => error
+  # an invalid code will raise an exception of type Vonage::ClientError
+end
+
+if code_check.http_response.code == '200'
+  # code is valid
+end
+```
+
 ## Documentation
 
 Vonage Ruby documentation: https://www.rubydoc.info/github/Vonage/vonage-ruby-sdk
 
-Vonage Ruby code examples: https://github.com/Nexmo/nexmo-ruby-code-snippets
+Vonage Ruby code examples: https://github.com/Vonage/vonage-ruby-code-snippets
 
 Vonage APIs API reference: https://developer.nexmo.com/api
 
@@ -252,6 +379,7 @@ The following is a list of Vonage APIs and whether the Ruby SDK provides support
 | Reports API | Beta |❌|
 | SMS API | General Availability |✅|
 | Verify API | General Availability |✅|
+| Verify API v2 | General Availability |✅|
 | Voice API | General Availability |✅|
 
 ## License

data/lib/vonage/client.rb

@@ -131,6 +131,13 @@ module Vonage
       @verify ||= T.let(Verify.new(config), T.nilable(Vonage::Verify))
     end
 
+    # @return [Verify2]
+    #
+    sig { returns(T.nilable(Vonage::Verify2)) }
+    def verify2
+      @verify2 ||= T.let(Verify2.new(config), T.nilable(Vonage::Verify2))
+    end
+
     # @return [Voice]
     #
     sig { returns(T.nilable(Vonage::Voice)) }

data/lib/vonage/namespace.rb

@@ -202,7 +202,7 @@ module Vonage
       when Net::HTTPNoContent
         response_class.new(nil, response)
       when Net::HTTPSuccess
-        if response['Content-Type'].split(';').first == 'application/json'
+        if response['Content-Type'] && response['Content-Type'].split(';').first == 'application/json'
           entity = ::JSON.parse(response.body, object_class: Vonage::Entity)
 
           response_class.new(entity, response)

data/lib/vonage/verify2/channels/email.rb

@@ -0,0 +1,38 @@
+# typed: true
+# frozen_string_literal: true
+require 'phonelib'
+
+module Vonage
+  class Verify2::Channels::Email
+
+    attr_reader :channel, :to, :from
+
+    def initialize(to:, from: nil)
+      self.channel = 'email'
+      self.to = to
+      self.from = from if from
+    end
+
+    def to=(to)
+      # TODO: add validation
+      @to = to
+    end
+
+    def from=(from)
+      # TODO: add validation
+      @from = from
+    end
+
+    def to_h
+      hash = Hash.new
+      self.instance_variables.each do |ivar|
+        hash[ivar.to_s.delete("@").to_sym] = self.instance_variable_get(ivar)
+      end
+      hash
+    end
+
+    private
+
+    attr_writer :channel
+  end
+end

data/lib/vonage/verify2/channels/silent_auth.rb

@@ -0,0 +1,32 @@
+# typed: true
+# frozen_string_literal: true
+require 'phonelib'
+
+module Vonage
+  class Verify2::Channels::SilentAuth
+
+    attr_reader :channel, :to
+
+    def initialize(to:)
+      self.channel = 'silent_auth'
+      self.to = to
+    end
+
+    def to=(to)
+      raise ArgumentError, "Invalid 'to' value #{to}. Expected to be in E.164 format" unless Phonelib.parse(to.to_i).valid?
+      @to = to
+    end
+
+    def to_h
+      hash = Hash.new
+      self.instance_variables.each do |ivar|
+        hash[ivar.to_s.delete("@").to_sym] = self.instance_variable_get(ivar)
+      end
+      hash
+    end
+
+    private
+
+    attr_writer :channel
+  end
+end

data/lib/vonage/verify2/channels/sms.rb

@@ -0,0 +1,39 @@
+# typed: true
+# frozen_string_literal: true
+require 'phonelib'
+
+module Vonage
+  class Verify2::Channels::SMS
+    APP_HASH_LENGTH = 11
+
+    attr_reader :channel, :to, :app_hash
+
+    def initialize(to:, app_hash: nil)
+      self.channel = 'sms'
+      self.to = to
+      self.app_hash = app_hash if app_hash
+    end
+
+    def to=(to)
+      raise ArgumentError, "Invalid 'to' value #{to}. Expected to be in E.164 format" unless Phonelib.parse(to).valid?
+      @to = to
+    end
+
+    def app_hash=(app_hash)
+      raise ArgumentError, "Invalid 'app_hash' value #{app_hash}. Length must be #{APP_HASH_LENGTH}" unless app_hash.length == APP_HASH_LENGTH
+      @app_hash = app_hash
+    end
+
+    def to_h
+      hash = Hash.new
+      self.instance_variables.each do |ivar|
+        hash[ivar.to_s.delete("@").to_sym] = self.instance_variable_get(ivar)
+      end
+      hash
+    end
+
+    private
+
+    attr_writer :channel
+  end
+end

data/lib/vonage/verify2/channels/voice.rb

@@ -0,0 +1,32 @@
+# typed: true
+# frozen_string_literal: true
+require 'phonelib'
+
+module Vonage
+  class Verify2::Channels::Voice
+
+    attr_reader :channel, :to
+
+    def initialize(to:)
+      self.channel = 'voice'
+      self.to = to
+    end
+
+    def to=(to)
+      raise ArgumentError, "Invalid 'to' value #{to}. Expected to be in E.164 format" unless Phonelib.parse(to.to_i).valid?
+      @to = to
+    end
+
+    def to_h
+      hash = Hash.new
+      self.instance_variables.each do |ivar|
+        hash[ivar.to_s.delete("@").to_sym] = self.instance_variable_get(ivar)
+      end
+      hash
+    end
+
+    private
+
+    attr_writer :channel
+  end
+end

data/lib/vonage/verify2/channels/whats_app.rb

@@ -0,0 +1,38 @@
+# typed: true
+# frozen_string_literal: true
+require 'phonelib'
+
+module Vonage
+  class Verify2::Channels::WhatsApp
+
+    attr_reader :channel, :to, :from
+
+    def initialize(to:, from: nil)
+      self.channel = 'whatsapp'
+      self.to = to
+      self.from = from if from
+    end
+
+    def to=(to)
+      raise ArgumentError, "Invalid 'to' value #{to}. Expected to be in E.164 format" unless Phonelib.parse(to.to_i).valid?
+      @to = to
+    end
+
+    def from=(from)
+      raise ArgumentError, "Invalid 'from' value #{from}. Expected to be in E.164 format" unless Phonelib.parse(from.to_i).valid?
+      @from = from
+    end
+
+    def to_h
+      hash = Hash.new
+      self.instance_variables.each do |ivar|
+        hash[ivar.to_s.delete("@").to_sym] = self.instance_variable_get(ivar)
+      end
+      hash
+    end
+
+    private
+
+    attr_writer :channel
+  end
+end

data/lib/vonage/verify2/channels/whats_app_interactive.rb

@@ -0,0 +1,32 @@
+# typed: true
+# frozen_string_literal: true
+require 'phonelib'
+
+module Vonage
+  class Verify2::Channels::WhatsAppInteractive
+
+    attr_reader :channel, :to
+
+    def initialize(to:)
+      self.channel = 'whatsapp_interactive'
+      self.to = to
+    end
+
+    def to=(to)
+      raise ArgumentError, "Invalid 'to' value #{to}. Expected to be in E.164 format" unless Phonelib.parse(to.to_i).valid?
+      @to = to
+    end
+
+    def to_h
+      hash = Hash.new
+      self.instance_variables.each do |ivar|
+        hash[ivar.to_s.delete("@").to_sym] = self.instance_variable_get(ivar)
+      end
+      hash
+    end
+
+    private
+
+    attr_writer :channel
+  end
+end

data/lib/vonage/verify2/start_verification_options.rb

@@ -0,0 +1,71 @@
+# typed: true
+# frozen_string_literal: true
+
+module Vonage
+  class Verify2::StartVerificationOptions
+    VALID_OPTS = [:locale, :channel_timeout, :client_ref, :code_length, :code, :fraud_check].freeze
+
+    VALID_LOCALES = [
+      'en-us', 'en-gb', 'es-es', 'es-mx', 'es-us', 'it-it', 'fr-fr',
+      'de-de', 'ru-ru', 'hi-in', 'pt-br', 'pt-pt', 'id-id'
+    ].freeze
+
+    MIN_CHANNEL_TIMEOUT, MAX_CHANNEL_TIMEOUT = [60, 900]
+
+    MIN_CODE_LENGTH, MAX_CODE_LENGTH = [4, 10]
+
+    attr_reader(*VALID_OPTS)
+
+    def initialize(**opts)
+      VALID_OPTS.each do |opt|
+        send("#{opt}=", opts[opt]) unless opts[opt].nil?
+      end
+    end
+
+    def locale=(locale)
+      unless VALID_LOCALES.include?(locale)
+        raise ArgumentError, "Invalid 'locale' #{locale}. Please choose from the following #{VALID_LOCALES}"
+      end
+
+      @locale = locale
+    end
+
+    def channel_timeout=(channel_timeout)
+      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
+
+      @channel_timeout = channel_timeout
+    end
+
+    def client_ref=(client_ref)
+      @client_ref = client_ref
+    end
+
+    def code_length=(code_length)
+      unless code_length.between?(MIN_CODE_LENGTH, MAX_CODE_LENGTH)
+        raise ArgumentError, "Invalid 'code_length' #{code_length}. Must be between #{MIN_CODE_LENGTH} and #{MAX_CODE_LENGTH} (inclusive)"
+      end
+
+      @code_length = code_length
+    end
+
+    def code=(code)
+      @code = code
+    end
+
+    def fraud_check=(fraud_check)
+      raise ArgumentError, "Invalid 'fraud_check' #{fraud_check}. Must be `false`" unless fraud_check == false
+
+      @fraud_check = fraud_check
+    end
+
+    def to_h
+      hash = Hash.new
+      self.instance_variables.each do |ivar|
+        hash[ivar.to_s.delete("@").to_sym] = self.instance_variable_get(ivar)
+      end
+      hash
+    end
+  end
+end

data/lib/vonage/verify2/workflow.rb

@@ -0,0 +1,39 @@
+# typed: true
+# frozen_string_literal: true
+
+module Vonage
+  class Verify2::Workflow
+    CHANNELS = {
+      sms: Verify2::Channels::SMS,
+      whatsapp: Verify2::Channels::WhatsApp,
+      whatsapp_interactive: Verify2::Channels::WhatsAppInteractive,
+      voice: Verify2::Channels::Voice,
+      email: Verify2::Channels::Email,
+      silent_auth: Verify2::Channels::SilentAuth
+    }
+
+    CHANNELS.keys.each do |method|
+      define_method method do |attributes|
+        CHANNELS[method].new(**attributes)
+      end
+    end
+
+    def self.method_missing(method)
+      raise ClientError.new("Workflow channel must be one of the valid options. Please refer to https://developer.vonage.com/en/api/verify.v2#newRequest for a complete list.")
+    end
+
+    attr_reader :list
+
+    def initialize
+      @list = []
+    end
+
+    def <<(workflow)
+      list << workflow
+    end
+
+    def hashified_list
+      list.map(&:to_h)
+    end
+  end
+end

data/lib/vonage/verify2/workflow_builder.rb

@@ -0,0 +1,25 @@
+# typed: true
+# frozen_string_literal: true
+
+module Vonage
+  class Verify2::WorkflowBuilder
+
+    def self.build
+      builder = self.new
+      yield builder if block_given?
+      builder.workflow
+    end
+
+    attr_reader :workflow
+
+    def initialize
+      @workflow = Vonage::Verify2::Workflow.new
+    end
+
+    Vonage::Verify2::Workflow::CHANNELS.keys.each do |channel|
+      define_method "add_#{channel.to_s}" do |args|
+        workflow << workflow.send(channel, **args)
+      end
+    end
+  end
+end

data/lib/vonage/verify2.rb

@@ -0,0 +1,93 @@
+# typed: true
+# frozen_string_literal: true
+
+module Vonage
+  class Verify2 < Namespace
+    self.authentication = BearerToken
+
+    self.request_body = JSON
+
+    # Request a verification be sent to a user.
+    #
+    # @example
+    #   verification_request = verify.start_verification(
+    #     brand: 'Acme',
+    #     workflow: [{channel: 'sms', to: '447000000000'}],
+    #     code_length: 6
+    #   )
+    #
+    # @param [required, String] :brand The brand that is sending the verification request
+    #
+    # @param [required, Array<Hash>] :workflow An array of hashes for channels in the workflow
+    #
+    # @param [optional, Hash] opts the options for the verification request.
+    #   @option opts [Integer] :code_length The length of the one-time code provided to the end-user
+    #   @option opts [String] :code An optional alphanumeric custom code to use instead of an auto-generated code
+    #   @option opts [String] :locale The language to use for the verification message (where applicable)
+    #   @option opts [Integer] :channel_timeout Wait time in seconds before trying the next channel in the workflow
+    #   @option opts [String] :client_ref Reference to be included in callbacks
+    #   @option opts [Boolean] If used, must be set to `false`. Will bypass a network block for a single Verify V2 request
+    #
+    # @return Vomage::Response
+    # @see https://developer.vonage.com/en/api/verify.v2#newRequest
+    #
+    def start_verification(brand:, workflow:, **opts)
+      raise ArgumentError, ':workflow must be an Array' unless workflow.is_a?(Array)
+      raise ArgumentError, ':workflow must not be empty' if workflow.empty?
+
+      request('/v2/verify/', params: opts.merge(brand: brand, workflow: workflow), type: Post)
+    end
+
+    # Check a supplied code against a request to see if it is valid.
+    #
+    # @example
+    #   code_check = verify.check_code(request_id: '7e8c5965-0a3f-44df-8a14-f1486209d8a2', code: '1234')
+    #
+    # @param [required, String] :request_id The request_id of the verification request being checked
+    #
+    # @param [required, String] :code The code supplied to the end-user by the verification request
+    #
+    # @see https://developer.vonage.com/en/api/verify.v2#checkCode
+    #
+    def check_code(request_id:, code:)
+      request('/v2/verify/' + request_id, params: {code: code}, type: Post)
+    end
+
+    # Cancel a verifiction. If a verification request is still active, calling this method aborts the workflow.
+    #
+    # @example
+    #   verify.cancel_verification_request(request_id: '7e8c5965-0a3f-44df-8a14-f1486209d8a2')
+    #
+    # @param [required, String] :request_id The request_id of the verification request to be cancelled
+    #
+    # @see https://developer.vonage.com/en/api/verify.v2#cancelRequest
+    #
+    def cancel_verification_request(request_id:)
+      request('/v2/verify/' + request_id, type: Delete)
+    end
+
+    # Instantiate a new Vonage::Verify2::StartVerificationOptions object
+    #
+    # @param [optional, Hash] opts the options for the verification request.
+    #   @option opts [Integer] :code_length The length of the one-time code provided to the end-user
+    #   @option opts [String] :code An optional alphanumeric custom code to use instead of an auto-generated code
+    #   @option opts [String] :locale The language to use for the verification message (where applicable)
+    #   @option opts [Integer] :channel_timeout Wait time in seconds before trying the next channel in the workflow
+    #   @option opts [String] :client_ref Reference to be included in callbacks
+    #   @option opts [Boolean] If used, must be set to `false`. Will bypass a network block for a single Verify V2 request
+    #
+    def start_verification_options(**opts)
+      StartVerificationOptions.new(**opts)
+    end
+
+    # Instantiate a new Vonage::Verify2::Workflow object
+    def workflow
+      Workflow.new
+    end
+
+    # Return the Vonage::Verify2::WorkflowBuilder class
+    def workflow_builder
+      WorkflowBuilder.itself
+    end
+  end
+end

data/lib/vonage/version.rb

@@ -1,5 +1,5 @@
 # typed: strong
 
 module Vonage
-  VERSION = "7.9.0"
+  VERSION = "7.11.0"
 end

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

@@ -2,9 +2,9 @@
 # frozen_string_literal: true
 require 'phonelib'
 
-module Vonage  
+module Vonage
   class Voice::Actions::Connect
-    attr_accessor :endpoint, :from, :eventType, :timeout, :limit, :machineDetection, :eventUrl, :eventMethod, :ringbackTone
+    attr_accessor :endpoint, :from, :eventType, :timeout, :limit, :machineDetection, :advanced_machine_detection, :eventUrl, :eventMethod, :ringbackTone
 
     def initialize(attributes = {})
       @endpoint = attributes.fetch(:endpoint)
@@ -13,6 +13,7 @@ module Vonage
       @timeout = attributes.fetch(:timeout, nil)
       @limit = attributes.fetch(:limit, nil)
       @machineDetection = attributes.fetch(:machineDetection, nil)
+      @advanced_machine_detection = attributes.fetch(:advanced_machine_detection, nil)
       @eventUrl = attributes.fetch(:eventUrl, nil)
       @eventMethod = attributes.fetch(:eventMethod, nil)
       @ringbackTone = attributes.fetch(:ringbackTone, nil)
@@ -39,6 +40,10 @@ module Vonage
         verify_machine_detection
       end
 
+      if self.advanced_machine_detection
+        verify_advanced_machine_detection
+      end
+
       if self.eventUrl
         verify_event_url
       end
@@ -82,6 +87,25 @@ module Vonage
       raise ClientError.new("Invalid 'machineDetection' value, must be either: 'continue' or 'hangup' if defined") unless self.machineDetection == 'continue' || self.machineDetection == 'hangup'
     end
 
+    def verify_advanced_machine_detection
+      raise ClientError.new("Invalid 'advanced_machine_detection' value, must be a Hash") unless self.advanced_machine_detection.is_a?(Hash)
+      verify_advanced_machine_detection_behavior if self.advanced_machine_detection[:behavior]
+      verify_advanced_machine_detection_mode if self.advanced_machine_detection[:mode]
+      verify_advanced_machine_detection_beep_timeout if self.advanced_machine_detection[:beep_timeout]
+    end
+
+    def verify_advanced_machine_detection_behavior
+      raise ClientError.new("Invalid 'advanced_machine_detection[:behavior]' value, must be a `continue` or `hangup`") unless ['continue', 'hangup'].include?(self.advanced_machine_detection[:behavior])
+    end
+
+    def verify_advanced_machine_detection_mode
+      raise ClientError.new("Invalid 'advanced_machine_detection[:mode]' value, must be a `detect` or `detect_beep`") unless ['detect', 'detect_beep'].include?(self.advanced_machine_detection[:mode])
+    end
+
+    def verify_advanced_machine_detection_beep_timeout
+      raise ClientError.new("Invalid 'advanced_machine_detection[:beep_timeout]' value, must be between 45 and 120") unless self.advanced_machine_detection[:beep_timeout].between?(45, 120)
+    end
+
     def verify_event_url
       uri = URI.parse(self.eventUrl)
 
@@ -196,4 +220,4 @@ module Vonage
       }
     end
   end
-end
+end

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

@@ -2,7 +2,7 @@
 # frozen_string_literal: true
 module Vonage
   class Voice::Actions::Talk
-    attr_accessor :text, :bargeIn, :loop, :level, :language, :style
+    attr_accessor :text, :bargeIn, :loop, :level, :language, :style, :premium
 
     def initialize(attributes= {})
       @text = attributes.fetch(:text)
@@ -11,6 +11,7 @@ module Vonage
       @level = attributes.fetch(:level, nil)
       @language = attributes.fetch(:language, nil)
       @style = attributes.fetch(:style, nil)
+      @premium = attributes.fetch(:premium, nil)
 
       after_initialize!
     end
@@ -31,6 +32,10 @@ module Vonage
       if self.style
         verify_style
       end
+
+      if self.premium
+        verify_premium
+      end
     end
 
     def verify_barge_in
@@ -49,6 +54,10 @@ module Vonage
       raise ClientError.new("Expected 'style' value to be an Integer") unless self.style.is_a?(Integer)
     end
 
+    def verify_premium
+      raise ClientError.new("Expected 'premium' value to be a Boolean") unless self.premium == true || self.premium == false
+    end
+
     def action
       create_talk!(self)
     end
@@ -70,4 +79,4 @@ module Vonage
       ncco
     end
   end
-end
+end

data/lib/vonage/voice/talk.rb

@@ -12,8 +12,18 @@ module Vonage
     # @option params [required, String] :text
     #   The text to read.
     #
+    # @option params [String] :language
+    #   The language to use. See {https://developer.vonage.com/en/api/voice#startTalk-req-body} for a list of valid language codes.
+    #
+    # @option params [Integer] :style
+    #   The vocal style, as identified by an assigned integer.
+    #     See {https://developer.vonage.com/en/voice/voice-api/concepts/text-to-speech#supported-languages} for a list of available styles.
+    #
+    # @option params [Boolean] :premium
+    #   Set to `true` to use the premium version of the specified style if available, otherwise the standard version will be used.
+    #
     # @option params [String] :voice_name
-    #   The voice & language to use.
+    #   The voice & language to use. [DEPRECATED: use `language` and `style` instead].
     #
     # @option params [Integer] :loop
     #   The number of times to repeat the text the file, 0 for infinite.

data/lib/vonage/voice.rb

@@ -48,6 +48,17 @@ module Vonage
     # @option params [String] :machine_detection
     #   Configure the behavior when Vonage detects that the call is answered by voicemail.
     #
+    # @option params [Hash] :advanced_machine_detection
+    #   Configure the behavior of Vonage's advanced machine detection. Overrides machine_detection if both are set.
+    #   Hash with three possible properties:
+    #     - :behavior [String]: Must be one of `continue` or `hangup`. When hangup is used, the call will be terminated if a
+    #         machine is detected. When continue is used, the call will continue even if a machine is detected.
+    #     - :mode [String]: Must be one of `detect` or `detect_beep`. Detect if machine answered and sends a human or
+    #         machine status in the webhook payload. When set to `detect_beep`, the system also attempts to detect
+    #         voice mail beep and sends an additional parameter `sub_state` in the webhook with the value `beep_start`.
+    #     - :beep_timeout [Integer]: Min: 45, Max: 120. Maximum time in seconds Vonage should wait for a machine beep
+    #         to be detected. A machine event with `sub_state` set to `beep_timeout` will be sent if the timeout is exceeded.
+    #
     # @option params [Integer] :length_timer
     #   Set the number of seconds that elapse before Vonage hangs up after the call state changes to in_progress.
     #

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: vonage
 version: !ruby/object:Gem::Version
-  version: 7.9.0
+  version: 7.11.0
 platform: ruby
 authors:
 - Vonage
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2023-04-19 00:00:00.000000000 Z
+date: 2023-06-16 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: vonage-jwt
@@ -152,13 +152,22 @@ files:
 - lib/vonage/tfa.rb
 - lib/vonage/user_agent.rb
 - lib/vonage/verify.rb
+- lib/vonage/verify2.rb
+- lib/vonage/verify2/channels/email.rb
+- lib/vonage/verify2/channels/silent_auth.rb
+- lib/vonage/verify2/channels/sms.rb
+- lib/vonage/verify2/channels/voice.rb
+- lib/vonage/verify2/channels/whats_app.rb
+- lib/vonage/verify2/channels/whats_app_interactive.rb
+- lib/vonage/verify2/start_verification_options.rb
+- lib/vonage/verify2/workflow.rb
+- lib/vonage/verify2/workflow_builder.rb
 - lib/vonage/version.rb
 - lib/vonage/voice.rb
 - lib/vonage/voice/actions/connect.rb
 - lib/vonage/voice/actions/conversation.rb
 - lib/vonage/voice/actions/input.rb
 - lib/vonage/voice/actions/notify.rb
-- lib/vonage/voice/actions/pay.rb
 - lib/vonage/voice/actions/record.rb
 - lib/vonage/voice/actions/stream.rb
 - lib/vonage/voice/actions/talk.rb

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

@@ -1,107 +0,0 @@
-# typed: true
-# frozen_string_literal: true
-module Vonage
-  class Voice::Actions::Pay
-    attr_accessor :amount, :currency, :eventUrl, :prompts, :voice
-
-    def initialize(attributes= {})
-      @amount = attributes.fetch(:amount)
-      @currency = attributes.fetch(:currency, nil)
-      @eventUrl = attributes.fetch(:eventUrl, nil)
-      @prompts = attributes.fetch(:prompts, nil)
-      @voice = attributes.fetch(:voice, nil)
-
-      after_initialize!
-    end
-
-    def action
-      create_pay!(self)
-    end
-
-    def create_pay!(builder)
-      ncco = [
-        {
-          action: 'pay',
-          amount: builder.amount
-        }
-      ]
-
-      ncco[0].merge!(currency: builder.currency) if builder.currency
-      ncco[0].merge!(eventUrl: builder.eventUrl) if builder.eventUrl
-      ncco[0].merge!(prompts: builder.prompts) if builder.prompts
-      ncco[0].merge!(voice: builder.voice) if builder.voice
-
-      ncco
-    end
-
-    private
-
-    def after_initialize!
-      verify_amount
-
-      if self.eventUrl
-        verify_event_url
-      end
-
-      if self.prompts
-        verify_prompts
-      end
-
-      if self.voice
-        verify_voice
-      end
-    end
-
-    def verify_amount
-      verify_amount_class
-      verify_amount_value
-    end
-
-    def verify_event_url
-      raise ClientError.new("Expected 'eventUrl' parameter to be an Array containing a single string item") unless self.eventUrl.is_a?(Array)
-
-      uri = URI.parse(self.eventUrl[0])
-
-      raise ClientError.new("Invalid 'eventUrl' value, must be a valid URL") unless uri.kind_of?(URI::HTTP) || uri.kind_of?(URI::HTTPS)
-    end
-
-    def verify_prompts
-      verify_prompts_structure
-      verify_prompts_values
-    end
-
-    def verify_voice
-      verify_voice_structure
-      verify_voice_style if self.voice[:style]
-    end
-
-    def verify_amount_class
-      raise ClientError.new("Invalid 'amount' value, must be a float") unless self.amount.is_a?(Float)
-    end
-
-    def verify_amount_value
-      raise ClientError.new("Invalid 'amount' value, must be greater than 0") unless self.amount > 0
-    end
-
-    def verify_prompts_structure
-      raise ClientError.new("Invalid 'prompt', must be an array of at least one hash") unless self.prompts.is_a?(Array) && !self.prompts.empty? && self.prompts.all?(Hash)
-    end
-
-    def verify_prompts_values
-      self.prompts.each do |prompt|
-        prompt_keys = prompt.keys
-        [:type, :text, :errors].each do |key|
-          raise ClientError.new("Invalid 'prompt', '#{key}' is required") unless prompt_keys.include?(key)
-        end
-      end
-    end
-
-    def verify_voice_structure
-      raise ClientError.new("Expected 'voice' value to be a Hash") unless self.voice.is_a?(Hash)
-    end
-
-    def verify_voice_style
-      raise ClientError.new("Expected 'style' value to be an Integer") unless self.voice[:style].is_a?(Integer)
-    end
-  end
-end