wepay-api 0.1.0

data/lib/wepay/api/subscription.rb

@@ -0,0 +1,50 @@
+module Wepay
+  module Api
+    class Subscription < Base
+      ##
+      # @param params [Hash] See documentation below
+      # @return [Hashie::Mash]
+      # @docs [/subscription](https://www.wepay.com/developer/reference/subscription#lookup)
+      #
+      def show(params)
+        post 'subscription', params
+      end
+
+      ##
+      # @param params [Hash] See documentation below
+      # @return [Hashie::Mash]
+      # @docs [/subscription/find](https://www.wepay.com/developer/reference/subscription#find)
+      #
+      def find(params)
+        post 'subscription/find', params
+      end
+
+      ##
+      # @param params [Hash] See documentation below
+      # @return [Hashie::Mash]
+      # @docs [/subscription/create](https://www.wepay.com/developer/reference/subscription#create)
+      #
+      def create(params)
+        post 'subscription/create', params
+      end
+
+      ##
+      # @param params [Hash] See documentation below
+      # @return [Hashie::Mash]
+      # @docs [/subscription/cancel](https://www.wepay.com/developer/reference/subscription#cancel)
+      #
+      def cancel(params)
+        post 'subscription/cancel', params
+      end
+
+      ##
+      # @param params [Hash] See documentation below
+      # @return [Hashie::Mash]
+      # @docs [/subscription/modify](https://www.wepay.com/developer/reference/subscription#modify)
+      #
+      def modify(params)
+        post 'subscription/modify', params
+      end
+    end
+  end
+end

data/lib/wepay/api/subscription_plan.rb

@@ -0,0 +1,59 @@
+module Wepay
+  module Api
+    class SubscriptionPlan < Base
+      ##
+      # @param params [Hash] See documentation below
+      # @return [Hashie::Mash]
+      # @docs [/subscription_plan](https://www.wepay.com/developer/reference/subscription_plan#lookup)
+      #
+      def show(params)
+        post 'subscription_plan', params
+      end
+
+      ##
+      # @param params [Hash] See documentation below
+      # @return [Hashie::Mash]
+      # @docs [/subscription_plan/find](https://www.wepay.com/developer/reference/subscription_plan#find)
+      #
+      def find(params)
+        post 'subscription_plan/find', params
+      end
+
+      ##
+      # @param params [Hash] See documentation below
+      # @return [Hashie::Mash]
+      # @docs [/subscription_plan/create](https://www.wepay.com/developer/reference/subscription_plan#create)
+      #
+      def create(params)
+        post 'subscription_plan/create', params
+      end
+
+      ##
+      # @param params [Hash] See documentation below
+      # @return [Hashie::Mash]
+      # @docs [/subscription_plan/delete](https://www.wepay.com/developer/reference/subscription_plan#delete)
+      #
+      def delete(params)
+        post 'subscription_plan/delete', params
+      end
+
+      ##
+      # @param params [Hash] See documentation below
+      # @return [Hashie::Mash]
+      # @docs [/subscription_plan/get_button](https://www.wepay.com/developer/reference/subscription_plan#get_button)
+      #
+      def get_button(params)
+        post 'subscription_plan/get_button', params
+      end
+
+      ##
+      # @param params [Hash] See documentation below
+      # @return [Hashie::Mash]
+      # @docs [/subscription_plan/modify](https://www.wepay.com/developer/reference/subscription_plan#modify)
+      #
+      def modify(params)
+        post 'subscription_plan/modify', params
+      end
+    end
+  end
+end

data/lib/wepay/api/withdrawal.rb

@@ -0,0 +1,41 @@
+module Wepay
+  module Api
+    class Withdrawal < Base
+      ##
+      # @param params [Hash] See documentation below
+      # @return [Hashie::Mash]
+      # @docs [/withdrawal](https://www.wepay.com/developer/reference/withdrawal#lookup)
+      #
+      def show(params)
+        post 'withdrawal', params
+      end
+
+      ##
+      # @param params [Hash] See documentation below
+      # @return [Hashie::Mash]
+      # @docs [/withdrawal/find](https://www.wepay.com/developer/reference/withdrawal#find)
+      #
+      def find(params)
+        post 'withdrawal/find', params
+      end
+
+      ##
+      # @param params [Hash] See documentation below
+      # @return [Hashie::Mash]
+      # @docs [/withdrawal/create](https://www.wepay.com/developer/reference/withdrawal#create)
+      #
+      def create(params)
+        post 'withdrawal/create', params
+      end
+
+      ##
+      # @param params [Hash] See documentation below
+      # @return [Hashie::Mash]
+      # @docs [/withdrawal/modify](https://www.wepay.com/developer/reference/withdrawal#modify)
+      #
+      def modify(params)
+        post 'withdrawal/modify', params
+      end
+    end
+  end
+end

data/lib/wepay/client.rb

@@ -0,0 +1,63 @@
+require "faraday"
+require "faraday_middleware"
+
+module Wepay
+  class Client
+    DEFAULTS = {
+      open_timeout: 5,
+      timeout:      10
+    }
+
+    def initialize
+      @connection = Faraday.new(url, connection_options) do |builder|
+        # Request
+        builder.use Wepay::Middleware::CatchTimeout
+
+        yield builder if block_given?
+
+        # Response
+        builder.use FaradayMiddleware::Mashify
+        builder.use Wepay::Middleware::CheckStatus
+        builder.use FaradayMiddleware::ParseJson
+
+        builder.adapter :net_http
+      end
+    end
+
+    def get(*args, &block)
+      make_request(:get, *args, &block)
+    end
+
+    def post(*args, &block)
+      make_request(:post, *args, &block)
+    end
+
+    private
+
+    def connection_options
+      {
+        request: {
+          open_timeout:   open_timeout,
+          timeout:        timeout,
+        }
+      }
+    end
+
+    def url
+      raise NotImplementedError
+    end
+
+    def make_request(http_method, *args, &block)
+      response = @connection.send(http_method, *args, &block)
+      response.body
+    end
+
+    def open_timeout
+      Wepay.open_timeout || DEFAULTS[:open_timeout]
+    end
+
+    def timeout
+      Wepay.timeout || DEFAULTS[:timeout]
+    end
+  end
+end

data/lib/wepay/client/data.rb

@@ -0,0 +1,31 @@
+module Wepay
+  ##
+  # Client for query and manipulation of Wepay's data.
+  #
+  class Client::Data < Client
+    def initialize
+      super() do |builder|
+        # Request
+        builder.use FaradayMiddleware::EncodeJson
+      end
+    end
+
+    private
+    def url
+      Wepay.api_endpoint
+    end
+
+    def make_request(http_method, *args, &block)
+      params          = args[1]
+      access_token    = params.delete(:access_token) if params.is_a?(Hash)
+      access_token  ||= Wepay.access_token
+
+      response = @connection.send http_method, *args do |builder|
+        builder.headers['Authorization'] = "Bearer #{access_token}"
+        block.call(builder) if block_given?
+      end
+
+      response.body
+    end
+  end
+end

data/lib/wepay/client/token.rb

@@ -0,0 +1,30 @@
+module Wepay
+  ##
+  # Client for getting access token from Wepay's oauth endpoint.
+  #
+  class Client::Token < Client
+    def get_access_token(code, redirect_uri)
+      params = {
+        client_id:      client_id,
+        client_secret:  client_secret,
+        code:           code,
+        redirect_uri:   redirect_uri
+      }
+
+      get '', params
+    end
+
+    private
+    def url
+      Wepay.oauth_token_endpoint
+    end
+
+    def client_id
+      Wepay.client_id
+    end
+
+    def client_secret
+      Wepay.client_secret
+    end
+  end
+end

data/lib/wepay/configuration.rb

@@ -0,0 +1,34 @@
+module Wepay
+  module Configuration
+    attr_accessor :client_id, :client_secret, :access_token, :account_id, :scope, :using_stage
+
+    ##
+    # Time to wait for the connection to Wepay to open. After that
+    # {Wepay::TimeoutError} is thrown.
+    #
+    attr_accessor :open_timeout
+
+    ##
+    # Time to wait for the first block of response from Wepay. After that
+    # {Wepay::TimeoutError} is thrown.
+    #
+    attr_accessor :timeout
+
+    def configure
+      yield self
+      self
+    end
+
+    def api_endpoint
+      using_stage ? "https://stage.wepayapi.com/v2/" : "https://wepayapi.com/v2/"
+    end
+
+    def oauth_authorization_endpoint
+      using_stage ? "https://stage.wepay.com/v2/oauth2/authorize" : "https://www.wepay.com/v2/oauth2/authorize"
+    end
+
+    def oauth_token_endpoint
+      using_stage ? "https://stage.wepayapi.com/v2/oauth2/token" : "https://wepayapi.com/v2/oauth2/token"
+    end
+  end
+end

data/lib/wepay/error.rb

@@ -0,0 +1,28 @@
+module Wepay
+  class Error < StandardError
+  end
+
+  ##
+  # This error is raised when there is an error in the request.
+  #
+  class ApiError < Error
+    attr_reader :type, :code
+
+    def initialize(type, message, code)
+      super(message)
+      @type = type
+      @code = code
+    end
+
+    def message
+      "#{type} (#{code}): #{super}"
+    end
+  end
+
+  ##
+  # @see Wepay::Configuration#open_timeout
+  # @see Wepay::Configuration#timeout
+  #
+  class TimeoutError < Error
+  end
+end

data/lib/wepay/middleware.rb

@@ -0,0 +1,44 @@
+require "faraday"
+require "faraday_middleware/response_middleware"
+
+module Wepay
+  module Middleware
+    ##
+    # Translates `Faraday::Error::TimeoutError` into `Wepay::TimeoutError`.
+    #
+    # @raise Wepay::TimeoutError
+    #
+    class CatchTimeout
+      def initialize(app)
+        @app = app
+      end
+
+      def call(env)
+        begin
+          @app.call(env)
+        rescue Faraday::Error::TimeoutError
+          raise Wepay::TimeoutError
+        end
+      end
+    end
+
+    ##
+    # Checks for errors in responses from Wepay, in which case it raises a
+    # `Wepay::ApiError` which contains the code and the message found in the response.
+    #
+    # @raise Wepay::ApiError
+    #
+    class CheckStatus < Faraday::Response::Middleware
+      def on_complete(env)
+        response = env[:body]
+        if response.is_a?(Hash) && response["error"]
+          type    = response["error"]
+          message = response["error_description"]
+          code    = response["error_code"]
+
+          raise Wepay::ApiError.new(type, message, code)
+        end
+      end
+    end
+  end
+end

data/lib/wepay/oauth.rb

@@ -0,0 +1,32 @@
+require 'uri'
+
+module Wepay
+  module OAuth
+    ##
+    # @param redirect_uri [String] The uri the user will be redirected to after authorization. Must have the same domain as the application.
+    # @return [String] URL to redirect user to Wepay Authorization page
+    #
+    def authorization_url(redirect_uri)
+      url = URI.parse(Wepay.oauth_authorization_endpoint)
+
+      query = {
+        client_id:    Wepay.client_id,
+        scope:        Wepay.scope,
+        redirect_uri: redirect_uri
+      }
+
+      url.query = query.map { |k, v| "#{k}=#{v}" }.join("&")
+      url.to_s
+    end
+
+    ##
+    # @param code [String] The authorization code used to get the access token
+    # @param redirect_uri [String] The uri the user was redirected to after authorization. Must be the same as passed in /oauth2/authorize
+    # @return [Hashie::Mash]
+    #
+    def get_access_token(code, redirect_uri)
+      client = Wepay::Client::Token.new
+      client.get_access_token(code, redirect_uri)
+    end
+  end
+end

data/lib/wepay/version.rb

@@ -0,0 +1,3 @@
+module Wepay
+  VERSION = "0.1.0"
+end

data/spec/fixtures/vcr_cassettes/Wepay_Middleware/Wepay_Middleware_CheckStatus/raises_a_Wepay_ApiError_with_proper_error_type_message_and_code.yml

@@ -0,0 +1,35 @@
+---
+http_interactions:
+- request:
+    method: get
+    uri: https://stage.wepayapi.com/v2/null
+    body:
+      encoding: UTF-8
+      string: ''
+    headers:
+      User-Agent:
+      - Faraday v0.8.8
+      Authorization:
+      - Bearer access_token
+  response:
+    status:
+      code: 501
+      message:
+    headers:
+      server:
+      - nginx
+      date:
+      - Tue, 03 Dec 2013 09:34:30 GMT
+      content-type:
+      - application/json
+      transfer-encoding:
+      - chunked
+      connection:
+      - close
+    body:
+      encoding: UTF-8
+      string: '{"error":"invalid_request","error_description":"that is not a recognized
+        WePay API call","error_code":1001}'
+    http_version:
+  recorded_at: Tue, 03 Dec 2013 09:34:31 GMT
+recorded_with: VCR 2.8.0