@manybot/manybot 5.2.2 → 5.2.5

package/README.md

@@ -2,7 +2,7 @@
 
 ![ManyBot Logo](logo.png)
 
-![Node.js 20+](https://img.shields.io/badge/Node.js-20+-339933?logo=node.js&logoColor=white)
+![Node.js 24+](https://img.shields.io/badge/Node.js-20+-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)
@@ -16,7 +16,7 @@ Open-source framework for message automation, extensible via community plugins.
 
 ## Requirements
 
-- Node.js >= 20
+- Node.js >= 24.17.0
 - npm
 
 ## Getting started

package/dist/config.js

@@ -21,6 +21,7 @@ import os from "os";
 import path from "path";
 import { parse as parseToml } from "smol-toml";
 import { logger } from "#logger";
+import { t } from "#i18n";
 // ---------------------------------------------------------------------------
 // Paths
 // ---------------------------------------------------------------------------
@@ -208,13 +209,6 @@ PHONE_NUMBER = ""
 # Leave blank to choose interactively on first run — the choice is then
 # saved here automatically.
 LOGIN_METHOD = ""
-
-# JID of a single chat where the bot is allowed to respond to messages
-# sent by yourself (fromMe) — useful for testing commands without
-# affecting other conversations. In every other chat, fromMe messages
-# are always ignored.
-# Example: TEST_CHAT = "5511999999999@c.us"
-TEST_CHAT    = ""
 `;
 const DEFAULT_TOML_PT = `# Arquivo de configuração do ManyBot
 # Veja https://manybot.org/docs/config para saber mais
@@ -230,12 +224,6 @@ PHONE_NUMBER = ""
 # PHONE_NUMBER). Deixe em branco para escolher interativamente na primeira
 # execução — a escolha é salva aqui automaticamente.
 LOGIN_METHOD = ""
-
-# JID de um único chat onde o bot pode responder a mensagens enviadas por
-# você mesmo (fromMe) — útil para testar comandos sem afetar outras
-# conversas. Em qualquer outro chat, mensagens fromMe são sempre ignoradas.
-# Exemplo: TEST_CHAT = "5511999999999@c.us"
-TEST_CHAT    = ""
 `;
 const DEFAULT_TOML = detectSystemLang() === "pt" ? DEFAULT_TOML_PT : DEFAULT_TOML_EN;
 await fs.mkdir(CONFIG_DIR, { recursive: true });
@@ -261,8 +249,9 @@ async function loadToml(file, label) {
     }
     catch (e) {
         const err = e instanceof Error ? e : new Error(String(e));
-        logger.warn(`Error parsing ${label}: ${err.message}`);
-        return {};
+        logger.error(t("errors.invalid_config", { file: label, error: err.message }));
+        logger.error(t("errors.fix_config", { file: label }));
+        process.exit(1);
     }
 }
 tomlLayer = {
@@ -277,7 +266,6 @@ const DEFAULTS = {
     LANGUAGE: "en",
     PHONE_NUMBER: null,
     PLATFORM: "whatsapp",
-    TEST_CHAT: null,
     LOGIN_METHOD: null,
 };
 function normalize(cfg) {
@@ -285,8 +273,6 @@ function normalize(cfg) {
     // can always do a simple truthiness check regardless of config source.
     if (cfg.PHONE_NUMBER === "")
         cfg.PHONE_NUMBER = null;
-    if (cfg.TEST_CHAT === "")
-        cfg.TEST_CHAT = null;
     // Anything other than "phone"/"qr" is treated as "not configured yet",
     // so a typo or leftover garbage value falls back to the interactive
     // prompt instead of silently misbehaving.
@@ -327,7 +313,6 @@ export const PLUGINS = CONFIG.PLUGINS;
 export const LANGUAGE = CONFIG.LANGUAGE;
 export const PHONE_NUMBER = CONFIG.PHONE_NUMBER;
 export const PLATFORM = CONFIG.PLATFORM;
-export const TEST_CHAT = CONFIG.TEST_CHAT;
 export const LOGIN_METHOD = CONFIG.LOGIN_METHOD;
 /**
  * Writes a single value back to manybot.toml without rewriting the whole

package/dist/drivers/whatsapp/api/index.js

@@ -42,6 +42,8 @@ function getMsgType(msg) {
         return "unknown";
     if (m.conversation || m.extendedTextMessage)
         return "chat";
+    if (m.buttonsResponseMessage || m.listResponseMessage)
+        return "chat";
     if (m.imageMessage)
         return "image";
     if (m.videoMessage)
@@ -56,6 +58,14 @@ function getMsgType(msg) {
         m.pollCreationMessageV2 ||
         m.pollCreationMessageV3)
         return "poll";
+    if (m.locationMessage || m.liveLocationMessage)
+        return "location";
+    if (m.contactMessage)
+        return "vcard";
+    if (m.contactsArrayMessage)
+        return "multi_vcard";
+    if (m.protocolMessage?.type === 0)
+        return "revoked"; // REVOKE
     return "unknown";
 }
 function msgHasMedia(msg) {
@@ -98,6 +108,29 @@ function getMsgMimetype(msg) {
 // on every single incoming message from the same group.
 const GROUP_NAME_CACHE_TTL_MS = 5 * 60 * 1000;
 const groupNameCache = new Map();
+const GROUP_META_CACHE_TTL_MS = 5 * 60 * 1000;
+const groupMetaCache = new Map();
+async function getGroupMetadataCached(sock, jid) {
+    const cached = groupMetaCache.get(jid);
+    if (cached && Date.now() - cached.at < GROUP_META_CACHE_TTL_MS)
+        return cached.meta;
+    const meta = await sock.groupMetadata(jid);
+    groupMetaCache.set(jid, { meta, at: Date.now() });
+    return meta;
+}
+let groupMetaInvalidationBound = false;
+function bindGroupMetaInvalidation(sock) {
+    if (groupMetaInvalidationBound)
+        return;
+    groupMetaInvalidationBound = true;
+    const ev = sock.ev;
+    ev.on("group-participants.update", (u) => groupMetaCache.delete(u.id));
+    ev.on("groups.update", (updates) => {
+        for (const u of updates)
+            if (u.id)
+                groupMetaCache.delete(u.id);
+    });
+}
 /**
  * Build a WAChat adapter from a Baileys message + store.
  * Exposed for use in messageHandler.ts.
@@ -122,7 +155,7 @@ export async function buildChatFromMsg(msg, store, sock) {
         }
         else {
             try {
-                const meta = await sock.groupMetadata(rawJid);
+                const meta = await getGroupMetadataCached(sock, rawJid);
                 if (meta?.subject) {
                     name = meta.subject;
                     groupNameCache.set(rawJid, { name: meta.subject, at: Date.now() });
@@ -311,6 +344,12 @@ async function normalizeContact(jid, info, botJid, sock) {
             isWAAccount = false;
         }
     }
+    // No store record and no confirmed WhatsApp account (and not a group,
+    // which we can't verify this way) — nothing backs this contact.
+    // Matches the old whatsapp-web.js contract: getContactById() threw /
+    // resolved to null for an unknown ID instead of returning a hollow object.
+    if (!jid.endsWith("@g.us") && !isWAAccount)
+        return null;
     if (sock && !jid.endsWith("@g.us")) {
         try {
             isBusiness = Boolean(await sock.getBusinessProfile(jid));
@@ -485,7 +524,9 @@ export function buildMessageContext(msg, sock, store, guardOptions = {}) {
         },
         hasReply: !!(contextInfo?.quotedMessage),
         async getReply() {
-            return quotedRaw;
+            if (!quotedRaw)
+                return null;
+            return buildMessageContext(quotedRaw, sock, store, { cooldown: false, jitter: false });
         },
         reply: makeSender(sock, store, rawJid, msg, { cooldown, jitter }),
         async react(emoji) {
@@ -500,6 +541,10 @@ export function buildMessageContext(msg, sock, store, guardOptions = {}) {
             logger.warn("[pluginApi] pin() is not supported with Baileys");
         },
         hasPrefix,
+        /**
+         * Normalized contact of the message sender.
+         * @returns {Promise<object|null>} null if the sender can't be confirmed as a real WhatsApp account.
+         */
         async getContact() {
             const info = store.contacts[sender]
                 ?? store.contacts[store.resolveJid(msg.key.participant ?? "")];
@@ -1126,6 +1171,7 @@ function buildBaseApi(sock, store, pluginRegistry, pluginName) {
  * @param {string}                pluginName
  */
 export function buildSetupApi(sock, store, pluginRegistry, pluginName) {
+    bindGroupMetaInvalidation(sock);
     return {
         ...buildBaseApi(sock, store, pluginRegistry, pluginName),
         ...buildSetupSendApi(sock, store),
@@ -1161,6 +1207,7 @@ export function buildApi({ msg, chat, sock, store, pluginRegistry, pluginName, g
     const sender = getMsgSender(msg, store);
     const cooldown = (guardOptions.cooldown ?? true);
     const jitter = (guardOptions.jitter ?? true);
+    bindGroupMetaInvalidation(sock);
     // Sender for quoted messages
     const contextInfo = getContextInfo(msg);
     const quotedRaw = contextInfo?.quotedMessage
@@ -1213,7 +1260,7 @@ export function buildApi({ msg, chat, sock, store, pluginRegistry, pluginName, g
                 if (!chat.isGroup)
                     return [];
                 try {
-                    const meta = await sock.groupMetadata(rawJid);
+                    const meta = await getGroupMetadataCached(sock, rawJid);
                     return meta.participants.map(p => ({
                         id: normalizeJid(p.id),
                         isAdmin: p.admin === "admin" || p.admin === "superadmin",
@@ -1233,7 +1280,7 @@ export function buildApi({ msg, chat, sock, store, pluginRegistry, pluginName, g
                 if (!chat.isGroup)
                     return false;
                 try {
-                    const meta = await sock.groupMetadata(rawJid);
+                    const meta = await getGroupMetadataCached(sock, rawJid);
                     return meta.participants.some(p => matchesParticipant([contactId], p.id) && (p.admin === "admin" || p.admin === "superadmin"));
                 }
                 catch {
@@ -1248,7 +1295,7 @@ export function buildApi({ msg, chat, sock, store, pluginRegistry, pluginName, g
                 if (!chat.isGroup)
                     return false;
                 try {
-                    const meta = await sock.groupMetadata(rawJid);
+                    const meta = await getGroupMetadataCached(sock, rawJid);
                     const rawSenderParticipant = msg.key.participant ?? msg.key.remoteJid ?? "";
                     return meta.participants.some(p => matchesParticipant([sender, rawSenderParticipant], p.id) && (p.admin === "admin" || p.admin === "superadmin"));
                 }
@@ -1268,7 +1315,7 @@ export function buildApi({ msg, chat, sock, store, pluginRegistry, pluginName, g
                 if (!botCandidates.some(Boolean))
                     return false;
                 try {
-                    const meta = await sock.groupMetadata(rawJid);
+                    const meta = await getGroupMetadataCached(sock, rawJid);
                     return meta.participants.some(p => matchesParticipant(botCandidates, p.id) && (p.admin === "admin" || p.admin === "superadmin"));
                 }
                 catch {

package/dist/drivers/whatsapp/index.js

@@ -123,9 +123,9 @@ export const whatsappDriver = {
      * it's your own message or someone else's — prints the normalized
      * JID and the chat name (if any), and exits.
      *
-     * Intentionally does not go through the CHATS/fromMe/dedup filters of
+     * Intentionally does not go through the CHATS/dedup filters of
      * handleMessage: the only goal here is to discover the JID so you can
-     * configure CHATS/TEST_CHAT afterward, so there's no reason to filter
+     * configure CHATS afterward, so there's no reason to filter
      * anything out yet.
      */
     async getId() {
@@ -151,7 +151,7 @@ export const whatsappDriver = {
                 logger.success(`[getid] JID: ${jid}`);
                 if (name)
                     logger.info(`[getid] Chat/sender: ${name}`);
-                logger.info("[getid] Paste this value into CHATS or TEST_CHAT in manybot.toml.");
+                logger.info("[getid] Paste this value into CHATS in manybot.toml.");
                 resolve();
             });
         });

package/dist/drivers/whatsapp/messageHandler.js

@@ -11,7 +11,7 @@
  *
  * Each plugin decides whether to act or ignore.
  */
-import { CHATS, TEST_CHAT } from "#config";
+import { CHATS } from "#config";
 import { buildApi, buildChatFromMsg } from "./api/index.js";
 import { pluginRegistry } from "#kernel/pluginLoader.js";
 import { runPlugin } from "#kernel/pluginGuard.js";
@@ -58,10 +58,6 @@ export async function handleMessage(msg, sock, store) {
     if (CHATS.length > 0 && !CHATS.includes(jid)) {
         return;
     }
-    const isTestChat = !!TEST_CHAT && jid === normalizeJid(TEST_CHAT);
-    if (msg.key.fromMe && !isTestChat) {
-        return;
-    }
     if (alreadyProcessed(msg.key.id)) {
         return;
     }

package/dist/i18n/index.js

@@ -42,14 +42,41 @@ function loadLocale(lang) {
     }
 }
 /**
- * Gets configured language or default
+ * Detects the OS locale without depending on a single env var, since LANG
+ * isn't reliably set on macOS GUI sessions or Windows. Used as a fallback
+ * when CONFIG.LANGUAGE isn't available yet (e.g. circular import during
+ * config bootstrap) or isn't set.
+ */
+function detectSystemLang() {
+    try {
+        const locale = Intl.DateTimeFormat().resolvedOptions().locale;
+        if (locale)
+            return locale.split("-")[0].toLowerCase();
+    }
+    catch {
+        // Intl unavailable — fall through to env vars
+    }
+    const envLocale = process.env.LC_ALL || process.env.LC_MESSAGES || process.env.LANG || process.env.LANGUAGE;
+    if (envLocale)
+        return envLocale.split(/[_.]/)[0].toLowerCase();
+    return DEFAULT_LANG;
+}
+/**
+ * Gets configured language or falls back to system locale, then English.
  * @returns {string}
  */
 function getConfiguredLang() {
-    const lang = CONFIG.LANGUAGE?.trim().toLowerCase();
-    if (!lang)
-        return DEFAULT_LANG;
-    // Check if file exists
+    let lang;
+    try {
+        lang = CONFIG.LANGUAGE?.trim().toLowerCase();
+    }
+    catch {
+        // CONFIG not initialized yet (e.g. this module was pulled in via a
+        // circular import while #config is still bootstrapping)
+    }
+    if (!lang) {
+        lang = detectSystemLang();
+    }
     const filePath = path.join(LOCALES_DIR, `${lang}.json`);
     if (!fs.existsSync(filePath)) {
         console.warn(`[i18n] Language "${lang}" not found, falling back to "${DEFAULT_LANG}"`);

package/dist/kernel/scheduler.js

@@ -20,7 +20,7 @@
  *   }
  */
 import cron from "node-cron";
-import Database from "better-sqlite3";
+import { DatabaseSync } from "node:sqlite";
 import path from "path";
 import { mkdirSync } from "fs";
 import { logger } from "#logger";
@@ -30,8 +30,8 @@ import { CONFIG_DIR } from "#config";
 const tasks = new Map();
 // ── Persistence (metadata only — fn can't be serialized) ────────────────────
 mkdirSync(CONFIG_DIR, { recursive: true });
-const db = new Database(path.join(CONFIG_DIR, "scheduler.db"));
-db.pragma("journal_mode = WAL");
+const db = new DatabaseSync(path.join(CONFIG_DIR, "scheduler.db"));
+db.exec("PRAGMA journal_mode = WAL");
 db.exec(`
   CREATE TABLE IF NOT EXISTS scheduled_tasks (
     plugin_name  TEXT NOT NULL,

package/dist/kernel/settingsDb.js

@@ -10,16 +10,16 @@
  *
  * Plugins never touch the DB directly — only through buildSettingsApi().
  */
-import Database from "better-sqlite3";
+import { DatabaseSync } from "node:sqlite";
 import path from "path";
 import { mkdirSync } from "fs";
 import { CONFIG_DIR } from "#config";
 // ── DB init ───────────────────────────────────────────────────────────────────
 const DB_PATH = path.join(CONFIG_DIR, "settings.db");
 mkdirSync(path.dirname(DB_PATH), { recursive: true });
-const db = new Database(DB_PATH);
-db.pragma("journal_mode = WAL");
-db.pragma("foreign_keys = ON");
+const db = new DatabaseSync(DB_PATH);
+db.exec("PRAGMA journal_mode = WAL");
+db.exec("PRAGMA foreign_keys = ON");
 db.exec(`
   CREATE TABLE IF NOT EXISTS plugin_settings (
     plugin_name  TEXT NOT NULL,

package/dist/locales/en.json

@@ -34,7 +34,9 @@
     "sessionExpired": "Session expired or logged out — removing local session and restarting..."
   },
   "errors": {
-    "stack": "Stack"
+    "stack": "Stack",
+    "invalid_config": "Invalid config file {{file}}: {{error}}",
+    "fix_config": "Fix the syntax in {{file}} before starting the bot."
   },
   "onboarding": {
     "intro": "ManyBot — first login",

package/dist/locales/es.json

@@ -34,7 +34,9 @@
     "sessionExpired": "Sesión expirada o cerrada — eliminando sesión local y reiniciando..."
   },
   "errors": {
-    "stack": "Stack"
+    "stack": "Stack",
+    "invalid_config": "Archivo de configuración inválido {{file}}: {{error}}",
+    "fix_config": "Corrige la sintaxis en {{file}} antes de iniciar el bot."
   },
   "onboarding": {
     "intro": "ManyBot — primer inicio de sesión",

package/dist/locales/pt.json

@@ -34,7 +34,9 @@
     "sessionExpired": "Sessão expirada ou desconectada — removendo sessão local e reiniciando..."
   },
   "errors": {
-    "stack": "Stack"
+    "stack": "Stack",
+    "invalid_config": "Arquivo de configuração inválido {{file}}: {{error}}",
+    "fix_config": "Corrija a sintaxe em {{file}} antes de iniciar o bot."
   },
   "onboarding": {
     "intro": "ManyBot — primeiro login",

package/dist/main.js

@@ -1,3 +1,4 @@
+#!/usr/bin/env node
 /**
  * main.ts
  *
@@ -54,7 +55,7 @@ process.on("SIGINT", () => shutdown("SIGINT"));
 // ── --getid mode (provisional) ───────────────────────────────────────────
 // Usage: npm run start -- --getid
 // Connects, waits for the next message to arrive from any chat, and prints
-// the JID to the console, to paste into CHATS/TEST_CHAT in manybot.toml.
+// the JID to the console, to paste into CHATS in manybot.toml.
 // Does not enter the normal bot flow (plugins are not loaded).
 if (process.argv.includes("--getid")) {
     if (!activeDriver.getId) {

package/package.json

@@ -5,11 +5,11 @@
     "name": "SyntaxError!",
     "email": "me@stxerr.dev"
   },
-  "version": "5.2.2",
+  "version": "5.2.5",
   "license": "GPL-3.0-only",
   "private": false,
   "engines": {
-    "node": ">=20"
+    "node": ">=24.17.0"
   },
   "repository": {
     "type": "git",
@@ -30,16 +30,14 @@
     "typecheck": "tsc --noEmit"
   },
   "devDependencies": {
-    "@types/better-sqlite3": "^7.6.12",
     "@types/node": "^22.0.0",
     "tsx": "^4.19.2",
     "typescript": "^5.7.3"
   },
   "dependencies": {
-    "@clack/prompts": "^0.10.0",
+    "@clack/prompts": "^0.10.1",
     "@hapi/boom": "^10.0.1",
     "@whiskeysockets/baileys": "^6.7.23",
-    "better-sqlite3": "^12.11.1",
     "node-cron": "^4.6.0",
     "node-webpmux": "^3.2.1",
     "pino": "^10.3.1",