lithic 0.1.0.pre.alpha.1 → 0.1.0.pre.alpha.3

data/lib/lithic/type/union.rb

@@ -0,0 +1,196 @@
+# frozen_string_literal: true
+
+module Lithic
+  module Type
+    # @api private
+    #
+    # @example
+    #   # `account_holder_update_response` is a `Lithic::Models::AccountHolderUpdateResponse`
+    #   case account_holder_update_response
+    #   when Lithic::Models::AccountHolderUpdateResponse::KYBKYCPatchResponse
+    #     puts(account_holder_update_response.token)
+    #   when Lithic::Models::AccountHolderUpdateResponse::PatchResponse
+    #     puts(account_holder_update_response.address)
+    #   else
+    #     puts(account_holder_update_response)
+    #   end
+    module Union
+      include Lithic::Type::Converter
+
+      # @api private
+      #
+      # All of the specified variant info for this union.
+      #
+      # @return [Array<Array(Symbol, Proc)>]
+      private def known_variants = (@known_variants ||= [])
+
+      # @api private
+      #
+      # @return [Array<Array(Symbol, Object)>]
+      protected def derefed_variants
+        @known_variants.map { |key, variant_fn| [key, variant_fn.call] }
+      end
+
+      # All of the specified variants for this union.
+      #
+      # @return [Array<Object>]
+      def variants = derefed_variants.map(&:last)
+
+      # @api private
+      #
+      # @param property [Symbol]
+      private def discriminator(property)
+        case property
+        in Symbol
+          @discriminator = property
+        end
+      end
+
+      # @api private
+      #
+      # @param key [Symbol, Hash{Symbol=>Object}, Proc, Lithic::Type::Converter, Class]
+      #
+      # @param spec [Hash{Symbol=>Object}, Proc, Lithic::Type::Converter, Class] .
+      #
+      #   @option spec [NilClass, TrueClass, FalseClass, Integer, Float, Symbol] :const
+      #
+      #   @option spec [Proc] :enum
+      #
+      #   @option spec [Proc] :union
+      #
+      #   @option spec [Boolean] :"nil?"
+      private def variant(key, spec = nil)
+        variant_info =
+          case key
+          in Symbol
+            [key, Lithic::Type::Converter.type_info(spec)]
+          in Proc | Lithic::Type::Converter | Class | Hash
+            [nil, Lithic::Type::Converter.type_info(key)]
+          end
+
+        known_variants << variant_info
+      end
+
+      # @api private
+      #
+      # @param value [Object]
+      #
+      # @return [Lithic::Type::Converter, Class, nil]
+      private def resolve_variant(value)
+        case [@discriminator, value]
+        in [_, Lithic::BaseModel]
+          value.class
+        in [Symbol, Hash]
+          key = value.fetch(@discriminator) do
+            value.fetch(@discriminator.to_s, Lithic::Util::OMIT)
+          end
+
+          return nil if key == Lithic::Util::OMIT
+
+          key = key.to_sym if key.is_a?(String)
+          known_variants.find { |k,| k == key }&.last&.call
+        else
+          nil
+        end
+      end
+
+      # rubocop:disable Style/HashEachMethods
+      # rubocop:disable Style/CaseEquality
+
+      # @param other [Object]
+      #
+      # @return [Boolean]
+      def ===(other)
+        known_variants.any? do |_, variant_fn|
+          variant_fn.call === other
+        end
+      end
+
+      # @param other [Object]
+      #
+      # @return [Boolean]
+      def ==(other)
+        # rubocop:disable Layout/LineLength
+        other.is_a?(Module) && other.singleton_class <= Lithic::Union && other.derefed_variants == derefed_variants
+        # rubocop:enable Layout/LineLength
+      end
+
+      # @api private
+      #
+      # @param value [Object]
+      #
+      # @param state [Hash{Symbol=>Object}] .
+      #
+      #   @option state [Boolean, :strong] :strictness
+      #
+      #   @option state [Hash{Symbol=>Object}] :exactness
+      #
+      #   @option state [Integer] :branched
+      #
+      # @return [Object]
+      def coerce(value, state:)
+        if (target = resolve_variant(value))
+          return Lithic::Type::Converter.coerce(target, value, state: state)
+        end
+
+        strictness = state.fetch(:strictness)
+        exactness = state.fetch(:exactness)
+        state[:strictness] = strictness == :strong ? true : strictness
+
+        alternatives = []
+        known_variants.each do |_, variant_fn|
+          target = variant_fn.call
+          exact = state[:exactness] = {yes: 0, no: 0, maybe: 0}
+          state[:branched] += 1
+
+          coerced = Lithic::Type::Converter.coerce(target, value, state: state)
+          yes, no, maybe = exact.values
+          if (no + maybe).zero? || (!strictness && yes.positive?)
+            exact.each { exactness[_1] += _2 }
+            state[:exactness] = exactness
+            return coerced
+          elsif maybe.positive?
+            alternatives << [[-yes, -maybe, no], exact, coerced]
+          end
+        end
+
+        case alternatives.sort_by(&:first)
+        in []
+          exactness[:no] += 1
+          if strictness == :strong
+            message = "no possible conversion of #{value.class} into a variant of #{target.inspect}"
+            raise ArgumentError.new(message)
+          end
+          value
+        in [[_, exact, coerced], *]
+          exact.each { exactness[_1] += _2 }
+          coerced
+        end
+          .tap { state[:exactness] = exactness }
+      ensure
+        state[:strictness] = strictness
+      end
+
+      # @api private
+      #
+      # @param value [Object]
+      #
+      # @return [Object]
+      def dump(value)
+        if (target = resolve_variant(value))
+          return Lithic::Type::Converter.dump(target, value)
+        end
+
+        known_variants.each do
+          target = _2.call
+          return Lithic::Type::Converter.dump(target, value) if target === value
+        end
+
+        super
+      end
+
+      # rubocop:enable Style/CaseEquality
+      # rubocop:enable Style/HashEachMethods
+    end
+  end
+end

data/lib/lithic/type/unknown.rb

@@ -0,0 +1,56 @@
+# frozen_string_literal: true
+
+module Lithic
+  module Type
+    # @api private
+    #
+    # @abstract
+    #
+    # When we don't know what to expect for the value.
+    class Unknown
+      extend Lithic::Type::Converter
+
+      # rubocop:disable Lint/UnusedMethodArgument
+
+      # @param other [Object]
+      #
+      # @return [Boolean]
+      def self.===(other) = true
+
+      # @param other [Object]
+      #
+      # @return [Boolean]
+      def self.==(other) = other.is_a?(Class) && other <= Lithic::Unknown
+
+      class << self
+        # @api private
+        #
+        # @param value [Object]
+        #
+        # @param state [Hash{Symbol=>Object}] .
+        #
+        #   @option state [Boolean, :strong] :strictness
+        #
+        #   @option state [Hash{Symbol=>Object}] :exactness
+        #
+        #   @option state [Integer] :branched
+        #
+        # @return [Object]
+        def coerce(value, state:)
+          state.fetch(:exactness)[:yes] += 1
+          value
+        end
+
+        # @!parse
+        #   # @api private
+        #   #
+        #   # @param value [Object]
+        #   #
+        #   # @return [Object]
+        #   def dump(value) = super
+      end
+
+      # rubocop:enable Lint/UnusedMethodArgument
+    end
+  end
+end

data/lib/lithic/type.rb

@@ -0,0 +1,23 @@
+# frozen_string_literal: true
+
+module Lithic
+  Unknown = Lithic::Type::Unknown
+
+  BooleanModel = Lithic::Type::BooleanModel
+
+  Enum = Lithic::Type::Enum
+
+  Union = Lithic::Type::Union
+
+  ArrayOf = Lithic::Type::ArrayOf
+
+  HashOf = Lithic::Type::HashOf
+
+  BaseModel = Lithic::Type::BaseModel
+
+  RequestParameters = Lithic::Type::RequestParameters
+
+  # This module contains various type declarations.
+  module Type
+  end
+end

data/lib/lithic/util.rb

@@ -75,7 +75,7 @@ module Lithic
       def coerce_boolean(input)
         case input.is_a?(String) ? input.downcase : input
         in Numeric
-          !input.zero?
+          input.nonzero?
         in "true"
           true
         in "false"
@@ -165,14 +165,12 @@ module Lithic
       private def deep_merge_lr(lhs, rhs, concat: false)
         case [lhs, rhs, concat]
         in [Hash, Hash, _]
-          # rubocop:disable Style/YodaCondition
-          rhs_cleaned = rhs.reject { |_, val| OMIT == val }
+          rhs_cleaned = rhs.reject { _2 == Lithic::Util::OMIT }
           lhs
-            .reject { |key, _| OMIT == rhs[key] }
+            .reject { |key, _| rhs[key] == Lithic::Util::OMIT }
             .merge(rhs_cleaned) do |_, old_val, new_val|
               deep_merge_lr(old_val, new_val, concat: concat)
             end
-          # rubocop:enable Style/YodaCondition
         in [Array, Array, true]
           lhs.concat(rhs)
         else
@@ -255,9 +253,9 @@ module Lithic
           path
         in []
           ""
-        in [String, *interpolations]
+        in [String => p, *interpolations]
           encoded = interpolations.map { ERB::Util.url_encode(_1) }
-          path.first % encoded
+          format(p, *encoded)
         end
       end
     end

data/lib/lithic/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Lithic
-  VERSION = "0.1.0-alpha.1"
+  VERSION = "0.1.0-alpha.3"
 end

data/lib/lithic.rb

@@ -1,21 +1,7 @@
 # frozen_string_literal: true
 
-# We already ship the preferred sorbet manifests in the package itself.
-# `tapioca` currently does not offer us a way to opt out of unnecessary compilation.
-if Object.const_defined?(:Tapioca) && caller_locations.any? { _1.path.end_with?("tapioca/cli.rb") }
-  Warning.warn(
-    <<~WARN
-      \n
-      ⚠️ skipped loading of "lithic" gem under `tapioca`.
-
-      This message is normal and expected if you are running a `tapioca` command, and does not impact `.rbi` generation.
-      \n
-    WARN
-  )
-  return
-end
-
 # Standard libraries.
+require "English"
 require "cgi"
 require "date"
 require "erb"
@@ -30,19 +16,42 @@ require "stringio"
 require "time"
 require "uri"
 
+# We already ship the preferred sorbet manifests in the package itself.
+# `tapioca` currently does not offer us a way to opt out of unnecessary compilation.
+if Object.const_defined?(:Tapioca) && caller.chain([$PROGRAM_NAME]).chain(ARGV).grep(/tapioca/)
+  Warning.warn(
+    <<~WARN
+      \n
+      ⚠️ skipped loading of "lithic" gem under `tapioca`.
+
+      This message is normal and expected if you are running a `tapioca` command, and does not impact `.rbi` generation.
+      \n
+    WARN
+  )
+  return
+end
+
 # Gems.
 require "connection_pool"
 
 # Package files.
 require_relative "lithic/version"
 require_relative "lithic/util"
-require_relative "lithic/extern"
-require_relative "lithic/base_model"
-require_relative "lithic/base_page"
+require_relative "lithic/type/converter"
+require_relative "lithic/type/unknown"
+require_relative "lithic/type/boolean_model"
+require_relative "lithic/type/enum"
+require_relative "lithic/type/union"
+require_relative "lithic/type/array_of"
+require_relative "lithic/type/hash_of"
+require_relative "lithic/type/base_model"
+require_relative "lithic/type/base_page"
+require_relative "lithic/type/request_parameters"
+require_relative "lithic/type"
 require_relative "lithic/request_options"
 require_relative "lithic/errors"
-require_relative "lithic/base_client"
-require_relative "lithic/pooled_net_requester"
+require_relative "lithic/transport/base_client"
+require_relative "lithic/transport/pooled_net_requester"
 require_relative "lithic/client"
 require_relative "lithic/cursor_page"
 require_relative "lithic/single_page"

data/manifest.yaml

@@ -1,4 +1,5 @@
 dependencies:
+  - English
   - cgi
   - date
   - erb

data/rbi/lib/lithic/client.rbi

@@ -1,7 +1,7 @@
 # typed: strong
 
 module Lithic
-  class Client < Lithic::BaseClient
+  class Client < Lithic::Transport::BaseClient
     DEFAULT_MAX_RETRIES = 2
 
     DEFAULT_TIMEOUT_IN_SECONDS = T.let(60.0, Float)

data/rbi/lib/lithic/cursor_page.rbi

@@ -2,7 +2,7 @@
 
 module Lithic
   class CursorPage
-    include Lithic::BasePage
+    include Lithic::Type::BasePage
 
     Elem = type_member
 

data/rbi/lib/lithic/models/account_holder_create_params.rbi

@@ -3,7 +3,7 @@
 module Lithic
   module Models
     class AccountHolderCreateParams < Lithic::BaseModel
-      extend Lithic::RequestParameters::Converter
+      extend Lithic::Type::RequestParameters::Converter
       include Lithic::RequestParameters
 
       # List of all entities with >25% ownership in the company. If no entity or

data/rbi/lib/lithic/models/account_holder_create_response.rbi

@@ -58,7 +58,15 @@ module Lithic
         )
           .returns(T.attached_class)
       end
-      def self.new(token:, account_token:, status:, status_reasons:, created: nil, external_id: nil, required_documents: nil)
+      def self.new(
+        token:,
+        account_token:,
+        status:,
+        status_reasons:,
+        created: nil,
+        external_id: nil,
+        required_documents: nil
+      )
       end
 
       sig do

data/rbi/lib/lithic/models/account_holder_list_documents_params.rbi

@@ -3,7 +3,7 @@
 module Lithic
   module Models
     class AccountHolderListDocumentsParams < Lithic::BaseModel
-      extend Lithic::RequestParameters::Converter
+      extend Lithic::Type::RequestParameters::Converter
       include Lithic::RequestParameters
 
       sig do

data/rbi/lib/lithic/models/account_holder_list_params.rbi

@@ -3,7 +3,7 @@
 module Lithic
   module Models
     class AccountHolderListParams < Lithic::BaseModel
-      extend Lithic::RequestParameters::Converter
+      extend Lithic::Type::RequestParameters::Converter
       include Lithic::RequestParameters
 
       # Date string in RFC 3339 format. Only entries created after the specified time

data/rbi/lib/lithic/models/account_holder_retrieve_document_params.rbi

@@ -3,7 +3,7 @@
 module Lithic
   module Models
     class AccountHolderRetrieveDocumentParams < Lithic::BaseModel
-      extend Lithic::RequestParameters::Converter
+      extend Lithic::Type::RequestParameters::Converter
       include Lithic::RequestParameters
 
       sig { returns(String) }

data/rbi/lib/lithic/models/account_holder_retrieve_params.rbi

@@ -3,7 +3,7 @@
 module Lithic
   module Models
     class AccountHolderRetrieveParams < Lithic::BaseModel
-      extend Lithic::RequestParameters::Converter
+      extend Lithic::Type::RequestParameters::Converter
       include Lithic::RequestParameters
 
       sig do

data/rbi/lib/lithic/models/account_holder_simulate_enrollment_document_review_params.rbi

@@ -3,7 +3,7 @@
 module Lithic
   module Models
     class AccountHolderSimulateEnrollmentDocumentReviewParams < Lithic::BaseModel
-      extend Lithic::RequestParameters::Converter
+      extend Lithic::Type::RequestParameters::Converter
       include Lithic::RequestParameters
 
       # The account holder document upload which to perform the simulation upon.

data/rbi/lib/lithic/models/account_holder_simulate_enrollment_review_params.rbi

@@ -3,7 +3,7 @@
 module Lithic
   module Models
     class AccountHolderSimulateEnrollmentReviewParams < Lithic::BaseModel
-      extend Lithic::RequestParameters::Converter
+      extend Lithic::Type::RequestParameters::Converter
       include Lithic::RequestParameters
 
       # The account holder which to perform the simulation upon.

data/rbi/lib/lithic/models/account_holder_update_params.rbi

@@ -3,7 +3,7 @@
 module Lithic
   module Models
     class AccountHolderUpdateParams < Lithic::BaseModel
-      extend Lithic::RequestParameters::Converter
+      extend Lithic::Type::RequestParameters::Converter
       include Lithic::RequestParameters
 
       # List of all entities with >25% ownership in the company. If no entity or

data/rbi/lib/lithic/models/account_holder_upload_document_params.rbi

@@ -3,7 +3,7 @@
 module Lithic
   module Models
     class AccountHolderUploadDocumentParams < Lithic::BaseModel
-      extend Lithic::RequestParameters::Converter
+      extend Lithic::Type::RequestParameters::Converter
       include Lithic::RequestParameters
 
       # The type of document to upload

data/rbi/lib/lithic/models/account_list_params.rbi

@@ -3,7 +3,7 @@
 module Lithic
   module Models
     class AccountListParams < Lithic::BaseModel
-      extend Lithic::RequestParameters::Converter
+      extend Lithic::Type::RequestParameters::Converter
       include Lithic::RequestParameters
 
       # Date string in RFC 3339 format. Only entries created after the specified time
@@ -56,7 +56,14 @@ module Lithic
         )
           .returns(T.attached_class)
       end
-      def self.new(begin_: nil, end_: nil, ending_before: nil, page_size: nil, starting_after: nil, request_options: {})
+      def self.new(
+        begin_: nil,
+        end_: nil,
+        ending_before: nil,
+        page_size: nil,
+        starting_after: nil,
+        request_options: {}
+      )
       end
 
       sig do

data/rbi/lib/lithic/models/account_retrieve_params.rbi

@@ -3,7 +3,7 @@
 module Lithic
   module Models
     class AccountRetrieveParams < Lithic::BaseModel
-      extend Lithic::RequestParameters::Converter
+      extend Lithic::Type::RequestParameters::Converter
       include Lithic::RequestParameters
 
       sig do

data/rbi/lib/lithic/models/account_retrieve_spend_limits_params.rbi

@@ -3,7 +3,7 @@
 module Lithic
   module Models
     class AccountRetrieveSpendLimitsParams < Lithic::BaseModel
-      extend Lithic::RequestParameters::Converter
+      extend Lithic::Type::RequestParameters::Converter
       include Lithic::RequestParameters
 
       sig do

data/rbi/lib/lithic/models/account_update_params.rbi

@@ -3,7 +3,7 @@
 module Lithic
   module Models
     class AccountUpdateParams < Lithic::BaseModel
-      extend Lithic::RequestParameters::Converter
+      extend Lithic::Type::RequestParameters::Converter
       include Lithic::RequestParameters
 
       # Amount (in cents) for the account's daily spend limit (e.g. 100000 would be a

data/rbi/lib/lithic/models/aggregate_balance_list_params.rbi

@@ -3,7 +3,7 @@
 module Lithic
   module Models
     class AggregateBalanceListParams < Lithic::BaseModel
-      extend Lithic::RequestParameters::Converter
+      extend Lithic::Type::RequestParameters::Converter
       include Lithic::RequestParameters
 
       # Get the aggregate balance for a given Financial Account type.

data/rbi/lib/lithic/models/auth_rules/auth_rule_condition.rbi

@@ -123,11 +123,11 @@ module Lithic
         module Value
           extend Lithic::Union
 
-          StringArray = T.let(Lithic::ArrayOf[String], Lithic::Converter)
-
           sig { override.returns([String, Integer, T::Array[String]]) }
           def self.variants
           end
+
+          StringArray = T.let(Lithic::ArrayOf[String], Lithic::Type::Converter)
         end
       end
     end

data/rbi/lib/lithic/models/auth_rules/v2/backtest_create_params.rbi

@@ -5,7 +5,7 @@ module Lithic
     module AuthRules
       module V2
         class BacktestCreateParams < Lithic::BaseModel
-          extend Lithic::RequestParameters::Converter
+          extend Lithic::Type::RequestParameters::Converter
           include Lithic::RequestParameters
 
           # The end time of the backtest.

data/rbi/lib/lithic/models/auth_rules/v2/backtest_retrieve_params.rbi

@@ -5,7 +5,7 @@ module Lithic
     module AuthRules
       module V2
         class BacktestRetrieveParams < Lithic::BaseModel
-          extend Lithic::RequestParameters::Converter
+          extend Lithic::Type::RequestParameters::Converter
           include Lithic::RequestParameters
 
           sig { returns(String) }

data/rbi/lib/lithic/models/auth_rules/v2_apply_params.rbi

@@ -4,7 +4,7 @@ module Lithic
   module Models
     module AuthRules
       class V2ApplyParams < Lithic::BaseModel
-        extend Lithic::RequestParameters::Converter
+        extend Lithic::Type::RequestParameters::Converter
         include Lithic::RequestParameters
 
         # Account tokens to which the Auth Rule applies.
@@ -36,7 +36,13 @@ module Lithic
           )
             .returns(T.attached_class)
         end
-        def self.new(account_tokens:, card_tokens:, program_level:, excluded_card_tokens: nil, request_options: {})
+        def self.new(
+          account_tokens:,
+          card_tokens:,
+          program_level:,
+          excluded_card_tokens: nil,
+          request_options: {}
+        )
         end
 
         sig do

data/rbi/lib/lithic/models/auth_rules/v2_create_params.rbi

@@ -4,7 +4,7 @@ module Lithic
   module Models
     module AuthRules
       class V2CreateParams < Lithic::BaseModel
-        extend Lithic::RequestParameters::Converter
+        extend Lithic::Type::RequestParameters::Converter
         include Lithic::RequestParameters
 
         # Account tokens to which the Auth Rule applies.

data/rbi/lib/lithic/models/auth_rules/v2_delete_params.rbi

@@ -4,7 +4,7 @@ module Lithic
   module Models
     module AuthRules
       class V2DeleteParams < Lithic::BaseModel
-        extend Lithic::RequestParameters::Converter
+        extend Lithic::Type::RequestParameters::Converter
         include Lithic::RequestParameters
 
         sig do