fca-neokex-fix 1.0.1

package/examples/test-logging.js

@@ -0,0 +1,85 @@
+const utils = require('../src/utils/constants');
+const { globalMonitor } = require('../src/utils/monitoring');
+
+console.log('\n╔══════════════════════════════════════════════════════════════╗');
+console.log('║         NeoKEX-FCA Enhanced Logging System Demo             ║');
+console.log('╚══════════════════════════════════════════════════════════════╝\n');
+
+console.log('📝 Testing Different Log Levels:\n');
+
+utils.trace('This is a trace message - most verbose level');
+utils.debug('This is a debug message - for development info');
+utils.info('This is an info message - general information');
+utils.log('This is a standard log message');
+utils.success('This is a success message - operation completed!');
+utils.warn('This is a warning message - something needs attention');
+utils.error('This is an error message - something went wrong');
+utils.critical('This is a critical error - system failure!');
+
+console.log('\n\n🎨 Testing Visual Elements:\n');
+
+utils.banner('Welcome to NeoKEX-FCA', 'cyan');
+
+console.log('\n');
+
+utils.box('System Information', [
+    'Version: 4.5.1',
+    'Node Version: ' + process.version,
+    'Platform: ' + process.platform
+], 'info');
+
+console.log('\n');
+
+utils.box('Success Report', [
+    'Login successful',
+    'Connection established',
+    'All systems operational'
+], 'success');
+
+console.log('\n');
+
+utils.box('Warning Alert', [
+    'Rate limit approaching',
+    'High memory usage detected'
+], 'warn');
+
+console.log('\n');
+
+utils.box('Error Details', [
+    'Failed to connect to server',
+    'Retrying in 5 seconds...'
+], 'error');
+
+console.log('\n\n📊 Testing Monitoring System:\n');
+
+globalMonitor.trackRequest('/api/login', true, 150);
+globalMonitor.trackRequest('/api/messages', true, 250);
+globalMonitor.trackRequest('/api/send', false, 500, new Error('Rate limit exceeded'));
+globalMonitor.trackRequest('/api/threads', true, 6000);
+
+setTimeout(() => {
+    console.log('\n');
+    globalMonitor.displayHealthStatus();
+    
+    console.log('\n📌 Testing Log Level Control:\n');
+    
+    console.log('Setting log level to "warn" (only warnings, errors, and success will show):\n');
+    utils.setLogLevel('warn');
+    
+    utils.trace('This trace will NOT be shown');
+    utils.debug('This debug will NOT be shown');
+    utils.info('This info will NOT be shown');
+    utils.log('This log will NOT be shown');
+    utils.success('This success WILL be shown (success always shows!)');
+    utils.warn('This warning WILL be shown');
+    utils.error('This error WILL be shown');
+    
+    console.log('\n\nResetting log level to "info":\n');
+    utils.setLogLevel('info');
+    
+    utils.info('All log levels from info and above are now visible again!');
+    
+    console.log('\n\n╔══════════════════════════════════════════════════════════════╗');
+    console.log('║              Enhanced Logging Demo Complete! ✨              ║');
+    console.log('╚══════════════════════════════════════════════════════════════╝\n');
+}, 100);

package/examples/theme-usage-example.js

@@ -0,0 +1,53 @@
+const fs = require("fs");
+const { login } = require("../index");
+
+const credentials = { appState: JSON.parse(fs.readFileSync("appstate.json", "utf8")) };
+
+login(credentials, async (err, api) => {
+  if (err) return console.error(err);
+
+  const threadID = "YOUR_THREAD_ID";
+
+  api.listenMqtt((err) => {
+    if (err) console.error(err);
+  });
+
+  await new Promise(resolve => setTimeout(resolve, 2000));
+
+  console.log("Getting all available themes...");
+  const themes = await api.getTheme(threadID);
+  console.log(`Found ${themes.length} themes!`);
+  themes.slice(0, 5).forEach(theme => {
+    console.log(`- ${theme.name} (ID: ${theme.id})`);
+  });
+
+  console.log("\nGetting current thread theme...");
+  const currentTheme = await api.getThemeInfo(threadID);
+  console.log(`Thread: ${currentTheme.threadName}`);
+  console.log(`Color: ${currentTheme.color}`);
+  console.log(`Emoji: ${currentTheme.emoji}`);
+
+  console.log("\nApplying a standard theme...");
+  const blueTheme = themes.find(t => t.name.includes("Blue") || t.id === "1440238847056619");
+  if (blueTheme) {
+    await api.setThreadThemeMqtt(threadID, blueTheme.id);
+    console.log(`Applied theme: ${blueTheme.name}`);
+  }
+
+  console.log("\nTrying AI theme generation...");
+  try {
+    const aiThemes = await api.createAITheme("ocean sunset vibes");
+    console.log("AI theme generated!");
+    await api.setThreadThemeMqtt(threadID, aiThemes[0].id);
+    console.log("AI theme applied!");
+  } catch (e) {
+    if (e.code === 'FEATURE_UNAVAILABLE') {
+      console.log("AI themes not available for this account.");
+      console.log("You can still use all standard themes!");
+    } else {
+      console.error("Error:", e.message);
+    }
+  }
+
+  process.exit(0);
+});

package/index.js

@@ -0,0 +1,2 @@
+"use strict";
+module.exports = require('./src/engine/client');

package/package.json

@@ -0,0 +1,105 @@
+{
+  "name": "fca-neokex-fix",
+  "version": "1.0.1",
+  "module": "commonjs",
+  "types": "src/types/index.d.ts",
+  "description": "Advanced Facebook Chat API (FCA) for Node.js - Bug-fixed fork of neokex-fca with memory leak fixes, proper reconnection handling, and production-ready stability",
+  "main": "index.js",
+  "files": [
+    "index.js",
+    "src/",
+    "examples/",
+    "LICENSE",
+    "README.md",
+    "CHANGELOG.md",
+    "THEME_FEATURES.md"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/NeoKEX/fca-neokex.git"
+  },
+  "author": "NeoKEX",
+  "contributors": [
+    {
+      "name": "NeoKEX Team",
+      "url": "original authors"
+    }
+  ],
+  "license": "MIT",
+  "bugs": {
+    "url": "https://github.com/NeoKEX/fca-neokex/issues"
+  },
+  "homepage": "https://github.com/NeoKEX/fca-neokex#readme",
+  "keywords": [
+    "facebook",
+    "chat",
+    "api",
+    "fca",
+    "fca-neokex",
+    "neokex-fca",
+    "messenger",
+    "bot",
+    "automation",
+    "facebook-messenger",
+    "facebook-chat",
+    "messenger-bot",
+    "ai-theme",
+    "mqtt",
+    "realtime",
+    "websocket",
+    "facebook-api",
+    "chat-bot",
+    "messaging",
+    "bug-fix",
+    "production-ready",
+    "stable"
+  ],
+  "dependencies": {
+    "axios": "^1.13.2",
+    "axios-cookiejar-support": "^6.0.4",
+    "bluebird": "^3.7.2",
+    "chalk": "^4.1.2",
+    "cheerio": "^1.1.2",
+    "deepdash": "^5.3.9",
+    "form-data": "^4.0.4",
+    "gradient-string": "^1.2.0",
+    "https-proxy-agent": "^7.0.6",
+    "jsonpath-plus": "^10.3.0",
+    "lodash": "^4.17.21",
+    "mqtt": "^3.0.0",
+    "npmlog": "^7.0.1",
+    "tough-cookie": "^6.0.0",
+    "uuid": "^11.0.3",
+    "websocket-stream": "^5.3.0",
+    "ws": "^8.18.3"
+  },
+  "devDependencies": {
+    "@types/axios": "^0.9.36",
+    "@types/form-data": "^2.2.1",
+    "@types/node": "^22.19.0",
+    "@types/tough-cookie": "^4.0.5",
+    "eslint": "^9.39.1",
+    "mocha": "^11.7.5",
+    "prettier": "^3.6.2",
+    "ts-node": "^10.9.2",
+    "typescript": "^5.9.3"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "scripts": {
+    "start": "node examples/simple-bot.js",
+    "validate": "npm pack --dry-run",
+    "prepack": "echo 'Preparing package for npm...'",
+    "test": "echo 'No tests configured yet'"
+  },
+  "overrides": {
+    "websocket-stream": {
+      "ws": "^8.18.3"
+    }
+  },
+  "directories": {
+    "example": "examples",
+    "test": "test"
+  }
+}

package/src/apis/addExternalModule.js

@@ -0,0 +1,24 @@
+"use strict";
+const utils = require('../utils');
+
+module.exports = function (defaultFuncs, api, ctx) {
+  return function addExternalModule(moduleObj) {
+    if (utils.getType(moduleObj) == "Object") {
+      for (const apiName in moduleObj) {
+        if (utils.getType(moduleObj[apiName]) == "Function") {
+          api[apiName] = moduleObj[apiName](defaultFuncs, api, ctx);
+        } else {
+          throw new Error(
+            `Item "${apiName}" in moduleObj must be a function, not ${utils.getType(
+              moduleObj[apiName],
+            )}!`,
+          );
+        }
+      }
+    } else {
+      throw new Error(
+        `moduleObj must be an object, not ${utils.getType(moduleObj)}!`,
+      );
+    }
+  };
+};

package/src/apis/addUserToGroup.js

@@ -0,0 +1,108 @@
+"use strict";
+
+const utils = require('../utils');
+
+module.exports = (defaultFuncs, api, ctx) => {
+  return async function addUserToGroup(userID, threadID, callback) {
+    let resolveFunc = () => {};
+    let rejectFunc = () => {};
+    const returnPromise = new Promise((resolve, reject) => {
+      resolveFunc = resolve;
+      rejectFunc = reject;
+    });
+
+    if (!callback) {
+      callback = (err, result) => {
+        if (err) return rejectFunc(err);
+        resolveFunc(result);
+      };
+    }
+
+    try {
+      if (!ctx.mqttClient) {
+        throw new Error("Not connected to MQTT. Please use listenMqtt first.");
+      }
+
+      if (utils.getType(threadID) !== "Number" && utils.getType(threadID) !== "String") {
+        throw new Error("ThreadID should be of type Number or String");
+      }
+
+      if (utils.getType(userID) !== "Array") {
+        userID = [userID];
+      }
+
+      const reqID = ++ctx.wsReqNumber;
+      const taskID = ++ctx.wsTaskNumber;
+
+      const payload = {
+        epoch_id: utils.generateOfflineThreadingID(),
+        tasks: [
+          {
+            failure_count: null,
+            label: "23",
+            payload: JSON.stringify({
+              thread_key: threadID,
+              contact_ids: userID,
+              sync_group: 1
+            }),
+            queue_name: threadID.toString(),
+            task_id: taskID
+          }
+        ],
+        version_id: "24502707779384158"
+      };
+
+      const form = JSON.stringify({
+        app_id: "772021112871879",
+        payload: JSON.stringify(payload),
+        request_id: reqID,
+        type: 3
+      });
+
+      let responseHandled = false;
+      const handleRes = (topic, message) => {
+        if (topic !== "/ls_resp" || responseHandled) return;
+        let jsonMsg;
+        try {
+          jsonMsg = JSON.parse(message.toString());
+          jsonMsg.payload = JSON.parse(jsonMsg.payload);
+        } catch {
+          return;
+        }
+        if (jsonMsg.request_id !== reqID) return;
+        responseHandled = true;
+        clearTimeout(timeout);
+        ctx.mqttClient.removeListener("message", handleRes);
+        callback(null, { success: true, response: jsonMsg.payload });
+        resolveFunc({ success: true, response: jsonMsg.payload });
+      };
+
+      const timeout = setTimeout(() => {
+        if (!responseHandled) {
+          responseHandled = true;
+          ctx.mqttClient.removeListener("message", handleRes);
+          const err = new Error("MQTT request timeout");
+          callback(err);
+          rejectFunc(err);
+        }
+      }, 30000);
+
+      ctx.mqttClient.on("message", handleRes);
+      ctx.mqttClient.publish("/ls_req", form, { qos: 1, retain: false }, (err) => {
+        if (err && !responseHandled) {
+          responseHandled = true;
+          clearTimeout(timeout);
+          ctx.mqttClient.removeListener("message", handleRes);
+          callback(err);
+          rejectFunc(err);
+        }
+      });
+    } catch (err) {
+      utils.error("addUserToGroup", err);
+      callback(err);
+      rejectFunc(err);
+    }
+
+    return returnPromise;
+  };
+};

package/src/apis/changeAdminStatus.js

@@ -0,0 +1,148 @@
+"use strict";
+
+const utils = require('../utils');
+
+function generateOfflineThreadingID() {
+    return Date.now().toString() + Math.floor(Math.random() * 1000000).toString();
+}
+
+function getType(obj) {
+    return Object.prototype.toString.call(obj).slice(8, -1);
+}
+
+module.exports = function (defaultFuncs, api, ctx) {
+    return function changeAdminStatus(threadID, adminID, adminStatus, callback) {
+        let resolveFunc = function() {};
+        let rejectFunc = function() {};
+        const returnPromise = new Promise(function(resolve, reject) {
+            resolveFunc = resolve;
+            rejectFunc = reject;
+        });
+
+        if (!callback) {
+            callback = function(err, data) {
+                if (err) return rejectFunc(err);
+                resolveFunc(data);
+            };
+        }
+
+        if (getType(threadID) !== "String") {
+            return callback({ error: "changeAdminStatus: threadID must be a string" });
+        }
+        if (getType(adminID) !== "String" && getType(adminID) !== "Array") {
+            return callback({ error: "changeAdminStatus: adminID must be a string or an array" });
+        }
+        if (getType(adminStatus) !== "Boolean") {
+            return callback({ error: "changeAdminStatus: adminStatus must be true or false" });
+        }
+
+        if (ctx.mqttClient) {
+            const tasks = [];
+            const isAdmin = adminStatus ? 1 : 0;
+            const epochID = generateOfflineThreadingID();
+
+            if (getType(adminID) === "Array") {
+                adminID.forEach((id, index) => {
+                    tasks.push({
+                        failure_count: null,
+                        label: "25",
+                        payload: JSON.stringify({
+                            thread_key: threadID,
+                            contact_id: id,
+                            is_admin: isAdmin
+                        }),
+                        queue_name: "admin_status",
+                        task_id: index + 1
+                    });
+                });
+            } else {
+                tasks.push({
+                    failure_count: null,
+                    label: "25",
+                    payload: JSON.stringify({
+                        thread_key: threadID,
+                        contact_id: adminID,
+                        is_admin: isAdmin
+                    }),
+                    queue_name: "admin_status",
+                    task_id: 1
+                });
+            }
+
+            let count_req = 0;
+            const form = JSON.stringify({
+                app_id: "2220391788200892",
+                payload: JSON.stringify({
+                    epoch_id: epochID,
+                    tasks: tasks,
+                    version_id: "8798795233522156"
+                }),
+                request_id: ++count_req,
+                type: 3
+            });
+
+            ctx.mqttClient.publish("/ls_req", form, {}, (err, _packet) => {
+                if (err) {
+                    utils.error("changeAdminStatus (MQTT)", err);
+                    return callback(err);
+                } else {
+                    utils.log("Admin status changed successfully via MQTT");
+                    return callback(null, { success: true });
+                }
+            });
+        } else {
+            utils.warn("MQTT client not available, using HTTP fallback for changeAdminStatus");
+            const tasks = [];
+            const epochID = generateOfflineThreadingID();
+
+            if (getType(adminID) === "Array") {
+                adminID.forEach((id, index) => {
+                    tasks.push({
+                        label: '25',
+                        payload: JSON.stringify({ thread_key: threadID, contact_id: id, is_admin: adminStatus }),
+                        queue_name: 'admin_status',
+                        task_id: index + 1,
+                        failure_count: null
+                    });
+                });
+            } else {
+                tasks.push({
+                    label: '25',
+                    payload: JSON.stringify({ thread_key: threadID, contact_id: adminID, is_admin: adminStatus }),
+                    queue_name: 'admin_status',
+                    task_id: 1,
+                    failure_count: null
+                });
+            }
+
+            const form = {
+                fb_dtsg: ctx.fb_dtsg,
+                request_id: 1,
+                type: 3,
+                payload: {
+                    version_id: '3816854585040595',
+                    tasks: tasks,
+                    epoch_id: epochID,
+                    data_trace_id: null
+                },
+                app_id: '772021112871879'
+            };
+
+            form.payload = JSON.stringify(form.payload);
+
+            defaultFuncs
+                .post("https://www.facebook.com/api/graphqlbatch/", ctx.jar, form)
+                .then(utils.parseAndCheckLogin(ctx, defaultFuncs))
+                .then(() => {
+                    utils.log("Admin status changed successfully via HTTP");
+                    callback(null, { success: true });
+                })
+                .catch(err => {
+                    utils.error("changeAdminStatus (HTTP)", err);
+                    callback(err);
+                });
+        }
+
+        return returnPromise;
+    };
+};

package/src/apis/changeArchivedStatus.js

@@ -0,0 +1,61 @@
+"use strict";
+
+const utils = require('../utils');
+
+module.exports = (defaultFuncs, api, ctx) => {
+  return async function changeArchivedStatus(threadIDs, archive, callback) {
+    let resolveFunc = () => {};
+    let rejectFunc = () => {};
+    const returnPromise = new Promise((resolve, reject) => {
+      resolveFunc = resolve;
+      rejectFunc = reject;
+    });
+
+    if (!callback) {
+      callback = (err, result) => {
+        if (err) return rejectFunc(err);
+        resolveFunc(result);
+      };
+    }
+
+    try {
+      if (utils.getType(archive) === "Function") {
+        callback = archive;
+        archive = true;
+      }
+
+      if (utils.getType(archive) !== "Boolean") {
+        throw new Error("archive parameter must be a boolean");
+      }
+
+      if (!Array.isArray(threadIDs)) {
+        threadIDs = [threadIDs];
+      }
+
+      const form = {
+        should_archive: archive
+      };
+      
+      threadIDs.forEach(id => {
+        form[`thread_fbids[${id}]`] = true;
+      });
+
+      const res = await defaultFuncs.post(
+        "https://www.facebook.com/ajax/mercury/change_archived_status.php",
+        ctx.jar,
+        form
+      ).then(utils.parseAndCheckLogin(ctx, defaultFuncs));
+
+      if (res && res.error) {
+        throw res;
+      }
+
+      callback(null, { success: true });
+    } catch (err) {
+      utils.error("changeArchivedStatus", err);
+      callback(err);
+    }
+
+    return returnPromise;
+  };
+};

package/src/apis/changeAvatar.js

@@ -0,0 +1,103 @@
+"use strict";
+
+const utils = require('../utils');
+
+module.exports = (defaultFuncs, api, ctx) => {
+  async function handleUpload(image) {
+    const form = {
+      profile_id: ctx.userID,
+      photo_source: 57,
+      av: ctx.userID,
+      file: image
+    };
+
+    return defaultFuncs.postFormData(
+      "https://www.facebook.com/profile/picture/upload/",
+      ctx.jar,
+      form,
+      {}
+    ).then(utils.parseAndCheckLogin(ctx, defaultFuncs))
+    .then(resData => {
+      if (resData.error) throw resData;
+      return resData;
+    });
+  }
+
+  return async function changeAvatar(image, caption, timestamp, callback) {
+    let resolveFunc = () => {};
+    let rejectFunc = () => {};
+    const returnPromise = new Promise((resolve, reject) => {
+      resolveFunc = resolve;
+      rejectFunc = reject;
+    });
+
+    if (!timestamp && utils.getType(caption) === "Number") {
+      timestamp = caption;
+      caption = "";
+    }
+
+    if (!timestamp && !callback && (utils.getType(caption) === "Function")) {
+      callback = caption;
+      caption = "";
+      timestamp = null;
+    }
+
+    if (!callback) {
+      callback = (err, data) => {
+        if (err) return rejectFunc(err);
+        resolveFunc(data);
+      };
+    }
+
+    try {
+      if (!utils.isReadableStream(image)) {
+        throw new Error("Image is not a readable stream");
+      }
+
+      const payload = await handleUpload(image);
+      
+      const form = {
+        av: ctx.i_userID || ctx.userID,
+        fb_api_req_friendly_name: "ProfileCometProfilePictureSetMutation",
+        fb_api_caller_class: "RelayModern",
+        doc_id: "5066134240065849",
+        variables: JSON.stringify({
+          input: {
+            caption: caption || "",
+            existing_photo_id: payload.payload.fbid,
+            expiration_time: timestamp,
+            profile_id: ctx.i_userID || ctx.userID,
+            profile_pic_method: "EXISTING",
+            profile_pic_source: "TIMELINE",
+            scaled_crop_rect: {
+              height: 1,
+              width: 1,
+              x: 0,
+              y: 0
+            },
+            skip_cropping: true,
+            actor_id: ctx.i_userID || ctx.userID,
+            client_mutation_id: Math.round(Math.random() * 19).toString()
+          },
+          isPage: false,
+          isProfile: true,
+          scale: 3
+        })
+      };
+
+      const res = await defaultFuncs.post("https://www.facebook.com/api/graphql/", ctx.jar, form)
+        .then(utils.parseAndCheckLogin(ctx, defaultFuncs));
+
+      if (res.errors) {
+        throw res;
+      }
+
+      callback(null, res[0].data.profile_picture_set);
+    } catch (err) {
+      utils.error("changeAvatar", err);
+      callback(err);
+    }
+
+    return returnPromise;
+  };
+};