baileys-antiban 4.7.0 → 4.9.0

package/dist/antiban.d.ts

@@ -21,6 +21,7 @@ import { ReplyRatioGuard, type ReplyRatioConfig, type ReplyRatioStats } from './
 import { ContactGraphWarmer, type ContactGraphConfig, type ContactGraphStats } from './contactGraph.js';
 import { PresenceChoreographer, type PresenceChoreographerConfig, type PresenceChoreographerStats } from './presenceChoreographer.js';
 import { RetryReasonTracker, type RetryTrackerConfig, type RetryStats } from './retryTracker.js';
+import { TopologyThrottler, type TopologyThrottlerConfig } from './topologyThrottler.js';
 import { PostReconnectThrottle, type ReconnectThrottleConfig, type ReconnectThrottleStats } from './reconnectThrottle.js';
 import { LidResolver, type LidResolverConfig, type LidResolverStats } from './lidResolver.js';
 import { JidCanonicalizer, type JidCanonicalizerConfig, type JidCanonicalizerStats } from './jidCanonicalizer.js';
@@ -29,6 +30,8 @@ import { BanRecoveryOrchestrator, type RecoveryStatus } from './banRecoveryOrche
 import { type AntiBanInput, type ResolvedConfig } from './presets.js';
 import { type DeliveryTrackerStats } from './deliveryTracker.js';
 import { type InstanceCoordinatorStats } from './instanceCoordinator.js';
+import { MessageTypeRegistry } from './messageTypeRegistry.js';
+import { type AntibanSnapshot } from './stateExport.js';
 export interface AntiBanConfigLegacy {
     rateLimiter?: Partial<RateLimiterConfig>;
     warmUp?: Partial<WarmUpConfig>;
@@ -39,6 +42,7 @@ export interface AntiBanConfigLegacy {
     presence?: Partial<PresenceChoreographerConfig>;
     retryTracker?: Partial<RetryTrackerConfig>;
     reconnectThrottle?: Partial<ReconnectThrottleConfig>;
+    topologyThrottler?: Partial<TopologyThrottlerConfig>;
     lidResolver?: LidResolverConfig;
     jidCanonicalizer?: JidCanonicalizerConfig;
     sessionStability?: {
@@ -70,12 +74,26 @@ export interface AntiBanStats {
     presence?: PresenceChoreographerStats;
     retryTracker?: RetryStats | null;
     reconnectThrottle?: ReconnectThrottleStats | null;
+    topologyThrottler?: {
+        newContactsThisHour: number;
+        newContactsToday: number;
+        replyRatio: number | null;
+        blockedRatio: number | null;
+        hotspots: Array<{
+            sourceGroup: string;
+            count: number;
+        }>;
+    } | null;
     lidResolver?: LidResolverStats | null;
     jidCanonicalizer?: JidCanonicalizerStats | null;
     sessionStability?: SessionHealthStats | null;
     banRecovery?: RecoveryStatus | null;
     deliveryTracker: DeliveryTrackerStats;
     instanceCoordinator?: InstanceCoordinatorStats | null;
+    messageRegistry?: {
+        typeCount: number;
+        warningCount: number;
+    } | null;
 }
 export declare class AntiBan {
     private rateLimiter;
@@ -87,12 +105,14 @@ export declare class AntiBan {
     private presenceChoreographer;
     private retryTrackerModule;
     private reconnectThrottleModule;
+    private topologyThrottlerModule;
     private lidResolverModule;
     private jidCanonicalizerModule;
     private sessionStabilityMonitor;
     private banRecovery;
     private deliveryTracker;
     private instanceCoordinator;
+    private messageTypeRegistry;
     private stateManager;
     private resolvedConfig;
     private logging;
@@ -153,6 +173,10 @@ export declare class AntiBan {
     get retryTracker(): RetryReasonTracker;
     /** Get the reconnect throttle for direct access */
     get reconnectThrottle(): PostReconnectThrottle;
+    /** Get the topology throttler for direct access */
+    get topologyThrottler(): TopologyThrottler | null;
+    /** Get the topology throttler for direct access (alias) */
+    get topology(): TopologyThrottler | null;
     /** Get the LID resolver for direct access */
     get lidResolver(): LidResolver | null;
     /** Get the JID canonicalizer for direct access */
@@ -161,6 +185,8 @@ export declare class AntiBan {
     get sessionStability(): SessionHealthMonitor | null;
     /** Get the ban recovery orchestrator for direct access */
     get recoveryOrchestrator(): BanRecoveryOrchestrator;
+    /** Get the message type registry for direct access */
+    get messageRegistry(): MessageTypeRegistry | null;
     /**
      * Export warm-up state for persistence between restarts
      */
@@ -177,9 +203,20 @@ export declare class AntiBan {
      * Reset everything (use after a ban period)
      */
     reset(): void;
+    private isGroupJid;
     private runAdaptiveCheck;
     private persistStateDebounced;
     private persistStateImmediate;
+    /**
+     * Export unified state snapshot for Redis failover or cross-instance migration.
+     * Returns snapshot of all module states (warmup, health, rate limiter, circuits, etc.)
+     */
+    exportState(): AntibanSnapshot;
+    /**
+     * Import unified state snapshot.
+     * CRDT-safe for rate limiters (never overwrites higher counts).
+     */
+    importState(snapshot: AntibanSnapshot): void;
     /**
      * Clean up all timers and resources.
      * Call this when disposing of the AntiBan instance or when the socket closes.

package/dist/antiban.js

@@ -21,6 +21,7 @@ import { ReplyRatioGuard } from './replyRatio.js';
 import { ContactGraphWarmer } from './contactGraph.js';
 import { PresenceChoreographer } from './presenceChoreographer.js';
 import { RetryReasonTracker } from './retryTracker.js';
+import { TopologyThrottler } from './topologyThrottler.js';
 import { PostReconnectThrottle } from './reconnectThrottle.js';
 import { LidResolver } from './lidResolver.js';
 import { JidCanonicalizer } from './jidCanonicalizer.js';
@@ -31,6 +32,8 @@ import { StateManager } from './persist.js';
 import { shouldUseGroupProfile, applyGroupMultiplier } from './profiles.js';
 import { DeliveryTracker } from './deliveryTracker.js';
 import { InstanceCoordinator } from './instanceCoordinator.js';
+import { MessageTypeRegistry } from './messageTypeRegistry.js';
+import { exportAntibanState, importAntibanState } from './stateExport.js';
 function isLegacyConfig(cfg) {
     if (typeof cfg !== 'object' || cfg === null)
         return false;
@@ -103,12 +106,14 @@ export class AntiBan {
     presenceChoreographer;
     retryTrackerModule;
     reconnectThrottleModule;
+    topologyThrottlerModule = null;
     lidResolverModule = null;
     jidCanonicalizerModule = null;
     sessionStabilityMonitor = null;
     banRecovery;
     deliveryTracker;
     instanceCoordinator = null;
+    messageTypeRegistry = null;
     stateManager = null;
     resolvedConfig;
     logging;
@@ -243,6 +248,13 @@ export class AntiBan {
             ...(legacyPassthrough?.reconnectThrottle || {}),
             baselineRatePerMinute: () => this.rateLimiter.getStats().limits.perMinute,
         });
+        // Initialize topology throttler if configured
+        if (legacyPassthrough?.topologyThrottler) {
+            this.topologyThrottlerModule = new TopologyThrottler(legacyPassthrough.topologyThrottler);
+            if (this.logging) {
+                console.log(`[baileys-antiban] 🌐 Topology throttler enabled — max ${legacyPassthrough.topologyThrottler.maxNewContactsPerHour || 5}/hr, ${legacyPassthrough.topologyThrottler.maxNewContactsPerDay || 20}/day new contacts`);
+            }
+        }
         // Initialize LID resolver and canonicalizer if configured
         // If jidCanonicalizer is enabled but no resolver provided, create standalone resolver
         if (legacyPassthrough?.jidCanonicalizer?.enabled) {
@@ -297,6 +309,13 @@ export class AntiBan {
                 console.log(`[baileys-antiban] 🌐 Instance coordination enabled: ${cfg.instanceCoordinator}`);
             }
         }
+        // Initialize message type registry if configured
+        if (cfg.messageTypeRegistry) {
+            this.messageTypeRegistry = new MessageTypeRegistry();
+            if (this.logging) {
+                console.log(`[baileys-antiban] 📝 Message type registry enabled`);
+            }
+        }
     }
     /**
      * Check if a message can be sent and get required delay.
@@ -371,6 +390,46 @@ export class AntiBan {
                 health: healthStatus,
             };
         }
+        // Topology throttler check — only applies to DMs to new/unknown contacts
+        if (this.topologyThrottlerModule && !this.isGroupJid(recipient)) {
+            const knownChats = this.rateLimiter.getKnownChats();
+            const isNewContact = !knownChats.has(recipient);
+            if (isNewContact) {
+                // Check if we can send to new contact based on topology limits
+                const topologyDecision = this.topologyThrottlerModule.canSendToNewContact();
+                if (!topologyDecision.allowed) {
+                    this.stats.messagesBlocked++;
+                    if (this.logging) {
+                        console.log(`[baileys-antiban] 🌐 BLOCKED — topology: ${topologyDecision.reason}`);
+                    }
+                    return {
+                        allowed: false,
+                        delayMs: topologyDecision.retryAfterMs || 0,
+                        reason: `Topology: ${topologyDecision.reason}`,
+                        health: healthStatus,
+                    };
+                }
+                // Assess contact risk
+                const riskAssessment = this.topologyThrottlerModule.assessContact(recipient, {
+                    messageType: 'dm',
+                    hasReplied: false,
+                    knownGroups: [],
+                });
+                if (riskAssessment.recommendation === 'abort') {
+                    this.stats.messagesBlocked++;
+                    if (this.logging) {
+                        console.log(`[baileys-antiban] ⛔ BLOCKED — contact risk ${riskAssessment.risk} (score ${riskAssessment.score}): ${riskAssessment.reasons.join(', ')}`);
+                    }
+                    return {
+                        allowed: false,
+                        delayMs: 0,
+                        reason: `Contact risk too high: ${riskAssessment.reasons.join(', ')}`,
+                        health: healthStatus,
+                    };
+                }
+                // If delay recommended, we'll add it to the total delay later
+            }
+        }
         // Reply ratio check
         const replyRatioDecision = this.replyRatioGuard.beforeSend(recipient);
         if (!replyRatioDecision.allowed) {
@@ -472,6 +531,24 @@ export class AntiBan {
                 }
             }
         }
+        // Topology throttler recommended delay
+        if (this.topologyThrottlerModule && !this.isGroupJid(recipient)) {
+            const knownChats = this.rateLimiter.getKnownChats();
+            const isNewContact = !knownChats.has(recipient);
+            if (isNewContact) {
+                const riskAssessment = this.topologyThrottlerModule.assessContact(recipient, {
+                    messageType: 'dm',
+                    hasReplied: false,
+                    knownGroups: [],
+                });
+                if (riskAssessment.recommendation === 'delay' && riskAssessment.suggestedDelayMs) {
+                    delay += riskAssessment.suggestedDelayMs;
+                    if (this.logging) {
+                        console.log(`[baileys-antiban] ⚠️  Topology risk ${riskAssessment.risk} — adding ${Math.floor(riskAssessment.suggestedDelayMs / 60000)}min delay`);
+                    }
+                }
+            }
+        }
         // Roll for distraction pause
         const distractionCheck = this.presenceChoreographer.shouldPauseForDistraction();
         if (distractionCheck.pause) {
@@ -503,6 +580,7 @@ export class AntiBan {
         this.rateLimiter.record(recipient, content);
         this.warmUp.record();
         this.replyRatioGuard.recordSent(recipient);
+        this.topologyThrottlerModule?.recordSent(recipient);
         this.stats.messagesAllowed++;
         if (msgId) {
             this.deliveryTracker.onMessageSent(msgId);
@@ -542,6 +620,7 @@ export class AntiBan {
     onIncomingMessage(jid, msgText) {
         this.replyRatioGuard.recordReceived(jid);
         this.contactGraphWarmer.onIncomingMessage(jid);
+        this.topologyThrottlerModule?.recordReplied(jid);
         return this.replyRatioGuard.suggestReply(jid, msgText);
     }
     /**
@@ -585,6 +664,9 @@ export class AntiBan {
         if (this.reconnectThrottleModule['config']?.enabled) {
             stats.reconnectThrottle = this.reconnectThrottleModule.getStats();
         }
+        if (this.topologyThrottlerModule) {
+            stats.topologyThrottler = this.topologyThrottlerModule.getTopologyStats();
+        }
         if (this.lidResolverModule) {
             stats.lidResolver = this.lidResolverModule.getStats();
         }
@@ -597,6 +679,13 @@ export class AntiBan {
         if (this.instanceCoordinator) {
             stats.instanceCoordinator = this.instanceCoordinator.getStats();
         }
+        if (this.messageTypeRegistry) {
+            const warnings = this.messageTypeRegistry.getWarnings();
+            stats.messageRegistry = {
+                typeCount: Array.from(this.messageTypeRegistry.types.keys()).length,
+                warningCount: warnings.length,
+            };
+        }
         return stats;
     }
     /** Get the timelock guard for direct access */
@@ -623,6 +712,14 @@ export class AntiBan {
     get reconnectThrottle() {
         return this.reconnectThrottleModule;
     }
+    /** Get the topology throttler for direct access */
+    get topologyThrottler() {
+        return this.topologyThrottlerModule;
+    }
+    /** Get the topology throttler for direct access (alias) */
+    get topology() {
+        return this.topologyThrottlerModule;
+    }
     /** Get the LID resolver for direct access */
     get lidResolver() {
         return this.lidResolverModule;
@@ -639,6 +736,10 @@ export class AntiBan {
     get recoveryOrchestrator() {
         return this.banRecovery;
     }
+    /** Get the message type registry for direct access */
+    get messageRegistry() {
+        return this.messageTypeRegistry;
+    }
     /**
      * Export warm-up state for persistence between restarts
      */
@@ -680,6 +781,9 @@ export class AntiBan {
             console.log('[baileys-antiban] 🔄 Reset — starting fresh warm-up');
         }
     }
+    isGroupJid(jid) {
+        return jid.endsWith('@g.us') || jid.endsWith('@newsletter');
+    }
     runAdaptiveCheck() {
         const delivery = this.deliveryTracker.getStats();
         // Need min sample to be meaningful
@@ -731,6 +835,35 @@ export class AntiBan {
         };
         this.stateManager.saveImmediate(state);
     }
+    /**
+     * Export unified state snapshot for Redis failover or cross-instance migration.
+     * Returns snapshot of all module states (warmup, health, rate limiter, circuits, etc.)
+     */
+    exportState() {
+        return exportAntibanState({
+            warmup: this.warmUp,
+            health: this.health,
+            rateLimiter: this.rateLimiter,
+            timelockGuard: this.timelockGuard,
+            messageRegistry: this.messageTypeRegistry || undefined,
+            topologyThrottler: this.topologyThrottlerModule || undefined,
+            instanceId: this.resolvedConfig.instanceId,
+        });
+    }
+    /**
+     * Import unified state snapshot.
+     * CRDT-safe for rate limiters (never overwrites higher counts).
+     */
+    importState(snapshot) {
+        importAntibanState(snapshot, {
+            warmup: this.warmUp,
+            health: this.health,
+            rateLimiter: this.rateLimiter,
+            timelockGuard: this.timelockGuard,
+            messageRegistry: this.messageTypeRegistry || undefined,
+            topologyThrottler: this.topologyThrottlerModule || undefined,
+        });
+    }
     /**
      * Clean up all timers and resources.
      * Call this when disposing of the AntiBan instance or when the socket closes.
@@ -746,6 +879,7 @@ export class AntiBan {
         this.jidCanonicalizerModule?.destroy();
         this.lidResolverModule?.destroy();
         this.sessionStabilityMonitor?.reset();
+        this.messageTypeRegistry?.cleanup();
         if (this.logging) {
             console.log('[baileys-antiban] 🧹 Destroyed — all timers cleared');
         }

package/dist/cjs/antiban.js

@@ -24,6 +24,7 @@ const replyRatio_js_1 = require("./replyRatio.js");
 const contactGraph_js_1 = require("./contactGraph.js");
 const presenceChoreographer_js_1 = require("./presenceChoreographer.js");
 const retryTracker_js_1 = require("./retryTracker.js");
+const topologyThrottler_js_1 = require("./topologyThrottler.js");
 const reconnectThrottle_js_1 = require("./reconnectThrottle.js");
 const lidResolver_js_1 = require("./lidResolver.js");
 const jidCanonicalizer_js_1 = require("./jidCanonicalizer.js");
@@ -34,6 +35,8 @@ const persist_js_1 = require("./persist.js");
 const profiles_js_1 = require("./profiles.js");
 const deliveryTracker_js_1 = require("./deliveryTracker.js");
 const instanceCoordinator_js_1 = require("./instanceCoordinator.js");
+const messageTypeRegistry_js_1 = require("./messageTypeRegistry.js");
+const stateExport_js_1 = require("./stateExport.js");
 function isLegacyConfig(cfg) {
     if (typeof cfg !== 'object' || cfg === null)
         return false;
@@ -106,12 +109,14 @@ class AntiBan {
     presenceChoreographer;
     retryTrackerModule;
     reconnectThrottleModule;
+    topologyThrottlerModule = null;
     lidResolverModule = null;
     jidCanonicalizerModule = null;
     sessionStabilityMonitor = null;
     banRecovery;
     deliveryTracker;
     instanceCoordinator = null;
+    messageTypeRegistry = null;
     stateManager = null;
     resolvedConfig;
     logging;
@@ -246,6 +251,13 @@ class AntiBan {
             ...(legacyPassthrough?.reconnectThrottle || {}),
             baselineRatePerMinute: () => this.rateLimiter.getStats().limits.perMinute,
         });
+        // Initialize topology throttler if configured
+        if (legacyPassthrough?.topologyThrottler) {
+            this.topologyThrottlerModule = new topologyThrottler_js_1.TopologyThrottler(legacyPassthrough.topologyThrottler);
+            if (this.logging) {
+                console.log(`[baileys-antiban] 🌐 Topology throttler enabled — max ${legacyPassthrough.topologyThrottler.maxNewContactsPerHour || 5}/hr, ${legacyPassthrough.topologyThrottler.maxNewContactsPerDay || 20}/day new contacts`);
+            }
+        }
         // Initialize LID resolver and canonicalizer if configured
         // If jidCanonicalizer is enabled but no resolver provided, create standalone resolver
         if (legacyPassthrough?.jidCanonicalizer?.enabled) {
@@ -300,6 +312,13 @@ class AntiBan {
                 console.log(`[baileys-antiban] 🌐 Instance coordination enabled: ${cfg.instanceCoordinator}`);
             }
         }
+        // Initialize message type registry if configured
+        if (cfg.messageTypeRegistry) {
+            this.messageTypeRegistry = new messageTypeRegistry_js_1.MessageTypeRegistry();
+            if (this.logging) {
+                console.log(`[baileys-antiban] 📝 Message type registry enabled`);
+            }
+        }
     }
     /**
      * Check if a message can be sent and get required delay.
@@ -374,6 +393,46 @@ class AntiBan {
                 health: healthStatus,
             };
         }
+        // Topology throttler check — only applies to DMs to new/unknown contacts
+        if (this.topologyThrottlerModule && !this.isGroupJid(recipient)) {
+            const knownChats = this.rateLimiter.getKnownChats();
+            const isNewContact = !knownChats.has(recipient);
+            if (isNewContact) {
+                // Check if we can send to new contact based on topology limits
+                const topologyDecision = this.topologyThrottlerModule.canSendToNewContact();
+                if (!topologyDecision.allowed) {
+                    this.stats.messagesBlocked++;
+                    if (this.logging) {
+                        console.log(`[baileys-antiban] 🌐 BLOCKED — topology: ${topologyDecision.reason}`);
+                    }
+                    return {
+                        allowed: false,
+                        delayMs: topologyDecision.retryAfterMs || 0,
+                        reason: `Topology: ${topologyDecision.reason}`,
+                        health: healthStatus,
+                    };
+                }
+                // Assess contact risk
+                const riskAssessment = this.topologyThrottlerModule.assessContact(recipient, {
+                    messageType: 'dm',
+                    hasReplied: false,
+                    knownGroups: [],
+                });
+                if (riskAssessment.recommendation === 'abort') {
+                    this.stats.messagesBlocked++;
+                    if (this.logging) {
+                        console.log(`[baileys-antiban] ⛔ BLOCKED — contact risk ${riskAssessment.risk} (score ${riskAssessment.score}): ${riskAssessment.reasons.join(', ')}`);
+                    }
+                    return {
+                        allowed: false,
+                        delayMs: 0,
+                        reason: `Contact risk too high: ${riskAssessment.reasons.join(', ')}`,
+                        health: healthStatus,
+                    };
+                }
+                // If delay recommended, we'll add it to the total delay later
+            }
+        }
         // Reply ratio check
         const replyRatioDecision = this.replyRatioGuard.beforeSend(recipient);
         if (!replyRatioDecision.allowed) {
@@ -475,6 +534,24 @@ class AntiBan {
                 }
             }
         }
+        // Topology throttler recommended delay
+        if (this.topologyThrottlerModule && !this.isGroupJid(recipient)) {
+            const knownChats = this.rateLimiter.getKnownChats();
+            const isNewContact = !knownChats.has(recipient);
+            if (isNewContact) {
+                const riskAssessment = this.topologyThrottlerModule.assessContact(recipient, {
+                    messageType: 'dm',
+                    hasReplied: false,
+                    knownGroups: [],
+                });
+                if (riskAssessment.recommendation === 'delay' && riskAssessment.suggestedDelayMs) {
+                    delay += riskAssessment.suggestedDelayMs;
+                    if (this.logging) {
+                        console.log(`[baileys-antiban] ⚠️  Topology risk ${riskAssessment.risk} — adding ${Math.floor(riskAssessment.suggestedDelayMs / 60000)}min delay`);
+                    }
+                }
+            }
+        }
         // Roll for distraction pause
         const distractionCheck = this.presenceChoreographer.shouldPauseForDistraction();
         if (distractionCheck.pause) {
@@ -506,6 +583,7 @@ class AntiBan {
         this.rateLimiter.record(recipient, content);
         this.warmUp.record();
         this.replyRatioGuard.recordSent(recipient);
+        this.topologyThrottlerModule?.recordSent(recipient);
         this.stats.messagesAllowed++;
         if (msgId) {
             this.deliveryTracker.onMessageSent(msgId);
@@ -545,6 +623,7 @@ class AntiBan {
     onIncomingMessage(jid, msgText) {
         this.replyRatioGuard.recordReceived(jid);
         this.contactGraphWarmer.onIncomingMessage(jid);
+        this.topologyThrottlerModule?.recordReplied(jid);
         return this.replyRatioGuard.suggestReply(jid, msgText);
     }
     /**
@@ -588,6 +667,9 @@ class AntiBan {
         if (this.reconnectThrottleModule['config']?.enabled) {
             stats.reconnectThrottle = this.reconnectThrottleModule.getStats();
         }
+        if (this.topologyThrottlerModule) {
+            stats.topologyThrottler = this.topologyThrottlerModule.getTopologyStats();
+        }
         if (this.lidResolverModule) {
             stats.lidResolver = this.lidResolverModule.getStats();
         }
@@ -600,6 +682,13 @@ class AntiBan {
         if (this.instanceCoordinator) {
             stats.instanceCoordinator = this.instanceCoordinator.getStats();
         }
+        if (this.messageTypeRegistry) {
+            const warnings = this.messageTypeRegistry.getWarnings();
+            stats.messageRegistry = {
+                typeCount: Array.from(this.messageTypeRegistry.types.keys()).length,
+                warningCount: warnings.length,
+            };
+        }
         return stats;
     }
     /** Get the timelock guard for direct access */
@@ -626,6 +715,14 @@ class AntiBan {
     get reconnectThrottle() {
         return this.reconnectThrottleModule;
     }
+    /** Get the topology throttler for direct access */
+    get topologyThrottler() {
+        return this.topologyThrottlerModule;
+    }
+    /** Get the topology throttler for direct access (alias) */
+    get topology() {
+        return this.topologyThrottlerModule;
+    }
     /** Get the LID resolver for direct access */
     get lidResolver() {
         return this.lidResolverModule;
@@ -642,6 +739,10 @@ class AntiBan {
     get recoveryOrchestrator() {
         return this.banRecovery;
     }
+    /** Get the message type registry for direct access */
+    get messageRegistry() {
+        return this.messageTypeRegistry;
+    }
     /**
      * Export warm-up state for persistence between restarts
      */
@@ -683,6 +784,9 @@ class AntiBan {
             console.log('[baileys-antiban] 🔄 Reset — starting fresh warm-up');
         }
     }
+    isGroupJid(jid) {
+        return jid.endsWith('@g.us') || jid.endsWith('@newsletter');
+    }
     runAdaptiveCheck() {
         const delivery = this.deliveryTracker.getStats();
         // Need min sample to be meaningful
@@ -734,6 +838,35 @@ class AntiBan {
         };
         this.stateManager.saveImmediate(state);
     }
+    /**
+     * Export unified state snapshot for Redis failover or cross-instance migration.
+     * Returns snapshot of all module states (warmup, health, rate limiter, circuits, etc.)
+     */
+    exportState() {
+        return (0, stateExport_js_1.exportAntibanState)({
+            warmup: this.warmUp,
+            health: this.health,
+            rateLimiter: this.rateLimiter,
+            timelockGuard: this.timelockGuard,
+            messageRegistry: this.messageTypeRegistry || undefined,
+            topologyThrottler: this.topologyThrottlerModule || undefined,
+            instanceId: this.resolvedConfig.instanceId,
+        });
+    }
+    /**
+     * Import unified state snapshot.
+     * CRDT-safe for rate limiters (never overwrites higher counts).
+     */
+    importState(snapshot) {
+        (0, stateExport_js_1.importAntibanState)(snapshot, {
+            warmup: this.warmUp,
+            health: this.health,
+            rateLimiter: this.rateLimiter,
+            timelockGuard: this.timelockGuard,
+            messageRegistry: this.messageTypeRegistry || undefined,
+            topologyThrottler: this.topologyThrottlerModule || undefined,
+        });
+    }
     /**
      * Clean up all timers and resources.
      * Call this when disposing of the AntiBan instance or when the socket closes.
@@ -749,6 +882,7 @@ class AntiBan {
         this.jidCanonicalizerModule?.destroy();
         this.lidResolverModule?.destroy();
         this.sessionStabilityMonitor?.reset();
+        this.messageTypeRegistry?.cleanup();
         if (this.logging) {
             console.log('[baileys-antiban] 🧹 Destroyed — all timers cleared');
         }

package/dist/cjs/index.js

@@ -10,7 +10,7 @@
  */
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.getRetryJitter = exports.getTypingJitter = exports.getMessageSendJitter = exports.applySessionFingerprint = exports.generateSessionFingerprint = exports.proxyRotator = exports.readReceiptVariance = exports.credsSnapshot = exports.applyFingerprint = exports.generateFingerprint = exports.messageRecovery = exports.applyGroupMultiplier = exports.shouldUseGroupProfile = exports.isBroadcast = exports.isNewsletter = exports.isGroup = exports.StateManager = exports.PRESETS = exports.resolveConfig = exports.FileStateAdapter = exports.Scheduler = exports.WebhookAlerts = exports.ContentVariator = exports.MessageQueue = exports.wrapSocketWithFingerprint = exports.wrapSocket = exports.getRetryReasonDescription = exports.isMacError = exports.parseRetryReason = exports.MAC_ERROR_CODES = exports.MessageRetryReason = exports.createLidFirstResolver = exports.LidFirstResolver = exports.DeafSessionDetector = exports.classifyDisconnect = exports.wrapWithSessionStability = exports.SessionHealthMonitor = exports.JidCanonicalizer = exports.LidResolver = exports.PostReconnectThrottle = exports.RetryReasonTracker = exports.getCircadianMultiplier = exports.PresenceChoreographer = exports.ContactGraphWarmer = exports.ReplyRatioGuard = exports.TimelockGuard = exports.HealthMonitor = exports.WarmUp = exports.RateLimiter = exports.AntiBan = void 0;
-exports.createPeriodicExporter = exports.createMetricsHandler = exports.exportPrometheusMetrics = exports.createConsoleLogger = exports.createHumanEntropyService = exports.HumanEntropyService = exports.createInMemoryEventStoreBackend = exports.createMySQLEventStoreBackend = exports.createFleetEventStore = exports.createJidCircuitBreaker = exports.JidCircuitBreaker = exports.InstanceCoordinator = exports.DeliveryTracker = exports.BanRecoveryOrchestrator = exports.LegitimacySignalInjector = exports.GROUP_OP_ERRORS = exports.extractPrivacyBlock = exports.classifyGroupOpError = exports.GroupOperationGuard = exports.AbortError = exports.STEALTH_BROWSER_POOL = exports.rampPresenceAfterConnect = exports.getStealthSocketConfig = exports.createStealthFingerprint = exports.getBatteryState = exports.getVoiceNoteMetadata = void 0;
+exports.createPeriodicExporter = exports.createMetricsHandler = exports.exportPrometheusMetrics = exports.createConsoleLogger = exports.TopologyThrottler = exports.importAntibanState = exports.exportAntibanState = exports.MessageTypeRegistry = exports.createHumanEntropyService = exports.HumanEntropyService = exports.createInMemoryEventStoreBackend = exports.createMySQLEventStoreBackend = exports.createFleetEventStore = exports.createJidCircuitBreaker = exports.JidCircuitBreaker = exports.InstanceCoordinator = exports.DeliveryTracker = exports.BanRecoveryOrchestrator = exports.LegitimacySignalInjector = exports.GROUP_OP_ERRORS = exports.extractPrivacyBlock = exports.classifyGroupOpError = exports.GroupOperationGuard = exports.AbortError = exports.STEALTH_BROWSER_POOL = exports.rampPresenceAfterConnect = exports.getStealthSocketConfig = exports.createStealthFingerprint = exports.getBatteryState = exports.getVoiceNoteMetadata = void 0;
 // Core
 var antiban_js_1 = require("./antiban.js");
 Object.defineProperty(exports, "AntiBan", { enumerable: true, get: function () { return antiban_js_1.AntiBan; } });
@@ -143,6 +143,14 @@ Object.defineProperty(exports, "createInMemoryEventStoreBackend", { enumerable:
 var humanEntropy_js_1 = require("./humanEntropy.js");
 Object.defineProperty(exports, "HumanEntropyService", { enumerable: true, get: function () { return humanEntropy_js_1.HumanEntropyService; } });
 Object.defineProperty(exports, "createHumanEntropyService", { enumerable: true, get: function () { return humanEntropy_js_1.createHumanEntropyService; } });
+// v4.8 new modules
+var messageTypeRegistry_js_1 = require("./messageTypeRegistry.js");
+Object.defineProperty(exports, "MessageTypeRegistry", { enumerable: true, get: function () { return messageTypeRegistry_js_1.MessageTypeRegistry; } });
+var stateExport_js_1 = require("./stateExport.js");
+Object.defineProperty(exports, "exportAntibanState", { enumerable: true, get: function () { return stateExport_js_1.exportAntibanState; } });
+Object.defineProperty(exports, "importAntibanState", { enumerable: true, get: function () { return stateExport_js_1.importAntibanState; } });
+var topologyThrottler_js_1 = require("./topologyThrottler.js");
+Object.defineProperty(exports, "TopologyThrottler", { enumerable: true, get: function () { return topologyThrottler_js_1.TopologyThrottler; } });
 // Observability
 var observability_js_1 = require("./observability.js");
 Object.defineProperty(exports, "createConsoleLogger", { enumerable: true, get: function () { return observability_js_1.createConsoleLogger; } });