sentdm 0.34.0 → 0.35.0

data/rbi/sentdm/models/channels/voice_update_params.rbi

@@ -0,0 +1,158 @@
+# typed: strong
+
+module Sentdm
+  module Models
+    module Channels
+      class VoiceUpdateParams < Sentdm::Internal::Type::BaseModel
+        extend Sentdm::Internal::Type::RequestParameters::Converter
+        include Sentdm::Internal::Type::RequestParameters
+
+        OrHash =
+          T.type_alias do
+            T.any(
+              Sentdm::Channels::VoiceUpdateParams,
+              Sentdm::Internal::AnyHash
+            )
+          end
+
+        sig { returns(String) }
+        attr_accessor :number
+
+        # A new callback URL for the number, active or not: an absolute HTTP or HTTPS URL
+        # on a public host, where Sent asks what to do with each call. The signing secret
+        # is kept.
+        sig { returns(T.nilable(String)) }
+        attr_accessor :callback_url
+
+        # true makes this the line app-originated calls are placed from when a voice token
+        # names no number. false is refused: an account with active voice numbers always
+        # has exactly one default, so the default moves by giving it to another number.
+        sig { returns(T.nilable(T::Boolean)) }
+        attr_accessor :default_for_app_calls
+
+        # Sandbox flag - when true, the operation is simulated without side effects Useful
+        # for testing integrations without actual execution
+        sig { returns(T.nilable(T::Boolean)) }
+        attr_reader :sandbox
+
+        sig { params(sandbox: T::Boolean).void }
+        attr_writer :sandbox
+
+        # ACTIVE turns calls on for the number again, INACTIVE turns them off. Matched
+        # ignoring case. Turning the default line off is refused while other active voice
+        # numbers remain.
+        sig do
+          returns(
+            T.nilable(Sentdm::Channels::VoiceUpdateParams::Status::OrSymbol)
+          )
+        end
+        attr_accessor :status
+
+        sig { returns(T.nilable(String)) }
+        attr_reader :idempotency_key
+
+        sig { params(idempotency_key: String).void }
+        attr_writer :idempotency_key
+
+        sig { returns(T.nilable(String)) }
+        attr_reader :x_profile_id
+
+        sig { params(x_profile_id: String).void }
+        attr_writer :x_profile_id
+
+        sig do
+          params(
+            number: String,
+            callback_url: T.nilable(String),
+            default_for_app_calls: T.nilable(T::Boolean),
+            sandbox: T::Boolean,
+            status:
+              T.nilable(Sentdm::Channels::VoiceUpdateParams::Status::OrSymbol),
+            idempotency_key: String,
+            x_profile_id: String,
+            request_options: Sentdm::RequestOptions::OrHash
+          ).returns(T.attached_class)
+        end
+        def self.new(
+          number:,
+          # A new callback URL for the number, active or not: an absolute HTTP or HTTPS URL
+          # on a public host, where Sent asks what to do with each call. The signing secret
+          # is kept.
+          callback_url: nil,
+          # true makes this the line app-originated calls are placed from when a voice token
+          # names no number. false is refused: an account with active voice numbers always
+          # has exactly one default, so the default moves by giving it to another number.
+          default_for_app_calls: nil,
+          # Sandbox flag - when true, the operation is simulated without side effects Useful
+          # for testing integrations without actual execution
+          sandbox: nil,
+          # ACTIVE turns calls on for the number again, INACTIVE turns them off. Matched
+          # ignoring case. Turning the default line off is refused while other active voice
+          # numbers remain.
+          status: nil,
+          idempotency_key: nil,
+          x_profile_id: nil,
+          request_options: {}
+        )
+        end
+
+        sig do
+          override.returns(
+            {
+              number: String,
+              callback_url: T.nilable(String),
+              default_for_app_calls: T.nilable(T::Boolean),
+              sandbox: T::Boolean,
+              status:
+                T.nilable(
+                  Sentdm::Channels::VoiceUpdateParams::Status::OrSymbol
+                ),
+              idempotency_key: String,
+              x_profile_id: String,
+              request_options: Sentdm::RequestOptions
+            }
+          )
+        end
+        def to_hash
+        end
+
+        # ACTIVE turns calls on for the number again, INACTIVE turns them off. Matched
+        # ignoring case. Turning the default line off is refused while other active voice
+        # numbers remain.
+        module Status
+          extend Sentdm::Internal::Type::Enum
+
+          TaggedSymbol =
+            T.type_alias do
+              T.all(Symbol, Sentdm::Channels::VoiceUpdateParams::Status)
+            end
+          OrSymbol = T.type_alias { T.any(Symbol, String) }
+
+          # Turns calls on for the number again. The callback URL and the signing secret it had are kept; send `callback_url` in the same call to replace the URL.
+          ACTIVE =
+            T.let(
+              :ACTIVE,
+              Sentdm::Channels::VoiceUpdateParams::Status::TaggedSymbol
+            )
+
+          # Turns calls off for the number. Refused while the number is the default line for app calls and other active voice numbers remain; move the default first. The callback URL and the secret stay on the number.
+          INACTIVE =
+            T.let(
+              :INACTIVE,
+              Sentdm::Channels::VoiceUpdateParams::Status::TaggedSymbol
+            )
+
+          sig do
+            override.returns(
+              T::Array[
+                Sentdm::Channels::VoiceUpdateParams::Status::TaggedSymbol
+              ]
+            )
+          end
+          def self.values
+          end
+        end
+      end
+    end
+  end
+end

data/rbi/sentdm/models/webhook_list_events_response.rbi

@@ -74,7 +74,7 @@ module Sentdm
               Sentdm::ChannelEvent::OrHash,
               Sentdm::ContactEvent::OrHash,
               Sentdm::Models::WebhookListEventsResponse::EventData::SentDmServicesCommonServicesWebhooksContractsWebhookEventOfLinkWebhookPayload::OrHash,
-              Sentdm::Models::WebhookListEventsResponse::EventData::SentDmServicesCommonServicesWebhooksContractsWebhookEventOfCallWebhookPayload::OrHash
+              Sentdm::CallEvent::OrHash
             )
         ).void
       end
@@ -113,7 +113,7 @@ module Sentdm
               Sentdm::ChannelEvent::OrHash,
               Sentdm::ContactEvent::OrHash,
               Sentdm::Models::WebhookListEventsResponse::EventData::SentDmServicesCommonServicesWebhooksContractsWebhookEventOfLinkWebhookPayload::OrHash,
-              Sentdm::Models::WebhookListEventsResponse::EventData::SentDmServicesCommonServicesWebhooksContractsWebhookEventOfCallWebhookPayload::OrHash
+              Sentdm::CallEvent::OrHash
             ),
           event_type: String,
           http_status_code: T.nilable(Integer),
@@ -204,7 +204,7 @@ module Sentdm
               Sentdm::ChannelEvent,
               Sentdm::ContactEvent,
               Sentdm::Models::WebhookListEventsResponse::EventData::SentDmServicesCommonServicesWebhooksContractsWebhookEventOfLinkWebhookPayload,
-              Sentdm::Models::WebhookListEventsResponse::EventData::SentDmServicesCommonServicesWebhooksContractsWebhookEventOfCallWebhookPayload
+              Sentdm::CallEvent
             )
           end
 
@@ -632,272 +632,6 @@ module Sentdm
           end
         end
 
-        class SentDmServicesCommonServicesWebhooksContractsWebhookEventOfCallWebhookPayload < Sentdm::Internal::Type::BaseModel
-          OrHash =
-            T.type_alias do
-              T.any(
-                Sentdm::Models::WebhookListEventsResponse::EventData::SentDmServicesCommonServicesWebhooksContractsWebhookEventOfCallWebhookPayload,
-                Sentdm::Internal::AnyHash
-              )
-            end
-
-          # The specific event within the family, for example message.delivered,
-          # message.received or contact.opt_out. Absent on events that have no subtype, so
-          # treat it as optional.
-          sig { returns(T.nilable(String)) }
-          attr_accessor :event
-
-          # The event family, for example message, templates or contact. Route on this
-          # first, then on event for the specific change.
-          sig { returns(T.nilable(String)) }
-          attr_reader :field
-
-          sig { params(field: String).void }
-          attr_writer :field
-
-          # Body of a call.initiated, call.answered, call.completed, call.failed or
-          # call.recording_ready event. Which of them occurred is the envelope's event.
-          #
-          # Shaped like the message, inbound, template and channel payloads: account_id
-          # names the account the event is about, channel names the channel, and updated_at
-          # is when the change happened on the call, in the same yyyy-MM-ddTHH:mm:ssZ form.
-          # duration_seconds and price are added on call.completed, reason on call.failed
-          # and recording_id on call.recording_ready; each is omitted rather than sent as
-          # null when it does not apply.
-          #
-          # Casing is snake_case because these ride the same webhook stream customers
-          # already parse message_id from; the question/answer contract is a separate
-          # surface and stays camelCase. Nothing here is provider-shaped: no provider call
-          # id, no namespaced identity.
-          sig do
-            returns(
-              T.nilable(
-                Sentdm::Models::WebhookListEventsResponse::EventData::SentDmServicesCommonServicesWebhooksContractsWebhookEventOfCallWebhookPayload::Payload
-              )
-            )
-          end
-          attr_reader :payload
-
-          sig do
-            params(
-              payload:
-                T.nilable(
-                  Sentdm::Models::WebhookListEventsResponse::EventData::SentDmServicesCommonServicesWebhooksContractsWebhookEventOfCallWebhookPayload::Payload::OrHash
-                )
-            ).void
-          end
-          attr_writer :payload
-
-          # The event-specific body.
-          sig { returns(T.nilable(String)) }
-          attr_accessor :request_id
-
-          # When Sent emitted the event, in UTC (yyyy-MM-ddTHH:mm:ssZ). This is the emission
-          # time, not the time the underlying change happened. Use the timestamp inside the
-          # payload for the latter.
-          sig { returns(T.nilable(String)) }
-          attr_reader :timestamp
-
-          sig { params(timestamp: String).void }
-          attr_writer :timestamp
-
-          # The envelope Sent POSTs to a subscribed webhook endpoint. Every event shares
-          # this shape and varies only in Payload.
-          sig do
-            params(
-              event: T.nilable(String),
-              field: String,
-              payload:
-                T.nilable(
-                  Sentdm::Models::WebhookListEventsResponse::EventData::SentDmServicesCommonServicesWebhooksContractsWebhookEventOfCallWebhookPayload::Payload::OrHash
-                ),
-              request_id: T.nilable(String),
-              timestamp: String
-            ).returns(T.attached_class)
-          end
-          def self.new(
-            # The specific event within the family, for example message.delivered,
-            # message.received or contact.opt_out. Absent on events that have no subtype, so
-            # treat it as optional.
-            event: nil,
-            # The event family, for example message, templates or contact. Route on this
-            # first, then on event for the specific change.
-            field: nil,
-            # Body of a call.initiated, call.answered, call.completed, call.failed or
-            # call.recording_ready event. Which of them occurred is the envelope's event.
-            #
-            # Shaped like the message, inbound, template and channel payloads: account_id
-            # names the account the event is about, channel names the channel, and updated_at
-            # is when the change happened on the call, in the same yyyy-MM-ddTHH:mm:ssZ form.
-            # duration_seconds and price are added on call.completed, reason on call.failed
-            # and recording_id on call.recording_ready; each is omitted rather than sent as
-            # null when it does not apply.
-            #
-            # Casing is snake_case because these ride the same webhook stream customers
-            # already parse message_id from; the question/answer contract is a separate
-            # surface and stays camelCase. Nothing here is provider-shaped: no provider call
-            # id, no namespaced identity.
-            payload: nil,
-            # The event-specific body.
-            request_id: nil,
-            # When Sent emitted the event, in UTC (yyyy-MM-ddTHH:mm:ssZ). This is the emission
-            # time, not the time the underlying change happened. Use the timestamp inside the
-            # payload for the latter.
-            timestamp: nil
-          )
-          end
-
-          sig do
-            override.returns(
-              {
-                event: T.nilable(String),
-                field: String,
-                payload:
-                  T.nilable(
-                    Sentdm::Models::WebhookListEventsResponse::EventData::SentDmServicesCommonServicesWebhooksContractsWebhookEventOfCallWebhookPayload::Payload
-                  ),
-                request_id: T.nilable(String),
-                timestamp: String
-              }
-            )
-          end
-          def to_hash
-          end
-
-          class Payload < Sentdm::Internal::Type::BaseModel
-            OrHash =
-              T.type_alias do
-                T.any(
-                  Sentdm::Models::WebhookListEventsResponse::EventData::SentDmServicesCommonServicesWebhooksContractsWebhookEventOfCallWebhookPayload::Payload,
-                  Sentdm::Internal::AnyHash
-                )
-              end
-
-            # Sent's call id, the same one the customer saw on the first question.
-            sig { returns(String) }
-            attr_accessor :call_id
-
-            # The account the call belongs to: the key's own customer, or the sender profile
-            # it acted as.
-            sig { returns(T.nilable(String)) }
-            attr_reader :account_id
-
-            sig { params(account_id: String).void }
-            attr_writer :account_id
-
-            # Always voice.
-            sig { returns(T.nilable(String)) }
-            attr_reader :channel
-
-            sig { params(channel: String).void }
-            attr_writer :channel
-
-            # How long the call lasted. Only on call.completed.
-            sig { returns(T.nilable(Integer)) }
-            attr_accessor :duration_seconds
-
-            # The customer number that owns the call, in E.164 format.
-            sig { returns(T.nilable(String)) }
-            attr_reader :number
-
-            sig { params(number: String).void }
-            attr_writer :number
-
-            # What the call was charged. Only on call.completed, and omitted there until
-            # billing has recorded the charge.
-            sig { returns(T.nilable(Float)) }
-            attr_accessor :price
-
-            # The machine-readable reason the call did not complete. Only on call.failed, and
-            # omitted when no reason was recorded.
-            sig { returns(T.nilable(String)) }
-            attr_accessor :reason
-
-            # The recording that became available, the same id GET /v3/calls/{id}/recordings
-            # lists it under. Only on call.recording_ready, which is sent once per recording.
-            sig { returns(T.nilable(String)) }
-            attr_accessor :recording_id
-
-            # When the change happened on the call, as opposed to when the event was emitted.
-            sig { returns(T.nilable(String)) }
-            attr_reader :updated_at
-
-            sig { params(updated_at: String).void }
-            attr_writer :updated_at
-
-            # Body of a call.initiated, call.answered, call.completed, call.failed or
-            # call.recording_ready event. Which of them occurred is the envelope's event.
-            #
-            # Shaped like the message, inbound, template and channel payloads: account_id
-            # names the account the event is about, channel names the channel, and updated_at
-            # is when the change happened on the call, in the same yyyy-MM-ddTHH:mm:ssZ form.
-            # duration_seconds and price are added on call.completed, reason on call.failed
-            # and recording_id on call.recording_ready; each is omitted rather than sent as
-            # null when it does not apply.
-            #
-            # Casing is snake_case because these ride the same webhook stream customers
-            # already parse message_id from; the question/answer contract is a separate
-            # surface and stays camelCase. Nothing here is provider-shaped: no provider call
-            # id, no namespaced identity.
-            sig do
-              params(
-                call_id: String,
-                account_id: String,
-                channel: String,
-                duration_seconds: T.nilable(Integer),
-                number: String,
-                price: T.nilable(Float),
-                reason: T.nilable(String),
-                recording_id: T.nilable(String),
-                updated_at: String
-              ).returns(T.attached_class)
-            end
-            def self.new(
-              # Sent's call id, the same one the customer saw on the first question.
-              call_id:,
-              # The account the call belongs to: the key's own customer, or the sender profile
-              # it acted as.
-              account_id: nil,
-              # Always voice.
-              channel: nil,
-              # How long the call lasted. Only on call.completed.
-              duration_seconds: nil,
-              # The customer number that owns the call, in E.164 format.
-              number: nil,
-              # What the call was charged. Only on call.completed, and omitted there until
-              # billing has recorded the charge.
-              price: nil,
-              # The machine-readable reason the call did not complete. Only on call.failed, and
-              # omitted when no reason was recorded.
-              reason: nil,
-              # The recording that became available, the same id GET /v3/calls/{id}/recordings
-              # lists it under. Only on call.recording_ready, which is sent once per recording.
-              recording_id: nil,
-              # When the change happened on the call, as opposed to when the event was emitted.
-              updated_at: nil
-            )
-            end
-
-            sig do
-              override.returns(
-                {
-                  call_id: String,
-                  account_id: String,
-                  channel: String,
-                  duration_seconds: T.nilable(Integer),
-                  number: String,
-                  price: T.nilable(Float),
-                  reason: T.nilable(String),
-                  recording_id: T.nilable(String),
-                  updated_at: String
-                }
-              )
-            end
-            def to_hash
-            end
-          end
-        end
-
         sig do
           override.returns(
             T::Array[

data/rbi/sentdm/models.rbi

@@ -3,6 +3,12 @@
 module Sentdm
   APIMeta = Sentdm::Models::APIMeta
 
+  APIResponseOfCall = Sentdm::Models::APIResponseOfCall
+
+  APIResponseOfCallRecordings = Sentdm::Models::APIResponseOfCallRecordings
+
+  APIResponseOfCallsList = Sentdm::Models::APIResponseOfCallsList
+
   APIResponseOfContact = Sentdm::Models::APIResponseOfContact
 
   APIResponseOfContactMessageSummary =
@@ -31,10 +37,40 @@ module Sentdm
 
   BrandsBrandData = Sentdm::Models::BrandsBrandData
 
+  Call = Sentdm::Models::Call
+
+  CallEvent = Sentdm::Models::CallEvent
+
+  CallEventPayload = Sentdm::Models::CallEventPayload
+
+  CallHangupParams = Sentdm::Models::CallHangupParams
+
+  CallListParams = Sentdm::Models::CallListParams
+
+  CallListRecordingsParams = Sentdm::Models::CallListRecordingsParams
+
+  CallParty = Sentdm::Models::CallParty
+
+  CallRecording = Sentdm::Models::CallRecording
+
+  CallRecordings = Sentdm::Models::CallRecordings
+
+  CallRecordParams = Sentdm::Models::CallRecordParams
+
+  CallRetrieveParams = Sentdm::Models::CallRetrieveParams
+
+  Calls = Sentdm::Models::Calls
+
+  CallsList = Sentdm::Models::CallsList
+
+  CallTimelineEntry = Sentdm::Models::CallTimelineEntry
+
   ChannelEvent = Sentdm::Models::ChannelEvent
 
   ChannelEventPayload = Sentdm::Models::ChannelEventPayload
 
+  Channels = Sentdm::Models::Channels
+
   ContactCreateParams = Sentdm::Models::ContactCreateParams
 
   ContactDeleteParams = Sentdm::Models::ContactDeleteParams