@twilio/conversations 2.0.1 → 2.1.0-rc.6

package/builds/lib.d.ts

@@ -1,6 +1,6 @@
-/// <reference types="node" />
-import { SyncClient } from "twilio-sync";
-import { Transport, TwilsockClient, InitRegistration } from "twilsock";
+import { SyncClient, SyncDocument, SyncList } from "twilio-sync";
+import { LogLevelDesc } from "loglevel";
+import { Transport, TwilsockClient, InitRegistration, TransportResult } from "twilsock";
 import { ConnectionState as TwilsockConnectionState } from "twilsock";
 import { ReplayEventEmitter } from "@twilio/replay-event-emitter";
 import { ChannelType, Notifications } from "@twilio/notifications";
@@ -42,8 +42,8 @@ declare class Logger {
     private prefix;
     private constructor();
     static scope(prefix: string): Logger;
-    setLevel(level: any): void;
-    static setLevel(level: any): void;
+    setLevel(level: LogLevelDesc): void;
+    static setLevel(level: LogLevelDesc): void;
     trace(...args: any[]): void;
     debug(...args: any[]): void;
     info(...args: any[]): void;
@@ -55,7 +55,7 @@ declare class Logger {
     static warn(...args: any[]): void;
     static error(...args: any[]): void;
 }
-interface Limits {
+interface ConversationLimits {
     mediaAttachmentsCountLimit: number;
     mediaAttachmentSizeLimitInMb: number;
     mediaAttachmentsTotalSizeLimitInMb: number;
@@ -78,7 +78,7 @@ declare class Configuration {
         mediaSetService: string;
         messagesReceipts: string;
     };
-    readonly limits: Limits;
+    readonly limits: ConversationLimits;
     readonly productId?: string;
     readonly typingIndicatorTimeoutOverride?: number;
     readonly typingIndicatorTimeoutDefault: number;
@@ -91,7 +91,7 @@ declare class Configuration {
     readonly userIdentity: string;
     readonly userInfo: string;
     readonly myConversations: string;
-    constructor(options: Record<string, any>, configurationResponse: ConfigurationResponse, logger: Logger);
+    constructor(options: ClientOptions, configurationResponse: ConfigurationResponse, logger: Logger);
 }
 interface CommandExecutorServices {
     transport: Transport;
@@ -106,6 +106,20 @@ declare class CommandExecutor {
     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>;
 }
+/**
+ * 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;
@@ -181,25 +195,29 @@ declare class User extends ReplayEventEmitter<UserEvents> {
     /**
      * Custom attributes of the user.
      */
-    get attributes(): any;
+    get attributes(): JSONValue;
     /**
      * Friendly name of the user, null if not set.
      */
-    get friendlyName(): string;
+    get friendlyName(): string | null;
     /**
      * Status of the real-time conversation connection of the user.
      */
-    get isOnline(): boolean;
+    get isOnline(): boolean | null;
     /**
      * User push notification registration status.
      */
-    get isNotifiable(): boolean;
+    get isNotifiable(): boolean | null;
     /**
      * True if this user is receiving real-time status updates.
      */
     get isSubscribed(): boolean;
     // Handles service updates
-    _update(key: string, value: any): Promise<void>;
+    _update(key: string, value: {
+        value: string;
+        notifiable: boolean | null;
+        online: boolean | null;
+    }): Promise<void>;
     // Fetch reachability info
     private _updateReachabilityInfo;
     // Fetch user
@@ -209,7 +227,7 @@ declare class User extends ReplayEventEmitter<UserEvents> {
      * Edit user attributes.
      * @param attributes New attributes.
      */
-    updateAttributes(attributes: any): Promise<User>;
+    updateAttributes(attributes: JSONValue): Promise<User>;
     /**
      * Update the friendly name of the user.
      * @param friendlyName New friendly name.
@@ -233,7 +251,7 @@ declare class Network {
     private cleanupCache;
     pokeTimer(): void;
     private executeWithRetry;
-    get(url: string): Promise<any>;
+    get<T>(url: string): Promise<TransportResult<T>>;
 }
 type UsersEvents = {
     userUpdated: (data: {
@@ -265,7 +283,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}
      */
@@ -284,15 +302,16 @@ type ParticipantEvents = {
     }) => void;
 };
 interface ParticipantDescriptor {
-    attributes?: Object;
-    dateCreated: any;
-    dateUpdated: any;
+    attributes?: JSONValue;
+    dateCreated: Date | null;
+    dateUpdated: Date | null;
     identity: string;
     roleSid?: string;
-    lastConsumedMessageIndex: number;
+    lastConsumedMessageIndex: number | null;
     lastConsumptionTimestamp: number;
     type: ParticipantType;
     userInfo: string;
+    bindings?: ParticipantBindings;
 }
 interface ParticipantServices {
     users: Users;
@@ -304,15 +323,35 @@ interface ParticipantLinks {
 /**
  * The reason for the `updated` event being emitted by a participant.
  */
-type ParticipantUpdateReason = "attributes" | "dateCreated" | "dateUpdated" | "roleSid" | "lastReadMessageIndex" | "lastReadTimestamp";
+type ParticipantUpdateReason = "attributes" | "dateCreated" | "dateUpdated" | "roleSid" | "lastReadMessageIndex" | "lastReadTimestamp" | "bindings";
 /**
  * Type of a participant.
  */
-type ParticipantType = "chat" | "sms" | "whatsapp";
+type ParticipantType = "chat" | "sms" | "whatsapp" | "email";
 interface ParticipantUpdatedEventArgs {
     participant: Participant;
     updateReasons: ParticipantUpdateReason[];
 }
+/**
+ * Bindings for conversation participant.
+ */
+interface ParticipantBindings {
+    email?: ParticipantEmailBinding;
+}
+/**
+ * Email participation level.
+ * to = to/from
+ * cc = cc
+ */
+type ParticipantEmailLevel = "to" | "cc";
+/**
+ * Bindings for email participant.
+ */
+interface ParticipantEmailBinding {
+    name: string;
+    address: string;
+    level: ParticipantEmailLevel;
+}
 /**
  * A participant represents a remote client in a conversation.
  */
@@ -331,19 +370,19 @@ declare class Participant extends ReplayEventEmitter<ParticipantEvents> {
     /**
      * Custom attributes of the participant.
      */
-    get attributes(): Object;
+    get attributes(): JSONValue;
     /**
      * Date this participant was created on.
      */
-    get dateCreated(): Date;
+    get dateCreated(): Date | null;
     /**
      * Date this participant was last updated on.
      */
-    get dateUpdated(): Date;
+    get dateUpdated(): Date | null;
     /**
      * Identity of the participant.
      */
-    get identity(): string;
+    get identity(): string | null;
     /**
      * Indicates whether the participant is currently typing.
      */
@@ -358,12 +397,22 @@ declare class Participant extends ReplayEventEmitter<ParticipantEvents> {
     /**
      * Date of the most recent read horizon update.
      */
-    get lastReadTimestamp(): Date;
+    get lastReadTimestamp(): Date | null;
     get roleSid(): string;
     /**
-     * Message type of the participant.
+     * Type of the participant.
      */
     get type(): ParticipantType;
+    /**
+     * Get the bindings mapping for the current participant.
+     * Available binding depends on the participant type.
+     * You could access it as `participant.bindings.sms?.address` or
+     * 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.
+     */
+    get bindings(): ParticipantBindings;
     /**
      * @internal
      */
@@ -421,7 +470,30 @@ declare class Participant extends ReplayEventEmitter<ParticipantEvents> {
      * Update the attributes of the participant.
      * @param attributes New attributes.
      */
-    updateAttributes(attributes: any): Promise<Participant>;
+    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;
 }
 /**
  * Category of media. Possible values are as follows:
@@ -433,7 +505,7 @@ type MediaCategory$0 = McsMediaCategory;
 interface MediaState {
     sid: string;
     category: MediaCategory$0;
-    filename?: string;
+    filename: string | null;
     contentType: string;
     size: number;
 }
@@ -458,7 +530,7 @@ declare class Media {
     /**
      * File name. Null if absent.
      */
-    get filename(): string;
+    get filename(): string | null;
     /**
      * Content type of the media.
      */
@@ -478,7 +550,7 @@ declare class Media {
      * If the URL becomes expired, you need to request a new one.
      * Each call to this function produces a new temporary URL.
      */
-    getContentTemporaryUrl(): Promise<string>;
+    getContentTemporaryUrl(): Promise<string | null>;
     /**
      * Returns cached direct content URL for the media.
      *
@@ -488,7 +560,7 @@ declare class Media {
      *
      * @returns {Promise<String>}
      */
-    getCachedTemporaryUrl(): Promise<string>;
+    getCachedTemporaryUrl(): Promise<string | null>;
     private _fetchMcsMedia;
 }
 /**
@@ -583,7 +655,7 @@ interface DetailedDeliveryReceiptDescriptor {
     channel_message_sid: string;
     participant_sid: string;
     status: DeliveryStatus;
-    error_code: number | null;
+    error_code: string | null;
     date_created: string;
     date_updated: string;
 }
@@ -619,7 +691,7 @@ declare class DetailedDeliveryReceipt {
      * Numeric error code mapped from Status callback code. Information about the error codes can be found
      * [here](https://www.twilio.com/docs/sms/api/message-resource#delivery-related-errors).
      */
-    errorCode: number | null;
+    errorCode: string | 0;
     /**
      * Date this delivery receipt was created on.
      */
@@ -661,6 +733,21 @@ interface MessageUpdatedEventArgs {
     message: Message;
     updateReasons: MessageUpdateReason[];
 }
+interface MessageData {
+    sid: string;
+    text?: string;
+    type?: MessageType;
+    author: string | null;
+    subject: string | null;
+    lastUpdatedBy?: string | null;
+    attributes?: JSONValue;
+    dateUpdated: string;
+    timestamp?: string;
+    medias?: Media[];
+    media?: Media;
+    memberSid?: string;
+    delivery?: AggregatedDeliveryDescriptor;
+}
 /**
  * A message in a conversation.
  */
@@ -676,7 +763,7 @@ declare class Message extends ReplayEventEmitter<MessageEvents> {
     /**
      * @internal
      */
-    constructor(index: number, data: any, conversation: Conversation, links: MessageLinks, configuration: Configuration, services: MessageServices);
+    constructor(index: number, data: MessageData, conversation: Conversation, links: MessageLinks, configuration: Configuration, services: MessageServices);
     /**
      * Fired when the properties or the body of the message has been updated.
      *
@@ -693,7 +780,7 @@ declare class Message extends ReplayEventEmitter<MessageEvents> {
     /**
      * Name of the user that sent the message.
      */
-    get author(): string;
+    get author(): string | null;
     /**
      * Message subject. Used only in email conversations.
      */
@@ -701,11 +788,11 @@ declare class Message extends ReplayEventEmitter<MessageEvents> {
     /**
      * Body of the message.
      */
-    get body(): string;
+    get body(): string | null;
     /**
      * Date this message was last updated on.
      */
-    get dateUpdated(): Date;
+    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,
@@ -721,24 +808,24 @@ declare class Message extends ReplayEventEmitter<MessageEvents> {
     /**
      * Identity of the last user that updated the message.
      */
-    get lastUpdatedBy(): string;
+    get lastUpdatedBy(): string | null;
     /**
      * Date this message was created on.
      */
-    get dateCreated(): Date;
+    get dateCreated(): Date | null;
     /**
      * Custom attributes of the message.
      */
-    get attributes(): Object;
+    get attributes(): JSONValue;
     /**
-     * Push notification type of the message.
+     * Type of the message.
      */
     get type(): MessageType;
     /**
-     * One of the attached media.
+     * One of the attached media (if present).
      * @deprecated Use attachedMedia instead. Note that the latter is now an array.
      */
-    get media(): Media;
+    get media(): Media | null;
     /**
      * Return all media attachments, except email body/history attachments, without temporary urls.
      */
@@ -746,7 +833,7 @@ declare class Message extends ReplayEventEmitter<MessageEvents> {
     /**
      * The server-assigned unique identifier of the authoring participant.
      */
-    get participantSid(): string;
+    get participantSid(): string | null;
     /**
      * Aggregated information about the message delivery statuses across all participants of a conversation..
      */
@@ -758,6 +845,18 @@ declare class Message extends ReplayEventEmitter<MessageEvents> {
      * @returns Array of media descriptors matching given categories.
      */
     getMediaByCategory(categories: Array<MediaCategory>): Array<Media> | null;
+    /**
+     * Get a media descriptor for an email body attachment of a provided type.
+     * Allowed body types are returned in the Conversation.limits().emailBodiesAllowedMimeTypes array.
+     * @param type Type of email body to request, defaults to `text/plain`.
+     */
+    getEmailBody(type?: string): Media | null;
+    /**
+     * Get a media descriptor for an email history attachment of a provided type.
+     * Allowed body types are returned in the Conversation.limits().emailHistoriesAllowedMimeTypes array.
+     * @param type Type of email history to request, defaults to `text/plain`.
+     */
+    getEmailHistory(type?: string): Media | null;
     _update(data: any): void;
     /**
      * Get the participant who is the author of the message.
@@ -780,12 +879,12 @@ declare class Message extends ReplayEventEmitter<MessageEvents> {
      * Edit the message attributes.
      * @param attributes New attributes.
      */
-    updateAttributes(attributes: any): Promise<Message>;
+    updateAttributes(attributes: JSONValue): Promise<Message>;
     /**
      * Get content URLs for all media attachments in the given set using single operation.
      * @param contentSet Set of media attachments to query for content URL.
      */
-    attachTemporaryUrlsFor(contentSet: Media[]): Promise<Media[]>;
+    attachTemporaryUrlsFor(contentSet: Media[] | null): Promise<Media[]>;
     private _getDetailedDeliveryReceiptsPaginator;
 }
 /**
@@ -867,9 +966,9 @@ declare class TypingIndicator {
 declare class UnsentMessage {
     private messagesEntity;
     text?: string;
-    attributes: any;
+    attributes: JSONValue;
     mediaContent: [MediaCategory, FormData | SendMediaOptions][];
-    emailOptions?: SendEmailOptions;
+    emailOptions: SendEmailOptions;
     /**
      * @internal
      */
@@ -878,7 +977,154 @@ declare class UnsentMessage {
      * Send the prepared message to the conversation.
      * @returns Index of the new message in the conversation.
      */
-    send(): Promise<number>;
+    send(): Promise<number | null>;
+}
+/**
+ * Pagination helper class.
+ */
+declare class RestPaginator<T> implements Paginator<T> {
+    private state;
+    /**
+     * Indicates the existence of the next page.
+     */
+    get hasNextPage(): boolean;
+    /**
+     * Indicates the existence of the previous page
+     */
+    get hasPrevPage(): boolean;
+    /**
+     * Array of elements on the current page.
+     */
+    get items(): T[];
+    /**
+     * @internal
+     */
+    constructor(items: any, source: any, prevToken: any, nextToken: any);
+    /**
+     * Request the next page. Does not modify the existing object.
+     */
+    nextPage(): Promise<RestPaginator<T>>;
+    /**
+     * Request the previous page. Does not modify the existing object.
+     */
+    prevPage(): Promise<RestPaginator<T>>;
+}
+/**
+ * @classdesc Pagination helper class for Sync
+ *
+ * @property {Array} items Array of elements on current page
+ * @property {boolean} hasNextPage
+ * @property {boolean} hasPrevPage
+ */
+declare class SyncPaginator<T> implements Paginator<T> {
+    private state;
+    hasNextPage: boolean;
+    hasPrevPage: boolean;
+    get items(): T[];
+    /**
+     * @param {Array} items Array of element for current page
+     * @param {Object} params
+     */
+    constructor(items: any, pageSize: any, anchor: any, direction: any, source: any);
+    nextPage(): Promise<RestPaginator<T>>;
+    prevPage(): Promise<SyncPaginator<T> | RestPaginator<T>>;
+}
+interface MessageResponse {
+    account_sid: string;
+    chat_service_sid: string;
+    conversation_sid: string;
+    sid: string;
+    index: number;
+    attributes: string;
+    author: string;
+    participant_sid: string;
+    body: string;
+    subject: string;
+    date_created: string;
+    date_updated: string;
+    url: string;
+    media: {
+        sid: string;
+        size: string;
+        content_type: string;
+        filename: string;
+    }[] | null;
+    links: {
+        conversation: string;
+        messages_receipts: string;
+    };
+}
+type MessagesEvents = {
+    messageAdded: (message: Message) => void;
+    messageRemoved: (message: Message) => void;
+    messageUpdated: (data: {
+        message: Message;
+        updateReasons: MessageUpdateReason[];
+    }) => void;
+};
+interface MessagesServices {
+    mcsClient: McsClient;
+    network: Network;
+    syncClient: SyncClient;
+    commandExecutor: CommandExecutor;
+}
+/**
+ * Represents the collection of messages in a conversation
+ */
+declare class Messages extends ReplayEventEmitter<MessagesEvents> {
+    readonly conversation: Conversation;
+    private readonly configuration;
+    private readonly services;
+    private readonly messagesByIndex;
+    private messagesListPromise;
+    constructor(conversation: Conversation, configuration: Configuration, services: MessagesServices);
+    /**
+     * Subscribe to the Messages Event Stream
+     * @param name - The name of Sync object for the Messages resource.
+     */
+    subscribe(name: string): Promise<SyncList>;
+    unsubscribe(): Promise<void>;
+    /**
+     * Send Message to the conversation, message could include both text and multiple media attachments.
+     * @param message Message to post
+     * @returns Returns a promise which can fail
+     */
+    sendV2(message: UnsentMessage): Promise<MessageResponse>;
+    /**
+     * Send Message to the conversation
+     * @param message Message to post
+     * @param attributes Message attributes
+     * @param emailOptions Options that modify E-mail integration behaviors.
+     * @returns Returns promise which can fail
+     */
+    send(message: null | string | FormData | SendMediaOptions, attributes?: JSONValue, emailOptions?: SendEmailOptions): Promise<MessageResponse>;
+    /**
+     * Send Media Message to the conversation
+     * @param mediaContent Media content to post
+     * @param attributes Message attributes
+     * @param emailOptions Email options
+     * @returns Returns promise which can fail
+     */
+    sendMedia(mediaContent: FormData | SendMediaOptions, attributes?: JSONValue, emailOptions?: SendEmailOptions): Promise<MessageResponse>;
+    /**
+     * Returns messages from conversation using paginator interface
+     * @param pageSize Number of messages to return in single chunk. By default it's 30.
+     * @param anchor Most early message id which is already known, or 'end' by default
+     * @param direction Pagination order 'backwards' or 'forward', 'forward' by default
+     * @returns Last page of messages by default
+     */
+    getMessages(pageSize: number | undefined, anchor: number | "end" | undefined, direction?: "forward" | "backwards"): Promise<SyncPaginator<Message>>;
+    private _wrapPaginator;
+    private _upsertMessage;
+    /**
+     * Returns last messages from conversation
+     * @param {Number} [pageSize] Number of messages to return in single chunk. By default it's 30.
+     * @param {String} [anchor] Most early message id which is already known, or 'end' by default
+     * @param {String} [direction] Pagination order 'backwards' or 'forward', or 'forward' by default
+     * @returns {Promise<SyncPaginator<Message>>} last page of messages by default
+     * @private
+     */
+    private _getMessages;
 }
 /**
  * Message builder. Allows the message to be built and sent via method chaining.
@@ -898,10 +1144,12 @@ declare class UnsentMessage {
 declare class MessageBuilder {
     private readonly limits;
     private readonly message;
+    private emailBodies;
+    private emailHistories;
     /**
      * @internal
      */
-    constructor(limits: Limits, messagesEntity: any);
+    constructor(limits: ConversationLimits, messagesEntity: Messages);
     /**
      * Sets the message body.
      * @param text Contents of the body.
@@ -916,7 +1164,19 @@ declare class MessageBuilder {
      * Sets the message attributes.
      * @param attributes Message attributes.
      */
-    setAttributes(attributes: any): MessageBuilder;
+    setAttributes(attributes: JSONValue): MessageBuilder;
+    /**
+     * Set email body with given MIME-type.
+     * @param mimeType Format of the body to set (text/plain or text/html).
+     * @param body Body payload in selected format.
+     */
+    setEmailBody(mimeType: string, body: FormData | SendMediaOptions): MessageBuilder;
+    /**
+     * Set email history with given MIME-type.
+     * @param mimeType Format of the history to set (text/plain or text/html).
+     * @param history History payload in selected format.
+     */
+    setEmailHistory(mimeType: string, history: FormData | SendMediaOptions): MessageBuilder;
     /**
      * Adds media to the message.
      * @param payload Media to add.
@@ -961,13 +1221,14 @@ interface ConversationDescriptor {
     channel: string;
     entityName: string;
     uniqueName: string;
-    attributes: any;
+    attributes: JSONValue;
     createdBy?: string;
     friendlyName?: string;
     lastConsumedMessageIndex: number;
-    dateCreated: any;
-    dateUpdated: any;
+    dateCreated: Date | null;
+    dateUpdated: Date | null;
     notificationLevel?: NotificationLevel;
+    bindings?: ConversationBindings;
 }
 interface ConversationLinks {
     self: string;
@@ -977,7 +1238,7 @@ interface ConversationLinks {
 /**
  * The reason for the `updated` event being emitted by a conversation.
  */
-type ConversationUpdateReason = "attributes" | "createdBy" | "dateCreated" | "dateUpdated" | "friendlyName" | "lastReadMessageIndex" | "state" | "status" | "uniqueName" | "lastMessage" | "notificationLevel";
+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
@@ -1008,6 +1269,23 @@ interface ConversationUpdatedEventArgs {
     conversation: Conversation;
     updateReasons: ConversationUpdateReason[];
 }
+/**
+ * Binding for email conversation.
+ */
+interface ConversationBindings {
+    email?: ConversationEmailBinding;
+    sms?: ConversationSmsBinding;
+}
+/**
+ * Binding for email conversation.
+ */
+interface ConversationEmailBinding {
+    name?: string;
+    projected_address: string;
+}
+interface ConversationSmsBinding {
+    address?: string;
+}
 /**
  * Configuration for attaching a media file to a message.
  * These options can be passed to {@link Conversation.sendMessage} and
@@ -1017,7 +1295,7 @@ interface SendMediaOptions {
     /**
      * Content type of media.
      */
-    contentType: string;
+    contentType: null | string;
     /**
      * Optional filename.
      */
@@ -1025,7 +1303,7 @@ interface SendMediaOptions {
     /**
      * Content to post.
      */
-    media: string | Buffer | Blob;
+    media: null | string | Buffer | Blob;
 }
 /**
  * These options can be passed to {@link Conversation.sendMessage}.
@@ -1161,7 +1439,7 @@ declare class Conversation extends ReplayEventEmitter<ConversationEvents> {
     /**
      * Unique name of the conversation.
      */
-    get uniqueName(): string;
+    get uniqueName(): string | null;
     /**
      * Status of the conversation.
      */
@@ -1169,15 +1447,15 @@ declare class Conversation extends ReplayEventEmitter<ConversationEvents> {
     /**
      * Name of the conversation.
      */
-    get friendlyName(): string;
+    get friendlyName(): string | null;
     /**
      * Date this conversation was last updated on.
      */
-    get dateUpdated(): any;
+    get dateUpdated(): Date | null;
     /**
      * Date this conversation was created on.
      */
-    get dateCreated(): any;
+    get dateCreated(): Date | null;
     /**
      * Identity of the user that created this conversation.
      */
@@ -1185,7 +1463,7 @@ declare class Conversation extends ReplayEventEmitter<ConversationEvents> {
     /**
      * Custom attributes of the conversation.
      */
-    get attributes(): any;
+    get attributes(): JSONValue;
     /**
      * Index of the last message the user has read in this conversation.
      */
@@ -1193,12 +1471,13 @@ declare class Conversation extends ReplayEventEmitter<ConversationEvents> {
     /**
      * Last message sent to this conversation.
      */
-    get lastMessage(): LastMessage;
+    get lastMessage(): LastMessage | undefined;
     /**
      * User notification level for this conversation.
      */
     get notificationLevel(): NotificationLevel;
-    get limits(): Limits;
+    get bindings(): ConversationBindings;
+    get limits(): ConversationLimits;
     /**
      * State of the conversation.
      */
@@ -1208,7 +1487,7 @@ declare class Conversation extends ReplayEventEmitter<ConversationEvents> {
      * This or _subscribeStreams will need to be called before any events on conversation will fire.
      * @internal
      */
-    _subscribe(): Promise<any>;
+    _subscribe(): Promise<void | 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.
@@ -1222,7 +1501,7 @@ declare class Conversation extends ReplayEventEmitter<ConversationEvents> {
      */
     _unsubscribe(): Promise<[
         void,
-        any
+        void
     ]>;
     /**
      * Set conversation status.
@@ -1250,14 +1529,15 @@ declare class Conversation extends ReplayEventEmitter<ConversationEvents> {
      * @param identity Identity of the Client to add.
      * @param attributes Attributes to be attached to the participant.
      */
-    add(identity: string, attributes?: any): Promise<void>;
+    add(identity: string, attributes?: JSONValue): Promise<ParticipantResponse>;
     /**
      * 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.
      */
-    addNonChatParticipant(proxyAddress: string, address: string, attributes?: any): Promise<void>;
+    addNonChatParticipant(proxyAddress: string, address: string, attributes?: JSONValue, bindingOptions?: ParticipantBindingOptions): Promise<ParticipantResponse>;
     /**
      * Advance the conversation's last read message index to the current read horizon.
      * Rejects if the user is not a participant of the conversation.
@@ -1273,7 +1553,7 @@ declare class Conversation extends ReplayEventEmitter<ConversationEvents> {
     /**
      * Get the custom attributes of this Conversation.
      */
-    getAttributes(): Promise<any>;
+    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.
@@ -1302,12 +1582,12 @@ declare class Conversation extends ReplayEventEmitter<ConversationEvents> {
      * Get a participant by its SID.
      * @param participantSid Participant SID.
      */
-    getParticipantBySid(participantSid: string): Promise<Participant>;
+    getParticipantBySid(participantSid: string): Promise<Participant | null>;
     /**
      * Get a participant by its identity.
      * @param identity Participant identity.
      */
-    getParticipantByIdentity(identity: string): Promise<Participant>;
+    getParticipantByIdentity(identity?: string | null): Promise<Participant | null>;
     /**
      * Get the total message count in the conversation.
      *
@@ -1348,6 +1628,8 @@ 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.
@@ -1357,10 +1639,11 @@ declare class Conversation extends ReplayEventEmitter<ConversationEvents> {
      * @param emailOptions Email options for the message.
      * @return Index of the new message.
      */
-    sendMessage(message: string | FormData | SendMediaOptions | null, messageAttributes?: any, emailOptions?: SendEmailOptions): Promise<number>;
+    sendMessage(message: null | string | FormData | SendMediaOptions, messageAttributes?: JSONValue, emailOptions?: SendEmailOptions): Promise<number>;
     /**
      * New interface to prepare for sending a message.
      * Use instead of `sendMessage`.
+     * @return A MessageBuilder to help set all message sending options.
      */
     prepareMessage(): MessageBuilder;
     /**
@@ -1387,7 +1670,7 @@ declare class Conversation extends ReplayEventEmitter<ConversationEvents> {
      * Update the attributes of the conversation.
      * @param attributes New attributes.
      */
-    updateAttributes(attributes: any): Promise<Conversation>;
+    updateAttributes(attributes: JSONValue): Promise<Conversation>;
     /**
      * Update the friendly name of the conversation.
      * @param friendlyName New friendly name.
@@ -1412,13 +1695,13 @@ type ConversationsDataSource = "sync" | "chat" | "rest";
  */
 type PushNotificationType = "twilio.conversations.new_message" | "twilio.conversations.added_to_conversation" | "twilio.conversations.removed_from_conversation";
 interface PushNotificationDescriptor {
-    title: string;
-    body: string;
-    sound: string;
-    badge: number;
-    action: string;
+    title: string | null;
+    body: string | null;
+    sound: string | null;
+    badge: number | null;
+    action: string | null;
     type: PushNotificationType;
-    data: Object;
+    data: Record<string, unknown>;
 }
 /**
  * Additional data for a given push notification.
@@ -1444,23 +1727,23 @@ declare class PushNotification {
     /**
      * Title of the notification.
      */
-    readonly title: string;
+    readonly title: string | null;
     /**
      * Text of the notification.
      */
-    readonly body: string;
+    readonly body: string | null;
     /**
      * Sound of the notification.
      */
-    readonly sound: string;
+    readonly sound: string | null;
     /**
      * Number of the badge.
      */
-    readonly badge: number;
+    readonly badge: number | null;
     /**
      * Notification action (`click_action` in FCM terms and `category` in APN terms).
      */
-    readonly action: string;
+    readonly action: string | null;
     /**
      * Type of the notification.
      */
@@ -1536,7 +1819,7 @@ type State = "failed" | "initialized";
  * * `'apn'`
  */
 type NotificationsChannelType = ChannelType;
-type LogLevel = "trace" | "debug" | "info" | "warn" | "error" | "silent" | null;
+type LogLevel = "trace" | "debug" | "info" | "warn" | "error" | "silent";
 /**
  * Conversations client options.
  */
@@ -1556,15 +1839,17 @@ interface ClientOptions {
     httpCacheIntervalOverride?: string;
     userInfosToSubscribeOverride?: number;
     retryWhenThrottledOverride?: boolean;
-    backoffConfigOverride?: any;
-    Chat?: any;
-    IPMessaging?: any;
-    Sync?: any;
-    Notification?: any;
-    Twilsock?: any;
-    clientMetadata?: any;
+    backoffConfigOverride?: Record<string, unknown>;
+    Chat?: ClientOptions;
+    IPMessaging?: ClientOptions;
+    Sync?: Record<string, unknown>;
+    Notification?: Record<string, unknown>;
+    Twilsock?: Record<string, unknown>;
+    clientMetadata?: Record<string, unknown>;
     initRegistrations?: InitRegistration[];
     disableDeepClone?: boolean;
+    typingUri?: string;
+    apiUri?: string;
 }
 /**
  * Options for {@link Client.createConversation}.
@@ -1573,7 +1858,7 @@ interface CreateConversationOptions {
     /**
      * Any custom attributes to attach to the conversation.
      */
-    attributes?: any;
+    attributes?: JSONValue;
     /**
      * A non-unique display name of the conversation.
      */
@@ -1620,7 +1905,7 @@ declare class Client extends ReplayEventEmitter<ClientEvents> {
      * @param options Options to customize the Client
      * @returns A not yet fully-initialized client.
      */
-    constructor(fpaToken: string, options?: ClientOptions);
+    constructor(fpaToken: string, options?: ClientOptions | null);
     static populateInitRegistrations(reg: InitRegistration): void;
     /**
      * Fired when a conversation becomes visible to the client. The event is also triggered when the client creates a new conversation.
@@ -1828,7 +2113,7 @@ declare class Client extends ReplayEventEmitter<ClientEvents> {
      * @param options Options to customize the client.
      * @returns Returns a fully initialized client.
      */
-    static create(token: string, options?: ClientOptions): Promise<Client>;
+    static create(token: string, options?: ClientOptions | null): Promise<Client>;
     /**
      * Information of the logged-in user. Before client initialization, returns an
      * uninitialized user. Will trigger a {@link Client.userUpdated} event after
@@ -1866,7 +2151,7 @@ declare class Client extends ReplayEventEmitter<ClientEvents> {
     /**
      * Get the current list of all the subscribed conversations.
      */
-    getSubscribedConversations(args?: any): Promise<Paginator<Conversation>>;
+    getSubscribedConversations(): Promise<Paginator<Conversation>>;
     /**
      * Create a conversation on the server and subscribe to its events.
      * The default is a conversation with an empty friendly name.
@@ -1920,36 +2205,6 @@ declare class Client extends ReplayEventEmitter<ClientEvents> {
      */
     getSubscribedUsers(): Promise<Array<User>>;
 }
-/**
- * Pagination helper class.
- */
-declare class RestPaginator<T> implements Paginator<T> {
-    private state;
-    /**
-     * Indicates the existence of the next page.
-     */
-    get hasNextPage(): boolean;
-    /**
-     * Indicates the existence of the previous page
-     */
-    get hasPrevPage(): boolean;
-    /**
-     * Array of elements on the current page.
-     */
-    get items(): Array<T>;
-    /**
-     * @internal
-     */
-    constructor(items: any, source: any, prevToken: any, nextToken: any);
-    /**
-     * Request the next page. Does not modify the existing object.
-     */
-    nextPage(): Promise<RestPaginator<T>>;
-    /**
-     * Request the previous page. Does not modify the existing object.
-     */
-    prevPage(): Promise<RestPaginator<T>>;
-}
 declare class NotificationTypes {
     static readonly TYPING_INDICATOR = "twilio.ipmsg.typing_indicator";
     static readonly NEW_MESSAGE = "twilio.conversations.new_message";
@@ -1958,4 +2213,4 @@ declare class NotificationTypes {
     static readonly REMOVED_FROM_CONVERSATION = "twilio.conversations.removed_from_conversation";
     static readonly CONSUMPTION_UPDATE = "twilio.channel.consumption_update";
 }
-export { Conversation, ConversationUpdateReason, ConversationStatus, NotificationLevel, ConversationState, ConversationUpdatedEventArgs, SendMediaOptions, SendEmailOptions, LastMessage, Participant, ParticipantUpdateReason, ParticipantType, ParticipantUpdatedEventArgs, Message, MessageUpdateReason, MessageType, MessageUpdatedEventArgs, Media, MediaCategory$0 as MediaCategory, AggregatedDeliveryReceipt, DeliveryAmount, DetailedDeliveryReceipt, DeliveryStatus, RestPaginator, MessageBuilder, UnsentMessage, Paginator, User, UserUpdateReason, UserUpdatedEventArgs, PushNotification, PushNotificationType, PushNotificationDescriptor, PushNotificationData, NotificationTypes, Client, State, ConnectionState, NotificationsChannelType, ClientOptions, CreateConversationOptions };
+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 };