rcs-js 2.0.3 → 2.0.5

package/README.md

@@ -5,6 +5,23 @@
 
 The Pinnacle TypeScript library provides convenient access to the Pinnacle APIs from TypeScript.
 
+## Table of Contents
+
+- [Installation](#installation)
+- [Usage](#usage)
+- [Request and Response Types](#request-and-response-types)
+- [Exception Handling](#exception-handling)
+- [Advanced](#advanced)
+    - [Additional Headers](#additional-headers)
+    - [Additional Query String Parameters](#additional-query-string-parameters)
+    - [Retries](#retries)
+    - [Timeouts](#timeouts)
+    - [Aborting Requests](#aborting-requests)
+    - [Access Raw Response Data](#access-raw-response-data)
+    - [Runtime Compatibility](#runtime-compatibility)
+- [Contributing](#contributing)
+- [Reference](#reference)
+
 ## Installation
 
 ```sh
@@ -29,7 +46,7 @@ await client.brands.autofill({
 });
 ```
 
-## Request And Response Types
+## Request and Response Types
 
 The SDK exports all request and response types as TypeScript interfaces. Simply import them with the
 following namespace:

package/dist/cjs/Client.js

@@ -54,8 +54,8 @@ class PinnacleClient {
         this._options = Object.assign(Object.assign({}, _options), { headers: (0, headers_js_1.mergeHeaders)({
                 "X-Fern-Language": "JavaScript",
                 "X-Fern-SDK-Name": "rcs-js",
-                "X-Fern-SDK-Version": "2.0.3",
-                "User-Agent": "rcs-js/2.0.3",
+                "X-Fern-SDK-Version": "2.0.5",
+                "User-Agent": "rcs-js/2.0.5",
                 "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/messages/resources/index.d.ts

@@ -6,3 +6,4 @@ export * as rcs from "./rcs/index.js";
 export * from "./rcs/types/index.js";
 export * from "./sms/client/requests/index.js";
 export * from "./mms/client/requests/index.js";
+export * from "./rcs/client/requests/index.js";

package/dist/cjs/api/resources/messages/resources/index.js

@@ -45,3 +45,4 @@ exports.rcs = __importStar(require("./rcs/index.js"));
 __exportStar(require("./rcs/types/index.js"), exports);
 __exportStar(require("./sms/client/requests/index.js"), exports);
 __exportStar(require("./mms/client/requests/index.js"), exports);
+__exportStar(require("./rcs/client/requests/index.js"), exports);

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

@@ -58,6 +58,39 @@ export declare class Rcs {
      */
     send(request: Pinnacle.RichMessage, requestOptions?: Rcs.RequestOptions): core.HttpResponsePromise<Pinnacle.messages.RcsSendResponse>;
     private __send;
+    /**
+     * Send a typing indicator from an RCS agent to a recipient.
+     *
+     * This endpoint allows RCS agents to display a typing indicator to recipients. The indicator is a message bubble with animated typing dots like this: <img src="https://server.trypinnacle.app/storage/v1/object/public/pinnacle-public-assets/ios-typing-indicator.png" alt="Typing Indicator" style="display: inline; height: 1.5em; vertical-align: middle; margin: 0 4px;" />
+     *
+     * **Use Case:** Typing indicators are especially useful for providing feedback to users while the agent is thinking or generating a response that may take some time, creating a more engaging conversational experience.
+     *
+     * **Expiration:** Typing indicators automatically expire after around 20 seconds or when the agent sends a message, whichever comes first.
+     *
+     * **Frequency:** You can send typing indicators as many times as needed, though only one will be displayed at a time. Sending multiple typing indicators will extend the duration of the current indicator.
+     *
+     * > **Note:** Typing indicators are best-effort hints, not delivery-guaranteed state. The platform is allowed to coalesce or drop them, and the client UI decides when to show/hide.
+     *
+     * @param {Pinnacle.messages.SendTypingIndicatorSchema} request
+     * @param {Rcs.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link Pinnacle.BadRequestError}
+     * @throws {@link Pinnacle.UnauthorizedError}
+     * @throws {@link Pinnacle.NotFoundError}
+     * @throws {@link Pinnacle.InternalServerError}
+     * @throws {@link Pinnacle.NotImplementedError}
+     *
+     * @example
+     *     await client.messages.rcs.sendTyping({
+     *         agentId: "agent_pinnacle",
+     *         to: "+14154746461",
+     *         options: {
+     *             test_mode: false
+     *         }
+     *     })
+     */
+    sendTyping(request: Pinnacle.messages.SendTypingIndicatorSchema, requestOptions?: Rcs.RequestOptions): core.HttpResponsePromise<Pinnacle.SendTypingIndicatorResponse>;
+    private __sendTyping;
     /**
      * Validate RCS message content without sending it.
      *

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

@@ -143,6 +143,96 @@ class Rcs {
             }
         });
     }
+    /**
+     * Send a typing indicator from an RCS agent to a recipient.
+     *
+     * This endpoint allows RCS agents to display a typing indicator to recipients. The indicator is a message bubble with animated typing dots like this: <img src="https://server.trypinnacle.app/storage/v1/object/public/pinnacle-public-assets/ios-typing-indicator.png" alt="Typing Indicator" style="display: inline; height: 1.5em; vertical-align: middle; margin: 0 4px;" />
+     *
+     * **Use Case:** Typing indicators are especially useful for providing feedback to users while the agent is thinking or generating a response that may take some time, creating a more engaging conversational experience.
+     *
+     * **Expiration:** Typing indicators automatically expire after around 20 seconds or when the agent sends a message, whichever comes first.
+     *
+     * **Frequency:** You can send typing indicators as many times as needed, though only one will be displayed at a time. Sending multiple typing indicators will extend the duration of the current indicator.
+     *
+     * > **Note:** Typing indicators are best-effort hints, not delivery-guaranteed state. The platform is allowed to coalesce or drop them, and the client UI decides when to show/hide.
+     *
+     * @param {Pinnacle.messages.SendTypingIndicatorSchema} request
+     * @param {Rcs.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link Pinnacle.BadRequestError}
+     * @throws {@link Pinnacle.UnauthorizedError}
+     * @throws {@link Pinnacle.NotFoundError}
+     * @throws {@link Pinnacle.InternalServerError}
+     * @throws {@link Pinnacle.NotImplementedError}
+     *
+     * @example
+     *     await client.messages.rcs.sendTyping({
+     *         agentId: "agent_pinnacle",
+     *         to: "+14154746461",
+     *         options: {
+     *             test_mode: false
+     *         }
+     *     })
+     */
+    sendTyping(request, requestOptions) {
+        return core.HttpResponsePromise.fromPromise(this.__sendTyping(request, requestOptions));
+    }
+    __sendTyping(request, requestOptions) {
+        return __awaiter(this, void 0, void 0, function* () {
+            var _a, _b, _c;
+            let _headers = (0, headers_js_1.mergeHeaders)((_a = this._options) === null || _a === void 0 ? void 0 : _a.headers, (0, headers_js_1.mergeOnlyDefinedHeaders)(Object.assign({}, (yield this._getCustomAuthorizationHeaders()))), requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.headers);
+            const _response = yield core.fetcher({
+                url: core.url.join((_c = (_b = (yield core.Supplier.get(this._options.baseUrl))) !== null && _b !== void 0 ? _b : (yield core.Supplier.get(this._options.environment))) !== null && _c !== void 0 ? _c : environments.PinnacleEnvironment.Default, "messages/typing"),
+                method: "POST",
+                headers: _headers,
+                contentType: "application/json",
+                queryParameters: requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.queryParams,
+                requestType: "json",
+                body: request,
+                timeoutMs: (requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.timeoutInSeconds) != null ? requestOptions.timeoutInSeconds * 1000 : 60000,
+                maxRetries: requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.maxRetries,
+                abortSignal: requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.abortSignal,
+            });
+            if (_response.ok) {
+                return { data: _response.body, rawResponse: _response.rawResponse };
+            }
+            if (_response.error.reason === "status-code") {
+                switch (_response.error.statusCode) {
+                    case 400:
+                        throw new Pinnacle.BadRequestError(_response.error.body, _response.rawResponse);
+                    case 401:
+                        throw new Pinnacle.UnauthorizedError(_response.error.body, _response.rawResponse);
+                    case 404:
+                        throw new Pinnacle.NotFoundError(_response.error.body, _response.rawResponse);
+                    case 500:
+                        throw new Pinnacle.InternalServerError(_response.error.body, _response.rawResponse);
+                    case 501:
+                        throw new Pinnacle.NotImplementedError(_response.error.body, _response.rawResponse);
+                    default:
+                        throw new errors.PinnacleError({
+                            statusCode: _response.error.statusCode,
+                            body: _response.error.body,
+                            rawResponse: _response.rawResponse,
+                        });
+                }
+            }
+            switch (_response.error.reason) {
+                case "non-json":
+                    throw new errors.PinnacleError({
+                        statusCode: _response.error.statusCode,
+                        body: _response.error.rawBody,
+                        rawResponse: _response.rawResponse,
+                    });
+                case "timeout":
+                    throw new errors.PinnacleTimeoutError("Timeout exceeded when calling POST /messages/typing.");
+                case "unknown":
+                    throw new errors.PinnacleError({
+                        message: _response.error.errorMessage,
+                        rawResponse: _response.rawResponse,
+                    });
+            }
+        });
+    }
     /**
      * Validate RCS message content without sending it.
      *

package/dist/cjs/api/resources/messages/resources/rcs/client/index.d.ts

@@ -1 +1,2 @@
 export {};
+export * from "./requests/index.js";

package/dist/cjs/api/resources/messages/resources/rcs/client/index.js

@@ -1,2 +1,17 @@
 "use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
 Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./requests/index.js"), exports);

package/dist/cjs/api/resources/messages/resources/rcs/client/requests/SendTypingIndicatorSchema.d.ts

@@ -0,0 +1,38 @@
+/**
+ * This file was auto-generated by Fern from our API Definition.
+ */
+/**
+ * @example
+ *     {
+ *         agentId: "agent_pinnacle",
+ *         to: "+14154746461",
+ *         options: {
+ *             test_mode: false
+ *         }
+ *     }
+ */
+export interface SendTypingIndicatorSchema {
+    /**
+     * The unique identifier of the RCS agent sending the typing indicator. <br>
+     *
+     * Format: `agent_` followed by alphanumeric characters (e.g., `agent_pinnacle`).
+     */
+    agentId: string;
+    /**
+     * The recipient's phone number in E.164 format. <br>
+     *
+     * Must include country code with a leading plus sign (e.g., `+14155551234`).
+     */
+    to: string;
+    /** Configure how your typing indicator is sent. */
+    options?: SendTypingIndicatorSchema.Options;
+}
+export declare namespace SendTypingIndicatorSchema {
+    /**
+     * Configure how your typing indicator is sent.
+     */
+    interface Options {
+        /** Send via the test agent to whitelisted test devices. Useful for development and debugging. */
+        test_mode?: boolean;
+    }
+}

package/dist/cjs/api/resources/messages/resources/rcs/client/requests/SendTypingIndicatorSchema.js

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

package/dist/cjs/api/resources/messages/resources/rcs/client/requests/index.d.ts

@@ -0,0 +1 @@
+export { type SendTypingIndicatorSchema } from "./SendTypingIndicatorSchema.js";

package/dist/cjs/api/resources/messages/resources/rcs/client/requests/index.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

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

@@ -0,0 +1,21 @@
+/**
+ * This file was auto-generated by Fern from our API Definition.
+ */
+import * as Pinnacle from "../index.js";
+/**
+ * Configure how your RCS message is sent and tracked.
+ */
+export interface Options {
+    schedule?: Pinnacle.MessageSchedule;
+    /** Send via the test agent to whitelisted test devices. Useful for development and debugging. */
+    test_mode?: boolean;
+    tracking?: Pinnacle.Tracking;
+    /** Media files and card media will be transcoded to a supported RCS format. This adds a small delay to sending the message. Ignored for rich text messages. */
+    transcode?: boolean;
+    /**
+     * Validate your message for any unsupported files. <br>
+     *
+     * If failed, errors will be thrown and the message will not send.
+     */
+    validate?: boolean;
+}

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

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

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

@@ -5,10 +5,39 @@
  * Button that opens a URL when tapped by the recipient.
  */
 export interface RcsButtonOpenUrl {
-    /** Optional additional data to attach to this button. */
-    metadata?: string;
+    /**
+     * Controls how the URL is displayed when the button is tapped.
+     *
+     * **Default behavior:** If not specified, the URL opens in the device's default browser. If you're sending deeplinks, you should use this mode as it will open the deeplink in the native app if it is installed.
+     *
+     * **Available modes in order of size:**
+     * - `HALF` — Half-screen webview overlay
+     * - `TALL` — Tall webview overlay
+     * - `FULL` — Full-screen webview
+     */
+    webviewMode?: RcsButtonOpenUrl.WebviewMode;
     /** The URL to open when the button is tapped. Must be a valid HTTP or HTTPS URL. */
     payload: string;
     /** Display text for the button. */
     title: string;
+    /** Optional additional data to attach to this button. */
+    metadata?: string;
+}
+export declare namespace RcsButtonOpenUrl {
+    /**
+     * Controls how the URL is displayed when the button is tapped.
+     *
+     * **Default behavior:** If not specified, the URL opens in the device's default browser. If you're sending deeplinks, you should use this mode as it will open the deeplink in the native app if it is installed.
+     *
+     * **Available modes in order of size:**
+     * - `HALF` — Half-screen webview overlay
+     * - `TALL` — Tall webview overlay
+     * - `FULL` — Full-screen webview
+     */
+    type WebviewMode = "HALF" | "TALL" | "FULL";
+    const WebviewMode: {
+        readonly Half: "HALF";
+        readonly Tall: "TALL";
+        readonly Full: "FULL";
+    };
 }

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

@@ -3,3 +3,12 @@
  * This file was auto-generated by Fern from our API Definition.
  */
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.RcsButtonOpenUrl = void 0;
+var RcsButtonOpenUrl;
+(function (RcsButtonOpenUrl) {
+    RcsButtonOpenUrl.WebviewMode = {
+        Half: "HALF",
+        Tall: "TALL",
+        Full: "FULL",
+    };
+})(RcsButtonOpenUrl || (exports.RcsButtonOpenUrl = RcsButtonOpenUrl = {}));

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

@@ -5,12 +5,18 @@
  * Button that shares a specific location with the recipient when tapped.
  */
 export interface RcsButtonSendLocation {
+    /**
+     * Optional name or label for the location that will be displayed in the map app (e.g., "Central Park", "Home Office").
+     *
+     * If not provided, the button title will be used as the location name.
+     */
+    name?: string;
     /** Geographic coordinates of the location to share. */
     latLong: RcsButtonSendLocation.LatLong;
-    /** Optional additional data to attach to this button. */
-    metadata?: string;
     /** Display text for the button. */
     title: string;
+    /** Optional additional data to attach to this button. */
+    metadata?: string;
 }
 export declare namespace RcsButtonSendLocation {
     /**

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

@@ -2,5 +2,55 @@
  * This file was auto-generated by Fern from our API Definition.
  */
 import * as Pinnacle from "../index.js";
-export interface RichCardsMessage extends Pinnacle.RcsBase, Pinnacle.RcsCards {
+export interface RichCardsMessage extends Pinnacle.RcsCards {
+    options?: RichCardsMessage.Options;
+    /** Your RCS agent ID which must be prefixed with 'agent_'. */
+    from: string;
+    /** Recipient's phone number in E.164 format. */
+    to: string;
+}
+export declare namespace RichCardsMessage {
+    interface Options extends Pinnacle.Options {
+        /**
+         * Configure standalone card layout options for enhanced visual presentation.
+         *
+         * > **⚠️ Important Restriction**
+         * >
+         * > This option is **only valid for single card messages**. Using it with multiple cards will cause the request to fail with a validation error.
+         */
+        standalone_card?: Options.StandaloneCard;
+    }
+    namespace Options {
+        /**
+         * Configure standalone card layout options for enhanced visual presentation.
+         *
+         * > **⚠️ Important Restriction**
+         * >
+         * > This option is **only valid for single card messages**. Using it with multiple cards will cause the request to fail with a validation error.
+         */
+        interface StandaloneCard {
+            /** The orientation of the standalone card. */
+            orientation?: StandaloneCard.Orientation;
+            /** The alignment of the image in the standalone card. This field is ignored if orientation is VERTICAL. */
+            image_alignment?: StandaloneCard.ImageAlignment;
+        }
+        namespace StandaloneCard {
+            /**
+             * The orientation of the standalone card.
+             */
+            type Orientation = "HORIZONTAL" | "VERTICAL";
+            const Orientation: {
+                readonly Horizontal: "HORIZONTAL";
+                readonly Vertical: "VERTICAL";
+            };
+            /**
+             * The alignment of the image in the standalone card. This field is ignored if orientation is VERTICAL.
+             */
+            type ImageAlignment = "LEFT" | "RIGHT";
+            const ImageAlignment: {
+                readonly Left: "LEFT";
+                readonly Right: "RIGHT";
+            };
+        }
+    }
 }

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

@@ -3,3 +3,21 @@
  * This file was auto-generated by Fern from our API Definition.
  */
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.RichCardsMessage = void 0;
+var RichCardsMessage;
+(function (RichCardsMessage) {
+    let Options;
+    (function (Options) {
+        let StandaloneCard;
+        (function (StandaloneCard) {
+            StandaloneCard.Orientation = {
+                Horizontal: "HORIZONTAL",
+                Vertical: "VERTICAL",
+            };
+            StandaloneCard.ImageAlignment = {
+                Left: "LEFT",
+                Right: "RIGHT",
+            };
+        })(StandaloneCard = Options.StandaloneCard || (Options.StandaloneCard = {}));
+    })(Options = RichCardsMessage.Options || (RichCardsMessage.Options = {}));
+})(RichCardsMessage || (exports.RichCardsMessage = RichCardsMessage = {}));

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

@@ -0,0 +1,22 @@
+/**
+ * This file was auto-generated by Fern from our API Definition.
+ */
+/**
+ * Response schema confirming the typing indicator was sent.
+ */
+export interface SendTypingIndicatorResponse {
+    /** Indicates whether the typing indicator was successfully sent. */
+    success: boolean;
+    /** The RCS agent that sent the typing indicator. */
+    agentId: string;
+    /** The recipient's phone number that received the typing indicator. */
+    recipient: string;
+    /** Timestamp when the typing indicator was started (ISO 8601 format). */
+    startedAt: string;
+    /**
+     * Timestamp when the typing indicator will automatically expire (ISO 8601 format). <br>
+     *
+     * This is typically one minute after `startedAt` unless a message is sent first.
+     */
+    endedAt: string;
+}

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

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

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

@@ -80,9 +80,11 @@ export * from "./RcsBase.js";
 export * from "./RichTextMessage.js";
 export * from "./RichMediaMessage.js";
 export * from "./RcsCards.js";
+export * from "./Options.js";
 export * from "./RichCardsMessage.js";
 export * from "./RichMessage.js";
 export * from "./SentRcsDetails.js";
+export * from "./SendTypingIndicatorResponse.js";
 export * from "./SmsValidationResult.js";
 export * from "./MmsValidationResult.js";
 export * from "./RcsValidateContent.js";

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

@@ -96,9 +96,11 @@ __exportStar(require("./RcsBase.js"), exports);
 __exportStar(require("./RichTextMessage.js"), exports);
 __exportStar(require("./RichMediaMessage.js"), exports);
 __exportStar(require("./RcsCards.js"), exports);
+__exportStar(require("./Options.js"), exports);
 __exportStar(require("./RichCardsMessage.js"), exports);
 __exportStar(require("./RichMessage.js"), exports);
 __exportStar(require("./SentRcsDetails.js"), exports);
+__exportStar(require("./SendTypingIndicatorResponse.js"), exports);
 __exportStar(require("./SmsValidationResult.js"), exports);
 __exportStar(require("./MmsValidationResult.js"), exports);
 __exportStar(require("./RcsValidateContent.js"), exports);

package/dist/cjs/version.d.ts

@@ -1 +1 @@
-export declare const SDK_VERSION = "2.0.3";
+export declare const SDK_VERSION = "2.0.5";

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.3";
+exports.SDK_VERSION = "2.0.5";

package/dist/esm/Client.mjs

@@ -18,8 +18,8 @@ export class PinnacleClient {
         this._options = Object.assign(Object.assign({}, _options), { headers: mergeHeaders({
                 "X-Fern-Language": "JavaScript",
                 "X-Fern-SDK-Name": "rcs-js",
-                "X-Fern-SDK-Version": "2.0.3",
-                "User-Agent": "rcs-js/2.0.3",
+                "X-Fern-SDK-Version": "2.0.5",
+                "User-Agent": "rcs-js/2.0.5",
                 "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/messages/resources/index.d.mts

@@ -6,3 +6,4 @@ export * as rcs from "./rcs/index.mjs";
 export * from "./rcs/types/index.mjs";
 export * from "./sms/client/requests/index.mjs";
 export * from "./mms/client/requests/index.mjs";
+export * from "./rcs/client/requests/index.mjs";

package/dist/esm/api/resources/messages/resources/index.mjs

@@ -6,3 +6,4 @@ export * as rcs from "./rcs/index.mjs";
 export * from "./rcs/types/index.mjs";
 export * from "./sms/client/requests/index.mjs";
 export * from "./mms/client/requests/index.mjs";
+export * from "./rcs/client/requests/index.mjs";

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

@@ -58,6 +58,39 @@ export declare class Rcs {
      */
     send(request: Pinnacle.RichMessage, requestOptions?: Rcs.RequestOptions): core.HttpResponsePromise<Pinnacle.messages.RcsSendResponse>;
     private __send;
+    /**
+     * Send a typing indicator from an RCS agent to a recipient.
+     *
+     * This endpoint allows RCS agents to display a typing indicator to recipients. The indicator is a message bubble with animated typing dots like this: <img src="https://server.trypinnacle.app/storage/v1/object/public/pinnacle-public-assets/ios-typing-indicator.png" alt="Typing Indicator" style="display: inline; height: 1.5em; vertical-align: middle; margin: 0 4px;" />
+     *
+     * **Use Case:** Typing indicators are especially useful for providing feedback to users while the agent is thinking or generating a response that may take some time, creating a more engaging conversational experience.
+     *
+     * **Expiration:** Typing indicators automatically expire after around 20 seconds or when the agent sends a message, whichever comes first.
+     *
+     * **Frequency:** You can send typing indicators as many times as needed, though only one will be displayed at a time. Sending multiple typing indicators will extend the duration of the current indicator.
+     *
+     * > **Note:** Typing indicators are best-effort hints, not delivery-guaranteed state. The platform is allowed to coalesce or drop them, and the client UI decides when to show/hide.
+     *
+     * @param {Pinnacle.messages.SendTypingIndicatorSchema} request
+     * @param {Rcs.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link Pinnacle.BadRequestError}
+     * @throws {@link Pinnacle.UnauthorizedError}
+     * @throws {@link Pinnacle.NotFoundError}
+     * @throws {@link Pinnacle.InternalServerError}
+     * @throws {@link Pinnacle.NotImplementedError}
+     *
+     * @example
+     *     await client.messages.rcs.sendTyping({
+     *         agentId: "agent_pinnacle",
+     *         to: "+14154746461",
+     *         options: {
+     *             test_mode: false
+     *         }
+     *     })
+     */
+    sendTyping(request: Pinnacle.messages.SendTypingIndicatorSchema, requestOptions?: Rcs.RequestOptions): core.HttpResponsePromise<Pinnacle.SendTypingIndicatorResponse>;
+    private __sendTyping;
     /**
      * Validate RCS message content without sending it.
      *

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

@@ -107,6 +107,96 @@ export class Rcs {
             }
         });
     }
+    /**
+     * Send a typing indicator from an RCS agent to a recipient.
+     *
+     * This endpoint allows RCS agents to display a typing indicator to recipients. The indicator is a message bubble with animated typing dots like this: <img src="https://server.trypinnacle.app/storage/v1/object/public/pinnacle-public-assets/ios-typing-indicator.png" alt="Typing Indicator" style="display: inline; height: 1.5em; vertical-align: middle; margin: 0 4px;" />
+     *
+     * **Use Case:** Typing indicators are especially useful for providing feedback to users while the agent is thinking or generating a response that may take some time, creating a more engaging conversational experience.
+     *
+     * **Expiration:** Typing indicators automatically expire after around 20 seconds or when the agent sends a message, whichever comes first.
+     *
+     * **Frequency:** You can send typing indicators as many times as needed, though only one will be displayed at a time. Sending multiple typing indicators will extend the duration of the current indicator.
+     *
+     * > **Note:** Typing indicators are best-effort hints, not delivery-guaranteed state. The platform is allowed to coalesce or drop them, and the client UI decides when to show/hide.
+     *
+     * @param {Pinnacle.messages.SendTypingIndicatorSchema} request
+     * @param {Rcs.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link Pinnacle.BadRequestError}
+     * @throws {@link Pinnacle.UnauthorizedError}
+     * @throws {@link Pinnacle.NotFoundError}
+     * @throws {@link Pinnacle.InternalServerError}
+     * @throws {@link Pinnacle.NotImplementedError}
+     *
+     * @example
+     *     await client.messages.rcs.sendTyping({
+     *         agentId: "agent_pinnacle",
+     *         to: "+14154746461",
+     *         options: {
+     *             test_mode: false
+     *         }
+     *     })
+     */
+    sendTyping(request, requestOptions) {
+        return core.HttpResponsePromise.fromPromise(this.__sendTyping(request, requestOptions));
+    }
+    __sendTyping(request, requestOptions) {
+        return __awaiter(this, void 0, void 0, function* () {
+            var _a, _b, _c;
+            let _headers = mergeHeaders((_a = this._options) === null || _a === void 0 ? void 0 : _a.headers, mergeOnlyDefinedHeaders(Object.assign({}, (yield this._getCustomAuthorizationHeaders()))), requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.headers);
+            const _response = yield core.fetcher({
+                url: core.url.join((_c = (_b = (yield core.Supplier.get(this._options.baseUrl))) !== null && _b !== void 0 ? _b : (yield core.Supplier.get(this._options.environment))) !== null && _c !== void 0 ? _c : environments.PinnacleEnvironment.Default, "messages/typing"),
+                method: "POST",
+                headers: _headers,
+                contentType: "application/json",
+                queryParameters: requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.queryParams,
+                requestType: "json",
+                body: request,
+                timeoutMs: (requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.timeoutInSeconds) != null ? requestOptions.timeoutInSeconds * 1000 : 60000,
+                maxRetries: requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.maxRetries,
+                abortSignal: requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.abortSignal,
+            });
+            if (_response.ok) {
+                return { data: _response.body, rawResponse: _response.rawResponse };
+            }
+            if (_response.error.reason === "status-code") {
+                switch (_response.error.statusCode) {
+                    case 400:
+                        throw new Pinnacle.BadRequestError(_response.error.body, _response.rawResponse);
+                    case 401:
+                        throw new Pinnacle.UnauthorizedError(_response.error.body, _response.rawResponse);
+                    case 404:
+                        throw new Pinnacle.NotFoundError(_response.error.body, _response.rawResponse);
+                    case 500:
+                        throw new Pinnacle.InternalServerError(_response.error.body, _response.rawResponse);
+                    case 501:
+                        throw new Pinnacle.NotImplementedError(_response.error.body, _response.rawResponse);
+                    default:
+                        throw new errors.PinnacleError({
+                            statusCode: _response.error.statusCode,
+                            body: _response.error.body,
+                            rawResponse: _response.rawResponse,
+                        });
+                }
+            }
+            switch (_response.error.reason) {
+                case "non-json":
+                    throw new errors.PinnacleError({
+                        statusCode: _response.error.statusCode,
+                        body: _response.error.rawBody,
+                        rawResponse: _response.rawResponse,
+                    });
+                case "timeout":
+                    throw new errors.PinnacleTimeoutError("Timeout exceeded when calling POST /messages/typing.");
+                case "unknown":
+                    throw new errors.PinnacleError({
+                        message: _response.error.errorMessage,
+                        rawResponse: _response.rawResponse,
+                    });
+            }
+        });
+    }
     /**
      * Validate RCS message content without sending it.
      *

package/dist/esm/api/resources/messages/resources/rcs/client/index.d.mts

@@ -1 +1,2 @@
 export {};
+export * from "./requests/index.mjs";

package/dist/esm/api/resources/messages/resources/rcs/client/index.mjs

@@ -1 +1 @@
-export {};
+export * from "./requests/index.mjs";

package/dist/esm/api/resources/messages/resources/rcs/client/requests/SendTypingIndicatorSchema.d.mts

@@ -0,0 +1,38 @@
+/**
+ * This file was auto-generated by Fern from our API Definition.
+ */
+/**
+ * @example
+ *     {
+ *         agentId: "agent_pinnacle",
+ *         to: "+14154746461",
+ *         options: {
+ *             test_mode: false
+ *         }
+ *     }
+ */
+export interface SendTypingIndicatorSchema {
+    /**
+     * The unique identifier of the RCS agent sending the typing indicator. <br>
+     *
+     * Format: `agent_` followed by alphanumeric characters (e.g., `agent_pinnacle`).
+     */
+    agentId: string;
+    /**
+     * The recipient's phone number in E.164 format. <br>
+     *
+     * Must include country code with a leading plus sign (e.g., `+14155551234`).
+     */
+    to: string;
+    /** Configure how your typing indicator is sent. */
+    options?: SendTypingIndicatorSchema.Options;
+}
+export declare namespace SendTypingIndicatorSchema {
+    /**
+     * Configure how your typing indicator is sent.
+     */
+    interface Options {
+        /** Send via the test agent to whitelisted test devices. Useful for development and debugging. */
+        test_mode?: boolean;
+    }
+}

package/dist/esm/api/resources/messages/resources/rcs/client/requests/SendTypingIndicatorSchema.mjs

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

package/dist/esm/api/resources/messages/resources/rcs/client/requests/index.d.mts

@@ -0,0 +1 @@
+export { type SendTypingIndicatorSchema } from "./SendTypingIndicatorSchema.mjs";

package/dist/esm/api/resources/messages/resources/rcs/client/requests/index.mjs

@@ -0,0 +1 @@
+export {};

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

@@ -0,0 +1,21 @@
+/**
+ * This file was auto-generated by Fern from our API Definition.
+ */
+import * as Pinnacle from "../index.mjs";
+/**
+ * Configure how your RCS message is sent and tracked.
+ */
+export interface Options {
+    schedule?: Pinnacle.MessageSchedule;
+    /** Send via the test agent to whitelisted test devices. Useful for development and debugging. */
+    test_mode?: boolean;
+    tracking?: Pinnacle.Tracking;
+    /** Media files and card media will be transcoded to a supported RCS format. This adds a small delay to sending the message. Ignored for rich text messages. */
+    transcode?: boolean;
+    /**
+     * Validate your message for any unsupported files. <br>
+     *
+     * If failed, errors will be thrown and the message will not send.
+     */
+    validate?: boolean;
+}

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

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

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

@@ -5,10 +5,39 @@
  * Button that opens a URL when tapped by the recipient.
  */
 export interface RcsButtonOpenUrl {
-    /** Optional additional data to attach to this button. */
-    metadata?: string;
+    /**
+     * Controls how the URL is displayed when the button is tapped.
+     *
+     * **Default behavior:** If not specified, the URL opens in the device's default browser. If you're sending deeplinks, you should use this mode as it will open the deeplink in the native app if it is installed.
+     *
+     * **Available modes in order of size:**
+     * - `HALF` — Half-screen webview overlay
+     * - `TALL` — Tall webview overlay
+     * - `FULL` — Full-screen webview
+     */
+    webviewMode?: RcsButtonOpenUrl.WebviewMode;
     /** The URL to open when the button is tapped. Must be a valid HTTP or HTTPS URL. */
     payload: string;
     /** Display text for the button. */
     title: string;
+    /** Optional additional data to attach to this button. */
+    metadata?: string;
+}
+export declare namespace RcsButtonOpenUrl {
+    /**
+     * Controls how the URL is displayed when the button is tapped.
+     *
+     * **Default behavior:** If not specified, the URL opens in the device's default browser. If you're sending deeplinks, you should use this mode as it will open the deeplink in the native app if it is installed.
+     *
+     * **Available modes in order of size:**
+     * - `HALF` — Half-screen webview overlay
+     * - `TALL` — Tall webview overlay
+     * - `FULL` — Full-screen webview
+     */
+    type WebviewMode = "HALF" | "TALL" | "FULL";
+    const WebviewMode: {
+        readonly Half: "HALF";
+        readonly Tall: "TALL";
+        readonly Full: "FULL";
+    };
 }

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

@@ -1,4 +1,11 @@
 /**
  * This file was auto-generated by Fern from our API Definition.
  */
-export {};
+export var RcsButtonOpenUrl;
+(function (RcsButtonOpenUrl) {
+    RcsButtonOpenUrl.WebviewMode = {
+        Half: "HALF",
+        Tall: "TALL",
+        Full: "FULL",
+    };
+})(RcsButtonOpenUrl || (RcsButtonOpenUrl = {}));

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

@@ -5,12 +5,18 @@
  * Button that shares a specific location with the recipient when tapped.
  */
 export interface RcsButtonSendLocation {
+    /**
+     * Optional name or label for the location that will be displayed in the map app (e.g., "Central Park", "Home Office").
+     *
+     * If not provided, the button title will be used as the location name.
+     */
+    name?: string;
     /** Geographic coordinates of the location to share. */
     latLong: RcsButtonSendLocation.LatLong;
-    /** Optional additional data to attach to this button. */
-    metadata?: string;
     /** Display text for the button. */
     title: string;
+    /** Optional additional data to attach to this button. */
+    metadata?: string;
 }
 export declare namespace RcsButtonSendLocation {
     /**

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

@@ -2,5 +2,55 @@
  * This file was auto-generated by Fern from our API Definition.
  */
 import * as Pinnacle from "../index.mjs";
-export interface RichCardsMessage extends Pinnacle.RcsBase, Pinnacle.RcsCards {
+export interface RichCardsMessage extends Pinnacle.RcsCards {
+    options?: RichCardsMessage.Options;
+    /** Your RCS agent ID which must be prefixed with 'agent_'. */
+    from: string;
+    /** Recipient's phone number in E.164 format. */
+    to: string;
+}
+export declare namespace RichCardsMessage {
+    interface Options extends Pinnacle.Options {
+        /**
+         * Configure standalone card layout options for enhanced visual presentation.
+         *
+         * > **⚠️ Important Restriction**
+         * >
+         * > This option is **only valid for single card messages**. Using it with multiple cards will cause the request to fail with a validation error.
+         */
+        standalone_card?: Options.StandaloneCard;
+    }
+    namespace Options {
+        /**
+         * Configure standalone card layout options for enhanced visual presentation.
+         *
+         * > **⚠️ Important Restriction**
+         * >
+         * > This option is **only valid for single card messages**. Using it with multiple cards will cause the request to fail with a validation error.
+         */
+        interface StandaloneCard {
+            /** The orientation of the standalone card. */
+            orientation?: StandaloneCard.Orientation;
+            /** The alignment of the image in the standalone card. This field is ignored if orientation is VERTICAL. */
+            image_alignment?: StandaloneCard.ImageAlignment;
+        }
+        namespace StandaloneCard {
+            /**
+             * The orientation of the standalone card.
+             */
+            type Orientation = "HORIZONTAL" | "VERTICAL";
+            const Orientation: {
+                readonly Horizontal: "HORIZONTAL";
+                readonly Vertical: "VERTICAL";
+            };
+            /**
+             * The alignment of the image in the standalone card. This field is ignored if orientation is VERTICAL.
+             */
+            type ImageAlignment = "LEFT" | "RIGHT";
+            const ImageAlignment: {
+                readonly Left: "LEFT";
+                readonly Right: "RIGHT";
+            };
+        }
+    }
 }

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

@@ -1,4 +1,20 @@
 /**
  * This file was auto-generated by Fern from our API Definition.
  */
-export {};
+export var RichCardsMessage;
+(function (RichCardsMessage) {
+    let Options;
+    (function (Options) {
+        let StandaloneCard;
+        (function (StandaloneCard) {
+            StandaloneCard.Orientation = {
+                Horizontal: "HORIZONTAL",
+                Vertical: "VERTICAL",
+            };
+            StandaloneCard.ImageAlignment = {
+                Left: "LEFT",
+                Right: "RIGHT",
+            };
+        })(StandaloneCard = Options.StandaloneCard || (Options.StandaloneCard = {}));
+    })(Options = RichCardsMessage.Options || (RichCardsMessage.Options = {}));
+})(RichCardsMessage || (RichCardsMessage = {}));

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

@@ -0,0 +1,22 @@
+/**
+ * This file was auto-generated by Fern from our API Definition.
+ */
+/**
+ * Response schema confirming the typing indicator was sent.
+ */
+export interface SendTypingIndicatorResponse {
+    /** Indicates whether the typing indicator was successfully sent. */
+    success: boolean;
+    /** The RCS agent that sent the typing indicator. */
+    agentId: string;
+    /** The recipient's phone number that received the typing indicator. */
+    recipient: string;
+    /** Timestamp when the typing indicator was started (ISO 8601 format). */
+    startedAt: string;
+    /**
+     * Timestamp when the typing indicator will automatically expire (ISO 8601 format). <br>
+     *
+     * This is typically one minute after `startedAt` unless a message is sent first.
+     */
+    endedAt: string;
+}

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

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

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

@@ -80,9 +80,11 @@ export * from "./RcsBase.mjs";
 export * from "./RichTextMessage.mjs";
 export * from "./RichMediaMessage.mjs";
 export * from "./RcsCards.mjs";
+export * from "./Options.mjs";
 export * from "./RichCardsMessage.mjs";
 export * from "./RichMessage.mjs";
 export * from "./SentRcsDetails.mjs";
+export * from "./SendTypingIndicatorResponse.mjs";
 export * from "./SmsValidationResult.mjs";
 export * from "./MmsValidationResult.mjs";
 export * from "./RcsValidateContent.mjs";

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

@@ -80,9 +80,11 @@ export * from "./RcsBase.mjs";
 export * from "./RichTextMessage.mjs";
 export * from "./RichMediaMessage.mjs";
 export * from "./RcsCards.mjs";
+export * from "./Options.mjs";
 export * from "./RichCardsMessage.mjs";
 export * from "./RichMessage.mjs";
 export * from "./SentRcsDetails.mjs";
+export * from "./SendTypingIndicatorResponse.mjs";
 export * from "./SmsValidationResult.mjs";
 export * from "./MmsValidationResult.mjs";
 export * from "./RcsValidateContent.mjs";

package/dist/esm/version.d.mts

@@ -1 +1 @@
-export declare const SDK_VERSION = "2.0.3";
+export declare const SDK_VERSION = "2.0.5";

package/dist/esm/version.mjs

@@ -1 +1 @@
-export const SDK_VERSION = "2.0.3";
+export const SDK_VERSION = "2.0.5";

package/package.json

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

package/reference.md

@@ -3017,6 +3017,85 @@ await client.messages.rcs.send({
 </dl>
 </details>
 
+<details><summary><code>client.messages.rcs.<a href="/src/api/resources/messages/resources/rcs/client/Client.ts">sendTyping</a>({ ...params }) -> Pinnacle.SendTypingIndicatorResponse</code></summary>
+<dl>
+<dd>
+
+#### 📝 Description
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+Send a typing indicator from an RCS agent to a recipient.
+
+This endpoint allows RCS agents to display a typing indicator to recipients. The indicator is a message bubble with animated typing dots like this: <img src="https://server.trypinnacle.app/storage/v1/object/public/pinnacle-public-assets/ios-typing-indicator.png" alt="Typing Indicator" style="display: inline; height: 1.5em; vertical-align: middle; margin: 0 4px;" />
+
+**Use Case:** Typing indicators are especially useful for providing feedback to users while the agent is thinking or generating a response that may take some time, creating a more engaging conversational experience.
+
+**Expiration:** Typing indicators automatically expire after around 20 seconds or when the agent sends a message, whichever comes first.
+
+**Frequency:** You can send typing indicators as many times as needed, though only one will be displayed at a time. Sending multiple typing indicators will extend the duration of the current indicator.
+
+> **Note:** Typing indicators are best-effort hints, not delivery-guaranteed state. The platform is allowed to coalesce or drop them, and the client UI decides when to show/hide.
+
+</dd>
+</dl>
+</dd>
+</dl>
+
+#### 🔌 Usage
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+```typescript
+await client.messages.rcs.sendTyping({
+    agentId: "agent_pinnacle",
+    to: "+14154746461",
+    options: {
+        test_mode: false,
+    },
+});
+```
+
+</dd>
+</dl>
+</dd>
+</dl>
+
+#### ⚙️ Parameters
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+**request:** `Pinnacle.messages.SendTypingIndicatorSchema`
+
+</dd>
+</dl>
+
+<dl>
+<dd>
+
+**requestOptions:** `Rcs.RequestOptions`
+
+</dd>
+</dl>
+</dd>
+</dl>
+
+</dd>
+</dl>
+</details>
+
 <details><summary><code>client.messages.rcs.<a href="/src/api/resources/messages/resources/rcs/client/Client.ts">validate</a>({ ...params }) -> Pinnacle.RcsValidationResult</code></summary>
 <dl>
 <dd>