ayman-fca 1.0.0

package/README.md

@@ -0,0 +1,81 @@
+AYMAN-FCA 🤖
+
+> مكتبة غير رسمية للتواصل مع Facebook Messenger عبر Node.js
+> مخصصة لبوت **KIRA**
+
+---
+
+## 👤 المطور
+
+**Ayman** — جميع الحقوق محفوظة © 2025
+
+---
+
+## 📦 التثبيت
+
+```bash
+npm install ayman-fca
+```
+
+---
+
+## 🚀 الاستخدام الأساسي
+
+```javascript
+const login = require("ayman-fca");
+const fs = require("fs");
+
+const appState = JSON.parse(fs.readFileSync("appstate.json", "utf8"));
+
+login({ appState }, (err, api) => {
+  if (err) return console.error("خطأ في اللوجين:", err);
+
+  console.log("✅ KIRA بوت متصل!");
+
+  api.listenMqtt((err, message) => {
+    if (err) return;
+    if (message.type === "message") {
+      api.sendMessage("مرحباً! أنا KIRA 🤖", message.threadID);
+    }
+  });
+});
+```
+
+---
+
+## ⚙️ ملف الإعدادات `fca-config.json`
+
+```json
+{
+  "autoUpdate": false,
+  "mqtt": {
+    "enabled": true,
+    "reconnectInterval": 3600
+  }
+}
+```
+
+---
+
+## 📋 الميزات
+
+- ✅ إرسال واستقبال الرسائل عبر MQTT
+- ✅ حماية من الكراش التلقائي
+- ✅ حفظ AppState تلقائي
+- ✅ إعادة اتصال تلقائية
+- ✅ دعم المرفقات والصور والفيديو
+- ✅ دعم التفاعلات والردود
+- ✅ لا يُرسل أي بيانات لسيرفرات خارجية
+
+---
+
+## 🔒 الأمان
+
+هذه المكتبة لا تُرسل أي بيانات لأي سيرفر خارجي.
+كل شيء يعمل على جهازك/سيرفرك فقط.
+
+---
+
+## 📄 الترخيص
+
+MIT License — المطور: **Ayman**

package/func/checkUpdate.js

@@ -0,0 +1,13 @@
+// ============================================================
+//  AYMAN-FCA v2.0 — Check Update (معطل)
+//  © 2025 Ayman. All Rights Reserved.
+//  autoUpdate معطل — لا يبطئ الإقلاع على Render
+// ============================================================
+"use strict";
+
+async function checkAndUpdateVersion() {
+  // ✅ معطل بشكل دائم — لا يتحقق من أي تحديث
+  return Promise.resolve();
+}
+
+module.exports = { checkAndUpdateVersion };

package/func/logAdapter.js

@@ -0,0 +1,30 @@
+// ============================================================
+//  AYMAN-FCA v2.0 — Log Adapter
+//  © 2025 Ayman. All Rights Reserved.
+// ============================================================
+"use strict";
+
+const logger = require("./logger");
+
+function formatArgs(args) {
+  const [prefix, msg] = args;
+  if (msg === undefined) {
+    if (prefix instanceof Error) return prefix.stack || prefix.message || String(prefix);
+    return String(prefix ?? "");
+  }
+  const tag  = prefix == null ? "" : String(prefix);
+  const text = msg instanceof Error
+    ? (msg.message || String(msg))
+    : (msg == null ? "" : String(msg));
+  return tag ? `${tag}: ${text}` : text;
+}
+
+const log = {
+  info:    (...args) => logger(formatArgs(args), "info"),
+  warn:    (...args) => logger(formatArgs(args), "warn"),
+  error:   (...args) => logger(formatArgs(args), "error"),
+  verbose: (...args) => logger(formatArgs(args), "info"),
+  silly:   (...args) => logger(formatArgs(args), "info"),
+};
+
+module.exports = log;

package/func/logger.js

@@ -0,0 +1,66 @@
+// ============================================================
+//  AYMAN-FCA v2.0 — Logger
+//  © 2025 Ayman. All Rights Reserved.
+//  جميع الحقوق محفوظة لأيمن
+// ============================================================
+"use strict";
+
+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:.2},{color:"cyan",pos:.4},{color:"pink",pos:.6},{color:"cyan",pos:.8},{color:"#1affa3",pos:1}]);
+  if (t === "dream2")   return gradient("blue","pink");
+  if (t === "dream")    return gradient([{color:"blue",pos:.2},{color:"pink",pos:.3},{color:"gold",pos:.6},{color:"pink",pos:.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);
+
+// ✅ تسجيل الأوقات لكل رسالة لتسهيل التشخيص
+function timestamp() {
+  return new Date().toLocaleTimeString("en-US", { hour12: false });
+}
+
+module.exports = function logger(text, type) {
+  const s   = String(type || "info").toLowerCase();
+  const ts  = timestamp();
+
+  if (s === "warn") {
+    process.stderr.write(co(`\r[ AYMAN-WARN ][ ${ts} ] > ${text}`) + "\n");
+    return;
+  }
+  if (s === "error") {
+    process.stderr.write(
+      chalk.bold.hex("#ff0000")(`\r[ AYMAN-ERROR ][ ${ts} ]`) + ` > ${text}\n`
+    );
+    return;
+  }
+  if (s === "info") {
+    process.stderr.write(chalk.bold(co(`\r[ AYMAN-FCA ][ ${ts} ] > ${text}`)) + "\n");
+    return;
+  }
+  process.stderr.write(chalk.bold(co(`\r[ ${s.toUpperCase()} ][ ${ts} ] > ${text}`)) + "\n");
+};