wa-multi-mongodb 3.10.3 → 3.10.6

package/dist/Socket/index.d.ts

@@ -102,4 +102,163 @@ export declare const getGroupMetadata: (sessionId: string, jid: string, forceFet
 export declare const clearGroupMetadataCache: (sessionId: string, jid: string) => Promise<void>;
 export declare const clearSessionGroupMetadataCache: (sessionId: string) => Promise<void>;
 export declare const clearAllGroupMetadataCache: () => void;
+/**
+ * Result type for LID to PN conversion
+ */
+export interface LIDConversionResult {
+    success: boolean;
+    lid: string;
+    pn: string | null;
+    error?: string;
+}
+/**
+ * Result type for PN to LID conversion
+ */
+export interface PNConversionResult {
+    success: boolean;
+    pn: string;
+    lid: string | null;
+    error?: string;
+}
+/**
+ * LID Mapping entry type
+ */
+export interface LIDMappingEntry {
+    lid: string;
+    pn: string;
+}
+/**
+ * Convert LID (Linked ID) to Phone Number (PN/JID)
+ *
+ * This function uses Baileys' internal signalRepository.lidMapping to retrieve
+ * the phone number associated with a given LID.
+ *
+ * @param sessionId - Session ID to use for conversion
+ * @param lid - The LID to convert (e.g., "1524746986546@lid")
+ * @returns Promise<LIDConversionResult> - Result object with the phone number or null if not found
+ *
+ * @example
+ * ```typescript
+ * const result = await whatsapp.getPNForLID("mysession", "1524746986546@lid");
+ * if (result.success && result.pn) {
+ *   console.log(`Phone number: ${result.pn}`);
+ * } else {
+ *   console.log("Phone number not found for this LID");
+ * }
+ * ```
+ *
+ * @note This function may return null for new contacts or when WhatsApp
+ * hasn't provided the LID-PN mapping yet. Not all LIDs have known phone numbers.
+ */
+export declare const getPNForLID: (sessionId: string, lid: string) => Promise<LIDConversionResult>;
+/**
+ * Convert Phone Number (PN/JID) to LID (Linked ID)
+ *
+ * This function uses Baileys' internal signalRepository.lidMapping to retrieve
+ * the LID associated with a given phone number.
+ *
+ * @param sessionId - Session ID to use for conversion
+ * @param pn - The phone number/JID to convert (e.g., "6281234567890" or "6281234567890@s.whatsapp.net")
+ * @returns Promise<PNConversionResult> - Result object with the LID or null if not found
+ *
+ * @example
+ * ```typescript
+ * const result = await whatsapp.getLIDForPN("mysession", "6281234567890");
+ * if (result.success && result.lid) {
+ *   console.log(`LID: ${result.lid}`);
+ * } else {
+ *   console.log("LID not found for this phone number");
+ * }
+ * ```
+ *
+ * @note This function may return null for contacts that haven't been encountered
+ * with their LID mapping yet.
+ */
+export declare const getLIDForPN: (sessionId: string, pn: string) => Promise<PNConversionResult>;
+/**
+ * Get all known LID-PN mappings for a session
+ *
+ * This function retrieves all LID to phone number mappings that are currently
+ * stored in the session's signal repository.
+ *
+ * @param sessionId - Session ID to get mappings from
+ * @returns Promise<LIDMappingEntry[]> - Array of LID-PN mapping entries
+ *
+ * @example
+ * ```typescript
+ * const mappings = await whatsapp.getAllLIDMappings("mysession");
+ * for (const mapping of mappings) {
+ *   console.log(`${mapping.lid} => ${mapping.pn}`);
+ * }
+ * ```
+ *
+ * @note This may return an empty array if no mappings are available yet.
+ */
+export declare const getAllLIDMappings: (sessionId: string) => Promise<LIDMappingEntry[]>;
+/**
+ * Check if a JID is in LID format
+ *
+ * @param jid - The JID to check
+ * @returns boolean - True if the JID is in LID format
+ *
+ * @example
+ * ```typescript
+ * if (whatsapp.isLIDFormat("1524746986546@lid")) {
+ *   console.log("This is an LID");
+ * }
+ * ```
+ */
+export declare const isLIDFormat: (jid: string) => boolean;
+/**
+ * Check if a JID is in Phone Number format (@s.whatsapp.net)
+ *
+ * @param jid - The JID to check
+ * @returns boolean - True if the JID is in PN format
+ *
+ * @example
+ * ```typescript
+ * if (whatsapp.isPNFormat("6281234567890@s.whatsapp.net")) {
+ *   console.log("This is a phone number JID");
+ * }
+ * ```
+ */
+export declare const isPNFormat: (jid: string) => boolean;
+/**
+ * Smart convert any JID to phone number
+ *
+ * Automatically detects if the input is an LID and converts it to PN,
+ * or returns the PN if already in PN format.
+ *
+ * @param sessionId - Session ID to use for conversion
+ * @param jid - Any JID (LID or PN format)
+ * @returns Promise<string | null> - Phone number or null if conversion failed
+ *
+ * @example
+ * ```typescript
+ * const pn = await whatsapp.toPhoneNumber("mysession", jid);
+ * if (pn) {
+ *   console.log(`Phone number: ${pn}`);
+ * }
+ * ```
+ */
+export declare const toPhoneNumber: (sessionId: string, jid: string) => Promise<string | null>;
+/**
+ * Smart convert any JID to LID
+ *
+ * Automatically detects if the input is a PN and converts it to LID,
+ * or returns the LID if already in LID format.
+ *
+ * @param sessionId - Session ID to use for conversion
+ * @param jid - Any JID (LID or PN format)
+ * @returns Promise<string | null> - LID or null if conversion failed
+ *
+ * @example
+ * ```typescript
+ * const lid = await whatsapp.toLID("mysession", "6281234567890@s.whatsapp.net");
+ * if (lid) {
+ *   console.log(`LID: ${lid}`);
+ * }
+ * ```
+ */
+export declare const toLID: (sessionId: string, jid: string) => Promise<string | null>;
 //# sourceMappingURL=index.d.ts.map

package/dist/Socket/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/Socket/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/Socket/index.ts"],"names":[],"mappings":"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"}

package/dist/Socket/index.js

@@ -7,7 +7,7 @@ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, ge
         step((generator = generator.apply(thisArg, _arguments || [])).next());
     });
 };
-import makeWASocket, { Browsers, DisconnectReason, fetchLatestBaileysVersion, } from "baileys";
+import makeWASocket, { Browsers, DisconnectReason, fetchLatestBaileysVersion, jidNormalizedUser } from "baileys";
 import path from "path";
 import fs from "fs";
 import QRCode from "qrcode";
@@ -21,6 +21,32 @@ import { MongoClient } from "mongodb";
 import { useMongoAuthState } from "../Utils/mongo-auth-state.js";
 import { createDelay } from "../Utils/create-delay.js";
 const sessions = new Map();
+/**
+ * Helper function to generate browser configuration based on type and name
+ * @param browserType - Browser type (ubuntu, macOS, windows, appropriate)
+ * @param browserName - Custom browser/app name
+ * @returns Browser configuration tuple for Baileys
+ */
+const getBrowserConfig = (browserType = "ubuntu", browserName = "Chrome") => {
+    let browserTuple;
+    switch (browserType) {
+        case "macOS":
+            browserTuple = Browsers.macOS(browserName);
+            break;
+        case "windows":
+            browserTuple = Browsers.windows(browserName);
+            break;
+        case "appropriate":
+            browserTuple = Browsers.appropriate(browserName);
+            break;
+        case "ubuntu":
+        default:
+            browserTuple = Browsers.ubuntu(browserName);
+            break;
+    }
+    // Convert readonly tuple to mutable tuple for Baileys compatibility
+    return [...browserTuple];
+};
 const callback = new Map();
 const retryCount = new Map();
 // Tambahkan Map untuk melacak session yang menggunakan pairing code
@@ -85,7 +111,7 @@ export const startSession = (...args_1) => __awaiter(void 0, [...args_1], void 0
             auth: state,
             logger: P,
             markOnlineOnConnect: false,
-            browser: Browsers.ubuntu("Chrome"),
+            browser: getBrowserConfig(options.browserType, options.browserName),
             // Configure caching group metadata using our hybrid implementation with session ID
             cachedGroupMetadata: (jid) => __awaiter(void 0, void 0, void 0, function* () {
                 return yield groupCache.get(sessionId, jid);
@@ -94,7 +120,7 @@ export const startSession = (...args_1) => __awaiter(void 0, [...args_1], void 0
         sessions.set(sessionId, Object.assign({}, sock));
         try {
             sock.ev.process((events) => __awaiter(void 0, void 0, void 0, function* () {
-                var _a, _b, _c, _d, _e, _f, _g, _h, _j, _k, _l, _m, _o, _p, _q, _r;
+                var _a, _b, _c, _d, _e, _f, _g, _h, _j, _k, _l, _m, _o, _p, _q, _r, _s, _t, _u, _v;
                 if (events["connection.update"]) {
                     const update = events["connection.update"];
                     const { connection, lastDisconnect } = update;
@@ -202,12 +228,19 @@ export const startSession = (...args_1) => __awaiter(void 0, [...args_1], void 0
                         }
                         const msg = rawMsg;
                         msg.sessionId = sessionId;
+                        // Get normalized sender phone number using toPhoneNumber
+                        // For group messages, sender is in 'participant', for personal chats it's in 'remoteJid'
+                        const isGroup = ((_r = (_q = msg.key) === null || _q === void 0 ? void 0 : _q.remoteJid) === null || _r === void 0 ? void 0 : _r.endsWith('@g.us')) || false;
+                        const senderJid = isGroup
+                            ? (((_s = msg.key) === null || _s === void 0 ? void 0 : _s.participant) || '')
+                            : (((_t = msg.key) === null || _t === void 0 ? void 0 : _t.remoteJid) || '');
+                        msg.sender = yield toPhoneNumber(sessionId, senderJid);
                         msg.saveImage = (path) => saveImageHandler(msg, path);
                         msg.saveVideo = (path) => saveVideoHandler(msg, path);
                         msg.saveDocument = (path) => saveDocumentHandler(msg, path);
                         msg.saveAudio = (path) => saveAudioHandler(msg, path);
-                        (_q = callback.get(CALLBACK_KEY.ON_MESSAGE_RECEIVED)) === null || _q === void 0 ? void 0 : _q(Object.assign({}, msg));
-                        (_r = options.onMessageReceived) === null || _r === void 0 ? void 0 : _r.call(options, msg);
+                        (_u = callback.get(CALLBACK_KEY.ON_MESSAGE_RECEIVED)) === null || _u === void 0 ? void 0 : _u(Object.assign({}, msg));
+                        (_v = options.onMessageReceived) === null || _v === void 0 ? void 0 : _v.call(options, msg);
                     }
                 }
             }));
@@ -244,7 +277,7 @@ export const startSessionWithPairingCode = (sessionId_1, phoneNumber_1, ...args_
             auth: state,
             logger: P,
             markOnlineOnConnect: false,
-            browser: Browsers.ubuntu("Chrome"),
+            browser: getBrowserConfig(options.browserType, options.browserName),
             // Opsi tambahan untuk meningkatkan kompatibilitas
             linkPreviewImageThumbnailWidth: 300,
             generateHighQualityLinkPreview: true,
@@ -284,7 +317,7 @@ export const startSessionWithPairingCode = (sessionId_1, phoneNumber_1, ...args_
                 }
             }
             sock.ev.process((events) => __awaiter(void 0, void 0, void 0, function* () {
-                var _a, _b, _c, _d, _e, _f, _g, _h, _j, _k, _l, _m, _o, _p, _q;
+                var _a, _b, _c, _d, _e, _f, _g, _h, _j, _k, _l, _m, _o, _p, _q, _r, _s, _t, _u;
                 if (events["connection.update"]) {
                     const update = events["connection.update"];
                     const { connection, lastDisconnect } = update;
@@ -404,12 +437,19 @@ export const startSessionWithPairingCode = (sessionId_1, phoneNumber_1, ...args_
                         }
                         const msg = rawMsg;
                         msg.sessionId = sessionId;
+                        // Get normalized sender phone number using toPhoneNumber
+                        // For group messages, sender is in 'participant', for personal chats it's in 'remoteJid'
+                        const isGroup = ((_q = (_p = msg.key) === null || _p === void 0 ? void 0 : _p.remoteJid) === null || _q === void 0 ? void 0 : _q.endsWith('@g.us')) || false;
+                        const senderJid = isGroup
+                            ? (((_r = msg.key) === null || _r === void 0 ? void 0 : _r.participant) || '')
+                            : (((_s = msg.key) === null || _s === void 0 ? void 0 : _s.remoteJid) || '');
+                        msg.sender = yield toPhoneNumber(sessionId, senderJid);
                         msg.saveImage = (path) => saveImageHandler(msg, path);
                         msg.saveVideo = (path) => saveVideoHandler(msg, path);
                         msg.saveDocument = (path) => saveDocumentHandler(msg, path);
                         msg.saveAudio = (path) => saveAudioHandler(msg, path);
-                        (_p = callback.get(CALLBACK_KEY.ON_MESSAGE_RECEIVED)) === null || _p === void 0 ? void 0 : _p(Object.assign({}, msg));
-                        (_q = options.onMessageReceived) === null || _q === void 0 ? void 0 : _q.call(options, msg);
+                        (_t = callback.get(CALLBACK_KEY.ON_MESSAGE_RECEIVED)) === null || _t === void 0 ? void 0 : _t(Object.assign({}, msg));
+                        (_u = options.onMessageReceived) === null || _u === void 0 ? void 0 : _u.call(options, msg);
                     }
                 }
             }));
@@ -806,3 +846,316 @@ export const clearSessionGroupMetadataCache = (sessionId) => __awaiter(void 0, v
 export const clearAllGroupMetadataCache = () => {
     groupCache.flush();
 };
+/**
+ * Convert LID (Linked ID) to Phone Number (PN/JID)
+ *
+ * This function uses Baileys' internal signalRepository.lidMapping to retrieve
+ * the phone number associated with a given LID.
+ *
+ * @param sessionId - Session ID to use for conversion
+ * @param lid - The LID to convert (e.g., "1524746986546@lid")
+ * @returns Promise<LIDConversionResult> - Result object with the phone number or null if not found
+ *
+ * @example
+ * ```typescript
+ * const result = await whatsapp.getPNForLID("mysession", "1524746986546@lid");
+ * if (result.success && result.pn) {
+ *   console.log(`Phone number: ${result.pn}`);
+ * } else {
+ *   console.log("Phone number not found for this LID");
+ * }
+ * ```
+ *
+ * @note This function may return null for new contacts or when WhatsApp
+ * hasn't provided the LID-PN mapping yet. Not all LIDs have known phone numbers.
+ */
+export const getPNForLID = (sessionId, lid) => __awaiter(void 0, void 0, void 0, function* () {
+    var _a, _b;
+    const session = getSession(sessionId);
+    if (!session) {
+        return {
+            success: false,
+            lid,
+            pn: null,
+            error: Messages.sessionNotFound(sessionId)
+        };
+    }
+    try {
+        // Normalize LID format
+        let normalizedLid = lid;
+        if (!lid.includes('@lid')) {
+            normalizedLid = `${lid}@lid`;
+        }
+        // Access the signalRepository.lidMapping to get PN for LID
+        const signalRepo = session.signalRepository;
+        if (!signalRepo || !signalRepo.lidMapping) {
+            return {
+                success: false,
+                lid: normalizedLid,
+                pn: null,
+                error: "LID mapping not available in this session"
+            };
+        }
+        // Try to get the phone number for the LID (getPNForLID is async!)
+        const pn = (yield ((_b = (_a = signalRepo.lidMapping).getPNForLID) === null || _b === void 0 ? void 0 : _b.call(_a, normalizedLid))) || null;
+        return {
+            success: pn !== null,
+            lid: normalizedLid,
+            pn
+        };
+    }
+    catch (error) {
+        return {
+            success: false,
+            lid,
+            pn: null,
+            error: `Failed to convert LID to PN: ${error.message || String(error)}`
+        };
+    }
+});
+/**
+ * Convert Phone Number (PN/JID) to LID (Linked ID)
+ *
+ * This function uses Baileys' internal signalRepository.lidMapping to retrieve
+ * the LID associated with a given phone number.
+ *
+ * @param sessionId - Session ID to use for conversion
+ * @param pn - The phone number/JID to convert (e.g., "6281234567890" or "6281234567890@s.whatsapp.net")
+ * @returns Promise<PNConversionResult> - Result object with the LID or null if not found
+ *
+ * @example
+ * ```typescript
+ * const result = await whatsapp.getLIDForPN("mysession", "6281234567890");
+ * if (result.success && result.lid) {
+ *   console.log(`LID: ${result.lid}`);
+ * } else {
+ *   console.log("LID not found for this phone number");
+ * }
+ * ```
+ *
+ * @note This function may return null for contacts that haven't been encountered
+ * with their LID mapping yet.
+ */
+export const getLIDForPN = (sessionId, pn) => __awaiter(void 0, void 0, void 0, function* () {
+    var _a, _b;
+    const session = getSession(sessionId);
+    if (!session) {
+        return {
+            success: false,
+            pn,
+            lid: null,
+            error: Messages.sessionNotFound(sessionId)
+        };
+    }
+    try {
+        // Normalize PN format
+        let normalizedPn = pn.replace(/\D/g, ''); // Remove non-digits
+        if (!pn.includes('@s.whatsapp.net')) {
+            normalizedPn = `${normalizedPn}@s.whatsapp.net`;
+        }
+        else {
+            normalizedPn = pn;
+        }
+        // Access the signalRepository.lidMapping to get LID for PN
+        const signalRepo = session.signalRepository;
+        if (!signalRepo || !signalRepo.lidMapping) {
+            return {
+                success: false,
+                pn: normalizedPn,
+                lid: null,
+                error: "LID mapping not available in this session"
+            };
+        }
+        // Try to get the LID for the phone number
+        const lid = ((_b = (_a = signalRepo.lidMapping).getLIDForPN) === null || _b === void 0 ? void 0 : _b.call(_a, normalizedPn)) || null;
+        return {
+            success: lid !== null,
+            pn: normalizedPn,
+            lid
+        };
+    }
+    catch (error) {
+        return {
+            success: false,
+            pn,
+            lid: null,
+            error: `Failed to convert PN to LID: ${error.message || String(error)}`
+        };
+    }
+});
+/**
+ * Get all known LID-PN mappings for a session
+ *
+ * This function retrieves all LID to phone number mappings that are currently
+ * stored in the session's signal repository.
+ *
+ * @param sessionId - Session ID to get mappings from
+ * @returns Promise<LIDMappingEntry[]> - Array of LID-PN mapping entries
+ *
+ * @example
+ * ```typescript
+ * const mappings = await whatsapp.getAllLIDMappings("mysession");
+ * for (const mapping of mappings) {
+ *   console.log(`${mapping.lid} => ${mapping.pn}`);
+ * }
+ * ```
+ *
+ * @note This may return an empty array if no mappings are available yet.
+ */
+export const getAllLIDMappings = (sessionId) => __awaiter(void 0, void 0, void 0, function* () {
+    const session = getSession(sessionId);
+    if (!session) {
+        throw new WhatsappError(Messages.sessionNotFound(sessionId));
+    }
+    try {
+        const signalRepo = session.signalRepository;
+        if (!signalRepo || !signalRepo.lidMapping) {
+            return [];
+        }
+        // Try to get all mappings if available
+        const getAllMappings = signalRepo.lidMapping.getAll || signalRepo.lidMapping.getAllMappings;
+        if (typeof getAllMappings === 'function') {
+            const mappings = getAllMappings();
+            if (Array.isArray(mappings)) {
+                return mappings;
+            }
+            // If it's a Map or Object, convert to array
+            if (mappings instanceof Map) {
+                return Array.from(mappings.entries()).map(([lid, pn]) => ({ lid, pn: pn }));
+            }
+            if (typeof mappings === 'object') {
+                return Object.entries(mappings).map(([lid, pn]) => ({ lid, pn: pn }));
+            }
+        }
+        // Alternative: Try to access internal store directly
+        const store = signalRepo.lidMapping.store || signalRepo.lidMapping._store;
+        if (store) {
+            if (store instanceof Map) {
+                return Array.from(store.entries()).map(([lid, pn]) => ({ lid, pn: pn }));
+            }
+            if (typeof store === 'object') {
+                return Object.entries(store).map(([lid, pn]) => ({ lid, pn: pn }));
+            }
+        }
+        return [];
+    }
+    catch (error) {
+        throw new WhatsappError(`Failed to get LID mappings: ${error.message || String(error)}`);
+    }
+});
+/**
+ * Check if a JID is in LID format
+ *
+ * @param jid - The JID to check
+ * @returns boolean - True if the JID is in LID format
+ *
+ * @example
+ * ```typescript
+ * if (whatsapp.isLIDFormat("1524746986546@lid")) {
+ *   console.log("This is an LID");
+ * }
+ * ```
+ */
+export const isLIDFormat = (jid) => {
+    return jid.includes('@lid');
+};
+/**
+ * Check if a JID is in Phone Number format (@s.whatsapp.net)
+ *
+ * @param jid - The JID to check
+ * @returns boolean - True if the JID is in PN format
+ *
+ * @example
+ * ```typescript
+ * if (whatsapp.isPNFormat("6281234567890@s.whatsapp.net")) {
+ *   console.log("This is a phone number JID");
+ * }
+ * ```
+ */
+export const isPNFormat = (jid) => {
+    return jid.includes('@s.whatsapp.net');
+};
+/**
+ * Smart convert any JID to phone number
+ *
+ * Automatically detects if the input is an LID and converts it to PN,
+ * or returns the PN if already in PN format.
+ *
+ * @param sessionId - Session ID to use for conversion
+ * @param jid - Any JID (LID or PN format)
+ * @returns Promise<string | null> - Phone number or null if conversion failed
+ *
+ * @example
+ * ```typescript
+ * const pn = await whatsapp.toPhoneNumber("mysession", jid);
+ * if (pn) {
+ *   console.log(`Phone number: ${pn}`);
+ * }
+ * ```
+ */
+export const toPhoneNumber = (sessionId, jid) => __awaiter(void 0, void 0, void 0, function* () {
+    // Handle null/undefined input
+    if (!jid) {
+        return null;
+    }
+    // If it's a group or broadcast, return null
+    if (jid.includes('@g.us') || jid.includes('@broadcast')) {
+        return null;
+    }
+    // If already in PN format, use jidNormalizedUser to remove device ID
+    if (isPNFormat(jid)) {
+        // Use jidNormalizedUser to normalize and remove device ID (e.g., :0, :1)
+        const normalized = jidNormalizedUser(jid);
+        return normalized || jid; // Fallback to original if normalization fails
+    }
+    // If it's an LID, try to convert
+    if (isLIDFormat(jid)) {
+        const lidResult = yield getPNForLID(sessionId, jid);
+        if (lidResult.pn) {
+            // Use jidNormalizedUser to normalize the result and remove device ID
+            const normalized = jidNormalizedUser(lidResult.pn);
+            return normalized || lidResult.pn; // Fallback to original if normalization fails
+        }
+        return null;
+    }
+    // If it's just a number, format it as PN (no device ID needed)
+    const phoneNumber = jid.replace(/\D/g, '');
+    if (phoneNumber.length >= 10) {
+        return `${phoneNumber}@s.whatsapp.net`;
+    }
+    return null;
+});
+/**
+ * Smart convert any JID to LID
+ *
+ * Automatically detects if the input is a PN and converts it to LID,
+ * or returns the LID if already in LID format.
+ *
+ * @param sessionId - Session ID to use for conversion
+ * @param jid - Any JID (LID or PN format)
+ * @returns Promise<string | null> - LID or null if conversion failed
+ *
+ * @example
+ * ```typescript
+ * const lid = await whatsapp.toLID("mysession", "6281234567890@s.whatsapp.net");
+ * if (lid) {
+ *   console.log(`LID: ${lid}`);
+ * }
+ * ```
+ */
+export const toLID = (sessionId, jid) => __awaiter(void 0, void 0, void 0, function* () {
+    // If already in LID format, return as-is
+    if (isLIDFormat(jid)) {
+        return jid;
+    }
+    // If it's a PN, try to convert
+    if (isPNFormat(jid) || /^\d+$/.test(jid.replace(/\D/g, ''))) {
+        const result = yield getLIDForPN(sessionId, jid);
+        return result.lid;
+    }
+    // If it's a group or broadcast, return null
+    if (jid.includes('@g.us') || jid.includes('@broadcast')) {
+        return null;
+    }
+    return null;
+});

package/dist/Types/index.d.ts

@@ -1,4 +1,12 @@
 import { WAMessageUpdate, proto } from "baileys";
+/**
+ * Supported browser types for WhatsApp connection
+ * - ubuntu: Uses Ubuntu browser agent (default)
+ * - macOS: Uses macOS browser agent
+ * - windows: Uses Windows browser agent
+ * - appropriate: Uses appropriate browser based on platform
+ */
+export type BrowserType = "ubuntu" | "macOS" | "windows" | "appropriate";
 export interface SendMessageTypes {
     to: string | number;
     text?: string;
@@ -27,6 +35,11 @@ export interface MessageReceived extends proto.IWebMessageInfo {
      * Your Session ID
      */
     sessionId: string;
+    /**
+     * Sender's phone number in normalized format (without device ID)
+     * @example "6281234567890@s.whatsapp.net"
+     */
+    sender: string | null;
     /**
      * @param path save image location path with extension
      * @example "./myimage.jpg"
@@ -53,6 +66,19 @@ export interface StartSessionParams {
      * Print QR Code into Terminal
      */
     printQR?: boolean;
+    /**
+     * Browser type for WhatsApp connection
+     * Options: "ubuntu" (default), "macOS", "windows", "appropriate"
+     * @default "ubuntu"
+     */
+    browserType?: BrowserType;
+    /**
+     * Custom browser/app name displayed in WhatsApp
+     * This name will appear in "Linked Devices" on your phone
+     * @default "Chrome"
+     * @example "My Bot App"
+     */
+    browserName?: string;
     onQRUpdated?: (qr: string) => void;
     onConnected?: () => void;
     onConnecting?: () => void;

package/dist/Types/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/Types/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AAEjD,MAAM,WAAW,gBAAgB;IAC/B,EAAE,EAAE,MAAM,GAAG,MAAM,CAAC;IACpB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,SAAS,CAAC,EAAE,KAAK,CAAC,eAAe,CAAC;CACnC;AAED,MAAM,WAAW,2BAA4B,SAAQ,gBAAgB;IACnE,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;CACrB;AAED,MAAM,WAAW,cAAe,SAAQ,gBAAgB;IACtD,KAAK,EAAE,MAAM,GAAG,MAAM,CAAC;IACvB,IAAI,EAAE,OAAO,GAAG,OAAO,GAAG,OAAO,GAAG,KAAK,GAAG,KAAK,GAAG,MAAM,GAAG,KAAK,GAAG,MAAM,GAAG,KAAK,GAAG,KAAK,CAAC;IAC5F,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,eAAgB,SAAQ,gBAAgB;IACvD,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,aAAa;IAC5B,SAAS,EAAE,MAAM,CAAC;IAClB,GAAG,EAAE,KAAK,CAAC,WAAW,CAAC;CACxB;AAED,MAAM,WAAW,eAAgB,SAAQ,KAAK,CAAC,eAAe;IAC5D;;OAEG;IACH,SAAS,EAAE,MAAM,CAAC;IAElB;;;OAGG;IACH,SAAS,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAC3C;;;OAGG;IACH,SAAS,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAC3C;;;OAGG;IACH,SAAS,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAC3C;;;OAGG;IACH,YAAY,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;CAC/C;AAED,MAAM,WAAW,kBAAkB;IACjC;;OAEG;IACH,OAAO,CAAC,EAAE,OAAO,CAAC;IAGlB,WAAW,CAAC,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,IAAI,CAAC;IACnC,WAAW,CAAC,EAAE,MAAM,IAAI,CAAC;IACzB,YAAY,CAAC,EAAE,MAAM,IAAI,CAAC;IAC1B,cAAc,CAAC,EAAE,MAAM,IAAI,CAAC;IAC5B,aAAa,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IAGvC,iBAAiB,CAAC,EAAE,CAAC,OAAO,EAAE,eAAe,KAAK,IAAI,CAAC;IACvD,gBAAgB,CAAC,EAAE,CAAC,OAAO,EAAE,cAAc,KAAK,IAAI,CAAC;CACtD;AAED,MAAM,WAAW,iCAAiC;IAChD;;OAEG;IACH,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,MAAM,cAAc,GAAG,eAAe,GAAG;IAC7C,SAAS,EAAE,MAAM,CAAC;IAClB,aAAa,EACT,OAAO,GACP,SAAS,GACT,QAAQ,GACR,WAAW,GACX,MAAM,GACN,QAAQ,CAAC;CACd,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/Types/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AAEjD;;;;;;GAMG;AACH,MAAM,MAAM,WAAW,GAAG,QAAQ,GAAG,OAAO,GAAG,SAAS,GAAG,aAAa,CAAC;AAEzE,MAAM,WAAW,gBAAgB;IAC/B,EAAE,EAAE,MAAM,GAAG,MAAM,CAAC;IACpB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,SAAS,CAAC,EAAE,KAAK,CAAC,eAAe,CAAC;CACnC;AAED,MAAM,WAAW,2BAA4B,SAAQ,gBAAgB;IACnE,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;CACrB;AAED,MAAM,WAAW,cAAe,SAAQ,gBAAgB;IACtD,KAAK,EAAE,MAAM,GAAG,MAAM,CAAC;IACvB,IAAI,EAAE,OAAO,GAAG,OAAO,GAAG,OAAO,GAAG,KAAK,GAAG,KAAK,GAAG,MAAM,GAAG,KAAK,GAAG,MAAM,GAAG,KAAK,GAAG,KAAK,CAAC;IAC5F,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,eAAgB,SAAQ,gBAAgB;IACvD,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,aAAa;IAC5B,SAAS,EAAE,MAAM,CAAC;IAClB,GAAG,EAAE,KAAK,CAAC,WAAW,CAAC;CACxB;AAED,MAAM,WAAW,eAAgB,SAAQ,KAAK,CAAC,eAAe;IAC5D;;OAEG;IACH,SAAS,EAAE,MAAM,CAAC;IAElB;;;OAGG;IACH,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IAEtB;;;OAGG;IACH,SAAS,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAC3C;;;OAGG;IACH,SAAS,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAC3C;;;OAGG;IACH,SAAS,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAC3C;;;OAGG;IACH,YAAY,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;CAC/C;AAED,MAAM,WAAW,kBAAkB;IACjC;;OAEG;IACH,OAAO,CAAC,EAAE,OAAO,CAAC;IAElB;;;;OAIG;IACH,WAAW,CAAC,EAAE,WAAW,CAAC;IAE1B;;;;;OAKG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IAGrB,WAAW,CAAC,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,IAAI,CAAC;IACnC,WAAW,CAAC,EAAE,MAAM,IAAI,CAAC;IACzB,YAAY,CAAC,EAAE,MAAM,IAAI,CAAC;IAC1B,cAAc,CAAC,EAAE,MAAM,IAAI,CAAC;IAC5B,aAAa,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IAGvC,iBAAiB,CAAC,EAAE,CAAC,OAAO,EAAE,eAAe,KAAK,IAAI,CAAC;IACvD,gBAAgB,CAAC,EAAE,CAAC,OAAO,EAAE,cAAc,KAAK,IAAI,CAAC;CACtD;AAED,MAAM,WAAW,iCAAiC;IAChD;;OAEG;IACH,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,MAAM,cAAc,GAAG,eAAe,GAAG;IAC7C,SAAS,EAAE,MAAM,CAAC;IAClB,aAAa,EACX,OAAO,GACP,SAAS,GACT,QAAQ,GACR,WAAW,GACX,MAAM,GACN,QAAQ,CAAC;CACZ,CAAC"}