lithic 0.1.0.pre.alpha.2 → 0.1.0.pre.alpha.4

data/lib/lithic/resources/transactions.rb

@@ -12,17 +12,18 @@ module Lithic
       # Get a specific card transaction. All amounts are in the smallest unit of their
       #   respective currency (e.g., cents for USD).
       #
-      # @param transaction_token [String] Globally unique identifier for the transaction.
+      # @overload retrieve(transaction_token, request_options: {})
       #
-      # @param params [Lithic::Models::TransactionRetrieveParams, Hash{Symbol=>Object}] .
-      #
-      #   @option params [Lithic::RequestOptions, Hash{Symbol=>Object}, nil] :request_options
+      # @param transaction_token [String]
+      # @param request_options [Lithic::RequestOptions, Hash{Symbol=>Object}, nil]
       #
       # @return [Lithic::Models::Transaction]
+      #
+      # @see Lithic::Models::TransactionRetrieveParams
       def retrieve(transaction_token, params = {})
         @client.request(
           method: :get,
-          path: ["v1/transactions/%0s", transaction_token],
+          path: ["v1/transactions/%1$s", transaction_token],
           model: Lithic::Models::Transaction,
           options: params[:request_options]
         )
@@ -31,34 +32,22 @@ module Lithic
       # List card transactions. All amounts are in the smallest unit of their respective
       #   currency (e.g., cents for USD) and inclusive of any acquirer fees.
       #
-      # @param params [Lithic::Models::TransactionListParams, Hash{Symbol=>Object}] .
-      #
-      #   @option params [String] :account_token Filters for transactions associated with a specific account.
-      #
-      #   @option params [Time] :begin_ Date string in RFC 3339 format. Only entries created after the specified time
-      #     will be included. UTC time zone.
-      #
-      #   @option params [String] :card_token Filters for transactions associated with a specific card.
-      #
-      #   @option params [Time] :end_ Date string in RFC 3339 format. Only entries created before the specified time
-      #     will be included. UTC time zone.
-      #
-      #   @option params [String] :ending_before A cursor representing an item's token before which a page of results should end.
-      #     Used to retrieve the previous page of results before this item.
+      # @overload list(account_token: nil, begin_: nil, card_token: nil, end_: nil, ending_before: nil, page_size: nil, result: nil, starting_after: nil, status: nil, request_options: {})
       #
-      #   @option params [Integer] :page_size Page size (for pagination).
-      #
-      #   @option params [Symbol, Lithic::Models::TransactionListParams::Result] :result Filters for transactions using transaction result field. Can filter by
-      #     `APPROVED`, and `DECLINED`.
-      #
-      #   @option params [String] :starting_after A cursor representing an item's token after which a page of results should
-      #     begin. Used to retrieve the next page of results after this item.
-      #
-      #   @option params [Symbol, Lithic::Models::TransactionListParams::Status] :status Filters for transactions using transaction status field.
-      #
-      #   @option params [Lithic::RequestOptions, Hash{Symbol=>Object}, nil] :request_options
+      # @param account_token [String]
+      # @param begin_ [Time]
+      # @param card_token [String]
+      # @param end_ [Time]
+      # @param ending_before [String]
+      # @param page_size [Integer]
+      # @param result [Symbol, Lithic::Models::TransactionListParams::Result]
+      # @param starting_after [String]
+      # @param status [Symbol, Lithic::Models::TransactionListParams::Status]
+      # @param request_options [Lithic::RequestOptions, Hash{Symbol=>Object}, nil]
       #
       # @return [Lithic::CursorPage<Lithic::Models::Transaction>]
+      #
+      # @see Lithic::Models::TransactionListParams
       def list(params = {})
         parsed, options = Lithic::Models::TransactionListParams.dump_request(params)
         @client.request(
@@ -73,17 +62,18 @@ module Lithic
 
       # Expire authorization
       #
-      # @param transaction_token [String] The token of the transaction to expire.
-      #
-      # @param params [Lithic::Models::TransactionExpireAuthorizationParams, Hash{Symbol=>Object}] .
+      # @overload expire_authorization(transaction_token, request_options: {})
       #
-      #   @option params [Lithic::RequestOptions, Hash{Symbol=>Object}, nil] :request_options
+      # @param transaction_token [String]
+      # @param request_options [Lithic::RequestOptions, Hash{Symbol=>Object}, nil]
       #
       # @return [nil]
+      #
+      # @see Lithic::Models::TransactionExpireAuthorizationParams
       def expire_authorization(transaction_token, params = {})
         @client.request(
           method: :post,
-          path: ["v1/transactions/%0s/expire_authorization", transaction_token],
+          path: ["v1/transactions/%1$s/expire_authorization", transaction_token],
           model: NilClass,
           options: params[:request_options]
         )
@@ -98,56 +88,23 @@ module Lithic
       #   [update account](https://docs.lithic.com/reference/patchaccountbytoken)
       #   endpoint.
       #
-      # @param params [Lithic::Models::TransactionSimulateAuthorizationParams, Hash{Symbol=>Object}] .
-      #
-      #   @option params [Integer] :amount Amount (in cents) to authorize. For credit authorizations and financial credit
-      #     authorizations, any value entered will be converted into a negative amount in
-      #     the simulated transaction. For example, entering 100 in this field will result
-      #     in a -100 amount in the transaction. For balance inquiries, this field must be
-      #     set to 0.
-      #
-      #   @option params [String] :descriptor Merchant descriptor.
-      #
-      #   @option params [String] :pan Sixteen digit card number.
-      #
-      #   @option params [String] :mcc Merchant category code for the transaction to be simulated. A four-digit number
-      #     listed in ISO 18245. Supported merchant category codes can be found
-      #     [here](https://docs.lithic.com/docs/transactions#merchant-category-codes-mccs).
-      #
-      #   @option params [String] :merchant_acceptor_id Unique identifier to identify the payment card acceptor.
-      #
-      #   @option params [Integer] :merchant_amount Amount of the transaction to be simulated in currency specified in
-      #     merchant_currency, including any acquirer fees.
+      # @overload simulate_authorization(amount:, descriptor:, pan:, mcc: nil, merchant_acceptor_id: nil, merchant_amount: nil, merchant_currency: nil, partial_approval_capable: nil, pin: nil, status: nil, request_options: {})
       #
-      #   @option params [String] :merchant_currency 3-character alphabetic ISO 4217 currency code. Note: Simulator only accepts USD,
-      #     GBP, EUR and defaults to GBP if another ISO 4217 code is provided
-      #
-      #   @option params [Boolean] :partial_approval_capable Set to true if the terminal is capable of partial approval otherwise false.
-      #     Partial approval is when part of a transaction is approved and another payment
-      #     must be used for the remainder.
-      #
-      #   @option params [String] :pin Simulate entering a PIN. If omitted, PIN check will not be performed.
-      #
-      #   @option params [Symbol, Lithic::Models::TransactionSimulateAuthorizationParams::Status] :status Type of event to simulate.
-      #
-      #     - `AUTHORIZATION` is a dual message purchase authorization, meaning a subsequent
-      #       clearing step is required to settle the transaction.
-      #     - `BALANCE_INQUIRY` is a $0 authorization requesting the balance held on the
-      #       card, and is most often observed when a cardholder requests to view a card's
-      #       balance at an ATM.
-      #     - `CREDIT_AUTHORIZATION` is a dual message request from a merchant to authorize
-      #       a refund, meaning a subsequent clearing step is required to settle the
-      #       transaction.
-      #     - `FINANCIAL_AUTHORIZATION` is a single message request from a merchant to debit
-      #       funds immediately (such as an ATM withdrawal), and no subsequent clearing is
-      #       required to settle the transaction.
-      #     - `FINANCIAL_CREDIT_AUTHORIZATION` is a single message request from a merchant
-      #       to credit funds immediately, and no subsequent clearing is required to settle
-      #       the transaction.
-      #
-      #   @option params [Lithic::RequestOptions, Hash{Symbol=>Object}, nil] :request_options
+      # @param amount [Integer]
+      # @param descriptor [String]
+      # @param pan [String]
+      # @param mcc [String]
+      # @param merchant_acceptor_id [String]
+      # @param merchant_amount [Integer]
+      # @param merchant_currency [String]
+      # @param partial_approval_capable [Boolean]
+      # @param pin [String]
+      # @param status [Symbol, Lithic::Models::TransactionSimulateAuthorizationParams::Status]
+      # @param request_options [Lithic::RequestOptions, Hash{Symbol=>Object}, nil]
       #
       # @return [Lithic::Models::TransactionSimulateAuthorizationResponse]
+      #
+      # @see Lithic::Models::TransactionSimulateAuthorizationParams
       def simulate_authorization(params)
         parsed, options = Lithic::Models::TransactionSimulateAuthorizationParams.dump_request(params)
         @client.request(
@@ -163,16 +120,15 @@ module Lithic
       #   merchant acquirer. An authorization advice changes the pending amount of the
       #   transaction.
       #
-      # @param params [Lithic::Models::TransactionSimulateAuthorizationAdviceParams, Hash{Symbol=>Object}] .
+      # @overload simulate_authorization_advice(token:, amount:, request_options: {})
       #
-      #   @option params [String] :token The transaction token returned from the /v1/simulate/authorize. response.
-      #
-      #   @option params [Integer] :amount Amount (in cents) to authorize. This amount will override the transaction's
-      #     amount that was originally set by /v1/simulate/authorize.
-      #
-      #   @option params [Lithic::RequestOptions, Hash{Symbol=>Object}, nil] :request_options
+      # @param token [String]
+      # @param amount [Integer]
+      # @param request_options [Lithic::RequestOptions, Hash{Symbol=>Object}, nil]
       #
       # @return [Lithic::Models::TransactionSimulateAuthorizationAdviceResponse]
+      #
+      # @see Lithic::Models::TransactionSimulateAuthorizationAdviceParams
       def simulate_authorization_advice(params)
         parsed, options = Lithic::Models::TransactionSimulateAuthorizationAdviceParams.dump_request(params)
         @client.request(
@@ -191,23 +147,15 @@ module Lithic
       #   Transactions that have already cleared, either partially or fully, cannot be
       #   cleared again using this endpoint.
       #
-      # @param params [Lithic::Models::TransactionSimulateClearingParams, Hash{Symbol=>Object}] .
-      #
-      #   @option params [String] :token The transaction token returned from the /v1/simulate/authorize response.
+      # @overload simulate_clearing(token:, amount: nil, request_options: {})
       #
-      #   @option params [Integer] :amount Amount (in cents) to clear. Typically this will match the amount in the original
-      #     authorization, but can be higher or lower. The sign of this amount will
-      #     automatically match the sign of the original authorization's amount. For
-      #     example, entering 100 in this field will result in a -100 amount in the
-      #     transaction, if the original authorization is a credit authorization.
-      #
-      #     If `amount` is not set, the full amount of the transaction will be cleared.
-      #     Transactions that have already cleared, either partially or fully, cannot be
-      #     cleared again using this endpoint.
-      #
-      #   @option params [Lithic::RequestOptions, Hash{Symbol=>Object}, nil] :request_options
+      # @param token [String]
+      # @param amount [Integer]
+      # @param request_options [Lithic::RequestOptions, Hash{Symbol=>Object}, nil]
       #
       # @return [Lithic::Models::TransactionSimulateClearingResponse]
+      #
+      # @see Lithic::Models::TransactionSimulateClearingParams
       def simulate_clearing(params)
         parsed, options = Lithic::Models::TransactionSimulateClearingParams.dump_request(params)
         @client.request(
@@ -222,25 +170,18 @@ module Lithic
       # Simulates a credit authorization advice from the card network. This message
       #   indicates that the network approved a credit authorization on your behalf.
       #
-      # @param params [Lithic::Models::TransactionSimulateCreditAuthorizationParams, Hash{Symbol=>Object}] .
+      # @overload simulate_credit_authorization(amount:, descriptor:, pan:, mcc: nil, merchant_acceptor_id: nil, request_options: {})
       #
-      #   @option params [Integer] :amount Amount (in cents). Any value entered will be converted into a negative amount in
-      #     the simulated transaction. For example, entering 100 in this field will appear
-      #     as a -100 amount in the transaction.
-      #
-      #   @option params [String] :descriptor Merchant descriptor.
-      #
-      #   @option params [String] :pan Sixteen digit card number.
-      #
-      #   @option params [String] :mcc Merchant category code for the transaction to be simulated. A four-digit number
-      #     listed in ISO 18245. Supported merchant category codes can be found
-      #     [here](https://docs.lithic.com/docs/transactions#merchant-category-codes-mccs).
-      #
-      #   @option params [String] :merchant_acceptor_id Unique identifier to identify the payment card acceptor.
-      #
-      #   @option params [Lithic::RequestOptions, Hash{Symbol=>Object}, nil] :request_options
+      # @param amount [Integer]
+      # @param descriptor [String]
+      # @param pan [String]
+      # @param mcc [String]
+      # @param merchant_acceptor_id [String]
+      # @param request_options [Lithic::RequestOptions, Hash{Symbol=>Object}, nil]
       #
       # @return [Lithic::Models::TransactionSimulateCreditAuthorizationResponse]
+      #
+      # @see Lithic::Models::TransactionSimulateCreditAuthorizationParams
       def simulate_credit_authorization(params)
         parsed, options = Lithic::Models::TransactionSimulateCreditAuthorizationParams.dump_request(params)
         @client.request(
@@ -256,17 +197,16 @@ module Lithic
       #   endpoint clear immediately, without prior authorization, and result in a
       #   `SETTLED` transaction status.
       #
-      # @param params [Lithic::Models::TransactionSimulateReturnParams, Hash{Symbol=>Object}] .
+      # @overload simulate_return(amount:, descriptor:, pan:, request_options: {})
       #
-      #   @option params [Integer] :amount Amount (in cents) to authorize.
-      #
-      #   @option params [String] :descriptor Merchant descriptor.
-      #
-      #   @option params [String] :pan Sixteen digit card number.
-      #
-      #   @option params [Lithic::RequestOptions, Hash{Symbol=>Object}, nil] :request_options
+      # @param amount [Integer]
+      # @param descriptor [String]
+      # @param pan [String]
+      # @param request_options [Lithic::RequestOptions, Hash{Symbol=>Object}, nil]
       #
       # @return [Lithic::Models::TransactionSimulateReturnResponse]
+      #
+      # @see Lithic::Models::TransactionSimulateReturnParams
       def simulate_return(params)
         parsed, options = Lithic::Models::TransactionSimulateReturnParams.dump_request(params)
         @client.request(
@@ -282,13 +222,14 @@ module Lithic
       #   can be financial credit authorizations, or credit authorizations that have
       #   cleared.
       #
-      # @param params [Lithic::Models::TransactionSimulateReturnReversalParams, Hash{Symbol=>Object}] .
-      #
-      #   @option params [String] :token The transaction token returned from the /v1/simulate/authorize response.
+      # @overload simulate_return_reversal(token:, request_options: {})
       #
-      #   @option params [Lithic::RequestOptions, Hash{Symbol=>Object}, nil] :request_options
+      # @param token [String]
+      # @param request_options [Lithic::RequestOptions, Hash{Symbol=>Object}, nil]
       #
       # @return [Lithic::Models::TransactionSimulateReturnReversalResponse]
+      #
+      # @see Lithic::Models::TransactionSimulateReturnReversalParams
       def simulate_return_reversal(params)
         parsed, options = Lithic::Models::TransactionSimulateReturnReversalParams.dump_request(params)
         @client.request(
@@ -305,22 +246,16 @@ module Lithic
       #   transactions. _Simulating an authorization expiry on credit authorizations or
       #   credit authorization advice is not currently supported but will be added soon._
       #
-      # @param params [Lithic::Models::TransactionSimulateVoidParams, Hash{Symbol=>Object}] .
+      # @overload simulate_void(token:, amount: nil, type: nil, request_options: {})
       #
-      #   @option params [String] :token The transaction token returned from the /v1/simulate/authorize response.
-      #
-      #   @option params [Integer] :amount Amount (in cents) to void. Typically this will match the amount in the original
-      #     authorization, but can be less.
-      #
-      #   @option params [Symbol, Lithic::Models::TransactionSimulateVoidParams::Type] :type Type of event to simulate. Defaults to `AUTHORIZATION_REVERSAL`.
-      #
-      #     - `AUTHORIZATION_EXPIRY` indicates authorization has expired and been reversed
-      #       by Lithic.
-      #     - `AUTHORIZATION_REVERSAL` indicates authorization was reversed by the merchant.
-      #
-      #   @option params [Lithic::RequestOptions, Hash{Symbol=>Object}, nil] :request_options
+      # @param token [String]
+      # @param amount [Integer]
+      # @param type [Symbol, Lithic::Models::TransactionSimulateVoidParams::Type]
+      # @param request_options [Lithic::RequestOptions, Hash{Symbol=>Object}, nil]
       #
       # @return [Lithic::Models::TransactionSimulateVoidResponse]
+      #
+      # @see Lithic::Models::TransactionSimulateVoidParams
       def simulate_void(params)
         parsed, options = Lithic::Models::TransactionSimulateVoidParams.dump_request(params)
         @client.request(
@@ -332,6 +267,8 @@ module Lithic
         )
       end
 
+      # @api private
+      #
       # @param client [Lithic::Client]
       def initialize(client:)
         @client = client

data/lib/lithic/resources/transfers.rb

@@ -6,25 +6,18 @@ module Lithic
       # Transfer funds between two financial accounts or between a financial account and
       #   card
       #
-      # @param params [Lithic::Models::TransferCreateParams, Hash{Symbol=>Object}] .
+      # @overload create(amount:, from:, to:, token: nil, memo: nil, request_options: {})
       #
-      #   @option params [Integer] :amount Amount to be transferred in the currency’s smallest unit (e.g., cents for USD).
-      #     This should always be a positive value.
-      #
-      #   @option params [String] :from Globally unique identifier for the financial account or card that will send the
-      #     funds. Accepted type dependent on the program's use case.
-      #
-      #   @option params [String] :to Globally unique identifier for the financial account or card that will receive
-      #     the funds. Accepted type dependent on the program's use case.
-      #
-      #   @option params [String] :token Customer-provided token that will serve as an idempotency token. This token will
-      #     become the transaction token.
-      #
-      #   @option params [String] :memo Optional descriptor for the transfer.
-      #
-      #   @option params [Lithic::RequestOptions, Hash{Symbol=>Object}, nil] :request_options
+      # @param amount [Integer]
+      # @param from [String]
+      # @param to [String]
+      # @param token [String]
+      # @param memo [String]
+      # @param request_options [Lithic::RequestOptions, Hash{Symbol=>Object}, nil]
       #
       # @return [Lithic::Models::Transfer]
+      #
+      # @see Lithic::Models::TransferCreateParams
       def create(params)
         parsed, options = Lithic::Models::TransferCreateParams.dump_request(params)
         @client.request(
@@ -36,6 +29,8 @@ module Lithic
         )
       end
 
+      # @api private
+      #
       # @param client [Lithic::Client]
       def initialize(client:)
         @client = client

data/lib/lithic/transport/base_client.rb

@@ -92,7 +92,7 @@ module Lithic
               URI.join(url, response_headers["location"])
             rescue ArgumentError
               message = "Server responded with status #{status} but no valid location header."
-              raise Lithic::APIConnectionError.new(url: url, message: message)
+              raise Lithic::Errors::APIConnectionError.new(url: url, message: message)
             end
 
           request = {**request, url: location}
@@ -100,7 +100,7 @@ module Lithic
           case [url.scheme, location.scheme]
           in ["https", "http"]
             message = "Tried to redirect to a insecure URL"
-            raise Lithic::APIConnectionError.new(url: url, message: message)
+            raise Lithic::Errors::APIConnectionError.new(url: url, message: message)
           else
             nil
           end
@@ -129,13 +129,13 @@ module Lithic
 
         # @api private
         #
-        # @param status [Integer, Lithic::APIConnectionError]
+        # @param status [Integer, Lithic::Errors::APIConnectionError]
         # @param stream [Enumerable, nil]
         def reap_connection!(status, stream:)
           case status
           in (..199) | (300..499)
             stream&.each { next }
-          in Lithic::APIConnectionError | (500..)
+          in Lithic::Errors::APIConnectionError | (500..)
             Lithic::Util.close_fused!(stream)
           else
           end
@@ -326,7 +326,7 @@ module Lithic
       #
       # @param send_retry_header [Boolean]
       #
-      # @raise [Lithic::APIError]
+      # @raise [Lithic::Errors::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)
@@ -349,7 +349,7 @@ module Lithic
           self.class.reap_connection!(status, stream: stream)
 
           message = "Failed to complete the request within #{self.class::MAX_REDIRECTS} redirects."
-          raise Lithic::APIConnectionError.new(url: url, message: message)
+          raise Lithic::Errors::APIConnectionError.new(url: url, message: message)
         in 300..399
           self.class.reap_connection!(status, stream: stream)
 
@@ -369,14 +369,14 @@ module Lithic
             self.class.reap_connection!(status, stream: stream)
           end
 
-          raise Lithic::APIStatusError.for(
+          raise Lithic::Errors::APIStatusError.for(
             url: url,
             status: status,
             body: decoded,
             request: nil,
             response: response
           )
-        in (400..) | Lithic::APIConnectionError
+        in (400..) | Lithic::Errors::APIConnectionError
           self.class.reap_connection!(status, stream: stream)
 
           delay = retry_delay(response, retry_count: retry_count)
@@ -416,7 +416,7 @@ module Lithic
       #
       #   @option req [Lithic::RequestOptions, Hash{Symbol=>Object}, nil] :options
       #
-      # @raise [Lithic::APIError]
+      # @raise [Lithic::Errors::APIError]
       # @return [Object]
       def request(req)
         self.class.validate!(req)

data/lib/lithic/transport/pooled_net_requester.rb

@@ -153,7 +153,7 @@ module Lithic
             end
           end
         rescue Timeout::Error
-          raise Lithic::APITimeoutError
+          raise Lithic::Errors::APITimeoutError
         end
 
         conn, _, response = enum.next

data/lib/lithic/type/base_model.rb

@@ -331,6 +331,16 @@ module Lithic
           .to_h
       end
 
+      # @param a [Object]
+      #
+      # @return [String]
+      def to_json(*a) = self.class.dump(self).to_json(*a)
+
+      # @param a [Object]
+      #
+      # @return [String]
+      def to_yaml(*a) = self.class.dump(self).to_yaml(*a)
+
       # Create a new instance of a model.
       #
       # @param data [Hash{Symbol=>Object}, Lithic::BaseModel]

data/lib/lithic/type/base_page.rb

@@ -29,7 +29,7 @@ module Lithic
       # @return [Boolean]
       def next_page? = (raise NotImplementedError)
 
-      # @raise [Lithic::APIError]
+      # @raise [Lithic::Errors::APIError]
       # @return [Lithic::Type::BasePage]
       def next_page = (raise NotImplementedError)
 

data/lib/lithic/util.rb

@@ -253,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
@@ -441,7 +441,7 @@ module Lithic
       #
       # @yieldparam [Enumerator::Yielder]
       # @return [Enumerable]
-      def string_io(&blk)
+      def writable_enum(&blk)
         Enumerator.new do |y|
           y.define_singleton_method(:write) do
             self << _1.clone
@@ -454,15 +454,13 @@ module Lithic
     end
 
     class << self
-      # rubocop:disable Naming/MethodParameterName
-
       # @api private
       #
       # @param y [Enumerator::Yielder]
       # @param boundary [String]
       # @param key [Symbol, String]
       # @param val [Object]
-      private def encode_multipart_formdata(y, boundary:, key:, val:)
+      private def write_multipart_chunk(y, boundary:, key:, val:)
         y << "--#{boundary}\r\n"
         y << "Content-Disposition: form-data"
         unless key.nil?
@@ -494,8 +492,6 @@ module Lithic
         y << "\r\n"
       end
 
-      # rubocop:enable Naming/MethodParameterName
-
       # @api private
       #
       # @param body [Object]
@@ -504,21 +500,21 @@ module Lithic
       private def encode_multipart_streaming(body)
         boundary = SecureRandom.urlsafe_base64(60)
 
-        strio = string_io do |y|
+        strio = writable_enum do |y|
           case body
           in Hash
             body.each do |key, val|
               case val
               in Array if val.all? { primitive?(_1) }
                 val.each do |v|
-                  encode_multipart_formdata(y, boundary: boundary, key: key, val: v)
+                  write_multipart_chunk(y, boundary: boundary, key: key, val: v)
                 end
               else
-                encode_multipart_formdata(y, boundary: boundary, key: key, val: val)
+                write_multipart_chunk(y, boundary: boundary, key: key, val: val)
               end
             end
           else
-            encode_multipart_formdata(y, boundary: boundary, key: nil, val: body)
+            write_multipart_chunk(y, boundary: boundary, key: nil, val: body)
           end
           y << "--#{boundary}--\r\n"
         end

data/lib/lithic/version.rb

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

data/rbi/lib/lithic/client.rbi

@@ -110,9 +110,9 @@ module Lithic
     # Creates and returns a new client for interacting with the API.
     sig do
       params(
+        api_key: T.nilable(String),
         environment: NilClass,
         base_url: T.nilable(String),
-        api_key: T.nilable(String),
         max_retries: Integer,
         timeout: Float,
         initial_retry_delay: Float,
@@ -121,6 +121,8 @@ module Lithic
         .returns(T.attached_class)
     end
     def self.new(
+      # Defaults to `ENV["LITHIC_API_KEY"]`
+      api_key: ENV["LITHIC_API_KEY"],
       # Specifies the environment to use for the API.
       #
       #   Each environment maps to a different base URL:
@@ -130,8 +132,6 @@ module Lithic
       environment: nil,
       # Override the default base URL for the API, e.g., `"https://api.example.com/v2/"`
       base_url: nil,
-      # Defaults to `ENV["LITHIC_API_KEY"]`
-      api_key: ENV["LITHIC_API_KEY"],
       # Max number of retries to attempt after a failed retryable request.
       max_retries: DEFAULT_MAX_RETRIES,
       timeout: DEFAULT_TIMEOUT_IN_SECONDS,