sentdm 0.31.0 → 0.33.0

data/lib/sentdm/models/conversation_messages_list.rb

@@ -67,7 +67,14 @@ module Sentdm
 
         # @!attribute message_body
         #   Structured message body format for database storage. Preserves channel-specific
-        #   components (header, body, footer, buttons).
+        #   components (header, header media, body, footer, buttons, MMS subject and media).
+        #
+        #   Persisted as the messageBody jsonb column on Messages. Every write path goes
+        #   through MessageUtils.MessageBodyJsonOptions, which writes nulls, so the envelope
+        #   shape is stable regardless of channel or status. Anything that rebuilds this
+        #   object field by field — the four IMessageBodyStrategy implementations and
+        #   MessageUtils.BuildSegmentBody — has to carry every member, or that member is
+        #   silently dropped on whichever path forgot it.
         #
         #   @return [Sentdm::Models::ConversationMessagesList::Message::MessageBody, nil]
         optional :message_body, -> { Sentdm::ConversationMessagesList::Message::MessageBody }, nil?: true
@@ -116,7 +123,12 @@ module Sentdm
         #   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
+        #   Message response for v3 API — same shape as v2 with snake_case JSON conventions.
+        #
+        #   The shape of a message that was sent immediately: it never has a scheduled_at
+        #   key. A message that is or was held for a later instant is a
+        #   ScheduledMessageResponse, and the endpoint decides which of the two to answer
+        #   with. From always returns this type.
         #
         #   @param id [String]
         #
@@ -202,14 +214,65 @@ module Sentdm
           #   @return [String, nil]
           optional :header, String, nil?: true
 
-          # @!method initialize(buttons: nil, content: nil, footer: nil, header: nil)
+          # @!attribute header_media
+          #   The media asset that rode a message's header, recorded as sent.
+          #
+          #   @return [Sentdm::Models::ConversationMessagesList::Message::MessageBody::HeaderMedia, nil]
+          optional :header_media,
+                   -> { Sentdm::ConversationMessagesList::Message::MessageBody::HeaderMedia },
+                   api_name: :headerMedia,
+                   nil?: true
+
+          # @!attribute media
+          #   MMS attachments, as the publicly fetchable URLs handed to the carrier. Null on
+          #   every other channel.
+          #
+          #   Persisted rather than derived because a resend and a curfew release rebuild the
+          #   send from the stored row — MessageReplayCommandBuilder reads templateId and
+          #   templateVariables and nothing else — so media that lives only on the original
+          #   request would silently turn a replayed MMS into a text message.
+          #
+          #   @return [Array<Sentdm::Models::ConversationMessagesList::Message::MessageBody::Media>, nil]
+          optional :media,
+                   -> {
+                     Sentdm::Internal::Type::ArrayOf[Sentdm::ConversationMessagesList::Message::MessageBody::Media]
+                   },
+                   nil?: true
+
+          # @!attribute subject
+          #   MMS subject line. Null on every other channel.
+          #
+          #   @return [String, nil]
+          optional :subject, String, nil?: true
+
+          # @!method initialize(buttons: nil, content: nil, footer: nil, header: nil, header_media: nil, media: nil, subject: nil)
+          #   Some parameter documentations has been truncated, see
+          #   {Sentdm::Models::ConversationMessagesList::Message::MessageBody} for more
+          #   details.
+          #
           #   Structured message body format for database storage. Preserves channel-specific
-          #   components (header, body, footer, buttons).
+          #   components (header, header media, body, footer, buttons, MMS subject and media).
+          #
+          #   Persisted as the messageBody jsonb column on Messages. Every write path goes
+          #   through MessageUtils.MessageBodyJsonOptions, which writes nulls, so the envelope
+          #   shape is stable regardless of channel or status. Anything that rebuilds this
+          #   object field by field — the four IMessageBodyStrategy implementations and
+          #   MessageUtils.BuildSegmentBody — has to carry every member, or that member is
+          #   silently dropped on whichever path forgot it.
           #
           #   @param buttons [Array<Sentdm::Models::ConversationMessagesList::Message::MessageBody::Button>, nil]
+          #
           #   @param content [String]
+          #
           #   @param footer [String, nil]
+          #
           #   @param header [String, nil]
+          #
+          #   @param header_media [Sentdm::Models::ConversationMessagesList::Message::MessageBody::HeaderMedia, nil] The media asset that rode a message's header, recorded as sent.
+          #
+          #   @param media [Array<Sentdm::Models::ConversationMessagesList::Message::MessageBody::Media>, nil] MMS attachments, as the publicly fetchable URLs handed to the carrier. Null on e
+          #
+          #   @param subject [String, nil] MMS subject line. Null on every other channel.
 
           class Button < Sentdm::Internal::Type::BaseModel
             # @!attribute postback_data
@@ -238,6 +301,64 @@ module Sentdm
             #   @param type [String]
             #   @param value [String]
           end
+
+          # @see Sentdm::Models::ConversationMessagesList::Message::MessageBody#header_media
+          class HeaderMedia < Sentdm::Internal::Type::BaseModel
+            # @!attribute type
+            #   "image", "video" or "document" — taken from the header's media variable.
+            #
+            #   @return [String, nil]
+            optional :type, String
+
+            # @!attribute url
+            #   The https URL the caller supplied for this send. Never the template's stored
+            #   props.sample, which is Meta's expiring header_handle rather than what was
+            #   delivered.
+            #
+            #   @return [String, nil]
+            optional :url, String
+
+            # @!method initialize(type: nil, url: nil)
+            #   Some parameter documentations has been truncated, see
+            #   {Sentdm::Models::ConversationMessagesList::Message::MessageBody::HeaderMedia}
+            #   for more details.
+            #
+            #   The media asset that rode a message's header, recorded as sent.
+            #
+            #   @param type [String] "image", "video" or "document" — taken from the header's media variable.
+            #
+            #   @param url [String] The https URL the caller supplied for this send. Never the template's stored
+          end
+
+          class Media < Sentdm::Internal::Type::BaseModel
+            # @!attribute media_type
+            #   One of Constants.MmsMediaTypes when known. Advisory — the carrier reads the
+            #   fetched object's Content-Type, not this.
+            #
+            #   @return [String, nil]
+            optional :media_type, String, api_name: :mediaType, nil?: true
+
+            # @!attribute url
+            #
+            #   @return [String, nil]
+            optional :url, String
+
+            # @!method initialize(media_type: nil, url: nil)
+            #   Some parameter documentations has been truncated, see
+            #   {Sentdm::Models::ConversationMessagesList::Message::MessageBody::Media} for more
+            #   details.
+            #
+            #   One attachment on a message: a customer-supplied public URL handed to the
+            #   carrier as-is.
+            #
+            #                A URL and nothing else. sent.dm never takes custody of MMS media — the customer hosts it and we
+            #                pass the link through at send time — so there is no storage key, size or expiry to record. If we ever
+            #                do host attachments, that belongs with the change that introduces the hosting, not here.
+            #
+            #   @param media_type [String, nil] One of Constants.MmsMediaTypes when known. Advisory — the carrier reads the
+            #
+            #   @param url [String]
+          end
         end
       end
     end

data/lib/sentdm/models/inbound_message_event.rb

@@ -4,16 +4,16 @@ module Sentdm
   module Models
     class InboundMessageEvent < Sentdm::Internal::Type::BaseModel
       # @!attribute event
-      #   The specific event within the family, for example message.delivered or
-      #   message.received. Absent on events that have no subtype, so treat it as
-      #   optional.
+      #   The specific event within the family, for example message.delivered,
+      #   message.received or contact.opt_out. Absent on events that have no subtype, so
+      #   treat it as optional.
       #
       #   @return [String, nil]
       optional :event, String, nil?: true
 
       # @!attribute field
-      #   The event family, for example message or templates. Route on this first, then on
-      #   event for the specific change.
+      #   The event family, for example message, templates or contact. Route on this
+      #   first, then on event for the specific change.
       #
       #   @return [String, nil]
       optional :field, String
@@ -25,6 +25,12 @@ module Sentdm
       #   @return [Sentdm::Models::InboundMessageEventPayload, nil]
       optional :payload, -> { Sentdm::InboundMessageEventPayload }, nil?: true
 
+      # @!attribute request_id
+      #   The event-specific body.
+      #
+      #   @return [String, nil]
+      optional :request_id, String, nil?: true
+
       # @!attribute timestamp
       #   When Sent emitted the event, in UTC (yyyy-MM-ddTHH:mm:ssZ). This is the emission
       #   time, not the time the underlying change happened. Use the timestamp inside the
@@ -33,19 +39,21 @@ module Sentdm
       #   @return [String, nil]
       optional :timestamp, String
 
-      # @!method initialize(event: nil, field: nil, payload: nil, timestamp: nil)
+      # @!method initialize(event: nil, field: nil, payload: nil, request_id: nil, timestamp: nil)
       #   Some parameter documentations has been truncated, see
       #   {Sentdm::Models::InboundMessageEvent} for more details.
       #
       #   The envelope Sent POSTs to a subscribed webhook endpoint. Every event shares
       #   this shape and varies only in Payload.
       #
-      #   @param event [String, nil] The specific event within the family, for example message.delivered or
+      #   @param event [String, nil] The specific event within the family, for example message.delivered,
       #
-      #   @param field [String] The event family, for example message or templates. Route on this first, then
+      #   @param field [String] The event family, for example message, templates or contact. Route on
       #
       #   @param payload [Sentdm::Models::InboundMessageEventPayload, nil] Body of a message.received event. Delivered when a contact messages one of your
       #
+      #   @param request_id [String, nil] The event-specific body.
+      #
       #   @param timestamp [String] When Sent emitted the event, in UTC (yyyy-MM-ddTHH:mm:ssZ). This is the emission
     end
   end

data/lib/sentdm/models/message_event.rb

@@ -4,16 +4,16 @@ module Sentdm
   module Models
     class MessageEvent < Sentdm::Internal::Type::BaseModel
       # @!attribute event
-      #   The specific event within the family, for example message.delivered or
-      #   message.received. Absent on events that have no subtype, so treat it as
-      #   optional.
+      #   The specific event within the family, for example message.delivered,
+      #   message.received or contact.opt_out. Absent on events that have no subtype, so
+      #   treat it as optional.
       #
       #   @return [String, nil]
       optional :event, String, nil?: true
 
       # @!attribute field
-      #   The event family, for example message or templates. Route on this first, then on
-      #   event for the specific change.
+      #   The event family, for example message, templates or contact. Route on this
+      #   first, then on event for the specific change.
       #
       #   @return [String, nil]
       optional :field, String
@@ -26,6 +26,12 @@ module Sentdm
       #   @return [Sentdm::Models::MessageEventPayload, nil]
       optional :payload, -> { Sentdm::MessageEventPayload }, nil?: true
 
+      # @!attribute request_id
+      #   The event-specific body.
+      #
+      #   @return [String, nil]
+      optional :request_id, String, nil?: true
+
       # @!attribute timestamp
       #   When Sent emitted the event, in UTC (yyyy-MM-ddTHH:mm:ssZ). This is the emission
       #   time, not the time the underlying change happened. Use the timestamp inside the
@@ -34,19 +40,21 @@ module Sentdm
       #   @return [String, nil]
       optional :timestamp, String
 
-      # @!method initialize(event: nil, field: nil, payload: nil, timestamp: nil)
+      # @!method initialize(event: nil, field: nil, payload: nil, request_id: nil, timestamp: nil)
       #   Some parameter documentations has been truncated, see
       #   {Sentdm::Models::MessageEvent} for more details.
       #
       #   The envelope Sent POSTs to a subscribed webhook endpoint. Every event shares
       #   this shape and varies only in Payload.
       #
-      #   @param event [String, nil] The specific event within the family, for example message.delivered or
+      #   @param event [String, nil] The specific event within the family, for example message.delivered,
       #
-      #   @param field [String] The event family, for example message or templates. Route on this first, then
+      #   @param field [String] The event family, for example message, templates or contact. Route on
       #
       #   @param payload [Sentdm::Models::MessageEventPayload, nil] Body of an outbound message lifecycle event. Delivered once per status change, s
       #
+      #   @param request_id [String, nil] The event-specific body.
+      #
       #   @param timestamp [String] When Sent emitted the event, in UTC (yyyy-MM-ddTHH:mm:ssZ). This is the emission
     end
   end

data/lib/sentdm/models/message_event_payload.rb

@@ -23,6 +23,14 @@ module Sentdm
       #   @return [String, nil]
       optional :agent_id, String, nil?: true
 
+      # @!attribute body
+      #   The rendered message body, as plain text. Sent as null when we aren't asserting
+      #   a body for this event. The field is always present, so read it and check for
+      #   null rather than checking whether the key exists. Truncated to 3072 characters.
+      #
+      #   @return [String, nil]
+      optional :body, String, nil?: true
+
       # @!attribute channel
       #   The channel the message went out on, for example sms or whatsapp. A message that
       #   falls back to another channel reports the channel actually used.
@@ -43,6 +51,21 @@ module Sentdm
       #   @return [String, nil]
       optional :outbound_number, String
 
+      # @!attribute schedule_reason
+      #   message.scheduled only: why the message is held, either because you scheduled it
+      #   or because the recipient is inside a protected quiet-hours window. Omitted on
+      #   every other event.
+      #
+      #   @return [String, nil]
+      optional :schedule_reason, String, nil?: true
+
+      # @!attribute scheduled_at
+      #   message.scheduled only: when the held message will be released for delivery, in
+      #   UTC (yyyy-MM-ddTHH:mm:ssZ). Omitted on every other event.
+      #
+      #   @return [String, nil]
+      optional :scheduled_at, String, nil?: true
+
       # @!attribute template_id
       #   The template the message was sent from, when it was sent from one.
       #
@@ -62,7 +85,7 @@ module Sentdm
       #   @return [String, nil]
       optional :updated_at, String
 
-      # @!method initialize(message_status:, account_id: nil, agent_id: nil, channel: nil, message_id: nil, outbound_number: nil, template_id: nil, template_name: nil, updated_at: nil)
+      # @!method initialize(message_status:, account_id: nil, agent_id: nil, body: nil, channel: nil, message_id: nil, outbound_number: nil, schedule_reason: nil, scheduled_at: nil, template_id: nil, template_name: nil, updated_at: nil)
       #   Some parameter documentations has been truncated, see
       #   {Sentdm::Models::MessageEventPayload} for more details.
       #
@@ -76,12 +99,18 @@ module Sentdm
       #
       #   @param agent_id [String, nil] The agent attributed to the send, when the send was attributed to one.
       #
+      #   @param body [String, nil] The rendered message body, as plain text. Sent as null when we aren't asserting
+      #
       #   @param channel [String] The channel the message went out on, for example sms or whatsapp. A message
       #
       #   @param message_id [String] The message this event describes. Stable across every event in the message's lif
       #
       #   @param outbound_number [String] The recipient's number in E.164 format.
       #
+      #   @param schedule_reason [String, nil] message.scheduled only: why the message is held, either because you scheduled it
+      #
+      #   @param scheduled_at [String, nil] message.scheduled only: when the held message will be released for delivery, in
+      #
       #   @param template_id [String, nil] The template the message was sent from, when it was sent from one.
       #
       #   @param template_name [String, nil] Name of the template the message was sent from. Omitted when the message wasn't

data/lib/sentdm/models/message_retrieve_activities_response.rb

@@ -98,9 +98,18 @@ module Sentdm
           #   @return [String, nil]
           optional :price, String, nil?: true
 
+          # @!attribute scheduled_at
+          #   SCHEDULED activities only: when the held message will be released for delivery,
+          #   in UTC. Same wire name as on the send response, the message and the webhook.
+          #   Omitted on every other activity. A message that quiet hours moved at release has
+          #   two SCHEDULED entries, each carrying the instant as it stood at that moment.
+          #
+          #   @return [Time, nil]
+          optional :scheduled_at, Time, nil?: true
+
           # @!attribute status
-          #   Activity status. Outbound: QUEUED, PROCESSED, ROUTED, SENT, DELIVERED, READ,
-          #   FAILED. Inbound (from contact): RECEIVED (terminal).
+          #   Activity status. Outbound: QUEUED, PROCESSED, ROUTED, SCHEDULED, SENT,
+          #   DELIVERED, READ, FAILED. Inbound (from contact): RECEIVED (terminal).
           #
           #   @return [String, nil]
           optional :status, String
@@ -111,12 +120,16 @@ module Sentdm
           #   @return [Time, nil]
           optional :timestamp, Time
 
-          # @!method initialize(active_contact_price: nil, description: nil, from: nil, price: nil, status: nil, timestamp: nil)
+          # @!method initialize(active_contact_price: nil, description: nil, from: nil, price: nil, scheduled_at: nil, status: nil, timestamp: nil)
           #   Some parameter documentations has been truncated, see
           #   {Sentdm::Models::MessageRetrieveActivitiesResponse::Data::Activity} for more
           #   details.
           #
-          #   A single message activity event for v3 API
+          #   A single message activity event for v3 API.
+          #
+          #   The activity list mixes statuses, so unlike a message it is one shape rather
+          #   than two: a SCHEDULED entry carries scheduled_at, and every other entry has no
+          #   such key.
           #
           #   @param active_contact_price [String, nil] Active contact markup applied on top of the channel cost, formatted to 4 decimal
           #
@@ -126,7 +139,9 @@ module Sentdm
           #
           #   @param price [String, nil] Channel cost for this activity (e.g., SMS/WhatsApp provider cost), formatted to
           #
-          #   @param status [String] Activity status. Outbound: QUEUED, PROCESSED, ROUTED, SENT, DELIVERED, READ, FAI
+          #   @param scheduled_at [Time, nil] SCHEDULED activities only: when the held message will be released for delivery,
+          #
+          #   @param status [String] Activity status. Outbound: QUEUED, PROCESSED, ROUTED, SCHEDULED, SENT, DELIVERED
           #
           #   @param timestamp [Time] When this activity occurred
         end

data/lib/sentdm/models/message_retrieve_status_response.rb

@@ -5,7 +5,12 @@ module Sentdm
     # @see Sentdm::Resources::Messages#retrieve_status
     class MessageRetrieveStatusResponse < Sentdm::Internal::Type::BaseModel
       # @!attribute data
-      #   Message response for v3 API — same shape as v2 with snake_case JSON conventions
+      #   Message response for v3 API — same shape as v2 with snake_case JSON conventions.
+      #
+      #   The shape of a message that was sent immediately: it never has a scheduled_at
+      #   key. A message that is or was held for a later instant is a
+      #   ScheduledMessageResponse, and the endpoint decides which of the two to answer
+      #   with. From always returns this type.
       #
       #   @return [Sentdm::Models::MessageRetrieveStatusResponse::Data, nil]
       optional :data, -> { Sentdm::Models::MessageRetrieveStatusResponse::Data }, nil?: true
@@ -29,9 +34,12 @@ module Sentdm
       optional :success, Sentdm::Internal::Type::Boolean
 
       # @!method initialize(data: nil, error: nil, meta: nil, success: nil)
+      #   Some parameter documentations has been truncated, see
+      #   {Sentdm::Models::MessageRetrieveStatusResponse} for more details.
+      #
       #   Standard API response envelope for all v3 endpoints
       #
-      #   @param data [Sentdm::Models::MessageRetrieveStatusResponse::Data, nil] Message response for v3 API — same shape as v2 with snake_case JSON conventions
+      #   @param data [Sentdm::Models::MessageRetrieveStatusResponse::Data, nil] Message response for v3 API — same shape as v2 with snake_case JSON conventions.
       #
       #   @param error [Sentdm::Models::ErrorDetail, nil] Error information
       #
@@ -85,7 +93,14 @@ module Sentdm
 
         # @!attribute message_body
         #   Structured message body format for database storage. Preserves channel-specific
-        #   components (header, body, footer, buttons).
+        #   components (header, header media, body, footer, buttons, MMS subject and media).
+        #
+        #   Persisted as the messageBody jsonb column on Messages. Every write path goes
+        #   through MessageUtils.MessageBodyJsonOptions, which writes nulls, so the envelope
+        #   shape is stable regardless of channel or status. Anything that rebuilds this
+        #   object field by field — the four IMessageBodyStrategy implementations and
+        #   MessageUtils.BuildSegmentBody — has to carry every member, or that member is
+        #   silently dropped on whichever path forgot it.
         #
         #   @return [Sentdm::Models::MessageRetrieveStatusResponse::Data::MessageBody, nil]
         optional :message_body,
@@ -136,7 +151,12 @@ module Sentdm
         #   Some parameter documentations has been truncated, see
         #   {Sentdm::Models::MessageRetrieveStatusResponse::Data} for more details.
         #
-        #   Message response for v3 API — same shape as v2 with snake_case JSON conventions
+        #   Message response for v3 API — same shape as v2 with snake_case JSON conventions.
+        #
+        #   The shape of a message that was sent immediately: it never has a scheduled_at
+        #   key. A message that is or was held for a later instant is a
+        #   ScheduledMessageResponse, and the endpoint decides which of the two to answer
+        #   with. From always returns this type.
         #
         #   @param id [String]
         #
@@ -220,14 +240,63 @@ module Sentdm
           #   @return [String, nil]
           optional :header, String, nil?: true
 
-          # @!method initialize(buttons: nil, content: nil, footer: nil, header: nil)
+          # @!attribute header_media
+          #   The media asset that rode a message's header, recorded as sent.
+          #
+          #   @return [Sentdm::Models::MessageRetrieveStatusResponse::Data::MessageBody::HeaderMedia, nil]
+          optional :header_media,
+                   -> { Sentdm::Models::MessageRetrieveStatusResponse::Data::MessageBody::HeaderMedia },
+                   api_name: :headerMedia,
+                   nil?: true
+
+          # @!attribute media
+          #   MMS attachments, as the publicly fetchable URLs handed to the carrier. Null on
+          #   every other channel.
+          #
+          #   Persisted rather than derived because a resend and a curfew release rebuild the
+          #   send from the stored row — MessageReplayCommandBuilder reads templateId and
+          #   templateVariables and nothing else — so media that lives only on the original
+          #   request would silently turn a replayed MMS into a text message.
+          #
+          #   @return [Array<Sentdm::Models::MessageRetrieveStatusResponse::Data::MessageBody::Media>, nil]
+          optional :media,
+                   -> { Sentdm::Internal::Type::ArrayOf[Sentdm::Models::MessageRetrieveStatusResponse::Data::MessageBody::Media] },
+                   nil?: true
+
+          # @!attribute subject
+          #   MMS subject line. Null on every other channel.
+          #
+          #   @return [String, nil]
+          optional :subject, String, nil?: true
+
+          # @!method initialize(buttons: nil, content: nil, footer: nil, header: nil, header_media: nil, media: nil, subject: nil)
+          #   Some parameter documentations has been truncated, see
+          #   {Sentdm::Models::MessageRetrieveStatusResponse::Data::MessageBody} for more
+          #   details.
+          #
           #   Structured message body format for database storage. Preserves channel-specific
-          #   components (header, body, footer, buttons).
+          #   components (header, header media, body, footer, buttons, MMS subject and media).
+          #
+          #   Persisted as the messageBody jsonb column on Messages. Every write path goes
+          #   through MessageUtils.MessageBodyJsonOptions, which writes nulls, so the envelope
+          #   shape is stable regardless of channel or status. Anything that rebuilds this
+          #   object field by field — the four IMessageBodyStrategy implementations and
+          #   MessageUtils.BuildSegmentBody — has to carry every member, or that member is
+          #   silently dropped on whichever path forgot it.
           #
           #   @param buttons [Array<Sentdm::Models::MessageRetrieveStatusResponse::Data::MessageBody::Button>, nil]
+          #
           #   @param content [String]
+          #
           #   @param footer [String, nil]
+          #
           #   @param header [String, nil]
+          #
+          #   @param header_media [Sentdm::Models::MessageRetrieveStatusResponse::Data::MessageBody::HeaderMedia, nil] The media asset that rode a message's header, recorded as sent.
+          #
+          #   @param media [Array<Sentdm::Models::MessageRetrieveStatusResponse::Data::MessageBody::Media>, nil] MMS attachments, as the publicly fetchable URLs handed to the carrier. Null on e
+          #
+          #   @param subject [String, nil] MMS subject line. Null on every other channel.
 
           class Button < Sentdm::Internal::Type::BaseModel
             # @!attribute postback_data
@@ -256,6 +325,64 @@ module Sentdm
             #   @param type [String]
             #   @param value [String]
           end
+
+          # @see Sentdm::Models::MessageRetrieveStatusResponse::Data::MessageBody#header_media
+          class HeaderMedia < Sentdm::Internal::Type::BaseModel
+            # @!attribute type
+            #   "image", "video" or "document" — taken from the header's media variable.
+            #
+            #   @return [String, nil]
+            optional :type, String
+
+            # @!attribute url
+            #   The https URL the caller supplied for this send. Never the template's stored
+            #   props.sample, which is Meta's expiring header_handle rather than what was
+            #   delivered.
+            #
+            #   @return [String, nil]
+            optional :url, String
+
+            # @!method initialize(type: nil, url: nil)
+            #   Some parameter documentations has been truncated, see
+            #   {Sentdm::Models::MessageRetrieveStatusResponse::Data::MessageBody::HeaderMedia}
+            #   for more details.
+            #
+            #   The media asset that rode a message's header, recorded as sent.
+            #
+            #   @param type [String] "image", "video" or "document" — taken from the header's media variable.
+            #
+            #   @param url [String] The https URL the caller supplied for this send. Never the template's stored
+          end
+
+          class Media < Sentdm::Internal::Type::BaseModel
+            # @!attribute media_type
+            #   One of Constants.MmsMediaTypes when known. Advisory — the carrier reads the
+            #   fetched object's Content-Type, not this.
+            #
+            #   @return [String, nil]
+            optional :media_type, String, api_name: :mediaType, nil?: true
+
+            # @!attribute url
+            #
+            #   @return [String, nil]
+            optional :url, String
+
+            # @!method initialize(media_type: nil, url: nil)
+            #   Some parameter documentations has been truncated, see
+            #   {Sentdm::Models::MessageRetrieveStatusResponse::Data::MessageBody::Media} for
+            #   more details.
+            #
+            #   One attachment on a message: a customer-supplied public URL handed to the
+            #   carrier as-is.
+            #
+            #                A URL and nothing else. sent.dm never takes custody of MMS media — the customer hosts it and we
+            #                pass the link through at send time — so there is no storage key, size or expiry to record. If we ever
+            #                do host attachments, that belongs with the change that introduces the hosting, not here.
+            #
+            #   @param media_type [String, nil] One of Constants.MmsMediaTypes when known. Advisory — the carrier reads the
+            #
+            #   @param url [String]
+          end
         end
       end
     end