surge_api 0.9.0 → 0.10.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: c8cabbc1ca93255610f86e41e4408ee35552d4755552e0bb63dec43d34e37847
-  data.tar.gz: 94fd6a84dd1d08f71b3fb51125010f75d03f824538078a70103213297391c30b
+  metadata.gz: 4ab0d460fe03be9712dc7d4ad68bc64e6ebb931573b9fe9ff91b8f36f2979514
+  data.tar.gz: 20488d8ba034a202671fa5cb1c3e0bde2c863bfa7826ed3ffb718911c34515ee
 SHA512:
-  metadata.gz: cce465d2b1f99e690347727f8e987b6afa07a0cd2eadfb0e0832b1bf1100477ae03592e774c9ee8929d9c2eb5903e820fac12ca0d8d28a6ed1207dcdabc33a3c
-  data.tar.gz: 184ca9625b88a0b8366f92f0760e1fd5f53abd52752a4c0284b99429442cc69280b29e9758d94381a0ca4fba98e693f36d083710a17883ad13c4aaae3b83d39b
+  metadata.gz: abd73bd158429ed55c7343a89e85ce56ed40979df1278b20937250787bf360b91e1de84494abd4f1d2e9c2f3dc8f2bbfbedec04f1666b2d9b5798f976cda985f
+  data.tar.gz: bcbd4c0adb4baba0a737a833232f02abb63588f31a8d9ff70c39dee65037db86032efc12f34499c57ff46bd6b6b27c5276d6a9af4600fb290aced6e0014cda80

data/CHANGELOG.md

@@ -1,5 +1,23 @@
 # Changelog
 
+## 0.10.0 (2026-02-12)
+
+Full Changelog: [v0.9.0...v0.10.0](https://github.com/surgeapi/ruby-sdk/compare/v0.9.0...v0.10.0)
+
+### Features
+
+* **api:** add campaign.status field ([f0ab6be](https://github.com/surgeapi/ruby-sdk/commit/f0ab6bef5d1cbca9741b3731189e5a821c6abcb3))
+* **api:** add get campaign endpoint ([511d2b3](https://github.com/surgeapi/ruby-sdk/commit/511d2b3cd36a3e4a1f1737093a02f5c31296c332))
+* **api:** add recording.completed webhook ([9a72a0c](https://github.com/surgeapi/ruby-sdk/commit/9a72a0c754dad51ac7b02e84c3f8ce8e6ba85378))
+* **api:** add voicemail.received webhook ([37edfcd](https://github.com/surgeapi/ruby-sdk/commit/37edfcd3a2d26f42ea5a0fbf5481e046486f4456))
+* **api:** get recording file ([db0184e](https://github.com/surgeapi/ruby-sdk/commit/db0184e171168f74e20d91b65cea452a32aad263))
+
+
+### Bug Fixes
+
+* **api:** make message.blast_id nullable ([9096e75](https://github.com/surgeapi/ruby-sdk/commit/9096e75d5aa6803c4b11aba0fe2c61448abf3f6a))
+* **client:** loosen json header parsing ([51f4092](https://github.com/surgeapi/ruby-sdk/commit/51f409235dc8e2c377411b3f53595df8fea9b4e4))
+
 ## 0.9.0 (2026-02-04)
 
 Full Changelog: [v0.8.0...v0.9.0](https://github.com/surgeapi/ruby-sdk/compare/v0.8.0...v0.9.0)

data/README.md

@@ -17,7 +17,7 @@ To use this gem, install via Bundler by adding the following to your application
 <!-- x-release-please-start-version -->
 
 ```ruby
-gem "surge_api", "~> 0.9.0"
+gem "surge_api", "~> 0.10.0"
 ```
 
 <!-- x-release-please-end -->

data/lib/surge_api/client.rb

@@ -36,6 +36,9 @@ module SurgeAPI
     # @return [SurgeAPI::Resources::PhoneNumbers]
     attr_reader :phone_numbers
 
+    # @return [SurgeAPI::Resources::Recordings]
+    attr_reader :recordings
+
     # @return [SurgeAPI::Resources::Users]
     attr_reader :users
 
@@ -98,6 +101,7 @@ module SurgeAPI
       @contacts = SurgeAPI::Resources::Contacts.new(client: self)
       @messages = SurgeAPI::Resources::Messages.new(client: self)
       @phone_numbers = SurgeAPI::Resources::PhoneNumbers.new(client: self)
+      @recordings = SurgeAPI::Resources::Recordings.new(client: self)
       @users = SurgeAPI::Resources::Users.new(client: self)
       @verifications = SurgeAPI::Resources::Verifications.new(client: self)
       @webhooks = SurgeAPI::Resources::Webhooks.new(client: self)

data/lib/surge_api/internal/util.rb

@@ -485,7 +485,7 @@ module SurgeAPI
       end
 
       # @type [Regexp]
-      JSON_CONTENT = %r{^application/(?:vnd(?:\.[^.]+)*\+)?json(?!l)}
+      JSON_CONTENT = %r{^application/(?:[a-zA-Z0-9.-]+\+)?json(?!l)}
       # @type [Regexp]
       JSONL_CONTENT = %r{^application/(:?x-(?:n|l)djson)|(:?(?:x-)?jsonl)}
 

data/lib/surge_api/models/campaign.rb

@@ -60,6 +60,12 @@ module SurgeAPI
       #   @return [String]
       required :privacy_policy_url, String
 
+      # @!attribute status
+      #   The current status of the campaign.
+      #
+      #   @return [Symbol, SurgeAPI::Models::Campaign::Status]
+      required :status, enum: -> { SurgeAPI::Campaign::Status }
+
       # @!attribute use_cases
       #   A list containing 1-5 types of messages that will be sent with this campaign.
       #
@@ -125,7 +131,7 @@ module SurgeAPI
       #   @return [String, nil]
       optional :terms_and_conditions_url, String
 
-      # @!method initialize(id:, consent_flow:, description:, includes:, message_samples:, privacy_policy_url:, use_cases:, volume:, link_sample: nil, terms_and_conditions_url: nil)
+      # @!method initialize(id:, consent_flow:, description:, includes:, message_samples:, privacy_policy_url:, status:, use_cases:, volume:, link_sample: nil, terms_and_conditions_url: nil)
       #   Some parameter documentations has been truncated, see
       #   {SurgeAPI::Models::Campaign} for more details.
       #
@@ -144,6 +150,8 @@ module SurgeAPI
       #
       #   @param privacy_policy_url [String] The URL of the privacy policy for the brand in question. This may be a shared pr
       #
+      #   @param status [Symbol, SurgeAPI::Models::Campaign::Status] The current status of the campaign.
+      #
       #   @param use_cases [Array<Symbol, SurgeAPI::Models::Campaign::UseCase>] A list containing 1-5 types of messages that will be sent with this campaign.
       #
       #   @param volume [Symbol, SurgeAPI::Models::Campaign::Volume] This will be one of the following:
@@ -164,6 +172,24 @@ module SurgeAPI
         #   @return [Array<Symbol>]
       end
 
+      # The current status of the campaign.
+      #
+      # @see SurgeAPI::Models::Campaign#status
+      module Status
+        extend SurgeAPI::Internal::Type::Enum
+
+        ACTIVE = :active
+        CANCELED = :canceled
+        CREATED = :created
+        DEACTIVATED = :deactivated
+        IN_REVIEW = :in_review
+        PENDING = :pending
+        REJECTED = :rejected
+
+        # @!method self.values
+        #   @return [Array<Symbol>]
+      end
+
       module UseCase
         extend SurgeAPI::Internal::Type::Enum
 

data/lib/surge_api/models/campaign_retrieve_params.rb

@@ -0,0 +1,14 @@
+# frozen_string_literal: true
+
+module SurgeAPI
+  module Models
+    # @see SurgeAPI::Resources::Campaigns#retrieve
+    class CampaignRetrieveParams < SurgeAPI::Internal::Type::BaseModel
+      extend SurgeAPI::Internal::Type::RequestParameters::Converter
+      include SurgeAPI::Internal::Type::RequestParameters
+
+      # @!method initialize(request_options: {})
+      #   @param request_options [SurgeAPI::RequestOptions, Hash{Symbol=>Object}]
+    end
+  end
+end

data/lib/surge_api/models/message.rb

@@ -20,7 +20,7 @@ module SurgeAPI
       #   attribute messages back to a specific blast.
       #
       #   @return [String, nil]
-      optional :blast_id, String
+      optional :blast_id, String, nil?: true
 
       # @!attribute body
       #   The message body.
@@ -50,7 +50,7 @@ module SurgeAPI
       #
       #   @param attachments [Array<SurgeAPI::Models::Message::Attachment>]
       #
-      #   @param blast_id [String] The ID of the blast this message belongs to, if any. This can be used to attribu
+      #   @param blast_id [String, nil] The ID of the blast this message belongs to, if any. This can be used to attribu
       #
       #   @param body [String, nil] The message body.
       #

data/lib/surge_api/models/recording_completed_webhook_event.rb

@@ -0,0 +1,136 @@
+# frozen_string_literal: true
+
+module SurgeAPI
+  module Models
+    class RecordingCompletedWebhookEvent < SurgeAPI::Internal::Type::BaseModel
+      # @!attribute account_id
+      #   The ID of the account in which this event occurred
+      #
+      #   @return [String]
+      required :account_id, String
+
+      # @!attribute data
+      #   The data associated with the event
+      #
+      #   @return [SurgeAPI::Models::RecordingCompletedWebhookEvent::Data]
+      required :data, -> { SurgeAPI::RecordingCompletedWebhookEvent::Data }
+
+      # @!attribute timestamp
+      #   The timestamp when this event occurred, in ISO8601 format
+      #
+      #   @return [Time]
+      required :timestamp, Time
+
+      # @!attribute type
+      #   The type of the event. Always `recording.completed` for this event.
+      #
+      #   @return [Symbol, :"recording.completed"]
+      required :type, const: :"recording.completed"
+
+      # @!method initialize(account_id:, data:, timestamp:, type: :"recording.completed")
+      #   @param account_id [String] The ID of the account in which this event occurred
+      #
+      #   @param data [SurgeAPI::Models::RecordingCompletedWebhookEvent::Data] The data associated with the event
+      #
+      #   @param timestamp [Time] The timestamp when this event occurred, in ISO8601 format
+      #
+      #   @param type [Symbol, :"recording.completed"] The type of the event. Always `recording.completed` for this event.
+
+      # @see SurgeAPI::Models::RecordingCompletedWebhookEvent#data
+      class Data < SurgeAPI::Internal::Type::BaseModel
+        # @!attribute id
+        #   The unique identifier for the recording
+        #
+        #   @return [String]
+        required :id, String
+
+        # @!attribute call
+        #   The call that produced this recording
+        #
+        #   @return [SurgeAPI::Models::RecordingCompletedWebhookEvent::Data::Call]
+        required :call, -> { SurgeAPI::RecordingCompletedWebhookEvent::Data::Call }
+
+        # @!attribute duration
+        #   The duration of the recording in seconds
+        #
+        #   @return [Integer]
+        required :duration, Integer
+
+        # @!method initialize(id:, call:, duration:)
+        #   The data associated with the event
+        #
+        #   @param id [String] The unique identifier for the recording
+        #
+        #   @param call [SurgeAPI::Models::RecordingCompletedWebhookEvent::Data::Call] The call that produced this recording
+        #
+        #   @param duration [Integer] The duration of the recording in seconds
+
+        # @see SurgeAPI::Models::RecordingCompletedWebhookEvent::Data#call
+        class Call < SurgeAPI::Internal::Type::BaseModel
+          # @!attribute id
+          #   The unique identifier for the call
+          #
+          #   @return [String]
+          required :id, String
+
+          # @!attribute contact
+          #   A contact who has consented to receive messages
+          #
+          #   @return [SurgeAPI::Models::Contact]
+          required :contact, -> { SurgeAPI::Contact }
+
+          # @!attribute duration
+          #   The duration of the call in seconds
+          #
+          #   @return [Integer]
+          required :duration, Integer
+
+          # @!attribute initiated_at
+          #   When the call was initiated
+          #
+          #   @return [Time]
+          required :initiated_at, Time
+
+          # @!attribute status
+          #   The status of the call
+          #
+          #   @return [Symbol, SurgeAPI::Models::RecordingCompletedWebhookEvent::Data::Call::Status]
+          required :status, enum: -> { SurgeAPI::RecordingCompletedWebhookEvent::Data::Call::Status }
+
+          # @!method initialize(id:, contact:, duration:, initiated_at:, status:)
+          #   The call that produced this recording
+          #
+          #   @param id [String] The unique identifier for the call
+          #
+          #   @param contact [SurgeAPI::Models::Contact] A contact who has consented to receive messages
+          #
+          #   @param duration [Integer] The duration of the call in seconds
+          #
+          #   @param initiated_at [Time] When the call was initiated
+          #
+          #   @param status [Symbol, SurgeAPI::Models::RecordingCompletedWebhookEvent::Data::Call::Status] The status of the call
+
+          # The status of the call
+          #
+          # @see SurgeAPI::Models::RecordingCompletedWebhookEvent::Data::Call#status
+          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
+
+            # @!method self.values
+            #   @return [Array<Symbol>]
+          end
+        end
+      end
+    end
+  end
+end

data/lib/surge_api/models/recording_get_file_params.rb

@@ -0,0 +1,14 @@
+# frozen_string_literal: true
+
+module SurgeAPI
+  module Models
+    # @see SurgeAPI::Resources::Recordings#get_file
+    class RecordingGetFileParams < SurgeAPI::Internal::Type::BaseModel
+      extend SurgeAPI::Internal::Type::RequestParameters::Converter
+      include SurgeAPI::Internal::Type::RequestParameters
+
+      # @!method initialize(request_options: {})
+      #   @param request_options [SurgeAPI::RequestOptions, Hash{Symbol=>Object}]
+    end
+  end
+end

data/lib/surge_api/models/recording_get_file_response.rb

@@ -0,0 +1,19 @@
+# frozen_string_literal: true
+
+module SurgeAPI
+  module Models
+    # @see SurgeAPI::Resources::Recordings#get_file
+    class RecordingGetFileResponse < SurgeAPI::Internal::Type::BaseModel
+      # @!attribute error
+      #   An error response
+      #
+      #   @return [SurgeAPI::Models::Error]
+      required :error, -> { SurgeAPI::Error }
+
+      # @!method initialize(error:)
+      #   An error response
+      #
+      #   @param error [SurgeAPI::Models::Error] An error response
+    end
+  end
+end

data/lib/surge_api/models/unwrap_webhook_event.rb

@@ -27,8 +27,12 @@ module SurgeAPI
 
       variant :"message.sent", -> { SurgeAPI::MessageSentWebhookEvent }
 
+      variant :"recording.completed", -> { SurgeAPI::RecordingCompletedWebhookEvent }
+
+      variant :"voicemail.received", -> { SurgeAPI::VoicemailReceivedWebhookEvent }
+
       # @!method self.variants
-      #   @return [Array(SurgeAPI::Models::CallEndedWebhookEvent, SurgeAPI::Models::CampaignApprovedWebhookEvent, SurgeAPI::Models::ContactOptedInWebhookEvent, SurgeAPI::Models::ContactOptedOutWebhookEvent, SurgeAPI::Models::ConversationCreatedWebhookEvent, SurgeAPI::Models::LinkFollowedWebhookEvent, SurgeAPI::Models::MessageDeliveredWebhookEvent, SurgeAPI::Models::MessageFailedWebhookEvent, SurgeAPI::Models::MessageReceivedWebhookEvent, SurgeAPI::Models::MessageSentWebhookEvent)]
+      #   @return [Array(SurgeAPI::Models::CallEndedWebhookEvent, SurgeAPI::Models::CampaignApprovedWebhookEvent, SurgeAPI::Models::ContactOptedInWebhookEvent, SurgeAPI::Models::ContactOptedOutWebhookEvent, SurgeAPI::Models::ConversationCreatedWebhookEvent, SurgeAPI::Models::LinkFollowedWebhookEvent, SurgeAPI::Models::MessageDeliveredWebhookEvent, SurgeAPI::Models::MessageFailedWebhookEvent, SurgeAPI::Models::MessageReceivedWebhookEvent, SurgeAPI::Models::MessageSentWebhookEvent, SurgeAPI::Models::RecordingCompletedWebhookEvent, SurgeAPI::Models::VoicemailReceivedWebhookEvent)]
     end
   end
 end

data/lib/surge_api/models/voicemail_received_webhook_event.rb

@@ -0,0 +1,144 @@
+# frozen_string_literal: true
+
+module SurgeAPI
+  module Models
+    class VoicemailReceivedWebhookEvent < SurgeAPI::Internal::Type::BaseModel
+      # @!attribute account_id
+      #   The ID of the account in which this event occurred
+      #
+      #   @return [String]
+      required :account_id, String
+
+      # @!attribute data
+      #   The data associated with the event
+      #
+      #   @return [SurgeAPI::Models::VoicemailReceivedWebhookEvent::Data]
+      required :data, -> { SurgeAPI::VoicemailReceivedWebhookEvent::Data }
+
+      # @!attribute timestamp
+      #   The timestamp when this event occurred, in ISO8601 format
+      #
+      #   @return [Time]
+      required :timestamp, Time
+
+      # @!attribute type
+      #   The type of the event. Always `voicemail.received` for this event.
+      #
+      #   @return [Symbol, :"voicemail.received"]
+      required :type, const: :"voicemail.received"
+
+      # @!method initialize(account_id:, data:, timestamp:, type: :"voicemail.received")
+      #   @param account_id [String] The ID of the account in which this event occurred
+      #
+      #   @param data [SurgeAPI::Models::VoicemailReceivedWebhookEvent::Data] The data associated with the event
+      #
+      #   @param timestamp [Time] The timestamp when this event occurred, in ISO8601 format
+      #
+      #   @param type [Symbol, :"voicemail.received"] The type of the event. Always `voicemail.received` for this event.
+
+      # @see SurgeAPI::Models::VoicemailReceivedWebhookEvent#data
+      class Data < SurgeAPI::Internal::Type::BaseModel
+        # @!attribute id
+        #   The unique identifier for the voicemail
+        #
+        #   @return [String]
+        required :id, String
+
+        # @!attribute call
+        #   The call that resulted in this voicemail
+        #
+        #   @return [SurgeAPI::Models::VoicemailReceivedWebhookEvent::Data::Call]
+        required :call, -> { SurgeAPI::VoicemailReceivedWebhookEvent::Data::Call }
+
+        # @!attribute duration
+        #   The duration of the voicemail in seconds
+        #
+        #   @return [Integer]
+        required :duration, Integer
+
+        # @!attribute recording_id
+        #   The unique identifier for the recording
+        #
+        #   @return [String]
+        required :recording_id, String
+
+        # @!method initialize(id:, call:, duration:, recording_id:)
+        #   The data associated with the event
+        #
+        #   @param id [String] The unique identifier for the voicemail
+        #
+        #   @param call [SurgeAPI::Models::VoicemailReceivedWebhookEvent::Data::Call] The call that resulted in this voicemail
+        #
+        #   @param duration [Integer] The duration of the voicemail in seconds
+        #
+        #   @param recording_id [String] The unique identifier for the recording
+
+        # @see SurgeAPI::Models::VoicemailReceivedWebhookEvent::Data#call
+        class Call < SurgeAPI::Internal::Type::BaseModel
+          # @!attribute id
+          #   The unique identifier for the call
+          #
+          #   @return [String]
+          required :id, String
+
+          # @!attribute contact
+          #   A contact who has consented to receive messages
+          #
+          #   @return [SurgeAPI::Models::Contact]
+          required :contact, -> { SurgeAPI::Contact }
+
+          # @!attribute duration
+          #   The duration of the call in seconds
+          #
+          #   @return [Integer]
+          required :duration, Integer
+
+          # @!attribute initiated_at
+          #   When the call was initiated
+          #
+          #   @return [Time]
+          required :initiated_at, Time
+
+          # @!attribute status
+          #   The status of the call
+          #
+          #   @return [Symbol, SurgeAPI::Models::VoicemailReceivedWebhookEvent::Data::Call::Status]
+          required :status, enum: -> { SurgeAPI::VoicemailReceivedWebhookEvent::Data::Call::Status }
+
+          # @!method initialize(id:, contact:, duration:, initiated_at:, status:)
+          #   The call that resulted in this voicemail
+          #
+          #   @param id [String] The unique identifier for the call
+          #
+          #   @param contact [SurgeAPI::Models::Contact] A contact who has consented to receive messages
+          #
+          #   @param duration [Integer] The duration of the call in seconds
+          #
+          #   @param initiated_at [Time] When the call was initiated
+          #
+          #   @param status [Symbol, SurgeAPI::Models::VoicemailReceivedWebhookEvent::Data::Call::Status] The status of the call
+
+          # The status of the call
+          #
+          # @see SurgeAPI::Models::VoicemailReceivedWebhookEvent::Data::Call#status
+          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
+
+            # @!method self.values
+            #   @return [Array<Symbol>]
+          end
+        end
+      end
+    end
+  end
+end

data/lib/surge_api/models.rb

@@ -65,6 +65,8 @@ module SurgeAPI
 
   CampaignParams = SurgeAPI::Models::CampaignParams
 
+  CampaignRetrieveParams = SurgeAPI::Models::CampaignRetrieveParams
+
   Contact = SurgeAPI::Models::Contact
 
   ContactCreateParams = SurgeAPI::Models::ContactCreateParams
@@ -111,6 +113,10 @@ module SurgeAPI
 
   PhoneNumberPurchaseParams = SurgeAPI::Models::PhoneNumberPurchaseParams
 
+  RecordingCompletedWebhookEvent = SurgeAPI::Models::RecordingCompletedWebhookEvent
+
+  RecordingGetFileParams = SurgeAPI::Models::RecordingGetFileParams
+
   UnwrapWebhookEvent = SurgeAPI::Models::UnwrapWebhookEvent
 
   User = SurgeAPI::Models::User
@@ -135,5 +141,7 @@ module SurgeAPI
 
   VerificationCreateParams = SurgeAPI::Models::VerificationCreateParams
 
+  VoicemailReceivedWebhookEvent = SurgeAPI::Models::VoicemailReceivedWebhookEvent
+
   WebhookUnwrapParams = SurgeAPI::Models::WebhookUnwrapParams
 end

data/lib/surge_api/resources/campaigns.rb

@@ -35,6 +35,26 @@ module SurgeAPI
         )
       end
 
+      # Retrieves a Campaign object.
+      #
+      # @overload retrieve(id, request_options: {})
+      #
+      # @param id [String] The ID of the campaign to retrieve.
+      #
+      # @param request_options [SurgeAPI::RequestOptions, Hash{Symbol=>Object}, nil]
+      #
+      # @return [SurgeAPI::Models::Campaign]
+      #
+      # @see SurgeAPI::Models::CampaignRetrieveParams
+      def retrieve(id, params = {})
+        @client.request(
+          method: :get,
+          path: ["campaigns/%1$s", id],
+          model: SurgeAPI::Campaign,
+          options: params[:request_options]
+        )
+      end
+
       # @api private
       #
       # @param client [SurgeAPI::Client]

data/lib/surge_api/resources/recordings.rb

@@ -0,0 +1,35 @@
+# frozen_string_literal: true
+
+module SurgeAPI
+  module Resources
+    class Recordings
+      # Redirects to a signed URL where the recording audio file can be downloaded. URL
+      # is short-lived, so redirect should be followed immediately.
+      #
+      # @overload get_file(recording_id, request_options: {})
+      #
+      # @param recording_id [String] The ID of the recording.
+      #
+      # @param request_options [SurgeAPI::RequestOptions, Hash{Symbol=>Object}, nil]
+      #
+      # @return [SurgeAPI::Models::RecordingGetFileResponse]
+      #
+      # @see SurgeAPI::Models::RecordingGetFileParams
+      def get_file(recording_id, params = {})
+        @client.request(
+          method: :get,
+          path: ["recordings/%1$s/file", recording_id],
+          model: SurgeAPI::Models::RecordingGetFileResponse,
+          options: params[:request_options]
+        )
+      end
+
+      # @api private
+      #
+      # @param client [SurgeAPI::Client]
+      def initialize(client:)
+        @client = client
+      end
+    end
+  end
+end

data/lib/surge_api/resources/webhooks.rb

@@ -5,7 +5,7 @@ module SurgeAPI
     class Webhooks
       # @param payload [String] The raw webhook payload as a string
       #
-      # @return [SurgeAPI::Models::CallEndedWebhookEvent, SurgeAPI::Models::CampaignApprovedWebhookEvent, SurgeAPI::Models::ContactOptedInWebhookEvent, SurgeAPI::Models::ContactOptedOutWebhookEvent, SurgeAPI::Models::ConversationCreatedWebhookEvent, SurgeAPI::Models::LinkFollowedWebhookEvent, SurgeAPI::Models::MessageDeliveredWebhookEvent, SurgeAPI::Models::MessageFailedWebhookEvent, SurgeAPI::Models::MessageReceivedWebhookEvent, SurgeAPI::Models::MessageSentWebhookEvent]
+      # @return [SurgeAPI::Models::CallEndedWebhookEvent, SurgeAPI::Models::CampaignApprovedWebhookEvent, SurgeAPI::Models::ContactOptedInWebhookEvent, SurgeAPI::Models::ContactOptedOutWebhookEvent, SurgeAPI::Models::ConversationCreatedWebhookEvent, SurgeAPI::Models::LinkFollowedWebhookEvent, SurgeAPI::Models::MessageDeliveredWebhookEvent, SurgeAPI::Models::MessageFailedWebhookEvent, SurgeAPI::Models::MessageReceivedWebhookEvent, SurgeAPI::Models::MessageSentWebhookEvent, SurgeAPI::Models::RecordingCompletedWebhookEvent, SurgeAPI::Models::VoicemailReceivedWebhookEvent]
       def unwrap(payload)
         parsed = JSON.parse(payload, symbolize_names: true)
         SurgeAPI::Internal::Type::Converter.coerce(SurgeAPI::Models::UnwrapWebhookEvent, parsed)

data/lib/surge_api/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module SurgeAPI
-  VERSION = "0.9.0"
+  VERSION = "0.10.0"
 end

data/lib/surge_api.rb

@@ -67,6 +67,7 @@ require_relative "surge_api/models/call_ended_webhook_event"
 require_relative "surge_api/models/campaign"
 require_relative "surge_api/models/campaign_approved_webhook_event"
 require_relative "surge_api/models/campaign_create_params"
+require_relative "surge_api/models/campaign_retrieve_params"
 require_relative "surge_api/models/contact"
 require_relative "surge_api/models/contact_create_params"
 require_relative "surge_api/models/contact_list_params"
@@ -89,6 +90,9 @@ require_relative "surge_api/models/organization"
 require_relative "surge_api/models/phone_number"
 require_relative "surge_api/models/phone_number_list_params"
 require_relative "surge_api/models/phone_number_purchase_params"
+require_relative "surge_api/models/recording_completed_webhook_event"
+require_relative "surge_api/models/recording_get_file_params"
+require_relative "surge_api/models/recording_get_file_response"
 require_relative "surge_api/models/unwrap_webhook_event"
 require_relative "surge_api/models/user"
 require_relative "surge_api/models/user_create_params"
@@ -101,6 +105,7 @@ require_relative "surge_api/models/verification"
 require_relative "surge_api/models/verification_check"
 require_relative "surge_api/models/verification_check_params"
 require_relative "surge_api/models/verification_create_params"
+require_relative "surge_api/models/voicemail_received_webhook_event"
 require_relative "surge_api/models/webhook_unwrap_params"
 require_relative "surge_api/models"
 require_relative "surge_api/resources/accounts"
@@ -109,6 +114,7 @@ require_relative "surge_api/resources/campaigns"
 require_relative "surge_api/resources/contacts"
 require_relative "surge_api/resources/messages"
 require_relative "surge_api/resources/phone_numbers"
+require_relative "surge_api/resources/recordings"
 require_relative "surge_api/resources/users"
 require_relative "surge_api/resources/verifications"
 require_relative "surge_api/resources/webhooks"

data/rbi/surge_api/client.rbi

@@ -31,6 +31,9 @@ module SurgeAPI
     sig { returns(SurgeAPI::Resources::PhoneNumbers) }
     attr_reader :phone_numbers
 
+    sig { returns(SurgeAPI::Resources::Recordings) }
+    attr_reader :recordings
+
     sig { returns(SurgeAPI::Resources::Users) }
     attr_reader :users
 

data/rbi/surge_api/internal/util.rbi

@@ -296,7 +296,7 @@ module SurgeAPI
       end
 
       JSON_CONTENT =
-        T.let(%r{^application/(?:vnd(?:\.[^.]+)*\+)?json(?!l)}, Regexp)
+        T.let(%r{^application/(?:[a-zA-Z0-9.-]+\+)?json(?!l)}, Regexp)
       JSONL_CONTENT =
         T.let(%r{^application/(:?x-(?:n|l)djson)|(:?(?:x-)?jsonl)}, Regexp)