@cexy/hoonfca 1.0.0 → 1.0.1

package/src/apis/setThreadThemeMqtt.js

@@ -0,0 +1,94 @@
+'use strict';
+
+const utils = require('../utils');
+
+module.exports = function (defaultFuncs, api, ctx) {
+  return function setThreadThemeMqtt(threadID, themeFBID, callback) {
+    if (!ctx.mqttClient) {
+      throw new Error('Not connected to MQTT');
+    }
+
+    ctx.wsReqNumber += 1;
+    let baseTaskNumber = ++ctx.wsTaskNumber;
+
+    const makeTask = (label, queueName, extraPayload = {}) => ({
+      failure_count: null,
+      label: String(label),
+      payload: JSON.stringify({
+        thread_key: threadID,
+        theme_fbid: themeFBID,
+        sync_group: 1,
+        ...extraPayload,
+      }),
+      queue_name: typeof queueName === 'string' ? queueName : JSON.stringify(queueName),
+      task_id: baseTaskNumber++,
+    });
+
+    const messages = [
+      {
+        label: 1013,
+        queue: ['ai_generated_theme', String(threadID)],
+      },
+      {
+        label: 1037,
+        queue: ['msgr_custom_thread_theme', String(threadID)],
+      },
+      {
+        label: 1028,
+        queue: ['thread_theme_writer', String(threadID)],
+      },
+      {
+        label: 43,
+        queue: 'thread_theme',
+        extra: { source: null, payload: null },
+      },
+    ].map(({ label, queue, extra }) => {
+      ctx.wsReqNumber += 1;
+      return {
+        app_id: '772021112871879',
+        payload: JSON.stringify({
+          epoch_id: parseInt(utils.generateOfflineThreadingID()),
+          tasks: [makeTask(label, queue, extra)],
+          version_id: '24227364673632991',
+        }),
+        request_id: ctx.wsReqNumber,
+        type: 3,
+      };
+    });
+
+    // Return promise if no callback provided
+    if (!callback) {
+      return new Promise((resolve, reject) => {
+        try {
+          messages.forEach((msg, idx) => {
+            ctx.mqttClient.publish(
+              '/ls_req',
+              JSON.stringify(msg),
+              { qos: 1, retain: false },
+              idx === messages.length - 1 ? (err) => {
+                if (err) reject(err);
+                else resolve();
+              } : undefined
+            );
+          });
+        } catch (err) {
+          reject(err);
+        }
+      });
+    }
+
+    // Callback mode
+    try {
+      messages.forEach((msg, idx) => {
+        ctx.mqttClient.publish(
+          '/ls_req',
+          JSON.stringify(msg),
+          { qos: 1, retain: false },
+          idx === messages.length - 1 ? callback : undefined
+        );
+      });
+    } catch (err) {
+      callback(err);
+    }
+  };
+};

package/src/apis/share.js

@@ -0,0 +1,107 @@
+"use strict";
+
+const utils = require('../utils');
+
+function formatPreviewResult(data) {
+    if (data.errors) {
+        throw data.errors[0];
+    }
+    const previewData = data.data?.xma_preview_data;
+    if (!previewData) {
+        throw { error: "Could not generate a preview for this post." };
+    }
+    return {
+        postID: previewData.post_id,
+        header: previewData.header_title,
+        subtitle: previewData.subtitle_text,
+        title: previewData.title_text,
+        previewImage: previewData.preview_url,
+        favicon: previewData.favicon_url,
+        headerImage: previewData.header_image_url
+    };
+}
+
+module.exports = function(defaultFuncs, api, ctx) {
+    return async function getPostPreview(postID, callback) {
+        let resolveFunc, rejectFunc;
+        const returnPromise = new Promise((resolve, reject) => {
+            resolveFunc = resolve;
+            rejectFunc = reject;
+        });
+        
+        const cb = (err, data) => {
+            if (callback) callback(err, data);
+            if (err) return rejectFunc(err);
+            resolveFunc(data);
+        };
+        if (!postID) {
+            cb({ error: "A postID is required to generate a preview." });
+            return returnPromise;
+        }
+
+        const variables = {
+            shareable_id: postID.toString(),
+            scale: 3,
+        };
+
+        // Use configurable doc_id or default (may be outdated)
+        // To update: 
+        // 1. Open Facebook Messenger in browser
+        // 2. Open DevTools (F12) → Network tab → Filter by "graphql"
+        // 3. Trigger a share/preview action
+        // 4. Look for CometXMAProxyShareablePreviewQuery request
+        // 5. Copy the doc_id value from the request payload
+        // 6. Set ctx.options.sharePreviewDocId = 'NEW_DOC_ID' when logging in
+        //
+        // Known doc_ids (may expire):
+        // - 28939050904374351 (expired as of Nov 2024)
+        // - Check ws3-fca or @dongdev packages for potential updates
+        const docId = ctx.options?.sharePreviewDocId || '28939050904374351';
+
+        const form = {
+            fb_api_caller_class: 'RelayModern',
+            fb_api_req_friendly_name: 'CometXMAProxyShareablePreviewQuery',
+            variables: JSON.stringify(variables),
+            doc_id: docId
+        };
+
+        try {
+            const resData = await defaultFuncs
+                .post("https://www.facebook.com/api/graphql/", ctx.jar, form)
+                .then(utils.parseAndCheckLogin(ctx, defaultFuncs));
+            
+            // Check for persisted query not found error (case-insensitive)
+            if (resData?.errors) {
+                const persistedQueryError = resData.errors.find(e => {
+                    const msg = (e.message || '').toLowerCase();
+                    return msg.includes('persistedquerynotfound') || 
+                           msg.includes('document') && msg.includes('not found') ||
+                           msg.includes('persisted query');
+                });
+                if (persistedQueryError) {
+                    const error = {
+                        error: "Facebook GraphQL doc_id expired. Please update ctx.options.sharePreviewDocId",
+                        details: "Capture the current doc_id from Messenger web traffic (inspect CometXMAProxyShareablePreviewQuery request)",
+                        currentDocId: docId,
+                        fbError: persistedQueryError.message
+                    };
+                    utils.error("getPostPreview", error);
+                    cb(error);
+                    return returnPromise;
+                }
+            }
+            
+            const result = formatPreviewResult(resData);
+            cb(null, result);
+            return returnPromise;
+        } catch (err) {
+            // Add helpful context for common failure modes
+            if (err.message?.includes('UNHANDLED_REJECTION') || err.message?.includes('not found')) {
+                err.hint = "The GraphQL doc_id may be outdated. Set ctx.options.sharePreviewDocId with current value from Messenger traffic.";
+            }
+            utils.error("getPostPreview", err);
+            cb(err);
+            return returnPromise;
+        }
+    };
+};

package/src/apis/shareContact.js

@@ -0,0 +1,66 @@
+/* eslint-disable linebreak-style */
+"use strict";
+
+const utils = require('../utils');
+
+/**
+ * @module shareContact
+ * @param {Object} defaultFuncs - The default functions provided by the API.
+ * @param {Object} api - The full API object.
+ * @param {Object} ctx - The context object.
+ * @returns {function(text: string, senderID: string, threadID: string, callback: Function): void} - A function to share a contact.
+ */
+module.exports = function(defaultFuncs, api, ctx) {
+  /**
+   * Shares a user's contact information into a specific thread via MQTT.
+   * @param {string} [text] - An optional message to send along with the contact card.
+   * @param {string} senderID - The Facebook user ID of the contact you want to share.
+   * @param {string} threadID - The ID of the thread where the contact will be shared.
+   * @param {Function} [callback] - An optional callback function to be executed.
+   */
+  return function shareContact(text, senderID, threadID, callback) {
+    if (!ctx.mqttClient) {
+      throw new Error('Not connected to MQTT');
+    }
+
+    ctx.wsReqNumber ??= 0;
+    ctx.wsTaskNumber ??= 0;
+
+    ctx.wsReqNumber += 1;
+    ctx.wsTaskNumber += 1;
+
+    const queryPayload = {
+      contact_id: senderID,
+      sync_group: 1,
+      text: text || "",
+      thread_id: threadID
+    };
+
+    const query = {
+      failure_count: null,
+      label: '359',
+      payload: JSON.stringify(queryPayload),
+      queue_name: 'messenger_contact_sharing',
+      task_id: Math.random() * 1001 << 0,
+    };
+
+    const context = {
+      app_id: '2220391788200892',
+      payload: {
+        tasks: [query],
+        epoch_id: utils.generateOfflineThreadingID(),
+        version_id: '7214102258676893',
+      },
+      request_id: ctx.wsReqNumber,
+      type: 3,
+    };
+
+    context.payload = JSON.stringify(context.payload);
+
+    if (typeof callback === 'function') {
+      ctx.callback_Task[ctx.wsReqNumber] = { callback, type: "shareContact" };
+    }
+
+    ctx.mqttClient.publish('/ls_req', JSON.stringify(context), { qos: 1, retain: false });
+  };
+};

package/src/apis/stickers.js

@@ -0,0 +1,257 @@
+"use strict";
+
+/**
+ * Sticker API Module
+ * Provides access to Facebook's GraphQL-based sticker endpoints.
+ * Made by @ChoruOfficial
+ */
+
+const utils = require('../utils');
+/**
+ * Format the sticker pack list (store or tray)
+ * @param {object} data - Raw GraphQL response
+ * @returns {{ packs: Array<{id: string, name: string, thumbnail: string}>, page_info: object, store_id?: string }}
+ */
+function formatPackList(data) {
+    const trayPacks = data?.data?.picker_plugins?.sticker_picker?.sticker_store?.tray_packs?.edges;
+    const storePacks = data?.data?.viewer?.sticker_store?.available_packs?.edges;
+    
+    const packData = storePacks || trayPacks;
+    if (!packData || !packData.edges) return { packs: [], page_info: { has_next_page: false } };
+
+    const formattedPacks = packData.edges.map(edge => edge.node ? ({
+        id: edge.node.id,
+        name: edge.node.name,
+        thumbnail: edge.node.thumbnail_image?.uri
+    }) : null).filter(Boolean);
+
+    return {
+        packs: formattedPacks,
+        page_info: packData.page_info,
+        store_id: data?.data?.viewer?.sticker_store?.id
+    };
+}
+
+/**
+ * Format search result stickers
+ * @param {object} data - Raw GraphQL response
+ * @returns {Array<Object>}
+ */
+function formatStickerSearchResults(data) {
+    const stickers = data?.data?.sticker_search?.sticker_results?.edges;
+    if (!stickers) return [];
+    return stickers.map(edge => edge.node ? ({
+        type: "sticker",
+        ID: edge.node.id,
+        url: edge.node.image?.uri,
+        animatedUrl: edge.node.animated_image?.uri,
+        packID: edge.node.pack?.id,
+        label: edge.node.label || edge.node.accessibility_label,
+        stickerID: edge.node.id
+    }) : null).filter(Boolean);
+}
+
+/**
+ * Format sticker pack content
+ * @param {object} data - Raw GraphQL response
+ * @returns {Array<Object>}
+ */
+function formatStickerPackResults(data) {
+    const stickers = data?.data?.sticker_pack?.stickers?.edges;
+    if (!stickers) return [];
+    return stickers.map(edge => edge.node ? ({
+        type: "sticker",
+        ID: edge.node.id,
+        url: edge.node.image?.uri,
+        animatedUrl: edge.node.animated_image?.uri,
+        packID: edge.node.pack?.id,
+        label: edge.node.label || edge.node.accessibility_label,
+        stickerID: edge.node.id
+    }) : null).filter(Boolean);
+}
+
+/**
+ * Format AI-generated stickers
+ * @param {object} data - Raw GraphQL response
+ * @returns {Array<Object>}
+ */
+function formatAiStickers(data) {
+    const stickers = data?.data?.xfb_trending_generated_ai_stickers?.nodes;
+    if (!stickers) return [];
+    return stickers.map(node => ({
+        type: "sticker",
+        ID: node.id,
+        url: node.url,
+        label: node.label,
+        stickerID: node.id
+    })).filter(Boolean);
+}
+
+module.exports = function(defaultFuncs, api, ctx) {
+    /**
+     * Make a GraphQL request and handle login and error checking
+     * @param {object} form - Form data for the request
+     * @returns {Promise<object>}
+     */
+    async function makeRequest(form) {
+        const resData = await defaultFuncs.post("https://www.facebook.com/api/graphql/", ctx.jar, form)
+            .then(utils.parseAndCheckLogin(ctx, defaultFuncs));
+        if (!resData) throw new Error("GraphQL request returned no data.");
+        if (resData.errors) {
+            utils.error("StickerAPI GraphQL Error", resData.errors[0].message);
+            throw resData.errors[0];
+        }
+        return resData;
+    }
+
+    return {
+        /**
+         * Search for stickers by keyword
+         * @param {string} query - Search term
+         * @returns {Promise<Array<Object>>}
+         */
+        search: async function(query) {
+            const form = {
+                fb_api_caller_class: 'RelayModern',
+                fb_api_req_friendly_name: 'CometStickerPickerSearchResultsRootQuery',
+                variables: JSON.stringify({
+                    scale: 3,
+                    search_query: query,
+                    sticker_height: 128,
+                    sticker_width: 128,
+                    stickerInterface: "MESSAGES"
+                }),
+                doc_id: '24004987559125954'
+            };
+            const res = await makeRequest(form);
+            return formatStickerSearchResults(res);
+        },
+
+        /**
+         * List user's sticker packs
+         * @returns {Promise<Array<Object>>}
+         */
+        listPacks: async function() {
+            const form = {
+                fb_api_caller_class: 'RelayModern',
+                fb_api_req_friendly_name: 'CometStickerPickerCardQuery',
+                variables: JSON.stringify({ scale: 3, stickerInterface: "MESSAGES" }),
+                doc_id: '10095807770482952'
+            };
+            const res = await makeRequest(form);
+            return formatPackList(res).packs;
+        },
+
+        /**
+         * Get all available sticker packs from the store (with pagination)
+         * @returns {Promise<Array<Object>>}
+         */
+        getStorePacks: async function() {
+            utils.log("Starting to fetch all sticker packs from store...");
+            let allPacks = [];
+
+            const initialForm = {
+                fb_api_caller_class: 'RelayModern',
+                fb_api_req_friendly_name: 'CometStickersStoreDialogQuery',
+                variables: JSON.stringify({}),
+                doc_id: '29237828849196584'
+            };
+            let res = await makeRequest(initialForm);
+            let { packs, page_info, store_id } = formatPackList(res);
+            allPacks.push(...packs);
+            utils.log(`Fetched first page with ${packs.length} packs.`);
+
+            while (page_info && page_info.has_next_page) {
+                utils.log("Fetching next page with cursor:", page_info.end_cursor);
+
+                const paginatedForm = {
+                    fb_api_caller_class: 'RelayModern',
+                    fb_api_req_friendly_name: 'CometStickersStorePackListPaginationQuery',
+                    variables: JSON.stringify({
+                        count: 20,
+                        cursor: page_info.end_cursor,
+                        id: store_id
+                    }),
+                    doc_id: '9898634630218439'
+                };
+                res = await makeRequest(paginatedForm);
+                let paginatedResult = formatPackList(res);
+                allPacks.push(...paginatedResult.packs);
+                page_info = paginatedResult.page_info;
+                utils.log(`Fetched ${paginatedResult.packs.length} more packs. Total now: ${allPacks.length}`);
+            }
+
+            utils.log(`Finished fetching. Total unique packs found: ${allPacks.length}`);
+            return allPacks;
+        },
+
+        /**
+         * Merge user's and store sticker packs into one list
+         * @returns {Promise<Array<Object>>}
+         */
+        listAllPacks: async function() {
+            const [myPacks, storePacks] = await Promise.all([
+                this.listPacks(),
+                this.getStorePacks()
+            ]);
+            const allPacksMap = new Map();
+            myPacks.forEach(pack => allPacksMap.set(pack.id, pack));
+            storePacks.forEach(pack => allPacksMap.set(pack.id, pack));
+            return Array.from(allPacksMap.values());
+        },
+
+        /**
+         * Add a sticker pack by ID
+         * @param {string} packID - The ID of the sticker pack
+         * @returns {Promise<Object>}
+         */
+        addPack: async function(packID) {
+            const form = {
+                fb_api_caller_class: 'RelayModern',
+                fb_api_req_friendly_name: 'CometStickersStorePackMutationAddMutation',
+                variables: JSON.stringify({
+                    input: {
+                        pack_id: packID,
+                        actor_id: ctx.userID,
+                        client_mutation_id: Math.round(Math.random() * 10).toString()
+                    }
+                }),
+                doc_id: '9877489362345320'
+            };
+            const res = await makeRequest(form);
+            return res.data.sticker_pack_add.sticker_pack;
+        },
+
+        /**
+         * Get all stickers in a pack
+         * @param {string} packID - Sticker pack ID
+         * @returns {Promise<Array<Object>>}
+         */
+        getStickersInPack: async function(packID) {
+            const form = {
+                fb_api_caller_class: 'RelayModern',
+                fb_api_req_friendly_name: 'CometStickerPickerPackContentRootQuery',
+                variables: JSON.stringify({ packID, stickerWidth: 128, stickerHeight: 128, scale: 3 }),
+                doc_id: '23982341384707469'
+            };
+            const res = await makeRequest(form);
+            return formatStickerPackResults(res);
+        },
+
+        /**
+         * Get trending AI-generated stickers
+         * @param {{ limit?: number }} options - Options object
+         * @returns {Promise<Array<Object>>}
+         */
+        getAiStickers: async function({ limit = 10 } = {}) {
+            const form = {
+                fb_api_caller_class: 'RelayModern',
+                fb_api_req_friendly_name: 'CometStickerPickerStickerGeneratedCardQuery',
+                variables: JSON.stringify({ limit }),
+                doc_id: '24151467751156443'
+            };
+            const res = await makeRequest(form);
+            return formatAiStickers(res);
+        }
+    };
+};