transactionable 0.1.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: 38e0184eda5b9abc7aeb8930c495815d91de289a
+  data.tar.gz: 603cef288a2633938f229905a004ad0947c207c5
+SHA512:
+  metadata.gz: 862efeab377c63bde79712bc32dcc2191126c3ec962c3203a721b6afd8a6c7dc2b0b2b73a75b744aa2ac470c97d56eb56de0a64f66d5d491264317380aae2e3e
+  data.tar.gz: 67c979751972a0862f4440f1e61c9aa72ed8e8a569aaf77c9c50327bf677b44b02bc17c5c7986abfc4df32054b3e94613e821d2cf89371e43618004d344d2180

data/MIT-LICENSE

@@ -0,0 +1,20 @@
+Copyright 2014 TANOOKI SUIT LABS
+
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of this software and associated documentation files (the
+"Software"), to deal in the Software without restriction, including
+without limitation the rights to use, copy, modify, merge, publish,
+distribute, sublicense, and/or sell copies of the Software, and to
+permit persons to whom the Software is furnished to do so, subject to
+the following conditions:
+
+The above copyright notice and this permission notice shall be
+included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
+LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
+OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
+WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

data/README.rdoc

@@ -0,0 +1,3 @@
+= Transactionable
+
+This project rocks and uses MIT-LICENSE.

data/Rakefile

@@ -0,0 +1,29 @@
+begin
+  require 'bundler/setup'
+rescue LoadError
+  puts 'You must `gem install bundler` and `bundle install` to run rake tasks'
+end
+
+require 'rdoc/task'
+
+RDoc::Task.new(:rdoc) do |rdoc|
+  rdoc.rdoc_dir = 'rdoc'
+  rdoc.title    = 'Transactionable'
+  rdoc.options << '--line-numbers'
+  rdoc.rdoc_files.include('README.rdoc')
+  rdoc.rdoc_files.include('lib/**/*.rb')
+end
+
+APP_RAKEFILE = File.expand_path("../spec/dummy/Rakefile", __FILE__)
+load 'rails/tasks/engine.rake'
+
+Bundler::GemHelper.install_tasks
+
+require 'rspec/core'
+require 'rspec/core/rake_task'
+
+desc "Run all specs in spec directory (excluding plugin specs)"
+RSpec::Core::RakeTask.new(:spec => 'app:db:test:prepare')
+
+task :default => :spec
+

data/app/assets/javascripts/transactionable/add_bank_account.js

@@ -0,0 +1,45 @@
+$(document).ready(function() {
+  var bankAcctNumberField = $(".acct-number");
+  var bankAcctRoutingNumberField = $(".acct-routing-number");
+  var bankAcctTypeField = $(".acct-type");
+  var bankAcctNameField = $(".acct-name");
+  var bankAcctBalancedUriField = $(".acct-balanced-uri");
+  var $bankAcctForm = $(".acct-info-form");
+  var bankAcctSubmitButton = $(".submit-bank-acct-info");
+
+  bankAcctCallbackHandler = function(response) {
+    console.log(response.status);
+    console.log(response);
+
+    switch (response.status) {
+      case 201:
+        bankAcctBalancedUriField.val(response.data.uri);
+        bankAcctNumberField.val(response.data.account_number);
+        bankAcctRoutingNumberField.val(null);
+        bankAcctSubmitButton.unbind('click');
+        bankAcctSubmitButton.click();
+        break;
+      default:
+        alert("There was an error with the bank account information you supplied. Please verify that all fields are correct and try again.");
+        break;
+    }
+  }
+
+  if ($bankAcctForm.length > 0 && bankAcctBalancedUriField.val() == "") {
+    bankAcctSubmitButton.click(function(e) {
+      e.preventDefault();
+
+      var acctData = {
+        name: bankAcctNameField.val(),
+        routing_number: bankAcctRoutingNumberField.val(),
+        account_number: bankAcctNumberField.val(),
+        type: bankAcctTypeField.val()
+      }
+
+      console.log(acctData);
+
+      balanced.bankAccount.create(acctData, bankAcctCallbackHandler);
+    });
+  }
+
+});

data/app/assets/javascripts/transactionable/add_credit_card.js

@@ -0,0 +1,87 @@
+$(document).ready(function() {
+  var ccNumberField = $(".cc-number");
+  var ccSecurityCodeField = $(".cc-csc");
+  var ccExpirationDateField = $(".cc-exp-date");
+  var ccExpirationYearField = $(".cc-exp-year");
+  var ccExpirationMonthField = $(".cc-exp-month");
+  var ccNameField = $(".cc-name");
+  var ccPostalCodeField = $(".cc-postal-code");
+  var balancedUriField = $(".cc-balanced-uri");
+  var submitButton = $(".submit-cc-info");
+  var ccAddressFields = $(".cc-address");
+  var $form = $(".cc-info-form");
+
+  Array.prototype.clean = function(deleteValue) {
+    for (var i = 0; i < this.length; i++) {
+      if (this[i] == deleteValue) {         
+        this.splice(i, 1);
+        i--;
+      }
+    }
+    return this;
+  };
+
+  callbackHandler = function(response) {
+    console.log(response.status);
+    console.log(response);
+    window.resp = response;
+
+    switch (response.status) {
+      case 201:
+        balancedUriField.val(response.data.uri);
+        ccNumberField.val(response.data.brand + ' (' + response.data.last_four + ')');
+        ccSecurityCodeField.val(null);
+        submitButton.unbind('click');
+        submitButton.click();
+        break;
+      default:
+        alert("There was an error with the credit card information you supplied. Please verify that all fields are correct and try again.");
+        break;
+    }
+  }
+
+  function composeCCData() {
+    var ccName = ccNameField.val();
+    var ccNumber = ccNumberField.val();
+    var ccCSC = ccSecurityCodeField.val();
+    var ccZip = ccPostalCodeField.val();
+    var ccAddress;
+    var ccExpYear;
+    var ccExpMo;
+
+    var ccAddressVals = ccAddressFields.map(function() { return this.value.trim() });
+    ccAddress = ccAddressVals.toArray().clean("").join(", ");
+
+    if (ccExpirationDateField.length > 0) {
+      ccExpMo = ccExpirationDateField.val().split("/")[0];
+      ccExpYear = ccExpirationDateField.val().split("/")[1];
+    } else {
+      ccExpMo = ccExpirationMonthField.val();
+      ccExpYear = ccExpirationYearField.val();
+    }
+
+    data = {
+        card_number: ccNumber,
+        expiration_month: ccExpMo,
+        expiration_year: ccExpYear,
+        security_code: ccCSC,
+        name: ccName,
+        address: ccAddress,
+        postal_code: ccZip
+      }
+
+    return data;
+  }
+
+  if ($form.length > 0 && balancedUriField.val() == "") {
+    submitButton.click(function(e) {
+      e.preventDefault();
+
+      var ccData = composeCCData();
+      console.log(ccData);
+
+      balanced.card.create(ccData, callbackHandler);
+    });
+  }
+
+});

data/app/assets/javascripts/transactionable/application.js

@@ -0,0 +1,12 @@
+// This is a manifest file that'll be compiled into application.js, which will include all the files
+// listed below.
+//
+// Any JavaScript/Coffee file within this directory, lib/assets/javascripts, vendor/assets/javascripts,
+// or vendor/assets/javascripts of plugins, if any, can be referenced here using a relative path.
+//
+// It's not advisable to add code directly here, but if you do, it'll appear at the bottom of the
+// compiled file.
+//
+// Read Sprockets README (https://github.com/sstephenson/sprockets#sprockets-directives) for details
+// about supported directives.
+//

data/app/assets/stylesheets/transactionable/application.css

@@ -0,0 +1,13 @@
+/*
+ * This is a manifest file that'll be compiled into application.css, which will include all the files
+ * listed below.
+ *
+ * Any CSS and SCSS file within this directory, lib/assets/stylesheets, vendor/assets/stylesheets,
+ * or vendor/assets/stylesheets of plugins, if any, can be referenced here using a relative path.
+ *
+ * You're free to add application-wide styles to this file and they'll appear at the top of the
+ * compiled file, but it's generally better to create a new file per style scope.
+ *
+ *= require_self
+ *= require_tree .
+ */

data/app/controllers/transactionable/application_controller.rb

@@ -0,0 +1,4 @@
+module Transactionable
+  class ApplicationController < ActionController::Base
+  end
+end

data/app/helpers/transactionable/application_helper.rb

@@ -0,0 +1,4 @@
+module Transactionable
+  module ApplicationHelper
+  end
+end

data/app/models/transactionable/bank_account.rb

@@ -0,0 +1,35 @@
+module Transactionable
+  class BankAccount < ActiveRecord::Base
+    belongs_to :bank_accountable, polymorphic: true
+    has_one :remote_bank_account, as: :local_entity, dependent: :destroy
+    has_many :transactions, as: :transactionable
+    has_many :credits, as: :transactionable
+    has_many :reversals, as: :transactionable
+
+    def remote
+      if remote_bank_account && remote_bank_account.synced?
+        remote_bank_account.fetch
+      end
+    end
+
+    def sync
+      balanced_bank_account = remote
+      self.bank_name = balanced_bank_account.bank_name
+      self.description = balanced_bank_account.account_number
+      self.name = balanced_bank_account.name
+      self.can_debit = balanced_bank_account.can_debit
+      self.account_type = balanced_bank_account.type
+      save
+    end
+
+    def credit!(amount)
+      remote_credit = remote.credit(amount: amount_in_cents(amount))
+      transaction = Credit.create_from_remote(remote_credit)
+      credits << transaction
+    end
+
+    def amount_in_cents(amount)
+      (amount * 100).to_i
+    end
+  end
+end

data/app/models/transactionable/credit.rb

@@ -0,0 +1,28 @@
+module Transactionable
+  class Credit < Transaction
+    has_many :reversals
+
+    def reverse!(reversal_amount = nil)
+      ensure_valid_reversal(reversal_amount)
+      remote_reversal = reversal_amount ? remote.reverse(amount: amount_in_cents(reversal_amount)) : remote.reverse
+      transaction = Reversal.create_from_remote(remote_reversal)
+      reversals << transaction
+      transactionable.transactions << transaction
+    end
+
+    def max_reversal_amount
+      amount - reversals.sum(:amount)
+    end
+
+    private
+
+    def ensure_valid_reversal(reversal_amount)
+      reversal_amount = reversal_amount ? reversal_amount : amount
+      raise Exceptions::InvalidReversalAmount if reversal_amount > max_reversal_amount
+    end
+
+    def amount_in_cents(dollar_amount)
+      (dollar_amount * 100).to_i
+    end
+  end
+end

data/app/models/transactionable/credit_card.rb

@@ -0,0 +1,39 @@
+module Transactionable
+  class CreditCard < ActiveRecord::Base
+    belongs_to :credit_cardable, polymorphic: true
+    has_one :remote_credit_card, as: :local_entity, dependent: :destroy
+    has_many :transactions, as: :transactionable
+    has_many :debits, as: :transactionable
+    has_many :refunds, as: :transactionable
+
+    def remote
+      if remote_credit_card && remote_credit_card.synced?
+        remote_credit_card.fetch
+      end
+    end
+
+    def debit!(amount)
+      # TODO: Consider whether to assume that this method takes
+      # decimal/float dollar values
+      remote_debit = remote.debit(amount: amount_in_cents(amount))
+      transaction = Debit.create_from_remote(remote_debit)
+      debits << transaction
+    end
+
+    def amount_in_cents(amount)
+      (amount*100).to_i
+    end
+
+    def sync
+      remote_cc = self.remote
+      self.name = remote_cc.name
+      self.description = "#{remote_cc.brand} (#{remote_cc.last_four})"
+      self.last_four = remote_cc.last_four
+      self.brand = remote_cc.brand
+      self.expiration_month = remote_cc.expiration_month
+      self.expiration_year = remote_cc.expiration_year
+      self.expiration_date = Date.parse("#{expiration_month}/#{expiration_year}")
+      save
+    end
+  end
+end

data/app/models/transactionable/debit.rb

@@ -0,0 +1,28 @@
+module Transactionable
+  class Debit < Transaction
+    has_many :refunds
+
+    def refund!(refund_amount = nil)
+      ensure_valid_refund(refund_amount)
+      remote_refund = refund_amount ? remote.refund(amount: amount_in_cents(refund_amount)) : remote.refund
+      transaction = Refund.create_from_remote(remote_refund)
+      refunds << transaction
+      transactionable.transactions << transaction
+    end
+
+    def max_refund_amount
+      amount - refunds.sum(:amount)
+    end
+
+    private
+
+    def ensure_valid_refund(refund_amount)
+      refund_amount = refund_amount ? refund_amount : amount
+      raise Exceptions::InvalidRefundAmount if refund_amount > max_refund_amount
+    end
+
+    def amount_in_cents(dollar_amount)
+      (dollar_amount * 100).to_i
+    end
+  end
+end

data/app/models/transactionable/refund.rb

@@ -0,0 +1,5 @@
+module Transactionable
+  class Refund < Transaction
+    belongs_to :credit
+  end
+end

data/app/models/transactionable/remote_bank_account.rb

@@ -0,0 +1,4 @@
+module Transactionable
+  class RemoteBankAccount < RemoteEntity
+  end
+end

data/app/models/transactionable/remote_credit_card.rb

@@ -0,0 +1,7 @@
+module Transactionable
+  class RemoteCreditCard < RemoteEntity
+    def remote_entity_type
+      "Card"
+    end
+  end
+end

data/app/models/transactionable/remote_customer.rb

@@ -0,0 +1,39 @@
+module Transactionable
+  class RemoteCustomer < RemoteEntity
+    before_create :build_or_update_remote
+
+    def build_or_update_remote
+      build_remote unless synced?
+      update_remote
+    end
+
+    def build_remote
+      balanced_customer = Balanced::Customer.new.save
+      self.uri = balanced_customer.uri
+      self.synced_at = Time.now
+    end
+
+    def update_remote
+      balanced_customer = fetch
+      if self.local_entity.respond_to?(:sync_attributes)
+        balanced_customer_attributes = local_entity.sync_attributes
+        non_address_keys = [:name, :email, :phone]
+        new_customer_attributes = balanced_customer_attributes.reject { |k,v| v.blank? }
+        address = new_customer_attributes.slice!(*non_address_keys)
+        new_customer_attributes.merge!(address: address)
+        new_customer_attributes.each { |k,v| balanced_customer.send("#{k}=", v) }
+        balanced_customer.save
+      else
+        balanced_customer = fetch
+        balanced_customer.name = "#{self.local_entity_type} #{self.local_entity_id}"
+        balanced_customer.meta = {
+                                    entity: self.local_entity_type,
+                                    entity_id: self.local_entity_id
+                                 }
+        balanced_customer.save
+      end
+      update_attribute(:synced_at, Time.now) unless new_record?
+      balanced_customer
+    end
+  end
+end

data/app/models/transactionable/remote_entity.rb

@@ -0,0 +1,42 @@
+module Transactionable
+  class RemoteEntity < ActiveRecord::Base
+    belongs_to :local_entity, polymorphic: true
+
+    before_destroy :destroy_remote
+
+    def build_or_update_remote
+      raise "Not Implemented"
+    end
+
+    def service_name
+      read_attribute(:service_name) || "Balanced"
+    end
+
+    def build_remote
+      raise "Not Implemented"
+    end
+
+    def update_remote
+      raise "Not Implemented"
+    end
+
+    def synced?
+      !!self.uri
+    end
+
+    def fetch
+      if synced?
+        "#{self.service_name}::#{remote_entity_type}".constantize.find(self.uri)
+      end
+    end
+
+    def remote_entity_type
+      "#{self.class.name.gsub("Transactionable::Remote","")}"
+    end
+
+    def destroy_remote
+      re = self.fetch
+      re.unstore if re
+    end
+  end
+end