@gara31/void-baileys 7.0.0-rc.10

package/readme.md

@@ -0,0 +1,522 @@
+<div align="center">
+
+<img src="https://raw.githubusercontent.com/gara31/void-md/main/uploads/1778931942943_ajzmir7fupi.jpg" alt="void-baileys banner" width="100%" />
+
+# @gara31/void-baileys
+
+### Modded Baileys v7 — Pesan Interaktif, Album, AI Rich Response & Lebih
+
+[![npm version](https://img.shields.io/npm/v/@gara31/void-baileys?color=CB3837&logo=npm&logoColor=white&style=for-the-badge)](https://www.npmjs.com/package/@gara31/void-baileys)
+[![npm downloads](https://img.shields.io/npm/dm/@gara31/void-baileys?color=CB3837&logo=npm&logoColor=white&style=for-the-badge)](https://www.npmjs.com/package/@gara31/void-baileys)
+[![License](https://img.shields.io/badge/license-MIT-blue?style=for-the-badge)](LICENSE)
+[![Node](https://img.shields.io/badge/node-%3E%3D20.0.0-339933?logo=node.js&logoColor=white&style=for-the-badge)](https://nodejs.org)
+[![ESM](https://img.shields.io/badge/ESM-only-F7DF1E?logo=javascript&logoColor=black&style=for-the-badge)](#)
+
+---
+
+**Build modifikasi dari [WhiskeySockets/Baileys](https://github.com/WhiskeySockets/Baileys)**  
+dengan dukungan native untuk pesan interaktif, album, AI rich response, newsletter, status mention, dan berbagai utilitas tambahan.
+
+Package ini adalah **distribusi/build repo** untuk `@gara31/void-baileys`.  
+Berisi file runtime yang sudah dikompilasi di `lib/` dan protobuf di `WAProto/`, dirancang untuk digunakan langsung dari npm.
+
+</div>
+
+---
+
+## Daftar Isi
+
+- [Fitur](#-fitur)
+- [Persyaratan](#-persyaratan)
+- [Isi Package](#-isi-package)
+- [Instalasi](#-instalasi)
+- [Quick Start](#-quick-start)
+- [Referensi API Socket](#-referensi-api-socket)
+- [Referensi Event](#-referensi-event)
+- [Utilitas](#-utilitas)
+- [Lisensi](#-lisensi)
+
+---
+
+## ✨ Fitur
+
+| Fitur | Deskripsi | Status |
+|---|---|---|
+| **Pesan Interaktif** | Flow button native, list/select menu, carousel | ✅ |
+| **Album Messages** | Multi-image/video album dengan metadata | ✅ |
+| **AI Rich Response** | `sendTable`, `sendList`, `sendCodeBlock`, `sendRichMessage` | ✅ |
+| **Unified Response V2** | `sendTableV2`, `sendCodeBlockV2`, `sendLinkV2` | ✅ |
+| **Link Messages** | Link inline dengan kutipan dan verifikasi | ✅ |
+| **Payment Messages** | Pesan pembayaran dengan catatan/stiker | ✅ |
+| **Produk & Katalog** | Pesan produk bisnis, katalog lengkap | ✅ |
+| **Event & Poll** | Builder pesan event dan hasil polling | ✅ |
+| **Newsletter Extras** | Follow massal, metadata, admin utilities | ✅ |
+| **Komunitas & Grup** | CRUD komunitas, undangan, persetujuan | ✅ |
+| **Status Mention** | `sendStatusMention()` untuk mention di status | ✅ |
+| **LID & Session** | Pemetaan LID↔PN, migrasi sesi | ✅ |
+| **TypeScript** | File `.d.ts` tersedia untuk semua API | ✅ |
+
+---
+
+## ✅ Persyaratan
+
+- **Node.js** `>= 20.0.0`
+- **Proyek ESM** (`"type": "module"` di `package.json`)
+- Auth store persisten untuk penggunaan produksi
+- Opsional: `pino`, `qrcode-terminal`, `sharp`, `jimp`
+
+> **Penting:** `@gara31/void-baileys` hanya mendukung ESM. Proyek CommonJS perlu migrasi atau dynamic import wrapper.
+
+---
+
+## 📁 Isi Package
+
+| Path | Kegunaan |
+|---|---|
+| `lib/` | Runtime utama, tipe, socket layer, utilitas |
+| `WAProto/` | Protobuf runtime yang sudah digenerate |
+| `package.json` | Metadata package |
+
+---
+
+## 📦 Instalasi
+
+```bash
+npm install @gara31/void-baileys
+```
+
+Package pendamping yang disarankan:
+
+```bash
+npm install pino qrcode-terminal
+```
+
+### Menggunakan Alias
+
+Tambahkan ke `package.json`:
+
+```json
+{
+  "dependencies": {
+    "baileys": "npm:@gara31/void-baileys@latest"
+  }
+}
+```
+
+Lalu jalankan:
+
+```bash
+npm install
+```
+
+---
+
+## 🛠️ Quick Start
+
+### 1. Setup Proyek
+
+```bash
+mkdir bot-ku && cd bot-ku
+npm init -y
+```
+
+Pastikan `package.json` memiliki `"type": "module"`:
+
+```json
+{
+  "name": "bot-ku",
+  "type": "module",
+  "dependencies": {
+    "baileys": "npm:@gara31/void-baileys@latest"
+  }
+}
+```
+
+### 2. Install Dependensi
+
+```bash
+npm install @gara31/void-baileys pino qrcode-terminal
+```
+
+### 3. Buat `index.js`
+
+```js
+import makeWASocket, {
+  useMultiFileAuthState,
+  DisconnectReason,
+  Browsers,
+} from '@gara31/void-baileys'
+import pino from 'pino'
+import qrcode from 'qrcode-terminal'
+
+const logger = pino({ level: 'silent' })
+
+async function startBot() {
+  const { state, saveCreds } = await useMultiFileAuthState('./session')
+
+  const sock = makeWASocket({
+    auth: state,
+    logger,
+    browser: Browsers.ubuntu('Chrome'),
+    syncFullHistory: false,
+  })
+
+  sock.ev.on('creds.update', saveCreds)
+
+  sock.ev.on('connection.update', ({ connection, lastDisconnect, qr }) => {
+    if (qr) qrcode.generate(qr, { small: true })
+
+    if (connection === 'close') {
+      const shouldReconnect =
+        lastDisconnect?.error?.output?.statusCode !== DisconnectReason.loggedOut
+      if (shouldReconnect) startBot()
+    }
+    if (connection === 'open') console.log('Terhubung!')
+  })
+
+  sock.ev.on('messages.upsert', async ({ messages }) => {
+    const msg = messages[0]
+    if (!msg?.message || msg.key.fromMe) return
+
+    const text =
+      msg.message.conversation || msg.message.extendedTextMessage?.text || ''
+
+    if (text === '.ping') {
+      await sock.sendMessage(msg.key.remoteJid, { text: 'Pong!' })
+    }
+  })
+}
+
+startBot()
+```
+
+### 4. Jalankan
+
+```bash
+node index.js
+```
+
+Scan QR code, tunggu hingga socket mencapai `connection: "open"`, lalu kirim `.ping` untuk tes.
+
+### 5. Contoh Pairing Code
+
+```js
+const sock = makeWASocket({
+  auth: state,
+  logger,
+  browser: Browsers.windows('Chrome'),
+})
+
+sock.ev.on('connection.update', async ({ connection }) => {
+  if (connection === 'connecting') {
+    const code = await sock.requestPairingCode('628xxxxxxxxx')
+    console.log('Pairing code:', code)
+  }
+})
+```
+
+---
+
+## 📡 Referensi API Socket
+
+### Koneksi & Autentikasi
+
+```js
+const sock = makeWASocket({
+  auth: state,
+  logger,
+  browser: Browsers.ubuntu('Chrome'),
+  connectTimeoutMs: 20_000,
+  defaultQueryTimeoutMs: 60_000,
+  syncFullHistory: false,
+})
+```
+
+### Kirim Pesan
+
+```js
+// Teks
+await sock.sendMessage(jid, { text: 'Halo!' })
+
+// Gambar
+await sock.sendMessage(jid, {
+  image: { url: './foto.jpg' },
+  caption: 'Sebuah foto',
+})
+
+// Video
+await sock.sendMessage(jid, {
+  video: { url: './video.mp4' },
+  caption: 'Sebuah video',
+})
+
+// Audio / Voice Note
+await sock.sendMessage(jid, {
+  audio: { url: './audio.ogg' },
+  mimetype: 'audio/ogg; codecs=opus',
+  ptt: true,
+})
+
+// Stiker
+await sock.sendMessage(jid, {
+  sticker: { url: './stiker.webp' },
+})
+
+// Dokumen
+await sock.sendMessage(jid, {
+  document: { url: './file.pdf' },
+  fileName: 'dokumen.pdf',
+  mimetype: 'application/pdf',
+})
+
+// Reaksi
+await sock.sendMessage(jid, {
+  react: { key: msg.key, text: '👍' },
+})
+
+// Polling
+await sock.sendMessage(jid, {
+  poll: {
+    name: 'Vote!',
+    values: ['Opsi A', 'Opsi B', 'Opsi C'],
+    selectableCount: 1,
+  },
+})
+
+// Hapus pesan
+await sock.sendMessage(jid, { delete: msg.key })
+
+// Edit pesan
+await sock.sendMessage(jid, {
+  text: 'Teks yang sudah diedit',
+  edit: msg.key,
+})
+```
+
+### Pesan Interaktif
+
+```js
+// Tombol Flow
+await sock.sendMessage(jid, {
+  interactiveMessage: {
+    title: 'Selamat Datang!',
+    footer: 'Powered by Void',
+    buttons: [
+      {
+        name: 'quick_reply',
+        buttonParamsJson: JSON.stringify({
+          display_text: 'Menu',
+          id: 'menu',
+        }),
+      },
+      {
+        name: 'cta_url',
+        buttonParamsJson: JSON.stringify({
+          display_text: 'Website',
+          url: 'https://example.com',
+        }),
+      },
+    ],
+    header: 'Pilih opsi',
+  },
+})
+
+// List Menu
+await sock.sendMessage(jid, {
+  interactiveMessage: {
+    title: 'Pilih Kategori',
+    footer: 'Powered by Void',
+    buttons: [
+      {
+        name: 'single_select',
+        buttonParamsJson: JSON.stringify({
+          title: 'Menu',
+          sections: [
+            {
+              title: 'Game',
+              rows: [
+                { title: 'Kuis', id: '.kuis' },
+                { title: 'Tebak Gambar', id: '.tebakgambar' },
+              ],
+            },
+          ],
+        }),
+      },
+    ],
+    header: 'Menu Bot',
+  },
+})
+```
+
+### Album Messages
+
+```js
+await sock.sendMessage(jid, {
+  albumMessage: [
+    { image: { url: './foto1.jpg' }, caption: 'Pertama' },
+    { image: { url: './foto2.jpg' }, caption: 'Kedua' },
+    { video: { url: './klip.mp4' }, caption: 'Video' },
+  ],
+})
+```
+
+### AI Rich Response
+
+```js
+// Tabel
+await sock.sendTable(
+  jid,
+  'Java vs JavaScript',
+  ['Fitur', 'Java', 'JavaScript'],
+  [
+    ['Tipe', 'Compiled', 'Interpreted'],
+    ['Typing', 'Static', 'Dynamic'],
+    ['Kegunaan', 'Enterprise', 'Web, Full-stack'],
+  ],
+  quoted,
+  { headerText: 'Perbandingan:', footer: 'Semoga membantu!' }
+)
+
+// List
+await sock.sendList(
+  jid,
+  'Info Bot',
+  [
+    ['Nama', 'Void AI'],
+    ['Versi', '7.0.0'],
+    ['Developer', 'gara31'],
+  ],
+  quoted,
+  { footer: '© Void AI' }
+)
+
+// Code Block
+await sock.sendCodeBlock(
+  jid,
+  `const salam = "Halo Dunia"
+function kataSalam(nama) {
+    return salam + " " + nama
+}
+kataSalam("Void")`,
+  quoted,
+  {
+    language: 'javascript',
+    title: 'Contoh Kode',
+    footer: 'Powered by Void',
+  }
+)
+```
+
+### Metode Newsletter
+
+```js
+await sock.newsletterFollow('id@newsletter')
+await sock.newsletterUnfollow('id@newsletter')
+await sock.newsletterMute('id@newsletter')
+await sock.newsletterUnmute('id@newsletter')
+await sock.newsletterCreate('Saluran Saya', 'Deskripsi')
+await sock.newsletterUpdate('id@newsletter', { name: 'Nama Baru' })
+const { subscribers } = await sock.newsletterSubscribers('id@newsletter')
+await sock.newsletterMultipleFollow('id1@newsletter id2@newsletter')
+```
+
+### Metode Grup
+
+```js
+const meta = await sock.groupMetadata('id@g.us')
+const grup = await sock.groupCreate('Grup Baru', ['628xxx@s.whatsapp.net'])
+await sock.groupLeave('id@g.us')
+await sock.groupUpdateSubject('id@g.us', 'Nama Baru')
+await sock.groupUpdateDescription('id@g.us', 'Deskripsi Baru')
+await sock.groupParticipantsUpdate('id@g.us', ['628xxx@s.whatsapp.net'], 'add')
+const kode = await sock.groupInviteCode('id@g.us')
+await sock.groupRevokeInvite('id@g.us')
+await sock.groupSettingUpdate('id@g.us', 'announcement')
+```
+
+### Metode Komunitas
+
+```js
+const komunitas = await sock.communityCreate('Komunitas Kami', 'Deskripsi')
+await sock.communityLinkGroup('groupid@g.us', 'communityid@g.us')
+await sock.communityUnlinkGroup('groupid@g.us', 'communityid@g.us')
+await sock.communityLeave('communityid@g.us')
+```
+
+### Pengaturan Privasi
+
+```js
+await sock.updateLastSeenPrivacy('all')       // 'all' | 'contacts' | 'nobody'
+await sock.updateOnlinePrivacy('all')
+await sock.updateProfilePicturePrivacy('contacts')
+await sock.updateStatusPrivacy('contacts')
+await sock.updateReadReceiptsPrivacy('all')   // 'all' | 'none'
+await sock.updateGroupsAddPrivacy('all')
+await sock.updateCallPrivacy('everyone')
+```
+
+---
+
+## 📡 Referensi Event
+
+```js
+sock.ev.on('connection.update', ({ connection, lastDisconnect, qr }) => {})
+sock.ev.on('creds.update', (update) => {})
+sock.ev.on('messages.upsert', ({ messages, type }) => {})
+sock.ev.on('messages.update', (updates) => {})
+sock.ev.on('messages.delete', (keys) => {})
+sock.ev.on('messages.reaction', (reactions) => {})
+sock.ev.on('groups.update', (updates) => {})
+sock.ev.on('group-participants.update', (update) => {})
+sock.ev.on('contacts.upsert', (contacts) => {})
+sock.ev.on('contacts.update', (updates) => {})
+sock.ev.on('chats.upsert', (chats) => {})
+sock.ev.on('chats.update', (updates) => {})
+sock.ev.on('call', (calls) => {})
+sock.ev.on('newsletter.update', (updates) => {})
+sock.ev.on('settings.update', (settings) => {})
+```
+
+---
+
+## 🔧 Utilitas
+
+```js
+import {
+  // Auth
+  useMultiFileAuthState,
+  makeCacheableSignalKeyStore,
+  initAuthCreds,
+  BufferJSON,
+  fetchLatestBaileysVersion,
+
+  // JID
+  jidEncode,
+  jidDecode,
+  jidNormalizedUser,
+  areJidsSameUser,
+  isJidGroup,
+  isJidNewsletter,
+  isJidBroadcast,
+
+  // Koneksi
+  DisconnectReason,
+  Browsers,
+} from '@gara31/void-baileys'
+```
+
+---
+
+## 📄 Lisensi
+
+MIT © [gara31](https://github.com/gara31)
+
+> **Peringatan:** Library ini untuk keperluan edukasi. Pastikan penggunaannya sesuai dengan Syarat Layanan WhatsApp.
+
+---
+
+<div align="center">
+
+**Dibuat dengan 💚 oleh gara31**
+
+</div>