sentdm 0.42.1 → 0.44.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: dd3b3bed92e98b1956bd019920853c3e129c80d3e1c7e7d2620c5900ae3ed704
-  data.tar.gz: fecba2039a8648e24e75724cde8a36217760296de0e1374a466dfab20968cd44
+  metadata.gz: 46c6f38c1bac617a9d4b5f114cf1315c0165581995884399707a19b74db1d1c7
+  data.tar.gz: 9fd166f6b0d86b2fe8bba638891c98bcf80f77bbdd6a035aa9524ec5a666c239
 SHA512:
-  metadata.gz: 447e13859d654e6ba7ca912ec279a3ae5b8a0e03639cd866d0df35f5dc7bd8273db34e0d4769f9861afce48ed1320fe2583475d1a4d22f513bb86678bbba383d
-  data.tar.gz: cc688d4a9ceefdf327a8f09372ab8e14ae77cf94f25a5f662138cbb72a8ff8c656c5fd98ad289ce08bd43605929f31101b5a2dceacd4d4ca7c56826df4f89247
+  metadata.gz: e313815b9a52feac9bf9cc74368eec76805d90c4d4e83bdf01866e7ba837745fd8bb089b901ae602c3aec9041994aef97b66a74dae712ef5586b774f120eeb59
+  data.tar.gz: 473e10edb48f2d5c5c46df341966ca4db2bab6b024eb7e57369a474f816f8fa1490534287c58d3917d0a6c14b01a017ad329601d8ce0e052732ccfb5892ab953

data/CHANGELOG.md

@@ -1,5 +1,19 @@
 # Changelog
 
+## [0.44.0](https://github.com/sentdm/sent-dm-ruby/compare/v0.43.0...v0.44.0) (2026-11-04)
+
+
+### Features
+
+* **pagination:** expose page, page_size, total_count and total_pages on every page model ([2403928](https://github.com/sentdm/sent-dm-ruby/commit/24039285c1ed89e4e7b3ec22e71ac984b590dcf3))
+
+## [0.43.0](https://github.com/sentdm/sent-dm-ruby/compare/v0.42.1...v0.43.0) (2026-11-03)
+
+
+### Features
+
+* **api:** add messages.resend to resend a message on its id ([9a2f65f](https://github.com/sentdm/sent-dm-ruby/commit/9a2f65f47bee3c3dc784eb32fcb9a081f242ef50))
+
 ## [0.42.1](https://github.com/sentdm/sent-dm-ruby/compare/v0.42.0...v0.42.1) (2026-10-30)
 
 

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 "sentdm", "~> 0.42.1"
+gem "sentdm", "~> 0.44.0"
 ```
 
 <!-- x-release-please-end -->
@@ -32,7 +32,7 @@ sent = Sentdm::Client.new(
   api_key: ENV["SENT_DM_API_KEY"] # This is the default and can be omitted
 )
 
-response = sent.messages.send_(
+message_send_response = sent.messages.send_(
   channel: ["sms", "whatsapp"],
   template: {
     id: "7ba7b820-9dad-11d1-80b4-00c04fd430c8",
@@ -42,7 +42,7 @@ response = sent.messages.send_(
   to: ["+14155551234", "+14155555678"]
 )
 
-puts(response.data)
+puts(message_send_response.data)
 ```
 
 ### Pagination
@@ -192,7 +192,7 @@ You can send undocumented parameters to any endpoint, and read undocumented resp
 Note: the `extra_` parameters of the same name overrides the documented parameters.
 
 ```ruby
-response =
+message_send_response =
   sent.messages.send_(
     channel: ["sms"],
     template: {
@@ -208,7 +208,7 @@ response =
     }
   )
 
-puts(response[:my_undocumented_property])
+puts(message_send_response[:my_undocumented_property])
 ```
 
 #### Undocumented request params

data/lib/sentdm/internal/calls_page.rb

@@ -106,8 +106,32 @@ module Sentdm
           #   @return [Boolean, nil]
           optional :has_more, Sentdm::Internal::Type::Boolean
 
-          # @!method initialize(has_more: nil)
+          # @!attribute page
+          #
+          #   @return [Integer, nil]
+          optional :page, Integer
+
+          # @!attribute page_size
+          #
+          #   @return [Integer, nil]
+          optional :page_size, Integer
+
+          # @!attribute total_count
+          #
+          #   @return [Integer, nil]
+          optional :total_count, Integer
+
+          # @!attribute total_pages
+          #
+          #   @return [Integer, nil]
+          optional :total_pages, Integer
+
+          # @!method initialize(has_more: nil, page: nil, page_size: nil, total_count: nil, total_pages: nil)
           #   @param has_more [Boolean]
+          #   @param page [Integer]
+          #   @param page_size [Integer]
+          #   @param total_count [Integer]
+          #   @param total_pages [Integer]
         end
       end
     end

data/lib/sentdm/internal/contacts_page.rb

@@ -106,8 +106,32 @@ module Sentdm
           #   @return [Boolean, nil]
           optional :has_more, Sentdm::Internal::Type::Boolean
 
-          # @!method initialize(has_more: nil)
+          # @!attribute page
+          #
+          #   @return [Integer, nil]
+          optional :page, Integer
+
+          # @!attribute page_size
+          #
+          #   @return [Integer, nil]
+          optional :page_size, Integer
+
+          # @!attribute total_count
+          #
+          #   @return [Integer, nil]
+          optional :total_count, Integer
+
+          # @!attribute total_pages
+          #
+          #   @return [Integer, nil]
+          optional :total_pages, Integer
+
+          # @!method initialize(has_more: nil, page: nil, page_size: nil, total_count: nil, total_pages: nil)
           #   @param has_more [Boolean]
+          #   @param page [Integer]
+          #   @param page_size [Integer]
+          #   @param total_count [Integer]
+          #   @param total_pages [Integer]
         end
       end
     end

data/lib/sentdm/internal/conversations_page.rb

@@ -106,8 +106,32 @@ module Sentdm
           #   @return [Boolean, nil]
           optional :has_more, Sentdm::Internal::Type::Boolean
 
-          # @!method initialize(has_more: nil)
+          # @!attribute page
+          #
+          #   @return [Integer, nil]
+          optional :page, Integer
+
+          # @!attribute page_size
+          #
+          #   @return [Integer, nil]
+          optional :page_size, Integer
+
+          # @!attribute total_count
+          #
+          #   @return [Integer, nil]
+          optional :total_count, Integer
+
+          # @!attribute total_pages
+          #
+          #   @return [Integer, nil]
+          optional :total_pages, Integer
+
+          # @!method initialize(has_more: nil, page: nil, page_size: nil, total_count: nil, total_pages: nil)
           #   @param has_more [Boolean]
+          #   @param page [Integer]
+          #   @param page_size [Integer]
+          #   @param total_count [Integer]
+          #   @param total_pages [Integer]
         end
       end
     end

data/lib/sentdm/internal/templates_page.rb

@@ -106,8 +106,32 @@ module Sentdm
           #   @return [Boolean, nil]
           optional :has_more, Sentdm::Internal::Type::Boolean
 
-          # @!method initialize(has_more: nil)
+          # @!attribute page
+          #
+          #   @return [Integer, nil]
+          optional :page, Integer
+
+          # @!attribute page_size
+          #
+          #   @return [Integer, nil]
+          optional :page_size, Integer
+
+          # @!attribute total_count
+          #
+          #   @return [Integer, nil]
+          optional :total_count, Integer
+
+          # @!attribute total_pages
+          #
+          #   @return [Integer, nil]
+          optional :total_pages, Integer
+
+          # @!method initialize(has_more: nil, page: nil, page_size: nil, total_count: nil, total_pages: nil)
           #   @param has_more [Boolean]
+          #   @param page [Integer]
+          #   @param page_size [Integer]
+          #   @param total_count [Integer]
+          #   @param total_pages [Integer]
         end
       end
     end

data/lib/sentdm/internal/voice_agents_page.rb

@@ -106,8 +106,32 @@ module Sentdm
           #   @return [Boolean, nil]
           optional :has_more, Sentdm::Internal::Type::Boolean
 
-          # @!method initialize(has_more: nil)
+          # @!attribute page
+          #
+          #   @return [Integer, nil]
+          optional :page, Integer
+
+          # @!attribute page_size
+          #
+          #   @return [Integer, nil]
+          optional :page_size, Integer
+
+          # @!attribute total_count
+          #
+          #   @return [Integer, nil]
+          optional :total_count, Integer
+
+          # @!attribute total_pages
+          #
+          #   @return [Integer, nil]
+          optional :total_pages, Integer
+
+          # @!method initialize(has_more: nil, page: nil, page_size: nil, total_count: nil, total_pages: nil)
           #   @param has_more [Boolean]
+          #   @param page [Integer]
+          #   @param page_size [Integer]
+          #   @param total_count [Integer]
+          #   @param total_pages [Integer]
         end
       end
     end

data/lib/sentdm/internal/webhook_events_page.rb

@@ -106,8 +106,32 @@ module Sentdm
           #   @return [Boolean, nil]
           optional :has_more, Sentdm::Internal::Type::Boolean
 
-          # @!method initialize(has_more: nil)
+          # @!attribute page
+          #
+          #   @return [Integer, nil]
+          optional :page, Integer
+
+          # @!attribute page_size
+          #
+          #   @return [Integer, nil]
+          optional :page_size, Integer
+
+          # @!attribute total_count
+          #
+          #   @return [Integer, nil]
+          optional :total_count, Integer
+
+          # @!attribute total_pages
+          #
+          #   @return [Integer, nil]
+          optional :total_pages, Integer
+
+          # @!method initialize(has_more: nil, page: nil, page_size: nil, total_count: nil, total_pages: nil)
           #   @param has_more [Boolean]
+          #   @param page [Integer]
+          #   @param page_size [Integer]
+          #   @param total_count [Integer]
+          #   @param total_pages [Integer]
         end
       end
     end

data/lib/sentdm/internal/webhooks_page.rb

@@ -106,8 +106,32 @@ module Sentdm
           #   @return [Boolean, nil]
           optional :has_more, Sentdm::Internal::Type::Boolean
 
-          # @!method initialize(has_more: nil)
+          # @!attribute page
+          #
+          #   @return [Integer, nil]
+          optional :page, Integer
+
+          # @!attribute page_size
+          #
+          #   @return [Integer, nil]
+          optional :page_size, Integer
+
+          # @!attribute total_count
+          #
+          #   @return [Integer, nil]
+          optional :total_count, Integer
+
+          # @!attribute total_pages
+          #
+          #   @return [Integer, nil]
+          optional :total_pages, Integer
+
+          # @!method initialize(has_more: nil, page: nil, page_size: nil, total_count: nil, total_pages: nil)
           #   @param has_more [Boolean]
+          #   @param page [Integer]
+          #   @param page_size [Integer]
+          #   @param total_count [Integer]
+          #   @param total_pages [Integer]
         end
       end
     end

data/lib/sentdm/models/message_resend_params.rb

@@ -0,0 +1,32 @@
+# frozen_string_literal: true
+
+module Sentdm
+  module Models
+    # @see Sentdm::Resources::Messages#resend
+    class MessageResendParams < Sentdm::Models::MutationRequest
+      extend Sentdm::Internal::Type::RequestParameters::Converter
+      include Sentdm::Internal::Type::RequestParameters
+
+      # @!attribute id
+      #
+      #   @return [String]
+      required :id, String
+
+      # @!attribute idempotency_key
+      #
+      #   @return [String, nil]
+      optional :idempotency_key, String
+
+      # @!attribute x_profile_id
+      #
+      #   @return [String, nil]
+      optional :x_profile_id, String
+
+      # @!method initialize(id:, idempotency_key: nil, x_profile_id: nil, request_options: {})
+      #   @param id [String]
+      #   @param idempotency_key [String]
+      #   @param x_profile_id [String]
+      #   @param request_options [Sentdm::RequestOptions, Hash{Symbol=>Object}]
+    end
+  end
+end

data/lib/sentdm/models/message_send_response.rb

@@ -2,7 +2,7 @@
 
 module Sentdm
   module Models
-    # @see Sentdm::Resources::Messages#send_
+    # @see Sentdm::Resources::Messages#resend
     class MessageSendResponse < Sentdm::Internal::Type::BaseModel
       # @!attribute data
       #   The result of a multi-recipient send.
@@ -19,7 +19,7 @@ module Sentdm
       #   which of the two to answer with. From always returns this type.
       #
       #   @return [Sentdm::Models::MessageSendResponse::Data, nil]
-      optional :data, -> { Sentdm::Models::MessageSendResponse::Data }, nil?: true
+      optional :data, -> { Sentdm::MessageSendResponse::Data }, nil?: true
 
       # @!attribute error
       #   Error information
@@ -58,8 +58,7 @@ module Sentdm
         # @!attribute recipients
         #
         #   @return [Array<Sentdm::Models::MessageSendResponse::Data::Recipient>, nil]
-        optional :recipients,
-                 -> { Sentdm::Internal::Type::ArrayOf[Sentdm::Models::MessageSendResponse::Data::Recipient] }
+        optional :recipients, -> { Sentdm::Internal::Type::ArrayOf[Sentdm::MessageSendResponse::Data::Recipient] }
 
         # @!attribute status
         #   QUEUED: the batch is accepted. A request that carried scheduled_at is QUEUED

data/lib/sentdm/models.rb

@@ -117,12 +117,16 @@ module Sentdm
 
   MessageEventPayload = Sentdm::Models::MessageEventPayload
 
+  MessageResendParams = Sentdm::Models::MessageResendParams
+
   MessageRetrieveActivitiesParams = Sentdm::Models::MessageRetrieveActivitiesParams
 
   MessageRetrieveStatusParams = Sentdm::Models::MessageRetrieveStatusParams
 
   MessageSendParams = Sentdm::Models::MessageSendParams
 
+  MessageSendResponse = Sentdm::Models::MessageSendResponse
+
   MutationRequest = Sentdm::Models::MutationRequest
 
   NumberLookupParams = Sentdm::Models::NumberLookupParams

data/lib/sentdm/resources/messages.rb

@@ -25,6 +25,67 @@ module Sentdm
     # released yet. Cancelling is free, fires `message.cancelled`, and is final — a
     # cancelled message cannot be resent.
     class Messages
+      # Some parameter documentations has been truncated, see
+      # {Sentdm::Models::MessageResendParams} for more details.
+      #
+      # Resends a message you already sent, on the same message id, without rebuilding
+      # the request. The typical use is recovering a BLOCKED message — for example one
+      # refused for insufficient balance — after the account has been topped up.
+      #
+      # **A resend bills again.** Each accepted resend is a new delivery attempt and
+      # records a new charge against the same message id; a client that resends on every
+      # failure is charged on every loop.
+      #
+      # **Every policy runs again.** The resend goes back through the full send pipeline
+      # — consent, balance, KYC and channel quota, template approval, quiet hours and
+      # channel health — so it can land on BLOCKED, FILTERED or SCHEDULED again rather
+      # than being sent, exactly as a fresh send would. Status webhooks (message.sent,
+      # message.blocked, message.filtered, message.failed) fire again for the same
+      # message id, so consumers keyed on the id will see repeated transitions.
+      #
+      # **What can be resent.** A message in a terminal state — DELIVERED, FAILED, READ
+      # or BLOCKED — or one stuck at SENT for more than 15 minutes. A FILTERED message
+      # can never be resent: the recipient opted out or a routing rule refused the send.
+      # A message still in flight (QUEUED, PROCESSED, ROUTED), held for quiet hours
+      # (SCHEDULED), or SENT less than 15 minutes ago returns 409. Two concurrent
+      # resends of one id are serialised: one is accepted, the other gets 409.
+      #
+      # The resend keeps the channel the message was originally requested on; the
+      # channel cannot be changed on a resend — send a new message instead.
+      # `Idempotency-Key` is honoured, so a retried request replays the first accepted
+      # response instead of resending twice.
+      #
+      # The response has the same shape as `POST /v3/messages`: `recipients` has a
+      # single entry whose `message_id` is the id you resent.
+      #
+      # @overload resend(id, sandbox: nil, idempotency_key: nil, x_profile_id: nil, request_options: {})
+      #
+      # @param id [String] Path param: Message ID
+      #
+      # @param sandbox [Boolean] Body param: Sandbox flag - when true, the operation is simulated without side ef
+      #
+      # @param idempotency_key [String] Header param: Unique key to ensure idempotent request processing. Must be 1-255
+      #
+      # @param x_profile_id [String] Header param: Profile UUID to scope the request to a child profile. Only organiz
+      #
+      # @param request_options [Sentdm::RequestOptions, Hash{Symbol=>Object}, nil]
+      #
+      # @return [Sentdm::Models::MessageSendResponse]
+      #
+      # @see Sentdm::Models::MessageResendParams
+      def resend(id, params = {})
+        parsed, options = Sentdm::MessageResendParams.dump_request(params)
+        header_params = {idempotency_key: "idempotency-key", x_profile_id: "x-profile-id"}
+        @client.request(
+          method: :post,
+          path: ["v3/messages/%1$s/resend", id],
+          headers: parsed.slice(*header_params.keys).transform_keys(header_params),
+          body: parsed.except(*header_params.keys),
+          model: Sentdm::MessageSendResponse,
+          options: options
+        )
+      end
+
       # Some parameter documentations has been truncated, see
       # {Sentdm::Models::MessageRetrieveActivitiesParams} for more details.
       #
@@ -163,7 +224,7 @@ module Sentdm
           path: "v3/messages",
           headers: parsed.slice(*header_params.keys).transform_keys(header_params),
           body: parsed.except(*header_params.keys),
-          model: Sentdm::Models::MessageSendResponse,
+          model: Sentdm::MessageSendResponse,
           options: options
         )
       end

data/lib/sentdm/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Sentdm
-  VERSION = "0.42.1"
+  VERSION = "0.44.0"
 end

data/lib/sentdm.rb

@@ -118,6 +118,7 @@ require_relative "sentdm/models/me_retrieve_params"
 require_relative "sentdm/models/me_retrieve_response"
 require_relative "sentdm/models/message_event"
 require_relative "sentdm/models/message_event_payload"
+require_relative "sentdm/models/message_resend_params"
 require_relative "sentdm/models/message_retrieve_activities_params"
 require_relative "sentdm/models/message_retrieve_activities_response"
 require_relative "sentdm/models/message_retrieve_status_params"

data/rbi/sentdm/internal/calls_page.rbi

@@ -57,11 +57,59 @@ module Sentdm
           sig { params(has_more: T::Boolean).void }
           attr_writer :has_more
 
-          sig { params(has_more: T::Boolean).returns(T.attached_class) }
-          def self.new(has_more: nil)
+          sig { returns(T.nilable(Integer)) }
+          attr_reader :page
+
+          sig { params(page: Integer).void }
+          attr_writer :page
+
+          sig { returns(T.nilable(Integer)) }
+          attr_reader :page_size
+
+          sig { params(page_size: Integer).void }
+          attr_writer :page_size
+
+          sig { returns(T.nilable(Integer)) }
+          attr_reader :total_count
+
+          sig { params(total_count: Integer).void }
+          attr_writer :total_count
+
+          sig { returns(T.nilable(Integer)) }
+          attr_reader :total_pages
+
+          sig { params(total_pages: Integer).void }
+          attr_writer :total_pages
+
+          sig do
+            params(
+              has_more: T::Boolean,
+              page: Integer,
+              page_size: Integer,
+              total_count: Integer,
+              total_pages: Integer
+            ).returns(T.attached_class)
+          end
+          def self.new(
+            has_more: nil,
+            page: nil,
+            page_size: nil,
+            total_count: nil,
+            total_pages: nil
+          )
           end
 
-          sig { override.returns({ has_more: T::Boolean }) }
+          sig do
+            override.returns(
+              {
+                has_more: T::Boolean,
+                page: Integer,
+                page_size: Integer,
+                total_count: Integer,
+                total_pages: Integer
+              }
+            )
+          end
           def to_hash
           end
         end

data/rbi/sentdm/internal/contacts_page.rbi

@@ -57,11 +57,59 @@ module Sentdm
           sig { params(has_more: T::Boolean).void }
           attr_writer :has_more
 
-          sig { params(has_more: T::Boolean).returns(T.attached_class) }
-          def self.new(has_more: nil)
+          sig { returns(T.nilable(Integer)) }
+          attr_reader :page
+
+          sig { params(page: Integer).void }
+          attr_writer :page
+
+          sig { returns(T.nilable(Integer)) }
+          attr_reader :page_size
+
+          sig { params(page_size: Integer).void }
+          attr_writer :page_size
+
+          sig { returns(T.nilable(Integer)) }
+          attr_reader :total_count
+
+          sig { params(total_count: Integer).void }
+          attr_writer :total_count
+
+          sig { returns(T.nilable(Integer)) }
+          attr_reader :total_pages
+
+          sig { params(total_pages: Integer).void }
+          attr_writer :total_pages
+
+          sig do
+            params(
+              has_more: T::Boolean,
+              page: Integer,
+              page_size: Integer,
+              total_count: Integer,
+              total_pages: Integer
+            ).returns(T.attached_class)
+          end
+          def self.new(
+            has_more: nil,
+            page: nil,
+            page_size: nil,
+            total_count: nil,
+            total_pages: nil
+          )
           end
 
-          sig { override.returns({ has_more: T::Boolean }) }
+          sig do
+            override.returns(
+              {
+                has_more: T::Boolean,
+                page: Integer,
+                page_size: Integer,
+                total_count: Integer,
+                total_pages: Integer
+              }
+            )
+          end
           def to_hash
           end
         end

data/rbi/sentdm/internal/conversations_page.rbi

@@ -57,11 +57,59 @@ module Sentdm
           sig { params(has_more: T::Boolean).void }
           attr_writer :has_more
 
-          sig { params(has_more: T::Boolean).returns(T.attached_class) }
-          def self.new(has_more: nil)
+          sig { returns(T.nilable(Integer)) }
+          attr_reader :page
+
+          sig { params(page: Integer).void }
+          attr_writer :page
+
+          sig { returns(T.nilable(Integer)) }
+          attr_reader :page_size
+
+          sig { params(page_size: Integer).void }
+          attr_writer :page_size
+
+          sig { returns(T.nilable(Integer)) }
+          attr_reader :total_count
+
+          sig { params(total_count: Integer).void }
+          attr_writer :total_count
+
+          sig { returns(T.nilable(Integer)) }
+          attr_reader :total_pages
+
+          sig { params(total_pages: Integer).void }
+          attr_writer :total_pages
+
+          sig do
+            params(
+              has_more: T::Boolean,
+              page: Integer,
+              page_size: Integer,
+              total_count: Integer,
+              total_pages: Integer
+            ).returns(T.attached_class)
+          end
+          def self.new(
+            has_more: nil,
+            page: nil,
+            page_size: nil,
+            total_count: nil,
+            total_pages: nil
+          )
           end
 
-          sig { override.returns({ has_more: T::Boolean }) }
+          sig do
+            override.returns(
+              {
+                has_more: T::Boolean,
+                page: Integer,
+                page_size: Integer,
+                total_count: Integer,
+                total_pages: Integer
+              }
+            )
+          end
           def to_hash
           end
         end