@whanext/core 0.5.1 → 0.8.0

package/CHANGELOG.md

@@ -2,6 +2,37 @@
 
 Todas as mudanças relevantes do projeto serão registradas neste arquivo.
 
+## 0.8.0
+
+### Adicionado
+
+- `app.media.sticker(chatId, { sticker })` para enviar stickers WebP estáticos ou animados a partir de bytes, URL ou arquivo local.
+
+## 0.7.0
+
+### Adicionado
+
+- `app.message.react(message, emoji)` e `app.message.unreact(message)` para adicionar e remover reações sem expor tipos do provider.
+- Evento `groupParticipantsChanged`, com grupo, ação, participantes afetados e autor quando informado pelo WhatsApp.
+
+### Alterado
+
+- Alterações de participantes continuam invalidando automaticamente o cache de metadados do grupo antes da emissão do evento público.
+
+## 0.6.0
+
+### Adicionado
+
+- `app.media.download(message)` para baixar imagens, vídeos, áudios, documentos e stickers recebidos como um `Buffer` com metadados normalizados.
+- Renovação automática da URL de mídia quando o link original expira.
+- Configurações `cache.memoryMaxEntries` e `messageCacheSize` para limitar a memória usada pelos caches internos.
+
+### Alterado
+
+- O cache em memória agora usa LRU e agrupa buscas simultâneas dos metadados do mesmo grupo em uma única consulta ao WhatsApp.
+- O cache de mensagens usa a chave completa da conversa, evitando colisões entre mensagens de chats distintos, e mantém até 1.000 entradas por padrão.
+- Envio de presença deixou de fazer uma assinatura remota antes de cada atualização, reduzindo uma ida extra à rede para `typing`, `recording` e `paused`.
+
 ## 0.5.1
 
 ### Adicionado

package/CONTRIBUTING.md

@@ -18,6 +18,9 @@ npm run check
 - A API pública usa modelos e erros do WhaNext.
 - Operações dependentes de estado retornam resultados tipados e idempotentes.
 - JID, LID e PN são resolvidos pela biblioteca.
+- Mídias são expostas por modelos normalizados; tipos e objetos do provider não entram na API pública.
+- APIs de presença não devem adicionar chamadas remotas além da atualização de estado solicitada.
+- Caches internos devem ter limite de memória, TTL quando aplicável e cobertura para concorrência.
 - Novos comportamentos possuem testes sem conexão real com o WhatsApp.
 - Imports com vários nomes mantêm um nome por linha.
 - Código-fonte não contém comentários explicando implementação óbvia.

package/README.md

@@ -35,7 +35,7 @@ await app.login({
 - Login por pairing code, sessão persistente e reconexão automática.
 - Prefixo global e comandos declarativos com argumentos tipados.
 - Usuários normalizados entre JID, LID e PN.
-- Mensagens, replies, edição, exclusão, menções e mídias.
+- Mensagens, replies, edição, exclusão, 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.
@@ -261,10 +261,15 @@ await app.message.reply(message, {
 
 await app.message.edit(sent, 'Texto atualizado.');
 await app.message.delete(sent);
+
+await app.message.react(sent, '👏🏻');
+await app.message.unreact(sent);
 ```
 
 `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.
+
 ## Mídias
 
 ```ts
@@ -284,9 +289,19 @@ await app.media.audio(chatId, {
   mimetype: 'audio/ogg; codecs=opus',
   voice: true,
 });
+
+await app.media.sticker(chatId, {
+  sticker: { path: './sticker.webp' },
+});
+
+const downloaded = await app.media.download(message);
+
+await writeFile(`./downloads/${downloaded.fileName ?? message.id}`, downloaded.data);
 ```
 
-Texto, imagem e vídeo aceitam `User` diretamente em `mentions`.
+`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.
+
+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`.
 
 ## Grupos e membros
 
@@ -305,6 +320,19 @@ await app.member.demote(groupId, user);
 
 Estados como `already_open`, `already_admin`, `not_admin`, `not_in_group` e `already_removed` evitam mutações redundantes. A biblioteca escolhe automaticamente a identidade correta para grupos LID ou PN e só retorna sucesso depois da confirmação do WhatsApp.
 
+Mudanças feitas por outros participantes podem ser acompanhadas sem lidar com o provider:
+
+```ts
+app.on('groupParticipantsChanged', async (change) => {
+  console.log(change.groupId);
+  console.log(change.action);
+  console.log(change.participantIds);
+  console.log(change.authorId);
+});
+```
+
+`action` pode ser `add`, `remove`, `promote`, `demote` ou `modify`. O cache de metadados do grupo é invalidado antes desse evento ser emitido.
+
 ## Mute nativo
 
 Quando habilitado, o mute é aplicado antes dos eventos públicos e do router. Mensagens de um usuário mutado são apagadas automaticamente.
@@ -489,11 +517,18 @@ const app = await create({
   cache: {
     store: myRedisStore,
     groupTtlMs: 300_000,
+    memoryMaxEntries: 1_000,
   },
 });
 ```
 
-O cache padrão vive na instância do app. Eventos e mutações de grupo invalidam automaticamente entradas relacionadas.
+O cache padrão vive na instância do app, usa LRU limitado e elimina entradas expiradas durante as leituras. Consultas simultâneas dos mesmos metadados são agrupadas em uma única chamada ao WhatsApp. Eventos e mutações de grupo invalidam automaticamente entradas relacionadas.
+
+O cache interno de mensagens mantém até 1.000 mensagens por padrão para replies, reenvios do provider e downloads de mídia. Ajuste quando necessário:
+
+```ts
+const app = await create({ messageCacheSize: 2_000 });
+```
 
 ## Presença
 
@@ -503,6 +538,8 @@ await app.chat.recording(chatId);
 await app.chat.stopTyping(chatId);
 ```
 
+`typing()` envia `composing`, `recording()` envia `recording` com mídia de áudio e `stopTyping()` envia `paused`, conforme o protocolo do WhatsApp. Nenhuma assinatura de presença desnecessária é feita antes do envio.
+
 ## Chamadas
 
 ```ts
@@ -533,8 +570,8 @@ Todos os erros públicos usam `WhaNextError` e códigos estáveis. O logger regi
 
 | Domínio | Responsabilidade |
 | --- | --- |
-| `app.message` | Envio, reply, edição, exclusão e texto |
-| `app.media` | Imagem, vídeo e áudio |
+| `app.message` | Envio, reply, edição, exclusão, texto e reações |
+| `app.media` | Envio, download e stickers |
 | `app.group` | Estado, convite, pin e metadados |
 | `app.member` | Remoção, promoção e rebaixamento |
 | `app.user` | Criação e resolução de usuários |
@@ -544,6 +581,7 @@ Todos os erros públicos usam `WhaNextError` e códigos estáveis. O logger regi
 | `app.router()` | Registro e despacho de comandos |
 | `loadCommands()` | Autoload de comandos a partir de uma pasta |
 | `app.health()` | Snapshot de saúde da aplicação |
+| `app.on('groupParticipantsChanged')` | Alterações de participantes em grupos |
 
 ## Exemplo executável
 

package/SECURITY.md

@@ -4,7 +4,7 @@
 
 | Versão | Suporte |
 | --- | --- |
-| 0.3.x | Sim |
+| 0.8.x | Sim |
 | anteriores | Não |
 
 ## Reportando uma vulnerabilidade

package/dist/index.d.ts

@@ -7,6 +7,7 @@ interface CacheStore {
 interface CacheOptions {
     store?: CacheStore;
     groupTtlMs?: number;
+    memoryMaxEntries?: number;
 }
 
 interface UserData {
@@ -107,6 +108,12 @@ interface SentMessage {
     keys: MessageKey;
     timestamp: Date;
 }
+interface DownloadedMedia {
+    data: Buffer;
+    kind: MediaKind;
+    mimetype?: string;
+    fileName?: string;
+}
 type MediaSource = Uint8Array | {
     url: string;
 } | {
@@ -135,7 +142,10 @@ interface AudioContent {
     mimetype?: string;
     voice?: boolean;
 }
-type MessageContent = TextContent | ImageContent | VideoContent | AudioContent;
+interface StickerContent {
+    sticker: MediaSource;
+}
+type MessageContent = TextContent | ImageContent | VideoContent | AudioContent | StickerContent;
 
 interface CommandDefinition {
     name: string;
@@ -150,7 +160,7 @@ interface CommandDefinition {
 declare function defineCommand<const Command extends CommandDefinition>(command: Command): Command;
 declare function defineCommands<const Commands extends readonly CommandDefinition[]>(...commands: Commands): Commands;
 
-type WhaNextErrorCode = 'AUTH_INVALID_PHONE' | 'AUTH_EXPIRED' | 'CONNECTION_CLOSED' | 'CONNECTION_FAILED' | 'GROUP_NOT_FOUND' | 'MEMBER_NOT_FOUND' | 'BOT_NOT_ADMIN' | 'MESSAGE_NOT_FOUND' | 'MUTE_DISABLED' | 'STORAGE_ERROR' | 'ARGUMENT_MISSING' | 'ARGUMENT_INVALID' | 'COMMAND_NOT_ALLOWED' | 'COMMAND_LOAD_FAILED' | 'PROVIDER_ERROR' | 'UNKNOWN_ERROR';
+type WhaNextErrorCode = 'AUTH_INVALID_PHONE' | 'AUTH_EXPIRED' | 'CONNECTION_CLOSED' | 'CONNECTION_FAILED' | 'GROUP_NOT_FOUND' | 'MEMBER_NOT_FOUND' | 'BOT_NOT_ADMIN' | 'MESSAGE_NOT_FOUND' | 'MEDIA_NOT_AVAILABLE' | 'MUTE_DISABLED' | 'STORAGE_ERROR' | 'ARGUMENT_MISSING' | 'ARGUMENT_INVALID' | 'COMMAND_NOT_ALLOWED' | 'COMMAND_LOAD_FAILED' | 'PROVIDER_ERROR' | 'UNKNOWN_ERROR';
 interface WhaNextErrorOptions {
     cause?: unknown;
     context?: Readonly<Record<string, unknown>>;
@@ -167,6 +177,13 @@ declare function toWhaNextError(error: unknown, context?: Readonly<Record<string
 type GroupAccess = 'open' | 'closed';
 type GroupRole = 'member' | 'admin' | 'owner';
 type GroupAddressingMode = 'lid' | 'pn';
+type GroupParticipantAction = 'add' | 'remove' | 'promote' | 'demote' | 'modify';
+interface GroupParticipantsChanged {
+    groupId: string;
+    action: GroupParticipantAction;
+    participantIds: string[];
+    authorId?: string;
+}
 interface GroupParticipant {
     id: string;
     lid?: string;
@@ -228,6 +245,7 @@ interface ProviderEvents {
     groupChanged: {
         groupId: string;
     };
+    groupParticipantsChanged: GroupParticipantsChanged;
     call: CallEvent;
 }
 type Unsubscribe = () => void;
@@ -238,6 +256,8 @@ 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>;
+    reactToMessage(key: MessageKey, emoji?: string): Promise<SentMessage>;
+    downloadMedia(key: MessageKey): Promise<DownloadedMedia>;
     editMessage(key: MessageKey, content: string): Promise<SentMessage>;
     deleteMessage(key: MessageKey): Promise<void>;
     getGroup(groupId: string): Promise<GroupSnapshot>;
@@ -393,6 +413,8 @@ declare class MediaService {
     image(chatId: string, content: ImageContent): Promise<SentMessage>;
     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>;
 }
 
 declare class MemberService {
@@ -410,6 +432,8 @@ declare class MessageService {
     reply(message: Message, content: MessageContent): 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>;
+    unreact(message: Message | SentMessage | MessageKey): Promise<SentMessage>;
     text(chatId: string, text: string, mentions?: MentionTarget[]): Promise<SentMessage>;
 }
 
@@ -426,6 +450,7 @@ interface AppEvents {
     error: WhaNextError;
     mute: MuteEnforcement;
     call: CallEvent;
+    groupParticipantsChanged: GroupParticipantsChanged;
 }
 interface LoginOptions {
     onCode?: (code: string) => void | Promise<void>;
@@ -491,12 +516,16 @@ interface CreateOptions {
     mute?: MuteOptions;
     router?: Omit<RouterOptions, 'prefix'>;
     reconnect?: ReconnectOptions;
+    messageCacheSize?: number;
     provider?: WhatsAppProvider;
 }
 declare function create(options?: CreateOptions): Promise<WhaNextApp>;
 
 declare class MemoryCache implements CacheStore {
     #private;
+    constructor(options?: {
+        maxEntries?: number;
+    });
     get<T>(key: string): Promise<T | undefined>;
     set<T>(key: string, value: T, ttlMs?: number): Promise<void>;
     delete(key: string): Promise<void>;
@@ -531,4 +560,4 @@ declare class SqliteMuteStore implements MuteStore {
     close(): void;
 }
 
-export { type AddMuteOptions, type AddMuteResult, type AppEvents, type AppHealth, type AppHealthStatus, ArgsParser, type AudioContent, Browser, type CacheOptions, type CacheStore, type CallEvent, type CallStatus, type ChangeResult, type CommandDefinition, type CommandRegistrar, CommandRouter, type ConnectionState, type ConnectionUpdate, type CreateOptions, type GroupAccess, type GroupAddressingMode, type GroupParticipant, type GroupRole, type GroupSnapshot, 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 MentionTarget, type Message, type MessageContent, type MessageKey, type MessageMedia, type MuteChangeResult, type MuteEnforcement, type MuteOptions, type MuteRecord, MuteService, type MuteStore, type ParticipantUpdateResult, type PresenceState, type QuotedMessage, type ReconnectOptions, type RemoveMuteResult, type RouterOptions, type SentMessage, SqliteMuteStore, type StoredMute, type TextContent, User, type UserData, type VideoContent, WhaNextApp, WhaNextError, type WhaNextErrorCode, type WhatsAppProvider, create, defineCommand, defineCommands, loadCommands, toWhaNextError };
+export { type AddMuteOptions, type AddMuteResult, type AppEvents, type AppHealth, type AppHealthStatus, ArgsParser, type AudioContent, Browser, type CacheOptions, type CacheStore, type CallEvent, type CallStatus, type ChangeResult, type CommandDefinition, type CommandRegistrar, CommandRouter, type ConnectionState, type ConnectionUpdate, type CreateOptions, type DownloadedMedia, type GroupAccess, type GroupAddressingMode, type GroupParticipant, type GroupParticipantAction, type GroupParticipantsChanged, type GroupRole, type GroupSnapshot, 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 MentionTarget, type Message, type MessageContent, type MessageKey, type MessageMedia, type MuteChangeResult, type MuteEnforcement, type MuteOptions, type MuteRecord, MuteService, type MuteStore, type ParticipantUpdateResult, type PresenceState, type QuotedMessage, type ReconnectOptions, type RemoveMuteResult, type RouterOptions, type SentMessage, SqliteMuteStore, type StickerContent, type StoredMute, type TextContent, User, type UserData, type VideoContent, WhaNextApp, WhaNextError, type WhaNextErrorCode, type WhatsAppProvider, create, defineCommand, defineCommands, loadCommands, toWhaNextError };

package/dist/index.js

@@ -1,6 +1,10 @@
 // src/cache/memory-cache.ts
 var MemoryCache = class {
   #entries = /* @__PURE__ */ new Map();
+  #maxEntries;
+  constructor(options = {}) {
+    this.#maxEntries = Math.max(1, options.maxEntries ?? 1e3);
+  }
   async get(key) {
     const entry = this.#entries.get(key);
     if (!entry) {
@@ -10,6 +14,8 @@ var MemoryCache = class {
       this.#entries.delete(key);
       return void 0;
     }
+    this.#entries.delete(key);
+    this.#entries.set(key, entry);
     return entry.value;
   }
   async set(key, value, ttlMs) {
@@ -18,6 +24,11 @@ var MemoryCache = class {
       entry.expiresAt = Date.now() + ttlMs;
     }
     this.#entries.set(key, entry);
+    while (this.#entries.size > this.#maxEntries) {
+      const oldest = this.#entries.keys().next().value;
+      if (oldest === void 0) return;
+      this.#entries.delete(oldest);
+    }
   }
   async delete(key) {
     this.#entries.delete(key);
@@ -932,6 +943,7 @@ var GroupService = class {
   #provider;
   #cache;
   #ttlMs;
+  #requests = /* @__PURE__ */ new Map();
   constructor(provider, cache, ttlMs = 3e5) {
     this.#provider = provider;
     this.#cache = cache;
@@ -979,9 +991,17 @@ var GroupService = class {
         return cached;
       }
     }
-    const group = await this.#provider.getGroup(groupId);
-    await this.#cache.set(key, group, this.#ttlMs);
-    return group;
+    const pending = this.#requests.get(key);
+    if (pending) {
+      return pending;
+    }
+    const request = this.#loadMetadata(key, groupId);
+    this.#requests.set(key, request);
+    try {
+      return await request;
+    } finally {
+      this.#requests.delete(key);
+    }
   }
   async isAdmin(groupId, memberIds) {
     if (!groupId.endsWith("@g.us")) {
@@ -1030,6 +1050,11 @@ var GroupService = class {
   #key(groupId) {
     return `group:${groupId}`;
   }
+  async #loadMetadata(key, groupId) {
+    const group = await this.#provider.getGroup(groupId);
+    await this.#cache.set(key, group, this.#ttlMs);
+    return group;
+  }
   #matchesParticipant(participant, identities) {
     const participantIds = [participant.id, participant.lid, participant.phoneNumber].filter((identity) => identity !== void 0);
     return identities.some((identity) => participantIds.some((participantId) => identitiesMatch(identity, participantId)));
@@ -1051,6 +1076,13 @@ var MediaService = class {
   audio(chatId, content) {
     return this.#provider.sendMessage(chatId, content);
   }
+  sticker(chatId, content) {
+    return this.#provider.sendMessage(chatId, content);
+  }
+  download(message) {
+    const key = "keys" in message ? message.keys : message;
+    return this.#provider.downloadMedia(key);
+  }
 };
 
 // src/services/member-service.ts
@@ -1141,6 +1173,14 @@ var MessageService = class {
     const key = "keys" in message ? message.keys : message;
     return this.#provider.deleteMessage(key);
   }
+  react(message, emoji) {
+    const key = "keys" in message ? message.keys : message;
+    return this.#provider.reactToMessage(key, emoji);
+  }
+  unreact(message) {
+    const key = "keys" in message ? message.keys : message;
+    return this.#provider.reactToMessage(key);
+  }
   text(chatId, text, mentions) {
     const content = { text };
     if (mentions !== void 0) {
@@ -1199,7 +1239,9 @@ var WhaNextApp = class {
     this.#provider = provider;
     this.#phone = options.phone;
     this.logger = logger;
-    const cache = options.cache?.store ?? new MemoryCache();
+    const cache = options.cache?.store ?? new MemoryCache(
+      options.cache?.memoryMaxEntries === void 0 ? void 0 : { maxEntries: options.cache.memoryMaxEntries }
+    );
     this.group = new GroupService(provider, cache, options.cache?.groupTtlMs);
     this.member = new MemberService(provider, this.group);
     this.message = new MessageService(provider);
@@ -1307,6 +1349,10 @@ var WhaNextApp = class {
       await this.#events.emit("connection", update);
     });
     this.#provider.on("groupChanged", ({ groupId }) => this.group.invalidate(groupId));
+    this.#provider.on("groupParticipantsChanged", async (change) => {
+      await this.group.invalidate(change.groupId);
+      await this.#events.emit("groupParticipantsChanged", change);
+    });
     this.#provider.on("call", async (call) => {
       this.logger.debug("Call received", {
         callId: call.id,
@@ -1401,6 +1447,7 @@ var Browser = /* @__PURE__ */ ((Browser2) => {
 import {
   Browsers,
   DisconnectReason,
+  downloadMediaMessage,
   makeWASocket,
   proto,
   useMultiFileAuthState
@@ -1611,6 +1658,7 @@ var BaileysProvider = class {
   #events = new TypedEventEmitter();
   #logger;
   #messageStore = /* @__PURE__ */ new Map();
+  #messageCacheSize;
   #socket;
   #saveCredentials;
   #saveQueue = Promise.resolve();
@@ -1621,6 +1669,7 @@ var BaileysProvider = class {
   constructor(options) {
     this.#options = options;
     this.#logger = options.logger ?? new Logger("silent");
+    this.#messageCacheSize = Math.max(1, options.messageCacheSize ?? 1e3);
   }
   on(event, listener) {
     return this.#events.on(event, listener);
@@ -1645,7 +1694,7 @@ var BaileysProvider = class {
         markOnlineOnConnect: false,
         enableAutoSessionRecreation: true,
         enableRecentMessageCache: true,
-        getMessage: async (key) => key.id ? this.#messageStore.get(key.id) : void 0
+        getMessage: async (key) => this.#messageStore.get(this.#messageStoreKey(key))?.message ?? void 0
       });
       this.#socket = socket;
       this.#bind(socket);
@@ -1724,6 +1773,39 @@ var BaileysProvider = class {
     const result = await socket.sendMessage(chatId, this.#toContent(content), options);
     return this.#sent(result);
   }
+  async reactToMessage(key, emoji) {
+    const result = await this.#requireSocket().sendMessage(key.chatId, {
+      react: {
+        text: emoji ?? "",
+        key: this.#toWaKey(key)
+      }
+    });
+    return this.#sent(result);
+  }
+  async downloadMedia(key) {
+    const message = this.#messageStore.get(this.#messageStoreKey(key));
+    if (!message?.message) {
+      throw new WhaNextError(
+        "MEDIA_NOT_AVAILABLE",
+        "The media is unavailable. Download it from the received message event while it is cached.",
+        { recoverable: true }
+      );
+    }
+    const data = await downloadMediaMessage(message, "buffer", {}, {
+      reuploadRequest: (current) => this.#requireSocket().updateMediaMessage(current),
+      logger: createBaileysLogger(this.#logger.child("media"))
+    });
+    const media = normalizeBaileysMessage(message)?.media;
+    if (!media) {
+      throw new WhaNextError("MEDIA_NOT_AVAILABLE", "The selected message does not contain media.");
+    }
+    return {
+      data,
+      kind: media.kind,
+      ...media.mimetype ? { mimetype: media.mimetype } : {},
+      ...media.fileName ? { fileName: media.fileName } : {}
+    };
+  }
   async editMessage(key, content) {
     const result = await this.#requireSocket().sendMessage(key.chatId, {
       text: content,
@@ -1792,7 +1874,6 @@ var BaileysProvider = class {
   }
   async setPresence(chatId, state) {
     const socket = this.#requireSocket();
-    await socket.presenceSubscribe(chatId);
     const presence = state === "typing" ? "composing" : state === "recording" ? "recording" : "paused";
     await socket.sendPresenceUpdate(presence, chatId);
   }
@@ -1809,7 +1890,7 @@ var BaileysProvider = class {
     socket.ev.on("messages.upsert", ({ messages, type }) => {
       if (type !== "notify") return;
       for (const raw of messages) {
-        if (raw.key.id && raw.message) this.#remember(raw.key.id, raw.message);
+        if (raw.key.id && raw.message) this.#remember(raw);
         const message = normalizeBaileysMessage(raw);
         if (message) void this.#events.emit("message", message);
       }
@@ -1819,7 +1900,10 @@ var BaileysProvider = class {
         if (group.id) void this.#events.emit("groupChanged", { groupId: group.id });
       }
     });
-    socket.ev.on("group-participants.update", ({ id }) => {
+    socket.ev.on("group-participants.update", (update) => {
+      const change = this.#groupParticipantsChanged(update);
+      void this.#events.emit("groupParticipantsChanged", change);
+      const { id } = update;
       void this.#events.emit("groupChanged", { groupId: id });
     });
     socket.ev.on("call", (calls) => {
@@ -1919,6 +2003,9 @@ var BaileysProvider = class {
         ...content.gif !== void 0 ? { gifPlayback: content.gif } : {}
       };
     }
+    if ("sticker" in content) {
+      return { sticker: this.#media(content.sticker) };
+    }
     return {
       audio: this.#media(content.audio),
       ...content.mimetype ? { mimetype: content.mimetype } : {},
@@ -1949,7 +2036,7 @@ var BaileysProvider = class {
     if (!message?.key.id || !message.key.remoteJid) {
       throw new WhaNextError("PROVIDER_ERROR", "WhatsApp did not confirm the sent message.");
     }
-    if (message.message) this.#remember(message.key.id, message.message);
+    if (message.message) this.#remember(message);
     return {
       id: message.key.id,
       chatId: message.key.remoteJid,
@@ -1968,6 +2055,15 @@ var BaileysProvider = class {
       date: call.date ?? /* @__PURE__ */ new Date()
     };
   }
+  #groupParticipantsChanged(change) {
+    const participantIds = change.participants.map((participant) => participant.id).filter((id) => Boolean(id));
+    return {
+      groupId: change.id,
+      action: change.action,
+      participantIds,
+      ...change.author ? { authorId: change.author } : {}
+    };
+  }
   #callStatus(status) {
     const known = [
       "offer",
@@ -1979,13 +2075,19 @@ var BaileysProvider = class {
     ];
     return known.find((value) => value === status) ?? "timeout";
   }
-  #remember(id, message) {
-    this.#messageStore.set(id, message);
-    if (this.#messageStore.size > 500) {
+  #remember(message) {
+    const key = this.#messageStoreKey(message.key);
+    this.#messageStore.delete(key);
+    this.#messageStore.set(key, message);
+    while (this.#messageStore.size > this.#messageCacheSize) {
       const oldest = this.#messageStore.keys().next().value;
       if (oldest) this.#messageStore.delete(oldest);
     }
   }
+  #messageStoreKey(key) {
+    const chatId = "chatId" in key ? key.chatId : key.remoteJid;
+    return `${chatId ?? ""}:${key.id ?? ""}`;
+  }
 };
 
 // src/app/create.ts
@@ -1995,6 +2097,7 @@ async function create(options = {}) {
     auth: options.auth ?? "./session",
     browser: options.browser ?? "windows" /* Windows */,
     logger: logger.child("provider"),
+    ...options.messageCacheSize !== void 0 ? { messageCacheSize: options.messageCacheSize } : {},
     ...options.reconnect ? { reconnect: options.reconnect } : {}
   });
   return new WhaNextApp(provider, {