tangocard-raas 1.1.2 → 2.2.1

data/lib/raas.rb

@@ -1,4 +1,5 @@
-# This file was automatically generated for Tango Card, Inc. by APIMATIC v2.0 ( https://apimatic.io ).
+# This file was automatically generated for Tango Card, Inc. by APIMATIC v2.0
+# ( https://apimatic.io ).
 require 'date'
 require 'json'
 require 'faraday'
@@ -20,42 +21,54 @@ require_relative 'raas/http/auth/basic_auth.rb'
 
 # Models
 require_relative 'raas/models/base_model.rb'
-require_relative 'raas/models/account_summary_model.rb'
-require_relative 'raas/models/customer_model.rb'
-require_relative 'raas/models/account_model.rb'
-require_relative 'raas/models/create_customer_request_model.rb'
 require_relative 'raas/models/create_account_request_model.rb'
-require_relative 'raas/models/raas_server_error_model.rb'
+require_relative 'raas/models/name_email_model.rb'
 require_relative 'raas/models/system_status_response_model.rb'
-require_relative 'raas/models/catalog_model.rb'
-require_relative 'raas/models/brand_model.rb'
+require_relative 'raas/models/raas_server_error_model.rb'
+require_relative 'raas/models/new_credit_card_model.rb'
+require_relative 'raas/models/create_customer_request_model.rb'
+require_relative 'raas/models/unregister_credit_card_response_model.rb'
+require_relative 'raas/models/unregister_credit_card_request_model.rb'
+require_relative 'raas/models/create_order_request_model.rb'
+require_relative 'raas/models/deposit_request_model.rb'
+require_relative 'raas/models/get_orders_response_model.rb'
 require_relative 'raas/models/item_model.rb'
+require_relative 'raas/models/catalog_model.rb'
+require_relative 'raas/models/reward_credential_model.rb'
 require_relative 'raas/models/order_model.rb'
+require_relative 'raas/models/exchange_rate_model.rb'
+require_relative 'raas/models/full_name_email_model.rb'
+require_relative 'raas/models/raas_client_error_model.rb'
+require_relative 'raas/models/brand_model.rb'
+require_relative 'raas/models/billing_address_model.rb'
+require_relative 'raas/models/account_model.rb'
+require_relative 'raas/models/create_credit_card_request_model.rb'
+require_relative 'raas/models/get_deposit_response_model.rb'
+require_relative 'raas/models/reward_model.rb'
 require_relative 'raas/models/currency_breakdown_model.rb'
-require_relative 'raas/models/name_email_model.rb'
-require_relative 'raas/models/exchange_rate_response_model.rb'
-require_relative 'raas/models/get_orders_response_model.rb'
+require_relative 'raas/models/account_summary_model.rb'
 require_relative 'raas/models/resend_order_response_model.rb'
-require_relative 'raas/models/create_order_request_model.rb'
-require_relative 'raas/models/reward_model.rb'
-require_relative 'raas/models/reward_credential_model.rb'
-require_relative 'raas/models/exchange_rate_model.rb'
+require_relative 'raas/models/deposit_response_model.rb'
+require_relative 'raas/models/exchange_rate_response_model.rb'
+require_relative 'raas/models/customer_model.rb'
+require_relative 'raas/models/order_summary_model.rb'
 require_relative 'raas/models/page_model.rb'
-require_relative 'raas/models/raas_client_error_model.rb'
+require_relative 'raas/models/credit_card_model.rb'
 
 # Exceptions
 require_relative 'raas/exceptions/api_exception.rb'
+require_relative 'raas/exceptions/raas_server_exception.rb'
 require_relative 'raas/exceptions/raas_generic_exception.rb'
 require_relative 'raas/exceptions/raas_client_exception.rb'
-require_relative 'raas/exceptions/raas_server_exception.rb'
 
 require_relative 'raas/configuration.rb'
 
 # Controllers
 require_relative 'raas/controllers/base_controller.rb'
+require_relative 'raas/controllers/status_controller.rb'
 require_relative 'raas/controllers/accounts_controller.rb'
 require_relative 'raas/controllers/orders_controller.rb'
-require_relative 'raas/controllers/catalog_controller.rb'
+require_relative 'raas/controllers/fund_controller.rb'
 require_relative 'raas/controllers/exchange_rates_controller.rb'
-require_relative 'raas/controllers/status_controller.rb'
 require_relative 'raas/controllers/customers_controller.rb'
+require_relative 'raas/controllers/catalog_controller.rb'

data/lib/raas/api_helper.rb

@@ -1,18 +1,22 @@
-# This file was automatically generated for Tango Card, Inc. by APIMATIC v2.0 ( https://apimatic.io ).
+# This file was automatically generated for Tango Card, Inc. by APIMATIC v2.0
+# ( https://apimatic.io ).
 
 module Raas
+  # API utility class
   class APIHelper
-    # Serializes an array parameter (creates key value pairs)
-    # @param [String] The name of the parameter
-    # @param [Array] The value of the parameter
-    # @param [String] The format of the serialization
+    # Serializes an array parameter (creates key value pairs).
+    # @param [String] The name of the parameter.
+    # @param [Array] The value of the parameter.
+    # @param [String] The format of the serialization.
     def self.serialize_array(key, array, formatting: 'indexed')
       tuples = []
 
       if formatting == 'unindexed'
         tuples += array.map { |element| ["#{key}[]", element] }
       elsif formatting == 'indexed'
-        tuples += array.map.with_index { |element, index| ["#{key}[#{index}]", element] }
+        tuples += array.map.with_index do |element, index|
+          ["#{key}[#{index}]", element]
+        end
       elsif formatting == 'plain'
         tuples += array.map { |element| [key, element] }
       else
@@ -21,17 +25,21 @@ module Raas
       tuples
     end
 
-    # Replaces template parameters in the given url
-    # @param [String] The query string builder to replace the template parameters
-    # @param [Hash] The parameters to replace in the url
+    # Replaces template parameters in the given url.
+    # @param [String] The query string builder to replace the template
+    # parameters.
+    # @param [Hash] The parameters to replace in the url.
     def self.append_url_with_template_parameters(query_builder, parameters)
       # perform parameter validation
-      raise ArgumentError, 'Given value for parameter \"query_builder\" is invalid.' unless query_builder.instance_of? String
+      unless query_builder.instance_of? String
+        raise ArgumentError, 'Given value for parameter \"query_builder\" is
+          invalid.'
+      end
 
-      # return if there are no parameters to replace
+      # Return if there are no parameters to replace.
       return query_builder if parameters.nil?
 
-      # iterate and append parameters
+      # Iterate and append parameters.
       parameters.each do |key, value|
         replace_value = ''
 
@@ -44,38 +52,50 @@ module Raas
           replace_value = CGI.escape(value.to_s)
         end
 
-        # find the template parameter and replace it with its value
+        # Find the template parameter and replace it with its value.
         query_builder = query_builder.gsub('{' + key.to_s + '}', replace_value)
       end
       query_builder
     end
 
-    # Appends the given set of parameters to the given query string
-    # @param [String] The query string builder to add the query parameters to
-    # @param [Hash] The parameters to append
-    # @param [String] The format of array parameter serialization
-    def self.append_url_with_query_parameters(query_builder, parameters, array_serialization: 'indexed')
-      # perform parameter validation
-      raise ArgumentError, 'Given value for parameter \"query_builder\" is invalid.' unless query_builder.instance_of? String
+    # Appends the given set of parameters to the given query string.
+    # @param [String] The query string builder to add the query parameters to.
+    # @param [Hash] The parameters to append.
+    # @param [String] The format of array parameter serialization.
+    def self.append_url_with_query_parameters(query_builder, parameters,
+                                              array_serialization: 'indexed')
+      # Perform parameter validation.
+      unless query_builder.instance_of? String
+        raise ArgumentError, 'Given value for parameter \"query_builder\"
+          is invalid.'
+      end
 
-      # return if there are no parameters to replace
+      # Return if there are no parameters to replace.
       return query_builder if parameters.nil?
 
       parameters.each do |key, value|
-        seperator = (query_builder.include? '?') ? '&' : '?'
-        if not value.nil?
+        seperator = query_builder.include?('?') ? '&' : '?'
+        unless value.nil?
           if value.instance_of? Array
             value.compact!
-            if array_serialization == 'csv'
-              query_builder += "#{seperator}#{key}=#{value.map { |element| CGI.escape(element.to_s) }.join(',')}"
-            elsif array_serialization == 'psv'
-              query_builder += "#{seperator}#{key}=#{value.map { |element| CGI.escape(element.to_s) }.join('|')}"
-            elsif array_serialization == 'tsv'
-              query_builder += "#{seperator}#{key}=#{value.map { |element| CGI.escape(element.to_s) }.join('\t')}"
-            else
-              query_builder += "#{seperator}#{APIHelper.serialize_array(key, value, formatting: array_serialization).
-                map { |k, v| "#{k}=#{CGI.escape(v.to_s)}" }.join('&')}"
-            end
+            query_builder += if array_serialization == 'csv'
+                               "#{seperator}#{key}=#{value.map do |element|
+                                 CGI.escape(element.to_s)
+                               end.join(',')}"
+                             elsif array_serialization == 'psv'
+                               "#{seperator}#{key}=#{value.map do |element|
+                                 CGI.escape(element.to_s)
+                               end.join('|')}"
+                             elsif array_serialization == 'tsv'
+                               "#{seperator}#{key}=#{value.map do |element|
+                                 CGI.escape(element.to_s)
+                               end.join("\t")}"
+                             else
+                               "#{seperator}#{APIHelper.serialize_array(
+                                 key, value, formatting: array_serialization
+                               ).map { |k, v| "#{k}=#{CGI.escape(v.to_s)}" }
+                               .join('&')}"
+                             end
           else
             query_builder += "#{seperator}#{key}=#{CGI.escape(value.to_s)}"
           end
@@ -84,31 +104,31 @@ module Raas
       query_builder
     end
 
-    # Validates and processes the given Url
-    # @param [String] The given Url to process
-    # @return [String] Pre-processed Url as string
+    # Validates and processes the given Url.
+    # @param [String] The given Url to process.
+    # @return [String] Pre-processed Url as string.
     def self.clean_url(url)
-      # perform parameter validation
+      # Perform parameter validation.
       raise ArgumentError, 'Invalid Url.' unless url.instance_of? String
 
-      # ensure that the urls are absolute
+      # Ensure that the urls are absolute.
       matches = url.match(%r{^(https?:\/\/[^\/]+)})
       raise ArgumentError, 'Invalid Url format.' if matches.nil?
 
-      # get the http protocol match
+      # Get the http protocol match.
       protocol = matches[1]
 
-      # check if parameters exist
+      # Check if parameters exist.
       index = url.index('?')
 
-      # remove redundant forward slashes
+      # Remove redundant forward slashes.
       query = url[protocol.length...(!index.nil? ? index : url.length)]
       query.gsub!(%r{\/\/+}, '/')
 
-      # get the parameters
+      # Get the parameters.
       parameters = !index.nil? ? url[url.index('?')...url.length] : ''
 
-      # return processed url
+      # Return processed url.
       protocol + query + parameters
     end
 
@@ -116,7 +136,7 @@ module Raas
     # @param [String] A JSON string.
     def self.json_deserialize(json)
       return JSON.parse(json)
-    rescue
+    rescue StandardError
       raise TypeError, 'Server responded with invalid JSON.'
     end
 
@@ -132,18 +152,52 @@ module Raas
     def self.form_encode_parameters(form_parameters)
       encoded = {}
       form_parameters.each do |key, value|
-        encoded.merge!(APIHelper.form_encode(value, key))
+        encoded.merge!(APIHelper.form_encode(value, key, formatting:
+          Configuration.array_serialization))
       end
       encoded
     end
 
+    def self.custom_merge(a, b)
+      x = {}
+      a.each do |key, value_a|
+        b.each do |k, value_b|
+          next unless key == k
+          x[k] = []
+          if value_a.instance_of? Array
+            value_a.each do |v|
+              x[k].push(v)
+            end
+          else
+            x[k].push(value_a)
+          end
+          if value_b.instance_of? Array
+            value_b.each do |v|
+              x[k].push(v)
+            end
+          else
+            x[k].push(value_b)
+          end
+          a.delete(k)
+          b.delete(k)
+        end
+      end
+      x.merge!(a)
+      x.merge!(b)
+      x
+    end
+
     # Form encodes an object.
     # @param [Dynamic] An object to form encode.
     # @param [String] The name of the object.
-    # @return [Hash] A form encoded representation of the object in the form of a hash.
-    def self.form_encode(obj, instance_name)
+    # @return [Hash] A form encoded representation of the object in the form
+    # of a hash.
+    def self.form_encode(obj, instance_name, formatting: 'indexed')
       retval = {}
 
+      serializable_types = [String, Numeric, TrueClass,
+                            FalseClass, Date, DateTime]
+
       # If this is a structure, resolve it's field names.
       obj = obj.to_hash if obj.is_a? BaseModel
 
@@ -151,31 +205,69 @@ module Raas
       if obj.nil?
         nil
       elsif obj.instance_of? Array
-        obj.each_with_index do |value, index|
-          retval.merge!(APIHelper.form_encode(value, instance_name + '[' + index.to_s + ']'))
+        if formatting == 'indexed'
+          obj.each_with_index do |value, index|
+            retval.merge!(APIHelper.form_encode(value, instance_name + '[' +
+              index.to_s + ']'))
+          end
+        elsif serializable_types.map { |x| obj[0].is_a? x }.any?
+          obj.each do |value|
+            abc = if formatting == 'unindexed'
+                    APIHelper.form_encode(value, instance_name + '[]',
+                                          formatting: formatting)
+                  else
+                    APIHelper.form_encode(value, instance_name,
+                                          formatting: formatting)
+                  end
+            retval = APIHelper.custom_merge(retval, abc)
+            # print retval
+          end
+        else
+          obj.each_with_index do |value, index|
+            retval.merge!(APIHelper.form_encode(value, instance_name + '[' +
+              index.to_s + ']', formatting: formatting))
+          end
         end
       elsif obj.instance_of? Hash
         obj.each do |key, value|
-          retval.merge!(APIHelper.form_encode(value, instance_name + '[' + key + ']'))
+          retval.merge!(APIHelper.form_encode(value, instance_name + '[' +
+            key + ']', formatting: formatting))
         end
       else
         retval[instance_name] = obj
       end
       retval
     end
+
+    # Safely converts a string into an rfc3339 DateTime object
+    # @param [String] The datetime string
+    # @return [DateTime] A DateTime object of rfc3339 format
+    def self.rfc3339(date_time)
+      # missing timezone information
+      if date_time.end_with?('Z') || date_time.index('+')
+        DateTime.rfc3339(date_time)
+      else
+        DateTime.rfc3339(date_time + 'Z')
+      end
+    end
   end
 end
 
-# extend types to support to_bool
+# Extend types to support to_bool.
 module ToBoolean
   def to_bool
-    return true if self == true || self.to_s.strip =~ /^(true|yes|y|1)$/i
-    return false
+    return true if self == true || to_s.strip =~ /^(true|yes|y|1)$/i
+    false
   end
 end
 
+# Extend NilClass type to support to_bool.
 class NilClass; include ToBoolean; end
+# Extend TrueClass type to support to_bool.
 class TrueClass; include ToBoolean; end
+# Extend FalseClass type to support to_bool.
 class FalseClass; include ToBoolean; end
+# Extend Numeric type to support to_bool.
 class Numeric; include ToBoolean; end
-class String; include ToBoolean; end
+# Extend String type to support to_bool.
+class String; include ToBoolean; end

data/lib/raas/configuration.rb

@@ -1,66 +1,58 @@
-# This file was automatically generated for Tango Card, Inc. by APIMATIC v2.0 ( https://apimatic.io ).
+# This file was automatically generated for Tango Card, Inc. by APIMATIC v2.0
+# ( https://apimatic.io ).
 
 module Raas
 
   Logging.logger.root.appenders = Logging.appenders.stdout
   Logging.logger.root.level = :info
 
+  # All configuration including auth info and base URI for the API access
+  # are configured in this class.
   class Configuration
-    # Set the array parameter serialization method
+    # Set the array parameter serialization method.
     # (allowed: indexed, unindexed, plain, csv, tsv, psv)
     @array_serialization = 'indexed'
 
-    # An enum for SDK environments
+    # An enum for SDK environments.
     class Environment
-      #SANDBOX: Sandbox (Fake) Environment
-      #PRODUCTION: Production (Live) Environment
-      #QA: Tango Card Internal Use Only
-      #GAMMA: Tango Card Internal Use Only
-      #LOCAL: Tango Card Internal Use Only
-      ENVIRONMENT = [SANDBOX = 0, PRODUCTION = 1, QA = 2, GAMMA = 3, LOCAL = 4]
+      #SANDBOX: The sandbox environment does not use real money and can be used for testing.
+      #PRODUCTION: The production environment uses real money and is for live transactions.
+      ENVIRONMENT = [SANDBOX = 0, PRODUCTION = 1].freeze
     end
 
-    # An enum for API servers
+    # An enum for API servers.
     class Server
-      SERVER = [DEFAULT = 0]
+      SERVER = [DEFAULT = 0].freeze
     end
 
-    # The environment in which the SDK is running
+    # The environment in which the SDK is running.
     @environment = Environment::SANDBOX
 
-    # RaaS v2 API Platform Name
+    # Platform Name (Provided by Tango Card)
     @platform_name = 'QAPlatform2'
 
-    # RaaS v2 API Platform Key
+    # Platform Key (Provided by Tango Card)
     @platform_key = 'apYPfT6HNONpDRUj3CLGWYt7gvIHONpDRUYPfT6Hj'
 
-    # All the environments the SDK can run in
+    # All the environments the SDK can run in.
     @environments = {
       Environment::SANDBOX => {
-        Server::DEFAULT => 'https://integration-api.tangocard.com/raas/v2',
+        Server::DEFAULT => 'https://integration-api.tangocard.com/raas/v2'
       },
       Environment::PRODUCTION => {
-        Server::DEFAULT => 'https://api.tangocard.com/raas/v2',
-      },
-      Environment::QA => {
-        Server::DEFAULT => 'https://qa-api.tangocard.com/raas/v2',
-      },
-      Environment::GAMMA => {
-        Server::DEFAULT => 'https://gamma-api.tangocard.com/raas/v2',
-      },
-      Environment::LOCAL => {
-        Server::DEFAULT => 'http://raastango.cc:8080/v2',
-      },
+        Server::DEFAULT => 'https://api.tangocard.com/raas/v2'
+      }
     }
 
     # Generates the appropriate base URI for the environment and the server.
-    # @param [Configuration::Server] The server enum for which the base URI is required.
+    # @param [Configuration::Server] The server enum for which the base URI is
+    # required.
     # @return [String] The base URI.
     def self.get_base_uri(server = Server::DEFAULT)
-      environments[environment][server]
+      environments[environment][server].clone
     end
 
-    # The attribute accessors for public properties
+    # The attribute accessors for public properties.
     class << self
       attr_accessor :array_serialization
       attr_accessor :environment