baileys-antiban 4.9.0 → 4.10.0

package/dist/antiban.d.ts

@@ -32,6 +32,7 @@ import { type DeliveryTrackerStats } from './deliveryTracker.js';
 import { type InstanceCoordinatorStats } from './instanceCoordinator.js';
 import { MessageTypeRegistry } from './messageTypeRegistry.js';
 import { type AntibanSnapshot } from './stateExport.js';
+import { ReputationVoucher } from './reputationVoucher.js';
 export interface AntiBanConfigLegacy {
     rateLimiter?: Partial<RateLimiterConfig>;
     warmUp?: Partial<WarmUpConfig>;
@@ -116,6 +117,8 @@ export declare class AntiBan {
     private stateManager;
     private resolvedConfig;
     private logging;
+    /** Optional reputation voucher (standalone — caller manages separate voucher sockets) */
+    reputationVoucher?: ReputationVoucher;
     private stats;
     constructor(input?: AntiBanInput | AntiBanConfigLegacy, warmUpStateArg?: WarmUpState);
     /**

package/dist/antiban.js

@@ -117,6 +117,8 @@ export class AntiBan {
     stateManager = null;
     resolvedConfig;
     logging;
+    /** Optional reputation voucher (standalone — caller manages separate voucher sockets) */
+    reputationVoucher;
     stats = {
         messagesAllowed: 0,
         messagesBlocked: 0,
@@ -847,6 +849,7 @@ export class AntiBan {
             timelockGuard: this.timelockGuard,
             messageRegistry: this.messageTypeRegistry || undefined,
             topologyThrottler: this.topologyThrottlerModule || undefined,
+            reputationVoucher: this.reputationVoucher || undefined,
             instanceId: this.resolvedConfig.instanceId,
         });
     }
@@ -862,6 +865,7 @@ export class AntiBan {
             timelockGuard: this.timelockGuard,
             messageRegistry: this.messageTypeRegistry || undefined,
             topologyThrottler: this.topologyThrottlerModule || undefined,
+            reputationVoucher: this.reputationVoucher || undefined,
         });
     }
     /**

package/dist/cjs/antiban.js

@@ -120,6 +120,8 @@ class AntiBan {
     stateManager = null;
     resolvedConfig;
     logging;
+    /** Optional reputation voucher (standalone — caller manages separate voucher sockets) */
+    reputationVoucher;
     stats = {
         messagesAllowed: 0,
         messagesBlocked: 0,
@@ -850,6 +852,7 @@ class AntiBan {
             timelockGuard: this.timelockGuard,
             messageRegistry: this.messageTypeRegistry || undefined,
             topologyThrottler: this.topologyThrottlerModule || undefined,
+            reputationVoucher: this.reputationVoucher || undefined,
             instanceId: this.resolvedConfig.instanceId,
         });
     }
@@ -865,6 +868,7 @@ class AntiBan {
             timelockGuard: this.timelockGuard,
             messageRegistry: this.messageTypeRegistry || undefined,
             topologyThrottler: this.topologyThrottlerModule || undefined,
+            reputationVoucher: this.reputationVoucher || undefined,
         });
     }
     /**

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.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;
+exports.createPeriodicExporter = exports.createMetricsHandler = exports.exportPrometheusMetrics = exports.createConsoleLogger = exports.ReputationVoucher = 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; } });
@@ -151,6 +151,9 @@ Object.defineProperty(exports, "exportAntibanState", { enumerable: true, get: fu
 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; } });
+// v4.9 new modules
+var reputationVoucher_js_1 = require("./reputationVoucher.js");
+Object.defineProperty(exports, "ReputationVoucher", { enumerable: true, get: function () { return reputationVoucher_js_1.ReputationVoucher; } });
 // Observability
 var observability_js_1 = require("./observability.js");
 Object.defineProperty(exports, "createConsoleLogger", { enumerable: true, get: function () { return observability_js_1.createConsoleLogger; } });

package/dist/cjs/reputationVoucher.js

@@ -0,0 +1,377 @@
+"use strict";
+/**
+ * ReputationVoucher — High-trust accounts vouch for new numbers
+ *
+ * Establishes genuine conversation history between trusted accounts and new numbers
+ * before those new numbers contact customers. Reduces warmup time and makes new
+ * accounts appear established with real bidirectional message history.
+ *
+ * Key design principles:
+ * - Dedicated sacrificial vouch accounts (separate from business accounts)
+ * - Max 5 vouches per week per vouching account (not per day)
+ * - Targets must complete 3 qualifying events before vouching
+ * - Strike system: 3 failed vouches = 90-day suspension for voucher
+ * - Blast radius containment: vouching accounts isolated from main business
+ *
+ * Usage:
+ *   const rv = new ReputationVoucher();
+ *
+ *   // Register a trusted account
+ *   rv.registerVoucher({
+ *     jid: '27123456789@s.whatsapp.net',
+ *     trustScore: 85,
+ *     accountAgeDays: 240
+ *   });
+ *
+ *   // Queue a new number for vouching
+ *   rv.queueTarget({ jid: '27987654321@s.whatsapp.net' });
+ *
+ *   // Record qualifying events (auction completion, payment, etc)
+ *   rv.recordQualifyingEvent('27987654321@s.whatsapp.net');
+ *   rv.recordQualifyingEvent('27987654321@s.whatsapp.net');
+ *   rv.recordQualifyingEvent('27987654321@s.whatsapp.net');
+ *
+ *   // Check if target qualifies
+ *   const check = rv.targetQualifies('27987654321@s.whatsapp.net');
+ *   if (check.qualified) {
+ *     const voucher = rv.getAvailableVoucher();
+ *     if (voucher) {
+ *       // Plan the conversation
+ *       const conversation = rv.planVouchConversation(voucher.jid, '27987654321@s.whatsapp.net');
+ *
+ *       // Execute sends (caller must have separate socket for voucher account)
+ *       // ... send conversation.messages ...
+ *
+ *       // After target replies
+ *       rv.recordVouchOutcome('27987654321@s.whatsapp.net', true);
+ *
+ *       // Calculate warmup credit
+ *       const daysCredit = rv.calculateWarmupCredit('27987654321@s.whatsapp.net');
+ *       // Skip daysCredit days of warmup for this target
+ *     }
+ *   }
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ReputationVoucher = void 0;
+const DEFAULT_CONFIG = {
+    maxVouchesPerWeek: 5,
+    qualifyingEventsRequired: 3,
+    strikesForSuspension: 3,
+    suspensionDurationMs: 90 * 24 * 60 * 60 * 1000, // 90 days
+    minVoucherTrustScore: 60,
+    minVoucherAgeDays: 180, // 6 months
+    warmupMessages: [
+        "Hey, just checking this is the right number?",
+        "Hi! Got your details from the group",
+        "Morning! Are you available this week?",
+        "Hey there, hope this is a good time to connect",
+        "Hi, just wanted to reach out",
+    ],
+};
+class ReputationVoucher {
+    config;
+    vouchers = new Map();
+    targets = new Map();
+    conversations = [];
+    constructor(config) {
+        this.config = { ...DEFAULT_CONFIG, ...config };
+    }
+    /**
+     * Register a vouching account (high-trust, established number)
+     */
+    registerVoucher(account) {
+        // Validate account meets minimum requirements
+        if (account.trustScore < this.config.minVoucherTrustScore) {
+            throw new Error(`Voucher trust score ${account.trustScore} below minimum ${this.config.minVoucherTrustScore}`);
+        }
+        if (account.accountAgeDays < this.config.minVoucherAgeDays) {
+            throw new Error(`Voucher account age ${account.accountAgeDays} days below minimum ${this.config.minVoucherAgeDays} days`);
+        }
+        const existing = this.vouchers.get(account.jid);
+        if (existing) {
+            // Update existing voucher (preserve counters)
+            this.vouchers.set(account.jid, {
+                ...account,
+                vouchesThisWeek: existing.vouchesThisWeek,
+                totalVouches: existing.totalVouches,
+                failedVouches: existing.failedVouches,
+                strikes: existing.strikes,
+                suspendedUntil: existing.suspendedUntil,
+                lastVouchAt: existing.lastVouchAt,
+            });
+        }
+        else {
+            // New voucher
+            this.vouchers.set(account.jid, {
+                ...account,
+                vouchesThisWeek: 0,
+                totalVouches: 0,
+                failedVouches: 0,
+                strikes: 0,
+            });
+        }
+    }
+    /**
+     * Queue a target for vouching
+     */
+    queueTarget(target) {
+        const existing = this.targets.get(target.jid);
+        if (existing && existing.status !== 'failed') {
+            // Already queued or in progress
+            return;
+        }
+        this.targets.set(target.jid, {
+            ...target,
+            qualifyingEvents: target.qualifyingEvents || 0,
+            requestedAt: Date.now(),
+            status: 'pending',
+        });
+    }
+    /**
+     * Check if a target qualifies for vouching
+     */
+    targetQualifies(jid) {
+        const target = this.targets.get(jid);
+        if (!target) {
+            return { qualified: false, reason: 'Target not queued', eventsNeeded: this.config.qualifyingEventsRequired };
+        }
+        const events = target.qualifyingEvents || 0;
+        if (events < this.config.qualifyingEventsRequired) {
+            return {
+                qualified: false,
+                reason: `Not enough qualifying events (${events}/${this.config.qualifyingEventsRequired})`,
+                eventsNeeded: this.config.qualifyingEventsRequired - events,
+            };
+        }
+        if (target.status === 'completed') {
+            return { qualified: false, reason: 'Already vouched' };
+        }
+        if (target.status === 'failed') {
+            return { qualified: false, reason: 'Previous vouch failed' };
+        }
+        return { qualified: true };
+    }
+    /**
+     * Record a qualifying event for a target (e.g., auction completion, payment cleared)
+     */
+    recordQualifyingEvent(jid) {
+        const target = this.targets.get(jid);
+        if (!target) {
+            // Auto-queue with first event
+            this.queueTarget({ jid, qualifyingEvents: 1 });
+            return;
+        }
+        target.qualifyingEvents = (target.qualifyingEvents || 0) + 1;
+    }
+    /**
+     * Get next available voucher for a target (respects limits + suspension)
+     */
+    getAvailableVoucher() {
+        const now = Date.now();
+        const weekMs = 7 * 24 * 60 * 60 * 1000;
+        // Find eligible vouchers
+        const eligible = [];
+        for (const voucher of this.vouchers.values()) {
+            // Check suspension
+            if (voucher.suspendedUntil && voucher.suspendedUntil > now) {
+                continue;
+            }
+            // Reset weekly counter if 7 days have passed since last vouch
+            if (voucher.lastVouchAt && now - voucher.lastVouchAt > weekMs) {
+                voucher.vouchesThisWeek = 0;
+            }
+            // Check weekly limit
+            if (voucher.vouchesThisWeek >= this.config.maxVouchesPerWeek) {
+                continue;
+            }
+            eligible.push(voucher);
+        }
+        if (eligible.length === 0) {
+            return null;
+        }
+        // Sort by:
+        // 1. Lowest vouchesThisWeek (spread load)
+        // 2. Highest trustScore (best vouchers first)
+        // 3. Lowest totalVouches (rotate usage)
+        eligible.sort((a, b) => {
+            if (a.vouchesThisWeek !== b.vouchesThisWeek) {
+                return a.vouchesThisWeek - b.vouchesThisWeek;
+            }
+            if (a.trustScore !== b.trustScore) {
+                return b.trustScore - a.trustScore;
+            }
+            return a.totalVouches - b.totalVouches;
+        });
+        return eligible[0];
+    }
+    /**
+     * Plan a vouch conversation.
+     * Returns a conversation plan — caller executes the sends.
+     */
+    planVouchConversation(voucherJid, targetJid) {
+        const voucher = this.vouchers.get(voucherJid);
+        if (!voucher) {
+            throw new Error(`Voucher ${voucherJid} not registered`);
+        }
+        const target = this.targets.get(targetJid);
+        if (!target) {
+            throw new Error(`Target ${targetJid} not queued`);
+        }
+        const check = this.targetQualifies(targetJid);
+        if (!check.qualified) {
+            throw new Error(`Target ${targetJid} not qualified: ${check.reason}`);
+        }
+        // Update voucher counters
+        voucher.vouchesThisWeek++;
+        voucher.totalVouches++;
+        voucher.lastVouchAt = Date.now();
+        // Update target status
+        target.status = 'active';
+        target.vouchedAt = Date.now();
+        target.vouchedBy = voucherJid;
+        // Pick 2-3 warmup messages randomly
+        const messageCount = 2 + Math.floor(Math.random() * 2); // 2-3 messages
+        const selectedMessages = [];
+        const pool = [...this.config.warmupMessages];
+        for (let i = 0; i < messageCount && pool.length > 0; i++) {
+            const idx = Math.floor(Math.random() * pool.length);
+            selectedMessages.push(pool[idx]);
+            pool.splice(idx, 1); // Remove to avoid duplicates
+        }
+        // Create conversation plan
+        const conversation = {
+            targetJid,
+            voucherJid,
+            messages: selectedMessages.map((text, idx) => ({
+                direction: 'outbound',
+                timestamp: Date.now() + idx * 5000, // Stagger by 5s
+                text,
+            })),
+            startedAt: Date.now(),
+            success: false, // Will be updated when recordVouchOutcome is called
+        };
+        this.conversations.push(conversation);
+        return conversation;
+    }
+    /**
+     * Record outcome of a vouch.
+     * success = true if target replied within reasonable time (e.g., 7 days)
+     * success = false if target got banned within 7 days of vouch
+     */
+    recordVouchOutcome(targetJid, success) {
+        const target = this.targets.get(targetJid);
+        if (!target || !target.vouchedBy) {
+            throw new Error(`Target ${targetJid} not vouched`);
+        }
+        const voucher = this.vouchers.get(target.vouchedBy);
+        if (!voucher) {
+            throw new Error(`Voucher ${target.vouchedBy} not found`);
+        }
+        // Find the conversation
+        const conversation = this.conversations.find((c) => c.targetJid === targetJid && c.voucherJid === target.vouchedBy);
+        if (conversation) {
+            conversation.success = success;
+            conversation.completedAt = Date.now();
+        }
+        if (success) {
+            target.status = 'completed';
+        }
+        else {
+            // Failed vouch — apply strike to voucher
+            target.status = 'failed';
+            voucher.failedVouches++;
+            voucher.strikes++;
+            // Check if suspension threshold reached
+            if (voucher.strikes >= this.config.strikesForSuspension) {
+                voucher.suspendedUntil = Date.now() + this.config.suspensionDurationMs;
+            }
+        }
+    }
+    /**
+     * Calculate warmup credit for a successfully vouched target.
+     * Returns number of warmup days that can be skipped (0-3).
+     *
+     * Credit logic:
+     * - 1 reply = 1 day credit
+     * - 2+ replies = 2 days credit
+     * - Reply + 3+ days elapsed = 3 days credit (max)
+     */
+    calculateWarmupCredit(targetJid) {
+        const target = this.targets.get(targetJid);
+        if (!target || target.status !== 'completed') {
+            return 0;
+        }
+        const conversation = this.conversations.find((c) => c.targetJid === targetJid && c.success);
+        if (!conversation) {
+            return 0;
+        }
+        // Count inbound messages (replies from target)
+        const inboundCount = conversation.messages.filter((m) => m.direction === 'inbound').length;
+        if (inboundCount === 0) {
+            return 0;
+        }
+        if (inboundCount === 1) {
+            return 1;
+        }
+        if (inboundCount >= 2) {
+            // Check if 3+ days elapsed
+            const daysElapsed = (Date.now() - conversation.startedAt) / (24 * 60 * 60 * 1000);
+            if (daysElapsed >= 3) {
+                return 3; // Max credit
+            }
+            return 2;
+        }
+        return 0;
+    }
+    /**
+     * Get stats for a specific voucher
+     */
+    getVoucherStats(jid) {
+        const voucher = this.vouchers.get(jid);
+        return voucher ? { ...voucher } : null;
+    }
+    /**
+     * Get all pending targets (awaiting vouching)
+     */
+    getPendingTargets() {
+        return Array.from(this.targets.values()).filter((t) => t.status === 'pending');
+    }
+    /**
+     * Get vouch history
+     */
+    getVouchHistory() {
+        return [...this.conversations];
+    }
+    /**
+     * Export state for persistence
+     */
+    exportState() {
+        return {
+            version: 1,
+            exportedAt: Date.now(),
+            vouchers: Array.from(this.vouchers.values()),
+            targets: Array.from(this.targets.values()),
+            conversations: [...this.conversations],
+        };
+    }
+    /**
+     * Import state from persistence
+     */
+    importState(state) {
+        // Clear existing state
+        this.vouchers.clear();
+        this.targets.clear();
+        this.conversations = [];
+        // Import vouchers
+        for (const voucher of state.vouchers) {
+            this.vouchers.set(voucher.jid, { ...voucher });
+        }
+        // Import targets
+        for (const target of state.targets) {
+            this.targets.set(target.jid, { ...target });
+        }
+        // Import conversations
+        this.conversations = [...state.conversations];
+    }
+}
+exports.ReputationVoucher = ReputationVoucher;

package/dist/cjs/stateExport.js

@@ -75,6 +75,10 @@ function exportAntibanState(modules) {
     if (modules.topologyThrottler) {
         snapshot.topologyThrottler = modules.topologyThrottler.exportState();
     }
+    // Export reputation voucher state
+    if (modules.reputationVoucher) {
+        snapshot.reputationVoucher = modules.reputationVoucher.exportState();
+    }
     // Export engagement scores
     if (modules.engagementScores) {
         snapshot.engagementScores = Object.fromEntries(modules.engagementScores.entries());
@@ -152,6 +156,10 @@ function importAntibanState(snapshot, modules) {
     if (snapshot.topologyThrottler && modules.topologyThrottler) {
         modules.topologyThrottler.importState(snapshot.topologyThrottler);
     }
+    // Import reputation voucher state
+    if (snapshot.reputationVoucher && modules.reputationVoucher) {
+        modules.reputationVoucher.importState(snapshot.reputationVoucher);
+    }
     // Import engagement scores
     if (snapshot.engagementScores && modules.engagementScores) {
         for (const [jid, score] of Object.entries(snapshot.engagementScores)) {

package/dist/index.d.ts

@@ -49,4 +49,5 @@ export { HumanEntropyService, createHumanEntropyService, type HumanEntropyConfig
 export { MessageTypeRegistry, type MessageTypeDefinition, type MessageProvenance, type MessageTypeStats, type MessageTypeWarning, type MessageTypeRegistryState } from './messageTypeRegistry.js';
 export { exportAntibanState, importAntibanState, type AntibanSnapshot, type RateLimiterState, type TimelockGuardState, type CircuitState as CircuitStateExport, type DisconnectEvent } from './stateExport.js';
 export { TopologyThrottler, type TopologyThrottlerConfig, type ContactRisk, type ContactRiskAssessment, type ContactRiskConfig, type TopologyThrottlerState } from './topologyThrottler.js';
+export { ReputationVoucher, type ReputationVoucherConfig, type VouchTarget, type VouchingAccount, type VouchConversation, type ReputationVoucherState } from './reputationVoucher.js';
 export { createConsoleLogger, exportPrometheusMetrics, createMetricsHandler, createPeriodicExporter, type AntiBanLogger, type PeriodicExporterConfig, type PeriodicExporterHandle, } from './observability.js';

package/dist/index.js

@@ -71,5 +71,7 @@ export { HumanEntropyService, createHumanEntropyService } from './humanEntropy.j
 export { MessageTypeRegistry } from './messageTypeRegistry.js';
 export { exportAntibanState, importAntibanState } from './stateExport.js';
 export { TopologyThrottler } from './topologyThrottler.js';
+// v4.9 new modules
+export { ReputationVoucher } from './reputationVoucher.js';
 // Observability
 export { createConsoleLogger, exportPrometheusMetrics, createMetricsHandler, createPeriodicExporter, } from './observability.js';

package/dist/reputationVoucher.d.ts

@@ -0,0 +1,171 @@
+/**
+ * ReputationVoucher — High-trust accounts vouch for new numbers
+ *
+ * Establishes genuine conversation history between trusted accounts and new numbers
+ * before those new numbers contact customers. Reduces warmup time and makes new
+ * accounts appear established with real bidirectional message history.
+ *
+ * Key design principles:
+ * - Dedicated sacrificial vouch accounts (separate from business accounts)
+ * - Max 5 vouches per week per vouching account (not per day)
+ * - Targets must complete 3 qualifying events before vouching
+ * - Strike system: 3 failed vouches = 90-day suspension for voucher
+ * - Blast radius containment: vouching accounts isolated from main business
+ *
+ * Usage:
+ *   const rv = new ReputationVoucher();
+ *
+ *   // Register a trusted account
+ *   rv.registerVoucher({
+ *     jid: '27123456789@s.whatsapp.net',
+ *     trustScore: 85,
+ *     accountAgeDays: 240
+ *   });
+ *
+ *   // Queue a new number for vouching
+ *   rv.queueTarget({ jid: '27987654321@s.whatsapp.net' });
+ *
+ *   // Record qualifying events (auction completion, payment, etc)
+ *   rv.recordQualifyingEvent('27987654321@s.whatsapp.net');
+ *   rv.recordQualifyingEvent('27987654321@s.whatsapp.net');
+ *   rv.recordQualifyingEvent('27987654321@s.whatsapp.net');
+ *
+ *   // Check if target qualifies
+ *   const check = rv.targetQualifies('27987654321@s.whatsapp.net');
+ *   if (check.qualified) {
+ *     const voucher = rv.getAvailableVoucher();
+ *     if (voucher) {
+ *       // Plan the conversation
+ *       const conversation = rv.planVouchConversation(voucher.jid, '27987654321@s.whatsapp.net');
+ *
+ *       // Execute sends (caller must have separate socket for voucher account)
+ *       // ... send conversation.messages ...
+ *
+ *       // After target replies
+ *       rv.recordVouchOutcome('27987654321@s.whatsapp.net', true);
+ *
+ *       // Calculate warmup credit
+ *       const daysCredit = rv.calculateWarmupCredit('27987654321@s.whatsapp.net');
+ *       // Skip daysCredit days of warmup for this target
+ *     }
+ *   }
+ */
+export interface VouchTarget {
+    jid: string;
+    qualifyingEvents?: number;
+    requestedAt: number;
+    vouchedAt?: number;
+    vouchedBy?: string;
+    status: 'pending' | 'active' | 'completed' | 'failed';
+}
+export interface VouchingAccount {
+    jid: string;
+    trustScore: number;
+    accountAgeDays: number;
+    vouchesThisWeek: number;
+    totalVouches: number;
+    failedVouches: number;
+    strikes: number;
+    suspendedUntil?: number;
+    lastVouchAt?: number;
+}
+export interface VouchConversation {
+    targetJid: string;
+    voucherJid: string;
+    messages: Array<{
+        direction: 'outbound' | 'inbound';
+        timestamp: number;
+        text: string;
+    }>;
+    startedAt: number;
+    completedAt?: number;
+    success: boolean;
+}
+export interface ReputationVoucherConfig {
+    maxVouchesPerWeek?: number;
+    qualifyingEventsRequired?: number;
+    strikesForSuspension?: number;
+    suspensionDurationMs?: number;
+    minVoucherTrustScore?: number;
+    minVoucherAgeDays?: number;
+    warmupMessages?: string[];
+}
+export interface ReputationVoucherState {
+    version: number;
+    exportedAt: number;
+    vouchers: VouchingAccount[];
+    targets: VouchTarget[];
+    conversations: VouchConversation[];
+}
+export declare class ReputationVoucher {
+    private config;
+    private vouchers;
+    private targets;
+    private conversations;
+    constructor(config?: ReputationVoucherConfig);
+    /**
+     * Register a vouching account (high-trust, established number)
+     */
+    registerVoucher(account: Omit<VouchingAccount, 'vouchesThisWeek' | 'totalVouches' | 'failedVouches' | 'strikes'>): void;
+    /**
+     * Queue a target for vouching
+     */
+    queueTarget(target: Omit<VouchTarget, 'status' | 'requestedAt'>): void;
+    /**
+     * Check if a target qualifies for vouching
+     */
+    targetQualifies(jid: string): {
+        qualified: boolean;
+        reason?: string;
+        eventsNeeded?: number;
+    };
+    /**
+     * Record a qualifying event for a target (e.g., auction completion, payment cleared)
+     */
+    recordQualifyingEvent(jid: string): void;
+    /**
+     * Get next available voucher for a target (respects limits + suspension)
+     */
+    getAvailableVoucher(): VouchingAccount | null;
+    /**
+     * Plan a vouch conversation.
+     * Returns a conversation plan — caller executes the sends.
+     */
+    planVouchConversation(voucherJid: string, targetJid: string): VouchConversation;
+    /**
+     * Record outcome of a vouch.
+     * success = true if target replied within reasonable time (e.g., 7 days)
+     * success = false if target got banned within 7 days of vouch
+     */
+    recordVouchOutcome(targetJid: string, success: boolean): void;
+    /**
+     * Calculate warmup credit for a successfully vouched target.
+     * Returns number of warmup days that can be skipped (0-3).
+     *
+     * Credit logic:
+     * - 1 reply = 1 day credit
+     * - 2+ replies = 2 days credit
+     * - Reply + 3+ days elapsed = 3 days credit (max)
+     */
+    calculateWarmupCredit(targetJid: string): number;
+    /**
+     * Get stats for a specific voucher
+     */
+    getVoucherStats(jid: string): VouchingAccount | null;
+    /**
+     * Get all pending targets (awaiting vouching)
+     */
+    getPendingTargets(): VouchTarget[];
+    /**
+     * Get vouch history
+     */
+    getVouchHistory(): VouchConversation[];
+    /**
+     * Export state for persistence
+     */
+    exportState(): ReputationVoucherState;
+    /**
+     * Import state from persistence
+     */
+    importState(state: ReputationVoucherState): void;
+}

package/dist/reputationVoucher.js

@@ -0,0 +1,373 @@
+/**
+ * ReputationVoucher — High-trust accounts vouch for new numbers
+ *
+ * Establishes genuine conversation history between trusted accounts and new numbers
+ * before those new numbers contact customers. Reduces warmup time and makes new
+ * accounts appear established with real bidirectional message history.
+ *
+ * Key design principles:
+ * - Dedicated sacrificial vouch accounts (separate from business accounts)
+ * - Max 5 vouches per week per vouching account (not per day)
+ * - Targets must complete 3 qualifying events before vouching
+ * - Strike system: 3 failed vouches = 90-day suspension for voucher
+ * - Blast radius containment: vouching accounts isolated from main business
+ *
+ * Usage:
+ *   const rv = new ReputationVoucher();
+ *
+ *   // Register a trusted account
+ *   rv.registerVoucher({
+ *     jid: '27123456789@s.whatsapp.net',
+ *     trustScore: 85,
+ *     accountAgeDays: 240
+ *   });
+ *
+ *   // Queue a new number for vouching
+ *   rv.queueTarget({ jid: '27987654321@s.whatsapp.net' });
+ *
+ *   // Record qualifying events (auction completion, payment, etc)
+ *   rv.recordQualifyingEvent('27987654321@s.whatsapp.net');
+ *   rv.recordQualifyingEvent('27987654321@s.whatsapp.net');
+ *   rv.recordQualifyingEvent('27987654321@s.whatsapp.net');
+ *
+ *   // Check if target qualifies
+ *   const check = rv.targetQualifies('27987654321@s.whatsapp.net');
+ *   if (check.qualified) {
+ *     const voucher = rv.getAvailableVoucher();
+ *     if (voucher) {
+ *       // Plan the conversation
+ *       const conversation = rv.planVouchConversation(voucher.jid, '27987654321@s.whatsapp.net');
+ *
+ *       // Execute sends (caller must have separate socket for voucher account)
+ *       // ... send conversation.messages ...
+ *
+ *       // After target replies
+ *       rv.recordVouchOutcome('27987654321@s.whatsapp.net', true);
+ *
+ *       // Calculate warmup credit
+ *       const daysCredit = rv.calculateWarmupCredit('27987654321@s.whatsapp.net');
+ *       // Skip daysCredit days of warmup for this target
+ *     }
+ *   }
+ */
+const DEFAULT_CONFIG = {
+    maxVouchesPerWeek: 5,
+    qualifyingEventsRequired: 3,
+    strikesForSuspension: 3,
+    suspensionDurationMs: 90 * 24 * 60 * 60 * 1000, // 90 days
+    minVoucherTrustScore: 60,
+    minVoucherAgeDays: 180, // 6 months
+    warmupMessages: [
+        "Hey, just checking this is the right number?",
+        "Hi! Got your details from the group",
+        "Morning! Are you available this week?",
+        "Hey there, hope this is a good time to connect",
+        "Hi, just wanted to reach out",
+    ],
+};
+export class ReputationVoucher {
+    config;
+    vouchers = new Map();
+    targets = new Map();
+    conversations = [];
+    constructor(config) {
+        this.config = { ...DEFAULT_CONFIG, ...config };
+    }
+    /**
+     * Register a vouching account (high-trust, established number)
+     */
+    registerVoucher(account) {
+        // Validate account meets minimum requirements
+        if (account.trustScore < this.config.minVoucherTrustScore) {
+            throw new Error(`Voucher trust score ${account.trustScore} below minimum ${this.config.minVoucherTrustScore}`);
+        }
+        if (account.accountAgeDays < this.config.minVoucherAgeDays) {
+            throw new Error(`Voucher account age ${account.accountAgeDays} days below minimum ${this.config.minVoucherAgeDays} days`);
+        }
+        const existing = this.vouchers.get(account.jid);
+        if (existing) {
+            // Update existing voucher (preserve counters)
+            this.vouchers.set(account.jid, {
+                ...account,
+                vouchesThisWeek: existing.vouchesThisWeek,
+                totalVouches: existing.totalVouches,
+                failedVouches: existing.failedVouches,
+                strikes: existing.strikes,
+                suspendedUntil: existing.suspendedUntil,
+                lastVouchAt: existing.lastVouchAt,
+            });
+        }
+        else {
+            // New voucher
+            this.vouchers.set(account.jid, {
+                ...account,
+                vouchesThisWeek: 0,
+                totalVouches: 0,
+                failedVouches: 0,
+                strikes: 0,
+            });
+        }
+    }
+    /**
+     * Queue a target for vouching
+     */
+    queueTarget(target) {
+        const existing = this.targets.get(target.jid);
+        if (existing && existing.status !== 'failed') {
+            // Already queued or in progress
+            return;
+        }
+        this.targets.set(target.jid, {
+            ...target,
+            qualifyingEvents: target.qualifyingEvents || 0,
+            requestedAt: Date.now(),
+            status: 'pending',
+        });
+    }
+    /**
+     * Check if a target qualifies for vouching
+     */
+    targetQualifies(jid) {
+        const target = this.targets.get(jid);
+        if (!target) {
+            return { qualified: false, reason: 'Target not queued', eventsNeeded: this.config.qualifyingEventsRequired };
+        }
+        const events = target.qualifyingEvents || 0;
+        if (events < this.config.qualifyingEventsRequired) {
+            return {
+                qualified: false,
+                reason: `Not enough qualifying events (${events}/${this.config.qualifyingEventsRequired})`,
+                eventsNeeded: this.config.qualifyingEventsRequired - events,
+            };
+        }
+        if (target.status === 'completed') {
+            return { qualified: false, reason: 'Already vouched' };
+        }
+        if (target.status === 'failed') {
+            return { qualified: false, reason: 'Previous vouch failed' };
+        }
+        return { qualified: true };
+    }
+    /**
+     * Record a qualifying event for a target (e.g., auction completion, payment cleared)
+     */
+    recordQualifyingEvent(jid) {
+        const target = this.targets.get(jid);
+        if (!target) {
+            // Auto-queue with first event
+            this.queueTarget({ jid, qualifyingEvents: 1 });
+            return;
+        }
+        target.qualifyingEvents = (target.qualifyingEvents || 0) + 1;
+    }
+    /**
+     * Get next available voucher for a target (respects limits + suspension)
+     */
+    getAvailableVoucher() {
+        const now = Date.now();
+        const weekMs = 7 * 24 * 60 * 60 * 1000;
+        // Find eligible vouchers
+        const eligible = [];
+        for (const voucher of this.vouchers.values()) {
+            // Check suspension
+            if (voucher.suspendedUntil && voucher.suspendedUntil > now) {
+                continue;
+            }
+            // Reset weekly counter if 7 days have passed since last vouch
+            if (voucher.lastVouchAt && now - voucher.lastVouchAt > weekMs) {
+                voucher.vouchesThisWeek = 0;
+            }
+            // Check weekly limit
+            if (voucher.vouchesThisWeek >= this.config.maxVouchesPerWeek) {
+                continue;
+            }
+            eligible.push(voucher);
+        }
+        if (eligible.length === 0) {
+            return null;
+        }
+        // Sort by:
+        // 1. Lowest vouchesThisWeek (spread load)
+        // 2. Highest trustScore (best vouchers first)
+        // 3. Lowest totalVouches (rotate usage)
+        eligible.sort((a, b) => {
+            if (a.vouchesThisWeek !== b.vouchesThisWeek) {
+                return a.vouchesThisWeek - b.vouchesThisWeek;
+            }
+            if (a.trustScore !== b.trustScore) {
+                return b.trustScore - a.trustScore;
+            }
+            return a.totalVouches - b.totalVouches;
+        });
+        return eligible[0];
+    }
+    /**
+     * Plan a vouch conversation.
+     * Returns a conversation plan — caller executes the sends.
+     */
+    planVouchConversation(voucherJid, targetJid) {
+        const voucher = this.vouchers.get(voucherJid);
+        if (!voucher) {
+            throw new Error(`Voucher ${voucherJid} not registered`);
+        }
+        const target = this.targets.get(targetJid);
+        if (!target) {
+            throw new Error(`Target ${targetJid} not queued`);
+        }
+        const check = this.targetQualifies(targetJid);
+        if (!check.qualified) {
+            throw new Error(`Target ${targetJid} not qualified: ${check.reason}`);
+        }
+        // Update voucher counters
+        voucher.vouchesThisWeek++;
+        voucher.totalVouches++;
+        voucher.lastVouchAt = Date.now();
+        // Update target status
+        target.status = 'active';
+        target.vouchedAt = Date.now();
+        target.vouchedBy = voucherJid;
+        // Pick 2-3 warmup messages randomly
+        const messageCount = 2 + Math.floor(Math.random() * 2); // 2-3 messages
+        const selectedMessages = [];
+        const pool = [...this.config.warmupMessages];
+        for (let i = 0; i < messageCount && pool.length > 0; i++) {
+            const idx = Math.floor(Math.random() * pool.length);
+            selectedMessages.push(pool[idx]);
+            pool.splice(idx, 1); // Remove to avoid duplicates
+        }
+        // Create conversation plan
+        const conversation = {
+            targetJid,
+            voucherJid,
+            messages: selectedMessages.map((text, idx) => ({
+                direction: 'outbound',
+                timestamp: Date.now() + idx * 5000, // Stagger by 5s
+                text,
+            })),
+            startedAt: Date.now(),
+            success: false, // Will be updated when recordVouchOutcome is called
+        };
+        this.conversations.push(conversation);
+        return conversation;
+    }
+    /**
+     * Record outcome of a vouch.
+     * success = true if target replied within reasonable time (e.g., 7 days)
+     * success = false if target got banned within 7 days of vouch
+     */
+    recordVouchOutcome(targetJid, success) {
+        const target = this.targets.get(targetJid);
+        if (!target || !target.vouchedBy) {
+            throw new Error(`Target ${targetJid} not vouched`);
+        }
+        const voucher = this.vouchers.get(target.vouchedBy);
+        if (!voucher) {
+            throw new Error(`Voucher ${target.vouchedBy} not found`);
+        }
+        // Find the conversation
+        const conversation = this.conversations.find((c) => c.targetJid === targetJid && c.voucherJid === target.vouchedBy);
+        if (conversation) {
+            conversation.success = success;
+            conversation.completedAt = Date.now();
+        }
+        if (success) {
+            target.status = 'completed';
+        }
+        else {
+            // Failed vouch — apply strike to voucher
+            target.status = 'failed';
+            voucher.failedVouches++;
+            voucher.strikes++;
+            // Check if suspension threshold reached
+            if (voucher.strikes >= this.config.strikesForSuspension) {
+                voucher.suspendedUntil = Date.now() + this.config.suspensionDurationMs;
+            }
+        }
+    }
+    /**
+     * Calculate warmup credit for a successfully vouched target.
+     * Returns number of warmup days that can be skipped (0-3).
+     *
+     * Credit logic:
+     * - 1 reply = 1 day credit
+     * - 2+ replies = 2 days credit
+     * - Reply + 3+ days elapsed = 3 days credit (max)
+     */
+    calculateWarmupCredit(targetJid) {
+        const target = this.targets.get(targetJid);
+        if (!target || target.status !== 'completed') {
+            return 0;
+        }
+        const conversation = this.conversations.find((c) => c.targetJid === targetJid && c.success);
+        if (!conversation) {
+            return 0;
+        }
+        // Count inbound messages (replies from target)
+        const inboundCount = conversation.messages.filter((m) => m.direction === 'inbound').length;
+        if (inboundCount === 0) {
+            return 0;
+        }
+        if (inboundCount === 1) {
+            return 1;
+        }
+        if (inboundCount >= 2) {
+            // Check if 3+ days elapsed
+            const daysElapsed = (Date.now() - conversation.startedAt) / (24 * 60 * 60 * 1000);
+            if (daysElapsed >= 3) {
+                return 3; // Max credit
+            }
+            return 2;
+        }
+        return 0;
+    }
+    /**
+     * Get stats for a specific voucher
+     */
+    getVoucherStats(jid) {
+        const voucher = this.vouchers.get(jid);
+        return voucher ? { ...voucher } : null;
+    }
+    /**
+     * Get all pending targets (awaiting vouching)
+     */
+    getPendingTargets() {
+        return Array.from(this.targets.values()).filter((t) => t.status === 'pending');
+    }
+    /**
+     * Get vouch history
+     */
+    getVouchHistory() {
+        return [...this.conversations];
+    }
+    /**
+     * Export state for persistence
+     */
+    exportState() {
+        return {
+            version: 1,
+            exportedAt: Date.now(),
+            vouchers: Array.from(this.vouchers.values()),
+            targets: Array.from(this.targets.values()),
+            conversations: [...this.conversations],
+        };
+    }
+    /**
+     * Import state from persistence
+     */
+    importState(state) {
+        // Clear existing state
+        this.vouchers.clear();
+        this.targets.clear();
+        this.conversations = [];
+        // Import vouchers
+        for (const voucher of state.vouchers) {
+            this.vouchers.set(voucher.jid, { ...voucher });
+        }
+        // Import targets
+        for (const target of state.targets) {
+            this.targets.set(target.jid, { ...target });
+        }
+        // Import conversations
+        this.conversations = [...state.conversations];
+    }
+}

package/dist/stateExport.d.ts

@@ -13,6 +13,7 @@
 import type { WarmUpState } from './warmup.js';
 import type { MessageTypeRegistryState } from './messageTypeRegistry.js';
 import type { TopologyThrottlerState } from './topologyThrottler.js';
+import type { ReputationVoucherState } from './reputationVoucher.js';
 export interface DisconnectEvent {
     type: 'disconnect' | 'forbidden' | 'loggedOut' | 'messageFailed' | 'reconnect' | 'reachoutTimelocked';
     timestamp: number;
@@ -78,6 +79,8 @@ export interface AntibanSnapshot {
     messageRegistry?: MessageTypeRegistryState;
     /** Topology throttler state */
     topologyThrottler?: TopologyThrottlerState;
+    /** Reputation voucher state */
+    reputationVoucher?: ReputationVoucherState;
     /** Per-JID engagement scores */
     engagementScores?: Record<string, number>;
 }
@@ -119,6 +122,9 @@ export declare function exportAntibanState(modules: {
     topologyThrottler?: {
         exportState: () => TopologyThrottlerState;
     };
+    reputationVoucher?: {
+        exportState: () => ReputationVoucherState;
+    };
     engagementScores?: Map<string, number>;
     instanceId?: string;
 }): AntibanSnapshot;
@@ -150,5 +156,8 @@ export declare function importAntibanState(snapshot: AntibanSnapshot, modules: {
     topologyThrottler?: {
         importState: (state: TopologyThrottlerState) => void;
     };
+    reputationVoucher?: {
+        importState: (state: ReputationVoucherState) => void;
+    };
     engagementScores?: Map<string, number>;
 }): void;

package/dist/stateExport.js

@@ -71,6 +71,10 @@ export function exportAntibanState(modules) {
     if (modules.topologyThrottler) {
         snapshot.topologyThrottler = modules.topologyThrottler.exportState();
     }
+    // Export reputation voucher state
+    if (modules.reputationVoucher) {
+        snapshot.reputationVoucher = modules.reputationVoucher.exportState();
+    }
     // Export engagement scores
     if (modules.engagementScores) {
         snapshot.engagementScores = Object.fromEntries(modules.engagementScores.entries());
@@ -148,6 +152,10 @@ export function importAntibanState(snapshot, modules) {
     if (snapshot.topologyThrottler && modules.topologyThrottler) {
         modules.topologyThrottler.importState(snapshot.topologyThrottler);
     }
+    // Import reputation voucher state
+    if (snapshot.reputationVoucher && modules.reputationVoucher) {
+        modules.reputationVoucher.importState(snapshot.reputationVoucher);
+    }
     // Import engagement scores
     if (snapshot.engagementScores && modules.engagementScores) {
         for (const [jid, score] of Object.entries(snapshot.engagementScores)) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "baileys-antiban",
-  "version": "4.9.0",
+  "version": "4.10.0",
   "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",