prelude-sdk 0.4.0 → 0.6.0

data/rbi/prelude_sdk/models/verification_create_params.rbi

@@ -258,6 +258,37 @@ module PreludeSDK
         sig { params(callback_url: String).void }
         attr_writer :callback_url
 
+        # The channels this verification may use, in the order they are tried. Channels
+        # you omit are never used, including on retries. This option can only be set when
+        # the verification is created. The list is recorded on the verification and
+        # applies for its whole lifecycle, so `channels` sent while retrying an existing
+        # verification is ignored — unlike `preferred_channel`, which is honored on every
+        # retry. Every channel you list must be enabled on your account and active in the
+        # destination country, otherwise the request fails with
+        # `channel_not_enabled_in_region`. Prelude still picks the best provider within
+        # each channel. Cannot be combined with `preferred_channel`. Voice is requested
+        # through `method` instead. Disabled by default — contact support to enable it.
+        sig do
+          returns(
+            T.nilable(
+              T::Array[
+                PreludeSDK::VerificationCreateParams::Options::Channel::OrSymbol
+              ]
+            )
+          )
+        end
+        attr_reader :channels
+
+        sig do
+          params(
+            channels:
+              T::Array[
+                PreludeSDK::VerificationCreateParams::Options::Channel::OrSymbol
+              ]
+          ).void
+        end
+        attr_writer :channels
+
         # The size of the code generated. It should be between 4 and 8. Defaults to the
         # code size specified from the Dashboard.
         sig { returns(T.nilable(Integer)) }
@@ -275,6 +306,19 @@ module PreludeSDK
         sig { params(custom_code: String).void }
         attr_writer :custom_code
 
+        # When `true`, the verification is routed through challenge-safe channels
+        # (non-SMS/Voice) regardless of country eligibility or any antispam outcome. The
+        # resulting verification has `status: "challenged"`. Use this when you have your
+        # own signal that the request is suspicious and want stricter routing — the
+        # verification is **not** classified as fraud and does not contribute to
+        # anti-fraud counters or risk factors. This feature is disabled by default —
+        # contact Prelude support to enable it on your account.
+        sig { returns(T.nilable(T::Boolean)) }
+        attr_reader :force_challenge
+
+        sig { params(force_challenge: T::Boolean).void }
+        attr_writer :force_challenge
+
         # A BCP-47 formatted locale string with the language the text message will be sent
         # to. If there's no locale set, the language will be determined by the country
         # code of the phone number. If the language specified doesn't exist, it defaults
@@ -285,6 +329,27 @@ module PreludeSDK
         sig { params(locale: String).void }
         attr_writer :locale
 
+        # Maximum number of delivery attempts Prelude may add on its own after the one you
+        # requested. `0` means a single attempt: if it cannot be delivered, Prelude
+        # neither tries another provider nor another channel, and does not retry
+        # automatically. `1` allows one additional attempt, and so on — a value larger
+        # than the number of routes available for the destination simply behaves like the
+        # default. When omitted, Prelude retries as your account is configured, across as
+        # many channels as the route offers.
+        #
+        # This option can only be set when the verification is created. The value is
+        # recorded on the verification and applies for its whole lifecycle, so a
+        # `max_auto_fallbacks` sent while retrying an existing verification is ignored —
+        # the limit cannot be raised or lowered after the fact. A retry you ask for is not
+        # an automatic attempt, so it gets a fresh allowance of the same limit. This
+        # option is disabled by default — contact Prelude support to enable it on your
+        # account.
+        sig { returns(T.nilable(Integer)) }
+        attr_reader :max_auto_fallbacks
+
+        sig { params(max_auto_fallbacks: Integer).void }
+        attr_writer :max_auto_fallbacks
+
         # The method used for verifying this phone number. The 'voice' option provides an
         # accessible alternative for visually impaired users by delivering the
         # verification code through a phone call rather than a text message. It also
@@ -309,7 +374,12 @@ module PreludeSDK
         end
         attr_writer :verification_method
 
-        # The preferred channel to be used in priority for verification.
+        # The channel to prioritize when delivering the verification. Prelude prioritizes
+        # this channel on the first attempt and continues to prefer it on retries while an
+        # untried route on that channel remains; once those are exhausted, retries fall
+        # back to the next best available route. If the channel is unavailable (for
+        # example, when a verification is challenged), Prelude uses the best available
+        # route instead. Cannot be combined with `channels`.
         sig do
           returns(
             T.nilable(
@@ -356,9 +426,15 @@ module PreludeSDK
             app_realm:
               PreludeSDK::VerificationCreateParams::Options::AppRealm::OrHash,
             callback_url: String,
+            channels:
+              T::Array[
+                PreludeSDK::VerificationCreateParams::Options::Channel::OrSymbol
+              ],
             code_size: Integer,
             custom_code: String,
+            force_challenge: T::Boolean,
             locale: String,
+            max_auto_fallbacks: Integer,
             verification_method:
               PreludeSDK::VerificationCreateParams::Options::Method::OrSymbol,
             preferred_channel:
@@ -376,6 +452,17 @@ module PreludeSDK
           # verification creation, attempt creation, and delivery status changes. For more
           # details, refer to [Webhook](/verify/v2/documentation/webhook).
           callback_url: nil,
+          # The channels this verification may use, in the order they are tried. Channels
+          # you omit are never used, including on retries. This option can only be set when
+          # the verification is created. The list is recorded on the verification and
+          # applies for its whole lifecycle, so `channels` sent while retrying an existing
+          # verification is ignored — unlike `preferred_channel`, which is honored on every
+          # retry. Every channel you list must be enabled on your account and active in the
+          # destination country, otherwise the request fails with
+          # `channel_not_enabled_in_region`. Prelude still picks the best provider within
+          # each channel. Cannot be combined with `preferred_channel`. Voice is requested
+          # through `method` instead. Disabled by default — contact support to enable it.
+          channels: nil,
           # The size of the code generated. It should be between 4 and 8. Defaults to the
           # code size specified from the Dashboard.
           code_size: nil,
@@ -383,11 +470,35 @@ module PreludeSDK
           # contact us to enable it for your account. For more details, refer to
           # [Custom Code](/verify/v2/documentation/custom-codes).
           custom_code: nil,
+          # When `true`, the verification is routed through challenge-safe channels
+          # (non-SMS/Voice) regardless of country eligibility or any antispam outcome. The
+          # resulting verification has `status: "challenged"`. Use this when you have your
+          # own signal that the request is suspicious and want stricter routing — the
+          # verification is **not** classified as fraud and does not contribute to
+          # anti-fraud counters or risk factors. This feature is disabled by default —
+          # contact Prelude support to enable it on your account.
+          force_challenge: nil,
           # A BCP-47 formatted locale string with the language the text message will be sent
           # to. If there's no locale set, the language will be determined by the country
           # code of the phone number. If the language specified doesn't exist, it defaults
           # to US English.
           locale: nil,
+          # Maximum number of delivery attempts Prelude may add on its own after the one you
+          # requested. `0` means a single attempt: if it cannot be delivered, Prelude
+          # neither tries another provider nor another channel, and does not retry
+          # automatically. `1` allows one additional attempt, and so on — a value larger
+          # than the number of routes available for the destination simply behaves like the
+          # default. When omitted, Prelude retries as your account is configured, across as
+          # many channels as the route offers.
+          #
+          # This option can only be set when the verification is created. The value is
+          # recorded on the verification and applies for its whole lifecycle, so a
+          # `max_auto_fallbacks` sent while retrying an existing verification is ignored —
+          # the limit cannot be raised or lowered after the fact. A retry you ask for is not
+          # an automatic attempt, so it gets a fresh allowance of the same limit. This
+          # option is disabled by default — contact Prelude support to enable it on your
+          # account.
+          max_auto_fallbacks: nil,
           # The method used for verifying this phone number. The 'voice' option provides an
           # accessible alternative for visually impaired users by delivering the
           # verification code through a phone call rather than a text message. It also
@@ -396,7 +507,12 @@ module PreludeSDK
           # skips silent verification, useful for scenarios requiring direct user
           # interaction.
           verification_method: nil,
-          # The preferred channel to be used in priority for verification.
+          # The channel to prioritize when delivering the verification. Prelude prioritizes
+          # this channel on the first attempt and continues to prefer it on retries while an
+          # untried route on that channel remains; once those are exhausted, retries fall
+          # back to the next best available route. If the channel is unavailable (for
+          # example, when a verification is challenged), Prelude uses the best available
+          # route instead. Cannot be combined with `channels`.
           preferred_channel: nil,
           # The Sender ID to use for this message. The Sender ID needs to be enabled by
           # Prelude.
@@ -415,9 +531,15 @@ module PreludeSDK
               app_realm:
                 PreludeSDK::VerificationCreateParams::Options::AppRealm,
               callback_url: String,
+              channels:
+                T::Array[
+                  PreludeSDK::VerificationCreateParams::Options::Channel::OrSymbol
+                ],
               code_size: Integer,
               custom_code: String,
+              force_challenge: T::Boolean,
               locale: String,
+              max_auto_fallbacks: Integer,
               verification_method:
                 PreludeSDK::VerificationCreateParams::Options::Method::OrSymbol,
               preferred_channel:
@@ -530,6 +652,60 @@ module PreludeSDK
           end
         end
 
+        module Channel
+          extend PreludeSDK::Internal::Type::Enum
+
+          TaggedSymbol =
+            T.type_alias do
+              T.all(
+                Symbol,
+                PreludeSDK::VerificationCreateParams::Options::Channel
+              )
+            end
+          OrSymbol = T.type_alias { T.any(Symbol, String) }
+
+          SMS =
+            T.let(
+              :sms,
+              PreludeSDK::VerificationCreateParams::Options::Channel::TaggedSymbol
+            )
+          RCS =
+            T.let(
+              :rcs,
+              PreludeSDK::VerificationCreateParams::Options::Channel::TaggedSymbol
+            )
+          WHATSAPP =
+            T.let(
+              :whatsapp,
+              PreludeSDK::VerificationCreateParams::Options::Channel::TaggedSymbol
+            )
+          VIBER =
+            T.let(
+              :viber,
+              PreludeSDK::VerificationCreateParams::Options::Channel::TaggedSymbol
+            )
+          ZALO =
+            T.let(
+              :zalo,
+              PreludeSDK::VerificationCreateParams::Options::Channel::TaggedSymbol
+            )
+          TELEGRAM =
+            T.let(
+              :telegram,
+              PreludeSDK::VerificationCreateParams::Options::Channel::TaggedSymbol
+            )
+
+          sig do
+            override.returns(
+              T::Array[
+                PreludeSDK::VerificationCreateParams::Options::Channel::TaggedSymbol
+              ]
+            )
+          end
+          def self.values
+          end
+        end
+
         # The method used for verifying this phone number. The 'voice' option provides an
         # accessible alternative for visually impaired users by delivering the
         # verification code through a phone call rather than a text message. It also
@@ -576,7 +752,12 @@ module PreludeSDK
           end
         end
 
-        # The preferred channel to be used in priority for verification.
+        # The channel to prioritize when delivering the verification. Prelude prioritizes
+        # this channel on the first attempt and continues to prefer it on retries while an
+        # untried route on that channel remains; once those are exhausted, retries fall
+        # back to the next best available route. If the channel is unavailable (for
+        # example, when a verification is challenged), Prelude uses the best available
+        # route instead. Cannot be combined with `channels`.
         module PreferredChannel
           extend PreludeSDK::Internal::Type::Enum
 

data/rbi/prelude_sdk/models/verification_create_response.rbi

@@ -31,6 +31,9 @@ module PreludeSDK
       #   non-voice channels only. This mode must be enabled for your customer account
       #   by Prelude support.
       # - `blocked` - The verification was blocked.
+      # - `shadow_blocked` - The verification triggered a block rule but the decision
+      #   was not enforced; this is used to dry-run anti-fraud configuration. This mode
+      #   must be enabled for your customer account by Prelude support.
       sig do
         returns(
           PreludeSDK::Models::VerificationCreateResponse::Status::TaggedSymbol
@@ -77,7 +80,7 @@ module PreludeSDK
       attr_writer :metadata
 
       # The reason why the verification was blocked. Only present when status is
-      # "blocked".
+      # "blocked" or "shadow_blocked".
       #
       # - `expired_signature` - The signature of the SDK signals is expired. They should
       #   be sent within the hour following their collection.
@@ -115,8 +118,8 @@ module PreludeSDK
       attr_writer :request_id
 
       # The risk factors that contributed to the verification being blocked. Only
-      # present when status is "blocked" and the anti-fraud system detected specific
-      # risk signals.
+      # present when status is "blocked" or "shadow_blocked" and the anti-fraud system
+      # detected specific risk signals.
       #
       # - `behavioral_pattern` - The phone number past behavior during verification
       #   flows exhibits suspicious patterns.
@@ -210,13 +213,16 @@ module PreludeSDK
         #   non-voice channels only. This mode must be enabled for your customer account
         #   by Prelude support.
         # - `blocked` - The verification was blocked.
+        # - `shadow_blocked` - The verification triggered a block rule but the decision
+        #   was not enforced; this is used to dry-run anti-fraud configuration. This mode
+        #   must be enabled for your customer account by Prelude support.
         status:,
         # The ordered sequence of channels to be used for verification
         channels: nil,
         # The metadata for this verification.
         metadata: nil,
         # The reason why the verification was blocked. Only present when status is
-        # "blocked".
+        # "blocked" or "shadow_blocked".
         #
         # - `expired_signature` - The signature of the SDK signals is expired. They should
         #   be sent within the hour following their collection.
@@ -233,8 +239,8 @@ module PreludeSDK
         reason: nil,
         request_id: nil,
         # The risk factors that contributed to the verification being blocked. Only
-        # present when status is "blocked" and the anti-fraud system detected specific
-        # risk signals.
+        # present when status is "blocked" or "shadow_blocked" and the anti-fraud system
+        # detected specific risk signals.
         #
         # - `behavioral_pattern` - The phone number past behavior during verification
         #   flows exhibits suspicious patterns.
@@ -342,6 +348,9 @@ module PreludeSDK
       #   non-voice channels only. This mode must be enabled for your customer account
       #   by Prelude support.
       # - `blocked` - The verification was blocked.
+      # - `shadow_blocked` - The verification triggered a block rule but the decision
+      #   was not enforced; this is used to dry-run anti-fraud configuration. This mode
+      #   must be enabled for your customer account by Prelude support.
       module Status
         extend PreludeSDK::Internal::Type::Enum
 
@@ -374,6 +383,11 @@ module PreludeSDK
             :blocked,
             PreludeSDK::Models::VerificationCreateResponse::Status::TaggedSymbol
           )
+        SHADOW_BLOCKED =
+          T.let(
+            :shadow_blocked,
+            PreludeSDK::Models::VerificationCreateResponse::Status::TaggedSymbol
+          )
 
         sig do
           override.returns(
@@ -482,7 +496,7 @@ module PreludeSDK
       end
 
       # The reason why the verification was blocked. Only present when status is
-      # "blocked".
+      # "blocked" or "shadow_blocked".
       #
       # - `expired_signature` - The signature of the SDK signals is expired. They should
       #   be sent within the hour following their collection.

data/rbi/prelude_sdk/models/watch_predict_params.rbi

@@ -11,7 +11,7 @@ module PreludeSDK
           T.any(PreludeSDK::WatchPredictParams, PreludeSDK::Internal::AnyHash)
         end
 
-      # The prediction target. Only supports phone numbers for now.
+      # The signup identifier to score — a phone number or email address.
       sig { returns(PreludeSDK::WatchPredictParams::Target) }
       attr_reader :target
 
@@ -56,7 +56,7 @@ module PreludeSDK
         ).returns(T.attached_class)
       end
       def self.new(
-        # The prediction target. Only supports phone numbers for now.
+        # The signup identifier to score — a phone number or email address.
         target:,
         # The identifier of the dispatch that came from the front-end SDK.
         dispatch_id: nil,
@@ -100,7 +100,7 @@ module PreludeSDK
         sig { returns(String) }
         attr_accessor :value
 
-        # The prediction target. Only supports phone numbers for now.
+        # The signup identifier to score — a phone number or email address.
         sig do
           params(
             type: PreludeSDK::WatchPredictParams::Target::Type::OrSymbol,

data/rbi/prelude_sdk/models/watch_send_events_params.rbi

@@ -53,7 +53,15 @@ module PreludeSDK
             )
           end
 
-        # A confidence level you want to assign to the event.
+        # How much this event tells us to trust the end-user's legitimacy — not how
+        # certain you are that the event occurred. In increasing order of trust:
+        # `minimum`, `low`, `neutral`, `high`, `maximum`.
+        #
+        # Use `minimum` for an event tied to a user you trust the least to be legitimate
+        # (e.g. a `payment.chargeback`), and `maximum` for an event tied to a highly
+        # trustworthy user (e.g. a confirmed 3DS payment). Prelude weights these signals
+        # when scoring traffic: it filters out users tied to low-confidence events while
+        # preserving the experience for users tied to high-confidence ones.
         sig do
           returns(
             PreludeSDK::WatchSendEventsParams::Event::Confidence::OrSymbol
@@ -85,7 +93,15 @@ module PreludeSDK
           ).returns(T.attached_class)
         end
         def self.new(
-          # A confidence level you want to assign to the event.
+          # How much this event tells us to trust the end-user's legitimacy — not how
+          # certain you are that the event occurred. In increasing order of trust:
+          # `minimum`, `low`, `neutral`, `high`, `maximum`.
+          #
+          # Use `minimum` for an event tied to a user you trust the least to be legitimate
+          # (e.g. a `payment.chargeback`), and `maximum` for an event tied to a highly
+          # trustworthy user (e.g. a confirmed 3DS payment). Prelude weights these signals
+          # when scoring traffic: it filters out users tied to low-confidence events while
+          # preserving the experience for users tied to high-confidence ones.
           confidence:,
           # A label to describe what the event refers to.
           label:,
@@ -107,7 +123,15 @@ module PreludeSDK
         def to_hash
         end
 
-        # A confidence level you want to assign to the event.
+        # How much this event tells us to trust the end-user's legitimacy — not how
+        # certain you are that the event occurred. In increasing order of trust:
+        # `minimum`, `low`, `neutral`, `high`, `maximum`.
+        #
+        # Use `minimum` for an event tied to a user you trust the least to be legitimate
+        # (e.g. a `payment.chargeback`), and `maximum` for an event tied to a highly
+        # trustworthy user (e.g. a confirmed 3DS payment). Prelude weights these signals
+        # when scoring traffic: it filters out users tied to low-confidence events while
+        # preserving the experience for users tied to high-confidence ones.
         module Confidence
           extend PreludeSDK::Internal::Type::Enum
 

data/rbi/prelude_sdk/resources/notify.rbi

@@ -121,16 +121,15 @@ module PreludeSDK
           template_id: String,
           to: String,
           callback_url: String,
-          context: PreludeSDK::NotifySendParams::Context::OrHash,
           correlation_id: String,
           document: PreludeSDK::NotifySendParams::Document::OrHash,
           expires_at: Time,
           from: String,
           locale: String,
+          max_auto_retries: Integer,
           preferred_channel:
             PreludeSDK::NotifySendParams::PreferredChannel::OrSymbol,
           schedule_at: Time,
-          text: String,
           variables: T::Hash[Symbol, String],
           request_options: PreludeSDK::RequestOptions::OrHash
         ).returns(PreludeSDK::Models::NotifySendResponse)
@@ -142,9 +141,6 @@ module PreludeSDK
         to:,
         # The URL where webhooks will be sent for message delivery events.
         callback_url: nil,
-        # Context for replying to an inbound message. When provided, the message is sent
-        # as a WhatsApp reply within the 24-hour conversation window.
-        context: nil,
         # A user-defined identifier to correlate this message with your internal systems.
         # It is returned in the response and any webhook events that refer to this
         # message.
@@ -170,6 +166,12 @@ module PreludeSDK
         # code of the phone number. If the language specified doesn't exist, the default
         # set on the template will be used.
         locale: nil,
+        # Maximum number of automatic retry attempts across channels for this send, in
+        # addition to the first attempt. For example, `2` allows up to 3 total delivery
+        # attempts. Lower values reduce delivery cost on hard-to-reach numbers at the
+        # expense of deliverability. When omitted, your account's configured default
+        # applies.
+        max_auto_retries: nil,
         # The preferred channel to be used in priority for message delivery. If the
         # channel is unavailable, the system will fallback to other available channels.
         preferred_channel: nil,
@@ -177,10 +179,6 @@ module PreludeSDK
         # can be scheduled up to 90 days in advance and will be automatically adjusted for
         # compliance with local time window restrictions.
         schedule_at: nil,
-        # The reply message body. Required when `context.reply_to` is provided. Used for
-        # 2-way WhatsApp messaging to send free-form text replies within a conversation
-        # window.
-        text: nil,
         # The variables to be replaced in the template.
         variables: nil,
         request_options: {}
@@ -198,6 +196,7 @@ module PreludeSDK
           expires_at: Time,
           from: String,
           locale: String,
+          max_auto_retries: Integer,
           preferred_channel:
             PreludeSDK::NotifySendBatchParams::PreferredChannel::OrSymbol,
           schedule_at: Time,
@@ -232,6 +231,12 @@ module PreludeSDK
         from: nil,
         # A BCP-47 formatted locale string.
         locale: nil,
+        # Maximum number of automatic retry attempts across channels for each send in the
+        # batch, in addition to the first attempt. For example, `2` allows up to 3 total
+        # delivery attempts per recipient. Lower values reduce delivery cost on
+        # hard-to-reach numbers at the expense of deliverability. When omitted, your
+        # account's configured default applies.
+        max_auto_retries: nil,
         # Preferred channel for delivery. If unavailable, automatic fallback applies.
         preferred_channel: nil,
         # Schedule delivery in RFC3339 format. Marketing sends may be adjusted to comply

data/rbi/prelude_sdk/resources/transactional.rbi

@@ -16,6 +16,7 @@ module PreludeSDK
           expires_at: String,
           from: String,
           locale: String,
+          max_auto_retries: Integer,
           preferred_channel:
             PreludeSDK::TransactionalSendParams::PreferredChannel::OrSymbol,
           variables: T::Hash[Symbol, String],
@@ -53,6 +54,10 @@ module PreludeSDK
         # code of the phone number. If the language specified doesn't exist, the default
         # set on the template will be used.
         locale: nil,
+        # Maximum number of automatic retry attempts across channels for this send, in
+        # addition to the first attempt. For example, `2` allows up to 3 total delivery
+        # attempts. When omitted, your account's configured default applies.
+        max_auto_retries: nil,
         # The preferred delivery channel for the message. When specified, the system will
         # prioritize sending via the requested channel if the template is configured for
         # it.

data/rbi/prelude_sdk/resources/verification.rbi

@@ -40,6 +40,7 @@ module PreludeSDK
         params(
           code: String,
           target: PreludeSDK::VerificationCheckParams::Target::OrHash,
+          psd2: PreludeSDK::VerificationCheckParams::Psd2::OrHash,
           request_options: PreludeSDK::RequestOptions::OrHash
         ).returns(PreludeSDK::Models::VerificationCheckResponse)
       end
@@ -49,6 +50,11 @@ module PreludeSDK
         # The verification target. Either a phone number or an email address. To use the
         # email verification feature contact us to discuss your use case.
         target:,
+        # Required when checking a code issued under the `prelude:psd2` template. The
+        # submitted variables must match those provided at issuance; any mismatch
+        # invalidates the code (PSD2 SCA RTS Article 5 dynamic linking). Ignored on
+        # non-PSD2 verifications.
+        psd2: nil,
         request_options: {}
       )
       end

data/rbi/prelude_sdk/resources/watch.rbi

@@ -4,7 +4,12 @@ module PreludeSDK
   module Resources
     # Evaluate email addresses and phone numbers for trustworthiness.
     class Watch
-      # Predict the outcome of a verification based on Prelude’s anti-fraud system.
+      # At signup, score the user's phone number or email address (target) as legitimate
+      # or suspicious. Scoring-only — does not update counters by itself. When using
+      # Feedback, call predict before verification.started on the same target (and
+      # correlation_id when used) so feedback can warm Watch auth-start counters. Use
+      # Events for product fraud labels; use Feedback only if you run your own phone
+      # verification funnel outside Prelude Verify.
       sig do
         params(
           target: PreludeSDK::WatchPredictParams::Target::OrHash,
@@ -15,7 +20,7 @@ module PreludeSDK
         ).returns(PreludeSDK::Models::WatchPredictResponse)
       end
       def predict(
-        # The prediction target. Only supports phone numbers for now.
+        # The signup identifier to score — a phone number or email address.
         target:,
         # The identifier of the dispatch that came from the front-end SDK.
         dispatch_id: nil,
@@ -28,8 +33,11 @@ module PreludeSDK
       )
       end
 
-      # Send real-time event data from end-user interactions within your application.
-      # Events will be analyzed for proactive fraud prevention and risk scoring.
+      # Send custom fraud signals from your application (labels and confidence levels).
+      # Events capture product-specific risk patterns and are weighted when scoring
+      # traffic. Use without Predict or Feedback if you only need to report product-side
+      # abuse (for example account.banned). Feedback is a separate, optional endpoint
+      # for self-hosted phone verification funnels.
       sig do
         params(
           events: T::Array[PreludeSDK::WatchSendEventsParams::Event::OrHash],
@@ -44,8 +52,13 @@ module PreludeSDK
       )
       end
 
-      # Send feedback regarding your end-users verification funnel. Events will be
-      # analyzed for proactive fraud prevention and risk scoring.
+      # Optional. Report verification-funnel steps (verification.started,
+      # verification.completed) when you run phone verification outside Prelude Verify.
+      # Feeds Watch abuse-rate counters for your own flow. Call Predict on the same
+      # target before verification.started and reuse metadata.correlation_id so
+      # auth-start counters receive predict signals; without a linked predict, only
+      # attempt-rate counters update on started. Not required if you only use Events
+      # and/or Predict, or if Verify already handles verification for that traffic.
       sig do
         params(
           feedbacks:

data/sig/prelude_sdk/models/notify_send_batch_params.rbs

@@ -10,6 +10,7 @@ module PreludeSDK
         expires_at: Time,
         from: String,
         locale: String,
+        max_auto_retries: Integer,
         preferred_channel: PreludeSDK::Models::NotifySendBatchParams::preferred_channel,
         schedule_at: Time,
         variables: ::Hash[Symbol, String]
@@ -50,6 +51,10 @@ module PreludeSDK
 
       def locale=: (String) -> String
 
+      attr_reader max_auto_retries: Integer?
+
+      def max_auto_retries=: (Integer) -> Integer
+
       attr_reader preferred_channel: PreludeSDK::Models::NotifySendBatchParams::preferred_channel?
 
       def preferred_channel=: (
@@ -73,6 +78,7 @@ module PreludeSDK
         ?expires_at: Time,
         ?from: String,
         ?locale: String,
+        ?max_auto_retries: Integer,
         ?preferred_channel: PreludeSDK::Models::NotifySendBatchParams::preferred_channel,
         ?schedule_at: Time,
         ?variables: ::Hash[Symbol, String],
@@ -88,6 +94,7 @@ module PreludeSDK
         expires_at: Time,
         from: String,
         locale: String,
+        max_auto_retries: Integer,
         preferred_channel: PreludeSDK::Models::NotifySendBatchParams::preferred_channel,
         schedule_at: Time,
         variables: ::Hash[Symbol, String],