@xbibzlibrary/whatsbibz 1.3.2 → 1.4.3

package/assets/logo/README.md

@@ -1,21 +1,19 @@
 # Logo WhatsBibz
 
-Gelembung pesan hijau (`#0a6958`) dengan buku terbuka di dalamnya, wordmark **WhatsBib'S** dan
-tagline *WHATSAPP LIBRARY*. Sumber utamanya adalah `preview-2048.png` (raster 2048×2048, dari
-pemilik proyek); semua berkas lain diturunkan dari situ.
+Logo utama (banner/logo lebar 1672×940) diberikan oleh pemilik proyek sebagai WebP
+dan disimpan sebagai `preview.webp`; turunan PNG-nya ada di `preview.png`.
+Keduanya dipakai untuk README dan halaman npm.
 
 | Berkas | Pakai untuk |
 |---|---|
-| `preview.png` | lockup lengkap 1024×1024 — README, halaman npm, dokumen |
-| `preview-2048.png` | master resolusi penuh (tidak ikut dipublish ke npm) |
-| `png/logo-1600.png`, `png/logo-800.png` | lockup dipangkas rapi (tanpa margin besar) |
-| `png/mark-1024.png`, `png/mark-512.png` | gelembung saja, **latar transparan** — avatar, watermark |
-| `png/icon-{16…1024}.png` | ikon persegi sudut membulat (tile putih + gelembung) — avatar npm/GitHub, app icon |
+| `preview.webp` | master asli (WebP 1672×940) — README, halaman npm |
+| `preview.png` | versi PNG `preview.webp` (1080×607) |
+| `preview-2048.png` | master persegi 2048×2048 dari rebrand sebelumnya (arsip) |
+| `png/logo-1600.png`, `png/logo-800.png` | lockup lama yang dipangkas rapi |
+| `png/mark-1024.png`, `png/mark-512.png` | gelembung saja, latar transparan — avatar, watermark |
+| `png/icon-{16…1024}.png` | ikon persegi sudut membulat — avatar npm/GitHub, app icon |
 | `png/banner-1200x360.png` | banner README/sosial |
 | `whatsbibz.ico` | favicon multi-ukuran 16–256 |
 
-Warna: hijau utama `#0a6958`, teks `#2b2e33`, latar putih. Ruang kosong minimal di sekeliling
-lockup = tinggi huruf **B**. Jangan dimiringkan, diberi outline, atau diganti fontnya.
-
-Regenerasi turunan (mark transparan, ikon, ICO, banner) dari master: skrip yang dipakai ada di
-riwayat proyek (`scripts/` tidak menyertakannya karena hanya dijalankan sekali saat rebrand).
+Ikon, mark, banner, dan favicon masih turunan dari lockup persegi versi lama.
+Setelah versi final disepakati, turunan tersebut perlu diregenerasi dari `preview.webp`.

package/lib/BibzWhats/banner.d.ts

@@ -0,0 +1,32 @@
+/** @module @xbibzlibrary/whatsbibz/lib/BibzWhats/banner */
+/**
+ * Banner ASCII "WhatsBibz." yang dicetak saat client dibuat.
+ * Huruf: "Small Slant" (figlet). Warna: filter pelangi (Rainbow 2).
+ */
+
+export const BANNER_FONT: string;
+export const BANNER_FILTER: string;
+
+/** Banner polos tanpa kode warna ANSI (4 baris, tanpa newline tambahan). */
+export const BANNER_TEXT: string;
+
+export interface BannerRenderOptions {
+    /** true = selalu berwarna, false = polos, 'auto' (default) = ikuti terminal. */
+    color?: boolean | 'auto';
+    /** Berapa kali spektrum pelangi diulang sepanjang lebar banner (default 1). */
+    cycles?: number;
+    /** Environment untuk deteksi warna (default process.env). */
+    env?: NodeJS.ProcessEnv;
+    /** Stream untuk deteksi TTY (default process.stdout). */
+    stream?: unknown;
+}
+
+export function colorEnabled(opts?: { env?: NodeJS.ProcessEnv; stream?: unknown }): boolean;
+
+/** Render banner menjadi string siap cetak (tanpa newline tambahan). */
+export function renderBanner(options?: BannerRenderOptions): string;
+
+/** Cetak banner ke terminal. */
+export function printBanner(
+    options?: BannerRenderOptions & { write?: (chunk: string) => void },
+): boolean;

package/lib/BibzWhats/banner.js

@@ -0,0 +1,121 @@
+/** @module @xbibzlibrary/whatsbibz/lib/BibzWhats/banner */
+// BibzWhats — banner ASCII "WhatsBibz." yang dicetak ke terminal saat client dibuat.
+//
+// • Huruf   : "Small Slant" (figlet / smslant) — dirender sekali dan disimpan
+//   sebagai string statis, jadi TIDAK butuh dependency figlet saat runtime.
+// • Warna   : filter pelangi (gradien hue mengalir dari kiri ke kanan), gaya
+//   truecolor (24-bit) dengan fallback palet 256 bila terminal tidak
+//   mendukungnya, dan otomatis tanpa warna (plain) bila stdout bukan TTY.
+// • Matikan : NO_COLOR=1, atau opsi client `banner: false`.
+
+// Baris asli hasil figlet.textSync('WhatsBibz.', { font: 'Small Slant' }).
+// Perhatikan: sebagian besar glyph saling berimpit karena font-nya miring rapat —
+// itu memang karakteristik "Small Slant".
+const LINES = [
+    "  _      ____        __      ___  _ __       ",
+    " | | /| / / /  ___ _/ /____ / _ )(_) /  ___  ",
+    " | |/ |/ / _ \\/ _ `/ __(_-</ _  / / _ \\/_ /_ ",
+    " |__/|__/_//_/\\_,_/\\__/___/____/_/_.__//__(_)",
+];
+
+export const BANNER_FONT = 'Small Slant';
+export const BANNER_FILTER = 'Rainbow 2';
+
+const MAX_WIDTH = Math.max(...LINES.map((l) => l.length));
+
+/** Banner polos (tanpa ANSI) — 4 baris, tanpa baris kosong di ujung. */
+export const BANNER_TEXT = LINES.map((l) => l.trimEnd()).join('\n');
+
+const RESET = '\x1b[0m';
+const TRUE_COLOR_TERMS = new Set(['truecolor', '24bit']);
+const TRUECOLOR_TERM_PROGRAMS = ['iterm.app', 'wezterm', 'vscode', 'hyper', 'tabby', 'ghostty', 'kitty', 'alacritty'];
+
+/** Deteksi warna: hormati NO_COLOR / FORCE_COLOR; default hanya saat stdout TTY. */
+export function colorEnabled({ env = process.env, stream = process.stdout } = {}) {
+    const nc = env.NO_COLOR;
+    if (nc !== undefined && nc !== '' && nc !== '0') return false;
+    const fc = env.FORCE_COLOR;
+    if (fc !== undefined && fc !== '' && fc !== '0') return true;
+    return !!(stream && stream.isTTY) && env.TERM !== 'dumb';
+}
+
+function trueColorSupported(env = process.env) {
+    const ct = String(env.COLORTERM || '').toLowerCase();
+    if (ct && TRUE_COLOR_TERMS.has(ct)) return true;
+    const prog = String(env.TERM_PROGRAM || '').toLowerCase();
+    return TRUECOLOR_TERM_PROGRAMS.some((p) => prog.includes(p));
+}
+
+function hslToRgb(h, s, l) {
+    h = ((h % 360) + 360) % 360;
+    const c = (1 - Math.abs(2 * l - 1)) * s;
+    const hp = h / 60;
+    const x = c * (1 - Math.abs((hp % 2) - 1));
+    let r = 0, g = 0, b = 0;
+    if (hp < 1) [r, g, b] = [c, x, 0];
+    else if (hp < 2) [r, g, b] = [x, c, 0];
+    else if (hp < 3) [r, g, b] = [0, c, x];
+    else if (hp < 4) [r, g, b] = [0, x, c];
+    else if (hp < 5) [r, g, b] = [x, 0, c];
+    else [r, g, b] = [c, 0, x];
+    const m = l - c / 2;
+    return [Math.round((r + m) * 255), Math.round((g + m) * 255), Math.round((b + m) * 255)];
+}
+
+// Pendekatan terdekat ke kode palet 256 (cube 6×6×6 atau grayscale).
+const CUBE = [0, 95, 135, 175, 215, 255];
+function nearest256(r, g, b) {
+    const map = (v) => CUBE.reduce((best, x) => (Math.abs(x - v) < Math.abs(best - v) ? x : best), CUBE[0]);
+    const rr = map(r), gg = map(g), bb = map(b);
+    const rgbErr = (rr - r) ** 2 + (gg - g) ** 2 + (bb - b) ** 2;
+    const avg = (r + g + b) / 3;
+    const grayIdx = Math.min(23, Math.max(0, Math.round((avg - 3) / 10)));
+    const grayV = 8 + grayIdx * 10;
+    const grayErr = (grayV - r) ** 2 + (grayV - g) ** 2 + (grayV - b) ** 2;
+    if (grayErr < rgbErr) return `38;5;${232 + grayIdx}`;
+    return `38;5;${16 + 36 * CUBE.indexOf(rr) + 6 * CUBE.indexOf(gg) + CUBE.indexOf(bb)}`;
+}
+
+function colorCode(r, g, b, trueColor) {
+    return trueColor ? `38;2;${r};${g};${b}` : nearest256(r, g, b);
+}
+
+/**
+ * Render banner.
+ * @param {object} [opts]
+ * @param {boolean|'auto'} [opts.color='auto']  true=selalu berwarna, false=polos, 'auto'=ikuti terminal
+ * @param {number} [opts.cycles=1]              berapa kali spektrum pelangi diulang sepanjang lebar banner
+ * @param {object} [opts.env]                   environment (untuk deteksi warna)
+ * @param {object} [opts.stream]                stream untuk deteksi TTY (biasanya process.stdout)
+ * @returns {string} banner siap dicetak (tanpa newline tambahan)
+ */
+export function renderBanner({ color = 'auto', cycles = 1, env = process.env, stream = process.stdout } = {}) {
+    const useColor = color === true || (color === 'auto' && colorEnabled({ env, stream }));
+    if (!useColor) return BANNER_TEXT;
+    const trueColor = trueColorSupported(env);
+    return LINES.map((line) => {
+        let out = '';
+        for (let c = 0; c < line.length; c++) {
+            const ch = line[c];
+            if (ch === ' ') {
+                out += ' ';
+                continue;
+            }
+            const hue = ((c / MAX_WIDTH) * 360 * cycles) % 360;
+            const [r, g, b] = hslToRgb(hue, 1, 0.5);
+            out += `\x1b[${colorCode(r, g, b, trueColor)}m${ch}${RESET}`;
+        }
+        return out.trimEnd();
+    }).join('\n');
+}
+
+/**
+ * Cetak banner ke terminal.
+ * @param {object} [opts]  meneruskan opsi renderBanner + `write`
+ * @param {(s:string)=>void} [opts.write]  penulis output (default process.stdout.write)
+ */
+export function printBanner(opts = {}) {
+    const { write = (s) => process.stdout.write(s), ...rest } = opts;
+    write(renderBanner(rest) + '\n');
+    return true;
+}

package/lib/BibzWhats/client.d.ts

@@ -1,3 +1,4 @@
+/** @module @xbibzlibrary/whatsbibz/lib/BibzWhats/client */
 import { EventEmitter } from 'events';
 import type { WASocket } from '../index.js';
 import type { SocketConfig, WABrowserDescription, ConnectionState } from '../Types/index.js';
@@ -33,6 +34,12 @@ export interface BibzWhatsOptions {
     logger?: BibzWhatsLogger;
     /** cetak QR ASCII ke console saat fallback (butuh qrcode-terminal) */
     printQR?: boolean;
+    /**
+     * Cetak banner ASCII "WhatsBibz." saat client dibuat.
+     * Default (undefined): hanya di terminal interaktif (stdout TTY).
+     * true = selalu cetak, false = jangan pernah.
+     */
+    banner?: boolean;
     /** opsi tambahan langsung ke makeWASocket (override) */
     socketConfig?: Partial<SocketConfig>;
     maxReconnectAttempts?: number;
@@ -55,7 +62,7 @@ export interface BibzWhatsOptions {
     /** default true: 'ready' dipancarkan untuk setiap socket baru (pertama & tiap reconnect) */
     readyOnEveryConnect?: boolean;
 }
-export declare const BIBZWHATS_DEFAULTS: Readonly<Required<Omit<BibzWhatsOptions, 'phone' | 'pairingCode' | 'logger' | 'printQR' | 'socketConfig'>>>;
+export declare const BIBZWHATS_DEFAULTS: Readonly<Required<Omit<BibzWhatsOptions, 'phone' | 'pairingCode' | 'logger' | 'printQR' | 'socketConfig' | 'banner'>>>;
 export declare function wipeAuthDir(dir: string): boolean;
 export declare function makeSocketNetworkOptions(opts?: { forceIPv4?: boolean }): Partial<SocketConfig>;
 export declare function sessionWipeReason(status: number | undefined, message?: string): string | null;

package/lib/BibzWhats/client.js

@@ -1,3 +1,4 @@
+/** @module @xbibzlibrary/whatsbibz/lib/BibzWhats/client */
 // BibzWhats — createBibzWhats()
 // Pembungkus tingkat tinggi di atas makeWASocket:
 //  • versi WA Web TERBARU diambil di setiap connect (server menolak versi lama)
@@ -24,6 +25,7 @@ import { Browsers } from '../Utils/browser-utils.js';
 import { lintIdentity, derivePairingDisplay } from '../Utils/platform-identity.js';
 import { resolveDeviceIdentity, createIdentityRotator, isIdentityRejection, describeIdentity, clearIdentityState, loadIdentityState, saveIdentityState } from './device-identity.js';
 import { createPairingController } from './pairing.js';
+import { printBanner } from './banner.js';
 
 export const BIBZWHATS_DEFAULTS = Object.freeze({
     authDir: 'bibzwhats-session',
@@ -106,6 +108,9 @@ function mergeLogger(logger) {
  * @property {[string,string,string]} [browser]  alias lama `identity` (tuple eksplisit)
  * @property {object} [logger]            {info,warn,error,ok,debug}
  * @property {boolean} [printQR]          cetak QR ASCII ke console saat fallback (butuh qrcode-terminal)
+ * @property {boolean} [banner]          cetak banner ASCII 'WhatsBibz.' saat client dibuat.
+ *                                    default: hanya di terminal interaktif (stdout TTY);
+ *                                    true = selalu, false = jangan pernah.
  * @property {object} [socketConfig]      opsi tambahan langsung ke makeWASocket (override)
  * @property {string} [companionPlatformDisplay]  override `companion_platform_display` (WA memvalidasi dgn allow-list; default diturunkan otomatis, mis. "Chrome (Mac OS)" / "Chrome (Linux)")
  * @property {boolean} [readyOnEveryConnect]      default true — 'ready' tiap socket baru; false = hanya sekali
@@ -127,6 +132,14 @@ export async function createBibzWhats(options = {}) {
     const emitter = new EventEmitter();
     const groupMetadataCache = new Map();
 
+    // Banner ASCII 'WhatsBibz.' (Small Slant, pelangi) — hanya terminal interaktif secara
+    // bawaan; `banner: true` memaksa cetak (mis. untuk log/daemon), `banner: false` mematikan.
+    const wantBanner =
+        opts.banner === true || (opts.banner !== false && !!process.stdout.isTTY);
+    if (wantBanner) {
+        try { printBanner(); } catch {}
+    }
+
     // ── Identitas perangkat tertaut: kustom (opsi/env) atau otomatis (paling stabil) ──
     const resolved = resolveDeviceIdentity({ identity: opts.identity === 'auto' ? undefined : opts.identity, browser: opts.browser, authDir: opts.authDir });
     for (const note of resolved.notes) (note.level === 'warn' ? log.warn : log.info)(`BibzWhats: ${note.message}`);

package/lib/BibzWhats/device-identity.d.ts

@@ -1,3 +1,4 @@
+/** @module @xbibzlibrary/whatsbibz/lib/BibzWhats/device-identity */
 import type { WABrowserDescription } from '../Types/index.js';
 
 export interface IdentityProfile { id: string; browser: WABrowserDescription; score: number; note: string }

package/lib/BibzWhats/device-identity.js

@@ -1,3 +1,4 @@
+/** @module @xbibzlibrary/whatsbibz/lib/BibzWhats/device-identity */
 // BibzWhats — identitas perangkat tertaut: KUSTOM atau OTOMATIS (paling stabil).
 //
 // Prinsip:

package/lib/BibzWhats/extract.d.ts

@@ -1,3 +1,4 @@
+/** @module @xbibzlibrary/whatsbibz/lib/BibzWhats/extract */
 import type { WAMessage, proto } from '../index.js';
 export type ExtractedType = 'text' | 'image' | 'video' | 'audio' | 'sticker' | 'document' | 'reaction' | 'button' | 'poll' | 'other';
 export interface ExtractedMessage {

package/lib/BibzWhats/extract.js

@@ -1,3 +1,4 @@
+/** @module @xbibzlibrary/whatsbibz/lib/BibzWhats/extract */
 // BibzWhats — ekstraksi isi pesan masuk (WAMessage → objek sederhana).
 // Unwrap otomatis: ephemeral, view-once (v1/v2/ext), document-with-caption, edited.
 

package/lib/BibzWhats/index.d.ts

@@ -1,7 +1,9 @@
+/** @module @xbibzlibrary/whatsbibz/lib/BibzWhats/index */
 export * from './pairing.js';
 export * from './client.js';
 export * from './device-identity.js';
 export * from './send.js';
 export * from './extract.js';
 export * from './jid.js';
+export * from './banner.js';
 export { BIBZWHATS_VERSION, BIBZWHATS_NAME, BIBZWHATS_PACKAGE, BIBZWHATS_UPSTREAM, BIBZWHATS_WA_WEB_VERSION } from './version.js';

package/lib/BibzWhats/index.js

@@ -1,3 +1,4 @@
+/** @module @xbibzlibrary/whatsbibz/lib/BibzWhats/index */
 // BibzWhats — lapisan API tingkat tinggi.
 export * from './pairing.js';
 export * from './client.js';
@@ -5,4 +6,5 @@ export * from './device-identity.js';
 export * from './send.js';
 export * from './extract.js';
 export * from './jid.js';
+export * from './banner.js';
 export { BIBZWHATS_VERSION, BIBZWHATS_NAME, BIBZWHATS_PACKAGE, BIBZWHATS_UPSTREAM, BIBZWHATS_WA_WEB_VERSION } from './version.js';

package/lib/BibzWhats/jid.d.ts

@@ -1,3 +1,4 @@
+/** @module @xbibzlibrary/whatsbibz/lib/BibzWhats/jid */
 export declare function digitsOf(jid: unknown): string;
 export declare const isGroupJid: (jid: unknown) => boolean;
 export declare const isLidJid: (jid: unknown) => boolean;

package/lib/BibzWhats/jid.js

@@ -1,3 +1,4 @@
+/** @module @xbibzlibrary/whatsbibz/lib/BibzWhats/jid */
 // BibzWhats — utilitas JID (PN / LID / grup) tanpa dependensi luar.
 
 const S_WHATSAPP_NET = '@s.whatsapp.net'; // (diekspor oleh WABinary)

package/lib/BibzWhats/pairing.d.ts

@@ -1,3 +1,4 @@
+/** @module @xbibzlibrary/whatsbibz/lib/BibzWhats/pairing */
 export declare const PAIRING_REFRESH_MS: number;
 export declare const PAIRING_BACKOFF_MAX_MS: number;
 export declare function normalizePairingCode(value: unknown): string;

package/lib/BibzWhats/pairing.js

@@ -1,3 +1,4 @@
+/** @module @xbibzlibrary/whatsbibz/lib/BibzWhats/pairing */
 // BibzWhats — PairingController
 // Meminta pairing code (custom 8 karakter atau acak bawaan) dengan disiplin:
 //  • satu request in-flight pada satu waktu

package/lib/BibzWhats/send.d.ts

@@ -1,3 +1,4 @@
+/** @module @xbibzlibrary/whatsbibz/lib/BibzWhats/send */
 import type { WASocket } from '../index.js';
 import type { AnyMessageContent, WAMessage, WAMessageKey, WAPresence } from '../Types/index.js';
 export declare function splitText(text: string, maxLen?: number): string[];

package/lib/BibzWhats/send.js

@@ -1,3 +1,4 @@
+/** @module @xbibzlibrary/whatsbibz/lib/BibzWhats/send */
 // BibzWhats — helper kirim pesan yang sering dipakai bot.
 // Semua fungsi menerima `sock` (WASocket) agar bisa dipakai dengan
 // makeWASocket biasa maupun client.sock dari createBibzWhats().

package/lib/BibzWhats/version.js

@@ -1,7 +1,8 @@
 export const BIBZWHATS_NAME = 'WhatsBibz';
 /** nama paket di npm */
 export const BIBZWHATS_PACKAGE = '@xbibzlibrary/whatsbibz';
-export const BIBZWHATS_VERSION = '1.3.2';
-export const BIBZWHATS_UPSTREAM = 'ourin-baileys@9.0.21 (fork WhiskeySockets/Baileys v7) + patch upstream s/d rc14/master 2026-08 & PR #2769/#2776/#2778/#2789; identitas platform diukur ke server 2026-09-03';
-/** versi WA Web bawaan (fallback) — diperbarui 2026-09-03 dari web.whatsapp.com */
-export const BIBZWHATS_WA_WEB_VERSION = [2, 3000, 1046874154];
+export const BIBZWHATS_VERSION = '1.4.3';
+export const BIBZWHATS_UPSTREAM = 'WhiskeySockets/Baileys v7 + patch upstream s/d 2026-10 (rc14/master & PR #2769/#2776/#2778/#2789/#2804/#2807/#2808/#2834-#2840/#2856/#2864-#2866); identitas platform diukur ke server 2026-10-21';
+/** versi WA Web bawaan (fallback) — diperbarui 2026-10-21 dari web.whatsapp.com */
+export const BIBZWHATS_WA_WEB_VERSION = [2, 3000, 1051141409];
+

package/lib/Defaults/index.d.ts

@@ -1,3 +1,4 @@
+/** @module @xbibzlibrary/whatsbibz/lib/Defaults/index */
 import { proto } from '../../WAProto/index.js';
 import type { SocketConfig } from '../Types/index.js';
 export declare const UNAUTHORIZED_CODES: number[];
@@ -55,6 +56,8 @@ export declare const MEDIA_HKDF_KEY_MAPPING: {
 };
 export type MediaType = keyof typeof MEDIA_HKDF_KEY_MAPPING;
 export declare const MEDIA_KEYS: MediaType[];
+/** 120s timeout for history sync stall detection, same as WA Web's handleChunkProgress / restartPausedTimer (g = 120) */
+export declare const HISTORY_SYNC_PAUSED_TIMEOUT_MS = 120000;
 export declare const MIN_PREKEY_COUNT = 5;
 export declare const INITIAL_PREKEY_COUNT = 812;
 export declare const UPLOAD_TIMEOUT = 30000;

package/lib/Defaults/index.js

@@ -1,8 +1,9 @@
+/** @module @xbibzlibrary/whatsbibz/lib/Defaults/index */
 import { proto } from "../../WAProto/index.js";
 import { makeLibSignalRepository } from "../Signal/libsignal.js";
 import { Browsers } from "../Utils/browser-utils.js";
 import logger from "../Utils/logger.js";
-const version = [2, 3000, 1046874154];
+const version = [2, 3000, 1051141409];
 export const UNAUTHORIZED_CODES = [401, 403, 419];
 export const DEFAULT_ORIGIN = "https://web.whatsapp.com";
 export const CALL_VIDEO_PREFIX = "https://call.whatsapp.com/video/";
@@ -75,11 +76,6 @@ export const DEFAULT_CONNECTION_CONFIG = {
     snapshot: false,
   },
   countryCode: "US",
-  // BibzWhats: tidak ada auto-follow channel diam-diam. Set true + isi
-  // autoFollowNewsletterJid bila memang ingin memakainya.
-  autoFollowNewsletterOnConnect: false,
-  autoFollowNewsletterDelayMs: 90000,
-  autoFollowNewsletterJid: "",
   getMessage: async () => undefined,
   cachedGroupMetadata: async () => undefined,
   makeSignalRepository: makeLibSignalRepository,
@@ -123,6 +119,8 @@ export const MEDIA_HKDF_KEY_MAPPING = {
   "sticker-pack": "Sticker Pack",
 };
 export const MEDIA_KEYS = Object.keys(MEDIA_PATH_MAP);
+/** 120s timeout for history sync stall detection, same as WA Web's handleChunkProgress / restartPausedTimer (g = 120) */
+export const HISTORY_SYNC_PAUSED_TIMEOUT_MS = 120000;
 export const MIN_PREKEY_COUNT = 5;
 export const INITIAL_PREKEY_COUNT = 812;
 export const UPLOAD_TIMEOUT = 30000; // 30 seconds

package/lib/Modded/message_builder.d.ts

@@ -1,3 +1,4 @@
+/** @module @xbibzlibrary/whatsbibz/lib/Modded/message_builder */
 // Deklarasi minimal (upstream tidak menyertakan tipe untuk modul ini).
 export declare const VERSION: string;
 export declare class Toolkit {

package/lib/Modded/message_builder.js

@@ -1,32 +1,8 @@
 /**
- * Do not remove this watermark.
- *
- * NIXCODE - Advanced WhatsApp Interactive Message Builder
- * Built for creating buttons, carousels, native flows,
- * and AI rich response payloads using BibzWhats with
- * fluent chaining, flexible payload customization,
- * and scalable architecture for modern bot development.
- *
- * Runtime:
- * - BibzWhats (fork Baileys)
- *
- * Created by Nixel
- * Contributors: ~ Ahmad tumbuh kembang
- *
- * WhatsApp: wa.me/6285188349341
- * Channel: https://whatsapp.com/channel/0029VbCV1ck8fewpdNb2TY2k
- *
- * Copyright (c) 2026 Nixel
- *
- * Permission is granted to use and modify this library
- * for personal or commercial projects.
- *
- * Reuploading, reselling, relicensing, or redistributing
- * this library as a standalone product is prohibited.
- *
- * Do not claim this project as your own original work.
+ * @module @xbibzlibrary/whatsbibz/Modded/message_builder
+ * BibzWhats Interactive Message Builder
+ * Supports buttons, carousels, native flows, and AI rich response payloads.
  */
-
 'use strict';
 
 const VERSION = '4.6';
@@ -145,7 +121,7 @@ function extractIE(text, { extract = true, hyperlink = true, citation = true, la
 
                 let [txt = '', width = null, height = null, font_height = null, padding = null] = raw.split('|');
 
-                key = `\u004E\u0049\u0058\u0045\u004C_LATEX_${latex_index++}`;
+                key = `BIBZWHATS_LATEX_${latex_index++}`;
                 tag = `{{${key}}}${txt || 'image'}{{/${key}}}`;
 
                 data = {
@@ -169,7 +145,7 @@ function extractIE(text, { extract = true, hyperlink = true, citation = true, la
                     url = url.slice(1);
                 }
 
-                key = `\u004E\u0049\u0058\u0045\u004C_HYPERLINK_${hyperlink_index++}`;
+                key = `BIBZWHATS_HYPERLINK_${hyperlink_index++}`;
                 tag = `{{${key}}}${url}{{/${key}}}`;
 
                 data = {
@@ -184,7 +160,7 @@ function extractIE(text, { extract = true, hyperlink = true, citation = true, la
             } else {
                 if (!citation) continue;
 
-                key = `\u004E\u0049\u0058\u0045\u004C_CITATION_${citation_index - 1}`;
+                key = `BIBZWHATS_CITATION_${citation_index - 1}`;
                 tag = `{{${key}}}${url}{{/${key}}}`;
 
                 data = {
@@ -281,7 +257,7 @@ class Toolkit {
             },
             {
                 upload: _client.waUploadToServer,
-                jid: '\u0040\u006e\u0065\u0077\u0073\u006c\u0065\u0074\u0074\u0065\u0072',
+                jid: '@newsletter',
             }
         );
 
@@ -813,18 +789,15 @@ class Button extends BaseBuilder {
     }
 
     async build(jid, { ...options } = {}) {
-        if (this._cardBuilders && this._cardBuilders.length > 0) {
-            for (const builder of this._cardBuilders) {
-                this.addCard(await builder._card.toCard());
-            }
-            this._cardBuilders = [];
-        }
+        // Konten interactive message = hasil toCard() (body/footer/header + nativeFlowMessage).
+        // Sebelumnya memakai variabel `message` yang tidak pernah didefinisikan → ReferenceError.
+        const payload = await this.toCard();
         return generateWAMessageFromContent(
             jid,
             {
                 ...this._extraPayload,
                 interactiveMessage: {
-                    ...message,
+                    ...payload,
                     contextInfo: this._contextInfo,
                 },
             },
@@ -833,6 +806,7 @@ class Button extends BaseBuilder {
     }
 
     async send(jid, { ...options } = {}) {
+        if (this._buttons.length < 1) throw new Error('Button requires at least one button');
         const msg = await this.build(jid, options);
 
         await this.#client.relayMessage(msg.key.remoteJid, msg.message, {
@@ -997,7 +971,17 @@ class Carousel extends BaseBuilder {
         return this;
     }
 
-    build(jid, { ...options } = {}) {
+    async build(jid, { ...options } = {}) {
+        // Konsumsi builder terdaftar lewat .card(cb). Sebelumnya _cardBuilders tidak pernah
+        // dipakai di sini → carousel terkirim dengan 0 kartu (diam-diam rusak).
+        if (this._cardBuilders && this._cardBuilders.length > 0) {
+            const built = [];
+            for (const builder of this._cardBuilders) {
+                built.push(await builder._card.toCard());
+            }
+            this._cardBuilders = [];
+            this.addCard(built);
+        }
         return generateWAMessageFromContent(
             jid,
             {
@@ -1019,6 +1003,15 @@ class Carousel extends BaseBuilder {
     }
 
     async send(jid, { ...options } = {}) {
+        if (this._cardBuilders && this._cardBuilders.length > 0) {
+            const built = [];
+            for (const builder of this._cardBuilders) {
+                built.push(await builder._card.toCard());
+            }
+            this._cardBuilders = [];
+            this.addCard(built);
+        }
+        if (this._cards.length < 1) throw new Error('Carousel requires at least one card');
         const msg = await this.build(jid, options);
 
         await this.#client.relayMessage(msg.key.remoteJid, msg.message, {
@@ -1243,7 +1236,7 @@ class AIRich extends BaseBuilder {
 
         reels.forEach((item, idx) => {
             this._richResponseSources.push({
-                provider: '\u004E\u0049\u0058\u0045\u004C',
+                provider: 'BIBZWHATS',
                 thumbnailCDNURL: item._thumbnail,
                 sourceProviderURL: item.videoUrl ?? item.url ?? '',
                 sourceQuery: '',
@@ -1344,7 +1337,7 @@ class AIRich extends BaseBuilder {
 
         this._submessages.push({
             messageType: 2,
-            messageText: '[ CANNOT_LOAD_VIDEO - \u004E\u0049\u0058\u0045\u004C ]',
+            messageText: '[ CANNOT_LOAD_VIDEO ]',
         });
 
         items.forEach((item) => {
@@ -1414,7 +1407,7 @@ class AIRich extends BaseBuilder {
 
         this._submessages.push({
             messageType: 2,
-            messageText: '[ CANNOT_LOAD_PRODUCT - NIXEL ]',
+            messageText: '[ CANNOT_LOAD_PRODUCT ]',
         });
 
         const items = Array.isArray(data) ? data : [data];
@@ -1450,7 +1443,7 @@ class AIRich extends BaseBuilder {
 
         this._submessages.push({
             messageType: 2,
-            messageText: '[ CANNOT_LOAD_POST - NIXEL ]',
+            messageText: '[ CANNOT_LOAD_POST ]',
         });
 
         const primitives = posts.map((p) => ({

package/lib/Signal/Group/ciphertext-message.d.ts

@@ -1,3 +1,4 @@
+/** @module @xbibzlibrary/whatsbibz/lib/Signal/Group/ciphertext-message */
 export declare class CiphertextMessage {
     readonly UNSUPPORTED_VERSION: number;
     readonly CURRENT_VERSION: number;

package/lib/Signal/Group/ciphertext-message.js

@@ -1,3 +1,4 @@
+/** @module @xbibzlibrary/whatsbibz/lib/Signal/Group/ciphertext-message */
 export class CiphertextMessage {
     constructor() {
         this.UNSUPPORTED_VERSION = 1;

package/lib/Signal/Group/group-session-builder.d.ts

@@ -1,3 +1,4 @@
+/** @module @xbibzlibrary/whatsbibz/lib/Signal/Group/group-session-builder */
 import { SenderKeyDistributionMessage } from './sender-key-distribution-message.js';
 import { SenderKeyName } from './sender-key-name.js';
 import { SenderKeyRecord } from './sender-key-record.js';

package/lib/Signal/Group/group-session-builder.js

@@ -1,3 +1,4 @@
+/** @module @xbibzlibrary/whatsbibz/lib/Signal/Group/group-session-builder */
 import * as keyhelper from './keyhelper.js';
 import { SenderKeyDistributionMessage } from './sender-key-distribution-message.js';
 import { SenderKeyName } from './sender-key-name.js';

package/lib/Signal/Group/group_cipher.d.ts

@@ -1,3 +1,4 @@
+/** @module @xbibzlibrary/whatsbibz/lib/Signal/Group/group_cipher */
 import { SenderKeyName } from './sender-key-name.js';
 import { SenderKeyRecord } from './sender-key-record.js';
 export interface SenderKeyStore {

package/lib/Signal/Group/group_cipher.js

@@ -1,3 +1,4 @@
+/** @module @xbibzlibrary/whatsbibz/lib/Signal/Group/group_cipher */
 import { decrypt, encrypt } from 'libsignal/src/crypto.js';
 import { SenderKeyMessage } from './sender-key-message.js';
 import { SenderKeyName } from './sender-key-name.js';

package/lib/Signal/Group/index.d.ts

@@ -1,3 +1,4 @@
+/** @module @xbibzlibrary/whatsbibz/lib/Signal/Group/index */
 export { GroupSessionBuilder } from './group-session-builder.js';
 export { SenderKeyDistributionMessage } from './sender-key-distribution-message.js';
 export { SenderKeyRecord } from './sender-key-record.js';

package/lib/Signal/Group/index.js

@@ -1,3 +1,4 @@
+/** @module @xbibzlibrary/whatsbibz/lib/Signal/Group/index */
 export { GroupSessionBuilder } from './group-session-builder.js';
 export { SenderKeyDistributionMessage } from './sender-key-distribution-message.js';
 export { SenderKeyRecord } from './sender-key-record.js';

package/lib/Signal/Group/keyhelper.d.ts

@@ -1,3 +1,4 @@
+/** @module @xbibzlibrary/whatsbibz/lib/Signal/Group/keyhelper */
 import { generateKeyPair } from 'libsignal/src/curve.js';
 type KeyPairType = ReturnType<typeof generateKeyPair>;
 export declare function generateSenderKey(): Buffer;