zavudev 0.0.2

data/rbi/zavudev/models/whatsapp_business_profile_vertical.rbi

@@ -0,0 +1,81 @@
+# typed: strong
+
+module Zavudev
+  module Models
+    # Business category for WhatsApp Business profile.
+    module WhatsappBusinessProfileVertical
+      extend Zavudev::Internal::Type::Enum
+
+      TaggedSymbol =
+        T.type_alias { T.all(Symbol, Zavudev::WhatsappBusinessProfileVertical) }
+      OrSymbol = T.type_alias { T.any(Symbol, String) }
+
+      UNDEFINED =
+        T.let(
+          :UNDEFINED,
+          Zavudev::WhatsappBusinessProfileVertical::TaggedSymbol
+        )
+      OTHER =
+        T.let(:OTHER, Zavudev::WhatsappBusinessProfileVertical::TaggedSymbol)
+      AUTO =
+        T.let(:AUTO, Zavudev::WhatsappBusinessProfileVertical::TaggedSymbol)
+      BEAUTY =
+        T.let(:BEAUTY, Zavudev::WhatsappBusinessProfileVertical::TaggedSymbol)
+      APPAREL =
+        T.let(:APPAREL, Zavudev::WhatsappBusinessProfileVertical::TaggedSymbol)
+      EDU = T.let(:EDU, Zavudev::WhatsappBusinessProfileVertical::TaggedSymbol)
+      ENTERTAIN =
+        T.let(
+          :ENTERTAIN,
+          Zavudev::WhatsappBusinessProfileVertical::TaggedSymbol
+        )
+      EVENT_PLAN =
+        T.let(
+          :EVENT_PLAN,
+          Zavudev::WhatsappBusinessProfileVertical::TaggedSymbol
+        )
+      FINANCE =
+        T.let(:FINANCE, Zavudev::WhatsappBusinessProfileVertical::TaggedSymbol)
+      GROCERY =
+        T.let(:GROCERY, Zavudev::WhatsappBusinessProfileVertical::TaggedSymbol)
+      GOVT =
+        T.let(:GOVT, Zavudev::WhatsappBusinessProfileVertical::TaggedSymbol)
+      HOTEL =
+        T.let(:HOTEL, Zavudev::WhatsappBusinessProfileVertical::TaggedSymbol)
+      HEALTH =
+        T.let(:HEALTH, Zavudev::WhatsappBusinessProfileVertical::TaggedSymbol)
+      NONPROFIT =
+        T.let(
+          :NONPROFIT,
+          Zavudev::WhatsappBusinessProfileVertical::TaggedSymbol
+        )
+      PROF_SERVICES =
+        T.let(
+          :PROF_SERVICES,
+          Zavudev::WhatsappBusinessProfileVertical::TaggedSymbol
+        )
+      RETAIL =
+        T.let(:RETAIL, Zavudev::WhatsappBusinessProfileVertical::TaggedSymbol)
+      TRAVEL =
+        T.let(:TRAVEL, Zavudev::WhatsappBusinessProfileVertical::TaggedSymbol)
+      RESTAURANT =
+        T.let(
+          :RESTAURANT,
+          Zavudev::WhatsappBusinessProfileVertical::TaggedSymbol
+        )
+      NOT_A_BIZ =
+        T.let(
+          :NOT_A_BIZ,
+          Zavudev::WhatsappBusinessProfileVertical::TaggedSymbol
+        )
+
+      sig do
+        override.returns(
+          T::Array[Zavudev::WhatsappBusinessProfileVertical::TaggedSymbol]
+        )
+      end
+      def self.values
+      end
+    end
+  end
+end

data/rbi/zavudev/models/whatsapp_category.rbi

@@ -0,0 +1,24 @@
+# typed: strong
+
+module Zavudev
+  module Models
+    # WhatsApp template category.
+    module WhatsappCategory
+      extend Zavudev::Internal::Type::Enum
+
+      TaggedSymbol = T.type_alias { T.all(Symbol, Zavudev::WhatsappCategory) }
+      OrSymbol = T.type_alias { T.any(Symbol, String) }
+
+      UTILITY = T.let(:UTILITY, Zavudev::WhatsappCategory::TaggedSymbol)
+      MARKETING = T.let(:MARKETING, Zavudev::WhatsappCategory::TaggedSymbol)
+      AUTHENTICATION =
+        T.let(:AUTHENTICATION, Zavudev::WhatsappCategory::TaggedSymbol)
+
+      sig do
+        override.returns(T::Array[Zavudev::WhatsappCategory::TaggedSymbol])
+      end
+      def self.values
+      end
+    end
+  end
+end

data/rbi/zavudev/models.rbi

@@ -0,0 +1,190 @@
+# typed: strong
+
+module Zavudev
+  Address = Zavudev::Models::Address
+
+  AddressCreateParams = Zavudev::Models::AddressCreateParams
+
+  AddressDeleteParams = Zavudev::Models::AddressDeleteParams
+
+  AddressListParams = Zavudev::Models::AddressListParams
+
+  AddressRetrieveParams = Zavudev::Models::AddressRetrieveParams
+
+  AddressStatus = Zavudev::Models::AddressStatus
+
+  AvailablePhoneNumber = Zavudev::Models::AvailablePhoneNumber
+
+  Broadcast = Zavudev::Models::Broadcast
+
+  BroadcastCancelParams = Zavudev::Models::BroadcastCancelParams
+
+  BroadcastChannel = Zavudev::Models::BroadcastChannel
+
+  BroadcastContact = Zavudev::Models::BroadcastContact
+
+  BroadcastContactStatus = Zavudev::Models::BroadcastContactStatus
+
+  BroadcastContent = Zavudev::Models::BroadcastContent
+
+  BroadcastCreateParams = Zavudev::Models::BroadcastCreateParams
+
+  BroadcastDeleteParams = Zavudev::Models::BroadcastDeleteParams
+
+  BroadcastListParams = Zavudev::Models::BroadcastListParams
+
+  BroadcastMessageType = Zavudev::Models::BroadcastMessageType
+
+  BroadcastProgress = Zavudev::Models::BroadcastProgress
+
+  BroadcastProgressParams = Zavudev::Models::BroadcastProgressParams
+
+  BroadcastRescheduleParams = Zavudev::Models::BroadcastRescheduleParams
+
+  BroadcastRetrieveParams = Zavudev::Models::BroadcastRetrieveParams
+
+  Broadcasts = Zavudev::Models::Broadcasts
+
+  BroadcastSendParams = Zavudev::Models::BroadcastSendParams
+
+  BroadcastStatus = Zavudev::Models::BroadcastStatus
+
+  BroadcastUpdateParams = Zavudev::Models::BroadcastUpdateParams
+
+  Channel = Zavudev::Models::Channel
+
+  Contact = Zavudev::Models::Contact
+
+  ContactListParams = Zavudev::Models::ContactListParams
+
+  ContactRetrieveByPhoneParams = Zavudev::Models::ContactRetrieveByPhoneParams
+
+  ContactRetrieveParams = Zavudev::Models::ContactRetrieveParams
+
+  ContactUpdateParams = Zavudev::Models::ContactUpdateParams
+
+  IntrospectValidatePhoneParams = Zavudev::Models::IntrospectValidatePhoneParams
+
+  LineType = Zavudev::Models::LineType
+
+  Message = Zavudev::Models::Message
+
+  MessageContent = Zavudev::Models::MessageContent
+
+  MessageListParams = Zavudev::Models::MessageListParams
+
+  MessageReactParams = Zavudev::Models::MessageReactParams
+
+  MessageResponse = Zavudev::Models::MessageResponse
+
+  MessageRetrieveParams = Zavudev::Models::MessageRetrieveParams
+
+  MessageSendParams = Zavudev::Models::MessageSendParams
+
+  MessageStatus = Zavudev::Models::MessageStatus
+
+  MessageType = Zavudev::Models::MessageType
+
+  OwnedPhoneNumber = Zavudev::Models::OwnedPhoneNumber
+
+  OwnedPhoneNumberPricing = Zavudev::Models::OwnedPhoneNumberPricing
+
+  PhoneNumberCapabilities = Zavudev::Models::PhoneNumberCapabilities
+
+  PhoneNumberListParams = Zavudev::Models::PhoneNumberListParams
+
+  PhoneNumberPricing = Zavudev::Models::PhoneNumberPricing
+
+  PhoneNumberPurchaseParams = Zavudev::Models::PhoneNumberPurchaseParams
+
+  PhoneNumberReleaseParams = Zavudev::Models::PhoneNumberReleaseParams
+
+  PhoneNumberRequirementsParams = Zavudev::Models::PhoneNumberRequirementsParams
+
+  PhoneNumberRetrieveParams = Zavudev::Models::PhoneNumberRetrieveParams
+
+  PhoneNumberSearchAvailableParams =
+    Zavudev::Models::PhoneNumberSearchAvailableParams
+
+  PhoneNumberStatus = Zavudev::Models::PhoneNumberStatus
+
+  PhoneNumberType = Zavudev::Models::PhoneNumberType
+
+  PhoneNumberUpdateParams = Zavudev::Models::PhoneNumberUpdateParams
+
+  RegulatoryDocument = Zavudev::Models::RegulatoryDocument
+
+  RegulatoryDocumentCreateParams =
+    Zavudev::Models::RegulatoryDocumentCreateParams
+
+  RegulatoryDocumentDeleteParams =
+    Zavudev::Models::RegulatoryDocumentDeleteParams
+
+  RegulatoryDocumentListParams = Zavudev::Models::RegulatoryDocumentListParams
+
+  RegulatoryDocumentRetrieveParams =
+    Zavudev::Models::RegulatoryDocumentRetrieveParams
+
+  RegulatoryDocumentUploadURLParams =
+    Zavudev::Models::RegulatoryDocumentUploadURLParams
+
+  Requirement = Zavudev::Models::Requirement
+
+  RequirementAcceptanceCriteria = Zavudev::Models::RequirementAcceptanceCriteria
+
+  RequirementFieldType = Zavudev::Models::RequirementFieldType
+
+  RequirementType = Zavudev::Models::RequirementType
+
+  Sender = Zavudev::Models::Sender
+
+  SenderCreateParams = Zavudev::Models::SenderCreateParams
+
+  SenderDeleteParams = Zavudev::Models::SenderDeleteParams
+
+  SenderGetProfileParams = Zavudev::Models::SenderGetProfileParams
+
+  SenderListParams = Zavudev::Models::SenderListParams
+
+  SenderRegenerateWebhookSecretParams =
+    Zavudev::Models::SenderRegenerateWebhookSecretParams
+
+  SenderRetrieveParams = Zavudev::Models::SenderRetrieveParams
+
+  Senders = Zavudev::Models::Senders
+
+  SenderUpdateParams = Zavudev::Models::SenderUpdateParams
+
+  SenderUpdateProfileParams = Zavudev::Models::SenderUpdateProfileParams
+
+  SenderUploadProfilePictureParams =
+    Zavudev::Models::SenderUploadProfilePictureParams
+
+  SenderWebhook = Zavudev::Models::SenderWebhook
+
+  Template = Zavudev::Models::Template
+
+  TemplateCreateParams = Zavudev::Models::TemplateCreateParams
+
+  TemplateDeleteParams = Zavudev::Models::TemplateDeleteParams
+
+  TemplateListParams = Zavudev::Models::TemplateListParams
+
+  TemplateRetrieveParams = Zavudev::Models::TemplateRetrieveParams
+
+  TemplateSubmitParams = Zavudev::Models::TemplateSubmitParams
+
+  WebhookEvent = Zavudev::Models::WebhookEvent
+
+  WebhookSecretResponse = Zavudev::Models::WebhookSecretResponse
+
+  WhatsappBusinessProfile = Zavudev::Models::WhatsappBusinessProfile
+
+  WhatsappBusinessProfileResponse =
+    Zavudev::Models::WhatsappBusinessProfileResponse
+
+  WhatsappBusinessProfileVertical =
+    Zavudev::Models::WhatsappBusinessProfileVertical
+
+  WhatsappCategory = Zavudev::Models::WhatsappCategory
+end

data/rbi/zavudev/request_options.rbi

@@ -0,0 +1,57 @@
+# typed: strong
+
+module Zavudev
+  # Specify HTTP behaviour to use for a specific request. These options supplement
+  # or override those provided at the client level.
+  #
+  # When making a request, you can pass an actual {RequestOptions} instance, or
+  # simply pass a Hash with symbol keys matching the attributes on this class.
+  class RequestOptions < Zavudev::Internal::Type::BaseModel
+    OrHash =
+      T.type_alias do
+        T.any(Zavudev::RequestOptions, Zavudev::Internal::AnyHash)
+      end
+
+    # @api private
+    sig { params(opts: Zavudev::RequestOptions::OrHash).void }
+    def self.validate!(opts)
+    end
+
+    # Idempotency key to send with request and all associated retries. Will only be
+    # sent for write requests.
+    sig { returns(T.nilable(String)) }
+    attr_accessor :idempotency_key
+
+    # Extra query params to send with the request. These are `.merge`’d into any
+    # `query` given at the client level.
+    sig do
+      returns(
+        T.nilable(T::Hash[String, T.nilable(T.any(T::Array[String], String))])
+      )
+    end
+    attr_accessor :extra_query
+
+    # Extra headers to send with the request. These are `.merged`’d into any
+    # `extra_headers` given at the client level.
+    sig { returns(T.nilable(T::Hash[String, T.nilable(String)])) }
+    attr_accessor :extra_headers
+
+    # Extra data to send with the request. These are deep merged into any data
+    # generated as part of the normal request.
+    sig { returns(T.nilable(T.anything)) }
+    attr_accessor :extra_body
+
+    # Maximum number of retries to attempt after a failed initial request.
+    sig { returns(T.nilable(Integer)) }
+    attr_accessor :max_retries
+
+    # Request timeout in seconds.
+    sig { returns(T.nilable(Float)) }
+    attr_accessor :timeout
+
+    # Returns a new instance of RequestOptions.
+    sig { params(values: Zavudev::Internal::AnyHash).returns(T.attached_class) }
+    def self.new(values = {})
+    end
+  end
+end

data/rbi/zavudev/resources/addresses.rbi

@@ -0,0 +1,73 @@
+# typed: strong
+
+module Zavudev
+  module Resources
+    class Addresses
+      # Create a regulatory address for phone number purchases. Some countries require a
+      # verified address before phone numbers can be activated.
+      sig do
+        params(
+          country_code: String,
+          locality: String,
+          postal_code: String,
+          street_address: String,
+          administrative_area: String,
+          business_name: String,
+          extended_address: String,
+          first_name: String,
+          last_name: String,
+          request_options: Zavudev::RequestOptions::OrHash
+        ).returns(Zavudev::Models::AddressCreateResponse)
+      end
+      def create(
+        country_code:,
+        locality:,
+        postal_code:,
+        street_address:,
+        administrative_area: nil,
+        business_name: nil,
+        extended_address: nil,
+        first_name: nil,
+        last_name: nil,
+        request_options: {}
+      )
+      end
+
+      # Get a specific regulatory address.
+      sig do
+        params(
+          address_id: String,
+          request_options: Zavudev::RequestOptions::OrHash
+        ).returns(Zavudev::Models::AddressRetrieveResponse)
+      end
+      def retrieve(address_id, request_options: {})
+      end
+
+      # List regulatory addresses for this project.
+      sig do
+        params(
+          cursor: String,
+          limit: Integer,
+          request_options: Zavudev::RequestOptions::OrHash
+        ).returns(Zavudev::Internal::Cursor[Zavudev::Address])
+      end
+      def list(cursor: nil, limit: nil, request_options: {})
+      end
+
+      # Delete a regulatory address. Cannot delete addresses that are in use.
+      sig do
+        params(
+          address_id: String,
+          request_options: Zavudev::RequestOptions::OrHash
+        ).void
+      end
+      def delete(address_id, request_options: {})
+      end
+
+      # @api private
+      sig { params(client: Zavudev::Client).returns(T.attached_class) }
+      def self.new(client:)
+      end
+    end
+  end
+end

data/rbi/zavudev/resources/broadcasts/contacts.rbi

@@ -0,0 +1,67 @@
+# typed: strong
+
+module Zavudev
+  module Resources
+    class Broadcasts
+      class Contacts
+        # List contacts in a broadcast with optional status filter.
+        sig do
+          params(
+            broadcast_id: String,
+            cursor: String,
+            limit: Integer,
+            status: Zavudev::BroadcastContactStatus::OrSymbol,
+            request_options: Zavudev::RequestOptions::OrHash
+          ).returns(Zavudev::Internal::Cursor[Zavudev::BroadcastContact])
+        end
+        def list(
+          broadcast_id,
+          cursor: nil,
+          limit: nil,
+          # Status of a contact within a broadcast.
+          status: nil,
+          request_options: {}
+        )
+        end
+
+        # Add contacts to a broadcast in batch. Maximum 1000 contacts per request.
+        sig do
+          params(
+            broadcast_id: String,
+            contacts:
+              T::Array[Zavudev::Broadcasts::ContactAddParams::Contact::OrHash],
+            request_options: Zavudev::RequestOptions::OrHash
+          ).returns(Zavudev::Models::Broadcasts::ContactAddResponse)
+        end
+        def add(
+          broadcast_id,
+          # List of contacts to add (max 1000 per request).
+          contacts:,
+          request_options: {}
+        )
+        end
+
+        # Remove a contact from a broadcast in draft status.
+        sig do
+          params(
+            contact_id: String,
+            broadcast_id: String,
+            request_options: Zavudev::RequestOptions::OrHash
+          ).void
+        end
+        def remove(
+          # Broadcast contact ID (not the global contact ID)
+          contact_id,
+          broadcast_id:,
+          request_options: {}
+        )
+        end
+
+        # @api private
+        sig { params(client: Zavudev::Client).returns(T.attached_class) }
+        def self.new(client:)
+        end
+      end
+    end
+  end
+end

data/rbi/zavudev/resources/broadcasts.rbi

@@ -0,0 +1,180 @@
+# typed: strong
+
+module Zavudev
+  module Resources
+    class Broadcasts
+      sig { returns(Zavudev::Resources::Broadcasts::Contacts) }
+      attr_reader :contacts
+
+      # Create a new broadcast campaign. Add contacts after creation, then send.
+      sig do
+        params(
+          channel: Zavudev::BroadcastChannel::OrSymbol,
+          name: String,
+          content: Zavudev::BroadcastContent::OrHash,
+          email_html_body: String,
+          email_subject: String,
+          idempotency_key: String,
+          message_type: Zavudev::BroadcastMessageType::OrSymbol,
+          metadata: T::Hash[Symbol, String],
+          scheduled_at: Time,
+          sender_id: String,
+          text: String,
+          request_options: Zavudev::RequestOptions::OrHash
+        ).returns(Zavudev::Models::BroadcastCreateResponse)
+      end
+      def create(
+        # Broadcast delivery channel. Use 'smart' for per-contact intelligent routing.
+        channel:,
+        # Name of the broadcast campaign.
+        name:,
+        # Content for non-text broadcast message types.
+        content: nil,
+        # HTML body for email broadcasts.
+        email_html_body: nil,
+        # Email subject line. Required for email broadcasts.
+        email_subject: nil,
+        # Idempotency key to prevent duplicate broadcasts.
+        idempotency_key: nil,
+        # Type of message for broadcast.
+        message_type: nil,
+        metadata: nil,
+        # Schedule the broadcast for future delivery.
+        scheduled_at: nil,
+        # Sender profile ID. Uses default sender if omitted.
+        sender_id: nil,
+        # Text content or caption. Supports template variables: {{name}}, {{1}}, etc.
+        text: nil,
+        request_options: {}
+      )
+      end
+
+      # Get broadcast
+      sig do
+        params(
+          broadcast_id: String,
+          request_options: Zavudev::RequestOptions::OrHash
+        ).returns(Zavudev::Models::BroadcastRetrieveResponse)
+      end
+      def retrieve(broadcast_id, request_options: {})
+      end
+
+      # Update a broadcast in draft status.
+      sig do
+        params(
+          broadcast_id: String,
+          content: Zavudev::BroadcastContent::OrHash,
+          email_html_body: String,
+          email_subject: String,
+          metadata: T::Hash[Symbol, String],
+          name: String,
+          text: String,
+          request_options: Zavudev::RequestOptions::OrHash
+        ).returns(Zavudev::Models::BroadcastUpdateResponse)
+      end
+      def update(
+        broadcast_id,
+        # Content for non-text broadcast message types.
+        content: nil,
+        email_html_body: nil,
+        email_subject: nil,
+        metadata: nil,
+        name: nil,
+        text: nil,
+        request_options: {}
+      )
+      end
+
+      # List broadcasts for this project.
+      sig do
+        params(
+          cursor: String,
+          limit: Integer,
+          status: Zavudev::BroadcastStatus::OrSymbol,
+          request_options: Zavudev::RequestOptions::OrHash
+        ).returns(Zavudev::Internal::Cursor[Zavudev::Broadcast])
+      end
+      def list(
+        cursor: nil,
+        limit: nil,
+        # Current status of the broadcast.
+        status: nil,
+        request_options: {}
+      )
+      end
+
+      # Delete a broadcast in draft status.
+      sig do
+        params(
+          broadcast_id: String,
+          request_options: Zavudev::RequestOptions::OrHash
+        ).void
+      end
+      def delete(broadcast_id, request_options: {})
+      end
+
+      # Cancel a broadcast. Pending contacts will be skipped, but already queued
+      # messages may still be delivered.
+      sig do
+        params(
+          broadcast_id: String,
+          request_options: Zavudev::RequestOptions::OrHash
+        ).returns(Zavudev::Models::BroadcastCancelResponse)
+      end
+      def cancel(broadcast_id, request_options: {})
+      end
+
+      # Get real-time progress of a broadcast including delivery counts and estimated
+      # completion time.
+      sig do
+        params(
+          broadcast_id: String,
+          request_options: Zavudev::RequestOptions::OrHash
+        ).returns(Zavudev::BroadcastProgress)
+      end
+      def progress(broadcast_id, request_options: {})
+      end
+
+      # Update the scheduled time for a broadcast. The broadcast must be in scheduled
+      # status.
+      sig do
+        params(
+          broadcast_id: String,
+          scheduled_at: Time,
+          request_options: Zavudev::RequestOptions::OrHash
+        ).returns(Zavudev::Models::BroadcastRescheduleResponse)
+      end
+      def reschedule(
+        broadcast_id,
+        # New scheduled time for the broadcast.
+        scheduled_at:,
+        request_options: {}
+      )
+      end
+
+      # Start sending the broadcast immediately or schedule for later. Broadcasts go
+      # through automated AI content review before sending. If the review passes, the
+      # broadcast proceeds. If rejected, use PATCH to edit content, then call POST
+      # /retry-review. Reserves the estimated cost from your balance.
+      sig do
+        params(
+          broadcast_id: String,
+          scheduled_at: Time,
+          request_options: Zavudev::RequestOptions::OrHash
+        ).returns(Zavudev::Models::BroadcastSendResponse)
+      end
+      def send_(
+        broadcast_id,
+        # Schedule for future delivery. Omit to send immediately.
+        scheduled_at: nil,
+        request_options: {}
+      )
+      end
+
+      # @api private
+      sig { params(client: Zavudev::Client).returns(T.attached_class) }
+      def self.new(client:)
+      end
+    end
+  end
+end