@kyyinfinite/baileys 1.0.0 → 2.0.0

package/README.md

@@ -1,10 +1,11 @@
 <div align="center">
 
-<img src="https://readme-typing-svg.demolab.com?font=Fira+Code&weight=700&size=15&duration=2500&pause=800&color=00B4D8&center=true&vCenter=true&width=750&lines=@kyyinfinite%2Fbaileys+%E2%80%94+v0.1.0;Interactive+Messages+%7C+Flow+Buttons+%7C+List+Menus;AI+Rich+Response+%7C+Table+%7C+Code+Block+%7C+Link;Album+Messages+%7C+Multi-media+Grouped+Delivery;ESM-only+%7C+TypeScript+%7C+Signal+Protocol;Drop-in+replacement+for+whiskeysockets%2Fbaileys" alt="Typing SVG" />
+<img src="https://readme-typing-svg.demolab.com?font=Fira+Code&weight=700&size=15&duration=2500&pause=800&color=00B4D8&center=true&vCenter=true&width=750&lines=@kyyinfinite%2Fbaileys+%E2%80%94+v2.0.0;Interactive+Messages+%7C+Flow+Buttons+%7C+List+Menus;AI+Rich+Response+%7C+Table+%7C+Code+Block+%7C+Link;Album+Messages+%7C+Multi-media+Grouped+Delivery;Based+on+WhiskeySockets%2FBaileys+v7.0.0-rc14;ESM-only+%7C+TypeScript+%7C+Signal+Protocol" alt="Typing SVG" />
 
 <br/>
 
-[![npm version](https://img.shields.io/badge/npm-v0.1.0-CB3837?style=for-the-badge&logo=npm&logoColor=white)](https://www.npmjs.com/package/@kyyinfinite/baileys)
+[![npm version](https://img.shields.io/badge/npm-v2.0.0-CB3837?style=for-the-badge&logo=npm&logoColor=white)](https://www.npmjs.com/package/@kyyinfinite/baileys)
+[![Baileys base](https://img.shields.io/badge/Baileys-7.0.0--rc14-00B4D8?style=for-the-badge)](https://github.com/WhiskeySockets/Baileys/releases/tag/v7.0.0-rc14)
 [![npm downloads](https://img.shields.io/badge/downloads-monthly-00B4D8?style=for-the-badge&logo=npm&logoColor=white)](https://www.npmjs.com/package/@kyyinfinite/baileys)
 [![License](https://img.shields.io/badge/license-MIT-green?style=for-the-badge)](LICENSE)
 [![Node.js](https://img.shields.io/badge/node-%3E%3D20.0.0-339933?style=for-the-badge&logo=nodedotjs&logoColor=white)](https://nodejs.org)
@@ -14,15 +15,16 @@
 
 <br/>
 
-**A modded build of [WhiskeySockets/Baileys](https://github.com/WhiskeySockets/Baileys)**  
-with native support for **interactive messages**, **album messages**, **unified AI rich responses**,  
-**newsletter helpers**, **status mentions**, and additional **business / community utilities**.
+**`@kyyinfinite/baileys`** is built on top of the official **[WhiskeySockets/Baileys](https://github.com/WhiskeySockets/Baileys) v7.0.0-rc14** release.  
+It keeps the native Baileys socket API intact while adding a cleaner **Kyyinfinite Simple API** for message building, media, buttons, carousels, and other helpers.
 
 <br/>
 
 > [!IMPORTANT]
 > **`@kyyinfinite/baileys`** is **ESM-only**. You must set `"type": "module"` in your `package.json`.  
 > CommonJS projects must migrate or use dynamic `import()` wrappers.
+> 
+> **Base:** `@whiskeysockets/baileys@7.0.0-rc14`
 
 <br/>
 
@@ -36,12 +38,16 @@ with native support for **interactive messages**, **album messages**, **unified
 - [✅ Requirements](#-requirements)
 - [📦 Installation](#-installation)
 - [🚀 Quick Start](#-quick-start)
-  - [Project Setup](#1-project-setup)
-  - [Install Dependencies](#2-install-dependencies)
-  - [Create index.js](#3-create-indexjs)
-  - [QR Code Login](#4-run--qr-code-login)
-  - [Pairing Code Login](#5-pairing-code-login)
-  - [Auto Reconnect](#6-auto-reconnect)
+- [✨ Simple API](#-simple-api)
+  - [Setup](#setup)
+  - [Text](#text-1)
+  - [Media](#media)
+  - [Message Builder](#message-builder)
+  - [Buttons](#buttons)
+  - [Carousel](#carousel-1)
+  - [Generic Message Helpers](#generic-message-helpers)
+  - [Non-mutating API](#non-mutating-api)
+  - [Native Baileys Still Works](#native-baileys-still-works)
 - [💬 Message Examples](#-message-examples)
   - [Text](#text)
   - [Image](#image)
@@ -92,11 +98,11 @@ with native support for **interactive messages**, **album messages**, **unified
 
 | Feature | Description | Status |
 |---|---|:---:|
-| **Interactive Messages** | Native flow buttons, list/select menus, button wrappers, carousel support via Dugong | ✅ |
+| **Interactive Messages** | Native Baileys interactive messages, native flow buttons, list/select menus, and carousel structures | ✅ |
 | **Flow Buttons** | `quick_reply`, `cta_url`, `cta_copy` and more button types | ✅ |
 | **Native Button** | Native WhatsApp button structures | ✅ |
-| **Carousel** | Multi-card carousel messages via Dugong | ✅ |
-| **AI Rich Response** | `sendTable`, `sendList`, `sendCodeBlock`, `sendRichMessage`, `sendUnifiedResponse` | ✅ |
+| **Carousel** | Multi-card carousel messages using Baileys `interactiveMessage` / `carouselMessage` structures | ✅ |
+| **AI Rich Response** | Rich-response message structures plus Kyyinfinite helper methods such as `sendTable`, `sendList`, `sendCodeBlock`, and `sendUnifiedResponse` | ✅ |
 | **Album Messages** | Multi-image/video album relay with count metadata and grouped delivery | ✅ |
 | **Link Messages** | Rich inline links with citations, proofs, and forwarded bot context | ✅ |
 | **Table Message** | `sendTable()` / `sendTableV2()` styled as Meta AI tables | ✅ |
@@ -124,6 +130,7 @@ with native support for **interactive messages**, **album messages**, **unified
 | Requirement | Version / Detail |
 |---|---|
 | **Node.js** | `>= 20.0.0` |
+| **Baileys base** | `7.0.0-rc14` |
 | **Module system** | ESM only — `"type": "module"` in `package.json` |
 | **Auth store** | Persistent auth required for production use |
 
@@ -364,6 +371,320 @@ sock.ev.on("connection.update", ({ connection, lastDisconnect }) => {
 
 ---
 
+## ✨ Simple API
+
+> [!NOTE]
+> **v2.0.0** introduces the `@kyyinfinite/baileys` Simple API — a fluent wrapper on top of the native socket.
+> Native Baileys methods remain available and unchanged.
+
+### Setup
+
+```js
+import makeWASocket, {
+  useMultiFileAuthState,
+  attachKyyinfinite,
+} from "@kyyinfinite/baileys";
+
+const { state, saveCreds } = await useMultiFileAuthState("./session");
+
+const sock = makeWASocket({
+  auth: state,
+});
+
+sock.ev.on("creds.update", saveCreds);
+
+attachKyyinfinite(sock);
+```
+
+After attaching the wrapper, the socket can use both the original Baileys API and the simpler fluent API.
+
+### Text
+
+```js
+await sock.text("Hello")
+  .send(jid);
+```
+
+### Media
+
+```js
+await sock.image({ url: "./image.jpg" })
+  .caption("Hello")
+  .send(jid);
+
+await sock.video({ url: "./video.mp4" })
+  .caption("Video")
+  .send(jid);
+
+await sock.audio({ url: "./audio.mp3" })
+  .send(jid);
+
+await sock.voice({ url: "./voice.ogg" })
+  .send(jid);
+
+await sock.sticker({ url: "./sticker.webp" })
+  .send(jid);
+
+await sock.document({ url: "./file.pdf" })
+  .fileName("document.pdf")
+  .send(jid);
+
+await sock.ptv({ url: "./video.mp4" })
+  .send(jid);
+
+await sock.gif({ url: "./video.mp4" })
+  .send(jid);
+```
+
+### Message Builder
+
+```js
+await sock.text("Hello")
+  .footer("Powered by @kyyinfinite/baileys")
+  .mentions(["6281234567890@s.whatsapp.net"])
+  .send(jid);
+```
+
+Supported fluent options include:
+
+```text
+text()
+footer()
+context()
+mentions()
+viewOnce()
+edit()
+payload()
+build()
+send()
+```
+
+### Buttons
+
+```js
+await sock.button()
+  .title("Welcome")
+  .body("Choose an option")
+  .footer("Powered by @kyyinfinite/baileys")
+  .addButton("Menu", "menu")
+  .send(jid);
+```
+
+CTA helpers are also available:
+
+```js
+await sock.button()
+  .title("Actions")
+  .body("Choose an action")
+  .reply("Reply", "reply_1")
+  .url("Website", "https://example.com")
+  .copy("Copy", "KYY-001")
+  .call("Call", "628123456789")
+  .send(jid);
+```
+
+The copy helper also supports the shorthand typo-compatible alias:
+
+```js
+.copy("Copy", "KYY-001")
+.coppy("Copy", "KYY-001")
+```
+
+Additional button helpers:
+
+```text
+reply() / quickReply()
+call()
+url()
+copy() / coppy()
+reminder()
+cancelReminder()
+address()
+location()
+select()
+section()
+row()
+```
+
+### ButtonV2
+
+```js
+await sock.buttonV2()
+  .title("Button V2")
+  .body("Choose an option")
+  .send(jid);
+```
+
+The raw builder is still available when full low-level control is required.
+
+### Carousel
+
+The carousel API supports a nested fluent card builder:
+
+```js
+await sock.carousel()
+  .body("Choose a product")
+  .footer("Kyyinfinite")
+  .card()
+    .image({ url: "./product-1.jpg" })
+    .title("Product One")
+    .body("Product description")
+    .button("Pilih", "product_1")
+    .url("Website", "https://example.com")
+    .copy("Copy Code", "KYY-001")
+    .call("Call", "628123456789")
+    .add()
+  .card()
+    .image({ url: "./product-2.jpg" })
+    .title("Product Two")
+    .body("Product two")
+    .button("Pilih", "product_2")
+    .add()
+  .send(jid);
+```
+
+Card helpers:
+
+```text
+title()
+body() / text()
+footer()
+image()
+video()
+media()
+button()
+reply() / quickReply()
+url()
+copy() / coppy()
+call()
+buttons()
+rawButton()
+context()
+payload()
+build()
+add()
+end()
+```
+
+Carousel helpers:
+
+```text
+card()
+addCard()
+cards()
+clear()
+title()
+subtitle()
+body() / text()
+footer()
+context()
+payload()
+loadFrom()
+build()
+send()
+```
+
+### Generic Message Helpers
+
+```js
+await sock.message({ text: "Hello" })
+  .send(jid);
+
+await sock.poll(
+  "What's your favorite language?",
+  ["JavaScript", "TypeScript", "Python"],
+  1
+).send(jid);
+
+await sock.location({
+  degreesLatitude: -6.2088,
+  degreesLongitude: 106.8456,
+  name: "Jakarta"
+}).send(jid);
+
+await sock.react(msg.key, "👍");
+
+await sock.delete(msg.key);
+```
+
+Available helpers include:
+
+```text
+message()
+poll()
+event()
+album()
+contacts()
+location()
+buttonReply()
+listReply()
+react()
+groupInvite()
+product()
+requestPhoneNumber()
+sharePhoneNumber()
+pin()
+forward()
+delete()
+disappearing()
+limitSharing()
+```
+
+### Non-mutating API
+
+If you do not want to modify the socket object, create a separate API facade:
+
+```js
+import {
+  createKyyinfinite,
+} from "@kyyinfinite/baileys";
+
+const api = createKyyinfinite(sock);
+
+await api.text("Hello")
+  .send(jid);
+```
+
+The facade keeps the original socket accessible through `api.raw`:
+
+```js
+api.raw
+```
+
+Raw wrapper classes are available through:
+
+```js
+api.raw.Button
+api.raw.ButtonV2
+api.raw.Carousel
+api.raw.AIRich
+api.raw.Toolkit
+api.raw.Foad
+api.raw.Foad2
+```
+
+Use the Simple API for everyday message construction while keeping the raw builders available whenever lower-level control is needed.
+
+### Native Baileys Still Works
+
+The Simple API does not replace native socket methods:
+
+```js
+await sock.sendMessage(jid, {
+  text: "Hello from native Baileys"
+});
+
+await sock.sendPresenceUpdate("composing", jid);
+
+sock.ev.on("messages.upsert", ({ messages }) => {
+  console.log(messages);
+});
+```
+
+Use the Simple API when you want shorter, cleaner code. Use the native API or `.raw` builders whenever you need lower-level control.
+
+---
+
 ## 💬 Message Examples
 
 ### Text
@@ -551,8 +872,8 @@ await sock.sendMessage(jid, {
 ## ⚡ Interactive Messages
 
 > [!NOTE]
-> Interactive messages are powered by the **Dugong** layer in `@kyyinfinite/baileys`.  
-> These are not available in the official WhiskeySockets/Baileys.
+> Interactive messages are based on the native **Baileys v7.0.0-rc14** message structures.  
+> The Kyyinfinite Simple API provides a shorter fluent interface on top of those native structures.
 
 ### Flow Buttons
 
@@ -657,43 +978,74 @@ await sock.sendMessage(jid, {
 
 ### Carousel
 
+For the native Baileys structure, a carousel is represented by an `interactiveMessage` containing a `carouselMessage`. Media headers are prepared before the message is relayed:
+
 ```js
-import { Dugong } from "@kyyinfinite/baileys";
+import {
+  proto,
+  prepareWAMessageMedia,
+  generateWAMessageFromContent,
+} from "@kyyinfinite/baileys";
 
-await sock.sendMessage(jid, {
-  interactiveMessage: Dugong.carousel({
-    cards: [
-      {
-        header: {
-          imageUrl: "https://example.com/card1.jpg",
-        },
-        title: "Card One",
-        body: "Description for the first card.",
-        buttons: [
-          {
-            name: "quick_reply",
-            buttonParamsJson: JSON.stringify({ display_text: "Select", id: "card_1" }),
-          },
-        ],
+const cards = [];
+
+for (const [index, imageUrl] of [
+  "https://example.com/card1.jpg",
+  "https://example.com/card2.jpg",
+]) {
+  const media = await prepareWAMessageMedia(
+    { image: { url: imageUrl } },
+    { upload: sock.waUploadToServer },
+  );
+
+  cards.push(
+    proto.Message.InteractiveMessage.fromObject({
+      header: {
+        title: `Card ${index + 1}`,
+        hasMediaAttachment: true,
+        ...media,
       },
-      {
-        header: {
-          imageUrl: "https://example.com/card2.jpg",
-        },
-        title: "Card Two",
-        body: "Description for the second card.",
+      body: { text: `Description for card ${index + 1}` },
+      footer: { text: "@kyyinfinite/baileys" },
+      nativeFlowMessage: {
         buttons: [
           {
             name: "quick_reply",
-            buttonParamsJson: JSON.stringify({ display_text: "Select", id: "card_2" }),
+            buttonParamsJson: JSON.stringify({
+              display_text: "Select",
+              id: `card_${index + 1}`,
+            }),
           },
         ],
       },
-    ],
-  }),
-});
+    }),
+  );
+}
+
+const message = generateWAMessageFromContent(
+  jid,
+  {
+    viewOnceMessage: {
+      message: {
+        interactiveMessage: proto.Message.InteractiveMessage.fromObject({
+          body: { text: "Choose a product" },
+          footer: { text: "Swipe to see more" },
+          carouselMessage: { cards },
+        }),
+      },
+    },
+  },
+  {},
+);
+
+await sock.relayMessage(
+  jid,
+  message.message,
+  { messageId: message.key.id },
+);
 ```
 
+
 ### Native Interactive
 
 Combine multiple button types in a single message:
@@ -735,7 +1087,7 @@ await sock.sendMessage(jid, {
 
 > [!NOTE]
 > These message types are styled to match **Meta AI's** WhatsApp response format — tables, code blocks, and rich linked text.  
-> They are exclusive to `@kyyinfinite/baileys` and not available in official Baileys.
+> The underlying rich-response message types are part of the Baileys v7 line. The `sendTable()`, `sendList()`, `sendCodeBlock()`, and related convenience methods documented here are exposed by this package.
 
 ### sendTable()
 
@@ -767,7 +1119,7 @@ await sock.sendList(
   "Bot Information",
   [
     ["Package",   "@kyyinfinite/baileys"],
-    ["Version",   "0.1.0"],
+    ["Version",   "2.0.0"],
     ["Developer", "kyyinfinite"],
     ["License",   "MIT"],
     ["Node",      ">= 20"],
@@ -1286,8 +1638,6 @@ import {
   DisconnectReason,
   Browsers,
 
-//advance
-  Dugong,
 
 } from "@kyyinfinite/baileys";
 ```
@@ -1465,30 +1815,24 @@ Then instantiate a separate `makeWASocket` for each session.
 <details>
 <summary><strong>Interactive messages are not rendering. What's wrong?</strong></summary>
 
-Interactive messages (flow buttons, carousels, list menus) require:
-
-- A **WhatsApp Business API**-capable number, or
-- A number that has been granted access to the interactive message API by WhatsApp.
-
-On regular personal numbers, interactive messages may silently fail or show as plain text.
+Interactive messages depend on the message type, current WhatsApp client behavior, and server-side availability. Rendering can differ between WhatsApp Web, Android, and iOS. Test the specific interactive structure with the account and client versions you target.
 
 </details>
 
 <details>
 <summary><strong>What is the difference from official Baileys?</strong></summary>
 
-| Area | Official Baileys | @kyyinfinite/baileys |
+| Area | Baileys v7.0.0-rc14 | @kyyinfinite/baileys |
 |---|---|---|
-| Interactive messages | No native support | ✅ Full support via Dugong |
-| Album messages | Not supported | ✅ Multi-media albums |
-| AI Rich Response | Not available | ✅ Table, code block, rich text |
-| Table V2 | Not available | ✅ Unified response |
-| Code Block V2 | Not available | ✅ 6 languages |
-| Link Message | Not available | ✅ Inline embeds + citations |
-| Newsletter extras | Basic only | ✅ Bulk follow, URL resolve, admin |
-| Payment messages | Not supported | ✅ Full support |
-| Status mentions | Not available | ✅ `sendStatusMention()` |
-| LID support | Basic | ✅ Full LID↔PN mapping + migration |
+| Native socket API | ✅ | ✅ Preserved |
+| ESM | ✅ | ✅ |
+| Interactive messages | ✅ Native structures | ✅ Plus fluent builders |
+| Carousel messages | ✅ Native `carouselMessage` structures | ✅ Plus nested carousel builder |
+| Rich responses | ✅ Native rich-response structures | ✅ Plus convenience helpers |
+| Media messages | ✅ | ✅ Plus fluent media builders |
+| Newsletter / Group / Business APIs | ✅ | ✅ Native API preserved |
+| Simple fluent API | — | ✅ `text()`, `image()`, `button()`, `carousel()`, etc. |
+| Raw escape hatch | ✅ Native socket / proto APIs | ✅ `api.raw` + native socket |
 
 </details>
 
@@ -1543,7 +1887,7 @@ copies or substantial portions of the Software.
 
 <br/>
 
-**© 2026 kyyinfinite — `@kyyinfinite/baileys` v0.1.0 • MIT License**
+**© 2026 kyyinfinite — `@kyyinfinite/baileys` v2.0.0 • MIT License**
 
 *Built on top of [WhiskeySockets/Baileys](https://github.com/WhiskeySockets/Baileys)*