module HTTPX
  class HTTPProxyError < Error
  end

  module Plugins
    module Proxy
      Error: singleton(HTTPProxyError)
      PROXY_ERRORS: Array[singleton(StandardError)]

      class Parameters
        attr_reader uri: URI::Generic
        attr_reader username: string?
        attr_reader password: string?

        def authenticated?: () -> boolish
        def token_authentication: () -> String?

        def ==: (untyped) -> bool

        private

        def initialize: (uri: generic_uri, ?username: string, ?password: string) -> untyped
      end

      def self.configure: (singleton(Session)) -> void

      type proxyParam = Parameters | Hash[Symbol, untyped]

      interface _ProxyOptions
        def proxy: () -> proxyParam?
      end

      def self.extra_options: (Options) -> (Options & _ProxyOptions)

      module InstanceMethods
        private

        def proxy_uris: (uri, Options & _ProxyOptions) -> { uri: (URI | string), username: string, password: string }
                      | (uri, Options & _ProxyOptions) -> { uri: (URI | string) }
                      | (uri, Options & _ProxyOptions) -> nil
      end
    end

    type sessionProxy = Session & Proxy::InstanceMethods
  end
end