@neelegirl/baileys 1.5.2 → 1.5.3

package/LICENSE

@@ -1,21 +1,21 @@
-MIT License
-
-Copyright (c) 2025 Neele
-
-Permission is hereby granted, free of charge, to any person obtaining a copy
-of this software and associated documentation files (the "Software"), to deal
-in the Software without restriction, including without limitation the rights
-to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-copies of the Software, and to permit persons to whom the Software is
-furnished to do so, subject to the following conditions:
-
-The above copyright notice and this permission notice shall be included in all
-copies or substantial portions of the Software.
-
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-SOFTWARE.
+MIT License
+
+Copyright (c) 2025 Neele
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,187 +1,195 @@
-
-<p align="center">
-  <img src="https://files.catbox.moe/68vl0n.jpg" width="720" alt="Neele Baileys Header" />
-</p>
-
-<h1 align="center">🌸 Willkommen bei <code>@neelegirl/baileys</code> 🌸</h1>
-<p align="center"><i>Eine charmante WhatsApp Web API für TypeScript/JavaScript – von einer Prinzessin für alle, die Magie lieben.</i></p>
-
-<div align="center">
-
-<img src="https://img.shields.io/github/downloads/neelegirl/baileys/total?label=Downloads%20%E2%AD%90" />
-<img src="https://img.shields.io/npm/dw/%40neelegirl%2Fbaileys?label=npm%20Downloads&color=pink" />
-<img src="https://img.shields.io/github/languages/code-size/neelegirl/baileys" />
-<img src="https://img.shields.io/github/license/neelegirl/baileys?color=lightpink" />
-<img src="https://img.shields.io/github/stars/neelegirl/baileys?label=GitHub%20Stars%20%E2%9D%A4" />
-<img src="https://img.shields.io/github/forks/neelegirl/baileys?label=Forks%20%E2%9C%A8" />
-<img src="https://img.shields.io/badge/Multi‑Device-Ready-ff6fb5" />
-<img src="https://img.shields.io/badge/LID‑Kompatibel-Yes-ff9ecf" />
-
-</div>
-
----
-
-## ❗ Wichtige Hinweise
-
-Dieses Projekt ist eine zarte Eigenkreation von **@neelegirl** – es steht in keiner offiziellen Verbindung zu WhatsApp.
-
-> ⚠️ Bitte benutze es **verantwortungsvoll**:  
-> ✖️ Kein Spam, keine Massennachrichten  
-> ✖️ Kein Missbrauch für unethische Zwecke  
-> ✔️ Stattdessen: Lasst uns **respektvoll Magie verbreiten**! 🌟
-
-💬 **Haftungshinweis:**  
-Die Entwickler:innen übernehmen keine Verantwortung für den Gebrauch. Lies die [MIT-Lizenz](https://github.com/neelegirl/baileys/blob/main/LICENSE) für Details.
-
----
-
-## 🧚‍♀️ Warum <code>@neelegirl/baileys</code>?
-
-✨ **Zauberhafte Vorteile**
-
-- 🧠 Ultra leichtgewichtig – keine Browser- oder Selenium-Monster nötig!
-- 🌈 Moderne **WebSocket-Magie** direkt, schnell & stabil
-- 💖 Vollständige **Multi‑Device** Unterstützung
-- 🧩 **LID‑kompatibel** (Linked ID Erkennung & Nutzung)
-- 🧷 Saubere TypeScript‑Typen, DX zum Verlieben
-
----
-
-## 🌈 Installation (Dein magisches Setup)
-
-Mit **yarn**:
-
-```bash
-yarn add @neelegirl/baileys
-```
-
-Mit **npm**:
-
-```bash
-npm i @neelegirl/baileys
-```
-
-Bleeding‑edge direkt von GitHub:
-
-```bash
-yarn add github:neelegirl/baileys
-# oder
-npm i github:neelegirl/baileys
-```
-
-**Import** – ganz leicht:
-```ts
-import makeWASocket, { useMultiFileAuthState, Browsers } from '@neelegirl/baileys'
-```
-
----
-
-## 🌸 Quickstart (inkl. LID‑Magic)
-
-Ein kurzer, süßer Start in deinen Zauberwald – mit QR‑Login, Auto‑Reconnect und LID‑Handling. 💫
-
-```ts
-import makeWASocket, {
-  useMultiFileAuthState,
-  DisconnectReason,
-  fetchLatestBaileysVersion,
-  jidDecode
-} from '@neelegirl/baileys'
-
-async function start() {
-  const { state, saveCreds } = await useMultiFileAuthState('./auth_neele')
-  const { version } = await fetchLatestBaileysVersion()
-
-  const sock = makeWASocket({
-    version,
-    auth: state,
-    browser: ['Neele Princess','Safari','1.0'],
-    printQRInTerminal: true, // Für Desktop-Dev – mobil gern mit UI scannen
-    markOnlineOnConnect: false,
-    syncFullHistory: false
-  })
-
-  // 💖 LID-kompatibel: extrahiere sichere Sender-IDs
-  const getSenderId = (m: any) => {
-    const participant = m?.key?.participant || m?.participant || m?.sender
-    const lid = participant || m?.key?.remoteJid
-    // Dekodiere LID/JID hübsch & sicher
-    const decoded = lid ? jidDecode(lid) : null
-    return decoded?.user ? `${decoded.user}@${decoded.server}` : (lid || 'anon')
-  }
-
-  sock.ev.on('messages.upsert', async ({ messages }) => {
-    const m = messages[0]
-    if (!m?.message) return
-
-    const from = m.key.remoteJid
-    const sender = getSenderId(m)
-
-    // 🎀 Kleiner Ping-Pong-Zauber
-    const body = m.message?.conversation
-      || m.message?.extendedTextMessage?.text
-      || m.message?.imageMessage?.caption
-      || ''
-
-    if (/^!ping$/i.test(body)) {
-      await sock.sendMessage(from, { text: '🏓 Pong! Neele‑Magic online ✨' }, { quoted: m })
-    }
-
-    // ✨ Sticker-Schnellzauber (antworte auf ein Bild)
-    if (/^!sticker$/i.test(body) && m.message?.imageMessage) {
-      const stream = await sock.downloadMediaMessage(m)
-      await sock.sendMessage(from, { sticker: stream }, { quoted: m })
-    }
-  })
-
-  sock.ev.on('creds.update', saveCreds)
-
-  sock.ev.on('connection.update', (u) => {
-    const { connection, lastDisconnect } = u
-    if (connection === 'close') {
-      const shouldReconnect =
-        (lastDisconnect?.error as any)?.output?.statusCode !== DisconnectReason.loggedOut
-      if (shouldReconnect) start()
-    } else if (connection === 'open') {
-      console.log('🌸 Verbunden – bereit zum Glitzern!')
-    }
-  })
-}
-
-start().catch(console.error)
-```
-
----
-
-## 🧁 Häufige Rezepte
-
-- 💌 **Nachrichten**: `sock.sendMessage(jid, { text: 'Hello 🌸' })`  
-- 📸 **Medien**: `sock.sendMessage(jid, { image: fs.readFileSync('pic.jpg'), caption: 'Kawaii!' })`  
-- 🎀 **Sticker**: Antwort auf `imageMessage` → `{ sticker: stream }`  
-- 👥 **Gruppen**: `sock.groupCreate('Neele Club', [user1, user2])`  
-- 🧲 **LID‑ID**: mit `jidDecode()` schön & sicher nutzen
-
----
-
-## 💠 LID‑Kompatibilität (Kurz erklärt)
-
-**LID (Linked ID)** sorgt dafür, dass Benutzer:innen auch über geräteübergreifende IDs korrekt erkannt werden.  
-Dieses Paket ist **voll LID‑kompatibel**:
-- Extraktion & Normalisierung von Absender‑IDs
-- Sicheres Antworten, auch wenn die Gegenstelle Geräte wechselt
-- Sanfte Fallbacks, wenn keine LID vorliegt
-
-> Ergebnis: stabilere Replies, weniger Rätselraten, mehr Glitzer ✨
-
----
-
-## ❤️ Credits & Danksagung
-
-Mit Liebe, Glitzer und rosa Codezeilen von **@neelegirl** erschaffen.  
-Wenn dir dieses Projekt gefällt:
-
-> ⭐ Gib ihm ein ⭐️ auf GitHub – das wär sooo süß! 🌟
-
----
-
-<p align="center"><i>✨ Möge dein Bot so bezaubernd sein wie ein Anime‑Mädchen mit Glitzeraugen ✨</i></p>
+<p align="center">
+  <img src="https://files.catbox.moe/68vl0n.jpg" width="720" alt="Neele Baileys Header" />
+</p>
+
+<h1 align="center">🌸 Willkommen bei <code>@neelegirl/baileys</code> 🌸</h1>
+<p align="center"><i>Eine charmante WhatsApp Web API für TypeScript/JavaScript – von einer Prinzessin für alle, die Magie lieben.</i></p>
+
+---
+
+<p align="center">
+  🌟 <b>Ja, jetzt ist es offiziell raus – offiziell lit!</b> 🌟<br/>
+  💫 <b>Offiziell out now: Version 1.5.3 – @Neelegirl/Baileys ist jetzt offiziell erhältlich!</b> 💫<br/>
+  Ihr müsst vielleicht ein kleines bisschen umändern und hier und da rumfischen,<br/>
+  aber keine Sorge – <b>Neele ist immer für euch da, Baby 💕</b><br/>
+  <sub><i>(Jetzt beginnt die Magie... powered by @neelegirl ✨)</i></sub>
+</p>
+
+---
+
+<div align="center">
+
+<img src="https://img.shields.io/github/downloads/neelegirl/baileys/total?label=Downloads%20%E2%AD%90" />
+<img src="https://img.shields.io/npm/dw/%40neelegirl%2Fbaileys?label=npm%20Downloads&color=pink" />
+<img src="https://img.shields.io/github/languages/code-size/neelegirl/baileys" />
+<img src="https://img.shields.io/github/license/neelegirl/baileys?color=lightpink" />
+<img src="https://img.shields.io/github/stars/neelegirl/baileys?label=GitHub%20Stars%20%E2%9D%A4" />
+<img src="https://img.shields.io/github/forks/neelegirl/baileys?label=Forks%20%E2%9C%A8" />
+<img src="https://img.shields.io/badge/Multi-Device-Ready-ff6fb5" />
+<img src="https://img.shields.io/badge/LID-Kompatibel-Yes-ff9ecf" />
+
+</div>
+
+---
+
+## ❗ Wichtige Hinweise
+
+Dieses Projekt ist eine zarte Eigenkreation von **@neelegirl** – es steht in keiner offiziellen Verbindung zu WhatsApp.
+
+> ⚠️ Bitte benutze es **verantwortungsvoll**:  
+> ✖️ Kein Spam, keine Massennachrichten  
+> ✖️ Kein Missbrauch für unethische Zwecke  
+> ✔️ Stattdessen: Lasst uns **respektvoll Magie verbreiten**! 🌟
+
+💬 **Haftungshinweis:**  
+Die Entwickler:innen übernehmen keine Verantwortung für den Gebrauch. Lies die [MIT-Lizenz](https://github.com/neelegirl/baileys/blob/main/LICENSE) für Details.
+
+---
+
+## 🧚‍♀️ Warum <code>@neelegirl/baileys</code>?
+
+✨ **Zauberhafte Vorteile**
+
+- 🧠 Ultra leichtgewichtig – keine Browser- oder Selenium-Monster nötig!
+- 🌈 Moderne **WebSocket-Magie** direkt, schnell & stabil
+- 💖 Vollständige **Multi-Device** Unterstützung
+- 🧩 **LID-kompatibel** (Linked ID Erkennung & Nutzung)
+- 🧷 Saubere TypeScript-Typen, DX zum Verlieben
+
+---
+
+## 🌈 Installation (Dein magisches Setup)
+
+Mit **yarn**:
+
+```bash
+yarn add @neelegirl/baileys
+```
+
+Mit **npm**:
+
+```bash
+npm i @neelegirl/baileys
+```
+
+Bleeding-edge direkt von GitHub:
+
+```bash
+yarn add github:neelegirl/baileys
+# oder
+npm i github:neelegirl/baileys
+```
+
+**Import** – ganz leicht:
+```ts
+import makeWASocket, { useMultiFileAuthState, Browsers } from '@neelegirl/baileys'
+```
+
+---
+
+## 🌸 Quickstart (inkl. LID-Magic)
+
+Ein kurzer, süßer Start in deinen Zauberwald – mit QR-Login, Auto-Reconnect und LID-Handling. 💫
+
+```ts
+import makeWASocket, {
+  useMultiFileAuthState,
+  DisconnectReason,
+  fetchLatestBaileysVersion,
+  jidDecode
+} from '@neelegirl/baileys'
+
+async function start() {
+  const { state, saveCreds } = await useMultiFileAuthState('./auth_neele')
+  const { version } = await fetchLatestBaileysVersion()
+
+  const sock = makeWASocket({
+    version,
+    auth: state,
+    browser: ['Neele Princess','Safari','1.0'],
+    printQRInTerminal: true, // Für Desktop-Dev – mobil gern mit UI scannen
+    markOnlineOnConnect: false,
+    syncFullHistory: false
+  })
+
+  // 💖 LID-kompatibel: extrahiere sichere Sender-IDs
+  const getSenderId = (m: any) => {
+    const participant = m?.key?.participant || m?.participant || m?.sender
+    const lid = participant || m?.key?.remoteJid
+    const decoded = lid ? jidDecode(lid) : null
+    return decoded?.user ? `${decoded.user}@${decoded.server}` : (lid || 'anon')
+  }
+
+  sock.ev.on('messages.upsert', async ({ messages }) => {
+    const m = messages[0]
+    if (!m?.message) return
+
+    const from = m.key.remoteJid
+    const sender = getSenderId(m)
+
+    const body = m.message?.conversation
+      || m.message?.extendedTextMessage?.text
+      || m.message?.imageMessage?.caption
+      || ''
+
+    if (/^!ping$/i.test(body)) {
+      await sock.sendMessage(from, { text: '🏓 Pong! Neele-Magic online ✨' }, { quoted: m })
+    }
+
+    if (/^!sticker$/i.test(body) && m.message?.imageMessage) {
+      const stream = await sock.downloadMediaMessage(m)
+      await sock.sendMessage(from, { sticker: stream }, { quoted: m })
+    }
+  })
+
+  sock.ev.on('creds.update', saveCreds)
+
+  sock.ev.on('connection.update', (u) => {
+    const { connection, lastDisconnect } = u
+    if (connection === 'close') {
+      const shouldReconnect =
+        (lastDisconnect?.error as any)?.output?.statusCode !== DisconnectReason.loggedOut
+      if (shouldReconnect) start()
+    } else if (connection === 'open') {
+      console.log('🌸 Verbunden – bereit zum Glitzern!')
+    }
+  })
+}
+
+start().catch(console.error)
+```
+
+---
+
+## 🧁 Häufige Rezepte
+
+- 💌 **Nachrichten**: `sock.sendMessage(jid, { text: 'Hello 🌸' })`  
+- 📸 **Medien**: `sock.sendMessage(jid, { image: fs.readFileSync('pic.jpg'), caption: 'Kawaii!' })`  
+- 🎀 **Sticker**: Antwort auf `imageMessage` → `{ sticker: stream }`  
+- 👥 **Gruppen**: `sock.groupCreate('Neele Club', [user1, user2])`  
+- 🧲 **LID-ID**: mit `jidDecode()` schön & sicher nutzen
+
+---
+
+## 💠 LID-Kompatibilität (Kurz erklärt)
+
+**LID (Linked ID)** sorgt dafür, dass Benutzer:innen auch über geräteübergreifende IDs korrekt erkannt werden.  
+Dieses Paket ist **voll LID-kompatibel**:
+- Extraktion & Normalisierung von Absender-IDs
+- Sicheres Antworten, auch wenn die Gegenstelle Geräte wechselt
+- Sanfte Fallbacks, wenn keine LID vorliegt
+
+> Ergebnis: stabilere Replies, weniger Rätselraten, mehr Glitzer ✨
+
+---
+
+## ❤️ Credits & Danksagung
+
+Mit Liebe, Glitzer und rosa Codezeilen von **@neelegirl** erschaffen.  
+Wenn dir dieses Projekt gefällt:
+
+> ⭐ Gib ihm ein ⭐️ auf GitHub – das wär sooo süß! 🌟
+
+---
+
+<p align="center"><i>✨ Möge dein Bot so bezaubernd sein wie ein Anime-Mädchen mit Glitzeraugen ✨</i></p>