@whanext/core 0.12.0 → 0.13.1

package/CHANGELOG.md

@@ -1,5 +1,16 @@
 # Changelog
 
+## 0.13.1
+
+- Corrigido download de mídias para mensagens visualização única citadas, através do cache do payload citado carregado em `contextInfo`.
+- Adicionado desempacotamento explícito para envelopes de mensagens efêmeras e de visualização única, incluindo `viewOnceMessageV2Extension`.
+
+## 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
 

package/README.md

@@ -803,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

@@ -129,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[];
@@ -238,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>;
@@ -440,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>;
@@ -800,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 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 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);
@@ -2272,14 +2281,39 @@ import {
   getContentType,
   normalizeMessageContent
 } from "@whiskeysockets/baileys";
+function unwrapMessageContent(input) {
+  if (!input) return void 0;
+  const normalized = normalizeMessageContent(input);
+  const content = extractMessageContent(normalized);
+  if (!content) return void 0;
+  const nested = content.ephemeralMessage?.message ?? content.viewOnceMessage?.message ?? content.viewOnceMessageV2?.message ?? content.viewOnceMessageV2Extension?.message;
+  return nested ? unwrapMessageContent(nested) : content;
+}
+function extractQuotedBaileysMessage(input) {
+  const chatId = input.key.remoteJid;
+  const content = unwrapMessageContent(input.message);
+  if (!chatId || !content) return void 0;
+  const type = getContentType(content);
+  const node = type ? content[type] : void 0;
+  const context = getContextInfo(node);
+  if (!context?.stanzaId || !context.quotedMessage) return void 0;
+  return {
+    key: {
+      id: context.stanzaId,
+      remoteJid: context.remoteJid ?? chatId,
+      fromMe: false,
+      ...context.participant ? { participant: context.participant } : {}
+    },
+    message: context.quotedMessage
+  };
+}
 function normalizeBaileysMessage(input) {
   const chatId = input.key.remoteJid;
   const id = input.key.id;
   if (!chatId || !id || !input.message) {
     return void 0;
   }
-  const normalized = normalizeMessageContent(input.message);
-  const content = extractMessageContent(normalized);
+  const content = unwrapMessageContent(input.message);
   if (!content) {
     return void 0;
   }
@@ -2420,8 +2454,7 @@ function getQuoted(context, chatId) {
     return void 0;
   }
   const quoted = context.quotedMessage;
-  const normalized = normalizeMessageContent(quoted);
-  const content = extractMessageContent(normalized);
+  const content = unwrapMessageContent(quoted);
   const result = {
     key: {
       id: context.stanzaId,
@@ -2583,6 +2616,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: {
@@ -2703,6 +2755,8 @@ var BaileysProvider = class {
       if (type !== "notify") return;
       for (const raw of messages) {
         if (raw.key.id && raw.message) this.#remember(raw);
+        const quoted = extractQuotedBaileysMessage(raw);
+        if (quoted?.key.id && quoted.message) this.#remember(quoted);
         const message = normalizeBaileysMessage(raw);
         if (message) void this.#events.emit("message", message);
       }