@vanzxysenpai/baileys 0.0.0-stage → 0.0.2

package/CHANGELOG.md

@@ -0,0 +1,30 @@
+# Changelog
+
+## 0.0.2
+
+### Added
+- Experimental audio voice calls (`VoipClient`, `ActiveCall`, `CallState`; WASM call stack + WebRTC relay ported from ourin-baileys 9.0.11). Opt-in, needs the optional `@roamhq/wrtc` peer dependency.
+- Startup banner (`VanzxyBanner.js`): printed once per process on import and via the `prestart` script; opt out with `VANZXY_BANNER=0` (also respects `NO_COLOR`, plain text when not a TTY).
+
+### Changed
+- Repository links now point to `github.com/vanzxysenpai/vanzxysenpai`.
+- Removed internal change-log style code comments (third-party attribution headers are kept).
+- VoIP only runs when you create a `VoipClient`; there are still no connect-time account actions.
+
+## 0.0.1
+
+First release of `@vanzxysenpai/baileys`, built on WhiskeySockets/Baileys 7.0.0-rc14.
+
+### Included
+- rc14 core plus the `albumParentKey` send option.
+- Message builders (`AIRich`, `Button`/`ButtonV2`/`ButtonV3`, `Carousel`, `Poll`, `Album`, `Event`, `A2UI`), interactive / native-flow send layer, group status, newsletter / username / status extras, stickerpacks, `Bot` framework.
+- Merged `WAProto` containing every message class and field found in rc14 and newer community protos, with type declarations.
+- Stability and security helpers: reconnect backoff, Bad MAC handler, connection watchdog, auto-reconnect, encrypted auth state, SQLite / Mongo / MySQL / PostgreSQL / Redis backends, anti force-close payload guard (`createAnchorGuard`).
+- Media helpers (`resizeImage`, `convertToOpusAudio`, `convertToWhatsAppVideo`, `getVideoThumbnail`, `probeMedia`, `getMp4Duration`), `TTLCache`, social link-preview helpers.
+
+### Behaviour notes
+- `useMultiFileAuthState` writes `creds.json` atomically and keeps `creds.json.bak`; a corrupt file is restored from the backup or moved aside as `creds.json.corrupt-*`.
+- No install-time scripts, no connect-time account actions, no hidden message attribution.
+- `profilePictureUrl` defaults to `'image'`; the tc-token is opt-in (`shouldIncludeTcToken`).
+- Android browser platform is not enabled (platform is always WEB).
+- `Message.pollResultSnapshotMessageV3` keeps the field number used by the bundled proto.

package/LICENSE

@@ -0,0 +1,25 @@
+MIT License
+
+Copyright (c) 2025 Rajeh Taher/WhiskeySockets
+Copyright (c) 2026 Vanzxy
+
+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.
+
+Third-party components ported into this package keep their own copyright
+notices; they are listed per component in NOTICE.md.

package/NOTICE.md

@@ -0,0 +1,158 @@
+# NOTICE
+
+`@vanzxysenpai/baileys` is MIT-licensed (see the root `LICENSE`/`license` field in
+`package.json`). It's a fork built on top of, and incorporating ported code
+from, several other MIT-licensed WhatsApp libraries. This file lists each
+third-party component, its original author/source, and where it lives in
+this package — so credit stays attached to the actual code, not just a
+generic "thanks" in the README.
+
+MIT only requires the original copyright notice to travel with the code; it
+does not require original authors to endorse this fork. Every component
+below was MIT-licensed at its source at the time it was ported.
+
+---
+
+## Upstream base
+
+- **WhiskeySockets/Baileys** — 7.0.0-rc14 is the base of this package (MIT, Copyright (c) 2025 Rajeh Taher/WhiskeySockets). Every rc14 module is present; modules the Vanzxy line did not touch are carried over from rc14 essentially unchanged (only compile-style differences).
+- **@vanzxy/baileys 2.1.2** — the Vanzxy feature set carried over into this package (see ports below).
+- **@itsliaaa/baileys** — intermediate fork this package was branched from.
+
+## Ported components
+
+### MessageBuilder / AIRich / Button / Carousel / Toolkit — base implementation
+- **Sources (lineage as recorded in the in-file headers):**
+  - `@blurose/baileys` 1.1.13 (base), with perf defaults and message-authenticity fields backported from `arslan-baileys` 1.1.0.
+  - The original builder design is credited upstream to Nixel, "NIXCODE — Advanced WhatsApp Interactive Message Builder", with contributions from Ahmad tumbuh kembang.
+- **Location in this package:** `lib/Builders/` (`AIRich.js`, `Button*.js`, `Carousel.js`, `Poll.js`, `shared.js`, ...).
+- Builder modules in `lib/Builders/` were subsequently rewritten/extended by the maintainer; the lineage above is kept for credit.
+
+### MessageBuilder v4.7 additions (setResponseId/setBotResponseId/hasId/getIds/peek/delete)
+- **Source:** credited in-code as "temen's MessageBuilderV4.7" (original author handle not recorded).
+- **Location in this package:** `lib/Builders/` (response-id helpers on the builders).
+
+### Button/list addon-kind resolution logic
+- **Source:** vinikjkkj, [zapo](https://github.com/vinikjkkj/zapo) (MIT).
+- **Location in this package:** `lib/Utils/message-kind.js` (`resolveButtonAddonKind`, ported from `zapo-js` `src/message/encode/content.ts`).
+- *(Corrected from the previous NOTICE, which pointed this entry at
+  `button-helper-utils.js`/`button-sender.js` — those two files are actually
+  sourced from `@queenanya/baileys`, see below. The zapo attribution belongs
+  here instead.)*
+- Also referenced "in spirit" (not a direct port) for migration-tracking
+  design in `lib/Utils/use-sqlite-auth-state.js`.
+
+### Button helper / button-sender runtime layer
+- **Source:** QueenAnya, [`@queenanya/baileys`](https://github.com/QueenAnya/Bail) (MIT) `src/addons/message-utils.ts` and `src/addons/button-sender.ts` — both of which that fork's own header credits onward to **`@ryuu-reinzz/button-helper` v2.2.5** as the original implementation.
+- **Location in this package:** `lib/Utils/button-helper-utils.js`, `lib/Utils/button-sender.js`.
+
+### Interactive/native-flow button send layer
+- **Source:** QueenAnya, [`@queenanya/baileys`](https://github.com/QueenAnya/Bail) (MIT, Copyright (c) 2025 Rajeh Taher/WhiskeySockets).
+- **Location in this package:** `lib/Utils/button-sender.js` (send-layer portions).
+
+### Username management (check/set/pin/recommend/find)
+- **Source:** QueenAnya, [`@queenanya/baileys`](https://github.com/QueenAnya/Bail) `lib/Socket/username.js` (MIT), itself ported from `@innovatorssoft/baileys`.
+- **Location in this package:** `lib/Socket/username.js`.
+
+### Chat Control utilities (TypingIndicator + related presence helpers)
+- **Source:** `@innovatorssoft/baileys` `chat-control.js` (direct, per this file's own header — not routed through @queenanya/baileys).
+- **Location in this package:** `lib/Utils/chat-control.js` (and its `.d.ts`).
+
+### Bail-master Utils addons batch
+- **Source:** QueenAnya's `Bail` repository, master branch ("Bail-master"), `src/addons/*.ts` — same upstream as the `@queenanya/baileys` package above.
+- **Location in this package** (TS → ESM JS conversions, type-only annotations dropped, behavior unchanged unless noted):
+  - `lib/Utils/vcard.js` ← `addons/vcard.ts`
+  - `lib/Utils/scheduling.js` ← `addons/scheduling.ts` + `addons/message-scheduler.ts` (merged into one class-based scheduler)
+  - `lib/Utils/message-search.js` ← `addons/message-search.ts`
+  - `lib/Utils/auto-reply.js` ← `addons/auto-reply.ts`
+  - `lib/Utils/stickerpack.js` ← `addons/stickerpack.ts`
+  - `lib/Utils/anti-delete.js` ← `addons/anti-delete.ts`
+  - `lib/Utils/chat-history-helpers.js` ← `addons/chat-history-helpers.ts` (adapted to this fork's own `makeInMemoryStore`)
+  - `lib/Utils/media-messages.js` ← `addons/media-messages.ts`
+  - `lib/Utils/media-set.js` ← `addons/media-set.ts`
+  - `lib/Utils/status.js` ← `addons/status-helpers.ts`
+  - `lib/Utils/templates.js` ← `addons/templates.ts`
+  - `lib/Utils/baileys-event-stream.js` ← `addons/baileys-event-stream.ts`
+  - `lib/Utils/past-participants.js` ← `addons/past-participants.ts`
+  - `lib/Utils/use-cache-manager-auth-state.js` ← `addons/use-cache-manager-auth-state.ts` (that file itself credits `@innovatorssoft/baileys` `make-cache-manager-store.js`)
+
+### Bot Framework (Bot / Context / SessionManager / StatsManager / MediaManager / SQLiteStore)
+- **Source:** Originally submitted as WhiskeySockets/Baileys PR #2710 by **LuferOS**; the P0–P3 bugfix pass and TypeScript rewrite referenced in this package's code comments were done by QueenAnya in `@queenanya/baileys` `lib/Framework/` (MIT). Adapted further for this fork (async `better-sqlite3`/`fluent-ffmpeg` lazy-loading, no `ffmpeg-static` dependency) — see the `Vanz@Port`/`Vanz@Fix` comments at the top of each file for exactly what changed.
+- **Location in this package:** `lib/Framework/`.
+
+### lpzeravk / systemzero baileys ports (v2.0.3)
+- **Source:** `@lpzeravk/baileys` 1.0.0 (MIT); `@systemzero/baileys` 1.1.4 carries the same files.
+- **Location in this package:** `lib/Utils/reconnect-backoff.js` (`computeReconnectDelay`; `createReconnectBackoff` is own code),
+  `lib/Utils/bad-mac-handler.js` (rewritten: injectable logger, no hardcoded auth path, narrower Bad MAC match, async cleanup),
+  `lib/Utils/connection-watchdog.js` (rewritten: ping probe by default, self-stopping unref'd timer).
+
+### nexustech baileys ports (v2.0.3)
+- **Source:** `@nexustechpro/baileys` 2.2.7 (MIT, Copyright (c) 2026 nexustechpro2).
+- **Location in this package:**
+  - `lib/WAUSync/Protocols/USyncBusinessProtocol.js`, `USyncPictureProtocol.js`, `USyncTextStatusProtocol.js`,
+    `USyncSidelistProtocol.js`, `USyncFeatureProtocol.js`, plus the matching `with*Protocol()` methods on `USyncQuery`
+    and `withPictureId/withVerifiedNameSerial/withBusinessProfileTag/withSidelistDelete` on `USyncUser`.
+  - `lib/Utils/meta-ai-msmsg.js` — `decryptMsmsgBotMessage` / `decodeDecryptedMsmsgMessage`, exported as standalone
+    experimental helpers only (not wired into the socket; see the header comment in that file).
+- Only the readable source files were used. That fork's `lib/Socket/chats.js` ships obfuscated and was **not** ported.
+
+### japofc baileys ports (v2.0.3)
+- **Source:** `@japofc/baileys` 2.4.1 (MIT per the `license` field of its `package.json`; the published tarball carries no
+  separate `LICENSE` file). Author: JAPofc (J.AP).
+- **Location in this package:** `lib/Utils/auto-reconnect.js` (`autoReconnect`), `lib/Utils/auth-secure.js`
+  (encrypted auth state, backup/restore, integrity, pairing/QR guards, secret redaction), `lib/Utils/humanizer.js`
+  (`sendHumanized`), `lib/Utils/mock-socket.js` (`createMockSocket`), `lib/Utils/meta-ai.js` (`askMetaAI`).
+
+### ourin-baileys ports
+- **Source:** ourin-baileys (version 9.0.11 for the VoIP stack, per this package's `lib/index.js`).
+- **Location in this package:**
+  - `lib/VoIP/`, `lib/assets/wasm/` — audio call WASM stack + WebRTC relay (the bundled `whatsapp.wasm`, ~9.8 MB, comes with this port; its redistribution terms follow the ourin-baileys package it was taken from). Opt-in: nothing runs unless a `VoipClient` is created.
+  - `lib/Builders/AIRich.js` — the `ORich` no-op subclass of `AIRich`, kept only for drop-in compatibility with code originally written against ourin-baileys.
+
+---
+
+## Reviewed but intentionally not ported
+
+- `spam-report` (nexustech) — mass-report tooling.
+- identity / device-fingerprint rotation (whatsbibz) — spoofs device identity.
+
+---
+
+## Referenced for verification only (no code incorporated)
+
+A few bug-fix comments in `lib/Builders/` cite other
+implementations to confirm expected wire behavior, without copying code from
+them: `zqdevelopers/zq_baileys_helper`, `@chatunity/baileys`, `@neoxr/wb`,
+and `WhiskeySockets/Baileys` issue/PR `#2626`. Listed here for transparency
+only — not attribution-bearing ports, so no third-party notice entry is
+needed for them.
+
+---
+
+If a source or attribution above is inaccurate or a component was missed,
+please open an issue at the repository linked in `package.json` so it can be
+corrected — misattribution here is a mistake to fix, not a dispute to argue.
+
+### Donor-diff pass ports (v2.0.3)
+Small, individually attributed MIT ports; each ported file carries a `Vanz@Port` header naming its source.
+- **@rexxhayanasi/elaina-baileys 1.3.10** — `lib/Utils/group-metadata-cache.js`, `lib/Utils/username.js`.
+- **Bail-master (QueenAnya)** — `isAndroidBrowser`, `isLottieBuffer` + Lottie sticker-pack handling, `printQRIfNecessaryListener` (`lib/Utils/qr-terminal.js`).
+- **kangwifi72/baileys 1.4.9** — idea and structure of `lib/Utils/disconnect-reason.js` (re-keyed to this fork's enum) and `lib/Utils/phone-utils.js`.
+- **@japofc/baileys 2.4.1** — `lib/Utils/text-tools.js` (`parseMentions` fixed), `formatPairingCode`.
+- **xbibzlibrary/whatsbibz 1.4.0** — `lib/Utils/pairing-utils.js` (pairing code + error classification only; identity rotation remains unported).
+- **@systemzero/baileys 1.1.4** — idea for the default remote-media size cap (`DEFAULT_MAX_REMOTE_MEDIA_BYTES`).
+- **@japofc/baileys 2.4.1 (second pass)** — `lib/Utils/jid-tools.js`, `tag.js`, `ffmpeg-path.js`, `voice-note.js` (voice-note changed to avoid direct `fetch()`).
+- **Round23 audit build (2.0.4 line, produced with ChatGPT)** — merged by 3-way diff: event-buffer pass-through fix, `lock-manager.js`, `migrate-auth-state.js`, `passkey.js`, key-store `list()` / `listIds()`, socket convenience wrappers, and their tests. Not a third-party fork; no upstream licence implications beyond the existing notices.
+- **xbibzlibrary/whatsbibz 1.4.0 (third pass)** — `lib/Utils/text-format.js` (`splitText`, `whatsappify`; code-span handling and retry removal are this fork's changes).
+- **@japofc/baileys 2.4.1 (third pass)** — `withMusicAttribution` (`lib/Utils/status.js`), idea for `resolveSocketVersionConfig` (`lib/Framework/Bot.js`, made opt-in).
+
+### Builder upgrade pass (v2.1.14)
+- **betton (own bot-side builder module, CommonJS)** — ported into `lib/Builders/Button.js` / `Carousel.js`: `setVideoGif`, `setLocationHeader`, `addMPM`/`addPayment`/`addAgentTransfer`/`addReviewOrder`, the split-button family (`addSplit*`), `Button.sendAudio`, `Carousel.makeCard`/`clearCards`/`cardCount`, plus `lib/Utils/android-stanza-id.js` (`generateAndroidStanzaId` / `patchAndroidStanzaId`). The betton V1 and in-Button card modes were not ported (`ButtonV2` and `Carousel` already cover them).
+- **MessageBuilderv2.js (Nixel's Go port of the AIRich builder; personal/commercial use, no redistribution as a standalone product)** — used as a *structural reference only*; no Go code is copied. Ideas taken: `setForwarded` / `setIncludesUnifiedResponse` / `setIncludesSubmessages`, `addTextRaw`, `addProgress`, quota-upsell variants (written without the Go reference's hardcoded third-party default link), thin wrappers for the real `GenAI*` primitives it pushes (search ad, nested unified, 3P account linking, search planner, orchestrator search engine, professional consent, embedded contextual screen), experimental `addLayout` / `addMultipleResponse` / `addFlexibleGrid` / `addVStack`, and `A2UI.setVersion` / `setCatalogId` / `imageFit` / `imageHeader`. The Go helpers that only emit placeholder markdown text (`addSportsWidget`, `addClippyFollowUp`, `addClippyWidget`, `addP13N`, `addLocationPermission`, `addTimestampPlaceholder`, `addDeeplinkItem`) are ported as the same plain text cards. Go-language plumbing has JS equivalents: `Opts`/`OptsAt` -> `opts()`/`optsAt()`, `MarshalJSON` -> `toJSON()` (AIRich, A2UI, AIRichError), `Error`/`Code`/`Unwrap` -> `message`/`code`/`unwrap()`, `Pay` -> `Button#addPay()` / `Pay()` over the fork's existing `payment-utils.js` (written without the reference's hardcoded payout accounts).
+
+
+
+## Additions in 0.0.1
+- `lib/Utils/anchor-guard.js`, `lib/Utils/media-processor.js` — from `@rennzsync/baileys` 10.7.4 (MIT); anchor-guard originates from `@rexxhayanasi/elaina-anchorguard` (MIT).
+- `lib/Utils/link-preview-metadata.js`, `lib/Utils/ttl-cache.js` — from `@rexxhayanasi/elaina-baileys` 1.4.7 (MIT).
+- `WAProto/`: 17 message classes plus 61 fields merged from the protos of elaina-baileys 1.4.7, rennzsync 10.7.4, levvsync 0.0.4 and Baileys rc14 by copying their generated code verbatim.