lithic 0.11.0 → 0.13.0

data/rbi/lithic/models/auth_rules/rule_feature.rbi

@@ -24,6 +24,10 @@ module Lithic
       # - `SPEND_VELOCITY`: Spend velocity data for the card or account. Requires
       #   `scope`, `period`, and optionally `filters` to configure the velocity
       #   calculation. Available for AUTHORIZATION event stream rules.
+      # - `TRANSACTION_HISTORY_SIGNALS`: Behavioral feature state derived from the
+      #   entity's transaction history. Requires `scope` to specify whether to load
+      #   card, account, or business account history. Available for AUTHORIZATION event
+      #   stream rules.
       module RuleFeature
         extend Lithic::Internal::Type::Union
 
@@ -37,7 +41,8 @@ module Lithic
               Lithic::AuthRules::RuleFeature::CardFeature,
               Lithic::AuthRules::RuleFeature::AccountHolderFeature,
               Lithic::AuthRules::RuleFeature::IPMetadataFeature,
-              Lithic::AuthRules::RuleFeature::SpendVelocityFeature
+              Lithic::AuthRules::RuleFeature::SpendVelocityFeature,
+              Lithic::AuthRules::RuleFeature::TransactionHistorySignalsFeature
             )
           end
 
@@ -403,6 +408,104 @@ module Lithic
           end
         end
 
+        class TransactionHistorySignalsFeature < Lithic::Internal::Type::BaseModel
+          OrHash =
+            T.type_alias do
+              T.any(
+                Lithic::AuthRules::RuleFeature::TransactionHistorySignalsFeature,
+                Lithic::Internal::AnyHash
+              )
+            end
+
+          # The entity scope to load transaction history signals for.
+          sig do
+            returns(
+              Lithic::AuthRules::RuleFeature::TransactionHistorySignalsFeature::Scope::OrSymbol
+            )
+          end
+          attr_accessor :scope
+
+          sig { returns(Symbol) }
+          attr_accessor :type
+
+          # The variable name for this feature in the rule function signature
+          sig { returns(T.nilable(String)) }
+          attr_reader :name
+
+          sig { params(name: String).void }
+          attr_writer :name
+
+          sig do
+            params(
+              scope:
+                Lithic::AuthRules::RuleFeature::TransactionHistorySignalsFeature::Scope::OrSymbol,
+              name: String,
+              type: Symbol
+            ).returns(T.attached_class)
+          end
+          def self.new(
+            # The entity scope to load transaction history signals for.
+            scope:,
+            # The variable name for this feature in the rule function signature
+            name: nil,
+            type: :TRANSACTION_HISTORY_SIGNALS
+          )
+          end
+
+          sig do
+            override.returns(
+              {
+                scope:
+                  Lithic::AuthRules::RuleFeature::TransactionHistorySignalsFeature::Scope::OrSymbol,
+                type: Symbol,
+                name: String
+              }
+            )
+          end
+          def to_hash
+          end
+
+          # The entity scope to load transaction history signals for.
+          module Scope
+            extend Lithic::Internal::Type::Enum
+
+            TaggedSymbol =
+              T.type_alias do
+                T.all(
+                  Symbol,
+                  Lithic::AuthRules::RuleFeature::TransactionHistorySignalsFeature::Scope
+                )
+              end
+            OrSymbol = T.type_alias { T.any(Symbol, String) }
+
+            CARD =
+              T.let(
+                :CARD,
+                Lithic::AuthRules::RuleFeature::TransactionHistorySignalsFeature::Scope::TaggedSymbol
+              )
+            ACCOUNT =
+              T.let(
+                :ACCOUNT,
+                Lithic::AuthRules::RuleFeature::TransactionHistorySignalsFeature::Scope::TaggedSymbol
+              )
+            BUSINESS_ACCOUNT =
+              T.let(
+                :BUSINESS_ACCOUNT,
+                Lithic::AuthRules::RuleFeature::TransactionHistorySignalsFeature::Scope::TaggedSymbol
+              )
+
+            sig do
+              override.returns(
+                T::Array[
+                  Lithic::AuthRules::RuleFeature::TransactionHistorySignalsFeature::Scope::TaggedSymbol
+                ]
+              )
+            end
+            def self.values
+            end
+          end
+        end
+
         sig do
           override.returns(T::Array[Lithic::AuthRules::RuleFeature::Variants])
         end

data/rbi/lithic/models/auth_rules/spend_velocity_filters.rbi

@@ -0,0 +1,58 @@
+# typed: strong
+
+module Lithic
+  module Models
+    module AuthRules
+      class SpendVelocityFilters < Lithic::Models::AuthRules::VelocityLimitFilters
+        OrHash =
+          T.type_alias do
+            T.any(
+              Lithic::AuthRules::SpendVelocityFilters,
+              Lithic::Internal::AnyHash
+            )
+          end
+
+        # Tag key-value pairs to exclude from the velocity calculation. Transactions
+        # matching all specified tag key-value pairs will be excluded from the calculated
+        # velocity.
+        sig { returns(T.nilable(T::Hash[Symbol, String])) }
+        attr_accessor :exclude_tags
+
+        # Tag key-value pairs to include in the velocity calculation. Only transactions
+        # matching all specified tag key-value pairs will be included in the calculated
+        # velocity.
+        sig { returns(T.nilable(T::Hash[Symbol, String])) }
+        attr_accessor :include_tags
+
+        sig do
+          params(
+            exclude_tags: T.nilable(T::Hash[Symbol, String]),
+            include_tags: T.nilable(T::Hash[Symbol, String])
+          ).returns(T.attached_class)
+        end
+        def self.new(
+          # Tag key-value pairs to exclude from the velocity calculation. Transactions
+          # matching all specified tag key-value pairs will be excluded from the calculated
+          # velocity.
+          exclude_tags: nil,
+          # Tag key-value pairs to include in the velocity calculation. Only transactions
+          # matching all specified tag key-value pairs will be included in the calculated
+          # velocity.
+          include_tags: nil
+        )
+        end
+
+        sig do
+          override.returns(
+            {
+              exclude_tags: T.nilable(T::Hash[Symbol, String]),
+              include_tags: T.nilable(T::Hash[Symbol, String])
+            }
+          )
+        end
+        def to_hash
+        end
+      end
+    end
+  end
+end

data/rbi/lithic/models/auth_rules/typescript_code_parameters.rbi

@@ -30,7 +30,8 @@ module Lithic
                 Lithic::AuthRules::RuleFeature::CardFeature,
                 Lithic::AuthRules::RuleFeature::AccountHolderFeature,
                 Lithic::AuthRules::RuleFeature::IPMetadataFeature,
-                Lithic::AuthRules::RuleFeature::SpendVelocityFeature
+                Lithic::AuthRules::RuleFeature::SpendVelocityFeature,
+                Lithic::AuthRules::RuleFeature::TransactionHistorySignalsFeature
               )
             ]
           )
@@ -51,7 +52,8 @@ module Lithic
                   Lithic::AuthRules::RuleFeature::CardFeature::OrHash,
                   Lithic::AuthRules::RuleFeature::AccountHolderFeature::OrHash,
                   Lithic::AuthRules::RuleFeature::IPMetadataFeature::OrHash,
-                  Lithic::AuthRules::RuleFeature::SpendVelocityFeature::OrHash
+                  Lithic::AuthRules::RuleFeature::SpendVelocityFeature::OrHash,
+                  Lithic::AuthRules::RuleFeature::TransactionHistorySignalsFeature::OrHash
                 )
               ]
           ).returns(T.attached_class)
@@ -80,7 +82,8 @@ module Lithic
                     Lithic::AuthRules::RuleFeature::CardFeature,
                     Lithic::AuthRules::RuleFeature::AccountHolderFeature,
                     Lithic::AuthRules::RuleFeature::IPMetadataFeature,
-                    Lithic::AuthRules::RuleFeature::SpendVelocityFeature
+                    Lithic::AuthRules::RuleFeature::SpendVelocityFeature,
+                    Lithic::AuthRules::RuleFeature::TransactionHistorySignalsFeature
                   )
                 ]
             }

data/rbi/lithic/models/auth_rules/v2_create_params.rbi

@@ -85,6 +85,7 @@ module Lithic
                   Lithic::AuthRules::ConditionalAuthorizationActionParameters,
                   Lithic::AuthRules::ConditionalACHActionParameters,
                   Lithic::AuthRules::ConditionalTokenizationActionParameters,
+                  Lithic::AuthRules::ConditionalCardTransactionUpdateActionParameters,
                   Lithic::AuthRules::TypescriptCodeParameters
                 )
               )
@@ -101,7 +102,8 @@ module Lithic
             # - `VELOCITY_LIMIT`: AUTHORIZATION event stream.
             # - `MERCHANT_LOCK`: AUTHORIZATION event stream.
             # - `CONDITIONAL_ACTION`: AUTHORIZATION, THREE_DS_AUTHENTICATION, TOKENIZATION,
-            #   ACH_CREDIT_RECEIPT, or ACH_DEBIT_RECEIPT event stream.
+            #   ACH_CREDIT_RECEIPT, ACH_DEBIT_RECEIPT, or CARD_TRANSACTION_UPDATE event
+            #   stream.
             # - `TYPESCRIPT_CODE`: AUTHORIZATION, THREE_DS_AUTHENTICATION, TOKENIZATION,
             #   ACH_CREDIT_RECEIPT, or ACH_DEBIT_RECEIPT event stream.
             sig do
@@ -151,6 +153,7 @@ module Lithic
                     Lithic::AuthRules::ConditionalAuthorizationActionParameters::OrHash,
                     Lithic::AuthRules::ConditionalACHActionParameters::OrHash,
                     Lithic::AuthRules::ConditionalTokenizationActionParameters::OrHash,
+                    Lithic::AuthRules::ConditionalCardTransactionUpdateActionParameters::OrHash,
                     Lithic::AuthRules::TypescriptCodeParameters::OrHash
                   ),
                 type:
@@ -174,7 +177,8 @@ module Lithic
               # - `VELOCITY_LIMIT`: AUTHORIZATION event stream.
               # - `MERCHANT_LOCK`: AUTHORIZATION event stream.
               # - `CONDITIONAL_ACTION`: AUTHORIZATION, THREE_DS_AUTHENTICATION, TOKENIZATION,
-              #   ACH_CREDIT_RECEIPT, or ACH_DEBIT_RECEIPT event stream.
+              #   ACH_CREDIT_RECEIPT, ACH_DEBIT_RECEIPT, or CARD_TRANSACTION_UPDATE event
+              #   stream.
               # - `TYPESCRIPT_CODE`: AUTHORIZATION, THREE_DS_AUTHENTICATION, TOKENIZATION,
               #   ACH_CREDIT_RECEIPT, or ACH_DEBIT_RECEIPT event stream.
               type:,
@@ -201,6 +205,7 @@ module Lithic
                       Lithic::AuthRules::ConditionalAuthorizationActionParameters,
                       Lithic::AuthRules::ConditionalACHActionParameters,
                       Lithic::AuthRules::ConditionalTokenizationActionParameters,
+                      Lithic::AuthRules::ConditionalCardTransactionUpdateActionParameters,
                       Lithic::AuthRules::TypescriptCodeParameters
                     ),
                   type:
@@ -229,6 +234,7 @@ module Lithic
                     Lithic::AuthRules::ConditionalAuthorizationActionParameters,
                     Lithic::AuthRules::ConditionalACHActionParameters,
                     Lithic::AuthRules::ConditionalTokenizationActionParameters,
+                    Lithic::AuthRules::ConditionalCardTransactionUpdateActionParameters,
                     Lithic::AuthRules::TypescriptCodeParameters
                   )
                 end
@@ -254,7 +260,8 @@ module Lithic
             # - `VELOCITY_LIMIT`: AUTHORIZATION event stream.
             # - `MERCHANT_LOCK`: AUTHORIZATION event stream.
             # - `CONDITIONAL_ACTION`: AUTHORIZATION, THREE_DS_AUTHENTICATION, TOKENIZATION,
-            #   ACH_CREDIT_RECEIPT, or ACH_DEBIT_RECEIPT event stream.
+            #   ACH_CREDIT_RECEIPT, ACH_DEBIT_RECEIPT, or CARD_TRANSACTION_UPDATE event
+            #   stream.
             # - `TYPESCRIPT_CODE`: AUTHORIZATION, THREE_DS_AUTHENTICATION, TOKENIZATION,
             #   ACH_CREDIT_RECEIPT, or ACH_DEBIT_RECEIPT event stream.
             module Type
@@ -331,6 +338,7 @@ module Lithic
                   Lithic::AuthRules::ConditionalAuthorizationActionParameters,
                   Lithic::AuthRules::ConditionalACHActionParameters,
                   Lithic::AuthRules::ConditionalTokenizationActionParameters,
+                  Lithic::AuthRules::ConditionalCardTransactionUpdateActionParameters,
                   Lithic::AuthRules::TypescriptCodeParameters
                 )
               )
@@ -347,7 +355,8 @@ module Lithic
             # - `VELOCITY_LIMIT`: AUTHORIZATION event stream.
             # - `MERCHANT_LOCK`: AUTHORIZATION event stream.
             # - `CONDITIONAL_ACTION`: AUTHORIZATION, THREE_DS_AUTHENTICATION, TOKENIZATION,
-            #   ACH_CREDIT_RECEIPT, or ACH_DEBIT_RECEIPT event stream.
+            #   ACH_CREDIT_RECEIPT, ACH_DEBIT_RECEIPT, or CARD_TRANSACTION_UPDATE event
+            #   stream.
             # - `TYPESCRIPT_CODE`: AUTHORIZATION, THREE_DS_AUTHENTICATION, TOKENIZATION,
             #   ACH_CREDIT_RECEIPT, or ACH_DEBIT_RECEIPT event stream.
             sig do
@@ -384,6 +393,7 @@ module Lithic
                     Lithic::AuthRules::ConditionalAuthorizationActionParameters::OrHash,
                     Lithic::AuthRules::ConditionalACHActionParameters::OrHash,
                     Lithic::AuthRules::ConditionalTokenizationActionParameters::OrHash,
+                    Lithic::AuthRules::ConditionalCardTransactionUpdateActionParameters::OrHash,
                     Lithic::AuthRules::TypescriptCodeParameters::OrHash
                   ),
                 type:
@@ -407,7 +417,8 @@ module Lithic
               # - `VELOCITY_LIMIT`: AUTHORIZATION event stream.
               # - `MERCHANT_LOCK`: AUTHORIZATION event stream.
               # - `CONDITIONAL_ACTION`: AUTHORIZATION, THREE_DS_AUTHENTICATION, TOKENIZATION,
-              #   ACH_CREDIT_RECEIPT, or ACH_DEBIT_RECEIPT event stream.
+              #   ACH_CREDIT_RECEIPT, ACH_DEBIT_RECEIPT, or CARD_TRANSACTION_UPDATE event
+              #   stream.
               # - `TYPESCRIPT_CODE`: AUTHORIZATION, THREE_DS_AUTHENTICATION, TOKENIZATION,
               #   ACH_CREDIT_RECEIPT, or ACH_DEBIT_RECEIPT event stream.
               type:,
@@ -431,6 +442,7 @@ module Lithic
                       Lithic::AuthRules::ConditionalAuthorizationActionParameters,
                       Lithic::AuthRules::ConditionalACHActionParameters,
                       Lithic::AuthRules::ConditionalTokenizationActionParameters,
+                      Lithic::AuthRules::ConditionalCardTransactionUpdateActionParameters,
                       Lithic::AuthRules::TypescriptCodeParameters
                     ),
                   type:
@@ -457,6 +469,7 @@ module Lithic
                     Lithic::AuthRules::ConditionalAuthorizationActionParameters,
                     Lithic::AuthRules::ConditionalACHActionParameters,
                     Lithic::AuthRules::ConditionalTokenizationActionParameters,
+                    Lithic::AuthRules::ConditionalCardTransactionUpdateActionParameters,
                     Lithic::AuthRules::TypescriptCodeParameters
                   )
                 end
@@ -482,7 +495,8 @@ module Lithic
             # - `VELOCITY_LIMIT`: AUTHORIZATION event stream.
             # - `MERCHANT_LOCK`: AUTHORIZATION event stream.
             # - `CONDITIONAL_ACTION`: AUTHORIZATION, THREE_DS_AUTHENTICATION, TOKENIZATION,
-            #   ACH_CREDIT_RECEIPT, or ACH_DEBIT_RECEIPT event stream.
+            #   ACH_CREDIT_RECEIPT, ACH_DEBIT_RECEIPT, or CARD_TRANSACTION_UPDATE event
+            #   stream.
             # - `TYPESCRIPT_CODE`: AUTHORIZATION, THREE_DS_AUTHENTICATION, TOKENIZATION,
             #   ACH_CREDIT_RECEIPT, or ACH_DEBIT_RECEIPT event stream.
             module Type
@@ -555,6 +569,7 @@ module Lithic
                   Lithic::AuthRules::ConditionalAuthorizationActionParameters,
                   Lithic::AuthRules::ConditionalACHActionParameters,
                   Lithic::AuthRules::ConditionalTokenizationActionParameters,
+                  Lithic::AuthRules::ConditionalCardTransactionUpdateActionParameters,
                   Lithic::AuthRules::TypescriptCodeParameters
                 )
               )
@@ -575,7 +590,8 @@ module Lithic
             # - `VELOCITY_LIMIT`: AUTHORIZATION event stream.
             # - `MERCHANT_LOCK`: AUTHORIZATION event stream.
             # - `CONDITIONAL_ACTION`: AUTHORIZATION, THREE_DS_AUTHENTICATION, TOKENIZATION,
-            #   ACH_CREDIT_RECEIPT, or ACH_DEBIT_RECEIPT event stream.
+            #   ACH_CREDIT_RECEIPT, ACH_DEBIT_RECEIPT, or CARD_TRANSACTION_UPDATE event
+            #   stream.
             # - `TYPESCRIPT_CODE`: AUTHORIZATION, THREE_DS_AUTHENTICATION, TOKENIZATION,
             #   ACH_CREDIT_RECEIPT, or ACH_DEBIT_RECEIPT event stream.
             sig do
@@ -634,6 +650,7 @@ module Lithic
                     Lithic::AuthRules::ConditionalAuthorizationActionParameters::OrHash,
                     Lithic::AuthRules::ConditionalACHActionParameters::OrHash,
                     Lithic::AuthRules::ConditionalTokenizationActionParameters::OrHash,
+                    Lithic::AuthRules::ConditionalCardTransactionUpdateActionParameters::OrHash,
                     Lithic::AuthRules::TypescriptCodeParameters::OrHash
                   ),
                 program_level: T::Boolean,
@@ -661,7 +678,8 @@ module Lithic
               # - `VELOCITY_LIMIT`: AUTHORIZATION event stream.
               # - `MERCHANT_LOCK`: AUTHORIZATION event stream.
               # - `CONDITIONAL_ACTION`: AUTHORIZATION, THREE_DS_AUTHENTICATION, TOKENIZATION,
-              #   ACH_CREDIT_RECEIPT, or ACH_DEBIT_RECEIPT event stream.
+              #   ACH_CREDIT_RECEIPT, ACH_DEBIT_RECEIPT, or CARD_TRANSACTION_UPDATE event
+              #   stream.
               # - `TYPESCRIPT_CODE`: AUTHORIZATION, THREE_DS_AUTHENTICATION, TOKENIZATION,
               #   ACH_CREDIT_RECEIPT, or ACH_DEBIT_RECEIPT event stream.
               type:,
@@ -690,6 +708,7 @@ module Lithic
                       Lithic::AuthRules::ConditionalAuthorizationActionParameters,
                       Lithic::AuthRules::ConditionalACHActionParameters,
                       Lithic::AuthRules::ConditionalTokenizationActionParameters,
+                      Lithic::AuthRules::ConditionalCardTransactionUpdateActionParameters,
                       Lithic::AuthRules::TypescriptCodeParameters
                     ),
                   program_level: T::Boolean,
@@ -720,6 +739,7 @@ module Lithic
                     Lithic::AuthRules::ConditionalAuthorizationActionParameters,
                     Lithic::AuthRules::ConditionalACHActionParameters,
                     Lithic::AuthRules::ConditionalTokenizationActionParameters,
+                    Lithic::AuthRules::ConditionalCardTransactionUpdateActionParameters,
                     Lithic::AuthRules::TypescriptCodeParameters
                   )
                 end
@@ -745,7 +765,8 @@ module Lithic
             # - `VELOCITY_LIMIT`: AUTHORIZATION event stream.
             # - `MERCHANT_LOCK`: AUTHORIZATION event stream.
             # - `CONDITIONAL_ACTION`: AUTHORIZATION, THREE_DS_AUTHENTICATION, TOKENIZATION,
-            #   ACH_CREDIT_RECEIPT, or ACH_DEBIT_RECEIPT event stream.
+            #   ACH_CREDIT_RECEIPT, ACH_DEBIT_RECEIPT, or CARD_TRANSACTION_UPDATE event
+            #   stream.
             # - `TYPESCRIPT_CODE`: AUTHORIZATION, THREE_DS_AUTHENTICATION, TOKENIZATION,
             #   ACH_CREDIT_RECEIPT, or ACH_DEBIT_RECEIPT event stream.
             module Type

data/rbi/lithic/models/auth_rules/v2_draft_params.rbi

@@ -27,6 +27,7 @@ module Lithic
                 Lithic::AuthRules::ConditionalAuthorizationActionParameters,
                 Lithic::AuthRules::ConditionalACHActionParameters,
                 Lithic::AuthRules::ConditionalTokenizationActionParameters,
+                Lithic::AuthRules::ConditionalCardTransactionUpdateActionParameters,
                 Lithic::AuthRules::TypescriptCodeParameters
               )
             )
@@ -47,6 +48,7 @@ module Lithic
                   Lithic::AuthRules::ConditionalAuthorizationActionParameters::OrHash,
                   Lithic::AuthRules::ConditionalACHActionParameters::OrHash,
                   Lithic::AuthRules::ConditionalTokenizationActionParameters::OrHash,
+                  Lithic::AuthRules::ConditionalCardTransactionUpdateActionParameters::OrHash,
                   Lithic::AuthRules::TypescriptCodeParameters::OrHash
                 )
               ),
@@ -75,6 +77,7 @@ module Lithic
                     Lithic::AuthRules::ConditionalAuthorizationActionParameters,
                     Lithic::AuthRules::ConditionalACHActionParameters,
                     Lithic::AuthRules::ConditionalTokenizationActionParameters,
+                    Lithic::AuthRules::ConditionalCardTransactionUpdateActionParameters,
                     Lithic::AuthRules::TypescriptCodeParameters
                   )
                 ),
@@ -99,6 +102,7 @@ module Lithic
                 Lithic::AuthRules::ConditionalAuthorizationActionParameters,
                 Lithic::AuthRules::ConditionalACHActionParameters,
                 Lithic::AuthRules::ConditionalTokenizationActionParameters,
+                Lithic::AuthRules::ConditionalCardTransactionUpdateActionParameters,
                 Lithic::AuthRules::TypescriptCodeParameters
               )
             end

data/rbi/lithic/models/card_authorization_challenge_response_webhook_event.rbi

@@ -0,0 +1,175 @@
+# typed: strong
+
+module Lithic
+  module Models
+    class CardAuthorizationChallengeResponseWebhookEvent < Lithic::Internal::Type::BaseModel
+      OrHash =
+        T.type_alias do
+          T.any(
+            Lithic::CardAuthorizationChallengeResponseWebhookEvent,
+            Lithic::Internal::AnyHash
+          )
+        end
+
+      # The token of the card associated with the challenge
+      sig { returns(T.nilable(String)) }
+      attr_accessor :card_token
+
+      # The method used to deliver the challenge to the cardholder
+      sig do
+        returns(
+          Lithic::CardAuthorizationChallengeResponseWebhookEvent::ChallengeMethod::TaggedSymbol
+        )
+      end
+      attr_accessor :challenge_method
+
+      # The timestamp of when the challenge was completed
+      sig { returns(T.nilable(Time)) }
+      attr_accessor :completed
+
+      # The timestamp of when the challenge was created
+      sig { returns(Time) }
+      attr_accessor :created
+
+      # Globally unique identifier for the event
+      sig { returns(String) }
+      attr_accessor :event_token
+
+      # Event type
+      sig { returns(Symbol) }
+      attr_accessor :event_type
+
+      # The cardholder's response to the challenge
+      sig do
+        returns(
+          Lithic::CardAuthorizationChallengeResponseWebhookEvent::Response::TaggedSymbol
+        )
+      end
+      attr_accessor :response
+
+      # The token of the transaction associated with the authorization event being
+      # challenged
+      sig { returns(T.nilable(String)) }
+      attr_accessor :transaction_token
+
+      sig do
+        params(
+          card_token: T.nilable(String),
+          challenge_method:
+            Lithic::CardAuthorizationChallengeResponseWebhookEvent::ChallengeMethod::OrSymbol,
+          completed: T.nilable(Time),
+          created: Time,
+          event_token: String,
+          response:
+            Lithic::CardAuthorizationChallengeResponseWebhookEvent::Response::OrSymbol,
+          transaction_token: T.nilable(String),
+          event_type: Symbol
+        ).returns(T.attached_class)
+      end
+      def self.new(
+        # The token of the card associated with the challenge
+        card_token:,
+        # The method used to deliver the challenge to the cardholder
+        challenge_method:,
+        # The timestamp of when the challenge was completed
+        completed:,
+        # The timestamp of when the challenge was created
+        created:,
+        # Globally unique identifier for the event
+        event_token:,
+        # The cardholder's response to the challenge
+        response:,
+        # The token of the transaction associated with the authorization event being
+        # challenged
+        transaction_token:,
+        # Event type
+        event_type: :"card_authorization.challenge_response"
+      )
+      end
+
+      sig do
+        override.returns(
+          {
+            card_token: T.nilable(String),
+            challenge_method:
+              Lithic::CardAuthorizationChallengeResponseWebhookEvent::ChallengeMethod::TaggedSymbol,
+            completed: T.nilable(Time),
+            created: Time,
+            event_token: String,
+            event_type: Symbol,
+            response:
+              Lithic::CardAuthorizationChallengeResponseWebhookEvent::Response::TaggedSymbol,
+            transaction_token: T.nilable(String)
+          }
+        )
+      end
+      def to_hash
+      end
+
+      # The method used to deliver the challenge to the cardholder
+      module ChallengeMethod
+        extend Lithic::Internal::Type::Enum
+
+        TaggedSymbol =
+          T.type_alias do
+            T.all(
+              Symbol,
+              Lithic::CardAuthorizationChallengeResponseWebhookEvent::ChallengeMethod
+            )
+          end
+        OrSymbol = T.type_alias { T.any(Symbol, String) }
+
+        SMS =
+          T.let(
+            :SMS,
+            Lithic::CardAuthorizationChallengeResponseWebhookEvent::ChallengeMethod::TaggedSymbol
+          )
+
+        sig do
+          override.returns(
+            T::Array[
+              Lithic::CardAuthorizationChallengeResponseWebhookEvent::ChallengeMethod::TaggedSymbol
+            ]
+          )
+        end
+        def self.values
+        end
+      end
+
+      # The cardholder's response to the challenge
+      module Response
+        extend Lithic::Internal::Type::Enum
+
+        TaggedSymbol =
+          T.type_alias do
+            T.all(
+              Symbol,
+              Lithic::CardAuthorizationChallengeResponseWebhookEvent::Response
+            )
+          end
+        OrSymbol = T.type_alias { T.any(Symbol, String) }
+
+        APPROVE =
+          T.let(
+            :APPROVE,
+            Lithic::CardAuthorizationChallengeResponseWebhookEvent::Response::TaggedSymbol
+          )
+        DECLINE =
+          T.let(
+            :DECLINE,
+            Lithic::CardAuthorizationChallengeResponseWebhookEvent::Response::TaggedSymbol
+          )
+
+        sig do
+          override.returns(
+            T::Array[
+              Lithic::CardAuthorizationChallengeResponseWebhookEvent::Response::TaggedSymbol
+            ]
+          )
+        end
+        def self.values
+        end
+      end
+    end
+  end
+end

data/rbi/lithic/models/card_create_params.rbi

@@ -78,7 +78,8 @@ module Lithic
       attr_writer :digital_card_art_token
 
       # Two digit (MM) expiry month. If neither `exp_month` nor `exp_year` is provided,
-      # an expiration date will be generated.
+      # an expiration date five years in the future will be generated. Five years is the
+      # maximum expiration date.
       sig { returns(T.nilable(String)) }
       attr_reader :exp_month
 
@@ -86,7 +87,8 @@ module Lithic
       attr_writer :exp_month
 
       # Four digit (yyyy) expiry year. If neither `exp_month` nor `exp_year` is
-      # provided, an expiration date will be generated.
+      # provided, an expiration date five years in the future will be generated. Five
+      # years is the maximum expiration date.
       sig { returns(T.nilable(String)) }
       attr_reader :exp_year
 
@@ -339,10 +341,12 @@ module Lithic
         # [Flexible Card Art Guide](https://docs.lithic.com/docs/about-digital-wallets#flexible-card-art).
         digital_card_art_token: nil,
         # Two digit (MM) expiry month. If neither `exp_month` nor `exp_year` is provided,
-        # an expiration date will be generated.
+        # an expiration date five years in the future will be generated. Five years is the
+        # maximum expiration date.
         exp_month: nil,
         # Four digit (yyyy) expiry year. If neither `exp_month` nor `exp_year` is
-        # provided, an expiration date will be generated.
+        # provided, an expiration date five years in the future will be generated. Five
+        # years is the maximum expiration date.
         exp_year: nil,
         # Friendly name to identify the card.
         memo: nil,

data/rbi/lithic/models/card_renew_params.rbi

@@ -29,7 +29,8 @@ module Lithic
       attr_writer :carrier
 
       # Two digit (MM) expiry month. If neither `exp_month` nor `exp_year` is provided,
-      # an expiration date six years in the future will be generated.
+      # an expiration date five years in the future will be generated. Five years is the
+      # maximum expiration date.
       sig { returns(T.nilable(String)) }
       attr_reader :exp_month
 
@@ -37,7 +38,8 @@ module Lithic
       attr_writer :exp_month
 
       # Four digit (yyyy) expiry year. If neither `exp_month` nor `exp_year` is
-      # provided, an expiration date six years in the future will be generated.
+      # provided, an expiration date five years in the future will be generated. Five
+      # years is the maximum expiration date.
       sig { returns(T.nilable(String)) }
       attr_reader :exp_year
 
@@ -100,10 +102,12 @@ module Lithic
         # If omitted, the previous carrier will be used.
         carrier: nil,
         # Two digit (MM) expiry month. If neither `exp_month` nor `exp_year` is provided,
-        # an expiration date six years in the future will be generated.
+        # an expiration date five years in the future will be generated. Five years is the
+        # maximum expiration date.
         exp_month: nil,
         # Four digit (yyyy) expiry year. If neither `exp_month` nor `exp_year` is
-        # provided, an expiration date six years in the future will be generated.
+        # provided, an expiration date five years in the future will be generated. Five
+        # years is the maximum expiration date.
         exp_year: nil,
         # Specifies the configuration (e.g. physical card art) that the card should be
         # manufactured with, and only applies to cards of type `PHYSICAL`. This must be