fabychy 0.0.1

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: b3ef24822b7befc7c0557b46425d64d74f76929d
+  data.tar.gz: f598182235c89ae306c95d79dadd7f84b055b70b
+SHA512:
+  metadata.gz: 6402ac7b3dde3a7191da382459ca27ca448c1dd12a532da1ce83f11c35fe218fc53330cf8e7ed80bedfdbd08a3c7d41a06bb188ede39f6118cc8858d68d40216
+  data.tar.gz: f6d21e92eaeb13258323bd60e4a0d603ad21032f3b8712e513d3423ef314f7e2cc4d31e8c6df883ecc52e066d2399c5427e7ce4832824a4477572adeddb883b7

data/.gitignore

@@ -0,0 +1,35 @@
+*.rbc
+capybara-*.html
+.rspec
+/log
+/tmp
+/db/*.sqlite3
+/db/*.sqlite3-journal
+/public/system
+/coverage/
+/spec/tmp
+**.orig
+rerun.txt
+pickle-email-*.html
+
+# TODO Comment out these rules if you are OK with secrets being uploaded to the repo
+config/initializers/secret_token.rb
+config/secrets.yml
+
+## Environment normalization:
+/.bundle
+/vendor/bundle
+
+# these should all be checked in to normalize the environment:
+# Gemfile.lock, .ruby-version, .ruby-gemset
+
+# unless supporting rvm < 1.11.0 or doing something fancy, ignore this:
+.rvmrc
+
+# if using bower-rails ignore default bower_components path bower.json files
+/vendor/assets/bower_components
+*.bowerrc
+bower.json
+
+# Ignore pow environment settings
+.powenv

data/Gemfile

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

data/LICENSE

@@ -0,0 +1,21 @@
+The MIT License (MIT)
+
+Copyright (c) 2016 Nima Kaviani
+
+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/fabychy.gemspec

@@ -0,0 +1,26 @@
+lib = File.expand_path('../lib', __FILE__)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+require 'fabychy/version'
+
+Gem::Specification.new do |spec|
+  spec.name          = "fabychy"
+  spec.version       = Fabychy::VERSION
+  spec.authors       = ["Nima Kaviani"]
+  spec.email         = ["nima@robochy.com"]
+  spec.description   = %q{Ruby client for Facebook Bot API}
+  spec.summary       = %q{Ruby client for Facebook Bot API}
+  spec.homepage      = "https://github.com/nkaviani/fabychy"
+  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 "httpclient", "~> 2.6"
+  spec.add_dependency "virtus", "~> 1.0"
+  spec.add_dependency "multi_json", "~> 1.11"
+
+  spec.add_development_dependency "bundler", "~> 1.7"
+  spec.add_development_dependency "rake", "~> 10.1"
+end

data/lib/fabychy/api_response.rb

@@ -0,0 +1,34 @@
+module Fabychy
+  class ApiResponse
+    attr_reader :body
+    attr_reader :result
+    attr_reader :success
+
+    def initialize(response,fail_silently = false)
+      if response.status < 500
+        @body = response.body
+        data = MultiJson.load(@body)
+        @success = (response.status == 200)
+
+        if @success
+          @result = data
+        else
+          if !fail_silently
+            fail Fabychy::Errors::BadRequestError.new(data['error'], data['message'])
+          end
+        end
+      else
+        if !fail_silently
+          fail Fabychy::Errors::ServiceUnavailableError.new(response.status)
+        end
+      end
+    end
+
+    def self.parse(request)
+     Fabychy::DataTypes::ReceivedMessages.new(MultiJson.load(request.body))
+    end
+
+    alias_method :success?, :success
+  end
+end
+

data/lib/fabychy/bot.rb

@@ -0,0 +1,62 @@
+module Fabychy
+  class Bot
+    API_ENDPOINT = 'https://graph.facebook.com/v2.6'
+
+    attr_reader :me
+
+    def initialize(token)
+      @access_token = token
+      @offset = 0
+      @timeout = 60
+      @fail_silently = false
+      @connection = HTTPClient.new
+    end
+
+    def send_message(message)
+      api_post("me/messages?access_token=#{@access_token}", Fabychy::Sanitizer.sanitize(message))
+    end
+
+    def get_user(user_id)
+      response = api_get("#{user_id}?fields=first_name,last_name,profile_pic&access_token=#{@access_token}")
+      Fabychy::DataTypes::User.new(response.result)
+    end
+
+  private
+
+
+    def api_get(action)
+      api_uri = "#{action}"
+      begin
+        response = @connection.get(
+          "#{API_ENDPOINT}/#{api_uri}",
+          nil
+        )
+
+        ApiResponse.new(response,@fail_silently)
+      rescue HTTPClient::ReceiveTimeoutError => e
+        if !@fail_silently
+          fail Fabychy::Errors::TimeoutError, e.to_s
+        end
+      end
+    end
+
+    def api_post(action, params)
+      api_uri = "#{action}"
+
+      begin
+        response = @connection.post(
+          "#{API_ENDPOINT}/#{api_uri}",
+          MultiJson.dump(params),
+          'Content-Type' => 'application/json'
+        )
+
+        ApiResponse.new(response,@fail_silently)
+      rescue HTTPClient::ReceiveTimeoutError => e
+        if !@fail_silently
+          fail Fabychy::Errors::TimeoutError, e.to_s
+        end
+      end
+    end
+
+  end
+end

data/lib/fabychy/data_types/address.rb

@@ -0,0 +1,28 @@
+module Fabychy
+  module DataTypes
+    class Address < Fabychy::DataTypes::Base
+      attribute :street_1, String
+      attribute :street_2, String
+      attribute :city, String
+      attribute :postal_code, String
+      attribute :state, String
+      attribute :country, String
+
+      def initialize *params
+        super(*params)
+      end
+
+      def validations
+        {
+          street_1: { required: true, class: [String] },
+          street_2: { required: false, drop_empty: true, class: [String] },
+          city: { required: true, class: [String] },
+          postal_code: { required: true, class: [String] },
+          state: { required: true, class: [String] },
+          country: { required: true, class: [String] },
+        }
+      end
+    end
+  end
+end
+

data/lib/fabychy/data_types/adjustment.rb

@@ -0,0 +1,20 @@
+module Fabychy
+  module DataTypes
+    class Adjustment < Fabychy::DataTypes::Base
+      attribute :name, String
+      attribute :amount, Integer
+
+      def initialize *params
+        super(*params)
+      end
+
+      def validations
+        {
+          name: { required: false, class: [String] },
+          amount: { required: false, class: [Fixnum] },
+        }
+      end
+    end
+  end
+end
+

data/lib/fabychy/data_types/attachment.rb

@@ -0,0 +1,14 @@
+module Fabychy
+  module DataTypes
+    class Attachment < Fabychy::DataTypes::Base
+      attribute :type, String
+      attribute :payload, Payload
+
+      def validations
+        {
+          type: { required: true, class: [String] } ,
+        }
+      end
+    end
+  end
+end

data/lib/fabychy/data_types/base.rb

@@ -0,0 +1,7 @@
+module Fabychy
+  module DataTypes
+    class Base
+      include Virtus.model
+    end
+  end
+end

data/lib/fabychy/data_types/button.rb

@@ -0,0 +1,24 @@
+module Fabychy
+  module DataTypes
+    class Button < Fabychy::DataTypes::Base
+      attribute :type, String
+      attribute :title, String
+      attribute :url, String
+      attribute :payload, String
+
+      def initialize *params
+        super(*params)
+      end
+
+      def validations
+        {
+          type: { required: true, class: [String], in: ["web_url", "postback"] },
+          title: { required: true, class: [String] },
+          url: { required: false, drop_empty:true, class: [String], exclusive: true },
+          payload: { required: false, drop_empty: true, class: [String], exclusive: true },
+        }
+      end
+    end
+  end
+end
+

data/lib/fabychy/data_types/button_template_payload.rb

@@ -0,0 +1,22 @@
+module Fabychy
+  module DataTypes
+    class ButtonTemplatePayload < Fabychy::DataTypes::Payload
+      attribute :text, String
+      attribute :buttons, Array[Button]
+      def initialize *params
+        super(*params)
+        @template_type = 'button'
+      end
+
+      def validations
+        super.merge(
+          {
+            text: {required: false, drop_empty: true, class: [String] },
+            buttons: {required: true, class: [Array], inner_class: [Button] }
+          }
+        )
+      end
+    end
+  end
+end
+

data/lib/fabychy/data_types/element.rb

@@ -0,0 +1,22 @@
+module Fabychy
+  module DataTypes
+    class Element < Fabychy::DataTypes::Base
+      attribute :title, String
+      attribute :subtitle, String
+      attribute :image_url, String
+
+      def initialize *params
+        super(*params)
+      end
+
+      def validations
+        {
+          title: { required: true, class: [String] },
+          subtitle: { required: false, class: [String] },
+          image_url: { required: false, drop_empty: true, class: [String] },
+        }
+      end
+    end
+  end
+end
+

data/lib/fabychy/data_types/generic_element.rb

@@ -0,0 +1,22 @@
+module Fabychy
+  module DataTypes
+    class GenericElement < Fabychy::DataTypes::Element
+      attribute :item_url, String
+      attribute :buttons, Array[Fabychy::DataTypes::Button], :default => nil
+
+      def initialize *params
+        super(*params)
+      end
+
+      def validations
+        super.merge(
+          {
+            item_url: { required: false, drop_empty: true, class: [String] },
+            buttons: { required: false, drop_empty: true, class: [Array], inner_class: [Fabychy::DataTypes::Button] },
+          }
+        )
+      end
+    end
+  end
+end
+

data/lib/fabychy/data_types/generic_template_payload.rb

@@ -0,0 +1,20 @@
+module Fabychy
+  module DataTypes
+    class GenericTemplatePayload < Fabychy::DataTypes::Payload
+      attribute :elements, Array[Element]
+      def initialize *params
+        super(*params)
+        @template_type = 'generic'
+      end
+
+      def validations
+        super.merge(
+          {
+            elements: {required: true, class: [Array], inner_class: [GenericElement] }
+          }
+        )
+      end
+    end
+  end
+end
+

data/lib/fabychy/data_types/image_attachment.rb

@@ -0,0 +1,21 @@
+module Fabychy
+  module DataTypes
+    class ImageAttachment < Fabychy::DataTypes::Attachment
+      attribute :payload, ImagePayload
+
+      def initialize *params
+        super(*params)
+        @type = 'image'
+      end
+
+      def validations
+        super.merge(
+          {
+            payload: {required: true, class: [ImagePayload] }
+          }
+        )
+      end
+    end
+  end
+end
+

data/lib/fabychy/data_types/image_payload.rb

@@ -0,0 +1,14 @@
+module Fabychy
+  module DataTypes
+    class ImagePayload < Fabychy::DataTypes::Payload
+      attribute :url, String
+
+      def validations
+        {
+          url: {required: true, class: [String]}
+        }
+      end
+    end
+  end
+end
+

data/lib/fabychy/data_types/message_body.rb

@@ -0,0 +1,16 @@
+module Fabychy
+  module DataTypes
+    class MessageBody < Fabychy::DataTypes::Base
+      attribute :text, String
+      attribute :attachment, Attachment
+
+      def validations
+        {
+          text: {required: true, class: [String], drop_empty: true, exclusive: true },
+          attachment: {required: true, class: [TemplateAttachment, ImageAttachment], drop_empty: true, exclusive: true }
+        }
+      end
+    end
+  end
+end
+

data/lib/fabychy/data_types/payload.rb

@@ -0,0 +1,14 @@
+module Fabychy
+  module DataTypes
+    class Payload < Fabychy::DataTypes::Base
+      attribute :template_type, String
+
+      def validations
+        {
+          template_type: {required: true, class: [String]}
+        }
+      end
+    end
+  end
+end
+

data/lib/fabychy/data_types/receipt_element.rb

@@ -0,0 +1,21 @@
+module Fabychy
+  module DataTypes
+    class ReceiptElement < Fabychy::DataTypes::Element
+      attribute :quantity, Integer
+      attribute :price, Integer
+      attribute :currency, String
+
+      def validations
+        super.merge (
+          {
+            quantity: {required: false, drop_empty: true, class: [Fixnum] },
+            price: {required: false, drop_empty: true, class: [Fixnum] },
+            currency: {required: false, drop_empty: true, class: [String] }
+          }
+        )
+      end
+    end
+  end
+end
+
+

data/lib/fabychy/data_types/receipt_template_payload.rb

@@ -0,0 +1,40 @@
+module Fabychy
+  module DataTypes
+    class ReceiptTemplatePayload < Fabychy::DataTypes::Payload
+      attribute :recipient_name, String
+      attribute :order_number, String
+      attribute :currency, String
+      attribute :payment_method, String
+      attribute :timestamp, String
+      attribute :order_url, String
+      attribute :elements, String
+      attribute :address, Address
+      attribute :summary, Summary
+      attribute :adjustments, Adjustment
+
+      def initialize *params
+        super(*params)
+        @template_type = 'receipt'
+      end
+
+      def validations
+        super.merge(
+          {
+            recipient_name: {required: true, class: [String] },
+            order_number: {required: true, class: [String] },
+            currency: {required: true, class: [String] },
+            payment_method: {required: true, class: [String] },
+            timestamp: {required: false, drop_empty: true, class: [String] },
+            order_url: {required: true, class: [String] },
+            elements: {required: true, class: [Array], inner_class: [ReceiptElement] },
+            address: {required: false, drop_empty: true, class: [Address] },
+            summary: {required: true, class: [Summary] },
+            adjustments: {required: false, class: [Adjustment] }
+          }
+        )
+      end
+    end
+  end
+end
+
+

data/lib/fabychy/data_types/recipient.rb

@@ -0,0 +1,16 @@
+module Fabychy
+  module DataTypes
+    class Recipient < Fabychy::DataTypes::Base
+      attribute :id, String
+      attribute :phone_number, String
+
+      def validations
+        {
+          id: {required: false, drop_empty: true, class: [String] },
+          phone_number: { required: false, drop_empty: true, class: [String] }
+        }
+      end
+    end
+  end
+end
+

data/lib/fabychy/data_types/summary.rb

@@ -0,0 +1,20 @@
+module Fabychy
+  module DataTypes
+    class Summary < Fabychy::DataTypes::Base
+      attribute :subtotal, Integer
+      attribute :shipping_cost, Integer
+      attribute :total_tax, Integer
+      attribute :total_cost, Integer
+
+      def validations
+        {
+          subtotal: { required: false, class: [Fixnum] },
+          shipping_cost: { required: false, class: [Fixnum] },
+          total_tax: { required: false, class: [Fixnum] },
+          total_cost: { required: true, class: [Fixnum] },
+        }
+      end
+    end
+  end
+end
+

data/lib/fabychy/data_types/template_attachment.rb

@@ -0,0 +1,21 @@
+module Fabychy
+  module DataTypes
+    class TemplateAttachment < Fabychy::DataTypes::Attachment
+      attribute :payload, Payload
+
+      def initialize *params
+        super(*params)
+        @type = 'template'
+      end
+
+      def validations
+        super.merge(
+          {
+            payload: {required: true, class: [GenericTemplatePayload, ReceiptTemplatePayload, ButtonTemplatePayload] }
+          }
+        )
+      end
+    end
+  end
+end
+

data/lib/fabychy/data_types/user.rb

@@ -0,0 +1,10 @@
+module Fabychy
+  module DataTypes
+    class User < Fabychy::DataTypes::Base
+      attribute :first_name, String
+      attribute :last_name, String
+      attribute :profile_pic, String
+    end
+  end
+end
+

data/lib/fabychy/message.rb

@@ -0,0 +1,14 @@
+module Fabychy
+  class Notification
+    REGULAR = "REGULAR"
+    SILENT_PUSH = "SILENT_PUSH"
+    NO_PUSH = "NO_PUSH"
+  end
+
+  class Message < Fabychy::DataTypes::Base
+    attribute :recipient, DataTypes::Recipient
+    attribute :message, DataTypes::MessageBody
+    attribute :notification_type, String
+  end
+end
+

data/lib/fabychy/sanitizer.rb

@@ -0,0 +1,69 @@
+module Fabychy
+  class Sanitizer
+
+    def self.sanitize(object)
+      return object if object.class.name !~ /Fabychy::/
+      internal = sanitize_internal(object)
+      h = Hash.new
+      object.attributes.each do |k, att|
+        next unless internal.nil? || internal.key?(k)
+        if !att.is_a? Array
+          h[k]=sanitize(att)
+        else
+          h[k]=Array.new
+          att.each do |attr|
+            h[k] << sanitize(attr)
+          end
+        end
+      end
+      return h
+    end
+
+    def self.sanitize_internal(object)
+      return if !object.methods.include?(:validations)
+      # Delete params not accepted by the API
+      validated_param = object.to_hash.delete_if do |k, _v|
+        !object.validations.key?(k) || (object.validations[k][:drop_empty] && (_v.nil? || (_v.is_a?(Array) && _v.empty?)))
+      end
+
+      exclusives = object.validations.select{|k,v| v[:exclusive] }.keys
+      valid_exclusives = object.validations.select{|k,v| v[:exclusive] }.keys & validated_param.keys
+      if valid_exclusives.size > 1
+        fail Fabychy::Errors::ExclusivityError.new(exclusive_elements)
+      end
+      ignored_exclusive = exclusives - valid_exclusives
+      # Check all required params by the action are present
+      object.validations.each do |key, _value|
+        next if ignored_exclusive.include?(key)
+        if _value[:required] && (!validated_param.key?(key) || validated_param[key].nil?)
+          fail Fabychy::Errors::MissingParamsError.new(key, object.class.name)
+        end
+
+        # Check param types
+        unless _value[:class].include?(validated_param[key].class) || (_value[:drop_empty] && validated_param[key].nil?)
+          fail Fabychy::Errors::InvalidParamTypeError.new(key, validated_param[key].class, _value[:class])
+        end
+
+        if _value[:class] && _value[:class].include?(Array)
+          if validated_param[key].empty?
+            fail Fabychy::Errors::InvalidParamValueError.new(key, validated_param[key], ["should not be empty"])
+          end
+          if _value[:inner_class]
+            validated_param[key].each do |v|
+              unless _value[:inner_class].include?(v.class)
+                fail Fabychy::Errors::InvalidParamTypeError.new(key, validated_param[key].class, _value[:inner_class])
+              end
+            end
+          end
+        end
+
+        unless _value[:in].nil? || _value[:in].include?(validated_param[key])
+          fail Fabychy::Errors::InvalidParamValueError.new(key, validated_param[key], _value[:in])
+        end
+        validated_param[key] = validated_param[key].to_s if _value[:class] == Fixnum
+      end
+
+      return validated_param
+    end
+  end
+end

data/lib/fabychy/user.rb

@@ -0,0 +1,74 @@
+
+require 'httpclient'
+require 'virtus'
+require 'multi_json'
+
+require 'fabychy/version'
+require 'fabychy/data_types/base'
+
+require 'fabychy/data_types/payload'
+require 'fabychy/data_types/element'
+require 'fabychy/data_types/button'
+
+require 'fabychy/data_types/receipt_element'
+require 'fabychy/data_types/generic_element'
+
+require 'fabychy/data_types/address'
+require 'fabychy/data_types/adjustment'
+require 'fabychy/data_types/summary'
+require 'fabychy/data_types/attachment'
+
+require 'fabychy/data_types/generic_template_payload'
+require 'fabychy/data_types/button_template_payload'
+require 'fabychy/data_types/receipt_template_payload'
+require 'fabychy/data_types/image_payload'
+
+require 'fabychy/data_types/image_attachment'
+require 'fabychy/data_types/template_attachment'
+
+require 'fabychy/data_types/recipient'
+require 'fabychy/data_types/message_body'
+require 'fabychy/data_types/user'
+
+require 'fabychy/message'
+require 'fabychy/bot'
+require 'fabychy/api_response'
+
+module Fabychy
+  module Errors
+    # Error returned when a required param is missing
+    class MissingParamsError < StandardError
+      def initialize(parameter, action)
+        super("Missing parameter `#{parameter}` for `#{action}`")
+      end
+    end
+
+    # Error returned when a param type is invalid
+    class InvalidParamTypeError < StandardError
+      def initialize(parameter, current_type, allowed_types)
+        super("Invalid parameter type: `#{parameter}`: `#{current_type}`. Allowed types: #{allowed_types.each { |type| type.class.to_s }.join(',')}.")
+      end
+    end
+
+    # Error returned when something goes bad with your request to the fabychy API
+    class BadRequestError < StandardError
+      def initialize(error_code, message)
+        super("Bad request. Error code: `#{error_code}` - Message: `#{message}`")
+      end
+    end
+
+    # Error returned when fabychy API Service is unavailable
+    class ServiceUnavailableError < StandardError
+      def initialize(status_code)
+        super("fabychy API Service unavailable (HTTP error code #{status_code})")
+      end
+    end
+
+    # Error returned when HTTPClient raise a timeout (?)
+    class TimeoutError < StandardError
+      def initialize(message)
+        super("Timeout reached. Message: #{message}")
+      end
+    end
+  end
+end

data/lib/fabychy/version.rb

@@ -0,0 +1,4 @@
+module Fabychy
+  VERSION = '0.0.1'
+end
+

data/lib/fabychy.rb

@@ -0,0 +1,87 @@
+require 'httpclient'
+require 'virtus'
+require 'multi_json'
+
+require 'fabychy/version'
+require 'fabychy/data_types/base'
+
+require 'fabychy/data_types/payload'
+require 'fabychy/data_types/element'
+require 'fabychy/data_types/button'
+
+require 'fabychy/data_types/receipt_element'
+require 'fabychy/data_types/generic_element'
+
+require 'fabychy/data_types/address'
+require 'fabychy/data_types/adjustment'
+require 'fabychy/data_types/summary'
+require 'fabychy/data_types/attachment'
+
+require 'fabychy/data_types/generic_template_payload'
+require 'fabychy/data_types/button_template_payload'
+require 'fabychy/data_types/receipt_template_payload'
+require 'fabychy/data_types/image_payload'
+
+require 'fabychy/data_types/image_attachment'
+require 'fabychy/data_types/template_attachment'
+
+require 'fabychy/data_types/recipient'
+require 'fabychy/data_types/message_body'
+
+require 'fabychy/sanitizer'
+require 'fabychy/message'
+require 'fabychy/user'
+require 'fabychy/bot'
+require 'fabychy/api_response'
+
+module Fabychy
+  module Errors
+    # Error returned when a required param is missing
+    class MissingParamsError < StandardError
+      def initialize(parameter, action)
+        super("Missing parameter `#{parameter}` for `#{action}`")
+      end
+    end
+
+    class ExclusivityError < StandardError
+      def initialize(param_list)
+        super("Only one of the following is allowed `#{param_list}`")
+      end
+    end
+
+    # Error returned when a param type is invalid
+    class InvalidParamTypeError < StandardError
+      def initialize(parameter, current_type, allowed_types)
+        super("Invalid parameter type: `#{parameter}`: `#{current_type}`. Allowed types: #{allowed_types.each { |type| type.class.to_s }.join(',')}.")
+      end
+    end
+
+    # Error returned when a param type is invalid
+    class InvalidParamValueError < StandardError
+      def initialize(parameter, current_value, allowed_values)
+        super("Invalid parameter value: `#{parameter}`: `#{current_value}`. Allowed values: #{allowed_values.each { |type| type.class.to_s }.join(',')}.")
+      end
+    end
+
+    # Error returned when something goes bad with your request to the fabychy API
+    class BadRequestError < StandardError
+      def initialize(error_code, message)
+        super("Bad request. Error code: `#{error_code}` - Message: `#{message}`")
+      end
+    end
+
+    # Error returned when fabychy API Service is unavailable
+    class ServiceUnavailableError < StandardError
+      def initialize(status_code)
+        super("fabychy API Service unavailable (HTTP error code #{status_code})")
+      end
+    end
+
+    # Error returned when HTTPClient raise a timeout (?)
+    class TimeoutError < StandardError
+      def initialize(message)
+        super("Timeout reached. Message: #{message}")
+      end
+    end
+  end
+end

metadata

@@ -0,0 +1,145 @@
+--- !ruby/object:Gem::Specification
+name: fabychy
+version: !ruby/object:Gem::Version
+  version: 0.0.1
+platform: ruby
+authors:
+- Nima Kaviani
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2016-04-16 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: httpclient
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.6'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.6'
+- !ruby/object:Gem::Dependency
+  name: virtus
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.0'
+- !ruby/object:Gem::Dependency
+  name: multi_json
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.11'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.11'
+- !ruby/object:Gem::Dependency
+  name: bundler
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.7'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.7'
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '10.1'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '10.1'
+description: Ruby client for Facebook Bot API
+email:
+- nima@robochy.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- ".gitignore"
+- Gemfile
+- LICENSE
+- README.md
+- fabychy.gemspec
+- lib/fabychy.rb
+- lib/fabychy/api_response.rb
+- lib/fabychy/bot.rb
+- lib/fabychy/data_types/address.rb
+- lib/fabychy/data_types/adjustment.rb
+- lib/fabychy/data_types/attachment.rb
+- lib/fabychy/data_types/base.rb
+- lib/fabychy/data_types/button.rb
+- lib/fabychy/data_types/button_template_payload.rb
+- lib/fabychy/data_types/element.rb
+- lib/fabychy/data_types/generic_element.rb
+- lib/fabychy/data_types/generic_template_payload.rb
+- lib/fabychy/data_types/image_attachment.rb
+- lib/fabychy/data_types/image_payload.rb
+- lib/fabychy/data_types/message_body.rb
+- lib/fabychy/data_types/payload.rb
+- lib/fabychy/data_types/receipt_element.rb
+- lib/fabychy/data_types/receipt_template_payload.rb
+- lib/fabychy/data_types/recipient.rb
+- lib/fabychy/data_types/summary.rb
+- lib/fabychy/data_types/template_attachment.rb
+- lib/fabychy/data_types/user.rb
+- lib/fabychy/message.rb
+- lib/fabychy/sanitizer.rb
+- lib/fabychy/user.rb
+- lib/fabychy/version.rb
+homepage: https://github.com/nkaviani/fabychy
+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.4.8
+signing_key: 
+specification_version: 4
+summary: Ruby client for Facebook Bot API
+test_files: []