sauruspro-bail 5.0.2-alpha.spr.test → 5.0.3

package/README.md

@@ -2,7 +2,7 @@
 
 # 🦖 SAURUSPRO BAILEYS
 
-**Custom WhatsApp Web API Library — SPR, Newsletter Status, Rich Messages & more**
+**WhatsApp Web API untuk Node.js, lengkap dengan Rich Message, SPR, dan Newsletter Status**
 
 <img src="https://cdn.saurus.qzz.io/image/EGYoX.png" width="140" alt="Sauruspro">
 
@@ -11,35 +11,41 @@
 ![node](https://img.shields.io/badge/Node.js-20%2B-22c55e?style=for-the-badge)
 ![license](https://img.shields.io/badge/License-MIT-3b82f6?style=for-the-badge)
 
-**Owner: Saurus / Dinonic** · **Version: 5.0.2-alpha.spr.test**
-
 </div>
 
 ---
 
-## 📦 Package Info
+## 📖 Apa itu Baileys?
 
-| | |
+**Baileys** adalah library JavaScript/TypeScript yang berbicara langsung dengan server WhatsApp lewat **WebSocket**, sama seperti WhatsApp Web, tetapi **tanpa browser** dan tanpa Selenium/Puppeteer. Dengan Baileys kamu bisa membuat bot atau aplikasi yang:
+
+- login sebagai *linked device* (perangkat tertaut) lewat **QR** atau **pairing code**,
+- mengirim dan menerima pesan (teks, gambar, video, stiker, poll, dll),
+- mengelola grup, komunitas, channel (newsletter), dan profil,
+- berjalan ringan karena hanya memakai protokol multi-device, bukan emulasi browser.
+
+**Sauruspro Baileys (`sauruspro-bail`)** adalah turunan Baileys dengan fitur tambahan:
+
+| Fitur | Isi |
 |---|---|
-| Package | `sauruspro-bail` |
-| Version | `5.0.2-alpha.spr.test` |
-| Owner | Saurus / Dinonic |
-| Module type | ESM (`"type": "module"`) |
-| Runtime | Node.js >= 20 |
-| Telegram | [@lordsaurus](https://t.me/lordsaurus) · [@lordsaurus](https://t.me/lordsaurus) |
+| 💬 **Rich Message** | `AIRich`, Carousel, Button, Native Flow, A2UI |
+| 🎯 **SPR (Selective Relay)** | Kirim pesan hanya ke device tertentu, pesan khusus per orang |
+| 📢 **Newsletter Status** | Kirim, react, hapus, dan ambil status Channel |
+| 🪪 **Greeting Card `/buss`** | Kartu sapaan untuk WhatsApp Business |
+| 🧩 **Plugin system** | `sock.use(plugin)` dan fitur bawaan bisa dimatikan |
+| 👤 **Presence & Profile API** | `sock.presence.*` dan `sock.profile.*` yang lebih rapi |
+| ⚡ **Native crypto (opsional)** | X25519 dan XEdDSA lebih cepat jika `@zapo-js/native` terpasang |
 
-## ✨ Features
+> Beberapa fitur diadaptasi dari [zapo-js](https://github.com/vinikjkkj/zapo) (MIT).
 
-| Feature | Description |
+## 📦 Info Paket
+
+| | |
 |---|---|
-| 🔐 Pairing Code & QR | Login via pairing code or QR |
-| 💬 Rich Messages | MessageBuilder: `AIRich`, `Carousel`, `Button`, `ButtonV2`, `Toolkit` |
-| 🎯 **SPR** | Selective Relay: kirim pesan hanya ke device/JID tertentu |
-| 📢 **Newsletter Status** | Kirim, react, revoke & ambil status Channel (newsletter) |
-| 🔗 LID & PN | Kompatibel LID dan nomor telepon |
-| 👤 Username | Fetch username |
-| 👥 Groups & Communities | Manajemen grup dan komunitas |
-| 🗂️ Auth | Multi-file & SQLite auth state |
+| Nama | `sauruspro-bail` |
+| Modul | ESM (`"type": "module"`), bisa dipakai dari CommonJS (lihat di bawah) |
+| Node.js | >= 20 |
+| Telegram | [@lordsaurus](https://t.me/lordsaurus) |
 
 ## 🚀 Install
 
@@ -47,44 +53,214 @@
 npm install sauruspro-bail
 ```
 
-> Paket ini **ESM**. Gunakan `import`, atau `await import()` dari CommonJS.
+---
+
+## 🔌 Menghubungkan ke WhatsApp (bot)
+
+Ada dua cara login: **QR code** atau **pairing code** (kode 8 karakter yang dimasukkan di HP). Sesi disimpan di folder, jadi login hanya perlu sekali.
+
+### Contoh lengkap (pairing code + reconnect)
+
+```js
+import makeWASocket, {
+  useMultiFileAuthState,
+  DisconnectReason,
+  Browsers
+} from 'sauruspro-bail'
+
+const NOMOR = '628123456789' // format internasional, tanpa +, spasi, atau strip
+
+async function start() {
+  const { state, saveCreds } = await useMultiFileAuthState('session')
+
+  const sock = makeWASocket({
+    auth: state,
+    browser: Browsers.ubuntu('Chrome') // dianjurkan untuk pairing code
+  })
+
+  // simpan kredensial setiap kali berubah
+  sock.ev.on('creds.update', saveCreds)
+
+  // minta pairing code hanya jika belum login
+  if (!sock.authState.creds.registered) {
+    const code = await sock.requestPairingCode(NOMOR)
+    console.log('Pairing code:', code.match(/.{1,4}/g).join('-'))
+    // HP: WhatsApp > Perangkat tertaut > Tautkan perangkat > Tautkan dengan nomor telepon
+  }
+
+  // status koneksi + reconnect otomatis
+  sock.ev.on('connection.update', ({ connection, lastDisconnect }) => {
+    if (connection === 'open') console.log('✅ Bot terhubung')
+    if (connection === 'close') {
+      const status = lastDisconnect?.error?.output?.statusCode
+      if (status === DisconnectReason.loggedOut) {
+        console.log('Logout. Hapus folder "session" lalu jalankan ulang.')
+      } else {
+        start() // koneksi putus, sambungkan lagi
+      }
+    }
+  })
+
+  // contoh membalas pesan
+  sock.ev.on('messages.upsert', async ({ messages }) => {
+    const msg = messages[0]
+    if (!msg?.message || msg.key.fromMe) return
+    const teks = msg.message.conversation || msg.message.extendedTextMessage?.text
+    if (teks === 'ping') {
+      await sock.sendMessage(msg.key.remoteJid, { text: 'pong' }, { quoted: msg })
+    }
+  })
+}
+
+start()
+```
+
+### Catatan pairing code
+
+- Setiap pemanggilan `requestPairingCode` menghasilkan **kode acak baru**. Kamu juga bisa memakai kode sendiri: `requestPairingCode(NOMOR, 'ABCD1234')` (8 karakter, `A-Z` dan `0-9`).
+- Nomor otomatis dibersihkan, jadi `+62 812-3456-789` tetap diterima.
+- Jika sesi sudah login (`registered`), pairing ditolak. Hapus folder sesi untuk login ulang.
+- Kode berlaku singkat. Kalau kedaluwarsa, panggil `requestPairingCode` lagi.
+
+### Login dengan QR
 
-## ⚡ Quick Start
+Dengarkan event `connection.update` dan tampilkan `qr` (misalnya dengan paket `qrcode-terminal`):
 
 ```js
-import makeWASocket, { useMultiFileAuthState } from 'sauruspro-bail'
+sock.ev.on('connection.update', ({ qr }) => {
+  if (qr) console.log('Scan QR ini di WhatsApp:', qr)
+})
+```
+
+### Menyimpan sesi di SQLite (opsional)
+
+```js
+import { useSqliteAuthState } from 'sauruspro-bail'
+const { state, saveCreds } = await useSqliteAuthState('session.db')
+```
+
+---
 
-const { state, saveCreds } = await useMultiFileAuthState('session')
-const sock = makeWASocket({ auth: state })
+## 📜 Memakai dari CommonJS (`require`)
 
-sock.ev.on('creds.update', saveCreds)
+Paket ini ESM. Dari file `.js`/`.cjs` biasa, ada dua cara:
 
-// Pairing code
-if (!sock.authState.creds.registered) {
-  const code = await sock.requestPairingCode('628xxxxxxxxxx')
-  console.log('Pairing code:', code)
+**1. `import()` dinamis (semua versi Node 20+, paling aman)**
+
+```js
+// index.cjs
+async function main() {
+  const { default: makeWASocket, useMultiFileAuthState } = await import('sauruspro-bail')
+
+  const { state, saveCreds } = await useMultiFileAuthState('session')
+  const sock = makeWASocket({ auth: state })
+  sock.ev.on('creds.update', saveCreds)
 }
+main()
+```
+
+**2. `require()` langsung (Node 22.12+ atau Node 20.19+)**
+
+```js
+const baileys = require('sauruspro-bail')
+const makeWASocket = baileys.default
+const { useMultiFileAuthState } = baileys
+```
+
+Pada Node versi lama, `require('sauruspro-bail')` akan error `ERR_REQUIRE_ESM`. Pakai cara pertama.
+
+Mau ubah proyekmu jadi ESM saja? Tambahkan `"type": "module"` di `package.json` proyekmu lalu pakai `import`.
+
+---
+
+## 💬 Rich Message (AIRich)
+
+Rich Message adalah balasan bergaya Meta AI: teks, kode, tabel, gambar, dan lainnya dalam satu pesan. Dibuat dengan builder `sock.AIRich`.
+
+```js
+const rich = new sock.AIRich(sock)
+
+rich
+  .addText('Halo! Ini **Rich Message** dari Sauruspro.')
+  .addCode('javascript', "console.log('halo dunia')")
+  .addTable([
+    ['Fitur', 'Status'],
+    ['SPR', 'Aktif'],
+    ['Newsletter Status', 'Aktif']
+  ])
+
+await rich.send(jid)
+```
+
+Cara singkat tanpa builder:
+
+```js
+import { sendAIRichMessage } from 'sauruspro-bail'
+
+await sendAIRichMessage(sock, jid, { text: 'Halo dari Rich Message!' })
+```
+
+Builder lain yang tersedia: `sock.Carousel`, `sock.Button`, `sock.ButtonV2`, `sock.Toolkit`. Pesan `interactiveMessage`, `buttonsMessage`, `flowMessage`, dan `carouselMessage` juga bisa dikirim lewat `sock.sendMessage`.
+
+> Rich Message memakai fitur WhatsApp yang bisa berubah. Tampilannya bergantung pada versi aplikasi penerima.
+
+---
+
+## 🎯 SPR (Selective Relay)
+
+SPR mengontrol **siapa membaca apa** dalam satu pesan grup. Tiap device penerima masuk salah satu peran:
+
+| Peran | Yang diterima |
+|---|---|
+| `public` | pesan umum |
+| `personal` | pesan khusus miliknya saja |
+| `hidden` | tidak menerima apa-apa |
+
+```js
+// Sembunyikan pesan dari 1 orang
+await sock.sPR(groupJid, { conversation: 'rahasia' }, {
+  mode: 'exclude',                       // 'include' = hanya target yang menerima
+  target: ['6281234567890@s.whatsapp.net']
+})
+
+// Pesan umum untuk semua, pesan lain khusus untuk A
+await sock.sPR(groupJid, { conversation: 'info umum' }, {
+  personal: { '6281234567890@s.whatsapp.net': { conversation: 'info khusus kamu' } }
+})
+
+// Anggota lain lihat publicText, targetJid lihat privateText + foto profilnya
+await sock.sPRPrivate(groupJid, targetJid, {
+  publicText: 'Pesan ini memiliki isi khusus untuk beberapa penerima.',
+  privateText: 'rahasia buat kamu'
+})
+
+// Tiap anggota menerima pesan sendiri, {name} menjadi @mention orang itu
+await sock.sPRBroadcast(groupJid, { template: 'Halo {name}, ada pesan untukmu.', limit: 100 })
 ```
 
+Opsi lengkap dan penjelasan lebih dalam: **[docs/SPR.md](docs/SPR.md)**
+
+---
+
 ## 📢 Newsletter Status
 
-Kirim status ke Channel (newsletter) yang kamu admin-i.
+Kirim status ke **Channel (newsletter)** yang kamu admin-i. JID channel berakhiran `@newsletter`.
 
 ```js
 const jid = '120363xxxxxxxxxxxxx@newsletter'
 
 // Teks
 const sent = await sock.newsletter.sendStatus(jid, { text: 'Halo Channel!' })
-console.log(sent.newsletterStatusServerId)
+console.log(sent.newsletterStatusServerId) // dipakai untuk react / revoke
 
-// Gambar
-await sock.sendNewsletterStatus(jid, {
+// Gambar atau video
+await sock.newsletter.sendStatus(jid, {
   image: { url: './foto.jpg' },
   caption: 'Update terbaru'
 })
 
-// React ke status (butuh serverId dari status)
-await sock.newsletter.reactToStatus(jid, serverId, '🔥')
+// React ke status
+await sock.newsletter.reactToStatus(jid, sent.newsletterStatusServerId, '🔥')
 
 // Hapus status
 await sock.newsletter.revokeStatus(jid, statusId)
@@ -93,27 +269,36 @@ await sock.newsletter.revokeStatus(jid, statusId)
 const list = await sock.newsletter.fetchStatuses(jid, { count: 20 })
 ```
 
-Dokumentasi lengkap: **[docs/NEWSLETTER-STATUS.md](docs/NEWSLETTER-STATUS.md)**
+Semua fungsi juga tersedia langsung di socket: `sock.sendNewsletterStatus(...)`, `sock.sendNewsletterStatusReaction(...)`, dan seterusnya.
 
-## 🎯 SPR (Selective Relay)
+Dokumentasi jenis konten, opsi, dan error: lihat tipe di `lib/Utils/newsletter-status.d.ts`.
+
+---
+
+## 🧩 Fitur lain
 
 ```js
-await sock.sPR(jid, { conversation: 'Halo!' })
-// alias: sock.relayMessageSelective(jid, message, options)
+// Greeting Card /buss (hanya terlihat di WhatsApp Business)
+await sock.sendGreetingCard(jid, {
+  text: 'wow', title: 'Judul Kartu', greeting: 'Hi Business',
+  imageUrl: 'https://.../img.jpg', contactUrl: 'https://wa.me/NOMOR'
+})
 
-// pesan privat per orang + foto profil
-await sock.sPRPrivate(groupJid, targetJid, { publicText: 'Ada pesan', privateText: 'rahasia' })
-await sock.sPRBroadcast(groupJid, { template: 'Halo {name}!' })
-```
+// Presence & profile
+await sock.presence.withTyping(jid, () => sock.sendMessage(jid, { text: 'halo' }))
+await sock.profile.setStatus('Bot aktif')
 
-Dokumentasi lengkap: **[docs/SPR.md](docs/SPR.md)**
+// Plugin
+import { definePlugin } from 'sauruspro-bail'
+sock.use(definePlugin({ id: 'halo', setup: ({ extend }) => extend({ halo: () => 'hai' }) }))
+// matikan fitur bawaan: makeWASocket({ disablePlugins: ['greeting-card'] })
+```
 
 ## 📚 Dokumentasi
 
 | File | Isi |
 |---|---|
-| [docs/NEWSLETTER-STATUS.md](docs/NEWSLETTER-STATUS.md) | API newsletter status, opsi, error |
-| [docs/SPR.md](docs/SPR.md) | Selective Relay |
+| [docs/SPR.md](docs/SPR.md) | Selective Relay lengkap |
 | [docs/CHANGELOG.md](docs/CHANGELOG.md) | Riwayat versi |
 
 ## ⚠️ Disclaimer

package/docs/CHANGELOG.md

@@ -1,39 +1,61 @@
 # Changelog
 
-## 5.0.2-alpha.spr.test
+## 5.0.3
+### Fixed
+- **Pair code**: `requestPairingCode` diperbaiki.
+  - Nomor dibersihkan otomatis (`+62 812-3456-789` menjadi `628123456789`) dan divalidasi 7-15 digit.
+  - Menunggu socket terbuka dulu sebelum mengirim permintaan (tidak lagi error "Connection Closed" kalau dipanggil terlalu cepat).
+  - Setiap request membuat kode acak baru **dan** keypair ephemeral baru (sebelumnya keypair lama dipakai ulang).
+  - Kode custom dinormalkan ke huruf besar dan divalidasi `A-Z0-9` 8 karakter.
+  - Sesi yang sudah `registered` ditolak dengan pesan jelas.
+  - Jika pengiriman gagal, state pairing (kode, keypair, `me`) dikembalikan seperti semula.
+
 ### Changed
-- `lib/Utils/dinonic-spr.js` ditulis ulang dari nol (engine baru, sender key sekali pakai). API `sPR` / `selectiveRelay` tetap kompatibel.
+- Versi di banner `lib/index.js` kini dibaca dari `package.json` (export `packageVersion`). Banner bisa dimatikan dengan env `SAURUS_NO_BANNER=1`.
+- Info fitur di banner diperbarui.
+- README baru: pengertian Baileys, koneksi (QR dan pairing code), pemakaian dari CommonJS, Rich Message, SPR, dan Newsletter Status.
 
-### Added (diadaptasi dari plugin zapo-js, MIT)
-- Opsi `personal` pada `sPR`: pesan khusus per orang.
-- `sPRPrivate`, `sPRBroadcast` (`{name}` + mention + foto profil), `getSPRTargets`, `loadSPRAvatars`.
-- Batas target 100 + hitung overflow, cache foto, budget/timeout, konkurensi.
+## 5.0.2
+### Added (dari zapo-js, MIT)
+- **Greeting Card `/buss`**: `sock.sendGreetingCard(jid, { text, title, greeting, imageUrl, contactUrl, thumbnail?, sourceApp?, ref?, mentions?, adReply? }, sendOptions?)` dan `sock.buildGreetingCard(opts)`.
+  Pesan `extendedTextMessage` + `contextInfo.externalAdReply`; `sourceId`, `ctwaClid`, `ctaPayload` diacak tiap kirim. Kartu hanya tampil di WhatsApp Business; user biasa hanya melihat teks.
+  ```js
+  await sock.sendGreetingCard(jid, {
+    text: 'wow', title: 'Megumin Dominada BUSI', greeting: 'Hi Business',
+    imageUrl: 'https://.../img.jpg', contactUrl: 'https://wa.me/NOMOR'
+  }, { quoted: null })
+  ```
+- **Group History Bundle** (`sock.GroupHistory`): `encodeGroupHistoryBundle`, `decodeGroupHistoryBundle`, `streamGroupHistoryBundle`.
+- **Meta AI Bot helpers** (`sock.MetaAIBot`): `BOT_KNOWN_JIDS`, `genBotMsgSecret`, `deriveBotChunkKey`, `decryptBotChunk`, `attachBotMetadata`, `attachBotThread`, `extractInvokedBotJid`, `buildBotInvokeProtoCopy`.
+- **Plugin system**: `sock.use(plugin)`, `sock.removePlugin(id)`, `sock.hasPlugin(id)`, `sock.listPlugins()`, helper `definePlugin({ id, exposeAs?, setup(ctx), dispose? })`. Opsi socket `plugins: [...]` dan `disablePlugins: [...]`.
+  Fitur bawaan berupa plugin: `spr`, `greeting-card`, `group-history`, `meta-ai-bot`, `presence`, `profile`.
+- **Presence & Profile API**: `sock.presence` (`setOnline`, `setOffline`, `typing`, `recording`, `paused`, `subscribe`, `typeFor`, `withTyping`) dan `sock.profile` (`getPicture`, `setPicture`, `removePicture`, `getStatus`, `setStatus`, `setName`, `username.*`).
+- **Akselerator kripto native opsional**: jika `@zapo-js/native` terpasang, X25519 dan XEdDSA memakai native (NAPI lalu WASM), jika tidak tetap JS. Env `SAURUS_NATIVE_BACKEND=auto|napi|wasm|js|none`.
+- **SPR**: opsi `personal` (pesan khusus per orang), `sPRPrivate`, `sPRBroadcast` (`{name}` + mention + foto profil), `getSPRTargets`, `loadSPRAvatars`, batas target 100 dengan hitungan overflow, cache foto, budget/timeout, konkurensi (diadaptasi dari plugin zapo-js).
+
+### Fixed
+- Kode pairing tanpa custom kini acak tiap request (sebelumnya selalu sama).
+
+### Changed
+- `lib/Utils/dinonic-spr.js` ditulis ulang (sender key sekali pakai). API `sPR` / `selectiveRelay` tetap kompatibel.
 - Reporting token memakai util resmi, tctoken memakai pengecekan expired.
 
 ## 5.0.1
-**Owner: Saurus / Dinonic**
-
-### Added (fitur tambahan, by Saurus)
+### Added
 - **A2UI / Bloks widget**: `a2uiText`, `a2uiButton`, `a2uiCard`, `a2uiTabs`, `a2uiModal`, dll, plus `sendA2UI`, `sendBloksWidget`.
-- **DinonicBuilder** (`sock.DinonicBuilder`): Button, ButtonV2, Carousel, AIRich, Toolkit.
-- **Extras / AIRich lengkap**, **HTML App** (`sendHtmlApp`, `sendHtmlDocument`), **Meta AI sections**, **Bot Signature**, **Native Flow**.
+- **Builder** (`sock.DinonicBuilder`): Button, ButtonV2, Carousel, AIRich, Toolkit.
+- **AIRich lengkap**, **HTML App** (`sendHtmlApp`, `sendHtmlDocument`), **Meta AI sections**, **Bot Signature**, **Native Flow**.
 - **Modern Messages**: komentar, event invite, pertanyaan/jawaban, poll add option, scheduled call, undangan newsletter, status mention/reaction/audience.
-- **Payment Messages** (payment reminder, split payment), **Scheduled Message** (conditional reveal), **Status Stickers** (musik, link, lokasi, pesan, channel).
-- **Dinonic handler** (`Socket/dinonic-handler.js`): Interactive/Carousel, Buttons, Flow, Group Story di `sendMessage`, plus `sock.sendStatusWhatsApp` dan `sock.getName`.
+- **Payment Messages** (payment reminder, split payment), **Scheduled Message**, **Status Stickers** (musik, link, lokasi, pesan, channel).
+- Handler `Socket/dinonic-handler.js`: Interactive/Carousel, Buttons, Flow, Group Story di `sendMessage`, plus `sock.sendStatusWhatsApp` dan `sock.getName`.
 - Opsi socket: `rejectCalls`, `callRejectMessage`, `autoReadStatus`, `autoReadMessages`.
-- `baileys-event-stream`, file `.d.ts` untuk modul baru.
+- `baileys-event-stream` dan file `.d.ts` untuk modul baru.
 
 ### Changed
-- Semua nama `dinolith` → `dinonic` (termasuk file `dinonic-spr.js`). Branding fitur tambahan diganti menjadi Saurus / Dinonic.
 - **Newsletter Status** diganti dengan implementasi penuh (alias `prepareNewsletterStatusContent` dan `makeNewsletterStatusAttribution` tetap ada).
-- Pesan `interactiveMessage`, `buttonsMessage`, `flowMessage`, `carouselMessage`/`cards` sekarang lewat handler Dinonic.
-
-### Tidak dibawa
-- Telegram adapter dan bridge, auto-follow channel (sudah ada di `Socket/newsletter.js`), registrasi mobile, mobile client, `phonenumber-mcc` (dasar Baileys lama).
+- Pesan `interactiveMessage`, `buttonsMessage`, `flowMessage`, `carouselMessage`/`cards` sekarang lewat handler baru.
 
 ## 5.0.0
-**Owner: Saurus / Dinonic**
-
 ### Added
 - **Newsletter Status**: `sendNewsletterStatus`, `sendNewsletterStatusReaction`, `revokeNewsletterStatus`, `getNewsletterStatuses`, `getNewsletterStatusUpdates`, plus `sock.newsletter.{sendStatus, reactToStatus, revokeStatus, fetchStatuses, fetchStatusUpdates}`.
 - File tipe `newsletter-status.d.ts` dan `dinonic-spr.d.ts`.
@@ -42,12 +64,4 @@
 
 ### Fixed
 - `dinonic-spr.js` mengimpor `encodeSignedDeviceIdentity` dari `generics.js` (tidak ada), sehingga seluruh paket gagal load. Sekarang dari `validate-connection.js`.
-- SPR: disamakan penuh dengan SPR diezyxhao-baileys 1.4.0 (logika identik, hanya CJS → ESM), termasuk fallback `conn.user` saat `authState.creds.me` kosong.
-- `package.json`: `"type": "module"` ditambahkan (kode ESM), duplikat `lru-cache` di devDependencies dihapus.
-
-### Changed
-- Versi `3.0.0` → `5.0.0`, author/owner `Saurus / Dinonic`.
-- README ditulis ulang, banner menampilkan versi & owner.
-
-### Notes
-- Newsletter status diport dari diezyxhao-baileys 1.4.0 ke ESM; tidak mengubah `sendMessage`.
+- SPR: fallback `conn.user` saat `authState.creds.me` kosong.

package/docs/SPR.md

@@ -85,4 +85,4 @@ Foto profil diambil konkuren (10 sekaligus) dengan budget 10 dtk dan batas keras
 
 - Penerima `personal` hanya melihat pesan personalnya; pesan umum tidak dikirim ke mereka.
 - Fitur privat/broadcast diadaptasi dari plugin zapo-js (MIT).
-- Perubahan v5.0.2-alpha.spr.test: engine ditulis ulang (kode baru), tambah `personal`, `sPRPrivate`, `sPRBroadcast`, `getSPRTargets`, `loadSPRAvatars`. API `sPR`/`selectiveRelay` lama tetap kompatibel.
+- Perubahan v5.0.2: engine ditulis ulang (kode baru), tambah `personal`, `sPRPrivate`, `sPRBroadcast`, `getSPRTargets`, `loadSPRAvatars`. API `sPR`/`selectiveRelay` lama tetap kompatibel.

package/lib/Socket/index.js

@@ -6,6 +6,11 @@ import { makePrivacySocket } from './privacy.js'
 import { makeGraphQLSocket } from './graphql.js'
 import { makeMessageBuilderSocket } from './message-builder.js'
 import { sPR, sPRPrivate, sPRBroadcast, getSPRTargets } from '../Utils/dinonic-spr.js'
+import { sendGreetingCard, buildGreetingCardContent } from '../Utils/greeting-card.js'
+import * as GroupHistory from '../Utils/group-history.js'
+import * as MetaAIBot from '../Utils/meta-ai-bot.js'
+import { definePlugin, makePluginHost } from '../Utils/plugins.js'
+import { makePresence, makeProfile } from '../Utils/presence-profile.js'
 import * as DinonicBuilder from '../Utils/MessageBuilder.js'
 import {
     makeNewsletterStatusSender,
@@ -36,12 +41,38 @@ const makeWASocket = (config) => {
     // Builder by Saurus (A2UI, AIRich, Button, ButtonV2, Carousel, Toolkit)
     clientWithBuilder.DinonicBuilder = DinonicBuilder;
 
-    // SPR (Selective Relay)
-    clientWithBuilder.sPR = (jid, message, options) => sPR(clientWithBuilder, jid, message, options);
-    clientWithBuilder.relayMessageSelective = clientWithBuilder.sPR;
-    clientWithBuilder.sPRPrivate = (groupJid, targetJid, options) => sPRPrivate(clientWithBuilder, groupJid, targetJid, options);
-    clientWithBuilder.sPRBroadcast = (groupJid, options) => sPRBroadcast(clientWithBuilder, groupJid, options);
-    clientWithBuilder.getSPRTargets = (groupJid, options) => getSPRTargets(clientWithBuilder, groupJid, options);
+    // Plugin system (sock.use) + fitur bawaan sebagai plugin (bisa dimatikan lewat config.disablePlugins)
+    const host = makePluginHost(clientWithBuilder, newConfig);
+    clientWithBuilder.use = host.use;
+    clientWithBuilder.removePlugin = host.removePlugin;
+    clientWithBuilder.hasPlugin = host.hasPlugin;
+    clientWithBuilder.listPlugins = host.listPlugins;
+    const sock = clientWithBuilder;
+    const builtinPlugins = [
+        definePlugin({
+            id: 'spr',
+            setup: ({ extend }) => extend({
+                sPR: (jid, message, options) => sPR(sock, jid, message, options),
+                relayMessageSelective: (jid, message, options) => sPR(sock, jid, message, options),
+                sPRPrivate: (groupJid, targetJid, options) => sPRPrivate(sock, groupJid, targetJid, options),
+                sPRBroadcast: (groupJid, options) => sPRBroadcast(sock, groupJid, options),
+                getSPRTargets: (groupJid, options) => getSPRTargets(sock, groupJid, options)
+            })
+        }),
+        definePlugin({
+            id: 'greeting-card',
+            setup: ({ extend }) => extend({
+                sendGreetingCard: (jid, opts, sendOptions) => sendGreetingCard(sock, jid, opts, sendOptions),
+                buildGreetingCard: buildGreetingCardContent
+            })
+        }),
+        definePlugin({ id: 'group-history', setup: ({ extend }) => extend({ GroupHistory }) }),
+        definePlugin({ id: 'meta-ai-bot', setup: ({ extend }) => extend({ MetaAIBot }) }),
+        definePlugin({ id: 'presence', exposeAs: 'presence', setup: ({ sock: s }) => makePresence(s) }),
+        definePlugin({ id: 'profile', exposeAs: 'profile', setup: ({ sock: s }) => makeProfile(s) })
+    ];
+    for (const plugin of builtinPlugins) host.use(plugin);
+    for (const plugin of newConfig.plugins ?? []) host.use(plugin);
 
     // Newsletter Status (Channel Status)
     if (!clientWithBuilder.sendNewsletterStatus) {

package/lib/Socket/socket.js

@@ -735,62 +735,92 @@ export const makeSocket = (config) => {
         void end(new Boom(msg || 'Intentional Logout', { statusCode: DisconnectReason.loggedOut }));
     };
     const requestPairingCode = async (phoneNumber, customPairingCode) => {
-        const pairingCode = customPairingCode ?? 'VINXSYNC';
-        if (customPairingCode && customPairingCode?.length !== 8) {
-            throw new Error('Custom pairing code must be exactly 8 chars');
+        if (authState.creds.registered) {
+            throw new Boom('Sesi sudah terdaftar (registered). Hapus folder sesi untuk pairing ulang.', { statusCode: 400 });
         }
-        authState.creds.pairingCode = pairingCode;
+        // Nomor harus angka saja dengan kode negara (tanpa +, spasi, atau strip).
+        const digits = String(phoneNumber ?? '').replace(/\D/g, '');
+        if (digits.length < 7 || digits.length > 15) {
+            throw new Boom('Nomor tidak valid. Gunakan format internasional tanpa +, contoh: 628123456789', { statusCode: 400 });
+        }
+        let customCode;
+        if (customPairingCode) {
+            customCode = String(customPairingCode).toUpperCase();
+            if (!/^[A-Z0-9]{8}$/.test(customCode)) {
+                throw new Error('Custom pairing code must be exactly 8 chars (A-Z, 0-9)');
+            }
+        }
+        // Pastikan koneksi sudah terbuka sebelum mengirim permintaan pairing.
+        await waitForSocketOpen();
+        const previous = {
+            pairingCode: authState.creds.pairingCode,
+            pairingEphemeralKeyPair: authState.creds.pairingEphemeralKeyPair,
+            me: authState.creds.me
+        };
+        // Kode acak baru + keypair ephemeral baru di setiap request (tidak memakai ulang yang lama).
+        authState.creds.pairingCode = customCode ?? bytesToCrockford(randomBytes(5));
+        authState.creds.pairingEphemeralKeyPair = Curve.generateKeyPair();
         authState.creds.me = {
-            id: jidEncode(phoneNumber, 's.whatsapp.net'),
+            id: jidEncode(digits, 's.whatsapp.net'),
             name: '~'
         };
         ev.emit('creds.update', authState.creds);
-        await sendNode({
-            tag: 'iq',
-            attrs: {
-                to: S_WHATSAPP_NET,
-                type: 'set',
-                id: generateMessageTag(),
-                xmlns: 'md'
-            },
-            content: [
-                {
-                    tag: 'link_code_companion_reg',
-                    attrs: {
-                        jid: authState.creds.me.id,
-                        stage: 'companion_hello',
-                        should_show_push_notification: 'true'
-                    },
-                    content: [
-                        {
-                            tag: 'link_code_pairing_wrapped_companion_ephemeral_pub',
-                            attrs: {},
-                            content: await generatePairingKey()
-                        },
-                        {
-                            tag: 'companion_server_auth_key_pub',
-                            attrs: {},
-                            content: authState.creds.noiseKey.public
-                        },
-                        {
-                            tag: 'companion_platform_id',
-                            attrs: {},
-                            content: getCompanionPlatformId(browser)
-                        },
-                        {
-                            tag: 'companion_platform_display',
-                            attrs: {},
-                            content: `${browser[1]} (${browser[0]})`
+        try {
+            await sendNode({
+                tag: 'iq',
+                attrs: {
+                    to: S_WHATSAPP_NET,
+                    type: 'set',
+                    id: generateMessageTag(),
+                    xmlns: 'md'
+                },
+                content: [
+                    {
+                        tag: 'link_code_companion_reg',
+                        attrs: {
+                            jid: authState.creds.me.id,
+                            stage: 'companion_hello',
+                            should_show_push_notification: 'true'
                         },
-                        {
-                            tag: 'link_code_pairing_nonce',
-                            attrs: {},
-                            content: '0'
-                        }
-                    ]
-                }
-            ]
-        });
+                        content: [
+                            {
+                                tag: 'link_code_pairing_wrapped_companion_ephemeral_pub',
+                                attrs: {},
+                                content: await generatePairingKey()
+                            },
+                            {
+                                tag: 'companion_server_auth_key_pub',
+                                attrs: {},
+                                content: authState.creds.noiseKey.public
+                            },
+                            {
+                                tag: 'companion_platform_id',
+                                attrs: {},
+                                content: getCompanionPlatformId(browser)
+                            },
+                            {
+                                tag: 'companion_platform_display',
+                                attrs: {},
+                                content: `${browser[1]} (${browser[0]})`
+                            },
+                            {
+                                tag: 'link_code_pairing_nonce',
+                                attrs: {},
+                                content: '0'
+                            }
+                        ]
+                    }
+                ]
+            });
+        }
+        catch (error) {
+            // Gagal kirim: kembalikan state lama supaya tidak tertinggal kode/keypair setengah jadi.
+            authState.creds.pairingCode = previous.pairingCode;
+            authState.creds.pairingEphemeralKeyPair = previous.pairingEphemeralKeyPair;
+            authState.creds.me = previous.me;
+            ev.emit('creds.update', authState.creds);
+            throw error;
+        }
         return authState.creds.pairingCode;
     };
     async function generatePairingKey() {