surge_api 0.2.1 → 0.4.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: cc8267ebb4682d2884a0ed0a4ff0c1ec89a6e76988ee96cbdd794bc9ee745ef2
-  data.tar.gz: fcefd6289c6dae43967d4eac94bbc87299ab03c52e335f611949a4d6169c7c79
+  metadata.gz: da7c01aaa992d5a9324e6a320821c240261535e5c85ef840624e00e82ff3a722
+  data.tar.gz: 1219ffe72345fb81de26f7f7be3c6a05d11d790de928bb8e3821c59ca837ad86
 SHA512:
-  metadata.gz: 22b712d8f2898bca0a102de847125c57cc1feb4771c23db55de558616b6dba9de87a1915e05e44c23ca619872f9a9d0f70df9c8f522e8f867048fd43a53cb660
-  data.tar.gz: '025923bb1e6f82ecbe04e30ee9f849369e8ddd76dd73f729dfe046220ffc044633cc7f1d15d286b6d37c2b5d6d641bae27e2cb558499e4c6271133997ba8444f'
+  metadata.gz: 44b3bd94a28e639bdae0131f72893b3e0fbbccc4ef11eaef833cd4214d167879bbbdb36ab964ce991c07d8cf844b2a59225c1a2e4afd231ac1045472e6c5f2b0
+  data.tar.gz: aeba66370a29d5bc640f998625e6bde7e3a040f9579a24253442d434d9b671fa1f46d42c84afb07913958d696836e89a226ab2a989585ec90fc156150e45bbb2

data/CHANGELOG.md

@@ -1,5 +1,45 @@
 # Changelog
 
+## 0.4.0 (2026-01-10)
+
+Full Changelog: [v0.3.0...v0.4.0](https://github.com/surgeapi/ruby-sdk/compare/v0.3.0...v0.4.0)
+
+### Features
+
+* **api:** add archive account endpoint ([b56a3ac](https://github.com/surgeapi/ruby-sdk/commit/b56a3ac799df5e73cfea5416bb6af32cdeaac64d))
+
+
+### Bug Fixes
+
+* issue where json.parse errors when receiving HTTP 204 with nobody ([a54e6ff](https://github.com/surgeapi/ruby-sdk/commit/a54e6ff310c9d5d146161a33971eb0dc541c9774))
+
+
+### Chores
+
+* **internal:** codegen related update ([6dda266](https://github.com/surgeapi/ruby-sdk/commit/6dda2669de3018139c1ff15a9c23edda513fd899))
+* move `cgi` into dependencies for ruby 4 ([03ce06b](https://github.com/surgeapi/ruby-sdk/commit/03ce06b6a4f4d7f510dee6ece06e89ff93ede89d))
+
+## 0.3.0 (2025-12-17)
+
+Full Changelog: [v0.2.1...v0.3.0](https://github.com/surgeapi/ruby-sdk/compare/v0.2.1...v0.3.0)
+
+### Features
+
+* **api:** add retrieve message endpoint ([55df346](https://github.com/surgeapi/ruby-sdk/commit/55df346f91c99fece77d130057afc55b021666c7))
+
+
+### Bug Fixes
+
+* better thread safety via early initializing SSL store during HTTP client creation ([0d14e5e](https://github.com/surgeapi/ruby-sdk/commit/0d14e5e73496e95743359c4c8dbab6da1c384a6e))
+* calling `break` out of streams should be instantaneous ([b43c7e5](https://github.com/surgeapi/ruby-sdk/commit/b43c7e54e9dfaaf31ffa0fe498c53fcc51bbb81c))
+
+
+### Chores
+
+* bump dependency version and update sorbet types ([e00a588](https://github.com/surgeapi/ruby-sdk/commit/e00a5886df58170099838c7a2b1ba25fe36588d6))
+* explicitly require "base64" gem ([a25ee53](https://github.com/surgeapi/ruby-sdk/commit/a25ee53f821df6c2d177b0e41c864e15e4b8bae9))
+* **internal:** codegen related update ([744a068](https://github.com/surgeapi/ruby-sdk/commit/744a0682fa04890d445106232878d0d5be7d7273))
+
 ## 0.2.1 (2025-10-31)
 
 Full Changelog: [v0.2.0...v0.2.1](https://github.com/surgeapi/ruby-sdk/compare/v0.2.0...v0.2.1)

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.2.1"
+gem "surge_api", "~> 0.4.0"
 ```
 
 <!-- x-release-please-end -->

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

@@ -201,7 +201,8 @@ module SurgeAPI
             self.class::PLATFORM_HEADERS,
             {
               "accept" => "application/json",
-              "content-type" => "application/json"
+              "content-type" => "application/json",
+              "user-agent" => user_agent
             },
             headers
           )
@@ -219,6 +220,11 @@ module SurgeAPI
         # @return [Hash{String=>String}]
         private def auth_headers = {}
 
+        # @api private
+        #
+        # @return [String]
+        private def user_agent = "#{self.class.name}/Ruby #{SurgeAPI::VERSION}"
+
         # @api private
         #
         # @return [String]

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

@@ -16,10 +16,11 @@ module SurgeAPI
         class << self
           # @api private
           #
+          # @param cert_store [OpenSSL::X509::Store]
           # @param url [URI::Generic]
           #
           # @return [Net::HTTP]
-          def connect(url)
+          def connect(cert_store:, url:)
             port =
               case [url.port, url.scheme]
               in [Integer, _]
@@ -33,6 +34,8 @@ module SurgeAPI
             Net::HTTP.new(url.host, port).tap do
               _1.use_ssl = %w[https wss].include?(url.scheme)
               _1.max_retries = 0
+
+              (_1.cert_store = cert_store) if _1.use_ssl?
             end
           end
 
@@ -102,7 +105,7 @@ module SurgeAPI
           pool =
             @mutex.synchronize do
               @pools[origin] ||= ConnectionPool.new(size: @size) do
-                self.class.connect(url)
+                self.class.connect(cert_store: @cert_store, url: url)
               end
             end
 
@@ -150,17 +153,19 @@ module SurgeAPI
                   end
 
                   self.class.calibrate_socket_timeout(conn, deadline)
-                  conn.request(req) do |rsp|
-                    y << [req, rsp]
-                    break if finished
-
-                    rsp.read_body do |bytes|
-                      y << bytes.force_encoding(Encoding::BINARY)
-                      break if finished
-
-                      self.class.calibrate_socket_timeout(conn, deadline)
+                  ::Kernel.catch(:jump) do
+                    conn.request(req) do |rsp|
+                      y << [req, rsp]
+                      ::Kernel.throw(:jump) if finished
+
+                      rsp.read_body do |bytes|
+                        y << bytes.force_encoding(Encoding::BINARY)
+                        ::Kernel.throw(:jump) if finished
+
+                        self.class.calibrate_socket_timeout(conn, deadline)
+                      end
+                      eof = true
                     end
-                    eof = true
                   end
                 end
               ensure
@@ -192,6 +197,7 @@ module SurgeAPI
         def initialize(size: self.class::DEFAULT_MAX_CONNECTIONS)
           @mutex = Mutex.new
           @size = size
+          @cert_store = OpenSSL::X509::Store.new.tap(&:set_default_paths)
           @pools = {}
         end
 

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

@@ -17,6 +17,18 @@ module SurgeAPI
       #   else
       #     puts(unwrap_webhook_event)
       #   end
+      #
+      # @example
+      #   case unwrap_webhook_event
+      #   in {type: :"call.ended", account_id: account_id, data: data, timestamp: timestamp}
+      #     puts(account_id)
+      #   in {type: :"campaign.approved", account_id: account_id, data: data, timestamp: timestamp}
+      #     puts(data)
+      #   in {type: :"contact.opted_in", account_id: account_id, data: data, timestamp: timestamp}
+      #     puts(timestamp)
+      #   else
+      #     puts(unwrap_webhook_event)
+      #   end
       module Union
         include SurgeAPI::Internal::Type::Converter
         include SurgeAPI::Internal::Util::SorbetRuntimeSupport

data/lib/surge_api/internal/util.rb

@@ -657,7 +657,8 @@ module SurgeAPI
         def decode_content(headers, stream:, suppress_error: false)
           case (content_type = headers["content-type"])
           in SurgeAPI::Internal::Util::JSON_CONTENT
-            json = stream.to_a.join
+            return nil if (json = stream.to_a.join).empty?
+
             begin
               JSON.parse(json, symbolize_names: true)
             rescue JSON::ParserError => e
@@ -667,7 +668,11 @@ module SurgeAPI
           in SurgeAPI::Internal::Util::JSONL_CONTENT
             lines = decode_lines(stream)
             chain_fused(lines) do |y|
-              lines.each { y << JSON.parse(_1, symbolize_names: true) }
+              lines.each do
+                next if _1.empty?
+
+                y << JSON.parse(_1, symbolize_names: true)
+              end
             end
           in %r{^text/event-stream}
             lines = decode_lines(stream)

data/lib/surge_api/models/account_archive_params.rb

@@ -0,0 +1,14 @@
+# frozen_string_literal: true
+
+module SurgeAPI
+  module Models
+    # @see SurgeAPI::Resources::Accounts#archive
+    class AccountArchiveParams < 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_retrieve_params.rb

@@ -0,0 +1,14 @@
+# frozen_string_literal: true
+
+module SurgeAPI
+  module Models
+    # @see SurgeAPI::Resources::Messages#retrieve
+    class MessageRetrieveParams < 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/unwrap_webhook_event.rb

@@ -5,23 +5,25 @@ module SurgeAPI
     module UnwrapWebhookEvent
       extend SurgeAPI::Internal::Type::Union
 
-      variant -> { SurgeAPI::CallEndedWebhookEvent }
+      discriminator :type
 
-      variant -> { SurgeAPI::CampaignApprovedWebhookEvent }
+      variant :"call.ended", -> { SurgeAPI::CallEndedWebhookEvent }
 
-      variant -> { SurgeAPI::ContactOptedInWebhookEvent }
+      variant :"campaign.approved", -> { SurgeAPI::CampaignApprovedWebhookEvent }
 
-      variant -> { SurgeAPI::ContactOptedOutWebhookEvent }
+      variant :"contact.opted_in", -> { SurgeAPI::ContactOptedInWebhookEvent }
 
-      variant -> { SurgeAPI::ConversationCreatedWebhookEvent }
+      variant :"contact.opted_out", -> { SurgeAPI::ContactOptedOutWebhookEvent }
 
-      variant -> { SurgeAPI::MessageDeliveredWebhookEvent }
+      variant :"conversation.created", -> { SurgeAPI::ConversationCreatedWebhookEvent }
 
-      variant -> { SurgeAPI::MessageFailedWebhookEvent }
+      variant :"message.delivered", -> { SurgeAPI::MessageDeliveredWebhookEvent }
 
-      variant -> { SurgeAPI::MessageReceivedWebhookEvent }
+      variant :"message.failed", -> { SurgeAPI::MessageFailedWebhookEvent }
 
-      variant -> { SurgeAPI::MessageSentWebhookEvent }
+      variant :"message.received", -> { SurgeAPI::MessageReceivedWebhookEvent }
+
+      variant :"message.sent", -> { SurgeAPI::MessageSentWebhookEvent }
 
       # @!method self.variants
       #   @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)]

data/lib/surge_api/models.rb

@@ -41,6 +41,8 @@ module SurgeAPI
 
   Account = SurgeAPI::Models::Account
 
+  AccountArchiveParams = SurgeAPI::Models::AccountArchiveParams
+
   AccountCreateParams = SurgeAPI::Models::AccountCreateParams
 
   AccountRetrieveStatusParams = SurgeAPI::Models::AccountRetrieveStatusParams
@@ -91,6 +93,8 @@ module SurgeAPI
 
   MessageReceivedWebhookEvent = SurgeAPI::Models::MessageReceivedWebhookEvent
 
+  MessageRetrieveParams = SurgeAPI::Models::MessageRetrieveParams
+
   MessageSentWebhookEvent = SurgeAPI::Models::MessageSentWebhookEvent
 
   Organization = SurgeAPI::Models::Organization

data/lib/surge_api/resources/accounts.rb

@@ -67,6 +67,35 @@ module SurgeAPI
         )
       end
 
+      # Archives an account and releases all associated resources.
+      #
+      # **Warning**: This action will:
+      #
+      # - Release all phone numbers associated with the account
+      # - Deactivate all campaigns
+      # - Make the account unusable for sending messages
+      #
+      # This operation is irreversible. If you need to send SMS in the future, you will
+      # need to re-register new phone numbers and campaigns.
+      #
+      # @overload archive(id, request_options: {})
+      #
+      # @param id [String] The ID of the account to archive.
+      #
+      # @param request_options [SurgeAPI::RequestOptions, Hash{Symbol=>Object}, nil]
+      #
+      # @return [SurgeAPI::Models::Account]
+      #
+      # @see SurgeAPI::Models::AccountArchiveParams
+      def archive(id, params = {})
+        @client.request(
+          method: :delete,
+          path: ["accounts/%1$s", id],
+          model: SurgeAPI::Account,
+          options: params[:request_options]
+        )
+      end
+
       # Check an account's status and capabilities
       #
       # @overload retrieve_status(account_id, capabilities: nil, request_options: {})

data/lib/surge_api/resources/messages.rb

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

data/lib/surge_api/version.rb

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

data/lib/surge_api.rb

@@ -3,12 +3,14 @@
 # Standard libraries.
 # rubocop:disable Lint/RedundantRequireStatement
 require "English"
+require "base64"
 require "cgi"
 require "date"
 require "erb"
 require "etc"
 require "json"
 require "net/http"
+require "openssl"
 require "pathname"
 require "rbconfig"
 require "securerandom"
@@ -53,6 +55,7 @@ require_relative "surge_api/client"
 require_relative "surge_api/models/campaign_params"
 require_relative "surge_api/models/message_params"
 require_relative "surge_api/models/account"
+require_relative "surge_api/models/account_archive_params"
 require_relative "surge_api/models/account_create_params"
 require_relative "surge_api/models/account_retrieve_status_params"
 require_relative "surge_api/models/account_status"
@@ -76,6 +79,7 @@ require_relative "surge_api/models/message_create_params"
 require_relative "surge_api/models/message_delivered_webhook_event"
 require_relative "surge_api/models/message_failed_webhook_event"
 require_relative "surge_api/models/message_received_webhook_event"
+require_relative "surge_api/models/message_retrieve_params"
 require_relative "surge_api/models/message_sent_webhook_event"
 require_relative "surge_api/models/organization"
 require_relative "surge_api/models/phone_number"

data/manifest.yaml

@@ -1,11 +1,13 @@
 dependencies:
   - English
+  - base64
   - cgi
   - date
   - erb
   - etc
   - json
   - net/http
+  - openssl
   - pathname
   - rbconfig
   - securerandom

data/rbi/surge_api/internal/transport/base_client.rbi

@@ -176,6 +176,11 @@ module SurgeAPI
         private def auth_headers
         end
 
+        # @api private
+        sig { returns(String) }
+        private def user_agent
+        end
+
         # @api private
         sig { returns(String) }
         private def generate_idempotency_key

data/rbi/surge_api/internal/transport/pooled_net_requester.rbi

@@ -26,8 +26,12 @@ module SurgeAPI
 
         class << self
           # @api private
-          sig { params(url: URI::Generic).returns(Net::HTTP) }
-          def connect(url)
+          sig do
+            params(cert_store: OpenSSL::X509::Store, url: URI::Generic).returns(
+              Net::HTTP
+            )
+          end
+          def connect(cert_store:, url:)
           end
 
           # @api private

data/rbi/surge_api/internal/type/base_model.rbi

@@ -31,7 +31,7 @@ module SurgeAPI
           #
           # Assumes superclass fields are totally defined before fields are accessed /
           # defined on subclasses.
-          sig { params(child: T.self_type).void }
+          sig { params(child: SurgeAPI::Internal::Type::BaseModel).void }
           def inherited(child)
           end
 
@@ -274,9 +274,13 @@ module SurgeAPI
 
         # Create a new instance of a model.
         sig do
-          params(data: T.any(T::Hash[Symbol, T.anything], T.self_type)).returns(
-            T.attached_class
-          )
+          params(
+            data:
+              T.any(
+                T::Hash[Symbol, T.anything],
+                SurgeAPI::Internal::Type::BaseModel
+              )
+          ).returns(T.attached_class)
         end
         def self.new(data = {})
         end

data/rbi/surge_api/models/account_archive_params.rbi

@@ -0,0 +1,27 @@
+# typed: strong
+
+module SurgeAPI
+  module Models
+    class AccountArchiveParams < SurgeAPI::Internal::Type::BaseModel
+      extend SurgeAPI::Internal::Type::RequestParameters::Converter
+      include SurgeAPI::Internal::Type::RequestParameters
+
+      OrHash =
+        T.type_alias do
+          T.any(SurgeAPI::AccountArchiveParams, SurgeAPI::Internal::AnyHash)
+        end
+
+      sig do
+        params(request_options: SurgeAPI::RequestOptions::OrHash).returns(
+          T.attached_class
+        )
+      end
+      def self.new(request_options: {})
+      end
+
+      sig { override.returns({ request_options: SurgeAPI::RequestOptions }) }
+      def to_hash
+      end
+    end
+  end
+end

data/rbi/surge_api/models/message_retrieve_params.rbi

@@ -0,0 +1,27 @@
+# typed: strong
+
+module SurgeAPI
+  module Models
+    class MessageRetrieveParams < SurgeAPI::Internal::Type::BaseModel
+      extend SurgeAPI::Internal::Type::RequestParameters::Converter
+      include SurgeAPI::Internal::Type::RequestParameters
+
+      OrHash =
+        T.type_alias do
+          T.any(SurgeAPI::MessageRetrieveParams, SurgeAPI::Internal::AnyHash)
+        end
+
+      sig do
+        params(request_options: SurgeAPI::RequestOptions::OrHash).returns(
+          T.attached_class
+        )
+      end
+      def self.new(request_options: {})
+      end
+
+      sig { override.returns({ request_options: SurgeAPI::RequestOptions }) }
+      def to_hash
+      end
+    end
+  end
+end

data/rbi/surge_api/models.rbi

@@ -3,6 +3,8 @@
 module SurgeAPI
   Account = SurgeAPI::Models::Account
 
+  AccountArchiveParams = SurgeAPI::Models::AccountArchiveParams
+
   AccountCreateParams = SurgeAPI::Models::AccountCreateParams
 
   AccountRetrieveStatusParams = SurgeAPI::Models::AccountRetrieveStatusParams
@@ -54,6 +56,8 @@ module SurgeAPI
 
   MessageReceivedWebhookEvent = SurgeAPI::Models::MessageReceivedWebhookEvent
 
+  MessageRetrieveParams = SurgeAPI::Models::MessageRetrieveParams
+
   MessageSentWebhookEvent = SurgeAPI::Models::MessageSentWebhookEvent
 
   Organization = SurgeAPI::Models::Organization

data/rbi/surge_api/resources/accounts.rbi

@@ -65,6 +65,29 @@ module SurgeAPI
       )
       end
 
+      # Archives an account and releases all associated resources.
+      #
+      # **Warning**: This action will:
+      #
+      # - Release all phone numbers associated with the account
+      # - Deactivate all campaigns
+      # - Make the account unusable for sending messages
+      #
+      # This operation is irreversible. If you need to send SMS in the future, you will
+      # need to re-register new phone numbers and campaigns.
+      sig do
+        params(
+          id: String,
+          request_options: SurgeAPI::RequestOptions::OrHash
+        ).returns(SurgeAPI::Account)
+      end
+      def archive(
+        # The ID of the account to archive.
+        id,
+        request_options: {}
+      )
+      end
+
       # Check an account's status and capabilities
       sig do
         params(

data/rbi/surge_api/resources/messages.rbi

@@ -46,6 +46,20 @@ module SurgeAPI
       )
       end
 
+      # Retrieves a Message object.
+      sig do
+        params(
+          id: String,
+          request_options: SurgeAPI::RequestOptions::OrHash
+        ).returns(SurgeAPI::Message)
+      end
+      def retrieve(
+        # The ID of the message to retrieve.
+        id,
+        request_options: {}
+      )
+      end
+
       # @api private
       sig { params(client: SurgeAPI::Client).returns(T.attached_class) }
       def self.new(client:)

data/sig/surge_api/internal/transport/base_client.rbs

@@ -87,6 +87,8 @@ module SurgeAPI
 
         private def auth_headers: -> ::Hash[String, String]
 
+        private def user_agent: -> String
+
         private def generate_idempotency_key: -> String
 
         private def build_request: (

data/sig/surge_api/internal/transport/pooled_net_requester.rbs

@@ -17,7 +17,10 @@ module SurgeAPI
 
         DEFAULT_MAX_CONNECTIONS: Integer
 
-        def self.connect: (URI::Generic url) -> top
+        def self.connect: (
+          cert_store: OpenSSL::X509::Store,
+          url: URI::Generic
+        ) -> top
 
         def self.calibrate_socket_timeout: (top conn, Float deadline) -> void
 

data/sig/surge_api/models/account_archive_params.rbs

@@ -0,0 +1,15 @@
+module SurgeAPI
+  module Models
+    type account_archive_params =
+      {  } & SurgeAPI::Internal::Type::request_parameters
+
+    class AccountArchiveParams < 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/message_retrieve_params.rbs

@@ -0,0 +1,15 @@
+module SurgeAPI
+  module Models
+    type message_retrieve_params =
+      {  } & SurgeAPI::Internal::Type::request_parameters
+
+    class MessageRetrieveParams < 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.rbs

@@ -1,6 +1,8 @@
 module SurgeAPI
   class Account = SurgeAPI::Models::Account
 
+  class AccountArchiveParams = SurgeAPI::Models::AccountArchiveParams
+
   class AccountCreateParams = SurgeAPI::Models::AccountCreateParams
 
   class AccountRetrieveStatusParams = SurgeAPI::Models::AccountRetrieveStatusParams
@@ -51,6 +53,8 @@ module SurgeAPI
 
   class MessageReceivedWebhookEvent = SurgeAPI::Models::MessageReceivedWebhookEvent
 
+  class MessageRetrieveParams = SurgeAPI::Models::MessageRetrieveParams
+
   class MessageSentWebhookEvent = SurgeAPI::Models::MessageSentWebhookEvent
 
   class Organization = SurgeAPI::Models::Organization

data/sig/surge_api/resources/accounts.rbs

@@ -18,6 +18,11 @@ module SurgeAPI
         ?request_options: SurgeAPI::request_opts
       ) -> SurgeAPI::Account
 
+      def archive: (
+        String id,
+        ?request_options: SurgeAPI::request_opts
+      ) -> SurgeAPI::Account
+
       def retrieve_status: (
         String account_id,
         ?capabilities: ::Array[SurgeAPI::Models::AccountRetrieveStatusParams::capability],

data/sig/surge_api/resources/messages.rbs

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

metadata

@@ -1,15 +1,29 @@
 --- !ruby/object:Gem::Specification
 name: surge_api
 version: !ruby/object:Gem::Version
-  version: 0.2.1
+  version: 0.4.0
 platform: ruby
 authors:
 - Surge
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2025-10-31 00:00:00.000000000 Z
+date: 2026-01-11 00:00:00.000000000 Z
 dependencies:
+- !ruby/object:Gem::Dependency
+  name: cgi
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
 - !ruby/object:Gem::Dependency
   name: connection_pool
   requirement: !ruby/object:Gem::Requirement
@@ -56,6 +70,7 @@ files:
 - lib/surge_api/internal/util.rb
 - lib/surge_api/models.rb
 - lib/surge_api/models/account.rb
+- lib/surge_api/models/account_archive_params.rb
 - lib/surge_api/models/account_create_params.rb
 - lib/surge_api/models/account_retrieve_status_params.rb
 - lib/surge_api/models/account_status.rb
@@ -81,6 +96,7 @@ files:
 - lib/surge_api/models/message_failed_webhook_event.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
@@ -129,6 +145,7 @@ files:
 - rbi/surge_api/internal/util.rbi
 - rbi/surge_api/models.rbi
 - rbi/surge_api/models/account.rbi
+- rbi/surge_api/models/account_archive_params.rbi
 - rbi/surge_api/models/account_create_params.rbi
 - rbi/surge_api/models/account_retrieve_status_params.rbi
 - rbi/surge_api/models/account_status.rbi
@@ -154,6 +171,7 @@ files:
 - rbi/surge_api/models/message_failed_webhook_event.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
@@ -201,6 +219,7 @@ files:
 - sig/surge_api/internal/util.rbs
 - sig/surge_api/models.rbs
 - sig/surge_api/models/account.rbs
+- sig/surge_api/models/account_archive_params.rbs
 - sig/surge_api/models/account_create_params.rbs
 - sig/surge_api/models/account_retrieve_status_params.rbs
 - sig/surge_api/models/account_status.rbs
@@ -226,6 +245,7 @@ files:
 - sig/surge_api/models/message_failed_webhook_event.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