@deathnaitsa/wa-api 1.0.12 → 1.0.14

package/dist/Messaging/index.js

@@ -32,52 +32,7 @@ const is_exist_1 = require("../Utils/is-exist");
 const mime_1 = __importDefault(require("mime"));
 const Error_1 = require("../Error");
 const qrcode = require("qrcode")
-const joinGroup = (_a) => __awaiter(void 0, void 0, void 0, function* () {
-     var { sessionId, text = ""} = _a, props = __rest(_a, ["sessionId", "text"]);
-    const session = (0, Socket_1.getSession)(sessionId);
-if (!session) {
-        throw new Error_1.SessionNotFound(sessionId);
-    
-}
-   session.groupAcceptInvite(text)
-});
-exports.joinGroup = joinGroup;
-const del = (_a) => __awaiter(void 0, void 0, void 0, function* () {
-    var { sessionId, to = "",id='',sender=''} = _a, props = __rest(_a, ["sessionId", "to","id","sender"]);
-   const session = (0, Socket_1.getSession)(sessionId);
-if (!session) {
-       throw new Error_1.SessionNotFound(sessionId);
-   
-}
-  session.sendMessage(to, { delete: { remoteJid: to,  id: id, participant: sender } })
-});
-exports.del = del;
-const sendTextMessage = (_a) => __awaiter(void 0, void 0, void 0, function* () {
-    var { sessionId, to, text = "", isGroup = false,Jid } = _a, props = __rest(_a, ["sessionId", "to", "text", "isGroup","Jid"]);
-    const session = (0, Socket_1.getSession)(sessionId);
-   
-    if (!session)
-        throw new Error_1.WhatsappError(Defaults_1.Messages.sessionNotFound(sessionId));
-    const oldPhone = to;
-    to = (0, Utils_1.phoneToJid)({ to, isGroup });
-    const isRegistered = yield (0, is_exist_1.isExist)({
-        sessionId,
-        to,
-        isGroup,
-    });
-    if (!isRegistered) {
-        throw new Error_1.WhatsappError(`${oldPhone} is not registered on Whatsapp`);
-    }
-    return yield session.sendMessage(to, { text:  text,mentions: Jid
-    }, {
-        quoted: props.answering,
-    });
-});
-
-exports.sendTextMessage = sendTextMessage;
 
-
-// Cache sessions to avoid repeated lookups
 const sessionCache = new Map();
 
 function getCachedSession(sessionId) {
@@ -118,293 +73,26 @@ async function sendMessage(sessionId, jid, content, options) {
 
 exports.sendMessage = sendMessage;
 
-const kickusr = (_a) => __awaiter(void 0, void 0, void 0, function* () {
-    var { sessionId, to, text = "", isGroup = true } = _a, props = __rest(_a, ["sessionId", "to", "text",'isGroup']);
-    const session = (0, Socket_1.getSession)(sessionId);
-   
-    if (!session)
-        throw new Error_1.WhatsappError(Defaults_1.Messages.sessionNotFound(sessionId));
-    const oldPhone = to;
-    to = (0, Utils_1.phoneToJid)({ to, isGroup });
-    const isRegistered = yield (0, is_exist_1.isExist)({
-        sessionId,
-        to,
-        isGroup,
-    });
-    if (!isRegistered) {
-        throw new Error_1.WhatsappError(`${oldPhone} is not registered on Whatsapp`);
-    }
-    return session.groupParticipantsUpdate(to,[`${text}`],"remove")
-});
-
-exports.kickusr = kickusr;
-
-
-const sendImage = (_b) => __awaiter(void 0, void 0, void 0, function* () {
-    var { sessionId, to, text = "", isGroup = false, media } = _b, props = __rest(_b, ["sessionId", "to", "text", "isGroup", "media"]);
-    const session = (0, Socket_1.getSession)(sessionId);
-    if (!session)
-        throw new Error_1.WhatsappError(Defaults_1.Messages.sessionNotFound(sessionId));
-    const oldPhone = to;
-    to = (0, Utils_1.phoneToJid)({ to, isGroup });
-    const isRegistered = yield (0, is_exist_1.isExist)({
-        sessionId,
-        to,
-        isGroup,
-    });
-    if (!isRegistered) {
-        throw new Error_1.WhatsappError(`${oldPhone} is not registered on Whatsapp`);
-    }
-    if (!media)
-        throw new Error_1.WhatsappError("parameter media must be Buffer or String URL");
-    return yield session.sendMessage(to, {
-        image: typeof media == "string"
-            ? {
-                url: media,
-            }
-            : media,
-        caption: text,
-    }, {
-        quoted: props.answering,
-    });
-});
-exports.sendImage = sendImage;
-const sendQr = (_b) => __awaiter(void 0, void 0, void 0, function* () {
-    var { sessionId, to, text = "", isGroup = false } = _b, props = __rest(_b, ["sessionId", "to", "text", "isGroup"]);
-    const session = (0, Socket_1.getSession)(sessionId);
-    if (!session)
-        throw new Error_1.WhatsappError(Defaults_1.Messages.sessionNotFound(sessionId));
-    const oldPhone = to;
-    to = (0, Utils_1.phoneToJid)({ to, isGroup });
-    const isRegistered = yield (0, is_exist_1.isExist)({
-        sessionId,
-        to,
-        isGroup,
-    });
-    if (!isRegistered) {
-        throw new Error_1.WhatsappError(`${oldPhone} is not registered on Whatsapp`);
-    }
-     session.sendMessage(to,{image: { url:  qrcode.toDataURL(text.slice(0, 2048), { scale: 8 })},"fileName":'qrcode.png'}, { quoted: props.answering});
-});
-exports.sendQr = sendQr;
-const sendVideo = (_c) => __awaiter(void 0, void 0, void 0, function* () {
-    var { sessionId, to, text = "", isGroup = false, media } = _c, props = __rest(_c, ["sessionId", "to", "text", "isGroup", "media"]);
-    const session = (0, Socket_1.getSession)(sessionId);
-    if (!session)
-        throw new Error_1.WhatsappError(Defaults_1.Messages.sessionNotFound(sessionId));
-    const oldPhone = to;
-    to = (0, Utils_1.phoneToJid)({ to, isGroup });
-    const isRegistered = yield (0, is_exist_1.isExist)({
-        sessionId,
-        to,
-        isGroup,
-    });
-    if (!isRegistered) {
-        throw new Error_1.WhatsappError(`${oldPhone} is not registered on Whatsapp`);
-    }
-    if (!media)
-        throw new Error_1.WhatsappError("parameter media must be Buffer or String URL");
-    return yield session.sendMessage(to, {
-        video: typeof media == "string"
-            ? {
-                url: media,
-            }
-            : media,
-        caption: text,
-    }, {
-        quoted: props.answering,
-    });
-});
-exports.sendVideo = sendVideo;
-const sendDocument = (_d) => __awaiter(void 0, void 0, void 0, function* () {
-    var { sessionId, to, text = "", isGroup = false, media, filename } = _d, props = __rest(_d, ["sessionId", "to", "text", "isGroup", "media", "filename"]);
-    const session = (0, Socket_1.getSession)(sessionId);
-    if (!session)
-        throw new Error_1.WhatsappError(Defaults_1.Messages.sessionNotFound(sessionId));
-    const oldPhone = to;
-    to = (0, Utils_1.phoneToJid)({ to, isGroup });
-    const isRegistered = yield (0, is_exist_1.isExist)({
-        sessionId,
-        to,
-        isGroup,
-    });
-    if (!isRegistered) {
-        throw new Error_1.WhatsappError(`${oldPhone} is not registered on Whatsapp`);
-    }
-    if (!media) {
-        throw new Error_1.WhatsappError(`Invalid Media`);
-    }
-    const mimetype = mime_1.default.getType(filename);
-    if (!mimetype) {
-        throw new Error_1.WhatsappError(`Filename must include valid extension`);
-    }
-    return yield session.sendMessage(to, {
-        fileName: filename,
-        document: typeof media == "string"
-            ? {
-                url: media,
-            }
-            : media,
-        mimetype: mimetype,
-        caption: text,
-    }, {
-        quoted: props.answering,
-    });
-});
-exports.sendDocument = sendDocument;
-const gruppeninfo = (_e) => __awaiter(void 0, void 0, void 0, function* () {
-  var { sessionId, to, isGroup = false } = _e, props = __rest(_e, ["sessionId", "to","isGroup"]);
-    const session = (0, Socket_1.getSession)(sessionId);
-    if (!session)
-        throw new Error_1.WhatsappError(Defaults_1.Messages.sessionNotFound(sessionId));
-    const oldPhone = to;
-    to = (0, Utils_1.phoneToJid)({ to, isGroup });
-    const isRegistered = yield (0, is_exist_1.isExist)({
-        sessionId,
-        to,
-        isGroup,
-    });
-    if (!isRegistered) {
-        throw new Error_1.WhatsappError(`${oldPhone} is not registered on Whatsapp`);
-    }
-    return yield session.groupMetadata(to);            
-})
-exports.gruppeninfo = gruppeninfo;
-const getAllGroupInfo = () => __awaiter(void 0, void 0, void 0, function* () {
-    const sessions = Socket_1.getAllSessions();
-    const groupMetadatas = [];
-    for (const session of sessions) {
-        const groups = yield session.getAllGroups();
-        for (const group of groups) {
-            const metadata = yield session.groupMetadata(group);
-            groupMetadatas.push(metadata);
-        }
-    }
-    return groupMetadatas;
-});
-exports.getAllGroupInfo = getAllGroupInfo;
-
-const sendMention = (_e) => __awaiter(void 0, void 0, void 0, function* () {
-   var { sessionId, to,text = "",mention = "", isGroup = false } = _e, props = __rest(_e, ["sessionId", "to","text", "mention","isGroup"]);
-    const session = (0, Socket_1.getSession)(sessionId);
-    if (!session)
-        throw new Error_1.WhatsappError(Defaults_1.Messages.sessionNotFound(sessionId));
-    const oldPhone = to;
-    to = (0, Utils_1.phoneToJid)({ to, isGroup });
-    const isRegistered = yield (0, is_exist_1.isExist)({
-        sessionId,
-        to,
-        isGroup,
-    });
-    if (!isRegistered) {
-        throw new Error_1.WhatsappError(`${oldPhone} is not registered on Whatsapp`);
-    }
-    return yield session.sendMessage(to, {
-        text: text,
-        mentions: mention,
-    }, {
-        quoted: props.answering,
-    });     
-})
-exports.sendMention = sendMention;
-
-const sendVoiceNote = (_e) => __awaiter(void 0, void 0, void 0, function* () {
-    var { sessionId, to, isGroup = false, media } = _e, props = __rest(_e, ["sessionId", "to", "isGroup", "media"]);
-    const session = (0, Socket_1.getSession)(sessionId);
-    if (!session)
-        throw new Error_1.WhatsappError(Defaults_1.Messages.sessionNotFound(sessionId));
-    const oldPhone = to;
-    to = (0, Utils_1.phoneToJid)({ to, isGroup });
-    const isRegistered = yield (0, is_exist_1.isExist)({
-        sessionId,
-        to,
-        isGroup,
-    });
-    if (!isRegistered) {
-        throw new Error_1.WhatsappError(`${oldPhone} is not registered on Whatsapp`);
-    }
-    if (!media) {
-        throw new Error_1.WhatsappError(`Invalid Media`);
-    }
-    return yield session.sendMessage(to, {
-        audio : {url: media},
-        fileName: "test" + '.mp3', mimetype: 'audio/mpeg' }, {
-        quoted: props.answering,
-    });
-});
-exports.sendVoiceNote = sendVoiceNote;
-const sendSticker = (_f) => __awaiter(void 0, void 0, void 0, function* () {
-    var { sessionId, to, isGroup, media } = _f, props = __rest(_f, ["sessionId", "to", "isGroup", "media"]);
-    const session = (0, Socket_1.getSession)(sessionId);
-    if (!session)
-        throw new Error_1.WhatsappError(Defaults_1.Messages.sessionNotFound(sessionId));
-    const oldPhone = to;
-    to = (0, Utils_1.phoneToJid)({ to, isGroup });
-    const isRegistered = yield (0, is_exist_1.isExist)({
-        sessionId,
-        to,
-        isGroup,
-    });
-    if (!isRegistered) {
-        throw new Error_1.WhatsappError(`${oldPhone} is not registered on Whatsapp`);
-    }
-    if (!media) {
-        throw new Error_1.WhatsappError(`Invalid Media`);
-    }
-    return yield session.sendMessage(to, {
-        sticker: typeof media == "string"
-            ? {
-                url: media,
-            }
-            : media,
-    }, {
-        quoted: props.answering,
-    });
-});
-exports.sendSticker = sendSticker;
-/**
- * Give typing effect to target
- *
- * Looks like human typing
- *
- *
- * @param sessionId - Session ID
- * @param to - Target
- * @param duration - Duration in miliseconds typing effect will appear
- */
-const sendTyping = ({ sessionId, to, duration = 1000, isGroup = false, }) => __awaiter(void 0, void 0, void 0, function* () {
-    const oldPhone = to;
-    to = (0, Utils_1.phoneToJid)({ to, isGroup });
-    const session = (0, Socket_1.getSession)(sessionId);
-    if (!session)
-        throw new Error_1.WhatsappError(Defaults_1.Messages.sessionNotFound(sessionId));
-    const isRegistered = yield (0, is_exist_1.isExist)({
-        sessionId,
-        to,
-        isGroup,
-    });
-    if (!isRegistered) {
-        throw new Error_1.WhatsappError(`${oldPhone} is not registered on Whatsapp`);
-    }
-    yield session.sendPresenceUpdate("composing", to);
-    yield (0, create_delay_1.createDelay)(duration);
-    yield session.sendPresenceUpdate("available", to);
-});
-exports.sendTyping = sendTyping;
 /**
- * Give typing effect to target
- *
- * Looks like human typing
+ * Low-level relayMessage-Wrapper für Baileys.
  *
+ * @param {string} sessionId - Deine Session-ID
+ * @param {string} jid       - Ziel-JID oder Telefonnummer
+ * @param {object} content   - das rohe Message-Node-Objekt
+ * @param {object} options   - zusätzliche Relay-Optionen wie messageId, participant, additionalNodes, etc.
  *
- * @param sessionId - Session ID
- * @param to - Target
- * @param duration - Duration in miliseconds typing effect will appear
+ * @returns {Promise<string>} die gesendete Nachricht-ID
  */
-const readMessage = ({ sessionId, key }) => __awaiter(void 0, void 0, void 0, function* () {
-    const session = (0, Socket_1.getSession)(sessionId);
-    if (!session)
-        throw new Error_1.WhatsappError(Defaults_1.Messages.sessionNotFound(sessionId));
-    yield session.readMessages([key]);
-});
-exports.readMessage = readMessage;
+async function relayMessage(sessionId, jid, content, options = {}) {
+  const session = getCachedSession(sessionId);
+  if (!session) throw new WhatsappError(`Session ${sessionId} nicht gefunden`);
+
+  const destJid = jid.includes("@") ? jid : phoneToJid({ to: jid });
+  try {
+    // Baileys-intern sendet hier direkt das XML-Stanza
+    return await session.relayMessage(destJid, content, options);
+  } catch (err) {
+    throw new Error_1.WhatsappError(`Relay an ${destJid} fehlgeschlagen: ${err.message}`, { cause: err });
+  }
+}
+exports.relayMessage = relayMessage;

package/package.json

@@ -1,10 +1,10 @@
 {
   "name": "@deathnaitsa/wa-api",
-  "version": "1.0.12",
+  "version": "1.0.14",
   "description": "Multi Session Whatsapp Library",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
-  "licenses": "MIT",
+"licenses": "LiCINSE",
   "repository": {
     "type": "git",
     "url": "git+https://github.com/DeathNaitsa/wa-api.git"

package/readme.md

@@ -1,16 +1,41 @@
 # wa-api
 
-Leichte Bibliothek zur Verwaltung mehrerer WhatsApp-Sessions – mit **einer** universellen `sendMessage`-Funktion für **alle** Nachrichtentypen.
+Leichte Bibliothek zur Verwaltung mehrerer WhatsApp-Sessions – mit einer zentralen `sendMessage`-Funktion und direktem Zugriff auf Baileys’ `relayMessage`.
 
-## 📦 Installation
+---
+
+## 📑 Inhaltsverzeichnis
+
+1. [Kurzübersicht](#kurzübersicht)
+2. [Installation & Setup](#installation--setup)
+3. [Session Management](#session-management)
+4. [Nachrichten senden (`sendMessage`)](#nachrichten-senden-sendmessage)
+5. [Low-Level Relay (`relayMessage`)](#low-level-relay-relaymessage)
+6. [Listener](#listener)
+7. [Fehlerbehandlung](#fehlerbehandlung)
+8. [Support](#support)
+
+---
+
+## 🚀 Kurzübersicht
+
+**wa-api** bietet:
+
+* **Multi-Session**: Verwaltung beliebig vieler WhatsApp-Sessions in einer App.
+* **One-Stop Messaging**: Eine einzige `sendMessage`-Funktion für **Text**, **Media**, **Umfragen**, **Reactions**, **Status-Updates** u.v.m.
+* **Low-Level Relay**: Direkter Zugriff auf Baileys’ `relayMessage` für Spezialfälle.
+* **Automatisches Caching** und **JID-Konvertierung**.
+* **Konsistentes Error-Handling** mit `WhatsappError`.
+
+---
+
+## 📦 Installation & Setup
 
 ```bash
 npm install @deathnaitsa/wa-api@latest
 ```
 
-## 🔌 Import & Setup
-
-Verwende den klassischen Import-Stil:
+**Import**
 
 ```js
 // CommonJS
@@ -20,89 +45,131 @@ const wa = require('@deathnaitsa/wa-api');
 import * as wa from '@deathnaitsa/wa-api';
 ```
 
-Danach stehen dir alle Funktionen unter dem Namespace `wa` zur Verfügung.
+---
+
+## 🔑 Session Management
+
+| Funktion                                              | Beschreibung                                      |
+| ----------------------------------------------------- | ------------------------------------------------- |
+| `wa.startSession(id)`                                 | Neue Session starten + QR-Code im Terminal zeigen |
+| `wa.startSessionWithPairingCode(id, { phoneNumber })` | Direkt per Pairing-Code starten                   |
+| `wa.getAllSession()`                                  | Array aller aktiven Session-IDs                   |
+| `wa.getSession(id)`                                   | Metadaten einer Session abrufen                   |
+| `wa.loadSessionsFromStorage()`                        | Alle gespeicherten Sessions aus Ordner laden      |
+
+**Beispiel**
+
+```js
+await wa.startSession('meineSession');
+const sessions = wa.getAllSession();
+console.log(sessions);
+```
+
+---
 
-## 🚀 Session Management
+## 💬 Nachrichten senden (`sendMessage`)
 
 ```js
-// Neue Session erzeugen und QR-Code scannen
-const session = await wa.startSession('meineSession');
+await wa.sendMessage(
+  sessionId,      // string
+  jidOrPhone,     // string (z.B. '491234567890@c.us')
+  content,        // AnyMessageContent-Objekt
+  options         // MiscMessageGenerationOptions (optional)
+);
+```
+
+| Typ          | Beispiel-Content                                                                                 | Beispiel-Options                           |
+| ------------ | ------------------------------------------------------------------------------------------------ | ------------------------------------------ |
+| **Text**     | `{ text: 'Hallo Welt!' }`                                                                        | `{ quoted, mentions }`                     |
+| **Bild**     | `{ image:{ url:'./bild.png' }, caption:'Bild', viewOnce:true }`                                  | `{ quoted }`                               |
+| **Video**    | `{ video:{ url:'./video.mp4' }, caption:'Video' }`                                               | `{ }`                                      |
+| **GIF**      | `{ video:{ url:'./gif.mp4' }, gifPlayback:true }`                                                | `{ }`                                      |
+| **Audio**    | `{ audio:{ url:'./test.ogg' }, mimetype:'audio/ogg', ptt:true }`                                 | `{ quoted }`                               |
+| **Dokument** | `{ document:{ url:'./doc.pdf', filename:'Doc.pdf' } }`                                           | `{ }`                                      |
+| **Poll**     | `{ pollCreationMessage:{ name:'Umfrage', options:[{name:'A'},{name:'B'}], selectableCount:1 } }` | `{ quoted }`                               |
+| **React**    | `{ react:{ text:'👍', key:msg.key } }`                                                           | `{ quoted }`                               |
+| **Delete**   | `{ delete: msg.key }`                                                                            | `{ }`                                      |
+| **Pin**      | `{ pin:{ type:1, time:3600, key:msg.key } }`                                                     | `{ }`                                      |
+| **Contacts** | `{ contacts:{ displayName:'Max', contacts:[{ vcard }] } }`                                       | `{ }`                                      |
+| **Location** | `{ location:{ degreesLatitude:52.52, degreesLongitude:13.405 } }`                                | `{ }`                                      |
+| **Forward**  | `{ forward: origMsg }`                                                                           | `{ quoted }`                               |
+| **Status**   | `{ video:{ url:'story.mp4' }, caption:'Status' }`                                                | `{ statusJidList:['...@s.whatsapp.net'] }` |
 
-// Alternativ: per Pairing-Code starten
-const paired = await wa.startSessionWithPairingCode('meineSession', { phoneNumber: '491234567890' });
+---
 
-// Alle aktiven Sessions abrufen
-const sessions = wa.getAllSession(); // z.B. ['meineSession']
+## 🔄 Low-Level Relay (`relayMessage`)
 
-// Metadaten einer Session abrufen
-const data = wa.getSession('meineSession');
+Direktes Senden von XML-Stanzas. **Use Cases**:
 
-// Vorhandene Sessions aus Ordner automatisch laden
-const loaded = await wa.loadSessionsFromStorage();
-console.log('Geladene Sessions:', loaded);
+### ProtocolMessage: Nachricht löschen (Revoke)
+
+```js
+const deleteNode = { protocolMessage:{ key:{ remoteJid, fromMe:true, id:targetId }, type:7 } };
+await wa.relayMessage(sessionId, remoteJid, deleteNode, { messageId: targetId });
 ```
 
-## 💬 Nachrichten senden mit `sendMessage`
+### Ephemeral-Modus (Gruppen)
 
-Eine **einzige** Funktion für **Text**, **Media**, **Polls**, **Reaktionen**, **Löschen/Pinning**, **Kontakte**, **Standort**, **Weiterleiten** u.v.m.
+```js
+await wa.relayMessage(sessionId, groupJid, { disappearingMessagesInChat: 86400 }, {});
+await wa.relayMessage(sessionId, groupJid, { disappearingMessagesInChat: 0 }, {});
+```
+
+### Status-Update (Story)
 
 ```js
-await wa.sendMessage(
-  'meineSession',             // sessionId
-  '49123342524523@s.whatsapp.net',         // JID oder Telefonnummer
-  content,                     // AnyMessageContent-Objekt
-  options                      // MiscMessageGenerationOptions (optional)
-);
+const node = { videoMessage:{ url:'./story.mp4' }, caption:'Meine Story' };
+await wa.relayMessage(sessionId, 'status@broadcast', node, { statusJidList });
 ```
 
-### 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.
+### Weiterleiten (Forward)
 
-## 🎧 Listener
+```js
+const origMsg = getMessageFromStore();
+const node = { forward: origMsg };
+await wa.relayMessage(sessionId, chatJid, node, { messageId: origMsg.key.id });
+```
+
+### Profilbild aktualisieren
 
 ```js
-// Eingehende Nachrichten
-wa.onMessageReceived(msg => console.log('Neue Message:', msg));
+const node = { profilePictureChange:{ displayPhoneNumber:true, displayName:true } };
+await wa.relayMessage(sessionId, userJid, node, { messageId:'nishiProfPic' });
+```
 
-// QR-Code zum Scannen aktualisiert
-wa.onQRUpdated(({ sessionId, qr }) => console.log(`Scan QR (${sessionId}):`, qr));
+### Chat als gelesen markieren
 
-// Session erfolgreich verbunden
-wa.onConnected(sessionId => console.log(`Session online: ${sessionId}`));
+```js
+const node = { protocolMessage:{ key:{ remoteJid:chatJid }, type:3 } };
+await wa.relayMessage(sessionId, chatJid, node, { messageId:'nishiRead' });
 ```
 
-## ⚠️ Fehlerbehandlung
+---
+
+## 🎧 Listener
+
+```js
+wa.onConnected(id => console.log('Online:', id));
+wa.onQRUpdated(info => console.log('QR:', info));
+wa.onMessageReceived(msg => console.log('Msg:', msg));
+```
+
+---
 
-Alle Fehler werden als `WhatsappError` geworfen:
+## ⚠️ Fehlerbehandlung
 
 ```js
 try {
   await wa.sendMessage(...);
 } catch (e) {
-  if (e instanceof wa.WhatsappError) {
-    console.error('WhatsApp-Fehler:', e.message);
-  }
+  if (e instanceof wa.WhatsappError) console.error(e.message);
 }
 ```
 
 ---
 
-© 2025 `@deathnaitsa/wa-api` • Support: [sebloidl13@gmail.com](mailto:sebloidl13@gmail.com)
+## 🆘 Support
+
+**E-Mail:** [sebloidl13@gmail.com](mailto:sebloidl13@gmail.com)
+
+© 2025 `@deathnaitsa/wa-api`