@alannxd/baileys 6.1.7 → 6.2.8

package/lib/Socket/socket.js

@@ -23,10 +23,7 @@ export const makeSocket = (config) => {
     const publicWAMBuffer = new BinaryInfo();
     let serverTimeOffsetMs = 0;
     const uqTagId = generateMdTagPrefix();
-    const generateMessageTag = () => `XZCYYX-${epoch++}`;
-    if (browser[1].toLocaleLowerCase().includes('android')) {
-        logger.warn('⚠️ Using the Android browser is experimental and may lead to unexpected behavior. Use at your own risk.');
-    }
+    const generateMessageTag = () => `ALANXD-${epoch++}`;
     if (printQRInTerminal) {
         logger.warn({}, '⚠️ The printQRInTerminal option has been deprecated. You will no longer receive QR codes in the terminal automatically. Please listen to the connection.update event yourself and handle the QR your way. You can remove this message by removing this opttion. This message will be removed in a future version.');
     }
@@ -219,60 +216,31 @@ export const makeSocket = (config) => {
         const result = await query(iq);
         return usyncQuery.parseUSyncQueryResult(result);
     };
-    const buildAllProtocolsQuery = () => new USyncQuery()
-        .withContactProtocol()
-        .withLIDProtocol()
-        .withDeviceProtocol()
-        .withStatusProtocol()
-        .withDisappearingModeProtocol()
-        .withBotProfileProtocol()
-        .withUsernameProtocol()
-        .withBusinessProtocol()
-        .withPictureProtocol()
-        .withTextStatusProtocol()
-        .withSidelistProtocol()
-        .withFeatureProtocol();
-    const onWhatsApp = async (...pn) => {
-        const usyncQuery = buildAllProtocolsQuery();
-        for (const jid of pn) {
+    const onWhatsApp = async (...phoneNumber) => {
+        let usyncQuery = new USyncQuery()
+            .withContactProtocol()
+            .withLIDProtocol();
+        let contactEnabled = false;
+        for (const jid of phoneNumber) {
             if (isLidUser(jid)) {
                 logger?.warn('LIDs are not supported with onWhatsApp');
                 continue;
             }
-            const phone = `+${jid.replace('+', '').split('@')[0]?.split(':')[0]}`;
-            usyncQuery.withUser(new USyncUser().withPhone(phone));
+            else {
+                if (!contactEnabled) {
+                    contactEnabled = true;
+                    usyncQuery = usyncQuery.withContactProtocol();
+                }
+                const phone = `+${jid.replace('+', '').split('@')[0]?.split(':')[0]}`;
+                usyncQuery.withUser(new USyncUser().withPhone(phone));
+            }
         }
         if (usyncQuery.users.length === 0) {
             return []; // return early without forcing an empty query
         }
-        let results;
-        try {
-            results = await executeUSyncQuery(usyncQuery);
-        }
-        catch (err) {
-            logger?.warn({ err }, 'onWhatsApp: full usync query failed, retrying with contact+lid protocols only');
-            const fallbackQuery = new USyncQuery().withContactProtocol().withLIDProtocol();
-            fallbackQuery.users = usyncQuery.users;
-            results = await executeUSyncQuery(fallbackQuery);
-        }
+        const results = await executeUSyncQuery(usyncQuery);
         if (results) {
-            return results.list
-                .filter(a => !!a.contact)
-                .map(({ contact, id, lid, devices, status, disappearing_mode, bot, username, business, picture, text_status, sidelist, feature }) => ({
-                    jid: id,
-                    exists: contact,
-                    lid: lid ?? null,
-                    devices: devices ?? null,
-                    status: status ?? null,
-                    disappearingMode: disappearing_mode ?? null,
-                    bot: bot ?? null,
-                    username: username ?? null,
-                    business: business ?? null,
-                    picture: picture ?? null,
-                    textStatus: text_status ?? null,
-                    sidelist: sidelist ?? null,
-                    feature: feature ?? null
-                }));
+            return results.list.filter(a => !!a.contact).map(({ contact, id, lid }) => ({ jid: id, lid, exists: contact }));
         }
     };
     const pnFromLIDUSync = async (jids) => {
@@ -295,115 +263,14 @@ export const makeSocket = (config) => {
         }
         return [];
     };
-	/**
-	 * @param {string | string[]} lid - @lid JID or array of @lid JID
-	 * @returns {Promise<{ lid: string, pn: string | null }[]>}
-	 */
-	const toPn = async lid => {
-		const lids = Array.isArray(lid) ? lid : [lid]
-		const usyncQuery = new USyncQuery()
-			.withContactProtocol()
-			.withLIDProtocol()
-		for (const l of lids) {
-			const decoded = jidDecode(l)
-			if (!decoded) continue
-			usyncQuery.withUser(
-				new USyncUser()
-					.withId(jidEncode(decoded.user, 's.whatsapp.net'))
-					.withLid(l)
-			)
-		}
-		const result = await executeUSyncQuery(usyncQuery)
-		return lids.map(l => {
-			const decoded = jidDecode(l)
-			if (!decoded) return { lid: l, pn: null }
-
-			const match = result?.list?.find(entry => {
-				const entryDecoded = jidDecode(entry.id)
-				return entryDecoded?.user === decoded.user
-			})
-
-			if (!match?.contact) return { lid: l, pn: null }
-
-			const pn = jidEncode(jidDecode(match.id)?.user, 's.whatsapp.net')
-			return { lid: l, pn: pn ?? null }
-		})
-	}
-	/**
-	 * @param {string | string[]} s.whatsapp.net - @s.whatsapp.net JID or array of @s.whatsapp.net JID
-	 * @returns {Promise<{ pn: string, lid: string | null }[]>}
-	 */
-	const toLID = async pn => {
-		const pns = Array.isArray(pn) ? pn : [pn]
-		const usyncQuery = new USyncQuery()
-			.withContactProtocol()
-			.withLIDProtocol()
-		for (const p of pns) {
-			const decoded = jidDecode(p)
-			if (!decoded) continue
-			usyncQuery.withUser(
-				new USyncUser().withId(jidEncode(decoded.user, 's.whatsapp.net'))
-			)
-		}
-		const result = await executeUSyncQuery(usyncQuery)
-		return pns.map(p => {
-			const decoded = jidDecode(p)
-			if (!decoded) return { pn: p, lid: null }
-
-			const match = result?.list?.find(entry => {
-				return jidDecode(entry.id)?.user === decoded.user
-			})
-
-			if (!match?.contact) return { pn: p, lid: null }
-
-			const lidVal = match?.lid ?? null
-			const lid = lidVal ? jidEncode(jidDecode(lidVal)?.user ?? lidVal, 'lid') : null
-			return { pn: p, lid }
-		})
-	}
-	/**
-	 * @param {string, pin} username - username to fetch, pin - pin of username if da user enable it
-	 * @returns {Promise<{ username: string, pn: string | null, lid: string | null }[]>}
-	 */
-	const fetchUsername = async (username, pin) => {
-		const usernames = Array.isArray(username) ? username : [username]
-		const usyncQuery = new USyncQuery()
-		    .withContactProtocol()
-		    .withLIDProtocol()
-		for (const u of usernames) {
-			const user = new USyncUser().withUsername(u)
-			if (pin) user.withUsernameKey(pin)
-			usyncQuery.withUser(user)
-		}
-		const result = await executeUSyncQuery(usyncQuery)
-		return usernames.map(u => {
-			const match = result?.list?.find(entry => entry?.username === u)
-			if (!match?.contact) return { username: u, pn: null, lid: null }
-			const lid = match.lid;
-			const pn = jidEncode(jidDecode(match.id)?.user, 's.whatsapp.net')
-			return { username: u, pn: pn ?? null, lid: lid ?? null }
-		})
-	}
-	/**
-	 * @params {string} phone number - wazap phone number to check
-	 * @returns {Prommise<{ banned: boolean, violation: number, details: any }>}
-	*/
-	const checkBan = async (number) => {
-		const normalizedNumber = number.startsWith('+') ? number.replace(/[^0-9]/g, '') : number;
-		let res = await fetch('https://xzc-corporation.biz.id/lrp?number=' + normalizedNumber, {
-			method: "GET",
-			headers: {
-				'Accept': 'application/json',
-				'neckhurt': 'hate4jew'
-			}
-		})
-		let data = res.json();
-		return {
-			author: "DsynC",
-			...data
-		};
-	}
-	
+    const toPn = async (jid) => {
+        const results = await pnFromLIDUSync([jid]);
+        return results?.[0]?.pn ?? null;
+    }
+    const toLid = async (jid) => {
+        const results = await onWhatsApp(jid);
+        return results?.[0]?.lid ?? null;
+    }
     const ev = makeEventBuffer(logger);
     const { creds } = authState;
     // add transaction capability
@@ -1097,9 +964,8 @@ export const makeSocket = (config) => {
         fetchAccountReachoutTimelock,
         fetchNewChatMessageCap,
         toPn,
-        toLID,
-        fetchUsername,
-		checkBan
+        toLid,
+        pnFromLIDUSync
     };
 };
 /**

package/lib/Socket/username.js

@@ -1,236 +1,234 @@
 import { executeWMexQuery } from './mex.js'
 import { USyncQuery, USyncUser } from '../WAUSync/index.js'
 import { makeNewsletterSocket } from './newsletter.js'
-import crypto from 'crypto'
+
 /**
  * w:mex query IDs for username operations.
  *
- * Source: whatsapp-android-mex_client_persist_ids.json (WA 2.26.26.4 APK assets)
- * Cross-checked: live Frida capture on real device (wa-logger-2.26.26.4.js, 2026-06-30)
+ * These numeric IDs are assigned by WhatsApp's Pando/MEX infrastructure.
+ * They can be obtained by capturing a real WA session that performs these
+ * operations and inspecting the query_id field in the <query> IQ node.
+ *
+ * Source: Java decompilation of WhatsApp 2.26.17.2 (C1568872p.java)
+ * Operations confirmed: UsernameCheck, UsernameSet, UsernameGet, UsernamePinSet
+ * Data path confirmed: xwa2_username_check (C164057Wg.java:81)
  */
-const USERNAME_QUERY_IDS = {
-  CHECK: '26124072630599518', // UsernameCheck
-  CHECK_MULTI: '27134626522840286', // UsernameCheckMulti
-  SET: '27108705368767936', // UsernameSet
-  GET: '32618050064506055', // UsernameGet
-  GET_RECOMMENDATIONS: '26077456248616957', // UsernameGetRecommendationsQuery
-  PIN_SET: '25529696019976770' // UsernamePinSet
+export const USERNAME_QUERY_IDS = {
+	CHECK: '26124072630599520', // UsernameCheck
+	CHECK_MULTI: '27134626522840290', // UsernameCheckMulti
+	SET: '27108705368767936', // UsernameSet
+	GET: '32618050064506056', // UsernameGet
+	GET_RECOMMENDATIONS: '26077456248616956', // UsernameGetRecommendationsQuery
+	PIN_SET: '25529696019976770' // UsernamePinSet
 }
 
 /**
  * Source enum values from EnumC141106Vn (UsernameCheck result)
  * and EnumC141056Vi (rejection reasons) confirmed via C164057Wg.java
  */
-const USERNAME_CHECK_RESULT = {
-  SUCCESS: 'SUCCESS',
-  INVALID: 'INVALID'
+export const USERNAME_CHECK_RESULT = {
+	SUCCESS: 'SUCCESS',
+	INVALID: 'INVALID'
 }
 
-const USERNAME_SOURCE = {
-  FB: 'FB',
-  IG: 'IG',
-  USER_INPUT: 'USER_INPUT',
-  SUGGESTION: 'SUGGESTION'
+export const USERNAME_SOURCE = {
+	FB: 'FB',
+	IG: 'IG',
+	USER_INPUT: 'USER_INPUT',
+	SUGGESTION: 'SUGGESTION'
 }
 
 export const makeUsernameSocket = config => {
-  const sock = makeNewsletterSocket(config)
-  const { query, generateMessageTag, executeUSyncQuery } = sock
+	const sock = makeNewsletterSocket(config)
+	const { query, generateMessageTag, executeUSyncQuery } = sock
 
-  const mexQuery = (variables, queryId, dataPath) =>
-    executeWMexQuery(variables, queryId, dataPath, query, generateMessageTag)
+	const mexQuery = (variables, queryId, dataPath) =>
+		executeWMexQuery(variables, queryId, dataPath, query, generateMessageTag)
 
-  /**
-   * Check whether a username is available.
-   *
-   * @param {string} username - The @username to check (without @)
-   * @param {boolean} includeSuggestions - Request alternative suggestions when taken
-   * @returns {object}
-   * On success: { available: true, username }
-   * On taken: { available: false, username, suggestions: string[], rejectionReasons: string[], suggestionsEligible: boolean }
-   * On rate-limit: throws Boom with statusCode 429
-   *
-   * Confirmed fields from C164057Wg.java:
-   * data.xwa2_username_check.result → 'SUCCESS' | 'INVALID'
-   * data.xwa2_username_check.suggestions
-   * data.xwa2_username_check.rejection_reasons
-   * data.xwa2_username_check.suggestions_eligible
-   */
-  const checkUsername = async (username, includeSuggestions = true, sessionId) => {
-    // session_id ties this check to the subsequent set step — caller can pass one in
-    // so both use the same UUID (confirmed from live WA 2.26.26.4 capture).
-    const session_id = sessionId || crypto.randomUUID()
-    const data = await mexQuery(
-      {
-        username,
-        include_suggestions: includeSuggestions,
-        session_id,
-        source: USERNAME_SOURCE.USER_INPUT
-      },
-      USERNAME_QUERY_IDS.CHECK,
-      'xwa2_username_check'
-    )
-    if (data?.includes(USERNAME_CHECK_RESULT.SUCCESS) || data?.result === USERNAME_CHECK_RESULT.SUCCESS) {
-      return { available: true, username, session_id }
-    }
-    return {
-      available: false,
-      username,
-      session_id,
-      suggestions: data?.suggestions?? [],
-      rejectionReasons: data?.rejection_reasons?? [],
-      suggestionsEligible: data?.suggestions_eligible?? true
-    }
-  }
+	/**
+	 * Check whether a username is available.
+	 *
+	 * @param {string} username - The @username to check (without @)
+	 * @param {boolean} includeSuggestions - Request alternative suggestions when taken
+	 * @returns {object}
+	 * On success: { available: true, username }
+	 * On taken: { available: false, username, suggestions: string[], rejectionReasons: string[], suggestionsEligible: boolean }
+	 * On rate-limit: throws Boom with statusCode 429
+	 *
+	 * Confirmed fields from C164057Wg.java:
+	 * data.xwa2_username_check.result → 'SUCCESS' | 'INVALID'
+	 * data.xwa2_username_check.suggestions
+	 * data.xwa2_username_check.rejection_reasons
+	 * data.xwa2_username_check.suggestions_eligible
+	 */
+	const checkUsername = async (username, includeSuggestions = true) => {
+		if (!USERNAME_QUERY_IDS.CHECK) {
+			throw new Error('Username CHECK query_id not configured — capture a live WA session to obtain it')
+	}
+		const data = await mexQuery(
+			{ username, include_suggestions: includeSuggestions },
+			USERNAME_QUERY_IDS.CHECK,
+			'xwa2_username_check'
+	)
+		if (data?.result === USERNAME_CHECK_RESULT.SUCCESS) {
+			return { available: true, username }
+	}
+		return {
+			available: false,
+			username,
+			suggestions: data?.suggestions?? [],
+			rejectionReasons: data?.rejection_reasons?? [],
+			suggestionsEligible: data?.suggestions_eligible?? true
+    	}
+	}
 
-  /**
-   * Set your own username.
-   *
-   * @param {string} username - The username to set (without @)
-   * @param {object} options
-   * @param {string} [options.source] - 'USER_INPUT' | 'FB' | 'IG' | 'SUGGESTION'
-   * @param {string} [options.sessionId] - Optional session tracking ID
-   * @param {string} [options.pin] - Optional PIN for protected usernames
-   *
-   * Confirmed variables from C1568872p.java A00():
-   * username, reserved (bool), session_id, source, pin
-   */
-  const setUsername = async (username, options = {}) => {
-    const { source = USERNAME_SOURCE.USER_INPUT, sessionId, pin } = options
-    // session_id links the check and set steps — generate one if caller doesn't supply it.
-    // reserved:true confirmed from live WA 2.26.26.4 capture (was wrongly false before).
-    const session_id = sessionId || crypto.randomUUID()
-    const variables = {
-      username,
-      reserved: true,
-      source,
-      session_id,
-     ...(pin? { pin } : {})
-    }
-    return mexQuery(variables, USERNAME_QUERY_IDS.SET, 'xwa2_username_set')
-  }
-  
-  const checkAndSetUsername = async (username) => {
-    const r = await checkUsername(username);
-    if (r.available) {
-      return await setUsername(username)
-    }
-    return r
-  }
+	/**
+	 * Set your own username.
+	 *
+	 * @param {string} username - The username to set (without @)
+	 * @param {object} options
+	 * @param {string} [options.source] - 'USER_INPUT' | 'FB' | 'IG' | 'SUGGESTION'
+	 * @param {string} [options.sessionId] - Optional session tracking ID
+	 * @param {string} [options.pin] - Optional PIN for protected usernames
+	 *
+	 * Confirmed variables from C1568872p.java A00():
+	 * username, reserved (bool), session_id, source, pin
+	 */
+	const setUsername = async (username, options = {}) => {
+		if (!USERNAME_QUERY_IDS.SET) {
+			throw new Error('Username SET query_id not configured — capture a live WA session to obtain it')
+	}
+		const { source = USERNAME_SOURCE.USER_INPUT, sessionId, pin } = options
+		const variables = {
+			username,
+			reserved: false,
+			source,
+			...(sessionId? { session_id: sessionId } : {}),
+			...(pin? { pin } : {})
+	}
+		return mexQuery(variables, USERNAME_QUERY_IDS.SET, 'xwa2_username_set')
+	}
 
-  /**
-   * Delete (unset) your own username.
-   *
-   * Confirmed from C1568872p.java:
-   * str4 = str == null? "delete" : "set"
-   * → sending username=null triggers the delete path on the server.
-   */
-  const deleteUsername = async () => {
-    return mexQuery({ username: null }, USERNAME_QUERY_IDS.SET, 'xwa2_username_delete')
-  }
+	/**
+	 * Delete (unset) your own username.
+	 *
+	 * Confirmed from C1568872p.java:
+	 * str4 = str == null? "delete" : "set"
+	 * → sending username=null triggers the delete path on the server.
+	 */
+	const deleteUsername = async () => {
+		if (!USERNAME_QUERY_IDS.SET) {
+			throw new Error('Username SET query_id not configured — capture a live WA session to obtain it')
+	}
+		return mexQuery({ username: null }, USERNAME_QUERY_IDS.SET, 'xwa2_username_delete')
+	}
 
-  /**
-   * Get your own current username.
-   *
-   * Confirmed from C1568872p.java A02():
-   * AbstractC41851rT.A0L(AbstractC130045pa.A0T(), C1363664w.class, "UsernameGet", false)
-   */
-  const getMyUsername = async () => {
-    const data = await mexQuery({}, USERNAME_QUERY_IDS.GET, 'xwa2_username_get')
-    return data?.username?? null
-  }
+	/**
+	 * Get your own current username.
+	 *
+	 * Confirmed from C1568872p.java A02():
+	 * AbstractC41851rT.A0L(AbstractC130045pa.A0T(), C1363664w.class, "UsernameGet", false)
+	 */
+	const getMyUsername = async () => {
+		if (!USERNAME_QUERY_IDS.GET) {
+			throw new Error('Username GET query_id not configured — capture a live WA session to obtain it')
+	}
+		const data = await mexQuery({}, USERNAME_QUERY_IDS.GET, 'xwa2_username_get')
+		return data?.username?? null
+	}
 
-  /**
-   * Set or delete the PIN that protects your username.
-   *
-   * @param {string|null} pin - New PIN, or null to delete the PIN
-   *
-   * Confirmed from MexUsernamePinProtocolApi.java:
-   * operation "UsernamePinSet", variable "pin"
-   * pin=null triggers the "delete" path on the server.
-   */
-  const setUsernamePin = async pin => {
-    // pin=null → delete PIN (server interprets empty/null variables as delete)
-    const variables = pin!= null? { pin } : {}
-    return mexQuery(variables, USERNAME_QUERY_IDS.PIN_SET, 'xwa2_username_pin_set')
-  }
+	/**
+	 * Set or delete the PIN that protects your username.
+	 *
+	 * @param {string|null} pin - New PIN, or null to delete the PIN
+	 *
+	 * Confirmed from MexUsernamePinProtocolApi.java:
+	 * operation "UsernamePinSet", variable "pin"
+	 * pin=null triggers the "delete" path on the server.
+	 */
+	const setUsernamePin = async pin => {
+		if (!USERNAME_QUERY_IDS.PIN_SET) {
+			throw new Error('Username PIN_SET query_id not configured — capture a live WA session to obtain it')
+	}
+		return mexQuery({ pin }, USERNAME_QUERY_IDS.PIN_SET, 'xwa2_username_pin_set')
+	}
 
-  /**
-   * Look up a contact by their @username via USync.
-   *
-   * Confirmed via USyncContactProtocol.getUserElement():
-   * { tag: 'contact', attrs: { username, pin? } }
-   *
-   * @param {string} username - The username to look up (without @)
-   * @param {string} [pin] - Optional PIN if the username is PIN-protected
-   * @returns {{ jid, lid?, contact: boolean }|null}
-   */
-  const findUserByUsername = async (username, pin) => {
-    const usyncQuery = new USyncQuery().withContactProtocol()
-    const user = new USyncUser().withUsername(username)
-    if (pin) user.withUsernameKey(pin)
-    usyncQuery.withUser(user)
-    const result = await executeUSyncQuery(usyncQuery)
-    if (!result?.list?.length) return null
-    const entry = result.list[0]
-    return {
-      jid: entry.id,
-      contact: entry.contact?? false
-    }
-  }
+	/**
+	 * Look up a contact by their @username via USync.
+	 *
+	 * Confirmed via USyncContactProtocol.getUserElement():
+	 * { tag: 'contact', attrs: { username, pin? } }
+	 *
+	 * @param {string} username - The username to look up (without @)
+	 * @param {string} [pin] - Optional PIN if the username is PIN-protected
+	 * @returns {{ jid, lid?, contact: boolean }|null}
+	 */
+	const findUserByUsername = async (username, pin) => {
+		const usyncQuery = new USyncQuery().withContactProtocol()
+		const user = new USyncUser().withUsername(username)
+		if (pin) user.withUsernameKey(pin)
+	usyncQuery.withUser(user)
+		const result = await executeUSyncQuery(usyncQuery)
+		if (!result?.list?.length) return null
+		const entry = result.list[0]
+		return {
+			jid: entry.id,
+			contact: entry.contact?? false
+	}
+	}
 
-  /**
-   * Fetch the username of one or more contacts by their JID.
-   * Uses USync with the username protocol.
-   *
-   * @param {...string} jids - One or more JIDs
-   * @returns {Array<{ id, username: string|null }>}
-   */
-  const fetchContactUsernames = async (...jids) => {
-    const usyncQuery = new USyncQuery().withUsernameProtocol()
-    for (const jid of jids) {
-      usyncQuery.withUser(new USyncUser().withId(jid))
-    }
-    const result = await executeUSyncQuery(usyncQuery)
-    return result?.list?? []
-  }
+	/**
+	 * Fetch the username of one or more contacts by their JID.
+	 * Uses USync with the username protocol.
+	 *
+	 * @param {...string} jids - One or more JIDs
+	 * @returns {Array<{ id, username: string|null }>}
+	 */
+	const fetchContactUsernames = async (...jids) => {
+		const usyncQuery = new USyncQuery().withUsernameProtocol()
+		for (const jid of jids) {
+			usyncQuery.withUser(new USyncUser().withId(jid))
+	}
+		const result = await executeUSyncQuery(usyncQuery)
+		return result?.list?? []
+	}
 
-  /**
-   * Check multiple usernames for availability at once.
-   * @param {string[]} usernames - Array of usernames (without @)
-   */
-  const checkUsernameMulti = async usernames => {
-    const data = await mexQuery(
-      { usernames },
-      USERNAME_QUERY_IDS.CHECK_MULTI,
-      'xwa2_username_check_multi'
-    )
-    return data
-  }
+	/**
+	 * Check multiple usernames for availability at once.
+	 * @param {string[]} usernames - Array of usernames (without @)
+	 */
+	const checkUsernameMulti = async usernames => {
+		const data = await mexQuery(
+			{ usernames },
+			USERNAME_QUERY_IDS.CHECK_MULTI,
+			'xwa2_username_check_multi'
+	)
+		return data
+	}
 
-  /**
-   * Fetch username recommendations for the current user.
-   * @param {string} [source] - Source hint: 'FB' | 'IG' | 'USER_INPUT'
-   */
-  const getUsernameRecommendations = async (source = null) => {
-    const variables = {}
-    if (source) variables.source = source
-    return mexQuery(variables, USERNAME_QUERY_IDS.GET_RECOMMENDATIONS, 'xwa2_username_get_recommendations')
-  }
+	/**
+	 * Fetch username recommendations for the current user.
+	 * @param {string} [source] - Source hint: 'FB' | 'IG' | 'USER_INPUT'
+	 */
+	const getUsernameRecommendations = async (source = null) => {
+		const variables = {}
+		if (source) variables.source = source
+		return mexQuery(variables, USERNAME_QUERY_IDS.GET_RECOMMENDATIONS, 'xwa2_username_get_recommendations')
+	}
 
-  return {
-   ...sock,
-    checkUsername,
-    checkUsernameMulti,
-    setUsername,
-    deleteUsername,
-    getMyUsername,
-    getUsernameRecommendations,
-    setUsernamePin,
-    findUserByUsername,
-    fetchContactUsernames,
-    USERNAME_QUERY_IDS,
-    USERNAME_CHECK_RESULT,
-    USERNAME_SOURCE
-  }
+	return {
+	    ...sock,
+		checkUsername,
+		checkUsernameMulti,
+		setUsername,
+		deleteUsername,
+		getMyUsername,
+		getUsernameRecommendations,
+		setUsernamePin,
+		findUserByUsername,
+		fetchContactUsernames,
+		USERNAME_QUERY_IDS,
+		USERNAME_CHECK_RESULT,
+		USERNAME_SOURCE
+	}
 }