# Public: The Plaid namespace.
module Plaid
  # Public: The main interface to Plaid API.
  class Client
    # Public: All possible environments for the client to use.
    ENVIRONMENTS = %i[sandbox development production].freeze

    # Public: The current environment in use (one of ENVIRONMENTS).
    attr_reader :env

    # Public: The client ID.
    attr_reader :client_id

    # Public: Construct a Client instance
    #
    # Optionally takes a block to allow overriding the default Faraday
    # connection options.
    #
    # env        - The Symbol (:sandbox, :development, :production)
    # client_id  - The String Plaid account client ID to authenticate requests
    # secret     - The String Plaid account secret to authenticate requests
    def initialize(env:, client_id:, secret:, &block)
      @env        = env.to_sym
      @api_host   = api_host
      @client_id  = client_id
      @secret     = secret

      create_connection(&block)
    end

    extend SubproductMixin

    ##
    # :attr_reader:
    # Public: The Plaid::Accounts product accessor.
    subproduct :accounts

    ##
    # :attr_reader:
    # Public: The Plaid::Auth product accessor.
    subproduct :auth

    ##
    # :attr_reader:
    # Public: The Plaid::AssetReport product accessor.
    subproduct :asset_report

    ##
    # :attr_reader:
    # Public: The Plaid::Categories product accessor.
    subproduct :categories

    ##
    # :attr_reader:
    # Public: The Plaid::CreditDetails product accessor.
    subproduct :credit_details

    ##
    # :attr_reader:
    # Public: The Plaid::DepositSwitch product accessor.
    subproduct :deposit_switch

    ##
    # :attr_reader:
    # Public: The Plaid::Identity product accessor.
    subproduct :identity

    ##
    # :attr_reader:
    # Public: The Plaid::Income product accessor.
    subproduct :income

    ##
    # :attr_reader:
    # Public: The Plaid::Institutions product accessor.
    subproduct :institutions

    ##
    # :attr_reader:
    # Public: The Plaid::Item product accessor.
    subproduct :item

    ##
    # :attr_reader:
    # Public: The Plaid::Liabilities product accessor.
    subproduct :liabilities

    ##
    # :attr_reader:
    # Public: The Plaid::Processor product accessor.
    subproduct :processor

    ##
    # :attr_reader:
    # Public: The Plaid::Sandbox product accessor.
    subproduct :sandbox

    ##
    # :attr_reader:
    # Public: The Plaid::Transactions product accessor.
    subproduct :transactions

    ##
    # :attr_reader:
    # Public: The Plaid::Investments product accessor.
    subproduct :investments

    ##
    # :attr_reader:
    # Public: The Plaid::PaymentInitiation product accessor.
    subproduct :payment_initiation

    ##
    # :attr_reader:
    # Public: The Plaid::Webhooks endpoint accessor.
    subproduct :webhooks

    ##
    ## :attr_reader:
    ## Public: The Plaid::LinkToken endpoint accessor.
    subproduct :link_token

    # Public: Make a post request
    #
    # path    - Path or URL to make the request to
    # payload - The payload or data to post
    #
    # Returns the resulting parsed JSON of the request
    def post(path, payload)
      @connection.post(path, payload).body
    end

    # Public: Make a post request with appended authentication fields
    #
    # path    - Path or URL to make the request to
    # payload - The payload or data to post
    #
    # Returns the resulting parsed JSON of the request
    def post_with_auth(path, payload)
      @connection.post(
        path,
        payload.merge(client_id: @client_id, secret: @secret)
      ).body
    end

    # Public: Set Plaid defaults on the Faraday connection.
    #
    # builder - The Faraday builder object.
    def self.build_default_connection(builder)
      builder.options[:timeout] = Plaid::Middleware::NETWORK_TIMEOUT
      builder.headers = Plaid::Middleware::NETWORK_HEADERS
      builder.request :json
      builder.use Plaid::Middleware
      builder.response :json, content_type: /\bjson$/
      builder.adapter Faraday.default_adapter
    end

    protected

    # Internal: subproduct-generated methods depend on client method.
    def client
      self
    end

    # Internal: Gets the API hostname for given environment.
    #
    # env - The Symbol (:sandbox, :development, :production)
    #
    # Returns a String representing the environment URL.
    # Raises ArgumentError if environment is unknown.
    def api_host
      unless ENVIRONMENTS.include?(@env)
        raise ArgumentError,
              "Invalid value for env (#{@env.inspect}): must be one of " +
              ENVIRONMENTS.map(&:inspect) * ', '
      end

      "https://#{@env}.plaid.com"
    end

    # Internal: Initializes a new Plaid connection object via Faraday.
    #
    # Optionally takes a block to allow overriding the defaults.
    def create_connection
      @connection = Faraday.new(url: @api_host) do |builder|
        block_given? ? yield(builder) : Client.build_default_connection(builder)
      end
    end
  end
end