@izi-coder/baileys 0.0.0-stage → 6.0.9

package/LICENSE

@@ -0,0 +1,49 @@
+MIT License
+
+Copyright (c) 2026 @iziBrothers
+
+
+ATTRIBUTION AND PROVENANCE
+
+
+This project is a derivative work of Baileys
+(https://github.com/WhiskeySockets/Baileys), released under the MIT
+License. All modifications, extensions, and ongoing maintenance in this
+repository are authored by @iziBrothers.
+
+The following upstream copyright notices are preserved in full, as
+required by the terms of the MIT License:
+
+  Copyright (c) 2021       Adhiraj Singh
+  Copyright (c) 2022-2026  WhiskeySockets and Baileys contributors
+
+LICENSE TERMS
+
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.
+
+
+DISCLAIMER OF AFFILIATION
+
+
+This project is an independent, unofficial work. It is not affiliated
+with, authorized, maintained, sponsored, or endorsed by WhatsApp LLC,
+Meta Platforms, Inc., or any of their affiliates. All product names,
+trademarks, and registered trademarks are the property of their
+respective owners.

package/README.md

@@ -1,3 +1,520 @@
-# Temporary Holding Version
+<div align="center">
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+<img src="https://ziperrimg2.lovable.app/f/kedfkhvk9d.jpg" width="480" alt="XkyuurBails Banner">
+
+<h1>XkyuurBails</h1>
+
+<p><b>WhatsApp Web library ringan berbasis Baileys</b><br>
+Fokus pada pengelolaan pesan, raw message relay, dan utilitas tambahan untuk kebutuhan otomasi.</p>
+
+<p>
+  <a href="https://nodejs.org/">
+    <img src="https://img.shields.io/badge/Node.js-%3E%3D20-7C3AED?style=for-the-badge&logo=node.js&logoColor=white" alt="Node.js">
+  </a>
+  <a href="https://github.com/whiskeysockets/Baileys">
+    <img src="https://img.shields.io/badge/Baileys-Based-A78BFA?style=for-the-badge" alt="Baileys">
+  </a>
+  <a href="LICENSE">
+    <img src="https://img.shields.io/badge/License-MIT-9333EA?style=for-the-badge" alt="License">
+  </a>
+</p>
+
+<p>
+  <a href="#-fitur">Fitur</a> •
+  <a href="#-instalasi">Instalasi</a> •
+  <a href="#-quick-start">Quick Start</a> •
+  <a href="#-messaging">Messaging</a> •
+  <a href="#-raw-message-relay">Raw Relay</a> •
+  <a href="#-events">Events</a> •
+  <a href="#-authentication">Auth</a>
+</p>
+
+</div>
+
+---
+
+> [!WARNING]
+> **Tidak berafiliasi dengan WhatsApp LLC atau Meta Platforms.**
+> Gunakan library ini secara bertanggung jawab dan patuhi [WhatsApp Terms of Service](https://www.whatsapp.com/legal/terms-of-service). Segala bentuk penyalahgunaan sepenuhnya menjadi tanggung jawab pengguna.
+
+---
+
+## Daftar Isi
+
+- [Fitur](#-fitur)
+- [Persyaratan](#-persyaratan)
+- [Instalasi](#-instalasi)
+- [Quick Start](#-quick-start)
+- [Messaging](#-messaging)
+- [Raw Message Relay](#-raw-message-relay)
+- [Events](#-events)
+- [Authentication](#-authentication)
+- [Contoh Lengkap](#-contoh-lengkap)
+- [Thanks To](#-thanks-to)
+- [Disclaimer](#-disclaimer)
+- [License](#-license)
+
+---
+
+## </> Fitur
+
+| Kategori | Kemampuan |
+|----------|-----------|
+| **Connection** | WhatsApp Web connection, QR authentication, Pairing code, Multi-device authentication |
+| **Messaging** | `sendMessage`, `relayMessage`, `XyuSelf`, raw message support, custom message structure |
+| **Events** | Event handling lengkap melalui `sock.ev` |
+| **Utilities** | Utilitas tambahan untuk mempercepat development |
+
+---
+
+## </> Persyaratan
+
+- **Node.js** `>= 20.0.0`
+- **npm** `>= 9` (atau pnpm/yarn)
+- Akun WhatsApp aktif (disarankan gunakan nomor sekunder untuk testing)
+
+---
+
+## </> Instalasi
+
+Tambahkan dependency ke `package.json`:
+
+```json
+{
+  "dependencies": {
+    "izi-coder/baileys": latest",
+    "jimp": "^1.6.1"
+  }
+}
+```
+
+Lalu install:
+
+```bash
+npm install
+```
+
+Atau langsung melalui CLI:
+
+```bash
+npm install izi-coder/baileys@latest
+```
+
+Kemudian import di project kamu:
+
+```js
+const { useMultiFileAuthState } = require('izi-coder/baileys')
+```
+
+---
+
+## </> Quick Start
+
+```js
+const makeWASocket = require('izi-coder/baileys').default
+const { useMultiFileAuthState } = require('izi-coder/baileys')
+
+async function start() {
+  const { state, saveCreds } = await useMultiFileAuthState('./session')
+
+  const sock = makeWASocket({ auth: state })
+
+  sock.ev.on('creds.update', saveCreds)
+
+  sock.ev.on('connection.update', ({ connection }) => {
+    console.log('[ CONNECTION ]', connection)
+  })
+}
+
+start()
+```
+
+---
+
+## </> Messaging
+
+### Text Message
+
+```js
+await sock.sendMessage('628xxxxxxxxxx@s.whatsapp.net', {
+  text: 'Hello'
+})
+```
+
+### Image Message
+
+```js
+await sock.sendMessage('628xxxxxxxxxx@s.whatsapp.net', {
+  image: { url: './image.jpg' },
+  caption: 'Hello'
+})
+```
+
+### Video Message
+
+```js
+await sock.sendMessage('628xxxxxxxxxx@s.whatsapp.net', {
+  video: { url: './video.mp4' },
+  caption: 'Hello'
+})
+```
+
+### Order Message
+
+```js
+const fs = require('fs')
+const thumbnail = fs.readFileSync('./pouthumb.jpg')
+
+await sock.sendMessage(m.chat, {
+  thumbnail,
+  message: 'Order summary',
+  orderTitle: 'My Store',
+  totalAmount1000: 72502,
+  totalCurrencyCode: 'IDR'
+}, { quoted: m })
+```
+
+### Poll Result Snapshot
+
+```js
+await sock.sendMessage(m.chat, {
+  pollResultMessage: {
+    name: 'My Poll',
+    options: [
+      { optionName: 'Option 1' },
+      { optionName: 'Option 2' }
+    ],
+    newsletter: {
+      newsletterName: '0X8 - Society',
+      newsletterJid: '120363424944937940@newsletter'
+    }
+  }
+})
+```
+
+### Product Message
+
+```js
+await sock.relayMessage(m.chat, {
+  productMessage: {
+    title: 'Product.pdf',
+    description: 'Product description',
+    thumbnail: { url: './pouthumb.jpg' },
+    productId: 'EXAMPLE_TOKEN',
+    retailerId: 'EXAMPLE_RETAILER_ID',
+    url: 'https://example.com',
+    body: 'Body text',
+    footer: 'Footer',
+    buttons: [
+      {
+        name: 'cta_url',
+        buttonParamsJson: '{"display_text":"Visit","url":"https://example.com"}'
+      }
+    ],
+    priceAmount1000: 72502,
+    currencyCode: 'IDR'
+  }
+})
+```
+
+### Interactive Message
+
+```js
+await sock.sendMessage(m.chat, {
+  image: { url: './ximg.jpg' },
+  text: 'body',
+  title: 'title',
+  footer: 'footer',
+  interactiveButtons: [
+    {
+      name: 'single_select',
+      buttonParamsJson: JSON.stringify({ title: '\0' })
+    }
+  ],
+  messageParams: JSON.stringify({
+    bottom_sheet: {
+      /* other params */
+    }
+  })
+})
+```
+
+### Member Label
+
+```js
+await sock.sendMessage(m.chat, {
+  groupLabel: {
+    labelText: 'Tagged members appear here'
+  }
+})
+```
+
+### Broadcast ke Member Grup
+
+```js
+await sock.sendMessageMembers(m.chat, {
+  extendedTextMessage: {
+    text: 'Hello members'
+  }
+}, {})
+```
+
+---
+
+## </> Raw Message Relay
+
+`relayMessage()` digunakan untuk mengirim raw message object secara langsung tanpa harus melalui helper tambahan. Cocok untuk mengirim struktur pesan kustom atau pesan yang tidak tersedia di `sendMessage`.
+
+```js
+await sock.relayMessage(target, message, {
+  messageId: message.key.id
+})
+```
+
+### Opsi `XyuSelf`
+
+`XyuSelf` adalah opsi khusus `relayMessage` untuk chat **private / 1-on-1** yang mengatur apakah pesan ikut disinkronkan ke perangkat lain milik akun sendiri.
+
+| Nilai | Perilaku |
+|-------|----------|
+| `XyuSelf: true` | Pesan **tidak** disinkronkan ke perangkat lain milik pengirim |
+| `XyuSelf: false` | Menggunakan perilaku sinkronisasi normal |
+
+> Opsi ini **tidak** mengubah target penerima pesan.
+
+```js
+await sock.relayMessage(target, message, {
+  messageId: message.key.id,
+  XyuSelf: true
+})
+```
+
+> [!NOTE]
+> Perilaku sinkronisasi bergantung pada implementasi protokol WhatsApp dan sebaiknya diuji terlebih dahulu pada perangkat tertaut.
+
+---
+
+## </> Contoh Relay
+
+### Conversation
+
+```js
+await sock.relayMessage(jid, {
+  conversation: 'Hello'
+}, { XyuSelf: true })
+```
+
+### Extended Text
+
+```js
+await sock.relayMessage(jid, {
+  extendedTextMessage: {
+    text: 'Hello'
+  }
+}, { XyuSelf: true })
+```
+
+### Image Message
+
+```js
+await sock.relayMessage(jid, {
+  imageMessage: {
+    url: './image.jpg',
+    caption: 'Hello'
+  }
+}, { XyuSelf: true })
+```
+
+### Video Message
+
+```js
+await sock.relayMessage(jid, {
+  videoMessage: {
+    url: './video.mp4',
+    caption: 'Hello'
+  }
+}, { XyuSelf: true })
+```
+
+### Custom Message
+
+```js
+await sock.relayMessage(jid, {
+  extendedTextMessage: {
+    text: 'Custom message',
+    contextInfo: {
+      mentionedJid: []
+    }
+  }
+}, { XyuSelf: true })
+```
+
+---
+
+## </> Events
+
+Semua event tersedia melalui `sock.ev`.
+
+### Connection Update
+
+```js
+sock.ev.on('connection.update', ({ connection }) => {
+  console.log('[ CONNECTION ]', connection)
+})
+```
+
+### Incoming Message
+
+```js
+sock.ev.on('messages.upsert', ({ messages }) => {
+  for (const message of messages) {
+    console.log('[ INCOMING ]', message.message)
+  }
+})
+```
+
+### Credentials
+
+```js
+sock.ev.on('creds.update', saveCreds)
+```
+
+---
+
+## </> Authentication
+
+Session disimpan secara lokal pada folder yang ditentukan:
+
+```text
+session/
+├── creds.json
+├── app-state-sync-key-*.json
+└── ...
+```
+
+> [!CAUTION]
+> **Jangan pernah** meng-upload folder `session` ke repository publik. File tersebut berisi kredensial autentikasi akun kamu.
+
+Tambahkan ke `.gitignore`:
+
+```gitignore
+session/
+node_modules/
+.env
+```
+
+---
+
+## </> Contoh Lengkap
+
+```js
+const makeWASocket = require('izi-coder/baileys').default
+const { useMultiFileAuthState } = require('izi-coder/baileys')
+
+async function start() {
+  const { state, saveCreds } = await useMultiFileAuthState('./session')
+
+  const sock = makeWASocket({ auth: state })
+
+  sock.ev.on('creds.update', saveCreds)
+  sock.ev.on('connection.update', ({ connection }) => {
+    console.log('[ CONNECTION ]', connection)
+  })
+
+  async function relay(jid, message) {
+    return sock.relayMessage(jid, message, {
+      messageId: message.key?.id,
+      XyuSelf: true
+    })
+  }
+
+  return { sock, relay }
+}
+
+start().catch(console.error)
+```
+
+---
+
+## </> Thanks To
+
+<div align="center">
+
+<table>
+  <tr>
+    <td align="center" width="33%">
+      <a href="https://t.me/iziBrothers">
+        <img src="https://ziperrimg2.lovable.app/f/znsg5jjuvr.jpg" width="100" height="100" alt="íᴢìCódérs">
+      </a>
+      <br>
+      <b>íᴢìCódérs</b>
+      <br>
+      <sub>Developer</sub>
+      <br>
+      <a href="https://t.me/iziBrothers">@iziBrothers</a>
+    </td>
+    <td align="center" width="33%">
+      <a href="https://t.me/XzRzSynxC">
+        <img src="https://e.top4top.io/p_3967y77nb1.jpg" width="100" height="100" alt="println Rz">
+      </a>
+      <br>
+      <b>println!("Rz");</b>
+      <br>
+      <sub>Support</sub>
+      <br>
+      <a href="https://t.me/XzRzSynxC">@XzRzSynxC</a>
+    </td>
+    <td align="center" width="33%">
+      <a href="https://t.me/pouskibudi">
+        <img src="https://l.top4top.io/p_3967g0nxi1.jpg" width="100" height="100" alt="PouCode">
+      </a>
+      <br>
+      <b>PouCode</b>
+      <br>
+      <sub>Support</sub>
+      <br>
+      <a href="https://t.me/pouskibudi">@pouskibudi</a>
+    </td>
+  </tr>
+</table>
+
+</div>
+
+### Credits
+
+<div align="center">
+
+**@iziBrothers** — Main Developer & Maintainer
+<br>
+Based on **[Baileys](https://github.com/whiskeysockets/Baileys)**
+
+</div>
+
+---
+
+## </> Disclaimer
+
+Project ini dibuat untuk keperluan **development** dan **educational**.
+
+Developer tidak bertanggung jawab atas penyalahgunaan library, pembatasan akun, atau pelanggaran Terms of Service WhatsApp. Segala risiko penggunaan sepenuhnya menjadi tanggung jawab pengguna.
+
+---
+
+## </> License
+
+Project ini dirilis di bawah **MIT License**.
+Lihat file [`LICENSE`](LICENSE) untuk informasi lebih lanjut.
+
+---
+
+<div align="center">
+
+<img src="https://img.shields.io/badge/XzBails-7C3AED?style=for-the-badge">
+
+<br><br>
+
+**XzBails**
+
+<sub>Built with Baileys · Maintained by <a href="https://t.me/iziBrothers">@iziBrothers</a></sub>
+
+</div>

package/WAProto/GenerateStatics.sh

@@ -0,0 +1,3 @@
+yarn pbjs -t static-module --no-beautify -w es6 --no-bundle --no-delimited --no-verify --no-comments -o ./index.js ./WAProto.proto;
+yarn pbjs -t static-module --no-beautify -w es6 --no-bundle --no-delimited --no-verify ./WAProto.proto | yarn pbts --no-comments -o ./index.d.ts -;
+node ./fix-imports.js