bb-fca 2.0.6 → 2.0.8

package/dist/deltas/apis/users/searchGroups.js

@@ -0,0 +1,221 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.default = searchGroupsModule;
+const utils = require("../../../utils");
+/**
+ * @description A module for searching Facebook groups by keyword.
+ * Calls SearchCometResultsPaginatedResultsQuery via /api/graphql/.
+ * @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 {Function} An async function that searches for groups by keyword.
+ */
+function searchGroupsModule(defaultFuncs, api, ctx) {
+    /**
+     * Generates a UUID v4 string for use as a batch search ID.
+     */
+    function createBsid() {
+        return 'xxxxxxxx-xxxx-4xxx-yxxx-xxxxxxxxxxxx'.replace(/[xy]/g, (c) => {
+            const r = Math.random() * 16;
+            const v = c === 'x' ? r : (r & 0x3) | 0x8;
+            return Math.floor(v).toString(16);
+        });
+    }
+    /**
+     * Parses a localised member count string (e.g. "1.2K members") into a number.
+     */
+    function parseLocalizedCount(text) {
+        const match = text.match(/([\d.,]+)\s*([kKmMbB])?/);
+        if (!match)
+            return null;
+        const base = Number((match[1] || '').replace(/,/g, '.'));
+        if (Number.isNaN(base))
+            return null;
+        const unit = (match[2] || '').toLowerCase();
+        if (unit === 'k')
+            return Math.round(base * 1000);
+        if (unit === 'm')
+            return Math.round(base * 1000000);
+        if (unit === 'b')
+            return Math.round(base * 1000000000);
+        return Math.round(base);
+    }
+    /**
+     * Maps a single search result edge to a group object.
+     */
+    function mapSearchGroupEdge(edge) {
+        const viewModel = edge?.rendering_strategy?.view_model;
+        const profile = viewModel?.profile || {};
+        const primaryCTAProfile = viewModel?.ctas?.primary?.[0]?.profile || {};
+        const summaryText = viewModel?.primary_snippet_text_with_entities?.text || null;
+        const summaryParts = summaryText
+            ? summaryText
+                .split('·')
+                .map((part) => part.trim())
+                .filter(Boolean)
+            : [];
+        const memberPart = summaryParts.find((part) => /member|thành viên|membro|mitglieder|membres/i.test(part)) || null;
+        return {
+            groupID: profile.id || null,
+            name: profile.name || null,
+            url: profile.url || primaryCTAProfile.url || null,
+            profileUrl: profile.profile_url || profile.url || primaryCTAProfile.url || null,
+            imageSrc: profile.profile_picture?.uri || null,
+            summary: summaryText,
+            privacy: summaryParts[0] || null,
+            memberText: memberPart,
+            memberCount: memberPart ? parseLocalizedCount(memberPart) : null,
+            joinState: primaryCTAProfile.viewer_join_state || null,
+            hasMembershipQuestions: typeof primaryCTAProfile.has_membership_questions === 'boolean'
+                ? primaryCTAProfile.has_membership_questions
+                : null,
+        };
+    }
+    /**
+     * Parses the HTTP response body, handling both pre-parsed objects and raw strings.
+     */
+    function parseResponseBody(body) {
+        if (typeof body === 'object' && body !== null && !Buffer.isBuffer(body)) {
+            return body;
+        }
+        const raw = typeof body === 'string' ? body : body.toString();
+        const normalized = raw.replace(/^for \(;;\);\s*/, '');
+        try {
+            return JSON.parse(normalized);
+        }
+        catch {
+            const lines = normalized.split('\n').filter(Boolean);
+            return JSON.parse(lines[0]);
+        }
+    }
+    /**
+     * Searches for Facebook groups matching the given keyword.
+     * Uses Facebook's Search Comet endpoint with GROUPS_TAB_GLOBAL experience.
+     * @async
+     * @param {string} keyword The search keyword.
+     * @param {Object} [options] Optional parameters.
+     * @param {number} [options.limit=10] Number of results per page.
+     * @param {string|null} [options.cursor=null] Pagination cursor from a previous result.
+     * @param {string} [options.locale='vi_VN'] Locale for the search request.
+     * @returns {Promise<{ groups: any[]; cursor: string | null; hasNextPage: boolean }>}
+     * @throws {Error} If the keyword is missing or the API request fails.
+     *
+     * @example
+     * const result = await api.searchGroups('gaming');
+     * console.log(result.groups);     // Array of group objects
+     * console.log(result.cursor);     // cursor string for next page
+     * console.log(result.hasNextPage);
+     *
+     * // Page 2
+     * const page2 = await api.searchGroups('gaming', { cursor: result.cursor });
+     */
+    return async function searchGroups(keyword, options = {}) {
+        if (!keyword || typeof keyword !== 'string') {
+            throw new Error('searchGroups: keyword must be a non-empty string.');
+        }
+        const limit = typeof options.limit === 'number' && Number.isInteger(options.limit)
+            ? options.limit
+            : 10;
+        if (limit <= 0) {
+            throw new Error('searchGroups: options.limit must be a positive integer.');
+        }
+        const locale = options.locale || 'vi_VN';
+        const bsid = createBsid();
+        const tsid = Math.random().toString();
+        const variables = {
+            allow_streaming: false,
+            args: {
+                callsite: 'comet:groups_search',
+                config: {
+                    exact_match: false,
+                    high_confidence_config: null,
+                    intercept_config: null,
+                    sts_disambiguation: null,
+                    watch_config: null,
+                },
+                context: {
+                    bsid,
+                    tsid,
+                },
+                experience: {
+                    client_defined_experiences: ['ADS_PARALLEL_FETCH'],
+                    encoded_server_defined_params: null,
+                    fbid: null,
+                    type: 'GROUPS_TAB_GLOBAL',
+                },
+                filters: [],
+                text: keyword,
+            },
+            count: limit,
+            cursor: options.cursor ?? null,
+            feedLocation: 'SEARCH',
+            feedbackSource: 23,
+            fetch_filters: true,
+            focusCommentID: null,
+            locale: null,
+            privacySelectorRenderLocation: 'COMET_STREAM',
+            referringStoryRenderLocation: null,
+            renderLocation: 'search_results_page',
+            scale: 1,
+            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__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__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__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__GroupsCometGYSJFeedItemHeightrelayprovider: 150,
+            __relay_internal__pv__ShouldEnableBakedInTextStoriesrelayprovider: false,
+            __relay_internal__pv__StoriesShouldIncludeFbNotesrelayprovider: false,
+        };
+        const form = {
+            av: ctx.i_userID || ctx.userID,
+            __user: ctx.i_userID || ctx.userID,
+            __a: '1',
+            fb_dtsg: ctx.fb_dtsg,
+            jazoest: ctx.jazoest,
+            lsd: ctx.lsd || '',
+            locale,
+            fb_api_caller_class: 'RelayModern',
+            fb_api_req_friendly_name: 'SearchCometResultsPaginatedResultsQuery',
+            server_timestamps: 'true',
+            variables: JSON.stringify(variables),
+            doc_id: '26131941349797315',
+        };
+        const customHeader = {
+            'x-fb-friendly-name': 'SearchCometResultsPaginatedResultsQuery',
+            '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)}`,
+        };
+        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));
+        }
+        const results = data?.data?.serpResponse?.results;
+        const edges = Array.isArray(results?.edges) ? results.edges : [];
+        const pageInfo = results?.page_info || {};
+        return {
+            groups: edges.map(mapSearchGroupEdge),
+            cursor: pageInfo.end_cursor || null,
+            hasNextPage: Boolean(pageInfo.has_next_page),
+        };
+    };
+}
+//# sourceMappingURL=searchGroups.js.map

package/dist/deltas/apis/users/searchGroups.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"searchGroups.js","sourceRoot":"","sources":["../../../../src/deltas/apis/users/searchGroups.ts"],"names":[],"mappings":"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"}

package/dist/index.d.ts

@@ -88,8 +88,30 @@ export interface PostComment {
 }
 
 export interface GetPostCommentsOptions {
-  story_fbid: string;
+  /** Numeric story_fbid (used with id to construct permalink.php URL) */
+  story_fbid?: string;
+  /** Facebook user/page ID (used with story_fbid) */
   id?: string;
+  /** Direct Facebook post URL (e.g. https://www.facebook.com/user/posts/pfbid...) */
+  url?: string;
+  /** Cursor for fetching next page of comments (from page_info.end_cursor) */
+  after?: string;
+  /** GraphQL feedback ID for pagination (from page_info.feedback_id) */
+  feedback_id?: string;
+}
+
+export interface PageInfo {
+  end_cursor: string | null;
+  has_next_page: boolean;
+  has_previous_page?: boolean;
+  start_cursor?: string | null;
+  /** GraphQL feedback ID needed for pagination queries */
+  feedback_id?: string;
+}
+
+export interface GetPostCommentsResult {
+  comments: PostComment[];
+  page_info: PageInfo | null;
 }
 
 export interface ShareResult {
@@ -374,6 +396,56 @@ export interface ThreadInfo {
   };
 }
 
+export interface SearchGroupOptions {
+  limit?: number;
+  cursor?: string | null;
+  locale?: string;
+}
+
+export interface SearchGroupItem {
+  groupID: string | null;
+  name: string | null;
+  url: string | null;
+  profileUrl: string | null;
+  imageSrc: string | null;
+  summary: string | null;
+  privacy: string | null;
+  memberText: string | null;
+  memberCount: number | null;
+  joinState: string | null;
+  hasMembershipQuestions: boolean | null;
+}
+
+export interface SearchGroupResult {
+  groups: SearchGroupItem[];
+  cursor: string | null;
+  hasNextPage: boolean;
+}
+
+export interface GroupModule {
+  join(groupID: string): Promise<any>;
+  leave(groupID: string): Promise<any>;
+  getJoinedGroups(
+    cursor?: string | null,
+    count?: number,
+  ): Promise<{
+    groups: Array<{
+      id: string;
+      name: string;
+      imageUri: string;
+      url: string;
+      memberCount: string;
+      privacy: string;
+    }>;
+    endCursor: string | null;
+    hasNextPage: boolean;
+  }>;
+  searchGroup(
+    keyword: string,
+    options?: SearchGroupOptions,
+  ): Promise<SearchGroupResult>;
+}
+
 export interface MessageObject {
   body?: string;
   attachment?: ReadStream[];
@@ -609,8 +681,9 @@ export interface API {
     ): Promise<DeletePostResult>;
     getComments(
       postID: string | GetPostCommentsOptions,
-      callback?: Callback<PostComment[]>,
-    ): Promise<PostComment[]>;
+      optionsOrCallback?: GetPostCommentsOptions | Callback<GetPostCommentsResult>,
+      callback?: Callback<GetPostCommentsResult>,
+    ): Promise<GetPostCommentsResult>;
     uploadPhoto(
       photoPath: string,
       callback?: Callback<UploadPhotoResult>,
@@ -852,6 +925,9 @@ export interface API {
   /** Add an external module to extend the API. */
   addExternalModule(moduleObj: Record<string, Function>): void;
 
+  /** Group-related API methods. */
+  group: GroupModule;
+
   /** Allow accessing dynamically loaded methods. */
   [key: string]: any;
 }

package/dist/types/deltas/apis/posting/group.d.ts

@@ -0,0 +1,90 @@
+/**
+ * @namespace api.group
+ * @description A module for joining, leaving, and listing Facebook groups.
+ * @license Ex-it
+ */
+export default function (defaultFuncs: any, api: any, ctx: any): {
+    /**
+     * Joins a Facebook group.
+     * @async
+     * @param {string} groupID The ID of the group to join.
+     * @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: (groupID: string, inviteShortLinkKey?: string | null) => Promise<any>;
+    /**
+     * Leaves a Facebook group.
+     * @async
+     * @param {string} groupID The ID of the group to leave.
+     * @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: (groupID: string) => Promise<any>;
+    /**
+     * 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: (groupID: string, userIDs: string[]) => Promise<any>;
+    /**
+     * Fetches the logged-in user's joined Facebook groups with cursor-based pagination.
+     *
+     * @param {string|null} [cursor=null] Pagination cursor from a previous result's `endCursor`.
+     *   Pass `null` (or omit) for the first page.
+     * @param {number} [count=10] Number of groups to fetch per page (used for pagination requests).
+     * @returns {Promise<JoinedGroupsResult>} Groups list and pagination info.
+     *
+     * @example
+     * // Page 1
+     * const page1 = await api.group.getJoinedGroups();
+     * console.log(page1.groups);    // Array of GroupEntry
+     * console.log(page1.endCursor); // cursor string for next page
+     *
+     * // Page 2+
+     * const page2 = await api.group.getJoinedGroups(page1.endCursor);
+     */
+    getJoinedGroups: (cursor?: string | null, count?: number) => Promise<{
+        groups: {
+            id: string;
+            name: string;
+            imageUri: string;
+            url: string;
+            memberCount: string;
+            privacy: string;
+        }[];
+        endCursor: string | null;
+        hasNextPage: boolean;
+    }>;
+    /**
+     * Search Facebook groups by keyword.
+     *
+     * @param {string} keyword Search keyword.
+     * @param {{ limit?: number; cursor?: string | null; locale?: string }} [options]
+     * @returns {Promise<{ groups: any[]; cursor: string | null; hasNextPage: boolean }>} Search result and pagination info.
+     */
+    searchGroup: (keyword: string, options?: {
+        limit?: number;
+        cursor?: string | null;
+        locale?: string;
+    }) => Promise<{
+        groups: any[];
+        cursor: string | null;
+        hasNextPage: boolean;
+    }>;
+    /**
+     * Alias for searchGroup.
+     * @see searchGroup
+     */
+    searchGroups: (keyword: string, options?: {
+        limit?: number;
+        cursor?: string | null;
+        locale?: string;
+    }) => Promise<{
+        groups: any[];
+        cursor: string | null;
+        hasNextPage: boolean;
+    }>;
+};

package/dist/types/deltas/apis/posting/post.d.ts

@@ -21,7 +21,7 @@ export default function (defaultFuncs: any, api: any, ctx: any): {
         postID: any;
         data: any;
     }>;
-    getComments: (postID: any, callback: any) => Promise<any>;
+    getComments: (postID: any, optionsOrCallback?: any, callback?: any) => Promise<any>;
     uploadPhoto: (photoPath: any, callback: any) => Promise<any>;
     uploadVideo: (videoPath: any, callback: any) => Promise<any>;
 };

package/dist/types/deltas/apis/threads/searchGroup.d.ts

@@ -0,0 +1,15 @@
+type SearchGroupOptions = {
+    limit?: number;
+    cursor?: string | null;
+    locale?: string;
+};
+/**
+ * @ChoruOfficial
+ * @description Search Facebook groups by keyword using SearchCometResultsPaginatedResultsQuery.
+ */
+export default function searchGroupModule(defaultFuncs: any, api: any, ctx: any): (keyword: string, options?: SearchGroupOptions) => Promise<{
+    groups: any[];
+    cursor: string | null;
+    hasNextPage: boolean;
+}>;
+export {};

package/dist/types/deltas/apis/users/searchGroups.d.ts

@@ -0,0 +1,17 @@
+/**
+ * @description A module for searching Facebook groups by keyword.
+ * Calls SearchCometResultsPaginatedResultsQuery via /api/graphql/.
+ * @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 {Function} An async function that searches for groups by keyword.
+ */
+export default function searchGroupsModule(defaultFuncs: any, api: any, ctx: any): (keyword: string, options?: {
+    limit?: number;
+    cursor?: string | null;
+    locale?: string;
+}) => Promise<{
+    groups: any[];
+    cursor: string | null;
+    hasNextPage: boolean;
+}>;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "bb-fca",
-  "version": "2.0.6",
+  "version": "2.0.8",
   "description": "BB-FCA is a powerful and user-friendly Facebook Chat API wrapper for Node.js, designed to simplify the process of creating chatbots and automating interactions on Facebook Messenger. With BB-FCA, developers can easily send messages, manage conversations, and interact with the Facebook Messenger platform using a simple and intuitive API.",
   "main": "dist/core/client.js",
   "types": "dist/index.d.ts",