@aseppxyzz12/baileys 1.1.8

package/lib/Utils/chat-utils.js

@@ -0,0 +1,904 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const { Boom: Boom } = require("@hapi/boom");
+const { proto: proto } = require("../../WAProto");
+const { LabelAssociationType: LabelAssociationType } = require("../Types/LabelAssociation");
+const {
+    getBinaryNodeChild: getBinaryNodeChild,
+    getBinaryNodeChildren: getBinaryNodeChildren,
+    isJidGroup: isJidGroup,
+    jidNormalizedUser: jidNormalizedUser,
+    isLidUser: isLidUser,
+    isPnUser: isPnUser,
+} = require("../WABinary");
+const {
+    hkdf: hkdf,
+    hmacSign: hmacSign,
+    aesEncrypt: aesEncrypt,
+    aesDecrypt: aesDecrypt,
+} = require("./crypto");
+const { toNumber: toNumber } = require("./generics");
+const { LT_HASH_ANTI_TAMPERING: LT_HASH_ANTI_TAMPERING } = require("./lt-hash");
+const { downloadContentFromMessage: downloadContentFromMessage } = require("./messages-media");
+const mutationKeys = async (keydata) => {
+    const expanded = await hkdf(keydata, 160, { info: "WhatsApp Mutation Keys" });
+    return {
+        indexKey: expanded.slice(0, 32),
+        valueEncryptionKey: expanded.slice(32, 64),
+        valueMacKey: expanded.slice(64, 96),
+        snapshotMacKey: expanded.slice(96, 128),
+        patchMacKey: expanded.slice(128, 160),
+    };
+};
+const generateMac = (operation, data, keyId, key) => {
+    const getKeyData = () => {
+        let r;
+        switch (operation) {
+            case proto.SyncdMutation.SyncdOperation.SET:
+                r = 1;
+                break;
+            case proto.SyncdMutation.SyncdOperation.REMOVE:
+                r = 2;
+                break;
+        }
+        const buff = Buffer.from([r]);
+        return Buffer.concat([buff, Buffer.from(keyId, "base64")]);
+    };
+    const keyData = getKeyData();
+    const last = Buffer.alloc(8);
+    last.set([keyData.length], last.length - 1);
+    const total = Buffer.concat([keyData, data, last]);
+    const hmac = hmacSign(total, key, "sha512");
+    return hmac.slice(0, 32);
+};
+const to64BitNetworkOrder = (e) => {
+    const buff = Buffer.alloc(8);
+    buff.writeUint32BE(e, 4);
+    return buff;
+};
+const makeLtHashGenerator = ({ indexValueMap: indexValueMap, hash: hash }) => {
+    indexValueMap = { ...indexValueMap };
+    const addBuffs = [];
+    const subBuffs = [];
+    return {
+        mix: ({ indexMac: indexMac, valueMac: valueMac, operation: operation }) => {
+            const indexMacBase64 = Buffer.from(indexMac).toString("base64");
+            const prevOp = indexValueMap[indexMacBase64];
+            if (operation === proto.SyncdMutation.SyncdOperation.REMOVE) {
+                if (!prevOp) {
+                    throw new Boom("tried remove, but no previous op", {
+                        data: { indexMac: indexMac, valueMac: valueMac },
+                    });
+                }
+                delete indexValueMap[indexMacBase64];
+            } else {
+                addBuffs.push(new Uint8Array(valueMac).buffer);
+                indexValueMap[indexMacBase64] = { valueMac: valueMac };
+            }
+            if (prevOp) {
+                subBuffs.push(new Uint8Array(prevOp.valueMac).buffer);
+            }
+        },
+        finish: async () => {
+            const hashArrayBuffer = new Uint8Array(hash).buffer;
+            const result = await LT_HASH_ANTI_TAMPERING.subtractThenAdd(
+                hashArrayBuffer,
+                addBuffs,
+                subBuffs
+            );
+            const buffer = Buffer.from(result);
+            return { hash: buffer, indexValueMap: indexValueMap };
+        },
+    };
+};
+const generateSnapshotMac = (lthash, version, name, key) => {
+    const total = Buffer.concat([lthash, to64BitNetworkOrder(version), Buffer.from(name, "utf-8")]);
+    return hmacSign(total, key, "sha256");
+};
+const generatePatchMac = (snapshotMac, valueMacs, version, type, key) => {
+    const total = Buffer.concat([
+        snapshotMac,
+        ...valueMacs,
+        to64BitNetworkOrder(version),
+        Buffer.from(type, "utf-8"),
+    ]);
+    return hmacSign(total, key);
+};
+const newLTHashState = () => ({
+    version: 0,
+    hash: Buffer.alloc(128),
+    indexValueMap: {},
+});
+const encodeSyncdPatch = async (
+    {
+        type: type,
+        index: index,
+        syncAction: syncAction,
+        apiVersion: apiVersion,
+        operation: operation,
+    },
+    myAppStateKeyId,
+    state,
+    getAppStateSyncKey
+) => {
+    const key = !!myAppStateKeyId ? await getAppStateSyncKey(myAppStateKeyId) : undefined;
+    if (!key) {
+        throw new Boom(`myAppStateKey ("${myAppStateKeyId}") not present`, {
+            statusCode: 404,
+        });
+    }
+    const encKeyId = Buffer.from(myAppStateKeyId, "base64");
+    state = { ...state, indexValueMap: { ...state.indexValueMap } };
+    const indexBuffer = Buffer.from(JSON.stringify(index));
+    const dataProto = proto.SyncActionData.fromObject({
+        index: indexBuffer,
+        value: syncAction,
+        padding: new Uint8Array(0),
+        version: apiVersion,
+    });
+    const encoded = proto.SyncActionData.encode(dataProto).finish();
+    const keyValue = await mutationKeys(key.keyData);
+    const encValue = aesEncrypt(encoded, keyValue.valueEncryptionKey);
+    const valueMac = generateMac(operation, encValue, encKeyId, keyValue.valueMacKey);
+    const indexMac = hmacSign(indexBuffer, keyValue.indexKey);
+    const generator = makeLtHashGenerator(state);
+    generator.mix({
+        indexMac: indexMac,
+        valueMac: valueMac,
+        operation: operation,
+    });
+    Object.assign(state, await generator.finish());
+    state.version += 1;
+    const snapshotMac = generateSnapshotMac(
+        state.hash,
+        state.version,
+        type,
+        keyValue.snapshotMacKey
+    );
+    const patch = {
+        patchMac: generatePatchMac(
+            snapshotMac,
+            [valueMac],
+            state.version,
+            type,
+            keyValue.patchMacKey
+        ),
+        snapshotMac: snapshotMac,
+        keyId: { id: encKeyId },
+        mutations: [
+            {
+                operation: operation,
+                record: {
+                    index: { blob: indexMac },
+                    value: { blob: Buffer.concat([encValue, valueMac]) },
+                    keyId: { id: encKeyId },
+                },
+            },
+        ],
+    };
+    const base64Index = indexMac.toString("base64");
+    state.indexValueMap[base64Index] = { valueMac: valueMac };
+    return { patch: patch, state: state };
+};
+const decodeSyncdMutations = async (
+    msgMutations,
+    initialState,
+    getAppStateSyncKey,
+    onMutation,
+    validateMacs
+) => {
+    const ltGenerator = makeLtHashGenerator(initialState);
+    for (const msgMutation of msgMutations) {
+        const operation =
+            "operation" in msgMutation
+                ? msgMutation.operation
+                : proto.SyncdMutation.SyncdOperation.SET;
+        const record =
+            "record" in msgMutation && !!msgMutation.record ? msgMutation.record : msgMutation;
+        const key = await getKey(record.keyId.id);
+        const content = Buffer.from(record.value.blob);
+        const encContent = content.slice(0, -32);
+        const ogValueMac = content.slice(-32);
+        if (validateMacs) {
+            const contentHmac = generateMac(
+                operation,
+                encContent,
+                record.keyId.id,
+                key.valueMacKey
+            );
+            if (Buffer.compare(contentHmac, ogValueMac) !== 0) {
+                throw new Boom("HMAC content verification failed");
+            }
+        }
+        const result = aesDecrypt(encContent, key.valueEncryptionKey);
+        const syncAction = proto.SyncActionData.decode(result);
+        if (validateMacs) {
+            const hmac = hmacSign(syncAction.index, key.indexKey);
+            if (Buffer.compare(hmac, record.index.blob) !== 0) {
+                throw new Boom("HMAC index verification failed");
+            }
+        }
+        const indexStr = Buffer.from(syncAction.index).toString();
+        onMutation({ syncAction: syncAction, index: JSON.parse(indexStr) });
+        ltGenerator.mix({
+            indexMac: record.index.blob,
+            valueMac: ogValueMac,
+            operation: operation,
+        });
+    }
+    return await ltGenerator.finish();
+    async function getKey(keyId) {
+        const base64Key = Buffer.from(keyId).toString("base64");
+        const keyEnc = await getAppStateSyncKey(base64Key);
+        if (!keyEnc) {
+            throw new Boom(`failed to find key "${base64Key}" to decode mutation`, {
+                statusCode: 404,
+                data: { msgMutations: msgMutations },
+            });
+        }
+        return mutationKeys(keyEnc.keyData);
+    }
+};
+const decodeSyncdPatch = async (
+    msg,
+    name,
+    initialState,
+    getAppStateSyncKey,
+    onMutation,
+    validateMacs
+) => {
+    if (validateMacs) {
+        const base64Key = Buffer.from(msg.keyId.id).toString("base64");
+        const mainKeyObj = await getAppStateSyncKey(base64Key);
+        if (!mainKeyObj) {
+            throw new Boom(`failed to find key "${base64Key}" to decode patch`, {
+                statusCode: 404,
+                data: { msg: msg },
+            });
+        }
+        const mainKey = await mutationKeys(mainKeyObj.keyData);
+        const mutationmacs = msg.mutations.map((mutation) => mutation.record.value.blob.slice(-32));
+        const patchMac = generatePatchMac(
+            msg.snapshotMac,
+            mutationmacs,
+            toNumber(msg.version.version),
+            name,
+            mainKey.patchMacKey
+        );
+        if (Buffer.compare(patchMac, msg.patchMac) !== 0) {
+            throw new Boom("Invalid patch mac");
+        }
+    }
+    const result = await decodeSyncdMutations(
+        msg.mutations,
+        initialState,
+        getAppStateSyncKey,
+        onMutation,
+        validateMacs
+    );
+    return result;
+};
+const extractSyncdPatches = async (result, options) => {
+    const syncNode = getBinaryNodeChild(result, "sync");
+    const collectionNodes = getBinaryNodeChildren(syncNode, "collection");
+    const final = {};
+    await Promise.all(
+        collectionNodes.map(async (collectionNode) => {
+            const patchesNode = getBinaryNodeChild(collectionNode, "patches");
+            const patches = getBinaryNodeChildren(patchesNode || collectionNode, "patch");
+            const snapshotNode = getBinaryNodeChild(collectionNode, "snapshot");
+            const syncds = [];
+            const name = collectionNode.attrs.name;
+            const hasMorePatches = collectionNode.attrs.has_more_patches === "true";
+            let snapshot = undefined;
+            if (snapshotNode && !!snapshotNode.content) {
+                if (!Buffer.isBuffer(snapshotNode)) {
+                    snapshotNode.content = Buffer.from(Object.values(snapshotNode.content));
+                }
+                const blobRef = proto.ExternalBlobReference.decode(snapshotNode.content);
+                const data = await downloadExternalBlob(blobRef, options);
+                snapshot = proto.SyncdSnapshot.decode(data);
+            }
+            for (let { content: content } of patches) {
+                if (content) {
+                    if (!Buffer.isBuffer(content)) {
+                        content = Buffer.from(Object.values(content));
+                    }
+                    const syncd = proto.SyncdPatch.decode(content);
+                    if (!syncd.version) {
+                        syncd.version = { version: +collectionNode.attrs.version + 1 };
+                    }
+                    syncds.push(syncd);
+                }
+            }
+            final[name] = {
+                patches: syncds,
+                hasMorePatches: hasMorePatches,
+                snapshot: snapshot,
+            };
+        })
+    );
+    return final;
+};
+const downloadExternalBlob = async (blob, options) => {
+    const stream = await downloadContentFromMessage(blob, "md-app-state", {
+        options: options,
+    });
+    const bufferArray = [];
+    for await (const chunk of stream) {
+        bufferArray.push(chunk);
+    }
+    return Buffer.concat(bufferArray);
+};
+const downloadExternalPatch = async (blob, options) => {
+    const buffer = await downloadExternalBlob(blob, options);
+    const syncData = proto.SyncdMutations.decode(buffer);
+    return syncData;
+};
+const decodeSyncdSnapshot = async (
+    name,
+    snapshot,
+    getAppStateSyncKey,
+    minimumVersionNumber,
+    validateMacs = true
+) => {
+    const newState = newLTHashState();
+    newState.version = toNumber(snapshot.version.version);
+    const mutationMap = {};
+    const areMutationsRequired =
+        typeof minimumVersionNumber === "undefined" || newState.version > minimumVersionNumber;
+    const { hash: hash, indexValueMap: indexValueMap } = await decodeSyncdMutations(
+        snapshot.records,
+        newState,
+        getAppStateSyncKey,
+        areMutationsRequired
+            ? (mutation) => {
+                  const index = mutation.syncAction.index?.toString();
+                  mutationMap[index] = mutation;
+              }
+            : () => {},
+        validateMacs
+    );
+    newState.hash = hash;
+    newState.indexValueMap = indexValueMap;
+    if (validateMacs) {
+        const base64Key = Buffer.from(snapshot.keyId.id).toString("base64");
+        const keyEnc = await getAppStateSyncKey(base64Key);
+        if (!keyEnc) {
+            throw new Boom(`failed to find key "${base64Key}" to decode mutation`);
+        }
+        const result = await mutationKeys(keyEnc.keyData);
+        const computedSnapshotMac = generateSnapshotMac(
+            newState.hash,
+            newState.version,
+            name,
+            result.snapshotMacKey
+        );
+        if (Buffer.compare(snapshot.mac, computedSnapshotMac) !== 0) {
+            throw new Boom(
+                `failed to verify LTHash at ${newState.version} of ${name} from snapshot`
+            );
+        }
+    }
+    return { state: newState, mutationMap: mutationMap };
+};
+const decodePatches = async (
+    name,
+    syncds,
+    initial,
+    getAppStateSyncKey,
+    options,
+    minimumVersionNumber,
+    logger,
+    validateMacs = true
+) => {
+    const newState = { ...initial, indexValueMap: { ...initial.indexValueMap } };
+    const mutationMap = {};
+    for (const syncd of syncds) {
+        const { version: version, keyId: keyId, snapshotMac: snapshotMac } = syncd;
+        if (syncd.externalMutations) {
+            logger?.trace({ name: name, version: version }, "downloading external patch");
+            const ref = await downloadExternalPatch(syncd.externalMutations, options);
+            logger?.debug(
+                { name: name, version: version, mutations: ref.mutations.length },
+                "downloaded external patch"
+            );
+            syncd.mutations?.push(...ref.mutations);
+        }
+        const patchVersion = toNumber(version.version);
+        newState.version = patchVersion;
+        const shouldMutate =
+            typeof minimumVersionNumber === "undefined" || patchVersion > minimumVersionNumber;
+        const decodeResult = await decodeSyncdPatch(
+            syncd,
+            name,
+            newState,
+            getAppStateSyncKey,
+            shouldMutate
+                ? (mutation) => {
+                      const index = mutation.syncAction.index?.toString();
+                      mutationMap[index] = mutation;
+                  }
+                : () => {},
+            true
+        );
+        newState.hash = decodeResult.hash;
+        newState.indexValueMap = decodeResult.indexValueMap;
+        if (validateMacs) {
+            const base64Key = Buffer.from(keyId.id).toString("base64");
+            const keyEnc = await getAppStateSyncKey(base64Key);
+            if (!keyEnc) {
+                throw new Boom(`failed to find key "${base64Key}" to decode mutation`);
+            }
+            const result = await mutationKeys(keyEnc.keyData);
+            const computedSnapshotMac = generateSnapshotMac(
+                newState.hash,
+                newState.version,
+                name,
+                result.snapshotMacKey
+            );
+            if (Buffer.compare(snapshotMac, computedSnapshotMac) !== 0) {
+                throw new Boom(`failed to verify LTHash at ${newState.version} of ${name}`);
+            }
+        }
+        syncd.mutations = [];
+    }
+    return { state: newState, mutationMap: mutationMap };
+};
+const chatModificationToAppPatch = (mod, jid) => {
+    const OP = proto.SyncdMutation.SyncdOperation;
+    const getMessageRange = (lastMessages) => {
+        let messageRange;
+        if (Array.isArray(lastMessages)) {
+            const lastMsg = lastMessages[lastMessages.length - 1];
+            messageRange = {
+                lastMessageTimestamp: lastMsg?.messageTimestamp,
+                messages: lastMessages?.length
+                    ? lastMessages.map((m) => {
+                          if (!m.key?.id || !m.key?.remoteJid) {
+                              throw new Boom("Incomplete key", { statusCode: 400, data: m });
+                          }
+                          if (isJidGroup(m.key.remoteJid) && !m.key.fromMe && !m.key.participant) {
+                              throw new Boom("Expected not from me message to have participant", {
+                                  statusCode: 400,
+                                  data: m,
+                              });
+                          }
+                          if (!m.messageTimestamp || !toNumber(m.messageTimestamp)) {
+                              throw new Boom("Missing timestamp in last message list", {
+                                  statusCode: 400,
+                                  data: m,
+                              });
+                          }
+                          if (m.key.participant) {
+                              m.key.participant = jidNormalizedUser(m.key.participant);
+                          }
+                          return m;
+                      })
+                    : undefined,
+            };
+        } else {
+            messageRange = lastMessages;
+        }
+        return messageRange;
+    };
+    let patch;
+    if ("mute" in mod) {
+        patch = {
+            syncAction: {
+                muteAction: {
+                    muted: !!mod.mute,
+                    muteEndTimestamp: mod.mute || undefined,
+                },
+            },
+            index: ["mute", jid],
+            type: "regular_high",
+            apiVersion: 2,
+            operation: OP.SET,
+        };
+    } else if ("archive" in mod) {
+        patch = {
+            syncAction: {
+                archiveChatAction: {
+                    archived: !!mod.archive,
+                    messageRange: getMessageRange(mod.lastMessages),
+                },
+            },
+            index: ["archive", jid],
+            type: "regular_low",
+            apiVersion: 3,
+            operation: OP.SET,
+        };
+    } else if ("markRead" in mod) {
+        patch = {
+            syncAction: {
+                markChatAsReadAction: {
+                    read: mod.markRead,
+                    messageRange: getMessageRange(mod.lastMessages),
+                },
+            },
+            index: ["markChatAsRead", jid],
+            type: "regular_low",
+            apiVersion: 3,
+            operation: OP.SET,
+        };
+    } else if ("deleteForMe" in mod) {
+        const { timestamp: timestamp, key: key, deleteMedia: deleteMedia } = mod.deleteForMe;
+        patch = {
+            syncAction: {
+                deleteMessageForMeAction: {
+                    deleteMedia: deleteMedia,
+                    messageTimestamp: timestamp,
+                },
+            },
+            index: ["deleteMessageForMe", jid, key.id, key.fromMe ? "1" : "0", "0"],
+            type: "regular_high",
+            apiVersion: 3,
+            operation: OP.SET,
+        };
+    } else if ("clear" in mod) {
+        patch = {
+            syncAction: {
+                clearChatAction: { messageRange: getMessageRange(mod.lastMessages) },
+            },
+            index: ["clearChat", jid, "1", "0"],
+            type: "regular_high",
+            apiVersion: 6,
+            operation: OP.SET,
+        };
+    } else if ("pin" in mod) {
+        patch = {
+            syncAction: { pinAction: { pinned: !!mod.pin } },
+            index: ["pin_v1", jid],
+            type: "regular_low",
+            apiVersion: 5,
+            operation: OP.SET,
+        };
+    } else if ("contact" in mod) {
+        patch = {
+            syncAction: { contactAction: mod.contact || {} },
+            index: ["contact", jid],
+            type: "critical_unblock_low",
+            apiVersion: 2,
+            operation: mod.contact ? OP.SET : OP.REMOVE,
+        };
+    } else if ("disableLinkPreviews" in mod) {
+        patch = {
+            syncAction: {
+                privacySettingDisableLinkPreviewsAction: mod.disableLinkPreviews || {},
+            },
+            index: ["setting_disableLinkPreviews"],
+            type: "regular",
+            apiVersion: 8,
+            operation: OP.SET,
+        };
+    } else if ("star" in mod) {
+        const key = mod.star.messages[0];
+        patch = {
+            syncAction: { starAction: { starred: !!mod.star.star } },
+            index: ["star", jid, key.id, key.fromMe ? "1" : "0", "0"],
+            type: "regular_low",
+            apiVersion: 2,
+            operation: OP.SET,
+        };
+    } else if ("delete" in mod) {
+        patch = {
+            syncAction: {
+                deleteChatAction: { messageRange: getMessageRange(mod.lastMessages) },
+            },
+            index: ["deleteChat", jid, "1"],
+            type: "regular_high",
+            apiVersion: 6,
+            operation: OP.SET,
+        };
+    } else if ("pushNameSetting" in mod) {
+        patch = {
+            syncAction: { pushNameSetting: { name: mod.pushNameSetting } },
+            index: ["setting_pushName"],
+            type: "critical_block",
+            apiVersion: 1,
+            operation: OP.SET,
+        };
+    } else if ("quickReply" in mod) {
+        patch = {
+            syncAction: {
+                quickReplyAction: {
+                    count: 0,
+                    deleted: mod.quickReply.deleted || false,
+                    keywords: [],
+                    message: mod.quickReply.message || "",
+                    shortcut: mod.quickReply.shortcut || "",
+                },
+            },
+            index: [
+                "quick_reply",
+                mod.quickReply.timestamp || String(Math.floor(Date.now() / 1e3)),
+            ],
+            type: "regular",
+            apiVersion: 2,
+            operation: OP.SET,
+        };
+    } else if ("addLabel" in mod) {
+        patch = {
+            syncAction: {
+                labelEditAction: {
+                    name: mod.addLabel.name,
+                    color: mod.addLabel.color,
+                    predefinedId: mod.addLabel.predefinedId,
+                    deleted: mod.addLabel.deleted,
+                },
+            },
+            index: ["label_edit", mod.addLabel.id],
+            type: "regular",
+            apiVersion: 3,
+            operation: OP.SET,
+        };
+    } else if ("addChatLabel" in mod) {
+        patch = {
+            syncAction: { labelAssociationAction: { labeled: true } },
+            index: [LabelAssociationType.Chat, mod.addChatLabel.labelId, jid],
+            type: "regular",
+            apiVersion: 3,
+            operation: OP.SET,
+        };
+    } else if ("removeChatLabel" in mod) {
+        patch = {
+            syncAction: { labelAssociationAction: { labeled: false } },
+            index: [LabelAssociationType.Chat, mod.removeChatLabel.labelId, jid],
+            type: "regular",
+            apiVersion: 3,
+            operation: OP.SET,
+        };
+    } else if ("addMessageLabel" in mod) {
+        patch = {
+            syncAction: { labelAssociationAction: { labeled: true } },
+            index: [
+                LabelAssociationType.Message,
+                mod.addMessageLabel.labelId,
+                jid,
+                mod.addMessageLabel.messageId,
+                "0",
+                "0",
+            ],
+            type: "regular",
+            apiVersion: 3,
+            operation: OP.SET,
+        };
+    } else if ("removeMessageLabel" in mod) {
+        patch = {
+            syncAction: { labelAssociationAction: { labeled: false } },
+            index: [
+                LabelAssociationType.Message,
+                mod.removeMessageLabel.labelId,
+                jid,
+                mod.removeMessageLabel.messageId,
+                "0",
+                "0",
+            ],
+            type: "regular",
+            apiVersion: 3,
+            operation: OP.SET,
+        };
+    } else {
+        throw new Boom("not supported");
+    }
+    patch.syncAction.timestamp = Date.now();
+    return patch;
+};
+const processSyncAction = (syncAction, ev, me, initialSyncOpts, logger) => {
+    const isInitialSync = !!initialSyncOpts;
+    const accountSettings = initialSyncOpts?.accountSettings;
+    logger?.trace(
+        { syncAction: syncAction, initialSync: !!initialSyncOpts },
+        "processing sync action"
+    );
+    const {
+        syncAction: { value: action },
+        index: [type, id, msgId, fromMe],
+    } = syncAction;
+    if (action?.muteAction) {
+        ev.emit("chats.update", [
+            {
+                id: id,
+                muteEndTime: action.muteAction?.muted
+                    ? toNumber(action.muteAction.muteEndTimestamp)
+                    : null,
+                conditional: getChatUpdateConditional(id, undefined),
+            },
+        ]);
+    } else if (action?.archiveChatAction || type === "archive" || type === "unarchive") {
+        const archiveAction = action?.archiveChatAction;
+        const isArchived = archiveAction ? archiveAction.archived : type === "archive";
+        const msgRange = !accountSettings?.unarchiveChats ? undefined : archiveAction?.messageRange;
+        ev.emit("chats.update", [
+            {
+                id: id,
+                archived: isArchived,
+                conditional: getChatUpdateConditional(id, msgRange),
+            },
+        ]);
+    } else if (action?.markChatAsReadAction) {
+        const markReadAction = action.markChatAsReadAction;
+        const isNullUpdate = isInitialSync && markReadAction.read;
+        ev.emit("chats.update", [
+            {
+                id: id,
+                unreadCount: isNullUpdate ? null : !!markReadAction?.read ? 0 : -1,
+                conditional: getChatUpdateConditional(id, markReadAction?.messageRange),
+            },
+        ]);
+    } else if (action?.deleteMessageForMeAction || type === "deleteMessageForMe") {
+        ev.emit("messages.delete", {
+            keys: [{ remoteJid: id, id: msgId, fromMe: fromMe === "1" }],
+        });
+    } else if (action?.contactAction) {
+        const lidJid = action.contactAction.lidJid;
+        const idIsPn = isPnUser(id);
+        ev.emit("contacts.upsert", [
+            {
+                id: id,
+                name: action.contactAction.fullName,
+                lid: action.contactAction.lidJid || undefined,
+                phoneNumber: action.contactAction.pnJid || (idIsPn ? id : undefined),
+            },
+        ]);
+        // Added for AsepXyz Baileys (ported from PouCode): keep LID<->PN mapping in sync
+        if (lidJid && isLidUser(lidJid) && idIsPn) {
+            ev.emit("lid-mapping.update", { lid: lidJid, pn: id });
+        }
+    } else if (action?.pushNameSetting) {
+        const name = action?.pushNameSetting?.name;
+        if (name && me?.name !== name) {
+            ev.emit("creds.update", { me: { ...me, name: name } });
+        }
+    } else if (action?.pinAction) {
+        ev.emit("chats.update", [
+            {
+                id: id,
+                pinned: action.pinAction?.pinned ? toNumber(action.timestamp) : null,
+                conditional: getChatUpdateConditional(id, undefined),
+            },
+        ]);
+    } else if (action?.unarchiveChatsSetting) {
+        const unarchiveChats = !!action.unarchiveChatsSetting.unarchiveChats;
+        ev.emit("creds.update", {
+            accountSettings: { unarchiveChats: unarchiveChats },
+        });
+        logger?.info(`archive setting updated => '${action.unarchiveChatsSetting.unarchiveChats}'`);
+        if (accountSettings) {
+            accountSettings.unarchiveChats = unarchiveChats;
+        }
+    } else if (action?.starAction || type === "star") {
+        let starred = action?.starAction?.starred;
+        if (typeof starred !== "boolean") {
+            starred = syncAction.index[syncAction.index.length - 1] === "1";
+        }
+        ev.emit("messages.update", [
+            {
+                key: { remoteJid: id, id: msgId, fromMe: fromMe === "1" },
+                update: { starred: starred },
+            },
+        ]);
+    } else if (action?.deleteChatAction || type === "deleteChat") {
+        if (!isInitialSync) {
+            ev.emit("chats.delete", [id]);
+        }
+    } else if (action?.labelEditAction) {
+        const {
+            name: name,
+            color: color,
+            deleted: deleted,
+            predefinedId: predefinedId,
+        } = action.labelEditAction;
+        ev.emit("labels.edit", {
+            id: id,
+            name: name,
+            color: color,
+            deleted: deleted,
+            predefinedId: predefinedId ? String(predefinedId) : undefined,
+        });
+    } else if (action?.labelAssociationAction) {
+        ev.emit("labels.association", {
+            type: action.labelAssociationAction.labeled ? "add" : "remove",
+            association:
+                type === LabelAssociationType.Chat
+                    ? {
+                          type: LabelAssociationType.Chat,
+                          chatId: syncAction.index[2],
+                          labelId: syncAction.index[1],
+                      }
+                    : {
+                          type: LabelAssociationType.Message,
+                          chatId: syncAction.index[2],
+                          messageId: syncAction.index[3],
+                          labelId: syncAction.index[1],
+                      },
+        });
+    } else if (action?.localeSetting?.locale) {
+        ev.emit("settings.update", {
+            setting: "locale",
+            value: action.localeSetting.locale,
+        });
+    } else if (action?.timeFormatAction) {
+        ev.emit("settings.update", {
+            setting: "timeFormat",
+            value: action.timeFormatAction,
+        });
+    } else if (action?.pnForLidChatAction) {
+        if (action.pnForLidChatAction.pnJid) {
+            ev.emit("lid-mapping.update", {
+                lid: id,
+                pn: action.pnForLidChatAction.pnJid,
+            });
+        }
+    } else if (action?.privacySettingRelayAllCalls) {
+        ev.emit("settings.update", {
+            setting: "privacySettingRelayAllCalls",
+            value: action.privacySettingRelayAllCalls,
+        });
+    } else if (action?.statusPrivacy) {
+        ev.emit("settings.update", {
+            setting: "statusPrivacy",
+            value: action.statusPrivacy,
+        });
+    } else if (action?.lockChatAction) {
+        ev.emit("chats.lock", { id: id, locked: !!action.lockChatAction.locked });
+    } else if (action?.privacySettingDisableLinkPreviewsAction) {
+        ev.emit("settings.update", {
+            setting: "disableLinkPreviews",
+            value: action.privacySettingDisableLinkPreviewsAction,
+        });
+    } else if (action?.notificationActivitySettingAction?.notificationActivitySetting) {
+        ev.emit("settings.update", {
+            setting: "notificationActivitySetting",
+            value: action.notificationActivitySettingAction.notificationActivitySetting,
+        });
+    } else if (action?.lidContactAction) {
+        ev.emit("contacts.upsert", [
+            {
+                id: id,
+                name: action.lidContactAction.fullName,
+                lid: id,
+                phoneNumber: undefined,
+            },
+        ]);
+    } else if (action?.privacySettingChannelsPersonalisedRecommendationAction) {
+        ev.emit("settings.update", {
+            setting: "channelsPersonalisedRecommendation",
+            value: action.privacySettingChannelsPersonalisedRecommendationAction,
+        });
+    } else {
+        logger?.debug({ syncAction: syncAction, id: id }, "unprocessable update");
+    }
+    function getChatUpdateConditional(id, msgRange) {
+        return isInitialSync
+            ? (data) => {
+                  const chat = data.historySets.chats[id] || data.chatUpserts[id];
+                  if (chat) {
+                      return msgRange ? isValidPatchBasedOnMessageRange(chat, msgRange) : true;
+                  }
+              }
+            : undefined;
+    }
+    function isValidPatchBasedOnMessageRange(chat, msgRange) {
+        const lastMsgTimestamp = Number(
+            msgRange?.lastMessageTimestamp || msgRange?.lastSystemMessageTimestamp || 0
+        );
+        const chatLastMsgTimestamp = Number(chat?.lastMessageRecvTimestamp || 0);
+        return lastMsgTimestamp >= chatLastMsgTimestamp;
+    }
+};
+module.exports = {
+    mutationKeys: mutationKeys,
+    newLTHashState: newLTHashState,
+    encodeSyncdPatch: encodeSyncdPatch,
+    decodeSyncdMutations: decodeSyncdMutations,
+    decodeSyncdPatch: decodeSyncdPatch,
+    extractSyncdPatches: extractSyncdPatches,
+    downloadExternalBlob: downloadExternalBlob,
+    downloadExternalPatch: downloadExternalPatch,
+    decodeSyncdSnapshot: decodeSyncdSnapshot,
+    decodePatches: decodePatches,
+    chatModificationToAppPatch: chatModificationToAppPatch,
+    processSyncAction: processSyncAction,
+};