@twilio/conversations 2.1.0-rc.1 → 2.1.0-rc.8

package/builds/lib.d.ts

@@ -1,5 +1,6 @@
-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";
@@ -41,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;
@@ -54,11 +55,29 @@ declare class Logger {
     static warn(...args: any[]): void;
     static error(...args: any[]): void;
 }
-interface Limits {
+/**
+ * Represents conversation limits.
+ */
+interface ConversationLimits {
+    /**
+     * Maximum amount of attachments.
+     */
     mediaAttachmentsCountLimit: number;
+    /**
+     * Maximum attachment size in MB.
+     */
     mediaAttachmentSizeLimitInMb: number;
+    /**
+     * Maximum total attachment size in MB.
+     */
     mediaAttachmentsTotalSizeLimitInMb: number;
+    /**
+     * Allowed mime types for E-Mail histories.
+     */
     emailHistoriesAllowedMimeTypes: string[];
+    /**
+     * Allowed mime types for E-Mail bodies.
+     */
     emailBodiesAllowedMimeTypes: string[];
 }
 interface BackoffConfiguration {
@@ -77,7 +96,7 @@ declare class Configuration {
         mediaSetService: string;
         messagesReceipts: string;
     };
-    readonly limits: Limits;
+    readonly limits: ConversationLimits;
     readonly productId?: string;
     readonly typingIndicatorTimeoutOverride?: number;
     readonly typingIndicatorTimeoutDefault: number;
@@ -90,7 +109,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;
@@ -105,6 +124,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;
@@ -180,25 +213,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
@@ -208,7 +245,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.
@@ -232,7 +269,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: {
@@ -264,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}
      */
@@ -283,16 +320,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?: Object;
+    bindings?: ParticipantBindings;
 }
 interface ParticipantServices {
     users: Users;
@@ -351,19 +388,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.
      */
@@ -378,7 +415,7 @@ declare class Participant extends ReplayEventEmitter<ParticipantEvents> {
     /**
      * Date of the most recent read horizon update.
      */
-    get lastReadTimestamp(): Date;
+    get lastReadTimestamp(): Date | null;
     get roleSid(): string;
     /**
      * Type of the participant.
@@ -451,7 +488,27 @@ 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;
@@ -466,7 +523,7 @@ type MediaCategory$0 = McsMediaCategory;
 interface MediaState {
     sid: string;
     category: MediaCategory$0;
-    filename?: string;
+    filename: string | null;
     contentType: string;
     size: number;
 }
@@ -491,7 +548,7 @@ declare class Media {
     /**
      * File name. Null if absent.
      */
-    get filename(): string;
+    get filename(): string | null;
     /**
      * Content type of the media.
      */
@@ -511,7 +568,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.
      *
@@ -521,7 +578,7 @@ declare class Media {
      *
      * @returns {Promise<String>}
      */
-    getCachedTemporaryUrl(): Promise<string>;
+    getCachedTemporaryUrl(): Promise<string | null>;
     private _fetchMcsMedia;
 }
 /**
@@ -616,7 +673,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;
 }
@@ -652,7 +709,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.
      */
@@ -694,6 +751,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.
  */
@@ -709,7 +781,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.
      *
@@ -726,7 +798,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.
      */
@@ -734,11 +806,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,
@@ -754,15 +826,15 @@ 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;
     /**
      * Type of the message.
      */
@@ -779,7 +851,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..
      */
@@ -825,12 +897,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;
 }
 /**
@@ -912,9 +984,9 @@ declare class TypingIndicator {
 declare class UnsentMessage {
     private messagesEntity;
     text?: string;
-    attributes: any;
+    attributes: JSONValue;
     mediaContent: [MediaCategory, FormData | SendMediaOptions][];
-    emailOptions?: SendEmailOptions;
+    emailOptions: SendEmailOptions;
     /**
      * @internal
      */
@@ -923,7 +995,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.
@@ -948,7 +1167,7 @@ declare class MessageBuilder {
     /**
      * @internal
      */
-    constructor(limits: Limits, messagesEntity: any);
+    constructor(limits: ConversationLimits, messagesEntity: Messages);
     /**
      * Sets the message body.
      * @param text Contents of the body.
@@ -963,7 +1182,7 @@ 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).
@@ -1020,12 +1239,12 @@ 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;
 }
@@ -1073,6 +1292,7 @@ interface ConversationUpdatedEventArgs {
  */
 interface ConversationBindings {
     email?: ConversationEmailBinding;
+    sms?: ConversationSmsBinding;
 }
 /**
  * Binding for email conversation.
@@ -1081,6 +1301,9 @@ 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
@@ -1090,7 +1313,7 @@ interface SendMediaOptions {
     /**
      * Content type of media.
      */
-    contentType: string;
+    contentType: null | string;
     /**
      * Optional filename.
      */
@@ -1098,7 +1321,7 @@ interface SendMediaOptions {
     /**
      * Content to post.
      */
-    media: string | Buffer | Blob;
+    media: null | string | Buffer | Blob;
 }
 /**
  * These options can be passed to {@link Conversation.sendMessage}.
@@ -1234,7 +1457,7 @@ declare class Conversation extends ReplayEventEmitter<ConversationEvents> {
     /**
      * Unique name of the conversation.
      */
-    get uniqueName(): string;
+    get uniqueName(): string | null;
     /**
      * Status of the conversation.
      */
@@ -1242,15 +1465,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.
      */
@@ -1258,7 +1481,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.
      */
@@ -1266,13 +1489,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 bindings(): ConversationBindings;
-    get limits(): Limits;
+    get limits(): ConversationLimits;
     /**
      * State of the conversation.
      */
@@ -1282,7 +1505,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.
@@ -1296,7 +1519,7 @@ declare class Conversation extends ReplayEventEmitter<ConversationEvents> {
      */
     _unsubscribe(): Promise<[
         void,
-        any
+        void
     ]>;
     /**
      * Set conversation status.
@@ -1324,7 +1547,7 @@ 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.
@@ -1332,7 +1555,7 @@ declare class Conversation extends ReplayEventEmitter<ConversationEvents> {
      * @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?: Record<string, any>, bindingOptions?: ParticipantBindingOptions): 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.
@@ -1348,7 +1571,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.
@@ -1377,12 +1600,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.
      *
@@ -1423,6 +1646,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.
@@ -1432,7 +1657,7 @@ 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`.
@@ -1463,7 +1688,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.
@@ -1488,13 +1713,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.
@@ -1520,23 +1745,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.
      */
@@ -1612,7 +1837,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.
  */
@@ -1632,15 +1857,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}.
@@ -1649,7 +1876,7 @@ interface CreateConversationOptions {
     /**
      * Any custom attributes to attach to the conversation.
      */
-    attributes?: any;
+    attributes?: JSONValue;
     /**
      * A non-unique display name of the conversation.
      */
@@ -1696,7 +1923,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.
@@ -1904,7 +2131,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
@@ -1942,7 +2169,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.
@@ -1996,36 +2223,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";
@@ -2034,4 +2231,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 };
+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 };