@deathnaitsa/wa-api 2.0.29 → 2.1.1

package/README.md

@@ -8,8 +8,7 @@ Eine minimalistische, stabile WhatsApp Multi-Device API basierend auf Baileys mi
 - [Features](#-features)
 - [Installation](#-installation)
 - [Quick Start](#-quick-start)
-  - [ES Modules](#es-modules-empfohlen)
-  - [CommonJS](#commonjs)
+- [Configuration](#-configuration)
 - [API Dokumentation](#-api-dokumentation)
   - [Session Management](#-session-management-implementiert)
   - [Nachrichten](#-nachrichten-implementiert)
@@ -87,13 +86,46 @@ npm install
 npm install better-sqlite3
 ```
 
+**Config-Datei erstellen (empfohlen)**
+```bash
+node -e "import('@deathnaitsa/wa-api').then(m => m.initConfig())"
+```
+
+Dies erstellt eine `wa-api.config.js` im Hauptverzeichnis mit allen verfügbaren Einstellungen.
+
 **Unterstützt beide Formate:**
 - ✅ **ES Modules** (import)
 - ✅ **CommonJS** (require)
 
 ## 🚀 Quick Start
 
-### ES Modules (empfohlen)
+### 1. Config erstellen (optional, aber empfohlen)
+```javascript
+import { initConfig } from '@deathnaitsa/wa-api';
+
+// Erstellt wa-api.config.js im Hauptverzeichnis
+initConfig();
+```
+
+Dann in `wa-api.config.js` deine Einstellungen anpassen:
+```javascript
+export const waApiConfig = {
+    session: {
+        useSqlByDefault: true,  // SQLite als Standard
+        printQR: true,
+        autoReconnect: true,
+    },
+    footer: {
+        enabled: true,          // Footer aktivieren
+        text: 'Powered by Nishi API 🚀',
+    },
+    // ... weitere Einstellungen
+};
+```
+
+### 2. Session starten
+
+#### ES Modules (empfohlen)
 ```javascript
 import { startSession, onMessage, sendText } from '@deathnaitsa/wa-api';
 
@@ -108,7 +140,7 @@ onMessage(async (msg) => {
 });
 ```
 
-### CommonJS
+#### CommonJS
 ```javascript
 const { startSession, onMessage, sendText } = require('@deathnaitsa/wa-api');
 
@@ -193,6 +225,114 @@ await startSession('main', {
 npm install better-sqlite3
 ```
 
+## ⚙️ Configuration
+
+Die Nishi WhatsApp API kann über eine zentrale Config-Datei konfiguriert werden. Dies erspart dir, bei jedem `startSession()` Aufruf die gleichen Optionen anzugeben.
+
+### Config-Datei erstellen
+
+```javascript
+import { initConfig } from '@deathnaitsa/wa-api';
+
+initConfig(); // Erstellt wa-api.config.js im Hauptverzeichnis
+```
+
+Oder über CLI:
+```bash
+node -e "import('@deathnaitsa/wa-api').then(m => m.initConfig())"
+```
+
+### Verfügbare Config-Optionen
+
+```javascript
+// wa-api.config.js
+export const waApiConfig = {
+    // Session-Einstellungen
+    session: {
+        useSqlByDefault: true,              // SQLite statt JSON-Files
+        browser: ['Chrome', '120.0.0', 'Windows'],
+        printQR: true,
+        credentialsDir: './sessions',
+        autoReconnect: true,
+        logLevel: 'silent',                 // 'trace', 'debug', 'info', 'warn', 'error', 'fatal', 'silent'
+        markOnlineOnConnect: false,
+    },
+
+    // Auto-Reconnect Einstellungen
+    reconnect: {
+        maxRetries: 5,
+        initialDelay: 2000,
+        maxDelay: 30000,
+        multiplier: 2,
+    },
+
+    // Footer/Wasserzeichen für Nachrichten ✨ NEU!
+    footer: {
+        enabled: true,                       // Footer aktivieren
+        text: 'Powered by Nishi API 🚀',    // Footer-Text
+        applyToTypes: ['text', 'image', 'video', 'audio', 'document', 'sticker'], // Alle Typen!
+        onlyOutgoing: true,
+    },
+
+    // Rate Limiting
+    rateLimit: {
+        enabled: false,
+        maxMessages: 20,
+        interval: 60000,
+        queueInterval: 1000,
+    },
+
+    // Webhook, Stats, Media, Sticker, Features, Developer...
+    // Siehe wa-api.config.js für alle Optionen
+};
+```
+
+### Config verwenden
+
+**Mit Config-Datei:**
+```javascript
+// wa-api.config.js: useSqlByDefault: true, autoReconnect: true
+
+import { startSession } from '@deathnaitsa/wa-api';
+
+// Verwendet automatisch SQLite und Auto-Reconnect aus Config
+await startSession('bot1');
+```
+
+**Config überschreiben:**
+```javascript
+// Config sagt: useSqlByDefault: true
+// Aber für diese Session wollen wir JSON-Files:
+await startSession('bot1', { sql: false });
+```
+
+### Footer/Wasserzeichen Beispiel
+
+```javascript
+// wa-api.config.js
+footer: {
+    enabled: true,
+    text: '🤖 Powered by Nishi Bot',
+    applyToTypes: ['text'],
+}
+```
+
+Jetzt haben **alle** Text-Nachrichten automatisch einen Footer:
+```javascript
+await sendText('bot1', jid, 'Hallo Welt!');
+// Wird gesendet mit Footer "🤖 Powered by Nishi Bot"
+
+// Funktioniert auch für Media:
+await sendImage('bot1', jid, image, 'Schau mal!');
+// Bild mit Caption + Footer
+
+await sendVideo('bot1', jid, video, 'Cool!');
+// Video mit Caption + Footer
+
+await sendDocument('bot1', jid, doc);
+// Dokument mit Footer
+```
+
 #### ✅ Nachrichten (Implementiert)
 ```javascript
 import { sendText, onMessage } from '@deathnaitsa/wa-api';