vonage 7.29.1 → 8.0.0.beta

data/lib/vonage/subaccounts/credit_transfers/list_response.rb

@@ -1,11 +0,0 @@
-# typed: true
-
-class Vonage::Subaccounts::CreditTransfers::ListResponse < Vonage::Response
-  include Enumerable
-
-  def each
-    return enum_for(:each) unless block_given?
-
-    @entity._embedded.credit_transfers.each { |item| yield item }
-  end
-end

data/lib/vonage/subaccounts/list_response.rb

@@ -1,15 +0,0 @@
-# typed: true
-
-class Vonage::Subaccounts::ListResponse < Vonage::Response
-  include Enumerable
-
-  def primary_account
-    @entity._embedded.primary_account
-  end
-
-  def each
-    return enum_for(:each) unless block_given?
-
-    @entity._embedded.subaccounts.each { |item| yield item }
-  end
-end

data/lib/vonage/subaccounts.rb

@@ -1,203 +0,0 @@
-# typed: strict
-# frozen_string_literal: true
-
-module Vonage
-  class Subaccounts < Namespace
-    self.authentication = Basic
-
-    self.request_body = JSON
-
-    # Retrieve list of subaccounts.
-    #
-    # @example
-    #   response = client.subaccounts.list
-    #
-    # @see https://developer.vonage.com/en/api/subaccounts#retrieveSubaccountsList
-    #
-    def list
-      request("/accounts/#{@config.api_key}/subaccounts", response_class: ListResponse)
-    end
-
-    # Retrieve a subaccount.
-    #
-    # @example
-    #   response = client.subaccounts.find(subaccount_key: 'abc123')
-    #
-    # @option params [required, String] :subaccount_key
-    #   The API key for the subaccount you want to retrieve
-    #
-    # @see https://developer.vonage.com/en/api/subaccounts#retrieveSubaccount
-    #
-    def find(subaccount_key:)
-      request("/accounts/#{@config.api_key}/subaccounts/#{subaccount_key}")
-    end
-
-    # Create a subaccount.
-    #
-    # @example
-    #   response = client.subaccounts.create(name: 'Foo')
-    #
-    # @option params [required, String] :name
-    #   The name of the subaccount
-    #
-    # @option params [optional, String] :secret
-    #   An account secret for use by the subaccount. Can be used in combination with your API key to authenticate your API requests.
-    #   Requirements:
-    #     - 8 characters and no more than 25
-    #     - 1 lower-case letter
-    #     - 1 capital letter
-    #     - 1 digit
-    #     - must be unique
-    #
-    # @option params [optional, Boolean] :use_primary_account_balance
-    #   Whether the subaccount uses the primary account balance (true, the default) or has its own balance (false).
-    #   Once set to `false` cannot be changed back to `true`
-    #
-    # @see https://developer.vonage.com/en/api/subaccounts#createSubAccount
-    #
-    def create(name:, **params)
-      request("/accounts/#{@config.api_key}/subaccounts", params: params.merge(name: name), type: Post)
-    end
-
-    # Modify a subaccount.
-    #
-    # @example
-    #   response = client.subaccounts.update(name: 'Bar')
-    #
-    # @option params [required, String] :subaccount_key
-    #   The API key for the subaccount you want to modify
-    #
-    # @option params [optional, String] :name
-    #   The name of the subaccount
-    #
-    # @option params [optional, Boolean] :use_primary_account_balance
-    #   Whether the subaccount uses the primary account balance (true, the default) or has its own balance (false).
-    #   Once set to `false` cannot be changed back to `true`
-    #
-    # @option params [optional, String] :suspended
-    #   Whether the subaccount is suspended (true) or not (false, the default)
-    #
-    # @see https://developer.vonage.com/en/api/subaccounts#modifySubaccount
-    #
-    def update(subaccount_key:, **params)
-      request("/accounts/#{@config.api_key}/subaccounts/#{subaccount_key}", params: params, type: Patch)
-    end
-
-    # Retrieve list of credit transfers.
-    #
-    # @example
-    #   response = client.subaccounts.list_credit_transfers(start_date: "2023-06-15T15:53:50Z")
-    #
-    # @option params [optional, String] :start_date
-    #   The ISO format datetime from which to list transfers. Example: 2019-03-02T16:34:49Z.
-    #   Defaults to "1970-01-01T00:00:00Z" if omitted
-    #
-    # @option params [optional, String] :end_date
-    #   The ISO format datetime to which to list transfers. Example: 2019-03-02T16:34:49Z.
-    #   If absent then all transfers until now is returned.
-    #
-    # @option params [optional, String] :subaccount
-    #   Subaccount to filter by.
-    #
-    # @see https://developer.vonage.com/en/api/subaccounts#retrieveCreditTransfers
-    #
-    def list_credit_transfers(start_date: "1970-01-01T00:00:00Z", **params)
-      path = "/accounts/#{@config.api_key}/credit-transfers?#{Params.encode(params.merge(start_date: start_date))}"
-
-      request(path, response_class: CreditTransfers::ListResponse)
-    end
-
-    # Transfer credit.
-    #
-    # @example
-    #   response = client.subaccounts.transfer_credit(from: 'abc123', to: 'def456', amount: 10.00)
-    #
-    # @option params [required, String] :from
-    #   The API key of the account or subaccount to transfer credit from.
-    #
-    # @option params [required, String] :to
-    #   The API key of the account or subaccount to transfer credit to.
-    #
-    # @option params [required, Number] :amount
-    #   The amount to transfer
-    #
-    # @option params [optional, String] :reference
-    #   A reference for the transfer.
-    #
-    # @see https://developer.vonage.com/en/api/subaccounts#transferCredit
-    #
-    def transfer_credit(from:, to:, amount:, **params)
-      request("/accounts/#{@config.api_key}/credit-transfers", params: params.merge(from: from, to: to, amount: amount), type: Post)
-    end
-
-    # Retrieve list of balance transfers.
-    #
-    # @example
-    #   response = client.subaccounts.list_balance_transfers(start_date: "2023-06-15T15:53:50Z")
-    #
-    # @option params [optional, String] :start_date
-    #   The ISO format datetime from which to list transfers. Example: 2019-03-02T16:34:49Z.
-    #   Defaults to "1970-01-01T00:00:00Z" if omitted
-    #
-    # @option params [optional, String] :end_date
-    #   The ISO format datetime to which to list transfers. Example: 2019-03-02T16:34:49Z.
-    #   If absent then all transfers until now is returned.
-    #
-    # @option params [optional, String] :subaccount
-    #   Subaccount to filter by.
-    #
-    # @see https://developer.vonage.com/en/api/subaccounts#retrieveBalanceTransfers
-    #
-    def list_balance_transfers(start_date: "1970-01-01T00:00:00Z", **params)
-      path = "/accounts/#{@config.api_key}/balance-transfers?#{Params.encode(params.merge(start_date: start_date))}"
-
-      request(path, response_class: BalanceTransfers::ListResponse)
-    end
-
-    # Transfer balance.
-    #
-    # @example
-    #   response = client.subaccounts.transfer_balance(from: 'abc123', to: 'def456', amount: 10.00)
-    #
-    # @option params [required, String] :from
-    #   The API key of the account or subaccount to transfer balance from.
-    #
-    # @option params [required, String] :to
-    #   The API key of the account or subaccount to transfer balance to.
-    #
-    # @option params [required, Number] :amount
-    #   The amount to transfer
-    #
-    # @option params [optional, String] :reference
-    #   A reference for the transfer.
-    #
-    # @see https://developer.vonage.com/en/api/subaccounts#transferBalance
-    #
-    def transfer_balance(from:, to:, amount:, **params)
-      request("/accounts/#{@config.api_key}/balance-transfers", params: params.merge(from: from, to: to, amount: amount), type: Post)
-    end
-
-    # Transfer number.
-    #
-    # @example
-    #   response = client.subaccounts.transfer_number(from: 'abc123', to: 'def456', number: 447900000000, country: 'GB')
-    #
-    # @option params [required, String] :from
-    #   The API key of the account or subaccount to transfer the number from.
-    #
-    # @option params [required, String] :to
-    #   The API key of the account or subaccount to transfer the number to.
-    #
-    # @option params [required, Number] :number
-    #   The number to transfer
-    #
-    # @option params [required, String] :country
-    #   An ISO-3166-1 alpha 2 code representing the country for the number, e.g. GB.
-    #
-    # @see https://developer.vonage.com/en/api/subaccounts#transferNumber
-    #
-    def transfer_number(from:, to:, number:, country:)
-      request("/accounts/#{@config.api_key}/transfer-number", params: {from: from, to: to, number: number, country: country}, type: Post)
-    end
-  end
-end

data/lib/vonage/users/list_response.rb

@@ -1,11 +0,0 @@
-# typed: true
-
-class Vonage::Users::ListResponse < Vonage::Response
-  include Enumerable
-
-  def each
-    return enum_for(:each) unless block_given?
-
-    @entity._embedded.users.each { |item| yield item }
-  end
-end

data/lib/vonage/users.rb

@@ -1,156 +0,0 @@
-# typed: strict
-# frozen_string_literal: true
-
-module Vonage
-  class Users < Namespace
-    extend T::Sig
-    self.authentication = BearerToken
-
-    self.request_body = JSON
-
-    # Get a list of Users associated with the Vonage Application.
-    #
-    # @param [optional, Integer] :page_size
-    #   Specifies the number of records to be returned in the response.
-    #
-    # @param [optional, String] :order
-    #   Specifies the order in which the records should be returned.
-    #   Must be one of `asc`, `ASC`, `desc`, or `DESC`
-    #
-    # @param [optional, String] :cursor
-    #   Specficy a cursor point from which to start returning results, for example the values of the `next` or `prev`
-    #   `_links` contained in a response.
-    #
-    # @param [optional, String] :name
-    #   Specify a user name with which to filter results
-    #
-    # @return [ListResponse]
-    #
-    # @see https://developer.vonage.com/en/api/application.v2#getUsers
-    #
-    def list(**params)
-      request('/v1/users', params: params, response_class: ListResponse)
-    end
-
-    # Get a specified User associated with the Vonage Application.
-    #
-    # @param [required, String] :id
-    #   The unique ID or name for the user.
-    #
-    # @return [Vonage::Response]
-    #
-    # @see https://developer.vonage.com/en/api/application.v2#getUser
-    #
-    def find(id:)
-      request("/v1/users/#{id}")
-    end
-
-    # Create a new User associated with the Vonage Application.
-    #
-    # @param [optional, String] :name
-    #   A unique name for the user. If not provided, a name will be auto-generated.
-    #
-    # @param [optional, String] :display_name
-    #   A string to be displayed as user name. It does not need to be unique.
-    #
-    # @param [optional, String] :image_url
-    #   A publicly accessible URL to an image file for an image to be associated with the user.
-    #
-    # @param [optional, Hash] :properties A hash defining properties for the User.
-    #   @option properties [Hash] :custom_data A hash of custom data as key/value pairs.
-    #
-    # @param [optional, Hash] :channels A hash defining details of various channels.
-    #   @option channels [Array] :pstn An array containing a Hash which defines data for the pstn channel.
-    #     @option pstn [Integer] :number The pstn number.
-    #   @option channels [Array] :sip An array containing a Hash which defines data for the sip channel.
-    #     @option sip [String] :uri The sip uri.
-    #     @option sip [String] :username The sip username.
-    #     @option sip [String] :password The sip password.
-    #   @option channels [Array] :vbc An array containing a Hash which defines data for the vbc channel.
-    #     @option vbc [String] :extension The vbc extension.
-    #   @option channels [Array] :websocket An array containing a Hash which defines data for the websocket channel.
-    #     @option websocket [String] :uri The websocket uri.
-    #     @option websocket [String] :content-type The websocket audio type. Must be one of: `audio/l16;rate=8000`, `audio/l16;rate=16000`.
-    #     @option websocket [Hash] :headers A hash of custom websocket headers provided as key/value pairs.
-    #   @option channels [Array] :sms An array containing a Hash which defines data for the sms channel.
-    #     @option sms [Integer] :number The sms number.
-    #   @option channels [Array] :mms An array containing a Hash which defines data for the mms channel.
-    #     @option mms [Integer] :number The mms number.
-    #   @option channels [Array] :whatsapp An array containing a Hash which defines data for the whatsapp channel.
-    #     @option whatsapp [Integer] :number The whatsapp number.
-    #   @option channels [Array] :viber An array containing a Hash which defines data for the sms channel.
-    #     @option viber [Integer] :number The viber number.
-    #   @option channels [Array] :messenger An array containing a Hash which defines data for the messenger channel.
-    #     @option messenger [Integer] :id The messenger id.
-    #
-    # @return [Vonage::Response]
-    #
-    # @see https://developer.vonage.com/en/api/application.v2#createUser
-    #
-    def create(**params)
-      request('/v1/users', params: params, type: Post)
-    end
-
-    # Update an existing User associated with the Vonage Application.
-    #
-    # @param [required, String] :id
-    #   The unique ID or name for the user to be updated.
-    #
-    # @param [optional, String] :name
-    #   A unique name for the user.
-    #
-    # @param [optional, String] :display_name
-    #   A string to be displayed as user name. It does not need to be unique.
-    #
-    # @param [optional, String] :image_url
-    #   A publicly accessible URL to an image file for an image to be associated with the user.
-    #
-    # @param [optional, Hash] :properties A hash defining properties for the User.
-    #   @option properties [Hash] :custom_data A hash of custom data as key/value pairs.
-    #
-    # @param [optional, Hash] :channels A hash defining details of various channels.
-    #   @option channels [Array] :pstn An array containing a Hash which defines data for the pstn channel.
-    #     @option pstn [Integer] :number The pstn number.
-    #   @option channels [Array] :sip An array containing a Hash which defines data for the sip channel.
-    #     @option sip [String] :uri The sip uri.
-    #     @option sip [String] :username The sip username.
-    #     @option sip [String] :password The sip password.
-    #   @option channels [Array] :vbc An array containing a Hash which defines data for the vbc channel.
-    #     @option vbc [String] :extension The vbc extension.
-    #   @option channels [Array] :websocket An array containing a Hash which defines data for the websocket channel.
-    #     @option websocket [String] :uri The websocket uri.
-    #     @option websocket [String] :content-type The websocket audio type. Must be one of: `audio/l16;rate=8000`, `audio/l16;rate=16000`.
-    #     @option websocket [Hash] :headers A hash of custom websocket headers provided as key/value pairs.
-    #   @option channels [Array] :sms An array containing a Hash which defines data for the sms channel.
-    #     @option sms [Integer] :number The sms number.
-    #   @option channels [Array] :mms An array containing a Hash which defines data for the mms channel.
-    #     @option mms [Integer] :number The mms number.
-    #   @option channels [Array] :whatsapp An array containing a Hash which defines data for the whatsapp channel.
-    #     @option whatsapp [Integer] :number The whatsapp number.
-    #   @option channels [Array] :viber An array containing a Hash which defines data for the sms channel.
-    #     @option viber [Integer] :number The viber number.
-    #   @option channels [Array] :messenger An array containing a Hash which defines data for the messenger channel.
-    #     @option messenger [Integer] :id The messenger id.
-    #
-    # @return [Vonage::Response]
-    #
-    # @see https://developer.vonage.com/en/api/application.v2#createUser
-    #
-    def update(id:, **params)
-      request("/v1/users/#{id}", params: params, type: Patch)
-    end
-
-    # Delete a specified User associated with the Vonage Application.
-    #
-    # @param [required, String] :id
-    #   The unique ID or name for the user.
-    #
-    # @return [Vonage::Response]
-    #
-    # @see https://developer.vonage.com/en/api/application.v2#deleteUser
-    #
-    def delete(id:)
-      request("/v1/users/#{id}", type: Delete)
-    end
-  end
-end

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

@@ -1,36 +0,0 @@
-# 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 unless from.nil?
-    end
-
-    def to=(to)
-      @to = to
-    end
-
-    def from=(from)
-      @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

@@ -1,45 +0,0 @@
-# typed: true
-# frozen_string_literal: true
-require 'phonelib'
-require 'uri'
-
-module Vonage
-  class Verify2::Channels::SilentAuth
-
-    attr_reader :channel, :to, :sandbox, :redirect_url
-
-    def initialize(to:, redirect_url: nil, sandbox: nil)
-      self.channel = 'silent_auth'
-      self.to = to
-      self.redirect_url = redirect_url unless redirect_url.nil?
-      self.sandbox = sandbox unless sandbox.nil?
-    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 redirect_url=(redirect_url)
-      raise ArgumentError, "Invalid 'to' value #{redirect_url}. Expected to be a valid URL" unless URI.parse(redirect_url).is_a?(URI::HTTP)
-      @redirect_url = redirect_url
-    end
-
-    def sandbox=(sandbox)
-      raise ArgumentError, "Invalid 'sandbox' value #{sandbox}. Expected to be boolean value" unless [true, false].include? sandbox
-      @sandbox = sandbox
-    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

@@ -1,63 +0,0 @@
-# typed: true
-# frozen_string_literal: true
-require 'phonelib'
-
-module Vonage
-  class Verify2::Channels::SMS
-    APP_HASH_LENGTH = 11
-
-    attr_reader :channel, :to, :from, :entity_id, :content_id, :app_hash
-
-    def initialize(to:, app_hash: nil)
-      self.channel = 'sms'
-      self.to = to
-      self.app_hash = app_hash unless app_hash.nil?
-    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 from=(from)
-      validate_from(from)
-      @from = from
-    end
-
-    def entity_id=(entity_id)
-      raise ArgumentError, "Invalid 'entity_id' value #{entity_id}. Length must be between 1 and 20 characters." unless entity_id.length.between?(1, 20)
-      @entity_id = entity_id
-    end
-
-    def content_id=(content_id)
-      raise ArgumentError, "Invalid 'content_id' value #{content_id}. Length must be between 1 and 20 characters ." unless content_id.length.between?(1, 20)
-      @content_id = content_id
-    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
-
-    def validate_from(from)
-      if from.match?(/\D/)
-        raise ArgumentError, "Invalid alpha-numeric 'from' value #{from}. Length must be between 3 and 11 characters." unless from.length.between?(3, 11)
-      else
-        raise ArgumentError, "Invalid numeric 'from' value #{from}. Length must be between 11 and 15 characters." unless from.length.between?(11, 15)
-        raise ArgumentError, "Invalid 'from' value #{from}. Expected to be in E.164 format" unless Phonelib.parse(from).valid?
-      end
-    end
-  end
-end

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

@@ -1,32 +0,0 @@
-# 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

@@ -1,39 +0,0 @@
-# typed: true
-# frozen_string_literal: true
-require 'phonelib'
-
-module Vonage
-  class Verify2::Channels::WhatsApp
-
-    attr_reader :channel, :to, :from
-
-    def initialize(to:, from:)
-      self.channel = 'whatsapp'
-      self.to = to
-      self.from = 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}. Length must be between 11 and 15 characters." unless from.length.between?(11, 15)
-      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

@@ -1,32 +0,0 @@
-# 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