ENG-41037: docs(rbac): hide group messages sent before a member joined

rest-api/rbac-overview.mdx

@@ -111,18 +111,18 @@
 | ---------------------------- | --------------------------------------------------------------------- | ----------------- | --------------------------------------- | ------------------------------- | ------- |
 | Message Listing              | Allow or deny message listing functionality                           | string            | `listMessages`                          | allow, deny                     | allow   |
 | Message Listing Mode         | Choose whose messages can be listed: all users or friends only        | string            | `listMessages.mode`                     | all, friends                    | all     |
 | Message List Receiver Filter | Select which receiver types are allowed in message lists              | stringArray       | `listMessages.allowedReceiverTypes`     | user, group                     | null    |
 | Message List Sender Filter   | Select which sender roles' messages can be listed                     | rolesStringArray  | `listMessages.allowedSenderRoles`       | null                            | null    |
 | Message List Category Filter | Select which message categories can be listed                         | stringArray       | `listMessages.allowedMessageCategories` | message, custom                 | null    |
 | Message List Type Filter     | Select which message types can be listed                              | stringArray       | `listMessages.allowedMessageTypes`      | text, image, audio, video, file | null    |
 | Message Details              | Allow or deny fetching message details                                | string            | `getMessageDetails`                     | allow, deny                     | allow   |
 | Message Details Mode         | Choose whose message details can be viewed: all users or friends only | string            | `getMessageDetails.mode`                | all, friends                    | all     |
 | Message Sending              | Allow or deny message sending functionality                           | string            | `sendMessage`                           | allow, deny                     | allow   |
 | Message Sending Mode         | Choose who can receive messages: all users or friends only            | string            | `sendMessage.mode`                      | all, friends                    | all     |
 | Message Send Receiver Filter | Select receiver types to which the messages can be sent               | stringArray       | `sendMessage.allowedReceiverTypes`      | user, group                     | null    |
 | Message Send Role Filter     | Select receiver roles to which the messages can be sent               | rolesStringArray  | `sendMessage.allowedReceiverRoles`      | null                            | null    |
 | Message Send Category Filter | Select which message categories can be sent                           | stringArray       | `sendMessage.allowedMessageCategories`  | message, custom                 | null    |
 | Message Send Type Filter     | Select which message types can be sent                                | stringArray       | `sendMessage.allowedMessageTypes`       | text, image, audio, video, file | null    |
 | Custom Message Types         | Define custom message types that can be sent                          | customStringArray | `sendMessage.allowedCustomTypes`        | null                            | null    |
 | MIME Type Access Control     | Set MIME type filtering mode to allow or deny                         | string            | `sendMessage.mimeTypeAccessControl`     | allow, deny                     | allow   |
 | Media MIME Types             | Define MIME types for media message filtering                         | customStringArray | `sendMessage.mimeTypes`                 | null                            | null    |
@@ -135,10 +135,10 @@
 | ------------------------------- | --------------------------------------------------------------------- | ----------------- | ---------------------------------------------- | ------------------------------- | ------- |
 | Threaded Message Listing        | Allow or deny listing of threaded messages                            | string            | `listThreadedMessages`                         | allow, deny                     | allow   |
 | Thread Message Sending          | Allow or deny sending messages in threads                             | string            | `sendThreadedMessage`                          | allow, deny                     | allow   |
 | Thread Receiver Type Filter     | Select which receiver types (user/group) can receive thread messages  | stringArray       | `sendThreadedMessage.allowedReceiverTypes`     | user, group                     | null    |
 | Thread Role Filter              | Select which receiver roles can receive thread messages (1-on-1 only) | rolesStringArray  | `sendThreadedMessage.allowedReceiverRoles`     | null                            | null    |
 | Thread Category Filter          | Select which message categories can be sent in threads                | stringArray       | `sendThreadedMessage.allowedMessageCategories` | message, custom                 | null    |
 | Thread Type Filter              | Select which message types can be sent in threads                     | stringArray       | `sendThreadedMessage.allowedMessageTypes`      | text, image, audio, video, file | null    |
 | Thread Custom Types             | Define custom message types that can be sent in threads               | customStringArray | `sendThreadedMessage.allowedCustomTypes`       | null                            | null    |
 | Thread MIME Type Access Control | Set MIME type filtering mode for threads to allow or deny             | string            | `sendThreadedMessage.mimeTypeAccessControl`    | allow, deny                     | allow   |
 | Thread Media MIME Types         | Define MIME types for thread media message filtering                  | customStringArray | `sendThreadedMessage.mimeTypes`                | null                            | null    |
@@ -157,7 +157,7 @@
 | Title                     | Description                                                 | Data Type        | Permission Key                      | Available Values | Default |
 | ------------------------- | ----------------------------------------------------------- | ---------------- | ----------------------------------- | ---------------- | ------- |
 | Call Initiation           | Allow or deny call initiation functionality                 | string           | `initiateCall`                      | allow, deny      | allow   |
 | Call Receiver Type Filter | Select which receiver types can receive calls               | stringArray      | `initiateCall.allowedReceiverTypes` | user, group      | null    |
 | Call Receiver Role Filter | Select which receiver roles can receive calls (1-on-1 only) | rolesStringArray | `initiateCall.allowedReceiverRoles` | null             | null    |
 | Call Joining              | Allow or deny joining 1-on-1 calls                          | string           | `joinCall`                          | allow, deny      | allow   |
 
@@ -174,17 +174,17 @@
 | Title                      | Description                                         | Data Type   | Permission Key                      | Available Values          | Default |
 | -------------------------- | --------------------------------------------------- | ----------- | ----------------------------------- | ------------------------- | ------- |
 | Group Listing              | Allow or deny group listing functionality           | string      | `listGroups`                        | allow, deny               | allow   |
 | Group List Type Filter     | Select which group types can be listed              | stringArray | `listGroups.allowedGroupTypes`      | public, password, private | null    |
 | Group Details              | Allow or deny details for a group                   | string      | `getGroupDetails`                   | allow, deny               | allow   |
 | Group Details Type Filter  | Select for which group types details can be fetched | stringArray | `getGroupDetails.allowedGroupTypes` | public, password, private | null    |
 | Group Creation             | Allow or deny group creation functionality          | string      | `createGroup`                       | allow, deny               | allow   |
 | Group Creation Type Filter | Select which group types can be created             | stringArray | `createGroup.allowedGroupTypes`     | public, password, private | null    |
 | Group Joining              | Allow or deny group joining functionality           | string      | `joinGroup`                         | allow, deny               | allow   |
 | Group Join Type Filter     | Select which group types can be joined              | stringArray | `joinGroup.allowedGroupTypes`       | public, password          | null    |
 
 ### RBAC Example Configuration
 
 The following example denies the sendMessage permission for the user role. When applied, users with this role will not be able to send messages and will receive an `ERR_PERMISSION_DENIED` error.
 
 ```json
 {
@@ -300,6 +300,8 @@
 | Group Message Editing          | Allow or deny editing messages in groups                         | string            | `editMessage`                           | allow, deny                     | allow   |
 | Group Message Deletion         | Allow or deny deleting messages in groups                        | string            | `deleteMessage`                         | allow, deny                     | allow   |
 
+To stop new members from seeing messages sent before they joined a group, set `listMessages.historyBeforeJoin` to `deny` for their scope. See [Hide group messages sent before a member joined](#hide-group-messages-sent-before-a-member-joined).
+
 #### 4. Message Thread
 
 | Title                                 | Description                                                             | Data Type         | Permission Key                                 | Available Values                | Default |
@@ -340,6 +342,31 @@
 }
 ```
 
+### Hide Group Messages Sent Before a Member Joined
+
+To stop newly added members from seeing a group's earlier messages, use the **Message History** permission `listMessages.historyBeforeJoin`. It is set per member scope (`admin`, `moderator`, `participant`) on a group, takes `allow` or `deny`, and defaults to `allow`. When it is `deny` for a scope, members with that scope cannot list messages sent before they joined the group.
+
+<Steps>
+  <Step title="Set the permission">
+    Call [Set Scope Permissions](/rest-api/rbac/set-scope-permissions) for the group and scope. The request body is a `permissions` object keyed by permission key.
+
+    ```bash
+    curl -X PUT "https://<appId>.api-<region>.cometchat.io/v3/groups/cometchat-guid-1/scopes/participant/permissions" \
+      -H "apikey: YOUR_REST_API_KEY" \
+      -H "Content-Type: application/json" \
+      -d '{"permissions": {"listMessages.historyBeforeJoin": "deny"}}'
+    ```
+  </Step>
+  <Step title="Check the current value">
+    Call [List Scope Permissions](/rest-api/rbac/list-scope-permissions) for the same group and scope to confirm `listMessages.historyBeforeJoin` is `deny`.
+  </Step>
+</Steps>
+
+- `deny`: messages sent before the member joined are left out of the list. The request succeeds; it returns only messages from the join time onward.
+- `allow` (default): members with this scope can list the full group history. Set it with the same request, or call [Unset Scope Permissions](/rest-api/rbac/unset-scope-permissions) to return to the default.
+
+The permission applies per scope, not per member or per date. To apply it to every member of a group, set it for each scope. The join time is the member's most recent join: a member who leaves and rejoins sees history only from the rejoin onward.
+
 ### SBAC Permission Evaluation Order
 
 1. **Explicitly configured permission** for the scope which has the highest priority

sdk/android/v5/receive-messages.mdx

@@ -30,17 +30,17 @@
   }
 
   @Override
   public void onMediaMessageReceived(MediaMessage mediaMessage) {
       Log.d(TAG, "Media message received successfully: " + mediaMessage.toString());
   }
 
   @Override
   public void onCustomMessageReceived(CustomMessage customMessage) {
       Log.d(TAG, "Custom message received successfully: " + customMessage.toString());
   }
 
   @Override
   public void onCardMessageReceived(CardMessage cardMessage) {
       Log.d(TAG, "Card message received successfully: " + cardMessage.toString());
   }
 });
@@ -217,10 +217,10 @@
 <Tab title="Java">
 ```java
 private int limit = 30;
 private int latestId = CometChat.getLastDeliveredMessageId();
 private String UID = "cometchat-uid-1";
 
 MessagesRequest messagesRequest = new MessagesRequest.MessagesRequestBuilder()
       .setMessageId(latestId)
       .setLimit(limit)
       .setUID(UID)
@@ -295,10 +295,10 @@
 <Tab title="Java">
 ```java
 private int limit = 30;
 private int latestId = CometChat.getLastDeliveredMessageId();
 private String GUID = "cometchat-guid-1";
 
 MessagesRequest messagesRequest = new MessagesRequest.MessagesRequestBuilder()
       .setMessageId(latestId)
       .setLimit(limit)
       .setGUID(GUID)
@@ -378,7 +378,7 @@
 ```java
 String UID = "cometchat-uid-1";
 
 MessagesRequest messagesRequest = new MessagesRequest.MessagesRequestBuilder()
       .setUnread(true)
       .setLimit(20)
       .setUID(UID)
@@ -443,7 +443,7 @@
 ```java
 String GUID = "cometchat-guid-1";
 
 MessagesRequest messagesRequest = new MessagesRequest.MessagesRequestBuilder()
       .setUnread(true)
       .setLimit(20)
       .setGUID(GUID)
@@ -522,7 +522,7 @@
 private int limit = 30;
 private String UID = "cometchat-uid-1"
 
 MessagesRequest messagesRequest = new MessagesRequest.MessagesRequestBuilder()
       .setLimit(limit)
       .setUID(UID)
       .build();
@@ -591,7 +591,7 @@
 private int limit = 30;
 private String GUID = "cometchat-guid-1"
 
 MessagesRequest messagesRequest = new MessagesRequest.MessagesRequestBuilder()
       .setLimit(limit)
       .setGUID(GUID)
       .build();
@@ -650,6 +650,10 @@
 
 Calling the `fetchPrevious()` method on the same object repeatedly allows you to fetch the entire conversation between the logged in user and the specified user. This can be implemented with upward scrolling to display the entire conversation.
 
+<Note>
+To stop new members from seeing messages sent before they joined a group, use the SBAC permission `listMessages.historyBeforeJoin`. See [Hide group messages sent before a member joined](/rest-api/rbac-overview#hide-group-messages-sent-before-a-member-joined).
+</Note>
+
 ## Search Messages
 
 In other words, as a logged-in user, how do I search a message?
@@ -658,7 +662,7 @@
 
 <Note>
 
 By default, the searchKey is searched only in message text. However, if you enable `Conversation & Advanced Search`, the searchKey will be searched in message text, file name, mentions & mime type of the file.
 
 The `Conversation & Advanced Search` is only available in `Advanced` & `Custom` [plans](https://www.cometchat.com/pricing). If you're already on one of these plans, please enable the `Conversation & Advanced Search` from [CometChat Dashboard](https://app.cometchat.com) (Open your app, navigate to Chats -> Settings -> General Configuration)
 
@@ -679,7 +683,7 @@
 private int limit = 30;
 private String UID = "cometchat-uid-1";
 
 MessagesRequest messagesRequest = new MessagesRequest.MessagesRequestBuilder().setSearchKeyword("Hello").setUID(UID).setLimit(limit).build();
 
 messagesRequest.fetchPrevious(new CometChat.CallbackListener<List<BaseMessage>>() {
   @Override
@@ -738,7 +742,7 @@
 private int limit = 30;
 private String GUID = "cometchat-guid-1";
 
 MessagesRequest messagesRequest = new MessagesRequest.MessagesRequestBuilder().setSearchKeyword("Hello").setGUID(GUID).setLimit(limit).build();
 
 messagesRequest.fetchPrevious(new CometChat.CallbackListener<List<BaseMessage>>() {
   @Override
@@ -880,7 +884,7 @@
 
 </Tabs>
 
 In the `onSuccess()` callback, you will receive a Hashmap which will contain the `UID` of the user as the key and the unread message count as the value.
 
 ### Fetch Unread Message Count of a particular group conversation
 
@@ -966,7 +970,7 @@
 
 </Tabs>
 
 In the `onSuccess()` callback, you will receive a Hashmap which will contain the `GUID` of the group as the key and the unread message count as the value.
 
 ### Fetch Unread Message Count of all one-on-one & group conversations
 
@@ -1045,10 +1049,10 @@
 
 </Tabs>
 
 In the `onSuccess()` callback, you will receive a hashmap having two keys:
 
 1. `user` - The value for this key holds another hashmap that holds the `UIDs` of users and their corresponding unread message counts.
 2. `group` - The value for this key holds another hashmap that holds the `GUIDs` of groups and their corresponding unread message counts.
 
 ### Fetch Unread Message Count of all one-on-one conversations
 
@@ -1129,7 +1133,7 @@
 
 </Tabs>
 
 In the `onSuccess()` callback, you will receive a Hashmap that will contain the `UIDs` of users as the key and the unread message counts as the values.
 
 ### Fetch Unread Message Count of all group conversations
 
@@ -1210,4 +1214,4 @@
 
 </Tabs>
 
 In the `onSuccess()` callback, you will receive a hashmap which will contain the `GUIDs` of the groups as the key and the unread message counts as the values.

sdk/flutter/receive-messages.mdx

@@ -38,7 +38,7 @@
 <Tabs>
 <Tab title="Dart">
 ```dart
 class Class_Name  with MessageListener {
 
 //CometChat.addMessageListener("listenerId", this);
   @override
@@ -47,12 +47,12 @@
 }
 
 @override
 void onMediaMessageReceived(MediaMessage mediaMessage) {
 	debugPrint("Media message received successfully: $mediaMessage"); 
 }
 
 @override
 void onCustomMessageReceived(CustomMessage customMessage) {
   debugPrint("Custom message received successfully: $customMessage");  
 }
 
@@ -62,7 +62,7 @@
 }
 
 @override
 void onCardMessageReceived(CardMessage cardMessage) {
   debugPrint("Card message received successfully: $cardMessage");
 }
 
@@ -134,7 +134,7 @@
 int lastMessageId = -1;
 String UID = "cometchat-uid-1";
 
 MessagesRequest messageRequest = (MessagesRequestBuilder()
       ..uid = UID
       ..limit = limit
       ..messageId = lastMessageId
@@ -148,7 +148,7 @@
               debugPrint("Media message received successfully: "+(message as MediaMessage).toString());
             }
           }
       }, onError: (CometChatException e) {
         debugPrint("Message fetching failed with exception: ${e.message}");
       });
 ```
@@ -204,7 +204,7 @@
 int lastMessageId = -1;
 String GUID = "cometchat-uid-1";
 
 MessagesRequest messageRequest = (MessagesRequestBuilder()
       ..guid = GUID
       ..limit = limit
       ..messageId = lastMessageId
@@ -219,7 +219,7 @@
               debugPrint("Media message received successfully: "+(message as MediaMessage).toString());
             }
           }
       }, onError: (CometChatException e) {
         debugPrint("Message fetching failed with exception: ${e.message}");
       });
 ```
@@ -283,7 +283,7 @@
 int lastMessageId = -1;
 String UID = "cometchat-uid-1";
 
 MessagesRequest messageRequest = (MessagesRequestBuilder()
       ..uid = UID
       ..limit = limit
     ).build();
@@ -296,7 +296,7 @@
               debugPrint("Media message received successfully: "+(message as MediaMessage).toString());
             }
           }
       }, onError: (CometChatException e) {
         debugPrint("Message fetching failed with exception: ${e.message}");
       });
 ```
@@ -341,6 +341,10 @@
 
 Calling the `fetchPrevious()` method on the same object repeatedly allows you to fetch the entire conversation between the logged in user and the specified user. This can be implemented with upward scrolling to display the entire conversation.
 
+<Note>
+To stop new members from seeing messages sent before they joined a group, use the SBAC permission `listMessages.historyBeforeJoin`. See [Hide group messages sent before a member joined](/rest-api/rbac-overview#hide-group-messages-sent-before-a-member-joined).
+</Note>
+
 ## Search Messages
 
 In other words, as a logged-in user, how do I search a message?
@@ -349,7 +353,7 @@
 
 <Note>
 
 By default, the searchKey is searched only in message text. However, if you enable `Conversation & Advanced Search`, the searchKey will be searched in message text, file name, mentions & mime type of the file.
 
 The `Conversation & Advanced Search` is only available in `Advanced` & `Custom` [plans](https://www.cometchat.com/pricing). If you're already on one of these plans, please enable the `Conversation & Advanced Search` from [CometChat Dashboard](https://app.cometchat.com) (Open your app, navigate to Chats -> Settings -> General Configuration)
 
@@ -368,10 +372,10 @@
 <Tab title="Dart">
 ```dart
 int limit = 30;
 int searchKeyword = "search keyboard";
 String UID = "cometchat-uid-1";
 
 MessagesRequest  messageRequest = (MessagesRequestBuilder()
       ..uid = UID
       ..limit = limit
       .searchKeyword=searchKeyword
@@ -385,7 +389,7 @@
               debugPrint("Media message received successfully: "+(message as MediaMessage).toString());
             }
           }
       }, onError: (CometChatException e) {
         debugPrint("Message fetching failed with exception: ${e.message}");
       });
 ```
@@ -439,18 +443,18 @@
 *In other words, how do I find out the number of unread messages I have from a particular user?*
 
 The Flutter SDK has no per-user method. Call `getUnreadMessageCountForAllUsers()` and read the
 UID's entry from the returned map — the map is keyed by UID, and a UID with nothing unread is
 simply absent.
 
 <Tabs>
 <Tab title="Dart">
 ```dart
 CometChat.getUnreadMessageCountForAllUsers(
   onSuccess: (Map<String, int> counts) {
     final int unread = counts["cometchat-uid-1"] ?? 0;
     debugPrint("Unread from that user: $unread");
   },
   onError: (CometChatException e) {
     // Handle failure
   },
 );
@@ -467,8 +471,8 @@
 ```dart
 CometChat.getUnreadMessageCountForAllUsers(
   hideMessagesFromBlockedUsers: true,
   onSuccess: (Map<String, int> counts) {},
   onError: (CometChatException e) {},
 );
 ```
 
@@ -483,7 +487,7 @@
 
 CometChat.getUnreadMessageCountForUser(UID, new CometChat.CallbackListener<HashMap<String, Integer>>() {
 @Override
   public void onSuccess(HashMap<String, Integer> stringIntegerHashMap) {
   	// handle success
 }
 
@@ -539,7 +543,7 @@
                                       onSuccess: (Map<String, int> map) {
 
                                       },
         															onError: (CometChatException e) {
 
                                       }); 
 ```
@@ -584,7 +588,7 @@
 CometChat.getUnreadMessageCount(hideMessagesFromBlockedUsers: hideBlockedUser,
       onSuccess: (Map<String, Map<String, int>> map) {
 
       },onError: (CometChatException e) {
 
       });
 ```
@@ -635,7 +639,7 @@
       onSuccess: (Map<String, int> map) {
 
       },
       onError: (CometChatException e) {
 
       }); 
 ```

sdk/ios/receive-message.mdx

@@ -216,6 +216,10 @@ messagesRequest.fetchPrevious(onSuccess: { (messages) in
 The list of messages received is in the form of [`BaseMessage`](/sdk/reference/messages#basemessage) objects. A [`BaseMessage`](/sdk/reference/messages#basemessage) can be a [`TextMessage`](/sdk/reference/messages#textmessage), [`MediaMessage`](/sdk/reference/messages#mediamessage), or [`CustomMessage`](/sdk/reference/messages#custommessage). Use type casting to check the type.
 </Note>
 
+<Note>
+To stop new members from seeing messages sent before they joined a group, use the SBAC permission `listMessages.historyBeforeJoin`. See [Hide group messages sent before a member joined](/rest-api/rbac-overview#hide-group-messages-sent-before-a-member-joined).
+</Note>
+
 ---
 
 ## Offline support

sdk/javascript/receive-message.mdx

@@ -14,7 +14,7 @@
 | Primary output | Real-time callbacks deliver the specific message subclass (`TextMessage` / `MediaMessage` / `CustomMessage`); `fetchPrevious()` resolves to `Promise<CometChat.BaseMessage[]>`; `getMessageDetails()` resolves to `Promise<CometChat.BaseMessage>`; unread-count methods resolve to a `Promise` of an ID→count object; all reject with `CometChat.CometChatException` |
 | Listeners registered | `MessageListener` via `CometChat.addMessageListener(listenerID, ...)` / `CometChat.removeMessageListener(listenerID)` — callbacks shown: `onTextMessageReceived`, `onMediaMessageReceived`, `onCustomMessageReceived` |
 | Prerequisites | SDK initialized via [`CometChat.init()`](/sdk/javascript/setup-sdk) and a logged-in user via [`CometChat.login()`](/sdk/javascript/authentication-overview) |
 | Constraints | As a sender you do not receive your own message in a real-time event (though other devices of the same logged-in user do). Always remove listeners on unmount to avoid memory leaks and duplicate handling. Advanced search (file name, mentions, MIME type) requires the `Conversation & Advanced Search` feature |
 | Related | [Send a Message](/sdk/javascript/send-message) · [Delivery & Read Receipts](/sdk/javascript/delivery-read-receipts) · [All Real Time Listeners](/sdk/javascript/all-real-time-listeners) · [Retrieve Conversations](/sdk/javascript/retrieve-conversations) |
 | Full reference | [`BaseMessage`](/sdk/reference/messages#basemessage) · [`TextMessage`](/sdk/reference/messages#textmessage) · [`MediaMessage`](/sdk/reference/messages#mediamessage) · [`CustomMessage`](/sdk/reference/messages#custommessage) |
 
@@ -48,10 +48,10 @@
 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);
 },
 })
@@ -95,7 +95,7 @@
 
 <Warning>
   Always remove listeners when they're no longer needed (e.g., on component
   unmount). Failing to do so can cause memory leaks and duplicate event
   handling.
 </Warning>
 
@@ -117,7 +117,7 @@
 let UID: string = "UID";
 let limit: number = 30;
 
 let messagesRequest: CometChat.MessagesRequest =
 new CometChat.MessagesRequestBuilder()
 .setUID(UID)
 .setUnread(true)
@@ -180,7 +180,7 @@
 let UID: string = "UID";
 let limit: number = 30;
 
 let messagesRequest: CometChat.MessagesRequest =
 new CometChat.MessagesRequestBuilder()
 .setUID(UID)
 .setLimit(limit)
@@ -224,6 +224,10 @@
 
 The `fetchPrevious()` method returns an array of [`BaseMessage`](/sdk/reference/messages#basemessage) objects (which may be [`TextMessage`](/sdk/reference/messages#textmessage), [`MediaMessage`](/sdk/reference/messages#mediamessage), or other subclasses).
 
+<Note>
+To stop new members from seeing messages sent before they joined a group, use the SBAC permission `listMessages.historyBeforeJoin`. See [Hide group messages sent before a member joined](/rest-api/rbac-overview#hide-group-messages-sent-before-a-member-joined).
+</Note>
+
 ## Search Messages
 
 <Note>With offline support on, this filter is answered by the server only; the cached page is empty.</Note>
@@ -235,9 +239,9 @@
 ```typescript
 let UID: string = "UID";
 let limit: number = 30;
 let searchKeyword: string = "Hello";
 
 let messagesRequest: CometChat.MessagesRequest =
 new CometChat.MessagesRequestBuilder()
 .setUID(UID)
 .setLimit(limit)
@@ -436,7 +440,7 @@
 <Tabs>
 <Tab title="TypeScript">
 ```typescript
 let messageId: string = "MESSAGE_ID";
 
 CometChat.getMessageDetails(messageId).then(
 (message: CometChat.BaseMessage) => {

sdk/react-native/receive-messages.mdx

@@ -15,7 +15,7 @@
 | Listener Events | `onTextMessageReceived`, `onMediaMessageReceived`, `onCustomMessageReceived` |
 | Prerequisites | SDK initialized, user logged in |
 | Primary output | `fetchNext()` / `fetchPrevious()` → `Promise<CometChat.BaseMessage[] \| []>`; listeners return `void` and deliver via callbacks |
 | Constraints | `fetchPrevious()` walks backwards through history; `fetchNext()` walks forward. Mixing them on one request object interleaves pages confusingly. Every `add*Listener()` needs a matching `remove*Listener()` with the same listener ID — unremoved listeners leak and fire after unmount. |
 | Related | [Send a Message](/sdk/react-native/send-message) · [Message Filtering](/sdk/react-native/additional-message-filtering) · [Delivery & Read Receipts](/sdk/react-native/delivery-read-receipts) |
 | Full reference | [`BaseMessage`](/sdk/reference/messages#basemessage) · [`TextMessage`](/sdk/reference/messages#textmessage) · [`MediaMessage`](/sdk/reference/messages#mediamessage) · [`CometChatException`](/sdk/reference/auxiliary#cometchatexception) |
 
@@ -45,10 +45,10 @@
     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);
     },
   })
@@ -89,7 +89,7 @@
 ```
 
 <Warning>
 Always remove listeners when they're no longer needed (e.g., on component unmount). Failing to do so can cause memory leaks and duplicate event handling.
 </Warning>
 
 <Warning>
@@ -147,9 +147,9 @@
 ```typescript
 let UID: string = "UID";
 let limit: number = 30;
 let latestId: number = await CometChat.getLastDeliveredMessageId();
 
 let messagesRequest: CometChat.MessagesRequest =
   new CometChat.MessagesRequestBuilder()
     .setUID(UID)
     .setMessageId(latestId)
@@ -204,7 +204,7 @@
 let UID: string = "UID";
 let limit: number = 30;
 
 let messagesRequest: CometChat.MessagesRequest =
   new CometChat.MessagesRequestBuilder()
     .setUID(UID)
     .setUnread(true)
@@ -260,7 +260,7 @@
 let UID: string = "UID";
 let limit: number = 30;
 
 let messagesRequest: CometChat.MessagesRequest =
   new CometChat.MessagesRequestBuilder()
     .setUID(UID)
     .setLimit(limit)
@@ -302,6 +302,10 @@
 
 The `fetchPrevious()` method returns an array of [`BaseMessage`](/sdk/reference/messages#basemessage) objects (which may be [`TextMessage`](/sdk/reference/messages#textmessage), [`MediaMessage`](/sdk/reference/messages#mediamessage), or other subclasses).
 
+<Note>
+To stop new members from seeing messages sent before they joined a group, use the SBAC permission `listMessages.historyBeforeJoin`. See [Hide group messages sent before a member joined](/rest-api/rbac-overview#hide-group-messages-sent-before-a-member-joined).
+</Note>
+
 ## Search Messages
 
 Add `setSearchKeyword()` to the builder to filter messages by keyword.
@@ -311,9 +315,9 @@
 ```typescript
 let UID: string = "UID";
 let limit: number = 30;
 let searchKeyword: string = "Hello";
 
 let messagesRequest: CometChat.MessagesRequest =
   new CometChat.MessagesRequestBuilder()
     .setUID(UID)
     .setLimit(limit)
@@ -507,7 +511,7 @@
 <Tabs>
 <Tab title="TypeScript">
 ```typescript
 let messageId: string = "MESSAGE_ID";
 
 CometChat.getMessageDetails(messageId).then(
   (message: CometChat.BaseMessage) => {