yukistage

❄️ YukiStage

Advanced WhatsApp Web API Hybrid Client Library for Node.js
_{High-performance Baileys fork + Built-in MessageBuilder with Auto-Update System}

🔗 Support & Community

❄️ Deskripsi Proyek

YukiStage adalah hasil "kawin silang resmi" antara @whiskeysockets/baileys dan baileys-mbuilder yang dirancang khusus oleh ZetaGo-Aurum untuk memenuhi kebutuhan performa bot Yuki AI dengan maskot pelayan anime es (kuudere) khas Yuki.

Pustaka ini menggabungkan kekuatan core API komunikasi Baileys terbaru dengan kenyamanan MessageBuilder dengan sistem auto-update untuk membuat Button, Carousel, Native Flow, dan AI Rich Response WhatsApp dalam satu paket tunggal tanpa perlu menginstal dependensi terpisah!

🚀 Fitur Utama & Optimalisasi

• Integrasi MessageBuilder Bawaan (Hybrid) & Auto-Update

  • Akses langsung class builder: Button, ButtonV2, Carousel, AIRich, dan Toolkit langsung dari root import yukistage.
  • Dilengkapi sistem Auto-Update & Hot Reload otomatis (melalui Proxy) yang selalu memuat fungsionalitas MessageBuilder versi terbaru dari repositori resmi tanpa perlu mengupdate package secara manual.
  • Pembuatan pesan interaktif, dropdown menu (single_select), carousel multi-kartu, dan respon AI terformat menjadi sangat mudah dengan Fluent Chaining API.

• Stabilitas Koneksi Tinggi (Anti-Disconnect)

  • Interval keep-alive/ping dipersingkat menjadi 15 detik (default: 30 detik) untuk mencegah penutupan koneksi TCP secara sepihak oleh tabel NAT firewall VPS/Docker.
  • Durasi timeout koneksi awal diperpanjang hingga 30 detik untuk toleransi jaringan lambat.

• Optimasi Pengiriman Pesan Bisnis

  • Penambahan metadata bisnis (biz node) otomatis pada pengiriman interaktif untuk menjamin kesuksesan render tombol tanpa penolakan (silent drop) oleh server WhatsApp pada akun personal.

• Performa Ringan & Cepat

  • Pemangkasan berkas .map dan dependensi tidak terpakai.
  • Penanganan media yang dioptimalkan dengan resolusi buffer dan image resizer terintegrasi.

📦 Instalasi

Gunakan npm atau yarn untuk menginstal YukiStage ke dalam proyek Anda:

npm install yukistage

🛠️ Contoh Penggunaan

Menggunakan YukiStage dengan inisialisasi soket dan pembuatan tombol terintegrasi:

import makeWASocket, { DisconnectReason, useMultiFileAuthState, Button, ButtonV2, Toolkit } from 'yukistage';
import log from 'pino';

async function startBot() {
    const { state, saveCreds } = await useMultiFileAuthState('session_yuki');
    
    const client = makeWASocket({
        auth: state,
        logger: log({ level: 'silent' }),
        printQRInTerminal: true,
        connectTimeoutMs: 30000,
        keepAliveIntervalMs: 15000
    });

    client.ev.on('connection.update', (update) => {
        const { connection } = update;
        if (connection === 'open') {
            console.log('YukiStage berhasil terhubung ke WhatsApp!');
        }
    });

    client.ev.on('messages.upsert', async (chatUpdate) => {
        const msg = chatUpdate.messages[0];
        if (!msg.message || msg.key.fromMe) return;

        const jid = msg.key.remoteJid;

        // Contoh Membuat Tombol Interaktif (Native Flow) dengan YukiStage
        const button = new Button(client)
            .setTitle("❄️ Yuki Menu")
            .setBody("Halo Senapi, ada yang bisa Yuki bantu?")
            .setFooter("YukiStage Hybrid Client")
            .addReply("❄️ Menu", "menu_id")
            .addUrl("🌐 GitHub", "https://github.com")
            .addSelection("🔘 Pilihan Lainnya")
            .makeSection("Kategori Utama")
            .makeRow("🎧 Audio", "play_audio", "Putar audio musik", "row_1")
            .makeRow("🎬 Video", "play_video", "Putar video klip", "row_2");

        await button.send(jid);
    });

    client.ev.on('creds.update', saveCreds);
}

startBot();

🎖️ Credits & Penghargaan

Pustaka YukiStage ini menggunakan MessageBuilder sebagai pustaka internal tambahannya. Kredit penuh dan ucapan terima kasih sebesar-besarnya kami haturkan kepada:

• Nixel (NIXCODE) — Pembuat asli dan pengembang utama pustaka baileys-mbuilder.
• FongsiDev / FgsiDev — Kontributor pustaka baileys-mbuilder & npm package publisher.
• Update & Support — Silakan bergabung di WhatsApp Channel MBuilder.
• Pustaka asli Baileys oleh Rajeh Taher & WhiskeySockets.

📄 License

MIT © ZetaGo-Aurum

Note: The underlying MBuilder library (integrated into this project with auto-update system) is Copyright © 2026 Nixel(Dev) & FgsiDev(Contributor).

Developed and maintained with ❄️ by ZetaGo-Aurum.