ruby-baileys 0.0.0-stage → 1.5.17

package/src/Utils/process-message.js

@@ -0,0 +1,689 @@
+/* Elaina Baileys maintained distribution. Upstream notices and license are preserved in LICENSE and NOTICE.md. */
+import { Boom } from '@hapi/boom';
+import { proto } from '../../WAProto/index.js';
+import { WAMessageStubType } from '../Types/index.js';
+import { getContentType, normalizeMessageContent } from '../Utils/messages.js';
+import { areJidsSameUser, isHostedLidUser, isHostedPnUser, isJidBroadcast, isJidStatusBroadcast, isLidUser, jidDecode, jidEncode, jidNormalizedUser } from '../WABinary/index.js';
+import { aesDecryptGCM, hmacSign } from './crypto.js';
+import { getKeyAuthor, toNumber } from './generics.js';
+import { downloadAndProcessHistorySyncNotification } from './history.js';
+import { buildMergedTcTokenIndexWrite, resolveTcTokenJid } from './tc-token-utils.js';
+const REAL_MSG_STUB_TYPES = new Set([
+    WAMessageStubType.CALL_MISSED_GROUP_VIDEO,
+    WAMessageStubType.CALL_MISSED_GROUP_VOICE,
+    WAMessageStubType.CALL_MISSED_VIDEO,
+    WAMessageStubType.CALL_MISSED_VOICE
+]);
+const REAL_MSG_REQ_ME_STUB_TYPES = new Set([WAMessageStubType.GROUP_PARTICIPANT_ADD]);
+async function storeTcTokensFromHistorySync(chats, signalRepository, keyStore, logger) {
+    const getLIDForPN = signalRepository.lidMapping.getLIDForPN.bind(signalRepository.lidMapping);
+    const candidates = [];
+    for (const chat of chats) {
+        const ts = chat.tcTokenTimestamp ? toNumber(chat.tcTokenTimestamp) : 0;
+        if (chat.tcToken?.length && ts > 0) {
+            const jid = jidNormalizedUser(chat.id);
+            const storageJid = await resolveTcTokenJid(jid, getLIDForPN);
+            candidates.push({
+                storageJid,
+                token: Buffer.from(chat.tcToken),
+                ts,
+                senderTs: chat.tcTokenSenderTimestamp ? toNumber(chat.tcTokenSenderTimestamp) : undefined
+            });
+        }
+    }
+    if (!candidates.length) {
+        return;
+    }
+    const jids = candidates.map(c => c.storageJid);
+    const existing = await keyStore.get('tctoken', jids);
+    const entries = {};
+    for (const c of candidates) {
+        const existingEntry = existing[c.storageJid];
+        const existingTs = existingEntry?.timestamp ? Number(existingEntry.timestamp) : 0;
+        if (existingTs > 0 && existingTs >= c.ts) {
+            continue;
+        }
+        entries[c.storageJid] = {
+            ...existingEntry,
+            token: c.token,
+            timestamp: String(c.ts),
+            ...(c.senderTs !== undefined ? { senderTimestamp: c.senderTs } : {})
+        };
+    }
+    if (Object.keys(entries).length) {
+        logger?.debug({ count: Object.keys(entries).length }, 'storing tctokens from history sync');
+        try {
+
+            const indexWrite = await buildMergedTcTokenIndexWrite(keyStore, Object.keys(entries));
+            await keyStore.set({ tctoken: { ...entries, ...indexWrite } });
+        }
+        catch (err) {
+            logger?.warn({ err }, 'failed to store tctokens from history sync');
+        }
+    }
+}
+
+export const cleanMessage = (message, meId, meLid) => {
+
+    if (isHostedPnUser(message.key.remoteJid) || isHostedLidUser(message.key.remoteJid)) {
+        message.key.remoteJid = jidEncode(jidDecode(message.key?.remoteJid)?.user, isHostedPnUser(message.key.remoteJid) ? 's.whatsapp.net' : 'lid');
+    }
+    else {
+        message.key.remoteJid = jidNormalizedUser(message.key.remoteJid);
+    }
+    if (isHostedPnUser(message.key.participant) || isHostedLidUser(message.key.participant)) {
+        message.key.participant = jidEncode(jidDecode(message.key.participant)?.user, isHostedPnUser(message.key.participant) ? 's.whatsapp.net' : 'lid');
+    }
+    else {
+        message.key.participant = jidNormalizedUser(message.key.participant);
+    }
+    const content = normalizeMessageContent(message.message);
+
+    if (content?.reactionMessage) {
+        normaliseKey(content.reactionMessage.key);
+    }
+    if (content?.pollUpdateMessage) {
+        normaliseKey(content.pollUpdateMessage.pollCreationMessageKey);
+    }
+    function normaliseKey(msgKey) {
+
+        if (!message.key.fromMe) {
+
+            msgKey.fromMe = !msgKey.fromMe
+                ? areJidsSameUser(msgKey.participant || msgKey.remoteJid, meId) ||
+                    areJidsSameUser(msgKey.participant || msgKey.remoteJid, meLid)
+                :
+
+                    false;
+
+            msgKey.remoteJid = message.key.remoteJid;
+
+            msgKey.participant = msgKey.participant || message.key.participant;
+        }
+    }
+};
+
+export const isRealMessage = (message) => {
+    const normalizedContent = normalizeMessageContent(message.message);
+    const hasSomeContent = !!getContentType(normalizedContent);
+    return ((!!normalizedContent ||
+        REAL_MSG_STUB_TYPES.has(message.messageStubType) ||
+        REAL_MSG_REQ_ME_STUB_TYPES.has(message.messageStubType)) &&
+        hasSomeContent &&
+        !normalizedContent?.protocolMessage &&
+        !normalizedContent?.reactionMessage &&
+        !normalizedContent?.pollUpdateMessage);
+};
+export const shouldIncrementChatUnread = (message) => !message.key.fromMe && !message.messageStubType;
+
+export const getChatId = ({ remoteJid, participant, fromMe }) => {
+    if (!remoteJid) {
+        throw new Boom('Cannot derive chat id: message key is missing remoteJid', {
+            data: { remoteJid, participant, fromMe }
+        });
+    }
+    if (isJidBroadcast(remoteJid) && !isJidStatusBroadcast(remoteJid) && !fromMe) {
+        if (!participant) {
+            throw new Boom('Cannot derive chat id: broadcast message key is missing participant', {
+                data: { remoteJid, fromMe }
+            });
+        }
+        return participant;
+    }
+    return remoteJid;
+};
+
+export function decryptPollVote({ encPayload, encIv }, { pollCreatorJid, pollMsgId, pollEncKey, voterJid }) {
+    const sign = Buffer.concat([
+        toBinary(pollMsgId),
+        toBinary(pollCreatorJid),
+        toBinary(voterJid),
+        toBinary('Poll Vote'),
+        new Uint8Array([1])
+    ]);
+    const key0 = hmacSign(pollEncKey, new Uint8Array(32), 'sha256');
+    const decKey = hmacSign(sign, key0, 'sha256');
+    const aad = toBinary(`${pollMsgId}\u0000${voterJid}`);
+    const decrypted = aesDecryptGCM(encPayload, decKey, encIv, aad);
+    return proto.Message.PollVoteMessage.decode(decrypted);
+    function toBinary(txt) {
+        return Buffer.from(txt);
+    }
+}
+
+export function decryptEventResponse({ encPayload, encIv }, { eventCreatorJid, eventMsgId, eventEncKey, responderJid }) {
+    const sign = Buffer.concat([
+        toBinary(eventMsgId),
+        toBinary(eventCreatorJid),
+        toBinary(responderJid),
+        toBinary('Event Response'),
+        new Uint8Array([1])
+    ]);
+    const key0 = hmacSign(eventEncKey, new Uint8Array(32), 'sha256');
+    const decKey = hmacSign(sign, key0, 'sha256');
+    const aad = toBinary(`${eventMsgId}\u0000${responderJid}`);
+    const decrypted = aesDecryptGCM(encPayload, decKey, encIv, aad);
+    return proto.Message.EventResponseMessage.decode(decrypted);
+    function toBinary(txt) {
+        return Buffer.from(txt);
+    }
+}
+export function decryptMessageEdit({ encPayload, encIv }, { originalSenderJid, originalMsgId, editEncKey, editorJid }) {
+    const sign = Buffer.concat([
+        toBinary(originalMsgId),
+        toBinary(originalSenderJid),
+        toBinary(editorJid),
+        toBinary('Message Edit'),
+        new Uint8Array([1])
+    ]);
+    const key0 = hmacSign(editEncKey, new Uint8Array(32), 'sha256');
+    const decKey = hmacSign(sign, key0, 'sha256');
+    const aad = Buffer.alloc(0);
+    const decrypted = aesDecryptGCM(encPayload, decKey, encIv, aad);
+    return proto.Message.decode(decrypted);
+    function toBinary(txt) {
+        return Buffer.from(txt);
+    }
+}
+const resolveMessageEditAuthor = async (key, meId, lidMapping) => {
+    if (!key) {
+        return '';
+    }
+    const rawJid = key.fromMe
+        ? key.participantAlt || key.participant || meId
+        : key.participantAlt || key.participant || key.remoteJidAlt || key.remoteJid;
+    const normalized = jidNormalizedUser(rawJid);
+    if (!normalized) {
+        return '';
+    }
+    if (!isLidUser(normalized)) {
+        return normalized;
+    }
+    const pn = await lidMapping.getPNForLID(normalized);
+    return jidNormalizedUser(pn);
+};
+const buildEditUpdate = (args) => {
+    const editedInner = decryptMessageEdit({ encPayload: args.encPayload, encIv: args.encIv }, {
+        editEncKey: args.editEncKey,
+        originalSenderJid: args.originalSenderJid,
+        originalMsgId: args.originalMsgId,
+        editorJid: args.editorJid
+    });
+    const editProtocol = editedInner.protocolMessage;
+    const innerEdited = editProtocol?.editedMessage;
+    if (!innerEdited) {
+        args.logger?.warn({ targetKey: args.targetKey }, 'decrypted MESSAGE_EDIT plaintext had no protocolMessage.editedMessage — skipping update');
+        return null;
+    }
+    return {
+        key: { ...args.targetKey },
+        update: {
+            message: {
+                editedMessage: {
+                    message: innerEdited
+                }
+            },
+            messageTimestamp: editProtocol?.timestampMs
+                ? Math.floor(toNumber(editProtocol.timestampMs) / 1000)
+                : args.fallbackTimestamp
+        }
+    };
+};
+const processMessage = async (message, { shouldProcessHistoryMsg, placeholderResendCache, ev, creds, signalRepository, keyStore, logger, options, getMessage }) => {
+    const meId = creds.me.id;
+    const { accountSettings } = creds;
+    const chat = { id: jidNormalizedUser(getChatId(message.key)) };
+    const isRealMsg = isRealMessage(message);
+    if (isRealMsg) {
+        chat.messages = [{ message }];
+        chat.conversationTimestamp = toNumber(message.messageTimestamp);
+
+        if (shouldIncrementChatUnread(message)) {
+            chat.unreadCount = (chat.unreadCount || 0) + 1;
+        }
+    }
+    const content = normalizeMessageContent(message.message);
+
+    if ((isRealMsg || content?.reactionMessage?.key?.fromMe) && accountSettings?.unarchiveChats) {
+        chat.archived = false;
+        chat.readOnly = false;
+    }
+    const protocolMsg = content?.protocolMessage;
+    if (protocolMsg) {
+
+        const SELF_ONLY_TYPES = new Set([
+            proto.Message.ProtocolMessage.Type.HISTORY_SYNC_NOTIFICATION,
+            proto.Message.ProtocolMessage.Type.APP_STATE_SYNC_KEY_SHARE,
+            proto.Message.ProtocolMessage.Type.LID_MIGRATION_MAPPING_SYNC,
+            proto.Message.ProtocolMessage.Type.PEER_DATA_OPERATION_REQUEST_RESPONSE_MESSAGE
+        ]);
+        if (protocolMsg.type !== null &&
+            protocolMsg.type !== undefined &&
+            SELF_ONLY_TYPES.has(protocolMsg.type) &&
+            !message.key.fromMe) {
+            logger?.warn({ msgId: message.key.id, type: protocolMsg.type, from: message.key.participant || message.key.remoteJid }, 'dropping spoofed self-only protocolMessage from non-self origin');
+            return;
+        }
+        switch (protocolMsg.type) {
+            case proto.Message.ProtocolMessage.Type.HISTORY_SYNC_NOTIFICATION:
+                const histNotification = protocolMsg.historySyncNotification;
+                const process = shouldProcessHistoryMsg;
+                const isLatest = !creds.processedHistoryMessages?.length;
+                logger?.info({
+                    histNotification,
+                    process,
+                    id: message.key.id,
+                    isLatest
+                }, 'got history notification');
+                if (process) {
+
+                    if (histNotification.syncType !== proto.HistorySync.HistorySyncType.ON_DEMAND) {
+                        ev.emit('creds.update', {
+                            processedHistoryMessages: [
+                                ...(creds.processedHistoryMessages || []),
+                                { key: message.key, messageTimestamp: message.messageTimestamp }
+                            ]
+                        });
+                    }
+                    const data = await downloadAndProcessHistorySyncNotification(histNotification, options, logger);
+                    if (data.lidPnMappings?.length) {
+                        logger?.debug({ count: data.lidPnMappings.length }, 'processing LID-PN mappings from history sync');
+                        await signalRepository.lidMapping
+                            .storeLIDPNMappings(data.lidPnMappings)
+                            .catch(err => logger?.warn({ err }, 'failed to store LID-PN mappings from history sync'));
+                    }
+                    await storeTcTokensFromHistorySync(data.chats, signalRepository, keyStore, logger);
+                    ev.emit('messaging-history.set', {
+                        ...data,
+                        isLatest: histNotification.syncType !== proto.HistorySync.HistorySyncType.ON_DEMAND ? isLatest : undefined,
+                        chunkOrder: histNotification.chunkOrder,
+                        peerDataRequestSessionId: histNotification.peerDataRequestSessionId
+                    });
+                }
+                break;
+            case proto.Message.ProtocolMessage.Type.APP_STATE_SYNC_KEY_SHARE:
+                const keys = protocolMsg.appStateSyncKeyShare.keys;
+                if (keys?.length) {
+                    let newAppStateSyncKeyId = '';
+                    await keyStore.transaction(async () => {
+                        const newKeys = [];
+                        for (const { keyData, keyId } of keys) {
+                            const strKeyId = Buffer.from(keyId.keyId).toString('base64');
+                            newKeys.push(strKeyId);
+                            await keyStore.set({ 'app-state-sync-key': { [strKeyId]: keyData } });
+                            newAppStateSyncKeyId = strKeyId;
+                        }
+                        logger?.info({ newAppStateSyncKeyId, newKeys }, 'injecting new app state sync keys');
+                    }, meId);
+                    ev.emit('creds.update', { myAppStateKeyId: newAppStateSyncKeyId });
+                }
+                else {
+                    logger?.info({ protocolMsg }, 'recv app state sync with 0 keys');
+                }
+                break;
+            case proto.Message.ProtocolMessage.Type.REVOKE:
+                ev.emit('messages.update', [
+                    {
+                        key: {
+                            ...message.key,
+                            id: protocolMsg.key.id
+                        },
+                        update: { message: null, messageStubType: WAMessageStubType.REVOKE, key: message.key }
+                    }
+                ]);
+                break;
+            case proto.Message.ProtocolMessage.Type.EPHEMERAL_SETTING:
+                Object.assign(chat, {
+                    ephemeralSettingTimestamp: toNumber(message.messageTimestamp),
+                    ephemeralExpiration: protocolMsg.ephemeralExpiration || null
+                });
+                break;
+            case proto.Message.ProtocolMessage.Type.PEER_DATA_OPERATION_REQUEST_RESPONSE_MESSAGE:
+                const response = protocolMsg.peerDataOperationRequestResponseMessage;
+                if (response) {
+
+                    const peerDataOperationResult = response.peerDataOperationResult || [];
+                    for (const result of peerDataOperationResult) {
+                        const retryResponse = result?.placeholderMessageResendResponse;
+
+                        if (!retryResponse?.webMessageInfoBytes) {
+                            continue;
+                        }
+
+                        try {
+                            const webMessageInfo = proto.WebMessageInfo.decode(retryResponse.webMessageInfoBytes);
+                            const msgId = webMessageInfo.key?.id;
+
+                            const cachedData = msgId ? await placeholderResendCache?.get(msgId) : undefined;
+
+                            if (msgId) {
+                                await placeholderResendCache?.del(msgId);
+                            }
+                            let finalMsg;
+
+                            if (cachedData && typeof cachedData === 'object') {
+
+                                cachedData.message = webMessageInfo.message;
+
+                                if (webMessageInfo.messageTimestamp) {
+                                    cachedData.messageTimestamp = webMessageInfo.messageTimestamp;
+                                }
+                                finalMsg = cachedData;
+                            }
+                            else {
+                                finalMsg = webMessageInfo;
+                            }
+                            logger?.debug({ msgId, requestId: response.stanzaId }, 'received placeholder resend');
+                            ev.emit('messages.upsert', {
+                                messages: [finalMsg],
+                                type: 'notify',
+                                requestId: response.stanzaId
+                            });
+                        }
+                        catch (err) {
+                            logger?.warn({ err, stanzaId: response.stanzaId }, 'failed to decode placeholder resend response');
+                        }
+                    }
+                }
+                break;
+            case proto.Message.ProtocolMessage.Type.MESSAGE_EDIT:
+                ev.emit('messages.update', [
+                    {
+
+                        key: { ...message.key, id: protocolMsg.key?.id },
+                        update: {
+                            message: {
+                                editedMessage: {
+                                    message: protocolMsg.editedMessage
+                                }
+                            },
+                            messageTimestamp: protocolMsg.timestampMs
+                                ? Math.floor(toNumber(protocolMsg.timestampMs) / 1000)
+                                : message.messageTimestamp
+                        }
+                    }
+                ]);
+                break;
+            case proto.Message.ProtocolMessage.Type.GROUP_MEMBER_LABEL_CHANGE:
+                const labelAssociationMsg = protocolMsg.memberLabel;
+                if (labelAssociationMsg?.label) {
+                    ev.emit('group.member-tag.update', {
+                        groupId: chat.id,
+                        label: labelAssociationMsg.label,
+                        participant: message.key.participant,
+                        participantAlt: message.key.participantAlt,
+                        messageTimestamp: Number(message.messageTimestamp)
+                    });
+                }
+                break;
+            case proto.Message.ProtocolMessage.Type.LID_MIGRATION_MAPPING_SYNC:
+                const encodedPayload = protocolMsg.lidMigrationMappingSyncMessage?.encodedMappingPayload;
+                const { pnToLidMappings, chatDbMigrationTimestamp } = proto.LIDMigrationMappingSyncPayload.decode(encodedPayload);
+                logger?.debug({ pnToLidMappings, chatDbMigrationTimestamp }, 'got lid mappings and chat db migration timestamp');
+                const pairs = [];
+                for (const { pn, latestLid, assignedLid } of pnToLidMappings) {
+                    const lid = latestLid || assignedLid;
+                    pairs.push({ lid: `${lid}@lid`, pn: `${pn}@s.whatsapp.net` });
+                }
+                await signalRepository.lidMapping.storeLIDPNMappings(pairs);
+                if (pairs.length) {
+                    for (const { pn, lid } of pairs) {
+                        await signalRepository.migrateSession(pn, lid);
+                    }
+                }
+        }
+    }
+    else if (content?.reactionMessage) {
+        const reaction = {
+            ...content.reactionMessage,
+            key: message.key
+        };
+        ev.emit('messages.reaction', [
+            {
+                reaction,
+                key: content.reactionMessage?.key
+            }
+        ]);
+    }
+    else if (content?.encEventResponseMessage) {
+        const encEventResponse = content.encEventResponseMessage;
+        const creationMsgKey = encEventResponse.eventCreationMessageKey;
+
+        const eventMsg = await getMessage(creationMsgKey);
+        if (eventMsg) {
+            try {
+                const meIdNormalised = jidNormalizedUser(meId);
+
+                const eventCreatorKey = creationMsgKey.participant || creationMsgKey.remoteJid;
+                const eventCreatorPn = isLidUser(eventCreatorKey)
+                    ? await signalRepository.lidMapping.getPNForLID(eventCreatorKey)
+                    : eventCreatorKey;
+                const eventCreatorJid = getKeyAuthor({ remoteJid: jidNormalizedUser(eventCreatorPn), fromMe: meIdNormalised === eventCreatorPn }, meIdNormalised);
+                const responderJid = getKeyAuthor(message.key, meIdNormalised);
+                const eventEncKey = eventMsg?.messageContextInfo?.messageSecret;
+                if (!eventEncKey) {
+                    logger?.warn({ creationMsgKey }, 'event response: missing messageSecret for decryption');
+                }
+                else {
+                    const responseMsg = decryptEventResponse(encEventResponse, {
+                        eventEncKey,
+                        eventCreatorJid,
+                        eventMsgId: creationMsgKey.id,
+                        responderJid
+                    });
+                    const eventResponse = {
+                        eventResponseMessageKey: message.key,
+                        senderTimestampMs: responseMsg.timestampMs,
+                        response: responseMsg
+                    };
+                    ev.emit('messages.update', [
+                        {
+                            key: creationMsgKey,
+                            update: {
+                                eventResponses: [eventResponse]
+                            }
+                        }
+                    ]);
+                }
+            }
+            catch (err) {
+                logger?.warn({ err, creationMsgKey }, 'failed to decrypt event response');
+            }
+        }
+        else {
+            logger?.warn({ creationMsgKey }, 'event creation message not found, cannot decrypt response');
+        }
+    }
+    else if (content?.secretEncryptedMessage &&
+        content.secretEncryptedMessage.secretEncType === proto.Message.SecretEncryptedMessage.SecretEncType.MESSAGE_EDIT) {
+        const secEnc = content.secretEncryptedMessage;
+        const targetKey = secEnc.targetMessageKey;
+        const targetId = typeof targetKey?.id === 'string' ? targetKey.id.trim() : '';
+        const targetRemoteJid = targetKey?.remoteJid || targetKey?.remoteJidAlt;
+        if (!targetKey || !targetId || !targetRemoteJid) {
+            logger?.warn({ targetKey }, 'message edit: incomplete targetMessageKey — cannot decrypt');
+            return;
+        }
+        const lookupTargetKey = {
+            ...targetKey,
+            remoteJid: targetKey.remoteJid || targetKey.remoteJidAlt,
+            participant: targetKey.participant || targetKey.participantAlt
+        };
+        const targetMsg = await getMessage(lookupTargetKey);
+        if (!targetMsg) {
+            logger?.warn({ targetKey }, 'original message not found in store, cannot decrypt secretEncryptedMessage edit');
+            return;
+        }
+        try {
+            const meIdNormalised = jidNormalizedUser(meId);
+            const editEncKey = targetMsg?.messageContextInfo?.messageSecret;
+            if (!editEncKey?.length) {
+                logger?.warn({ targetKey }, 'message edit: missing messageSecret on original message — cannot decrypt');
+                return;
+            }
+            const originalSenderJid = await resolveMessageEditAuthor(targetKey, meIdNormalised, signalRepository.lidMapping);
+            if (!originalSenderJid) {
+                logger?.warn({ targetKey }, 'message edit: original sender JID unavailable — cannot decrypt');
+                return;
+            }
+            const editorJid = await resolveMessageEditAuthor(message.key, meIdNormalised, signalRepository.lidMapping);
+            if (!editorJid) {
+                logger?.warn({ key: message.key, targetKey }, 'message edit: editor JID unavailable — cannot decrypt');
+                return;
+            }
+            if (!secEnc.encPayload?.length || !secEnc.encIv?.length) {
+                logger?.warn({ targetKey }, 'message edit: encrypted payload or IV missing — cannot decrypt');
+                return;
+            }
+            const update = buildEditUpdate({
+                editEncKey,
+                encPayload: secEnc.encPayload,
+                encIv: secEnc.encIv,
+                originalSenderJid,
+                originalMsgId: targetId,
+                editorJid,
+                targetKey,
+                fallbackTimestamp: toNumber(message.messageTimestamp),
+                logger
+            });
+            if (update) {
+                ev.emit('messages.update', [update]);
+            }
+        }
+        catch (err) {
+            logger?.warn({ err, targetKey }, 'failed to decrypt secretEncryptedMessage MESSAGE_EDIT');
+        }
+    }
+    else if (message.messageStubType) {
+        const jid = message.key?.remoteJid;
+
+        let participants;
+        const emitParticipantsUpdate = (action) => ev.emit('group-participants.update', {
+            id: jid,
+            author: message.key.participant,
+            authorPn: message.key.participantAlt,
+            authorUsername: message.key.participantUsername,
+            participants,
+            action
+        });
+        const emitGroupUpdate = (update) => {
+            ev.emit('groups.update', [
+                {
+                    id: jid,
+                    ...update,
+                    author: message.key.participant ?? undefined,
+                    authorPn: message.key.participantAlt,
+                    authorUsername: message.key.participantUsername
+                }
+            ]);
+        };
+        const emitGroupRequestJoin = (participant, action, method) => {
+            ev.emit('group.join-request', {
+                id: jid,
+                author: message.key.participant,
+                authorPn: message.key.participantAlt,
+                authorUsername: message.key.participantUsername,
+                participant: participant.lid,
+                participantPn: participant.pn,
+                action,
+                method: method
+            });
+        };
+        const participantsIncludesMe = () => participants.find(jid => areJidsSameUser(meId, jid.phoneNumber));
+        const readStubJson = (index) => {
+            const raw = message.messageStubParameters?.[index];
+            if (typeof raw !== 'string') {
+                return undefined;
+            }
+            try {
+                return JSON.parse(raw);
+            }
+            catch (error) {
+                logger?.warn?.({ jid, stubType: message.messageStubType, raw }, 'group stub parameter is not JSON, skipping it');
+                return undefined;
+            }
+        };
+        const readStubParticipants = () => {
+            const raw = message.messageStubParameters;
+            if (!Array.isArray(raw)) {
+                logger?.warn?.({ jid, stubType: message.messageStubType }, 'group stub carries no parameters, treating it as an empty participant list');
+                return [];
+            }
+            return raw.map((_, index) => readStubJson(index)).filter(entry => entry !== undefined);
+        };
+        switch (message.messageStubType) {
+            case WAMessageStubType.GROUP_PARTICIPANT_CHANGE_NUMBER:
+                participants = readStubParticipants();
+                emitParticipantsUpdate('modify');
+                break;
+            case WAMessageStubType.GROUP_PARTICIPANT_LEAVE:
+            case WAMessageStubType.GROUP_PARTICIPANT_REMOVE:
+                participants = readStubParticipants();
+                emitParticipantsUpdate('remove');
+
+                if (participantsIncludesMe()) {
+                    chat.readOnly = true;
+                }
+                break;
+            case WAMessageStubType.GROUP_PARTICIPANT_ADD:
+            case WAMessageStubType.GROUP_PARTICIPANT_INVITE:
+            case WAMessageStubType.GROUP_PARTICIPANT_ADD_REQUEST_JOIN:
+                participants = readStubParticipants();
+                if (participantsIncludesMe()) {
+                    chat.readOnly = false;
+                }
+                emitParticipantsUpdate('add');
+                break;
+            case WAMessageStubType.GROUP_PARTICIPANT_DEMOTE:
+                participants = readStubParticipants();
+                emitParticipantsUpdate('demote');
+                break;
+            case WAMessageStubType.GROUP_PARTICIPANT_PROMOTE:
+                participants = readStubParticipants();
+                emitParticipantsUpdate('promote');
+                break;
+            case WAMessageStubType.GROUP_CHANGE_ANNOUNCE:
+                const announceValue = message.messageStubParameters?.[0];
+                emitGroupUpdate({ announce: announceValue === 'true' || announceValue === 'on' });
+                break;
+            case WAMessageStubType.GROUP_CHANGE_RESTRICT:
+                const restrictValue = message.messageStubParameters?.[0];
+                emitGroupUpdate({ restrict: restrictValue === 'true' || restrictValue === 'on' });
+                break;
+            case WAMessageStubType.GROUP_CHANGE_SUBJECT:
+                const name = message.messageStubParameters?.[0];
+                chat.name = name;
+                emitGroupUpdate({ subject: name });
+                break;
+            case WAMessageStubType.GROUP_CHANGE_DESCRIPTION:
+                const description = message.messageStubParameters?.[0];
+                chat.description = description;
+                emitGroupUpdate({ desc: description });
+                break;
+            case WAMessageStubType.GROUP_CHANGE_INVITE_LINK:
+                const code = message.messageStubParameters?.[0];
+                emitGroupUpdate({ inviteCode: code });
+                break;
+            case WAMessageStubType.GROUP_MEMBER_ADD_MODE:
+                const memberAddValue = message.messageStubParameters?.[0];
+                emitGroupUpdate({ memberAddMode: memberAddValue === 'all_member_add' });
+                break;
+            case WAMessageStubType.GROUP_MEMBERSHIP_JOIN_APPROVAL_MODE:
+                const approvalMode = message.messageStubParameters?.[0];
+                emitGroupUpdate({ joinApprovalMode: approvalMode === 'on' });
+                break;
+            case WAMessageStubType.GROUP_MEMBERSHIP_JOIN_APPROVAL_REQUEST_NON_ADMIN_ADD:
+                const participant = readStubJson(0);
+                const action = message.messageStubParameters?.[1];
+                const method = message.messageStubParameters?.[2];
+                if (participant) {
+                    emitGroupRequestJoin(participant, action, method);
+                }
+                break;
+        }
+    }
+    if (Object.keys(chat).length > 1) {
+        ev.emit('chats.update', [chat]);
+    }
+};
+export default processMessage;