baileys-antiban 3.8.7 → 3.8.9

package/CHANGELOG.md

@@ -5,6 +5,12 @@ 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.8] - 2026-05-15
+
+### Added
+- **`high-volume` preset** — for established, fully-warmed accounts running enterprise-scale operations. Limits: 40 msg/min, 1500/hr, 8000/day, 400–1800ms delays. Only use on accounts with 6+ months history and no prior bans. Set via `wrapSocket(sock, 'high-volume')` or env var `ANTIBAN_PRESET=high-volume`.
+- **Env-var integration pattern in docs** — full example showing how to drive every antiban parameter from environment variables inside a bot framework (avoids redeploying to tune limits). Based on real-world usage patterns from Zyra (kaikybrofc/zyra).
+
 ## [3.8.7] - 2026-05-14
 
 ### Added

package/README.md

@@ -1123,6 +1123,46 @@ Now every `npm install` / `openclaw plugins install @openclaw/whatsapp` automati
 
 ---
 
+### Full env-var configuration (framework integration pattern)
+
+When embedding `baileys-antiban` inside a framework or bot engine, drive every parameter from environment variables so you can tune without redeploying:
+
+```typescript
+import { wrapSocket } from 'baileys-antiban';
+import type { WrapOptions } from 'baileys-antiban';
+
+function readBoolean(key: string, fallback: boolean): boolean {
+  const v = process.env[key];
+  return v === undefined ? fallback : v !== 'false' && v !== '0';
+}
+function readNumber(key: string, fallback: number): number {
+  const v = process.env[key];
+  return v === undefined ? fallback : parseInt(v, 10);
+}
+
+const antibanOptions: WrapOptions = {
+  preset: (process.env.WA_ANTIBAN_PRESET as any) || 'conservative',
+  // rate limits
+  maxPerMinute:  readNumber('WA_ANTIBAN_MAX_PER_MINUTE',  undefined as any),
+  maxPerHour:    readNumber('WA_ANTIBAN_MAX_PER_HOUR',    undefined as any),
+  maxPerDay:     readNumber('WA_ANTIBAN_MAX_PER_DAY',     undefined as any),
+  minDelayMs:    readNumber('WA_ANTIBAN_MIN_DELAY_MS',    undefined as any),
+  maxDelayMs:    readNumber('WA_ANTIBAN_MAX_DELAY_MS',    undefined as any),
+  // warmup
+  warmupDays:    readNumber('WA_ANTIBAN_WARMUP_DAYS',     undefined as any),
+  // health
+  logging:       readBoolean('WA_ANTIBAN_LOGGING', true),
+  // deaf session
+  deafSession: readBoolean('WA_ANTIBAN_DEAF_SESSION_ENABLED', true)
+    ? { timeoutMs: readNumber('WA_ANTIBAN_DEAF_TIMEOUT_MS', 300_000) }
+    : undefined,
+};
+
+const sock = wrapSocket(makeWASocket({ ... }), antibanOptions);
+```
+
+Undefined values fall back to the preset defaults — so you only override what you need. Set `WA_ANTIBAN_PRESET=high-volume` for established enterprise accounts, `WA_ANTIBAN_PRESET=conservative` for new numbers.
+
 ### State not persisting across restarts
 
 Use the FileStateAdapter:

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,
@@ -51,6 +60,27 @@ exports.PRESETS = {
         groupProfiles: false,
         logging: true,
     },
+    // For established, fully-warmed accounts running enterprise-scale operations.
+    // Only use on accounts with 6+ months history and no prior bans.
+    'high-volume': {
+        maxPerMinute: 40,
+        maxPerHour: 1500,
+        maxPerDay: 8000,
+        minDelayMs: 400,
+        maxDelayMs: 1800,
+        newChatDelayMs: 1200,
+        maxIdenticalMessages: 20,
+        identicalMessageWindowMs: 3600000,
+        burstAllowance: 15,
+        warmupDays: 3,
+        day1Limit: 60,
+        growthFactor: 2.5,
+        inactivityThresholdHours: 24,
+        autoPauseAt: 'critical',
+        groupMultiplier: 0.95,
+        groupProfiles: false,
+        logging: true,
+    },
 };
 function resolveConfig(input) {
     if (input === undefined) {
@@ -58,14 +88,14 @@ function resolveConfig(input) {
     }
     if (typeof input === 'string') {
         if (!(input in exports.PRESETS)) {
-            throw new Error(`Unknown preset "${input}". Valid: ${Object.keys(exports.PRESETS).join(', ')}`);
+            throw new Error(`Unknown preset "${input}". Valid: conservative, moderate, aggressive, high-volume`);
         }
         return { ...exports.PRESETS[input] };
     }
     // Object form — extract preset base, merge overrides
     const { preset = 'conservative', ...overrides } = input;
     if (!(preset in exports.PRESETS)) {
-        throw new Error(`Unknown preset "${preset}". Valid: ${Object.keys(exports.PRESETS).join(', ')}`);
+        throw new Error(`Unknown preset "${preset}". Valid: conservative, moderate, aggressive, high-volume`);
     }
     return { ...exports.PRESETS[preset], ...overrides };
 }

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;
@@ -16,7 +19,7 @@ export interface ResolvedConfig {
     persist?: string;
     logging: boolean;
 }
-export type PresetName = 'conservative' | 'moderate' | 'aggressive';
+export type PresetName = 'conservative' | 'moderate' | 'aggressive' | 'high-volume';
 export type AntiBanInput = PresetName | Partial<ResolvedConfig & {
     preset?: PresetName;
 }> | undefined;

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,
@@ -47,6 +56,27 @@ export const PRESETS = {
         groupProfiles: false,
         logging: true,
     },
+    // For established, fully-warmed accounts running enterprise-scale operations.
+    // Only use on accounts with 6+ months history and no prior bans.
+    'high-volume': {
+        maxPerMinute: 40,
+        maxPerHour: 1500,
+        maxPerDay: 8000,
+        minDelayMs: 400,
+        maxDelayMs: 1800,
+        newChatDelayMs: 1200,
+        maxIdenticalMessages: 20,
+        identicalMessageWindowMs: 3600000,
+        burstAllowance: 15,
+        warmupDays: 3,
+        day1Limit: 60,
+        growthFactor: 2.5,
+        inactivityThresholdHours: 24,
+        autoPauseAt: 'critical',
+        groupMultiplier: 0.95,
+        groupProfiles: false,
+        logging: true,
+    },
 };
 export function resolveConfig(input) {
     if (input === undefined) {
@@ -54,14 +84,14 @@ export function resolveConfig(input) {
     }
     if (typeof input === 'string') {
         if (!(input in PRESETS)) {
-            throw new Error(`Unknown preset "${input}". Valid: ${Object.keys(PRESETS).join(', ')}`);
+            throw new Error(`Unknown preset "${input}". Valid: conservative, moderate, aggressive, high-volume`);
         }
         return { ...PRESETS[input] };
     }
     // Object form — extract preset base, merge overrides
     const { preset = 'conservative', ...overrides } = input;
     if (!(preset in PRESETS)) {
-        throw new Error(`Unknown preset "${preset}". Valid: ${Object.keys(PRESETS).join(', ')}`);
+        throw new Error(`Unknown preset "${preset}". Valid: conservative, moderate, aggressive, high-volume`);
     }
     return { ...PRESETS[preset], ...overrides };
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "baileys-antiban",
-  "version": "3.8.7",
+  "version": "3.8.9",
   "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",
@@ -90,6 +90,7 @@
   },
   "devDependencies": {
     "@types/node": "^20.0.0",
+    "@whiskeysockets/baileys": "^7.0.0-rc11",
     "baileys": "github:WhiskeySockets/Baileys#dfad98f815feb771cc561f32707a00c6e085b1f1",
     "tsx": "^4.21.0",
     "typescript": "^5.0.0",