npm - @lazyneoaz/metachat - Versions diffs - 1.0.8 → 1.0.9 - Mend

@lazyneoaz/metachat 1.0.8 → 1.0.9

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (19) hide show

package/package.json +1 -1
package/src/apis/changeAdminStatus.js +2 -6
package/src/apis/createPoll.js +1 -1
package/src/apis/getMessage.js +83 -29
package/src/apis/getThemeInfo.js +6 -2
package/src/apis/getThreadHistory.js +1 -1
package/src/apis/getThreadInfo.js +15 -5
package/src/apis/getThreadList.js +11 -5
package/src/apis/listenMqtt.js +19 -40
package/src/apis/markAsRead.js +12 -15
package/src/apis/mqttDeltaValue.js +2 -2
package/src/apis/nickname.js +1 -1
package/src/apis/pinMessage.js +7 -5
package/src/apis/removeUserFromGroup.js +1 -0
package/src/apis/setMessageReaction.js +12 -11
package/src/apis/setThreadTheme.js +11 -11
package/src/apis/unsendMessage.js +1 -1
package/src/utils/axios.js +30 -16
package/src/utils/clients.js +112 -112

package/package.json CHANGED Viewed

@@ -1,6 +1,6 @@
 {
   "name": "@lazyneoaz/metachat",
-  "version": "1.0.8",
+  "version": "1.0.9",
   "type": "commonjs",
   "types": "src/types/index.d.ts",
   "description": "Advanced Facebook Chat API client for building Messenger bots — real-time messaging, thread management, MQTT, and session stability.",

package/src/apis/changeAdminStatus.js CHANGED Viewed

@@ -2,10 +2,6 @@
 const utils = require('../utils');
-function generateOfflineThreadingID() {
-    return Date.now().toString() + Math.floor(Math.random() * 1000000).toString();
-}
 function getType(obj) {
     return Object.prototype.toString.call(obj).slice(8, -1);
 }
@@ -39,7 +35,7 @@ module.exports = function (defaultFuncs, api, ctx) {
         if (ctx.mqttClient) {
             const tasks = [];
             const isAdmin = adminStatus ? 1 : 0;
-            const epochID = generateOfflineThreadingID();
+            const epochID = utils.generateOfflineThreadingID();
             if (getType(adminID) === "Array") {
                 adminID.forEach((id, index) => {
@@ -93,7 +89,7 @@ module.exports = function (defaultFuncs, api, ctx) {
         } else {
             utils.warn("MQTT client not available, using HTTP fallback for changeAdminStatus");
             const tasks = [];
-            const epochID = generateOfflineThreadingID();
+            const epochID = utils.generateOfflineThreadingID();
             if (getType(adminID) === "Array") {
                 adminID.forEach((id, index) => {

package/src/apis/createPoll.js CHANGED Viewed

@@ -61,7 +61,7 @@ module.exports = (defaultFuncs, api, ctx) => {
         type: 3
       });
-      ctx.mqttClient.publish("/ls_req", form);
+      ctx.mqttClient.publish("/ls_req", form, { qos: 1, retain: false });
       callback(null, { success: true });
     } catch (err) {
       utils.error("createPoll", err);

package/src/apis/getMessage.js CHANGED Viewed

@@ -4,26 +4,72 @@ const utils = require('../utils');
 const { _formatAttachment } = require('../utils/formatters/data/formatAttachment');
 const THEME_COLORS = [
-    { theme_color: "FF000000", theme_id: "788274591712841", theme_emoji: "🖤", gradient: '["FFF0F0F0"]', should_show_icon: "", theme_name_with_subtitle: "Monochrome" },
-    { theme_color: "FFFF5CA1", theme_id: "169463077092846", theme_emoji: null, gradient: null, should_show_icon: "1", theme_name_with_subtitle: "Hot Pink" },
-    { theme_color: "FF2825B5", theme_id: "271607034185782", theme_emoji: null, gradient: '["FF5E007E","FF331290","FF2825B5"]', should_show_icon: "1", theme_name_with_subtitle: "Shadow" },
-    { theme_color: "FFD9A900", theme_id: "2533652183614000", theme_emoji: null, gradient: '["FF550029","FFAA3232","FFD9A900"]', should_show_icon: "1", theme_name_with_subtitle: "Maple" },
-    { theme_color: "FFFB45DE", theme_id: "2873642949430623", theme_emoji: null, gradient: null, should_show_icon: "1", theme_name_with_subtitle: "Tulip" },
-    { theme_color: "FF5E007E", theme_id: "193497045377796", theme_emoji: null, gradient: null, should_show_icon: "1", theme_name_with_subtitle: "Grape" },
-    { theme_color: "FF7AA286", theme_id: "1455149831518874", theme_emoji: "🌑", gradient: '["FF25C0E1","FFCE832A"]', should_show_icon: "", theme_name_with_subtitle: "Dune" },
-    { theme_color: "FFFAAF00", theme_id: "672058580051520", theme_emoji: null, gradient: null, should_show_icon: "1", theme_name_with_subtitle: "Honey" },
-    { theme_color: "FF0084FF", theme_id: "196241301102133", theme_emoji: null, gradient: null, should_show_icon: "1", theme_name_with_subtitle: "Default Blue" },
-    { theme_color: "FFFFC300", theme_id: "174636906462322", theme_emoji: null, gradient: null, should_show_icon: "1", theme_name_with_subtitle: "Yellow" },
-    { theme_color: "FF44BEC7", theme_id: "1928399724138152", theme_emoji: null, gradient: null, should_show_icon: "1", theme_name_with_subtitle: "Teal Blue" },
-    { theme_color: "FF7646FF", theme_id: "234137870477637", theme_emoji: null, gradient: null, should_show_icon: "1", theme_name_with_subtitle: "Bright Purple" },
-    { theme_color: "FFF25C54", theme_id: "3022526817824329", theme_emoji: null, gradient: null, should_show_icon: "1", theme_name_with_subtitle: "Peach" },
-    { theme_color: "FFF01D6A", theme_id: "724096885023603", theme_emoji: null, gradient: '["FF005FFF","FF9200FF","FFFF2E19"]', should_show_icon: "1", theme_name_with_subtitle: "Berry" },
-    { theme_color: "FFFF7CA8", theme_id: "624266884847972", theme_emoji: null, gradient: '["FFFF8FB2","FFA797FF","FF00E5FF"]', should_show_icon: "1", theme_name_with_subtitle: "Candy" },
-    { theme_color: "FF0084FF", theme_id: "196241301102133", theme_emoji: null, gradient: null, should_show_icon: "1", theme_name_with_subtitle: "Classic" },
-    { theme_color: "FF0099FF", theme_id: "3273938616164733", theme_emoji: null, gradient: null, should_show_icon: "1", theme_name_with_subtitle: "Classic" },
-    { theme_color: "FFFA3C4C", theme_id: "2129984390566328", theme_emoji: null, gradient: null, should_show_icon: "1", theme_name_with_subtitle: "Red" },
-    { theme_color: "FF13CF13", theme_id: "2136751179887052", theme_emoji: null, gradient: null, should_show_icon: "1", theme_name_with_subtitle: "Green" },
-    { theme_color: "FFFF7E29", theme_id: "175615189761153", theme_emoji: null, gradient: null, should_show_icon: "1", theme_name_with_subtitle: "Orange" }
+    // ── Core solid colours ────────────────────────────────────────────────────
+    { theme_color: "FF0084FF", theme_id: "196241301102133",   theme_emoji: null, gradient: null, should_show_icon: "1", theme_name_with_subtitle: "Default Blue" },
+    { theme_color: "FF0099FF", theme_id: "3273938616164733",  theme_emoji: null, gradient: null, should_show_icon: "1", theme_name_with_subtitle: "Classic" },
+    { theme_color: "FF44BEC7", theme_id: "1928399724138152",  theme_emoji: null, gradient: null, should_show_icon: "1", theme_name_with_subtitle: "Teal Blue" },
+    { theme_color: "FFFFC300", theme_id: "174636906462322",   theme_emoji: null, gradient: null, should_show_icon: "1", theme_name_with_subtitle: "Yellow" },
+    { theme_color: "FFFA3C4C", theme_id: "2129984390566328",  theme_emoji: null, gradient: null, should_show_icon: "1", theme_name_with_subtitle: "Red" },
+    { theme_color: "FF7646FF", theme_id: "234137870477637",   theme_emoji: null, gradient: null, should_show_icon: "1", theme_name_with_subtitle: "Bright Purple" },
+    { theme_color: "FF13CF13", theme_id: "2136751179887052",  theme_emoji: null, gradient: null, should_show_icon: "1", theme_name_with_subtitle: "Green" },
+    { theme_color: "FFFF7E29", theme_id: "175615189761153",   theme_emoji: null, gradient: null, should_show_icon: "1", theme_name_with_subtitle: "Orange" },
+    { theme_color: "FFFF5CA1", theme_id: "169463077092846",   theme_emoji: null, gradient: null, should_show_icon: "1", theme_name_with_subtitle: "Hot Pink" },
+    { theme_color: "FF25D366", theme_id: "2442142322678320",  theme_emoji: null, gradient: null, should_show_icon: "1", theme_name_with_subtitle: "Deep Sky Blue" },
+    { theme_color: "FF7646FF", theme_id: "2058653964378557",  theme_emoji: null, gradient: null, should_show_icon: "1", theme_name_with_subtitle: "Lavender Purple" },
+    { theme_color: "FFFF4500", theme_id: "980963458735625",   theme_emoji: null, gradient: null, should_show_icon: "1", theme_name_with_subtitle: "Light Coral" },
+    { theme_color: "FF00C9C9", theme_id: "417639218648241",   theme_emoji: null, gradient: null, should_show_icon: "1", theme_name_with_subtitle: "Aqua" },
+    // ── Named / gradient themes ───────────────────────────────────────────────
+    { theme_color: "FF000000", theme_id: "788274591712841",   theme_emoji: "🖤", gradient: '["FFF0F0F0"]', should_show_icon: "", theme_name_with_subtitle: "Monochrome" },
+    { theme_color: "FF2825B5", theme_id: "271607034185782",   theme_emoji: null, gradient: '["FF5E007E","FF331290","FF2825B5"]', should_show_icon: "1", theme_name_with_subtitle: "Shadow" },
+    { theme_color: "FFD9A900", theme_id: "2533652183614000",  theme_emoji: null, gradient: '["FF550029","FFAA3232","FFD9A900"]', should_show_icon: "1", theme_name_with_subtitle: "Maple" },
+    { theme_color: "FFFB45DE", theme_id: "2873642949430623",  theme_emoji: null, gradient: null, should_show_icon: "1", theme_name_with_subtitle: "Tulip" },
+    { theme_color: "FF5E007E", theme_id: "193497045377796",   theme_emoji: null, gradient: null, should_show_icon: "1", theme_name_with_subtitle: "Grape" },
+    { theme_color: "FF7AA286", theme_id: "1455149831518874",  theme_emoji: "🌑", gradient: '["FF25C0E1","FFCE832A"]', should_show_icon: "", theme_name_with_subtitle: "Dune" },
+    { theme_color: "FFFAAF00", theme_id: "672058580051520",   theme_emoji: null, gradient: null, should_show_icon: "1", theme_name_with_subtitle: "Honey" },
+    { theme_color: "FFF25C54", theme_id: "3022526817824329",  theme_emoji: null, gradient: null, should_show_icon: "1", theme_name_with_subtitle: "Peach" },
+    { theme_color: "FFF01D6A", theme_id: "724096885023603",   theme_emoji: null, gradient: '["FF005FFF","FF9200FF","FFFF2E19"]', should_show_icon: "1", theme_name_with_subtitle: "Berry" },
+    { theme_color: "FFFF7CA8", theme_id: "624266884847972",   theme_emoji: null, gradient: '["FFFF8FB2","FFA797FF","FF00E5FF"]', should_show_icon: "1", theme_name_with_subtitle: "Candy" },
+    { theme_color: "FF930099", theme_id: "930060997172551",   theme_emoji: null, gradient: null, should_show_icon: "1", theme_name_with_subtitle: "Mango" },
+    { theme_color: "FF4267B2", theme_id: "164535220883264",   theme_emoji: null, gradient: null, should_show_icon: "1", theme_name_with_subtitle: "Berry" },
+    { theme_color: "FF00C400", theme_id: "370940413392601",   theme_emoji: null, gradient: null, should_show_icon: "1", theme_name_with_subtitle: "Citrus" },
+    { theme_color: "FF50C878", theme_id: "557344741607350",   theme_emoji: null, gradient: null, should_show_icon: "1", theme_name_with_subtitle: "Citrus 2" },
+    { theme_color: "FFFF0000", theme_id: "205488546921017",   theme_emoji: null, gradient: null, should_show_icon: "1", theme_name_with_subtitle: "Candy" },
+    { theme_color: "FF8B4513", theme_id: "1833559466821043",  theme_emoji: null, gradient: null, should_show_icon: "1", theme_name_with_subtitle: "Earth" },
+    { theme_color: "FF0084FF", theme_id: "365557122117011",   theme_emoji: null, gradient: null, should_show_icon: "1", theme_name_with_subtitle: "Support" },
+    { theme_color: "FFFF6B6B", theme_id: "339021464972092",   theme_emoji: null, gradient: null, should_show_icon: "1", theme_name_with_subtitle: "Music" },
+    { theme_color: "FFFF69B4", theme_id: "1652456634878319",  theme_emoji: null, gradient: null, should_show_icon: "1", theme_name_with_subtitle: "Pride" },
+    { theme_color: "FF8B0000", theme_id: "538280997628317",   theme_emoji: null, gradient: null, should_show_icon: "1", theme_name_with_subtitle: "Doctor Strange" },
+    { theme_color: "FF6C63FF", theme_id: "1060619084701625",  theme_emoji: null, gradient: null, should_show_icon: "1", theme_name_with_subtitle: "Lo-Fi" },
+    { theme_color: "FF87CEEB", theme_id: "3190514984517598",  theme_emoji: null, gradient: null, should_show_icon: "1", theme_name_with_subtitle: "Sky" },
+    { theme_color: "FFFF4500", theme_id: "357833546030778",   theme_emoji: null, gradient: null, should_show_icon: "1", theme_name_with_subtitle: "Lunar New Year" },
+    { theme_color: "FFFF6347", theme_id: "627144732056021",   theme_emoji: null, gradient: null, should_show_icon: "1", theme_name_with_subtitle: "Celebration" },
+    { theme_color: "FF4682B4", theme_id: "390127158985345",   theme_emoji: null, gradient: null, should_show_icon: "1", theme_name_with_subtitle: "Chill" },
+    { theme_color: "FFFF0000", theme_id: "1059859811490132",  theme_emoji: null, gradient: null, should_show_icon: "1", theme_name_with_subtitle: "Stranger Things" },
+    { theme_color: "FFD4A574", theme_id: "275041734441112",   theme_emoji: null, gradient: null, should_show_icon: "1", theme_name_with_subtitle: "Care" },
+    { theme_color: "FF9B59B6", theme_id: "3082966625307060",  theme_emoji: null, gradient: null, should_show_icon: "1", theme_name_with_subtitle: "Astrology" },
+    { theme_color: "FFFF8C00", theme_id: "184305226956268",   theme_emoji: null, gradient: null, should_show_icon: "1", theme_name_with_subtitle: "J Balvin" },
+    { theme_color: "FFFF69B4", theme_id: "621630955405500",   theme_emoji: null, gradient: null, should_show_icon: "1", theme_name_with_subtitle: "Birthday" },
+    { theme_color: "FF228B22", theme_id: "539927563794799",   theme_emoji: null, gradient: null, should_show_icon: "1", theme_name_with_subtitle: "Cottagecore" },
+    { theme_color: "FF006994", theme_id: "736591620215564",   theme_emoji: null, gradient: null, should_show_icon: "1", theme_name_with_subtitle: "Ocean" },
+    { theme_color: "FFFF1493", theme_id: "741311439775765",   theme_emoji: null, gradient: null, should_show_icon: "1", theme_name_with_subtitle: "Love" },
+    { theme_color: "FFFF7F7F", theme_id: "230032715012014",   theme_emoji: null, gradient: null, should_show_icon: "1", theme_name_with_subtitle: "Tie Dye" },
+    { theme_color: "FF808080", theme_id: "262191918210707",   theme_emoji: null, gradient: null, should_show_icon: "1", theme_name_with_subtitle: "Tropical" },
+    { theme_color: "FF228B22", theme_id: "909695489504566",   theme_emoji: null, gradient: null, should_show_icon: "1", theme_name_with_subtitle: "Sushi" },
+    { theme_color: "FFFF69B4", theme_id: "280333826736184",   theme_emoji: null, gradient: null, should_show_icon: "1", theme_name_with_subtitle: "Lollipop" },
+    { theme_color: "FFFF007F", theme_id: "1257453361255152",  theme_emoji: null, gradient: null, should_show_icon: "1", theme_name_with_subtitle: "Rose" },
+    { theme_color: "FFE6E6FA", theme_id: "571193503540759",   theme_emoji: null, gradient: null, should_show_icon: "1", theme_name_with_subtitle: "Lavender" },
+    { theme_color: "FFFFC0CB", theme_id: "3151463484918004",  theme_emoji: null, gradient: null, should_show_icon: "1", theme_name_with_subtitle: "Kiwi" },
+    { theme_color: "FF6F2DA8", theme_id: "810978360551741",   theme_emoji: null, gradient: null, should_show_icon: "1", theme_name_with_subtitle: "Parenthood" },
+    { theme_color: "FF4169E1", theme_id: "1438011086532622",  theme_emoji: null, gradient: null, should_show_icon: "1", theme_name_with_subtitle: "Star Wars" },
+    { theme_color: "FF6B8E23", theme_id: "101275642962533",   theme_emoji: null, gradient: null, should_show_icon: "1", theme_name_with_subtitle: "Guardians of the Galaxy" },
+    { theme_color: "FFFF69B4", theme_id: "158263147151440",   theme_emoji: null, gradient: null, should_show_icon: "1", theme_name_with_subtitle: "Bloom" },
+    { theme_color: "FF9B59B6", theme_id: "195296273246380",   theme_emoji: null, gradient: null, should_show_icon: "1", theme_name_with_subtitle: "Bubble Tea" },
+    { theme_color: "FFFF8C00", theme_id: "6026716157422736",  theme_emoji: null, gradient: null, should_show_icon: "1", theme_name_with_subtitle: "Basketball" },
+    { theme_color: "FF4B0082", theme_id: "737761000603635",   theme_emoji: null, gradient: null, should_show_icon: "1", theme_name_with_subtitle: "Non-Binary" },
+    { theme_color: "FF55CDFC", theme_id: "504518465021637",   theme_emoji: null, gradient: null, should_show_icon: "1", theme_name_with_subtitle: "Transgender" },
+    { theme_color: "FFFC0080", theme_id: "769129927636836",   theme_emoji: null, gradient: null, should_show_icon: "1", theme_name_with_subtitle: "Taylor Swift" },
+    { theme_color: "FFFF7700", theme_id: "822549609168155",   theme_emoji: null, gradient: null, should_show_icon: "1", theme_name_with_subtitle: "Autumn" },
+    { theme_color: "FFFF007F", theme_id: "693996545771691",   theme_emoji: null, gradient: null, should_show_icon: "1", theme_name_with_subtitle: "Elephants and Flowers" },
 ];
 function formatMessage(threadID, data) {
@@ -63,20 +109,28 @@ function formatMessage(threadID, data) {
             const adminType = data.extensible_message_admin_text_type;
             if (adminType === "CHANGE_THREAD_THEME") {
-                const themeColor = data.extensible_message_admin_text.theme_color;
-                const colorMatch = THEME_COLORS.find(color => color.theme_color === themeColor);
+                const ext = data.extensible_message_admin_text || {};
+                const themeColor = ext.theme_color || null;
+                // Prefer the theme_id field returned directly by GraphQL.
+                // Fall back to a reverse lookup in THEME_COLORS for older API
+                // responses that omit theme_id.
+                const directThemeId = ext.theme_id || ext.theme_fbid || null;
+                const colorMatch = directThemeId
+                    ? THEME_COLORS.find(c => c.theme_id === directThemeId)
+                    : (themeColor ? THEME_COLORS.find(c => c.theme_color === themeColor) : null);
                 return {
                     ...baseMessage,
                     type: "event",
                     logMessageType: "log:thread-color",
-                    logMessageData: colorMatch || {
+                    logMessageData: {
                         theme_color: themeColor,
-                        theme_id: null,
-                        theme_emoji: null,
-                        gradient: null,
-                        should_show_icon: null,
-                        theme_name_with_subtitle: null
+                        theme_id: directThemeId || (colorMatch ? colorMatch.theme_id : null),
+                        theme_fbid: directThemeId || (colorMatch ? colorMatch.theme_id : null),
+                        theme_emoji: ext.theme_emoji || (colorMatch ? colorMatch.theme_emoji : null),
+                        gradient: ext.gradient || (colorMatch ? colorMatch.gradient : null),
+                        should_show_icon: ext.should_show_icon != null ? ext.should_show_icon : (colorMatch ? colorMatch.should_show_icon : null),
+                        theme_name_with_subtitle: ext.theme_name_with_subtitle || (colorMatch ? colorMatch.theme_name_with_subtitle : null)
                     },
                     logMessageBody: data.snippet
                 };

package/src/apis/getThemeInfo.js CHANGED Viewed

@@ -84,15 +84,19 @@ module.exports = function (defaultFuncs, api, ctx) {
       const info = Array.isArray(threadInfo) ? threadInfo[0] : threadInfo;
+      // theme_id comes from threadTheme.id (extracted at getThreadInfo level)
+      const themeId = info.theme_id || (info.threadTheme && info.threadTheme.id) || info.themeID || null;
       const themeInfo = {
         threadID: identifier,
         threadName: info.threadName || info.name || '',
         color: info.color || null,
         emoji: info.emoji || '👍',
-        theme_id: info.theme_id || info.themeID || null,
+        theme_id: themeId,
+        theme_fbid: themeId,
         theme_color: info.theme_color || info.color || null,
         gradient_colors: info.gradient_colors || null,
-        is_default: !info.color && !info.theme_id
+        threadTheme: info.threadTheme || null,
+        is_default: !info.color && !themeId
       };
       if (callback) {

package/src/apis/getThreadHistory.js CHANGED Viewed

@@ -203,7 +203,7 @@ module.exports = function (defaultFuncs, api, ctx) {
         }
         const form = {
-            av: ctx.globalOptions.pageID,
+            av: ctx.globalOptions.pageID || ctx.userID,
             queries: JSON.stringify({
                 o0: {
                     doc_id: "1498317363570230",

package/src/apis/getThreadInfo.js CHANGED Viewed

@@ -112,12 +112,22 @@ function formatThreadGraphQLResponse(data) {
     emoji: messageThread.customization_info
       ? messageThread.customization_info.emoji
       : null,
-    color:
-      messageThread.customization_info &&
-      messageThread.customization_info.outgoing_bubble_color
-        ? messageThread.customization_info.outgoing_bubble_color.slice(2)
-        : null,
+    color: (function() {
+      const raw = messageThread.customization_info &&
+        messageThread.customization_info.outgoing_bubble_color;
+      if (!raw) return null;
+      const s = String(raw);
+      // Format is FFRRGGBB (8 hex chars, ARGB). Strip the FF alpha prefix.
+      // Validate before slicing to avoid returning garbage for unexpected formats.
+      if (/^[0-9a-fA-F]{8}$/.test(s)) return s.slice(2);
+      // Handle #RRGGBB or #AARRGGBB
+      if (/^#[0-9a-fA-F]{6}$/.test(s)) return s.slice(1);
+      if (/^#[0-9a-fA-F]{8}$/.test(s)) return s.slice(3);
+      // Fallback: return as-is
+      return s;
+    })(),
     threadTheme: messageThread.thread_theme,
+    theme_id: messageThread.thread_theme ? (messageThread.thread_theme.id || null) : null,
     nicknames:
       messageThread.customization_info &&
       messageThread.customization_info.participant_customizations

package/src/apis/getThreadList.js CHANGED Viewed

@@ -102,12 +102,18 @@ function formatThreadGraphQLResponse(messageThread) {
     emoji: messageThread.customization_info
       ? messageThread.customization_info.emoji
       : null,
-    color:
-      messageThread.customization_info &&
-      messageThread.customization_info.outgoing_bubble_color
-        ? messageThread.customization_info.outgoing_bubble_color.slice(2)
-        : null,
+    color: (function() {
+      const raw = messageThread.customization_info &&
+        messageThread.customization_info.outgoing_bubble_color;
+      if (!raw) return null;
+      const s = String(raw);
+      if (/^[0-9a-fA-F]{8}$/.test(s)) return s.slice(2);
+      if (/^#[0-9a-fA-F]{6}$/.test(s)) return s.slice(1);
+      if (/^#[0-9a-fA-F]{8}$/.test(s)) return s.slice(3);
+      return s;
+    })(),
     threadTheme: messageThread.thread_theme,
+    theme_id: messageThread.thread_theme ? (messageThread.thread_theme.id || null) : null,
     nicknames:
       messageThread.customization_info &&
       messageThread.customization_info.participant_customizations

package/src/apis/listenMqtt.js CHANGED Viewed

@@ -449,15 +449,17 @@ async function listenMqtt(defaultFuncs, api, ctx, globalCallback, scheduleReconn
                     }
                 }
             } else if (topic === "/thread_typing" || topic === "/orca_typing_notifications") {
-                const typ = {
-                    type: "typ",
-                    isTyping: !!jsonMessage.state,
-                    from: jsonMessage.sender_fbid.toString(),
-                    threadID: utils.formatID((jsonMessage.thread || jsonMessage.sender_fbid).toString())
-                };
-                globalCallback(null, typ);
+                if (ctx.globalOptions.listenTyping) {
+                    const typ = {
+                        type: "typ",
+                        isTyping: !!jsonMessage.state,
+                        from: jsonMessage.sender_fbid.toString(),
+                        threadID: utils.formatID((jsonMessage.thread || jsonMessage.sender_fbid).toString())
+                    };
+                    globalCallback(null, typ);
+                }
             } else if (topic === "/orca_presence") {
-                if (!ctx.globalOptions.updatePresence && jsonMessage.list) {
+                if (ctx.globalOptions.updatePresence && jsonMessage.list) {
                     for (const data of jsonMessage.list) {
                         globalCallback(null, {
                             type: "presence",
@@ -808,39 +810,16 @@ module.exports = (defaultFuncs, api, ctx, opts) => {
         } catch (err) {
             const detail = (err && err.detail && err.detail.message) ? ` | detail=${err.detail.message}` : "";
             const msg = ((err && err.error) || (err && err.message) || String(err || "")) + detail;
-            const isNotLoggedIn = /Not logged in/i.test(msg);
-            const isLoginBlocked = /blocked the login|checkpoint|security check|session.*expir|invalid.*session|authentication.*fail|auth.*fail|login.*block|account.*lock|verification.*requir/i.test(msg);
-            if (isNotLoggedIn || isLoginBlocked) {
-                const reason = isLoginBlocked ? "login_blocked" : "not_logged_in";
-                utils.error("MQTT", `Auth error in getSeqID: ${reason} — attempting auto re-login`);
-                // Mirror the close-handler re-login pattern: try handleSessionExpiry first.
-                // If it succeeds we schedule a reconnect; only fall back to emitAuthError
-                // (which kills listening) when re-login is unavailable or already in progress.
-                if (!ctx._mqttReauthing && globalAutoReLoginManager && globalAutoReLoginManager.isEnabled && globalAutoReLoginManager.isEnabled()) {
-                    ctx._mqttReauthing = true;
-                    globalAutoReLoginManager.handleSessionExpiry(api, 'https://www.facebook.com', msg)
-                        .then((ok) => {
-                            ctx._mqttReauthing = false;
-                            if (ok && ctx.globalOptions.autoReconnect) {
-                                ctx._reconnectAttempts = 0;
-                                scheduleReconnect((ctx._mqttOpt && ctx._mqttOpt.reconnectDelayMs) || 2000);
-                            } else if (!ok) {
-                                emitAuthError(reason, msg);
-                            }
-                        })
-                        .catch(() => {
-                            ctx._mqttReauthing = false;
-                            emitAuthError(reason, msg);
-                        });
-                    return;
-                }
-                return emitAuthError(reason, msg);
+            if (/Not logged in/i.test(msg)) {
+                utils.error("MQTT", "Auth error in getSeqID: Not logged in");
+                return emitAuthError("not_logged_in", msg);
             }
+            if (/blocked the login|checkpoint|security check|session.*expir|invalid.*session|authentication.*fail|auth.*fail|login.*block|account.*lock|verification.*requir/i.test(msg)) {
+                utils.error("MQTT", "Auth error in getSeqID: Session/Login blocked");
+                return emitAuthError("login_blocked", msg);
+            }
             utils.error("MQTT", "getSeqID error:", msg);
             if (ctx.globalOptions.autoReconnect) {
                 const baseDelay = (ctx._mqttOpt && ctx._mqttOpt.reconnectDelayMs) || 2000;

package/src/apis/markAsRead.js CHANGED Viewed

@@ -50,23 +50,20 @@ module.exports = function (defaultFuncs, api, ctx) {
         callback(null);
       } else {
-        if (!ctx.mqttClient || !ctx.mqttClient.connected) {
-          const err = new Error("markAsRead requires an active MQTT connection. Call api.listenMqtt() first.");
-          callback(err);
-          return returnPromise;
-        }
+        const form = {
+          ["ids[" + threadID + "]"]:  read,
+          watermarkTimestamp:         Date.now(),
+          shouldSendReadReceipt:      true,
+        };
-        const publishErr = await new Promise((r) =>
-          ctx.mqttClient.publish(
-            "/mark_thread",
-            JSON.stringify({ threadID, mark: "read", state: read }),
-            { qos: 1, retain: false },
-            r,
-          )
-        );
+        const resData = await defaultFuncs
+          .post("https://www.facebook.com/ajax/mercury/change_read_status.php", ctx.jar, form)
+          .then(utils.saveCookies(ctx.jar))
+          .then(utils.parseAndCheckLogin(ctx, defaultFuncs));
-        if (publishErr) {
-          callback(publishErr instanceof Error ? publishErr : new Error(String(publishErr)));
+        if (resData && resData.error) {
+          const err = new Error(String(resData.error.message || resData.error));
+          callback(err);
           return returnPromise;
         }

package/src/apis/mqttDeltaValue.js CHANGED Viewed

@@ -183,7 +183,7 @@ function parseDelta(defaultFuncs, api, ctx, globalCallback, v) {
       } catch (err) {
         return;
       }
-      if (!ctx.globalOptions.selfListen && fmtEvent2 && fmtEvent2.author && fmtEvent2.author.toString() === ctx.userID) return;
+      if (!ctx.globalOptions.selfListenEvent && fmtEvent2 && fmtEvent2.author && fmtEvent2.author.toString() === ctx.userID) return;
       if (!ctx.loggedIn) return;
       if (fmtEvent2) globalCallback(null, fmtEvent2);
       break;
@@ -193,7 +193,7 @@ function parseDelta(defaultFuncs, api, ctx, globalCallback, v) {
       var tid = v.delta.threadKey.threadFbId;
       if (mid && tid) {
         var form = {
-          av: ctx.globalOptions.pageID,
+          av: ctx.globalOptions.pageID || ctx.userID,
           queries: JSON.stringify({
             o0: {
               doc_id: "2848441488556444",

package/src/apis/nickname.js CHANGED Viewed

@@ -99,7 +99,7 @@ module.exports = function (defaultFuncs, api, ctx) {
     };
     const context = {
-      app_id: ctx.appID,
+      app_id: ctx.appID || "2220391788200892",
       payload: {
         epoch_id: parseInt(utils.generateOfflineThreadingID()),
         tasks: [query],

package/src/apis/pinMessage.js CHANGED Viewed

@@ -34,11 +34,13 @@ function extractAndSearchLightspeedRequest(allJsonData, options = {}) {
   }
-  try {
-    fs.writeFileSync(outputFile, JSON.stringify(lightReq, null, 2), "utf8");
-    utils.log(`pin.js: Saved lightspeed_web_request to ${outputFile}`);
-  } catch (err) {
-    utils.error("pin.js: Failed to write lightspeed_web_request.json", err);
+  if (outputFile) {
+    try {
+      fs.writeFileSync(outputFile, JSON.stringify(lightReq, null, 2), "utf8");
+      utils.log(`pin.js: Saved lightspeed_web_request to ${outputFile}`);
+    } catch (err) {
+      utils.error("pin.js: Failed to write lightspeed_web_request.json", err);
+    }
   }

package/src/apis/removeUserFromGroup.js CHANGED Viewed

@@ -67,6 +67,7 @@ module.exports = (defaultFuncs, api, ctx) => {
           }
           if (jsonMsg.request_id !== reqID) return;
           responseHandled = true;
+          clearTimeout(timeout);
           ctx.mqttClient.removeListener("message", handleRes);
           callback(null, { success: true });
           resolveFunc({ success: true });

package/src/apis/setMessageReaction.js CHANGED Viewed

@@ -5,20 +5,21 @@ const utils = require('../utils');
 module.exports = function (defaultFuncs, api, ctx) {
   return async (reaction, messageID) => {
-    if (!reaction) throw new Error("Please enter a valid emoji.");
-    const defData = await defaultFuncs.postFormData("https://www.facebook.com/webgraphql/mutation/", ctx.jar, {}, {
+    if (reaction === undefined || reaction === null) throw new Error("Please enter a valid emoji.");
+    const action = reaction === "" ? "REMOVE_REACTION" : "ADD_REACTION";
+    const defData = await defaultFuncs.postFormData("https://www.facebook.com/webgraphql/mutation/", ctx.jar, {
       doc_id: "1491398900900362",
       variables: JSON.stringify({
-      data: {
-        client_mutation_id: ctx.clientMutationId++,
-        actor_id: ctx.userID,
-        action: reaction == "" ? "REMOVE_REACTION" : "ADD_REACTION",
-        message_id: messageID,
-        reaction
-      }
-    }),
+        data: {
+          client_mutation_id: ctx.clientMutationId++,
+          actor_id: ctx.userID,
+          action,
+          message_id: messageID,
+          reaction
+        }
+      }),
       dpr: 1
-    });
+    }, {});
     const resData = await utils.parseAndCheckLogin(ctx, defaultFuncs)(defData);
     if (!resData) {
       throw new Error("setMessageReactionLegacy returned empty object.");

package/src/apis/setThreadTheme.js CHANGED Viewed

@@ -35,17 +35,17 @@ module.exports = function (defaultFuncs, api, ctx) {
     // ── Hardcoded colour aliases (fast path — no API round trip needed) ──────
     const PALETTE = {
-      blue:    "196241301102133",
-      purple:  "370940413392601",
-      green:   "169463077092846",
-      pink:    "230032715012014",
-      orange:  "175615189761153",
-      red:     "2136751179887052",
-      yellow:  "2058653964378557",
-      teal:    "417639218648241",
-      black:   "539927563794799",
-      white:   "2873642392710980",
-      default: "196241301102133",
+      blue:    "196241301102133",  // DefaultBlue / MessengerBlue
+      purple:  "234137870477637",  // BrightPurple / MediumSlateBlue
+      green:   "2136751179887052", // FreeSpeechGreen / Green
+      pink:    "169463077092846",  // HotPink / BrilliantRose
+      orange:  "175615189761153",  // Pumpkin / Orange
+      red:     "2129984390566328", // RadicalRed / Red
+      yellow:  "174636906462322",  // GoldenPoppy / Yellow
+      teal:    "1928399724138152", // TealBlue / Viking
+      aqua:    "417639218648241",  // Aqua
+      black:   "271607034185782",  // Shadow (darkest solid theme)
+      default: "196241301102133",  // DefaultBlue
     };
     (async function worker() {

package/src/apis/unsendMessage.js CHANGED Viewed

@@ -10,7 +10,7 @@ module.exports = function (defaultFuncs, api, ctx) {
     })
     const resData = await utils.parseAndCheckLogin(ctx, defaultFuncs)(defData);
     if (resData.error) {
-      throw new Error(resData);
+      throw new Error(JSON.stringify(resData));
     }
     return resData;
   };

package/src/utils/axios.js CHANGED Viewed

@@ -77,22 +77,29 @@ async function inspectResponseForSessionIssues(adapted, ctx) {
     }
     if (isScrapingWarning) {
-        // Auto-dismiss before propagating the error.  Unhandled scraping warnings
-        // escalate to permanent suspension.  We await the bypass so the checkpoint is
-        // gone before the caller's retry (e.g. MQTT reconnect) fires.
-        // Guards: only attempt when ctx has jar + globalOptions available.
-        if (ctx && ctx.jar && ctx.globalOptions) {
+        if (ctx._emitter && typeof ctx._emitter.emit === 'function') {
+            ctx._emitter.emit('checkpoint', { type: 'scraping_warning', res: body });
+        }
+        // Attempt auto-login recovery — throwing immediately here escalates
+        // the checkpoint into a permanent ban without giving the session a
+        // chance to recover.
+        if (!ctx.auto_login && typeof ctx.performAutoLogin === 'function') {
+            ctx.auto_login = true;
             try {
-                const { bypassScrapingWarning } = require('./checkpointBypass');
-                await bypassScrapingWarning(ctx.jar, ctx.globalOptions, ctx.userID || null, null);
+                const ok = await ctx.performAutoLogin();
+                if (ok) {
+                    if (ctx._emitter && typeof ctx._emitter.emit === 'function') {
+                        ctx._emitter.emit('autoLoginSuccess', { res: body });
+                    }
+                    ctx.auto_login = false;
+                    return;
+                }
             } catch (_) {}
+            ctx.auto_login = false;
         }
         const err = new Error('Facebook scraping warning checkpoint detected.');
         err.error = 'checkpoint_scraping';
         err.res = body;
-        if (ctx._emitter && typeof ctx._emitter.emit === 'function') {
-            ctx._emitter.emit('checkpoint', { type: 'scraping_warning', res: body });
-        }
         throw err;
     }
@@ -101,14 +108,10 @@ async function inspectResponseForSessionIssues(adapted, ctx) {
     // actual login page — NOT generic strings like '"login.php?"' or
     // '"login_page"' which Facebook embeds in authenticated page payloads as
     // navigation links and client-side route names, causing false positives.
-    // `/checkpoint/block/?next` is the URL Facebook redirects to when it forces
-    // a logout; it appears in the response body as a redirect target and is a
-    // reliable signal that the session is gone.
     const isLoginRedirect =
         bodyStr.includes('<form id="login_form"') ||
         bodyStr.includes('id="loginbutton"') ||
-        bodyStr.includes('id="email" name="email"') ||
-        bodyStr.includes('/checkpoint/block/?next');
+        bodyStr.includes('id="email" name="email"');
     const isLoginBlocked =
         typeof body === 'object' && body !== null && body.error === 1357001;
@@ -261,6 +264,17 @@ async function requestWithRetry(requestFunction, retries = 5, endpoint = '', thr
             if (error.response) {
                 const adapted = adaptResponse(error.response);
                 checkAndApplyRateLimitCooldowns(adapted.body);
+                // Emit rateLimit event on HTTP 429 so consumers can react
+                if (error.response.status === 429) {
+                    if (ctx && ctx._emitter && typeof ctx._emitter.emit === 'function') {
+                        try { ctx._emitter.emit('rateLimit', { res: adapted.body, status: 429 }); } catch (_) {}
+                    }
+                    const waitMs = Math.min(Math.pow(2, i) * 1000 + Math.floor(Math.random() * 200), 30000);
+                    console.warn(`Rate limited (429). Waiting ${waitMs}ms before retry...`);
+                    await delay(waitMs);
+                    continue;
+                }
             }
             if (i === retries - 1) {
@@ -270,7 +284,7 @@ async function requestWithRetry(requestFunction, retries = 5, endpoint = '', thr
                 }
                 throw error;
             }
-            const backoffTime = (Math.pow(2, i)) * 1000 + Math.floor(Math.random() * 1000);
+            const backoffTime = Math.min(Math.pow(2, i) * 1000 + Math.floor(Math.random() * 200), 30000);
             console.warn(`Request attempt ${i + 1} failed. Retrying in ${backoffTime}ms...`);
             await delay(backoffTime);
         }

package/src/utils/clients.js CHANGED Viewed

@@ -3,6 +3,54 @@
 const { makeParsable, log, warn } = require("./constants");
 const { globalRateLimiter, configureRateLimiter } = require("./rateLimiter");
+/**
+ * Safely emits an event on ctx._emitter without throwing if the emitter is absent.
+ * @param {Object} ctx - Application context.
+ * @param {string} event - Event name.
+ * @param {*} payload - Event payload.
+ */
+function _emit(ctx, event, payload) {
+  try {
+    if (ctx && ctx._emitter && typeof ctx._emitter.emit === 'function') {
+      ctx._emitter.emit(event, payload);
+    }
+  } catch (_) {}
+}
+/**
+ * Attempts auto-login via ctx.performAutoLogin (wired by loginHelper).
+ * On success returns the original res so callers can continue transparently.
+ * On failure throws a SESSION_EXPIRED error with requiresReLogin = true.
+ * @param {Object} ctx
+ * @param {Object} http
+ * @param {*} res - Parsed JSON response body (passed through on success).
+ * @param {number} retryCount
+ * @returns {Promise<*>}
+ */
+async function _maybeAutoLogin(ctx, http, res, retryCount) {
+  if (ctx && !ctx.auto_login && typeof ctx.performAutoLogin === 'function') {
+    ctx.auto_login = true;
+    try {
+      const ok = await ctx.performAutoLogin();
+      ctx.auto_login = false;
+      if (ok) {
+        _emit(ctx, 'autoLoginSuccess', { res });
+        return res;
+      }
+    } catch (e) {
+      ctx.auto_login = false;
+      _emit(ctx, 'autoLoginFailed', { error: e, res });
+    }
+  }
+  _emit(ctx, 'sessionExpired', { reason: 'login_redirect' });
+  const err = new Error("Session expired - Redirected to login page");
+  err.error = 401;
+  err.errorCode = 401;
+  err.errorType = "LOGIN_REDIRECT";
+  err.requiresReLogin = true;
+  throw err;
+}
 /**
  * Formats a cookie array into a string for use in a cookie jar.
  * @param {Array<string>} arr - An array containing cookie parts.
@@ -23,33 +71,14 @@ function formatCookie(arr, url) {
 function parseAndCheckLogin(ctx, http, retryCount = 0) {
   const delay = (ms) => new Promise((resolve) => setTimeout(resolve, ms));
-  /**
-   * Attempt performAutoLogin if available and not already in progress.
-   * Returns true if re-login succeeded, false otherwise.
-   * Always resets ctx.auto_login in a finally block.
-   */
-  async function tryAutoLogin() {
-    if (ctx.auto_login || typeof ctx.performAutoLogin !== 'function') return false;
-    ctx.auto_login = true;
-    try {
-      const ok = await ctx.performAutoLogin();
-      return !!ok;
-    } catch (_) {
-      return false;
-    } finally {
-      ctx.auto_login = false;
-    }
-  }
   return async (data) => {
     if (data.statusCode === 401) {
-      warn("Session Status", "Session expired. Triggering auto re-login...");
-      await tryAutoLogin();
       const err = new Error("Session expired - Authentication required");
       err.error = 401;
       err.errorCode = 401;
       err.errorType = "AUTHENTICATION_REQUIRED";
       err.requiresReLogin = true;
+      warn("Session Status", "Session expired. Re-login required.");
       throw err;
     }
@@ -59,15 +88,20 @@ function parseAndCheckLogin(ctx, http, retryCount = 0) {
         err.statusCode = data.statusCode;
         err.res = data.body;
         err.error = "Request retry failed. Check the `res` and `statusCode` property on this error.";
+        log(`parseAndCheckLogin: Max retries (5) reached for status ${data.statusCode}`);
         throw err;
       }
       retryCount++;
-      const retryTime = Math.floor(Math.random() * 5000);
+      const baseDelay = retryCount === 1 ? 1500 : 1000 * Math.pow(2, retryCount - 1);
+      const jitter = Math.floor(Math.random() * 200);
+      const retryTime = Math.min(baseDelay + jitter, 10000);
       const url = data.request.uri.protocol + "//" + data.request.uri.hostname + data.request.uri.pathname;
+      warn(`parseAndCheckLogin: HTTP ${data.statusCode} — retrying (attempt ${retryCount}/5) after ${retryTime}ms`);
       await delay(retryTime);
+      // Guard against undefined Content-Type header before splitting
       const contentType = (data.request.headers && data.request.headers["content-type"]) || "";
       if (contentType.split(";")[0].trim() === "multipart/form-data") {
         const newData = await http.postFormData(
@@ -79,6 +113,10 @@ function parseAndCheckLogin(ctx, http, retryCount = 0) {
         );
         return await parseAndCheckLogin(ctx, http, retryCount)(newData);
       } else {
+        // defaultFuncs.post signature: (url, jar, form, ctxx, customHeader)
+        // The 4th arg must be ctx (not ctx.globalOptions) — passing globalOptions
+        // here caused the retry to be treated as a raw network call without
+        // session context, missing auth headers and session inspection.
         const newData = await http.post(
           url,
           ctx.jar,
@@ -121,9 +159,8 @@ function parseAndCheckLogin(ctx, http, retryCount = 0) {
     if (res.jsmods && res.jsmods.require && Array.isArray(res.jsmods.require[0]) && res.jsmods.require[0][0] === "Cookie") {
       res.jsmods.require[0][3][0] = res.jsmods.require[0][3][0].replace("_js_", "");
       const requireCookie = res.jsmods.require[0][3];
-      // Use setCookieSync to avoid async fire-and-forget that drops rotated session cookies
-      try { ctx.jar.setCookieSync(formatCookie(requireCookie, "facebook"), "https://www.facebook.com"); } catch (_) {}
-      try { ctx.jar.setCookieSync(formatCookie(requireCookie, "messenger"), "https://www.messenger.com"); } catch (_) {}
+      ctx.jar.setCookie(formatCookie(requireCookie, "facebook"), "https://www.facebook.com");
+      ctx.jar.setCookie(formatCookie(requireCookie, "messenger"), "https://www.messenger.com");
     }
     if (res.jsmods && Array.isArray(res.jsmods.require)) {
@@ -135,9 +172,6 @@ function parseAndCheckLogin(ctx, http, retryCount = 0) {
           for (let j = 0; j < ctx.fb_dtsg.length; j++) {
             ctx.ttstamp += ctx.fb_dtsg.charCodeAt(j);
           }
-          // jazoest MUST stay in sync with fb_dtsg — stale jazoest causes form-submission
-          // failures that Facebook treats as tamper attempts and flags as bot activity.
-          ctx.jazoest = `2${Array.from(ctx.fb_dtsg).reduce((a, b) => a + b.charCodeAt(0), 0)}`;
         }
       }
     }
@@ -149,16 +183,12 @@ function parseAndCheckLogin(ctx, http, retryCount = 0) {
     };
     if (res.error && SESSION_EXPIRY_CODES[res.error]) {
-      warn("Session Status", `${SESSION_EXPIRY_CODES[res.error]} (Code: ${res.error}) — triggering auto re-login`);
-      // Fire re-login so the session is refreshed even though this request fails.
-      // Awaiting ensures the new session is ready before the error propagates to
-      // callers (e.g. MQTT reconnect) that would immediately retry.
-      await tryAutoLogin();
       const err = new Error(SESSION_EXPIRY_CODES[res.error]);
       err.error = res.error;
       err.errorCode = res.error;
       err.errorType = "SESSION_EXPIRED";
       err.requiresReLogin = true;
+      warn("Session Status", `${SESSION_EXPIRY_CODES[res.error]} (Code: ${res.error})`);
       throw err;
     }
@@ -177,67 +207,61 @@ function parseAndCheckLogin(ctx, http, retryCount = 0) {
       err.errorType = res.error === 1357004 ? "CHECKPOINT" : res.error === 1357031 ? "LOCKED" : "BLOCKED";
       err.requiresReLogin = res.error === 1357004 || res.error === 1357031;
       warn("Account Status", `${ACCOUNT_ERROR_CODES[res.error]} (Code: ${res.error})`);
-      // For checkpoint and locked states, trigger re-login so the session can recover
-      if (err.requiresReLogin) {
-        await tryAutoLogin();
-      }
       throw err;
     }
     if (res.error === 1357001 || (res.errorSummary && res.errorSummary.includes("blocked"))) {
       const err = new Error("Facebook blocked the login");
-      err.error = "Not logged in.";
+      err.error = "login_blocked";
       err.errorType = "BLOCKED";
+      err.res = res;
+      _emit(ctx, "loginBlocked", { res });
       throw err;
     }
     const resStr = JSON.stringify(res);
+    // Scraping warning checkpoint — emit event and attempt auto-login so the
+    // session can recover instead of crashing. Throwing immediately here
+    // escalates the checkpoint into a permanent ban.
     if (resStr.includes("XCheckpointFBScrapingWarningController") || resStr.includes("601051028565049")) {
-      warn("Bot Detection", "Facebook checkpoint detected - scraping warning (601051028565049) — auto-dismissing");
-      try {
-        globalRateLimiter.setEndpointCooldown("__GLOBAL__", 5 * 60 * 1000);
+      warn("Bot Detection", "Facebook scraping-warning checkpoint detected — attempting auto-login recovery");
+      _emit(ctx, "checkpoint", { type: "scraping_warning", res });
+      try {
+        globalRateLimiter.setEndpointCooldown("__GLOBAL__", 5 * 60 * 1000);
         configureRateLimiter({ maxConcurrentRequests: 2 });
       } catch (_) {}
-      // Auto-dismiss the scraping warning — unhandled warnings escalate to permanent
-      // account suspension.  This path is reached when inspectResponseForSessionIssues
-      // was skipped (ctx._skipSessionInspect or null ctx).  We still throw after
-      // cleanup: `res` at this point is checkpoint JSON, not a valid API response,
-      // so returning it would corrupt the caller.  The bypass ensures the NEXT
-      // retry finds a clean session.
-      try {
-        const { bypassScrapingWarning } = require('./checkpointBypass');
-        await bypassScrapingWarning(ctx.jar, ctx.globalOptions, ctx.userID, null);
-        warn("Bot Detection", "Scraping warning dismissed — checkpoint cleared for next retry");
-      } catch (bypassErr) {
-        warn("Bot Detection", `Scraping warning bypass failed: ${bypassErr && bypassErr.message ? bypassErr.message : String(bypassErr)}`);
-      }
-      const err = new Error("Facebook detected automated behavior - Account may be flagged");
-      err.error = "Bot checkpoint detected";
-      err.errorCode = "CHECKPOINT_SCRAPING";
-      err.errorType = "BOT_DETECTION";
-      err.requiresReLogin = true;
-      throw err;
+      return await _maybeAutoLogin(ctx, http, res, retryCount);
     }
     if (resStr.includes("1501092823525282")) {
-      warn("Bot Detection", "Critical bot checkpoint 282 detected! Account requires immediate attention!");
-      log("Please check your Facebook account in a browser and complete any security checks.");
-      try {
-        globalRateLimiter.setEndpointCooldown("__GLOBAL__", 10 * 60 * 1000);
+      warn("Bot Detection", "Critical bot checkpoint 282 detected! Please check your Facebook account.");
+      try {
+        globalRateLimiter.setEndpointCooldown("__GLOBAL__", 10 * 60 * 1000);
         configureRateLimiter({ maxConcurrentRequests: 1 });
       } catch (_) {}
-      const err = new Error("Facebook detected automated behavior - Critical checkpoint required");
-      err.error = "Critical bot checkpoint";
+      _emit(ctx, "checkpoint", { type: "282", res });
+      _emit(ctx, "checkpoint_282", { res });
+      const err = new Error("Checkpoint 282 detected");
+      err.error = "checkpoint_282";
       err.errorCode = "CHECKPOINT_282";
       err.errorType = "BOT_DETECTION_CRITICAL";
       err.requiresReLogin = true;
+      err.res = res;
       throw err;
     }
     if (resStr.includes("828281030927956")) {
-      warn("Bot Detection", "Bot checkpoint 956 detected - Account may be restricted");
-      log("Please verify your Facebook account status in a browser.");
+      warn("Bot Detection", "Bot checkpoint 956 detected — account may be restricted");
+      _emit(ctx, "checkpoint", { type: "956", res });
+      _emit(ctx, "checkpoint_956", { res });
+      const err = new Error("Checkpoint 956 detected");
+      err.error = "checkpoint_956";
+      err.errorCode = "CHECKPOINT_956";
+      err.errorType = "BOT_DETECTION";
+      err.requiresReLogin = true;
+      err.res = res;
+      throw err;
     }
     // Only treat a redirect to login.php as a session expiry if the server
@@ -245,29 +269,13 @@ function parseAndCheckLogin(ctx, http, retryCount = 0) {
     // anywhere in the body JSON, which it does on authenticated pages as a
     // navigation/share link, causing false-positive session expiry errors.
     if (String(res.redirect || "").includes("login.php")) {
-      warn("Session Status", "Redirected to login page - Session expired — triggering auto re-login");
-      await tryAutoLogin();
-      const err = new Error("Session expired - Redirected to login page");
-      err.error = 401;
-      err.errorCode = 401;
-      err.errorType = "LOGIN_REDIRECT";
-      err.requiresReLogin = true;
-      throw err;
+      warn("Session Status", "Redirected to login page — attempting auto-login recovery");
+      return await _maybeAutoLogin(ctx, http, res, retryCount);
     }
-    if (typeof data.body === 'string' && (
-      data.body.includes('<title>Facebook - Log In or Sign Up</title>') ||
-      data.body.includes('name="login_form"') ||
-      data.body.includes('/checkpoint/block/?next')
-    )) {
-      warn("Session Status", "Detected login page or checkpoint redirect — triggering auto re-login");
-      await tryAutoLogin();
-      const err = new Error("Session expired - Redirected to login page");
-      err.error = 401;
-      err.errorCode = 401;
-      err.errorType = "LOGIN_REDIRECT";
-      err.requiresReLogin = true;
-      throw err;
+    if (typeof data.body === 'string' && (data.body.includes('<title>Facebook - Log In or Sign Up</title>') || data.body.includes('name="login_form"'))) {
+      warn("Session Status", "Detected login page redirect — session expired");
+      return await _maybeAutoLogin(ctx, http, res, retryCount);
     }
     return res;
@@ -276,25 +284,26 @@ function parseAndCheckLogin(ctx, http, retryCount = 0) {
 /**
  * Saves cookies from a response to the cookie jar.
- * Uses setCookieSync to guarantee cookies are saved before the next request fires.
- * Facebook continuously rotates session cookies (xs, c_user, fr, etc.) — any missed
- * rotation leaves the jar stale and Facebook forces an immediate logout.
- *
  * @param {Object} jar - The cookie jar instance.
  * @returns {function(res: Object): Object} A function that processes the response and returns it.
  */
 function saveCookies(jar) {
   return function (res) {
-    const cookies = (res.headers && res.headers["set-cookie"]) || [];
+    const cookies = res.headers["set-cookie"] || [];
     cookies.forEach(function (c) {
-      // Save to facebook.com
-      try { jar.setCookieSync(c, "https://www.facebook.com"); } catch (_) {}
-      // Mirror to messenger.com so MQTT / Messenger API calls stay authenticated.
+      // Always attempt to save every Set-Cookie header to both domains.
+      // The old guard `c.indexOf(".facebook.com") > -1` silently dropped
+      // cookies whose domain attribute was `facebook.com` (no dot),
+      // `www.facebook.com`, or absent entirely.  Facebook rotates critical
+      // session cookies (xs, c_user, fr, etc.) continuously — missing a
+      // single update causes the jar to go stale and Facebook forces logout.
+      try { jar.setCookie(c, "https://www.facebook.com"); } catch (_) {}
+      // Mirror to messenger.com so MQTT / Messenger API calls stay authed.
       const c2 = c
         .replace(/domain=[^;]*/i, "domain=.messenger.com")
         .replace(/secure;?\s*/i, "");
-      try { jar.setCookieSync(c2, "https://www.messenger.com"); } catch (_) {}
+      try { jar.setCookie(c2, "https://www.messenger.com"); } catch (_) {}
     });
     return res;
   };
@@ -309,6 +318,7 @@ function saveCookies(jar) {
 function getAccessFromBusiness(jar, Options) {
   return async function (res) {
     const html = res ? res.body : null;
+    // Use the same axios wrapper used everywhere else — "request" module does not exist
     const { get } = require("./axios");
     try {
         const businessRes = await get("https://business.facebook.com/content_management", jar, null, Options, { noRef: true });
@@ -321,24 +331,14 @@ function getAccessFromBusiness(jar, Options) {
 }
 /**
- * Retrieves all cookies from the jar for both Facebook and Messenger domains,
- * deduplicated by key + domain + path so stale copies don't shadow fresh ones.
+ * Retrieves all cookies from the jar for both Facebook and Messenger domains.
  * @param {Object} jar - The cookie jar instance.
  * @returns {Array<Object>} An array of cookie objects.
  */
 function getAppState(jar) {
-  const fbCookies = jar.getCookiesSync("https://www.facebook.com");
-  const messengerCookies = jar.getCookiesSync("https://www.messenger.com");
-  const seen = new Set();
-  const all = [];
-  for (const cookie of [...fbCookies, ...messengerCookies]) {
-    const id = `${cookie.key}|${cookie.domain || ""}|${cookie.path || "/"}`;
-    if (!seen.has(id)) {
-      seen.add(id);
-      all.push(cookie);
-    }
-  }
-  return all;
+  return jar
+    .getCookiesSync("https://www.facebook.com")
+    .concat(jar.getCookiesSync("https://www.messenger.com"));
 }
 module.exports = {