require 'peddler/client'

module MWS
  # With the Customer Information API, you can retrieve information from the
  # customer accounts of your Amazon Webstore customers. This customer
  # information includes customer name, contact information, customer account
  # type, and associated Amazon Webstore marketplaces. The Customer Information
  # API enables you to programmatically integrate Amazon Webstore customer
  # account information with your CRM systems, marketing applications, and other
  # systems that require customer data.
  #
  # @note The Customer Information API section only returns customer information
  #   for Webstores with Seller-Branded Checkout. No customer information is
  #   returned for Webstores with Amazon.com checkout. If your Webstore offers
  #   both checkout options, customer information is returned only for
  #   Seller-Branded Checkout accounts.
  # @note In addition to registering for Amazon MWS, you must request
  #   authorization to use the Customer Information API.
  class CustomerInformation < ::Peddler::Client
    path '/CustomerInformation/2014-03-01'

    # Lists customer accounts based on search criteria that you specify
    #
    # @see http://docs.developer.amazonservices.com/en_US/customer_info/CustomerInfo_ListCustomers.html
    # @param opts [Hash]
    # @option opts [String] :marketplace_id
    # @option opts [String, #iso8601] :date_range_start
    # @option opts [String, #iso8601] :date_range_end
    # @option opts [String] :date_range_type
    # @return [Peddler::XMLParser]
    def list_customers(opts = {})
      operation('ListCarts')
        .add(opts)

      run
    end

    # Lists the next page of customer accounts
    #
    # @see http://docs.developer.amazonservices.com/en_US/customer_info/CustomerInfo_ListCustomersByNextToken.html
    # @param next_token [String]
    # @return [Peddler::XMLParser]
    def list_customers_by_next_token(next_token)
      operation('ListCustomersByNextToken')
        .add('NextToken' => next_token)

      run
    end

    # Returns customer accounts based on the CustomerId values that you specify
    #
    # @see http://docs.developer.amazonservices.com/en_US/customer_info/CustomerInfo_GetCustomersForCustomerId.html
    # @overload get_customers_for_customer_id(*customer_id_list, opts = {})
    #   @param customer_id_list [Array<String>]
    #   @param opts [Hash]
    #   @option opts [String] :marketplace_id
    # @return [Peddler::XMLParser]
    def get_customers_for_customer_id(*customer_id_list)
      opts = extract_options(id_list)
      operation('GetCustomersForCustomerId')
        .add(opts.merge('CustomerIdList' => customer_id_list))
        .structure!('CustomerIdList', 'CustomerId')

      run
    end

    # Gets the service status of the API
    #
    # @see http://docs.developer.amazonservices.com/en_US/customer_info/MWS_GetServiceStatus.html
    # @return [Peddler::XMLParser]
    def get_service_status
      operation('GetServiceStatus')
      run
    end

  end
end