miaw-core 1.1.0 → 1.2.0

package/dist/cli/utils/session.js

@@ -0,0 +1,294 @@
+/**
+ * CLI Session Management Utilities
+ *
+ * Helper functions for managing MiawClient instances and sessions
+ */
+import * as fs from "fs";
+import * as path from "path";
+import qrcode from "qrcode-terminal";
+import { MiawClient } from "../../index.js";
+import { TIMEOUTS, THRESHOLDS } from "../../constants/timeouts.js";
+// Re-export prompt functions from shared utility
+export { prompt, confirm } from "./prompt.js";
+/**
+ * Get list of existing instances from session directory
+ */
+export function listInstances(sessionPath) {
+    if (!fs.existsSync(sessionPath)) {
+        return [];
+    }
+    const items = fs.readdirSync(sessionPath);
+    const instances = [];
+    for (const item of items) {
+        const itemPath = path.join(sessionPath, item);
+        const stats = fs.statSync(itemPath);
+        if (stats.isDirectory()) {
+            // Check if it has creds.json (valid session)
+            const credsPath = path.join(itemPath, "creds.json");
+            if (fs.existsSync(credsPath)) {
+                instances.push(item);
+            }
+        }
+    }
+    return instances;
+}
+/**
+ * Delete an instance session
+ */
+export function deleteInstance(sessionPath, instanceId) {
+    const instancePath = path.join(sessionPath, instanceId);
+    if (!fs.existsSync(instancePath)) {
+        return false;
+    }
+    try {
+        fs.rmSync(instancePath, { recursive: true, force: true });
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Create a new MiawClient instance
+ */
+export function createClient(config) {
+    return new MiawClient({
+        instanceId: config.instanceId,
+        sessionPath: config.sessionPath,
+        debug: config.debug || false,
+    });
+}
+/**
+ * Wait for client to be ready
+ */
+export async function waitForConnection(client, timeout = TIMEOUTS.CONNECTION_TIMEOUT) {
+    const state = client.getConnectionState();
+    if (state === "connected") {
+        return true;
+    }
+    return new Promise((resolve) => {
+        const timer = setTimeout(() => {
+            resolve(false);
+        }, timeout);
+        client.once("ready", () => {
+            clearTimeout(timer);
+            resolve(true);
+        });
+        client.once("disconnected", () => {
+            clearTimeout(timer);
+            resolve(false);
+        });
+    });
+}
+/**
+ * Wait for initial QR code or ready event
+ * @param client - MiawClient instance
+ * @returns "qr" if QR was shown, "ready" if connected, "timeout" if timed out
+ */
+async function waitForQROrReady(client) {
+    return new Promise((resolve) => {
+        const timeout = setTimeout(() => {
+            console.log("\n⏱️  Timeout while waiting for QR/ready event");
+            resolve("timeout");
+        }, TIMEOUTS.CONNECTION_TIMEOUT);
+        const onQr = (qr) => {
+            clearTimeout(timeout);
+            console.log("\n📱 Scan the QR code below with WhatsApp:");
+            qrcode.generate(qr, { small: true });
+            console.log();
+            resolve("qr");
+        };
+        const onReady = () => {
+            clearTimeout(timeout);
+            resolve("ready");
+        };
+        client.once("qr", onQr);
+        client.once("ready", onReady);
+    });
+}
+/**
+ * Wait for connection with polling fallback after QR display
+ * @param client - MiawClient instance
+ * @param qrDisplayTime - Timestamp when QR was displayed
+ * @returns true if connected, false if timeout
+ */
+async function waitForConnectionWithPolling(client, qrDisplayTime) {
+    return new Promise((resolve) => {
+        const timeout = setTimeout(() => {
+            const finalState = client.getConnectionState();
+            console.log(`\n⏱️  Connection timeout (final state: ${finalState})`);
+            resolve(false);
+        }, TIMEOUTS.CONNECTION_TIMEOUT);
+        const onReady = () => {
+            clearTimeout(timeout);
+            clearInterval(pollInterval);
+            client.off("ready", onReady);
+            client.off("disconnected", onDisconnected);
+            resolve(true);
+        };
+        const onDisconnected = () => {
+            const timeSinceQrDisplay = Date.now() - qrDisplayTime;
+            // During grace period after QR display, ignore all disconnects
+            // Baileys emits transient disconnects (codes 408/428) during normal connection handshake
+            if (timeSinceQrDisplay < TIMEOUTS.QR_GRACE_PERIOD) {
+                return; // Wait patiently - this is expected during QR scan and initial handshake
+            }
+            // After grace period, continue to be patient
+            // Auto-reconnect will retry transient issues
+            // Let the main timeout catch true hangs
+            // Don't fail prematurely - the ready event will fire when truly connected
+        };
+        client.once("ready", onReady);
+        client.on("disconnected", onDisconnected);
+        // Also poll connection state as fallback in case event was missed
+        let dots = 0;
+        let stuckStateCount = 0;
+        const pollInterval = setInterval(() => {
+            const currentState = client.getConnectionState();
+            const now = Date.now();
+            const timeSinceQrDisplay = now - qrDisplayTime;
+            if (currentState === "connected") {
+                clearTimeout(timeout);
+                clearInterval(pollInterval);
+                client.off("ready", onReady);
+                client.off("disconnected", onDisconnected);
+                resolve(true);
+            }
+            else if (currentState === "disconnected") {
+                // Just show feedback - don't fail here
+                // The onDisconnected event handler and main timeout will handle failures
+                const message = timeSinceQrDisplay < TIMEOUTS.QR_GRACE_PERIOD
+                    ? "Waiting for QR scan..."
+                    : "Waiting for connection...";
+                dots = (dots + 1) % 4;
+                process.stdout.write(`\r${".".repeat(dots).padEnd(3, " ")} ${message}   `);
+            }
+            else if (currentState === "qr_required") {
+                // QR timeout check
+                if (timeSinceQrDisplay > TIMEOUTS.QR_SCAN_TIMEOUT) {
+                    clearTimeout(timeout);
+                    clearInterval(pollInterval);
+                    client.off("ready", onReady);
+                    client.off("disconnected", onDisconnected);
+                    console.log(`\n⏱️  QR code not scanned within ${TIMEOUTS.QR_SCAN_TIMEOUT / 1000}s`);
+                    resolve(false);
+                    return;
+                }
+                dots = (dots + 1) % 4;
+                process.stdout.write(`\r${".".repeat(dots).padEnd(3, " ")} Waiting for QR scan...   `);
+            }
+            else if (currentState === "connecting" || currentState === "reconnecting") {
+                stuckStateCount++;
+                dots = (dots + 1) % 4;
+                process.stdout.write(`\r${".".repeat(dots).padEnd(3, " ")} State: ${currentState}   `);
+                // If stuck for too long, reset counter and keep trying
+                // Let the main timeout catch true hangs
+                if (stuckStateCount > THRESHOLDS.STUCK_STATE_COUNT) {
+                    stuckStateCount = 0; // Reset and keep waiting - be patient
+                }
+            }
+            else {
+                stuckStateCount = 0;
+                dots = (dots + 1) % 4;
+                process.stdout.write(`\r${".".repeat(dots).padEnd(3, " ")} State: ${currentState}   `);
+            }
+        }, TIMEOUTS.POLL_INTERVAL);
+    });
+}
+/**
+ * Handle QR code display and wait for connection
+ */
+export async function handleQRConnection(client) {
+    console.log("📱 Connecting to WhatsApp...");
+    // Start connection
+    client.connect();
+    // Wait a moment for connection to initialize
+    await new Promise((resolve) => setTimeout(resolve, TIMEOUTS.SOCKET_INIT_WAIT));
+    // Check if already connected (race condition check)
+    if (client.getConnectionState() === "connected") {
+        console.log("✅ Connected successfully!");
+        return { success: true };
+    }
+    // Wait for QR or ready
+    const result = await waitForQROrReady(client);
+    if (result === "timeout") {
+        // Check actual state before giving up
+        const finalState = client.getConnectionState();
+        if (finalState === "connected") {
+            console.log("✅ Connected successfully!");
+            return { success: true };
+        }
+        return {
+            success: false,
+            reason: `Timeout waiting for connection (state: ${finalState})`,
+        };
+    }
+    if (result === "ready") {
+        console.log("✅ Connected successfully!");
+        return { success: true };
+    }
+    // QR was shown, wait for ready with polling check as fallback
+    console.log("⏳ Waiting for connection...");
+    // First check if already connected (could have connected during QR display)
+    const initialCheckState = client.getConnectionState();
+    if (initialCheckState === "connected") {
+        console.log("✅ Connected successfully!");
+        return { success: true };
+    }
+    console.log(`(Current state: ${initialCheckState})`);
+    // Track QR display timing
+    const qrDisplayTime = Date.now();
+    // Wait for connection with polling
+    const connected = await waitForConnectionWithPolling(client, qrDisplayTime);
+    // Clear the progress line
+    process.stdout.write("\r" + " ".repeat(50) + "\r");
+    if (connected) {
+        console.log("✅ Connected successfully!");
+        return { success: true };
+    }
+    const finalState = client.getConnectionState();
+    return {
+        success: false,
+        reason: `Failed to connect after QR scan (final state: ${finalState})`,
+    };
+}
+/**
+ * Ensure client is connected, handling QR if needed
+ */
+export async function ensureConnected(client, options) {
+    const state = client.getConnectionState();
+    if (state === "connected") {
+        return { success: true };
+    }
+    if (state === "connecting" || state === "reconnecting") {
+        if (options?.silent !== true) {
+            console.log("📱 Connection in progress...");
+        }
+        // Wait for connection to complete
+        const connected = await waitForConnection(client, 60000);
+        if (connected) {
+            return { success: true };
+        }
+        return { success: false, reason: "Connection timeout" };
+    }
+    if (options?.silent !== true) {
+        console.log("📱 Not connected. Connecting...");
+    }
+    return handleQRConnection(client);
+}
+/**
+ * Format phone number to JID
+ */
+export function phoneToJid(phone) {
+    if (phone.includes("@")) {
+        return phone; // Already a JID
+    }
+    return `${phone}@s.whatsapp.net`;
+}
+/**
+ * Format JID to phone number
+ */
+export function jidToPhone(jid) {
+    return jid.replace("@s.whatsapp.net", "").replace("@g.us", "");
+}
+//# sourceMappingURL=session.js.map

package/dist/cli/utils/session.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"session.js","sourceRoot":"","sources":["../../../src/cli/utils/session.ts"],"names":[],"mappings":"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"}

package/dist/client/MiawClient.d.ts

@@ -1,5 +1,5 @@
 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";
+import { MiawClientOptions, ConnectionState, SendTextOptions, SendMessageResult, MiawClientEvents, MediaSource, SendImageOptions, SendDocumentOptions, SendVideoOptions, SendAudioOptions, MiawMessage, CheckNumberResult, ContactInfo, ContactProfile, 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, ChatInfo } from "../types/index.js";
 /**
  * Main client class for interacting with WhatsApp
  */
@@ -8,14 +8,24 @@ export declare class MiawClient extends EventEmitter {
     private socket;
     private authHandler;
     private connectionState;
+    private connectionStateTimestamp;
+    private connectionWatchdogTimer;
     private reconnectAttempts;
     private reconnectTimer;
+    private loggingOut;
     private logger;
     private lidToJidMap;
     private contactsStore;
-    private labelsStore;
-    private messagesStore;
     private chatsStore;
+    private messagesStore;
+    private labelsStore;
+    private labelChatsStore;
+    private pendingHistoryRequests;
+    private labelEventCount;
+    private lastLabelSyncTime?;
+    private initialLabelSyncPromise;
+    private initialLabelSyncComplete;
+    private authState;
     constructor(options: MiawClientOptions);
     /**
      * Connect to WhatsApp
@@ -26,23 +36,26 @@ export declare class MiawClient extends EventEmitter {
      */
     private registerSocketEvents;
     /**
-     * Handle protocol messages (edits, deletes)
+     * Remove all socket event listeners
+     * Call this before closing socket to prevent stale event handlers
      */
-    private handleProtocolMessage;
+    private removeSocketEvents;
     /**
-     * Update LID to JID mapping from contacts
+     * Handle protocol messages (edits, deletes)
      */
-    private updateLidToJidMapping;
+    private handleProtocolMessage;
     /**
-     * Update in-memory contacts store (v0.9.0)
-     * @param contacts - Array of contact objects from Baileys
+     * Add LID to JID mapping with normalized format and debug logging
+     * Centralized helper for all LID mapping operations
+     * @param lid - The LID (with or without @lid suffix)
+     * @param jid - The JID to map to (phone number)
+     * @param source - Source of the mapping for debug logs
      */
-    private updateContactsStore;
+    private addLidMapping;
     /**
-     * Update in-memory chats store (v0.9.0)
-     * @param chats - Array of chat objects from Baileys
+     * Update LID to JID mapping from contacts
      */
-    private updateChatsStore;
+    private updateLidToJidMapping;
     /**
      * Update LID to JID mapping from chat data
      */
@@ -70,6 +83,10 @@ export declare class MiawClient extends EventEmitter {
      * Get all registered LID mappings
      * Useful for persisting mappings to storage
      */
+    /**
+     * Get all LID to JID mappings (for debugging/monitoring)
+     * @returns Record of LID to JID mappings
+     */
     getLidMappings(): Record<string, string>;
     /**
      * Get LID cache size
@@ -79,6 +96,37 @@ export declare class MiawClient extends EventEmitter {
      * Clear LID cache
      */
     clearLidCache(): void;
+    /**
+     * Update in-memory contacts store
+     * @param contacts - Array of contact objects from Baileys
+     *
+     * Baileys v7 Contact structure:
+     * - id: primary identifier (could be @lid or @s.whatsapp.net)
+     * - phoneNumber: phone JID (@s.whatsapp.net) when available
+     * - lid: LID JID (@lid) when available
+     * - name: contact name saved by user
+     * - notify: contact's own display name (push name)
+     * - verifiedName: verified business name
+     */
+    private updateContactsStore;
+    /**
+     * Update in-memory chats store
+     * @param chats - Array of chat objects from Baileys
+     *
+     * Baileys v7 Chat structure (proto.IConversation):
+     * - id: chat JID (can be @lid or @s.whatsapp.net or @g.us)
+     * - pnJid: phone number JID when id is LID
+     * - lidJid: LID JID when id is phone
+     * - name/displayName: chat display name
+     * - conversationTimestamp: last message timestamp
+     * - unreadCount, archived, pinned: chat state
+     */
+    private updateChatsStore;
+    /**
+     * Add a message to the store
+     * @param msg - Baileys message object
+     */
+    private addMessageToStore;
     /**
      * Clear session data for this instance.
      * This will delete all stored authentication credentials.
@@ -103,6 +151,10 @@ export declare class MiawClient extends EventEmitter {
      * Update connection state and emit event
      */
     private updateConnectionState;
+    /**
+     * Start watchdog timer to detect stuck connection states
+     */
+    private startConnectionWatchdog;
     /**
      * Send a text message
      * @param to - Recipient phone number or JID
@@ -162,6 +214,12 @@ export declare class MiawClient extends EventEmitter {
      * @returns ContactInfo or null if not found
      */
     getContactInfo(jidOrPhone: string): Promise<ContactInfo | null>;
+    /**
+     * Get full contact profile including name, status, picture, and business info
+     * @param jidOrPhone - Contact's JID or phone number
+     * @returns ContactProfile or null if not found
+     */
+    getContactProfile(jidOrPhone: string): Promise<ContactProfile | null>;
     /**
      * Get business profile information
      * @param jidOrPhone - Contact's JID or phone number
@@ -177,7 +235,7 @@ export declare class MiawClient extends EventEmitter {
     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
+     * Note: Contacts are populated via Baileys store history sync
      * @returns FetchAllContactsResult with list of contacts
      */
     fetchAllContacts(): Promise<FetchAllContactsResult>;
@@ -193,7 +251,7 @@ export declare class MiawClient extends EventEmitter {
     getOwnProfile(): Promise<OwnProfile | null>;
     /**
      * Sync labels from WhatsApp app state
-     * This triggers a resync of the 'regular' collection which contains labels
+     * This triggers a resync of ALL app state collections to ensure labels are synced
      * Labels will be emitted via labels.edit events and stored in labelsStore
      */
     private syncLabelsFromAppState;
@@ -203,17 +261,117 @@ export declare class MiawClient extends EventEmitter {
      * @param forceSync - If true, force a resync from WhatsApp before returning labels
      * @returns FetchAllLabelsResult with list of labels
      */
-    fetchAllLabels(forceSync?: boolean): Promise<FetchAllLabelsResult>;
+    fetchAllLabels(forceSync?: boolean, syncTimeout?: number): Promise<FetchAllLabelsResult>;
+    /**
+     * Get chats that have a specific label
+     * @param labelId - Label ID to query
+     * @returns Array of ChatInfo for chats with this label
+     */
+    getChatsByLabel(labelId: string): ChatInfo[];
+    /**
+     * Get the count of label events received
+     * Useful for debugging label sync issues
+     * @returns Number of labels.edit events received since connection
+     */
+    getLabelEventCount(): number;
+    /**
+     * Get detailed information about the labels store
+     * Useful for debugging label sync issues
+     * @returns Object with store size, event count, and last sync time
+     */
+    getLabelsStoreInfo(): {
+        size: number;
+        eventCount: number;
+        lastSyncTime?: Date;
+    };
+    /**
+     * Get the path to the labels storage file
+     */
+    private getLabelsFilePath;
+    /**
+     * Save labels to disk for persistence across reconnections
+     * WhatsApp's resyncAppState only returns patches (not full snapshot) when version > 0,
+     * so we need to persist labels locally to survive reconnections
+     */
+    private saveLabelsToFile;
+    /**
+     * Load labels from disk
+     * Called on connection to restore labels from previous session
+     */
+    private loadLabelsFromFile;
+    private getContactsFilePath;
+    /**
+     * Save contacts to disk for persistence across reconnections
+     * Baileys v7 history sync doesn't always fire, so we persist contacts locally
+     */
+    private saveContactsToFile;
+    /**
+     * Load contacts from disk
+     * Called on connection to restore contacts from previous session
+     */
+    private loadContactsFromFile;
+    private getLidMappingsFilePath;
+    /**
+     * Save LID-to-JID mappings to disk for persistence across reconnections
+     * This ensures @lid JIDs can be resolved to phone numbers even after restart
+     */
+    private saveLidMappingsToFile;
+    /**
+     * Load LID-to-JID mappings from disk
+     * Called on connection BEFORE loading chats to ensure resolution works
+     */
+    private loadLidMappingsFromFile;
+    private getChatsFilePath;
+    /**
+     * Save chats to disk for persistence across reconnections
+     * Baileys v7 history sync doesn't always fire, so we persist chats locally
+     */
+    private saveChatsToFile;
+    /**
+     * Load chats from disk
+     * Called on connection to restore chats from previous session
+     */
+    private loadChatsFromFile;
+    private getMessagesFilePath;
+    /**
+     * Save messages to disk for persistence across reconnections
+     * Baileys v7 history sync doesn't always fire, so we persist messages locally
+     */
+    private saveMessagesToFile;
+    /**
+     * Load messages from disk
+     * Called on connection to restore messages from previous session
+     */
+    private loadMessagesFromFile;
+    /**
+     * Get message counts for all chats
+     * @returns Map of JID to message count
+     */
+    getMessageCounts(): Map<string, number>;
     /**
      * Get chat messages from the in-memory store
-     * Note: Messages are populated via messages.upsert events
+     * Note: Messages are populated via Baileys store history sync
      * @param jidOrPhone - Chat JID or phone number
      * @returns FetchChatMessagesResult with list of messages
      */
     getChatMessages(jidOrPhone: string): Promise<FetchChatMessagesResult>;
+    /**
+     * Load more (older) messages for a specific chat
+     * Uses Baileys fetchMessageHistory to fetch earlier messages
+     * @param jidOrPhone - Chat JID or phone number
+     * @param count - Number of messages to fetch (max 50)
+     * @param timeoutMs - Timeout in milliseconds (default 30000)
+     * @returns Result with number of messages loaded and whether more are available
+     */
+    loadMoreMessages(jidOrPhone: string, count?: number, timeoutMs?: number): Promise<{
+        success: boolean;
+        messagesLoaded?: number;
+        hasMore?: boolean;
+        error?: string;
+    }>;
     /**
      * Fetch all chats from the in-memory store
-     * Note: Chats are populated via history sync and chat events
+     * Note: Chats are populated via Baileys store history sync
      * @returns FetchAllChatsResult with list of chats
      */
     fetchAllChats(): Promise<FetchAllChatsResult>;
@@ -661,13 +819,35 @@ 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.
+     *
+     * This method:
+     * 1. Attempts to reconnect if disconnected (max 10 seconds)
+     * 2. Sends a logout request to WhatsApp servers using socket.query() to wait for acknowledgment
+     * 3. Clears local session files
+     * 4. Closes the connection
+     *
+     * Note: The socket.query() method waits for WhatsApp's acknowledgment before proceeding.
+     * This is more reliable than Baileys' native socket.logout() which uses sendNode() (fire-and-forget).
+     */
+    logout(): Promise<void>;
     /**
      * Get current connection state
      */
     getConnectionState(): ConnectionState;
+    /**
+     * Wait for connection state to change to desired state
+     * @param desiredState - The state to wait for
+     * @param timeoutMs - Maximum time to wait in milliseconds
+     */
+    private waitForState;
     /**
      * Get instance ID
      */
@@ -676,6 +856,25 @@ export declare class MiawClient extends EventEmitter {
      * Check if connected
      */
     isConnected(): boolean;
+    /**
+     * Enable debug mode at runtime
+     * Enables verbose logging for debugging (includes libsignal session logs)
+     */
+    enableDebug(): void;
+    /**
+     * Disable debug mode at runtime
+     * Disables verbose logging and suppresses libsignal session logs
+     */
+    disableDebug(): void;
+    /**
+     * Check if debug mode is enabled
+     */
+    isDebugEnabled(): boolean;
+    /**
+     * Set debug mode
+     * @param enabled - Whether to enable debug mode
+     */
+    setDebug(enabled: boolean): void;
     on<K extends keyof MiawClientEvents>(event: K, listener: MiawClientEvents[K]): this;
     emit<K extends keyof MiawClientEvents>(event: K, ...args: Parameters<MiawClientEvents[K]>): boolean;
 }