@manybot/manybot 5.8.0 → 5.9.0

package/dist/locales/en.json

@@ -30,6 +30,7 @@
     "schedulerError": "Plugin \"{{name}}\" scheduling error: {{message}}",
     "schedulerRegistered": "Schedule registered — plugin \"{{name}}\" → \"{{expression}}\"",
     "downloadJobFailed": "Download job failed — {{message}}",
+    "downloadJobNoErrorFn": "Download job failed and no errorFn was provided to enqueue()",
     "reconnecting": "Reconnecting in {{secs}}s...",
     "reconnectHalted": "Gave up reconnecting after {{attempts}} attempts — call connect() manually to retry. Repeated reconnect loops can make a WhatsApp restriction last longer.",
     "sessionExpired": "Session expired or logged out — removing local session and restarting...",
@@ -56,6 +57,13 @@
     "commandsConfigImportInvalidRoot": "commands.yaml: import \"{{path}}\" top-level must be a map of sections — skipped",
     "commandsConfigImportNested": "commands.yaml: import \"{{path}}\" declares its own \"import\" — nested imports are not supported and were ignored",
     "commandsConfigImportKeyConflict": "commands.yaml: import \"{{path}}\" redefines \"{{key}}\", already owned by \"{{owner}}\" — keeping the first one",
+    "commandsConfigCommandsWrapperInvalid": "commands.yaml: top-level \"commands:\" must be a map of command entries — ignored",
+    "commandsConfigCommandsWrapperCollision": "commands.yaml: \"commands:\" wrapper defines \"{{key}}\" that already exists at the top level — keeping the top-level entry",
+    "commandsConfigConflictingScopeFlags": "commands.yaml: \"permissions\" has both group_only and dm_only set to true — pick one (or use \"scope:\" directly)",
+    "commandsConfigLoadingPresetMissing": "commands.yaml: \"{{id}}\" loading preset \"{{name}}\" not found — leaving the field unset",
+    "commandsConfigLoadingInvalid": "commands.yaml: \"{{id}}\" loading value is not a preset name or inline object — ignored",
+    "commandsConfigLoadingUnknownType": "commands.yaml: \"{{id}}\" loading type \"{{type}}\" is not one of reaction|typing|recording_audio|spinner|none — ignored",
+    "commandsConfigLoadingUnknownProp": "commands.yaml: \"{{id}}\" loading type \"{{type}}\" does not accept property \"{{key}}\" — entry is malformed and was dropped",
     "commandRegistryOrphanEntry": "commandRegistry: entry \"{{id}}\" targets {{plugin}}.{{function}} but no active plugin provides it — skipped",
     "commandRegistryInvalidEntry": "commandRegistry: entry \"{{id}}\" has no plugin/function and no text — skipped",
     "commandRegistryInvocationCollision": "commandRegistry: invocation \"{{text}}\" already owned by \"{{winner}}\" — dropping {{loser}} ({{via}})",
@@ -66,6 +74,7 @@
     "commandDeprecationReservedInvocation": "commandRegistry: invocation \"{{text}}\" is reserved by active deprecation for \"{{id}}\" — refusing registration",
     "commandManualMissing": "No detailed manual available for command \"{{cmd}}\".",
     "commandNotFound": "Command or category \"{{cmd}}\" not found. Use {{prefix}}{{menuCmd}} to view the command list.",
+    "commandNotFoundSuggestion": "Command \"{{cmd}}\" not found. Did you mean {{prefix}}{{suggestion}}? Use {{prefix}}{{menuCmd}} to view the command list.",
     "commandRegistryMenuAliasCollision": "commandRegistry: menu alias \"{{alias}}\" collided with real command \"{{winner}}\" — menu alias ignored"
   },
   "errors": {
@@ -84,8 +93,11 @@
     "botNotAdmin": "This command requires the bot to be a group administrator.",
     "senderNotAdmin": "This command is restricted to group administrators.",
     "ownerOnly": "This command can only be run by the bot owner.",
+    "donoOnly": "This command can only be run by its designated owner.",
     "wrongScope": "This command cannot be used in this context.",
-    "cooldown": "Wait {{seconds}}s before using this command again."
+    "cooldown": "Wait {{seconds}}s before using this command again.",
+    "blacklist": "You are not allowed to use this command.",
+    "allowedChats": "This command is not available in this chat."
   },
   "commandRun": {
     "missingRequiredArg": "Missing required argument(s).",
@@ -101,6 +113,7 @@
   },
   "driver": {
     "groupParticipantNotFound": "\"{{id}}\" does not match a current participant in group \"{{group}}\" (check whether the person is still in the group, or use a reply/mention instead of typing the number).",
+    "cannotKickSelf": "Refusing to remove the bot itself from the group via admin.kick().",
     "groupParticipantsUpdateRejected": "groupParticipantsUpdate(\"{{action}}\") rejected for: {{detail}}",
     "groupParticipantsUpdateFailed": "groupParticipantsUpdate(\"{{action}}\") failed for group \"{{group}}\" with participants [{{users}}]: {{message}}",
     "pollDecryptFailed": "Failed to decrypt poll vote: {{error}}"

package/dist/locales/es.json

@@ -30,6 +30,7 @@
     "schedulerError": "Error en la programación del plugin \"{{name}}\": {{message}}",
     "schedulerRegistered": "Programación registrada — plugin \"{{name}}\" → \"{{expression}}\"",
     "downloadJobFailed": "Error en el trabajo de descarga — {{message}}",
+    "downloadJobNoErrorFn": "El trabajo de descarga falló y no se pasó errorFn a enqueue()",
     "reconnecting": "Reconectando en {{secs}}s...",
     "reconnectHalted": "Se dejó de reconectar tras {{attempts}} intentos — llama a connect() manualmente para reintentar. Los bucles de reconexión repetidos pueden prolongar una restricción de WhatsApp.",
     "sessionExpired": "Sesión expirada o cerrada — eliminando sesión local y reiniciando...",
@@ -56,6 +57,13 @@
     "commandsConfigImportInvalidRoot": "commands.yaml: el import \"{{path}}\" debe tener un mapa de secciones en el nivel raíz — se omitió",
     "commandsConfigImportNested": "commands.yaml: el import \"{{path}}\" declara su propio \"import\" — los imports anidados no son compatibles y se ignoraron",
     "commandsConfigImportKeyConflict": "commands.yaml: el import \"{{path}}\" redefine \"{{key}}\", que ya pertenece a \"{{owner}}\" — se conserva el primero",
+    "commandsConfigCommandsWrapperInvalid": "commands.yaml: el bloque superior \"commands:\" debe ser un mapa de comandos — se omitió",
+    "commandsConfigCommandsWrapperCollision": "commands.yaml: el bloque \"commands:\" define \"{{key}}\", que ya existe en el nivel superior — se conserva la entrada superior",
+    "commandsConfigConflictingScopeFlags": "commands.yaml: \"permissions\" tiene group_only y dm_only a la vez — elegí uno (o usá \"scope:\" directo)",
+    "commandsConfigLoadingPresetMissing": "commands.yaml: \"{{id}}\" referencia el preset de loading \"{{name}}\" que no existe — el campo queda vacío",
+    "commandsConfigLoadingInvalid": "commands.yaml: \"{{id}}\" el valor de loading no es nombre de preset ni objeto inline — se omitió",
+    "commandsConfigLoadingUnknownType": "commands.yaml: \"{{id}}\" el tipo de loading \"{{type}}\" no es uno de reaction|typing|recording_audio|spinner|none — se omitió",
+    "commandsConfigLoadingUnknownProp": "commands.yaml: \"{{id}}\" el tipo de loading \"{{type}}\" no acepta la propiedad \"{{key}}\" — la entrada está malformada y se descartó",
     "commandRegistryOrphanEntry": "commandRegistry: la entrada \"{{id}}\" apunta a {{plugin}}.{{function}} pero ningún plugin activo la provee — se omitió",
     "commandRegistryInvalidEntry": "commandRegistry: la entrada \"{{id}}\" no tiene plugin/function ni text — se omitió",
     "commandRegistryInvocationCollision": "commandRegistry: la invocación \"{{text}}\" ya pertenece a \"{{winner}}\" — descartando {{loser}} ({{via}})",
@@ -66,6 +74,7 @@
     "commandDeprecationReservedInvocation": "commandRegistry: la invocación \"{{text}}\" está reservada por deprecation activa de \"{{id}}\" — registro rechazado",
     "commandManualMissing": "No hay manual detallado disponible para el comando \"{{cmd}}\".",
     "commandNotFound": "Comando o categoría \"{{cmd}}\" no encontrado. Usa {{prefix}}{{menuCmd}} para ver la lista de comandos.",
+    "commandNotFoundSuggestion": "Comando \"{{cmd}}\" no encontrado. ¿Quisiste decir {{prefix}}{{suggestion}}? Usa {{prefix}}{{menuCmd}} para ver la lista de comandos.",
     "commandRegistryMenuAliasCollision": "commandRegistry: alias de menú \"{{alias}}\" colisionó con comando real \"{{winner}}\" — alias de menú ignorado"
   },
   "errors": {
@@ -82,10 +91,13 @@
   },
   "commandPermissions": {
     "botNotAdmin": "Este comando requiere que el bot sea administrador del grupo.",
-    "senderNotAdmin": "Este comando está restringido a administradores del grupo.",
-    "ownerOnly": "Este comando solo puede ser ejecutado por el dueño del bot.",
-    "wrongScope": "Este comando no puede usarse en este contexto.",
-    "cooldown": "Espera {{seconds}}s antes de volver a usar este comando."
+    "senderNotAdmin": "Este comando es solo para administradores del grupo.",
+    "ownerOnly": "Solo el dueño del bot puede usar este comando.",
+    "donoOnly": "Solo el dueño designado de este comando puede usarlo.",
+    "wrongScope": "Este comando no se puede usar en este contexto.",
+    "cooldown": "Esperá {{seconds}}s antes de usar este comando de nuevo.",
+    "blacklist": "No podés usar este comando.",
+    "allowedChats": "Este comando no está disponible en este chat."
   },
   "commandRun": {
     "missingRequiredArg": "Faltan argumentos obligatorios.",
@@ -101,6 +113,7 @@
   },
   "driver": {
     "groupParticipantNotFound": "\"{{id}}\" no coincide con ningún participante actual del grupo \"{{group}}\" (comprueba si la persona sigue en el grupo o usa una respuesta/mención en lugar de escribir el número).",
+    "cannotKickSelf": "Se rechaza eliminar al propio bot del grupo mediante admin.kick().",
     "groupParticipantsUpdateRejected": "groupParticipantsUpdate(\"{{action}}\") rechazado para: {{detail}}",
     "groupParticipantsUpdateFailed": "groupParticipantsUpdate(\"{{action}}\") falló para el grupo \"{{group}}\" con participantes [{{users}}]: {{message}}",
     "pollDecryptFailed": "No se pudo descifrar el voto de la encuesta: {{error}}"

package/dist/locales/pt.json

@@ -30,6 +30,7 @@
     "schedulerError": "Erro no agendamento do plugin \"{{name}}\": {{message}}",
     "schedulerRegistered": "Agendamento registrado — plugin \"{{name}}\" → \"{{expression}}\"",
     "downloadJobFailed": "Falha no job de download — {{message}}",
+    "downloadJobNoErrorFn": "Job de download falhou e nenhum errorFn foi passado para enqueue()",
     "reconnecting": "Reconectando em {{secs}}s...",
     "reconnectHalted": "Desisti de reconectar após {{attempts}} tentativas — chame connect() manualmente para tentar de novo. Loops de reconexão repetidos podem prolongar uma restrição do WhatsApp.",
     "sessionExpired": "Sessão expirada ou desconectada — removendo sessão local e reiniciando...",
@@ -56,6 +57,13 @@
     "commandsConfigImportInvalidRoot": "commands.yaml: o import \"{{path}}\" precisa ter um mapa de seções no nível raiz — ignorado",
     "commandsConfigImportNested": "commands.yaml: o import \"{{path}}\" declara seu próprio \"import\" — imports aninhados não são suportados e foram ignorados",
     "commandsConfigImportKeyConflict": "commands.yaml: o import \"{{path}}\" redefine \"{{key}}\", que já pertence a \"{{owner}}\" — mantendo o primeiro",
+    "commandsConfigCommandsWrapperInvalid": "commands.yaml: o bloco \"commands:\" de topo precisa ser um mapa de comandos — ignorado",
+    "commandsConfigCommandsWrapperCollision": "commands.yaml: o bloco \"commands:\" define \"{{key}}\", que já existe no nível de topo — mantendo a entrada do topo",
+    "commandsConfigConflictingScopeFlags": "commands.yaml: \"permissions\" tem group_only e dm_only ao mesmo tempo — escolha um (ou use \"scope:\" direto)",
+    "commandsConfigLoadingPresetMissing": "commands.yaml: \"{{id}}\" referencia o preset de loading \"{{name}}\" que não existe — campo fica vazio",
+    "commandsConfigLoadingInvalid": "commands.yaml: \"{{id}}\" o valor de loading não é nome de preset nem objeto inline — ignorado",
+    "commandsConfigLoadingUnknownType": "commands.yaml: \"{{id}}\" o tipo de loading \"{{type}}\" não é um dos reaction|typing|recording_audio|spinner|none — ignorado",
+    "commandsConfigLoadingUnknownProp": "commands.yaml: \"{{id}}\" o tipo de loading \"{{type}}\" não aceita a propriedade \"{{key}}\" — entrada malformada, descartada",
     "commandRegistryOrphanEntry": "commandRegistry: entrada \"{{id}}\" aponta para {{plugin}}.{{function}} mas nenhum plugin ativo fornece — ignorada",
     "commandRegistryInvalidEntry": "commandRegistry: entrada \"{{id}}\" não tem plugin/function nem text — ignorada",
     "commandRegistryInvocationCollision": "commandRegistry: invocação \"{{text}}\" já pertence a \"{{winner}}\" — descartando {{loser}} ({{via}})",
@@ -66,6 +74,7 @@
     "commandDeprecationReservedInvocation": "commandRegistry: invocação \"{{text}}\" está reservada por deprecation ativa de \"{{id}}\" — registro recusado",
     "commandManualMissing": "Nenhum manual detalhado disponível para o comando \"{{cmd}}\".",
     "commandNotFound": "Comando ou categoria \"{{cmd}}\" não encontrado. Use {{prefix}}{{menuCmd}} para ver a lista de comandos.",
+    "commandNotFoundSuggestion": "Comando \"{{cmd}}\" não encontrado. Você quis dizer {{prefix}}{{suggestion}}? Use {{prefix}}{{menuCmd}} para ver a lista de comandos.",
     "commandRegistryMenuAliasCollision": "commandRegistry: alias de menu \"{{alias}}\" colidiu com comando real \"{{winner}}\" — alias de menu ignorado"
   },
   "errors": {
@@ -81,11 +90,14 @@
     "description": "Descrição"
   },
   "commandPermissions": {
-    "botNotAdmin": "Este comando exige que o bot seja administrador do grupo.",
-    "senderNotAdmin": "Este comando é restrito a administradores do grupo.",
-    "ownerOnly": "Este comando só pode ser executado pelo dono do bot.",
-    "wrongScope": "Este comando não pode ser usado neste contexto.",
-    "cooldown": "Aguarde {{seconds}}s antes de usar este comando novamente."
+    "botNotAdmin": "Esse comando precisa que o bot seja admin do grupo.",
+    "senderNotAdmin": "Esse comando é só pra admins do grupo.",
+    "ownerOnly": "Só o dono do bot pode usar esse comando.",
+    "donoOnly": "Só o dono designado desse comando pode usá-lo.",
+    "wrongScope": "Esse comando não funciona aqui.",
+    "cooldown": "Espera {{seconds}}s antes de usar esse comando de novo.",
+    "blacklist": "Você não pode usar esse comando.",
+    "allowedChats": "Esse comando não está disponível nesse chat."
   },
   "commandRun": {
     "missingRequiredArg": "Faltam argumentos obrigatórios.",
@@ -101,6 +113,7 @@
   },
   "driver": {
     "groupParticipantNotFound": "\"{{id}}\" não corresponde a nenhum participante atual do grupo \"{{group}}\" (confira se a pessoa ainda está no grupo, ou use reply/menção em vez de digitar o número).",
+    "cannotKickSelf": "Removendo o próprio bot do grupo via admin.kick() recusado.",
     "groupParticipantsUpdateRejected": "groupParticipantsUpdate(\"{{action}}\") rejeitado para: {{detail}}",
     "groupParticipantsUpdateFailed": "groupParticipantsUpdate(\"{{action}}\") falhou para o grupo \"{{group}}\" com participantes [{{users}}]: {{message}}",
     "pollDecryptFailed": "Erro ao decriptar voto da enquete: {{error}}"

package/dist/plugins/__manybot_integration__/index.js

@@ -102,24 +102,41 @@ export const api = {
 export async function setup(ctx) {
     // The integration chat is decided by the harness BEFORE
     // setupPlugins() is called. Historically the harness set
-    // MANYBOT_TEST_CHAT, but users often set TEST_CHAT (per docs).
-    // Accept either, normalizing the value to the canonical JID form.
-    // Keep behavior strict: if neither is set, fail.
-    const rawEnv = process.env.MANYBOT_TEST_CHAT ?? process.env.TEST_CHAT;
-    if (!rawEnv) {
-        throw new Error(`[${INTEGRATION_PLUGIN_NAME}] setup() called without MANYBOT_TEST_CHAT or TEST_CHAT — ` +
-            `set MANYBOT_TEST_CHAT (preferred) or TEST_CHAT before setupPlugins().`);
-    }
-    // Normalize and validate the provided chat identifier.
+    // MANYBOT_TEST_CHAT, but users often set TEST_CHAT (per docs) —
+    // either as an env var or as a `TEST_CHAT` key in manybot.toml.
+    //
+    // `kernel/integrationMode.ts`'s own gate (`getIntegrationModeStatus`,
+    // which is what decided integration mode was "ready" and logged as
+    // much before this plugin's setup() ever ran) resolves TEST_CHAT via
+    // `getTestConfig()` — env var first, then manybot.toml. Reading
+    // straight off `process.env.TEST_CHAT` here (as this used to)
+    // silently diverged from that: the gate would report ready off a
+    // toml-only value while this threw "no TEST_CHAT set", because it
+    // never looked at the toml. Importing normalizeTestChat/getTestConfig
+    // here (rather than at module top) keeps the module load cheap when
+    // the plugin isn't used in production code paths.
+    //
+    // MANYBOT_TEST_CHAT remains a preferred override on top of that, for
+    // callers that want to point this specific plugin at a different
+    // chat than the gate's own resolution.
+    const { getTestConfig, normalizeTestChat } = await import("#kernel/testConfig.js");
     let normalized;
-    try {
-        // Importing normalizeTestChat here keeps the module load cheap
-        // when the plugin isn't used in production code paths.
-        const { normalizeTestChat } = await import("#kernel/testConfig.js");
-        normalized = normalizeTestChat(rawEnv);
+    const overrideEnv = process.env.MANYBOT_TEST_CHAT;
+    if (overrideEnv) {
+        try {
+            normalized = normalizeTestChat(overrideEnv);
+        }
+        catch (e) {
+            throw new Error(`[${INTEGRATION_PLUGIN_NAME}] invalid MANYBOT_TEST_CHAT provided: ${e.message}`);
+        }
     }
-    catch (e) {
-        throw new Error(`[${INTEGRATION_PLUGIN_NAME}] invalid test chat provided: ${e.message}`);
+    else {
+        const cfg = await getTestConfig();
+        if (!cfg.chat) {
+            throw new Error(`[${INTEGRATION_PLUGIN_NAME}] setup() called without MANYBOT_TEST_CHAT or TEST_CHAT — ` +
+                `set MANYBOT_TEST_CHAT (preferred), or TEST_CHAT (env var or manybot.toml), before setupPlugins().`);
+        }
+        normalized = cfg.chat;
     }
     configuredTestChat = normalized;
     api.testChat = normalized;

package/dist/plugins/__manybot_integration__/index.test.js

@@ -1,5 +1,6 @@
 import assert from "node:assert/strict";
 import { after, beforeEach, describe, test } from "node:test";
+import { _resetTestConfigForTests } from "#kernel/testConfig.js";
 const integrationPluginUrl = new URL("../../plugins/__manybot_integration__/index.ts", import.meta.url).href;
 describe("plugins/__manybot_integration__", () => {
     let mod;
@@ -7,13 +8,23 @@ describe("plugins/__manybot_integration__", () => {
         // Use a cache-busting query so each test gets a fresh module
         // (and therefore a fresh ring buffer + EventEmitter).
         mod = await import(`${integrationPluginUrl}?t=${Date.now()}-${Math.random()}`);
+        // setup() now falls back to kernel/testConfig.js's getTestConfig()
+        // for the TEST_CHAT-only case (see setup()'s comment), and that
+        // module caches its result in-process after the first read. Tests
+        // in this file mutate TEST_CHAT/MANYBOT_TEST_CHAT freely between
+        // cases, so the cache must be dropped before every test or a
+        // stale resolution from an earlier test leaks in.
+        _resetTestConfigForTests();
     });
     after(async () => {
         // Best-effort cleanup; nothing in the plugin subscribes to
         // process-level resources, but we re-clear the configured
-        // chat so a subsequent suite (e.g. loadIntegrationPlugin.test.ts)
-        // starts blank.
+        // chat (and the testConfig cache it now feeds through) so a
+        // subsequent suite (e.g. loadIntegrationPlugin.test.ts) starts
+        // blank.
         process.env.MANYBOT_TEST_CHAT = "";
+        delete process.env.TEST_CHAT;
+        _resetTestConfigForTests();
     });
     test("exports default, setup, and api", () => {
         assert.equal(typeof mod.default, "function");
@@ -27,11 +38,14 @@ describe("plugins/__manybot_integration__", () => {
     test("api.recentBodies() starts empty", () => {
         assert.deepEqual(mod.api.recentBodies(), []);
     });
-    test("setup() throws when MANYBOT_TEST_CHAT is unset", async () => {
-        delete process.env.MANYBOT_TEST_CHAT;
-        const { ctx } = makeSetupCtx();
-        await assert.rejects(mod.setup(ctx), /MANYBOT_TEST_CHAT/);
-    });
+    // Note: the previous "setup() throws when MANYBOT_TEST_CHAT is unset" test
+    // was removed when the resolution path was widened to env-or-toml (see the
+    // `setup() agrees with integrationMode's own gate` regression test below).
+    // With toml resolution in scope, "unset" can only be asserted by also
+    // clearing the toml — that's testConfig.test.ts's territory, not this
+    // plugin's. The plugin-specific throw cases (invalid format, missing
+    // MANYBOT_TEST_CHAT override while TEST_CHAT is empty, etc.) are covered
+    // by the remaining tests below.
     test("setup() captures the test chat and isTestChat accepts it", async () => {
         process.env.MANYBOT_TEST_CHAT = "5516999999999@s.whatsapp.net";
         const { ctx } = makeSetupCtx();
@@ -122,10 +136,30 @@ describe("plugins/__manybot_integration__", () => {
         assert.equal(mod.api.testChat, "5516999998888@s.whatsapp.net");
         assert.equal(mod.api.isTestChat("5516999998888@s.whatsapp.net"), true);
     });
+    test("setup() agrees with integrationMode's own gate (both resolve TEST_CHAT via getTestConfig)", async () => {
+        // Regression test: setup() used to read process.env.TEST_CHAT
+        // directly, which diverged from kernel/integrationMode.ts's gate
+        // (getIntegrationModeStatus -> getTestConfig, env-or-toml). That
+        // let the gate report "ready" off a value setup() couldn't see —
+        // this pins the two to the same resolution instead.
+        delete process.env.MANYBOT_TEST_CHAT;
+        process.env.TEST_CHAT = "5516999997777@s.whatsapp.net";
+        const { getTestConfig } = await import("#kernel/testConfig.js");
+        const { getIntegrationModeStatus } = await import("#kernel/integrationMode.js");
+        _resetTestConfigForTests();
+        const gateStatus = await getIntegrationModeStatus();
+        const { ctx } = makeSetupCtx();
+        await mod.setup(ctx);
+        assert.equal(gateStatus.chat, mod.api.testChat, "gate and setup() must resolve the same chat");
+        assert.equal(mod.api.testChat, "5516999997777@s.whatsapp.net");
+        // Sanity: both are backed by the same cached getTestConfig() call.
+        const cfg = await getTestConfig();
+        assert.equal(cfg.chat, mod.api.testChat);
+    });
     test("setup() throws when given an invalid test chat format", async () => {
         process.env.MANYBOT_TEST_CHAT = "not_a_valid_jid";
         const { ctx } = makeSetupCtx();
-        await assert.rejects(mod.setup(ctx), /invalid test chat provided/);
+        await assert.rejects(mod.setup(ctx), /invalid MANYBOT_TEST_CHAT provided/);
     });
     test("ring buffer caps at 50 messages and evicts oldest", async () => {
         process.env.MANYBOT_TEST_CHAT = "5516999999999@s.whatsapp.net";

package/dist/utils/phoneNumber.js

@@ -0,0 +1,83 @@
+/**
+ * src/utils/phoneNumber.ts
+ *
+ * Phone-number normalization built on `libphonenumber-js`. Centralized so
+ * the Baileys adapter, the `whatsmeow` driver, and any future call site
+ * produce a single, consistent shape for the `IContact` returned to
+ * plugins:
+ *
+ *   {
+ *     number:            "+12025550100",     // E.164 with leading "+"
+ *     numberRaw:         "12025550100",      // digits only, no "+"
+ *     numberPretty:      "+1 202 555-0100",  // formatInternational()
+ *     country:           "US",               // ISO 3166-1 alpha-2
+ *     countryCallingCode: "1",               // ITU calling code
+ *   }
+ *
+ * When the input is not a parseable phone number (bot JIDs, group JIDs,
+ * random strings, malformed numbers) every field is `null`. The helper
+ * never throws and never calls the network — it's a pure synchronous
+ * transform over the digits.
+ *
+ * `libphonenumber-js` has many format variants; we pick `formatInternational()`
+ * for `numberPretty` because it's the form most users expect to see in
+ * a chat reply ("+63 938 346-4136") and it preserves the country-code
+ * prefix unambiguously.
+ */
+import parsePhoneNumber from "libphonenumber-js";
+/** All-null {@link ParsedPhoneNumber} — the obvious return value when
+ *  the input isn't a phone number at all. Exported so test code (and
+ *  any consumer that wants to deep-compare) has a stable reference. */
+export const NULL_PHONE = Object.freeze({
+    number: null,
+    numberRaw: null,
+    numberPretty: null,
+    country: null,
+    countryCallingCode: null,
+});
+function isParseable(p) {
+    // libphonenumber-js's `parsePhoneNumberFromString` returns a PhoneNumber
+    // even for garbage input — but `country` is only set when the parser
+    // could pin a country. Use that as the "this is a real phone" signal:
+    // a country-less parse has nothing useful to say about country/CC.
+    return Boolean(p && p.country);
+}
+/**
+ * Parse a phone number into the canonical ManyBot shape. Accepts either
+ * a phone-based JID (`"5511999999999@s.whatsapp.net"`), a `@c.us` legacy
+ * form (`"5511999999999@c.us"`), or a plain digit string. Returns the
+ * all-null `NULL_PHONE` when the input is empty, a non-phone JID (group
+ * `@g.us`, bot meta-AI, status broadcast), or simply not parseable.
+ */
+export function parsePhone(value) {
+    if (!value)
+        return NULL_PHONE;
+    // Strip JID wrapper if present. Anything ending in a non-`@s.whatsapp.net` /
+    // non-`@c.us` server (groups, status, newsletters, bot meta) isn't a phone
+    // number at all — short-circuit to NULL_PHONE before calling the parser.
+    const isJid = value.includes("@");
+    if (isJid) {
+        const server = value.slice(value.indexOf("@") + 1);
+        if (server !== "s.whatsapp.net" && server !== "c.us")
+            return NULL_PHONE;
+    }
+    const digits = value.replace(/\D/g, "");
+    if (!digits)
+        return NULL_PHONE;
+    // Try the raw digit form first (covers the "5511999999999@s.whatsapp.net"
+    // case where the parser knows no default country); the "+"-prefixed form
+    // second (covers "5511999999999" when a default country is supplied by the
+    // caller). Without a country hint libphonenumber-js can't tell a Brazilian
+    // 55-prefix from a Portuguese 55-prefix and returns no country — that's
+    // why the wrapper JID case is the common path.
+    const parsed = parsePhoneNumber(value) ?? parsePhoneNumber("+" + digits);
+    if (!isParseable(parsed))
+        return NULL_PHONE;
+    return {
+        number: parsed.number,
+        numberRaw: digits,
+        numberPretty: parsed.formatInternational(),
+        country: parsed.country ?? null,
+        countryCallingCode: parsed.countryCallingCode ?? null,
+    };
+}

package/dist/utils/phoneNumber.test.js

@@ -0,0 +1,53 @@
+import assert from "node:assert/strict";
+import test from "node:test";
+import { parsePhone, NULL_PHONE } from "#utils/phoneNumber.js";
+test("parsePhone — US number (NANPA +1)", () => {
+    // Use the 555-0100 reserved-for-fiction range so the example never
+    // collides with a real subscriber anywhere on Earth.
+    const r = parsePhone("+12025550100");
+    assert.equal(r.number, "+12025550100");
+    assert.equal(r.numberRaw, "12025550100");
+    assert.equal(r.country, "US");
+    assert.equal(r.countryCallingCode, "1");
+    assert.match(r.numberPretty, /^\+1 /);
+});
+test("parsePhone — BR number from @s.whatsapp.net JID", () => {
+    const r = parsePhone("5516999999999@s.whatsapp.net");
+    assert.equal(r.number, "+5516999999999");
+    assert.equal(r.numberRaw, "5516999999999");
+    assert.equal(r.country, "BR");
+    assert.equal(r.countryCallingCode, "55");
+    assert.match(r.numberPretty, /^\+55 /);
+});
+test("parsePhone — US number with leading +", () => {
+    const r = parsePhone("+14155552671");
+    assert.equal(r.country, "US");
+    assert.equal(r.countryCallingCode, "1");
+    assert.equal(r.numberRaw, "14155552671");
+});
+test("parsePhone — group JID is not a phone number", () => {
+    // @g.us must NOT be parsed as a phone number, even though its user-part
+    // is digit-only. The wrapper short-circuits to NULL_PHONE.
+    assert.deepEqual(parsePhone("120363402117932687@g.us"), NULL_PHONE);
+});
+test("parsePhone — status/broadcast/newsletter JIDs are not phones", () => {
+    assert.deepEqual(parsePhone("status@broadcast"), NULL_PHONE);
+    assert.deepEqual(parsePhone("0@c.us"), NULL_PHONE);
+});
+test("parsePhone — empty / null / undefined all return NULL_PHONE", () => {
+    assert.deepEqual(parsePhone(""), NULL_PHONE);
+    assert.deepEqual(parsePhone(null), NULL_PHONE);
+    assert.deepEqual(parsePhone(undefined), NULL_PHONE);
+});
+test("parsePhone — unparseable digit string returns NULL_PHONE", () => {
+    // 7 digits with no country hint → libphonenumber-js returns no country
+    // for the raw form and no useful result for the +N form either.
+    assert.deepEqual(parsePhone("1234567"), NULL_PHONE);
+});
+test("parsePhone — accepts the legacy @c.us form (framework internal JID)", () => {
+    // Some code paths still hand us the framework's normalized "@c.us" form
+    // instead of the raw "@s.whatsapp.net" one. Both should parse identically.
+    const wire = parsePhone("5516999999999@s.whatsapp.net");
+    const internal = parsePhone("5516999999999@c.us");
+    assert.deepEqual(internal, wire);
+});

package/package.json

@@ -5,7 +5,7 @@
     "name": "SyntaxError!",
     "email": "me@stxerr.dev"
   },
-  "version": "5.8.0",
+  "version": "5.9.0",
   "license": "GPL-3.0-only",
   "private": false,
   "engines": {
@@ -33,7 +33,7 @@
     "test:integration": "NODE_ENV=test MANYBOT_RUN_WHATSAPP_TESTS=1 bash -O globstar -c 'tsx --conditions development --test src/**/*.integration.test.ts'",
     "test:integration:local": "NODE_ENV=test MANYBOT_RUN_WHATSAPP_TESTS=1 bash -O globstar -c 'tsx --conditions development --import ./src/main.ts --test src/**/*.integration.test.ts'",
     "typecheck": "tsc --noEmit",
-    "check": "npm run typecheck && npm run lint && npm run test"
+    "check": "npm run typecheck && npm run lint && npm run test && npx tsx scripts/check-types-drift.ts"
   },
   "devDependencies": {
     "@eslint/js": "^10.0.1",
@@ -51,8 +51,9 @@
     "@grpc/grpc-js": "^1.14.4",
     "@grpc/proto-loader": "^0.7.15",
     "@hapi/boom": "^10.0.1",
-    "@whiskeysockets/baileys": "6.7.24",
+    "@whiskeysockets/baileys": "^7.0.0-rc14",
     "js-yaml": "^5.2.3",
+    "libphonenumber-js": "^1.13.11",
     "node-cron": "^4.6.0",
     "node-webpmux": "^3.2.1",
     "nodemailer": "^9.0.3",