Docs: Offline Support for JavaScript SDK

docs.json

@@ -3163,6 +3163,19 @@
                               "sdk/javascript/reactions"
                             ]
                           },
+                          {
+                            "group": "Offline Support",
+                            "pages": [
+                              "sdk/javascript/offline-overview",
+                              "sdk/javascript/offline-enable",
+                              "sdk/javascript/offline-cached-data",
+                              "sdk/javascript/offline-send",
+                              "sdk/javascript/offline-sync",
+                              "sdk/javascript/offline-media-caching",
+                              "sdk/javascript/offline-encryption",
+                              "sdk/javascript/offline-reference"
+                            ]
+                          },
                           "sdk/javascript/calling-overview",
                           {
                             "group": "Users",

sdk/javascript/ai-moderation.mdx

@@ -77,6 +77,8 @@
 | 3. AI Processing  | Moderation service analyzes the content            |
 | 4. Result Event   | `onMessageModerated` event fires with final status |
 
+The `PENDING` here is the moderation status (`getModerationStatus()`). It is separate from the send status: with offline support enabled and a `MessageSentListener`, `onMessagePending` fires first, before the message reaches the server, and `onError` can mean the message is queued, not failed. See [Send While Offline](/sdk/javascript/offline-send).
+
 ## Supported Message Types
 
 Moderation is triggered **only** for the following message types:
@@ -98,7 +100,7 @@
 | Pending     | `CometChat.ModerationStatus.PENDING`     | Message is being processed by moderation        |
 | Approved    | `CometChat.ModerationStatus.APPROVED`    | Message passed moderation and is visible        |
 | Disapproved | `CometChat.ModerationStatus.DISAPPROVED` | Message violated rules and was blocked          |
 | Unmoderated | `CometChat.ModerationStatus.UNMODERATED` | Message was not subject to moderation (default) |
 
 ## Implementation
 
@@ -109,7 +111,7 @@
 <Tabs>
   <Tab title="TypeScript">
     ```typescript
     const textMessage = new CometChat.TextMessage(
       receiverUID,
       "Hello, how are you?",
       CometChat.RECEIVER_TYPE.USER
@@ -134,7 +136,7 @@
   </Tab>
   <Tab title="JavaScript">
     ```javascript
     const textMessage = new CometChat.TextMessage(
       receiverUID,
       "Hello, how are you?",
       CometChat.RECEIVER_TYPE.USER
@@ -414,7 +416,7 @@
 
 <Warning>
   Always remove listeners when they're no longer needed (e.g., on component
   unmount or page navigation). Failing to remove listeners can cause memory
   leaks and duplicate event handling.
 </Warning>
 

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

@@ -3,7 +3,7 @@
 description: "Use CometChat real-time listeners for user presence, groups, messages, calls, AI assistant events, and ongoing calls."
 ---
 
-CometChat provides the following listeners.
+CometChat provides the following listeners. With offline support enabled, four more listeners report what the SDK does on the device; see [Offline listeners](#offline-listeners).
 
 1. [User Listener](/sdk/javascript/all-real-time-listeners#user-listener)
 2. [Group Listener](/sdk/javascript/all-real-time-listeners#group-listener)
@@ -35,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 });
     },
   })
 );
@@ -92,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`:
 
@@ -117,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,
       });
     },
   })
@@ -291,6 +291,8 @@
 
 Receive events for incoming messages, typing indicators, read/delivery receipts, message edits/deletes, reactions, and moderation results.
 
+With offline support enabled, `MessageListener` also receives `onMessagesSynced` after the SDK catches up on reconnect. It carries updates to already-cached messages that changed while offline (reactions, edits, deletes and receipts); messages that arrived while offline still come through the typed callbacks such as `onTextMessageReceived`. See [Stay in Sync](/sdk/javascript/offline-sync).
+
 | Method                                                                  | Information                                                                                                                                                          |
 | ----------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
 | **onTextMessageReceived(message: CometChat.TextMessage)**               | This event is triggered when a Text Message is received.                                                                                                             |
@@ -312,7 +314,7 @@
 | **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.                                                                 |
@@ -328,23 +330,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);
@@ -365,10 +367,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);
@@ -771,7 +773,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">
@@ -783,7 +785,7 @@
 console.log("User joined:", user);
 },
 onUserLeft: (user: any) => {
 console.log("User left:", user);
 },
 onCallEnded: () => {
 console.log("Call ended");
@@ -849,15 +851,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);
@@ -912,10 +914,10 @@
 ```typescript
 const listenerID: string = "UNIQUE_LISTENER_ID";
 CometChat.addConnectionListener(
   listenerID,
   new CometChat.ConnectionListener({
     onConnected: () => {
       console.log("ConnectionListener :: connected");
     },
     inConnecting: () => {
       console.log("ConnectionListener :: connecting");
@@ -934,10 +936,10 @@
 ```javascript
 const listenerID = "UNIQUE_LISTENER_ID";
 CometChat.addConnectionListener(
   listenerID,
   new CometChat.ConnectionListener({
     onConnected: () => {
       console.log("ConnectionListener :: connected");
     },
     inConnecting: () => {
       console.log("ConnectionListener :: connecting");
@@ -960,6 +962,18 @@
 CometChat.removeConnectionListener("UNIQUE_LISTENER_ID");
 ```
 
+
+## Offline Listeners
+
+With offline support enabled, these listeners report what the SDK does on the device rather than events from the server. Each is documented with examples on its own page.
+
+| Listener | What it reports | Details |
+|---|---|---|
+| `OfflineMessageListener` | Every outbox transition, app-wide: a message queued, sent or failed | [Send While Offline](/sdk/javascript/offline-send) |
+| `SyncListener` | Progress and outcome of each catch-up sync | [Stay in Sync](/sdk/javascript/offline-sync) |
+| `OfflineCacheResetListener` | The on-device cache was rebuilt, for example after the encryption key was lost | [Encrypt the Cache](/sdk/javascript/offline-encryption) |
+| `MediaDownloadListener` | A background media download finished or failed | [Media Caching](/sdk/javascript/offline-media-caching) |
+
 ---
 
 ## Next Steps

sdk/javascript/block-users.mdx

@@ -14,7 +14,7 @@
 | Key classes | `CometChat.User` (access via `getBlockedByMe()`, `getHasBlockedMe()`); direction via `CometChat.BlockedUsersRequest.directions.BLOCKED_BY_ME` / `.HAS_BLOCKED_ME` / `.BOTH` |
 | Primary output | `blockUsers()` / `unblockUsers()` resolve to a `{ uid: "success" \| "fail" }` object (each UID processed independently); `fetchNext()` resolves to `Promise<CometChat.User[]>`; all reject with `CometChat.CometChatException` |
 | Prerequisites | SDK initialized via [`CometChat.init()`](/sdk/javascript/setup-sdk) and a logged-in user via [`CometChat.login()`](/sdk/javascript/authentication-overview) |
 | Constraints | `setDirection()` default is `BOTH`; `blockUsers()` / `unblockUsers()` take an array of UIDs |
 | Related | [Retrieve Users](/sdk/javascript/retrieve-users) · [User Presence](/sdk/javascript/user-presence) · [User Management](/sdk/javascript/user-management) · [Flag a Message](/sdk/javascript/flag-message) |
 | Full reference | [`User`](/sdk/reference/entities#user) |
 
@@ -22,12 +22,12 @@
 
 ## Block Users
 
 Block users to prevent all communication with them. Use `blockUsers()` with an array of UIDs.
 
 <Tabs>
 <Tab title="TypeScript">
 ```typescript
 const usersList: String[] = ["UID1", "UID2", "UID3"];
 
 CometChat.blockUsers(usersList).then(
 (list: Object) => {
@@ -59,7 +59,7 @@
 const usersList = ["UID1", "UID2", "UID3"];
 
 try {
   const list = await CometChat.blockUsers(usersList);
   console.log("users list blocked", { list });
 } catch (error) {
   console.log("Blocking user fails with error", error);
@@ -70,11 +70,11 @@
 
 </Tabs>
 
 Returns an object with UIDs as keys and `"success"` or `"fail"` as values. Each [`User`](/sdk/reference/entities#user) in the request is processed independently.
 
 ## Unblock Users
 
 Unblock previously blocked users using `unblockUsers()` with an array of UIDs.
 
 <Tabs>
 <Tab title="TypeScript">
@@ -122,7 +122,7 @@
 
 </Tabs>
 
 Returns an object with UIDs as keys and `"success"` or `"fail"` as values. Each [`User`](/sdk/reference/entities#user) in the request is processed independently.
 
 ## Get List of Blocked Users
 
@@ -157,13 +157,15 @@
 
 ### Set Search Keyword
 
+<Note>With offline support on, this filter is answered by the server only; `onCachedUsers` does not fire.</Note>
+
 Filters blocked users by a search string.
 
 <Tabs>
 <Tab title="TypeScript">
 ```typescript
 let limit: number = 30;
 let searchKeyword: string = "super";
 let blockedUsersRequest: CometChat.BlockedUsersRequest = new CometChat.BlockedUsersRequestBuilder()
   .setLimit(limit)
   .setSearchKeyword(searchKeyword)
@@ -175,7 +177,7 @@
 <Tab title="JavaScript">
 ```javascript
 let limit = 30;
 let searchKeyword = "super";
 let blockedUsersRequest = new CometChat.BlockedUsersRequestBuilder()
                   				.setLimit(limit)
                   				.setSearchKeyword(searchKeyword)
@@ -249,7 +251,7 @@
   .build();
 
 blockedUsersRequest.fetchNext().then(
 (userList: CometChat.User[]) => {
 console.log("Blocked user list received:", userList);
 }, (error: CometChat.CometChatException) => {
 console.log("Blocked user list fetching failed with error:", error);
@@ -288,6 +290,11 @@
 | blockedByMe  | `getBlockedByMe()`  | `boolean`   | Whether the logged-in user has blocked this user |
 | hasBlockedMe | `getHasBlockedMe()` | `boolean`   | Whether this user has blocked the logged-in user |
 
+
+## Offline Behaviour
+
+With offline support enabled, `BlockedUsersRequest.fetchNext()` accepts a `UserFetchListener` and first delivers `onCachedUsers` from the SDK's own blocked-users list, which it refreshes on login and on reconnect and updates when you call `blockUsers()` or `unblockUsers()`. Then `onServerUsers` delivers the live page to reconcile by `uid`; the server page is not saved to the device. The cached page is empty when no users are blocked. When `setSearchKeyword()` is set, the cached phase is skipped, so `onCachedUsers` does not fire. Offline, the read ends with `onError` with code `FAILED_TO_FETCH` after the cached page, or with `onError` alone when the cached phase is skipped. See [Show Cached Data](/sdk/javascript/offline-cached-data).
+
 ---
 
 ## Next Steps

sdk/javascript/campaigns.mdx

@@ -90,12 +90,12 @@
             "light": "transparent",
             "dark": "transparent"
           },
           "textColor": {
             "light": "#6C5CE7",
             "dark": "#6C5CE7"
           },
           "size": 40,
           "fontSize": 13,
           "borderRadius": 6,
           "padding": {
             "top": 0,
@@ -113,14 +113,14 @@
       "id": "col_98fed9bd-1a95-4cee-aa81-84a9016e41f2"
     }
   ],
   "fallbackText": "",
   "style": {
     "background": {
       "light": "#E8E8E8",
       "dark": "#E8E8E8"
     },
     "borderRadius": 16,
     "borderColor": {
       "light": "#DFE6E9",
       "dark": "#DFE6E9"
     },
@@ -224,6 +224,20 @@
 
 ---
 
+## Offline Behaviour
+
+With offline support enabled, `NotificationFeedRequest.fetchNext()` accepts a `NotificationFeedFetchListener` and first delivers `onCachedNotificationFeedItems` from the device (empty when nothing was recorded), then `onServerNotificationFeedItems` with the live page to reconcile by item `id`. Offline, the read ends with `onError` with code `FAILED_TO_FETCH` after the cached page. A `fetchNext()` started while another fetch of the same request is running ends with `onError` with code `REQUEST_IN_PROGRESS`. See [Show Cached Data](/sdk/javascript/offline-cached-data).
+
+| Builder method | Offline |
+|---|---|
+| `setLimit()` | Cached |
+| `setReadState()` | Cached |
+| `setCategory()` | Cached |
+| `setChannelId()` | Cached |
+| `setTags()` | Cached |
+| `setDateFrom()` | Cached |
+| `setDateTo()` | Cached |
+
 ## Retrieve Notification Categories
 
 Use `NotificationCategoriesRequestBuilder` to fetch available categories for filter chips.
@@ -231,7 +245,7 @@
 <Tabs>
 <Tab title="JavaScript">
 ```javascript
 const categoriesRequest = new CometChat.NotificationCategoriesRequestBuilder()
   .setLimit(50)
   .build();
 
@@ -467,7 +481,7 @@
 <Tabs>
 <Tab title="JavaScript">
 ```javascript
 const pushNotification = new CometChat.PushNotification(pushPayloadJson);
 
 CometChat.markPushNotificationDelivered(pushNotification).then(
   () => { /* Success */ },
@@ -565,10 +579,10 @@
             window.open(action.url, "_blank");
             break;
           case "chatWithUser":
             // Navigate to chat with action.uid
             break;
           case "chatWithGroup":
             // Navigate to group chat with action.guid
             break;
         }
       }}
@@ -589,15 +603,15 @@
 
 | Action Type | Parameters | Description |
 | --- | --- | --- |
 | `openUrl` | url, openIn | Open a URL in browser or webview |
 | `chatWithUser` | uid | Navigate to 1:1 chat |
 | `chatWithGroup` | guid | Navigate to group chat |
 | `sendMessage` | text, receiverUid, receiverGuid | Send a text message |
 | `copyToClipboard` | value | Copy text to clipboard |
 | `downloadFile` | url, filename | Download a file |
 | `initiateCall` | callType (audio/video), uid, guid | Start a call |
 | `apiCall` | url, method, headers, body | Make an HTTP request |
 | `customCallback` | callbackId, payload | App-specific logic |
 
 ---
 

sdk/javascript/connection-status.mdx

@@ -5,6 +5,8 @@
 
 CometChat SDK provides you with a mechanism to get real-time status of the connection to CometChat web-socket servers.
 
+With offline support enabled, your app keeps working without a connection: cached chats are shown instantly, and messages you send with a `MessageSentListener` are queued and delivered automatically on reconnect. See [Show Cached Data](/sdk/javascript/offline-cached-data) and [Send While Offline](/sdk/javascript/offline-send).
+
 Connection Status provides you with the below 3 methods to get the status of the connection to CometChat web-socket servers:
 
 | Delegate Method | Information                                                                                                                                      |
@@ -20,14 +22,14 @@
 <Tabs>
 <Tab title="TypeScript">
 ```typescript
 const connectionStatus: string = CometChat.getConnectionStatus();
 ```
 
 </Tab>
 
 <Tab title="JavaScript">
 ```javascript
 const connectionStatus = CometChat.getConnectionStatus();
 ```
 
 </Tab>
@@ -48,10 +50,10 @@
     onConnected: () => {
       console.log("ConnectionListener => On Connected");
     },
     inConnecting: () => {
       console.log("ConnectionListener => In connecting");
     },
     onDisconnected: () => {
       console.log("ConnectionListener => On Disconnected");
     },
   })
@@ -69,10 +71,10 @@
     onConnected: () => {
       console.log("ConnectionListener => On Connected");
     },
     inConnecting: () => {
       console.log("ConnectionListener => In connecting");
     },
     onDisconnected: () => {
       console.log("ConnectionListener => On Disconnected");
     },
   })
@@ -85,7 +87,7 @@
 
 <Warning>
   Always remove connection listeners when they're no longer needed (e.g., on
   component unmount or page navigation). Failing to remove listeners can cause
   memory leaks and duplicate event handling.
 </Warning>
 

sdk/javascript/delete-group.mdx

@@ -7,6 +7,8 @@ description: "Delete CometChat groups from JavaScript apps by GUID when the logg
 
 Use `deleteGroup()` with the group's GUID.
 
+Deleting a group needs a connection. With offline support enabled, `deleteGroup()` is **not** queued for later. After it succeeds, the group's conversation and cached messages are removed from the on-device cache at the next catch-up sync, and any messages still queued to it then fail with reason `DISCARDED`. See [Send While Offline](/sdk/javascript/offline-send).
+
 <Tabs>
 <Tab title="TypeScript">
 ```typescript

sdk/javascript/delete-message.mdx

@@ -12,10 +12,12 @@
 
 Use `deleteMessage()` with the message ID.
 
+Deleting a message needs a connection. With offline support enabled, `deleteMessage()` is **not** queued for later. After it succeeds, the deletion is applied to the message in the on-device cache if it is already cached; it never adds a new message. See [Send While Offline](/sdk/javascript/offline-send).
+
 <Tabs>
 <Tab title="TypeScript">
 ```typescript
 let messageId: string = "1";
 
 CometChat.deleteMessage(messageId).then(
 (message: CometChat.BaseMessage) => {
@@ -58,7 +60,7 @@
 
 </Tabs>
 
 The deleted message object is returned with `deletedAt` (timestamp) and `deletedBy` (UID of deleter) fields set.
 
 The `deleteMessage()` method returns a [`BaseMessage`](/sdk/reference/messages#basemessage) object.
 
@@ -66,8 +68,8 @@
 
 | Field     | Getter           | Return Type | Description                             |
 | --------- | ---------------- | ----------- | --------------------------------------- |
 | deletedAt | `getDeletedAt()` | `number`    | Timestamp when the message was deleted  |
 | deletedBy | `getDeletedBy()` | `string`    | UID of the user who deleted the message |
 
 Message editing in CometChat is controlled by -
 
@@ -124,8 +126,8 @@
 
 | Field     | Getter           | Return Type | Description                             |
 | --------- | ---------------- | ----------- | --------------------------------------- |
 | deletedAt | `getDeletedAt()` | `number`    | Timestamp when the message was deleted  |
 | deletedBy | `getDeletedBy()` | `string`    | UID of the user who deleted the message |
 
 ## Missed Message Delete Events
 

sdk/javascript/edit-message.mdx

@@ -12,6 +12,8 @@
 
 Use `editMessage()` with a [`TextMessage`](/sdk/reference/messages#textmessage) or [`CustomMessage`](/sdk/reference/messages#custommessage) object. Set the message ID using `setId()`.
 
+Editing a message needs a connection. With offline support enabled, `editMessage()` is **not** queued for later. After it succeeds, the edit is applied to the message in the on-device cache if it is already cached; it never adds a new message. See [Send While Offline](/sdk/javascript/offline-send).
+
 ### Add/Update Tags
 
 Use `setTags()` to update tags when editing. New tags replace existing ones.
@@ -63,10 +65,10 @@
 <Tab title="TypeScript">
 ```typescript
 let receiverID: string = "RECEIVER_UID";
 let messageText: string = "Hello world!";
 let receiverType: string = CometChat.RECEIVER_TYPE.USER;
 let messageId: number = 1;
 let textMessage: CometChat.TextMessage = new CometChat.TextMessage(receiverID, messageText, receiverType);
 
 textMessage.setId(messageId);
 
@@ -135,8 +137,8 @@
 
 | Field    | Getter          | Return Type | Description                            |
 | -------- | --------------- | ----------- | -------------------------------------- |
 | editedAt | `getEditedAt()` | `number`    | Timestamp when the message was edited  |
 | editedBy | `getEditedBy()` | `string`    | UID of the user who edited the message |
 
 By default, CometChat allows certain users to edit a message.
 
@@ -190,7 +192,7 @@
 </Tabs>
 
 <Warning>
 Always remove message listeners when they're no longer needed (e.g., on component unmount or page navigation). Failing to remove listeners can cause memory leaks and duplicate event handling.
 
 ```javascript
 CometChat.removeMessageListener("UNIQUE_LISTENER_ID");
@@ -204,8 +206,8 @@
 
 | Field    | Getter          | Return Type | Description                            |
 | -------- | --------------- | ----------- | -------------------------------------- |
 | editedAt | `getEditedAt()` | `number`    | Timestamp when the message was edited  |
 | editedBy | `getEditedBy()` | `string`    | UID of the user who edited the message |
 
 ## Missed Message Edit Events
 

sdk/javascript/group-kick-ban-members.mdx

@@ -1,6 +1,6 @@
 ---
 title: "Ban Or Kick Member From A Group"
 description: "Kick, ban, and unban CometChat group members in JavaScript apps when the logged-in user is an admin or moderator."
 ---
 
 <Accordion title="AI Integration Quick Reference">
@@ -15,7 +15,7 @@
 | Primary output | `kickGroupMember()` / `banGroupMember()` / `unbanGroupMember()` resolve to `boolean` (`true`) · `BannedMembersRequest.fetchNext()` resolves to `CometChat.GroupMember[]` · all reject with `CometChat.CometChatException` |
 | Listeners registered | `CometChat.GroupListener` via `CometChat.addGroupListener(listenerID, ...)` / `CometChat.removeGroupListener(listenerID)`; key callbacks `onGroupMemberKicked`, `onGroupMemberBanned`, `onGroupMemberUnbanned` |
 | Prerequisites | SDK initialized via [`CometChat.init()`](/sdk/javascript/setup-sdk) and a logged-in user via [`CometChat.login()`](/sdk/javascript/authentication-overview) |
 | Constraints | Kick, ban, and unban can only be performed by the group **Admin** or **Moderator**. A kicked user can rejoin; a banned user cannot rejoin until unbanned |
 | Related | [Add Members](/sdk/javascript/group-add-members) · [Change Member Scope](/sdk/javascript/group-change-member-scope) · [Retrieve Group Members](/sdk/javascript/retrieve-group-members) · [Leave a Group](/sdk/javascript/leave-group) |
 | Full reference | [`GroupMember`](/sdk/reference/entities#groupmember) · [`User`](/sdk/reference/entities#user) · [`Group`](/sdk/reference/entities#group) · [`Action`](/sdk/reference/messages#action) |
 
@@ -25,7 +25,7 @@
 
 1. Kick a member from the group
 2. Ban a member from the group
 3. Unban a member from the group
 4. Update the scope of the member of the group
 
 All the above actions can only be performed by the **Admin** or the **Moderator** of the group.
@@ -132,9 +132,9 @@
 
 On success, the method resolves with a `boolean` value (`true`) confirming the operation.
 
 ## Unban a Group Member
 
 Admins or Moderators can unban a previously banned member using `unbanGroupMember()`.
 
 <Tabs>
 <Tab title="TypeScript">
@@ -218,6 +218,8 @@
 
 ### Set Search Keyword
 
+<Note>With offline support on, this filter is answered by the server only; the cached page is empty.</Note>
+
 Filters banned members by a search string.
 
 <Tabs>
@@ -225,7 +227,7 @@
 ```typescript
 let GUID: string = "GUID";
 let limit: number = 30;
 let searchKeyword: string = "super";
 let bannedGroupMembersRequest: CometChat.BannedMembersRequest = new CometChat.BannedMembersRequestBuilder(GUID)
   .setLimit(limit)
   .setSearchKeyword(searchKeyword)
@@ -238,7 +240,7 @@
 ```javascript
 let GUID = "GUID";
 let limit = 30;
 let searchKeyword = "super";
 let bannedGroupMembersRequest = new CometChat.BannedMembersRequestBuilder(GUID)
   																.setLimit(limit)
   																.setSearchKeyword(searchKeyword)
@@ -261,7 +263,7 @@
   .build();
 
 bannedGroupMembersRequest.fetchNext().then(
 (bannedMembers: CometChat.GroupMember[]) => {
 console.log("Banned Group Member list fetched successfully:", bannedMembers);
 }, (error: CometChat.CometChatException) => {
 console.log("Banned Group Member list fetching failed with exception:", error);
@@ -294,6 +296,32 @@
 
 The `fetchNext()` method returns an array of [`GroupMember`](/sdk/reference/entities#groupmember) objects representing the banned members of the group.
 
+### Set Scopes
+
+Filters banned members by one or more scopes (`admin`, `moderator`, `participant`).
+
+<Tabs>
+<Tab title="TypeScript">
+```typescript
+let GUID: string = "GUID";
+let scopes: Array<String> = ["admin", "moderator"];
+let bannedGroupMembersRequest: CometChat.BannedMembersRequest = new CometChat.BannedMembersRequestBuilder(GUID)
+  .setScopes(scopes)
+  .build();
+```
+</Tab>
+
+<Tab title="JavaScript">
+```javascript
+let GUID = "GUID";
+let scopes = ["admin", "moderator"];
+let bannedGroupMembersRequest = new CometChat.BannedMembersRequestBuilder(GUID)
+  .setScopes(scopes)
+  .build();
+```
+</Tab>
+</Tabs>
+
 ## Real-Time Kick/Ban/Unban Events
 
 Implement these `GroupListener` methods to receive real-time notifications:
@@ -315,10 +343,10 @@
 onGroupMemberKicked: (message: CometChat.Action, kickedUser: CometChat.User, kickedBy: CometChat.User, kickedFrom: CometChat.Group) => {
 console.log("User kicked", { message, kickedUser, kickedBy, kickedFrom });
 },
 onGroupMemberBanned: (message: CometChat.Action, bannedUser: CometChat.User, bannedBy: CometChat.User, bannedFrom: CometChat.Group) => {
 console.log("User banned", { message, bannedUser, bannedBy, bannedFrom });
 },
 onGroupMemberUnbanned: (message: CometChat.Action, unbannedUser: CometChat.User, unbannedBy: CometChat.User, unbannedFrom: CometChat.Group) => {
 console.log("User unbanned", { message, unbannedUser, unbannedBy, unbannedFrom });
 }
 })
@@ -353,7 +381,7 @@
 </Tabs>
 
 <Warning>
 Always remove group listeners when they're no longer needed (e.g., on component unmount or page navigation). Failing to remove listeners can cause memory leaks and duplicate event handling.
 
 ```javascript
 CometChat.removeGroupListener("UNIQUE_LISTENER_ID");
@@ -392,6 +420,17 @@
 | `actionOn`  | [User](/sdk/reference/entities#user)   | The member who was unbanned      |
 | `actionFor` | [Group](/sdk/reference/entities#group) | The group                        |
 
+
+## Offline Behaviour
+
+With offline support enabled, `BannedMembersRequest.fetchNext()` accepts a `BannedMemberFetchListener` and first delivers `onCachedBannedGroupMembers` from the device (empty when nothing was recorded), then `onServerBannedGroupMembers` with the live page to reconcile by `uid`. Offline, the read ends with `onError` with code `FAILED_TO_FETCH` after the cached page. A request that uses a server-only filter records nothing, so its cached page is always empty. See [Show Cached Data](/sdk/javascript/offline-cached-data).
+
+| Builder method | Offline |
+|---|---|
+| `setLimit()` | Cached |
+| `setScopes()` | Cached |
+| `setSearchKeyword()` | Server only — cached page is empty |
+
 ---
 
 ## Next Steps

sdk/javascript/mentions.mdx

@@ -32,9 +32,9 @@
 <Tab title="TypeScript (User)">
 ```typescript
 let receiverID: string = "UID";
 let messageText: string = "Hello <@uid:cometchat-uid-1>";
 let receiverType: string = CometChat.RECEIVER_TYPE.USER;
 let textMessage: CometChat.TextMessage = new CometChat.TextMessage(receiverID, messageText, receiverType);
 
 CometChat.sendMessage(textMessage).then(
 (message: CometChat.TextMessage) => {
@@ -74,12 +74,12 @@
 <Tab title="TypeScript (Group)">
 ```typescript
 let receiverID: string = "GUID",
   messageText: string = "Hello world!",
   receiverType: string = CometChat.RECEIVER_TYPE.GROUP,
   textMessage: CometChat.TextMessage = new CometChat.TextMessage(
     receiverID,
     messageText,
     receiverType
   );
 
 CometChat.sendMessage(textMessage).then(
@@ -144,7 +144,7 @@
 ```typescript
 let UID: string = "UID",
   limit: number = 30,
   messagesRequest: CometChat.MessagesRequest =
     new CometChat.MessagesRequestBuilder()
       .setUID(UID)
       .setLimit(limit)
@@ -201,7 +201,7 @@
 ```typescript
 let GUID: string = "GUID",
   limit: number = 30,
   messagesRequest: CometChat.MessagesRequest =
     new CometChat.MessagesRequestBuilder()
       .setGUID(GUID)
       .setLimit(limit)
@@ -260,7 +260,7 @@
 
 | Field                         | Getter                | Return Type                              | Description                             |
 | ----------------------------- | --------------------- | ---------------------------------------- | --------------------------------------- |
 | mentionedUsers                | `getMentionedUsers()` | [`User[]`](/sdk/reference/entities#user) | Array of users mentioned in the message |
 | tags (on each mentioned user) | `getTags()`           | `string[]`                               | Tags associated with the mentioned user |
 
 ## Mentions With Blocked Info
@@ -271,7 +271,7 @@
 
 | Field                                 | Getter                | Return Type                              | Description                                                |
 | ------------------------------------- | --------------------- | ---------------------------------------- | ---------------------------------------------------------- |
 | mentionedUsers                        | `getMentionedUsers()` | [`User[]`](/sdk/reference/entities#user) | Array of users mentioned in the message                    |
 | blockedByMe (on each mentioned user)  | `getBlockedByMe()`    | `boolean`                                | Whether the logged-in user has blocked this mentioned user |
 | hasBlockedMe (on each mentioned user) | `getHasBlockedMe()`   | `boolean`                                | Whether this mentioned user has blocked the logged-in user |
 
@@ -280,7 +280,7 @@
 ```typescript
 let UID: string = "UID",
   limit: number = 30,
   messagesRequest: CometChat.MessagesRequest =
     new CometChat.MessagesRequestBuilder()
       .setUID(UID)
       .setLimit(limit)
@@ -339,7 +339,7 @@
 ```typescript
 let GUID: string = "GUID",
   limit: number = 30,
   messagesRequest: CometChat.MessagesRequest =
     new CometChat.MessagesRequestBuilder()
       .setGUID(GUID)
       .setLimit(limit)
@@ -406,6 +406,16 @@
 
 The getMentionedUsers() method returns an array of [`User`](/sdk/reference/entities#user) objects.
 
+
+## Offline Behaviour
+
+With offline support enabled, these mention fetches run in two phases: `onCachedMessages` delivers the cached page first (even when empty), then `onServerMessages` delivers the reconciled server copy. Offline, the read ends with `onError` with code `FAILED_TO_FETCH` after the cached page. To queue a mentioned message sent while offline, pass a `MessageSentListener` to `sendMessage()`; `onError` can then mean "queued", not "failed" (see [Send While Offline](/sdk/javascript/offline-send)). See [Show Cached Data](/sdk/javascript/offline-cached-data).
+
+| Builder method | Offline behaviour |
+| --- | --- |
+| `mentionsWithTagInfo()` | Cached, without the tag info of the mentioned users |
+| `mentionsWithBlockedInfo()` | Cached, without the blocked info of the mentioned users |
+
 ---
 
 ## Next Steps

sdk/javascript/message-filtering.mdx

@@ -47,7 +47,7 @@
 <Tabs>
 <Tab title="TypeScript">
 ```typescript
 let messagesRequest: CometChat.MessagesRequest =
   new CometChat.MessagesRequestBuilder().setLimit(50).build();
 ```
 
@@ -55,7 +55,7 @@
 
 <Tab title="JavaScript">
 ```javascript
 let messagesRequest = new CometChat.MessagesRequestBuilder()
   .setLimit(50)
   .build();
 ```
@@ -72,7 +72,7 @@
 <Tab title="TypeScript">
 ```typescript
 let UID = "UID";
 let messagesRequest: CometChat.MessagesRequest =
   new CometChat.MessagesRequestBuilder().setUID(UID).setLimit(50).build();
 ```
 
@@ -81,7 +81,7 @@
 <Tab title="JavaScript">
 ```javascript
 let UID = "UID";
 let messagesRequest = new CometChat.MessagesRequestBuilder()
   .setUID(UID)
   .setLimit(50)
   .build();
@@ -101,7 +101,7 @@
 <Tab title="TypeScript">
 ```typescript
 let GUID: string = "GUID";
 let messagesRequest: CometChat.MessagesRequest =
   new CometChat.MessagesRequestBuilder().setGUID(GUID).setLimit(50).build();
 ```
 
@@ -110,7 +110,7 @@
 <Tab title="JavaScript">
 ```javascript
 let GUID = "GUID";
 let messagesRequest = new CometChat.MessagesRequestBuilder()
   .setGUID(GUID)
   .setLimit(50)
   .build();
@@ -130,9 +130,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)
@@ -145,9 +145,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)
@@ -159,9 +159,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)
@@ -174,9 +174,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)
@@ -199,7 +199,7 @@
 let UID: string = "UID",
   timestamp: number = 1602221371,
   limit: number = 30,
   messagesRequest: CometChat.MessagesRequest =
     new CometChat.MessagesRequestBuilder()
       .setUID(UID)
       .setTimestamp(timestamp)
@@ -214,7 +214,7 @@
 let UID = "UID";
 let timestamp = 1602221371;
 let limit = 30;
 let messagesRequest = new CometChat.MessagesRequestBuilder()
   .setUID(UID)
   .setTimestamp(timestamp)
   .setLimit(limit)
@@ -228,7 +228,7 @@
 let GUID: string = "GUID",
   timestamp: number = 1602221371,
   limit: number = 30,
   messagesRequest: CometChat.MessagesRequest =
     new CometChat.MessagesRequestBuilder()
       .setUID(UID)
       .setTimestamp(timestamp)
@@ -243,7 +243,7 @@
 let GUID = "GUID";
 let timestamp = 1602221371;
 let limit = 30;
 let messagesRequest = new CometChat.MessagesRequestBuilder()
   .setGUID(GUID)
   .setTimestamp(timestamp)
   .setLimit(limit)
@@ -265,7 +265,7 @@
 ```typescript
 let UID: string = "UID",
   limit: number = 30,
   messagesRequest: CometChat.MessagesRequest =
     new CometChat.MessagesRequestBuilder()
       .setUID(UID)
       .setUnread(true)
@@ -279,7 +279,7 @@
 ```javascript
 let UID = "UID";
 let limit = 30;
 let messagesRequest = new CometChat.MessagesRequestBuilder()
   .setUID(UID)
   .setUnread(true)
   .setLimit(limit)
@@ -292,7 +292,7 @@
 ```typescript
 let GUID: string = "GUID",
   limit: number = 30,
   messagesRequest: CometChat.MessagesRequest =
     new CometChat.MessagesRequestBuilder()
       .setGUID(GUID)
       .setUnread(true)
@@ -306,7 +306,7 @@
 ```javascript
 let GUID = "GUID";
 let limit = 30;
 let messagesRequest = new CometChat.MessagesRequestBuilder()
   .setGUID(GUID)
   .setUnread(true)
   .setLimit(limit)
@@ -328,7 +328,7 @@
 ```typescript
 let UID: string = "UID",
   limit: number = 30,
   messagesRequest: CometChat.MessagesRequest =
     new CometChat.MessagesRequestBuilder()
       .setUID(UID)
       .hideMessagesFromBlockedUsers(true)
@@ -342,7 +342,7 @@
 ```javascript
 let UID = "UID";
 let limit = 30;
 let messagesRequest = new CometChat.MessagesRequestBuilder()
   .setUID(UID)
   .hideMessagesFromBlockedUsers(true)
   .setLimit(limit)
@@ -355,7 +355,7 @@
 ```typescript
 let GUID: string = "GUID",
   limit: number = 30,
   messagesRequest: CometChat.MessagesRequest =
     new CometChat.MessagesRequestBuilder()
       .setGUID(GUID)
       .hideMessagesFromBlockedUsers(true)
@@ -369,7 +369,7 @@
 ```javascript
 let GUID = "GUID";
 let limit = 30;
 let messagesRequest = new CometChat.MessagesRequestBuilder()
   .setGUID(GUID)
   .hideMessagesFromBlockedUsers(true)
   .setLimit(limit)
@@ -392,7 +392,7 @@
 let UID: string = "UID",
   limit: number = 30,
   timestamp: string = "1602221371",
   messagesRequest: CometChat.MessagesRequest =
     new CometChat.MessagesRequestBuilder()
       .setUID(UID)
       .setUpdatedAfter(timestamp)
@@ -407,7 +407,7 @@
 let UID = "UID";
 let limit = 30;
 let timestamp = 1602221371;
 let messagesRequest = new CometChat.MessagesRequestBuilder()
   .setUID(UID)
   .setUpdatedAfter(timestamp)
   .setLimit(limit)
@@ -421,7 +421,7 @@
 let GUID: string = "GUID",
   limit: number = 30,
   timestamp: string = "1602221371",
   messagesRequest: CometChat.MessagesRequest =
     new CometChat.MessagesRequestBuilder()
       .setGUID(GUID)
       .setUpdatedAfter(timestamp)
@@ -436,7 +436,7 @@
 let GUID = "GUID";
 let limit = 30;
 let timestamp = 1602221371;
 let messagesRequest = new CometChat.MessagesRequestBuilder()
   .setGUID(GUID)
   .setUpdatedAfter(timestamp)
   .setLimit(limit)
@@ -451,6 +451,8 @@
 
 ## Updated messages only
 
+<Note>With offline support on, this filter is answered by the server only; the cached page is empty.</Note>
+
 Use `updatesOnly(true)` with `setUpdatedAfter()` to fetch only updated messages (not newly received ones). This method must be used together with `setUpdatedAfter()`.
 
 <Tabs>
@@ -459,7 +461,7 @@
 let UID: string = "UID",
   limit: number = 30,
   timestamp: string = "1602221371",
   messagesRequest: CometChat.MessagesRequest =
     new CometChat.MessagesRequestBuilder()
       .setUID(UID)
       .setUpdatedAfter(timestamp)
@@ -475,7 +477,7 @@
 let UID = "UID";
 let limit = 30;
 let timestamp = 1602221371;
 let messagesRequest = new CometChat.MessagesRequestBuilder()
   .setUID(UID)
   .setUpdatedAfter(timestamp)
   .updatesOnly(true)
@@ -490,7 +492,7 @@
 let GUID: string = "GUID",
   limit: number = 30,
   timestamp: string = "1602221371",
   messagesRequest: CometChat.MessagesRequest =
     new CometChat.MessagesRequestBuilder()
       .setGUID(GUID)
       .setUpdatedAfter(timestamp)
@@ -506,7 +508,7 @@
 let GUID = "GUID";
 let limit = 30;
 let timestamp = 1602221371;
 let messagesRequest = new CometChat.MessagesRequestBuilder()
   .setGUID(GUID)
   .setUpdatedAfter(timestamp)
   .updatesOnly(true)
@@ -530,7 +532,7 @@
 let UID: string = "UID",
   limit: number = 30,
   categories: Array<String> = ["message", "custom"],
   messagesRequest: CometChat.MessagesRequest =
     new CometChat.MessagesRequestBuilder()
       .setUID(UID)
       .setCategories(categories)
@@ -545,7 +547,7 @@
 let UID = "UID";
 let limit = 30;
 let categories = ["message", "custom"];
 let messagesRequest = new CometChat.MessagesRequestBuilder()
   .setUID(UID)
   .setCategories(categories)
   .setLimit(limit)
@@ -559,7 +561,7 @@
 let GUID: string = "GUID",
   limit: number = 30,
   categories: Array<String> = ["message", "custom"],
   messagesRequest: CometChat.MessagesRequest =
     new CometChat.MessagesRequestBuilder()
       .setGUID(GUID)
       .setCategories(categories)
@@ -574,7 +576,7 @@
 let GUID = "GUID";
 let limit = 30;
 let categories = ["message", "custom"];
 let messagesRequest = new CometChat.MessagesRequestBuilder()
   .setGUID(GUID)
   .setCategories(categories)
   .setLimit(limit)
@@ -598,7 +600,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)
@@ -615,7 +617,7 @@
 let limit = 30;
 let categories = ["message"];
 let types = ["image", "video", "audio", "file"];
 let messagesRequest = new CometChat.MessagesRequestBuilder()
   .setUID(UID)
   .setCategories(categories)
   .setTypes(types)
@@ -631,7 +633,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)
@@ -648,7 +650,7 @@
 let limit = 30;
 let categories = ["message"];
 let types = ["image", "video", "audio", "file"];
 let messagesRequest = new CometChat.MessagesRequestBuilder()
   .setGUID(GUID)
   .setCategories(categories)
   .setTypes(types)
@@ -671,8 +673,8 @@
 ```typescript
 let UID: string = "UID",
   limit: number = 30,
   messageId: number = 1,
   messagesRequest: CometChat.MessagesRequest =
     new CometChat.MessagesRequestBuilder()
       .setUID(UID)
       .setLimit(limit)
@@ -685,9 +687,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)
@@ -700,8 +702,8 @@
 ```typescript
 let GUID: string = "GUID",
   limit: number = 30,
   messageId: number = 1,
   messagesRequest: CometChat.MessagesRequest =
     new CometChat.MessagesRequestBuilder()
       .setGUID(GUID)
       .setLimit(limit)
@@ -714,9 +716,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)
@@ -738,7 +740,7 @@
 ```typescript
 let UID: string = "UID",
   limit: number = 50,
   messagesRequest: CometChat.MessagesRequest =
     new CometChat.MessagesRequestBuilder()
       .setUID(UID)
       .setLimit(limit)
@@ -752,7 +754,7 @@
 ```javascript
 let UID = "UID";
 let limit = 50;
 let messagesRequest = new CometChat.MessagesRequestBuilder()
   .setUID(UID)
   .setLimit(limit)
   .setPinned(true)
@@ -765,7 +767,7 @@
 ```typescript
 let GUID: string = "GUID",
   limit: number = 50,
   messagesRequest: CometChat.MessagesRequest =
     new CometChat.MessagesRequestBuilder()
       .setGUID(GUID)
       .setLimit(limit)
@@ -779,7 +781,7 @@
 ```javascript
 let GUID = "GUID";
 let limit = 50;
 let messagesRequest = new CometChat.MessagesRequestBuilder()
   .setGUID(GUID)
   .setLimit(limit)
   .setPinned(true)
@@ -800,7 +802,7 @@
 <Tab title="TypeScript">
 ```typescript
 let limit: number = 50,
   messagesRequest: CometChat.MessagesRequest =
     new CometChat.MessagesRequestBuilder()
       .setLimit(limit)
       .setSaved(true)
@@ -812,7 +814,7 @@
 <Tab title="JavaScript">
 ```javascript
 let limit = 50;
 let messagesRequest = new CometChat.MessagesRequestBuilder()
   .setLimit(limit)
   .setSaved(true)
   .build();
@@ -833,7 +835,7 @@
 ```typescript
 let UID: string = "UID",
   limit: number = 30,
   messagesRequest: CometChat.MessagesRequest =
     new CometChat.MessagesRequestBuilder()
       .setUID(UID)
       .setLimit(limit)
@@ -847,7 +849,7 @@
 ```javascript
 let UID = "UID";
 let limit = 30;
 let messagesRequest = new CometChat.MessagesRequestBuilder()
   .setUID(UID)
   .setLimit(limit)
   .hideReplies(true)
@@ -860,7 +862,7 @@
 ```typescript
 let GUID: string = "GUID",
   limit: number = 30,
   messagesRequest: CometChat.MessagesRequest =
     new CometChat.MessagesRequestBuilder()
       .setGUID(GUID)
       .setLimit(limit)
@@ -874,7 +876,7 @@
 ```javascript
 let GUID = "GUID";
 let limit = 30;
 let messagesRequest = new CometChat.MessagesRequestBuilder()
   .setGUID(GUID)
   .setLimit(limit)
   .hideReplies(true)
@@ -893,7 +895,7 @@
 ```typescript
 let UID: string = "UID",
   limit: number = 30,
   messagesRequest: CometChat.MessagesRequest =
     new CometChat.MessagesRequestBuilder()
       .setUID(UID)
       .setLimit(limit)
@@ -907,7 +909,7 @@
 ```javascript
 let UID = "UID";
 let limit = 30;
 let messagesRequest = new CometChat.MessagesRequestBuilder()
   .setUID(UID)
   .setLimit(limit)
   .hideDeletedMessages(true)
@@ -920,7 +922,7 @@
 ```typescript
 let GUID: string = "GUID",
   limit: number = 30,
   messagesRequest: CometChat.MessagesRequest =
     new CometChat.MessagesRequestBuilder()
       .setGUID(GUID)
       .setLimit(limit)
@@ -934,7 +936,7 @@
 ```javascript
 let GUID = "GUID";
 let limit = 30;
 let messagesRequest = new CometChat.MessagesRequestBuilder()
   .setGUID(GUID)
   .setLimit(limit)
   .hideDeletedMessages(true)
@@ -953,7 +955,7 @@
 ```typescript
 let UID: string = "UID",
   limit: number = 30,
   messagesRequest: CometChat.MessagesRequest =
     new CometChat.MessagesRequestBuilder()
       .setUID(UID)
       .setLimit(limit)
@@ -967,7 +969,7 @@
 ```javascript
 let UID = "UID";
 let limit = 30;
 let messagesRequest = new CometChat.MessagesRequestBuilder()
   .setUID(UID)
   .setLimit(limit)
   .hideQuotedMessages(true)
@@ -980,7 +982,7 @@
 ```typescript
 let GUID: string = "GUID",
   limit: number = 30,
   messagesRequest: CometChat.MessagesRequest =
     new CometChat.MessagesRequestBuilder()
       .setGUID(GUID)
       .setLimit(limit)
@@ -994,7 +996,7 @@
 ```javascript
 let GUID = "GUID";
 let limit = 30;
 let messagesRequest = new CometChat.MessagesRequestBuilder()
   .setGUID(GUID)
   .setLimit(limit)
   .hideQuotedMessages(true)
@@ -1013,8 +1015,8 @@
 ```typescript
 let UID: string = "UID",
   limit: number = 30,
   tags: Array<String> = ["starredMessage"],
   messagesRequest: CometChat.MessagesRequest =
     new CometChat.MessagesRequestBuilder()
       .setUID(UID)
       .setLimit(limit)
@@ -1028,8 +1030,8 @@
 ```javascript
 let UID = "UID";
 let limit = 30;
 let tags = ["starredMessage"];
 let messagesRequest = new CometChat.MessagesRequestBuilder()
   .setUID(UID)
   .setLimit(limit)
   .setTags(tags)
@@ -1042,8 +1044,8 @@
 ```typescript
 let GUID: string = "GUID",
   limit: number = 30,
   tags: Array<String> = ["starredMessage"],
   messagesRequest: CometChat.MessagesRequest =
     new CometChat.MessagesRequestBuilder()
       .setGUID(GUID)
       .setLimit(limit)
@@ -1057,8 +1059,8 @@
 ```javascript
 let GUID = "GUID";
 let limit = 30;
 let tags = ["starredMessage"];
 let messagesRequest = new CometChat.MessagesRequestBuilder()
   .setGUID(GUID)
   .setLimit(limit)
   .setTags(tags)
@@ -1077,7 +1079,7 @@
 ```typescript
 let UID: string = "UID",
   limit: number = 30,
   messagesRequest: CometChat.MessagesRequest =
     new CometChat.MessagesRequestBuilder()
       .setGUID(UID)
       .setLimit(limit)
@@ -1091,7 +1093,7 @@
 ```javascript
 let UID = "UID";
 let limit = 30;
 let messagesRequest = new CometChat.MessagesRequestBuilder()
   .setUID(UID)
   .setLimit(limit)
   .withTags(true)
@@ -1104,7 +1106,7 @@
 ```typescript
 let GUID: string = "GUID",
   limit: number = 30,
   messagesRequest: CometChat.MessagesRequest =
     new CometChat.MessagesRequestBuilder()
       .setGUID(GUID)
       .setLimit(limit)
@@ -1118,7 +1120,7 @@
 ```javascript
 let GUID = "GUID";
 let limit = 30;
 let messagesRequest = new CometChat.MessagesRequestBuilder()
   .setGUID(GUID)
   .setLimit(limit)
   .withTags(tags)
@@ -1136,6 +1138,8 @@
 
 ## Messages with links
 
+<Note>With offline support on, this filter is answered by the server only; the cached page is empty.</Note>
+
 Use `hasLinks(true)` to fetch only messages containing links. Default is `false`.
 
 <Note>
@@ -1149,7 +1153,7 @@
 ```typescript
 let UID: string = "UID",
   limit: number = 30,
   messagesRequest: CometChat.MessagesRequest =
     new CometChat.MessagesRequestBuilder()
       .setGUID(UID)
       .setLimit(limit)
@@ -1163,7 +1167,7 @@
 ```javascript
 let UID = "UID";
 let limit = 30;
 let messagesRequest = new CometChat.MessagesRequestBuilder()
   .setUID(UID)
   .setLimit(limit)
   .hasLinks(true)
@@ -1176,7 +1180,7 @@
 ```typescript
 let GUID: string = "GUID",
   limit: number = 30,
   messagesRequest: CometChat.MessagesRequest =
     new CometChat.MessagesRequestBuilder()
       .setGUID(GUID)
       .setLimit(limit)
@@ -1190,7 +1194,7 @@
 ```javascript
 let GUID = "GUID";
 let limit = 30;
 let messagesRequest = new CometChat.MessagesRequestBuilder()
   .setGUID(GUID)
   .setLimit(limit)
   .hasLinks(true)
@@ -1215,7 +1219,7 @@
 ```typescript
 let UID: string = "UID",
   limit: number = 30,
   messagesRequest: CometChat.MessagesRequest =
     new CometChat.MessagesRequestBuilder()
       .setGUID(UID)
       .setLimit(limit)
@@ -1229,7 +1233,7 @@
 ```javascript
 let UID = "UID";
 let limit = 30;
 let messagesRequest = new CometChat.MessagesRequestBuilder()
   .setUID(UID)
   .setLimit(limit)
   .hasAttachments(true)
@@ -1242,7 +1246,7 @@
 ```typescript
 let GUID: string = "GUID",
   limit: number = 30,
   messagesRequest: CometChat.MessagesRequest =
     new CometChat.MessagesRequestBuilder()
       .setGUID(GUID)
       .setLimit(limit)
@@ -1256,7 +1260,7 @@
 ```javascript
 let GUID = "GUID";
 let limit = 30;
 let messagesRequest = new CometChat.MessagesRequestBuilder()
   .setGUID(GUID)
   .setLimit(limit)
   .hasAttachments(true)
@@ -1284,7 +1288,7 @@
 ```typescript
 let UID: string = "UID",
   limit: number = 30,
   messagesRequest: CometChat.MessagesRequest =
     new CometChat.MessagesRequestBuilder()
       .setGUID(UID)
       .setLimit(limit)
@@ -1298,7 +1302,7 @@
 ```javascript
 let UID = "UID";
 let limit = 30;
 let messagesRequest = new CometChat.MessagesRequestBuilder()
   .setUID(UID)
   .setLimit(limit)
   .hasReactions(true)
@@ -1311,7 +1315,7 @@
 ```typescript
 let GUID: string = "GUID",
   limit: number = 30,
   messagesRequest: CometChat.MessagesRequest =
     new CometChat.MessagesRequestBuilder()
       .setGUID(GUID)
       .setLimit(limit)
@@ -1325,7 +1329,7 @@
 ```javascript
 let GUID = "GUID";
 let limit = 30;
 let messagesRequest = new CometChat.MessagesRequestBuilder()
   .setGUID(GUID)
   .setLimit(limit)
   .hasReactions(true)
@@ -1353,7 +1357,7 @@
 ```typescript
 let UID: string = "UID",
   limit: number = 30,
   messagesRequest: CometChat.MessagesRequest =
     new CometChat.MessagesRequestBuilder()
       .setGUID(UID)
       .setLimit(limit)
@@ -1367,7 +1371,7 @@
 ```javascript
 let UID = "UID";
 let limit = 30;
 let messagesRequest = new CometChat.MessagesRequestBuilder()
   .setUID(UID)
   .setLimit(limit)
   .hasMentions(true)
@@ -1380,7 +1384,7 @@
 ```typescript
 let GUID: string = "GUID",
   limit: number = 30,
   messagesRequest: CometChat.MessagesRequest =
     new CometChat.MessagesRequestBuilder()
       .setGUID(GUID)
       .setLimit(limit)
@@ -1394,7 +1398,7 @@
 ```javascript
 let GUID = "GUID";
 let limit = 30;
 let messagesRequest = new CometChat.MessagesRequestBuilder()
   .setGUID(GUID)
   .setLimit(limit)
   .hasMentions(true)
@@ -1409,7 +1413,7 @@
 
 ## Messages with particular user mentions
 
 Use `setMentionedUIDs()` with an array of UIDs to fetch messages that mention specific users.
 
 <Note>
 
@@ -1422,7 +1426,7 @@
 ```typescript
 let UID: string = "UID",
   limit: number = 30,
   messagesRequest: CometChat.MessagesRequest =
     new CometChat.MessagesRequestBuilder()
       .setGUID(UID)
       .setLimit(limit)
@@ -1436,7 +1440,7 @@
 ```javascript
 let UID = "UID";
 let limit = 30;
 let messagesRequest = new CometChat.MessagesRequestBuilder()
   .setUID(UID)
   .setLimit(limit)
   .setMentionedUIDs(["UID"])
@@ -1449,7 +1453,7 @@
 ```typescript
 let GUID: string = "GUID",
   limit: number = 30,
   messagesRequest: CometChat.MessagesRequest =
     new CometChat.MessagesRequestBuilder()
       .setGUID(GUID)
       .setLimit(limit)
@@ -1463,7 +1467,7 @@
 ```javascript
 let GUID = "GUID";
 let limit = 30;
 let messagesRequest = new CometChat.MessagesRequestBuilder()
   .setGUID(GUID)
   .setLimit(limit)
   .setMentionedUIDs(["UID"])
@@ -1491,7 +1495,7 @@
 ```typescript
 let UID: string = "UID",
   limit: number = 30,
   messagesRequest: CometChat.MessagesRequest =
     new CometChat.MessagesRequestBuilder()
       .setGUID(UID)
       .setLimit(limit)
@@ -1505,7 +1509,7 @@
 ```javascript
 let UID = "UID";
 let limit = 30;
 let messagesRequest = new CometChat.MessagesRequestBuilder()
   .setUID(UID)
   .setLimit(limit)
   .setAttachmentTypes([CometChat.AttachmentType.IMAGE, CometChat.AttachmentType.VIDEO])
@@ -1518,7 +1522,7 @@
 ```typescript
 let GUID: string = "GUID",
   limit: number = 30,
   messagesRequest: CometChat.MessagesRequest =
     new CometChat.MessagesRequestBuilder()
       .setGUID(GUID)
       .setLimit(limit)
@@ -1532,7 +1536,7 @@
 ```javascript
 let GUID = "GUID";
 let limit = 30;
 let messagesRequest = new CometChat.MessagesRequestBuilder()
   .setGUID(GUID)
   .setLimit(limit)
   .setAttachmentTypes([CometChat.AttachmentType.IMAGE, CometChat.AttachmentType.VIDEO])
@@ -1545,6 +1549,39 @@
 
 The response contains media message objects filtered to the specified attachment types.
 
+
+## Offline Behaviour
+
+With offline support enabled, `fetchPrevious()` / `fetchNext()` accept a `MessageFetchListener` and answer from the on-device cache first (`onCachedMessages`, even when empty) and then from the server (`onServerMessages`). The cache answers a page **only when every filter on the request is locally computable**: a single server-only filter makes the cached page empty with no error, while the server phase still answers in full. Offline, the read ends with `onError` with code `FAILED_TO_FETCH` after the cached page. See [Show Cached Data](/sdk/javascript/offline-cached-data).
+
+| Builder method | Offline behaviour |
+| --- | --- |
+| `setUnread()` | Cached |
+| `hideMessagesFromBlockedUsers()` | Cached |
+| `updatesOnly()` | Server only — cached page is empty |
+| `setCategory()` / `setCategories()` | Cached |
+| `setType()` / `setTypes()` | Cached |
+| `setParentMessageId()` | Cached |
+| `hideReplies()` | Cached |
+| `hideDeletedMessages()` | Cached |
+| `hideQuotedMessages()` | Cached |
+| `setTags()` | Cached |
+| `withTags()` | Cached |
+| `hasLinks()` | Server only — cached page is empty |
+| `setSearchKeyword()` | Server only — cached page is empty |
+| `setInteractionGoalCompletedOnly()` | Server only — cached page is empty |
+| `hasAttachments()` | Cached |
+| `hasReactions()` | Cached |
+| `setAttachmentTypes()` | Cached |
+| `hasMentions()` | Cached |
+| `setMentionedUIDs()` | Cached |
+| `mentionsWithTagInfo()` / `mentionsWithBlockedInfo()` | Cached, without the tag or blocked info of the mentioned users |
+| `setPinned()` / `setSaved()` | Answered from the pinned or saved list |
+
+`setPinned` and `setSaved` are served from separate pinned and saved lists, not the message cache, so the other filters in this table do not apply to a pinned or saved read.
+
+`setMessageId`, `setUpdatedAfter`, `setLimit`, `setUID` and `setGUID` are scope and paging inputs, not filters, and do not change what the cache can answer. Setting both `setUID` and `setGUID` together (one sender's messages in a group) is answered by the server only. A read with no UID, GUID or parent message id (a cross-conversation read) is answered from the cache only when it also uses `setUnread`, `hasAttachments`, `hasMentions`, `setAttachmentTypes`, mentions of only the logged-in user, or only the `call` and `custom` categories.
+
 ## Next Steps
 
 <CardGroup cols={2}>