bb-fca 2.0.1 → 2.0.3

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

@@ -0,0 +1,165 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.default = default_1;
+const fs = __importStar(require("fs"));
+const utils = require("../../../utils");
+/**
+ * @ChoruOfficial
+ * @description A module for uploading a new cover photo (ảnh bìa) to Facebook.
+ * Two-step process:
+ *  1. Upload: sends the image file via multipart/form-data to /profile/cover/comet_upload/
+ *  2. Confirm: calls ProfileCometCoverPhotoUpdateMutation to apply the photo as cover
+ * @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 uploads a cover photo.
+ */
+function default_1(defaultFuncs, api, ctx) {
+    /**
+     * Step 2 — Confirm the uploaded photo as cover via ProfileCometCoverPhotoUpdateMutation.
+     * @private
+     * @param {string} photoID The ID of the uploaded photo.
+     * @param {string} profileID The profile ID.
+     * @param {{ x: number, y: number }} [focus] Optional focus point. Defaults to center {x:0.5, y:0.5}.
+     */
+    async function setCoverPhoto(photoID, profileID, focus = { x: 0.5, y: 0.5 }) {
+        const variables = {
+            input: {
+                attribution_id_v2: `ProfileCometAboutTabRoot.react,comet.profile.collection.about,via_cold_start,${Date.now()},670164,,,`,
+                cover_photo_id: photoID,
+                focus: focus,
+                target_user_id: profileID,
+                actor_id: ctx.userID,
+                client_mutation_id: Math.floor(Math.random() * 10 + 1).toString(),
+            },
+            scale: 1,
+            contextualProfileContext: null,
+        };
+        const form = {
+            av: ctx.userID,
+            __user: ctx.userID,
+            __a: '1',
+            fb_dtsg: ctx.fb_dtsg,
+            jazoest: ctx.jazoest,
+            lsd: ctx.lsd,
+            fb_api_caller_class: 'RelayModern',
+            fb_api_req_friendly_name: 'ProfileCometCoverPhotoUpdateMutation',
+            variables: JSON.stringify(variables),
+            server_timestamps: 'true',
+            doc_id: '31388044007461211',
+        };
+        const res = await defaultFuncs.post('https://www.facebook.com/api/graphql/', ctx.jar, form, {});
+        if (res.data.errors)
+            throw new Error(JSON.stringify(res.data.errors));
+        return res.data;
+    }
+    /**
+     * Uploads a new cover photo (ảnh bìa) for the logged-in user, then confirms it as the cover.
+     * @async
+     * @param {string} imagePath The local file path to the image to upload.
+     * @param {string} [profileID=ctx.userID] The profile ID. Defaults to the logged-in user.
+     * @param {{ x: number, y: number }} [focus] Optional focus point for cropping. Defaults to {x:0.5, y:0.5}.
+     * @param {Function} [callback] Optional callback function.
+     * @returns {Promise<Object>} A promise that resolves with { upload, set } data on success.
+     * @throws {Error} If the imagePath is missing, the file does not exist, or any step fails.
+     *
+     * @example
+     * await api.uploadCover('/path/to/cover.jpg');
+     * await api.uploadCover('/path/to/cover.jpg', '61588408996667');
+     * await api.uploadCover('/path/to/cover.jpg', ctx.userID, { x: 0.5, y: 0.3 });
+     */
+    return async function uploadCover(imagePath, profileID = ctx.userID, focus = { x: 0.5, y: 0.5 }, callback) {
+        let resolveFunc = function () { };
+        let rejectFunc = function () { };
+        const returnPromise = new Promise(function (resolve, reject) {
+            resolveFunc = resolve;
+            rejectFunc = reject;
+        });
+        callback =
+            callback ||
+                function (err, data) {
+                    if (err)
+                        return rejectFunc(err);
+                    resolveFunc(data);
+                };
+        try {
+            if (!imagePath)
+                throw new Error('imagePath is required.');
+            if (typeof imagePath !== 'string')
+                throw new Error('imagePath must be a string.');
+            if (!fs.existsSync(imagePath))
+                throw new Error(`File not found: ${imagePath}`);
+            // Step 1: Upload the photo
+            const photoStream = fs.createReadStream(imagePath);
+            const url = new URL('https://www.facebook.com/profile/cover/comet_upload/');
+            url.searchParams.append('profile_id', profileID);
+            url.searchParams.append('av', ctx.userID);
+            url.searchParams.append('__aaid', '0');
+            url.searchParams.append('__user', ctx.userID);
+            url.searchParams.append('__a', '1');
+            url.searchParams.append('fb_dtsg', ctx.fb_dtsg);
+            url.searchParams.append('jazoest', ctx.jazoest);
+            url.searchParams.append('lsd', ctx.lsd);
+            const uploadResponse = await utils.postFormData(url.toString(), ctx.jar, { file: photoStream }, ctx.globalOptions, ctx);
+            const uploadResult = JSON.parse(uploadResponse.body.toString().replace(/^for \(;;\);/, ''));
+            if (uploadResult.error || uploadResult.errors) {
+                throw new Error(JSON.stringify(uploadResult.error || uploadResult.errors));
+            }
+            const photoID = uploadResult.payload?.fbid ||
+                uploadResult.payload?.photoID ||
+                uploadResult.payload?.photo_id ||
+                null;
+            if (!photoID) {
+                throw new Error('Upload succeeded but could not extract photo ID from response.');
+            }
+            // Step 2: Confirm as cover photo
+            const setResult = await setCoverPhoto(photoID, profileID, focus);
+            const result = {
+                success: true,
+                photoID: photoID,
+                upload: uploadResult,
+                set: setResult,
+            };
+            callback(null, result);
+        }
+        catch (err) {
+            utils.error('uploadCover', err);
+            callback(err);
+        }
+        return returnPromise;
+    };
+}
+//# sourceMappingURL=uploadCover.js.map

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

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

package/dist/index.d.ts

@@ -123,6 +123,13 @@ export interface UploadPhotoResult {
   data: any;
 }
 
+export interface ChangeNameResult {
+  /** Raw preview response data from AccountsCenter name validation query. */
+  preview: any;
+  /** Raw mutation result data confirming the name change. */
+  result: any;
+}
+
 export interface CurrentFriendInfo {
   userID: string;
   name: string;
@@ -637,6 +644,8 @@ export interface API {
     getCurrentFriends(
       callback?: Callback<CurrentFriendInfo[]>,
     ): Promise<CurrentFriendInfo[]>;
+    /** Send a friend request to a user by their ID via their profile page. */
+    add(userID: UserID, callback?: Callback): Promise<any>;
     suggest: {
       list(
         limit?: number,
@@ -690,6 +699,19 @@ export interface API {
 
   // ── Session ────────────────────────────────────────────────────
 
+  /**
+   * Changes the Facebook account display name (two-step: preview then confirm).
+   * Calls AccountsCenter GraphQL API.
+   * @param firstName New first name.
+   * @param lastName New last name.
+   * @param middleName Optional middle name (default: empty string).
+   */
+  changeName(
+    firstName: string,
+    lastName: string,
+    middleName?: string,
+  ): Promise<ChangeNameResult>;
+
   /** Log out and invalidate the current session. */
   logout(callback?: (err: any) => void): Promise<void>;
 

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

@@ -49,6 +49,30 @@ export default function (defaultFuncs: any, api: any, ctx: any): {
      * @description Functions for managing friend suggestions.
      */
     getCurrentFriends: (callback?: any) => Promise<any>;
+    /**
+     * Sends a friend request to a user by their ID (via Profile Button channel).
+     * @async
+     * @param {string} userID The ID of the user to add as a friend.
+     * @returns {Promise<Object>} A promise that resolves to the API response data on success.
+     * @throws {Error} If the userID is missing or the API request fails.
+     */
+    add: (userID: any) => Promise<any>;
+    /**
+     * Cancels a sent friend request (hủy lời mời kết bạn đã gửi).
+     * @async
+     * @param {string} userID The ID of the user whose friend request is to be cancelled.
+     * @returns {Promise<Object>} A promise that resolves to the API response data upon successful cancellation.
+     * @throws {Error} If the userID is missing or the API request fails.
+     */
+    cancelRequest: (userID: any) => Promise<any>;
+    /**
+     * Unfriends a user (hủy kết bạn).
+     * @async
+     * @param {string} userID The ID of the user to unfriend.
+     * @returns {Promise<Object>} A promise that resolves to the API response data upon successful unfriending.
+     * @throws {Error} If the userID is missing or the API request fails.
+     */
+    unfriend: (userID: any) => Promise<any>;
     suggest: {
         /**
          * Fetches a list of suggested friends (People You May Know).

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

@@ -0,0 +1,10 @@
+/**
+ * @ChoruOfficial
+ * @description A module for updating the Facebook profile bio (tiểu sử).
+ * Calls ProfileCometBioFieldSaveMutation 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 updates the account's bio.
+ */
+export default function (defaultFuncs: any, api: any, ctx: any): (bio: string) => Promise<any>;

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

@@ -0,0 +1,15 @@
+/**
+ * @ChoruOfficial
+ * @description A module for changing the Facebook account display name via AccountsCenter.
+ * The name change process is two-step:
+ *  1. Preview: validate and preview the new name
+ *  2. Confirm: apply the name change mutation
+ * @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 changes the account's display name.
+ */
+export default function (defaultFuncs: any, api: any, ctx: any): (firstName: string, lastName: string, middleName?: string) => Promise<{
+    preview: any;
+    result: any;
+}>;

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

@@ -0,0 +1,11 @@
+/**
+ * @description A module for uploading a new profile picture (avatar) to Facebook.
+ * Two-step process:
+ *  1. Upload: sends the image file via multipart/form-data to /profile/picture/upload/
+ *  2. Set: calls ProfileCometProfilePictureSetMutation to apply the photo as avatar with optional caption
+ * @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 uploads an avatar image.
+ */
+export default function (defaultFuncs: any, api: any, ctx: any): (imagePath: string, caption?: string, profileID?: string, callback?: any) => Promise<any>;

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

@@ -0,0 +1,15 @@
+/**
+ * @ChoruOfficial
+ * @description A module for uploading a new cover photo (ảnh bìa) to Facebook.
+ * Two-step process:
+ *  1. Upload: sends the image file via multipart/form-data to /profile/cover/comet_upload/
+ *  2. Confirm: calls ProfileCometCoverPhotoUpdateMutation to apply the photo as cover
+ * @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 uploads a cover photo.
+ */
+export default function (defaultFuncs: any, api: any, ctx: any): (imagePath: string, profileID?: string, focus?: {
+    x: number;
+    y: number;
+}, callback?: any) => Promise<any>;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "bb-fca",
-  "version": "2.0.1",
+  "version": "2.0.3",
   "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",

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

@@ -8,7 +8,7 @@ import utils = require('../../../utils');
  * @param {Object} ctx The context object containing the user's session state (e.g., userID, jar, fb_dtsg).
  * @returns {Object} A `friendModule` object with methods for friend interactions.
  */
-export default function(defaultFuncs: any, api: any, ctx: any) {
+export default function (defaultFuncs: any, api: any, ctx: any) {
   /**
    * A private helper function to standardize friend data from various GraphQL endpoints.
    * @private
@@ -60,7 +60,7 @@ export default function(defaultFuncs: any, api: any, ctx: any) {
      * @returns {Promise<Array<Object>>} A promise that resolves to an array of friend request objects.
      * @throws {Error} If the API request fails or HTML parsing fails.
      */
-    requests: async function() {
+    requests: async function () {
       try {
         const url = 'https://www.facebook.com/friends/requests';
         const resData = await utils.get(
@@ -85,7 +85,7 @@ export default function(defaultFuncs: any, api: any, ctx: any) {
      * @returns {Promise<Object>} A promise that resolves to the API response data upon successful acceptance.
      * @throws {Error} If the identifier is missing, the user is not found in requests, or the API call fails.
      */
-    accept: async function(identifier) {
+    accept: async function (identifier) {
       try {
         if (!identifier) throw new Error('A name or user ID is required.');
         let targetUserID = identifier;
@@ -102,12 +102,17 @@ export default function(defaultFuncs: any, api: any, ctx: any) {
         }
         const variables = {
           input: {
+            click_correlation_id: Date.now().toString(),
+            click_proof_validation_result: '{"validated":true}',
             friend_requester_id: targetUserID,
-            friending_channel: 'FRIENDS_HOME_MAIN',
+            friending_channel: 'FRIENDS_HOME_REQUESTS',
+            warn_ack: false,
             actor_id: ctx.userID,
             client_mutation_id: Math.floor(Math.random() * 10 + 1).toString(),
           },
-          scale: 3,
+          scale: 1,
+          refresh_num: 0,
+          should_fix_banner: true,
         };
         const form = {
           av: ctx.userID,
@@ -120,7 +125,7 @@ export default function(defaultFuncs: any, api: any, ctx: any) {
           fb_api_req_friendly_name:
             'FriendingCometFriendRequestConfirmMutation',
           variables: JSON.stringify(variables),
-          doc_id: '24630768433181357',
+          doc_id: '24769943302682670',
         };
         const res = await defaultFuncs.post(
           'https://www.facebook.com/api/graphql/',
@@ -147,7 +152,7 @@ export default function(defaultFuncs: any, api: any, ctx: any) {
      * @returns {Promise<Object>} A promise that resolves to the API response data upon successful deletion.
      * @throws {Error} If the identifier is missing, the user is not found in requests, or the API call fails.
      */
-    delete: async function(identifier) {
+    delete: async function (identifier) {
       try {
         if (!identifier) throw new Error('A name or user ID is required.');
         let targetUserID = identifier;
@@ -206,7 +211,7 @@ export default function(defaultFuncs: any, api: any, ctx: any) {
      * @returns {Promise<Array<Object>>} A promise that resolves to an array of formatted friend objects.
      * @throws {Error} If the API request fails.
      */
-    list: async function(userID = ctx.userID) {
+    list: async function (userID = ctx.userID) {
       try {
         const sectionToken = Buffer.from(
           `app_section:${userID}:2356318349`,
@@ -249,6 +254,143 @@ export default function(defaultFuncs: any, api: any, ctx: any) {
      */
     getCurrentFriends: getCurrentFriends,
 
+    /**
+     * Sends a friend request to a user by their ID (via Profile Button channel).
+     * @async
+     * @param {string} userID The ID of the user to add as a friend.
+     * @returns {Promise<Object>} A promise that resolves to the API response data on success.
+     * @throws {Error} If the userID is missing or the API request fails.
+     */
+    add: async function (userID) {
+      try {
+        if (!userID) throw new Error('userID is required.');
+        const variables = {
+          input: {
+            click_correlation_id: Date.now().toString(),
+            click_proof_validation_result: '{"validated":true}',
+            friend_requestee_ids: [userID],
+            friending_channel: 'PROFILE_BUTTON',
+            warn_ack_for_ids: [],
+            actor_id: ctx.userID,
+            client_mutation_id: Math.floor(Math.random() * 10 + 1).toString(),
+          },
+          scale: 1,
+        };
+        const form = {
+          av: ctx.userID,
+          __user: ctx.userID,
+          __a: '1',
+          fb_dtsg: ctx.fb_dtsg,
+          jazoest: ctx.jazoest,
+          lsd: ctx.lsd,
+          fb_api_caller_class: 'RelayModern',
+          fb_api_req_friendly_name: 'FriendingCometFriendRequestSendMutation',
+          variables: JSON.stringify(variables),
+          doc_id: '34974854235435024',
+        };
+        const res = await defaultFuncs.post(
+          'https://www.facebook.com/api/graphql/',
+          ctx.jar,
+          form,
+          {},
+        );
+        if (res.data.errors) throw new Error(JSON.stringify(res.data.errors));
+        return res.data.data;
+      } catch (err) {
+        throw err;
+      }
+    },
+
+    /**
+     * Cancels a sent friend request (hủy lời mời kết bạn đã gửi).
+     * @async
+     * @param {string} userID The ID of the user whose friend request is to be cancelled.
+     * @returns {Promise<Object>} A promise that resolves to the API response data upon successful cancellation.
+     * @throws {Error} If the userID is missing or the API request fails.
+     */
+    cancelRequest: async function (userID) {
+      try {
+        if (!userID) throw new Error('userID is required.');
+        const variables = {
+          input: {
+            cancelled_friend_requestee_id: userID,
+            click_correlation_id: Date.now().toString(),
+            click_proof_validation_result: '{"validated":true}',
+            friending_channel: 'PROFILE_BUTTON',
+            actor_id: ctx.userID,
+            client_mutation_id: Math.floor(Math.random() * 10 + 1).toString(),
+          },
+          scale: 1,
+        };
+        const form = {
+          av: ctx.userID,
+          __user: ctx.userID,
+          __a: '1',
+          fb_dtsg: ctx.fb_dtsg,
+          jazoest: ctx.jazoest,
+          lsd: ctx.lsd,
+          fb_api_caller_class: 'RelayModern',
+          fb_api_req_friendly_name: 'FriendingCometFriendRequestCancelMutation',
+          variables: JSON.stringify(variables),
+          doc_id: '24453541284254355',
+        };
+        const res = await defaultFuncs.post(
+          'https://www.facebook.com/api/graphql/',
+          ctx.jar,
+          form,
+          {},
+        );
+        if (res.data.errors) throw new Error(JSON.stringify(res.data.errors));
+        return res.data.data;
+      } catch (err) {
+        throw err;
+      }
+    },
+
+    /**
+     * Unfriends a user (hủy kết bạn).
+     * @async
+     * @param {string} userID The ID of the user to unfriend.
+     * @returns {Promise<Object>} A promise that resolves to the API response data upon successful unfriending.
+     * @throws {Error} If the userID is missing or the API request fails.
+     */
+    unfriend: async function (userID) {
+      try {
+        if (!userID) throw new Error('userID is required.');
+        const variables = {
+          input: {
+            source: 'bd_profile_button',
+            unfriended_user_id: userID,
+            actor_id: ctx.userID,
+            client_mutation_id: Math.floor(Math.random() * 10 + 1).toString(),
+          },
+          scale: 1,
+        };
+        const form = {
+          av: ctx.userID,
+          __user: ctx.userID,
+          __a: '1',
+          fb_dtsg: ctx.fb_dtsg,
+          jazoest: ctx.jazoest,
+          lsd: ctx.lsd,
+          fb_api_caller_class: 'RelayModern',
+          fb_api_req_friendly_name: 'FriendingCometUnfriendMutation',
+          variables: JSON.stringify(variables),
+          doc_id: '24028849793460009',
+        };
+        const res = await defaultFuncs.post(
+          'https://www.facebook.com/api/graphql/',
+          ctx.jar,
+          form,
+          {},
+        );
+        if (res.data.errors) throw new Error(JSON.stringify(res.data.errors));
+        return res.data.data;
+      } catch (err) {
+        throw err;
+      }
+    },
+
     suggest: {
       /**
        * Fetches a list of suggested friends (People You May Know).
@@ -257,7 +399,7 @@ export default function(defaultFuncs: any, api: any, ctx: any) {
        * @returns {Promise<Array<Object>>} A promise that resolves to an array of suggested friend objects.
        * @throws {Error} If the API request fails.
        */
-      list: async function(limit = 30) {
+      list: async function (limit = 30) {
         try {
           const form = {
             av: ctx.userID,
@@ -290,7 +432,7 @@ 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 userID is missing or the API request fails.
        */
-      request: async function(userID) {
+      request: async function (userID) {
         try {
           if (!userID) throw new Error('userID is required.');
           const variables = {
@@ -337,17 +479,17 @@ export default function(defaultFuncs: any, api: any, ctx: any) {
    * @returns {Promise<Array<Object>>} A promise that resolves to an array of friend objects.
    */
   async function getCurrentFriends(callback?) {
-    let resolveFunc: Function = function() {};
-    let rejectFunc: Function = function() {};
+    let resolveFunc: Function = function () { };
+    let rejectFunc: Function = function () { };
 
-    const returnPromise = new Promise<any>(function(resolve, reject) {
+    const returnPromise = new Promise<any>(function (resolve, reject) {
       resolveFunc = resolve;
       rejectFunc = reject;
     });
 
     callback =
       callback ||
-      function(err, data) {
+      function (err, data) {
         if (err) return rejectFunc(err);
         resolveFunc(data);
       };

package/src/deltas/apis/users/changeBio.ts

@@ -0,0 +1,68 @@
+/**
+ * @ChoruOfficial
+ * @description A module for updating the Facebook profile bio (tiểu sử).
+ * Calls ProfileCometBioFieldSaveMutation 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 updates the account's bio.
+ */
+export default function (defaultFuncs: any, api: any, ctx: any) {
+  /**
+   * Updates the profile bio (tiểu sử) of the logged-in user.
+   * @async
+   * @param {string} bio The new bio text to set. Pass an empty string to clear the bio.
+   * @returns {Promise<Object>} A promise that resolves to the API response data on success.
+   * @throws {Error} If the API request fails.
+   *
+   * @example
+   * await api.changeBio('day la tieu su doi toi');
+   * await api.changeBio(''); // clear bio
+   */
+  return async function changeBio(bio: string): Promise<any> {
+    if (bio === undefined || bio === null) {
+      throw new Error('bio is required. Pass an empty string to clear it.');
+    }
+
+    // sectionToken = base64("app_section:<userID>:2327158227")
+    const sectionToken = Buffer.from(
+      `app_section:${ctx.userID}:2327158227`,
+    ).toString('base64');
+
+    const variables = {
+      collectionToken: 'UNKNOWN',
+      input: {
+        bio: bio,
+        profile_field_section_type: 'DIRECTORY_BIO',
+        actor_id: ctx.userID,
+        client_mutation_id: Math.floor(Math.random() * 10 + 1).toString(),
+      },
+      scale: 1,
+      sectionToken: sectionToken,
+    };
+
+    const form = {
+      av: ctx.userID,
+      __user: ctx.userID,
+      __a: '1',
+      fb_dtsg: ctx.fb_dtsg,
+      jazoest: ctx.jazoest,
+      lsd: ctx.lsd,
+      fb_api_caller_class: 'RelayModern',
+      fb_api_req_friendly_name: 'ProfileCometBioFieldSaveMutation',
+      variables: JSON.stringify(variables),
+      server_timestamps: 'true',
+      doc_id: '26787878704133086',
+    };
+
+    const res = await defaultFuncs.post(
+      'https://www.facebook.com/api/graphql/',
+      ctx.jar,
+      form,
+      {},
+    );
+
+    if (res.data.errors) throw new Error(JSON.stringify(res.data.errors));
+    return res.data.data;
+  };
+}