prelude-sdk 0.3.0 → 0.4.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 0442af375a6b077b348b680c39f073a48a66ff185d57f5f20ee53300531a8bf7
-  data.tar.gz: 60d8b444c65e5e55b487f61d158c9531fcb02435c66a1f9eaa3688640789d08f
+  metadata.gz: c30d57028d9ebcfd36fa8b9eec44cb27060d610dea0ad043a84d5d3ba03e63dd
+  data.tar.gz: 3704104bbb4293a7bef28aaa073376d8bd873f0b90ae8102c5e73194cd0259eb
 SHA512:
-  metadata.gz: 6c337ee4e3c9f6d13391ae942cda76beaef0ff292b14b5416f66450005908bfe09d250fad09444635eaabf1fb3e02eb3ad8d356740218a0a7188729487c65639
-  data.tar.gz: cb6ae9f844d4a6d5313e001802b40b0624e93da2cfdbbefaec0cfa68f2cd14f74a0397dd8ac51d338f52b24c478f350d19d9eb77a8cf4d17d12e9fe7778ffcea
+  metadata.gz: 56012d0287c7baa14666bc5a009ed125c3a40f442e2cdbf4a6c1e2fd65671212ec0cf947bffd9dfd90b5a64197d3525a1f79969f01d4f063e7f860f907b0b729
+  data.tar.gz: 497e10803825d58f550569fae77d4e02a20ff1a3a75480c31710513b41c58e19d8ce4d7979b497066f22385ca3c5cab537edd6a10d7b7d9e79ad619cf36d0a64

data/CHANGELOG.md

@@ -1,5 +1,38 @@
 # Changelog
 
+## 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.4.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

@@ -25,6 +25,13 @@ module PreludeSDK
       #   @return [String, nil]
       optional :callback_url, String
 
+      # @!attribute context
+      #   Context for replying to an inbound message. When provided, the message is sent
+      #   as a WhatsApp reply within the 24-hour conversation window.
+      #
+      #   @return [PreludeSDK::Models::NotifySendParams::Context, nil]
+      optional :context, -> { PreludeSDK::NotifySendParams::Context }
+
       # @!attribute correlation_id
       #   A user-defined identifier to correlate this message with your internal systems.
       #   It is returned in the response and any webhook events that refer to this
@@ -34,8 +41,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 }
@@ -77,13 +92,21 @@ module PreludeSDK
       #   @return [Time, nil]
       optional :schedule_at, Time
 
+      # @!attribute text
+      #   The reply message body. Required when `context.reply_to` is provided. Used for
+      #   2-way WhatsApp messaging to send free-form text replies within a conversation
+      #   window.
+      #
+      #   @return [String, nil]
+      optional :text, String
+
       # @!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, document: nil, expires_at: nil, from: nil, locale: nil, preferred_channel: nil, schedule_at: nil, variables: nil, request_options: {})
+      # @!method initialize(template_id:, to:, callback_url: nil, context: nil, correlation_id: nil, document: nil, expires_at: nil, from: nil, locale: nil, preferred_channel: nil, schedule_at: nil, text: nil, variables: nil, request_options: {})
       #   Some parameter documentations has been truncated, see
       #   {PreludeSDK::Models::NotifySendParams} for more details.
       #
@@ -93,9 +116,11 @@ module PreludeSDK
       #
       #   @param callback_url [String] The URL where webhooks will be sent for message delivery events.
       #
+      #   @param context [PreludeSDK::Models::NotifySendParams::Context] Context for replying to an inbound message. When provided, the message is sent a
+      #
       #   @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
       #
@@ -107,30 +132,64 @@ module PreludeSDK
       #
       #   @param schedule_at [Time] Schedule the message for future delivery in RFC3339 format. Marketing messages c
       #
+      #   @param text [String] The reply message body. Required when `context.reply_to` is provided. Used for 2
+      #
       #   @param variables [Hash{Symbol=>String}] The variables to be replaced in the template.
       #
       #   @param request_options [PreludeSDK::RequestOptions, Hash{Symbol=>Object}]
 
-      class Document < PreludeSDK::Internal::Type::BaseModel
-        # @!attribute filename
-        #   The filename to display for the document.
+      class Context < PreludeSDK::Internal::Type::BaseModel
+        # @!attribute reply_to
+        #   The inbound message ID (prefixed with `im_`) to reply to. This ID is provided in
+        #   the `inbound.message.received` webhook event.
         #
         #   @return [String]
-        required :filename, String
+        required :reply_to, String
 
+        # @!method initialize(reply_to:)
+        #   Some parameter documentations has been truncated, see
+        #   {PreludeSDK::Models::NotifySendParams::Context} for more details.
+        #
+        #   Context for replying to an inbound message. When provided, the message is sent
+        #   as a WhatsApp reply within the 24-hour conversation window.
+        #
+        #   @param reply_to [String] The inbound message ID (prefixed with `im_`) to reply to. This ID is provided in
+      end
+
+      class Document < PreludeSDK::Internal::Type::BaseModel
         # @!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 +198,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

@@ -69,13 +69,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" 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 +123,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.
@@ -198,6 +230,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}]