@manybot/manybot 5.7.0 → 5.9.0

package/dist/kernel/testConfig.test.js

@@ -0,0 +1,181 @@
+import test, { describe, before, after, beforeEach } from "node:test";
+import assert from "node:assert/strict";
+import fs from "fs/promises";
+import os from "os";
+import path from "path";
+const configDir = await fs.mkdtemp(path.join(os.tmpdir(), "manybot-test-config-"));
+process.env.MANYBOT_CONFIG_DIR = configDir;
+const { getTestConfig, requireTestConfig, normalizeTestChat, _resetTestConfigForTests, TEST_CHAT_ENV, RUN_WHATSAPP_TESTS_ENV, TEST_CHAT_TOML_KEY, } = await import("#kernel/testConfig.js");
+const { TOML_CONFIG_FILE } = await import("#config");
+const tomlPath = path.join(configDir, "manybot.toml");
+async function writeToml(contents) {
+    await fs.writeFile(tomlPath, contents, "utf8");
+}
+function clearEnv() {
+    delete process.env[TEST_CHAT_ENV];
+    delete process.env[RUN_WHATSAPP_TESTS_ENV];
+}
+before(async () => {
+    await fs.writeFile(tomlPath, "", "utf8");
+});
+beforeEach(async () => {
+    clearEnv();
+    await writeToml("");
+    _resetTestConfigForTests();
+});
+after(async () => {
+    clearEnv();
+    await fs.rm(configDir, { recursive: true, force: true });
+});
+describe("kernel/testConfig — normalizeTestChat", () => {
+    test("accepts a bare number and normalizes to @s.whatsapp.net", () => {
+        assert.equal(normalizeTestChat("5516999999999"), "5516999999999@s.whatsapp.net");
+    });
+    test("accepts a leading + on bare numbers", () => {
+        assert.equal(normalizeTestChat("+5516999999999"), "5516999999999@s.whatsapp.net");
+    });
+    test("preserves @c.us", () => {
+        assert.equal(normalizeTestChat("5516999999999@c.us"), "5516999999999@c.us");
+    });
+    test("preserves @s.whatsapp.net", () => {
+        assert.equal(normalizeTestChat("5516999999999@s.whatsapp.net"), "5516999999999@s.whatsapp.net");
+    });
+    test("preserves @lid", () => {
+        assert.equal(normalizeTestChat("12345@lid"), "12345@lid");
+    });
+    test("preserves @g.us", () => {
+        assert.equal(normalizeTestChat("120363012345678@g.us"), "120363012345678@g.us");
+    });
+    test("trims surrounding whitespace", () => {
+        assert.equal(normalizeTestChat("  5516999999999  "), "5516999999999@s.whatsapp.net");
+    });
+    test("rejects empty string", () => {
+        assert.throws(() => normalizeTestChat(""), /empty/);
+    });
+    test("rejects non-string input", () => {
+        assert.throws(() => normalizeTestChat(undefined), /string/);
+    });
+    test("rejects unknown suffix", () => {
+        assert.throws(() => normalizeTestChat("foo@example.com"), /JID/);
+    });
+    test("rejects JID with bad chars in the local part", () => {
+        assert.throws(() => normalizeTestChat("5516!@c.us"), /local part/);
+    });
+});
+describe("kernel/testConfig — getTestConfig", () => {
+    test("returns null chat and skipReason when nothing is configured", async () => {
+        const cfg = await getTestConfig();
+        assert.equal(cfg.chat, null);
+        assert.equal(cfg.source, null);
+        assert.equal(cfg.runWhatsApp, false);
+        assert.match(cfg.skipReason, /TEST_CHAT is not set/);
+    });
+    test("env wins over TOML", async () => {
+        await writeToml(`${TEST_CHAT_TOML_KEY} = "5516000000001"\n`);
+        process.env[TEST_CHAT_ENV] = "5516000000002";
+        const cfg = await getTestConfig();
+        assert.equal(cfg.chat, "5516000000002@s.whatsapp.net");
+        assert.equal(cfg.source, "env");
+    });
+    test("falls back to TOML when env is unset", async () => {
+        await writeToml(`${TEST_CHAT_TOML_KEY} = "5516000000003"\n`);
+        const cfg = await getTestConfig();
+        assert.equal(cfg.chat, "5516000000003@s.whatsapp.net");
+        assert.equal(cfg.source, "toml");
+    });
+    test("empty string in TOML is treated as absent", async () => {
+        await writeToml(`${TEST_CHAT_TOML_KEY} = ""\n`);
+        const cfg = await getTestConfig();
+        assert.equal(cfg.chat, null);
+    });
+    test("whitespace-only env is treated as absent", async () => {
+        process.env[TEST_CHAT_ENV] = "   ";
+        const cfg = await getTestConfig();
+        assert.equal(cfg.chat, null);
+    });
+    test("invalid value in TOML is ignored (warning logged, not thrown)", async () => {
+        await writeToml(`${TEST_CHAT_TOML_KEY} = "not-a-valid-jid@x.com"\n`);
+        const cfg = await getTestConfig();
+        assert.equal(cfg.chat, null);
+    });
+    test("non-string TOML value is ignored", async () => {
+        await writeToml(`${TEST_CHAT_TOML_KEY} = 42\n`);
+        const cfg = await getTestConfig();
+        assert.equal(cfg.chat, null);
+    });
+    test("runWhatsApp is true only when env equals '1'", async () => {
+        process.env[TEST_CHAT_ENV] = "5516000000004";
+        process.env[RUN_WHATSAPP_TESTS_ENV] = "1";
+        const on = await getTestConfig();
+        assert.equal(on.runWhatsApp, true);
+        _resetTestConfigForTests();
+        process.env[RUN_WHATSAPP_TESTS_ENV] = "true";
+        const off1 = await getTestConfig();
+        assert.equal(off1.runWhatsApp, false);
+        _resetTestConfigForTests();
+        process.env[RUN_WHATSAPP_TESTS_ENV] = "0";
+        const off2 = await getTestConfig();
+        assert.equal(off2.runWhatsApp, false);
+        _resetTestConfigForTests();
+        delete process.env[RUN_WHATSAPP_TESTS_ENV];
+        const off3 = await getTestConfig();
+        assert.equal(off3.runWhatsApp, false);
+    });
+    test("skipReason explains the missing opt-in even when TEST_CHAT is set", async () => {
+        await writeToml(`${TEST_CHAT_TOML_KEY} = "5516000000005"\n`);
+        const cfg = await getTestConfig();
+        assert.equal(cfg.chat, "5516000000005@s.whatsapp.net");
+        assert.equal(cfg.runWhatsApp, false);
+        assert.match(cfg.skipReason, /MANYBOT_RUN_WHATSAPP_TESTS=1/);
+    });
+    test("skipReason is null when everything is configured", async () => {
+        process.env[TEST_CHAT_ENV] = "5516000000006";
+        process.env[RUN_WHATSAPP_TESTS_ENV] = "1";
+        const cfg = await getTestConfig();
+        assert.equal(cfg.skipReason, null);
+    });
+    test("result is cached across calls within the same process", async () => {
+        process.env[TEST_CHAT_ENV] = "5516000000007";
+        const first = await getTestConfig();
+        process.env[TEST_CHAT_ENV] = "5516000000008";
+        const second = await getTestConfig();
+        assert.equal(first.chat, second.chat, "cache must not re-read env");
+        _resetTestConfigForTests();
+        const third = await getTestConfig();
+        assert.equal(third.chat, "5516000000008@s.whatsapp.net");
+    });
+    test("missing manybot.toml is treated as 'no value'", async () => {
+        await fs.rm(tomlPath, { force: true });
+        const cfg = await getTestConfig();
+        assert.equal(cfg.chat, null);
+        assert.equal(cfg.source, null);
+    });
+    test("malformed TOML is logged and treated as 'no value'", async () => {
+        await fs.writeFile(tomlPath, "this is not valid = = toml =", "utf8");
+        const cfg = await getTestConfig();
+        assert.equal(cfg.chat, null);
+    });
+});
+describe("kernel/testConfig — requireTestConfig", () => {
+    test("returns config when fully configured", async () => {
+        process.env[TEST_CHAT_ENV] = "5516000000009";
+        process.env[RUN_WHATSAPP_TESTS_ENV] = "1";
+        const cfg = await requireTestConfig();
+        assert.equal(cfg.chat, "5516000000009@s.whatsapp.net");
+        assert.equal(cfg.runWhatsApp, true);
+    });
+    test("throws when TEST_CHAT is missing", async () => {
+        process.env[RUN_WHATSAPP_TESTS_ENV] = "1";
+        await assert.rejects(requireTestConfig(), /TEST_CHAT is not set/);
+    });
+    test("throws when opt-in is missing", async () => {
+        process.env[TEST_CHAT_ENV] = "5516000000010";
+        await assert.rejects(requireTestConfig(), /MANYBOT_RUN_WHATSAPP_TESTS=1/);
+    });
+});
+// smoke: TOML_CONFIG_FILE should point inside the temp config dir
+describe("kernel/testConfig — wiring", () => {
+    test("TOML_CONFIG_FILE respects MANYBOT_CONFIG_DIR", () => {
+        assert.equal(TOML_CONFIG_FILE, tomlPath);
+    });
+});

package/dist/kernel/updateCheck.js

@@ -2,13 +2,19 @@
  * updateCheck.ts
  *
  * Compares the locally installed manybot version against the latest
- * published on npm, and fires an "info" alert (via alerts.ts) when a
+ * GitHub Release and fires an "info" alert (via alerts.ts) when a
  * newer version is available. Runs once on startup and then on a
  * schedule — both configurable (UPDATE_CHECK_ENABLED,
  * UPDATE_CHECK_INTERVAL_HOURS).
  *
- * Never throws — a failed check (offline, npm down) is logged at debug
- * level and silently skipped; it'll just try again next cycle.
+ * GitHub Releases is the source of truth for distribution: release
+ * candidate tags (-rc.N) skip npm entirely, and stable releases stay
+ * in "staged" on npm until a manual 2FA approval lands, so reading
+ * registry.npmjs.org here would either miss an already-published
+ * version or notify about one only after a long delay.
+ *
+ * Never throws — a failed check (offline, GitHub down) is logged at
+ * debug level and silently skipped; it'll just try again next cycle.
  */
 import { readFileSync } from "fs";
 import { fileURLToPath } from "url";
@@ -16,10 +22,11 @@ import path from "path";
 import { UPDATE_CHECK_ENABLED, UPDATE_CHECK_INTERVAL_HOURS } from "#config";
 import { sendAlert } from "#kernel/alerts.js";
 import { logger } from "#logger";
+import { t } from "#i18n";
 const __filename = fileURLToPath(import.meta.url);
 const __dirname = path.dirname(__filename);
 const pkg = JSON.parse(readFileSync(path.join(__dirname, "../../package.json"), "utf8"));
-const REGISTRY_URL = `https://registry.npmjs.org/${encodeURIComponent(pkg.name)}/latest`;
+const GITHUB_RELEASES_LATEST = "https://api.github.com/repos/many-bot/manybot/releases/latest";
 /** Naive semver compare — good enough for x.y.z, no pre-release handling. */
 function isNewer(latest, current) {
     const a = latest.split(".").map(Number);
@@ -34,6 +41,14 @@ function isNewer(latest, current) {
     }
     return false;
 }
+/**
+ * GitHub tags come prefixed with "v" (e.g. "v5.7.0"). Strip it so we
+ * can compare against pkg.version directly and render the upgrade
+ * command without the prefix.
+ */
+function stripTagPrefix(tag) {
+    return tag.startsWith("v") ? tag.slice(1) : tag;
+}
 let alreadyNotifiedFor = null;
 /**
  * Runs a single check. Safe to call anytime (startup, interval, manual
@@ -43,23 +58,31 @@ export async function checkForUpdate() {
     if (!UPDATE_CHECK_ENABLED)
         return;
     try {
-        const res = await fetch(REGISTRY_URL);
+        const res = await fetch(GITHUB_RELEASES_LATEST);
         if (!res.ok) {
-            logger.debug(`[updateCheck] npm registry responded ${res.status}`);
+            logger.debug(`[updateCheck] GitHub Releases responded ${res.status}`);
             return;
         }
         const data = await res.json();
-        const latest = data.version;
-        if (!latest || !isNewer(latest, pkg.version))
+        const rawTag = data.tag_name;
+        if (!rawTag)
+            return;
+        const latest = stripTagPrefix(rawTag);
+        if (!isNewer(latest, pkg.version))
             return;
         // Don't re-alert every cycle for the same version once already notified.
         if (alreadyNotifiedFor === latest)
             return;
         alreadyNotifiedFor = latest;
+        const releaseUrl = `https://github.com/many-bot/manybot/releases/tag/${rawTag}`;
         await sendAlert({
             level: "info",
-            title: "Nova versão do manybot disponível",
-            message: `Instalada: ${pkg.version} → disponível: ${latest}. Rode "npm install -g ${pkg.name}@${latest}" (ou equivalente) para atualizar.`,
+            title: t("alerts.updateAvailableTitle"),
+            message: t("alerts.updateAvailableMessage", {
+                installed: pkg.version,
+                available: latest,
+                url: releaseUrl,
+            }),
         });
     }
     catch (e) {

package/dist/locales/en.json

@@ -30,19 +30,94 @@
     "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...",
     "cacheLoaded": "{{count}} chat(s) loaded from cache.",
     "cacheLoadedStale": "{{count}} chat(s) loaded from cache (stale).",
     "sendFailedNoFallback": "manybot: no fallback driver available (jid={{jid}}, primary={{driver}})",
-    "sendFailedBothDrivers": "manybot: send failed on both drivers (jid={{jid}}, tried={{primary}} then {{secondary}})"
+    "sendFailedBothDrivers": "manybot: send failed on both drivers (jid={{jid}}, tried={{primary}} then {{secondary}})",
+    "commandsConfigMissingCmd": "commands.yaml: command \"{{id}}\" is missing required field \"cmd\" — skipped",
+    "commandRegistryInvalidPluginCommand": "commandRegistry: plugin \"{{plugin}}\" command \"{{function}}\" ({{id}}) has an invalid or missing \"cmd\" — skipped",
+    "commandsConfigArgumentMissingName": "commands.yaml: argument entry under \"{{id}}\" is missing required field \"name\" — skipped",
+    "commandsConfigArgumentMissingType": "commands.yaml: argument \"{{name}}\" under \"{{id}}\" is missing required field \"type\" — skipped",
+    "commandsConfigUnknownArgType": "commands.yaml: argument \"{{name}}\" under \"{{id}}\" has unknown type \"{{type}}\" — skipped",
+    "commandsConfigChoiceArgumentNoChoices": "commands.yaml: argument \"{{name}}\" under \"{{id}}\" is type \"choice\" but declared no choices — falling back to free placeholder in usage",
+    "commandsConfigArgumentsNotList": "commands.yaml: arguments under \"{{id}}\" must be a list — ignored",
+    "commandsConfigSubcommandMissingCmd": "commands.yaml: subcommand under \"{{id}}\" is missing required field \"cmd\" — skipped",
+    "commandsConfigSubcommandsNotList": "commands.yaml: subcommands under \"{{id}}\" must be a list — ignored",
+    "commandsConfigDuplicateSubcommand": "commands.yaml: duplicate subcommand \"{{cmd}}\" under \"{{id}}\" — keeping the first one",
+    "commandsConfigReadFailed": "commands.yaml: could not be read ({{path}}): {{message}}",
+    "commandsConfigParseFailed": "commands.yaml: YAML parse error: {{message}}",
+    "commandsConfigInvalidRoot": "commands.yaml: top-level must be a map of command entries",
+    "commandsConfigInvalidEntry": "commands.yaml: entry \"{{id}}\" is not an object — skipped",
+    "commandsConfigImportReadFailed": "commands.yaml: import \"{{path}}\" could not be read: {{message}}",
+    "commandsConfigImportParseFailed": "commands.yaml: import \"{{path}}\" YAML parse error: {{message}}",
+    "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}})",
+    "commandDeprecationRenamed": "commandRegistry: command \"{{id}}\" renamed from \"{{old}}\" to \"{{new}}\" — notifying old callers for {{days}} days",
+    "commandDeprecationRemoved": "commandRegistry: command \"{{id}}\" (cmd \"{{old}}\") was removed — notifying old callers for {{days}} days",
+    "commandDeprecationFallbackRenamed": "Command \"{{old}}\" was renamed to \"{{new}}\". Please update your message.",
+    "commandDeprecationFallbackRemoved": "Command \"{{old}}\" is no longer available.",
+    "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": {
     "stack": "Stack",
     "invalid_config": "Invalid config file {{file}}: {{error}}",
     "fix_config": "Fix the syntax in {{file}} before starting the bot."
   },
+  "menu": {
+    "intro": "Use {prefix}<command> to run it or {prefix}help <command> to view its manual.",
+    "other": "Other",
+    "category": "Category",
+    "manual": "Manual",
+    "description": "Description"
+  },
+  "commandPermissions": {
+    "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.",
+    "blacklist": "You are not allowed to use this command.",
+    "allowedChats": "This command is not available in this chat."
+  },
+  "commandRun": {
+    "missingRequiredArg": "Missing required argument(s).",
+    "unknownSubcommand": "Unknown subcommand \"{{sub}}\" for !{{cmd}}. Valid: {{valid}}."
+  },
+  "alerts": {
+    "noFallbackTitle": "manybot: no fallback driver",
+    "bothDriversFailedTitle": "manybot: sending failed on both drivers",
+    "updateAvailableTitle": "New manybot version available",
+    "updateAvailableMessage": "Installed: {{installed}} → available: {{available}}. See {{url}} for update instructions.",
+    "reconnectHaltedTitle": "manybot stopped reconnecting",
+    "reconnectHaltedMessage": "Gave up after {{attempts}} attempts — possible account restriction. Run connect() manually to retry."
+  },
+  "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}}"
+  },
   "onboarding": {
     "intro": "ManyBot — first login",
     "methodPrompt": "How do you want to connect your WhatsApp account?",
@@ -69,17 +144,6 @@
     "retrying": "Retrying ({{attempt}}/{{max}})...",
     "sessionWiped": "Session discarded, pairing again ({{round}}/{{max}})...",
     "connectGaveUp": "Couldn't connect after several attempts. Check your network and try again."
-  },
-  "whatsmeow": {
-    "installPrompt": "Install whatsmeow driver for fallback support? (EXPERIMENTAL — only text send & history work; other methods throw)",
-    "unsupportedArch": "whatsmeow driver not available for {{os}}-{{arch}}. The bot will use Baileys only.",
-    "fetchingTag": "Fetching latest whatsmeow release...",
-    "fetchFailed": "Could not reach Codeberg. Skipping whatsmeow install.",
-    "downloading": "Downloading {{url}}...",
-    "downloadFailed": "Download failed: {{reason}}",
-    "installTitle": "whatsmeow driver",
-    "installed": "whatsmeow driver installed at {{path}}",
-    "restartNotice": "Restart the bot for the whatsmeow driver to take effect.",
-    "experimentalNotice": "whatsmeow is EXPERIMENTAL: only sendText and getHistory are implemented. sendImage, sendPoll, groupMetadata, and other methods throw."
   }
 }
+

package/dist/locales/es.json

@@ -30,19 +30,94 @@
     "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...",
     "cacheLoaded": "{{count}} chat(s) cargado(s) desde la caché.",
     "cacheLoadedStale": "{{count}} chat(s) cargado(s) desde la caché (desactualizada).",
     "sendFailedNoFallback": "manybot: no hay driver de respaldo disponible (jid={{jid}}, primario={{driver}})",
-    "sendFailedBothDrivers": "manybot: envío falló en ambos drivers (jid={{jid}}, se probó {{primary}} y luego {{secondary}})"
+    "sendFailedBothDrivers": "manybot: envío falló en ambos drivers (jid={{jid}}, se probó {{primary}} y luego {{secondary}})",
+    "commandsConfigMissingCmd": "commands.yaml: el comando \"{{id}}\" no tiene el campo obligatorio \"cmd\" — se omitió",
+    "commandRegistryInvalidPluginCommand": "commandRegistry: el plugin \"{{plugin}}\" comando \"{{function}}\" ({{id}}) tiene \"cmd\" inválido o ausente — se omitió",
+    "commandsConfigArgumentMissingName": "commands.yaml: la entrada de argumento bajo \"{{id}}\" no tiene el campo obligatorio \"name\" — se omitió",
+    "commandsConfigArgumentMissingType": "commands.yaml: el argumento \"{{name}}\" bajo \"{{id}}\" no tiene el campo obligatorio \"type\" — se omitió",
+    "commandsConfigUnknownArgType": "commands.yaml: el argumento \"{{name}}\" bajo \"{{id}}\" tiene un tipo desconocido \"{{type}}\" — se omitió",
+    "commandsConfigChoiceArgumentNoChoices": "commands.yaml: el argumento \"{{name}}\" bajo \"{{id}}\" es de tipo \"choice\" pero no declaró ninguna opción — usando placeholder genérico en la sugerencia de uso",
+    "commandsConfigArgumentsNotList": "commands.yaml: arguments bajo \"{{id}}\" debe ser una lista — se ignoró",
+    "commandsConfigSubcommandMissingCmd": "commands.yaml: el subcomando bajo \"{{id}}\" no tiene el campo obligatorio \"cmd\" — se omitió",
+    "commandsConfigSubcommandsNotList": "commands.yaml: subcommands bajo \"{{id}}\" debe ser una lista — se ignoró",
+    "commandsConfigDuplicateSubcommand": "commands.yaml: subcomando duplicado \"{{cmd}}\" bajo \"{{id}}\" — se conserva el primero",
+    "commandsConfigReadFailed": "commands.yaml: no se pudo leer ({{path}}): {{message}}",
+    "commandsConfigParseFailed": "commands.yaml: error de parseo YAML: {{message}}",
+    "commandsConfigInvalidRoot": "commands.yaml: el nivel raíz debe ser un mapa de entradas de comandos",
+    "commandsConfigInvalidEntry": "commands.yaml: la entrada \"{{id}}\" no es un objeto — se omitió",
+    "commandsConfigImportReadFailed": "commands.yaml: no se pudo leer el import \"{{path}}\": {{message}}",
+    "commandsConfigImportParseFailed": "commands.yaml: error de parseo YAML en el import \"{{path}}\": {{message}}",
+    "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}})",
+    "commandDeprecationRenamed": "commandRegistry: comando \"{{id}}\" renombrado de \"{{old}}\" a \"{{new}}\" — notificando a quienes llamen al antiguo durante {{days}} días",
+    "commandDeprecationRemoved": "commandRegistry: comando \"{{id}}\" (cmd \"{{old}}\") fue eliminado — notificando a quienes llamen al antiguo durante {{days}} días",
+    "commandDeprecationFallbackRenamed": "El comando \"{{old}}\" se renombró a \"{{new}}\". Actualiza tu mensaje.",
+    "commandDeprecationFallbackRemoved": "El comando \"{{old}}\" ya no está disponible.",
+    "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": {
     "stack": "Stack",
     "invalid_config": "Archivo de configuración inválido {{file}}: {{error}}",
     "fix_config": "Corrige la sintaxis en {{file}} antes de iniciar el bot."
   },
+  "menu": {
+    "intro": "Usa {prefix}<comando> para ejecutarlo o {prefix}help <comando> para ver el manual.",
+    "other": "Otros",
+    "category": "Categoría",
+    "manual": "Manual",
+    "description": "Descripción"
+  },
+  "commandPermissions": {
+    "botNotAdmin": "Este comando requiere que el bot sea administrador del grupo.",
+    "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.",
+    "unknownSubcommand": "Subcomando \"{{sub}}\" desconocido para !{{cmd}}. Válidos: {{valid}}."
+  },
+"alerts": {
+    "noFallbackTitle": "manybot: sin driver de fallback",
+    "bothDriversFailedTitle": "manybot: envío fallido en ambos drivers",
+    "updateAvailableTitle": "Nueva versión del manybot disponible",
+    "updateAvailableMessage": "Instalado: {{instalado}} → disponible: {{disponible}}. Vea {{url}} para instrucciones de actualización.",
+    "reconnectHaltedTitle": "manybot detuvo la reconexión",
+    "reconnectHaltedMessage": "Desistió después de {{intento}} intentos — posible restricción de la cuenta. Ejecute connect() manualmente para intentar nuevamente."
+  },
+  "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}}"
+  },
   "onboarding": {
     "intro": "ManyBot — primer inicio de sesión",
     "methodPrompt": "¿Cómo quieres conectar tu cuenta de WhatsApp?",
@@ -69,17 +144,6 @@
     "retrying": "Reintentando ({{attempt}}/{{max}})...",
     "sessionWiped": "Sesión descartada, emparejando de nuevo ({{round}}/{{max}})...",
     "connectGaveUp": "No se pudo conectar tras varios intentos. Revisa tu conexión e intenta de nuevo."
-  },
-  "whatsmeow": {
-    "installPrompt": "¿Instalar el driver whatsmeow para soporte de fallback? (EXPERIMENTAL — solo sendText e historial funcionan; otros métodos lanzan error)",
-    "unsupportedArch": "Driver whatsmeow no disponible para {{os}}-{{arch}}. El bot usará solo Baileys.",
-    "fetchingTag": "Obteniendo última versión de whatsmeow...",
-    "fetchFailed": "No se pudo contactar a Codeberg. Instalación de whatsmeow omitida.",
-    "downloading": "Descargando {{url}}...",
-    "downloadFailed": "Descarga fallida: {{reason}}",
-    "installTitle": "Driver whatsmeow",
-    "installed": "Driver whatsmeow instalado en {{path}}",
-    "restartNotice": "Reinicia el bot para que el driver whatsmeow surta efecto.",
-    "experimentalNotice": "whatsmeow es EXPERIMENTAL: solo sendText y getHistory están implementados. sendImage, sendPoll, groupMetadata y otros métodos lanzan error."
   }
 }
+

package/dist/locales/pt.json

@@ -30,19 +30,94 @@
     "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...",
     "cacheLoaded": "{{count}} conversa(s) carregada(s) do cache.",
     "cacheLoadedStale": "{{count}} conversa(s) carregada(s) do cache (desatualizado).",
     "sendFailedNoFallback": "manybot: nenhum driver de fallback disponível (jid={{jid}}, primário={{driver}})",
-    "sendFailedBothDrivers": "manybot: envio falhou nos dois drivers (jid={{jid}}, tentou {{primary}} depois {{secondary}})"
+    "sendFailedBothDrivers": "manybot: envio falhou nos dois drivers (jid={{jid}}, tentou {{primary}} depois {{secondary}})",
+    "commandsConfigMissingCmd": "commands.yaml: comando \"{{id}}\" sem o campo obrigatório \"cmd\" — ignorado",
+    "commandRegistryInvalidPluginCommand": "commandRegistry: plugin \"{{plugin}}\" comando \"{{function}}\" ({{id}}) tem \"cmd\" inválido ou ausente — ignorado",
+    "commandsConfigArgumentMissingName": "commands.yaml: entrada de argumento sob \"{{id}}\" sem o campo obrigatório \"name\" — ignorada",
+    "commandsConfigArgumentMissingType": "commands.yaml: argumento \"{{name}}\" sob \"{{id}}\" sem o campo obrigatório \"type\" — ignorado",
+    "commandsConfigUnknownArgType": "commands.yaml: argumento \"{{name}}\" sob \"{{id}}\" com tipo desconhecido \"{{type}}\" — ignorado",
+    "commandsConfigChoiceArgumentNoChoices": "commands.yaml: argumento \"{{name}}\" sob \"{{id}}\" é do tipo \"choice\" mas não declarou nenhuma opção — usando placeholder genérico na sugestão de uso",
+    "commandsConfigArgumentsNotList": "commands.yaml: arguments sob \"{{id}}\" precisa ser uma lista — ignorado",
+    "commandsConfigSubcommandMissingCmd": "commands.yaml: subcomando sob \"{{id}}\" sem o campo obrigatório \"cmd\" — ignorado",
+    "commandsConfigSubcommandsNotList": "commands.yaml: subcommands sob \"{{id}}\" precisa ser uma lista — ignorado",
+    "commandsConfigDuplicateSubcommand": "commands.yaml: subcomando duplicado \"{{cmd}}\" sob \"{{id}}\" — mantendo o primeiro",
+    "commandsConfigReadFailed": "commands.yaml: não foi possível ler ({{path}}): {{message}}",
+    "commandsConfigParseFailed": "commands.yaml: erro de parse YAML: {{message}}",
+    "commandsConfigInvalidRoot": "commands.yaml: o nível raiz deve ser um mapa de entradas de comando",
+    "commandsConfigInvalidEntry": "commands.yaml: entrada \"{{id}}\" não é um objeto — ignorada",
+    "commandsConfigImportReadFailed": "commands.yaml: não foi possível ler o import \"{{path}}\": {{message}}",
+    "commandsConfigImportParseFailed": "commands.yaml: erro de parse YAML no import \"{{path}}\": {{message}}",
+    "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}})",
+    "commandDeprecationRenamed": "commandRegistry: comando \"{{id}}\" renomeado de \"{{old}}\" para \"{{new}}\" — avisando chamadores antigos por {{days}} dias",
+    "commandDeprecationRemoved": "commandRegistry: comando \"{{id}}\" (cmd \"{{old}}\") foi removido — avisando chamadores antigos por {{days}} dias",
+    "commandDeprecationFallbackRenamed": "O comando \"{{old}}\" foi renomeado para \"{{new}}\". Atualize sua mensagem.",
+    "commandDeprecationFallbackRemoved": "O comando \"{{old}}\" não está mais disponível.",
+    "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": {
     "stack": "Stack",
     "invalid_config": "Arquivo de configuração inválido {{file}}: {{error}}",
     "fix_config": "Corrija a sintaxe em {{file}} antes de iniciar o bot."
   },
+  "menu": {
+    "intro": "Use {prefix}<comando> para executar ou {prefix}help <comando> para ver o manual.",
+    "other": "Outros",
+    "category": "Categoria",
+    "manual": "Manual",
+    "description": "Descrição"
+  },
+  "commandPermissions": {
+    "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.",
+    "unknownSubcommand": "Subcomando \"{{sub}}\" desconhecido para !{{cmd}}. Válidos: {{valid}}."
+  },
+"alerts": {
+    "noFallbackTitle": "manybot: sem driver de fallback",
+    "bothDriversFailedTitle": "manybot: envio falhou nos dois drivers",
+    "updateAvailableTitle": "Nova versão do manybot disponível",
+    "updateAvailableMessage": "Instalado: {{installed}} → disponível: {{available}}. Veja {{url}} para instruções de atualização.",
+    "reconnectHaltedTitle": "manybot parou de reconectar",
+    "reconnectHaltedMessage": "Desistiu após {{attempts}} tentativas — possível restrição da conta. Execute connect() manualmente para tentar novamente."
+  },
+  "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}}"
+  },
   "onboarding": {
     "intro": "ManyBot — primeiro login",
     "methodPrompt": "Como você quer conectar sua conta do WhatsApp?",
@@ -69,17 +144,6 @@
     "retrying": "Tentando novamente ({{attempt}}/{{max}})...",
     "sessionWiped": "Sessão descartada, tentando parear novamente ({{round}}/{{max}})...",
     "connectGaveUp": "Não foi possível conectar após várias tentativas. Verifique sua conexão e tente de novo."
-  },
-  "whatsmeow": {
-    "installPrompt": "Instalar driver whatsmeow para suporte a fallback? (EXPERIMENTAL — apenas sendText e histórico funcionam; outros métodos lançam erro)",
-    "unsupportedArch": "Driver whatsmeow não disponível para {{os}}-{{arch}}. O bot usará apenas Baileys.",
-    "fetchingTag": "Buscando última versão do whatsmeow...",
-    "fetchFailed": "Não foi possível acessar o Codeberg. Instalação do whatsmeow ignorada.",
-    "downloading": "Baixando {{url}}...",
-    "downloadFailed": "Download falhou: {{reason}}",
-    "installTitle": "Driver whatsmeow",
-    "installed": "Driver whatsmeow instalado em {{path}}",
-    "restartNotice": "Reinicie o bot para que o driver whatsmeow entre em efeito.",
-    "experimentalNotice": "whatsmeow é EXPERIMENTAL: apenas sendText e getHistory estão implementados. sendImage, sendPoll, groupMetadata e outros métodos lançam erro."
   }
 }
+