@neelegirl/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("@neelegirl/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("@neelegirl/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,38 @@
+{
+  "name": "@neelegirl/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/neelegirly/neelegirl-wa-api.git"
+  },
+  "homepage": "https://https://github.com/neelegirly/neelegirl-wa-api#readme",
+  "bugs": {
+    "url": "https://github.com/neelegirly/neelegirl-wa-api"
+  },
+  "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": "Neele",
+  "license": "ISC",
+  "dependencies": {
+    "jest": "^29.0.0",
+    "@adiwajshing/keyed-db": "^0.2.4",
+    "@hapi/boom": "^10.0.1",
+    "@neelegirl/baileys": "^1.5.6",
+    "mime": "^3.0.0",
+    "pino": "^8.11.0",
+    "qrcode-terminal": "^0.12.0"
+  },
+  "devDependencies": {
+    "@types/mime": "^3.0.1"
+  }
+}

package/readme.md

@@ -0,0 +1,141 @@
+# 💌 @neelegirl/wa-api → **onimai**
+
+✨ *Die elegante & simple WhatsApp-Bibliothek*  
+zur Verwaltung **mehrerer Sessions** – mit  
+💎 **universeller `sendMessage`** und direkter  
+⚡ **`relayMessage`-Power** für Profis.  
+
+---
+
+> ⚠️ **Hinweis:**  
+> Diese Library funktioniert **ausschließlich** mit **@neelegirl/baileys** und ist auch **mit LID kompatibel**.  
+> 🔒 Andere Baileys-Forks oder Varianten sind **nicht unterstützt**.  
+
+---
+
+## 📚 Inhaltsverzeichnis
+
+1. [📦 Installation](#-installation)  
+2. [🔌 Import & Setup](#-import--setup)  
+3. [📲 Session Management](#-session-management)  
+4. [💬 Nachrichten senden (`sendMessage`)](#-nachrichten-senden-sendmessage)  
+5. [🔧 Spezialfunktionen (`relayMessage`)](#-spezialfunktionen-relaymessage)  
+6. [🎧 Listener](#-listener)  
+7. [🚨 Fehlerbehandlung](#-fehlerbehandlung)  
+8. [👩‍💻 Autorin & Support](#-autorin--support)  
+
+---
+
+## 📦 Installation
+
+```bash
+npm install @neelegirl/wa-api@latest
+```
+
+---
+
+## 🔌 Import & Setup
+
+```js
+// CommonJS
+const onimai = require('@neelegirl/wa-api');
+
+// ES Module
+import * as onimai from '@neelegirl/wa-api';
+```
+
+---
+
+## 📲 Session Management
+
+```js
+await onimai.startSession('session1');
+await onimai.startSessionWithPairingCode('session2', {
+  phoneNumber: '491234567890'
+});
+const all = onimai.getAllSession();
+const one = onimai.getSession('session1');
+const loaded = await onimai.loadSessionsFromStorage();
+```
+
+---
+
+## 💬 Nachrichten senden (`sendMessage`)
+
+```js
+await onimai1.sendMessage(sessionId, jidOrPhone, content, options);
+```
+
+### ✨ Beispiele
+
+| 📨 Typ        | 📘 Beschreibung        | 🧾 Inhalt Beispiel |
+|--------------|------------------------|--------------------|
+| **Text**     | Klassische Nachricht   | `{ text: 'Hallo!' }` |
+| **Bild**     | Mit Caption            | `{ image: { url: './img.png' }, caption: 'Hey' }` |
+| **Video**    | Mit Caption            | `{ video: { url: './vid.mp4' }, caption: 'Clip' }` |
+| **GIF**      | Loop-Video             | `{ video: { url: './gif.mp4' }, gifPlayback: true }` |
+| **Audio**    | Sprachnachricht        | `{ audio: fs.createReadStream('voice.ogg'), mimetype: 'audio/ogg', ptt: true }` |
+| **Dokument** | PDF o.ä.               | `{ document: { url: './doc.pdf', filename: 'Beispiel.pdf' } }` |
+| **Umfrage**  | Poll erstellen         | `{ pollCreationMessage: { name: 'Frage?', options: [...], selectableCount: 1 } }` |
+| **Reaktion** | Emoji antworten        | `{ react: { text: '❤️', key: msg.key } }` |
+| **Löschen**  | Nachricht zurückziehen | `{ delete: msg.key }` |
+| **Pin**      | Nachricht anpinnen     | `{ pin: { type: 1, time: 3600, key: msg.key } }` |
+| **Kontakt**  | vCard teilen           | `{ contacts: { displayName: 'Max', contacts: [{ vcard }] } }` |
+| **Standort** | Map teilen             | `{ location: { degreesLatitude: 52.52, degreesLongitude: 13.405 } }` |
+| **Forward**  | Nachricht weiterleiten | `{ forward: origMsg }` |
+| **Status**   | Story posten           | `{ video: { url: 'story.mp4' }, caption: 'Mein Status' }` |
+
+---
+
+## 🔧 Spezialfunktionen (`relayMessage`)
+
+- **Nachricht löschen (Revoke)**  
+- **Ephemeral-Mode an/aus**  
+- **Status posten (Story)**  
+- **Weiterleiten**  
+- **Profilbild ändern**  
+- **Chat als gelesen markieren**  
+- **Custom Message IDs setzen**  
+
+➡️ Beispiele siehe Code im Repo – alle Funktionen sind out-of-the-box!  
+
+---
+
+## 🎧 Listener
+
+```js
+onimai.onConnected(id => console.log('✅ Online:', id));
+onimai.onQRUpdated(info => console.log('📲 QR-Code:', info));
+onimai.onMessageReceived(msg => console.log('📥 Nachricht:', msg));
+```
+
+---
+
+## 🚨 Fehlerbehandlung
+
+```js
+try {
+  await onimai1.sendMessage(...);
+} catch (e) {
+  console.error('⚠️ Fehler:', e);
+}
+```
+
+---
+
+## 👩‍💻 Autorin & Support
+
+© 2026 **@neelegirl/wa-api**  
+🌸 Made with Love by **Neele**  
+💌 Support: [neelehoven@gmail.com](mailto:neelehoven@gmail.com)  
+📚 Docs: [wa-api.org](https://wa-api.org)  
+
+---
+
+## 💖 Community
+
+Wir danken allen **schönen & treuen Usern**, die diese Library benutzen und supporten.  
+Euer Vertrauen macht dieses Projekt **LID** und einzigartig. ✨  
+
+---
+🌸 *Stay kawaii, stay connected – Onimai forever!* 🌸