bb-fca 2.0.7 → 2.0.9

package/src/core/models/loginHelper.ts

@@ -1,8 +1,8 @@
-import utils = require('../../utils');
 import axios from 'axios';
 import * as fs from 'fs';
 import * as path from 'path';
 import * as qs from 'querystring';
+import { getJar, getAppState, get, saveCookies, log, error } from '../../utils';
 
 /**
  * The main login helper function, orchestrating the login process.
@@ -31,14 +31,27 @@ async function loginHelper(
   let defaultFuncs: any = null;
   let api: any = initialApi;
 
+  /**
+   * Sets an array of "name=value" cookie strings into the CookieJar
+   * for the facebook.com domain.
+   */
+  function setCookiesIntoJar(jar: any, cookieStrings: string[]): void {
+    const domain = '.facebook.com';
+    const expires = new Date().getTime() + 1000 * 60 * 60 * 24 * 365;
+    cookieStrings.forEach((cookieString) => {
+      const str = `${cookieString}; expires=${expires}; domain=${domain}; path=/;`;
+      jar.setCookie(str, `https://${domain}`);
+    });
+  }
+
   try {
-    const jar = utils.getJar();
-    utils.log('Logging in...');
+    const jar = getJar();
+    log('Logging in...');
 
     const appState = credentials.appState;
 
     if (appState) {
-      let cookieStrings = [];
+      let cookieStrings: string[] = [];
       if (Array.isArray(appState)) {
         cookieStrings = appState.map((c) =>
           [c.name || c.key, c.value].join('='),
@@ -54,12 +67,7 @@ async function loginHelper(
         );
       }
 
-      cookieStrings.forEach((cookieString) => {
-        const domain = '.facebook.com';
-        const expires = new Date().getTime() + 1000 * 60 * 60 * 24 * 365;
-        const str = `${cookieString}; expires=${expires}; domain=${domain}; path=/;`;
-        jar.setCookie(str, `https://${domain}`);
-      });
+      setCookiesIntoJar(jar, cookieStrings);
     } else if (credentials.email && credentials.password) {
       // Rui
       const url = 'https://api.facebook.com/method/auth.login';
@@ -80,15 +88,10 @@ async function loginHelper(
         if (resp.status !== 200) {
           throw new Error('Wrong password / email');
         }
-        let cstrs = resp.data['session_cookies'].map(
-          (c) => `${c.name}=${c.value}`,
+        const cstrs: string[] = resp.data['session_cookies'].map(
+          (c: any) => `${c.name}=${c.value}`,
         );
-        cstrs.forEach((cstr) => {
-          const domain = '.facebook.com';
-          const expires = new Date().getTime() + 1000 * 60 * 60 * 24 * 365;
-          const str = `${cstr}; expires=${expires}; domain=${domain}; path=/;`;
-          jar.setCookie(str, `https://${domain}`);
-        });
+        setCookiesIntoJar(jar, cstrs);
       } catch (e) {
         throw new Error('Wrong password / email');
       }
@@ -102,20 +105,19 @@ async function loginHelper(
       api = {
         setOptions: setOptionsFunc.bind(null, globalOptions),
         getAppState() {
-          const appState = utils.getAppState(jar);
-          if (!Array.isArray(appState)) return [];
-          const uniqueAppState = appState.filter(
+          const state = getAppState(jar);
+          if (!Array.isArray(state)) return [];
+          const uniqueState = state.filter(
             (item, index, self) =>
               self.findIndex((t) => t.key === item.key) === index,
           );
-          return uniqueAppState.length > 0 ? uniqueAppState : appState;
+          return uniqueState.length > 0 ? uniqueState : state;
         },
       };
     }
 
-    const resp = await utils
-      .get(fbLinkFunc(), jar, null, globalOptions, { noRef: true })
-      .then(utils.saveCookies(jar));
+    const resp = await get(fbLinkFunc(), jar, null, globalOptions, { noRef: true })
+      .then(saveCookies(jar));
     const extractNetData = (html) => {
       const allScriptsData = [];
       const scriptRegex = /<script type="application\/json"[^>]*>(.*?)<\/script>/g;
@@ -124,7 +126,7 @@ async function loginHelper(
         try {
           allScriptsData.push(JSON.parse(match[1]));
         } catch (e) {
-          utils.error(`Failed to parse a JSON blob from HTML`, e.message);
+          error(`Failed to parse a JSON blob from HTML`, (e as any).message);
         }
       }
       return allScriptsData;
@@ -173,7 +175,7 @@ async function loginHelper(
                 ? require(fullPath).default(defaultFuncs, api, ctx)
                 : require(fullPath)(defaultFuncs, api, ctx);
             } catch (e) {
-              utils.error(
+              error(
                 `Failed to load module ${moduleName} from ${folder}:`,
                 e,
               );
@@ -217,9 +219,9 @@ async function loginHelper(
     api.globalOptions = globalOptions;
 
     return callback(null, api);
-  } catch (error) {
-    utils.error('loginHelper', error.error || error);
-    return callback(error);
+  } catch (err: any) {
+    error('loginHelper', err.error || err);
+    return callback(err);
   }
 }
 

package/src/deltas/apis/create.ts

@@ -49,5 +49,15 @@ export default function(defaultFuncs: any, api: any, ctx: any) {
      * @returns {Promise<object>} Upload result with videoID.
      */
     uploadVideo: postModule.uploadVideo,
+
+    /**
+     * Reacts to a Facebook post (like, love, haha, wow, sad, angry, care).
+     * @param {string} feedbackId - Numeric post ID, "feedbackback:<id>", or base64 feedback ID.
+     * @param {string} [reaction="LIKE"] - "LIKE" | "LOVE" | "HAHA" | "WOW" | "SAD" | "ANGRY" | "CARE"
+     *   or emoji: "👍" | "❤️" | "😂" | "😮" | "😢" | "😡" | "🤗"
+     * @param {Function} [callback] - Optional callback function.
+     * @returns {Promise<object>} The server response.
+     */
+    reactPost: postModule.react,
   };
 }

package/src/deltas/apis/posting/group.ts

@@ -5,7 +5,7 @@ import utils = require('../../../utils');
  * @description A module for joining, leaving, and listing Facebook groups.
  * @license Ex-it
  */
-export default function(defaultFuncs: any, api: any, ctx: any) {
+export default function (defaultFuncs: any, api: any, ctx: any) {
   /**
    * Deep-searches an object/array tree for the first value matching a predicate.
    */
@@ -163,7 +163,9 @@ export default function(defaultFuncs: any, api: any, ctx: any) {
   /**
    * Builds the GraphQL POST form for groups pagination.
    */
-  function buildGroupsGraphQLForm(variables: object): Record<string, string> {
+  function buildGroupsGraphQLForm(
+    variables: object,
+  ): Record<string, string> {
     return {
       av: ctx.userID,
       __user: ctx.userID,
@@ -172,7 +174,8 @@ export default function(defaultFuncs: any, api: any, ctx: any) {
       jazoest: ctx.jazoest,
       lsd: ctx.lsd,
       fb_api_caller_class: 'RelayModern',
-      fb_api_req_friendly_name: 'GroupsCometJoinedGroupsListPaginationQuery',
+      fb_api_req_friendly_name:
+        'GroupsCometJoinedGroupsListPaginationQuery',
       variables: JSON.stringify(variables),
       server_timestamps: 'true',
       doc_id: '8957838874246460',
@@ -273,83 +276,46 @@ export default function(defaultFuncs: any, api: any, ctx: any) {
      * @returns {Promise<Object>} A promise that resolves to the API response data on success.
      * @throws {Error} If the groupID is missing or the API request fails.
      */
-    join: async function(groupID: string, inviteShortLinkKey?: string | null) {
+    join: async function (groupID: string) {
       if (!groupID) throw new Error('groupID is required.');
 
-      const actorId = ctx.i_userID || ctx.userID;
-
       const variables = {
-        feedType: 'DISCUSSION',
-        groupID: groupID,
         input: {
-          action_source: 'GROUP_MALL',
+          group_id: groupID,
+          group_share_tracking_params: null,
+          join_action_source: 'GROUP_HEADER',
           attribution_id_v2:
-            'CometGroupDiscussionRoot.react,comet.group,via_cold_start,' +
+            'GroupsCometGroupHeaderActionButton.react,comet.group,via_cold_start,' +
             Date.now() +
-            ',874165,2361831622,,',
-          group_id: groupID,
-          group_share_tracking_params: {
-            app_id: '2220391788200892',
-            exp_id: 'null',
-            is_from_share: false,
-          },
-          actor_id: actorId,
-          client_mutation_id: '1',
+            ',,,',
+          actor_id: ctx.userID,
+          client_mutation_id: Math.floor(Math.random() * 10 + 1).toString(),
         },
-        inviteShortLinkKey: inviteShortLinkKey ?? null,
-        isChainingRecommendationUnit: false,
         scale: 1,
-        source: 'GROUP_MALL',
-        renderLocation: 'group_mall',
-        __relay_internal__pv__groups_comet_use_glvrelayprovider: false,
-        __relay_internal__pv__GroupsCometGYSJUnifiedUnitCardImageHeightrelayprovider: 150,
-        __relay_internal__pv__GroupsCometGroupChatLazyLoadLastMessageSnippetrelayprovider: false,
       };
 
       const form = {
-        av: actorId,
-        __aaid: '0',
-        __user: actorId,
+        av: ctx.userID,
+        __user: ctx.userID,
         __a: '1',
-        __req: '18',
-        __hs: '20530.HCSV2:comet_pkg.2.1...0',
-        dpr: '1',
-        __ccg: 'GOOD',
-        __comet_req: '15',
         fb_dtsg: ctx.fb_dtsg,
         jazoest: ctx.jazoest,
         lsd: ctx.lsd,
-        __spin_r: '1035418183',
-        __spin_b: 'trunk',
-        __spin_t: Math.floor(Date.now() / 1000).toString(),
-        __crn: 'comet.fbweb.CometGroupDiscussionRoute',
         fb_api_caller_class: 'RelayModern',
-        fb_api_req_friendly_name: 'GroupCometJoinForumMutation',
+        fb_api_req_friendly_name: 'GroupCometJoinMutation',
         variables: JSON.stringify(variables),
-        server_timestamps: 'true',
-        doc_id: '26180016991684264',
-      };
-
-      const customHeader = {
-        'x-fb-friendly-name': 'GroupCometJoinForumMutation',
-        'x-fb-lsd': ctx.lsd || '',
-        'x-asbd-id': '359341',
-        origin: 'https://www.facebook.com',
-        referer: `https://www.facebook.com/groups/${groupID}`,
+        doc_id: '6192959194068498',
       };
 
-      const res = await utils.post(
+      const res = await defaultFuncs.post(
         'https://www.facebook.com/api/graphql/',
         ctx.jar,
         form,
-        ctx.globalOptions,
-        ctx,
-        customHeader,
+        {},
       );
 
-      const data = parseResponseBody(res.body);
-      if (data?.errors) throw new Error(JSON.stringify(data.errors));
-      return data?.data ?? data;
+      if (res.data?.errors) throw new Error(JSON.stringify(res.data.errors));
+      return res.data?.data ?? res.data;
     },
 
     /**
@@ -359,151 +325,45 @@ export default function(defaultFuncs: any, api: any, ctx: any) {
      * @returns {Promise<Object>} A promise that resolves to the API response data on success.
      * @throws {Error} If the groupID is missing or the API request fails.
      */
-    leave: async function(groupID: string) {
+    leave: async function (groupID: string) {
       if (!groupID) throw new Error('groupID is required.');
 
-      const actorId = ctx.i_userID || ctx.userID;
-
       const variables = {
         input: {
-          attribution_id_v2:
-            'CometGroupDiscussionRoot.react,comet.group,via_cold_start,' +
-            Date.now() +
-            ',243486,2361831622,,',
           group_id: groupID,
-          actor_id: actorId,
-          client_mutation_id: '1',
-        },
-        inviteShortLinkKey: null,
-        isChainingRecommendationUnit: false,
-        ordering: ['viewer_added'],
-        scale: 1,
-        groupID: groupID,
-        __relay_internal__pv__GroupsCometGYSJUnifiedUnitCardImageHeightrelayprovider: 150,
-        __relay_internal__pv__GroupsCometGroupChatLazyLoadLastMessageSnippetrelayprovider: false,
-      };
-
-      const form = {
-        av: actorId,
-        __aaid: '0',
-        __user: actorId,
-        __a: '1',
-        __req: '1f',
-        __hs: '20530.HCSV2:comet_pkg.2.1...0',
-        dpr: '1',
-        __ccg: 'EXCELLENT',
-        __comet_req: '15',
-        fb_dtsg: ctx.fb_dtsg,
-        jazoest: ctx.jazoest,
-        lsd: ctx.lsd,
-        __spin_r: '1035418183',
-        __spin_b: 'trunk',
-        __spin_t: Math.floor(Date.now() / 1000).toString(),
-        __crn: 'comet.fbweb.CometGroupDiscussionRoute',
-        fb_api_caller_class: 'RelayModern',
-        fb_api_req_friendly_name: 'GroupCometLeaveForumMutation',
-        variables: JSON.stringify(variables),
-        server_timestamps: 'true',
-        doc_id: '26077711195170900',
-      };
-
-      const customHeader = {
-        'x-fb-friendly-name': 'GroupCometLeaveForumMutation',
-        'x-fb-lsd': ctx.lsd || '',
-        'x-asbd-id': '359341',
-        origin: 'https://www.facebook.com',
-        referer: `https://www.facebook.com/groups/${groupID}`,
-      };
-
-      const res = await utils.post(
-        'https://www.facebook.com/api/graphql/',
-        ctx.jar,
-        form,
-        ctx.globalOptions,
-        ctx,
-        customHeader,
-      );
-
-      const data = parseResponseBody(res.body);
-      if (data?.errors) throw new Error(JSON.stringify(data.errors));
-      return data?.data ?? data;
-    },
-
-    /**
-     * Invites friends to a Facebook group.
-     * @async
-     * @param {string} groupID The ID of the group to invite friends to.
-     * @param {string[]} userIDs Array of user IDs to invite.
-     * @returns {Promise<Object>} A promise that resolves to the API response data on success.
-     * @throws {Error} If the groupID or userIDs are missing or the API request fails.
-     */
-    inviteFriends: async function(groupID: string, userIDs: string[]) {
-      if (!groupID) throw new Error('groupID is required.');
-      if (!userIDs?.length)
-        throw new Error('userIDs is required and must not be empty.');
-
-      const actorId = ctx.i_userID || ctx.userID;
-
-      const variables = {
-        input: {
+          action_source: 'GROUP_HEADER',
           attribution_id_v2:
-            'CometGroupDiscussionRoot.react,comet.group,via_cold_start,' +
+            'GroupsCometGroupHeaderActionButton.react,comet.group,via_cold_start,' +
             Date.now() +
-            ',829526,2361831622,,',
-          email_addresses: [],
-          group_id: groupID,
-          source: 'comet_invite_friends',
-          user_ids: userIDs,
-          actor_id: actorId,
-          client_mutation_id: '2',
+            ',,,',
+          actor_id: ctx.userID,
+          client_mutation_id: Math.floor(Math.random() * 10 + 1).toString(),
         },
-        groupID: groupID,
+        scale: 1,
       };
 
       const form = {
-        av: actorId,
-        __aaid: '0',
-        __user: actorId,
+        av: ctx.userID,
+        __user: ctx.userID,
         __a: '1',
-        __req: '1a',
-        __hs: '20530.HCSV2:comet_pkg.2.1...0',
-        dpr: '1',
-        __ccg: 'EXCELLENT',
-        __comet_req: '15',
         fb_dtsg: ctx.fb_dtsg,
         jazoest: ctx.jazoest,
         lsd: ctx.lsd,
-        __spin_r: '1035418183',
-        __spin_b: 'trunk',
-        __spin_t: Math.floor(Date.now() / 1000).toString(),
-        __crn: 'comet.fbweb.CometGroupDiscussionRoute',
         fb_api_caller_class: 'RelayModern',
-        fb_api_req_friendly_name: 'useGroupAddMembersMutation',
+        fb_api_req_friendly_name: 'GroupCometLeaveMutation',
         variables: JSON.stringify(variables),
-        server_timestamps: 'true',
-        doc_id: '25892331960437758',
-      };
-
-      const customHeader = {
-        'x-fb-friendly-name': 'useGroupAddMembersMutation',
-        'x-fb-lsd': ctx.lsd || '',
-        'x-asbd-id': '359341',
-        origin: 'https://www.facebook.com',
-        referer: `https://www.facebook.com/groups/${groupID}`,
+        doc_id: '5583297681747014',
       };
 
-      const res = await utils.post(
+      const res = await defaultFuncs.post(
         'https://www.facebook.com/api/graphql/',
         ctx.jar,
         form,
-        ctx.globalOptions,
-        ctx,
-        customHeader,
+        {},
       );
 
-      const data = parseResponseBody(res.body);
-      if (data?.errors) throw new Error(JSON.stringify(data.errors));
-      return data?.data ?? data;
+      if (res.data?.errors) throw new Error(JSON.stringify(res.data.errors));
+      return res.data?.data ?? res.data;
     },
 
     /**
@@ -523,7 +383,7 @@ export default function(defaultFuncs: any, api: any, ctx: any) {
      * // Page 2+
      * const page2 = await api.group.getJoinedGroups(page1.endCursor);
      */
-    getJoinedGroups: async function(
+    getJoinedGroups: async function (
       cursor: string | null = null,
       count: number = 10,
     ): Promise<JoinedGroupsResult> {
@@ -603,7 +463,7 @@ export default function(defaultFuncs: any, api: any, ctx: any) {
      * @param {{ limit?: number; cursor?: string | null; locale?: string }} [options]
      * @returns {Promise<{ groups: any[]; cursor: string | null; hasNextPage: boolean }>} Search result and pagination info.
      */
-    searchGroup: async function(
+    searchGroup: async function (
       keyword: string,
       options: { limit?: number; cursor?: string | null; locale?: string } = {},
     ): Promise<{ groups: any[]; cursor: string | null; hasNextPage: boolean }> {
@@ -664,25 +524,37 @@ export default function(defaultFuncs: any, api: any, ctx: any) {
         stream_initial_count: 0,
         useDefaultActor: false,
         __relay_internal__pv__GHLShouldChangeAdIdFieldNamerelayprovider: true,
-        __relay_internal__pv__GHLShouldChangeSponsoredDataFieldNamerelayprovider: true,
-        __relay_internal__pv__CometFeedStory_enable_post_permalink_white_space_clickrelayprovider: false,
-        __relay_internal__pv__CometUFICommentActionLinksRewriteEnabledrelayprovider: false,
-        __relay_internal__pv__CometUFICommentAvatarStickerAnimatedImagerelayprovider: false,
+        __relay_internal__pv__GHLShouldChangeSponsoredDataFieldNamerelayprovider:
+          true,
+        __relay_internal__pv__CometFeedStory_enable_post_permalink_white_space_clickrelayprovider:
+          false,
+        __relay_internal__pv__CometUFICommentActionLinksRewriteEnabledrelayprovider:
+          false,
+        __relay_internal__pv__CometUFICommentAvatarStickerAnimatedImagerelayprovider:
+          false,
         __relay_internal__pv__IsWorkUserrelayprovider: false,
-        __relay_internal__pv__TestPilotShouldIncludeDemoAdUseCaserelayprovider: false,
-        __relay_internal__pv__FBReels_deprecate_short_form_video_context_gkrelayprovider: true,
-        __relay_internal__pv__FBReels_enable_view_dubbed_audio_type_gkrelayprovider: true,
-        __relay_internal__pv__CometImmersivePhotoCanUserDisable3DMotionrelayprovider: false,
+        __relay_internal__pv__TestPilotShouldIncludeDemoAdUseCaserelayprovider:
+          false,
+        __relay_internal__pv__FBReels_deprecate_short_form_video_context_gkrelayprovider:
+          true,
+        __relay_internal__pv__FBReels_enable_view_dubbed_audio_type_gkrelayprovider:
+          true,
+        __relay_internal__pv__CometImmersivePhotoCanUserDisable3DMotionrelayprovider:
+          false,
         __relay_internal__pv__WorkCometIsEmployeeGKProviderrelayprovider: false,
         __relay_internal__pv__IsMergQAPollsrelayprovider: false,
-        __relay_internal__pv__FBReelsMediaFooter_comet_enable_reels_ads_gkrelayprovider: true,
-        __relay_internal__pv__CometUFIReactionsEnableShortNamerelayprovider: false,
+        __relay_internal__pv__FBReelsMediaFooter_comet_enable_reels_ads_gkrelayprovider:
+          true,
+        __relay_internal__pv__CometUFIReactionsEnableShortNamerelayprovider:
+          false,
         __relay_internal__pv__CometUFICommentAutoTranslationTyperelayprovider:
           'ORIGINAL',
         __relay_internal__pv__CometUFIShareActionMigrationrelayprovider: true,
         __relay_internal__pv__CometUFISingleLineUFIrelayprovider: false,
-        __relay_internal__pv__CometUFI_dedicated_comment_routable_dialog_gkrelayprovider: true,
-        __relay_internal__pv__FBReelsIFUTileContent_reelsIFUPlayOnHoverrelayprovider: true,
+        __relay_internal__pv__CometUFI_dedicated_comment_routable_dialog_gkrelayprovider:
+          true,
+        __relay_internal__pv__FBReelsIFUTileContent_reelsIFUPlayOnHoverrelayprovider:
+          true,
         __relay_internal__pv__GroupsCometGYSJFeedItemHeightrelayprovider: 150,
         __relay_internal__pv__ShouldEnableBakedInTextStoriesrelayprovider: false,
         __relay_internal__pv__StoriesShouldIncludeFbNotesrelayprovider: false,
@@ -708,9 +580,7 @@ export default function(defaultFuncs: any, api: any, ctx: any) {
         'x-fb-lsd': ctx.lsd || '',
         'x-asbd-id': '359341',
         origin: 'https://www.facebook.com',
-        referer: `https://www.facebook.com/groups/search/groups_home?q=${encodeURIComponent(
-          keyword,
-        )}&locale=${encodeURIComponent(locale)}`,
+        referer: `https://www.facebook.com/groups/search/groups_home?q=${encodeURIComponent(keyword)}&locale=${encodeURIComponent(locale)}`,
       };
 
       const res = await utils.post(
@@ -737,17 +607,6 @@ export default function(defaultFuncs: any, api: any, ctx: any) {
         hasNextPage: Boolean(pageInfo.has_next_page),
       };
     },
-
-    /**
-     * Alias for searchGroup.
-     * @see searchGroup
-     */
-    searchGroups: async function(
-      keyword: string,
-      options: { limit?: number; cursor?: string | null; locale?: string } = {},
-    ): Promise<{ groups: any[]; cursor: string | null; hasNextPage: boolean }> {
-      return groupModule.searchGroup(keyword, options);
-    },
   };
 
   return groupModule;