@badzz88/baileys 8.5.4 → 8.5.5

package/lib/Utils/generics.js

@@ -41,9 +41,11 @@ exports.bindWaitForEvent = bindWaitForEvent
 exports.trimUndefined = trimUndefined
 exports.bytesToCrockford = bytesToCrockford
 exports.encodeNewsletterMessage = encodeNewsletterMessage
+exports.generateIOSMessageID = void 0
+exports.generateAndroMessageID = void 0
 const boom_1 = require('@hapi/boom')
 const crypto_1 = require('crypto')
-const rb = require('whatsapp-rust-bridge')
+const Crypto_1 = require('./crypto')
 const DEFAULTS_1 = require('../Defaults')
 const index_js_1 = require('../../WAProto/index.js')
 const baileysVersion = DEFAULTS_1.VERSION
@@ -51,14 +53,14 @@ const Types_1 = require('../Types')
 const WABinary_1 = require('../WABinary')
 const crypto_2 = require('./crypto')
 exports.BufferJSON = {
-	
+	// eslint-disable-next-line @typescript-eslint/no-explicit-any
 	replacer: (k, value) => {
 		if (Buffer.isBuffer(value) || value instanceof Uint8Array || value?.type === 'Buffer') {
 			return { type: 'Buffer', data: Buffer.from(value?.data || value).toString('base64') }
 		}
 		return value
 	},
-	
+	// eslint-disable-next-line @typescript-eslint/no-explicit-any
 	reviver: (_, value) => {
 		if (typeof value === 'object' && value !== null && value.type === 'Buffer' && typeof value.data === 'string') {
 			return Buffer.from(value.data, 'base64')
@@ -79,7 +81,7 @@ const getKeyAuthor = (key, meId = 'me') =>
 	(key?.fromMe ? meId : key?.participantAlt || key?.remoteJidAlt || key?.participant || key?.remoteJid) || ''
 exports.getKeyAuthor = getKeyAuthor
 const isStringNullOrEmpty = value =>
-	
+	// eslint-disable-next-line eqeqeq
 	value == null || value === ''
 exports.isStringNullOrEmpty = isStringNullOrEmpty
 const writeRandomPadMax16 = msg => {
@@ -100,7 +102,7 @@ const unpadRandomMax16 = e => {
 	return new Uint8Array(t.buffer, t.byteOffset, t.length - r)
 }
 exports.unpadRandomMax16 = unpadRandomMax16
-
+// code is inspired by whatsmeow
 const generateParticipantHashV2 = participants => {
 	participants.sort()
 	const sha256Hash = (0, crypto_2.sha256)(Buffer.from(participants.join(''))).toString('base64')
@@ -125,7 +127,7 @@ const encodeBigEndian = (e, t = 4) => {
 exports.encodeBigEndian = encodeBigEndian
 const toNumber = t => (typeof t === 'object' && t ? ('toNumber' in t ? t.toNumber() : t.low) : t || 0)
 exports.toNumber = toNumber
-
+/** unix timestamp of a date in seconds */
 const unixTimestampSeconds = (date = new Date()) => Math.floor(date.getTime() / 1000)
 exports.unixTimestampSeconds = unixTimestampSeconds
 const debouncedTimeout = (intervalMs = 1000, task) => {
@@ -175,7 +177,7 @@ async function promiseTimeout(ms, promise) {
 		return new Promise(promise)
 	}
 	const stack = new Error().stack
-	
+	// Create a promise that rejects in <ms> milliseconds
 	const { delay, cancel } = (0, exports.delayCancellable)(ms)
 	const p = new Promise((resolve, reject) => {
 		delay
@@ -194,26 +196,38 @@ async function promiseTimeout(ms, promise) {
 	}).finally(cancel)
 	return p
 }
-
-
-const generateMessageIDV2 = userId => {
-	const data = Buffer.alloc(8 + 20 + 16)
-	data.writeBigUInt64BE(BigInt(Math.floor(Date.now() / 1000)))
-	if (userId) {
-		const id = (0, WABinary_1.jidDecode)(userId)
-		if (id?.user) {
-			data.write(id.user, 8)
-			data.write('@c.us', 8 + id.user.length)
-		}
-	}
-	const random = (0, crypto_1.randomBytes)(16)
-	random.copy(data, 28)
-	const hash = Buffer.from(rb.sha256(data))
-	return '3EB0' + hash.toString('hex').toUpperCase().substring(0, 18)
-}
+// inspired from whatsmeow code
+// https://github.com/tulir/whatsmeow/blob/64bc969fbe78d31ae0dd443b8d4c80a5d026d07a/send.go#L42
+const generateMessageIDV2 = (userId) => {
+    const data = Buffer.alloc(8 + 20 + 16);
+    data.writeBigUInt64BE(BigInt(Math.floor(Date.now() / 1000)));
+    if (userId) {
+        const id = (0, WABinary_1.jidDecode)(userId);
+        if (id?.user) {
+            data.write(id.user, 8);
+            data.write('@c.us', 8 + id.user.length);
+        }
+    }
+    const random = (0, crypto_1.randomBytes)(16);
+    random.copy(data, 28);
+    const hash = (0, crypto_1.createHash)('sha256').update(data).digest();
+    return 'XZCYYX-' + hash.toString('hex').toUpperCase().substring(0, 18);
+};
 exports.generateMessageIDV2 = generateMessageIDV2
-
-const generateMessageID = () => '3EB0' + (0, crypto_1.randomBytes)(18).toString('hex').toUpperCase()
+const generateIOSMessageID = () => {
+    const prefix = '3A';
+    const random = (0, crypto_1.randomBytes)(9.5); // 19 hex chars = 9.5 bytes
+    return (prefix + random.toString('hex')).toUpperCase().substring(0, 21);
+};
+exports.generateIOSMessageID = generateIOSMessageID
+const generateAndroMessageID = () => {
+    const prefix = '3A';
+    const random = (0, crypto_1.randomBytes)(16); // 32 hex chars = 16 bytes
+    return (random.toString('hex')).toUpperCase().substring(0, 21);
+};
+exports.generateAndroMessageID = generateAndroMessageID
+// generate a random ID to attach to a message
+const generateMessageID = () => 'XZCYYX-' + (0, crypto_1.randomBytes)(18).toString('hex').toUpperCase()
 exports.generateMessageID = generateMessageID
 function bindWaitForEvent(ev, event) {
 	return async (check, timeoutMs) => {
@@ -243,33 +257,30 @@ function bindWaitForEvent(ev, event) {
 }
 const bindWaitForConnectionUpdate = ev => bindWaitForEvent(ev, 'connection.update')
 exports.bindWaitForConnectionUpdate = bindWaitForConnectionUpdate
-
+/**
+ * utility that fetches latest baileys version from the master branch.
+ * Use to ensure your WA connection is always on the latest version
+ */
 const fetchLatestBaileysVersion = async (options = {}) => {
 	const URL = 'https://raw.githubusercontent.com/WhiskeySockets/Baileys/master/src/Defaults/index.ts'
 	try {
-		
-		
-		const controller = new AbortController()
-		const timer = setTimeout(() => controller.abort(), options.timeout ?? 5000)
 		const response = await fetch(URL, {
 			dispatcher: options.dispatcher,
 			method: 'GET',
-			headers: options.headers,
-			signal: controller.signal
+			headers: options.headers
 		})
-		clearTimeout(timer)
 		if (!response.ok) {
 			throw new boom_1.Boom(`Failed to fetch latest Baileys version: ${response.statusText}`, {
 				statusCode: response.status
 			})
 		}
 		const text = await response.text()
-		
+		// Extract version from line 7 (const version = [...])
 		const lines = text.split('\n')
-		const versionLine = lines[6] 
+		const versionLine = lines[6] // Line 7 (0-indexed)
 		const versionMatch = versionLine.match(/const version = \[(\d+),\s*(\d+),\s*(\d+)\]/)
 		if (versionMatch) {
-			const version = [parseInt(versionMatch[1], 10), parseInt(versionMatch[2], 10), parseInt(versionMatch[3], 10)]
+			const version = [parseInt(versionMatch[1]), parseInt(versionMatch[2]), parseInt(versionMatch[3])]
 			return {
 				version,
 				isLatest: true
@@ -286,25 +297,24 @@ const fetchLatestBaileysVersion = async (options = {}) => {
 	}
 }
 exports.fetchLatestBaileysVersion = fetchLatestBaileysVersion
-
+/**
+ * A utility that fetches the latest web version of whatsapp.
+ * Use to ensure your WA connection is always on the latest version
+ */
 const fetchLatestWaWebVersion = async (options = {}) => {
 	try {
-		
+		// Absolute minimal headers required to bypass anti-bot detection
 		const defaultHeaders = {
 			'sec-fetch-site': 'none',
 			'user-agent':
 				'Mozilla/5.0 (X11; Linux x86_64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/131.0.0.0 Safari/537.36'
 		}
 		const headers = { ...defaultHeaders, ...options.headers }
-		const controller = new AbortController()
-		const timer = setTimeout(() => controller.abort(), options.timeout ?? 5000)
 		const response = await fetch('https://web.whatsapp.com/sw.js', {
 			...options,
 			method: 'GET',
-			headers,
-			signal: controller.signal
+			headers
 		})
-		clearTimeout(timer)
 		if (!response.ok) {
 			throw new boom_1.Boom(`Failed to fetch sw.js: ${response.statusText}`, { statusCode: response.status })
 		}
@@ -334,7 +344,7 @@ const fetchLatestWaWebVersion = async (options = {}) => {
 	}
 }
 exports.fetchLatestWaWebVersion = fetchLatestWaWebVersion
-
+/** unique message tag prefix for MD clients */
 const generateMdTagPrefix = () => {
 	const bytes = (0, crypto_1.randomBytes)(4)
 	return `${bytes.readUInt16BE()}.${bytes.readUInt16BE(2)}-`
@@ -343,11 +353,13 @@ exports.generateMdTagPrefix = generateMdTagPrefix
 const STATUS_MAP = {
 	sender: index_js_1.proto.WebMessageInfo.Status.SERVER_ACK,
 	played: index_js_1.proto.WebMessageInfo.Status.PLAYED,
-	'played-self': index_js_1.proto.WebMessageInfo.Status.PLAYED,
 	read: index_js_1.proto.WebMessageInfo.Status.READ,
 	'read-self': index_js_1.proto.WebMessageInfo.Status.READ
 }
-
+/**
+ * Given a type of receipt, returns what the new status of the message should be
+ * @param type type from receipt
+ */
 const getStatusFromReceiptType = type => {
 	const status = STATUS_MAP[type]
 	if (typeof type === 'undefined') {
@@ -359,7 +371,10 @@ exports.getStatusFromReceiptType = getStatusFromReceiptType
 const CODE_MAP = {
 	conflict: Types_1.DisconnectReason.connectionReplaced
 }
-
+/**
+ * Stream errors generally provide a reason, map that to a baileys DisconnectReason
+ * @param reason the string reason given, eg. "conflict"
+ */
 const getErrorCodeFromStreamError = node => {
 	const [reasonNode] = (0, WABinary_1.getAllBinaryNodeChildren)(node)
 	let reason = reasonNode?.tag || 'unknown'
@@ -381,31 +396,11 @@ const getCallStatusFromNode = ({ tag, attrs }) => {
 			status = 'offer'
 			break
 		case 'terminate':
-			
-			switch (attrs.reason) {
-				case 'timeout':
-				case 'Timeout':
-					status = 'timeout'
-					break
-				case 'RejectDoNotDisturb':
-					status = 'reject_do_not_disturb'
-					break
-				case 'MicPermissionDenied':
-					status = 'mic_permission_denied'
-					break
-				case 'CameraPermissionDenied':
-					status = 'camera_permission_denied'
-					break
-				case 'RemoteBusy':
-					status = 'remote_busy'
-					break
-				case 'RemoteOffline':
-					status = 'remote_offline'
-					break
-				default:
-					
-					status = 'terminate'
-					break
+			if (attrs.reason === 'timeout') {
+				status = 'timeout'
+			} else {
+				//fired when accepted/rejected/timeout/caller hangs up
+				status = 'terminate'
 			}
 			break
 		case 'reject':
@@ -414,76 +409,6 @@ const getCallStatusFromNode = ({ tag, attrs }) => {
 		case 'accept':
 			status = 'accept'
 			break
-		case 'preaccept':
-			status = 'preaccept'
-			break
-		case 'accept_ack':
-			status = 'accept_ack'
-			break
-		case 'enc-rekey':
-		case 'enc_rekey':
-			status = 'enc_rekey'
-			break
-		case 'peer_state':
-			status = 'peer_state'
-			break
-		case 'group_info':
-			status = 'group_info'
-			break
-		case 'video_state':
-			status = 'video_state'
-			break
-		case 'video_state_ack':
-			status = 'video_state_ack'
-			break
-		case 'flow_control':
-			status = 'flow_control'
-			break
-		case 'relaylatency':
-			status = 'relaylatency'
-			break
-		case 'mute_v2':
-			status = 'mute'
-			break
-		case 'waiting_room_request':
-			status = 'waiting_room_request'
-			break
-		case 'signal':
-			
-			switch (attrs.type) {
-				case '13':
-					status = 'preaccept'
-					break
-				case '15':
-					status = 'video_state'
-					break
-				case '17':
-					status = 'group_info'
-					break
-				case '20':
-					status = 'video_state_ack'
-					break
-				case '21':
-					status = 'flow_control'
-					break
-				case '23':
-					status = 'accept_ack'
-					break
-				case '1002':
-				case '1007':
-					status = 'peer_state'
-					break
-				case '1008':
-					status = 'enc_rekey'
-					break
-				case '12':
-					status = 'mute'
-					break
-				default:
-					status = 'ringing'
-					break
-			}
-			break
 		default:
 			status = 'ringing'
 			break
@@ -500,22 +425,25 @@ const getCodeFromWSError = error => {
 			statusCode = code
 		}
 	} else if (
-		
+		// eslint-disable-next-line @typescript-eslint/no-explicit-any
 		error?.code?.startsWith('E') ||
 		error?.message?.includes('timed out')
 	) {
-		
+		// handle ETIMEOUT, ENOTFOUND etc
 		statusCode = 408
 	}
 	return statusCode
 }
 exports.getCodeFromWSError = getCodeFromWSError
-
+/**
+ * Is the given platform WA business
+ * @param platform AuthenticationCreds.platform
+ */
 const isWABusinessPlatform = platform => {
 	return platform === 'smbi' || platform === 'smba'
 }
 exports.isWABusinessPlatform = isWABusinessPlatform
-
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
 function trimUndefined(obj) {
 	for (const key in obj) {
 		if (typeof obj[key] === 'undefined') {
@@ -546,40 +474,51 @@ function encodeNewsletterMessage(message) {
 	return index_js_1.proto.Message.encode(message).finish()
 }
 
-
+/**
+ * Add human-like jitter to a base delay
+ * @param baseMs base delay in milliseconds
+ * @param varianceFraction fraction of baseMs to use as variance (0–1), default 0.3
+ */
 const jitterDelay = (baseMs, varianceFraction = 0.3) => {
 	const variance = baseMs * varianceFraction
 	return baseMs + (Math.random() * 2 - 1) * variance
 }
 exports.jitterDelay = jitterDelay
 
-
+/**
+ * Compute exponential backoff delay for a given attempt number (0-based)
+ * @param attempt attempt index (0 = first retry)
+ * @param baseMs starting delay in ms (default 500)
+ * @param maxMs maximum delay cap in ms (default 30000)
+ */
 const exponentialBackoff = (attempt, baseMs = 500, maxMs = 30000) => {
 	return Math.min(baseMs * Math.pow(2, attempt), maxMs)
 }
 exports.exponentialBackoff = exponentialBackoff
 
-
+/** Convert buffer/Uint8Array to hex string */
 const bytesToHex = buf => Buffer.from(buf).toString('hex')
 exports.bytesToHex = bytesToHex
 
-
+/** Convert hex string to Buffer */
 const hexToBytes = hex => Buffer.from(hex, 'hex')
 exports.hexToBytes = hexToBytes
 
-
+/** Convert buffer to base64url string */
 const bytesToBase64Url = buf => Buffer.from(buf).toString('base64url')
 exports.bytesToBase64Url = bytesToBase64Url
 
-
+/** Compute SHA-256 hex digest of data */
 const sha256Hex = data => (0, crypto_1.createHash)('sha256').update(data).digest('hex')
 exports.sha256Hex = sha256Hex
 
-
+/** Compute HMAC-SHA-256 of data with key, returns Buffer */
 const hmacSha256 = (data, key) => (0, crypto_1.createHmac)('sha256', key).update(data).digest()
 exports.hmacSha256 = hmacSha256
 
-
+/**
+ * Normalize and deduplicate an array of JIDs
+ */
 const normalizeJidBatch = (jids, normalizer) => {
 	const seen = new Set()
 	const result = []
@@ -595,11 +534,18 @@ const normalizeJidBatch = (jids, normalizer) => {
 }
 exports.normalizeJidBatch = normalizeJidBatch
 
-
+/**
+ * Sleep for a given number of milliseconds, returns a cancellable promise
+ */
 const sleep = ms => new Promise(resolve => setTimeout(resolve, ms))
 exports.sleep = sleep
 
-
+/**
+ * Run an async function with retry using exponential backoff
+ * @param fn async function to retry
+ * @param maxAttempts maximum number of attempts
+ * @param baseDelayMs base delay between retries
+ */
 const withRetry = async (fn, maxAttempts = 3, baseDelayMs = 500) => {
 	let lastErr
 	for (let i = 0; i < maxAttempts; i++) {

package/lib/Utils/group-history.js

@@ -4,7 +4,13 @@ exports.processGroupHistory = exports.decodeGroupHistory = void 0
 const zlib_1 = require('zlib')
 const index_js_1 = require('../../WAProto/index.js')
 
-
+/**
+ * Decode a GroupHistory protobuf blob (community/group history container).
+ * @param buffer raw bytes, optionally zlib-compressed
+ * @param options.inflate try zlib.inflateSync first, falling back to raw bytes (default true)
+ * @param options.withMessageBytes decode the GroupHistoryWithMessageBytes variant,
+ *   expanding each entry's messageBytes into a WebMessageInfo (default false)
+ */
 const decodeGroupHistory = (buffer, options = {}) => {
 	const { inflate = true, withMessageBytes = false } = options
 	if (!Buffer.isBuffer(buffer) && !(buffer instanceof Uint8Array)) {
@@ -15,7 +21,7 @@ const decodeGroupHistory = (buffer, options = {}) => {
 		try {
 			data = zlib_1.inflateSync(data)
 		} catch {
-			
+			// not zlib-compressed — use raw bytes
 		}
 	}
 	if (withMessageBytes) {
@@ -38,7 +44,10 @@ const decodeGroupHistory = (buffer, options = {}) => {
 }
 exports.decodeGroupHistory = decodeGroupHistory
 
-
+/**
+ * Normalize a decoded GroupHistory into stable message buckets.
+ * @param groupHistory a decoded proto.GroupHistory (or the withMessageBytes shape)
+ */
 const processGroupHistory = groupHistory => {
 	const gh = groupHistory || {}
 	return {

package/lib/Utils/history.js

@@ -17,8 +17,8 @@ const inflatePromise = (0, util_1.promisify)(zlib_1.inflate)
 const extractPnFromMessages = messages => {
 	for (const msgItem of messages) {
 		const message = msgItem.message
-		
-		
+		// Only extract from outgoing messages (fromMe: true) in 1:1 chats
+		// because userReceipt.userJid is the recipient's JID
 		if (!message?.key?.fromMe || !message.userReceipt?.length) {
 			continue
 		}
@@ -36,7 +36,7 @@ const downloadHistory = async (msg, options) => {
 		bufferArray.push(chunk)
 	}
 	let buffer = Buffer.concat(bufferArray)
-	
+	// decompress buffer
 	buffer = await inflatePromise(buffer)
 	const syncData = index_js_1.proto.HistorySync.decode(buffer)
 	return syncData
@@ -53,13 +53,13 @@ const processHistoryMessage = (item, logger) => {
 	let globalSettings = undefined
 	let statusV3Messages = undefined
 	logger?.trace({ progress: item.progress }, 'processing history of type ' + item.syncType?.toString())
-	
+	// Extract LID-PN mappings for all sync types
 	for (const m of item.phoneNumberToLidMappings || []) {
 		if (m.lidJid && m.pnJid) {
 			lidPnMappings.push({ lid: m.lidJid, pn: m.pnJid })
 		}
 	}
-	
+	// Extract inline contacts (LID-PN mappings with names)
 	for (const c of item.inlineContacts || []) {
 		if (c.lidJid && c.pnJid) {
 			lidPnMappings.push({ lid: c.lidJid, pn: c.pnJid })
@@ -77,7 +77,7 @@ const processHistoryMessage = (item, logger) => {
 			})
 		}
 	}
-	
+	// Extract call log records with richer metadata
 	for (const rec of item.callLogRecords || []) {
 		callLogRecords.push({
 			...rec,
@@ -89,7 +89,7 @@ const processHistoryMessage = (item, logger) => {
 			timestamp: rec.startTime ? (0, generics_1.toNumber)(rec.startTime) : undefined
 		})
 	}
-	
+	// Extract recent stickers with metadata, deduped by key
 	const stickerKeys = new Set()
 	for (const s of item.recentStickers || []) {
 		const stickerKey = s.fileSha256 ? Buffer.from(s.fileSha256).toString('base64') : undefined
@@ -103,12 +103,12 @@ const processHistoryMessage = (item, logger) => {
 		case index_js_1.proto.HistorySync.HistorySyncType.RECENT:
 		case index_js_1.proto.HistorySync.HistorySyncType.FULL:
 		case index_js_1.proto.HistorySync.HistorySyncType.ON_DEMAND:
-			
+			// Extract global client settings with full field parsing
 			if (item.globalSettings) {
 				const gs = item.globalSettings
 				globalSettings = {
 					...gs,
-					
+					// Parsed convenience fields
 					autoDownloadSettings: {
 						photos: gs.autoDownloadPhotos,
 						audio: gs.autoDownloadAudio,
@@ -139,7 +139,7 @@ const processHistoryMessage = (item, logger) => {
 						: undefined
 				}
 			}
-			
+			// Extract status V3 messages with expiry tracking
 			if (item.statusV3Messages?.length) {
 				const now = Math.floor(Date.now() / 1000)
 				statusV3Messages = item.statusV3Messages.filter(s => {
@@ -165,7 +165,7 @@ const processHistoryMessage = (item, logger) => {
 				} else if (isPn && chat.lidJid) {
 					lidPnMappings.push({ lid: chat.lidJid, pn: chatId })
 				} else if (isLid && !chat.pnJid) {
-					
+					// Fallback: extract PN from userReceipt in messages when pnJid is missing
 					const pnFromReceipt = extractPnFromMessages(chat.messages || [])
 					if (pnFromReceipt) {
 						lidPnMappings.push({ lid: chatId, pn: pnFromReceipt })
@@ -177,7 +177,7 @@ const processHistoryMessage = (item, logger) => {
 					const message = item.message
 					messages.push(message)
 					if (!chat.messages?.length) {
-						
+						// keep only the most recent message in the chat array
 						chat.messages = [{ message }]
 					}
 					if (!message.key.fromMe && !chat.lastMessageRecvTimestamp) {
@@ -194,13 +194,13 @@ const processHistoryMessage = (item, logger) => {
 						})
 					}
 				}
-				
+				// Extract past participants metadata
 				if (chat.id && (0, WABinary_1.isJidGroup)(chat.id)) {
-					
+					// Chat-level past participants info is available via PastParticipants messages
 				}
 				chats.push({ ...chat })
 			}
-			
+			// Extract past participants from dedicated field
 			for (const pp of item.pastParticipants || []) {
 				pastParticipants.push(pp)
 			}

package/lib/Utils/index.js

@@ -28,7 +28,6 @@ var __exportStar =
 Object.defineProperty(exports, '__esModule', { value: true })
 __exportStar(require('./generics'), exports)
 __exportStar(require('./decode-wa-message'), exports)
-__exportStar(require('./message-inspect'), exports)
 __exportStar(require('./messages'), exports)
 __exportStar(require('./messages-media'), exports)
 __exportStar(require('./validate-connection'), exports)
@@ -51,3 +50,8 @@ __exportStar(require('./message-composer'), exports)
 __exportStar(require('./group-history'), exports)
 __exportStar(require('./consumer-application'), exports)
 __exportStar(require('./voip-rekey'), exports)
+__exportStar(require('./companion-reg-client-utils'), exports)
+__exportStar(require('./view-once-cache'), exports)
+__exportStar(require('./sticker'), exports)
+__exportStar(require('./command-loader'), exports)
+__exportStar(require('./session-pool'), exports)

package/lib/Utils/link-preview.js

@@ -55,13 +55,18 @@ exports.getUrlInfo = void 0
 const messages_1 = require('./messages')
 const messages_media_1 = require('./messages-media')
 const THUMBNAIL_WIDTH_PX = 192
-
+/** Fetches an image and generates a thumbnail for it */
 const getCompressedJpegThumbnail = async (url, { thumbnailWidth, fetchOpts }) => {
 	const stream = await (0, messages_media_1.getHttpStream)(url, fetchOpts)
 	const result = await (0, messages_media_1.extractImageThumb)(stream, thumbnailWidth)
 	return result
 }
-
+/**
+ * Given a piece of text, checks for any URL present, generates link preview for the same and returns it
+ * Return undefined if the fetch failed or no URL was found
+ * @param text first matched URL in text
+ * @returns the URL info required to generate link preview
+ */
 const getUrlInfo = async (
 	text,
 	opts = {
@@ -70,7 +75,7 @@ const getUrlInfo = async (
 	}
 ) => {
 	try {
-		
+		// retries
 		const retries = 0
 		const maxRetry = 5
 		const { getLinkPreview } = await Promise.resolve().then(() => __importStar(require('link-preview-js')))

package/lib/Utils/lt-hash.js

@@ -1,6 +1,39 @@
 'use strict'
 Object.defineProperty(exports, '__esModule', { value: true })
 exports.LT_HASH_ANTI_TAMPERING = void 0
-const whatsapp_rust_bridge_1 = require('whatsapp-rust-bridge')
+const crypto_1 = require('./crypto')
 
-exports.LT_HASH_ANTI_TAMPERING = new whatsapp_rust_bridge_1.LTHashAntiTampering()
+/**
+ * LT Hash ("lthash16") is a summation-based homomorphic hash algorithm that
+ * maintains the integrity of a piece of data over a series of mutations. You
+ * can add/remove mutations and it'll return a hash equal to if the same
+ * series of mutations was made sequentially.
+ *
+ * WhatsApp expands each element to 128 bytes via HKDF (info = "WhatsApp Patch
+ * Integrity"), treats that as 64 little-endian uint16 lanes, and combines
+ * elements by adding/subtracting lane-wise mod 2^16 -- this is a pure HKDF +
+ * integer-arithmetic algorithm, no elliptic-curve math involved. Pure-JS,
+ * built on the already-validated `hkdf` implementation.
+ */
+const LTHASH_INFO = 'WhatsApp Patch Integrity'
+const LTHASH_SIZE = 128 // bytes = 64 uint16 lanes
+
+const expand = element => (0, crypto_1.hkdf)(element, LTHASH_SIZE, { info: LTHASH_INFO })
+
+const applyDelta = (result, element, sign) => {
+	const expanded = expand(element)
+	for (let i = 0; i < LTHASH_SIZE; i += 2) {
+		const lane = result.readUInt16LE(i)
+		const delta = expanded.readUInt16LE(i)
+		result.writeUInt16LE((lane + sign * delta) & 0xffff, i)
+	}
+}
+
+exports.LT_HASH_ANTI_TAMPERING = {
+	subtractThenAdd: (base, subtract = [], add = []) => {
+		const result = Buffer.from(base)
+		for (const element of subtract) applyDelta(result, element, -1)
+		for (const element of add) applyDelta(result, element, 1)
+		return result
+	}
+}