recurly 2.20.5 → 3.0.0.beta.1

data/lib/recurly/money.rb

@@ -1,120 +0,0 @@
-module Recurly
-  # Represents a collection of currencies (in cents).
-  class Money
-    # @return A money object representing multiple currencies (in cents).
-    # @param currencies [Hash] A hash of currency codes and amounts.
-    # @example
-    #   # 12 United States dollars.
-    #   Recurly::Money.new :USD => 12_00
-    #
-    #   # $9.99 (or €6.99).
-    #   Recurly::Money.new :USD => 9_99, :EUR => 6_99
-    #
-    #   # Using a default currency.
-    #   Recurly.default_currency = 'USD'
-    #   Recurly::Money.new(49_00) # => #<Recurly::Money USD: 49_00>
-    def initialize currencies = {}, parent = nil, attribute = nil
-      @currencies = {}
-      @parent = parent
-      @attribute = attribute
-
-      if currencies.respond_to? :each_pair
-        currencies.each_pair { |key, value| @currencies[key.to_s] = value }
-      elsif Recurly.default_currency
-        self[Recurly.default_currency] = currencies
-      else
-        message = 'expected a Hash'
-        message << ' or Numeric' if Recurly.default_currency
-        message << " but received #{currencies.class}"
-        raise ArgumentError, message
-      end
-    end
-
-    def [] code
-      currencies[code.to_s]
-    end
-
-    def []= code, amount
-      currencies[code.to_s] = amount
-      @parent.send "#@attribute=", dup if @parent
-      amount
-    end
-
-    # @return [Hash] A hash of currency codes to amounts.
-    def to_hash
-      currencies.dup
-    end
-
-    # @return [true, false] Whether or not the currency is equal to another
-    # instance.
-    # @param other [Money]
-    def eql? other
-      other.respond_to?(:currencies) && currencies.eql?(other.currencies)
-    end
-
-    # @return [Integer] Unique identifier.
-    # @see Hash#hash
-    def hash
-      currencies.hash
-    end
-
-    # Implemented so that solitary currencies can be compared and sorted.
-    #
-    # @return [-1, 0, 1]
-    # @param other [Money]
-    # @example
-    #   [Recurly::Money.new(2_00), Recurly::Money.new(1_00)].sort
-    #   # => [#<Recurly::Money USD: 1_00>, #<Recurly::Money USD: 2_00>]
-    # @see Hash#<=>
-    def <=> other
-      if currencies.keys.length == 1 && other.currencies.length == 1
-        if currencies.keys == other.currencies.keys
-          return currencies.values.first <=> other.currencies.values.first
-        end
-      end
-
-      currencies <=> other.currencies
-    end
-
-    # @return [true, false]
-    # @see Object#respond_to?
-    def respond_to? method_name, include_private = false
-      super || currencies.respond_to?(method_name, include_private)
-    end
-
-    # @return [String]
-    def inspect
-      string = "#<#{self.class}"
-      if currencies.any?
-        string << " %s" % currencies.keys.sort.map { |code|
-          value = currencies[code].to_s
-          value.gsub!(/^(\d)$/, '0_0\1')
-          value.gsub!(/^(\d{2})$/, '0_\1')
-          value.gsub!(/(\d)(\d{2})$/, '\1_\2')
-          value.gsub!(/(\d)(?=(\d\d\d)+(?!\d))/, '\1_')
-          "#{code}: #{value}"
-        }.join(', ')
-      end
-      string << '>'
-    end
-    alias to_s inspect
-
-    attr_reader :currencies
-
-    private
-
-    def method_missing name, *args, &block
-      if currencies.respond_to? name
-        return currencies.send name, *args, &block
-      elsif c = currencies[Recurly.default_currency] and c.respond_to? name
-        if currencies.keys.length > 1
-          raise TypeError, "can't convert multicurrency into Integer"
-        else
-          return c.send name, *args, &block
-        end
-      end
-
-      super
-    end
-  end
-end

data/lib/recurly/note.rb

@@ -1,14 +0,0 @@
-module Recurly
-  # Recurly Documentation: https://dev.recurly.com/docs/list-account-notes
-  class Note < Resource
-    # @return [Account]
-    belongs_to :account
-
-    define_attribute_methods %w(
-      account
-      message
-      created_at
-    )
-
-  end
-end

data/lib/recurly/percentage_tier.rb

@@ -1,17 +0,0 @@
-module Recurly
-  class PercentageTier < Resource
-
-    belongs_to :currency_percentage_tier
-
-    define_attribute_methods %w(
-      ending_amount_in_cents
-      usage_percentage
-    )
-
-    def xml_keys
-      attributes.keys
-    end
-
-    embedded! true
-  end
-end

data/lib/recurly/performance_obligation.rb

@@ -1,15 +0,0 @@
-module Recurly
-  class PerformanceObligation < Resource
-
-    define_attribute_methods %w(
-      id
-      name
-      created_at
-      updated_at
-    )
-
-    def self.collection_path
-      "performance_obligations"
-    end
-  end
-end

data/lib/recurly/plan.rb

@@ -1,59 +0,0 @@
-module Recurly
-  # Recurly Documentation: https://dev.recurly.com/docs/list-plans
-  class Plan < Resource
-
-    # @return [Pager<AddOn>, []]
-    has_many :add_ons
-
-    # @return <ExternalProduct>
-    has_one :external_product
-
-    # @return [[PlanRampInterval], nil]
-    has_many :ramp_intervals, class_name: :PlanRampInterval
-
-    # @return [[CustomField], []]
-    has_many :custom_fields, class_name: :CustomField, readonly: false
-
-    # Define attribute methods
-    define_attribute_methods %w(
-      plan_code
-      name
-      description
-      success_url
-      cancel_url
-      display_donation_amounts
-      display_quantity
-      display_phone_number
-      bypass_hosted_confirmation
-      unit_name
-      payment_page_tos_link
-      payment_page_css
-      setup_fee_in_cents
-      unit_amount_in_cents
-      plan_interval_length
-      plan_interval_unit
-      pricing_model
-      ramp_intervals
-      trial_interval_length
-      trial_interval_unit
-      total_billing_cycles
-      accounting_code
-      setup_fee_accounting_code
-      revenue_schedule_type
-      setup_fee_revenue_schedule_type
-      tax_exempt
-      tax_code
-      vertex_transaction_type
-      trial_requires_billing_info
-      auto_renew
-      allow_any_item_on_subscriptions
-      avalara_transaction_type
-      avalara_service_type
-      dunning_campaign_id
-      custom_fields
-      created_at
-      updated_at
-    ) + RevRec::PLAN_ATTRIBUTES
-    alias to_param plan_code
-  end
-end

data/lib/recurly/plan_ramp_interval.rb

@@ -1,10 +0,0 @@
-module Recurly
-  class PlanRampInterval < Resource
-    belongs_to :plan
-
-    define_attribute_methods %w(
-      starting_billing_cycle
-      unit_amount_in_cents
-    )
-  end
-end

data/lib/recurly/purchase.rb

@@ -1,240 +0,0 @@
-module Recurly
-  # The Purchase object works in a slightly different way than the rest of the models.
-  # You build up the purchase data into an object then pass to either:
-  # {Purchase.invoice!} or {Purchase.preview!} and it will
-  # return an {InvoiceCollection}.
-  #
-  # You can build your purchase object with a new account or an existing account.
-  # For an existing account, you just need an account_code:
-  #   Recurly::Purchase.new({account: {account_code: 'myexistingaccount'}})
-  # or
-  #   account = Recurly::Account.find('existing_account')
-  #   Recurly::Purchase.new({account: account})
-  # or
-  #   account = Recurly::Account.find('existing_account')
-  #   purchase = Recurly::Purchase.new
-  #   purchase.account = account
-  #
-  # For a new account, you can pass in {Account} data, {BillingInfo} data, etc
-  # in the same way you would when creating a {Subscription} with a new account.
-  #
-  # You can also pass in adjustments and invoicing data to be added to the invoice.
-  #
-  # There are multiple ways to set the shipping addresses:
-  # 1. Use {Purchase#shipping_address_id} if you want to apply an existing shipping
-  #    address to all subscriptions, adjustments, and shipping fees in this purchase.
-  # 2. Use {Purchase#shipping_address} if you want to add and apply a single shipping address.
-  # 3. Use {Subscription#shipping_address_id} or {Subscription#shipping_address}
-  #    to set a shipping address for only the subscription.
-  # 4. Use {Adjustment#shipping_address_id} or {Adjustment#shipping_address}
-  #    to set a shipping address for only the adjustment.
-  # 5. Use {ShippingFee#shipping_address_id} or {ShippingFee#shipping_address}
-  #    to set a shipping address for only the shipping fee. If there are multiple
-  #    shipping fees on a single purchase, each can have its own shipping address.
-  #    This way, if you ship different adjustments to multiple addresses, the
-  #    shipping fees on the purchase can be associated with the same address
-  #    as the adjustment.
-  #
-  # @example
-  #   require 'securerandom'
-  #
-  #   purchase = Recurly::Purchase.new(
-  #     currency: 'USD',
-  #     collection_method: :automatic,
-  #     account: {
-  #       account_code: SecureRandom.uuid,
-  #       billing_info: {
-  #         first_name: 'Benjamin',
-  #         last_name: 'Du Monde',
-  #         address1: '400 Alabama St.',
-  #         city: 'San Francisco',
-  #         state: 'CA',
-  #         zip: '94110',
-  #         country: 'US',
-  #         number: '4111-1111-1111-1111',
-  #         month: 12,
-  #         year: 2019,
-  #       }
-  #     },
-  #     adjustments: [
-  #       {
-  #          product_code: 'product_1',
-  #          unit_amount_in_cents: 1000,
-  #          quantity: 1,
-  #          revenue_schedule_type: :at_invoice
-  #       },
-  #       {
-  #         product_code: 'product_2',
-  #         unit_amount_in_cents: 3000,
-  #         quantity: 5,
-  #         revenue_schedule_type: :at_invoice
-  #       }
-  #     ],
-  #     shipping_address: {
-  #       first_name: 'Benjamin',
-  #       last_name: 'Du Monde',
-  #       address1: '400 Dolores St.',
-  #       city: 'San Francisco',
-  #       state: 'CA',
-  #       zip: '94110',
-  #       country: 'US',
-  #       nickname: 'Home'
-  #     },
-  #     shipping_fees: [
-  #       {
-  #         shipping_method_code: 'fast_fast_fast',
-  #         shipping_amount_in_cents: '999'
-  #       }
-  #     ]
-  #   )
-  #
-  #   begin
-  #     preview_collection = Recurly::Purchase.preview!(purchase)
-  #     puts preview_collection.inspect
-  #   rescue Recurly::Resource::Invalid => e
-  #     # Invalid data
-  #   end
-  #
-  #   begin
-  #     invoice_collection = Recurly::Purchase.invoice!(purchase)
-  #     puts invoice_collection.inspect
-  #   rescue Recurly::Resource::Invalid => e
-  #     # Invalid data
-  #   rescue Recurly::Transaction::DeclinedError => e
-  #     # Display e.message and/or subscription (and associated) errors...
-  #   rescue Recurly::Transaction::RetryableError => e
-  #     # You should be able to attempt to save this again later.
-  #   rescue Recurly::Transaction::Error => e
-  #     # Fallback transaction error
-  #     # e.transaction
-  #     # e.transaction_error_code
-  #   end
-  class Purchase < Resource
-    # @return [[Adjustment], nil]
-    has_many :adjustments, class_name: :Adjustment, readonly: false
-
-    # @return [Account, nil]
-    has_one :account, class_name: :Account, readonly: false
-
-    # @return [GiftCard, nil]
-    has_one :gift_card, class_name: :GiftCard, readonly: false
-
-    # @return [ShippingAddress, nil]
-    has_one :shipping_address, class_name: :ShippingAddress, readonly: false
-
-    # @return [[Subscription], nil]
-    has_many :subscriptions, class_name: :Subscription, readonly: false
-
-    # @return [[ShippingFee], nil]
-    has_many :shipping_fees, class_name: :ShippingFee, readonly: false
-
-    # @return [BillingInfo, nil]
-    has_one :billing_info, class_name: :BillingInfo, readonly: true
-
-    define_attribute_methods %w(
-      currency
-      collection_method
-      po_number
-      net_terms
-      net_terms_type
-      coupon_codes
-      terms_and_conditions
-      customer_notes
-      vat_reverse_charge_notes
-      shipping_address_id
-      gateway_code
-      transaction_type
-      vertex_transaction_type
-      billing_info_uuid
-    )
-
-    class << self
-
-      # Generate an invoice for the purchase and run any needed transactions.
-      #
-      # @param purchase [Purchase] The purchase data for the request.
-      # @return [InvoiceCollection] The saved invoice(s) representing this purchase.
-      # @raise [Invalid] Raised if the purchase cannot be invoiced.
-      # @raise [Transaction::Error] Raised if the transaction failed.
-      def invoice!(purchase)
-        post(purchase, collection_path)
-      end
-
-      # Generate a preview invoice for the purchase. Runs validations
-      # but does not run any transactions.
-      #
-      # @param purchase [Purchase] The purchase data for the request.
-      # @return [InvoiceCollection] The preview invoice(s) representing this purchase.
-      # @raise [Invalid] Raised if the purchase cannot be invoiced.
-      def preview!(purchase)
-        post(purchase, "#{collection_path}/preview")
-      end
-
-      # Generate an authorized invoice for the purchase. Runs validations
-      # but does not run any transactions. This endpoint will create a
-      # pending purchase that can be activated at a later time once payment
-      # has been completed on an external source (e.g. Adyen's Hosted
-      # Payment Pages).
-      #
-      # @param purchase [Purchase] The purchase data for the request.
-      # @return [InvoiceCollection] The authorized invoice collection representing this purchase.
-      # @raise [Invalid] Raised if the purchase cannot be invoiced.
-      def authorize!(purchase)
-        post(purchase, "#{collection_path}/authorize")
-      end
-
-      # Use for Adyen HPP transaction requests. Runs validations
-      # but does not run any transactions.
-      #
-      # @param purchase [Purchase] The purchase data for the request.
-      # @return [InvoiceCollection] The authorized invoice collection representing this purchase.
-      # @raise [Invalid] Raised if the purchase cannot be invoiced.
-      def pending!(purchase)
-        post(purchase, "#{collection_path}/pending")
-      end
-
-      # Allows the merchant to cancel an authorization.
-      #
-      # @param transaction_uuid [String] The uuid for the transaction representing the authorization. Can typically be found at invoice_collection.charge_invoice.transactions.first.uuid.
-      # @return [InvoiceCollection] The canceled invoice collection.
-      # @raise [Invalid] Raised if the authorization cannot be canceled.
-      def cancel!(transaction_uuid)
-        post(nil, "#{collection_path}/transaction-uuid-#{transaction_uuid}/cancel")
-      end
-
-      # Allows the merchants to initiate a capture transaction tied to the original authorization.
-      #
-      # @param transaction_uuid [String] The uuid for the transaction representing the authorization. Can typically be found at invoice_collection.charge_invoice.transactions.first.uuid.
-      # @return [InvoiceCollection] The captured invoice collection.
-      # @raise [Invalid] Raised if the authorization cannot be captured.
-      def capture!(transaction_uuid)
-        post(nil, "#{collection_path}/transaction-uuid-#{transaction_uuid}/capture")
-      end
-
-      def post(purchase, path)
-        body = purchase.nil? ? nil : purchase.to_xml
-        response = API.send(:post, path, body)
-        InvoiceCollection.from_response(response)
-      rescue API::UnprocessableEntity => e
-        purchase.apply_errors(e) if purchase
-        Transaction::Error.validate!(e, nil)
-        raise Resource::Invalid.new(purchase)
-      end
-    end
-
-    # TODO
-    # This is a temporary solution which allows us to
-    # embed these resources in a purchase without changing their
-    # interface. It will be removed once we get rid of default_currency.
-    def to_xml(options = {})
-      subscriptions.each {|s| s.currency = nil}
-      adjustments.each   {|a| a.currency = nil}
-      super(options)
-    end
-
-    # This object does not represent a model on the server side
-    # so we do not need to expose these methods.
-    protected(*%w(save save!))
-    private_class_method(*%w(all find_each first paginate scoped where post create! create))
-  end
-end

data/lib/recurly/redemption.rb

@@ -1,46 +0,0 @@
-module Recurly
-  # Redemptions are not top-level resources, but they can be accessed (and
-  # created) through {Coupon} instances.
-  #
-  # @example
-  #   coupon = Coupon.find("summer2011")
-  #   coupon.redemptions.each { |r| p r }
-  #   coupon.redeem Account.find("groupon_lover")
-  class Redemption < Resource
-    # @return [Coupon]
-    belongs_to :coupon
-
-    # @return [Account]
-    belongs_to :account, :readonly => false
-
-    # @return [Subscription]
-    belongs_to :subscription
-
-    # @return [Invoice]
-    belongs_to :invoice
-
-    define_attribute_methods %w(
-      uuid
-      single_use
-      total_discounted_in_cents
-      currency
-      state
-      coupon_code
-      subscription_uuid
-      created_at
-      updated_at
-    )
-
-    def save
-      return false if persisted?
-      copy_from coupon.redeem account, currency
-      true
-    rescue Recurly::API::UnprocessableEntity => e
-      apply_errors e
-      false
-    end
-
-    # Redemptions are only writeable through {Coupon} instances.
-    embedded!
-  end
-end

data/lib/recurly/resource/association.rb

@@ -1,16 +0,0 @@
-module Recurly
-  class Resource
-    class Association
-      attr_reader :relation, :resource_class
-
-      def initialize relation, resource_class, options = {}
-        @relation, @resource_class, @options = relation, resource_class, options
-      end
-
-      def class_name
-        return @class_name if defined? @class_name
-        @class_name = @options[:class_name]
-      end
-    end
-  end
-end

data/lib/recurly/resource/errors.rb

@@ -1,20 +0,0 @@
-module Recurly
-  class Resource
-    class Errors < Hash
-      def [] key
-        super key.to_s
-      end
-
-      def []= key, value
-        super key.to_s, value
-      end
-
-      def full_messages
-        map { |attribute, messages|
-          attribute_name = attribute.capitalize.gsub('_', ' ')
-          messages.map { |message| "#{attribute_name} #{message}." }
-        }.flatten
-      end
-    end
-  end
-end