zavudev 0.0.2

data/lib/zavudev/models/contact_update_params.rb

@@ -0,0 +1,54 @@
+# frozen_string_literal: true
+
+module Zavudev
+  module Models
+    # @see Zavudev::Resources::Contacts#update
+    class ContactUpdateParams < Zavudev::Internal::Type::BaseModel
+      extend Zavudev::Internal::Type::RequestParameters::Converter
+      include Zavudev::Internal::Type::RequestParameters
+
+      # @!attribute contact_id
+      #
+      #   @return [String]
+      required :contact_id, String
+
+      # @!attribute default_channel
+      #   Preferred channel for this contact. Set to null to clear.
+      #
+      #   @return [Symbol, Zavudev::Models::ContactUpdateParams::DefaultChannel, nil]
+      optional :default_channel,
+               enum: -> { Zavudev::ContactUpdateParams::DefaultChannel },
+               api_name: :defaultChannel,
+               nil?: true
+
+      # @!attribute metadata
+      #
+      #   @return [Hash{Symbol=>String}, nil]
+      optional :metadata, Zavudev::Internal::Type::HashOf[String]
+
+      # @!method initialize(contact_id:, default_channel: nil, metadata: nil, request_options: {})
+      #   @param contact_id [String]
+      #
+      #   @param default_channel [Symbol, Zavudev::Models::ContactUpdateParams::DefaultChannel, nil] Preferred channel for this contact. Set to null to clear.
+      #
+      #   @param metadata [Hash{Symbol=>String}]
+      #
+      #   @param request_options [Zavudev::RequestOptions, Hash{Symbol=>Object}]
+
+      # Preferred channel for this contact. Set to null to clear.
+      module DefaultChannel
+        extend Zavudev::Internal::Type::Enum
+
+        SMS = :sms
+        WHATSAPP = :whatsapp
+        TELEGRAM = :telegram
+        EMAIL = :email
+        INSTAGRAM = :instagram
+        VOICE = :voice
+
+        # @!method self.values
+        #   @return [Array<Symbol>]
+      end
+    end
+  end
+end

data/lib/zavudev/models/introspect_validate_phone_params.rb

@@ -0,0 +1,20 @@
+# frozen_string_literal: true
+
+module Zavudev
+  module Models
+    # @see Zavudev::Resources::Introspect#validate_phone
+    class IntrospectValidatePhoneParams < Zavudev::Internal::Type::BaseModel
+      extend Zavudev::Internal::Type::RequestParameters::Converter
+      include Zavudev::Internal::Type::RequestParameters
+
+      # @!attribute phone_number
+      #
+      #   @return [String]
+      required :phone_number, String, api_name: :phoneNumber
+
+      # @!method initialize(phone_number:, request_options: {})
+      #   @param phone_number [String]
+      #   @param request_options [Zavudev::RequestOptions, Hash{Symbol=>Object}]
+    end
+  end
+end

data/lib/zavudev/models/introspect_validate_phone_response.rb

@@ -0,0 +1,84 @@
+# frozen_string_literal: true
+
+module Zavudev
+  module Models
+    # @see Zavudev::Resources::Introspect#validate_phone
+    class IntrospectValidatePhoneResponse < Zavudev::Internal::Type::BaseModel
+      # @!attribute country_code
+      #
+      #   @return [String]
+      required :country_code, String, api_name: :countryCode
+
+      # @!attribute phone_number
+      #
+      #   @return [String]
+      required :phone_number, String, api_name: :phoneNumber
+
+      # @!attribute valid_number
+      #
+      #   @return [Boolean]
+      required :valid_number, Zavudev::Internal::Type::Boolean, api_name: :validNumber
+
+      # @!attribute available_channels
+      #   List of available messaging channels for this phone number.
+      #
+      #   @return [Array<String>, nil]
+      optional :available_channels, Zavudev::Internal::Type::ArrayOf[String], api_name: :availableChannels
+
+      # @!attribute carrier
+      #   Carrier information for the phone number.
+      #
+      #   @return [Zavudev::Models::IntrospectValidatePhoneResponse::Carrier, nil]
+      optional :carrier, -> { Zavudev::Models::IntrospectValidatePhoneResponse::Carrier }
+
+      # @!attribute line_type
+      #   Type of phone line.
+      #
+      #   @return [Symbol, Zavudev::Models::LineType, nil]
+      optional :line_type, enum: -> { Zavudev::LineType }, api_name: :lineType
+
+      # @!attribute national_format
+      #   Phone number in national format.
+      #
+      #   @return [String, nil]
+      optional :national_format, String, api_name: :nationalFormat
+
+      # @!method initialize(country_code:, phone_number:, valid_number:, available_channels: nil, carrier: nil, line_type: nil, national_format: nil)
+      #   @param country_code [String]
+      #
+      #   @param phone_number [String]
+      #
+      #   @param valid_number [Boolean]
+      #
+      #   @param available_channels [Array<String>] List of available messaging channels for this phone number.
+      #
+      #   @param carrier [Zavudev::Models::IntrospectValidatePhoneResponse::Carrier] Carrier information for the phone number.
+      #
+      #   @param line_type [Symbol, Zavudev::Models::LineType] Type of phone line.
+      #
+      #   @param national_format [String] Phone number in national format.
+
+      # @see Zavudev::Models::IntrospectValidatePhoneResponse#carrier
+      class Carrier < Zavudev::Internal::Type::BaseModel
+        # @!attribute name
+        #   Carrier name.
+        #
+        #   @return [String, nil]
+        optional :name, String, nil?: true
+
+        # @!attribute type
+        #   Type of phone line.
+        #
+        #   @return [Symbol, Zavudev::Models::LineType, nil]
+        optional :type, enum: -> { Zavudev::LineType }
+
+        # @!method initialize(name: nil, type: nil)
+        #   Carrier information for the phone number.
+        #
+        #   @param name [String, nil] Carrier name.
+        #
+        #   @param type [Symbol, Zavudev::Models::LineType] Type of phone line.
+      end
+    end
+  end
+end

data/lib/zavudev/models/line_type.rb

@@ -0,0 +1,19 @@
+# frozen_string_literal: true
+
+module Zavudev
+  module Models
+    # Type of phone line.
+    module LineType
+      extend Zavudev::Internal::Type::Enum
+
+      MOBILE = :mobile
+      LANDLINE = :landline
+      VOIP = :voip
+      TOLL_FREE = :toll_free
+      UNKNOWN = :unknown
+
+      # @!method self.values
+      #   @return [Array<Symbol>]
+    end
+  end
+end

data/lib/zavudev/models/message.rb

@@ -0,0 +1,147 @@
+# frozen_string_literal: true
+
+module Zavudev
+  module Models
+    # @see Zavudev::Resources::Messages#list
+    class Message < Zavudev::Internal::Type::BaseModel
+      # @!attribute id
+      #
+      #   @return [String]
+      required :id, String
+
+      # @!attribute channel
+      #   Delivery channel. Use 'auto' for intelligent routing.
+      #
+      #   @return [Symbol, Zavudev::Models::Channel]
+      required :channel, enum: -> { Zavudev::Channel }
+
+      # @!attribute created_at
+      #
+      #   @return [Time]
+      required :created_at, Time, api_name: :createdAt
+
+      # @!attribute message_type
+      #   Type of message. Non-text types are supported by WhatsApp and Telegram (varies
+      #   by type).
+      #
+      #   @return [Symbol, Zavudev::Models::MessageType]
+      required :message_type, enum: -> { Zavudev::MessageType }, api_name: :messageType
+
+      # @!attribute status
+      #
+      #   @return [Symbol, Zavudev::Models::MessageStatus]
+      required :status, enum: -> { Zavudev::MessageStatus }
+
+      # @!attribute to
+      #
+      #   @return [String]
+      required :to, String
+
+      # @!attribute content
+      #   Content for non-text message types (WhatsApp and Telegram).
+      #
+      #   @return [Zavudev::Models::MessageContent, nil]
+      optional :content, -> { Zavudev::MessageContent }
+
+      # @!attribute cost
+      #   MAU cost in USD (charged for first contact of the month).
+      #
+      #   @return [Float, nil]
+      optional :cost, Float, nil?: true
+
+      # @!attribute cost_provider
+      #   Provider cost in USD (Telnyx, SES, etc.).
+      #
+      #   @return [Float, nil]
+      optional :cost_provider, Float, api_name: :costProvider, nil?: true
+
+      # @!attribute cost_total
+      #   Total cost in USD (MAU + provider cost).
+      #
+      #   @return [Float, nil]
+      optional :cost_total, Float, api_name: :costTotal, nil?: true
+
+      # @!attribute error_code
+      #
+      #   @return [String, nil]
+      optional :error_code, String, api_name: :errorCode, nil?: true
+
+      # @!attribute error_message
+      #
+      #   @return [String, nil]
+      optional :error_message, String, api_name: :errorMessage, nil?: true
+
+      # @!attribute from
+      #
+      #   @return [String, nil]
+      optional :from, String
+
+      # @!attribute metadata
+      #
+      #   @return [Hash{Symbol=>String}, nil]
+      optional :metadata, Zavudev::Internal::Type::HashOf[String]
+
+      # @!attribute provider_message_id
+      #   Message ID from the delivery provider.
+      #
+      #   @return [String, nil]
+      optional :provider_message_id, String, api_name: :providerMessageId
+
+      # @!attribute sender_id
+      #
+      #   @return [String, nil]
+      optional :sender_id, String, api_name: :senderId
+
+      # @!attribute text
+      #   Text content or caption.
+      #
+      #   @return [String, nil]
+      optional :text, String
+
+      # @!attribute updated_at
+      #
+      #   @return [Time, nil]
+      optional :updated_at, Time, api_name: :updatedAt
+
+      # @!method initialize(id:, channel:, created_at:, message_type:, status:, to:, content: nil, cost: nil, cost_provider: nil, cost_total: nil, error_code: nil, error_message: nil, from: nil, metadata: nil, provider_message_id: nil, sender_id: nil, text: nil, updated_at: nil)
+      #   Some parameter documentations has been truncated, see {Zavudev::Models::Message}
+      #   for more details.
+      #
+      #   @param id [String]
+      #
+      #   @param channel [Symbol, Zavudev::Models::Channel] Delivery channel. Use 'auto' for intelligent routing.
+      #
+      #   @param created_at [Time]
+      #
+      #   @param message_type [Symbol, Zavudev::Models::MessageType] Type of message. Non-text types are supported by WhatsApp and Telegram (varies b
+      #
+      #   @param status [Symbol, Zavudev::Models::MessageStatus]
+      #
+      #   @param to [String]
+      #
+      #   @param content [Zavudev::Models::MessageContent] Content for non-text message types (WhatsApp and Telegram).
+      #
+      #   @param cost [Float, nil] MAU cost in USD (charged for first contact of the month).
+      #
+      #   @param cost_provider [Float, nil] Provider cost in USD (Telnyx, SES, etc.).
+      #
+      #   @param cost_total [Float, nil] Total cost in USD (MAU + provider cost).
+      #
+      #   @param error_code [String, nil]
+      #
+      #   @param error_message [String, nil]
+      #
+      #   @param from [String]
+      #
+      #   @param metadata [Hash{Symbol=>String}]
+      #
+      #   @param provider_message_id [String] Message ID from the delivery provider.
+      #
+      #   @param sender_id [String]
+      #
+      #   @param text [String] Text content or caption.
+      #
+      #   @param updated_at [Time]
+    end
+  end
+end

data/lib/zavudev/models/message_content.rb

@@ -0,0 +1,208 @@
+# frozen_string_literal: true
+
+module Zavudev
+  module Models
+    class MessageContent < Zavudev::Internal::Type::BaseModel
+      # @!attribute buttons
+      #   Interactive buttons (max 3).
+      #
+      #   @return [Array<Zavudev::Models::MessageContent::Button>, nil]
+      optional :buttons, -> { Zavudev::Internal::Type::ArrayOf[Zavudev::MessageContent::Button] }
+
+      # @!attribute contacts
+      #   Contact cards for contact messages.
+      #
+      #   @return [Array<Zavudev::Models::MessageContent::Contact>, nil]
+      optional :contacts, -> { Zavudev::Internal::Type::ArrayOf[Zavudev::MessageContent::Contact] }
+
+      # @!attribute emoji
+      #   Emoji for reaction messages.
+      #
+      #   @return [String, nil]
+      optional :emoji, String
+
+      # @!attribute filename
+      #   Filename for documents.
+      #
+      #   @return [String, nil]
+      optional :filename, String
+
+      # @!attribute latitude
+      #   Latitude for location messages.
+      #
+      #   @return [Float, nil]
+      optional :latitude, Float
+
+      # @!attribute list_button
+      #   Button text for list messages.
+      #
+      #   @return [String, nil]
+      optional :list_button, String, api_name: :listButton
+
+      # @!attribute location_address
+      #   Address of the location.
+      #
+      #   @return [String, nil]
+      optional :location_address, String, api_name: :locationAddress
+
+      # @!attribute location_name
+      #   Name of the location.
+      #
+      #   @return [String, nil]
+      optional :location_name, String, api_name: :locationName
+
+      # @!attribute longitude
+      #   Longitude for location messages.
+      #
+      #   @return [Float, nil]
+      optional :longitude, Float
+
+      # @!attribute media_id
+      #   WhatsApp media ID if already uploaded.
+      #
+      #   @return [String, nil]
+      optional :media_id, String, api_name: :mediaId
+
+      # @!attribute media_url
+      #   URL of the media file (for image, video, audio, document, sticker).
+      #
+      #   @return [String, nil]
+      optional :media_url, String, api_name: :mediaUrl
+
+      # @!attribute mime_type
+      #   MIME type of the media.
+      #
+      #   @return [String, nil]
+      optional :mime_type, String, api_name: :mimeType
+
+      # @!attribute react_to_message_id
+      #   Message ID to react to.
+      #
+      #   @return [String, nil]
+      optional :react_to_message_id, String, api_name: :reactToMessageId
+
+      # @!attribute sections
+      #   Sections for list messages.
+      #
+      #   @return [Array<Zavudev::Models::MessageContent::Section>, nil]
+      optional :sections, -> { Zavudev::Internal::Type::ArrayOf[Zavudev::MessageContent::Section] }
+
+      # @!attribute template_id
+      #   Template ID for template messages.
+      #
+      #   @return [String, nil]
+      optional :template_id, String, api_name: :templateId
+
+      # @!attribute template_variables
+      #   Variables for template rendering. Keys are variable positions (1, 2, 3...).
+      #
+      #   @return [Hash{Symbol=>String}, nil]
+      optional :template_variables, Zavudev::Internal::Type::HashOf[String], api_name: :templateVariables
+
+      # @!method initialize(buttons: nil, contacts: nil, emoji: nil, filename: nil, latitude: nil, list_button: nil, location_address: nil, location_name: nil, longitude: nil, media_id: nil, media_url: nil, mime_type: nil, react_to_message_id: nil, sections: nil, template_id: nil, template_variables: nil)
+      #   Content for non-text message types (WhatsApp and Telegram).
+      #
+      #   @param buttons [Array<Zavudev::Models::MessageContent::Button>] Interactive buttons (max 3).
+      #
+      #   @param contacts [Array<Zavudev::Models::MessageContent::Contact>] Contact cards for contact messages.
+      #
+      #   @param emoji [String] Emoji for reaction messages.
+      #
+      #   @param filename [String] Filename for documents.
+      #
+      #   @param latitude [Float] Latitude for location messages.
+      #
+      #   @param list_button [String] Button text for list messages.
+      #
+      #   @param location_address [String] Address of the location.
+      #
+      #   @param location_name [String] Name of the location.
+      #
+      #   @param longitude [Float] Longitude for location messages.
+      #
+      #   @param media_id [String] WhatsApp media ID if already uploaded.
+      #
+      #   @param media_url [String] URL of the media file (for image, video, audio, document, sticker).
+      #
+      #   @param mime_type [String] MIME type of the media.
+      #
+      #   @param react_to_message_id [String] Message ID to react to.
+      #
+      #   @param sections [Array<Zavudev::Models::MessageContent::Section>] Sections for list messages.
+      #
+      #   @param template_id [String] Template ID for template messages.
+      #
+      #   @param template_variables [Hash{Symbol=>String}] Variables for template rendering. Keys are variable positions (1, 2, 3...).
+
+      class Button < Zavudev::Internal::Type::BaseModel
+        # @!attribute id
+        #
+        #   @return [String]
+        required :id, String
+
+        # @!attribute title
+        #
+        #   @return [String]
+        required :title, String
+
+        # @!method initialize(id:, title:)
+        #   @param id [String]
+        #   @param title [String]
+      end
+
+      class Contact < Zavudev::Internal::Type::BaseModel
+        # @!attribute name
+        #
+        #   @return [String, nil]
+        optional :name, String
+
+        # @!attribute phones
+        #
+        #   @return [Array<String>, nil]
+        optional :phones, Zavudev::Internal::Type::ArrayOf[String]
+
+        # @!method initialize(name: nil, phones: nil)
+        #   @param name [String]
+        #   @param phones [Array<String>]
+      end
+
+      class Section < Zavudev::Internal::Type::BaseModel
+        # @!attribute rows
+        #
+        #   @return [Array<Zavudev::Models::MessageContent::Section::Row>]
+        required :rows, -> { Zavudev::Internal::Type::ArrayOf[Zavudev::MessageContent::Section::Row] }
+
+        # @!attribute title
+        #
+        #   @return [String]
+        required :title, String
+
+        # @!method initialize(rows:, title:)
+        #   @param rows [Array<Zavudev::Models::MessageContent::Section::Row>]
+        #   @param title [String]
+
+        class Row < Zavudev::Internal::Type::BaseModel
+          # @!attribute id
+          #
+          #   @return [String]
+          required :id, String
+
+          # @!attribute title
+          #
+          #   @return [String]
+          required :title, String
+
+          # @!attribute description
+          #
+          #   @return [String, nil]
+          optional :description, String
+
+          # @!method initialize(id:, title:, description: nil)
+          #   @param id [String]
+          #   @param title [String]
+          #   @param description [String]
+        end
+      end
+    end
+  end
+end

data/lib/zavudev/models/message_list_params.rb

@@ -0,0 +1,50 @@
+# frozen_string_literal: true
+
+module Zavudev
+  module Models
+    # @see Zavudev::Resources::Messages#list
+    class MessageListParams < Zavudev::Internal::Type::BaseModel
+      extend Zavudev::Internal::Type::RequestParameters::Converter
+      include Zavudev::Internal::Type::RequestParameters
+
+      # @!attribute channel
+      #   Delivery channel. Use 'auto' for intelligent routing.
+      #
+      #   @return [Symbol, Zavudev::Models::Channel, nil]
+      optional :channel, enum: -> { Zavudev::Channel }
+
+      # @!attribute cursor
+      #
+      #   @return [String, nil]
+      optional :cursor, String
+
+      # @!attribute limit
+      #
+      #   @return [Integer, nil]
+      optional :limit, Integer
+
+      # @!attribute status
+      #
+      #   @return [Symbol, Zavudev::Models::MessageStatus, nil]
+      optional :status, enum: -> { Zavudev::MessageStatus }
+
+      # @!attribute to
+      #
+      #   @return [String, nil]
+      optional :to, String
+
+      # @!method initialize(channel: nil, cursor: nil, limit: nil, status: nil, to: nil, request_options: {})
+      #   @param channel [Symbol, Zavudev::Models::Channel] Delivery channel. Use 'auto' for intelligent routing.
+      #
+      #   @param cursor [String]
+      #
+      #   @param limit [Integer]
+      #
+      #   @param status [Symbol, Zavudev::Models::MessageStatus]
+      #
+      #   @param to [String]
+      #
+      #   @param request_options [Zavudev::RequestOptions, Hash{Symbol=>Object}]
+    end
+  end
+end

data/lib/zavudev/models/message_react_params.rb

@@ -0,0 +1,36 @@
+# frozen_string_literal: true
+
+module Zavudev
+  module Models
+    # @see Zavudev::Resources::Messages#react
+    class MessageReactParams < Zavudev::Internal::Type::BaseModel
+      extend Zavudev::Internal::Type::RequestParameters::Converter
+      include Zavudev::Internal::Type::RequestParameters
+
+      # @!attribute message_id
+      #
+      #   @return [String]
+      required :message_id, String
+
+      # @!attribute emoji
+      #   Single emoji character to react with.
+      #
+      #   @return [String]
+      required :emoji, String
+
+      # @!attribute zavu_sender
+      #
+      #   @return [String, nil]
+      optional :zavu_sender, String
+
+      # @!method initialize(message_id:, emoji:, zavu_sender: nil, request_options: {})
+      #   @param message_id [String]
+      #
+      #   @param emoji [String] Single emoji character to react with.
+      #
+      #   @param zavu_sender [String]
+      #
+      #   @param request_options [Zavudev::RequestOptions, Hash{Symbol=>Object}]
+    end
+  end
+end

data/lib/zavudev/models/message_response.rb

@@ -0,0 +1,16 @@
+# frozen_string_literal: true
+
+module Zavudev
+  module Models
+    # @see Zavudev::Resources::Messages#retrieve
+    class MessageResponse < Zavudev::Internal::Type::BaseModel
+      # @!attribute message
+      #
+      #   @return [Zavudev::Models::Message]
+      required :message, -> { Zavudev::Message }
+
+      # @!method initialize(message:)
+      #   @param message [Zavudev::Models::Message]
+    end
+  end
+end

data/lib/zavudev/models/message_retrieve_params.rb

@@ -0,0 +1,20 @@
+# frozen_string_literal: true
+
+module Zavudev
+  module Models
+    # @see Zavudev::Resources::Messages#retrieve
+    class MessageRetrieveParams < Zavudev::Internal::Type::BaseModel
+      extend Zavudev::Internal::Type::RequestParameters::Converter
+      include Zavudev::Internal::Type::RequestParameters
+
+      # @!attribute message_id
+      #
+      #   @return [String]
+      required :message_id, String
+
+      # @!method initialize(message_id:, request_options: {})
+      #   @param message_id [String]
+      #   @param request_options [Zavudev::RequestOptions, Hash{Symbol=>Object}]
+    end
+  end
+end