docs(notifications): subscribed-threads & quoted-reply preference options

notifications/preferences.mdx

@@ -47,8 +47,8 @@
 | Categories      | Events                      | Available preferences                                                                                                        | Can user override?       |
 | --------------- | --------------------------- | ---------------------------------------------------------------------------------------------------------------------------- | ------------------------ |
 | Conversations   | New messages                | • Don't notify<br/>• **Notify for all messages (Default)** <br/>• Notify for messages with mentions                                   | • **Yes (Default)**<br/>• No |
-|                 | New replies                 | • Don't notify<br/>• **Notify for all replies (Default)**<br/>• Notify for replies with mentions                                     | • **Yes (Default)**<br/>• No |
-|                 | New quoted replies          | • Don't notify<br/>• **Notify for all replies (Default)**<br/>• Notify for replies with mentions                                     | • **Yes (Default)**<br/>• No |
+|                 | New replies                 | • Don't notify<br/>• **Notify for all replies (Default)**<br/>• Notify for replies with mentions<br/>• Notify for subscribed threads                                     | • **Yes (Default)**<br/>• No |
+|                 | New quoted replies          | • Don't notify<br/>• **Notify for all replies (Default)**<br/>• Notify for replies with mentions<br/>• Notify when my message is quoted                                     | • **Yes (Default)**<br/>• No |
 | Message actions | Message is edited           | • Don't notify<br/>• **Notify (Default)**                                                                                        | • Yes<br/>• **No (Default)** |
 |                 | Message is deleted          | • Don't notify<br/>• **Notify (Default)**                                                                                        | • Yes<br/>• **No (Default)** |
 |                 | Message receives a reaction | • Don't notify<br/>• Notify for reactions received on all messages<br/>• **Notify for reactions received on own messages (Default)** | • **Yes (Default)**<br/>• No |
@@ -60,6 +60,15 @@
 |                 | A member is unbanned        | • **Don't notify (Default)**<br/>• Notify                                                                                        | • **Yes (Default)**<br/>• No |
 |                 | A member's scope changes    | • **Don't notify (Default)**<br/>• Notify                                                                                        | • **Yes (Default)**<br/>• No |
 
+<Info>
+**Reply notification options**
+
+- **Notify for subscribed threads** — the user is notified about new replies only in threads they are *subscribed* to. A user becomes subscribed to a thread by sending its parent message, replying in it, being @-mentioned in it, or explicitly following it — and can unfollow to stop. Useful in busy conversations where users only want updates on threads they are part of.
+- **Notify when my message is quoted** *(quoted replies only)* — the sender of the original message is notified whenever someone quote-replies (swipe-to-reply) to their message, independent of threads or mentions.
+
+Both options apply to **group** and **one-on-one** conversations, across **push, email, and SMS**.
+</Info>
+
 <Note>
 Regarding Message edited & Message deleted events
 
@@ -78,11 +87,11 @@
 <Tabs>
 <Tab title="JavaScript">
 ```js
 // This is applicable for web, React native, Ionic cordova (Ionic Cordova is deprecated - use JavaScript SDK)
 const preferences = await CometChatNotifications.fetchPreferences();
 
 // Display Group preferences
 const groupPreferences = preferences.getGroupPreferences();
 
 const groupMessagesPreference = groupPreferences.getMessagesPreference();
 const groupRepliesPreference = groupPreferences.getRepliesPreference();
@@ -104,7 +113,7 @@
 ```kotlin
 CometChatNotifications.fetchPreferences(new CometChat.CallbackListener<NotificationPreferences>() {
   @Override
   public void onSuccess(NotificationPreferences notificationPreferences) {
       // Display group preferences
       GroupPreferences groupPreferences = notificationPreferences.getGroupPreferences();
 
@@ -147,7 +156,7 @@
   let unbanned = groupPreferences?.memberUnbannedPreference;
   let scope = groupPreferences?.memberScopeChangedPreference;
 
 } onError: { error in
   // Something went wrong while fetching notification preferences.
   print("fetchPreferences: \(error.errorCode) \(error.errorDescription)");
 }
@@ -174,7 +183,7 @@
       MemberActionsOptions? memberUnbannedPreference = groupPreferences?.memberUnbanned;
       MemberActionsOptions? memberScopeChangedPreference = groupPreferences?.memberScopeChanged;
     },
     onError: (e) {
       debugPrint("fetchPreferences:error ${e.toString()}");
     });
 ```
@@ -193,21 +202,21 @@
 
 <Note>
 
 Since the user is performing this action, enums have values as `SUBSCRIBE` or `DONT_SUBSCRIBE`. It is equivalent to "Notify" and "Don't notify" respectively, from the dashboard preferences.
 
 </Note>
 
 <Tabs>
 <Tab title="JavaScript">
 ```js
 // This is applicable for web, React native, Ionic cordova (Ionic Cordova is deprecated - use JavaScript SDK)
 // The example demonstrates modifying all values; however, modifying only the changed values is sufficient.
 
 // Instantiate the NotificationPreferences.
 const updatedPreferences = new NotificationPreferences();
 
 // Instantiate the preferences that you want to update.
 const groupPreferences = new GroupPreferences();
 
 // Change group preferences
 groupPreferences.setMessagesPreference(MessagesOptions.DONT_SUBSCRIBE);
@@ -229,7 +238,7 @@
 
 // Update the preferences and receive the updated copy.
 const preferences = await CometChatNotifications.updatePreferences(
   updatedPreferences
 );
 ```
 
@@ -281,10 +290,10 @@
 // The example demonstrates modifying all values; however, modifying only the changed values is sufficient.
 
 // Instantiate the NotificationPreferences.
 let updatedPreferences = CometChatNotifications.NotificationPreferences();
 
 // Instantiate the preferences that you want to update.
 let groupPreferences = CometChatNotifications.GroupPreferences();
 
 // Change group preferences
 groupPreferences.set(messagesPreference: .DONT_SUBSCRIBE)
@@ -301,12 +310,12 @@
 groupPreferences.set(memberScopeChangedPreference: .SUBSCRIBE)
 
 // Load the updates in the NotificationPreferences instance.
 updatedPreferences.set(groupPreferences: groupPreferences)
 
 // Update the preferences.
 CometChatNotifications.updatePreferences(updatedPreferences) { updatedPreferences in
     print("updatePreferences: \(updatedPreferences)")
 } onError: { error in
     print("updatePreferences: \(error.errorCode) \(error.errorDescription)")
 }
 ```
@@ -358,8 +367,8 @@
 | Categories      | Events                      | Available preferences                                                                                                        | Can user override?       |
 | --------------- | --------------------------- | ---------------------------------------------------------------------------------------------------------------------------- | ------------------------ |
 | Conversations   | New messages                | • Don't notify<br/>• **Notify for all messages (Default)**<br/>• Notify for messages with mentions                                   | • **Yes (Default)**<br/>• No |
-|                 | New replies                 | • Don't notify<br/>• **Notify for all replies (Default)**<br/>• Notify for replies with mentions                                     | • **Yes (Default)**<br/>• No |
-|                 | New quoted replies          | • Don't notify<br/>• **Notify for all replies (Default)**<br/>• Notify for replies with mentions                                     | • **Yes (Default)**<br/>• No |
+|                 | New replies                 | • Don't notify<br/>• **Notify for all replies (Default)**<br/>• Notify for replies with mentions<br/>• Notify for subscribed threads                                     | • **Yes (Default)**<br/>• No |
+|                 | New quoted replies          | • Don't notify<br/>• **Notify for all replies (Default)**<br/>• Notify for replies with mentions<br/>• Notify when my message is quoted                                     | • **Yes (Default)**<br/>• No |
 | Message actions | Message is edited           | • Don't notify<br/>• **Notify (Default)**                                                                                        | • Yes<br/>• **No (Default)** |
 |                 | Message is deleted          | • Don't notify<br/>• **Notify (Default)**                                                                                        | • Yes<br/>• **No (Default)** |
 |                 | Message receives a reaction | • Don't notify<br/>• Notify for reactions received on all messages<br/>• **Notify for reactions received on own messages (Default)** | • **Yes (Default)**<br/>• No |
@@ -380,7 +389,7 @@
 <Tabs>
 <Tab title="JavaScript">
 ```js
 // This is applicable for web, React native, Ionic cordova (Ionic Cordova is deprecated - use JavaScript SDK)
 const preferences = await CometChatNotifications.fetchPreferences();
 
 // Display One-on-One preferences
@@ -427,7 +436,7 @@
   let oneMessages = oneOnOnePreferences?.messagesPreference;
   let oneReplies = oneOnOnePreferences?.repliesPreference;
   let oneReactions = oneOnOnePreferences?.reactionsPreference;
 } onError: { error in
   // Something went wrong while fetching notification preferences.
   print("fetchPreferences: \(error.errorCode) \(error.errorDescription)");
 }
@@ -447,7 +456,7 @@
       RepliesOptions? oneOnOneQuotedRepliesPreference = oneOnOnePreferences?.quotedReplies;
       ReactionsOptions? oneOnOneReactionsPreference = oneOnOnePreferences?.reactions;
     },
     onError: (e) {
       debugPrint("fetchPreferences:error ${e.toString()}");
     });
 ```
@@ -467,7 +476,7 @@
 <Tabs>
 <Tab title="JavaScript">
 ```js
 // This is applicable for web, React native, Ionic cordova (Ionic Cordova is deprecated - use JavaScript SDK)
 // The example demonstrates modifying all values; however, modifying only the changed values is sufficient.
 
 // Instantiate the NotificationPreferences.
@@ -487,7 +496,7 @@
 
 // Update the preferences and receive the updated copy.
 const preferences = await CometChatNotifications.updatePreferences(
   updatedPreferences
 );
 ```
 
@@ -549,7 +558,7 @@
 // Update the preferences.
 CometChatNotifications.updatePreferences(updatedPreferences) { updatedPreferences in
     print("updatePreferences: \(updatedPreferences)")
 } onError: { error in
     print("updatePreferences: \(error.errorCode) \(error.errorDescription)")
 }
 ```
@@ -610,16 +619,16 @@
 <Tabs>
 <Tab title="JavaScript">
 ```js
 // This is applicable for web, React native, Ionic cordova (Ionic Cordova is deprecated - use JavaScript SDK)
 // Fetch mute preferences
 const preferences = await CometChatNotifications.fetchPreferences();
 
 // Display Mute preferences
 const mutePreferences = preferences.getMutePreferences();
 const DNDPreference = mutePreferences.getDNDPreference();
 
 // Fetch muted conversations
 const mutedConversations = await CometChatNotifications.getMutedConversations();
 ```
 
 </Tab>
@@ -631,7 +640,7 @@
   @Override
   public void onSuccess(NotificationPreferences notificationPreferences) {
       // Display mute preferences
       MutePreferences mutePreferences = notificationPreferences.getMutePreferences();
       DNDOptions dndPreference = mutePreferences.getDNDPreference();
   }
 
@@ -661,9 +670,9 @@
 ```swift
 CometChatNotifications.fetchPreferences { notificationPreferences in
   // Display mute preferences
   let mutePreferences = notificationPreferences.mutePreferences;
   let dndPreference = mutePreferences?.DNDPreference;
 } onError: { error in
   // Something went wrong while fetching notification preferences.
   print("fetchPreferences: \(error.errorCode) \(error.errorDescription)");
 }
@@ -671,7 +680,7 @@
 // Fetch muted conversations
 CometChatNotifications.getMutedConversations { mutedConversations in
   print("getMutedConversations: \(mutedConversations)")
 } onError: { error in
   print("getMutedConversations: \(error.errorCode) \(error.errorDescription)")
 }
 ```
@@ -721,7 +730,7 @@
 | `type`   | String | This can either be `oneOnOne` or `group`.                     |
 | `until`  | Number | This is a valid timestamp from the future. Eg: 1710696964705. |
 
 **To unmute** one or more group or one-on-one conversations that were muted by the user, utilize the `CometChatNotifications.unmuteConversations()` method. This method requires an array of `UnmutedConversation` objects, each containing the following properties:
 
 | Property | Type   | Description                               |
 | -------- | ------ | ----------------------------------------- |
@@ -731,7 +740,7 @@
 <Tabs>
 <Tab title="JavaScript">
 ```js
 // This is applicable for web, React native, Ionic cordova (Ionic Cordova is deprecated - use JavaScript SDK)
 // The example demonstrates modifying all values; however, modifying only the changed values is sufficient.
 
 // Instantiate the NotificationPreferences.
@@ -753,24 +762,24 @@
 // Mute conversations
 const until = Date.now() + 86400000; // Mute for 1 day
 
 const mutedUser = new MutedConversation();
 mutedUser.setId('cometchat-uid-1');
 mutedUser.setType(CometChatNotifications.MutedConversationType.ONE_ON_ONE);
 mutedUser.setUntil(until);
 
 const mutedGroup = new MutedConversation();
 mutedGroup.setId('cometchat-guid-1');
 mutedGroup.setType(CometChatNotifications.MutedConversationType.GROUP);
 mutedGroup.setUntil(until);
 
 await CometChatNotifications.muteConversations([mutedUser, mutedGroup]);
 
 // Unmute conversations
 const unmutedUser = new UnmutedConversation();
 unmutedUser.setId('cometchat-uid-1');
 unmutedUser.setType(CometChatNotifications.MutedConversationType.ONE_ON_ONE);
 
 const unmuteList = [unmutedUser];
 
 await CometChatNotifications.unmuteConversations(unmuteList);
 ```
@@ -865,53 +874,53 @@
 let updatedPreferences = CometChatNotifications.NotificationPreferences();
 
 // Instantiate the preferences that you want to update.
 let mutePreferences = CometChatNotifications.MutePreferences();
 
 // Change mute preferences
 mutePreferences.set(DNDPreference:.ENABLED)
 
 // Load the updates in the NotificationPreferences instance.
 updatedPreferences.set(mutePreferences: mutePreferences);
 
 // Update the preferences.
 CometChatNotifications.updatePreferences(updatedPreferences) { updatedPreferences in
     print("updatePreferences: \(updatedPreferences)")
 } onError: { error in
     print("updatePreferences: \(error.errorCode) \(error.errorDescription)")
 }
 
 // Mute conversations
 let untilInterval = Date().addingTimeInterval(86400) // Mute for 1 day
 let until = Int(untilInterval.timeIntervalSince1970 * 1000) // Convert to milliseconds
 
 var mutedUser = CometChatNotifications.MutedConversation()
 mutedUser.id = "cometchat-uid-1"
 mutedUser.type = .ONE_ON_ONE
 mutedUser.until = until
 
 var mutedGroup = CometChatNotifications.MutedConversation()
 mutedGroup.id = "cometchat-guid-1"
 mutedGroup.type = .GROUP
 mutedGroup.until = until
 
 let allMuted = [mutedUser, mutedGroup]
 
 CometChatNotifications.muteConversations(allMuted) { success in
   print("muteConversations: \(success)")
 } onError: { error in
   print("muteConversations: \(error.errorCode) \(error.errorDescription)")
 }
 
 // Unmute conversations
 
 var unmutedUser = CometChatNotifications.UnmutedConversation()
 unmutedUser.id = "cometchat-uid-1"
 unmutedUser.type = .ONE_ON_ONE
 
 let unmuteList = [unmutedUser]
 CometChatNotifications.unmuteConversations(unmuteList) { success in
   print("unmuteConversations: \(success)")
 } onError: { error in
   print("unmuteConversations: \(error.errorCode) \(error.errorDescription)")
 }
 ```
@@ -1004,25 +1013,25 @@
 <Tabs>
 <Tab title="JavaScript">
 ```js
 // This is applicable for web, React native, Ionic cordova (Ionic Cordova is deprecated - use JavaScript SDK)
 const preferences = await CometChatNotifications.fetchPreferences();
 
 // Display schedule preferences
 const mutePreferences = preferences.getMutePreferences();
 const schedulePreference = mutePreferences.getSchedulePreference();
 
 const mondaySchedule = schedulePreference.get(DayOfWeek.MONDAY);
 const tuesdaySchedule = schedulePreference.get(DayOfWeek.TUESDAY);
 const wednesdaySchedule = schedulePreference.get(DayOfWeek.WEDNESDAY);
 const thursdaySchedule = schedulePreference.get(DayOfWeek.THURSDAY);
 const fridaySchedule = schedulePreference.get(DayOfWeek.FRIDAY);
 const saturdaySchedule = schedulePreference.get(DayOfWeek.SATURDAY);
 const sundaySchedule = schedulePreference.get(DayOfWeek.SUNDAY);
 
 // This action can be performed on other days of the week.
 const mondayFrom = mondaySchedule?.getFrom();
 const mondayTo = mondaySchedule?.getTo();
 const mondayDnd = mondaySchedule?.getDND();
 ```
 
 </Tab>
@@ -1034,7 +1043,7 @@
   public void onSuccess(NotificationPreferences notificationPreferences) {
       // Display schedule preferences
       MutePreferences mutePreferences = notificationPreferences.getMutePreferences();
       Map<DayOfWeek, DaySchedule> scheduleMap = mutePreferences.getSchedulePreference();
 
       DaySchedule monday = scheduleMap.get(DayOfWeek.MONDAY);
       DaySchedule tuesday = scheduleMap.get(DayOfWeek.TUESDAY);
@@ -1080,7 +1089,7 @@
   let mondayFrom = mondaySchedule?.from;
   let mondayTo = mondaySchedule?.to;
   let mondayDND = mondaySchedule?.dnd;
 } onError: { error in
   // Something went wrong while fetching notification preferences.
   print("fetchPreferences: \(error.errorCode) \(error.errorDescription)");
 }
@@ -1166,13 +1175,13 @@
 MutePreferences mutePreferences = new MutePreferences();
 
 // Change schedule preferences
 Map scheduleMap = new ArrayMap<DayOfWeek, DaySchedule>();
 DaySchedule mondaySchedule = new DaySchedule();
 mondaySchedule.setFrom(2015);
 mondaySchedule.setTo(2345);
 mondaySchedule.setDnd(false);
 
 scheduleMap.put(DayOfWeek.MONDAY, mondaySchedule);
 
 mutePreferences.setSchedulePreference(scheduleMap);
 
@@ -1227,17 +1236,17 @@
 ```dart
 // The example demonstrates modifying all values; however, modifying only the changed values is sufficient.
 
 // Instantiate the NotificationPreferences
 NotificationPreferences updatedPreferences = NotificationPreferences();
 
 // Instantiate the preferences that you want to update.
 MutePreferences mutePreferences = MutePreferences(dnd: DNDOptions.DISABLED);
 Map<DayOfWeek, DaySchedule> scheduleMap = {};
 
 DaySchedule mondaySchedule = DaySchedule(from: 2015, to: 2345, dnd: false);
 scheduleMap[DayOfWeek.MONDAY] = mondaySchedule;
 
 mutePreferences.schedule = scheduleMap;
 updatedPreferences.mutePreferences = mutePreferences;
 
 // Update the preferences.
@@ -1245,7 +1254,7 @@
     onSuccess: (preferencesAfterUpdate) {
   debugPrint("updatePreferences:success");
   // Use the preferencesAfterUpdate
 }, onError: (e) {
   debugPrint("updatePreferences:error: ${e.toString()}");
 });
 ```
@@ -1293,7 +1302,7 @@
 ```kotlin
 CometChatNotifications.resetPreferences(new CometChat.CallbackListener<NotificationPreferences>() {
     @Override
     public void onSuccess(NotificationPreferences defaultPreferences) {
         // Display the defaultPreferences.
     }