@wanzforme/bails 0.0.0-stage → 1.0.0

package/README.md

@@ -1,3 +1,356 @@
-# Temporary Holding Version
+<p align="center">
+  <img src="https://e.top4top.io/p_38721hu6c1.jpg" width="250"/>
+</p>
 
-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.
+<h1 align="center">WhatsApp Baileys</h1>
+
+<p align="center">
+  Open-source library for building fast, stable WhatsApp automation and integrations over WebSocket — no browser required.
+</p>
+
+<p align="center">
+  <img src="https://img.shields.io/badge/Node.js-%3E%3D20-339933?logo=node.js&logoColor=white" alt="Node.js" />
+  <img src="https://img.shields.io/badge/license-MIT-blue" />
+  <img src="https://img.shields.io/badge/multi--device-supported-success" />
+</p>
+
+> [!NOTE]
+> `"@wanzlonely/bails4u": "latest"` is an unofficial WhatsApp Web API library. Not affiliated, not authorized, not maintained, not sponsored, and not endorsed by WhatsApp or Meta.
+>
+> Use Baileys responsibly, and comply with the WhatsApp Terms of Service and applicable laws.
+
+---
+
+# Table of Contents 
+
+- [Requirements](#requirements)
+- [Installation](#installation)
+- [Import](#import)
+- [Quick Start](#quick-start)
+  - [With QR Code](#with-qr-code)
+  - [With Pairing Code](#with-pairing-code)
+- [Sending Message](#sending-messate)
+  - [Generic Send / Relay](#generic-send--relay)
+  - [Simple Senders](#simple-senders)
+  - [Rich Menu](#rich-menu)
+  - [Sending Message with Participant](#sending-message-with-participant)
+- [Message Builder](#message-builder)
+  - [Import](#import)
+  - [Example](#examle)
+- [Button](#button)
+  - [Quick Reply + URL + Copy](#quick-reply--url--copy)
+- [ButtonV2](#buttonv2)
+- [Carousel](#carousel)
+- [Why Choose WhatsApp Baileys?](#why-choose-whatsapp-baileys)
+- [Contributors](#contributors)
+- [Contact Developer](#contact-developer)
+
+---
+
+# Requirements
+
+- Node.js **>= 20**
+- Optional peer dependencies depending on the features you use:
+  - `sharp` or `jimp` for image processing
+  - `link-preview-js` for link previews
+  - `audio-decode` for audio waveform handling
+  - `fluent-ffmpeg` for frame preview video, MessageBuilder Toolkit.getMp4Preview
+  
+---
+
+# Installation
+
+```bash
+npm install @wanzlonely/bails4u
+```
+
+Add it to your `package.json`:
+
+```json
+{
+  "dependencies": {
+    "@wanzlonely/bails4u": "latest"
+  }
+}
+```
+
+---
+
+# Import
+
+```javascript
+const {
+  default: makeWASocket,
+  // Other Options
+} = require('@wanzlonely/bails4u');
+```
+
+---
+
+# Quick Start
+
+## With QR Code
+
+```javascript
+const {
+  default: makeWASocket,
+  Browsers
+  // Other Options
+} = require('@wanzlonely/bails4u');
+
+const client = makeWASocket({
+  browser: Browsers.ubuntu('Chrome'),
+  printQRInTerminal: true
+});
+```
+
+## With Pairing Code
+
+```javascript
+const {
+  default: makeWASocket,
+  fetchLatestWAWebVersion,
+  Browsers
+} = require('@wanzlonely/bails4u');
+
+const client = makeWASocket({
+  browser: Browsers.ubuntu('Chrome'),
+  printQRInTerminal: false,
+  version: fetchLatestWAWebVersion(),
+  auth: state
+});
+
+const number = "628XXXXX";
+const code = await client.requestPairingCode(number.trim()); // Use (number, "XXXXXXXX") for custom pairing
+
+console.log("Ur pairing code : " + code);
+```
+
+---
+
+# Sending Message
+
+## Generic Send / Relay
+
+```javascript
+// relayMessage — sends a raw message object, bypassing the sendMessage pipeline
+await client.relayMessage(m.chat, {
+  conversation: 'WnzLnly'
+})
+
+// sendMessage — the standard way to send a message
+await client.sendMessage(m.chat, {
+  text: 'WnzLnly'
+})
+```
+
+## Simple Senders
+
+```javascript
+await client.sendText(m.chat, 'Hi!', { contextInfo: { mentionedJid: [jid] } })
+await client.sendImage(m.chat, { url: './photo.jpg' }, 'image caption')
+await client.sendVideo(m.chat, { url: './clip.mp4' }, 'video caption')
+await client.sendAudio(m.chat, { url: './clip.mp3' })
+await client.sendLocation(m.chat, 'Location name', -6.2, 106.8, 'https://maps.example', '1234567890')
+await client.sendPoll(m.chat, 'Pick one', ['Option 1', 'Option 2', 'Option 3'], /* multiSelect */ true)
+await client.sendQuiz(m.chat, 'Correct answer?', ['1', '2', '3'], /* correctIndex */ '2')
+```
+
+## Rich Menu
+
+`sendRich` sends a rich response with an optional header image, action buttons, carousel cards, and an open-URL footer:
+
+```javascript
+await client.sendRich(m.chat, {
+  header: {
+    disclaimer: true,
+    disclaimerText: "t.me/WanzzWangsaf",
+    title: "WnzLnly"
+  },
+  body: {
+    title: "Select Option",
+    buttons: ["Menu 1", "Menu 2"]
+  },
+  footer: {
+    text: "Telegram Channel",
+    url: "https://t.me/aboutvin7x"
+  }
+});
+```
+
+# Sending Message with Participant
+
+`relayMessage`:
+
+```javascript
+await client.relayMessage(m.chat, {
+  extendedTextMessage: {
+    text: "WnzLnly"
+  }
+}, {
+  ptcp: true
+});
+```
+
+`sendMessage`:
+
+```javascript
+await client.sendMessage(m.chat, {
+  text: "WnzLnly"
+}, {
+  ptcp: true
+});
+```
+
+---
+
+# Message Builder
+
+MessageBuilder v4.7 is included directly in `"npm:@wanzlonely/bails4u"`.
+
+## Import
+
+```javascript
+const {
+  VERSION, 
+  Button, 
+  ButtonV2, 
+  Carousel, 
+  AIRich, 
+  Toolkit, 
+  bind,
+  MB
+} = require('@wanzlonely/bails4u');
+```
+
+> [!NOTE]
+> MessageBuilder is integrated. You don't need to install `baileys-mbuilder` separately.
+
+---
+
+## Example
+
+```javascript
+const { MB } = require('@wanzlonely/bails4u')
+
+const rich = new MB.AIRich(sock)
+  .setTitle('WnzLnly')
+  .setFooter('Dibuat dengan AIRich')
+  .addText('Halo! Ini respons rich.')
+  .addCode('javascript', `console.log('Halo Wanz')`)
+  .addTable([
+    ['Fitur', 'Status'],
+    ['Button', 'Tersedia'],
+    ['Carousel', 'Tersedia'],
+    ['AIRich', 'Eksperimental']
+  ])
+  .addSuggest(['List Menu', 'Help', 'About Wanz'])
+
+await rich.send(jid)
+```
+
+---
+
+## Button
+
+Builder `Button` is used for native-flow interactive messages.
+
+### Quick Reply + URL + Copy
+
+```js
+const { MB } = require('@wanzlonely/bails4u')
+
+const msg = new MB.Button(client)
+  .setTitle('Select Menu')
+  .setBody('Pilih salah satu di bawah.')
+  .setFooter('t.me/WanzzWangsaf')
+  .addReply('Ping', 'ping')
+  .addUrl('Buka Website', 'https://example.com')
+  .addCopy('Salin Kode', 'WnzLnly')
+
+await msg.send(m.chat)
+```
+
+---
+
+## ButtonV2
+
+`ButtonV2` provides a simpler classic button builder.
+
+```javasript
+const { MB } = require('@wanzlonely/bails4u')
+
+const message = new MB.ButtonV2(client)
+  .setTitle('WnzLnly')
+  .setSubtitle('WhatsApp Bot')
+  .setBody('Pilih satu tindakan.')
+  .setFooter('Wanz Baileys')
+  .setThumbnail('https://example.com/xxx.jpg')
+  .addButton('Menu', 'menu')
+  .addButton('Ping', 'ping')
+
+await message.send(m.chat)
+```
+
+---
+
+## Carousel
+
+Carousel cards can be created from `Button.toCard()` and then submitted to `Carousel`.
+
+```js
+const { MB } = require('@wanzlonely/bails4u')
+
+const card1 = await new MB.Button(client)
+  .setImage('https://example.com/card1.jpg')
+  .setBody('Kartu pertama')
+  .addReply('Pilih', 'card_1')
+  .toCard()
+
+const card2 = await new MB.Button(client)
+  .setImage('https://example.com/card2.jpg')
+  .setBody('Kartu kedua')
+  .addUrl('Buka', 'https://example.com')
+  .toCard()
+
+const carousel = new MB.Carousel(client)
+  .setBody('Pilih salah satu kartu di bawah.')
+  .setFooter('Wanz Carousel')
+  .addCard([card1, card2])
+
+await carousel.send(jid)
+```
+
+> [!IMPORTANT]
+> Each carousel card must have an image or video media attachment in its header.
+
+---
+
+# Why Choose WhatsApp Baileys?
+
+Because this library offers high stability, full features, and an actively improved pairing process. It is ideal for developers aiming to create professional and secure WhatsApp automation solutions. Support for the latest WhatsApp features ensures compatibility with platform updates.
+
+---
+
+# Contributors
+
+<table>
+  <tr>
+    <td align="center">
+      <a href="https://github.com/wanzchil">
+        <img src="https://github.com/wanzchil.png" width="80px;" style="border-radius:50%;" alt="Main contributor"/>
+        <br /><sub><b>Wanz Lonely</b></sub>
+      </a>
+    </td>
+  </tr>
+</table>
+
+---
+
+## Contact Developer
+
+For questions, support, or collaboration, feel free to contact the developer:
+
+- **Telegram**: [Telegram Contact](https://t.me/WanzzWangsaf)
+- **Channel WhatsApp**: [Channel WhatsApp](https://whatsapp.com/channel/0029Vb0A6XC3WHTORDf0Pn3V)
+- **Channel Telegram**: [Channel Telegram](https://t.me/wanznotdev)

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