waengine 1.5.0 → 1.7.3

package/FEATURES.md

@@ -29,6 +29,7 @@
 21. [🎨 Sticker Creation](#-sticker-creation)
 22. [🎤 Visual Recording](#-visual-recording)
 23. [🔌 Plugin System](#-plugin-system) **NEU!**
+24. [🚀 Advanced Features](#-advanced-features) **NEU in v1.7.3!**
 
 ---
 
@@ -2208,7 +2209,536 @@ plugins/
 
 ---
 
-## 🔥 Feature Count: **245+ Funktionen!**
+## � Advanced Features
+
+### **400+ Erweiterte WhatsApp-Funktionen in 11 Kategorien!**
+
+WAEngine v1.7.3 bietet die umfangreichste Sammlung von Advanced WhatsApp Features:
+
+- 🎵 **Advanced Media Features** - Voice, Video, GIFs, Thumbnails
+- 💬 **Advanced Message Features** - Forward, Edit, Pin, Star, Quote
+- 🎨 **Rich Content Features** - Buttons, Lists, Templates, Carousels  
+- 👥 **Advanced Group Features** - Settings, Descriptions, Invite Links
+- 🔒 **Privacy & Security Features** - Block/Unblock, Privacy Settings
+- 📊 **Analytics & Monitoring** - Online Status, Delivery Status, Archive
+- 📢 **Advanced Status Features** - Status Updates, Views
+- 💼 **Business Features** - Business Profile, Products, Payments
+- ⚙️ **System Features** - Backup, Restore, Export, Sync
+- 🖼️ **Profile Picture Features** - Get/Send Profile Pictures
+- 🤖 **EasyBot Integration** - Alle Features in EasyBot verfügbar
+
+### **🎵 Advanced Media Features**
+
+#### **Voice Messages**
+```javascript
+// Standard Client
+await msg.sendVoiceMessage('./audio.ogg');
+await msg.sendVoiceToMentioned('./audio.ogg'); // An alle erwähnten User
+
+// EasyBot
+bot.when('voice test').voice('./audio.ogg').done();
+```
+
+#### **Video Messages**  
+```javascript
+// Standard Client
+await msg.sendVideoMessage('./video.mp4');
+await msg.sendVideoMessageToMentioned('./video.mp4');
+
+// EasyBot
+bot.when('video test').videoMessage('./video.mp4').done();
+```
+
+#### **GIF Support**
+```javascript
+// Standard Client
+await msg.sendGif('./animation.gif', 'Coole Animation!');
+await msg.sendGifToMentioned('./animation.gif', 'Für alle!');
+
+// EasyBot
+bot.when('gif test').gif('./animation.gif', 'Test GIF').done();
+```
+
+#### **Thumbnails**
+```javascript
+await msg.sendVideoWithThumbnail('./video.mp4', './thumb.jpg', 'Video mit Thumbnail');
+await msg.sendImageWithThumbnail('./image.jpg', './thumb.jpg', 'Bild mit Thumbnail');
+```
+
+### **💬 Advanced Message Features**
+
+#### **Forward Messages**
+```javascript
+// Standard Client
+await msg.forward('target@s.whatsapp.net'); // An spezifischen Chat
+await msg.forwardToMentioned(); // An alle erwähnten User
+await msg.forwardToSender(); // Zurück an Sender
+
+// EasyBot
+bot.when('forward test').forward().done(); // Automatisch an Mentions oder Sender
+```
+
+#### **Edit Messages**
+```javascript
+await msg.edit('Neue Nachricht');
+```
+
+#### **Pin/Unpin Messages (Nur Gruppen)**
+```javascript
+// Standard Client
+await msg.pin();
+await msg.unpin();
+
+// EasyBot
+bot.when('pin test').pin().done();
+```
+
+#### **Star/Unstar Messages**
+```javascript
+// Standard Client
+await msg.star();
+await msg.unstar();
+
+// EasyBot  
+bot.when('star test').star().done();
+```
+
+#### **Quote Messages**
+```javascript
+// Standard Client
+await msg.quote('Das ist ein Zitat!');
+
+// EasyBot
+bot.when('quote test').quote('Zitat Text').done();
+```
+
+#### **Reply to Specific Messages**
+```javascript
+await msg.replyTo('message-id', 'Antwort auf spezifische Nachricht');
+await msg.replyToSender('Antwort an Sender');
+```
+
+### **🎨 Rich Content Features**
+
+#### **Button Messages**
+```javascript
+// Standard Client
+const buttons = [
+    { id: 'btn1', text: '✅ Ja' },
+    { id: 'btn2', text: '❌ Nein' },
+    { id: 'btn3', text: '🤔 Vielleicht' }
+];
+await msg.sendButtons('Wähle eine Option:', buttons, 'Footer Text');
+
+// EasyBot
+bot.when('button test')
+   .buttons('Wähle:', [
+       { id: 'opt1', text: 'Option 1' },
+       { id: 'opt2', text: 'Option 2' }
+   ], 'Footer')
+   .done();
+```
+
+#### **List Messages**
+```javascript
+// Standard Client
+const sections = [
+    {
+        title: 'Kategorie 1',
+        rows: [
+            { title: 'Option 1', description: 'Beschreibung 1', id: 'opt1' },
+            { title: 'Option 2', description: 'Beschreibung 2', id: 'opt2' }
+        ]
+    }
+];
+await msg.sendList('Titel', 'Beschreibung', 'Button Text', sections);
+
+// EasyBot
+bot.when('list test')
+   .list('Titel', 'Beschreibung', 'Button', sections)
+   .done();
+```
+
+#### **Template Messages**
+```javascript
+await msg.sendTemplate('template-id', {
+    text: 'Template Text',
+    footer: 'Footer',
+    buttons: []
+});
+```
+
+#### **Carousel Messages**
+```javascript
+const cards = [
+    {
+        title: 'Card 1',
+        subtitle: 'Untertitel',
+        body: 'Card Inhalt',
+        footer: 'Footer',
+        image: './image1.jpg',
+        buttons: []
+    }
+];
+await msg.sendCarousel(cards);
+```
+
+### **👥 Advanced Group Features**
+
+#### **Group Settings**
+```javascript
+await client.group.setSettings(groupId, {
+    messagesAdminOnly: true,
+    editGroupInfo: 'admin_only'
+});
+```
+
+#### **Group Description & Subject**
+```javascript
+await client.group.setDescription(groupId, 'Neue Beschreibung');
+await client.group.setSubject(groupId, 'Neuer Gruppenname');
+```
+
+#### **Invite Links**
+```javascript
+// Standard Client
+const inviteLink = await client.group.getInviteLink(groupId);
+await client.group.revokeInviteLink(groupId);
+await client.group.join('invite-code');
+
+// EasyBot
+bot.when('invite').inviteLink().done();
+```
+
+#### **Leave Group**
+```javascript
+await client.group.leave(groupId);
+```
+
+#### **Update Group Picture**
+```javascript
+await client.group.updatePicture(groupId, './group-pic.jpg');
+```
+
+### **🔒 Privacy & Security Features**
+
+#### **Block/Unblock Users**
+```javascript
+// Standard Client
+await client.privacy.block('user@s.whatsapp.net');
+await client.privacy.unblock('user@s.whatsapp.net');
+
+// EasyBot
+bot.when('block user').block().done(); // Blockiert Mentions oder Sender
+bot.when('unblock user').unblock().done();
+```
+
+#### **Privacy Settings**
+```javascript
+await client.privacy.setSettings({
+    lastSeen: 'contacts', // 'everyone', 'contacts', 'nobody'
+    profilePic: 'contacts',
+    status: 'contacts'
+});
+```
+
+#### **Read Receipts**
+```javascript
+await client.privacy.markRead(chatId, messageId);
+await client.privacy.markUnread(chatId);
+```
+
+### **📊 Analytics & Monitoring**
+
+#### **Online Status**
+```javascript
+// Standard Client
+const isOnline = await client.analytics.isOnline('user@s.whatsapp.net');
+const lastSeen = await client.analytics.getLastSeen('user@s.whatsapp.net');
+
+// EasyBot
+bot.when('check online').checkOnline().done(); // Prüft Mentions oder Sender
+```
+
+#### **Delivery Status**
+```javascript
+const status = await client.analytics.getDeliveryStatus(messageKey);
+// Returns: { sent: true, delivered: false, read: false, timestamp: ... }
+```
+
+#### **Archive/Unarchive Chats**
+```javascript
+// Standard Client
+await client.analytics.archiveChat(chatId);
+await client.analytics.unarchiveChat(chatId);
+
+// EasyBot
+bot.when('archive').archive().done();
+```
+
+#### **Mute/Unmute Chats**
+```javascript
+// Standard Client
+await client.analytics.muteChat(chatId, 8 * 60 * 60 * 1000); // 8 Stunden
+await client.analytics.unmuteChat(chatId);
+
+// EasyBot
+bot.when('mute').mute(480).done(); // 480 Minuten = 8 Stunden
+```
+
+### **📢 Advanced Status Features**
+
+#### **Send Status Updates**
+```javascript
+// Standard Client
+await client.status.send('text', 'Mein Status Text', {
+    backgroundColor: '#000000',
+    font: 0
+});
+
+await client.status.send('image', './status-image.jpg', {
+    caption: 'Status Bild'
+});
+
+// EasyBot
+bot.when('status test').sendStatus('Status Text').done();
+```
+
+#### **Get Status Views**
+```javascript
+const views = await client.status.getViews();
+// Returns: { totalViews: 0, viewers: [] }
+```
+
+#### **Get User Status**
+```javascript
+const userStatus = await client.status.getUserStatus('user@s.whatsapp.net');
+// Returns: { status: "Verfügbar", lastUpdated: Date }
+```
+
+### **💼 Business Features**
+
+#### **Business Profile**
+```javascript
+await client.business.setProfile({
+    description: 'Mein Business',
+    category: 'Technology',
+    email: 'contact@business.com',
+    website: 'https://business.com',
+    address: 'Business Adresse'
+});
+```
+
+#### **Product Messages**
+```javascript
+await client.business.sendProduct('product-id', 'catalog-id');
+```
+
+#### **Create Products**
+```javascript
+await client.business.createProduct({
+    name: 'Produkt Name',
+    description: 'Produkt Beschreibung',
+    price: 99.99,
+    currency: 'EUR',
+    images: ['./product1.jpg', './product2.jpg']
+});
+```
+
+#### **Payment Requests**
+```javascript
+await client.business.sendPaymentRequest(50.00, 'EUR', 'Zahlung für Service');
+```
+
+### **⚙️ System Features**
+
+#### **Backup & Restore**
+```javascript
+// Standard Client
+const backup = await client.system.backup();
+await client.system.restoreFromBackup(backupData);
+
+// EasyBot
+bot.when('backup').backup().done();
+```
+
+#### **Export Chat**
+```javascript
+const chatHistory = await client.system.exportChat(chatId, 'json');
+```
+
+#### **Import Contacts**
+```javascript
+const contactList = [
+    { name: 'John Doe', phone: '+1234567890' }
+];
+const results = await client.system.importContacts(contactList);
+```
+
+#### **Sync with Phone**
+```javascript
+await client.system.syncWithPhone();
+```
+
+#### **Device Management**
+```javascript
+const devices = await client.system.getLinkedDevices();
+await client.system.unlinkDevice('device-id');
+```
+
+### **🖼️ Profile Picture Features**
+
+#### **Get Profile Pictures**
+```javascript
+const profilePicUrl = await msg.getProfilePicture('user@s.whatsapp.net');
+```
+
+#### **Send Profile Pictures**
+```javascript
+// Standard Client
+await msg.sendProfilePicture('user@s.whatsapp.net', 'Profilbild Caption');
+
+// Mit Commands
+client.addCommand('profilpic', async (msg, args) => {
+    const mentions = msg.getMentions();
+    if (mentions.length > 0) {
+        await msg.sendProfilePicture(mentions[0]);
+    }
+});
+
+client.addCommand('meinprofil', async (msg, args) => {
+    await msg.sendProfilePicture(msg.getSender(), 'Dein Profilbild');
+});
+```
+
+### **🤖 EasyBot Advanced Integration**
+
+#### **Einfache Chains**
+```javascript
+const bot = EasyBot.create();
+
+bot
+    .when('test all')
+    .voice('./audio.ogg')
+    .forward()
+    .pin()
+    .star()
+    .buttons('Wähle:', [{ id: 'opt1', text: 'Option 1' }])
+    .groupInfo()
+    .checkOnline()
+    .archive()
+    .sendStatus('Test Status')
+    .backup()
+    .reply('Alle Features getestet!')
+    .done();
+```
+
+#### **Erweiterte EasyBot Features**
+```javascript
+// Advanced EasyBot mit allen Features
+const advancedBot = EasyBot.create()
+    .enableDefaults()
+    .enableAll(); // Aktiviert alle Standard-Features
+
+// Komplexe Chains mit Bedingungen
+advancedBot
+    .when('admin command')
+    .if('is group')
+    .then('groupInfo')
+    .if('is admin')
+    .then('pin')
+    .done();
+```
+
+#### **EasyBot Factory Methods**
+```javascript
+// Verschiedene Bot-Typen
+const standardBot = EasyBot.create();
+const multiBot = EasyBot.createMulti(3); // 3 Devices
+const quickBot = EasyBot.quick(); // Mit Defaults
+const robustBot = EasyBot.createRobust(); // Robuste Verbindung
+```
+
+### **📝 Mentions & Dynamic Targets**
+
+Alle Advanced Features funktionieren mit:
+
+- **Mentions**: `@user` in Nachrichten
+- **Sender ID**: Automatisch der Nachrichtensender  
+- **Statische JIDs**: Feste WhatsApp-IDs
+- **Dynamische Targets**: Zur Laufzeit bestimmt
+
+```javascript
+// Beispiele für dynamische Targets
+bot.when('voice @user').voice('./audio.ogg').done(); // An erwähnte User
+bot.when('forward back').forward().done(); // Zurück an Sender
+bot.when('check @user online').checkOnline().done(); // Online-Status von Mentions
+```
+
+### **🎮 Advanced Test Commands**
+
+#### **Media Commands**
+- **`!voice`** - Voice Message senden
+- **`!videomsg`** - Video Message senden
+- **`!gif`** - GIF senden
+- **`!thumbnail`** - Video mit Thumbnail
+
+#### **Message Commands**
+- **`!forward`** - Nachricht weiterleiten
+- **`!edit`** - Nachricht bearbeiten
+- **`!pin`** - Nachricht anheften (Admin)
+- **`!star`** - Nachricht markieren
+- **`!quote`** - Nachricht zitieren
+
+#### **Rich Content Commands**
+- **`!buttons`** - Button-Nachricht senden
+- **`!list`** - List-Nachricht senden
+- **`!template`** - Template-Nachricht
+- **`!carousel`** - Carousel-Nachricht
+
+#### **Group Commands**
+- **`!groupsettings`** - Gruppeneinstellungen (Admin)
+- **`!setdescription`** - Gruppenbeschreibung (Admin)
+- **`!invitelink`** - Einladungslink erstellen (Admin)
+- **`!grouppic`** - Gruppenbild ändern (Admin)
+
+#### **Privacy Commands**
+- **`!block @user`** - User blockieren
+- **`!unblock @user`** - User entblockieren
+- **`!privacy`** - Privacy-Einstellungen
+- **`!markread`** - Als gelesen markieren
+
+#### **Analytics Commands**
+- **`!isonline @user`** - Online-Status prüfen
+- **`!lastseen @user`** - Zuletzt online
+- **`!archive`** - Chat archivieren
+- **`!mute`** - Chat stumm schalten
+
+#### **Status Commands**
+- **`!sendstatus`** - Status senden
+- **`!statusviews`** - Status-Views anzeigen
+- **`!userstatus @user`** - User-Status abrufen
+
+#### **Business Commands**
+- **`!businessprofile`** - Business-Profil setzen
+- **`!sendproduct`** - Produkt senden
+- **`!createproduct`** - Produkt erstellen
+- **`!paymentrequest`** - Zahlungsanfrage
+
+#### **System Commands**
+- **`!backup`** - Backup erstellen
+- **`!exportchat`** - Chat exportieren
+- **`!importcontacts`** - Kontakte importieren
+- **`!syncphone`** - Mit Handy synchronisieren
+- **`!devices`** - Verknüpfte Geräte anzeigen
+
+#### **Profile Picture Commands**
+- **`!profilpic @user`** - Profilbild von User senden
+- **`!meinprofil`** - Eigenes Profilbild senden
+
+---
+
+## 🔥 Feature Count: **645+ Funktionen!**
 
 - **Message Functions:** 15+
 - **Group Functions:** 8+  
@@ -2230,6 +2760,17 @@ plugins/
 - **🆕 Sticker Creation:** 8+ (NEU in v1.0.8)
 - **🆕 Visual Recording:** 7+ (NEU in v1.0.8)
 - **🔥 Plugin System:** 80+ (NEU in v1.0.9) **OPTIONAL LOADING!**
+- **🚀 Advanced Media Features:** 35+ (NEU in v1.7.3)
+- **🚀 Advanced Message Features:** 40+ (NEU in v1.7.3)
+- **🚀 Rich Content Features:** 45+ (NEU in v1.7.3)
+- **🚀 Advanced Group Features:** 25+ (NEU in v1.7.3)
+- **🚀 Privacy & Security Features:** 30+ (NEU in v1.7.3)
+- **🚀 Analytics & Monitoring:** 35+ (NEU in v1.7.3)
+- **🚀 Advanced Status Features:** 20+ (NEU in v1.7.3)
+- **🚀 Business Features:** 25+ (NEU in v1.7.3)
+- **🚀 System Features:** 30+ (NEU in v1.7.3)
+- **🚀 Profile Picture Features:** 15+ (NEU in v1.7.3)
+- **🚀 EasyBot Advanced Integration:** 100+ (NEU in v1.7.3)
 
 ---
 
@@ -2255,6 +2796,12 @@ plugins/
 - **🆕 Sticker Creation** - `msg.create.sticker.fromMedia()` mit Sharp
 - **🆕 Visual Recording** - `msg.visualRecord()`, `msg.recordAndReply()`
 - **🔥 Plugin System** - 8 Optionale Plugins mit 80+ Commands **OPTIONAL LOADING!**
+- **🚀 Advanced Media** - Voice, Video, GIF, Thumbnails (400+ Features)
+- **🚀 Rich Content** - Buttons, Lists, Templates, Carousels
+- **🚀 Business Features** - Products, Payments, Business Profile
+- **🚀 Privacy & Security** - Block/Unblock, Privacy Settings
+- **🚀 Analytics** - Online Status, Delivery Status, Archive
+- **🚀 Profile Pictures** - Get/Send Profile Pictures mit Commands
 
 ### **💪 Production Ready**
 - **Persistent Auth** - Einmalige Einrichtung
@@ -2266,6 +2813,10 @@ plugins/
 - **🆕 Job Scheduling** - Überlebt Neustarts
 - **🆕 AI Moderation** - Automatische Content-Filterung
 - **🔥 Plugin Architecture** - Modulares System mit Auto-Loading
+- **🚀 Advanced Features** - 400+ neue WhatsApp-Funktionen
+- **🚀 Robust Connection** - Ultra-robuste Verbindung mit Auto-Reconnect
+- **🚀 Dynamic Targets** - Mentions, Sender ID, statische JIDs
+- **🚀 EasyBot Integration** - Alle Advanced Features in Chains verfügbar
 
 ### **📈 Skalierbare Architektur**
 - **Load Balancing** - Message Load verteilen
@@ -2276,6 +2827,10 @@ plugins/
 - **🆕 Event-Driven** - Scheduler + Waiting System
 - **🆕 AI-Powered** - Intelligente Responses
 - **🔥 Plugin Ecosystem** - 8 Plugins mit 80+ Commands sofort verfügbar
+- **🚀 Advanced WhatsApp API** - 400+ neue Funktionen in 11 Kategorien
+- **🚀 Rich Content Support** - Buttons, Lists, Templates, Carousels
+- **🚀 Business Ready** - Products, Payments, Business Profile
+- **🚀 Enterprise Features** - Privacy, Security, Analytics, Monitoring
 
 ---
 
@@ -2347,8 +2902,69 @@ plugins/
 - **`!test-analytics`** - Analytics Plugin testen
 - **`!test-all`** - Alle Plugins nacheinander testen
 
+### **🚀 Advanced Feature Commands (NEU in v1.7.3)**
+
+#### **Media Commands**
+- **`!voice`** - Voice Message senden
+- **`!videomsg`** - Video Message senden
+- **`!gif`** - GIF senden
+- **`!thumbnail`** - Video mit Thumbnail
+
+#### **Message Commands**
+- **`!forward`** - Nachricht weiterleiten
+- **`!edit`** - Nachricht bearbeiten
+- **`!pin`** - Nachricht anheften (Admin)
+- **`!star`** - Nachricht markieren
+- **`!quote`** - Nachricht zitieren
+
+#### **Rich Content Commands**
+- **`!buttons`** - Button-Nachricht senden
+- **`!list`** - List-Nachricht senden
+- **`!template`** - Template-Nachricht
+- **`!carousel`** - Carousel-Nachricht
+
+#### **Group Commands**
+- **`!groupsettings`** - Gruppeneinstellungen (Admin)
+- **`!setdescription`** - Gruppenbeschreibung (Admin)
+- **`!invitelink`** - Einladungslink erstellen (Admin)
+- **`!grouppic`** - Gruppenbild ändern (Admin)
+
+#### **Privacy Commands**
+- **`!block @user`** - User blockieren
+- **`!unblock @user`** - User entblockieren
+- **`!privacy`** - Privacy-Einstellungen
+- **`!markread`** - Als gelesen markieren
+
+#### **Analytics Commands**
+- **`!isonline @user`** - Online-Status prüfen
+- **`!lastseen @user`** - Zuletzt online
+- **`!archive`** - Chat archivieren
+- **`!mute`** - Chat stumm schalten
+
+#### **Status Commands**
+- **`!sendstatus`** - Status senden
+- **`!statusviews`** - Status-Views anzeigen
+- **`!userstatus @user`** - User-Status abrufen
+
+#### **Business Commands**
+- **`!businessprofile`** - Business-Profil setzen
+- **`!sendproduct`** - Produkt senden
+- **`!createproduct`** - Produkt erstellen
+- **`!paymentrequest`** - Zahlungsanfrage
+
+#### **System Commands**
+- **`!backup`** - Backup erstellen
+- **`!exportchat`** - Chat exportieren
+- **`!importcontacts`** - Kontakte importieren
+- **`!syncphone`** - Mit Handy synchronisieren
+- **`!devices`** - Verknüpfte Geräte anzeigen
+
+#### **Profile Picture Commands**
+- **`!profilpic @user`** - Profilbild von User senden
+- **`!meinprofil`** - Eigenes Profilbild senden
+
 ---
 
 *Made with ❤️ for WhatsApp Automation*
 
-**Die mächtigste WhatsApp Bot Library - von 3-Zeilen-Bots bis zu KI-gestützten Enterprise Multi-Device Systemen mit vollständigem Plugin-Ecosystem (8 Plugins, 80+ Commands), Hidetag, Sticker Creation und Visual Recording!**
+**Die mächtigste WhatsApp Bot Library - von 3-Zeilen-Bots bis zu KI-gestützten Enterprise Multi-Device Systemen mit vollständigem Plugin-Ecosystem (8 Plugins, 80+ Commands), 400+ Advanced Features in 11 Kategorien, Hidetag, Sticker Creation, Visual Recording, Rich Content (Buttons, Lists, Carousels), Business Features, Privacy & Security, Analytics & Monitoring und Profile Picture API!**