miaw-core 1.13.0 → 1.13.2

package/docs/BAILEYS_VS_MIAW_COMPARISON.md

@@ -1,545 +0,0 @@
-# Baileys vs Miaw Core - Comprehensive Feature Comparison
-
-**Last Updated:** September 2, 2026  
-**Baileys Version:** 7.0.0-rc14  
-**Miaw Core Version:** 1.12.0
-
-## Overview
-
-This document provides a comprehensive comparison between [Baileys](https://github.com/WhiskeySockets/Baileys) (the underlying WhatsApp Web API library) and Miaw Core (the simplified wrapper). The analysis covers all capabilities found in both libraries.
-
-### Key Differences
-
-| Aspect                 | Baileys                          | Miaw Core                             |
-| ---------------------- | -------------------------------- | ------------------------------------- |
-| **Complexity**         | Low-level, complex API           | Simplified, high-level API            |
-| **Learning Curve**     | Steep                            | Gentle                                |
-| **Message Format**     | Raw WhatsApp protobuf structures | Normalized `MiawMessage` format       |
-| **Session Management** | Manual setup required            | Automatic with `AuthHandler`          |
-| **Reconnection**       | Manual implementation            | Built-in auto-reconnect               |
-| **TypeScript**         | Partial types                    | Full type safety                      |
-| **Events**             | Many granular events             | Consolidated, simplified events       |
-| **Error Handling**     | Exceptions, Boom errors          | Structured `{success, error}` results |
-
----
-
-## Feature Comparison Tables
-
-### Legend
-
-| Symbol | Meaning               |
-| ------ | --------------------- |
-| ✅     | Fully implemented     |
-| 🔶     | Partially implemented |
-| ❌     | Not implemented       |
-| 🏗️     | Planned for future    |
-| N/A    | Not applicable        |
-
----
-
-## 1. Connection & Authentication
-
-| Feature                                  | Baileys | Miaw Core | Notes                                 |
-| ---------------------------------------- | ------- | --------- | ------------------------------------- |
-| **QR Code Authentication**               | ✅      | ✅        | Miaw emits `qr` event                 |
-| **Pairing Code (Phone Number)**          | ✅      | ✅        | `usePairingCode` + `phoneNumber` (v1.6.0) |
-| **Session Persistence (Multi-file)**     | ✅      | ✅        | `AuthHandler` manages automatically   |
-| **Session Persistence (Single-file)**    | ✅      | ❌        | Multi-file only in Miaw               |
-| **Session Persistence (External Store)** | ✅      | ❌        | Redis, MongoDB, etc.                  |
-| **Auto-Reconnection**                    | ❌      | ✅        | Manual in Baileys, built-in in Miaw   |
-| **Connection State Events**              | ✅      | ✅        | Simplified in Miaw                    |
-| **Logout/Disconnect**                    | ✅      | ✅        | `disconnect()` method                 |
-| **Clear Session**                        | ✅      | ✅        | `clearSession()` method               |
-| **Multiple Instances**                   | ✅      | ✅        | Full support in both                  |
-| **Browser Config**                       | ✅      | 🔶        | Fixed browser config in Miaw          |
-| **Custom Logger**                        | ✅      | ✅        | Pino-based in both                    |
-| **Proxy Support**                        | ✅      | ✅        | HTTP/SOCKS via the `proxy` option (v1.3.0) |
-| **Proxy Lists / Rotation**               | ❌      | ✅        | `ProxyRotator` + TXT/JSON proxy files (v1.10.0) |
-| **Proxy Diagnostics**                    | ❌      | ✅        | `miaw-cli proxy test` — no connection needed (v1.10.0) |
-| **Per-Instance Proxy Pins**              | ❌      | ✅        | `instance set-proxy` persists an assignment; `setProxy()` restages (v1.11.0) |
-| **WebSocket Options**                    | ✅      | ❌        | Custom WS configuration               |
-
----
-
-## 2. Sending Messages
-
-### 2.1 Text Messages
-
-| Feature                    | Baileys | Miaw Core | Notes                                  |
-| -------------------------- | ------- | --------- | -------------------------------------- |
-| **Send Text**              | ✅      | ✅        | `sendText()`                           |
-| **Send with Quote/Reply**  | ✅      | ✅        | `options.quoted`                       |
-| **Send with Mentions**     | ✅      | ✅        | `mentions` option (v1.6.0)             |
-| **Send with Link Preview** | ✅      | 🔶        | Auto-generated in Baileys              |
-| **Send Extended Text**     | ✅      | ❌        | Bold, italic, strikethrough, monospace |
-
-### 2.2 Media Messages
-
-| Feature                     | Baileys | Miaw Core | Notes                       |
-| --------------------------- | ------- | --------- | --------------------------- |
-| **Send Image**              | ✅      | ✅        | `sendImage()` with caption  |
-| **Send Video**              | ✅      | ✅        | `sendVideo()` with caption  |
-| **Send Audio**              | ✅      | ✅        | `sendAudio()`               |
-| **Send Voice Note (PTT)**   | ✅      | ✅        | `options.ptt: true`         |
-| **Send Video Note (PTV)**   | ✅      | ✅        | `options.ptv: true`         |
-| **Send Document**           | ✅      | ✅        | `sendDocument()`            |
-| **Send Sticker**            | ✅      | ✅        | `sendSticker()` (v1.6.0)    |
-| **Send GIF**                | ✅      | ✅        | `options.gifPlayback: true` |
-| **View Once (Image/Video)** | ✅      | ✅        | `options.viewOnce: true`    |
-| **Media from URL**          | ✅      | ✅        | Pass URL string             |
-| **Media from Buffer**       | ✅      | ✅        | Pass Buffer                 |
-| **Media from Stream**       | ✅      | ❌        | Readable stream             |
-| **Custom Thumbnail**        | ✅      | ❌        | `jpegThumbnail` option      |
-
-### 2.3 Special Messages
-
-| Feature                    | Baileys | Miaw Core | Notes                                  |
-| -------------------------- | ------- | --------- | -------------------------------------- |
-| **Send Location**          | ✅      | ✅        | `sendLocation()` (v1.6.0)              |
-| **Send Live Location**     | ✅      | ❌        | Live location sharing                  |
-| **Send Contact (vCard)**   | ✅      | ✅        | `sendContact()` (v1.6.0)               |
-| **Send Multiple Contacts** | ✅      | ✅        | `sendContact()` array (v1.6.0)         |
-| **Send Poll**              | ✅      | ✅        | `sendPoll()` (v1.6.0)                  |
-| **Send Product**           | ✅      | ❌        | Product message                        |
-| **Send Event**             | ✅      | ❌        | Event/calendar messages                |
-| **Send Group Invite**      | ✅      | ✅        | `sendGroupInvite()` (v1.12.0)          |
-| **Send Buttons**           | ✅      | ❌        | Interactive buttons (deprecated by WA) |
-| **Send List**              | ✅      | ❌        | List messages (deprecated by WA)       |
-| **Send Template**          | ✅      | ❌        | Template messages (deprecated by WA)   |
-
-### 2.4 Message Operations
-
-| Feature                 | Baileys | Miaw Core | Notes                                 |
-| ----------------------- | ------- | --------- | ------------------------------------- |
-| **Forward Message**     | ✅      | ✅        | `forwardMessage()`                    |
-| **Edit Message**        | ✅      | ✅        | `editMessage()` (own messages, 15min) |
-| **Delete for Everyone** | ✅      | ✅        | `deleteMessage()`                     |
-| **Delete for Me**       | ✅      | ✅        | `deleteMessageForMe()`                |
-| **Send Reaction**       | ✅      | ✅        | `sendReaction()`                      |
-| **Remove Reaction**     | ✅      | ✅        | `removeReaction()`                    |
-| **Pin Message**         | ✅      | ✅        | `pinMessage()` / `unpinMessage()` (v1.12.0) |
-| **Star Message**        | ✅      | ✅        | `starMessage()` (v1.7.0)               |
-
----
-
-## 3. Receiving & Events
-
-### 3.1 Message Events
-
-| Feature                      | Baileys | Miaw Core | Notes                              |
-| ---------------------------- | ------- | --------- | ---------------------------------- |
-| **Receive Messages**         | ✅      | ✅        | `message` event with `MiawMessage` |
-| **Message Edit Event**       | ✅      | ✅        | `message_edit` event               |
-| **Message Delete Event**     | ✅      | ✅        | `message_delete` event             |
-| **Message Reaction Event**   | ✅      | ✅        | `message_reaction` event           |
-| **History Sync**             | ✅      | 🔶        | Chats/contacts synced to stores    |
-| **Poll Updates**             | ✅      | ✅        | `poll_vote` event (v1.6.0)         |
-| **Receipt Events**           | ✅      | ✅        | `message_receipt` event (v1.9.1)   |
-| **Call Events**              | ✅      | ✅        | `call` event (v1.12.0)             |
-| **Label Association Events** | ✅      | ❌        | Label add/remove events            |
-
-### 3.2 Connection Events
-
-| Feature                | Baileys | Miaw Core | Notes                 |
-| ---------------------- | ------- | --------- | --------------------- |
-| **Connection Update**  | ✅      | ✅        | `connection` event    |
-| **QR Event**           | ✅      | ✅        | `qr` event            |
-| **Ready Event**        | ✅      | ✅        | `ready` event         |
-| **Disconnected Event** | ✅      | ✅        | `disconnected` event  |
-| **Reconnecting Event** | N/A     | ✅        | Miaw-specific         |
-| **Credentials Update** | ✅      | ✅        | `session_saved` event |
-| **Error Event**        | ✅      | ✅        | `error` event         |
-
-### 3.3 Presence Events
-
-| Feature                | Baileys | Miaw Core | Notes                                                |
-| ---------------------- | ------- | --------- | ---------------------------------------------------- |
-| **Presence Update**    | ✅      | ✅        | `presence` event                                     |
-| **Subscribe Presence** | ✅      | ✅        | `subscribePresence()`                                |
-| **Presence Types**     | ✅      | ✅        | available, unavailable, composing, recording, paused |
-
----
-
-## 4. Media Download & Processing
-
-| Feature                     | Baileys | Miaw Core | Notes                             |
-| --------------------------- | ------- | --------- | --------------------------------- |
-| **Download Media**          | ✅      | ✅        | `downloadMedia()`                 |
-| **Re-upload Expired Media** | ✅      | ✅        | Auto-handled in `downloadMedia()` |
-| **Generate Thumbnail**      | ✅      | ❌        | Auto-generate thumbnails          |
-| **Get Media Stream**        | ✅      | ❌        | Stream instead of buffer          |
-
----
-
-## 5. Chat Management
-
-| Feature                   | Baileys | Miaw Core | Notes                     |
-| ------------------------- | ------- | --------- | ------------------------- |
-| **Mark as Read**          | ✅      | ✅        | `markAsRead()`            |
-| **Send Typing**           | ✅      | ✅        | `sendTyping()`            |
-| **Send Recording**        | ✅      | ✅        | `sendRecording()`         |
-| **Stop Typing**           | ✅      | ✅        | `stopTyping()`            |
-| **Set Presence**          | ✅      | ✅        | `setPresence()`           |
-| **Archive Chat**          | ✅      | ✅        | `archiveChat()` (v1.7.0)  |
-| **Mute Chat**             | ✅      | ✅        | `muteChat()` (v1.7.0)     |
-| **Pin Chat**              | ✅      | ✅        | `pinChat()` (v1.7.0)      |
-| **Delete Chat**           | ✅      | ✅        | `deleteChat()` (v1.7.0)   |
-| **Clear Chat**            | ✅      | ✅        | `clearChat()` (v1.7.0)    |
-| **Disappearing Messages** | ✅      | ✅        | `setChatEphemeral()`, `setGroupEphemeral()`, `setCommunityEphemeral()` (v1.12.0) |
-| **Fetch Message History** | ✅      | ✅        | `loadMoreMessages()`      |
-| **Chat Modify**           | ✅      | ✅        | Exposed via chat ops (v1.7.0) |
-| **Mark Chat Read/Unread** | ✅      | ✅        | `markChatRead()` (v1.7.0) |
-
----
-
-## 6. User & Contact Operations
-
-| Feature                      | Baileys | Miaw Core | Notes                             |
-| ---------------------------- | ------- | --------- | --------------------------------- |
-| **Check Number on WhatsApp** | ✅      | ✅        | `checkNumber()`, `checkNumbers()` |
-| **Get Contact Info**         | ✅      | ✅        | `getContactInfo()`                |
-| **Get Profile Picture**      | ✅      | ✅        | `getProfilePicture()`             |
-| **Fetch Status/About**       | ✅      | ✅        | In `getContactInfo()`             |
-| **Get Business Profile**     | ✅      | ✅        | `getBusinessProfile()`            |
-| **Add/Edit Contact**         | ✅      | ✅        | `addOrEditContact()`              |
-| **Remove Contact**           | ✅      | ✅        | `removeContact()`                 |
-| **Block User**               | ✅      | ✅        | `blockContact()` / `unblockContact()` (v1.12.0) |
-| **Get Blocklist**            | ✅      | ✅        | `getBlocklist()`, `isBlocked()` (v1.12.0) |
-| **Fetch All Contacts**       | ✅      | ✅        | `fetchAllContacts()`              |
-
----
-
-## 7. Profile Management
-
-| Feature                    | Baileys | Miaw Core | Notes                    |
-| -------------------------- | ------- | --------- | ------------------------ |
-| **Update Profile Picture** | ✅      | ✅        | `updateProfilePicture()` |
-| **Remove Profile Picture** | ✅      | ✅        | `removeProfilePicture()` |
-| **Update Profile Name**    | ✅      | ✅        | `updateProfileName()`    |
-| **Update Profile Status**  | ✅      | ✅        | `updateProfileStatus()`  |
-| **Get Own Profile**        | ✅      | ✅        | `getOwnProfile()`        |
-
----
-
-## 8. Group Management
-
-### 8.1 Group Operations
-
-| Feature                    | Baileys | Miaw Core | Notes                    |
-| -------------------------- | ------- | --------- | ------------------------ |
-| **Create Group**           | ✅      | ✅        | `createGroup()`          |
-| **Leave Group**            | ✅      | ✅        | `leaveGroup()`           |
-| **Get Group Info**         | ✅      | ✅        | `getGroupInfo()`         |
-| **Get Group Participants** | ✅      | ✅        | `getGroupParticipants()` |
-| **Fetch All Groups**       | ✅      | ✅        | `fetchAllGroups()`       |
-
-### 8.2 Group Participants
-
-| Feature                 | Baileys | Miaw Core | Notes                  |
-| ----------------------- | ------- | --------- | ---------------------- |
-| **Add Participants**    | ✅      | ✅        | `addParticipants()`    |
-| **Remove Participants** | ✅      | ✅        | `removeParticipants()` |
-| **Promote to Admin**    | ✅      | ✅        | `promoteToAdmin()`     |
-| **Demote from Admin**   | ✅      | ✅        | `demoteFromAdmin()`    |
-| **Get Join Requests**   | ✅      | ✅        | `getGroupJoinRequests()` / community (v1.12.0) |
-| **Approve/Reject Join** | ✅      | ✅        | `approve*` / `reject*JoinRequests()` (v1.12.0) |
-
-### 8.3 Group Settings
-
-| Feature                      | Baileys | Miaw Core | Notes                      |
-| ---------------------------- | ------- | --------- | -------------------------- |
-| **Update Group Name**        | ✅      | ✅        | `updateGroupName()`        |
-| **Update Group Description** | ✅      | ✅        | `updateGroupDescription()` |
-| **Update Group Picture**     | ✅      | ✅        | `updateGroupPicture()`     |
-| **Announcement Mode**        | ✅      | ✅        | `setGroupAnnounceOnly()` (v1.12.0) |
-| **Restrict Mode**            | ✅      | ✅        | `setGroupRestrictInfo()` (v1.12.0) |
-| **Member Add Mode**          | ✅      | ✅        | `setGroupMemberAddMode()` (v1.12.0) |
-| **Ephemeral Mode**           | ✅      | ✅        | `setGroupEphemeral()` (v1.12.0) |
-
-### 8.4 Group Invites
-
-| Feature                     | Baileys | Miaw Core | Notes                      |
-| --------------------------- | ------- | --------- | -------------------------- |
-| **Get Invite Link**         | ✅      | ✅        | `getGroupInviteLink()`     |
-| **Revoke Invite Link**      | ✅      | ✅        | `revokeGroupInvite()`      |
-| **Accept Invite**           | ✅      | ✅        | `acceptGroupInvite()`      |
-| **Get Invite Info**         | ✅      | ✅        | `getGroupInviteInfo()`     |
-| **Join via Invite Message** | ✅      | ❌        | Join from received message |
-
----
-
-## 9. Business Features (WhatsApp Business)
-
-### 9.1 Labels
-
-| Feature                       | Baileys | Miaw Core | Notes                  |
-| ----------------------------- | ------- | --------- | ---------------------- |
-| **Add/Edit Label**            | ✅      | ✅        | `addLabel()`           |
-| **Fetch All Labels**          | ✅      | ✅        | `fetchAllLabels()`     |
-| **Add Label to Chat**         | ✅      | ✅        | `addChatLabel()`       |
-| **Remove Label from Chat**    | ✅      | ✅        | `removeChatLabel()`    |
-| **Add Label to Message**      | ✅      | ✅        | `addMessageLabel()`    |
-| **Remove Label from Message** | ✅      | ✅        | `removeMessageLabel()` |
-
-### 9.2 Catalog & Products
-
-| Feature               | Baileys | Miaw Core | Notes              |
-| --------------------- | ------- | --------- | ------------------ |
-| **Get Catalog**       | ✅      | ✅        | `getCatalog()`     |
-| **Get Collections**   | ✅      | ✅        | `getCollections()` |
-| **Create Product**    | ✅      | ✅        | `createProduct()`  |
-| **Update Product**    | ✅      | ✅        | `updateProduct()`  |
-| **Delete Products**   | ✅      | ✅        | `deleteProducts()` |
-| **Get Order Details** | ✅      | ✅        | `getOrderDetails()` (v1.8.0) |
-
-### 9.3 Business Profile
-
-| Feature                     | Baileys | Miaw Core | Notes                       |
-| --------------------------- | ------- | --------- | --------------------------- |
-| **Get Business Profile**    | ✅      | ✅        | `getBusinessProfile()`      |
-| **Update Business Profile** | ✅      | ✅        | `updateBusinessProfile()` (v1.8.0) |
-| **Update Cover Photo**      | ✅      | ✅        | `updateCoverPhoto()` (v1.8.0) |
-| **Remove Cover Photo**      | ✅      | ✅        | `removeCoverPhoto()` (v1.8.0) |
-
-### 9.4 Quick Replies (Business)
-
-| Feature                | Baileys | Miaw Core | Notes              |
-| ---------------------- | ------- | --------- | ------------------ |
-| **Add Quick Reply**    | ✅      | ✅        | `addQuickReply()` (v1.8.0) |
-| **Remove Quick Reply** | ✅      | ✅        | `removeQuickReply()` (v1.8.0) |
-
----
-
-## 10. Newsletter/Channel Features
-
-| Feature                           | Baileys | Miaw Core | Notes                           |
-| --------------------------------- | ------- | --------- | ------------------------------- |
-| **Create Newsletter**             | ✅      | ✅        | `createNewsletter()`            |
-| **Delete Newsletter**             | ✅      | ✅        | `deleteNewsletter()`            |
-| **Get Newsletter Metadata**       | ✅      | ✅        | `getNewsletterMetadata()`       |
-| **Follow Newsletter**             | ✅      | ✅        | `followNewsletter()`            |
-| **Unfollow Newsletter**           | ✅      | ✅        | `unfollowNewsletter()`          |
-| **Mute Newsletter**               | ✅      | ✅        | `muteNewsletter()`              |
-| **Unmute Newsletter**             | ✅      | ✅        | `unmuteNewsletter()`            |
-| **Update Newsletter Name**        | ✅      | ✅        | `updateNewsletterName()`        |
-| **Update Newsletter Description** | ✅      | ✅        | `updateNewsletterDescription()` |
-| **Update Newsletter Picture**     | ✅      | ✅        | `updateNewsletterPicture()`     |
-| **Remove Newsletter Picture**     | ✅      | ✅        | `removeNewsletterPicture()`     |
-| **Send Newsletter Message**       | ✅      | ✅        | `sendNewsletterMessage()`       |
-| **Send Newsletter Image**         | ✅      | ✅        | `sendNewsletterImage()`         |
-| **Send Newsletter Video**         | ✅      | ✅        | `sendNewsletterVideo()`         |
-| **React to Newsletter Message**   | ✅      | ✅        | `reactToNewsletterMessage()`    |
-| **Fetch Newsletter Messages**     | ✅      | ✅        | `fetchNewsletterMessages()`     |
-| **Subscribe Newsletter Updates**  | ✅      | ✅        | `subscribeNewsletterUpdates()`  |
-| **Get Newsletter Subscribers**    | ✅      | ✅        | `getNewsletterSubscribers()`    |
-| **Get Newsletter Admin Count**    | ✅      | ✅        | `getNewsletterAdminCount()`     |
-| **Change Newsletter Owner**       | ✅      | ✅        | `changeNewsletterOwner()`       |
-| **Demote Newsletter Admin**       | ✅      | ✅        | `demoteNewsletterAdmin()`       |
-
----
-
-## 11. Privacy Settings
-
-| Feature                              | Baileys | Miaw Core | Notes                |
-| ------------------------------------ | ------- | --------- | -------------------- |
-| **Get Privacy Settings**             | ✅      | ✅        | `getPrivacySettings()` (v1.12.0) |
-| **Update Last Seen Privacy**         | ✅      | ✅        | `setLastSeenPrivacy()` (v1.12.0) |
-| **Update Online Privacy**            | ✅      | ✅        | `setOnlinePrivacy()` (v1.12.0) |
-| **Update Profile Picture Privacy**   | ✅      | ✅        | `setProfilePicturePrivacy()` (v1.12.0) |
-| **Update Status Privacy**            | ✅      | ✅        | `setStatusPrivacy()` (v1.12.0) |
-| **Update Read Receipts Privacy**     | ✅      | ✅        | `setReadReceiptsPrivacy()` (v1.12.0) |
-| **Update Groups Add Privacy**        | ✅      | ✅        | `setGroupAddPrivacy()` (v1.12.0) |
-| **Update Messages Privacy**          | ✅      | ✅        | `setMessagesPrivacy()` (v1.12.0) |
-| **Update Call Privacy**              | ✅      | ✅        | `setCallPrivacy()` (v1.12.0) |
-| **Update Default Disappearing Mode** | ✅      | ✅        | `setDefaultDisappearingMode()` (v1.12.0) |
-| **Disable Link Previews**            | ✅      | ✅        | `setLinkPreviewsDisabled()` (v1.12.0) |
-
----
-
-## 12. Status/Stories & Broadcasts
-
-| Feature                        | Baileys | Miaw Core | Notes                     |
-| ------------------------------ | ------- | --------- | ------------------------- |
-| **Send Status/Story**          | ✅      | ✅        | `postTextStatus()` etc. (v1.8.0) |
-| **Delete Status**              | ✅      | ❌        | Delete status post        |
-| **Send Broadcast**             | ✅      | ❌        | Send to broadcast list    |
-| **Query Broadcast Recipients** | ✅      | ❌        | List broadcast recipients |
-
----
-
-## 13. Communities
-
-| Feature                        | Baileys | Miaw Core | Notes                   |
-| ------------------------------ | ------- | --------- | ----------------------- |
-| **Get Community Metadata**     | ✅      | ✅        | `getCommunityInfo()` (v1.9.0) |
-| **Get Community Sub-groups**   | ✅      | ✅        | `getLinkedGroups()` (v1.9.0)  |
-| **Create Community**           | ✅      | ✅        | `createCommunity()` (v1.9.0)  |
-| **Add Community Sub-group**    | ✅      | ✅        | `linkGroupToCommunity()` (v1.9.0) |
-| **Remove Community Sub-group** | ✅      | ✅        | `unlinkGroupFromCommunity()` (v1.9.0) |
-| **Deactivate Community**       | ✅      | ❌        | No Baileys method (use `leaveCommunity()`) |
-
----
-
-## 14. Calls
-
-| Feature              | Baileys | Miaw Core | Notes                      |
-| -------------------- | ------- | --------- | -------------------------- |
-| **Call Events**      | ✅      | ✅        | `call` event (v1.12.0)     |
-| **Reject Call**      | ✅      | ✅        | `rejectCall()` (v1.12.0)   |
-| **Offer Call**       | ✅      | ❌        | Start audio/video call     |
-| **Terminate Call**   | ✅      | ❌        | End active call            |
-| **Group Video Call** | ✅      | ❌        | Group video calls          |
-| **Create Call Link** | ✅      | ✅        | `createCallLink()` (v1.12.0) |
-
----
-
-## 15. Utility Functions
-
-| Feature                           | Baileys | Miaw Core | Notes                               |
-| --------------------------------- | ------- | --------- | ----------------------------------- |
-| **JID Encoding/Decoding**         | ✅      | 🔶        | `MessageHandler.formatPhoneToJid()` |
-| **Check JID Type**                | ✅      | 🔶        | Group/user/newsletter/etc.          |
-| **LID to JID Resolution**         | ✅      | ✅        | `resolveLidToJid()` + async/bulk/reverse via native store (v1.5.0) |
-| **Get Phone from JID**            | ✅      | ✅        | `getPhoneFromJid()`                 |
-| **Generate Message ID**           | ✅      | ❌        | Custom message IDs                  |
-| **Download Content from Message** | ✅      | ✅        | `downloadMedia()`                   |
-| **Profile Picture Generation**    | ✅      | ❌        | Crop/resize for profile             |
-| **App State Sync**                | ✅      | 🔶        | For labels, used internally         |
-
----
-
-## 16. Low-Level / Advanced
-
-| Feature                      | Baileys | Miaw Core | Notes                  |
-| ---------------------------- | ------- | --------- | ---------------------- |
-| **Raw Query**                | ✅      | ❌        | Send raw IQ queries    |
-| **Custom Binary Node**       | ✅      | ❌        | Build custom nodes     |
-| **Event Buffering**          | ✅      | ❌        | Batch event processing |
-| **Signal Repository**        | ✅      | ❌        | Low-level encryption   |
-| **USyncQuery**               | ✅      | ❌        | User sync queries      |
-| **Custom WebSocket Handler** | ✅      | ❌        | WS event handling      |
-
----
-
-## Summary Statistics
-
-### Implementation Coverage
-
-| Category                  | Baileys Features | Miaw Core Implemented | Coverage |
-| ------------------------- | ---------------- | --------------------- | -------- |
-| **Connection & Auth**     | 14               | 12                    | 86%      |
-| **Sending Messages**      | 33               | 28                    | 85%      |
-| **Receiving & Events**    | 17               | 15                    | 88%      |
-| **Media**                 | 4                | 2                     | 50%      |
-| **Chat Management**       | 11               | 11                    | 100%     |
-| **User & Contacts**       | 10               | 10                    | 100%     |
-| **Profile Management**    | 5                | 5                     | 100%     |
-| **Group Management**      | 18               | 18                    | 100%     |
-| **Business (Labels)**     | 6                | 6                     | 100%     |
-| **Business (Catalog)**    | 6                | 6                     | 100%     |
-| **Business (Profile/QR)** | 4                | 4                     | 100%     |
-| **Newsletter/Channels**   | 19               | 19                    | 100%     |
-| **Privacy**               | 11               | 11                    | 100%     |
-| **Status/Broadcasts**     | 4                | 1                     | 25%      |
-| **Communities**           | 5                | 5                     | 100%     |
-| **Calls**                 | 6                | 3                     | 50%      |
-| **Utilities**             | 7                | 4                     | 57%      |
-| **Low-Level**             | 6                | 0                     | 0%       |
-| **TOTAL**                 | ~177             | ~163                  | ~92%     |
-
-### What Miaw Core Focuses On
-
-Miaw Core prioritizes the features that **90% of WhatsApp bots actually need**:
-
-1. ✅ **Core Messaging** - Text, media, reactions, editing, deletion
-2. ✅ **Group Management** - Full admin capabilities
-3. ✅ **Profile Management** - Complete profile control
-4. ✅ **Business Features** - Labels, products, catalogs
-5. ✅ **Newsletter/Channels** - Full channel support
-6. ✅ **Contact Management** - Add/edit/remove contacts
-7. ✅ **UX Features** - Typing indicators, read receipts, presence
-
-### What Miaw Core Doesn't Implement (Yet)
-
-**The prioritized backlog that used to live here is empty as of v1.12.0.** Every
-numbered item 1-8 has shipped; see **[DEFERRED_FEATURES.md](./DEFERRED_FEATURES.md)**,
-which now records only what is deliberately skipped.
-
-| Feature | Shipped in |
-| --- | --- |
-| Chat Management — archive, pin, mute, read/unread, clear, delete, star | v1.7.0 |
-| Business Extras — business profile, cover photo, order details, quick replies | v1.8.0 |
-| Status / Stories — post to `status@broadcast` | v1.8.0 |
-| Communities — the full `community*` layer | v1.9.0 |
-| Rich Messages — location, contact/vCard, poll + vote decoding, sticker | v1.6.0 |
-| Rich Messages — group-invite cards, pin-in-chat | v1.12.0 |
-| Privacy & Blocklist — block/unblock, blocklist, 10 privacy setters | v1.12.0 |
-| Group & Community Admin — announce/restrict, join approval, member-add mode, ephemeral | v1.12.0 |
-| Calls — call events, reject call, call links | v1.12.0 |
-
-Still deliberately not implemented:
-
-- 🔶 **Interactive Messages** — buttons / lists / templates, deprecated by WhatsApp (low value)
-- ❌ **Outbound calling** — `offerCall`, `terminateCall`, group video calls. Receiving,
-  rejecting and link creation are covered; placing a call is not.
-- ❌ **Low-level escape hatches** — raw IQ queries, custom binary nodes, direct signal
-  repository access. Deliberate: wrapping them would mean re-exposing the protocol that
-  miaw-core exists to hide.
-- ❌ **Extended text formatting, live location, product and event messages**, media from
-  a stream, custom thumbnails.
-- ❌ **Broadcast lists** and status deletion.
-
----
-
-## Design Philosophy Comparison
-
-### Baileys Approach
-
-- **Comprehensive** - Exposes nearly every WhatsApp Web feature
-- **Low-level** - Direct access to protocol
-- **Complex** - Requires understanding of WhatsApp internals
-- **Flexible** - Can do anything WhatsApp Web can do
-- **Events** - Many granular events to handle
-
-### Miaw Core Approach
-
-- **Focused** - Essential bot features only
-- **High-level** - Simplified abstractions
-- **Simple** - Easy to learn and use
-- **Opinionated** - Best practices built-in
-- **Events** - Consolidated, meaningful events
-
----
-
-## Migration Considerations
-
-### When to Use Baileys Directly
-
-- Need low-level protocol access
-- Implementing features Miaw doesn't have
-- Custom session storage backends
-- Need maximum control over behavior
-- Building a full WhatsApp client
-
-### When to Use Miaw Core
-
-- Building WhatsApp bots
-- Quick prototyping
-- Don't want to handle reconnection logic
-- Want simplified message handling
-- Need normalized message format
-- TypeScript with full type safety
-- Multiple bot instances
-
----
-
-## References
-
-- **Baileys Repository:** https://github.com/WhiskeySockets/Baileys
-- **Baileys Documentation:** https://baileys.whiskeysockets.io/
-- **Miaw Core Documentation:** [docs/USAGE.md](./USAGE.md)
-- **Miaw Core Roadmap:** [docs/ROADMAP.md](./ROADMAP.md)
-
----
-
-_This analysis was last updated on September 2, 2026, based on Baileys v7.0.0-rc14 and Miaw Core v1.12.0._