zavudev 0.0.2

data/rbi/zavudev/models/contact.rbi

@@ -0,0 +1,424 @@
+# typed: strong
+
+module Zavudev
+  module Models
+    class Contact < Zavudev::Internal::Type::BaseModel
+      OrHash =
+        T.type_alias { T.any(Zavudev::Contact, Zavudev::Internal::AnyHash) }
+
+      sig { returns(String) }
+      attr_accessor :id
+
+      # List of available messaging channels for this contact.
+      sig { returns(T::Array[String]) }
+      attr_accessor :available_channels
+
+      sig { returns(Time) }
+      attr_accessor :created_at
+
+      sig { returns(T::Hash[Symbol, String]) }
+      attr_accessor :metadata
+
+      # Whether this contact has been verified.
+      sig { returns(T::Boolean) }
+      attr_accessor :verified
+
+      # All communication channels for this contact.
+      sig { returns(T.nilable(T::Array[Zavudev::Contact::Channel])) }
+      attr_reader :channels
+
+      sig { params(channels: T::Array[Zavudev::Contact::Channel::OrHash]).void }
+      attr_writer :channels
+
+      sig { returns(T.nilable(String)) }
+      attr_reader :country_code
+
+      sig { params(country_code: String).void }
+      attr_writer :country_code
+
+      # Preferred channel for this contact.
+      sig { returns(T.nilable(Zavudev::Contact::DefaultChannel::TaggedSymbol)) }
+      attr_reader :default_channel
+
+      sig do
+        params(default_channel: Zavudev::Contact::DefaultChannel::OrSymbol).void
+      end
+      attr_writer :default_channel
+
+      # Display name for the contact.
+      sig { returns(T.nilable(String)) }
+      attr_reader :display_name
+
+      sig { params(display_name: String).void }
+      attr_writer :display_name
+
+      # DEPRECATED: Use primaryPhone instead. Primary phone number in E.164 format.
+      sig { returns(T.nilable(String)) }
+      attr_reader :phone_number
+
+      sig { params(phone_number: String).void }
+      attr_writer :phone_number
+
+      # Primary email address.
+      sig { returns(T.nilable(String)) }
+      attr_reader :primary_email
+
+      sig { params(primary_email: String).void }
+      attr_writer :primary_email
+
+      # Primary phone number in E.164 format.
+      sig { returns(T.nilable(String)) }
+      attr_reader :primary_phone
+
+      sig { params(primary_phone: String).void }
+      attr_writer :primary_phone
+
+      # Contact's WhatsApp profile name. Only available for WhatsApp contacts.
+      sig { returns(T.nilable(String)) }
+      attr_accessor :profile_name
+
+      # ID of a contact suggested for merging.
+      sig { returns(T.nilable(String)) }
+      attr_reader :suggested_merge_with
+
+      sig { params(suggested_merge_with: String).void }
+      attr_writer :suggested_merge_with
+
+      sig { returns(T.nilable(Time)) }
+      attr_reader :updated_at
+
+      sig { params(updated_at: Time).void }
+      attr_writer :updated_at
+
+      sig do
+        params(
+          id: String,
+          available_channels: T::Array[String],
+          created_at: Time,
+          metadata: T::Hash[Symbol, String],
+          verified: T::Boolean,
+          channels: T::Array[Zavudev::Contact::Channel::OrHash],
+          country_code: String,
+          default_channel: Zavudev::Contact::DefaultChannel::OrSymbol,
+          display_name: String,
+          phone_number: String,
+          primary_email: String,
+          primary_phone: String,
+          profile_name: T.nilable(String),
+          suggested_merge_with: String,
+          updated_at: Time
+        ).returns(T.attached_class)
+      end
+      def self.new(
+        id:,
+        # List of available messaging channels for this contact.
+        available_channels:,
+        created_at:,
+        metadata:,
+        # Whether this contact has been verified.
+        verified:,
+        # All communication channels for this contact.
+        channels: nil,
+        country_code: nil,
+        # Preferred channel for this contact.
+        default_channel: nil,
+        # Display name for the contact.
+        display_name: nil,
+        # DEPRECATED: Use primaryPhone instead. Primary phone number in E.164 format.
+        phone_number: nil,
+        # Primary email address.
+        primary_email: nil,
+        # Primary phone number in E.164 format.
+        primary_phone: nil,
+        # Contact's WhatsApp profile name. Only available for WhatsApp contacts.
+        profile_name: nil,
+        # ID of a contact suggested for merging.
+        suggested_merge_with: nil,
+        updated_at: nil
+      )
+      end
+
+      sig do
+        override.returns(
+          {
+            id: String,
+            available_channels: T::Array[String],
+            created_at: Time,
+            metadata: T::Hash[Symbol, String],
+            verified: T::Boolean,
+            channels: T::Array[Zavudev::Contact::Channel],
+            country_code: String,
+            default_channel: Zavudev::Contact::DefaultChannel::TaggedSymbol,
+            display_name: String,
+            phone_number: String,
+            primary_email: String,
+            primary_phone: String,
+            profile_name: T.nilable(String),
+            suggested_merge_with: String,
+            updated_at: Time
+          }
+        )
+      end
+      def to_hash
+      end
+
+      class Channel < Zavudev::Internal::Type::BaseModel
+        OrHash =
+          T.type_alias do
+            T.any(Zavudev::Contact::Channel, Zavudev::Internal::AnyHash)
+          end
+
+        sig { returns(String) }
+        attr_accessor :id
+
+        # Channel type.
+        sig { returns(Zavudev::Contact::Channel::Channel::TaggedSymbol) }
+        attr_accessor :channel
+
+        sig { returns(Time) }
+        attr_accessor :created_at
+
+        # Channel identifier (phone number or email address).
+        sig { returns(String) }
+        attr_accessor :identifier
+
+        # Whether this is the primary channel for its type.
+        sig { returns(T::Boolean) }
+        attr_accessor :is_primary
+
+        # Whether this channel has been verified.
+        sig { returns(T::Boolean) }
+        attr_accessor :verified
+
+        # ISO country code for phone numbers.
+        sig { returns(T.nilable(String)) }
+        attr_reader :country_code
+
+        sig { params(country_code: String).void }
+        attr_writer :country_code
+
+        # Optional label for the channel.
+        sig { returns(T.nilable(String)) }
+        attr_reader :label
+
+        sig { params(label: String).void }
+        attr_writer :label
+
+        # Last time a message was received on this channel.
+        sig { returns(T.nilable(Time)) }
+        attr_reader :last_inbound_at
+
+        sig { params(last_inbound_at: Time).void }
+        attr_writer :last_inbound_at
+
+        sig { returns(T.nilable(T::Hash[Symbol, String])) }
+        attr_reader :metadata
+
+        sig { params(metadata: T::Hash[Symbol, String]).void }
+        attr_writer :metadata
+
+        # Delivery metrics for this channel.
+        sig { returns(T.nilable(Zavudev::Contact::Channel::Metrics)) }
+        attr_reader :metrics
+
+        sig { params(metrics: Zavudev::Contact::Channel::Metrics::OrHash).void }
+        attr_writer :metrics
+
+        sig { returns(T.nilable(Time)) }
+        attr_reader :updated_at
+
+        sig { params(updated_at: Time).void }
+        attr_writer :updated_at
+
+        # A communication channel for a contact.
+        sig do
+          params(
+            id: String,
+            channel: Zavudev::Contact::Channel::Channel::OrSymbol,
+            created_at: Time,
+            identifier: String,
+            is_primary: T::Boolean,
+            verified: T::Boolean,
+            country_code: String,
+            label: String,
+            last_inbound_at: Time,
+            metadata: T::Hash[Symbol, String],
+            metrics: Zavudev::Contact::Channel::Metrics::OrHash,
+            updated_at: Time
+          ).returns(T.attached_class)
+        end
+        def self.new(
+          id:,
+          # Channel type.
+          channel:,
+          created_at:,
+          # Channel identifier (phone number or email address).
+          identifier:,
+          # Whether this is the primary channel for its type.
+          is_primary:,
+          # Whether this channel has been verified.
+          verified:,
+          # ISO country code for phone numbers.
+          country_code: nil,
+          # Optional label for the channel.
+          label: nil,
+          # Last time a message was received on this channel.
+          last_inbound_at: nil,
+          metadata: nil,
+          # Delivery metrics for this channel.
+          metrics: nil,
+          updated_at: nil
+        )
+        end
+
+        sig do
+          override.returns(
+            {
+              id: String,
+              channel: Zavudev::Contact::Channel::Channel::TaggedSymbol,
+              created_at: Time,
+              identifier: String,
+              is_primary: T::Boolean,
+              verified: T::Boolean,
+              country_code: String,
+              label: String,
+              last_inbound_at: Time,
+              metadata: T::Hash[Symbol, String],
+              metrics: Zavudev::Contact::Channel::Metrics,
+              updated_at: Time
+            }
+          )
+        end
+        def to_hash
+        end
+
+        # Channel type.
+        module Channel
+          extend Zavudev::Internal::Type::Enum
+
+          TaggedSymbol =
+            T.type_alias { T.all(Symbol, Zavudev::Contact::Channel::Channel) }
+          OrSymbol = T.type_alias { T.any(Symbol, String) }
+
+          SMS = T.let(:sms, Zavudev::Contact::Channel::Channel::TaggedSymbol)
+          WHATSAPP =
+            T.let(:whatsapp, Zavudev::Contact::Channel::Channel::TaggedSymbol)
+          EMAIL =
+            T.let(:email, Zavudev::Contact::Channel::Channel::TaggedSymbol)
+          TELEGRAM =
+            T.let(:telegram, Zavudev::Contact::Channel::Channel::TaggedSymbol)
+          VOICE =
+            T.let(:voice, Zavudev::Contact::Channel::Channel::TaggedSymbol)
+
+          sig do
+            override.returns(
+              T::Array[Zavudev::Contact::Channel::Channel::TaggedSymbol]
+            )
+          end
+          def self.values
+          end
+        end
+
+        class Metrics < Zavudev::Internal::Type::BaseModel
+          OrHash =
+            T.type_alias do
+              T.any(
+                Zavudev::Contact::Channel::Metrics,
+                Zavudev::Internal::AnyHash
+              )
+            end
+
+          sig { returns(T.nilable(Float)) }
+          attr_reader :avg_delivery_time_ms
+
+          sig { params(avg_delivery_time_ms: Float).void }
+          attr_writer :avg_delivery_time_ms
+
+          sig { returns(T.nilable(Integer)) }
+          attr_reader :failure_count
+
+          sig { params(failure_count: Integer).void }
+          attr_writer :failure_count
+
+          sig { returns(T.nilable(Time)) }
+          attr_reader :last_success_at
+
+          sig { params(last_success_at: Time).void }
+          attr_writer :last_success_at
+
+          sig { returns(T.nilable(Integer)) }
+          attr_reader :success_count
+
+          sig { params(success_count: Integer).void }
+          attr_writer :success_count
+
+          sig { returns(T.nilable(Integer)) }
+          attr_reader :total_attempts
+
+          sig { params(total_attempts: Integer).void }
+          attr_writer :total_attempts
+
+          # Delivery metrics for this channel.
+          sig do
+            params(
+              avg_delivery_time_ms: Float,
+              failure_count: Integer,
+              last_success_at: Time,
+              success_count: Integer,
+              total_attempts: Integer
+            ).returns(T.attached_class)
+          end
+          def self.new(
+            avg_delivery_time_ms: nil,
+            failure_count: nil,
+            last_success_at: nil,
+            success_count: nil,
+            total_attempts: nil
+          )
+          end
+
+          sig do
+            override.returns(
+              {
+                avg_delivery_time_ms: Float,
+                failure_count: Integer,
+                last_success_at: Time,
+                success_count: Integer,
+                total_attempts: Integer
+              }
+            )
+          end
+          def to_hash
+          end
+        end
+      end
+
+      # Preferred channel for this contact.
+      module DefaultChannel
+        extend Zavudev::Internal::Type::Enum
+
+        TaggedSymbol =
+          T.type_alias { T.all(Symbol, Zavudev::Contact::DefaultChannel) }
+        OrSymbol = T.type_alias { T.any(Symbol, String) }
+
+        SMS = T.let(:sms, Zavudev::Contact::DefaultChannel::TaggedSymbol)
+        WHATSAPP =
+          T.let(:whatsapp, Zavudev::Contact::DefaultChannel::TaggedSymbol)
+        TELEGRAM =
+          T.let(:telegram, Zavudev::Contact::DefaultChannel::TaggedSymbol)
+        EMAIL = T.let(:email, Zavudev::Contact::DefaultChannel::TaggedSymbol)
+        INSTAGRAM =
+          T.let(:instagram, Zavudev::Contact::DefaultChannel::TaggedSymbol)
+        VOICE = T.let(:voice, Zavudev::Contact::DefaultChannel::TaggedSymbol)
+
+        sig do
+          override.returns(
+            T::Array[Zavudev::Contact::DefaultChannel::TaggedSymbol]
+          )
+        end
+        def self.values
+        end
+      end
+    end
+  end
+end

data/rbi/zavudev/models/contact_list_params.rbi

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

data/rbi/zavudev/models/contact_retrieve_by_phone_params.rbi

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

data/rbi/zavudev/models/contact_retrieve_params.rbi

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

data/rbi/zavudev/models/contact_update_params.rbi

@@ -0,0 +1,114 @@
+# typed: strong
+
+module Zavudev
+  module Models
+    class ContactUpdateParams < Zavudev::Internal::Type::BaseModel
+      extend Zavudev::Internal::Type::RequestParameters::Converter
+      include Zavudev::Internal::Type::RequestParameters
+
+      OrHash =
+        T.type_alias do
+          T.any(Zavudev::ContactUpdateParams, Zavudev::Internal::AnyHash)
+        end
+
+      sig { returns(String) }
+      attr_accessor :contact_id
+
+      # Preferred channel for this contact. Set to null to clear.
+      sig do
+        returns(
+          T.nilable(Zavudev::ContactUpdateParams::DefaultChannel::OrSymbol)
+        )
+      end
+      attr_accessor :default_channel
+
+      sig { returns(T.nilable(T::Hash[Symbol, String])) }
+      attr_reader :metadata
+
+      sig { params(metadata: T::Hash[Symbol, String]).void }
+      attr_writer :metadata
+
+      sig do
+        params(
+          contact_id: String,
+          default_channel:
+            T.nilable(Zavudev::ContactUpdateParams::DefaultChannel::OrSymbol),
+          metadata: T::Hash[Symbol, String],
+          request_options: Zavudev::RequestOptions::OrHash
+        ).returns(T.attached_class)
+      end
+      def self.new(
+        contact_id:,
+        # Preferred channel for this contact. Set to null to clear.
+        default_channel: nil,
+        metadata: nil,
+        request_options: {}
+      )
+      end
+
+      sig do
+        override.returns(
+          {
+            contact_id: String,
+            default_channel:
+              T.nilable(Zavudev::ContactUpdateParams::DefaultChannel::OrSymbol),
+            metadata: T::Hash[Symbol, String],
+            request_options: Zavudev::RequestOptions
+          }
+        )
+      end
+      def to_hash
+      end
+
+      # Preferred channel for this contact. Set to null to clear.
+      module DefaultChannel
+        extend Zavudev::Internal::Type::Enum
+
+        TaggedSymbol =
+          T.type_alias do
+            T.all(Symbol, Zavudev::ContactUpdateParams::DefaultChannel)
+          end
+        OrSymbol = T.type_alias { T.any(Symbol, String) }
+
+        SMS =
+          T.let(
+            :sms,
+            Zavudev::ContactUpdateParams::DefaultChannel::TaggedSymbol
+          )
+        WHATSAPP =
+          T.let(
+            :whatsapp,
+            Zavudev::ContactUpdateParams::DefaultChannel::TaggedSymbol
+          )
+        TELEGRAM =
+          T.let(
+            :telegram,
+            Zavudev::ContactUpdateParams::DefaultChannel::TaggedSymbol
+          )
+        EMAIL =
+          T.let(
+            :email,
+            Zavudev::ContactUpdateParams::DefaultChannel::TaggedSymbol
+          )
+        INSTAGRAM =
+          T.let(
+            :instagram,
+            Zavudev::ContactUpdateParams::DefaultChannel::TaggedSymbol
+          )
+        VOICE =
+          T.let(
+            :voice,
+            Zavudev::ContactUpdateParams::DefaultChannel::TaggedSymbol
+          )
+
+        sig do
+          override.returns(
+            T::Array[Zavudev::ContactUpdateParams::DefaultChannel::TaggedSymbol]
+          )
+        end
+        def self.values
+        end
+      end
+    end
+  end
+end

data/rbi/zavudev/models/introspect_validate_phone_params.rbi

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