lithic 0.9.0 → 0.11.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: bdfdaef84ba463bcef004c9ee56dffec28197c5be9c0ef5c0afc4fe5f5ff925e
-  data.tar.gz: 987874852c6ee027d534ad085f842967c553a4d0bdd8ff7a9bec156d04f7cf0e
+  metadata.gz: 553b9c0f364c3ceda24f43c9070054640c640d3a64098de3b0ba14482cd5e3fa
+  data.tar.gz: 60d02df14fc6c2b57f8cbe950626641d8d97615c4739834e2ed0e6568e9a2160
 SHA512:
-  metadata.gz: 377bec29bb9c975d6b9c005f94a7236c526a05df1bd9a39e2910b0d2408d0d95ff32f2356360a8af624c033350df8dbf35d9713f5d89ae08647017670262e16b
-  data.tar.gz: 77ccfee6e72f7f0142ea103476a66adf2c5b3d74af6ff50ead53c9c2b4ebefe09a93966b42e0df1305266d5878d7f91eb73737a64d369f95559969d03cf0f9b7
+  metadata.gz: 49da4437a7eb8c6e4641e0317172d04d04894bf7d105ab6cfa09b9c841f87889610a5a70788477cf6395721fa377b621b451590428db5cb63ebcb21373535cf2
+  data.tar.gz: d727b8abf57c1facda792f2c410f64b1fbe055541c44c7d8002027e103704e1165042e185a1b01a1af55cda82ccbfaa16e3af844fea082ec9aed4001d4d24cf7

data/CHANGELOG.md

@@ -1,5 +1,73 @@
 # Changelog
 
+## 0.11.0 (2026-04-13)
+
+Full Changelog: [v0.10.0...v0.11.0](https://github.com/lithic-com/lithic-ruby/compare/v0.10.0...v0.11.0)
+
+### Features
+
+* **api:** add card decline count attributes to auth_rules conditional authorization ([d8d98d9](https://github.com/lithic-com/lithic-ruby/commit/d8d98d927f33b011b1a28c37df6b971ab7c895a0))
+* **api:** add DELINQUENT substatus to financial account update status ([6a49f69](https://github.com/lithic-com/lithic-ruby/commit/6a49f690f00b7c261e22201aaac8521db124e4dc))
+* **api:** add interchange/chargeback/provisional_credit_account to financial account type enums ([3d54444](https://github.com/lithic-com/lithic-ruby/commit/3d544442bb1ecfc4c69c806fb72cf8a1b0564c8d))
+* **api:** add override_company_name field to payment create parameters ([7e916b6](https://github.com/lithic-com/lithic-ruby/commit/7e916b6bb6e41494aab381d5a30bb83f9ea6ca23))
+* **api:** add statement_totals field to financial accounts statement ([1fa7586](https://github.com/lithic-com/lithic-ruby/commit/1fa758668e1caf7beefca72abe384c99d112ae85))
+* **api:** add transaction_token field to auth_rules examples ([4729281](https://github.com/lithic-com/lithic-ruby/commit/47292818b9afc96e2ac358235012b4deb8987016))
+* **api:** add transaction_token field to auth_rules v2 results response ([acca757](https://github.com/lithic-com/lithic-ruby/commit/acca757780ead14f428e035409c3b7cb815d9d83))
+
+
+### Bug Fixes
+
+* align path encoding with RFC 3986 section 3.3 ([5624e72](https://github.com/lithic-com/lithic-ruby/commit/5624e7234a615d0de2ecc92e007be91a54a90c98))
+* **internal:** correct multipart form field name encoding ([abfc1fd](https://github.com/lithic-com/lithic-ruby/commit/abfc1fdd7c78682932979e362448f95bca347d43))
+* multipart encoding for file arrays ([5a0bdeb](https://github.com/lithic-com/lithic-ruby/commit/5a0bdeb87640bd6340039f86a366886894e9991a))
+* **types:** [breaking] remove deprecated fields from auth_rules report_stats ([f3089b7](https://github.com/lithic-com/lithic-ruby/commit/f3089b7a510244d7c566bc69cc68d4564b899bec))
+* **types:** make credit_product_token optional in financial_accounts statement ([a0fa401](https://github.com/lithic-com/lithic-ruby/commit/a0fa40166b98f3d7e91878d5ea948027c72ea440))
+* **types:** remove INTERCHANGE/CHARGEBACK from FinancialAccount/InstanceFinancialAccountType ([6077d32](https://github.com/lithic-com/lithic-ruby/commit/6077d32ca7a8bc77204000d9c2e0cf7f28569c4b))
+* **types:** require Card fields, remove hostname in authorization approval webhook ([fb4f7d9](https://github.com/lithic-com/lithic-ruby/commit/fb4f7d98735f400ca090a07b7fe59373e8eb9ef1))
+* variable name typo ([0156ca5](https://github.com/lithic-com/lithic-ruby/commit/0156ca5e46b58cdfb25fdbcd293d16778e762c2a))
+
+
+### Chores
+
+* **ci:** skip lint on metadata-only changes ([810ca31](https://github.com/lithic-com/lithic-ruby/commit/810ca31d3deeb0fd04c5843496dc601187076633))
+* **ci:** support opting out of skipping builds on metadata-only commits ([40b20fb](https://github.com/lithic-com/lithic-ruby/commit/40b20fb0c3c2c31e2870ee2df86d4a55fac67a04))
+
+
+### Documentation
+
+* **api:** update nature_of_business and qr_code_url field descriptions ([b11902d](https://github.com/lithic-com/lithic-ruby/commit/b11902d30b4b337e7ffc05358df51c18e6ea6648))
+* improve examples ([a7a4a69](https://github.com/lithic-com/lithic-ruby/commit/a7a4a69c9c6930cb8fb3b6bfe4b10e32d1a49213))
+* update examples ([985e1f5](https://github.com/lithic-com/lithic-ruby/commit/985e1f5f0e12517dce490224aaf82021875c8101))
+
+## 0.10.0 (2026-03-23)
+
+Full Changelog: [v0.9.0...v0.10.0](https://github.com/lithic-com/lithic-ruby/compare/v0.9.0...v0.10.0)
+
+### Features
+
+* **api:** Add CARD_AGE and ACCOUNT_AGE attributes to authorization rules ([b5bc545](https://github.com/lithic-com/lithic-ruby/commit/b5bc54552df7e04862780f15b0dc96d2732ad038))
+* **api:** add override_company_name parameter to external payment create ([73612ab](https://github.com/lithic-com/lithic-ruby/commit/73612ab7a4e46f5572f7d12839acddb7beeb4b75))
+* **api:** Add service and merchant location fields ([d0111e3](https://github.com/lithic-com/lithic-ruby/commit/d0111e33b4f6ca04b75f07440f3fc11e0406bbcd))
+
+
+### Chores
+
+* **internal:** replace steady mock server with prism ([180a5d5](https://github.com/lithic-com/lithic-ruby/commit/180a5d5b2986fd1c32ea81bb3b036eb609c35e9a))
+* **internal:** update gitignore ([eac11a4](https://github.com/lithic-com/lithic-ruby/commit/eac11a49332ba63990479fb14e171fcb09edab93))
+* **tests:** bump steady to v0.19.4 ([ecee69a](https://github.com/lithic-com/lithic-ruby/commit/ecee69aa012a80f970784d78a9298db6155dd991))
+* **tests:** bump steady to v0.19.5 ([8a046d1](https://github.com/lithic-com/lithic-ruby/commit/8a046d1ed8d6b7409244efb552809b28937ebed8))
+* **tests:** bump steady to v0.19.6 ([5b45679](https://github.com/lithic-com/lithic-ruby/commit/5b45679d7f42fb122e2c7254a8568189cc8ae2c7))
+
+
+### Documentation
+
+* Update field descriptions for character limits and allowlist requirements ([e999dc1](https://github.com/lithic-com/lithic-ruby/commit/e999dc1091255c9688545bb50e39ec62fcdad9fc))
+
+
+### Refactors
+
+* **tests:** switch from prism to steady ([74cea9d](https://github.com/lithic-com/lithic-ruby/commit/74cea9d46211777e8e1de61ef24f52b0412564cd))
+
 ## 0.9.0 (2026-03-17)
 
 Full Changelog: [v0.8.0...v0.9.0](https://github.com/lithic-com/lithic-ruby/compare/v0.8.0...v0.9.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.9.0"
+gem "lithic", "~> 0.11.0"
 ```
 
 <!-- x-release-please-end -->

data/lib/lithic/internal/util.rb

@@ -157,7 +157,7 @@ module Lithic
           in Hash | nil => coerced
             coerced
           else
-            message = "Expected a #{Hash} or #{Lithic::Internal::Type::BaseModel}, got #{data.inspect}"
+            message = "Expected a #{Hash} or #{Lithic::Internal::Type::BaseModel}, got #{input.inspect}"
             raise ArgumentError.new(message)
           end
         end
@@ -237,6 +237,11 @@ module Lithic
         end
       end
 
+      # @type [Regexp]
+      #
+      # https://www.rfc-editor.org/rfc/rfc3986.html#section-3.3
+      RFC_3986_NOT_PCHARS = /[^A-Za-z0-9\-._~!$&'()*+,;=:@]+/
+
       class << self
         # @api private
         #
@@ -247,6 +252,15 @@ module Lithic
           "#{uri.scheme}://#{uri.host}#{":#{uri.port}" unless uri.port == uri.default_port}"
         end
 
+        # @api private
+        #
+        # @param path [String, Integer]
+        #
+        # @return [String]
+        def encode_path(path)
+          path.to_s.gsub(Lithic::Internal::Util::RFC_3986_NOT_PCHARS) { ERB::Util.url_encode(_1) }
+        end
+
         # @api private
         #
         # @param path [String, Array<String>]
@@ -259,7 +273,7 @@ module Lithic
           in []
             ""
           in [String => p, *interpolations]
-            encoded = interpolations.map { ERB::Util.url_encode(_1) }
+            encoded = interpolations.map { encode_path(_1) }
             format(p, *encoded)
           end
         end
@@ -571,16 +585,15 @@ module Lithic
           y << "Content-Disposition: form-data"
 
           unless key.nil?
-            name = ERB::Util.url_encode(key.to_s)
-            y << "; name=\"#{name}\""
+            y << "; name=\"#{key}\""
           end
 
           case val
           in Lithic::FilePart unless val.filename.nil?
-            filename = ERB::Util.url_encode(val.filename)
+            filename = encode_path(val.filename)
             y << "; filename=\"#{filename}\""
           in Pathname | IO
-            filename = ERB::Util.url_encode(::File.basename(val.to_path))
+            filename = encode_path(::File.basename(val.to_path))
             y << "; filename=\"#{filename}\""
           else
           end
@@ -597,6 +610,7 @@ module Lithic
         #
         # @return [Array(String, Enumerable<String>)]
         private def encode_multipart_streaming(body)
+          # rubocop:disable Style/CaseEquality
           # RFC 1521 Section 7.2.1 says we should have 70 char maximum for boundary length
           boundary = SecureRandom.urlsafe_base64(46)
 
@@ -606,7 +620,7 @@ module Lithic
             in Hash
               body.each do |key, val|
                 case val
-                in Array if val.all? { primitive?(_1) }
+                in Array if val.all? { primitive?(_1) || Lithic::Internal::Type::FileInput === _1 }
                   val.each do |v|
                     write_multipart_chunk(y, boundary: boundary, key: key, val: v, closing: closing)
                   end
@@ -622,6 +636,7 @@ module Lithic
 
           fused_io = fused_enum(strio) { closing.each(&:call) }
           [boundary, fused_io]
+          # rubocop:enable Style/CaseEquality
         end
 
         # @api private

data/lib/lithic/models/account_holder_create_params.rb

@@ -75,7 +75,8 @@ module Lithic
 
           # @!attribute nature_of_business
           #   Short description of the company's line of business (i.e., what does the company
-          #   do?).
+          #   do?). Values longer than 255 characters will be truncated before KYB
+          #   verification
           #
           #   @return [String, nil]
           optional :nature_of_business, String

data/lib/lithic/models/account_holder_update_params.rb

@@ -87,7 +87,8 @@ module Lithic
 
           # @!attribute nature_of_business
           #   Short description of the company's line of business (i.e., what does the company
-          #   do?).
+          #   do?). Values longer than 255 characters will be truncated before KYB
+          #   verification
           #
           #   @return [String, nil]
           optional :nature_of_business, String

data/lib/lithic/models/account_holder_updated_webhook_event.rb

@@ -50,7 +50,8 @@ module Lithic
 
         # @!attribute nature_of_business
         #   Short description of the company's line of business (i.e., what does the company
-        #   do?).
+        #   do?). Values longer than 255 characters will be truncated before KYB
+        #   verification
         #
         #   @return [String, nil]
         optional :nature_of_business, String

data/lib/lithic/models/auth_rules/backtest_stats.rb

@@ -77,12 +77,20 @@ module Lithic
           #   @return [Time, nil]
           optional :timestamp, Time
 
-          # @!method initialize(decision: nil, event_token: nil, timestamp: nil)
+          # @!attribute transaction_token
+          #   The token of the transaction associated with the event
+          #
+          #   @return [String, nil]
+          optional :transaction_token, String, nil?: true
+
+          # @!method initialize(decision: nil, event_token: nil, timestamp: nil, transaction_token: nil)
           #   @param decision [Symbol, Lithic::Models::AuthRules::BacktestStats::Example::Decision] The decision made by the rule for this event.
           #
           #   @param event_token [String] The event token.
           #
           #   @param timestamp [Time] The timestamp of the event.
+          #
+          #   @param transaction_token [String, nil] The token of the transaction associated with the event
 
           # The decision made by the rule for this event.
           #

data/lib/lithic/models/auth_rules/conditional_authorization_action_parameters.rb

@@ -75,6 +75,12 @@ module Lithic
           #     trailing hour up and until the authorization.
           #   - `CARD_TRANSACTION_COUNT_24H`: The number of transactions on the card in the
           #     trailing 24 hours up and until the authorization.
+          #   - `CARD_DECLINE_COUNT_15M`: The number of declined transactions on the card in
+          #     the trailing 15 minutes before the authorization.
+          #   - `CARD_DECLINE_COUNT_1H`: The number of declined transactions on the card in
+          #     the trailing hour up and until the authorization.
+          #   - `CARD_DECLINE_COUNT_24H`: The number of declined transactions on the card in
+          #     the trailing 24 hours up and until the authorization.
           #   - `CARD_STATE`: The current state of the card associated with the transaction.
           #     Valid values are `CLOSED`, `OPEN`, `PAUSED`, `PENDING_ACTIVATION`,
           #     `PENDING_FULFILLMENT`.
@@ -90,6 +96,17 @@ module Lithic
           #   - `ADDRESS_MATCH`: Lithic's evaluation result comparing transaction's address
           #     data with the cardholder KYC data if it exists. Valid values are `MATCH`,
           #     `MATCH_ADDRESS_ONLY`, `MATCH_ZIP_ONLY`,`MISMATCH`,`NOT_PRESENT`.
+          #   - `SERVICE_LOCATION_STATE`: The state/province code (ISO 3166-2) where the
+          #     cardholder received the service, e.g. "NY". When a service location is present
+          #     in the network data, the service location state is used. Otherwise, falls back
+          #     to the card acceptor state.
+          #   - `SERVICE_LOCATION_POSTAL_CODE`: The postal code where the cardholder received
+          #     the service, e.g. "10001". When a service location is present in the network
+          #     data, the service location postal code is used. Otherwise, falls back to the
+          #     card acceptor postal code.
+          #   - `CARD_AGE`: The age of the card in seconds at the time of the authorization.
+          #   - `ACCOUNT_AGE`: The age of the account holder's account in seconds at the time
+          #     of the authorization.
           #
           #   @return [Symbol, Lithic::Models::AuthRules::ConditionalAuthorizationActionParameters::Condition::Attribute]
           required :attribute,
@@ -157,6 +174,12 @@ module Lithic
           #   trailing hour up and until the authorization.
           # - `CARD_TRANSACTION_COUNT_24H`: The number of transactions on the card in the
           #   trailing 24 hours up and until the authorization.
+          # - `CARD_DECLINE_COUNT_15M`: The number of declined transactions on the card in
+          #   the trailing 15 minutes before the authorization.
+          # - `CARD_DECLINE_COUNT_1H`: The number of declined transactions on the card in
+          #   the trailing hour up and until the authorization.
+          # - `CARD_DECLINE_COUNT_24H`: The number of declined transactions on the card in
+          #   the trailing 24 hours up and until the authorization.
           # - `CARD_STATE`: The current state of the card associated with the transaction.
           #   Valid values are `CLOSED`, `OPEN`, `PAUSED`, `PENDING_ACTIVATION`,
           #   `PENDING_FULFILLMENT`.
@@ -172,6 +195,17 @@ module Lithic
           # - `ADDRESS_MATCH`: Lithic's evaluation result comparing transaction's address
           #   data with the cardholder KYC data if it exists. Valid values are `MATCH`,
           #   `MATCH_ADDRESS_ONLY`, `MATCH_ZIP_ONLY`,`MISMATCH`,`NOT_PRESENT`.
+          # - `SERVICE_LOCATION_STATE`: The state/province code (ISO 3166-2) where the
+          #   cardholder received the service, e.g. "NY". When a service location is present
+          #   in the network data, the service location state is used. Otherwise, falls back
+          #   to the card acceptor state.
+          # - `SERVICE_LOCATION_POSTAL_CODE`: The postal code where the cardholder received
+          #   the service, e.g. "10001". When a service location is present in the network
+          #   data, the service location postal code is used. Otherwise, falls back to the
+          #   card acceptor postal code.
+          # - `CARD_AGE`: The age of the card in seconds at the time of the authorization.
+          # - `ACCOUNT_AGE`: The age of the account holder's account in seconds at the time
+          #   of the authorization.
           #
           # @see Lithic::Models::AuthRules::ConditionalAuthorizationActionParameters::Condition#attribute
           module Attribute
@@ -190,12 +224,19 @@ module Lithic
             CARD_TRANSACTION_COUNT_15_M = :CARD_TRANSACTION_COUNT_15M
             CARD_TRANSACTION_COUNT_1_H = :CARD_TRANSACTION_COUNT_1H
             CARD_TRANSACTION_COUNT_24_H = :CARD_TRANSACTION_COUNT_24H
+            CARD_DECLINE_COUNT_15_M = :CARD_DECLINE_COUNT_15M
+            CARD_DECLINE_COUNT_1_H = :CARD_DECLINE_COUNT_1H
+            CARD_DECLINE_COUNT_24_H = :CARD_DECLINE_COUNT_24H
             CARD_STATE = :CARD_STATE
             PIN_ENTERED = :PIN_ENTERED
             PIN_STATUS = :PIN_STATUS
             WALLET_TYPE = :WALLET_TYPE
             TRANSACTION_INITIATOR = :TRANSACTION_INITIATOR
             ADDRESS_MATCH = :ADDRESS_MATCH
+            SERVICE_LOCATION_STATE = :SERVICE_LOCATION_STATE
+            SERVICE_LOCATION_POSTAL_CODE = :SERVICE_LOCATION_POSTAL_CODE
+            CARD_AGE = :CARD_AGE
+            ACCOUNT_AGE = :ACCOUNT_AGE
 
             # @!method self.values
             #   @return [Array<Symbol>]

data/lib/lithic/models/auth_rules/report_stats.rb

@@ -6,110 +6,77 @@ module Lithic
       class ReportStats < Lithic::Internal::Type::BaseModel
         # @!attribute action_counts
         #   A mapping of action types to the number of times that action was returned by
-        #   this rule during the relevant period. Actions are the possible outcomes of a
+        #   this version during the relevant period. Actions are the possible outcomes of a
         #   rule evaluation, such as DECLINE, CHALLENGE, REQUIRE_TFA, etc. In case rule
         #   didn't trigger any action, it's counted under NO_ACTION key.
         #
-        #   @return [Hash{Symbol=>Integer}, nil]
-        optional :action_counts, Lithic::Internal::Type::HashOf[Integer]
+        #   @return [Hash{Symbol=>Integer}]
+        required :action_counts, Lithic::Internal::Type::HashOf[Integer]
 
-        # @!attribute approved
-        #   @deprecated
-        #
-        #   The total number of historical transactions approved by this rule during the
-        #   relevant period, or the number of transactions that would have been approved if
-        #   the rule was evaluated in shadow mode.
-        #
-        #   @return [Integer, nil]
-        optional :approved, Integer
-
-        # @!attribute challenged
-        #   @deprecated
-        #
-        #   The total number of historical transactions challenged by this rule during the
-        #   relevant period, or the number of transactions that would have been challenged
-        #   if the rule was evaluated in shadow mode. Currently applicable only for 3DS Auth
-        #   Rules.
+        # @!attribute examples
+        #   Example events and their outcomes for this version.
         #
-        #   @return [Integer, nil]
-        optional :challenged, Integer
+        #   @return [Array<Lithic::Models::AuthRules::ReportStats::Example>]
+        required :examples, -> { Lithic::Internal::Type::ArrayOf[Lithic::AuthRules::ReportStats::Example] }
 
-        # @!attribute declined
-        #   @deprecated
-        #
-        #   The total number of historical transactions declined by this rule during the
-        #   relevant period, or the number of transactions that would have been declined if
-        #   the rule was evaluated in shadow mode.
+        # @!attribute state
+        #   The evaluation mode of this version during the reported period.
         #
-        #   @return [Integer, nil]
-        optional :declined, Integer
+        #   @return [Symbol, Lithic::Models::AuthRules::ReportStats::State]
+        required :state, enum: -> { Lithic::AuthRules::ReportStats::State }
 
-        # @!attribute examples
-        #   Example events and their outcomes.
+        # @!attribute version
+        #   The rule version number.
         #
-        #   @return [Array<Lithic::Models::AuthRules::ReportStats::Example>, nil]
-        optional :examples, -> { Lithic::Internal::Type::ArrayOf[Lithic::AuthRules::ReportStats::Example] }
+        #   @return [Integer]
+        required :version, Integer
 
-        # @!method initialize(action_counts: nil, approved: nil, challenged: nil, declined: nil, examples: nil)
+        # @!method initialize(action_counts:, examples:, state:, version:)
         #   Some parameter documentations has been truncated, see
         #   {Lithic::Models::AuthRules::ReportStats} for more details.
         #
         #   @param action_counts [Hash{Symbol=>Integer}] A mapping of action types to the number of times that action was returned by thi
         #
-        #   @param approved [Integer] The total number of historical transactions approved by this rule during the rel
-        #
-        #   @param challenged [Integer] The total number of historical transactions challenged by this rule during the r
+        #   @param examples [Array<Lithic::Models::AuthRules::ReportStats::Example>] Example events and their outcomes for this version.
         #
-        #   @param declined [Integer] The total number of historical transactions declined by this rule during the rel
+        #   @param state [Symbol, Lithic::Models::AuthRules::ReportStats::State] The evaluation mode of this version during the reported period.
         #
-        #   @param examples [Array<Lithic::Models::AuthRules::ReportStats::Example>] Example events and their outcomes.
+        #   @param version [Integer] The rule version number.
 
         class Example < Lithic::Internal::Type::BaseModel
           # @!attribute actions
-          #   The actions taken by the rule for this event.
+          #   The actions taken by this version for this event.
           #
-          #   @return [Array<Lithic::Models::AuthRules::ReportStats::Example::Action::DeclineActionAuthorization, Lithic::Models::AuthRules::ReportStats::Example::Action::ChallengeActionAuthorization, Lithic::Models::AuthRules::ReportStats::Example::Action::ResultAuthentication3DSAction, Lithic::Models::AuthRules::ReportStats::Example::Action::DeclineActionTokenization, Lithic::Models::AuthRules::ReportStats::Example::Action::RequireTfaAction, Lithic::Models::AuthRules::ReportStats::Example::Action::ApproveActionACH, Lithic::Models::AuthRules::ReportStats::Example::Action::ReturnAction>, nil]
-          optional :actions,
+          #   @return [Array<Lithic::Models::AuthRules::ReportStats::Example::Action::DeclineActionAuthorization, Lithic::Models::AuthRules::ReportStats::Example::Action::ChallengeActionAuthorization, Lithic::Models::AuthRules::ReportStats::Example::Action::ResultAuthentication3DSAction, Lithic::Models::AuthRules::ReportStats::Example::Action::DeclineActionTokenization, Lithic::Models::AuthRules::ReportStats::Example::Action::RequireTfaAction, Lithic::Models::AuthRules::ReportStats::Example::Action::ApproveActionACH, Lithic::Models::AuthRules::ReportStats::Example::Action::ReturnAction>]
+          required :actions,
                    -> { Lithic::Internal::Type::ArrayOf[union: Lithic::AuthRules::ReportStats::Example::Action] }
 
-          # @!attribute approved
-          #   @deprecated
-          #
-          #   Whether the rule would have approved the request.
-          #
-          #   @return [Boolean, nil]
-          optional :approved, Lithic::Internal::Type::Boolean
-
-          # @!attribute decision
-          #   @deprecated
-          #
-          #   The decision made by the rule for this event.
-          #
-          #   @return [Symbol, Lithic::Models::AuthRules::ReportStats::Example::Decision, nil]
-          optional :decision, enum: -> { Lithic::AuthRules::ReportStats::Example::Decision }
-
           # @!attribute event_token
           #   The event token.
           #
-          #   @return [String, nil]
-          optional :event_token, String
+          #   @return [String]
+          required :event_token, String
 
           # @!attribute timestamp
           #   The timestamp of the event.
           #
-          #   @return [Time, nil]
-          optional :timestamp, Time
+          #   @return [Time]
+          required :timestamp, Time
 
-          # @!method initialize(actions: nil, approved: nil, decision: nil, event_token: nil, timestamp: nil)
-          #   @param actions [Array<Lithic::Models::AuthRules::ReportStats::Example::Action::DeclineActionAuthorization, Lithic::Models::AuthRules::ReportStats::Example::Action::ChallengeActionAuthorization, Lithic::Models::AuthRules::ReportStats::Example::Action::ResultAuthentication3DSAction, Lithic::Models::AuthRules::ReportStats::Example::Action::DeclineActionTokenization, Lithic::Models::AuthRules::ReportStats::Example::Action::RequireTfaAction, Lithic::Models::AuthRules::ReportStats::Example::Action::ApproveActionACH, Lithic::Models::AuthRules::ReportStats::Example::Action::ReturnAction>] The actions taken by the rule for this event.
+          # @!attribute transaction_token
+          #   The token of the transaction associated with the event
           #
-          #   @param approved [Boolean] Whether the rule would have approved the request.
-          #
-          #   @param decision [Symbol, Lithic::Models::AuthRules::ReportStats::Example::Decision] The decision made by the rule for this event.
+          #   @return [String, nil]
+          optional :transaction_token, String, nil?: true
+
+          # @!method initialize(actions:, event_token:, timestamp:, transaction_token: nil)
+          #   @param actions [Array<Lithic::Models::AuthRules::ReportStats::Example::Action::DeclineActionAuthorization, Lithic::Models::AuthRules::ReportStats::Example::Action::ChallengeActionAuthorization, Lithic::Models::AuthRules::ReportStats::Example::Action::ResultAuthentication3DSAction, Lithic::Models::AuthRules::ReportStats::Example::Action::DeclineActionTokenization, Lithic::Models::AuthRules::ReportStats::Example::Action::RequireTfaAction, Lithic::Models::AuthRules::ReportStats::Example::Action::ApproveActionACH, Lithic::Models::AuthRules::ReportStats::Example::Action::ReturnAction>] The actions taken by this version for this event.
           #
           #   @param event_token [String] The event token.
           #
           #   @param timestamp [Time] The timestamp of the event.
+          #
+          #   @param transaction_token [String, nil] The token of the transaction associated with the event
 
           module Action
             extend Lithic::Internal::Type::Union
@@ -529,22 +496,20 @@ module Lithic
             # @!method self.variants
             #   @return [Array(Lithic::Models::AuthRules::ReportStats::Example::Action::DeclineActionAuthorization, Lithic::Models::AuthRules::ReportStats::Example::Action::ChallengeActionAuthorization, Lithic::Models::AuthRules::ReportStats::Example::Action::ResultAuthentication3DSAction, Lithic::Models::AuthRules::ReportStats::Example::Action::DeclineActionTokenization, Lithic::Models::AuthRules::ReportStats::Example::Action::RequireTfaAction, Lithic::Models::AuthRules::ReportStats::Example::Action::ApproveActionACH, Lithic::Models::AuthRules::ReportStats::Example::Action::ReturnAction)]
           end
+        end
 
-          # @deprecated
-          #
-          # The decision made by the rule for this event.
-          #
-          # @see Lithic::Models::AuthRules::ReportStats::Example#decision
-          module Decision
-            extend Lithic::Internal::Type::Enum
+        # The evaluation mode of this version during the reported period.
+        #
+        # @see Lithic::Models::AuthRules::ReportStats#state
+        module State
+          extend Lithic::Internal::Type::Enum
 
-            APPROVED = :APPROVED
-            DECLINED = :DECLINED
-            CHALLENGED = :CHALLENGED
+          ACTIVE = :ACTIVE
+          SHADOW = :SHADOW
+          INACTIVE = :INACTIVE
 
-            # @!method self.values
-            #   @return [Array<Symbol>]
-          end
+          # @!method self.values
+          #   @return [Array<Symbol>]
         end
       end
     end

data/lib/lithic/models/auth_rules/rule_feature.rb

@@ -18,7 +18,7 @@ module Lithic
       # - `CARD`: The card associated with the event. Available for AUTHORIZATION and
       #   THREE_DS_AUTHENTICATION event stream rules.
       # - `ACCOUNT_HOLDER`: The account holder associated with the card. Available for
-      #   THREE_DS_AUTHENTICATION event stream rules.
+      #   AUTHORIZATION and THREE_DS_AUTHENTICATION event stream rules.
       # - `IP_METADATA`: IP address metadata for the request. Available for
       #   THREE_DS_AUTHENTICATION event stream rules.
       # - `SPEND_VELOCITY`: Spend velocity data for the card or account. Requires

data/lib/lithic/models/auth_rules/v2_list_results_response.rb

@@ -67,7 +67,13 @@ module Lithic
           #   @return [Integer]
           required :rule_version, Integer
 
-          # @!method initialize(token:, actions:, auth_rule_token:, evaluation_time:, event_token:, mode:, rule_version:, event_stream: :AUTHORIZATION)
+          # @!attribute transaction_token
+          #   The token of the transaction that triggered the rule evaluation
+          #
+          #   @return [String, nil]
+          required :transaction_token, String, nil?: true
+
+          # @!method initialize(token:, actions:, auth_rule_token:, evaluation_time:, event_token:, mode:, rule_version:, transaction_token:, event_stream: :AUTHORIZATION)
           #   @param token [String] Globally unique identifier for the evaluation
           #
           #   @param actions [Array<Lithic::Models::AuthRules::V2ListResultsResponse::AuthorizationResult::Action::DeclineActionAuthorization, Lithic::Models::AuthRules::V2ListResultsResponse::AuthorizationResult::Action::ChallengeActionAuthorization>] Actions returned by the rule evaluation
@@ -82,6 +88,8 @@ module Lithic
           #
           #   @param rule_version [Integer] Version of the rule that was evaluated
           #
+          #   @param transaction_token [String, nil] The token of the transaction that triggered the rule evaluation
+          #
           #   @param event_stream [Symbol, :AUTHORIZATION] The event stream during which the rule was evaluated
 
           module Action
@@ -295,7 +303,13 @@ module Lithic
           #   @return [Integer]
           required :rule_version, Integer
 
-          # @!method initialize(token:, actions:, auth_rule_token:, evaluation_time:, event_token:, mode:, rule_version:, event_stream: :THREE_DS_AUTHENTICATION)
+          # @!attribute transaction_token
+          #   The token of the transaction that triggered the rule evaluation
+          #
+          #   @return [String, nil]
+          required :transaction_token, String, nil?: true
+
+          # @!method initialize(token:, actions:, auth_rule_token:, evaluation_time:, event_token:, mode:, rule_version:, transaction_token:, event_stream: :THREE_DS_AUTHENTICATION)
           #   @param token [String] Globally unique identifier for the evaluation
           #
           #   @param actions [Array<Lithic::Models::AuthRules::V2ListResultsResponse::Authentication3DSResult::Action>] Actions returned by the rule evaluation
@@ -310,6 +324,8 @@ module Lithic
           #
           #   @param rule_version [Integer] Version of the rule that was evaluated
           #
+          #   @param transaction_token [String, nil] The token of the transaction that triggered the rule evaluation
+          #
           #   @param event_stream [Symbol, :THREE_DS_AUTHENTICATION] The event stream during which the rule was evaluated
 
           class Action < Lithic::Internal::Type::BaseModel
@@ -406,7 +422,13 @@ module Lithic
           #   @return [Integer]
           required :rule_version, Integer
 
-          # @!method initialize(token:, actions:, auth_rule_token:, evaluation_time:, event_token:, mode:, rule_version:, event_stream: :TOKENIZATION)
+          # @!attribute transaction_token
+          #   The token of the transaction that triggered the rule evaluation
+          #
+          #   @return [String, nil]
+          required :transaction_token, String, nil?: true
+
+          # @!method initialize(token:, actions:, auth_rule_token:, evaluation_time:, event_token:, mode:, rule_version:, transaction_token:, event_stream: :TOKENIZATION)
           #   @param token [String] Globally unique identifier for the evaluation
           #
           #   @param actions [Array<Lithic::Models::AuthRules::V2ListResultsResponse::TokenizationResult::Action::DeclineActionTokenization, Lithic::Models::AuthRules::V2ListResultsResponse::TokenizationResult::Action::RequireTfaAction>] Actions returned by the rule evaluation
@@ -421,6 +443,8 @@ module Lithic
           #
           #   @param rule_version [Integer] Version of the rule that was evaluated
           #
+          #   @param transaction_token [String, nil] The token of the transaction that triggered the rule evaluation
+          #
           #   @param event_stream [Symbol, :TOKENIZATION] The event stream during which the rule was evaluated
 
           module Action
@@ -631,7 +655,13 @@ module Lithic
           #   @return [Integer]
           required :rule_version, Integer
 
-          # @!method initialize(token:, actions:, auth_rule_token:, evaluation_time:, event_stream:, event_token:, mode:, rule_version:)
+          # @!attribute transaction_token
+          #   The token of the transaction that triggered the rule evaluation
+          #
+          #   @return [String, nil]
+          required :transaction_token, String, nil?: true
+
+          # @!method initialize(token:, actions:, auth_rule_token:, evaluation_time:, event_stream:, event_token:, mode:, rule_version:, transaction_token:)
           #   @param token [String] Globally unique identifier for the evaluation
           #
           #   @param actions [Array<Lithic::Models::AuthRules::V2ListResultsResponse::ACHResult::Action::ApproveActionACH, Lithic::Models::AuthRules::V2ListResultsResponse::ACHResult::Action::ReturnAction>] Actions returned by the rule evaluation
@@ -647,6 +677,8 @@ module Lithic
           #   @param mode [Symbol, Lithic::Models::AuthRules::V2ListResultsResponse::ACHResult::Mode] The state of the Auth Rule
           #
           #   @param rule_version [Integer] Version of the rule that was evaluated
+          #
+          #   @param transaction_token [String, nil] The token of the transaction that triggered the rule evaluation
 
           module Action
             extend Lithic::Internal::Type::Union