prelude-sdk 0.1.0.pre.alpha.2 → 0.1.0

data/lib/prelude_sdk/internal/type/hash_of.rb

@@ -168,6 +168,7 @@ module PreludeSDK
         #   @option spec [Boolean] :"nil?"
         def initialize(type_info, spec = {})
           @item_type_fn = PreludeSDK::Internal::Type::Converter.type_info(type_info || spec)
+          @meta = PreludeSDK::Internal::Type::Converter.meta_info(type_info, spec)
           @nilable = spec.fetch(:nil?, false)
         end
 

data/lib/prelude_sdk/internal/type/union.rb

@@ -12,20 +12,20 @@ module PreludeSDK
         #
         # All of the specified variant info for this union.
         #
-        # @return [Array<Array(Symbol, Proc)>]
+        # @return [Array<Array(Symbol, Proc, Hash{Symbol=>Object})>]
         private def known_variants = (@known_variants ||= [])
 
         # @api private
         #
-        # @return [Array<Array(Symbol, Object)>]
+        # @return [Array<Array(Symbol, Object, Hash{Symbol=>Object})>]
         protected def derefed_variants
-          known_variants.map { |key, variant_fn| [key, variant_fn.call] }
+          known_variants.map { |key, variant_fn, meta| [key, variant_fn.call, meta] }
         end
 
         # All of the specified variants for this union.
         #
         # @return [Array<Object>]
-        def variants = derefed_variants.map(&:last)
+        def variants = derefed_variants.map { _2 }
 
         # @api private
         #
@@ -51,12 +51,13 @@ module PreludeSDK
         #
         #   @option spec [Boolean] :"nil?"
         private def variant(key, spec = nil)
+          meta = PreludeSDK::Internal::Type::Converter.meta_info(nil, spec)
           variant_info =
             case key
             in Symbol
-              [key, PreludeSDK::Internal::Type::Converter.type_info(spec)]
+              [key, PreludeSDK::Internal::Type::Converter.type_info(spec), meta]
             in Proc | PreludeSDK::Internal::Type::Converter | Class | Hash
-              [nil, PreludeSDK::Internal::Type::Converter.type_info(key)]
+              [nil, PreludeSDK::Internal::Type::Converter.type_info(key), meta]
             end
 
           known_variants << variant_info
@@ -79,7 +80,8 @@ module PreludeSDK
             return nil if key == PreludeSDK::Internal::OMIT
 
             key = key.to_sym if key.is_a?(String)
-            known_variants.find { |k,| k == key }&.last&.call
+            _, found = known_variants.find { |k,| k == key }
+            found&.call
           else
             nil
           end

data/lib/prelude_sdk/internal/util.rb

@@ -244,7 +244,7 @@ module PreludeSDK
         #
         # @return [String]
         def uri_origin(uri)
-          "#{uri.scheme}://#{uri.host}#{uri.port == uri.default_port ? '' : ":#{uri.port}"}"
+          "#{uri.scheme}://#{uri.host}#{":#{uri.port}" unless uri.port == uri.default_port}"
         end
 
         # @api private
@@ -346,8 +346,9 @@ module PreludeSDK
           base_path, base_query = lhs.fetch_values(:path, :query)
           slashed = base_path.end_with?("/") ? base_path : "#{base_path}/"
 
-          parsed_path, parsed_query = parse_uri(rhs.fetch(:path)).fetch_values(:path, :query)
-          override = URI::Generic.build(**rhs.slice(:scheme, :host, :port), path: parsed_path)
+          merged = {**parse_uri(rhs.fetch(:path)), **rhs.except(:path, :query)}
+          parsed_path, parsed_query = merged.fetch_values(:path, :query)
+          override = URI::Generic.build(**merged.slice(:scheme, :host, :port), path: parsed_path)
 
           joined = URI.join(URI::Generic.build(lhs.except(:path, :query)), slashed, override)
           query = deep_merge(
@@ -473,10 +474,9 @@ module PreludeSDK
         # @return [Enumerable<String>]
         def writable_enum(&blk)
           Enumerator.new do |y|
-            buf = String.new
             y.define_singleton_method(:write) do
-              self << buf.replace(_1)
-              buf.bytesize
+              self << _1.dup
+              _1.bytesize
             end
 
             blk.call(y)
@@ -566,7 +566,8 @@ module PreludeSDK
         #
         # @return [Array(String, Enumerable<String>)]
         private def encode_multipart_streaming(body)
-          boundary = SecureRandom.urlsafe_base64(60)
+          # RFC 1521 Section 7.2.1 says we should have 70 char maximum for boundary length
+          boundary = SecureRandom.urlsafe_base64(46)
 
           closing = []
           strio = writable_enum do |y|
@@ -647,7 +648,7 @@ module PreludeSDK
         #
         # Assumes each chunk in stream has `Encoding::BINARY`.
         #
-        # @param headers [Hash{String=>String}, Net::HTTPHeader]
+        # @param headers [Hash{String=>String}]
         # @param stream [Enumerable<String>]
         # @param suppress_error [Boolean]
         #

data/lib/prelude_sdk/models/transactional_send_params.rb

@@ -26,7 +26,9 @@ module PreludeSDK
       optional :callback_url, String
 
       # @!attribute correlation_id
-      #   A unique, user-defined identifier that will be included in webhook events.
+      #   A user-defined identifier to correlate this transactional message with. It is
+      #   returned in the response and any webhook events that refer to this
+      #   transactionalmessage.
       #
       #   @return [String, nil]
       optional :correlation_id, String
@@ -52,13 +54,27 @@ module PreludeSDK
       #   @return [String, nil]
       optional :locale, String
 
+      # @!attribute preferred_channel
+      #   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.
+      #
+      #   If not specified and the template is configured for WhatsApp, the message will
+      #   be sent via WhatsApp first, with automatic fallback to SMS if WhatsApp delivery
+      #   is unavailable.
+      #
+      #   Supported channels: `sms`, `rcs`, `whatsapp`.
+      #
+      #   @return [Symbol, PreludeSDK::Models::TransactionalSendParams::PreferredChannel, nil]
+      optional :preferred_channel, enum: -> { PreludeSDK::TransactionalSendParams::PreferredChannel }
+
       # @!attribute variables
       #   The variables to be replaced in the template.
       #
       #   @return [Hash{Symbol=>String}, nil]
       optional :variables, PreludeSDK::Internal::Type::HashOf[String]
 
-      # @!method initialize(template_id:, to:, callback_url: nil, correlation_id: nil, expires_at: nil, from: nil, locale: nil, variables: nil, request_options: {})
+      # @!method initialize(template_id:, to:, callback_url: nil, correlation_id: nil, expires_at: nil, from: nil, locale: nil, preferred_channel: nil, variables: nil, request_options: {})
       #   Some parameter documentations has been truncated, see
       #   {PreludeSDK::Models::TransactionalSendParams} for more details.
       #
@@ -68,7 +84,7 @@ module PreludeSDK
       #
       #   @param callback_url [String] The callback URL.
       #
-      #   @param correlation_id [String] A unique, user-defined identifier that will be included in webhook events.
+      #   @param correlation_id [String] A user-defined identifier to correlate this transactional message with. It is re
       #
       #   @param expires_at [String] The message expiration date.
       #
@@ -76,9 +92,31 @@ module PreludeSDK
       #
       #   @param locale [String] A BCP-47 formatted locale string with the language the text message will be sent
       #
+      #   @param preferred_channel [Symbol, PreludeSDK::Models::TransactionalSendParams::PreferredChannel] The preferred delivery channel for the message. When specified, the system will
+      #
       #   @param variables [Hash{Symbol=>String}] The variables to be replaced in the template.
       #
       #   @param request_options [PreludeSDK::RequestOptions, Hash{Symbol=>Object}]
+
+      # 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.
+      #
+      # If not specified and the template is configured for WhatsApp, the message will
+      # be sent via WhatsApp first, with automatic fallback to SMS if WhatsApp delivery
+      # is unavailable.
+      #
+      # Supported channels: `sms`, `rcs`, `whatsapp`.
+      module PreferredChannel
+        extend PreludeSDK::Internal::Type::Enum
+
+        SMS = :sms
+        RCS = :rcs
+        WHATSAPP = :whatsapp
+
+        # @!method self.values
+        #   @return [Array<Symbol>]
+      end
     end
   end
 end

data/lib/prelude_sdk/models/transactional_send_response.rb

@@ -47,7 +47,9 @@ module PreludeSDK
       optional :callback_url, String
 
       # @!attribute correlation_id
-      #   A unique, user-defined identifier that will be included in webhook events.
+      #   A user-defined identifier to correlate this transactional message with. It is
+      #   returned in the response and any webhook events that refer to this transactional
+      #   message.
       #
       #   @return [String, nil]
       optional :correlation_id, String
@@ -59,6 +61,9 @@ module PreludeSDK
       optional :from, String
 
       # @!method initialize(id:, created_at:, expires_at:, template_id:, to:, variables:, callback_url: nil, correlation_id: nil, from: nil)
+      #   Some parameter documentations has been truncated, see
+      #   {PreludeSDK::Models::TransactionalSendResponse} for more details.
+      #
       #   @param id [String] The message identifier.
       #
       #   @param created_at [Time] The message creation date.
@@ -73,7 +78,7 @@ module PreludeSDK
       #
       #   @param callback_url [String] The callback URL.
       #
-      #   @param correlation_id [String] A unique, user-defined identifier that will be included in webhook events.
+      #   @param correlation_id [String] A user-defined identifier to correlate this transactional message with. It is re
       #
       #   @param from [String] The Sender ID.
     end

data/lib/prelude_sdk/models/verification_check_response.rb

@@ -53,14 +53,19 @@ module PreludeSDK
       # @see PreludeSDK::Models::VerificationCheckResponse#metadata
       class Metadata < PreludeSDK::Internal::Type::BaseModel
         # @!attribute correlation_id
+        #   A user-defined identifier to correlate this verification with. It is returned in
+        #   the response and any webhook events that refer to this verification.
         #
         #   @return [String, nil]
         optional :correlation_id, String
 
         # @!method initialize(correlation_id: nil)
+        #   Some parameter documentations has been truncated, see
+        #   {PreludeSDK::Models::VerificationCheckResponse::Metadata} for more details.
+        #
         #   The metadata for this verification.
         #
-        #   @param correlation_id [String]
+        #   @param correlation_id [String] A user-defined identifier to correlate this verification with. It is returned in
       end
     end
   end

data/lib/prelude_sdk/models/verification_create_params.rb

@@ -93,16 +93,20 @@ module PreludeSDK
 
       class Metadata < PreludeSDK::Internal::Type::BaseModel
         # @!attribute correlation_id
-        #   A user-defined identifier to correlate this verification with.
+        #   A user-defined identifier to correlate this verification with. It is returned in
+        #   the response and any webhook events that refer to this verification.
         #
         #   @return [String, nil]
         optional :correlation_id, String
 
         # @!method initialize(correlation_id: nil)
+        #   Some parameter documentations has been truncated, see
+        #   {PreludeSDK::Models::VerificationCreateParams::Metadata} for more details.
+        #
         #   The metadata for this verification. This object will be returned with every
         #   response or webhook sent that refers to this verification.
         #
-        #   @param correlation_id [String] A user-defined identifier to correlate this verification with.
+        #   @param correlation_id [String] A user-defined identifier to correlate this verification with. It is returned in
       end
 
       class Options < PreludeSDK::Internal::Type::BaseModel
@@ -136,6 +140,12 @@ module PreludeSDK
         #   @return [String, nil]
         optional :custom_code, String
 
+        # @!attribute integration
+        #   The integration that triggered the verification.
+        #
+        #   @return [Symbol, PreludeSDK::Models::VerificationCreateParams::Options::Integration, nil]
+        optional :integration, enum: -> { PreludeSDK::VerificationCreateParams::Options::Integration }
+
         # @!attribute locale
         #   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
@@ -145,27 +155,25 @@ module PreludeSDK
         #   @return [String, nil]
         optional :locale, String
 
-        # @!attribute method_
+        # @!attribute verification_method
         #   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
-        #   allows verification of landline numbers that cannot receive SMS messages.
+        #   allows verification of landline numbers that cannot receive SMS messages. The
+        #   'message' option explicitly requests message delivery (SMS, WhatsApp ...) and
+        #   skips silent verification, useful for scenarios requiring direct user
+        #   interaction.
         #
         #   @return [Symbol, PreludeSDK::Models::VerificationCreateParams::Options::Method, nil]
-        optional :method_,
-                 enum: -> {
-                   PreludeSDK::VerificationCreateParams::Options::Method
-                 },
+        optional :verification_method,
+                 enum: -> { PreludeSDK::VerificationCreateParams::Options::Method },
                  api_name: :method
 
         # @!attribute preferred_channel
         #   The preferred channel to be used in priority for verification.
         #
         #   @return [Symbol, PreludeSDK::Models::VerificationCreateParams::Options::PreferredChannel, nil]
-        optional :preferred_channel,
-                 enum: -> {
-                   PreludeSDK::VerificationCreateParams::Options::PreferredChannel
-                 }
+        optional :preferred_channel, enum: -> { PreludeSDK::VerificationCreateParams::Options::PreferredChannel }
 
         # @!attribute sender_id
         #   The Sender ID to use for this message. The Sender ID needs to be enabled by
@@ -187,7 +195,7 @@ module PreludeSDK
         #   @return [Hash{Symbol=>String}, nil]
         optional :variables, PreludeSDK::Internal::Type::HashOf[String]
 
-        # @!method initialize(app_realm: nil, callback_url: nil, code_size: nil, custom_code: nil, locale: nil, method_: nil, preferred_channel: nil, sender_id: nil, template_id: nil, variables: nil)
+        # @!method initialize(app_realm: nil, callback_url: nil, code_size: nil, custom_code: nil, integration: nil, locale: nil, verification_method: nil, preferred_channel: nil, sender_id: nil, template_id: nil, variables: nil)
         #   Some parameter documentations has been truncated, see
         #   {PreludeSDK::Models::VerificationCreateParams::Options} for more details.
         #
@@ -201,9 +209,11 @@ module PreludeSDK
         #
         #   @param custom_code [String] The custom code to use for OTP verification. To use the custom code feature, con
         #
+        #   @param integration [Symbol, PreludeSDK::Models::VerificationCreateParams::Options::Integration] The integration that triggered the verification.
+        #
         #   @param locale [String] A BCP-47 formatted locale string with the language the text message will be sent
         #
-        #   @param method_ [Symbol, PreludeSDK::Models::VerificationCreateParams::Options::Method] The method used for verifying this phone number. The 'voice' option provides an
+        #   @param verification_method [Symbol, PreludeSDK::Models::VerificationCreateParams::Options::Method] The method used for verifying this phone number. The 'voice' option provides an
         #
         #   @param preferred_channel [Symbol, PreludeSDK::Models::VerificationCreateParams::Options::PreferredChannel] The preferred channel to be used in priority for verification.
         #
@@ -223,7 +233,9 @@ module PreludeSDK
           required :platform, enum: -> { PreludeSDK::VerificationCreateParams::Options::AppRealm::Platform }
 
           # @!attribute value
-          #   The Android SMS Retriever API hash code that identifies your app.
+          #   The Android SMS Retriever API hash code that identifies your app. For more
+          #   information, see
+          #   [Google documentation](https://developers.google.com/identity/sms-retriever/verify#computing_your_apps_hash_string).
           #
           #   @return [String]
           required :value, String
@@ -254,17 +266,34 @@ module PreludeSDK
           end
         end
 
+        # The integration that triggered the verification.
+        #
+        # @see PreludeSDK::Models::VerificationCreateParams::Options#integration
+        module Integration
+          extend PreludeSDK::Internal::Type::Enum
+
+          AUTH0 = :auth0
+          SUPABASE = :supabase
+
+          # @!method self.values
+          #   @return [Array<Symbol>]
+        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
-        # allows verification of landline numbers that cannot receive SMS messages.
+        # allows verification of landline numbers that cannot receive SMS messages. The
+        # 'message' option explicitly requests message delivery (SMS, WhatsApp ...) and
+        # skips silent verification, useful for scenarios requiring direct user
+        # interaction.
         #
-        # @see PreludeSDK::Models::VerificationCreateParams::Options#method_
+        # @see PreludeSDK::Models::VerificationCreateParams::Options#verification_method
         module Method
           extend PreludeSDK::Internal::Type::Enum
 
           AUTO = :auto
           VOICE = :voice
+          MESSAGE = :message
 
           # @!method self.values
           #   @return [Array<Symbol>]
@@ -282,8 +311,6 @@ module PreludeSDK
           VIBER = :viber
           ZALO = :zalo
           TELEGRAM = :telegram
-          SILENT = :silent
-          VOICE = :voice
 
           # @!method self.values
           #   @return [Array<Symbol>]
@@ -330,6 +357,14 @@ module PreludeSDK
         #   @return [Boolean, nil]
         optional :is_trusted_user, PreludeSDK::Internal::Type::Boolean
 
+        # @!attribute ja4_fingerprint
+        #   The JA4 fingerprint observed for the connection. Prelude will infer it
+        #   automatically when requests go through our client SDK (which uses Prelude's
+        #   edge), but you can also provide it explicitly if you terminate TLS yourself.
+        #
+        #   @return [String, nil]
+        optional :ja4_fingerprint, String
+
         # @!attribute os_version
         #   The version of the user's device operating system.
         #
@@ -344,7 +379,7 @@ module PreludeSDK
         #   @return [String, nil]
         optional :user_agent, String
 
-        # @!method initialize(app_version: nil, device_id: nil, device_model: nil, device_platform: nil, ip: nil, is_trusted_user: nil, os_version: nil, user_agent: nil)
+        # @!method initialize(app_version: nil, device_id: nil, device_model: nil, device_platform: nil, ip: nil, is_trusted_user: nil, ja4_fingerprint: nil, os_version: nil, user_agent: nil)
         #   Some parameter documentations has been truncated, see
         #   {PreludeSDK::Models::VerificationCreateParams::Signals} for more details.
         #
@@ -363,6 +398,8 @@ module PreludeSDK
         #
         #   @param is_trusted_user [Boolean] This signal should provide a higher level of trust, indicating that the user is
         #
+        #   @param ja4_fingerprint [String] The JA4 fingerprint observed for the connection. Prelude will infer it automatic
+        #
         #   @param os_version [String] The version of the user's device operating system.
         #
         #   @param user_agent [String] The user agent of the user's device. If the individual fields (os_version, devic

data/lib/prelude_sdk/models/verification_create_response.rb

@@ -10,11 +10,13 @@ module PreludeSDK
       #   @return [String]
       required :id, String
 
-      # @!attribute method_
+      # @!attribute verification_method
       #   The method used for verifying this phone number.
       #
       #   @return [Symbol, PreludeSDK::Models::VerificationCreateResponse::Method]
-      required :method_, enum: -> { PreludeSDK::Models::VerificationCreateResponse::Method }, api_name: :method
+      required :verification_method,
+               enum: -> { PreludeSDK::Models::VerificationCreateResponse::Method },
+               api_name: :method
 
       # @!attribute status
       #   The status of the verification.
@@ -25,8 +27,9 @@ module PreludeSDK
       # @!attribute channels
       #   The ordered sequence of channels to be used for verification
       #
-      #   @return [Array<String>, nil]
-      optional :channels, PreludeSDK::Internal::Type::ArrayOf[String]
+      #   @return [Array<Symbol, PreludeSDK::Models::VerificationCreateResponse::Channel>, nil]
+      optional :channels,
+               -> { PreludeSDK::Internal::Type::ArrayOf[enum: PreludeSDK::Models::VerificationCreateResponse::Channel] }
 
       # @!attribute metadata
       #   The metadata for this verification.
@@ -38,6 +41,19 @@ module PreludeSDK
       #   The reason why the verification was blocked. Only present when status is
       #   "blocked".
       #
+      #   - `expired_signature` - The signature of the SDK signals is expired. They should
+      #     be sent within the hour following their collection.
+      #   - `in_block_list` - The phone number is part of the configured block list.
+      #   - `invalid_phone_line` - The phone number is not a valid line number (e.g.
+      #     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.
+      #   - `suspicious` - The verification attempt was deemed suspicious by the
+      #     anti-fraud system.
+      #
       #   @return [Symbol, PreludeSDK::Models::VerificationCreateResponse::Reason, nil]
       optional :reason, enum: -> { PreludeSDK::Models::VerificationCreateResponse::Reason }
 
@@ -52,17 +68,17 @@ module PreludeSDK
       #   @return [PreludeSDK::Models::VerificationCreateResponse::Silent, nil]
       optional :silent, -> { PreludeSDK::Models::VerificationCreateResponse::Silent }
 
-      # @!method initialize(id:, method_:, status:, channels: nil, metadata: nil, reason: nil, request_id: nil, silent: nil)
+      # @!method initialize(id:, verification_method:, status:, channels: nil, metadata: nil, reason: nil, request_id: nil, silent: nil)
       #   Some parameter documentations has been truncated, see
       #   {PreludeSDK::Models::VerificationCreateResponse} for more details.
       #
       #   @param id [String] The verification identifier.
       #
-      #   @param method_ [Symbol, PreludeSDK::Models::VerificationCreateResponse::Method] The method used for verifying this phone number.
+      #   @param verification_method [Symbol, PreludeSDK::Models::VerificationCreateResponse::Method] The method used for verifying this phone number.
       #
       #   @param status [Symbol, PreludeSDK::Models::VerificationCreateResponse::Status] The status of the verification.
       #
-      #   @param channels [Array<String>] The ordered sequence of channels to be used for verification
+      #   @param channels [Array<Symbol, PreludeSDK::Models::VerificationCreateResponse::Channel>] The ordered sequence of channels to be used for verification
       #
       #   @param metadata [PreludeSDK::Models::VerificationCreateResponse::Metadata] The metadata for this verification.
       #
@@ -74,10 +90,11 @@ module PreludeSDK
 
       # The method used for verifying this phone number.
       #
-      # @see PreludeSDK::Models::VerificationCreateResponse#method_
+      # @see PreludeSDK::Models::VerificationCreateResponse#verification_method
       module Method
         extend PreludeSDK::Internal::Type::Enum
 
+        EMAIL = :email
         MESSAGE = :message
         SILENT = :silent
         VOICE = :voice
@@ -100,31 +117,67 @@ module PreludeSDK
         #   @return [Array<Symbol>]
       end
 
+      module Channel
+        extend PreludeSDK::Internal::Type::Enum
+
+        RCS = :rcs
+        SILENT = :silent
+        SMS = :sms
+        TELEGRAM = :telegram
+        VIBER = :viber
+        VOICE = :voice
+        WHATSAPP = :whatsapp
+        ZALO = :zalo
+
+        # @!method self.values
+        #   @return [Array<Symbol>]
+      end
+
       # @see PreludeSDK::Models::VerificationCreateResponse#metadata
       class Metadata < PreludeSDK::Internal::Type::BaseModel
         # @!attribute correlation_id
+        #   A user-defined identifier to correlate this verification with. It is returned in
+        #   the response and any webhook events that refer to this verification.
         #
         #   @return [String, nil]
         optional :correlation_id, String
 
         # @!method initialize(correlation_id: nil)
+        #   Some parameter documentations has been truncated, see
+        #   {PreludeSDK::Models::VerificationCreateResponse::Metadata} for more details.
+        #
         #   The metadata for this verification.
         #
-        #   @param correlation_id [String]
+        #   @param correlation_id [String] A user-defined identifier to correlate this verification with. It is returned in
       end
 
       # The reason why the verification was blocked. Only present when status is
       # "blocked".
       #
+      # - `expired_signature` - The signature of the SDK signals is expired. They should
+      #   be sent within the hour following their collection.
+      # - `in_block_list` - The phone number is part of the configured block list.
+      # - `invalid_phone_line` - The phone number is not a valid line number (e.g.
+      #   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.
+      # - `suspicious` - The verification attempt was deemed suspicious by the
+      #   anti-fraud system.
+      #
       # @see PreludeSDK::Models::VerificationCreateResponse#reason
       module Reason
         extend PreludeSDK::Internal::Type::Enum
 
-        SUSPICIOUS = :suspicious
-        REPEATED_ATTEMPTS = :repeated_attempts
+        EXPIRED_SIGNATURE = :expired_signature
+        IN_BLOCK_LIST = :in_block_list
         INVALID_PHONE_LINE = :invalid_phone_line
         INVALID_PHONE_NUMBER = :invalid_phone_number
-        IN_BLOCK_LIST = :in_block_list
+        INVALID_SIGNATURE = :invalid_signature
+        REPEATED_ATTEMPTS = :repeated_attempts
+        SUSPICIOUS = :suspicious
 
         # @!method self.values
         #   @return [Array<Symbol>]

data/lib/prelude_sdk/models/verification_management_delete_phone_number_params.rb

@@ -0,0 +1,32 @@
+# frozen_string_literal: true
+
+module PreludeSDK
+  module Models
+    # @see PreludeSDK::Resources::VerificationManagement#delete_phone_number
+    class VerificationManagementDeletePhoneNumberParams < PreludeSDK::Internal::Type::BaseModel
+      extend PreludeSDK::Internal::Type::RequestParameters::Converter
+      include PreludeSDK::Internal::Type::RequestParameters
+
+      # @!attribute phone_number
+      #   An E.164 formatted phone number to remove from the list.
+      #
+      #   @return [String]
+      required :phone_number, String
+
+      # @!method initialize(phone_number:, request_options: {})
+      #   @param phone_number [String] An E.164 formatted phone number to remove from the list.
+      #
+      #   @param request_options [PreludeSDK::RequestOptions, Hash{Symbol=>Object}]
+
+      module Action
+        extend PreludeSDK::Internal::Type::Enum
+
+        ALLOW = :allow
+        BLOCK = :block
+
+        # @!method self.values
+        #   @return [Array<Symbol>]
+      end
+    end
+  end
+end

data/lib/prelude_sdk/models/verification_management_delete_phone_number_response.rb

@@ -0,0 +1,17 @@
+# frozen_string_literal: true
+
+module PreludeSDK
+  module Models
+    # @see PreludeSDK::Resources::VerificationManagement#delete_phone_number
+    class VerificationManagementDeletePhoneNumberResponse < PreludeSDK::Internal::Type::BaseModel
+      # @!attribute phone_number
+      #   The E.164 formatted phone number that was removed from the list.
+      #
+      #   @return [String]
+      required :phone_number, String
+
+      # @!method initialize(phone_number:)
+      #   @param phone_number [String] The E.164 formatted phone number that was removed from the list.
+    end
+  end
+end

data/lib/prelude_sdk/models/verification_management_list_phone_numbers_params.rb

@@ -0,0 +1,24 @@
+# frozen_string_literal: true
+
+module PreludeSDK
+  module Models
+    # @see PreludeSDK::Resources::VerificationManagement#list_phone_numbers
+    class VerificationManagementListPhoneNumbersParams < PreludeSDK::Internal::Type::BaseModel
+      extend PreludeSDK::Internal::Type::RequestParameters::Converter
+      include PreludeSDK::Internal::Type::RequestParameters
+
+      # @!method initialize(request_options: {})
+      #   @param request_options [PreludeSDK::RequestOptions, Hash{Symbol=>Object}]
+
+      module Action
+        extend PreludeSDK::Internal::Type::Enum
+
+        ALLOW = :allow
+        BLOCK = :block
+
+        # @!method self.values
+        #   @return [Array<Symbol>]
+      end
+    end
+  end
+end