require 'hyperclient/link'
require 'faraday_middleware'
require_relative '../faraday/connection'

module Hyperclient
  # Public: Exception that is raised when trying to modify an
  # already initialized connection.
  class ConnectionAlreadyInitializedError < StandardError
    # Public: Returns a String with the exception message.
    def message
      'The connection has already been initialized.'
    end
  end

  # Public: The EntryPoint is the main public API for Hyperclient. It is used to
  # initialize an API client and setup the configuration.
  #
  # Examples
  #
  #  client = Hyperclient::EntryPoint.new('http://my.api.org')
  #
  #  client = Hyperclient::EntryPoint.new('http://my.api.org') do |entry_point|
  #    entry_point.connection(default: true) do |conn|
  #      conn.use Faraday::Request::OAuth
  #    end
  #    entry_point.headers['Access-Token'] = 'token'
  #  end
  #
  class EntryPoint < Link
    extend Forwardable
    # Public: Delegates common methods to be used with the Faraday connection.
    def_delegators :connection, :basic_auth, :digest_auth, :token_auth, :headers, :headers=, :params, :params=

    # Public: Initializes an EntryPoint.
    #
    # url    - A String with the entry point of your API.
    def initialize(url, &_block)
      @link = { 'href' => url }
      @entry_point = self
      yield self if block_given?
    end

    # Public: A Faraday connection to use as a HTTP client.
    #
    # options    - A Hash containing additional options.
    #
    #  default   - Set to true to reuse default Faraday connection options.
    #
    # Returns a Faraday::Connection.
    def connection(options = { default: true }, &block)
      if block_given?
        fail ConnectionAlreadyInitializedError if @connection
        if options[:default]
          @faraday_block = lambda do |conn|
            default_faraday_block.call conn
            block.call conn
          end
        else
          @faraday_block = block
        end
      else
        @connection ||= Faraday.new(_url, { headers: headers }, &faraday_block)
      end
    end

    # Public: Set headers.
    #
    # value    - A Hash containing headers to include with every API request.
    def headers=(value)
      fail ConnectionAlreadyInitializedError if @connection
      @headers = value
    end

    # Public: Headers included with every API request.
    #
    # Returns a Hash.
    def headers
      return @connection.headers if @connection
      @headers ||= default_headers
    end

    # Public: Faraday block used with every API request.
    #
    # Returns a Proc.
    def faraday_block
      @faraday_block ||= default_faraday_block
    end

    # Public: Set a Faraday block to use with every API request.
    #
    # value    - A Proc accepting a Faraday::Connection.
    def faraday_block=(value)
      fail ConnectionAlreadyInitializedError if @connection
      @faraday_block = value
    end

    private

    # Internal: Returns a block to initialize the Faraday connection. The
    # default block includes a middleware to encode requests as JSON, a
    # response middleware to parse JSON responses and sets the adapter as
    # NetHttp.
    #
    # These middleware can always be changed by accessing the Faraday
    # connection.
    #
    # Returns a block.
    def default_faraday_block
      lambda do |conn|
        conn.use Faraday::Response::RaiseError
        conn.use FaradayMiddleware::FollowRedirects
        conn.request :json
        conn.response :json, content_type: /\bjson$/
        conn.adapter :net_http
      end
    end

    # Internal: Returns the default headers to initialize the Faraday connection.
    # The default headers et the Content-Type and Accept to application/json.
    #
    # Returns a Hash.
    def default_headers
      { 'Content-Type' => 'application/json', 'Accept' => 'application/json' }
    end
  end
end