lithic 0.10.0 → 0.12.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 11e88e82fcc0153f5cdb72e8c89059d80322983cad5a04f21f7ee8cb58652a86
-  data.tar.gz: 326182c35442ef57d523b917d1f561302916593e64d9be3e72c4d8c47607ffd5
+  metadata.gz: f0ee91f9eb716880267ff8f0ceec1c0c1a68c030864826cdd077802e802c7b07
+  data.tar.gz: a43b4db3e1c7c2084c6bc79c8b6ab6f9776ce1402f3380e997e977ac6c15a6f2
 SHA512:
-  metadata.gz: da808cf2213f4fb880952816609649f93de70b6b4c544820d0bc3a86c93644f63bafb3a78debe42c0ba3c42bc5c9b62fdef755353f79234f6081990c72be9478
-  data.tar.gz: 29c1e2e9d8dbecf4f4fe2d20942afc6b625935627fe15deffc3b49ab03722f07aadd0eacf5c2146920feb50d6c6ab57f5e18544517dc6ca076c536fbbf890c13
+  metadata.gz: 9bc92ae6b2aed386110d68ee7bc6f423fe5e8c34b16e923b97efeb004c5c1699bab929e41f0af80a7733d32e25d42fd19a09bb22323e2fe3801c10e21ce3da9d
+  data.tar.gz: 7b4c1ecbb2902bc7ecb06e55f730f9db3e25536179e7042ef013de2fc126d8b413a0834f2878824cec583c065c50fc57e0f228a75dcade4f2d5130bf6b7e85b0

data/CHANGELOG.md

@@ -1,5 +1,54 @@
 # Changelog
 
+## 0.12.0 (2026-04-20)
+
+Full Changelog: [v0.11.0...v0.12.0](https://github.com/lithic-com/lithic-ruby/compare/v0.11.0...v0.12.0)
+
+### Features
+
+* **api:** Add card_authorization.challenge_response webhook ([8abc734](https://github.com/lithic-com/lithic-ruby/commit/8abc7348e6ed248c532058d68388fc357e54f65f))
+* **api:** Add card/account/business account signals endpoints and behavioral rule attributes ([76de3de](https://github.com/lithic-com/lithic-ruby/commit/76de3de7a510e54712be632789e90457b7486f3d))
+* **api:** add set_verification_method to external_bank_accounts ([3878cb3](https://github.com/lithic-com/lithic-ruby/commit/3878cb30db9f591d2070bed948cc40da07dd3f0e))
+
+## 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)

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.10.0"
+gem "lithic", "~> 0.12.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/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`.
@@ -101,6 +107,33 @@ module Lithic
           #   - `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.
+          #   - `AMOUNT_Z_SCORE`: The z-score of the transaction amount relative to the
+          #     entity's transaction history. Null if fewer than 30 approved transactions in
+          #     the specified window. Requires `parameters.scope` and `parameters.interval`.
+          #   - `AVG_TRANSACTION_AMOUNT`: The average approved transaction amount for the
+          #     entity over the specified window, in cents. Requires `parameters.scope` and
+          #     `parameters.interval`.
+          #   - `STDEV_TRANSACTION_AMOUNT`: The standard deviation of approved transaction
+          #     amounts for the entity over the specified window, in cents. Null if fewer than
+          #     30 approved transactions in the specified window. Requires `parameters.scope`
+          #     and `parameters.interval`.
+          #   - `IS_NEW_COUNTRY`: Whether the transaction's merchant country has not been seen
+          #     in the entity's transaction history. Valid values are `TRUE`, `FALSE`.
+          #     Requires `parameters.scope`.
+          #   - `IS_NEW_MCC`: Whether the transaction's MCC has not been seen in the entity's
+          #     transaction history. Valid values are `TRUE`, `FALSE`. Requires
+          #     `parameters.scope`.
+          #   - `IS_FIRST_TRANSACTION`: Whether this is the first transaction for the entity.
+          #     Valid values are `TRUE`, `FALSE`. Requires `parameters.scope`.
+          #   - `CONSECUTIVE_DECLINES`: The number of consecutive declined transactions for
+          #     the entity over the last 30 days (rolling). Requires `parameters.scope`. Not
+          #     supported for `BUSINESS_ACCOUNT` scope.
+          #   - `TIME_SINCE_LAST_TRANSACTION`: The number of days since the last approved
+          #     transaction for the entity. Requires `parameters.scope`.
+          #   - `DISTINCT_COUNTRY_COUNT`: The number of distinct merchant countries seen in
+          #     the entity's transaction history. Requires `parameters.scope`.
+          #   - `THREE_DS_SUCCESS_RATE`: The 3DS authentication success rate for the card, as
+          #     a percentage from 0.0 to 100.0. Card-scoped only; no `parameters` required.
           #
           #   @return [Symbol, Lithic::Models::AuthRules::ConditionalAuthorizationActionParameters::Condition::Attribute]
           required :attribute,
@@ -118,7 +151,18 @@ module Lithic
           #   @return [String, Integer, Array<String>, Time]
           required :value, union: -> { Lithic::AuthRules::ConditionalValue }
 
-          # @!method initialize(attribute:, operation:, value:)
+          # @!attribute parameters
+          #   Additional parameters required for transaction history signal attributes.
+          #   Required when `attribute` is one of `AMOUNT_Z_SCORE`, `AVG_TRANSACTION_AMOUNT`,
+          #   `STDEV_TRANSACTION_AMOUNT`, `IS_NEW_COUNTRY`, `IS_NEW_MCC`,
+          #   `IS_FIRST_TRANSACTION`, `CONSECUTIVE_DECLINES`, `TIME_SINCE_LAST_TRANSACTION`,
+          #   or `DISTINCT_COUNTRY_COUNT`. Not used for other attributes.
+          #
+          #   @return [Lithic::Models::AuthRules::ConditionalAuthorizationActionParameters::Condition::Parameters, nil]
+          optional :parameters,
+                   -> { Lithic::AuthRules::ConditionalAuthorizationActionParameters::Condition::Parameters }
+
+          # @!method initialize(attribute:, operation:, value:, parameters: nil)
           #   Some parameter documentations has been truncated, see
           #   {Lithic::Models::AuthRules::ConditionalAuthorizationActionParameters::Condition}
           #   for more details.
@@ -128,6 +172,8 @@ module Lithic
           #   @param operation [Symbol, Lithic::Models::AuthRules::ConditionalOperation] The operation to apply to the attribute
           #
           #   @param value [String, Integer, Array<String>, Time] A regex string, to be used with `MATCHES` or `DOES_NOT_MATCH`
+          #
+          #   @param parameters [Lithic::Models::AuthRules::ConditionalAuthorizationActionParameters::Condition::Parameters] Additional parameters required for transaction history signal attributes. Requir
 
           # The attribute to target.
           #
@@ -168,6 +214,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`.
@@ -194,6 +246,33 @@ module Lithic
           # - `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.
+          # - `AMOUNT_Z_SCORE`: The z-score of the transaction amount relative to the
+          #   entity's transaction history. Null if fewer than 30 approved transactions in
+          #   the specified window. Requires `parameters.scope` and `parameters.interval`.
+          # - `AVG_TRANSACTION_AMOUNT`: The average approved transaction amount for the
+          #   entity over the specified window, in cents. Requires `parameters.scope` and
+          #   `parameters.interval`.
+          # - `STDEV_TRANSACTION_AMOUNT`: The standard deviation of approved transaction
+          #   amounts for the entity over the specified window, in cents. Null if fewer than
+          #   30 approved transactions in the specified window. Requires `parameters.scope`
+          #   and `parameters.interval`.
+          # - `IS_NEW_COUNTRY`: Whether the transaction's merchant country has not been seen
+          #   in the entity's transaction history. Valid values are `TRUE`, `FALSE`.
+          #   Requires `parameters.scope`.
+          # - `IS_NEW_MCC`: Whether the transaction's MCC has not been seen in the entity's
+          #   transaction history. Valid values are `TRUE`, `FALSE`. Requires
+          #   `parameters.scope`.
+          # - `IS_FIRST_TRANSACTION`: Whether this is the first transaction for the entity.
+          #   Valid values are `TRUE`, `FALSE`. Requires `parameters.scope`.
+          # - `CONSECUTIVE_DECLINES`: The number of consecutive declined transactions for
+          #   the entity over the last 30 days (rolling). Requires `parameters.scope`. Not
+          #   supported for `BUSINESS_ACCOUNT` scope.
+          # - `TIME_SINCE_LAST_TRANSACTION`: The number of days since the last approved
+          #   transaction for the entity. Requires `parameters.scope`.
+          # - `DISTINCT_COUNTRY_COUNT`: The number of distinct merchant countries seen in
+          #   the entity's transaction history. Requires `parameters.scope`.
+          # - `THREE_DS_SUCCESS_RATE`: The 3DS authentication success rate for the card, as
+          #   a percentage from 0.0 to 100.0. Card-scoped only; no `parameters` required.
           #
           # @see Lithic::Models::AuthRules::ConditionalAuthorizationActionParameters::Condition#attribute
           module Attribute
@@ -212,6 +291,9 @@ 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
@@ -222,10 +304,85 @@ module Lithic
             SERVICE_LOCATION_POSTAL_CODE = :SERVICE_LOCATION_POSTAL_CODE
             CARD_AGE = :CARD_AGE
             ACCOUNT_AGE = :ACCOUNT_AGE
+            AMOUNT_Z_SCORE = :AMOUNT_Z_SCORE
+            AVG_TRANSACTION_AMOUNT = :AVG_TRANSACTION_AMOUNT
+            STDEV_TRANSACTION_AMOUNT = :STDEV_TRANSACTION_AMOUNT
+            IS_NEW_COUNTRY = :IS_NEW_COUNTRY
+            IS_NEW_MCC = :IS_NEW_MCC
+            IS_FIRST_TRANSACTION = :IS_FIRST_TRANSACTION
+            CONSECUTIVE_DECLINES = :CONSECUTIVE_DECLINES
+            TIME_SINCE_LAST_TRANSACTION = :TIME_SINCE_LAST_TRANSACTION
+            DISTINCT_COUNTRY_COUNT = :DISTINCT_COUNTRY_COUNT
+            THREE_DS_SUCCESS_RATE = :THREE_DS_SUCCESS_RATE
 
             # @!method self.values
             #   @return [Array<Symbol>]
           end
+
+          # @see Lithic::Models::AuthRules::ConditionalAuthorizationActionParameters::Condition#parameters
+          class Parameters < Lithic::Internal::Type::BaseModel
+            # @!attribute interval
+            #   The time window for statistical attributes (`AMOUNT_Z_SCORE`,
+            #   `AVG_TRANSACTION_AMOUNT`, `STDEV_TRANSACTION_AMOUNT`). Use `LIFETIME` for
+            #   all-time history or a specific window (`7D`, `30D`, `90D`).
+            #
+            #   @return [Symbol, Lithic::Models::AuthRules::ConditionalAuthorizationActionParameters::Condition::Parameters::Interval, nil]
+            optional :interval,
+                     enum: -> { Lithic::AuthRules::ConditionalAuthorizationActionParameters::Condition::Parameters::Interval }
+
+            # @!attribute scope
+            #   The entity scope to evaluate the attribute against.
+            #
+            #   @return [Symbol, Lithic::Models::AuthRules::ConditionalAuthorizationActionParameters::Condition::Parameters::Scope, nil]
+            optional :scope,
+                     enum: -> { Lithic::AuthRules::ConditionalAuthorizationActionParameters::Condition::Parameters::Scope }
+
+            # @!method initialize(interval: nil, scope: nil)
+            #   Some parameter documentations has been truncated, see
+            #   {Lithic::Models::AuthRules::ConditionalAuthorizationActionParameters::Condition::Parameters}
+            #   for more details.
+            #
+            #   Additional parameters required for transaction history signal attributes.
+            #   Required when `attribute` is one of `AMOUNT_Z_SCORE`, `AVG_TRANSACTION_AMOUNT`,
+            #   `STDEV_TRANSACTION_AMOUNT`, `IS_NEW_COUNTRY`, `IS_NEW_MCC`,
+            #   `IS_FIRST_TRANSACTION`, `CONSECUTIVE_DECLINES`, `TIME_SINCE_LAST_TRANSACTION`,
+            #   or `DISTINCT_COUNTRY_COUNT`. Not used for other attributes.
+            #
+            #   @param interval [Symbol, Lithic::Models::AuthRules::ConditionalAuthorizationActionParameters::Condition::Parameters::Interval] The time window for statistical attributes (`AMOUNT_Z_SCORE`, `AVG_TRANSACTION_A
+            #
+            #   @param scope [Symbol, Lithic::Models::AuthRules::ConditionalAuthorizationActionParameters::Condition::Parameters::Scope] The entity scope to evaluate the attribute against.
+
+            # The time window for statistical attributes (`AMOUNT_Z_SCORE`,
+            # `AVG_TRANSACTION_AMOUNT`, `STDEV_TRANSACTION_AMOUNT`). Use `LIFETIME` for
+            # all-time history or a specific window (`7D`, `30D`, `90D`).
+            #
+            # @see Lithic::Models::AuthRules::ConditionalAuthorizationActionParameters::Condition::Parameters#interval
+            module Interval
+              extend Lithic::Internal::Type::Enum
+
+              LIFETIME = :LIFETIME
+              INTERVAL_7_D = :"7D"
+              INTERVAL_30_D = :"30D"
+              INTERVAL_90_D = :"90D"
+
+              # @!method self.values
+              #   @return [Array<Symbol>]
+            end
+
+            # The entity scope to evaluate the attribute against.
+            #
+            # @see Lithic::Models::AuthRules::ConditionalAuthorizationActionParameters::Condition::Parameters#scope
+            module Scope
+              extend Lithic::Internal::Type::Enum
+
+              CARD = :CARD
+              ACCOUNT = :ACCOUNT
+              BUSINESS_ACCOUNT = :BUSINESS_ACCOUNT
+
+              # @!method self.values
+              #   @return [Array<Symbol>]
+            end
+          end
         end
       end
     end

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