@badzz88/baileys 8.5.4 → 8.5.5

package/lib/Utils/decode-wa-message.js

@@ -11,12 +11,16 @@ exports.decryptMessageNode =
 		void 0
 exports.decodeMessageNode = decodeMessageNode
 const boom_1 = require('@hapi/boom')
+const index_js_1 = require('../../WAProto/index.js')
 const WAProto_1 = require('../../WAProto/index.js')
 const WABinary_1 = require('../WABinary')
 const generics_1 = require('./generics')
 const meta_ai_msmsg_1 = require('./meta-ai-msmsg')
 const messages_1 = require('./messages')
 const MAX_SECRETS_PER_CHAT = 20
+// Module-level map: outgoing @bot message ID → messageSecret
+// Populated when we receive the outgoing pkmsg/msg to @bot (which contains messageContextInfo.messageSecret)
+// Consumed when the msmsg response from @bot arrives and needs decryption
 const botMessageSecrets = new Map()
 const botRecentSecretsByChat = new Map()
 const pushRecentChatSecret = (chatJid, id, secretBuf) => {
@@ -53,7 +57,7 @@ const getDecryptionJid = async (sender, repository) => {
 		(0, WABinary_1.isHostedLidUser)(sender) ||
 		(0, WABinary_1.isInteropUser)(sender)
 	) {
-		
+		// LID and interop JIDs are session keys themselves — no PN mapping lookup needed
 		return sender
 	}
 	const mapped = await repository.lidMapping.getLIDForPN(sender)
@@ -61,11 +65,12 @@ const getDecryptionJid = async (sender, repository) => {
 }
 exports.getDecryptionJid = getDecryptionJid
 const storeMappingFromEnvelope = async (stanza, sender, repository, decryptionJid, logger) => {
+	// TODO: Handle hosted IDs
 	const { senderAlt } = (0, exports.extractAddressingContext)(stanza)
 	if (
 		senderAlt &&
-		((0, WABinary_1.isLidUser)(senderAlt) || (0, WABinary_1.isHostedLidUser)(senderAlt)) &&
-		((0, WABinary_1.isPnUser)(sender) || (0, WABinary_1.isHostedPnUser)(sender)) &&
+		(0, WABinary_1.isLidUser)(senderAlt) &&
+		(0, WABinary_1.isPnUser)(sender) &&
 		decryptionJid === sender
 	) {
 		try {
@@ -79,14 +84,17 @@ const storeMappingFromEnvelope = async (stanza, sender, repository, decryptionJi
 }
 exports.NO_MESSAGE_FOUND_ERROR_TEXT = 'Message absent from node'
 exports.MISSING_KEYS_ERROR_TEXT = 'Key used already or never filled'
-
+/**
+ * Server-side error codes returned in ack stanzas (server → client).
+ * Distinct from the client-side NackReason enum.
+ */
 exports.SERVER_ERROR_CODES = {
-	
+	/** 1:1 message missing privacy token (tctoken) */
 	MissingTcToken: '463',
-	
+	/** Stanza validation failure (SMAX_INVALID) — likely stale device session */
 	SmaxInvalid: '479'
 }
-
+// Retry configuration for failed decryption
 exports.DECRYPTION_RETRY_CONFIG = {
 	maxRetries: 3,
 	baseDelayMs: 100,
@@ -113,19 +121,19 @@ const extractAddressingContext = stanza => {
 	const sender = stanza.attrs.participant || stanza.attrs.from
 	const addressingMode = stanza.attrs.addressing_mode || (sender?.endsWith('lid') ? 'lid' : 'pn')
 	if (addressingMode === 'lid') {
-		
-		
+		// Message is LID-addressed: sender is LID, extract corresponding PN
+		// without device data
 		senderAlt = stanza.attrs.participant_pn || stanza.attrs.sender_pn || stanza.attrs.peer_recipient_pn
 		recipientAlt = stanza.attrs.recipient_pn
-		
-		
+		// with device data
+		//if (sender && senderAlt) senderAlt = transferDevice(sender, senderAlt)
 	} else {
-		
-		
+		// Message is PN-addressed: sender is PN, extract corresponding LID
+		// without device data
 		senderAlt = stanza.attrs.participant_lid || stanza.attrs.sender_lid || stanza.attrs.peer_recipient_lid
 		recipientAlt = stanza.attrs.recipient_lid
-		
-		
+		//with device data
+		//if (sender && senderAlt) senderAlt = transferDevice(sender, senderAlt)
 	}
 	return {
 		addressingMode,
@@ -134,50 +142,15 @@ const extractAddressingContext = stanza => {
 	}
 }
 exports.extractAddressingContext = extractAddressingContext
-
+/**
+ * Decode the received node as a message.
+ * @note this will only parse the message, not decrypt it
+ */
 function decodeMessageNode(stanza, meId, meLid) {
-	let nodey = []
 	let msgType
 	let chatId
 	let author
 	let fromMe = false
-for (const { tag, attrs, content } of stanza.content) {
-const clean = v => {
-  if (Array.isArray(v)) return v.map(clean);
-
-  if (v && typeof v === "object") {
-    const keys = Object.keys(v);
-
-    if (
-      keys.length &&
-      keys.every(k => /^\d+$/.test(k))
-    ) {
-      return "[bytes]";
-    }
-
-    if (
-      v.type === "Buffer" &&
-      Array.isArray(v.data)
-    ) {
-      return "[bytes]";
-    }
-
-    return Object.fromEntries(
-      Object.entries(v).map(([k, val]) => [k, clean(val)])
-    );
-  }
-
-  return v;
-}
-if (tag !== "plaintext" && tag !== "enc") {
-nodey.push(clean({
-tag: tag,
-attrs: attrs,
-content: content
-}))
-}
-}
-
 	const msgId = stanza.attrs.id
 	const from = stanza.attrs.from
 	const participant = stanza.attrs.participant
@@ -236,9 +209,9 @@ content: content
 		msgType = 'newsletter'
 		chatId = from
 		author = from
-		
-		
-		
+		// if (isMe(from) || isMeLid(from)) {
+		// 	fromMe = true
+		// }
 
 		fromMe = (0, WABinary_1.isJidNewsletter)(from)
 			? !!stanza.attrs?.is_sender
@@ -246,8 +219,8 @@ content: content
 				? (0, WABinary_1.areJidsSameUser)(from, meLid)
 				: (0, WABinary_1.areJidsSameUser)(from, meId)
 	} else if ((0, WABinary_1.isInteropUser)(from)) {
-		
-		
+		// Message from an interop contact (Facebook Messenger / Instagram via WA bridge).
+		// Treat as regular 1:1 chat — same Signal decrypt path as @s.whatsapp.net / @lid.
 		msgType = 'chat'
 		chatId = from
 		author = from
@@ -255,7 +228,7 @@ content: content
 	} else {
 		throw new boom_1.Boom('Unknown message type', { data: stanza })
 	}
-	
+	// Interop stanzas (BirdyChat/Haiket) use display_name instead of notify
 	const pushname = stanza?.attrs?.notify ?? stanza?.attrs?.display_name
 	const key = {
 		remoteJid: chatId,
@@ -279,12 +252,10 @@ content: content
 		broadcast: (0, WABinary_1.isJidBroadcast)(from),
 		newsletter: (0, WABinary_1.isJidNewsletter)(from),
 		StanzaAttrs: stanza.attrs,
-		nodes: nodey,
-		Owner: 'badzz88' 
-
+		Owner: 'xazbails' // Non-WhatsApp attribute
 	}
 	if (key.fromMe) {
-		fullMessage.status = WAProto_1.proto.WebMessageInfo.Status.SERVER_ACK
+		fullMessage.status = index_js_1.proto.WebMessageInfo.Status.SERVER_ACK
 	}
 	if (msgType === 'newsletter') {
 		fullMessage.newsletter_server_id = +stanza.attrs?.server_id
@@ -327,7 +298,7 @@ const decryptMessageNode = (stanza, meId, meLid, repository, logger) => {
 							metaTargetSenderJid = attrs.target_sender_jid
 						}
 						if (tag === 'bot' && attrs && 'edit_target_id' in attrs) {
-							botEditTargetId = attrs.edit_target_id 
+							botEditTargetId = attrs.edit_target_id // Can be '' for 'first' type
 						}
 						if (tag === 'bot' && (attrs === null || attrs === void 0 ? void 0 : attrs.edit)) {
 							botType = attrs.edit
@@ -335,27 +306,14 @@ const decryptMessageNode = (stanza, meId, meLid, repository, logger) => {
 					}
 				}
 
-				
-				
-				
-				const _isGroupEnc = n => n.tag === 'enc' && (n.attrs?.type === 'skmsg' || n.attrs?.type === 'frskmsg')
-				const _stanzaContent = [
-					...stanza.content.filter(n => !_isGroupEnc(n)),
-					...stanza.content.filter(n => _isGroupEnc(n))
-				]
-				for (const { tag, attrs, content } of _stanzaContent) {
+				for (const { tag, attrs, content } of stanza.content) {
 					if (tag === 'verified_name' && content instanceof Uint8Array) {
-						const cert = WAProto_1.proto.VerifiedNameCertificate.decode(content)
-						const details = WAProto_1.proto.VerifiedNameCertificate.Details.decode(cert.details)
+						const cert = index_js_1.proto.VerifiedNameCertificate.decode(content)
+						const details = index_js_1.proto.VerifiedNameCertificate.Details.decode(cert.details)
 						fullMessage.verifiedBizName = details.verifiedName
-						
-						if (attrs?.verified_level) {
-							fullMessage.verifiedNameLevel = attrs.verified_level
-						}
 					}
 					if (tag === 'unavailable' && attrs.type === 'view_once') {
-						fullMessage.key.isViewOnce = true
-						fullMessage.messageStubType = WAProto_1.proto.WebMessageInfo.StubType.VIEWED_ONCE
+						fullMessage.key.isViewOnce = true // TODO: remove from here and add a STUB TYPE
 					}
 					if (attrs.count && tag === 'enc') {
 						fullMessage.retryCount = Number(attrs.count)
@@ -370,15 +328,12 @@ const decryptMessageNode = (stanza, meId, meLid, repository, logger) => {
 					let msgBuffer
 					const decryptionJid = await (0, exports.getDecryptionJid)(author, repository)
 					if (tag !== 'plaintext') {
-						if ((0, WABinary_1.isHostedPnUser)(decryptionJid) || (0, WABinary_1.isHostedLidUser)(decryptionJid)) {
-							fullMessage.isHostedDevice = true
-						}
+						// TODO: Handle hosted devices
 						await storeMappingFromEnvelope(stanza, author, repository, decryptionJid, logger)
 					}
 					try {
 						const e2eType = tag === 'plaintext' ? 'plaintext' : attrs.type
 						switch (e2eType) {
-							case 'frskmsg':
 							case 'skmsg':
 								msgBuffer = await repository.decryptGroupMessage({
 									group: sender,
@@ -387,39 +342,17 @@ const decryptMessageNode = (stanza, meId, meLid, repository, logger) => {
 								})
 								break
 
-							case 'story_reply':
-							case 'feed_reshare':
-							case 'native_flow_response':
-							case 'companion_enc_static':
-							case 'avatar_sticker':
-							case 'genai_sticker':
-							case 'account_authentication_request':
-							case 'motion_video':
-							case 'motion_photo':
 							case 'pkmsg':
-							case 'msg': {
-								const _unicastType =
-									e2eType === 'story_reply' ||
-									e2eType === 'feed_reshare' ||
-									e2eType === 'native_flow_response' ||
-									e2eType === 'companion_enc_static' ||
-									e2eType === 'avatar_sticker' ||
-									e2eType === 'genai_sticker' ||
-									e2eType === 'account_authentication_request' ||
-									e2eType === 'motion_video' ||
-									e2eType === 'motion_photo'
-										? 'msg'
-										: e2eType
+							case 'msg':
 								msgBuffer = await repository.decryptMessage({
 									jid: decryptionJid,
-									type: _unicastType,
+									type: e2eType,
 									ciphertext: content
 								})
 								break
-							}
-							case 'msmsg': 
-								
-								
+							case 'msmsg': //Message Secret Message
+								// null = no bot node (non-streaming), 'full'/'last' = complete response
+								// 'first' = streaming partial response, intentionally skipped
 								if (botType !== null && !['full', 'last'].includes(botType)) break
 								const secretIdCandidates = [botEditTargetId, metaTargetId, fullMessage.key?.id].filter(Boolean)
 								const secretCandidates = []
@@ -455,11 +388,17 @@ const decryptMessageNode = (stanza, meId, meLid, repository, logger) => {
 										participant: author,
 										meId: metaTargetSenderJid || `${meLid.split(`:`)[0]}@lid`,
 										meLid,
+										conversationJid: sender,
+										senderJid: metaTargetSenderJid,
+										botType,
 										botEditTargetId,
 										metaTargetId,
-										stanzaId: stanza.attrs?.id
+										stanzaId: stanza.attrs?.id,
+										targetId: botEditTargetId || metaTargetId || stanza.attrs?.id,
+										targetIdCandidates: secretIdCandidates
 									}
 									let decryptErr
+									const candidateAttemptSummaries = []
 									for (const candidate of secretCandidates) {
 										try {
 											msgBuffer = await (0, meta_ai_msmsg_1.decryptMsmsgBotMessage)(candidate.secret, helperKey, msMsg)
@@ -467,16 +406,24 @@ const decryptMessageNode = (stanza, meId, meLid, repository, logger) => {
 											break
 										} catch (e) {
 											decryptErr = e
+											if (Array.isArray(e?.attemptedStrategies) && e.attemptedStrategies.length) {
+												candidateAttemptSummaries.push({
+													secretSource: candidate.source,
+													attemptedStrategies: e.attemptedStrategies
+												})
+											}
 										}
 									}
-									if (!msgBuffer && decryptErr) {
+									if (!msgBuffer && candidateAttemptSummaries.length) {
 										logger.warn(
 											{
 												secretCandidateSources: secretCandidates.map(candidate => candidate.source),
-												cause: decryptErr?.message
+												attemptsBySecret: candidateAttemptSummaries
 											},
 											'msmsg: helper decryption failed for all candidate secrets'
 										)
+									}
+									if (!msgBuffer && decryptErr) {
 										throw decryptErr
 									}
 								}
@@ -499,16 +446,18 @@ const decryptMessageNode = (stanza, meId, meLid, repository, logger) => {
 						let msg =
 							e2eType === 'msmsg'
 								? (0, meta_ai_msmsg_1.decodeDecryptedMsmsgMessage)(msgBuffer)
-								: WAProto_1.proto.Message.decode(msgToDecode)
+								: index_js_1.proto.Message.decode(msgToDecode)
+						if (false) {
+						}
 						const outerMessageContextInfo = msg.messageContextInfo
 						msg = msg.deviceSentMessage?.message || msg
-						
-						
+						// deviceSentMessage.message may not carry messageContextInfo (e.g. messageSecret for @bot)
+						// even though the outer wrapper does — preserve it
 						if (outerMessageContextInfo && !msg.messageContextInfo) {
 							msg.messageContextInfo = outerMessageContextInfo
 						}
 						if (msg.senderKeyDistributionMessage) {
-							
+							//eslint-disable-next-line max-depth
 							try {
 								await repository.processSenderKeyDistributionMessage({
 									authorJid: author,
@@ -518,200 +467,12 @@ const decryptMessageNode = (stanza, meId, meLid, repository, logger) => {
 								logger.error({ key: fullMessage.key, err }, 'failed to process sender key distribution message')
 							}
 						}
-						if (msg.fastRatchetKeySenderKeyDistributionMessage) {
-							
-							try {
-								await repository.processSenderKeyDistributionMessage({
-									authorJid: author,
-									item: msg.fastRatchetKeySenderKeyDistributionMessage
-								})
-							} catch (err) {
-								logger.error(
-									{ key: fullMessage.key, err },
-									'failed to process fast ratchet sender key distribution message'
-								)
-							}
-						}
 						if (fullMessage.message) {
 							Object.assign(fullMessage.message, msg)
 						} else {
 							fullMessage.message = msg
 						}
-						
-						if (e2eType === 'story_reply') {
-							fullMessage.storyReply = true
-							
-							const quotedJid = msg.extendedTextMessage?.contextInfo?.remoteJid
-							if (quotedJid && (0, WABinary_1.isJidStatusBroadcast)(quotedJid)) {
-								fullMessage.storyReply = true
-							}
-						}
-						
-						if (e2eType === 'feed_reshare') {
-							fullMessage.feedReshare = true
-						}
-						
-						if (attrs.view_once === 'read' || attrs.view_once === 'write') {
-							fullMessage.viewOnceType = attrs.view_once
-						}
-						
-						if (msg.xmaMessage) {
-							fullMessage.xma = msg.xmaMessage
-							fullMessage.messageType = 'xma'
-						}
-						
-						if (e2eType === 'native_flow_response' || msg.nativeFlowResponseMessage) {
-							fullMessage.messageType = 'native_flow_response'
-							if (msg.nativeFlowResponseMessage) {
-								fullMessage.nativeFlowResponse = msg.nativeFlowResponseMessage
-								
-								if (msg.nativeFlowResponseMessage.name === 'md_smb_quick_reply') {
-									fullMessage.smbQuickReply = true
-								}
-							}
-						}
-						
-						if (msg.callPermissionRequestMessage) {
-							fullMessage.messageType = 'call_permission_request'
-							fullMessage.callPermissionRequest = msg.callPermissionRequestMessage
-						}
-						
-						if (msg.productMessage) {
-							fullMessage.messageType = 'product'
-						} else if (msg.orderMessage) {
-							fullMessage.messageType = 'order'
-						} else if (msg.catalogMessage || msg.listMessage?.catalogType) {
-							fullMessage.messageType = 'catalog'
-						}
-						
-						if (msg.paymentMessage) {
-							fullMessage.messageType = 'payment'
-							const pm = msg.paymentMessage
-							fullMessage.paymentInfo = {
-								amount: pm.amount1000 ? pm.amount1000 / 1000 : null,
-								currency: pm.currencyCodeIso4217 || null,
-								status: pm.status || null,
-								transactionTimestamp: pm.transactionTimestamp
-									? pm.transactionTimestamp.toNumber?.() || pm.transactionTimestamp
-									: null,
-								type: pm.type || null,
-								method: pm.paymentMethod || null,
-								futureProofed: pm.futureProofed || false
-							}
-						}
-						if (msg.requestPaymentMessage) {
-							fullMessage.messageType = 'request_payment'
-							fullMessage.paymentRequest = {
-								amount: msg.requestPaymentMessage.amount || null,
-								currency: msg.requestPaymentMessage.currencyCodeIso4217 || null,
-								expiry: msg.requestPaymentMessage.expiryTimestamp || null
-							}
-						}
-						if (msg.sendPaymentMessage) {
-							fullMessage.messageType = 'send_payment'
-						}
-						if (msg.cancelPaymentRequestMessage) {
-							fullMessage.messageType = 'cancel_payment'
-						}
-						
-						if (msg.stickerMessage) {
-							if (msg.stickerMessage.isAvatar) {
-								fullMessage.isAvatarSticker = true
-							}
-							if (msg.stickerMessage.isAiSticker || msg.stickerMessage.isGenAI) {
-								fullMessage.isAiSticker = true
-							}
-						}
-						
-						if (msg.stickerPackMessage) {
-							fullMessage.messageType = 'sticker_pack'
-							const sp = msg.stickerPackMessage
-							fullMessage.stickerPack = {
-								id: sp.stickerPackId,
-								name: sp.name,
-								
-								origin: sp.stickerPackOrigin,
-								size: sp.stickerPackSize,
-								stickers: sp.stickers || []
-							}
-						}
-						
-						if (msg.messageContextInfo?.botMetadata?.aiMediaCollectionMetadata) {
-							fullMessage.aiMediaCollectionMetadata = {
-								collectionId: msg.messageContextInfo.botMetadata.aiMediaCollectionMetadata.collectionId,
-								uploadOrderIndex: msg.messageContextInfo.botMetadata.aiMediaCollectionMetadata.uploadOrderIndex
-							}
-						}
-						
-						if (msg.protocolMessage?.aiMediaCollectionMessage) {
-							fullMessage.messageType = 'ai_media_collection'
-							const amc = msg.protocolMessage.aiMediaCollectionMessage
-							fullMessage.aiMediaCollection = {
-								collectionId: amc.collectionId,
-								expectedMediaCount: amc.expectedMediaCount
-							}
-						}
-						
-						if (msg.splitPaymentMessage) {
-							fullMessage.messageType = 'split_payment'
-							const sp = msg.splitPaymentMessage
-							fullMessage.splitPayment = {
-								splitId: sp.splitId,
-								totalAmount: sp.totalAmount,
-								description: sp.description,
-								requesterJid: sp.requesterJid,
-								participants: (sp.participants || []).map(p => ({
-									jid: p.jid,
-									amount: p.amount,
-									
-									status: p.status
-								})),
-								createdAtMs: sp.createdAtMs ? sp.createdAtMs.toNumber?.() || sp.createdAtMs : null
-							}
-						}
-						
-						if (msg.paymentInviteMessage) {
-							fullMessage.messageType = 'payment_invite'
-							const SERVICE_TYPE = { 0: 'UNKNOWN', 1: 'FBPAY', 2: 'NOVI', 3: 'UPI' }
-							fullMessage.paymentInvite = {
-								serviceType: SERVICE_TYPE[msg.paymentInviteMessage.serviceType] || 'UNKNOWN',
-								expiry: msg.paymentInviteMessage.expiryTimestamp
-									? msg.paymentInviteMessage.expiryTimestamp.toNumber?.() || msg.paymentInviteMessage.expiryTimestamp
-									: null,
-								incentiveEligible: msg.paymentInviteMessage.incentiveEligible || false
-							}
-						}
-						
-						if (msg.paymentReminderMessage) {
-							fullMessage.messageType = 'payment_reminder'
-						}
-						
-						if (e2eType === 'companion_enc_static') {
-							fullMessage.companionEncStatic = true
-						}
-						
-						if (e2eType === 'avatar_sticker' || e2eType === 'genai_sticker') {
-							fullMessage.stickerType = e2eType
-						}
-						
-						if (e2eType === 'account_authentication_request' || msg.accountAuthRequestMessage) {
-							fullMessage.messageType = 'account_auth_request'
-						}
-						
-						if (e2eType === 'motion_video' || (msg.videoMessage && msg.videoMessage.motionVideo)) {
-							fullMessage.messageType = 'motion_video'
-							fullMessage.motionVideo = true
-						}
-						
-						if (e2eType === 'motion_photo' || (msg.imageMessage && msg.imageMessage.motionPhoto)) {
-							fullMessage.messageType = 'motion_photo'
-							fullMessage.motionPhoto = true
-						}
-						
-						if (e2eType === 'plaintext') {
-							fullMessage.isNonE2EE = true
-						}
-						
+						// Auto-decode richResponseMessage text so m.msg.text is populated
 						{
 							const rich = fullMessage.message?.richResponseMessage
 							if (rich && !rich.text) {
@@ -724,7 +485,7 @@ const decryptMessageNode = (stanza, meId, meLid, repository, logger) => {
 								if (decoded) editedRich.text = decoded
 							}
 						}
-						
+						// Save messageSecret for any message (AI group server may set it on any message)
 						{
 							const secret = msg.messageContextInfo?.messageSecret
 							if (secret) {
@@ -744,21 +505,25 @@ const decryptMessageNode = (stanza, meId, meLid, repository, logger) => {
 							isSessionRecordError: isSessionRecordError(err)
 						}
 						logger.error(errorContext, 'failed to decrypt message')
-						fullMessage.messageStubType = WAProto_1.proto.WebMessageInfo.StubType.CIPHERTEXT
+						fullMessage.messageStubType = index_js_1.proto.WebMessageInfo.StubType.CIPHERTEXT
 						fullMessage.messageStubParameters = [err.message.toString()]
 					}
 				}
 			}
-			
+			// if nothing was found to decrypt
 			if (!decryptables && !fullMessage.key?.isViewOnce) {
-				fullMessage.messageStubType = WAProto_1.proto.WebMessageInfo.StubType.CIPHERTEXT
+				fullMessage.messageStubType = index_js_1.proto.WebMessageInfo.StubType.CIPHERTEXT
 				fullMessage.messageStubParameters = [exports.NO_MESSAGE_FOUND_ERROR_TEXT]
 			}
 		}
 	}
 }
 exports.decryptMessageNode = decryptMessageNode
-
+/**
+ * Decode text content from a richResponseMessage (Meta AI).
+ * Tries submessages first, then parses base64 JSON from unifiedResponse.data.
+ * Returns the extracted text string or '' on failure.
+ */
 function decodeRichResponseMessage(richMsg) {
 	try {
 		if (!richMsg) return ''
@@ -782,11 +547,13 @@ function decodeRichResponseMessage(richMsg) {
 			}
 		}
 		return texts.join('\n')
-	} catch {
+	} catch (e) {
 		return ''
 	}
 }
-
+/**
+ * Utility function to check if an error is related to missing session record
+ */
 function isSessionRecordError(error) {
 	const errorMessage = error?.message || error?.toString() || ''
 	return exports.DECRYPTION_RETRY_CONFIG.sessionRecordErrors.some(errorPattern => errorMessage.includes(errorPattern))