feat: Get registered ID for a given phone number (pedroslopez#483)

Exposes internal getNumberById function for easy usage.
This can help with dealing with brazilian numbers with the extra digit, always returning the correct ID.

This will probably eventually replace the current isRegisteredUser function.

Co-authored-by: Pedro Lopez <pedroslopez@me.com>

index.d.ts

@@ -77,6 +77,9 @@ declare namespace WAWebJS {
         /** Check if a given ID is registered in whatsapp */
         isRegisteredUser(contactId: string): Promise<boolean>
 
+        /** Get the registered WhatsApp ID for a number. Returns null if the number is not registered on WhatsApp. */
+        getNumberId(number: string): Promise<ContactId?>
+
         /**
          * Mutes the Chat until a specified date
          * @param chatId ID of the chat that will be muted

src/Client.js

@@ -712,6 +712,26 @@ class Client extends EventEmitter {
         }, id);
     }
 
+    /**
+     * Get the registered WhatsApp ID for a number. 
+     * Will return null if the number is not registered on WhatsApp.
+     * @param {string} number Number or ID ("@c.us" will be automatically appended if not specified)
+     * @returns {Promise<Object|null>}
+     */
+    async getNumberId(number) {
+        if(!number.endsWith('@c.us')) {
+            number += '@c.us';
+        }
+
+        try {
+            return await this.pupPage.evaluate(async numberId => {
+                return window.WWebJS.getNumberId(numberId);
+            }, number);
+        } catch(_) {
+            return null;
+        }
+    }
+
     /**
      * Create a new group
      * @param {string} name group title

src/util/Injected.js

@@ -34,13 +34,15 @@ exports.ExposeStore = (moduleRaidStr) => {
 
 exports.LoadUtils = () => {
     window.WWebJS = {};
+
     window.WWebJS.getNumberId = async (id) => {
 
         let result = await window.Store.Wap.queryExist(id);
         if (result.jid === undefined)
             throw 'The number provided is not a registered whatsapp user';
         return result.jid;
     };
+
     window.WWebJS.sendSeen = async (chatId) => {
         let chat = window.Store.Chat.get(chatId);
         if (chat !== undefined) {
@@ -50,6 +52,7 @@ exports.LoadUtils = () => {
         return false;
 
     };
+
     window.WWebJS.sendMessage = async (chat, content, options = {}) => {
         let attOptions = {};
         if (options.attachment) {