wa-multi-mongodb 3.10.2 → 3.10.4

package/dist/cjs/Profile/index.d.ts

@@ -0,0 +1,9 @@
+import { GetProfileInfoProps } from "../Types/profile";
+/**
+ * Get profile information of a target (people or group)
+ */
+export declare const getProfileInfo: (props: GetProfileInfoProps) => Promise<{
+    profilePictureUrl: string;
+    status: import("baileys").USyncQueryResultList[];
+}>;
+//# sourceMappingURL=index.d.ts.map

package/dist/cjs/Profile/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/Profile/index.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AAEvD;;GAEG;AACH,eAAO,MAAM,cAAc,GAAU,OAAO,mBAAmB;;;EAgB9D,CAAC"}

package/dist/cjs/Profile/index.js

@@ -0,0 +1,34 @@
+"use strict";
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getProfileInfo = void 0;
+const Defaults_1 = require("../Defaults");
+const Error_1 = require("../Error");
+const Socket_1 = require("../Socket");
+/**
+ * Get profile information of a target (people or group)
+ */
+const getProfileInfo = (props) => __awaiter(void 0, void 0, void 0, function* () {
+    const session = (0, Socket_1.getSession)(props.sessionId);
+    if (!session)
+        throw new Error_1.WhatsappError(Defaults_1.Messages.sessionNotFound(props.sessionId));
+    const [profilePictureUrl, status] = yield Promise.allSettled([
+        session.profilePictureUrl(props.target, "image", 5000),
+        session.fetchStatus(props.target),
+    ]);
+    return {
+        profilePictureUrl: profilePictureUrl.status === "fulfilled"
+            ? profilePictureUrl.value || null
+            : null,
+        status: status.status === "fulfilled" ? status.value || null : null,
+    };
+});
+exports.getProfileInfo = getProfileInfo;

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

@@ -0,0 +1,264 @@
+import { WASocket } from "baileys";
+import type { MessageReceived, MessageUpdated, StartSessionParams } from "../Types";
+/**
+ * Set MongoDB URI for connection
+ * This function will be used to configure MongoDB connection with just the URI
+ *
+ * @param uri MongoDB connection URI
+ */
+export declare const setMongoURI: (uri: string) => Promise<void>;
+export declare function setMongoCollection(collection: any): void;
+export declare const startSession: (sessionId?: string, options?: StartSessionParams) => Promise<WASocket>;
+/**
+ * Start WhatsApp session using pairing code method
+ * This is the recommended way to create sessions with pairing code
+ *
+ * @param sessionId Unique session identifier
+ * @param phoneNumber Phone number with country code (without + prefix)
+ * @param options Optional configuration for the session
+ * @returns Promise<WASocket> The WhatsApp socket instance
+ */
+export declare const startSessionWithPairingCode: (sessionId: string, phoneNumber: string, options?: StartSessionParams) => Promise<WASocket>;
+/**
+ * @deprecated Use startSession method instead
+ */
+export declare const startWhatsapp: (sessionId?: string, options?: StartSessionParams) => Promise<WASocket>;
+export declare const deleteSession: (sessionId: string) => Promise<void>;
+/**
+ * Get all active session IDs
+ * @returns Array of session IDs
+ */
+export declare const getAllSession: () => Promise<string[]>;
+export declare const getAllSessionSync: () => string[];
+export declare const getSession: (key: string) => WASocket | undefined;
+/**
+ * @deprecated Use loadSessionsFromMongo instead
+ */
+export declare const loadSessionsFromStorage: () => void;
+export declare const onMessageReceived: (listener: (msg: MessageReceived) => any) => void;
+export declare const onQRUpdated: (listener: ({ sessionId, qr }: {
+    sessionId: string;
+    qr: string;
+}) => any) => void;
+export declare const onConnected: (listener: (sessionId: string) => any) => void;
+export declare const onDisconnected: (listener: (sessionId: string) => any) => void;
+export declare const onConnecting: (listener: (sessionId: string) => any) => void;
+export declare const onMessageUpdate: (listener: (data: MessageUpdated) => any) => void;
+export declare const onPairingCode: (listener: (sessionId: string, code: string) => any) => void;
+/**
+ * Load all sessions from MongoDB and start them automatically
+ */
+export declare const loadSessionsFromMongo: () => Promise<void>;
+/**
+ * Configure MongoDB database and collection names
+ *
+ * @param dbName MongoDB database name (default: "wa_session")
+ * @param collectionName MongoDB collection name for auth storage (default: "auth")
+ */
+export declare const setMongoDBNames: (dbName?: string, collectionName?: string) => void;
+/**
+ * Sets the directory name for storing credentials (File-based storage)
+ *
+ * @deprecated When using MongoDB, this setting has no effect. Only used for legacy file-based storage.
+ * @param dirname Directory name for storing credentials (default: "wa_credentials")
+ */
+export declare const setCredentialsDir: (dirname?: string) => void;
+/**
+ * Attempt to reconnect a disconnected session
+ *
+ * @param sessionId Session ID to reconnect
+ * @returns Promise<boolean> indicating success
+ */
+export declare const reconnect: (sessionId: string) => Promise<boolean>;
+/**
+ * Reconnect all pairing code sessions that are tracked
+ * Useful for bulk reconnection after system restart
+ */
+export declare const reconnectAllPairingCodeSessions: () => Promise<{
+    [sessionId: string]: boolean;
+}>;
+/**
+ * Get all tracked pairing code sessions
+ * @returns Array of session IDs that were created with pairing code
+ */
+export declare const getPairingCodeSessions: () => string[];
+/**
+ * Get session status information
+ * @param sessionId Session ID to check
+ * @returns Object with session status information
+ */
+export declare const getSessionStatus: (sessionId: string) => {
+    sessionId: string;
+    isRunning: boolean;
+    isPairingCodeSession: boolean;
+    retryAttempts: number;
+    hasCredentials: boolean;
+};
+export declare const setGroupCacheConfig: (options: {
+    stdTTL?: number;
+    checkperiod?: number;
+}) => void;
+export declare const getGroupMetadata: (sessionId: string, jid: string, forceFetch?: boolean) => Promise<any>;
+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/cjs/Socket/index.d.ts.map

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