finch-api 0.1.0.pre.alpha.4 → 0.1.0.pre.alpha.5

data/sig/finch-api/type/union.rbs

@@ -0,0 +1,37 @@
+module FinchAPI
+  module Type
+    module Union
+      include FinchAPI::Type::Converter
+
+      private def self.known_variants: -> ::Array[[Symbol?, (^-> FinchAPI::Type::Converter::input)]]
+
+      def self.derefed_variants: -> ::Array[[Symbol?, top]]
+
+      def self.variants: -> ::Array[top]
+
+      private def self.discriminator: (Symbol property) -> void
+
+      private def self.variant: (
+        Symbol
+        | ::Hash[Symbol, top]
+        | ^-> FinchAPI::Type::Converter::input
+        | FinchAPI::Type::Converter::input key,
+        ?::Hash[Symbol, top]
+        | ^-> FinchAPI::Type::Converter::input
+        | FinchAPI::Type::Converter::input spec
+      ) -> void
+
+      private def self.resolve_variant: (
+        top value
+      ) -> FinchAPI::Type::Converter::input?
+
+      def ===: (top other) -> bool
+
+      def ==: (top other) -> bool
+
+      def coerce: (top value, state: FinchAPI::Type::Converter::state) -> top
+
+      def dump: (top value) -> top
+    end
+  end
+end

data/sig/finch-api/type/unknown.rbs

@@ -0,0 +1,18 @@
+module FinchAPI
+  module Type
+    class Unknown
+      extend FinchAPI::Type::Converter
+
+      def self.===: (top other) -> bool
+
+      def self.==: (top other) -> bool
+
+      def self.coerce: (
+        top value,
+        state: FinchAPI::Type::Converter::state
+      ) -> top
+
+      def self.dump: (top value) -> top
+    end
+  end
+end

data/sig/finch-api/type.rbs

@@ -0,0 +1,22 @@
+module FinchAPI
+  class Unknown = FinchAPI::Type::Unknown
+
+  class BooleanModel = FinchAPI::Type::BooleanModel
+
+  module Enum = FinchAPI::Type::Enum
+
+  module Union = FinchAPI::Type::Union
+
+  class ArrayOf = FinchAPI::Type::ArrayOf
+
+  class HashOf = FinchAPI::Type::HashOf
+
+  class BaseModel = FinchAPI::Type::BaseModel
+
+  type request_parameters = FinchAPI::Type::request_parameters
+
+  module RequestParameters = FinchAPI::Type::RequestParameters
+
+  module Type
+  end
+end

data/sig/finch-api/version.rbs

@@ -1,3 +1,3 @@
 module FinchAPI
-  VERSION: "0.1.0-alpha.3"
+  VERSION: "0.1.0-alpha.4"
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: finch-api
 version: !ruby/object:Gem::Version
-  version: 0.1.0.pre.alpha.4
+  version: 0.1.0.pre.alpha.5
 platform: ruby
 authors:
 - Finch
@@ -33,9 +33,6 @@ extra_rdoc_files:
 files:
 - README.md
 - lib/finch-api.rb
-- lib/finch-api/base_client.rb
-- lib/finch-api/base_model.rb
-- lib/finch-api/base_page.rb
 - lib/finch-api/client.rb
 - lib/finch-api/errors.rb
 - lib/finch-api/individuals_page.rb
@@ -153,7 +150,6 @@ files:
 - lib/finch-api/models/sandbox/payment_create_response.rb
 - lib/finch-api/models/webhook_event.rb
 - lib/finch-api/page.rb
-- lib/finch-api/pooled_net_requester.rb
 - lib/finch-api/request_options.rb
 - lib/finch-api/resources/access_tokens.rb
 - lib/finch-api/resources/account.rb
@@ -189,12 +185,22 @@ files:
 - lib/finch-api/resources/webhooks.rb
 - lib/finch-api/responses_page.rb
 - lib/finch-api/single_page.rb
+- lib/finch-api/transport/base_client.rb
+- lib/finch-api/transport/pooled_net_requester.rb
+- lib/finch-api/type.rb
+- lib/finch-api/type/array_of.rb
+- lib/finch-api/type/base_model.rb
+- lib/finch-api/type/base_page.rb
+- lib/finch-api/type/boolean_model.rb
+- lib/finch-api/type/converter.rb
+- lib/finch-api/type/enum.rb
+- lib/finch-api/type/hash_of.rb
+- lib/finch-api/type/request_parameters.rb
+- lib/finch-api/type/union.rb
+- lib/finch-api/type/unknown.rb
 - lib/finch-api/util.rb
 - lib/finch-api/version.rb
 - manifest.yaml
-- rbi/lib/finch-api/base_client.rbi
-- rbi/lib/finch-api/base_model.rbi
-- rbi/lib/finch-api/base_page.rbi
 - rbi/lib/finch-api/client.rbi
 - rbi/lib/finch-api/errors.rbi
 - rbi/lib/finch-api/individuals_page.rbi
@@ -312,7 +318,6 @@ files:
 - rbi/lib/finch-api/models/sandbox/payment_create_response.rbi
 - rbi/lib/finch-api/models/webhook_event.rbi
 - rbi/lib/finch-api/page.rbi
-- rbi/lib/finch-api/pooled_net_requester.rbi
 - rbi/lib/finch-api/request_options.rbi
 - rbi/lib/finch-api/resources/access_tokens.rbi
 - rbi/lib/finch-api/resources/account.rbi
@@ -348,11 +353,21 @@ files:
 - rbi/lib/finch-api/resources/webhooks.rbi
 - rbi/lib/finch-api/responses_page.rbi
 - rbi/lib/finch-api/single_page.rbi
+- rbi/lib/finch-api/transport/base_client.rbi
+- rbi/lib/finch-api/transport/pooled_net_requester.rbi
+- rbi/lib/finch-api/type.rbi
+- rbi/lib/finch-api/type/array_of.rbi
+- rbi/lib/finch-api/type/base_model.rbi
+- rbi/lib/finch-api/type/base_page.rbi
+- rbi/lib/finch-api/type/boolean_model.rbi
+- rbi/lib/finch-api/type/converter.rbi
+- rbi/lib/finch-api/type/enum.rbi
+- rbi/lib/finch-api/type/hash_of.rbi
+- rbi/lib/finch-api/type/request_parameters.rbi
+- rbi/lib/finch-api/type/union.rbi
+- rbi/lib/finch-api/type/unknown.rbi
 - rbi/lib/finch-api/util.rbi
 - rbi/lib/finch-api/version.rbi
-- sig/finch-api/base_client.rbs
-- sig/finch-api/base_model.rbs
-- sig/finch-api/base_page.rbs
 - sig/finch-api/client.rbs
 - sig/finch-api/errors.rbs
 - sig/finch-api/individuals_page.rbs
@@ -470,7 +485,6 @@ files:
 - sig/finch-api/models/sandbox/payment_create_response.rbs
 - sig/finch-api/models/webhook_event.rbs
 - sig/finch-api/page.rbs
-- sig/finch-api/pooled_net_requester.rbs
 - sig/finch-api/request_options.rbs
 - sig/finch-api/resources/access_tokens.rbs
 - sig/finch-api/resources/account.rbs
@@ -506,6 +520,19 @@ files:
 - sig/finch-api/resources/webhooks.rbs
 - sig/finch-api/responses_page.rbs
 - sig/finch-api/single_page.rbs
+- sig/finch-api/transport/base_client.rbs
+- sig/finch-api/transport/pooled_net_requester.rbs
+- sig/finch-api/type.rbs
+- sig/finch-api/type/array_of.rbs
+- sig/finch-api/type/base_model.rbs
+- sig/finch-api/type/base_page.rbs
+- sig/finch-api/type/boolean_model.rbs
+- sig/finch-api/type/converter.rbs
+- sig/finch-api/type/enum.rbs
+- sig/finch-api/type/hash_of.rbs
+- sig/finch-api/type/request_parameters.rbs
+- sig/finch-api/type/union.rbs
+- sig/finch-api/type/unknown.rbs
 - sig/finch-api/util.rbs
 - sig/finch-api/version.rbs
 homepage: https://gemdocs.org/gems/finch-api

data/lib/finch-api/base_client.rb

@@ -1,457 +0,0 @@
-# frozen_string_literal: true
-
-module FinchAPI
-  # @api private
-  #
-  # @abstract
-  class BaseClient
-    # from whatwg fetch spec
-    MAX_REDIRECTS = 20
-
-    # rubocop:disable Style/MutableConstant
-    PLATFORM_HEADERS =
-      {
-        "x-stainless-arch" => FinchAPI::Util.arch,
-        "x-stainless-lang" => "ruby",
-        "x-stainless-os" => FinchAPI::Util.os,
-        "x-stainless-package-version" => FinchAPI::VERSION,
-        "x-stainless-runtime" => ::RUBY_ENGINE,
-        "x-stainless-runtime-version" => ::RUBY_ENGINE_VERSION
-      }
-    # rubocop:enable Style/MutableConstant
-
-    class << self
-      # @api private
-      #
-      # @param req [Hash{Symbol=>Object}]
-      #
-      # @raise [ArgumentError]
-      def validate!(req)
-        keys = [:method, :path, :query, :headers, :body, :unwrap, :page, :stream, :model, :options]
-        case req
-        in Hash
-          req.each_key do |k|
-            unless keys.include?(k)
-              raise ArgumentError.new("Request `req` keys must be one of #{keys}, got #{k.inspect}")
-            end
-          end
-        else
-          raise ArgumentError.new("Request `req` must be a Hash or RequestOptions, got #{req.inspect}")
-        end
-      end
-
-      # @api private
-      #
-      # @param status [Integer]
-      # @param headers [Hash{String=>String}, Net::HTTPHeader]
-      #
-      # @return [Boolean]
-      def should_retry?(status, headers:)
-        coerced = FinchAPI::Util.coerce_boolean(headers["x-should-retry"])
-        case [coerced, status]
-        in [true | false, _]
-          coerced
-        in [_, 408 | 409 | 429 | (500..)]
-          # retry on:
-          # 408: timeouts
-          # 409: locks
-          # 429: rate limits
-          # 500+: unknown errors
-          true
-        else
-          false
-        end
-      end
-
-      # @api private
-      #
-      # @param request [Hash{Symbol=>Object}] .
-      #
-      #   @option request [Symbol] :method
-      #
-      #   @option request [URI::Generic] :url
-      #
-      #   @option request [Hash{String=>String}] :headers
-      #
-      #   @option request [Object] :body
-      #
-      #   @option request [Integer] :max_retries
-      #
-      #   @option request [Float] :timeout
-      #
-      # @param status [Integer]
-      #
-      # @param response_headers [Hash{String=>String}, Net::HTTPHeader]
-      #
-      # @return [Hash{Symbol=>Object}]
-      def follow_redirect(request, status:, response_headers:)
-        method, url, headers = request.fetch_values(:method, :url, :headers)
-        location =
-          Kernel.then do
-            URI.join(url, response_headers["location"])
-          rescue ArgumentError
-            message = "Server responded with status #{status} but no valid location header."
-            raise FinchAPI::APIConnectionError.new(url: url, message: message)
-          end
-
-        request = {**request, url: location}
-
-        case [url.scheme, location.scheme]
-        in ["https", "http"]
-          message = "Tried to redirect to a insecure URL"
-          raise FinchAPI::APIConnectionError.new(url: url, message: message)
-        else
-          nil
-        end
-
-        # from whatwg fetch spec
-        case [status, method]
-        in [301 | 302, :post] | [303, _]
-          drop = %w[content-encoding content-language content-length content-location content-type]
-          request = {
-            **request,
-            method: method == :head ? :head : :get,
-            headers: headers.except(*drop),
-            body: nil
-          }
-        else
-        end
-
-        # from undici
-        if FinchAPI::Util.uri_origin(url) != FinchAPI::Util.uri_origin(location)
-          drop = %w[authorization cookie host proxy-authorization]
-          request = {**request, headers: request.fetch(:headers).except(*drop)}
-        end
-
-        request
-      end
-
-      # @api private
-      #
-      # @param status [Integer, FinchAPI::APIConnectionError]
-      # @param stream [Enumerable, nil]
-      def reap_connection!(status, stream:)
-        case status
-        in (..199) | (300..499)
-          stream&.each { next }
-        in FinchAPI::APIConnectionError | (500..)
-          FinchAPI::Util.close_fused!(stream)
-        else
-        end
-      end
-    end
-
-    # @api private
-    # @return [FinchAPI::PooledNetRequester]
-    attr_accessor :requester
-
-    # @api private
-    #
-    # @param base_url [String]
-    # @param timeout [Float]
-    # @param max_retries [Integer]
-    # @param initial_retry_delay [Float]
-    # @param max_retry_delay [Float]
-    # @param headers [Hash{String=>String, Integer, Array<String, Integer, nil>, nil}]
-    # @param idempotency_header [String, nil]
-    def initialize(
-      base_url:,
-      timeout: 0.0,
-      max_retries: 0,
-      initial_retry_delay: 0.0,
-      max_retry_delay: 0.0,
-      headers: {},
-      idempotency_header: nil
-    )
-      @requester = FinchAPI::PooledNetRequester.new
-      @headers = FinchAPI::Util.normalized_headers(
-        self.class::PLATFORM_HEADERS,
-        {
-          "accept" => "application/json",
-          "content-type" => "application/json"
-        },
-        headers
-      )
-      @base_url = FinchAPI::Util.parse_uri(base_url)
-      @idempotency_header = idempotency_header&.to_s&.downcase
-      @max_retries = max_retries
-      @timeout = timeout
-      @initial_retry_delay = initial_retry_delay
-      @max_retry_delay = max_retry_delay
-    end
-
-    # @api private
-    #
-    # @return [Hash{String=>String}]
-    private def auth_headers = {}
-
-    # @api private
-    #
-    # @return [String]
-    private def generate_idempotency_key = "stainless-ruby-retry-#{SecureRandom.uuid}"
-
-    # @api private
-    #
-    # @param req [Hash{Symbol=>Object}] .
-    #
-    #   @option req [Symbol] :method
-    #
-    #   @option req [String, Array<String>] :path
-    #
-    #   @option req [Hash{String=>Array<String>, String, nil}, nil] :query
-    #
-    #   @option req [Hash{String=>String, Integer, Array<String, Integer, nil>, nil}, nil] :headers
-    #
-    #   @option req [Object, nil] :body
-    #
-    #   @option req [Symbol, nil] :unwrap
-    #
-    #   @option req [Class, nil] :page
-    #
-    #   @option req [Class, nil] :stream
-    #
-    #   @option req [FinchAPI::Converter, Class, nil] :model
-    #
-    # @param opts [Hash{Symbol=>Object}] .
-    #
-    #   @option opts [String, nil] :idempotency_key
-    #
-    #   @option opts [Hash{String=>Array<String>, String, nil}, nil] :extra_query
-    #
-    #   @option opts [Hash{String=>String, nil}, nil] :extra_headers
-    #
-    #   @option opts [Object, nil] :extra_body
-    #
-    #   @option opts [Integer, nil] :max_retries
-    #
-    #   @option opts [Float, nil] :timeout
-    #
-    # @return [Hash{Symbol=>Object}]
-    private def build_request(req, opts)
-      method, uninterpolated_path = req.fetch_values(:method, :path)
-
-      path = FinchAPI::Util.interpolate_path(uninterpolated_path)
-
-      query = FinchAPI::Util.deep_merge(req[:query].to_h, opts[:extra_query].to_h)
-
-      headers = FinchAPI::Util.normalized_headers(
-        @headers,
-        auth_headers,
-        req[:headers].to_h,
-        opts[:extra_headers].to_h
-      )
-
-      if @idempotency_header &&
-         !headers.key?(@idempotency_header) &&
-         !Net::HTTP::IDEMPOTENT_METHODS_.include?(method.to_s.upcase)
-        headers[@idempotency_header] = opts.fetch(:idempotency_key) { generate_idempotency_key }
-      end
-
-      unless headers.key?("x-stainless-retry-count")
-        headers["x-stainless-retry-count"] = "0"
-      end
-
-      timeout = opts.fetch(:timeout, @timeout).to_f.clamp((0..))
-      unless headers.key?("x-stainless-timeout") || timeout.zero?
-        headers["x-stainless-timeout"] = timeout.to_s
-      end
-
-      headers.reject! { |_, v| v.to_s.empty? }
-
-      body =
-        case method
-        in :get | :head | :options | :trace
-          nil
-        else
-          FinchAPI::Util.deep_merge(*[req[:body], opts[:extra_body]].compact)
-        end
-
-      headers, encoded = FinchAPI::Util.encode_content(headers, body)
-      {
-        method: method,
-        url: FinchAPI::Util.join_parsed_uri(@base_url, {**req, path: path, query: query}),
-        headers: headers,
-        body: encoded,
-        max_retries: opts.fetch(:max_retries, @max_retries),
-        timeout: timeout
-      }
-    end
-
-    # @api private
-    #
-    # @param headers [Hash{String=>String}]
-    # @param retry_count [Integer]
-    #
-    # @return [Float]
-    private def retry_delay(headers, retry_count:)
-      # Non-standard extension
-      span = Float(headers["retry-after-ms"], exception: false)&.then { _1 / 1000 }
-      return span if span
-
-      retry_header = headers["retry-after"]
-      return span if (span = Float(retry_header, exception: false))
-
-      span = retry_header&.then do
-        Time.httpdate(_1) - Time.now
-      rescue ArgumentError
-        nil
-      end
-      return span if span
-
-      scale = retry_count**2
-      jitter = 1 - (0.25 * rand)
-      (@initial_retry_delay * scale * jitter).clamp(0, @max_retry_delay)
-    end
-
-    # @api private
-    #
-    # @param request [Hash{Symbol=>Object}] .
-    #
-    #   @option request [Symbol] :method
-    #
-    #   @option request [URI::Generic] :url
-    #
-    #   @option request [Hash{String=>String}] :headers
-    #
-    #   @option request [Object] :body
-    #
-    #   @option request [Integer] :max_retries
-    #
-    #   @option request [Float] :timeout
-    #
-    # @param redirect_count [Integer]
-    #
-    # @param retry_count [Integer]
-    #
-    # @param send_retry_header [Boolean]
-    #
-    # @raise [FinchAPI::APIError]
-    # @return [Array(Integer, Net::HTTPResponse, Enumerable)]
-    private def send_request(request, redirect_count:, retry_count:, send_retry_header:)
-      url, headers, max_retries, timeout = request.fetch_values(:url, :headers, :max_retries, :timeout)
-      input = {**request.except(:timeout), deadline: FinchAPI::Util.monotonic_secs + timeout}
-
-      if send_retry_header
-        headers["x-stainless-retry-count"] = retry_count.to_s
-      end
-
-      begin
-        status, response, stream = @requester.execute(input)
-      rescue FinchAPI::APIConnectionError => e
-        status = e
-      end
-
-      case status
-      in ..299
-        [status, response, stream]
-      in 300..399 if redirect_count >= self.class::MAX_REDIRECTS
-        self.class.reap_connection!(status, stream: stream)
-
-        message = "Failed to complete the request within #{self.class::MAX_REDIRECTS} redirects."
-        raise FinchAPI::APIConnectionError.new(url: url, message: message)
-      in 300..399
-        self.class.reap_connection!(status, stream: stream)
-
-        request = self.class.follow_redirect(request, status: status, response_headers: response)
-        send_request(
-          request,
-          redirect_count: redirect_count + 1,
-          retry_count: retry_count,
-          send_retry_header: send_retry_header
-        )
-      in FinchAPI::APIConnectionError if retry_count >= max_retries
-        raise status
-      in (400..) if retry_count >= max_retries || !self.class.should_retry?(status, headers: response)
-        decoded = Kernel.then do
-          FinchAPI::Util.decode_content(response, stream: stream, suppress_error: true)
-        ensure
-          self.class.reap_connection!(status, stream: stream)
-        end
-
-        raise FinchAPI::APIStatusError.for(
-          url: url,
-          status: status,
-          body: decoded,
-          request: nil,
-          response: response
-        )
-      in (400..) | FinchAPI::APIConnectionError
-        self.class.reap_connection!(status, stream: stream)
-
-        delay = retry_delay(response, retry_count: retry_count)
-        sleep(delay)
-
-        send_request(
-          request,
-          redirect_count: redirect_count,
-          retry_count: retry_count + 1,
-          send_retry_header: send_retry_header
-        )
-      end
-    end
-
-    # Execute the request specified by `req`. This is the method that all resource
-    #   methods call into.
-    #
-    # @param req [Hash{Symbol=>Object}] .
-    #
-    #   @option req [Symbol] :method
-    #
-    #   @option req [String, Array<String>] :path
-    #
-    #   @option req [Hash{String=>Array<String>, String, nil}, nil] :query
-    #
-    #   @option req [Hash{String=>String, Integer, Array<String, Integer, nil>, nil}, nil] :headers
-    #
-    #   @option req [Object, nil] :body
-    #
-    #   @option req [Symbol, nil] :unwrap
-    #
-    #   @option req [Class, nil] :page
-    #
-    #   @option req [Class, nil] :stream
-    #
-    #   @option req [FinchAPI::Converter, Class, nil] :model
-    #
-    #   @option req [FinchAPI::RequestOptions, Hash{Symbol=>Object}, nil] :options
-    #
-    # @raise [FinchAPI::APIError]
-    # @return [Object]
-    def request(req)
-      self.class.validate!(req)
-      model = req.fetch(:model) { FinchAPI::Unknown }
-      opts = req[:options].to_h
-      FinchAPI::RequestOptions.validate!(opts)
-      request = build_request(req.except(:options), opts)
-      url = request.fetch(:url)
-
-      # Don't send the current retry count in the headers if the caller modified the header defaults.
-      send_retry_header = request.fetch(:headers)["x-stainless-retry-count"] == "0"
-      status, response, stream = send_request(
-        request,
-        redirect_count: 0,
-        retry_count: 0,
-        send_retry_header: send_retry_header
-      )
-
-      decoded = FinchAPI::Util.decode_content(response, stream: stream)
-      case req
-      in { stream: Class => st }
-        st.new(model: model, url: url, status: status, response: response, stream: decoded)
-      in { page: Class => page }
-        page.new(client: self, req: req, headers: response, page_data: decoded)
-      else
-        unwrapped = FinchAPI::Util.dig(decoded, req[:unwrap])
-        FinchAPI::Converter.coerce(model, unwrapped)
-      end
-    end
-
-    # @return [String]
-    def inspect
-      # rubocop:disable Layout/LineLength
-      base_url = FinchAPI::Util.unparse_uri(@base_url)
-      "#<#{self.class.name}:0x#{object_id.to_s(16)} base_url=#{base_url} max_retries=#{@max_retries} timeout=#{@timeout}>"
-      # rubocop:enable Layout/LineLength
-    end
-  end
-end