baileys-antiban 3.8.7 → 3.8.8

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/cjs/presets.js

@@ -51,6 +51,24 @@ 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,
+        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 +76,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

@@ -16,7 +16,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

@@ -47,6 +47,24 @@ 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,
+        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 +72,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.8",
   "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",