didww_ups 0.1.0

data/.gitignore

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

data/.rspec

@@ -0,0 +1,3 @@
+--color
+--format documentation
+--require spec_helper

data/.travis.yml

@@ -0,0 +1,8 @@
+nguage: ruby
+rvm:
+  - 1.9.3
+  - 2.0.0
+  - 2.1.5
+  - 2.2.0
+  - jruby-19mode # JRuby in 1.9 mode
+  - rbx-2.2.10

data/Gemfile

@@ -0,0 +1,6 @@
+source 'https://rubygems.org'
+group :test do
+  gem 'coveralls', require: false # Test coverage website. Go to https://coveralls.io
+end
+# Specify your gem's dependencies in didww_ups.gemspec
+gemspec

data/LICENSE.txt

@@ -0,0 +1,22 @@
+Copyright (c) 2014 Igor Fedoronchuk
+
+MIT License
+
+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,34 @@
+# DidwwUps
+
+[![Build Status](http://img.shields.io/travis/didww/didww_ups.svg)](https://travis-ci.org/didww/didww_ups)
+[![Coverage Status](http://img.shields.io/coveralls/didww/didww_ups.svg)](https://coveralls.io/r/didww/didww_ups)
+[![Dependency Status](http://img.shields.io/gemnasium/didww/didww_ups.svg)](https://gemnasium.com/didww/didww_ups)
+[![Code Climate](http://img.shields.io/codeclimate/github/didww/didww_ups.svg)](https://codeclimate.com/github/didww/didww_ups)
+[![Gem Version](http://img.shields.io/gem/v/didww_ups.svg)](https://rubygems.org/gems/didww_ups)
+[![License](http://img.shields.io/:license-mit-blue.svg)](http://didww.mit-license.org)
+
+
+API Client for DIDWW UPS payment gateway
+
+## Installation
+
+Add this line to your application's Gemfile:
+
+    gem 'didww_ups'
+
+And then execute:
+
+    $ bundle
+
+Or install it yourself as:
+
+    $ gem install didww_ups
+
+
+## Contributing
+
+1. Fork it
+2. Create your feature branch (`git checkout -b my-new-feature`)
+3. Commit your changes (`git commit -am 'Add some feature'`)
+4. Push to the branch (`git push origin my-new-feature`)
+5. Create new Pull Request

data/Rakefile

@@ -0,0 +1,7 @@
+require "bundler/gem_tasks"
+require 'rspec/core/rake_task'
+
+RSpec::Core::RakeTask.new('spec')
+
+# If you want to make this the default task
+task :default => :spec

data/didww_ups.gemspec

@@ -0,0 +1,28 @@
+# coding: utf-8
+lib = File.expand_path('../lib', __FILE__)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+require 'didww_ups/version'
+
+Gem::Specification.new do |spec|
+  spec.name = "didww_ups"
+  spec.version = DidwwUps::VERSION
+  spec.authors = ["Igor Fedoronchuk"]
+  spec.email = ["igor.f@didww.com"]
+  spec.description = %q{API client library for DIDWW payment gateway (UPS)}
+  spec.summary = %q{API client library for DIDWW payment gateway (UPS)}
+  spec.homepage = "https://www.didww.com"
+  spec.license = "MIT"
+
+  spec.files = `git ls-files`.split($/)
+  spec.executables = spec.files.grep(%r{^bin/}) { |f| File.basename(f) }
+  spec.test_files = spec.files.grep(%r{^(test|spec|features)/})
+  spec.require_paths = ["lib"]
+
+  spec.add_dependency('activeresource-response', "~> 1.1.1")
+
+  spec.add_development_dependency "bundler", "~> 1.3"
+  spec.add_development_dependency "rake"
+  spec.add_development_dependency "rack"
+  spec.add_development_dependency "rspec", "~> 3"
+  spec.add_development_dependency "webmock"
+end

data/lib/didww_ups.rb

@@ -0,0 +1,118 @@
+require "didww_ups/version"
+require "logger"
+require "activeresource-response"
+require 'active_support/core_ext/module'
+
+module DidwwUps
+
+  SANDBOX_HOST = 'dev-payments.didww.com'
+
+  PRODUCTION_HOST = 'ups.didww.com'
+
+  mattr_accessor :service_host
+  mattr_accessor :config
+  mattr_accessor :logger
+  mattr_accessor :global_store
+  self.logger = ::Logger.new($stdout)
+
+   def self.configure(env)
+     @configuration_env = env
+     all_configs = load_configuration
+
+
+     if all_configs.any?
+       self.config = all_configs[env].symbolize_keys
+       if config[:ups_host].present?
+         self.service_host = config[:ups_host]
+       else
+         self.environment = config[:ups_env]
+       end
+       DidwwUps::Base.site = 'https://' + self.service_host
+       store = DidwwUps::Store.new(api_public_key: config[:store_public_key], api_secret_key: config[:store_secret_key])
+       DidwwUps.global_store = store
+       DidwwUps.store = store
+     end
+   end
+
+
+  def self.environment=(env)
+    env = env.to_sym
+    if [:live, :production].include? env
+      self.service_host = PRODUCTION_HOST
+    elsif [:test, :development, :sandbox].include? env
+      self.service_host = SANDBOX_HOST
+    else
+      raise ArgumentError.new("environment= #{env} accepts any of :live, :production, :test, :sandbox")
+    end
+  end
+
+  def self.current_store
+    Thread.current['didww_ups.active_store'] || DidwwUps.global_store
+  end
+
+  def self.profile
+    current_store.class.profile
+  end
+
+  #
+  def self.store=(store)
+    Thread.current['didww_ups.active_store'] = store
+  end
+
+  def self.with_configuration(new_env)
+    old_env = @configuration_env
+    begin
+      self.configure(new_env)
+      yield if block_given?
+    ensure
+      self.configure(old_env)
+    end
+  end
+
+  def self.with_store(new_store)
+    old_store = current_store
+    begin
+      self.store = new_store
+      yield if block_given?
+    ensure
+      self.store=old_store
+    end
+  end
+
+  def self.load_configuration
+    config_file = ENV['DIDWW_UPS_CONFIG_FILE'] || 'config/didww_ups.yml'
+    if File.exist?(config_file)
+      YAML.load_file(config_file)
+    else
+      raise StandardError.new("File #{config_file} doesn't exist") if   ENV['DIDWW_UPS_CONFIG_FILE'].present?
+      logger.warn "Can't find #{config_file}"
+      {}
+    end
+  end
+
+
+end
+
+
+require "didww_ups/connection"
+require "didww_ups/collection"
+require "didww_ups/base"
+require "didww_ups/store"
+require "didww_ups/credit_card"
+require "didww_ups/payment"
+require "didww_ups/refund"
+require "didww_ups/modules_base"
+require "didww_ups/modules_token"
+require "didww_ups/modules_payment"
+require "didww_ups/modules_refund"
+require 'yaml'
+if defined? Rails
+  require 'didww_ups/railtie'
+  require 'generators/config'
+else
+  DidwwUps.configure(ENV['RACK_ENV'])
+end
+
+
+
+

data/lib/didww_ups/base.rb

@@ -0,0 +1,43 @@
+# DidwwUps::Base class base class for API resources
+module DidwwUps
+  class Base < ActiveResource::Base
+
+    self.include_format_in_path = false
+    self.prefix = "/api/rest/v1/"
+    add_response_method :http
+
+    self.collection_parser = DidwwUps::Collection
+
+    delegate :[], to: :@attributes
+
+    def remote_errors_response
+      instance_variable_get(:@remote_errors).try(:response)
+    end
+
+    class << self
+
+      def site=(site)
+        site_uri = create_site_uri_from(site)
+        @site = site_uri
+        Thread.current['didww_ups.site'] = site_uri
+      end
+
+      def site
+        Thread.current['didww_ups.site'] || @site
+      end
+
+      #no headers
+      def headers
+        {}
+      end
+
+      #override with needed Connection class
+      def connection(refresh = false)
+          @connection = DidwwUps::Connection.new(DidwwUps::Base.site, format) if refresh || @connection.nil?
+          @connection.timeout = timeout if timeout
+          @connection.ssl_options = ssl_options if ssl_options
+          @connection
+      end
+    end
+  end
+end

data/lib/didww_ups/collection.rb

@@ -0,0 +1,17 @@
+# DidwwUps::Collection class with ability to handle :total_count, :offset_value, :limit_value
+module DidwwUps
+  class Collection < ActiveResource::Collection
+
+    attr_reader :total_count, :offset_value, :limit_value
+
+    def resource_class=(rc)
+      super rc
+      response = rc.connection.http_response
+      @total_count = response['X-Total-Count'].to_i
+      @offset_value = response['X-Offset-Value'].to_i
+      @limit_value = response['X-Limit-Value'].to_i
+    end
+  end
+
+
+end

data/lib/didww_ups/connection.rb

@@ -0,0 +1,14 @@
+# DidwwUps::Connection class with overridden authorization_header method
+module DidwwUps
+  class Connection < ActiveResource::Connection
+
+
+    # Adding Auth header
+    # Example
+    #   Token token=dGVzdC1wdWJsaWM0OmNlNTM0M2NiNTY1ZDM3ZmFiZjExZjhkODAzMTA4YmQwMTBkYzc2ZGE=, date=2012-12-03 14:55:57,type=v1
+    def authorization_header(http_method, uri)
+      {'Authorization' => 'Token token=' + DidwwUps.current_store.request_token(URI(uri).request_uri, http_method)}
+    end
+
+  end
+end

data/lib/didww_ups/credit_card.rb

@@ -0,0 +1,155 @@
+# DidwwUps::CreditCard class to handle Credit Cards
+#
+# Routes:
+#    GET        /api/rest/v1/credit_cards/:id/modules(.:format)
+#    GET        /api/rest/v1/credit_cards/:credit_card_id/properties(.:format)
+#    GET        /api/rest/v1/credit_cards/:credit_card_id/billing_address(.:format)
+#    GET        /api/rest/v1/credit_cards(.:format)
+#    GET        /api/rest/v1/credit_cards/:id(.:format)
+#    DELETE     /api/rest/v1/credit_cards/:id(.:format)
+#
+# Filter Examples
+#   credit_cards = DidwwUps::CreditCard.all(params: { page:1, per_page:10 , q:{token_ref_is_present: true,  cc_expired_gte: '2014-06-01'}})
+#   # => GET "/api/rest/v1/credit_cards?page=1&per_page=10&q%5Bcc_number_contains%5D=37"
+#
+# Possible filter keys for q hash
+#     * +created_at_gte+
+#     * +created_at_lte+
+#     * +cc_expired_gte+
+#     * +cc_expired_lte+
+#     * +store_id_eq+
+#     * +cc_number_contains+
+#     * +token_ref_contains+
+#     * +token_ref_is_present+  (true)
+#     * +token_ref_is_blank+    (true)
+#     * +customer_id_eq+
+#     * +customer_id_starts_with+
+#
+# Methods for pagination
+#   # credit_cards.total_count
+#   # credit_cards.limit_value
+#   # credit_cards.offset_value
+#
+# Find by token example
+#  DidwwUps::CreditCard.find("ToTXNnMAUika3o0sS0sqMw")
+#  # => GET "/api/rest/v1/credit_cards/ToTXNnMAUika3o0sS0sqMw"
+#
+# Remove example
+#   DidwwUps::CreditCard.new({token_ref:"ToTXNnMAUika3o0sS0sqMw"}, true).destroy
+#   # => DELETE "/api/rest/v1/credit_cards/ToTXNnMAUika3o0sS0sqMw"
+#
+#
+module DidwwUps
+  class CreditCard < DidwwUps::Base
+
+    self.prefix = "/api/rest/v1/"
+
+    validate do
+      unless persisted? # was initialized by DidwwUps::Store#retrieve_credit_card
+        self.errors[:base] << "Invalid callback hash" unless self["secure_hash"].to_s == valid_callback_hash
+        self.errors[:base] << self["error"] if self["error"].present?
+      end
+    end
+
+    schema do
+      attribute :credit_card_number, :string
+      attribute :credit_card_type, :string
+      attribute :credit_card_expired, :string
+      attribute :unique_id, :string
+      attribute :store_id, :integer
+      attribute :token_ref, :string
+      attribute :updated_at, :datetime
+      attribute :customer_id, :string
+      attribute :card_id, :string
+
+    end
+
+
+    def updated_at
+      Time.parse(self[:updated_at])
+    end
+
+    def initialize(attributes = {}, persisted = false)
+      super attributes, persisted #check attributes keys
+      if self['success'].to_i == 1
+        @attributes['token_ref'] = self['result']
+      else
+        @attributes['error'] = self['result']
+      end
+    end
+
+    # Properties
+    #  DidwwUps::CreditCard.new({:token_ref => "LQ8IQ4Av6hM3tgX_WLJp9w"}, true).get(:properties)
+    #  DidwwUps::CreditCard.find("LQ8IQ4Av6hM3tgX_WLJp9w").properties
+    #  # => GET "/api/rest/v1/credit_cards/LQ8IQ4Av6hM3tgX_WLJp9w/properties"
+    #  # =>  {"bin"=>"510510", "bank"=>"BANK OF HAWAII", "country"=>"UNITED STATES", "card_brand"=>"MASTERCARD", "card_type"=>"CREDIT", "bank_phone"=>"1-888-643-3888 OR 1-888-643-9888", "customer_ip"=>"195.138.65.189", "fraud_level"=>nil}
+    #
+    def properties
+      attribute_or_get! :properties
+    end
+
+    # Payment Modules
+    #  DidwwUps::CreditCard.find("LQ8IQ4Av6hM3tgX_WLJp9w").get(:modules)
+    #  DidwwUps::CreditCard.find("LQ8IQ4Av6hM3tgX_WLJp9w").modules
+    #  # => GET "/api/rest/v1/credit_cards/LQ8IQ4Av6hM3tgX_WLJp9w/modules"
+    #  # => ["WorldnetTps"]
+    def modules
+      self[:modules] ||= self[:modules_tokens].present? ?
+          self[:modules_tokens].collect { |t| t.module_name } :
+          get(:modules)
+    end
+
+    # Billing Address
+    #  DidwwUps::CreditCard.new({:token_ref => "LQ8IQ4Av6hM3tgX_WLJp9w"}, true).get(:billing_address)
+    #  DidwwUps::CreditCard.find("LQ8IQ4Av6hM3tgX_WLJp9w").billing_address
+    #  # => GET "/api/rest/v1/credit_cards/LQ8IQ4Av6hM3tgX_WLJp9w/modules"
+    #  #  => "{\"bill_first_name\":\"FirstName\",\"bill_last_name\":\"SecondName\",\"city\":\"Odessa\",\"company\":\"\",\"country\":\"UA\",\"created_at\":\"2014-03-27T12:29:43Z\",\"email\":\"olga@gmail.com\",\"fax_number\":\"\",\"first_address_line\":\"Address line1\",\"id\":1070,\"phone_number\":\"3806600000000\",\"second_address_line\":\"Address line2\",\"state\":null,\"updated_at\":\"2014-03-27T12:29:43Z\",\"zip\":\"65007\",\"avs_result\":null}"
+    def billing_address
+      attribute_or_get! :billing_address
+    end
+
+    # create Payment ,
+    # * *See* : DidwwUps::Payment#create
+    # * *Returns* :  DidwwUps::Payment
+    def create_payment(params={})
+      DidwwUps::Payment.create(params.merge({token_ref: self['token_ref']}))
+    end
+
+    def to_param
+      token_ref
+    end
+
+    alias :id :to_param
+
+    def brand
+      self[:credit_card_type]
+    end
+
+    def display_name
+      "#{self.brand} #{self[:credit_card_number]}"
+    end
+
+    def expired_this_month?
+      self[:credit_card_expired] == DateTime.now.utc.strftime("%Y-%d")
+    end
+
+    def expired?
+      self[:credit_card_expired] < DateTime.now.utc.strftime("%Y-%d")
+    end
+
+    protected
+    def valid_callback_hash
+      Digest::SHA1.hexdigest "#{self['result']}#{self['success']}#{self['customer_id']}#{self['card_id']}#{self['date_time']}#{DidwwUps.current_store['api_secret_key']}"
+    end
+
+    def attribute_or_get!(name)
+      if self.attributes.has_key? name
+        return {} if  self[name].nil?
+        self[name].is_a?(Hash) ? self[name] : self[name].try(:attributes)
+      else
+        self[name] = get(name)
+      end
+    end
+
+  end
+end