zavudev 0.0.2

data/lib/zavudev/internal.rb

@@ -0,0 +1,20 @@
+# frozen_string_literal: true
+
+module Zavudev
+  module Internal
+    extend Zavudev::Internal::Util::SorbetRuntimeSupport
+
+    OMIT =
+      Object.new.tap do
+        _1.define_singleton_method(:inspect) { "#<#{Zavudev::Internal}::OMIT>" }
+      end
+        .freeze
+
+    define_sorbet_constant!(:AnyHash) do
+      T.type_alias { T::Hash[Symbol, T.anything] }
+    end
+    define_sorbet_constant!(:FileInput) do
+      T.type_alias { T.any(Pathname, StringIO, IO, String, Zavudev::FilePart) }
+    end
+  end
+end

data/lib/zavudev/models/address.rb

@@ -0,0 +1,90 @@
+# frozen_string_literal: true
+
+module Zavudev
+  module Models
+    # @see Zavudev::Resources::Addresses#list
+    class Address < Zavudev::Internal::Type::BaseModel
+      # @!attribute id
+      #
+      #   @return [String]
+      required :id, String
+
+      # @!attribute country_code
+      #
+      #   @return [String]
+      required :country_code, String, api_name: :countryCode
+
+      # @!attribute created_at
+      #
+      #   @return [Time]
+      required :created_at, Time, api_name: :createdAt
+
+      # @!attribute locality
+      #
+      #   @return [String]
+      required :locality, String
+
+      # @!attribute postal_code
+      #
+      #   @return [String]
+      required :postal_code, String, api_name: :postalCode
+
+      # @!attribute status
+      #
+      #   @return [Symbol, Zavudev::Models::AddressStatus]
+      required :status, enum: -> { Zavudev::AddressStatus }
+
+      # @!attribute street_address
+      #
+      #   @return [String]
+      required :street_address, String, api_name: :streetAddress
+
+      # @!attribute administrative_area
+      #
+      #   @return [String, nil]
+      optional :administrative_area, String, api_name: :administrativeArea, nil?: true
+
+      # @!attribute business_name
+      #
+      #   @return [String, nil]
+      optional :business_name, String, api_name: :businessName, nil?: true
+
+      # @!attribute extended_address
+      #
+      #   @return [String, nil]
+      optional :extended_address, String, api_name: :extendedAddress, nil?: true
+
+      # @!attribute first_name
+      #
+      #   @return [String, nil]
+      optional :first_name, String, api_name: :firstName, nil?: true
+
+      # @!attribute last_name
+      #
+      #   @return [String, nil]
+      optional :last_name, String, api_name: :lastName, nil?: true
+
+      # @!attribute updated_at
+      #
+      #   @return [Time, nil]
+      optional :updated_at, Time, api_name: :updatedAt
+
+      # @!method initialize(id:, country_code:, created_at:, locality:, postal_code:, status:, street_address:, administrative_area: nil, business_name: nil, extended_address: nil, first_name: nil, last_name: nil, updated_at: nil)
+      #   A regulatory address for phone number requirements.
+      #
+      #   @param id [String]
+      #   @param country_code [String]
+      #   @param created_at [Time]
+      #   @param locality [String]
+      #   @param postal_code [String]
+      #   @param status [Symbol, Zavudev::Models::AddressStatus]
+      #   @param street_address [String]
+      #   @param administrative_area [String, nil]
+      #   @param business_name [String, nil]
+      #   @param extended_address [String, nil]
+      #   @param first_name [String, nil]
+      #   @param last_name [String, nil]
+      #   @param updated_at [Time]
+    end
+  end
+end

data/lib/zavudev/models/address_create_params.rb

@@ -0,0 +1,68 @@
+# frozen_string_literal: true
+
+module Zavudev
+  module Models
+    # @see Zavudev::Resources::Addresses#create
+    class AddressCreateParams < Zavudev::Internal::Type::BaseModel
+      extend Zavudev::Internal::Type::RequestParameters::Converter
+      include Zavudev::Internal::Type::RequestParameters
+
+      # @!attribute country_code
+      #
+      #   @return [String]
+      required :country_code, String, api_name: :countryCode
+
+      # @!attribute locality
+      #
+      #   @return [String]
+      required :locality, String
+
+      # @!attribute postal_code
+      #
+      #   @return [String]
+      required :postal_code, String, api_name: :postalCode
+
+      # @!attribute street_address
+      #
+      #   @return [String]
+      required :street_address, String, api_name: :streetAddress
+
+      # @!attribute administrative_area
+      #
+      #   @return [String, nil]
+      optional :administrative_area, String, api_name: :administrativeArea
+
+      # @!attribute business_name
+      #
+      #   @return [String, nil]
+      optional :business_name, String, api_name: :businessName
+
+      # @!attribute extended_address
+      #
+      #   @return [String, nil]
+      optional :extended_address, String, api_name: :extendedAddress
+
+      # @!attribute first_name
+      #
+      #   @return [String, nil]
+      optional :first_name, String, api_name: :firstName
+
+      # @!attribute last_name
+      #
+      #   @return [String, nil]
+      optional :last_name, String, api_name: :lastName
+
+      # @!method initialize(country_code:, locality:, postal_code:, street_address:, administrative_area: nil, business_name: nil, extended_address: nil, first_name: nil, last_name: nil, request_options: {})
+      #   @param country_code [String]
+      #   @param locality [String]
+      #   @param postal_code [String]
+      #   @param street_address [String]
+      #   @param administrative_area [String]
+      #   @param business_name [String]
+      #   @param extended_address [String]
+      #   @param first_name [String]
+      #   @param last_name [String]
+      #   @param request_options [Zavudev::RequestOptions, Hash{Symbol=>Object}]
+    end
+  end
+end

data/lib/zavudev/models/address_create_response.rb

@@ -0,0 +1,17 @@
+# frozen_string_literal: true
+
+module Zavudev
+  module Models
+    # @see Zavudev::Resources::Addresses#create
+    class AddressCreateResponse < Zavudev::Internal::Type::BaseModel
+      # @!attribute address
+      #   A regulatory address for phone number requirements.
+      #
+      #   @return [Zavudev::Models::Address]
+      required :address, -> { Zavudev::Address }
+
+      # @!method initialize(address:)
+      #   @param address [Zavudev::Models::Address] A regulatory address for phone number requirements.
+    end
+  end
+end

data/lib/zavudev/models/address_delete_params.rb

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

data/lib/zavudev/models/address_list_params.rb

@@ -0,0 +1,26 @@
+# frozen_string_literal: true
+
+module Zavudev
+  module Models
+    # @see Zavudev::Resources::Addresses#list
+    class AddressListParams < Zavudev::Internal::Type::BaseModel
+      extend Zavudev::Internal::Type::RequestParameters::Converter
+      include Zavudev::Internal::Type::RequestParameters
+
+      # @!attribute cursor
+      #
+      #   @return [String, nil]
+      optional :cursor, String
+
+      # @!attribute limit
+      #
+      #   @return [Integer, nil]
+      optional :limit, Integer
+
+      # @!method initialize(cursor: nil, limit: nil, request_options: {})
+      #   @param cursor [String]
+      #   @param limit [Integer]
+      #   @param request_options [Zavudev::RequestOptions, Hash{Symbol=>Object}]
+    end
+  end
+end

data/lib/zavudev/models/address_retrieve_params.rb

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

data/lib/zavudev/models/address_retrieve_response.rb

@@ -0,0 +1,17 @@
+# frozen_string_literal: true
+
+module Zavudev
+  module Models
+    # @see Zavudev::Resources::Addresses#retrieve
+    class AddressRetrieveResponse < Zavudev::Internal::Type::BaseModel
+      # @!attribute address
+      #   A regulatory address for phone number requirements.
+      #
+      #   @return [Zavudev::Models::Address]
+      required :address, -> { Zavudev::Address }
+
+      # @!method initialize(address:)
+      #   @param address [Zavudev::Models::Address] A regulatory address for phone number requirements.
+    end
+  end
+end

data/lib/zavudev/models/address_status.rb

@@ -0,0 +1,16 @@
+# frozen_string_literal: true
+
+module Zavudev
+  module Models
+    module AddressStatus
+      extend Zavudev::Internal::Type::Enum
+
+      PENDING = :pending
+      VERIFIED = :verified
+      REJECTED = :rejected
+
+      # @!method self.values
+      #   @return [Array<Symbol>]
+    end
+  end
+end

data/lib/zavudev/models/available_phone_number.rb

@@ -0,0 +1,45 @@
+# frozen_string_literal: true
+
+module Zavudev
+  module Models
+    class AvailablePhoneNumber < Zavudev::Internal::Type::BaseModel
+      # @!attribute capabilities
+      #
+      #   @return [Zavudev::Models::PhoneNumberCapabilities]
+      required :capabilities, -> { Zavudev::PhoneNumberCapabilities }
+
+      # @!attribute phone_number
+      #
+      #   @return [String]
+      required :phone_number, String, api_name: :phoneNumber
+
+      # @!attribute pricing
+      #
+      #   @return [Zavudev::Models::PhoneNumberPricing]
+      required :pricing, -> { Zavudev::PhoneNumberPricing }
+
+      # @!attribute friendly_name
+      #
+      #   @return [String, nil]
+      optional :friendly_name, String, api_name: :friendlyName
+
+      # @!attribute locality
+      #
+      #   @return [String, nil]
+      optional :locality, String
+
+      # @!attribute region
+      #
+      #   @return [String, nil]
+      optional :region, String
+
+      # @!method initialize(capabilities:, phone_number:, pricing:, friendly_name: nil, locality: nil, region: nil)
+      #   @param capabilities [Zavudev::Models::PhoneNumberCapabilities]
+      #   @param phone_number [String]
+      #   @param pricing [Zavudev::Models::PhoneNumberPricing]
+      #   @param friendly_name [String]
+      #   @param locality [String]
+      #   @param region [String]
+    end
+  end
+end

data/lib/zavudev/models/broadcast.rb

@@ -0,0 +1,242 @@
+# frozen_string_literal: true
+
+module Zavudev
+  module Models
+    # @see Zavudev::Resources::Broadcasts#list
+    class Broadcast < Zavudev::Internal::Type::BaseModel
+      # @!attribute id
+      #
+      #   @return [String]
+      required :id, String
+
+      # @!attribute channel
+      #   Broadcast delivery channel. Use 'smart' for per-contact intelligent routing.
+      #
+      #   @return [Symbol, Zavudev::Models::BroadcastChannel]
+      required :channel, enum: -> { Zavudev::BroadcastChannel }
+
+      # @!attribute created_at
+      #
+      #   @return [Time]
+      required :created_at, Time, api_name: :createdAt
+
+      # @!attribute message_type
+      #   Type of message for broadcast.
+      #
+      #   @return [Symbol, Zavudev::Models::BroadcastMessageType]
+      required :message_type, enum: -> { Zavudev::BroadcastMessageType }, api_name: :messageType
+
+      # @!attribute name
+      #
+      #   @return [String]
+      required :name, String
+
+      # @!attribute status
+      #   Current status of the broadcast.
+      #
+      #   @return [Symbol, Zavudev::Models::BroadcastStatus]
+      required :status, enum: -> { Zavudev::BroadcastStatus }
+
+      # @!attribute total_contacts
+      #   Total number of contacts in the broadcast.
+      #
+      #   @return [Integer]
+      required :total_contacts, Integer, api_name: :totalContacts
+
+      # @!attribute actual_cost
+      #   Actual cost so far in USD.
+      #
+      #   @return [Float, nil]
+      optional :actual_cost, Float, api_name: :actualCost, nil?: true
+
+      # @!attribute completed_at
+      #
+      #   @return [Time, nil]
+      optional :completed_at, Time, api_name: :completedAt
+
+      # @!attribute content
+      #   Content for non-text broadcast message types.
+      #
+      #   @return [Zavudev::Models::BroadcastContent, nil]
+      optional :content, -> { Zavudev::BroadcastContent }
+
+      # @!attribute delivered_count
+      #
+      #   @return [Integer, nil]
+      optional :delivered_count, Integer, api_name: :deliveredCount
+
+      # @!attribute email_subject
+      #
+      #   @return [String, nil]
+      optional :email_subject, String, api_name: :emailSubject
+
+      # @!attribute estimated_cost
+      #   Estimated total cost in USD.
+      #
+      #   @return [Float, nil]
+      optional :estimated_cost, Float, api_name: :estimatedCost, nil?: true
+
+      # @!attribute failed_count
+      #
+      #   @return [Integer, nil]
+      optional :failed_count, Integer, api_name: :failedCount
+
+      # @!attribute metadata
+      #
+      #   @return [Hash{Symbol=>String}, nil]
+      optional :metadata, Zavudev::Internal::Type::HashOf[String]
+
+      # @!attribute pending_count
+      #
+      #   @return [Integer, nil]
+      optional :pending_count, Integer, api_name: :pendingCount
+
+      # @!attribute reserved_amount
+      #   Amount reserved from balance in USD.
+      #
+      #   @return [Float, nil]
+      optional :reserved_amount, Float, api_name: :reservedAmount, nil?: true
+
+      # @!attribute review_attempts
+      #   Number of review attempts (max 3).
+      #
+      #   @return [Integer, nil]
+      optional :review_attempts, Integer, api_name: :reviewAttempts, nil?: true
+
+      # @!attribute review_result
+      #   AI content review result.
+      #
+      #   @return [Zavudev::Models::Broadcast::ReviewResult, nil]
+      optional :review_result, -> { Zavudev::Broadcast::ReviewResult }, api_name: :reviewResult, nil?: true
+
+      # @!attribute scheduled_at
+      #
+      #   @return [Time, nil]
+      optional :scheduled_at, Time, api_name: :scheduledAt
+
+      # @!attribute sender_id
+      #
+      #   @return [String, nil]
+      optional :sender_id, String, api_name: :senderId
+
+      # @!attribute sending_count
+      #
+      #   @return [Integer, nil]
+      optional :sending_count, Integer, api_name: :sendingCount
+
+      # @!attribute started_at
+      #
+      #   @return [Time, nil]
+      optional :started_at, Time, api_name: :startedAt
+
+      # @!attribute text
+      #
+      #   @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:, name:, status:, total_contacts:, actual_cost: nil, completed_at: nil, content: nil, delivered_count: nil, email_subject: nil, estimated_cost: nil, failed_count: nil, metadata: nil, pending_count: nil, reserved_amount: nil, review_attempts: nil, review_result: nil, scheduled_at: nil, sender_id: nil, sending_count: nil, started_at: nil, text: nil, updated_at: nil)
+      #   @param id [String]
+      #
+      #   @param channel [Symbol, Zavudev::Models::BroadcastChannel] Broadcast delivery channel. Use 'smart' for per-contact intelligent routing.
+      #
+      #   @param created_at [Time]
+      #
+      #   @param message_type [Symbol, Zavudev::Models::BroadcastMessageType] Type of message for broadcast.
+      #
+      #   @param name [String]
+      #
+      #   @param status [Symbol, Zavudev::Models::BroadcastStatus] Current status of the broadcast.
+      #
+      #   @param total_contacts [Integer] Total number of contacts in the broadcast.
+      #
+      #   @param actual_cost [Float, nil] Actual cost so far in USD.
+      #
+      #   @param completed_at [Time]
+      #
+      #   @param content [Zavudev::Models::BroadcastContent] Content for non-text broadcast message types.
+      #
+      #   @param delivered_count [Integer]
+      #
+      #   @param email_subject [String]
+      #
+      #   @param estimated_cost [Float, nil] Estimated total cost in USD.
+      #
+      #   @param failed_count [Integer]
+      #
+      #   @param metadata [Hash{Symbol=>String}]
+      #
+      #   @param pending_count [Integer]
+      #
+      #   @param reserved_amount [Float, nil] Amount reserved from balance in USD.
+      #
+      #   @param review_attempts [Integer, nil] Number of review attempts (max 3).
+      #
+      #   @param review_result [Zavudev::Models::Broadcast::ReviewResult, nil] AI content review result.
+      #
+      #   @param scheduled_at [Time]
+      #
+      #   @param sender_id [String]
+      #
+      #   @param sending_count [Integer]
+      #
+      #   @param started_at [Time]
+      #
+      #   @param text [String]
+      #
+      #   @param updated_at [Time]
+
+      # @see Zavudev::Models::Broadcast#review_result
+      class ReviewResult < Zavudev::Internal::Type::BaseModel
+        # @!attribute categories
+        #   Policy categories violated, if any.
+        #
+        #   @return [Array<String>, nil]
+        optional :categories, Zavudev::Internal::Type::ArrayOf[String]
+
+        # @!attribute flagged_content
+        #   Problematic text fragments, if any.
+        #
+        #   @return [Array<String>, nil]
+        optional :flagged_content,
+                 Zavudev::Internal::Type::ArrayOf[String],
+                 api_name: :flaggedContent,
+                 nil?: true
+
+        # @!attribute reasoning
+        #   Explanation of the review decision.
+        #
+        #   @return [String, nil]
+        optional :reasoning, String
+
+        # @!attribute reviewed_at
+        #
+        #   @return [Time, nil]
+        optional :reviewed_at, Time, api_name: :reviewedAt
+
+        # @!attribute score
+        #   Content safety score from 0.0 to 1.0, where 1.0 is completely safe.
+        #
+        #   @return [Float, nil]
+        optional :score, Float
+
+        # @!method initialize(categories: nil, flagged_content: nil, reasoning: nil, reviewed_at: nil, score: nil)
+        #   AI content review result.
+        #
+        #   @param categories [Array<String>] Policy categories violated, if any.
+        #
+        #   @param flagged_content [Array<String>, nil] Problematic text fragments, if any.
+        #
+        #   @param reasoning [String] Explanation of the review decision.
+        #
+        #   @param reviewed_at [Time]
+        #
+        #   @param score [Float] Content safety score from 0.0 to 1.0, where 1.0 is completely safe.
+      end
+    end
+  end
+end

data/lib/zavudev/models/broadcast_cancel_params.rb

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

data/lib/zavudev/models/broadcast_cancel_response.rb

@@ -0,0 +1,16 @@
+# frozen_string_literal: true
+
+module Zavudev
+  module Models
+    # @see Zavudev::Resources::Broadcasts#cancel
+    class BroadcastCancelResponse < Zavudev::Internal::Type::BaseModel
+      # @!attribute broadcast
+      #
+      #   @return [Zavudev::Models::Broadcast]
+      required :broadcast, -> { Zavudev::Broadcast }
+
+      # @!method initialize(broadcast:)
+      #   @param broadcast [Zavudev::Models::Broadcast]
+    end
+  end
+end

data/lib/zavudev/models/broadcast_channel.rb

@@ -0,0 +1,22 @@
+# frozen_string_literal: true
+
+module Zavudev
+  module Models
+    # Broadcast delivery channel. Use 'smart' for per-contact intelligent routing.
+    module BroadcastChannel
+      extend Zavudev::Internal::Type::Enum
+
+      SMART = :smart
+      SMS = :sms
+      SMS_ONEWAY = :sms_oneway
+      WHATSAPP = :whatsapp
+      TELEGRAM = :telegram
+      EMAIL = :email
+      INSTAGRAM = :instagram
+      VOICE = :voice
+
+      # @!method self.values
+      #   @return [Array<Symbol>]
+    end
+  end
+end