lithic 0.18.0 → 0.18.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: a80dc483dcaf7f1447621887d20f136a834384e3deaf657b82c4f7c77e8b6d26
-  data.tar.gz: c70af03570736f72a214cbb4bbeeae2a457f74d940b52fd1deb048c5e6b10203
+  metadata.gz: 39c91f51cf5bdeac0ea066eb62ca454e3617be091bf90fbd2dc1a7880341dced
+  data.tar.gz: 70b13d4f29b3fe30a7ab75fc1d6a377cc15e557207918dacfe648eb186ec43dc
 SHA512:
-  metadata.gz: 7237ea1d42e1688989438721062d117dd676247fee14cbc782589079a83297ac9139914e669e6201124a87d8d0462b730afa46ff534ecf0c9449b761fcacc844
-  data.tar.gz: 93a8e906edb72f6bf9d1f95b8bb1e355da3383448bc3c1b73ee6f2449172ca864903f5d19f22ac7eb2028ea8d50599a00854ed243edf6836e6422fc03fdaa694
+  metadata.gz: 5ff8da6ba6b878a6096cf5ccfd4c030fcc6caa496718179c7cf9cfcef478b1d36286439743780ec77259eab01773661f5aefdf48a79530893944ded3477a92fc
+  data.tar.gz: 13bc491847868ff70266b047604a387579271a3aae3a65e223b085d641ba1c59a0e261be1b4446f061440ecb9ecad46af7e76225913656bf8eb7ebfec5a9bab3

data/CHANGELOG.md

@@ -1,5 +1,23 @@
 # Changelog
 
+## 0.18.1 (2026-06-29)
+
+Full Changelog: [v0.18.0...v0.18.1](https://github.com/lithic-com/lithic-ruby/compare/v0.18.0...v0.18.1)
+
+### Bug Fixes
+
+* **types:** convert CaseTransaction to union with Card/Payment variants ([0d84634](https://github.com/lithic-com/lithic-ruby/commit/0d84634d5cf4e42f4270832089df3cdbd50deed2))
+
+
+### Chores
+
+* **internal:** bound formatter parallelism to CPU count ([acf4dc5](https://github.com/lithic-com/lithic-ruby/commit/acf4dc52c4d33ea1bce9b0544123caf6c2d764d2))
+
+
+### Documentation
+
+* **types:** update cash_amount field description in CardAuthorization ([1385cde](https://github.com/lithic-com/lithic-ruby/commit/1385cde62aca3c83a7525150b535decc016c8ed4))
+
 ## 0.18.0 (2026-06-23)
 
 Full Changelog: [v0.17.0...v0.18.0](https://github.com/lithic-com/lithic-ruby/compare/v0.17.0...v0.18.0)

data/README.md

@@ -24,7 +24,7 @@ To use this gem, install via Bundler by adding the following to your application
 <!-- x-release-please-start-version -->
 
 ```ruby
-gem "lithic", "~> 0.18.0"
+gem "lithic", "~> 0.18.1"
 ```
 
 <!-- x-release-please-end -->

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

@@ -6,28 +6,14 @@ module Lithic
       # @api private
       #
       # @example
-      #   # `account_activity_list_response` is a `Lithic::Models::AccountActivityListResponse`
-      #   case account_activity_list_response
-      #   when Lithic::Models::AccountActivityListResponse::Internal
-      #     puts(account_activity_list_response.token)
-      #   when Lithic::BookTransferResponse
-      #     puts(account_activity_list_response.category)
-      #   when Lithic::Models::AccountActivityListResponse::Card
-      #     # ...
+      #   # `case_transaction` is a `Lithic::TransactionMonitoring::CaseTransaction`
+      #   case case_transaction
+      #   when Lithic::TransactionMonitoring::CaseTransaction::CardCaseTransaction
+      #     puts(case_transaction.token)
+      #   when Lithic::TransactionMonitoring::CaseTransaction::PaymentCaseTransaction
+      #     puts(case_transaction.added_at)
       #   else
-      #     puts(account_activity_list_response)
-      #   end
-      #
-      # @example
-      #   case account_activity_list_response
-      #   in {family: :INTERNAL, token: token, category: category, created: created}
-      #     puts(token)
-      #   in {family: :TRANSFER, token: token, category: category, created: created}
-      #     puts(category)
-      #   in {family: :PAYMENT, token: token, category: category, created: created}
-      #     puts(created)
-      #   else
-      #     puts(account_activity_list_response)
+      #     puts(case_transaction)
       #   end
       module Union
         include Lithic::Internal::Type::Converter

data/lib/lithic/models/card_authorization.rb

@@ -68,12 +68,13 @@ module Lithic
       required :cardholder_currency, String
 
       # @!attribute cash_amount
-      #   The portion of the transaction requested as cash back by the cardholder, and
-      #   does not include any acquirer fees. The amount field includes the purchase
-      #   amount, the requested cash back amount, and any acquirer fees.
+      #   The amount of cash requested by the cardholder, in the cardholder billing
+      #   currency's smallest unit. For purchase-with-cashback transactions this is the
+      #   cashback portion only; for ATM transactions this is the full amount. This amount
+      #   includes all acquirer fees.
       #
-      #   If no cash back was requested, the value of this field will be 0, and the field
-      #   will always be present.
+      #   If no cash was requested, the value of this field will be 0, and the field will
+      #   always be present.
       #
       #   @return [Integer]
       required :cash_amount, Integer
@@ -263,7 +264,7 @@ module Lithic
       #
       #   @param cardholder_currency [String] Deprecated, use `amounts`. 3-character alphabetic ISO 4217 code for cardholder's
       #
-      #   @param cash_amount [Integer] The portion of the transaction requested as cash back by the cardholder, and doe
+      #   @param cash_amount [Integer] The amount of cash requested by the cardholder, in the cardholder billing curren
       #
       #   @param created [Time] Date and time when the transaction first occurred in UTC.
       #

data/lib/lithic/models/transaction_monitoring/case_transaction.rb

@@ -3,50 +3,127 @@
 module Lithic
   module Models
     module TransactionMonitoring
+      # A single transaction associated with a case. The `category` field identifies
+      # whether this is a card transaction or a payment transaction.
+      #
       # @see Lithic::Resources::TransactionMonitoring::Cases#list_transactions
-      class CaseTransaction < Lithic::Internal::Type::BaseModel
-        # @!attribute token
-        #   Globally unique identifier for the transaction
-        #
-        #   @return [String]
-        required :token, String
-
-        # @!attribute account_token
-        #   Token of the account the transaction belongs to
-        #
-        #   @return [String]
-        required :account_token, String
-
-        # @!attribute added_at
-        #   Date and time at which the transaction was added to the case
-        #
-        #   @return [Time]
-        required :added_at, Time
-
-        # @!attribute card_token
-        #   Token of the card the transaction was made on
-        #
-        #   @return [String]
-        required :card_token, String
-
-        # @!attribute transaction_created_at
-        #   Date and time at which the transaction was created
-        #
-        #   @return [Time]
-        required :transaction_created_at, Time
-
-        # @!method initialize(token:, account_token:, added_at:, card_token:, transaction_created_at:)
-        #   A single transaction associated with a case
-        #
-        #   @param token [String] Globally unique identifier for the transaction
-        #
-        #   @param account_token [String] Token of the account the transaction belongs to
-        #
-        #   @param added_at [Time] Date and time at which the transaction was added to the case
-        #
-        #   @param card_token [String] Token of the card the transaction was made on
-        #
-        #   @param transaction_created_at [Time] Date and time at which the transaction was created
+      module CaseTransaction
+        extend Lithic::Internal::Type::Union
+
+        discriminator :category
+
+        # A card transaction associated with a case
+        variant -> { Lithic::TransactionMonitoring::CaseTransaction::CardCaseTransaction }
+
+        # A payment (ACH) transaction associated with a case
+        variant -> { Lithic::TransactionMonitoring::CaseTransaction::PaymentCaseTransaction }
+
+        class CardCaseTransaction < Lithic::Internal::Type::BaseModel
+          # @!attribute token
+          #   Globally unique identifier for the card transaction
+          #
+          #   @return [String]
+          required :token, String
+
+          # @!attribute account_token
+          #   Token of the account the transaction belongs to
+          #
+          #   @return [String]
+          required :account_token, String
+
+          # @!attribute added_at
+          #   Date and time at which the transaction was added to the case
+          #
+          #   @return [Time]
+          required :added_at, Time
+
+          # @!attribute card_token
+          #   Token of the card the transaction was made on
+          #
+          #   @return [String]
+          required :card_token, String
+
+          # @!attribute category
+          #
+          #   @return [Symbol, :CARD]
+          required :category, const: :CARD
+
+          # @!attribute transaction_created_at
+          #   Date and time at which the transaction was created
+          #
+          #   @return [Time]
+          required :transaction_created_at, Time
+
+          # @!method initialize(token:, account_token:, added_at:, card_token:, transaction_created_at:, category: :CARD)
+          #   A card transaction associated with a case
+          #
+          #   @param token [String] Globally unique identifier for the card transaction
+          #
+          #   @param account_token [String] Token of the account the transaction belongs to
+          #
+          #   @param added_at [Time] Date and time at which the transaction was added to the case
+          #
+          #   @param card_token [String] Token of the card the transaction was made on
+          #
+          #   @param transaction_created_at [Time] Date and time at which the transaction was created
+          #
+          #   @param category [Symbol, :CARD]
+        end
+
+        class PaymentCaseTransaction < Lithic::Internal::Type::BaseModel
+          # @!attribute token
+          #   Globally unique identifier for the payment transaction
+          #
+          #   @return [String]
+          required :token, String
+
+          # @!attribute added_at
+          #   Date and time at which the transaction was added to the case
+          #
+          #   @return [Time]
+          required :added_at, Time
+
+          # @!attribute category
+          #
+          #   @return [Symbol, :PAYMENT]
+          required :category, const: :PAYMENT
+
+          # @!attribute financial_account_token
+          #   Token of the financial account the payment belongs to
+          #
+          #   @return [String]
+          required :financial_account_token, String
+
+          # @!attribute transaction_created_at
+          #   Date and time at which the transaction was created
+          #
+          #   @return [Time]
+          required :transaction_created_at, Time
+
+          # @!attribute account_token
+          #   Token of the account the payment belongs to, if applicable
+          #
+          #   @return [String, nil]
+          optional :account_token, String
+
+          # @!method initialize(token:, added_at:, financial_account_token:, transaction_created_at:, account_token: nil, category: :PAYMENT)
+          #   A payment (ACH) transaction associated with a case
+          #
+          #   @param token [String] Globally unique identifier for the payment transaction
+          #
+          #   @param added_at [Time] Date and time at which the transaction was added to the case
+          #
+          #   @param financial_account_token [String] Token of the financial account the payment belongs to
+          #
+          #   @param transaction_created_at [Time] Date and time at which the transaction was created
+          #
+          #   @param account_token [String] Token of the account the payment belongs to, if applicable
+          #
+          #   @param category [Symbol, :PAYMENT]
+        end
+
+        # @!method self.variants
+        #   @return [Array(Lithic::Models::TransactionMonitoring::CaseTransaction::CardCaseTransaction, Lithic::Models::TransactionMonitoring::CaseTransaction::PaymentCaseTransaction)]
       end
     end
   end

data/lib/lithic/resources/transaction_monitoring/cases.rb

@@ -178,7 +178,7 @@ module Lithic
         #
         # @param request_options [Lithic::RequestOptions, Hash{Symbol=>Object}, nil]
         #
-        # @return [Lithic::Internal::CursorPage<Lithic::Models::TransactionMonitoring::CaseTransaction>]
+        # @return [Lithic::Internal::CursorPage<Lithic::Models::TransactionMonitoring::CaseTransaction::CardCaseTransaction, Lithic::Models::TransactionMonitoring::CaseTransaction::PaymentCaseTransaction>]
         #
         # @see Lithic::Models::TransactionMonitoring::CaseListTransactionsParams
         def list_transactions(case_token, params = {})

data/lib/lithic/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Lithic
-  VERSION = "0.18.0"
+  VERSION = "0.18.1"
 end

data/rbi/lithic/models/card_authorization.rbi

@@ -59,12 +59,13 @@ module Lithic
       sig { returns(String) }
       attr_accessor :cardholder_currency
 
-      # The portion of the transaction requested as cash back by the cardholder, and
-      # does not include any acquirer fees. The amount field includes the purchase
-      # amount, the requested cash back amount, and any acquirer fees.
+      # The amount of cash requested by the cardholder, in the cardholder billing
+      # currency's smallest unit. For purchase-with-cashback transactions this is the
+      # cashback portion only; for ATM transactions this is the full amount. This amount
+      # includes all acquirer fees.
       #
-      # If no cash back was requested, the value of this field will be 0, and the field
-      # will always be present.
+      # If no cash was requested, the value of this field will be 0, and the field will
+      # always be present.
       sig { returns(Integer) }
       attr_accessor :cash_amount
 
@@ -328,12 +329,13 @@ module Lithic
         # Deprecated, use `amounts`. 3-character alphabetic ISO 4217 code for cardholder's
         # billing currency.
         cardholder_currency:,
-        # The portion of the transaction requested as cash back by the cardholder, and
-        # does not include any acquirer fees. The amount field includes the purchase
-        # amount, the requested cash back amount, and any acquirer fees.
+        # The amount of cash requested by the cardholder, in the cardholder billing
+        # currency's smallest unit. For purchase-with-cashback transactions this is the
+        # cashback portion only; for ATM transactions this is the full amount. This amount
+        # includes all acquirer fees.
         #
-        # If no cash back was requested, the value of this field will be 0, and the field
-        # will always be present.
+        # If no cash was requested, the value of this field will be 0, and the field will
+        # always be present.
         cash_amount:,
         # Date and time when the transaction first occurred in UTC.
         created:,

data/rbi/lithic/models/transaction_monitoring/case_transaction.rbi

@@ -3,71 +3,176 @@
 module Lithic
   module Models
     module TransactionMonitoring
-      class CaseTransaction < Lithic::Internal::Type::BaseModel
-        OrHash =
+      # A single transaction associated with a case. The `category` field identifies
+      # whether this is a card transaction or a payment transaction.
+      module CaseTransaction
+        extend Lithic::Internal::Type::Union
+
+        Variants =
           T.type_alias do
             T.any(
-              Lithic::TransactionMonitoring::CaseTransaction,
-              Lithic::Internal::AnyHash
+              Lithic::TransactionMonitoring::CaseTransaction::CardCaseTransaction,
+              Lithic::TransactionMonitoring::CaseTransaction::PaymentCaseTransaction
             )
           end
 
-        # Globally unique identifier for the transaction
-        sig { returns(String) }
-        attr_accessor :token
+        class CardCaseTransaction < Lithic::Internal::Type::BaseModel
+          OrHash =
+            T.type_alias do
+              T.any(
+                Lithic::TransactionMonitoring::CaseTransaction::CardCaseTransaction,
+                Lithic::Internal::AnyHash
+              )
+            end
+
+          # Globally unique identifier for the card transaction
+          sig { returns(String) }
+          attr_accessor :token
 
-        # Token of the account the transaction belongs to
-        sig { returns(String) }
-        attr_accessor :account_token
+          # Token of the account the transaction belongs to
+          sig { returns(String) }
+          attr_accessor :account_token
 
-        # Date and time at which the transaction was added to the case
-        sig { returns(Time) }
-        attr_accessor :added_at
+          # Date and time at which the transaction was added to the case
+          sig { returns(Time) }
+          attr_accessor :added_at
 
-        # Token of the card the transaction was made on
-        sig { returns(String) }
-        attr_accessor :card_token
+          # Token of the card the transaction was made on
+          sig { returns(String) }
+          attr_accessor :card_token
 
-        # Date and time at which the transaction was created
-        sig { returns(Time) }
-        attr_accessor :transaction_created_at
+          sig { returns(Symbol) }
+          attr_accessor :category
 
-        # A single transaction associated with a case
-        sig do
-          params(
-            token: String,
-            account_token: String,
-            added_at: Time,
-            card_token: String,
-            transaction_created_at: Time
-          ).returns(T.attached_class)
+          # Date and time at which the transaction was created
+          sig { returns(Time) }
+          attr_accessor :transaction_created_at
+
+          # A card transaction associated with a case
+          sig do
+            params(
+              token: String,
+              account_token: String,
+              added_at: Time,
+              card_token: String,
+              transaction_created_at: Time,
+              category: Symbol
+            ).returns(T.attached_class)
+          end
+          def self.new(
+            # Globally unique identifier for the card transaction
+            token:,
+            # Token of the account the transaction belongs to
+            account_token:,
+            # Date and time at which the transaction was added to the case
+            added_at:,
+            # Token of the card the transaction was made on
+            card_token:,
+            # Date and time at which the transaction was created
+            transaction_created_at:,
+            category: :CARD
+          )
+          end
+
+          sig do
+            override.returns(
+              {
+                token: String,
+                account_token: String,
+                added_at: Time,
+                card_token: String,
+                category: Symbol,
+                transaction_created_at: Time
+              }
+            )
+          end
+          def to_hash
+          end
         end
-        def self.new(
-          # Globally unique identifier for the transaction
-          token:,
-          # Token of the account the transaction belongs to
-          account_token:,
+
+        class PaymentCaseTransaction < Lithic::Internal::Type::BaseModel
+          OrHash =
+            T.type_alias do
+              T.any(
+                Lithic::TransactionMonitoring::CaseTransaction::PaymentCaseTransaction,
+                Lithic::Internal::AnyHash
+              )
+            end
+
+          # Globally unique identifier for the payment transaction
+          sig { returns(String) }
+          attr_accessor :token
+
           # Date and time at which the transaction was added to the case
-          added_at:,
-          # Token of the card the transaction was made on
-          card_token:,
+          sig { returns(Time) }
+          attr_accessor :added_at
+
+          sig { returns(Symbol) }
+          attr_accessor :category
+
+          # Token of the financial account the payment belongs to
+          sig { returns(String) }
+          attr_accessor :financial_account_token
+
           # Date and time at which the transaction was created
-          transaction_created_at:
-        )
+          sig { returns(Time) }
+          attr_accessor :transaction_created_at
+
+          # Token of the account the payment belongs to, if applicable
+          sig { returns(T.nilable(String)) }
+          attr_reader :account_token
+
+          sig { params(account_token: String).void }
+          attr_writer :account_token
+
+          # A payment (ACH) transaction associated with a case
+          sig do
+            params(
+              token: String,
+              added_at: Time,
+              financial_account_token: String,
+              transaction_created_at: Time,
+              account_token: String,
+              category: Symbol
+            ).returns(T.attached_class)
+          end
+          def self.new(
+            # Globally unique identifier for the payment transaction
+            token:,
+            # Date and time at which the transaction was added to the case
+            added_at:,
+            # Token of the financial account the payment belongs to
+            financial_account_token:,
+            # Date and time at which the transaction was created
+            transaction_created_at:,
+            # Token of the account the payment belongs to, if applicable
+            account_token: nil,
+            category: :PAYMENT
+          )
+          end
+
+          sig do
+            override.returns(
+              {
+                token: String,
+                added_at: Time,
+                category: Symbol,
+                financial_account_token: String,
+                transaction_created_at: Time,
+                account_token: String
+              }
+            )
+          end
+          def to_hash
+          end
         end
 
         sig do
           override.returns(
-            {
-              token: String,
-              account_token: String,
-              added_at: Time,
-              card_token: String,
-              transaction_created_at: Time
-            }
+            T::Array[Lithic::TransactionMonitoring::CaseTransaction::Variants]
           )
         end
-        def to_hash
+        def self.variants
         end
       end
     end

data/rbi/lithic/resources/transaction_monitoring/cases.rbi

@@ -187,7 +187,7 @@ module Lithic
             request_options: Lithic::RequestOptions::OrHash
           ).returns(
             Lithic::Internal::CursorPage[
-              Lithic::TransactionMonitoring::CaseTransaction
+              Lithic::TransactionMonitoring::CaseTransaction::Variants
             ]
           )
         end

data/sig/lithic/models/transaction_monitoring/case_transaction.rbs

@@ -2,40 +2,99 @@ module Lithic
   module Models
     module TransactionMonitoring
       type case_transaction =
-        {
-          token: String,
-          account_token: String,
-          added_at: Time,
-          card_token: String,
-          transaction_created_at: Time
-        }
-
-      class CaseTransaction < Lithic::Internal::Type::BaseModel
-        attr_accessor token: String
-
-        attr_accessor account_token: String
-
-        attr_accessor added_at: Time
-
-        attr_accessor card_token: String
-
-        attr_accessor transaction_created_at: Time
-
-        def initialize: (
-          token: String,
-          account_token: String,
-          added_at: Time,
-          card_token: String,
-          transaction_created_at: Time
-        ) -> void
-
-        def to_hash: -> {
-          token: String,
-          account_token: String,
-          added_at: Time,
-          card_token: String,
-          transaction_created_at: Time
-        }
+        Lithic::TransactionMonitoring::CaseTransaction::CardCaseTransaction
+        | Lithic::TransactionMonitoring::CaseTransaction::PaymentCaseTransaction
+
+      module CaseTransaction
+        extend Lithic::Internal::Type::Union
+
+        type card_case_transaction =
+          {
+            token: String,
+            account_token: String,
+            added_at: Time,
+            card_token: String,
+            category: :CARD,
+            transaction_created_at: Time
+          }
+
+        class CardCaseTransaction < Lithic::Internal::Type::BaseModel
+          attr_accessor token: String
+
+          attr_accessor account_token: String
+
+          attr_accessor added_at: Time
+
+          attr_accessor card_token: String
+
+          attr_accessor category: :CARD
+
+          attr_accessor transaction_created_at: Time
+
+          def initialize: (
+            token: String,
+            account_token: String,
+            added_at: Time,
+            card_token: String,
+            transaction_created_at: Time,
+            ?category: :CARD
+          ) -> void
+
+          def to_hash: -> {
+            token: String,
+            account_token: String,
+            added_at: Time,
+            card_token: String,
+            category: :CARD,
+            transaction_created_at: Time
+          }
+        end
+
+        type payment_case_transaction =
+          {
+            token: String,
+            added_at: Time,
+            category: :PAYMENT,
+            financial_account_token: String,
+            transaction_created_at: Time,
+            account_token: String
+          }
+
+        class PaymentCaseTransaction < Lithic::Internal::Type::BaseModel
+          attr_accessor token: String
+
+          attr_accessor added_at: Time
+
+          attr_accessor category: :PAYMENT
+
+          attr_accessor financial_account_token: String
+
+          attr_accessor transaction_created_at: Time
+
+          attr_reader account_token: String?
+
+          def account_token=: (String) -> String
+
+          def initialize: (
+            token: String,
+            added_at: Time,
+            financial_account_token: String,
+            transaction_created_at: Time,
+            ?account_token: String,
+            ?category: :PAYMENT
+          ) -> void
+
+          def to_hash: -> {
+            token: String,
+            added_at: Time,
+            category: :PAYMENT,
+            financial_account_token: String,
+            transaction_created_at: Time,
+            account_token: String
+          }
+        end
+
+        def self?.variants: -> ::Array[Lithic::Models::TransactionMonitoring::case_transaction]
       end
     end
   end

data/sig/lithic/resources/transaction_monitoring/cases.rbs

@@ -57,7 +57,7 @@ module Lithic
           ?page_size: Integer,
           ?starting_after: String,
           ?request_options: Lithic::request_opts
-        ) -> Lithic::Internal::CursorPage[Lithic::TransactionMonitoring::CaseTransaction]
+        ) -> Lithic::Internal::CursorPage[Lithic::Models::TransactionMonitoring::case_transaction]
 
         def retrieve_cards: (
           String case_token,

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: lithic
 version: !ruby/object:Gem::Version
-  version: 0.18.0
+  version: 0.18.1
 platform: ruby
 authors:
 - Lithic
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2026-06-23 00:00:00.000000000 Z
+date: 2026-07-02 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: cgi