feat: add convertNumber function for WhatsApp ID format conversion

- Convert between @lid and @c.us formats

Author: jonalan7

README.md

@@ -601,6 +601,10 @@ await client.screenshot();
 ## Retrieving Data
 
 ```javascript
+
+// This function converts a number from the @c.us format to @lid, or vice versa.
+const convert = await client.convertNumber('[email protected]' || '00000000000000@lid');
+
 // return a chat
 const infoChat = await client.getChatById('[email protected]');
 

src/webpack/api/layes/retriever.layer.ts

@@ -13,6 +13,14 @@ export class RetrieverLayer extends Profile {
     super(page, browser, options, ev);
   }
 
+  /**
+   * Convert contact number to WhatsApp format
+   * @param number - Contact Number
+   */
+  public async convertNumber(number: string) {
+    return this.handleApiCallParametres(FunctionsLayer.convertNumber, number);
+  }
+
   /**
    * Get all messages in chat by chatId
    * @param chatId - Chat id

src/webpack/assets/api.js

@@ -42,6 +42,7 @@ import {
   refreshAltLinkingCode,
   getInterface,
   getChatById,
+  convertNumber,
 } from './functions';
 
 import {
@@ -105,7 +106,7 @@ if (typeof window.API === 'undefined') {
 
   // Get Functions
   window.API.loadAndGetAllMessagesInChat = loadAndGetAllMessagesInChat;
-
+  window.API.convertNumber = convertNumber;
   // Send Functions
   window.API.sendMessage = sendMessage;
 

src/webpack/assets/functions/convert-number.js

@@ -0,0 +1,23 @@
+/**
+ * Function to convert a number from lid to contact or vice versa
+ * @param {*} number - number to convert
+ * @returns - converted number or undefined if not possible
+ */
+export const convertNumber = async (number) => {
+  const lid = '@lid';
+  const contact = '@c.us';
+
+  const chat = await API.sendExist(number);
+  if (chat && chat.status != 404) {
+    const chatWid = new Store.WidFactory.createWid(chat.id._serialized);
+    if (lid === number.substr(-lid.length, lid.length)) {
+      return Store.ApiContact.getPhoneNumber(chatWid);
+    }
+    if (contact === number.substr(-contact.length, contact.length)) {
+      return Store.ApiContact.getCurrentLid(chatWid);
+    }
+    return undefined;
+  } else {
+    return chat;
+  }
+};

src/webpack/assets/functions/index.js

@@ -25,3 +25,4 @@ export * from './code-for-phone-number';
 export * from './refresh-alt-linking-code';
 export * from './get-interface';
 export * from './get-chat-by-id';
+export * from './convert-number';

src/webpack/assets/help/filter-object.js

@@ -180,4 +180,9 @@ export const filterObjects = [
     when: (module) =>
       module?.ProfilePicThumb && module?.ProfilePicThumbImpl ? module : null,
   },
+  {
+    id: 'ApiContact',
+    conditions: (module) =>
+      module?.getPhoneNumber && module?.getCurrentLid ? module : null,
+  },
 ];

src/webpack/model/api-types.ts

@@ -132,4 +132,6 @@ export interface API {
   eventOnReactionMessage(): Promise<void>;
   eventOnIntroReactionMessage(): Promise<void>;
   eventNewOnAck(): Promise<void>;
+
+  convertNumber(number: string): Promise<string>;
 }

src/webpack/model/enum/functions-layes.ts

@@ -1,4 +1,5 @@
 import { API } from '../';
+
 export enum FunctionsLayer {
   getGroupParticipant = 'getGroupParticipant',
   getAllChatsGroups = 'getAllChatsGroups',
@@ -18,6 +19,7 @@ export enum FunctionsLayer {
   getInterface = 'getInterface',
   screenshot = 'screenshot',
   getChatById = 'getChatById',
+  convertNumber = 'convertNumber',
 
   // Events Listeners
   eventInterfaceChange = 'eventInterfaceChange',

test/dev/bot.ts

@@ -159,6 +159,18 @@ import fs from 'fs';
             });
         }
 
+        if (hydraBotTestFunctions.convertNumber) {
+          // convert number to whatsapp format
+          await client
+            .convertNumber('[email protected]' || '00000000000000@lid')
+            .then((result) => {
+              console.log('Convert Number: ', result);
+            })
+            .catch((error) => {
+              console.log('Error Convert Number: ', error);
+            });
+        }
+
         if (hydraBotTestFunctions.getAllChats) {
           /// get all chats
           await client

test/help.ts

@@ -23,6 +23,7 @@ export const hydraBotTestFunctions = {
   getGroupParticipant: false,
   loadAndGetAllMessagesInChat: false,
   getChatById: false,
+  convertNumber: true,
 
   // Navigation functions
   browserClose: false,