httpx/sig/plugins/multipart.rbs

module HTTPX
  module Plugins
    module Multipart
      def self.load_dependencies: (singleton(Session)) -> void
      def self.configure: (*untyped) -> void
      def self?.encode: (untyped) -> (Encoder | Transcoder::Form::Encoder)
      def self?.decode: (HTTPX::Response response) -> Transcoder::_Decoder

      type multipart_value = string | Pathname | File | _Reader

      type record_multipart_value = multipart_value |
                                    { content_type: String, filename: String, body: multipart_value } |
                                    { content_type: String, body: multipart_value }

      type multipart_nested_value = multipart_value | _ToAry[multipart_value] | _ToHash[string, multipart_value]

      class Encoder
        include Transcoder::_Encoder
        include _Reader

        def content_type: () -> String

        private

        def initialize: (_Each[[Symbol | string, multipart_nested_value]] multipart_data) -> untyped

        def header_part: (string key, String content_type, String? filename) -> StringIO

        def read_chunks: (String buffer, Integer? length) -> void

        def read_from_part: (Integer? max_length) -> void
      end

      class Decoder
        BOUNDARY_RE: Regexp

        @state: :idle | :part_header | :part_body | :parse_boundary | :done
        @buffer: String
        @parts: Hash[String, untyped]
        @boundary: String
        @intermediate_boundary: String

        def call: (Response response, untyped) -> Hash[String, untyped]

        private

        def initialize: (Response response) -> void

        def parse: () -> void

        def get_filename: (String head) -> String?
      end

      class FilePart #  < SimpleDelegator
        attr_reader original_filename: String
        attr_reader content_type: String

        # @file: Tempfile

        # private

        def initialize: (String filename, String content_type) -> void
      end

      module Part
        def self?.call: (multipart_nested_value) -> ([_Reader, String, String?])
      end

      module MimeTypeDetector
        def self?.call: (::IO file, ?String filename) -> String?
      end
    end
  end
end