@vanzxy/baileys 2.0.1 → 2.0.3

package/NOTICE.md

@@ -34,9 +34,8 @@ below was MIT-licensed at its source at the time it was ported.
   entry. Let me know which and I'll finalize it.
 
 ### MessageBuilder v4.7 additions (setResponseId/setBotResponseId/hasId/getIds/peek/delete)
-- **Source:** credited in-code only as "temen's MessageBuilderV4.7" (`temen` = Indonesian for "friend/buddy") — not a resolvable handle or repo.
+- **Source:** Nixel — same author/watermark as the main MessageBuilder/AIRich base above ("temen's MessageBuilderV4.7" in the in-code credit refers to Nixel, confirmed by the person who introduced this codebase).
 - **Location in this package:** `lib/Utils/MessageBuilder.js` (`~line 2120, 2885, 2916`).
-- **⚠ Needs your input:** I can't attribute this properly without the actual author/repo name. Let me know who this refers to.
 
 ### Button/list addon-kind resolution logic
 - **Source:** vinikjkkj, [zapo](https://github.com/vinikjkkj/zapo) (MIT).

package/README.md

@@ -74,7 +74,7 @@
 - [💖 Support](#-support)
 - [👑 Maintainer](#-maintainer)
 - [⚠️ Disclaimer](#-disclaimer)
-- [📝 Patch Notes](#-v6-patch-notes)
+- [📝 Patch Notes](#-v8-patch-notes)
 
 </details>
 
@@ -246,6 +246,8 @@ Audio status uses a more compatible implementation to avoid unsupported-version
 ### AIRich — the rich-response message builder
 A chainable builder (`AIRich`, also exported as `AIVanzxy` / `LeafRich` / `VanzxyAI` / `VanzxyRich`) with 40+ `add*()`/`set*()` methods covering headings, formatted text (hyperlinks/citations/LaTeX), code blocks, tables, image/video/product/post cards, task & progress cards, tip banners, and quick-reply suggestions — the kind of rich card layout you'd normally only see from an official AI/assistant-style bot. See [Usage Examples](#airich--rich-response-cards) below.
 
+> **Experimental (V8):** `build()` now also populates the proto's `originalRecipientMetadata` field (previously left unset) with the same section payload as `unifiedResponse`. This is a fix for AI-response bubbles collapsing into WhatsApp's "Baca selengkapnya"/"Read more" fold earlier than expected while being built up live via `sendEdit()`. Pending live-traffic confirmation — report back if you still see early truncation.
+
 ### Native Flow Expansion
 
 <table>
@@ -524,10 +526,32 @@ Every message builder lives in its own file under `lib/Builders/`, so you can tr
 | `ButtonV3.js` | `ButtonV3` | Built around `loadFrom(msg)` — loads an existing `templateMessage` (e.g. one you fetched or that was quoted) so you can edit it in place instead of building one from scratch. |
 | `Carousel.js` | `Carousel` | Chains `Button(...).toCard()` results into a swipeable card carousel. Capped at `Carousel.MAX_CARDS` (10) since WhatsApp silently truncates anything beyond that. |
 | `Poll.js` | `Poll` | Poll/vote message builder — question, options, single/multi-select, hidden-voter mode, correct-answer marking, expiry. |
+| `NativeFlow.js` | `NativeFlow` | Modern `interactiveMessage`/`nativeFlowMessage` builder — `cta_url`, `cta_copy`, `cta_call`, `quick_reply`, `single_select`, offer banners, and the "..." options bottom-sheet. The recommended replacement for `ButtonV3`'s legacy hydrated-template buttons. |
+| `Location.js` | `Location` | Static location pins via the existing `location` shorthand, plus live/moving locations (built directly against `WAProto.Message.LiveLocationMessage` since there's no shorthand for that yet — call `send()` again with a higher `setSequence()` to push updates). |
+| `Contact.js` | `Contact` | vCard contact-card builder — one contact sends as `contactMessage`, two or more as `contactsArrayMessage`. `addContact()` generates a minimal VCARD 3.0 block from plain fields; `addRawVcard()` accepts a pre-built vCard string. |
+| `Album.js` | `Album` | Media-group/album builder — bundles 2+ images/videos. Thin wrapper: the actual cover + delayed-follow-up sending is already handled by the `content.album` shorthand in `Socket/messages-send.js`. |
 | `AIRich.js` | `AIRich` (+ aliases `ORich`, `AIVanzxy`, `LeafRich`, `VanzxyAI`, `VanzxyRich`, `RichVanzxy`) | The rich AI-assistant-style response builder described above — headings, formatted text, tables, media/product/post cards, task/progress cards, tip banners, quick-reply suggestions. |
 | `A2UI.js` | `A2UI`, `sendA2UIWidget` | Lower-level A2UI/Bloks widget builder. Builds the flat `components` tree (Column/Row → `children`, Card/Button → `child`, Modal → `trigger`/`content`) that Bloks widgets expect and sends it through the same `getBizBinaryNode()` path as `Button`/`ButtonV2`, so the wire-level node always matches the button names actually sent. |
-| `VanzxyBaileys.js` | `VanzxyBaileys` | A unified builder **hub** — one object that wraps all the builders above behind short method names (`.button()`, `.buttonV2()`, `.buttonV3()`, `.carousel()`, `.poll()`, `.airich()`, `.a2ui()`), plus PascalCase aliases (`.Button()`, `.Carousel()`, `.Poll()`, `.AIRich()`, `.A2UI()`) for developers who prefer that naming style. Nothing new is implemented here — it's purely a single entry point over the individual classes. |
-| `index.js` | everything above, plus `MESSAGE_BUILDER_VERSION` | The barrel file — re-exports every builder and its aliases so `import { Button, Poll, AIRich, VanzxyBaileys } from '@vanzxy/baileys'` works without reaching into individual files. `MESSAGE_BUILDER_VERSION` tracks the builder API surface's own version, independent of the package version. |
+| `LinkPreview.js` | `bindLinkPreview` | Not a builder class — a function that binds a `sendLinkPreview(jid, text, link, title, description, thumbnail, options)` method directly onto a Baileys socket instance. Builds the `linkPreview` context (matched text, title, description, optional thumbnail via `prepareWAMessageMedia`) and sends it through the socket's own `sendMessage`. Called automatically when you construct `VanzxyBaileys(sock)`; call it yourself (`bindLinkPreview(sock)`) if you're not using the hub. |
+| `VanzxyBaileys.js` | `VanzxyBaileys` | A unified builder **hub** — one object that wraps all the builders above behind short method names (`.button()`, `.buttonV2()`, `.buttonV3()`, `.carousel()`, `.poll()`, `.nativeFlow()`, `.location()`, `.contact()`, `.album()`, `.airich()`, `.a2ui()`), plus PascalCase aliases (`.Button()`, `.Carousel()`, `.Poll()`, `.NativeFlow()`, `.Location()`, `.Contact()`, `.Album()`, `.AIRich()`, `.A2UI()`) for developers who prefer that naming style. The constructor also runs `bindLinkPreview()` on the socket you pass in, so `vx.client.sendLinkPreview(...)` is available immediately. Nothing new is implemented here — it's purely a single entry point over the individual classes. |
+| `index.js` | everything above, plus `MESSAGE_BUILDER_VERSION` | The barrel file — re-exports every builder and its aliases so `import { Button, Poll, AIRich, VanzxyBaileys, bindLinkPreview } from '@vanzxy/baileys'` works without reaching into individual files. `MESSAGE_BUILDER_VERSION` tracks the builder API surface's own version, independent of the package version (currently `5.0`). |
+
+**Link preview example** — works on any socket, with or without the `VanzxyBaileys` hub:
+
+```js
+import { bindLinkPreview } from '@vanzxy/baileys'
+
+const sock = bindLinkPreview(makeWASocket({ /* ... */ }))
+
+await sock.sendLinkPreview(
+    jid,
+    'Cek repo ini deh',
+    'https://github.com/vanzxysenpai/vanzxybaileys',
+    'vanzxybaileys',
+    'Extended interactive messages & native flow, built on WhiskeySockets/Baileys.',
+    { url: 'https://files.catbox.moe/l72xji.svg' } // optional thumbnail
+)
+```
 
 **Unified hub example** — useful if you'd rather carry one object around than import each builder individually:
 
@@ -826,6 +850,25 @@ Use responsibly and follow WhatsApp Terms of Service.
 
 ---
 
+## 📝 V8 Patch Notes
+
+- Added `LinkPreview.js` to `lib/Builders/`: `bindLinkPreview(sock)` attaches a `sendLinkPreview(jid, text, link, title, description, thumbnail, options)` method directly to a socket instance (matched-text/title/description + optional thumbnail via `prepareWAMessageMedia`). Wired into `index.js`'s exports and auto-applied inside the `VanzxyBaileys` constructor, so `new VanzxyBaileys(sock)` gives you `sendLinkPreview` for free. See the [Builders Folder Map](#-builders-folder-map-libbuilders) for the usage example.
+- **Experimental AIRich fix:** `AIRich.build()` now populates the previously-unset `richResponseMessage.originalRecipientMetadata` proto field with the same section payload as `unifiedResponse`. Working hypothesis is that WhatsApp's client uses this field to decide full/expanded rendering for an AI-response bubble's original recipient, and its absence was causing live-built AIRich bubbles to collapse into "Baca selengkapnya" earlier than they should while still mid-`sendEdit()` build. Not yet confirmed against live traffic — flag it if the early collapse persists or if this introduces a regression.
+- Corrected `package.json`'s `version` field from `2.0.6` back to `2.0.3`. `2.0.6` was never reached through this fork's own release process — it got bumped out of sequence, so the version number is reset to the correct next step.
+
+---
+
+## 📝 V7 Patch Notes
+
+- Added four new builders to `lib/Builders/` (see the [📁 Builders Folder Map](#-builders-folder-map-libbuilders) for details), wired into both `index.js` and the `VanzxyBaileys` hub:
+  - `NativeFlow.js` — modern `interactiveMessage`/`nativeFlowMessage` builder (`cta_url`, `cta_copy`, `cta_call`, `quick_reply`, `single_select`), the recommended replacement for `ButtonV3`'s legacy hydrated-template buttons.
+  - `Location.js` — static + live location builder.
+  - `Contact.js` — single/multi vCard contact-card builder.
+  - `Album.js` — media-group/album builder (thin wrapper over the existing `content.album` shorthand).
+- Fixed a version mismatch: `AIRich.js`'s internal `VERSION` constant was still `4.7` while `index.js`'s `MESSAGE_BUILDER_VERSION` had already moved to `4.8`. Both now read `5.0`.
+
+---
+
 ## 📝 V6 Patch Notes
 
 - Fixed a `package.json` typo: the version field was mistakenly left at `1.0.1` instead of `2.0.1` after the V5 release — corrected to `2.0.1` so the published package version matches the intended release.