@xbibzlibrary/whatsbibz 1.3.0

package/CHANGELOG.md

@@ -0,0 +1,93 @@
+# Changelog — @xbibzlibrary/whatsbibz
+
+## 1.3.0 — identitas perangkat tertaut: kustom atau otomatis; rilis npm `@xbibzlibrary/whatsbibz` (2026-09-03)
+
+- **Dipublish ke npm sebagai `@xbibzlibrary/whatsbibz`** (nama tampilan *WhatsBibz*; API `createBibzWhats`/`BIBZWHATS_*`
+  tidak berubah, ditambah alias `createWhatsBibz`, `makeWhatsBibzSocket`, `Browsers.whatsbibz`, `BIBZWHATS_PACKAGE`).
+- Logo baru (gelembung + buku, `assets/logo/preview.png`) menggantikan set vektor "b"; ikon/ICO/banner diturunkan ulang.
+- `prepublishOnly` menjalankan seluruh test + `scripts/check.js`, jadi rilis rusak tidak bisa terpublish.
+
+- **Identitas perangkat tertaut: kustom atau otomatis** (`lib/BibzWhats/device-identity.js`). Default `identity: 'auto'`
+  memilih profil paling stabil (Mac OS/Chrome) dan **berpindah otomatis** bila server menolak (428 sebelum QR / 400 pairing /
+  405) — diuji live: 428→pindah→pairing OK dalam 2,5 s; 400→pindah→sambung ulang→pairing OK dalam 3 s. Profil yang berhasil
+  disimpan di `<authDir>/identity.json` (bertahan melewati wipe sesi) agar nama perangkat konsisten antar restart.
+  Kustom lewat `identity` (tuple / `'archLinux:Firefox'` / `'Mac OS/Safari/15.6.1'` / id profil), alias lama `browser`,
+  atau env `BIBZ_BROWSER` / `BIBZ_DEVICE_OS|BROWSER|VERSION` — dipakai apa adanya, tidak pernah diganti diam-diam.
+  Event baru `identity-changed`; `client.identity` kini {mode, source, profileId, linkedDeviceName, pairingDisplay, tried}.
+  `createPairingController` mendapat hook `onRejected`.
+- **Perbaikan hasil uji produksi (ditemukan saat verifikasi rilis):**
+  - `close()` kini membatalkan reconnect yang sudah terjadwal & `connect()` menolak berjalan setelah ditutup — sebelumnya setiap
+    client meninggalkan satu timer hidup (proses tidak bisa keluar sendiri, socket "hantu" bisa tersambung lagi). Diuji 40 siklus
+    create→close offline + 3 siklus live: 0 timer tersisa, heap stabil (Δ 3 MB).
+  - Putus jaringan setelah pairing code terbit: server menjawab **401 "pairing tertunda"** untuk kredensial yang sama. Dulu itu
+    dihitung sebagai wipe 401 biasa (jeda 10 s + 10 s, dan mengikis kuota `maxSessionWipes`). Kini dikenali: kredensial diganti,
+    kode diminta ulang dalam 2 s, tidak mengurangi kuota; percobaan pertama setelah putus jaringan pada koneksi sehat = 1 s
+    (bukan backoff 10 s). Live: pairing code kedua terbit 10 s setelah putus paksa (sebelumnya 22 s).
+  - **TypeScript**: `WAProto/index.d.ts` dibangkitkan ulang (866 KB, 217 namespace proto — upstream mengirim berkas 2 baris kosong
+    sehingga `import { proto }` gagal kompilasi); `@types/ws` & `long` jadi dependensi; `.d.ts` tidak lagi bergantung pada
+    deklarasi `whatsapp-rust-bridge` yang rusak. Konsumen TS kini lolos `tsc --strict` bahkan dengan `skipLibCheck: false`.
+  - Versi WA Web bawaan → 2.3000.1046721733 (server 2026-09-03 siang).
+- Test: 54 offline (+3 `lifecycle.test.js`, +2 pemulihan pairing) + 11 live. Node 20/22/24/26 hijau.
+- Bot tidak diubah: `conn/connection.js` masih meneruskan `browser` eksplisit (mode kustom, identitas valid).
+
+## 1.2.0 — identitas platform Mac OS & Arch Linux (2026-09-03)
+Diukur langsung ke server produksi WhatsApp (WA Web 2.3000.1046672143) dengan 70+ kombinasi identitas; semua hasil
+ada di `BibzWhats/test/identity-live.test.js` dan laporan `VERIFIKASI-IDENTITAS-2026-09-03.md`.
+- **`Browsers.macOS('Desktop')` + `syncFullHistory` kini berhasil**: `WebSubPlatform.DARWIN` ditutup server (428 sebelum QR,
+  upstream masih mengirimnya) → BibzWhats mengirim `WEB_BROWSER` dan riwayat penuh tetap diminta lewat `requireFullSync`.
+- **`companion_platform_display` (pairing kode) memakai allow-list hasil ukur**: `Arch Linux`, `Desktop`, nama produk,
+  `Mac OS X`, `GNU/Linux` dll. ditolak 400 oleh server. Modul baru `lib/Utils/platform-identity.js` menurunkan nilai yang
+  pasti valid (`derivePairingDisplay`): Arch Linux → `Chrome (Linux)`, Mac OS Desktop → `Chrome (Mac OS)`, nama produk → OS host.
+  Nama di *Perangkat tertaut* (`DeviceProps.os`) tetap apa adanya ("Arch Linux").
+- Preset baru `Browsers.archLinux(b)` = `['Arch Linux', b, '6.12.44']`, `Browsers.linux(b)`; `Browsers.macOS` → versi `15.6.1`;
+  `Browsers.appropriate` membaca distro dari `/etc/os-release` (Arch → "Arch Linux", bukan "Ubuntu").
+- Opsi socket baru: `companionPlatformId`, `webSubPlatform` (override eksplisit, angka enum atau nama).
+- `createBibzWhats`: `lintIdentity` memberi peringatan dini bila `companionPlatformDisplay` pasti 400; properti `client.identity`.
+- Pesan error 400 di `PairingController` diperbaiki (menyebut allow-list, bukan menyarankan 'Chrome (Windows)' saja).
+- Versi WA Web fallback → 2.3000.1046672143 (live 2026-09-03). Test: 37 offline (+11 identitas) + 5 live (`npm run test:live`),
+  lulus di Node 20.20 / 22.23 (Arch `nodejs-lts-jod`, brew `node@22`) / 24.20 / 26.8 (Arch `nodejs`, brew `node`).
+
+## Library baru: `BibzWhats/` (package `bibzwhats` 1.0.0)
+- Fork vendored penuh dari `ourin-baileys@9.0.21` (Baileys v7). Semua API lama diekspor apa adanya → kompatibel 100%.
+- **Handler `companion_reg_refresh` tertanam di source** (`lib/Socket/socket.js` + `lib/Utils/companion-reg-client-utils.js`).
+  Tidak ada lagi `scripts/patch-baileys.js` maupun `postinstall`.
+- Rebrand: `Dugong` → `BibzWhatsEngine` (`lib/Socket/engine.js`), `sock.ourin` → `sock.bibz` (alias `sock.ourin` tetap),
+  logger class `bibzwhats`, publisher sticker pack `BibzWhats`, `Browsers.bibzwhats('Chrome')`, alias tipe `BibzWhatsEventMap`, dsb.
+- Keamanan/etika: **auto-follow newsletter/channel dimatikan** (`autoFollowNewsletterOnConnect=false`, JID default kosong).
+- Lapisan API baru (`lib/BibzWhats/`):
+  - `createBibzWhats(opts)` — versi WA web terbaru per connect, pairing code custom/acak + fallback QR,
+    515 → reconnect, backoff reconnect, wipe sesi otomatis (401/500/411/korup, maks 3×), cache metadata grup, event emitter.
+  - `createPairingController` (dipindahkan dari `conn/connection.js` bot, perilaku identik + opsi `refreshMs/backoffMaxMs`).
+  - Helper: `sendText` (split ≤4000 + retry + whatsappify), `sendMedia` (fallback dokumen), `react`, `presence`,
+    `extractMessage`/`unwrapMessage`/`messageTimestampMs`, `LidMap` + util JID.
+- Source map dibuang (ukuran paket 4.1 MB terkompres / 19.8 MB unpacked); `.d.ts` dilengkapi untuk modul baru + Modded/VoIP.
+- Test: `npm --prefix BibzWhats test` (13 test) dan `scripts/check.js` (verifikasi export).
+
+## Perubahan di bot
+- `package.json`: `"bibzwhats": "file:./BibzWhats"` menggantikan `"baileys": "npm:ourin-baileys"`; `postinstall` & langkah
+  `patch-baileys` di `start` dihapus; `npm test` juga menjalankan test library.
+- `conn/connection.js`: kini tipis — memakai `createBibzWhats`, hanya banner pairing/QR + callback. Export lama
+  (`createPairingController`, `wipeAuthDir`, `PAIRING_REFRESH_MS`, `makeSocketNetworkOptions`) dipertahankan untuk tests.
+- `server.js`: import `downloadMediaMessage` dari `bibzwhats`; import patch dihapus.
+- `tests/patch-baileys.test.js` → diganti `tests/bibzwhats-integration.test.js`.
+- Dockerfile menyalin `BibzWhats/` sebelum `npm install`; `.gitignore`/`.dockerignore` mengabaikan `BibzWhats/node_modules/`.
+- README, egg, komentar diperbarui.
+
+## Hasil verifikasi
+- `node --check` semua file: OK. Import graph `server.js` → `bibzwhats`: OK (322 export).
+- Test bot: 338/341 lulus (2 gagal = `ffmpeg` tidak terpasang di sandbox, bukan terkait library; 1 skipped).
+- Smoke test nyata ke server WhatsApp: handshake noise + `pair-device` diterima, QR ter-generate & di-refresh (60 dtk) — jalur pairing hidup.
+
+## 1.1.0 — sinkron protokol WhatsApp Web (2026-09-02)
+Verifikasi ulang terhadap `web.whatsapp.com` (client_revision **1046603545**), Baileys `7.0.0-rc14` + master, dan issue/PR upstream Agustus 2026.
+Temuan: basis ourin 9.0.21 = Baileys rc10; ada patch rc11–rc14/master yang belum masuk. Semua di-port ke `BibzWhats/lib`:
+- **WIN32 → WIN_HYBRID** (`validate-connection.js`, upstream #2741): sejak ~2026-06-30 server menolak handshake (428 sebelum QR) untuk `Browsers.windows('Desktop')`.
+- **Versi WA Web bawaan** `2.3000.1043857760` → **`2.3000.1046603545`** (Defaults + generics + `BIBZWHATS_WA_WEB_VERSION`); `createBibzWhats` tidak lagi menurunkan versi bila fetch gagal (issue #2777).
+- **`requestPairingCode`** (PR #2769): `query()` bukan `sendNode()`, `creds.me` disimpan hanya setelah server ACK, timeout → error 408, opsi `companionPlatformDisplay` & `pairingRequestTimeoutMs`. `PairingController` mengenali 400 bad-request / timeout dengan pesan yang jelas (`isRegistrationRejected`, `isTimeoutError`, `pairingErrorCode`).
+- **tctoken** (rc11+/#2607): atribut `t`, token kedaluwarsa (~28 hari)/tanpa timestamp dibuang, `profilePictureUrl` menyarangkan token di `<picture>` dan melewatinya untuk JID sendiri/grup.
+- **Guard `protocolMessage` self-only** (rc12), **`Browsers.android()`** + platform ANDROID (#2201), **`groupOnlineCount`** (#2545), **presence tanpa nama tidak dikirim** (PR #2789), **`directPath` diutamakan** saat download (PR #2778), **`lottieStickerMessage`** di-unwrap (PR #2776), **guard dispatcher fetch** (#2557), **cleanup memori** `ev.destroy()`/`signalRepository.close()`/`registerSocketEndHandler` (#2191).
+- Deps: `whatsapp-rust-bridge` 0.5.2 → **0.5.5**, `protobufjs` ^7.5.6, `music-metadata` ^11.12.3. `.d.ts` diperbarui.
+- `createBibzWhats`: event **`ready` kini per socket baru** (start + tiap reconnect; `readyOnEveryConnect:false` = perilaku lama) + event `first-ready`. Memperbaiki bug lama bot: setelah reconnect handler pesan tidak terpasang di socket baru.
+- Bot: `conn/connection.js` memakai `readyOnEveryConnect` + env `BIBZ_PLATFORM_DISPLAY`; test `tests/bibzwhats-integration.test.js` +1, library `test/compat-2026-09.test.js` (12 test).
+- **Bugfix `client.sock`**: getter dilewatkan lewat `Object.assign` → nilainya disalin sekali dan membeku di socket pertama setelah reconnect (ditemukan smoke test reconnect). Kini `Object.defineProperty` — `client.sock` selalu socket aktif.
+- Verifikasi: library 26/26 test; smoke test nyata: handshake + QR OK dengan versi 2.3000.1046603545, `requestPairingCode` kini melempar error (bukan sukses palsu) dan `creds.me` tetap kosong.

package/LICENSE

@@ -0,0 +1,22 @@
+MIT License
+
+Copyright (c) 2026 Xbibz Developer (BibzWhats)
+Copyright (c) 2025 Rajeh Taher / WhiskeySockets (Baileys) — lihat LICENSE.upstream
+
+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.

package/LICENSE.upstream

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Rajeh Taher/WhiskeySockets
+
+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.

package/README.md

@@ -0,0 +1,280 @@
+<p align="center">
+  <img src="https://raw.githubusercontent.com/xbibzlibrary/whatsbibz/main/assets/logo/preview.png" alt="WhatsBibz" width="420"
+       onerror="this.src='assets/logo/preview.png'">
+</p>
+
+# WhatsBibz
+
+[![npm](https://img.shields.io/npm/v/%40xbibzlibrary%2Fwhatsbibz?label=%40xbibzlibrary%2Fwhatsbibz&color=0a6958)](https://www.npmjs.com/package/@xbibzlibrary/whatsbibz)
+[![node](https://img.shields.io/badge/node-%E2%89%A520-0a6958)](#instalasi)
+[![license](https://img.shields.io/badge/license-MIT-0a6958)](LICENSE)
+
+> Paket npm: **`@xbibzlibrary/whatsbibz`** — nama API internal tetap `BibzWhats`
+> (`createBibzWhats`, `BIBZWHATS_*`); alias `createWhatsBibz` juga tersedia.
+
+Library WhatsApp Web multi-device untuk ekosistem **Xbibz** — fork dari
+Baileys v7 (basis `ourin-baileys@9.0.21`) dengan lapisan API tingkat tinggi,
+pairing code custom, self-healing session, dan handler protokol terbaru
+(`companion_reg_refresh`) yang **sudah tertanam di source** (tidak perlu
+patch `postinstall`).
+
+- ESM only, Node.js ≥ 20
+- Seluruh API Baileys/ourin tetap diekspor → kode lama jalan tanpa perubahan
+- `createBibzWhats()` = koneksi + pairing + reconnect + wipe sesi otomatis dalam satu panggilan
+
+## Instalasi
+
+```bash
+npm install @xbibzlibrary/whatsbibz
+# atau lokal (vendored di proyek):
+npm install ./BibzWhats
+```
+
+Semua contoh di bawah memakai specifier `@xbibzlibrary/whatsbibz`. Bila kamu memasangnya
+sebagai vendored `bibzwhats` (`"bibzwhats": "file:./BibzWhats"`), cukup ganti specifier-nya —
+API-nya sama persis.
+
+Dependensi opsional (peer): `sharp` (thumbnail media), `qrcode-terminal`
+(QR ASCII saat fallback), `link-preview-js`, `jimp`, `audio-decode`,
+`@roamhq/wrtc` (VoIP).
+
+## Mulai cepat — `createBibzWhats()`
+
+```js
+import { createBibzWhats, extractMessage, sendText } from '@xbibzlibrary/whatsbibz';
+
+const client = await createBibzWhats({
+  phone: '6281234567890',     // nomor bot (digit + kode negara)
+  pairingCode: 'XBIBZPRO',    // opsional: kode custom 8 karakter A-Z0-9
+  authDir: 'bibzwhats-session',
+  printQR: true,              // QR ASCII bila pairing code tak kunjung diterima
+});
+
+client.on('pairing-code', (code, { custom }) =>
+  console.log(`PAIRING CODE: ${code} ${custom ? '(custom)' : '(acak)'}`));
+
+client.on('ready', (sock) => {
+  console.log('terhubung sebagai', sock.user?.id);
+  sock.ev.on('messages.upsert', async ({ messages, type }) => {
+    if (type !== 'notify') return;
+    for (const m of messages) {
+      if (m.key.fromMe) continue;
+      const item = extractMessage(m);
+      if (item?.type === 'text' && /^ping$/i.test(item.text)) {
+        await sendText(sock, m.key.remoteJid, '*pong* dari BibzWhats', { quoted: m });
+      }
+    }
+  });
+});
+```
+
+`client` adalah `EventEmitter`:
+
+| Event | Payload | Keterangan |
+|---|---|---|
+| `pairing-code` | `(code, {custom, fallback})` | kode siap dimasukkan di HP |
+| `qr` | `(qr)` | fallback QR (setelah `qrFallbackAfterMs`, atau langsung bila `phone` kosong) |
+| `ready` | `(sock)` | socket **baru** siap dipakai — pasang handler di sini. Dipancarkan saat start **dan tiap reconnect** (socket lama mati, listener ikut hilang). Set `readyOnEveryConnect:false` untuk perilaku lama (sekali) |
+| `first-ready` | `(sock)` | hanya sekali seumur client |
+| `open` / `close` | `(sock)` / `({status, error})` | tiap kali koneksi buka/tutup |
+| `user` | `(digits)` | nomor bot terdeteksi (persist bila perlu) |
+| `reconnecting` | `({delay, attempt, fresh})` | reconnect dijadwalkan |
+| `session-wiped` | `(reason)` | sesi dihapus (401/500/411/korup) |
+| `give-up` | `(message)` | berhenti mencoba — perlu campur tangan manusia |
+
+Properti/metode: `client.sock` (socket aktif; berubah setelah reconnect),
+`client.isConnected()`, `client.close()`, `client.logout()`.
+
+### Perilaku bawaan
+
+- **Versi WA Web terbaru** diambil di setiap connect (`fetchLatestWaWebVersion`) — server menolak pairing dari klien yang versinya tertinggal. Bila fetch gagal, versi **tidak diturunkan** (dipakai versi bawaan library `BIBZWHATS_WA_WEB_VERSION`, diperbarui 2026-09-03 → `2.3000.1046721733`; upstream issue #2777: versi lama = 408 loop).
+- **Pairing code diverifikasi server**: `requestPairingCode()` menunggu jawaban `companion_hello` (upstream PR #2769). Penolakan (`400 bad-request`, `429 rate-overlimit`) atau timeout kini **terlihat sebagai error** dan `creds.me` tidak tersimpan untuk perangkat yang tak pernah diakui — dulu kode "sukses" palsu muncul tapi notifikasi tautkan perangkat tidak pernah datang di HP.
+- `companion_platform_display` **divalidasi WhatsApp dengan allow-list**. Sejak 1.2.0 library menurunkannya otomatis ke nilai yang pasti valid (`Browsers.macOS` → `"Chrome (Mac OS)"`, `Browsers.archLinux` → `"Chrome (Linux)"`, nama produk → OS host). Override manual tetap dihormati apa adanya — lihat § Identitas platform.
+- **515 restartRequired** setelah pairing = normal → reconnect otomatis 2 dtk.
+- **401 loggedOut / 500 badSession / 411 / sesi korup** → folder sesi dihapus, kredensial baru, pairing ulang (maks. `maxSessionWipes`, default 3). Identitas perangkat yang sudah terbukti diterima (`identity.json`) **tidak** ikut dihapus.
+- **401 saat pairing masih tertunda** (koneksi putus setelah kode terbit, lalu sambung ulang) dikenali terpisah: kredensial diganti dan kode diminta ulang dalam 2 s, tanpa mengurangi kuota `maxSessionWipes`. Event `reconnecting` membawa `pairingPending: true`.
+- **Reconnect** biasa dengan backoff 10 s × percobaan (maks. 60 s, `maxReconnectAttempts` = 10); koneksi yang sudah sehat lalu putus jaringan mencoba lagi dalam 1 s dulu.
+- **`client.close()` bersih**: reconnect terjadwal dibatalkan, tidak ada timer tersisa — proses bisa keluar sendiri (diuji 40 siklus create→close).
+- **Pairing controller**: satu request in-flight, refresh 150 dtk (kode yang sedang diketik tidak hangus), custom code ditolak → fallback acak sekali, 428/429 → backoff eksponensial sampai 10 menit.
+- **IPv4 dipaksa** untuk upload media (`forceIPv4`, bisa dimatikan).
+- Cache metadata grup 5 menit (`cachedGroupMetadata`) — hemat query saat kirim ke grup.
+- **Tidak ada auto-follow channel/newsletter diam-diam** (`autoFollowNewsletterOnConnect` default `false`).
+
+Semua opsi bisa dioverride; opsi mentah `makeWASocket` lewat `socketConfig`.
+
+## API tingkat rendah (kompatibel Baileys)
+
+```js
+import makeWASocket, { useMultiFileAuthState, DisconnectReason, fetchLatestWaWebVersion, downloadMediaMessage } from '@xbibzlibrary/whatsbibz';
+```
+
+Semua yang ada di Baileys v7 / ourin-baileys tersedia: `makeWASocket`,
+`useMultiFileAuthState`, `DisconnectReason`, `downloadMediaMessage`, `proto`,
+`Browsers`, `jidNormalizedUser`, interactive message (`sock.sendMessage(jid, { interactiveButtons: [...] })`),
+album, newsletter, `Button`/`Carousel`/`AIRich` builder, `VoipClient`, dll.
+
+Penyesuaian nama: `Dugong` → `BibzWhatsEngine`, `sock.ourin` → `sock.bibz`
+(alias `sock.ourin` dipertahankan), `Browsers.whatsbibz('Chrome')` tersedia (alias `Browsers.bibzwhats`).
+
+## Helper BibzWhats
+
+```js
+import {
+  sendText, sendMedia, react, presence, sendWithRetry, splitText, whatsappify,
+  extractMessage, unwrapMessage, messageTimestampMs,
+  LidMap, digitsOf, pnJid, lidJid, isGroupJid, isLidJid, sameUser, normalizeJid,
+  createPairingController, normalizePairingCode, wipeAuthDir,
+} from '@xbibzlibrary/whatsbibz';
+```
+
+- `sendText(sock, jid, text, {quoted, format})` — pecah otomatis ≤ 4000 karakter, retry 3×, markdown ChatGPT → format WA.
+- `sendMedia(sock, jid, content, {quoted, fallbackToDocument})` — bila media ditolak, dikirim ulang sebagai dokumen.
+- `extractMessage(m)` — `{type, text, participant, mentions, quoted, imageMsg|audioMsg|...}`; unwrap ephemeral/view-once/edited otomatis; tombol/list/poll/interactive response → `type: 'button' | 'poll'`.
+- `LidMap` — peta LID ↔ nomor (`learnFromMessage(m)`, `canonical(jid)`, `variants(jid)`, `toJSON()/fromJSON()`).
+
+## Handler `companion_reg_refresh` (bawaan)
+
+Sejak 2026-07-28 server WA mengirim notification `companion_reg_refresh` /
+`pair-device-rotate-qr` yang menyita material registrasi perangkat yang belum
+paired. BibzWhats menanganinya di `lib/Socket/socket.js`: rotate adv secret
+(32 byte CSPRNG) → `creds.update` → render ulang QR **ref yang sama** (pool ref
+tidak habis). Bila `creds.me` sudah ada (pairing code sudah diminta / pair
+sukses) adv secret dipertahankan agar verifikasi tidak rusak.
+
+Fungsi murni untuk pengujian: `makePairingQRRenderer`, `handleCompanionRegRefresh`
+(`import ... from '@xbibzlibrary/whatsbibz'`).
+
+## Struktur
+
+```
+lib/
+  BibzWhats/      client.js (createBibzWhats), pairing.js, send.js, extract.js, jid.js
+  Socket/         socket.js (+ handler refresh), engine.js (BibzWhatsEngine), messages-*.js, ...
+  Utils/          companion-reg-client-utils.js (baru), generics.js, messages-media.js, ...
+  Defaults/ Signal/ Types/ WABinary/ WAM/ WAUSync/ VoIP/ Modded/
+WAProto/          protobuf WhatsApp
+```
+
+## Identitas perangkat tertaut: kustom atau otomatis (paling stabil)
+
+Yang tampil di HP sebagai *Perangkat tertaut* ditentukan oleh `browser = [os, browser, version]`.
+Sejak 1.3.0 ada dua mode:
+
+**Otomatis (default — tidak perlu setel apa pun).** Library memilih profil dengan skor stabilitas
+tertinggi (`Mac OS / Chrome`), lalu **berpindah sendiri** bila server menolaknya — `428` sebelum QR,
+`400 bad-request` saat pairing kode, atau `405` — ke profil berikutnya (`Mac OS/Safari` → `Windows/Chrome`
+→ `Linux/Chrome` → `Ubuntu/Chrome` → …). Profil yang terbukti bekerja disimpan di `<authDir>/identity.json`
+sehingga setelah restart identitasnya tetap sama (nama perangkat di HP tidak berubah-ubah).
+
+```js
+const client = await createBibzWhats({ phone });           // identity: 'auto'
+client.on('identity-changed', (i) => console.log('ganti identitas →', i.linkedDeviceName, i.reason));
+console.log(client.identity);
+// { mode:'auto', profileId:'macos-chrome', linkedDeviceName:'Chrome (Mac OS)',
+//   pairingDisplay:'Chrome (Mac OS)', pairingDisplayAccepted:true, tried:[] }
+```
+
+**Kustom.** Identitas yang kamu tentukan dipakai **apa adanya** — tidak pernah diganti diam-diam. Bila
+server menolaknya kamu mendapat log error yang jelas, bukan identitas lain. Semua bentuk ini setara:
+
+```js
+createBibzWhats({ phone, identity: Browsers.archLinux('Chrome') });      // tuple preset
+createBibzWhats({ phone, identity: ['Arch Linux', 'Firefox', '6.16.4'] }); // tuple bebas
+createBibzWhats({ phone, identity: 'archLinux:Firefox' });                 // "preset:Browser"
+createBibzWhats({ phone, identity: 'Mac OS/Safari/15.6.1' });              // "OS/Browser/Versi"
+createBibzWhats({ phone, identity: 'linux-chrome' });                      // id profil
+createBibzWhats({ phone, browser: ['Mac OS', 'Chrome', '14.4.1'] });       // alias lama, tetap jalan
+```
+
+Lewat environment (tanpa ubah kode): `BIBZ_BROWSER="archLinux:Chrome"` atau `BIBZ_BROWSER="Arch Linux/Firefox/6.16"`,
+atau trio `BIBZ_DEVICE_OS="Arch Linux" BIBZ_DEVICE_BROWSER="Chrome" BIBZ_DEVICE_VERSION="6.16"`. `BIBZ_BROWSER=auto`
+memaksa mode otomatis. Prioritas: opsi di kode → env → otomatis.
+
+| Profil auto (urutan) | Nama di HP | Display pairing |
+|---|---|---|
+| `macos-chrome` (skor 100) | Chrome (Mac OS) | Chrome (Mac OS) |
+| `macos-safari` 95 · `windows-chrome` 92 · `linux-chrome` 90 · `ubuntu-chrome` 88 | … | sama dengan nama |
+| `macos-firefox` 85 · `windows-edge` 84 · `archlinux-chrome` 80 | Chrome (Arch Linux) | Chrome (Linux) |
+| `macos-desktop` / `windows-desktop` (hanya bila diminta eksplisit; butuh `syncFullHistory`) | Desktop (…) | Chrome (…) |
+
+Opsi terkait: `maxIdentityRotations` (default 4). Fungsi yang diekspor: `resolveDeviceIdentity`,
+`parseBrowserSpec`, `identityFromEnv`, `IDENTITY_PROFILES`, `describeIdentity`, `createIdentityRotator`.
+
+## Identitas platform — Mac OS & Arch Linux (diukur ke server 2026-09-03)
+
+Identitas companion adalah tuple `browser = [os, browser, version]`. Ia dipakai di **tiga**
+tempat dengan aturan berbeda, dan BibzWhats menangani ketiganya:
+
+| Tempat | Dipakai untuk | Aturan server | Yang dilakukan BibzWhats |
+|---|---|---|---|
+| `DeviceProps.os` (= `browser[0]`) | teks di *Perangkat tertaut* di HP | bebas | dikirim apa adanya: **"Mac OS"**, **"Arch Linux"** |
+| `companion_platform_display` (pairing kode) | validasi `link_code_companion_reg` | **allow-list** — tak dikenal = `400 bad-request`, HP tak dapat notifikasi | diturunkan otomatis ke padanan valid (`derivePairingDisplay`) |
+| `WebInfo.webSubPlatform` (`Desktop` + `syncFullHistory`) | jenis klien desktop | `DARWIN`/`APP_STORE` **ditutup** (428 sebelum QR), `WIN_HYBRID`/`WEB_BROWSER` OK | Mac OS Desktop → `WEB_BROWSER` (riwayat penuh tetap via `requireFullSync`) |
+
+```js
+import { createBibzWhats, Browsers } from '@xbibzlibrary/whatsbibz';
+
+// macOS — tampil "Chrome (Mac OS)" / "Safari (Mac OS)" di HP
+await createBibzWhats({ phone, browser: Browsers.macOS('Chrome') });   // default library
+
+// Arch Linux — tampil "Chrome (Arch Linux)" di HP; pairing kode memakai "Chrome (Linux)"
+await createBibzWhats({ phone, browser: Browsers.archLinux('Chrome') });
+
+// mengikuti host: macOS → "Mac OS", Arch → "Arch Linux" (dibaca dari /etc/os-release), Windows → "Windows"
+await createBibzWhats({ phone, browser: Browsers.appropriate('Chrome') });
+
+client.identity  // → { browser: ['Arch Linux','Chrome','6.12.44'], pairingDisplay: 'Chrome (Linux)' }
+```
+
+Hasil pengukuran `companion_platform_display` terhadap server produksi (WA Web 2.3000.1046672143):
+
+| Diterima | Ditolak (400) |
+|---|---|
+| OS: `Mac OS`, `macOS`, `Windows`, `Linux`, `Ubuntu`, `Debian`, `Fedora`, `CentOS`, `Gentoo`, `Manjaro`, `Chromium OS`, `Android`, `iOS` | OS: `Arch Linux`, `Arch`, `ArchLinux`, `GNU/Linux`, `Mac OS X`, `Linux Mint`, `openSUSE`, `Kali`, `NixOS`, `Pop!_OS`, `FreeBSD`, `Chrome OS`, nama produk apa pun |
+| Browser: `Chrome`, `Chromium`, `Firefox`, `Safari`, `Edge`, `Opera`, `Brave`, `Vivaldi`, `Arc` | Browser: `Desktop`, nama produk |
+
+Helper yang diekspor: `derivePairingDisplay(browser)`, `isPairingDisplayAccepted(str)`,
+`resolvePairingOs(os)`, `lintIdentity({browser, companionPlatformDisplay})`, `hostOsLabel()`,
+`linuxDistroName()`. Opsi socket baru: `companionPlatformId`, `webSubPlatform` (override eksplisit).
+
+Uji hidup ke server (tanpa HP, nomor fiktif Ofcom +44 7700 900xxx): `npm run test:live`.
+
+## Kompatibilitas WhatsApp Web (sinkron 2026-09-02)
+
+Basis `ourin-baileys@9.0.21` setara Baileys **7.0.0-rc10** (Mei 2026). Patch upstream rc11 → rc14 → master + PR terbuka yang relevan sudah di-port:
+
+| Patch | Sumber | Dampak |
+|---|---|---|
+| `WIN32` → `WIN_HYBRID` untuk `Browsers.windows('Desktop')` | master #2741 (2026-08-04) | server menutup 428 sebelum QR bila WIN32 diiklankan |
+| versi WA Web bawaan `2.3000.1046721733` | web.whatsapp.com (2026-09-03) | fallback tidak lagi tertinggal |
+| `requestPairingCode` pakai `query()`, `creds.me` setelah ACK, `companionPlatformDisplay` | PR #2769 | pairing kode gagal kini terdeteksi, sesi tidak teracuni |
+| tctoken: atribut `t`, token kedaluwarsa/tanpa timestamp dibuang, bersarang di `<picture>`, tidak untuk JID sendiri | rc11+, #2607 | `profilePictureUrl` & kirim 1:1 sesuai WA Web |
+| guard `protocolMessage` self-only (history sync / app-state key / LID migration / PDO) | rc12 | pengirim asing tidak bisa memalsukan state lokal |
+| `Browsers.android()` + platform ANDROID (eksperimental) | #2201 | companion Android (bisa terima view-once) |
+| `DARWIN` → `WEB_BROWSER` untuk `Browsers.macOS('Desktop')`; `companion_platform_display` allow-list; `Browsers.archLinux/linux`; `appropriate()` sadar distro | pengukuran BibzWhats 2026-09-03 (belum ada di upstream) | Mac OS Desktop tidak lagi 428; Arch Linux bisa pairing kode |
+| `groupOnlineCount` di presence grup | #2545 | data tambahan `presence.update` |
+| `<presence/>` tidak dikirim pada `creds.update` parsial | PR #2789 | `markOnlineOnConnect:false` dihormati, notifikasi HP tidak tersedot |
+| `downloadContentFromMessage` mengutamakan `directPath` | PR #2778 | hindari `ENOTFOUND a.whatsapp.net` |
+| `lottieStickerMessage` di-unwrap | PR #2776 | stiker Lottie terdeteksi sebagai sticker |
+| guard `dispatcher` fetch (hanya Undici) | #2557 | `https.Agent` tidak bikin fetch error |
+| `ev.destroy()`, `signalRepository.close()`, `registerSocketEndHandler` | #2191 | tidak bocor memori setelah reconnect berulang |
+| `whatsapp-rust-bridge` 0.5.5 | upstream rc14 | dukungan CPU tanpa SIMD |
+
+Cek sendiri kapan saja: `node -e "import('@xbibzlibrary/whatsbibz').then(m=>m.fetchLatestWaWebVersion().then(console.log))"`.
+
+## TypeScript
+
+Deklarasi tipe ikut di paket (`lib/index.d.ts`, `WAProto/index.d.ts` lengkap 217 namespace `proto`). Diverifikasi dengan
+`tsc --strict`, `moduleResolution: NodeNext`, dan `skipLibCheck: false` — tidak perlu `@types` tambahan selain `@types/node`.
+
+```ts
+import { createBibzWhats, type BibzWhatsClient, type ResolvedIdentity } from '@xbibzlibrary/whatsbibz';
+const client: BibzWhatsClient = await createBibzWhats({ phone: '628…', identity: 'archLinux:Chrome' });
+client.on('identity-changed', (i) => console.log(i.linkedDeviceName));
+```
+
+## Catatan
+
+- Logo & ikon (PNG/ICO) ada di `assets/logo/` — lihat `assets/logo/README.md`.
+- WhatsApp Web API tidak resmi — gunakan nomor khusus, hindari spam (risiko banned).
+- Lisensi MIT (WhatsBibz/BibzWhats) di atas MIT Baileys — lihat `LICENSE` dan `LICENSE.upstream`.

package/VERIFIKASI-IDENTITAS-2026-09-03.md

@@ -0,0 +1,138 @@
+# BibzWhats 1.2.0 — Verifikasi identitas platform Mac OS & Arch Linux
+
+Tanggal: 2026-09-03 (WIB) · Server: web.whatsapp.com, WA Web **2.3000.1046672143** (client_revision live saat uji)
+Lingkup: **library saja** (`BibzWhats/`), tanpa menyentuh bot. Metode: unit test offline + koneksi nyata ke
+server WhatsApp (handshake Noise → QR → `requestPairingCode`) dengan kredensial baru per kasus dan nomor fiktif
+Ofcom (+44 7700 900xxx — rentang drama, tidak pernah dialokasikan; server tetap memvalidasi payload).
+Tidak ada HP yang menerima notifikasi dan tidak ada sesi yang disimpan.
+
+## 1. Ringkasan
+
+| Pertanyaan | Jawaban |
+|---|---|
+| Bisa tampil sebagai **Mac OS** di perangkat tertaut? | Ya — `Browsers.macOS('Chrome'|'Safari'|'Firefox'|'Edge')`: QR OK, pairing kode **diterima** |
+| Bisa tampil sebagai **Arch Linux**? | Ya — `Browsers.archLinux(...)`: `DeviceProps.os = "Arch Linux"`; QR OK; pairing kode **diterima** setelah display diturunkan otomatis ke `Chrome (Linux)` (nilai literal `Chrome (Arch Linux)` ditolak 400 oleh server) |
+| `Browsers.macOS('Desktop')` + `syncFullHistory` (riwayat penuh)? | **Sekarang berhasil.** Sebelumnya (dan di upstream Baileys sampai hari ini) mengirim `WebSubPlatform.DARWIN` → server memutus **428 sebelum QR**. BibzWhats mengirim `WEB_BROWSER`; QR OK & pairing diterima; `requireFullSync=true` tetap terkirim |
+| Jalan di Node yang dipakai macOS/Arch? | Lulus di Node **20.20.2** (sandbox), **22.23.2** (Arch `nodejs-lts-jod`, brew `node@22`), **24.20.0**, **26.8.1** (Arch `extra/nodejs`, brew `node`) — offline 37/37 dan live 5/5 |
+
+## 2. Apa yang diubah (semua di `BibzWhats/lib`)
+
+| Berkas | Perubahan |
+|---|---|
+| `Utils/platform-identity.js` (**baru**) + `.d.ts` | allow-list OS/browser hasil ukur, `derivePairingDisplay`, `isPairingDisplayAccepted`, `resolvePairingOs/Browser`, `hostOsLabel`, `linuxDistroName` (/etc/os-release), `lintIdentity` |
+| `Utils/browser-utils.js` | `Browsers.archLinux`, `Browsers.linux`, `macOS` → `15.6.1`, `bibzwhats` → `1.2.0`, `appropriate()` memakai nama distro nyata |
+| `Utils/validate-connection.js` | `PLATFORM_MAP['Mac OS'] = WEB_BROWSER` (bukan DARWIN); opsi `webSubPlatform` override |
+| `Socket/socket.js` | `companion_platform_display = config.companionPlatformDisplay ?? derivePairingDisplay(browser)`; `companion_platform_id` bisa di-override (`companionPlatformId`) |
+| `BibzWhats/client.js` (+`.d.ts`) | `lintIdentity` saat start (peringatan dini), `client.identity` |
+| `BibzWhats/pairing.js` | pesan error 400 menyebut allow-list |
+| `Types/index.d.ts`, `Types/Socket.d.ts` | tipe untuk preset & opsi baru |
+| `Defaults`, `Utils/generics.js`, `BibzWhats/version.js` | versi WA fallback 2.3000.1046672143; `BIBZWHATS_VERSION = 1.2.0` |
+| `test/identity.test.js` (**baru**, 11) · `test/identity-live.test.js` (**baru**, 5, aktif dgn `BIBZ_LIVE=1`) | — |
+
+Tidak ada perubahan API yang memutus kompatibilitas: semua export lama tetap; default `Browsers.macOS('Chrome')` tetap.
+
+## 3. Hasil pengukuran ke server (mentah)
+
+### 3a. Handshake + registrasi (QR) per identitas — semua kredensial baru
+| Identitas (`browser`, opsi) | webSubPlatform terkirim | Hasil |
+|---|---|---|
+| Mac OS / Chrome, Safari, Firefox, Edge | WEB_BROWSER | QR OK (0,3–0,6 s) |
+| Mac OS / Desktop, tanpa sync | WEB_BROWSER | QR OK |
+| Mac OS / Desktop + syncFullHistory — **kode lama** | **DARWIN (3)** | **FAIL 428 "Connection Terminated" sebelum QR** |
+| Mac OS / Desktop + syncFullHistory — **1.2.0** | WEB_BROWSER (0) | QR OK, pairing diterima |
+| Mac OS / Desktop + sync, override `WIN_HYBRID` | WIN_HYBRID (5) | QR OK, pairing diterima |
+| Mac OS / Desktop + sync, override `APP_STORE` | APP_STORE (1) | FAIL 428 |
+| Arch Linux / Chrome, Firefox | WEB_BROWSER | QR OK |
+| Arch Linux / Desktop + syncFullHistory | WEB_BROWSER | QR OK |
+| Linux / Chrome · Ubuntu / Chrome · Debian / Chrome | WEB_BROWSER | QR OK |
+| Windows / Desktop + syncFullHistory | WIN_HYBRID | QR OK |
+
+### 3b. `companion_platform_display` pada `link_code_companion_reg stage=companion_hello`
+Server menjawab `<iq type='result'><link_code_companion_reg stage='companion_hello'><link_code_pairing_ref>…` (diterima)
+atau `<error code='400' text='bad-request'/>` (ditolak). Format wajib `"<Browser> (<OS>)"`; huruf besar-kecil bebas.
+
+| Nilai | Hasil |
+|---|---|
+| Chrome (Mac OS) · Safari (Mac OS) · Firefox (Mac OS) · Edge (Mac OS) · Opera (Mac OS) · Chromium (Mac OS) · Brave (Mac OS) · Vivaldi (Mac OS) · Arc (Mac OS) · Mobile Safari (Mac OS) · chrome (mac os) · Chrome (macOS) | **diterima** |
+| Chrome (Linux) · Firefox (Linux) · Safari (Linux) · Chrome (Ubuntu) · Chrome (Debian) · Chrome (Fedora) · Chrome (CentOS) · Chrome (Gentoo) · Chrome (Manjaro) · Chrome (Chromium OS) · Chrome (Windows) · Edge (Windows) · Chrome (Android) · Safari (iOS) | **diterima** |
+| **Chrome (Arch Linux)** · Chrome (Arch) · Chrome (ArchLinux) · Chrome (Arch Linux ARM) · Chrome (GNU/Linux) · Chrome (Linux Mint) · Chrome (Mint) · Chrome (openSUSE) · Chrome (Kali) · Chrome (Pop!_OS) · Chrome (NixOS) · Chrome (FreeBSD) · Chrome (Chrome OS) · Chrome (Mac OS X) | **400 bad-request** |
+| **Desktop (Mac OS)** · **Desktop (Windows)** · Foo (Mac OS) · Chrome (BibzWhats) | **400 bad-request** |
+
+`companion_platform_id` (0 UNKNOWN, 1 Chrome, 3 Firefox, 5/6 Safari, 7 Desktop/Electron, 8 UWP, 9 OTHER) **tidak** memengaruhi
+hasil — hanya string display yang divalidasi. Kesimpulan ini konsisten dengan kode WA Web sendiri
+(`WAWebAltDeviceLinkingIq`: `companionPlatformDisplayElementValue: browser.name + " (" + os.name + ")"` dari ua-parser).
+
+### 3c. Perilaku `requestPairingCode` (nomor/kode)
+| Kasus | Hasil |
+|---|---|
+| nomor valid 12 digit · nomor 20 digit | diterima, `creds.me` terisi setelah ACK |
+| nomor 3 digit · `+44 7700…` (dengan +/spasi) · `0447…` | **408 Timed Out** (server tidak menjawab) — `creds.me` tetap kosong (tidak meracuni sesi) |
+| kode custom `XBIBZPRO` / `xbibzpro` | diterima; server tidak mengubah huruf |
+| kode custom 7 karakter | ditolak lokal sebelum kirim |
+| rate-limit | `500 rate-overlimit` (terjadi bila 1 nomor dipakai berulang dalam waktu singkat; harness memakai nomor berbeda per kasus) |
+
+### 3d. `createBibzWhats` end-to-end (jalur nyata library)
+Mac OS/Chrome dan Arch Linux/Chrome, `pairingCode: 'XBIBZPRO'`: event `pairing-code` `{custom:true}` dalam <3 s,
+`client.identity.pairingDisplay` = `Chrome (Mac OS)` / `Chrome (Linux)`, `creds.me` & `creds.pairingCode` tersimpan,
+putus paksa → `close 428` → `reconnecting` otomatis.
+
+## 4. Cara mengulang
+```bash
+cd BibzWhats
+npm install
+npm test                 # 42 test: 37 offline lulus, 5 live di-skip
+npm run test:live        # 5 test ke server WA nyata (≈40 s), nomor fiktif, tanpa HP
+```
+Bila suatu hari `Chrome (Linux)` ikut ditolak, ubah tabel di `lib/Utils/platform-identity.js` (`PAIRING_ACCEPTED_OS`)
+dan jalankan `npm run test:live` untuk memverifikasi.
+
+## 5. Catatan jujur
+- **Belum diuji**: pairing tuntas sampai HP sungguhan menampilkan "Arch Linux"/"Mac OS" di *Perangkat tertaut* — butuh HP
+  pemilik nomor. Teks itu berasal dari `DeviceProps.os` yang terkirim di registrasi (diverifikasi byte-nya dikirim dan diterima
+  server tanpa penolakan), jadi risikonya kecil.
+- Allow-list server bisa berubah tanpa pemberitahuan; tabel di atas adalah potret 2026-09-03.
+- `Browsers.appropriate()` di sandbox uji menghasilkan `"Debian"` (host Debian 13); di Arch akan menghasilkan `"Arch Linux"`
+  (diuji dengan `/etc/os-release` tiruan di `test/identity.test.js`).
+
+## 6. Identitas kustom vs otomatis (ditambahkan setelah § 1–5)
+
+Permintaan: identitas perangkat tertaut harus bisa disetel kustom, dan bila tidak disetel library otomatis memakai yang
+paling stabil. Implementasi di `lib/BibzWhats/device-identity.js`, terintegrasi ke `createBibzWhats`.
+
+| Skenario (live, server produksi, nomor fiktif) | Hasil |
+|---|---|
+| Tidak ada setelan → auto | profil `macos-chrome` langsung stabil; `pairing-code` 0,9 s; `identity.json` reason `pairing-accepted` |
+| Auto, profil pertama disabotase saat handshake (DARWIN → 428 sebelum QR) | `identity-changed` → `macos-safari` pada 0,9 s; reconnect 1 s; pairing diakui pada 2,5 s |
+| Auto, profil pertama disabotase saat pairing (display tak valid → 400) | `identity-changed` pada 1,2 s; socket ditutup & disambung ulang dengan identitas baru; pairing diakui pada 3,2 s |
+| Auto, restart proses setelah rotasi | identitas tersimpan (`macos-safari`) dilanjutkan (`source: auto+saved`), tidak mulai lagi dari `macos-chrome` |
+| Kustom `archLinux:Chrome` | dipakai apa adanya; nama HP `Chrome (Arch Linux)`, display pairing `Chrome (Linux)`; pairing diakui |
+| Kustom yang ditolak server (`Mac OS/Desktop` + DARWIN paksa) | **tidak** diganti: log error jelas, tidak ada `identity-changed`, reconnect biasa |
+
+Semua skenario di atas ada di `test/identity-live.test.js` (10 test live) dan logikanya di `test/device-identity.test.js`
+(12 test offline). Total suite: 59 test (49 lulus, 10 live di-skip tanpa `BIBZ_LIVE=1`) di Node 20.20 / 22.23 / 24.20 / 26.8.
+
+Aturan yang dipilih dan alasannya:
+- Rotasi hanya pada sinyal **penolakan identitas** (428 sebelum QR, 400 pairing, 405). 401/408/429/515 bukan alasan ganti
+  identitas — mengganti identitas saat rate-limit hanya memperburuk.
+- Rotasi hanya sebelum perangkat terdaftar. Setelah terdaftar, identitas dikunci (mengubahnya = perangkat "lain" di HP).
+- Wipe sesi (401/500/411) **mempertahankan** `identity.json` bila alasannya `qr-received|pairing-accepted|open`.
+- Mode kustom tidak pernah dirotasi: pilihan pemakai adalah kontrak; library hanya memberi peringatan (`lintIdentity`) dan
+  error yang menyebut penyebabnya.
+
+## 7. Verifikasi kesiapan produksi & rilis npm `@xbibzlibrary/whatsbibz` 1.3.0
+
+| Pemeriksaan | Hasil |
+|---|---|
+| Sintaks semua berkas `lib/**` (Node 20) | 0 error |
+| Suite offline (`npm test`) | 54 lulus / 0 gagal (11 live di-skip) di Node 20.20, 22.23, 24.20, 26.8 |
+| Suite live (`BIBZ_LIVE=1`) | 11/11 — QR, pairing, auto-rotasi 428 & 400, kustom, kontrol negatif, ketahanan putus jaringan |
+| Kebocoran siklus hidup | 40× create→close offline + 3× live: resource aktif tersisa hanya stdio, proses keluar sendiri |
+| TypeScript konsumen (`tsc --strict`, `skipLibCheck:false`, NodeNext) | 0 error; kontrol negatif (tipe salah) ditolak 5 error |
+| `npm pack` → install di proyek kosong | ESM, CJS (`import()`), subpath `lib/*` & `package.json`, `fetchLatestWaWebVersion()` OK |
+| `npm audit --omit=dev` | 0 kerentanan |
+| Isi tarball | 5,3 MB / 21,8 MB terbuka / 260 berkas; tanpa test/example/scripts/harness/sesi |
+| Integrasi bot (`tests/bibzwhats-integration.test.js`) | 6/6 |
+
+Temuan yang diperbaiki sebelum publish: timer reconnect bocor setelah `close()`; 401 "pairing tertunda" setelah putus jaringan
+diperlakukan sebagai kegagalan nomor; `WAProto/index.d.ts` kosong dari upstream (TS tidak bisa kompilasi); `.d.ts` bergantung
+deklarasi `whatsapp-rust-bridge` yang rusak.

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