@whanext/core 0.14.0 → 0.14.2

package/CHANGELOG.md

@@ -1,5 +1,32 @@
 # Changelog
 
+## 0.14.2
+
+### Corrigido
+
+- Mensagens privadas recebidas agora combinam `remoteJid` e `remoteJidAlt` nas identidades normalizadas do remetente, preservando PN JID e LID quando o WhatsApp fornece ambos.
+- `message.sender`, `message.senderIds` e `ctx.user.phone` passam a expor corretamente o número do remetente em chats privados LID sem exigir tratamento de Baileys na aplicação.
+- A identidade alternativa só é usada para mensagens recebidas em chats privados; mensagens de grupo e mensagens `fromMe` mantêm o comportamento anterior.
+
+### Compatibilidade
+
+- Nenhuma API pública foi removida ou alterada. Aplicações que já usam `ctx.user.phone` passam apenas a receber o número em mais casos.
+
+## 0.14.1
+
+### Corrigido
+
+- A normalização agora preserva corretamente o envelope de visualização única (`viewOnceMessage`, `viewOnceMessageV2` e `viewOnceMessageV2Extension`) antes de desembrulhar a mídia.
+- `message.isViewOnce` passa a ser verdadeiro mesmo quando o Baileys representa a visualização única apenas pelo wrapper externo.
+- Mensagens citadas agora expõem `quoted.isViewOnce`, `quoted.contentKind` e `quoted.media`, permitindo distinguir mídia normal de visualização única sem heurísticas na aplicação.
+- `app.media.download()` aceita diretamente uma `QuotedMessage`, permitindo `app.media.download(message.quoted)` quando houver mídia citada.
+- `app.account.jid`, `app.account.lid`, `app.account.phoneNumber` e `app.account.selfChatId` expõem identidades canônicas da própria conta. `selfChatId` prioriza PN JID sem sufixo de dispositivo antes de usar LID.
+
+### Compatibilidade
+
+- Os novos campos de `QuotedMessage` são opcionais no contrato público para não quebrar providers customizados ou objetos criados manualmente. O provider Baileys oficial os preenche nas mensagens normalizadas.
+- `app.media.download(message)` e `app.media.download(message.keys)` continuam funcionando sem alteração.
+
 ## 0.14.0
 
 ### Adicionado

package/README.md

@@ -373,7 +373,21 @@ const downloaded = await app.media.download(message);
 await writeFile(`./downloads/${downloaded.fileName ?? message.id}`, downloaded.data);
 ```
 
-`download()` aceita a `Message` recebida ou a sua `MessageKey` e devolve o buffer junto dos metadados normalizados. A mídia deve ser baixada enquanto a mensagem ainda está no cache da instância; o provider tenta renovar a URL de mídia automaticamente quando necessário.
+`download()` aceita a `Message` recebida, uma `QuotedMessage` ou uma `MessageKey` e devolve o buffer junto dos metadados normalizados. A mídia deve ser baixada enquanto a mensagem ainda está no cache da instância; o provider tenta renovar a URL de mídia automaticamente quando necessário.
+
+Para visualização única citada, o provider oficial preserva os metadados do envelope sem expor tipos do Baileys:
+
+```ts
+if (message.quoted?.isViewOnce && message.quoted.hasMedia) {
+  const media = await app.media.download(message.quoted);
+
+  console.log(message.quoted.contentKind); // image | video | audio
+  console.log(message.quoted.media?.kind);
+  console.log(media.mimetype);
+}
+```
+
+Isso também funciona quando a mídia de visualização única aparece dentro de envelopes `viewOnceMessageV2` ou `viewOnceMessageV2Extension`.
 
 Stickers aceitam `Uint8Array`, URL ou caminho local e devem estar em WebP, inclusive para animações. Texto, imagem e vídeo aceitam `User` diretamente em `mentions`.
 
@@ -559,6 +573,19 @@ if (ctx.isOwner) {
 }
 ```
 
+A identidade da própria conta também pode ser consultada sem escolher manualmente entre JID e LID:
+
+```ts
+console.log(app.account.jid);         // 5531...@s.whatsapp.net
+console.log(app.account.lid);         // ...@lid
+console.log(app.account.phoneNumber); // 5531...
+console.log(app.account.selfChatId);  // destino preferencial para falar consigo mesmo
+```
+
+`selfChatId` prioriza o PN JID canônico e remove automaticamente sufixos de dispositivo como `:12@s.whatsapp.net`.
+
+Em conversas privadas endereçadas por LID, o provider também aproveita o `remoteJidAlt` enviado pelo WhatsApp para preencher a identidade PN do remetente. Assim, quando esse mapeamento estiver presente no evento ao vivo, `ctx.user.phone` continua retornando o número normalmente mesmo que `ctx.chatId` termine em `@lid`.
+
 Na API legada, use `onlyOwner: true`:
 
 ```ts

package/dist/index.d.ts

@@ -86,6 +86,9 @@ interface QuotedMessage {
     senderId?: string;
     sender?: User;
     hasMedia: boolean;
+    isViewOnce?: boolean;
+    contentKind?: MessageContentKind;
+    media?: MessageMedia;
 }
 interface Message {
     id: string;
@@ -428,7 +431,7 @@ declare class MediaService {
     video(chatId: string, content: VideoContent): Promise<SentMessage>;
     audio(chatId: string, content: AudioContent): Promise<SentMessage>;
     sticker(chatId: string, content: StickerContent): Promise<SentMessage>;
-    download(message: Message | MessageKey): Promise<DownloadedMedia>;
+    download(message: Message | QuotedMessage | MessageKey): Promise<DownloadedMedia>;
 }
 
 declare class MemberService {
@@ -715,6 +718,10 @@ declare class AccountService {
     readonly id: string | undefined;
     constructor(provider: WhatsAppProvider, id?: string);
     get ids(): readonly string[];
+    get jid(): string | undefined;
+    get lid(): string | undefined;
+    get phoneNumber(): string | undefined;
+    get selfChatId(): string | undefined;
     isOwner(message: Pick<Message, 'keys' | 'senderIds'>): boolean;
 }
 

package/dist/index.js

@@ -1726,6 +1726,25 @@ var AccountService = class {
   get ids() {
     return uniqueIdentities(this.#provider.getCurrentUserIds());
   }
+  get jid() {
+    const identity = this.ids.find((candidate) => candidate.endsWith("@s.whatsapp.net") || candidate.endsWith("@c.us"));
+    if (identity) {
+      return normalizeIdentity(identity);
+    }
+    const phone = this.ids.map((candidate) => identityPhoneNumber(candidate)).find((candidate) => candidate !== void 0);
+    return phone ? `${phone}@s.whatsapp.net` : void 0;
+  }
+  get lid() {
+    const identity = this.ids.find((candidate) => candidate.endsWith("@lid"));
+    return identity ? normalizeIdentity(identity) : void 0;
+  }
+  get phoneNumber() {
+    const jid = this.jid;
+    return jid ? identityPhoneNumber(jid) : void 0;
+  }
+  get selfChatId() {
+    return this.jid ?? this.lid ?? this.ids[0];
+  }
   isOwner(message) {
     if (message.keys.fromMe) {
       return true;
@@ -1900,7 +1919,7 @@ var MediaService = class {
     return this.#provider.sendMessage(chatId, content);
   }
   download(message) {
-    const key = "keys" in message ? message.keys : message;
+    const key = "keys" in message ? message.keys : "key" in message ? message.key : message;
     return this.#provider.downloadMedia(key);
   }
 };
@@ -2331,6 +2350,13 @@ function unwrapMessageContent(input) {
   const nested = content.ephemeralMessage?.message ?? content.viewOnceMessage?.message ?? content.viewOnceMessageV2?.message ?? content.viewOnceMessageV2Extension?.message;
   return nested ? unwrapMessageContent(nested) : content;
 }
+function isViewOnceContent(input) {
+  if (!input) return false;
+  if (input.viewOnceMessage?.message || input.viewOnceMessageV2?.message || input.viewOnceMessageV2Extension?.message) {
+    return true;
+  }
+  return isViewOnceContent(input.ephemeralMessage?.message);
+}
 function extractQuotedBaileysMessage(input) {
   const chatId = input.key.remoteJid;
   const content = unwrapMessageContent(input.message);
@@ -2362,10 +2388,14 @@ function normalizeBaileysMessage(input) {
   const type = getContentType(content);
   const node = type ? content[type] : void 0;
   const context = getContextInfo(node);
+  const isPrivateIncoming = !chatId.endsWith("@g.us") && input.key.fromMe !== true;
+  const remoteJidAlt = input.key.remoteJidAlt;
   const senderIds = uniqueIdentities([
     input.key.participant,
     input.key.participantAlt,
-    input.key.participantUsername?.includes("@") ? input.key.participantUsername : void 0
+    input.key.participantUsername?.includes("@") ? input.key.participantUsername : void 0,
+    isPrivateIncoming ? remoteJidAlt : void 0,
+    isPrivateIncoming ? chatId : void 0
   ]);
   const senderJid = senderIds.find((identity) => identity.endsWith("@s.whatsapp.net") || identity.endsWith("@c.us"));
   const senderLid = senderIds.find((identity) => identity.endsWith("@lid"));
@@ -2376,7 +2406,8 @@ function normalizeBaileysMessage(input) {
     ...input.pushName ? { name: input.pushName } : {}
   });
   const mentionedUsers = (context?.mentionedJid ?? []).map((identity) => User.fromIdentities([identity]));
-  const media = getMedia(type, node, Boolean(input.key.isViewOnce));
+  const viewOnce = Boolean(input.key.isViewOnce) || isViewOnceContent(input.message);
+  const media = getMedia(type, node, viewOnce);
   const contentKind = getContentKind(type);
   const text = getText(content);
   const caption = getCaption(content);
@@ -2496,21 +2527,26 @@ function getQuoted(context, chatId) {
     return void 0;
   }
   const quoted = context.quotedMessage;
+  const quotedIsViewOnce = isViewOnceContent(quoted);
   const content = unwrapMessageContent(quoted);
+  const type = content ? getContentType(content) : void 0;
+  const node = type && content ? content[type] : void 0;
+  const media = getMedia(type, node, quotedIsViewOnce);
   const result = {
     key: {
       id: context.stanzaId,
       chatId: context.remoteJid ?? chatId,
       fromMe: false
     },
-    hasMedia: Boolean(
-      content && getMedia(
-        getContentType(content),
-        content[getContentType(content) ?? "conversation"],
-        false
-      )
-    )
+    hasMedia: media !== void 0,
+    isViewOnce: media?.viewOnce ?? quotedIsViewOnce
   };
+  if (content) {
+    result.contentKind = getContentKind(type);
+  }
+  if (media) {
+    result.media = media;
+  }
   if (context.participant) {
     result.senderId = context.participant;
     result.sender = User.fromIdentities([context.participant]);