@neelegirl/wa-api 1.6.0 → 1.6.3

package/readme.md

@@ -1,676 +1,88 @@
-<div align="center">
+# @neelegirl/wa-api
 
-# @neelegirl/wa-api
+![Neelegirl wa-api](https://files.catbox.moe/6np1ii.JPG)
 
-**Mehrfach-Sessions, QR-Login, Pairing-Code und vereinfachtes Messaging**  
-**aufbauend auf dem gepflegten `@neelegirl/baileys`-Fork.**
+High-level multi-session API wrapper for WhatsApp automation, built on `@neelegirl/baileys`.
 
-[![npm](https://img.shields.io/npm/v/@neelegirl/wa-api?style=for-the-badge&color=ff69b4&logo=npm)](https://www.npmjs.com/package/@neelegirl/wa-api)
-[![Dependency](https://img.shields.io/badge/@neelegirl%2Fbaileys-2.1.x-6f42c1?style=for-the-badge)](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)
+## Status
 
-<p align="center">
-  <img src="https://files.catbox.moe/6np1ii.JPG" width="920" alt="Neelegirl wa-api Hero" />
-</p>
+- Package version: `1.6.0`
+- Runtime: Node.js `>=20`
+- Core dependency: `@neelegirl/baileys` `^2.1.0`
 
-</div>
+## Features
 
-## Überblick
+- Multi-session start/stop with filesystem credentials
+- QR flow via callback
+- Pairing-code flow via callback
+- Auto reconnect retries (up to 10 attempts)
+- Message upsert/update callbacks with helper media savers
+- `sendMessage`, `sendStatusMentions`, and low-level `relayMessage`
 
-`@neelegirl/wa-api` ist die bequemere Multi-Session-Schicht für Projekte, die nicht direkt auf der vollständigen Baileys-Oberfläche arbeiten wollen. Das Paket nutzt `@neelegirl/baileys` als eigentliche WhatsApp-Web-Basis und stellt darauf ein kompakteres API-Set für Sessions, Event-Hooks und das Senden von Nachrichten bereit.
-
-## Update-Stand
-
-- abgestimmt auf `@neelegirl/baileys@2.1.x`
-- Dokumentation auf den realen Dist-Exports bereinigt
-- Bild/Branding modernisiert
-- Hinweise ergänzt, was lokal funktioniert und was bewusst nicht behauptet wird
-
-**Wichtig:** `wa-api` baut auf dem aktualisierten Neelegirl-Baileys-Fork auf. Es ist keine eigenständige Neuimplementierung von WhiskeySockets/Baileys, sondern eine Wrapper-Schicht darüber.
-
-## Installation
+## Install
 
 ```bash
-npm install @neelegirl/wa-api @neelegirl/baileys
+npm install @neelegirl/wa-api
 ```
 
-oder:
-
-```bash
-yarn add @neelegirl/wa-api @neelegirl/baileys
-```
-
-## Voraussetzungen
-
-- Node.js `20+`
-- WhatsApp Multi-Device-Konto
-- persistenter Speicherort für Sessiondaten
-
-## Schnellstart
+## Quick Start
 
 ```js
 const wa = require('@neelegirl/wa-api')
 
-async function bootstrap() {
-  await wa.startSession('main-session', {
-    printQR: true
-  })
-
-  console.log('Session gestartet')
-}
-
-wa.onConnected((sessionId) => {
-  console.log(`[${sessionId}] verbunden`)
+wa.onQRUpdated(({ sessionId, qr }) => {
+  console.log('QR for session:', sessionId)
+  console.log(qr)
 })
 
-wa.onDisconnected((sessionId) => {
-  console.log(`[${sessionId}] getrennt`)
+wa.onConnected((sessionId) => {
+  console.log('connected:', sessionId)
 })
 
-wa.onMessageReceived(async ({ sessionId, key, message }) => {
-  const jid = key.remoteJid
-  const text = message?.conversation || message?.extendedTextMessage?.text || ''
+wa.onMessageReceived(async (msg) => {
+  const sessionId = msg.sessionId
+  const jid = msg.key?.remoteJid
+  const text = msg.message?.conversation || msg.message?.extendedTextMessage?.text || ''
 
-  if (text.toLowerCase() === 'ping') {
+  if (jid && text.toLowerCase() === 'ping') {
     await wa.sendMessage(sessionId, jid, { text: 'pong' })
   }
 })
 
-bootstrap().catch(console.error)
-```
-
-## Session-API
-
-### Starten
-
-```js
-await wa.startSession('session-a', { printQR: true })
-
-await wa.startSessionWithPairingCode('session-b', {
-  phoneNumber: '491234567890'
-})
-```
-
-### Verwalten
-
-```js
-const all = wa.getAllSession()
-const one = wa.getSession('session-a')
-
-await wa.deleteSession('session-a')
-await wa.loadSessionsFromStorage()
-```
-
-## Messaging
-
-Die Dist-API bietet einen universellen `sendMessage`-Wrapper über die aktive Session:
-
-```js
-await wa.sendMessage('session-a', '491234567890@s.whatsapp.net', {
-  text: 'Hallo aus wa-api'
-})
-```
-
-Zusätzlich gibt es `relayMessage`, wenn du gezielt weiterleiten bzw. rohe Baileys-Pfade der Session nutzen willst.
-
-## Event-Hooks
-
-Vorhandene Event-Helper im Dist-Build:
-
-- `onMessageReceived(listener)`
-- `onQRUpdated(listener)`
-- `onConnected(listener)`
-- `onDisconnected(listener)`
-- `onConnecting(listener)`
-- `onMessageUpdate(listener)`
-- `onPairingCode(listener)`
-
-## Konsole beim Start
-
-Diese Zustände sind beim echten Start normal:
-
-- QR wird im Terminal angezeigt, wenn noch keine Session gespeichert ist
-- Pairing-Code wird ausgegeben, wenn du die Pairing-Variante nutzt
-- `connected`/`disconnected` wechseln bei Reconnects sauber
-- nach `creds.update` bleibt die Session für Folgestarts erhalten
-
-## Was wirklich funktioniert
-
-- mehrere parallele Sessions
-- Sessionstart per QR
-- Sessionstart per Pairing-Code
-- Nachrichtenversand über aktive Sessions
-- Sessionzugriff über `getSession()` für tiefergehende eigene Arbeit
-- Event-Listener für eingehende Nachrichten und Verbindungsstatus
-
-## Was bewusst **nicht** behauptet wird
-
-- kein separater, vollständig dokumentierter Source-Build im Paket selbst
-- kein vollständiger Ersatz für das volle Baileys-API-Surface
-- kein Anspruch auf vollständigen Upstream-Gleichstand in jeder internen Implementierungsdetailschicht
-
-## Empfehlung für produktive Nutzung
-
-- `@neelegirl/baileys` und `@neelegirl/wa-api` immer gemeinsam aktualisieren
-- Sessionordner außerhalb flüchtiger Deploy-Ordner speichern
-- bei Multi-Session-Projekten eigene Health-/Reconnect-Logs ergänzen
-
-## Lizenz
-
-`wa-api` bleibt die einfache Bedienebene. Die technische WhatsApp-Web-Basis stammt aus `@neelegirl/baileys`, das selektiv auf aktuellem WhiskeySockets/Baileys-Wissen aufsetzt.
-  image: { url: './bild.jpg' },
-  caption: 'Schönes Bild! ✨'
-});
-```
-
-#### 3. **Video**
-
-```javascript
-await onimai.sendMessage('session1', '491234567890@s.whatsapp.net', {
-  video: { url: './video.mp4' },
-  caption: 'Mein Video! 🎬'
-});
-```
-
-#### 4. **GIF (als Video)**
-
-```javascript
-await onimai.sendMessage('session1', '491234567890@s.whatsapp.net', {
-  video: { url: './animation.mp4' },
-  gifPlayback: true, // Wichtig für GIFs!
-  caption: 'Kawaii GIF! ✨'
-});
-```
-
-#### 5. **Audio/Sprachnachricht**
-
-```javascript
-const fs = require('fs');
-
-await onimai.sendMessage('session1', '491234567890@s.whatsapp.net', {
-  audio: fs.createReadStream('./audio.ogg'),
-  mimetype: 'audio/ogg',
-  ptt: true // Push-to-Talk (Sprachnachricht)
-});
-```
-
-#### 6. **Dokument**
-
-```javascript
-await onimai.sendMessage('session1', '491234567890@s.whatsapp.net', {
-  document: { 
-    url: './dokument.pdf',
-    filename: 'Wichtiges Dokument.pdf'
-  },
-  mimetype: 'application/pdf'
-});
-```
-
-#### 7. **Umfrage (Poll)**
-
-```javascript
-await onimai.sendMessage('session1', '491234567890@s.whatsapp.net', {
-  poll: {
-    name: 'Was ist deine Lieblingsfarbe?',
-    values: ['Rot', 'Blau', 'Grün', 'Gelb'],
-    selectableCount: 1 // Anzahl der auswählbaren Optionen
-  }
-});
-```
-
-#### 8. **Reaktion**
-
-```javascript
-await onimai.sendMessage('session1', '491234567890@s.whatsapp.net', {
-  react: {
-    text: '❤️', // Emoji
-    key: message.key // Key der Nachricht
-  }
-});
-
-// Reaktion entfernen
-await onimai.sendMessage('session1', '491234567890@s.whatsapp.net', {
-  react: {
-    text: '', // Leerer String entfernt Reaktion
-    key: message.key
-  }
-});
-```
-
-#### 9. **Nachricht löschen**
-
-```javascript
-await onimai.sendMessage('session1', '491234567890@s.whatsapp.net', {
-  delete: message.key // Für alle löschen
-});
-```
-
-#### 10. **Nachricht anpinnen**
-
-```javascript
-await onimai.sendMessage('session1', '491234567890@s.whatsapp.net', {
-  pin: {
-    type: 1, // 0 = entfernen, 1 = anpinnen
-    time: 86400, // Sekunden (24h = 86400)
-    key: message.key
-  }
-});
-```
-
-#### 11. **Kontakt teilen**
-
-```javascript
-const vcard = `BEGIN:VCARD
-VERSION:3.0
-FN:Max Mustermann
-TEL;type=CELL;type=VOICE;waid=491234567890:+49 123 4567890
-END:VCARD`;
-
-await onimai.sendMessage('session1', '491234567890@s.whatsapp.net', {
-  contacts: {
-    displayName: 'Max Mustermann',
-    contacts: [{ vcard }]
-  }
-});
-```
-
-#### 12. **Standort**
-
-```javascript
-await onimai.sendMessage('session1', '491234567890@s.whatsapp.net', {
-  location: {
-    degreesLatitude: 52.520008,
-    degreesLongitude: 13.404954
-  }
-});
-```
-
-#### 13. **Nachricht weiterleiten**
-
-```javascript
-await onimai.sendMessage('session1', '491234567890@s.whatsapp.net', {
-  forward: originalMessage // Originale Nachricht
-});
-```
-
-#### 14. **Mit Quote (Antwort)**
-
-```javascript
-await onimai.sendMessage(
-  'session1', 
-  '491234567890@s.whatsapp.net', 
-  {
-    text: 'Das ist eine Antwort!'
-  },
-  {
-    quoted: originalMessage // Originale Nachricht
-  }
-);
-```
-
-#### 15. **Mit Erwähnung**
-
-```javascript
-await onimai.sendMessage('session1', '491234567890@s.whatsapp.net', {
-  text: '@491111111111 Hallo!',
-  mentions: ['491111111111@s.whatsapp.net']
-});
-```
-
----
-
-## 🎧 Event Listener
-
-### 📥 **Nachrichten empfangen**
-
-```javascript
-onimai.onMessageReceived(async (msg) => {
-  const { 
-    sessionId,      // Session-ID
-    key,            // Message-Key (id, remoteJid, fromMe)
-    message,        // Nachrichteninhalt
-    messageTimestamp // Zeitstempel
-  } = msg;
-  
-  const from = key.remoteJid;
-  const text = message?.conversation || message?.extendedTextMessage?.text || '';
-  
-  console.log(`📥 Neue Nachricht von ${from}: ${text}`);
-  
-  // Medien speichern (wenn vorhanden)
-  if (message?.imageMessage) {
-    await msg.saveImage('./downloads/');
-  }
-  if (message?.videoMessage) {
-    await msg.saveVideo('./downloads/');
-  }
-  if (message?.documentMessage) {
-    await msg.saveDocument('./downloads/');
-  }
-});
+wa.startSession('main', { printQR: true }).catch(console.error)
 ```
 
-### 🔄 **Nachrichten-Updates**
-
-```javascript
-onimai.onMessageUpdate((sessionId, data) => {
-  const { 
-    update,           // Update-Objekt
-    messageStatus     // Lesbarer Status
-  } = data;
-  
-  console.log(`📊 Status Update: ${messageStatus}`);
-  // Mögliche Status: 'sent', 'delivered', 'read', 'failed'
-});
-```
-
-### 🔌 **Verbindungs-Events**
-
-```javascript
-// Verbunden
-onimai.onConnected((sessionId) => {
-  console.log(`✅ Session ${sessionId} ist jetzt verbunden!`);
-});
-
-// Verbindung wird hergestellt
-onimai.onConnecting((sessionId) => {
-  console.log(`🔄 Session ${sessionId} verbindet...`);
-});
-
-// Getrennt
-onimai.onDisconnected((sessionId) => {
-  console.log(`❌ Session ${sessionId} wurde getrennt`);
-});
-```
-
-### 📱 **QR-Code Updates**
-
-```javascript
-onimai.onQRUpdated((info) => {
-  const { sessionId, qr } = info;
-  console.log(`📱 Neuer QR-Code für Session ${sessionId}:`);
-  console.log(qr);
-  
-  // Du kannst den QR-Code auch in eine Datei speichern oder auf einer Webseite anzeigen
-});
-```
-
-### 🔑 **Pairing-Code**
-
-```javascript
-onimai.onPairingCode((sessionId, code) => {
-  console.log(`🔑 Pairing-Code für Session ${sessionId}: ${code}`);
-});
-```
-
----
-
-## 🔧 Erweiterte Funktionen
-
-### 💾 **Medien speichern**
-
-```javascript
-onimai.onMessageReceived(async (msg) => {
-  // Bild speichern
-  if (msg.message?.imageMessage) {
-    const path = await msg.saveImage('./downloads/');
-    console.log('✅ Bild gespeichert:', path);
-  }
-  
-  // Video speichern
-  if (msg.message?.videoMessage) {
-    const path = await msg.saveVideo('./downloads/');
-    console.log('✅ Video gespeichert:', path);
-  }
-  
-  // Dokument speichern
-  if (msg.message?.documentMessage) {
-    const path = await msg.saveDocument('./downloads/');
-    console.log('✅ Dokument gespeichert:', path);
-  }
-});
-```
-
-### 🔄 **Multi-Session Beispiel**
-
-```javascript
-// Mehrere Sessions gleichzeitig starten
-const sessions = ['session1', 'session2', 'session3'];
-
-for (const sessionId of sessions) {
-  await onimai.startSession(sessionId, { printQR: true });
-}
-
-// Nachricht an alle Sessions senden
-const message = { text: 'Broadcast-Nachricht! 📢' };
-const recipients = ['491234567890@s.whatsapp.net'];
-
-for (const sessionId of sessions) {
-  for (const recipient of recipients) {
-    await onimai.sendMessage(sessionId, recipient, message);
-  }
-}
-```
-
-### 🚀 **Smart Queue Integration**
-
-```javascript
-// Nutze die Smart Message Queue von Baileys für zuverlässiges Bulk-Messaging
-const baileys = require('@neelegirl/baileys');
-const session = onimai.getSession('session1');
-
-if (session) {
-  const queue = baileys.createSmartMessageQueue(session, {
-    maxRetries: 5,
-    retryDelay: 2000,
-    maxConcurrent: 3
-  });
-
-  // Viele Nachrichten zur Queue hinzufügen
-  const recipients = ['491234567890@s.whatsapp.net', '499876543210@s.whatsapp.net'];
-  
-  for (const jid of recipients) {
-    await queue.add({
-      jid,
-      message: { text: 'Wichtige Ankündigung! 📢' },
-      priority: 'high'
-    });
-  }
-}
-```
-
----
-
-## 📚 Vollständige API-Referenz
-
-### 🔌 **Session-Funktionen**
-
-| Funktion | Beschreibung | Beispiel |
-|----------|-------------|----------|
-| `startSession(id, options)` | Startet eine Session mit QR-Code | `await onimai.startSession('session1')` |
-| `startSessionWithPairingCode(id, options)` | Startet mit Pairing-Code | `await onimai.startSessionWithPairingCode('session2', { phoneNumber: '491234567890' })` |
-| `getAllSession()` | Gibt alle aktiven Sessions zurück | `const sessions = onimai.getAllSession()` |
-| `getSession(id)` | Gibt eine spezifische Session zurück | `const session = onimai.getSession('session1')` |
-| `deleteSession(id)` | Löscht eine Session | `await onimai.deleteSession('session1')` |
-| `loadSessionsFromStorage()` | Lädt alle Sessions aus Storage | `const loaded = await onimai.loadSessionsFromStorage()` |
-
-### 💬 **Nachrichten-Funktionen**
-
-| Funktion | Beschreibung |
-|----------|-------------|
-| `sendMessage(sessionId, jid, content, options)` | Sendet eine Nachricht |
-
-**Content-Typen:**
-- `{ text: string }` - Text
-- `{ image: { url: string }, caption?: string }` - Bild
-- `{ video: { url: string }, caption?: string, gifPlayback?: boolean }` - Video/GIF
-- `{ audio: Stream, mimetype: string, ptt?: boolean }` - Audio
-- `{ document: { url: string, filename?: string }, mimetype: string }` - Dokument
-- `{ poll: { name: string, values: string[], selectableCount: number } }` - Umfrage
-- `{ react: { text: string, key: MessageKey } }` - Reaktion
-- `{ delete: MessageKey }` - Löschen
-- `{ pin: { type: number, time: number, key: MessageKey } }` - Anpinnen
-- `{ contacts: { displayName: string, contacts: Array } }` - Kontakt
-- `{ location: { degreesLatitude: number, degreesLongitude: number } }` - Standort
-- `{ forward: Message }` - Weiterleiten
-
-### 🎧 **Event-Listener**
-
-| Event | Beschreibung | Callback-Parameter |
-|-------|-------------|-------------------|
-| `onMessageReceived` | Neue Nachricht empfangen | `(msg: Message)` |
-| `onMessageUpdate` | Nachrichten-Update | `(sessionId: string, data: UpdateData)` |
-| `onConnected` | Session verbunden | `(sessionId: string)` |
-| `onConnecting` | Session verbindet | `(sessionId: string)` |
-| `onDisconnected` | Session getrennt | `(sessionId: string)` |
-| `onQRUpdated` | QR-Code aktualisiert | `(info: { sessionId: string, qr: string })` |
-| `onPairingCode` | Pairing-Code erhalten | `(sessionId: string, code: string)` |
-
----
-
-## ⚠️ Wichtige Hinweise
-
-### 🚨 **Disclaimer**
-
-> ⚠️ **WICHTIG**: Diese Library funktioniert **ausschließlich** mit **@neelegirl/baileys**!
-> 
-> - ✖️ **Kein Spam** oder Massennachrichten
-> - ✖️ **Kein Missbrauch** für unethische Zwecke
-> - ✖️ **Keine Stalkerware** oder automatisierte Überwachung
-> - ✔️ **Verantwortungsvoller Gebrauch** wird erwartet
-
-### 🔒 **Sicherheit**
-
-- **Nie** deine Session-Daten öffentlich teilen
-- **Immer** `.gitignore` für Credentials-Ordner verwenden
-- **Regelmäßig** Backups erstellen
-- **Sichere** Passwörter für deine Server verwenden
-
-### 💡 **Best Practices**
-
-1. **Error-Handling**: Immer try-catch für wichtige Operationen
-2. **Rate-Limiting**: Nutze Smart Message Queue für Bulk-Messaging
-3. **Session-Management**: Sessions ordentlich verwalten und löschen wenn nicht mehr benötigt
-4. **Updates**: Regelmäßig auf Updates prüfen (automatisch aktiviert, nur einmal angezeigt)
-
----
-
-## 🆕 Was ist neu in Version 1.5.1?
-
-### ✨ **Neue Features & Glow-Up**
-
-- 📖 **README Glow-Up** – Version 1.5.1, Badges & Changelog
-- ✅ **Kompatibilität** mit **@neelegirl/baileys 2.0.4** & **Baileys API 1.7.2**
-- 🔔 **Update-Check** – Liest Version von **npm-Registry** (registry.npmjs.org), nur 1× pro Prozess
-- 📦 **Abhängigkeit** auf `@neelegirl/baileys@^2.0.4` (empfohlen 2.0.4)
-- 🚀 **Smart Queue Ready** · QR · Pairing · Auto-Reconnect
-- 💎 **Multi-Device** & Session-Management optimiert
-
-### 🔄 **Verbesserungen**
-
-- Semver-Vergleich für „Update verfügbar“ nur bei wirklich neuerer Version
-- Verbesserte Fehlerbehandlung & Stabilität
-- Schnellerer Verbindungsaufbau · Bessere LID-Unterstützung
-
----
-
-## 💬 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)
-[![Docs](https://img.shields.io/badge/Docs-wa--api.org-pink?style=for-the-badge)](https://wa-api.org)
-
-**⭐ Wenn dir dieses Projekt gefällt, gib ihm ein Star auf GitHub! ⭐**
-
-</div>
-
----
-
-## 📝 Changelog
-
-### Version 1.5.1 (Aktuell) 🎉
-
-- 📖 **README Glow-Up** – Version 1.5.1, Baileys 2.0.5 Badges
-- 🔔 Update-Check von **npm-Registry** (registry.npmjs.org), nur 1× pro Prozess
-- ✨ Kompatibilität mit **@neelegirl/baileys 2.0.4** & **Baileys API 1.7.2**
-- 📦 Abhängigkeit `@neelegirl/baileys@^2.0.4`
-
-### Version 1.3.2
-
-- 📖 **README Glow-Up** – Version 1.3.2, Baileys 2.0.2 Badges
-- 🔔 Update-Check von **npm-Registry** (registry.npmjs.org), nur 1× pro Prozess
-- ✨ Kompatibilität mit **@neelegirl/baileys 2.0.2** & **Baileys API 1.7.2**
-- 📦 Abhängigkeit `@neelegirl/baileys@^2.0.0`
-- 🚀 Smart Queue Ready · Semver-Vergleich für Update-Hinweis
-- 💎 Multi-Device & Session-Management optimiert
-- 🚀 Smart Queue Ready · Semver-Vergleich für Update-Hinweis
-- 💎 Multi-Device & Session-Management optimiert
-
-### Version 1.3.1
-
-- 📖 README Glow-Up · Changelog · Baileys 2.0.2
-
-### Version 1.2.5
-
-- 📖 README Glow-Up · Changelog
-
-### Version 1.2.4
-
-- 📖 README Glow-Up · Changelog
-
-### Version 1.2.3
-
-- 📖 README Glow-Up · Changelog
-
-### Version 1.2.2
-
-- 📖 README Glow-Up · Changelog ergänzt
-
-### Version 1.2.1
-
-- 📖 README Glow-Up · Update-Check von npm-Registry · Baileys 2.0.2 Badges
-
-### Version 1.2.0
-
-- 📖 README Glow-Up · Baileys 2.0.0 Badges
-- ✨ Kompatibilität mit @neelegirl/baileys 2.0.0 & Baileys API 1.7.2
-- 🚀 Smart Queue Ready · Auto-Update-Check (1x pro Prozess)
-
-### Version 1.1.1
-
-- 📖 README Glow-Up · Kompatibilität mit @neelegirl/baileys 1.7.1
-- 🚀 Smart Queue Ready, Auto-Update-Check
-
-### Version 1.1.0
-
-- ✨ Kompatibilität mit @neelegirl/baileys 1.7.0
-- 🚀 Smart Queue Ready, Auto-Update-Check
-
-### Version 1.0.10
-
-- ✨ Automatische Update-Prüfung hinzugefügt
-- 🎨 Verbesserte QR-Code-Anzeige
-- 🔄 Kompatibilität mit @neelegirl/baileys 1.6.6
-- 🚀 Verbesserte Stabilität
-- 🐛 Bugfixes für Session-Management
-
-### Version 1.0.9
+## API Surface
 
-- 🔔 Update-Benachrichtigung hinzugefügt
-- 💎 Optimierungen für Multi-Device
+- Session lifecycle
+  - `startSession(sessionId, options)`
+  - `startSessionWithPairingCode(sessionId, { phoneNumber }, pairingCode?)`
+  - `deleteSession(sessionId)`
+  - `getSession(sessionId)`
+  - `getAllSession()`
+  - `loadSessionsFromStorage()`
 
----
+- Messaging
+  - `sendMessage(sessionId, jidOrPhone, content, options?)`
+  - `sendStatusMentions(sessionId, content, options?)`
+  - `relayMessage(sessionId, jidOrPhone, content, options?)`
 
-<div align="center">
+- Events
+  - `onMessageReceived(listener)`
+  - `onMessageUpdate(listener)`
+  - `onQRUpdated(listener)`
+  - `onConnected(listener)`
+  - `onConnecting(listener)`
+  - `onDisconnected(listener)`
+  - `onPairingCode(listener)`
 
-### ✨ *Stay kawaii, stay connected – Onimai forever!* ✨
+## Operational Notes
 
-**🌸 Made with Love & Glitter 🌸**
+- Credentials are stored under `wa_credentials/<session>_credentials`.
+- The package performs a lightweight npm update check once per process start.
+- No dedicated Word2Web module is shipped in this package.
 
-[⬆️ Nach oben](#-neelegirlwa-api)
+## Legal
 
-</div>
+This project is not affiliated with WhatsApp.
+Use responsibly and comply with applicable laws and platform terms.