baileys-antiban 3.8.8 → 3.8.10

package/CHANGELOG.md

@@ -5,6 +5,16 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [3.8.9] - 2026-05-19
+
+### Fixed
+- **`maxIdenticalMessages`, `identicalMessageWindowMs`, `burstAllowance` silently ignored.** These fields were missing from `ResolvedConfig` so passing them in flat config had no effect — the `RateLimiter` used its hardcoded defaults (3/3/3600000). All three are now in `ResolvedConfig`, set via preset defaults, and forwarded to `RateLimiter`. Reported in #8.
+- **Flat top-level fields dropped when legacy config is detected.** If a config object contained any nested key (`health`, `timelock`, `jidCanonicalizer`, `lidResolver`, etc.), `isLegacyConfig()` returned true and `mapLegacyToFlat()` only extracted fields from nested sub-objects — silently dropping flat top-level fields like `warmUpDays`, `day1Limit`, `growthFactor`, `inactivityThresholdHours`, `maxIdenticalMessages`, `burstAllowance`. Mixed configs (flat rate/warmup fields + nested callback objects) now preserve the flat fields correctly. Reported in #8.
+
+### Added
+- **`AntiBan.getConfig()`** — returns a copy of the effective resolved config after preset merging and defaults. Useful for debugging which values are actually in use.
+- **Preset defaults for new fields** — `maxIdenticalMessages`: 3/5/10/20, `identicalMessageWindowMs`: 3600000 (all presets), `burstAllowance`: 3/5/8/15 for conservative/moderate/aggressive/high-volume.
+
 ## [3.8.8] - 2026-05-15
 
 ### Added

package/README.md

@@ -574,14 +574,38 @@ const ab = new AntiBan();
 // Or pick a preset
 const ab = new AntiBan('moderate');
 
-// Full control
+// Full control — all ResolvedConfig fields (import ResolvedConfig for type safety)
 const ab = new AntiBan({
-  preset: 'moderate',
+  preset: 'moderate',            // base preset: conservative|moderate|aggressive|high-volume
+  // Rate limits
+  maxPerMinute: 15,              // override any field from the preset
+  maxPerHour: 400,
+  maxPerDay: 2000,
+  minDelayMs: 1000,
+  maxDelayMs: 4000,
+  newChatDelayMs: 2500,
+  // Identical message protection
+  maxIdenticalMessages: 5,       // block after N identical msgs in window (default: 5)
+  identicalMessageWindowMs: 3600000, // tracking window in ms (default: 1h)
+  burstAllowance: 5,             // fast messages before throttle kicks in
+  // Warm-up
+  warmupDays: 7,
+  day1Limit: 20,
+  growthFactor: 1.8,
+  inactivityThresholdHours: 72,
+  // Health
+  autoPauseAt: 'high',          // pause at: low|medium|high|critical
+  // Groups
+  groupProfiles: true,
+  groupMultiplier: 0.7,
+  // Persistence
   persist: './antiban-state.json',  // survives restarts
-  groupProfiles: true,               // stricter limits for groups
-  maxPerMinute: 15,                  // override any value
+  logging: true,
 });
 
+// Debug: see the effective config after preset merging
+console.log(ab.getConfig());
+
 // Usage unchanged
 const result = await ab.beforeSend(jid, text);
 if (result.allowed) {
@@ -637,7 +661,30 @@ try {
 }
 ```
 
-## Quick Start (Legacy)
+### `wrapSocket` with optional features
+
+`deafSession` (deaf-session detector) and `autoRespondToIncoming` are **wrapOptions** — the 4th argument to `wrapSocket`, separate from the antiban config:
+
+```typescript
+import { wrapSocket } from 'baileys-antiban';
+
+const safeSock = wrapSocket(
+  sock,
+  { maxPerMinute: 15, autoPauseAt: 'high' },  // 2nd: AntiBanConfig (flat)
+  undefined,                                    // 3rd: warmUpState (or pass saved state)
+  {                                             // 4th: WrapSocketOptions
+    deafSession: {
+      timeoutMs: 300000,       // declare deaf after 5min without incoming msgs
+      minUptimeMs: 120000,     // must be up 2min before deaf detection starts
+      autoReconnect: true,
+      onDeafSession: () => { /* reconnect logic */ },
+    },
+    autoRespondToIncoming: false,
+  }
+);
+```
+
+## Quick Start (Legacy — v2 API, still works)
 
 ### Option 1: Wrap Your Socket (Easiest)
 
@@ -696,9 +743,9 @@ sock.ev.on('connection.update', ({ connection, lastDisconnect }) => {
 });
 ```
 
-## Configuration
+## Configuration (Legacy nested format — deprecated)
 
-All options are optional — defaults are conservative and safe.
+> **Use the flat config in Quick Start (v3) above instead.** The nested format below still works but triggers a deprecation warning. Callbacks (`onRiskChange`, `onTimelockDetected`, `onTimelockLifted`) and advanced options for `jidCanonicalizer`/`lidResolver` currently still require the nested format — flat equivalents planned for v3.9.
 
 ```typescript
 import { AntiBan } from 'baileys-antiban';

package/dist/antiban.d.ts

@@ -25,7 +25,7 @@ import { PostReconnectThrottle, type ReconnectThrottleConfig, type ReconnectThro
 import { LidResolver, type LidResolverConfig, type LidResolverStats } from './lidResolver.js';
 import { JidCanonicalizer, type JidCanonicalizerConfig, type JidCanonicalizerStats } from './jidCanonicalizer.js';
 import { SessionHealthMonitor, type SessionHealthStats } from './sessionStability.js';
-import { type AntiBanInput } from './presets.js';
+import { type AntiBanInput, type ResolvedConfig } from './presets.js';
 export interface AntiBanConfigLegacy {
     rateLimiter?: Partial<RateLimiterConfig>;
     warmUp?: Partial<WarmUpConfig>;
@@ -119,6 +119,10 @@ export declare class AntiBan {
         shouldReply: boolean;
         suggestedText?: string;
     };
+    /**
+     * Get the resolved configuration
+     */
+    getConfig(): ResolvedConfig;
     /**
      * Get comprehensive stats
      */

package/dist/antiban.js

@@ -61,6 +61,24 @@ function mapLegacyToFlat(legacy) {
         flat.growthFactor = legacy.warmUp.growthFactor;
     if (legacy.logging !== undefined)
         flat.logging = legacy.logging;
+    // Preserve flat top-level fields that coexist with nested keys
+    const legacyAsFlat = legacy;
+    if (flat.warmupDays === undefined && typeof legacyAsFlat.warmUpDays === 'number')
+        flat.warmupDays = legacyAsFlat.warmUpDays;
+    if (flat.warmupDays === undefined && typeof legacyAsFlat.warmupDays === 'number')
+        flat.warmupDays = legacyAsFlat.warmupDays;
+    if (flat.day1Limit === undefined && typeof legacyAsFlat.day1Limit === 'number')
+        flat.day1Limit = legacyAsFlat.day1Limit;
+    if (flat.growthFactor === undefined && typeof legacyAsFlat.growthFactor === 'number')
+        flat.growthFactor = legacyAsFlat.growthFactor;
+    if (flat.inactivityThresholdHours === undefined && typeof legacyAsFlat.inactivityThresholdHours === 'number')
+        flat.inactivityThresholdHours = legacyAsFlat.inactivityThresholdHours;
+    if (flat.maxIdenticalMessages === undefined && typeof legacyAsFlat.maxIdenticalMessages === 'number')
+        flat.maxIdenticalMessages = legacyAsFlat.maxIdenticalMessages;
+    if (flat.identicalMessageWindowMs === undefined && typeof legacyAsFlat.identicalMessageWindowMs === 'number')
+        flat.identicalMessageWindowMs = legacyAsFlat.identicalMessageWindowMs;
+    if (flat.burstAllowance === undefined && typeof legacyAsFlat.burstAllowance === 'number')
+        flat.burstAllowance = legacyAsFlat.burstAllowance;
     return flat;
 }
 export class AntiBan {
@@ -117,6 +135,9 @@ export class AntiBan {
             minDelayMs: cfg.minDelayMs,
             maxDelayMs: cfg.maxDelayMs,
             newChatDelayMs: cfg.newChatDelayMs,
+            maxIdenticalMessages: cfg.maxIdenticalMessages,
+            identicalMessageWindowMs: cfg.identicalMessageWindowMs,
+            burstAllowance: cfg.burstAllowance,
             ...(legacyPassthrough?.rateLimiter || {}),
         });
         // Restore knownChats from persisted state after rateLimiter is constructed
@@ -416,6 +437,12 @@ export class AntiBan {
         this.contactGraphWarmer.onIncomingMessage(jid);
         return this.replyRatioGuard.suggestReply(jid, msgText);
     }
+    /**
+     * Get the resolved configuration
+     */
+    getConfig() {
+        return { ...this.resolvedConfig };
+    }
     /**
      * Get comprehensive stats
      */

package/dist/cjs/antiban.js

@@ -64,6 +64,24 @@ function mapLegacyToFlat(legacy) {
         flat.growthFactor = legacy.warmUp.growthFactor;
     if (legacy.logging !== undefined)
         flat.logging = legacy.logging;
+    // Preserve flat top-level fields that coexist with nested keys
+    const legacyAsFlat = legacy;
+    if (flat.warmupDays === undefined && typeof legacyAsFlat.warmUpDays === 'number')
+        flat.warmupDays = legacyAsFlat.warmUpDays;
+    if (flat.warmupDays === undefined && typeof legacyAsFlat.warmupDays === 'number')
+        flat.warmupDays = legacyAsFlat.warmupDays;
+    if (flat.day1Limit === undefined && typeof legacyAsFlat.day1Limit === 'number')
+        flat.day1Limit = legacyAsFlat.day1Limit;
+    if (flat.growthFactor === undefined && typeof legacyAsFlat.growthFactor === 'number')
+        flat.growthFactor = legacyAsFlat.growthFactor;
+    if (flat.inactivityThresholdHours === undefined && typeof legacyAsFlat.inactivityThresholdHours === 'number')
+        flat.inactivityThresholdHours = legacyAsFlat.inactivityThresholdHours;
+    if (flat.maxIdenticalMessages === undefined && typeof legacyAsFlat.maxIdenticalMessages === 'number')
+        flat.maxIdenticalMessages = legacyAsFlat.maxIdenticalMessages;
+    if (flat.identicalMessageWindowMs === undefined && typeof legacyAsFlat.identicalMessageWindowMs === 'number')
+        flat.identicalMessageWindowMs = legacyAsFlat.identicalMessageWindowMs;
+    if (flat.burstAllowance === undefined && typeof legacyAsFlat.burstAllowance === 'number')
+        flat.burstAllowance = legacyAsFlat.burstAllowance;
     return flat;
 }
 class AntiBan {
@@ -120,6 +138,9 @@ class AntiBan {
             minDelayMs: cfg.minDelayMs,
             maxDelayMs: cfg.maxDelayMs,
             newChatDelayMs: cfg.newChatDelayMs,
+            maxIdenticalMessages: cfg.maxIdenticalMessages,
+            identicalMessageWindowMs: cfg.identicalMessageWindowMs,
+            burstAllowance: cfg.burstAllowance,
             ...(legacyPassthrough?.rateLimiter || {}),
         });
         // Restore knownChats from persisted state after rateLimiter is constructed
@@ -419,6 +440,12 @@ class AntiBan {
         this.contactGraphWarmer.onIncomingMessage(jid);
         return this.replyRatioGuard.suggestReply(jid, msgText);
     }
+    /**
+     * Get the resolved configuration
+     */
+    getConfig() {
+        return { ...this.resolvedConfig };
+    }
     /**
      * Get comprehensive stats
      */

package/dist/cjs/presets.js

@@ -10,6 +10,9 @@ exports.PRESETS = {
         minDelayMs: 2500,
         maxDelayMs: 7000,
         newChatDelayMs: 4000,
+        maxIdenticalMessages: 3,
+        identicalMessageWindowMs: 3600000,
+        burstAllowance: 3,
         warmupDays: 10,
         day1Limit: 15,
         growthFactor: 1.8,
@@ -26,6 +29,9 @@ exports.PRESETS = {
         minDelayMs: 1500,
         maxDelayMs: 5000,
         newChatDelayMs: 3000,
+        maxIdenticalMessages: 5,
+        identicalMessageWindowMs: 3600000,
+        burstAllowance: 5,
         warmupDays: 7,
         day1Limit: 20,
         growthFactor: 1.8,
@@ -42,6 +48,9 @@ exports.PRESETS = {
         minDelayMs: 800,
         maxDelayMs: 3000,
         newChatDelayMs: 2000,
+        maxIdenticalMessages: 10,
+        identicalMessageWindowMs: 3600000,
+        burstAllowance: 8,
         warmupDays: 4,
         day1Limit: 35,
         growthFactor: 2.0,
@@ -60,6 +69,9 @@ exports.PRESETS = {
         minDelayMs: 400,
         maxDelayMs: 1800,
         newChatDelayMs: 1200,
+        maxIdenticalMessages: 20,
+        identicalMessageWindowMs: 3600000,
+        burstAllowance: 15,
         warmupDays: 3,
         day1Limit: 60,
         growthFactor: 2.5,

package/dist/presets.d.ts

@@ -6,6 +6,9 @@ export interface ResolvedConfig {
     minDelayMs: number;
     maxDelayMs: number;
     newChatDelayMs: number;
+    maxIdenticalMessages: number;
+    identicalMessageWindowMs: number;
+    burstAllowance: number;
     warmupDays: number;
     day1Limit: number;
     growthFactor: number;

package/dist/presets.js

@@ -6,6 +6,9 @@ export const PRESETS = {
         minDelayMs: 2500,
         maxDelayMs: 7000,
         newChatDelayMs: 4000,
+        maxIdenticalMessages: 3,
+        identicalMessageWindowMs: 3600000,
+        burstAllowance: 3,
         warmupDays: 10,
         day1Limit: 15,
         growthFactor: 1.8,
@@ -22,6 +25,9 @@ export const PRESETS = {
         minDelayMs: 1500,
         maxDelayMs: 5000,
         newChatDelayMs: 3000,
+        maxIdenticalMessages: 5,
+        identicalMessageWindowMs: 3600000,
+        burstAllowance: 5,
         warmupDays: 7,
         day1Limit: 20,
         growthFactor: 1.8,
@@ -38,6 +44,9 @@ export const PRESETS = {
         minDelayMs: 800,
         maxDelayMs: 3000,
         newChatDelayMs: 2000,
+        maxIdenticalMessages: 10,
+        identicalMessageWindowMs: 3600000,
+        burstAllowance: 8,
         warmupDays: 4,
         day1Limit: 35,
         growthFactor: 2.0,
@@ -56,6 +65,9 @@ export const PRESETS = {
         minDelayMs: 400,
         maxDelayMs: 1800,
         newChatDelayMs: 1200,
+        maxIdenticalMessages: 20,
+        identicalMessageWindowMs: 3600000,
+        burstAllowance: 15,
         warmupDays: 3,
         day1Limit: 60,
         growthFactor: 2.5,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "baileys-antiban",
-  "version": "3.8.8",
+  "version": "3.8.10",
   "description": "Anti-ban middleware for Baileys WhatsApp bots. Rate limiting, warmup, health monitor, LID resolver, disconnect classifier. Free Whapi.Cloud alternative.",
   "main": "dist/cjs/index.js",
   "types": "dist/index.d.ts",