prelude-sdk 0.8.0 → 0.9.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 8731fe84115bb4e974b30b47e338de7edb1f104b7cf647c48fa5d02e0b18ae8d
-  data.tar.gz: ef60164897791a51d47662deac42eafc71b8a1036b0bd8cb9440564f01149c39
+  metadata.gz: 352849d968441a94ad1e67d3dbbcca51b693b630ffad11504def50f3ec52a2ea
+  data.tar.gz: 2e3a7617adbcb0fc5e7f8ae43e81d1f59e909153968f884e501c1bc50af28f17
 SHA512:
-  metadata.gz: 6a1bd302938e69cddf9fc148cf5f8cee8b1562afa6ce41e0290764c0b9cce9565fe5d7303648f13911a8ae32a7166cd67dd0bff7b55e901f91fc9d7e62266fbe
-  data.tar.gz: 02e63639aa44241d657fb07bdcd1877bb2de1c8290459dd07afd1c4320fd5e7a357b8836b4c04b375ba25b6874091bac694837075eb2d600590785221fb307f8
+  metadata.gz: 24926ad8c0b8f63d0e0237192f80fe82632c553eec22cbb570fd7a4a6e97d17a80ef25b9f4c6da84c227167ed4c0f46bdde8f72508874d054f2704cf47876e0b
+  data.tar.gz: dbd672b9d8bdacd81ee544bdec6d07657a3be690b909557c9808c42ad1895e0e05dd3c76c29ed8c98e3675aef8e98f77982c8880198b55d3812192eea1f0db83

data/CHANGELOG.md

@@ -1,5 +1,13 @@
 # Changelog
 
+## 0.9.0 (2026-09-22)
+
+Full Changelog: [v0.8.0...v0.9.0](https://github.com/prelude-so/ruby-sdk/compare/v0.8.0...v0.9.0)
+
+### Features
+
+* **api:** api update ([f86194b](https://github.com/prelude-so/ruby-sdk/commit/f86194b0bea9b4034842e7d6e08089a9c90da2e9))
+
 ## 0.8.0 (2026-09-18)
 
 Full Changelog: [v0.7.0...v0.8.0](https://github.com/prelude-so/ruby-sdk/compare/v0.7.0...v0.8.0)

data/README.md

@@ -17,7 +17,7 @@ To use this gem, install via Bundler by adding the following to your application
 <!-- x-release-please-start-version -->
 
 ```ruby
-gem "prelude-sdk", "~> 0.8.0"
+gem "prelude-sdk", "~> 0.9.0"
 ```
 
 <!-- x-release-please-end -->

data/lib/prelude_sdk/models/verification/phone/history_list_response.rb

@@ -75,8 +75,8 @@ module PreludeSDK
             #   - `invalid_line` - The phone number is not a valid line type.
             #   - `invalid_number` - The phone number is not a valid number.
             #   - `rate_limited` - The verification was refused by a rate limit.
-            #   - `expired_signals` - The SDK signals were collected too long before the
-            #     request.
+            #   - `expired_signals` - The SDK signals were collected too long before the request
+            #     to still attest to it.
             #   - `shadowed` - The anti-fraud system flagged the verification without blocking
             #     it.
             #
@@ -209,8 +209,8 @@ module PreludeSDK
             # - `invalid_line` - The phone number is not a valid line type.
             # - `invalid_number` - The phone number is not a valid number.
             # - `rate_limited` - The verification was refused by a rate limit.
-            # - `expired_signals` - The SDK signals were collected too long before the
-            #   request.
+            # - `expired_signals` - The SDK signals were collected too long before the request
+            #   to still attest to it.
             # - `shadowed` - The anti-fraud system flagged the verification without blocking
             #   it.
             #

data/lib/prelude_sdk/models/verification/phone/history_retrieve_response.rb

@@ -43,8 +43,8 @@ module PreludeSDK
           #   - `invalid_line` - The phone number is not a valid line type.
           #   - `invalid_number` - The phone number is not a valid number.
           #   - `rate_limited` - The verification was refused by a rate limit.
-          #   - `expired_signals` - The SDK signals were collected too long before the
-          #     request.
+          #   - `expired_signals` - The SDK signals were collected too long before the request
+          #     to still attest to it.
           #   - `shadowed` - The anti-fraud system flagged the verification without blocking
           #     it.
           #
@@ -58,31 +58,44 @@ module PreludeSDK
           optional :app_version, String
 
           # @!attribute block_reasons
-          #   Why the anti-fraud system blocked the verification. Empty unless it did.
-          #
-          #   - `behavioral_pattern` - The phone number past behavior during verification
-          #     flows exhibits suspicious patterns.
-          #   - `device_attribute` - The end-user device reported attributes associated with
-          #     fraud or emulation.
-          #   - `fraud_database` - The phone number appears in a fraud database.
-          #   - `location_discrepancy` - The phone number region and the observed location
-          #     disagree.
+          #   Why the anti-fraud system blocked the verification. Empty unless it did. These
+          #   are the same labels the Verify and Watch APIs serve as `risk_factors`.
+          #
+          #   - `automation_signature` - The request appears to come from an automated client
+          #     rather than a person.
+          #   - `carrier_not_permitted` - The destination carrier is one this account does not
+          #     accept traffic for.
+          #   - `client_fingerprint_mismatch` - The client does not appear to be the platform
+          #     it identifies itself as.
+          #   - `custom_policy` - A rule configured for your account matched this request.
+          #   - `device_emulator` - The request appears to come from an emulator rather than a
+          #     physical device.
+          #   - `device_not_permitted` - The device platform is one your account blocks.
+          #   - `device_reuse` - One device is driving verifications for an unusual number of
+          #     phone numbers.
+          #   - `expired_signals` - The SDK signals were collected too long before the request
+          #     to still attest to it.
+          #   - `fraud_database` - The phone number is flagged in one or more of the fraud
+          #     databases Prelude consults.
+          #   - `invalid_signature` - The SDK signature did not verify, so the request cannot
+          #     be attributed to the device it claims to come from.
+          #   - `ip_concentration` - The request shares its origin with an unusual volume of
+          #     other verifications.
+          #   - `ip_reputation` - The originating IP address is not trusted.
+          #   - `location_mismatch` - The network location and the phone number's country are
+          #     inconsistent.
           #   - `missing_signals` - The verification expected Prelude SDK signals and none
           #     arrived.
-          #   - `network_fingerprint` - The network fingerprint matches known fraudulent
-          #     traffic.
-          #   - `poor_conversion_history` - The phone number rarely completes the
-          #     verifications it starts.
-          #   - `prefix_concentration` - The phone number is part of a range known to be
-          #     associated with suspicious activity patterns.
-          #   - `repeated_number` - The phone number was used far more often than normal
-          #     traffic would explain.
-          #   - `suspected_request_tampering` - The SDK signals were altered or expired
-          #     between collection and use.
-          #   - `suspicious_ip_address` - The originating IP address is associated with
-          #     suspicious activity.
-          #   - `temporary_phone_number` - The phone number is known to be a temporary or
-          #     disposable number.
+          #   - `number_range_abuse` - The phone number belongs to a range currently
+          #     associated with abuse.
+          #   - `poor_conversion_history` - Traffic resembling this request rarely completes a
+          #     verification.
+          #   - `proxy_network` - The request did not arrive over the subscriber's own access
+          #     network.
+          #   - `repeated_attempts` - The phone number exceeded the allowed number of
+          #     verification attempts in a short period.
+          #   - `temporary_phone_number` - The phone number belongs to a disposable or
+          #     short-lived numbering service.
           #
           #   @return [Array<Symbol, PreludeSDK::Models::Verification::Phone::HistoryRetrieveResponse::BlockReason>, nil]
           optional :block_reasons,
@@ -198,7 +211,7 @@ module PreludeSDK
           #
           #   @param app_version [String] Version of your application, when known.
           #
-          #   @param block_reasons [Array<Symbol, PreludeSDK::Models::Verification::Phone::HistoryRetrieveResponse::BlockReason>] Why the anti-fraud system blocked the verification. Empty unless it did.
+          #   @param block_reasons [Array<Symbol, PreludeSDK::Models::Verification::Phone::HistoryRetrieveResponse::BlockReason>] Why the anti-fraud system blocked the verification. Empty unless it did. These a
           #
           #   @param carrier [PreludeSDK::Models::Verification::Phone::PhoneVerificationCarrier] The end user's mobile network.
           #
@@ -242,8 +255,8 @@ module PreludeSDK
           # - `invalid_line` - The phone number is not a valid line type.
           # - `invalid_number` - The phone number is not a valid number.
           # - `rate_limited` - The verification was refused by a rate limit.
-          # - `expired_signals` - The SDK signals were collected too long before the
-          #   request.
+          # - `expired_signals` - The SDK signals were collected too long before the request
+          #   to still attest to it.
           # - `shadowed` - The anti-fraud system flagged the verification without blocking
           #   it.
           #
@@ -271,17 +284,24 @@ module PreludeSDK
           module BlockReason
             extend PreludeSDK::Internal::Type::Enum
 
-            BEHAVIORAL_PATTERN = :behavioral_pattern
-            DEVICE_ATTRIBUTE = :device_attribute
+            AUTOMATION_SIGNATURE = :automation_signature
+            CARRIER_NOT_PERMITTED = :carrier_not_permitted
+            CLIENT_FINGERPRINT_MISMATCH = :client_fingerprint_mismatch
+            CUSTOM_POLICY = :custom_policy
+            DEVICE_EMULATOR = :device_emulator
+            DEVICE_NOT_PERMITTED = :device_not_permitted
+            DEVICE_REUSE = :device_reuse
+            EXPIRED_SIGNALS = :expired_signals
             FRAUD_DATABASE = :fraud_database
-            LOCATION_DISCREPANCY = :location_discrepancy
+            INVALID_SIGNATURE = :invalid_signature
+            IP_CONCENTRATION = :ip_concentration
+            IP_REPUTATION = :ip_reputation
+            LOCATION_MISMATCH = :location_mismatch
             MISSING_SIGNALS = :missing_signals
-            NETWORK_FINGERPRINT = :network_fingerprint
+            NUMBER_RANGE_ABUSE = :number_range_abuse
             POOR_CONVERSION_HISTORY = :poor_conversion_history
-            PREFIX_CONCENTRATION = :prefix_concentration
-            REPEATED_NUMBER = :repeated_number
-            SUSPECTED_REQUEST_TAMPERING = :suspected_request_tampering
-            SUSPICIOUS_IP_ADDRESS = :suspicious_ip_address
+            PROXY_NETWORK = :proxy_network
+            REPEATED_ATTEMPTS = :repeated_attempts
             TEMPORARY_PHONE_NUMBER = :temporary_phone_number
 
             # @!method self.values

data/lib/prelude_sdk/models/verification_create_response.rb

@@ -58,9 +58,10 @@ module PreludeSDK
       #     landline).
       #   - `invalid_phone_number` - The phone number is not a valid phone number (e.g.
       #     unallocated range).
-      #   - `invalid_signature` - The signature of the SDK signals is invalid.
-      #   - `repeated_attempts` - The phone number has made too many verification
-      #     attempts.
+      #   - `invalid_signature` - The SDK signature did not verify, so the request cannot
+      #     be attributed to the device it claims to come from.
+      #   - `repeated_attempts` - The phone number exceeded the allowed number of
+      #     verification attempts in a short period.
       #   - `suspicious` - The verification attempt was deemed suspicious by the
       #     anti-fraud system.
       #
@@ -77,26 +78,41 @@ module PreludeSDK
       #   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.
-      #   - `device_attribute` - The device exhibits characteristics associated with
-      #     suspicious activity patterns.
-      #   - `fraud_database` - The phone number has been flagged as suspicious in one or
-      #     more of our fraud databases.
-      #   - `location_discrepancy` - The phone number prefix and IP address discrepancy
-      #     indicates potential fraud.
-      #   - `network_fingerprint` - The network connection exhibits characteristics
-      #     associated with suspicious activity patterns.
-      #   - `poor_conversion_history` - The phone number has a history of poorly
-      #     converting to a verified phone number.
-      #   - `prefix_concentration` - The phone number is part of a range known to be
-      #     associated with suspicious activity patterns.
-      #   - `suspected_request_tampering` - The SDK signature is invalid and the request
-      #     is considered to be tampered with.
-      #   - `suspicious_ip_address` - The IP address is deemed to be associated with
-      #     suspicious activity patterns.
-      #   - `temporary_phone_number` - The phone number is known to be a temporary or
-      #     disposable number.
+      #   - `automation_signature` - The request appears to come from an automated client
+      #     rather than a person.
+      #   - `carrier_not_permitted` - The destination carrier is one this account does not
+      #     accept traffic for.
+      #   - `client_fingerprint_mismatch` - The client does not appear to be the platform
+      #     it identifies itself as.
+      #   - `custom_policy` - A rule configured for your account matched this request.
+      #   - `device_emulator` - The request appears to come from an emulator rather than a
+      #     physical device.
+      #   - `device_not_permitted` - The device platform is one your account blocks.
+      #   - `device_reuse` - One device is driving verifications for an unusual number of
+      #     phone numbers.
+      #   - `expired_signals` - The SDK signals were collected too long before the request
+      #     to still attest to it.
+      #   - `fraud_database` - The phone number is flagged in one or more of the fraud
+      #     databases Prelude consults.
+      #   - `invalid_signature` - The SDK signature did not verify, so the request cannot
+      #     be attributed to the device it claims to come from.
+      #   - `ip_concentration` - The request shares its origin with an unusual volume of
+      #     other verifications.
+      #   - `ip_reputation` - The originating IP address is not trusted.
+      #   - `location_mismatch` - The network location and the phone number's country are
+      #     inconsistent.
+      #   - `missing_signals` - The verification expected Prelude SDK signals and none
+      #     arrived.
+      #   - `number_range_abuse` - The phone number belongs to a range currently
+      #     associated with abuse.
+      #   - `poor_conversion_history` - Traffic resembling this request rarely completes a
+      #     verification.
+      #   - `proxy_network` - The request did not arrive over the subscriber's own access
+      #     network.
+      #   - `repeated_attempts` - The phone number exceeded the allowed number of
+      #     verification attempts in a short period.
+      #   - `temporary_phone_number` - The phone number belongs to a disposable or
+      #     short-lived numbering service.
       #
       #   @return [Array<Symbol, PreludeSDK::Models::VerificationCreateResponse::RiskFactor>, nil]
       optional :risk_factors,
@@ -215,9 +231,10 @@ module PreludeSDK
       #   landline).
       # - `invalid_phone_number` - The phone number is not a valid phone number (e.g.
       #   unallocated range).
-      # - `invalid_signature` - The signature of the SDK signals is invalid.
-      # - `repeated_attempts` - The phone number has made too many verification
-      #   attempts.
+      # - `invalid_signature` - The SDK signature did not verify, so the request cannot
+      #   be attributed to the device it claims to come from.
+      # - `repeated_attempts` - The phone number exceeded the allowed number of
+      #   verification attempts in a short period.
       # - `suspicious` - The verification attempt was deemed suspicious by the
       #   anti-fraud system.
       #
@@ -240,15 +257,24 @@ module PreludeSDK
       module RiskFactor
         extend PreludeSDK::Internal::Type::Enum
 
-        BEHAVIORAL_PATTERN = :behavioral_pattern
-        DEVICE_ATTRIBUTE = :device_attribute
+        AUTOMATION_SIGNATURE = :automation_signature
+        CARRIER_NOT_PERMITTED = :carrier_not_permitted
+        CLIENT_FINGERPRINT_MISMATCH = :client_fingerprint_mismatch
+        CUSTOM_POLICY = :custom_policy
+        DEVICE_EMULATOR = :device_emulator
+        DEVICE_NOT_PERMITTED = :device_not_permitted
+        DEVICE_REUSE = :device_reuse
+        EXPIRED_SIGNALS = :expired_signals
         FRAUD_DATABASE = :fraud_database
-        LOCATION_DISCREPANCY = :location_discrepancy
-        NETWORK_FINGERPRINT = :network_fingerprint
+        INVALID_SIGNATURE = :invalid_signature
+        IP_CONCENTRATION = :ip_concentration
+        IP_REPUTATION = :ip_reputation
+        LOCATION_MISMATCH = :location_mismatch
+        MISSING_SIGNALS = :missing_signals
+        NUMBER_RANGE_ABUSE = :number_range_abuse
         POOR_CONVERSION_HISTORY = :poor_conversion_history
-        PREFIX_CONCENTRATION = :prefix_concentration
-        SUSPECTED_REQUEST_TAMPERING = :suspected_request_tampering
-        SUSPICIOUS_IP_ADDRESS = :suspicious_ip_address
+        PROXY_NETWORK = :proxy_network
+        REPEATED_ATTEMPTS = :repeated_attempts
         TEMPORARY_PHONE_NUMBER = :temporary_phone_number
 
         # @!method self.values

data/lib/prelude_sdk/models/watch_evaluate_response.rb

@@ -88,7 +88,9 @@ module PreludeSDK
         # @!attribute rules
         #   One result per rule in the recipe, in membership order. Every rule runs — a
         #   score is only meaningful when complete, so there is no short-circuit on the
-        #   first trigger.
+        #   first trigger. The exception is a recipe whose verdict a preempting rule has
+        #   already determined, where a rule that could no longer change it may report
+        #   `SKIPPED` instead.
         #
         #   @return [Array<PreludeSDK::Models::WatchEvaluateResponse::Recipe::Rule>]
         required :rules,
@@ -149,6 +151,10 @@ module PreludeSDK
           #   - `NOT_EVALUATED` - The rule could not run, because something it reads never
           #     arrived. This is not a quieter `NOT_TRIGGERED`: it contributed nothing either
           #     way, and it is why `partial_evidence` is set on the recipe.
+          #   - `SKIPPED` - The rule was not run, because another rule had already determined
+          #     the recipe's verdict — see `determined_by`. Nothing was missing and nothing
+          #     failed, so `partial_evidence` is not set: `determined_by` is what accounts for
+          #     the recipe's score resting on fewer rules.
           #
           #   @return [Symbol, PreludeSDK::Models::WatchEvaluateResponse::Recipe::Rule::Outcome]
           required :outcome, enum: -> { PreludeSDK::Models::WatchEvaluateResponse::Recipe::Rule::Outcome }
@@ -161,6 +167,17 @@ module PreludeSDK
           #   @return [String]
           required :rule_id, String
 
+          # @!attribute type
+          #   Who authored the rule, which is what says how much of the rest of this result
+          #   you get.
+          #
+          #   - `MANAGED` - Prelude-owned, shared with customers: `name` and `version_id` are
+          #     omitted, and `blocked_by` reports only `missing_data`.
+          #   - `CUSTOM` - Yours: every field is returned.
+          #
+          #   @return [Symbol, PreludeSDK::Models::WatchEvaluateResponse::Recipe::Rule::Type]
+          required :type, enum: -> { PreludeSDK::Models::WatchEvaluateResponse::Recipe::Rule::Type }
+
           # @!attribute weight
           #   What this rule contributes to the recipe's score when it triggers.
           #
@@ -193,7 +210,15 @@ module PreludeSDK
           #   @return [Boolean, nil]
           optional :unavailable, PreludeSDK::Internal::Type::Boolean
 
-          # @!method initialize(outcome:, rule_id:, weight:, blocked_by: nil, name: nil, unavailable: nil)
+          # @!attribute version_id
+          #   The version of the rule that scored — the one this recipe is pinned to, or the
+          #   version current at evaluation time when it is not pinned. Present for a rule you
+          #   authored, and omitted for a Prelude-managed one.
+          #
+          #   @return [String, nil]
+          optional :version_id, String
+
+          # @!method initialize(outcome:, rule_id:, type:, weight:, blocked_by: nil, name: nil, unavailable: nil, version_id: nil)
           #   Some parameter documentations has been truncated, see
           #   {PreludeSDK::Models::WatchEvaluateResponse::Recipe::Rule} for more details.
           #
@@ -201,6 +226,8 @@ module PreludeSDK
           #
           #   @param rule_id [String] The rule that produced this result. Present whatever the rule's visibility, so a
           #
+          #   @param type [Symbol, PreludeSDK::Models::WatchEvaluateResponse::Recipe::Rule::Type] Who authored the rule, which is what says how much of the rest of this result yo
+          #
           #   @param weight [Integer] What this rule contributes to the recipe's score when it triggers.
           #
           #   @param blocked_by [String] Why the rule could not run, set only when `outcome` is `NOT_EVALUATED`.
@@ -208,6 +235,8 @@ module PreludeSDK
           #   @param name [String] The rule's name, present for a rule you authored and omitted for a Prelude-manag
           #
           #   @param unavailable [Boolean] The rule could not run for a reason on our side rather than anything about your
+          #
+          #   @param version_id [String] The version of the rule that scored — the one this recipe is pinned to, or the v
 
           # What the rule concluded.
           #
@@ -216,6 +245,10 @@ module PreludeSDK
           # - `NOT_EVALUATED` - The rule could not run, because something it reads never
           #   arrived. This is not a quieter `NOT_TRIGGERED`: it contributed nothing either
           #   way, and it is why `partial_evidence` is set on the recipe.
+          # - `SKIPPED` - The rule was not run, because another rule had already determined
+          #   the recipe's verdict — see `determined_by`. Nothing was missing and nothing
+          #   failed, so `partial_evidence` is not set: `determined_by` is what accounts for
+          #   the recipe's score resting on fewer rules.
           #
           # @see PreludeSDK::Models::WatchEvaluateResponse::Recipe::Rule#outcome
           module Outcome
@@ -224,6 +257,25 @@ module PreludeSDK
             TRIGGERED = :TRIGGERED
             NOT_TRIGGERED = :NOT_TRIGGERED
             NOT_EVALUATED = :NOT_EVALUATED
+            SKIPPED = :SKIPPED
+
+            # @!method self.values
+            #   @return [Array<Symbol>]
+          end
+
+          # Who authored the rule, which is what says how much of the rest of this result
+          # you get.
+          #
+          # - `MANAGED` - Prelude-owned, shared with customers: `name` and `version_id` are
+          #   omitted, and `blocked_by` reports only `missing_data`.
+          # - `CUSTOM` - Yours: every field is returned.
+          #
+          # @see PreludeSDK::Models::WatchEvaluateResponse::Recipe::Rule#type
+          module Type
+            extend PreludeSDK::Internal::Type::Enum
+
+            MANAGED = :MANAGED
+            CUSTOM = :CUSTOM
 
             # @!method self.values
             #   @return [Array<Symbol>]

data/lib/prelude_sdk/models/watch_predict_response.rb

@@ -28,29 +28,43 @@ module PreludeSDK
       #   when prediction is "suspicious" and the anti-fraud system detected specific risk
       #   signals.
       #
-      #   - `account_risk_profile` - The target matches a risk profile derived from the
-      #     outcomes reported on your own account, rather than from a signal shared across
-      #     accounts.
-      #   - `behavioral_pattern` - The phone number past behavior during verification
-      #     flows exhibits suspicious patterns.
-      #   - `device_attribute` - The device exhibits characteristics associated with
-      #     suspicious activity patterns.
-      #   - `fraud_database` - The phone number has been flagged as suspicious in one or
-      #     more of our fraud databases.
-      #   - `location_discrepancy` - The phone number prefix and IP address discrepancy
-      #     indicates potential fraud.
-      #   - `network_fingerprint` - The network connection exhibits characteristics
-      #     associated with suspicious activity patterns.
-      #   - `poor_conversion_history` - The phone number has a history of poorly
-      #     converting to a verified phone number.
-      #   - `prefix_concentration` - The phone number is part of a range known to be
-      #     associated with suspicious activity patterns.
-      #   - `suspected_request_tampering` - The SDK signature is invalid and the request
-      #     is considered to be tampered with.
-      #   - `suspicious_ip_address` - The IP address is deemed to be associated with
-      #     suspicious activity patterns.
-      #   - `temporary_phone_number` - The phone number is known to be a temporary or
-      #     disposable number.
+      #   - `account_risk_profile` - The request matches a risk profile derived from the
+      #     outcomes reported on your own account.
+      #   - `automation_signature` - The request appears to come from an automated client
+      #     rather than a person.
+      #   - `carrier_not_permitted` - The destination carrier is one this account does not
+      #     accept traffic for.
+      #   - `client_fingerprint_mismatch` - The client does not appear to be the platform
+      #     it identifies itself as.
+      #   - `custom_policy` - A rule configured for your account matched this request.
+      #   - `device_emulator` - The request appears to come from an emulator rather than a
+      #     physical device.
+      #   - `device_not_permitted` - The device platform is one your account blocks.
+      #   - `device_reuse` - One device is driving verifications for an unusual number of
+      #     phone numbers.
+      #   - `expired_signals` - The SDK signals were collected too long before the request
+      #     to still attest to it.
+      #   - `fraud_database` - The phone number is flagged in one or more of the fraud
+      #     databases Prelude consults.
+      #   - `invalid_signature` - The SDK signature did not verify, so the request cannot
+      #     be attributed to the device it claims to come from.
+      #   - `ip_concentration` - The request shares its origin with an unusual volume of
+      #     other verifications.
+      #   - `ip_reputation` - The originating IP address is not trusted.
+      #   - `location_mismatch` - The network location and the phone number's country are
+      #     inconsistent.
+      #   - `missing_signals` - The verification expected Prelude SDK signals and none
+      #     arrived.
+      #   - `number_range_abuse` - The phone number belongs to a range currently
+      #     associated with abuse.
+      #   - `poor_conversion_history` - Traffic resembling this request rarely completes a
+      #     verification.
+      #   - `proxy_network` - The request did not arrive over the subscriber's own access
+      #     network.
+      #   - `repeated_attempts` - The phone number exceeded the allowed number of
+      #     verification attempts in a short period.
+      #   - `temporary_phone_number` - The phone number belongs to a disposable or
+      #     short-lived numbering service.
       #
       #   @return [Array<Symbol, PreludeSDK::Models::WatchPredictResponse::RiskFactor>, nil]
       optional :risk_factors,
@@ -85,15 +99,24 @@ module PreludeSDK
         extend PreludeSDK::Internal::Type::Enum
 
         ACCOUNT_RISK_PROFILE = :account_risk_profile
-        BEHAVIORAL_PATTERN = :behavioral_pattern
-        DEVICE_ATTRIBUTE = :device_attribute
+        AUTOMATION_SIGNATURE = :automation_signature
+        CARRIER_NOT_PERMITTED = :carrier_not_permitted
+        CLIENT_FINGERPRINT_MISMATCH = :client_fingerprint_mismatch
+        CUSTOM_POLICY = :custom_policy
+        DEVICE_EMULATOR = :device_emulator
+        DEVICE_NOT_PERMITTED = :device_not_permitted
+        DEVICE_REUSE = :device_reuse
+        EXPIRED_SIGNALS = :expired_signals
         FRAUD_DATABASE = :fraud_database
-        LOCATION_DISCREPANCY = :location_discrepancy
-        NETWORK_FINGERPRINT = :network_fingerprint
+        INVALID_SIGNATURE = :invalid_signature
+        IP_CONCENTRATION = :ip_concentration
+        IP_REPUTATION = :ip_reputation
+        LOCATION_MISMATCH = :location_mismatch
+        MISSING_SIGNALS = :missing_signals
+        NUMBER_RANGE_ABUSE = :number_range_abuse
         POOR_CONVERSION_HISTORY = :poor_conversion_history
-        PREFIX_CONCENTRATION = :prefix_concentration
-        SUSPECTED_REQUEST_TAMPERING = :suspected_request_tampering
-        SUSPICIOUS_IP_ADDRESS = :suspicious_ip_address
+        PROXY_NETWORK = :proxy_network
+        REPEATED_ATTEMPTS = :repeated_attempts
         TEMPORARY_PHONE_NUMBER = :temporary_phone_number
 
         # @!method self.values

data/lib/prelude_sdk/resources/watch.rb

@@ -7,9 +7,9 @@ module PreludeSDK
       # Some parameter documentations has been truncated, see
       # {PreludeSDK::Models::WatchEvaluateParams} for more details.
       #
-      # **Beta.** The request and response shapes may still change, and flows and
-      # recipes are configured by Prelude on your behalf for now. Talk to us before you
-      # build against it.
+      # **Beta.** The request and response shapes may still change. Talk to us before
+      # you build against it. Flows, recipes and rules are authored through the Watch
+      # Management API, or configured by Prelude on your behalf.
       #
       # Score a target against the rules configured for one moment in your product —
       # signup, checkout, password reset. The flow selects which recipes run; each

data/lib/prelude_sdk/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module PreludeSDK
-  VERSION = "0.8.0"
+  VERSION = "0.9.0"
 end

data/rbi/prelude_sdk/models/verification/phone/history_list_response.rbi

@@ -112,8 +112,8 @@ module PreludeSDK
             # - `invalid_line` - The phone number is not a valid line type.
             # - `invalid_number` - The phone number is not a valid number.
             # - `rate_limited` - The verification was refused by a rate limit.
-            # - `expired_signals` - The SDK signals were collected too long before the
-            #   request.
+            # - `expired_signals` - The SDK signals were collected too long before the request
+            #   to still attest to it.
             # - `shadowed` - The anti-fraud system flagged the verification without blocking
             #   it.
             sig do
@@ -264,8 +264,8 @@ module PreludeSDK
               # - `invalid_line` - The phone number is not a valid line type.
               # - `invalid_number` - The phone number is not a valid number.
               # - `rate_limited` - The verification was refused by a rate limit.
-              # - `expired_signals` - The SDK signals were collected too long before the
-              #   request.
+              # - `expired_signals` - The SDK signals were collected too long before the request
+              #   to still attest to it.
               # - `shadowed` - The anti-fraud system flagged the verification without blocking
               #   it.
               status:,
@@ -440,8 +440,8 @@ module PreludeSDK
             # - `invalid_line` - The phone number is not a valid line type.
             # - `invalid_number` - The phone number is not a valid number.
             # - `rate_limited` - The verification was refused by a rate limit.
-            # - `expired_signals` - The SDK signals were collected too long before the
-            #   request.
+            # - `expired_signals` - The SDK signals were collected too long before the request
+            #   to still attest to it.
             # - `shadowed` - The anti-fraud system flagged the verification without blocking
             #   it.
             module Status