balanced-ach 0.1

data/lib/balanced/response/balanced_exception_middleware.rb

@@ -0,0 +1,33 @@
+require 'faraday'
+require 'balanced/error'
+
+# @api private
+module Faraday
+
+  class Response::RaiseBalancedError < Response::Middleware
+
+    HTTP_STATUS_CODES = {
+        300 => Balanced::MoreInformationRequired,
+        400 => Balanced::BadRequest,
+        401 => Balanced::Unauthorized,
+        402 => Balanced::PaymentRequired,
+        403 => Balanced::Forbidden,
+        404 => Balanced::NotFound,
+        405 => Balanced::MethodNotAllowed,
+        409 => Balanced::Conflict,
+        410 => Balanced::Gone,
+        500 => Balanced::InternalServerError,
+        501 => Balanced::NotImplemented,
+        502 => Balanced::BadGateway,
+        503 => Balanced::ServiceUnavailable,
+        504 => Balanced::GatewayTimeout,
+    }
+    def on_complete(response)
+      status_code = response[:status].to_i
+      error_class = HTTP_STATUS_CODES[status_code]
+      raise error_class.new(response) if error_class
+    end
+
+  end
+
+end

data/lib/balanced/utils.rb

@@ -0,0 +1,62 @@
+module Balanced
+  module Utils
+    def camelize underscored_word
+      underscored_word.to_s.gsub(/(?:^|_)(.)/) { $1.upcase }
+    end
+
+    def classify table_name
+      camelize singularize(table_name.to_s.sub(/.*\./, ''))
+    end
+
+    def demodulize class_name_in_module
+      class_name_in_module.to_s.sub(/^.*::/, '')
+    end
+
+    def pluralize word
+      word.to_s.sub(/([^s])$/, '\1s')
+    end
+
+    def singularize word
+      word.to_s.sub(/s$/, '').sub(/ie$/, 'y')
+    end
+
+    def underscore camel_cased_word
+      word = camel_cased_word.to_s.dup
+      word.gsub!(/::/, '/')
+      word.gsub!(/([A-Z]+)([A-Z][a-z])/, '\1_\2')
+      word.gsub!(/([a-z\d])([A-Z])/, '\1_\2')
+      word.tr! "-", "_"
+      word.downcase!
+      word
+    end
+
+    def hash_with_indifferent_read_access base = {}
+      indifferent = Hash.new do |hash, key|
+        hash[key.to_s] if key.is_a? Symbol
+      end
+      base.each_pair do |key, value|
+        if value.is_a? Hash
+          value = hash_with_indifferent_read_access value
+        elsif value.respond_to? :each
+          value.map! do |v|
+            if v.is_a? Hash
+               v = hash_with_indifferent_read_access v
+            end
+            v
+          end
+        end
+        indifferent[key.to_s] = value
+      end
+      indifferent
+    end
+
+    def stringify_keys! hash
+      hash.keys.each do |key|
+        stringify_keys! hash[key] if hash[key].is_a? Hash
+        hash[key.to_s] = hash.delete key if key.is_a? Symbol
+      end
+    end
+
+    extend self
+  end
+end

data/lib/balanced/version.rb

@@ -0,0 +1,3 @@
+module Balanced
+  VERSION = '0.1'
+end

data/spec/balanced/pager_spec.rb

@@ -0,0 +1,42 @@
+require "spec_helper"
+
+describe Balanced::Pager do
+  describe "#adjust_pagination_params" do
+    subject { Balanced::Pager.new 'a uri'}
+
+    it "sets limit based on per" do
+      params = subject.send(:adjust_pagination_params, per: 5)
+      params[:limit].should == 5
+    end
+
+    it "sets offset based on page and default limit" do
+      params = subject.send(:adjust_pagination_params, page: 2)
+      params[:offset].should == 10
+    end
+
+    it "sets offset based on page and per" do
+      params = subject.send(:adjust_pagination_params, page: 2, per: 4)
+      params[:offset].should == 4
+    end
+
+    it "prefers per to limit" do
+      params = subject.send(:adjust_pagination_params, per: 5, limit: 10)
+      params[:limit].should == 5
+    end
+
+    it "falls back to limit" do
+      params = subject.send(:adjust_pagination_params, limit: 3)
+      params[:limit].should == 3
+    end
+
+    it "prefers page to offset" do
+      params = subject.send(:adjust_pagination_params, page: 2, offset: 0)
+      params[:offset].should == 10
+    end
+
+    it "falls back to offset" do
+      params = subject.send(:adjust_pagination_params, offset: 6)
+      params[:offset].should == 6
+    end
+  end
+end

data/spec/balanced/resources/account_spec.rb

@@ -0,0 +1,571 @@
+require "spec_helper"
+
+describe Balanced::Account do
+  use_vcr_cassette
+  before do
+    api_key = Balanced::ApiKey.new.save
+    Balanced.configure api_key.secret
+    @marketplace = Balanced::Marketplace.new.save
+  end
+
+  describe "Account.uri" do
+    use_vcr_cassette
+
+    context "when ApiKey is not configured" do
+      use_vcr_cassette
+      before do
+        Balanced.configure nil
+      end
+
+      it "throw an exception that it can not generate the URI" do
+        expect {
+          Balanced::Account.uri
+        }.to raise_error Balanced::Error
+      end
+    end
+
+    context "when ApiKey is configured" do
+      use_vcr_cassette
+      before do
+        api_key = Balanced::ApiKey.new.save
+        Balanced.configure api_key.secret
+        @marketplace = Balanced::Marketplace.new.save
+      end
+
+      it "it matches the resource's uri structure" do
+        uri = Balanced::Account.uri
+        uri.should_not be_nil
+        uri.should match ACCOUNTS_URI_REGEX
+      end
+    end
+  end
+
+  describe "merchant" do
+    use_vcr_cassette
+
+    before do
+      @merchant_attributes = {
+        :type => "person",
+        :name => "Billy Jones",
+        :street_address => "801 High St.",
+        :postal_code => "94301",
+        :country => "USA",
+        :dob => "1842-01",
+        :phone_number => "+16505551234",
+      }
+    end
+
+    describe "new" do
+      use_vcr_cassette
+      before do
+        @bank_account = Balanced::BankAccount.new(
+          :account_number => "1234567890",
+          :bank_code => "321174851",
+          :name => "Jack Q Merchant"
+        ).save
+      end
+      it do
+        -> do
+          @merchant = Balanced::Account.new(
+            :uri => @marketplace.accounts_uri,
+            :email_address => "merchant@example.org",
+            :merchant => @merchant_attributes,
+            :bank_account_uri => @bank_account.uri,
+            :name => "Jack Q Merchant"
+          )
+        end.should_not raise_error
+      end
+    end
+
+    describe "#save" do
+
+      describe "when creating" do
+        use_vcr_cassette
+        before do
+          bank_account = Balanced::BankAccount.new(
+            :account_number => "1234567890",
+            :bank_code => "321174851",
+            :name => "Jack Q Merchant"
+          ).save
+          @merchant = Balanced::Account.new(
+            :uri => @marketplace.accounts_uri,
+            :email_address => "merchant@example.org",
+            :merchant => @merchant_attributes,
+            :bank_account_uri => bank_account.uri,
+            :name => "Jack Q Merchant"
+          )
+        end
+        it { -> { @merchant.save }.should_not raise_error }
+      end
+
+      describe "after #save" do
+        describe "attributes" do
+          use_vcr_cassette
+          before do
+            bank_account = Balanced::BankAccount.new(
+              :account_number => "1234567890",
+              :bank_code => "321174851",
+              :name => "Jack Q Merchant"
+            ).save
+            @merchant = Balanced::Account.new(
+              :uri => @marketplace.accounts_uri,
+              :email_address => "merchant2@example.org",
+              :merchant => @merchant_attributes,
+              :bank_account_uri => bank_account.uri,
+              :name => "Jack Q Merchant"
+            ).save
+          end
+
+          describe "#id" do
+            subject { @merchant.id }
+            it { should_not be_nil }
+            it { should_not be_empty }
+          end
+          describe "#roles" do
+            subject { @merchant.roles }
+            it { should include("merchant") }
+          end
+          describe "#email_address" do
+            subject { @merchant.email_address }
+            it { should eql "merchant2@example.org" }
+          end
+          describe "#name" do
+            subject { @merchant.name }
+            it { should eql "Jack Q Merchant" }
+          end
+          describe "#created_at" do
+            subject { @merchant.created_at }
+            it { should_not be_nil }
+            it { should_not be_empty }
+          end
+          describe "#uri" do
+            subject { @merchant.uri }
+            it { should match MERCHANT_URI_REGEX }
+          end
+          describe "#holds_uri" do
+            subject { @merchant.holds_uri }
+            it { should match HOLDS_URI_REGEX }
+          end
+          describe "#bank_accounts_uri" do
+            subject { @merchant.bank_accounts_uri }
+            it { should match BANK_ACCOUNTS_URI_REGEX }
+          end
+          describe "#refunds_uri" do
+            subject { @merchant.refunds_uri }
+            it { should match REFUNDS_URI_REGEX }
+          end
+          describe "#debits_uri" do
+            subject { @merchant.debits_uri }
+            it { should match DEBITS_URI_REGEX }
+          end
+          describe "#transactions_uri" do
+            subject { @merchant.transactions_uri }
+            it { should match TRANSACTIONS_URI_REGEX }
+          end
+          describe "#credits_uri" do
+            subject { @merchant.credits_uri }
+            it { should match CREDITS_URI_REGEX }
+          end
+          describe "#cards_uri" do
+            subject { @merchant.cards_uri }
+            it { should match CARDS_URI_REGEX }
+          end
+        end
+      end
+    end
+
+    describe "#add_bank_account" do
+      describe "when executing" do
+        use_vcr_cassette
+
+        before do
+          @bank_account = Balanced::BankAccount.new(
+            :account_number => "1234567890",
+            :bank_code => "321174851",
+            :name => "Jack Q Merchant"
+          ).save
+
+          @merchant = Balanced::Account.new(
+            :uri => @marketplace.accounts_uri,
+            :email_address => "merchant1@example.org",
+            :merchant => @merchant_attributes,
+            :bank_account_uri => @bank_account.uri,
+            :name => "Jack Q Merchant"
+          ).save
+
+          @new_bank_account = Balanced::BankAccount.new(
+            :account_number => "53434533",
+            :bank_code => "12345678",
+            :name => "Jack Q Merchant"
+          ).save
+        end
+        it { -> { @merchant.add_bank_account(@new_bank_account.uri) }.should_not raise_error }
+      end
+
+      describe "after executing" do
+        use_vcr_cassette
+        before do
+          @bank_account = Balanced::BankAccount.new(
+            :account_number => "12345678901",
+            :bank_code => "321174851",
+            :name => "Jack Q Merchant"
+          ).save
+
+          @merchant = Balanced::Account.new(
+            :uri => @marketplace.accounts_uri,
+            :email_address => "merchant4@example.org",
+            :merchant => @merchant_attributes,
+            :bank_account_uri => @bank_account.uri,
+            :name => "Jack Q Merchant"
+          ).save
+
+          @new_bank_account = Balanced::BankAccount.new(
+            :account_number => "53434533",
+            :bank_code => "12345678",
+            :name => "Jack Q Merchant"
+          ).save
+          @merchant.add_bank_account(@new_bank_account.uri)
+          @bank_accounts = Balanced::BankAccount.find(@merchant.bank_accounts_uri).items
+        end
+
+        subject { @bank_accounts.size }
+        it { should eql 2 }
+      end
+
+
+    end
+  end
+
+  describe "buyer" do
+    describe "#save" do
+      describe "when creating" do
+        use_vcr_cassette :record => :new_episodes
+        before do
+          card = Balanced::Card.new(
+            :card_number => "5105105105105100",
+            :expiration_month => "12",
+            :expiration_year => "2015",
+          ).save
+          @buyer = Balanced::Account.new(
+            :uri => @marketplace.accounts_uri,
+            :email_address => "buyer@example.org",
+            :card_uri => card.uri,
+            :name => "Jack Q Buyer"
+          )
+        end
+        it { -> { @buyer.save }.should_not raise_error }
+      end
+
+      describe "after #save" do
+        describe "attributes" do
+          use_vcr_cassette :record => :new_episodes
+          before do
+            card = Balanced::Card.new(
+              :card_number => "4111111111111111",
+              :expiration_month => "12",
+              :expiration_year => "2015",
+            ).save
+            @buyer = Balanced::Account.new(
+              :uri => @marketplace.accounts_uri,
+              :email_address => "buyer2@example.org",
+              :card_uri => card.uri,
+              :name => "Jack Q Buyer"
+            ).save
+          end
+
+          describe "#id" do
+            subject { @buyer.id }
+            it { should_not be_nil }
+            it { should_not be_empty }
+          end
+          describe "#roles" do
+            subject { @buyer.roles }
+            it { should include("buyer") }
+            it { should_not include("merchant") }
+          end
+          describe "#email_address" do
+            subject { @buyer.email_address }
+            it { should eql "buyer2@example.org" }
+          end
+          describe "#name" do
+            subject { @buyer.name }
+            it { should eql "Jack Q Buyer" }
+          end
+          describe "#created_at" do
+            subject { @buyer.created_at }
+            it { should_not be_nil }
+            it { should_not be_empty }
+          end
+          describe "#uri" do
+            subject { @buyer.uri }
+            it { should match MERCHANT_URI_REGEX }
+          end
+          describe "#holds_uri" do
+            subject { @buyer.holds_uri }
+            it { should match HOLDS_URI_REGEX }
+          end
+          describe "#bank_accounts_uri" do
+            subject { @buyer.bank_accounts_uri }
+            it { should match BANK_ACCOUNTS_URI_REGEX }
+          end
+          describe "#refunds_uri" do
+            subject { @buyer.refunds_uri }
+            it { should match REFUNDS_URI_REGEX }
+          end
+          describe "#debits_uri" do
+            subject { @buyer.debits_uri }
+            it { should match DEBITS_URI_REGEX }
+          end
+          describe "#transactions_uri" do
+            subject { @buyer.transactions_uri }
+            it { should match TRANSACTIONS_URI_REGEX }
+          end
+          describe "#credits_uri" do
+            subject { @buyer.credits_uri }
+            it { should match CREDITS_URI_REGEX }
+          end
+          describe "#cards_uri" do
+            subject { @buyer.cards_uri }
+            it { should match CARDS_URI_REGEX }
+          end
+          describe "#cards" do
+            subject { @buyer.cards }
+            it { should be_instance_of Array }
+            it { should_not be_empty }
+            it { subject.first.should be_instance_of Balanced::Card }
+          end
+          describe "#bank_accounts" do
+            subject { @buyer.bank_accounts }
+            it { should be_instance_of Array }
+            it { should be_empty }
+          end
+        end
+      end
+    end
+
+    describe "#add_card" do
+
+      describe "when executing" do
+        use_vcr_cassette
+        before do
+          card = Balanced::Card.new(
+            :card_number => "4111111111111111",
+            :expiration_month => "12",
+            :expiration_year => "2015",
+          ).save
+          @new_card = Balanced::Card.new(
+            :card_number => "4111111111111111",
+            :expiration_month => "1",
+            :expiration_year => "2015",
+          ).save
+          @buyer = Balanced::Account.new(
+            :uri => @marketplace.accounts_uri,
+            :email_address => "buyer3@example.org",
+            :card_uri => card.uri,
+            :name => "Jack Q Buyer"
+          ).save
+        end
+        it do
+          -> { @buyer.add_card(@new_card.uri) }.should_not raise_error
+        end
+      end
+      describe "after executing" do
+        use_vcr_cassette
+
+        before do
+          card = Balanced::Card.new(
+            :card_number => "4111111111111111",
+            :expiration_month => "12",
+            :expiration_year => "2015",
+          ).save
+          @new_card = Balanced::Card.new(
+            :card_number => "5105105105105100",
+            :expiration_month => "1",
+            :expiration_year => "2017",
+          ).save
+          @buyer = Balanced::Account.new(
+            :uri => @marketplace.accounts_uri,
+            :email_address => "buyer4@example.org",
+            :card_uri => card.uri,
+            :name => "Jack Q Buyer"
+          ).save
+          @buyer.add_card(@new_card.uri)
+          @cards = Balanced::Card.find @buyer.cards_uri
+        end
+        subject { @cards.items.size }
+        it { should eql 2 }
+      end
+    end
+
+    describe "#promote_to_merchant" do
+
+      describe "when executing" do
+        use_vcr_cassette
+        before do
+
+          @merchant_attributes = {
+            :type => "person",
+            :name => "Billy Jones",
+            :street_address => "801 High St.",
+            :postal_code => "94301",
+            :country => "USA",
+            :dob => "1842-01",
+            :phone_number => "+16505551234",
+          }
+          card = Balanced::Card.new(
+            :card_number => "4111111111111111",
+            :expiration_month => "12",
+            :expiration_year => "2015",
+          ).save
+          @buyer = Balanced::Account.new(
+            :uri => @marketplace.accounts_uri,
+            :email_address => "buyer5@example.org",
+            :card_uri => card.uri,
+            :name => "Jack Q Buyer"
+          ).save
+        end
+
+        it do
+          -> { @buyer.promote_to_merchant @merchant_attributes}.should_not raise_error
+        end
+      end
+      describe "after executing" do
+        use_vcr_cassette
+
+        before do
+          @merchant_attributes = {
+            :type => "person",
+            :name => "Billy Jones",
+            :street_address => "801 High St.",
+            :postal_code => "94301",
+            :country => "USA",
+            :dob => "1842-01",
+            :phone_number => "+16505551234",
+          }
+          card = Balanced::Card.new(
+            :card_number => "4111111111111111",
+            :expiration_month => "12",
+            :expiration_year => "2015",
+          ).save
+          @buyer = Balanced::Account.new(
+            :uri => @marketplace.accounts_uri,
+            :email_address => "buyer6@example.org",
+            :card_uri => card.uri,
+            :name => "Jack Q Buyer"
+          ).save
+          @buyer.promote_to_merchant @merchant_attributes
+        end
+        subject { @buyer.roles }
+        it { should include("merchant") }
+      end
+
+    end
+
+    describe "#debit" do
+      use_vcr_cassette :match_requests_on => [:body], :record => :new_episodes
+      before do
+        card = Balanced::Card.new(
+          :card_number => "4111111111111111",
+          :expiration_month => "12",
+          :expiration_year => "2015",
+        ).save
+        begin
+          @buyer = Balanced::Account.new(
+            :uri => @marketplace.accounts_uri,
+            :email_address => "buyer7@example.org",
+            :card_uri => card.uri,
+            :name => "Jack Q Buyer"
+          ).save
+        rescue Balanced::Conflict => ex
+          @buyer = Balanced::Account.find(ex.extras[:account_uri])
+        end
+      end
+      it "takes optional parameters"  do
+        debit = @buyer.debit(
+          :amount => 500,
+          :appears_on_statement_as => "BOBS BURGERS",
+        )
+        debit.should be_instance_of Balanced::Debit
+        debit.amount.should eql 500
+        debit.appears_on_statement_as.should eql "BOBS BURGERS"
+      end
+      it "takes positional parameters" do
+        debit = @buyer.debit(500, "FOO FIGHTER")
+        debit.should be_instance_of Balanced::Debit
+        debit.amount.should eql 500
+        debit.appears_on_statement_as.should eql "FOO FIGHTER"
+      end
+
+    end
+  end
+
+  describe ".find" do
+    use_vcr_cassette
+
+    before do
+      api_key = Balanced::ApiKey.new.save
+      Balanced.configure api_key.secret
+      @marketplace = Balanced::Marketplace.new.save
+      card = Balanced::Card.new(
+        :card_number => "5105105105105100",
+        :expiration_month => "12",
+        :expiration_year => "2015",
+      ).save
+      Balanced::Marketplace.my_marketplace.create_buyer(
+        "john.doe@example.com",
+        card.uri
+      )
+    end
+
+    context "(:all, :some_field => 'op')" do
+      use_vcr_cassette
+      it "should find the account by returning a page with items of one" do
+        response = Balanced::Account.find(:all, :email_address => "john.doe@example.com")
+        response.should be_instance_of Array
+        response[0].should be_instance_of Balanced::Account
+      end
+    end
+
+    context "(:first, :some_field => 'op')" do
+      use_vcr_cassette
+      it "should find the account by returning the first item" do
+        response = Balanced::Account.find(:first, :email_address => "john.doe@example.com")
+        response.should be_instance_of Balanced::Account
+      end
+    end
+
+
+  end
+
+  describe ".find_by_email" do
+    use_vcr_cassette  :record => :new_episodes
+    before do
+      api_key = Balanced::ApiKey.new.save
+      Balanced.configure api_key.secret
+      @marketplace = Balanced::Marketplace.new.save
+      card = Balanced::Card.new(
+        :card_number => "5105105105105100",
+        :expiration_month => "12",
+        :expiration_year => "2015",
+      ).save
+      buyer = Balanced::Marketplace.my_marketplace.create_buyer(
+        "john.doe@example.com",
+        card.uri
+      )
+    end
+
+    context "email address is in system" do
+      use_vcr_cassette  :record => :new_episodes
+      it "should return account object" do
+        Balanced::Account.find_by_email("john.doe@example.com").should be_instance_of Balanced::Account
+      end
+    end
+
+    context "email address does not exist" do
+      use_vcr_cassette  :record => :new_episodes
+      it "should return nil" do
+        Balanced::Account.find_by_email("foo@bar.com").should be_nil
+      end
+    end
+  end
+end