lithic 0.13.0 → 0.15.0

data/rbi/lithic/models/transfer_limits_response.rbi

@@ -228,16 +228,14 @@ module Lithic
 
             # Amount originated towards limit
             sig { returns(T.nilable(Integer)) }
-            attr_reader :amount_originated
-
-            sig { params(amount_originated: Integer).void }
-            attr_writer :amount_originated
+            attr_accessor :amount_originated
 
             # Credit limits
             sig do
-              params(limit: Integer, amount_originated: Integer).returns(
-                T.attached_class
-              )
+              params(
+                limit: Integer,
+                amount_originated: T.nilable(Integer)
+              ).returns(T.attached_class)
             end
             def self.new(
               # The limit amount
@@ -248,7 +246,9 @@ module Lithic
             end
 
             sig do
-              override.returns({ limit: Integer, amount_originated: Integer })
+              override.returns(
+                { limit: Integer, amount_originated: T.nilable(Integer) }
+              )
             end
             def to_hash
             end
@@ -269,16 +269,14 @@ module Lithic
 
             # Amount originated towards limit
             sig { returns(T.nilable(Integer)) }
-            attr_reader :amount_originated
-
-            sig { params(amount_originated: Integer).void }
-            attr_writer :amount_originated
+            attr_accessor :amount_originated
 
             # Debit limits
             sig do
-              params(limit: Integer, amount_originated: Integer).returns(
-                T.attached_class
-              )
+              params(
+                limit: Integer,
+                amount_originated: T.nilable(Integer)
+              ).returns(T.attached_class)
             end
             def self.new(
               # The limit amount
@@ -289,7 +287,9 @@ module Lithic
             end
 
             sig do
-              override.returns({ limit: Integer, amount_originated: Integer })
+              override.returns(
+                { limit: Integer, amount_originated: T.nilable(Integer) }
+              )
             end
             def to_hash
             end
@@ -377,16 +377,14 @@ module Lithic
 
             # Amount originated towards limit
             sig { returns(T.nilable(Integer)) }
-            attr_reader :amount_originated
-
-            sig { params(amount_originated: Integer).void }
-            attr_writer :amount_originated
+            attr_accessor :amount_originated
 
             # Credit limits
             sig do
-              params(limit: Integer, amount_originated: Integer).returns(
-                T.attached_class
-              )
+              params(
+                limit: Integer,
+                amount_originated: T.nilable(Integer)
+              ).returns(T.attached_class)
             end
             def self.new(
               # The limit amount
@@ -397,7 +395,9 @@ module Lithic
             end
 
             sig do
-              override.returns({ limit: Integer, amount_originated: Integer })
+              override.returns(
+                { limit: Integer, amount_originated: T.nilable(Integer) }
+              )
             end
             def to_hash
             end
@@ -418,16 +418,14 @@ module Lithic
 
             # Amount originated towards limit
             sig { returns(T.nilable(Integer)) }
-            attr_reader :amount_originated
-
-            sig { params(amount_originated: Integer).void }
-            attr_writer :amount_originated
+            attr_accessor :amount_originated
 
             # Debit limits
             sig do
-              params(limit: Integer, amount_originated: Integer).returns(
-                T.attached_class
-              )
+              params(
+                limit: Integer,
+                amount_originated: T.nilable(Integer)
+              ).returns(T.attached_class)
             end
             def self.new(
               # The limit amount
@@ -438,7 +436,9 @@ module Lithic
             end
 
             sig do
-              override.returns({ limit: Integer, amount_originated: Integer })
+              override.returns(
+                { limit: Integer, amount_originated: T.nilable(Integer) }
+              )
             end
             def to_hash
             end
@@ -531,16 +531,14 @@ module Lithic
 
             # Amount originated towards limit
             sig { returns(T.nilable(Integer)) }
-            attr_reader :amount_originated
-
-            sig { params(amount_originated: Integer).void }
-            attr_writer :amount_originated
+            attr_accessor :amount_originated
 
             # Credit limits
             sig do
-              params(limit: Integer, amount_originated: Integer).returns(
-                T.attached_class
-              )
+              params(
+                limit: Integer,
+                amount_originated: T.nilable(Integer)
+              ).returns(T.attached_class)
             end
             def self.new(
               # The limit amount
@@ -551,7 +549,9 @@ module Lithic
             end
 
             sig do
-              override.returns({ limit: Integer, amount_originated: Integer })
+              override.returns(
+                { limit: Integer, amount_originated: T.nilable(Integer) }
+              )
             end
             def to_hash
             end
@@ -572,16 +572,14 @@ module Lithic
 
             # Amount originated towards limit
             sig { returns(T.nilable(Integer)) }
-            attr_reader :amount_originated
-
-            sig { params(amount_originated: Integer).void }
-            attr_writer :amount_originated
+            attr_accessor :amount_originated
 
             # Debit limits
             sig do
-              params(limit: Integer, amount_originated: Integer).returns(
-                T.attached_class
-              )
+              params(
+                limit: Integer,
+                amount_originated: T.nilable(Integer)
+              ).returns(T.attached_class)
             end
             def self.new(
               # The limit amount
@@ -592,7 +590,9 @@ module Lithic
             end
 
             sig do
-              override.returns({ limit: Integer, amount_originated: Integer })
+              override.returns(
+                { limit: Integer, amount_originated: T.nilable(Integer) }
+              )
             end
             def to_hash
             end

data/rbi/lithic/models.rbi

@@ -53,6 +53,8 @@ module Lithic
 
   AccountRetrieveParams = Lithic::Models::AccountRetrieveParams
 
+  AccountRetrieveSignalsParams = Lithic::Models::AccountRetrieveSignalsParams
+
   AccountRetrieveSpendLimitsParams =
     Lithic::Models::AccountRetrieveSpendLimitsParams
 
@@ -105,12 +107,20 @@ module Lithic
 
   Card = Lithic::Models::Card
 
+  CardAuthorization = Lithic::Models::CardAuthorization
+
   CardAuthorizationApprovalRequestWebhookEvent =
     Lithic::Models::CardAuthorizationApprovalRequestWebhookEvent
 
+  CardAuthorizationChallengeResponseParams =
+    Lithic::Models::CardAuthorizationChallengeResponseParams
+
   CardAuthorizationChallengeResponseWebhookEvent =
     Lithic::Models::CardAuthorizationChallengeResponseWebhookEvent
 
+  CardAuthorizationChallengeWebhookEvent =
+    Lithic::Models::CardAuthorizationChallengeWebhookEvent
+
   CardBulkOrder = Lithic::Models::CardBulkOrder
 
   CardBulkOrderCreateParams = Lithic::Models::CardBulkOrderCreateParams
@@ -153,6 +163,8 @@ module Lithic
 
   CardRetrieveParams = Lithic::Models::CardRetrieveParams
 
+  CardRetrieveSignalsParams = Lithic::Models::CardRetrieveSignalsParams
+
   CardRetrieveSpendLimitsParams = Lithic::Models::CardRetrieveSpendLimitsParams
 
   Cards = Lithic::Models::Cards
@@ -277,6 +289,9 @@ module Lithic
 
   ExternalBankAccountListParams = Lithic::Models::ExternalBankAccountListParams
 
+  ExternalBankAccountPauseParams =
+    Lithic::Models::ExternalBankAccountPauseParams
+
   ExternalBankAccountRetrieveParams =
     Lithic::Models::ExternalBankAccountRetrieveParams
 
@@ -501,6 +516,8 @@ module Lithic
 
   ShippingAddress = Lithic::Models::ShippingAddress
 
+  SignalsResponse = Lithic::Models::SignalsResponse
+
   SpendLimitDuration = Lithic::Models::SpendLimitDuration
 
   StatementsCreatedWebhookEvent = Lithic::Models::StatementsCreatedWebhookEvent

data/rbi/lithic/resources/accounts.rbi

@@ -123,6 +123,27 @@ module Lithic
       )
       end
 
+      # Returns behavioral feature state derived from an account's transaction history.
+      #
+      # These signals expose the same data used by behavioral rule attributes (e.g.
+      # `AMOUNT_Z_SCORE` with `scope: ACCOUNT`, `IS_NEW_COUNTRY` with `scope: ACCOUNT`)
+      # and custom code `TRANSACTION_HISTORY_SIGNALS` features, allowing clients to
+      # inspect feature values before writing rules and debug rule behavior.
+      #
+      # Note: 3DS fields are not available at the account scope and will be null.
+      sig do
+        params(
+          account_token: String,
+          request_options: Lithic::RequestOptions::OrHash
+        ).returns(Lithic::SignalsResponse)
+      end
+      def retrieve_signals(
+        # The token of the account to fetch signals for.
+        account_token,
+        request_options: {}
+      )
+      end
+
       # Get an Account's available spend limits, which is based on the spend limit
       # configured on the Account and the amount already spent over the spend limit's
       # duration. For example, if the Account has a daily spend limit of $1000

data/rbi/lithic/resources/auth_rules/v2.rbi

@@ -123,7 +123,8 @@ module Lithic
                   Lithic::AuthRules::ConditionalACHActionParameters::OrHash,
                   Lithic::AuthRules::ConditionalTokenizationActionParameters::OrHash,
                   Lithic::AuthRules::ConditionalCardTransactionUpdateActionParameters::OrHash,
-                  Lithic::AuthRules::TypescriptCodeParameters::OrHash
+                  Lithic::AuthRules::TypescriptCodeParameters::OrHash,
+                  Lithic::AuthRules::ConditionalAuthorizationAdjustmentParameters::OrHash
                 )
               ),
             request_options: Lithic::RequestOptions::OrHash

data/rbi/lithic/resources/card_authorizations.rbi

@@ -0,0 +1,35 @@
+# typed: strong
+
+module Lithic
+  module Resources
+    class CardAuthorizations
+      # Card program's response to Authorization Challenge. Programs that have
+      # Authorization Challenges configured as Out of Band receive a
+      # [card_authorization.challenge](https://docs.lithic.com/reference/post_card-authorization-challenge)
+      # webhook when an authorization attempt triggers a challenge. The card program
+      # should respond using this endpoint after the cardholder completes the challenge.
+      sig do
+        params(
+          event_token: String,
+          response:
+            Lithic::CardAuthorizationChallengeResponseParams::Response::OrSymbol,
+          request_options: Lithic::RequestOptions::OrHash
+        ).void
+      end
+      def challenge_response(
+        # Globally unique identifier for the authorization event that triggered the
+        # challenge
+        event_token,
+        # Whether the cardholder has approved or declined the issued challenge
+        response:,
+        request_options: {}
+      )
+      end
+
+      # @api private
+      sig { params(client: Lithic::Client).returns(T.attached_class) }
+      def self.new(client:)
+      end
+    end
+  end
+end

data/rbi/lithic/resources/cards.rbi

@@ -590,6 +590,25 @@ module Lithic
       )
       end
 
+      # Returns behavioral feature state derived from a card's transaction history.
+      #
+      # These signals expose the same data used by behavioral rule attributes (e.g.
+      # `AMOUNT_Z_SCORE` with `scope: CARD`, `IS_NEW_COUNTRY` with `scope: CARD`) and
+      # custom code `TRANSACTION_HISTORY_SIGNALS` features, allowing clients to inspect
+      # feature values before writing rules and debug rule behavior.
+      sig do
+        params(
+          card_token: String,
+          request_options: Lithic::RequestOptions::OrHash
+        ).returns(Lithic::SignalsResponse)
+      end
+      def retrieve_signals(
+        # The token of the card to fetch signals for.
+        card_token,
+        request_options: {}
+      )
+      end
+
       # Get a Card's available spend limit, which is based on the spend limit configured
       # on the Card and the amount already spent over the spend limit's duration. For
       # example, if the Card has a monthly spend limit of $1000 configured, and has

data/rbi/lithic/resources/external_bank_accounts.rbi

@@ -116,6 +116,16 @@ module Lithic
       )
       end
 
+      # Pause an external bank account
+      sig do
+        params(
+          external_bank_account_token: String,
+          request_options: Lithic::RequestOptions::OrHash
+        ).returns(Lithic::ExternalBankAccount)
+      end
+      def pause(external_bank_account_token, request_options: {})
+      end
+
       # Retry external bank account micro deposit verification.
       sig do
         params(

data/rbi/lithic/resources/webhooks.rbi

@@ -17,6 +17,7 @@ module Lithic
             Lithic::AccountHolderVerificationWebhookEvent,
             Lithic::AccountHolderDocumentUpdatedWebhookEvent,
             Lithic::CardAuthorizationApprovalRequestWebhookEvent,
+            Lithic::CardAuthorizationChallengeWebhookEvent,
             Lithic::CardAuthorizationChallengeResponseWebhookEvent,
             Lithic::AuthRulesBacktestReportCreatedWebhookEvent,
             Lithic::BalanceUpdatedWebhookEvent,
@@ -81,7 +82,9 @@ module Lithic
       )
       end
 
-      sig { params(payload: String).returns(Lithic::ParsedWebhookEvent::Variants) }
+      sig do
+        params(payload: String).returns(Lithic::ParsedWebhookEvent::Variants)
+      end
       def parse_unsafe(payload)
       end
 

data/sig/lithic/client.rbs

@@ -31,6 +31,8 @@ module Lithic
 
     attr_reader cards: Lithic::Resources::Cards
 
+    attr_reader card_authorizations: Lithic::Resources::CardAuthorizations
+
     attr_reader card_bulk_orders: Lithic::Resources::CardBulkOrders
 
     attr_reader balances: Lithic::Resources::Balances

data/sig/lithic/models/account_holder_simulate_enrollment_review_response.rbs

@@ -11,9 +11,9 @@ module Lithic
         created: Time,
         email: String,
         exemption_type: Lithic::Models::AccountHolderSimulateEnrollmentReviewResponse::exemption_type?,
-        external_id: String,
+        external_id: String?,
         individual: Lithic::Models::AccountHolderSimulateEnrollmentReviewResponse::Individual,
-        naics_code: String,
+        naics_code: String?,
         nature_of_business: String,
         phone_number: String,
         required_documents: ::Array[Lithic::RequiredDocument],
@@ -63,9 +63,7 @@ module Lithic
 
       attr_accessor exemption_type: Lithic::Models::AccountHolderSimulateEnrollmentReviewResponse::exemption_type?
 
-      attr_reader external_id: String?
-
-      def external_id=: (String) -> String
+      attr_accessor external_id: String?
 
       attr_reader individual: Lithic::Models::AccountHolderSimulateEnrollmentReviewResponse::Individual?
 
@@ -73,9 +71,7 @@ module Lithic
         Lithic::Models::AccountHolderSimulateEnrollmentReviewResponse::Individual
       ) -> Lithic::Models::AccountHolderSimulateEnrollmentReviewResponse::Individual
 
-      attr_reader naics_code: String?
-
-      def naics_code=: (String) -> String
+      attr_accessor naics_code: String?
 
       attr_reader nature_of_business: String?
 
@@ -129,9 +125,9 @@ module Lithic
         ?created: Time,
         ?email: String,
         ?exemption_type: Lithic::Models::AccountHolderSimulateEnrollmentReviewResponse::exemption_type?,
-        ?external_id: String,
+        ?external_id: String?,
         ?individual: Lithic::Models::AccountHolderSimulateEnrollmentReviewResponse::Individual,
-        ?naics_code: String,
+        ?naics_code: String?,
         ?nature_of_business: String,
         ?phone_number: String,
         ?required_documents: ::Array[Lithic::RequiredDocument],
@@ -152,9 +148,9 @@ module Lithic
         created: Time,
         email: String,
         exemption_type: Lithic::Models::AccountHolderSimulateEnrollmentReviewResponse::exemption_type?,
-        external_id: String,
+        external_id: String?,
         individual: Lithic::Models::AccountHolderSimulateEnrollmentReviewResponse::Individual,
-        naics_code: String,
+        naics_code: String?,
         nature_of_business: String,
         phone_number: String,
         required_documents: ::Array[Lithic::RequiredDocument],

data/sig/lithic/models/account_retrieve_signals_params.rbs

@@ -0,0 +1,23 @@
+module Lithic
+  module Models
+    type account_retrieve_signals_params =
+      { account_token: String } & Lithic::Internal::Type::request_parameters
+
+    class AccountRetrieveSignalsParams < Lithic::Internal::Type::BaseModel
+      extend Lithic::Internal::Type::RequestParameters::Converter
+      include Lithic::Internal::Type::RequestParameters
+
+      attr_accessor account_token: String
+
+      def initialize: (
+        account_token: String,
+        ?request_options: Lithic::request_opts
+      ) -> void
+
+      def to_hash: -> {
+        account_token: String,
+        request_options: Lithic::RequestOptions
+      }
+    end
+  end
+end

data/sig/lithic/models/auth_rules/auth_rule.rbs

@@ -128,6 +128,7 @@ module Lithic
             | Lithic::AuthRules::ConditionalTokenizationActionParameters
             | Lithic::AuthRules::ConditionalCardTransactionUpdateActionParameters
             | Lithic::AuthRules::TypescriptCodeParameters
+            | Lithic::AuthRules::ConditionalAuthorizationAdjustmentParameters
 
           module Parameters
             extend Lithic::Internal::Type::Union
@@ -177,6 +178,7 @@ module Lithic
             | Lithic::AuthRules::ConditionalTokenizationActionParameters
             | Lithic::AuthRules::ConditionalCardTransactionUpdateActionParameters
             | Lithic::AuthRules::TypescriptCodeParameters
+            | Lithic::AuthRules::ConditionalAuthorizationAdjustmentParameters
 
           module Parameters
             extend Lithic::Internal::Type::Union

data/sig/lithic/models/auth_rules/auth_rule_version.rbs

@@ -44,6 +44,7 @@ module Lithic
           | Lithic::AuthRules::ConditionalTokenizationActionParameters
           | Lithic::AuthRules::ConditionalCardTransactionUpdateActionParameters
           | Lithic::AuthRules::TypescriptCodeParameters
+          | Lithic::AuthRules::ConditionalAuthorizationAdjustmentParameters
 
         module Parameters
           extend Lithic::Internal::Type::Union

data/sig/lithic/models/auth_rules/conditional_authorization_action_parameters.rbs

@@ -106,6 +106,8 @@ module Lithic
             | :DISTINCT_COUNTRY_COUNT
             | :IS_NEW_MERCHANT
             | :THREE_DS_SUCCESS_RATE
+            | :TRAVEL_SPEED
+            | :DISTANCE_FROM_LAST_TRANSACTION
 
           module Attribute
             extend Lithic::Internal::Type::Enum
@@ -147,6 +149,8 @@ module Lithic
             DISTINCT_COUNTRY_COUNT: :DISTINCT_COUNTRY_COUNT
             IS_NEW_MERCHANT: :IS_NEW_MERCHANT
             THREE_DS_SUCCESS_RATE: :THREE_DS_SUCCESS_RATE
+            TRAVEL_SPEED: :TRAVEL_SPEED
+            DISTANCE_FROM_LAST_TRANSACTION: :DISTANCE_FROM_LAST_TRANSACTION
 
             def self?.values: -> ::Array[Lithic::Models::AuthRules::ConditionalAuthorizationActionParameters::Condition::attribute]
           end
@@ -154,7 +158,8 @@ module Lithic
           type parameters =
             {
               interval: Lithic::Models::AuthRules::ConditionalAuthorizationActionParameters::Condition::Parameters::interval,
-              scope: Lithic::Models::AuthRules::ConditionalAuthorizationActionParameters::Condition::Parameters::scope
+              scope: Lithic::Models::AuthRules::ConditionalAuthorizationActionParameters::Condition::Parameters::scope,
+              unit: Lithic::Models::AuthRules::ConditionalAuthorizationActionParameters::Condition::Parameters::unit
             }
 
           class Parameters < Lithic::Internal::Type::BaseModel
@@ -170,14 +175,22 @@ module Lithic
               Lithic::Models::AuthRules::ConditionalAuthorizationActionParameters::Condition::Parameters::scope
             ) -> Lithic::Models::AuthRules::ConditionalAuthorizationActionParameters::Condition::Parameters::scope
 
+            attr_reader unit: Lithic::Models::AuthRules::ConditionalAuthorizationActionParameters::Condition::Parameters::unit?
+
+            def unit=: (
+              Lithic::Models::AuthRules::ConditionalAuthorizationActionParameters::Condition::Parameters::unit
+            ) -> Lithic::Models::AuthRules::ConditionalAuthorizationActionParameters::Condition::Parameters::unit
+
             def initialize: (
               ?interval: Lithic::Models::AuthRules::ConditionalAuthorizationActionParameters::Condition::Parameters::interval,
-              ?scope: Lithic::Models::AuthRules::ConditionalAuthorizationActionParameters::Condition::Parameters::scope
+              ?scope: Lithic::Models::AuthRules::ConditionalAuthorizationActionParameters::Condition::Parameters::scope,
+              ?unit: Lithic::Models::AuthRules::ConditionalAuthorizationActionParameters::Condition::Parameters::unit
             ) -> void
 
             def to_hash: -> {
               interval: Lithic::Models::AuthRules::ConditionalAuthorizationActionParameters::Condition::Parameters::interval,
-              scope: Lithic::Models::AuthRules::ConditionalAuthorizationActionParameters::Condition::Parameters::scope
+              scope: Lithic::Models::AuthRules::ConditionalAuthorizationActionParameters::Condition::Parameters::scope,
+              unit: Lithic::Models::AuthRules::ConditionalAuthorizationActionParameters::Condition::Parameters::unit
             }
 
             type interval = :LIFETIME | :"7D" | :"30D" | :"90D"
@@ -204,6 +217,19 @@ module Lithic
 
               def self?.values: -> ::Array[Lithic::Models::AuthRules::ConditionalAuthorizationActionParameters::Condition::Parameters::scope]
             end
+
+            type unit = :MPH | :KPH | :MILES | :KILOMETERS
+
+            module Unit
+              extend Lithic::Internal::Type::Enum
+
+              MPH: :MPH
+              KPH: :KPH
+              MILES: :MILES
+              KILOMETERS: :KILOMETERS
+
+              def self?.values: -> ::Array[Lithic::Models::AuthRules::ConditionalAuthorizationActionParameters::Condition::Parameters::unit]
+            end
           end
         end
       end