surge_api 0.8.0 → 0.10.0

data/sig/surge_api/models/recording_completed_webhook_event.rbs

@@ -0,0 +1,126 @@
+module SurgeAPI
+  module Models
+    type recording_completed_webhook_event =
+      {
+        account_id: String,
+        data: SurgeAPI::RecordingCompletedWebhookEvent::Data,
+        timestamp: Time,
+        type: :"recording.completed"
+      }
+
+    class RecordingCompletedWebhookEvent < SurgeAPI::Internal::Type::BaseModel
+      attr_accessor account_id: String
+
+      attr_accessor data: SurgeAPI::RecordingCompletedWebhookEvent::Data
+
+      attr_accessor timestamp: Time
+
+      attr_accessor type: :"recording.completed"
+
+      def initialize: (
+        account_id: String,
+        data: SurgeAPI::RecordingCompletedWebhookEvent::Data,
+        timestamp: Time,
+        ?type: :"recording.completed"
+      ) -> void
+
+      def to_hash: -> {
+        account_id: String,
+        data: SurgeAPI::RecordingCompletedWebhookEvent::Data,
+        timestamp: Time,
+        type: :"recording.completed"
+      }
+
+      type data =
+        {
+          id: String,
+          call: SurgeAPI::RecordingCompletedWebhookEvent::Data::Call,
+          duration: Integer
+        }
+
+      class Data < SurgeAPI::Internal::Type::BaseModel
+        attr_accessor id: String
+
+        attr_accessor call: SurgeAPI::RecordingCompletedWebhookEvent::Data::Call
+
+        attr_accessor duration: Integer
+
+        def initialize: (
+          id: String,
+          call: SurgeAPI::RecordingCompletedWebhookEvent::Data::Call,
+          duration: Integer
+        ) -> void
+
+        def to_hash: -> {
+          id: String,
+          call: SurgeAPI::RecordingCompletedWebhookEvent::Data::Call,
+          duration: Integer
+        }
+
+        type call =
+          {
+            id: String,
+            contact: SurgeAPI::Contact,
+            duration: Integer,
+            initiated_at: Time,
+            status: SurgeAPI::Models::RecordingCompletedWebhookEvent::Data::Call::status
+          }
+
+        class Call < SurgeAPI::Internal::Type::BaseModel
+          attr_accessor id: String
+
+          attr_accessor contact: SurgeAPI::Contact
+
+          attr_accessor duration: Integer
+
+          attr_accessor initiated_at: Time
+
+          attr_accessor status: SurgeAPI::Models::RecordingCompletedWebhookEvent::Data::Call::status
+
+          def initialize: (
+            id: String,
+            contact: SurgeAPI::Contact,
+            duration: Integer,
+            initiated_at: Time,
+            status: SurgeAPI::Models::RecordingCompletedWebhookEvent::Data::Call::status
+          ) -> void
+
+          def to_hash: -> {
+            id: String,
+            contact: SurgeAPI::Contact,
+            duration: Integer,
+            initiated_at: Time,
+            status: SurgeAPI::Models::RecordingCompletedWebhookEvent::Data::Call::status
+          }
+
+          type status =
+            :busy
+            | :canceled
+            | :completed
+            | :failed
+            | :in_progress
+            | :missed
+            | :no_answer
+            | :queued
+            | :ringing
+
+          module Status
+            extend SurgeAPI::Internal::Type::Enum
+
+            BUSY: :busy
+            CANCELED: :canceled
+            COMPLETED: :completed
+            FAILED: :failed
+            IN_PROGRESS: :in_progress
+            MISSED: :missed
+            NO_ANSWER: :no_answer
+            QUEUED: :queued
+            RINGING: :ringing
+
+            def self?.values: -> ::Array[SurgeAPI::Models::RecordingCompletedWebhookEvent::Data::Call::status]
+          end
+        end
+      end
+    end
+  end
+end

data/sig/surge_api/models/recording_get_file_params.rbs

@@ -0,0 +1,15 @@
+module SurgeAPI
+  module Models
+    type recording_get_file_params =
+      {  } & SurgeAPI::Internal::Type::request_parameters
+
+    class RecordingGetFileParams < SurgeAPI::Internal::Type::BaseModel
+      extend SurgeAPI::Internal::Type::RequestParameters::Converter
+      include SurgeAPI::Internal::Type::RequestParameters
+
+      def initialize: (?request_options: SurgeAPI::request_opts) -> void
+
+      def to_hash: -> { request_options: SurgeAPI::RequestOptions }
+    end
+  end
+end

data/sig/surge_api/models/recording_get_file_response.rbs

@@ -0,0 +1,13 @@
+module SurgeAPI
+  module Models
+    type recording_get_file_response = { error: SurgeAPI::Error }
+
+    class RecordingGetFileResponse < SurgeAPI::Internal::Type::BaseModel
+      attr_accessor error: SurgeAPI::Error
+
+      def initialize: (error: SurgeAPI::Error) -> void
+
+      def to_hash: -> { error: SurgeAPI::Error }
+    end
+  end
+end

data/sig/surge_api/models/unwrap_webhook_event.rbs

@@ -11,6 +11,8 @@ module SurgeAPI
       | SurgeAPI::MessageFailedWebhookEvent
       | SurgeAPI::MessageReceivedWebhookEvent
       | SurgeAPI::MessageSentWebhookEvent
+      | SurgeAPI::RecordingCompletedWebhookEvent
+      | SurgeAPI::VoicemailReceivedWebhookEvent
 
     module UnwrapWebhookEvent
       extend SurgeAPI::Internal::Type::Union

data/sig/surge_api/models/voicemail_received_webhook_event.rbs

@@ -0,0 +1,131 @@
+module SurgeAPI
+  module Models
+    type voicemail_received_webhook_event =
+      {
+        account_id: String,
+        data: SurgeAPI::VoicemailReceivedWebhookEvent::Data,
+        timestamp: Time,
+        type: :"voicemail.received"
+      }
+
+    class VoicemailReceivedWebhookEvent < SurgeAPI::Internal::Type::BaseModel
+      attr_accessor account_id: String
+
+      attr_accessor data: SurgeAPI::VoicemailReceivedWebhookEvent::Data
+
+      attr_accessor timestamp: Time
+
+      attr_accessor type: :"voicemail.received"
+
+      def initialize: (
+        account_id: String,
+        data: SurgeAPI::VoicemailReceivedWebhookEvent::Data,
+        timestamp: Time,
+        ?type: :"voicemail.received"
+      ) -> void
+
+      def to_hash: -> {
+        account_id: String,
+        data: SurgeAPI::VoicemailReceivedWebhookEvent::Data,
+        timestamp: Time,
+        type: :"voicemail.received"
+      }
+
+      type data =
+        {
+          id: String,
+          call: SurgeAPI::VoicemailReceivedWebhookEvent::Data::Call,
+          duration: Integer,
+          recording_id: String
+        }
+
+      class Data < SurgeAPI::Internal::Type::BaseModel
+        attr_accessor id: String
+
+        attr_accessor call: SurgeAPI::VoicemailReceivedWebhookEvent::Data::Call
+
+        attr_accessor duration: Integer
+
+        attr_accessor recording_id: String
+
+        def initialize: (
+          id: String,
+          call: SurgeAPI::VoicemailReceivedWebhookEvent::Data::Call,
+          duration: Integer,
+          recording_id: String
+        ) -> void
+
+        def to_hash: -> {
+          id: String,
+          call: SurgeAPI::VoicemailReceivedWebhookEvent::Data::Call,
+          duration: Integer,
+          recording_id: String
+        }
+
+        type call =
+          {
+            id: String,
+            contact: SurgeAPI::Contact,
+            duration: Integer,
+            initiated_at: Time,
+            status: SurgeAPI::Models::VoicemailReceivedWebhookEvent::Data::Call::status
+          }
+
+        class Call < SurgeAPI::Internal::Type::BaseModel
+          attr_accessor id: String
+
+          attr_accessor contact: SurgeAPI::Contact
+
+          attr_accessor duration: Integer
+
+          attr_accessor initiated_at: Time
+
+          attr_accessor status: SurgeAPI::Models::VoicemailReceivedWebhookEvent::Data::Call::status
+
+          def initialize: (
+            id: String,
+            contact: SurgeAPI::Contact,
+            duration: Integer,
+            initiated_at: Time,
+            status: SurgeAPI::Models::VoicemailReceivedWebhookEvent::Data::Call::status
+          ) -> void
+
+          def to_hash: -> {
+            id: String,
+            contact: SurgeAPI::Contact,
+            duration: Integer,
+            initiated_at: Time,
+            status: SurgeAPI::Models::VoicemailReceivedWebhookEvent::Data::Call::status
+          }
+
+          type status =
+            :busy
+            | :canceled
+            | :completed
+            | :failed
+            | :in_progress
+            | :missed
+            | :no_answer
+            | :queued
+            | :ringing
+
+          module Status
+            extend SurgeAPI::Internal::Type::Enum
+
+            BUSY: :busy
+            CANCELED: :canceled
+            COMPLETED: :completed
+            FAILED: :failed
+            IN_PROGRESS: :in_progress
+            MISSED: :missed
+            NO_ANSWER: :no_answer
+            QUEUED: :queued
+            RINGING: :ringing
+
+            def self?.values: -> ::Array[SurgeAPI::Models::VoicemailReceivedWebhookEvent::Data::Call::status]
+          end
+        end
+      end
+    end
+  end
+end

data/sig/surge_api/models.rbs

@@ -25,10 +25,14 @@ module SurgeAPI
 
   module CampaignParams = SurgeAPI::Models::CampaignParams
 
+  class CampaignRetrieveParams = SurgeAPI::Models::CampaignRetrieveParams
+
   class Contact = SurgeAPI::Models::Contact
 
   class ContactCreateParams = SurgeAPI::Models::ContactCreateParams
 
+  class ContactListParams = SurgeAPI::Models::ContactListParams
+
   class ContactOptedInWebhookEvent = SurgeAPI::Models::ContactOptedInWebhookEvent
 
   class ContactOptedOutWebhookEvent = SurgeAPI::Models::ContactOptedOutWebhookEvent
@@ -51,6 +55,8 @@ module SurgeAPI
 
   class MessageFailedWebhookEvent = SurgeAPI::Models::MessageFailedWebhookEvent
 
+  class MessageListParams = SurgeAPI::Models::MessageListParams
+
   module MessageParams = SurgeAPI::Models::MessageParams
 
   class MessageReceivedWebhookEvent = SurgeAPI::Models::MessageReceivedWebhookEvent
@@ -63,8 +69,14 @@ module SurgeAPI
 
   class PhoneNumber = SurgeAPI::Models::PhoneNumber
 
+  class PhoneNumberListParams = SurgeAPI::Models::PhoneNumberListParams
+
   class PhoneNumberPurchaseParams = SurgeAPI::Models::PhoneNumberPurchaseParams
 
+  class RecordingCompletedWebhookEvent = SurgeAPI::Models::RecordingCompletedWebhookEvent
+
+  class RecordingGetFileParams = SurgeAPI::Models::RecordingGetFileParams
+
   module UnwrapWebhookEvent = SurgeAPI::Models::UnwrapWebhookEvent
 
   class User = SurgeAPI::Models::User
@@ -89,5 +101,7 @@ module SurgeAPI
 
   class VerificationCreateParams = SurgeAPI::Models::VerificationCreateParams
 
+  class VoicemailReceivedWebhookEvent = SurgeAPI::Models::VoicemailReceivedWebhookEvent
+
   class WebhookUnwrapParams = SurgeAPI::Models::WebhookUnwrapParams
 end

data/sig/surge_api/resources/blasts.rbs

@@ -4,7 +4,7 @@ module SurgeAPI
       def create: (
         String account_id,
         ?attachments: ::Array[SurgeAPI::BlastCreateParams::Attachment],
-        ?body: String,
+        ?body: String?,
         ?contacts: ::Array[String],
         ?from: String,
         ?name: String,

data/sig/surge_api/resources/campaigns.rbs

@@ -7,6 +7,11 @@ module SurgeAPI
         ?request_options: SurgeAPI::request_opts
       ) -> SurgeAPI::Campaign
 
+      def retrieve: (
+        String id,
+        ?request_options: SurgeAPI::request_opts
+      ) -> SurgeAPI::Campaign
+
       def initialize: (client: SurgeAPI::Client) -> void
     end
   end

data/sig/surge_api/resources/contacts.rbs

@@ -26,6 +26,13 @@ module SurgeAPI
         ?request_options: SurgeAPI::request_opts
       ) -> SurgeAPI::Contact
 
+      def list: (
+        String account_id,
+        ?after: String,
+        ?before: String,
+        ?request_options: SurgeAPI::request_opts
+      ) -> SurgeAPI::Internal::Cursor[SurgeAPI::Contact]
+
       def initialize: (client: SurgeAPI::Client) -> void
     end
   end

data/sig/surge_api/resources/messages.rbs

@@ -12,6 +12,13 @@ module SurgeAPI
         ?request_options: SurgeAPI::request_opts
       ) -> SurgeAPI::Message
 
+      def list: (
+        String account_id,
+        ?after: String,
+        ?before: String,
+        ?request_options: SurgeAPI::request_opts
+      ) -> SurgeAPI::Internal::Cursor[SurgeAPI::Message]
+
       def initialize: (client: SurgeAPI::Client) -> void
     end
   end

data/sig/surge_api/resources/phone_numbers.rbs

@@ -1,6 +1,13 @@
 module SurgeAPI
   module Resources
     class PhoneNumbers
+      def list: (
+        String account_id,
+        ?after: String,
+        ?before: String,
+        ?request_options: SurgeAPI::request_opts
+      ) -> SurgeAPI::Internal::Cursor[SurgeAPI::PhoneNumber]
+
       def purchase: (
         String account_id,
         ?area_code: String,

data/sig/surge_api/resources/recordings.rbs

@@ -0,0 +1,12 @@
+module SurgeAPI
+  module Resources
+    class Recordings
+      def get_file: (
+        String recording_id,
+        ?request_options: SurgeAPI::request_opts
+      ) -> SurgeAPI::Models::RecordingGetFileResponse
+
+      def initialize: (client: SurgeAPI::Client) -> void
+    end
+  end
+end

data/sig/surge_api/resources/webhooks.rbs

@@ -12,7 +12,9 @@ module SurgeAPI
       | SurgeAPI::MessageDeliveredWebhookEvent
       | SurgeAPI::MessageFailedWebhookEvent
       | SurgeAPI::MessageReceivedWebhookEvent
-      | SurgeAPI::MessageSentWebhookEvent)
+      | SurgeAPI::MessageSentWebhookEvent
+      | SurgeAPI::RecordingCompletedWebhookEvent
+      | SurgeAPI::VoicemailReceivedWebhookEvent)
 
       def initialize: (client: SurgeAPI::Client) -> void
     end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: surge_api
 version: !ruby/object:Gem::Version
-  version: 0.8.0
+  version: 0.10.0
 platform: ruby
 authors:
 - Surge
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2026-01-26 00:00:00.000000000 Z
+date: 2026-02-12 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: cgi
@@ -54,6 +54,7 @@ files:
 - lib/surge_api/errors.rb
 - lib/surge_api/file_part.rb
 - lib/surge_api/internal.rb
+- lib/surge_api/internal/cursor.rb
 - lib/surge_api/internal/transport/base_client.rb
 - lib/surge_api/internal/transport/pooled_net_requester.rb
 - lib/surge_api/internal/type/array_of.rb
@@ -82,8 +83,10 @@ files:
 - lib/surge_api/models/campaign_approved_webhook_event.rb
 - lib/surge_api/models/campaign_create_params.rb
 - lib/surge_api/models/campaign_params.rb
+- lib/surge_api/models/campaign_retrieve_params.rb
 - lib/surge_api/models/contact.rb
 - lib/surge_api/models/contact_create_params.rb
+- lib/surge_api/models/contact_list_params.rb
 - lib/surge_api/models/contact_opted_in_webhook_event.rb
 - lib/surge_api/models/contact_opted_out_webhook_event.rb
 - lib/surge_api/models/contact_retrieve_params.rb
@@ -95,13 +98,18 @@ files:
 - lib/surge_api/models/message_create_params.rb
 - lib/surge_api/models/message_delivered_webhook_event.rb
 - lib/surge_api/models/message_failed_webhook_event.rb
+- lib/surge_api/models/message_list_params.rb
 - lib/surge_api/models/message_params.rb
 - lib/surge_api/models/message_received_webhook_event.rb
 - lib/surge_api/models/message_retrieve_params.rb
 - lib/surge_api/models/message_sent_webhook_event.rb
 - lib/surge_api/models/organization.rb
 - lib/surge_api/models/phone_number.rb
+- lib/surge_api/models/phone_number_list_params.rb
 - lib/surge_api/models/phone_number_purchase_params.rb
+- lib/surge_api/models/recording_completed_webhook_event.rb
+- lib/surge_api/models/recording_get_file_params.rb
+- lib/surge_api/models/recording_get_file_response.rb
 - lib/surge_api/models/unwrap_webhook_event.rb
 - lib/surge_api/models/user.rb
 - lib/surge_api/models/user_create_params.rb
@@ -114,6 +122,7 @@ files:
 - lib/surge_api/models/verification_check.rb
 - lib/surge_api/models/verification_check_params.rb
 - lib/surge_api/models/verification_create_params.rb
+- lib/surge_api/models/voicemail_received_webhook_event.rb
 - lib/surge_api/models/webhook_unwrap_params.rb
 - lib/surge_api/request_options.rb
 - lib/surge_api/resources/accounts.rb
@@ -122,6 +131,7 @@ files:
 - lib/surge_api/resources/contacts.rb
 - lib/surge_api/resources/messages.rb
 - lib/surge_api/resources/phone_numbers.rb
+- lib/surge_api/resources/recordings.rb
 - lib/surge_api/resources/users.rb
 - lib/surge_api/resources/verifications.rb
 - lib/surge_api/resources/webhooks.rb
@@ -131,6 +141,7 @@ files:
 - rbi/surge_api/errors.rbi
 - rbi/surge_api/file_part.rbi
 - rbi/surge_api/internal.rbi
+- rbi/surge_api/internal/cursor.rbi
 - rbi/surge_api/internal/transport/base_client.rbi
 - rbi/surge_api/internal/transport/pooled_net_requester.rbi
 - rbi/surge_api/internal/type/array_of.rbi
@@ -159,8 +170,10 @@ files:
 - rbi/surge_api/models/campaign_approved_webhook_event.rbi
 - rbi/surge_api/models/campaign_create_params.rbi
 - rbi/surge_api/models/campaign_params.rbi
+- rbi/surge_api/models/campaign_retrieve_params.rbi
 - rbi/surge_api/models/contact.rbi
 - rbi/surge_api/models/contact_create_params.rbi
+- rbi/surge_api/models/contact_list_params.rbi
 - rbi/surge_api/models/contact_opted_in_webhook_event.rbi
 - rbi/surge_api/models/contact_opted_out_webhook_event.rbi
 - rbi/surge_api/models/contact_retrieve_params.rbi
@@ -172,13 +185,18 @@ files:
 - rbi/surge_api/models/message_create_params.rbi
 - rbi/surge_api/models/message_delivered_webhook_event.rbi
 - rbi/surge_api/models/message_failed_webhook_event.rbi
+- rbi/surge_api/models/message_list_params.rbi
 - rbi/surge_api/models/message_params.rbi
 - rbi/surge_api/models/message_received_webhook_event.rbi
 - rbi/surge_api/models/message_retrieve_params.rbi
 - rbi/surge_api/models/message_sent_webhook_event.rbi
 - rbi/surge_api/models/organization.rbi
 - rbi/surge_api/models/phone_number.rbi
+- rbi/surge_api/models/phone_number_list_params.rbi
 - rbi/surge_api/models/phone_number_purchase_params.rbi
+- rbi/surge_api/models/recording_completed_webhook_event.rbi
+- rbi/surge_api/models/recording_get_file_params.rbi
+- rbi/surge_api/models/recording_get_file_response.rbi
 - rbi/surge_api/models/unwrap_webhook_event.rbi
 - rbi/surge_api/models/user.rbi
 - rbi/surge_api/models/user_create_params.rbi
@@ -191,6 +209,7 @@ files:
 - rbi/surge_api/models/verification_check.rbi
 - rbi/surge_api/models/verification_check_params.rbi
 - rbi/surge_api/models/verification_create_params.rbi
+- rbi/surge_api/models/voicemail_received_webhook_event.rbi
 - rbi/surge_api/models/webhook_unwrap_params.rbi
 - rbi/surge_api/request_options.rbi
 - rbi/surge_api/resources/accounts.rbi
@@ -199,6 +218,7 @@ files:
 - rbi/surge_api/resources/contacts.rbi
 - rbi/surge_api/resources/messages.rbi
 - rbi/surge_api/resources/phone_numbers.rbi
+- rbi/surge_api/resources/recordings.rbi
 - rbi/surge_api/resources/users.rbi
 - rbi/surge_api/resources/verifications.rbi
 - rbi/surge_api/resources/webhooks.rbi
@@ -207,6 +227,7 @@ files:
 - sig/surge_api/errors.rbs
 - sig/surge_api/file_part.rbs
 - sig/surge_api/internal.rbs
+- sig/surge_api/internal/cursor.rbs
 - sig/surge_api/internal/transport/base_client.rbs
 - sig/surge_api/internal/transport/pooled_net_requester.rbs
 - sig/surge_api/internal/type/array_of.rbs
@@ -235,8 +256,10 @@ files:
 - sig/surge_api/models/campaign_approved_webhook_event.rbs
 - sig/surge_api/models/campaign_create_params.rbs
 - sig/surge_api/models/campaign_params.rbs
+- sig/surge_api/models/campaign_retrieve_params.rbs
 - sig/surge_api/models/contact.rbs
 - sig/surge_api/models/contact_create_params.rbs
+- sig/surge_api/models/contact_list_params.rbs
 - sig/surge_api/models/contact_opted_in_webhook_event.rbs
 - sig/surge_api/models/contact_opted_out_webhook_event.rbs
 - sig/surge_api/models/contact_retrieve_params.rbs
@@ -248,13 +271,18 @@ files:
 - sig/surge_api/models/message_create_params.rbs
 - sig/surge_api/models/message_delivered_webhook_event.rbs
 - sig/surge_api/models/message_failed_webhook_event.rbs
+- sig/surge_api/models/message_list_params.rbs
 - sig/surge_api/models/message_params.rbs
 - sig/surge_api/models/message_received_webhook_event.rbs
 - sig/surge_api/models/message_retrieve_params.rbs
 - sig/surge_api/models/message_sent_webhook_event.rbs
 - sig/surge_api/models/organization.rbs
 - sig/surge_api/models/phone_number.rbs
+- sig/surge_api/models/phone_number_list_params.rbs
 - sig/surge_api/models/phone_number_purchase_params.rbs
+- sig/surge_api/models/recording_completed_webhook_event.rbs
+- sig/surge_api/models/recording_get_file_params.rbs
+- sig/surge_api/models/recording_get_file_response.rbs
 - sig/surge_api/models/unwrap_webhook_event.rbs
 - sig/surge_api/models/user.rbs
 - sig/surge_api/models/user_create_params.rbs
@@ -267,6 +295,7 @@ files:
 - sig/surge_api/models/verification_check.rbs
 - sig/surge_api/models/verification_check_params.rbs
 - sig/surge_api/models/verification_create_params.rbs
+- sig/surge_api/models/voicemail_received_webhook_event.rbs
 - sig/surge_api/models/webhook_unwrap_params.rbs
 - sig/surge_api/request_options.rbs
 - sig/surge_api/resources/accounts.rbs
@@ -275,6 +304,7 @@ files:
 - sig/surge_api/resources/contacts.rbs
 - sig/surge_api/resources/messages.rbs
 - sig/surge_api/resources/phone_numbers.rbs
+- sig/surge_api/resources/recordings.rbs
 - sig/surge_api/resources/users.rbs
 - sig/surge_api/resources/verifications.rbs
 - sig/surge_api/resources/webhooks.rbs