@manybot/manybot 5.3.3 → 5.4.1

package/README.md

@@ -2,7 +2,7 @@
 
 ![ManyBot Logo](logo.png)
 
-![Node.js 24+](https://img.shields.io/badge/Node.js-20+-339933?logo=node.js&logoColor=white)
+![Node.js 24+](https://img.shields.io/badge/Node.js-24+-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)
@@ -46,9 +46,9 @@ Browse available plugins at **[manybot.org/plugins](https://manybot.org/plugins/
 All kinds of contributions are welcome:
 
 - **Bug reports and feature requests**: open an issue on GitHub or Codeberg
-- **Code**: pull requests are welcome on [GitHub](https://github.com/many-bot/manybot) or [Codeberg](https://codeberg.org/many-bot/manybot); patches by email (`devel+manybot.org`) are also accepted - subscribe to the mailing list [here](https://list.stxerr.dev).
+- **Code**: pull requests are welcome on [GitHub](https://github.com/many-bot/manybot) or [Codeberg](https://codeberg.org/many-bot/manybot); patches by email (`manybot@pm.me`) are also accepted.
 - **Plugins**: submit your plugin to [manyplug-repo](https://github.com/many-bot/manyplug-repo), which has instructions on how to do it
-- **Anything else**: suggestions, translations, documentation fixes - reach out by email or open an issue
+- **Anything else**: suggestions, translations, documentation fixes, art - reach out by email or open an issue
 
 ## License
 

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

@@ -412,6 +412,22 @@ async function normalizeContact(jid, info, botJid, sock) {
         mention: { text: `@${mentionDisplayName(jid)}`, mentions: [toWireJid(jid)] },
     };
 }
+// ── Chats API ─────────────────────────────────────────────────────────────────
+function buildChatsApi(store) {
+    return {
+        /**
+         * Chats currently known from the in-memory cache (populated from
+         * Baileys' chats.upsert / messaging-history.set events) — no network call.
+         * @returns {Array<{ id: string, name: string, isGroup: boolean }>}
+         */
+        all() {
+            return store.chats.all().map((c) => {
+                const id = normalizeJid(c.id);
+                return { id, name: c.name, isGroup: id.endsWith("@g.us") };
+            });
+        },
+    };
+}
 // ── Contact API ───────────────────────────────────────────────────────────────
 function buildContactsApi(sock, store, botJid) {
     return {
@@ -419,6 +435,7 @@ function buildContactsApi(sock, store, botJid) {
          * Get a normalized contact object by JID.
          * @param {string} contactId
          * @param {{groupId?: string}} [opts] — when `contactId` is a raw `@lid`, this
+    
          *   always cross-checks it against Baileys' own protocol-level
          *   `sock.signalRepository.lidMapping` first (populated from real Signal
          *   session/identity resolution — not a heuristic, and doesn't need a
@@ -587,6 +604,15 @@ function buildContactsApi(sock, store, botJid) {
         },
     };
 }
+function makeHistoryArray(entries, store) {
+    const arr = entries;
+    arr.last = (n) => makeHistoryArray(typeof n === "number" ? entries.slice(-n) : entries.slice(), store);
+    arr.from = (senderId) => {
+        const target = normalizeJid(store.resolveJid(normalizeJid(senderId)));
+        return makeHistoryArray(entries.filter((e) => e.sender === target), store);
+    };
+    return arr;
+}
 export function buildMessageContext(msg, sock, store, guardOptions = {}) {
     const body = getMsgBody(msg);
     const prefix = CONFIG.CMD_PREFIX;
@@ -612,6 +638,8 @@ export function buildMessageContext(msg, sock, store, guardOptions = {}) {
         }
         : null;
     return {
+        id: msg.key.id ?? "",
+        timestamp: Number(msg.messageTimestamp) || 0,
         body,
         type: getMsgType(msg),
         fromMe: !!(msg.key.fromMe),
@@ -817,6 +845,28 @@ function makeSender(sock, store, jid, quoted = null, { cooldown = true, jitter =
                 return sock.sendMessage(jid, messageContent, sendOpts);
             })(), sock, store, { cooldown, jitter });
         },
+        /**
+         * Send a GIF. WhatsApp has no native GIF format — this sends an mp4
+         * with the `gifPlayback` flag, which the client auto-loops, muted.
+         * `filePath` must already be mp4-encoded (no .gif input, no conversion).
+         */
+        gif(filePath, caption = "", opts = {}) {
+            return new MessageHandle((async () => {
+                const quotedMsg = await resolveQuoted();
+                const sendOpts = quotedMsg ? { quoted: quotedMsg } : {};
+                await waitForSendSlot(normJid, { cooldown, jitter });
+                await simulateState(toPresenceCapable(sock), jid, mediaDuration(), "typing");
+                const buffer = await readFile(filePath);
+                const messageContent = { video: buffer, caption, gifPlayback: true };
+                if (opts.viewOnce) {
+                    messageContent.viewOnce = true;
+                }
+                if (opts.mentions?.length) {
+                    messageContent.mentions = await resolveMentionJids(sock, store, jid, opts.mentions);
+                }
+                return sock.sendMessage(jid, messageContent, sendOpts);
+            })(), sock, store, { cooldown, jitter });
+        },
         audio(filePath, { asVoice = true, viewOnce = false } = {}) {
             return new MessageHandle((async () => {
                 const quotedMsg = await resolveQuoted();
@@ -890,6 +940,7 @@ function buildSendApi(sock, store, rawJid, guardOptions = {}) {
             text: (text, opts) => current.text(text, opts),
             image: (filePath, caption, opts) => current.image(filePath, caption, opts),
             video: (filePath, caption, opts) => current.video(filePath, caption, opts),
+            gif: (filePath, caption, opts) => current.gif(filePath, caption, opts),
             audio: (filePath, opts) => current.audio(filePath, opts),
             sticker: (source) => current.sticker(source),
             file: (filePath, filename) => current.file(filePath, filename),
@@ -1406,6 +1457,7 @@ function buildBaseApi(sock, store, pluginRegistry, pluginName) {
         download: buildDownloadApi(),
         scheduler: buildSchedulerApi(pluginName),
         plugins: buildPluginsApi(pluginRegistry),
+        chats: buildChatsApi(store),
         contacts: buildContactsApi(sock, store, botJid),
         storage: buildStorageApi(pluginName),
         botId: botJid,
@@ -1502,6 +1554,19 @@ export function buildApi({ msg, chat, sock, store, pluginRegistry, pluginName, g
             id: normJid,
             name: chat.name,
             isGroup: chat.isGroup,
+            /**
+             * Cached message history for this chat (oldest → newest), capped at
+             * the store's per-chat limit. Supports index access (`history[10]`)
+             * and two chainable filters: `.last(n)` and `.from(senderId)`.
+             * @returns {WAHistoryArray}
+             */
+            get history() {
+                const chatMsgs = store.messages.get(rawJid);
+                const entries = chatMsgs
+                    ? [...chatMsgs.values()].map((m) => buildMessageContext(m, sock, store, { cooldown: false, jitter: false }))
+                    : [];
+                return makeHistoryArray(entries, store);
+            },
             /**
              * List of group participants.
              * Returns [] for non-group chats.

package/dist/drivers/whatsapp/index.js

@@ -31,6 +31,39 @@ let connecting = false;
 let reconnectAttempts = 0;
 let cacheHydrated = false;
 let cacheSaveTimer = null;
+// ── Per-chat message queue ──────────────────────────────────────────────────
+// Messages from the same chat are processed one at a time (in order), but
+// different chats run concurrently — a slow plugin in one chat (e.g. sticker
+// generation) no longer blocks replies in every other chat.
+const chatQueues = new Map();
+function enqueueForChat(jid, task) {
+    const prev = chatQueues.get(jid) ?? Promise.resolve();
+    const settled = prev.catch(() => { }).then(task).catch((e) => {
+        const err = e instanceof Error ? e : new Error(String(e));
+        logger.error(`${err.message}\n${err.stack}`);
+    });
+    chatQueues.set(jid, settled);
+    settled.finally(() => {
+        if (chatQueues.get(jid) === settled)
+            chatQueues.delete(jid);
+    });
+}
+// Messages older than this (WhatsApp's own delivery delay — e.g. backlog
+// dumped after the bot reconnects) are skipped. Checked at arrival time,
+// so time spent waiting in chatQueues never counts against a message.
+const MAX_MESSAGE_AGE_SECONDS = 60;
+function isMessageStale(msg) {
+    const msgTimestamp = Number(msg.messageTimestamp);
+    if (!msgTimestamp)
+        return false;
+    const nowInSeconds = Math.floor(Date.now() / 1000);
+    const age = nowInSeconds - msgTimestamp;
+    if (age > MAX_MESSAGE_AGE_SECONDS) {
+        logger.debug(`[whatsapp] Skipping stale message (age: ${age}s, id: ${msg.key.id})`);
+        return true;
+    }
+    return false;
+}
 const RECONNECT_BASE_MS = 1000;
 const RECONNECT_MAX_MS = 60000;
 const CACHE_SAVE_INTERVAL_MS = 5 * 60 * 1000; // 5min
@@ -156,13 +189,10 @@ async function startBot() {
             const body = getBodyQuick(m);
             if (!body && !msgHasMediaQuick(m))
                 continue;
-            try {
-                await handleMessage(m, sock, store);
-            }
-            catch (e) {
-                const err = e instanceof Error ? e : new Error(String(e));
-                logger.error(`${err.message}\n${err.stack}`);
-            }
+            if (isMessageStale(m))
+                continue;
+            const jid = normalizeJid(m.key.remoteJid ?? "");
+            enqueueForChat(jid, () => handleMessage(m, sock, store));
         }
     });
 }

package/dist/drivers/whatsapp/messageHandler.js

@@ -45,14 +45,6 @@ function alreadyProcessed(id) {
  * @param {WAStore}    store
  */
 export async function handleMessage(msg, sock, store) {
-    const msgTimestamp = Number(msg.messageTimestamp);
-    if (msgTimestamp) {
-        const nowInSeconds = Math.floor(Date.now() / 1000);
-        const messageAge = nowInSeconds - msgTimestamp;
-        if (messageAge > 60) {
-            return;
-        }
-    }
     const rawJid = msg.key.remoteJid ?? "";
     const jid = normalizeJid(rawJid);
     if (CHATS.length > 0 && !CHATS.includes(jid)) {

package/package.json

@@ -5,7 +5,7 @@
     "name": "SyntaxError!",
     "email": "me@stxerr.dev"
   },
-  "version": "5.3.3",
+  "version": "5.4.1",
   "license": "GPL-3.0-only",
   "private": false,
   "engines": {