@twilio/conversations 3.0.0-rc.1 → 3.0.0-rc.7

package/builds/lib.d.ts

@@ -1,6 +1,6 @@
 import { SyncClient, SyncDocument, SyncList } from "twilio-sync";
 import { LogLevelDesc } from "loglevel";
-import { Transport, TwilsockClient, InitRegistration, TransportResult } from "twilsock";
+import { Transport, TwilsockClient, InitRegistration, ConnectionError, TransportResult } from "twilsock";
 import { ConnectionState as TwilsockConnectionState } from "twilsock";
 import { ReplayEventEmitter } from "@twilio/replay-event-emitter";
 import { ChannelType, Notifications } from "@twilio/notifications";
@@ -301,7 +301,7 @@ declare class Users extends ReplayEventEmitter<UsersEvents> {
      * if not - then subscribes and adds user to the FIFO stack
      * @returns {Promise<User>} Fully initialized user
      */
-    getUser(identity?: string, entityName?: string): Promise<User>;
+    getUser(identity: string, entityName?: string): Promise<User>;
     /**
      * @returns {Promise<Array<User>>} returns list of subscribed User objects {@see User}
      */
@@ -326,9 +326,9 @@ interface ParticipantDescriptor {
     identity: string;
     roleSid?: string;
     lastConsumedMessageIndex: number | null;
-    lastConsumptionTimestamp: number;
+    lastConsumptionTimestamp: number | null;
     type: ParticipantType;
-    userInfo: string;
+    userInfo?: string;
     bindings?: ParticipantBindings;
 }
 interface ParticipantServices {
@@ -490,26 +490,6 @@ declare class Participant extends ReplayEventEmitter<ParticipantEvents> {
      */
     updateAttributes(attributes: JSONValue): Promise<Participant>;
 }
-interface ParticipantResponse {
-    account_sid: string;
-    chat_service_sid: string;
-    conversation_sid: string;
-    role_sid: string;
-    sid: string;
-    attributes: string;
-    date_created: string;
-    date_updated: string;
-    identity: string | null;
-    messaging_binding: {
-        type: string;
-        address: string;
-        proxy_address: string;
-    } | null;
-    url: string;
-    links: {
-        conversation: string;
-    };
-}
 interface ParticipantBindingOptions {
     email?: ParticipantEmailBinding;
 }
@@ -892,7 +872,7 @@ declare class Message extends ReplayEventEmitter<MessageEvents> {
      * Get content URLs for all media attachments in the given set using a single operation.
      * @param contentSet Set of media attachments to query content URLs.
      */
-    getTemporaryContentUrlsForMedia(contentSet: Media[] | null): CancellablePromise<Map<string, string>>;
+    getTemporaryContentUrlsForMedia(contentSet: Media[]): CancellablePromise<Map<string, string>>;
     /**
      * Get content URLs for all media attachments in the given set of media sids using a single operation.
      * @param mediaSids Set of media sids to query for the content URL.
@@ -958,7 +938,7 @@ declare class TypingIndicator {
     private sentUpdates;
     private getConversation;
     private serviceTypingTimeout;
-    constructor(getConversation: any, config: Configuration, services: TypingIndicatorServices);
+    constructor(getConversation: (conversationSid: string) => Promise<Conversation>, config: Configuration, services: TypingIndicatorServices);
     get typingTimeout(): number;
     /**
      * Initialize TypingIndicator controller
@@ -1130,7 +1110,10 @@ declare class UnsentMessage {
     private messagesEntity;
     text?: string;
     attributes: JSONValue;
-    mediaContent: [MediaCategory, FormData | SendMediaOptions][];
+    mediaContent: [
+        MediaCategory,
+        FormData | SendMediaOptions
+    ][];
     emailOptions: SendEmailOptions;
     /**
      * @internal
@@ -1208,6 +1191,9 @@ declare class MessageBuilder {
     buildAndSend(): CancellablePromise<number | null>;
     private getPayloadContentType;
 }
+/**
+ * Conversation events.
+ */
 type ConversationEvents = {
     participantJoined: (participant: Participant) => void;
     participantLeft: (participant: Participant) => void;
@@ -1229,55 +1215,28 @@ type ConversationEvents = {
     }) => void;
     removed: (conversation: Conversation) => void;
 };
-interface ConversationServices {
-    users: Users;
-    typingIndicator: TypingIndicator;
-    network: Network;
-    mcsClient: McsClient;
-    syncClient: SyncClient;
-    commandExecutor: CommandExecutor;
-}
-interface ConversationDescriptor {
-    channel: string;
-    entityName: string;
-    uniqueName: string;
-    attributes: JSONValue;
-    createdBy?: string;
-    friendlyName?: string;
-    lastConsumedMessageIndex: number;
-    dateCreated: Date | null;
-    dateUpdated: Date | null;
-    notificationLevel?: NotificationLevel;
-    bindings?: ConversationBindings;
-}
-interface ConversationLinks {
-    self: string;
-    messages: string;
-    participants: string;
-}
 /**
- * The reason for the `updated` event being emitted by a conversation.
+ * Reason for the `updated` event emission by a conversation.
  */
 type ConversationUpdateReason = "attributes" | "createdBy" | "dateCreated" | "dateUpdated" | "friendlyName" | "lastReadMessageIndex" | "state" | "status" | "uniqueName" | "lastMessage" | "notificationLevel" | "bindings";
 /**
- * The status of the conversation, relative to the client: whether
- * the conversation has been `joined` or the client is
- * `notParticipating` in the conversation.
+ * Status of the conversation, relative to the client: whether the conversation
+ * has been `joined` or the client is `notParticipating` in the conversation.
  */
 type ConversationStatus = "notParticipating" | "joined";
 /**
- * The user's notification level for the conversation. Determines
+ * User's notification level for the conversation. Determines
  * whether the currently logged-in user will receive pushes for events
  * in this conversation. Can be either `muted` or `default`, where
  * `default` defers to the global service push configuration.
  */
 type NotificationLevel = "default" | "muted";
 /**
- * The state of the conversation.
+ * State of the conversation.
  */
 interface ConversationState {
     /**
-     * The current state.
+     * Current state.
      */
     current: "active" | "inactive" | "closed";
     /**
@@ -1285,6 +1244,9 @@ interface ConversationState {
      */
     dateUpdated: Date;
 }
+/**
+ * Event arguments for the `updated` event.
+ */
 interface ConversationUpdatedEventArgs {
     conversation: Conversation;
     updateReasons: ConversationUpdateReason[];
@@ -1303,6 +1265,9 @@ interface ConversationEmailBinding {
     name?: string;
     projected_address: string;
 }
+/**
+ * Binding for SMS conversation.
+ */
 interface ConversationSmsBinding {
     address?: string;
 }
@@ -1348,33 +1313,51 @@ interface LastMessage {
     dateCreated?: Date;
 }
 /**
- * A conversation represents communication between multiple Conversations clients
+ * Conversation services.
+ */
+interface ConversationServices {
+    users: Users;
+    typingIndicator: TypingIndicator;
+    network: Network;
+    mcsClient: McsClient;
+    syncClient: SyncClient;
+    commandExecutor: CommandExecutor;
+}
+/**
+ * Conversation descriptor.
+ */
+interface ConversationDescriptor {
+    channel: string;
+    entityName: string;
+    uniqueName: string;
+    attributes: JSONValue;
+    createdBy?: string;
+    friendlyName?: string;
+    lastConsumedMessageIndex: number;
+    dateCreated: Date | null;
+    dateUpdated: Date | null;
+    notificationLevel?: NotificationLevel;
+    bindings?: ConversationBindings;
+}
+/**
+ * Conversation links.
+ */
+interface ConversationLinks {
+    self: string;
+    messages: string;
+    participants: string;
+}
+/**
+ * A conversation represents communication between multiple Conversations
+ * clients.
  */
 declare class Conversation extends ReplayEventEmitter<ConversationEvents> {
-    /**
-     * Unique system identifier of the conversation.
-     */
-    readonly sid: string;
-    readonly links: ConversationLinks;
-    private readonly configuration;
-    private readonly services;
-    private channelState;
-    private statusSource;
-    private entityPromise;
-    private entityName;
-    private entity;
-    private messagesEntity;
-    private participantsEntity;
-    private readonly participants;
-    /**
-     * @internal
-     */
-    constructor(descriptor: ConversationDescriptor, sid: string, links: ConversationLinks, configuration: Configuration, services: ConversationServices);
     /**
      * Fired when a participant has joined the conversation.
      *
      * Parameters:
-     * 1. {@link Participant} `participant` - participant that joined the conversation
+     * 1. {@link Participant} `participant` - participant that joined the
+     * conversation
      * @event
      */
     static readonly participantJoined = "participantJoined";
@@ -1382,7 +1365,8 @@ declare class Conversation extends ReplayEventEmitter<ConversationEvents> {
      * Fired when a participant has left the conversation.
      *
      * Parameters:
-     * 1. {@link Participant} `participant` - participant that left the conversation
+     * 1. {@link Participant} `participant` - participant that left the
+     * conversation
      * @event
      */
     static readonly participantLeft = "participantLeft";
@@ -1390,9 +1374,12 @@ declare class Conversation extends ReplayEventEmitter<ConversationEvents> {
      * Fired when data of a participant has been updated.
      *
      * Parameters:
-     * 1. object `data` - info object provided with the event. It has the following properties:
-     *     * {@link Participant} `participant` - participant that has received the update
-     *     * {@link ParticipantUpdateReason}[] `updateReasons` - array of reasons for update
+     * 1. object `data` - info object provided with the event. It has the
+     * following properties:
+     *     * {@link Participant} `participant` - participant that has received the
+     *     update
+     *     * {@link ParticipantUpdateReason}[] `updateReasons` - array of reasons
+     *     for the update
      * @event
      */
     static readonly participantUpdated = "participantUpdated";
@@ -1416,9 +1403,11 @@ declare class Conversation extends ReplayEventEmitter<ConversationEvents> {
      * Fired when data of a message has been updated.
      *
      * Parameters:
-     * 1. object `data` - info object provided with the event. It has the following properties:
+     * 1. object `data` - info object provided with the event. It has the
+     * following properties:
      *     * {@link Message} `message` - message that has received the update
-     *     * {@link MessageUpdateReason}[] `updateReasons` - array of reasons for update
+     *     * {@link MessageUpdateReason}[] `updateReasons` - array of reasons for
+     *     the update
      * @event
      */
     static readonly messageUpdated = "messageUpdated";
@@ -1426,7 +1415,8 @@ declare class Conversation extends ReplayEventEmitter<ConversationEvents> {
      * Fired when a participant has stopped typing.
      *
      * Parameters:
-     * 1. {@link Participant} `participant` - the participant that has stopped typing
+     * 1. {@link Participant} `participant` - the participant that has stopped
+     * typing
      * @event
      */
     static readonly typingEnded = "typingEnded";
@@ -1434,7 +1424,8 @@ declare class Conversation extends ReplayEventEmitter<ConversationEvents> {
      * Fired when a participant has started typing.
      *
      * Parameters:
-     * 1. {@link Participant} `participant` - the participant that has started typing
+     * 1. {@link Participant} `participant` - the participant that has started
+     * typing
      * @event
      */
     static readonly typingStarted = "typingStarted";
@@ -1442,20 +1433,87 @@ declare class Conversation extends ReplayEventEmitter<ConversationEvents> {
      * Fired when the data of the conversation has been updated.
      *
      * Parameters:
-     * 1. object `data` - info object provided with the event. It has the following properties:
-     *     * {@link Conversation} `conversation` - conversation that has received the update
-     *     * {@link ConversationUpdateReason}[] `updateReasons` - array of reasons for update
+     * 1. object `data` - info object provided with the event. It has the
+     * following properties:
+     *     * {@link Conversation} `conversation` - conversation that has received
+     *     the update
+     *     * {@link ConversationUpdateReason}[] `updateReasons` - array of reasons
+     *     for the update
      * @event
      */
     static readonly updated = "updated";
     /**
-     * Fired when the conversation was destroyed or the currently-logged-in user has left private conversation.
+     * Fired when the conversation was destroyed or the currently-logged-in user
+     * has left private conversation.
      *
      * Parameters:
      * 1. {@link Conversation} `conversation` - conversation that has been removed
      * @event
      */
     static readonly removed = "removed";
+    /**
+     * Logger instance.
+     */
+    private static readonly _logger;
+    /**
+     * Unique system identifier of the conversation.
+     */
+    readonly sid: string;
+    /**
+     * Conversation links for REST requests.
+     * @internal
+     */
+    readonly _links: ConversationLinks;
+    /**
+     * Map of participants.
+     * @internal
+     */
+    readonly _participants: Map<string, Participant>;
+    /**
+     * Configuration of the client that the conversation belongs to.
+     */
+    private readonly _configuration;
+    /**
+     * Conversation service objects.
+     */
+    private readonly _services;
+    /**
+     * Internal state of the conversation.
+     */
+    private readonly _internalState;
+    /**
+     * Name of the conversation entity document.
+     */
+    private readonly _entityName;
+    /**
+     * Messages entity.
+     */
+    private readonly _messagesEntity;
+    /**
+     * Participants entity.
+     */
+    private readonly _participantsEntity;
+    /**
+     * Source of the most recent update.
+     */
+    private _dataSource;
+    /**
+     * Promise for the conversation entity document.
+     */
+    private _entityPromise;
+    /**
+     * Conversation entity document.
+     */
+    private _entity;
+    /**
+     * @param descriptor Conversation descriptor.
+     * @param sid Conversation SID.
+     * @param links Conversation links for REST requests.
+     * @param configuration Client configuration.
+     * @param services Conversation services.
+     * @internal
+     */
+    constructor(descriptor: ConversationDescriptor, sid: string, links: ConversationLinks, configuration: Configuration, services: ConversationServices);
     /**
      * Unique name of the conversation.
      */
@@ -1496,6 +1554,10 @@ declare class Conversation extends ReplayEventEmitter<ConversationEvents> {
      * User notification level for this conversation.
      */
     get notificationLevel(): NotificationLevel;
+    /**
+     * Conversation bindings. Undocumented feature (for now).
+     * @internal
+     */
     get bindings(): ConversationBindings;
     /**
      * Current conversation limits.
@@ -1506,65 +1568,38 @@ declare class Conversation extends ReplayEventEmitter<ConversationEvents> {
      */
     get state(): ConversationState | undefined;
     /**
-     * Load and subscribe to this conversation and do not subscribe to its participants and messages.
-     * This or _subscribeStreams will need to be called before any events on conversation will fire.
+     * Source of the conversation update.
      * @internal
      */
-    _subscribe(): Promise<void | SyncDocument>;
+    get _statusSource(): ConversationsDataSource;
     /**
-     * Load the attributes of this conversation and instantiate its participants and messages.
-     * This or _subscribe will need to be called before any events on the conversation will fire.
-     * This will need to be called before any events on participants or messages will fire
-     * @internal
+     * Preprocess the update object.
+     * @param update The update object received from Sync.
+     * @param conversationSid The SID of the conversation in question.
      */
-    _subscribeStreams(): Promise<void>;
-    /**
-     * Stop listening for and firing events on this conversation.
-     * @internal
-     */
-    _unsubscribe(): Promise<[
-        void,
-        void
-    ]>;
-    /**
-     * Set conversation status.
-     * @internal
-     */
-    _setStatus(status: ConversationStatus, source: ConversationsDataSource): void;
-    /**
-     * Get the source of the conversation update.
-     * @internal
-     */
-    _statusSource(): ConversationsDataSource;
     private static preprocessUpdate;
-    /**
-     * Update the local conversation object with new values.
-     * @internal
-     */
-    _update(update: any): void;
-    /**
-     * @internal
-     */
-    private _onMessageAdded;
-    private _setLastReadMessageIndex;
     /**
      * Add a participant to the conversation by its identity.
      * @param identity Identity of the Client to add.
      * @param attributes Attributes to be attached to the participant.
+     * @returns The added participant.
      */
-    add(identity: string, attributes?: JSONValue): Promise<ParticipantResponse>;
+    add(identity: string, attributes?: JSONValue): Promise<Participant>;
     /**
      * Add a non-chat participant to the conversation.
      * @param proxyAddress Proxy (Twilio) address of the participant.
      * @param address User address of the participant.
      * @param attributes Attributes to be attached to the participant.
-     * @param bindingOptions Options for adding email participants - name and CC/To level.
+     * @param bindingOptions Options for adding email participants - name and
+     * CC/To level.
+     * @returns The added participant.
      */
-    addNonChatParticipant(proxyAddress: string, address: string, attributes?: JSONValue, bindingOptions?: ParticipantBindingOptions): Promise<ParticipantResponse>;
+    addNonChatParticipant(proxyAddress: string, address: string, attributes?: JSONValue, bindingOptions?: ParticipantBindingOptions): Promise<Participant>;
     /**
-     * Advance the conversation's last read message index to the current read horizon.
-     * Rejects if the user is not a participant of the conversation.
-     * Last read message index is updated only if the new index value is higher than the previous.
+     * Advance the conversation's last read message index to the current read
+     * horizon. Rejects if the user is not a participant of the conversation. Last
+     * read message index is updated only if the new index value is higher than
+     * the previous.
      * @param index Message index to advance to.
      * @return Resulting unread messages count in the conversation.
      */
@@ -1579,10 +1614,13 @@ declare class Conversation extends ReplayEventEmitter<ConversationEvents> {
     getAttributes(): Promise<JSONValue>;
     /**
      * Returns messages from the conversation using the paginator interface.
-     * @param pageSize Number of messages to return in a single chunk. Default is 30.
-     * @param anchor Index of the newest message to fetch. Default is from the end.
-     * @param direction Query direction. By default it queries backwards
-     * from newer to older. The `"forward"` value will query in the opposite direction.
+     * @param pageSize Number of messages to return in a single chunk. Default is
+     * 30.
+     * @param anchor Index of the newest message to fetch. Default is from the
+     * end.
+     * @param direction Query direction. By default, it queries backwards
+     * from newer to older. The `"forward"` value will query in the opposite
+     * direction.
      * @return A page of messages.
      */
     getMessages(pageSize?: number, anchor?: number, direction?: "backwards" | "forward"): Promise<Paginator<Message>>;
@@ -1593,12 +1631,13 @@ declare class Conversation extends ReplayEventEmitter<ConversationEvents> {
     /**
      * Get conversation participants count.
      *
-     * 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 Conversations system does not
-     * provide real time events for counter values changes.
+     * 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
+     * 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.
+     * 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.
      */
     getParticipantsCount(): Promise<number>;
     /**
@@ -1614,28 +1653,30 @@ declare class Conversation extends ReplayEventEmitter<ConversationEvents> {
     /**
      * Get the total message count in the conversation.
      *
-     * 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 Conversations system does not
-     * provide real time events for counter values changes.
+     * 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
+     * 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.
+     * 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.
      */
     getMessagesCount(): Promise<number>;
     /**
-     * Get unread messages count for the user if they are a participant of this conversation.
-     * Rejects if the user is not a participant of the conversation.
+     * Get unread messages count 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
      * {@link Conversation.updateLastReadMessageIndex} instead of relying on the
      * 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 Conversations system does not
-     * provide real time events for counter values changes.
+     * 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
+     * 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.
+     * 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.
      */
     getUnreadMessagesCount(): Promise<number | null>;
     /**
@@ -1651,13 +1692,12 @@ declare class Conversation extends ReplayEventEmitter<ConversationEvents> {
      * argument, it will assume that the string is an identity or SID.
      * @param participant Identity, SID or the participant object to remove.
      */
-    /* eslint-disable @typescript-eslint/ban-ts-comment */
-    // @ts-ignore TODO: fix validateTypesAsync typing
     removeParticipant(participant: string | Participant): Promise<void>;
     /**
      * Send a message to the conversation.
      * @param message Message body for the text message,
-     * `FormData` or {@link SendMediaOptions} for media content. Sending FormData is supported only with the browser engine.
+     * `FormData` or {@link SendMediaOptions} for media content. Sending FormData
+     * is supported only with the browser engine.
      * @param messageAttributes Attributes for the message.
      * @param emailOptions Email options for the message.
      * @return Index of the new message.
@@ -1665,12 +1705,13 @@ declare class Conversation extends ReplayEventEmitter<ConversationEvents> {
     sendMessage(message: null | string | FormData | SendMediaOptions, messageAttributes?: JSONValue, emailOptions?: SendEmailOptions): Promise<number>;
     /**
      * New interface to prepare for sending a message.
-     * Use instead of `sendMessage`.
+     * Use this instead of {@link Message.sendMessage}.
      * @return A MessageBuilder to help set all message sending options.
      */
     prepareMessage(): MessageBuilder;
     /**
-     * Set last read message index of the conversation to the index of the last known message.
+     * Set last read message index of the conversation to the index of the last
+     * known message.
      * @return Resulting unread messages count in the conversation.
      */
     setAllMessagesRead(): Promise<number>;
@@ -1685,8 +1726,10 @@ declare class Conversation extends ReplayEventEmitter<ConversationEvents> {
      */
     setUserNotificationLevel(notificationLevel: NotificationLevel): Promise<void>;
     /**
-     * Send a notification to the server indicating that this client is currently typing in this conversation.
-     * Typing ended notification is sent after a while automatically, but by calling this method again you ensure that typing ended is not received.
+     * Send a notification to the server indicating that this client is currently
+     * typing in this conversation. Typing ended notification is sent after a
+     * while automatically, but by calling this method again you ensure that
+     * typing ended is not received.
      */
     typing(): Promise<void>;
     /**
@@ -1701,21 +1744,61 @@ declare class Conversation extends ReplayEventEmitter<ConversationEvents> {
     updateFriendlyName(friendlyName: string): Promise<Conversation>;
     /**
      * 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}.
+     * @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.
      */
     updateLastReadMessageIndex(index: number | null): Promise<number>;
     /**
      * Update the unique name of the conversation.
-     * @param uniqueName New unique name for the conversation. Setting unique name to null removes it.
+     * @param uniqueName New unique name for the conversation. Setting unique name
+     * to null removes it.
      */
     updateUniqueName(uniqueName: string | null): Promise<Conversation>;
+    /**
+     * Load and subscribe to this conversation and do not subscribe to its
+     * participants and messages. This or _subscribeStreams will need to be called
+     * before any events on conversation will fire.
+     * @internal
+     */
+    _subscribe(): Promise<SyncDocument>;
+    /**
+     * Load the attributes of this conversation and instantiate its participants
+     * and messages. This or _subscribe will need to be called before any events
+     * on the conversation will fire. This will need to be called before any
+     * events on participants or messages will fire
+     * @internal
+     */
+    _subscribeStreams(): Promise<void>;
+    /**
+     * Stop listening for and firing events on this conversation.
+     * @internal
+     */
+    _unsubscribe(): Promise<[
+        void,
+        void
+    ]>;
+    /**
+     * Set conversation status.
+     * @internal
+     */
+    _setStatus(status: ConversationStatus, source: ConversationsDataSource): void;
+    /**
+     * Update the local conversation object with new values.
+     * @internal
+     */
+    _update(update: any): void;
+    /**
+     * Handle onMessageAdded event.
+     */
+    private _onMessageAdded;
+    /**
+     * Set last read message index.
+     * @param index New index to set.
+     */
+    private _setLastReadMessageIndex;
 }
-type ConversationsDataSource = "sync" | "chat" | "rest";
-/**
- * Push notification type.
- */
+type ConversationsDataSource = "sync" | "rest";
 type PushNotificationType = "twilio.conversations.new_message" | "twilio.conversations.added_to_conversation" | "twilio.conversations.removed_from_conversation";
 interface PushNotificationDescriptor {
     title: string | null;
@@ -1734,6 +1817,10 @@ interface PushNotificationData {
      * SID of the conversation.
      */
     conversationSid?: string;
+    /**
+     * Title of the conversation.
+     */
+    conversationTitle?: string;
     /**
      * Index of the message in the conversation.
      */
@@ -1742,6 +1829,14 @@ interface PushNotificationData {
      * SID of the message in the conversation.
      */
     messageSid?: string;
+    /**
+     * Media of the notification
+     */
+    media?: Media;
+    /**
+     * Amount of the attached media of the message.
+     */
+    mediaCount?: number;
 }
 /**
  * Push notification for a Conversations client.
@@ -1804,7 +1899,7 @@ type ClientEvents = {
         message: Message;
         updateReasons: MessageUpdateReason[];
     }) => void;
-    tokenAboutToExpire: (ttl: number) => void;
+    tokenAboutToExpire: () => void;
     tokenExpired: () => void;
     typingEnded: (participant: Participant) => void;
     typingStarted: (participant: Participant) => void;
@@ -1817,15 +1912,10 @@ type ClientEvents = {
     }) => void;
     stateChanged: ({ state, error }: {
         state: State;
-        error?: Error;
+        error?: ConnectionError;
     }) => void;
     connectionStateChanged: (state: TwilsockConnectionState) => void;
-    connectionError: (data: {
-        terminal: boolean;
-        message: string;
-        httpStatusCode?: number;
-        errorCode?: number;
-    }) => void;
+    connectionError: (data: ConnectionError) => void;
 };
 /**
  * Connection state of the client. Possible values are as follows:
@@ -2013,8 +2103,6 @@ declare class Client extends ReplayEventEmitter<ClientEvents> {
     static readonly messageUpdated = "messageUpdated";
     /**
      * Fired when the token is about to expire and needs to be updated.
-     * * Parameters:
-     * 1. number `message` - token's time to live
      * @event
      */
     static readonly tokenAboutToExpire = "tokenAboutToExpire";
@@ -2169,7 +2257,7 @@ declare class Client extends ReplayEventEmitter<ClientEvents> {
     /**
      * The Conversations entity.
      */
-    private _conversations;
+    private _conversationsEntity;
     /**
      * Promise that resolves when initial conversations are fetched.
      */
@@ -2352,4 +2440,4 @@ 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 };
+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 };