import { Channel } from './channel'; import { ChannelMemberResponse, ChannelMembership, FormatMessageResponse, Event, ExtendableGenerics, DefaultGenerics, MessageSetType, MessageResponse, ReactionResponse, UserResponse } from './types'; declare type ChannelReadStatus = Record; }>; /** * ChannelState - A container class for the channel state. */ export declare class ChannelState { _channel: Channel; watcher_count: number; typing: Record>; read: ChannelReadStatus; pinnedMessages: Array['formatMessage']>>; threads: Record['formatMessage']>>>; mutedUsers: Array>; watchers: Record>; members: Record>; unreadCount: number; membership: ChannelMembership; last_message_at: Date | null; /** * Flag which indicates if channel state contain latest/recent messages or no. * This flag should be managed by UI sdks using a setter - setIsUpToDate. * When false, any new message (received by websocket event - message.new) will not * be pushed on to message list. */ isUpToDate: boolean; /** * Disjoint lists of messages * Users can jump in the message list (with searching) and this can result in disjoint lists of messages * The state manages these lists and merges them when lists overlap * The messages array contains the currently active set */ messageSets: { isCurrent: boolean; isLatest: boolean; messages: Array['formatMessage']>>; }[]; constructor(channel: Channel); get messages(): Array['formatMessage']>>; set messages(messages: Array['formatMessage']>>); /** * The list of latest messages * The messages array not always contains the latest messages (for example if a user searched for an earlier message, that is in a different message set) */ get latestMessages(): Array['formatMessage']>>; set latestMessages(messages: Array['formatMessage']>>); /** * addMessageSorted - Add a message to the state * * @param {MessageResponse} newMessage A new message * @param {boolean} timestampChanged Whether updating a message with changed created_at value. * @param {boolean} addIfDoesNotExist Add message if it is not in the list, used to prevent out of order updated messages from being added. * @param {MessageSetType} messageSetToAddToIfDoesNotExist Which message set to add to if message is not in the list (only used if addIfDoesNotExist is true) */ addMessageSorted(newMessage: MessageResponse, timestampChanged?: boolean, addIfDoesNotExist?: boolean, messageSetToAddToIfDoesNotExist?: MessageSetType): void; /** * formatMessage - Takes the message object. Parses the dates, sets __html * and sets the status to received if missing. Returns a message object * * @param {MessageResponse} message a message object * */ formatMessage(message: MessageResponse): FormatMessageResponse; /** * addMessagesSorted - Add the list of messages to state and resorts the messages * * @param {Array>} newMessages A list of messages * @param {boolean} timestampChanged Whether updating messages with changed created_at value. * @param {boolean} initializing Whether channel is being initialized. * @param {boolean} addIfDoesNotExist Add message if it is not in the list, used to prevent out of order updated messages from being added. * @param {MessageSetType} messageSetToAddToIfDoesNotExist Which message set to add to if messages are not in the list (only used if addIfDoesNotExist is true) * */ addMessagesSorted(newMessages: MessageResponse[], timestampChanged?: boolean, initializing?: boolean, addIfDoesNotExist?: boolean, messageSetToAddToIfDoesNotExist?: MessageSetType): void; /** * addPinnedMessages - adds messages in pinnedMessages property * * @param {Array>} pinnedMessages A list of pinned messages * */ addPinnedMessages(pinnedMessages: MessageResponse[]): void; /** * addPinnedMessage - adds message in pinnedMessages * * @param {MessageResponse} pinnedMessage message to update * */ addPinnedMessage(pinnedMessage: MessageResponse): void; /** * removePinnedMessage - removes pinned message from pinnedMessages * * @param {MessageResponse} message message to remove * */ removePinnedMessage(message: MessageResponse): void; addReaction(reaction: ReactionResponse, message?: MessageResponse, enforce_unique?: boolean): MessageResponse | undefined; _addOwnReactionToMessage(ownReactions: ReactionResponse[] | null | undefined, reaction: ReactionResponse, enforce_unique?: boolean): ReactionResponse[]; _removeOwnReactionFromMessage(ownReactions: ReactionResponse[] | null | undefined, reaction: ReactionResponse): ReactionResponse[] | null | undefined; removeReaction(reaction: ReactionResponse, message?: MessageResponse): MessageResponse | undefined; removeQuotedMessageReferences(message: MessageResponse): void; /** * Updates all instances of given message in channel state * @param message * @param updateFunc */ _updateMessage(message: { id?: string; parent_id?: string; pinned?: boolean; show_in_channel?: boolean; }, updateFunc: (msg: ReturnType['formatMessage']>) => ReturnType['formatMessage']>): void; /** * Setter for isUpToDate. * * @param isUpToDate Flag which indicates if channel state contain latest/recent messages or no. * This flag should be managed by UI sdks using a setter - setIsUpToDate. * When false, any new message (received by websocket event - message.new) will not * be pushed on to message list. */ setIsUpToDate: (isUpToDate: boolean) => void; /** * _addToMessageList - Adds a message to a list of messages, tries to update first, appends if message isn't found * * @param {Array['formatMessage']>>} messages A list of messages * @param message * @param {boolean} timestampChanged Whether updating a message with changed created_at value. * @param {string} sortBy field name to use to sort the messages by * @param {boolean} addIfDoesNotExist Add message if it is not in the list, used to prevent out of order updated messages from being added. */ _addToMessageList(messages: Array['formatMessage']>>, message: ReturnType['formatMessage']>, timestampChanged?: boolean, sortBy?: 'pinned_at' | 'created_at', addIfDoesNotExist?: boolean): FormatMessageResponse[]; /** * removeMessage - Description * * @param {{ id: string; parent_id?: string }} messageToRemove Object of the message to remove. Needs to have at id specified. * * @return {boolean} Returns if the message was removed */ removeMessage(messageToRemove: { id: string; parent_id?: string; }): boolean; removeMessageFromArray: (msgArray: Array['formatMessage']>>, msg: { id: string; parent_id?: string; }) => { removed: boolean; result: FormatMessageResponse[]; }; /** * Updates the message.user property with updated user object, for messages. * * @param {UserResponse} user */ updateUserMessages: (user: UserResponse) => void; /** * Marks the messages as deleted, from deleted user. * * @param {UserResponse} user * @param {boolean} hardDelete */ deleteUserMessages: (user: UserResponse, hardDelete?: boolean) => void; /** * filterErrorMessages - Removes error messages from the channel state. * */ filterErrorMessages(): void; /** * clean - Remove stale data such as users that stayed in typing state for more than 5 seconds */ clean(): void; clearMessages(): void; initMessages(): void; /** * loadMessageIntoState - Loads a given message (and messages around it) into the state * * @param {string} messageId The id of the message, or 'latest' to indicate switching to the latest messages * @param {string} parentMessageId The id of the parent message, if we want load a thread reply */ loadMessageIntoState(messageId: string | 'latest', parentMessageId?: string): Promise; private switchToMessageSet; private areMessageSetsOverlap; private findMessageSetIndex; private findTargetMessageSet; } export {}; //# sourceMappingURL=channel_state.d.ts.map