prelude-sdk 0.3.0 → 0.5.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 0442af375a6b077b348b680c39f073a48a66ff185d57f5f20ee53300531a8bf7
-  data.tar.gz: 60d8b444c65e5e55b487f61d158c9531fcb02435c66a1f9eaa3688640789d08f
+  metadata.gz: e471ff14576be4e30d555ac095637659799c089243d85e8eb0b1e107d5f72a4d
+  data.tar.gz: b7429bca67dc1516c3deaccf43ca63535b4b2ec8e07d36889635893b940cb1ee
 SHA512:
-  metadata.gz: 6c337ee4e3c9f6d13391ae942cda76beaef0ff292b14b5416f66450005908bfe09d250fad09444635eaabf1fb3e02eb3ad8d356740218a0a7188729487c65639
-  data.tar.gz: cb6ae9f844d4a6d5313e001802b40b0624e93da2cfdbbefaec0cfa68f2cd14f74a0397dd8ac51d338f52b24c478f350d19d9eb77a8cf4d17d12e9fe7778ffcea
+  metadata.gz: ad313a26fcd1936dc0b3e66224f7fdf4488c392c85ac3828ee18ff93463791e07ff0113296d5145ef492a3189787601c8481a8ee83fd735af42b985a52cbb148
+  data.tar.gz: 2be45dd24a4db7b69cc636e1db2703d69a88721034ebb50bff9f3f79c1b6df2179b4a1f4a08f9681bd6498c7f50f380034e9ff1e6ee895a437433932bbd9d212

data/CHANGELOG.md

@@ -1,5 +1,47 @@
 # Changelog
 
+## 0.5.0 (2026-05-07)
+
+Full Changelog: [v0.4.0...v0.5.0](https://github.com/prelude-so/ruby-sdk/compare/v0.4.0...v0.5.0)
+
+### Features
+
+* **api:** api update ([4a28614](https://github.com/prelude-so/ruby-sdk/commit/4a286145c86c872f859225d1d892e98c640598af))
+* **api:** api update ([7beed1d](https://github.com/prelude-so/ruby-sdk/commit/7beed1dab00a7fd90594bba5f94f53261e22b549))
+
+## 0.4.0 (2026-04-30)
+
+Full Changelog: [v0.3.0...v0.4.0](https://github.com/prelude-so/ruby-sdk/compare/v0.3.0...v0.4.0)
+
+### Features
+
+* **api:** api update ([6ef917b](https://github.com/prelude-so/ruby-sdk/commit/6ef917bcd3a32e40139d32528e20ad17ea3b8278))
+* **api:** api update ([f0ec5a8](https://github.com/prelude-so/ruby-sdk/commit/f0ec5a8d5121f7f8d541a3f9fbf5a2176380bdb2))
+* **api:** api update ([3041c86](https://github.com/prelude-so/ruby-sdk/commit/3041c8644933cc9a849dc02bdf2717c4405bf812))
+* **api:** api update ([3d94aa1](https://github.com/prelude-so/ruby-sdk/commit/3d94aa1539b0ee491fb1b852976aee745c72f08b))
+* **api:** api update ([3f9e6ce](https://github.com/prelude-so/ruby-sdk/commit/3f9e6ce6f97d66c574611befa9c1620b93eeeb76))
+* support setting headers via env ([755c4ac](https://github.com/prelude-so/ruby-sdk/commit/755c4acad1a339802b824f6f719a9084db6742fc))
+
+
+### Bug Fixes
+
+* align path encoding with RFC 3986 section 3.3 ([20f9b5e](https://github.com/prelude-so/ruby-sdk/commit/20f9b5e3571676a09e4b2aa5a1f554257d67c07d))
+* **internal:** correct multipart form field name encoding ([ba42aef](https://github.com/prelude-so/ruby-sdk/commit/ba42aeff39e77c2911fddb776676bf5ec3b6480d))
+* multipart encoding for file arrays ([00c8720](https://github.com/prelude-so/ruby-sdk/commit/00c87208d38c26848af8a20f0f2ab916d908ca95))
+* variable name typo ([2a83f6e](https://github.com/prelude-so/ruby-sdk/commit/2a83f6eff281991ab4736f6ce752cef42c7e4b60))
+
+
+### Chores
+
+* **ci:** skip lint on metadata-only changes ([ecdcd0b](https://github.com/prelude-so/ruby-sdk/commit/ecdcd0b15967ac9ab50887e24c9884804a72c2c7))
+* **ci:** support opting out of skipping builds on metadata-only commits ([86d205e](https://github.com/prelude-so/ruby-sdk/commit/86d205e651fbb5002655857a287ec09b0b2b4370))
+* **internal:** more robust bootstrap script ([1163c75](https://github.com/prelude-so/ruby-sdk/commit/1163c758b68ed31eb3ae60117d8850ba3417c829))
+* **tests:** bump steady to v0.19.6 ([9be6206](https://github.com/prelude-so/ruby-sdk/commit/9be6206e357ce0ab47da60230a356ed5d2e33bc3))
+* **tests:** bump steady to v0.19.7 ([e96d496](https://github.com/prelude-so/ruby-sdk/commit/e96d496b589f7a404288d92b8519ae25fc1f4c96))
+* **tests:** bump steady to v0.20.1 ([f9c136f](https://github.com/prelude-so/ruby-sdk/commit/f9c136fad7a342404cc80b6e5d10a0c5cce19d88))
+* **tests:** bump steady to v0.20.2 ([cf8ca21](https://github.com/prelude-so/ruby-sdk/commit/cf8ca215bacfb6606bfe3ca08db55bacef5c3d18))
+* **tests:** bump steady to v0.22.1 ([4223d7b](https://github.com/prelude-so/ruby-sdk/commit/4223d7b15d68b27d1029eb93e135a96e25244548))
+
 ## 0.3.0 (2026-03-23)
 
 Full Changelog: [v0.2.0...v0.3.0](https://github.com/prelude-so/ruby-sdk/compare/v0.2.0...v0.3.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.3.0"
+gem "prelude-sdk", "~> 0.5.0"
 ```
 
 <!-- x-release-please-end -->

data/lib/prelude_sdk/client.rb

@@ -81,6 +81,19 @@ module PreludeSDK
         raise ArgumentError.new("api_token is required, and can be set via environ: \"API_TOKEN\"")
       end
 
+      headers = {}
+      custom_headers_env = ENV["PRELUDE_CUSTOM_HEADERS"]
+      unless custom_headers_env.nil?
+        parsed = {}
+        custom_headers_env.split("\n").each do |line|
+          colon = line.index(":")
+          unless colon.nil?
+            parsed[line[0...colon].strip] = line[(colon + 1)..].strip
+          end
+        end
+        headers = parsed.merge(headers)
+      end
+
       @api_token = api_token.to_s
 
       super(
@@ -88,7 +101,8 @@ module PreludeSDK
         timeout: timeout,
         max_retries: max_retries,
         initial_retry_delay: initial_retry_delay,
-        max_retry_delay: max_retry_delay
+        max_retry_delay: max_retry_delay,
+        headers: headers
       )
 
       @lookup = PreludeSDK::Resources::Lookup.new(client: self)

data/lib/prelude_sdk/internal/util.rb

@@ -157,7 +157,7 @@ module PreludeSDK
           in Hash | nil => coerced
             coerced
           else
-            message = "Expected a #{Hash} or #{PreludeSDK::Internal::Type::BaseModel}, got #{data.inspect}"
+            message = "Expected a #{Hash} or #{PreludeSDK::Internal::Type::BaseModel}, got #{input.inspect}"
             raise ArgumentError.new(message)
           end
         end
@@ -237,6 +237,11 @@ module PreludeSDK
         end
       end
 
+      # @type [Regexp]
+      #
+      # https://www.rfc-editor.org/rfc/rfc3986.html#section-3.3
+      RFC_3986_NOT_PCHARS = /[^A-Za-z0-9\-._~!$&'()*+,;=:@]+/
+
       class << self
         # @api private
         #
@@ -247,6 +252,15 @@ module PreludeSDK
           "#{uri.scheme}://#{uri.host}#{":#{uri.port}" unless uri.port == uri.default_port}"
         end
 
+        # @api private
+        #
+        # @param path [String, Integer]
+        #
+        # @return [String]
+        def encode_path(path)
+          path.to_s.gsub(PreludeSDK::Internal::Util::RFC_3986_NOT_PCHARS) { ERB::Util.url_encode(_1) }
+        end
+
         # @api private
         #
         # @param path [String, Array<String>]
@@ -259,7 +273,7 @@ module PreludeSDK
           in []
             ""
           in [String => p, *interpolations]
-            encoded = interpolations.map { ERB::Util.url_encode(_1) }
+            encoded = interpolations.map { encode_path(_1) }
             format(p, *encoded)
           end
         end
@@ -571,16 +585,15 @@ module PreludeSDK
           y << "Content-Disposition: form-data"
 
           unless key.nil?
-            name = ERB::Util.url_encode(key.to_s)
-            y << "; name=\"#{name}\""
+            y << "; name=\"#{key}\""
           end
 
           case val
           in PreludeSDK::FilePart unless val.filename.nil?
-            filename = ERB::Util.url_encode(val.filename)
+            filename = encode_path(val.filename)
             y << "; filename=\"#{filename}\""
           in Pathname | IO
-            filename = ERB::Util.url_encode(::File.basename(val.to_path))
+            filename = encode_path(::File.basename(val.to_path))
             y << "; filename=\"#{filename}\""
           else
           end
@@ -597,6 +610,7 @@ module PreludeSDK
         #
         # @return [Array(String, Enumerable<String>)]
         private def encode_multipart_streaming(body)
+          # rubocop:disable Style/CaseEquality
           # RFC 1521 Section 7.2.1 says we should have 70 char maximum for boundary length
           boundary = SecureRandom.urlsafe_base64(46)
 
@@ -606,7 +620,7 @@ module PreludeSDK
             in Hash
               body.each do |key, val|
                 case val
-                in Array if val.all? { primitive?(_1) }
+                in Array if val.all? { primitive?(_1) || PreludeSDK::Internal::Type::FileInput === _1 }
                   val.each do |v|
                     write_multipart_chunk(y, boundary: boundary, key: key, val: v, closing: closing)
                   end
@@ -622,6 +636,7 @@ module PreludeSDK
 
           fused_io = fused_enum(strio) { closing.each(&:call) }
           [boundary, fused_io]
+          # rubocop:enable Style/CaseEquality
         end
 
         # @api private

data/lib/prelude_sdk/models/notify_send_batch_params.rb

@@ -32,8 +32,16 @@ module PreludeSDK
       optional :correlation_id, String
 
       # @!attribute document
-      #   A document to attach to the message. Only supported on WhatsApp templates that
-      #   have a document header.
+      #   A media attachment to include in the message header. Supported on WhatsApp
+      #   templates registered with a `DOCUMENT`, `IMAGE`, or `VIDEO` header. The media
+      #   type is determined by the template's registered header format; send the matching
+      #   file type for each.
+      #
+      #   - `DOCUMENT` headers accept PDF and other document formats; `filename` is
+      #     required and displayed to the recipient.
+      #   - `IMAGE` headers accept `.png`, `.jpg`, `.jpeg`, and `.webp` URLs; `filename`
+      #     is ignored.
+      #   - `VIDEO` headers accept `.mp4` and `.3gp` URLs; `filename` is ignored.
       #
       #   @return [PreludeSDK::Models::NotifySendBatchParams::Document, nil]
       optional :document, -> { PreludeSDK::NotifySendBatchParams::Document }
@@ -88,7 +96,7 @@ module PreludeSDK
       #
       #   @param correlation_id [String] A user-defined identifier to correlate this request with your internal systems.
       #
-      #   @param document [PreludeSDK::Models::NotifySendBatchParams::Document] A document to attach to the message. Only supported on WhatsApp templates that h
+      #   @param document [PreludeSDK::Models::NotifySendBatchParams::Document] A media attachment to include in the message header. Supported on
       #
       #   @param expires_at [Time] The message expiration date in RFC3339 format. Messages will not be sent after t
       #
@@ -105,25 +113,39 @@ module PreludeSDK
       #   @param request_options [PreludeSDK::RequestOptions, Hash{Symbol=>Object}]
 
       class Document < PreludeSDK::Internal::Type::BaseModel
-        # @!attribute filename
-        #   The filename to display for the document.
-        #
-        #   @return [String]
-        required :filename, String
-
         # @!attribute url
-        #   The URL of the document to attach. Must be a valid HTTP or HTTPS URL.
+        #   HTTPS URL of the media file. The file extension must match the template's
+        #   registered header format (PDF for DOCUMENT; PNG/JPG/JPEG/WEBP for IMAGE; MP4/3GP
+        #   for VIDEO).
         #
         #   @return [String]
         required :url, String
 
-        # @!method initialize(filename:, url:)
-        #   A document to attach to the message. Only supported on WhatsApp templates that
-        #   have a document header.
+        # @!attribute filename
+        #   Filename displayed to the recipient. Required for templates with a `DOCUMENT`
+        #   header; ignored for `IMAGE` and `VIDEO` headers.
+        #
+        #   @return [String, nil]
+        optional :filename, String
+
+        # @!method initialize(url:, filename: nil)
+        #   Some parameter documentations has been truncated, see
+        #   {PreludeSDK::Models::NotifySendBatchParams::Document} for more details.
+        #
+        #   A media attachment to include in the message header. Supported on WhatsApp
+        #   templates registered with a `DOCUMENT`, `IMAGE`, or `VIDEO` header. The media
+        #   type is determined by the template's registered header format; send the matching
+        #   file type for each.
+        #
+        #   - `DOCUMENT` headers accept PDF and other document formats; `filename` is
+        #     required and displayed to the recipient.
+        #   - `IMAGE` headers accept `.png`, `.jpg`, `.jpeg`, and `.webp` URLs; `filename`
+        #     is ignored.
+        #   - `VIDEO` headers accept `.mp4` and `.3gp` URLs; `filename` is ignored.
         #
-        #   @param filename [String] The filename to display for the document.
+        #   @param url [String] HTTPS URL of the media file. The file extension must match the template's regist
         #
-        #   @param url [String] The URL of the document to attach. Must be a valid HTTP or HTTPS URL.
+        #   @param filename [String] Filename displayed to the recipient. Required for templates with a `DOCUMENT` he
       end
 
       # Preferred channel for delivery. If unavailable, automatic fallback applies.
@@ -131,6 +153,7 @@ module PreludeSDK
         extend PreludeSDK::Internal::Type::Enum
 
         SMS = :sms
+        RCS = :rcs
         WHATSAPP = :whatsapp
 
         # @!method self.values

data/lib/prelude_sdk/models/notify_send_params.rb

@@ -34,8 +34,16 @@ module PreludeSDK
       optional :correlation_id, String
 
       # @!attribute document
-      #   A document to attach to the message. Only supported on WhatsApp templates that
-      #   have a document header.
+      #   A media attachment to include in the message header. Supported on WhatsApp
+      #   templates registered with a `DOCUMENT`, `IMAGE`, or `VIDEO` header. The media
+      #   type is determined by the template's registered header format; send the matching
+      #   file type for each.
+      #
+      #   - `DOCUMENT` headers accept PDF and other document formats; `filename` is
+      #     required and displayed to the recipient.
+      #   - `IMAGE` headers accept `.png`, `.jpg`, `.jpeg`, and `.webp` URLs; `filename`
+      #     is ignored.
+      #   - `VIDEO` headers accept `.mp4` and `.3gp` URLs; `filename` is ignored.
       #
       #   @return [PreludeSDK::Models::NotifySendParams::Document, nil]
       optional :document, -> { PreludeSDK::NotifySendParams::Document }
@@ -95,7 +103,7 @@ module PreludeSDK
       #
       #   @param correlation_id [String] A user-defined identifier to correlate this message with your internal systems.
       #
-      #   @param document [PreludeSDK::Models::NotifySendParams::Document] A document to attach to the message. Only supported on WhatsApp templates that h
+      #   @param document [PreludeSDK::Models::NotifySendParams::Document] A media attachment to include in the message header. Supported on
       #
       #   @param expires_at [Time] The message expiration date in RFC3339 format. The message will not be sent if t
       #
@@ -112,25 +120,39 @@ module PreludeSDK
       #   @param request_options [PreludeSDK::RequestOptions, Hash{Symbol=>Object}]
 
       class Document < PreludeSDK::Internal::Type::BaseModel
-        # @!attribute filename
-        #   The filename to display for the document.
-        #
-        #   @return [String]
-        required :filename, String
-
         # @!attribute url
-        #   The URL of the document to attach. Must be a valid HTTP or HTTPS URL.
+        #   HTTPS URL of the media file. The file extension must match the template's
+        #   registered header format (PDF for DOCUMENT; PNG/JPG/JPEG/WEBP for IMAGE; MP4/3GP
+        #   for VIDEO).
         #
         #   @return [String]
         required :url, String
 
-        # @!method initialize(filename:, url:)
-        #   A document to attach to the message. Only supported on WhatsApp templates that
-        #   have a document header.
+        # @!attribute filename
+        #   Filename displayed to the recipient. Required for templates with a `DOCUMENT`
+        #   header; ignored for `IMAGE` and `VIDEO` headers.
+        #
+        #   @return [String, nil]
+        optional :filename, String
+
+        # @!method initialize(url:, filename: nil)
+        #   Some parameter documentations has been truncated, see
+        #   {PreludeSDK::Models::NotifySendParams::Document} for more details.
+        #
+        #   A media attachment to include in the message header. Supported on WhatsApp
+        #   templates registered with a `DOCUMENT`, `IMAGE`, or `VIDEO` header. The media
+        #   type is determined by the template's registered header format; send the matching
+        #   file type for each.
+        #
+        #   - `DOCUMENT` headers accept PDF and other document formats; `filename` is
+        #     required and displayed to the recipient.
+        #   - `IMAGE` headers accept `.png`, `.jpg`, `.jpeg`, and `.webp` URLs; `filename`
+        #     is ignored.
+        #   - `VIDEO` headers accept `.mp4` and `.3gp` URLs; `filename` is ignored.
         #
-        #   @param filename [String] The filename to display for the document.
+        #   @param url [String] HTTPS URL of the media file. The file extension must match the template's regist
         #
-        #   @param url [String] The URL of the document to attach. Must be a valid HTTP or HTTPS URL.
+        #   @param filename [String] Filename displayed to the recipient. Required for templates with a `DOCUMENT` he
       end
 
       # The preferred channel to be used in priority for message delivery. If the
@@ -139,6 +161,7 @@ module PreludeSDK
         extend PreludeSDK::Internal::Type::Enum
 
         SMS = :sms
+        RCS = :rcs
         WHATSAPP = :whatsapp
 
         # @!method self.values

data/lib/prelude_sdk/models/transactional_send_params.rb

@@ -34,8 +34,16 @@ module PreludeSDK
       optional :correlation_id, String
 
       # @!attribute document
-      #   A document to attach to the message. Only supported on WhatsApp templates that
-      #   have a document header.
+      #   A media attachment to include in the message header. Supported on WhatsApp
+      #   templates registered with a `DOCUMENT`, `IMAGE`, or `VIDEO` header. The media
+      #   type is determined by the template's registered header format; send the matching
+      #   file type for each.
+      #
+      #   - `DOCUMENT` headers accept PDF and other document formats; `filename` is
+      #     required and displayed to the recipient.
+      #   - `IMAGE` headers accept `.png`, `.jpg`, `.jpeg`, and `.webp` URLs; `filename`
+      #     is ignored.
+      #   - `VIDEO` headers accept `.mp4` and `.3gp` URLs; `filename` is ignored.
       #
       #   @return [PreludeSDK::Models::TransactionalSendParams::Document, nil]
       optional :document, -> { PreludeSDK::TransactionalSendParams::Document }
@@ -93,7 +101,7 @@ module PreludeSDK
       #
       #   @param correlation_id [String] A user-defined identifier to correlate this transactional message with. It is re
       #
-      #   @param document [PreludeSDK::Models::TransactionalSendParams::Document] A document to attach to the message. Only supported on WhatsApp templates that h
+      #   @param document [PreludeSDK::Models::TransactionalSendParams::Document] A media attachment to include in the message header. Supported on
       #
       #   @param expires_at [String] The message expiration date.
       #
@@ -108,25 +116,39 @@ module PreludeSDK
       #   @param request_options [PreludeSDK::RequestOptions, Hash{Symbol=>Object}]
 
       class Document < PreludeSDK::Internal::Type::BaseModel
-        # @!attribute filename
-        #   The filename to display for the document.
-        #
-        #   @return [String]
-        required :filename, String
-
         # @!attribute url
-        #   The URL of the document to attach. Must be a valid HTTP or HTTPS URL.
+        #   HTTPS URL of the media file. The file extension must match the template's
+        #   registered header format (PDF for DOCUMENT; PNG/JPG/JPEG/WEBP for IMAGE; MP4/3GP
+        #   for VIDEO).
         #
         #   @return [String]
         required :url, String
 
-        # @!method initialize(filename:, url:)
-        #   A document to attach to the message. Only supported on WhatsApp templates that
-        #   have a document header.
+        # @!attribute filename
+        #   Filename displayed to the recipient. Required for templates with a `DOCUMENT`
+        #   header; ignored for `IMAGE` and `VIDEO` headers.
+        #
+        #   @return [String, nil]
+        optional :filename, String
+
+        # @!method initialize(url:, filename: nil)
+        #   Some parameter documentations has been truncated, see
+        #   {PreludeSDK::Models::TransactionalSendParams::Document} for more details.
+        #
+        #   A media attachment to include in the message header. Supported on WhatsApp
+        #   templates registered with a `DOCUMENT`, `IMAGE`, or `VIDEO` header. The media
+        #   type is determined by the template's registered header format; send the matching
+        #   file type for each.
+        #
+        #   - `DOCUMENT` headers accept PDF and other document formats; `filename` is
+        #     required and displayed to the recipient.
+        #   - `IMAGE` headers accept `.png`, `.jpg`, `.jpeg`, and `.webp` URLs; `filename`
+        #     is ignored.
+        #   - `VIDEO` headers accept `.mp4` and `.3gp` URLs; `filename` is ignored.
         #
-        #   @param filename [String] The filename to display for the document.
+        #   @param url [String] HTTPS URL of the media file. The file extension must match the template's regist
         #
-        #   @param url [String] The URL of the document to attach. Must be a valid HTTP or HTTPS URL.
+        #   @param filename [String] Filename displayed to the recipient. Required for templates with a `DOCUMENT` he
       end
 
       # The preferred delivery channel for the message. When specified, the system will

data/lib/prelude_sdk/models/verification_create_response.rb

@@ -27,6 +27,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.
       #
       #   @return [Symbol, PreludeSDK::Models::VerificationCreateResponse::Status]
       required :status, enum: -> { PreludeSDK::Models::VerificationCreateResponse::Status }
@@ -46,7 +49,7 @@ module PreludeSDK
 
       # @!attribute reason
       #   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.
@@ -69,13 +72,43 @@ module PreludeSDK
       #   @return [String, nil]
       optional :request_id, String
 
+      # @!attribute risk_factors
+      #   The risk factors that contributed to the verification being blocked. Only
+      #   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.
+      #
+      #   @return [Array<Symbol, PreludeSDK::Models::VerificationCreateResponse::RiskFactor>, nil]
+      optional :risk_factors,
+               -> { PreludeSDK::Internal::Type::ArrayOf[enum: PreludeSDK::Models::VerificationCreateResponse::RiskFactor] }
+
       # @!attribute silent
       #   The silent verification specific properties.
       #
       #   @return [PreludeSDK::Models::VerificationCreateResponse::Silent, nil]
       optional :silent, -> { PreludeSDK::Models::VerificationCreateResponse::Silent }
 
-      # @!method initialize(id:, verification_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, risk_factors: nil, silent: nil)
       #   Some parameter documentations has been truncated, see
       #   {PreludeSDK::Models::VerificationCreateResponse} for more details.
       #
@@ -93,6 +126,8 @@ module PreludeSDK
       #
       #   @param request_id [String]
       #
+      #   @param risk_factors [Array<Symbol, PreludeSDK::Models::VerificationCreateResponse::RiskFactor>] The risk factors that contributed to the verification being blocked. Only presen
+      #
       #   @param silent [PreludeSDK::Models::VerificationCreateResponse::Silent] The silent verification specific properties.
 
       # The method used for verifying this phone number.
@@ -118,6 +153,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.
       #
       # @see PreludeSDK::Models::VerificationCreateResponse#status
       module Status
@@ -127,6 +165,7 @@ module PreludeSDK
         RETRY = :retry
         CHALLENGED = :challenged
         BLOCKED = :blocked
+        SHADOW_BLOCKED = :shadow_blocked
 
         # @!method self.values
         #   @return [Array<Symbol>]
@@ -167,7 +206,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.
@@ -198,6 +237,24 @@ module PreludeSDK
         #   @return [Array<Symbol>]
       end
 
+      module RiskFactor
+        extend PreludeSDK::Internal::Type::Enum
+
+        BEHAVIORAL_PATTERN = :behavioral_pattern
+        DEVICE_ATTRIBUTE = :device_attribute
+        FRAUD_DATABASE = :fraud_database
+        LOCATION_DISCREPANCY = :location_discrepancy
+        NETWORK_FINGERPRINT = :network_fingerprint
+        POOR_CONVERSION_HISTORY = :poor_conversion_history
+        PREFIX_CONCENTRATION = :prefix_concentration
+        SUSPECTED_REQUEST_TAMPERING = :suspected_request_tampering
+        SUSPICIOUS_IP_ADDRESS = :suspicious_ip_address
+        TEMPORARY_PHONE_NUMBER = :temporary_phone_number
+
+        # @!method self.values
+        #   @return [Array<Symbol>]
+      end
+
       # @see PreludeSDK::Models::VerificationCreateResponse#silent
       class Silent < PreludeSDK::Internal::Type::BaseModel
         # @!attribute request_url

data/lib/prelude_sdk/models/watch_send_events_params.rb

@@ -8,13 +8,17 @@ module PreludeSDK
       include PreludeSDK::Internal::Type::RequestParameters
 
       # @!attribute events
-      #   A list of events to dispatch.
+      #   A list of events to dispatch. A maximum of 100 events can be sent in a single
+      #   request.
       #
       #   @return [Array<PreludeSDK::Models::WatchSendEventsParams::Event>]
       required :events, -> { PreludeSDK::Internal::Type::ArrayOf[PreludeSDK::WatchSendEventsParams::Event] }
 
       # @!method initialize(events:, request_options: {})
-      #   @param events [Array<PreludeSDK::Models::WatchSendEventsParams::Event>] A list of events to dispatch.
+      #   Some parameter documentations has been truncated, see
+      #   {PreludeSDK::Models::WatchSendEventsParams} for more details.
+      #
+      #   @param events [Array<PreludeSDK::Models::WatchSendEventsParams::Event>] A list of events to dispatch. A maximum of 100 events can be sent in a single re
       #
       #   @param request_options [PreludeSDK::RequestOptions, Hash{Symbol=>Object}]
 

data/lib/prelude_sdk/models/watch_send_feedbacks_params.rb

@@ -8,14 +8,18 @@ module PreludeSDK
       include PreludeSDK::Internal::Type::RequestParameters
 
       # @!attribute feedbacks
-      #   A list of feedbacks to send.
+      #   A list of feedbacks to send. A maximum of 100 feedbacks can be sent in a single
+      #   request.
       #
       #   @return [Array<PreludeSDK::Models::WatchSendFeedbacksParams::Feedback>]
       required :feedbacks,
                -> { PreludeSDK::Internal::Type::ArrayOf[PreludeSDK::WatchSendFeedbacksParams::Feedback] }
 
       # @!method initialize(feedbacks:, request_options: {})
-      #   @param feedbacks [Array<PreludeSDK::Models::WatchSendFeedbacksParams::Feedback>] A list of feedbacks to send.
+      #   Some parameter documentations has been truncated, see
+      #   {PreludeSDK::Models::WatchSendFeedbacksParams} for more details.
+      #
+      #   @param feedbacks [Array<PreludeSDK::Models::WatchSendFeedbacksParams::Feedback>] A list of feedbacks to send. A maximum of 100 feedbacks can be sent in a single
       #
       #   @param request_options [PreludeSDK::RequestOptions, Hash{Symbol=>Object}]
 

data/lib/prelude_sdk/resources/notify.rb

@@ -156,8 +156,8 @@ module PreludeSDK
       # Some parameter documentations has been truncated, see
       # {PreludeSDK::Models::NotifySendParams} for more details.
       #
-      # Send transactional and marketing messages to your users via SMS and WhatsApp
-      # with automatic compliance enforcement.
+      # Send transactional and marketing messages to your users via SMS, RCS and
+      # WhatsApp with automatic compliance enforcement.
       #
       # @overload send_(template_id:, to:, callback_url: nil, correlation_id: nil, document: nil, expires_at: nil, from: nil, locale: nil, preferred_channel: nil, schedule_at: nil, variables: nil, request_options: {})
       #
@@ -169,7 +169,7 @@ module PreludeSDK
       #
       # @param correlation_id [String] A user-defined identifier to correlate this message with your internal systems.
       #
-      # @param document [PreludeSDK::Models::NotifySendParams::Document] A document to attach to the message. Only supported on WhatsApp templates that h
+      # @param document [PreludeSDK::Models::NotifySendParams::Document] A media attachment to include in the message header. Supported on
       #
       # @param expires_at [Time] The message expiration date in RFC3339 format. The message will not be sent if t
       #
@@ -214,7 +214,7 @@ module PreludeSDK
       #
       # @param correlation_id [String] A user-defined identifier to correlate this request with your internal systems.
       #
-      # @param document [PreludeSDK::Models::NotifySendBatchParams::Document] A document to attach to the message. Only supported on WhatsApp templates that h
+      # @param document [PreludeSDK::Models::NotifySendBatchParams::Document] A media attachment to include in the message header. Supported on
       #
       # @param expires_at [Time] The message expiration date in RFC3339 format. Messages will not be sent after t
       #

data/lib/prelude_sdk/resources/transactional.rb

@@ -22,7 +22,7 @@ module PreludeSDK
       #
       # @param correlation_id [String] A user-defined identifier to correlate this transactional message with. It is re
       #
-      # @param document [PreludeSDK::Models::TransactionalSendParams::Document] A document to attach to the message. Only supported on WhatsApp templates that h
+      # @param document [PreludeSDK::Models::TransactionalSendParams::Document] A media attachment to include in the message header. Supported on
       #
       # @param expires_at [String] The message expiration date.
       #