sentdm 0.28.0 → 0.30.0

data/lib/sentdm/models/conversation_messages_list.rb

@@ -0,0 +1,245 @@
+# frozen_string_literal: true
+
+module Sentdm
+  module Models
+    class ConversationMessagesList < Sentdm::Internal::Type::BaseModel
+      # @!attribute messages
+      #   The messages on this page.
+      #
+      #   @return [Array<Sentdm::Models::ConversationMessagesList::Message>, nil]
+      optional :messages, -> { Sentdm::Internal::Type::ArrayOf[Sentdm::ConversationMessagesList::Message] }
+
+      # @!attribute pagination
+      #   Pagination metadata for list responses
+      #
+      #   @return [Sentdm::Models::PaginationMeta, nil]
+      optional :pagination, -> { Sentdm::PaginationMeta }
+
+      # @!method initialize(messages: nil, pagination: nil)
+      #   A paginated list of messages — used by both conversation read endpoints.
+      #
+      #   @param messages [Array<Sentdm::Models::ConversationMessagesList::Message>] The messages on this page.
+      #
+      #   @param pagination [Sentdm::Models::PaginationMeta] Pagination metadata for list responses
+
+      class Message < Sentdm::Internal::Type::BaseModel
+        # @!attribute id
+        #
+        #   @return [String, nil]
+        optional :id, String
+
+        # @!attribute active_contact_price
+        #
+        #   @return [Float, nil]
+        optional :active_contact_price, Float, nil?: true
+
+        # @!attribute channel
+        #
+        #   @return [String, nil]
+        optional :channel, String
+
+        # @!attribute contact_id
+        #
+        #   @return [String, nil]
+        optional :contact_id, String
+
+        # @!attribute created_at
+        #
+        #   @return [Time, nil]
+        optional :created_at, Time
+
+        # @!attribute customer_id
+        #
+        #   @return [String, nil]
+        optional :customer_id, String
+
+        # @!attribute direction
+        #
+        #   @return [String, nil]
+        optional :direction, String
+
+        # @!attribute events
+        #
+        #   @return [Array<Sentdm::Models::ConversationMessagesList::Message::Event>, nil]
+        optional :events,
+                 -> { Sentdm::Internal::Type::ArrayOf[Sentdm::ConversationMessagesList::Message::Event] },
+                 nil?: true
+
+        # @!attribute message_body
+        #   Structured message body format for database storage. Preserves channel-specific
+        #   components (header, body, footer, buttons).
+        #
+        #   @return [Sentdm::Models::ConversationMessagesList::Message::MessageBody, nil]
+        optional :message_body, -> { Sentdm::ConversationMessagesList::Message::MessageBody }, nil?: true
+
+        # @!attribute phone
+        #
+        #   @return [String, nil]
+        optional :phone, String
+
+        # @!attribute phone_international
+        #
+        #   @return [String, nil]
+        optional :phone_international, String
+
+        # @!attribute price
+        #
+        #   @return [Float, nil]
+        optional :price, Float, nil?: true
+
+        # @!attribute region_code
+        #
+        #   @return [String, nil]
+        optional :region_code, String
+
+        # @!attribute status
+        #
+        #   @return [String, nil]
+        optional :status, String
+
+        # @!attribute template_category
+        #
+        #   @return [String, nil]
+        optional :template_category, String, nil?: true
+
+        # @!attribute template_id
+        #
+        #   @return [String, nil]
+        optional :template_id, String, nil?: true
+
+        # @!attribute template_name
+        #
+        #   @return [String, nil]
+        optional :template_name, String, nil?: true
+
+        # @!method initialize(id: nil, active_contact_price: nil, channel: nil, contact_id: nil, created_at: nil, customer_id: nil, direction: nil, events: nil, message_body: nil, phone: nil, phone_international: nil, price: nil, region_code: nil, status: nil, template_category: nil, template_id: nil, template_name: nil)
+        #   Some parameter documentations has been truncated, see
+        #   {Sentdm::Models::ConversationMessagesList::Message} for more details.
+        #
+        #   Message response for v3 API — same shape as v2 with snake_case JSON conventions
+        #
+        #   @param id [String]
+        #
+        #   @param active_contact_price [Float, nil]
+        #
+        #   @param channel [String]
+        #
+        #   @param contact_id [String]
+        #
+        #   @param created_at [Time]
+        #
+        #   @param customer_id [String]
+        #
+        #   @param direction [String]
+        #
+        #   @param events [Array<Sentdm::Models::ConversationMessagesList::Message::Event>, nil]
+        #
+        #   @param message_body [Sentdm::Models::ConversationMessagesList::Message::MessageBody, nil] Structured message body format for database storage.
+        #
+        #   @param phone [String]
+        #
+        #   @param phone_international [String]
+        #
+        #   @param price [Float, nil]
+        #
+        #   @param region_code [String]
+        #
+        #   @param status [String]
+        #
+        #   @param template_category [String, nil]
+        #
+        #   @param template_id [String, nil]
+        #
+        #   @param template_name [String, nil]
+
+        class Event < Sentdm::Internal::Type::BaseModel
+          # @!attribute status
+          #
+          #   @return [String]
+          required :status, String
+
+          # @!attribute timestamp
+          #
+          #   @return [Time]
+          required :timestamp, Time
+
+          # @!attribute description
+          #
+          #   @return [String, nil]
+          optional :description, String, nil?: true
+
+          # @!method initialize(status:, timestamp:, description: nil)
+          #   Represents a status change event in a message's lifecycle (v3)
+          #
+          #   @param status [String]
+          #   @param timestamp [Time]
+          #   @param description [String, nil]
+        end
+
+        # @see Sentdm::Models::ConversationMessagesList::Message#message_body
+        class MessageBody < Sentdm::Internal::Type::BaseModel
+          # @!attribute buttons
+          #
+          #   @return [Array<Sentdm::Models::ConversationMessagesList::Message::MessageBody::Button>, nil]
+          optional :buttons,
+                   -> {
+                     Sentdm::Internal::Type::ArrayOf[Sentdm::ConversationMessagesList::Message::MessageBody::Button]
+                   },
+                   nil?: true
+
+          # @!attribute content
+          #
+          #   @return [String, nil]
+          optional :content, String
+
+          # @!attribute footer
+          #
+          #   @return [String, nil]
+          optional :footer, String, nil?: true
+
+          # @!attribute header
+          #
+          #   @return [String, nil]
+          optional :header, String, nil?: true
+
+          # @!method initialize(buttons: nil, content: nil, footer: nil, header: nil)
+          #   Structured message body format for database storage. Preserves channel-specific
+          #   components (header, body, footer, buttons).
+          #
+          #   @param buttons [Array<Sentdm::Models::ConversationMessagesList::Message::MessageBody::Button>, nil]
+          #   @param content [String]
+          #   @param footer [String, nil]
+          #   @param header [String, nil]
+
+          class Button < Sentdm::Internal::Type::BaseModel
+            # @!attribute postback_data
+            #
+            #   @return [String, nil]
+            optional :postback_data, String, api_name: :postbackData, nil?: true
+
+            # @!attribute text
+            #
+            #   @return [String, nil]
+            optional :text, String, nil?: true
+
+            # @!attribute type
+            #
+            #   @return [String, nil]
+            optional :type, String
+
+            # @!attribute value
+            #
+            #   @return [String, nil]
+            optional :value, String
+
+            # @!method initialize(postback_data: nil, text: nil, type: nil, value: nil)
+            #   @param postback_data [String, nil]
+            #   @param text [String, nil]
+            #   @param type [String]
+            #   @param value [String]
+          end
+        end
+      end
+    end
+  end
+end

data/lib/sentdm/models/error_detail.rb

@@ -0,0 +1,42 @@
+# frozen_string_literal: true
+
+module Sentdm
+  module Models
+    class ErrorDetail < Sentdm::Internal::Type::BaseModel
+      # @!attribute code
+      #   Machine-readable error code (e.g., "RESOURCE_001")
+      #
+      #   @return [String, nil]
+      optional :code, String
+
+      # @!attribute details
+      #   Additional validation error details (field-level errors)
+      #
+      #   @return [Hash{Symbol=>Array<String>}, nil]
+      optional :details, Sentdm::Internal::Type::HashOf[Sentdm::Internal::Type::ArrayOf[String]], nil?: true
+
+      # @!attribute doc_url
+      #   URL to documentation about this error
+      #
+      #   @return [String, nil]
+      optional :doc_url, String, nil?: true
+
+      # @!attribute message
+      #   Human-readable error message
+      #
+      #   @return [String, nil]
+      optional :message, String
+
+      # @!method initialize(code: nil, details: nil, doc_url: nil, message: nil)
+      #   Error information
+      #
+      #   @param code [String] Machine-readable error code (e.g., "RESOURCE_001")
+      #
+      #   @param details [Hash{Symbol=>Array<String>}, nil] Additional validation error details (field-level errors)
+      #
+      #   @param doc_url [String, nil] URL to documentation about this error
+      #
+      #   @param message [String] Human-readable error message
+    end
+  end
+end

data/lib/sentdm/models/inbound_message_event_payload.rb

@@ -3,6 +3,18 @@
 module Sentdm
   module Models
     class InboundMessageEventPayload < Sentdm::Internal::Type::BaseModel
+      # @!attribute inbound_number
+      #   The contact's number in E.164 format, meaning the number the message came from.
+      #
+      #   @return [String]
+      required :inbound_number, String
+
+      # @!attribute received_at
+      #   When the message was received, in UTC (yyyy-MM-ddTHH:mm:ssZ).
+      #
+      #   @return [String]
+      required :received_at, String
+
       # @!attribute account_id
       #   The account the message belongs to.
       #
@@ -15,12 +27,6 @@ module Sentdm
       #   @return [String, nil]
       optional :channel, String
 
-      # @!attribute inbound_number
-      #   The contact's number in E.164 format, meaning the number the message came from.
-      #
-      #   @return [String, nil]
-      optional :inbound_number, String
-
       # @!attribute message_id
       #   The inbound message.
       #
@@ -33,12 +39,6 @@ module Sentdm
       #   @return [String, nil]
       optional :outbound_number, String
 
-      # @!attribute received_at
-      #   When the message was received, in UTC (yyyy-MM-ddTHH:mm:ssZ).
-      #
-      #   @return [String, nil]
-      optional :received_at, String
-
       # @!attribute text
       #   The message body. Sent as null when the inbound message carried no text, for
       #   example a media-only message. The field is always present, so read it and check
@@ -54,25 +54,25 @@ module Sentdm
       #   @return [String, nil]
       optional :updated_at, String
 
-      # @!method initialize(account_id: nil, channel: nil, inbound_number: nil, message_id: nil, outbound_number: nil, received_at: nil, text: nil, updated_at: nil)
+      # @!method initialize(inbound_number:, received_at:, account_id: nil, channel: nil, message_id: nil, outbound_number: nil, text: nil, updated_at: nil)
       #   Some parameter documentations has been truncated, see
       #   {Sentdm::Models::InboundMessageEventPayload} for more details.
       #
       #   Body of a message.received event. Delivered when a contact messages one of your
       #   numbers.
       #
+      #   @param inbound_number [String] The contact's number in E.164 format, meaning the number the message came from.
+      #
+      #   @param received_at [String] When the message was received, in UTC (yyyy-MM-ddTHH:mm:ssZ).
+      #
       #   @param account_id [String] The account the message belongs to.
       #
       #   @param channel [String] The channel the message arrived on, for example sms or whatsapp.
       #
-      #   @param inbound_number [String] The contact's number in E.164 format, meaning the number the message came from.
-      #
       #   @param message_id [String] The inbound message.
       #
       #   @param outbound_number [String] Your number in E.164 format, meaning the number the message was addressed to.
       #
-      #   @param received_at [String] When the message was received, in UTC (yyyy-MM-ddTHH:mm:ssZ).
-      #
       #   @param text [String, nil] The message body. Sent as null when the inbound message carried no text, for
       #
       #   @param updated_at [String] When the message was received, in UTC (yyyy-MM-ddTHH:mm:ssZ). Same value as