prelude-sdk 0.2.0 → 0.4.0

data/lib/prelude_sdk/models/watch_predict_params.rb

@@ -105,8 +105,9 @@ module PreludeSDK
         optional :app_version, String
 
         # @!attribute device_id
-        #   The unique identifier for the user's device. For Android, this corresponds to
-        #   the `ANDROID_ID` and for iOS, this corresponds to the `identifierForVendor`.
+        #   A unique ID for the user's device. You should ensure that each user device has a
+        #   unique `device_id` value. Ideally, for Android, this corresponds to the
+        #   `ANDROID_ID` and for iOS, this corresponds to the `identifierForVendor`.
         #
         #   @return [String, nil]
         optional :device_id, String
@@ -124,23 +125,26 @@ module PreludeSDK
         optional :device_platform, enum: -> { PreludeSDK::WatchPredictParams::Signals::DevicePlatform }
 
         # @!attribute ip
-        #   The IP address of the user's device.
+        #   The public IP v4 or v6 address of the end-user's device. You should collect this
+        #   from your backend. If your backend is behind a proxy, use the `X-Forwarded-For`,
+        #   `Forwarded`, `True-Client-IP`, `CF-Connecting-IP` or an equivalent header to get
+        #   the actual public IP of the end-user's device.
         #
         #   @return [String, nil]
         optional :ip, String
 
         # @!attribute is_trusted_user
-        #   This signal should provide a higher level of trust, indicating that the user is
-        #   genuine. Contact us to discuss your use case. For more details, refer to
+        #   This signal should indicate a higher level of trust, explicitly stating that the
+        #   user is genuine. Contact us to discuss your use case. For more details, refer to
         #   [Signals](/verify/v2/documentation/prevent-fraud#signals).
         #
         #   @return [Boolean, nil]
         optional :is_trusted_user, PreludeSDK::Internal::Type::Boolean
 
         # @!attribute ja4_fingerprint
-        #   The JA4 fingerprint observed for the connection. Prelude will infer it
-        #   automatically when requests go through our client SDK (which uses Prelude's
-        #   edge), but you can also provide it explicitly if you terminate TLS yourself.
+        #   The JA4 fingerprint observed for the end-user's connection. Prelude will infer
+        #   it automatically when you use our Frontend SDKs (which use Prelude's edge
+        #   network), but you can also forward the value if you terminate TLS yourself.
         #
         #   @return [String, nil]
         optional :ja4_fingerprint, String
@@ -168,17 +172,17 @@ module PreludeSDK
         #
         #   @param app_version [String] The version of your application.
         #
-        #   @param device_id [String] The unique identifier for the user's device. For Android, this corresponds to th
+        #   @param device_id [String] A unique ID for the user's device. You should ensure that each user device has a
         #
         #   @param device_model [String] The model of the user's device.
         #
         #   @param device_platform [Symbol, PreludeSDK::Models::WatchPredictParams::Signals::DevicePlatform] The type of the user's device.
         #
-        #   @param ip [String] The IP address of the user's device.
+        #   @param ip [String] The public IP v4 or v6 address of the end-user's device. You should collect this
         #
-        #   @param is_trusted_user [Boolean] This signal should provide a higher level of trust, indicating that the user is
+        #   @param is_trusted_user [Boolean] This signal should indicate a higher level of trust, explicitly stating that the
         #
-        #   @param ja4_fingerprint [String] The JA4 fingerprint observed for the connection. Prelude will infer it automatic
+        #   @param ja4_fingerprint [String] The JA4 fingerprint observed for the end-user's connection. Prelude will infer i
         #
         #   @param os_version [String] The version of the user's device operating system.
         #

data/lib/prelude_sdk/models/watch_predict_response.rb

@@ -23,7 +23,37 @@ module PreludeSDK
       #   @return [String]
       required :request_id, String
 
-      # @!method initialize(id:, prediction:, request_id:)
+      # @!attribute risk_factors
+      #   The risk factors that contributed to the suspicious prediction. Only present
+      #   when prediction is "suspicious" 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::WatchPredictResponse::RiskFactor>, nil]
+      optional :risk_factors,
+               -> { PreludeSDK::Internal::Type::ArrayOf[enum: PreludeSDK::Models::WatchPredictResponse::RiskFactor] }
+
+      # @!method initialize(id:, prediction:, request_id:, risk_factors: nil)
       #   Some parameter documentations has been truncated, see
       #   {PreludeSDK::Models::WatchPredictResponse} for more details.
       #
@@ -32,6 +62,8 @@ module PreludeSDK
       #   @param prediction [Symbol, PreludeSDK::Models::WatchPredictResponse::Prediction] The prediction outcome.
       #
       #   @param request_id [String] A string that identifies this specific request. Report it back to us to help us
+      #
+      #   @param risk_factors [Array<Symbol, PreludeSDK::Models::WatchPredictResponse::RiskFactor>] The risk factors that contributed to the suspicious prediction. Only present whe
 
       # The prediction outcome.
       #
@@ -45,6 +77,24 @@ module PreludeSDK
         # @!method self.values
         #   @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
     end
   end
 end

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}]
 
@@ -32,38 +36,18 @@ module PreludeSDK
         #   @return [Symbol, PreludeSDK::Models::WatchSendFeedbacksParams::Feedback::Type]
         required :type, enum: -> { PreludeSDK::WatchSendFeedbacksParams::Feedback::Type }
 
-        # @!attribute dispatch_id
-        #   The identifier of the dispatch that came from the front-end SDK.
-        #
-        #   @return [String, nil]
-        optional :dispatch_id, String
-
         # @!attribute metadata
         #   The metadata for this feedback.
         #
         #   @return [PreludeSDK::Models::WatchSendFeedbacksParams::Feedback::Metadata, nil]
         optional :metadata, -> { PreludeSDK::WatchSendFeedbacksParams::Feedback::Metadata }
 
-        # @!attribute signals
-        #   The signals used for anti-fraud. For more details, refer to
-        #   [Signals](/verify/v2/documentation/prevent-fraud#signals).
-        #
-        #   @return [PreludeSDK::Models::WatchSendFeedbacksParams::Feedback::Signals, nil]
-        optional :signals, -> { PreludeSDK::WatchSendFeedbacksParams::Feedback::Signals }
-
-        # @!method initialize(target:, type:, dispatch_id: nil, metadata: nil, signals: nil)
-        #   Some parameter documentations has been truncated, see
-        #   {PreludeSDK::Models::WatchSendFeedbacksParams::Feedback} for more details.
-        #
+        # @!method initialize(target:, type:, metadata: nil)
         #   @param target [PreludeSDK::Models::WatchSendFeedbacksParams::Feedback::Target] The feedback target. Only supports phone numbers for now.
         #
         #   @param type [Symbol, PreludeSDK::Models::WatchSendFeedbacksParams::Feedback::Type] The type of feedback.
         #
-        #   @param dispatch_id [String] The identifier of the dispatch that came from the front-end SDK.
-        #
         #   @param metadata [PreludeSDK::Models::WatchSendFeedbacksParams::Feedback::Metadata] The metadata for this feedback.
-        #
-        #   @param signals [PreludeSDK::Models::WatchSendFeedbacksParams::Feedback::Signals] The signals used for anti-fraud. For more details, refer to [Signals](/verify/v2
 
         # @see PreludeSDK::Models::WatchSendFeedbacksParams::Feedback#target
         class Target < PreludeSDK::Internal::Type::BaseModel
@@ -131,113 +115,6 @@ module PreludeSDK
           #
           #   @param correlation_id [String] A user-defined identifier to correlate this feedback with. It is returned in the
         end
-
-        # @see PreludeSDK::Models::WatchSendFeedbacksParams::Feedback#signals
-        class Signals < PreludeSDK::Internal::Type::BaseModel
-          # @!attribute app_version
-          #   The version of your application.
-          #
-          #   @return [String, nil]
-          optional :app_version, String
-
-          # @!attribute device_id
-          #   The unique identifier for the user's device. For Android, this corresponds to
-          #   the `ANDROID_ID` and for iOS, this corresponds to the `identifierForVendor`.
-          #
-          #   @return [String, nil]
-          optional :device_id, String
-
-          # @!attribute device_model
-          #   The model of the user's device.
-          #
-          #   @return [String, nil]
-          optional :device_model, String
-
-          # @!attribute device_platform
-          #   The type of the user's device.
-          #
-          #   @return [Symbol, PreludeSDK::Models::WatchSendFeedbacksParams::Feedback::Signals::DevicePlatform, nil]
-          optional :device_platform,
-                   enum: -> { PreludeSDK::WatchSendFeedbacksParams::Feedback::Signals::DevicePlatform }
-
-          # @!attribute ip
-          #   The IP address of the user's device.
-          #
-          #   @return [String, nil]
-          optional :ip, String
-
-          # @!attribute is_trusted_user
-          #   This signal should provide a higher level of trust, indicating that the user is
-          #   genuine. Contact us to discuss your use case. For more details, refer to
-          #   [Signals](/verify/v2/documentation/prevent-fraud#signals).
-          #
-          #   @return [Boolean, nil]
-          optional :is_trusted_user, PreludeSDK::Internal::Type::Boolean
-
-          # @!attribute ja4_fingerprint
-          #   The JA4 fingerprint observed for the connection. Prelude will infer it
-          #   automatically when requests go through our client SDK (which uses Prelude's
-          #   edge), but you can also provide it explicitly if you terminate TLS yourself.
-          #
-          #   @return [String, nil]
-          optional :ja4_fingerprint, String
-
-          # @!attribute os_version
-          #   The version of the user's device operating system.
-          #
-          #   @return [String, nil]
-          optional :os_version, String
-
-          # @!attribute user_agent
-          #   The user agent of the user's device. If the individual fields (os_version,
-          #   device_platform, device_model) are provided, we will prioritize those values
-          #   instead of parsing them from the user agent string.
-          #
-          #   @return [String, nil]
-          optional :user_agent, String
-
-          # @!method initialize(app_version: nil, device_id: nil, device_model: nil, device_platform: nil, ip: nil, is_trusted_user: nil, ja4_fingerprint: nil, os_version: nil, user_agent: nil)
-          #   Some parameter documentations has been truncated, see
-          #   {PreludeSDK::Models::WatchSendFeedbacksParams::Feedback::Signals} for more
-          #   details.
-          #
-          #   The signals used for anti-fraud. For more details, refer to
-          #   [Signals](/verify/v2/documentation/prevent-fraud#signals).
-          #
-          #   @param app_version [String] The version of your application.
-          #
-          #   @param device_id [String] The unique identifier for the user's device. For Android, this corresponds to th
-          #
-          #   @param device_model [String] The model of the user's device.
-          #
-          #   @param device_platform [Symbol, PreludeSDK::Models::WatchSendFeedbacksParams::Feedback::Signals::DevicePlatform] The type of the user's device.
-          #
-          #   @param ip [String] The IP address of the user's device.
-          #
-          #   @param is_trusted_user [Boolean] This signal should provide a higher level of trust, indicating that the user is
-          #
-          #   @param ja4_fingerprint [String] The JA4 fingerprint observed for the connection. Prelude will infer it automatic
-          #
-          #   @param os_version [String] The version of the user's device operating system.
-          #
-          #   @param user_agent [String] The user agent of the user's device. If the individual fields (os_version, devic
-
-          # The type of the user's device.
-          #
-          # @see PreludeSDK::Models::WatchSendFeedbacksParams::Feedback::Signals#device_platform
-          module DevicePlatform
-            extend PreludeSDK::Internal::Type::Enum
-
-            ANDROID = :android
-            IOS = :ios
-            IPADOS = :ipados
-            TVOS = :tvos
-            WEB = :web
-
-            # @!method self.values
-            #   @return [Array<Symbol>]
-          end
-        end
       end
     end
   end

data/lib/prelude_sdk/resources/lookup.rb

@@ -2,6 +2,8 @@
 
 module PreludeSDK
   module Resources
+    # Retrieve detailed information about a phone number including carrier data, line
+    # type, and portability status.
     class Lookup
       # Some parameter documentations has been truncated, see
       # {PreludeSDK::Models::LookupLookupParams} for more details.
@@ -22,10 +24,11 @@ module PreludeSDK
       # @see PreludeSDK::Models::LookupLookupParams
       def lookup(phone_number, params = {})
         parsed, options = PreludeSDK::LookupLookupParams.dump_request(params)
+        query = PreludeSDK::Internal::Util.encode_query_params(parsed)
         @client.request(
           method: :get,
           path: ["v2/lookup/%1$s", phone_number],
-          query: parsed,
+          query: query,
           model: PreludeSDK::Models::LookupLookupResponse,
           options: options
         )

data/lib/prelude_sdk/resources/notify.rb

@@ -2,6 +2,7 @@
 
 module PreludeSDK
   module Resources
+    # Send transactional and marketing messages with compliance enforcement.
     class Notify
       # Retrieve a specific subscription management configuration by its ID.
       #
@@ -70,10 +71,11 @@ module PreludeSDK
       # @see PreludeSDK::Models::NotifyListSubscriptionConfigsParams
       def list_subscription_configs(params = {})
         parsed, options = PreludeSDK::NotifyListSubscriptionConfigsParams.dump_request(params)
+        query = PreludeSDK::Internal::Util.encode_query_params(parsed)
         @client.request(
           method: :get,
           path: "v2/notify/management/subscriptions",
-          query: parsed,
+          query: query,
           model: PreludeSDK::Models::NotifyListSubscriptionConfigsResponse,
           options: options
         )
@@ -101,6 +103,7 @@ module PreludeSDK
       # @see PreludeSDK::Models::NotifyListSubscriptionPhoneNumberEventsParams
       def list_subscription_phone_number_events(phone_number, params)
         parsed, options = PreludeSDK::NotifyListSubscriptionPhoneNumberEventsParams.dump_request(params)
+        query = PreludeSDK::Internal::Util.encode_query_params(parsed)
         config_id =
           parsed.delete(:config_id) do
             raise ArgumentError.new("missing required path argument #{_1}")
@@ -112,7 +115,7 @@ module PreludeSDK
             config_id,
             phone_number
           ],
-          query: parsed,
+          query: query,
           model: PreludeSDK::Models::NotifyListSubscriptionPhoneNumberEventsResponse,
           options: options
         )
@@ -140,10 +143,11 @@ module PreludeSDK
       # @see PreludeSDK::Models::NotifyListSubscriptionPhoneNumbersParams
       def list_subscription_phone_numbers(config_id, params = {})
         parsed, options = PreludeSDK::NotifyListSubscriptionPhoneNumbersParams.dump_request(params)
+        query = PreludeSDK::Internal::Util.encode_query_params(parsed)
         @client.request(
           method: :get,
           path: ["v2/notify/management/subscriptions/%1$s/phone_numbers", config_id],
-          query: parsed,
+          query: query,
           model: PreludeSDK::Models::NotifyListSubscriptionPhoneNumbersResponse,
           options: options
         )
@@ -152,10 +156,10 @@ 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, expires_at: nil, from: nil, locale: nil, preferred_channel: nil, schedule_at: nil, variables: nil, request_options: {})
+      # @overload send_(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: {})
       #
       # @param template_id [String] The template identifier configured by your Customer Success team.
       #
@@ -163,8 +167,12 @@ 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 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
       #
       # @param from [String] The Sender ID. Must be approved for your account.
@@ -175,6 +183,8 @@ 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}, nil]
@@ -198,7 +208,7 @@ module PreludeSDK
       #
       # Send the same message to multiple recipients in a single request.
       #
-      # @overload send_batch(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: {})
+      # @overload send_batch(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: {})
       #
       # @param template_id [String] The template identifier configured by your Customer Success team.
       #
@@ -208,6 +218,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 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
       #
       # @param from [String] The Sender ID. Must be approved for your account.

data/lib/prelude_sdk/resources/transactional.rb

@@ -2,6 +2,7 @@
 
 module PreludeSDK
   module Resources
+    # Send transactional messages (deprecated - use Notify API instead).
     class Transactional
       # @deprecated
       #
@@ -11,7 +12,7 @@ module PreludeSDK
       # Legacy route maintained for backward compatibility. Migrate to `/v2/notify`
       # instead.
       #
-      # @overload send_(template_id:, to:, callback_url: nil, correlation_id: nil, expires_at: nil, from: nil, locale: nil, preferred_channel: nil, variables: nil, request_options: {})
+      # @overload send_(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: {})
       #
       # @param template_id [String] The template identifier.
       #
@@ -21,6 +22,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 media attachment to include in the message header. Supported on
+      #
       # @param expires_at [String] The message expiration date.
       #
       # @param from [String] The Sender ID.

data/lib/prelude_sdk/resources/verification.rb

@@ -2,6 +2,7 @@
 
 module PreludeSDK
   module Resources
+    # Verify phone numbers.
     class Verification
       # Some parameter documentations has been truncated, see
       # {PreludeSDK::Models::VerificationCreateParams} for more details.

data/lib/prelude_sdk/resources/verification_management.rb

@@ -2,6 +2,7 @@
 
 module PreludeSDK
   module Resources
+    # Verify phone numbers.
     class VerificationManagement
       # Remove a phone number from the allow or block list.
       #

data/lib/prelude_sdk/resources/watch.rb

@@ -2,6 +2,7 @@
 
 module PreludeSDK
   module Resources
+    # Evaluate email addresses and phone numbers for trustworthiness.
     class Watch
       # Some parameter documentations has been truncated, see
       # {PreludeSDK::Models::WatchPredictParams} for more details.
@@ -34,12 +35,15 @@ module PreludeSDK
         )
       end
 
+      # Some parameter documentations has been truncated, see
+      # {PreludeSDK::Models::WatchSendEventsParams} for more details.
+      #
       # Send real-time event data from end-user interactions within your application.
       # Events will be analyzed for proactive fraud prevention and risk scoring.
       #
       # @overload send_events(events:, request_options: {})
       #
-      # @param events [Array<PreludeSDK::Models::WatchSendEventsParams::Event>] A list of events to dispatch.
+      # @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}, nil]
       #
@@ -57,12 +61,15 @@ module PreludeSDK
         )
       end
 
+      # Some parameter documentations has been truncated, see
+      # {PreludeSDK::Models::WatchSendFeedbacksParams} for more details.
+      #
       # Send feedback regarding your end-users verification funnel. Events will be
       # analyzed for proactive fraud prevention and risk scoring.
       #
       # @overload send_feedbacks(feedbacks:, request_options: {})
       #
-      # @param feedbacks [Array<PreludeSDK::Models::WatchSendFeedbacksParams::Feedback>] A list of feedbacks to send.
+      # @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}, nil]
       #

data/lib/prelude_sdk/version.rb

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

data/rbi/prelude_sdk/client.rbi

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

data/rbi/prelude_sdk/internal/util.rbi

@@ -148,12 +148,20 @@ module PreludeSDK
         end
       end
 
+      # https://www.rfc-editor.org/rfc/rfc3986.html#section-3.3
+      RFC_3986_NOT_PCHARS = T.let(/[^A-Za-z0-9\-._~!$&'()*+,;=:@]+/, Regexp)
+
       class << self
         # @api private
         sig { params(uri: URI::Generic).returns(String) }
         def uri_origin(uri)
         end
 
+        # @api private
+        sig { params(path: T.any(String, Integer)).returns(String) }
+        def encode_path(path)
+        end
+
         # @api private
         sig { params(path: T.any(String, T::Array[String])).returns(String) }
         def interpolate_path(path)
@@ -296,11 +304,31 @@ module PreludeSDK
       end
 
       JSON_CONTENT =
-        T.let(%r{^application/(?:vnd(?:\.[^.]+)*\+)?json(?!l)}, Regexp)
+        T.let(%r{^application/(?:[a-zA-Z0-9.-]+\+)?json(?!l)}, Regexp)
       JSONL_CONTENT =
         T.let(%r{^application/(:?x-(?:n|l)djson)|(:?(?:x-)?jsonl)}, Regexp)
 
       class << self
+        # @api private
+        sig do
+          params(query: PreludeSDK::Internal::AnyHash).returns(
+            PreludeSDK::Internal::AnyHash
+          )
+        end
+        def encode_query_params(query)
+        end
+
+        # @api private
+        sig do
+          params(
+            collection: PreludeSDK::Internal::AnyHash,
+            key: String,
+            element: T.anything
+          ).void
+        end
+        private def write_query_param_element!(collection, key, element)
+        end
+
         # @api private
         sig do
           params(