🌸 @neelegirly/baileys 🌸

Die WhatsApp Web API mit sauberem Neelegirly-Glow-up

QR Branding · Wrapper-Aware Update Notify · LID · Smart Queue

Installation · Quickstart · Highlights · QR Branding · Migration · Release Notes

Neelegirlys Variante von Baileys ist die WhatsApp-Web-Basis für stabile Bots, schöne QR-Flows und einen sauber gepinnten Multi-Session-Stack. Die Library bleibt nah an Baileys, aber mit fokussiertem Branding, Update-Notify und Begleit-Ökosystem für @neelegirly/wa-api.

Hinweis: Dieses Projekt ist nicht offiziell mit WhatsApp, Meta oder Baileys-Upstream verbunden.

✨ Highlights

| Feature | Beschreibung | Status | | --- | --- | --- | | 💖 Multi-Device API | WhatsApp Web auf Node.js mit Event-Flow | ✅ | | 📷 QR Branding | Header/Footer + Wrapper-/Versionskontext direkt im QR-Flow | ✅ | | 🔔 Wrapper-Aware Update Notify | Status für Baileys und optionalen Wrapper-Kontext | ✅ | | 🚀 Smart Queue | Retries, Prioritäten und Bulk-Sending für produktive Setups | ✅ | | 🧷 LID / Session-Fokus | passend für moderne Multi-Device-/Linked-ID-Flows | ✅ | | 🎀 Neelegirly Scope | sauber auf @neelegirly/* ausgerichtet | ✅ |

🆕 Was sich in v2.2.18 geändert hat

• ✅ QR-Branding zeigt den Baileys- und Wrapper-Status jetzt klarer als up to date oder update available
• ✅ Wrapper-Hinweise werden nur noch angezeigt, wenn wirklich ein Update vorhanden ist
• ✅ Companion-Stack auf @neelegirly/wa-api 1.8.0 abgestimmt
• ✅ README auf den neuen Release- und Update-Notify-Stand gebracht

📦 Kompatibilität

| Paket | Empfohlene Version | | --- | --- | | @neelegirly/baileys | 2.2.18 | | @neelegirly/wa-api | 1.8.0 | | @neelegirly/libsignal | 1.0.28 |

🚀 Installation

npm

npm install @neelegirly/[email protected] @neelegirly/[email protected] --save-exact

yarn

yarn add @neelegirly/[email protected] @neelegirly/[email protected] --exact

pnpm

pnpm add @neelegirly/[email protected] @neelegirly/[email protected] --save-exact

Für den kompletten Neelegirly-Stack passt dazu @neelegirly/[email protected].

⚡ Quickstart

import makeWASocket, {
  useMultiFileAuthState,
  fetchLatestBaileysVersion,
  DisconnectReason,
  Browsers
} from '@neelegirly/baileys'

async function start() {
  const { state, saveCreds } = await useMultiFileAuthState('./auth')
  const { version } = await fetchLatestBaileysVersion()

  const sock = makeWASocket({
    auth: state,
    version,
    browser: Browsers.ubuntu('Chrome'),
    printQRInTerminal: true
  })

  sock.ev.on('creds.update', saveCreds)

  sock.ev.on('connection.update', ({ connection, lastDisconnect }) => {
    if (connection === 'open') {
      console.log('Verbunden 💖')
      return
    }

    if (connection === 'close') {
      const statusCode = lastDisconnect?.error?.output?.statusCode
      const isLoggedOut = statusCode === DisconnectReason.loggedOut

      if (!isLoggedOut) start().catch(console.error)
    }
  })
}

start().catch(console.error)

Direktes sock.ev.on('creds.update', saveCreds) ist für kleine Demos okay. In produktiven Multi-Session-Setups sollten Credential-Saves gebündelt oder debounced werden.

🧩 Companion Stack

| Paket | Rolle | |------|-------| | @neelegirly/baileys 2.2.18 | Socket, Events, Messaging | | @neelegirly/libsignal 1.0.28 | Signal-Protokoll-Komponente | | @neelegirly/wa-api 1.8.0 | Lifecycle-, Session- und Update-Wrapper |

🩷 QR Branding & Update Status

Beim QR-Scan werden automatisch Markenzeilen oberhalb und unterhalb des QR-Codes ausgegeben. Die Ausgabe liest Versionen dynamisch aus package.json, verarbeitet Update-Status robust und kann zusätzlich Wrapper-Kontext aus @neelegirly/wa-api darstellen.

Typische Anzeige:

• Baileys Update-Status: up to date (2.2.18)
• Wrapper Update-Status: up to date (1.8.0)
• Bei echten Updates werden kompakte Hinweise auf latest eingeblendet

Wenn kein Wrapper-Kontext vorhanden ist, bleibt die Anzeige sauber bei Baileys. Kein unnötiges Drama, nur QR. ✨

🔄 Update-Check

• Quelle 1: npm Registry (registry.npmjs.org)
• Quelle 2: GitHub Releases (neelegirly/baileys) als Fallback
• Fehler und Timeouts werden abgefangen, ohne den Prozess zu stoppen
• Semver-Vergleich wird numerisch ausgewertet
• Wrapper-Status kann über die von @neelegirly/wa-api gesetzten Umgebungsvariablen übernommen werden

Wenn du direkt prüfen willst:

import { checkNpmVersion } from '@neelegirly/baileys'

const info = await checkNpmVersion('@neelegirly/baileys', '2.2.18', {
  githubRepo: 'neelegirly/baileys'
})

console.log(info)

🌐 Namespace-Migration

Wenn du vom Upstream kommst, nutze den Neelegirly-Scope:

- import makeWASocket from '@whiskeysockets/baileys'
+ import makeWASocket from '@neelegirly/baileys'

📝 Release Notes 2.2.18

• 🌸 QR-/Footer-Branding zeigt Baileys- und Wrapper-Status klarer an
• 🧠 Wrapper-Updatehinweise werden nur bei echten Updates eingeblendet
• 🔗 Companion-Stack auf 2.2.18 / 1.8.0 / 1.0.28 aktualisiert
• ✨ README auf neuen Release- und Update-Notify-Stand gebracht