@deathnaitsa/wa-api 1.0.0

package/dist/Utils/save-media.js

@@ -0,0 +1,47 @@
+"use strict";
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.saveDocumentHandler = exports.saveVideoHandler = exports.saveImageHandler = void 0;
+const baileys_1 = require("@whiskeysockets/baileys");
+const error_1 = __importDefault(require("./error"));
+const promises_1 = __importDefault(require("fs/promises"));
+const saveMedia = (path, data) => __awaiter(void 0, void 0, void 0, function* () {
+    yield promises_1.default.writeFile(path, data.toString("base64"), "base64");
+});
+const saveImageHandler = (msg, path) => __awaiter(void 0, void 0, void 0, function* () {
+    var _a;
+    if (!((_a = msg.message) === null || _a === void 0 ? void 0 : _a.imageMessage))
+        throw new error_1.default("Message is not contain Image");
+    const buf = yield (0, baileys_1.downloadMediaMessage)(msg, "buffer", {});
+    return saveMedia(path, buf);
+});
+exports.saveImageHandler = saveImageHandler;
+const saveVideoHandler = (msg, path) => __awaiter(void 0, void 0, void 0, function* () {
+    var _b;
+    if (!((_b = msg.message) === null || _b === void 0 ? void 0 : _b.videoMessage))
+        throw new error_1.default("Message is not contain Video");
+    const buf = yield (0, baileys_1.downloadMediaMessage)(msg, "buffer", {});
+    return saveMedia(path, buf);
+});
+exports.saveVideoHandler = saveVideoHandler;
+const saveDocumentHandler = (msg, path) => __awaiter(void 0, void 0, void 0, function* () {
+    var _c, _d;
+    if (!((_c = msg.message) === null || _c === void 0 ? void 0 : _c.documentMessage))
+        throw new error_1.default("Message is not contain Document");
+    const buf = yield (0, baileys_1.downloadMediaMessage)(msg, "buffer", {});
+    const ext = (_d = msg.message.documentMessage.fileName) === null || _d === void 0 ? void 0 : _d.split(".").pop();
+    path += "." + ext;
+    return saveMedia(path, buf);
+});
+exports.saveDocumentHandler = saveDocumentHandler;

package/dist/Utils/set-credentials-dir.d.ts

@@ -0,0 +1,2 @@
+export declare const setCredentialsDir: (dirname?: string) => void;
+//# sourceMappingURL=set-credentials-dir.d.ts.map

package/dist/Utils/set-credentials-dir.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"set-credentials-dir.d.ts","sourceRoot":"","sources":["../../src/Utils/set-credentials-dir.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,iBAAiB,aAAa,MAAM,SAEhD,CAAC"}

package/dist/Utils/set-credentials-dir.js

@@ -0,0 +1,8 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.setCredentialsDir = void 0;
+const Defaults_1 = require("../Defaults");
+const setCredentialsDir = (dirname = "wa_credentials") => {
+    Defaults_1.CREDENTIALS.DIR_NAME = dirname;
+};
+exports.setCredentialsDir = setCredentialsDir;

package/dist/Utils/set-credentials.d.ts

@@ -0,0 +1,2 @@
+export declare const setCredentials: (dirname?: string) => void;
+//# sourceMappingURL=set-credentials-dir.d.ts.map

package/dist/Utils/set-credentials.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"set-credentials-dir.d.ts","sourceRoot":"","sources":["../../src/Utils/set-credentials.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,iBAAiB,aAAa,MAAM,SAEhD,CAAC"}

package/dist/Utils/set-credentials.js

@@ -0,0 +1,8 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.setCredentials = void 0;
+const Defaults_1 = require("../Defaults");
+const setCredentials = (dirname = "_credentials") => {
+    Defaults_1.CREDENTIALS.SUFFIX = dirname;
+};
+exports.setCredentials = setCredentials;

package/dist/index.d.ts

@@ -0,0 +1,6 @@
+export * from "./Socket";
+export * from "./Messaging";
+export * from "./Utils";
+export * from "./Types";
+export * from "./Error";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,UAAU,CAAC;AACzB,cAAc,aAAa,CAAC;AAC5B,cAAc,SAAS,CAAC;AACxB,cAAc,SAAS,CAAC;AACxB,cAAc,SAAS,CAAC"}

package/dist/index.js

@@ -0,0 +1,21 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./Socket"), exports);
+__exportStar(require("./Messaging"), exports);
+__exportStar(require("./Utils"), exports);
+__exportStar(require("./Types"), exports);
+__exportStar(require("./Error"), exports);

package/dist/whatsapp/index.d.ts

@@ -0,0 +1,15 @@
+import { Socket } from "../Socket/Socket";
+import { WhatsappOptions } from "../Types/WhatsappOptions";
+export declare class Whatsapp {
+    constructor(options?: WhatsappOptions);
+    sockets: Map<string, Socket>;
+    callback: Map<string, Function>;
+    retryCount: Map<string, number>;
+    load(each?: (socket: Socket) => Socket): Promise<void>;
+    private shouldLoadSession;
+    private getSocket;
+    startSession: (socket: Socket) => Promise<Socket>;
+    private isSessionExistAndRunning;
+    deleteSession: (sessionId: string) => Promise<void>;
+}
+//# sourceMappingURL=index.d.ts.map

package/dist/whatsapp/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/Whatsapp/index.ts"],"names":[],"mappings":"AASA,OAAO,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAC;AAC1C,OAAO,EAAE,eAAe,EAAE,MAAM,0BAA0B,CAAC;AAc3D,qBAAa,QAAQ;gBACP,OAAO,GAAE,eAAoB;IAEzC,OAAO,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAa;IACzC,QAAQ,EAAE,GAAG,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAa;IAC5C,UAAU,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAa;IAEtC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,MAAM;IAsB5C,OAAO,CAAC,iBAAiB,CAoBvB;IAEF,OAAO,CAAC,SAAS,CACe;IAEhC,YAAY,WAAkB,MAAM,KAAG,QAAQ,MAAM,CAAC,CAiGpD;IAEF,OAAO,CAAC,wBAAwB,CAoB9B;IAEF,aAAa,cAAqB,MAAM,mBAWtC;CACH"}

package/dist/whatsapp/index.js

@@ -0,0 +1,206 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || function (mod) {
+    if (mod && mod.__esModule) return mod;
+    var result = {};
+    if (mod != null) for (var k in mod) if (k !== "default" && Object.prototype.hasOwnProperty.call(mod, k)) __createBinding(result, mod, k);
+    __setModuleDefault(result, mod);
+    return result;
+};
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Whatsapp = void 0;
+const baileys_1 = __importStar(require("@whiskeysockets/baileys"));
+const Defaults_1 = require("../Defaults");
+const Socket_1 = require("../Socket/Socket");
+const fs_1 = __importDefault(require("fs"));
+const path_1 = __importDefault(require("path"));
+const Error_1 = require("../Error");
+const pino_1 = __importDefault(require("pino"));
+const message_status_1 = require("../Utils/message-status");
+const save_media_1 = require("../Utils/save-media");
+class Whatsapp {
+    constructor(options = {}) {
+        this.sockets = new Map();
+        this.callback = new Map();
+        this.retryCount = new Map();
+        this.shouldLoadSession = (socket) => {
+            if (fs_1.default.existsSync(path_1.default.resolve(Defaults_1.CREDENTIALS.DIR_NAME)) &&
+                fs_1.default.existsSync(path_1.default.resolve(Defaults_1.CREDENTIALS.DIR_NAME, socket.id + "_" + socket.phoneNumber + Defaults_1.CREDENTIALS.SUFFIX)) &&
+                fs_1.default.readdirSync(path_1.default.resolve(Defaults_1.CREDENTIALS.DIR_NAME, socket.id + "_" + socket.phoneNumber + Defaults_1.CREDENTIALS.SUFFIX)).length &&
+                !this.getSocket(socket.id)) {
+                return true;
+            }
+            return false;
+        };
+        this.getSocket = (key) => { var _a; return (_a = this.sockets.get(key)) !== null && _a !== void 0 ? _a : null; };
+        this.startSession = (socket) => __awaiter(this, void 0, void 0, function* () {
+            if (this.isSessionExistAndRunning(socket))
+                throw new Error_1.WhatsappError(Defaults_1.Messages.sessionAlreadyExist(socket.id));
+            const logger = (0, pino_1.default)({ level: "silent" });
+            const { version } = yield (0, baileys_1.fetchLatestBaileysVersion)();
+            const startSocket = () => __awaiter(this, void 0, void 0, function* () {
+                var _a;
+                const { state, saveCreds } = yield (0, baileys_1.useMultiFileAuthState)(path_1.default.resolve(Defaults_1.CREDENTIALS.DIR_NAME, socket.id + "_" + socket.phoneNumber + Defaults_1.CREDENTIALS.SUFFIX));
+                const sock = (0, baileys_1.default)({
+                    version,
+                    auth: {
+                        creds: state.creds,
+                        keys: (0, baileys_1.makeCacheableSignalKeyStore)(state.keys, logger),
+                    },
+                    logger,
+                    markOnlineOnConnect: false,
+                    browser: baileys_1.Browsers.ubuntu("Chrome"),
+                });
+                socket.socket = sock;
+                this.sockets.set(socket.id, socket);
+                try {
+                    sock.ev.process((events) => __awaiter(this, void 0, void 0, function* () {
+                        var _b, _c, _d, _e, _f, _g, _h, _j, _k, _l;
+                        if (events["connection.update"]) {
+                            const update = events["connection.update"];
+                            const { connection, lastDisconnect } = update;
+                            if (update.qr) {
+                                (_b = socket.onQr) === null || _b === void 0 ? void 0 : _b.call(socket, update.qr);
+                            }
+                            if (connection == "connecting") {
+                                (_c = socket.onConnecting) === null || _c === void 0 ? void 0 : _c.call(socket);
+                            }
+                            if (connection === "close") {
+                                const code = (_e = (_d = lastDisconnect === null || lastDisconnect === void 0 ? void 0 : lastDisconnect.error) === null || _d === void 0 ? void 0 : _d.output) === null || _e === void 0 ? void 0 : _e.statusCode;
+                                let retryAttempt = (_f = this.retryCount.get(socket.id)) !== null && _f !== void 0 ? _f : 0;
+                                let shouldRetry;
+                                if (code != baileys_1.DisconnectReason.loggedOut && retryAttempt < 10) {
+                                    shouldRetry = true;
+                                }
+                                if (shouldRetry) {
+                                    retryAttempt++;
+                                }
+                                if (shouldRetry) {
+                                    this.retryCount.set(socket.id, retryAttempt);
+                                    startSocket();
+                                }
+                                else {
+                                    this.retryCount.delete(socket.id);
+                                    this.deleteSession(socket.id);
+                                    (_g = socket.onDisconnected) === null || _g === void 0 ? void 0 : _g.call(socket);
+                                }
+                            }
+                            if (connection == "open") {
+                                this.retryCount.delete(socket.id);
+                                (_h = socket.onConnected) === null || _h === void 0 ? void 0 : _h.call(socket);
+                            }
+                        }
+                        if (events["creds.update"]) {
+                            yield saveCreds();
+                        }
+                        if (events["messages.update"]) {
+                            const msg = events["messages.update"][0];
+                            const data = Object.assign({ sessionId: socket.id, messageStatus: (0, message_status_1.parseMessageStatusCodeToReadable)(msg.update.status) }, msg);
+                            (_j = socket.onMessageUpdated) === null || _j === void 0 ? void 0 : _j.call(socket, data);
+                        }
+                        if (events["messages.upsert"]) {
+                            const msg = (_k = events["messages.upsert"]
+                                .messages) === null || _k === void 0 ? void 0 : _k[0];
+                            msg.sessionId = socket.id;
+                            msg.saveImage = (path) => (0, save_media_1.saveImageHandler)(msg, path);
+                            msg.saveVideo = (path) => (0, save_media_1.saveVideoHandler)(msg, path);
+                            msg.saveDocument = (path) => (0, save_media_1.saveDocumentHandler)(msg, path);
+                            (_l = socket.onMessageReceived) === null || _l === void 0 ? void 0 : _l.call(socket, msg);
+                        }
+                    }));
+                    if (!sock.authState.creds.registered) {
+                        yield new Promise((resolve) => setTimeout(resolve, 5000));
+                        const code = yield sock.requestPairingCode(socket.phoneNumber);
+                        console.log(code);
+                        (_a = socket.onPairing) === null || _a === void 0 ? void 0 : _a.call(socket, code);
+                    }
+                    return socket;
+                }
+                catch (error) {
+                    console.log(error.message);
+                    return socket;
+                }
+            });
+            return startSocket();
+        });
+        this.isSessionExistAndRunning = (socket) => {
+            if (fs_1.default.existsSync(path_1.default.resolve(Defaults_1.CREDENTIALS.DIR_NAME)) &&
+                fs_1.default.existsSync(path_1.default.resolve(Defaults_1.CREDENTIALS.DIR_NAME, socket.id + "_" + socket.phoneNumber + Defaults_1.CREDENTIALS.SUFFIX)) &&
+                fs_1.default.readdirSync(path_1.default.resolve(Defaults_1.CREDENTIALS.DIR_NAME, socket.id + "_" + socket.phoneNumber + Defaults_1.CREDENTIALS.SUFFIX)).length &&
+                this.getSocket(socket.id)) {
+                return true;
+            }
+            return false;
+        };
+        this.deleteSession = (sessionId) => __awaiter(this, void 0, void 0, function* () {
+            const socket = this.getSocket(sessionId);
+            if (!socket)
+                return;
+            yield socket.logout();
+            const dir = path_1.default.resolve(Defaults_1.CREDENTIALS.DIR_NAME, socket.id + "_" + socket.phoneNumber + Defaults_1.CREDENTIALS.SUFFIX);
+            if (fs_1.default.existsSync(dir)) {
+                fs_1.default.rmSync(dir, { force: true, recursive: true });
+            }
+        });
+    }
+    load(each) {
+        return __awaiter(this, void 0, void 0, function* () {
+            if (!fs_1.default.existsSync(path_1.default.resolve(Defaults_1.CREDENTIALS.DIR_NAME))) {
+                fs_1.default.mkdirSync(path_1.default.resolve(Defaults_1.CREDENTIALS.DIR_NAME));
+            }
+            fs_1.default.readdir(path_1.default.resolve(Defaults_1.CREDENTIALS.DIR_NAME), (err, dirs) => __awaiter(this, void 0, void 0, function* () {
+                var _a;
+                if (err) {
+                    throw err;
+                }
+                for (const dir of dirs) {
+                    const sessionId = dir.split("_")[0];
+                    const phoneNumber = dir.split("_")[1];
+                    let socket = new Socket_1.Socket({
+                        id: sessionId,
+                        phoneNumber: phoneNumber,
+                    });
+                    socket = (_a = each === null || each === void 0 ? void 0 : each(socket)) !== null && _a !== void 0 ? _a : socket;
+                    if (!this.shouldLoadSession(socket))
+                        continue;
+                    this.startSession(socket);
+                }
+            }));
+        });
+    }
+}
+exports.Whatsapp = Whatsapp;
+const wa = new Whatsapp();
+// wa.load();
+const mySocket = new Socket_1.Socket({ id: "mysocket", phoneNumber: "6281524538841" });
+mySocket.onPairing = (code) => {
+    console.log(code);
+};
+wa.startSession(mySocket);

package/package.json

@@ -0,0 +1,37 @@
+{
+  "name": "@deathnaitsa/wa-api",
+  "version": "1.0.0",
+  "description": "Multi Session Whatsapp Library",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/DeathNaitsa/wa-api.git"
+  },
+  "homepage": "https://github.com/DeathNaitsa/wa-api#readme",
+  "bugs": {
+    "url": "https://github.com/DeathNaitsa/wa-api/issues"
+  },
+  "files": [
+    "dist/**/*"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "start": "tsc && node ./dist/index.js",
+    "test": "echo \"Error: no test specified\" && exit 1",
+    "run-script": "node ./dist/index.js"
+  },
+  "author": "DeathNaitsa",
+  "license": "ISC",
+  "dependencies": {
+    "@adiwajshing/keyed-db": "^0.2.4",
+    "@hapi/boom": "^10.0.1",
+    "@whiskeysockets/baileys": "^6.7.16",
+    "mime": "^4.0.7",
+    "pino": "^9.6.0",
+    "qrcode-terminal": "^0.12.0"
+  },
+  "devDependencies": {
+    "@types/mime": "^4.0.0"
+  }
+}

package/readme.md

@@ -0,0 +1,108 @@
+# wa-api
+
+Leichte Bibliothek zur Verwaltung mehrerer WhatsApp-Sessions – mit **einer** universellen `sendMessage`-Funktion für **alle** Nachrichtentypen.
+
+## 📦 Installation
+
+```bash
+npm install @DeathNaitsa/wa-api@latest
+```
+
+## 🔌 Import & Setup
+
+Verwende den klassischen Import-Stil:
+
+```js
+// CommonJS
+const wa = require('@DeathNaitsa/wa-api');
+
+// ES Module
+import * as wa from '@DeathNaitsa/wa-api';
+```
+
+Danach stehen dir alle Funktionen unter dem Namespace `wa` zur Verfügung.
+
+## 🚀 Session Management
+
+```js
+// Neue Session erzeugen und QR-Code scannen
+const session = await wa.startSession('meineSession');
+
+// Alternativ: per Pairing-Code starten
+const paired = await wa.startSessionWithPairingCode('meineSession', { phoneNumber: '491234567890' });
+
+// Alle aktiven Sessions abrufen
+const sessions = wa.getAllSession(); // z.B. ['meineSession']
+
+// Metadaten einer Session abrufen
+const data = wa.getSession('meineSession');
+
+// Vorhandene Sessions aus Ordner automatisch laden
+const loaded = await wa.loadSessionsFromStorage();
+console.log('Geladene Sessions:', loaded);
+```
+
+## 💬 Nachrichten senden mit `sendMessage`
+
+Eine **einzige** Funktion für **Text**, **Media**, **Polls**, **Reaktionen**, **Löschen/Pinning**, **Kontakte**, **Standort**, **Weiterleiten** u.v.m.
+
+```js
+await wa.sendMessage(
+  'meineSession',             // sessionId
+  '491234567890@c.us',         // JID oder Telefonnummer
+  content,                     // AnyMessageContent-Objekt
+  options                      // MiscMessageGenerationOptions (optional)
+);
+```
+
+### Beispiele für `content` & `options`
+
+| Typ          | content-Beispiel                                                                                | optionale Flags        | Beschreibung                                  |
+| ------------ | ----------------------------------------------------------------------------------------------- | ---------------------- | --------------------------------------------- |
+| **Text**     | `{ text: 'Hallo Welt!' }`                                                                       | `{ quoted, mentions }` | Einfache Textnachricht                        |
+| **Quote**    | `{ text: 'Antwort...' }`, `options: { quoted: msgObj }`                                         |                        | Text als Antwort (Quote)                      |
+| **Mention**  | `{ text: '@491234567890 Hallo' }`, `options: { mentions: ['491234567890@s.whatsapp.net'] }`     |                        | Erwähnung in Text                             |
+| **Bild**     | `{ image: { url:'./bild.png' }, caption:'Bild', viewOnce:true }`                                | `viewOnce`             | Bild senden; `viewOnce` für Einmaldarstellung |
+| **Video**    | `{ video: { url:'./video.mp4' }, caption:'Video', gifPlayback:true }`                           | `gifPlayback`          | Video oder GIF (als MP4)                      |
+| **Audio**    | `{ audio: { url:'./audio.ogg' }, mimetype:'audio/ogg', ptt:true }`                              | `ptt`                  | Audio/Sprachnachricht                         |
+| **Dokument** | `{ document: { url:'./doc.pdf', filename:'D.pdf' } }`                                           |                        | Datei/Dokument                                |
+| **Umfrage**  | `{ poll: { name:'Umfrage?', values:['A','B'], selectableCount:1, toAnnouncementGroup:false } }` |                        | Neue Umfrage                                  |
+| **Reaktion** | `{ react: { text:'👍', key:msgObj.key } }`                                                      |                        | Nachricht mit Emoji reagieren                 |
+| **Löschen**  | `{ delete: msgObj.key }`                                                                        |                        | Nachricht für alle löschen                    |
+| **Pinning**  | `{ pin: { type:1, time:86400, key:msgObj.key } }`                                               |                        | Nachricht pinnen (1) oder entpinnen (0)       |
+| **Kontakte** | `{ contacts:{ displayName:'Max', contacts:[{ vcard }] } }`                                      |                        | Kontaktkarte                                  |
+| **Standort** | `{ location:{ degreesLatitude:52.52, degreesLongitude:13.405 } }`                               |                        | Standort                                      |
+| **Weiterl.** | `{ forward: msgToForward }`                                                                     |                        | Nachricht weiterleiten                        |
+
+> **Hinweis:** Weitere Flags und Optionen (`edit`, `mentions`, `quoted`, etc.) können über das `options`-Objekt übergeben werden.
+
+## 🎧 Listener
+
+```js
+// Eingehende Nachrichten
+wa.onMessageReceived(msg => console.log('Neue Message:', msg));
+
+// QR-Code zum Scannen aktualisiert
+wa.onQRUpdated(({ sessionId, qr }) => console.log(`Scan QR (${sessionId}):`, qr));
+
+// Session erfolgreich verbunden
+wa.onConnected(sessionId => console.log(`Session online: ${sessionId}`));
+```
+
+## ⚠️ Fehlerbehandlung
+
+Alle Fehler werden als `WhatsappError` geworfen:
+
+```js
+try {
+  await wa.sendMessage(...);
+} catch (e) {
+  if (e instanceof wa.WhatsappError) {
+    console.error('WhatsApp-Fehler:', e.message);
+  }
+}
+```
+
+---
+
+© 2025 `@DeathNaitsa/wa-api` • Support: [sebloidl13@gmail.com](mailto:sebloidl13@gmail.com)