revox 0.2.0 → 0.4.0

data/rbi/revox/models/campaign_update_params.rbi

@@ -0,0 +1,313 @@
+# typed: strong
+
+module Revox
+  module Models
+    class CampaignUpdateParams < Revox::Internal::Type::BaseModel
+      extend Revox::Internal::Type::RequestParameters::Converter
+      include Revox::Internal::Type::RequestParameters
+
+      OrHash =
+        T.type_alias do
+          T.any(Revox::CampaignUpdateParams, Revox::Internal::AnyHash)
+        end
+
+      sig { returns(String) }
+      attr_accessor :id
+
+      # Configuration for call retry behavior including time windows, delays, and max
+      # iterations. If not provided, defaults will be used.
+      sig { returns(T.nilable(Revox::CampaignUpdateParams::CallRetryConfig)) }
+      attr_reader :call_retry_config
+
+      sig do
+        params(
+          call_retry_config:
+            T.nilable(Revox::CampaignUpdateParams::CallRetryConfig::OrHash)
+        ).void
+      end
+      attr_writer :call_retry_config
+
+      # The phone number to use for outbound calls. Editable after launch; applied to
+      # the campaign's calls that have not completed yet.
+      sig { returns(T.nilable(String)) }
+      attr_accessor :from_phone_number
+
+      # Maximum concurrent calls. Editable after launch.
+      sig { returns(T.nilable(Float)) }
+      attr_accessor :max_concurrent_calls
+
+      # Campaign display name
+      sig { returns(T.nilable(String)) }
+      attr_reader :name
+
+      sig { params(name: String).void }
+      attr_writer :name
+
+      sig do
+        params(
+          id: String,
+          call_retry_config:
+            T.nilable(Revox::CampaignUpdateParams::CallRetryConfig::OrHash),
+          from_phone_number: T.nilable(String),
+          max_concurrent_calls: T.nilable(Float),
+          name: String,
+          request_options: Revox::RequestOptions::OrHash
+        ).returns(T.attached_class)
+      end
+      def self.new(
+        id:,
+        # Configuration for call retry behavior including time windows, delays, and max
+        # iterations. If not provided, defaults will be used.
+        call_retry_config: nil,
+        # The phone number to use for outbound calls. Editable after launch; applied to
+        # the campaign's calls that have not completed yet.
+        from_phone_number: nil,
+        # Maximum concurrent calls. Editable after launch.
+        max_concurrent_calls: nil,
+        # Campaign display name
+        name: nil,
+        request_options: {}
+      )
+      end
+
+      sig do
+        override.returns(
+          {
+            id: String,
+            call_retry_config:
+              T.nilable(Revox::CampaignUpdateParams::CallRetryConfig),
+            from_phone_number: T.nilable(String),
+            max_concurrent_calls: T.nilable(Float),
+            name: String,
+            request_options: Revox::RequestOptions
+          }
+        )
+      end
+      def to_hash
+      end
+
+      class CallRetryConfig < Revox::Internal::Type::BaseModel
+        OrHash =
+          T.type_alias do
+            T.any(
+              Revox::CampaignUpdateParams::CallRetryConfig,
+              Revox::Internal::AnyHash
+            )
+          end
+
+        # Days of the week when calls are allowed, in the recipient's timezone. Default:
+        # Monday through Friday.
+        sig do
+          returns(
+            T::Array[
+              Revox::CampaignUpdateParams::CallRetryConfig::AllowedDay::OrSymbol
+            ]
+          )
+        end
+        attr_accessor :allowed_days
+
+        # If true and max_retry_attempts >= 2, attempt #2 fires immediately (skipping
+        # retry_delay_seconds) when attempt #1 didn't reach a human.
+        # Calling-window/allowed-days checks still apply. Only affects the 1→2 transition.
+        # Default: false.
+        sig { returns(T::Boolean) }
+        attr_accessor :call_twice_in_a_row
+
+        sig do
+          returns(
+            T::Array[
+              Revox::CampaignUpdateParams::CallRetryConfig::CallingWindow
+            ]
+          )
+        end
+        attr_accessor :calling_windows
+
+        # Maximum number of call retry attempts. Default: 3.
+        sig { returns(Integer) }
+        attr_accessor :max_retry_attempts
+
+        # Optional IANA timezone identifier to override the automatic timezone detection
+        # from phone number. If not provided, timezone is determined from the recipient's
+        # phone number country code. Examples: 'America/New_York', 'Europe/Paris'.
+        sig { returns(T.nilable(String)) }
+        attr_accessor :timezone
+
+        # Configuration for call retry behavior including time windows, delays, and max
+        # iterations. If not provided, defaults will be used.
+        sig do
+          params(
+            allowed_days:
+              T::Array[
+                Revox::CampaignUpdateParams::CallRetryConfig::AllowedDay::OrSymbol
+              ],
+            call_twice_in_a_row: T::Boolean,
+            calling_windows:
+              T::Array[
+                Revox::CampaignUpdateParams::CallRetryConfig::CallingWindow::OrHash
+              ],
+            max_retry_attempts: Integer,
+            timezone: T.nilable(String)
+          ).returns(T.attached_class)
+        end
+        def self.new(
+          # Days of the week when calls are allowed, in the recipient's timezone. Default:
+          # Monday through Friday.
+          allowed_days:,
+          # If true and max_retry_attempts >= 2, attempt #2 fires immediately (skipping
+          # retry_delay_seconds) when attempt #1 didn't reach a human.
+          # Calling-window/allowed-days checks still apply. Only affects the 1→2 transition.
+          # Default: false.
+          call_twice_in_a_row:,
+          calling_windows:,
+          # Maximum number of call retry attempts. Default: 3.
+          max_retry_attempts:,
+          # Optional IANA timezone identifier to override the automatic timezone detection
+          # from phone number. If not provided, timezone is determined from the recipient's
+          # phone number country code. Examples: 'America/New_York', 'Europe/Paris'.
+          timezone: nil
+        )
+        end
+
+        sig do
+          override.returns(
+            {
+              allowed_days:
+                T::Array[
+                  Revox::CampaignUpdateParams::CallRetryConfig::AllowedDay::OrSymbol
+                ],
+              call_twice_in_a_row: T::Boolean,
+              calling_windows:
+                T::Array[
+                  Revox::CampaignUpdateParams::CallRetryConfig::CallingWindow
+                ],
+              max_retry_attempts: Integer,
+              timezone: T.nilable(String)
+            }
+          )
+        end
+        def to_hash
+        end
+
+        module AllowedDay
+          extend Revox::Internal::Type::Enum
+
+          TaggedSymbol =
+            T.type_alias do
+              T.all(
+                Symbol,
+                Revox::CampaignUpdateParams::CallRetryConfig::AllowedDay
+              )
+            end
+          OrSymbol = T.type_alias { T.any(Symbol, String) }
+
+          MONDAY =
+            T.let(
+              :monday,
+              Revox::CampaignUpdateParams::CallRetryConfig::AllowedDay::TaggedSymbol
+            )
+          TUESDAY =
+            T.let(
+              :tuesday,
+              Revox::CampaignUpdateParams::CallRetryConfig::AllowedDay::TaggedSymbol
+            )
+          WEDNESDAY =
+            T.let(
+              :wednesday,
+              Revox::CampaignUpdateParams::CallRetryConfig::AllowedDay::TaggedSymbol
+            )
+          THURSDAY =
+            T.let(
+              :thursday,
+              Revox::CampaignUpdateParams::CallRetryConfig::AllowedDay::TaggedSymbol
+            )
+          FRIDAY =
+            T.let(
+              :friday,
+              Revox::CampaignUpdateParams::CallRetryConfig::AllowedDay::TaggedSymbol
+            )
+          SATURDAY =
+            T.let(
+              :saturday,
+              Revox::CampaignUpdateParams::CallRetryConfig::AllowedDay::TaggedSymbol
+            )
+          SUNDAY =
+            T.let(
+              :sunday,
+              Revox::CampaignUpdateParams::CallRetryConfig::AllowedDay::TaggedSymbol
+            )
+
+          sig do
+            override.returns(
+              T::Array[
+                Revox::CampaignUpdateParams::CallRetryConfig::AllowedDay::TaggedSymbol
+              ]
+            )
+          end
+          def self.values
+          end
+        end
+
+        class CallingWindow < Revox::Internal::Type::BaseModel
+          OrHash =
+            T.type_alias do
+              T.any(
+                Revox::CampaignUpdateParams::CallRetryConfig::CallingWindow,
+                Revox::Internal::AnyHash
+              )
+            end
+
+          # End time for the calling window in the recipient's timezone (or
+          # timezone_override if provided). Format: 'HH:mm' (24-hour) or 'H:mma' (12-hour).
+          # Examples: '17:00', '6pm'. Default: '18:00'.
+          sig { returns(String) }
+          attr_accessor :calling_window_end_time
+
+          # Start time for the calling window in the recipient's timezone (or
+          # timezone_override if provided). Format: 'HH:mm' (24-hour) or 'H:mma' (12-hour).
+          # Examples: '09:00', '10am'. Default: '10:00'.
+          sig { returns(String) }
+          attr_accessor :calling_window_start_time
+
+          # Delay between retry attempts in seconds. 0 retries as soon as the calling window
+          # allows. Default: 7200 (2 hours).
+          sig { returns(Integer) }
+          attr_accessor :retry_delay_seconds
+
+          sig do
+            params(
+              calling_window_end_time: String,
+              calling_window_start_time: String,
+              retry_delay_seconds: Integer
+            ).returns(T.attached_class)
+          end
+          def self.new(
+            # End time for the calling window in the recipient's timezone (or
+            # timezone_override if provided). Format: 'HH:mm' (24-hour) or 'H:mma' (12-hour).
+            # Examples: '17:00', '6pm'. Default: '18:00'.
+            calling_window_end_time:,
+            # Start time for the calling window in the recipient's timezone (or
+            # timezone_override if provided). Format: 'HH:mm' (24-hour) or 'H:mma' (12-hour).
+            # Examples: '09:00', '10am'. Default: '10:00'.
+            calling_window_start_time:,
+            # Delay between retry attempts in seconds. 0 retries as soon as the calling window
+            # allows. Default: 7200 (2 hours).
+            retry_delay_seconds:
+          )
+          end
+
+          sig do
+            override.returns(
+              {
+                calling_window_end_time: String,
+                calling_window_start_time: String,
+                retry_delay_seconds: Integer
+              }
+            )
+          end
+          def to_hash
+          end
+        end
+      end
+    end
+  end
+end