bb-fca 2.0.3 → 2.0.4

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

@@ -0,0 +1,113 @@
+import utils = require('../../../utils');
+
+/**
+ * @ChoruOfficial
+ * @description A module for updating the current city on a Facebook profile.
+ * Calls ProfileCometCurrentCityProfileFieldSaveMutation 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 current city.
+ */
+export default function (defaultFuncs: any, api: any, ctx: any) {
+  /**
+   * Updates the current city on the logged-in user's profile.
+   * Use `api.searchCity()` to get the city `fbid` first.
+   * @async
+   * @param {string} cityId The Facebook ID of the city (from searchCity's `fbid` field).
+   * @param {string} [privacy='EVERYONE'] Privacy setting: 'EVERYONE', 'FRIENDS', or 'SELF'.
+   * @returns {Promise<any>} A promise that resolves to the API response data on success.
+   * @throws {Error} If the cityId is missing or the API request fails.
+   *
+   * @example
+   * const cities = await api.searchCity('vinh');
+   * await api.updateCity(cities[0].fbid);
+   * await api.updateCity('112963075384670', 'FRIENDS');
+   */
+  return async function updateCity(
+    cityId: string,
+    privacy: string = 'EVERYONE',
+  ): Promise<any> {
+    if (!cityId) {
+      throw new Error('cityId is required. Use searchCity() to find the city fbid.');
+    }
+
+    // sectionToken = base64("app_section:<userID>:2327158227")
+    const sectionToken = Buffer.from(
+      `app_section:${ctx.userID}:2327158227`,
+    ).toString('base64');
+
+    const variables = {
+      collectionToken: 'UNKNOWN',
+      input: {
+        current_city_id: cityId,
+        life_event_publish_type: 'SUPPRESS_ALL',
+        logging_data: {
+          nav_chain: `ProfileCometAboutTabRoot.react,comet.profile.collection.directory_personal_details,unexpected,${Date.now()},0,,,`,
+        },
+        privacy: {
+          allow: [],
+          base_state: privacy,
+          deny: [],
+          tag_expansion_state: 'UNSPECIFIED',
+        },
+        actor_id: ctx.userID,
+        client_mutation_id: Math.floor(Math.random() * 10 + 1).toString(),
+      },
+      scale: 1,
+      sectionToken: sectionToken,
+      profileID: ctx.userID,
+      useDefaultActor: false,
+    };
+
+    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:
+        'ProfileCometCurrentCityProfileFieldSaveMutation',
+      variables: JSON.stringify(variables),
+      server_timestamps: 'true',
+      doc_id: '24052423611121998',
+    };
+
+    const customHeader = {
+      'x-fb-friendly-name':
+        'ProfileCometCurrentCityProfileFieldSaveMutation',
+      'x-fb-lsd': ctx.lsd,
+      'x-asbd-id': '359341',
+      origin: 'https://www.facebook.com',
+      referer: `https://www.facebook.com/profile.php?id=${ctx.userID}&sk=directory_personal_details`,
+    };
+
+    const resData = await utils.post(
+      'https://www.facebook.com/api/graphql/',
+      ctx.jar,
+      form,
+      ctx.globalOptions,
+      ctx,
+      customHeader,
+    );
+
+    // Handle both parsed object and string/Buffer response
+    let data: any;
+    if (typeof resData.body === 'object' && resData.body !== null && !Buffer.isBuffer(resData.body)) {
+      data = resData.body;
+    } else {
+      const body = typeof resData.body === 'string' ? resData.body : resData.body.toString();
+      try {
+        data = JSON.parse(body);
+      } catch {
+        const lines = body.split('\n').filter(Boolean);
+        data = JSON.parse(lines[0]);
+      }
+    }
+
+    if (data.errors) throw new Error(JSON.stringify(data.errors));
+    return data.data || data;
+  };
+}

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

@@ -0,0 +1,112 @@
+import utils = require('../../../utils');
+
+/**
+ * @ChoruOfficial
+ * @description A module for updating the hometown on a Facebook profile.
+ * Calls ProfileCometHometownProfileFieldSaveMutation 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 hometown.
+ */
+export default function (defaultFuncs: any, api: any, ctx: any) {
+  /**
+   * Updates the hometown on the logged-in user's profile.
+   * Use `api.searchCity(query, 'HOMETOWN')` to get the city `fbid` first.
+   * @async
+   * @param {string} cityId The Facebook ID of the city (from searchCity's `fbid` field).
+   * @param {string} [privacy='EVERYONE'] Privacy setting: 'EVERYONE', 'FRIENDS', or 'SELF'.
+   * @returns {Promise<any>} A promise that resolves to the API response data on success.
+   * @throws {Error} If the cityId is missing or the API request fails.
+   *
+   * @example
+   * const cities = await api.searchCity('ha noi', 'HOMETOWN');
+   * await api.updateHometown(cities[0].fbid);
+   * await api.updateHometown('106388046062960', 'FRIENDS');
+   */
+  return async function updateHometown(
+    cityId: string,
+    privacy: string = 'EVERYONE',
+  ): Promise<any> {
+    if (!cityId) {
+      throw new Error('cityId is required. Use searchCity(query, "HOMETOWN") to find the city fbid.');
+    }
+
+    // sectionToken = base64("app_section:<userID>:2327158227")
+    const sectionToken = Buffer.from(
+      `app_section:${ctx.userID}:2327158227`,
+    ).toString('base64');
+
+    const variables = {
+      collectionToken: 'UNKNOWN',
+      input: {
+        hometown_city_id: cityId,
+        life_event_publish_type: 'SUPPRESS_ALL',
+        logging_data: {
+          nav_chain: `ProfileCometAboutTabRoot.react,comet.profile.collection.directory_personal_details,via_cold_start,${Date.now()},0,,,`,
+        },
+        privacy: {
+          allow: [],
+          base_state: privacy,
+          deny: [],
+          tag_expansion_state: 'UNSPECIFIED',
+        },
+        actor_id: ctx.userID,
+        client_mutation_id: Math.floor(Math.random() * 10 + 1).toString(),
+      },
+      scale: 1,
+      sectionToken: sectionToken,
+      useDefaultActor: false,
+    };
+
+    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:
+        'ProfileCometHometownProfileFieldSaveMutation',
+      variables: JSON.stringify(variables),
+      server_timestamps: 'true',
+      doc_id: '26631736056430441',
+    };
+
+    const customHeader = {
+      'x-fb-friendly-name':
+        'ProfileCometHometownProfileFieldSaveMutation',
+      'x-fb-lsd': ctx.lsd,
+      'x-asbd-id': '359341',
+      origin: 'https://www.facebook.com',
+      referer: `https://www.facebook.com/profile.php?id=${ctx.userID}&sk=directory_personal_details`,
+    };
+
+    const resData = await utils.post(
+      'https://www.facebook.com/api/graphql/',
+      ctx.jar,
+      form,
+      ctx.globalOptions,
+      ctx,
+      customHeader,
+    );
+
+    // Handle both parsed object and string/Buffer response
+    let data: any;
+    if (typeof resData.body === 'object' && resData.body !== null && !Buffer.isBuffer(resData.body)) {
+      data = resData.body;
+    } else {
+      const body = typeof resData.body === 'string' ? resData.body : resData.body.toString();
+      try {
+        data = JSON.parse(body);
+      } catch {
+        const lines = body.split('\n').filter(Boolean);
+        data = JSON.parse(lines[0]);
+      }
+    }
+
+    if (data.errors) throw new Error(JSON.stringify(data.errors));
+    return data.data || data;
+  };
+}

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

@@ -0,0 +1,160 @@
+import utils = require('../../../utils');
+
+/**
+ * @ChoruOfficial
+ * @description A module for adding/updating work experience on a Facebook profile.
+ * Calls ProfileCometWorkExperienceSaveMutation 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 work experience.
+ */
+export default function updateWorkExperienceModule(defaultFuncs: any, api: any, ctx: any) {
+  /**
+   * Adds or updates a work experience entry on the profile.
+   * Use `api.searchCompany()` and `api.searchJobTitle()` to get IDs first.
+   * @async
+   * @param {Object} options Work experience details.
+   * @param {string} options.companyName The company/employer name.
+   * @param {string} [options.companyId] The company fbid from searchCompany (optional, UUID generated if empty).
+   * @param {string} [options.positionName] The job title/position name.
+   * @param {string} [options.positionId] The job title fbid from searchJobTitle (optional, UUID generated if empty).
+   * @param {boolean} [options.isCurrent=true] Whether this is the current job.
+   * @param {Object} [options.startDate] Start date: { year, month?, day? }.
+   * @param {Object} [options.endDate] End date: { year?, month?, day? } (if not current).
+   * @param {string} [options.description] Job description text.
+   * @param {string} [options.locationId] City fbid for work location (from searchCity).
+   * @param {string} [options.privacy='EVERYONE'] Privacy: 'EVERYONE', 'FRIENDS', or 'SELF'.
+   * @param {string} [options.workExperienceID] Existing work experience ID to update (null for new).
+   * @returns {Promise<any>} A promise that resolves to the API response data.
+   * @throws {Error} If companyName is missing or the API request fails.
+   *
+   * @example
+   * // Add new work experience
+   * await api.updateWorkExperience({
+   *   companyName: 'Google',
+   *   companyId: '104958162837',        // from searchCompany
+   *   positionName: 'Software Engineer',
+   *   positionId: '106154556093103',     // from searchJobTitle
+   *   isCurrent: true,
+   *   startDate: { year: 2024 },
+   * });
+   */
+  return async function updateWorkExperience(
+    options: {
+      companyName: string;
+      companyId?: string;
+      positionName?: string;
+      positionId?: string;
+      isCurrent?: boolean;
+      startDate?: { year?: number; month?: number; day?: number };
+      endDate?: { year?: number; month?: number; day?: number };
+      description?: string;
+      locationId?: string;
+      privacy?: string;
+      workExperienceID?: string | null;
+    },
+  ): Promise<any> {
+    if (!options.companyName) {
+      throw new Error('companyName is required.');
+    }
+
+    const privacy = options.privacy || 'EVERYONE';
+
+    // Generate a UUID-like ID if not provided
+    const generateUUID = () =>
+      'xxxxxxxx-xxxx-4xxx-yxxx-xxxxxxxxxxxx'.replace(/[xy]/g, (c) => {
+        const r = (Math.random() * 16) | 0;
+        const v = c === 'x' ? r : (r & 0x3) | 0x8;
+        return v.toString(16);
+      });
+
+    // sectionToken = base64("app_section:<userID>:2327158227")
+    const sectionToken = Buffer.from(
+      `app_section:${ctx.userID}:2327158227`,
+    ).toString('base64');
+
+    const variables: any = {
+      collectionToken: 'UNKNOWN',
+      input: {
+        description: options.description || '',
+        employer_id: options.companyId || generateUUID(),
+        employer_name: options.companyName,
+        end_date: options.endDate || {},
+        is_current: options.isCurrent !== undefined ? options.isCurrent : true,
+        location_id: options.locationId || '',
+        logging_data: {
+          nav_chain: `ProfileCometAboutTabRoot.react,comet.profile.collection.directory_work,unexpected,${Date.now()},0,,,`,
+        },
+        mutation_surface: 'PROFILE',
+        position_id: options.positionId || generateUUID(),
+        position_name: options.positionName || '',
+        privacy: {
+          allow: [],
+          base_state: privacy,
+          deny: [],
+          tag_expansion_state: 'UNSPECIFIED',
+        },
+        start_date: options.startDate || {},
+        actor_id: ctx.userID,
+        client_mutation_id: Math.floor(Math.random() * 10 + 1).toString(),
+      },
+      scale: 1,
+      sectionToken: sectionToken,
+      profileID: ctx.userID,
+      workExperienceID: options.workExperienceID || null,
+      useDefaultActor: false,
+      isProfileDirectory: true,
+      shouldFetchPostClick: false,
+    };
+
+    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:
+        'ProfileCometWorkExperienceSaveMutation',
+      variables: JSON.stringify(variables),
+      server_timestamps: 'true',
+      doc_id: '25132001056475784',
+    };
+
+    const customHeader = {
+      'x-fb-friendly-name':
+        'ProfileCometWorkExperienceSaveMutation',
+      'x-fb-lsd': ctx.lsd,
+      'x-asbd-id': '359341',
+      origin: 'https://www.facebook.com',
+      referer: `https://www.facebook.com/profile.php?id=${ctx.userID}&sk=directory_work`,
+    };
+
+    const resData = await utils.post(
+      'https://www.facebook.com/api/graphql/',
+      ctx.jar,
+      form,
+      ctx.globalOptions,
+      ctx,
+      customHeader,
+    );
+
+    let data: any;
+    if (typeof resData.body === 'object' && resData.body !== null && !Buffer.isBuffer(resData.body)) {
+      data = resData.body;
+    } else {
+      const body = typeof resData.body === 'string' ? resData.body : resData.body.toString();
+      try {
+        data = JSON.parse(body);
+      } catch {
+        const lines = body.split('\n').filter(Boolean);
+        data = JSON.parse(lines[0]);
+      }
+    }
+
+    if (data.errors) throw new Error(JSON.stringify(data.errors));
+    return data.data || data;
+  };
+}

package/src/types/index.d.ts

@@ -699,6 +699,121 @@ export interface API {
 
   // ── Session ────────────────────────────────────────────────────
 
+  /**
+   * Searches for cities matching the given query string.
+   * Uses Facebook's Directory Typeahead data source.
+   * @param query The search query (city name or partial name).
+   * @param searchCategory The category to search (default: 'CURRENT_CITY').
+   */
+  searchCity(
+    query: string,
+    searchCategory?: string,
+  ): Promise<Array<{
+    fbid: string;
+    title: string;
+    value: string;
+    photoUri: string;
+    subtitle: string;
+    secondSubtitle: string;
+  }>>;
+
+  /**
+   * Searches for companies/workplaces matching the given query string.
+   * Uses Facebook's Directory Typeahead data source with WORKPLACE category.
+   * @param query The search query (company name or partial name).
+   */
+  searchCompany(
+    query: string,
+  ): Promise<Array<{
+    fbid: string;
+    title: string;
+    value: string;
+    photoUri: string;
+    subtitle: string;
+    secondSubtitle: string;
+  }>>;
+
+  /**
+   * Searches for job titles/positions matching the given query string.
+   * Uses Facebook's Directory Typeahead data source with JOB_TITLE category.
+   * @param query The search query (job title or partial name).
+   */
+  searchJobTitle(
+    query: string,
+  ): Promise<Array<{
+    fbid: string;
+    title: string;
+    value: string;
+    photoUri: string;
+    subtitle: string;
+    secondSubtitle: string;
+  }>>;
+
+  /**
+   * Fetches the friend list of a given user with pagination support.
+   * @param userID The Facebook user ID whose friends to fetch.
+   * @param count Number of friends per page (default: 8).
+   * @param cursor Pagination cursor from previous response's endCursor (default: null).
+   */
+  getUserFriends(
+    userID: string,
+    count?: number,
+    cursor?: string | null,
+  ): Promise<{
+    friends: Array<{
+      id: string;
+      name: string;
+      avatarUri: string;
+      profileUrl: string;
+      mutualFriendsText: string;
+      friendshipStatus: string;
+      gender: string;
+    }>;
+    endCursor: string | null;
+    hasNextPage: boolean;
+  }>;
+
+  /**
+   * Adds or updates a work experience entry on the profile.
+   * Use searchCompany() and searchJobTitle() to get IDs first.
+   * @param options Work experience details.
+   */
+  updateWorkExperience(options: {
+    companyName: string;
+    companyId?: string;
+    positionName?: string;
+    positionId?: string;
+    isCurrent?: boolean;
+    startDate?: { year?: number; month?: number; day?: number };
+    endDate?: { year?: number; month?: number; day?: number };
+    description?: string;
+    locationId?: string;
+    privacy?: string;
+    workExperienceID?: string | null;
+  }): Promise<any>;
+
+  /**
+   * Updates the current city on the profile.
+   * Use searchCity() to get the city fbid first.
+   * @param cityId The Facebook ID of the city (from searchCity's fbid field).
+   * @param privacy Privacy setting: 'EVERYONE', 'FRIENDS', or 'SELF' (default: 'EVERYONE').
+   */
+  updateCity(
+    cityId: string,
+    privacy?: string,
+  ): Promise<any>;
+
+  /**
+   * Updates the hometown on the profile.
+   * Use searchCity() to get the city fbid first.
+   * @param cityId The Facebook ID of the city (from searchCity's fbid field).
+   * @param privacy Privacy setting: 'EVERYONE', 'FRIENDS', or 'SELF' (default: 'EVERYONE').
+   */
+  updateHometown(
+    cityId: string,
+    privacy?: string,
+  ): Promise<any>;
+
   /**
    * Changes the Facebook account display name (two-step: preview then confirm).
    * Calls AccountsCenter GraphQL API.