@manybot/manybot 4.0.1

package/README.md

@@ -0,0 +1,18 @@
+<div align="center">
+
+![ManyBot Logo](logo.png)
+
+**Just a cool open source WhatsApp bot**
+
+[🇧🇷 Português](README.md) · [🇺🇸 English](README_EN.md)
+
+![Node.js 18+](https://img.shields.io/badge/Node.js-18+-339933?logo=node.js&logoColor=white)
+![npm 9+](https://img.shields.io/badge/npm-9+-CB3837?logo=npm&logoColor=white)
+![GPL v3](https://img.shields.io/badge/License-GPL--v3-blue.svg)
+![Linux](https://img.shields.io/badge/Linux%20%7C%20Windows-lightgrey)
+
+---
+
+This repository is dedicated to contributions related to the project.
+
+website: https://manybot.stxerr.dev

package/package.json

@@ -0,0 +1,53 @@
+{
+  "name": "@manybot/manybot",
+  "description": "Free and open source WhatsApp bot",
+  "author": {
+    "name": "SyntaxError!",
+    "email": "me@stxerr.dev"
+  },
+  "version": "4.0.1",
+  "license": "GPL-3.0-only",
+  "private": false,
+  "engines": {
+    "node": ">=18"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/many-bot/manybot.git"
+  },
+  "type": "module",
+  "bin": {
+    "manybot": "./src/main.js"
+  },
+  "files": [
+    "src/client",
+    "src/config.js",
+    "src/download",
+    "src/i18n",
+    "src/kernel",
+    "src/locales",
+    "src/logger",
+    "src/main.js",
+    "src/utils",
+    "README.md",
+    "README_EN.md",
+    "latest",
+    "LICENSE"
+  ],
+  "dependencies": {
+    "node-webpmux": "^3.2.1",
+    "qrcode-terminal": "^0.12.0",
+    "whatsapp-web.js": "^1.24.0"
+  },
+  "imports": {
+    "#client/*": "./src/client/*.js",
+    "#kernel/*": "./src/kernel/*.js",
+    "#manyapi": "./src/kernel/pluginApi.js",
+    "#logger": "./src/logger/logger.js",
+    "#utils/*": "./src/utils/*.js",
+    "#i18n": "./src/i18n/index.js",
+    "#download": "./src/download/queue.js",
+    "#config": "./src/config.js",
+    "#main": "./src/main.js"
+  }
+}

package/src/client/banner.js

@@ -0,0 +1,57 @@
+const C = {
+  reset: "\x1b[0m",
+  bold: "\x1b[1m",
+
+  blue: "\x1b[94m",
+  magenta: "\x1b[95m",
+  cyan: "\x1b[96m",
+  gray: "\x1b[90m",
+  yellow: "\x1b[93m",
+};
+
+import { readFileSync } from "fs";
+import { fileURLToPath } from "url";
+import path from "path";
+
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = path.dirname(__filename);
+
+const v = JSON.parse(
+  readFileSync(
+    path.join(__dirname, "../../package.json"),
+    "utf8"
+  )
+).version;
+
+export function printBanner() {
+  const banner = [
+    `                             _           _  `,
+    `                            | |         | | `,
+    ` _ __ ___   __ _ _ __  _   _| |__   ___ | |_`,
+    `| '_ \` _ \\ / _\` | '_ \\| | | | '_ \\ / _ \\| __`,
+    `| | | | | | (_| | | | | |_| | |_) | (_) | |_`,
+    `|_| |_| |_|\\__,_|_| |_|\\__, |_.__/ \\___/ \\__`,
+    `                        __/ |               `,
+    ` ${v}                 |___/                `
+  ];
+
+  console.log(`${C.bold}${C.blue}`);
+  console.log(banner.join("\n"));
+  console.log(C.reset);
+
+  console.log(
+    `  made with ${C.magenta}<3${C.reset} by ${C.bold}${C.cyan}SyntaxError!${C.reset} ${C.gray}<me@stxerr.dev>${C.reset}`
+  );
+
+  console.log();
+
+  console.log(
+    `  ${C.gray}website${C.reset} : ${C.yellow}https://manybot.stxerr.dev${C.reset}`
+  );
+
+  console.log(
+    `  ${C.gray}github ${C.reset} : ${C.yellow}https://github.com/many-bot${C.reset}`
+  );
+
+  console.log();
+}

package/src/client/whatsappClient.js

@@ -0,0 +1,103 @@
+/* whatsappClient
+ *
+ * Initialize client and connect to WhatsApp
+ *
+ * if PHONE_NUMBER is set on config, it will request a verficiation code
+ * but if it is not, it will display a QR Code on the screen to scan using your phone
+ *
+ * */
+
+import pkg                         from "whatsapp-web.js";
+import fs                          from "fs";
+import path                        from "path";
+import { fileURLToPath }           from "url";
+import { PHONE_NUMBER, CLIENT_ID } from "#config";
+import { logger }                  from "#logger";
+import qrcode                      from "qrcode-terminal";
+import { t }                       from "#i18n"
+
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = path.dirname(__filename);
+
+export const { Client, LocalAuth, MessageMedia } = pkg;
+
+// -- Instance --------------------------------------------------
+const clientOptions = {
+  authStrategy: new LocalAuth({ clientId: CLIENT_ID }),
+  puppeteer: {
+    headless: true,
+    args: [
+      '--no-sandbox',
+      '--disable-setuid-sandbox'
+    ],
+  },
+};
+
+// -- Qr Handle --------------------------------------------------
+export function handleQR(qr) {
+  logger.info(t("system.qrScan"));
+  qrcode.generate(qr, { small: true });
+}
+
+// -- Handle pairing code ---------------------------------------
+export function handlePairingCode(code) {
+  logger.info(t("system.pairingCodeTitle"));
+  logger.info(t("system.pairingCodeValue", { code: code }));
+  logger.info(t("system.pairingCodeInstructions"));
+}
+
+// -- Phone Number Validation ------------------------------------
+const AUTH_STATE_PATH = path.join(__dirname, `../../.auth_${CLIENT_ID}.json`);
+
+// Validates if phone string has 10-15 characters
+function isValidPhoneNumber(phone) {
+  if (!phone || typeof phone !== 'string') return false;
+  const phoneRegex = /^\d{10,15}$/;
+  return phoneRegex.test(phone);
+}
+
+// Checks if phone number changed since last authentication
+function hasPhoneNumberChanged(currentPhone) {
+  try {
+    if (!fs.existsSync(AUTH_STATE_PATH)) return false;
+    const state = JSON.parse(fs.readFileSync(AUTH_STATE_PATH, 'utf8'));
+    const storedPhone = state.phoneNumber || null;
+    return storedPhone !== currentPhone;
+  } catch {
+    return false;
+  }
+}
+
+// Saves phone number to auth state file
+function savePhoneNumber(phone) {
+  try {
+    fs.writeFileSync(AUTH_STATE_PATH, JSON.stringify({ phoneNumber: phone, savedAt: new Date().toISOString() }));
+  } catch {
+    return false;
+  }
+}
+
+// Check if phone number changed and force re-authentication if needed
+if (PHONE_NUMBER && hasPhoneNumberChanged(PHONE_NUMBER)) {
+  // Delete auth folder to force fresh authentication
+  const authPath = path.join(__dirname, `../../.wwebjs_auth/session-${CLIENT_ID}`);
+  if (fs.existsSync(authPath)) {
+    fs.rmSync(authPath, { recursive: true, force: true });
+  }
+} 
+
+// Add phone number pairing if PHONE_NUMBER is configured and valid
+if (PHONE_NUMBER) {
+  if (isValidPhoneNumber(PHONE_NUMBER)) {
+    clientOptions.pairWithPhoneNumber = {
+      phoneNumber: PHONE_NUMBER,
+      showNotification: true,
+    };
+  }
+  savePhoneNumber(PHONE_NUMBER);
+}
+
+export const client = new Client(clientOptions);
+
+
+export default client;

package/src/config.js

@@ -0,0 +1,196 @@
+/**
+ * config.js
+ *
+ * Loads:
+ *   ~/.manybot/manybot.conf
+ *   ~/.manybot/manyplug.conf
+ *
+ * Merges both files into a single configuration object.
+ */
+
+import fs from "fs/promises";
+import os from "os";
+import path from "path";
+
+import { logger } from "#logger";
+
+const CONFIG_DIR = path.join(os.homedir(), ".manybot");
+const CONFIG_FILE = path.join(CONFIG_DIR, "manybot.conf");
+const PLUGIN_FILE = path.join(CONFIG_DIR, "manyplug.conf");
+
+/**
+ * Converts strings to native JS values.
+ */
+function parseValue(value) {
+  value = value.trim();
+
+  if (
+    (value.startsWith('"') && value.endsWith('"')) ||
+    (value.startsWith("'") && value.endsWith("'"))
+  ) {
+    value = value.slice(1, -1);
+  }
+
+  if (value === "true")
+    return true;
+
+  if (value === "false")
+    return false;
+
+  return value;
+}
+
+/**
+ * Reads comments safely.
+ * Ignores # inside quoted strings.
+ */
+function stripInlineComment(line) {
+  let result = "";
+  let quote = null;
+
+  for (let i = 0; i < line.length; i++) {
+    const ch = line[i];
+
+    if ((ch === '"' || ch === "'") && line[i - 1] !== "\\") {
+      if (quote === ch)
+        quote = null;
+      else if (!quote)
+        quote = ch;
+    }
+
+    if (ch === "#" && !quote)
+      break;
+
+    result += ch;
+  }
+
+  return result.trim();
+}
+
+/**
+ * Parses manybot.conf syntax.
+ */
+function parseConf(raw) {
+  const lines = raw.split(/\r?\n/);
+
+  const mergedLines = [];
+
+  let insideList = false;
+  let buffer = "";
+
+  for (let line of lines) {
+    line = stripInlineComment(line);
+
+    if (!line)
+      continue;
+
+    if (!insideList) {
+      if (/=\s*\[$/.test(line)) {
+        insideList = true;
+        buffer = line;
+      } else {
+        mergedLines.push(line);
+      }
+    } else {
+      buffer += " " + line;
+
+      if (line.includes("]")) {
+        mergedLines.push(buffer);
+        buffer = "";
+        insideList = false;
+      }
+    }
+  }
+
+  const config = {};
+
+  for (const line of mergedLines) {
+    const idx = line.indexOf("=");
+
+    if (idx === -1)
+      continue;
+
+    const key = line.slice(0, idx).trim();
+    let value = line.slice(idx + 1).trim();
+
+    if (value.startsWith("[") && value.endsWith("]")) {
+      config[key] = value
+        .slice(1, -1)
+        .split(",")
+        .map(v => parseValue(v))
+        .filter(v => v !== "");
+      continue;
+    }
+
+    config[key] = parseValue(value);
+  }
+
+  return config;
+}
+
+async function readFileSafe(file) {
+  try {
+    return await fs.readFile(file, "utf-8");
+  } catch (err) {
+    if (err.code !== "ENOENT") {
+      logger.warn(`Error reading ${file}: ${err.message}`);
+    }
+    return "";
+  }
+}
+
+const defaultConfig = 
+`
+# Many bot configuration file
+# See https://manybot.stxerr.dev/docs/config to learn more
+
+CLIENT_ID="manybot"
+CMD_PREFIX="!"
+CHATS=[]
+LANGUAGE=en
+PHONE_NUMBER=
+`;
+
+try {
+  await fs.stat(CONFIG_FILE);
+} catch {
+  logger.warn("Configuration file not found: ", CONFIG_FILE, ". Creating a new one.");
+
+  await fs.mkdir(CONFIG_DIR, { recursive: true });
+  await fs.writeFile(CONFIG_FILE, defaultConfig);
+}
+
+const baseConfig = await readFileSafe(CONFIG_FILE);
+const pluginConfig = await readFileSafe(PLUGIN_FILE);
+
+export const CONFIG = parseConf(baseConfig + "\n" + pluginConfig);
+
+/**
+ * Common exports.
+ */
+export const CLIENT_ID =
+  CONFIG.CLIENT_ID ?? "manybot";
+
+export const CMD_PREFIX =
+  CONFIG.CMD_PREFIX ?? "!";
+
+export const CHATS =
+  CONFIG.CHATS ?? [];
+
+export const PLUGINS =
+  CONFIG.PLUGINS ?? [];
+
+export const LANGUAGE =
+  CONFIG.LANGUAGE ?? "en";
+
+export const PHONE_NUMBER =
+  CONFIG.PHONE_NUMBER ?? null;
+
+/**
+ * Useful paths for plugins/modules.
+ */
+export const PATHS = {
+  HOME: CONFIG_DIR,
+  CONFIG_FILE,
+  PLUGIN_FILE
+};

package/src/download/queue.js

@@ -0,0 +1,55 @@
+/**
+ * src/download/queue.js
+ *
+ * Sequential execution queue for heavy jobs (downloads, conversions).
+ * Ensures only one job runs at a time — without overloading yt-dlp or ffmpeg.
+ *
+ * Plugin passes a `workFn` that does everything: download, convert, send.
+ * Queue only handles sequence and error handling.
+ *
+ * Usage:
+ *   import { enqueue } from "../../src/download/queue.js";
+ *   enqueue(async () => { ... all plugin logic ... }, onError);
+ */
+
+import { logger } from "#logger";
+import { t }      from "#i18n";
+
+/**
+ * @typedef {{
+ *   workFn:   () => Promise<void>,
+ *   errorFn:  (err: Error) => Promise<void>,
+ * }} Job
+ */
+
+/** @type {Job[]} */
+let queue = [];
+let processing = false;
+
+/**
+ * Add job to queue and start processing if idle.
+ *
+ * @param {Function} workFn   — async () => void  — all plugin logic
+ * @param {Function} errorFn  — async (err) => void  — called if workFn throws
+ */
+export function enqueue(workFn, errorFn) {
+  queue.push({ workFn, errorFn });
+  if (!processing) processQueue();
+}
+
+async function processQueue() {
+  processing = true;
+  while (queue.length) {
+    await processJob(queue.shift());
+  }
+  processing = false;
+}
+
+async function processJob({ workFn, errorFn }) {
+  try {
+    await workFn();
+  } catch (err) {
+    logger.error(t("system.downloadJobFailed", { message: err.message }));
+    try { await errorFn(err); } catch { }
+  }
+}