rcs-js 2.0.12 → 2.0.13

package/dist/cjs/Client.js

@@ -53,8 +53,8 @@ class PinnacleClient {
         this._options = Object.assign(Object.assign({}, _options), { logging: core.logging.createLogger(_options === null || _options === void 0 ? void 0 : _options.logging), headers: (0, headers_js_1.mergeHeaders)({
                 "X-Fern-Language": "JavaScript",
                 "X-Fern-SDK-Name": "rcs-js",
-                "X-Fern-SDK-Version": "2.0.12",
-                "User-Agent": "rcs-js/2.0.12",
+                "X-Fern-SDK-Version": "2.0.13",
+                "User-Agent": "rcs-js/2.0.13",
                 "X-Fern-Runtime": core.RUNTIME.type,
                 "X-Fern-Runtime-Version": core.RUNTIME.version,
             }, _options === null || _options === void 0 ? void 0 : _options.headers) });

package/dist/cjs/api/resources/conversations/types/ConversationsListMessagesRequestStatus.d.ts

@@ -4,6 +4,7 @@ export declare const ConversationsListMessagesRequestStatus: {
     readonly SendFailed: "SEND_FAILED";
     readonly Delivered: "DELIVERED";
     readonly DeliveryFailed: "DELIVERY_FAILED";
+    readonly FallbackSent: "FALLBACK_SENT";
     readonly Received: "RECEIVED";
     readonly Read: "READ";
 };

package/dist/cjs/api/resources/conversations/types/ConversationsListMessagesRequestStatus.js

@@ -8,6 +8,7 @@ exports.ConversationsListMessagesRequestStatus = {
     SendFailed: "SEND_FAILED",
     Delivered: "DELIVERED",
     DeliveryFailed: "DELIVERY_FAILED",
+    FallbackSent: "FALLBACK_SENT",
     Received: "RECEIVED",
     Read: "READ",
 };

package/dist/cjs/api/resources/messages/resources/blast/client/Client.d.ts

@@ -96,6 +96,10 @@ export declare class Blast {
      *                 }],
      *             text: "Hello from Pinnacle RCS!"
      *         },
+     *         fallback: {
+     *             from: "+14155164736",
+     *             text: "Hello from Pinnacle! Reply LEARN to learn more."
+     *         },
      *         options: {
      *             transcode: true,
      *             validate: true

package/dist/cjs/api/resources/messages/resources/blast/client/Client.js

@@ -257,6 +257,10 @@ class Blast {
      *                 }],
      *             text: "Hello from Pinnacle RCS!"
      *         },
+     *         fallback: {
+     *             from: "+14155164736",
+     *             text: "Hello from Pinnacle! Reply LEARN to learn more."
+     *         },
      *         options: {
      *             transcode: true,
      *             validate: true

package/dist/cjs/api/resources/messages/resources/blast/client/requests/BlastRcs.d.ts

@@ -12,6 +12,10 @@ import type * as Pinnacle from "../../../../../../index.js";
  *                 }],
  *             text: "Hello from Pinnacle RCS!"
  *         },
+ *         fallback: {
+ *             from: "+14155164736",
+ *             text: "Hello from Pinnacle! Reply LEARN to learn more."
+ *         },
  *         options: {
  *             transcode: true,
  *             validate: true
@@ -30,6 +34,10 @@ import type * as Pinnacle from "../../../../../../index.js";
  *                 }],
  *             text: "Hello from Pinnacle RCS!"
  *         },
+ *         fallback: {
+ *             from: "+14155164736",
+ *             text: "Hello from Pinnacle! Reply LEARN to learn more."
+ *         },
  *         options: {
  *             transcode: true,
  *             validate: true
@@ -54,6 +62,7 @@ export interface BlastRcs {
      */
     senders: string[];
     message: Pinnacle.RcsValidateContent;
+    fallback?: Pinnacle.FallbackMessage;
     /** Configure how your RCS blast is sent and tracked. */
     options?: BlastRcs.Options;
 }

package/dist/cjs/api/types/BaseRichMessage.d.ts

@@ -2,6 +2,7 @@ import type * as Pinnacle from "../index.js";
 export interface BaseRichMessage {
     /** Your RCS agent ID which must be prefixed with 'agent_'. */
     from: string;
+    fallback?: Pinnacle.FallbackMessage;
     /** Configure how your RCS message is sent and tracked. */
     options?: Pinnacle.SendRichMessageOptions;
     /** Recipient's phone number in E.164 format. */

package/dist/cjs/api/types/FallbackMessage.d.ts

@@ -0,0 +1,32 @@
+/**
+ * SMS/MMS fallback message to send if the RCS message fails to deliver.
+ *
+ * When a recipient's device doesn't support RCS or the RCS message cannot be delivered, this fallback message will be sent as SMS or MMS instead. The fallback is sent from the specified phone number.
+ *
+ * > **Note:** At least one of `text` or `mediaUrls` must be provided. Fallback messages require a verified `from` phone number with SMS/MMS sending capabilities.
+ * > **Note:** You will not be charged for the fallback message, only the original RCS message will be charged.
+ */
+export interface FallbackMessage {
+    /**
+     * Phone number to send the fallback message from in E.164 format.
+     *
+     * Must be a verified phone number with SMS/MMS sending capabilities. Sandbox numbers cannot be used for fallbacks. The phone number must be connected an active toll-free or 10DLC campaign.
+     */
+    from: string;
+    /**
+     * Text content for the fallback message.
+     *
+     * At least one of `text` or `mediaUrls` must be provided.
+     *
+     * > **Note:** If text exceeds 3072 characters, the fallback will be sent as MMS instead of SMS.
+     */
+    text?: string;
+    /**
+     * Media file URLs to include in the fallback MMS message.
+     *
+     * See [supported media types](https://app.pinnacle.sh/supported-file-types?type=MMS).
+     *
+     * If provided, the fallback will be sent as MMS. Otherwise, it will be sent as SMS (unless text exceeds 3072 characters). At least one of `text` or `mediaUrls` must be provided.
+     */
+    mediaUrls?: string[];
+}

package/dist/cjs/api/types/FallbackMessage.js

@@ -0,0 +1,3 @@
+"use strict";
+// This file was auto-generated by Fern from our API Definition.
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/cjs/api/types/Message.d.ts

@@ -19,6 +19,14 @@ export interface Message {
      * Null indicates no errors.
      */
     error: string | null;
+    /**
+     * The fallback SMS/MMS message configuration for this RCS message.
+     *
+     * Null indicates no fallback was configured for this message. Only applicable for RCS messages.
+     *
+     * The original RCS message with have status `FALLBACK_SENT` when the fallback message was sent instead.
+     */
+    fallback?: Pinnacle.FallbackMessage | null;
     /** Unique identifier of the message. This identifier is a string that always begins with the prefix `msg_`, for example: `msg_1234567890`. */
     id: string;
     method: Pinnacle.MessageMethodEnum;

package/dist/cjs/api/types/MessageEvent.d.ts

@@ -20,6 +20,14 @@ export interface MessageEvent {
      */
     deliveredAt?: string | null;
     message: Pinnacle.MessageEventContent;
+    /**
+     * Details of the fallback SMS/MMS message that was sent instead of the original RCS message.
+     *
+     * This field is only present when the message `status` is `FALLBACK_SENT`, indicating the original RCS message could not be delivered and a fallback message was sent instead.
+     *
+     * Use this information to track which fallback messages were sent and their content.
+     */
+    fallbackMessage?: MessageEvent.FallbackMessage | null;
 }
 export declare namespace MessageEvent {
     /**
@@ -42,4 +50,36 @@ export declare namespace MessageEvent {
         readonly Outbound: "OUTBOUND";
     };
     type Direction = (typeof Direction)[keyof typeof Direction];
+    /**
+     * Details of the fallback SMS/MMS message that was sent instead of the original RCS message.
+     *
+     * This field is only present when the message `status` is `FALLBACK_SENT`, indicating the original RCS message could not be delivered and a fallback message was sent instead.
+     *
+     * Use this information to track which fallback messages were sent and their content.
+     */
+    interface FallbackMessage {
+        /**
+         * Unique identifier of the fallback message. This identifier is a string that always begins with the prefix `msg_`, for example: `msg_1234567890`. <br><br>
+         * To get the full message details, use the [GET /messages/{id}](/api-reference/messages/get) endpoint.
+         */
+        id: string;
+        /** Type of the fallback message sent. */
+        type: FallbackMessage.Type;
+        /** Phone number the fallback message was sent from in E.164 format. */
+        from: string;
+        /** Recipient's phone number in E.164 format. */
+        to: string;
+        /** Text content of the fallback message. */
+        text?: string;
+        /** Media URLs included in the fallback MMS message. Empty array for SMS fallbacks. */
+        mediaUrls?: string[];
+    }
+    namespace FallbackMessage {
+        /** Type of the fallback message sent. */
+        const Type: {
+            readonly Sms: "SMS";
+            readonly Mms: "MMS";
+        };
+        type Type = (typeof Type)[keyof typeof Type];
+    }
 }

package/dist/cjs/api/types/MessageEvent.js

@@ -9,4 +9,12 @@ var MessageEvent;
         Inbound: "INBOUND",
         Outbound: "OUTBOUND",
     };
+    let FallbackMessage;
+    (function (FallbackMessage) {
+        /** Type of the fallback message sent. */
+        FallbackMessage.Type = {
+            Sms: "SMS",
+            Mms: "MMS",
+        };
+    })(FallbackMessage = MessageEvent.FallbackMessage || (MessageEvent.FallbackMessage = {}));
 })(MessageEvent || (exports.MessageEvent = MessageEvent = {}));

package/dist/cjs/api/types/MessageEventContent.d.ts

@@ -5,22 +5,45 @@ import type * as Pinnacle from "../index.js";
 export type MessageEventContent = 
 /**
  * SMS message containing plain text only. Has type `SMS`. */
-Pinnacle.MessageEventSmsContent
+Pinnacle.MessageEventContent.Sms
 /**
  * MMS message with text and/or media files from a phone number. Has type `MMS`. */
- | Pinnacle.MessageEventMmsContent
+ | Pinnacle.MessageEventContent.Mms
 /**
  * RCS message containing longer text content with optional quick reply buttons. Has type `RCS_TEXT`. */
- | Pinnacle.MessageEventRcsTextContent
+ | Pinnacle.MessageEventContent.RcsText
 /**
  * RCS message containing media file with optional quick reply buttons. Has type `RCS_MEDIA`. */
- | Pinnacle.MessageEventRcsMediaContent
+ | Pinnacle.MessageEventContent.RcsMedia
 /**
  * RCS message containing cards with titles, subtitles, and buttons. Has type `RCS_CARDS`. */
- | Pinnacle.MessageEventRcsCardsContent
+ | Pinnacle.MessageEventContent.RcsCards
 /**
  * RCS button click data. Sent when user clicks any button. Has type `RCS_BUTTON_DATA`. */
- | Pinnacle.MessageEventRcsButtonData
+ | Pinnacle.MessageEventContent.RcsButtonData
 /**
  * RCS location sharing data. Sent when user shares their location via a `requestUserLocation` button. Has type `RCS_LOCATION_DATA`. */
- | Pinnacle.MessageEventRcsLocationData;
+ | Pinnacle.MessageEventContent.RcsLocationData;
+export declare namespace MessageEventContent {
+    interface Sms extends Pinnacle.MessageEventSmsContent {
+        type: "SMS";
+    }
+    interface Mms extends Pinnacle.MessageEventMmsContent {
+        type: "MMS";
+    }
+    interface RcsText extends Pinnacle.MessageEventRcsTextContent {
+        type: "RCS_TEXT";
+    }
+    interface RcsMedia extends Pinnacle.MessageEventRcsMediaContent {
+        type: "RCS_MEDIA";
+    }
+    interface RcsCards extends Pinnacle.MessageEventRcsCardsContent {
+        type: "RCS_CARDS";
+    }
+    interface RcsButtonData extends Pinnacle.MessageEventRcsButtonData {
+        type: "RCS_BUTTON_DATA";
+    }
+    interface RcsLocationData extends Pinnacle.MessageEventRcsLocationData {
+        type: "RCS_LOCATION_DATA";
+    }
+}

package/dist/cjs/api/types/MessageEventMmsContent.d.ts

@@ -2,8 +2,6 @@
  * MMS message with text and/or media files from a phone number.
  */
 export interface MessageEventMmsContent {
-    /** Message type identifier. */
-    type: "MMS";
     /**
      * Unique identifier of the message. This identifier is a string that always begins with the prefix `msg_`, for example: `msg_1234567890`. <br><br>
      * To get the message details, use the [GET /messages/{id}](/api-reference/messages/get) endpoint.

package/dist/cjs/api/types/MessageEventRcsButtonData.d.ts

@@ -4,12 +4,59 @@ import type * as Pinnacle from "../index.js";
  *
  * This event contains information about which button was clicked, how many times it's been clicked, and any payload or metadata attached to the button. Use this data to handle user interactions with your RCS messages.
  */
-export interface MessageEventRcsButtonData extends Pinnacle.ButtonClickedData {
-    /** Message type identifier. */
-    type: "RCS_BUTTON_DATA";
+export interface MessageEventRcsButtonData {
     /**
      * Unique identifier of the message. This identifier is a string that always begins with the prefix `msg_`, for example: `msg_1234567890`. <br><br>
      * To get the message details, use the [GET /messages/{id}](/api-reference/messages/get) endpoint.
      */
     id: string;
+    /** Information about the button that was clicked. */
+    button: MessageEventRcsButtonData.Button;
+    /** ID of the message this button was sent in, or null if not available. To get the message details, use the [GET /messages/{id}](/api-reference/messages/get) endpoint. */
+    messageId: string | null;
+}
+export declare namespace MessageEventRcsButtonData {
+    /**
+     * Information about the button that was clicked.
+     */
+    interface Button {
+        /**
+         * Type of button clicked.
+         * - `CARD` for card buttons,
+         * - `QUICK_REPLY` for quick replies.
+         * - `null` if we cannot determine the button type. This is a rare edge case and is mainly here for backward compatibility.
+         */
+        type?: Button.Type | null;
+        /** Raw button data. Contains the entire button that was clicked by the user. In rare cases where we cannot determine the exact button, this will return only the button title. */
+        raw: Button.Raw;
+        /** Extracted payload from the button's `payload` field, if provided. Provides quick access to any payload that was attached to the button. */
+        payload?: string | null;
+        /** Additional metadata attached to the button's `metadata` field, if provided. */
+        metadata?: string | null;
+        /** Number of times the button has been clicked. */
+        clicks: number;
+    }
+    namespace Button {
+        /**
+         * Type of button clicked.
+         * - `CARD` for card buttons,
+         * - `QUICK_REPLY` for quick replies.
+         * - `null` if we cannot determine the button type. This is a rare edge case and is mainly here for backward compatibility.
+         */
+        const Type: {
+            readonly Card: "CARD";
+            readonly QuickReply: "QUICK_REPLY";
+        };
+        type Type = (typeof Type)[keyof typeof Type];
+        /**
+         * Raw button data. Contains the entire button that was clicked by the user. In rare cases where we cannot determine the exact button, this will return only the button title.
+         */
+        type Raw = 
+        /**
+         * Full button object if we can determine the exact button. */
+        Pinnacle.RichButton
+        /**
+         * Button title if we cannot determine the exact button. This is a rare edge case and is mainly here for backward compatibility. */
+         | string;
+    }
 }

package/dist/cjs/api/types/MessageEventRcsButtonData.js

@@ -1,3 +1,20 @@
 "use strict";
 // This file was auto-generated by Fern from our API Definition.
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.MessageEventRcsButtonData = void 0;
+var MessageEventRcsButtonData;
+(function (MessageEventRcsButtonData) {
+    let Button;
+    (function (Button) {
+        /**
+         * Type of button clicked.
+         * - `CARD` for card buttons,
+         * - `QUICK_REPLY` for quick replies.
+         * - `null` if we cannot determine the button type. This is a rare edge case and is mainly here for backward compatibility.
+         */
+        Button.Type = {
+            Card: "CARD",
+            QuickReply: "QUICK_REPLY",
+        };
+    })(Button = MessageEventRcsButtonData.Button || (MessageEventRcsButtonData.Button = {}));
+})(MessageEventRcsButtonData || (exports.MessageEventRcsButtonData = MessageEventRcsButtonData = {}));

package/dist/cjs/api/types/MessageEventRcsCardsContent.d.ts

@@ -5,8 +5,6 @@ import type * as Pinnacle from "../index.js";
  * See [supported file types](https://app.pinnacle.sh/supported-file-types?type=RCS-CARD).
  */
 export interface MessageEventRcsCardsContent {
-    /** Message type identifier. */
-    type: "RCS_CARDS";
     /**
      * Unique identifier of the message. This identifier is a string that always begins with the prefix `msg_`, for example: `msg_1234567890`. <br><br>
      * To get the message details, use the [GET /messages/{id}](/api-reference/messages/get) endpoint.

package/dist/cjs/api/types/MessageEventRcsLocationData.d.ts

@@ -1,15 +1,31 @@
-import type * as Pinnacle from "../index.js";
 /**
  * Location sharing event data received when a user responds to a `requestUserLocation` button and shares their current location.
  *
  * This event contains the geographic coordinates (latitude/longitude) and human-readable address of the location the user chose to share. Use this data to process location-based requests or provide location-specific services.
  */
-export interface MessageEventRcsLocationData extends Pinnacle.LocationShareAction {
-    /** Message type identifier. */
-    type: "RCS_LOCATION_DATA";
+export interface MessageEventRcsLocationData {
     /**
      * Unique identifier of the message. This identifier is a string that always begins with the prefix `msg_`, for example: `msg_1234567890`. <br><br>
      * To get the message details, use the [GET /messages/{id}](/api-reference/messages/get) endpoint.
      */
     id: string;
+    /** Location data shared by the user. */
+    data: MessageEventRcsLocationData.Data;
+    /** ID of the message this button was sent in, or null if not available. To get the message details, use the [GET /messages/{id}](/api-reference/messages/get) endpoint. */
+    messageId?: string | null;
+}
+export declare namespace MessageEventRcsLocationData {
+    /**
+     * Location data shared by the user.
+     */
+    interface Data {
+        /** Address corresponding to the shared location. */
+        address: string;
+        /** Latitude of the shared location. */
+        latitude: number;
+        /** Longitude of the shared location. */
+        longitude: number;
+        /** Text message sent with the location. */
+        text?: string;
+    }
 }

package/dist/cjs/api/types/MessageEventRcsMediaContent.d.ts

@@ -5,8 +5,6 @@ import type * as Pinnacle from "../index.js";
  * See [supported file types](https://app.pinnacle.sh/supported-file-types?type=RCS-MEDIA).
  */
 export interface MessageEventRcsMediaContent {
-    /** Message type identifier. */
-    type: "RCS_MEDIA";
     /**
      * Unique identifier of the message. This identifier is a string that always begins with the prefix `msg_`, for example: `msg_1234567890`. <br><br>
      * To get the message details, use the [GET /messages/{id}](/api-reference/messages/get) endpoint.

package/dist/cjs/api/types/MessageEventRcsTextContent.d.ts

@@ -3,8 +3,6 @@ import type * as Pinnacle from "../index.js";
  * RCS message containing longer text content with optional quick reply buttons.
  */
 export interface MessageEventRcsTextContent {
-    /** Message type identifier. */
-    type: "RCS_TEXT";
     /**
      * Unique identifier of the message. This identifier is a string that always begins with the prefix `msg_`, for example: `msg_1234567890`. <br><br>
      * To get the message details, use the [GET /messages/{id}](/api-reference/messages/get) endpoint.

package/dist/cjs/api/types/MessageEventSmsContent.d.ts

@@ -2,8 +2,6 @@
  * SMS message containing plain text only.
  */
 export interface MessageEventSmsContent {
-    /** Message type identifier. */
-    type: "SMS";
     /**
      * Unique identifier of the message. This identifier is a string that always begins with the prefix `msg_`, for example: `msg_1234567890`. <br><br>
      * To get the message details, use the [GET /messages/{id}](/api-reference/messages/get) endpoint.

package/dist/cjs/api/types/MessageStatusEnum.d.ts

@@ -8,5 +8,6 @@ export declare const MessageStatusEnum: {
     readonly DeliveryFailed: "DELIVERY_FAILED";
     readonly Received: "RECEIVED";
     readonly Read: "READ";
+    readonly FallbackSent: "FALLBACK_SENT";
 };
 export type MessageStatusEnum = (typeof MessageStatusEnum)[keyof typeof MessageStatusEnum];

package/dist/cjs/api/types/MessageStatusEnum.js

@@ -12,4 +12,5 @@ exports.MessageStatusEnum = {
     DeliveryFailed: "DELIVERY_FAILED",
     Received: "RECEIVED",
     Read: "READ",
+    FallbackSent: "FALLBACK_SENT",
 };

package/dist/cjs/api/types/RichCardsMessage.d.ts

@@ -3,6 +3,7 @@ export interface RichCardsMessage extends Pinnacle.RichCards {
     options?: RichCardsMessage.Options;
     /** Your RCS agent ID which must be prefixed with 'agent_'. */
     from: string;
+    fallback?: Pinnacle.FallbackMessage;
     /** Recipient's phone number in E.164 format. */
     to: string;
 }

package/dist/cjs/api/types/index.d.ts

@@ -40,6 +40,7 @@ export * from "./Error_.js";
 export * from "./ExtendedBrand.js";
 export * from "./ExtendedBrandWithVetting.js";
 export * from "./ExtendedRcsCampaign.js";
+export * from "./FallbackMessage.js";
 export * from "./GetConversationParams.js";
 export * from "./LinkClickEvent.js";
 export * from "./LocationShareAction.js";

package/dist/cjs/api/types/index.js

@@ -56,6 +56,7 @@ __exportStar(require("./Error_.js"), exports);
 __exportStar(require("./ExtendedBrand.js"), exports);
 __exportStar(require("./ExtendedBrandWithVetting.js"), exports);
 __exportStar(require("./ExtendedRcsCampaign.js"), exports);
+__exportStar(require("./FallbackMessage.js"), exports);
 __exportStar(require("./GetConversationParams.js"), exports);
 __exportStar(require("./LinkClickEvent.js"), exports);
 __exportStar(require("./LocationShareAction.js"), exports);

package/dist/cjs/version.d.ts

@@ -1 +1 @@
-export declare const SDK_VERSION = "2.0.12";
+export declare const SDK_VERSION = "2.0.13";

package/dist/cjs/version.js

@@ -1,4 +1,4 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.SDK_VERSION = void 0;
-exports.SDK_VERSION = "2.0.12";
+exports.SDK_VERSION = "2.0.13";

package/dist/esm/Client.mjs

@@ -17,8 +17,8 @@ export class PinnacleClient {
         this._options = Object.assign(Object.assign({}, _options), { logging: core.logging.createLogger(_options === null || _options === void 0 ? void 0 : _options.logging), headers: mergeHeaders({
                 "X-Fern-Language": "JavaScript",
                 "X-Fern-SDK-Name": "rcs-js",
-                "X-Fern-SDK-Version": "2.0.12",
-                "User-Agent": "rcs-js/2.0.12",
+                "X-Fern-SDK-Version": "2.0.13",
+                "User-Agent": "rcs-js/2.0.13",
                 "X-Fern-Runtime": core.RUNTIME.type,
                 "X-Fern-Runtime-Version": core.RUNTIME.version,
             }, _options === null || _options === void 0 ? void 0 : _options.headers) });

package/dist/esm/api/resources/conversations/types/ConversationsListMessagesRequestStatus.d.mts

@@ -4,6 +4,7 @@ export declare const ConversationsListMessagesRequestStatus: {
     readonly SendFailed: "SEND_FAILED";
     readonly Delivered: "DELIVERED";
     readonly DeliveryFailed: "DELIVERY_FAILED";
+    readonly FallbackSent: "FALLBACK_SENT";
     readonly Received: "RECEIVED";
     readonly Read: "READ";
 };

package/dist/esm/api/resources/conversations/types/ConversationsListMessagesRequestStatus.mjs

@@ -5,6 +5,7 @@ export const ConversationsListMessagesRequestStatus = {
     SendFailed: "SEND_FAILED",
     Delivered: "DELIVERED",
     DeliveryFailed: "DELIVERY_FAILED",
+    FallbackSent: "FALLBACK_SENT",
     Received: "RECEIVED",
     Read: "READ",
 };

package/dist/esm/api/resources/messages/resources/blast/client/Client.d.mts

@@ -96,6 +96,10 @@ export declare class Blast {
      *                 }],
      *             text: "Hello from Pinnacle RCS!"
      *         },
+     *         fallback: {
+     *             from: "+14155164736",
+     *             text: "Hello from Pinnacle! Reply LEARN to learn more."
+     *         },
      *         options: {
      *             transcode: true,
      *             validate: true

package/dist/esm/api/resources/messages/resources/blast/client/Client.mjs

@@ -221,6 +221,10 @@ export class Blast {
      *                 }],
      *             text: "Hello from Pinnacle RCS!"
      *         },
+     *         fallback: {
+     *             from: "+14155164736",
+     *             text: "Hello from Pinnacle! Reply LEARN to learn more."
+     *         },
      *         options: {
      *             transcode: true,
      *             validate: true

package/dist/esm/api/resources/messages/resources/blast/client/requests/BlastRcs.d.mts

@@ -12,6 +12,10 @@ import type * as Pinnacle from "../../../../../../index.mjs";
  *                 }],
  *             text: "Hello from Pinnacle RCS!"
  *         },
+ *         fallback: {
+ *             from: "+14155164736",
+ *             text: "Hello from Pinnacle! Reply LEARN to learn more."
+ *         },
  *         options: {
  *             transcode: true,
  *             validate: true
@@ -30,6 +34,10 @@ import type * as Pinnacle from "../../../../../../index.mjs";
  *                 }],
  *             text: "Hello from Pinnacle RCS!"
  *         },
+ *         fallback: {
+ *             from: "+14155164736",
+ *             text: "Hello from Pinnacle! Reply LEARN to learn more."
+ *         },
  *         options: {
  *             transcode: true,
  *             validate: true
@@ -54,6 +62,7 @@ export interface BlastRcs {
      */
     senders: string[];
     message: Pinnacle.RcsValidateContent;
+    fallback?: Pinnacle.FallbackMessage;
     /** Configure how your RCS blast is sent and tracked. */
     options?: BlastRcs.Options;
 }

package/dist/esm/api/types/BaseRichMessage.d.mts

@@ -2,6 +2,7 @@ import type * as Pinnacle from "../index.mjs";
 export interface BaseRichMessage {
     /** Your RCS agent ID which must be prefixed with 'agent_'. */
     from: string;
+    fallback?: Pinnacle.FallbackMessage;
     /** Configure how your RCS message is sent and tracked. */
     options?: Pinnacle.SendRichMessageOptions;
     /** Recipient's phone number in E.164 format. */

package/dist/esm/api/types/FallbackMessage.d.mts

@@ -0,0 +1,32 @@
+/**
+ * SMS/MMS fallback message to send if the RCS message fails to deliver.
+ *
+ * When a recipient's device doesn't support RCS or the RCS message cannot be delivered, this fallback message will be sent as SMS or MMS instead. The fallback is sent from the specified phone number.
+ *
+ * > **Note:** At least one of `text` or `mediaUrls` must be provided. Fallback messages require a verified `from` phone number with SMS/MMS sending capabilities.
+ * > **Note:** You will not be charged for the fallback message, only the original RCS message will be charged.
+ */
+export interface FallbackMessage {
+    /**
+     * Phone number to send the fallback message from in E.164 format.
+     *
+     * Must be a verified phone number with SMS/MMS sending capabilities. Sandbox numbers cannot be used for fallbacks. The phone number must be connected an active toll-free or 10DLC campaign.
+     */
+    from: string;
+    /**
+     * Text content for the fallback message.
+     *
+     * At least one of `text` or `mediaUrls` must be provided.
+     *
+     * > **Note:** If text exceeds 3072 characters, the fallback will be sent as MMS instead of SMS.
+     */
+    text?: string;
+    /**
+     * Media file URLs to include in the fallback MMS message.
+     *
+     * See [supported media types](https://app.pinnacle.sh/supported-file-types?type=MMS).
+     *
+     * If provided, the fallback will be sent as MMS. Otherwise, it will be sent as SMS (unless text exceeds 3072 characters). At least one of `text` or `mediaUrls` must be provided.
+     */
+    mediaUrls?: string[];
+}

package/dist/esm/api/types/FallbackMessage.mjs

@@ -0,0 +1,2 @@
+// This file was auto-generated by Fern from our API Definition.
+export {};

package/dist/esm/api/types/Message.d.mts

@@ -19,6 +19,14 @@ export interface Message {
      * Null indicates no errors.
      */
     error: string | null;
+    /**
+     * The fallback SMS/MMS message configuration for this RCS message.
+     *
+     * Null indicates no fallback was configured for this message. Only applicable for RCS messages.
+     *
+     * The original RCS message with have status `FALLBACK_SENT` when the fallback message was sent instead.
+     */
+    fallback?: Pinnacle.FallbackMessage | null;
     /** Unique identifier of the message. This identifier is a string that always begins with the prefix `msg_`, for example: `msg_1234567890`. */
     id: string;
     method: Pinnacle.MessageMethodEnum;

package/dist/esm/api/types/MessageEvent.d.mts

@@ -20,6 +20,14 @@ export interface MessageEvent {
      */
     deliveredAt?: string | null;
     message: Pinnacle.MessageEventContent;
+    /**
+     * Details of the fallback SMS/MMS message that was sent instead of the original RCS message.
+     *
+     * This field is only present when the message `status` is `FALLBACK_SENT`, indicating the original RCS message could not be delivered and a fallback message was sent instead.
+     *
+     * Use this information to track which fallback messages were sent and their content.
+     */
+    fallbackMessage?: MessageEvent.FallbackMessage | null;
 }
 export declare namespace MessageEvent {
     /**
@@ -42,4 +50,36 @@ export declare namespace MessageEvent {
         readonly Outbound: "OUTBOUND";
     };
     type Direction = (typeof Direction)[keyof typeof Direction];
+    /**
+     * Details of the fallback SMS/MMS message that was sent instead of the original RCS message.
+     *
+     * This field is only present when the message `status` is `FALLBACK_SENT`, indicating the original RCS message could not be delivered and a fallback message was sent instead.
+     *
+     * Use this information to track which fallback messages were sent and their content.
+     */
+    interface FallbackMessage {
+        /**
+         * Unique identifier of the fallback message. This identifier is a string that always begins with the prefix `msg_`, for example: `msg_1234567890`. <br><br>
+         * To get the full message details, use the [GET /messages/{id}](/api-reference/messages/get) endpoint.
+         */
+        id: string;
+        /** Type of the fallback message sent. */
+        type: FallbackMessage.Type;
+        /** Phone number the fallback message was sent from in E.164 format. */
+        from: string;
+        /** Recipient's phone number in E.164 format. */
+        to: string;
+        /** Text content of the fallback message. */
+        text?: string;
+        /** Media URLs included in the fallback MMS message. Empty array for SMS fallbacks. */
+        mediaUrls?: string[];
+    }
+    namespace FallbackMessage {
+        /** Type of the fallback message sent. */
+        const Type: {
+            readonly Sms: "SMS";
+            readonly Mms: "MMS";
+        };
+        type Type = (typeof Type)[keyof typeof Type];
+    }
 }

package/dist/esm/api/types/MessageEvent.mjs

@@ -6,4 +6,12 @@ export var MessageEvent;
         Inbound: "INBOUND",
         Outbound: "OUTBOUND",
     };
+    let FallbackMessage;
+    (function (FallbackMessage) {
+        /** Type of the fallback message sent. */
+        FallbackMessage.Type = {
+            Sms: "SMS",
+            Mms: "MMS",
+        };
+    })(FallbackMessage = MessageEvent.FallbackMessage || (MessageEvent.FallbackMessage = {}));
 })(MessageEvent || (MessageEvent = {}));

package/dist/esm/api/types/MessageEventContent.d.mts

@@ -5,22 +5,45 @@ import type * as Pinnacle from "../index.mjs";
 export type MessageEventContent = 
 /**
  * SMS message containing plain text only. Has type `SMS`. */
-Pinnacle.MessageEventSmsContent
+Pinnacle.MessageEventContent.Sms
 /**
  * MMS message with text and/or media files from a phone number. Has type `MMS`. */
- | Pinnacle.MessageEventMmsContent
+ | Pinnacle.MessageEventContent.Mms
 /**
  * RCS message containing longer text content with optional quick reply buttons. Has type `RCS_TEXT`. */
- | Pinnacle.MessageEventRcsTextContent
+ | Pinnacle.MessageEventContent.RcsText
 /**
  * RCS message containing media file with optional quick reply buttons. Has type `RCS_MEDIA`. */
- | Pinnacle.MessageEventRcsMediaContent
+ | Pinnacle.MessageEventContent.RcsMedia
 /**
  * RCS message containing cards with titles, subtitles, and buttons. Has type `RCS_CARDS`. */
- | Pinnacle.MessageEventRcsCardsContent
+ | Pinnacle.MessageEventContent.RcsCards
 /**
  * RCS button click data. Sent when user clicks any button. Has type `RCS_BUTTON_DATA`. */
- | Pinnacle.MessageEventRcsButtonData
+ | Pinnacle.MessageEventContent.RcsButtonData
 /**
  * RCS location sharing data. Sent when user shares their location via a `requestUserLocation` button. Has type `RCS_LOCATION_DATA`. */
- | Pinnacle.MessageEventRcsLocationData;
+ | Pinnacle.MessageEventContent.RcsLocationData;
+export declare namespace MessageEventContent {
+    interface Sms extends Pinnacle.MessageEventSmsContent {
+        type: "SMS";
+    }
+    interface Mms extends Pinnacle.MessageEventMmsContent {
+        type: "MMS";
+    }
+    interface RcsText extends Pinnacle.MessageEventRcsTextContent {
+        type: "RCS_TEXT";
+    }
+    interface RcsMedia extends Pinnacle.MessageEventRcsMediaContent {
+        type: "RCS_MEDIA";
+    }
+    interface RcsCards extends Pinnacle.MessageEventRcsCardsContent {
+        type: "RCS_CARDS";
+    }
+    interface RcsButtonData extends Pinnacle.MessageEventRcsButtonData {
+        type: "RCS_BUTTON_DATA";
+    }
+    interface RcsLocationData extends Pinnacle.MessageEventRcsLocationData {
+        type: "RCS_LOCATION_DATA";
+    }
+}

package/dist/esm/api/types/MessageEventMmsContent.d.mts

@@ -2,8 +2,6 @@
  * MMS message with text and/or media files from a phone number.
  */
 export interface MessageEventMmsContent {
-    /** Message type identifier. */
-    type: "MMS";
     /**
      * Unique identifier of the message. This identifier is a string that always begins with the prefix `msg_`, for example: `msg_1234567890`. <br><br>
      * To get the message details, use the [GET /messages/{id}](/api-reference/messages/get) endpoint.

package/dist/esm/api/types/MessageEventRcsButtonData.d.mts

@@ -4,12 +4,59 @@ import type * as Pinnacle from "../index.mjs";
  *
  * This event contains information about which button was clicked, how many times it's been clicked, and any payload or metadata attached to the button. Use this data to handle user interactions with your RCS messages.
  */
-export interface MessageEventRcsButtonData extends Pinnacle.ButtonClickedData {
-    /** Message type identifier. */
-    type: "RCS_BUTTON_DATA";
+export interface MessageEventRcsButtonData {
     /**
      * Unique identifier of the message. This identifier is a string that always begins with the prefix `msg_`, for example: `msg_1234567890`. <br><br>
      * To get the message details, use the [GET /messages/{id}](/api-reference/messages/get) endpoint.
      */
     id: string;
+    /** Information about the button that was clicked. */
+    button: MessageEventRcsButtonData.Button;
+    /** ID of the message this button was sent in, or null if not available. To get the message details, use the [GET /messages/{id}](/api-reference/messages/get) endpoint. */
+    messageId: string | null;
+}
+export declare namespace MessageEventRcsButtonData {
+    /**
+     * Information about the button that was clicked.
+     */
+    interface Button {
+        /**
+         * Type of button clicked.
+         * - `CARD` for card buttons,
+         * - `QUICK_REPLY` for quick replies.
+         * - `null` if we cannot determine the button type. This is a rare edge case and is mainly here for backward compatibility.
+         */
+        type?: Button.Type | null;
+        /** Raw button data. Contains the entire button that was clicked by the user. In rare cases where we cannot determine the exact button, this will return only the button title. */
+        raw: Button.Raw;
+        /** Extracted payload from the button's `payload` field, if provided. Provides quick access to any payload that was attached to the button. */
+        payload?: string | null;
+        /** Additional metadata attached to the button's `metadata` field, if provided. */
+        metadata?: string | null;
+        /** Number of times the button has been clicked. */
+        clicks: number;
+    }
+    namespace Button {
+        /**
+         * Type of button clicked.
+         * - `CARD` for card buttons,
+         * - `QUICK_REPLY` for quick replies.
+         * - `null` if we cannot determine the button type. This is a rare edge case and is mainly here for backward compatibility.
+         */
+        const Type: {
+            readonly Card: "CARD";
+            readonly QuickReply: "QUICK_REPLY";
+        };
+        type Type = (typeof Type)[keyof typeof Type];
+        /**
+         * Raw button data. Contains the entire button that was clicked by the user. In rare cases where we cannot determine the exact button, this will return only the button title.
+         */
+        type Raw = 
+        /**
+         * Full button object if we can determine the exact button. */
+        Pinnacle.RichButton
+        /**
+         * Button title if we cannot determine the exact button. This is a rare edge case and is mainly here for backward compatibility. */
+         | string;
+    }
 }

package/dist/esm/api/types/MessageEventRcsButtonData.mjs

@@ -1,2 +1,17 @@
 // This file was auto-generated by Fern from our API Definition.
-export {};
+export var MessageEventRcsButtonData;
+(function (MessageEventRcsButtonData) {
+    let Button;
+    (function (Button) {
+        /**
+         * Type of button clicked.
+         * - `CARD` for card buttons,
+         * - `QUICK_REPLY` for quick replies.
+         * - `null` if we cannot determine the button type. This is a rare edge case and is mainly here for backward compatibility.
+         */
+        Button.Type = {
+            Card: "CARD",
+            QuickReply: "QUICK_REPLY",
+        };
+    })(Button = MessageEventRcsButtonData.Button || (MessageEventRcsButtonData.Button = {}));
+})(MessageEventRcsButtonData || (MessageEventRcsButtonData = {}));

package/dist/esm/api/types/MessageEventRcsCardsContent.d.mts

@@ -5,8 +5,6 @@ import type * as Pinnacle from "../index.mjs";
  * See [supported file types](https://app.pinnacle.sh/supported-file-types?type=RCS-CARD).
  */
 export interface MessageEventRcsCardsContent {
-    /** Message type identifier. */
-    type: "RCS_CARDS";
     /**
      * Unique identifier of the message. This identifier is a string that always begins with the prefix `msg_`, for example: `msg_1234567890`. <br><br>
      * To get the message details, use the [GET /messages/{id}](/api-reference/messages/get) endpoint.

package/dist/esm/api/types/MessageEventRcsLocationData.d.mts

@@ -1,15 +1,31 @@
-import type * as Pinnacle from "../index.mjs";
 /**
  * Location sharing event data received when a user responds to a `requestUserLocation` button and shares their current location.
  *
  * This event contains the geographic coordinates (latitude/longitude) and human-readable address of the location the user chose to share. Use this data to process location-based requests or provide location-specific services.
  */
-export interface MessageEventRcsLocationData extends Pinnacle.LocationShareAction {
-    /** Message type identifier. */
-    type: "RCS_LOCATION_DATA";
+export interface MessageEventRcsLocationData {
     /**
      * Unique identifier of the message. This identifier is a string that always begins with the prefix `msg_`, for example: `msg_1234567890`. <br><br>
      * To get the message details, use the [GET /messages/{id}](/api-reference/messages/get) endpoint.
      */
     id: string;
+    /** Location data shared by the user. */
+    data: MessageEventRcsLocationData.Data;
+    /** ID of the message this button was sent in, or null if not available. To get the message details, use the [GET /messages/{id}](/api-reference/messages/get) endpoint. */
+    messageId?: string | null;
+}
+export declare namespace MessageEventRcsLocationData {
+    /**
+     * Location data shared by the user.
+     */
+    interface Data {
+        /** Address corresponding to the shared location. */
+        address: string;
+        /** Latitude of the shared location. */
+        latitude: number;
+        /** Longitude of the shared location. */
+        longitude: number;
+        /** Text message sent with the location. */
+        text?: string;
+    }
 }

package/dist/esm/api/types/MessageEventRcsMediaContent.d.mts

@@ -5,8 +5,6 @@ import type * as Pinnacle from "../index.mjs";
  * See [supported file types](https://app.pinnacle.sh/supported-file-types?type=RCS-MEDIA).
  */
 export interface MessageEventRcsMediaContent {
-    /** Message type identifier. */
-    type: "RCS_MEDIA";
     /**
      * Unique identifier of the message. This identifier is a string that always begins with the prefix `msg_`, for example: `msg_1234567890`. <br><br>
      * To get the message details, use the [GET /messages/{id}](/api-reference/messages/get) endpoint.

package/dist/esm/api/types/MessageEventRcsTextContent.d.mts

@@ -3,8 +3,6 @@ import type * as Pinnacle from "../index.mjs";
  * RCS message containing longer text content with optional quick reply buttons.
  */
 export interface MessageEventRcsTextContent {
-    /** Message type identifier. */
-    type: "RCS_TEXT";
     /**
      * Unique identifier of the message. This identifier is a string that always begins with the prefix `msg_`, for example: `msg_1234567890`. <br><br>
      * To get the message details, use the [GET /messages/{id}](/api-reference/messages/get) endpoint.

package/dist/esm/api/types/MessageEventSmsContent.d.mts

@@ -2,8 +2,6 @@
  * SMS message containing plain text only.
  */
 export interface MessageEventSmsContent {
-    /** Message type identifier. */
-    type: "SMS";
     /**
      * Unique identifier of the message. This identifier is a string that always begins with the prefix `msg_`, for example: `msg_1234567890`. <br><br>
      * To get the message details, use the [GET /messages/{id}](/api-reference/messages/get) endpoint.

package/dist/esm/api/types/MessageStatusEnum.d.mts

@@ -8,5 +8,6 @@ export declare const MessageStatusEnum: {
     readonly DeliveryFailed: "DELIVERY_FAILED";
     readonly Received: "RECEIVED";
     readonly Read: "READ";
+    readonly FallbackSent: "FALLBACK_SENT";
 };
 export type MessageStatusEnum = (typeof MessageStatusEnum)[keyof typeof MessageStatusEnum];

package/dist/esm/api/types/MessageStatusEnum.mjs

@@ -9,4 +9,5 @@ export const MessageStatusEnum = {
     DeliveryFailed: "DELIVERY_FAILED",
     Received: "RECEIVED",
     Read: "READ",
+    FallbackSent: "FALLBACK_SENT",
 };

package/dist/esm/api/types/RichCardsMessage.d.mts

@@ -3,6 +3,7 @@ export interface RichCardsMessage extends Pinnacle.RichCards {
     options?: RichCardsMessage.Options;
     /** Your RCS agent ID which must be prefixed with 'agent_'. */
     from: string;
+    fallback?: Pinnacle.FallbackMessage;
     /** Recipient's phone number in E.164 format. */
     to: string;
 }

package/dist/esm/api/types/index.d.mts

@@ -40,6 +40,7 @@ export * from "./Error_.mjs";
 export * from "./ExtendedBrand.mjs";
 export * from "./ExtendedBrandWithVetting.mjs";
 export * from "./ExtendedRcsCampaign.mjs";
+export * from "./FallbackMessage.mjs";
 export * from "./GetConversationParams.mjs";
 export * from "./LinkClickEvent.mjs";
 export * from "./LocationShareAction.mjs";

package/dist/esm/api/types/index.mjs

@@ -40,6 +40,7 @@ export * from "./Error_.mjs";
 export * from "./ExtendedBrand.mjs";
 export * from "./ExtendedBrandWithVetting.mjs";
 export * from "./ExtendedRcsCampaign.mjs";
+export * from "./FallbackMessage.mjs";
 export * from "./GetConversationParams.mjs";
 export * from "./LinkClickEvent.mjs";
 export * from "./LocationShareAction.mjs";

package/dist/esm/version.d.mts

@@ -1 +1 @@
-export declare const SDK_VERSION = "2.0.12";
+export declare const SDK_VERSION = "2.0.13";

package/dist/esm/version.mjs

@@ -1 +1 @@
-export const SDK_VERSION = "2.0.12";
+export const SDK_VERSION = "2.0.13";

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "rcs-js",
-    "version": "2.0.12",
+    "version": "2.0.13",
     "private": false,
     "repository": "github:pinnacle-dev/rcs-js",
     "type": "commonjs",

package/reference.md

@@ -3774,6 +3774,10 @@ await client.messages.blast.rcs({
             }],
         text: "Hello from Pinnacle RCS!"
     },
+    fallback: {
+        from: "+14155164736",
+        text: "Hello from Pinnacle! Reply LEARN to learn more."
+    },
     options: {
         transcode: true,
         validate: true