zavudev 0.14.0 → 0.16.0

data/rbi/zavudev/resources/invitations.rbi

@@ -3,15 +3,26 @@
 module Zavudev
   module Resources
     class Invitations
-      # Create a partner invitation link for a client to connect their WhatsApp Business
-      # account. The client will complete Meta's embedded signup flow and the resulting
-      # sender will be created in your project.
+      # Create a partner invitation link for a client to connect WhatsApp. The client
+      # opens the returned `url` and connects. Set `connectionType` to choose how they
+      # connect:
+      #
+      # - `whatsapp_waba` (default): the client completes Meta's embedded signup,
+      #   linking an official WhatsApp Business Account.
+      # - `whatsapp_alt`: the client links their number by scanning a QR code. Requires
+      #   the WhatsApp Alternative feature to be enabled for your team (otherwise
+      #   returns 400).
+      #
+      # Either way, the resulting sender is created in your project when the client
+      # completes the flow, and the invitation transitions to `completed`.
       sig do
         params(
           allowed_phone_countries: T::Array[String],
           client_email: String,
           client_name: String,
           client_phone: String,
+          connection_type:
+            Zavudev::InvitationCreateParams::ConnectionType::OrSymbol,
           expires_in_days: Integer,
           phone_number_id: String,
           request_options: Zavudev::RequestOptions::OrHash
@@ -26,6 +37,11 @@ module Zavudev
         client_name: nil,
         # Phone number of the client in E.164 format.
         client_phone: nil,
+        # How the client connects WhatsApp. `whatsapp_waba` (default) runs Meta's embedded
+        # signup to link an official WhatsApp Business Account. `whatsapp_alt` links the
+        # number by scanning a QR code — available only to teams with the WhatsApp
+        # Alternative feature enabled.
+        connection_type: nil,
         # Number of days until the invitation expires.
         expires_in_days: nil,
         # ID of a Zavu phone number to pre-assign for WhatsApp registration. If provided,

data/rbi/zavudev/resources/messages.rbi

@@ -16,19 +16,20 @@ module Zavudev
       # List messages previously sent by this project.
       sig do
         params(
-          channel: Zavudev::Channel::OrSymbol,
+          channel: Zavudev::MessageListParams::Channel::OrSymbol,
           cursor: String,
           limit: Integer,
-          status: Zavudev::MessageStatus::OrSymbol,
+          status: Zavudev::MessageListParams::Status::OrSymbol,
           to: String,
           request_options: Zavudev::RequestOptions::OrHash
         ).returns(Zavudev::Internal::Cursor[Zavudev::Message])
       end
       def list(
-        # Delivery channel. Use 'auto' for intelligent routing.
+        # Filter by delivery channel.
         channel: nil,
         cursor: nil,
         limit: nil,
+        # Filter by status. Not all stored statuses are filterable.
         status: nil,
         to: nil,
         request_options: {}
@@ -94,8 +95,11 @@ module Zavudev
         ).returns(Zavudev::MessageResponse)
       end
       def send_(
-        # Body param: Recipient phone number in E.164 format, email address, or numeric
-        # chat ID (for Telegram/Instagram/Messenger).
+        # Body param: Recipient phone number in E.164 format, email address, WhatsApp
+        # business-scoped user ID (BSUID, e.g. `US.13491208655302741918`), or numeric chat
+        # ID (for Telegram/Instagram/Messenger). A BSUID is routed to WhatsApp and sent
+        # via the `recipient` field; use it to message a contact who adopted a username
+        # and whose phone number is hidden.
         to:,
         # Body param: Email attachments. Only supported when channel is 'email'. Maximum
         # 40MB total size.

data/rbi/zavudev/resources/plan.rbi

@@ -3,16 +3,6 @@
 module Zavudev
   module Resources
     class Plan
-      # Get the current subscription plan for the API key's team, including tier,
-      # billing interval, and period dates.
-      sig do
-        params(request_options: Zavudev::RequestOptions::OrHash).returns(
-          Zavudev::Models::PlanRetrieveResponse
-        )
-      end
-      def retrieve(request_options: {})
-      end
-
       # @api private
       sig { params(client: Zavudev::Client).returns(T.attached_class) }
       def self.new(client:)

data/rbi/zavudev/resources/usage.rbi

@@ -3,16 +3,6 @@
 module Zavudev
   module Resources
     class Usage
-      # Get the current month's usage counters for A2P messages and emails, along with
-      # the tier limits.
-      sig do
-        params(request_options: Zavudev::RequestOptions::OrHash).returns(
-          Zavudev::Models::UsageRetrieveResponse
-        )
-      end
-      def retrieve(request_options: {})
-      end
-
       # @api private
       sig { params(client: Zavudev::Client).returns(T.attached_class) }
       def self.new(client:)

data/sig/zavudev/models/broadcast_channel.rbs

@@ -1,15 +1,7 @@
 module Zavudev
   module Models
     type broadcast_channel =
-      :smart
-      | :sms
-      | :sms_oneway
-      | :whatsapp
-      | :telegram
-      | :email
-      | :instagram
-      | :messenger
-      | :voice
+      :smart | :sms | :sms_oneway | :whatsapp | :telegram | :email
 
     module BroadcastChannel
       extend Zavudev::Internal::Type::Enum
@@ -20,9 +12,6 @@ module Zavudev
       WHATSAPP: :whatsapp
       TELEGRAM: :telegram
       EMAIL: :email
-      INSTAGRAM: :instagram
-      MESSENGER: :messenger
-      VOICE: :voice
 
       def self?.values: -> ::Array[Zavudev::Models::broadcast_channel]
     end

data/sig/zavudev/models/channel.rbs

@@ -5,6 +5,7 @@ module Zavudev
       | :sms
       | :sms_oneway
       | :whatsapp
+      | :whatsapp_alt
       | :telegram
       | :email
       | :instagram
@@ -18,6 +19,7 @@ module Zavudev
       SMS: :sms
       SMS_ONEWAY: :sms_oneway
       WHATSAPP: :whatsapp
+      WHATSAPP_ALT: :whatsapp_alt
       TELEGRAM: :telegram
       EMAIL: :email
       INSTAGRAM: :instagram

data/sig/zavudev/models/contact_channel.rbs

@@ -85,7 +85,8 @@ module Zavudev
         updated_at: Time
       }
 
-      type channel = :sms | :whatsapp | :email | :telegram | :messenger | :voice
+      type channel =
+        :sms | :whatsapp | :email | :telegram | :instagram | :messenger | :voice
 
       module Channel
         extend Zavudev::Internal::Type::Enum
@@ -94,6 +95,7 @@ module Zavudev
         WHATSAPP: :whatsapp
         EMAIL: :email
         TELEGRAM: :telegram
+        INSTAGRAM: :instagram
         MESSENGER: :messenger
         VOICE: :voice
 

data/sig/zavudev/models/contact_create_params.rbs

@@ -79,7 +79,13 @@ module Zavudev
         }
 
         type channel =
-          :sms | :whatsapp | :email | :telegram | :messenger | :voice
+          :sms
+          | :whatsapp
+          | :email
+          | :telegram
+          | :instagram
+          | :messenger
+          | :voice
 
         module Channel
           extend Zavudev::Internal::Type::Enum
@@ -88,6 +94,7 @@ module Zavudev
           WHATSAPP: :whatsapp
           EMAIL: :email
           TELEGRAM: :telegram
+          INSTAGRAM: :instagram
           MESSENGER: :messenger
           VOICE: :voice
 

data/sig/zavudev/models/contacts/channel_add_params.rbs

@@ -55,7 +55,13 @@ module Zavudev
         }
 
         type channel =
-          :sms | :whatsapp | :email | :telegram | :messenger | :voice
+          :sms
+          | :whatsapp
+          | :email
+          | :telegram
+          | :instagram
+          | :messenger
+          | :voice
 
         module Channel
           extend Zavudev::Internal::Type::Enum
@@ -64,6 +70,7 @@ module Zavudev
           WHATSAPP: :whatsapp
           EMAIL: :email
           TELEGRAM: :telegram
+          INSTAGRAM: :instagram
           MESSENGER: :messenger
           VOICE: :voice
 

data/sig/zavudev/models/invitation.rbs

@@ -13,6 +13,7 @@ module Zavudev
         client_name: String?,
         client_phone: String?,
         completed_at: Time?,
+        connection_type: Zavudev::Models::Invitation::connection_type,
         phone_number_id: String?,
         sender_id: String?,
         started_at: Time?,
@@ -42,6 +43,12 @@ module Zavudev
 
       attr_accessor completed_at: Time?
 
+      attr_reader connection_type: Zavudev::Models::Invitation::connection_type?
+
+      def connection_type=: (
+        Zavudev::Models::Invitation::connection_type
+      ) -> Zavudev::Models::Invitation::connection_type
+
       attr_accessor phone_number_id: String?
 
       attr_accessor sender_id: String?
@@ -62,6 +69,7 @@ module Zavudev
         ?client_name: String?,
         ?client_phone: String?,
         ?completed_at: Time?,
+        ?connection_type: Zavudev::Models::Invitation::connection_type,
         ?phone_number_id: String?,
         ?sender_id: String?,
         ?started_at: Time?,
@@ -80,6 +88,7 @@ module Zavudev
         client_name: String?,
         client_phone: String?,
         completed_at: Time?,
+        connection_type: Zavudev::Models::Invitation::connection_type,
         phone_number_id: String?,
         sender_id: String?,
         started_at: Time?,
@@ -99,6 +108,17 @@ module Zavudev
 
         def self?.values: -> ::Array[Zavudev::Models::Invitation::status]
       end
+
+      type connection_type = :whatsapp_waba | :whatsapp_alt
+
+      module ConnectionType
+        extend Zavudev::Internal::Type::Enum
+
+        WHATSAPP_WABA: :whatsapp_waba
+        WHATSAPP_ALT: :whatsapp_alt
+
+        def self?.values: -> ::Array[Zavudev::Models::Invitation::connection_type]
+      end
     end
   end
 end

data/sig/zavudev/models/invitation_create_params.rbs

@@ -6,6 +6,7 @@ module Zavudev
         client_email: String,
         client_name: String,
         client_phone: String,
+        connection_type: Zavudev::Models::InvitationCreateParams::connection_type,
         expires_in_days: Integer,
         phone_number_id: String
       }
@@ -31,6 +32,12 @@ module Zavudev
 
       def client_phone=: (String) -> String
 
+      attr_reader connection_type: Zavudev::Models::InvitationCreateParams::connection_type?
+
+      def connection_type=: (
+        Zavudev::Models::InvitationCreateParams::connection_type
+      ) -> Zavudev::Models::InvitationCreateParams::connection_type
+
       attr_reader expires_in_days: Integer?
 
       def expires_in_days=: (Integer) -> Integer
@@ -44,6 +51,7 @@ module Zavudev
         ?client_email: String,
         ?client_name: String,
         ?client_phone: String,
+        ?connection_type: Zavudev::Models::InvitationCreateParams::connection_type,
         ?expires_in_days: Integer,
         ?phone_number_id: String,
         ?request_options: Zavudev::request_opts
@@ -54,10 +62,22 @@ module Zavudev
         client_email: String,
         client_name: String,
         client_phone: String,
+        connection_type: Zavudev::Models::InvitationCreateParams::connection_type,
         expires_in_days: Integer,
         phone_number_id: String,
         request_options: Zavudev::RequestOptions
       }
+
+      type connection_type = :whatsapp_waba | :whatsapp_alt
+
+      module ConnectionType
+        extend Zavudev::Internal::Type::Enum
+
+        WHATSAPP_WABA: :whatsapp_waba
+        WHATSAPP_ALT: :whatsapp_alt
+
+        def self?.values: -> ::Array[Zavudev::Models::InvitationCreateParams::connection_type]
+      end
     end
   end
 end

data/sig/zavudev/models/message_list_params.rbs

@@ -2,10 +2,10 @@ module Zavudev
   module Models
     type message_list_params =
       {
-        channel: Zavudev::Models::channel,
+        channel: Zavudev::Models::MessageListParams::channel,
         cursor: String,
         limit: Integer,
-        status: Zavudev::Models::message_status,
+        status: Zavudev::Models::MessageListParams::status,
         to: String
       }
       & Zavudev::Internal::Type::request_parameters
@@ -14,9 +14,11 @@ module Zavudev
       extend Zavudev::Internal::Type::RequestParameters::Converter
       include Zavudev::Internal::Type::RequestParameters
 
-      attr_reader channel: Zavudev::Models::channel?
+      attr_reader channel: Zavudev::Models::MessageListParams::channel?
 
-      def channel=: (Zavudev::Models::channel) -> Zavudev::Models::channel
+      def channel=: (
+        Zavudev::Models::MessageListParams::channel
+      ) -> Zavudev::Models::MessageListParams::channel
 
       attr_reader cursor: String?
 
@@ -26,33 +28,74 @@ module Zavudev
 
       def limit=: (Integer) -> Integer
 
-      attr_reader status: Zavudev::Models::message_status?
+      attr_reader status: Zavudev::Models::MessageListParams::status?
 
       def status=: (
-        Zavudev::Models::message_status
-      ) -> Zavudev::Models::message_status
+        Zavudev::Models::MessageListParams::status
+      ) -> Zavudev::Models::MessageListParams::status
 
       attr_reader to: String?
 
       def to=: (String) -> String
 
       def initialize: (
-        ?channel: Zavudev::Models::channel,
+        ?channel: Zavudev::Models::MessageListParams::channel,
         ?cursor: String,
         ?limit: Integer,
-        ?status: Zavudev::Models::message_status,
+        ?status: Zavudev::Models::MessageListParams::status,
         ?to: String,
         ?request_options: Zavudev::request_opts
       ) -> void
 
       def to_hash: -> {
-        channel: Zavudev::Models::channel,
+        channel: Zavudev::Models::MessageListParams::channel,
         cursor: String,
         limit: Integer,
-        status: Zavudev::Models::message_status,
+        status: Zavudev::Models::MessageListParams::status,
         to: String,
         request_options: Zavudev::RequestOptions
       }
+
+      type channel =
+        :sms
+        | :sms_oneway
+        | :whatsapp
+        | :email
+        | :telegram
+        | :instagram
+        | :messenger
+        | :voice
+
+      module Channel
+        extend Zavudev::Internal::Type::Enum
+
+        SMS: :sms
+        SMS_ONEWAY: :sms_oneway
+        WHATSAPP: :whatsapp
+        EMAIL: :email
+        TELEGRAM: :telegram
+        INSTAGRAM: :instagram
+        MESSENGER: :messenger
+        VOICE: :voice
+
+        def self?.values: -> ::Array[Zavudev::Models::MessageListParams::channel]
+      end
+
+      type status =
+        :queued | :sending | :sent | :delivered | :failed | :received
+
+      module Status
+        extend Zavudev::Internal::Type::Enum
+
+        QUEUED: :queued
+        SENDING: :sending
+        SENT: :sent
+        DELIVERED: :delivered
+        FAILED: :failed
+        RECEIVED: :received
+
+        def self?.values: -> ::Array[Zavudev::Models::MessageListParams::status]
+      end
     end
   end
 end

data/sig/zavudev/models/phone_number_type.rbs

@@ -1,12 +1,12 @@
 module Zavudev
   module Models
-    type phone_number_type = :local | :mobile | :tollFree
+    type phone_number_type = :local | :national | :tollFree
 
     module PhoneNumberType
       extend Zavudev::Internal::Type::Enum
 
       LOCAL: :local
-      MOBILE: :mobile
+      NATIONAL: :national
       TOLL_FREE: :tollFree
 
       def self?.values: -> ::Array[Zavudev::Models::phone_number_type]

data/sig/zavudev/models/url_list_verified_params.rbs

@@ -40,7 +40,7 @@ module Zavudev
         request_options: Zavudev::RequestOptions
       }
 
-      type status = :pending | :approved | :rejected | :malicious
+      type status = :pending | :approved | :rejected | :escalated | :malicious
 
       module Status
         extend Zavudev::Internal::Type::Enum
@@ -48,6 +48,7 @@ module Zavudev
         PENDING: :pending
         APPROVED: :approved
         REJECTED: :rejected
+        ESCALATED: :escalated
         MALICIOUS: :malicious
 
         def self?.values: -> ::Array[Zavudev::Models::URLListVerifiedParams::status]

data/sig/zavudev/models/verified_url.rbs

@@ -52,7 +52,7 @@ module Zavudev
         updated_at: Time
       }
 
-      type status = :pending | :approved | :rejected | :malicious
+      type status = :pending | :approved | :rejected | :escalated | :malicious
 
       module Status
         extend Zavudev::Internal::Type::Enum
@@ -60,6 +60,7 @@ module Zavudev
         PENDING: :pending
         APPROVED: :approved
         REJECTED: :rejected
+        ESCALATED: :escalated
         MALICIOUS: :malicious
 
         def self?.values: -> ::Array[Zavudev::Models::VerifiedURL::status]

data/sig/zavudev/models.rbs

@@ -79,14 +79,6 @@ module Zavudev
 
   class ContactUpdateParams = Zavudev::Models::ContactUpdateParams
 
-  class DataExport = Zavudev::Models::DataExport
-
-  class ExportCreateParams = Zavudev::Models::ExportCreateParams
-
-  class ExportListParams = Zavudev::Models::ExportListParams
-
-  class ExportRetrieveParams = Zavudev::Models::ExportRetrieveParams
-
   class FunctionCreateParams = Zavudev::Models::FunctionCreateParams
 
   class FunctionDeleteParams = Zavudev::Models::FunctionDeleteParams
@@ -167,8 +159,6 @@ module Zavudev
 
   class PhoneNumberUpdateParams = Zavudev::Models::PhoneNumberUpdateParams
 
-  class PlanRetrieveParams = Zavudev::Models::PlanRetrieveParams
-
   class RegulatoryDocument = Zavudev::Models::RegulatoryDocument
 
   class RegulatoryDocumentCreateParams = Zavudev::Models::RegulatoryDocumentCreateParams
@@ -247,8 +237,6 @@ module Zavudev
 
   class URLSubmitForVerificationParams = Zavudev::Models::URLSubmitForVerificationParams
 
-  class UsageRetrieveParams = Zavudev::Models::UsageRetrieveParams
-
   class VerifiedURL = Zavudev::Models::VerifiedURL
 
   module WebhookEvent = Zavudev::Models::WebhookEvent

data/sig/zavudev/resources/exports.rbs

@@ -1,25 +1,6 @@
 module Zavudev
   module Resources
     class Exports
-      def create: (
-        data_types: ::Array[Zavudev::Models::ExportCreateParams::data_type],
-        ?date_from: Time,
-        ?date_to: Time,
-        ?request_options: Zavudev::request_opts
-      ) -> Zavudev::Models::ExportCreateResponse
-
-      def retrieve: (
-        String export_id,
-        ?request_options: Zavudev::request_opts
-      ) -> Zavudev::Models::ExportRetrieveResponse
-
-      def list: (
-        ?cursor: String,
-        ?limit: Integer,
-        ?status: Zavudev::Models::ExportListParams::status,
-        ?request_options: Zavudev::request_opts
-      ) -> Zavudev::Internal::Cursor[Zavudev::DataExport]
-
       def initialize: (client: Zavudev::Client) -> void
     end
   end

data/sig/zavudev/resources/invitations.rbs

@@ -6,6 +6,7 @@ module Zavudev
         ?client_email: String,
         ?client_name: String,
         ?client_phone: String,
+        ?connection_type: Zavudev::Models::InvitationCreateParams::connection_type,
         ?expires_in_days: Integer,
         ?phone_number_id: String,
         ?request_options: Zavudev::request_opts

data/sig/zavudev/resources/messages.rbs

@@ -7,10 +7,10 @@ module Zavudev
       ) -> Zavudev::MessageResponse
 
       def list: (
-        ?channel: Zavudev::Models::channel,
+        ?channel: Zavudev::Models::MessageListParams::channel,
         ?cursor: String,
         ?limit: Integer,
-        ?status: Zavudev::Models::message_status,
+        ?status: Zavudev::Models::MessageListParams::status,
         ?to: String,
         ?request_options: Zavudev::request_opts
       ) -> Zavudev::Internal::Cursor[Zavudev::Message]

data/sig/zavudev/resources/plan.rbs

@@ -1,10 +1,6 @@
 module Zavudev
   module Resources
     class Plan
-      def retrieve: (
-        ?request_options: Zavudev::request_opts
-      ) -> Zavudev::Models::PlanRetrieveResponse
-
       def initialize: (client: Zavudev::Client) -> void
     end
   end

data/sig/zavudev/resources/usage.rbs

@@ -1,10 +1,6 @@
 module Zavudev
   module Resources
     class Usage
-      def retrieve: (
-        ?request_options: Zavudev::request_opts
-      ) -> Zavudev::Models::UsageRetrieveResponse
-
       def initialize: (client: Zavudev::Client) -> void
     end
   end