contactually-rb 0.1.1

data/lib/contactually/buckets.rb

@@ -0,0 +1,14 @@
+module Contactually
+  class Buckets < Base
+    implements :list, :fetch
+
+    def initialize(url: '/v2/buckets', interface: nil)
+      @url = url
+      @interface = interface
+    end
+
+    def model
+      Models::Bucket
+    end
+  end
+end

data/lib/contactually/client.rb

@@ -0,0 +1,36 @@
+module Contactually
+  class Client
+    attr_reader :interface
+
+    def initialize(api_key: nil, auth_token: nil, base_url: 'https://api.contactually.com')
+      @api_key = api_key
+      @auth_token = auth_token
+      @base_url = base_url
+      @interface = Contactually::Interface.new(
+        api_key:      @api_key,
+        auth_token:   @auth_token,
+        base_url:     @base_url
+      )
+    end
+
+    def buckets
+      @buckets ||= Contactually::Buckets.new(interface: interface)
+    end
+
+    def contacts
+      @contacts ||= Contactually::Contacts.new(interface: interface)
+    end
+
+    def me
+      @contacts ||= Contactually::Me.new(interface: interface)
+    end
+
+    def tags
+      @tags ||= Contactually::Tags.new(interface: interface)
+    end
+
+    def tasks
+      @tasks ||= Contactually::Tasks.new(interface: interface)
+    end
+  end
+end

data/lib/contactually/collection.rb

@@ -0,0 +1,33 @@
+module Contactually
+  class Collection
+    extend Forwardable
+    include Enumerable
+
+    attr_reader :items, :next_page, :previous_page, :total
+
+    def initialize(items, meta: {})
+      @items = items
+
+      @next_page = meta['next_page']
+      @previous_page = meta['previous_page']
+      @total = meta['total']
+    end
+
+    def each(&block)
+      items.each do |item|
+        block.call(item)
+      end
+    end
+
+    def has_next_page?
+      !next_page.nil?
+    end
+
+    def has_previous_page?
+      !previous_page.nil?
+    end
+
+    def_delegator :items, :last
+    def_delegator :items, :size
+  end
+end

data/lib/contactually/contacts.rb

@@ -0,0 +1,14 @@
+module Contactually
+  class Contacts < Base
+    implements :list, :fetch
+
+    def initialize(url: '/v2/contacts', interface: nil)
+      @url = url
+      @interface = interface
+    end
+
+    def model
+      Models::Contact
+    end
+  end
+end

data/lib/contactually/interface.rb

@@ -0,0 +1,50 @@
+module Contactually
+  class Interface
+    attr_reader :adapter, :api_key, :auth_token, :base_url, :connection, :headers
+
+    def initialize(auth_token: nil, api_key: nil, base_url: nil)
+      @auth_token = auth_token
+      @api_key = api_key
+      @adapter = Contactually.configuration.adapter || :net_http
+      @base_url = base_url
+
+      set_headers
+    end
+
+    def get(url, params)
+      connection.get(build_full_url(url), params)
+    end
+
+    def connection
+      @connection ||= Faraday.new do |conn|
+        conn.adapter  @adapter
+        conn.response :json, :content_type => /\bjson$/
+        conn.use Contactually::Middleware::ErrorHandler
+
+        conn.headers['Content-type']  = 'application/json',
+        conn.headers['Authorization'] = "Bearer #{token}"
+      end
+    end
+
+    private
+
+    def build_full_url(url)
+      if url.downcase.start_with?('http')
+        url
+      else
+        "#{base_url}#{url}"
+      end
+    end
+
+    def token
+      auth_token || api_key
+    end
+
+    def set_headers
+      @headers = {
+        'Content-type' => 'application/json',
+        'Authorization' => "Bearer #{token}"
+      }
+    end
+  end
+end

data/lib/contactually/me.rb

@@ -0,0 +1,18 @@
+module Contactually
+  class Me < Base
+    implements :fetch
+
+    def initialize(url: '/v2/me', interface: nil)
+      @url = url
+      @interface = interface
+    end
+
+    def fetch
+      super(nil)
+    end
+
+    def model
+      Models::User
+    end
+  end
+end

data/lib/contactually/middleware/error_middleware.rb

@@ -0,0 +1,47 @@
+module Contactually
+  module Middleware
+    class ErrorHandler < Faraday::Middleware
+      def call(env)
+        @app.call(env).on_complete do |env|
+          case env.status
+            when 401
+              # Missing or invalid auth token
+              raise Contactually::UnauthorizedError.new(error_messages(env.response))
+            when 403
+              # App does not have permission to perform the operation
+              raise Contactually::ForbiddenError.new(error_messages(env.response))
+            when 404
+              # Standard REST resource not found or not allowed to fetch
+              raise Contactually::NotFoundError.new(error_messages(env.response))
+          end
+        end
+      end
+
+      private
+
+      def error_messages(response)
+        return generic_error unless is_json?(response)
+
+        body = parse_body(response)
+
+        if body.has_key?('errors')
+          body['errors']
+        else
+          generic_error
+        end
+      end
+
+      def generic_error
+        ['Something went wrong']
+      end
+
+      def is_json?(response)
+        response.headers['content-type'] =~ /application\/json/i
+      end
+
+      def parse_body(response)
+        JSON.parse(response.body) rescue {}
+      end
+    end
+  end
+end

data/lib/contactually/models/address.rb

@@ -0,0 +1,17 @@
+module Contactually
+  module Models
+    class Address
+      include Model
+
+      field :city, :string
+      field :country, :string
+      field :id, :string
+      field :full_address, :string
+      field :label, :string
+      field :state, :string
+      field :street_1, :string
+      field :street_2, :string
+      field :zip, :string
+    end
+  end
+end

data/lib/contactually/models/bucket.rb

@@ -0,0 +1,17 @@
+module Contactually
+  module Models
+    class Bucket
+      include Model
+
+      field :contact_count, :integer
+      field :created_at, :datetime
+      field :goal, :string
+      field :id, :string
+      field :name, :string
+      field :reminder_interval, :integer
+      field :updated_at, :datetime
+
+      field :extra_data, Hash
+    end
+  end
+end

data/lib/contactually/models/contact.rb

@@ -0,0 +1,33 @@
+module Contactually
+  module Models
+    class Contact
+      include Model
+
+      field :addresses, [Address]
+      field :avatar_url, :string
+      field :company, :string
+      field :created_at, :datetime
+      field :email_addresses, [EmailAddress]
+      field :first_name, :string
+      field :id, :string
+      field :last_name, :string
+      field :phone_numbers, [PhoneNumber]
+      field :social_media_profiles, [SocialMediaProfile]
+      field :tags, [String]
+      field :title, :string
+      field :websites, [Website]
+      field :updated_at, :datetime
+
+      # field :custom_fields, [String] TODO: should be it's own model type
+      field :extra_data, Hash
+
+      def first_email_address
+        if email_addresses
+          email_addresses.first
+        else
+          EmailAddress.new({})
+        end
+      end
+    end
+  end
+end

data/lib/contactually/models/email_address.rb

@@ -0,0 +1,11 @@
+module Contactually
+  module Models
+    class EmailAddress
+      include Model
+
+      field :id, :string
+      field :label, :string
+      field :address, :string
+    end
+  end
+end

data/lib/contactually/models/model.rb

@@ -0,0 +1,95 @@
+module Contactually
+  module Models
+    module Model
+      def self.included(base)
+        base.send :extend, ClassMethods
+      end
+
+      def initialize(params={})
+        params.each do |attr, _value|
+          self.send("#{attr}=", params.delete(attr)) if respond_to?(attr)
+        end if params
+
+        @_extra_attributes = params
+
+        super()
+      end
+
+      def attributes
+        self.class.field_list.inject({}) do |acc, field_name|
+          value = send(field_name)
+
+          if Array === value
+            if value.first.respond_to?(:attributes)
+              value = value.map(&:attributes)
+            else
+              value
+            end
+          end
+
+          acc.merge(field_name.to_s => value)
+        end
+      end
+
+      private
+
+      attr_reader :_extra_attributes
+
+      def type_cast(value, type)
+        case type
+          when :string then value.to_s
+          when :integer then value.to_i
+          when :float then value.to_f
+          when :date then value.to_date
+          when :datetime then DateTime.parse(value)
+          else
+            case type
+              when Array
+                value.map { |obj| type.first.new(obj) }
+              else
+                if type == Hash
+                  value
+                else
+                  type.new(value)
+                end
+            end
+        end
+      end
+
+      def method_missing(method, *args, **kwargs)
+        string_method = method.to_s
+
+        if _extra_attributes.has_key?(string_method)
+          _extra_attributes[string_method]
+        else
+          super
+        end
+      end
+
+      module ClassMethods
+        attr_accessor :field_list
+
+        def field(field_name, type)
+          register_field field_name
+
+          private_method = define_method "#{field_name}=" do |value|
+            instance_variable_set "@#{field_name}", type_cast(value, type)
+          end
+          private private_method
+        end
+
+        def field_list
+          @field_list ||= []
+        end
+
+        def register_field(field_name)
+          class_eval do
+            attr_reader field_name
+          end
+
+          self.field_list << field_name
+        end
+      end
+    end
+  end
+end

data/lib/contactually/models/phone_number.rb

@@ -0,0 +1,11 @@
+module Contactually
+  module Models
+    class PhoneNumber
+      include Model
+
+      field :id, :string
+      field :label, :string
+      field :number, :string
+    end
+  end
+end

data/lib/contactually/models/social_media_profile.rb

@@ -0,0 +1,11 @@
+module Contactually
+  module Models
+    class SocialMediaProfile
+      include Model
+
+      field :id, :string
+      field :label, :string
+      field :url, :string
+    end
+  end
+end

data/lib/contactually/models/tag.rb

@@ -0,0 +1,13 @@
+module Contactually
+  module Models
+    class Tag
+      include Model
+
+      field :contact_count, :integer
+      field :created_at, :datetime
+      field :id, :string
+      field :name, :string
+      field :updated_at, :datetime
+    end
+  end
+end