zen-plaid 0.0.2

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: a6b519922fa379a6daeb4daab3532af7ce63fa46
+  data.tar.gz: cf7ee2f343ab48afc87a17ce65b5edca75333e40
+SHA512:
+  metadata.gz: 00ad929ef2b22e9c452b44d53c125b3921dc321332e376adcef981c3d517c72a27c626c43cd34756b6321eb85b7ba3e1ca76ce7f398d671cbfac0d1a9bb333ca
+  data.tar.gz: 05df053ed9761ecf194dd22c25a2a0cc6b1df1253b449540c3e8d8568359aaf11fbb5c82c6554803d961d3e4029ac88d86c841c41e16e4a7bcc055b569639800

data/.gitignore

@@ -0,0 +1,22 @@
+*.gem
+*.rbc
+.bundle
+.config
+.yardoc
+Gemfile.lock
+InstalledFiles
+_yardoc
+coverage
+doc/
+lib/bundler/man
+pkg
+rdoc
+spec/reports
+test/tmp
+test/version_tmp
+tmp
+*.bundle
+*.so
+*.o
+*.a
+mkmf.log

data/.rspec

@@ -0,0 +1 @@
+--color

data/.travis.yml

@@ -0,0 +1,7 @@
+language: ruby
+rvm:
+  - 1.9.2
+  - 1.9.3
+  - 2.0.0
+  - 2.1.1
+  - 2.1.2

data/Gemfile

@@ -0,0 +1,2 @@
+source 'https://rubygems.org'
+gemspec

data/LICENSE

@@ -0,0 +1,20 @@
+The MIT License (MIT)
+
+Copyright (c) 2014 Sean McCann
+
+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.md

@@ -0,0 +1,7 @@
+[![Build Status](https://travis-ci.org/seanmccann/zen-plaid.svg)](https://travis-ci.org/seanmccann/zen-plaid)
+
+# zen-plaid
+
+A zen Ruby gem wrapper for the Plaid API. For more details, please see the [full API documentation](https://plaid.com/docs).
+
+The original gem sucked and this one rocks. Thanks to Stripe for borrowing some RestClient wrapper code and ideas.

data/Rakefile

@@ -0,0 +1,6 @@
+require 'rake'
+require 'rspec/core/rake_task'
+
+RSpec::Core::RakeTask.new(:spec)
+
+task default: :spec

data/lib/zen-plaid/auth.rb

@@ -0,0 +1,7 @@
+module Plaid
+  class Auth
+    def self.add(params)
+      Plaid.request(:post, '/auth', params)
+    end
+  end
+end

data/lib/zen-plaid/balance.rb

@@ -0,0 +1,7 @@
+module Plaid
+  class Balance
+    def self.get(access_token)
+      Plaid.request(:post, '/balance/', {access_token: access_token} )
+    end
+  end
+end

data/lib/zen-plaid/category.rb

@@ -0,0 +1,11 @@
+module Plaid
+  class Category
+    def self.all
+      Plaid.request(:get, '/categories')[:message]
+    end
+
+    def self.find(id)
+      Plaid.request(:get, '/categories/' + id )[:message]
+    end
+  end
+end

data/lib/zen-plaid/configuration.rb

@@ -0,0 +1,23 @@
+module Plaid
+  class << self
+    attr_accessor :configuration
+  end
+
+  def self.configuration
+    @configuration ||= Configuration.new
+  end
+
+  def self.configure
+    yield(configuration)
+  end
+
+  class Configuration
+     attr_accessor :environment, :client_id, :secret
+
+     def initialize
+        @environment ||= 'development'
+        @client_id ||= 'test_id'
+        @secret ||= 'test_secret'
+     end
+  end
+end

data/lib/zen-plaid/connect.rb

@@ -0,0 +1,15 @@
+module Plaid
+  class Connect
+    def self.get(params)
+      Plaid.request(:post, '/connect/get', params)
+    end
+
+    def self.add(params)
+      Plaid.request(:post, '/connect', params)
+    end
+
+    def self.mfa_step(params)
+      Plaid.request(:post, '/connect/step', params)
+    end
+  end
+end

data/lib/zen-plaid/entity.rb

@@ -0,0 +1,7 @@
+module Plaid
+  class Entity
+    def self.find(id)
+      Plaid.request(:get, '/entities/' + id )[:message]
+    end
+  end
+end

data/lib/zen-plaid/institution.rb

@@ -0,0 +1,11 @@
+module Plaid
+  class Institution
+    def self.all
+      Plaid.request(:get, '/institutions')[:message]
+    end
+
+    def self.find(id)
+      Plaid.request(:get, '/institutions/' + id )[:message]
+    end
+  end
+end

data/lib/zen-plaid/util.rb

@@ -0,0 +1,67 @@
+module Plaid
+  module Util
+    def self.objects_to_ids(h)
+      case h
+      when APIResource
+        h.id
+      when Hash
+        res = {}
+        h.each { |k, v| res[k] = objects_to_ids(v) unless v.nil? }
+        res
+      when Array
+        h.map { |v| objects_to_ids(v) }
+      else
+        h
+      end
+    end
+
+    def self.symbolize_names(object)
+      case object
+      when Hash
+        new = {}
+        object.each do |key, value|
+          key = (key.to_sym rescue key) || key
+          new[key] = symbolize_names(value)
+        end
+        new
+      when Array
+        object.map { |value| symbolize_names(value) }
+      else
+        object
+      end
+    end
+
+    def self.url_encode(key)
+      URI.escape(key.to_s, Regexp.new("[^#{URI::PATTERN::UNRESERVED}]"))
+    end
+
+    def self.flatten_params(params, parent_key=nil)
+      result = []
+      params.each do |key, value|
+        calculated_key = parent_key ? "#{parent_key}[#{url_encode(key)}]" : url_encode(key)
+        if value.is_a?(Hash)
+          result += flatten_params(value, calculated_key)
+        elsif value.is_a?(Array)
+          result += flatten_params_array(value, calculated_key)
+        else
+          result << [calculated_key, value]
+        end
+      end
+      result
+    end
+
+    def self.flatten_params_array(value, calculated_key)
+      result = []
+      value.each do |elem|
+        if elem.is_a?(Hash)
+          result += flatten_params(elem, calculated_key)
+        elsif elem.is_a?(Array)
+          result += flatten_params_array(elem, calculated_key)
+        else
+          result << ["#{calculated_key}[]", elem]
+        end
+      end
+      result
+    end
+  end
+end

data/lib/zen-plaid/version.rb

@@ -0,0 +1,3 @@
+module Plaid
+  VERSION = '0.0.2'
+end

data/lib/zen-plaid.rb

@@ -0,0 +1,79 @@
+require 'rest_client'
+require 'oj'
+
+require 'zen-plaid/version'
+require 'zen-plaid/configuration'
+require 'zen-plaid/util'
+
+require 'zen-plaid/auth'
+require 'zen-plaid/connect'
+require 'zen-plaid/institution'
+require 'zen-plaid/category'
+require 'zen-plaid/entity'
+require 'zen-plaid/balance'
+
+module Plaid
+  def self.uri_encode(params)
+    Util.flatten_params(params).
+      map { |k,v| "#{k}=#{Util.url_encode(v)}" }.join('&')
+  end
+
+  def self.handle_api_error(rcode, rbody)
+    error_obj = Util.symbolize_names(Oj.load(rbody))
+
+    {code: rcode, error: error_obj}
+  end
+
+  def self.parse(response)
+    begin
+      response = Util.symbolize_names(Oj.load(response.body))
+    rescue Oj::ParseError
+      raise general_api_error(response.code, response.body)
+    end
+  end
+
+  def self.api_url(url='')
+    api_base + url
+  end
+
+  def self.api_base
+    if Plaid.configuration.environment == 'production'
+      'https://api.plaid.com/'
+    else
+      'https://tartan.plaid.com/'
+    end
+  end
+
+  def self.request(method, url, params={}, headers={})
+    request_opts = { verify_ssl: false }
+    url = api_url(url)
+    params = params.merge!(auth)
+
+    case method.to_s.downcase.to_sym
+    when :get, :head, :delete
+      # Make params into GET parameters
+      url += "#{URI.parse(url).query ? '&' : '?'}#{uri_encode(params)}" if params && params.any?
+      payload = nil
+    else
+      payload = uri_encode(params)
+    end
+
+    request_opts.update(headers: headers,
+                        method: method,
+                        open_timeout: 30,
+                        payload: payload,
+                        url: url,
+                        timeout: 80)
+
+    begin
+      response = RestClient::Request.execute(request_opts)
+      return {code: response.code, message: parse(response)}
+    rescue RestClient::ExceptionWithResponse => e
+      return handle_api_error(e.http_code, e.http_body)
+    end
+  end
+
+  def self.auth
+    {client_id: Plaid.configuration.client_id, secret: Plaid.configuration.secret}
+  end
+end

data/spec/auth_spec.rb

@@ -0,0 +1,170 @@
+require 'spec_helper.rb'
+
+describe Plaid::Auth do
+  context 'unsupported institution' do
+    it "returns 404 http code" do
+      connection = Plaid::Auth.add({type: 'amex', username: 'plaid_test', password: 'plaid_good'})
+      expect(connection[:code]).to eq(404)
+    end
+  end
+
+  context 'missing password' do
+    it "returns 400 http code" do
+      connection = Plaid::Auth.add({type: 'bofa', username: 'plaid_test'})
+      expect(connection[:code]).to eq(400)
+    end
+  end
+
+  context 'pin when its not needed' do
+    it "returns 200 http code" do
+      connection = Plaid::Auth.add({type: 'schwab', username: 'plaid_test', password: 'plaid_good', pin: 1234})
+      expect(connection[:code]).to eq(200)
+    end
+  end
+
+  context 'forget pin when its needed' do
+    it "returns 402 http code" do
+      connection = Plaid::Auth.add({type: 'usaa', username: 'plaid_test', password: 'plaid_good'})
+      expect(connection[:code]).to eq(402)
+    end
+  end
+
+  context 'wrong credentials with no mfa' do
+    it "returns 402 http code" do
+      connection = Plaid::Auth.add({type: 'schwab', username: 'plaid_test', password: 'plaid_bad'})
+      expect(connection[:code]).to eq(402)
+    end
+
+    it "returns error message" do
+      connection = Plaid::Auth.add({type: 'schwab', username: 'plaid_test', password: 'plaid_bad'})
+      expect(connection[:error][:message]).to eq('invalid credentials')
+    end
+
+    it "returns error resolution" do
+      connection = Plaid::Auth.add({type: 'schwab', username: 'plaid_test', password: 'plaid_bad'})
+      expect(connection[:error][:resolve]).to eq('The username or password provided were not correct.')
+    end
+  end
+
+  context 'wrong credentials with mfa' do
+    it "returns 402 http code" do
+      connection = Plaid::Auth.add({type: 'chase', username: 'plaid_test', password: 'plaid_bad'})
+      expect(connection[:code]).to eq(402)
+    end
+
+    it "returns error message" do
+      connection = Plaid::Auth.add({type: 'chase', username: 'plaid_test', password: 'plaid_bad'})
+      expect(connection[:error][:message]).to eq('invalid credentials')
+    end
+
+    it "returns error resolution" do
+      connection = Plaid::Auth.add({type: 'chase', username: 'plaid_test', password: 'plaid_bad'})
+      expect(connection[:error][:resolve]).to eq('The username or password provided were not correct.')
+    end
+  end
+
+  context 'correct credentials with no mfa' do
+    it "returns 200 http code" do
+      connection = Plaid::Auth.add({type: 'schwab', username: 'plaid_test', password: 'plaid_good'})
+      expect(connection[:code]).to eq(200)
+    end
+
+    it "returns accounts" do
+      connection = Plaid::Auth.add({type: 'schwab', username: 'plaid_test', password: 'plaid_good'})
+      expect(connection[:message]).to have_key(:accounts)
+    end
+  end
+
+  # context 'correct credentials with pin' do
+  #   it "returns 200 http code" do
+  #     connection = Plaid::Auth.add({type: 'usaa', username: 'plaid_test', password: 'plaid_good', pin: 1234})
+  #     expect(connection[:code]).to eq(200)
+  #   end
+
+  #   it "returns accounts" do
+  #     connection = Plaid::Auth.add({type: 'usaa', username: 'plaid_test', password: 'plaid_good', pin: 1234})
+  #     expect(connection[:message]).to have_key(:accounts)
+  #   end
+
+  #   it "returns transactions" do
+  #     connection = Plaid::Auth.add({type: 'usaa', username: 'plaid_test', password: 'plaid_good', pin: 1234})
+  #     expect(connection[:message]).to have_key(:transactions)
+  #   end
+  # end
+
+  context 'correct credentials with default chase mfa' do
+    it "returns 201 http code" do
+      connection = Plaid::Auth.add({type: 'chase', username: 'plaid_test', password: 'plaid_good'})
+      expect(connection[:code]).to eq(201)
+    end
+
+    it "returns access_token" do
+      connection = Plaid::Auth.add({type: 'chase', username: 'plaid_selections', password: 'plaid_good'})
+      expect(connection[:message]).to have_key(:access_token)
+    end
+
+    it "returns mfa type" do
+      connection = Plaid::Auth.add({type: 'chase', username: 'plaid_selections', password: 'plaid_good'})
+      expect(connection[:message][:type]).to eq("device")
+    end
+
+    it "returns mfa message" do
+      connection = Plaid::Auth.add({type: 'chase', username: 'plaid_selections', password: 'plaid_good'})
+      expect(connection[:message][:mfa][:message]).to eq("Code sent to t..t@plaid.com")
+    end
+  end
+
+  context 'correct credentials with chase mfa choice' do
+    it "returns 201 http code" do
+      connection = Plaid::Auth.add({type: 'chase', username: 'plaid_selections', password: 'plaid_good', options: {list: true}})
+      expect(connection[:code]).to eq(201)
+    end
+
+    it "returns access_token" do
+      connection = Plaid::Auth.add({type: 'chase', username: 'plaid_selections', password: 'plaid_good', options: {list: true}})
+      expect(connection[:message]).to have_key(:access_token)
+    end
+
+    it "returns mfa type as list" do
+      connection = Plaid::Auth.add({type: 'chase', username: 'plaid_selections', password: 'plaid_good', options: {list: true}})
+      expect(connection[:message][:type]).to eq("list")
+    end
+
+    it "returns mfa list array" do
+      connection = Plaid::Auth.add({type: 'chase', username: 'plaid_selections', password: 'plaid_good', options: {list: true}})
+      expect(connection[:message][:mfa]).to be_an(Array)
+    end
+  end
+
+  context 'correct credentials with citi bank' do
+    it "returns 201 http code" do
+      connection = Plaid::Auth.add({type: 'citi', username: 'plaid_selections', password: 'plaid_good'})
+      expect(connection[:code]).to eq(201)
+    end
+
+    it "returns access_token" do
+      connection = Plaid::Auth.add({type: 'citi', username: 'plaid_selections', password: 'plaid_good'})
+      expect(connection[:message]).to have_key(:access_token)
+    end
+
+    it "returns mfa type" do
+      connection = Plaid::Auth.add({type: 'citi', username: 'plaid_selections', password: 'plaid_good'})
+      expect(connection[:message][:type]).to eq("selections")
+    end
+
+    it "returns mfa list array" do
+      connection = Plaid::Auth.add({type: 'citi', username: 'plaid_selections', password: 'plaid_good'})
+      expect(connection[:message][:mfa]).to be_an(Array)
+    end
+
+    it "returns mfa questions" do
+      connection = Plaid::Auth.add({type: 'citi', username: 'plaid_selections', password: 'plaid_good'})
+      expect(connection[:message][:mfa][0]).to have_key(:question)
+    end
+
+    it "returns mfa question selections" do
+      connection = Plaid::Auth.add({type: 'citi', username: 'plaid_selections', password: 'plaid_good'})
+      expect(connection[:message][:mfa][0]).to have_key(:answers)
+    end
+  end
+end

data/spec/balance_spec.rb

@@ -0,0 +1,17 @@
+require 'spec_helper.rb'
+
+describe Plaid::Balance do
+  describe "#get" do
+    it "returns 200 http code" do
+      expect(Plaid::Balance.get('test')[:code]).to eq(200)
+    end
+
+    it "returns accounts" do
+      expect(Plaid::Balance.get('test')[:message][:accounts]).to be_an(Array)
+    end
+
+    it "returns accounts with balances" do
+      expect(Plaid::Balance.get('test')[:message][:accounts][0]).to have_key(:balance)
+    end
+  end
+end

data/spec/category_spec.rb

@@ -0,0 +1,15 @@
+require 'spec_helper.rb'
+
+describe Plaid::Category do
+  describe "#all" do
+    it "returns categories" do
+      expect(Plaid::Category.all).to be_an(Array)
+    end
+  end
+
+  describe "#find" do
+    it "finds American Express" do
+      expect(Plaid::Category.find('52544965f71e87d007000049')[:hierarchy].first).to eq('Food and Drink')
+    end
+  end
+end

data/spec/connect_spec.rb

@@ -0,0 +1,251 @@
+require 'spec_helper.rb'
+
+describe Plaid::Connect do
+  describe "#get" do
+    it "returns 200 http code" do
+      connection = Plaid::Connect.get({access_token: 'test', type: 'chase'})
+      expect(connection[:code]).to eq(200)
+    end
+
+    it "returns transactions" do
+      connection = Plaid::Connect.get({access_token: 'test', type: 'chase'})
+      expect(connection[:message]).to have_key(:transactions)
+    end
+
+    it "returns accounts" do
+      connection = Plaid::Connect.get({access_token: 'test', type: 'chase'})
+      expect(connection[:message]).to have_key(:accounts)
+    end
+  end
+
+  describe "#mfa_step" do
+    context 'correct mfa reply code' do
+      it "returns 200 http code" do
+        connection = Plaid::Connect.mfa_step({access_token: 'test', type: 'chase', mfa: '1234'})
+        expect(connection[:code]).to eq(200)
+      end
+    end
+
+    context 'wrong mfa reply code' do
+      it "returns 402 http code" do
+        connection = Plaid::Connect.mfa_step({access_token: 'test', type: 'chase', mfa: '666'})
+        expect(connection[:code]).to eq(402)
+      end
+
+      it "returns error message" do
+        connection = Plaid::Connect.mfa_step({access_token: 'test', type: 'chase', mfa: '666'})
+        expect(connection[:error][:message]).to eq("invalid mfa")
+      end
+    end
+
+    context 'correct mfa reply answer' do
+      it "returns 200 http code" do
+        connection = Plaid::Connect.mfa_step({access_token: 'test', type: 'us', mfa: 'tomato'})
+        expect(connection[:code]).to eq(200)
+      end
+    end
+
+    context 'wrong mfa reply answer' do
+      it "returns 402 http code" do
+        connection = Plaid::Connect.mfa_step({access_token: 'test', type: 'us', mfa: 'wrong'})
+        expect(connection[:code]).to eq(402)
+      end
+
+      it "returns error message" do
+        connection = Plaid::Connect.mfa_step({access_token: 'test', type: 'us', mfa: 'wrong'})
+        expect(connection[:error][:message]).to eq("invalid mfa")
+      end
+    end
+
+    context 'correct mfa reply selections' do
+      it "returns 200 http code" do
+        connection = Plaid::Connect.mfa_step({access_token: 'test', type: 'citi', credentials: {pin: 1234}})
+        expect(connection[:code]).to eq(200)
+      end
+    end
+  end
+
+  describe "#add" do
+    context 'missing password' do
+      it "returns 400 http code" do
+        connection = Plaid::Connect.add({type: 'amex', username: 'plaid_test'})
+        expect(connection[:code]).to eq(400)
+      end
+    end
+
+    context 'pin when its not needed' do
+      it "returns 200 http code" do
+        connection = Plaid::Connect.add({type: 'amex', username: 'plaid_test', password: 'plaid_good', pin: 1234})
+        expect(connection[:code]).to eq(200)
+      end
+    end
+
+    context 'forget pin when its needed' do
+      it "returns 402 http code" do
+        connection = Plaid::Connect.add({type: 'usaa', username: 'plaid_test', password: 'plaid_good'})
+        expect(connection[:code]).to eq(402)
+      end
+    end
+
+    context 'locked credentials with no mfa' do
+      it "returns 402 http code" do
+        connection = Plaid::Connect.add({type: 'amex', username: 'plaid_test', password: 'plaid_locked'})
+        expect(connection[:code]).to eq(402)
+      end
+
+      it "returns error message" do
+        connection = Plaid::Connect.add({type: 'amex', username: 'plaid_test', password: 'plaid_locked'})
+        expect(connection[:error][:message]).to eq('account locked')
+      end
+
+      it "returns error resolution" do
+        connection = Plaid::Connect.add({type: 'amex', username: 'plaid_test', password: 'plaid_locked'})
+        expect(connection[:error][:resolve]).to include('The account is locked.')
+      end
+    end
+
+    context 'wrong credentials with no mfa' do
+      it "returns 402 http code" do
+        connection = Plaid::Connect.add({type: 'amex', username: 'plaid_test', password: 'plaid_bad'})
+        expect(connection[:code]).to eq(402)
+      end
+
+      it "returns error message" do
+        connection = Plaid::Connect.add({type: 'amex', username: 'plaid_test', password: 'plaid_bad'})
+        expect(connection[:error][:message]).to eq('invalid credentials')
+      end
+
+      it "returns error resolution" do
+        connection = Plaid::Connect.add({type: 'amex', username: 'plaid_test', password: 'plaid_bad'})
+        expect(connection[:error][:resolve]).to eq('The username or password provided were not correct.')
+      end
+    end
+
+    context 'wrong credentials with mfa' do
+      it "returns 402 http code" do
+        connection = Plaid::Connect.add({type: 'chase', username: 'plaid_test', password: 'plaid_bad'})
+        expect(connection[:code]).to eq(402)
+      end
+
+      it "returns error message" do
+        connection = Plaid::Connect.add({type: 'chase', username: 'plaid_test', password: 'plaid_bad'})
+        expect(connection[:error][:message]).to eq('invalid credentials')
+      end
+
+      it "returns error resolution" do
+        connection = Plaid::Connect.add({type: 'chase', username: 'plaid_test', password: 'plaid_bad'})
+        expect(connection[:error][:resolve]).to eq('The username or password provided were not correct.')
+      end
+    end
+
+    context 'correct credentials with no mfa' do
+      it "returns 200 http code" do
+        connection = Plaid::Connect.add({type: 'amex', username: 'plaid_test', password: 'plaid_good'})
+        expect(connection[:code]).to eq(200)
+      end
+
+      it "returns accounts" do
+        connection = Plaid::Connect.add({type: 'amex', username: 'plaid_test', password: 'plaid_good'})
+        expect(connection[:message]).to have_key(:accounts)
+      end
+
+      it "returns transactions" do
+        connection = Plaid::Connect.add({type: 'amex', username: 'plaid_test', password: 'plaid_good'})
+        expect(connection[:message]).to have_key(:transactions)
+      end
+    end
+
+    context 'correct credentials with pin' do
+      it "returns 200 http code" do
+        connection = Plaid::Connect.add({type: 'amex', username: 'plaid_test', password: 'plaid_good', pin: 1234})
+        expect(connection[:code]).to eq(200)
+      end
+
+      it "returns accounts" do
+        connection = Plaid::Connect.add({type: 'amex', username: 'plaid_test', password: 'plaid_good', pin: 1234})
+        expect(connection[:message]).to have_key(:accounts)
+      end
+
+      it "returns transactions" do
+        connection = Plaid::Connect.add({type: 'amex', username: 'plaid_test', password: 'plaid_good', pin: 1234})
+        expect(connection[:message]).to have_key(:transactions)
+      end
+    end
+
+    context 'correct credentials with default chase mfa' do
+      it "returns 201 http code" do
+        connection = Plaid::Connect.add({type: 'chase', username: 'plaid_test', password: 'plaid_good'})
+        expect(connection[:code]).to eq(201)
+      end
+
+      it "returns access_token" do
+        connection = Plaid::Connect.add({type: 'chase', username: 'plaid_selections', password: 'plaid_good'})
+        expect(connection[:message]).to have_key(:access_token)
+      end
+
+      it "returns mfa type" do
+        connection = Plaid::Connect.add({type: 'chase', username: 'plaid_selections', password: 'plaid_good'})
+        expect(connection[:message][:type]).to eq("device")
+      end
+
+      it "returns mfa message" do
+        connection = Plaid::Connect.add({type: 'chase', username: 'plaid_selections', password: 'plaid_good'})
+        expect(connection[:message][:mfa][:message]).to eq("Code sent to t..t@plaid.com")
+      end
+    end
+
+    context 'correct credentials with chase mfa choice' do
+      it "returns 201 http code" do
+        connection = Plaid::Connect.add({type: 'chase', username: 'plaid_selections', password: 'plaid_good', options: {list: true}})
+        expect(connection[:code]).to eq(201)
+      end
+
+      it "returns access_token" do
+        connection = Plaid::Connect.add({type: 'chase', username: 'plaid_selections', password: 'plaid_good', options: {list: true}})
+        expect(connection[:message]).to have_key(:access_token)
+      end
+
+      it "returns mfa type as list" do
+        connection = Plaid::Connect.add({type: 'chase', username: 'plaid_selections', password: 'plaid_good', options: {list: true}})
+        expect(connection[:message][:type]).to eq("list")
+      end
+
+      it "returns mfa list array" do
+        connection = Plaid::Connect.add({type: 'chase', username: 'plaid_selections', password: 'plaid_good', options: {list: true}})
+        expect(connection[:message][:mfa]).to be_an(Array)
+      end
+    end
+
+    context 'correct credentials with citi bank' do
+      it "returns 201 http code" do
+        connection = Plaid::Connect.add({type: 'citi', username: 'plaid_selections', password: 'plaid_good'})
+        expect(connection[:code]).to eq(201)
+      end
+
+      it "returns access_token" do
+        connection = Plaid::Connect.add({type: 'citi', username: 'plaid_selections', password: 'plaid_good'})
+        expect(connection[:message]).to have_key(:access_token)
+      end
+
+      it "returns mfa type" do
+        connection = Plaid::Connect.add({type: 'citi', username: 'plaid_selections', password: 'plaid_good'})
+        expect(connection[:message][:type]).to eq("selections")
+      end
+
+      it "returns mfa list array" do
+        connection = Plaid::Connect.add({type: 'citi', username: 'plaid_selections', password: 'plaid_good'})
+        expect(connection[:message][:mfa]).to be_an(Array)
+      end
+
+      it "returns mfa questions" do
+        connection = Plaid::Connect.add({type: 'citi', username: 'plaid_selections', password: 'plaid_good'})
+        expect(connection[:message][:mfa][0]).to have_key(:question)
+      end
+
+      it "returns mfa question selections" do
+        connection = Plaid::Connect.add({type: 'citi', username: 'plaid_selections', password: 'plaid_good'})
+        expect(connection[:message][:mfa][0]).to have_key(:answers)
+      end
+    end
+  end
+end

data/spec/entity_spec.rb

@@ -0,0 +1,9 @@
+require 'spec_helper.rb'
+
+describe Plaid::Entity do
+  describe "#find" do
+    it "finds " do
+      expect(Plaid::Entity.find('526842af335228673f0000b7')[:name]).to eq('Starbucks')
+    end
+  end
+end

data/spec/institution_spec.rb

@@ -0,0 +1,15 @@
+require 'spec_helper.rb'
+
+describe Plaid::Institution do
+  describe "#all" do
+    it "returns institutions" do
+      expect(Plaid::Institution.all).to be_an(Array)
+    end
+  end
+
+  describe "#find" do
+    it "finds American Express" do
+      expect(Plaid::Institution.find('5301a9d704977c52b60000db')[:name]).to eq('American Express')
+    end
+  end
+end

data/spec/spec_helper.rb

@@ -0,0 +1,4 @@
+require 'bundler/setup'
+Bundler.setup
+
+require 'zen-plaid'

data/zen-plaid.gemspec

@@ -0,0 +1,19 @@
+$:.unshift(File.join(File.dirname(__FILE__), 'lib'))
+require 'zen-plaid/version'
+
+Gem::Specification.new do |s|
+  s.name        = 'zen-plaid'
+  s.version     = Plaid::VERSION
+  s.date        = '2014-10-22'
+  s.summary     = 'Plaid Ruby Gem'
+  s.description = 'Ruby Gem wrapper for Plaid API.'
+  s.authors     = ['Sean McCann']
+  s.email       = 'sean@smccann.com'
+  s.files       = `git ls-files`.split("\n")
+  s.homepage    = 'https://github.com/seanmccann/zen-plaid'
+  s.license     = 'MIT'
+  s.add_runtime_dependency 'rest-client'
+  s.add_runtime_dependency 'oj'
+  s.add_development_dependency 'rake'
+  s.add_development_dependency 'rspec'
+end

metadata

@@ -0,0 +1,125 @@
+--- !ruby/object:Gem::Specification
+name: zen-plaid
+version: !ruby/object:Gem::Version
+  version: 0.0.2
+platform: ruby
+authors:
+- Sean McCann
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2014-10-22 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: rest-client
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: oj
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: rspec
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+description: Ruby Gem wrapper for Plaid API.
+email: sean@smccann.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- .gitignore
+- .rspec
+- .travis.yml
+- Gemfile
+- LICENSE
+- README.md
+- Rakefile
+- lib/zen-plaid.rb
+- lib/zen-plaid/auth.rb
+- lib/zen-plaid/balance.rb
+- lib/zen-plaid/category.rb
+- lib/zen-plaid/configuration.rb
+- lib/zen-plaid/connect.rb
+- lib/zen-plaid/entity.rb
+- lib/zen-plaid/institution.rb
+- lib/zen-plaid/util.rb
+- lib/zen-plaid/version.rb
+- spec/auth_spec.rb
+- spec/balance_spec.rb
+- spec/category_spec.rb
+- spec/connect_spec.rb
+- spec/entity_spec.rb
+- spec/institution_spec.rb
+- spec/spec_helper.rb
+- zen-plaid.gemspec
+homepage: https://github.com/seanmccann/zen-plaid
+licenses:
+- MIT
+metadata: {}
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 2.0.14
+signing_key: 
+specification_version: 4
+summary: Plaid Ruby Gem
+test_files: []
+has_rdoc: