prelude-sdk 0.7.0 → 0.9.0

data/rbi/prelude_sdk/models/watch_send_events_params.rbi

@@ -74,14 +74,10 @@ module PreludeSDK
         attr_accessor :label
 
         # The event target. Only supports phone numbers for now.
-        sig { returns(PreludeSDK::WatchSendEventsParams::Event::Target) }
+        sig { returns(PreludeSDK::Target) }
         attr_reader :target
 
-        sig do
-          params(
-            target: PreludeSDK::WatchSendEventsParams::Event::Target::OrHash
-          ).void
-        end
+        sig { params(target: PreludeSDK::Target::OrHash).void }
         attr_writer :target
 
         sig do
@@ -89,7 +85,7 @@ module PreludeSDK
             confidence:
               PreludeSDK::WatchSendEventsParams::Event::Confidence::OrSymbol,
             label: String,
-            target: PreludeSDK::WatchSendEventsParams::Event::Target::OrHash
+            target: PreludeSDK::Target::OrHash
           ).returns(T.attached_class)
         end
         def self.new(
@@ -116,7 +112,7 @@ module PreludeSDK
               confidence:
                 PreludeSDK::WatchSendEventsParams::Event::Confidence::OrSymbol,
               label: String,
-              target: PreludeSDK::WatchSendEventsParams::Event::Target
+              target: PreludeSDK::Target
             }
           )
         end
@@ -180,91 +176,6 @@ module PreludeSDK
           def self.values
           end
         end
-
-        class Target < PreludeSDK::Internal::Type::BaseModel
-          OrHash =
-            T.type_alias do
-              T.any(
-                PreludeSDK::WatchSendEventsParams::Event::Target,
-                PreludeSDK::Internal::AnyHash
-              )
-            end
-
-          # The type of the target. Either "phone_number" or "email_address".
-          sig do
-            returns(
-              PreludeSDK::WatchSendEventsParams::Event::Target::Type::OrSymbol
-            )
-          end
-          attr_accessor :type
-
-          # An E.164 formatted phone number or an email address.
-          sig { returns(String) }
-          attr_accessor :value
-
-          # The event target. Only supports phone numbers for now.
-          sig do
-            params(
-              type:
-                PreludeSDK::WatchSendEventsParams::Event::Target::Type::OrSymbol,
-              value: String
-            ).returns(T.attached_class)
-          end
-          def self.new(
-            # The type of the target. Either "phone_number" or "email_address".
-            type:,
-            # An E.164 formatted phone number or an email address.
-            value:
-          )
-          end
-
-          sig do
-            override.returns(
-              {
-                type:
-                  PreludeSDK::WatchSendEventsParams::Event::Target::Type::OrSymbol,
-                value: String
-              }
-            )
-          end
-          def to_hash
-          end
-
-          # The type of the target. Either "phone_number" or "email_address".
-          module Type
-            extend PreludeSDK::Internal::Type::Enum
-
-            TaggedSymbol =
-              T.type_alias do
-                T.all(
-                  Symbol,
-                  PreludeSDK::WatchSendEventsParams::Event::Target::Type
-                )
-              end
-            OrSymbol = T.type_alias { T.any(Symbol, String) }
-
-            PHONE_NUMBER =
-              T.let(
-                :phone_number,
-                PreludeSDK::WatchSendEventsParams::Event::Target::Type::TaggedSymbol
-              )
-            EMAIL_ADDRESS =
-              T.let(
-                :email_address,
-                PreludeSDK::WatchSendEventsParams::Event::Target::Type::TaggedSymbol
-              )
-
-            sig do
-              override.returns(
-                T::Array[
-                  PreludeSDK::WatchSendEventsParams::Event::Target::Type::TaggedSymbol
-                ]
-              )
-            end
-            def self.values
-            end
-          end
-        end
       end
     end
   end

data/rbi/prelude_sdk/models/watch_send_feedbacks_params.rbi

@@ -55,15 +55,10 @@ module PreludeSDK
           end
 
         # The feedback target. Only supports phone numbers for now.
-        sig { returns(PreludeSDK::WatchSendFeedbacksParams::Feedback::Target) }
+        sig { returns(PreludeSDK::Target) }
         attr_reader :target
 
-        sig do
-          params(
-            target:
-              PreludeSDK::WatchSendFeedbacksParams::Feedback::Target::OrHash
-          ).void
-        end
+        sig { params(target: PreludeSDK::Target::OrHash).void }
         attr_writer :target
 
         # The type of feedback.
@@ -92,8 +87,7 @@ module PreludeSDK
 
         sig do
           params(
-            target:
-              PreludeSDK::WatchSendFeedbacksParams::Feedback::Target::OrHash,
+            target: PreludeSDK::Target::OrHash,
             type:
               PreludeSDK::WatchSendFeedbacksParams::Feedback::Type::OrSymbol,
             metadata:
@@ -113,7 +107,7 @@ module PreludeSDK
         sig do
           override.returns(
             {
-              target: PreludeSDK::WatchSendFeedbacksParams::Feedback::Target,
+              target: PreludeSDK::Target,
               type:
                 PreludeSDK::WatchSendFeedbacksParams::Feedback::Type::OrSymbol,
               metadata: PreludeSDK::WatchSendFeedbacksParams::Feedback::Metadata
@@ -123,91 +117,6 @@ module PreludeSDK
         def to_hash
         end
 
-        class Target < PreludeSDK::Internal::Type::BaseModel
-          OrHash =
-            T.type_alias do
-              T.any(
-                PreludeSDK::WatchSendFeedbacksParams::Feedback::Target,
-                PreludeSDK::Internal::AnyHash
-              )
-            end
-
-          # The type of the target. Either "phone_number" or "email_address".
-          sig do
-            returns(
-              PreludeSDK::WatchSendFeedbacksParams::Feedback::Target::Type::OrSymbol
-            )
-          end
-          attr_accessor :type
-
-          # An E.164 formatted phone number or an email address.
-          sig { returns(String) }
-          attr_accessor :value
-
-          # The feedback target. Only supports phone numbers for now.
-          sig do
-            params(
-              type:
-                PreludeSDK::WatchSendFeedbacksParams::Feedback::Target::Type::OrSymbol,
-              value: String
-            ).returns(T.attached_class)
-          end
-          def self.new(
-            # The type of the target. Either "phone_number" or "email_address".
-            type:,
-            # An E.164 formatted phone number or an email address.
-            value:
-          )
-          end
-
-          sig do
-            override.returns(
-              {
-                type:
-                  PreludeSDK::WatchSendFeedbacksParams::Feedback::Target::Type::OrSymbol,
-                value: String
-              }
-            )
-          end
-          def to_hash
-          end
-
-          # The type of the target. Either "phone_number" or "email_address".
-          module Type
-            extend PreludeSDK::Internal::Type::Enum
-
-            TaggedSymbol =
-              T.type_alias do
-                T.all(
-                  Symbol,
-                  PreludeSDK::WatchSendFeedbacksParams::Feedback::Target::Type
-                )
-              end
-            OrSymbol = T.type_alias { T.any(Symbol, String) }
-
-            PHONE_NUMBER =
-              T.let(
-                :phone_number,
-                PreludeSDK::WatchSendFeedbacksParams::Feedback::Target::Type::TaggedSymbol
-              )
-            EMAIL_ADDRESS =
-              T.let(
-                :email_address,
-                PreludeSDK::WatchSendFeedbacksParams::Feedback::Target::Type::TaggedSymbol
-              )
-
-            sig do
-              override.returns(
-                T::Array[
-                  PreludeSDK::WatchSendFeedbacksParams::Feedback::Target::Type::TaggedSymbol
-                ]
-              )
-            end
-            def self.values
-            end
-          end
-        end
-
         # The type of feedback.
         module Type
           extend PreludeSDK::Internal::Type::Enum

data/rbi/prelude_sdk/models.rbi

@@ -1,6 +1,8 @@
 # typed: strong
 
 module PreludeSDK
+  Intel = PreludeSDK::Models::Intel
+
   LookupLookupParams = PreludeSDK::Models::LookupLookupParams
 
   NotifyGetSubscriptionConfigParams =
@@ -18,16 +20,26 @@ module PreludeSDK
   NotifyListSubscriptionPhoneNumbersParams =
     PreludeSDK::Models::NotifyListSubscriptionPhoneNumbersParams
 
+  NotifyReplyParams = PreludeSDK::Models::NotifyReplyParams
+
   NotifySendBatchParams = PreludeSDK::Models::NotifySendBatchParams
 
   NotifySendParams = PreludeSDK::Models::NotifySendParams
 
+  Signals = PreludeSDK::Models::Signals
+
+  Target = PreludeSDK::Models::Target
+
   TransactionalSendParams = PreludeSDK::Models::TransactionalSendParams
 
+  Verification = PreludeSDK::Models::Verification
+
   VerificationCheckParams = PreludeSDK::Models::VerificationCheckParams
 
   VerificationCreateParams = PreludeSDK::Models::VerificationCreateParams
 
+  VerificationManagement = PreludeSDK::Models::VerificationManagement
+
   VerificationManagementDeletePhoneNumberParams =
     PreludeSDK::Models::VerificationManagementDeletePhoneNumberParams
 
@@ -43,6 +55,8 @@ module PreludeSDK
   VerificationManagementSubmitSenderIDParams =
     PreludeSDK::Models::VerificationManagementSubmitSenderIDParams
 
+  WatchEvaluateParams = PreludeSDK::Models::WatchEvaluateParams
+
   WatchPredictParams = PreludeSDK::Models::WatchPredictParams
 
   WatchSendEventsParams = PreludeSDK::Models::WatchSendEventsParams

data/rbi/prelude_sdk/resources/intel/kyc.rbi

@@ -0,0 +1,61 @@
+# typed: strong
+
+module PreludeSDK
+  module Resources
+    class Intel
+      # Retrieve detailed information about a phone number including carrier data, line
+      # type, and portability status.
+      class KYC
+        # Verify identity attributes against the subscriber record held by the end-user's
+        # mobile operator. Send a phone number along with the attributes to check; Prelude
+        # resolves the operator internally and returns a per-attribute match. Currently
+        # available for France only (Orange, SFR, Bouygues) and must be enabled for your
+        # account.
+        sig do
+          params(
+            phone: String,
+            address: String,
+            birthdate: Date,
+            country: String,
+            email: String,
+            family_name: String,
+            given_name: String,
+            locality: String,
+            postal_code: String,
+            region: String,
+            request_options: PreludeSDK::RequestOptions::OrHash
+          ).returns(PreludeSDK::Models::Intel::KYCMatchResponse)
+        end
+        def match(
+          # An E.164 formatted phone number whose subscriber identity to match against.
+          phone,
+          # The street address.
+          address: nil,
+          # The date of birth in ISO 8601 (`YYYY-MM-DD`) format. Compared exactly.
+          birthdate: nil,
+          # The ISO 3166-1 alpha-2 country code. Compared exactly.
+          country: nil,
+          # The email address.
+          email: nil,
+          # The end-user's family (last) name.
+          family_name: nil,
+          # The end-user's given (first) name.
+          given_name: nil,
+          # The locality (city).
+          locality: nil,
+          # The postal code. Compared exactly.
+          postal_code: nil,
+          # The region, state, or province.
+          region: nil,
+          request_options: {}
+        )
+        end
+
+        # @api private
+        sig { params(client: PreludeSDK::Client).returns(T.attached_class) }
+        def self.new(client:)
+        end
+      end
+    end
+  end
+end

data/rbi/prelude_sdk/resources/intel.rbi

@@ -0,0 +1,17 @@
+# typed: strong
+
+module PreludeSDK
+  module Resources
+    class Intel
+      # Retrieve detailed information about a phone number including carrier data, line
+      # type, and portability status.
+      sig { returns(PreludeSDK::Resources::Intel::KYC) }
+      attr_reader :kyc
+
+      # @api private
+      sig { params(client: PreludeSDK::Client).returns(T.attached_class) }
+      def self.new(client:)
+      end
+    end
+  end
+end

data/rbi/prelude_sdk/resources/notify.rbi

@@ -124,6 +124,37 @@ module PreludeSDK
       )
       end
 
+      # Send a free-form text reply to an inbound WhatsApp message within the 24-hour
+      # conversation window. See
+      # [WhatsApp 2-Way Messaging](/notify/v2/documentation/whatsapp) for details.
+      sig do
+        params(
+          reply_to: String,
+          text: String,
+          to: String,
+          callback_url: String,
+          correlation_id: String,
+          request_options: PreludeSDK::RequestOptions::OrHash
+        ).returns(PreludeSDK::Models::NotifyReplyResponse)
+      end
+      def reply(
+        # The inbound message ID (prefixed with `im_`) to reply to. This ID is provided in
+        # the `inbound.message.received` webhook event.
+        reply_to:,
+        # The reply message body sent as a free-form WhatsApp text.
+        text:,
+        # The recipient's phone number in E.164 format. Must match the phone number that
+        # sent the original inbound message.
+        to:,
+        # The URL where webhooks will be sent for delivery events of this reply.
+        callback_url: nil,
+        # A user-defined identifier to correlate this reply with your internal systems. It
+        # is returned in the response and any webhook events that refer to this message.
+        correlation_id: nil,
+        request_options: {}
+      )
+      end
+
       # Send transactional and marketing messages to your users via SMS, RCS and
       # WhatsApp with automatic compliance enforcement.
       sig do

data/rbi/prelude_sdk/resources/verification/phone/history.rbi

@@ -0,0 +1,112 @@
+# typed: strong
+
+module PreludeSDK
+  module Resources
+    class Verification
+      class Phone
+        # Verify phone numbers.
+        class History
+          # Retrieve everything Prelude recorded for one phone verification: its outcome and
+          # the device, network and anti-fraud context it was created in, the chronological
+          # timeline of every message attempt and code check, and the anti-fraud signals you
+          # forwarded.
+          #
+          # The identifier is the `id` returned by
+          # [Create or retry a verification](/verify/v2/api-reference/create-or-retry-a-verification)
+          # or the `verification_id` of the verification webhooks. Both `lifecycle` and
+          # `signals` are optional: a verification can resolve with its top-level fields
+          # alone.
+          sig do
+            params(
+              id: String,
+              request_options: PreludeSDK::RequestOptions::OrHash
+            ).returns(
+              PreludeSDK::Models::Verification::Phone::HistoryRetrieveResponse
+            )
+          end
+          def retrieve(
+            # The verification identifier.
+            id,
+            request_options: {}
+          )
+          end
+
+          # List your phone verifications, most recent first, one entry per verification
+          # with its outcome, channels, attempts and cost. Every filter is optional and they
+          # combine with AND.
+          #
+          # Use it to find every verification a phone number went through from your support
+          # tooling, then
+          # [Get a phone verification](/verify/v2/api-reference/history/get-a-phone-verification)
+          # for the full timeline of one of them. A cursor is bound to the filters that
+          # produced it: pass `next_cursor` back with the exact same query parameters.
+          sig do
+            params(
+              channels:
+                T::Array[
+                  PreludeSDK::Verification::Phone::HistoryListParams::Channel::OrSymbol
+                ],
+              cursor: String,
+              device_platform:
+                PreludeSDK::Verification::Phone::HistoryListParams::DevicePlatform::OrSymbol,
+              from: Time,
+              limit: Integer,
+              max_attempts: Integer,
+              min_attempts: Integer,
+              phone_number: String,
+              region: String,
+              status:
+                PreludeSDK::Verification::Phone::HistoryListParams::Status::OrSymbol,
+              template_id: String,
+              to: Time,
+              request_options: PreludeSDK::RequestOptions::OrHash
+            ).returns(
+              PreludeSDK::Models::Verification::Phone::HistoryListResponse
+            )
+          end
+          def list(
+            # Only verifications that could use one of these channels. Repeat the parameter
+            # for several values.
+            channels: nil,
+            # Pagination cursor from the previous response.
+            cursor: nil,
+            # Only verifications created from this device platform.
+            device_platform: nil,
+            # Only verifications created at or after this RFC 3339 timestamp. Goes with `to`,
+            # at most 6 months apart. Without them the whole history is searched.
+            from: nil,
+            # Maximum number of verifications to return per page.
+            limit: nil,
+            # Only verifications that sent at most this many messages. `0` keeps the
+            # verifications that never sent one.
+            max_attempts: nil,
+            # Only verifications that sent at least this many messages.
+            min_attempts: nil,
+            # Only verifications targeting this E.164 phone number. The leading `+` may be
+            # omitted.
+            phone_number: nil,
+            # Only verifications of phone numbers from this region, as an ISO 3166-1 alpha-2
+            # code.
+            region: nil,
+            # Only verifications in this status. `pending_check` cannot be filtered on.
+            status: nil,
+            # Only verifications sent with this template, as returned in `template_id` by
+            # [Get a phone verification](/verify/v2/api-reference/history/get-a-phone-verification).
+            # Built-in templates (`prelude:*`) cannot be filtered on.
+            template_id: nil,
+            # Only verifications created at or before this RFC 3339 timestamp. Goes with
+            # `from`.
+            to: nil,
+            request_options: {}
+          )
+          end
+
+          # @api private
+          sig { params(client: PreludeSDK::Client).returns(T.attached_class) }
+          def self.new(client:)
+          end
+        end
+      end
+    end
+  end
+end

data/rbi/prelude_sdk/resources/verification/phone.rbi

@@ -0,0 +1,18 @@
+# typed: strong
+
+module PreludeSDK
+  module Resources
+    class Verification
+      class Phone
+        # Verify phone numbers.
+        sig { returns(PreludeSDK::Resources::Verification::Phone::History) }
+        attr_reader :history
+
+        # @api private
+        sig { params(client: PreludeSDK::Client).returns(T.attached_class) }
+        def self.new(client:)
+        end
+      end
+    end
+  end
+end

data/rbi/prelude_sdk/resources/verification.rbi

@@ -4,16 +4,19 @@ module PreludeSDK
   module Resources
     # Verify phone numbers.
     class Verification
+      sig { returns(PreludeSDK::Resources::Verification::Phone) }
+      attr_reader :phone
+
       # Create a new verification for a specific phone number. If another non-expired
       # verification exists (the request is performed within the verification window),
       # this endpoint will perform a retry instead.
       sig do
         params(
-          target: PreludeSDK::VerificationCreateParams::Target::OrHash,
+          target: PreludeSDK::Target::OrHash,
           dispatch_id: String,
           metadata: PreludeSDK::VerificationCreateParams::Metadata::OrHash,
           options: PreludeSDK::VerificationCreateParams::Options::OrHash,
-          signals: PreludeSDK::VerificationCreateParams::Signals::OrHash,
+          signals: PreludeSDK::Signals::OrHash,
           request_options: PreludeSDK::RequestOptions::OrHash
         ).returns(PreludeSDK::Models::VerificationCreateResponse)
       end
@@ -39,7 +42,7 @@ module PreludeSDK
       sig do
         params(
           code: String,
-          target: PreludeSDK::VerificationCheckParams::Target::OrHash,
+          target: PreludeSDK::Target::OrHash,
           psd2: PreludeSDK::VerificationCheckParams::Psd2::OrHash,
           request_options: PreludeSDK::RequestOptions::OrHash
         ).returns(PreludeSDK::Models::VerificationCheckResponse)

data/rbi/prelude_sdk/resources/verification_management/sandbox.rbi

@@ -0,0 +1,76 @@
+# typed: strong
+
+module PreludeSDK
+  module Resources
+    class VerificationManagement
+      # Verify phone numbers.
+      class Sandbox
+        # Register a phone number as a sandbox number and associate it with a fixed
+        # attempt code. Subsequent verification attempts against this number will not
+        # trigger a real SMS/call and will validate against the configured attempt code.
+        #
+        # This operation is idempotent - re-adding the same phone number will overwrite
+        # the existing attempt code.
+        #
+        # In order to get access to this endpoint, contact our support team.
+        sig do
+          params(
+            attempt_code: String,
+            phone_number: String,
+            request_options: PreludeSDK::RequestOptions::OrHash
+          ).returns(
+            PreludeSDK::Models::VerificationManagement::SandboxAddPhoneNumberResponse
+          )
+        end
+        def add_phone_number(
+          # The fixed attempt code that will validate verification attempts for this phone
+          # number.
+          attempt_code:,
+          # An E.164 formatted phone number to add to the sandbox list.
+          phone_number:,
+          request_options: {}
+        )
+        end
+
+        # Remove a phone number from the sandbox list.
+        #
+        # This operation is idempotent - deleting a phone number that is not in the
+        # sandbox list will succeed without making any changes.
+        #
+        # In order to get access to this endpoint, contact our support team.
+        sig do
+          params(
+            phone_number: String,
+            request_options: PreludeSDK::RequestOptions::OrHash
+          ).returns(
+            PreludeSDK::Models::VerificationManagement::SandboxDeletePhoneNumberResponse
+          )
+        end
+        def delete_phone_number(
+          # The E.164 formatted phone number to remove from the sandbox list.
+          phone_number,
+          request_options: {}
+        )
+        end
+
+        # Retrieve the list of sandbox phone numbers for the account. Sandbox numbers are
+        # test numbers that bypass the real verification flow and return a fixed attempt
+        # code.
+        #
+        # In order to get access to this endpoint, contact our support team.
+        sig do
+          params(request_options: PreludeSDK::RequestOptions::OrHash).returns(
+            PreludeSDK::Models::VerificationManagement::SandboxListPhoneNumbersResponse
+          )
+        end
+        def list_phone_numbers(request_options: {})
+        end
+
+        # @api private
+        sig { params(client: PreludeSDK::Client).returns(T.attached_class) }
+        def self.new(client:)
+        end
+      end
+    end
+  end
+end

data/rbi/prelude_sdk/resources/verification_management.rbi

@@ -4,6 +4,10 @@ module PreludeSDK
   module Resources
     # Verify phone numbers.
     class VerificationManagement
+      # Verify phone numbers.
+      sig { returns(PreludeSDK::Resources::VerificationManagement::Sandbox) }
+      attr_reader :sandbox
+
       # Remove a phone number from the allow or block list.
       #
       # This operation is idempotent - re-deleting the same phone number will not result