@deathnaitsa/wa-api 2.0.3 → 2.0.4

package/README.md

@@ -16,20 +16,21 @@ Eine minimalistische, stabile WhatsApp Multi-Device API basierend auf Baileys mi
 - **Media Support** (Bilder, Videos, GIF-Playback)
 - **Sticker Support** (Bilder, GIFs, Videos → Sticker mit wa-sticker-formatter)
 - Media Download
+- **Group Management** (Erstellen, Bearbeiten, Teilnehmer verwalten)
+- **Advanced Messaging** (Audio, Document, Location, Contact, Reactions)
+- **Contact Management** (Kontakte abrufen, Profilbilder, Status)
+- **Presence & Typing** (Tipp-Indikatoren, Aufnahme-Status)
 
 ### 🚧 In Entwicklung
-- Group Management
-- Contact Handling
-- Message Reactions
-- Status/Story Features
-- Typing Indicators
-
-### 📋 Geplant
-- Auto-Reconnect Optionen
 - Message Queue System
 - Rate Limiting
 - Webhook Support
 
+### 📋 Geplant
+- Status/Story Features
+- Broadcast Lists
+- Auto-Reconnect Optionen
+
 ## ✨ Features
 
 - 🔄 **Multi-Session Support** - Unbegrenzt viele WhatsApp-Accounts parallel
@@ -47,8 +48,13 @@ Eine minimalistische, stabile WhatsApp Multi-Device API basierend auf Baileys mi
 npm install
 ```
 
+**Unterstützt beide Formate:**
+- ✅ **ES Modules** (import)
+- ✅ **CommonJS** (require)
+
 ## 🚀 Quick Start
 
+### ES Modules (empfohlen)
 ```javascript
 import { startSession, onMessage, sendText } from '@deathnaitsa/wa-api';
 
@@ -63,6 +69,23 @@ onMessage(async (msg) => {
 });
 ```
 
+### CommonJS
+```javascript
+const { startSession, onMessage, sendText } = require('@deathnaitsa/wa-api');
+
+(async () => {
+    await startSession('bot');
+
+    onMessage(async (msg) => {
+        console.log(`📨 ${msg.from}: ${msg.message}`);
+        
+        if (msg.message === '!ping') {
+            await sendText(msg.sessionId, msg.from, 'Pong! 🏓');
+        }
+    });
+})();
+```
+
 ## 📖 API Dokumentation
 
 ### Verfügbare Funktionen
@@ -241,22 +264,194 @@ countReceivedMessage('bot1');
 
 #### ❌ Noch nicht implementiert
 ```javascript
-// Group Management
-// await client.createGroup(sessionId, subject, participants);
-// await client.leaveGroup(sessionId, groupJid);
-// await client.updateGroupSubject(sessionId, groupJid, subject);
-
-// Contact Management  
-// await client.getContacts(sessionId);
-// await client.blockUser(sessionId, jid);
-
 // Status/Stories
 // await client.sendStory(sessionId, content);
-// await client.getStatus(sessionId, jid);
+
+// Broadcast Lists
+// await client.createBroadcastList(sessionId, name, recipients);
+// await client.sendBroadcast(sessionId, broadcastListId, message);
 
 // Advanced Features
-// await client.sendReaction(sessionId, messageKey, emoji);
-// await client.sendPresenceUpdate(sessionId, type);
+// await client.queueMessage(sessionId, to, message, priority);
+// await client.setRateLimit(sessionId, messagesPerMinute);
+```
+
+## 🚀 Neue Features in v2.0
+
+### ✅ Group Management (Implementiert)
+```javascript
+import { 
+    createGroup,
+    getGroupMetadata,
+    updateGroupSubject,
+    updateGroupDescription,
+    addParticipants,
+    removeParticipants,
+    promoteParticipants,
+    demoteParticipants,
+    leaveGroup,
+    getGroupInviteCode,
+    acceptGroupInvite,
+    updateGroupSettings
+} from '@deathnaitsa/wa-api';
+
+// Gruppe erstellen
+const group = await createGroup('bot1', 'Meine Gruppe', [
+    '4915123456789@s.whatsapp.net',
+    '4915987654321@s.whatsapp.net'
+]);
+
+// Gruppen-Metadaten abrufen
+const metadata = await getGroupMetadata('bot1', 'groupId@g.us');
+console.log(metadata.subject, metadata.participants.length);
+
+// Gruppennamen ändern
+await updateGroupSubject('bot1', 'groupId@g.us', 'Neuer Name');
+
+// Beschreibung ändern
+await updateGroupDescription('bot1', 'groupId@g.us', 'Neue Beschreibung');
+
+// Teilnehmer hinzufügen
+await addParticipants('bot1', 'groupId@g.us', ['4915123456789@s.whatsapp.net']);
+
+// Teilnehmer entfernen
+await removeParticipants('bot1', 'groupId@g.us', ['4915123456789@s.whatsapp.net']);
+
+// Zum Admin machen
+await promoteParticipants('bot1', 'groupId@g.us', ['4915123456789@s.whatsapp.net']);
+
+// Admin-Rechte entfernen
+await demoteParticipants('bot1', 'groupId@g.us', ['4915123456789@s.whatsapp.net']);
+
+// Gruppe verlassen
+await leaveGroup('bot1', 'groupId@g.us');
+
+// Einladungslink erhalten
+const code = await getGroupInviteCode('bot1', 'groupId@g.us');
+console.log(`https://chat.whatsapp.com/${code}`);
+
+// Gruppe über Link beitreten
+await acceptGroupInvite('bot1', 'inviteCode');
+
+// Gruppen-Einstellungen (nur Admins können schreiben)
+await updateGroupSettings('bot1', 'groupId@g.us', 'announcement');
+// Alle können schreiben
+await updateGroupSettings('bot1', 'groupId@g.us', 'not_announcement');
+```
+
+### ✅ Advanced Messaging (Implementiert)
+```javascript
+import { 
+    sendAudio,
+    sendDocument,
+    sendLocation,
+    sendContact,
+    sendReaction,
+    deleteMessage
+} from '@deathnaitsa/wa-api';
+
+// Audio senden (Voice Message)
+await sendAudio('bot1', 'nummer@s.whatsapp.net', './audio.mp3', true);
+
+// Audio senden (normaler Audio-File)
+await sendAudio('bot1', 'nummer@s.whatsapp.net', './song.mp3', false);
+
+// Dokument senden
+await sendDocument('bot1', 'nummer@s.whatsapp.net', 
+    './file.pdf', 
+    'Dokument.pdf', 
+    'application/pdf',
+    'Hier ist das Dokument'
+);
+
+// Standort senden
+await sendLocation('bot1', 'nummer@s.whatsapp.net', 52.520008, 13.404954, 'Berlin');
+
+// Kontakt senden
+await sendContact('bot1', 'nummer@s.whatsapp.net', [
+    {
+        displayName: 'Max Mustermann',
+        vcard: 'BEGIN:VCARD\nVERSION:3.0\nFN:Max Mustermann\nTEL:+4915123456789\nEND:VCARD'
+    }
+]);
+
+// Reaktion senden
+await sendReaction('bot1', 'chatId@s.whatsapp.net', 'messageId', '👍');
+
+// Reaktion entfernen
+await sendReaction('bot1', 'chatId@s.whatsapp.net', 'messageId', '');
+
+// Nachricht löschen
+await deleteMessage('bot1', messageKey);
+```
+
+### ✅ Contact Management (Implementiert)
+```javascript
+import { 
+    getProfilePicture,
+    getContact,
+    checkNumbersOnWhatsApp,
+    blockContact,
+    unblockContact,
+    getBusinessProfile,
+    getStatus
+} from '@deathnaitsa/wa-api';
+
+// Profilbild URL abrufen
+const url = await getProfilePicture('bot1', '4915123456789@s.whatsapp.net');
+
+// Kontaktinfo
+const contact = await getContact('bot1', '4915123456789@s.whatsapp.net');
+
+// Nummern auf WhatsApp prüfen
+const results = await checkNumbersOnWhatsApp('bot1', ['4915123456789', '4915987654321']);
+
+// Kontakt blockieren
+await blockContact('bot1', '4915123456789@s.whatsapp.net');
+
+// Kontakt entblocken
+await unblockContact('bot1', '4915123456789@s.whatsapp.net');
+
+// Business-Profil abrufen
+const business = await getBusinessProfile('bot1', 'businessNumber@s.whatsapp.net');
+
+// Status/About abrufen
+const status = await getStatus('bot1', '4915123456789@s.whatsapp.net');
+console.log(status?.status);
+```
+
+### ✅ Presence & Typing (Implementiert)
+```javascript
+import { 
+    sendTyping,
+    sendRecording,
+    updateProfileStatus,
+    updateProfileName,
+    setProfilePicture,
+    markChatRead
+} from '@deathnaitsa/wa-api';
+
+// Tipp-Indikator anzeigen
+await sendTyping('bot1', 'chatId@s.whatsapp.net', true);
+// Stoppen
+await sendTyping('bot1', 'chatId@s.whatsapp.net', false);
+
+// Aufnahme-Indikator anzeigen
+await sendRecording('bot1', 'chatId@s.whatsapp.net', true);
+// Stoppen
+await sendRecording('bot1', 'chatId@s.whatsapp.net', false);
+
+// Eigenen Status ändern
+await updateProfileStatus('bot1', 'Verfügbar 🟢');
+
+// Eigenen Namen ändern
+await updateProfileName('bot1', 'Neuer Name');
+
+// Profilbild setzen
+await setProfilePicture('bot1', './profile.jpg');
+
+// Chat als gelesen markieren
+await markChatRead('bot1', 'chatId@s.whatsapp.net', [messageKey1, messageKey2]);
 ```
 
 ## 🎮 Bot-Beispiel
@@ -264,7 +459,12 @@ countReceivedMessage('bot1');
 Siehe `socket.js` für ein vollständiges Bot-Beispiel mit:
 - Chat-Assignment System (keine Doppel-Antworten bei mehreren Sessions)
 - Command-Lock System (keine Race-Conditions)
-- Deutsche Befehle (!ping, !stats, !gesamtstats, !neustart, etc.)
+- Deutsche Befehle
+  - **Basis**: !ping, !info, !liste, !stats, !gesamtstats
+  - **Gruppen**: !gruppeninfo, !gruppenlink, !gruppenname, !gruppenbio, !hinzufügen, !entfernen, !promoten, !demoten
+  - **Nachrichten**: !ort, !reaktion, !tippen, !aufnehmen
+  - **Profil & Kontakt**: !profilbild, !status, !kontakt, !meinestatus
+  - **Session**: !neustart, !pause, !fortsetzen, !stopp, !löschen, !start, !zuweisen, !zuweisungen
 - Session-Control Commands
 - Latenz-Messung
 
@@ -368,28 +568,31 @@ wa_credentials/             # Session-Daten
 ## 🛠️ Bekannte Einschränkungen & Design-Entscheidungen
 
 ### Nicht implementiert (Stand: Dezember 2024)
-- ❌ Audio/Voice Messages
-- ❌ Document/PDF Upload
-- ❌ Group Management (Create/Leave/Update Groups)
-- ❌ Contact Management (Block/Unblock)
-- ❌ Status/Story Features
-- ❌ Message Reactions
-- ❌ Typing Indicators
-- ❌ Presence Updates (Online/Offline Status)
+- ❌ Status/Story Features (Upload/View/Delete Stories)
+- ❌ Broadcast Lists
 - ❌ Auto-Reconnect (bewusst einfach gehalten)
 - ❌ Message Queue/Rate Limiting
 - ❌ Webhook Support
+- ❌ Poll Messages
+- ❌ Chat Archive/Mute/Pin Features
+
+### Neu implementiert in v2.0 ✅
+- ✅ Group Management (Complete)
+- ✅ Advanced Messaging (Audio, Document, Location, Contact, Reactions)
+- ✅ Contact Management (Profile Pictures, Status, Block/Unblock)
+- ✅ Presence & Typing Indicators
+- ✅ Profile Updates (Status, Name, Picture)
 
 ### Design-Philosophie
 - **Einfachheit über Features** - Lieber stabil als feature-reich
 - **Kein Auto-Reconnect** - Manuelles Management für mehr Kontrolle
-- **Minimale Dependencies** - Nur Baileys, Pino, QRCode-Terminal
+- **Minimale Dependencies** - Nur Baileys, Pino, QRCode-Terminal, wa-sticker-formatter
 - **Event-Driven** - Keine Polling, nur Events
 - **Map-basiert** - Schnelle Session-Lookups
 
 ### Performance-Charakteristiken
 - ✅ Sehr schnelle Session-Switches
-- ✅ Geringer Memory-Footprint (~50MB pro Session)
+- ✅ Geringer Memory-Footprint (~50-80MB pro Session)
 - ✅ Keine Blocking Operations
 - ⚠️ Kein Built-in Rate Limiting (muss selbst implementiert werden)