zoho_hub 0.1.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: ece1e0545ceee8dd7c4f64e7d23ec915ee335d57e137e2548fef79a77b1f0f76
+  data.tar.gz: d41629b8939a7f361406d678a4844770f65dcbd820c5eb996ef235f44f290c25
+SHA512:
+  metadata.gz: 3d1449cac85281a94053e38fd6d456bd1530d08cffd304a6d1673d5b587d1488e818b5a040611a06da4fa23feb9d7e350d1941f01a44bed975cf066b562a969b
+  data.tar.gz: 5eb0c0dc4b51157e52969dbaf76c3b654db9a8cda778cd3e96f7cbfe49d5aa0b9df469beac69cadebaa33961a84eaa2e45a35938ae2c0eb517c9641ed93c6b3f

data/.gitignore

@@ -0,0 +1,12 @@
+/.bundle/
+/.env
+/.yardoc
+/_yardoc/
+/coverage/
+/doc/
+/pkg/
+/spec/reports/
+/tmp/
+
+# rspec failure tracking
+.rspec_status

data/.rspec

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

data/.rubocop.yml

@@ -0,0 +1,39 @@
+require: rubocop-rspec
+
+AllCops:
+  TargetRubyVersion: 2.5.1
+
+# Don't force top level comments in every class
+Style/Documentation:
+  Enabled: false
+
+# A good line length is 100 chars
+Metrics/LineLength:
+  Max: 100
+  AllowURI: true
+
+Metrics/BlockLength:
+  Enabled: false
+
+Metrics/ClassLength:
+  Max: 300
+
+Metrics/MethodLength:
+  Max: 20
+
+Metrics/AbcSize:
+  Max: 30
+
+RSpec/ExampleLength:
+  Enabled: false
+
+RSpec/MultipleExpectations:
+  Max: 10
+
+RSpec/RepeatedExample:
+  Exclude:
+    - 'spec/policies/**/*'
+
+RSpec/RepeatedDescription:
+  Exclude:
+    - 'spec/policies/**/*'

data/.ruby-version

@@ -0,0 +1 @@
+2.5.1

data/.travis.yml

@@ -0,0 +1,5 @@
+sudo: false
+language: ruby
+rvm:
+  - 2.5.0
+before_install: gem install bundler -v 1.16.1

data/Gemfile

@@ -0,0 +1,8 @@
+# frozen_string_literal: true
+
+source 'https://rubygems.org'
+
+git_source(:github) { |repo_name| "https://github.com/#{repo_name}" }
+
+# Specify your gem's dependencies in zoho_hub.gemspec
+gemspec

data/Gemfile.lock

@@ -0,0 +1,102 @@
+PATH
+  remote: .
+  specs:
+    zoho_hub (0.1.0)
+      activesupport (~> 5.2)
+      addressable (~> 2.5)
+      faraday (~> 0.15)
+      faraday_middleware (~> 0.12)
+      multi_json (~> 1.13)
+
+GEM
+  remote: https://rubygems.org/
+  specs:
+    activesupport (5.2.0)
+      concurrent-ruby (~> 1.0, >= 1.0.2)
+      i18n (>= 0.7, < 2)
+      minitest (~> 5.1)
+      tzinfo (~> 1.1)
+    addressable (2.5.2)
+      public_suffix (>= 2.0.2, < 4.0)
+    ast (2.4.0)
+    byebug (10.0.2)
+    coderay (1.1.2)
+    concurrent-ruby (1.0.5)
+    diff-lcs (1.3)
+    docile (1.3.1)
+    dotenv (2.5.0)
+    faraday (0.15.2)
+      multipart-post (>= 1.2, < 3)
+    faraday_middleware (0.12.2)
+      faraday (>= 0.7.4, < 1.0)
+    i18n (1.0.1)
+      concurrent-ruby (~> 1.0)
+    jaro_winkler (1.5.1)
+    json (2.1.0)
+    method_source (0.9.0)
+    minitest (5.11.3)
+    multi_json (1.13.1)
+    multipart-post (2.0.0)
+    parallel (1.12.1)
+    parser (2.5.1.2)
+      ast (~> 2.4.0)
+    powerpack (0.1.2)
+    pry (0.11.3)
+      coderay (~> 1.1.0)
+      method_source (~> 0.9.0)
+    pry-byebug (3.6.0)
+      byebug (~> 10.0)
+      pry (~> 0.10)
+    public_suffix (3.0.2)
+    rainbow (3.0.0)
+    rake (10.5.0)
+    rspec (3.7.0)
+      rspec-core (~> 3.7.0)
+      rspec-expectations (~> 3.7.0)
+      rspec-mocks (~> 3.7.0)
+    rspec-core (3.7.1)
+      rspec-support (~> 3.7.0)
+    rspec-expectations (3.7.0)
+      diff-lcs (>= 1.2.0, < 2.0)
+      rspec-support (~> 3.7.0)
+    rspec-mocks (3.7.0)
+      diff-lcs (>= 1.2.0, < 2.0)
+      rspec-support (~> 3.7.0)
+    rspec-support (3.7.1)
+    rubocop (0.58.1)
+      jaro_winkler (~> 1.5.1)
+      parallel (~> 1.10)
+      parser (>= 2.5, != 2.5.1.1)
+      powerpack (~> 0.1)
+      rainbow (>= 2.2.2, < 4.0)
+      ruby-progressbar (~> 1.7)
+      unicode-display_width (~> 1.0, >= 1.0.1)
+    rubocop-rspec (1.27.0)
+      rubocop (>= 0.56.0)
+    ruby-progressbar (1.9.0)
+    simplecov (0.16.1)
+      docile (~> 1.1)
+      json (>= 1.8, < 3)
+      simplecov-html (~> 0.10.0)
+    simplecov-html (0.10.2)
+    thread_safe (0.3.6)
+    tzinfo (1.2.5)
+      thread_safe (~> 0.1)
+    unicode-display_width (1.4.0)
+
+PLATFORMS
+  ruby
+
+DEPENDENCIES
+  bundler (~> 1.16)
+  dotenv (~> 2.5)
+  pry-byebug (~> 3.6)
+  rake (~> 10.0)
+  rspec (~> 3.0)
+  rubocop (~> 0.58)
+  rubocop-rspec (~> 1.27)
+  simplecov (~> 0.16)
+  zoho_hub!
+
+BUNDLED WITH
+   1.16.2

data/LICENSE.txt

@@ -0,0 +1,21 @@
+The MIT License (MIT)
+
+Copyright (c) 2018 Ricardo Otero
+
+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,42 @@
+# ZohoHub
+
+https://www.zoho.com/crm/help/api-diff/
+
+## Installation
+
+Add this line to your application's Gemfile:
+
+```ruby
+gem 'zoho_hub'
+```
+
+And then execute:
+
+    $ bundle
+
+Or install it yourself as:
+
+    $ gem install zoho_hub
+
+## Usage
+
+TODO: Write usage instructions here
+
+## Development
+
+After checking out the repo, run `bin/setup` to install dependencies. Then, run `rake spec` to run
+the tests. You can also run `bin/console` for an interactive prompt that will allow you to
+experiment.
+
+To install this gem onto your local machine, run `bundle exec rake install`. To release a new
+version, update the version number in `version.rb`, and then run `bundle exec rake release`, which
+will create a git tag for the version, push git commits and tags, and push the `.gem` file
+to [rubygems.org](https://rubygems.org).
+
+## Contributing
+
+Bug reports and pull requests are welcome on GitHub at https://github.com/rikas/zoho_hub.
+
+## License
+
+The gem is available as open source under the terms of the [MIT License](https://opensource.org/licenses/MIT).

data/Rakefile

@@ -0,0 +1,8 @@
+# frozen_string_literal: true
+
+require 'bundler/gem_tasks'
+require 'rspec/core/rake_task'
+
+RSpec::Core::RakeTask.new(:spec)
+
+task default: :spec

data/bin/console

@@ -0,0 +1,23 @@
+#!/usr/bin/env ruby
+# frozen_string_literal: true
+
+require 'bundler/setup'
+require 'zoho_hub'
+
+require 'dotenv'
+Dotenv.load
+
+ZohoHub.configure do |config|
+  config.client_id = ENV['ZOHO_CLIENT_ID']
+  config.secret = ENV['ZOHO_SECRET']
+  config.redirect_uri = ENV['ZOHO_OAUTH_REDIRECT_URL']
+  # config.debug = true
+end
+
+token_params = ZohoHub::Auth.refresh_token(ENV['ZOHO_REFRESH_TOKEN'])
+ZohoHub.setup_connection(token_params)
+
+include ZohoHub # rubocop:disable Style/MixinUsage
+
+require 'pry'
+Pry.start

data/bin/setup

@@ -0,0 +1,8 @@
+#!/usr/bin/env bash
+set -euo pipefail
+IFS=$'\n\t'
+set -vx
+
+bundle install
+
+# Do any other automated setup that you need to do here

data/lib/zoho_hub/auth.rb

@@ -0,0 +1,118 @@
+# frozen_string_literal: true
+
+require 'multi_json'
+require 'faraday'
+require 'faraday_middleware'
+require 'addressable'
+
+module ZohoHub
+  class Auth
+    extend Forwardable
+
+    TOKEN_PATH = '/oauth/v2/token'
+    AUTH_PATH = '/oauth/v2/auth'
+
+    DEFAULT_SCOPES = %w[
+      ZohoCRM.modules.custom.all
+      ZohoCRM.settings.all
+      ZohoCRM.modules.contacts.all
+      ZohoCRM.modules.all
+    ].freeze
+
+    DEFAULT_ACCESS_TYPE = 'offline'
+
+    def_delegators :@configuration, :redirect_uri, :client_id, :secret
+
+    def initialize(access_type: nil, scopes: nil)
+      @configuration = ZohoHub.configuration
+      @access_type = access_type || ZohoHub.configuration.access_type
+      @scopes = scopes || DEFAULT_SCOPES
+    end
+
+    def token_full_uri
+      Addressable::URI.join(@configuration.base_url, TOKEN_PATH)
+    end
+
+    def auth_full_uri
+      Addressable::URI.join(@configuration.base_url, AUTH_PATH)
+    end
+
+    def auth_url
+      uri = auth_full_uri
+
+      uri.query_values = {
+        client_id: client_id,
+        scope: @scopes.join(','),
+        access_type: @access_type,
+        redirect_uri: redirect_uri,
+        response_type: 'code'
+      }
+
+      Addressable::URI.unencode(uri.to_s)
+    end
+
+    def token_url(grant_token)
+      uri = token_full_uri
+
+      uri.query_values = {
+        client_id: client_id,
+        client_secret: secret,
+        code: grant_token,
+        redirect_uri: redirect_uri,
+        grant_type: 'authorization_code'
+      }
+
+      Addressable::URI.unencode(uri.to_s)
+    end
+
+    def refresh_url(refresh_token)
+      uri = token_full_uri
+
+      uri.query_values = {
+        client_id: client_id,
+        client_secret: secret,
+        refresh_token: refresh_token,
+        grant_type: 'refresh_token'
+      }
+
+      Addressable::URI.unencode(uri.to_s)
+    end
+
+    def self.refresh_token(refresh_token)
+      new.refresh_token(refresh_token)
+    end
+
+    def refresh_token(refresh_token)
+      result = Faraday.post(refresh_url(refresh_token))
+
+      json = parse(result.body)
+      json.merge(refresh_token: refresh_token)
+    end
+
+    def revoke_refresh_token(refresh_token)
+      uri = token_full_uri
+
+      uri.query_values = { token: refresh_token }
+
+      url = Addressable::URI.unencode(uri.to_s)
+
+      result = Faraday.post(url)
+
+      parse(result.body)
+    end
+
+    def self.get_token(grant_token)
+      new.get_token(grant_token)
+    end
+
+    def get_token(grant_token)
+      result = Faraday.post(token_url(grant_token))
+
+      parse(result.body)
+    end
+
+    def parse(body)
+      MultiJson.load(body, symbolize_keys: true)
+    end
+  end
+end

data/lib/zoho_hub/configuration.rb

@@ -0,0 +1,22 @@
+# frozen_string_literal: true
+
+module ZohoHub
+  class Configuration
+    attr_accessor :client_id, :secret, :redirect_uri, :base_url, :access_type
+    attr_writer :debug
+
+    DEFAULT_BASE_URL = 'https://accounts.zoho.eu'
+
+    def initialize
+      @client_id = ''
+      @secret = ''
+      @redirect_uri = ''
+      @base_url = DEFAULT_BASE_URL
+      @access_type = Auth::DEFAULT_ACCESS_TYPE
+    end
+
+    def debug?
+      @debug
+    end
+  end
+end

data/lib/zoho_hub/connection.rb

@@ -0,0 +1,78 @@
+# frozen_string_literal: true
+
+require 'faraday'
+require 'faraday_middleware'
+
+require 'zoho_hub/response'
+
+module ZohoHub
+  class Connection
+    attr_accessor :debug, :access_token, :expires_in, :api_domain, :refresh_token
+
+    BASE_PATH = '/crm/v2/'
+
+    def initialize(access_token:, expires_in:, api_domain:, refresh_token: nil)
+      @access_token = access_token
+      @expires_in = expires_in
+      @api_domain = api_domain
+      @refresh_token ||= refresh_token # do not overwrite if it's already set
+    end
+
+    def get(path, params = {})
+      response = with_refresh { adapter.get(path, params) }
+      response.body
+    end
+
+    def post(path, params = {})
+      response = with_refresh { adapter.post(path, params) }
+      response.body
+    end
+
+    def access_token?
+      @access_token.present?
+    end
+
+    def refresh_token?
+      @refresh_token.present?
+    end
+
+    private
+
+    def with_refresh
+      http_response = yield
+
+      response = Response.new(http_response.body)
+
+      # Try to refresh the token and try again
+      if response.invalid_token? && refresh_token?
+        puts 'Refreshing outdated token...'
+        params = ZohoHub::Auth.refresh_token(@refresh_token)
+
+        @access_token = params[:access_token]
+
+        http_response = yield
+      end
+
+      http_response
+    end
+
+    def base_url
+      URI.join(@api_domain, BASE_PATH).to_s
+    end
+
+    # The authorization header that must be added to every request for authorized requests.
+    def authorization_header
+      { 'Authorization' => "Zoho-oauthtoken #{@access_token}" }
+    end
+
+    def adapter
+      Faraday.new(url: base_url) do |conn|
+        conn.headers = authorization_header if access_token?
+        conn.use FaradayMiddleware::ParseJson
+        conn.response :json, parser_options: { symbolize_names: true }
+        conn.response :logger if ZohoHub.configuration.debug?
+        conn.adapter Faraday.default_adapter
+      end
+    end
+  end
+end

data/lib/zoho_hub/errors.rb

@@ -0,0 +1,12 @@
+# frozen_string_literal: true
+
+module ZohoHub
+  class RecordNotFound < StandardError
+  end
+
+  class RecordInvalid < StandardError
+  end
+
+  class InvalidTokenError < StandardError
+  end
+end

data/lib/zoho_hub/records/account.rb

@@ -0,0 +1,43 @@
+# frozen_string_literal: true
+
+require 'zoho_hub/records/base_record'
+
+module ZohoHub
+  class Account < BaseRecord
+    attributes :id, :name, :territories, :company_number, :employee_count, :company_type, :industry
+    attributes :billing_city, :billing_code, :billing_country, :billing_street, :billing_state
+    attributes :account_type
+
+    # This is the ID to be used when the borrower has no organisation (unlikely) or belongs to
+    # multiple organisations.
+    CATCH_ALL_ID = '78265000000826001'
+
+    DEFAULTS = {
+      account_type: 'Prospect'
+    }.freeze
+
+    # The translation from attribute name to the JSON field on Zoho. The default behaviour will be
+    # to Camel_Case the attribute so on this list we should only have exceptions to this rule.
+    attribute_translation(
+      id: :id,
+      name: :Account_Name,
+      company_number: :company_reg_id,
+      employee_count: :No_of_Employees,
+      industry: :Industry_Category
+    )
+
+    def initialize(params)
+      attributes.each do |attr|
+        zoho_key = attr_to_zoho_key(attr)
+
+        send("#{attr}=", params[zoho_key] || params[attr] || DEFAULTS[attr])
+      end
+    end
+
+    def to_params
+      params = super
+
+      params
+    end
+  end
+end

data/lib/zoho_hub/records/base_record.rb

@@ -0,0 +1,162 @@
+# frozen_string_literal: true
+
+require 'zoho_hub/response'
+
+module ZohoHub
+  class BaseRecord
+    class << self
+      def record_name(name = nil)
+        @record_name = name if name
+        @record_name ||= to_s.demodulize.pluralize
+        @record_name
+      end
+
+      def list_name(name = nil)
+        @list_name = name if name
+        @list_name ||= to_s.demodulize.pluralize.downcase
+        @list_name
+      end
+
+      def attributes(*attributes)
+        @attributes ||= []
+
+        return @attributes unless attributes
+
+        attr_accessor(*attributes)
+
+        @attributes += attributes
+      end
+
+      def attribute_translation(translation = nil)
+        @attribute_translation ||= {}
+
+        return @attribute_translation unless translation
+
+        @attribute_translation = translation
+      end
+
+      def zoho_key_translation
+        @attribute_translation.to_a.map(&:rotate).to_h
+      end
+
+      def find(id)
+        body = get(File.join(record_name, id.to_s))
+        response = build_response(body)
+
+        if response.empty?
+          raise RecordNotFound, "Couldn't find #{record_name.singularize} with 'id'=#{id}"
+        end
+
+        new(response.data)
+      end
+
+      def where(params)
+        response = get(list_name, params)
+        data = response[:data]
+
+        data.map { |info| new(info) }
+      end
+
+      def find_by(params)
+        records = where(params)
+        records.first
+      end
+
+      def create(params)
+        new(params).save
+      end
+
+      def all(options = {})
+        options[:page] ||= 1
+        options[:per_page] ||= 200
+
+        body = get(list_name, options)
+        response = build_response(body)
+
+        data = response.nil? ? [] : response.data
+
+        data.map { |info| new(info) }
+      end
+
+      def get(path, params = {})
+        ZohoHub.connection.get(path, params)
+      end
+
+      def post(path, params = {})
+        puts "POSTING TO `#{path}` -- #{params}"
+
+        ZohoHub.connection.post(path, params.to_json)
+      end
+
+      def exists?(id)
+        !find(id).nil?
+      rescue RecordNotFound
+        false
+      end
+
+      alias exist? exists?
+
+      def build_response(body)
+        response = Response.new(body)
+
+        raise InvalidTokenError, response.msg if response.invalid_token?
+        raise RecordInvalid, response.msg if response.invalid_data?
+
+        response
+      end
+    end
+
+    def attributes
+      self.class.attributes
+    end
+
+    def get(path, params = {})
+      self.class.get(path, params)
+    end
+
+    def post(path, params = {})
+      self.class.post(path, params)
+    end
+
+    def save
+      body = post(self.class.record_name, data: [to_params])
+      response = build_response(body)
+
+      response.data.dig(:details, :id)
+    end
+
+    def to_params
+      params = {}
+
+      attributes.each do |attr|
+        key = attr_to_zoho_key(attr)
+
+        params[key] = send(attr)
+      end
+
+      params
+    end
+
+    def build_response(body)
+      self.class.build_response(body)
+    end
+
+    private
+
+    def attr_to_zoho_key(attr_name)
+      translations = self.class.attribute_translation
+
+      return translations[attr_name.to_sym] if translations.key?(attr_name.to_sym)
+
+      attr_name.to_s.split('_').map(&:capitalize).join('_').to_sym
+    end
+
+    def zoho_key_to_attr(zoho_key)
+      translations = self.class.zoho_key_translation
+
+      return translations[zoho_key.to_sym] if translations.key?(zoho_key.to_sym)
+
+      zoho_key.to_sym
+    end
+  end
+end

data/lib/zoho_hub/records/campaign.rb

@@ -0,0 +1,14 @@
+# frozen_string_literal: true
+
+require 'zoho_hub/records/base_record'
+
+module ZohoHub
+  class Campaign < BaseRecord
+    attributes :id, :name
+
+    def initialize(params)
+      @id = params[:id]
+      @name = params[:Campaign_Name]
+    end
+  end
+end

data/lib/zoho_hub/records/contact.rb

@@ -0,0 +1,45 @@
+# frozen_string_literal: true
+
+require 'zoho_hub/records/base_record'
+
+module ZohoHub
+  class Contact < BaseRecord
+    attributes :id, :email, :salutation, :first_name, :mobile, :role, :last_name
+    attributes :account_id, :owner_id, :campaign_id, :status, :campaign_detail
+
+    attribute_translation(
+      id: :id,
+      role: :platform_cont_type,
+      status: :platform_cont_status,
+      use_proceeds: :use_proceeds
+    )
+
+    DEFAULTS = {
+      status: 'active',
+      campaign_detail: 'Web Sign Up'
+    }.freeze
+
+    def initialize(params)
+      attributes.each do |attr|
+        zoho_key = attr_to_zoho_key(attr)
+
+        send("#{attr}=", params[zoho_key] || params[attr] || DEFAULTS[attr])
+      end
+
+      # Setup values as they come from the Zoho API if needed
+      @account_id ||= params.dig(:Account_Name, :id)
+      @owner_id ||= params.dig(:Owner, :id)
+      @campaign_id ||= params.dig(:Campaign_Lookup, :id)
+    end
+
+    def to_params
+      params = super
+
+      params[:Account_Name] = { id: @account_id } if @account_id
+      params[:Owner] = { id: @owner_id } if @owner_id
+      params[:Campaign_Lookup] = { id: @campaign_id } if @campaign_id
+
+      params
+    end
+  end
+end

data/lib/zoho_hub/records/potential.rb

@@ -0,0 +1,54 @@
+# frozen_string_literal: true
+
+require 'zoho_hub/records/base_record'
+
+module ZohoHub
+  class Potential < BaseRecord
+    list_name 'Potentials'
+
+    attributes :id, :code, :deal_name, :amount, :description, :stage
+    attributes :company_age_years, :company_age_months, :term, :use_proceeds, :proceeds_detail
+    attributes :currency, :territory, :employee_count, :turnover, :industry, :region
+    attributes :review_outcome, :first_created, :last_modified, :preferred_term
+    attributes :campaign_id, :account_id, :contact_id, :campaign_detail
+
+    DEFAULTS = {
+      currency: 'GBP',
+      territory: 'UK all',
+      campaign_detail: 'Web Sign Up'
+    }.freeze
+
+    # The translation from attribute name to the JSON field on Zoho. The default behaviour will be
+    # to Camel_Case the attribute so on this list we should only have exceptions to this rule.
+    attribute_translation(
+      id: :id,
+      code: :Project_Ref_No,
+      description: :Project_description,
+      employee_count: :Number_of_Employees,
+      use_proceeds: :use_proceeds
+    )
+
+    def initialize(params)
+      attributes.each do |attr|
+        zoho_key = attr_to_zoho_key(attr)
+
+        send("#{attr}=", params[zoho_key] || params[attr] || DEFAULTS[attr])
+      end
+
+      # Setup values as they come from the Zoho API if needed
+      @account_id ||= params.dig(:Account_Name, :id)
+      @contact_id ||= params.dig(:Contact_Name, :id)
+      @campaign_id ||= params.dig(:Campaign_Source, :id)
+    end
+
+    def to_params
+      params = super
+
+      params[:Campaign_Source] = { id: @campaign_id } if @campaign_id
+      params[:Account_Name] = { id: @account_id } if @account_id
+      params[:Contact_Name] = { id: @contact_id } if @contact_id
+
+      params
+    end
+  end
+end

data/lib/zoho_hub/response.rb

@@ -0,0 +1,44 @@
+# frozen_string_literal: true
+
+module ZohoHub
+  class Response
+    def initialize(params)
+      @params = params || {}
+    end
+
+    def invalid_data?
+      data[:code] == 'INVALID_DATA'
+    end
+
+    # {:code=>"INVALID_TOKEN", :details=>{}, :message=>"invalid oauth token", :status=>"error"}
+    def invalid_token?
+      data[:code] == 'INVALID_TOKEN'
+    end
+
+    def empty?
+      @params.empty?
+    end
+
+    def data
+      data = @params[:data] if @params.dig(:data)
+      data ||= @params
+
+      return data.first if data.is_a?(Array) && data.size == 1
+
+      data
+    end
+
+    def msg
+      msg = data[:message]
+
+      if data.dig(:details, :expected_data_type)
+        expected = data.dig(:details, :expected_data_type)
+        field = data.dig(:details, :api_name)
+
+        msg << ", expected #{expected} for '#{field}'"
+      end
+
+      msg
+    end
+  end
+end

data/lib/zoho_hub/version.rb

@@ -0,0 +1,5 @@
+# frozen_string_literal: true
+
+module ZohoHub
+  VERSION = '0.1.0'
+end

data/lib/zoho_hub.rb

@@ -0,0 +1,50 @@
+# frozen_string_literal: true
+
+require 'active_support/core_ext/object/blank'
+require 'active_support/core_ext/string/inflections'
+
+require 'zoho_hub/version'
+require 'zoho_hub/auth'
+require 'zoho_hub/configuration'
+require 'zoho_hub/connection'
+require 'zoho_hub/errors'
+require 'zoho_hub/records/contact'
+require 'zoho_hub/records/potential'
+require 'zoho_hub/records/campaign'
+require 'zoho_hub/records/account'
+
+module ZohoHub
+  module_function
+
+  def configuration
+    @configuration ||= Configuration.new
+  end
+
+  def connection
+    @connection
+  end
+
+  def setup_connection(params = {})
+    raise "ERROR: #{params[:error]}" if params[:error]
+
+    connection_params = params.slice(:access_token, :expires_in, :api_domain, :refresh_token)
+
+    @connection = Connection.new(connection_params)
+  end
+
+  def refresh_token?
+    return false unless connection.present?
+
+    connection.refresh_token?
+  end
+
+  def access_token?
+    return false unless connection.present?
+
+    connection.access_token?
+  end
+
+  def configure
+    yield(configuration)
+  end
+end

data/zoho_hub.gemspec

@@ -0,0 +1,40 @@
+# frozen_string_literal: true
+
+lib = File.expand_path('lib', __dir__)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+
+require 'zoho_hub/version'
+
+Gem::Specification.new do |spec|
+  spec.name          = 'zoho_hub'
+  spec.version       = ZohoHub::VERSION
+  spec.authors       = ['Ricardo Otero']
+  spec.email         = ['oterosantos@gmail.com']
+
+  spec.summary       = 'Simple gem to connect to Zoho CRM API V2'
+  spec.description   = spec.summary
+  spec.homepage      = 'https://github.com/rikas/zoho_hub'
+  spec.license       = 'MIT'
+
+  spec.files         = `git ls-files -z`.split("\x0").reject do |f|
+    f.match(%r{^(test|spec|features)/})
+  end
+  spec.bindir        = 'exe'
+  spec.executables   = spec.files.grep(%r{^exe/}) { |f| File.basename(f) }
+  spec.require_paths = ['lib']
+
+  spec.add_dependency 'activesupport', '~> 5.2'
+  spec.add_dependency 'addressable', '~> 2.5'
+  spec.add_dependency 'faraday', '~> 0.15'
+  spec.add_dependency 'faraday_middleware', '~> 0.12'
+  spec.add_dependency 'multi_json', '~> 1.13'
+
+  spec.add_development_dependency 'bundler', '~> 1.16'
+  spec.add_development_dependency 'dotenv', '~> 2.5'
+  spec.add_development_dependency 'pry-byebug', '~> 3.6'
+  spec.add_development_dependency 'rake', '~> 10.0'
+  spec.add_development_dependency 'rspec', '~> 3.0'
+  spec.add_development_dependency 'rubocop', '~> 0.58'
+  spec.add_development_dependency 'rubocop-rspec', '~> 1.27'
+  spec.add_development_dependency 'simplecov', '~> 0.16'
+end

metadata

@@ -0,0 +1,251 @@
+--- !ruby/object:Gem::Specification
+name: zoho_hub
+version: !ruby/object:Gem::Version
+  version: 0.1.0
+platform: ruby
+authors:
+- Ricardo Otero
+autorequire: 
+bindir: exe
+cert_chain: []
+date: 2018-07-20 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: activesupport
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '5.2'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '5.2'
+- !ruby/object:Gem::Dependency
+  name: addressable
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.5'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.5'
+- !ruby/object:Gem::Dependency
+  name: faraday
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.15'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.15'
+- !ruby/object:Gem::Dependency
+  name: faraday_middleware
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.12'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.12'
+- !ruby/object:Gem::Dependency
+  name: multi_json
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.13'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.13'
+- !ruby/object:Gem::Dependency
+  name: bundler
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.16'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.16'
+- !ruby/object:Gem::Dependency
+  name: dotenv
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.5'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.5'
+- !ruby/object:Gem::Dependency
+  name: pry-byebug
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.6'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.6'
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '10.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '10.0'
+- !ruby/object:Gem::Dependency
+  name: rspec
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.0'
+- !ruby/object:Gem::Dependency
+  name: rubocop
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.58'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.58'
+- !ruby/object:Gem::Dependency
+  name: rubocop-rspec
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.27'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.27'
+- !ruby/object:Gem::Dependency
+  name: simplecov
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.16'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.16'
+description: Simple gem to connect to Zoho CRM API V2
+email:
+- oterosantos@gmail.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- ".gitignore"
+- ".rspec"
+- ".rubocop.yml"
+- ".ruby-version"
+- ".travis.yml"
+- Gemfile
+- Gemfile.lock
+- LICENSE.txt
+- README.md
+- Rakefile
+- bin/console
+- bin/setup
+- lib/zoho_hub.rb
+- lib/zoho_hub/auth.rb
+- lib/zoho_hub/configuration.rb
+- lib/zoho_hub/connection.rb
+- lib/zoho_hub/errors.rb
+- lib/zoho_hub/records/account.rb
+- lib/zoho_hub/records/base_record.rb
+- lib/zoho_hub/records/campaign.rb
+- lib/zoho_hub/records/contact.rb
+- lib/zoho_hub/records/potential.rb
+- lib/zoho_hub/response.rb
+- lib/zoho_hub/version.rb
+- zoho_hub.gemspec
+homepage: https://github.com/rikas/zoho_hub
+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.7.6
+signing_key: 
+specification_version: 4
+summary: Simple gem to connect to Zoho CRM API V2
+test_files: []