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/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
+ };