surge_api 0.1.0 → 0.2.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: bd72992441d9bff1aa161673f62cd5957d2f626eee83f83dfd3f259341377826
-  data.tar.gz: 37b27a1c5c4aa7406a0c81753b3b93469bb6181055cc3e9c6e4c9737cd2317a0
+  metadata.gz: 71252990f4c5eb46dec5222b3dd1307f1c347b59ef3a2c7a1aa6ac646555c920
+  data.tar.gz: 671de5440b15ba3455652ffcf8b8f0752c6e4827750a99dcb288bfa26cf65acd
 SHA512:
-  metadata.gz: 5482581f94873824fd774a5abcac9fcfb723c168cd3fc84f6f05603cc887e66870b3407f6a1546777c2f82b920ce3fc9c798c8fbc522fa8b42398cc8b10274c0
-  data.tar.gz: 8897a9b535eeac8e8b995e23e2b7793ecf57474f14d13ded041f4ba91eaa6f9730912ac844287621ff427d8eb7fddff3151e8e1b311745947b81794692ec92c8
+  metadata.gz: 4595e79a8c3fccbdf83430c0242b378b70acb7f52471a5177e9b78542889f310c62c8d5a6d41515a8cfd6ef72df9a298428274645b0b38f8f61eeb42ea0a3c57
+  data.tar.gz: 538a4232414a89f66dd781f0bda3a4e8257cdf9a88d7a07d3efef95345a26a93f895d696b54a6ff3c987f29fac2d62abda9e9c44532786d2e145d8b24c3da6b7

data/CHANGELOG.md

@@ -1,5 +1,24 @@
 # Changelog
 
+## 0.2.0 (2025-10-09)
+
+Full Changelog: [v0.1.0...v0.2.0](https://github.com/surgeapi/ruby-sdk/compare/v0.1.0...v0.2.0)
+
+### Features
+
+* **api:** api update ([8a7eeeb](https://github.com/surgeapi/ruby-sdk/commit/8a7eeeb4c5248d0f0aa4da399c45d2763b98ba3b))
+
+
+### Bug Fixes
+
+* always send `filename=...` for multipart requests where a file is expected ([28bdedf](https://github.com/surgeapi/ruby-sdk/commit/28bdedfba8e9bef43abf39e08169bc2bf2edb0e8))
+* coroutine leaks from connection pool ([239043f](https://github.com/surgeapi/ruby-sdk/commit/239043f74e12856fb8e6b2a477ea9bf35945f2f2))
+
+
+### Chores
+
+* ignore linter error for tests having large collections ([4d89802](https://github.com/surgeapi/ruby-sdk/commit/4d898024ffae04e4f24591b1c54a922e1b6c51f4))
+
 ## 0.1.0 (2025-09-26)
 
 Full Changelog: [v0.0.1...v0.1.0](https://github.com/surgeapi/ruby-sdk/compare/v0.0.1...v0.1.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.1.0"
+gem "surge_api", "~> 0.2.0"
 ```
 
 <!-- x-release-please-end -->

data/lib/surge_api/file_part.rb

@@ -38,18 +38,21 @@ module SurgeAPI
     def to_yaml(*a) = read.to_yaml(*a)
 
     # @param content [Pathname, StringIO, IO, String]
-    # @param filename [String, nil]
+    # @param filename [Pathname, String, nil]
     # @param content_type [String, nil]
     def initialize(content, filename: nil, content_type: nil)
-      @content = content
+      @content_type = content_type
       @filename =
-        case content
-        in Pathname
-          filename.nil? ? content.basename.to_path : ::File.basename(filename)
+        case [filename, (@content = content)]
+        in [String | Pathname, _]
+          ::File.basename(filename)
+        in [nil, Pathname]
+          content.basename.to_path
+        in [nil, IO]
+          content.to_path
         else
-          filename.nil? ? nil : ::File.basename(filename)
+          filename
         end
-      @content_type = content_type
     end
   end
 end

data/lib/surge_api/internal/transport/pooled_net_requester.rb

@@ -134,9 +134,9 @@ module SurgeAPI
 
           # rubocop:disable Metrics/BlockLength
           enum = Enumerator.new do |y|
-            with_pool(url, deadline: deadline) do |conn|
-              next if finished
+            next if finished
 
+            with_pool(url, deadline: deadline) do |conn|
               req, closing = self.class.build_request(request) do
                 self.class.calibrate_socket_timeout(conn, deadline)
               end
@@ -149,7 +149,7 @@ module SurgeAPI
 
               self.class.calibrate_socket_timeout(conn, deadline)
               conn.request(req) do |rsp|
-                y << [conn, req, rsp]
+                y << [req, rsp]
                 break if finished
 
                 rsp.read_body do |bytes|
@@ -160,6 +160,8 @@ module SurgeAPI
                 end
                 eof = true
               end
+            ensure
+              conn.finish if !eof && conn&.started?
             end
           rescue Timeout::Error
             raise SurgeAPI::Errors::APITimeoutError.new(url: url, request: req)
@@ -168,16 +170,11 @@ module SurgeAPI
           end
           # rubocop:enable Metrics/BlockLength
 
-          conn, _, response = enum.next
+          _, response = enum.next
           body = SurgeAPI::Internal::Util.fused_enum(enum, external: true) do
             finished = true
-            tap do
-              enum.next
-            rescue StopIteration
-              nil
-            end
+            loop { enum.next }
           ensure
-            conn.finish if !eof && conn&.started?
             closing&.call
           end
           [Integer(response.code), response, body]

data/lib/surge_api/internal/type/file_input.rb

@@ -82,17 +82,20 @@ module SurgeAPI
           #
           # @return [Pathname, StringIO, IO, String, Object]
           def dump(value, state:)
-            # rubocop:disable Lint/DuplicateBranch
             case value
+            in StringIO | String
+              # https://datatracker.ietf.org/doc/html/rfc7578#section-4.2
+              # while not required, a filename is recommended, and in practice many servers do expect this
+              SurgeAPI::FilePart.new(value, filename: "upload")
             in IO
               state[:can_retry] = false
+              value.to_path.nil? ? SurgeAPI::FilePart.new(value, filename: "upload") : value
             in SurgeAPI::FilePart if value.content.is_a?(IO)
               state[:can_retry] = false
+              value
             else
+              value
             end
-            # rubocop:enable Lint/DuplicateBranch
-
-            value
           end
 
           # @api private

data/lib/surge_api/internal/type/union.rb

@@ -12,7 +12,7 @@ module SurgeAPI
       #     puts(unwrap_webhook_event.account_id)
       #   when SurgeAPI::CampaignApprovedWebhookEvent
       #     puts(unwrap_webhook_event.data)
-      #   when SurgeAPI::ConversationCreatedWebhookEvent
+      #   when SurgeAPI::ContactOptedInWebhookEvent
       #     puts(unwrap_webhook_event.timestamp)
       #   else
       #     puts(unwrap_webhook_event)

data/lib/surge_api/models/contact_opted_in_webhook_event.rb

@@ -0,0 +1,54 @@
+# frozen_string_literal: true
+
+module SurgeAPI
+  module Models
+    class ContactOptedInWebhookEvent < 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::ContactOptedInWebhookEvent::Data]
+      required :data, -> { SurgeAPI::ContactOptedInWebhookEvent::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 `contact.opted_in` for this event.
+      #
+      #   @return [Symbol, :"contact.opted_in"]
+      required :type, const: :"contact.opted_in"
+
+      # @!method initialize(account_id:, data:, timestamp:, type: :"contact.opted_in")
+      #   @param account_id [String] The ID of the account in which this event occurred
+      #
+      #   @param data [SurgeAPI::Models::ContactOptedInWebhookEvent::Data] The data associated with the event
+      #
+      #   @param timestamp [Time] The timestamp when this event occurred, in ISO8601 format
+      #
+      #   @param type [Symbol, :"contact.opted_in"] The type of the event. Always `contact.opted_in` for this event.
+
+      # @see SurgeAPI::Models::ContactOptedInWebhookEvent#data
+      class Data < SurgeAPI::Internal::Type::BaseModel
+        # @!attribute id
+        #   The unique identifier for the contact
+        #
+        #   @return [String]
+        required :id, String
+
+        # @!method initialize(id:)
+        #   The data associated with the event
+        #
+        #   @param id [String] The unique identifier for the contact
+      end
+    end
+  end
+end

data/lib/surge_api/models/contact_opted_out_webhook_event.rb

@@ -0,0 +1,54 @@
+# frozen_string_literal: true
+
+module SurgeAPI
+  module Models
+    class ContactOptedOutWebhookEvent < 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::ContactOptedOutWebhookEvent::Data]
+      required :data, -> { SurgeAPI::ContactOptedOutWebhookEvent::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 `contact.opted_out` for this event.
+      #
+      #   @return [Symbol, :"contact.opted_out"]
+      required :type, const: :"contact.opted_out"
+
+      # @!method initialize(account_id:, data:, timestamp:, type: :"contact.opted_out")
+      #   @param account_id [String] The ID of the account in which this event occurred
+      #
+      #   @param data [SurgeAPI::Models::ContactOptedOutWebhookEvent::Data] The data associated with the event
+      #
+      #   @param timestamp [Time] The timestamp when this event occurred, in ISO8601 format
+      #
+      #   @param type [Symbol, :"contact.opted_out"] The type of the event. Always `contact.opted_out` for this event.
+
+      # @see SurgeAPI::Models::ContactOptedOutWebhookEvent#data
+      class Data < SurgeAPI::Internal::Type::BaseModel
+        # @!attribute id
+        #   The unique identifier for the contact
+        #
+        #   @return [String]
+        required :id, String
+
+        # @!method initialize(id:)
+        #   The data associated with the event
+        #
+        #   @param id [String] The unique identifier for the contact
+      end
+    end
+  end
+end

data/lib/surge_api/models/unwrap_webhook_event.rb

@@ -9,6 +9,10 @@ module SurgeAPI
 
       variant -> { SurgeAPI::CampaignApprovedWebhookEvent }
 
+      variant -> { SurgeAPI::ContactOptedInWebhookEvent }
+
+      variant -> { SurgeAPI::ContactOptedOutWebhookEvent }
+
       variant -> { SurgeAPI::ConversationCreatedWebhookEvent }
 
       variant -> { SurgeAPI::MessageDeliveredWebhookEvent }
@@ -20,7 +24,7 @@ module SurgeAPI
       variant -> { SurgeAPI::MessageSentWebhookEvent }
 
       # @!method self.variants
-      #   @return [Array(SurgeAPI::Models::CallEndedWebhookEvent, SurgeAPI::Models::CampaignApprovedWebhookEvent, SurgeAPI::Models::ConversationCreatedWebhookEvent, 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::MessageDeliveredWebhookEvent, SurgeAPI::Models::MessageFailedWebhookEvent, SurgeAPI::Models::MessageReceivedWebhookEvent, SurgeAPI::Models::MessageSentWebhookEvent)]
     end
   end
 end

data/lib/surge_api/models.rb

@@ -65,6 +65,10 @@ module SurgeAPI
 
   ContactCreateParams = SurgeAPI::Models::ContactCreateParams
 
+  ContactOptedInWebhookEvent = SurgeAPI::Models::ContactOptedInWebhookEvent
+
+  ContactOptedOutWebhookEvent = SurgeAPI::Models::ContactOptedOutWebhookEvent
+
   ContactRetrieveParams = SurgeAPI::Models::ContactRetrieveParams
 
   ContactUpdateParams = SurgeAPI::Models::ContactUpdateParams

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::ConversationCreatedWebhookEvent, 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::MessageDeliveredWebhookEvent, SurgeAPI::Models::MessageFailedWebhookEvent, SurgeAPI::Models::MessageReceivedWebhookEvent, SurgeAPI::Models::MessageSentWebhookEvent]
       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.1.0"
+  VERSION = "0.2.0"
 end

data/lib/surge_api.rb

@@ -63,6 +63,8 @@ require_relative "surge_api/models/campaign_approved_webhook_event"
 require_relative "surge_api/models/campaign_create_params"
 require_relative "surge_api/models/contact"
 require_relative "surge_api/models/contact_create_params"
+require_relative "surge_api/models/contact_opted_in_webhook_event"
+require_relative "surge_api/models/contact_opted_out_webhook_event"
 require_relative "surge_api/models/contact_retrieve_params"
 require_relative "surge_api/models/contact_update_params"
 require_relative "surge_api/models/conversation_created_webhook_event"

data/rbi/surge_api/file_part.rbi

@@ -27,7 +27,7 @@ module SurgeAPI
     sig do
       params(
         content: T.any(Pathname, StringIO, IO, String),
-        filename: T.nilable(String),
+        filename: T.nilable(T.any(Pathname, String)),
         content_type: T.nilable(String)
       ).returns(T.attached_class)
     end

data/rbi/surge_api/models/contact_opted_in_webhook_event.rbi

@@ -0,0 +1,95 @@
+# typed: strong
+
+module SurgeAPI
+  module Models
+    class ContactOptedInWebhookEvent < SurgeAPI::Internal::Type::BaseModel
+      OrHash =
+        T.type_alias do
+          T.any(
+            SurgeAPI::ContactOptedInWebhookEvent,
+            SurgeAPI::Internal::AnyHash
+          )
+        end
+
+      # The ID of the account in which this event occurred
+      sig { returns(String) }
+      attr_accessor :account_id
+
+      # The data associated with the event
+      sig { returns(SurgeAPI::ContactOptedInWebhookEvent::Data) }
+      attr_reader :data
+
+      sig do
+        params(data: SurgeAPI::ContactOptedInWebhookEvent::Data::OrHash).void
+      end
+      attr_writer :data
+
+      # The timestamp when this event occurred, in ISO8601 format
+      sig { returns(Time) }
+      attr_accessor :timestamp
+
+      # The type of the event. Always `contact.opted_in` for this event.
+      sig { returns(Symbol) }
+      attr_accessor :type
+
+      sig do
+        params(
+          account_id: String,
+          data: SurgeAPI::ContactOptedInWebhookEvent::Data::OrHash,
+          timestamp: Time,
+          type: Symbol
+        ).returns(T.attached_class)
+      end
+      def self.new(
+        # The ID of the account in which this event occurred
+        account_id:,
+        # The data associated with the event
+        data:,
+        # The timestamp when this event occurred, in ISO8601 format
+        timestamp:,
+        # The type of the event. Always `contact.opted_in` for this event.
+        type: :"contact.opted_in"
+      )
+      end
+
+      sig do
+        override.returns(
+          {
+            account_id: String,
+            data: SurgeAPI::ContactOptedInWebhookEvent::Data,
+            timestamp: Time,
+            type: Symbol
+          }
+        )
+      end
+      def to_hash
+      end
+
+      class Data < SurgeAPI::Internal::Type::BaseModel
+        OrHash =
+          T.type_alias do
+            T.any(
+              SurgeAPI::ContactOptedInWebhookEvent::Data,
+              SurgeAPI::Internal::AnyHash
+            )
+          end
+
+        # The unique identifier for the contact
+        sig { returns(String) }
+        attr_accessor :id
+
+        # The data associated with the event
+        sig { params(id: String).returns(T.attached_class) }
+        def self.new(
+          # The unique identifier for the contact
+          id:
+        )
+        end
+
+        sig { override.returns({ id: String }) }
+        def to_hash
+        end
+      end
+    end
+  end
+end

data/rbi/surge_api/models/contact_opted_out_webhook_event.rbi

@@ -0,0 +1,95 @@
+# typed: strong
+
+module SurgeAPI
+  module Models
+    class ContactOptedOutWebhookEvent < SurgeAPI::Internal::Type::BaseModel
+      OrHash =
+        T.type_alias do
+          T.any(
+            SurgeAPI::ContactOptedOutWebhookEvent,
+            SurgeAPI::Internal::AnyHash
+          )
+        end
+
+      # The ID of the account in which this event occurred
+      sig { returns(String) }
+      attr_accessor :account_id
+
+      # The data associated with the event
+      sig { returns(SurgeAPI::ContactOptedOutWebhookEvent::Data) }
+      attr_reader :data
+
+      sig do
+        params(data: SurgeAPI::ContactOptedOutWebhookEvent::Data::OrHash).void
+      end
+      attr_writer :data
+
+      # The timestamp when this event occurred, in ISO8601 format
+      sig { returns(Time) }
+      attr_accessor :timestamp
+
+      # The type of the event. Always `contact.opted_out` for this event.
+      sig { returns(Symbol) }
+      attr_accessor :type
+
+      sig do
+        params(
+          account_id: String,
+          data: SurgeAPI::ContactOptedOutWebhookEvent::Data::OrHash,
+          timestamp: Time,
+          type: Symbol
+        ).returns(T.attached_class)
+      end
+      def self.new(
+        # The ID of the account in which this event occurred
+        account_id:,
+        # The data associated with the event
+        data:,
+        # The timestamp when this event occurred, in ISO8601 format
+        timestamp:,
+        # The type of the event. Always `contact.opted_out` for this event.
+        type: :"contact.opted_out"
+      )
+      end
+
+      sig do
+        override.returns(
+          {
+            account_id: String,
+            data: SurgeAPI::ContactOptedOutWebhookEvent::Data,
+            timestamp: Time,
+            type: Symbol
+          }
+        )
+      end
+      def to_hash
+      end
+
+      class Data < SurgeAPI::Internal::Type::BaseModel
+        OrHash =
+          T.type_alias do
+            T.any(
+              SurgeAPI::ContactOptedOutWebhookEvent::Data,
+              SurgeAPI::Internal::AnyHash
+            )
+          end
+
+        # The unique identifier for the contact
+        sig { returns(String) }
+        attr_accessor :id
+
+        # The data associated with the event
+        sig { params(id: String).returns(T.attached_class) }
+        def self.new(
+          # The unique identifier for the contact
+          id:
+        )
+        end
+
+        sig { override.returns({ id: String }) }
+        def to_hash
+        end
+      end
+    end
+  end
+end

data/rbi/surge_api/models/unwrap_webhook_event.rbi

@@ -10,6 +10,8 @@ module SurgeAPI
           T.any(
             SurgeAPI::CallEndedWebhookEvent,
             SurgeAPI::CampaignApprovedWebhookEvent,
+            SurgeAPI::ContactOptedInWebhookEvent,
+            SurgeAPI::ContactOptedOutWebhookEvent,
             SurgeAPI::ConversationCreatedWebhookEvent,
             SurgeAPI::MessageDeliveredWebhookEvent,
             SurgeAPI::MessageFailedWebhookEvent,

data/rbi/surge_api/models.rbi

@@ -27,6 +27,10 @@ module SurgeAPI
 
   ContactCreateParams = SurgeAPI::Models::ContactCreateParams
 
+  ContactOptedInWebhookEvent = SurgeAPI::Models::ContactOptedInWebhookEvent
+
+  ContactOptedOutWebhookEvent = SurgeAPI::Models::ContactOptedOutWebhookEvent
+
   ContactRetrieveParams = SurgeAPI::Models::ContactRetrieveParams
 
   ContactUpdateParams = SurgeAPI::Models::ContactUpdateParams

data/rbi/surge_api/resources/webhooks.rbi

@@ -8,6 +8,8 @@ module SurgeAPI
           T.any(
             SurgeAPI::CallEndedWebhookEvent,
             SurgeAPI::CampaignApprovedWebhookEvent,
+            SurgeAPI::ContactOptedInWebhookEvent,
+            SurgeAPI::ContactOptedOutWebhookEvent,
             SurgeAPI::ConversationCreatedWebhookEvent,
             SurgeAPI::MessageDeliveredWebhookEvent,
             SurgeAPI::MessageFailedWebhookEvent,

data/sig/surge_api/file_part.rbs

@@ -14,7 +14,7 @@ module SurgeAPI
 
     def initialize: (
       Pathname | StringIO | IO | String content,
-      ?filename: String?,
+      ?filename: (Pathname | String)?,
       ?content_type: String?
     ) -> void
   end

data/sig/surge_api/models/contact_opted_in_webhook_event.rbs

@@ -0,0 +1,45 @@
+module SurgeAPI
+  module Models
+    type contact_opted_in_webhook_event =
+      {
+        account_id: String,
+        data: SurgeAPI::ContactOptedInWebhookEvent::Data,
+        timestamp: Time,
+        type: :"contact.opted_in"
+      }
+
+    class ContactOptedInWebhookEvent < SurgeAPI::Internal::Type::BaseModel
+      attr_accessor account_id: String
+
+      attr_accessor data: SurgeAPI::ContactOptedInWebhookEvent::Data
+
+      attr_accessor timestamp: Time
+
+      attr_accessor type: :"contact.opted_in"
+
+      def initialize: (
+        account_id: String,
+        data: SurgeAPI::ContactOptedInWebhookEvent::Data,
+        timestamp: Time,
+        ?type: :"contact.opted_in"
+      ) -> void
+
+      def to_hash: -> {
+        account_id: String,
+        data: SurgeAPI::ContactOptedInWebhookEvent::Data,
+        timestamp: Time,
+        type: :"contact.opted_in"
+      }
+
+      type data = { id: String }
+
+      class Data < SurgeAPI::Internal::Type::BaseModel
+        attr_accessor id: String
+
+        def initialize: (id: String) -> void
+
+        def to_hash: -> { id: String }
+      end
+    end
+  end
+end

data/sig/surge_api/models/contact_opted_out_webhook_event.rbs

@@ -0,0 +1,45 @@
+module SurgeAPI
+  module Models
+    type contact_opted_out_webhook_event =
+      {
+        account_id: String,
+        data: SurgeAPI::ContactOptedOutWebhookEvent::Data,
+        timestamp: Time,
+        type: :"contact.opted_out"
+      }
+
+    class ContactOptedOutWebhookEvent < SurgeAPI::Internal::Type::BaseModel
+      attr_accessor account_id: String
+
+      attr_accessor data: SurgeAPI::ContactOptedOutWebhookEvent::Data
+
+      attr_accessor timestamp: Time
+
+      attr_accessor type: :"contact.opted_out"
+
+      def initialize: (
+        account_id: String,
+        data: SurgeAPI::ContactOptedOutWebhookEvent::Data,
+        timestamp: Time,
+        ?type: :"contact.opted_out"
+      ) -> void
+
+      def to_hash: -> {
+        account_id: String,
+        data: SurgeAPI::ContactOptedOutWebhookEvent::Data,
+        timestamp: Time,
+        type: :"contact.opted_out"
+      }
+
+      type data = { id: String }
+
+      class Data < SurgeAPI::Internal::Type::BaseModel
+        attr_accessor id: String
+
+        def initialize: (id: String) -> void
+
+        def to_hash: -> { id: String }
+      end
+    end
+  end
+end

data/sig/surge_api/models/unwrap_webhook_event.rbs

@@ -3,6 +3,8 @@ module SurgeAPI
     type unwrap_webhook_event =
       SurgeAPI::CallEndedWebhookEvent
       | SurgeAPI::CampaignApprovedWebhookEvent
+      | SurgeAPI::ContactOptedInWebhookEvent
+      | SurgeAPI::ContactOptedOutWebhookEvent
       | SurgeAPI::ConversationCreatedWebhookEvent
       | SurgeAPI::MessageDeliveredWebhookEvent
       | SurgeAPI::MessageFailedWebhookEvent

data/sig/surge_api/models.rbs

@@ -25,6 +25,10 @@ module SurgeAPI
 
   class ContactCreateParams = SurgeAPI::Models::ContactCreateParams
 
+  class ContactOptedInWebhookEvent = SurgeAPI::Models::ContactOptedInWebhookEvent
+
+  class ContactOptedOutWebhookEvent = SurgeAPI::Models::ContactOptedOutWebhookEvent
+
   class ContactRetrieveParams = SurgeAPI::Models::ContactRetrieveParams
 
   class ContactUpdateParams = SurgeAPI::Models::ContactUpdateParams

data/sig/surge_api/resources/webhooks.rbs

@@ -5,6 +5,8 @@ module SurgeAPI
         String payload
       ) -> (SurgeAPI::CallEndedWebhookEvent
       | SurgeAPI::CampaignApprovedWebhookEvent
+      | SurgeAPI::ContactOptedInWebhookEvent
+      | SurgeAPI::ContactOptedOutWebhookEvent
       | SurgeAPI::ConversationCreatedWebhookEvent
       | SurgeAPI::MessageDeliveredWebhookEvent
       | SurgeAPI::MessageFailedWebhookEvent

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: surge_api
 version: !ruby/object:Gem::Version
-  version: 0.1.0
+  version: 0.2.0
 platform: ruby
 authors:
 - Surge
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2025-09-26 00:00:00.000000000 Z
+date: 2025-10-09 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: connection_pool
@@ -68,6 +68,8 @@ files:
 - lib/surge_api/models/campaign_create_params.rb
 - lib/surge_api/models/contact.rb
 - lib/surge_api/models/contact_create_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
 - lib/surge_api/models/contact_update_params.rb
 - lib/surge_api/models/conversation_created_webhook_event.rb
@@ -137,6 +139,8 @@ files:
 - rbi/surge_api/models/campaign_create_params.rbi
 - rbi/surge_api/models/contact.rbi
 - rbi/surge_api/models/contact_create_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
 - rbi/surge_api/models/contact_update_params.rbi
 - rbi/surge_api/models/conversation_created_webhook_event.rbi
@@ -205,6 +209,8 @@ files:
 - sig/surge_api/models/campaign_create_params.rbs
 - sig/surge_api/models/contact.rbs
 - sig/surge_api/models/contact_create_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
 - sig/surge_api/models/contact_update_params.rbs
 - sig/surge_api/models/conversation_created_webhook_event.rbs