@sentdm/sentdm 0.38.0 → 0.40.0

package/resources/messages.d.ts

@@ -8,11 +8,15 @@ import { RequestOptions } from "../internal/request-options.js";
  * One endpoint sends on any channel: pass `channel: "sent"` and we pick between SMS, WhatsApp and RCS per recipient using your routing rules, or name a channel to pin it. A send is accepted asynchronously — `POST /v3/messages` returns an id, and delivery is reported through `GET /v3/messages/{id}`, its activities, or a webhook.
  *
  * **A message needs a sender.** What you can send, where, and at what cost is decided by the markets under **Channels** — so a recipient in a country you hold no sender for is refused here rather than queued.
+ *
+ * **A message can be resent on its id.** `POST /v3/messages/{id}/resend` puts a finished message — typically one BLOCKED for insufficient balance — back through the send pipeline. It is a new attempt, not a free retry: every policy runs again, the message is billed again, and its status webhooks fire again. A FILTERED message is never resendable.
  */
 export declare class Messages extends APIResource {
     /**
      * Retrieves the activity log for a specific message. Activities track the message
-     * lifecycle including acceptance, processing, sending, delivery, and any errors.
+     * lifecycle including acceptance, processing, sending, delivery, and any errors. A
+     * SCHEDULED entry carries scheduled_at, the release instant in UTC as it stood at
+     * that moment. Other entries have no scheduled_at key.
      *
      * @example
      * ```ts
@@ -24,7 +28,11 @@ export declare class Messages extends APIResource {
     retrieveActivities(id: string, params?: MessageRetrieveActivitiesParams | null | undefined, options?: RequestOptions): APIPromise<MessageRetrieveActivitiesResponse>;
     /**
      * Retrieves the current status and details of a message by ID. Includes delivery
-     * status, timestamps, and error information if applicable.
+     * status, timestamps, and error information if applicable. A message that is or
+     * was held for a later time (a send you scheduled with scheduled_at, or a
+     * quiet-hours hold) is returned as a ScheduledMessageResponse: the same fields
+     * plus scheduled_at, the release instant in UTC. A message sent immediately has no
+     * scheduled_at key.
      *
      * @example
      * ```ts
@@ -44,7 +52,17 @@ export declare class Messages extends APIResource {
      * insufficient balance, a template not approved for sending, or free-form content
      * with no open conversation with the contact. The send is accepted with 202 and
      * the affected messages are reported as BLOCKED on GET /messages/{id} and the
-     * message.blocked webhook.
+     * message.blocked webhook. To send later, set scheduled_at (ISO-8601 with an
+     * explicit UTC offset; a value without one is rejected) between 1 minute and 30
+     * days ahead: the response is a ScheduledSendMessageResponse (the same fields plus
+     * scheduled_at; status is still QUEUED), each message then moves to SCHEDULED, is
+     * held and released at that time (within a few minutes), and a message.scheduled
+     * webhook fires once it is held. Balance and template approval are evaluated at
+     * release, not at acceptance. Quiet hours are not checked when the request is
+     * accepted: if the time falls inside a legally protected quiet-hours window for a
+     * recipient, that message is moved to the next allowed time at release and a
+     * second message.scheduled webhook reports the new scheduled_at. An account may
+     * hold at most 1,000,000 scheduled messages at once (429 LIMIT_001).
      *
      * @example
      * ```ts
@@ -94,7 +112,11 @@ export declare namespace MessageRetrieveActivitiesResponse {
     }
     namespace Data {
         /**
-         * 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.
          */
         interface Activity {
             /**
@@ -118,8 +140,15 @@ export declare namespace MessageRetrieveActivitiesResponse {
              */
             price?: string | null;
             /**
-             * Activity status. Outbound: QUEUED, PROCESSED, ROUTED, SENT, DELIVERED, READ,
-             * FAILED. Inbound (from contact): RECEIVED (terminal).
+             * 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.
+             */
+            scheduled_at?: string | null;
+            /**
+             * Activity status. Outbound: QUEUED, PROCESSED, ROUTED, SCHEDULED, SENT,
+             * DELIVERED, READ, FAILED. Inbound (from contact): RECEIVED (terminal).
              */
             status?: string;
             /**
@@ -134,7 +163,12 @@ export declare namespace MessageRetrieveActivitiesResponse {
  */
 export interface MessageRetrieveStatusResponse {
     /**
-     * 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.
      */
     data?: MessageRetrieveStatusResponse.Data | null;
     /**
@@ -152,7 +186,12 @@ export interface MessageRetrieveStatusResponse {
 }
 export declare namespace MessageRetrieveStatusResponse {
     /**
-     * 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.
      */
     interface Data {
         id?: string;
@@ -165,7 +204,14 @@ export declare namespace MessageRetrieveStatusResponse {
         events?: Array<Data.Event> | null;
         /**
          * 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.
          */
         message_body?: Data.MessageBody | null;
         phone?: string;
@@ -188,13 +234,38 @@ export declare namespace MessageRetrieveStatusResponse {
         }
         /**
          * 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.
          */
         interface MessageBody {
             buttons?: Array<MessageBody.Button> | null;
             content?: string;
             footer?: string | null;
             header?: string | null;
+            /**
+             * The media asset that rode a message's header, recorded as sent.
+             */
+            headerMedia?: MessageBody.HeaderMedia | null;
+            /**
+             * 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.
+             */
+            media?: Array<MessageBody.Media> | null;
+            /**
+             * MMS subject line. Null on every other channel.
+             */
+            subject?: string | null;
         }
         namespace MessageBody {
             interface Button {
@@ -203,6 +274,37 @@ export declare namespace MessageRetrieveStatusResponse {
                 type?: string;
                 value?: string;
             }
+            /**
+             * The media asset that rode a message's header, recorded as sent.
+             */
+            interface HeaderMedia {
+                /**
+                 * "image", "video" or "document" — taken from the header's media variable.
+                 */
+                type?: string;
+                /**
+                 * 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.
+                 */
+                url?: string;
+            }
+            /**
+             * 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.
+             */
+            interface Media {
+                /**
+                 * One of Constants.MmsMediaTypes when known. Advisory — the carrier reads the
+                 * fetched object's Content-Type, not this.
+                 */
+                mediaType?: string | null;
+                url?: string;
+            }
         }
     }
 }
@@ -220,7 +322,9 @@ export interface MessageSendResponse {
      * its result; this is what a caller sees, and the mapping between them is a
      * decision the endpoint makes.
      *
-     * The wire is unchanged by the move: same names, same values.
+     * The shape of an immediate send: it never has a scheduled_at key. A send that
+     * carried scheduled_at is a ScheduledSendMessageResponse, and the endpoint decides
+     * which of the two to answer with. From always returns this type.
      */
     data?: MessageSendResponse.Data | null;
     /**
@@ -247,12 +351,16 @@ export declare namespace MessageSendResponse {
      * its result; this is what a caller sees, and the mapping between them is a
      * decision the endpoint makes.
      *
-     * The wire is unchanged by the move: same names, same values.
+     * The shape of an immediate send: it never has a scheduled_at key. A send that
+     * carried scheduled_at is a ScheduledSendMessageResponse, and the endpoint decides
+     * which of the two to answer with. From always returns this type.
      */
     interface Data {
         recipients?: Array<Data.Recipient>;
         /**
-         * Overall status — QUEUED once the batch is accepted for delivery.
+         * QUEUED: the batch is accepted. A request that carried scheduled_at is QUEUED
+         * here too; each message moves to SCHEDULED once it is held, as GET
+         * /v3/messages/{id} and the message.scheduled webhook report.
          */
         status?: string;
         template_id?: string;
@@ -304,11 +412,47 @@ export interface MessageSendParams {
      * ["sent"] (auto-detect) if omitted.
      */
     channel?: Array<string> | null;
+    /**
+     * Body param: Attachments for this send, as publicly fetchable https URLs. Used by
+     * the MMS channel and ignored by every other one.
+     *
+     * Supplying these replaces the media on the template's mms body rather than adding
+     * to it, so a template can hold a default creative while a caller still sends
+     * something recipient-specific.
+     *
+     * Their presence is also what makes a message eligible for MMS on an auto-detect
+     * send: a message with nothing attached is delivered as SMS, because an MMS with
+     * no media is a more expensive text message.
+     *
+     * The recipient's carrier fetches each URL after the send is accepted, so it must
+     * stay publicly reachable — a link that expires, or one behind auth, arrives as a
+     * failed message.
+     */
+    media_urls?: Array<string> | null;
     /**
      * Body param: Sandbox flag - when true, the operation is simulated without side
      * effects Useful for testing integrations without actual execution
      */
     sandbox?: boolean;
+    /**
+     * Body param: Optional future send time as an ISO-8601 timestamp with an explicit
+     * UTC offset, e.g. 2026-10-01T09:00:00+02:00 or 2026-10-01T07:00:00Z. A value
+     * without an offset is rejected (400) rather than read in the server's zone. The
+     * offset only fixes the instant: it is stored and echoed in UTC as scheduled_at.
+     * Omit to send now. Must be at least one minute ahead and at most 30 days ahead.
+     * Accepted messages report SCHEDULED and are released for delivery at this time.
+     * Quiet hours, balance and template approval are evaluated at release, not at
+     * acceptance: a message whose time falls inside a recipient's protected
+     * quiet-hours window is moved to the next allowed time and a second
+     * message.scheduled webhook reports the new scheduled_at.
+     */
+    scheduled_at?: string | null;
+    /**
+     * Body param: Subject line for this send, overriding the template's. MMS only;
+     * ignored on every other channel. Most handsets render it above the body, some
+     * ignore it entirely.
+     */
+    subject?: string | null;
     /**
      * Body param: SDK-style template reference: resolve by ID or by name, with
      * optional parameters.
@@ -352,7 +496,20 @@ export declare namespace MessageSendParams {
          */
         name?: string | null;
         /**
-         * Template variable parameters for personalization
+         * Template variable parameters for personalization, keyed by variable name.
+         *
+         * Every variable the template declares is required; GET /v3/templates/{id} lists
+         * them. Supplying a key the template does not declare is ignored.
+         *
+         * Media headers. A template whose header is an image (designed in WhatsApp Manager
+         * and imported into Sent) declares a reserved header_image key. Its value is a
+         * publicly reachable https URL that Meta fetches at send time — Sent does not host
+         * the asset, and the sample approved with the template is not reused. The key is
+         * derived from the header's media type, so header_video and header_document follow
+         * the same shape when those formats ship.
+         *
+         * "parameters": { "header_image": "https://cdn.example.com/banner.jpg", "name":
+         * "John Doe" }
          */
         parameters?: {
             [key: string]: string;

package/resources/messages.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"messages.d.ts","sourceRoot":"","sources":["../src/resources/messages.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"messages.d.ts","sourceRoot":"","sources":["../src/resources/messages.ts"],"names":[],"mappings":"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"}

package/resources/messages.js

@@ -11,11 +11,15 @@ const path_1 = require("../internal/utils/path.js");
  * One endpoint sends on any channel: pass `channel: "sent"` and we pick between SMS, WhatsApp and RCS per recipient using your routing rules, or name a channel to pin it. A send is accepted asynchronously — `POST /v3/messages` returns an id, and delivery is reported through `GET /v3/messages/{id}`, its activities, or a webhook.
  *
  * **A message needs a sender.** What you can send, where, and at what cost is decided by the markets under **Channels** — so a recipient in a country you hold no sender for is refused here rather than queued.
+ *
+ * **A message can be resent on its id.** `POST /v3/messages/{id}/resend` puts a finished message — typically one BLOCKED for insufficient balance — back through the send pipeline. It is a new attempt, not a free retry: every policy runs again, the message is billed again, and its status webhooks fire again. A FILTERED message is never resendable.
  */
 class Messages extends resource_1.APIResource {
     /**
      * Retrieves the activity log for a specific message. Activities track the message
-     * lifecycle including acceptance, processing, sending, delivery, and any errors.
+     * lifecycle including acceptance, processing, sending, delivery, and any errors. A
+     * SCHEDULED entry carries scheduled_at, the release instant in UTC as it stood at
+     * that moment. Other entries have no scheduled_at key.
      *
      * @example
      * ```ts
@@ -36,7 +40,11 @@ class Messages extends resource_1.APIResource {
     }
     /**
      * Retrieves the current status and details of a message by ID. Includes delivery
-     * status, timestamps, and error information if applicable.
+     * status, timestamps, and error information if applicable. A message that is or
+     * was held for a later time (a send you scheduled with scheduled_at, or a
+     * quiet-hours hold) is returned as a ScheduledMessageResponse: the same fields
+     * plus scheduled_at, the release instant in UTC. A message sent immediately has no
+     * scheduled_at key.
      *
      * @example
      * ```ts
@@ -65,7 +73,17 @@ class Messages extends resource_1.APIResource {
      * insufficient balance, a template not approved for sending, or free-form content
      * with no open conversation with the contact. The send is accepted with 202 and
      * the affected messages are reported as BLOCKED on GET /messages/{id} and the
-     * message.blocked webhook.
+     * message.blocked webhook. To send later, set scheduled_at (ISO-8601 with an
+     * explicit UTC offset; a value without one is rejected) between 1 minute and 30
+     * days ahead: the response is a ScheduledSendMessageResponse (the same fields plus
+     * scheduled_at; status is still QUEUED), each message then moves to SCHEDULED, is
+     * held and released at that time (within a few minutes), and a message.scheduled
+     * webhook fires once it is held. Balance and template approval are evaluated at
+     * release, not at acceptance. Quiet hours are not checked when the request is
+     * accepted: if the time falls inside a legally protected quiet-hours window for a
+     * recipient, that message is moved to the next allowed time at release and a
+     * second message.scheduled webhook reports the new scheduled_at. An account may
+     * hold at most 1,000,000 scheduled messages at once (429 LIMIT_001).
      *
      * @example
      * ```ts

package/resources/messages.js.map

@@ -1 +1 @@
-{"version":3,"file":"messages.js","sourceRoot":"","sources":["../src/resources/messages.ts"],"names":[],"mappings":";AAAA,sFAAsF;;;AAEtF,kDAA+C;AAG/C,oDAAmD;AAEnD,oDAA8C;AAE9C;;;;;;GAMG;AACH,MAAa,QAAS,SAAQ,sBAAW;IACvC;;;;;;;;;;OAUG;IACH,kBAAkB,CAChB,EAAU,EACV,SAA6D,EAAE,EAC/D,OAAwB;QAExB,MAAM,EAAE,cAAc,EAAE,UAAU,EAAE,GAAG,MAAM,IAAI,EAAE,CAAC;QACpD,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAA,WAAI,EAAA,gBAAgB,EAAE,aAAa,EAAE;YAC3D,GAAG,OAAO;YACV,OAAO,EAAE,IAAA,sBAAY,EAAC;gBACpB,EAAE,GAAG,CAAC,UAAU,IAAI,IAAI,CAAC,CAAC,CAAC,EAAE,cAAc,EAAE,UAAU,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC,EAAE;gBACxE,OAAO,EAAE,OAAO;aACjB,CAAC;SACH,CAAC,CAAC;IACL,CAAC;IAED;;;;;;;;;;OAUG;IACH,cAAc,CACZ,EAAU,EACV,SAAyD,EAAE,EAC3D,OAAwB;QAExB,MAAM,EAAE,cAAc,EAAE,UAAU,EAAE,GAAG,MAAM,IAAI,EAAE,CAAC;QACpD,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAA,WAAI,EAAA,gBAAgB,EAAE,EAAE,EAAE;YAChD,GAAG,OAAO;YACV,OAAO,EAAE,IAAA,sBAAY,EAAC;gBACpB,EAAE,GAAG,CAAC,UAAU,IAAI,IAAI,CAAC,CAAC,CAAC,EAAE,cAAc,EAAE,UAAU,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC,EAAE;gBACxE,OAAO,EAAE,OAAO;aACjB,CAAC;SACH,CAAC,CAAC;IACL,CAAC;IAED;;;;;;;;;;;;;;;;OAgBG;IACH,IAAI,CAAC,MAAyB,EAAE,OAAwB;QACtD,MAAM,EAAE,iBAAiB,EAAE,cAAc,EAAE,cAAc,EAAE,UAAU,EAAE,GAAG,IAAI,EAAE,GAAG,MAAM,CAAC;QAC1F,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,cAAc,EAAE;YACvC,IAAI;YACJ,GAAG,OAAO;YACV,OAAO,EAAE,IAAA,sBAAY,EAAC;gBACpB;oBACE,GAAG,CAAC,cAAc,IAAI,IAAI,CAAC,CAAC,CAAC,EAAE,iBAAiB,EAAE,cAAc,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC;oBAC/E,GAAG,CAAC,UAAU,IAAI,IAAI,CAAC,CAAC,CAAC,EAAE,cAAc,EAAE,UAAU,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC;iBACrE;gBACD,OAAO,EAAE,OAAO;aACjB,CAAC;SACH,CAAC,CAAC;IACL,CAAC;CACF;AApFD,4BAoFC"}
+{"version":3,"file":"messages.js","sourceRoot":"","sources":["../src/resources/messages.ts"],"names":[],"mappings":";AAAA,sFAAsF;;;AAEtF,kDAA+C;AAG/C,oDAAmD;AAEnD,oDAA8C;AAE9C;;;;;;;;GAQG;AACH,MAAa,QAAS,SAAQ,sBAAW;IACvC;;;;;;;;;;;;OAYG;IACH,kBAAkB,CAChB,EAAU,EACV,SAA6D,EAAE,EAC/D,OAAwB;QAExB,MAAM,EAAE,cAAc,EAAE,UAAU,EAAE,GAAG,MAAM,IAAI,EAAE,CAAC;QACpD,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAA,WAAI,EAAA,gBAAgB,EAAE,aAAa,EAAE;YAC3D,GAAG,OAAO;YACV,OAAO,EAAE,IAAA,sBAAY,EAAC;gBACpB,EAAE,GAAG,CAAC,UAAU,IAAI,IAAI,CAAC,CAAC,CAAC,EAAE,cAAc,EAAE,UAAU,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC,EAAE;gBACxE,OAAO,EAAE,OAAO;aACjB,CAAC;SACH,CAAC,CAAC;IACL,CAAC;IAED;;;;;;;;;;;;;;OAcG;IACH,cAAc,CACZ,EAAU,EACV,SAAyD,EAAE,EAC3D,OAAwB;QAExB,MAAM,EAAE,cAAc,EAAE,UAAU,EAAE,GAAG,MAAM,IAAI,EAAE,CAAC;QACpD,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAA,WAAI,EAAA,gBAAgB,EAAE,EAAE,EAAE;YAChD,GAAG,OAAO;YACV,OAAO,EAAE,IAAA,sBAAY,EAAC;gBACpB,EAAE,GAAG,CAAC,UAAU,IAAI,IAAI,CAAC,CAAC,CAAC,EAAE,cAAc,EAAE,UAAU,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC,EAAE;gBACxE,OAAO,EAAE,OAAO;aACjB,CAAC;SACH,CAAC,CAAC;IACL,CAAC;IAED;;;;;;;;;;;;;;;;;;;;;;;;;;OA0BG;IACH,IAAI,CAAC,MAAyB,EAAE,OAAwB;QACtD,MAAM,EAAE,iBAAiB,EAAE,cAAc,EAAE,cAAc,EAAE,UAAU,EAAE,GAAG,IAAI,EAAE,GAAG,MAAM,CAAC;QAC1F,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,cAAc,EAAE;YACvC,IAAI;YACJ,GAAG,OAAO;YACV,OAAO,EAAE,IAAA,sBAAY,EAAC;gBACpB;oBACE,GAAG,CAAC,cAAc,IAAI,IAAI,CAAC,CAAC,CAAC,EAAE,iBAAiB,EAAE,cAAc,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC;oBAC/E,GAAG,CAAC,UAAU,IAAI,IAAI,CAAC,CAAC,CAAC,EAAE,cAAc,EAAE,UAAU,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC;iBACrE;gBACD,OAAO,EAAE,OAAO;aACjB,CAAC;SACH,CAAC,CAAC;IACL,CAAC;CACF;AApGD,4BAoGC"}

package/resources/messages.mjs

@@ -8,11 +8,15 @@ import { path } from "../internal/utils/path.mjs";
  * One endpoint sends on any channel: pass `channel: "sent"` and we pick between SMS, WhatsApp and RCS per recipient using your routing rules, or name a channel to pin it. A send is accepted asynchronously — `POST /v3/messages` returns an id, and delivery is reported through `GET /v3/messages/{id}`, its activities, or a webhook.
  *
  * **A message needs a sender.** What you can send, where, and at what cost is decided by the markets under **Channels** — so a recipient in a country you hold no sender for is refused here rather than queued.
+ *
+ * **A message can be resent on its id.** `POST /v3/messages/{id}/resend` puts a finished message — typically one BLOCKED for insufficient balance — back through the send pipeline. It is a new attempt, not a free retry: every policy runs again, the message is billed again, and its status webhooks fire again. A FILTERED message is never resendable.
  */
 export class Messages extends APIResource {
     /**
      * Retrieves the activity log for a specific message. Activities track the message
-     * lifecycle including acceptance, processing, sending, delivery, and any errors.
+     * lifecycle including acceptance, processing, sending, delivery, and any errors. A
+     * SCHEDULED entry carries scheduled_at, the release instant in UTC as it stood at
+     * that moment. Other entries have no scheduled_at key.
      *
      * @example
      * ```ts
@@ -33,7 +37,11 @@ export class Messages extends APIResource {
     }
     /**
      * Retrieves the current status and details of a message by ID. Includes delivery
-     * status, timestamps, and error information if applicable.
+     * status, timestamps, and error information if applicable. A message that is or
+     * was held for a later time (a send you scheduled with scheduled_at, or a
+     * quiet-hours hold) is returned as a ScheduledMessageResponse: the same fields
+     * plus scheduled_at, the release instant in UTC. A message sent immediately has no
+     * scheduled_at key.
      *
      * @example
      * ```ts
@@ -62,7 +70,17 @@ export class Messages extends APIResource {
      * insufficient balance, a template not approved for sending, or free-form content
      * with no open conversation with the contact. The send is accepted with 202 and
      * the affected messages are reported as BLOCKED on GET /messages/{id} and the
-     * message.blocked webhook.
+     * message.blocked webhook. To send later, set scheduled_at (ISO-8601 with an
+     * explicit UTC offset; a value without one is rejected) between 1 minute and 30
+     * days ahead: the response is a ScheduledSendMessageResponse (the same fields plus
+     * scheduled_at; status is still QUEUED), each message then moves to SCHEDULED, is
+     * held and released at that time (within a few minutes), and a message.scheduled
+     * webhook fires once it is held. Balance and template approval are evaluated at
+     * release, not at acceptance. Quiet hours are not checked when the request is
+     * accepted: if the time falls inside a legally protected quiet-hours window for a
+     * recipient, that message is moved to the next allowed time at release and a
+     * second message.scheduled webhook reports the new scheduled_at. An account may
+     * hold at most 1,000,000 scheduled messages at once (429 LIMIT_001).
      *
      * @example
      * ```ts

package/resources/messages.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"messages.mjs","sourceRoot":"","sources":["../src/resources/messages.ts"],"names":[],"mappings":"AAAA,sFAAsF;AAEtF,OAAO,EAAE,WAAW,EAAE,6BAAyB;AAG/C,OAAO,EAAE,YAAY,EAAE,gCAA4B;AAEnD,OAAO,EAAE,IAAI,EAAE,mCAA+B;AAE9C;;;;;;GAMG;AACH,MAAM,OAAO,QAAS,SAAQ,WAAW;IACvC;;;;;;;;;;OAUG;IACH,kBAAkB,CAChB,EAAU,EACV,SAA6D,EAAE,EAC/D,OAAwB;QAExB,MAAM,EAAE,cAAc,EAAE,UAAU,EAAE,GAAG,MAAM,IAAI,EAAE,CAAC;QACpD,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAA,gBAAgB,EAAE,aAAa,EAAE;YAC3D,GAAG,OAAO;YACV,OAAO,EAAE,YAAY,CAAC;gBACpB,EAAE,GAAG,CAAC,UAAU,IAAI,IAAI,CAAC,CAAC,CAAC,EAAE,cAAc,EAAE,UAAU,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC,EAAE;gBACxE,OAAO,EAAE,OAAO;aACjB,CAAC;SACH,CAAC,CAAC;IACL,CAAC;IAED;;;;;;;;;;OAUG;IACH,cAAc,CACZ,EAAU,EACV,SAAyD,EAAE,EAC3D,OAAwB;QAExB,MAAM,EAAE,cAAc,EAAE,UAAU,EAAE,GAAG,MAAM,IAAI,EAAE,CAAC;QACpD,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAA,gBAAgB,EAAE,EAAE,EAAE;YAChD,GAAG,OAAO;YACV,OAAO,EAAE,YAAY,CAAC;gBACpB,EAAE,GAAG,CAAC,UAAU,IAAI,IAAI,CAAC,CAAC,CAAC,EAAE,cAAc,EAAE,UAAU,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC,EAAE;gBACxE,OAAO,EAAE,OAAO;aACjB,CAAC;SACH,CAAC,CAAC;IACL,CAAC;IAED;;;;;;;;;;;;;;;;OAgBG;IACH,IAAI,CAAC,MAAyB,EAAE,OAAwB;QACtD,MAAM,EAAE,iBAAiB,EAAE,cAAc,EAAE,cAAc,EAAE,UAAU,EAAE,GAAG,IAAI,EAAE,GAAG,MAAM,CAAC;QAC1F,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,cAAc,EAAE;YACvC,IAAI;YACJ,GAAG,OAAO;YACV,OAAO,EAAE,YAAY,CAAC;gBACpB;oBACE,GAAG,CAAC,cAAc,IAAI,IAAI,CAAC,CAAC,CAAC,EAAE,iBAAiB,EAAE,cAAc,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC;oBAC/E,GAAG,CAAC,UAAU,IAAI,IAAI,CAAC,CAAC,CAAC,EAAE,cAAc,EAAE,UAAU,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC;iBACrE;gBACD,OAAO,EAAE,OAAO;aACjB,CAAC;SACH,CAAC,CAAC;IACL,CAAC;CACF"}
+{"version":3,"file":"messages.mjs","sourceRoot":"","sources":["../src/resources/messages.ts"],"names":[],"mappings":"AAAA,sFAAsF;AAEtF,OAAO,EAAE,WAAW,EAAE,6BAAyB;AAG/C,OAAO,EAAE,YAAY,EAAE,gCAA4B;AAEnD,OAAO,EAAE,IAAI,EAAE,mCAA+B;AAE9C;;;;;;;;GAQG;AACH,MAAM,OAAO,QAAS,SAAQ,WAAW;IACvC;;;;;;;;;;;;OAYG;IACH,kBAAkB,CAChB,EAAU,EACV,SAA6D,EAAE,EAC/D,OAAwB;QAExB,MAAM,EAAE,cAAc,EAAE,UAAU,EAAE,GAAG,MAAM,IAAI,EAAE,CAAC;QACpD,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAA,gBAAgB,EAAE,aAAa,EAAE;YAC3D,GAAG,OAAO;YACV,OAAO,EAAE,YAAY,CAAC;gBACpB,EAAE,GAAG,CAAC,UAAU,IAAI,IAAI,CAAC,CAAC,CAAC,EAAE,cAAc,EAAE,UAAU,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC,EAAE;gBACxE,OAAO,EAAE,OAAO;aACjB,CAAC;SACH,CAAC,CAAC;IACL,CAAC;IAED;;;;;;;;;;;;;;OAcG;IACH,cAAc,CACZ,EAAU,EACV,SAAyD,EAAE,EAC3D,OAAwB;QAExB,MAAM,EAAE,cAAc,EAAE,UAAU,EAAE,GAAG,MAAM,IAAI,EAAE,CAAC;QACpD,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAA,gBAAgB,EAAE,EAAE,EAAE;YAChD,GAAG,OAAO;YACV,OAAO,EAAE,YAAY,CAAC;gBACpB,EAAE,GAAG,CAAC,UAAU,IAAI,IAAI,CAAC,CAAC,CAAC,EAAE,cAAc,EAAE,UAAU,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC,EAAE;gBACxE,OAAO,EAAE,OAAO;aACjB,CAAC;SACH,CAAC,CAAC;IACL,CAAC;IAED;;;;;;;;;;;;;;;;;;;;;;;;;;OA0BG;IACH,IAAI,CAAC,MAAyB,EAAE,OAAwB;QACtD,MAAM,EAAE,iBAAiB,EAAE,cAAc,EAAE,cAAc,EAAE,UAAU,EAAE,GAAG,IAAI,EAAE,GAAG,MAAM,CAAC;QAC1F,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,cAAc,EAAE;YACvC,IAAI;YACJ,GAAG,OAAO;YACV,OAAO,EAAE,YAAY,CAAC;gBACpB;oBACE,GAAG,CAAC,cAAc,IAAI,IAAI,CAAC,CAAC,CAAC,EAAE,iBAAiB,EAAE,cAAc,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC;oBAC/E,GAAG,CAAC,UAAU,IAAI,IAAI,CAAC,CAAC,CAAC,EAAE,cAAc,EAAE,UAAU,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC;iBACrE;gBACD,OAAO,EAAE,OAAO;aACjB,CAAC;SACH,CAAC,CAAC;IACL,CAAC;CACF"}