prelude-sdk 0.2.0 → 0.3.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 20bf770b210bf23b3214f6dc77fd7e2f74a96869d52c7f96788a548a87c8afb0
-  data.tar.gz: fcb6a885d033659e8a2d8f7c91b97e04cf9df00ac8da6ad1392961f77f52c525
+  metadata.gz: 0442af375a6b077b348b680c39f073a48a66ff185d57f5f20ee53300531a8bf7
+  data.tar.gz: 60d8b444c65e5e55b487f61d158c9531fcb02435c66a1f9eaa3688640789d08f
 SHA512:
-  metadata.gz: 2797a1a23e09c4a7038ac2f06a86d491c1505c734d7fecaea592b7d0fc125818a1517cab2d1431229c3cf1634b8847c754e58b511c7d7968517f2095a3aa1536
-  data.tar.gz: 5bdad09b05d0f22ceba1f75fd9b3fbf7f045331729c288ae938b78de419a378382469347e1ea50ab7f6fcf044f3ffe120ff27136c995ea163bad08987991840c
+  metadata.gz: 6c337ee4e3c9f6d13391ae942cda76beaef0ff292b14b5416f66450005908bfe09d250fad09444635eaabf1fb3e02eb3ad8d356740218a0a7188729487c65639
+  data.tar.gz: cb6ae9f844d4a6d5313e001802b40b0624e93da2cfdbbefaec0cfa68f2cd14f74a0397dd8ac51d338f52b24c478f350d19d9eb77a8cf4d17d12e9fe7778ffcea

data/CHANGELOG.md

@@ -1,5 +1,53 @@
 # Changelog
 
+## 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)
+
+### Features
+
+* **api:** api update ([24553b3](https://github.com/prelude-so/ruby-sdk/commit/24553b346bf3e424aa565b58dfc0a5ff339d0ffd))
+* **api:** api update ([c8e488b](https://github.com/prelude-so/ruby-sdk/commit/c8e488bc5106f22fd3c3e1e996aa865bf51ff3a1))
+* **api:** api update ([bc9d8d4](https://github.com/prelude-so/ruby-sdk/commit/bc9d8d41c941879192c531c1b5f07d619d4bfc7b))
+* **api:** api update ([1e8ea21](https://github.com/prelude-so/ruby-sdk/commit/1e8ea213c96c039d76722d6bc522e84e0ff0278f))
+* **api:** api update ([c339306](https://github.com/prelude-so/ruby-sdk/commit/c3393069dc67ed5ecaecb276b26c2308a00356d1))
+* **api:** api update ([ec6ca20](https://github.com/prelude-so/ruby-sdk/commit/ec6ca2085c7628b495b9486bd46c27656432e9eb))
+* **api:** api update ([64ca50e](https://github.com/prelude-so/ruby-sdk/commit/64ca50eae743d655d253c2ab6564eade851b60be))
+* **api:** api update ([240811f](https://github.com/prelude-so/ruby-sdk/commit/240811ffbc8caabaad46ce164bdb9ac3c6cbf9b0))
+
+
+### Bug Fixes
+
+* calling `break` out of streams should be instantaneous ([a880e79](https://github.com/prelude-so/ruby-sdk/commit/a880e79694d57969c34395666edbd365d5a65483))
+* **client:** add types for path params, and update structure of unions nested in params ([dff25fc](https://github.com/prelude-so/ruby-sdk/commit/dff25fc4134005a9e8a7f84d8fc6fbd5f9ac8098))
+* **client:** always add content-length to post body, even when empty ([73b8b98](https://github.com/prelude-so/ruby-sdk/commit/73b8b98d2f14602fb5b297a697d3894699659b84))
+* **client:** loosen json header parsing ([144e10b](https://github.com/prelude-so/ruby-sdk/commit/144e10bb50679a7748df724edf574a86fc8fbc9e))
+* **client:** serialize query parameters properly ([e59d46e](https://github.com/prelude-so/ruby-sdk/commit/e59d46eaa39b1033807c4c000cfb4220b1c8d0ff))
+* issue where json.parse errors when receiving HTTP 204 with nobody ([5960180](https://github.com/prelude-so/ruby-sdk/commit/59601805484363ad564d640ae2dec6a2eff08f26))
+* properly mock time in ruby ci tests ([19a7259](https://github.com/prelude-so/ruby-sdk/commit/19a7259d6c21e24e6773487981154c17215846f0))
+
+
+### Chores
+
+* **ci:** add build step ([9517e54](https://github.com/prelude-so/ruby-sdk/commit/9517e54b4ad0cf6bfeefdb9c227217f5f732cf27))
+* **ci:** skip uploading artifacts on stainless-internal branches ([b239f23](https://github.com/prelude-so/ruby-sdk/commit/b239f237e3b67cc6a01f992028fc5885336f6538))
+* **docs:** add missing descriptions ([874587d](https://github.com/prelude-so/ruby-sdk/commit/874587d45083a9a5e0fc188b378a9b8d58dd39a5))
+* **docs:** remove www prefix ([9c41466](https://github.com/prelude-so/ruby-sdk/commit/9c41466d86710318107d52692f8efb93515e9738))
+* **internal:** codegen related update ([4721c32](https://github.com/prelude-so/ruby-sdk/commit/4721c32fbc82220da55e561f4ad10ac22223108b))
+* **internal:** codegen related update ([d227583](https://github.com/prelude-so/ruby-sdk/commit/d227583e5a4a92a1cbc4bd75ed70b18df8a2f0ff))
+* **internal:** tweak CI branches ([1a3bb89](https://github.com/prelude-so/ruby-sdk/commit/1a3bb8905066138aec8da0bba42d3f699da7144f))
+* **internal:** update `actions/checkout` version ([dd49de2](https://github.com/prelude-so/ruby-sdk/commit/dd49de2c037b0f622d7cdead21ab464a1455363f))
+* **internal:** update gitignore ([603a4c6](https://github.com/prelude-so/ruby-sdk/commit/603a4c69350448463dae3f8d99d6aa09d0c48b1b))
+* **test:** do not count install time for mock server timeout ([77b5e70](https://github.com/prelude-so/ruby-sdk/commit/77b5e70ec2a773c70e55ca4cb3e527e8d2446459))
+* **tests:** bump steady to v0.19.4 ([001f050](https://github.com/prelude-so/ruby-sdk/commit/001f050d338b3015dba4527bc278795fadb04ac2))
+* **tests:** bump steady to v0.19.5 ([e824cb0](https://github.com/prelude-so/ruby-sdk/commit/e824cb0c8e2f3f601a4e07f7c36afeafcfff9b28))
+* update mock server docs ([6fa353c](https://github.com/prelude-so/ruby-sdk/commit/6fa353cd9d0112786119b6a50d96fc48c77253c3))
+
+
+### Refactors
+
+* **tests:** switch from prism to steady ([4f1499f](https://github.com/prelude-so/ruby-sdk/commit/4f1499f85472caac00731960ba4a9623131c57f6))
+
 ## 0.2.0 (2025-12-05)
 
 Full Changelog: [v0.1.0...v0.2.0](https://github.com/prelude-so/ruby-sdk/compare/v0.1.0...v0.2.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.2.0"
+gem "prelude-sdk", "~> 0.3.0"
 ```
 
 <!-- x-release-please-end -->

data/lib/prelude_sdk/client.rb

@@ -19,21 +19,28 @@ module PreludeSDK
     # @return [String]
     attr_reader :api_token
 
+    # Retrieve detailed information about a phone number including carrier data, line
+    # type, and portability status.
     # @return [PreludeSDK::Resources::Lookup]
     attr_reader :lookup
 
+    # Send transactional and marketing messages with compliance enforcement.
     # @return [PreludeSDK::Resources::Notify]
     attr_reader :notify
 
+    # Send transactional messages (deprecated - use Notify API instead).
     # @return [PreludeSDK::Resources::Transactional]
     attr_reader :transactional
 
+    # Verify phone numbers.
     # @return [PreludeSDK::Resources::Verification]
     attr_reader :verification
 
+    # Verify phone numbers.
     # @return [PreludeSDK::Resources::VerificationManagement]
     attr_reader :verification_management
 
+    # Evaluate email addresses and phone numbers for trustworthiness.
     # @return [PreludeSDK::Resources::Watch]
     attr_reader :watch
 

data/lib/prelude_sdk/internal/transport/pooled_net_requester.rb

@@ -75,7 +75,7 @@ module PreludeSDK
 
             case body
             in nil
-              nil
+              req["content-length"] ||= 0 unless req["transfer-encoding"]
             in String
               req["content-length"] ||= body.bytesize.to_s unless req["transfer-encoding"]
               req.body_stream = PreludeSDK::Internal::Util::ReadIOAdapter.new(body, &blk)
@@ -153,17 +153,19 @@ module PreludeSDK
                   end
 
                   self.class.calibrate_socket_timeout(conn, deadline)
-                  conn.request(req) do |rsp|
-                    y << [req, rsp]
-                    break if finished
-
-                    rsp.read_body do |bytes|
-                      y << bytes.force_encoding(Encoding::BINARY)
-                      break if finished
-
-                      self.class.calibrate_socket_timeout(conn, deadline)
+                  ::Kernel.catch(:jump) do
+                    conn.request(req) do |rsp|
+                      y << [req, rsp]
+                      ::Kernel.throw(:jump) if finished
+
+                      rsp.read_body do |bytes|
+                        y << bytes.force_encoding(Encoding::BINARY)
+                        ::Kernel.throw(:jump) if finished
+
+                        self.class.calibrate_socket_timeout(conn, deadline)
+                      end
+                      eof = true
                     end
-                    eof = true
                   end
                 end
               ensure

data/lib/prelude_sdk/internal/util.rb

@@ -485,11 +485,42 @@ module PreludeSDK
       end
 
       # @type [Regexp]
-      JSON_CONTENT = %r{^application/(?:vnd(?:\.[^.]+)*\+)?json(?!l)}
+      JSON_CONTENT = %r{^application/(?:[a-zA-Z0-9.-]+\+)?json(?!l)}
       # @type [Regexp]
       JSONL_CONTENT = %r{^application/(:?x-(?:n|l)djson)|(:?(?:x-)?jsonl)}
 
       class << self
+        # @api private
+        #
+        # @param query [Hash{Symbol=>Object}]
+        #
+        # @return [Hash{Symbol=>Object}]
+        def encode_query_params(query)
+          out = {}
+          query.each { write_query_param_element!(out, _1, _2) }
+          out
+        end
+
+        # @api private
+        #
+        # @param collection [Hash{Symbol=>Object}]
+        # @param key [String]
+        # @param element [Object]
+        #
+        # @return [nil]
+        private def write_query_param_element!(collection, key, element)
+          case element
+          in Hash
+            element.each do |name, value|
+              write_query_param_element!(collection, "#{key}[#{name}]", value)
+            end
+          in Array
+            collection[key] = element.map(&:to_s).join(",")
+          else
+            collection[key] = element.to_s
+          end
+        end
+
         # @api private
         #
         # @param y [Enumerator::Yielder]
@@ -657,7 +688,8 @@ module PreludeSDK
         def decode_content(headers, stream:, suppress_error: false)
           case (content_type = headers["content-type"])
           in PreludeSDK::Internal::Util::JSON_CONTENT
-            json = stream.to_a.join
+            return nil if (json = stream.to_a.join).empty?
+
             begin
               JSON.parse(json, symbolize_names: true)
             rescue JSON::ParserError => e
@@ -667,7 +699,11 @@ module PreludeSDK
           in PreludeSDK::Internal::Util::JSONL_CONTENT
             lines = decode_lines(stream)
             chain_fused(lines) do |y|
-              lines.each { y << JSON.parse(_1, symbolize_names: true) }
+              lines.each do
+                next if _1.empty?
+
+                y << JSON.parse(_1, symbolize_names: true)
+              end
             end
           in %r{^text/event-stream}
             lines = decode_lines(stream)

data/lib/prelude_sdk/models/lookup_lookup_params.rb

@@ -7,6 +7,12 @@ module PreludeSDK
       extend PreludeSDK::Internal::Type::RequestParameters::Converter
       include PreludeSDK::Internal::Type::RequestParameters
 
+      # @!attribute phone_number
+      #   An E.164 formatted phone number to look up.
+      #
+      #   @return [String]
+      required :phone_number, String
+
       # @!attribute type
       #   Optional features. Possible values are:
       #
@@ -16,10 +22,12 @@ module PreludeSDK
       #   @return [Array<Symbol, PreludeSDK::Models::LookupLookupParams::Type>, nil]
       optional :type, -> { PreludeSDK::Internal::Type::ArrayOf[enum: PreludeSDK::LookupLookupParams::Type] }
 
-      # @!method initialize(type: nil, request_options: {})
+      # @!method initialize(phone_number:, type: nil, request_options: {})
       #   Some parameter documentations has been truncated, see
       #   {PreludeSDK::Models::LookupLookupParams} for more details.
       #
+      #   @param phone_number [String] An E.164 formatted phone number to look up.
+      #
       #   @param type [Array<Symbol, PreludeSDK::Models::LookupLookupParams::Type>] Optional features. Possible values are:
       #
       #   @param request_options [PreludeSDK::RequestOptions, Hash{Symbol=>Object}]

data/lib/prelude_sdk/models/notify_get_subscription_config_params.rb

@@ -7,7 +7,13 @@ module PreludeSDK
       extend PreludeSDK::Internal::Type::RequestParameters::Converter
       include PreludeSDK::Internal::Type::RequestParameters
 
-      # @!method initialize(request_options: {})
+      # @!attribute config_id
+      #
+      #   @return [String]
+      required :config_id, String
+
+      # @!method initialize(config_id:, request_options: {})
+      #   @param config_id [String]
       #   @param request_options [PreludeSDK::RequestOptions, Hash{Symbol=>Object}]
     end
   end

data/lib/prelude_sdk/models/notify_get_subscription_phone_number_params.rb

@@ -12,8 +12,14 @@ module PreludeSDK
       #   @return [String]
       required :config_id, String
 
-      # @!method initialize(config_id:, request_options: {})
+      # @!attribute phone_number
+      #
+      #   @return [String]
+      required :phone_number, String
+
+      # @!method initialize(config_id:, phone_number:, request_options: {})
       #   @param config_id [String]
+      #   @param phone_number [String]
       #   @param request_options [PreludeSDK::RequestOptions, Hash{Symbol=>Object}]
     end
   end

data/lib/prelude_sdk/models/notify_list_subscription_phone_number_events_params.rb

@@ -12,6 +12,11 @@ module PreludeSDK
       #   @return [String]
       required :config_id, String
 
+      # @!attribute phone_number
+      #
+      #   @return [String]
+      required :phone_number, String
+
       # @!attribute cursor
       #   Pagination cursor from the previous response
       #
@@ -24,9 +29,11 @@ module PreludeSDK
       #   @return [Integer, nil]
       optional :limit, Integer
 
-      # @!method initialize(config_id:, cursor: nil, limit: nil, request_options: {})
+      # @!method initialize(config_id:, phone_number:, cursor: nil, limit: nil, request_options: {})
       #   @param config_id [String]
       #
+      #   @param phone_number [String]
+      #
       #   @param cursor [String] Pagination cursor from the previous response
       #
       #   @param limit [Integer] Maximum number of events to return per page

data/lib/prelude_sdk/models/notify_list_subscription_phone_numbers_params.rb

@@ -7,6 +7,11 @@ module PreludeSDK
       extend PreludeSDK::Internal::Type::RequestParameters::Converter
       include PreludeSDK::Internal::Type::RequestParameters
 
+      # @!attribute config_id
+      #
+      #   @return [String]
+      required :config_id, String
+
       # @!attribute cursor
       #   Pagination cursor from the previous response
       #
@@ -25,7 +30,9 @@ module PreludeSDK
       #   @return [Symbol, PreludeSDK::Models::NotifyListSubscriptionPhoneNumbersParams::State, nil]
       optional :state, enum: -> { PreludeSDK::NotifyListSubscriptionPhoneNumbersParams::State }
 
-      # @!method initialize(cursor: nil, limit: nil, state: nil, request_options: {})
+      # @!method initialize(config_id:, cursor: nil, limit: nil, state: nil, request_options: {})
+      #   @param config_id [String]
+      #
       #   @param cursor [String] Pagination cursor from the previous response
       #
       #   @param limit [Integer] Maximum number of phone numbers to return per page

data/lib/prelude_sdk/models/notify_send_batch_params.rb

@@ -31,6 +31,13 @@ module PreludeSDK
       #   @return [String, nil]
       optional :correlation_id, String
 
+      # @!attribute document
+      #   A document to attach to the message. Only supported on WhatsApp templates that
+      #   have a document header.
+      #
+      #   @return [PreludeSDK::Models::NotifySendBatchParams::Document, nil]
+      optional :document, -> { PreludeSDK::NotifySendBatchParams::Document }
+
       # @!attribute expires_at
       #   The message expiration date in RFC3339 format. Messages will not be sent after
       #   this time.
@@ -69,7 +76,7 @@ module PreludeSDK
       #   @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, preferred_channel: nil, schedule_at: nil, variables: nil, request_options: {})
+      # @!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: {})
       #   Some parameter documentations has been truncated, see
       #   {PreludeSDK::Models::NotifySendBatchParams} for more details.
       #
@@ -81,6 +88,8 @@ 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 expires_at [Time] The message expiration date in RFC3339 format. Messages will not be sent after t
       #
       #   @param from [String] The Sender ID. Must be approved for your account.
@@ -95,6 +104,28 @@ 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.
+        #
+        #   @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.
+        #
+        #   @param filename [String] The filename to display for the document.
+        #
+        #   @param url [String] The URL of the document to attach. Must be a valid HTTP or HTTPS URL.
+      end
+
       # Preferred channel for delivery. If unavailable, automatic fallback applies.
       module PreferredChannel
         extend PreludeSDK::Internal::Type::Enum

data/lib/prelude_sdk/models/notify_send_batch_response.rb

@@ -146,6 +146,22 @@ module PreludeSDK
           #   @return [Time, nil]
           optional :created_at, Time
 
+          # @!attribute encoding
+          #   The SMS encoding type based on message content. GSM-7 supports standard
+          #   characters (up to 160 chars per segment), while UCS-2 supports Unicode including
+          #   emoji (up to 70 chars per segment). Only present for SMS messages.
+          #
+          #   @return [Symbol, PreludeSDK::Models::NotifySendBatchResponse::Result::Message::Encoding, nil]
+          optional :encoding, enum: -> { PreludeSDK::Models::NotifySendBatchResponse::Result::Message::Encoding }
+
+          # @!attribute estimated_segment_count
+          #   The estimated number of SMS segments for this message. This value is not
+          #   contractual; the actual segment count will be determined after the SMS is sent
+          #   by the provider. Only present for SMS messages.
+          #
+          #   @return [Integer, nil]
+          optional :estimated_segment_count, Integer
+
           # @!attribute expires_at
           #   The message expiration date in RFC3339 format.
           #
@@ -176,7 +192,10 @@ module PreludeSDK
           #   @return [String, nil]
           optional :to, String
 
-          # @!method initialize(id: nil, correlation_id: nil, created_at: nil, expires_at: nil, from: nil, locale: nil, schedule_at: nil, to: nil)
+          # @!method initialize(id: nil, correlation_id: nil, created_at: nil, encoding: nil, estimated_segment_count: nil, expires_at: nil, from: nil, locale: nil, schedule_at: nil, to: nil)
+          #   Some parameter documentations has been truncated, see
+          #   {PreludeSDK::Models::NotifySendBatchResponse::Result::Message} for more details.
+          #
           #   Present only if success is true.
           #
           #   @param id [String] The message identifier.
@@ -185,6 +204,10 @@ module PreludeSDK
           #
           #   @param created_at [Time] The message creation date in RFC3339 format.
           #
+          #   @param encoding [Symbol, PreludeSDK::Models::NotifySendBatchResponse::Result::Message::Encoding] The SMS encoding type based on message content. GSM-7 supports standard characte
+          #
+          #   @param estimated_segment_count [Integer] The estimated number of SMS segments for this message. This value is not contrac
+          #
           #   @param expires_at [Time] The message expiration date in RFC3339 format.
           #
           #   @param from [String] The Sender ID used for this message.
@@ -194,6 +217,21 @@ module PreludeSDK
           #   @param schedule_at [Time] When the message will actually be sent in RFC3339 format with timezone offset.
           #
           #   @param to [String] The recipient's phone number in E.164 format.
+
+          # The SMS encoding type based on message content. GSM-7 supports standard
+          # characters (up to 160 chars per segment), while UCS-2 supports Unicode including
+          # emoji (up to 70 chars per segment). Only present for SMS messages.
+          #
+          # @see PreludeSDK::Models::NotifySendBatchResponse::Result::Message#encoding
+          module Encoding
+            extend PreludeSDK::Internal::Type::Enum
+
+            GSM_7 = :"GSM-7"
+            UCS_2 = :"UCS-2"
+
+            # @!method self.values
+            #   @return [Array<Symbol>]
+          end
         end
       end
     end

data/lib/prelude_sdk/models/notify_send_params.rb

@@ -33,6 +33,13 @@ module PreludeSDK
       #   @return [String, nil]
       optional :correlation_id, String
 
+      # @!attribute document
+      #   A document to attach to the message. Only supported on WhatsApp templates that
+      #   have a document header.
+      #
+      #   @return [PreludeSDK::Models::NotifySendParams::Document, nil]
+      optional :document, -> { PreludeSDK::NotifySendParams::Document }
+
       # @!attribute expires_at
       #   The message expiration date in RFC3339 format. The message will not be sent if
       #   this time is reached.
@@ -76,7 +83,7 @@ module PreludeSDK
       #   @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, preferred_channel: nil, schedule_at: nil, variables: nil, request_options: {})
+      # @!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: {})
       #   Some parameter documentations has been truncated, see
       #   {PreludeSDK::Models::NotifySendParams} for more details.
       #
@@ -88,6 +95,8 @@ 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 expires_at [Time] The message expiration date in RFC3339 format. The message will not be sent if t
       #
       #   @param from [String] The Sender ID. Must be approved for your account.
@@ -102,6 +111,28 @@ 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.
+        #
+        #   @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.
+        #
+        #   @param filename [String] The filename to display for the document.
+        #
+        #   @param url [String] The URL of the document to attach. Must be a valid HTTP or HTTPS URL.
+      end
+
       # The preferred channel to be used in priority for message delivery. If the
       # channel is unavailable, the system will fallback to other available channels.
       module PreferredChannel

data/lib/prelude_sdk/models/notify_send_response.rb

@@ -52,6 +52,22 @@ module PreludeSDK
       #   @return [String, nil]
       optional :correlation_id, String
 
+      # @!attribute encoding
+      #   The SMS encoding type based on message content. GSM-7 supports standard
+      #   characters (up to 160 chars per segment), while UCS-2 supports Unicode including
+      #   emoji (up to 70 chars per segment). Only present for SMS messages.
+      #
+      #   @return [Symbol, PreludeSDK::Models::NotifySendResponse::Encoding, nil]
+      optional :encoding, enum: -> { PreludeSDK::Models::NotifySendResponse::Encoding }
+
+      # @!attribute estimated_segment_count
+      #   The estimated number of SMS segments for this message. This value is not
+      #   contractual; the actual segment count will be determined after the SMS is sent
+      #   by the provider. Only present for SMS messages.
+      #
+      #   @return [Integer, nil]
+      optional :estimated_segment_count, Integer
+
       # @!attribute from
       #   The Sender ID used for this message.
       #
@@ -66,7 +82,7 @@ module PreludeSDK
       #   @return [Time, nil]
       optional :schedule_at, Time
 
-      # @!method initialize(id:, created_at:, expires_at:, template_id:, to:, variables:, callback_url: nil, correlation_id: nil, from: nil, schedule_at: nil)
+      # @!method initialize(id:, created_at:, expires_at:, template_id:, to:, variables:, callback_url: nil, correlation_id: nil, encoding: nil, estimated_segment_count: nil, from: nil, schedule_at: nil)
       #   Some parameter documentations has been truncated, see
       #   {PreludeSDK::Models::NotifySendResponse} for more details.
       #
@@ -86,9 +102,28 @@ module PreludeSDK
       #
       #   @param correlation_id [String] A user-defined identifier to correlate this message with your internal systems.
       #
+      #   @param encoding [Symbol, PreludeSDK::Models::NotifySendResponse::Encoding] The SMS encoding type based on message content. GSM-7 supports standard characte
+      #
+      #   @param estimated_segment_count [Integer] The estimated number of SMS segments for this message. This value is not contrac
+      #
       #   @param from [String] The Sender ID used for this message.
       #
       #   @param schedule_at [Time] When the message will actually be sent in RFC3339 format with timezone offset. F
+
+      # The SMS encoding type based on message content. GSM-7 supports standard
+      # characters (up to 160 chars per segment), while UCS-2 supports Unicode including
+      # emoji (up to 70 chars per segment). Only present for SMS messages.
+      #
+      # @see PreludeSDK::Models::NotifySendResponse#encoding
+      module Encoding
+        extend PreludeSDK::Internal::Type::Enum
+
+        GSM_7 = :"GSM-7"
+        UCS_2 = :"UCS-2"
+
+        # @!method self.values
+        #   @return [Array<Symbol>]
+      end
     end
   end
 end

data/lib/prelude_sdk/models/transactional_send_params.rb

@@ -33,6 +33,13 @@ module PreludeSDK
       #   @return [String, nil]
       optional :correlation_id, String
 
+      # @!attribute document
+      #   A document to attach to the message. Only supported on WhatsApp templates that
+      #   have a document header.
+      #
+      #   @return [PreludeSDK::Models::TransactionalSendParams::Document, nil]
+      optional :document, -> { PreludeSDK::TransactionalSendParams::Document }
+
       # @!attribute expires_at
       #   The message expiration date.
       #
@@ -74,7 +81,7 @@ module PreludeSDK
       #   @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, preferred_channel: nil, variables: nil, request_options: {})
+      # @!method initialize(template_id:, to:, callback_url: nil, correlation_id: nil, document: 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.
       #
@@ -86,6 +93,8 @@ 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 expires_at [String] The message expiration date.
       #
       #   @param from [String] The Sender ID.
@@ -98,6 +107,28 @@ 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.
+        #
+        #   @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.
+        #
+        #   @param filename [String] The filename to display for the document.
+        #
+        #   @param url [String] The URL of the document to attach. Must be a valid HTTP or HTTPS URL.
+      end
+
       # 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.