@neelegirl/baileys

🌸 Willkommen bei @neelegirl/baileys 🌸

Eine charmante WhatsApp Web API für TypeScript/JavaScript – von einer Prinzessin für alle, die Magie lieben.

🌟 Ja, jetzt ist es offiziell raus – offiziell lit! 🌟
💫 Offiziell out now: Version 1.5.6 – @Neelegirl/Baileys ist jetzt offiziell erhältlich! 💫
Ihr müsst vielleicht ein kleines bisschen umändern und hier und da rumfischen,
aber keine Sorge – Neele ist immer für euch da, Baby 💕
_{(Jetzt beginnt die Magie... powered by @neelegirl ✨)}

❗ 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 für Details.

🧚‍♀️ Warum @neelegirl/baileys?

✨ 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:

yarn add @neelegirl/baileys

Mit npm:

npm i @neelegirl/baileys

Bleeding-edge direkt von GitHub:

yarn add github:neelegirl/baileys
# oder
npm i github:neelegirl/baileys

Import – ganz leicht:

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. 💫

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üß! 🌟

✨ Möge dein Bot so bezaubernd sein wie ein Anime-Mädchen mit Glitzeraugen ✨