zavudev 0.7.0 → 0.9.0

data/rbi/zavudev/models/message_content.rbi

@@ -28,6 +28,50 @@ module Zavudev
       end
       attr_writer :contacts
 
+      # Button label for cta_url messages.
+      sig { returns(T.nilable(String)) }
+      attr_reader :cta_display_text
+
+      sig { params(cta_display_text: String).void }
+      attr_writer :cta_display_text
+
+      # Public HTTPS URL of the header media when ctaHeaderType is 'image', 'video', or
+      # 'document'. WhatsApp fetches this URL — it must be publicly reachable and return
+      # the declared content type.
+      sig { returns(T.nilable(String)) }
+      attr_reader :cta_header_media_url
+
+      sig { params(cta_header_media_url: String).void }
+      attr_writer :cta_header_media_url
+
+      # Header text when ctaHeaderType is 'text'.
+      sig { returns(T.nilable(String)) }
+      attr_reader :cta_header_text
+
+      sig { params(cta_header_text: String).void }
+      attr_writer :cta_header_text
+
+      # Optional header type for cta_url messages.
+      sig do
+        returns(T.nilable(Zavudev::MessageContent::CtaHeaderType::OrSymbol))
+      end
+      attr_reader :cta_header_type
+
+      sig do
+        params(
+          cta_header_type: Zavudev::MessageContent::CtaHeaderType::OrSymbol
+        ).void
+      end
+      attr_writer :cta_header_type
+
+      # Destination URL opened in the device's default browser when the button is
+      # tapped. Used with messageType=cta_url. WhatsApp requires HTTPS in production.
+      sig { returns(T.nilable(String)) }
+      attr_reader :cta_url
+
+      sig { params(cta_url: String).void }
+      attr_writer :cta_url
+
       # Emoji for reaction messages.
       sig { returns(T.nilable(String)) }
       attr_reader :emoji
@@ -42,6 +86,13 @@ module Zavudev
       sig { params(filename: String).void }
       attr_writer :filename
 
+      # Optional footer text for cta_url messages.
+      sig { returns(T.nilable(String)) }
+      attr_reader :footer_text
+
+      sig { params(footer_text: String).void }
+      attr_writer :footer_text
+
       # Latitude for location messages.
       sig { returns(T.nilable(Float)) }
       attr_reader :latitude
@@ -116,6 +167,26 @@ module Zavudev
       end
       attr_writer :sections
 
+      # Variables for dynamic button placeholders (URL buttons and OTP buttons). Keys
+      # are the button index (0, 1, 2) in the template's `buttons` array — not the
+      # placeholder name. Values substitute the `{{1}}` placeholder inside that button's
+      # URL.
+      #
+      # **WhatsApp constraints:**
+      #
+      # - URL buttons only accept `{{1}}` — positional, numeric, no whitespace, no name.
+      #   Named placeholders like `{{token}}` are stored as literal URL text by Meta and
+      #   cannot be substituted.
+      # - At most one placeholder per URL button.
+      # - A template may have at most three buttons.
+      # - Static URL buttons (no placeholder) and `quick_reply` buttons are not included
+      #   here.
+      sig { returns(T.nilable(T::Hash[Symbol, String])) }
+      attr_reader :template_button_variables
+
+      sig { params(template_button_variables: T::Hash[Symbol, String]).void }
+      attr_writer :template_button_variables
+
       # Template ID for template messages.
       sig { returns(T.nilable(String)) }
       attr_reader :template_id
@@ -123,7 +194,8 @@ module Zavudev
       sig { params(template_id: String).void }
       attr_writer :template_id
 
-      # Variables for template rendering. Keys are variable positions (1, 2, 3...).
+      # Variables for body placeholders. Keys are positions (1, 2, 3, ...) matching the
+      # order placeholders appear in the template body.
       sig { returns(T.nilable(T::Hash[Symbol, String])) }
       attr_reader :template_variables
 
@@ -135,8 +207,14 @@ module Zavudev
         params(
           buttons: T::Array[Zavudev::MessageContent::Button::OrHash],
           contacts: T::Array[Zavudev::MessageContent::Contact::OrHash],
+          cta_display_text: String,
+          cta_header_media_url: String,
+          cta_header_text: String,
+          cta_header_type: Zavudev::MessageContent::CtaHeaderType::OrSymbol,
+          cta_url: String,
           emoji: String,
           filename: String,
+          footer_text: String,
           latitude: Float,
           list_button: String,
           location_address: String,
@@ -147,6 +225,7 @@ module Zavudev
           mime_type: String,
           react_to_message_id: String,
           sections: T::Array[Zavudev::MessageContent::Section::OrHash],
+          template_button_variables: T::Hash[Symbol, String],
           template_id: String,
           template_variables: T::Hash[Symbol, String]
         ).returns(T.attached_class)
@@ -156,10 +235,25 @@ module Zavudev
         buttons: nil,
         # Contact cards for contact messages.
         contacts: nil,
+        # Button label for cta_url messages.
+        cta_display_text: nil,
+        # Public HTTPS URL of the header media when ctaHeaderType is 'image', 'video', or
+        # 'document'. WhatsApp fetches this URL — it must be publicly reachable and return
+        # the declared content type.
+        cta_header_media_url: nil,
+        # Header text when ctaHeaderType is 'text'.
+        cta_header_text: nil,
+        # Optional header type for cta_url messages.
+        cta_header_type: nil,
+        # Destination URL opened in the device's default browser when the button is
+        # tapped. Used with messageType=cta_url. WhatsApp requires HTTPS in production.
+        cta_url: nil,
         # Emoji for reaction messages.
         emoji: nil,
         # Filename for documents.
         filename: nil,
+        # Optional footer text for cta_url messages.
+        footer_text: nil,
         # Latitude for location messages.
         latitude: nil,
         # Button text for list messages.
@@ -180,9 +274,25 @@ module Zavudev
         react_to_message_id: nil,
         # Sections for list messages.
         sections: nil,
+        # Variables for dynamic button placeholders (URL buttons and OTP buttons). Keys
+        # are the button index (0, 1, 2) in the template's `buttons` array — not the
+        # placeholder name. Values substitute the `{{1}}` placeholder inside that button's
+        # URL.
+        #
+        # **WhatsApp constraints:**
+        #
+        # - URL buttons only accept `{{1}}` — positional, numeric, no whitespace, no name.
+        #   Named placeholders like `{{token}}` are stored as literal URL text by Meta and
+        #   cannot be substituted.
+        # - At most one placeholder per URL button.
+        # - A template may have at most three buttons.
+        # - Static URL buttons (no placeholder) and `quick_reply` buttons are not included
+        #   here.
+        template_button_variables: nil,
         # Template ID for template messages.
         template_id: nil,
-        # Variables for template rendering. Keys are variable positions (1, 2, 3...).
+        # Variables for body placeholders. Keys are positions (1, 2, 3, ...) matching the
+        # order placeholders appear in the template body.
         template_variables: nil
       )
       end
@@ -192,8 +302,14 @@ module Zavudev
           {
             buttons: T::Array[Zavudev::MessageContent::Button],
             contacts: T::Array[Zavudev::MessageContent::Contact],
+            cta_display_text: String,
+            cta_header_media_url: String,
+            cta_header_text: String,
+            cta_header_type: Zavudev::MessageContent::CtaHeaderType::OrSymbol,
+            cta_url: String,
             emoji: String,
             filename: String,
+            footer_text: String,
             latitude: Float,
             list_button: String,
             location_address: String,
@@ -204,6 +320,7 @@ module Zavudev
             mime_type: String,
             react_to_message_id: String,
             sections: T::Array[Zavudev::MessageContent::Section],
+            template_button_variables: T::Hash[Symbol, String],
             template_id: String,
             template_variables: T::Hash[Symbol, String]
           }
@@ -264,6 +381,32 @@ module Zavudev
         end
       end
 
+      # Optional header type for cta_url messages.
+      module CtaHeaderType
+        extend Zavudev::Internal::Type::Enum
+
+        TaggedSymbol =
+          T.type_alias { T.all(Symbol, Zavudev::MessageContent::CtaHeaderType) }
+        OrSymbol = T.type_alias { T.any(Symbol, String) }
+
+        TEXT =
+          T.let(:text, Zavudev::MessageContent::CtaHeaderType::TaggedSymbol)
+        IMAGE =
+          T.let(:image, Zavudev::MessageContent::CtaHeaderType::TaggedSymbol)
+        VIDEO =
+          T.let(:video, Zavudev::MessageContent::CtaHeaderType::TaggedSymbol)
+        DOCUMENT =
+          T.let(:document, Zavudev::MessageContent::CtaHeaderType::TaggedSymbol)
+
+        sig do
+          override.returns(
+            T::Array[Zavudev::MessageContent::CtaHeaderType::TaggedSymbol]
+          )
+        end
+        def self.values
+        end
+      end
+
       class Section < Zavudev::Internal::Type::BaseModel
         OrHash =
           T.type_alias do

data/rbi/zavudev/models/message_type.rbi

@@ -20,6 +20,7 @@ module Zavudev
       CONTACT = T.let(:contact, Zavudev::MessageType::TaggedSymbol)
       BUTTONS = T.let(:buttons, Zavudev::MessageType::TaggedSymbol)
       LIST = T.let(:list, Zavudev::MessageType::TaggedSymbol)
+      CTA_URL = T.let(:cta_url, Zavudev::MessageType::TaggedSymbol)
       REACTION = T.let(:reaction, Zavudev::MessageType::TaggedSymbol)
       TEMPLATE = T.let(:template, Zavudev::MessageType::TaggedSymbol)
 

data/rbi/zavudev/models/number_10dlc/brand_create_params.rbi

@@ -0,0 +1,228 @@
+# typed: strong
+
+module Zavudev
+  module Models
+    module Number10dlc
+      class BrandCreateParams < Zavudev::Internal::Type::BaseModel
+        extend Zavudev::Internal::Type::RequestParameters::Converter
+        include Zavudev::Internal::Type::RequestParameters
+
+        OrHash =
+          T.type_alias do
+            T.any(
+              Zavudev::Number10dlc::BrandCreateParams,
+              Zavudev::Internal::AnyHash
+            )
+          end
+
+        sig { returns(String) }
+        attr_accessor :city
+
+        # Two-letter ISO country code.
+        sig { returns(String) }
+        attr_accessor :country
+
+        # Display name of the brand.
+        sig { returns(String) }
+        attr_accessor :display_name
+
+        sig { returns(String) }
+        attr_accessor :email
+
+        # Business entity type for 10DLC brand registration.
+        sig do
+          returns(Zavudev::Number10dlc::BrandCreateParams::EntityType::OrSymbol)
+        end
+        attr_accessor :entity_type
+
+        # Contact phone in E.164 format.
+        sig { returns(String) }
+        attr_accessor :phone
+
+        sig { returns(String) }
+        attr_accessor :postal_code
+
+        sig { returns(String) }
+        attr_accessor :state
+
+        sig { returns(String) }
+        attr_accessor :street
+
+        # Industry vertical.
+        sig { returns(String) }
+        attr_accessor :vertical
+
+        # Legal company name.
+        sig { returns(T.nilable(String)) }
+        attr_reader :company_name
+
+        sig { params(company_name: String).void }
+        attr_writer :company_name
+
+        # Employer Identification Number (format: XX-XXXXXXX).
+        sig { returns(T.nilable(String)) }
+        attr_reader :ein
+
+        sig { params(ein: String).void }
+        attr_writer :ein
+
+        sig { returns(T.nilable(String)) }
+        attr_reader :first_name
+
+        sig { params(first_name: String).void }
+        attr_writer :first_name
+
+        sig { returns(T.nilable(String)) }
+        attr_reader :last_name
+
+        sig { params(last_name: String).void }
+        attr_writer :last_name
+
+        sig { returns(T.nilable(String)) }
+        attr_reader :stock_exchange
+
+        sig { params(stock_exchange: String).void }
+        attr_writer :stock_exchange
+
+        sig { returns(T.nilable(String)) }
+        attr_reader :stock_symbol
+
+        sig { params(stock_symbol: String).void }
+        attr_writer :stock_symbol
+
+        sig { returns(T.nilable(String)) }
+        attr_reader :website
+
+        sig { params(website: String).void }
+        attr_writer :website
+
+        sig do
+          params(
+            city: String,
+            country: String,
+            display_name: String,
+            email: String,
+            entity_type:
+              Zavudev::Number10dlc::BrandCreateParams::EntityType::OrSymbol,
+            phone: String,
+            postal_code: String,
+            state: String,
+            street: String,
+            vertical: String,
+            company_name: String,
+            ein: String,
+            first_name: String,
+            last_name: String,
+            stock_exchange: String,
+            stock_symbol: String,
+            website: String,
+            request_options: Zavudev::RequestOptions::OrHash
+          ).returns(T.attached_class)
+        end
+        def self.new(
+          city:,
+          # Two-letter ISO country code.
+          country:,
+          # Display name of the brand.
+          display_name:,
+          email:,
+          # Business entity type for 10DLC brand registration.
+          entity_type:,
+          # Contact phone in E.164 format.
+          phone:,
+          postal_code:,
+          state:,
+          street:,
+          # Industry vertical.
+          vertical:,
+          # Legal company name.
+          company_name: nil,
+          # Employer Identification Number (format: XX-XXXXXXX).
+          ein: nil,
+          first_name: nil,
+          last_name: nil,
+          stock_exchange: nil,
+          stock_symbol: nil,
+          website: nil,
+          request_options: {}
+        )
+        end
+
+        sig do
+          override.returns(
+            {
+              city: String,
+              country: String,
+              display_name: String,
+              email: String,
+              entity_type:
+                Zavudev::Number10dlc::BrandCreateParams::EntityType::OrSymbol,
+              phone: String,
+              postal_code: String,
+              state: String,
+              street: String,
+              vertical: String,
+              company_name: String,
+              ein: String,
+              first_name: String,
+              last_name: String,
+              stock_exchange: String,
+              stock_symbol: String,
+              website: String,
+              request_options: Zavudev::RequestOptions
+            }
+          )
+        end
+        def to_hash
+        end
+
+        # Business entity type for 10DLC brand registration.
+        module EntityType
+          extend Zavudev::Internal::Type::Enum
+
+          TaggedSymbol =
+            T.type_alias do
+              T.all(Symbol, Zavudev::Number10dlc::BrandCreateParams::EntityType)
+            end
+          OrSymbol = T.type_alias { T.any(Symbol, String) }
+
+          PRIVATE_PROFIT =
+            T.let(
+              :PRIVATE_PROFIT,
+              Zavudev::Number10dlc::BrandCreateParams::EntityType::TaggedSymbol
+            )
+          PUBLIC_PROFIT =
+            T.let(
+              :PUBLIC_PROFIT,
+              Zavudev::Number10dlc::BrandCreateParams::EntityType::TaggedSymbol
+            )
+          NON_PROFIT =
+            T.let(
+              :NON_PROFIT,
+              Zavudev::Number10dlc::BrandCreateParams::EntityType::TaggedSymbol
+            )
+          GOVERNMENT =
+            T.let(
+              :GOVERNMENT,
+              Zavudev::Number10dlc::BrandCreateParams::EntityType::TaggedSymbol
+            )
+          SOLE_PROPRIETOR =
+            T.let(
+              :SOLE_PROPRIETOR,
+              Zavudev::Number10dlc::BrandCreateParams::EntityType::TaggedSymbol
+            )
+
+          sig do
+            override.returns(
+              T::Array[
+                Zavudev::Number10dlc::BrandCreateParams::EntityType::TaggedSymbol
+              ]
+            )
+          end
+          def self.values
+          end
+        end
+      end
+    end
+  end
+end

data/rbi/zavudev/models/number_10dlc/brand_create_response.rbi

@@ -0,0 +1,35 @@
+# typed: strong
+
+module Zavudev
+  module Models
+    module Number10dlc
+      class BrandCreateResponse < Zavudev::Internal::Type::BaseModel
+        OrHash =
+          T.type_alias do
+            T.any(
+              Zavudev::Models::Number10dlc::BrandCreateResponse,
+              Zavudev::Internal::AnyHash
+            )
+          end
+
+        sig { returns(Zavudev::Number10dlc::TenDlcBrand) }
+        attr_reader :brand
+
+        sig { params(brand: Zavudev::Number10dlc::TenDlcBrand::OrHash).void }
+        attr_writer :brand
+
+        sig do
+          params(brand: Zavudev::Number10dlc::TenDlcBrand::OrHash).returns(
+            T.attached_class
+          )
+        end
+        def self.new(brand:)
+        end
+
+        sig { override.returns({ brand: Zavudev::Number10dlc::TenDlcBrand }) }
+        def to_hash
+        end
+      end
+    end
+  end
+end

data/rbi/zavudev/models/number_10dlc/brand_delete_params.rbi

@@ -0,0 +1,40 @@
+# typed: strong
+
+module Zavudev
+  module Models
+    module Number10dlc
+      class BrandDeleteParams < Zavudev::Internal::Type::BaseModel
+        extend Zavudev::Internal::Type::RequestParameters::Converter
+        include Zavudev::Internal::Type::RequestParameters
+
+        OrHash =
+          T.type_alias do
+            T.any(
+              Zavudev::Number10dlc::BrandDeleteParams,
+              Zavudev::Internal::AnyHash
+            )
+          end
+
+        sig { returns(String) }
+        attr_accessor :brand_id
+
+        sig do
+          params(
+            brand_id: String,
+            request_options: Zavudev::RequestOptions::OrHash
+          ).returns(T.attached_class)
+        end
+        def self.new(brand_id:, request_options: {})
+        end
+
+        sig do
+          override.returns(
+            { brand_id: String, request_options: Zavudev::RequestOptions }
+          )
+        end
+        def to_hash
+        end
+      end
+    end
+  end
+end

data/rbi/zavudev/models/number_10dlc/brand_list_params.rbi

@@ -0,0 +1,54 @@
+# typed: strong
+
+module Zavudev
+  module Models
+    module Number10dlc
+      class BrandListParams < Zavudev::Internal::Type::BaseModel
+        extend Zavudev::Internal::Type::RequestParameters::Converter
+        include Zavudev::Internal::Type::RequestParameters
+
+        OrHash =
+          T.type_alias do
+            T.any(
+              Zavudev::Number10dlc::BrandListParams,
+              Zavudev::Internal::AnyHash
+            )
+          end
+
+        sig { returns(T.nilable(String)) }
+        attr_reader :cursor
+
+        sig { params(cursor: String).void }
+        attr_writer :cursor
+
+        sig { returns(T.nilable(Integer)) }
+        attr_reader :limit
+
+        sig { params(limit: Integer).void }
+        attr_writer :limit
+
+        sig do
+          params(
+            cursor: String,
+            limit: Integer,
+            request_options: Zavudev::RequestOptions::OrHash
+          ).returns(T.attached_class)
+        end
+        def self.new(cursor: nil, limit: nil, request_options: {})
+        end
+
+        sig do
+          override.returns(
+            {
+              cursor: String,
+              limit: Integer,
+              request_options: Zavudev::RequestOptions
+            }
+          )
+        end
+        def to_hash
+        end
+      end
+    end
+  end
+end

data/rbi/zavudev/models/number_10dlc/brand_list_use_cases_params.rbi

@@ -0,0 +1,32 @@
+# typed: strong
+
+module Zavudev
+  module Models
+    module Number10dlc
+      class BrandListUseCasesParams < Zavudev::Internal::Type::BaseModel
+        extend Zavudev::Internal::Type::RequestParameters::Converter
+        include Zavudev::Internal::Type::RequestParameters
+
+        OrHash =
+          T.type_alias do
+            T.any(
+              Zavudev::Number10dlc::BrandListUseCasesParams,
+              Zavudev::Internal::AnyHash
+            )
+          end
+
+        sig do
+          params(request_options: Zavudev::RequestOptions::OrHash).returns(
+            T.attached_class
+          )
+        end
+        def self.new(request_options: {})
+        end
+
+        sig { override.returns({ request_options: Zavudev::RequestOptions }) }
+        def to_hash
+        end
+      end
+    end
+  end
+end