@whanext/core 0.14.3 → 0.15.0

package/CHANGELOG.md

@@ -1,6 +1,27 @@
 # Changelog
 
 
+## 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

@@ -340,6 +340,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

@@ -139,6 +139,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 +178,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';
@@ -458,6 +476,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 {
@@ -886,4 +905,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 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
@@ -2281,6 +2284,8 @@ import {
   Browsers,
   DisconnectReason,
   downloadMediaMessage,
+  generateWAMessageFromContent,
+  isJidGroup,
   makeWASocket,
   proto,
   useMultiFileAuthState
@@ -2685,6 +2690,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: {
@@ -2928,6 +2936,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 {