@neelegirl/baileys 1.5.0 → 1.5.2

package/LICENSE

@@ -1,6 +1,6 @@
 MIT License
 
-Copyright (c) 2023 WhiskeySockets
+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

package/README.md

@@ -0,0 +1,187 @@
+
+<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>