rapido-fca 0.0.10 → 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+The MIT License (MIT)
+
+Copyright (c) 2015 Avery, Benjamin, David, Maude
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in
+all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+THE SOFTWARE.

package/index.js

@@ -135,8 +135,8 @@ function buildAPI(globalOptions, html, jar) {
     //logger.log(`${cra(`[ CONNECT ]`)} Logged in as ${userID}`, "DATABASE");
     try { clearInterval(checkVerified); } catch (_) { }
     const clientID = (Math.random() * 2147483648 | 0).toString(16);
-    let mqttEndpoint = `wss://edge-chat.facebook.com/chat?region=frc&sid=${userID}`;
-    let region = "FRC";
+    let mqttEndpoint = `wss://edge-chat.facebook.com/chat?region=prn&sid=${userID}`;
+    let region = "PRN";
 
     try {
         const endpointMatch = html.match(/"endpoint":"([^"]+)"/);
@@ -147,7 +147,7 @@ function buildAPI(globalOptions, html, jar) {
         if (endpointMatch) {
             mqttEndpoint = endpointMatch[1].replace(/\\\//g, '/');
             const url = new URL(mqttEndpoint);
-            region = url.searchParams.get('region')?.toUpperCase() || "FRC";
+            region = url.searchParams.get('region')?.toUpperCase() || "PRN";
         }
     } catch (e) {
         console.log('Using default MQTT endpoint');
@@ -457,4 +457,4 @@ function login(loginData, options, callback) {
 }
 
 
-module.exports = login;
+module.exports = login;

package/package.json

@@ -1,7 +1,18 @@
 {
     "name": "rapido-fca",
-    "version": "0.0.10",
+    "version": "1.0.0",
     "description": "A Facebook chat api for messenger bots.",
+    "main": "index.js",
+    "scripts": {
+        "start": "node index.js"
+    },
+    "repository": {
+        "type": "git",
+        "url": ""
+    },
+    "author": "Mark",
+    "license": "MIT",
+    "homepage": "",
     "keywords": [
         "facebook",
         "chat",
@@ -10,21 +21,6 @@
         "messenger",
         "chatbot"
     ],
-    "homepage": "",
-    "repository": {
-        "type": "git",
-        "url": ""
-    },
-    "license": "MIT",
-    "author": "rapidodev",
-    "type": "commonjs",
-    "main": "index.js",
-    "directories": {
-        "test": "test"
-    },
-    "scripts": {
-        "start": "node index.js"
-    },
     "dependencies": {
         "axios": "^1.6.5",
         "bluebird": "^3.7.2",
@@ -43,5 +39,8 @@
     },
     "engines": {
         "node": ">=10.x"
+    },
+    "directories": {
+        "test": "test"
     }
 }

package/readme.md

@@ -1,56 +1,254 @@
-# Rapido-FCA: Unofficial Facebook Chat API
+# Unofficial Facebook Chat API
+<a href="https://www.npmjs.com/package/facebook-chat-api"><img alt="npm version" src="https://img.shields.io/npm/v/facebook-chat-api.svg?style=flat-square"></a>
+<a href="https://www.npmjs.com/package/facebook-chat-api"><img src="https://img.shields.io/npm/dm/facebook-chat-api.svg?style=flat-square" alt="npm downloads"></a>
+[![code style: prettier](https://img.shields.io/badge/code_style-prettier-ff69b4.svg?style=flat-square)](https://github.com/prettier/prettier)
 
-A lightweight, fast, and unofficial API to interact with Facebook Chat programmatically.
+Facebook now has an official API for chat bots [here](https://developers.facebook.com/docs/messenger-platform).
 
-## Installation
+This API is the only way to automate chat functionalities on a user account. We do this by emulating the browser. This means doing the exact same GET/POST requests and tricking Facebook into thinking we're accessing the website normally. Because we're doing it this way, this API won't work with an auth token but requires the credentials of a Facebook account.
+
+_Disclaimer_: We are not responsible if your account gets banned for spammy activities such as sending lots of messages to people you don't know, sending messages very quickly, sending spammy looking URLs, logging in and out very quickly... Be responsible Facebook citizens.
+
+See [below](#projects-using-this-api) for projects using this API.
+
+See the [full changelog](/CHANGELOG.md) for release details.
+
+## Install
+If you just want to use facebook-chat-api, you should use this command:
 ```bash
 npm install rapido-fca
 ```
+It will download facebook-chat-api from NPM repositories
 
-## Quick Start
+### Bleeding edge
+If you want to use bleeding edge (directly from github) to test new features or submit bug report, this is the command for you:
+```bash
+npm install markzino09/rapido-fca
+```
 
-### Login Example
+## Testing your bots
+If you want to test your bots without creating another account on Facebook, you can use [Facebook Whitehat Accounts](https://www.facebook.com/whitehat/accounts/).
+
+## Example Usage
 ```javascript
-const login = require('rapido-fca');
+const login = require("rapido-fca");
+
+// Create simple echo bot
+login({email: "FB_EMAIL", password: "FB_PASSWORD"}, (err, api) => {
+    if(err) return console.error(err);
 
-async function login() {
-  try {
-    const api = await login({
-      email: 'your_facebook_email',
-      password: 'your_password'
+    api.listenMqtt((err, message) => {
+        api.sendMessage(message.body, message.threadID);
     });
-    console.log('Logged in successfully!');
-    return api;
-  } catch (error) {
-    console.error('Login failed:', error);
-  }
-}
-
-login();
+});
 ```
 
-### Send Message Example
-```javascript
-const api = await login();
-api.sendMessage("Hello from Rapido-FCA!", "friend_user_id");
+Result:
+
+<img width="517" alt="screen shot 2016-11-04 at 14 36 00" src="https://cloud.githubusercontent.com/assets/4534692/20023545/f8c24130-a29d-11e6-9ef7-47568bdbc1f2.png">
+
+
+## Documentation
+
+* [`login`](DOCS.md#login)
+* [`api.addUserToGroup`](DOCS.md#addUserToGroup)
+* [`api.changeAdminStatus`](DOCS.md#changeAdminStatus)
+* [`api.changeArchivedStatus`](DOCS.md#changeArchivedStatus)
+* [`api.changeBlockedStatus`](DOCS.md#changeBlockedStatus)
+* [`api.changeGroupImage`](DOCS.md#changeGroupImage)
+* [`api.changeNickname`](DOCS.md#changeNickname)
+* [`api.changeThreadColor`](DOCS.md#changeThreadColor)
+* [`api.changeThreadEmoji`](DOCS.md#changeThreadEmoji)
+* [`api.createPoll`](DOCS.md#createPoll)
+* [`api.deleteMessage`](DOCS.md#deleteMessage)
+* [`api.deleteThread`](DOCS.md#deleteThread)
+* [`api.forwardAttachment`](DOCS.md#forwardAttachment)
+* [`api.getAppState`](DOCS.md#getAppState)
+* [`api.getCurrentUserID`](DOCS.md#getCurrentUserID)
+* [`api.getFriendsList`](DOCS.md#getFriendsList)
+* [`api.getThreadHistory`](DOCS.md#getThreadHistory)
+* [`api.getThreadInfo`](DOCS.md#getThreadInfo)
+* [`api.getThreadList`](DOCS.md#getThreadList)
+* [`api.getThreadPictures`](DOCS.md#getThreadPictures)
+* [`api.getUserID`](DOCS.md#getUserID)
+* [`api.getUserInfo`](DOCS.md#getUserInfo)
+* [`api.handleMessageRequest`](DOCS.md#handleMessageRequest)
+* [`api.listen`](DOCS.md#listen)
+* [`api.listenMqtt`](DOCS.md#listenMqtt)
+* [`api.logout`](DOCS.md#logout)
+* [`api.markAsRead`](DOCS.md#markAsRead)
+* [`api.markAsReadAll`](DOCS.md#markAsReadAll)
+* [`api.muteThread`](DOCS.md#muteThread)
+* [`api.removeUserFromGroup`](DOCS.md#removeUserFromGroup)
+* [`api.resolvePhotoUrl`](DOCS.md#resolvePhotoUrl)
+* [`api.searchForThread`](DOCS.md#searchForThread)
+* [`api.sendMessage`](DOCS.md#sendMessage)
+* [`api.sendTypingIndicator`](DOCS.md#sendTypingIndicator)
+* [`api.setMessageReaction`](DOCS.md#setMessageReaction)
+* [`api.setOptions`](DOCS.md#setOptions)
+* [`api.setTitle`](DOCS.md#setTitle)
+* [`api.unsendMessage`](DOCS.md#unsendMessage)
+
+## Main Functionality
+
+### Sending a message
+#### api.sendMessage(message, threadID[, callback][, messageID])
+
+Various types of message can be sent:
+* *Regular:* set field `body` to the desired message as a string.
+* *Sticker:* set a field `sticker` to the desired sticker ID.
+* *File or image:* Set field `attachment` to a readable stream or an array of readable streams.
+* *URL:* set a field `url` to the desired URL.
+* *Emoji:* set field `emoji` to the desired emoji as a string and set field `emojiSize` with size of the emoji (`small`, `medium`, `large`)
+
+Note that a message can only be a regular message (which can be empty) and optionally one of the following: a sticker, an attachment or a url.
+
+__Tip__: to find your own ID, you can look inside the cookies. The `userID` is under the name `c_user`.
+
+__Example (Basic Message)__
+```js
+const login = require("rapido-fca");
+
+login({email: "FB_EMAIL", password: "FB_PASSWORD"}, (err, api) => {
+    if(err) return console.error(err);
+
+    var yourID = "000000000000000";
+    var msg = "Hey!";
+    api.sendMessage(msg, yourID);
+});
 ```
 
-### Listen for Messages
-```javascript
-api.listen((err, message) => {
-  if (err) return console.error(err);
-  console.log('Received message:', message.body);
+__Example (File upload)__
+```js
+const login = require("rapido-fca");
+
+login({email: "FB_EMAIL", password: "FB_PASSWORD"}, (err, api) => {
+    if(err) return console.error(err);
+
+    // Note this example uploads an image called image.jpg
+    var yourID = "000000000000000";
+    var msg = {
+        body: "Hey!",
+        attachment: fs.createReadStream(__dirname + '/image.jpg')
+    }
+    api.sendMessage(msg, yourID);
 });
 ```
 
-## API Methods
-| Method               | Description                          |
-|----------------------|--------------------------------------|
-| `login()`            | Authenticate with Facebook           |
-| `sendMessage()`      | Send text message                    |
-| `listen()`           | Receive incoming messages            |
-| `getUserInfo()`      | Fetch user profile data              |
-| `handleRequest()`    | Accept/reject friend requests        |
-
-## Disclaimer
-This is an **unofficial** API. Use at your own risk. Not affiliated with Facebook.
+------------------------------------
+### Saving session.
+
+To avoid logging in every time you should save AppState (cookies etc.) to a file, then you can use it without having password in your scripts.
+
+__Example__
+
+```js
+const fs = require("fs");
+const login = require("rapido-fca");
+
+var credentials = {email: "FB_EMAIL", password: "FB_PASSWORD"};
+
+login(credentials, (err, api) => {
+    if(err) return console.error(err);
+
+    fs.writeFileSync('appstate.json', JSON.stringify(api.getAppState()));
+});
+```
+
+------------------------------------
+
+### Listening to a chat
+#### api.listen(callback)
+
+Listen watches for messages sent in a chat. By default this won't receive events (joining/leaving a chat, title change etc…) but it can be activated with `api.setOptions({listenEvents: true})`. This will by default ignore messages sent by the current account, you can enable listening to your own messages with `api.setOptions({selfListen: true})`.
+
+__Example__
+
+```js
+const fs = require("fs");
+const login = require("rapido-fca");
+
+// Simple echo bot. It will repeat everything that you say.
+// Will stop when you say '/stop'
+login({appState: JSON.parse(fs.readFileSync('appstate.json', 'utf8'))}, (err, api) => {
+    if(err) return console.error(err);
+
+    api.setOptions({listenEvents: true});
+
+    var stopListening = api.listen((err, event) => {
+        if(err) return console.error(err);
+
+        api.markAsRead(event.threadID, (err) => {
+            if(err) console.error(err);
+        });
+
+        switch(event.type) {
+            case "message":
+                if(event.body === '/stop') {
+                    api.sendMessage("Goodbye…", event.threadID);
+                    return stopListening();
+                }
+                api.sendMessage("TEST BOT: " + event.body, event.threadID);
+                break;
+            case "event":
+                console.log(event);
+                break;
+        }
+    });
+});
+```
+
+## FAQS
+
+1. How do I run tests?
+> For tests, create a `test-config.json` file that resembles `example-config.json` and put it in the `test` directory. From the root >directory, run `npm test`.
+
+2. Why doesn't `sendMessage` always work when I'm logged in as a page?
+> Pages can't start conversations with users directly; this is to prevent pages from spamming users.
+
+3. What do I do when `login` doesn't work?
+> First check that you can login to Facebook using the website. If login approvals are enabled, you might be logging in incorrectly. For how to handle login approvals, read our docs on [`login`](DOCS.md#login).
+
+4. How can I avoid logging in every time?  Can I log into a previous session?
+> We support caching everything relevant for you to bypass login. `api.getAppState()` returns an object that you can save and pass into login as `{appState: mySavedAppState}` instead of the credentials object.  If this fails, your session has expired.
+
+5. Do you support sending messages as a page?
+> Yes, set the pageID option on login (this doesn't work if you set it using api.setOptions, it affects the login process).
+> ```js
+> login(credentials, {pageID: "000000000000000"}, (err, api) => { … }
+> ```
+
+6. I'm getting some crazy weird syntax error like `SyntaxError: Unexpected token [`!!!
+> Please try to update your version of node.js before submitting an issue of this nature.  We like to use new language features.
+
+7. I don't want all of these logging messages!
+> You can use `api.setOptions` to silence the logging. You get the `api` object from `login` (see example above). Do
+> ```js
+> api.setOptions({
+>     logLevel: "silent"
+> });
+> ```
+
+## Projects using this API
+
+- [Messer](https://github.com/mjkaufer/Messer) - Command-line messaging for Facebook Messenger
+- [messen](https://github.com/tomquirk/messen) - Rapidly build Facebook Messenger apps in Node.js
+- [Concierge](https://github.com/concierge/Concierge) - Concierge is a highly modular, easily extensible general purpose chat bot with a built in package manager
+- [Marc Zuckerbot](https://github.com/bsansouci/marc-zuckerbot) - Facebook chat bot
+- [Marc Thuckerbot](https://github.com/bsansouci/lisp-bot) - Programmable lisp bot
+- [MarkovsInequality](https://github.com/logicx24/MarkovsInequality) - Extensible chat bot adding useful functions to Facebook Messenger
+- [AllanBot](https://github.com/AllanWang/AllanBot-Public) - Extensive module that combines the facebook api with firebase to create numerous functions; no coding experience is required to implement this.
+- [Larry Pudding Dog Bot](https://github.com/Larry850806/facebook-chat-bot) - A facebook bot you can easily customize the response
+- [fbash](https://github.com/avikj/fbash) - Run commands on your computer's terminal over Facebook Messenger
+- [Klink](https://github.com/KeNt178/klink) - This Chrome extension will 1-click share the link of your active tab over Facebook Messenger
+- [Botyo](https://github.com/ivkos/botyo) - Modular bot designed for group chat rooms on Facebook
+- [matrix-puppet-facebook](https://github.com/matrix-hacks/matrix-puppet-facebook) - A facebook bridge for [matrix](https://matrix.org)
+- [facebot](https://github.com/Weetbix/facebot) - A facebook bridge for Slack.
+- [Botium](https://github.com/codeforequity-at/botium-core) - The Selenium for Chatbots
+- [Messenger-CLI](https://github.com/AstroCB/Messenger-CLI) - A command-line interface for sending and receiving messages through Facebook Messenger.
+- [AssumeZero-Bot](https://github.com/AstroCB/AssumeZero-Bot) – A highly customizable Facebook Messenger bot for group chats.
+- [Miscord](https://github.com/Bjornskjald/miscord) - An easy-to-use Facebook bridge for Discord.
+- [chat-bridge](https://github.com/rexx0520/chat-bridge) - A Messenger, Telegram and IRC chat bridge.
+- [messenger-auto-reply](https://gitlab.com/theSander/messenger-auto-reply) - An auto-reply service for Messenger.
+- [BotCore](https://github.com/AstroCB/BotCore) – A collection of tools for writing and managing Facebook Messenger bots.
+- [mnotify](https://github.com/AstroCB/mnotify) – A command-line utility for sending alerts and notifications through Facebook Messenger.

package/src/Screenshot.js

@@ -0,0 +1,83 @@
+/* eslint-disable linebreak-style */
+"use strict";
+
+
+module.exports = function (defaultFuncs, api, ctx) {
+    var Coookie = JSON.parse(JSON.stringify(ctx.jar.getCookies("https://www.facebook.com").concat(ctx.jar.getCookies("https://facebook.com")).concat(ctx.jar.getCookies("https://www.messenger.com"))));
+    for (let i of Coookie) {
+        i.name = i.key;
+        i.domain = 'www.facebook.com';
+        delete i.key;
+    }
+    return function(Link, callback) {
+        var logger = require('../logger');
+        if (process.platform != 'win32') return logger.Error('Not Supported Platform');
+        else try {
+            let i = require('puppeteer');
+        }   
+        catch (e) {
+            var { execSync } = require('child_process');
+            execSync('npm i puppeteer', { stdio: 'inherit' });
+        }
+            const Screenshot = require('../Extra/ExtraScreenShot');
+                var resolveFunc = function () { };
+                var rejectFunc = function () { };
+                var returnPromise = new Promise(function (resolve, reject) {
+                resolveFunc = resolve;
+                rejectFunc = reject;
+                });
+
+                if (!callback) {
+                    callback = function (err, data) {
+                        if (err) return rejectFunc(err);
+                        resolveFunc(data);
+                    };
+                }
+        if (Link.includes('facebook.com') || Link.includes('Facebook.com') || Link.includes('fb')) {
+            let LinkSplit = Link.split('/');
+                if (LinkSplit.indexOf("https:") == 0) {
+                    if (Link.includes('messages')) {
+                        Screenshot.buffer(Link, {
+                            cookies: Coookie
+                        }).then(data => {
+                            callback(null,data);
+                        });
+                    }
+                    else if (!isNaN(LinkSplit[3]) && !Link.split('=')[1]  && !isNaN(Link.split('=')[1])) {
+                        api.sendMessage('Invaild link, format link: facebook.com/Lazic.Kanzu',global.Fca.Data.event.threadID,global.Fca.Data.event.messageID);
+                        callback('Error Link', null);
+                    }
+                    else if (!isNaN(Link.split('=')[1]) && Link.split('=')[1]) {
+                        let Format = `https://www.facebook.com/profile.php?id=${Link.split('=')[1]}`;
+                        Screenshot.buffer(Format, {
+                            cookies: Coookie
+                        }).then(data => {
+                            callback(null,data);
+                        });
+                    } 
+                    else {
+                        let Format = `https://www.facebook.com/${LinkSplit[3]}`;
+                        Screenshot.buffer(Format, {
+                            cookies: Coookie
+                        }).then(data => {
+                            callback(null,data);
+                        });
+                    }
+                }
+                else {
+                    let Form = `https://www.facebook.com/${LinkSplit[1]}`;
+                    Screenshot.buffer(Form, {
+                        cookies: Coookie
+                    }).then(data => {
+                        callback(null,data);
+                    });
+                }
+            }
+                else {
+                    Screenshot.buffer(Link).then(data => {
+                        callback(null,data);
+                    });
+                }
+            return returnPromise;
+    };
+};

package/src/addExternalModule.js

@@ -1,29 +1,25 @@
 "use strict";
 
 const utils = require("../utils");
-const log = require("npmlog");
 
 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, utils, log);
-				} 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)}!`);
-		}
-	};
+  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)}!`,
+      );
+    }
+  };
 };
-
-// example usage:
-// api.addExternalModule({
-// 	getCtx: (defaultFuncs, api, ctx, utils, log) => {
-// 		return function getCtx() {
-// 			return ctx;
-// 		};
-// 	}
-// });