feat(history): comprehensive LID-PN mapping with full JID format support

Enhances LID-PN mapping extraction to handle all WhatsApp JID formats
and extract mappings from multiple sources within history sync data.

New JID validation:
- Add `isPersonJid()` helper to identify JIDs that can have LID-PN mappings
- Skip non-person JIDs: @newsletter (channels), @broadcast, @g.us (groups)

Triple-source extraction:
1. Top-level `phoneNumberToLidMappings` array (existing)
2. Conversation objects via `lidJid`/`pnJid` properties (existing)
3. Message objects via `remoteJidAlt`/`participantAlt` fields (NEW)

New `extractLidPnFromMessage()` function:
- Extracts mappings from message key alternative JID fields
- Handles both direct messages (remoteJidAlt) and group messages (participantAlt)
- Properly identifies LID vs PN based on server type

JID formats handled:
- @s.whatsapp.net - Standard phone number
- @lid - Logical ID (privacy)
- @hosted - Hosted phone number
- @hosted.lid - Hosted LID

46 comprehensive tests covering all scenarios.

Related: WhiskeySockets/Baileys#2263
This commit is contained in:
Claude
2026-01-20 22:29:36 +00:00
parent 86c1cf439a
commit 154dd772dd
2 changed files with 440 additions and 4 deletions
+311 -1
View File
@@ -1,5 +1,156 @@
import { proto } from '../../../WAProto/index.js'
import { processHistoryMessage, extractLidPnFromConversation } from '../../Utils/history'
import {
processHistoryMessage,
extractLidPnFromConversation,
extractLidPnFromMessage,
isPersonJid
} from '../../Utils/history'
describe('isPersonJid', () => {
it('should return true for @s.whatsapp.net format', () => {
expect(isPersonJid('5511999999999@s.whatsapp.net')).toBe(true)
})
it('should return true for @lid format', () => {
expect(isPersonJid('123456789012345@lid')).toBe(true)
})
it('should return true for @hosted format', () => {
expect(isPersonJid('5511999999999@hosted')).toBe(true)
})
it('should return true for @hosted.lid format', () => {
expect(isPersonJid('123456789012345@hosted.lid')).toBe(true)
})
it('should return false for @g.us (groups)', () => {
expect(isPersonJid('123456789012345@g.us')).toBe(false)
})
it('should return false for @broadcast', () => {
expect(isPersonJid('status@broadcast')).toBe(false)
})
it('should return false for @newsletter (channels)', () => {
expect(isPersonJid('123456789012345@newsletter')).toBe(false)
})
it('should return false for undefined', () => {
expect(isPersonJid(undefined)).toBe(false)
})
it('should return false for empty string', () => {
expect(isPersonJid('')).toBe(false)
})
})
describe('extractLidPnFromMessage', () => {
describe('direct messages', () => {
it('should extract mapping when remoteJid is LID and remoteJidAlt is PN', () => {
const result = extractLidPnFromMessage(
'123456789012345@lid',
'5511999999999@s.whatsapp.net',
undefined,
undefined
)
expect(result).toEqual({
lid: '123456789012345@lid',
pn: '5511999999999@s.whatsapp.net'
})
})
it('should extract mapping when remoteJid is PN and remoteJidAlt is LID', () => {
const result = extractLidPnFromMessage(
'5511999999999@s.whatsapp.net',
'123456789012345@lid',
undefined,
undefined
)
expect(result).toEqual({
lid: '123456789012345@lid',
pn: '5511999999999@s.whatsapp.net'
})
})
})
describe('group messages', () => {
it('should extract mapping from participant fields in groups', () => {
const result = extractLidPnFromMessage(
'123456789012345@g.us', // group JID
undefined,
'5511999999999@s.whatsapp.net', // participant
'123456789012345@lid' // participantAlt
)
expect(result).toEqual({
lid: '123456789012345@lid',
pn: '5511999999999@s.whatsapp.net'
})
})
it('should prefer participant over remoteJid for mapping', () => {
const result = extractLidPnFromMessage(
'5511888888888@s.whatsapp.net', // ignored
'987654321098765@lid', // ignored
'5511999999999@s.whatsapp.net', // participant used
'123456789012345@lid' // participantAlt used
)
expect(result).toEqual({
lid: '123456789012345@lid',
pn: '5511999999999@s.whatsapp.net'
})
})
})
describe('edge cases', () => {
it('should return undefined when no alt JID is present', () => {
const result = extractLidPnFromMessage(
'5511999999999@s.whatsapp.net',
undefined,
undefined,
undefined
)
expect(result).toBeUndefined()
})
it('should return undefined when both are same type (LID)', () => {
const result = extractLidPnFromMessage(
'123456789012345@lid',
'987654321098765@lid',
undefined,
undefined
)
expect(result).toBeUndefined()
})
it('should return undefined when both are same type (PN)', () => {
const result = extractLidPnFromMessage(
'5511999999999@s.whatsapp.net',
'5511888888888@s.whatsapp.net',
undefined,
undefined
)
expect(result).toBeUndefined()
})
it('should return undefined for newsletter messages', () => {
const result = extractLidPnFromMessage(
'123456789012345@newsletter',
undefined,
undefined,
undefined
)
expect(result).toBeUndefined()
})
})
})
describe('extractLidPnFromConversation', () => {
describe('LID chat with pnJid', () => {
@@ -71,6 +222,26 @@ describe('extractLidPnFromConversation', () => {
expect(result).toBeUndefined()
})
it('should return undefined for newsletters (@newsletter)', () => {
const result = extractLidPnFromConversation(
'123456789012345@newsletter',
'11111111111111@lid',
'5511999999999@s.whatsapp.net'
)
expect(result).toBeUndefined()
})
it('should return undefined for broadcast lists (@broadcast)', () => {
const result = extractLidPnFromConversation(
'status@broadcast',
undefined,
undefined
)
expect(result).toBeUndefined()
})
it('should return undefined when no alternate JID is available', () => {
const result = extractLidPnFromConversation(
'123456789012345@lid',
@@ -379,5 +550,144 @@ describe('processHistoryMessage', () => {
{ lid: '11111111111111@lid', pn: '5511999999999@s.whatsapp.net' }
])
})
it('should not extract mapping from newsletter conversations', () => {
const historySync: proto.IHistorySync = {
syncType: proto.HistorySync.HistorySyncType.INITIAL_BOOTSTRAP,
conversations: [
{
id: '123456789012345@newsletter',
name: 'News Channel'
}
]
}
const result = processHistoryMessage(historySync)
expect(result.lidPnMappings).toEqual([])
})
it('should not extract mapping from broadcast conversations', () => {
const historySync: proto.IHistorySync = {
syncType: proto.HistorySync.HistorySyncType.INITIAL_BOOTSTRAP,
conversations: [
{
id: 'status@broadcast',
name: 'Status'
}
]
}
const result = processHistoryMessage(historySync)
expect(result.lidPnMappings).toEqual([])
})
})
describe('LID-PN extraction from messages (remoteJidAlt)', () => {
// Note: remoteJidAlt and participantAlt are runtime extensions to IMessageKey
// defined in WAMessageKey type. We cast via unknown for test data.
it('should extract mapping from message with remoteJidAlt', () => {
const historySync = {
syncType: proto.HistorySync.HistorySyncType.INITIAL_BOOTSTRAP,
conversations: [
{
id: '5511999999999@s.whatsapp.net',
name: 'User',
messages: [
{
message: {
key: {
remoteJid: '5511999999999@s.whatsapp.net',
remoteJidAlt: '11111111111111@lid',
id: 'MSG123',
fromMe: false
},
messageTimestamp: 1234567890
}
}
]
}
]
} as unknown as proto.IHistorySync
const result = processHistoryMessage(historySync)
expect(result.lidPnMappings).toContainEqual({
lid: '11111111111111@lid',
pn: '5511999999999@s.whatsapp.net'
})
})
it('should extract mapping from group message with participantAlt', () => {
const historySync = {
syncType: proto.HistorySync.HistorySyncType.INITIAL_BOOTSTRAP,
conversations: [
{
id: '123456789012345@g.us',
name: 'Group Chat',
messages: [
{
message: {
key: {
remoteJid: '123456789012345@g.us',
participant: '5511999999999@s.whatsapp.net',
participantAlt: '11111111111111@lid',
id: 'MSG456',
fromMe: false
},
messageTimestamp: 1234567890
}
}
]
}
]
} as unknown as proto.IHistorySync
const result = processHistoryMessage(historySync)
expect(result.lidPnMappings).toContainEqual({
lid: '11111111111111@lid',
pn: '5511999999999@s.whatsapp.net'
})
})
it('should deduplicate mappings from all three sources', () => {
const historySync = {
syncType: proto.HistorySync.HistorySyncType.INITIAL_BOOTSTRAP,
phoneNumberToLidMappings: [
{ lidJid: '11111111111111@lid', pnJid: '5511999999999@s.whatsapp.net' }
],
conversations: [
{
id: '11111111111111@lid',
name: 'User',
pnJid: '5511999999999@s.whatsapp.net',
messages: [
{
message: {
key: {
remoteJid: '11111111111111@lid',
remoteJidAlt: '5511999999999@s.whatsapp.net',
id: 'MSG789',
fromMe: true
},
messageTimestamp: 1234567890
}
}
]
}
]
} as unknown as proto.IHistorySync
const result = processHistoryMessage(historySync)
// Should have only 1 mapping (deduplicated across all 3 sources)
expect(result.lidPnMappings).toHaveLength(1)
expect(result.lidPnMappings[0]).toEqual({
lid: '11111111111111@lid',
pn: '5511999999999@s.whatsapp.net'
})
})
})
})