fix: add biz node injection and quality_control for carousel WhatsApp Web rendering

- Add interactive message detection helpers (getButtonType, isCarouselMessage, etc.)
- Inject biz node with interactive/native_flow for non-carousel interactive messages
- Inject biz + quality_control with decision_id for carousel messages
- Skip bot node for native_flow/carousel/catalog (breaks Web rendering)
- Force device-identity inclusion for carousel messages
- Append deferred biz/bot/quality_control nodes after device-identity and tctoken
- Store tctoken under both LID and PN for reliable lookup

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

WAProto/WAProto.proto

@@ -1,7 +1,7 @@
 syntax = "proto3";
 package proto;
 
-/// WhatsApp Version: 2.3000.1035302375
+/// WhatsApp Version: 2.3000.1035216863
 
 message ADVDeviceIdentity {
     optional uint32 rawId = 1;

src/Defaults/baileys-version.json

@@ -1 +1 @@
-{"version":[2,3000,1035317910]}
+{"version":[2,3000,1035223526]}

src/Signal/libsignal.ts

@@ -306,7 +306,7 @@ export function makeLibSignalRepository(
 	// This prevents PN/LID race conditions where concurrent operations for the
 	// same logical contact acquire different mutex locks because one uses PN
 	// and the other uses LID. (Aligned with WABA behavior — all operations use LID internally.)
-	const resolveCanonicalJid = async (jid: string): Promise<string> => {
+	const resolveCanonicalJid = async(jid: string): Promise<string> => {
 		if (isAnyLidUser(jid)) {
 			return jid
 		}

src/Socket/groups.ts

@@ -25,30 +25,28 @@ export const makeGroupsSocket = (config: SocketConfig) => {
 		const lidMapping = signalRepository.lidMapping
 
 		// Resolve all participant LIDs in parallel for better performance on large groups
-		await Promise.all(
+		await Promise.all(metadata.participants.map(async (p) => {
-			metadata.participants.map(async p => {
+			if (isLidUser(p.id)) {
-				if (isLidUser(p.id)) {
+				if (p.phoneNumber) {
-					if (p.phoneNumber) {
+					p.lid = p.id
+					p.id = p.phoneNumber
+				} else {
+					const resolved = await resolveLidToPn(p.id, lidMapping, logger)
+					if (resolved && resolved !== p.id) {
 						p.lid = p.id
-						p.id = p.phoneNumber
+						p.id = resolved
-					} else {
-						const resolved = await resolveLidToPn(p.id, lidMapping, logger)
-						if (resolved && resolved !== p.id) {
-							p.lid = p.id
-							p.id = resolved
-						}
 					}
 				}
-			})
+			}
-		)
+		}))
 
 		// Normalize owner/subjectOwner if LID (parallel)
 		const [resolvedOwner, resolvedSubjectOwner] = await Promise.all([
 			metadata.owner && isLidUser(metadata.owner)
-				? metadata.ownerPn || resolveLidToPn(metadata.owner, lidMapping, logger)
+				? (metadata.ownerPn || resolveLidToPn(metadata.owner, lidMapping, logger))
 				: null,
 			metadata.subjectOwner && isLidUser(metadata.subjectOwner)
-				? metadata.subjectOwnerPn || resolveLidToPn(metadata.subjectOwner, lidMapping, logger)
+				? (metadata.subjectOwnerPn || resolveLidToPn(metadata.subjectOwner, lidMapping, logger))
 				: null
 		])
 		if (resolvedOwner) metadata.owner = resolvedOwner
@@ -97,13 +95,11 @@ export const makeGroupsSocket = (config: SocketConfig) => {
 		if (groupsChild) {
 			const groups = getBinaryNodeChildren(groupsChild, 'group')
 			for (const groupNode of groups) {
-				const meta = await normalizeGroupMetadata(
+				const meta = await normalizeGroupMetadata(extractGroupMetadata({
-					extractGroupMetadata({
+					tag: 'result',
-						tag: 'result',
+					attrs: {},
-						attrs: {},
+					content: [groupNode]
-						content: [groupNode]
+				}))
-					})
-				)
 				data[meta.id] = meta
 			}
 		}

src/Socket/messages-recv.ts

@@ -376,7 +376,7 @@ export const makeMessagesRecvSocket = (config: SocketConfig) => {
 				for (const update of updates) {
 					if (update.jid && update.user) {
 						const [resolvedAuthor, resolvedUser] = await Promise.all([
-							resolveLidToPn(node.attrs.from, signalRepository.lidMapping, logger),
+							resolveLidToPn(node.attrs.from!, signalRepository.lidMapping, logger),
 							resolveLidToPn(update.user, signalRepository.lidMapping, logger)
 						])
 						ev.emit('newsletter-participants.update', {
@@ -403,7 +403,7 @@ export const makeMessagesRecvSocket = (config: SocketConfig) => {
 		const child = getAllBinaryNodeChildren(node)[0]!
 		const rawAuthor = node.attrs.participant!
 		// Resolve author LID→PN (participant is a user JID that could be LID)
-		const author = (await resolveLidToPn(rawAuthor, signalRepository.lidMapping, logger)) || rawAuthor
+		const author = await resolveLidToPn(rawAuthor, signalRepository.lidMapping, logger) || rawAuthor
 
 		logger.info({ from, child }, 'got newsletter notification')
 
@@ -430,8 +430,7 @@ export const makeMessagesRecvSocket = (config: SocketConfig) => {
 				break
 
 			case 'participant':
-				const resolvedParticipantUser =
+				const resolvedParticipantUser = await resolveLidToPn(child.attrs.jid!, signalRepository.lidMapping, logger) || child.attrs.jid!
-					(await resolveLidToPn(child.attrs.jid, signalRepository.lidMapping, logger)) || child.attrs.jid!
 				const participantUpdate = {
 					id: from,
 					author,
@@ -574,7 +573,7 @@ export const makeMessagesRecvSocket = (config: SocketConfig) => {
 		const offerContent: BinaryNode[] = [
 			{ tag: 'privacy', attrs: {}, content: undefined },
 			{ tag: 'audio', attrs: { rate: '8000', enc: 'opus' }, content: undefined },
-			{ tag: 'audio', attrs: { rate: '16000', enc: 'opus' }, content: undefined }
+			{ tag: 'audio', attrs: { rate: '16000', enc: 'opus' }, content: undefined },
 		]
 
 		if (isVideo) {
@@ -595,31 +594,31 @@ export const makeMessagesRecvSocket = (config: SocketConfig) => {
 			{ tag: 'net', attrs: { medium: '3' }, content: undefined },
 			{ tag: 'capability', attrs: { ver: '1' }, content: undefined },
 			{ tag: 'enc', attrs: { v: '2', type: isVideo ? 'msg' : 'pkmsg' }, content: undefined },
-			{ tag: 'encopt', attrs: { keygen: '2' }, content: undefined }
+			{ tag: 'encopt', attrs: { keygen: '2' }, content: undefined },
 		)
 
 		// Voice calls include device-identity (verified via Frida capture)
 		if (!isVideo) {
-			offerContent.push({ tag: 'device-identity', attrs: {}, content: undefined })
+			offerContent.push(
+				{ tag: 'device-identity', attrs: {}, content: undefined },
+			)
 		}
 
 		const stanza: BinaryNode = {
 			tag: 'call',
 			attrs: {
 				to: jid,
-				id: stanzaId
+				id: stanzaId,
 			},
-			content: [
+			content: [{
-				{
+				tag: 'offer',
-					tag: 'offer',
+				attrs: {
-					attrs: {
+					'call-creator': meId,
-						'call-creator': meId,
+					'call-id': callId,
-						'call-id': callId,
+					'device_class': '2013',
-						device_class: '2013'
+				},
-					},
+				content: offerContent
-					content: offerContent
+			}]
-				}
-			]
 		}
 
 		await query(stanza)
@@ -648,7 +647,7 @@ export const makeMessagesRecvSocket = (config: SocketConfig) => {
 
 		const terminateAttrs: Record<string, string> = {
 			'call-id': callId,
-			'call-creator': callCreator || meId
+			'call-creator': callCreator || meId,
 		}
 
 		if (reason) {
@@ -664,15 +663,13 @@ export const makeMessagesRecvSocket = (config: SocketConfig) => {
 			tag: 'call',
 			attrs: {
 				to: callTo,
-				id: randomBytes(16).toString('hex').toUpperCase()
+				id: randomBytes(16).toString('hex').toUpperCase(),
 			},
-			content: [
+			content: [{
-				{
+				tag: 'terminate',
-					tag: 'terminate',
+				attrs: terminateAttrs,
-					attrs: terminateAttrs,
+				content: undefined
-					content: undefined
+			}]
-				}
-			]
 		}
 
 		await query(stanza)
@@ -686,18 +683,24 @@ export const makeMessagesRecvSocket = (config: SocketConfig) => {
 	 * @param callFrom - JID of the caller (call-creator)
 	 * @param isVideo - true for video call
 	 */
-	const acceptCall = async (callId: string, callFrom: string, isVideo?: boolean) => {
+	const acceptCall = async (
+		callId: string,
+		callFrom: string,
+		isVideo?: boolean,
+	) => {
 		const meId = authState.creds.me?.id
 		if (!meId) throw new Boom('Not authenticated', { statusCode: 401 })
 
-		const acceptContent: BinaryNode[] = [{ tag: 'audio', attrs: { rate: '16000', enc: 'opus' }, content: undefined }]
+		const acceptContent: BinaryNode[] = [
+			{ tag: 'audio', attrs: { rate: '16000', enc: 'opus' }, content: undefined },
+		]
 
 		if (isVideo) {
 			acceptContent.push({
 				tag: 'video',
 				attrs: {
 					dec: 'H264,AV1',
-					device_orientation: '1'
+					device_orientation: '1',
 				},
 				content: undefined
 			})
@@ -705,7 +708,7 @@ export const makeMessagesRecvSocket = (config: SocketConfig) => {
 
 		acceptContent.push(
 			{ tag: 'net', attrs: { medium: '2' }, content: undefined },
-			{ tag: 'encopt', attrs: { keygen: '2' }, content: undefined }
+			{ tag: 'encopt', attrs: { keygen: '2' }, content: undefined },
 		)
 
 		const stanza: BinaryNode = {
@@ -713,18 +716,16 @@ export const makeMessagesRecvSocket = (config: SocketConfig) => {
 			attrs: {
 				from: meId,
 				to: callFrom,
-				id: randomBytes(16).toString('hex').toUpperCase()
+				id: randomBytes(16).toString('hex').toUpperCase(),
 			},
-			content: [
+			content: [{
-				{
+				tag: 'accept',
-					tag: 'accept',
+				attrs: {
-					attrs: {
+					'call-id': callId,
-						'call-id': callId,
+					'call-creator': callFrom,
-						'call-creator': callFrom
+				},
-					},
+				content: acceptContent
-					content: acceptContent
+			}]
-				}
-			]
 		}
 
 		await query(stanza)
@@ -739,8 +740,14 @@ export const makeMessagesRecvSocket = (config: SocketConfig) => {
 	 * @param callCreator - JID of the caller
 	 * @param isVideo - true for video call
 	 */
-	const preacceptCall = async (callId: string, callCreator: string, isVideo?: boolean) => {
+	const preacceptCall = async (
-		const preacceptContent: BinaryNode[] = [{ tag: 'audio', attrs: { rate: '16000', enc: 'opus' }, content: undefined }]
+		callId: string,
+		callCreator: string,
+		isVideo?: boolean,
+	) => {
+		const preacceptContent: BinaryNode[] = [
+			{ tag: 'audio', attrs: { rate: '16000', enc: 'opus' }, content: undefined },
+		]
 
 		if (isVideo) {
 			preacceptContent.push({
@@ -749,7 +756,7 @@ export const makeMessagesRecvSocket = (config: SocketConfig) => {
 					screen_width: '1080',
 					screen_height: '2400',
 					dec: 'H264,H265,AV1',
-					device_orientation: '0'
+					device_orientation: '0',
 				},
 				content: undefined
 			})
@@ -757,25 +764,23 @@ export const makeMessagesRecvSocket = (config: SocketConfig) => {
 
 		preacceptContent.push(
 			{ tag: 'encopt', attrs: { keygen: '2' }, content: undefined },
-			{ tag: 'capability', attrs: { ver: '1' }, content: undefined }
+			{ tag: 'capability', attrs: { ver: '1' }, content: undefined },
 		)
 
 		const stanza: BinaryNode = {
 			tag: 'call',
 			attrs: {
 				to: callCreator,
-				id: randomBytes(16).toString('hex').toUpperCase()
+				id: randomBytes(16).toString('hex').toUpperCase(),
 			},
-			content: [
+			content: [{
-				{
+				tag: 'preaccept',
-					tag: 'preaccept',
+				attrs: {
-					attrs: {
+					'call-id': callId,
-						'call-id': callId,
+					'call-creator': callCreator,
-						'call-creator': callCreator
+				},
-					},
+				content: preacceptContent
-					content: preacceptContent
+			}]
-				}
-			]
 		}
 
 		await query(stanza)
@@ -801,11 +806,11 @@ export const makeMessagesRecvSocket = (config: SocketConfig) => {
 			dlBw?: number
 			ulBw?: number
 		}>,
-		transactionId?: string
+		transactionId?: string,
 	) => {
 		const relayLatencyAttrs: Record<string, string> = {
 			'call-id': callId,
-			'call-creator': callCreator
+			'call-creator': callCreator,
 		}
 
 		if (transactionId) {
@@ -838,15 +843,13 @@ export const makeMessagesRecvSocket = (config: SocketConfig) => {
 			tag: 'call',
 			attrs: {
 				to: callCreator,
-				id: randomBytes(16).toString('hex').toUpperCase()
+				id: randomBytes(16).toString('hex').toUpperCase(),
 			},
-			content: [
+			content: [{
-				{
+				tag: 'relaylatency',
-					tag: 'relaylatency',
+				attrs: relayLatencyAttrs,
-					attrs: relayLatencyAttrs,
+				content: teChildren
-					content: teChildren
+			}]
-				}
-			]
 		}
 
 		await sendNode(stanza)
@@ -867,12 +870,12 @@ export const makeMessagesRecvSocket = (config: SocketConfig) => {
 		callCreator: string,
 		to: string,
 		candidates: Array<{ priority: string; data?: Uint8Array }>,
-		round?: number
+		round?: number,
 	) => {
 		const transportAttrs: Record<string, string> = {
 			'call-id': callId,
 			'call-creator': callCreator,
-			'transport-message-type': '1'
+			'transport-message-type': '1',
 		}
 
 		if (round !== undefined) {
@@ -882,22 +885,20 @@ export const makeMessagesRecvSocket = (config: SocketConfig) => {
 		const teChildren: BinaryNode[] = candidates.map(c => ({
 			tag: 'te',
 			attrs: { priority: c.priority },
-			content: c.data
+			content: c.data,
 		}))
 
 		const stanza: BinaryNode = {
 			tag: 'call',
 			attrs: {
 				to,
-				id: randomBytes(16).toString('hex').toUpperCase()
+				id: randomBytes(16).toString('hex').toUpperCase(),
 			},
-			content: [
+			content: [{
-				{
+				tag: 'transport',
-					tag: 'transport',
+				attrs: transportAttrs,
-					attrs: transportAttrs,
+				content: teChildren
-					content: teChildren
+			}]
-				}
-			]
 		}
 
 		await sendNode(stanza)
@@ -918,27 +919,25 @@ export const makeMessagesRecvSocket = (config: SocketConfig) => {
 		callCreator: string,
 		peer: string,
 		audioDuration: number,
-		callType = '1x1'
+		callType: string = '1x1',
 	) => {
 		const stanza: BinaryNode = {
 			tag: 'call',
 			attrs: {
 				to: 'call',
-				id: randomBytes(16).toString('hex').toUpperCase()
+				id: randomBytes(16).toString('hex').toUpperCase(),
 			},
-			content: [
+			content: [{
-				{
+				tag: 'duration',
-					tag: 'duration',
+				attrs: {
-					attrs: {
+					'call-id': callId,
-						'call-id': callId,
+					'call-creator': callCreator,
-						'call-creator': callCreator,
+					peer,
-						peer,
+					audio_duration: String(audioDuration),
-						audio_duration: String(audioDuration),
+					type: callType,
-						type: callType
+				},
-					},
+				content: undefined
-					content: undefined
+			}]
-				}
-			]
 		}
 
 		await sendNode(stanza)
@@ -953,24 +952,27 @@ export const makeMessagesRecvSocket = (config: SocketConfig) => {
 	 * @param to - destination JID
 	 * @param muted - true to mute, false to unmute
 	 */
-	const muteCall = async (callId: string, callCreator: string, to: string, muted: boolean) => {
+	const muteCall = async (
+		callId: string,
+		callCreator: string,
+		to: string,
+		muted: boolean,
+	) => {
 		const stanza: BinaryNode = {
 			tag: 'call',
 			attrs: {
 				to,
-				id: randomBytes(16).toString('hex').toUpperCase()
+				id: randomBytes(16).toString('hex').toUpperCase(),
 			},
-			content: [
+			content: [{
-				{
+				tag: 'mute_v2',
-					tag: 'mute_v2',
+				attrs: {
-					attrs: {
+					'mute-state': muted ? '1' : '0',
-						'mute-state': muted ? '1' : '0',
+					'call-id': callId,
-						'call-id': callId,
+					'call-creator': callCreator,
-						'call-creator': callCreator
+				},
-					},
+				content: undefined
-					content: undefined
+			}]
-				}
-			]
 		}
 
 		await sendNode(stanza)
@@ -983,23 +985,24 @@ export const makeMessagesRecvSocket = (config: SocketConfig) => {
 	 * @param callId - the call-id (also used as JID with @call)
 	 * @param callCreator - JID of the call creator
 	 */
-	const sendHeartbeat = async (callId: string, callCreator: string) => {
+	const sendHeartbeat = async (
+		callId: string,
+		callCreator: string,
+	) => {
 		const stanza: BinaryNode = {
 			tag: 'call',
 			attrs: {
 				to: `${callId}@call`,
-				id: randomBytes(16).toString('hex').toUpperCase()
+				id: randomBytes(16).toString('hex').toUpperCase(),
 			},
-			content: [
+			content: [{
-				{
+				tag: 'heartbeat',
-					tag: 'heartbeat',
+				attrs: {
-					attrs: {
+					'call-id': callId,
-						'call-id': callId,
+					'call-creator': callCreator,
-						'call-creator': callCreator
+				},
-					},
+				content: undefined
-					content: undefined
+			}]
-				}
-			]
 		}
 
 		await sendNode(stanza)
@@ -1014,27 +1017,30 @@ export const makeMessagesRecvSocket = (config: SocketConfig) => {
 	 * @param to - destination JID
 	 * @param transactionId - transaction ID for the rekey
 	 */
-	const sendEncRekey = async (callId: string, callCreator: string, to: string, transactionId: string) => {
+	const sendEncRekey = async (
+		callId: string,
+		callCreator: string,
+		to: string,
+		transactionId: string,
+	) => {
 		const stanza: BinaryNode = {
 			tag: 'call',
 			attrs: {
 				to,
-				id: randomBytes(16).toString('hex').toUpperCase()
+				id: randomBytes(16).toString('hex').toUpperCase(),
 			},
-			content: [
+			content: [{
-				{
+				tag: 'enc_rekey',
-					tag: 'enc_rekey',
+				attrs: {
-					attrs: {
+					'transaction-id': transactionId,
-						'transaction-id': transactionId,
+					'call-id': callId,
-						'call-id': callId,
+					'call-creator': callCreator,
-						'call-creator': callCreator
+				},
-					},
+				content: [
-					content: [
+					{ tag: 'encopt', attrs: { keygen: '2' }, content: undefined },
-						{ tag: 'encopt', attrs: { keygen: '2' }, content: undefined },
+					{ tag: 'enc', attrs: { v: '2', type: 'msg' }, content: undefined },
-						{ tag: 'enc', attrs: { v: '2', type: 'msg' }, content: undefined }
+				]
-					]
+			}]
-				}
-			]
 		}
 
 		await sendNode(stanza)
@@ -1055,26 +1061,24 @@ export const makeMessagesRecvSocket = (config: SocketConfig) => {
 		callCreator: string,
 		to: string,
 		enabled: boolean,
-		orientation = '1'
+		orientation: string = '1',
 	) => {
 		const stanza: BinaryNode = {
 			tag: 'call',
 			attrs: {
 				to,
-				id: randomBytes(16).toString('hex').toUpperCase()
+				id: randomBytes(16).toString('hex').toUpperCase(),
 			},
-			content: [
+			content: [{
-				{
+				tag: 'video',
-					tag: 'video',
+				attrs: {
-					attrs: {
+					'call-id': callId,
-						'call-id': callId,
+					'call-creator': callCreator,
-						'call-creator': callCreator,
+					state: enabled ? '1' : '0',
-						state: enabled ? '1' : '0',
+					device_orientation: orientation,
-						device_orientation: orientation
+				},
-					},
+				content: undefined
-					content: undefined
+			}]
-				}
-			]
 		}
 
 		await sendNode(stanza)
@@ -1096,17 +1100,15 @@ export const makeMessagesRecvSocket = (config: SocketConfig) => {
 			tag: 'call',
 			attrs: {
 				to: 'call',
-				id: randomBytes(16).toString('hex').toUpperCase()
+				id: randomBytes(16).toString('hex').toUpperCase(),
 			},
-			content: [
+			content: [{
-				{
+				tag: 'link_create',
-					tag: 'link_create',
+				attrs: { media },
-					attrs: { media },
+				content: event
-					content: event
+					? [{ tag: 'event', attrs: { start_time: String(event.startTime) }, content: undefined }]
-						? [{ tag: 'event', attrs: { start_time: String(event.startTime) }, content: undefined }]
+					: undefined
-						: undefined
+			}]
-				}
-			]
 		}
 
 		const response = await query(stanza, timeoutMs)
@@ -1134,7 +1136,9 @@ export const makeMessagesRecvSocket = (config: SocketConfig) => {
 		}
 
 		// URL format verified via Frida capture: https://call.whatsapp.com/<token>
-		const url = token ? `https://call.whatsapp.com/${token}` : undefined
+		const url = token
+			? `https://call.whatsapp.com/${token}`
+			: undefined
 
 		return { token, url, response }
 	}
@@ -1152,15 +1156,13 @@ export const makeMessagesRecvSocket = (config: SocketConfig) => {
 			tag: 'call',
 			attrs: {
 				to: 'call',
-				id: randomBytes(16).toString('hex').toUpperCase()
+				id: randomBytes(16).toString('hex').toUpperCase(),
 			},
-			content: [
+			content: [{
-				{
+				tag: 'link_query',
-					tag: 'link_query',
+				attrs: { media, token },
-					attrs: { media, token },
+				content: undefined
-					content: undefined
+			}]
-				}
-			]
 		}
 
 		return await query(stanza)
@@ -1178,7 +1180,7 @@ export const makeMessagesRecvSocket = (config: SocketConfig) => {
 		const joinContent: BinaryNode[] = [
 			{ tag: 'audio', attrs: { rate: '16000', enc: 'opus' }, content: undefined },
 			{ tag: 'net', attrs: { medium: '2' }, content: undefined },
-			{ tag: 'capability', attrs: { ver: '1' }, content: undefined }
+			{ tag: 'capability', attrs: { ver: '1' }, content: undefined },
 		]
 
 		if (media === 'video') {
@@ -1188,7 +1190,7 @@ export const makeMessagesRecvSocket = (config: SocketConfig) => {
 					screen_width: '1080',
 					screen_height: '2400',
 					dec: 'H264,H265,AV1',
-					device_orientation: '0'
+					device_orientation: '0',
 				},
 				content: undefined
 			})
@@ -1198,15 +1200,13 @@ export const makeMessagesRecvSocket = (config: SocketConfig) => {
 			tag: 'call',
 			attrs: {
 				to: 'call',
-				id: randomBytes(16).toString('hex').toUpperCase()
+				id: randomBytes(16).toString('hex').toUpperCase(),
 			},
-			content: [
+			content: [{
-				{
+				tag: 'link_join',
-					tag: 'link_join',
+				attrs: { media, token },
-					attrs: { media, token },
+				content: joinContent
-					content: joinContent
+			}]
-				}
-			]
 		}
 
 		return await query(stanza)
@@ -1223,7 +1223,7 @@ export const makeMessagesRecvSocket = (config: SocketConfig) => {
 		// For group messages, scope by participant (each participant has its own Signal session).
 		const retryDedupeJid = msgKey.participant
 			? jidNormalizedUser(msgKey.participant)
-			: jidNormalizedUser(node.attrs.from)
+			: jidNormalizedUser(node.attrs.from!)
 		if (retryRequestActiveJids.has(retryDedupeJid)) {
 			logger.debug(
 				{ fromJid: retryDedupeJid, msgId },
@@ -1246,9 +1246,7 @@ export const makeMessagesRecvSocket = (config: SocketConfig) => {
 				// this cleanup only runs as a last resort.
 				// For group messages, use participant JID (Signal sessions are per-participant, not per-group).
 				if (autoCleanCorrupted) {
-					const senderJid = msgKey.participant
+					const senderJid = msgKey.participant ? jidNormalizedUser(msgKey.participant) : jidNormalizedUser(node.attrs.from!)
-						? jidNormalizedUser(msgKey.participant)
-						: jidNormalizedUser(node.attrs.from)
 					try {
 						const decryptionJid = await getDecryptionJid(senderJid, signalRepository)
 						const deletedCount = await cleanupCorruptedSession(decryptionJid, signalRepository, logger)
@@ -1284,9 +1282,7 @@ export const makeMessagesRecvSocket = (config: SocketConfig) => {
 
 				// Safety net cleanup (same as new system above)
 				if (autoCleanCorrupted) {
-					const senderJid = msgKey.participant
+					const senderJid = msgKey.participant ? jidNormalizedUser(msgKey.participant) : jidNormalizedUser(node.attrs.from!)
-						? jidNormalizedUser(msgKey.participant)
-						: jidNormalizedUser(node.attrs.from)
 					try {
 						const decryptionJid = await getDecryptionJid(senderJid, signalRepository)
 						await cleanupCorruptedSession(decryptionJid, signalRepository, logger)
@@ -1468,13 +1464,13 @@ export const makeMessagesRecvSocket = (config: SocketConfig) => {
 							const senderTs = unixTimestampSeconds()
 							logTcToken('reissue', { jid: normalizedJid, reason: 'session_refreshed' })
 							getPrivacyTokens([normalizedJid], senderTs)
-								.then(async iqResult => {
+								.then(async (iqResult) => {
 									await storeTcTokensFromIqResult({
 										result: iqResult,
 										fallbackJid: normalizedJid,
 										keys: authState.keys,
 										getLIDForPN,
-										onNewJidStored: storedJid => {
+										onNewJidStored: (storedJid) => {
 											tcTokenKnownJids.add(storedJid)
 											scheduleTcTokenIndexSave()
 										}
@@ -1520,20 +1516,16 @@ export const makeMessagesRecvSocket = (config: SocketConfig) => {
 		const affectedParticipantPn = getBinaryNodeChild(child, 'participant')?.attrs?.phone_number || actingParticipantPn!
 
 		// Resolve acting participant to PN — prefer inline PN, fall back to LID→PN resolution
-		const actingParticipant = actingParticipantPn || (await resolveLidToPn(actingParticipantLid, lidMapping, logger))
+		const actingParticipant = actingParticipantPn
+			|| await resolveLidToPn(actingParticipantLid, lidMapping, logger)
 
 		// Resolve affected participant to PN
-		const affectedParticipant =
+		const affectedParticipant = affectedParticipantPn
-			affectedParticipantPn || (await resolveLidToPn(affectedParticipantLid, lidMapping, logger))
+			|| await resolveLidToPn(affectedParticipantLid, lidMapping, logger)
 
 		// Store LID↔PN mappings from notification attributes
 		const mappingsToStore: Array<{ lid: string; pn: string }> = []
-		if (
+		if (actingParticipantLid && actingParticipantPn && isLidUser(actingParticipantLid) && isPnUser(actingParticipantPn)) {
-			actingParticipantLid &&
-			actingParticipantPn &&
-			isLidUser(actingParticipantLid) &&
-			isPnUser(actingParticipantPn)
-		) {
 			mappingsToStore.push({ lid: actingParticipantLid, pn: actingParticipantPn })
 		}
 
@@ -1562,7 +1554,7 @@ export const makeMessagesRecvSocket = (config: SocketConfig) => {
 
 				// Resolve metadata owner to PN
 				if (metadata.owner && isLidUser(metadata.owner)) {
-					const resolvedOwner = metadata.ownerPn || (await resolveLidToPn(metadata.owner, lidMapping, logger))
+					const resolvedOwner = metadata.ownerPn || await resolveLidToPn(metadata.owner, lidMapping, logger)
 					if (resolvedOwner) metadata.owner = resolvedOwner
 				}
 
@@ -1596,7 +1588,7 @@ export const makeMessagesRecvSocket = (config: SocketConfig) => {
 			case 'modify':
 				const oldNumbers = await Promise.all(
 					getBinaryNodeChildren(child, 'participant').map(async p => {
-						const resolved = await resolveLidToPn(p.attrs.jid, lidMapping, logger)
+						const resolved = await resolveLidToPn(p.attrs.jid!, lidMapping, logger)
 						return resolved || p.attrs.jid!
 					})
 				)
@@ -1778,7 +1770,7 @@ export const makeMessagesRecvSocket = (config: SocketConfig) => {
 
 				{
 					const rawPictureJid = jidNormalizedUser(node?.attrs?.from) || (setPicture || delPicture)?.attrs?.hash || ''
-					const pictureJid = (await resolveLidToPn(rawPictureJid, signalRepository.lidMapping, logger)) || rawPictureJid
+					const pictureJid = await resolveLidToPn(rawPictureJid, signalRepository.lidMapping, logger) || rawPictureJid
 					ev.emit('contacts.update', [
 						{
 							id: pictureJid,
@@ -1823,8 +1815,7 @@ export const makeMessagesRecvSocket = (config: SocketConfig) => {
 					const blocklists = getBinaryNodeChildren(child, 'item')
 
 					for (const { attrs } of blocklists) {
-						const resolvedBlockJid =
+						const resolvedBlockJid = await resolveLidToPn(attrs.jid!, signalRepository.lidMapping, logger) || attrs.jid!
-							(await resolveLidToPn(attrs.jid, signalRepository.lidMapping, logger)) || attrs.jid!
 						const blocklist = [resolvedBlockJid]
 						const type = attrs.action === 'block' ? 'add' : 'remove'
 						ev.emit('blocklist.update', { blocklist, type })
@@ -2155,8 +2146,7 @@ export const makeMessagesRecvSocket = (config: SocketConfig) => {
 							if (attrs.participant) {
 								const updateKey: keyof MessageUserReceipt =
 									status === proto.WebMessageInfo.Status.DELIVERY_ACK ? 'receiptTimestamp' : 'readTimestamp'
-								const resolvedReceiptUserJid =
+								const resolvedReceiptUserJid = await resolveLidToPn(attrs.participant, lidMapping, logger) || jidNormalizedUser(attrs.participant)
-									(await resolveLidToPn(attrs.participant, lidMapping, logger)) || jidNormalizedUser(attrs.participant)
 								ev.emit(
 									'message-receipt.update',
 									ids.map(id => ({
@@ -2269,7 +2259,13 @@ export const makeMessagesRecvSocket = (config: SocketConfig) => {
 			category,
 			author,
 			decrypt
-		} = decryptMessageNode(node, authState.creds.me!.id, authState.creds.me!.lid || '', signalRepository, logger)
+		} = decryptMessageNode(
+			node,
+			authState.creds.me!.id,
+			authState.creds.me!.lid || '',
+			signalRepository,
+			logger,
+		)
 
 		const alt = msg.key.participantAlt || msg.key.remoteJidAlt
 		// Handle LID/PN mappings with hybrid approach:
@@ -2684,7 +2680,7 @@ export const makeMessagesRecvSocket = (config: SocketConfig) => {
 			jid: u.attrs.jid,
 			state: u.attrs.state,
 			userPn: u.attrs.user_pn,
-			type: u.attrs.type
+			type: u.attrs.type,
 		}))
 	}
 
@@ -2772,7 +2768,9 @@ export const makeMessagesRecvSocket = (config: SocketConfig) => {
 				const callSummary = getBinaryNodeChild(infoChild, 'call_summary')
 				if (callSummary) {
 					call.media = callSummary.attrs.media
-					call.duration = callSummary.attrs.call_duration ? Number(callSummary.attrs.call_duration) : undefined
+					call.duration = callSummary.attrs.call_duration
+						? Number(callSummary.attrs.call_duration)
+						: undefined
 					call.participants = extractParticipants(callSummary)
 				}
 			}
@@ -2816,14 +2814,12 @@ export const makeMessagesRecvSocket = (config: SocketConfig) => {
 			if (resolvedLinkCreator) call.linkCreator = resolvedLinkCreator
 			// Resolve participant JIDs in parallel
 			if (call.participants) {
-				await Promise.all(
+				await Promise.all(call.participants.map(async (p) => {
-					call.participants.map(async p => {
+					if (p.jid) {
-						if (p.jid) {
+						const resolved = p.userPn || await resolveLidToPn(p.jid, callLidMapping, logger)
-							const resolved = p.userPn || (await resolveLidToPn(p.jid, callLidMapping, logger))
+						if (resolved) p.jid = resolved
-							if (resolved) p.jid = resolved
+					}
-						}
+				}))
-					})
-				)
 			}
 
 			ev.emit('call', [call])
@@ -2861,22 +2857,20 @@ export const makeMessagesRecvSocket = (config: SocketConfig) => {
 				// WABA Android: error 463 triggers getPrivacyTokens() fire-and-forget
 				// to ensure token is available for the retry below
 				getPrivacyTokens([jid])
-					.then(async result => {
+					.then(async (result) => {
 						await storeTcTokensFromIqResult({
 							result,
 							fallbackJid: jid,
 							keys: authState.keys,
 							getLIDForPN,
-							onNewJidStored: storedJid => {
+							onNewJidStored: (storedJid) => {
 								tcTokenKnownJids.add(storedJid)
 								scheduleTcTokenIndexSave()
 							}
 						})
 						logTcToken('fetched', { jid, reason: 'error_463' })
 					})
-					.catch(() => {
+					.catch(() => { /* fire-and-forget */ })
-						/* fire-and-forget */
-					})
 
 				// Single-retry: wait 1.5s for the server's tctoken notification to arrive,
 				// then resend. A Set prevents infinite retry loops.
@@ -2917,22 +2911,20 @@ export const makeMessagesRecvSocket = (config: SocketConfig) => {
 				logTcToken('error_479', { jid: jid479, msgId: attrs.id })
 				// WABA Android: error 479 (SmaxInvalid) also triggers token re-fetch
 				getPrivacyTokens([jid479])
-					.then(async result => {
+					.then(async (result) => {
 						await storeTcTokensFromIqResult({
 							result,
 							fallbackJid: jid479,
 							keys: authState.keys,
 							getLIDForPN,
-							onNewJidStored: storedJid => {
+							onNewJidStored: (storedJid) => {
 								tcTokenKnownJids.add(storedJid)
 								scheduleTcTokenIndexSave()
 							}
 						})
 						logTcToken('fetched', { jid: jid479, reason: 'error_479' })
 					})
-					.catch(() => {
+					.catch(() => { /* fire-and-forget */ })
-						/* fire-and-forget */
-					})
 			} else {
 				logger.warn({ attrs }, 'received error in ack')
 			}
@@ -3066,20 +3058,24 @@ export const makeMessagesRecvSocket = (config: SocketConfig) => {
 		// (call link relays may arrive without these attrs — just log them)
 		if (callId && rawCallCreator) {
 			// Resolve LID→PN for call creator
-			const callCreator = (await resolveLidToPn(rawCallCreator, signalRepository.lidMapping, logger)) || rawCallCreator
+			const callCreator = await resolveLidToPn(rawCallCreator, signalRepository.lidMapping, logger) || rawCallCreator
-			logger.debug({ callId, callCreator, uuid: node.attrs.uuid }, 'received relay info')
+			logger.debug(
-			ev.emit('call', [
+				{ callId, callCreator, uuid: node.attrs.uuid },
-				{
+				'received relay info'
-					chatId: callCreator,
+			)
-					from: callCreator,
+			ev.emit('call', [{
-					id: callId,
+				chatId: callCreator,
-					date: new Date(),
+				from: callCreator,
-					offline: false,
+				id: callId,
-					status: 'relay' as WACallUpdateType
+				date: new Date(),
-				}
+				offline: false,
-			])
+				status: 'relay' as WACallUpdateType,
+			}])
 		} else {
-			logger.debug({ attrs: node.attrs }, 'received relay stanza without call-id/call-creator')
+			logger.debug(
+				{ attrs: node.attrs },
+				'received relay stanza without call-id/call-creator'
+			)
 		}
 	})
 

src/Socket/socket.ts

@@ -1361,16 +1361,13 @@ export const makeSocket = (config: SocketConfig) => {
 		const pairPlatformId = isAndroid ? getPlatformId('Chrome') : getPlatformId(browser[1])
 		const pairPlatformDisplay = isAndroid ? 'Chrome (Mac OS)' : `${browser[1]} (${browser[0]})`
 
-		logger.info(
+		logger.info({
-			{
+			pairCode: pairingCode,
-				pairCode: pairingCode,
+			jid: authState.creds.me.id,
-				jid: authState.creds.me.id,
+			companionPlatformId: pairPlatformId,
-				companionPlatformId: pairPlatformId,
+			companionPlatformDisplay: pairPlatformDisplay,
-				companionPlatformDisplay: pairPlatformDisplay,
+			isAndroid,
-				isAndroid
+		}, `pair code requested | companion: ${pairPlatformDisplay} | ${isAndroid ? 'android override -> Chrome' : 'native platform'}`)
-			},
-			`pair code requested | companion: ${pairPlatformDisplay} | ${isAndroid ? 'android override -> Chrome' : 'native platform'}`
-		)
 
 		ev.emit('creds.update', authState.creds)
 		await sendNode({
@@ -1541,9 +1538,7 @@ export const makeSocket = (config: SocketConfig) => {
 	ws.on('CB:success', async (node: BinaryNode) => {
 		const isAndroid = isAndroidBrowser(browser)
 		const phoneId = authState.creds.me?.id?.split(':')[0]?.split('@')[0] || 'new session'
-		logger.info(
+		logger.info(`${isAndroid ? '\uD83D\uDCF1' : '\uD83D\uDDA5\uFE0F'} Connected to WA | ${phoneId} | platform: ${isAndroid ? 'SMB_ANDROID' : 'MACOS'} | device: ${isAndroid ? 'Android' : 'Desktop'} | platformType: ${isAndroid ? 'ANDROID_PHONE' : 'CHROME'}`)
-			`${isAndroid ? '\uD83D\uDCF1' : '\uD83D\uDDA5\uFE0F'} Connected to WA | ${phoneId} | platform: ${isAndroid ? 'SMB_ANDROID' : 'MACOS'} | device: ${isAndroid ? 'Android' : 'Desktop'} | platformType: ${isAndroid ? 'ANDROID_PHONE' : 'CHROME'}`
-		)
 		clearTimeout(qrTimer) // will never happen in all likelyhood -- but just in case WA sends success on first try
 
 		ev.emit('creds.update', { me: { ...authState.creds.me!, lid: node.attrs.lid } })

src/Utils/circuit-breaker.ts

@@ -716,7 +716,7 @@ export function createConnectionCircuitBreaker(customOptions?: Partial<CircuitBr
 	const WS_LIFECYCLE_STATUS_CODES = new Set([
 		428, // connectionClosed
 		408, // connectionLost / timedOut
-		440 // connectionReplaced
+		440, // connectionReplaced
 	])
 
 	return new CircuitBreaker({

src/Utils/decode-wa-message.ts

@@ -13,7 +13,7 @@ import {
 	isJidNewsletter,
 	isJidStatusBroadcast,
 	isLidUser,
-	isPnUser
+	isPnUser,
 	//	transferDevice
 } from '../WABinary'
 import { unpadRandomMax16 } from './generics'
@@ -274,7 +274,7 @@ export const decryptMessageNode = (
 	meId: string,
 	meLid: string,
 	repository: SignalRepositoryWithLIDStore,
-	logger: ILogger
+	logger: ILogger,
 ) => {
 	const { fullMessage, author, sender } = decodeMessageNode(stanza, meId, meLid)
 	return {

src/Utils/generics.ts

@@ -246,7 +246,6 @@ export const fetchLatestBaileysVersion = async (options: RequestInit & { timeout
 		} finally {
 			clearTimeout(timeout)
 		}
-
 		if (!response.ok) {
 			throw new Boom(`Failed to fetch latest Baileys version: ${response.statusText}`, { statusCode: response.status })
 		}

src/Utils/messages-media.ts

@@ -160,7 +160,7 @@ export const extractImageThumb = async (bufferOrFilePath: Readable | Buffer | st
 				height: dimensions.height
 			}
 		}
-	} else if ('jimp' in lib && typeof lib.jimp?.Jimp === 'function') {
+	} else if ('jimp' in lib && (typeof lib.jimp?.Jimp === 'object' || typeof lib.jimp?.Jimp === 'function')) {
 		const jimp = await (lib.jimp.Jimp as any).read(bufferOrFilePath)
 		const dimensions = {
 			width: jimp.width,

src/Utils/messages.ts

@@ -41,12 +41,10 @@ import type { ILogger } from './logger'
 import {
 	downloadContentFromMessage,
 	encryptedStream,
-	extractImageThumb,
 	generateThumbnail,
 	getAudioDuration,
 	getAudioWaveform,
 	getRawMediaUploadData,
-	getStream,
 	type MediaDownloadOptions
 } from './messages-media'
 import { shouldIncludeReportingToken } from './reporting-utils'
@@ -650,49 +648,6 @@ export const generateCarouselMessage = async (
 			if (hasMedia && mediaOptions) {
 				if (card.image) {
 					const { imageMessage } = await prepareWAMessageMedia({ image: card.image }, mediaOptions)
-
-					// Mirror the working Pastorini-style result: every carousel image card should
-					// carry a jpegThumbnail and dimensions before it reaches the Web live renderer.
-					if (imageMessage && (!imageMessage.jpegThumbnail || !imageMessage.height || !imageMessage.width)) {
-						try {
-							const { stream } = await getStream(card.image, mediaOptions.options)
-							const { buffer, original } = await extractImageThumb(stream)
-
-							// eslint-disable-next-line max-depth
-							if (!imageMessage.jpegThumbnail) {
-								imageMessage.jpegThumbnail = buffer.toString('base64')
-							}
-
-							// eslint-disable-next-line max-depth
-							if (!imageMessage.width && original.width) {
-								imageMessage.width = original.width
-							}
-
-							// eslint-disable-next-line max-depth
-							if (!imageMessage.height && original.height) {
-								imageMessage.height = original.height
-							}
-
-							mediaOptions.logger?.info(
-								{
-									cardTitle: card.title,
-									recoveredThumbnail: !!imageMessage.jpegThumbnail,
-									width: imageMessage.width,
-									height: imageMessage.height
-								},
-								'[CAROUSEL] Recovered image metadata from source media'
-							)
-						} catch (error) {
-							mediaOptions.logger?.warn(
-								{
-									cardTitle: card.title,
-									trace: error instanceof Error ? error.stack : String(error)
-								},
-								'[CAROUSEL] Failed source-media thumbnail fallback'
-							)
-						}
-					}
-
 					// Validate image fields needed for WhatsApp rendering
 					if (imageMessage && !imageMessage.jpegThumbnail) {
 						mediaOptions.logger?.warn(
@@ -1273,20 +1228,57 @@ export const generateWAMessageContent = async (
 			options.logger?.info('Sending CTA buttons as nativeFlowMessage with viewOnceMessage wrapper')
 		}
 	}
-	// Check for nativeCarousel
+	// Check for nativeCarousel — inline handler (validated on Android, iOS, Web)
+	// Direct interactiveMessage at root (field 45), NO viewOnceMessage wrapper,
+	// NO messageContextInfo, NO biz/bot stanza nodes needed
 	else if (hasNonNullishProperty(message, 'nativeCarousel')) {
 		const carouselMsg = message as any
-		const carouselOptions: CarouselMessageOptions = {
+		const cards = carouselMsg.nativeCarousel.cards || []
-			cards: carouselMsg.nativeCarousel.cards,
+		const title = carouselMsg.nativeCarousel.title || carouselMsg.title
-			title: carouselMsg.nativeCarousel.title || carouselMsg.title,
+		const text = carouselMsg.text
-			text: carouselMsg.text,
+		const footer = carouselMsg.footer
-			footer: carouselMsg.footer
+
+		const carouselCards = await Promise.all(
+			cards.map(async (card: any) => {
+				const hasMedia = !!(card.image || card.video)
+				const header: any = {
+					title: card.title || '',
+					subtitle: card.footer || '',
+					hasMediaAttachment: hasMedia
+				}
+				if (hasMedia && card.image) {
+					const { imageMessage } = await prepareWAMessageMedia({ image: card.image }, options)
+					if (imageMessage && !imageMessage.height) imageMessage.height = 500
+					if (imageMessage && !imageMessage.width) imageMessage.width = 500
+					header.imageMessage = imageMessage
+				}
+				return {
+					header,
+					body: { text: card.body || '' },
+					footer: card.footer ? { text: card.footer } : undefined,
+					nativeFlowMessage: {
+						buttons: (card.buttons || []).map((btn: any) => {
+							switch (btn.type) {
+								case 'url': return { name: 'cta_url', buttonParamsJson: JSON.stringify({ display_text: btn.text, url: btn.url, merchant_url: btn.url }) }
+								case 'copy': return { name: 'cta_copy', buttonParamsJson: JSON.stringify({ display_text: btn.text, copy_code: btn.copyText }) }
+								case 'call': return { name: 'cta_call', buttonParamsJson: JSON.stringify({ display_text: btn.text, phone_number: btn.phoneNumber }) }
+								default: return { name: 'quick_reply', buttonParamsJson: JSON.stringify({ display_text: btn.text, id: btn.id }) }
+							}
+						})
+					}
+				}
+			})
+		)
+
+		m.interactiveMessage = {
+			header: { title: title || ' ', hasMediaAttachment: false },
+			body: { text: text || '' },
+			footer: footer ? { text: footer } : undefined,
+			carouselMessage: {
+				cards: carouselCards,
+				messageVersion: 1
+			}
 		}
-		// Pass options for media processing if cards have images/videos
-		const generated = await generateCarouselMessage(carouselOptions, options)
-		// Frida capture shows interactiveMessage DIRECT (field 45) in DSM — no viewOnceMessage wrapper
-		// Testing without wrapper: biz node + quality_control already match Pastorini CDP stanza
-		m.interactiveMessage = generated.interactiveMessage
 		return m
 	}
 	// Check for nativeList

src/Utils/process-message.ts

@@ -1,7 +1,6 @@
 /* eslint-disable @typescript-eslint/no-unused-vars */
 import Long from 'long'
 import { proto } from '../../WAProto/index.js'
-import type { LIDMappingStore } from '../Signal/lid-mapping'
 import type {
 	AuthenticationCreds,
 	BaileysEventEmitter,
@@ -20,6 +19,7 @@ import type {
 	WAMessage,
 	WAMessageKey
 } from '../Types'
+import type { LIDMappingStore } from '../Signal/lid-mapping'
 import { WAMessageStubType } from '../Types'
 import { getContentType, normalizeMessageContent } from '../Utils/messages'
 import {
@@ -784,8 +784,7 @@ const processMessage = async (
 			})
 		}
 
-		const participantsIncludesMe = () =>
+		const participantsIncludesMe = () => participants.find(p => areJidsSameUser(meId, p.id) || areJidsSameUser(meId, p.phoneNumber))
-			participants.find(p => areJidsSameUser(meId, p.id) || areJidsSameUser(meId, p.phoneNumber))
 
 		switch (message.messageStubType) {
 			case WAMessageStubType.GROUP_PARTICIPANT_CHANGE_NUMBER:

src/Utils/sticker-pack.ts

@@ -2,7 +2,7 @@ import { Boom } from '@hapi/boom'
 import { createHash } from 'crypto'
 import { zipSync } from 'fflate'
 import { promises as fs } from 'fs'
-import { gunzipSync, gzipSync } from 'zlib'
+import { gzipSync, gunzipSync } from 'zlib'
 import { proto } from '../../WAProto/index.js'
 import type { MediaType } from '../Defaults/index.js'
 import type { StickerPack, WAMediaUpload, WAMediaUploadFunction } from '../Types/Message.js'
@@ -728,9 +728,10 @@ export const prepareStickerPackMessage = async (
 		// Tray icon uses PNG format, 96x96 pixels (official client standard)
 		const lib = await getImageProcessingLibrary()
 		if (!lib?.sharp) {
-			throw new Boom('Sharp library is required for cover/tray icon processing. Install with: yarn add sharp', {
+			throw new Boom(
-				statusCode: 400
+				'Sharp library is required for cover/tray icon processing. Install with: yarn add sharp',
-			})
+				{ statusCode: 400 }
+			)
 		}
 
 		coverWebP = await lib.sharp

src/Utils/tc-token-utils.ts

@@ -158,13 +158,11 @@ export async function storeTcTokensFromIqResult({
 			...existingEntry,
 			token: Buffer.from(tokenNode.content),
 			timestamp: tokenNode.attrs.t,
-			// WABA Android: resets real_issue_timestamp to null when storing a new token
+			// Resets real_issue_timestamp to null when storing a new token
-			// (UPDATE wa_trusted_contacts_send SET real_issue_timestamp=null)
 			realIssueTimestamp: null
 		}
 
 		// Store under resolved storageJid AND under fallbackJid (PN) for reliable lookup
-		// The read path may resolve to a different LID than the store path
 		const normalizedFallback = jidNormalizedUser(fallbackJid)
 		const keysToStore: Record<string, typeof tokenEntry | null> = {
 			[storageJid]: tokenEntry