@whanext/core 0.11.0 → 0.13.0

package/CHANGELOG.md

@@ -1,5 +1,26 @@
 # Changelog
 
+## 0.13.0
+
+- Adicionado `MessageService.repost()` para republicar qualquer mensagem do WhatsApp recebida recentemente, sem criar uma resposta.
+- Adicionado suporte a `repostMessage()` em nível de provedor, com injeção de menções.
+- As republicações preservam o payload estruturado original, permitindo que textos, mídias, figurinhas, enquetes, localizações, contatos e mensagens de catálogo sejam reutilizados através da API de alto nível.
+
+
+## 0.12.0 - Message content classification
+
+### Adicionado
+
+- `Message.contentKind` para classificar o payload recebido sem expor tipos do Baileys.
+- Novo tipo público `MessageContentKind`.
+- Classificação nativa para texto, imagem, vídeo, áudio, documento, sticker, localização, contato, enquete e catálogo/produto.
+- `unknown` como fallback para formatos ainda não normalizados pela biblioteca.
+
+### Compatibilidade
+
+- `contentKind` é opcional no contrato público para manter compatibilidade com providers customizados e objetos `Message` criados por aplicações existentes.
+- O `BaileysProvider` oficial sempre preenche `contentKind` nas mensagens recebidas.
+- `message.media.kind` continua sendo a API indicada para mídia baixável; `contentKind` complementa essa API com tipos não-mídia.
 
 ## 0.11.0 - Command discovery
 

package/README.md

@@ -220,6 +220,22 @@ if (app.isReady) {
 
 Toda mensagem possui `message.sender: User`. Menções ficam em `message.mentionedUsers`, e o remetente de um reply em `message.quoted?.sender`.
 
+O provider Baileys também classifica o payload em `message.contentKind`, sem exigir acesso aos tipos internos do Baileys ou download da mídia:
+
+```ts
+app.on('message', async (message) => {
+  if (message.contentKind === 'location') {
+    console.log('Localização recebida');
+  }
+
+  if (message.contentKind === 'poll') {
+    console.log('Enquete recebida');
+  }
+});
+```
+
+Os valores disponíveis são `text`, `image`, `video`, `audio`, `document`, `sticker`, `location`, `contact`, `poll`, `catalog` e `unknown`. Para mídia baixável, continue usando `message.media.kind`.
+
 ```ts
 app.on('message', async (message) => {
   console.log(message.sender.id);
@@ -787,3 +803,16 @@ MIT. Consulte [LICENSE](./LICENSE).
 ## Aviso
 
 WhaNext não é afiliado, autorizado ou mantido pelo WhatsApp ou pela Meta. O provider padrão usa uma integração não oficial; quem utiliza o projeto é responsável pelos termos aplicáveis e pelos riscos de bloqueio da conta.
+
+
+### Reposting received messages
+
+WhaNext can repost a recently received message while preserving its original WhatsApp payload:
+
+```ts
+await app.message.repost(message.quoted!.key, message.chatId, {
+  mentions: users,
+});
+```
+
+The source message must still be present in the provider recent-message cache. This avoids downloading and reconstructing media or structured messages.

package/dist/index.d.ts

@@ -65,6 +65,14 @@ interface MessageKey {
     participantId?: string;
 }
 type MediaKind = 'image' | 'video' | 'audio' | 'document' | 'sticker';
+/**
+ * High-level classification of the received WhatsApp message payload.
+ *
+ * `media.kind` remains the source of truth for downloadable media.
+ * `contentKind` additionally exposes non-media payloads such as locations,
+ * contacts, polls and catalog/product messages without leaking Baileys types.
+ */
+type MessageContentKind = 'text' | 'image' | 'video' | 'audio' | 'document' | 'sticker' | 'location' | 'contact' | 'poll' | 'catalog' | 'unknown';
 interface MessageMedia {
     kind: MediaKind;
     mimetype?: string;
@@ -99,6 +107,7 @@ interface Message {
     isReply: boolean;
     isViewOnce: boolean;
     hasMedia: boolean;
+    contentKind?: MessageContentKind;
     media?: MessageMedia;
     quoted?: QuotedMessage;
 }
@@ -120,6 +129,11 @@ type MediaSource = Uint8Array | {
     path: string;
 };
 type MentionTarget = string | User;
+/** Options for reposting a previously received message without quoting it. */
+interface RepostMessageOptions {
+    /** Hidden or visible mentions injected into the reposted payload. */
+    mentions?: readonly MentionTarget[];
+}
 interface TextContent {
     text: string;
     mentions?: MentionTarget[];
@@ -229,6 +243,7 @@ interface WhatsAppProvider {
     requestPairingCode(phone: string): Promise<string>;
     on<Event extends keyof ProviderEvents>(event: Event, listener: (payload: ProviderEvents[Event]) => void | Promise<void>): Unsubscribe;
     sendMessage(chatId: string, content: MessageContent, replyTo?: MessageKey): Promise<SentMessage>;
+    repostMessage(source: MessageKey, chatId: string, options?: RepostMessageOptions): Promise<SentMessage>;
     reactToMessage(key: MessageKey, emoji?: string): Promise<SentMessage>;
     downloadMedia(key: MessageKey): Promise<DownloadedMedia>;
     editMessage(key: MessageKey, content: string): Promise<SentMessage>;
@@ -431,6 +446,12 @@ declare class MessageService {
     constructor(provider: WhatsAppProvider);
     send(chatId: string, content: MessageContent): Promise<SentMessage>;
     reply(message: Message, content: MessageContent): Promise<SentMessage>;
+    /**
+     * Reposts a cached received message into a chat without creating a reply.
+     * The original payload is preserved by the provider, so this works for
+     * media and structured WhatsApp messages as well as text.
+     */
+    repost(source: Message | MessageKey, chatId: string, options?: RepostMessageOptions): Promise<SentMessage>;
     edit(message: Message | SentMessage | MessageKey, text: string): Promise<SentMessage>;
     delete(message: Message | SentMessage | MessageKey): Promise<void>;
     react(message: Message | SentMessage | MessageKey, emoji: string): Promise<SentMessage>;
@@ -791,4 +812,4 @@ declare class SqliteMuteStore implements MuteStore {
     close(): void;
 }
 
-export { 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 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 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 MessageKey, type MessageMedia, 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 RouterOptions, type SentMessage, SqliteMuteStore, type StickerContent, type StoredMute, type StringOption, type TextContent, User, type UserData, type UserOption, type VideoContent, WhaNextApp, WhaNextError, type WhaNextErrorCode, type WhatsAppProvider, create, defineCommand, defineCommandGroup, defineCommands, defineSubcommand, guards, isCommandGroup, loadCommands, option, toWhaNextError };
+export { 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 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 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 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, type WhatsAppProvider, create, defineCommand, defineCommandGroup, defineCommands, defineSubcommand, guards, isCommandGroup, loadCommands, option, toWhaNextError };

package/dist/index.js

@@ -1946,6 +1946,15 @@ var MessageService = class {
   reply(message, content) {
     return this.#provider.sendMessage(message.chatId, content, message.keys);
   }
+  /**
+   * Reposts a cached received message into a chat without creating a reply.
+   * The original payload is preserved by the provider, so this works for
+   * media and structured WhatsApp messages as well as text.
+   */
+  repost(source, chatId, options = {}) {
+    const key = "keys" in source ? source.keys : source;
+    return this.#provider.repostMessage(key, chatId, options);
+  }
   edit(message, text) {
     const key = "keys" in message ? message.keys : message;
     return this.#provider.editMessage(key, text);
@@ -2301,6 +2310,7 @@ function normalizeBaileysMessage(input) {
   });
   const mentionedUsers = (context?.mentionedJid ?? []).map((identity) => User.fromIdentities([identity]));
   const media = getMedia(type, node, Boolean(input.key.isViewOnce));
+  const contentKind = getContentKind(type);
   const text = getText(content);
   const caption = getCaption(content);
   const quoted = getQuoted(context, chatId);
@@ -2318,7 +2328,8 @@ function normalizeBaileysMessage(input) {
     isGroup: chatId.endsWith("@g.us"),
     isReply: quoted !== void 0,
     isViewOnce: media?.viewOnce ?? false,
-    hasMedia: media !== void 0
+    hasMedia: media !== void 0,
+    contentKind
   };
   if (senderJid !== void 0) message.senderJid = senderJid;
   if (senderLid !== void 0) {
@@ -2331,6 +2342,42 @@ function normalizeBaileysMessage(input) {
   if (quoted !== void 0) message.quoted = quoted;
   return message;
 }
+function getContentKind(type) {
+  switch (String(type ?? "")) {
+    case "conversation":
+    case "extendedTextMessage":
+    case "buttonsResponseMessage":
+    case "listResponseMessage":
+    case "templateButtonReplyMessage":
+      return "text";
+    case "imageMessage":
+      return "image";
+    case "videoMessage":
+      return "video";
+    case "audioMessage":
+      return "audio";
+    case "documentMessage":
+    case "documentWithCaptionMessage":
+      return "document";
+    case "stickerMessage":
+      return "sticker";
+    case "locationMessage":
+    case "liveLocationMessage":
+      return "location";
+    case "contactMessage":
+    case "contactsArrayMessage":
+      return "contact";
+    case "pollCreationMessage":
+    case "pollCreationMessageV2":
+    case "pollCreationMessageV3":
+      return "poll";
+    case "productMessage":
+    case "orderMessage":
+      return "catalog";
+    default:
+      return "unknown";
+  }
+}
 function normalizeKey(key) {
   const normalized = {
     id: key.id ?? "",
@@ -2545,6 +2592,25 @@ var BaileysProvider = class {
     const result = await socket.sendMessage(chatId, this.#toContent(content), options);
     return this.#sent(result);
   }
+  async repostMessage(source, chatId, options = {}) {
+    const original = this.#messageStore.get(this.#messageStoreKey(source));
+    if (!original?.message) {
+      throw new WhaNextError(
+        "MESSAGE_NOT_FOUND",
+        "The source message is no longer available in the recent-message cache.",
+        {
+          context: { messageId: source.id, chatId: source.chatId },
+          recoverable: true
+        }
+      );
+    }
+    const content = {
+      forward: original,
+      ...options.mentions && options.mentions.length > 0 ? { mentions: this.#mentions(options.mentions) } : {}
+    };
+    const result = await this.#requireSocket().sendMessage(chatId, content);
+    return this.#sent(result);
+  }
   async reactToMessage(key, emoji) {
     const result = await this.#requireSocket().sendMessage(key.chatId, {
       react: {