feat(pin-save-thread-subscription-js-sdk): add documentation for pin/save messages, pin conversations and thread subscription

docs.json

@@ -3226,10 +3226,14 @@
                               "sdk/javascript/message-filtering",
                               "sdk/javascript/retrieve-conversations",
                               "sdk/javascript/threaded-messages",
+                              "sdk/javascript/thread-subscription",
                               "sdk/javascript/edit-message",
                               "sdk/javascript/delete-message",
                               "sdk/javascript/flag-message",
+                              "sdk/javascript/pin-message",
+                              "sdk/javascript/save-message",
                               "sdk/javascript/delete-conversation",
+                              "sdk/javascript/pin-conversation",
                               "sdk/javascript/typing-indicators",
                               "sdk/javascript/transient-messages",
                               "sdk/javascript/delivery-read-receipts",

sdk/javascript/all-real-time-listeners.mdx

@@ -3,14 +3,15 @@
 description: "Use CometChat real-time listeners for user presence, groups, messages, calls, AI assistant events, and ongoing calls."
 ---
 
-CometChat provides 4 listeners viz.
+CometChat provides the following listeners.
 
 1. [User Listener](/sdk/javascript/all-real-time-listeners#user-listener)
 2. [Group Listener](/sdk/javascript/all-real-time-listeners#group-listener)
 3. [Message Listener](/sdk/javascript/all-real-time-listeners#message-listener)
-4. [Call Listener](/sdk/javascript/all-real-time-listeners#call-listener)
-5. [AI Assistant Listener](/sdk/javascript/all-real-time-listeners#ai-assistant-listener)
-6. [Ongoing Call Listener (Calls SDK)](/sdk/javascript/all-real-time-listeners#ongoing-call-listener-calls-sdk)
+4. [Conversation Listener](/sdk/javascript/all-real-time-listeners#conversation-listener)
+5. [Call Listener](/sdk/javascript/all-real-time-listeners#call-listener)
+6. [AI Assistant Listener](/sdk/javascript/all-real-time-listeners#ai-assistant-listener)
+7. [Ongoing Call Listener (Calls SDK)](/sdk/javascript/all-real-time-listeners#ongoing-call-listener-calls-sdk)
 
 ## User Listener
 
@@ -34,9 +35,9 @@
       /* when someuser/friend comes online, user will be received here */
       console.log("On User Online:", { onlineUser });
     },
     onUserOffline: (offlineUser: CometChat.User) => {
       /* when someuser/friend went offline, user will be received here */
       console.log("On User Offline:", { offlineUser });
     },
   })
 );
@@ -91,13 +92,13 @@
 
 | Method                                                                                                                                                  | Information                                                                                                                                    |
 | ------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------- |
 | **onGroupMemberJoined(action: CometChat.Action, joinedUser: CometChat.User, joinedGroup: CometChat.Group)**                                             | This method is triggered when a user joins any group. All the members present in the group will receive this event.                            |
 | **onGroupMemberLeft(action: CometChat.Action, leftUser: CometChat.User, leftGroup: CometChat.Group)**                                                   | This method is triggered when a user who was a member of any group leaves the group. All the members of the group receive this event.          |
 | **onGroupMemberKicked(action: CometChat.Action, kickedUser: CometChat.User, kickedBy: CometChat.User, kickedFrom: CometChat.Group)**                    | This method is triggered when a user is kicked from a group. All the members including the user receive this event                             |
 | **onGroupMemberBanned(action: CometChat.Action, bannedUser: CometChat.User, bannedBy: CometChat.User, bannedFrom: CometChat.Group)**                    | This method is triggered when a user is banned from a group. All the members including the user receive this event                             |
 | **onGroupMemberUnbanned(action: CometChat.Action, unbannedUser: CometChat.User, unbannedBy: CometChat.User, unbannedFrom: CometChat.Group)**            | This method is triggered when a user is banned from a group. All the members of the group receive this event.                                  |
 | **onGroupMemberScopeChanged(action: CometChat.Action, changedUser: CometChat.User, newScope: string, oldScope: string, changedGroup: CometChat.Group)** | This method is triggered when the scope of any Group Member has been changed. All the members that are a part of that group receive this event |
 | **onMemberAddedToGroup(action: CometChat.Action, userAdded: CometChat.User, addedBy: CometChat.User, addedTo: CometChat.Group)**                        | This method is triggered when a user is added to any group. All the members including the user himself receive this event.                     |
 
 To add the `GroupListener`:
 
@@ -116,76 +117,76 @@
     },
     onGroupMemberLeft: (
       message: CometChat.Action,
       leftUser: CometChat.User,
       leftGroup: CometChat.Group
     ) => {
       console.log("onGroupMemberLeft", { message, leftUser, leftGroup });
     },
     onGroupMemberKicked: (
       message: CometChat.Action,
       kickedUser: CometChat.User,
       kickedBy: CometChat.User,
       kickedFrom: CometChat.Group
     ) => {
       console.log("onGroupMemberKicked", {
         message,
         kickedUser,
         kickedBy,
         kickedFrom,
       });
     },
     onGroupMemberBanned: (
       message: CometChat.Action,
       bannedUser: CometChat.User,
       bannedBy: CometChat.User,
       bannedFrom: CometChat.Group
     ) => {
       console.log("onGroupMemberBanned", {
         message,
         bannedUser,
         bannedBy,
         bannedFrom,
       });
     },
     onGroupMemberUnbanned: (
       message: CometChat.Action,
       unbannedUser: CometChat.User,
       unbannedBy: CometChat.User,
       unbannedFrom: CometChat.Group
     ) => {
       console.log("onGroupMemberUnbanned", {
         message,
         unbannedUser,
         unbannedBy,
         unbannedFrom,
       });
     },
     onGroupMemberScopeChanged: (
       message: CometChat.Action,
       changedUser: CometChat.User,
       newScope: string,
       oldScope: string,
       changedGroup: CometChat.Group
     ) => {
       console.log("onGroupMemberScopeChanged", {
         message,
         changedUser,
         newScope,
         oldScope,
         changedGroup,
       });
     },
     onMemberAddedToGroup: (
       message: CometChat.Action,
       userAdded: CometChat.User,
       addedby: CometChat.User,
       addedTo: CometChat.Group
     ) => {
       console.log("onMemberAddedToGroup", {
         message,
         userAdded,
         addedby,
         addedTo,
       });
     },
   })
@@ -308,6 +309,10 @@
 | **onMessagesDeliveredToAll(receipt: CometChat.MessageReceipt)**         | This event is triggered when a group message is delivered to all members. Group conversations only.                                                                  |
 | **onMessagesReadByAll(receipt: CometChat.MessageReceipt)**              | This event is triggered when a group message is read by all members. Group conversations only.                                                                       |
 | **onAIAssistantMessageReceived(message: CometChat.AIAssistantMessage)** | This event is triggered when a persisted AI assistant reply is received after an agent run completes.                                                                |
+| **onMessagePinned(message: CometChat.BaseMessage)**                     | This event is triggered when a message is pinned in a user/group conversation. Broadcast to everyone in that conversation.                                            |
+| **onMessageUnpinned(message: CometChat.BaseMessage)**                   | This event is triggered when a message is unpinned in a user/group conversation.                                                                                      |
+| **onMessageSaved(message: CometChat.BaseMessage)**                      | This event is triggered when the logged-in user saves a message. Private and delivered to that user's other devices only.                                             |
+| **onMessageUnsaved(message: CometChat.BaseMessage)**                    | This event is triggered when the logged-in user unsaves a message.                                                                                                   |
 | **onAIToolResultReceived(message: CometChat.AIToolResultMessage)**      | This event is triggered when a persisted AI tool result message is received after an agent run completes.                                                            |
 | **onAIToolArgumentsReceived(message: CometChat.AIToolArgumentMessage)** | This event is triggered when a persisted AI tool argument message is received after an agent run completes.                                                          |
 | **onCardMessageReceived(message: CometChat.CardMessage)**               | This event is triggered when a standalone [card message](/sdk/javascript/card-messages) is received.                                                                 |
@@ -323,23 +328,23 @@
     onTextMessageReceived: (textMessage: CometChat.TextMessage) => {
       console.log("Text message received successfully", textMessage);
     },
     onMediaMessageReceived: (mediaMessage: CometChat.MediaMessage) => {
       console.log("Media message received successfully", mediaMessage);
     },
     onCustomMessageReceived: (customMessage: CometChat.CustomMessage) => {
       console.log("Custom message received successfully", customMessage);
     },
     onMessagesDelivered: (messageReceipt: CometChat.MessageReceipt) => {
       console.log("Message Delivered", messageReceipt);
     },
     onMessagesRead: (messageReceipt: CometChat.MessageReceipt) => {
       console.log("Message Read", messageReceipt);
     },
     onTypingStarted: (typingIndicator: CometChat.TypingIndicator) => {
       console.log("Typing Started", typingIndicator);
     },
     onTypingEnded: (typingIndicator: CometChat.TypingIndicator) => {
       console.log("Typing Ended", typingIndicator);
     },
     onMessageDeleted: (message: CometChat.BaseMessage) => {
       console.log("Message Delted", message);
@@ -360,10 +365,10 @@
       console.log("Message Moderated", message);
     },
     onMessagesDeliveredToAll: (messageReceipt: CometChat.MessageReceipt) => {
       console.log("Message Delivered to All", messageReceipt);
     },
     onMessagesReadByAll: (messageReceipt: CometChat.MessageReceipt) => {
       console.log("Message Read by All", messageReceipt);
     },
     onAIAssistantMessageReceived: (message: CometChat.AIAssistantMessage) => {
       console.log("AI Assistant message received", message);
@@ -474,6 +479,77 @@
 
 </Tabs>
 
+## Conversation Listener
+
+Receive events when a conversation is pinned or unpinned. This is a separate channel from `MessageListener` because its payload is a `Conversation`, not a message.
+
+| Method                                                            | Information                                                                                                                       |
+| ----------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------- |
+| **onConversationPinned(conversation: CometChat.Conversation)**    | Triggered when a conversation is pinned — by the logged-in user on another device, or globally by an admin.                        |
+| **onConversationUnpinned(conversation: CometChat.Conversation)**  | Triggered when a conversation is unpinned. The `Conversation` arrives with its pin attributes cleared.                             |
+
+<Tabs>
+<Tab title="TypeScript">
+```typescript
+let listenerID: string = "UNIQUE_LISTENER_ID";
+
+CometChat.addConversationListener(
+  listenerID,
+  new CometChat.ConversationListener({
+    onConversationPinned: (conversation: CometChat.Conversation) => {
+      console.log("Conversation pinned", conversation);
+    },
+    onConversationUnpinned: (conversation: CometChat.Conversation) => {
+      console.log("Conversation unpinned", conversation);
+    },
+  })
+);
+```
+
+</Tab>
+
+<Tab title="JavaScript">
+```javascript
+let listenerID = "UNIQUE_LISTENER_ID";
+
+CometChat.addConversationListener(
+  listenerID,
+  new CometChat.ConversationListener({
+    onConversationPinned: (conversation) => {
+      console.log("Conversation pinned", conversation);
+    },
+    onConversationUnpinned: (conversation) => {
+      console.log("Conversation unpinned", conversation);
+    },
+  })
+);
+```
+
+</Tab>
+
+</Tabs>
+
+Remove the listener once you are done:
+
+<Tabs>
+<Tab title="TypeScript">
+```typescript
+CometChat.removeConversationListener("UNIQUE_LISTENER_ID");
+```
+
+</Tab>
+
+<Tab title="JavaScript">
+```javascript
+CometChat.removeConversationListener("UNIQUE_LISTENER_ID");
+```
+
+</Tab>
+
+</Tabs>
+
+See [Pin A Conversation](/sdk/javascript/pin-conversation) for the full feature.
+
 ## Call Listener
 
 Receive events for incoming and outgoing call state changes.
@@ -695,7 +771,7 @@
 | `event.user.name` | `string` | Name of the user who started recording |
 | `event.user.uid`  | `string` | UID of the user who started recording  |
 
 **`onRecordingStopped()`**, **`onCallEnded()`**, **`onSessionTimeout()`**, **`onCallEndButtonPressed()`**, **`onScreenShareStarted()`**, **`onScreenShareStopped()`** — receive no arguments.
 
 <Tabs>
 <Tab title="TypeScript">
@@ -707,7 +783,7 @@
 console.log("User joined:", user);
 },
 onUserLeft: (user: any) => {
 console.log("User left:", user);
 },
 onCallEnded: () => {
 console.log("Call ended");
@@ -773,15 +849,15 @@
 const listenerID: string = "UNIQUE_LISTENER_ID";
 CometChat.addLoginListener(
   listenerID,
   new CometChat.LoginListener({
     loginSuccess: (user: CometChat.User) => {
       console.log("LoginListener :: loginSuccess", user);
     },
     loginFailure: (error: CometChat.CometChatException) => {
       console.log("LoginListener :: loginFailure", error);
     },
     logoutSuccess: () => {
       console.log("LoginListener :: logoutSuccess");
     },
     logoutFailure: (error: CometChat.CometChatException) => {
       console.log("LoginListener :: logoutFailure", error);
@@ -836,10 +912,10 @@
 ```typescript
 const listenerID: string = "UNIQUE_LISTENER_ID";
 CometChat.addConnectionListener(
   listenerID,
   new CometChat.ConnectionListener({
     onConnected: () => {
       console.log("ConnectionListener :: connected");
     },
     inConnecting: () => {
       console.log("ConnectionListener :: connecting");
@@ -858,10 +934,10 @@
 ```javascript
 const listenerID = "UNIQUE_LISTENER_ID";
 CometChat.addConnectionListener(
   listenerID,
   new CometChat.ConnectionListener({
     onConnected: () => {
       console.log("ConnectionListener :: connected");
     },
     inConnecting: () => {
       console.log("ConnectionListener :: connecting");

sdk/javascript/message-filtering.mdx

@@ -31,7 +31,7 @@
 <Tabs>
 <Tab title="TypeScript">
 ```typescript
 let messagesRequest: CometChat.MessagesRequest =
   new CometChat.MessagesRequestBuilder().setLimit(50).build();
 ```
 
@@ -39,7 +39,7 @@
 
 <Tab title="JavaScript">
 ```javascript
 let messagesRequest = new CometChat.MessagesRequestBuilder()
   .setLimit(50)
   .build();
 ```
@@ -56,7 +56,7 @@
 <Tab title="TypeScript">
 ```typescript
 let UID = "UID";
 let messagesRequest: CometChat.MessagesRequest =
   new CometChat.MessagesRequestBuilder().setUID(UID).setLimit(50).build();
 ```
 
@@ -65,7 +65,7 @@
 <Tab title="JavaScript">
 ```javascript
 let UID = "UID";
 let messagesRequest = new CometChat.MessagesRequestBuilder()
   .setUID(UID)
   .setLimit(50)
   .build();
@@ -85,7 +85,7 @@
 <Tab title="TypeScript">
 ```typescript
 let GUID: string = "GUID";
 let messagesRequest: CometChat.MessagesRequest =
   new CometChat.MessagesRequestBuilder().setGUID(GUID).setLimit(50).build();
 ```
 
@@ -94,7 +94,7 @@
 <Tab title="JavaScript">
 ```javascript
 let GUID = "GUID";
 let messagesRequest = new CometChat.MessagesRequestBuilder()
   .setGUID(GUID)
   .setLimit(50)
   .build();
@@ -114,9 +114,9 @@
 <Tab title="TypeScript (User)">
 ```typescript
 let UID: string = "UID",
   messageId: number = 1,
   limit: number = 30,
   messagesRequest: CometChat.MessagesRequest =
     new CometChat.MessagesRequestBuilder()
       .setUID(UID)
       .setMessageId(messageId)
@@ -129,9 +129,9 @@
 <Tab title="JavaScript (User)">
 ```javascript
 let UID = "UID";
 let messageId = 1;
 let limit = 30;
 let messagesRequest = new CometChat.MessagesRequestBuilder()
   .setUID(UID)
   .setMessageId(messageId)
   .setLimit(limit)
@@ -143,9 +143,9 @@
 <Tab title="TypeScript (Group)">
 ```typescript
 let GUID: string = "GUID",
   messageId: number = 1,
   limit: number = 30,
   messagesRequest: CometChat.MessagesRequest =
     new CometChat.MessagesRequestBuilder()
       .setUID(UID)
       .setMessageId(messageId)
@@ -158,9 +158,9 @@
 <Tab title="JavaScript (Group)">
 ```javascript
 let GUID = "GUID";
 let messageId = 1;
 let limit = 30;
 let messagesRequest = new CometChat.MessagesRequestBuilder()
   .setGUID(GUID)
   .setMessageId(messageId)
   .setLimit(limit)
@@ -183,7 +183,7 @@
 let UID: string = "UID",
   timestamp: number = 1602221371,
   limit: number = 30,
   messagesRequest: CometChat.MessagesRequest =
     new CometChat.MessagesRequestBuilder()
       .setUID(UID)
       .setTimestamp(timestamp)
@@ -198,7 +198,7 @@
 let UID = "UID";
 let timestamp = 1602221371;
 let limit = 30;
 let messagesRequest = new CometChat.MessagesRequestBuilder()
   .setUID(UID)
   .setTimestamp(timestamp)
   .setLimit(limit)
@@ -212,7 +212,7 @@
 let GUID: string = "GUID",
   timestamp: number = 1602221371,
   limit: number = 30,
   messagesRequest: CometChat.MessagesRequest =
     new CometChat.MessagesRequestBuilder()
       .setUID(UID)
       .setTimestamp(timestamp)
@@ -227,7 +227,7 @@
 let GUID = "GUID";
 let timestamp = 1602221371;
 let limit = 30;
 let messagesRequest = new CometChat.MessagesRequestBuilder()
   .setGUID(GUID)
   .setTimestamp(timestamp)
   .setLimit(limit)
@@ -249,7 +249,7 @@
 ```typescript
 let UID: string = "UID",
   limit: number = 30,
   messagesRequest: CometChat.MessagesRequest =
     new CometChat.MessagesRequestBuilder()
       .setUID(UID)
       .setUnread(true)
@@ -263,7 +263,7 @@
 ```javascript
 let UID = "UID";
 let limit = 30;
 let messagesRequest = new CometChat.MessagesRequestBuilder()
   .setUID(UID)
   .setUnread(true)
   .setLimit(limit)
@@ -276,7 +276,7 @@
 ```typescript
 let GUID: string = "GUID",
   limit: number = 30,
   messagesRequest: CometChat.MessagesRequest =
     new CometChat.MessagesRequestBuilder()
       .setGUID(GUID)
       .setUnread(true)
@@ -290,7 +290,7 @@
 ```javascript
 let GUID = "GUID";
 let limit = 30;
 let messagesRequest = new CometChat.MessagesRequestBuilder()
   .setGUID(GUID)
   .setUnread(true)
   .setLimit(limit)
@@ -312,7 +312,7 @@
 ```typescript
 let UID: string = "UID",
   limit: number = 30,
   messagesRequest: CometChat.MessagesRequest =
     new CometChat.MessagesRequestBuilder()
       .setUID(UID)
       .hideMessagesFromBlockedUsers(true)
@@ -326,7 +326,7 @@
 ```javascript
 let UID = "UID";
 let limit = 30;
 let messagesRequest = new CometChat.MessagesRequestBuilder()
   .setUID(UID)
   .hideMessagesFromBlockedUsers(true)
   .setLimit(limit)
@@ -339,7 +339,7 @@
 ```typescript
 let GUID: string = "GUID",
   limit: number = 30,
   messagesRequest: CometChat.MessagesRequest =
     new CometChat.MessagesRequestBuilder()
       .setGUID(GUID)
       .hideMessagesFromBlockedUsers(true)
@@ -353,7 +353,7 @@
 ```javascript
 let GUID = "GUID";
 let limit = 30;
 let messagesRequest = new CometChat.MessagesRequestBuilder()
   .setGUID(GUID)
   .hideMessagesFromBlockedUsers(true)
   .setLimit(limit)
@@ -376,7 +376,7 @@
 let UID: string = "UID",
   limit: number = 30,
   timestamp: string = "1602221371",
   messagesRequest: CometChat.MessagesRequest =
     new CometChat.MessagesRequestBuilder()
       .setUID(UID)
       .setUpdatedAfter(timestamp)
@@ -391,7 +391,7 @@
 let UID = "UID";
 let limit = 30;
 let timestamp = 1602221371;
 let messagesRequest = new CometChat.MessagesRequestBuilder()
   .setUID(UID)
   .setUpdatedAfter(timestamp)
   .setLimit(limit)
@@ -405,7 +405,7 @@
 let GUID: string = "GUID",
   limit: number = 30,
   timestamp: string = "1602221371",
   messagesRequest: CometChat.MessagesRequest =
     new CometChat.MessagesRequestBuilder()
       .setGUID(GUID)
       .setUpdatedAfter(timestamp)
@@ -420,7 +420,7 @@
 let GUID = "GUID";
 let limit = 30;
 let timestamp = 1602221371;
 let messagesRequest = new CometChat.MessagesRequestBuilder()
   .setGUID(GUID)
   .setUpdatedAfter(timestamp)
   .setLimit(limit)
@@ -443,7 +443,7 @@
 let UID: string = "UID",
   limit: number = 30,
   timestamp: string = "1602221371",
   messagesRequest: CometChat.MessagesRequest =
     new CometChat.MessagesRequestBuilder()
       .setUID(UID)
       .setUpdatedAfter(timestamp)
@@ -459,7 +459,7 @@
 let UID = "UID";
 let limit = 30;
 let timestamp = 1602221371;
 let messagesRequest = new CometChat.MessagesRequestBuilder()
   .setUID(UID)
   .setUpdatedAfter(timestamp)
   .updatesOnly(true)
@@ -474,7 +474,7 @@
 let GUID: string = "GUID",
   limit: number = 30,
   timestamp: string = "1602221371",
   messagesRequest: CometChat.MessagesRequest =
     new CometChat.MessagesRequestBuilder()
       .setGUID(GUID)
       .setUpdatedAfter(timestamp)
@@ -490,7 +490,7 @@
 let GUID = "GUID";
 let limit = 30;
 let timestamp = 1602221371;
 let messagesRequest = new CometChat.MessagesRequestBuilder()
   .setGUID(GUID)
   .setUpdatedAfter(timestamp)
   .updatesOnly(true)
@@ -514,7 +514,7 @@
 let UID: string = "UID",
   limit: number = 30,
   categories: Array<String> = ["message", "custom"],
   messagesRequest: CometChat.MessagesRequest =
     new CometChat.MessagesRequestBuilder()
       .setUID(UID)
       .setCategories(categories)
@@ -529,7 +529,7 @@
 let UID = "UID";
 let limit = 30;
 let categories = ["message", "custom"];
 let messagesRequest = new CometChat.MessagesRequestBuilder()
   .setUID(UID)
   .setCategories(categories)
   .setLimit(limit)
@@ -543,7 +543,7 @@
 let GUID: string = "GUID",
   limit: number = 30,
   categories: Array<String> = ["message", "custom"],
   messagesRequest: CometChat.MessagesRequest =
     new CometChat.MessagesRequestBuilder()
       .setGUID(GUID)
       .setCategories(categories)
@@ -558,7 +558,7 @@
 let GUID = "GUID";
 let limit = 30;
 let categories = ["message", "custom"];
 let messagesRequest = new CometChat.MessagesRequestBuilder()
   .setGUID(GUID)
   .setCategories(categories)
   .setLimit(limit)
@@ -582,7 +582,7 @@
   limit: number = 30,
   categories: Array<String> = ["message", "custom"],
   types: Array<String> = ["image", "video", "audio", "file"],
   messagesRequest: CometChat.MessagesRequest =
     new CometChat.MessagesRequestBuilder()
       .setUID(UID)
       .setCategories(categories)
@@ -599,7 +599,7 @@
 let limit = 30;
 let categories = ["message"];
 let types = ["image", "video", "audio", "file"];
 let messagesRequest = new CometChat.MessagesRequestBuilder()
   .setUID(UID)
   .setCategories(categories)
   .setTypes(types)
@@ -615,7 +615,7 @@
   limit: number = 30,
   categories: Array<String> = ["message", "custom"],
   types: Array<String> = ["image", "video", "audio", "file"],
   messagesRequest: CometChat.MessagesRequest =
     new CometChat.MessagesRequestBuilder()
       .setGUID(GUID)
       .setCategories(categories)
@@ -632,7 +632,7 @@
 let limit = 30;
 let categories = ["message"];
 let types = ["image", "video", "audio", "file"];
 let messagesRequest = new CometChat.MessagesRequestBuilder()
   .setGUID(GUID)
   .setCategories(categories)
   .setTypes(types)
@@ -655,8 +655,8 @@
 ```typescript
 let UID: string = "UID",
   limit: number = 30,
   messageId: number = 1,
   messagesRequest: CometChat.MessagesRequest =
     new CometChat.MessagesRequestBuilder()
       .setUID(UID)
       .setLimit(limit)
@@ -669,9 +669,9 @@
 <Tab title="JavaScript (User)">
 ```javascript
 let UID = "UID";
 let messageId = 1;
 let limit = 30;
 let messagesRequest = new CometChat.MessagesRequestBuilder()
   .setUID(UID)
   .setLimit(limit)
   .setParentMessageId(messageId)
@@ -684,8 +684,8 @@
 ```typescript
 let GUID: string = "GUID",
   limit: number = 30,
   messageId: number = 1,
   messagesRequest: CometChat.MessagesRequest =
     new CometChat.MessagesRequestBuilder()
       .setGUID(GUID)
       .setLimit(limit)
@@ -698,9 +698,9 @@
 <Tab title="JavaScript (Group)">
 ```javascript
 let GUID = "GUID";
 let messageId = 1;
 let limit = 30;
 let messagesRequest = new CometChat.MessagesRequestBuilder()
   .setGUID(GUID)
   .setLimit(limit)
   .setParentMessageId(messageId)
@@ -713,6 +713,101 @@
 
 The above code returns messages belonging to the thread with the specified parent message ID.
 
+## Pinned messages
+
+Use `setPinned(true)` to fetch only the pinned messages of a conversation. A pinned list is conversation-scoped, so pair it with `setUID()` or `setGUID()` — exactly one of the two is required.
+
+<Tabs>
+<Tab title="TypeScript (User)">
+```typescript
+let UID: string = "UID",
+  limit: number = 50,
+  messagesRequest: CometChat.MessagesRequest =
+    new CometChat.MessagesRequestBuilder()
+      .setUID(UID)
+      .setLimit(limit)
+      .setPinned(true)
+      .build();
+```
+
+</Tab>
+
+<Tab title="JavaScript (User)">
+```javascript
+let UID = "UID";
+let limit = 50;
+let messagesRequest = new CometChat.MessagesRequestBuilder()
+  .setUID(UID)
+  .setLimit(limit)
+  .setPinned(true)
+  .build();
+```
+
+</Tab>
+
+<Tab title="TypeScript (Group)">
+```typescript
+let GUID: string = "GUID",
+  limit: number = 50,
+  messagesRequest: CometChat.MessagesRequest =
+    new CometChat.MessagesRequestBuilder()
+      .setGUID(GUID)
+      .setLimit(limit)
+      .setPinned(true)
+      .build();
+```
+
+</Tab>
+
+<Tab title="JavaScript (Group)">
+```javascript
+let GUID = "GUID";
+let limit = 50;
+let messagesRequest = new CometChat.MessagesRequestBuilder()
+  .setGUID(GUID)
+  .setLimit(limit)
+  .setPinned(true)
+  .build();
+```
+
+</Tab>
+
+</Tabs>
+
+The list is ordered by pin time, most recently pinned first — not by when the messages were sent. See [Pin A Message](/sdk/javascript/pin-message) for the full feature.
+
+## Saved messages
+
+Use `setSaved(true)` to fetch the logged-in user's saved messages. The saved list is user-level and spans every conversation, so unlike the pinned list you do **not** set a UID or a GUID.
+
+<Tabs>
+<Tab title="TypeScript">
+```typescript
+let limit: number = 50,
+  messagesRequest: CometChat.MessagesRequest =
+    new CometChat.MessagesRequestBuilder()
+      .setLimit(limit)
+      .setSaved(true)
+      .build();
+```
+
+</Tab>
+
+<Tab title="JavaScript">
+```javascript
+let limit = 50;
+let messagesRequest = new CometChat.MessagesRequestBuilder()
+  .setLimit(limit)
+  .setSaved(true)
+  .build();
+```
+
+</Tab>
+
+</Tabs>
+
+Saves are private to the logged-in user. Because the rows come from different conversations, use `getConversationId()`, `getReceiverType()` and `getReceiverId()` on each message to route back to the right conversation. See [Save A Message](/sdk/javascript/save-message) for the full feature.
+
 ## Hide threaded messages in user/group conversations
 
 Use `hideReplies(true)` to exclude threaded messages from the main conversation. Default is `false`.
@@ -722,7 +817,7 @@
 ```typescript
 let UID: string = "UID",
   limit: number = 30,
   messagesRequest: CometChat.MessagesRequest =
     new CometChat.MessagesRequestBuilder()
       .setUID(UID)
       .setLimit(limit)
@@ -736,7 +831,7 @@
 ```javascript
 let UID = "UID";
 let limit = 30;
 let messagesRequest = new CometChat.MessagesRequestBuilder()
   .setUID(UID)
   .setLimit(limit)
   .hideReplies(true)
@@ -749,7 +844,7 @@
 ```typescript
 let GUID: string = "GUID",
   limit: number = 30,
   messagesRequest: CometChat.MessagesRequest =
     new CometChat.MessagesRequestBuilder()
       .setGUID(GUID)
       .setLimit(limit)
@@ -763,7 +858,7 @@
 ```javascript
 let GUID = "GUID";
 let limit = 30;
 let messagesRequest = new CometChat.MessagesRequestBuilder()
   .setGUID(GUID)
   .setLimit(limit)
   .hideReplies(true)
@@ -782,7 +877,7 @@
 ```typescript
 let UID: string = "UID",
   limit: number = 30,
   messagesRequest: CometChat.MessagesRequest =
     new CometChat.MessagesRequestBuilder()
       .setUID(UID)
       .setLimit(limit)
@@ -796,7 +891,7 @@
 ```javascript
 let UID = "UID";
 let limit = 30;
 let messagesRequest = new CometChat.MessagesRequestBuilder()
   .setUID(UID)
   .setLimit(limit)
   .hideDeletedMessages(true)
@@ -809,7 +904,7 @@
 ```typescript
 let GUID: string = "GUID",
   limit: number = 30,
   messagesRequest: CometChat.MessagesRequest =
     new CometChat.MessagesRequestBuilder()
       .setGUID(GUID)
       .setLimit(limit)
@@ -823,7 +918,7 @@
 ```javascript
 let GUID = "GUID";
 let limit = 30;
 let messagesRequest = new CometChat.MessagesRequestBuilder()
   .setGUID(GUID)
   .setLimit(limit)
   .hideDeletedMessages(true)
@@ -842,7 +937,7 @@
 ```typescript
 let UID: string = "UID",
   limit: number = 30,
   messagesRequest: CometChat.MessagesRequest =
     new CometChat.MessagesRequestBuilder()
       .setUID(UID)
       .setLimit(limit)
@@ -856,7 +951,7 @@
 ```javascript
 let UID = "UID";
 let limit = 30;
 let messagesRequest = new CometChat.MessagesRequestBuilder()
   .setUID(UID)
   .setLimit(limit)
   .hideQuotedMessages(true)
@@ -869,7 +964,7 @@
 ```typescript
 let GUID: string = "GUID",
   limit: number = 30,
   messagesRequest: CometChat.MessagesRequest =
     new CometChat.MessagesRequestBuilder()
       .setGUID(GUID)
       .setLimit(limit)
@@ -883,7 +978,7 @@
 ```javascript
 let GUID = "GUID";
 let limit = 30;
 let messagesRequest = new CometChat.MessagesRequestBuilder()
   .setGUID(GUID)
   .setLimit(limit)
   .hideQuotedMessages(true)
@@ -902,8 +997,8 @@
 ```typescript
 let UID: string = "UID",
   limit: number = 30,
   tags: Array<String> = ["starredMessage"],
   messagesRequest: CometChat.MessagesRequest =
     new CometChat.MessagesRequestBuilder()
       .setUID(UID)
       .setLimit(limit)
@@ -917,8 +1012,8 @@
 ```javascript
 let UID = "UID";
 let limit = 30;
 let tags = ["starredMessage"];
 let messagesRequest = new CometChat.MessagesRequestBuilder()
   .setUID(UID)
   .setLimit(limit)
   .setTags(tags)
@@ -931,8 +1026,8 @@
 ```typescript
 let GUID: string = "GUID",
   limit: number = 30,
   tags: Array<String> = ["starredMessage"],
   messagesRequest: CometChat.MessagesRequest =
     new CometChat.MessagesRequestBuilder()
       .setGUID(GUID)
       .setLimit(limit)
@@ -946,8 +1041,8 @@
 ```javascript
 let GUID = "GUID";
 let limit = 30;
 let tags = ["starredMessage"];
 let messagesRequest = new CometChat.MessagesRequestBuilder()
   .setGUID(GUID)
   .setLimit(limit)
   .setTags(tags)
@@ -966,7 +1061,7 @@
 ```typescript
 let UID: string = "UID",
   limit: number = 30,
   messagesRequest: CometChat.MessagesRequest =
     new CometChat.MessagesRequestBuilder()
       .setGUID(UID)
       .setLimit(limit)
@@ -980,7 +1075,7 @@
 ```javascript
 let UID = "UID";
 let limit = 30;
 let messagesRequest = new CometChat.MessagesRequestBuilder()
   .setUID(UID)
   .setLimit(limit)
   .withTags(true)
@@ -993,7 +1088,7 @@
 ```typescript
 let GUID: string = "GUID",
   limit: number = 30,
   messagesRequest: CometChat.MessagesRequest =
     new CometChat.MessagesRequestBuilder()
       .setGUID(GUID)
       .setLimit(limit)
@@ -1007,7 +1102,7 @@
 ```javascript
 let GUID = "GUID";
 let limit = 30;
 let messagesRequest = new CometChat.MessagesRequestBuilder()
   .setGUID(GUID)
   .setLimit(limit)
   .withTags(tags)
@@ -1038,7 +1133,7 @@
 ```typescript
 let UID: string = "UID",
   limit: number = 30,
   messagesRequest: CometChat.MessagesRequest =
     new CometChat.MessagesRequestBuilder()
       .setGUID(UID)
       .setLimit(limit)
@@ -1052,7 +1147,7 @@
 ```javascript
 let UID = "UID";
 let limit = 30;
 let messagesRequest = new CometChat.MessagesRequestBuilder()
   .setUID(UID)
   .setLimit(limit)
   .hasLinks(true)
@@ -1065,7 +1160,7 @@
 ```typescript
 let GUID: string = "GUID",
   limit: number = 30,
   messagesRequest: CometChat.MessagesRequest =
     new CometChat.MessagesRequestBuilder()
       .setGUID(GUID)
       .setLimit(limit)
@@ -1079,7 +1174,7 @@
 ```javascript
 let GUID = "GUID";
 let limit = 30;
 let messagesRequest = new CometChat.MessagesRequestBuilder()
   .setGUID(GUID)
   .setLimit(limit)
   .hasLinks(true)
@@ -1104,7 +1199,7 @@
 ```typescript
 let UID: string = "UID",
   limit: number = 30,
   messagesRequest: CometChat.MessagesRequest =
     new CometChat.MessagesRequestBuilder()
       .setGUID(UID)
       .setLimit(limit)
@@ -1118,7 +1213,7 @@
 ```javascript
 let UID = "UID";
 let limit = 30;
 let messagesRequest = new CometChat.MessagesRequestBuilder()
   .setUID(UID)
   .setLimit(limit)
   .hasAttachments(true)
@@ -1131,7 +1226,7 @@
 ```typescript
 let GUID: string = "GUID",
   limit: number = 30,
   messagesRequest: CometChat.MessagesRequest =
     new CometChat.MessagesRequestBuilder()
       .setGUID(GUID)
       .setLimit(limit)
@@ -1145,7 +1240,7 @@
 ```javascript
 let GUID = "GUID";
 let limit = 30;
 let messagesRequest = new CometChat.MessagesRequestBuilder()
   .setGUID(GUID)
   .setLimit(limit)
   .hasAttachments(true)
@@ -1173,7 +1268,7 @@
 ```typescript
 let UID: string = "UID",
   limit: number = 30,
   messagesRequest: CometChat.MessagesRequest =
     new CometChat.MessagesRequestBuilder()
       .setGUID(UID)
       .setLimit(limit)
@@ -1187,7 +1282,7 @@
 ```javascript
 let UID = "UID";
 let limit = 30;
 let messagesRequest = new CometChat.MessagesRequestBuilder()
   .setUID(UID)
   .setLimit(limit)
   .hasReactions(true)
@@ -1200,7 +1295,7 @@
 ```typescript
 let GUID: string = "GUID",
   limit: number = 30,
   messagesRequest: CometChat.MessagesRequest =
     new CometChat.MessagesRequestBuilder()
       .setGUID(GUID)
       .setLimit(limit)
@@ -1214,7 +1309,7 @@
 ```javascript
 let GUID = "GUID";
 let limit = 30;
 let messagesRequest = new CometChat.MessagesRequestBuilder()
   .setGUID(GUID)
   .setLimit(limit)
   .hasReactions(true)
@@ -1242,7 +1337,7 @@
 ```typescript
 let UID: string = "UID",
   limit: number = 30,
   messagesRequest: CometChat.MessagesRequest =
     new CometChat.MessagesRequestBuilder()
       .setGUID(UID)
       .setLimit(limit)
@@ -1256,7 +1351,7 @@
 ```javascript
 let UID = "UID";
 let limit = 30;
 let messagesRequest = new CometChat.MessagesRequestBuilder()
   .setUID(UID)
   .setLimit(limit)
   .hasMentions(true)
@@ -1269,7 +1364,7 @@
 ```typescript
 let GUID: string = "GUID",
   limit: number = 30,
   messagesRequest: CometChat.MessagesRequest =
     new CometChat.MessagesRequestBuilder()
       .setGUID(GUID)
       .setLimit(limit)
@@ -1283,7 +1378,7 @@
 ```javascript
 let GUID = "GUID";
 let limit = 30;
 let messagesRequest = new CometChat.MessagesRequestBuilder()
   .setGUID(GUID)
   .setLimit(limit)
   .hasMentions(true)
@@ -1298,7 +1393,7 @@
 
 ## Messages with particular user mentions
 
 Use `setMentionedUIDs()` with an array of UIDs to fetch messages that mention specific users.
 
 <Note>
 
@@ -1311,7 +1406,7 @@
 ```typescript
 let UID: string = "UID",
   limit: number = 30,
   messagesRequest: CometChat.MessagesRequest =
     new CometChat.MessagesRequestBuilder()
       .setGUID(UID)
       .setLimit(limit)
@@ -1325,7 +1420,7 @@
 ```javascript
 let UID = "UID";
 let limit = 30;
 let messagesRequest = new CometChat.MessagesRequestBuilder()
   .setUID(UID)
   .setLimit(limit)
   .setMentionedUIDs(["UID"])
@@ -1338,7 +1433,7 @@
 ```typescript
 let GUID: string = "GUID",
   limit: number = 30,
   messagesRequest: CometChat.MessagesRequest =
     new CometChat.MessagesRequestBuilder()
       .setGUID(GUID)
       .setLimit(limit)
@@ -1352,7 +1447,7 @@
 ```javascript
 let GUID = "GUID";
 let limit = 30;
 let messagesRequest = new CometChat.MessagesRequestBuilder()
   .setGUID(GUID)
   .setLimit(limit)
   .setMentionedUIDs(["UID"])
@@ -1380,7 +1475,7 @@
 ```typescript
 let UID: string = "UID",
   limit: number = 30,
   messagesRequest: CometChat.MessagesRequest =
     new CometChat.MessagesRequestBuilder()
       .setGUID(UID)
       .setLimit(limit)
@@ -1394,7 +1489,7 @@
 ```javascript
 let UID = "UID";
 let limit = 30;
 let messagesRequest = new CometChat.MessagesRequestBuilder()
   .setUID(UID)
   .setLimit(limit)
   .setAttachmentTypes([CometChat.AttachmentType.IMAGE, CometChat.AttachmentType.VIDEO])
@@ -1407,7 +1502,7 @@
 ```typescript
 let GUID: string = "GUID",
   limit: number = 30,
   messagesRequest: CometChat.MessagesRequest =
     new CometChat.MessagesRequestBuilder()
       .setGUID(GUID)
       .setLimit(limit)
@@ -1421,7 +1516,7 @@
 ```javascript
 let GUID = "GUID";
 let limit = 30;
 let messagesRequest = new CometChat.MessagesRequestBuilder()
   .setGUID(GUID)
   .setLimit(limit)
   .setAttachmentTypes([CometChat.AttachmentType.IMAGE, CometChat.AttachmentType.VIDEO])