@deathnaitsa/wa-api 1.0.11 → 1.0.13

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.11",
+  "version": "1.0.13",
   "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,108 +1,209 @@
 # 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** universellen `sendMessage`-Funktion und direkter `relayMessage`-Unterstützung für alle fortgeschrittenen Szenarien.
+
+---
+
+## 📑 Inhaltsverzeichnis
+
+1. [Installation](#installation)
+2. [Import & Setup](#import--setup)
+3. [Session Management](#session-management)
+4. [Nachrichten senden via `sendMessage`](#nachrichten-senden-via-sendmessage)
+5. [Low-level `relayMessage` Beispiele](#low-level-relaymessage-beispiele)
+
+   * [ProtocolMessage: Nachricht löschen (Revoke)](#protocolmessage-nachricht-löschen-revoke)
+   * [Ephemeral-Modus (Gruppen)](#ephemeral-modus-gruppen)
+   * [Status-Update (Story)](#status-update-story)
+   * [Weiterleiten (Forward)](#weiterleiten-forward)
+   * [Profilbild aktualisieren](#profilbild-aktualisieren)
+   * [Chat als gelesen markieren](#chat-als-gelesen-markieren)
+6. [Listener](#listener)
+7. [Fehlerbehandlung](#fehlerbehandlung)
+
+---
 
 ## 📦 Installation
 
 ```bash
-npm install @deathnaitsa/baileys@latest
+npm install @deathnaitsa/wa-api@latest
 ```
 
 ## 🔌 Import & Setup
 
-Verwende den klassischen Import-Stil:
-
 ```js
 // CommonJS
-const wa = require('@deathnaitsa/baileys');
+const wa = require('@deathnaitsa/wa-api');
 
 // ES Module
-import * as wa from '@deathnaitsa/baileys';
+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');
+await wa.startSession('session1');
+await wa.startSessionWithPairingCode('session2', { phoneNumber: '491234567890' });
+const all = wa.getAllSession();
+const one = wa.getSession('session1');
+const loaded = await wa.loadSessionsFromStorage();
+```
+
+## 💬 Nachrichten senden via `sendMessage`
+
+Eine **zentrale** Funktion für **alle** Nachrichtentypen:
+
+```js
+await wa.sendMessage(
+  sessionId,      // Session-ID
+  jidOrPhone,     // JID oder Telefonnummer
+  content,        // AnyMessageContent
+  options         // MiscMessageGenerationOptions
+);
+```
 
-// Alternativ: per Pairing-Code starten
-const paired = await wa.startSessionWithPairingCode('meineSession', { phoneNumber: '491234567890' });
+### Beispiele
+
+| Typ            | Kurzbeschreibung           | content                                                                                      | options                       |
+| -------------- | -------------------------- | -------------------------------------------------------------------------------------------- | ----------------------------- |
+| Text           | Normale Textnachricht      | `{ text: 'Hallo Welt!' }`                                                                    | `{ quoted, mentions }`        |
+| Bild           | Sende Bild                 | `{ image:{url:'./img.png'},caption:'Bild',viewOnce:true }`                                   | `{ quoted }`                  |
+| Video          | Sende Video                | `{ video:{url:'./vid.mp4'},caption:'Video' }`                                                | `{ }`                         |
+| GIF            | Sende GIF (MP4 + Playback) | `{ video:{url:'./gif.mp4'},gifPlayback:true }`                                               | `{ }`                         |
+| Audio          | Voice Note (OGG/Opus)      | `{ audio: fs.createReadStream('test.ogg'),mimetype:'audio/ogg',ptt:true }`                   | `{ quoted }`                  |
+| Dokument       | Datei                      | `{ document:{url:'./doc.pdf',filename:'Doc.pdf'} }`                                          | `{ }`                         |
+| Poll           | Umfrage                    | `{ pollCreationMessage:{name:'Umfrage',options:[{name:'A'},{name:'B'}],selectableCount:1} }` | `{ quoted }`                  |
+| React          | Emoji-Reaktion             | `{ react:{text:'👍',key:msg.key} }`                                                          | `{ quoted }`                  |
+| Delete         | Löschen (Revoke)           | `{ delete: msg.key }`                                                                        | `{ }`                         |
+| Pin            | Pin/Unpin                  | `{ pin:{type:1,time:3600,key:msg.key} }`                                                     | `{ }`                         |
+| Contacts       | Kontaktkarte               | `{ contacts:{displayName:'Max',contacts:[{vcard}] } }`                                       | `{ }`                         |
+| Location       | Standort                   | `{ location:{degreesLatitude:52.52,degreesLongitude:13.405} }`                               | `{ }`                         |
+| Forward        | Weiterleiten               | `{ forward: origMsg }`                                                                       | `{ quoted }`                  |
+| Status (Story) | Status-Update              | `{ video:{url:'story.mp4'},caption:'Status' }`                                               | `{ statusJidList:[...JIDs] }` |
 
-// Alle aktiven Sessions abrufen
-const sessions = wa.getAllSession(); // z.B. ['meineSession']
+---
 
-// Metadaten einer Session abrufen
-const data = wa.getSession('meineSession');
+## 🔄 Low-level `relayMessage` Beispiele
 
-// Vorhandene Sessions aus Ordner automatisch laden
-const loaded = await wa.loadSessionsFromStorage();
-console.log('Geladene Sessions:', loaded);
+Direktes Senden von WAMessage-Stanzas für Spezialfälle.
+
+### ProtocolMessage: Nachricht löschen (Revoke)
+
+```js
+const deleteNode = {
+  protocolMessage: {
+    key: { remoteJid: chatJid, fromMe: true, id: targetId },
+    type: 7 // MESSAGE_REVOKE
+  }
+};
+await wa.relayMessage(
+  sessionId,
+  chatJid,
+  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
+// 24h Ephemeral ein
+await wa.relayMessage(
+  sessionId,
+  groupJid,
+  { disappearingMessagesInChat: Defaults.WA_DEFAULT_EPHEMERAL },
+  {}
+);
+// Ephemeral aus
+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 storyNode = {
+  videoMessage: { url: './story.mp4' },
+  caption: 'Meine Story' 
+};
+await wa.relayMessage(
+  sessionId,
+  'status@broadcast',
+  storyNode,
+  { statusJidList: ['491234567890@s.whatsapp.net'] }
 );
 ```
 
-### 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 forwardNode = { forward: origMsg };
+await wa.relayMessage(
+  sessionId,
+  chatJid,
+  forwardNode,
+  { messageId: origMsg.key.id }
+);
+```
+
+### Profilbild aktualisieren
 
 ```js
-// Eingehende Nachrichten
-wa.onMessageReceived(msg => console.log('Neue Message:', msg));
+const updateNode = {
+  profilePictureChange: {
+    displayPicture: fs.readFileSync('./newprofile.jpg')
+  }
+};
+await wa.relayMessage(
+  sessionId,
+  userJid,
+  updateNode,
+  { messageId: 'nishiProfileUpdate' }
+);
+```
 
-// 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 readNode = {
+  protocolMessage: {
+    key: { remoteJid: chatJid },
+    type: 3 // READ 
+  }
+};
+await wa.relayMessage(
+  sessionId,
+  chatJid,
+  readNode,
+  { messageId: 'nishiMarkRead' }
+);
 ```
 
-## ⚠️ Fehlerbehandlung
+---
+
+## 🎧 Listener
+
+```js
+wa.onConnected(id => console.log('Online:', id));
+wa.onQRUpdated(info => console.log('QR:', info));
+wa.onMessageReceived(msg => console.log('Nachricht:', 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);
-  }
+} catch(e) {
+  console.error(e);
 }
 ```
 
 ---
 
-© 2025 `@deathnaitsa/baileys` • Support: [sebloidl13@gmail.com](mailto:sebloidl13@gmail.com)
+© 2025 `@deathnaitsa/wa-api` • Support: [sebloidl13@gmail.com](mailto:sebloidl13@gmail.com)