braintree 2.98.0 → 4.23.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 67e6afaacba1448a5c2aafd4b1e9432aa6875c3f22d5a8812c4e102a156e2d67
-  data.tar.gz: 2c620e47df93ef23542d98b092bf93cf9ef7bfe21b5d4e424976d5b51187836a
+  metadata.gz: 80f9d00b4dec8e85066f61cecaf04c5863399c8c6552d5158d0fe69f8b81a64f
+  data.tar.gz: 4664e8431f59bf1293d6cafbaf3623b6fe2069aa81af17520384b5e85c34a0a5
 SHA512:
-  metadata.gz: ca18891a468ccdfa0e22960490781c60206775cccad4a2e23edad4a7a3883b515e68ec71436c6b1edf4e57c51c3633e6127986025aead83055f1f37b55640459
-  data.tar.gz: 0cdcff4610e50bfd41d939f27d164dc87d95c7949fef5fa07dd3d21a42df851cb642590be7088aa9e53008611208cbfac7d3dbd062e0eca6a5197430e7a61266
+  metadata.gz: 73131e462a1c99744d967f82cecdda88dc2780e04c3bb69f51cd7149fc8e747d7e487e31cc5e5e3fe7f4440d6da3ef42a90ee7e027c7fa0f567ad2b84a6119dd
+  data.tar.gz: a17216eb8f219f33af17d79accae60eccc23e059753ac159aed34063ec7f8abb0566c6268097647bb1a657fabf507d4f9d1d90c39e3c73b0e66f9d4c1a29c8bc

data/LICENSE

@@ -1,4 +1,4 @@
-Copyright (c) 2009-2017 Braintree, a division of PayPal, Inc.
+Copyright (c) 2009-2020 Braintree, a division of PayPal, Inc.
 
 Permission is hereby granted, free of charge, to any person
 obtaining a copy of this software and associated documentation

data/braintree.gemspec

@@ -1,21 +1,24 @@
 $:.push File.expand_path("../lib", __FILE__)
-require 'braintree/version'
+require "braintree/version"
 
 Gem::Specification.new do |s|
   s.name = "braintree"
-  s.summary = "Braintree Gateway Ruby Client Library"
-  s.description = "Ruby library for integrating with the Braintree Gateway"
+  s.summary = "Braintree Ruby Server SDK"
+  s.description = "Resources and tools for developers to integrate Braintree's global payments platform."
   s.version = Braintree::Version::String
   s.license = "MIT"
   s.author = "Braintree"
   s.email = "code@getbraintree.com"
   s.homepage = "https://www.braintreepayments.com/"
   s.files = Dir.glob ["README.rdoc", "LICENSE", "lib/**/*.{rb,crt}", "spec/**/*", "*.gemspec"]
-  s.add_dependency "builder", ">= 2.0.0"
+  s.add_dependency "builder", ">= 3.2.4"
+  s.add_dependency "rexml", ">= 3.1.9" # Use rexml version associated with minimum supported Ruby version
+  s.required_ruby_version = ">=2.6.0"
   s.metadata = {
     "bug_tracker_uri" => "https://github.com/braintree/braintree_ruby/issues",
     "changelog_uri" => "https://github.com/braintree/braintree_ruby/blob/master/CHANGELOG.md",
     "source_code_uri" => "https://github.com/braintree/braintree_ruby",
+    "documentation_uri" => "https://developer.paypal.com/braintree/docs"
   }
 end
 

data/lib/braintree/account_updater_daily_report.rb

@@ -1,5 +1,5 @@
 module Braintree
-  class AccountUpdaterDailyReport # :nodoc:
+  class AccountUpdaterDailyReport
     include BaseModule
 
     attr_reader :report_date
@@ -7,12 +7,12 @@ module Braintree
 
     class << self
       protected :new
-      def _new(*args) # :nodoc:
-        self.new *args
+      def _new(*args)
+        self.new(*args)
       end
     end
 
-    def initialize(attributes) # :nodoc:
+    def initialize(attributes)
       set_instance_variables_from_hash(attributes)
       @report_date = Date.parse(report_date)
     end

data/lib/braintree/ach_mandate.rb

@@ -1,6 +1,6 @@
 module Braintree
   class AchMandate
-    include BaseModule # :nodoc:
+    include BaseModule
 
     attr_reader :accepted_at
     attr_reader :text

data/lib/braintree/add_on_gateway.rb

@@ -1,5 +1,5 @@
 module Braintree
-  class AddOnGateway # :nodoc
+  class AddOnGateway
     def initialize(gateway)
       @gateway = gateway
       @config = gateway.config

data/lib/braintree/address.rb

@@ -1,6 +1,6 @@
 module Braintree
   class Address
-    include BaseModule # :nodoc:
+    include BaseModule
 
     attr_reader :company
     attr_reader :country_code_alpha2
@@ -12,8 +12,10 @@ module Braintree
     attr_reader :extended_address
     attr_reader :first_name
     attr_reader :id
+    attr_reader :international_phone
     attr_reader :last_name
     attr_reader :locality
+    attr_reader :phone_number
     attr_reader :postal_code
     attr_reader :region
     attr_reader :street_address
@@ -43,44 +45,22 @@ module Braintree
       Configuration.gateway.address.update!(*args)
     end
 
-    def initialize(gateway, attributes) # :nodoc:
+    def initialize(gateway, attributes)
       @gateway = gateway
       set_instance_variables_from_hash(attributes)
     end
 
-    def ==(other) # :nodoc:
+    def ==(other)
       return false unless other.is_a?(Address)
       id == other.id && customer_id == other.customer_id
     end
 
-    # Deprecated. Use Braintree::Address.delete
-    def delete
-      warn "[DEPRECATED] delete as an instance method is deprecated. Please use Address.delete"
-      @gateway.address.delete(customer_id, self.id)
-    end
-
-    # Deprecated. Use Braintree::Address.update
-    def update(attributes)
-      warn "[DEPRECATED] update as an instance method is deprecated. Please use Address.update"
-      result = @gateway.address.update(customer_id, id, attributes)
-      if result.success?
-        copy_instance_variables_from_object result.address
-      end
-      result
-    end
-
-    # Deprecated. Use Braintree::Address.update!
-    def update!(attributes)
-      warn "[DEPRECATED] update! as an instance method is deprecated. Please use Address.update!"
-      return_object_or_raise(:address) { update(attributes) }
-    end
-
     class << self
       protected :new
     end
 
-    def self._new(*args) # :nodoc:
-      self.new *args
+    def self._new(*args)
+      self.new(*args)
     end
   end
 end

data/lib/braintree/address_gateway.rb

@@ -1,5 +1,5 @@
 module Braintree
-  class AddressGateway # :nodoc
+  class AddressGateway
     include BaseModule
 
     def initialize(gateway)
@@ -62,7 +62,7 @@ module Braintree
       return_object_or_raise(:address) { update(*args) }
     end
 
-    def _determine_customer_id(customer_or_customer_id) # :nodoc:
+    def _determine_customer_id(customer_or_customer_id)
       customer_id = customer_or_customer_id.is_a?(Customer) ? customer_or_customer_id.id : customer_or_customer_id
       unless customer_id =~ /\A[\w_-]+\z/
         raise ArgumentError, "customer_id contains invalid characters"
@@ -70,17 +70,18 @@ module Braintree
       customer_id
     end
 
-    def self._create_signature # :nodoc:
+    def self._create_signature
       _shared_signature + [:customer_id]
     end
 
-    def self._shared_signature # :nodoc:
+    def self._shared_signature
       [:company, :country_code_alpha2, :country_code_alpha3, :country_code_numeric,
-        :country_name, :extended_address, :first_name,
-        :last_name, :locality, :postal_code, :region, :street_address]
+       :country_name, :extended_address, :first_name,
+       {:international_phone => [:country_code, :national_number]},
+       :last_name, :locality, :phone_number, :postal_code, :region, :street_address]
     end
 
-    def self._update_signature # :nodoc:
+    def self._update_signature
       _create_signature
     end
   end

data/lib/braintree/advanced_search.rb

@@ -1,6 +1,6 @@
 module Braintree
-  class AdvancedSearch # :nodoc:
-    class SearchNode # :nodoc:
+  class AdvancedSearch
+    class SearchNode
       def self.operators(*operator_names)
         operator_names.each do |operator|
           define_method(operator) do |value|
@@ -14,29 +14,29 @@ module Braintree
       end
     end
 
-    class IsNode < SearchNode # :nodoc:
+    class IsNode < SearchNode
       operators :is
     end
 
-    class EqualityNode < IsNode # :nodoc:
+    class EqualityNode < IsNode
       operators :is_not
     end
 
-    class PartialMatchNode < EqualityNode # :nodoc:
+    class PartialMatchNode < EqualityNode
       operators :ends_with, :starts_with
     end
 
-    class TextNode < PartialMatchNode # :nodoc:
+    class TextNode < PartialMatchNode
       operators :contains
     end
 
-    class KeyValueNode < SearchNode # :nodoc:
+    class KeyValueNode < SearchNode
       def is(value)
         @parent.add_criteria(@node_name, value)
       end
     end
 
-    class MultipleValueNode < SearchNode # :nodoc:
+    class MultipleValueNode < SearchNode
       def in(*values)
         values.flatten!
 
@@ -62,7 +62,7 @@ module Braintree
       end
     end
 
-    class EndsWithNode < SearchNode # :nodoc:
+    class EndsWithNode < SearchNode
       operators :ends_with
     end
 
@@ -76,12 +76,11 @@ module Braintree
       end
     end
 
-    class RangeNode < SearchNode # :nodoc:
+    class RangeNode < SearchNode
       operators :is
 
       def between(min, max)
-        self >= min
-        self <= max
+        self >= min && self <= max
       end
 
       def >=(min)

data/lib/braintree/apple_pay.rb

@@ -1,8 +1,8 @@
 module Braintree
   class ApplePay
-    include BaseModule # :nodoc:
+    include BaseModule
 
-    def initialize(gateway, attributes) # :nodoc:
+    def initialize(gateway, attributes)
       set_instance_variables_from_hash(attributes)
     end
 
@@ -10,8 +10,8 @@ module Braintree
       protected :new
     end
 
-    def self._new(*args) # :nodoc:
-      self.new *args
+    def self._new(*args)
+      self.new(*args)
     end
 
     def self.register_domain(domain)

data/lib/braintree/apple_pay_card.rb

@@ -1,6 +1,6 @@
 module Braintree
   class ApplePayCard
-    include BaseModule # :nodoc:
+    include BaseModule
 
     module CardType
       AmEx = "Apple Pay - American Express"
@@ -10,25 +10,39 @@ module Braintree
       All = constants.map { |c| const_get(c) }
     end
 
+    attr_reader :billing_address
     attr_reader :bin
     attr_reader :card_type
+    attr_reader :cardholder_name
+    attr_reader :commercial
+    attr_reader :country_of_issuance
     attr_reader :created_at
     attr_reader :customer_id
+    attr_reader :debit
     attr_reader :default
+    attr_reader :durbin_regulated
     attr_reader :expiration_month
     attr_reader :expiration_year
     attr_reader :expired
+    attr_reader :healthcare
     attr_reader :image_url
+    attr_reader :issuing_bank
     attr_reader :last_4
+    attr_reader :merchant_token_identifier
     attr_reader :payment_instrument_name
+    attr_reader :payroll
+    attr_reader :prepaid
+    attr_reader :product_id
+    attr_reader :source_card_last4
     attr_reader :source_description
     attr_reader :subscriptions
     attr_reader :token
     attr_reader :updated_at
 
-    def initialize(gateway, attributes) # :nodoc:
+    def initialize(gateway, attributes)
       @gateway = gateway
       set_instance_variables_from_hash(attributes)
+      @billing_address = attributes[:billing_address] ? Address._new(@gateway, attributes[:billing_address]) : nil
       @subscriptions = (@subscriptions || []).map { |subscription_hash| Subscription._new(@gateway, subscription_hash) }
     end
 
@@ -44,8 +58,8 @@ module Braintree
       protected :new
     end
 
-    def self._new(*args) # :nodoc:
-      self.new *args
+    def self._new(*args)
+      self.new(*args)
     end
   end
 end

data/lib/braintree/apple_pay_options.rb

@@ -1,10 +1,10 @@
 module Braintree
   class ApplePayOptions
-    include BaseModule # :nodoc:
+    include BaseModule
 
     attr_reader :domains
 
-    def initialize(attributes) # :nodoc:
+    def initialize(attributes)
       set_instance_variables_from_hash(attributes)
     end
 
@@ -12,8 +12,8 @@ module Braintree
       protected :new
     end
 
-    def self._new(*args) # :nodoc:
-      self.new *args
+    def self._new(*args)
+      self.new(*args)
     end
   end
 end

data/lib/braintree/authorization_adjustment.rb

@@ -1,5 +1,5 @@
 module Braintree
-  class AuthorizationAdjustment # :nodoc:
+  class AuthorizationAdjustment
     include BaseModule
 
     attr_reader :amount
@@ -11,12 +11,12 @@ module Braintree
 
     class << self
       protected :new
-      def _new(*args) # :nodoc:
-        self.new *args
+      def _new(*args)
+        self.new(*args)
       end
     end
 
-    def initialize(attributes) # :nodoc:
+    def initialize(attributes)
       set_instance_variables_from_hash(attributes)
     end
   end

data/lib/braintree/base_module.rb

@@ -1,5 +1,5 @@
 module Braintree
-  module BaseModule # :nodoc: all
+  module BaseModule
     module Methods
       def return_object_or_raise(object_to_return)
         result = yield
@@ -18,6 +18,16 @@ module Braintree
 
       def set_instance_variables_from_hash(hash)
         hash.each do |key, value|
+          if key == :global_id
+            instance_variable_set "@graphql_id", value
+          elsif key == :android_pay_cards
+            instance_variable_set "@google_pay_cards", value
+          elsif key == :android_pay_card
+            instance_variable_set "@google_pay_card", value
+          elsif key == :android_pay_details
+            instance_variable_set "@google_pay_details", value
+          end
+
           instance_variable_set "@#{key}", value
         end
       end

data/lib/braintree/bin_data.rb

@@ -1,5 +1,5 @@
 module Braintree
-  class BinData # :nodoc:
+  class BinData
     include BaseModule
 
     attr_reader :commercial
@@ -17,10 +17,17 @@ module Braintree
     end
 
     def inspect
-      formatted_attrs = self.class._attributes.map do |attr|
+      formatted_attributes = self.class._attributes.map do |attr|
         "#{attr}: #{send(attr).inspect}"
       end
-      "#<BinData #{formatted_attrs.join(", ")}>"
+      "#<#{self.class} #{formatted_attributes.join(", ")}>"
+    end
+
+    def self._attributes
+      [
+        :commercial, :country_of_issuance, :debit, :durbin_regulated, :healthcare,
+        :issuing_bank, :payroll, :prepaid, :product_id
+      ]
     end
   end
 end

data/lib/braintree/client_token.rb

@@ -1,4 +1,4 @@
-require 'json'
+require "json"
 
 module Braintree
   module ClientToken

data/lib/braintree/client_token_gateway.rb

@@ -25,16 +25,17 @@ module Braintree
       end
     end
 
-    def self._generate_signature # :nodoc:
+    def self._generate_signature
       [
         :address_id, :customer_id, :proxy_merchant_id, :merchant_account_id,
         :version,
-        {:options => [:make_default, :verify_card, :fail_on_duplicate_payment_method]}
+        {:domains => [:_any_key_]},
+        {:options => [:fail_on_duplicate_payment_method, :fail_on_duplicate_payment_method_for_customer, :make_default, :verify_card]}
       ]
     end
 
     def _validate_options(options)
-      [:make_default, :fail_on_duplicate_payment_method, :verify_card].each do |credit_card_option|
+      [:fail_on_duplicate_payment_method, :fail_on_duplicate_payment_method_for_customer, :make_default, :verify_card].each do |credit_card_option|
         if options[credit_card_option]
           raise ArgumentError.new("cannot specify #{credit_card_option} without a customer_id") unless options[:customer_id]
         end

data/lib/braintree/configuration.rb

@@ -1,8 +1,9 @@
 module Braintree
   class Configuration
-    API_VERSION = "5" # :nodoc:
-    DEFAULT_ENDPOINT = "api" # :nodoc:
-    GRAPHQL_API_VERSION = "2018-09-10" # :nodoc:
+    API_VERSION = "6"
+    DEFAULT_ENDPOINT = "api"
+    # NEXT_MAJOR_VERSION update to the latest version of GraphQL API
+    GRAPHQL_API_VERSION = "2018-09-10"
 
     READABLE_ATTRIBUTES = [
       :merchant_id,
@@ -40,25 +41,24 @@ module Braintree
     ]
 
     class << self
-      attr_writer *WRITABLE_ATTRIBUTES
-      attr_reader *NON_REQUIRED_READABLE_ATTRIBUTES
+      attr_writer(*WRITABLE_ATTRIBUTES)
+      attr_reader(*NON_REQUIRED_READABLE_ATTRIBUTES)
     end
-    attr_reader *READABLE_ATTRIBUTES
-    attr_reader *NON_REQUIRED_READABLE_ATTRIBUTES
-    attr_writer *WRITABLE_ATTRIBUTES
+    attr_reader(*READABLE_ATTRIBUTES)
+    attr_reader(*NON_REQUIRED_READABLE_ATTRIBUTES)
+    attr_writer(*WRITABLE_ATTRIBUTES)
 
-    def self.expectant_reader(*attributes) # :nodoc:
+    def self.expectant_reader(*attributes)
       attributes.each do |attribute|
         (class << self; self; end).send(:define_method, attribute) do
           attribute_value = instance_variable_get("@#{attribute}")
-          raise ConfigurationError.new("Braintree::Configuration.#{attribute.to_s} needs to be set") if attribute_value.nil? || attribute_value.to_s.empty?
+          raise ConfigurationError.new("Braintree::Configuration.#{attribute} needs to be set") if attribute_value.nil? || attribute_value.to_s.empty?
           attribute_value
         end
       end
     end
-    expectant_reader *READABLE_ATTRIBUTES
+    expectant_reader(*READABLE_ATTRIBUTES)
 
-    # Sets the Braintree environment to use. Valid values are <tt>:sandbox</tt> and <tt>:production</tt>
     def self.environment=(env)
       env = env.to_sym
       unless [:development, :qa, :sandbox, :production].include?(env)
@@ -67,12 +67,12 @@ module Braintree
       @environment = env
     end
 
-    def self.gateway # :nodoc:
+    def self.gateway
       Braintree::Gateway.new(instantiate)
     end
 
-    def self.instantiate # :nodoc:
-      config = new(
+    def self.instantiate
+      new(
         :custom_user_agent => @custom_user_agent,
         :endpoint => @endpoint,
         :environment => environment,
@@ -86,7 +86,7 @@ module Braintree
         :proxy_port => proxy_port,
         :proxy_user => proxy_user,
         :proxy_pass => proxy_pass,
-        :ssl_version => ssl_version
+        :ssl_version => ssl_version,
       )
     end
 
@@ -158,15 +158,15 @@ module Braintree
       end
     end
 
-    def api_version # :nodoc:
+    def api_version
       API_VERSION
     end
 
-    def graphql_api_version # :nodoc:
+    def graphql_api_version
       GRAPHQL_API_VERSION
     end
 
-    def base_merchant_path # :nodoc:
+    def base_merchant_path
       "/merchants/#{merchant_id}"
     end
 
@@ -178,11 +178,11 @@ module Braintree
       "#{protocol}://#{graphql_server}:#{graphql_port}/graphql"
     end
 
-    def base_merchant_url # :nodoc:
+    def base_merchant_url
       "#{base_url}#{base_merchant_path}"
     end
 
-    def ca_file # :nodoc:
+    def ca_file
       File.expand_path(File.join(File.dirname(__FILE__), "..", "ssl", "api_braintreegateway_com.ca.crt"))
     end
 
@@ -190,7 +190,7 @@ module Braintree
       @endpoint || DEFAULT_ENDPOINT
     end
 
-    def http # :nodoc:
+    def http
       Http.new(self)
     end
 
@@ -202,25 +202,25 @@ module Braintree
       @logger ||= self.class._default_logger
     end
 
-    def port # :nodoc:
+    def port
       case @environment
       when :development, :integration
-        ENV['GATEWAY_PORT'] || 3000
+        ENV["GATEWAY_PORT"] || 3000
       when :production, :qa, :sandbox
         443
       end
     end
 
-    def graphql_port # :nodoc:
+    def graphql_port
       case @environment
       when :development, :integration
-        ENV['GRAPHQL_PORT'] || 8080
+        ENV["GRAPHQL_PORT"] || 8080
       when :production, :qa, :sandbox
         443
       end
     end
 
-    def protocol # :nodoc:
+    def protocol
       ssl? ? "https" : "http"
     end
 
@@ -232,23 +232,23 @@ module Braintree
       @http_read_timeout
     end
 
-    def server # :nodoc:
+    def server
       case @environment
       when :development, :integration
-        ENV['GATEWAY_HOST'] || "localhost"
+        ENV["GATEWAY_HOST"] || "localhost"
       when :production
         "#{endpoint}.braintreegateway.com"
       when :qa
-        "gateway.qa.braintreepayments.com"
+        "gateway.qa2.braintreepayments.com"
       when :sandbox
         "api.sandbox.braintreegateway.com"
       end
     end
 
-    def graphql_server # :nodoc:
+    def graphql_server
       case @environment
       when :development, :integration
-        ENV['GRAPHQL_HOST'] || "graphql.bt.local"
+        ENV["GRAPHQL_HOST"] || "graphql.bt.local"
       when :production
         "payments.braintree-api.com"
       when :qa
@@ -271,7 +271,7 @@ module Braintree
       end
     end
 
-    def ssl? # :nodoc:
+    def ssl?
       case @environment
       when :development, :integration
         false
@@ -280,12 +280,12 @@ module Braintree
       end
     end
 
-    def user_agent # :nodoc:
+    def user_agent
       base_user_agent = "Braintree Ruby Gem #{Braintree::Version::String}"
       @custom_user_agent ? "#{base_user_agent} (#{@custom_user_agent})" : base_user_agent
     end
 
-    def self._default_logger # :nodoc:
+    def self._default_logger
       logger = Logger.new(STDOUT)
       logger.level = Logger::INFO
       logger