baileys-antiban 3.6.1 → 3.7.0

package/CHANGELOG.md

@@ -5,6 +5,19 @@ 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.7.0] - 2026-04-27
+
+### Added
+- `LidResolver.learnFromGroupMetadata(participants)` — ingest LID↔PN mappings from Baileys group metadata. Supports v6 (`id: '@s.whatsapp.net', lid: '@lid'`) and v7 (`id: '@lid', phoneNumber: '@s.whatsapp.net'`) participant formats.
+- `JidCanonicalizer.learnFromGroupMetadata(participants)` — passthrough to `LidResolver.learnFromGroupMetadata()`.
+
+### Fixed
+- Confirmed compatibility with Baileys v7.0.0-rc.9 LID migration. `resolveCanonical()` correctly falls back to original JID when LID→PN mapping is unknown (no throw).
+
+### Notes
+- Default `enabled: false` unchanged — opt-in as always.
+- Group metadata learning is the recommended way to pre-populate LID mappings for auction groups where `getCachedGroupMetadata()` is called anyway.
+
 ## [3.6.1] - 2026-04-26
 
 ### Changed

package/dist/jidCanonicalizer.d.ts

@@ -80,6 +80,21 @@ export declare class JidCanonicalizer {
         messages: Array<any>;
         type?: string;
     }): void;
+    /**
+     * Learn LID↔PN mappings from group metadata participants.
+     * Call after fetchGroupMetadata() to pre-populate the resolver map.
+     * No-op if canonicalization is disabled.
+     *
+     * @param participants - Group metadata participants array from Baileys
+     * @returns Number of new mappings learned (0 if disabled)
+     */
+    learnFromGroupMetadata(participants: Array<{
+        id: string;
+        lid?: string;
+        phoneNumber?: string;
+        phone?: string;
+        number?: string;
+    }>): number;
     /**
      * Called by wrapper on messages.update event. Learns from sent-message refs.
      */

package/dist/jidCanonicalizer.js

@@ -149,6 +149,20 @@ export class JidCanonicalizer {
             this.learnFromMessage(msg);
         }
     }
+    /**
+     * Learn LID↔PN mappings from group metadata participants.
+     * Call after fetchGroupMetadata() to pre-populate the resolver map.
+     * No-op if canonicalization is disabled.
+     *
+     * @param participants - Group metadata participants array from Baileys
+     * @returns Number of new mappings learned (0 if disabled)
+     */
+    learnFromGroupMetadata(participants) {
+        if (!this.config.enabled || !this.config.learnFromEvents) {
+            return 0;
+        }
+        return this.lidResolver.learnFromGroupMetadata(participants);
+    }
     /**
      * Called by wrapper on messages.update event. Learns from sent-message refs.
      */

package/dist/lidResolver.d.ts

@@ -71,6 +71,22 @@ export declare class LidResolver {
      * Full mapping for inspection
      */
     getMapping(jid: string): LidMapping | null;
+    /**
+     * Learn LID↔PN mappings from group metadata participants.
+     * Call this after fetchGroupMetadata() to pre-populate the map.
+     * Supports both {id: '@lid', phoneNumber: '@s.whatsapp.net'} and
+     * {id: '@s.whatsapp.net', lid: '@lid'} participant formats (v7 + v6 shapes).
+     *
+     * @param participants - Group metadata participants array from Baileys
+     * @returns Number of new mappings learned
+     */
+    learnFromGroupMetadata(participants: Array<{
+        id: string;
+        lid?: string;
+        phoneNumber?: string;
+        phone?: string;
+        number?: string;
+    }>): number;
     /**
      * Seed from persistence (called automatically in constructor if persistence provided)
      */

package/dist/lidResolver.js

@@ -178,6 +178,38 @@ export class LidResolver {
         }
         return null;
     }
+    /**
+     * Learn LID↔PN mappings from group metadata participants.
+     * Call this after fetchGroupMetadata() to pre-populate the map.
+     * Supports both {id: '@lid', phoneNumber: '@s.whatsapp.net'} and
+     * {id: '@s.whatsapp.net', lid: '@lid'} participant formats (v7 + v6 shapes).
+     *
+     * @param participants - Group metadata participants array from Baileys
+     * @returns Number of new mappings learned
+     */
+    learnFromGroupMetadata(participants) {
+        let learned = 0;
+        for (const p of participants) {
+            const domain = p.id.split('@')[1] || '';
+            if (domain === 'lid' && (p.phoneNumber || p.phone || p.number)) {
+                const pn = p.phoneNumber || (p.phone ? `${p.phone}@s.whatsapp.net` : null) || (p.number ? `${p.number}@s.whatsapp.net` : null);
+                if (pn) {
+                    const prevSize = this.lidToPn.size;
+                    this.learn({ lid: p.id, pn });
+                    if (this.lidToPn.size > prevSize)
+                        learned++;
+                }
+            }
+            else if (domain === 's.whatsapp.net' && p.lid) {
+                const lid = p.lid.endsWith('@lid') ? p.lid : `${p.lid}@lid`;
+                const prevSize = this.lidToPn.size;
+                this.learn({ lid, pn: p.id });
+                if (this.lidToPn.size > prevSize)
+                    learned++;
+            }
+        }
+        return learned;
+    }
     /**
      * Seed from persistence (called automatically in constructor if persistence provided)
      */

package/package.json

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