@dongdev/fca-unofficial 2.0.11 → 2.0.13

package/CHANGELOG.md

@@ -0,0 +1,76 @@
+# Changelog
+Too lazy to write changelog, sorry! (will write changelog in the next release, through.)
+## v1.0.10 - 2025-04-24
+- Hotfix / auto bump
+
+## v1.0.11 - 2025-04-24
+- Hotfix / auto bump
+
+## v1.0.12 - 2025-04-28
+- Hotfix / auto bump
+
+## v1.0.13 - 2025-04-28
+- Hotfix / auto bump
+
+## v1.0.14 - 2025-04-28
+- Hotfix / auto bump
+
+## v1.0.15 - 2025-05-03
+- Hotfix / auto bump
+
+## v1.0.16 - 2025-05-07
+- Hotfix / auto bump
+
+## v1.0.17 - 2025-05-07
+- Hotfix / auto bump
+
+## v1.0.18 - 2025-05-22
+- Hotfix / auto bump
+
+## v1.0.19 - 2025-05-23
+- Hotfix / auto bump
+
+## v2.0.0 - 2025-10-05
+- Hotfix / auto bump
+
+## v2.0.1 - 2025-10-05
+- Hotfix / auto bump
+
+## v2.0.2 - 2025-10-05
+- Hotfix / auto bump
+
+## v2.0.3 - 2025-10-05
+- Hotfix / auto bump
+
+## v2.0.4 - 2025-10-05
+- Hotfix / auto bump
+
+## v2.0.5 - 2025-10-06
+- Now you can turn on/off autoLogin in config file.
+- Added autoUpdate feature.
+## v2.0.6-beta - 2025-10-06
+- Hotfix / auto bump
+
+## v2.0.7 - 2025-10-06
+- Hotfix / auto bump
+
+## v2.0.8 - 2025-10-07
+- Hotfix / auto bump
+
+## v2.0.9 - 2025-10-07
+- Hotfix / auto bump
+
+## v2.0.9 - 2025-10-07
+- Hotfix / auto bump
+
+## v2.0.10 - 2025-10-07
+- Hotfix / auto bump
+
+## v2.0.10 - 2025-10-07
+- Hotfix / auto bump
+
+## v2.0.11 - 2025-10-07
+- Hotfix / auto bump
+
+## v2.0.12 - 2025-10-07
+- Hotfix / auto bump

package/LICENSE-MIT

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 DongDev (@dongdev/fca-unofficial)
+
+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/README.md

@@ -8,6 +8,7 @@
 ## ⚠️ Important 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
@@ -15,13 +16,14 @@
 
 **Recommendation:** Use Firefox browser or [this website](https://fca.dongdev.id.vn) to reduce logout issues, especially for iOS users.
 
-**Support:** If you encounter errors, contact us [here](https://www.facebook.com/minhdong.dev)
+**Support:** If you encounter errors, contact us [here](https://www.facebook.com/mdong.dev)
 
 ## 🔍 Introduction
 
 Facebook now has an [official API for chat bots](https://developers.facebook.com/docs/messenger-platform), however it's only available for Facebook Pages.
 
 `@dongdev/fca-unofficial` is the only API that allows you to automate chat functionalities on a **user account** by emulating the browser. This means:
+
 - Making the exact same GET/POST requests as a browser
 - Does not work with auth tokens
 - Requires Facebook account credentials (email/password) or AppState
@@ -109,13 +111,13 @@ login({ appState: [] }, (err, api) => {
 
 ## 📝 Message Types
 
-| Type             | Usage                                                           |
-| ---------------- | --------------------------------------------------------------- |
+| Type                   | Usage                                                             |
+| ---------------------- | ----------------------------------------------------------------- |
 | **Regular text** | `{ body: "message text" }`                                      |
 | **Sticker**      | `{ sticker: "sticker_id" }`                                     |
 | **File/Image**   | `{ attachment: fs.createReadStream(path) }` or array of streams |
 | **URL**          | `{ url: "https://example.com" }`                                |
-| **Large emoji**  | `{ emoji: "👍", emojiSize: "large" }` (small/medium/large)       |
+| **Large emoji**  | `{ emoji: "👍", emojiSize: "large" }` (small/medium/large)      |
 
 **Note:** 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.
 
@@ -228,6 +230,7 @@ api.setOptions({
 ```
 
 **By default:**
+
 - `listenEvents` is `false` - won't receive events like joining/leaving chat, title changes
 - `selfListen` is `false` - will ignore messages sent by the current account
 
@@ -252,6 +255,7 @@ api.setOptions({
 ## 📚 Full API Documentation
 
 See [DOCS.md](./DOCS.md) for detailed information about:
+
 - All available API methods
 - Parameters and options
 - Event types
@@ -291,6 +295,7 @@ api.setMessageReaction(reaction, messageID, callback);
 ## 🤝 Contributing
 
 Contributions are welcome! Please:
+
 1. Fork the repository
 2. Create a new branch (`git checkout -b feature/AmazingFeature`)
 3. Commit your changes (`git commit -m 'Add some AmazingFeature'`)

package/func/checkUpdate.js

@@ -0,0 +1,62 @@
+// func/checkUpdate.js
+const logger = require("./logger");
+const fs = require("fs");
+const { exec } = require("child_process");
+const pkgName = "@dongdev/fca-unofficial";
+
+function execPromise(cmd) {
+  return new Promise((resolve, reject) => {
+    exec(cmd, (error, stdout, stderr) => {
+      if (error) return reject({ error, stderr });
+      resolve({ stdout, stderr });
+    });
+  });
+}
+
+function getInstalledVersion() {
+  try {
+    const p = require.resolve(`${pkgName}/package.json`, { paths: [process.cwd(), __dirname] });
+    return JSON.parse(fs.readFileSync(p, "utf8")).version;
+  } catch {
+    return null;
+  }
+}
+
+async function _checkAndUpdateVersionImpl() {
+  logger("Checking version...", "info");
+  const latest = (await execPromise(`npm view ${pkgName} version`)).stdout.trim();
+  const installed = getInstalledVersion();
+  if (!installed || installed !== latest) {
+    logger(`New version available (${latest}). Current version (${installed || "not installed"}). Updating...`, "info");
+    try {
+      const { stderr } = await execPromise(`npm i ${pkgName}@latest`);
+      if (stderr) logger(stderr, "error");
+      logger(`Updated fca to the latest version: ${latest}, Restart to apply`, "info");
+      process.exit(1);
+    } catch (e) {
+      logger(`Error running npm install: ${e.error || e}. Trying to install from GitHub...`, "error");
+      try {
+        const { stderr } = await execPromise("npm i https://github.com/Donix-VN/fca-unofficial");
+        if (stderr) logger(stderr, "error");
+        logger(`Installed from GitHub successfully: ${latest}`, "info");
+        return;
+      } catch (gitErr) {
+        logger(`Error installing from GitHub: ${gitErr.error || gitErr}`, "error");
+        throw (gitErr.error || gitErr);
+      }
+    }
+  } else {
+    logger(`You're already on the latest version - ${latest}`, "info");
+    return;
+  }
+}
+
+function checkAndUpdateVersion(callback) {
+  if (typeof callback === "function") {
+    _checkAndUpdateVersionImpl().then(() => callback(null)).catch(err => callback(err));
+    return;
+  }
+  return _checkAndUpdateVersionImpl();
+}
+
+module.exports = { checkAndUpdateVersion };

package/func/logger.js

@@ -0,0 +1,48 @@
+const chalk = require("chalk");
+const gradient = require("gradient-string");
+
+const themes = [
+  "blue", "dream2", "dream", "fiery", "rainbow", "pastel", "cristal", "red", "aqua", "pink", "retro", "sunlight", "teen", "summer", "flower", "ghost", "hacker"
+];
+
+function buildGradient(name) {
+  const t = String(name || "").toLowerCase();
+  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 }]);
+  if (t === "dream2") return gradient("blue", "pink");
+  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 }]);
+  if (t === "fiery") return gradient("#fc2803", "#fc6f03", "#fcba03");
+  if (t === "rainbow") return gradient.rainbow;
+  if (t === "pastel") return gradient.pastel;
+  if (t === "cristal") return gradient.cristal;
+  if (t === "red") return gradient("red", "orange");
+  if (t === "aqua") return gradient("#0030ff", "#4e6cf2");
+  if (t === "pink") return gradient("#d94fff", "purple");
+  if (t === "retro") return gradient.retro;
+  if (t === "sunlight") return gradient("orange", "#ffff00", "#ffe600");
+  if (t === "teen") return gradient.teen;
+  if (t === "summer") return gradient.summer;
+  if (t === "flower") return gradient("blue", "purple", "yellow", "#81ff6e");
+  if (t === "ghost") return gradient.mind;
+  if (t === "hacker") return gradient("#47a127", "#0eed19", "#27f231");
+  return gradient("#243aff", "#4687f0", "#5800d4");
+}
+
+const themeName = themes[Math.floor(Math.random() * themes.length)];
+const co = buildGradient(themeName);
+
+module.exports = (text, type) => {
+  const s = String(type || "info").toLowerCase();
+  if (s === "warn") {
+    process.stderr.write(co(`\r[ FCA-WARN ] > ${text}`) + "\n");
+    return;
+  }
+  if (s === "error") {
+    process.stderr.write(chalk.bold.hex("#ff0000")(`\r[ FCA-ERROR ]`) + ` > ${text}\n`);
+    return;
+  }
+  if (s === "info") {
+    process.stderr.write(chalk.bold(co(`\r[ FCA-UNO ] > ${text}`)) + "\n");
+    return;
+  }
+  process.stderr.write(chalk.bold(co(`\r[ ${s.toUpperCase()} ] > ${text}`)) + "\n");
+};