module Desk
  class Client
    # Defines methods related to customers
    module Customer
      # Returns extended information of customers
      #
      #   @option options [Boolean, String, Integer]
      #   @example Return extended information for customers
      #     Desk.customers
      #     Desk.customers(:since_id => 12345, :count => 5)
      # @format :json
      # @authenticated true
      # @see http://dev.desk.com/docs/api/customers
      def customers(*args)
        options = args.last.is_a?(Hash) ? args.pop : {}
        response = get("customers",options)
        response
      end

      # Returns extended information on a single customer
      #
      #   @option options [String]
      #   @example Return extended information for customer 12345
      #     Desk.customer(12345)
      # @format :json
      # @authenticated true
      # @see http://dev.desk.com/docs/api/customers/show
      def customer(id)
        response = get("customers/#{id}")
        response.customer
      end

      # Create a new customer
      #
      #   @option options [String]
      #   @example Return extended information for 12345
      #     Desk.create_customer(:name => "Chris Warren", :twitter => "cdwarren")
      # @format :json
      # @authenticated true
      # @see http://dev.desk.com/docs/api/customers/create
      def create_customer(*args)
        options = args.last.is_a?(Hash) ? args.pop : {}
        response = post("customers",options)
        if response['success']
          return response['results']['customer']
        else
          return response
        end
      end

      # Update a customer
      #
      #   @option options [String]
      #   @example Return extended information for 12345
      #     Desk.update_customer(12345, :name => "Christopher Warren")
      # @format :json
      # @authenticated true
      # @see http://dev.desk.com/docs/api/customers/update
      def update_customer(id, *args)
        options = args.last.is_a?(Hash) ? args.pop : {}
        response = put("customers/#{id}",options)
        if response['success']
          return response['results']['customer']
        else
          return response
        end
      end

      # Create a new customer email
      #
      #   @option options [String]
      #   @example Return extended information for 12345
      #     Desk.create_customer_email(12345, "foo@example.com")
      # @format :json
      # @authenticated true
      # @see http://dev.desk.com/docs/api/customers/emails/create
      def create_customer_email(id, email, *args)
        options = args.last.is_a?(Hash) ? args.pop : {}
        options.merge!({:email => email})
        response = post("customers/#{id}/emails",options)
        if response['success']
          return response['results']['email']
        else
          return response
        end
      end

      # Update a customer's email
      #
      #   @option options [String]
      #   @example Return extended information for 12345
      #     Desk.update_customer_email(12345, 12345, :email => "foo@example.com")
      #     Desk.update_customer_email(12345, 12345, :customer_contact_type => "work")
      # @format :json
      # @authenticated true
      # @see http://dev.desk.com/docs/api/customers/emails/update
      def update_customer_email(id, email_id, *args)
        options = args.last.is_a?(Hash) ? args.pop : {}
        response = put("customers/#{id}/emails/#{email_id}",options)
        if response['success']
          return response['results']['email']
        else
          return response
        end
      end

      # Create a new customer phone number
      #
      #   @option options [String]
      #   @example Return extended information for 12345
      #     Desk.create_customer_phone(12345, "555-368-7147")
      # @format :json
      # @authenticated true
      # @see http://dev.desk.com/docs/api/customers/phones/create
      def create_customer_phone(id, phone, *args)
        options = args.last.is_a?(Hash) ? args.pop : {}
        options.merge!({:phone => phone})
        response = post("customers/#{id}/phones",options)
        if response['success']
          return response['results']['phone']
        else
          return response
        end
      end

      # Update a customer's phone number
      #
      #   @option options [String]
      #   @example Return extended information for 12345
      #     Desk.update_customer_phone(12345, 12345, :phone => "555-368-7147")
      #     Desk.update_customer_phone(12345, 12345, :customer_contact_type => "work")
      # @format :json
      # @authenticated true
      # @see http://dev.desk.com/docs/api/customers/phones/update
      def update_customer_phone(id, phone_id, *args)
        options = args.last.is_a?(Hash) ? args.pop : {}
        response = put("customers/#{id}/phones/#{phone_id}",options)
        if response['success']
          return response['results']['phone']
        else
          return response
        end
      end
    end
  end
end