vonage 7.20.0 → 8.0.0.beta

data/lib/vonage/proactive_connect/items/file_response.rb

@@ -1,32 +0,0 @@
-# typed: true
-
-class Vonage::ProactiveConnect::Items::FileResponse < Vonage::Response
-  DEFAULT_FILENAME = 'vonage-proactive-connect-list-items.csv'
-
-  attr_accessor :filename
-
-  def initialize(entity=nil, http_response=nil)
-    super
-    self.filename = initial_filename
-  end
-
-  def save(filepath:)
-    pn = Pathname.new(filepath)
-    raise ArgumentError, ':filepath not a directory' unless pn.directory?
-    raise ArgumentError, ':filepath not absolute' unless pn.absolute?
-    raise ArgumentError, ':filepath not writable' unless pn.writable?
-
-    File.open("#{pn.cleanpath}/#{filename}", 'w') {|f| f.write(http_response.body) }
-  end
-
-  def data
-    http_response ? http_response.body : nil
-  end
-
-  private
-
-  def initial_filename
-    match_data = http_response['Content-Disposition'].match(/filename=(\"?)(.+)\1/)
-    match_data ? match_data[2] : DEFAULT_FILENAME
-  end
-end

data/lib/vonage/proactive_connect/items/list_response.rb

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

data/lib/vonage/proactive_connect/items.rb

@@ -1,107 +0,0 @@
-# typed: true
-# frozen_string_literal: true
-
-module Vonage
-  class ProactiveConnect::Items < Namespace
-    extend T::Sig
-
-    self.authentication = BearerToken
-
-    self.host = :vonage_host
-
-    # Find all list items
-    #
-    # @example
-    #   response = proactive_connect.items.list(list_id: 'e546eebe-8e23-4e4d-bb7c-29d4700c9865')
-    #
-    # @param [required, String] :list_id
-    #   Unique identifier for the list
-    #
-    # @param [optional, String] :page
-    #   Page of results to jump to
-    #
-    # @param [optional, String] :page_size
-    #   Number of results per page
-    #
-    # @param [optional, String] order
-    #   Sort in either ascending (asc, the default) or descending (desc) order
-    #
-    # @see https://developer.vonage.com/en/api/proactive-connect#itemsFindAll
-    #
-    def list(list_id:, **params)
-      path = "/v0.1/bulk/lists/#{list_id}/items"
-      path += "?#{Params.encode(params)}" unless params.empty?
-
-      request(path, response_class: ListResponse)
-    end
-
-    # Download list items as a CSV file format
-    #
-    # @example
-    #   response = proactive_connect.items.download_csv(list_id: 'e546eebe-8e23-4e4d-bb7c-29d4700c9865')
-    #
-    # @param [required, String] :list_id
-    #   ID for the list to download
-    #
-    # @param [optional, String] order
-    #   Sort in either ascending (asc, the default) or descending (desc) order
-    #
-    # @param [optional, String] :filename
-    #   A name to set for the returned File object. If not set, the File object will use the actual filename (if available)
-    #     or a default of `download.csv` if the actual filename is not available.
-    #
-    # @param [optional, String] :filepath
-    #   A filepath to a directory where the file should be written.
-    #   If not set, the file is not written, though the the file can be written at any time by calling `save` on the returned
-    #     object and passing in `:filepath` as an argument to the `save` method, for example:
-    #       response = proactive_connect.items.download_csv(list_id: 'e546eebe-8e23-4e4d-bb7c-29d4700c9865')
-    #       response.save('/files/downloads/')
-    #   If set, the filepath must be:
-    #     - An absolute path
-    #     - For a valid directory
-    #     - The directory must be writable
-    #
-    # @see https://developer.vonage.com/en/api/proactive-connect#itemsDownload
-    #
-    def download_csv(list_id:, order: 'asc', **params)
-      response = request("/v0.1/bulk/lists/#{list_id}/items/download?order=#{order}", response_class: FileResponse)
-
-      response.filename = params[:filename] if params[:filename]
-      response.save(filepath: params[:filepath]) if params[:filepath]
-
-      response
-    end
-
-    # Import list items from a CSV file
-    #
-    # @example
-    #   response = proactive_connect.items.upload_csv(list_id: 'e546eebe-8e23-4e4d-bb7c-29d4700c9865', filepath: '/files/import.csv')
-    #
-    # @param [required, String] :list_id
-    #   ID for the list to download
-    #
-    # @param [optional, String] order
-    #   Sort in either ascending (asc, the default) or descending (desc) order
-    #
-    # @param [optional, String] :filename
-    #   A name to set for the returned File object. If not set, the File object will use the actual filename (if available)
-    #     or a default of `download.csv` if the actual filename is not available.
-    #
-    # @param [required, String] :filepath
-    #   A filepath for the file to import. The file must be:
-    #     - A valid file
-    #     - Readable
-    #     - Must have a `.csv` extension
-    #
-    # @see https://developer.vonage.com/en/api/proactive-connect#itemsImport
-    #
-    def upload_csv(list_id:, filepath:)
-      pn = Pathname.new(filepath)
-      raise ArgumentError, ':filepath not for a file' unless pn.file?
-      raise ArgumentError, 'file at :filepath not readable' unless pn.readable?
-      raise ArgumentError, 'file at :filepath not csv' unless pn.extname == '.csv'
-
-      multipart_post_request("/v0.1/bulk/lists/#{list_id}/items/import", filepath: filepath, file_name: pn.basename, mime_type: 'text/csv')
-    end
-  end
-end

data/lib/vonage/proactive_connect/list.rb

@@ -1,168 +0,0 @@
-# typed: true
-# frozen_string_literal: true
-
-module Vonage
-  class ProactiveConnect::List < Namespace
-    extend T::Sig
-
-    self.authentication = BearerToken
-
-    self.host = :vonage_host
-
-    self.request_body = JSON
-
-    # Create list
-    #
-    # @example
-    #   response = proactive_connect.list.create(name: 'List Number 1')
-    #
-    # @param [required, String] :name
-    #   A name for the list
-    #
-    # @param [optional, String] :description
-    #   A description of the list
-    #
-    # @param [optional, Array] :tags
-    #   An Array of up to 10 Strings assigining tags to the list. Each String must be between 1 and 15 characters
-    #
-    # @param [optional, Array] :attributes
-    #   Array of Hash objects. Each Hash represents an attribute for the list.
-    #
-    # @option attributes [required, String] :name
-    #   The name of the attribute
-    #
-    # @option attributes [optional, String] :alias
-    #   Alternative name to use for this attribute.
-    #   Use when you wish to correlate between 2 or more list that are using different attribute names for the same semantic data
-    #
-    # @option attributes [optional, Boolean] :key
-    #   Set to `true` if this attribute should be used to correlate between 2 or more lists. Default is `false`
-    #
-    # @param [optional, Hash] :datasource
-    #   Datasource for the list
-    #
-    # @option datasource [required, String] :type
-    #   Must be set to `manual`, which is the default
-    #
-    # @see https://developer.vonage.com/en/api/proactive-connect#listsCreate
-    #
-    def create(name:, **params)
-      request(
-        "/v0.1/bulk/lists",
-        params: params.merge({ name: name }),
-        type: Post
-      )
-    end
-
-    # Get list by id
-    #
-    # @example
-    #   response = proactive_connect.list.find(id: 'e546eebe-8e23-4e4d-bb7c-29d4700c9865')
-    #
-    # @param [required, String] :id
-    #   Unique identifier for the list
-    #
-    # @see https://developer.vonage.com/en/api/proactive-connect#listsGet
-    #
-    def find(id:)
-      request("/v0.1/bulk/lists/#{id}")
-    end
-
-    # Update list
-    #
-    # @example
-    #   response = proactive_connect.list.update(name: 'List Number 1')
-    #
-    # @param [required, String] :id
-    #   The id of the list to update
-    #
-    # @param [required, String] :name
-    #   The name of the list
-    #
-    # @param [optional, String] :description
-    #   A description of the list
-    #
-    # @param [optional, Array] :tags
-    #   An Array of up to 10 Strings assigining tags to the list. Each String must be between 1 and 15 characters
-    #
-    # @param [optional, Array] :attributes
-    #   Array of Hash objects. Each Hash represents an attribute for the list.
-    #
-    # @option attributes [required, String] :name
-    #   The name of the attribute
-    #
-    # @option attributes [optional, String] :alias
-    #   Alternative name to use for this attribute.
-    #   Use when you wish to correlate between 2 or more list that are using different attribute names for the same semantic data
-    #
-    # @option attributes [optional, Boolean] :key
-    #   Set to `true` if this attribute should be used to correlate between 2 or more lists. Default is `false`
-    #
-    # @param [optional, Hash] :datasource
-    #   Datasource for the list
-    #
-    # @option datasource [required, String] :type
-    #   Must be set to `manual`, which is the default
-    #
-    # @see https://developer.vonage.com/en/api/proactive-connect#listsUpdate
-    #
-    def update(id:, name:, **params)
-      request(
-        "/v0.1/bulk/lists/#{id}",
-        params: params.merge({ name: name }),
-        type: Put
-      )
-    end
-
-    # Delete a list by id
-    #
-    # @example
-    #   response = proactive_connect.list.delete(id: '74ea1ecf-06c9-4072-a285-61677bd353e8')
-    #
-    # @param [required, String] :id
-    #   Unique identifier for the list
-    #
-    # @see https://developer.vonage.com/en/api/proactive-connect#listsDelete
-    #
-    def delete(id:)
-      request(
-        "/v0.1/bulk/lists/#{id}",
-        type: Delete
-      )
-    end
-
-    # Clear list by deleting all items
-    #
-    # @example
-    #   response = proactive_connect.list.clear_items(id: 'e546eebe-8e23-4e4d-bb7c-29d4700c9865')
-    #
-    # @param [required, String] :id
-    #   Unique identifier for the list
-    #
-    # @see https://developer.vonage.com/en/api/proactive-connect#listsClear
-    #
-    def clear_items(id:)
-      request(
-        "/v0.1/bulk/lists/#{id}/clear",
-        type: Post
-      )
-    end
-
-    # Fetch and replace all items from datasource
-    #
-    # @example
-    #   response = proactive_connect.list.fetch_and_replace_items(id: 'e546eebe-8e23-4e4d-bb7c-29d4700c9865')
-    #
-    # @param [required, String] :id
-    #   Unique identifier for the list
-    #
-    # @see https://developer.vonage.com/en/api/proactive-connect#listsFetch
-    #
-    def fetch_and_replace_items(id:)
-      request(
-        "/v0.1/bulk/lists/#{id}/fetch",
-        type: Post
-      )
-    end
-  end
-end

data/lib/vonage/proactive_connect/lists/list_response.rb

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

data/lib/vonage/proactive_connect/lists.rb

@@ -1,35 +0,0 @@
-# typed: true
-# frozen_string_literal: true
-
-module Vonage
-  class ProactiveConnect::Lists < Namespace
-    extend T::Sig
-
-    self.authentication = BearerToken
-
-    self.host = :vonage_host
-
-    # Find all lists
-    #
-    # @example
-    #   response = proactive_connect.lists.list
-    #
-    # @param [optional, String] :page
-    #   Page of results to jump to
-    #
-    # @param [optional, String] :page_size
-    #   Number of results per page
-    #
-    # @param [optional, String] order
-    #   Sort in either ascending (asc, the default) or descending (desc) order
-    #
-    # @see https://developer.vonage.com/en/api/proactive-connect#listsFindAll
-    #
-    def list(**params)
-      path = "/v0.1/bulk/lists"
-      path += "?#{Params.encode(params)}" unless params.empty?
-
-      request(path, response_class: ListResponse)
-    end
-  end
-end

data/lib/vonage/proactive_connect.rb

@@ -1,33 +0,0 @@
-# typed: true
-# frozen_string_literal: true
-
-module Vonage
-  class ProactiveConnect < Namespace
-    extend T::Sig
-
-    sig { returns(T.nilable(Vonage::ProactiveConnect::Lists)) }
-    def lists
-      @lists ||= Lists.new(@config)
-    end
-
-    sig { returns(T.nilable(Vonage::ProactiveConnect::List)) }
-    def list
-      @list ||= List.new(@config)
-    end
-
-    sig { returns(T.nilable(Vonage::ProactiveConnect::Items)) }
-    def items
-      @items ||= Items.new(@config)
-    end
-
-    sig { returns(T.nilable(Vonage::ProactiveConnect::Item)) }
-    def item
-      @item ||= Item.new(@config)
-    end
-
-    sig { returns(T.nilable(Vonage::ProactiveConnect::Events)) }
-    def events
-      @events ||= Events.new(@config)
-    end
-  end
-end

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

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

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