lithic 0.1.0.pre.alpha.5 → 0.1.0.pre.alpha.7

data/lib/lithic/internal/util.rb

@@ -2,8 +2,6 @@
 
 module Lithic
   module Internal
-    # rubocop:disable Metrics/ModuleLength
-
     # @api private
     module Util
       # @api private
@@ -61,7 +59,7 @@ module Lithic
         # @return [Boolean]
         def primitive?(input)
           case input
-          in true | false | Integer | Float | Symbol | String
+          in true | false | Numeric | Symbol | String
             true
           else
             false
@@ -70,13 +68,11 @@ module Lithic
 
         # @api private
         #
-        # @param input [Object]
+        # @param input [String, Boolean]
         #
         # @return [Boolean, Object]
         def coerce_boolean(input)
           case input.is_a?(String) ? input.downcase : input
-          in Numeric
-            input.nonzero?
           in "true"
             true
           in "false"
@@ -88,7 +84,7 @@ module Lithic
 
         # @api private
         #
-        # @param input [Object]
+        # @param input [String, Boolean]
         #
         # @raise [ArgumentError]
         # @return [Boolean, nil]
@@ -103,34 +99,20 @@ module Lithic
 
         # @api private
         #
-        # @param input [Object]
+        # @param input [String, Integer]
         #
         # @return [Integer, Object]
         def coerce_integer(input)
-          case input
-          in true
-            1
-          in false
-            0
-          else
-            Integer(input, exception: false) || input
-          end
+          Integer(input, exception: false) || input
         end
 
         # @api private
         #
-        # @param input [Object]
+        # @param input [String, Integer, Float]
         #
         # @return [Float, Object]
         def coerce_float(input)
-          case input
-          in true
-            1.0
-          in false
-            0.0
-          else
-            Float(input, exception: false) || input
-          end
+          Float(input, exception: false) || input
         end
 
         # @api private
@@ -159,12 +141,7 @@ module Lithic
         private def deep_merge_lr(lhs, rhs, concat: false)
           case [lhs, rhs, concat]
           in [Hash, Hash, _]
-            rhs_cleaned = rhs.reject { _2 == Lithic::Internal::OMIT }
-            lhs
-              .reject { |key, _| rhs[key] == Lithic::Internal::OMIT }
-              .merge(rhs_cleaned) do |_, old_val, new_val|
-                deep_merge_lr(old_val, new_val, concat: concat)
-              end
+            lhs.merge(rhs) { deep_merge_lr(_2, _3, concat: concat) }
           in [Array, Array, true]
             lhs.concat(rhs)
           else
@@ -175,7 +152,7 @@ module Lithic
         # @api private
         #
         # Recursively merge one hash with another. If the values at a given key are not
-        #   both hashes, just take the new value.
+        # both hashes, just take the new value.
         #
         # @param values [Array<Object>]
         #
@@ -362,7 +339,7 @@ module Lithic
             value =
               case val
               in Array
-                val.map { _1.to_s.strip }.join(", ")
+                val.filter_map { _1&.to_s&.strip }.join(", ")
               else
                 val&.to_s&.strip
               end
@@ -419,7 +396,7 @@ module Lithic
 
         # @api private
         #
-        # @param stream [String, IO, StringIO, Enumerable]
+        # @param stream [String, IO, StringIO, Enumerable<String>]
         # @param blk [Proc]
         #
         # @yieldparam [String]
@@ -434,7 +411,7 @@ module Lithic
         # @param blk [Proc]
         #
         # @yieldparam [Enumerator::Yielder]
-        # @return [Enumerable]
+        # @return [Enumerable<String>]
         def writable_enum(&blk)
           Enumerator.new do |y|
             y.define_singleton_method(:write) do
@@ -469,7 +446,7 @@ module Lithic
           case val
           in IO
             y << "Content-Type: application/octet-stream\r\n\r\n"
-            IO.copy_stream(val, y)
+            IO.copy_stream(val.tap(&:rewind), y)
           in StringIO
             y << "Content-Type: application/octet-stream\r\n\r\n"
             y << val.string
@@ -490,7 +467,7 @@ module Lithic
         #
         # @param body [Object]
         #
-        # @return [Array(String, Enumerable)]
+        # @return [Array(String, Enumerable<String>)]
         private def encode_multipart_streaming(body)
           boundary = SecureRandom.urlsafe_base64(60)
 
@@ -525,7 +502,7 @@ module Lithic
         def encode_content(headers, body)
           content_type = headers["content-type"]
           case [content_type, body]
-          in [%r{^application/(?:vnd\.api\+)?json}, Hash | Array]
+          in [%r{^application/(?:vnd\.api\+)?json}, _] unless body.nil?
             [headers, JSON.fast_generate(body)]
           in [%r{^application/(?:x-)?jsonl}, Enumerable]
             [headers, body.lazy.map { JSON.fast_generate(_1) }]
@@ -533,8 +510,12 @@ module Lithic
             boundary, strio = encode_multipart_streaming(body)
             headers = {**headers, "content-type" => "#{content_type}; boundary=#{boundary}"}
             [headers, strio]
+          in [_, IO]
+            [headers, body.tap(&:rewind)]
           in [_, StringIO]
             [headers, body.string]
+          in [_, Symbol | Numeric]
+            [headers, body.to_s]
           else
             [headers, body]
           end
@@ -543,7 +524,7 @@ module Lithic
         # @api private
         #
         # @param headers [Hash{String=>String}, Net::HTTPHeader]
-        # @param stream [Enumerable]
+        # @param stream [Enumerable<String>]
         # @param suppress_error [Boolean]
         #
         # @raise [JSON::ParserError]
@@ -580,11 +561,11 @@ module Lithic
         #
         # https://doc.rust-lang.org/std/iter/trait.FusedIterator.html
         #
-        # @param enum [Enumerable]
+        # @param enum [Enumerable<Object>]
         # @param external [Boolean]
         # @param close [Proc]
         #
-        # @return [Enumerable]
+        # @return [Enumerable<Object>]
         def fused_enum(enum, external: false, &close)
           fused = false
           iter = Enumerator.new do |y|
@@ -610,7 +591,7 @@ module Lithic
 
         # @api private
         #
-        # @param enum [Enumerable, nil]
+        # @param enum [Enumerable<Object>, nil]
         def close_fused!(enum)
           return unless enum.is_a?(Enumerator)
 
@@ -621,11 +602,11 @@ module Lithic
 
         # @api private
         #
-        # @param enum [Enumerable, nil]
+        # @param enum [Enumerable<Object>, nil]
         # @param blk [Proc]
         #
         # @yieldparam [Enumerator::Yielder]
-        # @return [Enumerable]
+        # @return [Enumerable<Object>]
         def chain_fused(enum, &blk)
           iter = Enumerator.new { blk.call(_1) }
           fused_enum(iter) { close_fused!(enum) }
@@ -635,9 +616,9 @@ module Lithic
       class << self
         # @api private
         #
-        # @param enum [Enumerable]
+        # @param enum [Enumerable<String>]
         #
-        # @return [Enumerable]
+        # @return [Enumerable<String>]
         def decode_lines(enum)
           re = /(\r\n|\r|\n)/
           buffer = String.new.b
@@ -671,9 +652,9 @@ module Lithic
         #
         # https://html.spec.whatwg.org/multipage/server-sent-events.html#parsing-an-event-stream
         #
-        # @param lines [Enumerable]
+        # @param lines [Enumerable<String>]
         #
-        # @return [Hash{Symbol=>Object}]
+        # @return [Enumerable<Hash{Symbol=>Object}>]
         def decode_sse(lines)
           # rubocop:disable Metrics/BlockLength
           chain_fused(lines) do |y|
@@ -711,7 +692,5 @@ module Lithic
         end
       end
     end
-
-    # rubocop:enable Metrics/ModuleLength
   end
 end

data/lib/lithic/models/account.rb

@@ -6,25 +6,25 @@ module Lithic
     class Account < Lithic::Internal::Type::BaseModel
       # @!attribute token
       #   Globally unique identifier for the account. This is the same as the
-      #     account_token returned by the enroll endpoint. If using this parameter, do not
-      #     include pagination.
+      #   account_token returned by the enroll endpoint. If using this parameter, do not
+      #   include pagination.
       #
       #   @return [String]
       required :token, String
 
       # @!attribute created
       #   Timestamp of when the account was created. For accounts created before
-      #     2023-05-11, this field will be null.
+      #   2023-05-11, this field will be null.
       #
       #   @return [Time, nil]
       required :created, Time, nil?: true
 
       # @!attribute spend_limit
       #   Spend limit information for the user containing the daily, monthly, and lifetime
-      #     spend limit of the account. Any charges to a card owned by this account will be
-      #     declined once their transaction volume has surpassed the value in the applicable
-      #     time limit (rolling). A lifetime limit of 0 indicates that the lifetime limit
-      #     feature is disabled.
+      #   spend limit of the account. Any charges to a card owned by this account will be
+      #   declined once their transaction volume has surpassed the value in the applicable
+      #   time limit (rolling). A lifetime limit of 0 indicates that the lifetime limit
+      #   feature is disabled.
       #
       #   @return [Lithic::Models::Account::SpendLimit]
       required :spend_limit, -> { Lithic::Models::Account::SpendLimit }
@@ -32,15 +32,15 @@ module Lithic
       # @!attribute state
       #   Account state:
       #
-      #     - `ACTIVE` - Account is able to transact and create new cards.
-      #     - `PAUSED` - Account will not be able to transact or create new cards. It can be
-      #       set back to `ACTIVE`.
-      #     - `CLOSED` - Account will not be able to transact or create new cards. `CLOSED`
-      #       accounts are also unable to be transitioned to `ACTIVE` or `PAUSED` states.
-      #       `CLOSED` accounts result from failing to pass KYB/KYC or Lithic closing for
-      #       risk/compliance reasons. Please contact
-      #       [support@lithic.com](mailto:support@lithic.com) if you believe this was in
-      #       error.
+      #   - `ACTIVE` - Account is able to transact and create new cards.
+      #   - `PAUSED` - Account will not be able to transact or create new cards. It can be
+      #     set back to `ACTIVE`.
+      #   - `CLOSED` - Account will not be able to transact or create new cards. `CLOSED`
+      #     accounts are also unable to be transitioned to `ACTIVE` or `PAUSED` states.
+      #     `CLOSED` accounts result from failing to pass KYB/KYC or Lithic closing for
+      #     risk/compliance reasons. Please contact
+      #     [support@lithic.com](mailto:support@lithic.com) if you believe this was in
+      #     error.
       #
       #   @return [Symbol, Lithic::Models::Account::State]
       required :state, enum: -> { Lithic::Models::Account::State }
@@ -56,9 +56,9 @@ module Lithic
 
       # @!attribute [r] auth_rule_tokens
       #   List of identifiers for the Auth Rule(s) that are applied on the account. This
-      #     field is deprecated and will no longer be populated in the `account_holder`
-      #     object. The key will be removed from the schema in a future release. Use the
-      #     `/auth_rules` endpoints to fetch Auth Rule information instead.
+      #   field is deprecated and will no longer be populated in the `account_holder`
+      #   object. The key will be removed from the schema in a future release. Use the
+      #   `/auth_rules` endpoints to fetch Auth Rule information instead.
       #
       #   @return [Array<String>, nil]
       optional :auth_rule_tokens, Lithic::Internal::Type::ArrayOf[String]
@@ -134,10 +134,10 @@ module Lithic
 
         # @!parse
         #   # Spend limit information for the user containing the daily, monthly, and lifetime
-        #   #   spend limit of the account. Any charges to a card owned by this account will be
-        #   #   declined once their transaction volume has surpassed the value in the applicable
-        #   #   time limit (rolling). A lifetime limit of 0 indicates that the lifetime limit
-        #   #   feature is disabled.
+        #   # spend limit of the account. Any charges to a card owned by this account will be
+        #   # declined once their transaction volume has surpassed the value in the applicable
+        #   # time limit (rolling). A lifetime limit of 0 indicates that the lifetime limit
+        #   # feature is disabled.
         #   #
         #   # @param daily [Integer]
         #   # @param lifetime [Integer]
@@ -150,15 +150,15 @@ module Lithic
 
       # Account state:
       #
-      #   - `ACTIVE` - Account is able to transact and create new cards.
-      #   - `PAUSED` - Account will not be able to transact or create new cards. It can be
-      #     set back to `ACTIVE`.
-      #   - `CLOSED` - Account will not be able to transact or create new cards. `CLOSED`
-      #     accounts are also unable to be transitioned to `ACTIVE` or `PAUSED` states.
-      #     `CLOSED` accounts result from failing to pass KYB/KYC or Lithic closing for
-      #     risk/compliance reasons. Please contact
-      #     [support@lithic.com](mailto:support@lithic.com) if you believe this was in
-      #     error.
+      # - `ACTIVE` - Account is able to transact and create new cards.
+      # - `PAUSED` - Account will not be able to transact or create new cards. It can be
+      #   set back to `ACTIVE`.
+      # - `CLOSED` - Account will not be able to transact or create new cards. `CLOSED`
+      #   accounts are also unable to be transitioned to `ACTIVE` or `PAUSED` states.
+      #   `CLOSED` accounts result from failing to pass KYB/KYC or Lithic closing for
+      #   risk/compliance reasons. Please contact
+      #   [support@lithic.com](mailto:support@lithic.com) if you believe this was in
+      #   error.
       #
       # @see Lithic::Models::Account#state
       module State
@@ -185,8 +185,8 @@ module Lithic
 
         # @!attribute business_account_token
         #   Only applicable for customers using the KYC-Exempt workflow to enroll authorized
-        #     users of businesses. Account_token of the enrolled business associated with an
-        #     enrolled AUTHORIZED_USER individual.
+        #   users of businesses. Account_token of the enrolled business associated with an
+        #   enrolled AUTHORIZED_USER individual.
         #
         #   @return [String]
         required :business_account_token, String
@@ -238,15 +238,15 @@ module Lithic
 
         # @!attribute postal_code
         #   Valid postal code. Only USA postal codes (ZIP codes) are currently supported,
-        #     entered as a five-digit postal code or nine-digit postal code (ZIP+4) using the
-        #     format 12345-1234.
+        #   entered as a five-digit postal code or nine-digit postal code (ZIP+4) using the
+        #   format 12345-1234.
         #
         #   @return [String]
         required :postal_code, String
 
         # @!attribute state
         #   Valid state code. Only USA state codes are currently supported, entered in
-        #     uppercase ISO 3166-2 two-character format.
+        #   uppercase ISO 3166-2 two-character format.
         #
         #   @return [String]
         required :state, String