@twilio/conversations 3.0.0-rc.9 → 3.0.1-rc.1

package/builds/lib.d.ts

@@ -1,12 +1,13 @@
+/// <reference types="node" />
 import { SyncClient, SyncDocument, SyncList } from "twilio-sync";
 import { LogLevelDesc } from "loglevel";
-import { Transport, TwilsockClient, InitRegistration, ConnectionError, TransportResult } from "twilsock";
-import { ConnectionState as TwilsockConnectionState } from "twilsock";
+import { TwilsockClient } from "twilsock";
 import { ReplayEventEmitter } from "@twilio/replay-event-emitter";
+import { JSONValue, CancellationError } from "@twilio/shared";
+import { CancellablePromise as CancellablePromise$0 } from "@twilio/shared";
 import { ChannelType, Notifications } from "@twilio/notifications";
 import { Notifications as NotificationClient } from "@twilio/notifications";
 import { CancellablePromise, McsClient, MediaCategory, McsMedia } from "@twilio/mcs-client";
-import { MediaCategory as McsMediaCategory } from "@twilio/mcs-client";
 interface ConfigurationResponse {
     options: {
         consumption_report_interval: string;
@@ -109,10 +110,11 @@ declare class Configuration {
     readonly userIdentity: string;
     readonly userInfo: string;
     readonly myConversations: string;
+    readonly channelMetadataCacheCapacity: number;
     constructor(options: ClientOptions, configurationResponse: ConfigurationResponse, logger: Logger);
 }
 interface CommandExecutorServices {
-    transport: Transport;
+    transport: TwilsockClient;
 }
 declare class CommandExecutor {
     private _serviceUrl;
@@ -121,23 +123,9 @@ declare class CommandExecutor {
     constructor(_serviceUrl: string, _services: CommandExecutorServices, _productId?: string);
     private _preProcessUrl;
     private _makeRequest;
-    fetchResource<REQ = void, RESP = void>(url: string, requestBody?: REQ): Promise<RESP>;
-    mutateResource<REQ = void, RESP = void>(method: "post" | "delete", url: string, requestBody?: REQ): Promise<RESP>;
+    fetchResource<Request = void, Response = void>(url: string, requestBody?: Request): Promise<Response>;
+    mutateResource<Request = void, Response = void>(method: "post" | "delete", url: string, requestBody?: Request): Promise<Response>;
 }
-/**
- * Represents a JSON value.
- */
-type JSONValue = null | string | number | boolean | JSONObject | JSONArray;
-/**
- * Represents a JSON object.
- */
-type JSONObject = {
-    [x: string]: JSONValue;
-};
-/**
- * Represents a JSON array.
- */
-type JSONArray = JSONValue[];
 type UserEvents = {
     updated: (data: {
         user: User;
@@ -264,12 +252,16 @@ declare class Network {
     private cacheLifetime;
     private readonly cache;
     private timer;
+    private pendingRequests;
+    private isShutdownInitiated;
     constructor(configuration: any, services: any);
     private isExpired;
     private cleanupCache;
     pokeTimer(): void;
+    private static responsePostProcess;
     private executeWithRetry;
-    get<T>(url: string): Promise<TransportResult<T>>;
+    get(url: string): Promise<any>;
+    disconnect(): Promise<void>;
 }
 type UsersEvents = {
     userUpdated: (data: {
@@ -343,9 +335,10 @@ interface ParticipantLinks {
  */
 type ParticipantUpdateReason = "attributes" | "dateCreated" | "dateUpdated" | "roleSid" | "lastReadMessageIndex" | "lastReadTimestamp" | "bindings";
 /**
- * Type of a participant.
+ * Participant type. The string variant can be used to denote new types of
+ * participant that aren't supported by this version of the SDK.
  */
-type ParticipantType = "chat" | "sms" | "whatsapp" | "email";
+type ParticipantType = "chat" | "sms" | "whatsapp" | "email" | string;
 interface ParticipantUpdatedEventArgs {
     participant: Participant;
     updateReasons: ParticipantUpdateReason[];
@@ -428,7 +421,7 @@ declare class Participant extends ReplayEventEmitter<ParticipantEvents> {
      * using the type dynamically `participant.bindings[participant.type]`
      * just be aware that the binding information has different structure for
      * each participant type.
-     * See also {ParticipantEmailBinding}, the only available currently binding descriptor.
+     * See also {@link ParticipantEmailBinding}, the only available currently binding descriptor.
      */
     get bindings(): ParticipantBindings;
     /**
@@ -490,19 +483,15 @@ declare class Participant extends ReplayEventEmitter<ParticipantEvents> {
      */
     updateAttributes(attributes: JSONValue): Promise<Participant>;
 }
+/**
+ * Participant binding options
+ */
 interface ParticipantBindingOptions {
     email?: ParticipantEmailBinding;
 }
-/**
- * Category of media. Possible values are as follows:
- * * `'media'`
- * * `'body'`
- * * `'history'`
- */
-type MediaCategory$0 = McsMediaCategory;
 interface MediaState {
     sid: string;
-    category: MediaCategory$0;
+    category: MediaCategory;
     filename: string | null;
     contentType: string;
     size: number;
@@ -540,7 +529,7 @@ declare class Media {
     /**
      * Media category, can be one of the {@link MediaCategory} values.
      */
-    get category(): MediaCategory$0;
+    get category(): MediaCategory;
     /**
      * Returns the direct content URL for the media.
      *
@@ -567,7 +556,7 @@ interface AggregatedDeliveryDescriptor {
  * Contains aggregated information about delivery statuses of a message across all participants
  * of a conversation.
  *
- * At any moment during the message delivery to a participant, the message can have zero or more of following
+ * At any moment during the message delivery to a participant, the message can have zero or more of the following
  * delivery statuses:
  * * Message is considered as **sent** to a participant if the nearest upstream carrier accepted the message.
  * * Message is considered as **delivered** to a participant if Twilio has received confirmation of message
@@ -693,6 +682,499 @@ declare class DetailedDeliveryReceipt {
      */
     constructor(descriptor: DetailedDeliveryReceiptDescriptor);
 }
+type ContentDataActionResponse = Readonly<{
+    type: string;
+    title: string;
+    id?: string;
+    url?: string;
+    phone?: string;
+    index?: number;
+}>;
+type ContentDataTextResponse = Readonly<{
+    body: string;
+}>;
+type ContentDataMediaResponse = Readonly<{
+    body?: string;
+    media: string[];
+}>;
+type ContentDataLocationResponse = Readonly<{
+    longitude: number;
+    latitude: number;
+    label?: string;
+}>;
+type ContentDataQuickReplyResponse = Readonly<{
+    body: string;
+    actions: Readonly<{
+        title: string;
+        id?: string;
+    }>[];
+}>;
+type ContentDataCallToActionResponse = Readonly<{
+    body: string;
+    actions: ContentDataActionResponse[];
+}>;
+type ContentDataListPickerResponse = Readonly<{
+    body: string;
+    button: string;
+    items: Readonly<{
+        id: string;
+        item: string;
+        description?: string;
+    }>[];
+}>;
+type ContentDataCardResponse = Readonly<{
+    title: string;
+    subtitle?: string;
+    media?: string[];
+    actions?: ContentDataActionResponse[];
+}>;
+type ContentDataResponse = Readonly<{
+    "twilio/text"?: ContentDataTextResponse;
+    "twilio/media"?: ContentDataMediaResponse;
+    "twilio/location"?: ContentDataLocationResponse;
+    "twilio/quick-reply"?: ContentDataQuickReplyResponse;
+    "twilio/call-to-action"?: ContentDataCallToActionResponse;
+    "twilio/list-picker"?: ContentDataListPickerResponse;
+    "twilio/card"?: ContentDataCardResponse;
+}>;
+type ContentTemplateResponse = Readonly<{
+    sid: string;
+    account_sid: string;
+    friendly_name: string;
+    variables: string;
+    variants: ContentDataResponse;
+    date_created: string;
+    date_updated: string;
+}>;
+/**
+ * Shows a button that sends back a predefined text. Used in
+ * {@link ContentDataQuickReply}.
+ */
+type ContentDataReply = {
+    /**
+     * Display value of the action. This is the message that will be sent back
+     * when the user taps on the button.
+     */
+    readonly title: string;
+    /**
+     * Postback payload. This field is not visible to the end user.
+     */
+    readonly id?: string;
+};
+/**
+ * Shows a button that redirects recipient to a predefined URL.
+ */
+type ContentDataActionUrl = {
+    /**
+     * The type discriminant.
+     */
+    readonly type: "url";
+    /**
+     * Display value for the action.
+     */
+    readonly title: string;
+    /**
+     * URL to direct to when the recipient taps the button.
+     */
+    readonly url: string;
+    /**
+     * Full data as a stringified JSON. This could be used for future content
+     * types and fields which are not yet supported by the newest version of
+     * the Conversations SDK, or for using newer types in the older versions of
+     * the SDK.
+     */
+    readonly rawData: string;
+};
+/**
+ * Shows a button that calls a phone number.
+ */
+type ContentDataActionPhone = {
+    /**
+     * The type discriminant.
+     */
+    readonly type: "phone";
+    /**
+     * Display value for the action.
+     */
+    readonly title: string;
+    /**
+     * Phone number to call when the recipient taps the button.
+     */
+    readonly phone: string;
+    /**
+     * Full data as a stringified JSON. This could be used for future content
+     * types and fields which are not yet supported by the newest version of
+     * the Conversations SDK, or for using newer types in the older versions of
+     * the SDK.
+     */
+    readonly rawData: string;
+};
+/**
+ * Shows a button that sends back a predefined text.
+ */
+type ContentDataActionReply = {
+    /**
+     * The type discriminant.
+     */
+    readonly type: "reply";
+    /**
+     * Display value for the action. This is the message that will be sent back
+     * when the user taps on the button.
+     */
+    readonly title: string;
+    /**
+     * Postback payload. This field is not visible to the end user.
+     */
+    readonly id?: string;
+    /**
+     * Index for the action.
+     */
+    readonly index: number;
+    /**
+     * Full data as a stringified JSON. This could be used for future content
+     * types and fields which are not yet supported by the newest version of
+     * the Conversations SDK, or for using newer types in the older versions of
+     * the SDK.
+     */
+    readonly rawData: string;
+};
+/**
+ * Used for unknown action types which aren't present in the current version of
+ * the Conversations SDK.
+ */
+type ContentDataActionOther = {
+    /**
+     * The type discriminant.
+     */
+    readonly type: "other";
+    /**
+     * Full data as a stringified JSON. This could be used for future content
+     * types and fields which are not yet supported by the newest version of
+     * the Conversations SDK, or for using newer types in the older versions of
+     * the SDK.
+     */
+    readonly rawData: string;
+};
+/**
+ * A union of possible actions used in {@link ContentDataCallToAction} and
+ * {@link ContentDataCard}.
+ */
+type ContentDataAction = ContentDataActionUrl | ContentDataActionPhone | ContentDataActionReply | ContentDataActionOther;
+/**
+ * Represents an item in the {@link ContentDataListPicker}.
+ */
+type ContentDataListItem = {
+    /**
+     * Unique item identifier. Not visible to the recipient.
+     */
+    readonly id: string;
+    /**
+     * Display value of the item.
+     */
+    readonly item: string;
+    /**
+     * Description of the item.
+     */
+    readonly description?: string;
+};
+/**
+ * Contains only the plain text-based content. Represents the twilio/text
+ * content type.
+ */
+type ContentDataText = {
+    /**
+     * The type discriminant.
+     */
+    readonly type: "text";
+    /**
+     * The text of the message you want to send.
+     */
+    readonly body: string;
+    /**
+     * Full data as a stringified JSON. This could be used for future content
+     * types and fields which are not yet supported by the newest version of
+     * the Conversations SDK, or for using newer types in the older versions of
+     * the SDK.
+     */
+    readonly rawData: string;
+};
+/**
+ * Used to send file attachments, or to send long texts via MMS in the US and
+ * Canada. Represents the twilio/media content type.
+ */
+type ContentDataMedia = {
+    /**
+     * The type discriminant.
+     */
+    readonly type: "media";
+    /**
+     * The text of the message you want to send.
+     */
+    readonly body?: string;
+    /**
+     * URLs of the media you want to send.
+     */
+    readonly media: string[];
+    /**
+     * Full data as a stringified JSON. This could be used for future content
+     * types and fields which are not yet supported by the newest version of
+     * the Conversations SDK, or for using newer types in the older versions of
+     * the SDK.
+     */
+    readonly rawData: string;
+};
+/**
+ * Contains a location pin and an optional label, which can be used to enhance
+ * delivery notifications or connect recipients to physical experiences you
+ * offer. Represents the twilio/location content type.
+ */
+type ContentDataLocation = {
+    /**
+     * The type discriminant.
+     */
+    readonly type: "location";
+    /**
+     * The longitude value of the location pin you want to send.
+     */
+    readonly longitude: number;
+    /**
+     * The latitude value of the location pin you want to send.
+     */
+    readonly latitude: number;
+    /**
+     * The label to be displayed to the end user alongside the location pin.
+     */
+    readonly label?: string;
+    /**
+     * Full data as a stringified JSON. This could be used for future content
+     * types and fields which are not yet supported by the newest version of
+     * the Conversations SDK, or for using newer types in the older versions of
+     * the SDK.
+     */
+    readonly rawData: string;
+};
+/**
+ * Let recipients tap, rather than type, to respond to the message. Represents
+ * the twilio/quick-reply content type.
+ */
+type ContentDataQuickReply = {
+    /**
+     * The type discriminant.
+     */
+    readonly type: "quickReply";
+    /**
+     * The text of the message you want to send. This is included as a regular
+     * text message.
+     */
+    readonly body: string;
+    /**
+     * Up to 3 buttons can be created for quick reply. See
+     * {@link ContentDataReply}.
+     */
+    readonly replies: ContentDataReply[];
+    /**
+     * Full data as a stringified JSON. This could be used for future content
+     * types and fields which are not yet supported by the newest version of
+     * the Conversations SDK, or for using newer types in the older versions of
+     * the SDK.
+     */
+    readonly rawData: string;
+};
+/**
+ * Buttons that let recipients tap to trigger actions such as launching a
+ * website or making a phone call. Represents the twilio/call-to-action content
+ * type.
+ */
+type ContentDataCallToAction = {
+    /**
+     * The type discriminant.
+     */
+    readonly type: "callToAction";
+    /**
+     * The text of the message you want to send. This is included as a regular
+     * text message.
+     */
+    readonly body: string;
+    /**
+     * Buttons that recipients can tap on to act on the message.
+     */
+    readonly actions: ContentDataAction[];
+    /**
+     * Full data as a stringified JSON. This could be used for future content
+     * types and fields which are not yet supported by the newest version of
+     * the Conversations SDK, or for using newer types in the older versions of
+     * the SDK.
+     */
+    readonly rawData: string;
+};
+/**
+ * Shows a menu of up to 10 options, which offers a simple way for users to make
+ * a selection. Represents the twilio/list-picker content type.
+ */
+type ContentDataListPicker = {
+    /**
+     * The type discriminant.
+     */
+    readonly type: "listPicker";
+    /**
+     * The text of the message you want to send. This is rendered as the body of
+     * the message.
+     */
+    readonly body: string;
+    /**
+     * Display value of the primary button.
+     */
+    readonly button: string;
+    /**
+     * List item objects displayed in the list. See {@link ContentDataListItem}.
+     */
+    readonly items: ContentDataListItem[];
+    /**
+     * Full data as a stringified JSON. This could be used for future content
+     * types and fields which are not yet supported by the newest version of
+     * the Conversations SDK, or for using newer types in the older versions of
+     * the SDK.
+     */
+    readonly rawData: string;
+};
+/**
+ * Shows a menu of up to 10 options, which offers a simple way for users to make
+ * a selection. Represents the twilio/card content type.
+ */
+type ContentDataCard = {
+    /**
+     * The type discriminant.
+     */
+    readonly type: "card";
+    /**
+     * Title of the card.
+     */
+    readonly title: string;
+    /**
+     * Subtitle of the card.
+     */
+    readonly subtitle?: string;
+    /**
+     * URLs of the media to send with the message.
+     */
+    readonly media: string[];
+    /**
+     * Buttons that the recipients can tap on to act on the message.
+     */
+    readonly actions: ContentDataAction[];
+    /**
+     * Full data as a stringified JSON. This could be used for future content
+     * types and fields which are not yet supported by the newest version of
+     * the Conversations SDK, or for using newer types in the older versions of
+     * the SDK.
+     */
+    readonly rawData: string;
+};
+/**
+ * Used for unknown content types which aren't present in the current version of
+ * the Conversations SDK.
+ */
+type ContentDataOther = {
+    /**
+     * The type discriminant.
+     */
+    readonly type: "other";
+    /**
+     * Full data as a stringified JSON. This could be used for future content
+     * types and fields which are not yet supported by the newest version of
+     * the Conversations SDK, or for using newer types in the older versions of
+     * the SDK.
+     */
+    readonly rawData: string;
+};
+/**
+ * A union of possible data types in rich content templates.
+ */
+type ContentData = ContentDataText | ContentDataMedia | ContentDataLocation | ContentDataQuickReply | ContentDataCallToAction | ContentDataListPicker | ContentDataCard | ContentDataOther;
+/**
+ * Represents a variable for a content template. See
+ * {@link ContentTemplate.variables}.
+ */
+declare class ContentTemplateVariable {
+    readonly name: string;
+    readonly value: string;
+    constructor(/**
+     * Name of the variable.
+     */
+    name: string, /**
+     * Key of the variable
+     */
+    value: string);
+    /**
+     * Copies the variable with a new value.
+     *
+     * @param value The new value for the variable.
+     */
+    copyWithValue(value: string): ContentTemplateVariable;
+}
+/**
+ * A rich content template.
+ *
+ * Use {@link Client.getContentTemplates} to request all the templates available
+ * for the current account.
+ */
+declare class ContentTemplate {
+    /**
+     * The server-assigned unique identifier for the template.
+     */
+    readonly sid: string;
+    /**
+     * Friendly name used to describe the content. Not visible to the recipient.
+     */
+    readonly friendlyName: string;
+    /**
+     * Variables used by this template.
+     */
+    readonly variables: ContentTemplateVariable[];
+    /**
+     * Variants of the content. See {@link ContentData}.
+     */
+    readonly variants: Map<string, ContentData>;
+    /**
+     * Date of creation.
+     */
+    readonly dateCreated: Date;
+    /**
+     * Date of the last update.
+     */
+    readonly dateUpdated: Date;
+    /**
+     * @internal
+     */
+    constructor(contentTemplateResponse: ContentTemplateResponse);
+}
+type ChannelMetadataClientServices = {
+    commandExecutor: CommandExecutor;
+};
+/**
+ * Represents channel metadata.
+ */
+declare class ChannelMetadata {
+    /**
+     * Communication channel type.
+     */
+    readonly type: string;
+    /**
+     * The actual metadata.
+     */
+    readonly data: unknown;
+    /**
+     * @internal
+     */
+    constructor(type: string, data: unknown);
+}
+declare class ChannelMetadataClient {
+    private readonly _services;
+    private readonly _configuration;
+    private readonly _cache;
+    constructor(services: ChannelMetadataClientServices, configuration: Configuration);
+    getChannelMetadata(conversationSid: string, messageSid: string): Promise<ChannelMetadata | null>;
+}
 type MessageEvents = {
     updated: (data: {
         message: Message;
@@ -703,6 +1185,7 @@ interface MessageServices {
     mcsClient: McsClient;
     network: Network;
     commandExecutor: CommandExecutor;
+    channelMetadataClient: ChannelMetadataClient;
 }
 interface MessageLinks {
     self: string;
@@ -727,14 +1210,16 @@ interface MessageData {
     type?: MessageType;
     author: string | null;
     subject: string | null;
+    contentSid: string | null;
     lastUpdatedBy?: string | null;
     attributes?: JSONValue;
     dateUpdated: string;
     timestamp?: string;
-    medias?: Media[];
-    media?: Media;
+    medias: MediaState[] | null;
+    media: MediaState | null;
     memberSid?: string;
     delivery?: AggregatedDeliveryDescriptor;
+    channelMetadata?: boolean;
 }
 /**
  * A message in a conversation.
@@ -773,6 +1258,10 @@ declare class Message extends ReplayEventEmitter<MessageEvents> {
      * Message subject. Used only in email conversations.
      */
     get subject(): string | null;
+    /**
+     * Unique identifier of {@link ContentTemplate} for this message.
+     */
+    get contentSid(): string | null;
     /**
      * Body of the message.
      */
@@ -782,14 +1271,15 @@ declare class Message extends ReplayEventEmitter<MessageEvents> {
      */
     get dateUpdated(): Date | null;
     /**
-     * Index of the message in the conversation's messages list.
-     * By design of the Conversations system, the message indices may have arbitrary gaps between them,
+     * Index of this message in the conversation's list of messages.
+     *
+     * By design, the message indices may have arbitrary gaps between them,
      * that does not necessarily mean they were deleted or otherwise modified - just that
      * messages may have some non-contiguous indices even if they are being sent immediately one after another.
      *
      * Trying to use indices for some calculations is going to be unreliable.
      *
-     * To calculate the number of unread messages it is better to use the read horizon API.
+     * To calculate the number of unread messages, it is better to use the Read Horizon API.
      * See {@link Conversation.getUnreadMessagesCount} for details.
      */
     get index(): number;
@@ -809,11 +1299,6 @@ declare class Message extends ReplayEventEmitter<MessageEvents> {
      * Type of the message.
      */
     get type(): MessageType;
-    /**
-     * One of the attached media (if present).
-     * @deprecated Use attachedMedia instead. Note that the latter is now an array.
-     */
-    get media(): Media | null;
     /**
      * Return all media attachments, except email body/history attachments, without temporary urls.
      */
@@ -883,6 +1368,16 @@ declare class Message extends ReplayEventEmitter<MessageEvents> {
      */
     getTemporaryContentUrlsForAttachedMedia(): CancellablePromise<Map<string, string>>;
     private _getDetailedDeliveryReceiptsPaginator;
+    /**
+     * Get the {@link ContentData} for this message. Resolves to `null` when
+     * {@link Message.contentSid} is null.
+     */
+    getContentData(): CancellablePromise<ContentData | null>;
+    /**
+     * Get the {@link ChannelMetadata} for this message. Resolves to `null` if
+     * the message doesn't have any channel metadata.
+     */
+    getChannelMetadata(): Promise<ChannelMetadata | null>;
 }
 /**
  * Pagination helper interface.
@@ -1018,12 +1513,14 @@ interface MessageResponse {
     participant_sid: string;
     body: string;
     subject: string;
+    content_sid: string;
     date_created: string;
     date_updated: string;
     url: string;
     media: {
         sid: string;
         size: string;
+        category: string;
         content_type: string;
         filename: string;
     }[] | null;
@@ -1045,6 +1542,7 @@ interface MessagesServices {
     network: Network;
     syncClient: SyncClient;
     commandExecutor: CommandExecutor;
+    channelMetadataClient: ChannelMetadataClient;
 }
 /**
  * Represents the collection of messages in a conversation
@@ -1058,9 +1556,10 @@ declare class Messages extends ReplayEventEmitter<MessagesEvents> {
     constructor(conversation: Conversation, configuration: Configuration, services: MessagesServices);
     /**
      * Subscribe to the Messages Event Stream
-     * @param name - The name of Sync object for the Messages resource.
+     * @param arg - Name of the Sync object, or the SyncList itself, that
+     * represents the Messages resource.
      */
-    subscribe(name: string): Promise<SyncList>;
+    subscribe(arg: string | SyncList): Promise<SyncList>;
     unsubscribe(): Promise<void>;
     /**
      * Send a message to the conversation. The message could include text and multiple media attachments.
@@ -1092,7 +1591,7 @@ declare class Messages extends ReplayEventEmitter<MessagesEvents> {
      */
     getMessages(pageSize: number | undefined, anchor: number | "end" | undefined, direction?: "forward" | "backwards"): Promise<SyncPaginator<Message>>;
     private _wrapPaginator;
-    private _upsertMessage;
+    _upsertMessage(index: number, value: MessageData): Message;
     /**
      * Returns last messages from conversation
      * @param {Number} [pageSize] Number of messages to return in single chunk. By default it's 30.
@@ -1115,6 +1614,8 @@ declare class UnsentMessage {
         FormData | SendMediaOptions
     ][];
     emailOptions: SendEmailOptions;
+    contentSid?: string;
+    contentVariables?: ContentTemplateVariable[];
     /**
      * @internal
      */
@@ -1176,6 +1677,21 @@ declare class MessageBuilder {
      * @param history History payload in the selected format.
      */
     setEmailHistory(contentType: string, history: FormData | SendMediaOptions): MessageBuilder;
+    /**
+     * Adds {@link ContentTemplate} SID for the message alongside optional
+     * variables. When no variables provided, the default values will be used.
+     *
+     * Adding the content SID converts the message to a rich message. In this
+     * case, other fields are ignored and the message is sent using the content
+     * from the the {@link ContentTemplate}.
+     *
+     * Use {@link Client.getContentTemplates} to request all available
+     * {@link ContentTemplate}s.
+     *
+     * @param contentSid SID of the {@link ContentTemplate}
+     * @param variables Custom variables to resolve the template.
+     */
+    setContentTemplate(contentSid: string, contentVariables?: ContentTemplateVariable[]): MessageBuilder;
     /**
      * Adds media to the message.
      * @param payload Media to add.
@@ -1189,7 +1705,6 @@ declare class MessageBuilder {
      * Prepares a message and sends it to the conversation.
      */
     buildAndSend(): CancellablePromise<number | null>;
-    private getPayloadContentType;
 }
 /**
  * Conversation events.
@@ -1322,6 +1837,7 @@ interface ConversationServices {
     mcsClient: McsClient;
     syncClient: SyncClient;
     commandExecutor: CommandExecutor;
+    channelMetadataClient: ChannelMetadataClient;
 }
 /**
  * Conversation descriptor.
@@ -1489,10 +2005,18 @@ declare class Conversation extends ReplayEventEmitter<ConversationEvents> {
      * Messages entity.
      */
     private readonly _messagesEntity;
+    /**
+     * Sync list containing messages.
+     */
+    private _messagesList?;
     /**
      * Participants entity.
      */
     private readonly _participantsEntity;
+    /**
+     * Sync map containing participants.
+     */
+    private _participantsMap?;
     /**
      * Source of the most recent update.
      */
@@ -1663,7 +2187,7 @@ declare class Conversation extends ReplayEventEmitter<ConversationEvents> {
      */
     getMessagesCount(): Promise<number>;
     /**
-     * Get unread messages count for the user if they are a participant of this
+     * Get count of unread messages for the user if they are a participant of this
      * conversation. Rejects if the user is not a participant of the conversation.
      *
      * Use this method to obtain the number of unread messages together with
@@ -1671,12 +2195,19 @@ declare class Conversation extends ReplayEventEmitter<ConversationEvents> {
      * message indices which may have gaps. See {@link Message.index} for details.
      *
      * This method is semi-realtime. This means that this data will be eventually
-     * correct, but will also be possibly incorrect for a few seconds. The
+     * correct, but it will also be possibly incorrect for a few seconds. The
      * Conversations system does not provide real time events for counter values
      * changes.
      *
      * This is useful for any UI badges, but it is not recommended to build any
      * core application logic based on these counters being accurate in real time.
+     *
+     * If the read horizon is not set, this function will return null. This could mean
+     * that all messages in the conversation are unread, or that the read horizon system
+     * is not being used. How to interpret this `null` value is up to the customer application.
+     *
+     * @return Number of unread messages based on the current read horizon set for
+     * the user or `null` if the read horizon is not set.
      */
     getUnreadMessagesCount(): Promise<number | null>;
     /**
@@ -1702,10 +2233,10 @@ declare class Conversation extends ReplayEventEmitter<ConversationEvents> {
      * @param emailOptions Email options for the message.
      * @return Index of the new message.
      */
-    sendMessage(message: null | string | FormData | SendMediaOptions, messageAttributes?: JSONValue, emailOptions?: SendEmailOptions): Promise<number>;
+    sendMessage(message: null | string | FormData | SendMediaOptions, messageAttributes?: JSONValue, emailOptions?: SendEmailOptions): Promise<Message>;
     /**
      * New interface to prepare for sending a message.
-     * Use this instead of {@link Message.sendMessage}.
+     * Use this instead of {@link Conversation.sendMessage}.
      * @return A MessageBuilder to help set all message sending options.
      */
     prepareMessage(): MessageBuilder;
@@ -1717,7 +2248,7 @@ declare class Conversation extends ReplayEventEmitter<ConversationEvents> {
     setAllMessagesRead(): Promise<number>;
     /**
      * Set all messages in the conversation unread.
-     * @return Resulting unread messages count in the conversation.
+     * @returns New count of unread messages after this update.
      */
     setAllMessagesUnread(): Promise<number>;
     /**
@@ -1746,7 +2277,7 @@ declare class Conversation extends ReplayEventEmitter<ConversationEvents> {
      * Set the last read message index to the current read horizon.
      * @param index Message index to set as last read. If null is provided, then
      * the behavior is identical to {@link Conversation.setAllMessagesUnread}.
-     * @returns Resulting unread messages count in the conversation.
+     * @returns New count of unread messages after this update.
      */
     updateLastReadMessageIndex(index: number | null): Promise<number>;
     /**
@@ -1762,6 +2293,16 @@ declare class Conversation extends ReplayEventEmitter<ConversationEvents> {
      * @internal
      */
     _subscribe(): Promise<SyncDocument>;
+    /**
+     * Fetch participants and messages of the conversation. This method needs to
+     * be called during conversation initialization to catch broken conversations
+     * (broken conversations are conversations that have essential Sync entities
+     * missing, i.e. the conversation document, the messages list or the
+     * participant map). In case of this conversation being broken, the method
+     * will throw an exception that will be caught and handled gracefully.
+     * @internal
+     */
+    _fetchStreams(): Promise<void>;
     /**
      * Load the attributes of this conversation and instantiate its participants
      * and messages. This or _subscribe will need to be called before any events
@@ -1799,6 +2340,9 @@ declare class Conversation extends ReplayEventEmitter<ConversationEvents> {
     private _setLastReadMessageIndex;
 }
 type ConversationsDataSource = "sync" | "rest";
+/**
+ * Type of a push notification.
+ */
 type PushNotificationType = "twilio.conversations.new_message" | "twilio.conversations.added_to_conversation" | "twilio.conversations.removed_from_conversation";
 interface PushNotificationDescriptor {
     title: string | null;
@@ -1910,11 +2454,11 @@ type ClientEvents = {
         user: User;
         updateReasons: UserUpdateReason[];
     }) => void;
-    stateChanged: ({ state, error }: {
-        state: State;
+    initialized: () => void;
+    initFailed: ({ error }: {
         error?: ConnectionError;
     }) => void;
-    connectionStateChanged: (state: TwilsockConnectionState) => void;
+    connectionStateChanged: (state: ConnectionState) => void;
     connectionError: (data: ConnectionError) => void;
 };
 /**
@@ -1927,7 +2471,7 @@ type ClientEvents = {
  * * `'denied'` - client connection is denied because of invalid JWT access
  * token. User must refresh token in order to proceed
  */
-type ConnectionState = TwilsockConnectionState;
+type ConnectionState = "disconnected" | "connecting" | "connected";
 /**
  * State of the client. Possible values are as follows:
  * * `'failed'` - the client failed to initialize
@@ -1952,10 +2496,14 @@ interface ClientOptions {
      * The level of logging to enable.
      */
     logLevel?: LogLevel;
+    /**
+     * The cache capacity for channel metadata.
+     */
+    channelMetadataCacheCapacity?: number;
     region?: string;
     productId?: string;
     twilsockClient?: TwilsockClient;
-    transport?: Transport;
+    transport?: TwilsockClient;
     notificationsClient?: NotificationClient;
     syncClient?: SyncClient;
     typingIndicatorTimeoutOverride?: number;
@@ -1970,11 +2518,14 @@ interface ClientOptions {
     Notification?: Record<string, unknown>;
     Twilsock?: Record<string, unknown>;
     clientMetadata?: Record<string, unknown>;
-    initRegistrations?: InitRegistration[];
     disableDeepClone?: boolean;
     typingUri?: string;
     apiUri?: string;
 }
+type ConnectionError = {
+    terminal: boolean;
+    message: string;
+};
 /**
  * Options for {@link Client.createConversation}.
  */
@@ -2167,16 +2718,20 @@ declare class Client extends ReplayEventEmitter<ClientEvents> {
      */
     static readonly userUpdated = "userUpdated";
     /**
-     * Fired when the state of the client has been changed.
+     * Fired when the client has completed initialization successfully.
+     * @event
+     */
+    static readonly initialized = "initialized";
+    /**
+     * Fired when the client initialization failed.
      *
      * Parameters:
      * 1. object `data` - info object provided with the event. It has the
-     * following properties:
-     *     * {@link State} `state` - the new client state
+     * following property:
      *     * Error? `error` - the initialization error if present
      * @event
      */
-    static readonly stateChanged = "stateChanged";
+    static readonly initFailed = "initFailed";
     /**
      * Fired when the connection state of the client has been changed.
      *
@@ -2221,7 +2776,7 @@ declare class Client extends ReplayEventEmitter<ClientEvents> {
     /**
      * Client connection state.
      */
-    connectionState: ConnectionState;
+    connectionState: ConnectionState | "unknown";
     /**
      * Promise that resolves on successful initialization.
      */
@@ -2285,26 +2840,6 @@ declare class Client extends ReplayEventEmitter<ClientEvents> {
      * initialization was completed.
      */
     get reachabilityEnabled(): boolean;
-    /**
-     * @deprecated Call constructor directly.
-     *
-     * Factory method to create a Conversations client instance.
-     *
-     * The factory method will automatically trigger connection.
-     * Do not use it if you need finer-grained control.
-     *
-     * Since this method returns an already-initialized client, some of the events
-     * will be lost because they happen *before* the initialization. It is
-     * recommended that `client.onWithReplay` is used as opposed to `client.on`
-     * for subscribing to client events. The `client.onWithReplay` will re-emit
-     * the most recent value for a given event if it emitted before the
-     * subscription.
-     *
-     * @param token Access token.
-     * @param options Options to customize the client.
-     * @returns Returns a fully initialized client.
-     */
-    static create(token: string, options?: ClientOptions | null): Promise<Client>;
     /**
      * Static method for push notification payload parsing. Returns parsed push as
      * a {@link PushNotification} object.
@@ -2316,11 +2851,6 @@ declare class Client extends ReplayEventEmitter<ClientEvents> {
      * @param data Data to parse
      */
     private static _parsePushNotificationChatData;
-    /**
-     * Populate the client with init registrations.
-     * @param reg The init registration to populate.
-     */
-    static populateInitRegistrations(reg: InitRegistration): void;
     /**
      * Gracefully shut down the client.
      */
@@ -2363,12 +2893,6 @@ declare class Client extends ReplayEventEmitter<ClientEvents> {
      * on the platform.
      */
     setPushRegistrationId(channelType: NotificationsChannelType, registrationId: string): Promise<void>;
-    /**
-     * Unregister from push notifications.
-     * @param channelType Channel type.
-     * @deprecated Use removePushRegistrations() instead.
-     */
-    unsetPushRegistrationId(channelType: NotificationsChannelType): Promise<void>;
     /**
      * Clear existing registrations directly using provided device token.
      * This is useful to ensure stopped subscriptions without resubscribing.
@@ -2417,6 +2941,11 @@ declare class Client extends ReplayEventEmitter<ClientEvents> {
      * @param contentSet Set of media attachments to query content URLs.
      */
     getTemporaryContentUrlsForMedia(contentSet: Media[]): CancellablePromise<Map<string, string>>;
+    /**
+     * Returns rich content templates belonging to the account. Rich content
+     * templates can be created via the Twilio console or the REST API.
+     */
+    getContentTemplates(): Promise<Readonly<ContentTemplate[]>>;
     /**
      * Initialize the client.
      */
@@ -2426,11 +2955,6 @@ declare class Client extends ReplayEventEmitter<ClientEvents> {
      * @param channelType The channel type to subscribe to.
      */
     private _subscribeToPushNotifications;
-    /**
-     * Unsubscribe from push notifications.
-     * @param channelType The channel type to unsubscribe from.
-     */
-    private _unsubscribeFromPushNotifications;
 }
 declare class NotificationTypes {
     static readonly TYPING_INDICATOR = "twilio.ipmsg.typing_indicator";
@@ -2440,4 +2964,7 @@ declare class NotificationTypes {
     static readonly REMOVED_FROM_CONVERSATION = "twilio.conversations.removed_from_conversation";
     static readonly CONSUMPTION_UPDATE = "twilio.channel.consumption_update";
 }
-export { Conversation, ConversationBindings, ConversationEmailBinding, ConversationUpdateReason, ConversationStatus, NotificationLevel, ConversationState, ConversationUpdatedEventArgs, SendMediaOptions, SendEmailOptions, LastMessage, Participant, ParticipantUpdateReason, ParticipantType, ParticipantUpdatedEventArgs, ParticipantBindings, ParticipantEmailBinding, ParticipantEmailLevel, Message, MessageUpdateReason, MessageType, MessageUpdatedEventArgs, Media, MediaCategory$0 as MediaCategory, AggregatedDeliveryReceipt, DeliveryAmount, DetailedDeliveryReceipt, DeliveryStatus, RestPaginator, MessageBuilder, UnsentMessage, Paginator, ParticipantBindingOptions, User, UserUpdateReason, UserUpdatedEventArgs, PushNotification, PushNotificationType, PushNotificationDescriptor, PushNotificationData, NotificationTypes, Client, State, ConnectionState, NotificationsChannelType, ClientOptions, CreateConversationOptions, ConversationLimits, JSONValue, JSONObject, JSONArray, CancellablePromise };
+export { Conversation, ConversationBindings, ConversationEmailBinding, ConversationUpdateReason, ConversationStatus, NotificationLevel, ConversationState, ConversationUpdatedEventArgs, SendMediaOptions, SendEmailOptions, LastMessage, Participant, ParticipantUpdateReason, ParticipantType, ParticipantUpdatedEventArgs, ParticipantBindings, ParticipantEmailBinding, ParticipantEmailLevel, Message, MessageUpdateReason, MessageType, MessageUpdatedEventArgs, Media, AggregatedDeliveryReceipt, DeliveryAmount, DetailedDeliveryReceipt, DeliveryStatus, RestPaginator, MessageBuilder, UnsentMessage, Paginator, ParticipantBindingOptions, User, UserUpdateReason, UserUpdatedEventArgs, PushNotification, PushNotificationType, PushNotificationDescriptor, PushNotificationData, NotificationTypes, Client, State, ConnectionState, NotificationsChannelType, ClientOptions, CreateConversationOptions, ConversationLimits, CancellablePromise$0 as CancellablePromise, CancellationError, ContentDataActionUrl, ContentDataActionPhone, ContentDataActionReply, ContentDataActionOther, ContentDataAction, ContentDataText, ContentDataMedia, ContentDataLocation, ContentDataReply, ContentDataQuickReply, ContentDataCallToAction, ContentDataListPicker, ContentDataListItem, ContentDataCard, ContentDataOther, ContentData, ContentTemplate, ContentTemplateVariable, ChannelMetadata, LogLevel };
+export { JSONValue, JSONObject, JSONArray } from "@twilio/shared";
+export { MediaCategory } from "@twilio/mcs-client";
+export { ChannelType } from "@twilio/notifications";