module Recurly
  class Transaction < Resource
    require 'recurly/transaction/errors'

    # @macro [attach] scope
    #   @scope class
    #   @return [Pager] a pager that yields +$1+ transactions.
    scope :authorizations, type: 'authorization'
    scope :purchases,      type: 'purchase'
    scope :refunds,        type: 'refund'
    scope :successful,     state: 'successful'
    scope :failed,         state: 'failed'
    scope :voided,         state: 'voided'

    # @return [Account]
    belongs_to :account
    # @return [Invoice, nil]
    belongs_to :invoice
    # @return [Subscription, nil]
    belongs_to :subscription

    # @return [Transaction, nil]
    has_one :original_transaction, class_name: :Transaction, readonly: true

    define_attribute_methods %w(
      id
      uuid
      action
      amount_in_cents
      tax_in_cents
      currency
      payment_method
      status
      reference
      recurring
      test
      voidable
      refundable
      cvv_result
      avs_result
      avs_result_street
      created_at
      updated_at
      details
      transaction_error
      source
      ip_address
      collected_at
      description
      tax_exempt
      tax_code
      accounting_code
      fraud
      product_code
      gateway_type
      origin
      message
      approval_code
    )
    alias to_param uuid
    alias fraud_info fraud

    def self.to_xml(attrs)
      transaction = new attrs
      transaction.to_xml
    end

    # @return ["credit", "charge", nil] The type of transaction.
    attr_reader :type

    # @see Resource#initialize
    def initialize(attributes = {})
      super({ :currency => Recurly.default_currency }.merge attributes)
    end

    # Saves new records only.
    #
    # @return [true, false]
    # @raise [Recurly::Error] For persisted transactions.
    # @see Resource#save
    def save
      return super if new_record?
      raise Recurly::Error, "#{self.class.collection_name} cannot be updated"
    end

    # Refunds the transaction.
    #
    # @return [Transaction, false] The updated original transaction if voided,
    #   a new refund transaction, false if the transaction isn't voidable or
    #   refundable.
    # @raise [Error] If the refund fails.
    # @param amount_in_cents [Integer, nil] The amount (in cents) to refund
    #   (refunds fully if nil).
    def refund amount_in_cents = nil
      return false unless link? :refund
      refund = self.class.from_response(
        follow_link :refund, :params => { :amount_in_cents => amount_in_cents }
      )
      refund.uuid == uuid ? copy_from(refund) && self : refund
    end

    def signable_attributes
      super.merge :amount_in_cents => amount_in_cents, :currency => currency
    end

    # @return [String]
    def inspect
      attributes = self.class.attribute_names
      unless type == 'credit_card'
        attributes -= %w(cvv_result avs_result avs_result_street)
      end
      super attributes
    end
  end
end