nexmo 6.1.0 → 7.1.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 991aaf647a8a483780486cdf6ad8393305d9e597aeeda649c404e8ce4ba4f858
-  data.tar.gz: 5849c75718751dc5b4c6d7fc0c205b224e19a5527ca536176bbd30956a916fda
+  metadata.gz: 30bb0f469e9a1f2f85455d1ac2e0524bbc29a95589d4a87cb61a71b2667fe939
+  data.tar.gz: 92790dada4fd50a470e97214d0b0aa3584ac6d0e75fcc350ed912c3b7fc79886
 SHA512:
-  metadata.gz: 2ad6c409666f784c59656bb55c793ea5e1885c6bee593fb866259edbfecd178b62d89214946ba4ab2bce1c6a36a71f2149a584b8d0781de0978eab2e498a9cbc
-  data.tar.gz: f91e6bbcbf7de8a41a88411d47c58529b0c204780a25c5f827cac682cfe17e162c33193c86928f6ba39b4cf452f0303c7d75ded9281ddbf41b4cf2892a2f5d0f
+  metadata.gz: ff3fcd89549bfcd1c98db024e2bace02b2b2e63780a3171dd2a31af84db1ea5e6e4efe7e1ac361f488d1f2964a3fc11a0e20b575cbef76e0b92a44d97ee15b6b
+  data.tar.gz: ae131dac65585a7544770b4f7d68b002605273a3e79b2293f7f9885049872ccfdb13a48328aa284df07dae1c2862655bb5b3e818abd8a22cc14fd5c0d8e93db9

data/LICENSE.txt

@@ -1,6 +1,6 @@
 The MIT License (MIT)
 
-Copyright (c) 2016-2019 Nexmo Inc
+Copyright (c) 2016-2020 Nexmo Inc
 
 Permission is hereby granted, free of charge, to any person
 obtaining a copy of this software and associated documentation

data/README.md

@@ -2,15 +2,18 @@
 
 [![Gem Version](https://badge.fury.io/rb/nexmo.svg)](https://badge.fury.io/rb/nexmo) [![Build Status](https://api.travis-ci.org/Nexmo/nexmo-ruby.svg?branch=master)](https://travis-ci.org/Nexmo/nexmo-ruby) [![Coverage Status](https://coveralls.io/repos/github/Nexmo/nexmo-ruby/badge.svg?branch=coveralls)](https://coveralls.io/github/Nexmo/nexmo-ruby?branch=master)
 
+<img src="https://developer.nexmo.com/assets/images/Vonage_Nexmo.svg" height="48px" alt="Nexmo is now known as Vonage" />
+
 This is the Ruby client library for Nexmo's API. To use it you'll
 need a Nexmo account. Sign up [for free at nexmo.com][signup].
 
 * [Requirements](#requirements)
 * [Installation](#installation)
 * [Usage](#usage)
-* [Logging](#logging)
-* [JWT authentication](#jwt-authentication)
-* [Webhook signatures](#webhook-signatures)
+    * [Logging](#logging)
+    * [Overriding the default hosts](#overriding-the-default-hosts)
+    * [JWT authentication](#jwt-authentication)
+    * [Webhook signatures](#webhook-signatures)
 * [Documentation](#documentation)
 * [License](#license)
 
@@ -73,6 +76,21 @@ By default the library sets the logger to `Rails.logger` if it is defined.
 To disable logging set the logger to `nil`.
 
 
+## Overriding the default hosts
+
+To override the default hosts that the SDK uses for HTTP requests, you need to
+specify the `api_host`, `rest_host` or both in the client configuration. For example:
+
+```ruby
+client = Nexmo::Client.new(
+  api_host: 'api-sg-1.nexmo.com',
+  rest_host: 'rest-sg-1.nexmo.com'
+)
+```
+
+By default the hosts are set to `api.nexmo.com` and `rest.nexmo.com`, respectively.
+
+
 ## JWT authentication
 
 To call newer endpoints that support JWT authentication such as the Voice API you'll
@@ -112,7 +130,9 @@ client = Nexmo::Client.new(token: token)
 To check webhook signatures you'll also need to specify the `signature_secret` option. For example:
 
 ```ruby
-client = Nexmo::Client.new(signature_secret: 'secret')
+client = Nexmo::Client.new
+client.config.signature_secret = 'secret'
+client.config.signature_method = 'sha512'
 
 if client.signature.check(request.GET)
   # valid signature

data/lib/nexmo.rb

@@ -1,23 +1,21 @@
+# typed: true
 # frozen_string_literal: true
 require 'zeitwerk'
+require 'sorbet-runtime'
 
 module Nexmo
-  class ZeitwerkInflector < Zeitwerk::Inflector
-    def camelize(basename, _abspath)
-      case basename
-      when 'http', 'json', 'jwt', 'sms', 'tfa', 'gsm7', 'dtmf', 'version'
-        basename.upcase
-      else
-        super
-      end
-    end
-  end
-
-  private_constant :ZeitwerkInflector
-
   loader = Zeitwerk::Loader.new
   loader.tag = File.basename(__FILE__, '.rb')
-  loader.inflector = ZeitwerkInflector.new
+  loader.inflector.inflect({
+    'dtmf' => 'DTMF',
+    'gsm7' => 'GSM7',
+    'http' => 'HTTP',
+    'json' => 'JSON',
+    'jwt' => 'JWT',
+    'sms' => 'SMS',
+    'tfa' => 'TFA',
+    'version' => 'VERSION',
+  })
   loader.push_dir(__dir__)
   loader.setup
 

data/lib/nexmo/abstract_authentication.rb

@@ -1,3 +1,5 @@
+# typed: ignore
+
 module Nexmo
   class AbstractAuthentication
     def initialize(config)

data/lib/nexmo/account.rb

@@ -1,10 +1,12 @@
+# typed: strict
 # frozen_string_literal: true
 
 module Nexmo
   class Account < Namespace
+    extend T::Sig
     include Keys
 
-    self.host = 'rest.nexmo.com'
+    self.host = :rest_host
 
     # Retrieve your account balance.
     #
@@ -12,6 +14,7 @@ module Nexmo
     #
     # @see https://developer.nexmo.com/api/developer/account#get-balance
     #
+    sig { returns(Nexmo::Response) }
     def balance
       request('/account/get-balance')
     end
@@ -34,6 +37,7 @@ module Nexmo
     #
     # @see https://developer.nexmo.com/api/developer/account#settings
     #
+    sig { params(params: T::Hash[Symbol, T.untyped]).returns(Nexmo::Response) }
     def update(params)
       request('/account/settings', params: camelcase(params), type: Post)
     end
@@ -49,6 +53,7 @@ module Nexmo
     #
     # @see https://developer.nexmo.com/api/developer/account#top-up
     #
+    sig { params(params: T::Hash[Symbol, T.untyped]).returns(Nexmo::Response) }
     def topup(params)
       request('/account/top-up', params: params, type: Post)
     end

data/lib/nexmo/alerts.rb

@@ -1,8 +1,10 @@
+# typed: strict
 # frozen_string_literal: true
 
 module Nexmo
   class Alerts < Namespace
-    self.host = 'rest.nexmo.com'
+    extend T::Sig
+    self.host = :rest_host
 
     # Request the list of phone numbers opted out from your campaign.
     #
@@ -10,6 +12,7 @@ module Nexmo
     #
     # @return [Response]
     #
+    sig { returns(Nexmo::Response) }
     def list
       request('/sc/us/alert/opt-in/query/json')
     end
@@ -25,6 +28,7 @@ module Nexmo
     #
     # @see https://developer.nexmo.com/api/sms/us-short-codes/alerts/subscription
     #
+    sig { params(params: T::Hash[Symbol, T.untyped]).returns(Nexmo::Response) }
     def remove(params)
       request('/sc/us/alert/opt-in/manage/json', params: params, type: Post)
     end
@@ -60,6 +64,7 @@ module Nexmo
     #
     # @see https://developer.nexmo.com/api/sms/us-short-codes/alerts/sending
     #
+    sig { params(params: T::Hash[Symbol, T.untyped]).returns(Nexmo::Response) }
     def send(params)
       request('/sc/us/alert/json', params: params, type: Post)
     end

data/lib/nexmo/applications.rb

@@ -1,7 +1,9 @@
+# typed: strict
 # frozen_string_literal: true
 
 module Nexmo
   class Applications < Namespace
+    extend T::Sig
     self.authentication = Basic
 
     self.request_body = JSON
@@ -13,9 +15,20 @@ module Nexmo
     # @example
     #   params = {
     #     name: 'Example App',
-    #     type: 'voice',
-    #     answer_url: answer_url,
-    #     event_url: event_url
+    #     capabilities: {
+    #       'messages': {
+    #         'webhooks': {
+    #           'inbound_url': {
+    #             'address': 'https://example.com/webhooks/inbound',
+    #             'http_method': 'POST'
+    #           },
+    #           'status_url': {
+    #             'address': 'https://example.com/webhooks/status',
+    #             'http_method': 'POST'
+    #           }
+    #         }
+    #       }
+    #     }
     #   }
     #
     #   response = client.applications.create(params)
@@ -37,6 +50,7 @@ module Nexmo
     #
     # @see https://developer.nexmo.com/api/application.v2#createApplication
     #
+    sig { params(params: T::Hash[Symbol, T.untyped]).returns(Nexmo::Response) }
     def create(params)
       request('/v2/applications', params: params, type: Post)
     end
@@ -61,6 +75,7 @@ module Nexmo
     #
     # @see https://developer.nexmo.com/api/application.v2#listApplication
     #
+    sig { params(params: T.nilable(T::Hash[Symbol, Integer])).returns(Nexmo::Response) }
     def list(params = nil)
       request('/v2/applications', params: params, response_class: ListResponse)
     end
@@ -76,6 +91,7 @@ module Nexmo
     #
     # @see https://developer.nexmo.com/api/application.v2#getApplication
     #
+    sig { params(id: String).returns(Nexmo::Response) }
     def get(id)
       request('/v2/applications/' + id)
     end
@@ -103,6 +119,10 @@ module Nexmo
     #
     # @see https://developer.nexmo.com/api/application.v2#updateApplication
     #
+    sig { params(
+      id: String,
+      params: T::Hash[Symbol, T.untyped]
+    ).returns(Nexmo::Response) }
     def update(id, params)
       request('/v2/applications/' + id, params: params, type: Put)
     end
@@ -120,6 +140,7 @@ module Nexmo
     #
     # @see https://developer.nexmo.com/api/application.v2#deleteApplication
     #
+    sig { params(id: String).returns(Nexmo::Response) }
     def delete(id)
       request('/v2/applications/' + id, type: Delete)
     end

data/lib/nexmo/applications/list_response.rb

@@ -1,3 +1,5 @@
+# typed: ignore
+
 class Nexmo::Applications::ListResponse < Nexmo::Response
   include Enumerable
 

data/lib/nexmo/authentication_error.rb

@@ -1,3 +1,5 @@
+# typed: strong
+
 module Nexmo
   class AuthenticationError < ClientError
   end

data/lib/nexmo/basic.rb

@@ -1,3 +1,5 @@
+# typed: ignore
+
 module Nexmo
   class Basic < AbstractAuthentication
     def update(object)

data/lib/nexmo/bearer_token.rb

@@ -1,3 +1,4 @@
+# typed: ignore
 # frozen_string_literal: true
 
 module Nexmo

data/lib/nexmo/client.rb

@@ -1,111 +1,134 @@
+# typed: strict
+
 module Nexmo
   class Client
+    extend T::Sig
+
+    sig { returns(Nexmo::Config) }
     attr_reader :config
 
+    sig { params(options: T.nilable(T::Hash[Symbol, T.untyped])).void }
     def initialize(options = nil)
-      @config = Nexmo.config.merge(options)
+      @config = T.let(Nexmo.config.merge(options), Nexmo::Config)
     end
 
     # @return [Signature]
     #
+    sig { returns(T.nilable(Nexmo::Signature)) }
     def signature
-      @signature ||= Signature.new(config)
+      @signature ||= T.let(Signature.new(config), T.nilable(Nexmo::Signature))
     end
 
     # @return [Account]
     #
+    sig { returns(T.nilable(Nexmo::Account)) }
     def account
-      @account ||= Account.new(config)
+      @account ||= T.let(Account.new(config), T.nilable(Nexmo::Account))
     end
 
     # @return [Alerts]
     #
+    sig { returns(T.nilable(Nexmo::Alerts)) }
     def alerts
-      @alerts ||= Alerts.new(config)
+      @alerts ||= T.let(Alerts.new(config), T.nilable(Nexmo::Alerts))
     end
 
     # @return [Applications]
     #
+    sig { returns(T.nilable(Nexmo::Applications)) }
     def applications
-      @applications ||= Applications.new(config)
-    end
-
-    # @return [Calls]
-    #
-    def calls
-      @calls ||= Calls.new(config)
+      @applications ||= T.let(Applications.new(config), T.nilable(Nexmo::Applications))
     end
 
     # @return [Conversations]
     #
+    sig { returns(T.nilable(Nexmo::Conversations)) }
     def conversations
-      @conversations ||= Conversations.new(config)
+      @conversations ||= T.let(Conversations.new(config), T.nilable(Nexmo::Conversations))
     end
 
     # @return [Conversions]
     #
+    sig { returns(T.nilable(Nexmo::Conversions)) }
     def conversions
-      @conversions ||= Conversions.new(config)
+      @conversions ||= T.let(Conversions.new(config), T.nilable(Nexmo::Conversions))
     end
 
     # @return [Files]
     #
+    sig { returns(T.nilable(Nexmo::Files)) }
     def files
-      @files ||= Files.new(config)
+      @files ||= T.let(Files.new(config), T.nilable(Nexmo::Files))
     end
 
     # @return [Messages]
     #
+    sig { returns(T.nilable(Nexmo::Messages)) }
     def messages
-      @messages ||= Messages.new(config)
+      @messages ||= T.let(Messages.new(config), T.nilable(Nexmo::Messages))
     end
 
     # @return [NumberInsight]
     #
+    sig { returns(T.nilable(Nexmo::NumberInsight)) }
     def number_insight
-      @number_insight ||= NumberInsight.new(config)
+      @number_insight ||= T.let(NumberInsight.new(config), T.nilable(Nexmo::NumberInsight))
     end
 
     # @return [Numbers]
     #
+    sig { returns(T.nilable(Nexmo::Numbers)) }
     def numbers
-      @numbers ||= Numbers.new(config)
+      @numbers ||= T.let(Numbers.new(config), T.nilable(Nexmo::Numbers))
     end
 
     # @return [PricingTypes]
     #
+    sig { returns(T.nilable(Nexmo::PricingTypes)) }
     def pricing
-      @pricing ||= PricingTypes.new(config)
+      @pricing ||= T.let(PricingTypes.new(config), T.nilable(Nexmo::PricingTypes))
     end
 
     # @return [Redact]
     #
+    sig { returns(T.nilable(Nexmo::Redact)) }
     def redact
-      @redact ||= Redact.new(config)
+      @redact ||= T.let(Redact.new(config), T.nilable(Nexmo::Redact))
     end
 
     # @return [Secrets]
     #
+    sig { returns(T.nilable(Nexmo::Secrets)) }
     def secrets
-      @secrets ||= Secrets.new(config)
+      @secrets ||= T.let(Secrets.new(config), T.nilable(Nexmo::Secrets))
     end
 
     # @return [SMS]
     #
+    sig { returns(T.nilable(Nexmo::SMS)) }
     def sms
-      @sms ||= SMS.new(config)
+      @sms ||= T.let(SMS.new(config), T.nilable(Nexmo::SMS))
     end
 
     # @return [TFA]
     #
+    sig { returns(T.nilable(Nexmo::TFA)) }
     def tfa
-      @tfa ||= TFA.new(config)
+      @tfa ||= T.let(TFA.new(config), T.nilable(Nexmo::TFA))
     end
 
     # @return [Verify]
     #
+    sig { returns(T.nilable(Nexmo::Verify)) }
     def verify
-      @verify ||= Verify.new(config)
+      @verify ||= T.let(Verify.new(config), T.nilable(Nexmo::Verify))
+    end
+
+    # @return [Voice]
+    #
+    sig { returns(T.nilable(Nexmo::Voice)) }
+    def voice
+      @voice ||= T.let(Voice.new(config), T.nilable(Nexmo::Voice))
     end
   end
 end