@badzz88/baileys 8.5.4 → 8.5.5

package/lib/antiban.js

@@ -23,17 +23,17 @@ var __copyProps = (to, from, except, desc) => {
 var __toESM = (mod, isNodeMode, target) => (
 	(target = mod != null ? __create(__getProtoOf(mod)) : {}),
 	__copyProps(
-		
-		
-		
-		
+		// If the importer is in node compatibility mode or this is not an ESM
+		// file that has been converted to a CommonJS file using a Babel-
+		// compatible transform (i.e. "__esModule" has not been set), then set
+		// "default" to the CommonJS "module.exports" for node compatibility.
 		isNodeMode || !mod || !mod.__esModule ? __defProp(target, 'default', { value: mod, enumerable: true }) : target,
 		mod
 	)
 )
 var __toCommonJS = mod => __copyProps(__defProp({}, '__esModule', { value: true }), mod)
 
-
+// index.js
 var index_exports = {}
 __export(index_exports, {
 	AntiBan: () => AntiBan,
@@ -61,7 +61,6 @@ __export(index_exports, {
 	WebhookAlerts: () => WebhookAlerts,
 	applyFingerprint: () => applyFingerprint,
 	applyGroupMultiplier: () => applyGroupMultiplier,
-	buildContentSignature: () => buildContentSignature,
 	classifyDisconnect: () => classifyDisconnect,
 	createLidFirstResolver: () => createLidFirstResolver,
 	credsSnapshot: () => credsSnapshot,
@@ -83,44 +82,46 @@ __export(index_exports, {
 })
 module.exports = __toCommonJS(index_exports)
 
-
+// rateLimiter.js
 var TIME_CONSTANTS = {
 	MS_PER_SECOND: 1e3,
 	MS_PER_MINUTE: 6e4,
 	MS_PER_HOUR: 36e5,
 	MS_PER_DAY: 864e5,
 	BURST_RESET_MS: 3e4,
-	IDENTICAL_WINDOW_MS: 18e5
-	
+	IDENTICAL_WINDOW_MS: 36e5
+	// 1 hour
 }
 var DEFAULT_CONFIG = {
-	maxPerMinute: 12,
-	maxPerHour: 400,
-	maxPerDay: 2500,
-	minDelayMs: 1200,
-	maxDelayMs: 4e3,
-	newChatDelayMs: 2e3,
-	maxIdenticalMessages: 10,
-	burstAllowance: 5,
+	maxPerMinute: 8,
+	maxPerHour: 200,
+	maxPerDay: 1500,
+	minDelayMs: 1500,
+	maxDelayMs: 5e3,
+	newChatDelayMs: 3e3,
+	maxIdenticalMessages: 3,
+	burstAllowance: 3,
 	identicalMessageWindowMs: TIME_CONSTANTS.IDENTICAL_WINDOW_MS
 }
 var RateLimiter = class {
 	config
 	messages = []
-	identicalCount =  new Map()
-	knownChats =  new Set()
+	identicalCount = /* @__PURE__ */ new Map()
+	knownChats = /* @__PURE__ */ new Set()
 	burstCount = 0
 	lastMessageTime = 0
-	statsCacheTime = 0
-	statsCache = null
 	constructor(config = {}) {
 		this.config = { ...DEFAULT_CONFIG, ...config }
 	}
-	
-	async getDelay(recipient, content, dedupKey) {
+	/**
+	 * Calculate delay before next message can be sent.
+	 * Returns 0 if message can be sent immediately.
+	 * Returns -1 if message should be blocked entirely.
+	 */
+	async getDelay(recipient, content) {
 		const now = Date.now()
 		this.cleanup(now)
-		const contentHash = this.hashContent(dedupKey !== undefined ? dedupKey : content)
+		const contentHash = this.hashContent(content)
 		const dayMessages = this.messages.filter(m => now - m.timestamp < TIME_CONSTANTS.MS_PER_DAY)
 		if (dayMessages.length >= this.config.maxPerDay) {
 			return -1
@@ -166,14 +167,16 @@ var RateLimiter = class {
 		if (timeSinceLast < this.config.minDelayMs) {
 			delay = Math.max(delay, this.config.minDelayMs - timeSinceLast)
 		}
-		const typingDelay = Math.min((content?.length || 0) * 15, 2e3)
+		const typingDelay = Math.min(content.length * 30, 3e3)
 		delay += this.jitter(typingDelay * 0.5, typingDelay)
 		return Math.round(delay)
 	}
-	
-	record(recipient, content, dedupKey) {
+	/**
+	 * Record a sent message
+	 */
+	record(recipient, content) {
 		const now = Date.now()
-		const contentHash = this.hashContent(dedupKey !== undefined ? dedupKey : content)
+		const contentHash = this.hashContent(content)
 		const timeSinceLast = now - this.lastMessageTime
 		if (timeSinceLast > TIME_CONSTANTS.BURST_RESET_MS) {
 			this.burstCount = 0
@@ -193,26 +196,16 @@ var RateLimiter = class {
 			this.identicalCount.set(contentHash, { count: 1, firstSeen: now, lastSeen: now })
 		}
 	}
-	
+	/**
+	 * Get current usage stats
+	 */
 	getStats() {
 		const now = Date.now()
-		if (this.statsCache && now - this.statsCacheTime < 100) {
-			return this.statsCache
-		}
 		this.cleanup(now)
-		let lastMinute = 0
-		let lastHour = 0
-		let lastDay = 0
-		for (const m of this.messages) {
-			const age = now - m.timestamp
-			if (age < TIME_CONSTANTS.MS_PER_MINUTE) lastMinute++
-			if (age < TIME_CONSTANTS.MS_PER_HOUR) lastHour++
-			if (age < TIME_CONSTANTS.MS_PER_DAY) lastDay++
-		}
-		this.statsCache = {
-			lastMinute,
-			lastHour,
-			lastDay,
+		return {
+			lastMinute: this.messages.filter(m => now - m.timestamp < TIME_CONSTANTS.MS_PER_MINUTE).length,
+			lastHour: this.messages.filter(m => now - m.timestamp < TIME_CONSTANTS.MS_PER_HOUR).length,
+			lastDay: this.messages.filter(m => now - m.timestamp < TIME_CONSTANTS.MS_PER_DAY).length,
 			limits: {
 				perMinute: this.config.maxPerMinute,
 				perHour: this.config.maxPerHour,
@@ -220,14 +213,12 @@ var RateLimiter = class {
 			},
 			knownChats: this.knownChats.size
 		}
-		this.statsCacheTime = now
-		return this.statsCache
 	}
-	
+	/** Get the set of known chat JIDs (for state persistence) */
 	getKnownChats() {
 		return this.knownChats
 	}
-	
+	/** Restore known chats from persisted state */
 	restoreKnownChats(chats) {
 		for (const jid of chats) {
 			this.knownChats.add(jid)
@@ -241,7 +232,7 @@ var RateLimiter = class {
 			}
 		}
 	}
-	
+	/** Random delay between min and max (gaussian-ish distribution) */
 	jitter(min, max) {
 		const u1 = Math.random()
 		const u2 = Math.random()
@@ -250,7 +241,7 @@ var RateLimiter = class {
 		const clamped = Math.max(0, Math.min(1, normalized))
 		return Math.round(min + clamped * (max - min))
 	}
-	
+	/** Simple hash for content dedup */
 	hashContent(content) {
 		let hash = 0
 		for (let i = 0; i < content.length; i++) {
@@ -262,12 +253,12 @@ var RateLimiter = class {
 	}
 }
 
-
+// warmup.js
 var DEFAULT_CONFIG2 = {
-	warmUpDays: 5,
-	day1Limit: 30,
+	warmUpDays: 7,
+	day1Limit: 20,
 	growthFactor: 1.8,
-	inactivityThresholdHours: 168
+	inactivityThresholdHours: 72
 }
 var WarmUp = class {
 	config
@@ -276,7 +267,9 @@ var WarmUp = class {
 		this.config = { ...DEFAULT_CONFIG2, ...config }
 		this.state = existingState || this.freshState()
 	}
-	
+	/**
+	 * Get the current daily message limit based on warm-up phase
+	 */
 	getDailyLimit() {
 		if (this.state.graduated) return Infinity
 		const day = this.getCurrentDay()
@@ -286,7 +279,9 @@ var WarmUp = class {
 		}
 		return Math.round(this.config.day1Limit * Math.pow(this.config.growthFactor, day))
 	}
-	
+	/**
+	 * Check if a message can be sent (within warm-up limits)
+	 */
 	canSend() {
 		this.checkInactivity()
 		if (this.state.graduated) return true
@@ -294,7 +289,9 @@ var WarmUp = class {
 		const todayCount = this.state.dailyCounts[day] || 0
 		return todayCount < this.getDailyLimit()
 	}
-	
+	/**
+	 * Record a sent message
+	 */
 	record() {
 		const now = Date.now()
 		const day = this.getCurrentDay()
@@ -304,7 +301,9 @@ var WarmUp = class {
 		this.state.dailyCounts[day]++
 		this.state.lastActiveAt = now
 	}
-	
+	/**
+	 * Get current warm-up status
+	 */
 	getStatus() {
 		const day = this.getCurrentDay()
 		const todaySent = this.state.dailyCounts[day] || 0
@@ -318,11 +317,15 @@ var WarmUp = class {
 			progress: this.state.graduated ? 100 : Math.round((day / this.config.warmUpDays) * 100)
 		}
 	}
-	
+	/**
+	 * Export state for persistence
+	 */
 	exportState() {
 		return { ...this.state }
 	}
-	
+	/**
+	 * Reset warm-up (e.g., after detected ban risk)
+	 */
 	reset() {
 		this.state = this.freshState()
 	}
@@ -347,7 +350,7 @@ var WarmUp = class {
 	}
 }
 
-
+// health.js
 var DEFAULT_CONFIG3 = {
 	disconnectWarningThreshold: 3,
 	disconnectCriticalThreshold: 5,
@@ -365,7 +368,9 @@ var HealthMonitor = class {
 	constructor(config = {}) {
 		this.config = { ...DEFAULT_CONFIG3, ...config }
 	}
-	
+	/**
+	 * Record a disconnection event
+	 */
 	recordDisconnect(reason) {
 		const reasonStr = String(reason)
 		if (reasonStr === '403' || reasonStr === 'forbidden') {
@@ -387,25 +392,33 @@ var HealthMonitor = class {
 		}
 		this.checkAndNotify()
 	}
-	
+	/**
+	 * Record a successful reconnection
+	 */
 	recordReconnect() {
 		this.events.push({ type: 'reconnect', timestamp: Date.now() })
 	}
-	
+	/**
+	 * Record a failed message send
+	 */
 	recordMessageFailed(error) {
 		this.events.push({ type: 'messageFailed', timestamp: Date.now(), detail: error })
 		this.lastBadEventTime = Date.now()
 		this.lastEventWasSevere = false
 		this.checkAndNotify()
 	}
-	
+	/**
+	 * Record a 463 reachout timelock error
+	 */
 	recordReachoutTimelock(detail) {
 		this.events.push({ type: 'reachoutTimelocked', timestamp: Date.now(), detail })
 		this.lastBadEventTime = Date.now()
 		this.lastEventWasSevere = false
 		this.checkAndNotify()
 	}
-	
+	/**
+	 * Get current health status
+	 */
 	getStatus() {
 		const now = Date.now()
 		this.cleanup(now)
@@ -481,18 +494,24 @@ var HealthMonitor = class {
 			}
 		}
 	}
-	
+	/**
+	 * Check if sending should be paused
+	 */
 	isPaused() {
 		if (this.paused) return true
 		const status = this.getStatus()
 		const riskOrder = ['low', 'medium', 'high', 'critical']
 		return riskOrder.indexOf(status.risk) >= riskOrder.indexOf(this.config.autoPauseAt)
 	}
-	
+	/**
+	 * Manually pause/resume
+	 */
 	setPaused(paused) {
 		this.paused = paused
 	}
-	
+	/**
+	 * Reset all tracked events
+	 */
 	reset() {
 		this.events = []
 		this.startTime = Date.now()
@@ -513,7 +532,7 @@ var HealthMonitor = class {
 	}
 }
 
-
+// timelockGuard.js
 var DEFAULT_CONFIG4 = {
 	resumeBufferMs: 1e4
 }
@@ -523,21 +542,23 @@ var TimelockGuard = class {
 		isActive: false,
 		errorCount: 0
 	}
-	knownChats =  new Set()
+	knownChats = /* @__PURE__ */ new Set()
 	resumeTimer = null
 	timerGeneration = 0
-	
+	// BUG FIX 4: Track timer validity to prevent race conditions
 	constructor(config = {}) {
 		this.config = { ...DEFAULT_CONFIG4, ...config }
 	}
-	
+	/**
+	 * Update timelock state from Baileys connection.update event
+	 */
 	onTimelockUpdate(data) {
 		const wasActive = this.state.isActive
 		this.state.isActive = !!data.isActive
 		this.state.enforcementType = data.enforcementType
 		this.state.expiresAt = data.timeEnforcementEnds
 		if (this.state.isActive && !wasActive) {
-			this.state.detectedAt =  new Date()
+			this.state.detectedAt = /* @__PURE__ */ new Date()
 			this.state.errorCount = 0
 			this.config.onTimelockDetected?.(this.getState())
 			this.scheduleResume()
@@ -549,28 +570,36 @@ var TimelockGuard = class {
 			this.config.onTimelockLifted?.(this.getState())
 		}
 	}
-	
+	/**
+	 * Record a 463 error from a failed send
+	 */
 	record463Error() {
 		this.state.errorCount++
 		if (!this.state.isActive) {
 			this.state.isActive = true
-			this.state.detectedAt =  new Date()
+			this.state.detectedAt = /* @__PURE__ */ new Date()
 			this.state.expiresAt = new Date(Date.now() + 6e4)
 			this.config.onTimelockDetected?.(this.getState())
 			this.scheduleResume()
 		}
 	}
-	
+	/**
+	 * Register a JID as a known/existing chat (has tctoken / prior history)
+	 */
 	registerKnownChat(jid) {
 		this.knownChats.add(jid)
 	}
-	
+	/**
+	 * Register multiple known chats at once (e.g. from chat list on connect)
+	 */
 	registerKnownChats(jids) {
 		for (const jid of jids) {
 			this.knownChats.add(jid)
 		}
 	}
-	
+	/**
+	 * Check if a message to this recipient should be allowed
+	 */
 	canSend(jid) {
 		if (!this.state.isActive) {
 			return { allowed: true }
@@ -594,11 +623,15 @@ var TimelockGuard = class {
 			reason: `Reachout timelocked (${this.state.enforcementType || 'unknown'}). New contacts blocked. Expires in ${Math.ceil(expiresIn / 1e3)}s.`
 		}
 	}
-	
+	/**
+	 * Get current timelock state
+	 */
 	getState() {
 		return { ...this.state }
 	}
-	
+	/**
+	 * Check if currently timelocked
+	 */
 	isTimelocked() {
 		if (!this.state.isActive) return false
 		if (this.state.expiresAt) {
@@ -610,11 +643,15 @@ var TimelockGuard = class {
 		}
 		return true
 	}
-	
+	/**
+	 * Get the set of known chat JIDs
+	 */
 	getKnownChats() {
 		return new Set(this.knownChats)
 	}
-	
+	/**
+	 * Manually lift the timelock
+	 */
 	lift() {
 		if (this.state.isActive) {
 			this.state.isActive = false
@@ -622,7 +659,9 @@ var TimelockGuard = class {
 			this.config.onTimelockLifted?.(this.getState())
 		}
 	}
-	
+	/**
+	 * Reset all state
+	 */
 	reset() {
 		this.state = { isActive: false, errorCount: 0 }
 		this.knownChats.clear()
@@ -652,7 +691,7 @@ var TimelockGuard = class {
 	}
 }
 
-
+// replyRatio.js
 var DEFAULT_CONFIG5 = {
 	enabled: false,
 	minRatio: 0.1,
@@ -664,11 +703,14 @@ var DEFAULT_CONFIG5 = {
 }
 var ReplyRatioGuard = class {
 	config
-	contacts =  new Map()
+	contacts = /* @__PURE__ */ new Map()
 	constructor(config = {}) {
 		this.config = { ...DEFAULT_CONFIG5, ...config }
 	}
-	
+	/**
+	 * Check if message can be sent to this contact based on reply ratio.
+	 * Call before sending.
+	 */
 	beforeSend(jid) {
 		if (!this.config.enabled) {
 			return { allowed: true }
@@ -699,14 +741,18 @@ var ReplyRatioGuard = class {
 		}
 		return { allowed: true }
 	}
-	
+	/**
+	 * Record an outbound message sent to this contact.
+	 */
 	recordSent(jid) {
 		if (!this.config.enabled) return
 		const record = this.contacts.get(jid) || { sent: 0, received: 0 }
 		record.sent++
 		this.contacts.set(jid, record)
 	}
-	
+	/**
+	 * Record an inbound message received from this contact.
+	 */
 	recordReceived(jid) {
 		if (!this.config.enabled) return
 		const record = this.contacts.get(jid) || { sent: 0, received: 0 }
@@ -714,7 +760,11 @@ var ReplyRatioGuard = class {
 		delete record.cooledUntil
 		this.contacts.set(jid, record)
 	}
-	
+	/**
+	 * Suggest whether to send an auto-reply to this incoming message.
+	 * Returns { shouldReply: true, suggestedText: '👍' } if probability check passes.
+	 * Caller is responsible for actually sending the message.
+	 */
 	suggestReply(jid, _msgText) {
 		if (!this.config.enabled) {
 			return { shouldReply: false }
@@ -729,7 +779,9 @@ var ReplyRatioGuard = class {
 		}
 		return { shouldReply: false }
 	}
-	
+	/**
+	 * Get statistics for all contacts and global metrics.
+	 */
 	getStats() {
 		const perContact = Array.from(this.contacts.entries()).map(([jid, record]) => ({
 			jid,
@@ -750,49 +802,60 @@ var ReplyRatioGuard = class {
 			contactsOnCooldown
 		}
 	}
-	
+	/**
+	 * Reset all counters.
+	 */
 	reset() {
 		this.contacts.clear()
 	}
-	
+	/**
+	 * Export state for persistence.
+	 */
 	exportState() {
 		return {
 			contacts: Array.from(this.contacts.entries())
 		}
 	}
-	
+	/**
+	 * Restore state from persistence.
+	 */
 	restoreState(state) {
 		if (state?.contacts && Array.isArray(state.contacts)) {
 			this.contacts = new Map(state.contacts)
 		}
 	}
-	
+	/**
+	 * Check if JID is a group.
+	 */
 	isGroup(jid) {
 		return jid.endsWith('@g.us')
 	}
 }
 
-
+// contactGraph.js
 var DEFAULT_CONFIG6 = {
 	enabled: false,
 	requireHandshakeBeforeGroupSend: true,
 	handshakeMinDelayMs: 36e5,
-	
+	// 1 hour
 	groupLurkPeriodMs: 432e5,
-	
+	// 12 hours
 	maxStrangerMessagesPerDay: 5,
 	autoRegisterOnIncoming: true
 }
 var ContactGraphWarmer = class {
 	config
-	contacts =  new Map()
-	groups =  new Map()
+	contacts = /* @__PURE__ */ new Map()
+	groups = /* @__PURE__ */ new Map()
 	strangerMessagesToday = 0
 	lastStrangerResetDay = this.getCurrentDay()
 	constructor(config = {}) {
 		this.config = { ...DEFAULT_CONFIG6, ...config }
 	}
-	
+	/**
+	 * Check if message can be sent to this contact/group.
+	 * Returns { allowed: false, needsHandshake: true } if handshake required.
+	 */
 	canMessage(jid) {
 		if (!this.config.enabled) {
 			return { allowed: true }
@@ -807,7 +870,9 @@ var ContactGraphWarmer = class {
 		}
 		return this.checkIndividualMessage(jid)
 	}
-	
+	/**
+	 * Mark handshake as sent to this contact.
+	 */
 	markHandshakeSent(jid) {
 		if (!this.config.enabled) return
 		if (this.isGroup(jid)) return
@@ -816,7 +881,9 @@ var ContactGraphWarmer = class {
 		record.handshakeSentAt = Date.now()
 		this.contacts.set(jid, record)
 	}
-	
+	/**
+	 * Mark handshake as complete with this contact.
+	 */
 	markHandshakeComplete(jid) {
 		if (!this.config.enabled) return
 		if (this.isGroup(jid)) return
@@ -824,7 +891,9 @@ var ContactGraphWarmer = class {
 		record.state = 'handshake_complete'
 		this.contacts.set(jid, record)
 	}
-	
+	/**
+	 * Register a contact as known (skip handshake requirement).
+	 */
 	registerKnownContact(jid) {
 		if (!this.config.enabled) return
 		if (this.isGroup(jid)) return
@@ -832,18 +901,24 @@ var ContactGraphWarmer = class {
 		record.state = 'known'
 		this.contacts.set(jid, record)
 	}
-	
+	/**
+	 * Register a group join event.
+	 */
 	registerGroupJoin(groupJid) {
 		if (!this.config.enabled) return
 		if (!this.isGroup(groupJid)) return
 		this.groups.set(groupJid, { joinedAt: Date.now() })
 	}
-	
+	/**
+	 * Get contact state.
+	 */
 	getContactState(jid) {
 		if (this.isGroup(jid)) return 'known'
 		return this.contacts.get(jid)?.state || 'stranger'
 	}
-	
+	/**
+	 * Handle incoming message — auto-register if enabled.
+	 */
 	onIncomingMessage(jid) {
 		if (!this.config.enabled) return
 		if (this.isGroup(jid)) return
@@ -851,7 +926,9 @@ var ContactGraphWarmer = class {
 			this.registerKnownContact(jid)
 		}
 	}
-	
+	/**
+	 * Get statistics.
+	 */
 	getStats() {
 		const knownContacts = Array.from(this.contacts.values()).filter(c => c.state === 'known').length
 		const pendingHandshakes = Array.from(this.contacts.values()).filter(c => c.state === 'handshake_sent').length
@@ -867,14 +944,18 @@ var ContactGraphWarmer = class {
 			groupsJoined
 		}
 	}
-	
+	/**
+	 * Reset all state.
+	 */
 	reset() {
 		this.contacts.clear()
 		this.groups.clear()
 		this.strangerMessagesToday = 0
 		this.lastStrangerResetDay = this.getCurrentDay()
 	}
-	
+	/**
+	 * Export state for persistence.
+	 */
 	exportState() {
 		return {
 			contacts: Array.from(this.contacts.entries()),
@@ -883,7 +964,9 @@ var ContactGraphWarmer = class {
 			lastStrangerResetDay: this.lastStrangerResetDay
 		}
 	}
-	
+	/**
+	 * Restore state from persistence.
+	 */
 	restoreState(state) {
 		if (state?.contacts && Array.isArray(state.contacts)) {
 			this.contacts = new Map(state.contacts)
@@ -898,7 +981,7 @@ var ContactGraphWarmer = class {
 			this.lastStrangerResetDay = state.lastStrangerResetDay
 		}
 	}
-	
+	// Private helpers
 	isGroup(jid) {
 		return jid.endsWith('@g.us')
 	}
@@ -952,7 +1035,7 @@ var ContactGraphWarmer = class {
 	}
 }
 
-
+// presenceChoreographer.js
 var DEFAULT_CONFIG7 = {
 	enabled: false,
 	enableCircadianRhythm: true,
@@ -985,60 +1068,60 @@ var DEFAULT_CONFIG7 = {
 var ACTIVITY_CURVES = {
 	office: [
 		0.1, 0.1, 0.1, 0.1, 0.1, 0.1, 0.1, 0.1,
-		
+		// 0-7: night quiet
 		0.5, 0.5,
-		
+		// 8-9: morning ramp
 		0.95, 0.95,
-		
+		// 10-11: morning peak
 		0.6,
-		
+		// 12: lunch dip
 		0.9, 0.9, 0.9, 0.9,
-		
+		// 13-16: afternoon
 		0.6, 0.6,
-		
+		// 17-18: wind-down
 		0.4, 0.4,
-		
+		// 19-20: evening
 		0.2, 0.2, 0.2, 0.2
-		
+		// 21-24: taper
 	],
 	social: [
 		0.1, 0.1, 0.1, 0.1, 0.1, 0.1, 0.1, 0.1,
-		
+		// 0-7: night quiet
 		0.3, 0.4,
-		
+		// 8-9: slow start
 		0.7, 0.8,
-		
+		// 10-11: ramp up
 		0.5,
-		
+		// 12: lunch
 		0.7, 0.7,
-		
+		// 13-14: afternoon
 		0.4,
-		
+		// 15: tea time dip
 		0.8, 0.9, 0.9,
-		
+		// 16-18: active
 		0.6,
-		
+		// 19: dinner dip
 		0.8, 0.85, 0.9, 0.95, 1
-		
+		// 20-24: evening peak
 	],
 	global: [
 		0.5, 0.5, 0.5, 0.5, 0.5, 0.5,
-		
+		// 0-5: night
 		0.4, 0.4,
-		
+		// 6-7: dawn dip
 		0.6, 0.7, 0.8, 0.8,
-		
+		// 8-11: morning
 		0.6,
-		
+		// 12: lunch
 		0.8, 0.8, 0.8, 0.8,
-		
+		// 13-16: afternoon
 		0.7, 0.7,
-		
+		// 17-18: evening
 		0.6, 0.5, 0.5, 0.5, 0.5, 0.5
-		
+		// 19-24: night taper
 	]
 }
-function getCircadianMultiplier(date =  new Date(), profile = 'default', timezone) {
+function getCircadianMultiplier(date = /* @__PURE__ */ new Date(), profile = 'default', timezone) {
 	if (profile === 'always_on') {
 		return 1
 	}
@@ -1103,7 +1186,11 @@ var PresenceChoreographer = class {
 			}
 		}
 	}
-	
+	/**
+	 * Get current activity factor (0.1 to 1.0).
+	 * Higher = more active = shorter delays.
+	 * If circadian disabled, returns 1.0.
+	 */
 	getCurrentActivityFactor() {
 		if (!this.config.enabled || !this.config.enableCircadianRhythm) {
 			return 1
@@ -1112,7 +1199,10 @@ var PresenceChoreographer = class {
 		const curve = ACTIVITY_CURVES[this.config.activityCurve]
 		return curve[hour] || 0.5
 	}
-	
+	/**
+	 * Check if should pause for distraction.
+	 * Returns { pause: true, durationMs: 600000 } if probability check passes.
+	 */
 	shouldPauseForDistraction() {
 		if (!this.config.enabled) {
 			return { pause: false, durationMs: 0 }
@@ -1124,7 +1214,10 @@ var PresenceChoreographer = class {
 		}
 		return { pause: false, durationMs: 0 }
 	}
-	
+	/**
+	 * Check if should take offline gap.
+	 * Returns { offline: true, durationMs: 600000 } if probability check passes.
+	 */
 	shouldTakeOfflineGap() {
 		if (!this.config.enabled) {
 			return { offline: false, durationMs: 0 }
@@ -1136,7 +1229,12 @@ var PresenceChoreographer = class {
 		}
 		return { offline: false, durationMs: 0 }
 	}
-	
+	/**
+	 * Check if should mark message as read.
+	 * Returns { mark: false } if skip probability hit.
+	 * Returns { mark: true, delayMs: 5000 } otherwise.
+	 * Applies circadian multiplier to delay.
+	 */
 	shouldMarkRead() {
 		if (!this.config.enabled) {
 			return { mark: true, delayMs: 0 }
@@ -1149,7 +1247,7 @@ var PresenceChoreographer = class {
 		let delayMs = baseDelayMs
 		if (this.config.circadian.enabled) {
 			const circadianMultiplier = getCircadianMultiplier(
-				 new Date(),
+				/* @__PURE__ */ new Date(),
 				this.config.circadian.profile,
 				this.config.circadian.timezone
 			)
@@ -1158,7 +1256,18 @@ var PresenceChoreographer = class {
 		this.stats.readReceiptsDelayed++
 		return { mark: true, delayMs }
 	}
-	
+	/**
+	 * Compute realistic typing duration for a message of given length.
+	 * Includes Gaussian WPM variance + think-pause injection + circadian timing multiplier.
+	 * Returns a "typing plan": array of { state, durationMs } steps the caller should execute sequentially.
+	 *
+	 *   plan = [
+	 *     { state: 'composing', durationMs: 4200 },
+	 *     { state: 'paused',    durationMs: 950 },   // think pause
+	 *     { state: 'composing', durationMs: 6800 },
+	 *     { state: 'paused',    durationMs: 600 },   // brief stop before send
+	 *   ]
+	 */
 	computeTypingPlan(messageLength) {
 		if (!this.config.enabled || !this.config.enableTypingModel) {
 			return [{ state: 'composing', durationMs: this.config.typingMinMs }]
@@ -1173,7 +1282,7 @@ var PresenceChoreographer = class {
 		let circadianMultiplier = 1
 		if (this.config.circadian.enabled) {
 			circadianMultiplier = getCircadianMultiplier(
-				 new Date(),
+				/* @__PURE__ */ new Date(),
 				this.config.circadian.profile,
 				this.config.circadian.timezone
 			)
@@ -1216,7 +1325,13 @@ var PresenceChoreographer = class {
 		}
 		return plan
 	}
-	
+	/**
+	 * Execute a typing plan against a Baileys-shaped sock with sendPresenceUpdate(state, jid).
+	 * Awaits each step's duration. Updates stats.
+	 *
+	 *   await choreo.executeTypingPlan(sock, jid, plan);
+	 *   await sock.sendMessage(jid, content);
+	 */
 	async executeTypingPlan(sock, jid, plan, options) {
 		this.stats.typingPlansExecuted++
 		for (const step of plan) {
@@ -1229,7 +1344,9 @@ var PresenceChoreographer = class {
 			this.stats.totalTypingTimeMs += step.durationMs
 		}
 	}
-	
+	/**
+	 * Get statistics.
+	 */
 	getStats() {
 		return {
 			currentActivityFactor: this.getCurrentActivityFactor(),
@@ -1243,7 +1360,9 @@ var PresenceChoreographer = class {
 			totalTypingTimeMs: this.stats.totalTypingTimeMs
 		}
 	}
-	
+	/**
+	 * Reset statistics.
+	 */
 	reset() {
 		this.stats = {
 			distractionPausesInjected: 0,
@@ -1255,7 +1374,7 @@ var PresenceChoreographer = class {
 			totalTypingTimeMs: 0
 		}
 	}
-	
+	// Private helpers
 	getLocalHour() {
 		try {
 			const formatter = new Intl.DateTimeFormat('en-US', {
@@ -1263,13 +1382,13 @@ var PresenceChoreographer = class {
 				hour: 'numeric',
 				hour12: false
 			})
-			const parts = formatter.formatToParts( new Date())
+			const parts = formatter.formatToParts(/* @__PURE__ */ new Date())
 			const hourPart = parts.find(p => p.type === 'hour')
 			if (hourPart) {
 				return parseInt(hourPart.value, 10)
 			}
 		} catch (error) {}
-		return  new Date().getUTCHours()
+		return /* @__PURE__ */ new Date().getUTCHours()
 	}
 	randomBetween(min, max) {
 		return Math.floor(Math.random() * (max - min + 1)) + min
@@ -1277,7 +1396,10 @@ var PresenceChoreographer = class {
 	clamp(value, min, max) {
 		return Math.max(min, Math.min(max, value))
 	}
-	
+	/**
+	 * Generate Gaussian sample using Box-Muller transform.
+	 * Returns a sample from N(mean, stdDev).
+	 */
 	gaussianSample(mean, stdDev) {
 		const u1 = Math.random()
 		const u2 = Math.random()
@@ -1289,7 +1411,7 @@ var PresenceChoreographer = class {
 	}
 }
 
-
+// retryTracker.js
 var DEFAULT_CONFIG8 = {
 	enabled: false,
 	maxRetries: 5,
@@ -1298,7 +1420,7 @@ var DEFAULT_CONFIG8 = {
 }
 var RetryReasonTracker = class {
 	config
-	retries =  new Map()
+	retries = /* @__PURE__ */ new Map()
 	totalRetries = 0
 	reasonCounts = {
 		no_session: 0,
@@ -1316,7 +1438,10 @@ var RetryReasonTracker = class {
 	constructor(config) {
 		this.config = { ...DEFAULT_CONFIG8, ...config }
 	}
-	
+	/**
+	 * Call when a messages.update event arrives with a status/error.
+	 * Classifies and records the retry.
+	 */
 	onMessageUpdate(update) {
 		if (!this.config.enabled) return
 		const msgId = update.key?.id
@@ -1325,7 +1450,9 @@ var RetryReasonTracker = class {
 		const reason = this.classify(update.error || update)
 		this.recordRetry(msgId, reason)
 	}
-	
+	/**
+	 * Classify an arbitrary error object into a RetryReason
+	 */
 	classify(err) {
 		if (!err) return 'unknown'
 		const statusCode = err.output?.statusCode || err.statusCode || err.status
@@ -1342,7 +1469,9 @@ var RetryReasonTracker = class {
 		if (errorMsg.includes('malformed') || errorMsg.includes('invalid node')) return 'node_malformed'
 		return 'unknown'
 	}
-	
+	/**
+	 * Record a retry for a message
+	 */
 	recordRetry(msgId, reason) {
 		const now = Date.now()
 		let record = this.retries.get(msgId)
@@ -1366,16 +1495,22 @@ var RetryReasonTracker = class {
 			this.config.onSpiral(msgId, reason)
 		}
 	}
-	
+	/**
+	 * Should we warn the user this message is spiraling?
+	 */
 	isSpiraling(msgId) {
 		const record = this.retries.get(msgId)
 		return record ? record.count >= this.config.spiralThreshold : false
 	}
-	
+	/**
+	 * Reset counters for a specific message (call on successful delivery)
+	 */
 	clear(msgId) {
 		this.retries.delete(msgId)
 	}
-	
+	/**
+	 * Get current stats
+	 */
 	getStats() {
 		return {
 			totalRetries: this.totalRetries,
@@ -1384,7 +1519,9 @@ var RetryReasonTracker = class {
 			activeRetries: this.retries.size
 		}
 	}
-	
+	/**
+	 * Clean up old retry records (>5 minutes old)
+	 */
 	cleanup() {
 		const now = Date.now()
 		const maxAge = 5 * 60 * 1e3
@@ -1394,14 +1531,16 @@ var RetryReasonTracker = class {
 			}
 		}
 	}
-	
+	/**
+	 * Destroy and clean up
+	 */
 	destroy() {
 		this.retries.clear()
 		this.cleanup()
 	}
 }
 
-
+// reconnectThrottle.js
 var DEFAULT_CONFIG9 = {
 	enabled: false,
 	rampDurationMs: 6e4,
@@ -1416,11 +1555,11 @@ var PostReconnectThrottle = class {
 	lifetimeReconnects = 0
 	rampTimer = null
 	currentStep = 0
-	
+	// Tracking sends in current window
 	sendsInCurrentWindow = 0
 	currentWindowStart = 0
 	WINDOW_DURATION_MS = 6e4
-	
+	// 1 minute window
 	constructor(config) {
 		this.config = {
 			...DEFAULT_CONFIG9,
@@ -1428,7 +1567,9 @@ var PostReconnectThrottle = class {
 			baselineRatePerMinute: config?.baselineRatePerMinute || null
 		}
 	}
-	
+	/**
+	 * Call when connection is re-established. Starts throttle window.
+	 */
 	onReconnect() {
 		if (!this.config.enabled) return
 		this.throttledSince = Date.now()
@@ -1442,9 +1583,13 @@ var PostReconnectThrottle = class {
 		}
 		this.scheduleNextRampStep()
 	}
-	
+	/**
+	 * Call when connection drops (optional — reset state).
+	 */
 	onDisconnect() {}
-	
+	/**
+	 * Schedule the next ramp step
+	 */
 	scheduleNextRampStep() {
 		if (this.currentStep >= this.config.rampSteps) {
 			this.throttledSince = null
@@ -1457,7 +1602,9 @@ var PostReconnectThrottle = class {
 			this.scheduleNextRampStep()
 		}, stepDuration)
 	}
-	
+	/**
+	 * Returns current rate multiplier (1.0 = no throttle)
+	 */
 	getCurrentMultiplier() {
 		if (!this.config.enabled || !this.throttledSince) {
 			return 1
@@ -1470,7 +1617,9 @@ var PostReconnectThrottle = class {
 		const multiplier = this.config.initialRateMultiplier + (1 - this.config.initialRateMultiplier) * progress
 		return Math.min(1, multiplier)
 	}
-	
+	/**
+	 * Checks if a send should be gated. Returns {allowed, reason, retryAfterMs?}
+	 */
 	beforeSend() {
 		if (!this.config.enabled || !this.throttledSince) {
 			return { allowed: true }
@@ -1499,7 +1648,9 @@ var PostReconnectThrottle = class {
 		this.throttledSendCount++
 		return { allowed: true }
 	}
-	
+	/**
+	 * Get current stats
+	 */
 	getStats() {
 		const multiplier = this.getCurrentMultiplier()
 		const isThrottled = this.throttledSince !== null && multiplier < 1
@@ -1516,7 +1667,9 @@ var PostReconnectThrottle = class {
 			lifetimeReconnects: this.lifetimeReconnects
 		}
 	}
-	
+	/**
+	 * Destroy and clean up timers
+	 */
 	destroy() {
 		if (this.rampTimer) {
 			clearTimeout(this.rampTimer)
@@ -1526,7 +1679,7 @@ var PostReconnectThrottle = class {
 	}
 }
 
-
+// lidResolver.js
 var DEFAULT_CONFIG10 = {
 	canonical: 'pn',
 	maxEntries: 1e4
@@ -1534,10 +1687,10 @@ var DEFAULT_CONFIG10 = {
 var LidResolver = class {
 	config
 	persistence
-	
-	lidToPn =  new Map()
-	pnToLid =  new Map()
-	
+	// Bidirectional maps: lid→pn and pn→lid
+	lidToPn = /* @__PURE__ */ new Map()
+	pnToLid = /* @__PURE__ */ new Map()
+	// pn → lid (for quick reverse lookup)
 	stats = {
 		learnedFromEvents: 0,
 		lookupsServed: 0,
@@ -1550,7 +1703,10 @@ var LidResolver = class {
 			void this.hydrate()
 		}
 	}
-	
+	/**
+	 * Learn from a message event. Idempotent.
+	 * Accepts partial mappings — will use whatever fields are available.
+	 */
 	learn(mapping) {
 		let lid = mapping.lid ? this.normalizeJid(mapping.lid) : void 0
 		let pn = mapping.pn ? this.normalizeJid(mapping.pn) : void 0
@@ -1588,7 +1744,10 @@ var LidResolver = class {
 			void this.flush()
 		}
 	}
-	
+	/**
+	 * Given any form (LID or PN), return the canonical form.
+	 * Falls back to input if unknown (no throw).
+	 */
 	resolveCanonical(jid) {
 		const normalized = this.normalizeJid(jid)
 		if (this.config.canonical === 'pn') {
@@ -1622,7 +1781,9 @@ var LidResolver = class {
 			return normalized
 		}
 	}
-	
+	/**
+	 * Lookup partner form. Returns null if unknown.
+	 */
 	getLid(pn) {
 		const normalized = this.normalizeJid(pn)
 		const lid = this.pnToLid.get(normalized)
@@ -1643,7 +1804,9 @@ var LidResolver = class {
 		}
 		return null
 	}
-	
+	/**
+	 * Full mapping for inspection
+	 */
 	getMapping(jid) {
 		const normalized = this.normalizeJid(jid)
 		const byLid = this.lidToPn.get(normalized)
@@ -1661,7 +1824,9 @@ var LidResolver = class {
 		}
 		return null
 	}
-	
+	/**
+	 * Seed from persistence (called automatically in constructor if persistence provided)
+	 */
 	async hydrate() {
 		if (!this.persistence?.load) return
 		try {
@@ -1688,7 +1853,9 @@ var LidResolver = class {
 			}
 		} catch (error) {}
 	}
-	
+	/**
+	 * Flush current map to persistence
+	 */
 	async flush() {
 		if (!this.persistence?.save) return
 		try {
@@ -1708,7 +1875,9 @@ var LidResolver = class {
 			canonicalForm: this.config.canonical
 		}
 	}
-	
+	/**
+	 * Clear everything
+	 */
 	reset() {
 		this.lidToPn.clear()
 		this.pnToLid.clear()
@@ -1724,12 +1893,16 @@ var LidResolver = class {
 			void this.flush()
 		}
 	}
-	
-	
+	// Private helpers
+	/**
+	 * Normalize JID: strip device suffix `:N`
+	 */
 	normalizeJid(jid) {
 		return jid.replace(/:\d+@/, '@')
 	}
-	
+	/**
+	 * Evict least recently accessed mapping (LRU)
+	 */
 	evictLRU() {
 		let oldestLid = null
 		let oldestTime = Infinity
@@ -1749,7 +1922,7 @@ var LidResolver = class {
 	}
 }
 
-
+// jidCanonicalizer.js
 var DEFAULT_CONFIG11 = {
 	enabled: false,
 	canonicalizeOutbound: true,
@@ -1759,7 +1932,7 @@ var JidCanonicalizer = class {
 	config
 	lidResolver
 	ownsResolver
-	
+	// Track if we created the resolver (for destroy)
 	stats = {
 		outboundCanonicalized: 0,
 		outboundPassthrough: 0,
@@ -1777,11 +1950,15 @@ var JidCanonicalizer = class {
 			this.ownsResolver = true
 		}
 	}
-	
+	/**
+	 * Access the underlying resolver (for cross-module sharing)
+	 */
 	get resolver() {
 		return this.lidResolver
 	}
-	
+	/**
+	 * Called by wrapper on every outbound send. Returns canonical JID.
+	 */
 	canonicalizeTarget(jid) {
 		if (!this.config.enabled || !this.config.canonicalizeOutbound) {
 			return jid
@@ -1794,7 +1971,22 @@ var JidCanonicalizer = class {
 		}
 		return canonical
 	}
-	
+	/**
+	 * Returns a stable, canonical thread key for storage / DB indexing.
+	 *
+	 * Different from `canonicalizeTarget()` (which picks the right send target):
+	 * - canonicalizeTarget('1234@lid') → '+27...@s.whatsapp.net' (best send target)
+	 * - canonicalKey('1234@lid')      → 'thread:27...'  (stable thread identifier)
+	 *
+	 * If LID has known PN mapping → use phone-number form
+	 * If only LID known → use LID stripped of suffix
+	 * Always lowercase, no @-suffix, prefixed with `thread:`
+	 *
+	 * Apps using this as their DB key won't double-thread on LID/PN drift.
+	 *
+	 * @param jid - WhatsApp JID (can be PN, LID, group, or broadcast)
+	 * @returns Stable thread key for DB indexing
+	 */
 	canonicalKey(jid) {
 		if (!jid || typeof jid !== 'string' || jid.trim() === '') {
 			return 'thread:invalid'
@@ -1832,7 +2024,9 @@ var JidCanonicalizer = class {
 		}
 		return `thread:${domain}:${user}`
 	}
-	
+	/**
+	 * Called by wrapper on messages.upsert event. Learns mappings.
+	 */
 	onIncomingEvent(upsert) {
 		if (!this.config.enabled || !this.config.learnFromEvents) {
 			return
@@ -1841,7 +2035,9 @@ var JidCanonicalizer = class {
 			this.learnFromMessage(msg)
 		}
 	}
-	
+	/**
+	 * Called by wrapper on messages.update event. Learns from sent-message refs.
+	 */
 	onMessageUpdate(updates) {
 		if (!this.config.enabled || !this.config.learnFromEvents) {
 			return
@@ -1867,8 +2063,10 @@ var JidCanonicalizer = class {
 			this.lidResolver.destroy()
 		}
 	}
-	
-	
+	// Private helpers
+	/**
+	 * Extract LID↔PN mappings from a message object
+	 */
 	learnFromMessage(msg) {
 		if (!msg.key) return
 		this.learnFromMessageKey(msg.key)
@@ -1880,7 +2078,9 @@ var JidCanonicalizer = class {
 			this.stats.inboundLearned++
 		}
 	}
-	
+	/**
+	 * Extract mappings from message.key
+	 */
 	learnFromMessageKey(key) {
 		if (!key) return
 		if (key.participant && key.participantPn) {
@@ -1913,7 +2113,7 @@ var JidCanonicalizer = class {
 	}
 }
 
-
+// sessionStability.js
 function classifyDisconnect(statusCode) {
 	if (statusCode === 401 || statusCode === 440) {
 		return {
@@ -1952,7 +2152,7 @@ function classifyDisconnect(statusCode) {
 			category: 'recoverable',
 			shouldReconnect: true,
 			backoffMs: 3e4,
-			
+			// 30 seconds
 			message: 'Precondition failed \u2014 auth state mismatch, retry after delay',
 			code: statusCode
 		}
@@ -1962,7 +2162,7 @@ function classifyDisconnect(statusCode) {
 			category: 'rate-limited',
 			shouldReconnect: true,
 			backoffMs: 3e5,
-			
+			// 5 minutes
 			message: 'Rate limited by WhatsApp \u2014 cool-off period required',
 			code: statusCode
 		}
@@ -1972,7 +2172,7 @@ function classifyDisconnect(statusCode) {
 			category: 'rate-limited',
 			shouldReconnect: true,
 			backoffMs: 6e4,
-			
+			// 1 minute
 			message: 'WhatsApp service unavailable \u2014 temporary outage',
 			code: statusCode
 		}
@@ -1982,7 +2182,7 @@ function classifyDisconnect(statusCode) {
 			category: 'recoverable',
 			shouldReconnect: true,
 			backoffMs: 5e3,
-			
+			// 5 seconds
 			message: 'Connection timeout \u2014 network issue, safe to retry',
 			code: statusCode
 		}
@@ -1992,7 +2192,7 @@ function classifyDisconnect(statusCode) {
 			category: 'recoverable',
 			shouldReconnect: true,
 			backoffMs: 1e4,
-			
+			// 10 seconds
 			message: 'WhatsApp internal error \u2014 temporary server issue',
 			code: statusCode
 		}
@@ -2002,7 +2202,7 @@ function classifyDisconnect(statusCode) {
 			category: 'recoverable',
 			shouldReconnect: true,
 			backoffMs: 2e3,
-			
+			// 2 seconds
 			message: 'Connection closed gracefully \u2014 safe to reconnect',
 			code: statusCode
 		}
@@ -2011,7 +2211,7 @@ function classifyDisconnect(statusCode) {
 		category: 'unknown',
 		shouldReconnect: true,
 		backoffMs: 15e3,
-		
+		// 15 seconds
 		message: `Unknown disconnect reason (code ${statusCode}) \u2014 reconnect with caution`,
 		code: statusCode
 	}
@@ -2036,12 +2236,16 @@ var SessionHealthMonitor = class {
 		this.onDegraded = config.onDegraded
 		this.onRecovered = config.onRecovered
 	}
-	
+	/**
+	 * Record successful decrypt
+	 */
 	recordDecryptSuccess() {
 		this.stats.decryptSuccess++
 		this.checkRecovery()
 	}
-	
+	/**
+	 * Record failed decrypt (Bad MAC or similar)
+	 */
 	recordDecryptFail(isBadMac = false) {
 		this.stats.decryptFail++
 		if (isBadMac) {
@@ -2058,7 +2262,9 @@ var SessionHealthMonitor = class {
 			}
 		}
 	}
-	
+	/**
+	 * Check if session has recovered from degraded state
+	 */
 	checkRecovery() {
 		if (!this.stats.isDegraded) return
 		const now = Date.now()
@@ -2070,11 +2276,15 @@ var SessionHealthMonitor = class {
 			this.onRecovered?.(this.getStats())
 		}
 	}
-	
+	/**
+	 * Get current health stats
+	 */
 	getStats() {
 		return { ...this.stats }
 	}
-	
+	/**
+	 * Reset all counters
+	 */
 	reset() {
 		this.stats = {
 			decryptSuccess: 0,
@@ -2107,51 +2317,51 @@ function wrapWithSessionStability(sock, config = {}) {
 	})
 }
 
-
+// presets.js
 var PRESETS = {
 	conservative: {
-		maxPerMinute: 6,
-		maxPerHour: 150,
-		maxPerDay: 1000,
-		minDelayMs: 2000,
-		maxDelayMs: 6e3,
-		newChatDelayMs: 3e3,
-		warmupDays: 7,
-		day1Limit: 20,
+		maxPerMinute: 5,
+		maxPerHour: 100,
+		maxPerDay: 800,
+		minDelayMs: 2500,
+		maxDelayMs: 7e3,
+		newChatDelayMs: 4e3,
+		warmupDays: 10,
+		day1Limit: 15,
 		growthFactor: 1.8,
-		inactivityThresholdHours: 120,
-		autoPauseAt: 'high',
+		inactivityThresholdHours: 72,
+		autoPauseAt: 'medium',
 		groupMultiplier: 0.5,
 		groupProfiles: false,
 		logging: true
 	},
 	moderate: {
-		maxPerMinute: 15,
-		maxPerHour: 500,
-		maxPerDay: 3e3,
-		minDelayMs: 1e3,
-		maxDelayMs: 4e3,
-		newChatDelayMs: 2e3,
-		warmupDays: 5,
-		day1Limit: 30,
+		maxPerMinute: 10,
+		maxPerHour: 300,
+		maxPerDay: 1500,
+		minDelayMs: 1500,
+		maxDelayMs: 5e3,
+		newChatDelayMs: 3e3,
+		warmupDays: 7,
+		day1Limit: 20,
 		growthFactor: 1.8,
-		inactivityThresholdHours: 168,
-		autoPauseAt: 'critical',
+		inactivityThresholdHours: 72,
+		autoPauseAt: 'high',
 		groupMultiplier: 0.7,
 		groupProfiles: false,
 		logging: true
 	},
 	aggressive: {
-		maxPerMinute: 25,
-		maxPerHour: 1200,
-		maxPerDay: 6e3,
-		minDelayMs: 600,
-		maxDelayMs: 2500,
-		newChatDelayMs: 1500,
-		warmupDays: 3,
-		day1Limit: 50,
+		maxPerMinute: 20,
+		maxPerHour: 800,
+		maxPerDay: 4e3,
+		minDelayMs: 800,
+		maxDelayMs: 3e3,
+		newChatDelayMs: 2e3,
+		warmupDays: 4,
+		day1Limit: 35,
 		growthFactor: 2,
-		inactivityThresholdHours: 96,
+		inactivityThresholdHours: 48,
 		autoPauseAt: 'critical',
 		groupMultiplier: 0.9,
 		groupProfiles: false,
@@ -2160,7 +2370,7 @@ var PRESETS = {
 }
 function resolveConfig(input) {
 	if (input === void 0) {
-		return { ...PRESETS.moderate }
+		return { ...PRESETS.conservative }
 	}
 	if (typeof input === 'string') {
 		if (!(input in PRESETS)) {
@@ -2168,14 +2378,14 @@ function resolveConfig(input) {
 		}
 		return { ...PRESETS[input] }
 	}
-	const { preset = 'moderate', ...overrides } = input
+	const { preset = 'conservative', ...overrides } = input
 	if (!(preset in PRESETS)) {
 		throw new Error(`Unknown preset "${preset}". Valid: ${Object.keys(PRESETS).join(', ')}`)
 	}
 	return { ...PRESETS[preset], ...overrides }
 }
 
-
+// persist.js
 var fs = __toESM(require('fs'), 1)
 var KNOWN_CHATS_MAX = 1e3
 var DEBOUNCE_MS = 5e3
@@ -2201,7 +2411,7 @@ var StateManager = class {
 			return null
 		}
 	}
-	
+	/** Debounced save — called after every send (5s delay) */
 	saveDebounced(state) {
 		if (this.debounceTimer) {
 			clearTimeout(this.debounceTimer)
@@ -2211,7 +2421,7 @@ var StateManager = class {
 			this.debounceTimer = null
 		}, DEBOUNCE_MS)
 	}
-	
+	/** Immediate save — called after health events (ban/restriction) */
 	saveImmediate(state) {
 		if (this.debounceTimer) {
 			clearTimeout(this.debounceTimer)
@@ -2219,7 +2429,7 @@ var StateManager = class {
 		}
 		this.writeFile(state)
 	}
-	
+	/** Flush/cancel pending debounced write (for tests and process exit) */
 	flush() {
 		if (this.debounceTimer) {
 			clearTimeout(this.debounceTimer)
@@ -2233,7 +2443,7 @@ var StateManager = class {
 		const toSave = {
 			...state,
 			savedAt: Date.now(),
-			
+			// LRU eviction: keep last KNOWN_CHATS_MAX entries
 			knownChats:
 				state.knownChats.length > KNOWN_CHATS_MAX ? state.knownChats.slice(-KNOWN_CHATS_MAX) : state.knownChats
 		}
@@ -2245,7 +2455,7 @@ var StateManager = class {
 	}
 }
 
-
+// profiles.js
 function isGroup(jid) {
 	return jid.endsWith('@g.us')
 }
@@ -2266,23 +2476,26 @@ function applyGroupMultiplier(limits, multiplier) {
 	}
 }
 
-
-
-
-
-
-
-
-
-const CORE_LEGACY_KEYS = ['rateLimiter', 'warmUp']
-function hasLegacyCoreNesting(cfg) {
+// antiban.js
+function isLegacyConfig(cfg) {
 	if (typeof cfg !== 'object' || cfg === null) return false
-	return CORE_LEGACY_KEYS.some(key => key in cfg)
+	return (
+		'rateLimiter' in cfg ||
+		'warmUp' in cfg ||
+		'health' in cfg ||
+		'timelock' in cfg ||
+		'replyRatio' in cfg ||
+		'contactGraph' in cfg ||
+		'presence' in cfg ||
+		'retryTracker' in cfg ||
+		'reconnectThrottle' in cfg ||
+		'lidResolver' in cfg ||
+		'jidCanonicalizer' in cfg ||
+		'sessionStability' in cfg
+	)
 }
 function mapLegacyToFlat(legacy) {
-	process.stderr.write(
-		'[baileys-antiban] DEPRECATED: nested { rateLimiter, warmUp } config detected. Migrate to flat fields: new AntiBan({ maxPerMinute: 8, warmupDays: 5 }). Flat top-level fields you also pass always take precedence.\n'
-	)
+	process.stderr.write('[baileys-antiban] DEPRECATED: Nested config (v2 style) detected. Migrate to flat config: new AntiBan({ maxPerMinute: 8 }).\n')
 	const flat = {}
 	if (legacy.rateLimiter?.maxPerMinute !== void 0) flat.maxPerMinute = legacy.rateLimiter.maxPerMinute
 	if (legacy.rateLimiter?.maxPerHour !== void 0) flat.maxPerHour = legacy.rateLimiter.maxPerHour
@@ -2293,6 +2506,7 @@ function mapLegacyToFlat(legacy) {
 	if (legacy.warmUp?.warmUpDays !== void 0) flat.warmupDays = legacy.warmUp.warmUpDays
 	if (legacy.warmUp?.day1Limit !== void 0) flat.day1Limit = legacy.warmUp.day1Limit
 	if (legacy.warmUp?.growthFactor !== void 0) flat.growthFactor = legacy.warmUp.growthFactor
+	if (legacy.logging !== void 0) flat.logging = legacy.logging
 	return flat
 }
 var AntiBan = class {
@@ -2317,29 +2531,18 @@ var AntiBan = class {
 		totalDelayMs: 0
 	}
 	constructor(input, warmUpStateArg) {
+		let flatConfig
+		let legacyPassthrough = null
 		let warmUpState = warmUpStateArg
-		
-		
-		
-		
-		const rawInput = typeof input === 'object' && input !== null ? input : {}
-		const legacyNested = hasLegacyCoreNesting(rawInput)
-		
-		const flatMerged = legacyNested ? { ...mapLegacyToFlat(rawInput), ...rawInput } : rawInput
-		const cfg = typeof input === 'string' ? resolveConfig(input) : resolveConfig(flatMerged)
+		if (isLegacyConfig(input)) {
+			legacyPassthrough = input
+			flatConfig = mapLegacyToFlat(legacyPassthrough)
+		} else {
+			flatConfig = {}
+			legacyPassthrough = null
+		}
+		const cfg = isLegacyConfig(input) ? resolveConfig(flatConfig) : resolveConfig(input)
 		this.resolvedConfig = cfg
-		const rateLimiterOverrides = rawInput.rateLimiter || {}
-		const warmUpOverrides = rawInput.warmUp || {}
-		const healthOverrides = rawInput.health || {}
-		const timelockOverrides = rawInput.timelock || {}
-		const replyRatioCfg = rawInput.replyRatio
-		const contactGraphCfg = rawInput.contactGraph
-		const presenceCfg = rawInput.presence
-		const retryTrackerCfg = rawInput.retryTracker
-		const reconnectThrottleCfg = rawInput.reconnectThrottle
-		const lidResolverCfg = rawInput.lidResolver
-		const jidCanonicalizerCfg = rawInput.jidCanonicalizer
-		const sessionStabilityCfg = rawInput.sessionStability
 		let savedState = null
 		if (cfg.persist) {
 			this.stateManager = new StateManager(cfg.persist)
@@ -2349,9 +2552,7 @@ var AntiBan = class {
 			}
 		}
 		this.logging = cfg.logging ?? true
-		this._log = msg => {
-			if (this.logging) process.stdout.write(`[baileys-antiban] ${msg}\n`)
-		}
+		this._log = (msg) => { if (this.logging) process.stdout.write(`[antiban] ${msg}\n`) }
 		this.rateLimiter = new RateLimiter({
 			maxPerMinute: cfg.maxPerMinute,
 			maxPerHour: cfg.maxPerHour,
@@ -2359,7 +2560,7 @@ var AntiBan = class {
 			minDelayMs: cfg.minDelayMs,
 			maxDelayMs: cfg.maxDelayMs,
 			newChatDelayMs: cfg.newChatDelayMs,
-			...rateLimiterOverrides
+			...(legacyPassthrough?.rateLimiter || {})
 		})
 		if (savedState?.knownChats) {
 			this.rateLimiter.restoreKnownChats(savedState.knownChats)
@@ -2370,73 +2571,69 @@ var AntiBan = class {
 				day1Limit: cfg.day1Limit,
 				growthFactor: cfg.growthFactor,
 				inactivityThresholdHours: cfg.inactivityThresholdHours,
-				...warmUpOverrides
+				...(legacyPassthrough?.warmUp || {})
 			},
 			warmUpState
 		)
 		this.health = new HealthMonitor({
 			autoPauseAt: cfg.autoPauseAt,
-			...healthOverrides,
+			...(legacyPassthrough?.health || {}),
 			onRiskChange: status => {
 				const emoji = { low: '\u{1F7E2}', medium: '\u{1F7E1}', high: '\u{1F7E0}', critical: '\u{1F534}' }
 				this._log(`${emoji[status.risk]} Risk level: ${status.risk.toUpperCase()} (score: ${status.score})`)
 				this._log(status.recommendation)
 				status.reasons.forEach(r => this._log(`  \u2192 ${r}`))
-				healthOverrides.onRiskChange?.(status)
+				legacyPassthrough?.health?.onRiskChange?.(status)
 			}
 		})
 		this.timelockGuard = new TimelockGuard({
-			...timelockOverrides,
+			...(legacyPassthrough?.timelock || {}),
 			onTimelockDetected: state => {
 				this.health.recordReachoutTimelock(state.enforcementType)
-				this._log(
-					`REACHOUT TIMELOCKED \u2014 ${state.enforcementType || 'unknown'}, expires ${state.expiresAt?.toISOString() || 'unknown'}`
-				)
-				timelockOverrides.onTimelockDetected?.(state)
+				this._log(`REACHOUT TIMELOCKED \u2014 ${state.enforcementType || 'unknown'}, expires ${state.expiresAt?.toISOString() || 'unknown'}`)
+				legacyPassthrough?.timelock?.onTimelockDetected?.(state)
 			},
 			onTimelockLifted: state => {
 				this._log('Timelock lifted \u2014 resuming new contact messages')
-				timelockOverrides.onTimelockLifted?.(state)
+				legacyPassthrough?.timelock?.onTimelockLifted?.(state)
 			}
 		})
-		this.replyRatioGuard = new ReplyRatioGuard(replyRatioCfg)
-		this.contactGraphWarmer = new ContactGraphWarmer(contactGraphCfg)
-		this.presenceChoreographer = new PresenceChoreographer(presenceCfg)
+		this.replyRatioGuard = new ReplyRatioGuard(legacyPassthrough?.replyRatio)
+		this.contactGraphWarmer = new ContactGraphWarmer(legacyPassthrough?.contactGraph)
+		this.presenceChoreographer = new PresenceChoreographer(legacyPassthrough?.presence)
 		this.retryTrackerModule = new RetryReasonTracker({
-			...(retryTrackerCfg || {}),
+			...(legacyPassthrough?.retryTracker || {}),
 			onSpiral: (msgId, reason) => {
 				this._log(`\u26A0\uFE0F  Message ${msgId} stuck in retry spiral (${reason})`)
-				retryTrackerCfg?.onSpiral?.(msgId, reason)
+				legacyPassthrough?.retryTracker?.onSpiral?.(msgId, reason)
 			}
 		})
 		this.reconnectThrottleModule = new PostReconnectThrottle({
-			...(reconnectThrottleCfg || {}),
+			...(legacyPassthrough?.reconnectThrottle || {}),
 			baselineRatePerMinute: () => this.rateLimiter.getStats().limits.perMinute
 		})
-		if (jidCanonicalizerCfg?.enabled) {
-			if (jidCanonicalizerCfg.resolver) {
-				this.jidCanonicalizerModule = new JidCanonicalizer(jidCanonicalizerCfg)
-				this.lidResolverModule = jidCanonicalizerCfg.resolver
+		if (legacyPassthrough?.jidCanonicalizer?.enabled) {
+			if (legacyPassthrough.jidCanonicalizer.resolver) {
+				this.jidCanonicalizerModule = new JidCanonicalizer(legacyPassthrough.jidCanonicalizer)
+				this.lidResolverModule = legacyPassthrough.jidCanonicalizer.resolver
 			} else {
-				const resolverConfig = lidResolverCfg || jidCanonicalizerCfg.resolverConfig
+				const resolverConfig = legacyPassthrough.lidResolver || legacyPassthrough.jidCanonicalizer.resolverConfig
 				const resolver = new LidResolver(resolverConfig)
 				this.lidResolverModule = resolver
 				this.jidCanonicalizerModule = new JidCanonicalizer({
-					...jidCanonicalizerCfg,
+					...legacyPassthrough.jidCanonicalizer,
 					resolver
 				})
 			}
-		} else if (lidResolverCfg) {
-			this.lidResolverModule = new LidResolver(lidResolverCfg)
+		} else if (legacyPassthrough?.lidResolver) {
+			this.lidResolverModule = new LidResolver(legacyPassthrough.lidResolver)
 		}
-		if (sessionStabilityCfg?.enabled) {
+		if (legacyPassthrough?.sessionStability?.enabled) {
 			const healthConfig = {
-				badMacThreshold: sessionStabilityCfg.badMacThreshold,
-				badMacWindowMs: sessionStabilityCfg.badMacWindowMs,
+				badMacThreshold: legacyPassthrough.sessionStability.badMacThreshold,
+				badMacWindowMs: legacyPassthrough.sessionStability.badMacWindowMs,
 				onDegraded: stats => {
-					this._log(
-						`\u{1F534} SESSION DEGRADED \u2014 Bad MAC rate: ${stats.badMacCount} in last ${sessionStabilityCfg.badMacWindowMs || 6e4}ms`
-					)
+					this._log(`\u{1F534} SESSION DEGRADED \u2014 Bad MAC rate: ${stats.badMacCount} in last ${legacyPassthrough?.sessionStability?.badMacWindowMs || 6e4}ms`)
 					this._log('Consider restarting session or switching to LID-based canonical form')
 				},
 				onRecovered: () => {
@@ -2446,8 +2643,11 @@ var AntiBan = class {
 			this.sessionStabilityMonitor = new SessionHealthMonitor(healthConfig)
 		}
 	}
-	
-	async beforeSend(recipient, content, dedupKey) {
+	/**
+	 * Check if a message can be sent and get required delay.
+	 * Call this BEFORE every sendMessage().
+	 */
+	async beforeSend(recipient, content) {
 		const healthStatus = this.health.getStatus()
 		if (this.health.isPaused()) {
 			this.stats.messagesBlocked++
@@ -2473,9 +2673,7 @@ var AntiBan = class {
 		if (!this.warmUp.canSend()) {
 			this.stats.messagesBlocked++
 			const warmUpStatus = this.warmUp.getStatus()
-			this._log(
-				`\u23F3 BLOCKED \u2014 warm-up day ${warmUpStatus.day}/${warmUpStatus.totalDays}, limit reached (${warmUpStatus.todaySent}/${warmUpStatus.todayLimit})`
-			)
+			this._log(`\u23F3 BLOCKED \u2014 warm-up day ${warmUpStatus.day}/${warmUpStatus.totalDays}, limit reached (${warmUpStatus.todaySent}/${warmUpStatus.todayLimit})`)
 			return {
 				allowed: false,
 				delayMs: 0,
@@ -2537,7 +2735,7 @@ var AntiBan = class {
 				return { allowed: false, delayMs: 0, reason: 'Group rate limit exceeded', health: healthStatus }
 			}
 		}
-		let delay = await this.rateLimiter.getDelay(recipient, content, dedupKey)
+		let delay = await this.rateLimiter.getDelay(recipient, content)
 		if (delay === -1) {
 			this.stats.messagesBlocked++
 			this._log(`\u{1F6AB} BLOCKED \u2014 rate limit or identical message spam`)
@@ -2570,19 +2768,26 @@ var AntiBan = class {
 			health: healthStatus
 		}
 	}
-	
-	afterSend(recipient, content, dedupKey) {
-		this.rateLimiter.record(recipient, content, dedupKey)
+	/**
+	 * Record a successfully sent message.
+	 * Call this AFTER every successful sendMessage().
+	 */
+	afterSend(recipient, content) {
+		this.rateLimiter.record(recipient, content)
 		this.warmUp.record()
 		this.replyRatioGuard.recordSent(recipient)
 		this.stats.messagesAllowed++
 		this.persistStateDebounced()
 	}
-	
+	/**
+	 * Record a failed message send
+	 */
 	afterSendFailed(error) {
 		this.health.recordMessageFailed(error)
 	}
-	
+	/**
+	 * Record a disconnection (call from connection.update handler)
+	 */
 	onDisconnect(reason) {
 		this.health.recordDisconnect(reason)
 		this.reconnectThrottleModule.onDisconnect()
@@ -2591,18 +2796,25 @@ var AntiBan = class {
 			this.persistStateImmediate()
 		}
 	}
-	
+	/**
+	 * Record a successful reconnection
+	 */
 	onReconnect() {
 		this.health.recordReconnect()
 		this.reconnectThrottleModule.onReconnect()
 	}
-	
+	/**
+	 * Handle incoming message — record in reply ratio + contact graph.
+	 * Returns suggested reply if reply ratio suggests auto-reply.
+	 */
 	onIncomingMessage(jid, msgText) {
 		this.replyRatioGuard.recordReceived(jid)
 		this.contactGraphWarmer.onIncomingMessage(jid)
 		return this.replyRatioGuard.suggestReply(jid, msgText)
 	}
-	
+	/**
+	 * Get comprehensive stats
+	 */
 	getStats() {
 		const stats = {
 			...this.stats,
@@ -2636,57 +2848,65 @@ var AntiBan = class {
 		}
 		return stats
 	}
-	
+	/** Get the timelock guard for direct access */
 	get timelock() {
 		return this.timelockGuard
 	}
-	
+	/** Get the reply ratio guard for direct access */
 	get replyRatio() {
 		return this.replyRatioGuard
 	}
-	
+	/** Get the contact graph warmer for direct access */
 	get contactGraph() {
 		return this.contactGraphWarmer
 	}
-	
+	/** Get the presence choreographer for direct access */
 	get presence() {
 		return this.presenceChoreographer
 	}
-	
+	/** Get the retry tracker for direct access */
 	get retryTracker() {
 		return this.retryTrackerModule
 	}
-	
+	/** Get the reconnect throttle for direct access */
 	get reconnectThrottle() {
 		return this.reconnectThrottleModule
 	}
-	
+	/** Get the LID resolver for direct access */
 	get lidResolver() {
 		return this.lidResolverModule
 	}
-	
+	/** Get the JID canonicalizer for direct access */
 	get jidCanonicalizer() {
 		return this.jidCanonicalizerModule
 	}
-	
+	/** Get the session stability monitor for direct access */
 	get sessionStability() {
 		return this.sessionStabilityMonitor
 	}
-	
+	/**
+	 * Export warm-up state for persistence between restarts
+	 */
 	exportWarmUpState() {
 		return this.warmUp.exportState()
 	}
-	
+	/**
+	 * Force pause all sending
+	 */
 	pause() {
 		this.health.setPaused(true)
 		this._log('\u23F8\uFE0F  Sending paused manually')
 	}
-	
+	/**
+	 * Resume sending
+	 */
 	resume() {
 		this.health.setPaused(false)
 		this._log('\u25B6\uFE0F  Sending resumed')
 	}
-	
+	/**
+	 * Reset everything (use after a ban period)
+	 */
 	reset() {
 		this.timelockGuard.reset()
 		this.health.reset()
@@ -2719,7 +2939,10 @@ var AntiBan = class {
 		}
 		this.stateManager.saveImmediate(state)
 	}
-	
+	/**
+	 * Clean up all timers and resources.
+	 * Call this when disposing of the AntiBan instance or when the socket closes.
+	 */
 	destroy() {
 		this.stateManager?.destroy()
 		this.timelockGuard.reset()
@@ -2735,14 +2958,17 @@ var AntiBan = class {
 	}
 }
 
-
+// lidFirstResolver.js
 var fs2 = __toESM(require('fs'), 1)
 var path = __toESM(require('path'), 1)
 var LidFirstResolver = class {
-	lidToPhone =  new Map()
-	phoneToLid =  new Map()
-	
-	
+	lidToPhone = /* @__PURE__ */ new Map()
+	phoneToLid = /* @__PURE__ */ new Map()
+	// phone → lid (quick reverse lookup)
+	/**
+	 * Load mappings from Baileys auth state directory.
+	 * Looks for lid-mapping-*_reverse.json files.
+	 */
 	loadFromAuthDir(authDir) {
 		try {
 			if (!fs2.existsSync(authDir)) {
@@ -2772,7 +2998,10 @@ var LidFirstResolver = class {
 			}
 		} catch (error) {}
 	}
-	
+	/**
+	 * Learn a new mapping from a Baileys event (messages, contacts, etc.).
+	 * Accepts partial data — will extract what it can.
+	 */
 	learnFromEvent(event) {
 		try {
 			if (event.key?.remoteJid) {
@@ -2791,19 +3020,28 @@ var LidFirstResolver = class {
 			}
 		} catch (error) {}
 	}
-	
+	/**
+	 * Resolve phone number or phone JID to LID JID.
+	 * Returns null if not known.
+	 */
 	resolveToLID(phoneOrJid) {
 		const phone = this.extractPhone(phoneOrJid)
 		if (!phone) return null
 		return this.phoneToLid.get(phone) || null
 	}
-	
+	/**
+	 * Resolve LID JID to phone number.
+	 * Returns null if not known.
+	 */
 	resolveToPhone(lid) {
 		const normalized = this.normalizeLid(lid)
 		const mapping = this.lidToPhone.get(normalized)
 		return mapping ? mapping.phone : null
 	}
-	
+	/**
+	 * Get full mapping for a given JID (either LID or phone).
+	 * Returns null if not known.
+	 */
 	getMapping(jid) {
 		const normalized = this.normalizeLid(jid)
 		const byLid = this.lidToPhone.get(normalized)
@@ -2815,16 +3053,20 @@ var LidFirstResolver = class {
 		}
 		return null
 	}
-	
+	/**
+	 * Get total number of known mappings.
+	 */
 	size() {
 		return this.lidToPhone.size
 	}
-	
+	/**
+	 * Clear all mappings.
+	 */
 	clear() {
 		this.lidToPhone.clear()
 		this.phoneToLid.clear()
 	}
-	
+	// Private helpers
 	learnJid(_jid, _source) {}
 	extractPhone(jid) {
 		if (!jid) return null
@@ -2843,7 +3085,7 @@ function createLidFirstResolver() {
 	return new LidFirstResolver()
 }
 
-
+// retryReason.js
 var MessageRetryReason
 ;(function (MessageRetryReason2) {
 	MessageRetryReason2[(MessageRetryReason2['UnknownError'] = 0)] = 'UnknownError'
@@ -2855,7 +3097,7 @@ var MessageRetryReason
 	MessageRetryReason2[(MessageRetryReason2['MessageExpired'] = 8)] = 'MessageExpired'
 	MessageRetryReason2[(MessageRetryReason2['DecryptionError'] = 9)] = 'DecryptionError'
 })(MessageRetryReason || (MessageRetryReason = {}))
-var MAC_ERROR_CODES =  new Set([
+var MAC_ERROR_CODES = /* @__PURE__ */ new Set([
 	MessageRetryReason.SignalErrorBadMac,
 	MessageRetryReason.SignalErrorInvalidMessage,
 	MessageRetryReason.SignalErrorNoSession,
@@ -2900,171 +3142,133 @@ function getRetryReasonDescription(reason) {
 	}
 }
 
-
-
-function mediaFingerprint(media) {
-	if (Buffer.isBuffer(media)) {
-		const len = media.length
-		const head = media.subarray(0, Math.min(24, len)).toString('hex')
-		const tail = len > 24 ? media.subarray(Math.max(24, len - 24)).toString('hex') : ''
-		return `buf:${len}:${head}:${tail}`
-	}
-	if (media && typeof media === 'object' && typeof media.url === 'string') {
-		return `url:${media.url}`
-	}
-	if (typeof media === 'string') {
-		return `str:${media}`
-	}
-	if (media && typeof media === 'object') {
-		
-		
-		
-		return `unresolvable:${Math.random().toString(36)}`
-	}
-	return 'none'
-}
-
-function buildContentSignature(content) {
-	if (!content || typeof content !== 'object') return String(content ?? '')
-	const parts = []
-	const text =
-		content.text ||
-		content.caption ||
-		content.image?.caption ||
-		content.video?.caption ||
-		content.document?.caption ||
-		''
-	if (text) parts.push(`text:${text}`)
-	if (content.image !== undefined) parts.push(`image:${mediaFingerprint(content.image)}`)
-	if (content.video !== undefined) parts.push(`video:${mediaFingerprint(content.video)}`)
-	if (content.audio !== undefined) parts.push(`audio:${mediaFingerprint(content.audio)}`)
-	if (content.sticker !== undefined) parts.push(`sticker:${mediaFingerprint(content.sticker)}`)
-	if (content.document !== undefined) {
-		parts.push(`document:${mediaFingerprint(content.document)}:${content.fileName || ''}`)
-	}
-	if (content.location) {
-		parts.push(`location:${content.location.degreesLatitude}:${content.location.degreesLongitude}`)
-	}
-	if (content.contacts) {
-		const vcards = content.contacts.contacts?.map(c => c.vcard).join('|') || JSON.stringify(content.contacts)
-		parts.push(`contacts:${vcards}`)
-	}
-	if (content.poll) {
-		parts.push(`poll:${content.poll.name}:${(content.poll.values || []).join(',')}`)
-	}
-	if (content.buttons) parts.push(`buttons:${JSON.stringify(content.buttons)}`)
-	if (content.templateButtons) parts.push(`template:${JSON.stringify(content.templateButtons)}`)
-	if (content.sections) parts.push(`sections:${JSON.stringify(content.sections)}`)
-	if (content.react) parts.push(`react:${content.react.text}:${content.react.key?.id || ''}`)
-	if (!parts.length) {
-		
-		parts.push(`shape:${Object.keys(content).sort().join(',')}`)
-	}
-	return parts.join('|')
-}
+// wrapper.js
 function wrapSocket(sock, config, warmUpState, wrapOptions) {
 	const antiban = new AntiBan(config, warmUpState)
 	const options = {
 		autoRespondToIncoming: false,
 		...wrapOptions
 	}
-	
-	
-	
-	
-	const pendingAutoReplyTimers = new Set()
-	const scheduleAutoReply = (jid, suggestedText) => {
-		const replyDelay = Math.floor(Math.random() * 12e3) + 3e3
-		const timer = setTimeout(async () => {
-			pendingAutoReplyTimers.delete(timer)
-			try {
-				await sock.sendMessage(jid, { text: suggestedText })
-			} catch (error) {}
-		}, replyDelay)
-		pendingAutoReplyTimers.add(timer)
-	}
-	const handleConnectionUpdate = update => {
-		if (update.connection === 'close') {
-			const reason = update.lastDisconnect?.error?.output?.statusCode || 'unknown'
-			antiban.onDisconnect(reason)
-		}
-		if (update.connection === 'open') {
-			antiban.onReconnect()
-		}
-		if (update.reachoutTimeLock) {
-			antiban.timelock.onTimelockUpdate({
-				isActive: update.reachoutTimeLock.isActive,
-				timeEnforcementEnds: update.reachoutTimeLock.timeEnforcementEnds,
-				enforcementType: update.reachoutTimeLock.enforcementType
-			})
-		}
-	}
-	const handleMessagesUpdate = updates => {
-		for (const update of updates) {
-			if (update?.update?.messageStubParameters) {
-				const params = update.update.messageStubParameters
-				if (params.includes(463) || params.includes('463')) {
-					antiban.timelock.record463Error()
+	if (typeof sock.ev.process === 'function') {
+		sock.ev.process(async events => {
+			if (events['connection.update']) {
+				const update = events['connection.update']
+				if (update.connection === 'close') {
+					const reason = update.lastDisconnect?.error?.output?.statusCode || 'unknown'
+					antiban.onDisconnect(reason)
+				}
+				if (update.connection === 'open') {
+					antiban.onReconnect()
+				}
+				if (update.reachoutTimeLock) {
+					antiban.timelock.onTimelockUpdate({
+						isActive: update.reachoutTimeLock.isActive,
+						timeEnforcementEnds: update.reachoutTimeLock.timeEnforcementEnds,
+						enforcementType: update.reachoutTimeLock.enforcementType
+					})
 				}
 			}
-			antiban.retryTracker.onMessageUpdate(update)
-		}
-		antiban.jidCanonicalizer?.onMessageUpdate(updates)
-	}
-	const handleMessagesUpsert = upsert => {
-		const { messages } = upsert
-		antiban.jidCanonicalizer?.onIncomingEvent(upsert)
-		for (const msg of messages || []) {
-			const jid = msg.key?.remoteJid
-			if (!jid) continue
-			antiban.timelock.registerKnownChat(jid)
-			const isSelf = msg.key?.fromMe || false
-			if (isSelf) continue
-			const msgText =
-				msg.message?.conversation ||
-				msg.message?.extendedTextMessage?.text ||
-				msg.message?.imageMessage?.caption ||
-				msg.message?.videoMessage?.caption ||
-				''
-			const replySuggestion = antiban.onIncomingMessage(jid, msgText)
-			if (options.autoRespondToIncoming && replySuggestion.shouldReply && replySuggestion.suggestedText) {
-				scheduleAutoReply(jid, replySuggestion.suggestedText)
+			if (events['messages.update']) {
+				const updates = events['messages.update']
+				for (const update of updates) {
+					if (update?.update?.messageStubParameters) {
+						const params = update.update.messageStubParameters
+						if (params.includes(463) || params.includes('463')) {
+							antiban.timelock.record463Error()
+						}
+					}
+					antiban.retryTracker.onMessageUpdate(update)
+				}
+				antiban.jidCanonicalizer?.onMessageUpdate(updates)
 			}
-		}
-	}
-	let stopEventBridge = () => {}
-	if (typeof sock.ev.process === 'function') {
-		const processListener = async events => {
-			if (events['connection.update']) handleConnectionUpdate(events['connection.update'])
-			if (events['messages.update']) handleMessagesUpdate(events['messages.update'])
-			if (events['messages.upsert']) handleMessagesUpsert(events['messages.upsert'])
-		}
-		const maybeUnsubscribe = sock.ev.process(processListener)
-		if (typeof maybeUnsubscribe === 'function') {
-			stopEventBridge = maybeUnsubscribe
-		}
+			if (events['messages.upsert']) {
+				const { messages } = events['messages.upsert']
+				antiban.jidCanonicalizer?.onIncomingEvent(events['messages.upsert'])
+				for (const msg of messages || []) {
+					const jid = msg.key?.remoteJid
+					if (!jid) continue
+					antiban.timelock.registerKnownChat(jid)
+					const isSelf = msg.key?.fromMe || false
+					if (isSelf) continue
+					const msgText =
+						msg.message?.conversation ||
+						msg.message?.extendedTextMessage?.text ||
+						msg.message?.imageMessage?.caption ||
+						msg.message?.videoMessage?.caption ||
+						''
+					const replySuggestion = antiban.onIncomingMessage(jid, msgText)
+					if (options.autoRespondToIncoming && replySuggestion.shouldReply && replySuggestion.suggestedText) {
+						const replyDelay = Math.floor(Math.random() * 12e3) + 3e3
+						setTimeout(async () => {
+							try {
+								await sock.sendMessage(jid, { text: replySuggestion.suggestedText })
+							} catch (error) {}
+						}, replyDelay)
+					}
+				}
+			}
+		})
 	} else {
-		sock.ev.on('connection.update', handleConnectionUpdate)
-		sock.ev.on('messages.update', handleMessagesUpdate)
-		sock.ev.on('messages.upsert', handleMessagesUpsert)
-		stopEventBridge = () => {
-			sock.ev.off('connection.update', handleConnectionUpdate)
-			sock.ev.off('messages.update', handleMessagesUpdate)
-			sock.ev.off('messages.upsert', handleMessagesUpsert)
-		}
+		sock.ev.on('connection.update', update => {
+			if (update.connection === 'close') {
+				const reason = update.lastDisconnect?.error?.output?.statusCode || 'unknown'
+				antiban.onDisconnect(reason)
+			}
+			if (update.connection === 'open') {
+				antiban.onReconnect()
+			}
+			if (update.reachoutTimeLock) {
+				antiban.timelock.onTimelockUpdate({
+					isActive: update.reachoutTimeLock.isActive,
+					timeEnforcementEnds: update.reachoutTimeLock.timeEnforcementEnds,
+					enforcementType: update.reachoutTimeLock.enforcementType
+				})
+			}
+		})
+		sock.ev.on('messages.update', updates => {
+			for (const update of updates) {
+				if (update?.update?.messageStubParameters) {
+					const params = update.update.messageStubParameters
+					if (params.includes(463) || params.includes('463')) {
+						antiban.timelock.record463Error()
+					}
+				}
+				antiban.retryTracker.onMessageUpdate(update)
+			}
+			antiban.jidCanonicalizer?.onMessageUpdate(updates)
+		})
+		sock.ev.on('messages.upsert', upsert => {
+			const { messages } = upsert
+			antiban.jidCanonicalizer?.onIncomingEvent(upsert)
+			for (const msg of messages || []) {
+				const jid = msg.key?.remoteJid
+				if (!jid) continue
+				antiban.timelock.registerKnownChat(jid)
+				const isSelf = msg.key?.fromMe || false
+				if (isSelf) continue
+				const msgText =
+					msg.message?.conversation ||
+					msg.message?.extendedTextMessage?.text ||
+					msg.message?.imageMessage?.caption ||
+					msg.message?.videoMessage?.caption ||
+					''
+				const replySuggestion = antiban.onIncomingMessage(jid, msgText)
+				if (options.autoRespondToIncoming && replySuggestion.shouldReply && replySuggestion.suggestedText) {
+					const replyDelay = Math.floor(Math.random() * 12e3) + 3e3
+					setTimeout(async () => {
+						try {
+							await sock.sendMessage(jid, { text: replySuggestion.suggestedText })
+						} catch (error) {}
+					}, replyDelay)
+				}
+			}
+		})
 	}
 	const originalSendMessage = sock.sendMessage.bind(sock)
 	const wrappedSendMessage = async (jid, content, options2) => {
 		const canonicalJid = antiban.jidCanonicalizer?.canonicalizeTarget(jid) || jid
-		const text =
-			content?.text ||
-			content?.caption ||
-			content?.image?.caption ||
-			content?.video?.caption ||
-			content?.document?.caption ||
-			''
-		const dedupKey = buildContentSignature(content)
-		const decision = await antiban.beforeSend(canonicalJid, text, dedupKey)
+		const text = content?.text || content?.caption || content?.image?.caption || ''
+		const decision = await antiban.beforeSend(canonicalJid, text)
 		if (!decision.allowed) {
 			throw new Error(`[baileys-antiban] Message blocked: ${decision.reason}`)
 		}
@@ -3073,7 +3277,7 @@ function wrapSocket(sock, config, warmUpState, wrapOptions) {
 		}
 		try {
 			const result = await originalSendMessage(canonicalJid, content, options2)
-			antiban.afterSend(canonicalJid, text, dedupKey)
+			antiban.afterSend(canonicalJid, text)
 			antiban.timelock.registerKnownChat(canonicalJid)
 			if (result?.key?.id) {
 				antiban.retryTracker.clear(result.key.id)
@@ -3087,17 +3291,11 @@ function wrapSocket(sock, config, warmUpState, wrapOptions) {
 	const wrapped = Object.create(sock)
 	wrapped.sendMessage = wrappedSendMessage
 	wrapped.antiban = antiban
-	const originalDestroy = antiban.destroy.bind(antiban)
-	wrapped.antiban.destroy = () => {
-		stopEventBridge()
-		for (const timer of pendingAutoReplyTimers) clearTimeout(timer)
-		pendingAutoReplyTimers.clear()
-		originalDestroy()
-	}
+	wrapped.antiban.destroy = antiban.destroy.bind(antiban)
 	return wrapped
 }
 
-
+// messageQueue.js
 var import_events = require('events')
 var DEFAULT_CONFIG12 = {
 	maxAttempts: 3,
@@ -3116,11 +3314,16 @@ var MessageQueue = class extends import_events.EventEmitter {
 		super()
 		this.config = { ...DEFAULT_CONFIG12, ...config }
 	}
-	
+	/**
+	 * Set the send function (called for each message when drained)
+	 * This should be the anti-ban wrapped sendMessage
+	 */
 	setSendFunction(fn) {
 		this.sendFn = fn
 	}
-	
+	/**
+	 * Add a message to the queue
+	 */
 	add(recipient, content, options) {
 		if (this.queue.length >= this.config.maxQueueSize) {
 			throw new Error(`Queue full (${this.config.maxQueueSize} messages)`)
@@ -3142,17 +3345,23 @@ var MessageQueue = class extends import_events.EventEmitter {
 		this.emit('added', message)
 		return id
 	}
-	
+	/**
+	 * Add multiple messages (e.g., broadcast to many recipients)
+	 */
 	addBulk(recipients, content, options) {
 		return recipients.map(r => this.add(r, content, options))
 	}
-	
+	/**
+	 * Start processing the queue
+	 */
 	start(intervalMs = 1e3) {
 		if (this.drainTimer) return
 		this.drainTimer = setInterval(() => this.processNext(), intervalMs)
 		this.emit('started')
 	}
-	
+	/**
+	 * Stop processing
+	 */
 	stop() {
 		if (this.drainTimer) {
 			clearInterval(this.drainTimer)
@@ -3160,11 +3369,16 @@ var MessageQueue = class extends import_events.EventEmitter {
 		}
 		this.emit('stopped')
 	}
-	
+	/**
+	 * Clean up all timers and resources.
+	 * Call this when disposing of the queue.
+	 */
 	destroy() {
 		this.stop()
 	}
-	
+	/**
+	 * Process the next message in the queue
+	 */
 	async processNext() {
 		if (this.processing || !this.sendFn) return
 		const now = Date.now()
@@ -3193,7 +3407,9 @@ var MessageQueue = class extends import_events.EventEmitter {
 			this.processing = false
 		}
 	}
-	
+	/**
+	 * Get queue stats
+	 */
 	getStats() {
 		const now = Date.now()
 		return {
@@ -3209,23 +3425,31 @@ var MessageQueue = class extends import_events.EventEmitter {
 			isRunning: this.drainTimer !== null
 		}
 	}
-	
+	/**
+	 * Clear all messages
+	 */
 	clear() {
 		const count = this.queue.length
 		this.queue = []
 		this.emit('cleared', count)
 	}
-	
+	/**
+	 * Remove a specific message
+	 */
 	remove(id) {
 		const before = this.queue.length
 		this.queue = this.queue.filter(m => m.id !== id)
 		return this.queue.length < before
 	}
-	
+	/**
+	 * Export queue for persistence
+	 */
 	export() {
 		return [...this.queue]
 	}
-	
+	/**
+	 * Import queue (e.g., after restart)
+	 */
 	import(messages) {
 		this.queue = [...messages]
 		this.sortQueue()
@@ -3241,7 +3465,7 @@ var MessageQueue = class extends import_events.EventEmitter {
 	}
 }
 
-
+// contentVariator.js
 var DEFAULT_CONFIG13 = {
 	zeroWidthChars: true,
 	punctuationVariation: true,
@@ -3250,13 +3474,13 @@ var DEFAULT_CONFIG13 = {
 }
 var ZERO_WIDTH = [
 	'\u200B',
-	
+	// zero-width space
 	'\u200C',
-	
+	// zero-width non-joiner
 	'\u200D',
-	
+	// zero-width joiner
 	'\uFEFF'
-	
+	// zero-width no-break space
 ]
 var SYNONYMS = {
 	hello: ['hi', 'hey', 'howdy'],
@@ -3283,7 +3507,10 @@ var ContentVariator = class {
 	constructor(config = {}) {
 		this.config = { ...DEFAULT_CONFIG13, ...config }
 	}
-	
+	/**
+	 * Create a unique variation of a message
+	 * Each call produces a slightly different version
+	 */
 	vary(text) {
 		let result = text
 		this.counter++
@@ -3304,15 +3531,22 @@ var ContentVariator = class {
 		}
 		return result
 	}
-	
+	/**
+	 * Create N unique variations of a message
+	 */
 	varyBulk(text, count) {
 		const results = []
-		const startCounter = this.counter
+		const seen = /* @__PURE__ */ new Set()
 		for (let i = 0; i < count; i++) {
-			this.counter = startCounter + i
-			results.push(this.vary(text))
+			let variation = this.vary(text)
+			let attempts = 0
+			while (seen.has(variation) && attempts < 10) {
+				variation = this.vary(text)
+				attempts++
+			}
+			seen.add(variation)
+			results.push(variation)
 		}
-		this.counter = startCounter + count
 		return results
 	}
 	addZeroWidth(text) {
@@ -3331,14 +3565,14 @@ var ContentVariator = class {
 	}
 	varyPunctuation(text) {
 		const variations = [
-			
+			// Trailing space variations
 			() => text + ' ',
 			() => text + '  ',
-			
+			// Period variations
 			() => (text.endsWith('.') ? text.slice(0, -1) : text + '.'),
-			
+			// Nothing
 			() => text,
-			
+			// Capitalize first letter variation
 			() => (text.charAt(0) === text.charAt(0).toUpperCase() ? text.charAt(0).toLowerCase() + text.slice(1) : text)
 		]
 		return variations[this.counter % variations.length]()
@@ -3348,18 +3582,21 @@ var ContentVariator = class {
 		return text + emojis[this.counter % emojis.length]
 	}
 	applySynonyms(text) {
-		const lower = text.toLowerCase()
-		for (const key of Object.keys(SYNONYMS)) {
-			const idx = lower.indexOf(key)
-			if (idx === -1) continue
-			const word = text.substring(idx, idx + key.length)
-			if (!SYNONYMS[key] || Math.random() > 0.5) continue
-			const synonym = SYNONYMS[key][Math.floor(Math.random() * SYNONYMS[key].length)]
-			const replacement =
-				word[0] === word[0].toUpperCase() ? synonym.charAt(0).toUpperCase() + synonym.slice(1) : synonym
-			return text.substring(0, idx) + replacement + text.substring(idx + key.length)
-		}
-		return text
+		const words = text.split(/\b/)
+		let replaced = false
+		return words
+			.map(word => {
+				if (replaced) return word
+				const lower = word.toLowerCase()
+				const synonymList = SYNONYMS[lower]
+				if (synonymList && Math.random() > 0.5) {
+					replaced = true
+					const synonym = synonymList[Math.floor(Math.random() * synonymList.length)]
+					return word[0] === word[0].toUpperCase() ? synonym.charAt(0).toUpperCase() + synonym.slice(1) : synonym
+				}
+				return word
+			})
+			.join('')
 	}
 	randomPositions(max, count) {
 		const positions = []
@@ -3371,7 +3608,7 @@ var ContentVariator = class {
 	}
 }
 
-
+// webhooks.js
 var DEFAULT_CONFIG14 = {
 	urls: [],
 	minRiskLevel: 'medium',
@@ -3384,7 +3621,9 @@ var WebhookAlerts = class {
 	constructor(config = {}) {
 		this.config = { ...DEFAULT_CONFIG14, ...config }
 	}
-	
+	/**
+	 * Send alert if risk level warrants it
+	 */
 	async alert(data) {
 		const riskOrder = ['low', 'medium', 'high', 'critical']
 		if (riskOrder.indexOf(data.risk) < riskOrder.indexOf(this.config.minRiskLevel)) {
@@ -3397,7 +3636,7 @@ var WebhookAlerts = class {
 		this.lastAlertTime = now
 		const payload = {
 			source: 'baileys-antiban',
-			timestamp:  new Date().toISOString(),
+			timestamp: /* @__PURE__ */ new Date().toISOString(),
 			...data
 		}
 		for (const url of this.config.urls) {
@@ -3432,7 +3671,7 @@ ${data.reasons.map(r => `\u2022 ${r}`).join('\n')}`
 							{ name: 'Recommendation', value: data.recommendation },
 							{ name: 'Reasons', value: data.reasons.join('\n') }
 						],
-						timestamp:  new Date().toISOString()
+						timestamp: /* @__PURE__ */ new Date().toISOString()
 					}
 				]
 			}).catch(() => {})
@@ -3457,7 +3696,7 @@ ${data.reasons.map(r => `\u2022 ${r}`).join('\n')}`
 	}
 }
 
-
+// scheduler.js
 var DEFAULT_CONFIG15 = {
 	timezone: 'UTC',
 	activeHours: [8, 21],
@@ -3472,13 +3711,18 @@ var Scheduler = class {
 	constructor(config = {}) {
 		this.config = { ...DEFAULT_CONFIG15, ...config }
 	}
-	
+	/**
+	 * Check if now is within active hours
+	 */
 	isActiveTime() {
 		const hour = this.getCurrentHour()
 		const [start, end] = this.config.activeHours
 		return hour >= start && hour < end
 	}
-	
+	/**
+	 * Get the speed multiplier for current time
+	 * > 1 = faster, < 1 = slower, 0 = don't send
+	 */
 	getSpeedFactor() {
 		if (!this.isActiveTime()) return 0
 		const hour = this.getCurrentHour()
@@ -3497,10 +3741,12 @@ var Scheduler = class {
 		}
 		return factor
 	}
-	
+	/**
+	 * Get ms until next active window
+	 */
 	msUntilActive() {
 		if (this.isActiveTime()) return 0
-		const now =  new Date()
+		const now = /* @__PURE__ */ new Date()
 		const hour = now.getHours()
 		const [start] = this.config.activeHours
 		let nextActive
@@ -3514,13 +3760,17 @@ var Scheduler = class {
 		}
 		return nextActive.getTime() - now.getTime()
 	}
-	
+	/**
+	 * Adjust a delay based on current time factors
+	 */
 	adjustDelay(baseDelayMs) {
 		const factor = this.getSpeedFactor()
 		if (factor === 0) return -1
 		return Math.round(baseDelayMs / factor)
 	}
-	
+	/**
+	 * Get current schedule status
+	 */
 	getStatus() {
 		const hour = this.getCurrentHour()
 		const day = this.getCurrentDay()
@@ -3536,14 +3786,14 @@ var Scheduler = class {
 		}
 	}
 	getCurrentHour() {
-		return  new Date().getHours()
+		return /* @__PURE__ */ new Date().getHours()
 	}
 	getCurrentDay() {
-		return  new Date().getDay()
+		return /* @__PURE__ */ new Date().getDay()
 	}
 }
 
-
+// stateAdapter.js
 var _fsPromises = require('fs/promises')
 var _fsSync = require('fs')
 var _path3 = require('path')
@@ -3586,11 +3836,11 @@ var FileStateAdapter = class {
 	}
 }
 
-
+// messageRecovery.js
 var DEFAULT_CONFIG16 = {
 	maxTrackedChats: 1e3,
 	maxGapMs: 30 * 6e4,
-	
+	// 30 minutes
 	persistDebounceMs: 2e3,
 	onGapFilled: () => {},
 	logger: {
@@ -3602,7 +3852,7 @@ var DEFAULT_CONFIG16 = {
 function messageRecovery(sock, config) {
 	const cfg = { ...DEFAULT_CONFIG16, ...config }
 	const logger = cfg.logger
-	const lastSeen =  new Map()
+	const lastSeen = /* @__PURE__ */ new Map()
 	let disconnectedAt = null
 	let totalRecovered = 0
 	let lastReconnectAt = null
@@ -3702,7 +3952,7 @@ function messageRecovery(sock, config) {
 				loggedFetchWarning = true
 			}
 			disconnectedAt = null
-			lastReconnectAt =  new Date()
+			lastReconnectAt = /* @__PURE__ */ new Date()
 			lastGapMs = gapMs
 			await cfg.onRecoveryComplete?.({
 				chats: 0,
@@ -3715,7 +3965,7 @@ function messageRecovery(sock, config) {
 			try {
 				const messages = await sock.fetchMessageHistory(jid, 50, {
 					before: void 0
-					
+					// Get latest
 				})
 				if (!messages || !Array.isArray(messages)) continue
 				const gapMessages = messages.filter(msg => {
@@ -3748,7 +3998,7 @@ function messageRecovery(sock, config) {
 			}
 		}
 		totalRecovered += recovered
-		lastReconnectAt =  new Date()
+		lastReconnectAt = /* @__PURE__ */ new Date()
 		lastGapMs = gapMs
 		disconnectedAt = null
 		logger.info?.(
@@ -3835,33 +4085,29 @@ function messageRecovery(sock, config) {
 	}
 }
 
-
+// deviceFingerprint.js
 var DEFAULT_APP_VERSION_POOL = [
-	[2, 25, 10, 67],
-	[2, 25, 10, 68],
-	[2, 25, 9, 96],
-	[2, 25, 8, 77],
-	[2, 25, 7, 85],
-	[2, 25, 6, 98],
-	[2, 24, 22, 78],
-	[2, 24, 20, 86]
+	[2, 24, 5, 18],
+	[2, 24, 5, 17],
+	[2, 24, 4, 77],
+	[2, 24, 5, 15],
+	[2, 24, 3, 91],
+	[2, 24, 5, 20]
 ]
-var DEFAULT_OS_VERSION_POOL = ['11', '12', '13', '14', '15']
+var DEFAULT_OS_VERSION_POOL = ['10', '11', '12', '13', '14']
 var DEFAULT_DEVICE_MODEL_POOL = [
-	'Pixel 8',
-	'Pixel 9',
+	'Pixel 6',
 	'Pixel 7',
-	'Galaxy S24',
-	'Galaxy S23',
 	'Galaxy S22',
-	'Xiaomi 14',
+	'Galaxy S23',
 	'Xiaomi 13',
-	'OnePlus 12',
+	'Xiaomi 12',
 	'OnePlus 11',
 	'Moto G84',
-	'Realme 12',
-	'Vivo V30',
-	'Oppo Find X7'
+	'Moto G54',
+	'Realme 11',
+	'Vivo V29',
+	'Oppo Find X6'
 ]
 var SeededRandom = class {
 	state
@@ -3901,7 +4147,7 @@ function generateFingerprint(config = {}, sessionId) {
 	const deviceModel = enabled && randomizeDeviceModel ? rng.pick(deviceModelPool) : deviceModelPool[0]
 	return {
 		appVersion: [...appVersion],
-		
+		// Copy to avoid mutation
 		osVersion,
 		deviceModel,
 		sessionId: finalSessionId
@@ -3918,7 +4164,7 @@ function applyFingerprint(socketConfig, fp) {
 	return config
 }
 
-
+// credsSnapshot.js
 var import_fs = require('fs')
 var path2 = __toESM(require('path'), 1)
 var noop = () => {}
@@ -3938,7 +4184,7 @@ function credsSnapshot(config) {
 				return null
 			}
 			await import_fs.promises.mkdir(snapshotDir, { recursive: true })
-			const timestamp =  new Date().toISOString().replace(/[:.]/g, '-')
+			const timestamp = /* @__PURE__ */ new Date().toISOString().replace(/[:.]/g, '-')
 			const snapshotPath = path2.join(snapshotDir, `creds-${timestamp}.json`)
 			const tmpPath = `${snapshotPath}.tmp`
 			await import_fs.promises.copyFile(credsPath, tmpPath)
@@ -4019,7 +4265,7 @@ function credsSnapshot(config) {
 	}
 }
 
-
+// readReceiptVariance.js
 function gaussianRandom() {
 	let u = 0
 	let v = 0
@@ -4029,7 +4275,7 @@ function gaussianRandom() {
 }
 function readReceiptVariance(config = {}) {
 	const { meanMs = 1500, stdDevMs = 800, minMs = 200, maxMs = 8e3, skipIfOlderThanMs = 6e4 } = config
-	const pendingTimers =  new Set()
+	const pendingTimers = /* @__PURE__ */ new Set()
 	function delayMs() {
 		const gaussian = gaussianRandom()
 		const value = meanMs + gaussian * stdDevMs
@@ -4086,7 +4332,7 @@ function readReceiptVariance(config = {}) {
 	}
 }
 
-
+// proxyRotator.js
 var import_node_module = require('node:module')
 var require2 = (0, import_node_module.createRequire)(__importMetaUrl)
 var NoopLogger = {
@@ -4102,7 +4348,7 @@ function proxyRotator(config) {
 		scheduledIntervalMs = 0,
 		maxFailures = 3,
 		deadCooldownMs = 6e5,
-		
+		// 10 minutes
 		logger = NoopLogger
 	} = config
 	if (!pool || pool.length === 0) {
@@ -4124,7 +4370,7 @@ function proxyRotator(config) {
 	let totalRotations = 0
 	const rotationsByTrigger = {}
 	let scheduledTimer = null
-	const agentCache =  new Map()
+	const agentCache = /* @__PURE__ */ new Map()
 	const moduleCache = {}
 	function buildProxyUrl(endpoint) {
 		const { type, host, port, username, password } = endpoint
@@ -4263,7 +4509,7 @@ function proxyRotator(config) {
 		} else {
 			currentIndex = nextIdx
 		}
-		states[currentIndex].lastUsedAt =  new Date()
+		states[currentIndex].lastUsedAt = /* @__PURE__ */ new Date()
 		totalRotations++
 		rotationsByTrigger[reason] = (rotationsByTrigger[reason] || 0) + 1
 		const label = states[currentIndex].endpoint.label || states[currentIndex].endpoint.host
@@ -4331,7 +4577,7 @@ function proxyRotator(config) {
 		}, scheduledIntervalMs)
 		logger.info?.(`Scheduled rotation enabled (every ${scheduledIntervalMs}ms)`)
 	}
-	states[0].lastUsedAt =  new Date()
+	states[0].lastUsedAt = /* @__PURE__ */ new Date()
 	return {
 		currentAgent: currentAgentImpl,
 		current: currentImpl,
@@ -4342,7 +4588,7 @@ function proxyRotator(config) {
 		getStats: getStatsImpl
 	}
 }
-
+// Annotate the CommonJS export names for ESM import in node:
 0 &&
 	(module.exports = {
 		AntiBan,