vonage 7.15.0 → 8.0.0.beta

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: fe42d262916665b0528b89b25fc9094ff4009739cea53ec28a416afe2ec232c8
-  data.tar.gz: d1bb14fcc3e8c862dedd87a32b80034d9914c0cafcc2c53f071b05a9c640a644
+  metadata.gz: e003a6ed3211d3eace84884bf3fb03d21b81f097b13aba079f1906daf95380ff
+  data.tar.gz: 956c6921b50df45aaf2f1901b08ccd3cb164c2553b23d8e45570f63dcdf6f960
 SHA512:
-  metadata.gz: a52f19d149c83ff7cbc2fe73982abaf79901c146fa45d006d19ba9f32b9640bf14065e132362aae591869339109deeafa68e72349a1e6d9f2a6fba173efbf9a6
-  data.tar.gz: 38f8d3a78930e5b13e8ed71e3bce0ee37789a506f053e9f31c543bdac10760f574dc976fca097f64f47419f9d99c4b912ce32484b389243b96c52f5fa6e7ef4c
+  metadata.gz: 1500879cd4a974009f6510cf12ea15b4ce60a9163f916b8a5e07fe785323c24c6909134163b21e29afc9c251550fd36a9e348c2ff7eac3b18b45f0e4ef7e1be1
+  data.tar.gz: fe368d23b897a7f1b2b9ba473c993a351ffb1233ef80304c16ec69ed28692c93e422c7a453f8d0da14b6e038424c215026a945d7ccee9b4a26412e3ecbe5435f

data/README.md

@@ -17,8 +17,6 @@ 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)
@@ -222,136 +220,11 @@ 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/Vonage/vonage-ruby-code-snippets
+Vonage Ruby code examples: https://github.com/Nexmo/nexmo-ruby-code-snippets
 
 Vonage APIs API reference: https://developer.nexmo.com/api
 
@@ -379,7 +252,6 @@ 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

@@ -61,13 +61,6 @@ module Vonage
       @files ||= T.let(Files.new(config), T.nilable(Vonage::Files))
     end
 
-    # @return [Meetings]
-    #
-    sig { returns(T.nilable(Vonage::Meetings)) }
-    def meetings
-      @meetings ||= T.let(Meetings.new(config), T.nilable(Vonage::Meetings))
-    end
-
     # @return [Messages]
     #
     sig { returns(T.nilable(Vonage::Messages)) }
@@ -103,13 +96,6 @@ module Vonage
       @pricing ||= T.let(PricingTypes.new(config), T.nilable(Vonage::PricingTypes))
     end
 
-    # @return [ProactiveConnect]
-    #
-    sig { returns(T.nilable(Vonage::ProactiveConnect)) }
-    def proactive_connect
-      @proactive_connect ||= T.let(ProactiveConnect.new(config), T.nilable(Vonage::ProactiveConnect))
-    end
-
     # @return [Redact]
     #
     sig { returns(T.nilable(Vonage::Redact)) }
@@ -131,13 +117,6 @@ module Vonage
       @sms ||= T.let(SMS.new(config), T.nilable(Vonage::SMS))
     end
 
-    # @return [Subaccounts]
-    #
-    sig { returns(T.nilable(Vonage::Subaccounts)) }
-    def subaccounts
-      @subaccounts ||= T.let(Subaccounts.new(config), T.nilable(Vonage::Subaccounts))
-    end
-
     # @return [TFA]
     #
     sig { returns(T.nilable(Vonage::TFA)) }
@@ -145,13 +124,6 @@ module Vonage
       @tfa ||= T.let(TFA.new(config), T.nilable(Vonage::TFA))
     end
 
-    # @return [Users]
-    #
-    sig { returns(T.nilable(Vonage::Users)) }
-    def users
-      @users ||= T.let(Users.new(config), T.nilable(Vonage::Users))
-    end
-
     # @return [Verify]
     #
     sig { returns(T.nilable(Vonage::Verify)) }
@@ -159,11 +131,11 @@ module Vonage
       @verify ||= T.let(Verify.new(config), T.nilable(Vonage::Verify))
     end
 
-    # @return [Verify2]
+    # @return [Video]
     #
-    sig { returns(T.nilable(Vonage::Verify2)) }
-    def verify2
-      @verify2 ||= T.let(Verify2.new(config), T.nilable(Vonage::Verify2))
+    sig { returns(T.nilable(Vonage::Video)) }
+    def video
+      @video ||= T.let(Video.new(config), T.nilable(Vonage::Video))
     end
 
     # @return [Voice]

data/lib/vonage/config.rb

@@ -18,7 +18,7 @@ module Vonage
       self.signature_secret = ENV['VONAGE_SIGNATURE_SECRET']
       self.signature_method = ENV['VONAGE_SIGNATURE_METHOD'] || 'md5hash'
       self.token = T.let(nil, T.nilable(String))
-      self.vonage_host = 'api-eu.vonage.com'
+      self.video_host = 'video.api.vonage.com'
     end
 
     # Merges the config with the given options hash.
@@ -200,7 +200,7 @@ module Vonage
     attr_writer :token
 
     sig { returns(String) }
-    attr_accessor :vonage_host
+    attr_accessor :video_host
 
     protected
 

data/lib/vonage/errors.rb

@@ -1,25 +1,14 @@
 # typed: strict
 # frozen_string_literal: true
-require "json"
+require 'json'
 
 module Vonage
   module Errors
     extend T::Sig
 
-    sig do
-      params(
-        response:
-          T.any(
-            Net::HTTPUnauthorized,
-            Net::HTTPClientError,
-            Net::HTTPServerError,
-            T.untyped
-          )
-      ).returns(Vonage::Error)
-    end
+    sig {params(response: T.any(Net::HTTPUnauthorized, Net::HTTPClientError, Net::HTTPServerError, T.untyped)).returns(Vonage::Error)}
     def self.parse(response)
-      exception_class =
-        case response
+      exception_class = case response
         when Net::HTTPUnauthorized
           AuthenticationError
         when Net::HTTPClientError
@@ -30,34 +19,31 @@ module Vonage
           Error
         end
 
-      message =
-        if response.content_type == "application/json"
-          hash = ::JSON.parse(response.body)
-
-          if hash.key?("error_title")
-            hash["error_title"]
-          elsif hash.key?("error-code-label")
-            hash["error-code-label"]
-          elsif hash.key?("description")
-            hash["description"]
-          elsif hash.key?("message")
-            hash["message"]
-          elsif problem_details?(hash)
-            problem_details_message(hash)
-          end
+      message = if response.content_type == 'application/json'
+        hash = ::JSON.parse(response.body)
+
+        if hash.key?('error_title')
+          hash['error_title']
+        elsif hash.key?('error-code-label')
+          hash['error-code-label']
+        elsif hash.key?('description')
+          hash['description']
+        elsif problem_details?(hash)
+          problem_details_message(hash)
         end
+      end
 
       exception_class.new(message)
     end
 
     sig { params(hash: T::Hash[String, T.untyped]).returns(T::Boolean) }
     def self.problem_details?(hash)
-      hash.key?("title") && hash.key?("detail") && hash.key?("type")
+      hash.key?('title') && hash.key?('detail') && hash.key?('type')
     end
 
     sig { params(hash: T::Hash[String, T.untyped]).returns(String) }
     def self.problem_details_message(hash)
-      "#{hash["title"]}. #{hash["detail"]} See #{hash["type"]} for more info, or email support@nexmo.com if you have any questions."
+      "#{hash['title']}. #{hash['detail']} See #{hash['type']} for more info, or email support@nexmo.com if you have any questions."
     end
   end
 

data/lib/vonage/gsm7.rb

@@ -4,7 +4,7 @@ module Vonage
   module GSM7
     extend T::Sig
     
-    CHARACTERS = "\n\f\r !\"\#$%&'()*+,-./0123456789:;<=>?@ABCDEFGHIJKLMNOPQRSTUVWXYZ[\\]^_abcdefghijklmnopqrstuvwxyz{|}~ ¡£¤¥§¿ÄÅÆÇÉÑÖØÜßàäåæèéìñòöøùüΓΔΘΛΞΠΣΦΨΩ€"
+    CHARACTERS = "\n\f\r !\"\#$%&'()*+,-./0123456789:;<=>?@ABCDEFGHIJKLMNOPQRSTUVWXYZ[\\]^_abcdefghijklmnopqrstuvwxyz{|}~ ¡£¤¥§¿ÄÅÆÉÑÖØÜßàäåæçèéìñòöøùüΓΔΘΛΞΠΣΦΨΩ€"
 
     REGEXP = /\A[#{Regexp.escape(CHARACTERS)}]*\z/
 

data/lib/vonage/keys.rb

@@ -21,7 +21,13 @@ module Vonage
         'voice_callback_value',
         'voice_status_callback',
         'messages_callback_value',
-        'messages_callback_type'
+        'messages_callback_type',
+        'add_stream',
+        'has_audio',
+        'has_video',
+        'remove_stream',
+        'screenshare_type',
+        'archive_mode'
       ]
       hash.transform_keys do |k|
         if exceptions.include?(k.to_s)

data/lib/vonage/messaging/channels/viber.rb

@@ -2,7 +2,7 @@
 
 module Vonage
   class Messaging::Channels::Viber  < Messaging::Message
-    MESSAGE_TYPES = ['text', 'image', 'video', 'file']
+    MESSAGE_TYPES = ['text', 'image']
 
     attr_reader :data
 
@@ -33,13 +33,6 @@ module Vonage
       when 'image'
         raise Vonage::ClientError.new(":message must be a Hash") unless message.is_a? Hash
         raise Vonage::ClientError.new(":url is required in :message") unless message[:url]
-      when 'video'
-        raise Vonage::ClientError.new(":message must be a Hash") unless message.is_a? Hash
-        raise Vonage::ClientError.new(":url is required in :message") unless message[:url]
-        raise Vonage::ClientError.new(":thumb_url is required in :message") unless message[:thumb_url]
-      when 'file'
-        raise Vonage::ClientError.new(":message must be a Hash") unless message.is_a? Hash
-        raise Vonage::ClientError.new(":url is required in :message") unless message[:url]
       end
     end
   end

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

@@ -2,7 +2,7 @@
 
 module Vonage
   class Messaging::Channels::WhatsApp < Messaging::Message
-    MESSAGE_TYPES = ['text', 'image', 'audio', 'video', 'file', 'template', 'sticker', 'custom']
+    MESSAGE_TYPES = ['text', 'image', 'audio', 'video', 'file', 'template', 'custom']
 
     attr_reader :data
 
@@ -35,8 +35,6 @@ module Vonage
         raise Vonage::ClientError.new(":name is required in :template") unless message[:name]
         raise Vonage::ClientError.new(":whatsapp is required in :opts") unless opts[:whatsapp]
         raise Vonage::ClientError.new(":locale is required in :whatsapp") unless opts[:whatsapp][:locale]
-      when 'sticker'
-        raise Vonage::ClientError.new(":message must contain either :id or :url") unless message.has_key?(:id) ^ message.has_key?(:url)
       when 'custom'
         raise Vonage::ClientError.new(":message must be a Hash") unless message.is_a? Hash
       else