miaw-core 1.0.0 → 1.1.1

package/CHANGELOG.md

@@ -5,6 +5,47 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [1.1.0] - 2026-01-02
+
+**Baileys v7 Migration** - ESM-only release with improved session stability
+
+### BREAKING CHANGES
+
+- **ESM-only** - Package now uses `"type": "module"`. CommonJS `require()` is no longer supported.
+- **Node.js >= 18.0.0** required
+
+### Fixed
+
+- **Session reconnection issue** - Fixed bug where app couldn't reconnect after QR scan and restart without re-pairing
+- Includes fixes from Baileys v7: #1735, #1822, #1663, #1697
+
+### Changed
+
+- **Baileys** upgraded from v6.7.21 to v7.0.0-rc.9
+- TypeScript target updated to ES2022
+- All imports now use `.js` extensions for ESM compatibility
+- Node.js built-in imports use `node:` prefix
+
+### Migration
+
+For users upgrading from v1.0.x:
+
+```typescript
+// No code changes needed if already using ESM imports
+import { MiawClient } from "miaw-core";
+
+// If using CommonJS, migrate to ESM:
+// Before (CommonJS - no longer supported):
+// const { MiawClient } = require('miaw-core');
+
+// After (ESM):
+import { MiawClient } from "miaw-core";
+```
+
+Ensure your `package.json` has `"type": "module"` or use `.mjs` file extension.
+
+---
+
 ## [1.0.0] - 2025-12-24
 
 **First Stable Release!** 🎉
@@ -21,15 +62,18 @@ This is the first stable release of Miaw Core. After 9 pre-releases, the API is
 ### What's New Since v0.9.1
 
 #### LID Cache Management
+
 - `getLidCacheSize()` - Get current LID to JID cache size
 - `clearLidCache()` - Clear the LID cache
 - `getLidMappings()` - Returns `Record<string, string>` instead of `Map`
 
 #### Resource Cleanup
+
 - `dispose()` - Properly clean up resources before shutdown
 - Recommended to call on process exit for clean session save
 
 #### Performance Improvements
+
 - LID mappings now use LRU cache with max size of 1000 entries
 - Automatic eviction of least recently used mappings
 - Improved memory management for long-running bots
@@ -37,6 +81,7 @@ This is the first stable release of Miaw Core. After 9 pre-releases, the API is
 ### API Surface
 
 81 public methods across 10 categories:
+
 - Core Client (7 methods)
 - Messaging (6 methods)
 - Media (5 methods)
@@ -73,6 +118,7 @@ This is the first stable release of Miaw Core. After 9 pre-releases, the API is
 ### Added
 
 #### Examples
+
 - `01-basic-bot.ts` - Core client, QR authentication, echo bot (v0.1.0)
 - `02-media-bot.ts` - Media sending and downloading (v0.2.0)
 - `03-message-context.ts` - Reply, edit, delete, reactions (v0.3.0)
@@ -93,6 +139,7 @@ This is the first stable release of Miaw Core. After 9 pre-releases, the API is
 ### Added
 
 #### Label Operations (WhatsApp Business only)
+
 - `addLabel()` - Create or edit labels
 - `addChatLabel()` - Add a label to a chat
 - `removeChatLabel()` - Remove a label from a chat
@@ -103,6 +150,7 @@ This is the first stable release of Miaw Core. After 9 pre-releases, the API is
 - `Label`, `LabelOperationResult` types
 
 #### Catalog/Product Operations (WhatsApp Business only)
+
 - `getCatalog()` - Fetch product catalog with pagination support
 - `getCollections()` - Fetch catalog collections
 - `createProduct()` - Add new products to catalog
@@ -111,6 +159,7 @@ This is the first stable release of Miaw Core. After 9 pre-releases, the API is
 - `Product`, `ProductCollection`, `ProductCatalog`, `ProductOperationResult`, `ProductOptions` types
 
 #### Newsletter/Channel Operations
+
 - `createNewsletter()` - Create WhatsApp channels/newsletters
 - `getNewsletterMetadata()` - Get newsletter information
 - `followNewsletter()` - Follow/subscribe to newsletters
@@ -132,11 +181,13 @@ This is the first stable release of Miaw Core. After 9 pre-releases, the API is
 - `NewsletterMetadata`, `NewsletterMessage`, `NewsletterMessagesResult`, `NewsletterOperationResult`, `NewsletterSubscriptionInfo` types
 
 #### Contact Management
+
 - `addOrEditContact()` - Add or update contacts
 - `removeContact()` - Remove contacts
 - `ContactData`, `ContactOperationResult` types
 
 #### Tests
+
 - Integration tests for all v0.9.0 features (`12-business-features.test.ts`, `13-newsletter-features.test.ts`)
 
 ## [0.8.0] - 2025-12-21
@@ -144,14 +195,17 @@ This is the first stable release of Miaw Core. After 9 pre-releases, the API is
 ### Added
 
 - **Profile Picture Management**
+
   - `updateProfilePicture()` - Update your own profile picture (file path, URL, or Buffer)
   - `removeProfilePicture()` - Remove your profile picture
 
 - **Profile Information**
+
   - `updateProfileName()` - Update your display name (push name)
   - `updateProfileStatus()` - Update your "About" text
 
 - **New Types**
+
   - `ProfileOperationResult` - Result type for profile operations (success/error)
 
 - **Integration Tests**
@@ -162,31 +216,37 @@ This is the first stable release of Miaw Core. After 9 pre-releases, the API is
 ### Added
 
 - **Group Creation**
+
   - `createGroup()` - Create new WhatsApp groups with initial participants
   - Returns `CreateGroupResult` with group JID and metadata
 
 - **Participant Management**
+
   - `addParticipants()` - Add members to a group (requires admin)
   - `removeParticipants()` - Remove members from a group (requires admin)
   - `leaveGroup()` - Leave a group
   - Returns `ParticipantOperationResult[]` with status for each participant
 
 - **Admin Management**
+
   - `promoteToAdmin()` - Promote members to group admin
   - `demoteFromAdmin()` - Demote admins to regular members
 
 - **Group Settings**
+
   - `updateGroupName()` - Change group name/subject
   - `updateGroupDescription()` - Set or clear group description
   - `updateGroupPicture()` - Change group profile picture
 
 - **Group Invites**
+
   - `getGroupInviteLink()` - Get group invite link (https://chat.whatsapp.com/...)
   - `revokeGroupInvite()` - Revoke current link and get new one
   - `acceptGroupInvite()` - Join group via invite code or URL
   - `getGroupInviteInfo()` - Preview group info before joining
 
 - **New Types**
+
   - `ParticipantOperationResult` - Result of add/remove/promote/demote operations
   - `CreateGroupResult` - Result of group creation with metadata
   - `GroupOperationResult` - Generic success/error result for group operations
@@ -200,13 +260,16 @@ This is the first stable release of Miaw Core. After 9 pre-releases, the API is
 ### Added
 
 - **Send Reactions**
+
   - `sendReaction()` - Send emoji reactions to messages (e.g., '❤️', '👍')
   - `removeReaction()` - Remove your reaction from a message
 
 - **Forward Messages**
+
   - `forwardMessage()` - Forward any message to another chat
 
 - **Edit Messages**
+
   - `editMessage()` - Edit your own messages (within WhatsApp's 15-minute window)
 
 - **Delete Messages**
@@ -218,21 +281,25 @@ This is the first stable release of Miaw Core. After 9 pre-releases, the API is
 ### Added
 
 - **Read Receipts**
+
   - `markAsRead()` - Mark messages as read (send read receipt)
   - Returns boolean indicating success
 
 - **Typing & Recording Indicators**
+
   - `sendTyping()` - Send "typing..." indicator to a chat
   - `sendRecording()` - Send "recording audio..." indicator
   - `stopTyping()` - Stop typing/recording indicator (send paused state)
   - Works with both individual contacts and groups
 
 - **Presence Management**
+
   - `setPresence()` - Set bot's online/offline status ('available' or 'unavailable')
   - `subscribePresence()` - Subscribe to contact's presence updates
   - `presence` event - Emitted when subscribed contact's presence changes
 
 - **New Types**
+
   - `PresenceStatus` - Union type for 'available' | 'unavailable'
   - `PresenceUpdate` - Presence notification data (jid, status, lastSeen)
 
@@ -244,20 +311,24 @@ This is the first stable release of Miaw Core. After 9 pre-releases, the API is
 ### Added
 
 - **Contact Validation**
+
   - `checkNumber()` - Verify if phone number is on WhatsApp
   - `checkNumbers()` - Batch check multiple phone numbers
   - Returns `CheckNumberResult` with exists flag and JID
 
 - **Contact Information**
+
   - `getContactInfo()` - Fetch contact info including status
   - `getBusinessProfile()` - Get business account profile details
   - `getProfilePicture()` - Get profile picture URL (supports low/high res)
 
 - **Group Information**
+
   - `getGroupInfo()` - Fetch group metadata (name, description, settings)
   - `getGroupParticipants()` - List all group members with roles
 
 - **New Types**
+
   - `CheckNumberResult` - Result of number validation
   - `ContactInfo` - Contact information structure
   - `BusinessProfile` - Business profile data
@@ -273,23 +344,28 @@ This is the first stable release of Miaw Core. After 9 pre-releases, the API is
 ### Added
 
 - **Reply to Messages (Quoted)**
+
   - All send methods now support `quoted` option
   - Pass `MiawMessage` to reply to specific messages
   - Works with `sendText()`, `sendImage()`, `sendDocument()`, `sendVideo()`, `sendAudio()`
 
 - **Edit Notifications**
+
   - `message_edit` event when messages are edited
   - `MessageEdit` type with messageId, chatId, newText, editTimestamp
 
 - **Delete Notifications**
+
   - `message_delete` event when messages are deleted/revoked
   - `MessageDelete` type with messageId, chatId, fromMe, participant
 
 - **Reactions**
+
   - `message_reaction` event when messages receive reactions
   - `MessageReaction` type with messageId, chatId, reactorId, emoji, isRemoval
 
 - **New Types**
+
   - `MessageEdit` - Edit notification data
   - `MessageDelete` - Delete notification data
   - `MessageReaction` - Reaction notification data
@@ -307,15 +383,18 @@ This is the first stable release of Miaw Core. After 9 pre-releases, the API is
 ### Added
 
 - **Media Sending Methods**
+
   - `sendImage()` - Send images with caption and view-once support
   - `sendDocument()` - Send documents with auto-mimetype detection
   - `sendVideo()` - Send videos with caption, GIF playback, and PTV (video notes)
   - `sendAudio()` - Send audio with PTT (voice notes) support
 
 - **Media Download**
+
   - `downloadMedia()` - Download media from received messages as Buffer
 
 - **Media Metadata**
+
   - `MediaInfo` type with full metadata extraction
   - Support for mimetype, fileSize, dimensions, duration
   - PTT detection for voice notes
@@ -323,6 +402,7 @@ This is the first stable release of Miaw Core. After 9 pre-releases, the API is
   - View-once message detection
 
 - **New Types**
+
   - `MediaSource` - Flexible input type (path/URL/Buffer)
   - `SendImageOptions`, `SendDocumentOptions`, `SendVideoOptions`, `SendAudioOptions`
   - `MediaInfo` - Media metadata interface
@@ -345,22 +425,26 @@ This is the first stable release of Miaw Core. After 9 pre-releases, the API is
 ### Added
 
 - **Core Client**
+
   - `MiawClient` class with event-driven architecture
   - Connection management with auto-reconnection
   - Session persistence using Baileys multi-file auth state
   - Multiple instance support with isolated sessions
 
 - **Messaging**
+
   - `sendText()` - Send text messages to individuals and groups
   - Message normalization with `MiawMessage` format
   - Support for @s.whatsapp.net, @lid, @g.us JID formats
 
 - **LID Support**
+
   - Handle WhatsApp's @lid privacy format
   - LID to phone number mapping
   - `resolveLidToJid()`, `getPhoneFromJid()`, `registerLidMapping()`
 
 - **Events**
+
   - `qr` - QR code for authentication
   - `ready` - Client connected and ready
   - `message` - Incoming message received

package/README.md

@@ -1,13 +1,35 @@
 # Miaw Core
 
-**Multiple Instance of App WhatsApp** - A simplified WhatsApp API wrapper for Baileys
+**Multiple Instance of Awesome WhatsApp** - A simplified WhatsApp API wrapper for Baileys
 
 Miaw Core abstracts away the complexity of Baileys, providing a clean, simple API for building WhatsApp bots and automation tools. It handles all the painful parts: session management, QR codes, reconnection logic, and message parsing.
 
+> **Now powered by Baileys v7.0.0** - Full support for the latest WhatsApp Web features including newsletters/channels
+
+## Why Miaw Core vs Baileys Directly?
+
+| Aspect                 | Baileys (Direct)              | Miaw Core                          |
+| ---------------------- | ----------------------------- | ---------------------------------- |
+| **Learning Curve**     | Steep - 150+ methods to learn | Gentle - 92 focused methods        |
+| **Setup Code**         | 50-100 lines boilerplate      | 10 lines to start                  |
+| **Session Management** | Manual auth state handling    | Automatic file-based persistence   |
+| **Reconnection**       | DIY implementation            | Built-in with configurable retries |
+| **Message Format**     | Complex nested structures     | Normalized `MiawMessage` objects   |
+| **TypeScript**         | Types available but complex   | Clean, simplified types            |
+| **Multi-Instance**     | Manual socket management      | Instance ID-based separation       |
+
+**Choose Baileys directly** if you need low-level control, custom implementations, or access to every WhatsApp feature.
+
+**Choose Miaw Core** if you want to build bots quickly with clean code, automatic session handling, and don't need every obscure feature.
+
+For a detailed comparison, see [Baileys vs Miaw Core Comparison](./docs/BAILEYS_VS_MIAW_COMPARISON.md).
+
 ## Documentation
 
 - **[Usage Guide](./docs/USAGE.md)** - Complete guide for all current features
+- **[Baileys Comparison](./docs/BAILEYS_VS_MIAW_COMPARISON.md)** - Feature comparison with raw Baileys
 - **[Migration Guide](./docs/MIGRATION.md)** - Upgrading between versions
+- **[Test Coverage](./docs/TEST_COVERAGE_ANALYSIS.md)** - API coverage analysis
 - **[Roadmap](./docs/ROADMAP.md)** - Feature roadmap and development plan
 - **[Changelog](./CHANGELOG.md)** - Version history and changes
 - **[Examples](./examples/)** - Code examples and sample bots
@@ -26,6 +48,11 @@ Miaw Core abstracts away the complexity of Baileys, providing a clean, simple AP
 - **Group Management** - Full admin capabilities for groups
 - **Profile Management** - Customize bot profile picture, name, and status
 
+## Requirements
+
+- **Node.js** >= 18.0.0
+- **ESM** - This package is ESM-only (uses `"type": "module"`)
+
 ## Installation
 
 ```bash
@@ -67,9 +94,65 @@ await client.connect();
 
 For more examples and detailed usage, see the [Usage Guide](./docs/USAGE.md).
 
-## Current Capabilities (v1.0.0)
+## Testing
+
+### Manual Interactive Testing
+
+Test all 92 API methods interactively:
+
+```bash
+# Show available test groups
+npm run test:manual
+
+# Run specific test groups
+npm run test:manual all         # All tests
+npm run test:manual messaging   # Messaging tests only
+npm run test:manual newsletter  # Newsletter tests only
+npm run test:manual business    # Business features only
+```
+
+**Available test groups:**
+
+| Group        | Description                     | Methods |
+| ------------ | ------------------------------- | ------- |
+| `core`       | Connection, lifecycle           | 6       |
+| `get`        | Fetch contacts, groups, chats   | 6       |
+| `messaging`  | Send/receive, reactions, edit   | 12      |
+| `contacts`   | Check numbers, contact info     | 7       |
+| `group`      | Create, manage participants     | 13      |
+| `profile`    | Update picture, name, status    | 4       |
+| `business`   | Labels, catalog (Business only) | 10      |
+| `newsletter` | Channels, subscriptions         | 6       |
+| `ux`         | Typing, presence, read receipts | 5       |
+
+**Features:**
+
+- Auto-connects using existing session (skips QR if already authenticated)
+- Tracks test results with pass/fail/skip status
+- Generates summary report with timestamps
+- Pre-loads test configuration from `.env.test`
+
+See [Test Coverage Analysis](./docs/TEST_COVERAGE_ANALYSIS.md) for detailed coverage report.
+
+### Unit & Integration Tests
+
+```bash
+# Run all tests
+npm test
+
+# Run in watch mode
+npm run test:watch
+
+# Generate coverage report
+npm run test:coverage
+```
+
+## Current Capabilities (v1.1.0)
+
+Built on **Baileys v7.0.0-rc.9** - the latest WhatsApp Web protocol implementation.
 
 ### Core Features
+
 - ✅ Send and receive text messages
 - ✅ Send/receive media (images, videos, audio, documents)
 - ✅ QR code authentication
@@ -81,6 +164,7 @@ For more examples and detailed usage, see the [Usage Guide](./docs/USAGE.md).
 - ✅ Error handling
 
 ### Advanced Messaging
+
 - ✅ Reply/quote messages
 - ✅ Edit own messages
 - ✅ Delete messages
@@ -88,6 +172,7 @@ For more examples and detailed usage, see the [Usage Guide](./docs/USAGE.md).
 - ✅ Forward messages
 
 ### Group Management
+
 - ✅ Create groups
 - ✅ Add/remove participants
 - ✅ Promote/demote admins
@@ -95,16 +180,18 @@ For more examples and detailed usage, see the [Usage Guide](./docs/USAGE.md).
 - ✅ Update group settings
 
 ### Profile Management
+
 - ✅ Update profile picture
 - ✅ Remove profile picture
 - ✅ Update profile name
 - ✅ Update profile status
 
-### Business & Social (v1.0.0)
+### Business & Social
+
 - ✅ Label operations (WhatsApp Business)
 - ✅ Product catalog management (WhatsApp Business)
-- ✅ Newsletter/channel operations
-- ✅ Contact management
+- ✅ Newsletter/channel operations (create, send, manage)
+- ✅ Contact management (add, edit, remove)
 
 See [ROADMAP.md](./docs/ROADMAP.md) for planned features.
 
@@ -161,8 +248,8 @@ MIT
 
 ## Credits
 
-Built on top of [@whiskeysockets/baileys](https://github.com/WhiskeySockets/Baileys)
+Built on top of [@whiskeysockets/baileys](https://github.com/WhiskeySockets/Baileys) v7.0.0-rc.9
 
 ---
 
-**Version:** 1.0.0 | **Status:** Stable | **Updated:** 2025-12-24
+**Version:** 1.1.0 | **Baileys:** 7.0.0-rc.9 | **Status:** Stable | **Updated:** 2026-01-03

package/babel.config.js

@@ -1,5 +1,5 @@
-module.exports = {
+export default {
   presets: [
-    ['@babel/preset-env', { targets: { node: 'current' } }],
+    ['@babel/preset-env', { targets: { node: 'current' }, modules: false }],
   ],
 };

package/dist/client/MiawClient.d.ts

@@ -1,5 +1,5 @@
-import { EventEmitter } from 'events';
-import { MiawClientOptions, ConnectionState, SendTextOptions, SendMessageResult, MiawClientEvents, MediaSource, SendImageOptions, SendDocumentOptions, SendVideoOptions, SendAudioOptions, MiawMessage, CheckNumberResult, ContactInfo, BusinessProfile, GroupParticipant, GroupInfo, PresenceStatus, ParticipantOperationResult, CreateGroupResult, GroupOperationResult, GroupInviteInfo, ProfileOperationResult, Label, LabelOperationResult, ProductCatalog, ProductOperationResult, ProductOptions, ProductCollection, NewsletterMetadata, NewsletterMessagesResult, NewsletterOperationResult, NewsletterSubscriptionInfo, ContactData, ContactOperationResult } from '../types';
+import { EventEmitter } from "node:events";
+import { MiawClientOptions, ConnectionState, SendTextOptions, SendMessageResult, MiawClientEvents, MediaSource, SendImageOptions, SendDocumentOptions, SendVideoOptions, SendAudioOptions, MiawMessage, CheckNumberResult, ContactInfo, BusinessProfile, GroupParticipant, GroupInfo, PresenceStatus, ParticipantOperationResult, CreateGroupResult, GroupOperationResult, GroupInviteInfo, ProfileOperationResult, Label, LabelOperationResult, ProductCatalog, ProductOperationResult, ProductOptions, ProductCollection, NewsletterMetadata, NewsletterMessagesResult, NewsletterOperationResult, NewsletterSubscriptionInfo, ContactData, ContactOperationResult, OwnProfile, FetchAllContactsResult, FetchAllGroupsResult, FetchAllLabelsResult, FetchChatMessagesResult, FetchAllChatsResult } from "../types/index.js";
 /**
  * Main client class for interacting with WhatsApp
  */
@@ -12,6 +12,10 @@ export declare class MiawClient extends EventEmitter {
     private reconnectTimer;
     private logger;
     private lidToJidMap;
+    private contactsStore;
+    private labelsStore;
+    private messagesStore;
+    private chatsStore;
     constructor(options: MiawClientOptions);
     /**
      * Connect to WhatsApp
@@ -29,6 +33,16 @@ export declare class MiawClient extends EventEmitter {
      * Update LID to JID mapping from contacts
      */
     private updateLidToJidMapping;
+    /**
+     * Update in-memory contacts store (v0.9.0)
+     * @param contacts - Array of contact objects from Baileys
+     */
+    private updateContactsStore;
+    /**
+     * Update in-memory chats store (v0.9.0)
+     * @param chats - Array of chat objects from Baileys
+     */
+    private updateChatsStore;
     /**
      * Update LID to JID mapping from chat data
      */
@@ -65,6 +79,13 @@ export declare class MiawClient extends EventEmitter {
      * Clear LID cache
      */
     clearLidCache(): void;
+    /**
+     * Clear session data for this instance.
+     * This will delete all stored authentication credentials.
+     * After calling this, the next connect() will require scanning a new QR code.
+     * @returns true if session was cleared, false if no session existed
+     */
+    clearSession(): boolean;
     /**
      * Dispose client and clean up resources
      */
@@ -154,6 +175,48 @@ export declare class MiawClient extends EventEmitter {
      * @returns Profile picture URL or null if not available
      */
     getProfilePicture(jidOrPhone: string, highRes?: boolean): Promise<string | null>;
+    /**
+     * Fetch all contacts from the in-memory store
+     * Note: Contacts are populated via history sync and contact events
+     * @returns FetchAllContactsResult with list of contacts
+     */
+    fetchAllContacts(): Promise<FetchAllContactsResult>;
+    /**
+     * Fetch all groups the user is participating in
+     * @returns FetchAllGroupsResult with list of groups
+     */
+    fetchAllGroups(): Promise<FetchAllGroupsResult>;
+    /**
+     * Get own profile information
+     * @returns OwnProfile or null if not available
+     */
+    getOwnProfile(): Promise<OwnProfile | null>;
+    /**
+     * Sync labels from WhatsApp app state
+     * This triggers a resync of the 'regular' collection which contains labels
+     * Labels will be emitted via labels.edit events and stored in labelsStore
+     */
+    private syncLabelsFromAppState;
+    /**
+     * Fetch all labels from the in-memory store
+     * Note: Labels are populated via history sync and label events
+     * @param forceSync - If true, force a resync from WhatsApp before returning labels
+     * @returns FetchAllLabelsResult with list of labels
+     */
+    fetchAllLabels(forceSync?: boolean): Promise<FetchAllLabelsResult>;
+    /**
+     * Get chat messages from the in-memory store
+     * Note: Messages are populated via messages.upsert events
+     * @param jidOrPhone - Chat JID or phone number
+     * @returns FetchChatMessagesResult with list of messages
+     */
+    getChatMessages(jidOrPhone: string): Promise<FetchChatMessagesResult>;
+    /**
+     * Fetch all chats from the in-memory store
+     * Note: Chats are populated via history sync and chat events
+     * @returns FetchAllChatsResult with list of chats
+     */
+    fetchAllChats(): Promise<FetchAllChatsResult>;
     /**
      * Get group metadata/information
      * @param groupJid - Group JID (e.g., '123456789@g.us')
@@ -398,7 +461,7 @@ export declare class MiawClient extends EventEmitter {
      * @param limit - Maximum number of products to fetch (default: 10)
      * @param cursor - Pagination cursor for fetching next page
      * @returns ProductCatalog
-     * @note Requires WhatsApp Business account
+     * @note Requires WhatsApp Business account with catalog configured
      */
     getCatalog(businessJidOrPhone?: string, limit?: number, cursor?: string): Promise<ProductCatalog>;
     /**
@@ -406,22 +469,23 @@ export declare class MiawClient extends EventEmitter {
      * @param businessJidOrPhone - Business JID or phone number (default: your own collections)
      * @param limit - Maximum number of collections to fetch (default: 51)
      * @returns Array of ProductCollection
-     * @note Requires WhatsApp Business account
+     * @note Requires WhatsApp Business account with collections created via the catalog API.
+     *       Collections created in the WhatsApp Business app may not appear here.
      */
     getCollections(businessJidOrPhone?: string, limit?: number): Promise<ProductCollection[]>;
     /**
      * Create a new product in the catalog
-     * @param options - Product options (name, price, images, etc.)
+     * @param options - Product options (name, price, currency, images, etc.)
      * @returns ProductOperationResult with product ID
-     * @note Requires WhatsApp Business account
+     * @note Requires WhatsApp Business account with catalog enabled
      */
     createProduct(options: ProductOptions): Promise<ProductOperationResult>;
     /**
      * Update an existing product in the catalog
      * @param productId - Product ID to update
-     * @param options - Product options (name, price, images, etc.)
+     * @param options - Product options (name, price, currency, images, etc.)
      * @returns ProductOperationResult
-     * @note Requires WhatsApp Business account
+     * @note Requires WhatsApp Business account with catalog enabled
      */
     updateProduct(productId: string, options: ProductOptions): Promise<ProductOperationResult>;
     /**
@@ -431,6 +495,32 @@ export declare class MiawClient extends EventEmitter {
      * @note Requires WhatsApp Business account
      */
     deleteProducts(productIds: string[]): Promise<ProductOperationResult>;
+    /**
+     * Send a text message to a newsletter/channel
+     * @param newsletterId - Newsletter JID (e.g., '1234567890@newsletter')
+     * @param text - Message text content
+     * @returns SendMessageResult
+     * @note You must be an admin/owner of the newsletter to send messages
+     */
+    sendNewsletterMessage(newsletterId: string, text: string): Promise<SendMessageResult>;
+    /**
+     * Send an image to a newsletter/channel
+     * @param newsletterId - Newsletter JID (e.g., '1234567890@newsletter')
+     * @param image - Image source (file path, URL, or Buffer)
+     * @param caption - Optional caption
+     * @returns SendMessageResult
+     * @note You must be an admin/owner of the newsletter to send messages
+     */
+    sendNewsletterImage(newsletterId: string, image: MediaSource, caption?: string): Promise<SendMessageResult>;
+    /**
+     * Send a video to a newsletter/channel
+     * @param newsletterId - Newsletter JID (e.g., '1234567890@newsletter')
+     * @param video - Video source (file path, URL, or Buffer)
+     * @param caption - Optional caption
+     * @returns SendMessageResult
+     * @note You must be an admin/owner of the newsletter to send messages
+     */
+    sendNewsletterVideo(newsletterId: string, video: MediaSource, caption?: string): Promise<SendMessageResult>;
     /**
      * Create a new newsletter/channel
      * @param name - Newsletter name
@@ -571,9 +661,16 @@ export declare class MiawClient extends EventEmitter {
      */
     private getMimetypeFromFileName;
     /**
-     * Disconnect from WhatsApp
+     * Disconnect from WhatsApp without logging out.
+     * The session is preserved and can be used to reconnect later without scanning QR again.
+     * Use logout() if you want to fully log out and require a new QR code.
      */
     disconnect(): Promise<void>;
+    /**
+     * Logout from WhatsApp and clear session.
+     * After calling this, the next connect() will require scanning a new QR code.
+     */
+    logout(): Promise<void>;
     /**
      * Get current connection state
      */