@whanext/core 0.14.3 → 0.16.0

package/CHANGELOG.md

@@ -1,6 +1,42 @@
 # Changelog
 
 
+## 0.16.0
+
+### Adicionado
+
+- Novo evento público `messageDeleted` em `app.on()` e `multi.on()`.
+- Novo tipo `MessageDeleted`, com chave da mensagem, payload original quando disponível, autor da revogação e horário da exclusão.
+- O provider Baileys passa a observar `messages.update` e reconhecer revogações sem expor tipos do Baileys à aplicação.
+- Mensagens revogadas permanecem no cache recente, permitindo `app.message.repost()` e `app.media.download()` enquanto a entrada estiver disponível.
+
+### Compatibilidade
+
+- A mudança é aditiva para consumidores da API pública.
+- Providers customizados passam a incluir `messageDeleted` em `ProviderEvents`.
+- Quando a mensagem original já saiu do cache, o evento continua sendo emitido sem o campo `message`.
+
+## 0.15.0
+
+### Adicionado
+
+- Suporte de alto nível a mensagens com botões interativos Native Flow.
+- Botão `copy` para copiar códigos/textos usando `cta_copy`.
+- Botão `link` para abrir URLs usando `cta_url`.
+- Novo `ButtonsContent` no `MessageContent`, com `title`, `text`, `footer`, `mentions` e uma lista tipada de botões.
+- Novo atalho `app.message.buttons(chatId, content)`; `ctx.reply({...})` e `app.message.reply(...)` também aceitam o novo conteúdo automaticamente.
+- Exportação pública dos tipos `ButtonsContent`, `MessageButton`, `CopyCodeButton` e `LinkButton`.
+
+### Provider Baileys
+
+- Mensagens interativas são geradas como `InteractiveMessage`/`NativeFlowMessage` e enviadas por `relayMessage`, sem expor protobufs ao consumidor.
+- Replies e menções são preservados no envio de botões.
+- O relay inclui os nós de compatibilidade necessários para Native Flow em chats privados e grupos.
+
+### Compatibilidade
+
+- Nenhum contrato existente foi removido. Texto, mídia, reações, edição, delete e repost continuam usando as APIs anteriores.
+
 ## 0.14.3
 
 - Corrige uma rejeição órfã durante o login quando a solicitação de código de pareamento falha ao mesmo tempo em que o socket é fechado.

package/README.md

@@ -37,7 +37,7 @@ await app.login({
 - Prefixo global e comandos declarativos com argumentos tipados.
 - Comandos exclusivos da conta conectada com `guards.owner()` ou `onlyOwner`.
 - Usuários normalizados entre JID, LID e PN.
-- Mensagens, replies, edição, exclusão, menções, mídias e download normalizado.
+- Mensagens, replies, edição, exclusão, revogações, menções, mídias e download normalizado.
 - Operações de grupos e membros com resultados idempotentes.
 - Cache de metadados transparente e substituível.
 - Mute permanente ou temporário com SQLite ou banco próprio.
@@ -159,6 +159,20 @@ if (principal?.isReady) {
 
 `multi.commands.command()`, `use()`, `onError()` e `load()` aplicam a mesma configuração de comandos a todas as contas. Dentro de um comando, `ctx.account.id` informa qual conta recebeu e executou aquela interação. Eventos também podem ser observados em conjunto com `multi.on()`.
 
+## Mensagens apagadas
+
+Revogações recebidas pelo WhatsApp são expostas pelo evento `messageDeleted`. Quando a mensagem original ainda estiver no cache recente, o payload inclui `message`, que pode ser republicada ou usada para baixar a mídia pelas APIs existentes.
+
+```ts
+app.on('messageDeleted', async ({ message, deletedByMe }) => {
+  if (!message || deletedByMe) return;
+
+  await app.message.repost(message, app.account.selfChatId);
+});
+```
+
+O evento também informa `deletedById` quando o WhatsApp fornece a identidade responsável pela revogação.
+
 ## Logging
 
 O nível padrão é `info`. Estão disponíveis `debug`, `info`, `warn`, `error` e `silent`.
@@ -340,6 +354,44 @@ await app.message.react(sent, '👏🏻');
 await app.message.unreact(sent);
 ```
 
+### Botões interativos
+
+Por enquanto, a API pública suporta botões de **copiar código** e **abrir link**:
+
+```ts
+await app.message.buttons(chatId, {
+  title: 'Acesso',
+  text: 'Escolha uma ação:',
+  footer: 'WhaNext',
+  buttons: [
+    {
+      type: 'copy',
+      label: 'Copiar código',
+      code: 'ABC-123',
+    },
+    {
+      type: 'link',
+      label: 'Abrir painel',
+      url: 'https://example.com',
+    },
+  ],
+});
+```
+
+Também funciona diretamente em replies de comandos, sem importar tipos do Baileys:
+
+```ts
+await ctx.reply({
+  text: 'Use uma das opções abaixo.',
+  buttons: [
+    { type: 'copy', label: 'Copiar', code: 'ABC-123' },
+    { type: 'link', label: 'Abrir site', url: 'https://example.com' },
+  ],
+});
+```
+
+`title`, `footer` e `mentions` são opcionais. Os botões podem ser combinados na mesma mensagem.
+
 `delete()` aceita `Message`, `SentMessage` ou `MessageKey`.
 
 `react()` aceita os mesmos tipos e adiciona uma reação à mensagem. `unreact()` remove a reação da conta conectada.

package/dist/index.d.ts

@@ -90,6 +90,13 @@ interface QuotedMessage {
     contentKind?: MessageContentKind;
     media?: MessageMedia;
 }
+interface MessageDeleted {
+    key: MessageKey;
+    message?: Message;
+    deletedByMe: boolean;
+    deletedById?: string;
+    deletedAt: Date;
+}
 interface Message {
     id: string;
     jid: string;
@@ -139,6 +146,24 @@ interface TextContent {
     text: string;
     mentions?: MentionTarget[];
 }
+interface LinkButton {
+    type: 'link';
+    label: string;
+    url: string;
+}
+interface CopyCodeButton {
+    type: 'copy';
+    label: string;
+    code: string;
+}
+type MessageButton = LinkButton | CopyCodeButton;
+interface ButtonsContent {
+    text: string;
+    buttons: MessageButton[];
+    title?: string;
+    footer?: string;
+    mentions?: MentionTarget[];
+}
 interface ImageContent {
     image: MediaSource;
     caption?: string;
@@ -160,7 +185,7 @@ interface AudioContent {
 interface StickerContent {
     sticker: MediaSource;
 }
-type MessageContent = TextContent | ImageContent | VideoContent | AudioContent | StickerContent;
+type MessageContent = TextContent | ButtonsContent | ImageContent | VideoContent | AudioContent | StickerContent;
 
 type GroupAccess = 'open' | 'closed';
 type GroupRole = 'member' | 'admin' | 'owner';
@@ -229,6 +254,7 @@ interface ConnectionUpdate {
 }
 interface ProviderEvents {
     message: Message;
+    messageDeleted: MessageDeleted;
     connection: ConnectionUpdate;
     groupChanged: {
         groupId: string;
@@ -458,6 +484,7 @@ declare class MessageService {
     react(message: Message | SentMessage | MessageKey, emoji: string): Promise<SentMessage>;
     unreact(message: Message | SentMessage | MessageKey): Promise<SentMessage>;
     text(chatId: string, text: string, mentions?: MentionTarget[]): Promise<SentMessage>;
+    buttons(chatId: string, content: ButtonsContent): Promise<SentMessage>;
 }
 
 interface CommandCatalogView {
@@ -727,6 +754,7 @@ declare class AccountService {
 
 interface AppEvents {
     message: Message;
+    messageDeleted: MessageDeleted;
     connection: ConnectionUpdate;
     error: WhaNextError;
     mute: MuteEnforcement;
@@ -886,4 +914,4 @@ declare class SqliteMuteStore implements MuteStore {
     close(): void;
 }
 
-export { AccountService, type AddMuteOptions, type AddMuteResult, type AppEvents, type AppHealth, type AppHealthStatus, ArgsParser, type AudioContent, type BooleanOption, Browser, type CacheOptions, type CacheStore, type CallEvent, type CallStatus, type ChangeResult, type CommandAccountContext, type CommandCatalogOptions, type CommandCatalogView, type CommandChatContext, type CommandConcurrency, type CommandContext, type CommandCooldown, type CommandDefinition, type CommandErrorHandler, type CommandGroupContext, type CommandGroupDefinition, type CommandGuard, type CommandHelpOptions, type CommandHooks, type CommandLocalization, type CommandMetadata, type CommandMiddleware, type CommandOptionDefinition, type CommandOptionSchema, type CommandOptionValue, type CommandOptionValues, type CommandRegistrar, CommandRouter, type CommandRuntimeServices, type CommandScope, type ConcurrencyStrategy, type ConnectionState, type ConnectionUpdate, type CreateMultiOptions, type CreateOptions, DeferredReply, type DownloadedMedia, type DurationOption, type EnumOption, type ExecutableCommandDefinition, type GroupAccess, type GroupAddressingMode, type GroupParticipant, type GroupParticipantAction, type GroupParticipantsChanged, type GroupRole, type GroupSnapshot, type GuardResult, type ImageContent, type InviteResult, type LoadCommandsOptions, type LoadCommandsResult, type LoadedCommand, type LogContext, type LogEntry, type LogFormat, type LogLevel, type LogWriter, Logger, type LoggerConfig, type LoggerOptions, type LoginOptions, type MediaKind, type MediaSource, type MemberActionState, MemoryCache, type MemoryCacheStats, type MentionTarget, type Message, type MessageContent, type MessageContentKind, type MessageKey, type MessageMedia, type MultiAccountOptions, type MultiAppEvent, type MultiAppHealth, MultiCommandRouter, type MultiLoadCommandsResult, type MultiLoginOptions, type MuteChangeResult, type MuteEnforcement, type MuteOptions, type MuteRecord, MuteService, type MuteStore, type NumberOption, ParsedCommandOptions, type ParticipantUpdateResult, type PresenceState, type QuotedMessage, type ReconnectOptions, type RegisteredCommand, type RemoveMuteResult, type ReplyOptions, type RepostMessageOptions, type RouterOptions, type SentMessage, SqliteMuteStore, type StickerContent, type StoredMute, type StringOption, type TextContent, User, type UserData, type UserOption, type VideoContent, WhaNextApp, WhaNextError, type WhaNextErrorCode, WhaNextMultiApp, type WhatsAppProvider, create, createMulti, defineCommand, defineCommandGroup, defineCommands, defineSubcommand, guards, isCommandGroup, loadCommands, option, toWhaNextError };
+export { AccountService, type AddMuteOptions, type AddMuteResult, type AppEvents, type AppHealth, type AppHealthStatus, ArgsParser, type AudioContent, type BooleanOption, Browser, type ButtonsContent, type CacheOptions, type CacheStore, type CallEvent, type CallStatus, type ChangeResult, type CommandAccountContext, type CommandCatalogOptions, type CommandCatalogView, type CommandChatContext, type CommandConcurrency, type CommandContext, type CommandCooldown, type CommandDefinition, type CommandErrorHandler, type CommandGroupContext, type CommandGroupDefinition, type CommandGuard, type CommandHelpOptions, type CommandHooks, type CommandLocalization, type CommandMetadata, type CommandMiddleware, type CommandOptionDefinition, type CommandOptionSchema, type CommandOptionValue, type CommandOptionValues, type CommandRegistrar, CommandRouter, type CommandRuntimeServices, type CommandScope, type ConcurrencyStrategy, type ConnectionState, type ConnectionUpdate, type CopyCodeButton, type CreateMultiOptions, type CreateOptions, DeferredReply, type DownloadedMedia, type DurationOption, type EnumOption, type ExecutableCommandDefinition, type GroupAccess, type GroupAddressingMode, type GroupParticipant, type GroupParticipantAction, type GroupParticipantsChanged, type GroupRole, type GroupSnapshot, type GuardResult, type ImageContent, type InviteResult, type LinkButton, type LoadCommandsOptions, type LoadCommandsResult, type LoadedCommand, type LogContext, type LogEntry, type LogFormat, type LogLevel, type LogWriter, Logger, type LoggerConfig, type LoggerOptions, type LoginOptions, type MediaKind, type MediaSource, type MemberActionState, MemoryCache, type MemoryCacheStats, type MentionTarget, type Message, type MessageButton, type MessageContent, type MessageContentKind, type MessageDeleted, type MessageKey, type MessageMedia, type MultiAccountOptions, type MultiAppEvent, type MultiAppHealth, MultiCommandRouter, type MultiLoadCommandsResult, type MultiLoginOptions, type MuteChangeResult, type MuteEnforcement, type MuteOptions, type MuteRecord, MuteService, type MuteStore, type NumberOption, ParsedCommandOptions, type ParticipantUpdateResult, type PresenceState, type QuotedMessage, type ReconnectOptions, type RegisteredCommand, type RemoveMuteResult, type ReplyOptions, type RepostMessageOptions, type RouterOptions, type SentMessage, SqliteMuteStore, type StickerContent, type StoredMute, type StringOption, type TextContent, User, type UserData, type UserOption, type VideoContent, WhaNextApp, WhaNextError, type WhaNextErrorCode, WhaNextMultiApp, type WhatsAppProvider, create, createMulti, defineCommand, defineCommandGroup, defineCommands, defineSubcommand, guards, isCommandGroup, loadCommands, option, toWhaNextError };

package/dist/index.js

@@ -2036,6 +2036,9 @@ var MessageService = class {
     }
     return this.send(chatId, content);
   }
+  buttons(chatId, content) {
+    return this.send(chatId, content);
+  }
 };
 
 // src/app/whanext-app.ts
@@ -2194,6 +2197,15 @@ var WhaNextApp = class {
       });
       await this.#events.emit("call", call);
     });
+    this.#provider.on("messageDeleted", async (deletion) => {
+      this.logger.debug("Message deleted", {
+        chatId: deletion.key.chatId,
+        messageId: deletion.key.id,
+        deletedByMe: deletion.deletedByMe,
+        cached: deletion.message !== void 0
+      });
+      await this.#events.emit("messageDeleted", deletion);
+    });
     this.#provider.on("message", async (message) => {
       try {
         const enforcement = await this.mute.enforce(message);
@@ -2281,6 +2293,8 @@ import {
   Browsers,
   DisconnectReason,
   downloadMediaMessage,
+  generateWAMessageFromContent,
+  isJidGroup,
   makeWASocket,
   proto,
   useMultiFileAuthState
@@ -2685,6 +2699,9 @@ var BaileysProvider = class {
     }
   }
   async sendMessage(chatId, content, replyTo) {
+    if ("buttons" in content) {
+      return this.#sendButtons(chatId, content, replyTo);
+    }
     const socket = this.#requireSocket();
     const options = replyTo ? {
       quoted: {
@@ -2840,6 +2857,23 @@ var BaileysProvider = class {
         if (message) void this.#events.emit("message", message);
       }
     });
+    socket.ev.on("messages.update", (updates) => {
+      for (const { key, update } of updates) {
+        if (update.message !== null || !key.id || !key.remoteJid) continue;
+        const stored = this.#messageStore.get(this.#messageStoreKey(key));
+        const message = stored ? normalizeBaileysMessage(stored) : void 0;
+        const deletionKey = update.key;
+        const deletedByMe = deletionKey?.fromMe === true;
+        const deletedById = deletionKey?.participant ?? deletionKey?.participantAlt ?? (deletedByMe ? this.#socket?.user?.id : deletionKey?.remoteJid ?? void 0);
+        void this.#events.emit("messageDeleted", {
+          key: message?.keys ?? normalizeKey(key),
+          ...message ? { message } : {},
+          deletedByMe,
+          ...deletedById ? { deletedById } : {},
+          deletedAt: /* @__PURE__ */ new Date()
+        });
+      }
+    });
     socket.ev.on("groups.update", (groups) => {
       for (const group of groups) {
         if (group.id) {
@@ -2928,6 +2962,111 @@ var BaileysProvider = class {
     }
     return this.#socket;
   }
+  async #sendButtons(chatId, content, replyTo) {
+    const socket = this.#requireSocket();
+    const userJid = socket.user?.id;
+    if (!userJid) {
+      throw new WhaNextError(
+        "PROVIDER_ERROR",
+        "WhatsApp did not expose the current account identity for the interactive message."
+      );
+    }
+    const interactiveMessage = proto.Message.InteractiveMessage.create({
+      ...content.title !== void 0 ? {
+        header: {
+          title: content.title,
+          hasMediaAttachment: false
+        }
+      } : {},
+      body: { text: content.text },
+      ...content.footer !== void 0 ? { footer: { text: content.footer } } : {},
+      ...content.mentions && content.mentions.length > 0 ? {
+        contextInfo: {
+          mentionedJid: this.#mentions(content.mentions)
+        }
+      } : {},
+      nativeFlowMessage: {
+        buttons: content.buttons.map((button) => {
+          if (button.type === "copy") {
+            return {
+              name: "cta_copy",
+              buttonParamsJson: JSON.stringify({
+                display_text: button.label,
+                copy_code: button.code
+              })
+            };
+          }
+          return {
+            name: "cta_url",
+            buttonParamsJson: JSON.stringify({
+              display_text: button.label,
+              url: button.url,
+              merchant_url: button.url
+            })
+          };
+        }),
+        messageParamsJson: "{}",
+        messageVersion: 1
+      }
+    });
+    const quoted = replyTo ? {
+      key: this.#toWaKey(replyTo),
+      message: { conversation: "" }
+    } : void 0;
+    const generated = generateWAMessageFromContent(
+      chatId,
+      { interactiveMessage },
+      {
+        userJid,
+        ...quoted ? { quoted } : {}
+      }
+    );
+    const messageId = generated.key.id;
+    if (!generated.message || !messageId) {
+      throw new WhaNextError(
+        "PROVIDER_ERROR",
+        "WhatsApp could not generate the interactive message."
+      );
+    }
+    await socket.relayMessage(chatId, generated.message, {
+      messageId,
+      additionalNodes: this.#interactiveRelayNodes(chatId)
+    });
+    return this.#sent(generated);
+  }
+  #interactiveRelayNodes(chatId) {
+    const bizNode = {
+      tag: "biz",
+      attrs: {
+        actual_actors: "2",
+        host_storage: "2",
+        privacy_mode_ts: (Math.floor(Date.now() / 1e3) - 77980457).toString()
+      },
+      content: [
+        {
+          tag: "interactive",
+          attrs: { type: "native_flow", v: "1" },
+          content: [
+            {
+              tag: "native_flow",
+              attrs: { v: "9", name: "mixed" }
+            }
+          ]
+        },
+        {
+          tag: "quality_control",
+          attrs: { source_type: "third_party" }
+        }
+      ]
+    };
+    if (isJidGroup(chatId)) {
+      return [bizNode];
+    }
+    return [
+      { tag: "bot", attrs: { biz_bot: "1" } },
+      bizNode
+    ];
+  }
   #toContent(content) {
     if ("text" in content) {
       return {