stfca 1.0.14 → 1.0.15

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "stfca",
-  "version": "1.0.14",
+  "version": "1.0.15",
   "description": "Unofficial Facebook Chat API for Node.js with Auto-Update System - Enhanced by ST | Sheikh Tamim",
   "main": "index.js",
   "files": [

package/src/note.js

@@ -0,0 +1,228 @@
+
+"use strict";
+
+const utils = require('../utils');
+
+/**
+ * @description Enhanced module for interacting with Facebook Messenger Notes with additional features
+ * @param {Object} defaultFuncs The default functions provided by the API wrapper
+ * @param {Object} api The full API object
+ * @param {Object} ctx The context object containing the user's session state
+ * @returns {Object} An object containing enhanced methods for note management
+ */
+module.exports = function(defaultFuncs, api, ctx) {
+
+  /**
+   * @callback notesCallback
+   * @param {Error|null} error An error object if the request fails, otherwise null
+   * @param {Object} [data] The data returned from the API
+   */
+
+  /**
+   * Enhanced check note function with additional user info
+   */
+  function checkNoteAdvanced(callback) {
+    if (typeof callback !== 'function') {
+      callback = () => {};
+    }
+
+    const form = {
+      fb_api_caller_class: "RelayModern",
+      fb_api_req_friendly_name: "MWInboxTrayNoteCreationDialogQuery",
+      variables: JSON.stringify({ scale: 2 }),
+      doc_id: "30899655739648624",
+    };
+
+    defaultFuncs
+      .post("https://www.facebook.com/api/graphql/", ctx.jar, form)
+      .then(utils.parseAndCheckLogin(ctx, defaultFuncs))
+      .then(resData => {
+        if (resData && resData.errors) throw resData.errors[0];
+        const currentNote = resData?.data?.viewer?.actor?.msgr_user_rich_status;
+
+        // Enhanced response with additional metadata
+        const enhancedResponse = {
+          note: currentNote,
+          hasActiveNote: !!currentNote,
+          userId: ctx.userID,
+          timestamp: Date.now(),
+          expiresAt: currentNote ? (currentNote.created_time * 1000) + (24 * 60 * 60 * 1000) : null
+        };
+
+        callback(null, enhancedResponse);
+      })
+      .catch(err => {
+        utils.error && utils.error("notesv2.checkNoteAdvanced", err);
+        callback(err);
+      });
+  }
+
+  /**
+   * Create note with enhanced privacy options and validation
+   */
+  function createNoteAdvanced(text, options = {}, callback) {
+    if (typeof options === 'function') {
+      callback = options;
+      options = {};
+    }
+
+    if (typeof callback !== 'function') {
+      callback = () => {};
+    }
+
+    // Validate input
+    if (!text || text.trim().length === 0) {
+      return callback(new Error("Note text cannot be empty"));
+    }
+
+    if (text.length > 280) {
+      return callback(new Error("Note text cannot exceed 280 characters"));
+    }
+
+    const {
+      privacy = "FRIENDS",
+      duration = 86400,
+      noteType = "TEXT_NOTE"
+    } = options;
+
+    const variables = {
+      input: {
+        client_mutation_id: Math.round(Math.random() * 1000000).toString(),
+        actor_id: ctx.userID,
+        description: text.trim(),
+        duration: duration,
+        note_type: noteType,
+        privacy: privacy,
+        session_id: utils.getGUID(),
+      },
+    };
+
+    const form = {
+      fb_api_caller_class: "RelayModern",
+      fb_api_req_friendly_name: "MWInboxTrayNoteCreationDialogCreationStepContentMutation",
+      variables: JSON.stringify(variables),
+      doc_id: "24060573783603122",
+    };
+
+    defaultFuncs
+      .post("https://www.facebook.com/api/graphql/", ctx.jar, form)
+      .then(utils.parseAndCheckLogin(ctx, defaultFuncs))
+      .then(resData => {
+        if (resData && resData.errors) throw resData.errors[0];
+        const status = resData?.data?.xfb_rich_status_create?.status;
+        if (!status) throw new Error("Could not find note status in the server response.");
+
+        // Enhanced response
+        const enhancedResponse = {
+          ...status,
+          createdAt: Date.now(),
+          expiresAt: Date.now() + (duration * 1000),
+          characterCount: text.trim().length,
+          privacy: privacy
+        };
+
+        callback(null, enhancedResponse);
+      })
+      .catch(err => {
+        utils.error && utils.error("notesv2.createNoteAdvanced", err);
+        callback(err);
+      });
+  }
+
+  /**
+   * Delete note with confirmation
+   */
+  function deleteNoteAdvanced(noteID, callback) {
+    if (typeof callback !== 'function') {
+      callback = () => {};
+    }
+
+    if (!noteID) {
+      return callback(new Error("Note ID is required"));
+    }
+
+    const variables = {
+      input: {
+        client_mutation_id: Math.round(Math.random() * 1000000).toString(),
+        actor_id: ctx.userID,
+        rich_status_id: noteID,
+      },
+    };
+
+    const form = {
+      fb_api_caller_class: "RelayModern",
+      fb_api_req_friendly_name: "useMWInboxTrayDeleteNoteMutation",
+      variables: JSON.stringify(variables),
+      doc_id: "9532619970198958",
+    };
+
+    defaultFuncs
+      .post("https://www.facebook.com/api/graphql/", ctx.jar, form)
+      .then(utils.parseAndCheckLogin(ctx, defaultFuncs))
+      .then(resData => {
+        if (resData && resData.errors) throw resData.errors[0];
+        const deletedStatus = resData?.data?.xfb_rich_status_delete;
+        if (!deletedStatus) throw new Error("Could not find deletion status in the server response.");
+
+        const enhancedResponse = {
+          ...deletedStatus,
+          deletedAt: Date.now(),
+          noteId: noteID
+        };
+
+        callback(null, enhancedResponse);
+      })
+      .catch(err => {
+        utils.error && utils.error("notesv2.deleteNoteAdvanced", err);
+        callback(err);
+      });
+  }
+
+  /**
+   * Update existing note (delete old and create new)
+   */
+  function updateNote(oldNoteID, newText, options = {}, callback) {
+    if (typeof options === 'function') {
+      callback = options;
+      options = {};
+    }
+
+    if (typeof callback !== 'function') {
+      callback = () => {};
+    }
+
+    deleteNoteAdvanced(oldNoteID, (err, deleted) => {
+      if (err) {
+        return callback(err);
+      }
+
+      // Wait a bit before creating new note
+      setTimeout(() => {
+        createNoteAdvanced(newText, options, (err, created) => {
+          if (err) {
+            return callback(err);
+          }
+          callback(null, { 
+            deleted, 
+            created,
+            updatedAt: Date.now()
+          });
+        });
+      }, 1000);
+    });
+  }
+
+  return {
+    // Enhanced functions
+    checkAdvanced: checkNoteAdvanced,
+    createAdvanced: createNoteAdvanced,
+    deleteAdvanced: deleteNoteAdvanced,
+    update: updateNote,
+
+    // Backward compatibility
+    check: checkNoteAdvanced,
+    create: createNoteAdvanced,
+    delete: deleteNoteAdvanced,
+    recreate: updateNote
+  };
+};

package/src/removeSuspiciousAccount.js

@@ -0,0 +1,79 @@
+/**
+ * ===========================================================
+ * 🧑‍💻 Author: Sheikh Tamim (ST | Sheikh Tamim)
+ * 🔰 Owner & Developer
+ * 🌐 GitHub: https://github.com/sheikhtamimlover
+ * 📸 Instagram: https://instagram.com/sheikh.tamim_lover
+ * -----------------------------------------------------------
+ * 🕊️ Respect the creator & give proper credits if reused.
+ * ===========================================================
+ */
+"use strict";
+
+const utils = require("../utils");
+const log = require("npmlog");
+
+module.exports = function (defaultFuncs, api, ctx) {
+     /** Developed by Sheikh Tamim | GitHub: sheikhtamimlover | Instagram: @sheikh.tamim_lover */
+	return function removeSuspiciousAccount(callback) {
+		let resolveFunc = function () {};
+		let rejectFunc = function () {};
+		const returnPromise = new Promise(function (resolve, reject) {
+			resolveFunc = resolve;
+			rejectFunc = reject;
+		});
+
+		if (!callback) {
+			callback = function (err, data) {
+				if (err) return rejectFunc(err);
+				resolveFunc(data);
+			};
+		}
+
+		const form = {
+			av: ctx.userID,
+			__user: ctx.userID,
+			__a: "1",
+			__req: utils.getGUID(),
+			__hs: utils.getEventTime(),
+			dpr: "1",
+			__ccg: "EXCELLENT",
+			__rev: "1029700657",
+			__s: utils.getSessionID(),
+			__hsi: utils.getEventTime(),
+			__dyn: ctx.__dyn || "",
+			__csr: ctx.__csr || "",
+			__comet_req: "15",
+			fb_dtsg: ctx.fb_dtsg || "",
+			jazoest: utils.getJazoest(ctx.fb_dtsg),
+			lsd: utils.getFormData(ctx.jar, "https://www.facebook.com")?.lsd || "J4SCzL5WXd7KIzVF0tdxFm",
+			__spin_r: "1029700657",
+			__spin_b: "trunk",
+			__spin_t: utils.getEventTime(),
+			fb_api_caller_class: "RelayModern",
+			fb_api_req_friendly_name: "FBScrapingWarningMutation",
+			server_timestamps: "true",
+			variables: "{}",
+			doc_id: "24406519995698862"
+		};
+
+		defaultFuncs
+			.post("https://www.facebook.com/api/graphql/", ctx.jar, form)
+			.then(utils.parseAndCheckLogin(ctx, defaultFuncs))
+			.then(function (resData) {
+				if (resData.error) {
+					throw resData;
+				}
+
+				log.info("removeSuspiciousAccount", "Successfully removed suspicious account warning");
+				callback(null, { success: true, message: "Suspicious account warning removed" });
+			})
+			.catch(function (err) {
+				log.error("removeSuspiciousAccount", err);
+				return callback(err);
+			});
+
+		return returnPromise;
+	};
+};
+/** Developed by Sheikh Tamim | GitHub: sheikhtamimlover | Please give credits if reused. */

package/src/setActiveStatus.js

@@ -0,0 +1,93 @@
+/**
+ * ===========================================================
+ * 🧑‍💻 Author: Sheikh Tamim (ST | Sheikh Tamim)
+ * 🔰 Owner & Developer
+ * 🌐 GitHub: https://github.com/sheikhtamimlover
+ * 📸 Instagram: https://instagram.com/sheikh.tamim_lover
+ * -----------------------------------------------------------
+ * 🕊️ Respect the creator & give proper credits if reused.
+ * ===========================================================
+ */
+"use strict";
+
+var utils = require("../utils");
+var log = require("npmlog");
+
+module.exports = function (defaultFuncs, api, ctx) {
+    /** Developed by Sheikh Tamim | GitHub: sheikhtamimlover | Instagram: @sheikh.tamim_lover */
+    return function setActiveStatus(isActive, callback) {
+        var resolveFunc = function () { };
+        var rejectFunc = function () { };
+        var returnPromise = new Promise(function (resolve, reject) {
+            resolveFunc = resolve;
+            rejectFunc = reject;
+        });
+
+        if (!callback) {
+            callback = function (err, data) {
+                if (err) return rejectFunc(err);
+                resolveFunc(data);
+            };
+        }
+
+        if (typeof isActive !== "boolean") {
+            return callback({ error: "isActive must be a boolean value" });
+        }
+
+        const form = {
+            av: ctx.userID,
+            __aaid: 0,
+            __user: ctx.userID,
+            __a: 1,
+            __req: utils.getSignatureID(),
+            __hs: "20351.HYP:comet_pkg.2.1...0",
+            dpr: 1,
+            __ccg: "EXCELLENT",
+            __rev: "1027388793",
+            __s: utils.getSignatureID(),
+            __hsi: "7552256848274926554",
+            __comet_req: 15,
+            fb_dtsg: ctx.fb_dtsg,
+            jazoest: ctx.ttstamp,
+            lsd: ctx.fb_dtsg,
+            __spin_r: "1027388793",
+            __spin_b: "trunk",
+            __spin_t: Date.now(),
+            fb_api_caller_class: "RelayModern",
+            fb_api_req_friendly_name: "UpdatePresenceSettingsMutation",
+            variables: JSON.stringify({
+                input: {
+                    online_policy: "ALLOWLIST",
+                    web_allowlist: [],
+                    web_visibility: isActive,
+                    actor_id: ctx.userID.toString(),
+                    client_mutation_id: "1"
+                }
+            }),
+            server_timestamps: true,
+            doc_id: "9444355898946246"
+        };
+
+        defaultFuncs
+            .post("https://www.facebook.com/api/graphql/", ctx.jar, form)
+            .then(utils.parseAndCheckLogin(ctx, defaultFuncs))
+            .then(function (resData) {
+                if (resData.error) {
+                    throw resData;
+                }
+
+                return callback(null, {
+                    success: true,
+                    activeStatus: isActive,
+                    response: resData
+                });
+            })
+            .catch(function (err) {
+                log.error("setActiveStatus", err);
+                return callback(err);
+            });
+
+        return returnPromise;
+    };
+};
+/** Developed by Sheikh Tamim | GitHub: sheikhtamimlover | Please give credits if reused. */

package/src/setProfileLock.js

@@ -0,0 +1,98 @@
+/**
+ * ===========================================================
+ * 🧑‍💻 Author: Sheikh Tamim (ST | Sheikh Tamim)
+ * 🔰 Owner & Developer
+ * 🌐 GitHub: https://github.com/sheikhtamimlover
+ * 📸 Instagram: https://instagram.com/sheikh.tamim_lover
+ * -----------------------------------------------------------
+ * 🕊️ Respect the creator & give proper credits if reused.
+ * ===========================================================
+ */
+"use strict";
+
+const utils = require("../utils");
+const log = require("npmlog");
+
+module.exports = function (defaultFuncs, api, ctx) {
+     /** Developed by Sheikh Tamim | GitHub: sheikhtamimlover | Instagram: @sheikh.tamim_lover */
+	return function setProfileLock(enable, callback) {
+		let resolveFunc = function () { };
+		let rejectFunc = function () { };
+		const returnPromise = new Promise(function (resolve, reject) {
+			resolveFunc = resolve;
+			rejectFunc = reject;
+		});
+
+		if (!callback) {
+			callback = function (err, data) {
+				if (err) {
+					return rejectFunc(err);
+				}
+				resolveFunc(data);
+			};
+		}
+
+		if (typeof enable !== "boolean") {
+			return callback(new Error("enable must be a boolean value"));
+		}
+
+		const form = {
+			av: ctx.userID,
+			__aaid: 0,
+			__user: ctx.userID,
+			__a: 1,
+			__req: utils.getGUID(),
+			__hs: ctx.fb_dtsg_ag,
+			dpr: 1,
+			__ccg: "EXCELLENT",
+			__rev: ctx.req_ID,
+			__s: utils.getGUID(),
+			__hsi: ctx.hsi,
+			__comet_req: 15,
+			fb_dtsg: ctx.fb_dtsg,
+			jazoest: utils.getJazoest(ctx.fb_dtsg),
+			lsd: ctx.fb_dtsg,
+			__spin_r: ctx.req_ID,
+			__spin_b: "trunk",
+			__spin_t: Date.now(),
+			__crn: "comet.fbweb.CometProfileTimelineListViewRoute",
+			fb_api_caller_class: "RelayModern",
+			fb_api_req_friendly_name: "WemPrivateSharingMutation",
+			server_timestamps: true,
+			variables: JSON.stringify({
+				enable: !enable
+			}),
+			doc_id: "9144138075685633"
+		};
+
+		defaultFuncs
+			.post("https://www.facebook.com/api/graphql/", ctx.jar, form)
+			.then(utils.parseAndCheckLogin(ctx, defaultFuncs))
+			.then(function (resData) {
+				if (resData.error) {
+					throw resData;
+				}
+
+				const result = resData?.data?.toggle_wem_private_sharing_control_enabled;
+				
+				if (!result) {
+					throw new Error("Cannot toggle profile lock status");
+				}
+
+				return callback(null, {
+					private_sharing_enabled: result.private_sharing_enabled,
+					is_ppg_converter: result.is_ppg_converter,
+					is_ppg_user: result.is_ppg_user,
+					last_toggle_time: result.private_sharing_last_toggle_time,
+					owner_id: result.owner_id
+				});
+			})
+			.catch(function (err) {
+				log.error("setProfileLock", err);
+				return callback(err);
+			});
+
+		return returnPromise;
+	};
+};
+/** Developed by Sheikh Tamim | GitHub: sheikhtamimlover | Please give credits if reused. */

package/src/setStoryReaction.js

@@ -1,64 +1,134 @@
+/**
+ * ===========================================================
+ * 🧑‍💻 Author: Sheikh Tamim (ST | Sheikh Tamim)
+ * 🔰 Owner & Developer
+ * 🌐 GitHub: https://github.com/sheikhtamimlover
+ * 📸 Instagram: https://instagram.com/sheikh.tamim_lover
+ * -----------------------------------------------------------
+ * 🕊️ Respect the creator & give proper credits if reused.
+ * ===========================================================
+ */
 'use strict';
 
 var utils = require('../utils.js');
 var log = require('npmlog');
 
 module.exports = function(defaultFuncs, api, ctx) {
+  /** Developed by Sheikh Tamim | GitHub: sheikhtamimlover | Instagram: @sheikh.tamim_lover */
   return function setStoryReaction(storyID, react, callback) {
-    var cb;
-    var returnPromise = new Promise(function(resolve, reject) {
-      cb = error => error ? reject(error) : resolve();
+    var resolveFunc = function () { };
+    var rejectFunc = function () { };
+    var returnPromise = new Promise(function (resolve, reject) {
+      resolveFunc = resolve;
+      rejectFunc = reject;
     });
 
     if (typeof react == 'function') {
       callback = react;
-      react = 1;
+      react = '❤️'; // Default heart reaction
+    }
+    
+    if (!callback) {
+      callback = function (err, data) {
+        if (err) return rejectFunc(err);
+        resolveFunc(data);
+      };
+    }
+
+    if (!storyID) {
+      return callback({ error: "storyID is required" });
     }
-    if (typeof callback == 'function') cb = callback;
-    if (typeof Number(react) != 'number') react = 1;
 
-    var map = {
+    var reactionMap = {
       1: '👍',
-      2: '❤️',
+      2: '❤️', 
       3: '🤗',
       4: '😆',
       5: '😮',
       6: '😢',
-      7: '😡'
-    }
+      7: '😡',
+      'like': '👍',
+      'love': '❤️',
+      'heart': '❤️',
+      'haha': '😆',
+      'wow': '😮',
+      'sad': '😢',
+      'angry': '😡'
+    };
+
+    var reaction = reactionMap[react] || react || '❤️';
+
     var form = {
-      fb_api_req_friendly_name: 'useStoriesSendReplyMutation',
+      av: ctx.userID,
+      __aaid: 0,
+      __user: ctx.userID,
+      __a: 1,
+      __req: utils.getSignatureID(),
+      __hs: ctx.fb_dtsg_ag,
+      dpr: 1,
+      __ccg: "EXCELLENT",
+      __rev: ctx.req_ID,
+      __s: utils.getSignatureID(),
+      __hsi: ctx.hsi,
+      __comet_req: 15,
+      fb_dtsg: ctx.fb_dtsg,
+      jazoest: ctx.ttstamp,
+      lsd: ctx.fb_dtsg,
+      __spin_r: ctx.req_ID,
+      __spin_b: "trunk",
+      __spin_t: Date.now(),
+      fb_api_caller_class: "RelayModern",
+      fb_api_req_friendly_name: "useStoriesSendReplyMutation",
       variables: JSON.stringify({
         input: {
-          attribution_id_v2: `StoriesCometSuspenseRoot.react,comet.stories.viewer,unexpected,${Date.now()},538296,,;CometHomeRoot.react,comet.home,via_cold_start,${Date.now()},850302,4748854339,`,
+          attribution_id_v2: `StoriesCometSuspenseRoot.react,comet.stories.viewer,unexpected,${Date.now()},356653,,;CometHomeRoot.react,comet.home,tap_tabbar,${Date.now()},109945,4748854339,,`,
           lightweight_reaction_actions: {
             offsets: [0],
-            reaction: map[react] || map[1]
+            reaction: reaction
           },
-          message: map[react] || map[1],
+          message: reaction,
           story_id: storyID,
           story_reply_type: "LIGHT_WEIGHT",
           actor_id: ctx.userID,
-          client_mutation_id: String(parseInt(Math.random() * 16))
+          client_mutation_id: String(Math.floor(Math.random() * 16) + 1)
         }
       }),
-      doc_id: '4826141330837571'
-    }
+      server_timestamps: true,
+      doc_id: "9697491553691692"
+    };
 
     defaultFuncs
-      .post('https://www.facebook.com/api/graphql/', ctx.jar, form)
+      .post("https://www.facebook.com/api/graphql/", ctx.jar, form)
       .then(utils.parseAndCheckLogin(ctx, defaultFuncs))
-      .then(function(res) {
-        if (res.errors) throw res;
-        return cb();
+      .then(function (resData) {
+        if (resData.error) throw resData;
+        
+        // Parse successful response
+        if (resData.data && resData.data.direct_message_reply) {
+          const replyData = resData.data.direct_message_reply;
+          return callback(null, {
+            success: true,
+            client_mutation_id: replyData.client_mutation_id,
+            story_id: replyData.story?.id || storyID,
+            reaction: reaction,
+            story_reactions: replyData.story?.story_card_info?.story_card_reactions?.edges || [],
+            timestamp: Date.now()
+          });
+        }
+        
+        return callback(null, {
+          success: true,
+          reaction: reaction,
+          story_id: storyID,
+          timestamp: Date.now()
+        });
       })
-      .catch(function(err) {
-        console.error('setPostReaction', err);
-        return cb(err);
+      .catch(function (err) {
+        log.error("setStoryReaction", err);
+        return callback(err);
       });
 
     return returnPromise;
-  }
-}
-
-//new update version 1.0.9
+  };
+};
+/** Developed by Sheikh Tamim | GitHub: sheikhtamimlover | Please give credits if reused. */

package/src/setStorySeen.js

@@ -0,0 +1,109 @@
+/**
+ * ===========================================================
+ * 🧑‍💻 Author: Sheikh Tamim (ST | Sheikh Tamim)
+ * 🔰 Owner & Developer
+ * 🌐 GitHub: https://github.com/sheikhtamimlover
+ * 📸 Instagram: https://instagram.com/sheikh.tamim_lover
+ * -----------------------------------------------------------
+ * 🕊️ Respect the creator & give proper credits if reused.
+ * ===========================================================
+ */
+'use strict';
+
+var utils = require('../utils.js');
+var log = require('npmlog');
+
+module.exports = function(defaultFuncs, api, ctx) {
+    /** Developed by Sheikh Tamim | GitHub: sheikhtamimlover | Instagram: @sheikh.tamim_lover */
+  return function setStorySeen(storyID, callback) {
+    var resolveFunc = function () { };
+    var rejectFunc = function () { };
+    var returnPromise = new Promise(function (resolve, reject) {
+      resolveFunc = resolve;
+      rejectFunc = reject;
+    });
+
+    if (!callback) {
+      callback = function (err, data) {
+        if (err) return rejectFunc(err);
+        resolveFunc(data);
+      };
+    }
+
+    if (!storyID) {
+      return callback({ error: "storyID is required" });
+    }
+
+    // Extract bucket_id from story_id if needed
+    var bucketID = storyID;
+    if (typeof storyID === 'string' && storyID.includes(':')) {
+      // Extract bucket ID from the story ID pattern
+      try {
+        var decoded = Buffer.from(storyID, 'base64').toString('utf-8');
+        var match = decoded.match(/(\d+)/);
+        if (match) {
+          bucketID = match[1];
+        }
+      } catch (e) {
+        // Fallback to using story ID as bucket ID
+        bucketID = storyID;
+      }
+    }
+
+    var form = {
+      av: ctx.userID,
+      __aaid: 0,
+      __user: ctx.userID,
+      __a: 1,
+      __req: utils.getSignatureID(),
+      __hs: ctx.fb_dtsg_ag,
+      dpr: 1,
+      __ccg: "EXCELLENT",
+      __rev: ctx.req_ID,
+      __s: utils.getSignatureID(),
+      __hsi: ctx.hsi,
+      __comet_req: 15,
+      fb_dtsg: ctx.fb_dtsg,
+      jazoest: ctx.ttstamp,
+      lsd: ctx.fb_dtsg,
+      __spin_r: ctx.req_ID,
+      __spin_b: "trunk",
+      __spin_t: Date.now(),
+      fb_api_caller_class: "RelayModern",
+      fb_api_req_friendly_name: "storiesUpdateSeenStateMutation",
+      variables: JSON.stringify({
+        input: {
+          bucket_id: bucketID,
+          story_id: storyID,
+          actor_id: ctx.userID,
+          client_mutation_id: String(Math.floor(Math.random() * 16) + 1)
+        },
+        scale: 1
+      }),
+      server_timestamps: true,
+      doc_id: "9567413276713742"
+    };
+
+    defaultFuncs
+      .post("https://www.facebook.com/api/graphql/", ctx.jar, form)
+      .then(utils.parseAndCheckLogin(ctx, defaultFuncs))
+      .then(function (resData) {
+        if (resData.error) throw resData;
+        
+        return callback(null, {
+          success: true,
+          story_id: storyID,
+          bucket_id: bucketID,
+          seen_time: Date.now(),
+          response: resData
+        });
+      })
+      .catch(function (err) {
+        log.error("setStorySeen", err);
+        return callback(err);
+      });
+
+    return returnPromise;
+  };
+};
+/** Developed by Sheikh Tamim | GitHub: sheikhtamimlover | Please give credits if reused. */

package/src/storyManager.js

@@ -0,0 +1,358 @@
+/**
+ * ===========================================================
+ * 🧑‍💻 Author: Sheikh Tamim (ST | Sheikh Tamim)
+ * 🔰 Owner & Developer
+ * 🌐 GitHub: https://github.com/sheikhtamimlover
+ * 📸 Instagram: https://instagram.com/sheikh.tamim_lover
+ * -----------------------------------------------------------
+ * 🕊️ Respect the creator & give proper credits if reused.
+ * ===========================================================
+ */
+'use strict';
+
+var utils = require('../utils.js');
+var log = require('npmlog');
+
+module.exports = function(defaultFuncs, api, ctx) {
+     /** Developed by Sheikh Tamim | GitHub: sheikhtamimlover | Instagram: @sheikh.tamim_lover */
+  return function storyManager(options, callback) {
+    var resolveFunc = function () { };
+    var rejectFunc = function () { };
+    var returnPromise = new Promise(function (resolve, reject) {
+      resolveFunc = resolve;
+      rejectFunc = reject;
+    });
+
+    if (!callback) {
+      callback = function (err, data) {
+        if (err) return rejectFunc(err);
+        resolveFunc(data);
+      };
+    }
+
+    if (!options || typeof options !== 'object') {
+      return callback({ error: "Options object is required" });
+    }
+
+    const { action, attachment, storyID } = options;
+
+    if (!action || !['add', 'upload', 'delete', 'check'].includes(action)) {
+      return callback({ error: "Action must be 'add', 'upload', 'delete', or 'check'" });
+    }
+
+    // Helper function to upload story attachment
+    function uploadStoryAttachment(attachment) {
+      return new Promise((resolve, reject) => {
+        if (!utils.isReadableStream(attachment)) {
+          return reject({ error: 'Attachment should be a readable stream and not ' + utils.getType(attachment) });
+        }
+
+        const uploadForm = {
+          source: "8",
+          profile_id: ctx.userID,
+          waterfallxapp: "comet_stories",
+          farr: attachment,
+          upload_id: "jsc_c_m"
+        };
+
+        const uploadUrl = `https://upload.facebook.com/ajax/react_composer/attachments/photo/upload?av=${ctx.userID}&__aaid=0&__user=${ctx.userID}&__a=1&__req=${utils.getSignatureID()}&__hs=${ctx.fb_dtsg_ag}&dpr=1&__ccg=EXCELLENT&__rev=${ctx.req_ID}&__s=${utils.getSignatureID()}&__hsi=${ctx.hsi}&__comet_req=15&fb_dtsg=${ctx.fb_dtsg}&jazoest=${ctx.ttstamp}&lsd=${ctx.fb_dtsg}&__spin_r=${ctx.req_ID}&__spin_b=trunk&__spin_t=${Date.now()}`;
+
+        defaultFuncs
+          .postFormData(uploadUrl, ctx.jar, uploadForm)
+          .then(utils.parseAndCheckLogin(ctx, defaultFuncs))
+          .then(function (resData) {
+            if (resData.error || !resData.payload || !resData.payload.photoID) {
+              throw resData || { error: "Upload failed - no photo ID returned" };
+            }
+            resolve(resData.payload.photoID);
+          })
+          .catch(reject);
+      });
+    }
+
+    // Helper function to create story
+    function createStory(photoID) {
+      return new Promise((resolve, reject) => {
+        const form = {
+          av: ctx.userID,
+          __aaid: 0,
+          __user: ctx.userID,
+          __a: 1,
+          __req: utils.getSignatureID(),
+          __hs: ctx.fb_dtsg_ag,
+          dpr: 1,
+          __ccg: "EXCELLENT",
+          __rev: ctx.req_ID,
+          __s: utils.getSignatureID(),
+          __hsi: ctx.hsi,
+          __comet_req: 15,
+          fb_dtsg: ctx.fb_dtsg,
+          jazoest: ctx.ttstamp,
+          lsd: ctx.fb_dtsg,
+          __spin_r: ctx.req_ID,
+          __spin_b: "trunk",
+          __spin_t: Date.now(),
+          fb_api_caller_class: "RelayModern",
+          fb_api_req_friendly_name: "StoriesCreateMutation",
+          variables: JSON.stringify({
+            input: {
+              audiences: [{
+                stories: {
+                  self: {
+                    target_id: ctx.userID
+                  }
+                }
+              }],
+              audiences_is_complete: true,
+              logging: {
+                composer_session_id: `${Math.random().toString(36).substring(2, 8)}-${Math.random().toString(36).substring(2, 4)}-${Math.random().toString(36).substring(2, 4)}-${Math.random().toString(36).substring(2, 4)}-${Math.random().toString(36).substring(2, 12)}`
+              },
+              navigation_data: {
+                attribution_id_v2: `StoriesCreateRoot.react,comet.stories.create,unexpected,${Date.now()},545826,,;CometHomeRoot.react,comet.home,tap_tabbar,${Date.now()},661597,4748854339,,`
+              },
+              source: "WWW",
+              attachments: [{
+                photo: {
+                  id: photoID,
+                  overlays: []
+                }
+              }],
+              tracking: [null],
+              actor_id: ctx.userID,
+              client_mutation_id: String(Math.floor(Math.random() * 16) + 1)
+            }
+          }),
+          server_timestamps: true,
+          doc_id: "24226878183562473"
+        };
+
+        defaultFuncs
+          .post("https://www.facebook.com/api/graphql/", ctx.jar, form)
+          .then(utils.parseAndCheckLogin(ctx, defaultFuncs))
+          .then(function (resData) {
+            if (resData.error || !resData.data || !resData.data.story_create) {
+              throw resData || { error: "Story creation failed" };
+            }
+
+            // Extract story ID from response
+            let extractedStoryId = null;
+            const storyData = resData.data.story_create;
+            
+            try {
+              if (storyData.viewer && storyData.viewer.actor && storyData.viewer.actor.story_bucket) {
+                const storyNodes = storyData.viewer.actor.story_bucket.nodes;
+                if (storyNodes && storyNodes.length > 0 && storyNodes[0].first_story_to_show) {
+                  extractedStoryId = storyNodes[0].first_story_to_show.id;
+                }
+              }
+            } catch (e) {
+              log.warn("createStory", "Could not extract story ID from response:", e);
+            }
+
+            resolve({
+              story_id: extractedStoryId,
+              logging_token: storyData.logging_token,
+              full_response: resData
+            });
+          })
+          .catch(reject);
+      });
+    }
+
+    // Helper function to delete story
+    function deleteStory(storyID) {
+      return new Promise((resolve, reject) => {
+        const form = {
+          av: ctx.userID,
+          __aaid: 0,
+          __user: ctx.userID,
+          __a: 1,
+          __req: utils.getSignatureID(),
+          __hs: ctx.fb_dtsg_ag,
+          dpr: 1,
+          __ccg: "EXCELLENT",
+          __rev: ctx.req_ID,
+          __s: utils.getSignatureID(),
+          __hsi: ctx.hsi,
+          __comet_req: 15,
+          fb_dtsg: ctx.fb_dtsg,
+          jazoest: ctx.ttstamp,
+          lsd: ctx.fb_dtsg,
+          __spin_r: ctx.req_ID,
+          __spin_b: "trunk",
+          __spin_t: Date.now(),
+          fb_api_caller_class: "RelayModern",
+          fb_api_req_friendly_name: "StoriesDeleteCardOptionMenuItem_StoriesDeleteMutation",
+          variables: JSON.stringify({
+            input: {
+              story_ids: [storyID],
+              actor_id: ctx.userID,
+              client_mutation_id: String(Math.floor(Math.random() * 16) + 1)
+            },
+            enable_profile_story_consumption: false
+          }),
+          server_timestamps: true,
+          doc_id: "30236153679305121"
+        };
+
+        defaultFuncs
+          .post("https://www.facebook.com/api/graphql/", ctx.jar, form)
+          .then(utils.parseAndCheckLogin(ctx, defaultFuncs))
+          .then(function (resData) {
+            if (resData.error) {
+              throw resData;
+            }
+            
+            if (!resData.data || !resData.data.stories_delete) {
+              throw { error: "Delete response missing expected data" };
+            }
+
+            resolve({
+              deleted_story_ids: resData.data.stories_delete.deleted_story_thread_ids || [storyID],
+              success: true
+            });
+          })
+          .catch(reject);
+      });
+    }
+
+    // Helper function to check user stories
+    function checkUserStories() {
+      return new Promise((resolve, reject) => {
+        const form = {
+          av: ctx.userID,
+          __aaid: 0,
+          __user: ctx.userID,
+          __a: 1,
+          __req: utils.getSignatureID(),
+          __hs: ctx.fb_dtsg_ag,
+          dpr: 1,
+          __ccg: "EXCELLENT",
+          __rev: ctx.req_ID,
+          __s: utils.getSignatureID(),
+          __hsi: ctx.hsi,
+          __comet_req: 15,
+          fb_dtsg: ctx.fb_dtsg,
+          jazoest: ctx.ttstamp,
+          lsd: ctx.fb_dtsg,
+          __spin_r: ctx.req_ID,
+          __spin_b: "trunk",
+          __spin_t: Date.now(),
+          fb_api_caller_class: "RelayModern",
+          fb_api_req_friendly_name: "CometStoriesSuspenseViewerPaginationQuery",
+          variables: JSON.stringify({
+            count: 50,
+            scale: 1,
+            id: ctx.userID
+          }),
+          server_timestamps: true,
+          doc_id: "7723194127725452"
+        };
+
+        defaultFuncs
+          .post("https://www.facebook.com/api/graphql/", ctx.jar, form)
+          .then(utils.parseAndCheckLogin(ctx, defaultFuncs))
+          .then(function (resData) {
+            if (resData.error) {
+              throw resData;
+            }
+
+            let stories = [];
+            try {
+              if (resData.data && resData.data.node && resData.data.node.story_bucket) {
+                const storyBucket = resData.data.node.story_bucket;
+                if (storyBucket.unified_stories && storyBucket.unified_stories.edges) {
+                  stories = storyBucket.unified_stories.edges.map(edge => ({
+                    id: edge.node.id,
+                    creation_time: edge.node.creation_time,
+                    attachments: edge.node.attachments || [],
+                    bucket_id: storyBucket.id
+                  }));
+                }
+              }
+            } catch (e) {
+              log.warn("checkUserStories", "Error parsing stories:", e);
+            }
+
+            resolve(stories);
+          })
+          .catch(reject);
+      });
+    }
+
+    // Execute based on action
+    switch (action) {
+      case 'upload':
+        if (!attachment) {
+          return callback({ error: "Attachment is required for upload action" });
+        }
+        uploadStoryAttachment(attachment)
+          .then(photoID => {
+            callback(null, { success: true, photoID: photoID });
+          })
+          .catch(callback);
+        break;
+
+      case 'add':
+        if (!attachment) {
+          return callback({ error: "Attachment is required for add action" });
+        }
+        uploadStoryAttachment(attachment)
+          .then(photoID => {
+            return createStory(photoID).then(result => ({ photoID, result }));
+          })
+          .then(({ photoID, result }) => {
+            callback(null, {
+              success: true,
+              story_id: result.story_id,
+              logging_token: result.logging_token,
+              photoID: photoID,
+              full_response: result.full_response
+            });
+          })
+          .catch(err => {
+            log.error("storyManager add", err);
+            callback(err);
+          });
+        break;
+
+      case 'delete':
+        if (!storyID) {
+          return callback({ error: "Story ID is required for delete action" });
+        }
+        deleteStory(storyID)
+          .then(result => {
+            callback(null, {
+              success: true,
+              deleted_story_ids: result.deleted_story_ids
+            });
+          })
+          .catch(err => {
+            log.error("storyManager delete", err);
+            callback(err);
+          });
+        break;
+
+      case 'check':
+        checkUserStories()
+          .then(stories => {
+            callback(null, {
+              success: true,
+              stories: stories,
+              count: stories ? stories.length : 0
+            });
+          })
+          .catch(err => {
+            log.error("storyManager check", err);
+            callback(err);
+          });
+        break;
+
+      default:
+        callback({ error: "Invalid action" });
+    }
+
+    return returnPromise;
+  };
+};
+/** Developed by Sheikh Tamim | GitHub: sheikhtamimlover | Please give credits if reused. */