fix: extract LID-PN mappings from conversation objects in history sync

[jlucaso1]

Fixes an issue where LID-PN mappings from conversation objects in history sync were not being extracted and stored.

Related Issue: #2263
Related Comment: #2263 (comment)

Problem

@Jeferson-Ramos-Einov reported receiving chats in messaging-history.set with:

• id: "152230971891797@lid" (LID format)
• pnJid: "554199088675@s.whatsapp.net" (phone number available)

The LID-PN mapping was not being stored, preventing resolution of LID to phone number.

Root cause: Baileys only extracted mappings from the phoneNumberToLidMappings array at the top level of the history sync proto, but NOT from individual conversation objects.

How WhatsApp Web Handles This

Analysis of captured WhatsApp Web JavaScript (ftEKVbCt5NT.js, lines 109356-109386) shows they extract LID-PN mappings from both sources:

if (u.isUser()) {
  if (u.isLid()) {
    // Case 1: Chat ID is LID, extract pnJid
    var c = n.pnJid;
    if (c != null) {
      T.push({ lid: u, pn: createUserWidOrThrow(c) });
    }
  } else if (n.lidJid != null) {
    // Case 2: Chat ID is PN, extract lidJid
    T.push({ lid: createUserLidOrThrow(n.lidJid), pn: u });
  }
}

Solution

Added extraction logic in processHistoryMessage() to match WhatsApp Web:

const chatId = chat.id!
const isLid = isLidUser(chatId) || isHostedLidUser(chatId)
const isPn = isPnUser(chatId) || isHostedPnUser(chatId)
if (isLid && chat.pnJid) {
    lidPnMappings.push({ lid: chatId, pn: chat.pnJid })
} else if (isPn && chat.lidJid) {
    lidPnMappings.push({ lid: chat.lidJid, pn: chatId })
}

[whiskeysockets-bot]

Thanks for opening this pull request and contributing to the project!

The next step is for the maintainers to review your changes. If everything looks good, it will be approved and merged into the main branch.

In the meantime, anyone in the community is encouraged to test this pull request and provide feedback.

✅ How to confirm it works

If you’ve tested this PR, please comment below with:

Tested and working ✅

This helps us speed up the review and merge process.

📦 To test this PR locally:

# NPM
npm install @whiskeysockets/baileys@WhiskeySockets/Baileys#fix-lid-pn-mapping-from-history-sync-conversations

# Yarn (v2+)
yarn add @whiskeysockets/baileys@WhiskeySockets/Baileys#fix-lid-pn-mapping-from-history-sync-conversations

# PNPM
pnpm add @whiskeysockets/baileys@WhiskeySockets/Baileys#fix-lid-pn-mapping-from-history-sync-conversations

If you encounter any issues or have feedback, feel free to comment as well.

[Jeferson-Ramos-Einov]

@jlucaso1 Amigo tenho um caso onde pnJid não existe porem dentro da mensagem o remoteJid esta presente:

{ "participant": [], "id": "211071956705386@lid", "unreadCount": 0, "readOnly": false, "ephemeralExpiration": 0, "ephemeralSettingTimestamp": { "low": 0, "high": 0, "unsigned": false }, "conversationTimestamp": { "low": 1768320044, "high": 0, "unsigned": true }, "notSpam": true, "archived": false, "disappearingMode": { "initiator": "CHANGED_IN_CHAT", "trigger": "CHAT_SETTING", "initiatedByMe": false }, "unreadMentionCount": 0, "tcToken": { "type": "Buffer", "data": [ 4, 1, 30, 107, 55, 30, 173, 70, 144, 141, 52 ] }, "tcTokenTimestamp": { "low": 1768320009, "high": 0, "unsigned": true }, "contactPrimaryIdentityKey": { "type": "Buffer", "data": [ 217, 18, 128, 144, 15, 104, 255, 252, 32, 172, 103, 5, 223, 134, 11, 166, 224, 81, 78, 195, 38, 115, 184, 155, 135, 241, 149, 119, 152, 114, 80, 38 ] }, "tcTokenSenderTimestamp": { "low": 1768311770, "high": 0, "unsigned": true }, "terminated": false, "isDefaultSubgroup": false, "shareOwnPn": false, "locked": false, "limitSharing": false, "limitSharingSettingTimestamp": { "low": 0, "high": 0, "unsigned": false }, "limitSharingTrigger": 0, "limitSharingInitiatedByMe": false, "messages": [ { "message": { "key": { "remoteJid": "211071956705386@lid", "fromMe": true, "id": "3EB052FF8D9D00646C9994" }, "message": { "extendedTextMessage": { "text": "Oi, João!", "contextInfo": { "expiration": 0, "ephemeralSettingTimestamp": "1768147242" } } }, "messageTimestamp": "1768320044", "status": "READ", "userReceipt": [ { "userJid": "551838211855@s.whatsapp.net", "receiptTimestamp": "1768320045", "readTimestamp": "1768327083", "playedTimestamp": "0", "deliveredDeviceJid": [ "551838211855:0@s.whatsapp.net", "551838211855:93@s.whatsapp.net" ] } ], "originalSelfAuthorUserJidString": "188472275030054@lid", "interactiveMessageAdditionalMetadata": { "isGalaxyFlowCompleted": false } } } ], "lastMessageRecvTimestamp": 1768320009 }

[jlucaso1]

@Jeferson-Ramos-Einov added this edge case too. Thank you <3

[Jeferson-Ramos-Einov]

@jlucaso1 Cara a ultima acredito eu, existem casos onde o remoteJid não existe nesse mesmo contexto

{ "participant": [], "id": "213142651035807@lid", "unreadCount": 0, "readOnly": false, "ephemeralExpiration": 0, "ephemeralSettingTimestamp": { "low": 0, "high": 0, "unsigned": false }, "conversationTimestamp": { "low": 1767872448, "high": 0, "unsigned": true }, "notSpam": true, "archived": false, "disappearingMode": { "initiator": "CHANGED_IN_CHAT", "trigger": "CHAT_SETTING", "initiatedByMe": false }, "unreadMentionCount": 0, "tcToken": { "type": "Buffer", "data": [ 4, 1, 30, 112, 146, 199, 182, 102, 138, 59, 47 ] }, "tcTokenTimestamp": { "low": 1767872448, "high": 0, "unsigned": true }, "tcTokenSenderTimestamp": { "low": 1767731406, "high": 0, "unsigned": true }, "terminated": false, "isDefaultSubgroup": false, "shareOwnPn": false, "locked": false, "limitSharing": false, "limitSharingSettingTimestamp": { "low": 0, "high": 0, "unsigned": false }, "limitSharingTrigger": 0, "limitSharingInitiatedByMe": false, "messages": [ { "message": { "key": { "remoteJid": "213142651035807@lid", "fromMe": false, "id": "2A5B8A5FF1E97E688A1C" }, "messageTimestamp": "1768936342", "messageStubType": "BIZ_PRIVACY_MODE_TO_FB", "messageStubParameters": [ "" ], "interactiveMessageAdditionalMetadata": { "isGalaxyFlowCompleted": false } } } ], "lastMessageRecvTimestamp": 1768936342 }

[jlucaso1]

@jlucaso1 Cara a ultima acredito eu, existem casos onde o remoteJid não existe nesse mesmo contexto

{ "participant": [], "id": "213142651035807@lid", "unreadCount": 0, "readOnly": false, "ephemeralExpiration": 0, "ephemeralSettingTimestamp": { "low": 0, "high": 0, "unsigned": false }, "conversationTimestamp": { "low": 1767872448, "high": 0, "unsigned": true }, "notSpam": true, "archived": false, "disappearingMode": { "initiator": "CHANGED_IN_CHAT", "trigger": "CHAT_SETTING", "initiatedByMe": false }, "unreadMentionCount": 0, "tcToken": { "type": "Buffer", "data": [ 4, 1, 30, 112, 146, 199, 182, 102, 138, 59, 47 ] }, "tcTokenTimestamp": { "low": 1767872448, "high": 0, "unsigned": true }, "tcTokenSenderTimestamp": { "low": 1767731406, "high": 0, "unsigned": true }, "terminated": false, "isDefaultSubgroup": false, "shareOwnPn": false, "locked": false, "limitSharing": false, "limitSharingSettingTimestamp": { "low": 0, "high": 0, "unsigned": false }, "limitSharingTrigger": 0, "limitSharingInitiatedByMe": false, "messages": [ { "message": { "key": { "remoteJid": "213142651035807@lid", "fromMe": false, "id": "2A5B8A5FF1E97E688A1C" }, "messageTimestamp": "1768936342", "messageStubType": "BIZ_PRIVACY_MODE_TO_FB", "messageStubParameters": [ "" ], "interactiveMessageAdditionalMetadata": { "isGalaxyFlowCompleted": false } } } ], "lastMessageRecvTimestamp": 1768936342 }

Nesse caso não tem nada que possamos fazer, o chat é apenas LID, não tem como extrair o PN nessse caso.

[purpshell]

Nesse caso não tem nada que possamos fazer, o chat é apenas LID, não tem como extrair o PN nessse caso.

other than to use requestPhoneNumber message

[purpshell]

BIZ_PRIVACY_MODE_TO_FB

This is a Meta Ads chat, WhatsApp hides the phone number for the privacy of the users involved in this chat, as you can see on the app there exists a "+55•••••••4534" phone number

[Jeferson-Ramos-Einov]

@purpshell I can locate the chat on WhatsApp Web by the message content. Within WhatsApp Web, this chat has a phone number.