bb-fca 2.0.8 → 2.0.9

package/src/types/index.d.ts

@@ -88,30 +88,8 @@ export interface PostComment {
 }
 
 export interface GetPostCommentsOptions {
-  /** Numeric story_fbid (used with id to construct permalink.php URL) */
-  story_fbid?: string;
-  /** Facebook user/page ID (used with story_fbid) */
+  story_fbid: string;
   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 {
@@ -681,9 +659,8 @@ export interface API {
     ): Promise<DeletePostResult>;
     getComments(
       postID: string | GetPostCommentsOptions,
-      optionsOrCallback?: GetPostCommentsOptions | Callback<GetPostCommentsResult>,
-      callback?: Callback<GetPostCommentsResult>,
-    ): Promise<GetPostCommentsResult>;
+      callback?: Callback<PostComment[]>,
+    ): Promise<PostComment[]>;
     uploadPhoto(
       photoPath: string,
       callback?: Callback<UploadPhotoResult>,
@@ -794,14 +771,16 @@ export interface API {
   searchCity(
     query: string,
     searchCategory?: string,
-  ): Promise<Array<{
-    fbid: string;
-    title: string;
-    value: string;
-    photoUri: string;
-    subtitle: string;
-    secondSubtitle: string;
-  }>>;
+  ): Promise<
+    Array<{
+      fbid: string;
+      title: string;
+      value: string;
+      photoUri: string;
+      subtitle: string;
+      secondSubtitle: string;
+    }>
+  >;
 
   /**
    * Searches for companies/workplaces matching the given query string.
@@ -810,14 +789,16 @@ export interface API {
    */
   searchCompany(
     query: string,
-  ): Promise<Array<{
-    fbid: string;
-    title: string;
-    value: string;
-    photoUri: string;
-    subtitle: string;
-    secondSubtitle: 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.
@@ -826,14 +807,16 @@ export interface API {
    */
   searchJobTitle(
     query: string,
-  ): Promise<Array<{
-    fbid: string;
-    title: string;
-    value: string;
-    photoUri: string;
-    subtitle: string;
-    secondSubtitle: 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.
@@ -884,10 +867,7 @@ export interface API {
    * @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>;
+  updateCity(cityId: string, privacy?: string): Promise<any>;
 
   /**
    * Updates the hometown on the profile.
@@ -895,10 +875,7 @@ export interface API {
    * @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>;
+  updateHometown(cityId: string, privacy?: string): Promise<any>;
 
   /**
    * Changes the Facebook account display name (two-step: preview then confirm).

package/src/utils/constants.ts

@@ -3,9 +3,14 @@ const gradient = require('gradient-string');
 const echaceb = gradient(['#0061ff', '#681297']);
 const ws = echaceb('bb-fca');
 
-let h;
-const i = {};
-const j = {
+/**
+ * Presence compression token map.
+ * Keys are single uppercase letters used as compact tokens;
+ * values are the URL-encoded JSON substrings they replace.
+ * This map is used by presenceEncode/presenceDecode to compress
+ * presence payloads before sending to Facebook's EdgeChat API.
+ */
+const PRESENCE_TOKEN_MAP: Record<string, string> = {
   _: '%',
   A: '%2',
   B: '000',
@@ -36,17 +41,27 @@ const j = {
   Z:
     '%2c%22sb%22%3a1%2c%22t%22%3a%5b%5d%2c%22f%22%3anull%2c%22uct%22%3a0%2c%22s%22%3a0%2c%22blo%22%3a0%7d%2c%22bl%22%3a%7b%22ac%22%3a',
 };
-(function() {
-  const l = [];
-  for (const m in j) {
-    i[j[m]] = m;
-    l.push(j[m]);
+
+/** Reverse map: encoded substring → token letter. Built from PRESENCE_TOKEN_MAP. */
+const presenceDecodeMap: Record<string, string> = {};
+
+/** RegExp that matches any encodedsubstring in PRESENCE_TOKEN_MAP (longest first). */
+let presenceEncodeRegex: RegExp;
+
+(function buildPresenceMaps(): void {
+  const encodedValues: string[] = [];
+  for (const token in PRESENCE_TOKEN_MAP) {
+    presenceDecodeMap[PRESENCE_TOKEN_MAP[token]] = token;
+    encodedValues.push(PRESENCE_TOKEN_MAP[token]);
   }
-  l.reverse();
-  h = new RegExp(l.join('|'), 'g');
+  // Sort longest first so greedy matching works correctly
+  encodedValues.reverse();
+  presenceEncodeRegex = new RegExp(encodedValues.join('|'), 'g');
 })();
 
-const NUM_TO_MONTH = [
+// ─── Calendar helpers ───────────────────────────────────────────────────────
+
+const NUM_TO_MONTH: string[] = [
   'Jan',
   'Feb',
   'Mar',
@@ -60,26 +75,27 @@ const NUM_TO_MONTH = [
   'Nov',
   'Dec',
 ];
-const NUM_TO_DAY = ['Sun', 'Mon', 'Tue', 'Wed', 'Thu', 'Fri', 'Sat'];
+const NUM_TO_DAY: string[] = ['Sun', 'Mon', 'Tue', 'Wed', 'Thu', 'Fri', 'Sat'];
+
+// ─── Utility functions ───────────────────────────────────────────────────────
 
-function getRandom(arr) {
+function getRandom<T>(arr: T[]): T {
   return arr[Math.floor(Math.random() * arr.length)];
 }
 
-function padZeros(val, len = 2) {
-  val = String(val);
-  while (val.length < len) val = '0' + val;
-  return val;
+function padZeros(val: string | number, len: number = 2): string {
+  let s = String(val);
+  while (s.length < len) s = '0' + s;
+  return s;
 }
 
-function generateThreadingID(clientID) {
-  const k = Date.now();
-  const l = Math.floor(Math.random() * 4294967295);
-  const m = clientID;
-  return '<' + k + ':' + l + '-' + m + '@mail.projektitan.com>';
+function generateThreadingID(clientID: string): string {
+  const timestamp = Date.now();
+  const rand = Math.floor(Math.random() * 4294967295);
+  return '<' + timestamp + ':' + rand + '-' + clientID + '@mail.projektitan.com>';
 }
 
-function binaryToDecimal(data) {
+function binaryToDecimal(data: string): string {
   let ret = '';
   while (data !== '0') {
     let end = 0;
@@ -100,7 +116,7 @@ function binaryToDecimal(data) {
   return ret;
 }
 
-function generateOfflineThreadingID() {
+function generateOfflineThreadingID(): string {
   const ret = Date.now();
   const value = Math.floor(Math.random() * 4294967295);
   const str = ('0000000000000000000000' + value.toString(2)).slice(-22);
@@ -108,26 +124,33 @@ function generateOfflineThreadingID() {
   return binaryToDecimal(msgs);
 }
 
-function presenceEncode(str) {
+/**
+ * Compresses a presence JSON string using PRESENCE_TOKEN_MAP shortcuts.
+ * Reduces payload size when communicating with Facebook's EdgeChat API.
+ */
+function presenceEncode(str: string): string {
   return encodeURIComponent(str)
-    .replace(/([_A-Z])|%../g, function(m, n) {
+    .replace(/([_A-Z])|%../g, function(m: string, n: string): string {
       return n ? '%' + n.charCodeAt(0).toString(16) : m;
     })
     .toLowerCase()
-    .replace(h, function(m) {
-      return i[m];
+    .replace(presenceEncodeRegex, function(m: string): string {
+      return presenceDecodeMap[m];
     });
 }
 
-function presenceDecode(str) {
+/**
+ * Decompresses a presence-encoded string back to its original form.
+ */
+function presenceDecode(str: string): string {
   return decodeURIComponent(
-    str.replace(/[_A-Z]/g, function(m) {
-      return j[m];
+    str.replace(/[_A-Z]/g, function(m: string): string {
+      return PRESENCE_TOKEN_MAP[m];
     }),
   );
 }
 
-function generatePresence(userID) {
+function generatePresence(userID: string): string {
   const time = Date.now();
   return (
     'E' +
@@ -153,7 +176,7 @@ function generatePresence(userID) {
   );
 }
 
-function generateAccessiblityCookie() {
+function generateAccessiblityCookie(): string {
   const time = Date.now();
   return encodeURIComponent(
     JSON.stringify({
@@ -169,20 +192,19 @@ function generateAccessiblityCookie() {
   );
 }
 
-function getGUID() {
+function getGUID(): string {
   let sectionLength = Date.now();
   const id = 'xxxxxxxx-xxxx-4xxx-yxxx-xxxxxxxxxxxx'.replace(/[xy]/g, function(
-    c,
-  ) {
+    c: string,
+  ): string {
     const r = Math.floor((sectionLength + Math.random() * 16) % 16);
     sectionLength = Math.floor(sectionLength / 16);
-    const _guid = (c == 'x' ? r : (r & 7) | 8).toString(16);
-    return _guid;
+    return (c == 'x' ? r : (r & 7) | 8).toString(16);
   });
   return id;
 }
 
-function getFrom(str, startToken, endToken) {
+function getFrom(str: string, startToken: string, endToken: string): string {
   const start = str.indexOf(startToken) + startToken.length;
   if (start < startToken.length) return '';
 
@@ -196,7 +218,7 @@ function getFrom(str, startToken, endToken) {
   return lastHalf.substring(0, end);
 }
 
-function makeParsable(html) {
+function makeParsable(html: string): string | string[] {
   const withoutForLoop = html.replace(/for\s*\(\s*;\s*;\s*\)\s*;\s*/, '');
   const maybeMultipleObjects = withoutForLoop.split(/\}\r\n *\{/);
   if (maybeMultipleObjects.length === 1) return maybeMultipleObjects;
@@ -204,52 +226,57 @@ function makeParsable(html) {
   return '[' + maybeMultipleObjects.join('},{') + ']';
 }
 
-function arrToForm(form) {
+function arrToForm(form: Array<{ name: string; val: any }>): Record<string, any> {
   return arrayToObject(
     form,
-    function(v) {
-      return v.name;
-    },
-    function(v) {
-      return v.val;
-    },
+    function(v) { return v.name; },
+    function(v) { return v.val; },
   );
 }
 
-function arrayToObject(arr, getKey, getValue) {
-  return arr.reduce(function(acc, val) {
+function arrayToObject<T>(
+  arr: T[],
+  getKey: (v: T) => string,
+  getValue: (v: T) => any,
+): Record<string, any> {
+  return arr.reduce(function(acc: Record<string, any>, val: T) {
     acc[getKey(val)] = getValue(val);
     return acc;
   }, {});
 }
 
-function getSignatureID() {
+function getSignatureID(): string {
   return Math.floor(Math.random() * 2147483648).toString(16);
 }
 
-function generateTimestampRelative() {
+function generateTimestampRelative(): string {
   const d = new Date();
   return d.getHours() + ':' + padZeros(d.getMinutes());
 }
 
-function getType(obj) {
+function getType(obj: unknown): string {
   return Object.prototype.toString.call(obj).slice(8, -1);
 }
 
-// Logs
+// ─── Logging ─────────────────────────────────────────────────────────────────
+
 let logging = true;
-function logOptions(bool) {
+
+function logOptions(bool: boolean): void {
   logging = bool;
 }
-function log(...args) {
+
+function log(...args: unknown[]): void {
   if (logging === false) return;
   console.log(ws, chalk.green.bold('[LOG]'), ...args);
 }
-function error(...args) {
+
+function error(...args: unknown[]): void {
   if (logging === false) return;
   console.error(ws, chalk.red.bold('[ERROR]'), ...args);
 }
-function warn(...args) {
+
+function warn(...args: unknown[]): void {
   if (logging === false) return;
   console.warn(ws, chalk.yellow.bold('[WARNING]'), ...args);
 }