@neelegirl/baileys 2.1.0 → 2.1.3

package/README.md

@@ -1,891 +1,83 @@
-<div align="center">
+# @neelegirl/baileys
 
-# @neelegirl/baileys
+![Neelegirl Baileys](https://files.catbox.moe/phppor.JPG)
 
-**Kuratiertes CommonJS-Fork-Paket auf Basis von WhiskeySockets/Baileys**  
-**für Neelegirl und `@neelegirl/wa-api` – mit bewusst erhaltenem QR-Flow und `NEELE`-Message-ID-Signatur.**
+CJS-compatible Baileys fork for projects that depend on `require()` runtime behavior, especially `@neelegirl/wa-api`.
 
-[![npm](https://img.shields.io/npm/v/@neelegirl/baileys?style=for-the-badge&color=ff69b4&logo=npm)](https://www.npmjs.com/package/@neelegirl/baileys)
-[![Node](https://img.shields.io/badge/Node-20+-2ea043?style=for-the-badge&logo=node.js)](https://nodejs.org)
-[![Upstream](https://img.shields.io/badge/WhiskeySockets-Baileys%207.0.0--rc.9-6f42c1?style=for-the-badge)](https://github.com/WhiskeySockets/Baileys)
-[![License](https://img.shields.io/badge/License-MIT-f778ba?style=for-the-badge)](LICENSE)
+## Status
 
-<p align="center">
-  <img src="https://files.catbox.moe/phppor.JPG" width="920" alt="Neelegirl Baileys Hero" />
-</p>
+- Upstream base: `WhiskeySockets/Baileys` `v7.0.0-rc.9`
+- Upstream tracking: latest WhatsApp Web version update from upstream master integrated
+- Local package version: `2.1.0`
+- Node.js: `>=20`
 
-</div>
+## What This Fork Keeps
 
-## Überblick
+- Existing QR handling logic (unchanged)
+- Existing message-id signature logic containing `NEELE` (unchanged)
+- CJS-first runtime shape used by current Neelegirl ecosystem
 
-`@neelegirl/baileys` ist kein blindes 1:1-Repackaging des Upstreams. Dieses Paket hält eine bewusst kompatible CommonJS-Oberfläche für bestehende Neelegirl-/wa-api-Integrationen aufrecht und übernimmt nur solche Änderungen, die technisch sauber in die bestehende Struktur passen.
+## What Is Included
 
-### Was in `2.1.0` konkret gemacht wurde
+- Full socket/event/auth API surface exported from `lib/`
+- LID and hosted JID handling in receive/send pipelines
+- Group, community, newsletter, and media helpers
+- Store helpers (`makeInMemoryStore`, cache-manager store)
+- Optional QR terminal rendering via `qrcode-terminal`
 
-- Paketmetadaten, Export-Surface und Node-Anforderungen aufgeräumt
-- Inkonsistente Dependency-Lage korrigiert, inklusive `lru-cache`
-- Signal-Session-Validierung für moderneres Retry-Verhalten ergänzt
-- Retry-Pipeline selektiv an neuere Baileys-Mechanik angenähert
-- Dokumentation vollständig neu geschrieben und auf reale Funktionen reduziert
-
-### Was absichtlich **nicht** verändert wurde
-
-- QR-Code-Logik und QR-Anzeige bleiben unverändert
-- die `NEELE`-Message-ID-Signatur bleibt unverändert
-- projektindividuelle Neelegirl-Anpassungen bleiben erhalten, sofern sie nicht mit einem sicheren Upstream-Backport kollidieren
-
-## Update-Status
-
-| Bereich | Status |
-| --- | --- |
-| Paketbasis | gezielte Backports aus aktuellem WhiskeySockets/Baileys-Stand |
-| Modulformat | bewusst CommonJS für bestehende Integrationen |
-| QR-Login | unverändert erhalten |
-| Message-ID-Signatur | unverändert erhalten (`NEELE`) |
-| Vollsync auf Upstream-ESM | **nicht** übernommen |
-
-**Wichtig:** Dieses Paket baut auf aktuellem Upstream-Wissen auf, ist aber **kein vollständiger ESM-Vollsync** auf `baileys@7.0.0-rc.9`. Das ist Absicht, damit bestehende Neelegirl-/wa-api-Projekte nicht durch einen harten Modulwechsel brechen.
-
-## Installation
+## Install
 
 ```bash
 npm install @neelegirl/baileys
 ```
 
-oder:
-
-```bash
-yarn add @neelegirl/baileys
-```
-
-## Voraussetzungen
-
-- Node.js `20+`
-- Multi-Device-WhatsApp-Account
-- Schreibzugriff für deine Auth-Dateien
-
-## Quickstart
-
-### ESM
+## Quick Start
 
 ```js
-import makeWASocket, {
-  Browsers,
-  DisconnectReason,
+const {
+  default: makeWASocket,
+  useMultiFileAuthState,
   fetchLatestBaileysVersion,
-  useMultiFileAuthState
-} from '@neelegirl/baileys'
-import { Boom } from '@hapi/boom'
+  DisconnectReason,
+  Browsers,
+} = require('@neelegirl/baileys')
 
-async function startBot() {
-  const { state, saveCreds } = await useMultiFileAuthState('./auth_info')
+async function boot() {
+  const { state, saveCreds } = await useMultiFileAuthState('./wa_auth')
   const { version } = await fetchLatestBaileysVersion()
 
   const sock = makeWASocket({
     version,
     auth: state,
-    browser: Browsers.macOS('Desktop'),
-    printQRInTerminal: true
+    printQRInTerminal: true,
+    browser: Browsers.ubuntu('Chrome'),
   })
 
   sock.ev.on('creds.update', saveCreds)
-
-  sock.ev.on('connection.update', ({ connection, lastDisconnect, qr }) => {
-    if (qr) {
-      console.log('QR empfangen – scanne ihn in WhatsApp.')
-    }
-
-    if (connection === 'open') {
-      console.log('WhatsApp verbunden.')
-    }
-
+  sock.ev.on('connection.update', ({ connection, lastDisconnect }) => {
     if (connection === 'close') {
-      const statusCode = new Boom(lastDisconnect?.error)?.output?.statusCode
-      const shouldReconnect = statusCode !== DisconnectReason.loggedOut
-      console.log('Verbindung geschlossen. Reconnect:', shouldReconnect)
-      if (shouldReconnect) {
-        startBot().catch(console.error)
+      const code = lastDisconnect?.error?.output?.statusCode
+      if (code !== DisconnectReason.loggedOut) {
+        boot()
       }
     }
   })
 }
 
-startBot().catch(console.error)
-```
-
-### CommonJS
-
-```js
-const {
-  default: makeWASocket,
-  Browsers,
-  fetchLatestBaileysVersion,
-  useMultiFileAuthState
-} = require('@neelegirl/baileys')
-```
-
-## Praktische Start-Hinweise
-
-Beim ersten Bot-Start sind diese Meldungen normal und gewollt:
-
-- `QR empfangen` oder eine QR-Terminalausgabe bei frischer Session
-- `creds.update`, sobald Credentials gespeichert werden
-- `connection: open`, wenn die Sitzung steht
-- erneute Verbindungsversuche nach Netzabbrüchen
-
-Wenn du `printQRInTerminal: false` setzt, musst du den QR selbst aus `connection.update` verarbeiten.
-
-## Reale Kernfunktionen
-
-- `makeWASocket()` – Socket-Initialisierung für WhatsApp Web
-- `useMultiFileAuthState()` und `useMultiFileAuthStateV2()` – persistente Auth-Verwaltung
-- `fetchLatestBaileysVersion()` – Laufzeitabgleich der WhatsApp-Web-Version
-- `makeInMemoryStore()` – In-Memory-Store für Chat-/Kontaktzustand
-- LID-/PN-bezogene Hilfen in `WABinary`, `WAUSync`, `Signal` und `Utils`
-
-## Technischer Stand
-
-Dieses Fork übernimmt bewusst nur Änderungen, die mit dem vorhandenen CommonJS-Build und den bestehenden Neelegirl-Anpassungen sauber zusammenpassen.
-
-### Übernommen bzw. angeglichen
-
-- modernisierte Paketmetadaten und Export-Pfade
-- Node-20-Laufzeitanforderung
-- Retry-Manager-Anbindung für stabileres Retry-Verhalten
-- Session-Validierung im Signal-Repository
-
-### Bewusst nicht blind übernommen
-
-- kompletter ESM-Wechsel des aktuellen Upstreams
-- Rust-Bridge-/ESM-spezifische Upstream-Pfade
-- jede Upstream-Änderung, die die bestehende Neelegirl-/wa-api-Kompatibilität brechen würde
-
-## Bekannte Grenzen
-
-- kein vollständiger 1:1-Upstream-Sync auf die aktuelle ESM-Struktur
-- Dokumentation beschreibt nur APIs, die im Paket tatsächlich vorhanden sind
-- wer Upstream-ESM oder den Rust-Bridge-Stack benötigt, sollte ein separates Migrationsprojekt planen statt dieses CJS-Fork umzubauen
-
-## Hinweise für Integrationen
-
-- `@neelegirl/wa-api` soll gegen dieselbe Paketversion laufen
-- für lokale Installationen sollte keine veraltete eingebettete Kopie von `@neelegirl/baileys` bevorzugt werden
-- bei eigenen Typimports nutze bevorzugt den Root-Import statt tiefer, interner Pfade
-
-## Lizenz
-
-MIT. Upstream-Grundlage stammt von WhiskeySockets/Baileys; dieses Paket bringt darauf abgestimmte Neelegirl-Anpassungen und kompatible Backports zusammen.
-import { createSmartMessageQueue } from '@neelegirl/baileys'
-
-// Queue erstellen
-const queue = createSmartMessageQueue(sock, {
-  maxRetries: 3,           // Max. 3 Retry-Versuche
-  retryDelay: 1000,        // 1 Sekunde Basis-Delay
-  maxConcurrent: 5,        // Max. 5 gleichzeitige Nachrichten
-  onSuccess: (message) => {
-    console.log('✅ Nachricht erfolgreich gesendet!')
-  },
-  onError: (message, error) => {
-    console.error('❌ Nachricht fehlgeschlagen:', error)
-  }
-})
-
-// Nachrichten zur Queue hinzufügen
-await queue.add({
-  jid: '491234567890@s.whatsapp.net',
-  message: { text: 'Wichtige Nachricht!' },
-  priority: 'high' // 'low' | 'normal' | 'high'
-})
-
-// Queue-Statistiken abrufen
-const stats = queue.getStats()
-console.log(`Pending: ${stats.pending}, Processing: ${stats.processing}, Failed: ${stats.failed}`)
-
-// Queue pausieren/fortsetzen
-queue.pause()  // Pausiert die Verarbeitung
-queue.resume() // Setzt die Verarbeitung fort
-
-// Queue leeren
-queue.clear()
-```
-
-**Features der Smart Queue:**
-- ✅ **Automatische Retries** mit Exponential Backoff
-- ✅ **Prioritäts-System** (high > normal > low)
-- ✅ **Rate-Limiting** durch maxConcurrent
-- ✅ **Error-Handling** mit Callbacks
-- ✅ **Queue-Statistiken** für Monitoring
-- ✅ **Pause/Resume** für flexible Kontrolle
-
-#### 1. **`onWhatsApp()`** - Prüfe ob Nummer auf WhatsApp ist
-
-```typescript
-const [result] = await sock.onWhatsApp('491234567890@s.whatsapp.net')
-if (result?.exists) {
-  console.log(`✅ ${result.jid} ist auf WhatsApp!`)
-}
-```
-
-#### 2. **`executeUSyncQuery()`** - USync-Queries ausführen
-
-```typescript
-import { USyncQuery, USyncContactProtocol } from '@neelegirl/baileys'
-
-const query = new USyncQuery()
-  .withContactProtocol()
-  .withUser(new USyncUser().withPhone('+491234567890'))
-
-const result = await sock.executeUSyncQuery(query)
-console.log('Kontakt-Info:', result)
-```
-
-#### 3. **`digestKeyBundle()`** - Key-Bundle validieren
-
-```typescript
-try {
-  await sock.digestKeyBundle()
-  console.log('✅ Key-Bundle ist gültig')
-} catch (error) {
-  console.log('⚠️ Key-Bundle ungültig, Pre-Keys werden hochgeladen')
-}
-```
-
-#### 4. **`rotateSignedPreKey()`** - Signed Pre-Key rotieren
-
-```typescript
-await sock.rotateSignedPreKey()
-console.log('✅ Signed Pre-Key wurde rotiert')
-```
-
-### 🔄 **Automatische Update-Prüfung**
-
-Bei jedem Start wird automatisch geprüft, ob eine neue Version verfügbar ist:
-
-```
-╔════════════════════════════════════════╗
-║  🔔 NEUES UPDATE VERFÜGBAR! 🔔        ║
-╠════════════════════════════════════════╣
-║  @neelegirl/baileys                    ║
-║  Aktuelle Version: 1.6.6               ║
-║  Neue Version:     1.7.0                ║
-║                                        ║
-║  Bitte aktualisiere:                  ║
-║  npm install @neelegirl/baileys@latest ║
-╚════════════════════════════════════════╝
-```
-
----
-
-## 💡 Grundlegende Verwendung
-
-### 📱 **Nachrichten senden**
-
-```typescript
-// Text-Nachricht
-await sock.sendMessage(jid, { text: 'Hallo! 🌸' })
-
-// Mit Quote (Antwort)
-await sock.sendMessage(jid, { 
-  text: 'Das ist eine Antwort!' 
-}, { 
-  quoted: originalMessage 
-})
-
-// Mit Erwähnung
-await sock.sendMessage(jid, {
-  text: '@491234567890 Hallo!',
-  mentions: ['491234567890@s.whatsapp.net']
-})
+boot().catch(console.error)
 ```
 
-### 🖼️ **Medien senden**
-
-```typescript
-// Bild
-await sock.sendMessage(jid, {
-  image: { url: './bild.jpg' },
-  caption: 'Schönes Bild! 🌸'
-})
-
-// Video
-await sock.sendMessage(jid, {
-  video: { url: './video.mp4' },
-  caption: 'Mein Video! 🎬'
-})
-
-// GIF (als Video mit gifPlayback Flag)
-await sock.sendMessage(jid, {
-  video: { url: './animation.mp4' },
-  gifPlayback: true,
-  caption: 'Kawaii GIF! ✨'
-})
-
-// Audio/Sprachnachricht
-await sock.sendMessage(jid, {
-  audio: { url: './audio.ogg' },
-  mimetype: 'audio/ogg',
-  ptt: true // Push-to-Talk (Sprachnachricht)
-})
-
-// Dokument
-await sock.sendMessage(jid, {
-  document: { url: './dokument.pdf' },
-  mimetype: 'application/pdf',
-  fileName: 'Wichtiges Dokument.pdf'
-})
-
-// Sticker
-await sock.sendMessage(jid, {
-  sticker: { url: './sticker.webp' }
-})
-```
-
-### 👥 **Gruppen**
-
-```typescript
-// Gruppe erstellen
-const group = await sock.groupCreate('Meine Gruppe', [
-  '491234567890@s.whatsapp.net',
-  '499876543210@s.whatsapp.net'
-])
-
-// Teilnehmer hinzufügen
-await sock.groupParticipantsUpdate(
-  group.id,
-  ['491111111111@s.whatsapp.net'],
-  'add'
-)
-
-// Gruppenname ändern
-await sock.groupUpdateSubject(group.id, 'Neuer Gruppenname')
-
-// Gruppenbeschreibung ändern
-await sock.groupUpdateDescription(group.id, 'Neue Beschreibung')
-
-// Gruppen-Einstellungen ändern
-await sock.groupSettingUpdate(group.id, 'announcement') // Nur Admins können schreiben
-await sock.groupSettingUpdate(group.id, 'not_announcement') // Alle können schreiben
-```
-
-### 📊 **Umfragen (Polls)**
-
-```typescript
-await sock.sendMessage(jid, {
-  poll: {
-    name: 'Was ist deine Lieblingsfarbe?',
-    values: ['Rot', 'Blau', 'Grün', 'Gelb'],
-    selectableCount: 1 // Anzahl der auswählbaren Optionen
-  }
-})
-```
-
-### ⭐ **Reaktionen**
-
-```typescript
-// Reaktion hinzufügen
-await sock.sendMessage(jid, {
-  react: {
-    text: '❤️',
-    key: message.key
-  }
-})
-
-// Reaktion entfernen (leerer String)
-await sock.sendMessage(jid, {
-  react: {
-    text: '',
-    key: message.key
-  }
-})
-```
-
----
-
-## 🎯 Erweiterte Features
-
-### 🚀 **Smart Message Queue - Praktisches Beispiel**
-
-```typescript
-import { createSmartMessageQueue } from '@neelegirl/baileys'
-
-// Queue für Bulk-Messaging erstellen
-const bulkQueue = createSmartMessageQueue(sock, {
-  maxRetries: 5,
-  retryDelay: 2000,
-  maxConcurrent: 3, // Nicht zu viele gleichzeitig
-  onSuccess: (msg) => {
-    console.log(`✅ Gesendet an ${msg.jid}`)
-  },
-  onError: (msg, err) => {
-    console.error(`❌ Fehler bei ${msg.jid}:`, err.message)
-  }
-})
-
-// Viele Nachrichten hinzufügen
-const recipients = [
-  '491234567890@s.whatsapp.net',
-  '499876543210@s.whatsapp.net',
-  '491111111111@s.whatsapp.net'
-]
-
-for (const jid of recipients) {
-  await bulkQueue.add({
-    jid,
-    message: { text: 'Wichtige Ankündigung! 📢' },
-    priority: 'high'
-  })
-}
-
-// Statistik prüfen
-setInterval(() => {
-  const stats = bulkQueue.getStats()
-  console.log(`Queue: ${stats.pending} pending, ${stats.processing} processing, ${stats.failed} failed`)
-}, 5000)
-```
-
-### 💠 **LID-Kompatibilität (Linked ID)**
-
-LID sorgt dafür, dass Benutzer auch über geräteübergreifende IDs korrekt erkannt werden:
-
-```typescript
-import { jidDecode, jidEncode, isLidUser } from '@neelegirl/baileys'
-
-// Prüfe ob es eine LID ist
-if (isLidUser(someJid)) {
-  console.log('Das ist eine LID!')
-}
-
-// JID dekodieren
-const decoded = jidDecode('491234567890@s.whatsapp.net')
-console.log(decoded) // { user: '491234567890', server: 's.whatsapp.net' }
-
-// JID encodieren
-const encoded = jidEncode('491234567890', 's.whatsapp.net')
-console.log(encoded) // '491234567890@s.whatsapp.net'
-```
-
-### 🔐 **Sichere Sender-ID-Extraktion**
-
-```typescript
-import { jidDecode } from '@neelegirl/baileys'
-
-function getSenderId(message: any) {
-  const participant = message?.key?.participant || message?.participant
-  const lid = participant || message?.key?.remoteJid
-  
-  if (lid) {
-    const decoded = jidDecode(lid)
-    return decoded?.user 
-      ? `${decoded.user}@${decoded.server}` 
-      : lid
-  }
-  
-  return 'unknown'
-}
-
-sock.ev.on('messages.upsert', ({ messages }) => {
-  const sender = getSenderId(messages[0])
-  console.log('Nachricht von:', sender)
-})
-```
-
-### 📥 **Medien herunterladen**
-
-```typescript
-import { downloadMediaMessage } from '@neelegirl/baileys'
-import { writeFile } from 'fs/promises'
-
-sock.ev.on('messages.upsert', async ({ messages }) => {
-  const m = messages[0]
-  
-  if (m.message?.imageMessage) {
-    // Medien als Buffer herunterladen
-    const buffer = await downloadMediaMessage(
-      m,
-      'buffer',
-      {},
-      { logger: sock.logger }
-    )
-    
-    // Speichern
-    await writeFile('./downloaded-image.jpg', buffer)
-    console.log('✅ Bild gespeichert!')
-  }
-})
-```
-
-### 🔄 **Nachrichten bearbeiten**
-
-```typescript
-// Nachricht bearbeiten
-const sentMessage = await sock.sendMessage(jid, { text: 'Ursprünglicher Text' })
-
-// Später bearbeiten
-await sock.sendMessage(jid, {
-  text: 'Bearbeiteter Text',
-  edit: sentMessage.key
-})
-```
-
-### 🗑️ **Nachrichten löschen**
-
-```typescript
-// Für alle löschen
-await sock.sendMessage(jid, { delete: message.key })
-
-// Nur für mich löschen (via chatModify)
-await sock.chatModify({
-  clear: {
-    messages: [{
-      id: message.key.id,
-      fromMe: true,
-      timestamp: message.messageTimestamp
-    }]
-  }
-}, jid)
-```
-
-### 📌 **Nachrichten anpinnen**
-
-```typescript
-// Nachricht anpinnen (24 Stunden)
-await sock.sendMessage(jid, {
-  pin: {
-    type: 1, // 0 = entfernen, 1 = anpinnen
-    time: 86400, // Sekunden (24h)
-    key: message.key
-  }
-})
-```
-
-### 📍 **Standort senden**
-
-```typescript
-await sock.sendMessage(jid, {
-  location: {
-    degreesLatitude: 52.520008,
-    degreesLongitude: 13.404954
-  }
-})
-```
-
-### 📇 **Kontakt teilen**
-
-```typescript
-const vcard = `BEGIN:VCARD
-VERSION:3.0
-FN:Max Mustermann
-TEL;type=CELL;type=VOICE;waid=491234567890:+49 123 4567890
-END:VCARD`
-
-await sock.sendMessage(jid, {
-  contacts: {
-    displayName: 'Max Mustermann',
-    contacts: [{ vcard }]
-  }
-})
-```
-
-### 🔄 **Nachrichten weiterleiten**
-
-```typescript
-await sock.sendMessage(jid, {
-  forward: originalMessage
-})
-```
-
----
-
-## 📚 Dokumentation
-
-### 🎧 **Events (Event-Handler)**
-
-```typescript
-// Verbindungs-Updates
-sock.ev.on('connection.update', (update) => {
-  if (update.qr) {
-    console.log('📱 QR-Code:', update.qr)
-  }
-  if (update.connection === 'open') {
-    console.log('✅ Verbunden!')
-  }
-})
-
-// Neue Nachrichten
-sock.ev.on('messages.upsert', ({ messages, type }) => {
-  console.log('📥 Neue Nachricht:', messages[0])
-})
-
-// Nachrichten-Updates (z.B. gelesen, gelöscht)
-sock.ev.on('messages.update', (updates) => {
-  updates.forEach(({ key, update }) => {
-    if (update.status) {
-      console.log('📊 Status Update:', update.status)
-    }
-  })
-})
-
-// Credentials-Update (wichtig für Session-Speicherung!)
-sock.ev.on('creds.update', saveCreds)
-
-// Kontakte-Update
-sock.ev.on('contacts.update', (updates) => {
-  updates.forEach(update => {
-    console.log('👤 Kontakt-Update:', update)
-  })
-})
-
-// Gruppen-Updates
-sock.ev.on('groups.update', (updates) => {
-  updates.forEach(update => {
-    console.log('👥 Gruppen-Update:', update)
-  })
-})
-
-// Presence-Update (online, offline, typing)
-sock.ev.on('presence.update', ({ id, presences }) => {
-  console.log('🟢 Presence:', id, presences)
-})
-```
-
-### 🔧 **Socket-Konfiguration**
-
-```typescript
-const sock = makeWASocket({
-  // Auth-State (wichtig!)
-  auth: state,
-  
-  // WhatsApp-Version (automatisch oder manuell)
-  version: [2, 3000, 1032141294],
-  
-  // Browser-Info
-  browser: ['Mein Bot', 'Chrome', '1.0.0'],
-  // Oder vordefinierte Browser:
-  // browser: Browsers.macOS('Desktop')
-  // browser: Browsers.ubuntu('Server')
-  // browser: Browsers.iOS('Mobile')
-  
-  // QR-Code im Terminal anzeigen
-  printQRInTerminal: true,
-  
-  // Online beim Verbinden markieren
-  markOnlineOnConnect: true,
-  
-  // Vollständige Historie synchronisieren
-  syncFullHistory: false,
-  
-  // Logger (optional)
-  logger: pino({ level: 'silent' }),
-  
-  // Message-Store (für Retry & Poll-Votes)
-  getMessage: async (key) => {
-    // Hole Nachricht aus deinem Store
-    return await yourMessageStore.get(key)
-  },
-  
-  // Group-Metadata-Cache (empfohlen!)
-  cachedGroupMetadata: async (jid) => {
-    // Hole aus Cache
-    return await groupCache.get(jid)
-  },
-  
-  // Custom Upload Hosts
-  customUploadHosts: [],
-  
-  // Retry-Konfiguration
-  maxMsgRetryCount: 5,
-  retryRequestDelayMs: 250,
-  
-  // Query-Timeout
-  defaultQueryTimeoutMs: 60000,
-  
-  // QR-Timeout
-  qrTimeout: 60000
-})
-```
-
-### 💾 **Session-Speicherung**
-
-```typescript
-import { useMultiFileAuthState, BufferJSON } from '@neelegirl/baileys'
-import { readFileSync, writeFileSync } from 'fs'
-
-// Option 1: Multi-File (einfach, empfohlen für Entwicklung)
-const { state, saveCreds } = await useMultiFileAuthState('./auth_info')
-
-// Option 2: Single-File (für Produktion)
-import { useSingleFileAuthState } from '@neelegirl/baileys'
-
-const { state, saveCreds } = await useSingleFileAuthState('./auth.json')
-
-// Option 3: Custom (für Datenbanken)
-const authFile = './auth.json'
-
-const { state, saveCreds } = {
-  state: {
-    creds: JSON.parse(
-      readFileSync(authFile, { encoding: 'utf-8' }),
-      BufferJSON.reviver
-    ),
-    keys: {
-      get: async (type, ids) => {
-        // Hole Keys aus deiner DB
-      },
-      set: async (data) => {
-        // Speichere Keys in deiner DB
-      }
-    }
-  },
-  saveCreds: async () => {
-    const creds = state.creds
-    writeFileSync(authFile, JSON.stringify(creds, BufferJSON.replacer, 2))
-  }
-}
-```
-
-### 🗄️ **Message Store (für Retry & Poll-Votes)**
-
-```typescript
-import { makeInMemoryStore } from '@neelegirl/baileys'
-
-// In-Memory Store (für Entwicklung)
-const store = makeInMemoryStore({ logger: pino().child({ level: 'silent' }) })
-
-// Aus Datei laden
-store.readFromFile('./baileys_store.json')
-
-// Socket binden
-store.bind(sock.ev)
-
-// Alle 10 Sekunden speichern
-setInterval(() => {
-  store.writeToFile('./baileys_store.json')
-}, 10_000)
-
-// In Socket-Config verwenden
-const sock = makeWASocket({
-  getMessage: async (key) => {
-    return store.loadMessage(key.remoteJid!, key.id!)
-  }
-})
-```
-
----
-
-## ⚠️ Wichtige Hinweise
-
-### 🚨 **Disclaimer**
-
-> ⚠️ **WICHTIG**: Dieses Projekt steht in **keiner offiziellen Verbindung** zu WhatsApp.
-> 
-> - ✖️ **Kein Spam** oder Massennachrichten
-> - ✖️ **Kein Missbrauch** für unethische Zwecke  
-> - ✖️ **Keine Stalkerware** oder automatisierte Überwachung
-> - ✔️ **Verantwortungsvoller Gebrauch** wird erwartet
-> 
-> Die Entwickler:innen übernehmen **keine Verantwortung** für den Gebrauch.
-
-### 🔒 **Sicherheit**
-
-- **Nie** deine Auth-Dateien öffentlich teilen
-- **Immer** `.gitignore` für Auth-Ordner verwenden
-- **Regelmäßig** Backups erstellen
-- **Sichere** Passwörter für deine Server verwenden
-
-### 💡 **Best Practices**
-
-1. **Session-Speicherung**: Immer `useMultiFileAuthState` oder ähnliches verwenden
-2. **Error-Handling**: Immer try-catch für wichtige Operationen
-3. **Rate-Limiting**: Nicht zu viele Nachrichten auf einmal senden (nutze Smart Queue!)
-4. **Logging**: Logger für Debugging verwenden
-5. **Updates**: Regelmäßig auf Updates prüfen
-
----
-
-## 💬 Support & Community
-
-<div align="center">
-
-### 🌸 **Made with Love by @neelegirl** 🌸
-
-[![GitHub](https://img.shields.io/badge/GitHub-@neelegirl-pink?style=for-the-badge&logo=github)](https://github.com/neelegirl)
-[![Email](https://img.shields.io/badge/Email-Support-pink?style=for-the-badge&logo=gmail)](mailto:neelehoven@gmail.com)
-
-**⭐ Wenn dir dieses Projekt gefällt, gib ihm ein Star auf GitHub! ⭐**
-
-</div>
-
----
-
-## 📝 Changelog
-
-### Version 2.0.5 (Aktuell) 🎉
-
-- 📖 **README Glow-Up** – Version 2.0.5, Badges & Changelog
-- 🧪 **Engine-Check** – Node.js 20+ Hinweis für stabile Laufzeit
-- 🧰 **WAProto Tools** – GenerateStatics & Fix-Imports Skripte ergänzt
-- 🔔 **Update-Check** – Liest Version von **npm-Registry** (registry.npmjs.org), nur 1× pro Prozess
-- ✨ Semver-Vergleich für „Update verfügbar“ nur bei wirklich neuerer Version
-- 🎨 **QR-Code** & **Message ID** – unverändert
-- 🔄 Kompatibel mit **Baileys API 1.7.2**
-
-### Version 2.0.2
-
-- 📖 **README Glow-Up** – Version 2.0.2, Badges & Changelog
-- 🔔 **Update-Check** – Liest Version von **npm-Registry** (registry.npmjs.org), nur 1× pro Prozess
-- ✨ Semver-Vergleich für „Update verfügbar“ nur bei wirklich neuerer Version
-- 🎨 **QR-Code** & **Message ID** – unverändert
-- 🔄 Kompatibel mit **Baileys API 1.7.2**
-
-### Version 2.0.1
-
-- 🔄 Upstream aus Backup Baileys · LID in Pairing · historySyncConfig · getWebInfo · Defaults
-
-### Version 2.0.0
-
-- 🔄 Upstream aus Backup Baileys – validate-connection, Defaults & Pairing angeglichen
-- 🔐 LID in Pairing · 📤 historySyncConfig · 🌐 getWebInfo · ⚙️ Defaults
-- 🎨 QR-Code & Message ID unverändert · WhatsApp-Version [2, 3000, 1032141294]
-
-### Version 1.1.2
-
-- 📖 README Glow-Up, Baileys API 1.7.2 Badge
-- 🚀 Smart Message Queue, Auto-Update-Prüfung
-- 🎨 QR-Code-Anzeige · Message ID unverändert
-
-### Version 1.7.1
-
-- 📖 README Glow-Up, Smart Message Queue, Auto-Update-Check
-- 🎨 QR-Anzeige, Message ID System
-
-### Version 1.7.0
-
-- 🚀 **Smart Message Queue** eingeführt
-- ✨ Auto-Update-Check, QR-Anzeige, Message ID System
-
-### Version 1.6.6
-
-- ✨ **Automatische Update-Prüfung** hinzugefügt
-- 🎨 **Verbesserte QR-Code-Anzeige** mit Version-Info
-- 🔄 **WhatsApp-Version** aktualisiert auf [2, 3000, 1032141294]
-- 🚀 **Basiert auf** @whiskeysockets/baileys 7.0.0-rc.9
-- 🛠️ **Verbesserte Socket-Stabilität**
-- 🔐 **Verbesserte Pre-Key-Verwaltung**
-
-### Version 1.6.5
-
-- 🆕 Neue Funktionen: `onWhatsApp()`, `executeUSyncQuery()`
-- 🔐 `digestKeyBundle()` und `rotateSignedPreKey()` hinzugefügt
-- 💎 WAM Buffer Support
-
----
+## Compatibility Notes
 
-<div align="center">
+- This package intentionally stays CJS-oriented for compatibility with existing Neelegirl stacks.
+- Official upstream Baileys is ESM-first; direct drop-in replacement may break CJS consumers.
+- If you need strict upstream parity at source level, migrate consumers to ESM first.
 
-### ✨ *Möge dein Bot so bezaubernd sein wie ein Anime-Mädchen mit Glitzeraugen* ✨
+## Word2Web
 
-**🌸 Stay kawaii, stay connected! 🌸**
+No dedicated Word2Web module is shipped in this package. Do not assume Word2Web-specific behavior unless implemented in your host application.
 
-[⬆️ Nach oben](#-neelegirlbaileys)
+## Legal
 
-</div>
+This project is not affiliated with WhatsApp.
+Use responsibly and comply with applicable laws and platform terms.

package/lib/Defaults/baileys-version.json

@@ -1 +1 @@
-{"version":[2,3000,1032141294]}
+{"version":[2,3000,1035194821]}

package/lib/Defaults/index.d.ts

@@ -1,19 +1,28 @@
-import { proto } from '../../WAProto'
+import { proto } from '../../WAProto'
 import type { MediaType, SocketConfig } from '../Types'
 
 export declare const UNAUTHORIZED_CODES: number[]
 
 export declare const PHONENUMBER_MCC: Record<string, number>
 
-export declare const DEFAULT_ORIGIN: "https://web.whatsapp.com"
+export declare const DEFAULT_ORIGIN: 'https://web.whatsapp.com'
 
-export declare const DEF_CALLBACK_PREFIX: "CB:"
-export declare const DEF_TAG_PREFIX: "TAG:"
-export declare const PHONE_CONNECTION_CB: "CB:Pong"
+export declare const CALL_VIDEO_PREFIX: 'https://call.whatsapp.com/video/'
+export declare const CALL_AUDIO_PREFIX: 'https://call.whatsapp.com/voice/'
+
+export declare const DEF_CALLBACK_PREFIX: 'CB:'
+export declare const DEF_TAG_PREFIX: 'TAG:'
+export declare const PHONE_CONNECTION_CB: 'CB:Pong'
+
+export declare const WA_ADV_ACCOUNT_SIG_PREFIX: Buffer
+export declare const WA_ADV_DEVICE_SIG_PREFIX: Buffer
+export declare const WA_ADV_HOSTED_ACCOUNT_SIG_PREFIX: Buffer
+export declare const WA_ADV_HOSTED_DEVICE_SIG_PREFIX: Buffer
 
 export declare const WA_DEFAULT_EPHEMERAL: number
+export declare const STATUS_EXPIRY_SECONDS: number
 
-export declare const NOISE_MODE: "Noise_XX_25519_AESGCM_SHA256\0\0\0\0"
+export declare const NOISE_MODE: 'Noise_XX_25519_AESGCM_SHA256\0\0\0\0'
 
 export declare const DICT_VERSION: 3
 
@@ -24,6 +33,8 @@ export declare const URL_REGEX: RegExp
 
 export declare const WA_CERT_DETAILS: {
     SERIAL: number
+    ISSUER: string
+    PUBLIC_KEY: Buffer
 }
 
 export declare const PROCESSABLE_HISTORY_TYPES: proto.Message.HistorySyncNotification.HistorySyncType[]
@@ -35,15 +46,16 @@ export declare const MEDIA_PATH_MAP: {
 }
 
 export declare const MEDIA_HKDF_KEY_MAPPING: {
-    'audio': string
-    'document': string
-    'gif': string
-    'image': string
-    'ppic': string
-    'product': string
-    'ptt': string
-    'sticker': string
-    'video': string
+    audio: string
+    document: string
+    gif: string
+    image: string
+    ppic: string
+    product: string
+    ptt: string
+    video: string
+    sticker: string
+    'sticker-pack': string
     'thumbnail-document': string
     'thumbnail-image': string
     'thumbnail-video': string
@@ -52,17 +64,18 @@ export declare const MEDIA_HKDF_KEY_MAPPING: {
     'md-app-state': string
     'product-catalog-image': string
     'payment-bg-image': string
-    'ptv': string
+    ptv: string
+    'biz-cover-photo': string
 }
 
 export declare const MEDIA_KEYS: (keyof typeof MEDIA_HKDF_KEY_MAPPING)[]
 
 export declare const MIN_PREKEY_COUNT: 5
-export declare const INITIAL_PREKEY_COUNT: 30
+export declare const INITIAL_PREKEY_COUNT: 812
 
 export declare const DEFAULT_CACHE_TTLS: {
     SIGNAL_STORE: number
     MSG_RETRY: number
     CALL_OFFER: number
     USER_DEVICES: number
-}
+}

package/lib/Signal/libsignal.js

@@ -93,22 +93,6 @@ function makeLibSignalRepository(auth) {
         jidToSignalProtocolAddress(jid) {
             return jidToSignalProtocolAddress(jid).toString()
         },
-        async validateSession(jid) {
-            try {
-                const addr = jidToSignalProtocolAddress(jid)
-                const session = await storage.loadSession(addr.toString())
-                if (!session) {
-                    return { exists: false, reason: 'no session' }
-                }
-                if (!session.haveOpenSession()) {
-                    return { exists: false, reason: 'no open session' }
-                }
-                return { exists: true }
-            }
-            catch (_error) {
-                return { exists: false, reason: 'validation error' }
-            }
-        },
     }
 }
 

package/lib/Socket/messages-recv.js

@@ -27,7 +27,6 @@ const makeMessagesRecvSocket = (config) => {
     maxMsgRetryCount,
     getMessage,
     shouldIgnoreJid,
-    enableAutoSessionRecreation,
   } = config;
   const Neele = messages_send_1.makeMessagesSocket(config);
   const {
@@ -49,7 +48,6 @@ const makeMessagesRecvSocket = (config) => {
     getUSyncDevices,
     createParticipantNodes,
     sendPeerDataOperationMessage,
-    messageRetryManager,
   } = Neele;
 
   /** this mutex ensures that each retryRequest will wait for the previous one to finish */
@@ -245,30 +243,15 @@ const makeMessagesRecvSocket = (config) => {
     const { key: msgKey } = fullMessage;
     const msgId = msgKey.id;
     const key = `${msgId}:${msgKey?.participant}`;
-    let retryCount;
+    let retryCount = msgRetryCache.get(key) || 0;
 
-    if (messageRetryManager) {
-      if (messageRetryManager.hasExceededMaxRetries(msgId)) {
-        logger.debug({ msgId }, "reached retry limit, clearing");
-        messageRetryManager.markRetryFailed(msgId);
-        msgRetryCache.del(key);
-        return;
-      }
-
-      retryCount = messageRetryManager.incrementRetryCount(msgId);
-      msgRetryCache.set(key, retryCount);
-    } else {
-      retryCount = msgRetryCache.get(key) || 0;
-
-      if (retryCount >= maxMsgRetryCount) {
-        logger.debug({ retryCount, msgId }, "reached retry limit, clearing");
-        msgRetryCache.del(key);
-        return;
-      }
-
-      retryCount += 1;
-      msgRetryCache.set(key, retryCount);
+    if (retryCount >= maxMsgRetryCount) {
+      logger.debug({ retryCount, msgId }, "reached retry limit, clearing");
+      msgRetryCache.del(key);
+      return;
     }
+    retryCount += 1;
+    msgRetryCache.set(key, retryCount);
 
     const {
       account,
@@ -276,58 +259,12 @@ const makeMessagesRecvSocket = (config) => {
       signedIdentityKey: identityKey,
     } = authState.creds;
 
-    let shouldRecreateSession = false;
-    let recreateReason = "";
-    const fromJid = node.attrs.from;
-
-    if (
-      enableAutoSessionRecreation &&
-      messageRetryManager &&
-      typeof signalRepository.validateSession === "function"
-    ) {
-      try {
-        const sessionId = signalRepository.jidToSignalProtocolAddress(fromJid);
-        const validation = await signalRepository.validateSession(fromJid);
-        const result = messageRetryManager.shouldRecreateSession(
-          fromJid,
-          retryCount,
-          validation.exists
-        );
-
-        shouldRecreateSession = result.recreate;
-        recreateReason = result.reason;
-
-        if (shouldRecreateSession) {
-          logger.debug(
-            { fromJid, retryCount, reason: recreateReason },
-            "recreating session for retry"
-          );
-          await authState.keys.set({ session: { [sessionId]: null } });
-          forceIncludeKeys = true;
-        }
-      } catch (error) {
-        logger.warn({ error, fromJid }, "failed to check session recreation");
-      }
-    }
-
-    if (retryCount <= 2) {
-      if (messageRetryManager) {
-        messageRetryManager.schedulePhoneRequest(msgId, async () => {
-          try {
-            const requestId = await requestPlaceholderResend(msgKey);
-            logger.debug(
-              `sendRetryRequest: requested placeholder resend (${requestId}) for message ${msgId}`
-            );
-          } catch (error) {
-            logger.warn({ error, msgId }, "failed to send scheduled phone request");
-          }
-        }, retryRequestDelayMs || 3000);
-      } else {
-        const requestId = await requestPlaceholderResend(msgKey);
-        logger.debug(
-          `sendRetryRequest: requested placeholder resend for message ${requestId}`
-        );
-      }
+    if (retryCount === 1) {
+      //request a resend via phone
+      const msgId = await requestPlaceholderResend(msgKey);
+      logger.debug(
+        `sendRetryRequest: requested placeholder resend for message ${msgId}`
+      );
     }
 
     const deviceIdentity = Utils_1.encodeSignedDeviceIdentity(account, true);
@@ -348,7 +285,6 @@ const makeMessagesRecvSocket = (config) => {
               id: node.attrs.id,
               t: node.attrs.t,
               v: "1",
-              error: "0",
             },
           },
           {
@@ -367,7 +303,7 @@ const makeMessagesRecvSocket = (config) => {
         receipt.attrs.participant = node.attrs.participant;
       }
 
-      if (retryCount > 1 || forceIncludeKeys || shouldRecreateSession) {
+      if (retryCount > 1 || forceIncludeKeys) {
         const { update, preKeys } = await Utils_1.getNextPreKeys(authState, 1);
         const [keyId] = Object.keys(preKeys);
         const key = preKeys[+keyId];

package/lib/Types/Signal.d.ts

@@ -62,10 +62,6 @@ export type SignalRepository = {
         ciphertext: Uint8Array
     }>
     injectE2ESession(opts: E2ESessionOpts): Promise<void>
-    validateSession(jid: string): Promise<{
-        exists: boolean
-        reason?: string
-    }>
     jidToSignalProtocolAddress(jid: string): string
 }
 

package/lib/Types/Socket.d.ts

@@ -91,8 +91,6 @@ export type SocketConfig = {
      * entails uploading the jpegThumbnail to WA
      * */
     generateHighQualityLinkPreview: boolean
-    /** Enable automatic Signal session recreation when retries suggest a stale session */
-    enableAutoSessionRecreation: boolean
     /** Enable recent message caching for retry handling */
     enableRecentMessageCache: boolean
     /**

package/package.json

@@ -1,58 +1,35 @@
 {
   "name": "@neelegirl/baileys",
-  "version": "2.1.0",
-  "description": "Neelegirl CJS fork of WhiskeySockets/Baileys for wa-api, with preserved QR flow and NEELE message IDs.",
+  "version": "2.1.3",
+  "description": "CJS-compatible Baileys fork for @neelegirl/wa-api, aligned with WhiskeySockets/Baileys 7.0.0-rc.9 + latest web version updates",
   "keywords": [
     "whatsapp",
-    "baileys",
-    "whiskeysockets",
+    "js-whatsapp",
+    "whatsapp-api",
     "whatsapp-web",
+    "whatsapp-chat",
+    "whatsapp-group",
     "automation",
-    "multi-device",
-    "lid",
-    "wa-api",
-    "neelegirl"
+    "multi-device"
   ],
   "homepage": "https://github.com/neelegirl/baileys",
   "repository": {
     "type": "git",
     "url": "git+https://github.com/neelegirl/baileys.git"
   },
-  "bugs": {
-    "url": "https://github.com/neelegirl/baileys/issues"
-  },
   "license": "MIT",
   "author": "Neele",
   "main": "lib/index.js",
   "types": "lib/index.d.ts",
-  "exports": {
-    ".": {
-      "types": "./lib/index.d.ts",
-      "require": "./lib/index.js",
-      "default": "./lib/index.js"
-    },
-    "./lib": {
-      "types": "./lib/index.d.ts",
-      "require": "./lib/index.js",
-      "default": "./lib/index.js"
-    },
-    "./lib/*": "./lib/*",
-    "./WAProto": {
-      "types": "./WAProto/index.d.ts",
-      "require": "./WAProto/index.js",
-      "default": "./WAProto/index.js"
-    },
-    "./WAProto/*": "./WAProto/*",
-    "./package.json": "./package.json"
-  },
   "files": [
     "lib/**/*",
     "WAProto/**/*",
-    "engine-requirements.js",
-    "README.md",
-    "LICENSE"
+    "engine-requirements.js"
   ],
   "scripts": {
+    "build:all": "tsc && typedoc",
+    "build:docs": "typedoc",
+    "build:tsc": "tsc",
     "preinstall": "node ./engine-requirements.js"
   },
   "dependencies": {
@@ -66,13 +43,13 @@
     "cache-manager": "4.0.1",
     "futoin-hkdf": "^1.5.1",
     "libphonenumber-js": "^1.10.20",
-    "lru-cache": "^11.1.0",
     "music-metadata": "^7.12.3",
     "node-cache": "^5.1.2",
     "pino": "^7.0.0",
     "protobufjs": "^7.2.4",
     "uuid": "^9.0.0",
-    "ws": "^8.13.0"
+    "ws": "^8.13.0",
+    "lru-cache": "^11.1.0"
   },
   "devDependencies": {
     "@adiwajshing/eslint-config": "github:adiwajshing/eslint-config",
@@ -100,7 +77,8 @@
     "jimp": "^0.22.12",
     "link-preview-js": "^3.0.0",
     "qrcode-terminal": "^0.12.0",
-    "sharp": "^0.32.6"
+    "sharp": "^0.32.6",
+    "audio-decode": "^2.1.3"
   },
   "peerDependenciesMeta": {
     "jimp": {
@@ -114,10 +92,13 @@
     },
     "sharp": {
       "optional": true
+    },
+    "audio-decode": {
+      "optional": true
     }
   },
+  "packageManager": "yarn@1.22.19",
   "engines": {
     "node": ">=20.0.0"
-  },
-  "packageManager": "yarn@1.22.19"
+  }
 }