@manybot/manybot 5.7.0 → 5.8.0

package/dist/drivers/baileys/adapter.js

@@ -72,6 +72,22 @@ export function decodeContent(content) {
         type = "sticker";
         mimetype = m.stickerMessage.mimetype ?? undefined;
     }
+    else if (m?.templateMessage) {
+        type = "text";
+        const tpl = m.templateMessage.hydratedTemplate ?? m.templateMessage.hydratedFourRowTemplate;
+        const buttonUrls = tpl?.hydratedButtons?.map((b) => b.urlButton?.url).filter(Boolean).join(" ") ?? "";
+        body = [tpl?.hydratedContentText ?? "", buttonUrls].filter(Boolean).join(" ");
+    }
+    else if (m?.interactiveMessage) {
+        type = "text";
+        const buttonParams = m.interactiveMessage.nativeFlowMessage?.buttons
+            ?.map((b) => b.buttonParamsJson).filter(Boolean).join(" ") ?? "";
+        body = [m.interactiveMessage.body?.text ?? "", buttonParams].filter(Boolean).join(" ");
+    }
+    else if (m?.buttonsMessage) {
+        type = "text";
+        body = [m.buttonsMessage.contentText ?? "", m.buttonsMessage.footerText ?? ""].filter(Boolean).join(" ");
+    }
     return { type, body, mimetype };
 }
 export function createBaileysAdapter(initial) {
@@ -115,6 +131,29 @@ export function createBaileysAdapter(initial) {
         // which throws if `.message` is missing.
         return { quoted: { key: toFlatKey(quoted), message: inner } };
     }
+    /**
+     * Merge `quoted` reply-citation with the chat's current
+     * `ephemeralExpiration` so every outgoing send in a chat with a
+     * disappearing-message timer inherits it automatically. Returns
+     * `undefined` when there's nothing to set, so callers can pass it
+     * through as the third argument to `sock.sendMessage` without
+     * conditionally building the options object.
+     *
+     * The timer is read off the in-memory store, which is populated by
+     * `chats.upsert` / `chats.update` / `messages.upsert` (via the
+     * `ephemeralMessage` envelope) and from `groupMetadata().ephemeralDuration`
+     * in this same adapter — i.e. everything WhatsApp tells us about the
+     * chat's timer ends up there, and the send path just reads it back.
+     */
+    function buildSendOpts(jid, quoted) {
+        const quotedOpts = buildQuotedOpts(quoted);
+        const timer = store.chats.get(jid)?.ephemeralExpiration;
+        if (!timer)
+            return quotedOpts;
+        if (!quotedOpts)
+            return { ephemeralExpiration: timer };
+        return { ...quotedOpts, ephemeralExpiration: timer };
+    }
     /**
      * Translate a neutral `BotQuotedRef` into the FLAT key shape Baileys
      * expects for `react`/`delete`/`edit`/`readMessages` (proto.IMessageKey
@@ -151,6 +190,9 @@ export function createBaileysAdapter(initial) {
             m?.videoMessage?.contextInfo ??
             m?.audioMessage?.contextInfo ??
             m?.documentMessage?.contextInfo ??
+            m?.templateMessage?.contextInfo ??
+            m?.interactiveMessage?.contextInfo ??
+            m?.buttonsMessage?.contextInfo ??
             undefined;
         const ciTyped = contextInfo;
         return {
@@ -295,7 +337,7 @@ export function createBaileysAdapter(initial) {
         async sendText(jid, text, opts) {
             const content = { text };
             // eslint-disable-next-line @typescript-eslint/no-explicit-any
-            const sendOpts = buildQuotedOpts(opts?.quoted);
+            const sendOpts = buildSendOpts(jid, opts?.quoted);
             if (opts?.mentions?.length)
                 content.mentions = opts.mentions;
             const ref = await sock.sendMessage(jid, content, sendOpts);
@@ -309,7 +351,7 @@ export function createBaileysAdapter(initial) {
                 content.viewOnce = true;
             if (opts?.mentions?.length)
                 content.mentions = opts.mentions;
-            const ref = await sock.sendMessage(jid, content, buildQuotedOpts(opts?.quoted));
+            const ref = await sock.sendMessage(jid, content, buildSendOpts(jid, opts?.quoted));
             return toSentRef(ref, jid);
         },
         async sendVideo(jid, buffer, opts) {
@@ -322,7 +364,7 @@ export function createBaileysAdapter(initial) {
                 content.gifPlayback = true;
             if (opts?.mentions?.length)
                 content.mentions = opts.mentions;
-            const ref = await sock.sendMessage(jid, content, buildQuotedOpts(opts?.quoted));
+            const ref = await sock.sendMessage(jid, content, buildSendOpts(jid, opts?.quoted));
             return toSentRef(ref, jid);
         },
         async sendAudio(jid, buffer, opts) {
@@ -332,20 +374,20 @@ export function createBaileysAdapter(initial) {
                 content.ptt = true;
             if (opts?.viewOnce)
                 content.viewOnce = true;
-            const ref = await sock.sendMessage(jid, content, buildQuotedOpts(opts?.quoted));
+            const ref = await sock.sendMessage(jid, content, buildSendOpts(jid, opts?.quoted));
             return toSentRef(ref, jid);
         },
         async sendSticker(jid, buffer, opts) {
-            const ref = await sock.sendMessage(jid, { sticker: buffer }, buildQuotedOpts(opts?.quoted));
+            const ref = await sock.sendMessage(jid, { sticker: buffer }, buildSendOpts(jid, opts?.quoted));
             return toSentRef(ref, jid);
         },
         async sendDocument(jid, buffer, filename, mimetype, opts) {
-            const ref = await sock.sendMessage(jid, { document: buffer, mimetype, fileName: filename }, buildQuotedOpts(opts?.quoted));
+            const ref = await sock.sendMessage(jid, { document: buffer, mimetype, fileName: filename }, buildSendOpts(jid, opts?.quoted));
             return toSentRef(ref, jid);
         },
         async sendPoll(jid, opts) {
             const poll = { name: opts.name, values: opts.values, selectableCount: opts.selectableCount ?? 1 };
-            const ref = await sock.sendMessage(jid, { poll }, buildQuotedOpts(opts.quoted));
+            const ref = await sock.sendMessage(jid, { poll }, buildSendOpts(jid, opts.quoted));
             return toSentRef(ref, jid);
         },
         async react(jid, target, emoji) {
@@ -427,6 +469,15 @@ export function createBaileysAdapter(initial) {
         // ── groups ─────────────────────────────────────────────────────────────
         async groupMetadata(jid) {
             const meta = await sock.groupMetadata(jid);
+            // WhatsApp reports the group's current disappearing-message
+            // timer as `ephemeralDuration` on the metadata payload — promote
+            // it to the in-memory store so the next send to this group
+            // picks it up automatically (and so the timer survives a
+            // snapshot round-trip without us re-fetching metadata).
+            const rawDuration = meta.ephemeralDuration;
+            if (rawDuration !== undefined) {
+                store.setChatEphemeralExpiration(jid, Number(rawDuration) || 0);
+            }
             return {
                 subject: meta.subject,
                 participants: meta.participants.map(p => ({

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

@@ -14,6 +14,7 @@ import { logger } from "#logger";
 import { t, createPluginT, reloadTranslations, getCurrentLang } from "#i18n";
 import { CONFIG, CONFIG_DIR } from "#config";
 import { enqueue } from "#download";
+import { waitForEditSlot } from "#kernel/sendGuard.js";
 import { schedule, cancelPlugin } from "#kernel/scheduler.js";
 import { emptyFolder } from "#utils/file.js";
 import { normalizeJid, denormalizeJid, toWireJid } from "#drivers/jid.js";
@@ -24,9 +25,12 @@ import path from "path";
 import os from "os";
 import { spawn } from "child_process";
 import { randomUUID } from "crypto";
-import { waitForSendSlot, simulateState, typingDuration, mediaDuration, waitForEditSlot } from "#sendguard";
+import { waitForSendSlot, simulateState, typingDuration, mediaDuration } from "#sendguard";
 import { sendWithFallback } from "#kernel/sendFallbackGuard.js";
 import { buildSettingsApi } from "#settingsdb";
+import * as commandAccess from "#kernel/commandAccess.js";
+import * as chatSession from "#kernel/chatSession.js";
+import { resolveDispatch, runCommand as dispatchCommand } from "#kernel/runCommand.js";
 import WebP from "node-webpmux";
 import { jidNormalizedUser, } from "@whiskeysockets/baileys";
 // ── Raw-Baileys escape hatch ─────────────────────────────────────────────────
@@ -175,13 +179,13 @@ function hasMention(contextInfo) {
     return !!(ci?.mentionedJid && Array.isArray(ci.mentionedJid) && ci.mentionedJid.length > 0);
 }
 /** True if the bot's own JID (PN or LID) is in contextInfo.mentionedJid. */
-function hasBotMention(contextInfo, sock, store) {
+function hasBotMention(contextInfo, contract, store) {
     const ci = contextInfo;
     const mentioned = ci?.mentionedJid;
     if (!mentioned || mentioned.length === 0)
         return false;
-    const botLid = sock.user?.lid;
-    const botCandidates = [sock.user?.id, botLid]
+    const me = contract.me();
+    const botCandidates = [me.id, me.lid]
         .filter((v) => !!v)
         .map(v => normalizeJid(store.resolveJid(normalizeJid(v))));
     if (botCandidates.length === 0)
@@ -517,6 +521,27 @@ async function normalizeContact(jid, info, botJid, contract) {
     };
 }
 // ── Chats API ─────────────────────────────────────────────────────────────────
+function buildCommandsApi() {
+    return {
+        exists: commandAccess.exists,
+        desc: commandAccess.desc,
+        manual: commandAccess.manual,
+        list: commandAccess.list,
+        isMenuAlias: commandAccess.isMenuAlias,
+    };
+}
+// ── Session API (Phase 7, MANYBOT-6.md) ─────────────────────────────────────
+// Scoped to the current chat (normJid) + the calling plugin. Only built in
+// buildApi() (runtime), not buildBaseApi() — there is no "current chat" at
+// setup time to lock.
+function buildSessionApi(chatId, pluginName) {
+    return {
+        acquire: () => chatSession.acquireSession(chatId, pluginName),
+        release: () => { chatSession.releaseSession(chatId, pluginName); },
+        isLocked: () => chatSession.isSessionLocked(chatId),
+        isMine: () => chatSession.getSessionHolder(chatId) === pluginName,
+    };
+}
 function buildChatsApi(store) {
     return {
         /**
@@ -719,7 +744,6 @@ function makeHistoryArray(entries, store) {
     return arr;
 }
 export function buildMessageContext(msg, contract, store, guardOptions = {}) {
-    const sock = rawSocketOf(contract);
     const body = getMsgBody(msg);
     const prefix = CONFIG.CMD_PREFIX;
     const rawArgs = body.trim().split(/\s+/);
@@ -742,6 +766,21 @@ export function buildMessageContext(msg, contract, store, guardOptions = {}) {
     // We carry the same _raw.contextInfo on the synthetic so a recursive
     // getReply().getReply() keeps working (the inner call re-reads
     // getContextInfo off _raw.contextInfo).
+    //
+    // WhatsApp's contextInfo never carries the quoted author's pushname, so
+    // we best-effort it from the local contact store (same lookup pattern
+    // as getContact() below) instead of leaving it undefined -> falling
+    // back to the raw phone number in senderName.
+    const lookupPushName = (jid) => {
+        if (!jid)
+            return undefined;
+        const contacts = store.contacts;
+        const info = contacts[jid]
+            ?? contacts[denormalizeJid(jid)]
+            ?? contacts[store.resolveJid(jid)]
+            ?? contacts[denormalizeJid(store.resolveJid(jid))];
+        return info?.notify ?? undefined;
+    };
     const quotedRaw = contextInfo?.quotedMessage
         ? (() => {
             const decoded = decodeContent(contextInfo.quotedMessage);
@@ -754,6 +793,8 @@ export function buildMessageContext(msg, contract, store, guardOptions = {}) {
                 timestamp: 0,
                 body: decoded.body,
                 mimetype: decoded.mimetype,
+                fromPn: contextInfo.participant ?? undefined,
+                pushName: lookupPushName(contextInfo.participant),
                 _raw: {
                     contextInfo: {
                         stanzaId: contextInfo.stanzaId,
@@ -777,6 +818,8 @@ export function buildMessageContext(msg, contract, store, guardOptions = {}) {
                 type: "other",
                 contentHash: "",
                 timestamp: 0,
+                fromPn: msg.quotedKey.participant ?? undefined,
+                pushName: lookupPushName(msg.quotedKey.participant),
             }
             : null;
     return {
@@ -821,7 +864,7 @@ export function buildMessageContext(msg, contract, store, guardOptions = {}) {
             return buildMessageContext(quotedRaw, contract, store, { cooldown: false, jitter: false });
         },
         hasMention: hasMention(contextInfo),
-        hasBotMention: hasBotMention(contextInfo, sock, store),
+        hasBotMention: hasBotMention(contextInfo, contract, store),
         reply: makeSender(contract, store, rawJid, msg, { cooldown, jitter }),
         async react(emoji) {
             await contract.react(rawJid, {
@@ -845,7 +888,10 @@ export function buildMessageContext(msg, contract, store, guardOptions = {}) {
             if (!msg.fromMe) {
                 throw new Error("[pluginApi] edit() can only be used on the bot's own messages");
             }
-            if (!msg.id || !(await waitForEditSlot(msg.id)))
+            if (!msg.id)
+                return;
+            const allowed = await waitForEditSlot(msg.id);
+            if (!allowed)
                 return;
             await contract.editMessage(rawJid, {
                 id: msg.id,
@@ -867,7 +913,7 @@ export function buildMessageContext(msg, contract, store, guardOptions = {}) {
                 ?? store.contacts[denormalizeJid(sender)]
                 ?? store.contacts[store.resolveJid(msg.fromPn ?? "")]
                 ?? store.contacts[denormalizeJid(store.resolveJid(msg.fromPn ?? ""))];
-            const botJid = sock.user?.id ? jidNormalizedUser(sock.user.id) : null;
+            const botJid = contract.me().id ? jidNormalizedUser(contract.me().id) : null;
             return normalizeContact(sender, info, botJid, contract);
         },
     };
@@ -961,7 +1007,10 @@ class MessageHandle {
         if (!msg.fromMe) {
             throw new Error("[pluginApi] edit() can only be used on the bot's own messages");
         }
-        if (!msg.id || !(await waitForEditSlot(msg.id)))
+        if (!msg.id)
+            return;
+        const allowed = await waitForEditSlot(msg.id);
+        if (!allowed)
             return;
         await this._contract.editMessage(msg.chatId, {
             id: msg.id,
@@ -1472,8 +1521,42 @@ async function resolveMentionJids(contract, store, jid, mentions) {
     }
     return Array.from(new Set(result.filter(Boolean)));
 }
-function buildAdminApi(contract, chatJid) {
-    const norm = (v) => (Array.isArray(v) ? v : [v]).map(toWireJid);
+function buildAdminApi(contract, store, chatJid) {
+    /**
+     * Resolve admin-supplied identifiers (bare phone number, @c.us,
+     * @s.whatsapp.net, or @lid) to the exact jid WhatsApp has on file for
+     * that participant *in this group*. A naive toWireJid() guess is only
+     * correct for pn-addressed groups — lid-addressed groups (increasingly
+     * common, e.g. when a member hides their phone number) only recognize
+     * that member by @lid, which a phone number typed by the admin can't
+     * produce on its own. Baileys' raw groupMetadata() participants carry
+     * `id` (whatever WA addresses them as here), `jid` (its best
+     * phone-number guess) and `lid` — check all three.
+     *
+     * Throws per-identifier if it doesn't match a current member, instead
+     * of silently sending a guessed jid that WhatsApp rejects deep inside
+     * the per-participant status array (see assertParticipantsUpdateOk).
+     */
+    async function resolveTargets(groupJid, identifiers) {
+        const meta = await getGroupMetadataCached(contract, groupJid);
+        const out = [];
+        for (const id of identifiers) {
+            const wire = toWireJid(id);
+            const resolved = normalizeJid(store.resolveJid(id));
+            const match = meta.participants.find((p) => {
+                const pAny = p;
+                return (toWireJid(pAny.id) === wire ||
+                    normalizeJid(store.resolveJid(pAny.id)) === resolved ||
+                    (pAny.jid ? toWireJid(pAny.jid) === wire : false) ||
+                    (pAny.lid ? toWireJid(pAny.lid) === wire : false));
+            });
+            if (!match) {
+                throw new Error(t("driver.groupParticipantNotFound", { id, group: groupJid }));
+            }
+            out.push(match.id);
+        }
+        return Array.from(new Set(out));
+    }
     function requireChat() {
         if (!chatJid)
             throw new Error("This admin operation requires a runtime group context.");
@@ -1503,7 +1586,7 @@ function buildAdminApi(contract, chatJid) {
         const failed = results.filter((r) => r?.status && r.status !== "200");
         if (failed.length > 0) {
             const detail = failed.map((r) => `${r.jid ?? "?"}=${r.status}`).join(", ");
-            throw new Error(`groupParticipantsUpdate("${action}") rejeitado para: ${detail}`);
+            throw new Error(t("driver.groupParticipantsUpdateRejected", { action, detail }));
         }
     }
     /**
@@ -1518,16 +1601,35 @@ function buildAdminApi(contract, chatJid) {
             results = await contract.groupParticipantsUpdate(jid, users, action);
         }
         catch (err) {
-            throw new Error(`groupParticipantsUpdate("${action}") falhou para o grupo "${jid}" com participantes [${users.join(", ")}]: ${err.message}`);
+            throw new Error(t("driver.groupParticipantsUpdateFailed", {
+                action,
+                group: jid,
+                users: users.join(", "),
+                message: err.message,
+            }));
         }
         assertParticipantsUpdateOk(action, results);
         return results;
     }
-    function createTargetableAction(action, memberIds) {
-        const users = norm(memberIds);
-        const executeCurrent = async () => { requireChat(); return action(chatJid, users); };
+    function createTargetableAction(action, memberIds, mode = "existingMember") {
+        const raw = Array.isArray(memberIds) ? memberIds : [memberIds];
+        const resolve = async (groupJid) => mode === "existingMember"
+            ? resolveTargets(groupJid, raw)
+            // `add` targets people who aren't members yet — there's no
+            // participant-list entry to match against, so fall back to a
+            // plain jid guess (the historical behavior).
+            : Array.from(new Set(raw.map(toWireJid)));
+        const executeCurrent = async () => {
+            requireChat();
+            const users = await resolve(chatJid);
+            return action(chatJid, users);
+        };
         return {
-            async to(targetJid) { await getGroup(targetJid); return action(targetJid, users); },
+            async to(targetJid) {
+                await getGroup(targetJid);
+                const users = await resolve(targetJid);
+                return action(targetJid, users);
+            },
             then(onfulfilled, onrejected) {
                 return executeCurrent().then(onfulfilled, onrejected);
             },
@@ -1542,22 +1644,25 @@ function buildAdminApi(contract, chatJid) {
     return {
         /** @param {string|string[]} memberIds — JID (@s.whatsapp.net/@lid), this framework's @c.us form, or a bare phone number */
         add(memberIds) {
-            return createTargetableAction((jid, users) => runParticipantsUpdate(jid, users, "add"), memberIds);
+            return createTargetableAction((jid, users) => runParticipantsUpdate(jid, users, "add"), memberIds, "newMember");
         },
         /** @param {string|string[]} memberIds — JID (@s.whatsapp.net/@lid), this framework's @c.us form, or a bare phone number */
         async kick(memberIds) {
             requireChat();
-            return runParticipantsUpdate(chatJid, norm(memberIds), "remove");
+            const users = await resolveTargets(chatJid, Array.isArray(memberIds) ? memberIds : [memberIds]);
+            return runParticipantsUpdate(chatJid, users, "remove");
         },
         /** @param {string|string[]} memberIds — JID (@s.whatsapp.net/@lid), this framework's @c.us form, or a bare phone number */
         async promote(memberIds) {
             requireChat();
-            return runParticipantsUpdate(chatJid, norm(memberIds), "promote");
+            const users = await resolveTargets(chatJid, Array.isArray(memberIds) ? memberIds : [memberIds]);
+            return runParticipantsUpdate(chatJid, users, "promote");
         },
         /** @param {string|string[]} memberIds — JID (@s.whatsapp.net/@lid), this framework's @c.us form, or a bare phone number */
         async demote(memberIds) {
             requireChat();
-            return runParticipantsUpdate(chatJid, norm(memberIds), "demote");
+            const users = await resolveTargets(chatJid, Array.isArray(memberIds) ? memberIds : [memberIds]);
+            return runParticipantsUpdate(chatJid, users, "demote");
         },
         /** @param {string} name */
         async setSubject(name) {
@@ -1765,7 +1870,7 @@ function buildPollApi(contract, store, rawJid, guardOptions, pluginName) {
                     handle._updateFromAggregated(aggregated);
                 }
                 catch (err) {
-                    logger.error(`[poll] erro ao decriptar voto: ${err}`);
+                    logger.error(`[poll] ${t("driver.pollDecryptFailed", { error: err })}`);
                 }
             }
         });
@@ -1835,6 +1940,7 @@ function buildBaseApi(contract, store, pluginRegistry, pluginName) {
         contacts: buildContactsApi(contract, store, botJid),
         storage: buildStorageApi(pluginName),
         botId: botJid,
+        commands: buildCommandsApi(),
     };
 }
 // ── Setup API ─────────────────────────────────────────────────────────────────
@@ -1852,12 +1958,52 @@ export function buildSetupApi(contract, store, pluginRegistry, pluginName) {
     return {
         ...buildBaseApi(contract, store, pluginRegistry, pluginName),
         ...buildSetupSendApi(contract, store),
-        admin: buildAdminApi(contract, null),
+        admin: buildAdminApi(contract, store, null),
         events: buildEventsApi(contract, pluginName),
         me: buildMeApi(contract),
         settings: { global: buildSettingsApi(pluginName, "_global").global },
     };
 }
+// ── ctx.runCommand facet ─────────────────────────────────────────────────────
+/**
+ * Builds the `ctx.runCommand(invocation, rawArgs?)` facet for a runtime
+ * ctx bound to `msg`/`chat`. Deliberately built AFTER `buildApi` is
+ * declared (function declarations hoist) so it can call `buildApi`
+ * again, recursively, to build a context scoped to the TARGET
+ * command's owning plugin rather than reusing the caller's — same
+ * "own storage/plugins facet, not the caller's" principle as
+ * `ctx.plugins.require()`.
+ *
+ * @param {BotMessage}      msg
+ * @param {WAChat}          chat
+ * @param {WaContract}      contract
+ * @param {BotStore}        store
+ * @param {Map}             pluginRegistry
+ * @param {string}          callerPluginName
+ */
+function buildRunCommandFacet(msg, chat, contract, store, pluginRegistry, callerPluginName) {
+    return async function runCommandFacet(invocation, rawArgs = "") {
+        const resolution = resolveDispatch(invocation, rawArgs);
+        if (resolution.target.kind === "none") {
+            return { status: "no_dispatch", sentReply: null, suggestedReply: null };
+        }
+        const entry = resolution.target.kind === "sub" ? resolution.target.parent : resolution.target.entry;
+        const targetPluginName = entry.source === "plugin" ? entry.pluginName : null;
+        const targetCtx = targetPluginName && targetPluginName !== callerPluginName
+            ? buildApi({
+                msg, chat, contract, store, pluginRegistry,
+                pluginName: targetPluginName,
+                guardOptions: pluginRegistry.get(targetPluginName)?.guardOptions ?? {},
+            })
+            : buildApi({ msg, chat, contract, store, pluginRegistry, pluginName: callerPluginName });
+        return dispatchCommand({
+            pluginName: targetPluginName,
+            ctx: targetCtx,
+            resolution,
+            reply: targetCtx.msg.reply,
+        });
+    };
+}
 // ── Runtime API ───────────────────────────────────────────────────────────────
 /**
  * Runtime API — full context with message and chat.
@@ -1907,6 +2053,8 @@ export function buildApi({ msg, chat, contract, store, pluginRegistry, pluginNam
     return {
         ...buildBaseApi(contract, store, pluginRegistry, pluginName),
         ...buildSendApi(contract, store, rawJid, guardOptions),
+        runCommand: buildRunCommandFacet(msg, chat, contract, store, pluginRegistry, pluginName),
+        session: buildSessionApi(normJid, pluginName),
         // ── msg ──────────────────────────────────────────────────────────────────
         msg: buildMessageContext(msg, contract, store, { cooldown, jitter }),
         // ── chat ─────────────────────────────────────────────────────────────────
@@ -2008,7 +2156,7 @@ export function buildApi({ msg, chat, contract, store, pluginRegistry, pluginNam
             },
         },
         // ── admin ─────────────────────────────────────────────────────────────────
-        admin: buildAdminApi(contract, rawJid),
+        admin: buildAdminApi(contract, store, rawJid),
         // ── me ────────────────────────────────────────────────────────────────────
         me: buildMeApi(contract),
         // ── poll ──────────────────────────────────────────────────────────────────