lithic 0.1.0.pre.alpha.44 → 0.1.0.pre.alpha.46

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 2373f4ab03be865331281e30220b9ebfb84c36390b816a7ff82a599919882d64
-  data.tar.gz: 8be0a80d5a6a3ebdd440b05ed742cd5984e1ba9dbecbdd2a90762b4082e1ec27
+  metadata.gz: '09258a03a84cb7b42dc9bd53639ca8e2e5c36a402008e51134172449fe9e2dd7'
+  data.tar.gz: 4a5b22cb34a0dfc0b2b13d926aa3c7a66fda6e92650933f9faf7d2a75942b238
 SHA512:
-  metadata.gz: da6d8d1e5c1c3a38ae2bcfa4a539d125f478957760049c02a9f7476479112f8402af424f338dc4b006ad6a88e4982f9840ac9b56316ba05b1c068cc1989067b5
-  data.tar.gz: 11d60d3ff30217537f1cc4152496663e41bc4260ecbf1daa9e714c470d8246fa0bcfdd50cf1e91500b30ac3d612d63968f31a21fbba1930bb36d5e27e89577aa
+  metadata.gz: 9a39ad2e47a0dc4cd8b9db3a280074d1332ad8bba724cc8f4444e9f5832df9ed952df44fd59d4738b402f2f14655e9283f79e724c4a9b59c71611b47ec345072
+  data.tar.gz: b5e6122981a36bcd71f9dcd2fc16fdf3a58cd6a0aebe780d070692270a81fe1465d85dd3aa4ca2262efac3bdd83aefd561bf621f8c7a290c549b742a7cb55193

data/CHANGELOG.md

@@ -1,5 +1,38 @@
 # Changelog
 
+## 0.1.0-alpha.46 (2025-09-26)
+
+Full Changelog: [v0.1.0-alpha.45...v0.1.0-alpha.46](https://github.com/lithic-com/lithic-ruby/compare/v0.1.0-alpha.45...v0.1.0-alpha.46)
+
+### Bug Fixes
+
+* shorten multipart boundary sep to less than RFC specificed max length ([e5d086e](https://github.com/lithic-com/lithic-ruby/commit/e5d086ebb012d4e173072048d7ea3a5e7fc11a5f))
+
+## 0.1.0-alpha.45 (2025-09-26)
+
+Full Changelog: [v0.1.0-alpha.44...v0.1.0-alpha.45](https://github.com/lithic-com/lithic-ruby/compare/v0.1.0-alpha.44...v0.1.0-alpha.45)
+
+### Features
+
+* expose response headers for both streams and errors ([a0a6aba](https://github.com/lithic-com/lithic-ruby/commit/a0a6aba5882df60a0019557a7e7d38aba3fb7176))
+
+
+### Bug Fixes
+
+* **internal:** use null byte as file separator in the fast formatting script ([7260d7a](https://github.com/lithic-com/lithic-ruby/commit/7260d7a16edee1733a39556e554ed6f1901595de))
+
+
+### Performance Improvements
+
+* faster code formatting ([0367f27](https://github.com/lithic-com/lithic-ruby/commit/0367f2706e7903d3552ee18b7a75f62ece9fc927))
+
+
+### Chores
+
+* do not install brew dependencies in ./scripts/bootstrap by default ([23ebf5c](https://github.com/lithic-com/lithic-ruby/commit/23ebf5c02a0c168955ed2ebf1e7ef38d2d4eeda4))
+* **docs:** small updates to doc strings on a few endpoints ([b7c4832](https://github.com/lithic-com/lithic-ruby/commit/b7c4832186d3ecddb47728496bf966e00e3c15eb))
+* improve example values ([5c934d6](https://github.com/lithic-com/lithic-ruby/commit/5c934d6d52eccc89a72dfe7d5a850280b44ded75))
+
 ## 0.1.0-alpha.44 (2025-09-11)
 
 Full Changelog: [v0.1.0-alpha.43...v0.1.0-alpha.44](https://github.com/lithic-com/lithic-ruby/compare/v0.1.0-alpha.43...v0.1.0-alpha.44)

data/README.md

@@ -15,7 +15,7 @@ To use this gem, install via Bundler by adding the following to your application
 <!-- x-release-please-start-version -->
 
 ```ruby
-gem "lithic", "~> 0.1.0.pre.alpha.44"
+gem "lithic", "~> 0.1.0.pre.alpha.46"
 ```
 
 <!-- x-release-please-end -->

data/lib/lithic/errors.rb

@@ -40,6 +40,9 @@ module Lithic
       # @return [Integer, nil]
       attr_accessor :status
 
+      # @return [Hash{String=>String}, nil]
+      attr_accessor :headers
+
       # @return [Object, nil]
       attr_accessor :body
 
@@ -47,13 +50,15 @@ module Lithic
       #
       # @param url [URI::Generic]
       # @param status [Integer, nil]
+      # @param headers [Hash{String=>String}, nil]
       # @param body [Object, nil]
       # @param request [nil]
       # @param response [nil]
       # @param message [String, nil]
-      def initialize(url:, status: nil, body: nil, request: nil, response: nil, message: nil)
+      def initialize(url:, status: nil, headers: nil, body: nil, request: nil, response: nil, message: nil)
         @url = url
         @status = status
+        @headers = headers
         @body = body
         @request = request
         @response = response
@@ -74,6 +79,7 @@ module Lithic
       #
       # @param url [URI::Generic]
       # @param status [nil]
+      # @param headers [Hash{String=>String}, nil]
       # @param body [nil]
       # @param request [nil]
       # @param response [nil]
@@ -81,6 +87,7 @@ module Lithic
       def initialize(
         url:,
         status: nil,
+        headers: nil,
         body: nil,
         request: nil,
         response: nil,
@@ -95,6 +102,7 @@ module Lithic
       #
       # @param url [URI::Generic]
       # @param status [nil]
+      # @param headers [Hash{String=>String}, nil]
       # @param body [nil]
       # @param request [nil]
       # @param response [nil]
@@ -102,6 +110,7 @@ module Lithic
       def initialize(
         url:,
         status: nil,
+        headers: nil,
         body: nil,
         request: nil,
         response: nil,
@@ -116,21 +125,24 @@ module Lithic
       #
       # @param url [URI::Generic]
       # @param status [Integer]
+      # @param headers [Hash{String=>String}, nil]
       # @param body [Object, nil]
       # @param request [nil]
       # @param response [nil]
       # @param message [String, nil]
       #
       # @return [self]
-      def self.for(url:, status:, body:, request:, response:, message: nil)
-        kwargs = {
-          url: url,
-          status: status,
-          body: body,
-          request: request,
-          response: response,
-          message: message
-        }
+      def self.for(url:, status:, headers:, body:, request:, response:, message: nil)
+        kwargs =
+          {
+            url: url,
+            status: status,
+            headers: headers,
+            body: body,
+            request: request,
+            response: response,
+            message: message
+          }
 
         case status
         in 400
@@ -162,15 +174,17 @@ module Lithic
       #
       # @param url [URI::Generic]
       # @param status [Integer]
+      # @param headers [Hash{String=>String}, nil]
       # @param body [Object, nil]
       # @param request [nil]
       # @param response [nil]
       # @param message [String, nil]
-      def initialize(url:, status:, body:, request:, response:, message: nil)
+      def initialize(url:, status:, headers:, body:, request:, response:, message: nil)
         message ||= {url: url.to_s, status: status, body: body}
         super(
           url: url,
           status: status,
+          headers: headers,
           body: body,
           request: request,
           response: response,

data/lib/lithic/internal/cursor_page.rb

@@ -60,7 +60,7 @@ module Lithic
       #
       # @param client [Lithic::Internal::Transport::BaseClient]
       # @param req [Hash{Symbol=>Object}]
-      # @param headers [Hash{String=>String}, Net::HTTPHeader]
+      # @param headers [Hash{String=>String}]
       # @param page_data [Hash{Symbol=>Object}]
       def initialize(client:, req:, headers:, page_data:)
         super

data/lib/lithic/internal/single_page.rb

@@ -54,7 +54,7 @@ module Lithic
       #
       # @param client [Lithic::Internal::Transport::BaseClient]
       # @param req [Hash{Symbol=>Object}]
-      # @param headers [Hash{String=>String}, Net::HTTPHeader]
+      # @param headers [Hash{String=>String}]
       # @param page_data [Array<Object>]
       def initialize(client:, req:, headers:, page_data:)
         super

data/lib/lithic/internal/transport/base_client.rb

@@ -47,7 +47,7 @@ module Lithic
           # @api private
           #
           # @param status [Integer]
-          # @param headers [Hash{String=>String}, Net::HTTPHeader]
+          # @param headers [Hash{String=>String}]
           #
           # @return [Boolean]
           def should_retry?(status, headers:)
@@ -85,7 +85,7 @@ module Lithic
           #
           # @param status [Integer]
           #
-          # @param response_headers [Hash{String=>String}, Net::HTTPHeader]
+          # @param response_headers [Hash{String=>String}]
           #
           # @return [Hash{Symbol=>Object}]
           def follow_redirect(request, status:, response_headers:)
@@ -378,6 +378,7 @@ module Lithic
           rescue Lithic::Errors::APIConnectionError => e
             status = e
           end
+          headers = Lithic::Internal::Util.normalized_headers(response&.each_header&.to_h)
 
           case status
           in ..299
@@ -390,7 +391,7 @@ module Lithic
           in 300..399
             self.class.reap_connection!(status, stream: stream)
 
-            request = self.class.follow_redirect(request, status: status, response_headers: response)
+            request = self.class.follow_redirect(request, status: status, response_headers: headers)
             send_request(
               request,
               redirect_count: redirect_count + 1,
@@ -399,9 +400,9 @@ module Lithic
             )
           in Lithic::Errors::APIConnectionError if retry_count >= max_retries
             raise status
-          in (400..) if retry_count >= max_retries || !self.class.should_retry?(status, headers: response)
+          in (400..) if retry_count >= max_retries || !self.class.should_retry?(status, headers: headers)
             decoded = Kernel.then do
-              Lithic::Internal::Util.decode_content(response, stream: stream, suppress_error: true)
+              Lithic::Internal::Util.decode_content(headers, stream: stream, suppress_error: true)
             ensure
               self.class.reap_connection!(status, stream: stream)
             end
@@ -409,6 +410,7 @@ module Lithic
             raise Lithic::Errors::APIStatusError.for(
               url: url,
               status: status,
+              headers: headers,
               body: decoded,
               request: nil,
               response: response
@@ -485,19 +487,21 @@ module Lithic
             send_retry_header: send_retry_header
           )
 
-          decoded = Lithic::Internal::Util.decode_content(response, stream: stream)
+          headers = Lithic::Internal::Util.normalized_headers(response.each_header.to_h)
+          decoded = Lithic::Internal::Util.decode_content(headers, stream: stream)
           case req
           in {stream: Class => st}
             st.new(
               model: model,
               url: url,
               status: status,
+              headers: headers,
               response: response,
               unwrap: unwrap,
               stream: decoded
             )
           in {page: Class => page}
-            page.new(client: self, req: req, headers: response, page_data: decoded)
+            page.new(client: self, req: req, headers: headers, page_data: decoded)
           else
             unwrapped = Lithic::Internal::Util.dig(decoded, unwrap)
             Lithic::Internal::Type::Converter.coerce(model, unwrapped)

data/lib/lithic/internal/type/base_page.rb

@@ -39,7 +39,7 @@ module Lithic
         #
         # @param client [Lithic::Internal::Transport::BaseClient]
         # @param req [Hash{Symbol=>Object}]
-        # @param headers [Hash{String=>String}, Net::HTTPHeader]
+        # @param headers [Hash{String=>String}]
         # @param page_data [Object]
         def initialize(client:, req:, headers:, page_data:)
           @client = client

data/lib/lithic/internal/type/union.rb

@@ -6,14 +6,16 @@ module Lithic
       # @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)
+      #   # `account_activity_list_response` is a `Lithic::Models::AccountActivityListResponse`
+      #   case account_activity_list_response
+      #   when Lithic::Models::AccountActivityListResponse::FinancialTransaction
+      #     puts(account_activity_list_response.token)
+      #   when Lithic::Models::AccountActivityListResponse::BookTransferTransaction
+      #     puts(account_activity_list_response.category)
+      #   when Lithic::Models::AccountActivityListResponse::CardTransaction
+      #     # ...
       #   else
-      #     puts(account_holder_update_response)
+      #     puts(account_activity_list_response)
       #   end
       module Union
         include Lithic::Internal::Type::Converter

data/lib/lithic/internal/util.rb

@@ -566,7 +566,8 @@ module Lithic
         #
         # @return [Array(String, Enumerable<String>)]
         private def encode_multipart_streaming(body)
-          boundary = SecureRandom.urlsafe_base64(60)
+          # RFC 1521 Section 7.2.1 says we should have 70 char maximum for boundary length
+          boundary = SecureRandom.urlsafe_base64(46)
 
           closing = []
           strio = writable_enum do |y|
@@ -647,7 +648,7 @@ module Lithic
         #
         # Assumes each chunk in stream has `Encoding::BINARY`.
         #
-        # @param headers [Hash{String=>String}, Net::HTTPHeader]
+        # @param headers [Hash{String=>String}]
         # @param stream [Enumerable<String>]
         # @param suppress_error [Boolean]
         #

data/lib/lithic/models/account_activity_list_response.rb

@@ -8,6 +8,8 @@ module Lithic
     module AccountActivityListResponse
       extend Lithic::Internal::Type::Union
 
+      discriminator :family
+
       # Financial transaction with inheritance from unified base transaction
       variant -> { Lithic::Models::AccountActivityListResponse::FinancialTransaction }
 

data/lib/lithic/models/account_activity_retrieve_transaction_response.rb

@@ -8,6 +8,8 @@ module Lithic
     module AccountActivityRetrieveTransactionResponse
       extend Lithic::Internal::Type::Union
 
+      discriminator :family
+
       # Financial transaction with inheritance from unified base transaction
       variant -> { Lithic::Models::AccountActivityRetrieveTransactionResponse::FinancialTransaction }
 

data/lib/lithic/models/transaction_simulate_void_params.rb

@@ -15,7 +15,8 @@ module Lithic
 
       # @!attribute amount
       #   Amount (in cents) to void. Typically this will match the amount in the original
-      #   authorization, but can be less.
+      #   authorization, but can be less. Applies to authorization reversals only. An
+      #   authorization expiry will always apply to the full pending amount.
       #
       #   @return [Integer, nil]
       optional :amount, Integer

data/lib/lithic/version.rb

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

data/rbi/lithic/errors.rbi

@@ -33,6 +33,9 @@ module Lithic
       sig { returns(T.nilable(Integer)) }
       attr_accessor :status
 
+      sig { returns(T.nilable(T::Hash[String, String])) }
+      attr_accessor :headers
+
       sig { returns(T.nilable(T.anything)) }
       attr_accessor :body
 
@@ -41,6 +44,7 @@ module Lithic
         params(
           url: URI::Generic,
           status: T.nilable(Integer),
+          headers: T.nilable(T::Hash[String, String]),
           body: T.nilable(Object),
           request: NilClass,
           response: NilClass,
@@ -50,6 +54,7 @@ module Lithic
       def self.new(
         url:,
         status: nil,
+        headers: nil,
         body: nil,
         request: nil,
         response: nil,
@@ -70,6 +75,7 @@ module Lithic
         params(
           url: URI::Generic,
           status: NilClass,
+          headers: T.nilable(T::Hash[String, String]),
           body: NilClass,
           request: NilClass,
           response: NilClass,
@@ -79,6 +85,7 @@ module Lithic
       def self.new(
         url:,
         status: nil,
+        headers: nil,
         body: nil,
         request: nil,
         response: nil,
@@ -93,6 +100,7 @@ module Lithic
         params(
           url: URI::Generic,
           status: NilClass,
+          headers: T.nilable(T::Hash[String, String]),
           body: NilClass,
           request: NilClass,
           response: NilClass,
@@ -102,6 +110,7 @@ module Lithic
       def self.new(
         url:,
         status: nil,
+        headers: nil,
         body: nil,
         request: nil,
         response: nil,
@@ -116,13 +125,22 @@ module Lithic
         params(
           url: URI::Generic,
           status: Integer,
+          headers: T.nilable(T::Hash[String, String]),
           body: T.nilable(Object),
           request: NilClass,
           response: NilClass,
           message: T.nilable(String)
         ).returns(T.attached_class)
       end
-      def self.for(url:, status:, body:, request:, response:, message: nil)
+      def self.for(
+        url:,
+        status:,
+        headers:,
+        body:,
+        request:,
+        response:,
+        message: nil
+      )
       end
 
       sig { returns(Integer) }
@@ -133,13 +151,22 @@ module Lithic
         params(
           url: URI::Generic,
           status: Integer,
+          headers: T.nilable(T::Hash[String, String]),
           body: T.nilable(Object),
           request: NilClass,
           response: NilClass,
           message: T.nilable(String)
         ).returns(T.attached_class)
       end
-      def self.new(url:, status:, body:, request:, response:, message: nil)
+      def self.new(
+        url:,
+        status:,
+        headers:,
+        body:,
+        request:,
+        response:,
+        message: nil
+      )
       end
     end
 

data/rbi/lithic/internal/transport/base_client.rbi

@@ -84,10 +84,9 @@ module Lithic
 
           # @api private
           sig do
-            params(
-              status: Integer,
-              headers: T.any(T::Hash[String, String], Net::HTTPHeader)
-            ).returns(T::Boolean)
+            params(status: Integer, headers: T::Hash[String, String]).returns(
+              T::Boolean
+            )
           end
           def should_retry?(status, headers:)
           end
@@ -97,7 +96,7 @@ module Lithic
             params(
               request: Lithic::Internal::Transport::BaseClient::RequestInput,
               status: Integer,
-              response_headers: T.any(T::Hash[String, String], Net::HTTPHeader)
+              response_headers: T::Hash[String, String]
             ).returns(Lithic::Internal::Transport::BaseClient::RequestInput)
           end
           def follow_redirect(request, status:, response_headers:)

data/rbi/lithic/internal/type/base_page.rbi

@@ -30,7 +30,7 @@ module Lithic
           params(
             client: Lithic::Internal::Transport::BaseClient,
             req: Lithic::Internal::Transport::BaseClient::RequestComponents,
-            headers: T.any(T::Hash[String, String], Net::HTTPHeader),
+            headers: T::Hash[String, String],
             page_data: T.anything
           ).void
         end

data/rbi/lithic/internal/util.rbi

@@ -361,7 +361,7 @@ module Lithic
         # Assumes each chunk in stream has `Encoding::BINARY`.
         sig do
           params(
-            headers: T.any(T::Hash[String, String], Net::HTTPHeader),
+            headers: T::Hash[String, String],
             stream: T::Enumerable[String],
             suppress_error: T::Boolean
           ).returns(T.anything)

data/rbi/lithic/models/transaction_simulate_void_params.rbi

@@ -19,7 +19,8 @@ module Lithic
       attr_accessor :token
 
       # Amount (in cents) to void. Typically this will match the amount in the original
-      # authorization, but can be less.
+      # authorization, but can be less. Applies to authorization reversals only. An
+      # authorization expiry will always apply to the full pending amount.
       sig { returns(T.nilable(Integer)) }
       attr_reader :amount
 
@@ -55,7 +56,8 @@ module Lithic
         # The transaction token returned from the /v1/simulate/authorize response.
         token:,
         # Amount (in cents) to void. Typically this will match the amount in the original
-        # authorization, but can be less.
+        # authorization, but can be less. Applies to authorization reversals only. An
+        # authorization expiry will always apply to the full pending amount.
         amount: nil,
         # Type of event to simulate. Defaults to `AUTHORIZATION_REVERSAL`.
         #

data/rbi/lithic/resources/transactions.rbi

@@ -295,7 +295,8 @@ module Lithic
         # The transaction token returned from the /v1/simulate/authorize response.
         token:,
         # Amount (in cents) to void. Typically this will match the amount in the original
-        # authorization, but can be less.
+        # authorization, but can be less. Applies to authorization reversals only. An
+        # authorization expiry will always apply to the full pending amount.
         amount: nil,
         # Type of event to simulate. Defaults to `AUTHORIZATION_REVERSAL`.
         #

data/sig/lithic/errors.rbs

@@ -21,11 +21,14 @@ module Lithic
 
       attr_accessor status: Integer?
 
+      attr_accessor headers: ::Hash[String, String]?
+
       attr_accessor body: top?
 
       def initialize: (
         url: URI::Generic,
         ?status: Integer?,
+        ?headers: ::Hash[String, String]?,
         ?body: Object?,
         ?request: nil,
         ?response: nil,
@@ -37,6 +40,7 @@ module Lithic
       def initialize: (
         url: URI::Generic,
         ?status: nil,
+        ?headers: ::Hash[String, String]?,
         ?body: nil,
         ?request: nil,
         ?response: nil,
@@ -48,6 +52,7 @@ module Lithic
       def initialize: (
         url: URI::Generic,
         ?status: nil,
+        ?headers: ::Hash[String, String]?,
         ?body: nil,
         ?request: nil,
         ?response: nil,
@@ -59,6 +64,7 @@ module Lithic
       def self.for: (
         url: URI::Generic,
         status: Integer,
+        headers: ::Hash[String, String]?,
         body: Object?,
         request: nil,
         response: nil,
@@ -68,6 +74,7 @@ module Lithic
       def initialize: (
         url: URI::Generic,
         status: Integer,
+        headers: ::Hash[String, String]?,
         body: Object?,
         request: nil,
         response: nil,

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: lithic
 version: !ruby/object:Gem::Version
-  version: 0.1.0.pre.alpha.44
+  version: 0.1.0.pre.alpha.46
 platform: ruby
 authors:
 - Lithic
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2025-09-11 00:00:00.000000000 Z
+date: 2025-09-26 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: connection_pool