surya-sahil-fca 1.0.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/CHANGELOG.md +175 -0
- package/DOCS.md +2636 -0
- package/LICENSE-MIT +21 -0
- package/README.md +107 -0
- package/func/checkUpdate.js +222 -0
- package/func/logger.js +48 -0
- package/index.d.ts +746 -0
- package/index.js +8 -0
- package/module/config.js +34 -0
- package/module/login.js +126 -0
- package/module/loginHelper.js +747 -0
- package/module/options.js +45 -0
- package/package.json +82 -0
- package/src/api/messaging/changeGroupImage.js +90 -0
- package/src/api/messaging/changeNickname.js +70 -0
- package/src/api/messaging/changeThreadName.js +123 -0
- package/src/api/messaging/createCommentPost.js +207 -0
- package/src/api/messaging/sendMessage.js +272 -0
- package/src/api/messaging/sendTypingIndicator.js +67 -0
- package/src/api/messaging/setMessageReaction.js +76 -0
- package/src/api/messaging/setTitle.js +119 -0
- package/src/api/messaging/stickers.js +257 -0
- package/src/core/sendReqMqtt.js +96 -0
- package/src/database/models/index.js +49 -0
- package/src/database/models/thread.js +31 -0
- package/src/database/models/user.js +32 -0
- package/src/database/threadData.js +98 -0
- package/src/database/userData.js +89 -0
- package/src/utils/client.js +320 -0
- package/src/utils/constants.js +23 -0
- package/src/utils/format.js +1115 -0
- package/src/utils/headers.js +115 -0
- package/src/utils/request.js +305 -0
package/LICENSE-MIT
ADDED
|
@@ -0,0 +1,21 @@
|
|
|
1
|
+
MIT License
|
|
2
|
+
|
|
3
|
+
Copyright (c) 2025 DongDev
|
|
4
|
+
|
|
5
|
+
Permission is hereby granted, free of charge, to any person obtaining a copy
|
|
6
|
+
of this software and associated documentation files (the "Software"), to deal
|
|
7
|
+
in the Software without restriction, including without limitation the rights
|
|
8
|
+
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
|
|
9
|
+
copies of the Software, and to permit persons to whom the Software is
|
|
10
|
+
furnished to do so, subject to the following conditions:
|
|
11
|
+
|
|
12
|
+
The above copyright notice and this permission notice shall be included in all
|
|
13
|
+
copies or substantial portions of the Software.
|
|
14
|
+
|
|
15
|
+
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
|
|
16
|
+
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
|
|
17
|
+
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
|
|
18
|
+
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
|
|
19
|
+
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
|
|
20
|
+
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
|
|
21
|
+
SOFTWARE.
|
package/README.md
ADDED
|
@@ -0,0 +1,107 @@
|
|
|
1
|
+
# surya-sahil-fca
|
|
2
|
+
|
|
3
|
+
**Streamlined Facebook Chat API for Node.js** - Essential features only
|
|
4
|
+
|
|
5
|
+
## Features
|
|
6
|
+
|
|
7
|
+
- ✅ **Message Sending** - Send text messages and attachments
|
|
8
|
+
- ✅ **Typing Indicator** - Show typing status
|
|
9
|
+
- ✅ **Message Reactions** - React to messages
|
|
10
|
+
- ✅ **Group Management** - Change group name and image
|
|
11
|
+
- ✅ **Nickname Management** - Change user nicknames
|
|
12
|
+
- ✅ **Post Comments** - Comment on Facebook posts
|
|
13
|
+
- ✅ **Stickers** - Full sticker API support
|
|
14
|
+
- ✅ **Cookie Login** - Login using cookies (automatically converted to appState)
|
|
15
|
+
|
|
16
|
+
## Installation
|
|
17
|
+
|
|
18
|
+
```bash
|
|
19
|
+
npm install surya-sahil-fca
|
|
20
|
+
```
|
|
21
|
+
|
|
22
|
+
## Quick Start
|
|
23
|
+
|
|
24
|
+
### Login with Cookies
|
|
25
|
+
|
|
26
|
+
```javascript
|
|
27
|
+
const login = require("surya-sahil-fca");
|
|
28
|
+
|
|
29
|
+
// You can pass cookies as a string
|
|
30
|
+
const cookieString = "datr=xxx; sb=xxx; c_user=xxx; xs=xxx";
|
|
31
|
+
|
|
32
|
+
login({ Cookie: cookieString }, (err, api) => {
|
|
33
|
+
if (err) return console.error(err);
|
|
34
|
+
|
|
35
|
+
api.sendMessage("Hello!", "THREAD_ID");
|
|
36
|
+
});
|
|
37
|
+
```
|
|
38
|
+
|
|
39
|
+
### Login with AppState
|
|
40
|
+
|
|
41
|
+
```javascript
|
|
42
|
+
const login = require("surya-sahil-fca");
|
|
43
|
+
const fs = require("fs");
|
|
44
|
+
|
|
45
|
+
login({ appState: JSON.parse(fs.readFileSync("appstate.json", "utf8")) }, (err, api) => {
|
|
46
|
+
if (err) return console.error(err);
|
|
47
|
+
|
|
48
|
+
api.listenMqtt((err, event) => {
|
|
49
|
+
if (err) return console.error(err);
|
|
50
|
+
|
|
51
|
+
if (event.type === "message") {
|
|
52
|
+
api.sendMessage(`Echo: ${event.body}`, event.threadID);
|
|
53
|
+
}
|
|
54
|
+
});
|
|
55
|
+
});
|
|
56
|
+
```
|
|
57
|
+
|
|
58
|
+
## Available Methods
|
|
59
|
+
|
|
60
|
+
### Messaging
|
|
61
|
+
- `sendMessage(message, threadID, callback)` - Send messages
|
|
62
|
+
- `sendTypingIndicator(threadID, isTyping, callback)` - Show typing indicator
|
|
63
|
+
- `setMessageReaction(reaction, messageID, callback)` - React to messages
|
|
64
|
+
|
|
65
|
+
### Group Management
|
|
66
|
+
- `changeGroupImage(image, threadID, callback)` - Change group image
|
|
67
|
+
- `setTitle(title, threadID, callback)` - Change group name (alias: changeThreadName)
|
|
68
|
+
- `changeThreadName(newName, threadID, callback)` - Change group name via MQTT
|
|
69
|
+
|
|
70
|
+
### User Management
|
|
71
|
+
- `changeNickname(nickname, userID, threadID, callback)` - Change user nickname
|
|
72
|
+
|
|
73
|
+
### Posts & Comments
|
|
74
|
+
- `createCommentPost(message, postID, replyCommentID, callback)` - Comment on posts
|
|
75
|
+
|
|
76
|
+
### Stickers
|
|
77
|
+
- `stickers.search(query)` - Search for stickers
|
|
78
|
+
- `stickers.listPacks()` - List user's sticker packs
|
|
79
|
+
- `stickers.getStorePacks()` - Get all store packs
|
|
80
|
+
- `stickers.addPack(packID)` - Add a sticker pack
|
|
81
|
+
- `stickers.getStickersInPack(packID)` - Get stickers in a pack
|
|
82
|
+
- `stickers.getAiStickers()` - Get AI-generated stickers
|
|
83
|
+
|
|
84
|
+
### Listening
|
|
85
|
+
- `listenMqtt(callback)` - Listen for messages and events
|
|
86
|
+
|
|
87
|
+
## Cookie to AppState Conversion
|
|
88
|
+
|
|
89
|
+
This module automatically converts cookie strings to appState format. You can pass cookies in any of these formats:
|
|
90
|
+
|
|
91
|
+
```javascript
|
|
92
|
+
// Raw cookie string
|
|
93
|
+
const cookies = "datr=xxx; sb=xxx; c_user=xxx; xs=xxx";
|
|
94
|
+
|
|
95
|
+
// The module will automatically convert it to appState format
|
|
96
|
+
login({ Cookie: cookies }, (err, api) => {
|
|
97
|
+
// ...
|
|
98
|
+
});
|
|
99
|
+
```
|
|
100
|
+
|
|
101
|
+
## License
|
|
102
|
+
|
|
103
|
+
MIT
|
|
104
|
+
|
|
105
|
+
## Author
|
|
106
|
+
|
|
107
|
+
Surya Sahil
|
|
@@ -0,0 +1,222 @@
|
|
|
1
|
+
const logger = require("./logger");
|
|
2
|
+
const fs = require("fs");
|
|
3
|
+
const path = require("path");
|
|
4
|
+
const { exec } = require("child_process");
|
|
5
|
+
const https = require("https");
|
|
6
|
+
const pkgName = "surya-sahil-fca";
|
|
7
|
+
|
|
8
|
+
let axios = null;
|
|
9
|
+
try {
|
|
10
|
+
axios = require("axios");
|
|
11
|
+
} catch (e) {
|
|
12
|
+
}
|
|
13
|
+
|
|
14
|
+
const TEMP_DIR = path.join(process.cwd(), "temp");
|
|
15
|
+
const LOCK_FILE = path.join(TEMP_DIR, ".fca-update-lock.json");
|
|
16
|
+
const RESTART_COOLDOWN_MS = 10 * 60 * 1000;
|
|
17
|
+
|
|
18
|
+
function execPromise(cmd) {
|
|
19
|
+
return new Promise((resolve, reject) => {
|
|
20
|
+
exec(cmd, { cwd: process.cwd() }, (error, stdout, stderr) => {
|
|
21
|
+
if (error) return reject({ error, stderr });
|
|
22
|
+
resolve({ stdout, stderr });
|
|
23
|
+
});
|
|
24
|
+
});
|
|
25
|
+
}
|
|
26
|
+
|
|
27
|
+
function ensureTemp() {
|
|
28
|
+
try { fs.mkdirSync(TEMP_DIR, { recursive: true }); } catch { }
|
|
29
|
+
}
|
|
30
|
+
|
|
31
|
+
function readLock() {
|
|
32
|
+
try { return JSON.parse(fs.readFileSync(LOCK_FILE, "utf8")); } catch { return null; }
|
|
33
|
+
}
|
|
34
|
+
|
|
35
|
+
function writeLock(data) {
|
|
36
|
+
ensureTemp();
|
|
37
|
+
try { fs.writeFileSync(LOCK_FILE, JSON.stringify(data)); } catch { }
|
|
38
|
+
}
|
|
39
|
+
|
|
40
|
+
function clearLock() {
|
|
41
|
+
try { fs.unlinkSync(LOCK_FILE); } catch { }
|
|
42
|
+
}
|
|
43
|
+
|
|
44
|
+
function getInstalledVersion() {
|
|
45
|
+
try {
|
|
46
|
+
const p = require.resolve(`${pkgName}/package.json`, { paths: [process.cwd(), __dirname] });
|
|
47
|
+
return JSON.parse(fs.readFileSync(p, "utf8")).version;
|
|
48
|
+
} catch {
|
|
49
|
+
return null;
|
|
50
|
+
}
|
|
51
|
+
}
|
|
52
|
+
|
|
53
|
+
async function getInstalledVersionByNpm() {
|
|
54
|
+
try {
|
|
55
|
+
const { stdout } = await execPromise(`npm ls ${pkgName} --json --depth=0`);
|
|
56
|
+
const json = JSON.parse(stdout || "{}");
|
|
57
|
+
const v = (json && json.dependencies && json.dependencies[pkgName] && json.dependencies[pkgName].version) || null;
|
|
58
|
+
return v;
|
|
59
|
+
} catch {
|
|
60
|
+
return null;
|
|
61
|
+
}
|
|
62
|
+
}
|
|
63
|
+
|
|
64
|
+
async function getLatestVersionFromNpmRegistry() {
|
|
65
|
+
const url = `https://registry.npmjs.org/${pkgName}/latest`;
|
|
66
|
+
|
|
67
|
+
if (axios) {
|
|
68
|
+
try {
|
|
69
|
+
const response = await axios.get(url, {
|
|
70
|
+
timeout: 10000,
|
|
71
|
+
headers: {
|
|
72
|
+
'User-Agent': 'fca-unofficial-updater',
|
|
73
|
+
'Accept': 'application/json'
|
|
74
|
+
}
|
|
75
|
+
});
|
|
76
|
+
if (response && response.data && response.data.version) {
|
|
77
|
+
return response.data.version;
|
|
78
|
+
}
|
|
79
|
+
throw new Error("Invalid response from npm registry");
|
|
80
|
+
} catch (error) {
|
|
81
|
+
if (error.code === 'ECONNABORTED' || error.code === 'ETIMEDOUT') {
|
|
82
|
+
throw new Error("Request timeout");
|
|
83
|
+
}
|
|
84
|
+
throw error;
|
|
85
|
+
}
|
|
86
|
+
}
|
|
87
|
+
return new Promise((resolve, reject) => {
|
|
88
|
+
const timeout = setTimeout(() => {
|
|
89
|
+
reject(new Error("Request timeout"));
|
|
90
|
+
}, 10000);
|
|
91
|
+
|
|
92
|
+
https.get(url, {
|
|
93
|
+
headers: {
|
|
94
|
+
'User-Agent': 'fca-unofficial-updater',
|
|
95
|
+
'Accept': 'application/json'
|
|
96
|
+
}
|
|
97
|
+
}, (res) => {
|
|
98
|
+
let data = "";
|
|
99
|
+
res.on("data", (chunk) => { data += chunk; });
|
|
100
|
+
res.on("end", () => {
|
|
101
|
+
clearTimeout(timeout);
|
|
102
|
+
try {
|
|
103
|
+
const json = JSON.parse(data);
|
|
104
|
+
if (json && json.version) {
|
|
105
|
+
resolve(json.version);
|
|
106
|
+
} else {
|
|
107
|
+
reject(new Error("Invalid response from npm registry"));
|
|
108
|
+
}
|
|
109
|
+
} catch (e) {
|
|
110
|
+
reject(e);
|
|
111
|
+
}
|
|
112
|
+
});
|
|
113
|
+
}).on("error", (err) => {
|
|
114
|
+
clearTimeout(timeout);
|
|
115
|
+
reject(err);
|
|
116
|
+
});
|
|
117
|
+
});
|
|
118
|
+
}
|
|
119
|
+
|
|
120
|
+
async function getLatestVersion() {
|
|
121
|
+
const nodeVersion = process.version;
|
|
122
|
+
const nodeMajor = parseInt(nodeVersion.split('.')[0].substring(1), 10);
|
|
123
|
+
|
|
124
|
+
const shouldUseNpmCommand = nodeMajor >= 12 && nodeMajor < 20;
|
|
125
|
+
|
|
126
|
+
if (shouldUseNpmCommand) {
|
|
127
|
+
try {
|
|
128
|
+
const { stdout } = await execPromise(`npm view ${pkgName} version`);
|
|
129
|
+
const version = stdout.trim();
|
|
130
|
+
if (version && version.length > 0) {
|
|
131
|
+
return version;
|
|
132
|
+
}
|
|
133
|
+
} catch (npmError) {
|
|
134
|
+
const errorMsg = npmError.error && npmError.error.message ? npmError.error.message : String(npmError);
|
|
135
|
+
if (errorMsg.includes("npm") && errorMsg.includes("not to run")) {
|
|
136
|
+
logger("npm version incompatible, using registry API instead", "warn");
|
|
137
|
+
} else {
|
|
138
|
+
logger("npm view failed, using registry API instead", "warn");
|
|
139
|
+
}
|
|
140
|
+
}
|
|
141
|
+
} else {
|
|
142
|
+
logger("Using npm registry API (bypassing npm command)", "info");
|
|
143
|
+
}
|
|
144
|
+
try {
|
|
145
|
+
const version = await getLatestVersionFromNpmRegistry();
|
|
146
|
+
return version;
|
|
147
|
+
} catch (httpError) {
|
|
148
|
+
const errorMsg = httpError && httpError.message ? httpError.message : String(httpError);
|
|
149
|
+
logger(`Failed to get latest version: ${errorMsg}`, "error");
|
|
150
|
+
throw new Error("Cannot check for updates: npm command failed and registry API unavailable");
|
|
151
|
+
}
|
|
152
|
+
}
|
|
153
|
+
|
|
154
|
+
async function _checkAndUpdateVersionImpl() {
|
|
155
|
+
const lock = readLock();
|
|
156
|
+
if (lock && Date.now() - (lock.ts || 0) < RESTART_COOLDOWN_MS) {
|
|
157
|
+
logger("Skip auto-update due to recent attempt", "info");
|
|
158
|
+
return;
|
|
159
|
+
}
|
|
160
|
+
|
|
161
|
+
logger("Checking version...", "info");
|
|
162
|
+
let latest;
|
|
163
|
+
try {
|
|
164
|
+
latest = await getLatestVersion();
|
|
165
|
+
} catch (error) {
|
|
166
|
+
logger(`Cannot check for updates: ${error.message || error}. Skipping version check.`, "warn");
|
|
167
|
+
return;
|
|
168
|
+
}
|
|
169
|
+
|
|
170
|
+
let installed = getInstalledVersion();
|
|
171
|
+
if (!installed) installed = await getInstalledVersionByNpm();
|
|
172
|
+
|
|
173
|
+
if (installed && installed === latest) {
|
|
174
|
+
clearLock();
|
|
175
|
+
logger(`You're already on the latest version - ${latest}`, "info");
|
|
176
|
+
return;
|
|
177
|
+
}
|
|
178
|
+
|
|
179
|
+
if (lock && lock.latest === latest && Date.now() - (lock.ts || 0) < RESTART_COOLDOWN_MS) {
|
|
180
|
+
logger("Update already attempted recently, skipping restart loop", "info");
|
|
181
|
+
return;
|
|
182
|
+
}
|
|
183
|
+
|
|
184
|
+
logger(`New version available (${latest}). Current version (${installed || "not installed"}). Updating...`, "info");
|
|
185
|
+
|
|
186
|
+
try {
|
|
187
|
+
const { stderr } = await execPromise(`npm i ${pkgName}@latest`);
|
|
188
|
+
if (stderr) logger(stderr, "error");
|
|
189
|
+
} catch (e) {
|
|
190
|
+
logger(`Error running npm install: ${e.error || e}. Trying to install from GitHub...`, "error");
|
|
191
|
+
try {
|
|
192
|
+
const { stderr } = await execPromise("npm i https://github.com/surya-sahil/fca-unofficial");
|
|
193
|
+
if (stderr) logger(stderr, "error");
|
|
194
|
+
} catch (gitErr) {
|
|
195
|
+
writeLock({ ts: Date.now(), latest, status: "failed" });
|
|
196
|
+
logger(`Error installing from GitHub: ${gitErr.error || gitErr}`, "error");
|
|
197
|
+
throw (gitErr.error || gitErr);
|
|
198
|
+
}
|
|
199
|
+
}
|
|
200
|
+
|
|
201
|
+
let after = getInstalledVersion();
|
|
202
|
+
if (!after) after = await getInstalledVersionByNpm();
|
|
203
|
+
|
|
204
|
+
if (after && after === latest) {
|
|
205
|
+
writeLock({ ts: Date.now(), latest, status: "updated" });
|
|
206
|
+
logger(`Updated fca to the latest version: ${latest}, Restart to apply`, "info");
|
|
207
|
+
process.exit(1);
|
|
208
|
+
} else {
|
|
209
|
+
writeLock({ ts: Date.now(), latest, status: "mismatch" });
|
|
210
|
+
logger(`Installed but version mismatch (have: ${after || "unknown"}, want: ${latest}). Skip restart to avoid loop`, "error");
|
|
211
|
+
}
|
|
212
|
+
}
|
|
213
|
+
|
|
214
|
+
function checkAndUpdateVersion(callback) {
|
|
215
|
+
if (typeof callback === "function") {
|
|
216
|
+
_checkAndUpdateVersionImpl().then(() => callback(null)).catch(err => callback(err));
|
|
217
|
+
return;
|
|
218
|
+
}
|
|
219
|
+
return _checkAndUpdateVersionImpl();
|
|
220
|
+
}
|
|
221
|
+
|
|
222
|
+
module.exports = { checkAndUpdateVersion };
|
package/func/logger.js
ADDED
|
@@ -0,0 +1,48 @@
|
|
|
1
|
+
const chalk = require("chalk");
|
|
2
|
+
const gradient = require("gradient-string");
|
|
3
|
+
|
|
4
|
+
const themes = [
|
|
5
|
+
"blue", "dream2", "dream", "fiery", "rainbow", "pastel", "cristal", "red", "aqua", "pink", "retro", "sunlight", "teen", "summer", "flower", "ghost", "hacker"
|
|
6
|
+
];
|
|
7
|
+
|
|
8
|
+
function buildGradient(name) {
|
|
9
|
+
const t = String(name || "").toLowerCase();
|
|
10
|
+
if (t === "blue") return gradient([{ color: "#1affa3", pos: 0.2 }, { color: "cyan", pos: 0.4 }, { color: "pink", pos: 0.6 }, { color: "cyan", pos: 0.8 }, { color: "#1affa3", pos: 1 }]);
|
|
11
|
+
if (t === "dream2") return gradient("blue", "pink");
|
|
12
|
+
if (t === "dream") return gradient([{ color: "blue", pos: 0.2 }, { color: "pink", pos: 0.3 }, { color: "gold", pos: 0.6 }, { color: "pink", pos: 0.8 }, { color: "blue", pos: 1 }]);
|
|
13
|
+
if (t === "fiery") return gradient("#fc2803", "#fc6f03", "#fcba03");
|
|
14
|
+
if (t === "rainbow") return gradient.rainbow;
|
|
15
|
+
if (t === "pastel") return gradient.pastel;
|
|
16
|
+
if (t === "cristal") return gradient.cristal;
|
|
17
|
+
if (t === "red") return gradient("red", "orange");
|
|
18
|
+
if (t === "aqua") return gradient("#0030ff", "#4e6cf2");
|
|
19
|
+
if (t === "pink") return gradient("#d94fff", "purple");
|
|
20
|
+
if (t === "retro") return gradient.retro;
|
|
21
|
+
if (t === "sunlight") return gradient("orange", "#ffff00", "#ffe600");
|
|
22
|
+
if (t === "teen") return gradient.teen;
|
|
23
|
+
if (t === "summer") return gradient.summer;
|
|
24
|
+
if (t === "flower") return gradient("blue", "purple", "yellow", "#81ff6e");
|
|
25
|
+
if (t === "ghost") return gradient.mind;
|
|
26
|
+
if (t === "hacker") return gradient("#47a127", "#0eed19", "#27f231");
|
|
27
|
+
return gradient("#243aff", "#4687f0", "#5800d4");
|
|
28
|
+
}
|
|
29
|
+
|
|
30
|
+
const themeName = themes[Math.floor(Math.random() * themes.length)];
|
|
31
|
+
const co = buildGradient(themeName);
|
|
32
|
+
|
|
33
|
+
module.exports = (text, type) => {
|
|
34
|
+
const s = String(type || "info").toLowerCase();
|
|
35
|
+
if (s === "warn") {
|
|
36
|
+
process.stderr.write(co(`\r[ FCA-WARN ] > ${text}`) + "\n");
|
|
37
|
+
return;
|
|
38
|
+
}
|
|
39
|
+
if (s === "error") {
|
|
40
|
+
process.stderr.write(chalk.bold.hex("#ff0000")(`\r[ FCA-ERROR ]`) + ` > ${text}\n`);
|
|
41
|
+
return;
|
|
42
|
+
}
|
|
43
|
+
if (s === "info") {
|
|
44
|
+
process.stderr.write(chalk.bold(co(`\r[ FCA-UNO ] > ${text}`)) + "\n");
|
|
45
|
+
return;
|
|
46
|
+
}
|
|
47
|
+
process.stderr.write(chalk.bold(co(`\r[ ${s.toUpperCase()} ] > ${text}`)) + "\n");
|
|
48
|
+
};
|