stfca 1.0.10 → 1.0.11

package/package.json

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

package/src/metaTheme.js

@@ -0,0 +1,190 @@
+/**
+ * ===========================================================
+ * 💫 META THEME GENERATOR MODULE 💫
+ * ===========================================================
+ * 🧑‍💻 Author: Sheikh Tamim (ST | Sheikh Tamim)
+ * 🔰 Owner & Developer
+ * 🌐 GitHub: https://github.com/sheikhtamimlover
+ * 📸 Instagram: https://instagram.com/sheikh.tamim_lover
+ * 🧠 Description:
+ *   This module generates beautiful Messenger AI themes 
+ *   using Meta's hidden GraphQL endpoints. It allows you to 
+ *   create unique chat themes based on your custom prompt 
+ *   or optional image inspiration.
+ * -----------------------------------------------------------
+ * ⚙️ Features:
+ *   • Generate AI-based Messenger chat themes.
+ *   • Custom prompt & optional image URL input.
+ *   • Returns structured theme data with full color mapping.
+ * -----------------------------------------------------------
+ * 🕊️ Respect the creator & give proper credits if reused.
+ * ===========================================================
+ */
+
+"use strict";
+
+const utils = require("../utils");
+const log = require("npmlog");
+/** © Sheikh Tamim - Please give proper credits if you copy or reuse this code. */
+module.exports = function (defaultFuncs, api, ctx) {
+    return function metaTheme(prompt, options, callback) {
+        var resolveFunc = function () { };
+        var rejectFunc = function () { };
+        var returnPromise = new Promise(function (resolve, reject) {
+            resolveFunc = resolve;
+            rejectFunc = reject;
+        });
+
+        // Handle optional parameters
+        if (typeof options === 'function') {
+            callback = options;
+            options = {};
+        }
+        
+        if (!callback) {
+            callback = function (err, data) {
+                if (err) return rejectFunc(err);
+                resolveFunc(data);
+            };
+        }
+
+        if (!prompt || typeof prompt !== 'string') {
+            return callback({ error: "Prompt is required and must be a string" });
+        }
+
+        // Parse options
+        const numThemes = options.numThemes || 1;
+        const imageUrl = options.imageUrl || null;
+
+        const inputData = {
+            client_mutation_id: Math.floor(Math.random() * 10).toString(),
+            actor_id: ctx.userID,
+            bypass_cache: true,
+            caller: "MESSENGER",
+            num_themes: Math.min(numThemes, 5), // Limit to max 5 themes
+            prompt: prompt
+        };
+
+        // Add image URL if provided
+        if (imageUrl) {
+            inputData.image_url = imageUrl;
+        }
+
+        const form = {
+            av: ctx.userID,
+            __aaid: 0,
+            __user: ctx.userID,
+            __a: 1,
+            __req: utils.getSignatureID(),
+            __hs: "20358.HYP:comet_pkg.2.1...0",
+            dpr: 1,
+            __ccg: "EXCELLENT",
+            __rev: "1027673511",
+            __s: utils.getSignatureID(),
+            __hsi: "7554561631547849479",
+            __comet_req: 15,
+            fb_dtsg: ctx.fb_dtsg,
+            jazoest: ctx.ttstamp,
+            lsd: ctx.fb_dtsg,
+            __spin_r: "1027673511",
+            __spin_b: "trunk",
+            __spin_t: Date.now(),
+            __crn: "comet.fbweb.MWInboxHomeRoute",
+            qpl_active_flow_ids: "25309433,521485406",
+            fb_api_caller_class: "RelayModern",
+            fb_api_req_friendly_name: "useGenerateAIThemeMutation",
+            variables: JSON.stringify({ input: inputData }),
+            server_timestamps: true,
+            doc_id: "23873748445608673",
+            fb_api_analytics_tags: JSON.stringify(["qpl_active_flow_ids=25309433,521485406"])
+        };
+
+        defaultFuncs
+            .post("https://www.facebook.com/api/graphql/", ctx.jar, form)
+            .then(utils.parseAndCheckLogin(ctx, defaultFuncs))
+            .then(function (resData) {
+                if (resData.errors) {
+                    throw resData.errors;
+                }
+                
+                if (resData.data && resData.data.xfb_generate_ai_themes_from_prompt) {
+                    const themeData = resData.data.xfb_generate_ai_themes_from_prompt;
+                    if (themeData.success && themeData.themes && themeData.themes.length > 0) {
+                        const themes = themeData.themes.map((theme, index) => ({
+                            success: true,
+                            themeId: theme.id,
+                            name: theme.accessibility_label,
+                            description: theme.description,
+                            serialNumber: index + 1,
+                            colors: {
+                                composerBackground: theme.composer_background_color,
+                                backgroundGradient: theme.background_gradient_colors,
+                                titleBarButton: theme.title_bar_button_tint_color,
+                                inboundMessageGradient: theme.inbound_message_gradient_colors,
+                                titleBarText: theme.title_bar_text_color,
+                                composerTint: theme.composer_tint_color,
+                                messageText: theme.message_text_color,
+                                primaryButton: theme.primary_button_background_color,
+                                titleBarBackground: theme.title_bar_background_color,
+                                fallback: theme.fallback_color,
+                                gradient: theme.gradient_colors
+                            },
+                            backgroundImage: theme.background_asset ? theme.background_asset.image.uri : null,
+                            iconImage: theme.icon_asset ? theme.icon_asset.image.uri : null,
+                            images: {
+                                background: theme.background_asset ? theme.background_asset.image.uri : null,
+                                icon: theme.icon_asset ? theme.icon_asset.image.uri : null
+                            },
+                            alternativeThemes: theme.alternative_themes ? theme.alternative_themes.map(alt => ({
+                                id: alt.id,
+                                name: alt.accessibility_label,
+                                backgroundImage: alt.background_asset ? alt.background_asset.image.uri : null,
+                                iconImage: alt.icon_asset ? alt.icon_asset.image.uri : null
+                            })) : []
+                        }));
+
+                        const result = {
+                            success: true,
+                            count: themes.length,
+                            themes: themes,
+                            // For backward compatibility, include first theme data at root level
+                            ...themes[0]
+                        };
+                        return callback(null, result);
+                    } else {
+                        throw new Error("No themes generated for the given prompt");
+                    }
+                } else {
+                    throw new Error("Invalid response from AI theme generation");
+                }
+            })
+            .catch(function (err) {
+                log.error("metaTheme", err);
+                
+                // Check for specific error conditions
+                let errorMessage = "An error occurred while generating themes";
+                
+                if (err.message && err.message.includes("not authorized")) {
+                    errorMessage = "Your account is not authorized to generate AI themes. This feature may not be available for your account type.";
+                } else if (err.message && err.message.includes("rate limit")) {
+                    errorMessage = "Rate limit exceeded. Please wait a moment before trying again.";
+                } else if (err.message && err.message.includes("Invalid")) {
+                    errorMessage = "Invalid request parameters. Please check your input.";
+                } else if (err.statusCode === 403) {
+                    errorMessage = "Access denied. Your account may not support Meta AI theme generation.";
+                } else if (err.statusCode === 429) {
+                    errorMessage = "Too many requests. Please wait before trying again.";
+                }
+                
+                return callback({ 
+                    error: errorMessage,
+                    originalError: err.message || err,
+                    statusCode: err.statusCode || null
+                });
+            });
+
+        return returnPromise;
+    };
+};
+
+/** © Sheikh Tamim - Please give proper credits if you copy or reuse this code. */

package/src/setThreadTheme.js

@@ -0,0 +1,276 @@
+/**
+ * ===========================================================
+ * 🧑‍💻 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 setThreadTheme(threadID, themeData, 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 (!threadID) {
+            return callback({ error: "threadID is required" });
+        }
+
+        async function updateThreadTheme() {
+            try {
+                const timestamp = Date.now();
+                
+                // Step 1: Load theme bootloader modules
+                const moduleParams = new URLSearchParams({
+                    modules: "LSUpdateThreadTheme,LSUpdateThreadCustomEmoji,LSUpdateThreadThemePayloadCacheKey",
+                    __aaid: 0,
+                    __user: ctx.userID,
+                    __a: 1,
+                    __req: utils.getSignatureID(),
+                    __hs: "20352.HYP:comet_pkg.2.1...0",
+                    dpr: 1,
+                    __ccg: "EXCELLENT",
+                    __rev: "1027396270",
+                    __s: utils.getSignatureID(),
+                    __hsi: "7552524636527201016",
+                    __comet_req: 15,
+                    fb_dtsg_ag: ctx.fb_dtsg,
+                    jazoest: ctx.ttstamp,
+                    __spin_r: "1027396270",
+                    __spin_b: "trunk",
+                    __spin_t: timestamp,
+                    __crn: "comet.fbweb.MWInboxHomeRoute"
+                });
+
+                await defaultFuncs
+                    .get("https://www.facebook.com/ajax/bootloader-endpoint/?" + moduleParams.toString(), ctx.jar)
+                    .then(utils.parseAndCheckLogin(ctx, defaultFuncs));
+
+                // Step 2: Get available themes first
+                let availableThemes = [];
+                try {
+                    const themeForm = {
+                        av: ctx.userID,
+                        __aaid: 0,
+                        __user: ctx.userID,
+                        __a: 1,
+                        __req: utils.getSignatureID(),
+                        __hs: "20352.HYP:comet_pkg.2.1...0",
+                        dpr: 1,
+                        __ccg: "EXCELLENT",
+                        __rev: "1027396270",
+                        __s: utils.getSignatureID(),
+                        __hsi: "7552524636527201016",
+                        __comet_req: 15,
+                        fb_dtsg: ctx.fb_dtsg,
+                        jazoest: ctx.ttstamp,
+                        lsd: ctx.fb_dtsg,
+                        __spin_r: "1027396270",
+                        __spin_b: "trunk",
+                        __spin_t: timestamp,
+                        __crn: "comet.fbweb.MWInboxHomeRoute",
+                        qpl_active_flow_ids: "25308101",
+                        fb_api_caller_class: "RelayModern",
+                        fb_api_req_friendly_name: "MWPThreadThemeQuery_AllThemesQuery",
+                        variables: JSON.stringify({
+                            "version": "default"
+                        }),
+                        server_timestamps: true,
+                        doc_id: "24474714052117636"
+                    };
+
+                    const themeResult = await defaultFuncs
+                        .post("https://www.facebook.com/api/graphql/", ctx.jar, themeForm)
+                        .then(utils.parseAndCheckLogin(ctx, defaultFuncs));
+
+                    if (themeResult && themeResult.data && themeResult.data.messenger_thread_themes) {
+                        availableThemes = themeResult.data.messenger_thread_themes;
+                    }
+                } catch (e) {
+                    log.warn("setThreadTheme", "Could not fetch available themes, proceeding with theme update");
+                }
+
+                // Step 3: Determine theme ID based on input
+                let themeId = null;
+                let customEmoji = "👍";
+                
+                if (typeof themeData === "string") {
+                    // If it's a string, try to find matching theme
+                    if (themeData.match(/^[0-9]+$/)) {
+                        // Numeric theme ID
+                        themeId = themeData;
+                    } else {
+                        // Search by theme name/description
+                        const foundTheme = availableThemes.find(theme => 
+                            theme.accessibility_label && 
+                            theme.accessibility_label.toLowerCase().includes(themeData.toLowerCase())
+                        );
+                        if (foundTheme) {
+                            themeId = foundTheme.id;
+                        } else {
+                            // Fallback color mapping
+                            const colorMap = {
+                                blue: "196241301102133",
+                                purple: "370940413392601", 
+                                green: "169463077092846",
+                                pink: "230032715012014",
+                                orange: "175615189761153",
+                                red: "2136751179887052",
+                                yellow: "2058653964378557",
+                                teal: "417639218648241",
+                                black: "539927563794799",
+                                white: "2873642392710980",
+                                default: "196241301102133"
+                            };
+                            themeId = colorMap[themeData.toLowerCase()] || colorMap.default;
+                        }
+                    }
+                } else if (typeof themeData === "object" && themeData !== null) {
+                    themeId = themeData.themeId || themeData.theme_id || themeData.id;
+                    customEmoji = themeData.emoji || themeData.customEmoji || "👍";
+                }
+
+                if (!themeId) {
+                    themeId = "196241301102133"; // Default blue theme
+                }
+
+                // Step 4: Use direct bootloader approach for theme update
+                try {
+                    // First try with the legacy changeThreadColor approach
+                    const legacyForm = {
+                        dpr: 1,
+                        queries: JSON.stringify({
+                            o0: {
+                                doc_id: "1727493033983591",
+                                query_params: {
+                                    data: {
+                                        actor_id: ctx.userID,
+                                        client_mutation_id: "0",
+                                        source: "SETTINGS",
+                                        theme_id: themeId,
+                                        thread_id: threadID,
+                                    },
+                                },
+                            },
+                        }),
+                    };
+
+                    const legacyResult = await defaultFuncs
+                        .post("https://www.facebook.com/api/graphqlbatch/", ctx.jar, legacyForm)
+                        .then(utils.parseAndCheckLogin(ctx, defaultFuncs));
+
+                    if (legacyResult && !legacyResult[0]?.o0?.errors) {
+                        return callback(null, {
+                            threadID: threadID,
+                            themeId: themeId,
+                            customEmoji: customEmoji,
+                            timestamp: timestamp,
+                            success: true,
+                            method: "legacy",
+                            availableThemes: availableThemes.length > 0 ? availableThemes.map(t => ({
+                                id: t.id,
+                                name: t.accessibility_label,
+                                description: t.description
+                            })) : null
+                        });
+                    }
+                } catch (legacyErr) {
+                    log.warn("setThreadTheme", "Legacy method failed, trying alternative approach");
+                }
+
+                // Step 5: Try alternative GraphQL mutation with updated doc_id
+                const alternativeForm = {
+                    av: ctx.userID,
+                    __aaid: 0,
+                    __user: ctx.userID,
+                    __a: 1,
+                    __req: utils.getSignatureID(),
+                    __hs: "20352.HYP:comet_pkg.2.1...0",
+                    dpr: 1,
+                    __ccg: "EXCELLENT",
+                    __rev: "1027396270",
+                    __s: utils.getSignatureID(),
+                    __hsi: "7552524636527201016",
+                    __comet_req: 15,
+                    fb_dtsg: ctx.fb_dtsg,
+                    jazoest: ctx.ttstamp,
+                    lsd: ctx.fb_dtsg,
+                    __spin_r: "1027396270",
+                    __spin_b: "trunk",
+                    __spin_t: timestamp,
+                    __crn: "comet.fbweb.MWInboxHomeRoute",
+                    fb_api_caller_class: "RelayModern",
+                    fb_api_req_friendly_name: "MessengerThreadThemeUpdateMutation",
+                    variables: JSON.stringify({
+                        "input": {
+                            "actor_id": ctx.userID,
+                            "client_mutation_id": Math.floor(Math.random() * 10000).toString(),
+                            "source": "SETTINGS",
+                            "thread_id": threadID.toString(),
+                            "theme_id": themeId.toString(),
+                            "custom_emoji": customEmoji
+                        }
+                    }),
+                    server_timestamps: true,
+                    doc_id: "9734829906576883" // Updated doc_id based on working API
+                };
+
+                const result = await defaultFuncs
+                    .post("https://www.facebook.com/api/graphql/", ctx.jar, alternativeForm)
+                    .then(utils.parseAndCheckLogin(ctx, defaultFuncs));
+
+                if (result && result.errors && result.errors.length > 0) {
+                    throw new Error("GraphQL Error: " + JSON.stringify(result.errors));
+                }
+
+                // Check if the mutation was successful
+                if (result && result.data && result.data.messenger_thread_theme_update) {
+                    const updateResult = result.data.messenger_thread_theme_update;
+                    if (updateResult.errors && updateResult.errors.length > 0) {
+                        throw new Error("Theme Update Error: " + JSON.stringify(updateResult.errors));
+                    }
+                }
+
+                return callback(null, {
+                    threadID: threadID,
+                    themeId: themeId,
+                    customEmoji: customEmoji,
+                    timestamp: timestamp,
+                    success: true,
+                    method: "graphql",
+                    availableThemes: availableThemes.length > 0 ? availableThemes.map(t => ({
+                        id: t.id,
+                        name: t.accessibility_label,
+                        description: t.description
+                    })) : null
+                });
+
+            } catch (err) {
+                log.error("setThreadTheme", err);
+                return callback(err);
+            }
+        }
+
+        updateThreadTheme();
+        return returnPromise;
+    };
+};
+/** Developed by Sheikh Tamim | GitHub: sheikhtamimlover | Please give credits if reused. */