@oxidezap/baileyrs 0.0.26 → 0.0.28

package/README.md

@@ -27,8 +27,17 @@ so existing integrations can migrate with minimal changes. See
 | Key management | JS auth state | Rust `PersistenceManager` |
 | Auto-reconnect | Manual `startSock()` loop | Built-in with fibonacci backoff |
 
+## Documentation
+
+The full API reference and guides live in the
+**[baileyrs wiki](https://deepwiki.com/oxidezap/baileyrs)** — sending messages and
+media, groups, privacy, newsletters, custom stores, socket configuration,
+error handling, memory monitoring, and more.
+
 ## Installation
 
+Requires Node.js 22 or newer.
+
 ### New project
 
 ```sh
@@ -42,27 +51,26 @@ import makeWASocket from '@oxidezap/baileyrs'
 ### Drop-in replacement for upstream Baileys
 
 baileyrs is API-compatible with [@whiskeysockets/baileys](https://github.com/WhiskeySockets/Baileys).
-Existing projects switch over by aliasing the package — **no source changes needed**:
+Existing projects switch over by aliasing the package — **no source changes needed**
+(one exception: carrying an existing pairing across takes a one-line import swap,
+see [Migrating from Upstream Baileys](#migrating-from-upstream-baileys)):
 
 ```sh
 npm install @whiskeysockets/baileys@npm:@oxidezap/baileyrs
 ```
 
-That writes the alias to your `package.json`:
+That writes the alias to your `package.json` (with the latest version at install time):
 
 ```jsonc
 {
   "dependencies": {
-    "@whiskeysockets/baileys": "npm:@oxidezap/baileyrs@^0.0.8"
+    "@whiskeysockets/baileys": "npm:@oxidezap/baileyrs@^x.x.x"
   }
 }
 ```
 
 Every `import { makeWASocket } from '@whiskeysockets/baileys'` in your codebase
-now resolves to baileyrs. Auth state, event listeners, and message APIs work
-unchanged — see [Migrating from Upstream Baileys](#migrating-from-upstream-baileys)
-for what happens behind the scenes and the (very small) surface where behavior
-differs.
+now resolves to baileyrs.
 
 ## Quick Start
 
@@ -90,101 +98,11 @@ sock.ev.on('messages.upsert', ({ messages }) => {
         console.log('received message', msg.key.id)
     }
 })
-```
-
-## Error Handling
-
-baileyrs ships its own `Boom` error class, API-compatible with
-[`@hapi/boom`](https://github.com/hapijs/boom) — no extra dependency needed.
-Methods that fail (including `sendMessage`, media uploads, and connection errors)
-throw a `Boom` with a `statusCode` aligned to WhatsApp disconnect reasons.
-
-```ts
-import { Boom } from '@oxidezap/baileyrs'
-
-try {
-    await sock.sendMessage(jid, { text: 'hi' })
-} catch (err) {
-    if (Boom.isBoom(err)) {
-        console.log(err.statusCode)          // fast path
-        console.log(err.output.statusCode)   // @hapi/boom-compatible
-        console.log(err.data)                // optional user payload
-    }
-}
-```
-
-If you have existing code importing `Boom` from `@hapi/boom`, the
-`(err as Boom)?.output?.statusCode` pattern continues to work via structural
-typing — only the underlying dependency changed.
-
-## Connecting
-
-### QR Code
-
-```ts
-const sock = makeWASocket({
-    auth: state,
-    browser: Browsers.ubuntu('My App')
-})
-```
-
-A QR code will be emitted via `connection.update` events. Scan it with your phone.
-
-### Pairing Code
-
-```ts
-const sock = makeWASocket({ auth: state })
 
-if (!sock.isLoggedIn) {
-    const code = await sock.requestPairingCode('5511999999999')
-    console.log('Pairing code:', code)
-}
+await sock.sendMessage('1234567890@s.whatsapp.net', { text: 'Hello!' })
 ```
 
-## Auth State
-
-All state — crypto keys, Signal sessions, device identity, and push name — is managed and persisted by the Rust bridge. No `creds.json`, no `saveCreds` callback.
-
-```ts
-import { useMultiFileAuthState } from '@oxidezap/baileyrs'
-
-const { state } = await useMultiFileAuthState('auth_folder')
-const sock = makeWASocket({ auth: state })
-```
-
-Files created in `auth_folder/`:
-- `device-*.bin` — Rust device state (noise keys, identity, push name, etc.)
-- `session-*.bin` — Signal sessions
-- `identity-*.bin` — Signal identity keys
-- `pre-key-*.bin` — Signal pre-keys
-- `sender-key-*.bin` — Group sender keys
-
-### Custom Store (Native)
-
-For new deployments, implement `JsStoreCallbacks` directly — a flat binary key-value store. The Rust bridge handles all serialization internally.
-
-```ts
-import makeWASocket from '@oxidezap/baileyrs'
-
-const store = {
-  async get(store: string, key: string): Promise<Uint8Array | null> {
-    // read from your DB: SELECT value FROM wa_store WHERE store=? AND key=?
-  },
-  async set(store: string, key: string, value: Uint8Array): Promise<void> {
-    // upsert to your DB: INSERT ... ON DUPLICATE KEY UPDATE
-  },
-  async delete(store: string, key: string): Promise<void> {
-    // delete from your DB: DELETE FROM wa_store WHERE store=? AND key=?
-  },
-  async flush(): Promise<void> { /* flush pending writes if you batch */ }
-}
-
-const sock = makeWASocket({ auth: { store } })
-```
-
-No creds management, no type routing — just `(store, key) → bytes`. Works with any backend (MySQL, Redis, S3, etc.).
-
-### Migrating from Upstream Baileys
+## Migrating from Upstream Baileys
 
 baileyrs accepts the upstream `auth: { creds, keys }` shape directly — the
 internal `wrapLegacyStore` adapter runs automatically when it sees that
@@ -217,22 +135,24 @@ Same approach works for any custom upstream auth (`useMySQLAuthState`,
 `useRedisAuthState`, mysql-baileys, etc.) — your loader keeps returning
 `{creds, keys, saveCreds}`, baileyrs auto-wraps it on the way in.
 
-#### Existing sessions migrate without re-pairing
-
-`useLegacyMultiFileAuthState` reads the existing `creds.json` +
-`pre-key-*.json` / `session-*.json` files from the same folder upstream
-Baileys was using and hands them to the Rust engine. Pair-ID, identity,
-signed pre-keys, and Signal sessions are all preserved. No QR re-scan,
-no logged-out events.
+Existing sessions migrate without re-pairing: `useLegacyMultiFileAuthState`
+reads the existing `creds.json` + `pre-key-*.json` / `session-*.json` files
+from the same folder upstream Baileys was using and hands them to the Rust
+engine. Pair-ID, identity, signed pre-keys, and Signal sessions are all
+preserved. No QR re-scan, no logged-out events.
 
 > **Where the new state goes**: baileyrs continues to write the legacy
 > JSON files (via `saveCreds`) so the folder stays compatible with both
 > sides during a rollback window. The Rust engine treats the JSON as the
 > source of truth as long as you keep using `useLegacyMultiFileAuthState`.
+> One edge case: a Signal session imported while it still had pending
+> out-of-order message gaps becomes native-only on its first write-back —
+> after a rollback, that one session re-establishes itself through a fresh
+> Signal handshake (automatic; no re-pairing, other sessions unaffected).
 > If you later want to drop the JSON layer, switch to
 > `useMultiFileAuthState` — but that path requires a fresh QR.
 
-#### Gotchas
+### Gotchas
 
 A few behaviors that differ from upstream — almost always to your advantage:
 
@@ -243,359 +163,10 @@ A few behaviors that differ from upstream — almost always to your advantage:
   side caches group metadata and message keys natively. You can still pass
   them — they're respected as overrides — but they're optional.
 - **`Boom` ships in the box.** baileyrs exports its own
-  `@hapi/boom`-compatible `Boom` (see [Error Handling](#error-handling))
-  so the existing `(err as Boom).output.statusCode` pattern works
-  unchanged. If your `package.json` was pulling `@hapi/boom` only for
-  baileys, you can drop the dependency.
-
-#### Manual `wrapLegacyStore` (advanced)
-
-If you want explicit control over when the adapter runs (testing, custom
-shapes, mixed storage), call it yourself:
-
-```ts
-import makeWASocket, { useLegacyMultiFileAuthState, wrapLegacyStore } from '@oxidezap/baileyrs'
-
-const { state, saveCreds } = await useLegacyMultiFileAuthState('/path/to/baileys_auth_info')
-const store = await wrapLegacyStore(state, saveCreds)
-const sock = makeWASocket({ auth: { store } })
-```
-
-## Sending Messages
-
-```ts
-// Text
-await sock.sendMessage(jid, { text: 'Hello!' })
-
-// Quote
-await sock.sendMessage(jid, { text: 'Reply' }, { quoted: msg })
-
-// Mention
-await sock.sendMessage(jid, {
-    text: '@12345678901',
-    mentions: ['12345678901@s.whatsapp.net']
-})
-
-// Forward
-await sock.sendMessage(jid, { forward: msg })
-
-// Location
-await sock.sendMessage(jid, {
-    location: { degreesLatitude: 24.12, degreesLongitude: 55.11 }
-})
-
-// Contact
-await sock.sendMessage(jid, {
-    contacts: {
-        displayName: 'Jeff',
-        contacts: [{ vcard: 'BEGIN:VCARD\nVERSION:3.0\nFN:Jeff\nEND:VCARD' }]
-    }
-})
-
-// Reaction
-await sock.sendMessage(jid, { react: { text: '💖', key: msg.key } })
-
-// Poll
-await sock.sendMessage(jid, {
-    poll: { name: 'My Poll', values: ['Yes', 'No'], selectableCount: 1 }
-})
-
-// Delete (for everyone)
-await sock.sendMessage(jid, { delete: msg.key })
-
-// Edit
-await sock.sendMessage(jid, { text: 'updated text', edit: msg.key })
-
-// Disappearing messages
-await sock.sendMessage(jid, { disappearingMessagesInChat: 604800 }) // 7 days
-```
-
-### Media Messages
-
-Media encryption, upload, and CDN failover are handled entirely by the Rust bridge.
-
-```ts
-// Image
-await sock.sendMessage(jid, { image: readFileSync('photo.jpg'), caption: 'Hello' })
-
-// Video
-await sock.sendMessage(jid, { video: { url: './clip.mp4' }, caption: 'Watch this' })
-
-// Audio
-await sock.sendMessage(jid, { audio: { url: './audio.ogg' }, mimetype: 'audio/ogg; codecs=opus' })
-
-// Document
-await sock.sendMessage(jid, {
-    document: { url: './file.pdf' },
-    mimetype: 'application/pdf',
-    fileName: 'report.pdf'
-})
-
-// View once
-await sock.sendMessage(jid, { image: { url: './photo.jpg' }, viewOnce: true })
-
-// GIF (mp4 with gifPlayback)
-await sock.sendMessage(jid, { video: readFileSync('anim.mp4'), gifPlayback: true })
-```
-
-> Thumbnails are auto-generated for images (requires `jimp` or `sharp`). Video thumbnails need `ffmpeg` on your system, or provide `jpegThumbnail` directly.
-
-#### Streaming Upload (Large Files)
-
-For files that are too large to buffer in memory, pass a `processMedia` hook to `sendMessage`:
-
-```ts
-await sock.sendMessage(jid, { video: readFileSync('large-video.mp4') }, {
-    processMedia: async (buffer, mediaType, waClient) => {
-        const { Writable } = await import('node:stream')
-        const fs = await import('node:fs')
-        const os = await import('node:os')
-        const path = await import('node:path')
-
-        const tmpEnc = path.join(os.tmpdir(), `enc-${Date.now()}`)
-
-        // Streaming encrypt → temp file (constant ~40KB memory)
-        const input = new Blob([new Uint8Array(buffer)]).stream()
-        const output = Writable.toWeb(fs.createWriteStream(tmpEnc))
-        const enc = await waClient.encryptMediaStream(input, output, mediaType)
-
-        // Upload from temp file
-        const encData = await fs.promises.readFile(tmpEnc)
-        await fs.promises.unlink(tmpEnc)
-
-        const upload = await waClient.uploadEncryptedMediaStream(
-            () => new Blob([new Uint8Array(encData)]).stream(),
-            enc.mediaKey, enc.fileSha256, enc.fileEncSha256, enc.fileLength, mediaType
-        )
-
-        return { upload: { ...upload, ...enc } }
-    }
-})
-```
-
-### Downloading Media
-
-The recommended way to download media is via the socket method — it handles CDN failover, auth refresh, HMAC verification, and media re-upload automatically:
-
-```ts
-// Buffer (recommended)
-const buffer = await sock.downloadMedia(msg, 'buffer')
-await writeFile('photo.jpg', buffer)
-
-// Stream
-const stream = await sock.downloadMedia(msg, 'stream')
-for await (const chunk of stream) {
-    // process chunk — only ~64KB in memory at a time
-}
-```
-
-<details>
-<summary>Advanced: standalone utility (for use without a socket)</summary>
-
-If you need to download media outside of a socket context (e.g., custom logger or reupload logic), use the standalone `downloadMediaMessage` utility:
-
-```ts
-import { downloadMediaMessage } from '@oxidezap/baileyrs'
-
-const buffer = await downloadMediaMessage(msg, 'buffer', {}, {
-    logger: sock.logger,
-    reuploadRequest: m => sock.updateMediaMessage(m),
-    waClient: sock.waClient!
-})
-```
-
-</details>
-
-### Re-upload Expired Media
-```ts
-await sock.updateMediaMessage(msg)
-```
-
-## Read Receipts
-
-```ts
-await sock.readMessages([{ remoteJid: msg.key.remoteJid!, id: msg.key.id! }])
-```
-
-## Presence
-
-```ts
-// Online/offline
-await sock.sendPresenceUpdate('available')
-await sock.sendPresenceUpdate('unavailable')
-
-// Subscribe to a contact's presence
-await sock.presenceSubscribe(jid)
-
-// Typing indicator
-await sock.sendChatState(jid, 'composing')
-await sock.sendChatState(jid, 'paused')
-```
-
-## Chat Actions
-
-```ts
-await sock.pinChat(jid, true)
-await sock.muteChat(jid, 8 * 60 * 60 * 1000) // mute 8h
-await sock.muteChat(jid, null)                 // unmute
-await sock.archiveChat(jid, true)
-await sock.starMessage(jid, msgId, true)
-```
-
-## Reject Calls
-
-```ts
-await sock.rejectCall(callId, callFrom)
-```
-
-## User Queries
-
-```ts
-// Check if on WhatsApp
-const [result] = await sock.onWhatsApp('+1234567890')
-if (result.exists) console.log('JID:', result.jid)
-
-// Fetch status
-const status = await sock.fetchStatus(jid)
-
-// Profile picture
-const url = await sock.profilePictureUrl(jid, 'image')
-
-// Business profile
-const profile = await sock.getBusinessProfile(jid)
-
-// On-demand history (messages arrive via messaging-history.set event)
-await sock.fetchMessageHistory(50, oldestMsg.key, oldestMsg.messageTimestamp)
-```
-
-## Profile
-
-```ts
-await sock.setPushName('My Name')
-await sock.updateProfileStatus('Hello World!')
-await sock.updateProfilePicture(jid, imageBytes)
-await sock.removeProfilePicture()
-```
-
-## Groups
-
-```ts
-// Create
-const group = await sock.groupCreate('Group Name', ['1234@s.whatsapp.net'])
-
-// Participants
-await sock.groupParticipantsUpdate(jid, ['1234@s.whatsapp.net'], 'add')    // or 'remove', 'promote', 'demote'
-
-// Metadata
-const metadata = await sock.groupMetadata(jid)
-const all = await sock.groupFetchAllParticipating()
-
-// Settings
-await sock.groupUpdateSubject(jid, 'New Name')
-await sock.groupUpdateDescription(jid, 'New Description')
-await sock.groupSettingUpdate(jid, 'announce', true)   // only admins send
-await sock.groupSettingUpdate(jid, 'locked', true)      // only admins edit settings
-await sock.groupToggleEphemeral(jid, 604800)            // 7 days
-await sock.groupMemberAddMode(jid, 'admin_add')         // or 'all_member_add'
-
-// Invite
-const code = await sock.groupInviteCode(jid)
-const newCode = await sock.groupRevokeInvite(jid)
-const response = await sock.groupAcceptInvite(code)
-const info = await sock.groupGetInviteInfo(code)
-
-// Join requests
-const requests = await sock.groupRequestParticipantsList(jid)
-await sock.groupRequestParticipantsUpdate(jid, ['1234@s.whatsapp.net'], 'approve')
-
-// Leave
-await sock.groupLeave(jid)
-```
-
-## Privacy
-
-```ts
-// Block/unblock
-await sock.updateBlockStatus(jid, 'block')
-await sock.updateBlockStatus(jid, 'unblock')
-
-// Fetch
-const settings = await sock.fetchPrivacySettings()
-const blocklist = await sock.fetchBlocklist()
-
-// Update privacy settings
-await sock.updateLastSeenPrivacy('contacts')        // 'all' | 'contacts' | 'contact_blacklist' | 'none'
-await sock.updateOnlinePrivacy('all')                // 'all' | 'match_last_seen'
-await sock.updateProfilePicturePrivacy('contacts')
-await sock.updateStatusPrivacy('contacts')
-await sock.updateReadReceiptsPrivacy('all')          // 'all' | 'none'
-await sock.updateGroupsAddPrivacy('contacts')
-await sock.updateDefaultDisappearingMode(604800)     // seconds, 0 to disable
-```
-
-## Newsletters (Channels)
-
-```ts
-const channel = await sock.newsletterCreate('My Channel', 'Description')
-const meta = await sock.newsletterMetadata(jid)
-await sock.newsletterSubscribe(jid)
-await sock.newsletterUnsubscribe(jid)
-```
-
-## Memory Monitoring
-
-```ts
-import { getWasmMemoryBytes } from 'whatsapp-rust-bridge'
-
-// WASM linear memory (total reserved)
-const wasmBytes = getWasmMemoryBytes()
-console.log(`WASM memory: ${(wasmBytes / 1024 / 1024).toFixed(1)} MB`)
-
-// Detailed cache/collection diagnostics from the Rust engine
-const diag = await sock.waClient!.getMemoryDiagnostics()
-console.log(diag) // { signalCacheSessions, groupCache, deviceCache, ... }
-```
-
-## Socket Config
-
-```ts
-const sock = makeWASocket({
-    // Required
-    auth: state,
-
-    // Connection
-    waWebSocketUrl: 'wss://web.whatsapp.com/ws/chat',
-    connectTimeoutMs: 20_000,
-    keepAliveIntervalMs: 30_000,
-
-    // Identity
-    version: [2, 3000, 1035194821],
-    browser: Browsers.macOS('Chrome'),
-
-    // Events
-    emitOwnEvents: true,
-    shouldIgnoreJid: jid => false,
-
-    // Proxy (for fetch/HTTP requests — uses undici dispatcher)
-    options: { dispatcher: undiciAgent },
-
-    // Cache (Rust-side, see CacheConfig type)
-    cache: { group: { ttlSecs: 7200 } },
-
-    // Optional override for the display identity sent at pairing.
-    // Orthogonal to `browser`. Only takes effect on the initial pairing.
-    deviceProps: { os: '...', platformType: 'CHROME' }
-})
-```
-
-## Relationship to Baileys
-
-baileyrs began as a fork of [WhiskeySockets/Baileys](https://github.com/WhiskeySockets/Baileys)
-but the internals have been rewritten from the ground up on top of
-[whatsapp-rust](https://github.com/oxidezap/whatsapp-rust). Only the public API shape
-is preserved, to make migration from Baileys straightforward.
-
-See [ATTRIBUTION.md](ATTRIBUTION.md) for the full attribution notice.
+  `@hapi/boom`-compatible `Boom`, so the existing
+  `(err as Boom).output.statusCode` pattern works unchanged. If your
+  `package.json` was pulling `@hapi/boom` only for baileys, you can drop
+  the dependency.
 
 ## Disclaimer
 

package/lib/Bridge/adapt.d.ts

@@ -10,6 +10,8 @@
 import type { WhatsAppEvent } from 'whatsapp-rust-bridge';
 import type { ILogger } from '../Utils/logger.js';
 import type { CanonicalEvent } from './types.js';
+import { adaptBridgeMessageWire } from './schema.js';
+export { adaptBridgeMessageWire };
 /**
  * Set of bridge event types the adapter explicitly handles. The
  * `dts-drift.test.ts` cross-checks this against the bridge's `.d.ts`

package/lib/Bridge/adapt.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"adapt.d.ts","sourceRoot":"","sources":["../../src/Bridge/adapt.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAA;AACzD,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAA;AACjD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAA;AAGhD;;;;;GAKG;AACH,eAAO,MAAM,wBAAwB,EAAE,WAAW,CAAC,MAAM,CAAqB,CAAA;AAE9E,uFAAuF;AACvF,eAAO,MAAM,gBAAgB,GAAI,OAAO,aAAa,EAAE,SAAS,OAAO,KAAG,cAAc,GAAG,IAClD,CAAA"}
+{"version":3,"file":"adapt.d.ts","sourceRoot":"","sources":["../../src/Bridge/adapt.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAA;AACzD,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAA;AACjD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAA;AAChD,OAAO,EAEN,sBAAsB,EAEtB,MAAM,aAAa,CAAA;AAEpB,OAAO,EAAE,sBAAsB,EAAE,CAAA;AAEjC;;;;;GAKG;AACH,eAAO,MAAM,wBAAwB,EAAE,WAAW,CAAC,MAAM,CAAqB,CAAA;AAE9E,uFAAuF;AACvF,eAAO,MAAM,gBAAgB,UAAW,aAAa,WAAW,OAAO,KAAG,cAAc,GAAG,IAClD,CAAA"}

package/lib/Bridge/adapt.js

@@ -7,7 +7,8 @@
  * (table-driven dispatch, additional validation, schema-derived types,
  * etc.) without rippling through call sites.
  */
-import { adaptBridgeEventViaSchema, KNOWN_BRIDGE_EVENT_TYPES as KNOWN_FROM_SCHEMA } from "./schema.js";
+import { adaptBridgeEventViaSchema, adaptBridgeMessageWire, KNOWN_BRIDGE_EVENT_TYPES as KNOWN_FROM_SCHEMA } from './schema.js';
+export { adaptBridgeMessageWire };
 /**
  * Set of bridge event types the adapter explicitly handles. The
  * `dts-drift.test.ts` cross-checks this against the bridge's `.d.ts`

package/lib/Bridge/adapt.js.map

@@ -1 +1 @@
-{"version":3,"file":"adapt.js","sourceRoot":"","sources":["../../src/Bridge/adapt.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAKH,OAAO,EAAE,yBAAyB,EAAE,wBAAwB,IAAI,iBAAiB,EAAE,MAAM,aAAa,CAAA;AAEtG;;;;;GAKG;AACH,MAAM,CAAC,MAAM,wBAAwB,GAAwB,iBAAiB,CAAA;AAE9E,uFAAuF;AACvF,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,KAAoB,EAAE,MAAgB,EAAyB,EAAE,CACjG,yBAAyB,CAAC,KAAK,EAAE,MAAM,CAAC,CAAA"}
+{"version":3,"file":"adapt.js","sourceRoot":"","sources":["../../src/Bridge/adapt.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAKH,OAAO,EACN,yBAAyB,EACzB,sBAAsB,EACtB,wBAAwB,IAAI,iBAAiB,EAC7C,MAAM,aAAa,CAAA;AAEpB,OAAO,EAAE,sBAAsB,EAAE,CAAA;AAEjC;;;;;GAKG;AACH,MAAM,CAAC,MAAM,wBAAwB,GAAwB,iBAAiB,CAAA;AAE9E,uFAAuF;AACvF,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,KAAoB,EAAE,MAAgB,EAAyB,EAAE,CACjG,yBAAyB,CAAC,KAAK,EAAE,MAAM,CAAC,CAAA"}

package/lib/Bridge/history-sync-wire.d.ts

@@ -0,0 +1,17 @@
+import { type HistorySyncWireBatch, type WhatsAppEvent } from 'whatsapp-rust-bridge';
+import type { ILogger } from '../Utils/logger.js';
+declare const HISTORY_SYNC_EVENT_TYPE: 'history_sync';
+export interface DecodedHistorySyncWireBatch {
+    event: Extract<WhatsAppEvent, {
+        type: typeof HISTORY_SYNC_EVENT_TYPE;
+    }>;
+    skippedConversations: number;
+}
+/**
+ * Decode bridge-framed conversation protobufs directly into the JS objects
+ * consumed by baileyrs. The bridge owns only bounded inflate/framing; all
+ * Baileys-specific normalization remains on this side of the boundary.
+ */
+export declare const decodeHistorySyncWireBatch: (batch: HistorySyncWireBatch, logger: ILogger) => DecodedHistorySyncWireBatch;
+export {};
+//# sourceMappingURL=history-sync-wire.d.ts.map

package/lib/Bridge/history-sync-wire.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"history-sync-wire.d.ts","sourceRoot":"","sources":["../../src/Bridge/history-sync-wire.ts"],"names":[],"mappings":"AAAA,OAAO,EAAgB,KAAK,oBAAoB,EAAE,KAAK,aAAa,EAAE,MAAM,sBAAsB,CAAA;AAElG,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAA;AAIjD,QAAA,MAAM,uBAAuB,EAAG,cAAuB,CAAA;AAEvD,MAAM,WAAW,2BAA2B;IAC3C,KAAK,EAAE,OAAO,CAAC,aAAa,EAAE;QAAE,IAAI,EAAE,OAAO,uBAAuB,CAAA;KAAE,CAAC,CAAA;IACvE,oBAAoB,EAAE,MAAM,CAAA;CAC5B;AAED;;;;GAIG;AACH,eAAO,MAAM,0BAA0B,UAC/B,oBAAoB,UACnB,OAAO,KACb,2BAwDF,CAAA"}

package/lib/Bridge/history-sync-wire.js

@@ -0,0 +1,61 @@
+import { BinaryReader } from 'whatsapp-rust-bridge';
+import { proto as WAProto } from 'whatsapp-rust-bridge/proto-types';
+import { isConversationHistorySync } from '../Utils/process-history-message.js';
+import { createSparseArray } from '../Utils/sparse-array.js';
+const HISTORY_SYNC_EVENT_TYPE = 'history_sync';
+/**
+ * Decode bridge-framed conversation protobufs directly into the JS objects
+ * consumed by baileyrs. The bridge owns only bounded inflate/framing; all
+ * Baileys-specific normalization remains on this side of the boundary.
+ */
+export const decodeHistorySyncWireBatch = (batch, logger) => {
+    const wireData = batch.conversationData;
+    const wireOffsets = batch.conversationOffsets;
+    const shouldDecodeConversations = isConversationHistorySync(batch.syncType);
+    const conversationCount = Math.max(0, wireOffsets.length - 1);
+    const conversations = shouldDecodeConversations
+        ? createSparseArray(conversationCount)
+        : [];
+    let decodedConversations = 0;
+    let skippedConversations = 0;
+    if (shouldDecodeConversations) {
+        const reader = new BinaryReader(wireData);
+        for (let index = 0; index < conversationCount; index++) {
+            try {
+                const start = wireOffsets[index];
+                const end = wireOffsets[index + 1];
+                reader.pos = start;
+                const conversation = WAProto.Conversation.decode(reader, end - start);
+                conversations[decodedConversations++] = conversation;
+            }
+            catch (err) {
+                skippedConversations++;
+                logger.warn({ err, index }, 'skipping malformed history-sync conversation');
+            }
+        }
+    }
+    conversations.length = decodedConversations;
+    // The non-conversation remainder (pushnames, mappings, settings, ...)
+    // crosses as one encoded proto.HistorySync payload. The bridge's metadata
+    // envelope owns the canonical syncType/chunkOrder/progress values, so those
+    // (and the conversations decoded above) are dropped from the remainder
+    // instead of merged — that also keeps the proto side's `| null` field types
+    // out of the event contract.
+    const { conversationData: _wireData, conversationOffsets: _wireOffsets, remainderData, ...metadata } = batch;
+    let remainderFields = {};
+    if (remainderData && remainderData.length > 0) {
+        try {
+            const { syncType: _syncType, chunkOrder: _chunkOrder, progress: _progress, conversations: _conversations, ...rest } = WAProto.HistorySync.decode(remainderData);
+            remainderFields = rest;
+        }
+        catch (err) {
+            logger.warn({ err }, 'skipping undecodable history-sync remainder');
+        }
+    }
+    const data = { ...remainderFields, ...metadata, conversations };
+    return {
+        event: { type: HISTORY_SYNC_EVENT_TYPE, data },
+        skippedConversations
+    };
+};
+//# sourceMappingURL=history-sync-wire.js.map

package/lib/Bridge/history-sync-wire.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"history-sync-wire.js","sourceRoot":"","sources":["../../src/Bridge/history-sync-wire.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAiD,MAAM,sBAAsB,CAAA;AAClG,OAAO,EAAE,KAAK,IAAI,OAAO,EAAE,MAAM,kCAAkC,CAAA;AAEnE,OAAO,EAAE,yBAAyB,EAAE,MAAM,qCAAqC,CAAA;AAC/E,OAAO,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAA;AAE5D,MAAM,uBAAuB,GAAG,cAAuB,CAAA;AAOvD;;;;GAIG;AACH,MAAM,CAAC,MAAM,0BAA0B,GAAG,CACzC,KAA2B,EAC3B,MAAe,EACe,EAAE;IAChC,MAAM,QAAQ,GAAG,KAAK,CAAC,gBAAgB,CAAA;IACvC,MAAM,WAAW,GAAG,KAAK,CAAC,mBAAmB,CAAA;IAC7C,MAAM,yBAAyB,GAAG,yBAAyB,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAA;IAC3E,MAAM,iBAAiB,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,WAAW,CAAC,MAAM,GAAG,CAAC,CAAC,CAAA;IAC7D,MAAM,aAAa,GAAG,yBAAyB;QAC9C,CAAC,CAAC,iBAAiB,CAAiD,iBAAiB,CAAC;QACtF,CAAC,CAAC,EAAE,CAAA;IACL,IAAI,oBAAoB,GAAG,CAAC,CAAA;IAC5B,IAAI,oBAAoB,GAAG,CAAC,CAAA;IAE5B,IAAI,yBAAyB,EAAE,CAAC;QAC/B,MAAM,MAAM,GAAG,IAAI,YAAY,CAAC,QAAQ,CAAC,CAAA;QACzC,KAAK,IAAI,KAAK,GAAG,CAAC,EAAE,KAAK,GAAG,iBAAiB,EAAE,KAAK,EAAE,EAAE,CAAC;YACxD,IAAI,CAAC;gBACJ,MAAM,KAAK,GAAG,WAAW,CAAC,KAAK,CAAE,CAAA;gBACjC,MAAM,GAAG,GAAG,WAAW,CAAC,KAAK,GAAG,CAAC,CAAE,CAAA;gBACnC,MAAM,CAAC,GAAG,GAAG,KAAK,CAAA;gBAClB,MAAM,YAAY,GAAG,OAAO,CAAC,YAAY,CAAC,MAAM,CAAC,MAAM,EAAE,GAAG,GAAG,KAAK,CAAC,CAAA;gBACrE,aAAa,CAAC,oBAAoB,EAAE,CAAC,GAAG,YAAY,CAAA;YACrD,CAAC;YAAC,OAAO,GAAG,EAAE,CAAC;gBACd,oBAAoB,EAAE,CAAA;gBACtB,MAAM,CAAC,IAAI,CAAC,EAAE,GAAG,EAAE,KAAK,EAAE,EAAE,8CAA8C,CAAC,CAAA;YAC5E,CAAC;QACF,CAAC;IACF,CAAC;IACD,aAAa,CAAC,MAAM,GAAG,oBAAoB,CAAA;IAE3C,sEAAsE;IACtE,0EAA0E;IAC1E,4EAA4E;IAC5E,uEAAuE;IACvE,4EAA4E;IAC5E,6BAA6B;IAC7B,MAAM,EAAE,gBAAgB,EAAE,SAAS,EAAE,mBAAmB,EAAE,YAAY,EAAE,aAAa,EAAE,GAAG,QAAQ,EAAE,GAAG,KAAK,CAAA;IAC5G,IAAI,eAAe,GAClB,EAAE,CAAA;IACH,IAAI,aAAa,IAAI,aAAa,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC/C,IAAI,CAAC;YACJ,MAAM,EACL,QAAQ,EAAE,SAAS,EACnB,UAAU,EAAE,WAAW,EACvB,QAAQ,EAAE,SAAS,EACnB,aAAa,EAAE,cAAc,EAC7B,GAAG,IAAI,EACP,GAAG,OAAO,CAAC,WAAW,CAAC,MAAM,CAAC,aAAa,CAAC,CAAA;YAC7C,eAAe,GAAG,IAAI,CAAA;QACvB,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACd,MAAM,CAAC,IAAI,CAAC,EAAE,GAAG,EAAE,EAAE,6CAA6C,CAAC,CAAA;QACpE,CAAC;IACF,CAAC;IACD,MAAM,IAAI,GAAG,EAAE,GAAG,eAAe,EAAE,GAAG,QAAQ,EAAE,aAAa,EAAE,CAAA;IAC/D,OAAO;QACN,KAAK,EAAE,EAAE,IAAI,EAAE,uBAAuB,EAAE,IAAI,EAAE;QAC9C,oBAAoB;KACpB,CAAA;AACF,CAAC,CAAA"}

package/lib/Bridge/index.d.ts

@@ -6,7 +6,7 @@
  * exclusively — see `Socket/events.ts` for the bridge-canonical-Baileys
  * three-stage pipeline.
  */
-export { adaptBridgeEvent, KNOWN_BRIDGE_EVENT_TYPES } from './adapt.js';
+export { adaptBridgeEvent, adaptBridgeMessageWire, KNOWN_BRIDGE_EVENT_TYPES } from './adapt.js';
 export * from './types.js';
 export { asBool, asBoolOr, asJidString, asNumber, asString, bridgeJidToString, isBridgeJid, isObject, normalizeDiscriminator, toUnixSeconds } from './primitives.js';
 //# sourceMappingURL=index.d.ts.map