lithic 0.1.0.pre.alpha.6 → 0.1.0.pre.alpha.8

data/lib/lithic/internal/util.rb

@@ -2,8 +2,6 @@
 
 module Lithic
   module Internal
-    # rubocop:disable Metrics/ModuleLength
-
     # @api private
     module Util
       # @api private
@@ -124,7 +122,7 @@ module Lithic
         # @return [Hash{Object=>Object}, Object]
         def coerce_hash(input)
           case input
-          in NilClass | Array | Set | Enumerator
+          in NilClass | Array | Set | Enumerator | StringIO | IO
             input
           else
             input.respond_to?(:to_h) ? input.to_h : input
@@ -154,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>]
         #
@@ -350,10 +348,47 @@ module Lithic
         end
       end
 
+      # @api private
+      class SerializationAdapter
+        # @return [Pathname, IO]
+        attr_reader :inner
+
+        # @param a [Object]
+        #
+        # @return [String]
+        def to_json(*a) = (inner.is_a?(IO) ? inner.read : inner.read(binmode: true)).to_json(*a)
+
+        # @param a [Object]
+        #
+        # @return [String]
+        def to_yaml(*a) = (inner.is_a?(IO) ? inner.read : inner.read(binmode: true)).to_yaml(*a)
+
+        # @api private
+        #
+        # @param inner [Pathname, IO]
+        def initialize(inner) = @inner = inner
+      end
+
       # @api private
       #
       # An adapter that satisfies the IO interface required by `::IO.copy_stream`
       class ReadIOAdapter
+        # @api private
+        #
+        # @return [Boolean, nil]
+        def close? = @closing
+
+        # @api private
+        def close
+          case @stream
+          in Enumerator
+            Lithic::Internal::Util.close_fused!(@stream)
+          in IO if close?
+            @stream.close
+          else
+          end
+        end
+
         # @api private
         #
         # @param max_len [Integer, nil]
@@ -398,12 +433,21 @@ module Lithic
 
         # @api private
         #
-        # @param stream [String, IO, StringIO, Enumerable<String>]
+        # @param src [String, Pathname, StringIO, Enumerable<String>]
         # @param blk [Proc]
         #
         # @yieldparam [String]
-        def initialize(stream, &blk)
-          @stream = stream.is_a?(String) ? StringIO.new(stream) : stream
+        def initialize(src, &blk)
+          @stream =
+            case src
+            in String
+              StringIO.new(src)
+            in Pathname
+              @closing = true
+              src.open(binmode: true)
+            else
+              src
+            end
           @buf = String.new.b
           @blk = blk
         end
@@ -416,9 +460,10 @@ module Lithic
         # @return [Enumerable<String>]
         def writable_enum(&blk)
           Enumerator.new do |y|
+            buf = String.new.b
             y.define_singleton_method(:write) do
-              self << _1.clone
-              _1.bytesize
+              self << buf.replace(_1)
+              buf.bytesize
             end
 
             blk.call(y)
@@ -433,29 +478,39 @@ module Lithic
         # @param boundary [String]
         # @param key [Symbol, String]
         # @param val [Object]
-        private def write_multipart_chunk(y, boundary:, key:, val:)
+        # @param closing [Array<Proc>]
+        private def write_multipart_chunk(y, boundary:, key:, val:, closing:)
+          val = val.inner if val.is_a?(Lithic::Internal::Util::SerializationAdapter)
+
           y << "--#{boundary}\r\n"
           y << "Content-Disposition: form-data"
           unless key.nil?
             name = ERB::Util.url_encode(key.to_s)
             y << "; name=\"#{name}\""
           end
-          if val.is_a?(IO)
+          case val
+          in Pathname | IO
             filename = ERB::Util.url_encode(File.basename(val.to_path))
             y << "; filename=\"#{filename}\""
+          else
           end
           y << "\r\n"
           case val
+          in Pathname
+            y << "Content-Type: application/octet-stream\r\n\r\n"
+            io = val.open(binmode: true)
+            closing << io.method(:close)
+            IO.copy_stream(io, y)
           in IO
             y << "Content-Type: application/octet-stream\r\n\r\n"
-            IO.copy_stream(val.tap(&:rewind), y)
+            IO.copy_stream(val, y)
           in StringIO
             y << "Content-Type: application/octet-stream\r\n\r\n"
             y << val.string
           in String
             y << "Content-Type: application/octet-stream\r\n\r\n"
             y << val.to_s
-          in true | false | Integer | Float | Symbol
+          in _ if primitive?(val)
             y << "Content-Type: text/plain\r\n\r\n"
             y << val.to_s
           else
@@ -473,6 +528,7 @@ module Lithic
         private def encode_multipart_streaming(body)
           boundary = SecureRandom.urlsafe_base64(60)
 
+          closing = []
           strio = writable_enum do |y|
             case body
             in Hash
@@ -480,19 +536,20 @@ module Lithic
                 case val
                 in Array if val.all? { primitive?(_1) }
                   val.each do |v|
-                    write_multipart_chunk(y, boundary: boundary, key: key, val: v)
+                    write_multipart_chunk(y, boundary: boundary, key: key, val: v, closing: closing)
                   end
                 else
-                  write_multipart_chunk(y, boundary: boundary, key: key, val: val)
+                  write_multipart_chunk(y, boundary: boundary, key: key, val: val, closing: closing)
                 end
               end
             else
-              write_multipart_chunk(y, boundary: boundary, key: nil, val: body)
+              write_multipart_chunk(y, boundary: boundary, key: nil, val: body, closing: closing)
             end
             y << "--#{boundary}--\r\n"
           end
 
-          [boundary, strio]
+          fused_io = fused_enum(strio) { closing.each(&:call) }
+          [boundary, fused_io]
         end
 
         # @api private
@@ -503,21 +560,21 @@ module Lithic
         # @return [Object]
         def encode_content(headers, body)
           content_type = headers["content-type"]
+          body = body.inner if body.is_a?(Lithic::Internal::Util::SerializationAdapter)
+
           case [content_type, body]
-          in [%r{^application/(?:vnd\.api\+)?json}, _] unless body.nil?
+          in [%r{^application/(?:vnd\.api\+)?json}, Hash | Array | -> { primitive?(_1) }]
             [headers, JSON.fast_generate(body)]
-          in [%r{^application/(?:x-)?jsonl}, Enumerable]
+          in [%r{^application/(?:x-)?jsonl}, Enumerable] unless body.is_a?(StringIO) || body.is_a?(IO)
             [headers, body.lazy.map { JSON.fast_generate(_1) }]
-          in [%r{^multipart/form-data}, Hash | IO | StringIO]
+          in [%r{^multipart/form-data}, Hash | Pathname | StringIO | IO]
             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]
+          in [_, StringIO]
+            [headers, body.string]
           else
             [headers, body]
           end
@@ -694,7 +751,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